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

34 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).