pigeongov 0.2.0

package/dist/src/cli/prompts/deductions.js

@@ -0,0 +1,26 @@
+import { parseCurrency } from "./common.js";
+export async function collectDeductions(prompts) {
+    const deductionMode = await prompts.select("Deductions", [
+        { name: "Standard deduction", value: "standard" },
+        { name: "Itemized deduction total", value: "itemized" },
+    ]);
+    const educatorExpenses = parseCurrency(await prompts.input("Educator expenses", { default: "0" }));
+    const hsaDeduction = parseCurrency(await prompts.input("HSA deduction", { default: "0" }));
+    const iraDeduction = parseCurrency(await prompts.input("IRA deduction", { default: "0" }));
+    const studentLoanInterest = parseCurrency(await prompts.input("Student loan interest deduction", { default: "0" }));
+    const itemizedDeductions = deductionMode === "itemized"
+        ? parseCurrency(await prompts.input("Itemized deductions total", { default: "0" }))
+        : 0;
+    return {
+        useItemizedDeductions: deductionMode === "itemized",
+        itemizedDeductions,
+        adjustments: {
+            educatorExpenses,
+            hsaDeduction,
+            selfEmploymentTaxDeduction: 0,
+            iraDeduction,
+            studentLoanInterest,
+        },
+    };
+}
+//# sourceMappingURL=deductions.js.map

package/dist/src/cli/prompts/deductions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deductions.js","sourceRoot":"","sources":["../../../../src/cli/prompts/deductions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAqB;IAC3D,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,CAA0B,YAAY,EAAE;QAChF,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,EAAE;QACjD,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,UAAU,EAAE;KACxD,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,aAAa,CACpC,MAAM,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAC3D,CAAC;IACF,MAAM,YAAY,GAAG,aAAa,CAChC,MAAM,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CACvD,CAAC;IACF,MAAM,YAAY,GAAG,aAAa,CAChC,MAAM,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CACvD,CAAC;IACF,MAAM,mBAAmB,GAAG,aAAa,CACvC,MAAM,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CACzE,CAAC;IACF,MAAM,kBAAkB,GACtB,aAAa,KAAK,UAAU;QAC1B,CAAC,CAAC,aAAa,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC,CAAC;IAER,OAAO;QACL,qBAAqB,EAAE,aAAa,KAAK,UAAU;QACnD,kBAAkB;QAClB,WAAW,EAAE;YACX,gBAAgB;YAChB,YAAY;YACZ,0BAA0B,EAAE,CAAC;YAC7B,YAAY;YACZ,mBAAmB;SACpB;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cli/prompts/identity.d.ts

@@ -0,0 +1,8 @@
+import type { PersonIdentity } from "../../types.js";
+import type { FilingStatus } from "../../types.js";
+import { PromptClient } from "./common.js";
+export declare function collectIdentity(prompts: PromptClient): Promise<{
+    filingStatus: FilingStatus;
+    taxpayer: PersonIdentity;
+    spouse?: PersonIdentity;
+}>;

package/dist/src/cli/prompts/identity.js

@@ -0,0 +1,36 @@
+import { validateSsn } from "./common.js";
+export async function collectIdentity(prompts) {
+    const filingStatus = await prompts.select("Filing status", [
+        { name: "Single", value: "single" },
+        { name: "Married filing jointly", value: "married_filing_jointly" },
+        { name: "Married filing separately", value: "married_filing_separately" },
+        { name: "Head of household", value: "head_of_household" },
+        { name: "Qualifying surviving spouse", value: "qualifying_surviving_spouse" },
+    ]);
+    const taxpayer = {
+        firstName: await prompts.input("First name"),
+        lastName: await prompts.input("Last name"),
+        ssn: await prompts.password("SSN", { validate: validateSsn }),
+        address: {
+            street1: await prompts.input("Street address"),
+            city: await prompts.input("City"),
+            state: (await prompts.input("State (2-letter code)", {
+                validate: (value) => /^[A-Z]{2}$/.test(value.toUpperCase()) ? true : "Use a two-letter state code.",
+            })).toUpperCase(),
+            zipCode: await prompts.input("ZIP code", {
+                validate: (value) => /^\d{5}(?:-\d{4})?$/.test(value) ? true : "Use ##### or #####-####.",
+            }),
+        },
+    };
+    if (filingStatus !== "married_filing_jointly") {
+        return { filingStatus, taxpayer };
+    }
+    const spouse = {
+        firstName: await prompts.input("Spouse first name"),
+        lastName: await prompts.input("Spouse last name"),
+        ssn: await prompts.password("Spouse SSN", { validate: validateSsn }),
+        address: taxpayer.address,
+    };
+    return { filingStatus, taxpayer, spouse };
+}
+//# sourceMappingURL=identity.js.map

package/dist/src/cli/prompts/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../src/cli/prompts/identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAqB;IAMrB,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,MAAM,CAAe,eAAe,EAAE;QACvE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;QACnC,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,wBAAwB,EAAE;QACnE,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,2BAA2B,EAAE;QACzE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE;QACzD,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,6BAA6B,EAAE;KAC9E,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAmB;QAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;QAC5C,QAAQ,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;QAC1C,GAAG,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAC7D,OAAO,EAAE;YACP,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC;YAC9C,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;YACjC,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,8BAA8B;aACjF,CAAC,CAAC,CAAC,WAAW,EAAE;YACjB,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE;gBACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B;aACvE,CAAC;SACH;KACF,CAAC;IAEF,IAAI,YAAY,KAAK,wBAAwB,EAAE,CAAC;QAC9C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,MAAM,GAAmB;QAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;QACnD,QAAQ,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC;QACjD,GAAG,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QACpE,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC;IAEF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC"}

package/dist/src/cli/prompts/income.d.ts

@@ -0,0 +1,15 @@
+import type { ImportedDocument } from "../../types.js";
+import type { PromptClient } from "./common.js";
+export interface IncomePromptResult {
+    importedPaths: string[];
+    taxableInterest: number;
+    ordinaryDividends: number;
+    otherIncome: number;
+    scheduleCGrossReceipts: number;
+    scheduleCExpenses: number;
+}
+export declare function collectIncome(prompts: PromptClient): Promise<IncomePromptResult>;
+export declare function mergeImportedIncome(importedDocuments: ImportedDocument[]): Pick<IncomePromptResult, "taxableInterest" | "scheduleCGrossReceipts"> & {
+    wages: number;
+    federalWithheld: number;
+};

package/dist/src/cli/prompts/income.js

@@ -0,0 +1,61 @@
+import { parseCurrency } from "./common.js";
+export async function collectIncome(prompts) {
+    const importedPaths = [];
+    const wantsImport = await prompts.confirm("Import income documents?", { default: true });
+    if (wantsImport) {
+        const firstPath = await prompts.input("Path to W-2 or 1099 PDF");
+        if (firstPath)
+            importedPaths.push(firstPath);
+        while (await prompts.confirm("Import another income document?", { default: false })) {
+            importedPaths.push(await prompts.input("Path to another W-2 or 1099 PDF"));
+        }
+    }
+    const taxableInterest = parseCurrency(await prompts.input("Taxable interest (1099-INT or manual)", { default: "0" }));
+    const ordinaryDividends = parseCurrency(await prompts.input("Ordinary dividends", { default: "0" }));
+    const otherIncome = parseCurrency(await prompts.input("Other income (Schedule 1, line 8 style)", { default: "0" }));
+    const hasSelfEmployment = await prompts.confirm("Self-employment income (Schedule C)?", {
+        default: false,
+    });
+    if (!hasSelfEmployment) {
+        return {
+            importedPaths,
+            taxableInterest,
+            ordinaryDividends,
+            otherIncome,
+            scheduleCGrossReceipts: 0,
+            scheduleCExpenses: 0,
+        };
+    }
+    const scheduleCGrossReceipts = parseCurrency(await prompts.input("Schedule C gross receipts", { default: "0" }));
+    const scheduleCExpenses = parseCurrency(await prompts.input("Schedule C deductible expenses", { default: "0" }));
+    return {
+        importedPaths,
+        taxableInterest,
+        ordinaryDividends,
+        otherIncome,
+        scheduleCGrossReceipts,
+        scheduleCExpenses,
+    };
+}
+export function mergeImportedIncome(importedDocuments) {
+    let wages = 0;
+    let federalWithheld = 0;
+    let taxableInterest = 0;
+    let scheduleCGrossReceipts = 0;
+    for (const document of importedDocuments) {
+        if (document.type === "w2") {
+            wages += document.wages;
+            federalWithheld += document.federalWithheld;
+        }
+        else if (document.type === "1099-int") {
+            taxableInterest += document.interestIncome;
+            federalWithheld += document.federalWithheld ?? 0;
+        }
+        else if (document.type === "1099-nec") {
+            scheduleCGrossReceipts += document.nonemployeeCompensation;
+            federalWithheld += document.federalWithheld ?? 0;
+        }
+    }
+    return { wages, federalWithheld, taxableInterest, scheduleCGrossReceipts };
+}
+//# sourceMappingURL=income.js.map

package/dist/src/cli/prompts/income.js.map

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

package/dist/src/cli/prompts/workflow.d.ts

@@ -0,0 +1,3 @@
+import type { WorkflowQuestionSection } from "../../types.js";
+import type { PromptClient } from "./common.js";
+export declare function collectWorkflowData(prompts: PromptClient, sections: WorkflowQuestionSection[], starterData: unknown): Promise<Record<string, unknown>>;

package/dist/src/cli/prompts/workflow.js

@@ -0,0 +1,74 @@
+import { parseCurrency, validateSsn } from "./common.js";
+function setPath(target, key, value) {
+    const parts = key.split(".");
+    let cursor = target;
+    for (const part of parts.slice(0, -1)) {
+        const current = cursor[part];
+        if (typeof current !== "object" || current === null || Array.isArray(current)) {
+            cursor[part] = {};
+        }
+        cursor = cursor[part];
+    }
+    const last = parts.at(-1);
+    if (last) {
+        cursor[last] = value;
+    }
+}
+function getPath(target, key) {
+    return key.split(".").reduce((accumulator, part) => {
+        if (typeof accumulator !== "object" || accumulator === null) {
+            return undefined;
+        }
+        return accumulator[part];
+    }, target);
+}
+async function askField(prompts, field, draft) {
+    const existing = getPath(draft, field.key);
+    const defaultValue = typeof existing === "string" || typeof existing === "number" ? String(existing) : undefined;
+    switch (field.type) {
+        case "confirm": {
+            const value = await prompts.confirm(field.label, {
+                default: typeof existing === "boolean" ? existing : false,
+            });
+            setPath(draft, field.key, value);
+            return;
+        }
+        case "select": {
+            const value = await prompts.select(field.label, (field.options ?? []).map((option) => ({
+                name: option.label,
+                value: option.value,
+            })));
+            setPath(draft, field.key, value);
+            return;
+        }
+        case "currency": {
+            const value = await prompts.input(field.label, defaultValue ? { default: defaultValue } : {});
+            setPath(draft, field.key, parseCurrency(value));
+            return;
+        }
+        case "number": {
+            const value = await prompts.input(field.label, defaultValue ? { default: defaultValue } : {});
+            setPath(draft, field.key, Number(value || 0));
+            return;
+        }
+        default: {
+            const value = await prompts.input(field.label, {
+                ...(defaultValue ? { default: defaultValue } : {}),
+                ...((field.key.endsWith(".ssn") || field.key === "taxpayer.ssn")
+                    ? { validate: validateSsn }
+                    : {}),
+            });
+            setPath(draft, field.key, value);
+        }
+    }
+}
+export async function collectWorkflowData(prompts, sections, starterData) {
+    const draft = structuredClone(starterData);
+    for (const section of sections) {
+        for (const field of section.fields) {
+            await askField(prompts, field, draft);
+        }
+    }
+    return draft;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/src/cli/prompts/workflow.js.map

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

package/dist/src/cli/support.d.ts

@@ -0,0 +1,53 @@
+import type { PigeonGovErrorShape, ValidationFlag, WorkflowBundle } from "../types.js";
+export declare const CLI_EXIT_CODES: {
+    readonly success: 0;
+    readonly runtimeError: 1;
+    readonly hasWarnings: 2;
+    readonly hasErrors: 3;
+    readonly invalidInput: 4;
+    readonly notFound: 5;
+    readonly permissionDenied: 6;
+    readonly conflict: 7;
+    readonly schemaError: 8;
+    readonly dependencyMissing: 9;
+    readonly timeout: 10;
+};
+export type ExitCode = (typeof CLI_EXIT_CODES)[keyof typeof CLI_EXIT_CODES];
+export declare class PigeonGovError extends Error {
+    readonly code: string;
+    readonly exitCode: ExitCode;
+    readonly field?: string | undefined;
+    readonly suggestion?: string | undefined;
+    readonly retryable: boolean;
+    readonly docs?: string | undefined;
+    constructor(opts: {
+        code: string;
+        message: string;
+        exitCode?: ExitCode;
+        field?: string;
+        suggestion?: string;
+        retryable?: boolean;
+        docs?: string;
+    });
+    toShape(): PigeonGovErrorShape;
+}
+export declare function determineExitCode(flags: ValidationFlag[]): number;
+export declare function setExitCodeFromFlags(flags: ValidationFlag[]): void;
+export declare function emitJson(data: unknown): void;
+export declare function emitJsonCompact(data: unknown): void;
+export declare function emitJsonl(items: unknown[]): void;
+export declare function summarizeBundleForMachine(bundle: WorkflowBundle): {
+    workflowId: string;
+    domain: import("../types.js").WorkflowDomain;
+    title: string;
+    review: import("../types.js").ReviewSummary;
+    validation: {
+        checks: import("../types.js").ValidationCheck[];
+        flaggedFields: ValidationFlag[];
+    };
+    flaggedFields: ValidationFlag[];
+    derived: Record<string, unknown>;
+    outputArtifacts: import("../types.js").WorkflowArtifact[];
+    calculation: unknown;
+    filledForm: unknown;
+};

package/dist/src/cli/support.js

@@ -0,0 +1,80 @@
+export const CLI_EXIT_CODES = {
+    success: 0,
+    runtimeError: 1,
+    hasWarnings: 2,
+    hasErrors: 3,
+    invalidInput: 4,
+    notFound: 5,
+    permissionDenied: 6,
+    conflict: 7,
+    schemaError: 8,
+    dependencyMissing: 9,
+    timeout: 10,
+};
+export class PigeonGovError extends Error {
+    code;
+    exitCode;
+    field;
+    suggestion;
+    retryable;
+    docs;
+    constructor(opts) {
+        super(opts.message);
+        this.name = "PigeonGovError";
+        this.code = opts.code;
+        this.exitCode = opts.exitCode ?? CLI_EXIT_CODES.runtimeError;
+        this.field = opts.field;
+        this.suggestion = opts.suggestion;
+        this.retryable = opts.retryable ?? false;
+        this.docs = opts.docs;
+    }
+    toShape() {
+        return {
+            error: this.code,
+            message: this.message,
+            field: this.field,
+            suggestion: this.suggestion,
+            retryable: this.retryable,
+            docs: this.docs,
+            exitCode: this.exitCode,
+        };
+    }
+}
+export function determineExitCode(flags) {
+    if (flags.some((flag) => flag.severity === "error")) {
+        return CLI_EXIT_CODES.hasErrors;
+    }
+    if (flags.length > 0) {
+        return CLI_EXIT_CODES.hasWarnings;
+    }
+    return CLI_EXIT_CODES.success;
+}
+export function setExitCodeFromFlags(flags) {
+    process.exitCode = determineExitCode(flags);
+}
+export function emitJson(data) {
+    process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+}
+export function emitJsonCompact(data) {
+    process.stdout.write(`${JSON.stringify(data)}\n`);
+}
+export function emitJsonl(items) {
+    for (const item of items) {
+        process.stdout.write(`${JSON.stringify(item)}\n`);
+    }
+}
+export function summarizeBundleForMachine(bundle) {
+    return {
+        workflowId: bundle.workflowId,
+        domain: bundle.domain,
+        title: bundle.title,
+        review: bundle.review,
+        validation: bundle.validation,
+        flaggedFields: bundle.validation.flaggedFields,
+        derived: bundle.derived,
+        outputArtifacts: bundle.outputArtifacts,
+        calculation: bundle.calculation,
+        filledForm: bundle.filledForm,
+    };
+}
+//# sourceMappingURL=support.js.map

package/dist/src/cli/support.js.map

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

package/dist/src/cli/tui.d.ts

@@ -0,0 +1,22 @@
+export interface TuiDecisionInput {
+    formId: string;
+    interactive: boolean;
+    tui: boolean;
+}
+export interface TuiTtyState {
+    stdinIsTty: boolean;
+    stdoutIsTty: boolean;
+}
+export interface LaunchTuiOptions {
+    formId: string;
+    year: string;
+    cwd: string;
+    output?: string;
+    format?: string;
+    importPaths?: string[];
+    accessible?: boolean;
+    noAltScreen?: boolean;
+}
+export declare function shouldUseTui(input: TuiDecisionInput, ttyState: TuiTtyState): boolean;
+export declare function launchTui(options: LaunchTuiOptions): Promise<void>;
+export declare function tryLaunchTuiFill(options: LaunchTuiOptions): Promise<boolean>;

package/dist/src/cli/tui.js

@@ -0,0 +1,122 @@
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export function shouldUseTui(input, ttyState) {
+    if (!input.interactive || !input.tui) {
+        return false;
+    }
+    if (!ttyState.stdinIsTty || !ttyState.stdoutIsTty) {
+        return false;
+    }
+    if (process.env.PIGEONGOV_NO_TUI === "1" ||
+        process.env.PIGEONGOV_FORCE_NODE_PROMPTS === "1") {
+        return false;
+    }
+    return true;
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findPackageRoot(startFileUrl) {
+    let currentDir = path.dirname(fileURLToPath(startFileUrl));
+    while (true) {
+        if ((await pathExists(path.join(currentDir, "package.json"))) &&
+            (await pathExists(path.join(currentDir, "go.mod")))) {
+            return currentDir;
+        }
+        const parent = path.dirname(currentDir);
+        if (parent === currentDir) {
+            return null;
+        }
+        currentDir = parent;
+    }
+}
+async function resolveTuiLaunchCommand(packageRoot) {
+    const overrideBinary = process.env.PIGEONGOV_TUI_BIN;
+    if (overrideBinary && (await pathExists(overrideBinary))) {
+        return { command: overrideBinary, args: [] };
+    }
+    const builtBinary = path.join(packageRoot, "dist", "tui", "pigeongov-tui");
+    if (await pathExists(builtBinary)) {
+        return { command: builtBinary, args: [] };
+    }
+    const goEntry = path.join(packageRoot, "cmd", "pigeongov", "main.go");
+    if (await pathExists(goEntry)) {
+        return { command: "go", args: ["run", "./cmd/pigeongov"] };
+    }
+    return null;
+}
+function buildTuiArgs(options) {
+    const args = [
+        "--form",
+        options.formId,
+        "--year",
+        options.year,
+        "--cwd",
+        options.cwd,
+        "--output",
+        options.output ?? ".",
+        "--format",
+        options.format ?? "json",
+    ];
+    const importPaths = (options.importPaths ?? []).filter(Boolean);
+    if (importPaths.length > 0) {
+        args.push("--import", importPaths.join(","));
+    }
+    if (options.accessible) {
+        args.push("--accessible");
+    }
+    if (options.noAltScreen) {
+        args.push("--no-alt-screen");
+    }
+    return args;
+}
+export async function launchTui(options) {
+    const packageRoot = await findPackageRoot(import.meta.url);
+    if (!packageRoot) {
+        throw new Error("Unable to locate the PigeonGov package root for the terminal UI.");
+    }
+    const launchCommand = await resolveTuiLaunchCommand(packageRoot);
+    if (!launchCommand) {
+        throw new Error("The PigeonGov terminal UI is unavailable. Build it with `pnpm build:tui`, or install Go to run it from source.");
+    }
+    const args = [...launchCommand.args, ...buildTuiArgs(options)];
+    await new Promise((resolve, reject) => {
+        const child = spawn(launchCommand.command, args, {
+            cwd: packageRoot,
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.on("error", (error) => {
+            if (error.code === "ENOENT") {
+                reject(new Error("The PigeonGov terminal UI could not start because Go is not installed and no built TUI binary was found."));
+                return;
+            }
+            reject(error);
+        });
+        child.on("exit", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`PigeonGov TUI exited with code ${code ?? 1}.`));
+        });
+    });
+}
+export async function tryLaunchTuiFill(options) {
+    try {
+        await launchTui(options);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=tui.js.map

package/dist/src/cli/tui.js.map

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

package/dist/src/engine/audit-risk/scorer.d.ts

@@ -0,0 +1,36 @@
+export interface AuditRiskAssessment {
+    score: number;
+    riskLevel: "low" | "moderate" | "elevated" | "high";
+    factors: AuditRiskFactor[];
+    disclaimer: string;
+}
+export interface AuditRiskFactor {
+    id: string;
+    label: string;
+    contribution: number;
+    description: string;
+    severity: "info" | "warning" | "concern";
+}
+interface TaxProfile {
+    filingStatus: string;
+    agi: number;
+    totalIncome: number;
+    scheduleCNet?: number;
+    scheduleCExpenses?: number;
+    hasHomeOffice?: boolean;
+    charitableDeductions?: number;
+    useItemized?: boolean;
+    totalItemized?: number;
+    hasCryptoActivity?: boolean;
+    hasRentalIncome?: boolean;
+    selfEmploymentIncome?: number;
+    cashBusinessIndicators?: boolean;
+}
+/**
+ * Estimate audit risk based on publicly available IRS audit rate data and known patterns.
+ *
+ * THIS IS NOT LEGAL ADVICE. This is a statistical estimate based on published IRS data.
+ * Actual audit selection involves many factors not captured here.
+ */
+export declare function assessAuditRisk(profile: TaxProfile): AuditRiskAssessment;
+export {};