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:
1 parent
ffd1cc9862
commit
bbeb1de768
24 files changed
+425
-342
No files matched your search
@@ -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 |
|
||||
|
||||
@@ -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 语义映射。
|
||||
|
||||
Reference in new issue
Block a user