pigeongov 0.2.0

package/dist/src/pdf/writer.js

@@ -0,0 +1,311 @@
+import { readFile } from "node:fs/promises";
+import { PDFDocument, StandardFonts, rgb, } from "pdf-lib";
+import { compactTextLines, formatTemplateValue, } from "./shared.js";
+const LETTER_WIDTH = 612;
+const LETTER_HEIGHT = 792;
+const MARGIN = 48;
+async function loadPdfBytes(source) {
+    if (typeof source === "string") {
+        return new Uint8Array(await readFile(source));
+    }
+    if (source instanceof Uint8Array) {
+        return source;
+    }
+    return new Uint8Array(source);
+}
+function ensurePageSpace(pdfDoc, state, requiredSpace = 36) {
+    if (state.y > MARGIN + requiredSpace) {
+        return;
+    }
+    state.page = pdfDoc.addPage([LETTER_WIDTH, LETTER_HEIGHT]);
+    state.y = LETTER_HEIGHT - MARGIN;
+}
+function drawWrappedLines(page, text, options) {
+    const words = text.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let currentLine = "";
+    for (const word of words) {
+        const candidate = currentLine ? `${currentLine} ${word}` : word;
+        if (options.font.widthOfTextAtSize(candidate, options.size) <= options.width) {
+            currentLine = candidate;
+        }
+        else {
+            if (currentLine) {
+                lines.push(currentLine);
+            }
+            currentLine = word;
+        }
+    }
+    if (currentLine) {
+        lines.push(currentLine);
+    }
+    let currentY = options.y;
+    const lineGap = options.lineGap ?? 14;
+    for (const line of lines) {
+        page.drawText(line, {
+            x: options.x,
+            y: currentY,
+            size: options.size,
+            font: options.font,
+            color: options.color ?? rgb(0, 0, 0),
+        });
+        currentY -= lineGap;
+    }
+    return currentY;
+}
+function drawKeyValueLine(page, font, boldFont, label, value, x, y) {
+    page.drawText(`${label}:`, {
+        x,
+        y,
+        size: 11,
+        font: boldFont,
+        color: rgb(0.12, 0.12, 0.12),
+    });
+    return drawWrappedLines(page, value, {
+        x: x + 148,
+        y,
+        width: LETTER_WIDTH - MARGIN * 2 - 160,
+        font,
+        size: 11,
+        color: rgb(0.18, 0.18, 0.18),
+        lineGap: 13,
+    });
+}
+function drawSection(pdfDoc, state, title) {
+    ensurePageSpace(pdfDoc, state, 32);
+    state.y -= 8;
+    state.page.drawText(title, {
+        x: MARGIN,
+        y: state.y,
+        size: 13,
+        font: state.boldFont,
+        color: rgb(0.13, 0.13, 0.13),
+    });
+    state.y -= 18;
+}
+function drawFlaggedFields(pdfDoc, state, flaggedFields) {
+    if (flaggedFields.length === 0) {
+        state.page.drawText("None", {
+            x: MARGIN,
+            y: state.y,
+            size: 11,
+            font: state.bodyFont,
+            color: rgb(0.2, 0.45, 0.2),
+        });
+        state.y -= 18;
+        return;
+    }
+    for (const flag of flaggedFields) {
+        ensurePageSpace(pdfDoc, state, 42);
+        const bullet = flag.severity === "error" ? "!" : "•";
+        const color = flag.severity === "error"
+            ? rgb(0.75, 0.16, 0.16)
+            : flag.severity === "warning"
+                ? rgb(0.78, 0.48, 0.12)
+                : rgb(0.25, 0.32, 0.58);
+        const label = `${bullet} ${flag.field}`;
+        state.page.drawText(label, {
+            x: MARGIN,
+            y: state.y,
+            size: 11,
+            font: state.boldFont,
+            color,
+        });
+        state.y -= 13;
+        state.y = drawWrappedLines(state.page, flag.message, {
+            x: MARGIN + 14,
+            y: state.y,
+            width: LETTER_WIDTH - MARGIN * 2 - 18,
+            font: state.bodyFont,
+            size: 10.5,
+            color,
+            lineGap: 12,
+        });
+        state.y -= 6;
+    }
+}
+function sectionItemsToLines(section) {
+    return section.items.map((item) => `${item.label}: ${item.value}`);
+}
+export async function createReviewPdf(input) {
+    const pdfDoc = await PDFDocument.create();
+    pdfDoc.setTitle(input.title);
+    pdfDoc.setSubject(input.subtitle ?? "Govforms review");
+    pdfDoc.setAuthor("PigeonGov");
+    const bodyFont = await pdfDoc.embedFont(StandardFonts.Helvetica);
+    const boldFont = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+    let page = pdfDoc.addPage([LETTER_WIDTH, LETTER_HEIGHT]);
+    let y = LETTER_HEIGHT - MARGIN;
+    const state = {
+        page,
+        y,
+        bodyFont,
+        boldFont,
+    };
+    page.drawText(input.title, {
+        x: MARGIN,
+        y: state.y,
+        size: 20,
+        font: boldFont,
+        color: rgb(0.1, 0.1, 0.1),
+    });
+    state.y -= 26;
+    if (input.subtitle) {
+        state.y = drawWrappedLines(page, input.subtitle, {
+            x: MARGIN,
+            y: state.y,
+            width: LETTER_WIDTH - MARGIN * 2,
+            font: bodyFont,
+            size: 11.5,
+            color: rgb(0.35, 0.35, 0.35),
+            lineGap: 14,
+        });
+        state.y -= 6;
+    }
+    drawSection(pdfDoc, state, "Summary");
+    for (const note of input.notes) {
+        ensurePageSpace(pdfDoc, state, 20);
+        state.page.drawText(`• ${note}`, {
+            x: MARGIN,
+            y: state.y,
+            size: 11,
+            font: bodyFont,
+            color: rgb(0.18, 0.18, 0.18),
+        });
+        state.y -= 15;
+    }
+    if (input.sections?.length) {
+        for (const section of input.sections) {
+            drawSection(pdfDoc, state, section.title);
+            for (const line of sectionItemsToLines(section)) {
+                ensurePageSpace(pdfDoc, state, 18);
+                state.y = drawWrappedLines(state.page, line, {
+                    x: MARGIN,
+                    y: state.y,
+                    width: LETTER_WIDTH - MARGIN * 2,
+                    font: bodyFont,
+                    size: 11,
+                    color: rgb(0.18, 0.18, 0.18),
+                    lineGap: 13,
+                });
+                state.y -= 4;
+            }
+        }
+    }
+    drawSection(pdfDoc, state, "Flagged fields");
+    drawFlaggedFields(pdfDoc, state, input.flaggedFields);
+    if (input.footer?.length) {
+        drawSection(pdfDoc, state, "Next steps");
+        for (const line of input.footer) {
+            ensurePageSpace(pdfDoc, state, 18);
+            state.y = drawWrappedLines(state.page, line, {
+                x: MARGIN,
+                y: state.y,
+                width: LETTER_WIDTH - MARGIN * 2,
+                font: bodyFont,
+                size: 10.5,
+                color: rgb(0.22, 0.22, 0.22),
+                lineGap: 12,
+            });
+            state.y -= 4;
+        }
+    }
+    return pdfDoc.save();
+}
+export async function fillPdfTemplate(input) {
+    const bytes = await loadPdfBytes(input.template);
+    const pdfDoc = await PDFDocument.load(bytes);
+    const form = pdfDoc.getForm();
+    const existingFields = new Set(form.getFields().map((field) => field.getName()));
+    const flaggedFields = [];
+    let appliedFields = 0;
+    for (const field of input.fields) {
+        if (!existingFields.has(field.name)) {
+            flaggedFields.push({
+                field: field.name,
+                severity: "review",
+                message: "Template does not expose a field with this name.",
+            });
+            continue;
+        }
+        try {
+            if (field.kind === "checkbox" || typeof field.value === "boolean") {
+                const checkbox = form.getCheckBox(field.name);
+                if (field.value) {
+                    checkbox.check();
+                }
+                else {
+                    checkbox.uncheck();
+                }
+            }
+            else if (field.kind === "radio") {
+                form.getRadioGroup(field.name).select(formatTemplateValue(field.value));
+            }
+            else {
+                form.getTextField(field.name).setText(formatTemplateValue(field.value));
+            }
+            appliedFields += 1;
+        }
+        catch (error) {
+            flaggedFields.push({
+                field: field.name,
+                severity: "review",
+                message: error instanceof Error
+                    ? `Could not fill field: ${error.message}`
+                    : "Could not fill field because the template field type was unexpected.",
+            });
+        }
+    }
+    if (input.flatten ?? true) {
+        try {
+            form.flatten();
+        }
+        catch (error) {
+            flaggedFields.push({
+                field: "template",
+                severity: "review",
+                message: error instanceof Error
+                    ? `Could not flatten PDF form: ${error.message}`
+                    : "Could not flatten PDF form.",
+            });
+        }
+    }
+    if (input.title) {
+        pdfDoc.setTitle(input.title);
+    }
+    if (input.subject) {
+        pdfDoc.setSubject(input.subject);
+    }
+    if (input.author) {
+        pdfDoc.setAuthor(input.author);
+    }
+    return {
+        pdfBytes: await pdfDoc.save(),
+        flaggedFields,
+        appliedFields,
+    };
+}
+export function summarizeReviewSections(review) {
+    return [
+        {
+            title: "Review notes",
+            items: review.notes.map((note, index) => ({
+                label: `Note ${index + 1}`,
+                value: note,
+            })),
+        },
+    ];
+}
+export function buildReviewFooter(flaggedFields) {
+    if (flaggedFields.length === 0) {
+        return ["No flagged fields. Review complete."];
+    }
+    return [
+        "Double-check any flagged fields before filing.",
+        "Govforms does not submit returns to the IRS.",
+    ];
+}
+export function splitLongText(text) {
+    return compactTextLines(text);
+}
+//# sourceMappingURL=writer.js.map

package/dist/src/pdf/writer.js.map

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

package/dist/src/plugins/loader.d.ts

@@ -0,0 +1,15 @@
+import type { PluginEntry, PluginManifest } from "./types.js";
+export declare function getPluginManifest(): PluginManifest;
+export declare function savePluginManifest(manifest: PluginManifest): void;
+export declare function loadPlugins(): PluginEntry[];
+/**
+ * Dynamically import a plugin package, validate its shape,
+ * and return the workflows it provides.
+ */
+export declare function registerPluginWorkflows(entry: PluginEntry): Promise<{
+    registered: number;
+    errors: string[];
+}>;
+export declare function addPluginEntry(entry: PluginEntry): void;
+export declare function removePluginEntry(name: string): boolean;
+export declare function setPluginEnabled(name: string, enabled: boolean): boolean;

package/dist/src/plugins/loader.js

@@ -0,0 +1,86 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { isWorkflowPlugin } from "./types.js";
+const PIGEONGOV_DIR = path.join(homedir(), ".pigeongov");
+const MANIFEST_PATH = path.join(PIGEONGOV_DIR, "plugins.json");
+function ensureDir() {
+    if (!existsSync(PIGEONGOV_DIR)) {
+        mkdirSync(PIGEONGOV_DIR, { recursive: true });
+    }
+}
+export function getPluginManifest() {
+    ensureDir();
+    if (!existsSync(MANIFEST_PATH)) {
+        const empty = { version: 1, plugins: [] };
+        savePluginManifest(empty);
+        return empty;
+    }
+    const raw = readFileSync(MANIFEST_PATH, "utf-8");
+    return JSON.parse(raw);
+}
+export function savePluginManifest(manifest) {
+    ensureDir();
+    writeFileSync(MANIFEST_PATH, JSON.stringify(manifest, null, 2), "utf-8");
+}
+export function loadPlugins() {
+    const manifest = getPluginManifest();
+    return manifest.plugins.filter((p) => p.enabled);
+}
+/**
+ * Dynamically import a plugin package, validate its shape,
+ * and return the workflows it provides.
+ */
+export async function registerPluginWorkflows(entry) {
+    const errors = [];
+    let registered = 0;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const mod = await import(entry.packagePath);
+        // Support both default and named export patterns
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+        const plugin = mod.default ?? mod.plugin ?? mod;
+        if (!isWorkflowPlugin(plugin)) {
+            errors.push(`Plugin "${entry.name}" does not export a valid WorkflowPlugin shape`);
+            return { registered, errors };
+        }
+        // In a full implementation the workflows would be injected into the
+        // runtime registry. For now we just count them as successfully
+        // validated — the registry integration comes next.
+        registered = plugin.workflows.length;
+    }
+    catch (err) {
+        errors.push(`Failed to load plugin "${entry.name}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return { registered, errors };
+}
+export function addPluginEntry(entry) {
+    const manifest = getPluginManifest();
+    const existing = manifest.plugins.findIndex((p) => p.name === entry.name);
+    if (existing >= 0) {
+        manifest.plugins[existing] = entry;
+    }
+    else {
+        manifest.plugins.push(entry);
+    }
+    savePluginManifest(manifest);
+}
+export function removePluginEntry(name) {
+    const manifest = getPluginManifest();
+    const idx = manifest.plugins.findIndex((p) => p.name === name);
+    if (idx < 0)
+        return false;
+    manifest.plugins.splice(idx, 1);
+    savePluginManifest(manifest);
+    return true;
+}
+export function setPluginEnabled(name, enabled) {
+    const manifest = getPluginManifest();
+    const entry = manifest.plugins.find((p) => p.name === name);
+    if (!entry)
+        return false;
+    entry.enabled = enabled;
+    savePluginManifest(manifest);
+    return true;
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/plugins/loader.js.map

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

package/dist/src/plugins/sandbox.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Validate that a plugin's buildBundle output conforms to
+ * the WorkflowBundle shape. Returns true if valid, false otherwise.
+ */
+export declare function validatePluginOutput(bundle: unknown): boolean;
+/**
+ * Same as validatePluginOutput but returns the Zod error for diagnostics.
+ */
+export declare function validatePluginOutputDetailed(bundle: unknown): {
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+};

package/dist/src/plugins/sandbox.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+/**
+ * Zod schema that mirrors the WorkflowBundle shape.
+ * Used to validate plugin output at runtime so we never pass
+ * structurally broken bundles downstream.
+ */
+const validationFlagSchema = z.object({
+    field: z.string(),
+    severity: z.enum(["warning", "error", "review"]),
+    message: z.string(),
+    source: z.string().optional(),
+});
+const validationCheckSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    passed: z.boolean(),
+    severity: z.enum(["warning", "error"]),
+    message: z.string(),
+});
+const evidenceItemSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    required: z.boolean(),
+    status: z.enum(["provided", "missing", "review"]),
+    notes: z.string().optional(),
+    source: z.string().optional(),
+});
+const artifactSchema = z.object({
+    kind: z.string(),
+    label: z.string(),
+    format: z.enum(["json", "pdf", "checklist", "summary"]),
+    path: z.string().optional(),
+    content: z.unknown().optional(),
+});
+const workflowBundleSchema = z.object({
+    workflowId: z.string(),
+    domain: z.string(),
+    title: z.string(),
+    summary: z.string(),
+    year: z.number().optional(),
+    legacyFormId: z.string().optional(),
+    applicant: z.record(z.string(), z.unknown()).optional(),
+    household: z.array(z.object({
+        name: z.string(),
+        relationship: z.string(),
+        age: z.number().optional(),
+        notes: z.string().optional(),
+    })),
+    evidence: z.array(evidenceItemSchema),
+    answers: z.record(z.string(), z.unknown()),
+    derived: z.record(z.string(), z.unknown()),
+    validation: z.object({
+        checks: z.array(validationCheckSchema),
+        flaggedFields: z.array(validationFlagSchema),
+    }),
+    review: z.object({
+        headline: z.string(),
+        notes: z.array(z.string()),
+        flaggedFields: z.array(validationFlagSchema),
+    }),
+    outputArtifacts: z.array(artifactSchema),
+    provenance: z.array(z.string()),
+    filledForm: z.unknown().optional(),
+    calculation: z.unknown().optional(),
+});
+/**
+ * Validate that a plugin's buildBundle output conforms to
+ * the WorkflowBundle shape. Returns true if valid, false otherwise.
+ */
+export function validatePluginOutput(bundle) {
+    const result = workflowBundleSchema.safeParse(bundle);
+    return result.success;
+}
+/**
+ * Same as validatePluginOutput but returns the Zod error for diagnostics.
+ */
+export function validatePluginOutputDetailed(bundle) {
+    const result = workflowBundleSchema.safeParse(bundle);
+    if (result.success)
+        return { valid: true };
+    return {
+        valid: false,
+        error: result.error.issues
+            .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+            .join("; "),
+    };
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/src/plugins/sandbox.js.map

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

package/dist/src/plugins/types.d.ts

@@ -0,0 +1,17 @@
+import type { WorkflowPlugin } from "../types.js";
+export interface PluginManifest {
+    version: 1;
+    plugins: PluginEntry[];
+}
+export interface PluginEntry {
+    name: string;
+    version: string;
+    packagePath: string;
+    installedAt: string;
+    enabled: boolean;
+}
+/**
+ * Shape guard: runtime check that a module's default export
+ * looks like a WorkflowPlugin before we trust it.
+ */
+export declare function isWorkflowPlugin(value: unknown): value is WorkflowPlugin;

package/dist/src/plugins/types.js

@@ -0,0 +1,13 @@
+/**
+ * Shape guard: runtime check that a module's default export
+ * looks like a WorkflowPlugin before we trust it.
+ */
+export function isWorkflowPlugin(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj["name"] === "string" &&
+        typeof obj["version"] === "string" &&
+        Array.isArray(obj["workflows"]));
+}
+//# sourceMappingURL=types.js.map

package/dist/src/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/types.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC/B,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ;QAClC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAChC,CAAC;AACJ,CAAC"}