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.
This commit is contained in:
cflmy committed 2026-11-21 12:31:38 +08:00
1 parent ffd1cc9862
commit bbeb1de768
24 files changed
+425 -342

No files matched your search

+9 -9
View File
@@ -4,17 +4,17 @@ Status: **current architecture overview**. This file summarises the tree as it
is today. It is not a release promise, does not reopen a frozen ADR, and does not
replace `spec/` or a recorded test log.
- Baseline: [`24c88bcc78b1c705eb2319e7aaa8822a415eb01f`](https://github.com/cflmy/marqdo-cli/commit/24c88bcc78b1c705eb2319e7aaa8822a415eb01f) (2026-11-21, before the documentation migration commit).
- Baseline: [`ffd1cc9862f7fe6002b42f1210010c1f78671a95`](https://github.com/cflmy/marqdo-cli/commit/ffd1cc9862f7fe6002b42f1210010c1f78671a95) (2026-11-21, RFC-LANG-0002 implementation).
- Normative behavior: `spec/`; frozen decisions: `docs/adr/`; executed evidence: `docs/STATUS.md` and `docs/evidence/`.
- This is the **single current overview**. Do not add a second running "current state" file;
update this file, `docs/STATUS.md` and an evidence file together.
> **Language contract vs implementation.** The current language contract is
> **Language contract and implementation.** The language contract is
> [RFC-LANG-0002](RFC-LANG-0002-unified-semantics.md) (adopted by ADR-0052) and
> `spec/mapping.md`. The Rust frontend, expression parser and bundled `stdlib/`
> still implement the pre-RFC mapping; source/test/doc migration is tracked in
> [`../migration/README.md`](../migration/README.md). Do not read this overview
> as proof that the new syntax is executable.
> `spec/mapping.md`. The frontend, `marqdo-expression`, IR lowering, runtime and
> bundled `stdlib/` implement it. The workspace gate is green at `ffd1cc9`;
> rollout evidence and historical banners are indexed in
> [`../migration/README.md`](../migration/README.md).
## 1. Four state dimensions
@@ -24,8 +24,8 @@ platform".
| Dimension | Current state | Source |
|---|---|---|
| Implemented | Rust workspace `0.1.0`: Markdown/frontend/IR, tree-walk runtime, `Memory`, capability host, Tool/Analysis/Trace, Plugin ABI, Foreign kernels, bundled stdlib, CLI composition root | `Cargo.toml`, `crates/`, `stdlib/` |
| Tested locally | `cargo test --workspace --locked`: **491 passed, 0 failed, 2 ignored** on Linux x86_64 at the baseline | `docs/STATUS.md` §3 |
| Implemented | Rust workspace `0.1.0`: RFC-LANG-0002 Markdown/frontend/IR, v2 statement parser, tree-walk runtime, `Memory`, capability host, Tool/Analysis/Trace, Plugin ABI, Foreign kernels, migrated bundled stdlib, CLI composition root | `Cargo.toml`, `crates/`, `stdlib/` |
| Tested locally | `cargo test --workspace --locked`: **501 passed, 0 failed, 2 ignored** on Linux x86_64 at the baseline; fmt and clippy clean | `docs/STATUS.md` §0, `docs/evidence/2026-11-21-semantics-v2-green.md` |
| Bundled stdlib released | In-repo bundle `marqdo-stdlib@0.1.0`, SHA-256 digest verified before loading; it is **not** an external registry package | `stdlib/stdlib.json`, `stdlib/README.md` |
| Multi-platform verified | Linux local gate is the only executed lane here; Windows/macOS native lanes are **UNVERIFIED**, and the GitHub security lane remains a **VM-only** gate | `docs/STATUS.md` §1, §4 |
@@ -134,7 +134,7 @@ that a phase is complete.
| Priority | Gap | State |
|---|---|---|
| P0 | **Language syntax migration**: RFC-LANG-0002 is the single contract, but the frontend/expression/stdlib implementation and executable fixtures are still on the pre-RFC mapping | **in progress**; docs/examples/test text migrated, implementation pending; see `docs/migration/` |
| P0 | **Language syntax migration**: RFC-LANG-0002 single contract | **closed at `ffd1cc9`**; implementation, stdlib digest, examples and fixtures green; platform/strict evidence remains separate |
| P0 | Stdlib release is a bundle in this repo; extraction is deferred (ADR-0039) | accepted, keep in repo |
| P0 | Documentation drift between `STATUS.md`, the architecture index and the evidence | being fixed by this migration and the docs gate |
| P1 | `std:fs/file` read/write/copy, metadata/directory, append/read_at/walk are implemented; watch and binary offset reads remain open | open |
+2 -2
View File
@@ -19,7 +19,7 @@ input and evidence. It is not a second running-status page.
| Document | Status | What it is |
|---|---|---|
| [Unified semantics RFC-LANG-0002](RFC-LANG-0002-unified-semantics.md) | **Adopted target contract; implementation pending** | Single syntax: heading modes, unified payloads, keyword control flow, breaking migration and acceptance gates. |
| [Unified semantics RFC-LANG-0002](RFC-LANG-0002-unified-semantics.md) | **Adopted and implemented** | Single syntax: heading modes, unified payloads, keyword control flow, breaking migration and acceptance gates. |
| [Architecture audit and refactor RFC](Marqdo_CLI_Latest_Architecture_Audit_and_Refactor_RFC.md) | **Review input (historical)** | Responsibility convergence, stdio/file/stream correctness, CLI/Host split and the migration order at the time. Its language examples predate RFC-LANG-0002. |
| [Compute machine RFC-0001](../MARQDO_COMPUTE_MACHINE_RFC_0001.md) | **Proposed** | Opaque `Memory`, addressable regions, wire/host rejection. Compute semantics are unchanged by the syntax rewrite; its `.mq.md` examples are historical spelling. |
| [Core and stdlib migration RFC-0002](../MARQDO_COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md) | **Proposed** | Minimum core, `.mq.md` stdlib and system-capability migration. Stdlib source migration is pending per this RFC. |
@@ -31,7 +31,7 @@ The implemented first slices of these RFCs are recorded in `CURRENT.md` and
| RFC item | ADR | State |
|---|---|---|
| Unified Markdown semantics, heading modes, payload carriers, keyword control | [0051](../adr/0052-unified-markdown-semantics.md) | Accepted (target; frontend pending) |
| Unified Markdown semantics, heading modes, payload carriers, keyword control | [0052](../adr/0052-unified-markdown-semantics.md) | Accepted and implemented (`ffd1cc9`) |
| Execution scope (H2 functions only; carrier roles superseded) | [0002](../adr/0002-executables-only-in-function-bodies.md) | Accepted in part; mapping superseded by ADR-0052 |
| CM-A01 Memory identity/lifetime | [0022](../adr/0022-addressable-memory-and-place-assignment.md) | Accepted |
| CM-A02 page size, growth, budgets | [0022](../adr/0022-addressable-memory-and-place-assignment.md) | Accepted |
@@ -3,13 +3,15 @@
> **仓库采纳记录(2026-11-21)**:本文件是当前**唯一**的语言语义权威规范,由
> [ADR-0052](../adr/0052-unified-markdown-semantics.md) 采纳并取代此前所有
> Strong/Emph/List/Quote 映射描述。`spec/mapping.md` 与 `spec/expression.ebnf`
> 已原位改写为本规范的可执行摘要。**Rust 前端与标准库尚未落地本规范**;当前
> 状态、测试红区和迁移台账见 [`../STATUS.md`](../STATUS.md) 与
> [`../migration/semantic-rewrite-inventory.tsv`](../migration/semantic-rewrite-inventory.tsv)。
> 下文保留原始 RFC 的状态行(“待批准”)作为历史表述,不改变其技术内容。
> 已原位改写为本规范的可执行摘要。本规范已由前端、`marqdo-expression` 语句
> 解析器、IR 降级、运行时与同仓库标准库**完整落地**;`ffd1cc9` 上 workspace
> 测试全绿(详见 [`../STATUS.md`](../STATUS.md)、
> [`../evidence/2026-11-21-semantics-v2-green.md`](../evidence/2026-11-21-semantics-v2-green.md)
> 与 [`../migration/semantic-rewrite-inventory.tsv`](../migration/semantic-rewrite-inventory.tsv))。
> 下文保留原始 RFC 的状态行作为设计历史,不改变其技术内容。
> **文档定位**:本文件是**无需任何聊天背景即可独立实施的、单一现行语法开发规范**:先讲完整语言使用方法,再说明相较旧语法的破坏性变化,然后规定实现架构、全仓库迁移和阻断性验收。不能只阅读 RFC 标题就开始编码。
> **状态**:待批准的目标规范与实施计划;不代表当前 CLI 已支持。**开发目标是一次性替换原有语义**,不提供 V1/V2 双编译、不按文件选择语法、不保留旧 Mapper 和运行时兼容分支。
> **状态**:已采纳并实现(2026-11-21,见顶部采纳记录与 ADR-0052)。**本规范一次性替换原有语义**,不提供 V1/V2 双编译、不按文件选择语法、不保留旧 Mapper 和运行时兼容分支。
> **仓库**:[`cflmy/marqdo-cli`](https://github.com/cflmy/marqdo-cli),源码审查 SHA `7fbe069196e61d06a00d64fe8d65049c327373eb`。
> **语法名称**:下文称“新语法”或“新语义”,此名称用于规范和发布说明,**不是可切换的运行模式或 Front matter 选项**。
> **Markdown 层**:继续使用当前 Comrak/CommonMark/GFM AST;若扩展设置不变,Markdown 解析器 Profile 可保持原身份。变更的是唯一的 Markdown→Program 语义映射。