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.
5.2 KiB
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 marqdoSHA256:062cb56e226bee55c21d238e195920caa985e62bb3877ba7b07abcc04dc0fe3fmarqdo-provider-workerSHA256:7266db75f52e2954b29f8f018d957e1cae3110a239f98dfe1f34b73c90c96ba2- Toolchain: rustc/cargo 1.100.0;
Cargo.lockcommitted,--lockedbuild
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
marqdoandmarqdo-provider-workertogether; 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.projectmode 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
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/andtests/consumers/; repository-only pages (STATUS, evidence, the full prerelease policy) are linked above and are not duplicated into the archive.