nx_finance_svc.nx

nx_finance_svc.nx -- FINANCE SERVICE FACADE. One agentic MCP tool over the sovereign finance stack. This is the MCP / API / AGENTIC / WORKFLOW-READY / SCALABLE layer the gate-proven libraries did not yet have. It composes the integer-exact finance modules (nx_dcf, nx_bond, nx_taxlot, nx_amort) behind a verb- dispatched JSON contract inherited from nx_service, adding NO new domain logic -- every number comes from a gated module, so the facade cannot drift from the math it exposes (Rule 15 DRY, Rule 6 OOP, Rule 22 compose). MCP-ready: a single fork-exec organ, stable name + argv verb contract, registerable in the allowlist. API-ready: pure stdout JSON, versioned envelope, CORS-safe structured errors (400/404/422). agentic-ready: the `describe` verb emits this facade's verb catalog with arg shapes (tools/list analog). workflow-ready: every verb is a PURE function of its args returning a self-contained JSON object. scalable: stateless; a call is a fork-exec; concurrency is free. *THE FAIL-CLOSED PROPERTY SURVIVES THE FACADE: a domain refusal sentinel (the DCF growth>=rate trap, an unreachable bond yield, a bad tax-lot or amortization input) is mapped to a structured 422 REFUSED / 400 BAD_ARGS error, never a bogus number in the data. An agent sees the refusal as a first-class outcome. USAGE: nx_finance_svc <verb> [args...] genealogy_id: finance_spine + service_infrastructure