Files
marqdo-cli/docs/architecture

Architecture RFCs: current state, decisions and design input

Status: index. The single current architecture overview is CURRENT.md. This page only indexes frozen decisions, design input and evidence. It is not a second running-status page.

Design input RFCs (Proposed, not implemented behavior)

Document Status What it is
Unified semantics RFC-LANG-0002 Adopted and implemented Single syntax: heading modes, unified payloads, keyword control flow, breaking migration and acceptance gates.
Architecture audit and refactor RFC Review input (historical) Responsibility convergence, stdio/file/stream correctness, CLI/Host split and the migration order at the time. Its language examples predate RFC-LANG-0002.
Compute machine RFC-0001 Proposed Opaque Memory, addressable regions, wire/host rejection. Compute semantics are unchanged by the syntax rewrite; its .mq.md examples are historical spelling.
Core and stdlib migration RFC-0002 Proposed Minimum core, .mq.md stdlib and system-capability migration. Stdlib source migration is pending per this RFC.

The implemented first slices of these RFCs are recorded in CURRENT.md and ../STATUS.md; the RFC text itself never proves that code exists.

Decisions already frozen

RFC item ADR State
Unified Markdown semantics, heading modes, payload carriers, keyword control 0052 Accepted and implemented (ffd1cc9)
Execution scope (H2 functions only; carrier roles superseded) 0002 Accepted in part; mapping superseded by ADR-0052
CM-A01 Memory identity/lifetime 0022 Accepted
CM-A02 page size, growth, budgets 0022 Accepted
CM-A03 place assignment and evaluation order 0022 Accepted
CM-A04 minimal structure observation/construction 0023 Accepted
CM-A05 recoverable Result convention 0024 Accepted
CM-A06 minimal Resource/Stream ABI 0025 Accepted (first slice)
CM-A06 buffered project-file write 0026 Accepted
CM-A07 print migration staging / Compat-A 0027 Accepted (Compat-A only)
CM-A10 bundled stdlib / std: imports / digest 0028 Accepted (first slice)
Full-value stdlib formatting / FunctionRef+PluginHandle observation 0029 Accepted
CM-A07 Compat-B print routing 0030 Accepted
CM-A07 Compat-C remove legacy print formatting 0031 Accepted
CM-A08 table logical value / stdlib algorithms / T0 storage 0032 Accepted
CM-A09 in-process ResourceProvider v1 0033 Accepted (trusted in-process slice)
P5 blocking TCP resource endpoint v1 0034 Accepted (IP-literal, no DNS/TLS)
CM-A09 worker resource-provider transport v1 0035 Accepted (trusted helper)
CM-A09 C ABI ResourceProvider v1 0036 Accepted (trusted native adapter)
CM-A09 provider package manifest v1 0037 Accepted (host-side install)
CM-A09 C ABI provider worker binding v1 0038 Accepted (trusted helper)
Stdlib extraction deferral 0039 Accepted (in-repo for now)
Stdio stdin/stderr plus stdlib stream/console APIs 0040 Accepted (stdin read, separate stdout/stderr, product stdlib)
Non-streaming resource.request fs.* operations 0041 Accepted (project mode, grant-checked, recoverable fs Result)
clock.now resource operation 0042 Accepted (project mode, Unix millis)
env.get resource operation 0043 Accepted (exact-name project grant)
process.run resource operation 0044 Accepted (exact program grant, project only, not a sandbox)
fs.append/fs.read_at/fs.walk 0045 Accepted (bounded content, directory walk)
random.bytes resource operation 0046 Accepted (explicit --allow-random, project only)
DNS/UDP/TCP-listener endpoints 0047 Accepted (project only, exact host grant, no TLS)
TLS client endpoint 0048 Accepted (rustls, validated, project only)
gzip compression operations 0049 Accepted (bounded byte-list gzip)
Host regex extension 0050 Accepted (project-mode groups/alternation/captures)
Byte-exact HTTP framing 0051 Accepted (byte-list HTTP/1.1)
Table physical storage (T1/T2/T3), strict stdin/stderr/file/network resources — Not decided; do not implement by implication

Evidence and status

  • Executed test counts, platform lanes and release blockers live in ../STATUS.md. Do not repeat them here.
  • SHA-pinned fact snapshots live in ../evidence/.
  • Superseded planning input lives in ../history/, and its remaining files carry a Historical banner.

What a future phase must not do

  • add a top-level CLI command or Markdown keyword for memory, allocation or I/O;
  • add a HostOp for every new stdlib function;
  • turn managed List/Map/Table into aliased mutable storage;
  • expose a host pointer, let a handle cross the wire, or claim block-level safety for user allocators;
  • make strict accept an unverified provider by default;
  • claim an RFC phase is complete without the closure and negative evidence its phase gate requires;
  • edit a gate result in ../STATUS.md without an executed log or a source path.