@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/workflow/build-truth-read-model.schema.d.ts

@@ -0,0 +1,1218 @@
+/**
+ * BuildTruthReadModel — the single shared truth surface for the Build phase
+ * (Tasks → Implement → Knowledge). Computed once per request from the same
+ * underlying tasks truth + gate inputs so the three steps stop diverging.
+ *
+ * Build Spine Completion Sprint, P0 #2 (one shared Build truth model).
+ */
+import { z } from 'zod';
+export declare const BuildTruthTasksSchema: z.ZodObject<{
+    rowsCount: z.ZodNumber;
+    visibleRowsCount: z.ZodNumber;
+    statusCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    truthState: z.ZodString;
+    acceptedStageCount: z.ZodNumber;
+    expectedStageCount: z.ZodNumber;
+    missingStages: z.ZodArray<z.ZodString, "many">;
+    hasAcceptedFinalGraph: z.ZodBoolean;
+    hasAcceptedValidation: z.ZodBoolean;
+    kgComplete: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    kgComplete: boolean;
+    rowsCount: number;
+    visibleRowsCount: number;
+    statusCounts: Record<string, number>;
+    truthState: string;
+    acceptedStageCount: number;
+    expectedStageCount: number;
+    missingStages: string[];
+    hasAcceptedFinalGraph: boolean;
+    hasAcceptedValidation: boolean;
+}, {
+    kgComplete: boolean;
+    rowsCount: number;
+    visibleRowsCount: number;
+    statusCounts: Record<string, number>;
+    truthState: string;
+    acceptedStageCount: number;
+    expectedStageCount: number;
+    missingStages: string[];
+    hasAcceptedFinalGraph: boolean;
+    hasAcceptedValidation: boolean;
+}>;
+export type BuildTruthTasks = z.infer<typeof BuildTruthTasksSchema>;
+export declare const BuildTruthKnowledgeSchema: z.ZodObject<{
+    tasksKgComplete: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    tasksKgComplete: boolean;
+}, {
+    tasksKgComplete: boolean;
+}>;
+export type BuildTruthKnowledge = z.infer<typeof BuildTruthKnowledgeSchema>;
+export declare const BuildTruthReadModelSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    mode: z.ZodEnum<["build-new", "audit-existing"]>;
+    computedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+    /** Full Implement readiness (engines, repo, evidence, reasons) — single source. */
+    gate: z.ZodObject<{
+        status: z.ZodEnum<["blocked", "degraded", "ready"]>;
+        canImplement: z.ZodBoolean;
+        cursorSafe: z.ZodBoolean;
+        cursorAgentSafe: z.ZodOptional<z.ZodBoolean>;
+        openAiPatchSafe: z.ZodBoolean;
+        codexSafe: z.ZodBoolean;
+        codexAgentSafe: z.ZodOptional<z.ZodBoolean>;
+        manualDegradedSafe: z.ZodBoolean;
+        mode: z.ZodEnum<["build-new", "audit-existing"]>;
+        projectId: z.ZodString;
+        taskCount: z.ZodNumber;
+        acceptedTaskArtifactCount: z.ZodNumber;
+        acceptedPipelineStageCount: z.ZodNumber;
+        kgComplete: z.ZodBoolean;
+        hasTaskFinalGraph: z.ZodBoolean;
+        hasTaskValidation: z.ZodBoolean;
+        taskTruth: z.ZodObject<{
+            taskCount: z.ZodNumber;
+            selectedTaskCount: z.ZodNumber;
+            statuses: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            hasAcceptanceCriteria: z.ZodBoolean;
+            hasTargetFiles: z.ZodBoolean;
+            hasSourceFindingIds: z.ZodBoolean;
+            hasAffectedNodeIds: z.ZodBoolean;
+            hasLinkedIssues: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            selectedTaskCount: number;
+            taskCount: number;
+            statuses: Record<string, number>;
+            hasAcceptanceCriteria: boolean;
+            hasTargetFiles: boolean;
+            hasSourceFindingIds: boolean;
+            hasAffectedNodeIds: boolean;
+            hasLinkedIssues: boolean;
+        }, {
+            selectedTaskCount: number;
+            taskCount: number;
+            statuses: Record<string, number>;
+            hasAcceptanceCriteria: boolean;
+            hasTargetFiles: boolean;
+            hasSourceFindingIds: boolean;
+            hasAffectedNodeIds: boolean;
+            hasLinkedIssues: boolean;
+        }>;
+        evidenceTruth: z.ZodObject<{
+            hasAcceptedTaskFinalGraph: z.ZodBoolean;
+            hasAcceptedTaskValidation: z.ZodBoolean;
+            tasksKgComplete: z.ZodBoolean;
+            codeRealityGraphFresh: z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"not_applicable">]>;
+            scanCommitSha: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            scanCommitSha: string | null;
+            hasAcceptedTaskValidation: boolean;
+            hasAcceptedTaskFinalGraph: boolean;
+            tasksKgComplete: boolean;
+            codeRealityGraphFresh: boolean | "not_applicable";
+        }, {
+            scanCommitSha: string | null;
+            hasAcceptedTaskValidation: boolean;
+            hasAcceptedTaskFinalGraph: boolean;
+            tasksKgComplete: boolean;
+            codeRealityGraphFresh: boolean | "not_applicable";
+        }>;
+        repoTruth: z.ZodObject<{
+            repoFullName: z.ZodNullable<z.ZodString>;
+            baseBranch: z.ZodNullable<z.ZodString>;
+            allowedRepo: z.ZodBoolean;
+            allowedBranchPrefix: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            repoFullName: string | null;
+            baseBranch: string | null;
+            allowedRepo: boolean;
+            allowedBranchPrefix: string;
+        }, {
+            repoFullName: string | null;
+            baseBranch: string | null;
+            allowedRepo: boolean;
+            allowedBranchPrefix: string;
+        }>;
+        blockers: z.ZodArray<z.ZodString, "many">;
+        reasons: z.ZodArray<z.ZodString, "many">;
+        warnings: z.ZodArray<z.ZodString, "many">;
+        nextActions: z.ZodArray<z.ZodString, "many">;
+        allowedEngines: z.ZodArray<z.ZodEnum<["openai_patch", "cursor_cloud", "codex"]>, "many">;
+        engineCapabilities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<["openai_patch", "cursor_agent", "codex_agent", "manual_degraded"]>;
+            label: z.ZodString;
+            wired: z.ZodBoolean;
+            canGenerate: z.ZodBoolean;
+            canValidate: z.ZodBoolean;
+            canPushBranch: z.ZodBoolean;
+            canOpenPr: z.ZodBoolean;
+            canRepair: z.ZodBoolean;
+            requiresHuman: z.ZodBoolean;
+            maxTaskBatchSize: z.ZodNumber;
+            allowedFileKinds: z.ZodArray<z.ZodString, "many">;
+            unavailableReason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+            label: string;
+            wired: boolean;
+            canGenerate: boolean;
+            canValidate: boolean;
+            canPushBranch: boolean;
+            canOpenPr: boolean;
+            canRepair: boolean;
+            requiresHuman: boolean;
+            maxTaskBatchSize: number;
+            allowedFileKinds: string[];
+            unavailableReason?: string | undefined;
+        }, {
+            id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+            label: string;
+            wired: boolean;
+            canGenerate: boolean;
+            canValidate: boolean;
+            canPushBranch: boolean;
+            canOpenPr: boolean;
+            canRepair: boolean;
+            requiresHuman: boolean;
+            maxTaskBatchSize: number;
+            allowedFileKinds: string[];
+            unavailableReason?: string | undefined;
+        }>, "many">>;
+        cursorRequirements: z.ZodObject<{
+            requiresExpectedFiles: z.ZodLiteral<true>;
+            requiresSourceFindingIds: z.ZodLiteral<true>;
+            requiresAffectedNodeIds: z.ZodLiteral<true>;
+            requiresLinkedIssueOrTaskBinding: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            requiresExpectedFiles: true;
+            requiresSourceFindingIds: true;
+            requiresAffectedNodeIds: true;
+            requiresLinkedIssueOrTaskBinding: true;
+        }, {
+            requiresExpectedFiles: true;
+            requiresSourceFindingIds: true;
+            requiresAffectedNodeIds: true;
+            requiresLinkedIssueOrTaskBinding: true;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        status: "blocked" | "ready" | "degraded";
+        warnings: string[];
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        blockers: string[];
+        nextActions: string[];
+        reasons: string[];
+        taskCount: number;
+        canImplement: boolean;
+        cursorSafe: boolean;
+        openAiPatchSafe: boolean;
+        codexSafe: boolean;
+        manualDegradedSafe: boolean;
+        acceptedTaskArtifactCount: number;
+        acceptedPipelineStageCount: number;
+        kgComplete: boolean;
+        hasTaskFinalGraph: boolean;
+        hasTaskValidation: boolean;
+        taskTruth: {
+            selectedTaskCount: number;
+            taskCount: number;
+            statuses: Record<string, number>;
+            hasAcceptanceCriteria: boolean;
+            hasTargetFiles: boolean;
+            hasSourceFindingIds: boolean;
+            hasAffectedNodeIds: boolean;
+            hasLinkedIssues: boolean;
+        };
+        evidenceTruth: {
+            scanCommitSha: string | null;
+            hasAcceptedTaskValidation: boolean;
+            hasAcceptedTaskFinalGraph: boolean;
+            tasksKgComplete: boolean;
+            codeRealityGraphFresh: boolean | "not_applicable";
+        };
+        repoTruth: {
+            repoFullName: string | null;
+            baseBranch: string | null;
+            allowedRepo: boolean;
+            allowedBranchPrefix: string;
+        };
+        allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+        cursorRequirements: {
+            requiresExpectedFiles: true;
+            requiresSourceFindingIds: true;
+            requiresAffectedNodeIds: true;
+            requiresLinkedIssueOrTaskBinding: true;
+        };
+        cursorAgentSafe?: boolean | undefined;
+        codexAgentSafe?: boolean | undefined;
+        engineCapabilities?: {
+            id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+            label: string;
+            wired: boolean;
+            canGenerate: boolean;
+            canValidate: boolean;
+            canPushBranch: boolean;
+            canOpenPr: boolean;
+            canRepair: boolean;
+            requiresHuman: boolean;
+            maxTaskBatchSize: number;
+            allowedFileKinds: string[];
+            unavailableReason?: string | undefined;
+        }[] | undefined;
+    }, {
+        status: "blocked" | "ready" | "degraded";
+        warnings: string[];
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        blockers: string[];
+        nextActions: string[];
+        reasons: string[];
+        taskCount: number;
+        canImplement: boolean;
+        cursorSafe: boolean;
+        openAiPatchSafe: boolean;
+        codexSafe: boolean;
+        manualDegradedSafe: boolean;
+        acceptedTaskArtifactCount: number;
+        acceptedPipelineStageCount: number;
+        kgComplete: boolean;
+        hasTaskFinalGraph: boolean;
+        hasTaskValidation: boolean;
+        taskTruth: {
+            selectedTaskCount: number;
+            taskCount: number;
+            statuses: Record<string, number>;
+            hasAcceptanceCriteria: boolean;
+            hasTargetFiles: boolean;
+            hasSourceFindingIds: boolean;
+            hasAffectedNodeIds: boolean;
+            hasLinkedIssues: boolean;
+        };
+        evidenceTruth: {
+            scanCommitSha: string | null;
+            hasAcceptedTaskValidation: boolean;
+            hasAcceptedTaskFinalGraph: boolean;
+            tasksKgComplete: boolean;
+            codeRealityGraphFresh: boolean | "not_applicable";
+        };
+        repoTruth: {
+            repoFullName: string | null;
+            baseBranch: string | null;
+            allowedRepo: boolean;
+            allowedBranchPrefix: string;
+        };
+        allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+        cursorRequirements: {
+            requiresExpectedFiles: true;
+            requiresSourceFindingIds: true;
+            requiresAffectedNodeIds: true;
+            requiresLinkedIssueOrTaskBinding: true;
+        };
+        cursorAgentSafe?: boolean | undefined;
+        codexAgentSafe?: boolean | undefined;
+        engineCapabilities?: {
+            id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+            label: string;
+            wired: boolean;
+            canGenerate: boolean;
+            canValidate: boolean;
+            canPushBranch: boolean;
+            canOpenPr: boolean;
+            canRepair: boolean;
+            requiresHuman: boolean;
+            maxTaskBatchSize: number;
+            allowedFileKinds: string[];
+            unavailableReason?: string | undefined;
+        }[] | undefined;
+    }>;
+    tasks: z.ZodObject<{
+        rowsCount: z.ZodNumber;
+        visibleRowsCount: z.ZodNumber;
+        statusCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        truthState: z.ZodString;
+        acceptedStageCount: z.ZodNumber;
+        expectedStageCount: z.ZodNumber;
+        missingStages: z.ZodArray<z.ZodString, "many">;
+        hasAcceptedFinalGraph: z.ZodBoolean;
+        hasAcceptedValidation: z.ZodBoolean;
+        kgComplete: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        kgComplete: boolean;
+        rowsCount: number;
+        visibleRowsCount: number;
+        statusCounts: Record<string, number>;
+        truthState: string;
+        acceptedStageCount: number;
+        expectedStageCount: number;
+        missingStages: string[];
+        hasAcceptedFinalGraph: boolean;
+        hasAcceptedValidation: boolean;
+    }, {
+        kgComplete: boolean;
+        rowsCount: number;
+        visibleRowsCount: number;
+        statusCounts: Record<string, number>;
+        truthState: string;
+        acceptedStageCount: number;
+        expectedStageCount: number;
+        missingStages: string[];
+        hasAcceptedFinalGraph: boolean;
+        hasAcceptedValidation: boolean;
+    }>;
+    knowledge: z.ZodObject<{
+        tasksKgComplete: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        tasksKgComplete: boolean;
+    }, {
+        tasksKgComplete: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    tasks: {
+        kgComplete: boolean;
+        rowsCount: number;
+        visibleRowsCount: number;
+        statusCounts: Record<string, number>;
+        truthState: string;
+        acceptedStageCount: number;
+        expectedStageCount: number;
+        missingStages: string[];
+        hasAcceptedFinalGraph: boolean;
+        hasAcceptedValidation: boolean;
+    };
+    knowledge: {
+        tasksKgComplete: boolean;
+    };
+    projectId: string;
+    mode: "build-new" | "audit-existing";
+    durationMs: number;
+    computedAt: string;
+    gate: {
+        status: "blocked" | "ready" | "degraded";
+        warnings: string[];
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        blockers: string[];
+        nextActions: string[];
+        reasons: string[];
+        taskCount: number;
+        canImplement: boolean;
+        cursorSafe: boolean;
+        openAiPatchSafe: boolean;
+        codexSafe: boolean;
+        manualDegradedSafe: boolean;
+        acceptedTaskArtifactCount: number;
+        acceptedPipelineStageCount: number;
+        kgComplete: boolean;
+        hasTaskFinalGraph: boolean;
+        hasTaskValidation: boolean;
+        taskTruth: {
+            selectedTaskCount: number;
+            taskCount: number;
+            statuses: Record<string, number>;
+            hasAcceptanceCriteria: boolean;
+            hasTargetFiles: boolean;
+            hasSourceFindingIds: boolean;
+            hasAffectedNodeIds: boolean;
+            hasLinkedIssues: boolean;
+        };
+        evidenceTruth: {
+            scanCommitSha: string | null;
+            hasAcceptedTaskValidation: boolean;
+            hasAcceptedTaskFinalGraph: boolean;
+            tasksKgComplete: boolean;
+            codeRealityGraphFresh: boolean | "not_applicable";
+        };
+        repoTruth: {
+            repoFullName: string | null;
+            baseBranch: string | null;
+            allowedRepo: boolean;
+            allowedBranchPrefix: string;
+        };
+        allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+        cursorRequirements: {
+            requiresExpectedFiles: true;
+            requiresSourceFindingIds: true;
+            requiresAffectedNodeIds: true;
+            requiresLinkedIssueOrTaskBinding: true;
+        };
+        cursorAgentSafe?: boolean | undefined;
+        codexAgentSafe?: boolean | undefined;
+        engineCapabilities?: {
+            id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+            label: string;
+            wired: boolean;
+            canGenerate: boolean;
+            canValidate: boolean;
+            canPushBranch: boolean;
+            canOpenPr: boolean;
+            canRepair: boolean;
+            requiresHuman: boolean;
+            maxTaskBatchSize: number;
+            allowedFileKinds: string[];
+            unavailableReason?: string | undefined;
+        }[] | undefined;
+    };
+}, {
+    tasks: {
+        kgComplete: boolean;
+        rowsCount: number;
+        visibleRowsCount: number;
+        statusCounts: Record<string, number>;
+        truthState: string;
+        acceptedStageCount: number;
+        expectedStageCount: number;
+        missingStages: string[];
+        hasAcceptedFinalGraph: boolean;
+        hasAcceptedValidation: boolean;
+    };
+    knowledge: {
+        tasksKgComplete: boolean;
+    };
+    projectId: string;
+    mode: "build-new" | "audit-existing";
+    durationMs: number;
+    computedAt: string;
+    gate: {
+        status: "blocked" | "ready" | "degraded";
+        warnings: string[];
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        blockers: string[];
+        nextActions: string[];
+        reasons: string[];
+        taskCount: number;
+        canImplement: boolean;
+        cursorSafe: boolean;
+        openAiPatchSafe: boolean;
+        codexSafe: boolean;
+        manualDegradedSafe: boolean;
+        acceptedTaskArtifactCount: number;
+        acceptedPipelineStageCount: number;
+        kgComplete: boolean;
+        hasTaskFinalGraph: boolean;
+        hasTaskValidation: boolean;
+        taskTruth: {
+            selectedTaskCount: number;
+            taskCount: number;
+            statuses: Record<string, number>;
+            hasAcceptanceCriteria: boolean;
+            hasTargetFiles: boolean;
+            hasSourceFindingIds: boolean;
+            hasAffectedNodeIds: boolean;
+            hasLinkedIssues: boolean;
+        };
+        evidenceTruth: {
+            scanCommitSha: string | null;
+            hasAcceptedTaskValidation: boolean;
+            hasAcceptedTaskFinalGraph: boolean;
+            tasksKgComplete: boolean;
+            codeRealityGraphFresh: boolean | "not_applicable";
+        };
+        repoTruth: {
+            repoFullName: string | null;
+            baseBranch: string | null;
+            allowedRepo: boolean;
+            allowedBranchPrefix: string;
+        };
+        allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+        cursorRequirements: {
+            requiresExpectedFiles: true;
+            requiresSourceFindingIds: true;
+            requiresAffectedNodeIds: true;
+            requiresLinkedIssueOrTaskBinding: true;
+        };
+        cursorAgentSafe?: boolean | undefined;
+        codexAgentSafe?: boolean | undefined;
+        engineCapabilities?: {
+            id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+            label: string;
+            wired: boolean;
+            canGenerate: boolean;
+            canValidate: boolean;
+            canPushBranch: boolean;
+            canOpenPr: boolean;
+            canRepair: boolean;
+            requiresHuman: boolean;
+            maxTaskBatchSize: number;
+            allowedFileKinds: string[];
+            unavailableReason?: string | undefined;
+        }[] | undefined;
+    };
+}>;
+export type BuildTruthReadModel = z.infer<typeof BuildTruthReadModelSchema>;
+export declare const BuildTruthReadModelResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        projectId: z.ZodString;
+        mode: z.ZodEnum<["build-new", "audit-existing"]>;
+        computedAt: z.ZodString;
+        durationMs: z.ZodNumber;
+        /** Full Implement readiness (engines, repo, evidence, reasons) — single source. */
+        gate: z.ZodObject<{
+            status: z.ZodEnum<["blocked", "degraded", "ready"]>;
+            canImplement: z.ZodBoolean;
+            cursorSafe: z.ZodBoolean;
+            cursorAgentSafe: z.ZodOptional<z.ZodBoolean>;
+            openAiPatchSafe: z.ZodBoolean;
+            codexSafe: z.ZodBoolean;
+            codexAgentSafe: z.ZodOptional<z.ZodBoolean>;
+            manualDegradedSafe: z.ZodBoolean;
+            mode: z.ZodEnum<["build-new", "audit-existing"]>;
+            projectId: z.ZodString;
+            taskCount: z.ZodNumber;
+            acceptedTaskArtifactCount: z.ZodNumber;
+            acceptedPipelineStageCount: z.ZodNumber;
+            kgComplete: z.ZodBoolean;
+            hasTaskFinalGraph: z.ZodBoolean;
+            hasTaskValidation: z.ZodBoolean;
+            taskTruth: z.ZodObject<{
+                taskCount: z.ZodNumber;
+                selectedTaskCount: z.ZodNumber;
+                statuses: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                hasAcceptanceCriteria: z.ZodBoolean;
+                hasTargetFiles: z.ZodBoolean;
+                hasSourceFindingIds: z.ZodBoolean;
+                hasAffectedNodeIds: z.ZodBoolean;
+                hasLinkedIssues: z.ZodBoolean;
+            }, "strip", z.ZodTypeAny, {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            }, {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            }>;
+            evidenceTruth: z.ZodObject<{
+                hasAcceptedTaskFinalGraph: z.ZodBoolean;
+                hasAcceptedTaskValidation: z.ZodBoolean;
+                tasksKgComplete: z.ZodBoolean;
+                codeRealityGraphFresh: z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"not_applicable">]>;
+                scanCommitSha: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            }, {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            }>;
+            repoTruth: z.ZodObject<{
+                repoFullName: z.ZodNullable<z.ZodString>;
+                baseBranch: z.ZodNullable<z.ZodString>;
+                allowedRepo: z.ZodBoolean;
+                allowedBranchPrefix: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            }, {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            }>;
+            blockers: z.ZodArray<z.ZodString, "many">;
+            reasons: z.ZodArray<z.ZodString, "many">;
+            warnings: z.ZodArray<z.ZodString, "many">;
+            nextActions: z.ZodArray<z.ZodString, "many">;
+            allowedEngines: z.ZodArray<z.ZodEnum<["openai_patch", "cursor_cloud", "codex"]>, "many">;
+            engineCapabilities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodEnum<["openai_patch", "cursor_agent", "codex_agent", "manual_degraded"]>;
+                label: z.ZodString;
+                wired: z.ZodBoolean;
+                canGenerate: z.ZodBoolean;
+                canValidate: z.ZodBoolean;
+                canPushBranch: z.ZodBoolean;
+                canOpenPr: z.ZodBoolean;
+                canRepair: z.ZodBoolean;
+                requiresHuman: z.ZodBoolean;
+                maxTaskBatchSize: z.ZodNumber;
+                allowedFileKinds: z.ZodArray<z.ZodString, "many">;
+                unavailableReason: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }, {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }>, "many">>;
+            cursorRequirements: z.ZodObject<{
+                requiresExpectedFiles: z.ZodLiteral<true>;
+                requiresSourceFindingIds: z.ZodLiteral<true>;
+                requiresAffectedNodeIds: z.ZodLiteral<true>;
+                requiresLinkedIssueOrTaskBinding: z.ZodLiteral<true>;
+            }, "strip", z.ZodTypeAny, {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            }, {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            status: "blocked" | "ready" | "degraded";
+            warnings: string[];
+            projectId: string;
+            mode: "build-new" | "audit-existing";
+            blockers: string[];
+            nextActions: string[];
+            reasons: string[];
+            taskCount: number;
+            canImplement: boolean;
+            cursorSafe: boolean;
+            openAiPatchSafe: boolean;
+            codexSafe: boolean;
+            manualDegradedSafe: boolean;
+            acceptedTaskArtifactCount: number;
+            acceptedPipelineStageCount: number;
+            kgComplete: boolean;
+            hasTaskFinalGraph: boolean;
+            hasTaskValidation: boolean;
+            taskTruth: {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            };
+            evidenceTruth: {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            };
+            repoTruth: {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            };
+            allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+            cursorRequirements: {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            };
+            cursorAgentSafe?: boolean | undefined;
+            codexAgentSafe?: boolean | undefined;
+            engineCapabilities?: {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }[] | undefined;
+        }, {
+            status: "blocked" | "ready" | "degraded";
+            warnings: string[];
+            projectId: string;
+            mode: "build-new" | "audit-existing";
+            blockers: string[];
+            nextActions: string[];
+            reasons: string[];
+            taskCount: number;
+            canImplement: boolean;
+            cursorSafe: boolean;
+            openAiPatchSafe: boolean;
+            codexSafe: boolean;
+            manualDegradedSafe: boolean;
+            acceptedTaskArtifactCount: number;
+            acceptedPipelineStageCount: number;
+            kgComplete: boolean;
+            hasTaskFinalGraph: boolean;
+            hasTaskValidation: boolean;
+            taskTruth: {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            };
+            evidenceTruth: {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            };
+            repoTruth: {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            };
+            allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+            cursorRequirements: {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            };
+            cursorAgentSafe?: boolean | undefined;
+            codexAgentSafe?: boolean | undefined;
+            engineCapabilities?: {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }[] | undefined;
+        }>;
+        tasks: z.ZodObject<{
+            rowsCount: z.ZodNumber;
+            visibleRowsCount: z.ZodNumber;
+            statusCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            truthState: z.ZodString;
+            acceptedStageCount: z.ZodNumber;
+            expectedStageCount: z.ZodNumber;
+            missingStages: z.ZodArray<z.ZodString, "many">;
+            hasAcceptedFinalGraph: z.ZodBoolean;
+            hasAcceptedValidation: z.ZodBoolean;
+            kgComplete: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            kgComplete: boolean;
+            rowsCount: number;
+            visibleRowsCount: number;
+            statusCounts: Record<string, number>;
+            truthState: string;
+            acceptedStageCount: number;
+            expectedStageCount: number;
+            missingStages: string[];
+            hasAcceptedFinalGraph: boolean;
+            hasAcceptedValidation: boolean;
+        }, {
+            kgComplete: boolean;
+            rowsCount: number;
+            visibleRowsCount: number;
+            statusCounts: Record<string, number>;
+            truthState: string;
+            acceptedStageCount: number;
+            expectedStageCount: number;
+            missingStages: string[];
+            hasAcceptedFinalGraph: boolean;
+            hasAcceptedValidation: boolean;
+        }>;
+        knowledge: z.ZodObject<{
+            tasksKgComplete: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            tasksKgComplete: boolean;
+        }, {
+            tasksKgComplete: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        tasks: {
+            kgComplete: boolean;
+            rowsCount: number;
+            visibleRowsCount: number;
+            statusCounts: Record<string, number>;
+            truthState: string;
+            acceptedStageCount: number;
+            expectedStageCount: number;
+            missingStages: string[];
+            hasAcceptedFinalGraph: boolean;
+            hasAcceptedValidation: boolean;
+        };
+        knowledge: {
+            tasksKgComplete: boolean;
+        };
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        durationMs: number;
+        computedAt: string;
+        gate: {
+            status: "blocked" | "ready" | "degraded";
+            warnings: string[];
+            projectId: string;
+            mode: "build-new" | "audit-existing";
+            blockers: string[];
+            nextActions: string[];
+            reasons: string[];
+            taskCount: number;
+            canImplement: boolean;
+            cursorSafe: boolean;
+            openAiPatchSafe: boolean;
+            codexSafe: boolean;
+            manualDegradedSafe: boolean;
+            acceptedTaskArtifactCount: number;
+            acceptedPipelineStageCount: number;
+            kgComplete: boolean;
+            hasTaskFinalGraph: boolean;
+            hasTaskValidation: boolean;
+            taskTruth: {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            };
+            evidenceTruth: {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            };
+            repoTruth: {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            };
+            allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+            cursorRequirements: {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            };
+            cursorAgentSafe?: boolean | undefined;
+            codexAgentSafe?: boolean | undefined;
+            engineCapabilities?: {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }[] | undefined;
+        };
+    }, {
+        tasks: {
+            kgComplete: boolean;
+            rowsCount: number;
+            visibleRowsCount: number;
+            statusCounts: Record<string, number>;
+            truthState: string;
+            acceptedStageCount: number;
+            expectedStageCount: number;
+            missingStages: string[];
+            hasAcceptedFinalGraph: boolean;
+            hasAcceptedValidation: boolean;
+        };
+        knowledge: {
+            tasksKgComplete: boolean;
+        };
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        durationMs: number;
+        computedAt: string;
+        gate: {
+            status: "blocked" | "ready" | "degraded";
+            warnings: string[];
+            projectId: string;
+            mode: "build-new" | "audit-existing";
+            blockers: string[];
+            nextActions: string[];
+            reasons: string[];
+            taskCount: number;
+            canImplement: boolean;
+            cursorSafe: boolean;
+            openAiPatchSafe: boolean;
+            codexSafe: boolean;
+            manualDegradedSafe: boolean;
+            acceptedTaskArtifactCount: number;
+            acceptedPipelineStageCount: number;
+            kgComplete: boolean;
+            hasTaskFinalGraph: boolean;
+            hasTaskValidation: boolean;
+            taskTruth: {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            };
+            evidenceTruth: {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            };
+            repoTruth: {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            };
+            allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+            cursorRequirements: {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            };
+            cursorAgentSafe?: boolean | undefined;
+            codexAgentSafe?: boolean | undefined;
+            engineCapabilities?: {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }[] | undefined;
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        tasks: {
+            kgComplete: boolean;
+            rowsCount: number;
+            visibleRowsCount: number;
+            statusCounts: Record<string, number>;
+            truthState: string;
+            acceptedStageCount: number;
+            expectedStageCount: number;
+            missingStages: string[];
+            hasAcceptedFinalGraph: boolean;
+            hasAcceptedValidation: boolean;
+        };
+        knowledge: {
+            tasksKgComplete: boolean;
+        };
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        durationMs: number;
+        computedAt: string;
+        gate: {
+            status: "blocked" | "ready" | "degraded";
+            warnings: string[];
+            projectId: string;
+            mode: "build-new" | "audit-existing";
+            blockers: string[];
+            nextActions: string[];
+            reasons: string[];
+            taskCount: number;
+            canImplement: boolean;
+            cursorSafe: boolean;
+            openAiPatchSafe: boolean;
+            codexSafe: boolean;
+            manualDegradedSafe: boolean;
+            acceptedTaskArtifactCount: number;
+            acceptedPipelineStageCount: number;
+            kgComplete: boolean;
+            hasTaskFinalGraph: boolean;
+            hasTaskValidation: boolean;
+            taskTruth: {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            };
+            evidenceTruth: {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            };
+            repoTruth: {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            };
+            allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+            cursorRequirements: {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            };
+            cursorAgentSafe?: boolean | undefined;
+            codexAgentSafe?: boolean | undefined;
+            engineCapabilities?: {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }[] | undefined;
+        };
+    };
+}, {
+    success: true;
+    data: {
+        tasks: {
+            kgComplete: boolean;
+            rowsCount: number;
+            visibleRowsCount: number;
+            statusCounts: Record<string, number>;
+            truthState: string;
+            acceptedStageCount: number;
+            expectedStageCount: number;
+            missingStages: string[];
+            hasAcceptedFinalGraph: boolean;
+            hasAcceptedValidation: boolean;
+        };
+        knowledge: {
+            tasksKgComplete: boolean;
+        };
+        projectId: string;
+        mode: "build-new" | "audit-existing";
+        durationMs: number;
+        computedAt: string;
+        gate: {
+            status: "blocked" | "ready" | "degraded";
+            warnings: string[];
+            projectId: string;
+            mode: "build-new" | "audit-existing";
+            blockers: string[];
+            nextActions: string[];
+            reasons: string[];
+            taskCount: number;
+            canImplement: boolean;
+            cursorSafe: boolean;
+            openAiPatchSafe: boolean;
+            codexSafe: boolean;
+            manualDegradedSafe: boolean;
+            acceptedTaskArtifactCount: number;
+            acceptedPipelineStageCount: number;
+            kgComplete: boolean;
+            hasTaskFinalGraph: boolean;
+            hasTaskValidation: boolean;
+            taskTruth: {
+                selectedTaskCount: number;
+                taskCount: number;
+                statuses: Record<string, number>;
+                hasAcceptanceCriteria: boolean;
+                hasTargetFiles: boolean;
+                hasSourceFindingIds: boolean;
+                hasAffectedNodeIds: boolean;
+                hasLinkedIssues: boolean;
+            };
+            evidenceTruth: {
+                scanCommitSha: string | null;
+                hasAcceptedTaskValidation: boolean;
+                hasAcceptedTaskFinalGraph: boolean;
+                tasksKgComplete: boolean;
+                codeRealityGraphFresh: boolean | "not_applicable";
+            };
+            repoTruth: {
+                repoFullName: string | null;
+                baseBranch: string | null;
+                allowedRepo: boolean;
+                allowedBranchPrefix: string;
+            };
+            allowedEngines: ("cursor_cloud" | "openai_patch" | "codex")[];
+            cursorRequirements: {
+                requiresExpectedFiles: true;
+                requiresSourceFindingIds: true;
+                requiresAffectedNodeIds: true;
+                requiresLinkedIssueOrTaskBinding: true;
+            };
+            cursorAgentSafe?: boolean | undefined;
+            codexAgentSafe?: boolean | undefined;
+            engineCapabilities?: {
+                id: "openai_patch" | "cursor_agent" | "codex_agent" | "manual_degraded";
+                label: string;
+                wired: boolean;
+                canGenerate: boolean;
+                canValidate: boolean;
+                canPushBranch: boolean;
+                canOpenPr: boolean;
+                canRepair: boolean;
+                requiresHuman: boolean;
+                maxTaskBatchSize: number;
+                allowedFileKinds: string[];
+                unavailableReason?: string | undefined;
+            }[] | undefined;
+        };
+    };
+}>;
+export type BuildTruthReadModelResponse = z.infer<typeof BuildTruthReadModelResponseSchema>;