govagent 3.0.3__tar.gz → 3.2.0__tar.gz

{govagent-3.0.3 → govagent-3.2.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Niraj Kakodkar
-
-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.
+MIT License
+
+Copyright (c) 2026 Niraj Kakodkar
+
+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.

{govagent-3.0.3 → govagent-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: govagent
-Version: 3.0.3
+Version: 3.2.0
 Summary: The Governance-First Framework for Agentic AI, Enterprise Middleware & OCI Supply Chain Gating
 License: MIT
 License-File: LICENSE
@@ -39,13 +39,13 @@ Requires-Dist: slack-sdk (>=3.0.0)
 Requires-Dist: spacy (>=3.0.0)
 Project-URL: Bug Tracker, https://github.com/thekakodkar/govagent/issues
 Project-URL: Homepage, https://github.com/thekakodkar/govagent
-Project-URL: LinkedIn, https://www.linkedin.com/in/thekakodkar/
+Project-URL: LinkedIn, https://thekakodkar.github.io/govAgent/
 Project-URL: Repository, https://github.com/thekakodkar/govagent
 Description-Content-Type: text/markdown
 
-<img width="2071" height="795" alt="logo" src="https://github.com/user-attachments/assets/7aed634c-34e0-450c-9a7e-ee03ecd26ea5" />
+<img width="100%" alt="govAgent logo" src="https://github.com/user-attachments/assets/7aed634c-34e0-450c-9a7e-ee03ecd26ea5" />
 
-# govAgent (v3.0.3)
+# govAgent (v3.1.0)
 
 **The Governance-First Control Plane for AI Agents & Swarms**
 
@@ -64,6 +64,13 @@ Ideal for:
 * **Regulated Verticals:** Providing verifiable compliance out-of-the-box for Fintech, Supply Chain, Healthcare, Heavy Industry, and Legal infrastructure.
 * **Sovereign Infrastructure Operations:** Powering local Small Language Models (SLMs) and private inference nodes safely alongside or entirely independent of cloud providers.
 
+### Usage Guide
+<p align="center">
+  <a href="https://thekakodkar.github.io/govAgent/">
+     govAgent v3.1.0 - Library Documentation
+  </a>
+</p>
+
 ### 🎞️ Video Walkthrough
 
 <p align="center">
@@ -208,7 +215,7 @@ python -m spacy download en_core_web_lg
 uvicorn api.server:app --host 127.0.0.1 --port 8000
 npm run dev
 ```
-## 🏗️ Core Pillars: The v3.0.3 Sovereign Architecture
+## 🏗️ Core Pillars: The v3.1.0 Sovereign Architecture
 GovAgent utilizes a highly modular package structure to enforce a strict "Separation of Duties" across any enterprise application vertical:
 
 **govagent.context (The State):** Manages thread-safe session isolation, asynchronous parent-to-child trace propagation, and live cumulative Total Cost of Operation (TCO) calculation matrices across decentralized agent swarms.
@@ -224,6 +231,8 @@ GovAgent utilizes a highly modular package structure to enforce a strict "Separa
 
 **govagent.governance.meta (The Optimization):** Hosts the MetaGovernor engine, an automated self-healing policy loop. It continuously scrapes friction logs and repeated circuit-breaker events (such as successive budget rejections) to autonomously compile non-hallucinated, data-backed POLICY_AMENDMENT_PROPOSALS for review.
 
+**govagent.governance (3.1.0 exports):** `CFOAnalyticsEngine`, `EvidencePackGenerator`, and `ComplianceDossier` are importable from `govagent.governance`. The evidence generator reads a local JSONL buffer. A multi-tenant dossier is built from stored rows in the private control plane, [govagent-platform](https://github.com/thekakodkar/govagent-platform). `Policy` reads nested `fiscal_governance.global_limits` and `alignment` unless the same key is set at the top level. `HarborVerifier` calls Harbor v2 and fails closed unless the process is explicitly using the `mock-token` offline stub.
+
 **govagent.api & govagent.hitl (The Gateway & Judiciary):** Powers the stateless REST communication network. It exposes an async FastAPI gateway that integrates seamlessly with a Next.js long-polling frontend dashboard, while routing out-of-band policy breaches to corporate Slack workspaces via firewall-resilient webhooks to enforce role-weighted, multi-signature human consensus.
 
 ---
@@ -243,7 +252,7 @@ async def process_payment(amount: float, reference_id: str):
     """Executes a disbursement following corporate policy and OCI container validation."""
     return f"SUCCESS: Transacted ${amount} for Ref: {reference_id}"
 ```
-### Bootstrap an Executive Agent (v3.0.3 Pluggable Router Pattern)
+### Bootstrap an Executive Agent (v3.1.0 Pluggable Router Pattern)
 
 ```python
 import asyncio
@@ -314,7 +323,7 @@ Every session generates an immutable snapshot routed directly to external cloud
 
 In an institutional setting, "State Management" is insufficient; you require Sovereignty. GovAgent v1.0.0 is engineered horizontally to transform "Black Box" multi-agent workflows into transparent, compliance-vetted execution lifecycles across all commercial sectors.
 
-| Feature | **GovAgent v3.0.3** | LangGraph | Standard Orchestrators |
+| Feature | **GovAgent v3.1.0** | LangGraph | Standard Orchestrators |
 | --- | --- | --- | --- |
 | **Architectural Scope** | ✅ **Modular Control Plane** | ⚠️ Local State Graph | ❌ Ad-Hoc Swarm Execution |
 | **State Management** | ✅ **Isolated Fiscal Ledger** | ⚠️ Shared Thread State | ❌ Global context |
@@ -462,7 +471,7 @@ We enforce a strict branching strategy to keep `main` stable:
 
 ---
 ### Author Stamp
-*   **Framework:** GovAgent v3.0.3 
+*   **Framework:** GovAgent v3.1.0 
 *   **Compliance:** Designed for Article 9, 12, and 14 Accountability
 *   **Status:** Active / Open-Source Standard