governance-commons
Alpha. Reference implementation of Governance Commons standards: machine-checkable naming rules, capability-contract discovery, and conformance reporting.
The Python v0.2.0 package validates ONS (Ontic Namespace Structure) and
Capability Contract v0.1 declarations. The npm package remains ONS-only in
this MVP.
Agent Dossier, Agent Matrix, and Agent Project Orchestrator validation
are planned but not implemented yet — --spec currently accepts ons
only.
Install
pip install governance-commons
# or
npm install governance-commons
Quickstart
manifest.json:
{
"checks": [
{ "domain": "python_identifier", "name": "run_intent" },
{ "domain": "governance_cluster", "name": "ONS" }
]
}
gc-validate --spec ons manifest.json
GC Conformance Report
Spec: ons 1.4.0 (standard profile)
Subject: manifest.json
Result: PASS
+ [ONS-CASING-001] Python identifiers must be snake_case
+ [ONS-CASING-006] Cluster names must be 2–6 uppercase ASCII letters
Summary: 2 passed, 0 failed, 0 skipped of 2 total
Add --output json to get the same report as structured JSON, or save
it and inspect it later with gc-report <file>.
Validate and discover capability declarations:
gc-validate --spec capabilities .governance/contracts/capabilities.yaml
gc-discover --capability asset.palette.generate ../niji ../another-repo
Discovery validates every contract it reads and reports invalid declarations. It does not evaluate or grant execution authority.
Packages
- Python package:
governance-commons— CLI commandsgc-validate,gc-report,gc-discover - npm package:
governance-commons— CLI commandsgc-validate,gc-report
Development
python -m pytest -q
npm test
python -m build
npm pack --dry-run
Project Shape
This directory is the SDK/reference-implementation repo. VS Code extensions should live in separate repos, such as agent-dossier-vscode or governance-commons-vscode.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file governance_commons-0.2.0.tar.gz.
File metadata
- Download URL: governance_commons-0.2.0.tar.gz
- Upload date:
- Size: 21.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39687d2ed82e2228ebc1c3fc60a9330374c0ea017699462951fede543c4fd028
|
|
| MD5 |
e65e469192924a55e9459b1e3c97568d
|
|
| BLAKE2b-256 |
7034cb79b7434a3668592fad8e8e27ceea1e6fcea32cf42670c3587dcc7ea6d7
|
Provenance
The following attestation bundles were made for governance_commons-0.2.0.tar.gz:
Publisher:
main.yml on governancecommons/governance-commons-registry
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
governance_commons-0.2.0.tar.gz -
Subject digest:
39687d2ed82e2228ebc1c3fc60a9330374c0ea017699462951fede543c4fd028 - Sigstore transparency entry: 2514386210
- Sigstore integration time:
-
Permalink:
governancecommons/governance-commons-registry@2ac683492b4bb519c90005f26df62b23bec368a6 -
Branch / Tag:
refs/tags/sdk-v0.2.0 - Owner: https://github.com/governancecommons
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
main.yml@2ac683492b4bb519c90005f26df62b23bec368a6 -
Trigger Event:
push
-
Statement type:
File details
Details for the file governance_commons-0.2.0-py3-none-any.whl.
File metadata
- Download URL: governance_commons-0.2.0-py3-none-any.whl
- Upload date:
- Size: 16.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a35e73759c0336fc434eb666258dac5074f54a8f6e199d6b9f259003f6f0a9ea
|
|
| MD5 |
d0a1b6e04b8d6a8fb15e1c91a2e568ca
|
|
| BLAKE2b-256 |
a258c227a8b71feac0627ea707f643fa4fc618cacb8c5e419195963b6c509646
|
Provenance
The following attestation bundles were made for governance_commons-0.2.0-py3-none-any.whl:
Publisher:
main.yml on governancecommons/governance-commons-registry
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
governance_commons-0.2.0-py3-none-any.whl -
Subject digest:
a35e73759c0336fc434eb666258dac5074f54a8f6e199d6b9f259003f6f0a9ea - Sigstore transparency entry: 2514386233
- Sigstore integration time:
-
Permalink:
governancecommons/governance-commons-registry@2ac683492b4bb519c90005f26df62b23bec368a6 -
Branch / Tag:
refs/tags/sdk-v0.2.0 - Owner: https://github.com/governancecommons
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
main.yml@2ac683492b4bb519c90005f26df62b23bec368a6 -
Trigger Event:
push
-
Statement type:
