pigeongov 0.2.0

package/dist/src/analytics/stats.js

@@ -0,0 +1,158 @@
+import { readFile } from "node:fs/promises";
+import { getAuditLogPath } from "../storage/paths.js";
+/**
+ * Parse audit log lines into structured entries.
+ *
+ * The audit log format is one JSON object per line — each line is a
+ * timestamped record of a CLI operation. If the file doesn't exist
+ * yet (fresh install), we return an empty array and let the caller
+ * produce sensible zero-state output.
+ */
+async function readAuditEntries() {
+    const logPath = getAuditLogPath();
+    let raw;
+    try {
+        raw = await readFile(logPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Malformed line — skip it rather than crashing.
+        }
+    }
+    return entries;
+}
+/**
+ * Count files in a directory, returning 0 if the directory doesn't exist.
+ */
+async function countFilesInDir(dirPath) {
+    try {
+        const { readdir } = await import("node:fs/promises");
+        const entries = await readdir(dirPath);
+        return entries.length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Collect local usage statistics from the audit log and storage dirs.
+ */
+export async function getLocalStats() {
+    const entries = await readAuditEntries();
+    let workflowsCompleted = 0;
+    let documentsProcessed = 0;
+    let totalIncomeProcessed = 0;
+    let lastActivity = "";
+    const workflowsByDomain = {};
+    const commandCounts = {};
+    for (const entry of entries) {
+        // Track the most recent timestamp
+        if (entry.timestamp && entry.timestamp > lastActivity) {
+            lastActivity = entry.timestamp;
+        }
+        // Count commands
+        if (entry.command) {
+            commandCounts[entry.command] = (commandCounts[entry.command] ?? 0) + 1;
+        }
+        // Count completed workflows
+        if (entry.command === "fill" ||
+            entry.command === "start" ||
+            entry.workflowId) {
+            workflowsCompleted += 1;
+            // Track domain breakdown
+            const domain = entry.domain ?? entry.workflowId?.split("/")[0] ?? "unknown";
+            workflowsByDomain[domain] = (workflowsByDomain[domain] ?? 0) + 1;
+        }
+        // Accumulate document and income counts
+        if (entry.documentsImported) {
+            documentsProcessed += entry.documentsImported;
+        }
+        if (entry.incomeTotal) {
+            totalIncomeProcessed += entry.incomeTotal;
+        }
+        // Also count explicit extract commands
+        if (entry.command === "extract") {
+            documentsProcessed += 1;
+        }
+    }
+    // Count drafts and vault items from the filesystem
+    const { getDraftsDir, getVaultDir } = await import("../storage/paths.js");
+    const draftCount = await countFilesInDir(getDraftsDir());
+    const vaultItemCount = await countFilesInDir(getVaultDir());
+    return {
+        workflowsCompleted,
+        documentsProcessed,
+        totalIncomeProcessed,
+        workflowsByDomain,
+        commandCounts,
+        lastActivity: lastActivity || "never",
+        draftCount,
+        vaultItemCount,
+    };
+}
+const currencyFormatter = new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    maximumFractionDigits: 0,
+});
+/**
+ * Format stats for human-readable terminal output.
+ */
+export function formatStats(stats) {
+    const lines = [];
+    lines.push("PigeonGov Local Statistics");
+    lines.push("=".repeat(40));
+    lines.push("");
+    // Main counts
+    lines.push(`Workflows completed:   ${stats.workflowsCompleted}`);
+    lines.push(`Documents processed:   ${stats.documentsProcessed}`);
+    lines.push(`Drafts in progress:    ${stats.draftCount}`);
+    lines.push(`Vault items stored:    ${stats.vaultItemCount}`);
+    lines.push(`Last activity:         ${stats.lastActivity === "never" ? "never" : new Date(stats.lastActivity).toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric" })}`);
+    // Income stat — the fun one
+    if (stats.totalIncomeProcessed > 0) {
+        lines.push("");
+        lines.push(`Total income processed: ${currencyFormatter.format(stats.totalIncomeProcessed)}`);
+        if (stats.workflowsByDomain["tax"]) {
+            const taxReturns = stats.workflowsByDomain["tax"];
+            lines.push(`  across ${taxReturns} tax return${taxReturns === 1 ? "" : "s"} — ` +
+                `that's ${currencyFormatter.format(stats.totalIncomeProcessed / taxReturns)} avg per return`);
+        }
+    }
+    // Domain breakdown
+    const domains = Object.entries(stats.workflowsByDomain).sort((a, b) => b[1] - a[1]);
+    if (domains.length > 0) {
+        lines.push("");
+        lines.push("Workflows by domain:");
+        for (const [domain, count] of domains) {
+            const bar = "#".repeat(Math.min(count, 30));
+            lines.push(`  ${domain.padEnd(16)} ${String(count).padStart(3)}  ${bar}`);
+        }
+    }
+    // Command usage breakdown
+    const commands = Object.entries(stats.commandCounts).sort((a, b) => b[1] - a[1]);
+    if (commands.length > 0) {
+        lines.push("");
+        lines.push("Most used commands:");
+        for (const [cmd, count] of commands.slice(0, 10)) {
+            lines.push(`  ${cmd.padEnd(20)} ${String(count).padStart(4)} invocations`);
+        }
+    }
+    // Zero-state message
+    if (stats.workflowsCompleted === 0 && stats.documentsProcessed === 0) {
+        lines.push("");
+        lines.push("No activity recorded yet. Run `pigeongov fill tax/1040` to get started.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=stats.js.map

package/dist/src/analytics/stats.js.map

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

package/dist/src/api/handlers/deadlines.d.ts

@@ -0,0 +1,2 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare function deadlinesHandler(_req: IncomingMessage, res: ServerResponse, _params: Record<string, string>): Promise<void>;

package/dist/src/api/handlers/deadlines.js

@@ -0,0 +1,7 @@
+import { sendJson } from "../router.js";
+import { DEFAULT_DEADLINES, getUpcomingDeadlines, } from "../../workflows/deadlines.js";
+export async function deadlinesHandler(_req, res, _params) {
+    const upcoming = getUpcomingDeadlines(DEFAULT_DEADLINES);
+    sendJson(res, 200, { deadlines: upcoming });
+}
+//# sourceMappingURL=deadlines.js.map

package/dist/src/api/handlers/deadlines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadlines.js","sourceRoot":"","sources":["../../../../src/api/handlers/deadlines.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAqB,EACrB,GAAmB,EACnB,OAA+B;IAE/B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IACzD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/api/handlers/openapi.d.ts

@@ -0,0 +1,2 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare function openapiHandler(_req: IncomingMessage, res: ServerResponse, _params: Record<string, string>): Promise<void>;

package/dist/src/api/handlers/openapi.js

@@ -0,0 +1,7 @@
+import { sendJson } from "../router.js";
+import { generateOpenApiSpec } from "../openapi.js";
+export async function openapiHandler(_req, res, _params) {
+    const spec = generateOpenApiSpec();
+    sendJson(res, 200, spec);
+}
+//# sourceMappingURL=openapi.js.map

package/dist/src/api/handlers/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../../../src/api/handlers/openapi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAqB,EACrB,GAAmB,EACnB,OAA+B;IAE/B,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/src/api/handlers/workflows.d.ts

@@ -0,0 +1,5 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare function listWorkflowsHandler(_req: IncomingMessage, res: ServerResponse, _params: Record<string, string>): Promise<void>;
+export declare function describeWorkflowHandler(_req: IncomingMessage, res: ServerResponse, params: Record<string, string>): Promise<void>;
+export declare function fillWorkflowHandler(req: IncomingMessage, res: ServerResponse, params: Record<string, string>): Promise<void>;
+export declare function validateWorkflowHandler(req: IncomingMessage, res: ServerResponse, params: Record<string, string>): Promise<void>;

package/dist/src/api/handlers/workflows.js

@@ -0,0 +1,73 @@
+import { readJsonBody, sendJson } from "../router.js";
+import { listWorkflowSummaries, describeWorkflow, buildWorkflowBundle, validateWorkflowBundle, } from "../../workflows/registry.js";
+export async function listWorkflowsHandler(_req, res, _params) {
+    const workflows = listWorkflowSummaries();
+    sendJson(res, 200, { workflows });
+}
+export async function describeWorkflowHandler(_req, res, params) {
+    const id = params["id"];
+    if (!id) {
+        sendJson(res, 400, { error: "missing_param", message: "Workflow ID is required" });
+        return;
+    }
+    try {
+        const description = describeWorkflow(id);
+        sendJson(res, 200, description);
+    }
+    catch (err) {
+        sendJson(res, 404, {
+            error: "not_found",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+export async function fillWorkflowHandler(req, res, params) {
+    const id = params["id"];
+    if (!id) {
+        sendJson(res, 400, { error: "missing_param", message: "Workflow ID is required" });
+        return;
+    }
+    let body;
+    try {
+        body = await readJsonBody(req);
+    }
+    catch {
+        sendJson(res, 400, { error: "invalid_json", message: "Request body must be valid JSON" });
+        return;
+    }
+    try {
+        const bundle = buildWorkflowBundle(id, body);
+        sendJson(res, 200, bundle);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const status = message.includes("Unsupported workflow") ? 404 : 422;
+        sendJson(res, status, { error: "build_error", message });
+    }
+}
+export async function validateWorkflowHandler(req, res, params) {
+    const id = params["id"];
+    if (!id) {
+        sendJson(res, 400, { error: "missing_param", message: "Workflow ID is required" });
+        return;
+    }
+    let body;
+    try {
+        body = await readJsonBody(req);
+    }
+    catch {
+        sendJson(res, 400, { error: "invalid_json", message: "Request body must be valid JSON" });
+        return;
+    }
+    try {
+        const bundle = buildWorkflowBundle(id, body);
+        const validation = validateWorkflowBundle(bundle);
+        sendJson(res, 200, { workflowId: id, validation });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const status = message.includes("Unsupported workflow") ? 404 : 422;
+        sendJson(res, status, { error: "validation_error", message });
+    }
+}
+//# sourceMappingURL=workflows.js.map

package/dist/src/api/handlers/workflows.js.map

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

package/dist/src/api/index.d.ts

@@ -0,0 +1,20 @@
+import { type Server } from "node:http";
+import { type Route } from "./router.js";
+/**
+ * All REST API routes.
+ *
+ * Named groups in the regex patterns get passed as `params` to handlers.
+ * The /api prefix is included in every pattern so the router can be
+ * mounted at the server root without path rewriting.
+ */
+declare const API_ROUTES: Route[];
+/**
+ * Create and start a standalone REST API server.
+ */
+export declare function startApiServer(port: number): Server;
+/**
+ * Get the raw route handler for embedding in another HTTP server
+ * (e.g. alongside the MCP server).
+ */
+export declare function getApiRouteHandler(): (req: import("http").IncomingMessage, res: import("http").ServerResponse) => Promise<void>;
+export { API_ROUTES };

package/dist/src/api/index.js

@@ -0,0 +1,70 @@
+import { createServer } from "node:http";
+import { createRouter } from "./router.js";
+import { listWorkflowsHandler, describeWorkflowHandler, fillWorkflowHandler, validateWorkflowHandler, } from "./handlers/workflows.js";
+import { deadlinesHandler } from "./handlers/deadlines.js";
+import { openapiHandler } from "./handlers/openapi.js";
+/**
+ * All REST API routes.
+ *
+ * Named groups in the regex patterns get passed as `params` to handlers.
+ * The /api prefix is included in every pattern so the router can be
+ * mounted at the server root without path rewriting.
+ */
+const API_ROUTES = [
+    // Workflows
+    {
+        method: "GET",
+        pattern: /^\/api\/workflows$/,
+        handler: listWorkflowsHandler,
+    },
+    {
+        method: "GET",
+        pattern: /^\/api\/workflows\/(?<id>[^/]+(?:\/[^/]+)?)$/,
+        handler: describeWorkflowHandler,
+    },
+    {
+        method: "POST",
+        pattern: /^\/api\/workflows\/(?<id>[^/]+(?:\/[^/]+)?)\/fill$/,
+        handler: fillWorkflowHandler,
+    },
+    {
+        method: "POST",
+        pattern: /^\/api\/workflows\/(?<id>[^/]+(?:\/[^/]+)?)\/validate$/,
+        handler: validateWorkflowHandler,
+    },
+    // Deadlines
+    {
+        method: "GET",
+        pattern: /^\/api\/deadlines$/,
+        handler: deadlinesHandler,
+    },
+    // OpenAPI spec
+    {
+        method: "GET",
+        pattern: /^\/api\/openapi\.json$/,
+        handler: openapiHandler,
+    },
+];
+const routeHandler = createRouter(API_ROUTES);
+/**
+ * Create and start a standalone REST API server.
+ */
+export function startApiServer(port) {
+    const server = createServer((req, res) => {
+        void routeHandler(req, res);
+    });
+    server.listen(port, () => {
+        console.log(`PigeonGov REST API listening on http://localhost:${port}`);
+        console.log(`  OpenAPI spec: http://localhost:${port}/api/openapi.json`);
+    });
+    return server;
+}
+/**
+ * Get the raw route handler for embedding in another HTTP server
+ * (e.g. alongside the MCP server).
+ */
+export function getApiRouteHandler() {
+    return routeHandler;
+}
+export { API_ROUTES };
+//# sourceMappingURL=index.js.map

package/dist/src/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,GAAY;IAC1B,YAAY;IACZ;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE,oBAAoB;KAC9B;IACD;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,8CAA8C;QACvD,OAAO,EAAE,uBAAuB;KACjC;IACD;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,oDAAoD;QAC7D,OAAO,EAAE,mBAAmB;KAC7B;IACD;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,wDAAwD;QACjE,OAAO,EAAE,uBAAuB;KACjC;IAED,YAAY;IACZ;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE,gBAAgB;KAC1B;IAED,eAAe;IACf;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,wBAAwB;QACjC,OAAO,EAAE,cAAc;KACxB;CACF,CAAC;AAEF,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACvC,KAAK,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACvB,OAAO,CAAC,GAAG,CAAC,oDAAoD,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,mBAAmB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/api/openapi.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Build an OpenAPI 3.1.0 spec from the current workflow registry.
+ * Intentionally minimal — no external dependencies, just data structures.
+ */
+export declare function generateOpenApiSpec(): Record<string, unknown>;