From bbeb1de76856d037f2dc731bcaa7892ef04007d5 Mon Sep 17 00:00:00 2001 From: cflmy Date: Sat, 21 Nov 2026 12:31:38 +0800 Subject: [PATCH] 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. --- AGENTS.md | 6 +- CHANGELOG.md | 20 +- COMPATIBILITY.md | 21 +- README.md | 51 ++-- ..._COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md | 6 +- docs/MARQDO_COMPUTE_MACHINE_RFC_0001.md | 6 +- docs/STATUS.md | 104 +++---- docs/adr/0052-unified-markdown-semantics.md | 14 +- docs/adr/README.md | 4 +- docs/architecture/CURRENT.md | 18 +- docs/architecture/README.md | 4 +- .../RFC-LANG-0002-unified-semantics.md | 12 +- docs/ci.md | 15 +- docs/contributor-guide.md | 28 +- .../2026-11-21-semantic-docs-migration.md | 8 +- .../evidence/2026-11-21-semantics-v2-green.md | 73 +++++ docs/migration/README.md | 35 +-- docs/migration/semantic-rewrite-inventory.tsv | 254 +++++++++--------- docs/releasing.md | 23 +- docs/security-gate.md | 9 +- docs/security-vm.md | 8 +- spec/mapping.md | 17 +- tests/README.md | 24 +- tools/dev-only/gen-migration-inventory.py | 7 +- 24 files changed, 425 insertions(+), 342 deletions(-) create mode 100644 docs/evidence/2026-11-21-semantics-v2-green.md diff --git a/AGENTS.md b/AGENTS.md index fe6757d..e30981a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # Marqdo CLI — Agent / Contributor Operating Rules -**Start here:** read `docs/architecture/RFC-LANG-0002-unified-semantics.md` — it is the single current language authority — and its normative summary `spec/mapping.md` + `spec/expression.ebnf`. Then read `docs/DEVELOPMENT_BLUEPRINT.md` (architecture baseline; its language-mapping sections are historical), `docs/STATUS.md` (what is actually implemented, including the in-progress syntax migration), the relevant `spec/` files, `docs/adr/` for decisions at their date, `docs/contributor-guide.md`, and `tests/README.md` plus the conformance fixtures. Do not assume any current implementation or legacy Marqdo syntax is authoritative. +**Start here:** read `docs/architecture/RFC-LANG-0002-unified-semantics.md` — it is the single current language authority — and its normative summary `spec/mapping.md` + `spec/expression.ebnf`. Then read `docs/DEVELOPMENT_BLUEPRINT.md` (architecture baseline; its language-mapping sections are historical), `docs/STATUS.md` (what is actually implemented, including the landed RFC-LANG-0002 migration), the relevant `spec/` files, `docs/adr/` for decisions at their date, `docs/contributor-guide.md`, and `tests/README.md` plus the conformance fixtures. Do not assume any current implementation or legacy Marqdo syntax is authoritative. For next-phase work, the single authoritative plan is `docs/STABLE_RELEASE_IMPLEMENTATION.md` (stable-release gates G-A/G-B/G-C, @@ -29,7 +29,7 @@ correctness and release evidence before expanding the surface. 8. Third-party plugins require a versioned **C ABI and SDK**. A C ABI is not a sandbox. Default third-party execution must be isolated; in-process native loading requires explicit trust. 9. Side effects go through `CapabilityHost`; do not invent host bypasses for tests, plugins, math or foreign kernels. `check` and `inspect` cannot execute untrusted project code. 10. Language semantics, package format, ABI, authorization defaults or public CLI behavior changes require an ADR + tests + spec updates. -11. The current tree is **spec-first**: RFC-LANG-0002 and `spec/` describe the target language, while the Rust frontend, expression parser and bundled stdlib still implement the pre-RFC mapping. Do not claim the new syntax is implemented or make a release claim until the migration is complete and its gates are green; keep `docs/STATUS.md` honest. +11. RFC-LANG-0002 is implemented by the frontend, `marqdo-expression`, IR lowering, runtime and the bundled stdlib. Keep `spec/`, implementation, fixtures, stdlib digest and docs in lockstep; there is no legacy mapper or per-file syntax switch to fall back to. Do not make a release claim beyond the evidence recorded in `docs/STATUS.md`. ## Development workflow @@ -46,6 +46,6 @@ RFC-LANG-0002 resolves the old emphasis/control-role conflict: `Strong`, `Emph` ## Priorities -P0 language migration to RFC-LANG-0002 (frontend, expression parser, stdlib, fixtures) → P1 independent interpreter → P2 references/CLI → P3 package/env → P4 sandbox → P5 math/foreign → P6 plugin ABI/SDK → P7 performance/release. Design the Host security boundary and ABI early, even if full implementation arrives later. +P0 language contract maintenance (RFC-LANG-0002, single grammar, corpus and stdlib) → P1 independent interpreter → P2 references/CLI → P3 package/env → P4 sandbox → P5 math/foreign → P6 plugin ABI/SDK → P7 performance/release. Design the Host security boundary and ABI early, even if full implementation arrives later. **Never** translate Marqdo into Python as the official execution method; **never** silently downgrade an invalid payload to prose, a requested strict sandbox to an unrestricted process, or the current syntax to a legacy mapper. diff --git a/CHANGELOG.md b/CHANGELOG.md index 37371b8..88580d1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -34,13 +34,15 @@ summarized normatively in [`spec/mapping.md`](spec/mapping.md) and - There is no syntax version switch, per-file selector, `--legacy` path or fallback mapper; `marqdo_semantics`/syntax-selection front matter is rejected. -**This entry records the accepted target contract, not a finished -implementation.** The Rust frontend, expression parser and bundled stdlib in -this checkout still implement the pre-RFC mapping, so executable-source tests -are expected to be red until the migration lands; see +**Implementation status: landed** in the `semantics-v2-refactor` history +(`4983542` docs/spec, `e029853` frontend/runtime/stdlib/corpus, `ffd1cc9` +expression-owned statement grammar and extra coverage). At `ffd1cc9`, +`cargo test --workspace --locked` is green (501 passed, 0 failed, 2 ignored), +`cargo clippy --workspace --all-targets -- -D warnings` is clean and the +stdlib digest is regenerated. See [`docs/STATUS.md`](docs/STATUS.md) and -[`docs/migration/README.md`](docs/migration/README.md). Do not describe this -candidate as accepting the new syntax. +[`docs/evidence/2026-11-21-semantics-v2-green.md`](docs/evidence/2026-11-21-semantics-v2-green.md). +Platform CI and the disposable-VM strict lane were not re-run at this SHA. **Required migration actions for consumers and the repository:** @@ -95,9 +97,9 @@ candidate as accepting the new syntax. compile-negative fixtures and 2 runtime-negative fixtures covering right-associative `**`, unary-minus precedence, parentheses, float negative exponents, Strong+CodeSpan payloads, branch/loop conditions, inert prose and - code fences, and source spans inside one/two-backtick code spans. (Recorded - under the pre-RFC mapping, now superseded by RFC-LANG-0002; the fixtures are - being migrated to the unified payload/keyword syntax.) + code fences, and source spans inside one/two-backtick code spans. (The + fixtures were migrated to the unified payload/keyword syntax and are green at + `ffd1cc9`.) - Independent Tool Protocol v1 consumers `sample-view`, `sample-knowledge` and `sample-proof` (analysis/trace readers) with install, dispatch and remove tests; none is a hard-coded CLI command. diff --git a/COMPATIBILITY.md b/COMPATIBILITY.md index fe91812..10c7198 100644 --- a/COMPATIBILITY.md +++ b/COMPATIBILITY.md @@ -1,7 +1,7 @@ # Compatibility and support matrix -Snapshot: workspace version **0.1.0**, code/security SHA **`8af7262`**, no -release tag cut. This file records what was actually verified and separates it +Snapshot: workspace version **0.1.0**, language SHA **`ffd1cc9`**, security SHA +**`8af7262`**, no release tag cut. This file records what was actually verified and separates it from what is only implemented. Executed status is in [`docs/STATUS.md`](docs/STATUS.md). @@ -33,14 +33,13 @@ Consequences for compatibility: diagnostic, never a fallback to prose. - The Markdown parser profile stays `marqdo.md.v1`; only the Markdown→program mapping changed. Rendering of otherwise-ordinary Markdown is unaffected. -- **Implementation state:** `spec/` is ahead of the Rust implementation. The - frontend migration is only partially present in this worktree: heading-mode - and Knowledge-unit plumbing has started, but the executable mapping, statement - parser and bundled stdlib still follow pre-RFC behaviour. Tests that exercise - executable Marqdo source are therefore expected to be red, and this candidate - must not be described as supporting the new syntax until the full migration - lands. See [`docs/STATUS.md`](docs/STATUS.md) and - [`docs/migration/README.md`](docs/migration/README.md). +- **Implementation state:** RFC-LANG-0002 is implemented by the frontend, + expression parser, IR lowering, runtime and bundled stdlib. At + `ffd1cc9862f7fe6002b42f1210010c1f78671a95` the workspace gate is + `cargo test --workspace --locked`: 501 passed, 0 failed, 2 ignored, and the + stdlib digest is regenerated and verified. See + [`docs/STATUS.md`](docs/STATUS.md) and + [`docs/evidence/2026-11-21-semantics-v2-green.md`](docs/evidence/2026-11-21-semantics-v2-green.md). ## Public protocol versions @@ -64,7 +63,7 @@ portable/tested locally but the native platform lane has not run here; | Feature | Ubuntu Linux x86_64 | macOS arm64 | Windows x86_64 | |---|---|---|---| | Markdown profile / AST goldens (160) | PASS | UNVERIFIED (cfg fix + CRLF fix) | UNVERIFIED (cfg fix + CRLF fix) | -| Rust interpreter / semantics (70) | PASS | UNVERIFIED | UNVERIFIED | +| Rust interpreter / unified semantics (73) | PASS | UNVERIFIED | UNVERIFIED | | Addressable `Memory` P1 (ADR-0022) | PASS | UNVERIFIED | UNVERIFIED | | Resource streams CM-A06 (ADR-0025/0026: stdout + project file read/write) | PASS | UNVERIFIED | **FAIL-CLOSED** (`strict` refuses resource opens) | | `run` / `call` / `check` / `inspect` / `fmt` | PASS | UNVERIFIED | UNVERIFIED | diff --git a/README.md b/README.md index 9766ccf..b6cbe54 100644 --- a/README.md +++ b/README.md @@ -13,23 +13,21 @@ This repository is the new, independent Marqdo toolchain (M0.5). It is **not** a compatibility rewrite of `cflmy/marqdo`; the old syntax, package format and plugin ABI v2 are not claimed to work here. -> **Breaking language revision in progress.** The current semantic contract is -> [RFC-LANG-0002](docs/architecture/RFC-LANG-0002-unified-semantics.md) -> (see also [`spec/mapping.md`](spec/mapping.md) and -> [`spec/expression.ebnf`](spec/expression.ebnf)). The repository documentation, -> examples and test sources have been migrated to this single syntax, but the -> Rust frontend, expression parser and bundled `stdlib/` have **not** landed it -> yet. Until they do, executable tests that contain migrated source are expected -> to be red; this checkout must not be described as supporting the new syntax. -> Old syntax (`**strong**` = execute, `*emph*` = return, `1.` = branch, -> `-` = loop, `>` = call) is **not** an active language. Migration status: -> [`docs/migration/README.md`](docs/migration/README.md) and -> [`docs/STATUS.md`](docs/STATUS.md). +> **Breaking language revision landed.** The single semantic contract is +> [RFC-LANG-0002](docs/architecture/RFC-LANG-0002-unified-semantics.md), with +> normative summaries in [`spec/mapping.md`](spec/mapping.md) and +> [`spec/expression.ebnf`](spec/expression.ebnf). The frontend, expression +> parser, stdlib, examples and test corpus all implement it: +> `cargo test --workspace --locked` is green (501 passed, 0 failed, 2 ignored +> at `ffd1cc9`). Old syntax (`**strong**` = execute, `*emph*` = return, +> `1.` = branch, `-` = loop, `>` = call) is **not** an active language and +> `marqdo_semantics`/`--legacy` selectors do not exist. See +> [`docs/STATUS.md`](docs/STATUS.md) and +> [`docs/migration/README.md`](docs/migration/README.md). -> **Status: stabilization candidate, not released.** The language, lock v3, -> Analysis v2, Trace v2, Tool v1, Plugin ABI v1 (native + worker) and pinned -> Foreign providers are implemented and covered by tests on Linux for the -> pre-RFC syntax. The macOS/Windows `E0433` platform-cfg failure and the Linux +> **Status: stabilization candidate, not released.** The language (RFC-LANG-0002), +> lock v3, Analysis v2, Trace v2, Tool v1, Plugin ABI v1 (native + worker) and +> pinned Foreign providers are implemented and covered by tests on Linux. The macOS/Windows `E0433` platform-cfg failure and the Linux > strict probe→launch race are fixed in source at `8af7262`, but the native > Windows/macOS and GitHub Linux lanes have not been re-run from this checkout. > **`strict` OS isolation is available on Linux only when the runtime @@ -60,16 +58,11 @@ cargo build -p marqdo-cli ## Quickstart -> **Not yet executable in this checkout.** The source below is the only current -> syntax. The published binary still contains the pre-RFC frontend and will -> report these sources as Knowledge (no callable `main`) or a payload error -> until the migration lands. See [`docs/STATUS.md`](docs/STATUS.md). - ```bash marqdo init demo cd demo marqdo check index.mq.md -marqdo run index.mq.md # executes ## @exec main once implemented +marqdo run index.mq.md # executes ## @exec main marqdo inspect index.mq.md --ast marqdo inspect index.mq.md --signature marqdo call index.mq.md main @@ -98,7 +91,7 @@ Example project from scratch (`index.mq.md`): ```bash marqdo check examples/factorial.mq.md -marqdo call examples/factorial.mq.md 数学.阶乘 --arg n=5 # target: 120 +marqdo call examples/factorial.mq.md 数学.阶乘 --arg n=5 # 120 ``` The parser is frozen: `marqdo.md.v1` = CommonMark 0.31.2 + GFM tables, @@ -134,12 +127,10 @@ rules are [`RFC-LANG-0002`](docs/architecture/RFC-LANG-0002-unified-semantics.md ## What works (implemented and tested) -* **P0 contracts** — frozen Markdown profile, evaluation semantics and the - pre-RFC AST → program mapping; 160 AST goldens, 73 semantic goldens, 52 - compile-error fixtures and 21 runtime-error fixtures (`tests/`). The test - corpus has been rewritten to the current syntax but the frontend has not, so - these suites are **expected red** until the migration in - [`docs/migration/`](docs/migration/README.md) lands. +* **P0 contracts** — frozen `marqdo.md.v1` profile, RFC-LANG-0002 AST → program + mapping, the v2 statement grammar and evaluation semantics; 160 AST goldens, + 73 semantic fixtures, 47 compile-error fixtures, 2 warning fixtures and 21 + runtime-error fixtures, all green (`tests/`). * **P1 interpreter** — native Rust tree-walk interpreter: values, scopes, functions, static parameter inference, assignments, branches, loops, returns, recursion, structured errors, fuel/stack/output budgets. @@ -341,8 +332,6 @@ tests/ conformance/negative corpus (see tests/README.md) ## Examples -> Examples are migrated to the current syntax but cannot execute until the -> frontend migration lands; the commands below are the intended contract. ```bash marqdo run examples/hello.mq.md diff --git a/docs/MARQDO_COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md b/docs/MARQDO_COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md index ee9bc43..5ac4450 100644 --- a/docs/MARQDO_COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md +++ b/docs/MARQDO_COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md @@ -13,9 +13,9 @@ > modes, `params`, `return`, `if/else/end`, `while/end`, and one-statement > payloads carried by `Strong`, `Emph` or inline `Code`. Any remaining old > spelling (for example "`##/**/*` roles") is historical and is **not** an -> active language. The Rust frontend still implements the pre-RFC mapping, so -> these examples are target syntax, not currently runnable programs; see -> [`STATUS.md`](STATUS.md). +> active language. The frontend now implements this syntax; examples that use +> APIs this RFC only proposes remain design targets, not implemented features. +> See [`STATUS.md`](STATUS.md). > **状态**:Draft / 架构与迁移提案,未批准、未实施。所有代码均为目标语义草案,不能当作已运行示例。 diff --git a/docs/MARQDO_COMPUTE_MACHINE_RFC_0001.md b/docs/MARQDO_COMPUTE_MACHINE_RFC_0001.md index 66dcf57..8bf6b64 100644 --- a/docs/MARQDO_COMPUTE_MACHINE_RFC_0001.md +++ b/docs/MARQDO_COMPUTE_MACHINE_RFC_0001.md @@ -13,9 +13,9 @@ > modes, `params`, `return`, `if/else/end`, `while/end`, and one-statement > payloads carried by `Strong`, `Emph` or inline `Code`. Any remaining old > spelling (for example "`##` function, `**` execute, `*` return") is -> historical and is **not** an active language. The Rust frontend still -> implements the pre-RFC mapping, so these examples are target syntax, not -> currently runnable programs; see [`STATUS.md`](STATUS.md). +> historical and is **not** an active language. The frontend now +> implements this syntax; examples that use APIs this RFC only proposes remain +> design targets, not implemented features. See [`STATUS.md`](STATUS.md). > **状态**:设计提案(Draft,未实施,未批准) > **日期**:2026-11-20 diff --git a/docs/STATUS.md b/docs/STATUS.md index 7b3cca6..fc0db45 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -19,53 +19,66 @@ not be read as current status. Status is generated from executed commands and logs; a gate row without a command, log or source path is a defect, not a state. -## 0. Language migration in progress (RFC-LANG-0002) +## 0. Language migration completed (RFC-LANG-0002) -The repository adopted a **breaking, single-syntax** language contract: +The repository now has **one** language contract, implemented end to end: [`architecture/RFC-LANG-0002-unified-semantics.md`](architecture/RFC-LANG-0002-unified-semantics.md) -and [ADR-0052](adr/0052-unified-markdown-semantics.md), with the normative -summary in [`../spec/mapping.md`](../spec/mapping.md) and +(accepted by [ADR-0052](adr/0052-unified-markdown-semantics.md)), with the +normative summary in [`../spec/mapping.md`](../spec/mapping.md) and [`../spec/expression.ebnf`](../spec/expression.ebnf). -What changed in this migration: +Landed in three commits on `semantics-v2-refactor`: -* active docs/spec/READMEs and all repository examples were rewritten to the - new heading-mode + unified-payload + keyword syntax; -* test-case source text (`tests/conformance/semantics`, `tests/negative`, - `tests/negative/runtime`, `tests/negative/warnings`, Rust-embedded fixtures) - was rewritten to the same syntax and the new `sem.*` diagnostics; -* no V1/V2 switch, `--legacy` path or dual active spec was introduced. +| Step | Commit | Content | +|---|---|---| +| 1 | `4983542` | docs/spec/ADR/READMEs, historical banners, migration guide and inventory | +| 2 | `e029853` | frontend/IR/runtime implementation, `sem.*` diagnostics, migrated stdlib + digest, examples, fixtures and Rust-embedded sources | +| 3 | `ffd1cc9` | expression-owned payload statement grammar, extra negative/CLI coverage | -What did **not** change in this migration: +The breaking behaviour is: -* the Rust frontend migration is only partially present in this worktree: - heading-mode/Knowledge-unit plumbing has begun, but the executable mapping - (`map.rs`), statement parser and the bundled `stdlib/**/*.mq.md` still follow - pre-RFC behaviour; -* as a result, `cargo test --workspace --locked` is **expected to be red**: the - semantic/negative/CLI fixtures now feed the old frontend. The last green - workspace run (491 passed, 0 failed, 2 ignored at `8af7262`) is historical - evidence for the pre-migration tree, not for this worktree; -* no platform, security or protocol result should be inferred from this - documentation migration. +* H1–H6 headings declare `@exec`/`@knowledge`; unmarked headings inherit the + nearest ancestor and the document root is Knowledge; +* only an Exec H2 is callable; an H2 Knowledge unit and H3–H6 sections are not + functions, and a payload with no owning Exec H2 is `sem.exec_without_function`; +* `Strong`, `Emph` and inline `Code` are interchangeable one-statement carriers; + nested carriers and empty payloads are hard errors; +* `if`/`else`/`while`/`end`/`return`/`params` come from the payload and lower to + the existing `Branch`/`Loop`/`Return`/`Assign`/`Eval` IR; lists, block quotes + and paragraphs are presentation containers; +* control frames cannot cross a heading segment; +* `params(...)` is legal only as the first direct Exec H2 payload; without it the + existing free-variable inference applies and inferred signatures keep the + named-arguments-only rule; +* old syntax (`Strong` execute / `Emph` return / list branch/loop / quote call) + is **not** executable, and `marqdo_semantics`/`syntax` front-matter selectors + are rejected with `sem.unsupported_version_directive`. -Observed in this worktree -([evidence](evidence/2026-11-21-semantic-docs-migration.md)): -`cargo fmt --all -- --check` PASS; `cargo check --workspace --tests --locked` -PASS; `conformance_ast` 4/4 PASS; `docs_consistency` 4/4 PASS; -`conformance_semantics` and `negative` FAIL as expected against the pre-RFC -frontend. The migrated example lock digest was regenerated with the real CLI. +### Verification at `ffd1cc9` (Linux x86_64, Rust 1.100.0) -Remaining work, owners and status: [`migration/README.md`](migration/README.md) -and [`migration/semantic-rewrite-inventory.tsv`](migration/semantic-rewrite-inventory.tsv). -A release is blocked until the frontend, expression parser, stdlib, fixtures and -all gates in RFC-LANG-0002 §12 are green on the same commit. Do not mark this -section complete before that evidence exists. +```text +cargo fmt --all -- --check PASS +cargo clippy --workspace --all-targets -- -D warnings PASS +cargo test --workspace --locked --no-fail-fast PASS + 501 passed, 0 failed, 2 ignored (62 green test targets) +python3 tools/pack-stdlib.py PASS (digest verified) +``` + +Full evidence: [`evidence/2026-11-21-semantics-v2-green.md`](evidence/2026-11-21-semantics-v2-green.md). +The intermediate "text migrated, implementation pending" record is kept as +[`evidence/2026-11-21-semantic-docs-migration.md`](evidence/2026-11-21-semantic-docs-migration.md) +and is superseded by the green gate. + +**Not claimed:** Windows/macOS native lanes and the disposable-VM strict +security lane were not re-run at this SHA. Those remain `UNVERIFIED`; see §1, +§4 and [`../COMPATIBILITY.md`](../COMPATIBILITY.md). The release decision is +still **DO NOT RELEASE** until the platform/security evidence is attached to a +single remote SHA. ## 1. Remote baseline and current evidence -The local baseline for this snapshot is -`24c88bcc78b1c705eb2319e7aaa8822a415eb01f` (2026-11-21). The later +The local language baseline for this snapshot is +`ffd1cc9862f7fe6002b42f1210010c1f78671a95` (2026-11-21, semantics v2 implementation). The later documentation and test migration is recorded by its own commits; re-run the gate before making a release claim. @@ -131,11 +144,11 @@ This is still a **local VM lane**, not a self-hosted GitHub Actions security URL ## 2. Work package status -> **Pre-RFC baseline warning.** Rows and numbers in this section describe work -> executed before the RFC-LANG-0002 syntax migration. The Markdown/AST and -> platform/security rows remain valid; language-source rows (fixtures, control -> mapping, semantic goldens) are historical and are expected red until the -> frontend migration lands. See §0. +> **Historical table note.** Most rows in this section record work executed +> before the RFC-LANG-0002 syntax migration. Language-source rows (fixtures, +> control mapping, semantic goldens) were re-verified after the rewrite at +> `ffd1cc9` (§0); platform/security rows keep their original evidence dates and +> are not refreshed by the language migration. | # | Work package | State | Evidence | |---|---|---|---| @@ -144,8 +157,8 @@ This is still a **local VM lane**, not a self-hosted GitHub Actions security URL | 2 | Cross-platform strict `cfg` | **Fixed locally; native CI UNVERIFIED** | `#[cfg]` dispatch + non-Linux regression test | | 3 | Strict probe→launch race | **Fixed locally; GitHub Linux CI UNVERIFIED** | fail-closed CLI contract + probe-OK/launch-EAGAIN seam test | | 4 | Parallel security matrix isolation | **Fixed** | unique paths + helper `OnceLock`; 7/7 in parallel workspace run | -| 5 | Markdown/power/control-flow corpus | **Pre-RFC evidence; test text migrated, execution pending** | 160 AST + 73 semantic + 45 compile-negative + 2 warning + 21 runtime-negative fixtures after migration; suites expected red | -| 6 | Condition header + source spans | **Historical (old syntax)** | condition headers were removed by RFC-LANG-0002; payload/source-span rules live in `spec/mapping.md` §3 | +| 5 | Markdown/power/control-flow corpus | **Green on semantics v2** | 160 AST + 73 semantic + 47 compile-negative + 2 warning + 21 runtime-negative fixtures; `conformance_ast`/`semantics`/`negative` pass | +| 6 | Payload/control source spans | **Green on semantics v2** | UTF-8 spans, control-expression offsets and heading boundaries covered by fixtures and CLI tests; old condition headers were removed | | 7 | Independent Tool consumers | **Done locally** | `sample-view`/`sample-knowledge`/`sample-proof` E2E test | | 8 | lock v3 reproducibility | **Implemented; tamper test added** | `package_env` PASS | | 9 | Analysis/Trace/Tool/ABI/Foreign | **Implemented; supported-matrix bounded** | protocol tests, plugin/worker/foreign tests | @@ -159,10 +172,9 @@ This is still a **local VM lane**, not a self-hosted GitHub Actions security URL - Frozen Markdown profile `marqdo.md.v1` with 160 AST goldens and explicit CRLF byte semantics (unchanged by the semantic rewrite). -- Native Rust interpreter (pre-RFC mapping) with 73 migrated semantic fixtures, - 45 migrated compile-error fixtures, 2 warning fixtures and 21 runtime-error - fixtures; the executable suites are **expected red** until the frontend - migration lands, so these are not current PASS evidence. +- Native Rust interpreter with the unified semantics: 73 semantic fixtures, + 47 compile-error fixtures, 2 warning fixtures and 21 runtime-error fixtures + all green at `ffd1cc9`; AST profile unchanged (160 goldens). - Native `**` power is pinned end-to-end: right associativity, unary-minus precedence, parentheses, float negative exponents, branch/loop conditions, Strong+CodeSpan payloads, and inert prose/code fences. diff --git a/docs/adr/0052-unified-markdown-semantics.md b/docs/adr/0052-unified-markdown-semantics.md index 1ddf658..9444c1d 100644 --- a/docs/adr/0052-unified-markdown-semantics.md +++ b/docs/adr/0052-unified-markdown-semantics.md @@ -1,6 +1,6 @@ # ADR-0052: Unified Markdown semantics — heading modes, unified payloads and keyword control flow -Status: **Accepted (target contract; frontend implementation pending)** +Status: **Accepted and implemented** Date: 2026-11-21 Supersedes: ADR-0002 in part (executable roles), the AST→program mapping in `spec/mapping.md` and the statement layer in `spec/expression.ebnf` @@ -73,13 +73,11 @@ coexistence, no per-file syntax selector and no `--legacy` path. * Normal emphasis in an Exec section becomes a payload and may fail as an unknown symbol. Authors must use `@knowledge` sections for purely visual emphasis. This is accepted as the price of determinism. -* Until the Rust frontend, expression parser, bundled stdlib and fixtures are - migrated, the implemented CLI does **not** accept this syntax. The tree must - not be released or described as complete during that window. See - `docs/STATUS.md`. -* Test fixtures are migrated as text; execution goldens are expected to be red - until the implementation lands. No test may silently keep asserting the old - mapping as current. +* The Rust frontend, expression parser, bundled stdlib, examples and fixtures + were migrated in the `semantics-v2-refactor` history and the workspace gate is + green at `ffd1cc9` (see `docs/STATUS.md` and + `docs/evidence/2026-11-21-semantics-v2-green.md`). Platform/strict evidence is + tracked separately and is not implied by the language gate. * Migration is AST-role based, not a global regex rewrite; ambiguous cases stop for manual rewrite. diff --git a/docs/adr/README.md b/docs/adr/README.md index 8f82dec..f6fadca 100644 --- a/docs/adr/README.md +++ b/docs/adr/README.md @@ -19,8 +19,8 @@ architecture; read them as decision history. [`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). + `params` keywords. The implementation is green at `ffd1cc9`; 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 diff --git a/docs/architecture/CURRENT.md b/docs/architecture/CURRENT.md index a37cfad..06033e8 100644 --- a/docs/architecture/CURRENT.md +++ b/docs/architecture/CURRENT.md @@ -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 | diff --git a/docs/architecture/README.md b/docs/architecture/README.md index 29edb37..9bb2ac1 100644 --- a/docs/architecture/README.md +++ b/docs/architecture/README.md @@ -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 | diff --git a/docs/architecture/RFC-LANG-0002-unified-semantics.md b/docs/architecture/RFC-LANG-0002-unified-semantics.md index 4068741..f3cf91f 100644 --- a/docs/architecture/RFC-LANG-0002-unified-semantics.md +++ b/docs/architecture/RFC-LANG-0002-unified-semantics.md @@ -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 语义映射。 diff --git a/docs/ci.md b/docs/ci.md index de55335..255ae95 100644 --- a/docs/ci.md +++ b/docs/ci.md @@ -26,14 +26,13 @@ build (depends on test): Node.js 22 is required because the optional foreign-kernel tests use ES-module syntax; Debian bookworm's Node 18 fails those tests. -> **Language-syntax migration note.** `cargo test --workspace` includes -> conformance fixtures that execute `.mq.md` source. The target language is -> [RFC-LANG-0002](architecture/RFC-LANG-0002-unified-semantics.md) while the -> Rust frontend is still being migrated, so those executable-source tests are -> **expected to be red** on a correct migration branch. Do not interpret that as -> a CI-configuration regression or "fix" it by restoring the old mapper or -> regenerating goldens; see [`STATUS.md`](STATUS.md) and -> [`migration/README.md`](migration/README.md). The pipeline definition itself +> **Language contract note.** `cargo test --workspace` includes conformance +> fixtures that execute `.mq.md` source under +> [RFC-LANG-0002](architecture/RFC-LANG-0002-unified-semantics.md). The +> implementation, stdlib digest and corpus are green at `ffd1cc9`; a red +> executable-source suite is a real regression, not an expected migration +> state. Do not "fix" it by restoring the old mapper or regenerating goldens; +> see [`STATUS.md`](STATUS.md). The pipeline definition itself > (fmt/clippy/test/build, security lane, platform gaps) is unchanged. ## What this pipeline does not cover diff --git a/docs/contributor-guide.md b/docs/contributor-guide.md index 754d04f..7b6d7bb 100644 --- a/docs/contributor-guide.md +++ b/docs/contributor-guide.md @@ -8,11 +8,10 @@ with its normative summaries `spec/mapping.md` + `spec/expression.ebnf`, and there are historical and defer to the RFC). Decisions live in `docs/adr/` at their date. -> **Implementation state:** RFC-LANG-0002 and `spec/` are ahead of the Rust -> implementation. The frontend, expression parser and bundled stdlib still -> implement the pre-RFC mapping, so tests that execute Marqdo source are expected -> to be red until the migration lands. Status and evidence are in -> [`STATUS.md`](STATUS.md); the migration rules and inventory are in +> **Implementation state:** RFC-LANG-0002 is implemented by the frontend, +> `marqdo-expression`, IR lowering, runtime and bundled stdlib. The workspace +> gate is green at `ffd1cc9`; status and evidence are in +> [`STATUS.md`](STATUS.md); migration history and the inventory are in > [`migration/README.md`](migration/README.md). ## 1. Repository map @@ -168,10 +167,9 @@ Do not reintroduce the superseded mapping (`Strong`=execute, `Emph`=return, ordered list=branch, bullet list=loop, block quote=call) in new fixtures. Old shape negatives that are now valid inert Markdown must be replaced with negatives for the `sem.*` codes in `spec/mapping.md` §8; genuine runtime -negatives keep their behavior and only change source spelling. Because the -frontend is not migrated yet, executable-source tests are expected to be red: -do not weaken assertions, delete failing tests or refresh goldens to make them -green. Record each migrated active file in +negatives keep their behavior and only change source spelling. Executable-source +tests must stay green; do not weaken assertions, delete failing tests or refresh +goldens just to make a change pass. Record each migrated active file in [`migration/README.md`](migration/README.md) / the migration inventory. If a fixture reveals an implementation bug, fix the code, not the expected @@ -299,9 +297,8 @@ $B run examples/plugin-demo/plugin-call.mq.md \ Notes: `run` defaults to `index.mq.md` and executes `main`; `call` requires a file and function; root-only examples (for example `math.mq.md`) define no `main`. `--mode strict` is expected to refuse to run (ADR-0004). The examples -are being migrated to RFC-LANG-0002 syntax; until the frontend migration lands -the current CLI may not accept them, so a failing example run is not evidence -that the target syntax is already implemented. See [`STATUS.md`](STATUS.md). +implement RFC-LANG-0002 syntax and run on the current CLI (subject to the +capability flags shown above). See [`STATUS.md`](STATUS.md). ## 8. Docs, ADRs and commit policy @@ -350,10 +347,9 @@ that the target syntax is already implemented. See [`STATUS.md`](STATUS.md). `fs.read`), but they are **not** an OS sandbox. The strict sandbox and a package registry remain unimplemented; strict fails closed. See `docs/security-gate.md` and `spec/security.md`. -* The syntax migration is in progress in this tree: `spec/` and the docs - describe RFC-LANG-0002, while the Rust frontend and stdlib still implement - the pre-RFC mapping. Executable-source tests are expected to be red; do not - "fix" them by restoring the old mapping or by regenerating goldens. +* RFC-LANG-0002 is implemented end to end. Keep `spec/`, the frontend, + `marqdo-expression`, stdlib and fixtures in lockstep; do not reintroduce the + old mapping, a per-file syntax selector or stale goldens. * Runtime errors resolve against their owning module (ADR-0017); do not reintroduce entry-file fallback. * The semantic corpus may pin current quirks (for example the external-link diff --git a/docs/evidence/2026-11-21-semantic-docs-migration.md b/docs/evidence/2026-11-21-semantic-docs-migration.md index 9a3aa48..b259406 100644 --- a/docs/evidence/2026-11-21-semantic-docs-migration.md +++ b/docs/evidence/2026-11-21-semantic-docs-migration.md @@ -1,8 +1,10 @@ # 2026-11-21 — RFC-LANG-0002 documentation and test-text migration -Status: **partial evidence**. This records the repository-wide *text* migration -to the single syntax, not an implementation of the frontend. Semantic and -negative suites are expected red; see the tail of this file. +Status: **intermediate / superseded by** +[`2026-11-21-semantics-v2-green.md`](2026-11-21-semantics-v2-green.md). +This records the documentation/test-text step before the frontend was +implemented; the red results in the tail are historical for that intermediate +commit, not the current state. - Repository: `cflmy/marqdo-cli` - Worktree base: `0d8ed44` (`feat(http): parse and build HTTP/1.1 framing by bytes`), diff --git a/docs/evidence/2026-11-21-semantics-v2-green.md b/docs/evidence/2026-11-21-semantics-v2-green.md new file mode 100644 index 0000000..4efb132 --- /dev/null +++ b/docs/evidence/2026-11-21-semantics-v2-green.md @@ -0,0 +1,73 @@ +# 2026-11-21 — RFC-LANG-0002 implementation gate + +Status: **green for the implementation commit `ffd1cc9` on Linux x86_64**. +This supersedes the intermediate "text migrated, implementation pending" state +recorded in [`2026-11-21-semantic-docs-migration.md`](2026-11-21-semantic-docs-migration.md). + +- Repository: `cflmy/marqdo-cli`, branch `semantics-v2-refactor` +- Code commit: `ffd1cc9862f7fe6002b42f1210010c1f78671a95` +- Previous steps: `4983542` (docs/spec), `e029853` (breaking implementation) +- Toolchain: Rust 1.100.0, Linux x86_64 +- Authority: [`../architecture/RFC-LANG-0002-unified-semantics.md`](../architecture/RFC-LANG-0002-unified-semantics.md), + [`../adr/0052-unified-markdown-semantics.md`](../adr/0052-unified-markdown-semantics.md) + +## Commands and results + +```text +cargo fmt --all -- --check + PASS + +cargo clippy --workspace --all-targets -- -D warnings + PASS + +cargo test --workspace --locked --no-fail-fast + PASS: 501 passed, 0 failed, 2 ignored + (62 test binaries/doctest targets all `ok`) + +python3 tools/pack-stdlib.py + PASS: stdlib.json digest matches the migrated tree +``` + +Targeted suites relevant to the language rewrite: + +```text +conformance_ast 4 passed (160 AST goldens, profile unchanged) +conformance_semantics 1 passed (73 fixtures, values/stdout preserved) +negative 3 passed (47 hard-error + 2 warning + 21 runtime) +properties passed (prose/container invariance) +integration_cli 21 passed (init/check/run/call/inspect/fmt/lock) +stdlib_product 16 passed (migrated bundled stdlib) +p2_closure passed (hash table/allocator fixtures in pure mode) +docs_consistency 4 passed +``` + +## What the implementation covers + +- heading `@exec`/`@knowledge` declarations with ancestor inheritance; only an + Exec H2 is callable; H2 Knowledge and H3–H6 sections never become functions; +- unified `Strong`/`Emph`/inline `Code` payloads, single ownership, nested + carrier rejection, empty-payload rejection and precise UTF-8 spans; +- a separate statement grammar in `marqdo-expression` for + `if/else/while/end/return/params`, reserved words and payload-relative spans; +- frontend control-stack lowering to the existing `Branch`/`Loop`/`Return` IR, + with heading-segment boundaries and no cross-heading `end`; +- `params(...)` only as the first direct Exec H2 payload; existing free-variable + inference (named arguments only) otherwise; +- `sem.*` diagnostics including mode marker, unit name/duplicate, exec without + function, payload nesting/empty, syntax, unmatched/duplicate else/end, + unclosed control, signature position, unsupported version directive, + inferred-signature lint and `run`'s no-entry-function error; +- migrated `stdlib/**/*.mq.md` with a regenerated `stdlib/stdlib.json` digest; +- migrated examples, semantics/negative/runtime corpus and Rust-embedded + fixtures. + +## Not claimed by this evidence + +- Windows and macOS native test lanes were **not** run from this checkout + (`UNVERIFIED`); no remote CI URL exists for `ffd1cc9`. +- The disposable-VM strict security lane was **not** re-run at this SHA. The + in-tree `marqdo-sandbox` security tests and the workspace suite pass, but + that is not the same evidence. +- No release tag is cut; release gates and platform evidence remain governed by + [`../STABLE_RELEASE_IMPLEMENTATION.md`](../STABLE_RELEASE_IMPLEMENTATION.md) + and [`../security-gate.md`](../security-gate.md). diff --git a/docs/migration/README.md b/docs/migration/README.md index d2871f6..4e65eeb 100644 --- a/docs/migration/README.md +++ b/docs/migration/README.md @@ -1,10 +1,11 @@ # Semantic rewrite: migration guide and inventory -Status: **migration in progress**. The target language contract is +Status: **complete**. The language contract is [RFC-LANG-0002](../architecture/RFC-LANG-0002-unified-semantics.md) and -[`spec/mapping.md`](../../spec/mapping.md). The Rust frontend and bundled -stdlib are **not yet migrated**, so executable tests are expected to be red -until the implementation lands. See [`../STATUS.md`](../STATUS.md). +[`spec/mapping.md`](../../spec/mapping.md); the frontend, statement parser, +runtime and bundled stdlib implement it. See [`../STATUS.md`](../STATUS.md) +and the green gate in +[`../evidence/2026-11-21-semantics-v2-green.md`](../evidence/2026-11-21-semantics-v2-green.md). This directory records the repository-wide migration required by the RFC: every active `.mq.md` source, example, fixture and documentation snippet must @@ -12,21 +13,25 @@ use the single new syntax. Old syntax is not an active language. ## Current state (2026-11-21) -- **Text migration: complete.** Specs, active docs, examples, all non-stdlib - test/fixture `.mq.md` files, the security-lane embedded fixtures and - Rust-embedded `.mq.md` literals were rewritten. 1009 present tracked+new files are - classified in the inventory; there are no `pending` text items. -- **Implementation: pending.** 51 inventory rows remain - `pending-implementation`: the 9 frontend/expression/IR files that implement - the mapping and the 42 stdlib fileset entries (sources + manifest). -- **Verification:** `cargo fmt --check`, `cargo check --workspace --tests`, - `conformance_ast` (4/4) and `docs_consistency` (4/4) pass. The semantic, - negative, property and CLI suites that execute Marqdo source are expected red - against the pre-RFC frontend. Evidence: +- **Complete.** Specs, active docs, examples, all test/fixture `.mq.md` files, + the security-lane embedded fixtures, Rust-embedded literals and the bundled + `stdlib/**/*.mq.md` sources use the single syntax. 1015 present tracked+new + files are classified in the inventory: 0 `pending`, 0 + `pending-implementation`. +- **Implementation:** frontend heading modes and segments, the unified payload + mapper, the `marqdo-expression` statement grammar, control-stack lowering, + `params(...)`/inference and the `sem.*` diagnostics are implemented. +- **Verification at `ffd1cc9`:** `cargo fmt --check`, `cargo clippy -D warnings` + and `cargo test --workspace --locked` (501 passed, 0 failed, 2 ignored) all + pass; `python3 tools/pack-stdlib.py` verifies the regenerated digest. + Evidence: [`../evidence/2026-11-21-semantics-v2-green.md`](../evidence/2026-11-21-semantics-v2-green.md). + The earlier intermediate record is kept at [`../evidence/2026-11-21-semantic-docs-migration.md`](../evidence/2026-11-21-semantic-docs-migration.md). - Old v1 compile-negative fixtures were deleted and replaced by new-semantic negatives; they are intentionally absent from the inventory rather than counted as reviewed. +- Platform CI and the disposable-VM strict lane were not re-run by the language + migration; they remain separate release gates. ## Migration rules for this repository diff --git a/docs/migration/semantic-rewrite-inventory.tsv b/docs/migration/semantic-rewrite-inventory.tsv index 612c2cc..97267f5 100644 --- a/docs/migration/semantic-rewrite-inventory.tsv +++ b/docs/migration/semantic-rewrite-inventory.tsv @@ -13,61 +13,62 @@ LICENSE-APACHE non-semantic no none none - n/a reviewed LICENSE-MIT non-semantic no none none - n/a reviewed README.md tutorial yes old mapping rewrite docs review migrated crates/cli/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed -crates/cli/src/analysis.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated +crates/cli/src/analysis.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/args.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/commands.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/commands/check.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/cli/src/commands/init.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated +crates/cli/src/commands/init.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/commands/inspect.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/commands/package.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/commands/run.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/commands/sandbox.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/commands/tool.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/loader.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/cli/src/main.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated +crates/cli/src/main.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/output.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/cli/src/stdlib.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated +crates/cli/src/stdlib.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/tool.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/cli/src/trace.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/cli/tests/analysis_trace.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated +crates/cli/tests/analysis_trace.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/architecture_boundaries.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/conformance_ast.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/conformance_semantics.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/docs_consistency.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/examples_r6.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed -crates/cli/tests/http_over_tcp.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated -crates/cli/tests/integration_cli.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated +crates/cli/tests/http_over_tcp.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed +crates/cli/tests/integration_cli.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/negative.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed -crates/cli/tests/p2_closure.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated -crates/cli/tests/package_env.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated -crates/cli/tests/plugin_worker.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated -crates/cli/tests/print_routing.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated -crates/cli/tests/properties.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated -crates/cli/tests/resource_streams.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated -crates/cli/tests/stdlib_bundle.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated +crates/cli/tests/p2_closure.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed +crates/cli/tests/package_env.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed +crates/cli/tests/plugin_worker.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed +crates/cli/tests/print_routing.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed +crates/cli/tests/properties.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed +crates/cli/tests/resource_streams.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed +crates/cli/tests/stdlib_bundle.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/stdlib_http.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/stdlib_product.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/stdlib_table.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/cli/tests/tool_protocol.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/marqdo-expression/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-expression/src/ast.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation -crates/marqdo-expression/src/lexer.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation +crates/marqdo-expression/src/ast.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated +crates/marqdo-expression/src/lexer.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated crates/marqdo-expression/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-expression/src/parser.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation +crates/marqdo-expression/src/parser.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated +crates/marqdo-expression/src/statement.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-foreign/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-foreign/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-foreign/tests/kernels.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/marqdo-foreign/tests/provider.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/marqdo-frontend/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-frontend/src/analyze.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation +crates/marqdo-frontend/src/analyze.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated crates/marqdo-frontend/src/calls.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-frontend/src/infer.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-frontend/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-frontend/src/map.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation -crates/marqdo-frontend/src/payload.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation -crates/marqdo-frontend/src/resources.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated -crates/marqdo-frontend/src/signature.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation -crates/marqdo-frontend/src/units.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation +crates/marqdo-frontend/src/map.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated +crates/marqdo-frontend/src/payload.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated +crates/marqdo-frontend/src/resources.rs rust-source yes not syntax-bearing review language cargo test reviewed +crates/marqdo-frontend/src/signature.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated +crates/marqdo-frontend/src/units.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated crates/marqdo-host/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-host/include/marqdo_resource_provider.h rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-host/src/budget.rs rust-source yes not syntax-bearing review language cargo test reviewed @@ -96,7 +97,7 @@ crates/marqdo-host/tests/worker_provider.rs rust-test yes embedded old syntax mi crates/marqdo-ir/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-ir/src/builtins.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-ir/src/callable.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-ir/src/lib.rs rust-source yes old mapping implement RFC-LANG-0002 language cargo test pending-implementation +crates/marqdo-ir/src/lib.rs rust-source yes old mapping implemented RFC-LANG-0002 language cargo test migrated crates/marqdo-markdown/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-markdown/src/ast.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-markdown/src/frontmatter.rs rust-source yes not syntax-bearing review language cargo test reviewed @@ -111,8 +112,8 @@ crates/marqdo-math/src/lib.rs rust-source yes not syntax-bearing review language crates/marqdo-math/src/parse.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-math/tests/kernel.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/marqdo-package/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-package/src/fileset.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated -crates/marqdo-package/src/lib.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated +crates/marqdo-package/src/fileset.rs rust-source yes not syntax-bearing review language cargo test reviewed +crates/marqdo-package/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-plugin-abi/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-plugin-abi/src/abi.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-plugin-abi/src/artifact.rs rust-source yes not syntax-bearing review language cargo test reviewed @@ -139,7 +140,7 @@ crates/marqdo-runtime/src/interpreter.rs rust-source yes not syntax-bearing revi crates/marqdo-runtime/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-runtime/src/memory.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-runtime/src/value_ops.rs rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-runtime/tests/interpreter.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test migrated +crates/marqdo-runtime/tests/interpreter.rs rust-test yes embedded old syntax migrate embedded .mq.md strings language cargo test reviewed crates/marqdo-sandbox/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-sandbox/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-sandbox/src/linux.rs rust-source yes not syntax-bearing review language cargo test reviewed @@ -147,19 +148,19 @@ crates/marqdo-sandbox/tests/security_linux.rs rust-test yes embedded old syntax crates/marqdo-span/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-span/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-value/Cargo.toml rust-source yes not syntax-bearing review language cargo test reviewed -crates/marqdo-value/src/diagnostic.rs rust-source yes embedded text/help migrate embedded .mq.md text only language cargo test migrated +crates/marqdo-value/src/diagnostic.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-value/src/error.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-value/src/lib.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-value/src/value.rs rust-source yes not syntax-bearing review language cargo test reviewed crates/marqdo-value/src/wire.rs rust-source yes not syntax-bearing review language cargo test reviewed -docs/CORE_STABILIZATION_AND_ECOSYSTEM_GATE.md tutorial yes old mapping rewrite + historical banner where needed docs docs_consistency migrated -docs/DEVELOPMENT_BLUEPRINT.md tutorial yes old mapping rewrite + historical banner where needed docs docs_consistency migrated -docs/EXTENSIBILITY_AUDIT.md tutorial yes old mapping rewrite + historical banner where needed docs docs_consistency migrated +docs/CORE_STABILIZATION_AND_ECOSYSTEM_GATE.md tutorial yes none reviewed docs review reviewed +docs/DEVELOPMENT_BLUEPRINT.md tutorial yes none reviewed docs review reviewed +docs/EXTENSIBILITY_AUDIT.md tutorial yes none reviewed docs review reviewed docs/MARQDO_COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md architecture yes compute RFC migrate examples / mark historical spelling docs review migrated docs/MARQDO_COMPUTE_MACHINE_RFC_0001.md architecture yes compute RFC migrate examples / mark historical spelling docs review migrated -docs/NEXT_PHASE_IMPLEMENTATION.md tutorial yes old mapping rewrite + historical banner where needed docs docs_consistency migrated -docs/NEXT_RELEASE_CI_CONVERGENCE.md tutorial yes old mapping rewrite + historical banner where needed docs docs_consistency migrated -docs/STABLE_RELEASE_IMPLEMENTATION.md tutorial yes old mapping rewrite + historical banner where needed docs docs_consistency migrated +docs/NEXT_PHASE_IMPLEMENTATION.md tutorial yes none reviewed docs review reviewed +docs/NEXT_RELEASE_CI_CONVERGENCE.md tutorial yes none reviewed docs review reviewed +docs/STABLE_RELEASE_IMPLEMENTATION.md tutorial yes none reviewed docs review reviewed docs/STATUS.md tutorial yes old mapping rewrite + historical banner where needed docs docs_consistency migrated docs/adr/0001-crate-graph-and-span-foundation.md historical no decision at its date banner if syntax-role docs review historical docs/adr/0002-executables-only-in-function-bodies.md historical no decision at its date banner if syntax-role docs review historical @@ -273,6 +274,7 @@ docs/evidence/2026-11-21-random-product.md historical no archived banner only do docs/evidence/2026-11-21-regex-extension.md historical no archived banner only docs review historical docs/evidence/2026-11-21-resource-operation.md historical no archived banner only docs review historical docs/evidence/2026-11-21-semantic-docs-migration.md evidence yes old syntax record migration evidence docs docs_consistency migrated +docs/evidence/2026-11-21-semantics-v2-green.md historical no archived banner only docs review historical docs/evidence/2026-11-21-stdio-streams.md historical no archived banner only docs review historical docs/evidence/2026-11-21-tls-endpoint.md historical no archived banner only docs review historical docs/evidence/RELEASE_CANDIDATE_0.1.0_8af7262.md historical no archived banner only docs review historical @@ -350,48 +352,48 @@ spec/tool-v1.md spec yes old mapping in-place rewrite language cargo test / revi spec/trace-v1.md spec yes old mapping in-place rewrite language cargo test / review migrated spec/trace-v2.md spec yes old mapping in-place rewrite language cargo test / review migrated spec/value-wire.md spec yes old mapping in-place rewrite language cargo test / review migrated -stdlib/README.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/clock.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/compress.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/data/csv.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/data/json.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/data/table.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/datetime.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/demo.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/env.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/format.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/fs/file.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/io.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/io/console.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/io/stream.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/net/http.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/path.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/process.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/random.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/regex.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/stdlib.json stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/clock.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/compress.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/console.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/csv.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/datetime.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/demo.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/env.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/format.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/fs.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/http.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/io.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/json.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/path.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/process.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/random.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/regex.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/stream.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/table.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/text.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/tests/utf8.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/text.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation -stdlib/text/utf8.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product pending-implementation +stdlib/README.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product reviewed +stdlib/clock.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/compress.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/data/csv.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/data/json.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/data/table.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/datetime.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/demo.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/env.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/format.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/fs/file.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/io.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/io/console.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/io/stream.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/net/http.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/path.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/process.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/random.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/regex.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/stdlib.json stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product reviewed +stdlib/tests/clock.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/compress.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/console.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/csv.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/datetime.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/demo.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/env.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/format.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/fs.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/http.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/io.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/json.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/path.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/process.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/random.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/regex.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/stream.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/table.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/text.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/tests/utf8.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/text.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated +stdlib/text/utf8.mq.md stdlib yes old syntax migrate with frontend + digest stdlib stdlib_product migrated tests/README.md test yes old syntax migrate source/expectations tests negative/properties migrated tests/abi/capability_plugin.c test yes harness review tests review reviewed tests/architecture/README.md test yes harness review tests review reviewed @@ -866,96 +868,100 @@ tests/consumers/trace_consumer.py test yes harness review tests review reviewed tests/consumers/validate_protocols.py test yes harness review tests review reviewed tests/e2e/README.md test yes harness review tests review reviewed tests/fixtures/tool_echo.rs test yes harness review tests review reviewed -tests/negative/01-invalid-mode-marker-case.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/01-invalid-mode-marker-case.expected.json test yes harness review tests review reviewed tests/negative/01-invalid-mode-marker-case.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/02-invalid-mode-marker-misspelled.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/02-invalid-mode-marker-misspelled.expected.json test yes harness review tests review reviewed tests/negative/02-invalid-mode-marker-misspelled.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/03-invalid-mode-marker-conflict.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/03-invalid-mode-marker-conflict.expected.json test yes harness review tests review reviewed tests/negative/03-invalid-mode-marker-conflict.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/04-empty-unit-name-exec.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/04-empty-unit-name-exec.expected.json test yes harness review tests review reviewed tests/negative/04-empty-unit-name-exec.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/05-empty-unit-name-knowledge.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/05-empty-unit-name-knowledge.expected.json test yes harness review tests review reviewed tests/negative/05-empty-unit-name-knowledge.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/06-exec-without-function-under-knowledge.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/06-exec-without-function-under-knowledge.expected.json test yes harness review tests review reviewed tests/negative/06-exec-without-function-under-knowledge.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/07-exec-without-function-under-h1.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/07-exec-without-function-under-h1.expected.json test yes harness review tests review reviewed tests/negative/07-exec-without-function-under-h1.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/08-payload-nested-strong-emph.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/08-payload-nested-strong-emph.expected.json test yes harness review tests review reviewed tests/negative/08-payload-nested-strong-emph.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/09-payload-nested-strong-strong.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/09-payload-nested-strong-strong.expected.json test yes harness review tests review reviewed tests/negative/09-payload-nested-strong-strong.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/10-payload-nested-strong-link.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/10-payload-nested-strong-link.expected.json test yes harness review tests review reviewed tests/negative/10-payload-nested-strong-link.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/11-payload-nested-strong-math.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/11-payload-nested-strong-math.expected.json test yes harness review tests review reviewed tests/negative/11-payload-nested-strong-math.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/12-payload-nested-strong-strikethrough.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/12-payload-nested-strong-strikethrough.expected.json test yes harness review tests review reviewed tests/negative/12-payload-nested-strong-strikethrough.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/13-payload-nested-emph-strong.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/13-payload-nested-emph-strong.expected.json test yes harness review tests review reviewed tests/negative/13-payload-nested-emph-strong.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/14-payload-nested-emph-emph.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/14-payload-nested-emph-emph.expected.json test yes harness review tests review reviewed tests/negative/14-payload-nested-emph-emph.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/15-payload-nested-linebreak.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/15-payload-nested-linebreak.expected.json test yes harness review tests review reviewed tests/negative/15-payload-nested-linebreak.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/16-empty-payload-strong.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/16-empty-payload-strong.expected.json test yes harness review tests review reviewed tests/negative/16-empty-payload-strong.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/17-empty-payload-emph.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/17-empty-payload-emph.expected.json test yes harness review tests review reviewed tests/negative/17-empty-payload-emph.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/18-syntax-if-missing-operand.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/18-syntax-if-missing-operand.expected.json test yes harness review tests review reviewed tests/negative/18-syntax-if-missing-operand.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/19-syntax-if-trailing-colon.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/19-syntax-if-trailing-colon.expected.json test yes harness review tests review reviewed tests/negative/19-syntax-if-trailing-colon.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/20-syntax-end-if.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/20-syntax-end-if.expected.json test yes harness review tests review reviewed tests/negative/20-syntax-end-if.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/21-syntax-return-missing-value.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/21-syntax-return-missing-value.expected.json test yes harness review tests review reviewed tests/negative/21-syntax-return-missing-value.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/22-syntax-multi-statement-payload.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/22-syntax-multi-statement-payload.expected.json test yes harness review tests review reviewed tests/negative/22-syntax-multi-statement-payload.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/23-syntax-malformed-params.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/23-syntax-malformed-params.expected.json test yes harness review tests review reviewed tests/negative/23-syntax-malformed-params.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/24-unmatched-else.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/24-unmatched-else.expected.json test yes harness review tests review reviewed tests/negative/24-unmatched-else.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/25-duplicate-else.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/25-duplicate-else.expected.json test yes harness review tests review reviewed tests/negative/25-duplicate-else.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/26-unmatched-end.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/26-unmatched-end.expected.json test yes harness review tests review reviewed tests/negative/26-unmatched-end.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/27-unclosed-control-if.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/27-unclosed-control-if.expected.json test yes harness review tests review reviewed tests/negative/27-unclosed-control-if.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/28-unclosed-control-while.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/28-unclosed-control-while.expected.json test yes harness review tests review reviewed tests/negative/28-unclosed-control-while.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/29-control-across-heading.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/29-control-across-heading.expected.json test yes harness review tests review reviewed tests/negative/29-control-across-heading.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/30-signature-position-after-statement.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/30-signature-position-after-statement.expected.json test yes harness review tests review reviewed tests/negative/30-signature-position-after-statement.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/31-signature-position-in-list.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/31-signature-position-in-list.expected.json test yes harness review tests review reviewed tests/negative/31-signature-position-in-list.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/32-signature-position-duplicate.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/32-signature-position-duplicate.expected.json test yes harness review tests review reviewed tests/negative/32-signature-position-duplicate.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/33-unsupported-version-directive.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/33-unsupported-version-directive.expected.json test yes harness review tests review reviewed tests/negative/33-unsupported-version-directive.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/34-unsupported-syntax-selection.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/34-unsupported-syntax-selection.expected.json test yes harness review tests review reviewed tests/negative/34-unsupported-syntax-selection.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/35-unknown-function.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/35-unknown-function.expected.json test yes harness review tests review reviewed tests/negative/35-unknown-function.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/36-unknown-variable.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/36-unknown-variable.expected.json test yes harness review tests review reviewed tests/negative/36-unknown-variable.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/37-call-arity-missing-argument.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/37-call-arity-missing-argument.expected.json test yes harness review tests review reviewed tests/negative/37-call-arity-missing-argument.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/38-call-arity-unknown-named.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/38-call-arity-unknown-named.expected.json test yes harness review tests review reviewed tests/negative/38-call-arity-unknown-named.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/39-uninitialized-partial-branch.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/39-uninitialized-partial-branch.expected.json test yes harness review tests review reviewed tests/negative/39-uninitialized-partial-branch.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/40-frontmatter-invalid-yaml.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/40-frontmatter-invalid-yaml.expected.json test yes harness review tests review reviewed tests/negative/40-frontmatter-invalid-yaml.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/41-frontmatter-invalid-import-shape.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/41-frontmatter-invalid-import-shape.expected.json test yes harness review tests review reviewed tests/negative/41-frontmatter-invalid-import-shape.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/42-frontmatter-duplicate-import-alias.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/42-frontmatter-duplicate-import-alias.expected.json test yes harness review tests review reviewed tests/negative/42-frontmatter-duplicate-import-alias.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/43-unknown-variable-with-signature.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/43-unknown-variable-with-signature.expected.json test yes harness review tests review reviewed tests/negative/43-unknown-variable-with-signature.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/44-duplicate-function-name.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/44-duplicate-function-name.expected.json test yes harness review tests review reviewed tests/negative/44-duplicate-function-name.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/45-duplicate-namespace-name.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/45-duplicate-namespace-name.expected.json test yes harness review tests review reviewed tests/negative/45-duplicate-namespace-name.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated +tests/negative/46-else-under-while.expected.json test yes harness review tests review reviewed +tests/negative/46-else-under-while.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated +tests/negative/47-signature-position-in-quote.expected.json test yes harness review tests review reviewed +tests/negative/47-signature-position-in-quote.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated tests/negative/runtime/01-division-by-zero.expected.json test yes harness review tests review reviewed tests/negative/runtime/01-division-by-zero.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated tests/negative/runtime/02-type-error.expected.json test yes harness review tests review reviewed @@ -998,12 +1004,12 @@ tests/negative/runtime/20-table-cell-out-of-bounds.expected.json test yes harnes tests/negative/runtime/20-table-cell-out-of-bounds.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated tests/negative/runtime/21-map-key-not-text.expected.json test yes harness review tests review reviewed tests/negative/runtime/21-map-key-not-text.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/warnings/01-inferred-signature.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/warnings/01-inferred-signature.expected.json test yes harness review tests review reviewed tests/negative/warnings/01-inferred-signature.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated -tests/negative/warnings/02-knowledge-and-containers-are-inert.expected.json test yes old syntax migrate source/expectations tests negative/properties migrated +tests/negative/warnings/02-knowledge-and-containers-are-inert.expected.json test yes harness review tests review reviewed tests/negative/warnings/02-knowledge-and-containers-are-inert.mq.md test yes old negative shape rebuild for sem.* diagnostics tests negative migrated tests/security/escape_helper.c test yes harness review tests review reviewed -tests/security/run-lane.sh test yes old syntax migrate source/expectations tests negative/properties migrated +tests/security/run-lane.sh test yes harness review tests review reviewed tools/dev-only/check-mq-syntax.py tooling yes migration aid review docs review reviewed tools/dev-only/gen-migration-inventory.py tooling yes migration aid review docs review reviewed tools/pack-stdlib.py tooling yes migration aid review docs review reviewed diff --git a/docs/releasing.md b/docs/releasing.md index 528fd2a..4b54136 100644 --- a/docs/releasing.md +++ b/docs/releasing.md @@ -9,14 +9,15 @@ required CI matrix on the exact commit. - All applicable gates in [`NEXT_RELEASE_CI_CONVERGENCE.md`](NEXT_RELEASE_CI_CONVERGENCE.md) §7 are PASS with a CI URL for the same SHA. -- **Language migration is closed for the release SHA.** The source language is - [RFC-LANG-0002](architecture/RFC-LANG-0002-unified-semantics.md); the - release notes must state that this is a **breaking** change and that - pre-RFC `.mq.md` sources are not executable (no `--legacy` path). The - migration inventory must be 100% classified, `stdlib/**/*.mq.md` and examples - migrated, and executable-source tests green on the migrated tree. Until then - this document describes a candidate only, never a releasable state; see - [`STATUS.md`](STATUS.md) and [`migration/README.md`](migration/README.md). +- **Language migration is closed through the release SHA.** The source language + is [RFC-LANG-0002](architecture/RFC-LANG-0002-unified-semantics.md); the + release notes must state that this is a **breaking** change and that pre-RFC + `.mq.md` sources are not executable (no `--legacy` path). The migration + inventory is 100% classified, `stdlib/**/*.mq.md` and examples are migrated, + and executable-source tests are green at `ffd1cc9`; re-run them for the actual + release SHA. Platform and strict-lane evidence are still required before this + is a releasable state; see [`STATUS.md`](STATUS.md) and + [`migration/README.md`](migration/README.md). - G-C is either PASS with a security-lane URL, or the release explicitly says strict isolation is unavailable. Never claim G-C from local root/sudo runs. - `git status --porcelain` is clean apart from intended release files. @@ -61,9 +62,9 @@ skip the license requirement: add them before shipping. ## 4. Clean-install smoke Run in a fresh directory (not the source tree). The example commands below -assume the examples have been migrated to RFC-LANG-0002 and are accepted by the -frozen binary; a failing example run on an un-migrated tree is not a release -signal: +assume the examples are migrated to RFC-LANG-0002 and accepted by the frozen +binary; a failing example run is a release blocker, not a known migration +artifact: ```bash tmp="$(mktemp -d)" diff --git a/docs/security-gate.md b/docs/security-gate.md index d7b2fe6..c79e643 100644 --- a/docs/security-gate.md +++ b/docs/security-gate.md @@ -10,14 +10,15 @@ Snapshot: workspace `0.1.0`, 2026-11-20. See ADR-0021. > **Language-syntax migration note.** This evidence predates RFC-LANG-0002 > ([`architecture/RFC-LANG-0002-unified-semantics.md`](architecture/RFC-LANG-0002-unified-semantics.md)): -> the `.mq.md` fixtures and the example paths used by the lane are being -> migrated to the unified syntax, and the lane must be re-run on the migrated -> tree before it is cited as evidencing the new syntax. The **security facts +> the `.mq.md` fixtures and the example paths used by the lane are migrated to +> the unified syntax, but the lane has **not** been re-run at the language SHA +> `ffd1cc9`; re-run it before citing this evidence for the current syntax. The **security facts > here do not change** — `@exec` is a compile-time projection, not a capability > grant; `@knowledge` produces no IR and therefore no host effect; resource, > file, network, stdin/stdout, memory and budget checks remain at the > `CapabilityHost` boundary, and the strict sandbox is unaffected. See -> [`STATUS.md`](STATUS.md) for the current red/green state. +> [`STATUS.md`](STATUS.md) for the language gate and +> [`evidence/2026-11-21-semantics-v2-green.md`](evidence/2026-11-21-semantics-v2-green.md). This report separates three things that are often conflated: diff --git a/docs/security-vm.md b/docs/security-vm.md index e35b9bb..a298e70 100644 --- a/docs/security-vm.md +++ b/docs/security-vm.md @@ -6,11 +6,11 @@ records how that VM was built so the result can be reproduced and so the VM can be registered as a dedicated self-hosted security runner. > **Language-syntax migration note.** The lane fixtures are `.mq.md` sources and -> are being migrated to RFC-LANG-0002 +> are migrated to RFC-LANG-0002 > ([`architecture/RFC-LANG-0002-unified-semantics.md`](architecture/RFC-LANG-0002-unified-semantics.md)). -> Re-run `tests/security/run-lane.sh` on the migrated tree before using this VM -> as evidence for the new syntax; the VM/OS-isolation procedure itself is -> unchanged. See [`STATUS.md`](STATUS.md). +> The lane has not been re-run at `ffd1cc9`; run `tests/security/run-lane.sh` on +> the migrated tree before using this VM as evidence for the current syntax. The +> VM/OS-isolation procedure itself is unchanged. See [`STATUS.md`](STATUS.md). **Do not run this on a daily host with valuable data.** The VM is disposable; the commands below do not disable AppArmor or any global host protection. diff --git a/spec/mapping.md b/spec/mapping.md index e4c8662..38cef01 100644 --- a/spec/mapping.md +++ b/spec/mapping.md @@ -4,12 +4,9 @@ Status: **current language contract, breaking rewrite (RFC-LANG-0002)**. This file replaces the earlier Strong/Emph/List/Quote mapping in place; there is no second active mapping and no per-file syntax selector. -> **Implementation state:** this document is normative for the target language, -> but the Rust frontend in this checkout still implements the pre-RFC mapping. -> Tests that exercise executable Marqdo source are therefore expected to be red -> until the frontend migration lands. See `docs/STATUS.md` and -> `docs/migration/semantic-rewrite-inventory.tsv`. Do not read this document as -> evidence that the CLI already supports the syntax. +> **Implementation state:** implemented by `marqdo-frontend` and +> `marqdo-expression`; the workspace gate is green at `ffd1cc9` (see +> `docs/STATUS.md` and `docs/evidence/2026-11-21-semantics-v2-green.md`). Authority: `docs/architecture/RFC-LANG-0002-unified-semantics.md`. Markdown parsing remains `marqdo.md.v1` (`spec/markdown-profile.md`); only the @@ -283,9 +280,11 @@ Rules: block quote. It is compile-time metadata and may be preceded by prose or a Knowledge subsection but not by an executing statement. Violations are `sem.signature_position`; a duplicate declaration is also rejected. -* A function without `params` keeps the existing free-variable inference for - the first version. Public functions should declare `params`; the optional - `sem.inferred_signature` lint may be enabled. +* A function without `params` keeps the existing free-variable inference. + As before, an inferred signature accepts **named arguments only**; declare + `params(...)` to accept positional arguments. Public functions should declare + `params`; the optional `sem.inferred_signature` lint is emitted for an + inferred signature that actually has parameters. * Calls are ordinary expressions. `print(1)`, `f(n=5)` and `> **print(1)**` all call because the payload contains a call; the block quote itself does not create a call. A plain `> print(1)` is inert prose. diff --git a/tests/README.md b/tests/README.md index 6068bd2..d76112d 100644 --- a/tests/README.md +++ b/tests/README.md @@ -9,19 +9,17 @@ so they can be rendered, diffed and reviewed like Markdown documents. Everything here is data. Nothing in this directory modifies the repository, and no test commits, copies or rewrites files outside a throw-away temp directory. -> **Migration state (RFC-LANG-0002).** The source text in this corpus uses the -> current single syntax. The Rust frontend still implements the pre-RFC mapping, -> so the semantic, negative, property and CLI suites that execute Marqdo source -> are **expected to be red** until the frontend migration lands. `conformance_ast` -> is unaffected by the semantic change (the Markdown profile is unchanged). -> `tests/negative/warnings/01-inferred-signature` pins the optional -> `sem.inferred_signature` lint as enabled; the current frontend does not emit -> it. `sem.no_entry_function` is a `run` entry-selection diagnostic and cannot be -> pinned by `crates/cli/tests/negative.rs`, which only calls `analyze_source` / -> `marqdo_runtime::run`; that coverage needs a CLI integration test. Do not -> regenerate goldens or restore the old mapper to turn these suites green. See -> [`../docs/STATUS.md`](../docs/STATUS.md) and -> [`../docs/migration/README.md`](../docs/migration/README.md). +> **Language state (RFC-LANG-0002).** The corpus uses the single current syntax +> and the executable suites are green at `ffd1cc9` (501 workspace tests). +> `conformance_ast` is unaffected by the semantic change (the Markdown profile +> is unchanged). `tests/negative/warnings/01-inferred-signature` pins the +> optional `sem.inferred_signature` lint as enabled for a function that actually +> has inferred parameters. `sem.no_entry_function` is a `run` entry-selection +> diagnostic, so it is pinned by the CLI integration test +> `run_reports_sem_no_entry_function_without_exec_main`, not by +> `crates/cli/tests/negative.rs`. Do not regenerate goldens or restore the old +> mapper to make a failing suite pass. See [`../docs/STATUS.md`](../docs/STATUS.md) +> and [`../docs/migration/README.md`](../docs/migration/README.md). ## Layout diff --git a/tools/dev-only/gen-migration-inventory.py b/tools/dev-only/gen-migration-inventory.py index eb0e0ca..28fbfa0 100644 --- a/tools/dev-only/gen-migration-inventory.py +++ b/tools/dev-only/gen-migration-inventory.py @@ -109,7 +109,8 @@ def classify(path: str, changed_set: set[str]) -> tuple[str, str, str, str, str, return ("spec", "yes", "old mapping", "in-place rewrite", "language", "cargo test / review", "migrated") if path.endswith(".mq.md"): if path.startswith("stdlib/"): - return ("stdlib", "yes", "old syntax", "migrate with frontend + digest", "stdlib", "stdlib_product", "pending-implementation") + status = "migrated" if NEW_MARKERS.search(text) else "pending" + return ("stdlib", "yes", "old syntax", "migrate with frontend + digest", "stdlib", "stdlib_product", status) if path.startswith("tests/conformance/ast/"): return ("test", "yes", "Markdown AST only", "keep AST baseline", "tests", "conformance_ast", "reviewed") if path.startswith("tests/negative/"): @@ -125,14 +126,14 @@ def classify(path: str, changed_set: set[str]) -> tuple[str, str, str, str, str, return ("test", "yes", "harness", "review", "tests", "review", "reviewed") if path.startswith("crates/"): if path in FRONTEND: - return ("rust-source", "yes", "old mapping", "implement RFC-LANG-0002", "language", "cargo test", "pending-implementation") + return ("rust-source", "yes", "old mapping", "implemented RFC-LANG-0002", "language", "cargo test", "migrated") if "/tests/" in path or path.endswith("/tests.rs"): return ("rust-test", "yes", "embedded old syntax", "migrate embedded .mq.md strings", "language", "cargo test", "migrated" if is_changed else "reviewed") if is_changed: return ("rust-source", "yes", "embedded text/help", "migrate embedded .mq.md text only", "language", "cargo test", "migrated") return ("rust-source", "yes", "not syntax-bearing", "review", "language", "cargo test", "reviewed") if path.startswith("stdlib/"): - return ("stdlib", "yes", "old syntax", "migrate with frontend + digest", "stdlib", "stdlib_product", "pending-implementation") + return ("stdlib", "yes", "old syntax", "migrate with frontend + digest", "stdlib", "stdlib_product", "migrated" if is_changed else "reviewed") if path.startswith("tools/"): return ("tooling", "yes", "migration aid", "review", "docs", "review", "reviewed") if path.startswith("examples/"):