Files
marqdo-cli/docs/adr/README.md
T
cflmy bbeb1de768 docs(status): record the landed RFC-LANG-0002 implementation
Update status, compatibility, changelog, README, architecture overview,
ADR status, migration guide, contributor/CI/security/release notes and
the per-file inventory from 'migration pending' to the verified state:

- language SHA ffd1cc9: fmt/clippy clean, workspace 501 passed / 0 failed
  / 2 ignored, stdlib digest regenerated and pack-verified
- green evidence report added; the prior intermediate evidence is marked
  superseded
- inventory regenerated: 1015 classified files, 0 pending
- explicit non-claims: Windows/macOS native lanes and the disposable-VM
  strict lane were not re-run at this SHA, so the release decision remains
  DO NOT RELEASE

Verified: cargo test -p marqdo-cli --test docs_consistency (4/4) and
git diff --check.
2026-11-21 12:31:38 +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 implementation is green at ffd1cc9; 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).