Compare commits
1
Commits
v3.0.0-beta.1
...
master
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9e76635028 |
No files matched your search
+4
-1
@@ -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
|
||||
|
||||
+6
-3
@@ -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.
|
||||
@@ -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
|
||||
|
||||
@@ -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/<release-sha>/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/<release-sha>/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 的发布批准。
|
||||
|
||||
+25
-17
@@ -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/<sha>/manifest.json` |
|
||||
| Frozen-binary conformance | external `marqdo-extension-conformance` suite PASS with unchanged CLI hash | `evidence/extension/<sha>/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
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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`).
|
||||
@@ -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 <COMMAND>
|
||||
|
||||
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
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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": []
|
||||
}
|
||||
@@ -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.
|
||||
+35
@@ -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
|
||||
}
|
||||
}
|
||||
@@ -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-<sha>`. 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.
|
||||
@@ -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
|
||||
@@ -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": []
|
||||
}
|
||||
@@ -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": []
|
||||
}
|
||||
@@ -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.
|
||||
@@ -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))
|
||||
|
||||
Reference in new issue
Block a user