@mudraforge/statutory 2.4.0 → 2.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +41 -1
  2. package/package.json +5 -1
  3. package/src/index.js +1 -1
package/README.md CHANGED
@@ -15,7 +15,7 @@
15
15
 
16
16
  | Item | Value |
17
17
  |---|---|
18
- | **Package Release** | **`v2.4.0`** (Public Beta) |
18
+ | **Package Release** | **`v2.4.1`** (Public Beta) |
19
19
  | **Knowledge Specification** | **Google Open Knowledge Format (OKF v0.2) + MudraForge Statutory Schema Extension** |
20
20
  | **Regulatory Snapshot** | **CBDT / CBIC / MCA / MSME Baseline: October 2026** |
21
21
  | **Corpus Quality Card** | 100% Citation Resolution (15/15 URLs) in [`docs/CORPUS_QUALITY.md`](./docs/CORPUS_QUALITY.md) |
@@ -31,6 +31,46 @@
31
31
 
32
32
  ---
33
33
 
34
+ ## Table of Contents
35
+
36
+ - [Quick Start (Free Tier)](#quick-start-free-tier)
37
+ - [1. Installation via npm](#1-installation-via-npm)
38
+ - [2. Initialize AI Agent Skill](#2-initialize-ai-agent-skill)
39
+ - [3. Direct Programmatic Traversal](#3-direct-programmatic-traversal-zero-dependencies-offline-first)
40
+ - [Supported Application Patterns](#supported-application-patterns)
41
+ - [1. AI Agents & LLM Tooling](#1-ai-agents--llm-tooling)
42
+ - [2. Finance Software & Accounts-Payable Workflows](#2-finance-software--accounts-payable-workflows)
43
+ - [3. Developer Tooling & Audit Verification](#3-developer-tooling--audit-verification)
44
+ - [Tier Separation: Free Commons vs. Hosted Calculation Engine](#architectural-boundaries-open-substrate-vs-hosted-edge-vs-adesha-platform)
45
+ - [Legal Domains Currently Covered](#legal-domains-currently-covered)
46
+ - [Structured OKF Directory Hierarchy](#structured-okf-domain-hierarchy-zero-token-discovery)
47
+ - [Canonical Edge Synchronization](#canonical-edge-synchronization-full-statutory-universe)
48
+ - [Enterprise Tier (Paid Cloud Execution)](#enterprise-tier-paid-cloud-execution--analysis-mode)
49
+ - [Edge API Endpoints & Quotas](#enterprise-edge-api-endpoints--quotas)
50
+ - [Error Semantics & Response Codes](#error-semantics--response-codes)
51
+ - [System Origin & Validation Baseline](#system-origin--validation-baseline)
52
+ - [The Payment Instruction Boundary & End-to-End AP Architecture](#the-payment-instruction-boundary--end-to-end-ap-architecture)
53
+
54
+ ---
55
+
56
+ ## Supported Application Patterns
57
+
58
+ `@mudraforge/statutory` serves as an authoritative reference layer and computation client across three distinct environments:
59
+
60
+ ### 1. AI Agents & LLM Tooling
61
+ - **Current Implementation**: Generates a self-contained [`SKILL.md`](./SKILL.md) skill definition (`npx @mudraforge/statutory init-skill`) that connects agent runtimes directly to the local filesystem without external API calls or token bloat from search queries.
62
+ - **Integration Boundary**: Agents can read structured section definitions (`okf/**/section.json`) to discover rates, thresholds, and return filing schemas deterministically rather than relying on model parameter memory.
63
+
64
+ ### 2. Finance Software & Accounts-Payable Workflows
65
+ - **Current Implementation**: Provides offline threshold logic (such as Section 194Q cumulative purchases exceeding ₹50 Lakhs) and legislative sunsets (Section 206C(1H) omission on 1 April 2025). The hosted enterprise tier provides deterministic calculation via `client.calculate()`.
66
+ - **Integration Boundary**: Custom accounting engines or enterprise middleware can invoke these functions via Node.js or REST endpoints. *(Note: This package exposes standard programmatic and JSON interfaces; it does not ship pre-packaged ERP plugins for third-party platforms).*
67
+
68
+ ### 3. Developer Tooling & Audit Verification
69
+ - **Current Implementation**: CLI commands (`browse`, `lookup`, `list`, `check-update`) allow developers and tax compliance teams to inspect verified primary citations, download statutory checklists (such as Form 3CEA slump sale audit requirements), and verify dual-act forward crosswalks between the 1961 and 2025 Income-tax Acts.
70
+ - **Integration Boundary**: Usable standalone in terminal environments, continuous integration (CI) compliance checks, or custom tax tooling.
71
+
72
+ ---
73
+
34
74
  ## The Payment Instruction Boundary & End-to-End AP Architecture
35
75
 
36
76
  > **The Dangerous Moment in Finance AI**:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mudraforge/statutory",
3
- "version": "2.4.0",
3
+ "version": "2.4.1",
4
4
  "description": "Open Knowledge Format (OKF) client & AI Agent Skill for Indian and cross-border statutory tax provisions. Zero dependencies.",
5
5
  "type": "module",
6
6
  "main": "src/index.js",
@@ -38,6 +38,10 @@
38
38
  "type": "git",
39
39
  "url": "https://github.com/mondeep0123/mudraforge-statutory.git"
40
40
  },
41
+ "homepage": "https://mudraforge.in/docs",
42
+ "bugs": {
43
+ "url": "https://github.com/mondeep0123/mudraforge-statutory/issues"
44
+ },
41
45
  "keywords": [
42
46
  "tax",
43
47
  "india",
package/src/index.js CHANGED
@@ -17,7 +17,7 @@ const __filename = fileURLToPath(import.meta.url);
17
17
  const __dirname = path.dirname(__filename);
18
18
  export const DEFAULT_LOCAL_OKF_DIR = path.resolve(__dirname, '..', 'okf');
19
19
  export const DEFAULT_BASE_URL = 'https://api.mudraforge.in';
20
- export const STATUTORY_CLIENT_VERSION = '2.4.0';
20
+ export const STATUTORY_CLIENT_VERSION = '2.4.1';
21
21
 
22
22
  /**
23
23
  * Pinned official release Merkle root digests.