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.
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 —
Strongexecutes,Emphreturns, ordered list is a branch, bullet list is a loop, block quote is a call, plus the associatedmarkdown.inert_executable/markdown.invalid_constructrole diagnostics — is retired. The current language contract is RFC-LANG-0002, with its normative summariesspec/mapping.mdandspec/expression.ebnf:@exec/@knowledgeheading modes,Strong/Emph/inlineCodeas interchangeable one-statement payload carriers, andif/else/while/end/return/paramskeywords. The Rust frontend in this checkout still implements the pre-RFC mapping; seedocs/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 seedocs/STATUS.md.
Files: 0001–0050, plus 0051-byte-exact-http-framing.md (HTTP framing) and
0052-unified-markdown-semantics.md (current language mapping).