Files
cflmy e22ec95b09
extension-conformance / conformance (push) Canceled after 0s
contract: target Marqdo CLI 3.0.0-beta.1
The frozen-binary suite now negotiates the 3.0.0-beta.1 product line. Tool
compatibility requires an explicit prerelease range; the protocol versions
(Analysis v2, Trace v2, Tool v1, Plugin ABI v1, Foreign wire v1, Provider
manifest v2, lock v4) are unchanged. Re-run against the release binary SHA
recorded in evidence/.
2026-11-22 02:33:12 +08:00

62 lines
3.3 KiB
Markdown

# 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.