pigeongov 0.2.0

package/dist/src/schemas/2025/shared.js

@@ -0,0 +1,161 @@
+import { z } from "zod";
+export const filingStatusValues = [
+    "single",
+    "married_filing_jointly",
+    "married_filing_separately",
+    "head_of_household",
+    "qualifying_surviving_spouse",
+];
+export const filingStatusSchema = z
+    .enum(filingStatusValues)
+    .describe("Filing status");
+export const taxYearSchema = z.literal(2025).describe("Tax year");
+export const moneySchema = z
+    .coerce
+    .number()
+    .finite()
+    .describe("Monetary amount in dollars");
+export const signedMoneySchema = moneySchema.describe("Signed monetary amount in dollars");
+export const nonNegativeMoneySchema = moneySchema.min(0).describe("Non-negative monetary amount in dollars");
+export const percentSchema = z
+    .coerce
+    .number()
+    .finite()
+    .min(0)
+    .max(100)
+    .describe("Percentage value");
+export const ssnSchema = z
+    .string()
+    .trim()
+    .regex(/^\d{3}-\d{2}-\d{4}$/, "Expected SSN in ###-##-#### format")
+    .describe("Social Security number");
+export const einSchema = z
+    .string()
+    .trim()
+    .regex(/^\d{2}-\d{7}$/, "Expected EIN in ##-####### format")
+    .describe("Employer identification number");
+export const routingNumberSchema = z
+    .string()
+    .trim()
+    .regex(/^\d{9}$/, "Expected 9-digit routing number")
+    .describe("Direct-deposit routing number");
+export const accountNumberSchema = z
+    .string()
+    .trim()
+    .min(4)
+    .max(17)
+    .describe("Direct-deposit account number");
+export const stateCodeSchema = z
+    .string()
+    .trim()
+    .regex(/^[A-Z]{2}$/, "Expected two-letter state code")
+    .describe("State code");
+export const zipCodeSchema = z
+    .string()
+    .trim()
+    .regex(/^\d{5}(?:-\d{4})?$/, "Expected ZIP code in ##### or #####-#### format")
+    .describe("ZIP code");
+export const addressSchema = z
+    .object({
+    street1: z.string().trim().min(1).describe("Street address line 1"),
+    street2: z.string().trim().optional().describe("Street address line 2"),
+    city: z.string().trim().min(1).describe("City"),
+    state: stateCodeSchema,
+    zipCode: zipCodeSchema,
+})
+    .strict()
+    .describe("Mailing address");
+export const personIdentitySchema = z
+    .object({
+    firstName: z.string().trim().min(1).describe("First name"),
+    lastName: z.string().trim().min(1).describe("Last name"),
+    ssn: ssnSchema,
+    address: addressSchema,
+})
+    .strict()
+    .describe("Person identity");
+export const dependentSchema = z
+    .object({
+    name: z.string().trim().min(1).describe("Dependent name"),
+    ssn: ssnSchema,
+    relationship: z.string().trim().min(1).describe("Relationship to taxpayer"),
+    childTaxCreditEligible: z.boolean().describe("Child tax credit eligibility"),
+    eitcEligible: z.boolean().optional().describe("Earned income credit eligibility"),
+})
+    .strict()
+    .describe("Dependent");
+export const yesNoSchema = z.boolean().describe("Boolean yes/no value");
+export const stateInfoSchema = z
+    .object({
+    state: stateCodeSchema,
+    stateIdNumber: z.string().trim().min(1).optional().describe("State identification number"),
+    stateIncome: signedMoneySchema.optional().describe("State income amount"),
+    stateTaxWithheld: nonNegativeMoneySchema.optional().describe("State tax withheld"),
+    localIncome: signedMoneySchema.optional().describe("Local income amount"),
+    localTaxWithheld: nonNegativeMoneySchema.optional().describe("Local tax withheld"),
+})
+    .strict()
+    .describe("State and local tax information");
+export const w2Box12ItemSchema = z
+    .object({
+    code: z.string().trim().min(1).max(2).describe("W-2 box 12 code"),
+    amount: nonNegativeMoneySchema.describe("W-2 box 12 amount"),
+})
+    .strict()
+    .describe("W-2 box 12 entry");
+export const scheduleCExpenseFields = [
+    "advertising",
+    "carAndTruck",
+    "commissionsAndFees",
+    "contractLabor",
+    "depletion",
+    "depreciation",
+    "employeeBenefitPrograms",
+    "insuranceOtherThanHealth",
+    "interestMortgage",
+    "interestOther",
+    "legalAndProfessional",
+    "officeExpense",
+    "pensionAndProfitSharing",
+    "rentalOrLeaseVehicles",
+    "rentalOrLeaseOtherBusinessProperty",
+    "repairsAndMaintenance",
+    "supplies",
+    "taxesAndLicenses",
+    "travel",
+    "meals",
+    "utilities",
+    "wages",
+    "otherExpenses",
+];
+const scheduleCExpenseShape = {
+    advertising: nonNegativeMoneySchema.optional().describe("Schedule C expense: advertising"),
+    carAndTruck: nonNegativeMoneySchema.optional().describe("Schedule C expense: car and truck"),
+    commissionsAndFees: nonNegativeMoneySchema.optional().describe("Schedule C expense: commissions and fees"),
+    contractLabor: nonNegativeMoneySchema.optional().describe("Schedule C expense: contract labor"),
+    depletion: nonNegativeMoneySchema.optional().describe("Schedule C expense: depletion"),
+    depreciation: nonNegativeMoneySchema.optional().describe("Schedule C expense: depreciation"),
+    employeeBenefitPrograms: nonNegativeMoneySchema.optional().describe("Schedule C expense: employee benefit programs"),
+    insuranceOtherThanHealth: nonNegativeMoneySchema.optional().describe("Schedule C expense: insurance other than health"),
+    interestMortgage: nonNegativeMoneySchema.optional().describe("Schedule C expense: interest mortgage"),
+    interestOther: nonNegativeMoneySchema.optional().describe("Schedule C expense: interest other"),
+    legalAndProfessional: nonNegativeMoneySchema.optional().describe("Schedule C expense: legal and professional"),
+    officeExpense: nonNegativeMoneySchema.optional().describe("Schedule C expense: office expense"),
+    pensionAndProfitSharing: nonNegativeMoneySchema.optional().describe("Schedule C expense: pension and profit sharing"),
+    rentalOrLeaseVehicles: nonNegativeMoneySchema.optional().describe("Schedule C expense: rental or lease vehicles"),
+    rentalOrLeaseOtherBusinessProperty: nonNegativeMoneySchema.optional().describe("Schedule C expense: rental or lease other business property"),
+    repairsAndMaintenance: nonNegativeMoneySchema.optional().describe("Schedule C expense: repairs and maintenance"),
+    supplies: nonNegativeMoneySchema.optional().describe("Schedule C expense: supplies"),
+    taxesAndLicenses: nonNegativeMoneySchema.optional().describe("Schedule C expense: taxes and licenses"),
+    travel: nonNegativeMoneySchema.optional().describe("Schedule C expense: travel"),
+    meals: nonNegativeMoneySchema.optional().describe("Schedule C expense: meals"),
+    utilities: nonNegativeMoneySchema.optional().describe("Schedule C expense: utilities"),
+    wages: nonNegativeMoneySchema.optional().describe("Schedule C expense: wages"),
+    otherExpenses: nonNegativeMoneySchema.optional().describe("Schedule C expense: other expenses"),
+};
+export const scheduleCExpenseSchema = z
+    .object(scheduleCExpenseShape)
+    .strict()
+    .describe("Schedule C expense breakdown");
+export const formMeta = (meta) => meta;
+//# sourceMappingURL=shared.js.map

package/dist/src/schemas/2025/shared.js.map

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

package/dist/src/schemas/2025/w2.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export declare const w2Meta: import("./shared.js").SchemaMeta;
+export declare const w2Schema: z.ZodObject<{
+    taxYear: z.ZodLiteral<2025>;
+    employer: z.ZodObject<{
+        name: z.ZodString;
+        ein: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodObject<{
+            street1: z.ZodString;
+            street2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            state: z.ZodString;
+            zipCode: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    employee: z.ZodObject<{
+        ssn: z.ZodString;
+        firstName: z.ZodString;
+        lastName: z.ZodString;
+        address: z.ZodObject<{
+            street1: z.ZodString;
+            street2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            state: z.ZodString;
+            zipCode: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    boxes: z.ZodObject<{
+        box1WagesTipsOtherCompensation: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box2FederalIncomeTaxWithheld: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box3SocialSecurityWages: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box4SocialSecurityTaxWithheld: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box5MedicareWagesAndTips: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box6MedicareTaxWithheld: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box7SocialSecurityTips: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box8AllocatedTips: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box10DependentCareBenefits: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box11NonqualifiedPlans: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        box12: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            amount: z.ZodCoercedNumber<unknown>;
+        }, z.core.$strict>>>;
+        box13StatutoryEmployee: z.ZodOptional<z.ZodBoolean>;
+        box13RetirementPlan: z.ZodOptional<z.ZodBoolean>;
+        box13ThirdPartySickPay: z.ZodOptional<z.ZodBoolean>;
+        box14Other: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        state: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            state: z.ZodString;
+            stateIdNumber: z.ZodOptional<z.ZodString>;
+            stateIncome: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+            stateTaxWithheld: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+            localIncome: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+            localTaxWithheld: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type W2Schema = z.infer<typeof w2Schema>;

package/dist/src/schemas/2025/w2.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { einSchema, formMeta, moneySchema, nonNegativeMoneySchema, personIdentitySchema, stateInfoSchema, taxYearSchema, w2Box12ItemSchema, } from "./shared.js";
+export const w2Meta = formMeta({
+    id: "w2",
+    name: "Form W-2",
+    taxYear: 2025,
+    version: "2025.1",
+    kind: "source-document",
+});
+export const w2Schema = z
+    .object({
+    taxYear: taxYearSchema,
+    employer: z
+        .object({
+        name: z.string().trim().min(1).describe("Employer name"),
+        ein: einSchema.optional().describe("Employer EIN"),
+        address: z
+            .object({
+            street1: z.string().trim().min(1).describe("Employer street address line 1"),
+            street2: z.string().trim().optional().describe("Employer street address line 2"),
+            city: z.string().trim().min(1).describe("Employer city"),
+            state: z.string().trim().regex(/^[A-Z]{2}$/).describe("Employer state"),
+            zipCode: z.string().trim().regex(/^\d{5}(?:-\d{4})?$/).describe("Employer ZIP code"),
+        })
+            .strict()
+            .optional()
+            .describe("Employer address"),
+    })
+        .strict()
+        .describe("Employer information"),
+    employee: personIdentitySchema
+        .omit({ address: true })
+        .extend({
+        address: personIdentitySchema.shape.address,
+    })
+        .strict()
+        .describe("Employee information"),
+    boxes: z
+        .object({
+        box1WagesTipsOtherCompensation: moneySchema.optional().describe("Box 1 - wages, tips, other compensation"),
+        box2FederalIncomeTaxWithheld: nonNegativeMoneySchema.optional().describe("Box 2 - federal income tax withheld"),
+        box3SocialSecurityWages: nonNegativeMoneySchema.optional().describe("Box 3 - social security wages"),
+        box4SocialSecurityTaxWithheld: nonNegativeMoneySchema.optional().describe("Box 4 - social security tax withheld"),
+        box5MedicareWagesAndTips: nonNegativeMoneySchema.optional().describe("Box 5 - medicare wages and tips"),
+        box6MedicareTaxWithheld: nonNegativeMoneySchema.optional().describe("Box 6 - medicare tax withheld"),
+        box7SocialSecurityTips: nonNegativeMoneySchema.optional().describe("Box 7 - social security tips"),
+        box8AllocatedTips: nonNegativeMoneySchema.optional().describe("Box 8 - allocated tips"),
+        box10DependentCareBenefits: nonNegativeMoneySchema.optional().describe("Box 10 - dependent care benefits"),
+        box11NonqualifiedPlans: nonNegativeMoneySchema.optional().describe("Box 11 - nonqualified plans"),
+        box12: z.array(w2Box12ItemSchema).default([]).describe("Box 12 entries"),
+        box13StatutoryEmployee: z.boolean().optional().describe("Box 13 - statutory employee"),
+        box13RetirementPlan: z.boolean().optional().describe("Box 13 - retirement plan"),
+        box13ThirdPartySickPay: z.boolean().optional().describe("Box 13 - third-party sick pay"),
+        box14Other: z.array(z.string().trim().min(1)).default([]).describe("Box 14 - other entries"),
+        state: z.array(stateInfoSchema).default([]).describe("State and local boxes 15-20"),
+    })
+        .strict()
+        .describe("W-2 box data"),
+})
+    .strict()
+    .describe("W-2 source document");
+//# sourceMappingURL=w2.js.map

package/dist/src/schemas/2025/w2.js.map

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

package/dist/src/storage/drafts.d.ts

@@ -0,0 +1,25 @@
+import type { DraftMetadata } from "../types.js";
+/**
+ * Save a draft of an in-progress workflow.
+ * Returns the draft metadata (including the generated id).
+ */
+export declare function saveDraft(workflowId: string, answers: Record<string, unknown>, completedSections: string[]): Promise<DraftMetadata>;
+/**
+ * List all saved drafts, optionally filtered by workflow id.
+ * Sorted by most-recently-updated first.
+ */
+export declare function listDrafts(workflowId?: string): Promise<DraftMetadata[]>;
+/**
+ * Load a specific draft by its id.
+ */
+export declare function loadDraft(draftId: string): Promise<DraftMetadata | null>;
+/**
+ * Delete a draft by its id.
+ * Returns true if the file was deleted, false if it didn't exist.
+ */
+export declare function deleteDraft(draftId: string): Promise<boolean>;
+/**
+ * Remove all drafts older than `olderThanDays` days.
+ * Returns the number of drafts removed.
+ */
+export declare function cleanupDrafts(olderThanDays: number): Promise<number>;

package/dist/src/storage/drafts.js

@@ -0,0 +1,117 @@
+import { randomUUID } from "node:crypto";
+import { readdir, readFile, writeFile, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { getDraftsDir, ensureDir } from "./paths.js";
+/**
+ * Save a draft of an in-progress workflow.
+ * Returns the draft metadata (including the generated id).
+ */
+export async function saveDraft(workflowId, answers, completedSections) {
+    const draftsDir = getDraftsDir();
+    await ensureDir(draftsDir);
+    const id = randomUUID();
+    const now = new Date().toISOString();
+    const draft = {
+        id,
+        workflowId,
+        schemaVersion: "1.0.0",
+        answers,
+        completedSections,
+        createdAt: now,
+        updatedAt: now,
+    };
+    const filePath = join(draftsDir, `${id}.json`);
+    await writeFile(filePath, JSON.stringify(draft, null, 2), "utf-8");
+    return draft;
+}
+/**
+ * List all saved drafts, optionally filtered by workflow id.
+ * Sorted by most-recently-updated first.
+ */
+export async function listDrafts(workflowId) {
+    const draftsDir = getDraftsDir();
+    await ensureDir(draftsDir);
+    let entries;
+    try {
+        entries = await readdir(draftsDir);
+    }
+    catch {
+        return [];
+    }
+    const jsonFiles = entries.filter((f) => f.endsWith(".json"));
+    const drafts = [];
+    for (const file of jsonFiles) {
+        try {
+            const raw = await readFile(join(draftsDir, file), "utf-8");
+            const draft = JSON.parse(raw);
+            if (!workflowId || draft.workflowId === workflowId) {
+                drafts.push(draft);
+            }
+        }
+        catch {
+            // skip malformed files
+        }
+    }
+    drafts.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    return drafts;
+}
+/**
+ * Load a specific draft by its id.
+ */
+export async function loadDraft(draftId) {
+    const filePath = join(getDraftsDir(), `${draftId}.json`);
+    try {
+        const raw = await readFile(filePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete a draft by its id.
+ * Returns true if the file was deleted, false if it didn't exist.
+ */
+export async function deleteDraft(draftId) {
+    const filePath = join(getDraftsDir(), `${draftId}.json`);
+    try {
+        await unlink(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Remove all drafts older than `olderThanDays` days.
+ * Returns the number of drafts removed.
+ */
+export async function cleanupDrafts(olderThanDays) {
+    const draftsDir = getDraftsDir();
+    await ensureDir(draftsDir);
+    let entries;
+    try {
+        entries = await readdir(draftsDir);
+    }
+    catch {
+        return 0;
+    }
+    const cutoff = Date.now() - olderThanDays * 24 * 60 * 60 * 1000;
+    let removed = 0;
+    for (const file of entries.filter((f) => f.endsWith(".json"))) {
+        const filePath = join(draftsDir, file);
+        try {
+            const raw = await readFile(filePath, "utf-8");
+            const draft = JSON.parse(raw);
+            if (new Date(draft.updatedAt).getTime() < cutoff) {
+                await unlink(filePath);
+                removed++;
+            }
+        }
+        catch {
+            // skip files we can't parse — don't remove them either
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=drafts.js.map

package/dist/src/storage/drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts.js","sourceRoot":"","sources":["../../../src/storage/drafts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAQ,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,UAAkB,EAClB,OAAgC,EAChC,iBAA2B;IAE3B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3B,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,KAAK,GAAkB;QAC3B,EAAE;QACF,UAAU;QACV,aAAa,EAAE,OAAO;QACtB,OAAO;QACP,iBAAiB;QACjB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAEnE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAmB;IAClD,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3B,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;YAC/C,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,aAAqB;IACvD,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3B,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAChE,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;YAC/C,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;gBACjD,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/storage/paths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Root directory for all PigeonGov local data.
+ * Respects `PIGEONGOV_HOME` env override; defaults to `~/.pigeongov/`.
+ */
+export declare const PIGEONGOV_HOME: string;
+export declare function getDraftsDir(): string;
+export declare function getVaultDir(): string;
+export declare function getProfilePath(): string;
+export declare function getConfigPath(): string;
+export declare function getPluginsPath(): string;
+export declare function getAuditLogPath(): string;
+/**
+ * Recursively creates directory if it does not exist (mkdir -p).
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;

package/dist/src/storage/paths.js

@@ -0,0 +1,33 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+/**
+ * Root directory for all PigeonGov local data.
+ * Respects `PIGEONGOV_HOME` env override; defaults to `~/.pigeongov/`.
+ */
+export const PIGEONGOV_HOME = process.env.PIGEONGOV_HOME ?? join(homedir(), ".pigeongov");
+export function getDraftsDir() {
+    return join(PIGEONGOV_HOME, "drafts");
+}
+export function getVaultDir() {
+    return join(PIGEONGOV_HOME, "vault");
+}
+export function getProfilePath() {
+    return join(PIGEONGOV_HOME, "profile.json");
+}
+export function getConfigPath() {
+    return join(PIGEONGOV_HOME, "config.json");
+}
+export function getPluginsPath() {
+    return join(PIGEONGOV_HOME, "plugins.json");
+}
+export function getAuditLogPath() {
+    return join(PIGEONGOV_HOME, "audit.log");
+}
+/**
+ * Recursively creates directory if it does not exist (mkdir -p).
+ */
+export async function ensureDir(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/storage/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/storage/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAE9D,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/src/storage/profile.d.ts

@@ -0,0 +1,17 @@
+import type { HouseholdProfile } from "../types.js";
+/**
+ * Load the household profile from disk.
+ * Returns null if the file does not exist or is malformed.
+ */
+export declare function loadProfile(): Promise<HouseholdProfile | null>;
+/**
+ * Write the household profile to disk.
+ */
+export declare function saveProfile(profile: HouseholdProfile): Promise<void>;
+/**
+ * Deep merge identity fields from a household profile into starter data.
+ *
+ * Only merges fields that exist in both the profile and the starter data schema:
+ * firstName, lastName, ssn, address (and address subfields).
+ */
+export declare function mergeProfileIntoStarterData(profile: HouseholdProfile, starterData: Record<string, unknown>): Record<string, unknown>;

package/dist/src/storage/profile.js

@@ -0,0 +1,59 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { getProfilePath, ensureDir, PIGEONGOV_HOME } from "./paths.js";
+/**
+ * Load the household profile from disk.
+ * Returns null if the file does not exist or is malformed.
+ */
+export async function loadProfile() {
+    try {
+        const raw = await readFile(getProfilePath(), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write the household profile to disk.
+ */
+export async function saveProfile(profile) {
+    await ensureDir(PIGEONGOV_HOME);
+    await writeFile(getProfilePath(), JSON.stringify(profile, null, 2), "utf-8");
+}
+/**
+ * Deep merge identity fields from a household profile into starter data.
+ *
+ * Only merges fields that exist in both the profile and the starter data schema:
+ * firstName, lastName, ssn, address (and address subfields).
+ */
+export function mergeProfileIntoStarterData(profile, starterData) {
+    const result = structuredClone(starterData);
+    // Find the primary person (relationship: "self")
+    const primary = profile.people.find((p) => p.relationship === "self") ?? profile.people[0];
+    if (!primary)
+        return result;
+    // Merge top-level identity fields only if they exist in starter data
+    const identityFields = ["firstName", "lastName", "ssn"];
+    for (const field of identityFields) {
+        if (field in result && primary[field] !== undefined) {
+            result[field] = primary[field];
+        }
+    }
+    // Merge address fields
+    if ("address" in result && typeof result.address === "object" && result.address !== null) {
+        const addrTarget = result.address;
+        const addrSource = profile.address;
+        const addressFields = ["street1", "street2", "city", "state", "zipCode"];
+        for (const field of addressFields) {
+            if (field in addrTarget && addrSource[field] !== undefined) {
+                addrTarget[field] = addrSource[field];
+            }
+        }
+    }
+    else if ("address" in result) {
+        // starter data has address as a key but it's null/undefined — set the whole object
+        result.address = structuredClone(profile.address);
+    }
+    return result;
+}
+//# sourceMappingURL=profile.js.map

package/dist/src/storage/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/storage/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAyB;IACzD,MAAM,SAAS,CAAC,cAAc,CAAC,CAAC;IAChC,MAAM,SAAS,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAyB,EACzB,WAAoC;IAEpC,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE5C,iDAAiD;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3F,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAE5B,qEAAqE;IACrE,MAAM,cAAc,GAA8B,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACnF,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,IAAI,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,SAAS,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACzF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAkC,CAAC;QAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;QAEnC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;QAClF,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,KAAK,IAAI,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC3D,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QAC/B,mFAAmF;QACnF,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/storage/vault.d.ts

@@ -0,0 +1,38 @@
+import type { VaultEntry } from "../types.js";
+/**
+ * Derive a 256-bit key from a passphrase and salt using PBKDF2.
+ */
+export declare function deriveKey(passphrase: string, salt: Buffer): Buffer;
+/**
+ * Encrypt data with AES-256-GCM.
+ */
+export declare function encrypt(data: Buffer, key: Buffer): {
+    iv: Buffer;
+    authTag: Buffer;
+    encrypted: Buffer;
+};
+/**
+ * Decrypt AES-256-GCM ciphertext.
+ */
+export declare function decrypt(encrypted: Buffer, key: Buffer, iv: Buffer, authTag: Buffer): Buffer;
+/**
+ * Initialize the vault: create the salt file and return the derived key.
+ * Idempotent — safe to call when vault already exists.
+ */
+export declare function initVault(passphrase: string): Promise<Buffer>;
+/**
+ * Encrypt a file and add it to the vault.
+ */
+export declare function addToVault(passphrase: string, filePath: string, label: string, tags: string[]): Promise<VaultEntry>;
+/**
+ * List all vault entries (requires passphrase to decrypt the index).
+ */
+export declare function listVault(passphrase: string): Promise<VaultEntry[]>;
+/**
+ * Decrypt a vault entry to a file on disk.
+ */
+export declare function getFromVault(passphrase: string, id: string, outputPath: string): Promise<void>;
+/**
+ * Link a vault document to a workflow.
+ */
+export declare function linkToWorkflow(passphrase: string, docId: string, workflowId: string): Promise<void>;