3.3 KiB
Conformance contract
This repository targets the exact versions below. It makes no "latest version works" claim. Unknown/newer protocol versions fail closed.
| Contract | Version used here | Required by |
|---|---|---|
| Marqdo Core CLI | 0.1.0 (frozen binary SHA recorded in evidence/) |
all |
| Language semantics | RFC-LANG-0002 / ADR-0052 (one Markdown→program mapping) | .mq.md fixtures |
| Markdown profile | marqdo.md.v1 |
all documents |
| Plugin ABI | C ABI v1 (MQ_ABI_MAJOR=1, host target triple recorded in plugin/build/plugin.yaml) |
plugin/ |
| Plugin package manifest | plugin.yaml ABI v1 |
plugin/ |
| Value Wire | wire_version: 1, type-tagged JSON |
plugin and foreign payloads |
| Foreign kernel descriptor | kernel.json v1 (wire_version: 1) |
kernel/ |
| Resource provider manifest | marqdo.provider schema v2, transport: worker, abi: c-abi-1 |
provider/ |
| Resource provider worker protocol | ADR-0035 framed JSON (host ↔ helper) + C ABI v1 (helper ↔ library) | provider/ |
| Analysis | Analysis v2 (marqdo check --emit) |
tool/ |
| Trace | Trace v2 (marqdo run --trace-file) |
tool/ |
| CLI Tool Protocol | v1 (marqdo.cli-tool, schema_version 1) |
tool/ |
Platform matrix
| Lane | Status |
|---|---|
| Linux x86_64 (glibc) | supported — the mandatory conformance lane |
| macOS arm64/x86_64 | unverified by this repository unless tests/run_all.py is run there with a native build |
| Windows x86_64 | unsupported for plugin/provider C ABI in this fixture; the pure .mq.md, kernel and tool cases are portable but not claimed until run |
plugin/build_all.sh and provider/build_all.sh build for the host target
and write that target triple + artifact SHA-256 into the generated manifest;
the committed manifests contain zero digests and are templates only.
Hash and identity rules
- Artifact SHA-256 is integrity, not publisher identity or a signature.
marqdo.lockpins the pure-library Git commit by full 40-character SHA; the consumer never resolves a branch or "latest".- The plugin/provider manifests are matched against the static descriptor and the loaded artifact; a changed byte fails before the entry function runs.
- Analysis/Trace evidence is consumed as public JSON only; no private Rust IR is linked or copied.
Grants and failure behaviour
| Extension | Explicit grant | Without grant | Without manifest |
|---|---|---|---|
.mq.md package |
none beyond project mode | n/a | unresolved import (static error) |
| Plugin | --allow-plugin demo.ext (+ --plugin) |
permission.denied |
symbol.unknown |
| Foreign kernel | --allow-foreign (+ --kernel) |
permission.denied |
kernel.unavailable |
| Provider | --allow-provider demo.sensor (+ --provider) |
permission.denied |
resource.unsupported |
| Tool | none (tool runs as its own process) | n/a | command is unknown |
pure/strict modes reject extension flags and third-party execution; this
repository never claims strict L2 or an OS sandbox for worker transports.
Environment assumptions
Linux x86_64, Python 3 (stdlib only), a C compiler (cc), Git. No network is
required: the consumer test creates its pinned Git repository locally with
git init + git commit and a full SHA. No Node/Python runtime is required
for the kernel case: mocklang is a POSIX shell script.