Release Notes
APF has not published a tagged release. Every workspace crate is at version 0.1.0, and this documentation describes the repository’s main branch. When releases are tagged, their notes will appear on this page.
Policy Supply
- Signed policy bundles in the yaml-sigil format, with Ed25519 signing in
apf-compile genfixtureand Ed25519 or ECDSA P-256 trust roots. - Verification of the signature, every member digest, the validity window, and an anti-rollback revision counter. A restart can reload the bundle that is already active.
- Local file and HTTP bundle sources, with polling and hot swap for the HTTP source and
POST /v1/refreshfor the local source. - JSON Schemas and protobuf contracts for every authored document kind in
contracts/.
Decision and Enforcement
- Cedar evaluation with the annotator, Cedar, and effect pipeline, capability grants and control rules, body rewriting, header mutations, verdicts, and findings.
- Policy set hot swap in the gateway without a restart.
- OpenShell gateway interceptor: signed sandbox policy injection and validation, refresh of running sandboxes, and governance of policy edits, proposals, approvals, providers, and provider profiles.
- OpenShell supervisor middleware: per-request evaluation of HTTP requests and MCP tool calls at
PRE_CREDENTIALS. - Caller authentication with OpenShell extension tokens and TLS on both listeners.
- OpenShell bindings pinned to
v0.1.3, with extension protocol1.0negotiation.
Evidence
- The
apf.audit.event.v1schema, with one JSON Lines file per component. - Records for the policy lifecycle, document distribution, admissions, governance decisions, per-request decisions, the MCP tool on each request, and refused callers.
- Provenance tokens on every document served over gRPC.
Deployment
- Hardened systemd units with a polkit rule, under
deploy/systemd/. - Dockerfiles and a Docker Compose development stack (
compose.yaml), underdeploy/docker/. - A Helm chart for Kubernetes, under
deploy/helm/apf/. You build and load the images yourself. Refer to Kubernetes. - A verification harness under
e2e/that runs the Compose stack and the Helm chart against a real OpenShell gateway. - CI that builds release binaries of both services with SHA-256 checksums and third-party license notices.
Not Yet Available
The capabilities marked In Development in this documentation, a metrics endpoint and a delegation model, are not on main. Published container images and a published Helm chart, a shared policy service, and a verified user identity on the OpenShell request path are not in the repository either. Refer to Support and Compatibility.
Next Steps
- If something does not work as expected, refer to Troubleshooting.
- To move between builds, refer to Upgrade Guides.