kailash-pact 0.4.0__tar.gz

kailash_pact-0.4.0/.gitignore

@@ -0,0 +1,144 @@
+# Dependencies
+node_modules/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+!scripts/hooks/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.python-version
+
+# IDE specific files
+.idea/
+.vscode/
+.cursor/
+*.swp
+*.swo
+.DS_Store
+.jbeval/
+
+# Testing
+.pytest_cache/
+.coverage.*
+htmlcov/
+test_*.db
+test_shared_*.db
+demo_mcp.db
+mcp_registry.db
+mcp_registry.json
+test-env
+*.db
+*.db-wal
+*.db-shm
+default.db
+
+# Kaizen checkpoints (local agent state)
+.kaizen/
+
+# Internal task tracking
+todos/
+**/todos/
+
+# Claude Code session data (keep agents/skills/rules, ignore session artifacts)
+.claude/learning/
+.claude/settings.local.json
+**/.claude/learning/
+
+# Coverage artifacts
+.coverage
+**/.coverage
+
+# Hypothesis test cache
+.hypothesis/
+**/.hypothesis/
+
+# Playwright MCP artifacts
+.playwright-mcp/
+
+# Benchmarks
+.benchmarks/
+
+# Mypy / Ruff caches
+.mypy_cache/
+.ruff_cache/
+
+# Housekeeping
+.temp_cleanup/
+
+# Documentation builds
+docs/_build/
+docs/api/_build/
+docs/*/_build/
+_build/
+site/
+*.doctree
+
+# Data
+data/
+
+# Generated outputs - all output directories
+outputs/
+output/
+examples/outputs/
+examples/output/
+
+# Generated files in root and examples directories
+/*.csv
+/*.json
+/examples/*.csv
+/examples/*.json
+/examples/customer_*.csv
+/examples/processed_data.csv
+
+# Task tracking storage (if they exist outside examples/data)
+**/task_storage/
+**/tasks/runs/
+**/tasks/tasks/
+**/tasks/metrics/
+**/*_tracking/
+
+# Jupyter Notebooks
+.ipynb_checkpoints
+
+# Local development
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+.env.test
+docs/build_output.txt
+output.txt
+
+# Build/release artifacts
+test-release/
+dist/
+
+# Secrets baseline (local security scanning)
+.secrets.baseline

kailash_pact-0.4.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: kailash-pact
+Version: 0.4.0
+Summary: PACT governance framework — D/T/R accountability grammar, operating envelopes, knowledge clearance, and verification gradient for AI agent organizations
+Project-URL: Documentation, https://docs.terrene.foundation/kailash-pact
+Project-URL: Repository, https://github.com/terrene-foundation/kailash-py/tree/main/packages/kailash-pact
+Project-URL: Issues, https://github.com/terrene-foundation/kailash-py/issues
+Author: Terrene Foundation
+License-Expression: Apache-2.0
+Keywords: AI,D/T/R,EATP,agent,clearance,envelopes,governance,pact,trust
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+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 :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0
+Requires-Dist: fastapi>=0.109
+Requires-Dist: kailash[pact]>=2.1.0
+Provides-Extra: all
+Requires-Dist: kailash-kaizen>=2.0.0; extra == 'all'
+Requires-Dist: psycopg-pool>=3.0; extra == 'all'
+Requires-Dist: psycopg[binary]>=3.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: hypothesis>=6.98; extra == 'dev'
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.3; extra == 'dev'
+Provides-Extra: kaizen
+Requires-Dist: kailash-kaizen>=2.0.0; extra == 'kaizen'
+Provides-Extra: postgres
+Requires-Dist: psycopg-pool>=3.0; extra == 'postgres'
+Requires-Dist: psycopg[binary]>=3.0; extra == 'postgres'
+Description-Content-Type: text/markdown
+
+# kailash-pact
+
+**PACT governance framework** — D/T/R accountability grammar, operating envelopes, knowledge clearance, and verification gradient for AI agent organizations.
+
+Part of the [Kailash](https://github.com/terrene-foundation/kailash-py) enterprise AI platform.
+
+## Quick Start
+
+```python
+from pact.governance import GovernanceEngine
+
+engine = GovernanceEngine.from_yaml("my-org.yaml")
+verdict = engine.verify_action("D1-R1-T1-R1", "write_report", {"cost": 50.0})
+
+if verdict.allowed:
+    print("Approved:", verdict.reason)
+else:
+    print("Blocked:", verdict.reason)
+```
+
+## Installation
+
+```bash
+pip install kailash-pact
+```
+
+With Kaizen agent integration:
+```bash
+pip install kailash-pact[kaizen]
+```
+
+## Features
+
+- **D/T/R Grammar Engine** — Accountability grammar (Department/Team/Role) with positional addressing
+- **Three-Layer Envelopes** — Role (standing) + Task (ephemeral) = Effective (computed intersection)
+- **Knowledge Clearance** — Five-level classification independent of authority/seniority
+- **5-Step Access Enforcement** — Clearance → Classification → Compartment → Containment → Deny
+- **GovernanceEngine** — Single facade composing all primitives
+- **PactGovernedAgent** — Wrap any Kaizen agent with governance enforcement
+- **SQLite/PostgreSQL Stores** — Persistent governance state
+- **REST API** — 9 governance endpoints with auth and rate limiting
+- **CLI** — `kailash-pact validate org.yaml`
+
+## Documentation
+
+- [Quickstart](docs/quickstart.md) — Zero to governance in 10 minutes
+- [Architecture](docs/architecture.md) — How it all fits together
+- [Vertical Guide](docs/vertical-guide.md) — Build your own governed platform
+- [API Reference](docs/api.md) — REST endpoints
+- [Cookbook](docs/cookbook.md) — Common patterns
+- [YAML Schema](docs/yaml-schema.md) — Org definition format
+
+## License
+
+Apache 2.0 — Terrene Foundation

kailash_pact-0.4.0/README.md

@@ -0,0 +1,55 @@
+# kailash-pact
+
+**PACT governance framework** — D/T/R accountability grammar, operating envelopes, knowledge clearance, and verification gradient for AI agent organizations.
+
+Part of the [Kailash](https://github.com/terrene-foundation/kailash-py) enterprise AI platform.
+
+## Quick Start
+
+```python
+from pact.governance import GovernanceEngine
+
+engine = GovernanceEngine.from_yaml("my-org.yaml")
+verdict = engine.verify_action("D1-R1-T1-R1", "write_report", {"cost": 50.0})
+
+if verdict.allowed:
+    print("Approved:", verdict.reason)
+else:
+    print("Blocked:", verdict.reason)
+```
+
+## Installation
+
+```bash
+pip install kailash-pact
+```
+
+With Kaizen agent integration:
+```bash
+pip install kailash-pact[kaizen]
+```
+
+## Features
+
+- **D/T/R Grammar Engine** — Accountability grammar (Department/Team/Role) with positional addressing
+- **Three-Layer Envelopes** — Role (standing) + Task (ephemeral) = Effective (computed intersection)
+- **Knowledge Clearance** — Five-level classification independent of authority/seniority
+- **5-Step Access Enforcement** — Clearance → Classification → Compartment → Containment → Deny
+- **GovernanceEngine** — Single facade composing all primitives
+- **PactGovernedAgent** — Wrap any Kaizen agent with governance enforcement
+- **SQLite/PostgreSQL Stores** — Persistent governance state
+- **REST API** — 9 governance endpoints with auth and rate limiting
+- **CLI** — `kailash-pact validate org.yaml`
+
+## Documentation
+
+- [Quickstart](docs/quickstart.md) — Zero to governance in 10 minutes
+- [Architecture](docs/architecture.md) — How it all fits together
+- [Vertical Guide](docs/vertical-guide.md) — Build your own governed platform
+- [API Reference](docs/api.md) — REST endpoints
+- [Cookbook](docs/cookbook.md) — Common patterns
+- [YAML Schema](docs/yaml-schema.md) — Org definition format
+
+## License
+
+Apache 2.0 — Terrene Foundation