Files
marqdo-extension-conformance/CONTRACT.md
T
cflmy e22ec95b09
extension-conformance / conformance (push) Waiting to run
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

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