- docs/evidence/extension/6a7bb98.../manifest.json: tested_sha6a7bb98, cli sha256 28e3776d..., fixture repo e4b7352c..., all 7 required categories PASS - RFC-EXT-0001 status Implemented with PR-by-PR record and honest release caveat - STATUS/CURRENT/COMPATIBILITY/evidence report bind the executed result - workspace gate re-run: fmt/clippy clean, 599 passed across 67 targets Code tree at6a7bb98is byte-identical; this commit adds evidence/docs only.
11 KiB
Compatibility and support matrix
Snapshot: workspace version 0.1.0, RFC-EXT-0001 tree on
feat/extensible-ecosystem, no release tag cut. This file records what was
actually verified and separates it from what is only implemented. Executed
status is in docs/STATUS.md; SHA-bound external evidence is
under docs/evidence/extension/.
Language source syntax (breaking change)
The .mq.md source language is a breaking change. The current contract is
RFC-LANG-0002
(accepted by ADR-0052), with the
normative summaries in spec/mapping.md and
spec/expression.ebnf:
- H1–H6 headings declare
@exec/@knowledgemodes; unmarked headings inherit the nearest ancestor's mode and the document root is Knowledge. - Only an Exec H2 is a callable function. H2 Knowledge is inert and H3–H6 are non-callable sections.
- In an Exec scope,
Strong,Emphand inlineCodeare interchangeable carriers of one statement; the original emphasis role is gone. - Control flow comes from keywords in the payload (
if/else/while/end/return/params(...)). Ordered lists, bullet lists and block quotes are inert presentation containers. - There is no version selector,
--legacypath or fallback mapper.
Consequences for compatibility:
- Old pre-RFC
.mq.mdsource is not executable. A file that relied onStrong= execute,Emph= return, ordered list = branch, bullet list = loop, block quote = call or a first code-span signature must be rewritten by AST role (seedocs/migration/README.md). A parse failure is a hard diagnostic, never a fallback to prose. - The Markdown parser profile stays
marqdo.md.v1; only the Markdown→program mapping changed. Rendering of otherwise-ordinary Markdown is unaffected. - Implementation state: RFC-LANG-0002 is implemented by the frontend,
expression parser, IR lowering, runtime and bundled stdlib. At
9c1723dthe workspace gate iscargo test --workspace --locked: 507 passed, 0 failed, 2 ignored, and the stdlib digest is regenerated and verified. Seedocs/STATUS.mdanddocs/evidence/2026-11-21-semantics-v2-green.md.
Public protocol versions
| Surface | Version | Compatibility rule |
|---|---|---|
| Markdown profile | marqdo.md.v1 |
Frozen parser/options. The RFC-LANG-0002 mapping rewrite keeps this profile; the source-language break is tracked above, not by a new profile id. |
| Language / CLI | workspace 0.1.0 |
Pre-1.0. The .mq.md source language changed incompatibly (RFC-LANG-0002); there is no old-syntax execution path. CLI flags may change with a changelog note; strict refusal is contractual. |
marqdo.lock |
v4 | v3 is rejected with an explicit marqdo lock migration error; v1/v2 are rejected with a relock instruction; run/call/check never rewrite or fetch the lock. extensions: records manifest/artifact identity (integrity, not publisher auth). |
| Analysis | v2 | Consumers reject unknown majors; incompatible field changes require v3. |
| Trace | v2 | Binds to the exact Analysis bytes; unknown majors rejected. |
| CLI Tool | v1 | Manifest schema, SemVer negotiation and whole-bundle digest are stable for v1. |
| Plugin ABI | v1 | Struct layout/version negotiation frozen; --trust-native-plugin is required for in-process loading. The static manifest signature is authoritative; run reconciles loaded exports/signatures/owners/artifact digests exactly (ext.plugin_binding_mismatch); ABI v1 defaults are rejected. |
| Resource Provider manifest | v2 | schema_version: 2, abi: c-abi-1, transport: worker; v1 is rejected (ext.unsupported_provider_schema), no silent migration. CLI --provider/--allow-provider; trusted worker, not an OS sandbox. |
| Callable resolution | ADR-0054 | One registry + one binding pass; check and run bind the same CallSiteKey; no runtime name fallback. Import aliases colliding with builtin/plugin dotted namespaces are rejected. |
Analysis calls[].state/target |
v2 (projection) | Now projected from the unique binding; official stdlib aliases appear as function. Schema/version unchanged; private binding table not serialized. |
| Extension selection | lock v4 | marqdo.yaml.extensions only ./path or @alias/path; declaration is not a grant; declared identity must match the lock (ext.extension_lock_mismatch). |
| Foreign wire | v1 | One-shot request envelope; provider descriptors are explicit. |
Platform / feature evidence
Legend: PASS = executed on this snapshot with logs; UNVERIFIED = code is portable/tested locally but the native platform lane has not run here; UNSUPPORTED = deliberately not claimed; FAIL-CLOSED = request is refused.
| Feature | Ubuntu Linux x86_64 | macOS arm64 | Windows x86_64 |
|---|---|---|---|
| Markdown profile / AST goldens (160) | PASS | UNVERIFIED (cfg fix + CRLF fix) | UNVERIFIED (cfg fix + CRLF fix) |
| Rust interpreter / unified semantics (73) | PASS | UNVERIFIED | UNVERIFIED |
Addressable Memory P1 (ADR-0022) |
PASS | UNVERIFIED | UNVERIFIED |
| Resource streams CM-A06 (ADR-0025/0026: stdout + project file read/write) | PASS | UNVERIFIED | FAIL-CLOSED (strict refuses resource opens) |
run / call / check / inspect / fmt |
PASS | UNVERIFIED | UNVERIFIED |
| lock v4 path/Git graph + sync + tamper | PASS | UNVERIFIED | UNVERIFIED |
Extension selection/lock v4 (extensions:, identities, inspect --extensions) |
PASS | UNVERIFIED | UNVERIFIED |
Callable single binding + ext.import_namespace_conflict/symbol.unknown/plugin reconciliation |
PASS | UNVERIFIED | UNVERIFIED |
| Official stdlib public aliases (print de-magic; byte-identical output) | PASS | UNVERIFIED | UNVERIFIED |
Resource Provider v2 CLI (--provider/--allow-provider, worker helper) |
PASS (linux/x86_64; real C sensor + helper) | FAIL-CLOSED (ext.platform_unsupported) |
UNSUPPORTED |
Capability handler registry (fs.read handler, audit, unavailable) |
PASS | UNVERIFIED | UNVERIFIED |
External conformance repository (marqdo-extension-conformance, frozen CLI) |
PASS (--release binary sha256 28e3776d…, fixture repo e4b7352c…; see docs/evidence/extension/6a7bb983.../manifest.json) |
UNVERIFIED | UNVERIFIED |
| Analysis v2 / Trace v2 + Python consumers | PASS | UNVERIFIED | UNVERIFIED |
| Tool Protocol v1 + 3 independent consumers | PASS | UNVERIFIED | UNVERIFIED |
Native ABI (plugin inspect, trusted call) |
PASS (C fixture) | UNVERIFIED (host-native fixture) | UNSUPPORTED |
Worker ABI + fs.read bridge |
PASS (Unix) | UNVERIFIED | UNSUPPORTED (Unix-gated) |
| Foreign Python/Node | PASS (system python3/node) |
UNVERIFIED | UNVERIFIED |
| Foreign pinned environment binding | PASS | UNVERIFIED | UNVERIFIED |
strict Linux L1 (pure Marqdo + Math) |
PASS, probe-gated, 7/7 VM lane | FAIL-CLOSED | FAIL-CLOSED |
strict L2 (Worker/Foreign/native) |
UNSUPPORTED (flags refused) | UNSUPPORTED | UNSUPPORTED |
The Ubuntu column is from this development host (Ubuntu 26.04 container) and a
disposable Ubuntu 26.04 QEMU/TCG VM for the security lane. It is not a
GitHub Actions result: this checkout has a Gitee remote and no GitHub
credentials. A fresh local clone with core.autocrlf=true was used to
reproduce the Windows checkout byte behavior.
Strict L1 scope (ADR-0021)
- Enabled only when the runtime Bubblewrap probe succeeds. Probe failure or a
probe→launch race exits non-zero with a diagnostic and never falls back
to
project. - Inside the sandbox: user/mount/PID/net/UTS/IPC namespaces, no-new-privs,
empty capabilities, read-only
/project, private/proc//dev//tmp, rlimits and wall-clock/output supervision; the child verifiesPID 1,NoNewPrivs,CapEff=0, a non-initial uid map and no non-loopback network. - Refused before launch:
--allow-read,--allow-write,--allow-foreign,--allow-plugin,--plugin,--trust-native-plugin,--kernel,--trace-file. - Strict L2 (letting Worker/Foreign/native plugin run inside the sandbox) is not implemented and must not be inferred from L1 passing.
Minimum environment
- Rust 1.82+ (verified with 1.100.0).
- Linux/macOS: a C compiler for Native ABI fixtures; Python/Node only for
Foreign kernels;
gitfor Git dependencies. strictadditionally requires Bubblewrap and a kernel/environment that permits user, mount, PID and network namespaces. Seedocs/security-gate.mdand ADR-0021.
RFC-EXT-0001 platform statements
- Provider worker transport: linux/x86_64 only; macOS/Windows return
ext.platform_unsupported(compile-only, fail-closed). The RFC's macOS provider lane is not claimed. - Windows Native/Worker ABI remains UNSUPPORTED; a Linux PASS does not substitute for it.
strictL1 continues to refuse plugins/providers/foreign kernels; strict L2 is not implemented. A worker is a trusted process, not an OS sandbox.- The external conformance suite is a mandatory additional release gate
(
docs/releasing.md§7); it does not replace G3/G4/native lanes.
Explicitly unsupported in this candidate
- Pre-RFC
.mq.mdsource syntax (Strong-execute / Emph-return / ordered-list branch / bullet-list loop / block-quote call / first code-span signature). Old sources are a rewrite task, not a compatibility mode: there is no--legacy,marqdo_semanticsselector or second mapper. - OS-level strict isolation on macOS/Windows (Linux only, probe-gated).
- Strict L2: Worker/Foreign execution inside strict (refused in L1).
- Windows Native/Worker ABI runtime support.
- Automatic uv/npm/venv provisioning; only an explicitly provisioned, pinned directory is verified (and must contain a regular-file executable).
- Registry/package publishing, JIT, Knowledge/Proof/View built-ins,
sessions, and general-purpose CAS. The three
sample-*tools are test fixtures for the generic Tool protocol, not product features. - Tagged Windows/macOS release archives: the native build/test matrix is
green at
5fcc111, but the tag/dispatch release-candidate job has not produced those archives.
Release decision
DO NOT RELEASE. The RFC-CI-0001 series fixed the platform E0425 build
break, the strict --json empty-stdout defect (ADR-0053) and the native
Windows/macOS portability failures. Linux, Windows and macOS native jobs are
green, and G4 is MEASURED/WARN on the designated Woodpecker agent
(1199c88, 9/9 correctness-verified, pinned CPU). The release still lacks the
remote G3 security artifact with a matching tested_sha; a local VM PASS
is not a remote G3 proof. The G4 node is a shared powersave host, so its gate
is provisional. See docs/STATUS.md §0.1 and
docs/evidence/ci/README.md.