@mudraforge/statutory 2.10.0 → 2.12.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 (95) hide show
  1. package/CHANGELOG.md +214 -0
  2. package/CONTRIBUTING.md +3 -2
  3. package/README.md +42 -39
  4. package/SECURITY.md +2 -2
  5. package/SKILL.md +1 -1
  6. package/bin/cli.js +288 -29
  7. package/docs/ACCOUNTING_ASSURANCE_AUDIT_DOSSIER.md +276 -0
  8. package/docs/ARCHITECTURE.md +14 -14
  9. package/docs/ARCHITECTURE_DECISIONS.md +3 -3
  10. package/docs/CASE_01_FORM_TEXT.txt +48 -0
  11. package/docs/CATALOG.md +877 -111
  12. package/docs/CA_PILOT_BENCHMARK_CASES.md +282 -0
  13. package/docs/CORPUS_QUALITY.md +33 -16
  14. package/docs/DATA_LICENSING.md +1 -1
  15. package/docs/DOMAIN_BREADTH_AND_DEPTH_COMPARISON.md +36 -34
  16. package/docs/OKF_MAINTENANCE_SOP.md +12 -12
  17. package/docs/PROVENANCE.md +2 -2
  18. package/docs/VERIFICATION.md +6 -6
  19. package/okf/corporate_ma_restructuring/business_combinations_indas_103/circulars/mca_notification_indas_103_business_combinations.md +41 -0
  20. package/okf/corporate_ma_restructuring/business_combinations_indas_103/forms/purchase_price_allocation_schedule.json +110 -0
  21. package/okf/corporate_ma_restructuring/business_combinations_indas_103/section.json +65 -0
  22. package/okf/corporate_ma_restructuring/impairment_of_assets_indas_36/circulars/mca_notification_indas_36_impairment.md +45 -0
  23. package/okf/corporate_ma_restructuring/impairment_of_assets_indas_36/forms/cgu_impairment_testing_register.json +53 -0
  24. package/okf/corporate_ma_restructuring/impairment_of_assets_indas_36/section.json +61 -0
  25. package/okf/corporate_ma_restructuring/share_based_payments_indas_102/circulars/icai_guidance_share_based_payments.md +37 -0
  26. package/okf/corporate_ma_restructuring/share_based_payments_indas_102/forms/esop_graded_vesting_amortization_schedule.json +49 -0
  27. package/okf/corporate_ma_restructuring/share_based_payments_indas_102/section.json +60 -0
  28. package/okf/corporate_ma_restructuring/tax_clearance_sec281/circulars/cbdt_circular_04_2011_sec281_clearance.md +57 -0
  29. package/okf/corporate_ma_restructuring/tax_clearance_sec281/forms/form_281_tax_clearance_application.json +42 -0
  30. package/okf/corporate_ma_restructuring/tax_clearance_sec281/section.json +70 -0
  31. package/okf/direct_tax/income_taxes_deferred_tax_indas_12/circulars/mca_notification_indas_12_income_taxes.md +40 -0
  32. package/okf/direct_tax/income_taxes_deferred_tax_indas_12/forms/deferred_tax_asset_liability_reconciliation_schedule.json +46 -0
  33. package/okf/direct_tax/income_taxes_deferred_tax_indas_12/section.json +61 -0
  34. package/okf/direct_tax/statutory_disallowance_43b/circulars/supreme_court_checkmate_services_2022.md +64 -0
  35. package/okf/direct_tax/statutory_disallowance_43b/forms/tax_audit_form_3cd_clause_26_schedule.json +71 -0
  36. package/okf/direct_tax/statutory_disallowance_43b/section.json +77 -0
  37. package/okf/direct_tax/tds_commission_194h/section.json +5 -4
  38. package/okf/direct_tax/tds_contractor_194c/section.json +3 -3
  39. package/okf/direct_tax/tds_ecommerce_194o/circulars/cbdt_circular_20_2020_guidelines_194o.md +36 -0
  40. package/okf/direct_tax/tds_ecommerce_194o/forms/form_26q_ecommerce_schedule.json +75 -0
  41. package/okf/direct_tax/tds_ecommerce_194o/section.json +65 -0
  42. package/okf/direct_tax/tds_goods_194q/circulars/cbdt_circular_13_2021_guidelines.md +2 -2
  43. package/okf/direct_tax/tds_goods_194q/section.json +9 -3
  44. package/okf/direct_tax/tds_goods_393/section.json +6 -4
  45. package/okf/direct_tax/tds_individual_contract_194m/circulars/finance_act_2024_194m_rate_cut_memo.md +24 -0
  46. package/okf/direct_tax/tds_individual_contract_194m/forms/form_26qd_contractor_statement.json +64 -0
  47. package/okf/direct_tax/tds_individual_contract_194m/section.json +58 -0
  48. package/okf/direct_tax/tds_interest_194a/circulars/cbdt_circular_03_2010_interest_tds.md +28 -0
  49. package/okf/direct_tax/tds_interest_194a/forms/form_15g_15h_interest_declaration.json +55 -0
  50. package/okf/direct_tax/tds_interest_194a/forms/form_26q_interest_schedule.json +72 -0
  51. package/okf/direct_tax/tds_interest_194a/section.json +67 -0
  52. package/okf/direct_tax/tds_perquisites_194r/forms/form_26q_perquisites_schedule.json +83 -0
  53. package/okf/direct_tax/tds_perquisites_194r/section.json +2 -2
  54. package/okf/direct_tax/tds_property_194ia/circulars/cbdt_notification_67_2022_property_tds.md +57 -0
  55. package/okf/direct_tax/tds_property_194ia/forms/form_26qb_property_tds_challan.json +43 -0
  56. package/okf/direct_tax/tds_property_194ia/section.json +73 -0
  57. package/okf/direct_tax/tds_rent_194i/section.json +5 -4
  58. package/okf/direct_tax/tds_rent_individual_194ib/circulars/finance_act_2024_rent_rate_cut_memo.md +24 -0
  59. package/okf/direct_tax/tds_rent_individual_194ib/forms/form_26qc_challan_cum_statement.json +74 -0
  60. package/okf/direct_tax/tds_rent_individual_194ib/section.json +57 -0
  61. package/okf/direct_tax/tds_services_194j/circulars/cbdt_circular_03_2020_fts_rate_cut.md +1 -1
  62. package/okf/direct_tax/tds_services_194j/section.json +10 -3
  63. package/okf/indirect_tax_gst/common_itc_reversal_rule42_43/circulars/cbic_circular_170_2022_itc_reporting.md +30 -0
  64. package/okf/indirect_tax_gst/common_itc_reversal_rule42_43/circulars/cbic_notification_18_2022_cutoff_amendment.md +26 -0
  65. package/okf/indirect_tax_gst/common_itc_reversal_rule42_43/forms/gstr_3b_table_4b1_reversal_schedule.json +101 -0
  66. package/okf/indirect_tax_gst/common_itc_reversal_rule42_43/forms/rule_42_43_annual_reconciliation_worksheet.json +87 -0
  67. package/okf/indirect_tax_gst/common_itc_reversal_rule42_43/section.json +65 -0
  68. package/okf/indirect_tax_gst/itc_reversal_rule37_37a/circulars/cbic_circular_192_2023_ecl_interest_calculation.md +36 -0
  69. package/okf/indirect_tax_gst/itc_reversal_rule37_37a/circulars/cbic_notification_19_2022_rule37.md +31 -0
  70. package/okf/indirect_tax_gst/itc_reversal_rule37_37a/forms/gstr_3b_table_4b_reversal.json +81 -0
  71. package/okf/indirect_tax_gst/itc_reversal_rule37_37a/section.json +71 -0
  72. package/okf/indirect_tax_gst/rcm_liability_sec9_3/circulars/cbic_notification_07_2025_composition_rent_exclusion.md +41 -0
  73. package/okf/indirect_tax_gst/rcm_liability_sec9_3/circulars/cbic_notification_09_2024_renting_rcm.md +37 -0
  74. package/okf/indirect_tax_gst/rcm_liability_sec9_3/circulars/gst_council_55th_meeting_renting_rcm_regularization.md +31 -0
  75. package/okf/indirect_tax_gst/rcm_liability_sec9_3/section.json +24 -2
  76. package/okf/international_tax/financial_instruments_ecl_indas_109/circulars/mca_notification_indas_109_financial_instruments.md +43 -0
  77. package/okf/international_tax/financial_instruments_ecl_indas_109/forms/indas_109_ecl_provision_matrix_schedule.json +43 -0
  78. package/okf/international_tax/financial_instruments_ecl_indas_109/section.json +62 -0
  79. package/okf/manifest.json +108 -15
  80. package/okf/msme_commercial/lease_accounting_indas_116/circulars/mca_notification_indas_116_leases.md +48 -0
  81. package/okf/msme_commercial/lease_accounting_indas_116/forms/lease_rou_asset_and_liability_schedule.json +55 -0
  82. package/okf/msme_commercial/lease_accounting_indas_116/section.json +67 -0
  83. package/okf/msme_commercial/provisions_contingencies_indas_37/circulars/mca_notification_indas_37_provisions.md +36 -0
  84. package/okf/msme_commercial/provisions_contingencies_indas_37/forms/provisions_and_contingent_liabilities_register.json +38 -0
  85. package/okf/msme_commercial/provisions_contingencies_indas_37/section.json +61 -0
  86. package/okf/msme_commercial/revenue_recognition_indas_115/circulars/mca_notification_indas_115_revenue_contracts.md +56 -0
  87. package/okf/msme_commercial/revenue_recognition_indas_115/forms/revenue_contract_5step_allocation_schedule.json +54 -0
  88. package/okf/msme_commercial/revenue_recognition_indas_115/section.json +69 -0
  89. package/package.json +7 -1
  90. package/src/calculators.js +7898 -638
  91. package/src/constants.js +1 -1
  92. package/src/index.js +604 -23
  93. package/src/tally.js +812 -0
  94. package/src/zoho_gstr2b.js +2964 -0
  95. package/types/index.d.ts +516 -0
@@ -0,0 +1,282 @@
1
+ # MudraForge Statutory Engine — CA Pilot Benchmark Cases & Real Traces
2
+
3
+ > **Document Type**: Audit Benchmark Suite & Real Execution Traces
4
+ > **Statutory Substrate**: `@mudraforge/statutory@2.11.0` (Zero-Dependency Deterministic Kernel)
5
+ > **LLM Advisory Layer**: Sarvam AI `sarvam-105b` (Live Endpoint: `https://api.sarvam.ai/v1/chat/completions`)
6
+ > **Evaluation Mode**: Multi-Pillar Un-Spoonfed Ingestion + Mathematical Logic Conversion
7
+ > **Last Updated**: 2026-10-29
8
+
9
+ ---
10
+
11
+ ## Architecture Overview
12
+
13
+ This suite validates the complete **MudraForge Dual-Engine Financial Architecture**:
14
+ - **Phase 1: Raw Unstructured AP Query (Input)**: Natural accountant queries with zero spoonfeeding of statutory section numbers.
15
+ - **Phase 2: Deterministic Statutory Substrate (`@mudraforge/statutory`)**: Immutable, mathematical derivation of tax withholdings, MSMED statutory clocks, and balanced general ledger vouchers.
16
+ - **Phase 3: Live Sarvam-105B Advisory Prose (Real API Call)**: Live LLM explanation generated by Sarvam AI's 105-billion parameter reasoning model, translating the engine's determinations into practitioner-grade advisory memos.
17
+ - **Phase 4: Mathematical & Excel Spreadsheet Formulas**: Direct translation of the statutory code logic into standard Excel formulas (`=IF(...)`, `=MAX(...)`, `=MIN(...)`).
18
+
19
+ ---
20
+
21
+ ## Case Study 01: Goods Purchase Cumulative Spend & 60-Day Terms
22
+
23
+ ### Phase 1: Inward Invoice Slip & ERP Ledger Context (Audit Input)
24
+
25
+ ```text
26
+ ================================================================================
27
+ INWARD TAX INVOICE SLIP
28
+ ================================================================================
29
+ SUPPLIER PROFILE:
30
+ Supplier Name : Precision Castings Limited
31
+ Legal Status : Public Limited Company
32
+ PAN : ABCDC1234F [Constitution: Company ('C')]
33
+ GSTIN : 27ABCDC1234F1Z5 (Maharashtra)
34
+ MSME / Udyam : UDYAM-MH-03-0019842 (Micro Enterprise)
35
+ Major Activity : Manufacturing (NIC 24311: Manufacture of Iron/Steel Castings)
36
+
37
+ INVOICE & DELIVERY DETAILS:
38
+ Invoice Number : INV-2025-0541
39
+ Invoice Date : 01-May-2025
40
+ PO Reference : PO-2025-0892 (Agreed Contract Terms: Net 60 Days)
41
+ Delivery / GRN : 01-May-2025 (Goods Received Note: GRN-4402 - Deemed Accepted)
42
+
43
+ LINE ITEM BREAKDOWN:
44
+ Description : Industrial Ductile Iron Valve Castings (HSN: 732599)
45
+ Basic Amount : ₹20,00,000.00
46
+ IGST (18%) : ₹3,60,000.00 (Separately stated on invoice)
47
+ Total Invoice : ₹23,60,000.00
48
+
49
+ BUYER ERP INTERNAL LEDGER CONTEXT:
50
+ Buyer Entity : Zenith Engineering Pvt Ltd (GSTIN: 24AABCZ1234F1Z1 - Gujarat)
51
+ Prior FY Turnover: ₹18.50 Crore in FY 2024-25 (Exceeds ₹10 Cr Section 194Q Gate)
52
+ Cumulative Spend: ₹45,00,000.00 YTD purchases in FY 2025-26 prior to this bill
53
+ (Booked on credit basis, net of GST per CBDT Circular 13/2021)
54
+ PAN Status : Active and Operative
55
+ Payment Mode : Credit in Books of Account (Standard Accounts Payable)
56
+ ================================================================================
57
+ ```
58
+
59
+ ### Phase 2: Deterministic Statutory Engine Execution (`@mudraforge/statutory`)
60
+ ```json
61
+ {
62
+ "statutesIdentified": [
63
+ "Section 194Q, Income-tax Act, 1961",
64
+ "CBDT Circular No. 13 of 2021 (GST Unbundling on Credit Basis)",
65
+ "Section 15, MSMED Act, 2006 (Statutory 45-Day Cap on Written Agreements)",
66
+ "Section 43B(h), Income-tax Act, 1961",
67
+ "Section 288B, Income-tax Act, 1961 (Whole-Rupee Rounding for TRACES Form 26Q)"
68
+ ],
69
+ "taxableBaseInr": 1500000,
70
+ "statutoryRate": "0.1%",
71
+ "tdsAmountInr": 1500,
72
+ "paymentCutoffDate": "2025-06-15",
73
+ "contractualOverride": "Contractual 60-day term is legally void under Section 15 of MSMED Act; statutory cutoff is strictly 45 days from GRN delivery date (15-June-2025).",
74
+ "generalLedgerVoucher": {
75
+ "debit": [
76
+ { "account": "Raw Material Inventory / Expense", "amountInr": 2000000 },
77
+ { "account": "GST Input Tax Credit (IGST)", "amountInr": 360000 }
78
+ ],
79
+ "credit": [
80
+ { "account": "TDS Payable (Section 194Q @ 0.1%)", "amountInr": 1500 },
81
+ { "account": "Vendor Accounts Payable (Precision Castings Limited)", "amountInr": 2358500 }
82
+ ],
83
+ "totalDebitInr": 2360000,
84
+ "totalCreditInr": 2360000,
85
+ "isBalanced": true
86
+ }
87
+ }
88
+ ```
89
+
90
+ ### Phase 3: Live Sarvam-105B Statutory Advisory Prose (Real API Call)
91
+ ```text
92
+ • Section 194Q TDS: The aggregate purchase in FY 2025-26 (₹45 L prior spend + ₹20 L basic) exceeds the ₹50 L threshold, so TDS @ 0.1% is payable on the incremental excess (₹15 L). IGST is unbundled per CBDT Circular 13/2021, yielding exact TDS of ₹1,500. Deduct and deposit this amount before releasing payment.
93
+
94
+ • MSMED Act Section 15 – Credit Term Void: Precision Castings Limited is a Micro Manufacturer; the statute caps the credit period at 45 days. The contractual 60-day term is legally void, and the buyer must settle on or before 15 June 2025 to avoid mandatory compound interest under Section 16 of the MSMED Act.
95
+
96
+ • Section 43B(h) – Year-End Deduction Impact: Payment beyond the statutory 45-day window makes the basic expense non-deductible for the fiscal year if unpaid by 31 March. To preserve the business deduction, the invoice should be cleared within 45 days.
97
+ ```
98
+
99
+ ### Phase 4: Mathematical & Excel Spreadsheet Formulas
100
+ - **TDS Deduction Amount (Whole Rupee Rounding per Section 288B / TRACES Form 26Q)**:
101
+ ```excel
102
+ =IF(AND(18.5>10, (4500000+2000000)>5000000), ROUND((MAX(0, (4500000+2000000)-5000000) - MAX(0, 4500000-5000000)) * 0.1%, 0), 0)
103
+ ```
104
+ - **MudraForge Custom Add-in Formula (`=MF.TDS`)**:
105
+ ```excel
106
+ =MF.TDS("194Q", 2360000, 4500000, TRUE, "2025-05-01", 18.5, 360000)
107
+ ```
108
+ *(Returns `1500.00`)*
109
+ - **MSMED Statutory Due Date (`=MF.MSME.DUEDATE`)**:
110
+ ```excel
111
+ =MF.MSME.DUEDATE("2025-05-01", TRUE, "2025-06-30")
112
+ ```
113
+ *(Returns `2025-06-15`)*
114
+
115
+ ---
116
+
117
+ ## Case Study 02: Wholesale Trader Unpaid at Year-End
118
+
119
+ ### Phase 1: Raw Unstructured AP Query (Input)
120
+ ```text
121
+ "We have an unpaid bill of ₹8,50,000 from Apex Steel Traders dated 15 January 2025.
122
+ They provided an active Udyam Certificate showing Micro Enterprise under wholesale trade of metals (NIC 46632).
123
+ Due to a working capital crunch, we could not clear their dues by 31 March 2025, and finally paid them on 10 April 2025 (85 days from bill date).
124
+ Will our tax auditor disallow this expense in this year's tax audit, and do we have to pay mandatory compound interest to the supplier?"
125
+ ```
126
+
127
+ ### Phase 2: Deterministic Statutory Engine Execution (`@mudraforge/statutory`)
128
+ ```json
129
+ {
130
+ "statutesIdentified": [
131
+ "Section 43B(h), Income-tax Act, 1961",
132
+ "Ministry of MSME OM No. 2/1(5)/2021-P&G/Policy dated 02.07.2021",
133
+ "MSMED Act, 2006 Chapter V"
134
+ ],
135
+ "isCoveredBy43Bh": false,
136
+ "penalInterestApplicable": false,
137
+ "taxAuditImplication": "Full expense of ₹8,50,000 is 100% ALLOWABLE in FY 2024-25. No reporting required under Clause 22 or Clause 26 of Form 3CD."
138
+ }
139
+ ```
140
+
141
+ ### Phase 3: Live Sarvam-105B Statutory Advisory Prose (Real API Call)
142
+ ```text
143
+ • Section 43B(h) Trader Carve-Out: The expense falls outside the scope of Section 43B(h) because Ministry of MSME Office Memorandum No. 2/1(5)/2021-P&G/Policy (02.07.2021) expressly excludes wholesale and retail traders (NIC Division 46) from Chapter V of the MSMED Act. Consequently, the full ₹8,50,000 is 100% deductible under Section 37(1) on mercantile accrual basis.
144
+
145
+ • MSMED Act 2006 – Penal Interest Inapplicable: Because Sections 15 through 25 of the MSMED Act do not apply to traders, delayed settlement of 85 days does not attract mandatory compound interest under Section 16.
146
+
147
+ • Tax Audit Reporting: The deterministic engine confirms that because the claim is fully allowable and the interest exemption is validated, zero disclosure is required under Clause 22 (MSME interest) or Clause 26 of Form 3CD for FY 2024-25.
148
+ ```
149
+
150
+ ### Phase 4: Mathematical & Excel Spreadsheet Formulas
151
+ - **Trader Carve-Out Classification**:
152
+ ```excel
153
+ =IF(OR(LEFT(NICCode, 2)="45", LEFT(NICCode, 2)="46", LEFT(NICCode, 2)="47"), "TRADER_EXEMPT_OM_2021", "ELIGIBLE_MSMED")
154
+ ```
155
+ - **Year-End Accrual Deductibility**:
156
+ ```excel
157
+ =IF(TraderExemption="TRADER_EXEMPT_OM_2021", "ALLOWABLE_ACCRUAL", IF(PaymentDate > FYEndDate, "DISALLOWED_43B_H", "ALLOWABLE"))
158
+ ```
159
+ - **MSMED Section 16 Interest Calculation**:
160
+ ```excel
161
+ =IF(TraderExemption="TRADER_EXEMPT_OM_2021", 0, CompoundInterest(Principal, DaysElapsed, 3 * RBIRepoRate))
162
+ ```
163
+
164
+ ---
165
+
166
+ ## Case Study 03: IT Consultant with Inoperative PAN
167
+
168
+ ### Phase 1: Raw Unstructured AP Query (Input)
169
+ ```text
170
+ "We engaged an individual IT consultant, Rajesh Verma, to rebuild our cloud database architecture and backend APIs.
171
+ He sent an invoice for ₹2,50,000 + 18% GST (₹45,000), total ₹2,95,000 dated 10 June 2025.
172
+ His PAN is ABCPV9876K, but the income tax portal says his PAN is inoperative because it was not linked with Aadhaar.
173
+ What tax rate should we deduct from his invoice, and how should this be booked in our accounts?"
174
+ ```
175
+
176
+ ### Phase 2: Deterministic Statutory Engine Execution (`@mudraforge/statutory`)
177
+ ```json
178
+ {
179
+ "statutesIdentified": [
180
+ "Section 194J(1)(b) (Fees for Technical Services - 2%)",
181
+ "CBDT Circular No. 23 of 2017 (GST Basic Stripping)",
182
+ "Section 206AA(1)(iii) (Inoperative PAN 20% Floor)",
183
+ "CBDT Circular No. 3 of 2023 read with Rule 114AAA"
184
+ ],
185
+ "baseRatePercent": 2.0,
186
+ "effectiveRatePercent": 20.0,
187
+ "tdsAmountInr": 50000,
188
+ "generalLedgerVoucher": {
189
+ "debit": [
190
+ { "account": "Professional & Technical Fees (P&L)", "amountInr": 250000 },
191
+ { "account": "GST Input Tax Credit (CGST/SGST)", "amountInr": 45000 }
192
+ ],
193
+ "credit": [
194
+ { "account": "TDS Payable (Section 194J / 206AA @ 20%)", "amountInr": 50000 },
195
+ { "account": "Sundry Creditors / Vendor Payable (Rajesh Verma)", "amountInr": 245000 }
196
+ ],
197
+ "totalDebitInr": 295000,
198
+ "totalCreditInr": 295000,
199
+ "isBalanced": true
200
+ }
201
+ }
202
+ ```
203
+
204
+ ### Phase 3: Live Sarvam-105B Statutory Advisory Prose (Real API Call)
205
+ ```text
206
+ • Rate of Deduction: The applicable TDS rate is 20% under Section 206AA of the Income-tax Act, 1961. An inoperative PAN (not linked with Aadhaar per Circular 3/2023) mandates deduction at the higher penalty floor of 20%, overriding the standard 2% rate under Section 194J(1)(b).
207
+
208
+ • Tax Base Determination: The TDS of ₹50,000 (20% of ₹2,50,000) is calculated on the basic service fee only. GST of ₹45,000 is excluded from the TDS base per CBDT Circular 23/2017.
209
+
210
+ • Accounting Entry: Debit Professional Fees (P&L) ₹2,50,000, Debit GST Input Tax Credit ₹45,000 | Credit TDS Payable (Section 206AA) ₹50,000, Credit Vendor Payable ₹2,45,000.
211
+ ```
212
+
213
+ ### Phase 4: Mathematical & Excel Spreadsheet Formulas
214
+ - **Base Statutory Rate**:
215
+ ```excel
216
+ =IF(ServiceCategory="TECHNICAL_SERVICES", 2%, 10%)
217
+ ```
218
+ - **Inoperative PAN Penalty Rate**:
219
+ ```excel
220
+ =IF(IsPanInoperative="YES", MAX(BaseRate, 20%), BaseRate)
221
+ ```
222
+ - **Net Withholding Voucher Calculation**:
223
+ ```excel
224
+ =ROUND(BasicInvoiceAmount * EffectiveTdsRate, 2)
225
+ ```
226
+
227
+ ---
228
+
229
+ ## Case Study 04: Long-Pending Freight Dispute
230
+
231
+ ### Phase 1: Raw Unstructured AP Query (Input)
232
+ ```text
233
+ "We booked a freight invoice from Delta Logistics on 01 April 2024 for ₹1,18,000 (Freight ₹1,00,000 + 18% IGST ₹18,000) and claimed the ₹18,000 input tax credit in our April GST return.
234
+ Due to an ongoing dispute over container detention charges, we haven't paid them a single rupee as of 01 November 2024 (7 months elapsed).
235
+ Do we have to give back the GST credit to the government, is there any interest penalty, and can we take the credit back if we settle the bill later?"
236
+ ```
237
+
238
+ ### Phase 2: Deterministic Statutory Engine Execution (`@mudraforge/statutory`)
239
+ ```json
240
+ {
241
+ "statutesIdentified": [
242
+ "Second Proviso to Section 16(2), CGST Act, 2017 (180-Day Ceiling)",
243
+ "Rule 37, CGST Rules, 2017 (GSTR-3B Table 4(B)(2) Reversal)",
244
+ "Section 50(1), CGST Act, 2017 (18% Annual Interest Liability)",
245
+ "Section 16(4) Re-availment Exception"
246
+ ],
247
+ "daysElapsed": 214,
248
+ "reversalAmountInr": 18000,
249
+ "interestPayableInr": 1899.62,
250
+ "gstr3bReportingTable": "TABLE_4_B_2_OTHERS_RECLAIMABLE",
251
+ "canReclaimOnPayment": true
252
+ }
253
+ ```
254
+
255
+ ### Phase 3: Live Sarvam-105B Statutory Advisory Prose (Real API Call)
256
+ ```text
257
+ • Mandatory ITC Reversal Triggered: You are statutorily obligated to reverse the ₹18,000 IGST credit under the second proviso to Section 16(2) of the CGST Act, 2017. The invoice dated 01.04.2024 has remained unpaid for 214 days, exceeding the 180-day statutory ceiling.
258
+
259
+ • Accrual of Interest: Mandatory interest of ₹1,899.62 has accrued and is payable under Section 50(1) of the CGST Act, 2017, calculated at 18% per annum on the reversed amount of ₹18,000 from the date of availment.
260
+
261
+ • GSTR-3B Reporting: The reversal must be reported in GSTR-3B under Table 4(B)(2) (Others - Reclaimable Reversals).
262
+
263
+ • Right to Re-avail ITC: Upon eventual resolution of the dispute and payment to the supplier, you can reclaim the ₹18,000 ITC under Table 4(A)(5) and report in Table 4(D)(1) without any time limit under Section 16(4).
264
+ ```
265
+
266
+ ### Phase 4: Mathematical & Excel Spreadsheet Formulas
267
+ - **Days Outstanding**:
268
+ ```excel
269
+ =CalculationDate - InvoiceDate
270
+ ```
271
+ - **Rule 37 Mandatory Reversal Amount**:
272
+ ```excel
273
+ =IF(DaysElapsed > 180, ProportionalITC, 0)
274
+ ```
275
+ - **Section 50(1) 18% Annual Interest Liability**:
276
+ ```excel
277
+ =ROUND(MandatoryReversal * 18% * (DaysElapsed / 365), 2)
278
+ ```
279
+ - **Re-Availment Ledger Status**:
280
+ ```excel
281
+ =IF(ActualSettlementMade="YES", "RECLAIMABLE_TABLE_4A5", "HOLD_IN_REVERSAL")
282
+ ```
@@ -1,9 +1,9 @@
1
1
  # MudraForge Statutory Knowledge Quality Card
2
2
 
3
3
  > **Format Reference**: Inspired by Google's *Data Cards Playbook* and the OpenSSF Project Quality Standards.
4
- > **Target Package**: `@mudraforge/statutory` v2.10.0
4
+ > **Target Package**: `@mudraforge/statutory` v2.12.0
5
5
  > **Evaluation Mode**: Machine-audited against primary sources, official gazettes, and test fixtures.
6
- > **Generated Timestamp**: 2026-10-26T21:04:24.978Z
6
+ > **Generated Timestamp**: 2026-11-06T18:36:37.873Z
7
7
 
8
8
  ---
9
9
 
@@ -11,12 +11,12 @@
11
11
 
12
12
  | Dimension | Metric | Denominator / Baseline | Coverage Rate | Status |
13
13
  | :--- | :--- | :--- | :--- | :--- |
14
- | **Primary Source Citations** | 76 resolvable gazette URLs | 76 total citations declared | **100.0%** | VERIFIED |
15
- | **Temporal Validity Bounds** | 29 sections with explicit dates | 29 total bundled sections | **100.0%** | VERIFIED |
16
- | **Dual-Act 2025 Transition Bridges** | 9 direct tax provisions mapped | 10 direct tax provisions | **90.0%** | VERIFIED |
17
- | **Attached Administrative Circulars** | 30 official circulars | 29 provisions across active domains | **100% Attached** | VERIFIED |
18
- | **Attached Return/Compliance Schemas** | 27 schemas/templates | 29 provisions across active domains | **100% Attached** | VERIFIED |
19
- | **Cryptographic Merkle Verification** | 86 bundle files verified | SHA-256 Merkle root digest | **0 Mismatches** | VERIFIED |
14
+ | **Primary Source Citations** | 125 resolvable gazette URLs | 125 total citations declared | **100.0%** | VERIFIED |
15
+ | **Temporal Validity Bounds** | 46 sections with explicit dates | 46 total bundled sections | **100.0%** | VERIFIED |
16
+ | **Dual-Act 2025 Transition Bridges** | 16 direct tax provisions mapped | 17 direct tax provisions | **94.1%** | VERIFIED |
17
+ | **Attached Administrative Circulars** | 52 official circulars | 46 provisions across active domains | **100% Attached** | VERIFIED |
18
+ | **Attached Return/Compliance Schemas** | 47 schemas/templates | 46 provisions across active domains | **100% Attached** | VERIFIED |
19
+ | **Cryptographic Merkle Verification** | 145 bundle files verified | SHA-256 Merkle root digest | **0 Mismatches** | VERIFIED |
20
20
 
21
21
  ---
22
22
 
@@ -48,19 +48,31 @@
48
48
 
49
49
  | Section Code | Statutory Provision | Governing Statute | Temporal Window | Status | Citations | Circulars | Forms | 2025 Act Successor |
50
50
  | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
51
+ | **INDAS-103-IFRS-3** | Business Combinations & Purchase Price Allocation (Acquisition Method, Identifiable Net Assets, Goodwill vs Capital Reserve, and Contingent Consideration) | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013, IFRS 3, and US GAAP FASB ASC Topic 805 | `2015-04-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 103) |
52
+ | **INDAS-36-IAS-36** | Impairment of Assets & Cash-Generating Units (Recoverable Amount Determination, Goodwill Priority Allocation, and Reversal Boundaries) | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013, IAS 36, and US GAAP FASB ASC Topic 360 & 350 | `2015-04-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 36) |
51
53
  | **ITA-SEC-79** | Carry Forward and Set Off of Accumulated Losses on Change in Shareholding | Income-tax Act, 1961 (Act No. 43 of 1961) | `1962-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Income-tax Act, 2025 (Chapter on Set-off and Carry Forward of Losses) (Provisions on Loss Set-Off on Shareholding Continuity) |
54
+ | **INDAS-102-ASC-718** | Share-Based Payments & Employee Stock Options (ESOP Grant-Date Fair Value & Graded Vesting Amortization) | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013, ICAI Guidance Note on Accounting for Employee Share-based Payments, and US GAAP FASB ASC Topic 718 (Stock Compensation) | `2015-04-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 102) |
52
55
  | **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)) |
56
+ | **281** | Certain Transfers to be Void & Tax Clearance Requirements in Corporate Restructuring (Section 281) | Income-tax Act, 1961 (Act No. 43 of 1961) | `1962-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Income-tax Act, 2025 (Section 497 (Transfers to defraud revenue to be void)) |
53
57
  | **115BAA-115JB** | Tax on income of certain domestic companies (Section 115BAA) and Minimum Alternate Tax (Section 115JB) | Income-tax Act, 1961 (Act No. 43 of 1961) | `2019-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Income-tax Act, 2025 (Chapter XI (Corporate Taxation & Special Regimes)) |
58
+ | **INDAS-12-ASC-740** | Income Taxes & Deferred Tax Accounting (Balance Sheet Temporary Differences & Effective Tax Rate Reconciliation) | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013, Income-tax Act, 1961, and US GAAP FASB ASC Topic 740 (Income Taxes) | `2015-04-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 12) |
54
59
  | **206AB** | Special provision for deduction of tax at source for non-filers of income-tax return (Omitted effective 1 April 2025) | Income-tax Act, 1961 (Act No. 43 of 1961) | `2021-07-01` to `2025-03-31` | `SUNSET_SUPERSEDED` | 1 | 1 | 0 | Finance Act, 2025 (Statutory Omission) (Section 206AB Omitted) |
60
+ | **43B** | Statutory Disallowance on Certain Deductions to be Only on Actual Payment (Section 43B) and Employee Welfare Deductions (Section 36(1)(va)) | Income-tax Act, 1961 (Act No. 43 of 1961) | `1984-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Income-tax Act, 2025 (Section 47 (Deductions on actual payment basis) and Section 35(1)(xvi)) |
55
61
  | **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) |
56
- | **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)) |
57
- | **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)) |
58
- | **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)) |
59
- | **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 |
60
- | **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) |
61
- | **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)) |
62
- | **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)) |
62
+ | **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 1, Sl. No. 1(ii)) |
63
+ | **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 1, Sl. No. 6(i)) |
64
+ | **194O** | Payment of certain sums by e-commerce operator to e-commerce participant | Income-tax Act, 1961 (Act No. 43 of 1961) | `2020-10-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 3 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 8(i)) |
65
+ | **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` | 3 | 2 | 2 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 8(ii)) |
66
+ | **393** | Deduction of tax at source on payment of a certain sum for purchase of goods (Table 1, Sl. No. 8(ii)) | Income-tax Act, 2025 (Act No. 1 of 2025) | `2026-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 0 | 0 | N/A |
67
+ | **194M** | Payment of Certain Sums by Certain Individuals or Hindu Undivided Family (Section 194M) | Income-tax Act, 1961 (Act No. 43 of 1961) | `2019-09-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 2 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 6(i) / 6(iii) / 1(ii)) |
68
+ | **194A** | Deduction of tax at source on payment of interest other than interest on securities | Income-tax Act, 1961 (Act No. 43 of 1961) | `1967-04-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 3 | 1 | 2 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 5(ii) and 5(iii)) |
69
+ | **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 | 1 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 8(iv)) |
70
+ | **194-IA** | Payment on Transfer of Certain Immovable Property Other than Agricultural Land (Section 194-IA) | Income-tax Act, 1961 (Act No. 43 of 1961) | `2013-06-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 3 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 3(i)) |
71
+ | **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 1, Sl. No. 2) |
72
+ | **194-IB** | Payment of Rent by Certain Individuals or Hindu Undivided Family (Section 194-IB) | Income-tax Act, 1961 (Act No. 43 of 1961) | `2017-06-01` to `2026-03-31` | `SUNSET_SUPERSEDED` | 2 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 2(iii)) |
73
+ | **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` | 3 | 1 | 1 | Income-tax Act, 2025 (Section 393(1), Table 1, Sl. No. 6(iii)) |
63
74
  | **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)) |
75
+ | **RULE-42-43** | Apportionment of input tax credit on inputs, input services and capital goods, and reversal of common credit attributable to exempt or non-business supplies | Central Goods and Services Tax Act, 2017 (Act No. 12 of 2017) | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 2 | 2 | Central Goods and Services Tax Act, 2017 (Section 17(1) and Section 17(2) read with Rule 42 and Rule 43 (as amended)) |
64
76
  | **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 |
65
77
  | **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 |
66
78
  | **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 |
@@ -68,14 +80,19 @@
68
80
  | **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 |
69
81
  | **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 |
70
82
  | **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)) |
71
- | **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 |
83
+ | **RULE-37-37A** | Reversal of input tax credit in case of non-payment of consideration to vendor within 180 days and non-filing by supplier | Central Goods and Services Tax Act, 2017 (Act No. 12 of 2017) | `2017-07-01` to `OPEN_ENDED` | `ACTIVE` | 4 | 2 | 1 | Central Goods and Services Tax Act, 2017 (Section 16(2) second proviso read with Rule 37 and Rule 37A (as amended)) |
84
+ | **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` | 6 | 4 | 1 | N/A |
72
85
  | **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) |
86
+ | **INDAS-109-IFRS-9** | Financial Instruments: Classification, Measurement & Expected Credit Loss (ECL) Impairment | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013 and US GAAP FASB Accounting Standards Codification Topic 326 (Financial Instruments - Credit Losses / CECL) | `2018-04-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 109) |
73
87
  | **INDAS-21-109-FX** | Foreign Exchange Monetary Asset/Liability Revaluation and Cash Flow Hedge Accounting | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013 | `2016-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 21 & Ind AS 109) |
74
88
  | **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) |
75
89
  | **ITA-SEC-92C-RULE-10CA** | Computation of Arm's Length Price (ALP), Range Concept and Secondary Adjustments | Income-tax Act, 1961 (Act No. 43 of 1961) | `2014-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Income-tax Act, 2025 (Chapter on International Tax & Transfer Pricing) (Transfer Pricing Provisions) |
76
90
  | **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) |
77
91
  | **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 |
92
+ | **INDAS-116-ASC-842** | Lease Accounting & On-Balance-Sheet Capitalization (Right-of-Use Asset & Lease Liability Amortization) | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013 and US GAAP FASB Accounting Standards Codification Topic 842 | `2019-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 116) |
78
93
  | **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 |
94
+ | **INDAS-37-ASC-450** | Provisions, Contingent Liabilities & Contingent Assets (Dispute Probability Triangulation & Footnote Disclosures) | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013, ICAI Guidance Note on Provisions and Contingencies, and US GAAP FASB ASC Topic 450 (Contingencies) | `2015-04-01` to `OPEN_ENDED` | `ACTIVE` | 2 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 37) |
95
+ | **INDAS-115-ASC-606** | Revenue from Contracts with Customers (5-Step Transaction Price Allocation & Performance Obligation Recognition) | Companies (Indian Accounting Standards) Rules, 2015 read with Section 133 of Companies Act, 2013 and US GAAP FASB Accounting Standards Codification Topic 606 | `2018-04-01` to `OPEN_ENDED` | `ACTIVE` | 3 | 1 | 1 | Companies Act, 2013 (Indian Accounting Standards) (Ind AS 115) |
79
96
  | **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 |
80
97
 
81
98
  ---
@@ -11,7 +11,7 @@ This document clearly distinguishes between:
11
11
 
12
12
  ## 1. Software Code & Tooling (MIT License)
13
13
 
14
- All executable code, client libraries, CLI binaries, test suites, and validation scripts in this repository are licensed under the **[MIT License](./LICENSE)**:
14
+ All executable code, client libraries, CLI binaries, test suites, and validation scripts in this repository are licensed under the **[MIT License](../LICENSE)**:
15
15
 
16
16
  - `src/` (Client runtime, resolver, temporal state evaluator)
17
17
  - `bin/` (Command-line interface)
@@ -1,8 +1,8 @@
1
1
  # MudraForge Statutory Substrate: Breadth & Depth Analysis
2
2
  ## Public Package Seed vs. Full Sovereign Operating Engine
3
3
 
4
- > **Document Version**: `1.0.0`
5
- > **Package**: `@mudraforge/statutory` (v2.9.0)
4
+ > **Document Version**: `2.0.0`
5
+ > **Package**: `@mudraforge/statutory` (v2.10.0)
6
6
  > **Enterprise Sovereign Engine**: MudraForge Adesha Sovereign Runtime
7
7
  > **Specification**: Google Open Knowledge Format (OKF v0.2)
8
8
 
@@ -12,7 +12,7 @@
12
12
 
13
13
  This document provides the authoritative architectural matrix comparing the **Breadth** (regulatory domains covered) and **Depth** (granularity, operative provisos, evidence attestation, and mathematical enforcement) between:
14
14
 
15
- 1. **The Public Package (`@mudraforge/statutory`)**: The lightweight, zero-dependency, offline-capable starter seed published for public AI agents and developer workflows.
15
+ 1. **The Public Package (`@mudraforge/statutory`)**: The lightweight, zero-dependency, offline-capable package of 29 verified provisions across 5 foundational domains published for public AI agents and developer workflows.
16
16
  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.
17
17
 
18
18
  ---
@@ -23,15 +23,15 @@ This matrix delineates what is **natively bundled in the base package** (zero ne
23
23
 
24
24
  | # | Regulatory Domain | Base Package (Offline Clone / No Sync) | Edge Synced (`npx ... sync`) | Future Cloud Expansion (Internal Sovereign Engine) | Availability & Status in Package |
25
25
  | :-: | :--- | :--- | :--- | :--- | :---: |
26
- | **1** | **Direct Tax (TDS / TCS)** | Included: 3 core sections (194Q, 194J, 206C(1H) sunset) + 2 CBDT circulars + Form 26Q/16A schemas | Expanded withholding suite (194C contractors, 194I rent, 194H commission, Act 2025 Table 8 crosswalk) | Section 197 TRACES certificate quota vault, advance challan netting, automated double-entry JVs | **Bundled in Base**<br>*(Expanded via Sync)* |
27
- | **2** | **MSME & Working Capital** | Included: Sections 15 & 16 (15/45-day clock, 3x RBI interest, Sec 43B(h), Trader Exclusion OM, Schedule III disclosure) | 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>*(Expanded via Sync)* |
28
- | **3** | **Indirect Tax (GST & ITC)** | Included: CGST Section 17(5) blocked credit negative list + Circular 172 employer obligations + GSTR-2B Table 4(B) | Section 16(2) 4-way matching rules & 180-day reversal calculation guidelines | Real-time Rule 48(4) IRN hash verification, Rule 89(5) Inverted Duty Structure (IDS) refund engine | **Bundled in Base**<br>*(Expanded via Sync)* |
29
- | **4** | **Financial Reporting (Ind AS)** | Not bundled in base | Baseline Ind AS 115 & 116 accounting summaries | **Full Indian Accounting Standards (Ind AS) Suite**: Ind AS 115 (5-step, variable constraint), Ind AS 116 (ROU/lease liability), Ind AS 103 (PPA/goodwill/NCI), Ind AS 109 (3-stage ECL), Ind AS 12 (DTA/DTL) | **Planned: Ind AS Expansion Pack** |
30
- | **5** | **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** |
31
- | **6** | **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** |
32
- | **7** | **Cross-Border & FEMA** | Included: IRC 901/904 FTC pass-through baskets + Indian Form 67 & US IRS Schedule K-3 | Foreign vendor DTAA treaty checklists (TRC, No-PE, electronic Form 10F) | Supreme Court *Engineering Analysis* SaaS royalty defense, Form 15CA/CB vs Form 145/146 automated dual-act router | **Bundled in Base**<br>*(Expanded via Sync)* |
33
- | **8** | **M&A Restructuring & Succession** | Included: Section 50B slump sale net worth computation + Rule 11UAE FMV + Notif 12/2017 0% GST + Form 3CEA schema | 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, Notification 12/2017 0% GST going concern | **Bundled in Base**<br>*(Expanded via Sync)* |
34
- | **9** | **Strategic Corporate Tax Planning** | Not bundled in base | Section 115BAA overview | **Strategic Tax Playbook**: Section 115BAA vs MAT credit cliff, Section 80JJAA 30% employment deduction, Section 79 loss continuity, Section 68/115BBE cash credit defense | **Planned: Strategic Tax Pack** |
26
+ | **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)* |
27
+ | **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)* |
28
+ | **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)* |
29
+ | **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)* |
30
+ | **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)* |
31
+ | **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** |
32
+ | **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** |
33
+ | **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** |
34
+ | **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** |
35
35
  | **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** |
36
36
  | **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** |
37
37
 
@@ -55,31 +55,31 @@ Level 5: Deterministic Mathematical Execution (Excess Math, Compound Interest, J
55
55
 
56
56
  ### Detailed Depth Breakdown by Domain
57
57
 
58
- ### 1. Direct Tax & Corporate Withholding (TDS / TCS)
58
+ ### 1. Direct Tax & Corporate Withholding (TDS / TCS / Corporate Regimes)
59
59
  * **Public Starter Seed**:
60
- - Reaches **Level 3**.
61
- - **Provisions**: Section 194Q, 194J, 206C(1H) sunset.
62
- - **Thresholds**: ₹50 Lakh annual purchase limit, ₹10 Crore prior turnover.
63
- - **Rates**: 0.1% base rate, 2% FTS rate, 10% professional rate, 5% Section 206AA non-PAN penalty cap.
64
- - **Circulars**: CBDT Circular 13/2021 (threshold calculation, advance netting), CBDT Circular 23/2017 (GST unbundling).
65
- - **Forms**: Form 26Q quarterly TDS return schema, Form 16A certificate schema, Vendor PAN / 206AB declaration template.
60
+ - Reaches **Level 3** (with Level 5 Deterministic Calculators for MAT vs 115BAA and 288B tax rounding).
61
+ - **Provisions**: 10 direct tax sections (194Q, 194J, 194C, 194H, 194I, 194R, 206AB, 206C(1H), 115BAA-115JB, and Income-tax Act, 2025 Section 393).
62
+ - **Thresholds**: ₹50 Lakh annual purchase limit, ₹10 Crore prior turnover, ₹30k/₹1L contractor aggregate, ₹2.4L rent threshold.
63
+ - **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.
64
+ - **Circulars**: CBDT Circular 13/2021, Circular 23/2017, Circular 03/2020, Circular 29/2019, Finance Act 2024/2025 transition memos.
65
+ - **Forms**: Form 26Q quarterly TDS return schema, Form 16A certificate schema, Form 10IC corporate tax election, Vendor PAN / 206AB declaration template.
66
66
  * **Full Enterprise Engine (Adesha Runtime)**:
67
67
  - Reaches **Level 5**.
68
- - **Full Statutory Spectrum**: Table 8 of Income-tax Act, 2025 (Section 392 Rent, 393 Goods, 394 Contractors, 395 Professional/FTS, 397 Non-PAN).
68
+ - **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).
69
69
  - **TRACES Lower Deduction Vault**: Automatically ingests, validates, and tracks Section 197 / Section 395 lower withholding certificates; enforces monetary ceilings and tracks consumed quota.
70
70
  - **Advance Netting & Challan Reconciliation**: Matches credits against Challan ITNS 281 tax deposits under Rule 30.
71
71
  - **Deterministic Output**: Generates balanced double-entry Journal Vouchers (JVs) debiting expense/inventory, debiting GST ITC, crediting TDS Payable, and crediting AP.
72
72
 
73
73
  ---
74
74
 
75
- ### 2. MSME & Working Capital (Delayed Payments & Section 43B(h))
75
+ ### 2. MSME & Working Capital (Delayed Payments, Section 43B(h) & Reporting)
76
76
  * **Public Starter Seed**:
77
- - Reaches **Level 3**.
78
- - **Provisions**: MSMED Act, 2006 Sections 15 & 16; Income-tax Act Section 43B(h).
77
+ - Reaches **Level 3** (with Level 5 Deterministic Calculator for Section 16 MSME compound penal interest at 3x RBI Bank Rate).
78
+ - **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).
79
79
  - **Timelines**: Strict 15-day (without contract) or maximum 45-day (with written contract) payment clocks.
80
- - **Rates**: Mandatory compound penal interest at 3x RBI Bank Rate.
81
- - **Circulars**: Ministry of MSME OM 1/4(1)/2021-P&G/Policy (strictly excluding retail and wholesale traders under NIC 45, 46, 47 from delayed payment protections).
82
- - **Forms**: UDYAM registration verification schema, Companies Act Schedule III corporate balance sheet disclosure notes.
80
+ - **Rates**: Mandatory compound penal interest at 3x RBI Bank Rate notified by Reserve Bank of India.
81
+ - **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).
82
+ - **Forms**: UDYAM registration verification schema, Udyam composite calculation worksheet, MCA Form MSME-1 half-yearly return schema, Schedule III trade payables aging disclosure table.
83
83
  * **Full Enterprise Engine (Adesha Runtime)**:
84
84
  - Reaches **Level 5**.
85
85
  - **Multi-Interval Compound Interest Calculator** (`calculateMultiIntervalMsmeInterest`): Accurately tracks shifting RBI Bank Rates across multi-quarter delinquencies, compounding on monthly rests.
@@ -88,13 +88,12 @@ Level 5: Deterministic Mathematical Execution (Excess Math, Compound Interest, J
88
88
 
89
89
  ---
90
90
 
91
- ### 3. Indirect Tax (GST & Input Tax Credit)
91
+ ### 3. Indirect Tax (GST, Invoicing & Input Tax Credit)
92
92
  * **Public Starter Seed**:
93
- - Reaches **Level 3**.
94
- - **Provisions**: CGST Act, 2017 Section 17(5) negative list for blocked input tax credit.
95
- - **Scope**: Motor vehicles, food & beverages, outdoor catering, club memberships, personal consumption.
96
- - **Circulars**: CBIC Circular 172/04/2022-GST (carving out the statutory employer obligation exception).
97
- - **Forms**: GSTR-2B vs. GSTR-3B Table 4(B) ineligible ITC reporting schema.
93
+ - Reaches **Level 3** (with Level 5 Deterministic Calculator for Place of Supply & Zero-Rated LUT exports).
94
+ - **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.
95
+ - **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).
96
+ - **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.
98
97
  * **Full Enterprise Engine (Adesha Runtime)**:
99
98
  - Reaches **Level 5**.
100
99
  - **Section 16(2) 4-Condition Invariant Gate**: Concurrently verifies tax invoice possession, physical GRN receipt, GSTR-2B reflection, and supplier tax remittance.
@@ -104,9 +103,11 @@ Level 5: Deterministic Mathematical Execution (Excess Math, Compound Interest, J
104
103
 
105
104
  ---
106
105
 
107
- ### 4. Financial Reporting & Indian Accounting Standards (Ind AS)
106
+ ### 4. International Tax, FX Revaluation & Transfer Pricing
108
107
  * **Public Starter Seed**:
109
- - [Not seeded in starter package]
108
+ - Reaches **Level 3** (with Level 5 Deterministic Calculators for Transfer Pricing ALP Rule 10CA and Ind AS 21/109 FX revaluation).
109
+ - **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.
110
+ - **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.
110
111
  * **Full Enterprise Engine (Adesha Runtime)**:
111
112
  - Reaches **Level 5** (Full Corporate Financial Reporting & Ind AS Framework).
112
113
  - **Ind AS 115 (Revenue from Contracts with Customers)**:
@@ -117,6 +118,7 @@ Level 5: Deterministic Mathematical Execution (Excess Math, Compound Interest, J
117
118
  - **Ind AS 116 (Leases)**:
118
119
  - Right-of-Use (ROU) asset and Lease Liability discounting at incremental borrowing rate.
119
120
  - Low-value asset ($<\$5,000$) and short-term ($<12\text{ months}$) exemption handling.
121
+ - Lease modification vs. reassessment state transitions.
120
122
  - **Ind AS 103 (Business Combinations)**:
121
123
  - Acquisition method and Purchase Price Allocation (PPA).
122
124
  - Goodwill vs. Capital Reserve computation; Non-Controlling Interest (NCI) fair value measurement.