# 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 | `3.0.0-beta.1` (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.lock` pins 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.