@stithy/mileage 0.1.0

package/LICENSE

@@ -0,0 +1,26 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Stithy
+Licensed Work:        @stithy/memory
+                      Copyright (c) 2026 Stithy
+Additional Use Grant: You may use the Licensed Work for non-production
+                      use, internal evaluation, and personal projects
+                      free of charge. Production use by organizations
+                      with annual revenue over $1M USD requires a
+                      commercial license purchased through the MCP
+                      Marketplace or directly from Stithy.
+
+Change Date:          2028-04-12
+Change License:       Apache License, Version 2.0
+
+For full BSL 1.1 terms see: https://mariadb.com/bsl11/
+
+---
+
+Notice
+
+The Business Source License (this document, or the "License") is not an
+Open Source license. However, the Licensed Work will eventually be made
+available under an Open Source License, as stated in this License.

package/README.md

@@ -0,0 +1,75 @@
+# @stithy/mileage
+
+> IRS-audit-proof mileage tracking. Log every business mile in your AI client. Get a Schedule C export at tax time. No app, no cloud, no monthly fee.
+
+Stithy Mileage is a local-first MCP server for tracking deductible vehicle mileage. Every trip lives in a SQLite database on your laptop. Tax-year deductions are computed using the actual IRS standard mileage rate for that year — public-domain data, baked in.
+
+## Outcomes
+
+- **Stop missing deductions.** The average self-employed driver leaves $1,500-$3,000 on the table because they didn't log trips. Talk to Claude. Trip's logged.
+- **Stop paying $5-10/mo for an app you barely open.** MileIQ, Everlance, Driversnote — replaced by one MCP install.
+- **Audit-proof your log.** Per-trip date, miles, category, purpose, start/end, and vehicle — exactly what the IRS asks for during an audit.
+- **No cloud sync issues.** Your trip data lives on your machine. You own it. You back it up.
+
+## Install
+
+```
+npx -y @stithy/mileage install
+```
+
+Then in your AI client:
+
+```
+add_vehicle name="My truck" make=Toyota model=Tacoma year=2019 is_default=true
+add_trip trip_date=2026-04-01 miles=23 category=business purpose="client visit, downtown"
+```
+
+At tax time:
+
+```
+annual_deduction year=2026
+export_csv from_date=2026-01-01 to_date=2026-12-31
+```
+
+## Tools (14)
+
+| Tool | Purpose |
+|---|---|
+| `add_vehicle` | Register a vehicle (year/make/model optional) |
+| `list_vehicles` | All vehicles, default first |
+| `set_default_vehicle` | Pick which vehicle add_trip uses by default |
+| `remove_vehicle` | Delete (blocks if trips reference it) |
+| `add_trip` | Log a trip — date, miles, category, purpose |
+| `update_trip` | Patch a trip |
+| `delete_trip` | Remove a trip |
+| `list_trips` | List with optional date/category/vehicle filters |
+| `log_odometer` | Year-start / year-end odometer reading |
+| `list_odometer` | All readings for a vehicle, oldest first |
+| `mileage_summary` | Total miles per category for any date range |
+| `annual_deduction` | IRS-rate × miles for a tax year (Schedule C number) |
+| `export_csv` | Audit-trail CSV: Date, Miles, Category, Purpose, Start, End, Vehicle, Notes |
+| `irs_rates` | Reference: IRS standard mileage rates by year |
+
+## IRS Standard Mileage Rates Built-In
+
+Categories supported: **business**, **medical**, **moving** (active-duty military only since TCJA 2017), **charitable**.
+
+Rates baked in for years 2022-2026 (from public IRS publications). When the IRS publishes the next year's rate (typically December), `@stithy/mileage` ships a one-line update. No subscription required to receive it.
+
+## Privacy
+
+Everything is local. Writes to `~/.stithy/mileage.db` (override with `STITHY_MILEAGE_DB`). Nothing is sent to Stithy or any third party. No telemetry. No cloud backup. No analytics.
+
+## Compliance Notes
+
+- This tool computes mileage deductions using the IRS standard-mileage method.
+- The IRS requires you choose between standard-mileage and actual-expense in Year 1 of placing a vehicle in service. Standard-mileage is binding only if elected first; otherwise you can switch only with restrictions. Talk to your CPA.
+- This is software, not tax advice. Always verify deductions with a qualified preparer before filing.
+
+## License
+
+[BUSL-1.1](./LICENSE). Free for personal and commercial use under $1M annual revenue. Commercial license via mcp-marketplace.io.
+
+## Maintained
+
+Active maintenance, 7-day bug-fix turnaround, 30-day refund. Annual IRS rate refresh shipped within 1 week of IRS publication. Issues: https://github.com/resolceo-ai/stithy-mcp/issues

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+const cmd = process.argv[2];
+if (cmd === "install" || cmd === "uninstall" || cmd === "list") {
+    await import("./install.js");
+}
+else if (cmd === "license") {
+    const { verifyLicense } = await import("@mcp_marketplace/license");
+    const r = await verifyLicense({ slug: "stithy-mileage" });
+    if (r.valid) {
+        console.log(`Licensed (server_id: ${r.server_id ?? "n/a"})`);
+        if (r.expires_at)
+            console.log(`Expires: ${r.expires_at}`);
+    }
+    else {
+        console.log(`Not licensed: ${r.reason ?? "unknown"}`);
+        console.log(`Set MCP_LICENSE_KEY in your environment.`);
+        console.log(`Get a key: https://mcp-marketplace.io/stithy-mileage`);
+    }
+}
+else if (cmd === "--help" || cmd === "-h" || cmd === "help") {
+    console.log(`stithy-mileage — IRS-audit-proof mileage tracker MCP server
+
+Usage:
+  npx @stithy/mileage                    Run the MCP server (stdio transport)
+  npx @stithy/mileage install            Install into all detected AI clients
+  npx @stithy/mileage install --force    Overwrite existing config
+  npx @stithy/mileage list               Show install status for each client
+  npx @stithy/mileage uninstall          Remove from all detected clients
+  npx @stithy/mileage license            Check license status
+
+Environment:
+  MCP_LICENSE_KEY      Marketplace license key (required to run server)
+  STITHY_MILEAGE_DB    Path to SQLite db (default: ~/.stithy/mileage.db)
+  STITHY_SKIP_LICENSE  Set to 1 to bypass license check (dev/test only)
+
+Docs: https://github.com/resolceo-ai/stithy-mcp
+`);
+}
+else {
+    await import("./server.js");
+}
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE5B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;IAC/D,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;AAC/B,CAAC;KAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;IAC7B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;KAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;CAgBb,CAAC,CAAC;AACH,CAAC;KAAM,CAAC;IACN,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;AAC9B,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,3 @@
+import Database from "better-sqlite3";
+export declare function openDb(path: string): Database.Database;
+export declare const VALID_CATEGORIES: readonly ["business", "medical", "moving", "charitable"];

package/dist/db.js

@@ -0,0 +1,55 @@
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+export function openDb(path) {
+    mkdirSync(dirname(path), { recursive: true });
+    const db = new Database(path);
+    db.pragma("journal_mode = WAL");
+    db.pragma("synchronous = NORMAL");
+    db.pragma("foreign_keys = ON");
+    migrate(db);
+    return db;
+}
+function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS vehicles (
+      id              TEXT PRIMARY KEY,
+      name            TEXT NOT NULL,
+      year            INTEGER,
+      make            TEXT,
+      model           TEXT,
+      license_plate   TEXT,
+      is_default      INTEGER NOT NULL DEFAULT 0,
+      placed_in_service_date INTEGER,
+      created_at      INTEGER NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS trips (
+      id              TEXT PRIMARY KEY,
+      vehicle_id      TEXT NOT NULL REFERENCES vehicles(id) ON DELETE RESTRICT,
+      trip_date       TEXT NOT NULL,             -- ISO yyyy-mm-dd, no timezone games
+      miles           REAL NOT NULL,
+      category        TEXT NOT NULL,             -- business | medical | moving | charitable
+      purpose         TEXT NOT NULL,
+      start_location  TEXT,
+      end_location    TEXT,
+      notes           TEXT,
+      created_at      INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_trips_date ON trips(trip_date);
+    CREATE INDEX IF NOT EXISTS idx_trips_vehicle ON trips(vehicle_id);
+    CREATE INDEX IF NOT EXISTS idx_trips_category ON trips(category);
+
+    CREATE TABLE IF NOT EXISTS odometer_snapshots (
+      id              TEXT PRIMARY KEY,
+      vehicle_id      TEXT NOT NULL REFERENCES vehicles(id) ON DELETE CASCADE,
+      snapshot_date   TEXT NOT NULL,
+      reading         INTEGER NOT NULL,
+      note            TEXT,
+      created_at      INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_odo_vehicle_date ON odometer_snapshots(vehicle_id, snapshot_date);
+  `);
+}
+export const VALID_CATEGORIES = ["business", "medical", "moving", "charitable"];
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAClC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO,CAAC,EAAqB;IACpC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/install.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, renameSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { dirname, join } from "node:path";
+function targets() {
+    const home = homedir();
+    const p = platform();
+    const list = [];
+    if (p === "darwin") {
+        list.push({
+            name: "Claude Desktop",
+            configPath: join(home, "Library/Application Support/Claude/claude_desktop_config.json"),
+        });
+    }
+    else if (p === "win32") {
+        const appdata = process.env.APPDATA ?? join(home, "AppData/Roaming");
+        list.push({
+            name: "Claude Desktop",
+            configPath: join(appdata, "Claude/claude_desktop_config.json"),
+        });
+    }
+    else {
+        list.push({
+            name: "Claude Desktop",
+            configPath: join(home, ".config/Claude/claude_desktop_config.json"),
+        });
+    }
+    list.push({ name: "Cursor", configPath: join(home, ".cursor/mcp.json") });
+    list.push({
+        name: "Windsurf",
+        configPath: join(home, ".codeium/windsurf/mcp_config.json"),
+    });
+    list.push({ name: "Claude Code", configPath: join(home, ".claude.json") });
+    return list;
+}
+function serverEntry() {
+    return { command: "npx", args: ["-y", "@stithy/mileage"] };
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return { ok: true, data: {} };
+    try {
+        const raw = readFileSync(path, "utf8");
+        if (raw.trim().length === 0)
+            return { ok: true, data: {} };
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return { ok: false, reason: "Existing config is not a JSON object — refusing to overwrite" };
+        }
+        return { ok: true, data: parsed };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            reason: `Existing config is not valid JSON (${e instanceof Error ? e.message : String(e)}) — refusing to overwrite`,
+        };
+    }
+}
+function writeJsonAtomic(path, data) {
+    const tmp = `${path}.stithy.tmp`;
+    const json = JSON.stringify(data, null, 2);
+    writeFileSync(tmp, json);
+    JSON.parse(readFileSync(tmp, "utf8"));
+    renameSync(tmp, path);
+}
+function backup(path) {
+    if (!existsSync(path))
+        return;
+    const bak = `${path}.stithy.bak.${Date.now()}`;
+    copyFileSync(path, bak);
+    console.log(`  backup: ${bak}`);
+}
+function installFor(t, name, force) {
+    try {
+        const result = readJson(t.configPath);
+        if (!result.ok) {
+            console.error(`✗ ${t.name}: ${result.reason}`);
+            return "error";
+        }
+        const cfg = result.data;
+        const servers = cfg["mcpServers"] ?? {};
+        if (servers[name] && !force) {
+            console.log(`✓ ${t.name}: already configured (use --force to overwrite)`);
+            return "skipped";
+        }
+        servers[name] = serverEntry();
+        cfg["mcpServers"] = servers;
+        if (existsSync(t.configPath))
+            backup(t.configPath);
+        mkdirSync(dirname(t.configPath), { recursive: true });
+        writeJsonAtomic(t.configPath, cfg);
+        console.log(`✓ ${t.name}: installed at ${t.configPath}`);
+        return "installed";
+    }
+    catch (e) {
+        console.error(`✗ ${t.name}: ${e instanceof Error ? e.message : String(e)}`);
+        return "error";
+    }
+}
+function uninstallFor(t, name) {
+    try {
+        if (!existsSync(t.configPath))
+            return false;
+        const result = readJson(t.configPath);
+        if (!result.ok) {
+            console.error(`✗ ${t.name}: ${result.reason}`);
+            return false;
+        }
+        const cfg = result.data;
+        const servers = cfg["mcpServers"] ?? {};
+        if (!servers[name])
+            return false;
+        delete servers[name];
+        cfg["mcpServers"] = servers;
+        backup(t.configPath);
+        writeJsonAtomic(t.configPath, cfg);
+        console.log(`✓ ${t.name}: removed`);
+        return true;
+    }
+    catch (e) {
+        console.error(`✗ ${t.name}: ${e instanceof Error ? e.message : String(e)}`);
+        return false;
+    }
+}
+function main() {
+    const args = process.argv.slice(2);
+    const cmd = args[0] ?? "install";
+    const force = args.includes("--force");
+    const name = "stithy-mileage";
+    if (cmd === "uninstall") {
+        console.log("Removing stithy-mileage from detected clients...");
+        for (const t of targets())
+            uninstallFor(t, name);
+        console.log("\nDone. Restart your AI client to pick up the change.");
+        return;
+    }
+    if (cmd === "list") {
+        for (const t of targets()) {
+            const present = existsSync(t.configPath);
+            let has = false;
+            let bad = false;
+            if (present) {
+                const r = readJson(t.configPath);
+                if (!r.ok) {
+                    bad = true;
+                }
+                else {
+                    const servers = r.data["mcpServers"] ?? {};
+                    has = Boolean(servers[name]);
+                }
+            }
+            const marker = bad ? "?" : has ? "✓" : present ? "·" : "—";
+            console.log(`${marker} ${t.name.padEnd(16)} ${t.configPath}${bad ? "  (config unparseable)" : ""}`);
+        }
+        return;
+    }
+    console.log("Installing stithy-mileage across detected AI clients...\n");
+    let installed = 0;
+    for (const t of targets()) {
+        const result = installFor(t, name, force);
+        if (result === "installed")
+            installed++;
+    }
+    console.log(`\nInstalled to ${installed} client${installed === 1 ? "" : "s"}.`);
+    console.log("Restart your AI client(s) to load stithy-mileage.");
+}
+main();
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/rates.d.ts

@@ -0,0 +1,22 @@
+/**
+ * IRS standard mileage rates by tax year and category, in cents per mile.
+ *
+ * Source: IRS-published standard mileage rates. These are public-domain US tax data.
+ * Update annually when the IRS publishes the new year's rates (typically December).
+ *
+ * Categories:
+ *   business   — Schedule C line 9 deduction for self-employed business miles
+ *   medical    — Schedule A medical/dental travel
+ *   moving     — Active-duty military only (post-2017 TCJA)
+ *   charitable — Statutory rate set by Congress (rarely changes)
+ */
+export type Category = "business" | "medical" | "moving" | "charitable";
+export interface YearRates {
+    business: number;
+    medical: number;
+    moving: number;
+    charitable: number;
+}
+export declare const RATES: Record<number, YearRates>;
+export declare function rateCentsPerMile(year: number, category: Category): number;
+export declare function knownYears(): number[];

package/dist/rates.js

@@ -0,0 +1,31 @@
+/**
+ * IRS standard mileage rates by tax year and category, in cents per mile.
+ *
+ * Source: IRS-published standard mileage rates. These are public-domain US tax data.
+ * Update annually when the IRS publishes the new year's rates (typically December).
+ *
+ * Categories:
+ *   business   — Schedule C line 9 deduction for self-employed business miles
+ *   medical    — Schedule A medical/dental travel
+ *   moving     — Active-duty military only (post-2017 TCJA)
+ *   charitable — Statutory rate set by Congress (rarely changes)
+ */
+export const RATES = {
+    2022: { business: 58.5, medical: 18, moving: 18, charitable: 14 },
+    2023: { business: 65.5, medical: 22, moving: 22, charitable: 14 },
+    2024: { business: 67, medical: 21, moving: 21, charitable: 14 },
+    2025: { business: 70, medical: 21, moving: 21, charitable: 14 },
+    2026: { business: 72.5, medical: 21, moving: 21, charitable: 14 },
+};
+export function rateCentsPerMile(year, category) {
+    const yr = RATES[year];
+    if (!yr) {
+        const known = Object.keys(RATES).map(Number).sort();
+        throw new Error(`No IRS rate published yet for year ${year}. Known years: ${known.join(", ")}. Use the most recent year as a placeholder if filing late.`);
+    }
+    return yr[category];
+}
+export function knownYears() {
+    return Object.keys(RATES).map(Number).sort();
+}
+//# sourceMappingURL=rates.js.map

package/dist/rates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.js","sourceRoot":"","sources":["../src/rates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,CAAC,MAAM,KAAK,GAA8B;IAC9C,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IACjE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IACjE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAC/D,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAC/D,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;CAClE,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAkB;IAC/D,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,6DAA6D,CAC1I,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};