Repository navigation
apmx 0.8.0
Pre-releaseEXPERIMENTAL prerelease. Native notices and exact downloaded bytes are gated; this is not production certification.
Standalone apmx 0.8.0; candidate commit fae2067a0dc6ff07beda714015ff9e648f41ce63.
Changes in v0.8.0: Audit rows name what they check
- Breaking: the
apmx auditrowIngredientsis nowDependenciesin terminal output, JSON and SARIF (apmx-audit/dependencies) and--explain dependencies;--explain ingredientsis gone, with no alias. - Breaking: the separate
Standardsrow is removed. The same schema validation (in-toto Statement v1, SLSA Provenance v1, in-toto Test Result, CycloneDX 1.5, SLSA VSA v1) runs insideIntegrity, so a schema failure is anIntegrityfailure with the same message. Rows are now Policy, Integrity, Factory, Checks, Dependencies, Revocation, Outputs, Identity. - The audit JSON schema is
apmx-audit/2; update anything that parses rows by name. - Reference the actions and
run.ymlat@v0.8.0or its commit SHA, and re-pinfactories.signers[].workflow_shatogit rev-parse v0.8.0^{commit}.
See the v0.8.0 changelog.
What's new since v0.2.0
- Run a factory directory without writing orchestration: APMX derives execution order from the contracts' declared file dependencies.
- Deliver multiple output files together. Handoffs require every declared file, complete passing checks and an intact recorded inventory; the aggregate artifact view retains admitted outputs and the original required inputs/checks.
- Export real patches from private source edits with the bounded artifact tools, without changing the original checkout.
- Discover selected imported skills through native Copilot skill discovery, with clearer package-preparation progress and bounded terminal evidence.
- Try the software-factory example with optional Gherkin/Behave acceptance checks and separate regression checks. Its standalone checker now supports deeply nested Windows file paths with child-only Git configuration.
Compatibility and migration
BREAKING: imported skill metadata. Previously accepted imported skills can now fail admission without a nonempty name and description in SKILL.md. Names must be 1-64 lowercase letters/digits separated by single hyphens, with no leading or trailing hyphen. Selected context names must not collide case-insensitively; unsupported activation metadata is rejected.
Update the authored source package (for example, name: handoff-style with description: Write concise handoffs.), then select its updated revision through the normal dependency workflow, keeping apm.yml and its lock coherent. Do not patch generated apm_modules copies or edit lock digests by hand. Migration guide.
Leaf records use apm-contract-run/0.3 and factory records use apmx-contract-chain/0.2, separating execution from native assurance. Historical records are not rewritten and cannot authorize new handoffs.
Factory execution asks for consent interactively. Automation must pass --allow-host-access --allow-unproven-inputs; these flags do not admit failed or incomplete handoffs. Native execution is not a sandbox. Complete validated and finalized execution yields COMPLETE (0), not isolation or certification. Incomplete work remains UNPROVEN (21); rejection 20; halt 22.
Installation and assurance limits
Five native onedir archives include the runtime, LICENSE, NOTICE, release metadata, and the pinned official APM 0.33.0 backend with its complete runtime under libexec/apm. Extract the complete archive; do not move the executable out of its runtime directory.
Git, Copilot CLI, and contract-declared checker tools are external prerequisites. The CI actor is an explicitly hermetic Copilot JSONL protocol fixture, NOT live inference. Complete validated and finalized execution yields COMPLETE (0), not isolation or certification. Incomplete work remains UNPROVEN (21); rejection 20; halt 22.
No trusted publisher signature or Apple notarization is provided. macOS may carry PyInstaller's local ad-hoc signature; it is not publisher identity. Checksums prove byte integrity, not publisher authentication. Do not disable platform security to run these binaries.