@mudraforge/statutory 2.13.0 → 2.14.0

package/docs/DOMAIN_BREADTH_AND_DEPTH_COMPARISON.md

@@ -1,209 +0,0 @@
-# MudraForge Statutory Substrate: Breadth & Depth Analysis
-## Public Package Seed vs. Full Sovereign Operating Engine
-
-> **Document Version**: `2.13.0`  
-> **Package**: `@mudraforge/statutory` (v2.13.0)  
-> **Enterprise Sovereign Engine**: MudraForge Adesha Sovereign Runtime  
-> **Specification**: Google Open Knowledge Format (OKF v0.2)  
-
----
-
-## 1. Executive Overview
-
-This document provides the authoritative architectural matrix comparing the **Breadth** (regulatory domains covered) and **Depth** (granularity, operative provisos, evidence attestation, and mathematical enforcement) between:
-
-1. **The Public Package (`@mudraforge/statutory`)**: The lightweight, zero-dependency, offline-capable package of 46 verified provisions across 5 foundational domains with declarative USVM AST execution (`@mudraforge/statutory/usvm`) published for public AI agents and developer workflows.
-2. **The Full Sovereign Engine (Adesha Runtime)**: The private enterprise financial operating substrate governing live Accounts Payable (AP), Treasury, and General Ledger writebacks on the MudraForge Cloudflare Global Anycast Edge.
-
----
-
-## 2. Breadth Matrix: Regulatory Domains
-
-This matrix delineates what is **natively bundled in the base package** (zero network calls, completely offline), what is **available to pull immediately via edge sync (`npx @mudraforge/statutory sync`)**, and what is **scheduled for upcoming expansion packs** from the enterprise sovereign engine (Adesha Runtime):
-
-| # | Regulatory Domain | Base Package (Offline Clone / No Sync) | Edge Synced (`npx ... sync`) | Future Cloud Expansion (Internal Sovereign Engine) | Availability & Status in Package |
-| :-: | :--- | :--- | :--- | :--- | :---: |
-| **1** | **Direct Tax (TDS / TCS / Corporate)** | Included: 10 core provisions (194Q, 194J, 194C, 194H, 194I, 194R, 206AB, 206C(1H), 115BAA-115JB, Act 2025 Sec 393) + circulars & Form 26Q/16A/10IC | Real-time CBDT circular updates & threshold changes | Section 197 TRACES certificate quota vault, advance challan netting, automated double-entry JVs | **Bundled in Base**<br>*(Active)* |
-| **2** | **MSME & Working Capital** | Included: 4 provisions (Sections 15 & 16, MSMED-7 criteria, MCA Form MSME-1, Sec 22 Schedule III disclosures) | Live quarterly RBI repo rate tables & MSEFC state facilitation rules | Multi-interval monthly compounding calculator (`calculateMultiIntervalMsmeInterest`), Sec 23 Form 3CD addback | **Bundled in Base**<br>*(Active)* |
-| **3** | **Indirect Tax (GST & ITC)** | Included: 9 provisions (CGST 17(5) blocked credit, 8 composite/mixed, 9(3) RCM, 10 composition, 16(2) 180-day rule, 34 credit/debit notes, 51 TDS, IGST 16 LUT, Rule 48(4) IRN) | Real-time GSTR-2B reconciliation updates & notifications | Real-time Rule 48(4) IRN hash verification, Rule 89(5) Inverted Duty Structure (IDS) refund engine | **Bundled in Base**<br>*(Active)* |
-| **4** | **International Tax & FX** | Included: 4 provisions (Section 195 cross-border TDS, Ind AS 21/109 FX revaluation, IRC 901/904 FTC, Transfer Pricing 92C / Rule 10CA) | Foreign vendor DTAA treaty checklists (TRC, No-PE, electronic Form 10F) | Supreme Court *Engineering Analysis* SaaS royalty defense, Form 15CA/CB automated dual-act router | **Bundled in Base**<br>*(Active)* |
-| **5** | **Corporate M&A & Restructuring** | Included: 2 provisions (Section 50B slump sale net worth computation, Section 79 loss carry-forward & continuity) | Section 281 AO clearance NOC & Section 313 successor liability checklist | Section 50B organic undertaking test, Section 281 AO clearance NOC, Section 313 successor liability, CGST 85 going concern | **Bundled in Base**<br>*(Active)* |
-| **6** | **Corporate Governance (MCA)** | Not bundled in base | Companies Act Section 188 threshold guidance | **Full Companies Act 2013 Suite**: Section 188 (RPT audit committee & voting ban), Section 180 (borrowing limits), Section 185/186 (inter-corporate loans), Section 68 (25% buybacks) | **Planned: MCA Expansion Pack** |
-| **7** | **Capital Markets (SEBI LODR)** | Not bundled in base | Regulation 30 materiality guidelines | **SEBI LODR Suite**: Regulation 30 Materiality Triad calculator (2% turnover / 2% net worth / 50% PAT), 24-hr stock exchange disclosure timer, Regulation 23 listed RPTs | **Planned: SEBI Expansion Pack** |
-| **8** | **Financial Reporting (Advanced Ind AS)**| Core Ind AS 21/109 FX revaluation bundled | Baseline Ind AS 115 & 116 accounting summaries | **Full Indian Accounting Standards Suite**: Ind AS 115 (5-step, variable constraint), Ind AS 116 (ROU/lease liability), Ind AS 103 (PPA/goodwill/NCI), Ind AS 12 (DTA/DTL) | **Planned: Ind AS Expansion Pack** |
-| **9** | **Strategic Corporate Tax Planning** | Section 115BAA & Section 79 bundled | Extended tax planning guidance | **Strategic Tax Playbook**: Section 115BAA vs MAT credit cliff, Section 80JJAA 30% employment deduction, Section 68/115BBE cash credit defense | **Planned: Strategic Tax Pack** |
-| **10**| **Customs & Foreign Trade Policy** | Not bundled in base | Customs valuation basics | **Customs & Trade Suite**: Section 65 MOOWR duty deferral, EPCG, Advance Authorization, Section 74 fraud penalties, IGST Section 13(8)(b) intermediary traps | **Planned: Customs Pack** |
-| **11**| **Finance Operations & SOPs** | Not bundled in base | Standard 3-way match guidelines | **Enterprise Treasury Controls**: P2P 3-way match, O2C, 13-week cash forecasting, penny drop validation, maker-checker segregation of duties | **Planned: Finance Ops Pack** |
-
----
-
-## 3. Depth Matrix: Granularity, Invariants & Execution
-
-"Depth" measures the progression from declarative metadata to active legal interpretation, external government portal attestation, and deterministic arithmetic calculation:
-
-```
-Level 1: Declarative Schema (Section Code, Titles, Baseline Rates)
-   ↓
-Level 2: Official Provisos & Executive Circulars (CBDT, CBIC, MSME OMs)
-   ↓
-Level 3: Compliance Return Schemas (Form 26Q, Schedule III, GSTR-2B)
-   ↓
-Level 4: External Portal Attestation (TRACES Certificates, UDYAM Validations)
-   ↓
-Level 5: Deterministic Mathematical Execution (Excess Math, Compound Interest, Journal Vouchers)
-```
-
-### Detailed Depth Breakdown by Domain
-
-### 1. Direct Tax & Corporate Withholding (TDS / TCS / Corporate Regimes)
-* **Public Starter Seed**:
-  - Reaches **Level 3** (with Level 5 Deterministic Calculators for MAT vs 115BAA and 288B tax rounding).
-  - **Provisions**: 10 direct tax sections (194Q, 194J, 194C, 194H, 194I, 194R, 206AB, 206C(1H), 115BAA-115JB, and Income-tax Act, 2025 Section 393).
-  - **Thresholds**: ₹50 Lakh annual purchase limit, ₹10 Crore prior turnover, ₹30k/₹1L contractor aggregate, ₹2.4L rent threshold.
-  - **Rates**: 0.1% goods TDS, 2% FTS rate, 10% professional rate, 1%/2% contractor rate, 2% commission rate (Finance Act 2024), 22% 115BAA corporate rate, 15% MAT rate, 5% Section 206AA non-PAN cap.
-  - **Circulars**: CBDT Circular 13/2021, Circular 23/2017, Circular 03/2020, Circular 29/2019, Finance Act 2024/2025 transition memos.
-  - **Forms**: Form 26Q quarterly TDS return schema, Form 16A certificate schema, Form 10IC corporate tax election, Vendor PAN / 206AB declaration template.
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5**.
-  - **Full Statutory Spectrum**: Section 393(1), Table 1 of Income-tax Act, 2025 (Section 392 Rent, 393 Goods, 394 Contractors, 395 Professional/FTS, 397 Non-PAN).
-  - **TRACES Lower Deduction Vault**: Automatically ingests, validates, and tracks Section 197 / Section 395 lower withholding certificates; enforces monetary ceilings and tracks consumed quota.
-  - **Advance Netting & Challan Reconciliation**: Matches credits against Challan ITNS 281 tax deposits under Rule 30.
-  - **Deterministic Output**: Generates balanced double-entry Journal Vouchers (JVs) debiting expense/inventory, debiting GST ITC, crediting TDS Payable, and crediting AP.
-
----
-
-### 2. MSME & Working Capital (Delayed Payments, Section 43B(h) & Reporting)
-* **Public Starter Seed**:
-  - Reaches **Level 3** (with Level 5 Deterministic Calculator for Section 16 MSME compound penal interest at 3x RBI Bank Rate).
-  - **Provisions**: MSMED Act, 2006 Sections 15 & 16; MSMED Section 7 criteria; MCA Form MSME-1; MSMED Section 22 corporate balance sheet disclosures; Income-tax Act Section 43B(h).
-  - **Timelines**: Strict 15-day (without contract) or maximum 45-day (with written contract) payment clocks.
-  - **Rates**: Mandatory compound penal interest at 3x RBI Bank Rate notified by Reserve Bank of India.
-  - **Circulars**: Ministry of MSME OM 1/4(1)/2021-P&G/Policy (trader exclusion from delayed payment), Notification S.O. 2119(E) (composite investment & turnover criteria).
-  - **Forms**: UDYAM registration verification schema, Udyam composite calculation worksheet, MCA Form MSME-1 half-yearly return schema, Schedule III trade payables aging disclosure table.
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5**.
-  - **Multi-Interval Compound Interest Calculator** (`calculateMultiIntervalMsmeInterest`): Accurately tracks shifting RBI Bank Rates across multi-quarter delinquencies, compounding on monthly rests.
-  - **Section 23 Permanent Disallowance**: Enforces mandatory tax addback in Clause 22 of Tax Audit Form 3CD.
-  - **Dispute Interception Engine**: Evaluates formal 15-day defect notifications that legally pause statutory clocks under Section 15.
-
----
-
-### 3. Indirect Tax (GST, Invoicing & Input Tax Credit)
-* **Public Starter Seed**:
-  - Reaches **Level 3** (with Level 5 Deterministic Calculator for Place of Supply & Zero-Rated LUT exports).
-  - **Provisions**: 9 GST provisions: CGST Section 17(5) blocked credit, Section 8 composite/mixed supplies, Section 9(3) RCM, Section 10 composition, Section 16(2) 180-day payment rule, Section 34 credit/debit notes, Section 51 TDS, IGST Section 16 LUT export, CGST Rule 48(4) mandatory e-invoicing.
-  - **Circulars**: CBIC Circular 172/04/2022-GST (employer obligation exception), Notification 13/2017-CT(R) (RCM services), Notification 14/2020-CT (Rule 48(4) IRN threshold).
-  - **Forms**: GSTR-2B Table 4(B) ineligible ITC schema, GSTR-3B Table 4 ITC reversal schema, RCM self-invoice voucher, LUT Form GST RFND-11 export declaration.
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5**.
-  - **Section 16(2) 4-Condition Invariant Gate**: Concurrently verifies tax invoice possession, physical GRN receipt, GSTR-2B reflection, and supplier tax remittance.
-  - **180-Day Rule Reversal**: Calculates mandatory ITC reversals for invoices unpaid past 180 days with exact 18% annual interest under Section 50.
-  - **Rule 48(4) IRN Hash Validation**: Real-time e-invoicing authentication with automated exemptions for Special Economic Zone (SEZ) units.
-  - **Rule 89(5) Inverted Duty Structure (IDS)**: Mathematical refund computation formula on inputs vs. output supplies.
-
----
-
-### 4. International Tax, FX Revaluation & Transfer Pricing
-* **Public Starter Seed**:
-  - Reaches **Level 3** (with Level 5 Deterministic Calculators for Transfer Pricing ALP Rule 10CA and Ind AS 21/109 FX revaluation).
-  - **Provisions**: Section 195 cross-border payments, Ind AS 21 & 109 foreign exchange revaluation & hedge reserves, Transfer Pricing Section 92C & Rule 10CA range concept, US IRC §§ 901 & 904 Foreign Tax Credit.
-  - **Forms**: Form 15CA/15CB checklist, Form 3CEB transfer pricing report schema, Form 67 foreign tax credit statement, Ind AS 109 hedge reserve schedule, IRS Schedule K-3.
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5** (Full Corporate Financial Reporting & Ind AS Framework).
-  - **Ind AS 115 (Revenue from Contracts with Customers)**:
-    - 5-step revenue recognition model.
-    - Variable consideration constraint (recognition capped at highly probable non-reversal).
-    - Significant financing component discounting ($>1\text{ year}$).
-    - Relative Standalone Selling Price (SSP) allocation hierarchy.
-  - **Ind AS 116 (Leases)**:
-    - Right-of-Use (ROU) asset and Lease Liability discounting at incremental borrowing rate.
-    - Low-value asset ($<\$5,000$) and short-term ($<12\text{ months}$) exemption handling.
-    - Lease modification vs. reassessment state transitions.
-  - **Ind AS 103 (Business Combinations)**:
-    - Acquisition method and Purchase Price Allocation (PPA).
-    - Goodwill vs. Capital Reserve computation; Non-Controlling Interest (NCI) fair value measurement.
-  - **Ind AS 109 (Financial Instruments)**:
-    - Solely Payments of Principal and Interest (SPPI) contractual cash flow test.
-    - Classification into Amortised Cost, FVTOCI, or FVTPL.
-    - 3-Stage Expected Credit Loss (ECL) impairment modeling.
-  - **Ind AS 12 (Income Taxes)**:
-    - Balance sheet temporary difference method for Deferred Tax Assets (DTA) and Deferred Tax Liabilities (DTL).
-
----
-
-### 5. Corporate Governance & Companies Act, 2013
-* **Public Starter Seed**:
-  - [Not seeded in starter package]
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5**.
-  - **Section 188 (Related Party Transactions)**:
-    - Arm's length ordinary course of business evaluation.
-    - Audit Committee prior approval, Board consent, and public shareholder ordinary resolution (exceeding 10% consolidated turnover or ₹1,000 Crore).
-    - Related party voting exclusion enforcement.
-  - **Section 180(1)(c) (Borrowing Limits)**:
-    - Mathematical cap: Paid-up Capital + Free Reserves + Securities Premium.
-  - **Section 185 & 186 (Loans & Investments)**:
-    - 60% of paid-up capital/free reserves or 100% of free reserves statutory limits.
-  - **Section 68 (Share Buybacks)**:
-    - 25% net worth cap and mandatory $\le 2:1$ post-buyback debt-to-equity ratio test.
-
----
-
-### 6. Capital Markets & Listing Obligations (SEBI LODR)
-* **Public Starter Seed**:
-  - [Not seeded in starter package]
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5**.
-  - **Regulation 30 (Materiality Triad)**:
-    - Deterministic numerical threshold: lowest of:
-      1. $2\%$ of consolidated annual turnover
-      2. $2\%$ of consolidated net worth
-      3. $50\%$ of 3-year average absolute Profit After Tax (PAT)
-  - **24-Hour Stock Exchange Disclosure Clock**:
-    - Evaluates unexpected tax demands, vendor litigations, or regulatory notices against the triad threshold and triggers mandatory 24-hour disclosure alarms.
-  - **Regulation 23 (Listed RPTs)**:
-    - Mandatory prior Audit Committee approval with strict disqualification of all related parties from voting.
-
----
-
-### 7. Cross-Border & Foreign Exchange Management (FEMA)
-* **Public Starter Seed**:
-  - Reaches **Level 3**.
-  - **Provisions**: US Internal Revenue Code §§ 901 & 904 Foreign Tax Credit limitation baskets (General vs. Passive Category).
-  - **Forms**: Indian Form 67 (Rule 128 statement) and US IRS Form 1065 Schedule K-3 dual-reporting schema.
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5**.
-  - **Supreme Court Jurisprudence**: *Engineering Analysis Centre of Excellence (2021)* classification: automated SaaS and off-the-shelf cloud infrastructure qualify as "Business Profits" under DTAA Article 7 (0% withholding if No Permanent Establishment).
-  - **Form 15CA / 15CB vs. Form 145 / 146**: Automated routing based on remittance thresholds and AO orders under Income-tax Act, 2025.
-  - **Treaty Conditionality**: Validates Tax Residency Certificates (TRC), No-PE declarations, and electronic Form 10F filings.
-
----
-
-### 8. Corporate Mergers, Acquisitions & Successor Liability
-* **Public Starter Seed**:
-  - Reaches **Level 3**.
-  - **Provisions**: Section 50B (Capital gains on slump sale of undertakings).
-  - **Invariants**: Depreciable assets valued at WDV u/s 43(6); revaluations ignored; indexation benefit unavailable u/s 50B(2).
-  - **Circulars**: CBDT Notification 68/2021 (Rule 11UAE Fair Market Value formula: $\max(\text{FMV}_1, \text{FMV}_2)$); CBIC Notification 12/2017 Entry 2 (0% GST going concern exemption).
-  - **Forms**: Form 3CEA Chartered Accountant audit report schema; Section 281 & Section 313 tax due diligence checklist.
-* **Full Enterprise Engine (Adesha Runtime)**:
-  - Reaches **Level 5**.
-  - **Slump Sale vs. Itemized Sale (§50B / Act 2025)**:
-    - Organic undertaking test (equipment, workforce, operational leases, customer contracts).
-    - Prevents accidental collapse into itemized depreciable asset sales (§50).
-  - **Section 281 Transfer Voidability**:
-    - Intercepts pending tax proceedings and checks Assessing Officer NOC / clearance certificates.
-  - **Successor Liability (§313 & CGST §85)**:
-    - Joint and several tax liability enforcement on business transfer.
-  - **Notification 12/2017 Entry 2**:
-    - 0% GST going concern exemption verification.
-  - **MAT Credit Protection (§115JAA)**:
-    - Flags the non-transferability of seller MAT credit in asset/slump sales.
-
----
-
-## 4. Architectural Summary: Why the Split Exists
-
-1. **Lightweight Developer Gateway**: Shipping the starter seed via npm keeps package size small (~2 MB) and enables instantaneous installation for any developer or AI agent.
-2. **Deterministic Security Boundary**: Enterprise financial orchestration, banking CAS leases, and multi-tenant ledger writeback engines remain protected within the MudraForge Adesha Runtime, while declarative statutory ASTs evaluate locally via USVM (`@mudraforge/statutory/usvm`).
-3. **Continuous Expansion via Edge Sync**: New regulatory domains (Ind AS, MCA, SEBI, FEMA) are curated and verified against primary gazette notifications, official CBDT/CBIC executive circulars, and independent programmatic test fixtures, deployed to the edge, and pulled on-demand via `npx @mudraforge/statutory sync`.

package/docs/ENTERPRISE_GOVERNANCE.md

@@ -1,160 +0,0 @@
-# MudraForge Adesha: Enterprise Financial Governance Runtime
-*Autonomous Execution Boundaries, Payment Authorization Leases, and Organizational Controls*
-
-> **Document Type**: Architecture & Enterprise Governance Specification  
-> **Target Audience**: Chief Financial Officers (CFOs), Heads of Finance, Enterprise Security & Risk Teams  
-> **Underlying Substrate**: MudraForge Statutory Knowledge Layer (OKF) — [`@mudraforge/statutory`](../README.md)  
-
----
-
-## 1. The Autonomous Execution Liability
-
-When modern organizations adopt AI agents for finance operations, the primary risk is not that an LLM fails to answer a question. The catastrophic risk is **uncontrolled real-world execution**:
-
-- An agent issuing duplicate vendor wires following a network timeout.
-- An agent paying an altered bank account number following an unverified vendor email.
-- An agent writing an unbalanced journal entry into the corporate general ledger.
-
-MudraForge Adesha was designed to establish an impenetrable **Execution Boundary** between generative AI assistance and real-world money movement.
-
-> **The Core Thesis of Autonomous Finance**:  
-> *The dangerous moment in finance AI isn't when the model is wrong. It's when its output becomes a payment instruction.*  
-> 
-> In marketing, an AI hallucination is a typo. In accounts payable, an unhandled bank timeout can trigger a retry that double-pays a vendor.  
-> 
-> Hardening the financial runtime for **Adesha, MudraForge's organizational AI**, our principle is simple:  
-> **Reasoning can be probabilistic, but financial execution needs deterministic boundaries.**
-
----
-
-## 2. The Three-Tier Architecture & Operational Boundaries
-
-To ensure complete clarity for developers, auditors, and enterprise clients, MudraForge establishes three distinct architectural tiers with strict operational boundaries:
-
-| Tier | Component | Repository & Distribution | Pricing & License | Operational Status |
-| :--- | :--- | :--- | :--- | :--- |
-| **Tier 1** | **Open-Source Statutory Commons** (`@mudraforge/statutory`) | Public GitHub (`mondeep0123/mudraforge-statutory`) & NPM Registry | **100% Free** (MIT License / CC BY 4.0 Data) | **`CURRENT_PRODUCTION`** (Working offline software) |
-| **Tier 2** | **Hosted Statutory API & Edge Sync** | Cloudflare Global Anycast Edge (`api.mudraforge.in`) | Best-Effort Free Beta (Metered Cloud API) | **`CURRENT_BETA`** (Edge endpoints & caching) |
-| **Tier 3** | **Commercial Adesha Runtime** | Enterprise Private VPC / On-Premise Worker Deployment | Commercial Enterprise SaaS | **`PILOT_STAGE_INTERNAL`** / **`SANDBOX_VALIDATED`** |
-
-### Precise Status Classifications across Capabilities
-
-To ensure epistemic honesty and prevent conflating tested prototypes with general availability:
-
-- **`CURRENT_PRODUCTION` (Working, Publicly Inspectable Software)**:
-  - Bundled OKF statutory corpus (46 provisions across 5 legal domains).
-  - Universal Statutory Virtual Machine (USVM) declarative AST execution kernel (`@mudraforge/statutory/usvm`).
-  - Pure deterministic calculators in `src/calculators.js` (Corporate Tax, LUT Export, TP ALP, Section 79, Ind AS 21/109).
-  - Zero-network CLI (`mudraforge-statutory` doctor, crosswalk, diff, verify, browse).
-  - Cryptographic SHA-256 Merkle root integrity verifier (`npm run manifest:check`).
-  - Native AI Agent Skill (`SKILL.md`) for offline agent runtime inspection.
-
-- **`SANDBOX_VALIDATED` (Tested Under Realistic Simulation & Integration Sandboxes)**:
-  - Live Zoho Books general ledger balanced double-entry writeback (tested against sandbox and live accounts with readback).
-  - RazorpayX corporate banking sandbox payout dispatch (`SETTLEMENT_LIVE_SANDBOX`), HMAC-SHA256 webhook ingestion, and clearinghouse reversal interception.
-  - Multi-process lock contention testing verifying single-use lease acquisition across competing OS processes.
-
-- **`PILOT_STAGE_INTERNAL` / `PLANNED` (Enterprise Engagements Requiring Partner Onboarding)**:
-  - Direct host-to-host bank rail settlement (ICICI / HDFC corporate host-to-host RTGS/NEFT).
-  - Multi-region distributed lease coordination across Cloudflare Durable Objects.
-  - Hosted Model Context Protocol (MCP) server fleets and live multi-agent tool connectivity (strictly enterprise tier).
-
----
-
-## 3. The Four Pillars of Autonomous Finance Execution
-
-1. **Retrieval is Not Verification**: Finding a document or matching keywords is not legal verification. Real accounting requires validating evidence against connected systems of record (including live Zoho Books / SAP ERP readback) and authenticated tenant statutory vaults.
-2. **Safe Tools Do Not Guarantee Safe Workflows**: An AI agent can call individually safe API tools and still coordinate an unauthorized or illegal transaction. Generative models coordinate investigations; deterministic code calculates statutory taxes and enforces ledger invariants (*Rule 11: Agreement with the Engine ≠ Agreement with the Law*).
-3. **Preventing Silent Financial Drift**: Deterministic code computes numbers. RFC 8785 JSON Canonicalization Scheme (JCS) and SHA-256 bind calculation results to a verifiable fingerprint. The hash does not compute—it detects changes between calculation, human authorization, and execution. If the result no longer matches the fingerprint, the workflow halts.
-4. **Testing Payment Boundaries Against Failure**: Single-use CAS leases prevent duplicate payments under concurrent races. Formal TLA+ modeling with the TLC Model Checker explored all 361 reachable states in our configured distributed model with 0 invariant violations and caught 4 injected defects.
-
----
-
-## 4. Seven-Stage End-to-End AP Governance Lifecycle
-
-Every financial transaction in MudraForge Adesha passes through seven sequential verification gates before any funds can move or any ledger can mutate:
-
-```
-Stage 1: Invoice Ingestion (IRP QR Code / PDF & Vendor Validation)
-    ↓
-Stage 2: OKF Rule Resolution (Sub-1ms Local Offline Lookup)
-    ↓
-Stage 3: Deterministic Statutory Computation (Excess Math & GST Unbundling)
-    ↓
-Stage 4: Cryptographic Payment Authorization Lease (Single-Use Atomic CAS Gate)
-    ↓
-Stage 5: Human-in-the-Loop Authority Harness (CFO Biometric Passkey / Mobile)
-    ↓
-Stage 6: Bank Rail Settlement (Host-to-Host Corporate RTGS / Sandbox Rail)
-    ↓
-Stage 7: General Ledger Balanced Double-Entry Writeback (ERP Equilibrium: ₹0.00 Discrepancy)
-```
-
-Run this audited 7-stage AP simulation directly in your local terminal:
-```bash
-npm run example:trace
-```
-
----
-
-## 5. Cryptographic Single-Use Payment Authorization Leases
-
-In Adesha, banking adapters (such as RazorpayX, Mercury, or host-to-host SFTP connections) operate within a **Zero-Trust Execution Boundary**.
-
-An adapter cannot release funds based on an API parameter or natural language prompt. To disburse a wire, an execution path must present an active, unconsumed **Payment Authorization Lease**.
-
-### Seven-Fold Parameter Binding
-A payment lease is cryptographically bound to seven immutable parameters:
-1. **Beneficiary Legal Name**: The verified corporate entity name of the vendor.
-2. **Account Number Hash**: SHA-256 digest of the beneficiary bank account.
-3. **IFSC Routing Code**: Verified branch routing code.
-4. **Net Wire Amount**: Exact disbursement amount (paisa-level precision).
-5. **Canonical Result Fingerprint**: SHA-256 hash of the canonical financial record.
-6. **Source Document Hash**: Binary SHA-256 digest of the underlying tax invoice.
-7. **Maker-Checker Clearance**: Digital approval token issued by an authorized human officer.
-
-```
-┌────────────────────────────────────────────────────────────────────────┐
-│                   SINGLE-USE PAYMENT AUTHORIZATION LEASE               │
-├────────────────────────────────────────────────────────────────────────┤
-│ • Status: AUTHORIZED ──► CONSUMED (via Atomic CAS findAndModify)       │
-│ • Replay Protection: Second attempt immediately fails with             │
-│   LEASE_ALREADY_CONSUMED                                               │
-│ • Time-to-Live (TTL): 5-minute execution window                        │
-└────────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 6. Presentation Consistency Lock & Automated Prose Auditor
-
-Generative language models regularly drop trailing zeros or swap figures when drafting summaries for human reviewers. 
-
-Adesha enforces a **Presentation Consistency Lock**:
-- Before a payment lease can be issued, an automated discrepancy auditor compares the AI-generated prose against the cryptographically sealed canonical result.
-- **Tolerances**:
-  - Currency Variance: $> ₹1.00$ triggers an immediate fail-closed halt.
-  - Statutory Section Citations: Mismatches (e.g. citing Section 206C(1H) when 194Q applies) are flagged and blocked.
-  - Foreign Remittance Confabulation: Domestic vendors cannot have foreign remittance holds hallucinated upon them.
-
----
-
-## 7. OpenSSF Packaging vs. Full Security Assurance
-
-In accordance with OpenSSF (Open Source Security Foundation) npm best practices:
-- **Packaging Hygiene**: Zero runtime dependencies, offline-first execution, and `.npmrc` with `ignore-scripts=true` neutralize install-time supply chain attacks.
-- **Cryptographic Non-Tampering**: SHA-256 Merkle root manifests certify byte-level distribution fidelity.
-- **Epistemic Honesty**: These packaging strengths do not replace independent legal counsel, statutory audit certification, or runtime multi-region crash testing. Organizations must evaluate autonomous finance systems against end-to-end integration boundaries.
-
----
-
-## 8. Commercial Engagement & Enterprise Pilots
-
-The full Adesha Autonomous Governance Runtime is delivered as a managed enterprise deployment integrated with your corporate ERP (Zoho Books, SAP S/4HANA, NetSuite) and banking partners.
-
-To evaluate Adesha in read-only shadow mode against historical accounts payable records, review the [Supervised Shadow Pilot Evaluation Guide](./PILOT_EVALUATION_GUIDE.md).
-
-For enterprise architecture discussions, pilot deployments, or API keys:
-- **Email**: [hello@mudraforge.in](mailto:hello@mudraforge.in) or [support@mudraforge.in](mailto:support@mudraforge.in)
-- **Direct Founder Contact**: Mondeep Engti at [mondeepe@gmail.com](mailto:mondeepe@gmail.com)
-- **Website**: [mudraforge.in](https://mudraforge.in)