Blueprint section 10: a first-class plugin ABI independent of the legacy
MARQDO_ABI_VERSION=2, with a C ABI that is explicitly not a sandbox.
- include/marqdo_plugin_abi_v1.h: frozen stable-layout C contract with
documented buffer ownership/lifetimes, size limits, NULL/zero-length
semantics, single-threaded invocation, no hot-unload policy, version
negotiation and target-triple requirements.
- marqdo-plugin-abi (host side): repr(C) mirrors with compile-time layout
assertions, major/minor negotiation (wrong major fails, minor clamps),
plugin.yaml parsing/validation, target selection and sha256 artifact
verification, wire_version 1 typed JSON request/response envelopes,
structured PluginError, and a libloading-based loader with host alloc/free,
export registration and runtime ABI re-negotiation.
- marqdo-plugin-sdk (plugin side): mq_plugin_entry! macro, panic containment,
safe byte-buffer wrappers, capability/logging context and JSON helpers; it
depends only on the shared ABI crate.
- examples/plugin-demo: dependency-free C plugin (solver.add), manifest,
build.sh that refreshes the artifact hash, README explaining that install,
inspect and load are three different trust decisions.
- Tests: C plugin cross-compiled with cc and loaded, plus wrong ABI major,
missing symbol/artifact, hash mismatch and malformed manifest cases.