Files
marqdo-cli/docs/adr/README.md
T
cflmy 49835424ee docs(spec): adopt RFC-LANG-0002 unified language semantics
Replace the Strong/Emph/List/Quote mapping in place with the single
@exec/@knowledge heading-mode model, unified payload carriers and keyword
control flow.

- add the authoritative RFC, ADR-0052 and a historical ADR index
- rewrite spec/mapping.md and spec/expression.ebnf as the normative
  mapping/statement grammar; update evaluation, references, math,
  foreign, package-format, plugin-abi, security and schema notes
- rewrite README, AGENTS, COMPATIBILITY and CHANGELOG for the breaking
  language change; update the architecture index/overview and active docs
- mark superseded planning docs, compute RFCs, evidence and syntax-role
  ADRs as historical/superseded without rewriting their decisions
- add migration guide, per-file inventory and dev-only audit scripts

The frontend/stdlib migration is completed in the following commits; this
commit contains documentation only.
2026-11-21 12:24:19 +08:00

1.9 KiB
Raw Blame History

Architecture Decision Records (ADRs)

These files record decisions at the date they were made. They are not a description of current language behavior, implementation state or current architecture; read them as decision history.

  • Status is not a current-language claim. A status such as "Accepted" means the decision was accepted then, not that its syntax or behavior is still active. Superseded ADRs keep their original decision text and date; they are not rewritten.
  • Syntax-role decisions are superseded by ADR-0052. The earlier mapping — Strong executes, Emph returns, ordered list is a branch, bullet list is a loop, block quote is a call, plus the associated markdown.inert_executable / markdown.invalid_construct role diagnostics — is retired. The current language contract is RFC-LANG-0002, with its normative summaries spec/mapping.md and spec/expression.ebnf: @exec/@knowledge heading modes, Strong/Emph/inline Code as interchangeable one-statement payload carriers, and if/else/while/end/return/ params keywords. The Rust frontend in this checkout still implements the pre-RFC mapping; see docs/STATUS.md.
  • Infrastructure ADRs (crates, ABI, capabilities, CLI/JSON contract, packaging, security isolation) remain current unless a later ADR supersedes them. ADRs with a historical banner keep the banner scoped to the superseded part.
  • This index is not a spec. For current architecture see docs/architecture/CURRENT.md; for executed status see docs/STATUS.md.

Files: 0001–0050, plus 0051-byte-exact-http-framing.md (HTTP framing) and 0052-unified-markdown-semantics.md (current language mapping).