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

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
  • 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

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