Files

2.1 KiB

marqdo-extension-conformance

Independent, physically separate conformance fixtures for RFC-EXT-0001: a third-party repository that provides all five extension kinds without modifying or recompiling marqdo-cli.

Everything here is built and executed by a frozen marqdo binary whose absolute path is supplied as $MARQDO_BIN. No script in this repository runs Cargo, links a Rust crate, reads marqdo-cli's test fixtures, or writes into the CLI workspace.

Directory Extension kind Entry point
pure-lib/ .mq.md package (pinned Git) consumer/ project locks it by full SHA
plugin/ Callable ABI plugin (worker transport) plugin/plugin.yaml, C ABI v1
kernel/ Foreign kernel (mocklang) kernel/kernel.json, one-shot process
provider/ Resource provider v2 (demo.sensor) provider/provider.json, worker helper + C ABI
tool/ CLI Tool tool/tool.json, inspect-ext command

Quick start

cargo build --release -p marqdo-cli                 # in ../marqdo-cli (once)
export MARQDO_BIN=/abs/path/to/target/release/marqdo
# Ship the provider helper sibling exactly as the release archive does:
cp /abs/path/to/target/release/marqdo-provider-worker "$(dirname "$MARQDO_BIN")"/

./scripts/build_all.sh
python3 tests/run_all.py          # writes evidence/results.json

tests/verify_frozen_cli.py hashes $MARQDO_BIN before and after the suite and fails if the binary changed. The committed evidence/results.json is generated, not hand-edited; evidence/manifest.json is produced by the CLI repository's tools/ci/verify_extension_contracts.py.

Contract

See CONTRACT.md for the exact language/ABI/wire/schema versions and supported platform matrix. plugin/include/marqdo_plugin_abi_v1.h is a verbatim copy of the public ABI header published by the CLI repository; the provider ABI declarations are re-declared in provider/src/sensor.c from the public C ABI specification because no separate provider header is published yet.