@stithy/mileage 0.1.0

package/dist/server.js

@@ -0,0 +1,348 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { verifyLicense } from "@mcp_marketplace/license";
+import { z } from "zod";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { openDb, VALID_CATEGORIES } from "./db.js";
+import { Store } from "./store.js";
+import { knownYears } from "./rates.js";
+const SLUG = "stithy-mileage";
+const SKIP_LICENSE = process.env.STITHY_SKIP_LICENSE === "1";
+if (!SKIP_LICENSE) {
+    const result = await verifyLicense({ slug: SLUG });
+    if (!result.valid) {
+        console.error(`Stithy Mileage: license check failed (${result.reason ?? "unknown"}).\n` +
+            `Set MCP_LICENSE_KEY in your environment.\n` +
+            `Get a key: https://mcp-marketplace.io/${SLUG}`);
+        process.exit(1);
+    }
+}
+const dbPath = process.env.STITHY_MILEAGE_DB ?? join(homedir(), ".stithy", "mileage.db");
+const db = openDb(dbPath);
+const store = new Store(db);
+const server = new McpServer({ name: "stithy-mileage", version: "0.1.0" }, {
+    instructions: "IRS-audit-proof mileage tracker. Workflow: add_vehicle (set is_default=true) once, then add_trip whenever you drive for business / medical / charitable / moving (military). At tax time, run annual_deduction year=YYYY for the Schedule C number. export_csv produces the audit-trail file. Trip dates must be ISO yyyy-mm-dd.",
+});
+const ISO_DATE = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "must be ISO yyyy-mm-dd");
+const categoryEnum = z.enum(VALID_CATEGORIES);
+function err(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+function fail(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+// -- vehicle tools --
+server.registerTool("add_vehicle", {
+    title: "Add Vehicle",
+    description: "Register a vehicle for mileage tracking. Set is_default=true on your primary vehicle so add_trip can omit vehicle_id.",
+    inputSchema: {
+        name: z.string().min(1).max(100),
+        year: z.number().int().min(1900).max(2100).optional(),
+        make: z.string().max(50).optional(),
+        model: z.string().max(50).optional(),
+        license_plate: z.string().max(20).optional(),
+        placed_in_service_date: ISO_DATE.optional(),
+        is_default: z.boolean().optional(),
+    },
+}, async (args) => {
+    try {
+        const v = store.addVehicle(args);
+        return ok(`Added '${v.name}'${v.is_default ? " (default)" : ""}. id: ${v.id}`);
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("list_vehicles", {
+    title: "List Vehicles",
+    description: "All registered vehicles. Default first.",
+    inputSchema: {},
+}, async () => {
+    try {
+        const vs = store.listVehicles();
+        if (vs.length === 0)
+            return ok("No vehicles. Run add_vehicle first.");
+        return ok(vs
+            .map((v) => `- ${v.is_default ? "★ " : "  "}${v.name}` +
+            (v.year || v.make || v.model
+                ? ` (${[v.year, v.make, v.model].filter(Boolean).join(" ")})`
+                : "") +
+            (v.license_plate ? ` [${v.license_plate}]` : "") +
+            `\n    id: ${v.id}`)
+            .join("\n"));
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("set_default_vehicle", {
+    title: "Set Default Vehicle",
+    description: "Make this vehicle the default used by add_trip when no vehicle_id is given.",
+    inputSchema: { id: z.string() },
+}, async ({ id }) => {
+    try {
+        const v = store.setDefaultVehicle(id);
+        return v ? ok(`'${v.name}' is now the default.`) : fail("Vehicle not found.");
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("remove_vehicle", {
+    title: "Remove Vehicle",
+    description: "Delete a vehicle. Fails if any trips reference it — delete trips first.",
+    inputSchema: { id: z.string() },
+}, async ({ id }) => {
+    try {
+        const okRm = store.removeVehicle(id);
+        return okRm ? ok(`Removed ${id}.`) : fail("Vehicle not found.");
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+// -- trip tools --
+server.registerTool("add_trip", {
+    title: "Add Trip",
+    description: "Log one trip. trip_date must be ISO yyyy-mm-dd. category is business / medical / moving / charitable. If vehicle_id omitted, uses the default vehicle.",
+    inputSchema: {
+        trip_date: ISO_DATE,
+        miles: z.number().positive().max(5000),
+        category: categoryEnum,
+        purpose: z.string().min(1).max(500),
+        vehicle_id: z.string().optional(),
+        start_location: z.string().max(200).optional(),
+        end_location: z.string().max(200).optional(),
+        notes: z.string().max(1000).optional(),
+    },
+}, async (args) => {
+    try {
+        const t = store.addTrip(args);
+        return ok(`Logged ${t.miles}mi on ${t.trip_date} (${t.category}) — ${t.purpose}. id: ${t.id}`);
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("update_trip", {
+    title: "Update Trip",
+    description: "Patch fields on a trip.",
+    inputSchema: {
+        id: z.string(),
+        trip_date: ISO_DATE.optional(),
+        miles: z.number().positive().max(5000).optional(),
+        category: categoryEnum.optional(),
+        purpose: z.string().min(1).max(500).optional(),
+        vehicle_id: z.string().optional(),
+        start_location: z.string().max(200).nullable().optional(),
+        end_location: z.string().max(200).nullable().optional(),
+        notes: z.string().max(1000).nullable().optional(),
+    },
+}, async ({ id, ...patch }) => {
+    try {
+        const t = store.updateTrip(id, patch);
+        return t ? ok(`Updated ${id}.`) : fail("Trip not found.");
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("delete_trip", {
+    title: "Delete Trip",
+    description: "Delete a trip permanently.",
+    inputSchema: { id: z.string() },
+}, async ({ id }) => {
+    try {
+        const okDel = store.deleteTrip(id);
+        return okDel ? ok(`Deleted ${id}.`) : fail("Trip not found.");
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("list_trips", {
+    title: "List Trips",
+    description: "List trips, newest first, optionally filtered by date range, category, or vehicle.",
+    inputSchema: {
+        from_date: ISO_DATE.optional(),
+        to_date: ISO_DATE.optional(),
+        category: categoryEnum.optional(),
+        vehicle_id: z.string().optional(),
+        limit: z.number().int().min(1).max(1000).optional(),
+        offset: z.number().int().min(0).optional(),
+    },
+}, async (args) => {
+    try {
+        const trips = store.listTrips(args);
+        if (trips.length === 0)
+            return ok("No trips match.");
+        const lines = trips.map((t) => `- ${t.trip_date} | ${t.miles}mi | ${t.category.padEnd(10)} | ${t.purpose}` +
+            (t.start_location && t.end_location
+                ? `\n    ${t.start_location} → ${t.end_location}`
+                : "") +
+            `\n    id: ${t.id}`);
+        return ok(lines.join("\n"));
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+// -- odometer --
+server.registerTool("log_odometer", {
+    title: "Log Odometer Reading",
+    description: "Record a year-start, year-end, or interim odometer reading. The IRS strongly recommends yearly endpoints for substantiation.",
+    inputSchema: {
+        vehicle_id: z.string(),
+        snapshot_date: ISO_DATE,
+        reading: z.number().int().min(0),
+        note: z.string().max(200).optional(),
+    },
+}, async (args) => {
+    try {
+        const o = store.addOdometer(args);
+        return ok(`Logged odometer ${o.reading} on ${o.snapshot_date}.`);
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("list_odometer", {
+    title: "List Odometer Readings",
+    description: "Show all odometer snapshots for a vehicle, oldest first.",
+    inputSchema: { vehicle_id: z.string() },
+}, async ({ vehicle_id }) => {
+    try {
+        const snaps = store.listOdometers(vehicle_id);
+        if (snaps.length === 0)
+            return ok("No readings.");
+        return ok(snaps
+            .map((s) => `- ${s.snapshot_date} | ${s.reading.toLocaleString()}${s.note ? ` | ${s.note}` : ""}`)
+            .join("\n"));
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+// -- summaries --
+server.registerTool("mileage_summary", {
+    title: "Mileage Summary",
+    description: "Sum miles per category for any date range. Use for monthly check-ins or quarterly estimates.",
+    inputSchema: {
+        from_date: ISO_DATE,
+        to_date: ISO_DATE,
+        vehicle_id: z.string().optional(),
+    },
+}, async (args) => {
+    try {
+        const s = store.summary(args);
+        const lines = [
+            `Range: ${args.from_date} → ${args.to_date}`,
+            `Total: ${s.total_miles.toFixed(1)} miles across ${s.total_trips} trips`,
+            ``,
+            `By category:`,
+        ];
+        for (const [cat, v] of Object.entries(s.by_category)) {
+            if (v.miles > 0) {
+                lines.push(`  ${cat.padEnd(10)} ${v.miles.toFixed(1)}mi (${v.trips} trip${v.trips === 1 ? "" : "s"})`);
+            }
+        }
+        return ok(lines.join("\n"));
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("annual_deduction", {
+    title: "Annual Tax Deduction",
+    description: "Compute the IRS standard-mileage deduction for a tax year. Multiplies miles per category × the IRS rate published for that year. Returns the dollar amount you'd put on Schedule C line 9 (business) or Schedule A (medical). Rates available for years: " +
+        knownYears().join(", "),
+    inputSchema: {
+        year: z.number().int().min(2000).max(2100),
+        vehicle_id: z.string().optional(),
+    },
+}, async ({ year, vehicle_id }) => {
+    try {
+        const r = store.annualDeduction(year, vehicle_id);
+        const lines = [
+            `Tax year ${r.year}`,
+            `Total miles: ${r.total_miles.toFixed(1)}`,
+            `Total deduction: $${r.total_deduction_dollars.toFixed(2)}`,
+            ``,
+            `Breakdown:`,
+        ];
+        for (const [cat, v] of Object.entries(r.by_category)) {
+            if (v.miles > 0) {
+                lines.push(`  ${cat.padEnd(10)} ${v.miles.toFixed(1)}mi × ${v.rate_cents_per_mile}¢/mi = $${v.deduction_dollars.toFixed(2)} (${v.trips} trip${v.trips === 1 ? "" : "s"})`);
+            }
+        }
+        lines.push("");
+        lines.push("Schedule C line 9 = the 'business' row above.");
+        lines.push("Schedule A medical = the 'medical' row above (only if itemizing).");
+        lines.push("Reminder: standard-mileage method requires you DID NOT take actual-expense in year 1.");
+        return ok(lines.join("\n"));
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("export_csv", {
+    title: "Export CSV",
+    description: "IRS-audit-ready CSV: Date, Miles, Category, Purpose, Start, End, Vehicle, Notes. Filter by date range, category, or vehicle.",
+    inputSchema: {
+        from_date: ISO_DATE.optional(),
+        to_date: ISO_DATE.optional(),
+        category: categoryEnum.optional(),
+        vehicle_id: z.string().optional(),
+    },
+}, async (args) => {
+    try {
+        const csv = store.exportCsv(args);
+        return ok(csv);
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+server.registerTool("irs_rates", {
+    title: "IRS Standard Mileage Rates",
+    description: "Reference: IRS standard-mileage rates per year, in cents per mile.",
+    inputSchema: { year: z.number().int().min(2000).max(2100).optional() },
+}, async ({ year }) => {
+    try {
+        const { RATES } = await import("./rates.js");
+        const lines = [`Year     Business  Medical  Moving  Charitable`];
+        const years = year ? [year] : Object.keys(RATES).map(Number).sort();
+        for (const y of years) {
+            const r = RATES[y];
+            if (!r) {
+                lines.push(`${y}     (no rate published yet)`);
+                continue;
+            }
+            lines.push(`${y}     ${r.business.toString().padEnd(8)}  ${r.medical.toString().padEnd(7)}  ${r.moving.toString().padEnd(6)}  ${r.charitable}`);
+        }
+        lines.push("(All values in cents per mile.)");
+        return ok(lines.join("\n"));
+    }
+    catch (e) {
+        return fail(err(e));
+    }
+});
+const shutdown = (sig) => {
+    console.error(`stithy-mileage: ${sig}, closing db`);
+    try {
+        db.close();
+    }
+    catch { }
+    process.exit(0);
+};
+process.on("SIGINT", () => shutdown("SIGINT"));
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error(`stithy-mileage v0.1.0 ready (db: ${dbPath})`);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,126 @@
+import type Database from "better-sqlite3";
+import { type Category } from "./rates.js";
+export interface Vehicle {
+    id: string;
+    name: string;
+    year: number | null;
+    make: string | null;
+    model: string | null;
+    license_plate: string | null;
+    is_default: boolean;
+    placed_in_service_date: number | null;
+    created_at: number;
+}
+export interface Trip {
+    id: string;
+    vehicle_id: string;
+    trip_date: string;
+    miles: number;
+    category: Category;
+    purpose: string;
+    start_location: string | null;
+    end_location: string | null;
+    notes: string | null;
+    created_at: number;
+}
+export interface OdometerSnapshot {
+    id: string;
+    vehicle_id: string;
+    snapshot_date: string;
+    reading: number;
+    note: string | null;
+    created_at: number;
+}
+export declare class Store {
+    private readonly db;
+    constructor(db: Database.Database);
+    addVehicle(input: {
+        name: string;
+        year?: number;
+        make?: string;
+        model?: string;
+        license_plate?: string;
+        placed_in_service_date?: string;
+        is_default?: boolean;
+    }): Vehicle;
+    getVehicle(id: string): Vehicle | null;
+    listVehicles(): Vehicle[];
+    setDefaultVehicle(id: string): Vehicle | null;
+    defaultVehicle(): Vehicle | null;
+    removeVehicle(id: string): boolean;
+    addTrip(input: {
+        vehicle_id?: string;
+        trip_date: string;
+        miles: number;
+        category: string;
+        purpose: string;
+        start_location?: string;
+        end_location?: string;
+        notes?: string;
+    }): Trip;
+    getTrip(id: string): Trip | null;
+    updateTrip(id: string, patch: Partial<{
+        trip_date: string;
+        miles: number;
+        category: string;
+        purpose: string;
+        start_location: string | null;
+        end_location: string | null;
+        notes: string | null;
+        vehicle_id: string;
+    }>): Trip | null;
+    deleteTrip(id: string): boolean;
+    listTrips(filter?: {
+        from_date?: string;
+        to_date?: string;
+        category?: string;
+        vehicle_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Trip[];
+    addOdometer(input: {
+        vehicle_id: string;
+        snapshot_date: string;
+        reading: number;
+        note?: string;
+    }): OdometerSnapshot;
+    listOdometers(vehicle_id: string): OdometerSnapshot[];
+    /**
+     * Sum miles per category for a date range. Use this for monthly check-ins.
+     */
+    summary(input: {
+        from_date: string;
+        to_date: string;
+        vehicle_id?: string;
+    }): {
+        by_category: Record<Category, {
+            miles: number;
+            trips: number;
+        }>;
+        total_miles: number;
+        total_trips: number;
+    };
+    /**
+     * Annual deduction for a tax year: miles per category × IRS rate for that year.
+     */
+    annualDeduction(year: number, vehicle_id?: string): {
+        year: number;
+        by_category: Record<Category, {
+            miles: number;
+            trips: number;
+            rate_cents_per_mile: number;
+            deduction_dollars: number;
+        }>;
+        total_miles: number;
+        total_deduction_dollars: number;
+    };
+    /**
+     * IRS-audit-ready CSV. One row per trip. Header row matches what an auditor expects:
+     * Date | Miles | Category | Purpose | Start | End | Vehicle | Notes
+     */
+    exportCsv(filter?: {
+        from_date?: string;
+        to_date?: string;
+        vehicle_id?: string;
+    }): string;
+}