Skip to content

Plan, apply and roll back changes to a production ontology, with a blast radius report and a proof an auditor can re-check.

docs: document governance webhook for OpenCheir integration

FABIOTESSbbff5e8ff6c7
diff --git a/CLAUDE.md b/CLAUDE.md
index 5c51cfe5..fbc917cd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -182,6 +182,18 @@ If [OpenCheir](https://github.com/fabio-rovai/opencheir) is also connected as an
- **onto_validate_after_save** — warns if you save 3+ times without validating
- **onto_version_before_push** — warns if you push without saving a version snapshot first
+To enable automatic governance (no Claude orchestration needed), start with the governance webhook:
+
+```bash
+# Start OpenCheir first (it listens on port 9900 by default)
+opencheir serve &
+
+# Then start Open Ontologies pointing at OpenCheir's enforcer endpoint
+GOVERNANCE_WEBHOOK=http://localhost:9900/api/enforcer/event open-ontologies serve
+```
+
+Every lineage event (plan, apply, save, push, etc.) is automatically POSTed to OpenCheir's enforcer, which evaluates rules and logs verdicts.
+
These rules are optional — Open Ontologies works perfectly without OpenCheir.
## Benchmarks
diff --git a/README.md b/README.md
index 71e4580f..e90a4d55 100644
--- a/README.md
+++ b/README.md
@@ -304,7 +304,7 @@ Full benchmark writeup: [docs/benchmarks.md](docs/benchmarks.md)
| **Schema** | `import-schema` | PostgreSQL → OWL conversion |
| **Data** | `map` `ingest` `shacl` `reason` `extend` | Structured data → RDF pipeline |
| **Versioning** | `version` `history` `rollback` | Named snapshots and rollback |
-| **Lifecycle** | `plan` `apply` `lock` `drift` `enforce` `monitor` `monitor-clear` `lineage` | Terraform-style change management with webhook alerts |
+| **Lifecycle** | `plan` `apply` `lock` `drift` `enforce` `monitor` `monitor-clear` `lineage` | Terraform-style change management with webhook alerts and [OpenCheir](https://github.com/fabio-rovai/opencheir) governance integration |
| **Alignment** | `align` `align-feedback` | Cross-ontology class matching with self-calibrating confidence |
| **Clinical** | `crosswalk` `enrich` `validate-clinical` | ICD-10 / SNOMED / MeSH crosswalks |
| **Feedback** | `lint-feedback` `enforce-feedback` | Self-calibrating suppression |