Metadata-Version: 2.4
Name: governance-commons
Version: 0.1.1
Summary: Governance Commons reference implementation — ONS name validation and shared utilities for Python adopters.
Author: jj-ervin
License-Expression: MIT
Project-URL: Homepage, https://github.com/governancecommons/governance-commons-registry
Project-URL: Repository, https://github.com/governancecommons/governance-commons-registry
Keywords: governance,naming,ons,ontic-namespace-structure,schema,validation,agent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Dynamic: license-file

# governance-commons

**Alpha — ONS validation only.** Reference implementation of Governance
Commons standards: machine-checkable naming rules and conformance
reporting, with matching Python and TypeScript implementations.

v0.1.0 validates the **ONS (Ontic Namespace Structure)** naming spec.
Agent Dossier, Agent Matrix, and Agent Project Orchestrator validation
are planned but not implemented yet — `--spec` currently accepts `ons`
only.

## Install

```bash
pip install governance-commons
# or
npm install governance-commons
```

## Quickstart

`manifest.json`:

```json
{
  "checks": [
    { "domain": "python_identifier", "name": "run_intent" },
    { "domain": "governance_cluster", "name": "ONS" }
  ]
}
```

```bash
gc-validate --spec ons manifest.json
```

```text
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>`.

## Packages

- Python package: `governance-commons` — CLI commands `gc-validate`, `gc-report`
- npm package: `governance-commons` — CLI commands `gc-validate`, `gc-report`

## Development

```powershell
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`.
