pigeongov 0.2.0

package/dist/src/api/openapi.js

@@ -0,0 +1,384 @@
+import { listWorkflowSummaries, listDomains } from "../workflows/registry.js";
+/**
+ * Build an OpenAPI 3.1.0 spec from the current workflow registry.
+ * Intentionally minimal — no external dependencies, just data structures.
+ */
+export function generateOpenApiSpec() {
+    const workflows = listWorkflowSummaries();
+    const domains = listDomains();
+    const workflowIdEnum = workflows.map((w) => w.id);
+    return {
+        openapi: "3.1.0",
+        info: {
+            title: "PigeonGov REST API",
+            description: "Local-first API for U.S. government workflows, bundles, and forms.",
+            version: "0.2.0",
+            contact: { name: "PigeonGov", url: "https://github.com/pigeongov" },
+            license: { name: "MIT" },
+        },
+        servers: [
+            { url: "http://localhost:3847", description: "Local development" },
+        ],
+        paths: {
+            "/api/workflows": {
+                get: {
+                    operationId: "listWorkflows",
+                    summary: "List all available workflows",
+                    tags: ["workflows"],
+                    responses: {
+                        "200": {
+                            description: "List of workflow summaries",
+                            content: {
+                                "application/json": {
+                                    schema: {
+                                        type: "object",
+                                        properties: {
+                                            workflows: {
+                                                type: "array",
+                                                items: { $ref: "#/components/schemas/WorkflowSummary" },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            "/api/workflows/{id}": {
+                get: {
+                    operationId: "describeWorkflow",
+                    summary: "Describe a workflow's fields, sections, and schema",
+                    tags: ["workflows"],
+                    parameters: [
+                        {
+                            name: "id",
+                            in: "path",
+                            required: true,
+                            schema: { type: "string", enum: workflowIdEnum },
+                        },
+                    ],
+                    responses: {
+                        "200": {
+                            description: "Workflow description",
+                            content: {
+                                "application/json": {
+                                    schema: { $ref: "#/components/schemas/WorkflowDescription" },
+                                },
+                            },
+                        },
+                        "404": {
+                            description: "Workflow not found",
+                            content: {
+                                "application/json": {
+                                    schema: { $ref: "#/components/schemas/ErrorResponse" },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            "/api/workflows/{id}/fill": {
+                post: {
+                    operationId: "fillWorkflow",
+                    summary: "Build a complete workflow bundle from input data",
+                    tags: ["workflows"],
+                    parameters: [
+                        {
+                            name: "id",
+                            in: "path",
+                            required: true,
+                            schema: { type: "string", enum: workflowIdEnum },
+                        },
+                    ],
+                    requestBody: {
+                        required: true,
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    description: "Workflow-specific input data",
+                                },
+                            },
+                        },
+                    },
+                    responses: {
+                        "200": {
+                            description: "Built workflow bundle",
+                            content: {
+                                "application/json": {
+                                    schema: { $ref: "#/components/schemas/WorkflowBundle" },
+                                },
+                            },
+                        },
+                        "404": { description: "Workflow not found" },
+                        "422": { description: "Validation error" },
+                    },
+                },
+            },
+            "/api/workflows/{id}/validate": {
+                post: {
+                    operationId: "validateWorkflow",
+                    summary: "Validate input data against a workflow and return validation results",
+                    tags: ["workflows"],
+                    parameters: [
+                        {
+                            name: "id",
+                            in: "path",
+                            required: true,
+                            schema: { type: "string", enum: workflowIdEnum },
+                        },
+                    ],
+                    requestBody: {
+                        required: true,
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    description: "Workflow-specific input data",
+                                },
+                            },
+                        },
+                    },
+                    responses: {
+                        "200": {
+                            description: "Validation results",
+                            content: {
+                                "application/json": {
+                                    schema: {
+                                        type: "object",
+                                        properties: {
+                                            workflowId: { type: "string" },
+                                            validation: {
+                                                $ref: "#/components/schemas/Validation",
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        "404": { description: "Workflow not found" },
+                        "422": { description: "Schema validation error" },
+                    },
+                },
+            },
+            "/api/deadlines": {
+                get: {
+                    operationId: "listDeadlines",
+                    summary: "List upcoming workflow deadlines",
+                    tags: ["deadlines"],
+                    responses: {
+                        "200": {
+                            description: "List of deadlines",
+                            content: {
+                                "application/json": {
+                                    schema: {
+                                        type: "object",
+                                        properties: {
+                                            deadlines: {
+                                                type: "array",
+                                                items: {
+                                                    $ref: "#/components/schemas/WorkflowDeadline",
+                                                },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            "/api/openapi.json": {
+                get: {
+                    operationId: "getOpenApiSpec",
+                    summary: "This OpenAPI specification",
+                    tags: ["meta"],
+                    responses: {
+                        "200": {
+                            description: "OpenAPI 3.1 specification",
+                            content: { "application/json": { schema: { type: "object" } } },
+                        },
+                    },
+                },
+            },
+        },
+        components: {
+            schemas: {
+                WorkflowSummary: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        domain: { type: "string", enum: domains },
+                        title: { type: "string" },
+                        summary: { type: "string" },
+                        status: {
+                            type: "string",
+                            enum: ["active", "preview", "planned"],
+                        },
+                        audience: {
+                            type: "string",
+                            enum: ["individual", "household", "business"],
+                        },
+                        tags: { type: "array", items: { type: "string" } },
+                        year: { type: "number" },
+                        legacyFormId: { type: "string" },
+                    },
+                    required: ["id", "domain", "title", "summary", "status", "audience", "tags"],
+                },
+                WorkflowDescription: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        domain: { type: "string" },
+                        title: { type: "string" },
+                        summary: { type: "string" },
+                        sections: {
+                            type: "array",
+                            items: { $ref: "#/components/schemas/QuestionSection" },
+                        },
+                        inputSchema: { type: "array" },
+                        starterData: { type: "object" },
+                    },
+                },
+                QuestionSection: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        title: { type: "string" },
+                        description: { type: "string" },
+                        fields: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    key: { type: "string" },
+                                    label: { type: "string" },
+                                    type: {
+                                        type: "string",
+                                        enum: [
+                                            "text",
+                                            "textarea",
+                                            "currency",
+                                            "number",
+                                            "select",
+                                            "confirm",
+                                            "date",
+                                        ],
+                                    },
+                                    helpText: { type: "string" },
+                                    placeholder: { type: "string" },
+                                },
+                                required: ["key", "label", "type"],
+                            },
+                        },
+                    },
+                    required: ["id", "title", "fields"],
+                },
+                WorkflowBundle: {
+                    type: "object",
+                    description: "Complete workflow output bundle with evidence, validation, and review.",
+                    properties: {
+                        workflowId: { type: "string" },
+                        domain: { type: "string" },
+                        title: { type: "string" },
+                        summary: { type: "string" },
+                        household: { type: "array" },
+                        evidence: { type: "array" },
+                        answers: { type: "object" },
+                        derived: { type: "object" },
+                        validation: { $ref: "#/components/schemas/Validation" },
+                        review: { $ref: "#/components/schemas/ReviewSummary" },
+                        outputArtifacts: { type: "array" },
+                        provenance: { type: "array", items: { type: "string" } },
+                    },
+                    required: [
+                        "workflowId",
+                        "domain",
+                        "title",
+                        "summary",
+                        "validation",
+                        "review",
+                    ],
+                },
+                Validation: {
+                    type: "object",
+                    properties: {
+                        checks: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    id: { type: "string" },
+                                    label: { type: "string" },
+                                    passed: { type: "boolean" },
+                                    severity: {
+                                        type: "string",
+                                        enum: ["warning", "error"],
+                                    },
+                                    message: { type: "string" },
+                                },
+                            },
+                        },
+                        flaggedFields: {
+                            type: "array",
+                            items: { $ref: "#/components/schemas/ValidationFlag" },
+                        },
+                    },
+                },
+                ValidationFlag: {
+                    type: "object",
+                    properties: {
+                        field: { type: "string" },
+                        severity: {
+                            type: "string",
+                            enum: ["warning", "error", "review"],
+                        },
+                        message: { type: "string" },
+                        source: { type: "string" },
+                    },
+                    required: ["field", "severity", "message"],
+                },
+                ReviewSummary: {
+                    type: "object",
+                    properties: {
+                        headline: { type: "string" },
+                        notes: { type: "array", items: { type: "string" } },
+                        flaggedFields: {
+                            type: "array",
+                            items: { $ref: "#/components/schemas/ValidationFlag" },
+                        },
+                    },
+                },
+                WorkflowDeadline: {
+                    type: "object",
+                    properties: {
+                        workflowId: { type: "string" },
+                        label: { type: "string" },
+                        date: { type: "string", format: "date" },
+                        type: { type: "string", enum: ["hard", "soft"] },
+                        consequence: { type: "string" },
+                        extensionAvailable: { type: "boolean" },
+                    },
+                    required: [
+                        "workflowId",
+                        "label",
+                        "date",
+                        "type",
+                        "consequence",
+                        "extensionAvailable",
+                    ],
+                },
+                ErrorResponse: {
+                    type: "object",
+                    properties: {
+                        error: { type: "string" },
+                        message: { type: "string" },
+                    },
+                    required: ["error", "message"],
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=openapi.js.map

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

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

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

@@ -0,0 +1,19 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
+export interface Route {
+    method: "GET" | "POST";
+    pattern: RegExp;
+    handler: (req: IncomingMessage, res: ServerResponse, params: Record<string, string>) => Promise<void>;
+}
+export declare function createRouter(routes: Route[]): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+/**
+ * Read the full request body as a string.
+ */
+export declare function readBody(req: IncomingMessage): Promise<string>;
+/**
+ * Read the request body as parsed JSON.
+ */
+export declare function readJsonBody<T = unknown>(req: IncomingMessage): Promise<T>;
+/**
+ * Send a JSON response with the given status code.
+ */
+export declare function sendJson(res: ServerResponse, status: number, data: unknown): void;

package/dist/src/api/router.js

@@ -0,0 +1,57 @@
+export function createRouter(routes) {
+    return async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+        for (const route of routes) {
+            if (req.method !== route.method)
+                continue;
+            const match = url.pathname.match(route.pattern);
+            if (match) {
+                const params = {};
+                if (match.groups)
+                    Object.assign(params, match.groups);
+                try {
+                    await route.handler(req, res, params);
+                }
+                catch (err) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({
+                        error: "internal_error",
+                        message: String(err),
+                    }));
+                }
+                return;
+            }
+        }
+        res.writeHead(404, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({
+            error: "not_found",
+            message: `${req.method ?? "UNKNOWN"} ${url.pathname} not found`,
+        }));
+    };
+}
+/**
+ * Read the full request body as a string.
+ */
+export function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        req.on("error", reject);
+    });
+}
+/**
+ * Read the request body as parsed JSON.
+ */
+export async function readJsonBody(req) {
+    const raw = await readBody(req);
+    return JSON.parse(raw);
+}
+/**
+ * Send a JSON response with the given status code.
+ */
+export function sendJson(res, status, data) {
+    res.writeHead(status, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(data, null, 2));
+}
+//# sourceMappingURL=router.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/api/router.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,YAAY,CAC1B,MAAe;IAEf,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;QAEjF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;gBAAE,SAAS;YAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,MAAM,GAA2B,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,MAAM;oBAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAEtD,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;gBACxC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAC3D,GAAG,CAAC,GAAG,CACL,IAAI,CAAC,SAAS,CAAC;wBACb,KAAK,EAAE,gBAAgB;wBACvB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;qBACrB,CAAC,CACH,CAAC;gBACJ,CAAC;gBACD,OAAO;YACT,CAAC;QACH,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CACL,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,SAAS,IAAI,GAAG,CAAC,QAAQ,YAAY;SAChE,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAoB;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAoB;IAEpB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAmB,EACnB,MAAc,EACd,IAAa;IAEb,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/cli/commands/completions.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerCompletionsCommand(program: Command): void;