@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/workflow/channel-registry.d.ts

@@ -0,0 +1,959 @@
+/**
+ * WorkflowChannelRegistry — canonical SSOT for all workflow channels.
+ *
+ * Platform law: a stage is valid only when registry, orchestrator, artifact schema,
+ * display component, completion rule, and stale rule all agree on the same step,
+ * stage IDs, artifact types, and workflow variant.
+ *
+ * No step page, route, or orchestrator may use stage IDs, artifact types, or
+ * orchestrator keys that are not declared in this registry.
+ */
+import { z } from 'zod';
+import { type WorkflowStepDefinition } from '../constants/workflow-registry';
+export declare const WORKFLOW_FAMILIES: readonly ["software", "writing", "research", "media", "publication", "transformation"];
+export type WorkflowFamily = (typeof WORKFLOW_FAMILIES)[number];
+export declare const WORKFLOW_VARIANTS: readonly ["software_app", "nonfiction_book", "fiction_book", "research_report", "scientific_paper", "policy_framework", "screenplay", "movie_package", "audiobook", "documentary", "cross_channel_transformation", "film_production"];
+export type WorkflowVariant = (typeof WORKFLOW_VARIANTS)[number];
+/** Exact structured-output contract for one lossless nonfiction review map unit. */
+export declare const NonfictionPeerReviewMapOutputSchema: z.ZodObject<{
+    mapUnitEcho: z.ZodObject<{
+        unitId: z.ZodString;
+        unitHash: z.ZodString;
+        segments: z.ZodArray<z.ZodObject<{
+            segmentIndex: z.ZodNumber;
+            draftArtifactId: z.ZodString;
+            chapterIndex: z.ZodNumber;
+            chapterTitle: z.ZodString;
+            proseStart: z.ZodNumber;
+            proseEnd: z.ZodNumber;
+            proseHash: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            chapterIndex: number;
+            chapterTitle: string;
+            draftArtifactId: string;
+            proseHash: string;
+            segmentIndex: number;
+            proseStart: number;
+            proseEnd: number;
+        }, {
+            chapterIndex: number;
+            chapterTitle: string;
+            draftArtifactId: string;
+            proseHash: string;
+            segmentIndex: number;
+            proseStart: number;
+            proseEnd: number;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        segments: {
+            chapterIndex: number;
+            chapterTitle: string;
+            draftArtifactId: string;
+            proseHash: string;
+            segmentIndex: number;
+            proseStart: number;
+            proseEnd: number;
+        }[];
+        unitId: string;
+        unitHash: string;
+    }, {
+        segments: {
+            chapterIndex: number;
+            chapterTitle: string;
+            draftArtifactId: string;
+            proseHash: string;
+            segmentIndex: number;
+            proseStart: number;
+            proseEnd: number;
+        }[];
+        unitId: string;
+        unitHash: string;
+    }>;
+    sourceQualityConcerns: z.ZodArray<z.ZodObject<{
+        concern: z.ZodString;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+        location: z.ZodString;
+        recommendation: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        location: string;
+        concern: string;
+    }, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        location: string;
+        concern: string;
+    }>, "many">;
+    localContradictions: z.ZodArray<z.ZodObject<{
+        claimA: z.ZodString;
+        claimB: z.ZodString;
+        contradictionType: z.ZodEnum<["logical", "factual", "tonal", "definitional"]>;
+        location: z.ZodString;
+        resolution: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        location: string;
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }, {
+        location: string;
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }>, "many">;
+    unsupportedClaims: z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        location: z.ZodString;
+        riskLevel: z.ZodEnum<["high", "medium", "low"]>;
+        verificationAction: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        claim: string;
+        location: string;
+        riskLevel: "low" | "medium" | "high";
+        verificationAction: string;
+    }, {
+        claim: string;
+        location: string;
+        riskLevel: "low" | "medium" | "high";
+        verificationAction: string;
+    }>, "many">;
+    underengagedCounterarguments: z.ZodArray<z.ZodObject<{
+        counterargument: z.ZodString;
+        location: z.ZodString;
+        currentTreatment: z.ZodString;
+        recommendedTreatment: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        location: string;
+        counterargument: string;
+        currentTreatment: string;
+        recommendedTreatment: string;
+    }, {
+        location: string;
+        counterargument: string;
+        currentTreatment: string;
+        recommendedTreatment: string;
+    }>, "many">;
+    claimLedger: z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        location: z.ZodString;
+        stance: z.ZodString;
+        evidenceStatus: z.ZodEnum<["supported", "partially_supported", "unsupported", "speculative"]>;
+        sourceIds: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        claim: string;
+        location: string;
+        stance: string;
+        evidenceStatus: "supported" | "unsupported" | "speculative" | "partially_supported";
+        sourceIds: string[];
+    }, {
+        claim: string;
+        location: string;
+        stance: string;
+        evidenceStatus: "supported" | "unsupported" | "speculative" | "partially_supported";
+        sourceIds: string[];
+    }>, "many">;
+    qualityLedger: z.ZodObject<{
+        readerJourney: z.ZodArray<z.ZodObject<{
+            location: z.ZodString;
+            finding: z.ZodString;
+            whyItMatters: z.ZodString;
+            recommendation: z.ZodString;
+            severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+        }, "strict", z.ZodTypeAny, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }>, "many">;
+        humanismStorytelling: z.ZodArray<z.ZodObject<{
+            location: z.ZodString;
+            finding: z.ZodString;
+            whyItMatters: z.ZodString;
+            recommendation: z.ZodString;
+            severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+        }, "strict", z.ZodTypeAny, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }>, "many">;
+        printClarity: z.ZodArray<z.ZodObject<{
+            location: z.ZodString;
+            finding: z.ZodString;
+            whyItMatters: z.ZodString;
+            recommendation: z.ZodString;
+            severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+        }, "strict", z.ZodTypeAny, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }>, "many">;
+        audiobookListenability: z.ZodArray<z.ZodObject<{
+            location: z.ZodString;
+            finding: z.ZodString;
+            whyItMatters: z.ZodString;
+            recommendation: z.ZodString;
+            severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+        }, "strict", z.ZodTypeAny, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }>, "many">;
+        voiceStyleFidelity: z.ZodArray<z.ZodObject<{
+            location: z.ZodString;
+            finding: z.ZodString;
+            whyItMatters: z.ZodString;
+            recommendation: z.ZodString;
+            severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+        }, "strict", z.ZodTypeAny, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }, {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        humanismStorytelling: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        voiceStyleFidelity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        printClarity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        readerJourney: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        audiobookListenability: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+    }, {
+        humanismStorytelling: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        voiceStyleFidelity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        printClarity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        readerJourney: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        audiobookListenability: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+    }>;
+    localRatings: z.ZodObject<{
+        sourceQuality: z.ZodEnum<["high", "medium", "low", "critical"]>;
+        coherence: z.ZodEnum<["coherent", "mostly_coherent", "some_issues", "significant_issues"]>;
+        hallucinationRisk: z.ZodEnum<["high", "medium", "low", "minimal"]>;
+        rhetoricalBalance: z.ZodEnum<["balanced", "slightly_one_sided", "one_sided", "polemical"]>;
+    }, "strict", z.ZodTypeAny, {
+        coherence: "coherent" | "mostly_coherent" | "some_issues" | "significant_issues";
+        sourceQuality: "critical" | "low" | "medium" | "high";
+        hallucinationRisk: "low" | "medium" | "high" | "minimal";
+        rhetoricalBalance: "balanced" | "slightly_one_sided" | "one_sided" | "polemical";
+    }, {
+        coherence: "coherent" | "mostly_coherent" | "some_issues" | "significant_issues";
+        sourceQuality: "critical" | "low" | "medium" | "high";
+        hallucinationRisk: "low" | "medium" | "high" | "minimal";
+        rhetoricalBalance: "balanced" | "slightly_one_sided" | "one_sided" | "polemical";
+    }>;
+    unitSummary: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    mapUnitEcho: {
+        segments: {
+            chapterIndex: number;
+            chapterTitle: string;
+            draftArtifactId: string;
+            proseHash: string;
+            segmentIndex: number;
+            proseStart: number;
+            proseEnd: number;
+        }[];
+        unitId: string;
+        unitHash: string;
+    };
+    sourceQualityConcerns: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        location: string;
+        concern: string;
+    }[];
+    localContradictions: {
+        location: string;
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }[];
+    unsupportedClaims: {
+        claim: string;
+        location: string;
+        riskLevel: "low" | "medium" | "high";
+        verificationAction: string;
+    }[];
+    underengagedCounterarguments: {
+        location: string;
+        counterargument: string;
+        currentTreatment: string;
+        recommendedTreatment: string;
+    }[];
+    claimLedger: {
+        claim: string;
+        location: string;
+        stance: string;
+        evidenceStatus: "supported" | "unsupported" | "speculative" | "partially_supported";
+        sourceIds: string[];
+    }[];
+    qualityLedger: {
+        humanismStorytelling: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        voiceStyleFidelity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        printClarity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        readerJourney: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        audiobookListenability: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+    };
+    localRatings: {
+        coherence: "coherent" | "mostly_coherent" | "some_issues" | "significant_issues";
+        sourceQuality: "critical" | "low" | "medium" | "high";
+        hallucinationRisk: "low" | "medium" | "high" | "minimal";
+        rhetoricalBalance: "balanced" | "slightly_one_sided" | "one_sided" | "polemical";
+    };
+    unitSummary: string;
+}, {
+    mapUnitEcho: {
+        segments: {
+            chapterIndex: number;
+            chapterTitle: string;
+            draftArtifactId: string;
+            proseHash: string;
+            segmentIndex: number;
+            proseStart: number;
+            proseEnd: number;
+        }[];
+        unitId: string;
+        unitHash: string;
+    };
+    sourceQualityConcerns: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        location: string;
+        concern: string;
+    }[];
+    localContradictions: {
+        location: string;
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }[];
+    unsupportedClaims: {
+        claim: string;
+        location: string;
+        riskLevel: "low" | "medium" | "high";
+        verificationAction: string;
+    }[];
+    underengagedCounterarguments: {
+        location: string;
+        counterargument: string;
+        currentTreatment: string;
+        recommendedTreatment: string;
+    }[];
+    claimLedger: {
+        claim: string;
+        location: string;
+        stance: string;
+        evidenceStatus: "supported" | "unsupported" | "speculative" | "partially_supported";
+        sourceIds: string[];
+    }[];
+    qualityLedger: {
+        humanismStorytelling: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        voiceStyleFidelity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        printClarity: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        readerJourney: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+        audiobookListenability: {
+            severity: "critical" | "low" | "medium" | "high";
+            recommendation: string;
+            finding: string;
+            location: string;
+            whyItMatters: string;
+        }[];
+    };
+    localRatings: {
+        coherence: "coherent" | "mostly_coherent" | "some_issues" | "significant_issues";
+        sourceQuality: "critical" | "low" | "medium" | "high";
+        hallucinationRisk: "low" | "medium" | "high" | "minimal";
+        rhetoricalBalance: "balanced" | "slightly_one_sided" | "one_sided" | "polemical";
+    };
+    unitSummary: string;
+}>;
+export type NonfictionPeerReviewMapOutput = z.infer<typeof NonfictionPeerReviewMapOutputSchema>;
+/** Exact structured-output contract for the compact full-book review reducer. */
+export declare const NonfictionPeerReviewReducerOutputSchema: z.ZodObject<{
+    crossChapterContradictions: z.ZodArray<z.ZodObject<{
+        claimA: z.ZodString;
+        claimB: z.ZodString;
+        contradictionType: z.ZodEnum<["logical", "factual", "tonal", "definitional"]>;
+        locations: z.ZodArray<z.ZodString, "many">;
+        resolution: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        locations: string[];
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }, {
+        locations: string[];
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }>, "many">;
+    crossChapterRepetition: z.ZodArray<z.ZodObject<{
+        repeatedIdea: z.ZodString;
+        locations: z.ZodArray<z.ZodString, "many">;
+        readerCost: z.ZodString;
+        directEdit: z.ZodString;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+    }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "low" | "medium" | "high";
+        locations: string[];
+        repeatedIdea: string;
+        readerCost: string;
+        directEdit: string;
+    }, {
+        severity: "critical" | "low" | "medium" | "high";
+        locations: string[];
+        repeatedIdea: string;
+        readerCost: string;
+        directEdit: string;
+    }>, "many">;
+    readerJourney: z.ZodArray<z.ZodObject<{
+        location: z.ZodString;
+        finding: z.ZodString;
+        whyItMatters: z.ZodString;
+        recommendation: z.ZodString;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+    }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }>, "many">;
+    humanismStorytelling: z.ZodArray<z.ZodObject<{
+        location: z.ZodString;
+        finding: z.ZodString;
+        whyItMatters: z.ZodString;
+        recommendation: z.ZodString;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+    }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }>, "many">;
+    printClarity: z.ZodArray<z.ZodObject<{
+        location: z.ZodString;
+        finding: z.ZodString;
+        whyItMatters: z.ZodString;
+        recommendation: z.ZodString;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+    }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }>, "many">;
+    audiobookListenability: z.ZodArray<z.ZodObject<{
+        location: z.ZodString;
+        finding: z.ZodString;
+        whyItMatters: z.ZodString;
+        recommendation: z.ZodString;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+    }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }>, "many">;
+    voiceStyleFidelity: z.ZodArray<z.ZodObject<{
+        location: z.ZodString;
+        finding: z.ZodString;
+        whyItMatters: z.ZodString;
+        recommendation: z.ZodString;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+    }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }, {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }>, "many">;
+    overallSourceQuality: z.ZodEnum<["high", "medium", "low", "critical"]>;
+    overallCoherence: z.ZodEnum<["coherent", "mostly_coherent", "some_issues", "significant_issues"]>;
+    overallHallucinationRisk: z.ZodEnum<["high", "medium", "low", "minimal"]>;
+    overallBalance: z.ZodEnum<["balanced", "slightly_one_sided", "one_sided", "polemical"]>;
+    bookLevelAssessment: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    humanismStorytelling: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    voiceStyleFidelity: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    printClarity: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    overallCoherence: "coherent" | "mostly_coherent" | "some_issues" | "significant_issues";
+    readerJourney: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    audiobookListenability: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    crossChapterContradictions: {
+        locations: string[];
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }[];
+    crossChapterRepetition: {
+        severity: "critical" | "low" | "medium" | "high";
+        locations: string[];
+        repeatedIdea: string;
+        readerCost: string;
+        directEdit: string;
+    }[];
+    overallSourceQuality: "critical" | "low" | "medium" | "high";
+    overallHallucinationRisk: "low" | "medium" | "high" | "minimal";
+    overallBalance: "balanced" | "slightly_one_sided" | "one_sided" | "polemical";
+    bookLevelAssessment: string;
+}, {
+    humanismStorytelling: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    voiceStyleFidelity: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    printClarity: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    overallCoherence: "coherent" | "mostly_coherent" | "some_issues" | "significant_issues";
+    readerJourney: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    audiobookListenability: {
+        severity: "critical" | "low" | "medium" | "high";
+        recommendation: string;
+        finding: string;
+        location: string;
+        whyItMatters: string;
+    }[];
+    crossChapterContradictions: {
+        locations: string[];
+        resolution: string;
+        claimA: string;
+        claimB: string;
+        contradictionType: "definitional" | "logical" | "factual" | "tonal";
+    }[];
+    crossChapterRepetition: {
+        severity: "critical" | "low" | "medium" | "high";
+        locations: string[];
+        repeatedIdea: string;
+        readerCost: string;
+        directEdit: string;
+    }[];
+    overallSourceQuality: "critical" | "low" | "medium" | "high";
+    overallHallucinationRisk: "low" | "medium" | "high" | "minimal";
+    overallBalance: "balanced" | "slightly_one_sided" | "one_sided" | "polemical";
+    bookLevelAssessment: string;
+}>;
+export type NonfictionPeerReviewReducerOutput = z.infer<typeof NonfictionPeerReviewReducerOutputSchema>;
+export type WorkflowStageDefinition = {
+    /** Canonical stage ID — must match workflow_artifacts.stage_id exactly. */
+    stageId: string;
+    /** Human label for Doctor / UI. */
+    label: string;
+    /** Corresponding artifactType (usually same as stageId for legacy rows). */
+    artifactType: string;
+    /** Required for step completion. */
+    required: boolean;
+    /** This stage is the final rollup; downstream steps consume it. */
+    final: boolean;
+    /** Sort order within the step. */
+    displayOrder: number;
+    /** Optional schema key for payload validation. */
+    schemaKey?: string;
+};
+export type ArtifactRequirement = {
+    stepId: string;
+    stageId: string;
+    artifactType?: string;
+    required: boolean;
+};
+export type ArtifactOutput = {
+    stageId: string;
+    artifactType: string;
+    final?: boolean;
+};
+export type CompletionRule = {
+    mode: 'all_required_stages' | 'final_artifact' | 'any_of_stages' | 'custom';
+    requiredStageIds: string[];
+    /** The single stage whose presence = step done (used in final_artifact mode). */
+    finalStageId?: string;
+    /**
+     * For mode 'any_of_stages': the step is complete once ANY ONE of these stage IDs has an
+     * accepted artifact — never all of them. `requiredStageIds` stays empty for this mode;
+     * this is the canonical field the shared reader consumes. Use this — never `'custom'` — for
+     * a step that seeds one of several mutually-exclusive target-specific artifacts (e.g. a
+     * cross-channel transformation seed), so completion still reads through the one shared
+     * reader instead of a per-variant special case.
+     */
+    anyOfStageIds?: string[];
+};
+export type GateRule = {
+    gateId: string;
+    required: boolean;
+    condition: string;
+};
+export type StaleRule = {
+    /** Artifact types that, when changed, trigger staleness. */
+    triggerArtifactTypes: string[];
+    /** Artifact types that become stale when triggered. */
+    staleArtifactTypes: string[];
+    reason: string;
+};
+/** A single step within a workflow channel (pipeline execution, not navigation). */
+export type ChannelStepDefinition = {
+    stepId: string;
+    label: string;
+    /** Route path fragment, e.g. '/specify'. */
+    routePath: string;
+    /** Canonical presentation/execution phase for workflow navigation. */
+    phase?: number;
+    stages: WorkflowStageDefinition[];
+    /** Key into OrchestratorRegistry. */
+    orchestratorKey: string;
+    /** Route module key, e.g. 'ai.code.generate'. */
+    apiRouteKey: string;
+    /** Key into ComponentRegistry for the primary display. */
+    displayComponentKey: string;
+    /** Optional key for the inline editor component. */
+    editorComponentKey?: string;
+    requiredInputs: ArtifactRequirement[];
+    producedArtifacts: ArtifactOutput[];
+    completion: CompletionRule;
+    gates: GateRule[];
+    staleRules: StaleRule[];
+    /** ID of the next logical step; optional. */
+    nextStepId?: string;
+    /** If true, this step is registered but not yet fully implemented. */
+    experimental?: boolean;
+    /**
+     * Parallel spine retired from operator UI — retained for registry/orchestrator compatibility.
+     * Canonical coding-quality path is Ingest (`WORKFLOW_STEPS` in workflow-registry.ts).
+     */
+    deprecated?: boolean;
+};
+export type WorkflowChannelDefinition = {
+    /** Legacy project_kind value this channel maps from (for backcompat). */
+    projectKind: string;
+    family: WorkflowFamily;
+    variant: WorkflowVariant;
+    workflowVersion: string;
+    label: string;
+    description: string;
+    steps: ChannelStepDefinition[];
+    /** If true, channel is declared but not fully implemented. */
+    experimental?: boolean;
+};
+/**
+ * The canonical WorkflowChannelRegistry keyed by WorkflowVariant.
+ * This is the single source of truth for all active workflow channels.
+ */
+export declare const WORKFLOW_CHANNEL_REGISTRY: Record<WorkflowVariant, WorkflowChannelDefinition>;
+/** Get the channel definition for a workflow variant. Returns undefined for unknown variants. */
+export declare function getWorkflowChannel(variant: WorkflowVariant): WorkflowChannelDefinition;
+/** Get a step definition from a channel. Returns undefined if stepId not registered. */
+export declare function getChannelStep(variant: WorkflowVariant, stepId: string): ChannelStepDefinition | undefined;
+/** Get all stage definitions for a step. Returns [] for unregistered steps. */
+export declare function getWorkflowStages(variant: WorkflowVariant, stepId: string): readonly WorkflowStageDefinition[];
+/** Get stage IDs for a step (for backwards compatibility with getPipelineStages callers). */
+export declare function getWorkflowStageIds(variant: WorkflowVariant, stepId: string): readonly string[];
+/** Get the final stage definition for a step. */
+export declare function getWorkflowFinalStage(variant: WorkflowVariant, stepId: string): WorkflowStageDefinition | undefined;
+/** Get the completion rule for a step. */
+export declare function getCompletionRule(variant: WorkflowVariant, stepId: string): CompletionRule | undefined;
+/** Get required input artifact requirements for a step. */
+export declare function getRequiredInputs(variant: WorkflowVariant, stepId: string): readonly ArtifactRequirement[];
+/** Get produced artifact outputs for a step. */
+export declare function getProducedArtifacts(variant: WorkflowVariant, stepId: string): readonly ArtifactOutput[];
+/** Get the orchestrator key for a step. Returns undefined if step not registered. */
+export declare function getOrchestratorKey(variant: WorkflowVariant, stepId: string): string | undefined;
+/** Get the display component key for a step. Returns undefined if step not registered. */
+export declare function getDisplayComponentKey(variant: WorkflowVariant, stepId: string): string | undefined;
+/** Derive WorkflowFamily from WorkflowVariant without a DB column. */
+export declare function getWorkflowFamily(variant: WorkflowVariant): WorkflowFamily;
+/**
+ * One registry-derived plan shape shared by navigation, completion readers, and
+ * durable execution. `software_app` retains its rich operator workflow while
+ * every other variant is projected from its channel configuration.
+ */
+export declare function getWorkflowPlan(variant: WorkflowVariant): WorkflowStepDefinition[];
+/**
+ * True only for `software_app`: completion uses API/UI KG gates, tasks row parity,
+ * Vercel CI + product-realization + deployment verification, and implementation lineage checks.
+ * All other variants use manuscript/publication/spine semantics — never infer from `isWritingKind`.
+ */
+export declare function isSoftwareAppCompletionSpine(variant: WorkflowVariant): boolean;
+/** Check if a stage ID is declared for a given variant + step (used by dispatcher for validation). */
+export declare function isStageIdDeclared(variant: WorkflowVariant, stepId: string, stageId: string): boolean;
+/** List all registered (non-experimental) variants. */
+export declare function getActiveVariants(): WorkflowVariant[];
+/**
+ * Returns all unique final stage IDs for the given step across all registered active variants.
+ * Used by compute-workflow-step-stats and step-completion to avoid hardcoded stage_id arrays.
+ *
+ * Example: getRegistryFinalStageIds('plan') →
+ *   ['planFinal', 'storyStructureFinal', 'outlineFinal']
+ */
+export declare function getRegistryFinalStageIds(stepId: string): string[];
+export { resolveRegistryWorkflowStepId, resolveWorkflowStepRoutePath, resolveCanonicalWorkflowStepId, normalizeWorkflowStepStatsStepId, } from './step-id-canonical';
+/** One completion stage pulled from `completion.requiredStageIds` + stage `artifactType`. */
+export type RegistryPipelineStageExpectation = {
+    stageId: string;
+    artifactType: string;
+};
+/**
+ * How `expectedStages` combine to satisfy the step:
+ *   - 'all': every expected stage must have an accepted artifact (all_required_stages / final_artifact).
+ *   - 'any': at least one expected stage must have an accepted artifact — the canonical shape for a
+ *     step that seeds one of several mutually-exclusive target-specific artifacts (any_of_stages).
+ */
+export type RegistryPipelineStageMatchMode = 'all' | 'any';
+/** Inputs for registry-backed pipeline checks (variant filter, expectations, staleRules). */
+export type RegistryPipelineCheckContext = {
+    variant: WorkflowVariant;
+    workflowStepId: string;
+    expectedStages: readonly RegistryPipelineStageExpectation[];
+    staleRules: readonly StaleRule[];
+    matchMode: RegistryPipelineStageMatchMode;
+};
+/**
+ * Build registry-backed pipeline expectations for `checkPipelineStages`.
+ * Returns null when the step is not in the channel or has no required completion stages.
+ */
+export declare function buildRegistryPipelineCheckContext(variant: WorkflowVariant, registryStepId: string): RegistryPipelineCheckContext | null;
+/** Object payload passed through `runWorkflowStep` merged `input`. */
+export type WorkflowOrchestratorInput = Record<string, unknown>;
+export type WorkflowOrchestratorFn = (input: WorkflowOrchestratorInput) => Promise<unknown>;
+/**
+ * Canonical bridge from heterogeneous pipeline callables → dispatch shape (`===` identity at runtime).
+ */
+export declare function asWorkflowOrchestratorFn(native: unknown): WorkflowOrchestratorFn;