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
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.
111 lines
5.2 KiB
Markdown
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.
|