WCM is an open specification and reference SDK for protecting model weights when a builder deploys them into a customer's own or sovereign infrastructure. Contributions are welcome in three areas: the specification (SPEC.md, THREAT-MODEL.md), the Python reference SDK (python/), and the tests.
AgenTrust is an independent open-source project. No company funds, owns or directs it; contributions are voluntary.
This is a pre-1.0 design under review. Its public release is a deliberate call by the Project Lead, not gated on open question 8.8 (the hostile-owner residual is documented as an honest limitation, not a release blocker). Breaking spec changes (schema incompatibilities, changed release/attestation semantics, guarantee-scope changes) require an issue and discussion before a PR. Non-breaking additions and bug fixes can go straight to a PR.
The one non-negotiable: do not overclaim. WCM's value is its honesty about what the silicon does and does not guarantee (see SPEC.md §3.6). A contribution that quietly strengthens a claim beyond what the hardware delivers will be rejected.
All commits must be signed off with the Developer Certificate of Origin:
git commit -s -m "feat: add foo"
PRs without DCO sign-off will not be merged.
git clone https://github.com/agentrust-io/weight-custody-manifest
cd weight-custody-manifest/python
pip install --require-hashes -r ../requirements/dev.txt # the lock CI installs
pip install --no-deps -e .pytest -q # tests
mypy src/wcm # strict type checking
bandit -q -c pyproject.toml -r src/wcm # security scanThe lock workflow executes the checker from the pull request checkout. Changes to the checker, its scope or its workflow are changes to validation policy and require human review; a successful self-check does not independently approve that policy. The supported-platform resolver performs dry runs, not Windows execution.
- Fork and branch from
main. - Write tests for any SDK change. Anything security-relevant (signing, verification, the KBS gate, quote verification, custody) needs both a happy path and the failure paths.
- Ensure
pytest,mypy --strict, andbanditpass locally; keep coverage ≥ 80%. - Open a PR against
mainand fill in the template. - One maintainer approval is required to merge (see CODEOWNERS).
Manual dispatch of the publish workflow runs validation, source/archive scanning
and distribution builds, then saves the dist artifact for review. It requires
the current origin/main commit and performs no package publication. Only a
published GitHub Release can enter the existing PyPI publishing job, after the
release-source/version checks and successful validation and build.
- Open an issue describing the problem and the proposed change; reference the spec section.
- Allow a short comment period for reviewer feedback.
- Submit a PR to
SPEC.md(orTHREAT-MODEL.md) and update the SDK + tests so the executable model still matches the text (the example-validation test is what catches drift). - Update
CHANGELOG.mdand the spec version footer.
Code that parses or verifies real attestation formats (e.g. snp.py) must be validated against real hardware or captured vectors before its claims are stated as fact; until then it is labeled provisional. Do not remove a "provisional / unvalidated" label without the validation to back it. See python/docs/ and the PR history for how the AMD SEV-SNP path was validated.
- Python 3.11+; strict mypy
- Pydantic v2 for data models (
extra="forbid") - Standard library first; no new runtime dependency without discussion
- Conventional commits:
type(scope): short description
By contributing you agree that your contributions are licensed under Apache 2.0.