open-local-audit 0.61.0 → 0.62.0

package/dist/index.d.ts

@@ -13,6 +13,8 @@ export { runLighthouseAudit } from "./lighthouse.js";
 export { renderPdfReport } from "./pdf.js";
 export { renderHtmlReport, renderJsonReport, renderMarkdownReport } from "./reporters.js";
 export { buildLeadShortlist, readShortlistReviewCsv, renderShortlistCsv, renderShortlistJson, renderShortlistMarkdown, renderShortlistSummaryJson } from "./shortlist.js";
+export { readWorkflowConfig } from "./workflow-config.js";
+export { WorkflowRunError, runWorkflow, safeLeadSlug } from "./workflow.js";
 export { renderTerminalSummary } from "./summary.js";
 export type { BatchAuditContext, BatchIndexOptions, BatchInputEntry, BatchReportOptions, BatchReportResult, BatchCsvExportPreset, FailedBatchReportResult, SuccessfulBatchReportResult } from "./batch.js";
 export type { DiscoveryAuditResult, DiscoveryProviderName, DiscoverySummary, DuplicateProspectGroup, FetchGooglePlacesCandidatesOptions, FuzzyDuplicateConfidence, FuzzyDuplicateProspectGroup, LeadReviewRow, LeadSuppressionEntry, PlaceCandidate, ProspectExportRow, ProspectCsvExportPreset, ProspectRowInput, ReadManualDiscoveryCsvOptions, WebsiteResolution } from "./discovery.js";
@@ -20,4 +22,6 @@ export type { ExportValidationFormat, ExportValidationIssue, ExportValidationPre
 export type { ReportPackManifest, ReportPackOptions, ReportPackResult } from "./report-pack.js";
 export type { ReviewBulkUpsertInput, ReviewBulkUpsertResult, ReviewStatus, ReviewUpsertAction, ReviewUpsertInput, ReviewUpsertResult } from "./review.js";
 export type { ShortlistFormat, ShortlistLead, ShortlistOptions, ShortlistResult, ShortlistReviewRow, ShortlistSort } from "./shortlist.js";
+export type { RawWorkflowConfig as WorkflowConfig, ResolvedWorkflowConfig } from "./workflow-config.js";
+export type { WorkflowDependencies, WorkflowDiscoveryStageSummary, WorkflowPackageEntry, WorkflowPackageStatus, WorkflowPackageSummary, WorkflowPackagingStageSummary, WorkflowReviewStageSummary, WorkflowShortlistStageSummary, WorkflowStageName, WorkflowStageStatus, WorkflowStatus, WorkflowSummary } from "./workflow.js";
 export type { AuditOptions, AuditProfile, AuditReport, AuditSummary, Evidence, Finding, FindingCategory, LighthouseCategoryScores, LighthouseRunner, LighthouseSummary, PublicContact, ReportBrandConfig, ReportRenderOptions, PageSnapshot, Score, Severity } from "./types.js";

package/dist/index.js

@@ -13,5 +13,7 @@ export { runLighthouseAudit } from "./lighthouse.js";
 export { renderPdfReport } from "./pdf.js";
 export { renderHtmlReport, renderJsonReport, renderMarkdownReport } from "./reporters.js";
 export { buildLeadShortlist, readShortlistReviewCsv, renderShortlistCsv, renderShortlistJson, renderShortlistMarkdown, renderShortlistSummaryJson } from "./shortlist.js";
+export { readWorkflowConfig } from "./workflow-config.js";
+export { WorkflowRunError, runWorkflow, safeLeadSlug } from "./workflow.js";
 export { renderTerminalSummary } from "./summary.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/shortlist-runner.d.ts

@@ -0,0 +1,10 @@
+import { type ShortlistFormat, type ShortlistOptions, type ShortlistResult } from "./shortlist.js";
+export interface ShortlistRunOptions {
+    input: string;
+    out: string;
+    summaryJson?: string;
+    reviewCsv?: string;
+    format: ShortlistFormat;
+    shortlist: Omit<ShortlistOptions, "reviewRows">;
+}
+export declare function runShortlistReport(options: ShortlistRunOptions): Promise<ShortlistResult>;

package/dist/shortlist-runner.js

@@ -0,0 +1,24 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { buildLeadShortlist, readShortlistReviewCsv, renderShortlistCsv, renderShortlistJson, renderShortlistMarkdown, renderShortlistSummaryJson } from "./shortlist.js";
+export async function runShortlistReport(options) {
+    const input = await readFile(options.input, "utf8");
+    const reviewRows = options.reviewCsv ? readShortlistReviewCsv(await readFile(options.reviewCsv, "utf8")) : [];
+    const result = buildLeadShortlist(input, {
+        ...options.shortlist,
+        reviewRows
+    });
+    const output = options.format === "json"
+        ? renderShortlistJson(result)
+        : options.format === "csv"
+            ? renderShortlistCsv(result)
+            : renderShortlistMarkdown(result);
+    await mkdir(dirname(options.out), { recursive: true });
+    await writeFile(options.out, output, "utf8");
+    if (options.summaryJson) {
+        await mkdir(dirname(options.summaryJson), { recursive: true });
+        await writeFile(options.summaryJson, renderShortlistSummaryJson(result), "utf8");
+    }
+    return result;
+}
+//# sourceMappingURL=shortlist-runner.js.map

package/dist/shortlist-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortlist-runner.js","sourceRoot":"","sources":["../src/shortlist-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAI3B,MAAM,gBAAgB,CAAC;AAWxB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA4B;IACnE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9G,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE;QACvC,GAAG,OAAO,CAAC,SAAS;QACpB,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,MAAM;QACvB,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC;QAC7B,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK;YACxB,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC;YAC5B,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/workflow-config.d.ts

@@ -0,0 +1,151 @@
+import { z } from "zod";
+declare const workflowConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    outDir: z.ZodString;
+    discovery: z.ZodDiscriminatedUnion<"provider", [z.ZodObject<{
+        profile: z.ZodDefault<z.ZodEnum<["generic", "dental", "beauty", "restaurant", "contractor", "lawyer", "clinic", "gym", "hotel", "auto-service"]>>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+        maxAudits: z.ZodOptional<z.ZodNumber>;
+        provider: z.ZodLiteral<"manual-csv">;
+        input: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        profile: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service";
+        input: string;
+        concurrency: number;
+        provider: "manual-csv";
+        maxAudits?: number | undefined;
+    }, {
+        input: string;
+        provider: "manual-csv";
+        profile?: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service" | undefined;
+        concurrency?: number | undefined;
+        maxAudits?: number | undefined;
+    }>, z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        profile: z.ZodDefault<z.ZodEnum<["generic", "dental", "beauty", "restaurant", "contractor", "lawyer", "clinic", "gym", "hotel", "auto-service"]>>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+        maxAudits: z.ZodOptional<z.ZodNumber>;
+        provider: z.ZodLiteral<"google-places">;
+        query: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        profile: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service";
+        concurrency: number;
+        provider: "google-places";
+        limit: number;
+        query: string;
+        maxAudits?: number | undefined;
+    }, {
+        provider: "google-places";
+        query: string;
+        profile?: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service" | undefined;
+        concurrency?: number | undefined;
+        limit?: number | undefined;
+        maxAudits?: number | undefined;
+    }>]>;
+    shortlist: z.ZodObject<{
+        top: z.ZodDefault<z.ZodNumber>;
+        minOpportunityScore: z.ZodOptional<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<["opportunity-desc", "score-desc", "company-asc", "last-reviewed-asc", "contact-confidence-desc", "priority-desc", "source-asc"]>>;
+    }, "strict", z.ZodTypeAny, {
+        sort: "opportunity-desc" | "score-desc" | "company-asc" | "last-reviewed-asc" | "contact-confidence-desc" | "priority-desc" | "source-asc";
+        top: number;
+        minOpportunityScore?: number | undefined;
+    }, {
+        sort?: "opportunity-desc" | "score-desc" | "company-asc" | "last-reviewed-asc" | "contact-confidence-desc" | "priority-desc" | "source-asc" | undefined;
+        top?: number | undefined;
+        minOpportunityScore?: number | undefined;
+    }>;
+    review: z.ZodOptional<z.ZodObject<{
+        csv: z.ZodString;
+        staleBefore: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        csv: string;
+        staleBefore?: string | undefined;
+    }, {
+        csv: string;
+        staleBefore?: string | undefined;
+    }>>;
+    packageReports: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    outDir: string;
+    version: 1;
+    discovery: {
+        profile: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service";
+        input: string;
+        concurrency: number;
+        provider: "manual-csv";
+        maxAudits?: number | undefined;
+    } | {
+        profile: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service";
+        concurrency: number;
+        provider: "google-places";
+        limit: number;
+        query: string;
+        maxAudits?: number | undefined;
+    };
+    shortlist: {
+        sort: "opportunity-desc" | "score-desc" | "company-asc" | "last-reviewed-asc" | "contact-confidence-desc" | "priority-desc" | "source-asc";
+        top: number;
+        minOpportunityScore?: number | undefined;
+    };
+    packageReports: boolean;
+    review?: {
+        csv: string;
+        staleBefore?: string | undefined;
+    } | undefined;
+}, {
+    outDir: string;
+    version: 1;
+    discovery: {
+        input: string;
+        provider: "manual-csv";
+        profile?: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service" | undefined;
+        concurrency?: number | undefined;
+        maxAudits?: number | undefined;
+    } | {
+        provider: "google-places";
+        query: string;
+        profile?: "generic" | "dental" | "beauty" | "restaurant" | "contractor" | "lawyer" | "clinic" | "gym" | "hotel" | "auto-service" | undefined;
+        concurrency?: number | undefined;
+        limit?: number | undefined;
+        maxAudits?: number | undefined;
+    };
+    shortlist: {
+        sort?: "opportunity-desc" | "score-desc" | "company-asc" | "last-reviewed-asc" | "contact-confidence-desc" | "priority-desc" | "source-asc" | undefined;
+        top?: number | undefined;
+        minOpportunityScore?: number | undefined;
+    };
+    review?: {
+        csv: string;
+        staleBefore?: string | undefined;
+    } | undefined;
+    packageReports?: boolean | undefined;
+}>;
+export type RawWorkflowConfig = z.input<typeof workflowConfigSchema>;
+type ParsedWorkflowConfig = z.output<typeof workflowConfigSchema>;
+export interface WorkflowManagedPaths {
+    leadsCsv: string;
+    discoverySummaryJson: string;
+    shortlistCsv: string;
+    shortlistSummaryJson: string;
+    reviewSummaryJson: string;
+    workflowSummaryJson: string;
+    reportsDir: string;
+    packagesDir: string;
+}
+export type ResolvedWorkflowConfig = Omit<ParsedWorkflowConfig, "outDir" | "discovery" | "review"> & {
+    outDir: string;
+    discovery: (Extract<ParsedWorkflowConfig["discovery"], {
+        provider: "manual-csv";
+    }> & {
+        input: string;
+    }) | Extract<ParsedWorkflowConfig["discovery"], {
+        provider: "google-places";
+    }>;
+    review?: ParsedWorkflowConfig["review"] & {
+        csv: string;
+    };
+    paths: WorkflowManagedPaths;
+};
+export declare function readWorkflowConfig(configPath: string): Promise<ResolvedWorkflowConfig>;
+export {};

package/dist/workflow-config.js

@@ -0,0 +1,104 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { z } from "zod";
+import { auditProfileSchema } from "./schema.js";
+const nonblankStringSchema = z.string().trim().min(1);
+const discoveryDefaults = {
+    profile: auditProfileSchema.default("generic"),
+    concurrency: z.number().int().positive().default(1),
+    maxAudits: z.number().int().min(0).optional()
+};
+const manualDiscoverySchema = z
+    .object({
+    provider: z.literal("manual-csv"),
+    input: nonblankStringSchema,
+    ...discoveryDefaults
+})
+    .strict();
+const googleDiscoverySchema = z
+    .object({
+    provider: z.literal("google-places"),
+    query: nonblankStringSchema,
+    ...discoveryDefaults,
+    limit: z.number().int().positive().max(50).default(10)
+})
+    .strict();
+const shortlistSortValues = [
+    "opportunity-desc",
+    "score-desc",
+    "company-asc",
+    "last-reviewed-asc",
+    "contact-confidence-desc",
+    "priority-desc",
+    "source-asc"
+];
+function assertNoMissingShortlistSort() { }
+assertNoMissingShortlistSort();
+const shortlistSchema = z
+    .object({
+    top: z.number().int().positive().default(20),
+    minOpportunityScore: z.number().int().min(0).max(100).optional(),
+    sort: z.enum(shortlistSortValues).default("opportunity-desc")
+})
+    .strict();
+const calendarDateSchema = z.string().refine((value) => {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return false;
+    }
+    const parsed = Date.parse(`${value}T00:00:00.000Z`);
+    return Number.isFinite(parsed) && new Date(parsed).toISOString().slice(0, 10) === value;
+}, "Expected a real calendar date in YYYY-MM-DD format");
+const reviewSchema = z
+    .object({
+    csv: nonblankStringSchema,
+    staleBefore: calendarDateSchema.optional()
+})
+    .strict();
+const workflowConfigSchema = z
+    .object({
+    version: z.literal(1),
+    outDir: nonblankStringSchema,
+    discovery: z.discriminatedUnion("provider", [manualDiscoverySchema, googleDiscoverySchema]),
+    shortlist: shortlistSchema,
+    review: reviewSchema.optional(),
+    packageReports: z.boolean().default(false)
+})
+    .strict();
+export async function readWorkflowConfig(configPath) {
+    const absoluteConfigPath = resolve(configPath);
+    const configDirectory = dirname(absoluteConfigPath);
+    const content = await readFile(absoluteConfigPath, "utf8");
+    let rawConfig;
+    try {
+        rawConfig = JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Workflow config ${absoluteConfigPath} contains invalid JSON`, { cause: error });
+        }
+        throw error;
+    }
+    const config = workflowConfigSchema.parse(rawConfig);
+    const outDir = resolve(configDirectory, config.outDir);
+    return {
+        ...config,
+        outDir,
+        discovery: config.discovery.provider === "manual-csv"
+            ? { ...config.discovery, input: resolve(configDirectory, config.discovery.input) }
+            : config.discovery,
+        ...(config.review
+            ? { review: { ...config.review, csv: resolve(configDirectory, config.review.csv) } }
+            : {}),
+        paths: {
+            leadsCsv: join(outDir, "leads.csv"),
+            discoverySummaryJson: join(outDir, "discovery-summary.json"),
+            shortlistCsv: join(outDir, "shortlist.csv"),
+            shortlistSummaryJson: join(outDir, "shortlist-summary.json"),
+            reviewSummaryJson: join(outDir, "review-summary.json"),
+            workflowSummaryJson: join(outDir, "workflow-summary.json"),
+            reportsDir: join(outDir, "reports"),
+            packagesDir: join(outDir, "packages")
+        }
+    };
+}
+//# sourceMappingURL=workflow-config.js.map

package/dist/workflow-config.js.map

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

package/dist/workflow.d.ts

@@ -0,0 +1,85 @@
+import { runDiscovery, type DiscoveryRunResult } from "./discovery-runner.js";
+import { packageReport, type ReportPackResult } from "./report-pack.js";
+import { summarizeReviewCsvFile } from "./review.js";
+import { type ShortlistRunOptions } from "./shortlist-runner.js";
+import type { ShortlistResult } from "./shortlist.js";
+import { resolveGoogleMapsApiKey } from "./secrets.js";
+import { readWorkflowConfig, type ResolvedWorkflowConfig, type WorkflowManagedPaths } from "./workflow-config.js";
+export type WorkflowStatus = "success" | "failed";
+export type WorkflowStageStatus = "success" | "failed" | "skipped" | "not-run";
+export type WorkflowStageName = "discovery" | "shortlist" | "review" | "packaging";
+export type WorkflowPackageStatus = "packaged" | "skipped" | "failed";
+export interface WorkflowDiscoveryStageSummary {
+    status: WorkflowStageStatus;
+    totalCandidates?: number;
+    suppressedCandidates?: number;
+    audited?: number;
+}
+export interface WorkflowShortlistStageSummary {
+    status: WorkflowStageStatus;
+    totalRows?: number;
+    suppressedRows?: number;
+    filteredRows?: number;
+    selected?: number;
+}
+export interface WorkflowReviewStageSummary {
+    status: WorkflowStageStatus;
+    totalRows?: number;
+    reviewedRows?: number;
+    actionableLeads?: number;
+    staleRows?: number;
+    invalidReviewedAtRows?: number;
+    unreviewedRows?: number;
+}
+export interface WorkflowPackagingStageSummary {
+    status: WorkflowStageStatus;
+    packaged?: number;
+    skipped?: number;
+    failed?: number;
+}
+export interface WorkflowPackageEntry {
+    leadKey: string;
+    companyName: string;
+    status: WorkflowPackageStatus;
+    outDir?: string;
+    error?: string;
+}
+export interface WorkflowPackageSummary {
+    packaged: number;
+    skipped: number;
+    failed: number;
+    entries: WorkflowPackageEntry[];
+}
+export interface WorkflowSummary {
+    version: 1;
+    status: WorkflowStatus;
+    stages: {
+        discovery: WorkflowDiscoveryStageSummary;
+        shortlist: WorkflowShortlistStageSummary;
+        review: WorkflowReviewStageSummary;
+        packaging: WorkflowPackagingStageSummary;
+    };
+    outputs: WorkflowManagedPaths;
+    discoveredLeads: number;
+    selectedLeads: number;
+    packages: WorkflowPackageSummary;
+    error?: {
+        stage: WorkflowStageName;
+        message: string;
+    };
+}
+export interface WorkflowDependencies {
+    readWorkflowConfig: typeof readWorkflowConfig;
+    runDiscovery: (options: Parameters<typeof runDiscovery>[0]) => Promise<DiscoveryRunResult>;
+    runShortlistReport: (options: ShortlistRunOptions) => Promise<ShortlistResult>;
+    summarizeReviewCsvFile: typeof summarizeReviewCsvFile;
+    packageReport: (options: Parameters<typeof packageReport>[0]) => Promise<ReportPackResult>;
+    resolveGoogleMapsApiKey: typeof resolveGoogleMapsApiKey;
+}
+export declare class WorkflowRunError extends Error {
+    readonly summary: WorkflowSummary;
+    constructor(summary: WorkflowSummary);
+}
+export declare function safeLeadSlug(leadKey: string, companyName: string): string;
+export declare function runWorkflow(configPath: string, dependencies?: Partial<WorkflowDependencies>): Promise<WorkflowSummary>;
+export declare function runResolvedWorkflow(config: ResolvedWorkflowConfig, dependencies?: Partial<WorkflowDependencies>): Promise<WorkflowSummary>;