@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/implement-patch.schema.js

@@ -0,0 +1,573 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImplementOrchestrationFailureSchema = exports.ImplementOrchestrationResponseSchema = exports.ImplementOrchestrationRequestSchema = exports.ImplementOrchestrationBatchSchema = exports.ImplementOrchestrationWarningSchema = exports.ImplementOrchestrationStatusEnumSchema = exports.ImplementOrchestrationBatchStatusSchema = exports.ImplementOrchestrationScopeSchema = exports.ImplementPatchHistoryResponseSchema = exports.ImplementPatchDetailResponseSchema = exports.ImplementPatchDetailSchema = exports.ImplementPatchHistoryItemSchema = exports.ImplementPatchHistoryStatusSchema = exports.ProcessImplementationBatchResultSchema = exports.ImplementationBatchDeliveryModeSchema = exports.ImplementSetProofSourceResponseSchema = exports.ImplementSetProofSourceRequestSchema = exports.RecoverStalePipelineResponseSchema = exports.RecoverStalePipelineReasonCodeSchema = exports.RunSelectedProofResponseSchema = exports.RunSelectedProofRequestSchema = exports.ImplementTypedFailureSchema = exports.ImplementProofErrorCodeSchema = exports.ImplementProofErrorPhaseSchema = exports.ImplementationPatchValidateResponseSchema = exports.PatchCheckResultSchema = exports.ImplementationPRCreateResponseSchema = exports.ImplementationPRCreateRequestSchema = exports.ImplementationPushResponseSchema = exports.ImplementationPushRequestSchema = exports.ImplementationGenerateRequestSchema = exports.PatchRepairContextSchema = exports.ImplementGenerationModeSchema = exports.ImplementationPatchSetSchema = exports.ImplementPatchPayloadSchema = exports.ImplementPatchTraceabilitySchema = exports.GeneratedFilePatchSchema = exports.ImplementDiagnosticsSchema = exports.ImplementReadinessLiteSchema = exports.ImplementReadinessV2Schema = exports.IMPLEMENT_TASK_EXCLUDED_STATUSES = exports.IMPLEMENT_TASK_REPAIRABLE_STATUSES = exports.IMPLEMENT_TASK_ITERABLE_STATUSES = exports.IMPLEMENT_TASK_SELECTABLE_STATUSES = exports.ImplementReadinessSchema = exports.ImplementLatestPatchSetSchema = exports.ImplementPatchSupersessionSchema = exports.ImplementTaskCohortIdSchema = exports.ImplementReadinessBlockerSchema = exports.ImplementReadinessBlockerCodeSchema = void 0;
+exports.ImplementRunStatusSchema = exports.ImplementRunStartResponseSchema = exports.ImplementRunGovernedConfigSchema = exports.ImplementRunStartRequestSchema = exports.ImplementRunEnginePreferenceSchema = exports.ImplementRunStrategySchema = exports.ImplementOrchestrationStatusSchema = void 0;
+const zod_1 = require("zod");
+const implement_patch_detail_schema_1 = require("./implement-patch-detail.schema");
+const product_realization_schema_1 = require("./workflow/product-realization.schema");
+const implement_first_batch_schema_1 = require("./workflow/implement-first-batch.schema");
+exports.ImplementReadinessBlockerCodeSchema = zod_1.z.enum([
+    'NO_LINKED_REPO',
+    'GITHUB_NOT_CONNECTED',
+    'GITHUB_CONTENTS_WRITE_MISSING',
+    'GITHUB_PR_WRITE_MISSING',
+    'NO_READY_TASKS',
+    'REPO_SCAN_MISSING',
+    'GITHUB_PERMISSION_CHECK_FAILED',
+    'PRODUCT_REALISATION_BLOCKED',
+    'READINESS_DEGRADED',
+    'UNKNOWN',
+]);
+exports.ImplementReadinessBlockerSchema = zod_1.z.object({
+    code: exports.ImplementReadinessBlockerCodeSchema,
+    severity: zod_1.z.enum(['error', 'warning']),
+    message: zod_1.z.string(),
+    actionLabel: zod_1.z.string().optional(),
+    actionHref: zod_1.z.string().optional(),
+    realizationCheckCode: product_realization_schema_1.ProductRealizationCheckIdSchema.optional(),
+    realizationReason: product_realization_schema_1.ImplementRealizationReasonCodeSchema.optional(),
+    realizationEvidence: product_realization_schema_1.ImplementRealisationEvidenceSchema.optional(),
+});
+/** Rich patch summary for Implement readiness (Sprint T3 SSOT). */
+/** Stable SHA-256 hex identity for a sorted task set within a project (repair-first cohort key). */
+exports.ImplementTaskCohortIdSchema = zod_1.z.string().length(64);
+/** Duplicate / supersession linkage for CI classification (`superseding_pr` evidence). */
+exports.ImplementPatchSupersessionSchema = zod_1.z.object({
+    kind: zod_1.z.enum(['superseding_pr', 'superseded_by_new_pr']),
+    supersedingPrNumber: zod_1.z.number().int().positive().optional(),
+    supersededPrNumbers: zod_1.z.array(zod_1.z.number().int().positive()).optional(),
+    supersedingPatchSetId: zod_1.z.string().uuid().optional(),
+    supersededPatchSetIds: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+});
+exports.ImplementLatestPatchSetSchema = zod_1.z.object({
+    artifactId: zod_1.z.string().uuid(),
+    status: zod_1.z.enum(['draft', 'validated', 'pushed', 'pr_created', 'failed']),
+    branchName: zod_1.z.string().optional(),
+    commitSha: zod_1.z.string().optional(),
+    pullRequestUrl: zod_1.z.string().optional(),
+    pullRequestNumber: zod_1.z.number().int().optional(),
+    selectedTaskIds: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+    taskCohortId: exports.ImplementTaskCohortIdSchema.optional(),
+    fileCount: zod_1.z.number().int().optional(),
+    updatedAt: zod_1.z.string().optional(),
+    proofSource: implement_patch_detail_schema_1.ImplementProofSourceSchema.optional(),
+    proofInvalidReason: zod_1.z.string().optional(),
+});
+exports.ImplementReadinessSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    ready: zod_1.z.boolean(),
+    blockers: zod_1.z.array(exports.ImplementReadinessBlockerSchema),
+    repository: zod_1.z.object({
+        id: zod_1.z.string().uuid(),
+        owner: zod_1.z.string(),
+        name: zod_1.z.string(),
+        fullName: zod_1.z.string(),
+        defaultBranch: zod_1.z.string(),
+        url: zod_1.z.string(),
+    }).optional(),
+    permissions: zod_1.z.object({
+        contentsWrite: zod_1.z.boolean(),
+        pullRequestsWrite: zod_1.z.boolean(),
+        issuesWrite: zod_1.z.boolean(),
+    }),
+    taskSummary: zod_1.z.object({
+        total: zod_1.z.number(),
+        selectable: zod_1.z.number(),
+    }),
+    /** Patch the user should act on next (pushed > validated > draft > pr_created; excludes failed/rejected). */
+    activePatchSet: exports.ImplementLatestPatchSetSchema.optional(),
+    /** Most recently updated patch that reached pr_created (completed handoff); unrelated to active queue priority. */
+    latestCompletedPatchSet: exports.ImplementLatestPatchSetSchema.optional(),
+});
+/**
+ * SSOT for selectableCount and orchestrate initial-mode eligibility (readiness route + PATCH planner).
+ */
+exports.IMPLEMENT_TASK_SELECTABLE_STATUSES = [
+    'approved',
+    'ready',
+    'todo',
+    'not_started',
+    'in_progress',
+    'in_review',
+    'review_failed',
+];
+/**
+ * Tasks that have already been patched but are eligible for iterative improvement.
+ */
+exports.IMPLEMENT_TASK_ITERABLE_STATUSES = [
+    'completed',
+    'done',
+    'in_review',
+    'accepted',
+];
+/**
+ * Tasks that failed and can be repaired.
+ */
+exports.IMPLEMENT_TASK_REPAIRABLE_STATUSES = [
+    'failed',
+    'validation_failed',
+    'push_failed',
+    'pr_failed',
+    'review_failed',
+];
+/**
+ * Tasks excluded from all orchestration modes.
+ */
+exports.IMPLEMENT_TASK_EXCLUDED_STATUSES = [
+    'blocked',
+    'cancelled',
+    'archived',
+    'superseded',
+];
+/** Sprint I1: readiness payload additions (active patch histogram + batch gates). */
+exports.ImplementReadinessV2Schema = exports.ImplementReadinessSchema.extend({
+    activePatchCounts: zod_1.z.object({
+        draft: zod_1.z.number().int().nonnegative(),
+        validated: zod_1.z.number().int().nonnegative(),
+        pushed: zod_1.z.number().int().nonnegative(),
+        pr_created: zod_1.z.number().int().nonnegative(),
+        failed: zod_1.z.number().int().nonnegative(),
+        rejected: zod_1.z.number().int().nonnegative(),
+    }),
+    remainingTaskCount: zod_1.z.number().int().nonnegative(),
+    inReviewTaskCount: zod_1.z.number().int().nonnegative(),
+    readyForBatchGeneration: zod_1.z.boolean(),
+    /** R2: minimum product realisation on the active Implement patch (when evaluable). */
+    realisationGate: product_realization_schema_1.ProductRealisationGateResultSchema.optional(),
+});
+/** Fast counts-only Implement readiness (no GitHub). */
+exports.ImplementReadinessLiteSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    status: zod_1.z.enum(['blocked', 'ready', 'running', 'complete']),
+    taskCounts: zod_1.z.object({
+        total: zod_1.z.number().int().nonnegative(),
+        selectable: zod_1.z.number().int().nonnegative(),
+        remaining: zod_1.z.number().int().nonnegative(),
+        inReview: zod_1.z.number().int().nonnegative(),
+    }),
+    patchCounts: zod_1.z.object({
+        draft: zod_1.z.number().int().nonnegative(),
+        validated: zod_1.z.number().int().nonnegative(),
+        pushed: zod_1.z.number().int().nonnegative(),
+        pr_created: zod_1.z.number().int().nonnegative(),
+        failed: zod_1.z.number().int().nonnegative(),
+        rejected: zod_1.z.number().int().nonnegative(),
+    }),
+    hasBlockingPatch: zod_1.z.boolean(),
+    hasHonestPr: zod_1.z.boolean(),
+    knowledgeBlockedReason: zod_1.z.string().nullable(),
+});
+/** Heavy Implement diagnostics (GitHub + realisation + first-batch plan). */
+exports.ImplementDiagnosticsSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    repository: exports.ImplementReadinessSchema.shape.repository,
+    permissions: exports.ImplementReadinessSchema.shape.permissions,
+    branchSha: zod_1.z.string(),
+    installationFound: zod_1.z.boolean(),
+    permissionCheckFailed: zod_1.z.boolean(),
+    realisationGate: product_realization_schema_1.ProductRealisationGateResultSchema.optional(),
+    firstBatchPlan: implement_first_batch_schema_1.ImplementSuggestedFirstBatchResponseSchema.optional(),
+    degraded: zod_1.z.boolean(),
+    /** Fail-fast operator hints (e.g. missing @types that will Error Vercel in ~15s). */
+    operatorHints: zod_1.z.array(zod_1.z.string()).optional(),
+});
+exports.GeneratedFilePatchSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    content: zod_1.z.string(),
+    operation: zod_1.z.enum(["create", "update", "delete"]),
+    reason: zod_1.z.string(),
+    sourceTaskIds: zod_1.z.array(zod_1.z.string().uuid()),
+});
+exports.ImplementPatchTraceabilitySchema = zod_1.z.object({
+    taskId: zod_1.z.string().uuid(),
+    filePaths: zod_1.z.array(zod_1.z.string()).min(1),
+    acceptanceCriteriaIds: zod_1.z.array(zod_1.z.string()).optional(),
+});
+exports.ImplementPatchPayloadSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    workflowRunId: zod_1.z.string().uuid().optional(),
+    patchId: zod_1.z.string().uuid(),
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()).min(1),
+    taskCohortId: exports.ImplementTaskCohortIdSchema.optional(),
+    files: zod_1.z.array(exports.GeneratedFilePatchSchema).min(1),
+    traceability: zod_1.z.array(exports.ImplementPatchTraceabilitySchema),
+});
+exports.ImplementationPatchSetSchema = zod_1.z.object({
+    patchSetId: zod_1.z.string().uuid(),
+    files: zod_1.z.array(exports.GeneratedFilePatchSchema),
+    guardianScore: zod_1.z.number().nullable(),
+});
+exports.ImplementGenerationModeSchema = zod_1.z.enum([
+    'initial',
+    'iterate',
+    'repair',
+    'regenerate',
+]);
+exports.PatchRepairContextSchema = zod_1.z.object({
+    failedPatchId: zod_1.z.string().uuid(),
+    validationFailures: zod_1.z
+        .array(zod_1.z.object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+        filePath: zod_1.z.string().optional(),
+    }))
+        .optional(),
+    dependencyDiagnostics: zod_1.z.array(zod_1.z.string()).optional(),
+});
+exports.ImplementationGenerateRequestSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()).min(1),
+    orchestrationId: zod_1.z.string().uuid().optional(),
+    mode: exports.ImplementGenerationModeSchema.default('initial'),
+    repairContext: exports.PatchRepairContextSchema.optional(),
+});
+exports.ImplementationPushRequestSchema = zod_1.z.object({
+    branchName: zod_1.z.string().min(1).max(255).optional(),
+    /** When false (default), reuse/amend an open cohort PR branch instead of spawning a new one. */
+    forceNewPr: zod_1.z.boolean().optional(),
+});
+exports.ImplementationPushResponseSchema = zod_1.z.object({
+    patchSetId: zod_1.z.string().uuid(),
+    branchName: zod_1.z.string(),
+    commitSha: zod_1.z.string(),
+    repoOwner: zod_1.z.string(),
+    repoName: zod_1.z.string(),
+    pullRequestUrl: zod_1.z.string().url().optional(),
+    pullRequestNumber: zod_1.z.number().int().positive().optional(),
+    updatedTaskCount: zod_1.z.number().int().nonnegative(),
+    selectedTaskIds: zod_1.z.array(zod_1.z.string()),
+    reconciliationError: zod_1.z.string().optional(),
+});
+exports.ImplementationPRCreateRequestSchema = zod_1.z.object({
+    title: zod_1.z.string().optional(),
+    /** Operator acknowledgment for domain-layer-only patches (min 10 chars). Does not unlock Deploy/Review. */
+    operatorOverrideReason: zod_1.z.string().min(10).optional(),
+    domainLayerOnly: zod_1.z.boolean().optional(),
+});
+exports.ImplementationPRCreateResponseSchema = zod_1.z.object({
+    status: zod_1.z.enum(["created", "existing"]),
+    pullRequestNumber: zod_1.z.number(),
+    pullRequestUrl: zod_1.z.string().url(),
+    branchName: zod_1.z.string(),
+    patchSetId: zod_1.z.string().uuid(),
+    updatedTaskCount: zod_1.z.number().int().nonnegative(),
+    selectedTaskIds: zod_1.z.array(zod_1.z.string()),
+    idempotent: zod_1.z.boolean(),
+    /** True when an existing open cohort PR was amended instead of opening a new PR. */
+    repairMode: zod_1.z.boolean().optional(),
+    supersession: exports.ImplementPatchSupersessionSchema.optional(),
+    reconciliationError: zod_1.z.string().optional(),
+});
+exports.PatchCheckResultSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    status: zod_1.z.enum(['pass', 'fail', 'warning']),
+    message: zod_1.z.string(),
+    filePath: zod_1.z.string().optional(),
+});
+exports.ImplementationPatchValidateResponseSchema = zod_1.z.object({
+    patchSetId: zod_1.z.string().uuid(),
+    status: zod_1.z.enum(['validated', 'failed']),
+    checks: zod_1.z.array(exports.PatchCheckResultSchema),
+});
+exports.ImplementProofErrorPhaseSchema = zod_1.z.enum([
+    'target_selection',
+    'model_generation',
+    'repair_generation',
+    'post_generation_guard',
+    'target_obedience',
+    'validation',
+    'push',
+    'open_pr',
+    'writeback',
+    'readiness',
+]);
+exports.ImplementProofErrorCodeSchema = zod_1.z.enum([
+    'NO_PACKET_GRADE_TASKS',
+    'PLANNER_TIMEOUT',
+    'GENERATOR_JSX_IN_TS',
+    'PATCH_DID_NOT_TOUCH_EXPECTED_FILES',
+    'PATCH_OUTSIDE_PACKET_SCOPE',
+    'PATCH_STATIC_TYPECHECK_FAILED',
+    'MODEL_TIMEOUT',
+    'PATCH_WRITEBACK_FAILED',
+    'PATCH_PUSH_FAILED',
+    'OPEN_PR_FAILED',
+    'TRACEABILITY_MISSING',
+    'READINESS_TIMEOUT',
+    'STALE_PATCH_BLOCKING',
+    'TASK_POOL_DRAINED',
+]);
+exports.ImplementTypedFailureSchema = zod_1.z.object({
+    code: exports.ImplementProofErrorCodeSchema.or(zod_1.z.string().min(1)),
+    phase: exports.ImplementProofErrorPhaseSchema,
+    message: zod_1.z.string(),
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()),
+    targetFiles: zod_1.z.array(zod_1.z.string()),
+    generatedFiles: zod_1.z.array(zod_1.z.string()),
+    patchSetId: zod_1.z.string().uuid().nullable(),
+    firstValidationError: zod_1.z.string().nullable(),
+    details: zod_1.z.record(zod_1.z.unknown()),
+});
+exports.RunSelectedProofRequestSchema = zod_1.z.object({
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()).min(1).max(1).optional(),
+    engine: zod_1.z.literal('openai_patch').default('openai_patch'),
+    mode: zod_1.z.literal('proof_1x1').default('proof_1x1'),
+    autoValidate: zod_1.z.boolean().default(true),
+    autoPush: zod_1.z.boolean().default(true),
+    autoOpenPr: zod_1.z.boolean().default(true),
+    stopAfterFirstPr: zod_1.z.boolean().default(true),
+});
+const RunSelectedProofSuccessDataSchema = zod_1.z.object({
+    patchId: zod_1.z.string().uuid(),
+    branch: zod_1.z.string(),
+    prNumber: zod_1.z.number().int().positive(),
+    prUrl: zod_1.z.string().url(),
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()),
+    targetFiles: zod_1.z.array(zod_1.z.string()),
+    generatedFiles: zod_1.z.array(zod_1.z.string()),
+    kgWritten: zod_1.z.boolean(),
+});
+exports.RunSelectedProofResponseSchema = zod_1.z.union([
+    zod_1.z.object({
+        success: zod_1.z.literal(true),
+        data: RunSelectedProofSuccessDataSchema,
+    }),
+    zod_1.z.object({
+        success: zod_1.z.literal(false),
+        error: exports.ImplementTypedFailureSchema,
+    }),
+]);
+exports.RecoverStalePipelineReasonCodeSchema = zod_1.z.enum([
+    'GENERATOR_JSX_IN_TS',
+    'PATCH_STATIC_TYPECHECK_FAILED',
+    'PATCH_DID_NOT_TOUCH_EXPECTED_FILES',
+    'STALE_DRAFT_RELEASED',
+    'BYPASS_PR_REVOKED_AS_PROOF',
+    'PIPELINE_STATE_REPAIRED',
+]);
+exports.RecoverStalePipelineResponseSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: zod_1.z.object({
+        quarantinedPatchIds: zod_1.z.array(zod_1.z.string().uuid()),
+        releasedTaskIds: zod_1.z.array(zod_1.z.string().uuid()),
+        revokedBypassPatchIds: zod_1.z.array(zod_1.z.string().uuid()),
+        reasonCodes: zod_1.z.array(exports.RecoverStalePipelineReasonCodeSchema),
+        activePatchSet: zod_1.z.null(),
+    }),
+});
+/** POST …/patches/:patchSetId/proof-source — operator downgrade of invalid PR proof (#1249). */
+exports.ImplementSetProofSourceRequestSchema = zod_1.z.object({
+    proofSource: implement_patch_detail_schema_1.ImplementProofSourceSchema,
+    reason: zod_1.z.string().max(2000).optional(),
+    operator: zod_1.z.string().max(200).optional(),
+});
+exports.ImplementSetProofSourceResponseSchema = zod_1.z.object({
+    patchSetId: zod_1.z.string().uuid(),
+    status: zod_1.z.enum([
+        "draft",
+        "validated",
+        "pushed",
+        "pr_created",
+        "failed",
+        "rejected",
+        "quarantined",
+    ]),
+    proofSource: implement_patch_detail_schema_1.ImplementProofSourceSchema,
+    proofInvalidReason: zod_1.z.string().nullable(),
+});
+exports.ImplementationBatchDeliveryModeSchema = zod_1.z.enum([
+    'draft_only',
+    'auto_validate',
+    'auto_pr',
+]);
+exports.ProcessImplementationBatchResultSchema = zod_1.z.object({
+    batchId: zod_1.z.string(),
+    status: zod_1.z.enum(['completed', 'failed']),
+    patchSetId: zod_1.z.string().uuid().optional(),
+    fileCount: zod_1.z.number().int().optional(),
+    error: zod_1.z.string().optional(),
+    errorCode: zod_1.z.string().optional(),
+    branchName: zod_1.z.string().optional(),
+    commitSha: zod_1.z.string().optional(),
+    prNumber: zod_1.z.number().int().optional(),
+    prUrl: zod_1.z.string().url().optional(),
+});
+/** @deprecated Use ImplementPatchSetListItemSchema / detail status enums from implement-patch-detail (Sprint I1). */
+exports.ImplementPatchHistoryStatusSchema = zod_1.z.enum([
+    'draft',
+    'validated',
+    'pushed',
+    'pr_created',
+    'failed',
+    'rejected',
+]);
+/** @deprecated Use ImplementPatchSetListItemSchema from implement-patch-detail (Sprint I1). */
+exports.ImplementPatchHistoryItemSchema = zod_1.z.object({
+    artifactId: zod_1.z.string().uuid(),
+    status: exports.ImplementPatchHistoryStatusSchema,
+    branchName: zod_1.z.string().nullable(),
+    commitSha: zod_1.z.string().nullable(),
+    pullRequestUrl: zod_1.z.string().nullable(),
+    pullRequestNumber: zod_1.z.number().int().nullable(),
+    selectedTaskIds: zod_1.z.array(zod_1.z.string()),
+    fileCount: zod_1.z.number().int().nullable(),
+    updatedAt: zod_1.z.string(),
+    proofSource: implement_patch_detail_schema_1.ImplementProofSourceSchema.optional(),
+    proofInvalidReason: zod_1.z.string().optional(),
+});
+/** @deprecated Use ImplementPatchSetDetailPayloadSchema from implement-patch-detail (Sprint I1). */
+exports.ImplementPatchDetailSchema = exports.ImplementPatchHistoryItemSchema.extend({
+    validation: zod_1.z
+        .object({
+        ok: zod_1.z.boolean(),
+        errors: zod_1.z.array(zod_1.z.string()).optional(),
+        warnings: zod_1.z.array(zod_1.z.string()).optional(),
+    })
+        .nullable(),
+    taskStatuses: zod_1.z.array(zod_1.z.object({
+        taskId: zod_1.z.string().uuid(),
+        status: zod_1.z.string(),
+    })),
+});
+/** @deprecated Use ImplementPatchSetDetailPayloadSchema wrapped in ApiResponse via route handler (Sprint I1). */
+exports.ImplementPatchDetailResponseSchema = zod_1.z.object({
+    patch: exports.ImplementPatchDetailSchema,
+});
+/** @deprecated Use ImplementPatchSetListResponseSchema from implement-patch-detail (Sprint I1). */
+exports.ImplementPatchHistoryResponseSchema = zod_1.z.object({
+    patches: zod_1.z.array(exports.ImplementPatchHistoryItemSchema),
+});
+/* ------------------------------------------------------------------ */
+/*  Canonical Orchestration Engine — Durable Implementation Batching   */
+/* ------------------------------------------------------------------ */
+exports.ImplementOrchestrationScopeSchema = zod_1.z.enum([
+    'eligible',
+    'selected',
+    'failed',
+    'domain',
+]);
+exports.ImplementOrchestrationBatchStatusSchema = zod_1.z.enum([
+    'planned',
+    'queued',
+    'running',
+    'completed',
+    'failed',
+    'skipped',
+]);
+exports.ImplementOrchestrationStatusEnumSchema = zod_1.z.enum([
+    'planned',
+    'queued',
+    'running',
+    'completed',
+    'failed',
+    'partially_failed',
+    'cancelled',
+]);
+exports.ImplementOrchestrationWarningSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    severity: zod_1.z.enum(['info', 'warning', 'error']),
+});
+exports.ImplementOrchestrationBatchSchema = zod_1.z.object({
+    batchId: zod_1.z.string().uuid(),
+    domain: zod_1.z.string(),
+    layer: zod_1.z.string(),
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()).min(1),
+    status: exports.ImplementOrchestrationBatchStatusSchema,
+    dependsOnBatchIds: zod_1.z.array(zod_1.z.string().uuid()).default([]),
+    patchSetId: zod_1.z.string().uuid().optional(),
+    error: zod_1.z.string().optional(),
+    pullRequestUrl: zod_1.z.string().optional(),
+});
+exports.ImplementOrchestrationRequestSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    mode: exports.ImplementGenerationModeSchema.default('initial'),
+    scope: exports.ImplementOrchestrationScopeSchema.default('eligible'),
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+    domains: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Default 3 matches openai_patch per-patch cap (was 8 while hard-capped to 1 — the "lie"). */
+    batchSize: zod_1.z.number().int().min(1).max(16).default(3),
+    concurrency: zod_1.z.number().int().min(1).max(5).default(2),
+    dryRun: zod_1.z.boolean().default(false),
+    /** When true, skips open-PR / in-review guardrail on orchestration start. */
+    force: zod_1.z.boolean().optional().default(false),
+    /** When true, allow a second open PR for the same task cohort (split/batch override). */
+    forceNewPr: zod_1.z.boolean().optional().default(false),
+});
+exports.ImplementOrchestrationResponseSchema = zod_1.z.object({
+    orchestrationId: zod_1.z.string().uuid(),
+    status: exports.ImplementOrchestrationStatusEnumSchema,
+    mode: exports.ImplementGenerationModeSchema,
+    totalTasks: zod_1.z.number().int().nonnegative(),
+    totalBatches: zod_1.z.number().int().nonnegative(),
+    batches: zod_1.z.array(exports.ImplementOrchestrationBatchSchema),
+    warnings: zod_1.z.array(exports.ImplementOrchestrationWarningSchema).default([]),
+});
+exports.ImplementOrchestrationFailureSchema = zod_1.z.object({
+    batchId: zod_1.z.string().uuid(),
+    taskId: zod_1.z.string().uuid().optional(),
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    retryable: zod_1.z.boolean(),
+});
+exports.ImplementOrchestrationStatusSchema = zod_1.z.object({
+    orchestrationId: zod_1.z.string().uuid(),
+    status: exports.ImplementOrchestrationStatusEnumSchema,
+    progress: zod_1.z.object({
+        completedTasks: zod_1.z.number().int().nonnegative(),
+        failedTasks: zod_1.z.number().int().nonnegative(),
+        totalTasks: zod_1.z.number().int().nonnegative(),
+        completedBatches: zod_1.z.number().int().nonnegative(),
+        failedBatches: zod_1.z.number().int().nonnegative(),
+        totalBatches: zod_1.z.number().int().nonnegative(),
+    }),
+    currentBatches: zod_1.z.array(exports.ImplementOrchestrationBatchSchema),
+    failures: zod_1.z.array(exports.ImplementOrchestrationFailureSchema),
+});
+/** Governed one-button implement run (runId === orchestrationId). */
+exports.ImplementRunStrategySchema = zod_1.z.enum([
+    'safe_parallel',
+    'sequential',
+    'repair_only',
+    'selected',
+]);
+exports.ImplementRunEnginePreferenceSchema = zod_1.z.enum(['openai_patch', 'cursor_cloud', 'codex']);
+exports.ImplementRunStartRequestSchema = zod_1.z.object({
+    strategy: exports.ImplementRunStrategySchema.default('safe_parallel'),
+    maxParallelBatches: zod_1.z.number().int().min(1).max(5).default(1),
+    maxTasksPerBatch: zod_1.z.number().int().min(1).max(3).default(1),
+    maxRepairAttemptsPerPatch: zod_1.z.number().int().min(0).max(3).default(1),
+    enginePreference: zod_1.z.array(exports.ImplementRunEnginePreferenceSchema).default(['openai_patch']),
+    skipPreviouslyQuarantined: zod_1.z.boolean().default(true),
+    stopAfterFirstPr: zod_1.z.boolean().default(false),
+    /** Explicit task selection for strategy=selected or operator override. */
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+});
+exports.ImplementRunGovernedConfigSchema = zod_1.z.object({
+    strategy: exports.ImplementRunStrategySchema,
+    maxParallelBatches: zod_1.z.number().int(),
+    maxTasksPerBatch: zod_1.z.number().int(),
+    maxRepairAttemptsPerPatch: zod_1.z.number().int(),
+    stopAfterFirstPr: zod_1.z.boolean(),
+    enginePreference: zod_1.z.array(exports.ImplementRunEnginePreferenceSchema),
+    skipPreviouslyQuarantined: zod_1.z.boolean(),
+});
+exports.ImplementRunStartResponseSchema = zod_1.z.object({
+    runId: zod_1.z.string().uuid(),
+    orchestrationId: zod_1.z.string().uuid(),
+    status: exports.ImplementOrchestrationStatusEnumSchema,
+    mode: exports.ImplementGenerationModeSchema,
+    totalTasks: zod_1.z.number().int().nonnegative(),
+    totalBatches: zod_1.z.number().int().nonnegative(),
+    batches: zod_1.z.array(exports.ImplementOrchestrationBatchSchema),
+    warnings: zod_1.z.array(exports.ImplementOrchestrationWarningSchema).default([]),
+    governedConfig: exports.ImplementRunGovernedConfigSchema,
+});
+exports.ImplementRunStatusSchema = exports.ImplementOrchestrationStatusSchema.extend({
+    runId: zod_1.z.string().uuid(),
+    projectId: zod_1.z.string().uuid(),
+    paused: zod_1.z.boolean(),
+    createdPrCount: zod_1.z.number().int().nonnegative(),
+    quarantinedBatchCount: zod_1.z.number().int().nonnegative(),
+    governedConfig: exports.ImplementRunGovernedConfigSchema.optional(),
+});