Files
marqdo-cli/docs/architecture/README.md
T

5.8 KiB

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
Architecture audit and refactor RFC Review input Responsibility convergence, stdio/file/stream correctness, CLI/Host split and the current migration order. It is not evidence that a phase is done.
Compute machine RFC-0001 Proposed Opaque Memory, addressable regions, wire/host rejection.
Core and stdlib migration RFC-0002 Proposed Minimum core, .mq.md stdlib and system-capability migration.

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
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)
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.