@markcolabs/mcp 0.2.0 → 0.4.0

package/dist/index.js

@@ -1,197 +1,62 @@
 #!/usr/bin/env node
 /**
- * @markcolabs/mcp — MCP server entrypoint.
+ * @markcolabs/mcp v0.4.0 — stdio↔HTTPS shim.
  *
- * v0.2.0 (per ADR-0039 + ADR-0041 reconciliation). Registers:
- *   - 5 tools:
- *       dc.calculator.mortgage.monthlyPayment           (S135 Item 5)
- *       dc.calculator.compoundInterest.futureValue      (S135 Item 5)
- *       dc.calculator.retirement401k.projection         (S136 Item 3, renamed v0.2.0 per ADR-0041 D2)
- *       dc.calculator.socialSecurity.estimatedBenefit   (S136 Item 3, renamed v0.2.0 per ADR-0041 D2)
- *       dc.calculator.paycheck.netPay                   (S136 Item 3)
- *   - 1 resource: dc://disclaimers/ymyl (canonical YMYL disclaimer)
+ * Proxies MCP JSON-RPC messages from stdin to the hosted MCP server at
+ * mcp.digitalcalculator.info/mcp and writes responses back to stdout.
  *
- * Transport: stdio (default for local MCP clients).
+ * Per ADR-0044a (ACCEPTED 2026-05-28): engine source lives in the private
+ * monorepo at infra/mcp/. This shim contains no calculation logic — it is
+ * a thin transport adapter only. MIT-licensed.
  *
- * S136 hits O5-KR1 5-tool target. Post-S136: methodology resources
- * (dc://methodologies/*) and the `plan-retirement` prompt template (O5-KR2).
+ * Claude Desktop config:
+ *   { "mcpServers": { "digitalcalculator": { "command": "npx", "args": ["-y", "@markcolabs/mcp"] } } }
  */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { zodToJsonSchema } from "./util/zod-to-json-schema.js";
-import * as mortgageTool from "./tools/mortgage.js";
-import * as compoundInterestTool from "./tools/compoundInterest.js";
-import * as retirement401kTool from "./tools/retirement401k.js";
-import * as socialSecurityTool from "./tools/socialSecurity.js";
-import * as paycheckTool from "./tools/paycheck.js";
-import { YMYL_DISCLAIMER, YMYL_DISCLAIMER_URI, } from "./disclaimers/ymyl.js";
-// Re-export the tool execute functions and engines so consumers (and parity
-// tests) can import them directly without spinning up the MCP transport.
-export { execute as executeMortgageTool } from "./tools/mortgage.js";
-export { execute as executeCompoundInterestTool } from "./tools/compoundInterest.js";
-export { execute as executeRetirement401kTool } from "./tools/retirement401k.js";
-export { execute as executeSocialSecurityTool } from "./tools/socialSecurity.js";
-export { execute as executePaycheckTool } from "./tools/paycheck.js";
-export * as mortgageEngine from "./engines/mortgage.js";
-export * as compoundInterestEngine from "./engines/compoundInterest.js";
-export * as retirement401kEngine from "./engines/retirement401k.js";
-export * as socialSecurityEngine from "./engines/socialSecurity.js";
-export * as paycheckEngine from "./engines/paycheck.js";
-export * from "./envelope.js";
-// ---------------------------------------------------------------------------
-// Server setup
-// ---------------------------------------------------------------------------
-const server = new Server({
-    name: "@markcolabs/mcp",
-    version: "0.2.0",
-}, {
-    capabilities: {
-        tools: {},
-        resources: {},
-    },
-});
-// ---------------------------------------------------------------------------
-// tools/list
-// ---------------------------------------------------------------------------
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: [
-            {
-                name: mortgageTool.TOOL_NAME,
-                description: mortgageTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(mortgageTool.MortgageMonthlyPaymentInputSchema),
-            },
-            {
-                name: compoundInterestTool.TOOL_NAME,
-                description: compoundInterestTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(compoundInterestTool.CompoundInterestFutureValueInputSchema),
-            },
-            {
-                name: retirement401kTool.TOOL_NAME,
-                description: retirement401kTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(retirement401kTool.Retirement401kProjectionInputSchema),
-            },
-            {
-                name: socialSecurityTool.TOOL_NAME,
-                description: socialSecurityTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(socialSecurityTool.SocialSecurityEstimateInputSchema),
+import * as readline from "readline";
+import * as https from "https";
+const MCP_ENDPOINT = "https://mcp.digitalcalculator.info/mcp";
+const SESSION_ID = Math.random().toString(36).slice(2);
+function post(body) {
+    return new Promise((resolve, reject) => {
+        const url = new URL(MCP_ENDPOINT);
+        const data = Buffer.from(body);
+        const req = https.request({
+            hostname: url.hostname,
+            path: url.pathname,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": data.byteLength,
+                "Mcp-Session-Id": SESSION_ID,
             },
-            {
-                name: paycheckTool.TOOL_NAME,
-                description: paycheckTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(paycheckTool.PaycheckNetPayInputSchema),
-            },
-        ],
-    };
-});
-// ---------------------------------------------------------------------------
-// tools/call
-// ---------------------------------------------------------------------------
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    let result;
-    switch (name) {
-        case mortgageTool.TOOL_NAME:
-            result = mortgageTool.execute(args);
-            break;
-        case compoundInterestTool.TOOL_NAME:
-            result = compoundInterestTool.execute(args);
-            break;
-        case retirement401kTool.TOOL_NAME:
-            result = retirement401kTool.execute(args);
-            break;
-        case socialSecurityTool.TOOL_NAME:
-            result = socialSecurityTool.execute(args);
-            break;
-        case paycheckTool.TOOL_NAME:
-            result = paycheckTool.execute(args);
-            break;
-        default:
-            return {
-                isError: true,
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: {
-                                code: "INPUT_VALIDATION",
-                                message: `Unknown tool: ${name}`,
-                                retriable: false,
-                            },
-                        }),
-                    },
-                ],
-            };
-    }
-    if (result.ok) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result.value, null, 2),
-                },
-            ],
-        };
+        }, (res) => {
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(chunk));
+            res.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        });
+        req.on("error", reject);
+        req.write(data);
+        req.end();
+    });
+}
+const rl = readline.createInterface({ input: process.stdin, terminal: false });
+rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    try {
+        const response = await post(trimmed);
+        process.stdout.write(response + "\n");
     }
-    return {
-        isError: true,
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify(result.error),
-            },
-        ],
-    };
-});
-// ---------------------------------------------------------------------------
-// resources/list — exposes the canonical YMYL disclaimer (O5-KR2 stub)
-// ---------------------------------------------------------------------------
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return {
-        resources: [
-            {
-                uri: YMYL_DISCLAIMER_URI,
-                name: "Canonical YMYL Disclaimer",
-                description: "Single source of truth for the YMYL disclaimer string returned in every tool response.",
-                mimeType: "text/plain",
-            },
-        ],
-    };
-});
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    const { uri } = request.params;
-    if (uri === YMYL_DISCLAIMER_URI) {
-        return {
-            contents: [
-                {
-                    uri,
-                    mimeType: "text/plain",
-                    text: YMYL_DISCLAIMER,
-                },
-            ],
-        };
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const parsed = (() => { try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return {};
+        } })();
+        process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: parsed.id ?? null, error: { code: -32603, message } }) + "\n");
     }
-    throw new Error(`Unknown resource: ${uri}`);
 });
-// ---------------------------------------------------------------------------
-// Boot — only run when invoked directly (not when imported by tests).
-// ---------------------------------------------------------------------------
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    // eslint-disable-next-line no-console
-    console.error("[@markcolabs/mcp] v0.2.0 ready (stdio) — 5 tools registered.");
-}
-// Run only when invoked as a binary, not when imported by parity tests.
-const isDirect = import.meta.url === `file://${process.argv[1]}` ||
-    process.argv[1]?.endsWith("dist/index.js") ||
-    process.argv[1]?.endsWith("dist\\index.js");
-if (isDirect) {
-    main().catch((err) => {
-        // eslint-disable-next-line no-console
-        console.error("[@markcolabs/mcp] fatal:", err);
-        process.exit(1);
-    });
-}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@markcolabs/mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "private": false,
-  "description": "Model Context Protocol server for digitalcalculator.info financial calculators. v0.2.0 ships 5 calculator tools (mortgage monthlyPayment, compound-interest futureValue, retirement401k projection, Social Security estimatedBenefit, paycheck netPay). Per ADR-0039 + ADR-0041 contract reconciliation.",
+  "description": "MCP stdio↔HTTPS shim for digitalcalculator.info financial calculators. Proxies MCP JSON-RPC to the hosted server at mcp.digitalcalculator.info/mcp. Per ADR-0044a: engine source is private; this package is a thin transport adapter only.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,22 +12,17 @@
   "scripts": {
     "build": "tsc",
     "start": "node ./dist/index.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.23.8"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/node": "^20.12.7",
-    "typescript": "^5.4.5",
-    "vitest": "^4.0.18"
+    "typescript": "^5.4.5"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -35,16 +30,30 @@
   "keywords": [
     "mcp",
     "model-context-protocol",
+    "mcp-server",
+    "claude-mcp",
+    "anthropic",
     "financial-calculator",
     "mortgage",
     "compound-interest",
     "401k",
     "social-security",
     "paycheck",
-    "digitalcalculator"
+    "ira",
+    "roth-conversion",
+    "rmd",
+    "hsa",
+    "inflation",
+    "savings",
+    "digitalcalculator",
+    "digitalcalculator.info"
   ],
   "author": "Markcolabs LLC",
   "license": "MIT",
+  "homepage": "https://www.digitalcalculator.info/mcp/",
+  "bugs": {
+    "url": "https://github.com/mark57-ux/digitalcalculator/issues"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/mark57-ux/digitalcalculator.git",

package/dist/disclaimers/ymyl.d.ts

@@ -1,16 +0,0 @@
-/**
- * Canonical YMYL disclaimer — single source of truth.
- *
- * Per ADR-0039 § 3 and § Implementation Notes / "YMYL disclaimer canonicalization":
- * - Every ToolResult.disclaimer field embeds this exact string.
- * - The same string is exposed as the `dc://disclaimers/ymyl` MCP resource.
- * - Tools do NOT author their own disclaimers. All MCP responses use this constant.
- *
- * Authoring is owned by Content. Updates here propagate to every tool response.
- */
-export declare const YMYL_DISCLAIMER: string;
-/**
- * MCP resource URI under which the disclaimer is exposed (O5-KR2).
- */
-export declare const YMYL_DISCLAIMER_URI = "dc://disclaimers/ymyl";
-//# sourceMappingURL=ymyl.d.ts.map

package/dist/disclaimers/ymyl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ymyl.d.ts","sourceRoot":"","sources":["../../src/disclaimers/ymyl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,QAKqE,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC"}

package/dist/disclaimers/ymyl.js

@@ -1,20 +0,0 @@
-/**
- * Canonical YMYL disclaimer — single source of truth.
- *
- * Per ADR-0039 § 3 and § Implementation Notes / "YMYL disclaimer canonicalization":
- * - Every ToolResult.disclaimer field embeds this exact string.
- * - The same string is exposed as the `dc://disclaimers/ymyl` MCP resource.
- * - Tools do NOT author their own disclaimers. All MCP responses use this constant.
- *
- * Authoring is owned by Content. Updates here propagate to every tool response.
- */
-export const YMYL_DISCLAIMER = "Estimates only — for educational purposes. Results are computed in USD using deterministic " +
-    "formulas and the inputs you provided. They do not constitute financial, tax, legal, or " +
-    "investment advice. Actual rates, fees, taxes, and outcomes vary by lender, jurisdiction, " +
-    "and personal circumstances. Verify with a licensed professional before making financial " +
-    "decisions. Source: digitalcalculator.info — see methodology link for formula and assumptions.";
-/**
- * MCP resource URI under which the disclaimer is exposed (O5-KR2).
- */
-export const YMYL_DISCLAIMER_URI = "dc://disclaimers/ymyl";
-//# sourceMappingURL=ymyl.js.map

package/dist/disclaimers/ymyl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ymyl.js","sourceRoot":"","sources":["../../src/disclaimers/ymyl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,6FAA6F;IAC7F,yFAAyF;IACzF,2FAA2F;IAC3F,0FAA0F;IAC1F,+FAA+F,CAAC;AAElG;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC"}

package/dist/engines/compoundInterest.d.ts

@@ -1,75 +0,0 @@
-/**
- * Compound-interest engine — lifted from
- * site/src/pages/compound-interest-calculator/compound-interest-calculator.js
- * (function `calculateFutureValue`).
- *
- * Per ADR-0039 § 5: pure synchronous functions, ENGINE_VERSION constant,
- * parity test against the site source as the gate.
- *
- * Math reference:
- *   FV_principal = P * (1 + r/n)^(nt)
- *   FV_contributions = PMT_per_period * [((1 + r/n)^(nt) - 1) / (r/n)]   (if r > 0)
- *   FV_contributions = PMT_per_period * (n * t)                           (if r == 0)
- *   where:
- *     P  = initial principal
- *     PMT_per_period = monthlyContribution * (12 / n)
- *     r  = annual rate as decimal (e.g., 0.07 for 7%)
- *     n  = compounding periods per year
- *     t  = years
- *
- * The engine accepts the rate as a percent and compounding as a label
- * (per ADR-0039 § 2 Percent-suffix convention + sprint prompt enum).
- */
-import { type CompoundingFrequencyLabel } from "../shared/bounds.js";
-/**
- * SemVer of the compound-interest engine math. Per ADR-0039 § 5 (reaffirmed in
- * ADR-0041 Position #4a): major bump = math change; minor = additive output;
- * patch = numerical correction. NOT bumped for cosmetic refactors.
- * - 0.1.0: initial v1 lift from compound-interest-calculator.js (S135 Item 5).
- * - 0.2.0 (v0.1.0 publish): out-of-policy package-surface bump — superseded.
- * - 1.0.0 (v0.2.0 publish): one-time reset to align with ADR-0039 § 5 per ADR-0041 D4a.
- *   Math unchanged from 0.1.0 / 0.2.0.
- */
-export declare const ENGINE_VERSION = "1.0.0";
-/**
- * Inputs to the compound-interest future-value engine.
- *
- * Per ADR-0039 § 2:
- * - Monetary fields are bare USD numbers.
- * - Percentage fields use whole-number-percent units (e.g., 7 for 7%).
- * - Optional fields default to 0 inside the engine.
- */
-export interface CompoundInterestFutureValueInput {
-    /** Initial principal in USD. */
-    principal: number;
-    /** Annual interest rate as whole-number percent (e.g., 7 for 7%). */
-    annualRatePercent: number;
-    /** Investment period in years. May be 0 (returns principal alone). */
-    years: number;
-    /** Compounding frequency label. */
-    compoundingFrequency: CompoundingFrequencyLabel;
-    /** Monthly contribution in USD. Optional — defaults to 0. */
-    monthlyContribution?: number;
-}
-/**
- * Result payload (what goes inside ToolResult.result).
- */
-export interface CompoundInterestFutureValueResult {
-    /** Future value (principal + contributions + interest), in USD. */
-    futureValue: number;
-    /** Total contributed (principal + sum of monthly contributions over the period), in USD. */
-    totalContributions: number;
-    /** Interest earned (futureValue - totalContributions), in USD. */
-    interestEarned: number;
-}
-/**
- * Compute the future value of a compound-interest investment with optional
- * regular monthly contributions.
- *
- * 1-to-1 port of site/src/pages/compound-interest-calculator/compound-interest-calculator.js
- * function `calculateFutureValue`. Site uses `annualRate` as decimal; this engine
- * accepts whole-number percent and converts internally so the contract is
- * Percent-suffix consistent (ADR-0039).
- */
-export declare function futureValue(input: CompoundInterestFutureValueInput): CompoundInterestFutureValueResult;
-//# sourceMappingURL=compoundInterest.d.ts.map

package/dist/engines/compoundInterest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compoundInterest.d.ts","sourceRoot":"","sources":["../../src/engines/compoundInterest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAgC;IAC/C,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,oBAAoB,EAAE,yBAAyB,CAAC;IAChD,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,gCAAgC,GACtC,iCAAiC,CAyCnC"}

package/dist/engines/compoundInterest.js

@@ -1,74 +0,0 @@
-/**
- * Compound-interest engine — lifted from
- * site/src/pages/compound-interest-calculator/compound-interest-calculator.js
- * (function `calculateFutureValue`).
- *
- * Per ADR-0039 § 5: pure synchronous functions, ENGINE_VERSION constant,
- * parity test against the site source as the gate.
- *
- * Math reference:
- *   FV_principal = P * (1 + r/n)^(nt)
- *   FV_contributions = PMT_per_period * [((1 + r/n)^(nt) - 1) / (r/n)]   (if r > 0)
- *   FV_contributions = PMT_per_period * (n * t)                           (if r == 0)
- *   where:
- *     P  = initial principal
- *     PMT_per_period = monthlyContribution * (12 / n)
- *     r  = annual rate as decimal (e.g., 0.07 for 7%)
- *     n  = compounding periods per year
- *     t  = years
- *
- * The engine accepts the rate as a percent and compounding as a label
- * (per ADR-0039 § 2 Percent-suffix convention + sprint prompt enum).
- */
-import { COMPOUNDING_FREQUENCY, } from "../shared/bounds.js";
-/**
- * SemVer of the compound-interest engine math. Per ADR-0039 § 5 (reaffirmed in
- * ADR-0041 Position #4a): major bump = math change; minor = additive output;
- * patch = numerical correction. NOT bumped for cosmetic refactors.
- * - 0.1.0: initial v1 lift from compound-interest-calculator.js (S135 Item 5).
- * - 0.2.0 (v0.1.0 publish): out-of-policy package-surface bump — superseded.
- * - 1.0.0 (v0.2.0 publish): one-time reset to align with ADR-0039 § 5 per ADR-0041 D4a.
- *   Math unchanged from 0.1.0 / 0.2.0.
- */
-export const ENGINE_VERSION = "1.0.0";
-/**
- * Compute the future value of a compound-interest investment with optional
- * regular monthly contributions.
- *
- * 1-to-1 port of site/src/pages/compound-interest-calculator/compound-interest-calculator.js
- * function `calculateFutureValue`. Site uses `annualRate` as decimal; this engine
- * accepts whole-number percent and converts internally so the contract is
- * Percent-suffix consistent (ADR-0039).
- */
-export function futureValue(input) {
-    const { principal, annualRatePercent, years, compoundingFrequency, monthlyContribution = 0, } = input;
-    // Percent → decimal at the engine boundary.
-    const r = annualRatePercent / 100;
-    const n = COMPOUNDING_FREQUENCY[compoundingFrequency];
-    const t = years;
-    const periods = n * t;
-    const periodicRate = r / n;
-    // FV of principal.
-    const fvPrincipal = principal * Math.pow(1 + periodicRate, periods);
-    // FV of regular contributions (annuity-due-like, contributions split per period).
-    const contributionPerPeriod = monthlyContribution * (12 / n);
-    let fvContributions = 0;
-    if (periodicRate > 0 && contributionPerPeriod > 0) {
-        fvContributions =
-            contributionPerPeriod *
-                ((Math.pow(1 + periodicRate, periods) - 1) / periodicRate);
-    }
-    else if (contributionPerPeriod > 0) {
-        // 0% rate: contributions just sum.
-        fvContributions = contributionPerPeriod * periods;
-    }
-    const futureValueTotal = fvPrincipal + fvContributions;
-    const totalContributions = principal + monthlyContribution * 12 * t;
-    const interestEarned = futureValueTotal - totalContributions;
-    return {
-        futureValue: futureValueTotal,
-        totalContributions,
-        interestEarned,
-    };
-}
-//# sourceMappingURL=compoundInterest.js.map

package/dist/engines/compoundInterest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compoundInterest.js","sourceRoot":"","sources":["../../src/engines/compoundInterest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,qBAAqB,GAEtB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAmCtC;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,KAAuC;IAEvC,MAAM,EACJ,SAAS,EACT,iBAAiB,EACjB,KAAK,EACL,oBAAoB,EACpB,mBAAmB,GAAG,CAAC,GACxB,GAAG,KAAK,CAAC;IAEV,4CAA4C;IAC5C,MAAM,CAAC,GAAG,iBAAiB,GAAG,GAAG,CAAC;IAClC,MAAM,CAAC,GAAG,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,KAAK,CAAC;IAEhB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC;IAE3B,mBAAmB;IACnB,MAAM,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,OAAO,CAAC,CAAC;IAEpE,kFAAkF;IAClF,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,YAAY,GAAG,CAAC,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;QAClD,eAAe;YACb,qBAAqB;gBACrB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;QACrC,mCAAmC;QACnC,eAAe,GAAG,qBAAqB,GAAG,OAAO,CAAC;IACpD,CAAC;IAED,MAAM,gBAAgB,GAAG,WAAW,GAAG,eAAe,CAAC;IACvD,MAAM,kBAAkB,GAAG,SAAS,GAAG,mBAAmB,GAAG,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IAE7D,OAAO;QACL,WAAW,EAAE,gBAAgB;QAC7B,kBAAkB;QAClB,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/engines/data/federalTax.d.ts

@@ -1,47 +0,0 @@
-/**
- * Self-contained 2026 federal tax data subset for the @markcolabs/mcp
- * package's paycheck engine.
- *
- * Mirrored from site/src/data/annual-limits.js. See engines/data/ssa.ts for the
- * full rationale on the mirror pattern (npm consumers cannot reach site/src/).
- *
- * Filing status keys mirror the paycheck engine's camelCase convention:
- *   "single" | "married" | "marriedSeparate" | "headOfHousehold"
- *
- * Source of truth: IRS Rev. Proc. 2025-32 (2026 inflation adjustments).
- * Last verified: 2026-05-09.
- */
-import { SS_WAGE_BASE } from "./ssa.js";
-export type FilingStatus = "single" | "married" | "marriedSeparate" | "headOfHousehold";
-/** FICA statutory rates (unchanged since 1990 / ACA 2013). */
-export declare const FICA_RATES: {
-    readonly socialSecurityRate: 0.062;
-    readonly medicareRate: 0.0145;
-    readonly additionalMedicareRate: 0.009;
-};
-/** Additional Medicare Tax 0.9% kicks in above these wage thresholds (filing-status keyed). */
-export declare const ADDITIONAL_MEDICARE_THRESHOLDS_2026: Record<FilingStatus, number>;
-/** 2026 standard deductions (IRS Rev. Proc. 2025-32). */
-export declare const STANDARD_DEDUCTIONS_2026: Record<FilingStatus, number>;
-/** Tax bracket entry. `max: null` indicates the top open-ended bracket. */
-export interface TaxBracket {
-    min: number;
-    max: number | null;
-    rate: number;
-    /** Cumulative tax at this bracket's floor (Percentage Method). */
-    baseTax: number;
-}
-/**
- * 2026 federal tax brackets (IRS Rev. Proc. 2025-32; verified AL-2026-001 S134).
- * Filing-status keyed; values match site/src/data/annual-limits.js TAX_BRACKETS[2026].
- */
-export declare const FEDERAL_TAX_BRACKETS_2026: Record<FilingStatus, TaxBracket[]>;
-/** Pay periods per year. Matches site/src/utils/paycheck-tax-engine.js PAY_PERIODS. */
-export declare const PAY_PERIODS_PER_YEAR: Record<"weekly" | "biweekly" | "semimonthly" | "monthly" | "quarterly" | "annual", number>;
-export type PayFrequencyLabel = keyof typeof PAY_PERIODS_PER_YEAR;
-/** US states with no income tax (paycheck engine NO_TAX_STATES). */
-export declare const NO_TAX_STATES: readonly ["AK", "FL", "NV", "NH", "SD", "TN", "TX", "WA", "WY"];
-export type NoTaxStateCode = (typeof NO_TAX_STATES)[number];
-/** Re-export SS wage base for paycheck engine (FICA SS cap). */
-export { SS_WAGE_BASE };
-//# sourceMappingURL=federalTax.d.ts.map

package/dist/engines/data/federalTax.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"federalTax.d.ts","sourceRoot":"","sources":["../../../src/engines/data/federalTax.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAExF,8DAA8D;AAC9D,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,+FAA+F;AAC/F,eAAO,MAAM,mCAAmC,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAK5E,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKjE,CAAC;AAEF,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,YAAY,EAAE,UAAU,EAAE,CAqCxE,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,EAC1E,MAAM,CAQP,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAElE,oEAAoE;AACpE,eAAO,MAAM,aAAa,iEAUhB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,gEAAgE;AAChE,OAAO,EAAE,YAAY,EAAE,CAAC"}