openclaw-ontology-engine 0.1.0__tar.gz

openclaw_ontology_engine-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bisdom-cell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

openclaw_ontology_engine-0.1.0/PACKAGE_README.md

@@ -0,0 +1,75 @@
+# openclaw-ontology-engine
+
+Declarative governance + tool-ontology engine for Agent Runtime control planes.
+**Bring your own YAML (Layer 2), get tool governance + semantic query +
+governance audit + declared-state convergence (Layer 1).**
+
+Extracted from a production Agent Runtime ([openclaw-model-bridge](https://github.com/bisdom-cell/openclaw-model-bridge))
+that runs 40+ scheduled jobs against a multi-provider LLM gateway — every rule
+in this engine exists because a real production incident demanded it
+(90 invariants, 23 meta-rules, 14 silent-failure scanners and counting).
+
+## Two-layer architecture
+
+| Layer | What | Who writes it |
+|---|---|---|
+| **Layer 1 — engine** (this package) | Tool Ontology engine, 5 check executors, meta-rule discovery (MRD) scanners, convergence framework, three-stage gates | project-agnostic, `pip install` |
+| **Layer 2 — config** (your repo) | `tool_ontology.yaml`, `governance_ontology.yaml`, `domain_ontology.yaml`, `policy_ontology.yaml`, `convergence_ontology.yaml` | you |
+
+The engine never hardcodes your project: all Layer 2 config is injected via
+two environment variables.
+
+## Quick start
+
+```bash
+pip install openclaw-ontology-engine
+
+# Point the engine at YOUR config + YOUR project root
+export ONTOLOGY_CONFIG_DIR=/path/to/your/ontology
+export ONTOLOGY_PROJECT_ROOT=/path/to/your/repo
+
+# Audit your invariants (exit 1 on violation — CI-friendly)
+openclaw-ontology-audit
+
+# Query your tool ontology
+openclaw-ontology-query
+```
+
+```python
+from ontology_engine.engine import ToolOntology, evaluate_policy, find_by_domain
+from ontology_engine import governance_checker
+
+onto = ToolOntology()                      # reads ONTOLOGY_CONFIG_DIR
+print(onto.allowed_tools())                # your declared tool whitelist
+print(find_by_domain("Actor"))             # your domain instances
+print(evaluate_policy("max-tools-per-agent"))  # your declared policy limits
+```
+
+## What you get
+
+1. **Tool governance** — declarative whitelist / schema / alias resolution /
+   semantic classification, replacing hardcoded tool lists.
+2. **Governance audit** — invariants with declaration + runtime verification
+   layers, executed by 5 check types (`file_contains`, `file_not_contains`,
+   `python_assert`, …).
+3. **Meta-rule discovery (MRD)** — proactive scanners for whole bug *classes*
+   (silent `except: pass`, log-to-stdout pollution, push-route bypasses, …)
+   with project patterns supplied via `mrd_scan_patterns` in your YAML.
+4. **Convergence framework** — verifies your *declared* state (job registry,
+   service list) actually matches *runtime* state (crontab, launchd), with
+   per-spec dry-run/machine-sync escalation.
+5. **Three-stage gates** — pre-check / runtime-gate / post-verify policy
+   observation at the request boundary (shadow mode by default).
+
+A complete worked example (a fictional WeatherBot runtime, nothing shared
+with the host project) lives in
+[`examples/minimal_consumer/`](https://github.com/bisdom-cell/openclaw-model-bridge/tree/main/examples/minimal_consumer).
+
+## Documentation
+
+- [Extension guide](https://github.com/bisdom-cell/openclaw-model-bridge/blob/main/docs/ontology_engine_extension_guide.md) — 60-second onboarding
+- [Packaging design](https://github.com/bisdom-cell/openclaw-model-bridge/blob/main/docs/ontology_engine_packaging.md) — architecture & roadmap
+
+## License
+
+MIT

openclaw_ontology_engine-0.1.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: openclaw-ontology-engine
+Version: 0.1.0
+Summary: Declarative governance + tool-ontology engine for Agent Runtime control planes — bring your own YAML (Layer 2), get tool governance + semantic query + governance audit (Layer 1).
+Author: bisdom
+License: MIT License
+        
+        Copyright (c) 2026 bisdom-cell
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/bisdom-cell/openclaw-model-bridge
+Project-URL: Documentation, https://github.com/bisdom-cell/openclaw-model-bridge/blob/main/docs/ontology_engine_packaging.md
+Keywords: ontology,governance,agent-runtime,control-plane,llm,tool-calling,policy-engine
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=5.4
+Dynamic: license-file
+
+# openclaw-ontology-engine
+
+Declarative governance + tool-ontology engine for Agent Runtime control planes.
+**Bring your own YAML (Layer 2), get tool governance + semantic query +
+governance audit + declared-state convergence (Layer 1).**
+
+Extracted from a production Agent Runtime ([openclaw-model-bridge](https://github.com/bisdom-cell/openclaw-model-bridge))
+that runs 40+ scheduled jobs against a multi-provider LLM gateway — every rule
+in this engine exists because a real production incident demanded it
+(90 invariants, 23 meta-rules, 14 silent-failure scanners and counting).
+
+## Two-layer architecture
+
+| Layer | What | Who writes it |
+|---|---|---|
+| **Layer 1 — engine** (this package) | Tool Ontology engine, 5 check executors, meta-rule discovery (MRD) scanners, convergence framework, three-stage gates | project-agnostic, `pip install` |
+| **Layer 2 — config** (your repo) | `tool_ontology.yaml`, `governance_ontology.yaml`, `domain_ontology.yaml`, `policy_ontology.yaml`, `convergence_ontology.yaml` | you |
+
+The engine never hardcodes your project: all Layer 2 config is injected via
+two environment variables.
+
+## Quick start
+
+```bash
+pip install openclaw-ontology-engine
+
+# Point the engine at YOUR config + YOUR project root
+export ONTOLOGY_CONFIG_DIR=/path/to/your/ontology
+export ONTOLOGY_PROJECT_ROOT=/path/to/your/repo
+
+# Audit your invariants (exit 1 on violation — CI-friendly)
+openclaw-ontology-audit
+
+# Query your tool ontology
+openclaw-ontology-query
+```
+
+```python
+from ontology_engine.engine import ToolOntology, evaluate_policy, find_by_domain
+from ontology_engine import governance_checker
+
+onto = ToolOntology()                      # reads ONTOLOGY_CONFIG_DIR
+print(onto.allowed_tools())                # your declared tool whitelist
+print(find_by_domain("Actor"))             # your domain instances
+print(evaluate_policy("max-tools-per-agent"))  # your declared policy limits
+```
+
+## What you get
+
+1. **Tool governance** — declarative whitelist / schema / alias resolution /
+   semantic classification, replacing hardcoded tool lists.
+2. **Governance audit** — invariants with declaration + runtime verification
+   layers, executed by 5 check types (`file_contains`, `file_not_contains`,
+   `python_assert`, …).
+3. **Meta-rule discovery (MRD)** — proactive scanners for whole bug *classes*
+   (silent `except: pass`, log-to-stdout pollution, push-route bypasses, …)
+   with project patterns supplied via `mrd_scan_patterns` in your YAML.
+4. **Convergence framework** — verifies your *declared* state (job registry,
+   service list) actually matches *runtime* state (crontab, launchd), with
+   per-spec dry-run/machine-sync escalation.
+5. **Three-stage gates** — pre-check / runtime-gate / post-verify policy
+   observation at the request boundary (shadow mode by default).
+
+A complete worked example (a fictional WeatherBot runtime, nothing shared
+with the host project) lives in
+[`examples/minimal_consumer/`](https://github.com/bisdom-cell/openclaw-model-bridge/tree/main/examples/minimal_consumer).
+
+## Documentation
+
+- [Extension guide](https://github.com/bisdom-cell/openclaw-model-bridge/blob/main/docs/ontology_engine_extension_guide.md) — 60-second onboarding
+- [Packaging design](https://github.com/bisdom-cell/openclaw-model-bridge/blob/main/docs/ontology_engine_packaging.md) — architecture & roadmap
+
+## License
+
+MIT