@velum-labs/routekit-eval-setup 1.3.2 → 1.5.0

package/dist/services/task-seed/service.d.ts

@@ -0,0 +1,906 @@
+import { Context, Effect, Layer } from "effect";
+import { type RepositoryPreparationCacheV1 } from "../../adapters/repository-command-runner.js";
+import { RepositoryFoundryError } from "../../errors.js";
+import type { RepositoryBehaviorMapV1, RepositoryCommandRecipeV1 } from "../../repository-behavior-protocol.js";
+import { type RepositoryHiddenFixtureSuiteV1 } from "../../repository-fixture-protocol.js";
+import { type RepositorySeedCrossBatchQualificationV1, type RepositoryTaskSeedV1 } from "../../repository-task-seed-protocol.js";
+import type { RepositorySeedQualificationProgressV1 } from "../../repository-seed-qualification-progress-protocol.js";
+export declare const deriveHistoricalSeedEnvironmentV1: (input: {
+    readonly repositoryRoot: string;
+    readonly commit: string;
+    readonly gradeRecipes: readonly RepositoryCommandRecipeV1[];
+    /** Agentic planning is explicit; omitted preserves the legacy preparation policy. */
+    readonly executionMode?: "source" | "emitted" | "repository-default";
+    readonly testPaths: readonly string[];
+    readonly changedPaths: readonly string[];
+}) => Effect.Effect<{
+    readonly protectedControlPaths: readonly string[];
+    readonly trustedPreparationRecipes: readonly {
+        readonly id: string;
+        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+        readonly cwd: string;
+        readonly executable: string;
+        readonly args: readonly string[];
+        readonly timeoutMs: number;
+    }[];
+    readonly candidateValidationRecipes: readonly {
+        readonly id: string;
+        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+        readonly cwd: string;
+        readonly executable: string;
+        readonly args: readonly string[];
+        readonly timeoutMs: number;
+    }[];
+    readonly baselineGradeRecipes: readonly {
+        readonly id: string;
+        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+        readonly cwd: string;
+        readonly executable: string;
+        readonly args: readonly string[];
+        readonly timeoutMs: number;
+    }[];
+    readonly gradeRecipes: readonly {
+        readonly id: string;
+        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+        readonly cwd: string;
+        readonly executable: string;
+        readonly args: readonly string[];
+        readonly timeoutMs: number;
+    }[];
+    readonly packageManager?: {
+        readonly name: "pnpm";
+        readonly version: string;
+    } | undefined;
+    readonly lockfilePath?: string | undefined;
+}, RepositoryFoundryError, never>;
+export type TaskSeedShape = {
+    readonly extractHistorical: (map: RepositoryBehaviorMapV1) => Effect.Effect<readonly RepositoryTaskSeedV1[], RepositoryFoundryError>;
+    readonly qualifyHistorical: (input: {
+        readonly repositoryRoot: string;
+        readonly seed: RepositoryTaskSeedV1;
+        readonly hiddenFixtureSuite?: RepositoryHiddenFixtureSuiteV1;
+        readonly repetitions?: number;
+    }) => Effect.Effect<RepositoryTaskSeedV1, RepositoryFoundryError>;
+    readonly qualifyHistoricalAcrossBatches: (input: {
+        readonly repositoryRoot: string;
+        readonly seed: RepositoryTaskSeedV1;
+        readonly batches?: number;
+        readonly hiddenFixtureSuite?: RepositoryHiddenFixtureSuiteV1;
+        readonly repetitionsPerBatch?: number;
+    }) => Effect.Effect<RepositorySeedCrossBatchQualificationV1, RepositoryFoundryError>;
+};
+declare const TaskSeed_base: Context.ServiceClass<TaskSeed, "@velum-labs/routekit-eval-setup/TaskSeed", TaskSeedShape>;
+export declare class TaskSeed extends TaskSeed_base {
+}
+export declare const extractHistoricalTaskSeedsV1: (map: {
+    readonly version: 1;
+    readonly repository: {
+        readonly root: string;
+        readonly requestedRef: string;
+        readonly commit: string;
+        readonly tree: string;
+    };
+    readonly packages: readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly path: string;
+        readonly manifestPath: string;
+        readonly dependencyPackageIds: readonly string[];
+        readonly publicExports: readonly string[];
+    }[];
+    readonly publicSurfaces: readonly {
+        readonly kind: "package-export" | "cli-command" | "http-endpoint" | "documented-example";
+        readonly id: string;
+        readonly path: string;
+        readonly symbols: readonly string[];
+        readonly packageId?: string | undefined;
+    }[];
+    readonly protocols: readonly {
+        readonly id: string;
+        readonly path: string;
+        readonly name: string;
+        readonly kind: "schema" | "wire" | "persistence" | "internal-boundary";
+    }[];
+    readonly commands: readonly {
+        readonly id: string;
+        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+        readonly cwd: string;
+        readonly executable: string;
+        readonly args: readonly string[];
+        readonly timeoutMs: number;
+    }[];
+    readonly tests: readonly {
+        readonly id: string;
+        readonly path: string;
+        readonly names: readonly string[];
+        readonly commandIds: readonly string[];
+    }[];
+    readonly testBindings: readonly {
+        readonly testId: string;
+        readonly targetIds: readonly string[];
+        readonly signals: readonly ("direct-import" | "symbol-reference" | "fixture-reference" | "package-ownership" | "git-cochange" | "coverage" | "reviewed-hypothesis")[];
+        readonly confidence: "high" | "medium" | "hypothesis";
+    }[];
+    readonly historyEpisodes: readonly {
+        readonly id: string;
+        readonly commit: string;
+        readonly changedPaths: readonly {
+            readonly kind: "protocol" | "schema" | "test" | "documentation" | "implementation" | "operational" | "other";
+            readonly path: string;
+            readonly status: "added" | "modified" | "deleted" | "renamed" | "copied";
+            readonly previousPath?: string | undefined;
+        }[];
+        readonly testPaths: readonly string[];
+        readonly implementationPaths: readonly string[];
+        readonly protocolPaths: readonly string[];
+        readonly occurredAt: string;
+        readonly subject: string;
+        readonly body: string;
+        readonly behaviorChanging: boolean;
+        readonly seedEligible: boolean;
+        readonly parentCommit?: string | undefined;
+    }[];
+    readonly workloadSignals: readonly {
+        readonly id: string;
+        readonly kind: "recurring-cochange" | "recurring-behavior-change" | "recurring-command" | "public-contract" | "reviewed-critical";
+        readonly label: string;
+        readonly episodeIds: readonly string[];
+        readonly pathPatterns: readonly string[];
+        readonly frequency: number;
+        readonly importance: "critical" | "high" | "normal";
+        readonly confidence: "high" | "medium" | "review-required";
+    }[];
+    readonly blindSpots: readonly {
+        readonly id: string;
+        readonly kind: "unmapped-test" | "unreconstructible-command" | "unsupported-language" | "external-service" | "history-gap" | "unknown-relationship";
+        readonly detail: string;
+        readonly paths: readonly string[];
+    }[];
+}, options?: {
+    readonly deferEnvironment?: boolean;
+} | undefined) => Effect.Effect<{
+    readonly id: string;
+    readonly source: {
+        readonly kind: "historical-fix";
+        readonly changeEpisodeId: string;
+    } | {
+        readonly kind: "historical-feature";
+        readonly changeEpisodeId: string;
+    } | {
+        readonly kind: "historical-refactor";
+        readonly changeEpisodeId: string;
+    } | {
+        readonly kind: "existing-test";
+        readonly testIds: readonly string[];
+    } | {
+        readonly kind: "public-api";
+        readonly surfaceIds: readonly string[];
+    } | {
+        readonly kind: "schema-contract";
+        readonly protocolIds: readonly string[];
+    } | {
+        readonly kind: "production-request";
+        readonly requestId: string;
+    } | {
+        readonly kind: "reviewed-synthetic-gap";
+        readonly reviewId: string;
+    };
+    readonly version: 1;
+    readonly rejectionReasons: readonly string[];
+    readonly confidence: "high" | "medium" | "review-required";
+    readonly status: "candidate" | "qualified" | "rejected";
+    readonly capabilityEvidence: readonly {
+        readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+        readonly id: string;
+        readonly path?: string | undefined;
+    }[];
+    readonly initialState: {
+        readonly commit: string;
+        readonly parentCommit?: string | undefined;
+    };
+    readonly targetBehavior: readonly {
+        readonly id: string;
+        readonly description: string;
+        readonly critical: boolean;
+        readonly evidence: readonly {
+            readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+            readonly id: string;
+            readonly path?: string | undefined;
+        }[];
+    }[];
+    readonly baselineObservations: readonly {
+        readonly id: string;
+        readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+        readonly subjectId: string;
+        readonly outcome: "pass" | "fail" | "unknown";
+        readonly detail: string;
+    }[];
+    readonly preChangeObservations: readonly {
+        readonly id: string;
+        readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+        readonly subjectId: string;
+        readonly outcome: "pass" | "fail" | "unknown";
+        readonly detail: string;
+    }[];
+    readonly postChangeObservations: readonly {
+        readonly id: string;
+        readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+        readonly subjectId: string;
+        readonly outcome: "pass" | "fail" | "unknown";
+        readonly detail: string;
+    }[];
+    readonly candidateTestIds: readonly string[];
+    readonly risks: readonly ("review-required" | "external-service" | "ambiguous-intent" | "bundled-change" | "flaky-baseline" | "reference-only-oracle" | "weak-test-delta" | "unrealistic-mutation" | "private-context" | "cross-batch-instability")[];
+    readonly summary: string;
+    readonly environment: {
+        readonly protectedControlPaths: readonly string[];
+        readonly trustedPreparationRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly candidateValidationRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly baselineGradeRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly gradeRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly packageManager?: {
+            readonly name: "pnpm";
+            readonly version: string;
+        } | undefined;
+        readonly lockfilePath?: string | undefined;
+    };
+    readonly referenceCommit?: string | undefined;
+}[], RepositoryFoundryError, never>;
+export declare const qualifyHistoricalTaskSeedV1: (input: {
+    readonly repositoryRoot: string;
+    readonly seed: RepositoryTaskSeedV1;
+    readonly hiddenFixtureSuite?: RepositoryHiddenFixtureSuiteV1;
+    readonly repetitions?: number;
+    /** Diagnostic identity only; does not change replay or qualification behavior. */
+    readonly diagnosticBatch?: number;
+    /** Scoped immutable preparation shared only by the owning qualification. */
+    readonly preparationCache?: RepositoryPreparationCacheV1;
+}) => Effect.Effect<{
+    readonly id: string;
+    readonly source: {
+        readonly kind: "historical-fix";
+        readonly changeEpisodeId: string;
+    } | {
+        readonly kind: "historical-feature";
+        readonly changeEpisodeId: string;
+    } | {
+        readonly kind: "historical-refactor";
+        readonly changeEpisodeId: string;
+    } | {
+        readonly kind: "existing-test";
+        readonly testIds: readonly string[];
+    } | {
+        readonly kind: "public-api";
+        readonly surfaceIds: readonly string[];
+    } | {
+        readonly kind: "schema-contract";
+        readonly protocolIds: readonly string[];
+    } | {
+        readonly kind: "production-request";
+        readonly requestId: string;
+    } | {
+        readonly kind: "reviewed-synthetic-gap";
+        readonly reviewId: string;
+    };
+    readonly version: 1;
+    readonly rejectionReasons: readonly string[];
+    readonly confidence: "high" | "medium" | "review-required";
+    readonly status: "candidate" | "qualified" | "rejected";
+    readonly capabilityEvidence: readonly {
+        readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+        readonly id: string;
+        readonly path?: string | undefined;
+    }[];
+    readonly initialState: {
+        readonly commit: string;
+        readonly parentCommit?: string | undefined;
+    };
+    readonly targetBehavior: readonly {
+        readonly id: string;
+        readonly description: string;
+        readonly critical: boolean;
+        readonly evidence: readonly {
+            readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+            readonly id: string;
+            readonly path?: string | undefined;
+        }[];
+    }[];
+    readonly baselineObservations: readonly {
+        readonly id: string;
+        readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+        readonly subjectId: string;
+        readonly outcome: "pass" | "fail" | "unknown";
+        readonly detail: string;
+    }[];
+    readonly preChangeObservations: readonly {
+        readonly id: string;
+        readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+        readonly subjectId: string;
+        readonly outcome: "pass" | "fail" | "unknown";
+        readonly detail: string;
+    }[];
+    readonly postChangeObservations: readonly {
+        readonly id: string;
+        readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+        readonly subjectId: string;
+        readonly outcome: "pass" | "fail" | "unknown";
+        readonly detail: string;
+    }[];
+    readonly candidateTestIds: readonly string[];
+    readonly risks: readonly ("review-required" | "external-service" | "ambiguous-intent" | "bundled-change" | "flaky-baseline" | "reference-only-oracle" | "weak-test-delta" | "unrealistic-mutation" | "private-context" | "cross-batch-instability")[];
+    readonly summary: string;
+    readonly environment: {
+        readonly protectedControlPaths: readonly string[];
+        readonly trustedPreparationRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly candidateValidationRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly baselineGradeRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly gradeRecipes: readonly {
+            readonly id: string;
+            readonly kind: "schema" | "test" | "build" | "check" | "custom";
+            readonly cwd: string;
+            readonly executable: string;
+            readonly args: readonly string[];
+            readonly timeoutMs: number;
+        }[];
+        readonly packageManager?: {
+            readonly name: "pnpm";
+            readonly version: string;
+        } | undefined;
+        readonly lockfilePath?: string | undefined;
+    };
+    readonly referenceCommit?: string | undefined;
+}, RepositoryFoundryError, never>;
+export declare const qualifyHistoricalTaskSeedAcrossBatchesV1: (input: {
+    readonly repositoryRoot: string;
+    readonly seed: RepositoryTaskSeedV1;
+    readonly batches?: number;
+    readonly hiddenFixtureSuite?: RepositoryHiddenFixtureSuiteV1;
+    readonly repetitionsPerBatch?: number;
+}) => Effect.Effect<{
+    readonly seed: {
+        readonly id: string;
+        readonly source: {
+            readonly kind: "historical-fix";
+            readonly changeEpisodeId: string;
+        } | {
+            readonly kind: "historical-feature";
+            readonly changeEpisodeId: string;
+        } | {
+            readonly kind: "historical-refactor";
+            readonly changeEpisodeId: string;
+        } | {
+            readonly kind: "existing-test";
+            readonly testIds: readonly string[];
+        } | {
+            readonly kind: "public-api";
+            readonly surfaceIds: readonly string[];
+        } | {
+            readonly kind: "schema-contract";
+            readonly protocolIds: readonly string[];
+        } | {
+            readonly kind: "production-request";
+            readonly requestId: string;
+        } | {
+            readonly kind: "reviewed-synthetic-gap";
+            readonly reviewId: string;
+        };
+        readonly version: 1;
+        readonly rejectionReasons: readonly string[];
+        readonly confidence: "high" | "medium" | "review-required";
+        readonly status: "candidate" | "qualified" | "rejected";
+        readonly capabilityEvidence: readonly {
+            readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+            readonly id: string;
+            readonly path?: string | undefined;
+        }[];
+        readonly initialState: {
+            readonly commit: string;
+            readonly parentCommit?: string | undefined;
+        };
+        readonly targetBehavior: readonly {
+            readonly id: string;
+            readonly description: string;
+            readonly critical: boolean;
+            readonly evidence: readonly {
+                readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+                readonly id: string;
+                readonly path?: string | undefined;
+            }[];
+        }[];
+        readonly baselineObservations: readonly {
+            readonly id: string;
+            readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+            readonly subjectId: string;
+            readonly outcome: "pass" | "fail" | "unknown";
+            readonly detail: string;
+        }[];
+        readonly preChangeObservations: readonly {
+            readonly id: string;
+            readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+            readonly subjectId: string;
+            readonly outcome: "pass" | "fail" | "unknown";
+            readonly detail: string;
+        }[];
+        readonly postChangeObservations: readonly {
+            readonly id: string;
+            readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+            readonly subjectId: string;
+            readonly outcome: "pass" | "fail" | "unknown";
+            readonly detail: string;
+        }[];
+        readonly candidateTestIds: readonly string[];
+        readonly risks: readonly ("review-required" | "external-service" | "ambiguous-intent" | "bundled-change" | "flaky-baseline" | "reference-only-oracle" | "weak-test-delta" | "unrealistic-mutation" | "private-context" | "cross-batch-instability")[];
+        readonly summary: string;
+        readonly environment: {
+            readonly protectedControlPaths: readonly string[];
+            readonly trustedPreparationRecipes: readonly {
+                readonly id: string;
+                readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                readonly cwd: string;
+                readonly executable: string;
+                readonly args: readonly string[];
+                readonly timeoutMs: number;
+            }[];
+            readonly candidateValidationRecipes: readonly {
+                readonly id: string;
+                readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                readonly cwd: string;
+                readonly executable: string;
+                readonly args: readonly string[];
+                readonly timeoutMs: number;
+            }[];
+            readonly baselineGradeRecipes: readonly {
+                readonly id: string;
+                readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                readonly cwd: string;
+                readonly executable: string;
+                readonly args: readonly string[];
+                readonly timeoutMs: number;
+            }[];
+            readonly gradeRecipes: readonly {
+                readonly id: string;
+                readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                readonly cwd: string;
+                readonly executable: string;
+                readonly args: readonly string[];
+                readonly timeoutMs: number;
+            }[];
+            readonly packageManager?: {
+                readonly name: "pnpm";
+                readonly version: string;
+            } | undefined;
+            readonly lockfilePath?: string | undefined;
+        };
+        readonly referenceCommit?: string | undefined;
+    };
+    readonly stability: {
+        readonly version: 1;
+        readonly seedId: string;
+        readonly batchesRequired: number;
+        readonly repetitionsPerBatch: number;
+        readonly stable: boolean;
+        readonly batches: readonly {
+            readonly batch: number;
+            readonly status: "qualified" | "rejected";
+            readonly phaseSignatures: readonly {
+                readonly phase: "baseline" | "pre-change" | "post-change";
+                readonly signatures: readonly string[];
+            }[];
+            readonly rejectionReasons: readonly string[];
+        }[];
+        readonly divergentPhases: readonly ("baseline" | "pre-change" | "post-change")[];
+        readonly failureSignatures: readonly {
+            readonly signature: string;
+            readonly count: number;
+        }[];
+        readonly rejectionReasons: readonly string[];
+    };
+}, RepositoryFoundryError, never>;
+export declare const repositorySeedQualificationProgressSummaryV1: (progress: RepositorySeedQualificationProgressV1) => {
+    completedBatches: number;
+    batchesRequired: number;
+    completedUnits: number;
+    unitsPerBatch: number;
+};
+/**
+ * Resume reference qualification only at completed replay boundaries. Every
+ * started replay still owns and closes its checkout scope; interruption may
+ * repeat the in-flight replay, but never a previously checkpointed repetition.
+ */
+export declare const qualifyHistoricalTaskSeedAcrossBatchesResumableV1: (input: {
+    readonly repositoryRoot: string;
+    readonly seed: RepositoryTaskSeedV1;
+    readonly bindingDigest: string;
+    readonly progress?: RepositorySeedQualificationProgressV1;
+    readonly checkpoint: (progress: RepositorySeedQualificationProgressV1) => Effect.Effect<void, RepositoryFoundryError>;
+    readonly batches?: number;
+    readonly hiddenFixtureSuite?: RepositoryHiddenFixtureSuiteV1;
+    readonly repetitionsPerBatch?: number;
+}) => Effect.Effect<{
+    qualification: {
+        readonly seed: {
+            readonly id: string;
+            readonly source: {
+                readonly kind: "historical-fix";
+                readonly changeEpisodeId: string;
+            } | {
+                readonly kind: "historical-feature";
+                readonly changeEpisodeId: string;
+            } | {
+                readonly kind: "historical-refactor";
+                readonly changeEpisodeId: string;
+            } | {
+                readonly kind: "existing-test";
+                readonly testIds: readonly string[];
+            } | {
+                readonly kind: "public-api";
+                readonly surfaceIds: readonly string[];
+            } | {
+                readonly kind: "schema-contract";
+                readonly protocolIds: readonly string[];
+            } | {
+                readonly kind: "production-request";
+                readonly requestId: string;
+            } | {
+                readonly kind: "reviewed-synthetic-gap";
+                readonly reviewId: string;
+            };
+            readonly version: 1;
+            readonly rejectionReasons: readonly string[];
+            readonly confidence: "high" | "medium" | "review-required";
+            readonly status: "candidate" | "qualified" | "rejected";
+            readonly capabilityEvidence: readonly {
+                readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+                readonly id: string;
+                readonly path?: string | undefined;
+            }[];
+            readonly initialState: {
+                readonly commit: string;
+                readonly parentCommit?: string | undefined;
+            };
+            readonly targetBehavior: readonly {
+                readonly id: string;
+                readonly description: string;
+                readonly critical: boolean;
+                readonly evidence: readonly {
+                    readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+                    readonly id: string;
+                    readonly path?: string | undefined;
+                }[];
+            }[];
+            readonly baselineObservations: readonly {
+                readonly id: string;
+                readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+                readonly subjectId: string;
+                readonly outcome: "pass" | "fail" | "unknown";
+                readonly detail: string;
+            }[];
+            readonly preChangeObservations: readonly {
+                readonly id: string;
+                readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+                readonly subjectId: string;
+                readonly outcome: "pass" | "fail" | "unknown";
+                readonly detail: string;
+            }[];
+            readonly postChangeObservations: readonly {
+                readonly id: string;
+                readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+                readonly subjectId: string;
+                readonly outcome: "pass" | "fail" | "unknown";
+                readonly detail: string;
+            }[];
+            readonly candidateTestIds: readonly string[];
+            readonly risks: readonly ("review-required" | "external-service" | "ambiguous-intent" | "bundled-change" | "flaky-baseline" | "reference-only-oracle" | "weak-test-delta" | "unrealistic-mutation" | "private-context" | "cross-batch-instability")[];
+            readonly summary: string;
+            readonly environment: {
+                readonly protectedControlPaths: readonly string[];
+                readonly trustedPreparationRecipes: readonly {
+                    readonly id: string;
+                    readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                    readonly cwd: string;
+                    readonly executable: string;
+                    readonly args: readonly string[];
+                    readonly timeoutMs: number;
+                }[];
+                readonly candidateValidationRecipes: readonly {
+                    readonly id: string;
+                    readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                    readonly cwd: string;
+                    readonly executable: string;
+                    readonly args: readonly string[];
+                    readonly timeoutMs: number;
+                }[];
+                readonly baselineGradeRecipes: readonly {
+                    readonly id: string;
+                    readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                    readonly cwd: string;
+                    readonly executable: string;
+                    readonly args: readonly string[];
+                    readonly timeoutMs: number;
+                }[];
+                readonly gradeRecipes: readonly {
+                    readonly id: string;
+                    readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                    readonly cwd: string;
+                    readonly executable: string;
+                    readonly args: readonly string[];
+                    readonly timeoutMs: number;
+                }[];
+                readonly packageManager?: {
+                    readonly name: "pnpm";
+                    readonly version: string;
+                } | undefined;
+                readonly lockfilePath?: string | undefined;
+            };
+            readonly referenceCommit?: string | undefined;
+        };
+        readonly stability: {
+            readonly version: 1;
+            readonly seedId: string;
+            readonly batchesRequired: number;
+            readonly repetitionsPerBatch: number;
+            readonly stable: boolean;
+            readonly batches: readonly {
+                readonly batch: number;
+                readonly status: "qualified" | "rejected";
+                readonly phaseSignatures: readonly {
+                    readonly phase: "baseline" | "pre-change" | "post-change";
+                    readonly signatures: readonly string[];
+                }[];
+                readonly rejectionReasons: readonly string[];
+            }[];
+            readonly divergentPhases: readonly ("baseline" | "pre-change" | "post-change")[];
+            readonly failureSignatures: readonly {
+                readonly signature: string;
+                readonly count: number;
+            }[];
+            readonly rejectionReasons: readonly string[];
+        };
+    };
+    progress: {
+        readonly version: 1;
+        readonly bindingDigest: string;
+        readonly batchesRequired: number;
+        readonly repetitionsPerBatch: number;
+        readonly completedBatches: readonly {
+            readonly batch: number;
+            readonly seed: {
+                readonly id: string;
+                readonly source: {
+                    readonly kind: "historical-fix";
+                    readonly changeEpisodeId: string;
+                } | {
+                    readonly kind: "historical-feature";
+                    readonly changeEpisodeId: string;
+                } | {
+                    readonly kind: "historical-refactor";
+                    readonly changeEpisodeId: string;
+                } | {
+                    readonly kind: "existing-test";
+                    readonly testIds: readonly string[];
+                } | {
+                    readonly kind: "public-api";
+                    readonly surfaceIds: readonly string[];
+                } | {
+                    readonly kind: "schema-contract";
+                    readonly protocolIds: readonly string[];
+                } | {
+                    readonly kind: "production-request";
+                    readonly requestId: string;
+                } | {
+                    readonly kind: "reviewed-synthetic-gap";
+                    readonly reviewId: string;
+                };
+                readonly version: 1;
+                readonly rejectionReasons: readonly string[];
+                readonly confidence: "high" | "medium" | "review-required";
+                readonly status: "candidate" | "qualified" | "rejected";
+                readonly capabilityEvidence: readonly {
+                    readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+                    readonly id: string;
+                    readonly path?: string | undefined;
+                }[];
+                readonly initialState: {
+                    readonly commit: string;
+                    readonly parentCommit?: string | undefined;
+                };
+                readonly targetBehavior: readonly {
+                    readonly id: string;
+                    readonly description: string;
+                    readonly critical: boolean;
+                    readonly evidence: readonly {
+                        readonly kind: "symbol" | "package" | "public-surface" | "protocol" | "schema" | "test" | "command" | "history-episode" | "workload-signal" | "documentation";
+                        readonly id: string;
+                        readonly path?: string | undefined;
+                    }[];
+                }[];
+                readonly baselineObservations: readonly {
+                    readonly id: string;
+                    readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+                    readonly subjectId: string;
+                    readonly outcome: "pass" | "fail" | "unknown";
+                    readonly detail: string;
+                }[];
+                readonly preChangeObservations: readonly {
+                    readonly id: string;
+                    readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+                    readonly subjectId: string;
+                    readonly outcome: "pass" | "fail" | "unknown";
+                    readonly detail: string;
+                }[];
+                readonly postChangeObservations: readonly {
+                    readonly id: string;
+                    readonly kind: "test-command" | "property" | "schema" | "event-trace" | "structural";
+                    readonly subjectId: string;
+                    readonly outcome: "pass" | "fail" | "unknown";
+                    readonly detail: string;
+                }[];
+                readonly candidateTestIds: readonly string[];
+                readonly risks: readonly ("review-required" | "external-service" | "ambiguous-intent" | "bundled-change" | "flaky-baseline" | "reference-only-oracle" | "weak-test-delta" | "unrealistic-mutation" | "private-context" | "cross-batch-instability")[];
+                readonly summary: string;
+                readonly environment: {
+                    readonly protectedControlPaths: readonly string[];
+                    readonly trustedPreparationRecipes: readonly {
+                        readonly id: string;
+                        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                        readonly cwd: string;
+                        readonly executable: string;
+                        readonly args: readonly string[];
+                        readonly timeoutMs: number;
+                    }[];
+                    readonly candidateValidationRecipes: readonly {
+                        readonly id: string;
+                        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                        readonly cwd: string;
+                        readonly executable: string;
+                        readonly args: readonly string[];
+                        readonly timeoutMs: number;
+                    }[];
+                    readonly baselineGradeRecipes: readonly {
+                        readonly id: string;
+                        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                        readonly cwd: string;
+                        readonly executable: string;
+                        readonly args: readonly string[];
+                        readonly timeoutMs: number;
+                    }[];
+                    readonly gradeRecipes: readonly {
+                        readonly id: string;
+                        readonly kind: "schema" | "test" | "build" | "check" | "custom";
+                        readonly cwd: string;
+                        readonly executable: string;
+                        readonly args: readonly string[];
+                        readonly timeoutMs: number;
+                    }[];
+                    readonly packageManager?: {
+                        readonly name: "pnpm";
+                        readonly version: string;
+                    } | undefined;
+                    readonly lockfilePath?: string | undefined;
+                };
+                readonly referenceCommit?: string | undefined;
+            };
+        }[];
+        readonly activeUnits: readonly {
+            readonly batch: number;
+            readonly phase: "baseline" | "pre-change" | "post-change";
+            readonly repetition: number;
+            readonly results: readonly {
+                readonly recipeId: string;
+                readonly commit: string;
+                readonly repetition: number;
+                readonly stdout: string;
+                readonly stderr: string;
+                readonly exitCode: number | null;
+                readonly stage: "trusted-preparation" | "candidate-validation" | "grade";
+                readonly timedOut: boolean;
+                readonly outputTruncated: boolean;
+                readonly durationMs: number;
+                readonly trustedPreparationResults: readonly {
+                    readonly recipeId: string;
+                    readonly commit: string;
+                    readonly repetition: number;
+                    readonly stdout: string;
+                    readonly stderr: string;
+                    readonly exitCode: number | null;
+                    readonly stage: "trusted-preparation" | "candidate-validation" | "grade";
+                    readonly timedOut: boolean;
+                    readonly outputTruncated: boolean;
+                    readonly durationMs: number;
+                    readonly testReporter?: "vitest-v1" | undefined;
+                }[];
+                readonly candidateValidationResults: readonly {
+                    readonly recipeId: string;
+                    readonly commit: string;
+                    readonly repetition: number;
+                    readonly stdout: string;
+                    readonly stderr: string;
+                    readonly exitCode: number | null;
+                    readonly stage: "trusted-preparation" | "candidate-validation" | "grade";
+                    readonly timedOut: boolean;
+                    readonly outputTruncated: boolean;
+                    readonly durationMs: number;
+                    readonly testReporter?: "vitest-v1" | undefined;
+                }[];
+                readonly gradeExecuted: boolean;
+                readonly testReporter?: "vitest-v1" | undefined;
+                readonly isolationTimings?: {
+                    readonly checkoutDurationMs: number;
+                    readonly overlayDurationMs: number;
+                    readonly cleanupDurationMs: number;
+                } | undefined;
+                readonly preparation?: {
+                    readonly kind: "pristine-install-template";
+                    readonly templateKey: string;
+                    readonly sourceCommit: string;
+                    readonly cloneDurationMs: number;
+                    readonly sharedResults: readonly {
+                        readonly recipeId: string;
+                        readonly commit: string;
+                        readonly repetition: number;
+                        readonly stdout: string;
+                        readonly stderr: string;
+                        readonly exitCode: number | null;
+                        readonly stage: "trusted-preparation" | "candidate-validation" | "grade";
+                        readonly timedOut: boolean;
+                        readonly outputTruncated: boolean;
+                        readonly durationMs: number;
+                        readonly testReporter?: "vitest-v1" | undefined;
+                    }[];
+                } | undefined;
+            }[];
+        }[];
+    };
+}, RepositoryFoundryError, never>;
+export declare const makeTaskSeed: Effect.Effect<TaskSeedShape, never, never>;
+export declare const TaskSeedLive: Layer.Layer<TaskSeed, never, never>;
+export {};