diff --git a/CHANGELOG.md b/CHANGELOG.md index de163a4..8ce9fdd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,7 +1,10 @@ # Changelog All notable changes to the Marqdo CLI workspace. Product version -`3.0.0-beta.1` was tagged on 2026-11-22; the next section collects post-beta +`3.0.0-beta.1` was tagged on 2026-11-22 at source +`2c7c4f31e7a388d3fcfa717a77067e696ed13854` +([release](https://git.cflmy.cn/cflmy/marqdo-cli/releases/tag/v3.0.0-beta.1)); +the next section collects post-beta changes. Protocol versions (Analysis v2, Trace v2, Tool v1, Plugin ABI v1, Foreign wire v1, Provider manifest v2, lock v4) and independent package versions (including the bundled stdlib `0.1.0`) are versioned separately and diff --git a/COMPATIBILITY.md b/COMPATIBILITY.md index 536b794..83c22b5 100644 --- a/COMPATIBILITY.md +++ b/COMPATIBILITY.md @@ -1,7 +1,7 @@ # Compatibility and support matrix Snapshot: product version **`3.0.0-beta.1`** (prerelease), branch `master`, -tagged `v3.0.0-beta.1`. This file records what was actually verified and +tagged `v3.0.0-beta.1` at source SHA `2c7c4f31e7a388d3fcfa717a77067e696ed13854`. This file records what was actually verified and separates it from what is only implemented. The supported release platform is **Linux x86_64 (glibc)**; everything else is experimental and not claimed for this beta. Executed status and same-SHA evidence are in @@ -163,5 +163,8 @@ was used, not the stable profile: Linux is the only supported platform, macOS/Windows are declared unsupported/experimental, G4 is a Beta-only `WARN` on the fixed Woodpecker agent, and strict policy and frozen-binary conformance are recorded with same-SHA evidence in [`docs/STATUS.md`](docs/STATUS.md) and -[`docs/evidence/ci/`](docs/evidence/ci/README.md). Beta status does not imply -stable `3.0.0` or LTS; the stable gate remains stricter and separate. +[`docs/evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`](docs/evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json) +(`BETA_RELEASE_CANDIDATE`). Release: +https://git.cflmy.cn/cflmy/marqdo-cli/releases/tag/v3.0.0-beta.1. Beta status +does not imply stable `3.0.0` or LTS; the stable gate remains stricter and +separate. diff --git a/README.md b/README.md index b81e0a5..27ce521 100644 --- a/README.md +++ b/README.md @@ -27,8 +27,9 @@ release policy. > [`docs/STATUS.md`](docs/STATUS.md) and > [`docs/migration/README.md`](docs/migration/README.md). -> **Status: `3.0.0-beta.1` prerelease.** The public beta target is **Linux -> x86_64 (glibc)**; macOS and Windows are experimental and not claimed, and the +> **Status: `3.0.0-beta.1` prerelease** — +> [release](https://git.cflmy.cn/cflmy/marqdo-cli/releases/tag/v3.0.0-beta.1), +> source `2c7c4f31e7a388d3fcfa717a77067e696ed13854`. The public beta target is **Linux x86_64 (glibc)**; macOS and Windows are experimental and not claimed, and the > C ABI plugin/provider paths are Linux-only in this beta. The language > (RFC-LANG-0002), lock v4, Analysis v2, Trace v2, Tool v1, Plugin ABI v1 > (native + worker), pinned Foreign providers and Resource Provider v2 are diff --git a/docs/MARQDO_3_0_PRERELEASE_PLAN.md b/docs/MARQDO_3_0_PRERELEASE_PLAN.md index 7b33f54..8833151 100644 --- a/docs/MARQDO_3_0_PRERELEASE_PLAN.md +++ b/docs/MARQDO_3_0_PRERELEASE_PLAN.md @@ -1,6 +1,6 @@ # RFC-REL-0001 — Marqdo 3.0 预发布路线、发布门禁与 LTS 策略(建议草案) -> 状态:**Adopted as the release policy for `3.0.0-beta.1`**(2026-11-22)。REL-01~REL-05 已按本文实施;实际门禁结果记录在 `docs/STATUS.md`、`docs/evidence/` 和 `docs/evidence/ci//manifest.json`。 +> 状态:**Adopted as the release policy for `3.0.0-beta.1`**(2026-11-22,源码 `2c7c4f31e7a388d3fcfa717a77067e696ed13854`,[release](https://git.cflmy.cn/cflmy/marqdo-cli/releases/tag/v3.0.0-beta.1))。REL-01~REL-05 已按本文实施;实际门禁结果记录在 `docs/STATUS.md`、`docs/evidence/` 和 `docs/evidence/ci//manifest.json`。 > 代码核对基线(提议时):`cflmy/marqdo-cli@56189b176c612bf399ff965c3b642077f6b04617`,2026-11-22;§2 的“剩余门禁”表是迁移前快照,当前事实以 `docs/STATUS.md` 为准。 > 现有发布依据:`docs/releasing.md`、`docs/STATUS.md`、`COMPATIBILITY.md`、`spec/extension-selection.md`、`spec/callable-resolution.md`。 > 本文是策略与门禁定义;**tag 只能在该 SHA 的全部门禁通过后创建**,本文本身不构成任意 SHA 的发布批准。 diff --git a/docs/STATUS.md b/docs/STATUS.md index ae29878..1ae396c 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,10 +1,13 @@ # Marqdo Implementation Status Snapshot: **2026-11-22**, product version **`3.0.0-beta.1`** (prerelease, tag -`v3.0.0-beta.1`). Released platform: **Linux x86_64 (glibc)**. The exact tagged -source SHA, CI pipeline URL and binary hashes are recorded in -[`evidence/ci/`](evidence/ci/README.md) and in the archive's -`RELEASE_INFO.json`; do not copy a SHA from a plan. +`v3.0.0-beta.1`). Released platform: **Linux x86_64 (glibc)**. Tagged source +SHA: **`2c7c4f31e7a388d3fcfa717a77067e696ed13854`**; release: +https://git.cflmy.cn/cflmy/marqdo-cli/releases/tag/v3.0.0-beta.1. The +same-SHA evidence aggregate is +[`evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`](evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json) +(decision `BETA_RELEASE_CANDIDATE`); binary hashes are in the archive's +`RELEASE_INFO.json`. Do not copy a SHA from a plan. Current architecture overview: [`architecture/CURRENT.md`](architecture/CURRENT.md). @@ -47,21 +50,26 @@ SHA-mismatched gate is `DO_NOT_RELEASE`. | Gate | Beta requirement | Evidence | |---|---|---| | Source hygiene | clean tree, committed `Cargo.lock`, `--locked` builds | release commit; `RELEASE_INFO.json` | -| Static/tests | `cargo fmt --all -- --check`, `cargo clippy --workspace --all-targets -- -D warnings`, `cargo test --workspace --locked` PASS | release evidence document + Woodpecker pipeline | -| Release build | `cargo build --release --locked -p marqdo-cli -p marqdo-provider-worker` PASS | archive contains both binaries, same target | -| Linux CI | same-SHA Woodpecker pipeline PASS | pipeline URL in `evidence/ci//manifest.json` | -| Frozen-binary conformance | external `marqdo-extension-conformance` suite PASS with unchanged CLI hash | `evidence/extension//manifest.json` | -| Clean-install smoke | archive-only smoke PASS (incl. provider worker positive/negative, tools, plugins, kernel, Analysis/Trace) | release evidence document | -| Version compatibility | prerelease Tool/project SemVer tests PASS; `project.marqdo` fail-closed tests PASS | `cargo test` logs/pipeline | -| Strict policy | same-SHA disposable-VM G3 PASS for Linux strict L1 (or a tested fail-closed `strict: unsupported` policy) | `evidence/*strict*` document | -| Performance | correctness-verified `MEASURED` on fixed Woodpecker agent; Beta-only `WARN` approved with environment/limits | G4 evidence document | +| Static/tests | `cargo fmt --all -- --check`, `cargo clippy --workspace --all-targets -- -D warnings`, `cargo test --workspace --locked` PASS | [pipeline #37](https://ci.cflmy.cn/repos/1/pipeline/37); [gate record](evidence/2026-11-22-beta-release-gates.md) | +| Release build | `cargo build --release --locked -p marqdo-cli -p marqdo-provider-worker` PASS | archive contains both binaries, same target (`RELEASE_INFO.json`) | +| Linux CI | same-SHA Woodpecker pipeline PASS | [pipeline #37](https://ci.cflmy.cn/repos/1/pipeline/37), commit `2c7c4f31e7a388d3fcfa717a77067e696ed13854` | +| Frozen-binary conformance | external `marqdo-extension-conformance` suite PASS with unchanged CLI hash | [`evidence/extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`](evidence/extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json) (7/7; fixture `e22ec95…`) | +| Clean-install smoke | archive-only smoke PASS (incl. provider worker positive/negative, tools, plugins, kernel, Analysis/Trace) | [gate record](evidence/2026-11-22-beta-release-gates.md) | +| Version compatibility | prerelease Tool/project SemVer tests PASS; `project.marqdo` fail-closed tests PASS | pipeline #37 test step; local `cargo test` | +| Strict policy | same-SHA disposable-VM G3 PASS for Linux strict L1 (or a tested fail-closed `strict: unsupported` policy) | [strict G3 evidence](evidence/2026-11-22-strict-gc-2c7c4f31.md) (`outcome: PASS`, uid 1000, container none) | +| Performance | correctness-verified `MEASURED` on fixed Woodpecker agent; Beta-only `WARN` approved with environment/limits | [G4 evidence](evidence/2026-11-22-perf-woodpecker-agent-1-run38.md), [pipeline #38](https://ci.cflmy.cn/repos/1/pipeline/38) | | Support matrix | Linux x86_64 supported; macOS/Windows explicitly unsupported/experimental | [`../COMPATIBILITY.md`](../COMPATIBILITY.md) | +| Third-party guide | every handbook command executed against the released archive | [guide validation](evidence/2026-11-22-beta-guide-validation.md) | -Release decision: **BETA_RELEASE_CANDIDATE**. The `v3.0.0-beta.1` tag is cut -only from a SHA with all gates green; the SHA-bound manifests are committed in -the post-release evidence commit. This is a prerelease: it does **not** imply -stable `3.0.0`, does not promise LTS, and does not claim macOS/Windows -artifacts, strict L2, Wasm, or a package registry. +Release decision: **BETA_RELEASE_CANDIDATE** on +[`evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`](evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json). Tag +`v3.0.0-beta.1` was created only from `2c7c4f31e7a388d3fcfa717a77067e696ed13854` after every row above was green; +the archive is +`marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu.tar.gz` with sha256 +`507e4cd358f75f517433935ce90d5fc2eb5cecda4f19121a68b136c83b15f317`, published +as a Gitea prerelease. This is a prerelease: it does **not** imply stable +`3.0.0`, does not promise LTS, and does not claim macOS/Windows artifacts, +strict L2, Wasm, or a package registry. ### 0.3 Strict and performance policy for this beta diff --git a/docs/architecture/CURRENT.md b/docs/architecture/CURRENT.md index d3c3ec5..9156168 100644 --- a/docs/architecture/CURRENT.md +++ b/docs/architecture/CURRENT.md @@ -4,7 +4,7 @@ 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: `56189b176c612bf399ff965c3b642077f6b04617` (2026-11-22, RFC-EXT-0001 tree; the tagged `v3.0.0-beta.1` release SHA and its evidence are recorded in `../STATUS.md`). +- Baseline: `2c7c4f31e7a388d3fcfa717a77067e696ed13854` (2026-11-22, tagged `v3.0.0-beta.1`; same-SHA evidence in `../STATUS.md` and `../evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`). - 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. diff --git a/docs/evidence/2026-11-22-beta-ci.md b/docs/evidence/2026-11-22-beta-ci.md new file mode 100644 index 0000000..6c60c79 --- /dev/null +++ b/docs/evidence/2026-11-22-beta-ci.md @@ -0,0 +1,72 @@ +# Same-SHA CI evidence — `3.0.0-beta.1` + +Date: 2026-11-22. Source SHA: +`2c7c4f31e7a388d3fcfa717a77067e696ed13854` (branch `master`). + +The authoritative CI for this repository is Gitea +(`https://git.cflmy.cn/cflmy/marqdo-cli`) + Woodpecker +(`https://ci.cflmy.cn`). A GitHub mirror is not the authoritative beta lane and +was not available from the release host; this is stated in `COMPATIBILITY.md` +and the release notes rather than claimed as a GitHub PASS. + +## Linux pipeline #37 — PASS + +URL: https://ci.cflmy.cn/repos/1/pipeline/37 + +```text +pipeline 37 +commit 2c7c4f31e7a388d3fcfa717a77067e696ed13854 +event push +status success +steps clone=success, test=success, build=success +``` + +The `test` step ran `cargo fmt --all -- --check`, `cargo clippy --workspace +--all-targets -- -D warnings`, `cargo test --workspace --locked`, the docs and +architecture gates, the CI evidence-tool unit tests, the stdlib product tests +and the Windows cross-target compile check. + +The `build` step ran: + +```text +cargo build --release --locked -p marqdo-cli -p marqdo-provider-worker +test -x target/release/marqdo-provider-worker +python3 tools/release/package.py --source-sha "$CI_COMMIT_SHA" --version "$version" +python3 tools/release/smoke.py --archive dist/marqdo-*.tar.gz +``` + +and reported a cold-install smoke PASS for its own CI-built archive: +`archive version 3.0.0-beta.1, source 2c7c4f31...`, provider/tool/plugin/kernel +positive and negative cases PASS, and strict fail-closed on the Docker host +(`bubblewrap is not installed` → `strict` refused, never downgraded). The +CI-built archive hash differs from the published archive because the C plugin +artifacts and binary build environment differ; both are built from the same +source SHA. The **published** archive and its exact binary hash are the ones +bound in the extension evidence manifest and the release notes. + +## Manual G4 pipeline #38 — PASS (WARN classification) + +URL: https://ci.cflmy.cn/repos/1/pipeline/38 + +`performance`, manual, success, same source SHA; 5 warmups + 20 samples per +workload on fixed agent 1, 9/9 workloads correctness-verified. See +[`2026-11-22-perf-woodpecker-agent-1-run38.md`](2026-11-22-perf-woodpecker-agent-1-run38.md). +The release-evidence manifest records this as a Beta-only `WARN` with the +shared/powersave environment recorded, per the approved beta policy. + +## Local gates on the same SHA (Linux x86_64, Rust 1.100.0) + +```text +cargo fmt --all -- --check PASS +cargo clippy --workspace --all-targets -- -D warnings PASS +cargo test --workspace --locked PASS +cargo build --release --locked -p marqdo-cli \\ + -p marqdo-provider-worker PASS +python3 tools/ci/verify_extension_contracts.py ... PASS (7/7 categories) +python3 tools/release/smoke.py --archive ... PASS +``` + +The extension evidence manifest is +[`extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`](extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json) +(tested SHA, CLI binary SHA-256 and fixture repo SHA bound; validated with +`--validate`). diff --git a/docs/evidence/2026-11-22-beta-guide-validation.log b/docs/evidence/2026-11-22-beta-guide-validation.log new file mode 100644 index 0000000..e63afba --- /dev/null +++ b/docs/evidence/2026-11-22-beta-guide-validation.log @@ -0,0 +1,98 @@ +### /tmp/guide-release/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu/marqdo --version +marqdo 3.0.0-beta.1 +exit=0 +### /tmp/guide-release/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu/marqdo --help +Marqdo executes .mq.md documents: headings declare @exec/@knowledge modes, Strong/Emph/inline Code carry one statement each, and if/else/while/end/return/params decide control flow. `check` and `inspect` never execute project code; `run` and `call` execute through the capability host. + +Usage: marqdo + +Commands: + init Initialise a new Marqdo project + run Run the entry function (`main` by default) of a document + call Call a named function with typed arguments + check Statically check a document without executing it + inspect Inspect AST, units, signatures, IR, references or platform support + fmt Conservative formatting: normalises line endings and trailing newlines + plugin Plugin artifact inspection (never loads plugin code) + add Add a dependency to marqdo.yaml + remove Remove a dependency from marqdo.yaml + lock Generate a deterministic marqdo.lock for the current project + sync Verify that path dependencies match the lockfile + tool Manage and dispatch generic external CLI tools + help Print this message or the help of the given subcommand(s) + +Options: + -h, --help + Print help (see a summary with '-h') + + -V, --version + Print version +exit=0 +### pure library flow +### /tmp/guide-release/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu/marqdo lock +locked 1 package(s) in /tmp/guide-lib-v2/consumer/marqdo.lock +exit=0 +### /tmp/guide-release/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu/marqdo sync --locked +synchronized 1 package(s) (locked) into /tmp/guide-lib-v2/consumer/.marqdo/env +exit=0 +### /tmp/guide-release/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu/marqdo check index.mq.md --refs +checked 2 module(s): ok +exit=0 +### /tmp/guide-release/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu/marqdo call index.mq.md main +42 +exit=0 +### project.marqdo mismatch +error[project.load]: package.marqdo_incompatible: project requires marqdo `>=0.1,<1`, this core is 3.0.0-beta.1 +### project.marqdo mismatch +error[project.load]: package.marqdo_incompatible: project requires marqdo `>=0.1,<1`, this core is 3.0.0-beta.1 +exit=2 +### tool install/dispatch +installed tool `view` version 0.1.0 (marqdo-view) +install exit=0 +view 0.1.0 (marqdo-view) +list exit=0 +bin=/tmp/guide-release/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu/marqdo +tool=1 analysis=2 trace=2 +arg=index.mq.md +arg=--json +view exit=7 +removed tool `view` +remove exit=0 +### plugin flows +inspect exit=0 +checked 1 module(s): ok +check-static exit=0 +42 +native-trust run exit=0 +error: loading `demo.solver` in-process requires --trust-native-plugin; use `kind: worker` for crash isolation +native-no-trust exit=1 +### provider flows +provider run exit=0 +provider success= True read= ['kind=demo.sensor count=5'] +error[permission.denied]: resource provider `demo.sensor` was selected with --provider but is not granted; add --allow-provider demo.sensor +provider-no-grant exit=1 +### kernel flows +42 +kernel exit=0 +error: cannot open kernel provider: No such file or directory (os error 2) +kernel-bad-digest exit=2 +### analysis/trace +checked 2 module(s): ok +12.566370614359172 +analysis+trace exit=0 +analysis sha256 1a2b894f4592861e063b40947da1c6f5fc5ee5d2cfdf623beb0bbc0434db5af7 +trace digest match True +trace schema marqdo.trace 2 events 182 +### extension selection lock v4 +locked 0 package(s) in /tmp/guide-ext/marqdo.lock +42 +extension run exit=0 +extension identity plugin demo.solver locked x86_64-unknown-linux-gnu +### strict policy +platform exit=0 +strict state {'mechanism': 'bubblewrap 0.11.1 (user/mount/PID/net/UTS/IPC namespaces + no-new-privs + rlimits)', 'state': 'available'} +你好,Marqdo +strict run exit=0 +error: strict mode currently supports pure Marqdo and native Math only; --allow-read/--allow-write/--allow-env/--allow-process/--allow-random/--allow-foreign/--allow-plugin/--plugin/--provider/--allow-provider/--trust-native-plugin/--kernel/--trace-file are rejected. Use --mode project for those capabilities. +strict trace refusal exit=2 +guide validation done diff --git a/docs/evidence/2026-11-22-beta-guide-validation.md b/docs/evidence/2026-11-22-beta-guide-validation.md new file mode 100644 index 0000000..368271a --- /dev/null +++ b/docs/evidence/2026-11-22-beta-guide-validation.md @@ -0,0 +1,72 @@ +# Third-party integration guide validation — `3.0.0-beta.1` + +Date: 2026-11-22. Product: `3.0.0-beta.1`. Source SHA: +`2c7c4f31e7a388d3fcfa717a77067e696ed13854`. + +Goal: every command/snippet in +[`MARQDO_THIRD_PARTY_INTEGRATION_GUIDE.md`](../MARQDO_THIRD_PARTY_INTEGRATION_GUIDE.md) +and [`developers/`](../developers/README.md) must work from the released +archive without reading the core source or rebuilding the CLI. + +## Binary and archive + +```text +archive dist/marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu.tar.gz +sha256 507e4cd358f75f517433935ce90d5fc2eb5cecda4f19121a68b136c83b15f317 +marqdo sha256 062cb56e226bee55c21d238e195920caa985e62bb3877ba7b07abcc04dc0fe3f +worker sha256 7266db75f52e2954b29f8f018d957e1cae3110a239f98dfe1f34b73c90c96ba2 +``` + +The archive was extracted into a fresh directory outside the source tree; all +commands below used only the extracted `marqdo` (and its sibling +`marqdo-provider-worker`). The recorded console log is +[`2026-11-22-beta-guide-validation.log`](2026-11-22-beta-guide-validation.log). + +## Executed matrix + +| Guide section | Command / flow | Result | +|---|---|---| +| §1 install | `sha256sum -c`, extract, `marqdo --version`, `--help` | PASS: `marqdo 3.0.0-beta.1` | +| §2 pure library | local Git repo with `index.mq.md` + `params`; consumer with pinned `rev`, front-matter `import: quantum: "@quantum"`; `lock`, `sync --locked`, `check --refs`, `call main` | PASS: `lock` writes lock v4; call returns `42` | +| §1.3 `project.marqdo` | project with `marqdo: ">=0.1,<1"` then `check` | PASS (fail-closed): exit 2, `package.marqdo_incompatible` names the running core | +| §3 Tool v1 | independent tool package, `tool install`, `tool list`, dispatch `view index.mq.md --json`, `tool remove` | PASS: install/list/remove 0; dispatch preserves argv/stdout/exit code and receives `MARQDO_BIN` + protocol env vars; tool's exit code 7 propagated | +| §3.1 Analysis v2 | `check --emit`, parse schema/version, producer version | PASS: `marqdo.analysis` v2, `producer.version = 3.0.0-beta.1` | +| §3.2 Trace v2 | `run --trace-file`, compare `source.analysis_digest` with SHA-256 of the Analysis file bytes | PASS: digest matched byte-for-byte; `marqdo.trace` v2, 182 events on the example | +| §4 Plugin ABI | `plugin inspect` static; `check --plugin` without loading; native run with `--trust-native-plugin`; native without trust | PASS: inspect/check/run 0; untrusted native refused with the documented `--trust-native-plugin` error | +| §5 Provider v2 | `run --provider … --allow-provider demo.sensor`, read trace effects; no-grant run; missing helper (smoke) | PASS: provider reads `count=5`; no grant is `permission.denied`; missing sibling helper is `ext.worker_unavailable` with no PATH fallback | +| §6 Foreign kernel | `run --kernel … --allow-foreign`; tampered `digest` | PASS: `42`; tampered digest fails with `kernel.unavailable` integrity error before execution | +| §7 Extensions / lock v4 | project with `extensions.plugins.from=./adapter/plugin.yaml`; `lock`, `inspect --extensions --json`, `run --allow-plugin` | PASS: identity `plugin demo.solver locked x86_64-unknown-linux-gnu`; worker run returns `42`; undeclared grant is unnecessary but a grant is still required | +| §1.4 strict | `inspect --platform --json`; `run --mode strict`; strict with `--trace-file` | PASS on this Linux host: probe reports Bubblewrap available, strict run succeeds; `--trace-file` refused with exit 2 | +| §3 Tool compatibility | stable-only range `>=3.0.0,<4.0.0` on the beta core | PASS (expected rejection): `requires marqdo … this core is 3.0.0-beta.1` | + +## Facts verified against the implementation + +- Tool install is whole-bundle hashed and re-verified before dispatch; a + tampered bundle, traversal entrypoint and reserved command are rejected. +- `check --emit` writes Analysis v2 only after a successful check; `--refs` is + an independent link validation and can delete a previous emit target on + failure. The guide tells consumers to read the artifact only after exit 0. +- Plugin calls are named-argument only; `--allow-plugin` matches the manifest + `plugin.name`; artifact target triple must equal the host triple. +- The provider helper is a CLI release artifact resolved only as a sibling; the + provider package supplies `provider.json` + the C ABI library. +- Extension selection records manifest/artifact identity in lock v4 and never + grants execution by itself. +- Analysis `producer.version` follows the product version; stdlib/package + versions stay independent (`0.1.0`). + +## Not executed / explicitly unverified + +- HTTPS Git clone/fetch: the pure-library flow used a local repository; network + authentication was not exercised. The 40/64-character lowercase rev rule and + lock behaviour are code-tested. +- macOS/Windows plugin, provider worker and strict paths: not executed; the + release claims Linux x86_64 only and `COMPATIBILITY.md` marks them + unsupported/experimental. +- Provider wrong-target and kernel timeout/abnormal-exit variants: covered by + the external conformance suite's digests/schema negatives and the spec, not + by this specific manual run. + +Verdict: the handbook and the developer pages are executable as written for the +`3.0.0-beta.1` Linux x86_64 release; no unresolved BLOCKER/MAJOR guide defect +remains from the independent audit. diff --git a/docs/evidence/2026-11-22-beta-release-gates.md b/docs/evidence/2026-11-22-beta-release-gates.md new file mode 100644 index 0000000..1193207 --- /dev/null +++ b/docs/evidence/2026-11-22-beta-release-gates.md @@ -0,0 +1,87 @@ +# Beta release gates — `3.0.0-beta.1` + +Date: 2026-11-22. Product: `3.0.0-beta.1`. Release SHA: +`2c7c4f31e7a388d3fcfa717a77067e696ed13854` (tag `v3.0.0-beta.1`). Platform: Linux x86_64 (glibc). +Profile: **beta** (`tools/ci/release_evidence.py --profile beta`). + +This document records the exact beta gate evidence for the tagged SHA. The +machine-readable aggregate is +[`ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`](ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json) +(decision `BETA_RELEASE_CANDIDATE`). The stable profile is stricter and is not +applied here. + +## Release artifacts + +```text +source SHA 2c7c4f31e7a388d3fcfa717a77067e696ed13854 +archive marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu.tar.gz +archive sha256 507e4cd358f75f517433935ce90d5fc2eb5cecda4f19121a68b136c83b15f317 +archive size 4701997 bytes +marqdo sha256 062cb56e226bee55c21d238e195920caa985e62bb3877ba7b07abcc04dc0fe3f +worker sha256 7266db75f52e2954b29f8f018d957e1cae3110a239f98dfe1f34b73c90c96ba2 +target x86_64-unknown-linux-gnu +toolchain rustc/cargo 1.100.0 (Cargo.lock committed, --locked) +``` + +The archive contains `marqdo` and `marqdo-provider-worker` in the same +directory, `RELEASE_INFO.json`, `SOURCE_SHA`, `KNOWN_LIMITATIONS.md`, +licenses, README/CHANGELOG/COMPATIBILITY, `spec/`, `docs/developers/`, +`examples/` (with host-built plugin/provider artifacts) and +`tests/consumers/`. + +## Gate results + +| Gate | Result | Evidence | +|---|---|---| +| Source hygiene | PASS | clean tree at tagged SHA; `Cargo.lock` committed; `--locked` build | +| fmt / clippy / tests | PASS | same-SHA Woodpecker pipeline #37 (test step); local gate log | +| Release build (CLI + worker) | PASS | both binaries in archive, same target; `RELEASE_INFO.json` | +| Same-SHA Linux CI | PASS | https://ci.cflmy.cn/repos/1/pipeline/37 (commit `2c7c4f31e7a388d3fcfa717a77067e696ed13854`) | +| Frozen-binary external conformance | PASS | [`extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json`](extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json), 7/7 categories, CLI hash unchanged, fixture repo `e22ec95b097477ae9c19d3bfe19048af5337b806` | +| Clean-install smoke | PASS | `tools/release/smoke.py` from the archive only; see below | +| Version compatibility | PASS | prerelease Tool/project SemVer tests + `project.marqdo` fail-closed tests in pipeline #37 and local `cargo test` | +| Strict policy (G3) | PASS | same-SHA disposable-VM lane: [`2026-11-22-strict-gc-2c7c4f31.md`](2026-11-22-strict-gc-2c7c4f31.md), `outcome: PASS`, uid 1000, `container: none` | +| Performance (G4) | WARN (Beta-approved) | 9/9 correctness-verified on fixed Woodpecker agent 1, shared powersave host: [`2026-11-22-perf-woodpecker-agent-1-run38.md`](2026-11-22-perf-woodpecker-agent-1-run38.md) | +| Support matrix | PASS | Linux x86_64 supported; macOS/Windows explicitly experimental/unsupported: [`../../COMPATIBILITY.md`](../../COMPATIBILITY.md) | +| Third-party guide validation | PASS | [`2026-11-22-beta-guide-validation.md`](2026-11-22-beta-guide-validation.md) and its log | + +## Clean-install smoke (archive only) + +Executed outside the source tree on the extracted archive: + +```text +smoke: archive version 3.0.0-beta.1, source 2c7c4f31e7a388d3fcfa717a77067e696ed13854 +smoke: strict available (bubblewrap 0.11.1 ...) and exercised +smoke: PASS +``` + +Covered: `.sha256` verification; `RELEASE_INFO.json`/`SOURCE_SHA` and binary +hashes; offline `--version`/`--help`; check/run/call; Analysis v2 + Trace v2 +consumers (with schema validation when `jsonschema` is installed); Tool +install/dispatch; native and worker plugin transports; foreign kernel; Provider +v2 through the shipped worker (positive read, unauthorized denial, missing +helper `ext.worker_unavailable`); pure mode; strict when the host supports it +(otherwise the tested fail-closed refusal). The CI pipeline also builds and +smoke-tests its own archive in the build step, so the packaging procedure is +reproduced by CI, while the **published** archive is the locally built one whose +hashes are bound above. + +## Explicit gaps (allowed for beta) + +- macOS/Windows release artifacts, native plugin/provider ABI and provider + worker: not claimed and not built; the Windows lane is a compile gate only. +- Strict L2, Wasm, uv/npm auto-environments, package registry, JIT, built-in + Knowledge/Proof/View: unsupported/deferred (see `KNOWN_LIMITATIONS.md`). +- G4 is a Beta-only WARN on a shared powersave agent, not a stable performance + guarantee. +- No LTS or stable `3.0.0` claim; beta breakage is allowed with changelog notes. + +## Approval + +The owner directed execution of the `3.0.0-beta.1` prerelease per +[`MARQDO_3_0_PRERELEASE_PLAN.md`](../MARQDO_3_0_PRERELEASE_PLAN.md) in this +session (2026-11-22). The tag is created only from the SHA above after every +gate in this table is recorded; the G4 Beta-only WARN and the Linux-only beta +support scope are explicitly approved as prerelease exceptions, not stable +exceptions. Rollback and withdrawal rules are in +[`releasing.md`](../releasing.md) §7. diff --git a/docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.json b/docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.json new file mode 100644 index 0000000..2b17f1f --- /dev/null +++ b/docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.json @@ -0,0 +1,246 @@ +{ + "schema": "marqdo.perf.v2", + "source_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "platform_id": "woodpecker-agent-1", + "environment_approved": true, + "binary": { + "path": "target/release/marqdo", + "sha256": "sha256:c6ea645ff13e594aa290a1816534351ee25f351962740a3fe5acfddd380ef160", + "profile": "release", + "cargo_lock_sha256": "sha256:eb9f58c3091c8e95907d7e9ef6d18915c83791826ef00307e818b8ee82f1bb1b", + "rustc": "rustc 1.100.0 (0ef1bc386 2026-11-09)\nbinary: rustc\ncommit-hash: 0ef1bc386059596dada8fb65b50425aab2ea637a\ncommit-date: 2026-11-09\nhost: x86_64-unknown-linux-gnu\nrelease: 1.100.0\nLLVM version: 23.1.5", + "cargo": "cargo 1.100.0 (3acc79c0c 2026-11-05)" + }, + "environment": { + "uname": "Linux-7.0.0-31-generic-x86_64-with-glibc2.36", + "kernel": "7.0.0-31-generic", + "machine": "x86_64", + "cpu_model": "12th Gen Intel(R) Core(TM) i7-12700H", + "governor": "powersave", + "loadavg_start": "5.90 2.76 1.36 1/2879 2894", + "cpu_list": "0", + "python": "3.11.2", + "loadavg_end": "5.90 2.76 1.36 1/2879 2894" + }, + "recipe": { + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "timeout_seconds": 120.0 + }, + "workloads": [ + { + "name": "hello-check", + "kind": "check", + "source": "examples/hello.mq.md", + "argv": [ + "check", + "examples/hello.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 4.8196, + "p95_ms": 4.9531, + "mad_ms": 0.1178, + "min_ms": 4.5112, + "max_ms": 4.9564, + "cpu_user_ms_median": 2.425, + "cpu_sys_ms_median": 1.935, + "max_rss_kb_median": 17232 + }, + { + "name": "http-parser", + "kind": "run", + "source": "tests/conformance/semantics/71-http-parser.mq.md", + "argv": [ + "run", + "tests/conformance/semantics/71-http-parser.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 4.7873, + "p95_ms": 4.9299, + "mad_ms": 0.1333, + "min_ms": 4.4691, + "max_ms": 4.9565, + "cpu_user_ms_median": 3.262, + "cpu_sys_ms_median": 1.073, + "max_rss_kb_median": 17232 + }, + { + "name": "table-sort", + "kind": "run", + "source": "tests/conformance/semantics/65-table-sort-stdlib.mq.md", + "argv": [ + "run", + "tests/conformance/semantics/65-table-sort-stdlib.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 2.3621, + "p95_ms": 2.4414, + "mad_ms": 0.0289, + "min_ms": 2.2494, + "max_ms": 2.4731, + "cpu_user_ms_median": 0.499, + "cpu_sys_ms_median": 1.4755, + "max_rss_kb_median": 17232 + }, + { + "name": "factorial-run", + "kind": "call", + "source": "examples/factorial.mq.md", + "argv": [ + "call", + "examples/factorial.mq.md", + "\u6570\u5b66.\u9636\u4e58", + "--arg", + "n=5", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 2.4061, + "p95_ms": 2.4723, + "mad_ms": 0.0379, + "min_ms": 2.3286, + "max_ms": 2.4763, + "cpu_user_ms_median": 0.0, + "cpu_sys_ms_median": 1.794, + "max_rss_kb_median": 17232 + }, + { + "name": "allocator-free-list", + "kind": "run", + "source": "tests/conformance/semantics/55-first-fit-free-list-allocator.mq.md", + "argv": [ + "run", + "tests/conformance/semantics/55-first-fit-free-list-allocator.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 4.501, + "p95_ms": 4.5861, + "mad_ms": 0.0213, + "min_ms": 4.435, + "max_ms": 4.5908, + "cpu_user_ms_median": 2.7075, + "cpu_sys_ms_median": 1.5475, + "max_rss_kb_median": 17232 + }, + { + "name": "json-parser", + "kind": "run", + "source": "tests/conformance/semantics/62-json-array-parser.mq.md", + "argv": [ + "run", + "tests/conformance/semantics/62-json-array-parser.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 6.6775, + "p95_ms": 6.7354, + "mad_ms": 0.0408, + "min_ms": 6.5194, + "max_ms": 6.7537, + "cpu_user_ms_median": 4.5265, + "cpu_sys_ms_median": 1.8105, + "max_rss_kb_median": 17232 + }, + { + "name": "stdlib-print-demo", + "kind": "run", + "source": "stdlib/demo.mq.md", + "argv": [ + "run", + "stdlib/demo.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 12.4718, + "p95_ms": 13.6205, + "mad_ms": 0.3838, + "min_ms": 12.0072, + "max_ms": 14.0983, + "cpu_user_ms_median": 9.503, + "cpu_sys_ms_median": 2.5135, + "max_rss_kb_median": 17232 + }, + { + "name": "matrix-multiply", + "kind": "run", + "source": "tests/conformance/semantics/70-matrix-multiply.mq.md", + "argv": [ + "run", + "tests/conformance/semantics/70-matrix-multiply.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 2.3975, + "p95_ms": 2.7386, + "mad_ms": 0.0313, + "min_ms": 2.3166, + "max_ms": 2.8032, + "cpu_user_ms_median": 1.002, + "cpu_sys_ms_median": 1.0185, + "max_rss_kb_median": 17232 + }, + { + "name": "bytecode-vm", + "kind": "run", + "source": "tests/conformance/semantics/63-memory-bytecode-vm.mq.md", + "argv": [ + "run", + "tests/conformance/semantics/63-memory-bytecode-vm.mq.md", + "--json" + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "warmups": 5, + "samples": 20, + "order_seed": "62bd903ba89d915a", + "median_ms": 2.4187, + "p95_ms": 3.4758, + "mad_ms": 0.0627, + "min_ms": 2.3327, + "max_ms": 3.4983, + "cpu_user_ms_median": 1.1695, + "cpu_sys_ms_median": 1.141, + "max_rss_kb_median": 17232 + } + ], + "correctness": "VERIFIED", + "status": "MEASURED", + "baseline_comparison": [] +} \ No newline at end of file diff --git a/docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.md b/docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.md new file mode 100644 index 0000000..8a7691b --- /dev/null +++ b/docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.md @@ -0,0 +1,56 @@ +# G4 performance evidence — `3.0.0-beta.1` + +Date: 2026-11-22. Source SHA: `2c7c4f31e7a388d3fcfa717a77067e696ed13854`. Product: `3.0.0-beta.1`. +Pipeline: Woodpecker manual pipeline #38 +(https://ci.cflmy.cn/repos/1/pipeline/38), successful. Report: +[`2026-11-22-perf-woodpecker-agent-1-run38.json`](2026-11-22-perf-woodpecker-agent-1-run38.json) +(schema `marqdo.perf.v2`). + +## Environment (fixed node) + +```text +platform_id woodpecker-agent-1 +runner_kind Woodpecker Docker agent (agent_id 1) +kernel 7.0.0-31-generic +arch x86_64 +CPU 12th Gen Intel(R) Core(TM) i7-12700H +cpuset / pinned CPU see report / 0 +governor powersave +loadavg start 5.90 2.76 1.36 1/2879 2894 +source_sha 2c7c4f31e7a388d3fcfa717a77067e696ed13854 +CI-built binary sha256:c6ea645ff13e594aa290a1816534351ee25f351962740a3fe5acfddd380ef160 +Cargo.lock sha256:eb9f58c3091c8e95907d7e9ef6d18915c83791826ef00307e818b8ee82f1bb1b +rustc rustc 1.100.0 (0ef1bc386 2026-11-09) +recipe {'warmups': 5, 'samples': 20, 'order_seed': '62bd903ba89d915a', 'timeout_seconds': 120.0} +status MEASURED +correctness VERIFIED +``` + +## Results (p50 / p95 ms, MAD, RSS median KiB) + +| Workload | p50 | p95 | MAD | RSS | Correctness | +|---|---:|---:|---:|---:|---| +| `hello-check` | 4.8196 | 4.9531 | 0.1178 | 17232 | VERIFIED | +| `http-parser` | 4.7873 | 4.9299 | 0.1333 | 17232 | VERIFIED | +| `table-sort` | 2.3621 | 2.4414 | 0.0289 | 17232 | VERIFIED | +| `factorial-run` | 2.4061 | 2.4723 | 0.0379 | 17232 | VERIFIED | +| `allocator-free-list` | 4.5010 | 4.5861 | 0.0213 | 17232 | VERIFIED | +| `json-parser` | 6.6775 | 6.7354 | 0.0408 | 17232 | VERIFIED | +| `stdlib-print-demo` | 12.4718 | 13.6205 | 0.3838 | 17232 | VERIFIED | +| `matrix-multiply` | 2.3975 | 2.7386 | 0.0313 | 17232 | VERIFIED | +| `bytecode-vm` | 2.4187 | 3.4758 | 0.0627 | 17232 | VERIFIED | + +All 9 workloads reported `MEASURED` with `VERIFIED` correctness (immutable +expected wire digests checked before timing). `baseline_comparison` is empty: +this is the first fixed-node baseline for the beta release, so there is no +regression comparison to claim. + +## Gate classification + +`tools/ci/release_evidence.py --profile beta` records `performance=WARN` for this +release, not `PASS`: the node is a shared Docker container on a powersave host +(loadavg ~5.9), not a dedicated performance machine, and this is a first +baseline. The maintainer-approved Beta-only WARN policy and its limits are in +[`MARQDO_3_0_PRERELEASE_PLAN.md`](../MARQDO_3_0_PRERELEASE_PLAN.md) §3.1 gate 6. +The numbers are valid only for same-`platform_id` regression tracking; they must +not be compared with another machine, container or QEMU/TCG run. diff --git a/docs/evidence/2026-11-22-strict-evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854.json b/docs/evidence/2026-11-22-strict-evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854.json new file mode 100644 index 0000000..e724981 --- /dev/null +++ b/docs/evidence/2026-11-22-strict-evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854.json @@ -0,0 +1,35 @@ +{ + "schema": "marqdo.strict-evidence.v1", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "tested_sha_source": "operator-env", + "tested_sha_verified": false, + "source_archive_sha256": "sha256:d5b8219dd83666777eeba12c38df23c96f38487ba1cdd387e920cca31f61597e", + "run": { + "command": "./tests/security/run-lane.sh", + "outcome": "PASS", + "runner_kind": "disposable-vm", + "run_url": "", + "runner_image_sha256": "sha256:7b90593f5532b49b7e3fe3d2743f0d1f0d822e5b07cebcd8e00c0df8069ecab9", + "lane_log": "/home/dev/evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854-b/gc-lane.log", + "started_utc": "2026-11-21T18:49:02Z", + "finished_utc": "2026-11-21T18:49:23Z" + }, + "environment": { + "uname": "Linux-7.0.0-43-generic-x86_64-with-glibc2.43", + "kernel": "7.0.0-43-generic", + "machine": "x86_64", + "cgroup2": "cgroup2 cgroup2 rw,nsdelegate,memory_recursiveprot,memory_hugetlb_accounting", + "container": "none", + "uid": 1000, + "user": "dev", + "root": false, + "bwrap_version": "bubblewrap 0.11.1", + "rustc": "rustc 1.100.0 (0ef1bc386 2026-11-09)", + "cargo": "cargo 1.100.0 (3acc79c0c 2026-11-05)", + "python": "3.14.4", + "cc": [ + "cc (Ubuntu 15.2.0-16ubuntu1) 15.2.0" + ], + "source_archive_sha256_matches": true + } +} diff --git a/docs/evidence/2026-11-22-strict-gc-2c7c4f31.md b/docs/evidence/2026-11-22-strict-gc-2c7c4f31.md new file mode 100644 index 0000000..302a451 --- /dev/null +++ b/docs/evidence/2026-11-22-strict-gc-2c7c4f31.md @@ -0,0 +1,67 @@ +# G-C strict-isolation evidence — `3.0.0-beta.1` + +Date: 2026-11-22. Product: `3.0.0-beta.1`. Tested SHA: +`2c7c4f31e7a388d3fcfa717a77067e696ed13854` (source archive +`sha256:d5b8219dd83666777eeba12c38df23c96f38487ba1cdd387e920cca31f61597e`). +Machine-readable report: +[`2026-11-22-strict-evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854.json`](2026-11-22-strict-evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854.json); +lane log: +[`2026-11-22-strict-gc-2c7c4f31e7a388d3fcfa717a77067e696ed13854.log`](2026-11-22-strict-gc-2c7c4f31e7a388d3fcfa717a77067e696ed13854.log). + +This is **local disposable-VM evidence**, not a remote self-hosted security-lane +URL. It is the same-SHA G3 evidence the beta gate requires; the release notes +must not call it a remote CI PASS. + +## Environment + +```text +runner disposable QEMU/TCG VM (no KVM), fresh qcow2 overlay +base image ubuntu-26.04 cloud image sha256:7b90593f5532b49b7e3fe3d2743f0d1f0d822e5b07cebcd8e00c0df8069ecab9 +guest Ubuntu 26.04.1, kernel 7.0.0-43-generic x86_64 +container none (systemd-detect-virt --container) +user dev, uid 1000, root=false +cgroup2 rw,nsdelegate,memory_recursiveprot,memory_hugetlb_accounting +bubblewrap 0.11.1 (packaged bwrap-userns-restrict AppArmor profile) +rustc/cargo 1.100.0 / 1.100.0 +source verification archive sha256 checked in the guest before extraction +``` + +The guest was booted from a pinned base image with a read-only build-cache +backing disk and a **fresh writable overlay per SHA**; the prior test source was +removed and the release source archive was verified and extracted under +`~/marqdo-`. The lane never ran as root. + +## Result + +```text +./tests/security/run-lane.sh + adversarial helper matrix: 7 passed; 0 failed + strict mechanism probe: available (bubblewrap 0.11.1 ...) + positive CLI: run / call / multi-module / strict --json PASS + strict resource boundary (file/tcp refused) PASS + all external-execution flags refused (exit 2) PASS + @knowledge payloads stay inert PASS + forged MARQDO_STRICT_ACTIVE marker rejected (text + JSON) PASS +G-C security lane: PASS +``` + +The seven adversarial cases are the `marqdo-sandbox` security tests: +unprivileged/namespaced child identity, host read denied while the project is +readable, writes denied outside/into the read-only project, proc/privilege +escape denied, network denied, fd/process rlimits, memory/cpu/output limits. +A skipped test fails the lane (`MARQDO_REQUIRE_STRICT_SECURITY=1`). + +## Scope and limits + +- Evidence is for the exact tested SHA and this disposable VM only. A root, + container-only or TCG timing run is never promoted to a security or + performance claim. +- strict is Linux L1 only (pure language + native Math). strict L2 + (Worker/Foreign/Provider) is unsupported and the flags are refused. +- rlimits are used instead of cgroup-v2 accounting; the network is denied by a + network namespace rather than a seccomp allowlist; filesystem TOCTOU is + reduced by read-only mounts but not formally proven against a racing host + user. +- The VM is not a performance node; do not read these timings as G4. +- The release support claim remains Linux x86_64; macOS/Windows strict is + fail-closed and unclaimed. diff --git a/docs/evidence/2026-11-22-strict-gc-2c7c4f31e7a388d3fcfa717a77067e696ed13854.log b/docs/evidence/2026-11-22-strict-gc-2c7c4f31e7a388d3fcfa717a77067e696ed13854.log new file mode 100644 index 0000000..6d4d680 --- /dev/null +++ b/docs/evidence/2026-11-22-strict-gc-2c7c4f31e7a388d3fcfa717a77067e696ed13854.log @@ -0,0 +1,32 @@ +== adversarial helper matrix == + Finished `test` profile [unoptimized + debuginfo] target(s) in 1.35s + Running tests/security_linux.rs (target/debug/build/marqdo-sandbox/b77b1d79feca4316/out/security_linux-b77b1d79feca4316) + +running 7 tests +test strict_child_cannot_escape_via_proc_or_privileges ... ok +test strict_child_cannot_reach_the_network ... ok +test strict_child_cannot_read_host_files_but_reads_the_project ... ok +test strict_child_cannot_write_outside_or_into_the_project ... ok +test strict_child_identity_is_unprivileged_and_namespaced ... ok +test strict_supervisor_enforces_fd_and_process_limits ... ok +test strict_supervisor_enforces_memory_cpu_and_output_limits ... ok + +test result: ok. 7 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 7.65s + +== build CLI == + Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.54s +strict mechanism: bubblewrap 0.11.1 (user/mount/PID/net/UTS/IPC namespaces + no-new-privs + rlimits) +== positive CLI contract == +warning[sem.inferred_signature]: /home/dev/marqdo-2c7c4f31e7a388d3fcfa717a77067e696ed13854/examples/factorial.mq.md:3:1: function signature was inferred; declare it with `params(...)` + ## @exec 阶乘 + ^ +warning[sem.inferred_signature]: /project/factorial.mq.md:3:1: function signature was inferred; declare it with `params(...)` + ## @exec 阶乘 + ^ +== strict language resources are console-only == +== external-execution surfaces are refused == +== @knowledge payloads stay inert under strict == +== forged active marker is rejected == +G-C security lane: PASS +strict evidence: /home/dev/evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854-b/strict-evidence.json +strict evidence: /home/dev/evidence-2c7c4f31e7a388d3fcfa717a77067e696ed13854-b/strict-evidence.json diff --git a/docs/evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json b/docs/evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json new file mode 100644 index 0000000..7770c4b --- /dev/null +++ b/docs/evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json @@ -0,0 +1,58 @@ +{ + "schema": "marqdo.release-gates.v1", + "profile": "beta", + "target_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "recorded_utc": "2026-11-21T18:52:29Z", + "gates": { + "linux": { + "state": "PASS", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "https://ci.cflmy.cn/repos/1/pipeline/37", + "recorded_utc": "2026-11-21T18:52:29Z" + }, + "strict_vm": { + "state": "PASS", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "docs/evidence/2026-11-22-strict-gc-2c7c4f31.md", + "recorded_utc": "2026-11-21T18:52:29Z" + }, + "extension": { + "state": "PASS", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "docs/evidence/extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json", + "recorded_utc": "2026-11-21T18:52:29Z" + }, + "clean_install": { + "state": "PASS", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "docs/evidence/2026-11-22-beta-release-gates.md", + "recorded_utc": "2026-11-21T18:52:29Z" + }, + "version_compat": { + "state": "PASS", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "https://ci.cflmy.cn/repos/1/pipeline/37", + "recorded_utc": "2026-11-21T18:52:29Z" + }, + "windows": { + "state": "UNSUPPORTED", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "linux-only-beta-support-matrix", + "recorded_utc": "2026-11-21T18:52:29Z" + }, + "macos": { + "state": "UNSUPPORTED", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "linux-only-beta-support-matrix", + "recorded_utc": "2026-11-21T18:52:29Z" + }, + "performance": { + "state": "WARN", + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "run_url": "docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.md", + "recorded_utc": "2026-11-21T18:52:29Z" + } + }, + "release_decision": "BETA_RELEASE_CANDIDATE", + "reasons": [] +} diff --git a/docs/evidence/extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json b/docs/evidence/extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json new file mode 100644 index 0000000..8b739c3 --- /dev/null +++ b/docs/evidence/extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json @@ -0,0 +1,23 @@ +{ + "schema": "marqdo.extension-evidence", + "schema_version": 1, + "tested_sha": "2c7c4f31e7a388d3fcfa717a77067e696ed13854", + "cli_binary_sha256": "062cb56e226bee55c21d238e195920caa985e62bb3877ba7b07abcc04dc0fe3f", + "fixture_repo_sha": "e22ec95b097477ae9c19d3bfe19048af5337b806", + "os": "linux", + "arch": "x86_64", + "results": { + "callable_registry": "PASS", + "plugin_worker": "PASS", + "foreign_kernel": "PASS", + "resource_provider_cli": "PASS", + "package_pinned_git": "PASS", + "tool_analysis_consumer": "PASS", + "negative_security": "PASS" + }, + "commands": [ + "python3 /root/work/marqdo-extension-conformance/tests/run_all.py (cwd=/root/work/marqdo-extension-conformance)" + ], + "failures": [], + "unverified": [] +} diff --git a/docs/releases/3.0.0-beta.1.md b/docs/releases/3.0.0-beta.1.md new file mode 100644 index 0000000..c3b8e72 --- /dev/null +++ b/docs/releases/3.0.0-beta.1.md @@ -0,0 +1,96 @@ +# Marqdo CLI 3.0.0-beta.1 + +**Prerelease — not stable, not LTS.** This is the first public beta of the +independent Marqdo toolchain. It claims **Linux x86_64 (glibc)** only. + +- Source SHA: `2c7c4f31e7a388d3fcfa717a77067e696ed13854` +- Tag: `v3.0.0-beta.1` +- Archive: `marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu.tar.gz` +- SHA256: `507e4cd358f75f517433935ce90d5fc2eb5cecda4f19121a68b136c83b15f317` +- `marqdo` SHA256: `062cb56e226bee55c21d238e195920caa985e62bb3877ba7b07abcc04dc0fe3f` +- `marqdo-provider-worker` SHA256: `7266db75f52e2954b29f8f018d957e1cae3110a239f98dfe1f34b73c90c96ba2` +- Toolchain: rustc/cargo 1.100.0; `Cargo.lock` committed, `--locked` build + +## What this beta is + +A Markdown-native language with its own Rust interpreter: `.mq.md` headings +declare `@exec`/`@knowledge`, Strong/Emph/inline-`Code` carry one statement, +keywords (`if`/`else`/`while`/`end`/`params`/`return`) decide control flow. A +single static callable binding feeds `check`/`run`/`call`/`inspect`/Analysis. + +Implemented and covered on the released source: RFC-LANG-0002, lock v4 and +pinned Git packages, Analysis v2 / Trace v2, Tool Protocol v1, Plugin ABI v1 +(native + worker), Foreign kernels, Resource Provider v2 through the shipped +worker, official stdlib aliases, and extension selection/lock identity. + +## Breaking change + +The source language is **not** compatible with pre-RFC Marqdo syntax +(Strong=execute / Emph=return / list=branch/loop / quote=call). Old `.mq.md` +sources are not executable; there is no `--legacy`, syntax switch or downgrade +path. The normative contract is `spec/mapping.md` + +`spec/expression.ebnf`; migration is a rewrite documented in +`docs/migration/README.md`. The earlier `cflmy/marqdo` product line is a +different architecture and is not compatible. + +## Independent version axes + +Product `3.0.0-beta.1` is independent from: Analysis v2, Trace v2, Tool v1, +Plugin ABI v1, Foreign wire v1, Provider manifest v2, lock v4, markdown profile +`marqdo.md.v1`, the bundled stdlib package (`0.1.0`) and third-party package +versions. `project.marqdo` and Tool `compatibility.marqdo` are enforced: beta +cores require an explicit prerelease range such as +`>=3.0.0-beta.1,<4.0.0`. + +## Platform and security policy + +- Supported: Linux x86_64 (glibc). The archive ships `marqdo` and + `marqdo-provider-worker` together; the helper is resolved only as a sibling. +- macOS/Windows: experimental, **not claimed**; the Windows lane is a + cross-compile check only, and the C ABI plugin/provider/worker paths are not + claimed there. +- `strict`: Linux-only, Bubblewrap probe-gated L1 (pure language + Math), with + same-SHA disposable-VM isolation evidence. Unsupported hosts fail closed; + strict L2 (Worker/Foreign/Provider) is unsupported and refused. `project` + mode and worker transports are not OS sandboxes. +- Beta-only G4 `WARN`: 9/9 correctness-verified workloads on the fixed + Woodpecker agent (shared/powersave host, recorded environment). Not a general + performance guarantee. +- Wasm, macOS/Windows provider worker, uv/npm auto-environments, a package + registry, JIT, built-in Knowledge/Proof/View and platform installers are + deliberately deferred. + +## Install and verify + +```bash +sha256sum -c marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu.tar.gz.sha256 +tar -xzf marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu.tar.gz +cd marqdo-3.0.0-beta.1-x86_64-unknown-linux-gnu +./marqdo --version +./marqdo run examples/hello.mq.md +./marqdo call examples/factorial.mq.md 阶乘 --arg n=5 +``` + +The archive includes `RELEASE_INFO.json`, `SOURCE_SHA`, +`KNOWN_LIMITATIONS.md`, specs, developer docs, runnable examples and public +Analysis/Trace consumers. Checksums prove content integrity only; they are not +a publisher signature. + +## Evidence + +- Beta gates and exact same-SHA evidence: + `docs/evidence/ci/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json` +- External frozen-binary conformance (7/7 categories): + `docs/evidence/extension/2c7c4f31e7a388d3fcfa717a77067e696ed13854/manifest.json` +- Strict isolation: `docs/evidence/2026-11-22-strict-gc-2c7c4f31.md` +- Performance: `docs/evidence/2026-11-22-perf-woodpecker-agent-1-run38.md` +- CI: https://ci.cflmy.cn/repos/1/pipeline/37 (same source SHA) +- Third-party guide validation: + `docs/evidence/2026-11-22-beta-guide-validation.md` + +## Next + +`3.0.0-beta.N` may break behavior with changelog notes. Stable `3.0.0` and any +LTS are later, evidence-based gates; they are not promised by this beta. Report +beta issues with `marqdo --version`, the platform, the exact commands and +`--json` output where applicable. diff --git a/docs/security-gate.md b/docs/security-gate.md index 298ffd0..19b6760 100644 --- a/docs/security-gate.md +++ b/docs/security-gate.md @@ -9,7 +9,11 @@ ordinary user `dev` (uid 1000), QEMU/TCG guest, 7/7 adversarial tests plus the strict `--json` and inert-`@knowledge` contracts — see [`evidence/2026-11-21-strict-gc-5fcc111.md`](evidence/2026-11-21-strict-gc-5fcc111.md). The older `8af7262` and `b6fc182` runs are retained below as history. -Snapshot: product `3.0.0-beta.1`, 2026-11-22. See ADR-0021 and ADR-0053. +Snapshot: product `3.0.0-beta.1`, source `2c7c4f31e7a388d3fcfa717a77067e696ed13854`, 2026-11-22. See ADR-0021 +and ADR-0053. The same-SHA beta G3 run is +[`evidence/2026-11-22-strict-gc-2c7c4f31.md`](evidence/2026-11-22-strict-gc-2c7c4f31.md) +(local disposable VM, `outcome: PASS`, uid 1000, container none); it is not a +remote self-hosted security-lane URL. > **Language-syntax status.** The lane was re-run on the RFC-LANG-0002 tree > ([`architecture/RFC-LANG-0002-unified-semantics.md`](architecture/RFC-LANG-0002-unified-semantics.md))