@mudraforge/statutory 2.6.0 → 2.8.0

package/bin/cli.js

@@ -18,6 +18,11 @@ import {
     getLocalManifest,
     checkForPackageUpdate,
     decodeTaxIdentifier,
+    verifyLocalSubstrate,
+    runStatutoryDoctor,
+    crosswalkStatute,
+    getStatutoryDiff,
+    STATUTORY_EXIT_CODES,
     STATUTORY_CLIENT_VERSION,
     DEFAULT_LOCAL_OKF_DIR
 } from '../src/index.js';
@@ -25,11 +30,65 @@ import {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-const args = process.argv.slice(2);
+const rawArgs = process.argv.slice(2);
+const isJsonMode = rawArgs.includes('--json') || rawArgs.includes('-j');
+const isOfflineMode = rawArgs.includes('--offline') || rawArgs.includes('-o');
+const args = rawArgs.filter(a => a !== '--json' && a !== '-j' && a !== '--offline' && a !== '-o');
 const command = args[0] ? args[0].toLowerCase() : 'help';
 
+function getNamedArg(nameList, argList) {
+    for (let i = 0; i < argList.length; i++) {
+        const item = argList[i];
+        for (const name of nameList) {
+            if (item === name && i + 1 < argList.length && !argList[i + 1].startsWith('-')) {
+                return argList[i + 1];
+            }
+            if (item.startsWith(`${name}=`)) {
+                return item.slice(name.length + 1);
+            }
+        }
+    }
+    return null;
+}
+
 async function main() {
     switch (command) {
+        case 'doctor':
+        case 'diagnose':
+            await handleDoctor();
+            break;
+
+        case 'verify':
+        case 'audit':
+        case 'check':
+            await handleVerify(args[1]);
+            break;
+
+        case 'crosswalk':
+        case 'bridge':
+        case 'transition': {
+            const section = (args[1] && !args[1].startsWith('-')) ? args[1] : getNamedArg(['--section', '-s'], rawArgs);
+            const creditDate = getNamedArg(['--credit', '-c'], rawArgs);
+            const paymentDate = getNamedArg(['--payment', '-p'], rawArgs);
+            const asOfDate = getNamedArg(['--date', '-d', '--as-of'], rawArgs);
+            if (!section) {
+                console.error('[ERROR] Please specify a section to crosswalk, e.g. npx @mudraforge/statutory crosswalk 194Q --credit 2026-03-25 --payment 2026-04-10');
+                process.exit(STATUTORY_EXIT_CODES.USAGE_ERROR);
+            }
+            await handleCrosswalk(section, { creditDate, paymentDate, asOfDate });
+            break;
+        }
+
+        case 'diff':
+        case 'changelog':
+        case 'amendments': {
+            const section = (args[1] && !args[1].startsWith('-')) ? args[1] : getNamedArg(['--section', '-s'], rawArgs);
+            const since = getNamedArg(['--since'], rawArgs);
+            const domain = getNamedArg(['--domain'], rawArgs);
+            await handleDiff({ section, since, domain });
+            break;
+        }
+
         case 'init-skill':
         case 'install-skill':
             await handleInitSkill(args[1]);
@@ -43,9 +102,16 @@ async function main() {
 
         case 'sync':
         case 'pull':
-        case 'update':
-            await handleSync(args[1]);
+        case 'update': {
+            let target = args[1];
+            if (target === '--dest' || target === '-d') {
+                target = args[2];
+            } else if (target && target.startsWith('--dest=')) {
+                target = target.slice(7);
+            }
+            await handleSync(target);
             break;
+        }
 
         case 'browse':
         case 'nav':
@@ -83,7 +149,7 @@ async function main() {
     }
 
     // Non-intrusive background npm package update notice
-    if (!['check-update', 'status', 'version'].includes(command)) {
+    if (!isJsonMode && !['check-update', 'status', 'version', 'verify', 'audit', 'check', 'crosswalk', 'bridge', 'transition', 'diff', 'changelog', 'amendments'].includes(command)) {
         try {
             const updateInfo = await checkForPackageUpdate();
             if (updateInfo && updateInfo.updateAvailable) {
@@ -96,23 +162,244 @@ async function main() {
     }
 }
 
+async function handleVerify(targetDir) {
+    try {
+        let dest = DEFAULT_LOCAL_OKF_DIR;
+        if (targetDir) {
+            dest = path.resolve(process.cwd(), targetDir);
+        }
+        const report = verifyLocalSubstrate(dest);
+        if (isJsonMode) {
+            console.log(JSON.stringify(report, null, 2));
+            process.exit(report.exitCode);
+        }
+
+        console.log('\n===========================================================================');
+        console.log(`MUDRAFORGE OPEN KNOWLEDGE FORMAT (OKF) — CRYPTOGRAPHIC VERIFIER [v${report.okfVersion || 'Unknown'}]`);
+        console.log('===========================================================================');
+
+        if (report.integrity.valid) {
+            console.log(`[OK] Integrity: ${report.integrity.totalFilesChecked} files verified against Merkle manifest.`);
+            console.log(`     Root Merkle Hash: ${report.integrity.computedRoot}`);
+        } else {
+            console.error(`[FAIL] Integrity: Mismatches: ${report.integrity.mismatches.length}, Missing: ${report.integrity.missingFiles.length}, Untracked: ${report.integrity.untrackedFiles.length}`);
+            for (const m of report.integrity.mismatches) {
+                console.error(`     • ${m.file} (Expected ${m.expected.slice(0, 10)}..., actual ${m.actual.slice(0, 10)}...)`);
+            }
+            for (const mf of report.integrity.missingFiles) {
+                console.error(`     • Missing: ${mf}`);
+            }
+        }
+
+        if (report.authenticity.valid) {
+            console.log(`[OK] Authenticity: Provenance authenticated via ${report.authenticity.method}.`);
+            if (report.authenticity.keyId) {
+                console.log(`     Signer Key ID: ${report.authenticity.keyId}`);
+            }
+        } else {
+            console.error(`[FAIL] Authenticity: Root hash "${report.integrity.computedRoot}" is neither pinned nor signed by an authorized MudraForge trust anchor.`);
+        }
+
+        if (report.baselineCheck.valid) {
+            console.log(`[OK] Statutory Policy: All mandatory baseline provisions present (${report.baselineCheck.baselineSections.join(', ')}).`);
+        } else {
+            console.error(`[FAIL] Statutory Policy: Missing mandatory baseline provisions: ${report.baselineCheck.missingBaseline.join(', ')}`);
+        }
+
+        console.log('───────────────────────────────────────────────────────────────────────────');
+        if (report.valid) {
+            console.log(`[PASS] Statutory substrate is authentic, intact, and compliant (Exit ${report.exitCode}).\n`);
+        } else {
+            console.error(`[FAIL] Verification failed with Exit Code ${report.exitCode}.\n`);
+        }
+        process.exit(report.exitCode);
+    } catch (err) {
+        if (isJsonMode) {
+            console.log(JSON.stringify({ valid: false, exitCode: STATUTORY_EXIT_CODES.USAGE_ERROR, error: err.message }, null, 2));
+        } else {
+            console.error(`[ERROR] Verification error: ${err.message}`);
+        }
+        process.exit(STATUTORY_EXIT_CODES.USAGE_ERROR);
+    }
+}
+
+async function handleDoctor() {
+    try {
+        const report = await runStatutoryDoctor({ offline: isOfflineMode });
+        if (isJsonMode) {
+            console.log(JSON.stringify(report, null, 2));
+            process.exit(report.exitCode);
+        }
+
+        console.log('\n===========================================================================');
+        console.log(`MUDRAFORGE STATUTORY DIAGNOSTIC DOCTOR [v${report.clientVersion}]`);
+        console.log('===========================================================================');
+
+        console.log('── 1. RUNTIME & HOST ENVIRONMENT ──');
+        console.log(`Node.js:           ${report.runtime.nodeVersion} ${report.runtime.isSupportedNode ? '(Supported: v18+)' : '[UNSUPPORTED]'}`);
+        console.log(`Platform:          ${report.runtime.platform} (${report.runtime.arch})`);
+        console.log(`Environment:       ${report.runtime.environment}${report.runtime.isCI ? ' (CI Active)' : ''}`);
+        console.log(`API Key Config:    ${report.runtime.hasApiKey ? 'CONFIGURED (Enterprise Tier Enabled)' : 'NOT_CONFIGURED (Free Commons Mode)'}`);
+
+        console.log('\n── 2. LOCAL OKF SUBSTRATE HEALTH ──');
+        if (report.substrate.valid) {
+            console.log(`Directory:         ${DEFAULT_LOCAL_OKF_DIR}`);
+            console.log(`Manifest Version:  v${report.substrate.okfVersion} (Published: ${report.substrate.publishedAt})`);
+            console.log(`Files Checked:     ${report.substrate.integrity.totalFilesChecked} (0 mismatches, 0 missing, 0 untracked)`);
+            console.log(`Root Merkle Hash:  ${report.substrate.integrity.computedRoot}`);
+            console.log(`Integrity:         PASS`);
+            console.log(`Provenance:        AUTHENTIC (${report.substrate.authenticity.method})`);
+            console.log(`Statutory Policy:  PASS (All ${report.substrate.baselineCheck.baselineSections.length} mandatory baselines present)`);
+        } else {
+            console.error(`Substrate:         FAILED (Exit Code ${report.substrate.exitCode})`);
+            if (report.substrate.error) console.error(`Error:             ${report.substrate.error}`);
+            if (!report.substrate.integrity.valid) {
+                console.error(`Integrity Failure: ${report.substrate.integrity.mismatches.length} mismatch(es), ${report.substrate.integrity.missingFiles.length} missing files.`);
+            }
+            if (!report.substrate.authenticity.valid) {
+                console.error(`Authenticity:      Root hash not authenticated.`);
+            }
+            if (!report.substrate.baselineCheck.valid) {
+                console.error(`Missing Baselines: ${report.substrate.baselineCheck.missingBaseline.join(', ')}`);
+            }
+        }
+
+        console.log('\n── 3. CLOUDFLARE ANYCAST EDGE CONNECTIVITY ──');
+        console.log(`Endpoint:          ${report.edge.baseUrl}`);
+        if (report.edge.status === 'REACHABLE') {
+            console.log(`Status:            REACHABLE (Latency: ${report.edge.latencyMs}ms)`);
+        } else if (report.edge.status === 'SKIPPED_AIR_GAPPED') {
+            console.log(`Status:            SKIPPED (Air-Gapped / Offline Flag Enabled)`);
+        } else {
+            console.log(`Status:            ${report.edge.status} (Offline-first local mode operative)`);
+        }
+        console.log(`Advisory:          ${report.edge.advisory}`);
+
+        console.log('───────────────────────────────────────────────────────────────────────────');
+        if (report.healthy) {
+            console.log(`[PASS] All diagnostic checks passed with zero defects (Exit 0).\n`);
+        } else {
+            console.error(`[FAIL] Diagnostic doctor flagged health violations (Exit ${report.exitCode}).\n`);
+        }
+        process.exit(report.exitCode);
+    } catch (err) {
+        if (isJsonMode) {
+            console.log(JSON.stringify({ healthy: false, exitCode: STATUTORY_EXIT_CODES.USAGE_ERROR, error: err.message }, null, 2));
+        } else {
+            console.error(`[ERROR] Doctor diagnostic error: ${err.message}`);
+        }
+        process.exit(STATUTORY_EXIT_CODES.USAGE_ERROR);
+    }
+}
+
+async function handleCrosswalk(section, options) {
+    try {
+        const result = crosswalkStatute(section, options);
+        if (isJsonMode) {
+            console.log(JSON.stringify(result, null, 2));
+            process.exit(0);
+        }
+
+        console.log('\n===========================================================================');
+        console.log('MUDRAFORGE DUAL-ACT STATUTORY CROSSWALK (1961 ACT <-> 2025 ACT)');
+        console.log('===========================================================================');
+        console.log(`Query Section:       ${result.querySection}`);
+        console.log(`Governing Statute:   ${result.governingAct}`);
+        console.log(`Applicable Section:  ${result.applicableSection}`);
+        console.log(`Temporal Status:     ${result.temporalStatus}`);
+
+        console.log('\n── TEMPORAL CRYSTALLIZATION (EARLIER OF CREDIT OR PAYMENT) ──');
+        if (result.creditDate) console.log(`Credit in Books:     ${result.creditDate}`);
+        if (result.paymentDate) console.log(`Payment Rail:        ${result.paymentDate}`);
+        console.log(`Trigger Date:        ${result.triggerDate}`);
+        console.log(`Trigger Event:       ${result.triggerReason}`);
+        console.log(`Event Context:       ${result.triggerDescription}`);
+
+        console.log('\n── STATUTORY BRIDGE & DUAL-ACT MAPPING ──');
+        console.log(`Predecessor (1961):  ${result.crosswalk.predecessor.statutorySection} (${result.crosswalk.predecessor.title})`);
+        console.log(`                     Rate: ${result.crosswalk.predecessor.standardRate} | Challan: ${result.crosswalk.predecessor.challan} | Return: ${result.crosswalk.predecessor.returnForm}`);
+        console.log(`Successor (2025):    ${result.crosswalk.successor.statutorySection} (Effective ${result.crosswalk.successor.effectiveDate})`);
+        console.log(`                     Rate: ${result.crosswalk.successor.standardRate} | Return: ${result.crosswalk.successor.returnForm}`);
+
+        console.log('\n── STATUTORY SAVINGS & LEGAL GROUNDING ──');
+        console.log(`Primary Authority:   ${result.crosswalk.savingsAuthority.statute}`);
+        console.log(`Subsidiary Principle: ${result.crosswalk.savingsAuthority.subsidiary}`);
+        console.log(`Legal Analysis:      ${result.legalAnalysis}`);
+
+        console.log('───────────────────────────────────────────────────────────────────────────');
+        console.log('[PASS] Statutory crosswalk resolved successfully (Exit 0).\n');
+        process.exit(0);
+    } catch (err) {
+        if (isJsonMode) {
+            console.log(JSON.stringify({ status: 'ERROR', exitCode: STATUTORY_EXIT_CODES.USAGE_ERROR, error: err.message }, null, 2));
+        } else {
+            console.error(`[ERROR] Crosswalk failure: ${err.message}`);
+        }
+        process.exit(STATUTORY_EXIT_CODES.USAGE_ERROR);
+    }
+}
+
+async function handleDiff(options) {
+    try {
+        const result = getStatutoryDiff(options);
+        if (isJsonMode) {
+            console.log(JSON.stringify(result, null, 2));
+            process.exit(0);
+        }
+
+        console.log('\n===========================================================================');
+        console.log('MUDRAFORGE STATUTORY REGULATORY CHANGELOG & AMENDMENT TRACKER');
+        console.log('===========================================================================');
+        console.log(`Filter Section:      ${result.filterSection || 'ALL SECTIONS'}`);
+        console.log(`Filter Since:        ${result.filterSince || 'ALL TIME'}`);
+        console.log(`Filter Domain:       ${result.filterDomain || 'ALL DOMAINS'}`);
+        console.log(`Total Amendments:    ${result.totalAmendments}`);
+
+        if (result.amendments.length === 0) {
+            console.log('\n[NOTICE] No statutory amendments matched the specified query filters.');
+        } else {
+            for (const am of result.amendments) {
+                console.log(`\n── [${am.id}] ${am.sectionCode} (${am.domain}) ──`);
+                console.log(`Title:               ${am.title}`);
+                console.log(`Effective Date:      ${am.effectiveDate} (${am.amendmentType})`);
+                console.log(`Governing Statute:   ${am.statute}`);
+                console.log(`Enacted By:          ${am.legalAuthority}`);
+                console.log(`Previous Baseline:   ${am.previousValue}`);
+                console.log(`Amended Baseline:    ${am.amendedValue}`);
+                console.log(`Summary:             ${am.changeSummary}`);
+                console.log(`Statutory Impact:    ${am.statutoryImpact}`);
+            }
+        }
+
+        console.log('───────────────────────────────────────────────────────────────────────────');
+        console.log(`[PASS] Statutory diff completed successfully (${result.totalAmendments} amendment(s) found) (Exit 0).\n`);
+        process.exit(0);
+    } catch (err) {
+        if (isJsonMode) {
+            console.log(JSON.stringify({ status: 'ERROR', exitCode: STATUTORY_EXIT_CODES.USAGE_ERROR, error: err.message }, null, 2));
+        } else {
+            console.error(`[ERROR] Statutory diff failure: ${err.message}`);
+        }
+        process.exit(STATUTORY_EXIT_CODES.USAGE_ERROR);
+    }
+}
+
 async function handleCheckUpdate() {
     try {
-        console.log('\n[INFO] Checking npm package version against registry.npmjs.org...');
+        let pkgUpdate = null;
         try {
-            const pkgUpdate = await checkForPackageUpdate({ cacheTtlMs: 0 });
-            if (pkgUpdate && pkgUpdate.updateAvailable) {
-                console.log('───────────────────────────────────────────────────────────────────────────');
-                console.log(`[WARN] New npm package version available: v${pkgUpdate.latestVersion} (installed: v${pkgUpdate.currentVersion})`);
-                console.log(`Run: npm install @mudraforge/statutory@latest`);
-                console.log('───────────────────────────────────────────────────────────────────────────');
-            } else if (pkgUpdate) {
-                console.log(`[OK] npm package code is up to date (v${pkgUpdate.currentVersion}).`);
-            }
+            pkgUpdate = await checkForPackageUpdate({ cacheTtlMs: 0 });
         } catch (_) {}
 
-        console.log('\n[INFO] Checking OKF knowledge substrate status against Cloudflare edge...');
         const status = await checkUpdates();
+
+        if (isJsonMode) {
+            console.log(JSON.stringify({
+                packageUpdate: pkgUpdate,
+                substrateStatus: status
+            }, null, 2));
+            process.exit(0);
+        }
         console.log('───────────────────────────────────────────────────────────────────────────');
         console.log(`Local OKF Version:   ${status.localVersion}`);
         console.log(`Latest Edge Version: ${status.latestVersion}`);
@@ -179,6 +466,18 @@ async function handleSync(targetDir) {
 async function handleBrowse() {
     const manifest = getLocalManifest();
 
+    if (isJsonMode) {
+        console.log(JSON.stringify(manifest ? {
+            okfVersion: manifest.okfVersion,
+            publishedAt: manifest.publishedAt,
+            rootHash: manifest.rootHash,
+            totalSections: manifest.totalSections,
+            domains: manifest.domains,
+            sections: manifest.sections
+        } : { okfVersion: null, sections: [] }, null, 2));
+        process.exit(0);
+    }
+
     console.log('\n===========================================================================');
     console.log(`OPEN KNOWLEDGE FORMAT (OKF) — LOCAL BROWSER [v${manifest ? manifest.okfVersion : 'Local'}]`);
     console.log('===========================================================================');
@@ -276,18 +575,28 @@ async function handleLookup(section, asOfDate) {
         let temporalStatus = 'ACTIVE';
 
         if (s) {
-            console.log(`\n[LOCAL OKF CACHE] Loaded section [${cleanSection}] from disk.`);
+            if (!isJsonMode) console.log(`\n[LOCAL OKF CACHE] Loaded section [${cleanSection}] from disk.`);
             if (asOfDate) {
                 if (asOfDate < s.effectivePeriod.validFrom) temporalStatus = 'PRE_EFFECTIVE';
                 else if (s.effectivePeriod.validTo && asOfDate > s.effectivePeriod.validTo) temporalStatus = 'SUNSET_SUPERSEDED';
             }
         } else {
-            console.log(`\n[EDGE LOOKUP] Querying MudraForge Live Commons for [${cleanSection}]${asOfDate ? ` (as-of: ${asOfDate})` : ''}...`);
+            if (!isJsonMode) console.log(`\n[EDGE LOOKUP] Querying MudraForge Live Commons for [${cleanSection}]${asOfDate ? ` (as-of: ${asOfDate})` : ''}...`);
             const remote = await lookupStatute(cleanSection, { asOfDate });
             s = remote.statute;
             temporalStatus = remote.temporalStatus;
         }
 
+        if (isJsonMode) {
+            console.log(JSON.stringify({
+                status: 'SUCCESS',
+                sectionCode: cleanSection,
+                temporalStatus,
+                statute: s
+            }, null, 2));
+            process.exit(0);
+        }
+
         console.log('───────────────────────────────────────────────────────────────────────────');
         console.log(`Section:         ${s.statutorySection} (${s.governingStatute})`);
         console.log(`Title:           ${s.title}`);
@@ -317,6 +626,14 @@ async function handleLookup(section, asOfDate) {
         }
         console.log('───────────────────────────────────────────────────────────────────────────\n');
     } catch (err) {
+        if (isJsonMode) {
+            console.error(JSON.stringify({
+                status: 'ERROR',
+                error: err.message,
+                availableSections: err.availableSections || []
+            }, null, 2));
+            process.exit(1);
+        }
         console.error(`[ERROR] Lookup failed: ${err.message}`);
         if (err.availableSections) {
             console.log(`Available sections: ${err.availableSections.join(', ')}`);
@@ -327,8 +644,13 @@ async function handleLookup(section, asOfDate) {
 
 async function handleList() {
     try {
-        console.log('\n[INFO] Fetching indexed statutory sections from MudraForge Commons...');
         const sections = await listSections();
+        if (isJsonMode) {
+            console.log(JSON.stringify({ sections, total: sections.length }, null, 2));
+            process.exit(0);
+        }
+
+        console.log('\n[INFO] Fetching indexed statutory sections from MudraForge Commons...');
         console.log('───────────────────────────────────────────────────────────────────────────');
         for (const s of sections) {
             const displayValidTo = (s.validTo === 'OPEN_ENDED' || s.validTo === '2099-12-31') ? 'In Force' : s.validTo;
@@ -336,6 +658,10 @@ async function handleList() {
         }
         console.log('───────────────────────────────────────────────────────────────────────────\n');
     } catch (err) {
+        if (isJsonMode) {
+            console.error(JSON.stringify({ status: 'ERROR', error: err.message }, null, 2));
+            process.exit(1);
+        }
         console.error(`[ERROR] Failed to list sections: ${err.message}`);
         process.exit(1);
     }
@@ -343,6 +669,11 @@ async function handleList() {
 
 function handleDecodeId(rawId) {
     const res = decodeTaxIdentifier(rawId);
+    if (isJsonMode) {
+        console.log(JSON.stringify(res, null, 2));
+        process.exit(res.isValid ? 0 : 1);
+    }
+
     console.log('\n===========================================================================');
     console.log('INDIAN TAX IDENTIFIER DECODER & OFFLINE MOD-36 VALIDATOR');
     console.log('===========================================================================');
@@ -375,6 +706,10 @@ Usage:
   npx @mudraforge/statutory <command> [options]
 
 Commands:
+  doctor [--offline]        Run full diagnostic check of runtime, substrate integrity, & edge status
+  verify [path]             Cryptographically verify OKF substrate authenticity & file integrity
+  crosswalk <section>       Dual-act 1961 <-> 2025 bridge (earlier of credit vs payment)
+  diff                      Semantic regulatory changelog (--section, --since, --domain)
   browse                    Interactively browse local OKF statutory filesystem
   lookup <section> [date]   Look up section details & temporal status (e.g. 194Q 2025-06-01)
   decode-id <pan_or_gstin>  Offline ISO Mod-36 checksum, state name, and PAN entity decoding
@@ -383,6 +718,21 @@ Commands:
   list                      List all indexed statutory sections
   init-skill [path]         Install SKILL.md into your agent workspace (defaults to .agents/skills/)
   help                      Show this help message
+
+Options:
+  --credit <YYYY-MM-DD>     Date of credit to vendor/payee account in books (used in crosswalk)
+  --payment <YYYY-MM-DD>    Date of actual payment/disbursement (used in crosswalk)
+  --since <YYYY-MM-DD>      Filter amendments taking effect on or after date (used in diff)
+  --section, -s <section>   Filter amendments by section code (used in diff)
+  --domain <domain>         Filter amendments by statutory domain (used in diff)
+  --json, -j                Emit clean, machine-parseable JSON to stdout (suppresses banners)
+  --offline, -o             Bypass outbound network checks (air-gapped / offline environment mode)
+
+Exit Code Conventions:
+  0                         Success / Verification passed
+  1                         Usage or operational error (invalid syntax / parameters)
+  2                         Cryptographic authenticity or integrity violation (mismatch/revocation)
+  3                         Statutory policy violation (e.g. missing baseline provision)
 `);
 }
 

package/docs/CORPUS_QUALITY.md

@@ -3,7 +3,7 @@
 > **Format Reference**: Inspired by Google's *Data Cards Playbook* and the OpenSSF Project Quality Standards.  
 > **Target Package**: `@mudraforge/statutory` v2.4.0  
 > **Evaluation Mode**: Machine-audited against primary sources, official gazettes, and test fixtures.  
-> **Generated Timestamp**: 2026-10-24T15:20:46.069Z
+> **Generated Timestamp**: 2026-10-25T14:51:51.929Z
 
 ---
 
@@ -11,11 +11,11 @@
 
 | Dimension | Metric | Denominator / Baseline | Coverage Rate | Status |
 | :--- | :--- | :--- | :--- | :--- |
-| **Primary Source Citations** | 30 resolvable gazette URLs | 30 total citations declared | **100.0%** | VERIFIED |
-| **Temporal Validity Bounds** | 11 sections with explicit dates | 11 total bundled sections | **100.0%** | VERIFIED |
-| **Dual-Act 2025 Transition Bridges** | 6 direct tax provisions mapped | 7 direct tax provisions | **85.7%** | VERIFIED |
-| **Attached Administrative Circulars** | 11 official circulars | 6 sections across 4 domains | **100% Attached** | VERIFIED |
-| **Attached Return/Compliance Schemas** | 14 schemas/templates | 6 sections across 4 domains | **100% Attached** | VERIFIED |
+| **Primary Source Citations** | 61 resolvable gazette URLs | 61 total citations declared | **100.0%** | VERIFIED |
+| **Temporal Validity Bounds** | 24 sections with explicit dates | 24 total bundled sections | **100.0%** | VERIFIED |
+| **Dual-Act 2025 Transition Bridges** | 8 direct tax provisions mapped | 9 direct tax provisions | **88.9%** | VERIFIED |
+| **Attached Administrative Circulars** | 25 official circulars | 6 sections across 4 domains | **100% Attached** | VERIFIED |
+| **Attached Return/Compliance Schemas** | 22 schemas/templates | 6 sections across 4 domains | **100% Attached** | VERIFIED |
 | **Cryptographic Merkle Verification** | 20 bundle files verified | SHA-256 Merkle root digest | **0 Mismatches** | VERIFIED |
 
 ---
@@ -49,16 +49,29 @@
 | Section Code | Statutory Provision | Governing Statute | Temporal Window | Status | Citations | Circulars | Forms | 2025 Act Successor |
 | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
 | **50B** | Special provision for computation of capital gains in case of slump sale | Income-tax Act, 1961 (Act No. 43 of 1961) | `2000-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 2 | 2 | Income-tax Act, 2025 (Section 78 (Capital gains on slump sale of undertakings)) |
+| **206AB** | Special provision for deduction of tax at source for non-filers of income-tax return | Income-tax Act, 1961 (Act No. 43 of 1961) | `2021-07-01` to `OPEN_ENDED` | `ACTIVE` | 1 | 1 | 0 | Income-tax Act, 2025 (Section 397(3)) |
 | **206C(1H)** | Collection of tax at source by seller on receipt of consideration for sale of goods (Omitted effective 1 April 2025) | Income-tax Act, 1961 | `2020-10-01` to `2025-03-31` | `SUNSET_SUPERSEDED` | 2 | 1 | 0 | Finance Act, 2025 (Statutory Sunset) (Section 206C(1H) Omitted) |
 | **194H** | Deduction of tax at source on commission or brokerage | Income-tax Act, 1961 (Act No. 43 of 1961) | `2001-06-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 3 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 4, Item (i)) |
 | **194C** | Deduction of tax at source on payments to contractors and sub-contractors | Income-tax Act, 1961 (Act No. 43 of 1961) | `1972-04-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 3 | 1 | 2 | Income-tax Act, 2025 (Section 393(1), Table 3, Item (i)) |
 | **194Q** | Deduction of tax at source on payment of a certain sum for purchase of goods | Income-tax Act, 1961 (Act No. 43 of 1961) | `2021-07-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 2 | 2 | 2 | Income-tax Act, 2025 (Section 393(1), Table 8, Item (ii)) |
 | **393** | Deduction of tax at source on payment of a certain sum for purchase of goods | Income-tax Act, 2025 (Act No. 1 of 2025) | `2026-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 0 | 0 | N/A |
+| **194R** | Deduction of tax at source on benefit or perquisite in respect of business or profession | Income-tax Act, 1961 (Act No. 43 of 1961) | `2022-07-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 0 | Income-tax Act, 2025 (Section 393(1), Table 8, Item 12) |
 | **194I** | Deduction of tax at source on payment of rent | Income-tax Act, 1961 (Act No. 43 of 1961) | `1994-06-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 3 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 5, Item (i)) |
 | **194J** | Fees for professional or technical services, royalty, and non-compete fees | Income-tax Act, 1961 | `1995-07-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 2 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 6, Item (iii)) |
 | **17(5)** | Apportionment of credit and blocked input tax credits | Central Goods and Services Tax Act, 2017 (Act No. 12 of 2017) | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | CGST Act, 2017 (In force) (Section 17(5)(b)(i) & (b)(iii)) |
+| **8** | Tax liability on composite and mixed supplies and classification of bundled goods and services contracts | Central Goods and Services Tax Act, 2017 | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | N/A |
+| **10** | Composition levy and ineligible tax invoice restrictions | Central Goods and Services Tax Act, 2017 (Act No. 12 of 2017) | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 0 | N/A |
+| **34** | Credit and debit notes statutory adjustments and return filing deadlines | Central Goods and Services Tax Act, 2017 (Act No. 12 of 2017) | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 0 | N/A |
+| **RULE-48(4)** | Mandatory electronic invoicing (E-Invoicing), IRN generation, and invoice validity | Central Goods and Services Tax Rules, 2017 | `2020-10-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 0 | N/A |
+| **51** | Tax deduction at source under Goods and Services Tax | Central Goods and Services Tax Act, 2017 (Act No. 12 of 2017) | `2018-10-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 0 | N/A |
+| **16(2)** | Eligibility and conditions for taking input tax credit and mandatory 180-day payment rule | Central Goods and Services Tax Act, 2017 (Act No. 12 of 2017) | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 4 | 1 | 1 | CGST Act, 2017 (In force) (Section 16(2), (3), (4), (5), (6)) |
+| **9(3)** | Reverse Charge Mechanism (RCM) mandatory tax liability on recipient, self-invoicing, payment voucher issuance, and electronic cash discharge | Central Goods and Services Tax Act, 2017 read with Notification No. 13/2017-Central Tax (Rate) | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | N/A |
+| **195** | Deduction of tax at source on foreign cross-border payments to non-residents, DTAA treaty benefits, documentation, Form 15CA/15CB, and cloud software exemption | Income-tax Act, 1961 read with Double Taxation Avoidance Agreements (DTAA) under Section 90 | `1962-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 2 | 1 | Income-tax Act, 2025 Section 393(2) (Section 393(2) of Income-tax Act, 2025) |
 | **IRC-901-904** | Foreign Tax Credit authorization, separate basket limitation, and partnership pass-through reporting (Form 1116 / Schedule K-3) | Internal Revenue Code of 1986 (Title 26, U.S. Code) | `2021-01-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 0 | 2 | Title 26, U.S. Code (Continuous) (26 U.S.C. §§ 901, 904(d), 904(j), 469) |
 | **MSMED-15-16** | Statutory payment timelines to Micro & Small Enterprises, compound penal interest, and income tax deduction disallowance | Micro, Small and Medium Enterprises Development Act, 2006 read with Income-tax Act, 1961 Section 43B(h) | `2006-10-02` to `OPEN_ENDED` | `ACTIVE` | 4 | 1 | 2 | Income-tax Act, 2025 Section 37(2)(g) (Section 37(2)(g) of Income-tax Act, 2025) |
+| **MSMED-SEC-7** | Composite criteria for classification of Micro, Small and Medium Enterprises, investment calculations, and statutory exclusion of export turnover | Micro, Small and Medium Enterprises Development Act, 2006 read with Ministry of MSME Notification S.O. 2119(E) | `2020-07-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | N/A |
+| **MCA-MSME-1** | Mandatory half-yearly reporting of outstanding dues exceeding 45 days to Micro & Small Enterprises (Form MSME-1) | Companies Act, 2013 read with Specified Companies (Furnishing of information about payment to micro and small enterprise suppliers) Order, 2019 | `2019-01-22` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | N/A |
+| **MSMED-SEC-22** | Mandatory statutory disclosures in annual audited financial statements regarding dues to Micro and Small Enterprises and tax non-deductibility of penal interest | Micro, Small and Medium Enterprises Development Act, 2006 read with Companies Act, 2013 Schedule III | `2006-10-02` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 2 | N/A |
 
 ---
 

package/docs/PROVENANCE.md

@@ -0,0 +1,33 @@
+# Published Release & Provenance Ledger
+
+This document records the cryptographic provenance, normative specifications, and formal assurance artifacts for `@mudraforge/statutory`.
+
+---
+
+## Release Baseline Ledger
+
+| Item | Value |
+|---|---|
+| **Package Release** | **`v2.8.0`** (Stable Minor Release) |
+| **Knowledge Specification** | **Google Open Knowledge Format (OKF v0.2) + MudraForge Statutory Schema Extension** |
+| **Regulatory Snapshot** | **CBDT / CBIC / MCA / MSME Baseline: October 2026** |
+| **Corpus Quality Card** | 100% Citation Resolution (15/15 URLs) in [`docs/CORPUS_QUALITY.md`](./CORPUS_QUALITY.md) |
+| **Architecture Decision Records** | 6 Normative ADRs documented in [`docs/ARCHITECTURE_DECISIONS.md`](./ARCHITECTURE_DECISIONS.md) |
+| **Vendor Conformance Suite** | 12/12 Passing Fixture Tests in [`conformance/`](../conformance/) |
+| **End-to-End Execution Trace** | Audited 7-stage AP lifecycle in [`examples/`](../examples/) (`npm run example:trace`) |
+| **Enterprise Assurance Preview** | Formal TLA+ & mutation defenses in [`docs/ADESHA_ASSURANCE_OVERVIEW.md`](./ADESHA_ASSURANCE_OVERVIEW.md) |
+| **Integrity Root** | SHA-256 root manifest in [`okf/manifest.json`](../okf/manifest.json) (reproducible byte-level non-tampering proof) |
+| **Temporal Framework** | Dual-Act Bridge: *Income-tax Act, 1961* & *Income-tax Act, 2025* |
+| **Verification Gate** | 100% Pass across cumulative thresholds, legislative sunsets, and excess math |
+
+---
+
+## Cryptographic & Epistemic Scope
+
+The SHA-256 root hash in `okf/manifest.json` provides mathematical verification of **byte-level integrity** (ensuring local files have not been corrupted, altered, or partially written). A hash certifies that bytes match the published release; it does not by itself constitute legal or statutory authority. 
+
+Epistemic authority is established strictly via:
+1. Primary gazette citations and statutory text enacted by Parliament.
+2. Executive circulars and notifications issued by the CBDT, CBIC, MCA, and Ministry of MSME.
+3. Cryptographic Ed25519 signatures anchored to the MudraForge Root Authority.
+4. Independent legal ground-truth test suites parameterizing effective dates and cumulative turnover thresholds.

package/okf/manifest.json

@@ -1,5 +1,5 @@
 {
-  "okfVersion": "2.6.0",
+  "okfVersion": "2.8.0",
   "publishedAt": "2026-10-25T09:18:32.261Z",
   "rootHash": "sha256-ce88c2255df1c30c15bfe184c8117336ebc302c2ac5ef25e96a6957402ae11ae",
   "totalSections": 24,

package/okf.publication.json

@@ -2,7 +2,7 @@
   "$schema": "https://okf.dev/schema/v0.2/publication.json",
   "publicationId": "mudraforge-statutory-commons",
   "title": "MudraForge Statutory Knowledge Substrate (India & Cross-Border)",
-  "version": "2.4.0",
+  "version": "2.8.0",
   "lifecycle": "PUBLIC_BETA",
   "specification": "OKF-0.2",
   "publisher": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mudraforge/statutory",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Open Knowledge Format (OKF) client & AI Agent Skill for Indian and cross-border statutory tax provisions. Zero dependencies.",
   "type": "module",
   "main": "src/index.js",
@@ -33,7 +33,8 @@
     "example:trace": "node examples/simulate_end_to_end_trace.js",
     "manifest": "node scripts/generate_manifest.js",
     "manifest:check": "node scripts/generate_manifest.js --check",
-    "catalog": "node scripts/build_catalog.js"
+    "catalog": "node scripts/build_catalog.js",
+    "release": "node scripts/release.js"
   },
   "repository": {
     "type": "git",