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.
34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# 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](0052-unified-markdown-semantics.md).** 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](../architecture/RFC-LANG-0002-unified-semantics.md), with its
|
||
normative summaries [`spec/mapping.md`](../../spec/mapping.md) and
|
||
[`spec/expression.ebnf`](../../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`](../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`](../architecture/CURRENT.md); for executed
|
||
status see [`docs/STATUS.md`](../STATUS.md).
|
||
|
||
Files: `0001`–`0050`, plus `0051-byte-exact-http-framing.md` (HTTP framing) and
|
||
`0052-unified-markdown-semantics.md` (current language mapping).
|