Files
marqdo-cli/docs/releases/3.0.0-beta.1.md
T
cflmy eeea01d672
Linux strict security lane (G-C) / strict isolation escape matrix (push) Canceled after 0s
CI / fmt + clippy + test (Linux x86_64) (push) Canceled after 0s
CI / schema instance validation + consumers (push) Canceled after 0s
CI / runtime contract (macos-latest) (push) Canceled after 0s
CI / runtime contract (windows-latest) (push) Canceled after 0s
CI / release evidence manifest (push) Canceled after 0s
CI / release candidate artifact (macos-latest) (push) Canceled after 0s
CI / release candidate artifact (ubuntu-latest) (push) Canceled after 0s
ci/woodpecker/push/main Pipeline was canceled
docs(release): add explicit repository documentation links to beta release notes
The release body and notes now point to the third-party handbook, developer
entry page, support matrix and STATUS/evidence pages by absolute URL, and state
which docs are bundled in the archive versus repository-only. No source or
artifact change; the tag v3.0.0-beta.1 still names 2c7c4f3.
2026-11-22 08:38:52 +08:00

111 lines
5.2 KiB
Markdown

# 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.
## Documentation and entry points
- Third-party integration handbook:
https://git.cflmy.cn/cflmy/marqdo-cli/src/branch/master/docs/MARQDO_THIRD_PARTY_INTEGRATION_GUIDE.md
- Developer entry page:
https://git.cflmy.cn/cflmy/marqdo-cli/src/branch/master/docs/developers/README.md
- Support matrix:
https://git.cflmy.cn/cflmy/marqdo-cli/src/branch/master/COMPATIBILITY.md
- Status and same-SHA evidence:
https://git.cflmy.cn/cflmy/marqdo-cli/src/branch/master/docs/STATUS.md
- The archive itself contains `spec/`, `docs/developers/`, `examples/` and
`tests/consumers/`; repository-only pages (STATUS, evidence, the full
prerelease policy) are linked above and are not duplicated into the archive.