@telora/factory 0.4.5

package/dist/strategy-design-schema.d.ts

@@ -0,0 +1,767 @@
+/**
+ * Strategy design types, Zod schemas, and dependency validation.
+ *
+ * Pure data definitions and validation logic for AI-generated strategy designs.
+ * No side effects, no I/O -- safe to import from any module.
+ */
+import { z } from 'zod';
+/** Kind of artifact in an interface contract. */
+export type ContractItemKind = 'file' | 'export' | 'api_endpoint' | 'db_table' | 'type';
+/**
+ * A single artifact in an interface contract.
+ * Describes one thing a strategy produces or consumes.
+ */
+export interface ContractItem {
+    /** What kind of artifact this is. */
+    kind: ContractItemKind;
+    /** Identifier (e.g. file path, export name, endpoint path, table name). */
+    identifier: string;
+    /** Optional description of the artifact. */
+    description?: string;
+}
+/**
+ * Per-strategy interface contract declaring what a strategy produces and consumes.
+ */
+export interface StrategyContract {
+    /** Artifacts this strategy will create or expose. */
+    produces: ContractItem[];
+    /** Artifacts this strategy needs from its dependencies. */
+    consumes: ContractItem[];
+}
+/**
+ * A cross-strategy interface contract between two strategies.
+ * Describes what one strategy exposes that another depends on.
+ */
+export interface InterfaceContract {
+    /** What is being shared (e.g. "UserService API", "auth middleware"). */
+    name: string;
+    /** Which strategy exposes this contract (tempId reference). */
+    provider: string;
+    /** Which strategy consumes this contract (tempId reference). */
+    consumer: string;
+    /** Description of the interface boundary. */
+    description: string;
+}
+/**
+ * A single strategy in the AI-generated design plan.
+ * tempId is used for dependency references before real UUIDs are assigned.
+ */
+export interface StrategyDesignUnit {
+    /** Temporary ID for DAG references (e.g. "s-0", "s-1"). */
+    tempId: string;
+    /** Human-readable strategy name. */
+    name: string;
+    /** What this strategy covers and its scope boundary. */
+    description: string;
+    /** Technical context: stack, key files, architecture notes. */
+    techContext: string;
+    /** Priority order (0 = highest). */
+    priorityRank: number;
+    /** TempIds of strategies this one depends on (DAG edges). */
+    dependsOn: string[];
+    /** Per-strategy interface contract (what it produces and consumes). */
+    interfaceContract: StrategyContract;
+}
+/**
+ * The full strategy design plan returned by the designing phase AI.
+ */
+export interface StrategyDesignPlan {
+    /** The decomposed strategies. */
+    strategies: StrategyDesignUnit[];
+    /** Cross-strategy interface contracts. */
+    interfaceContracts: InterfaceContract[];
+    /** High-level summary of the decomposition rationale. */
+    summary: string;
+}
+/** A node in the strategy dependency graph. */
+export interface StrategyGraphNode {
+    strategyId: string;
+    name: string;
+    dependsOn: string[];
+    dependedOnBy: string[];
+    interfaceContract: StrategyContract | null;
+}
+/** Validated DAG of strategy dependencies. */
+export interface StrategyDependencyGraph {
+    /** All nodes keyed by strategy ID. */
+    nodes: Map<string, StrategyGraphNode>;
+    /** Topological execution order (strategies appear after all their dependencies). */
+    executionOrder: string[];
+    /** Groups of strategies with no cross-dependencies (can run in parallel). */
+    independentSubgraphs: string[][];
+}
+/** Result of interface contract validation. */
+export interface ContractValidationResult {
+    valid: boolean;
+    errors: ContractMismatch[];
+    warnings: ContractWarning[];
+}
+/** A contract mismatch where a consumer needs something a producer doesn't declare. */
+export interface ContractMismatch {
+    consumerStrategyId: string;
+    producerStrategyId: string;
+    consumedItem: ContractItem;
+    reason: string;
+}
+/** A non-fatal advisory about contract quality. */
+export interface ContractWarning {
+    strategyId: string;
+    message: string;
+}
+/** Mapping from tempId to real strategy UUID. */
+export interface StrategyMapping {
+    tempId: string;
+    strategyId: string;
+    name: string;
+}
+/** Execution status for factory-created strategies. */
+export type StrategyExecutionStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'gating_deterministic' | 'gating_behavioral' | 'gating_adversarial' | 'gate_fix_pending';
+/** A persisted strategy returned from the API (full data for planning). */
+export interface PersistedStrategy {
+    id: string;
+    name: string;
+    description: string | null;
+    techContext: string | null;
+    priorityRank: number;
+    status: string;
+    executionStatus: StrategyExecutionStatus | null;
+    interfaceContract: StrategyContract | null;
+    dependsOn: string[];
+    /** When the strategy entered gate_fix_pending (null when not in that state). */
+    gateFixStartedAt: string | null;
+}
+/** Result of a single strategy design generation attempt. */
+export type StrategyGenerationResult = {
+    success: true;
+    strategyDesign: StrategyDesignPlan;
+    tokenUsage: ParsedTokenUsage | null;
+} | {
+    success: false;
+    error: string;
+    tokenUsage: ParsedTokenUsage | null;
+};
+/** Input for building the dependency graph from persisted strategy data. */
+export interface StrategyGraphInput {
+    strategyId: string;
+    name: string;
+    dependsOn: string[];
+    interfaceContract: StrategyContract | null;
+}
+export declare const ContractItemSchema: z.ZodObject<{
+    kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+    identifier: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+    identifier: string;
+    description?: string | undefined;
+}, {
+    kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+    identifier: string;
+    description?: string | undefined;
+}>;
+export declare const StrategyContractSchema: z.ZodObject<{
+    produces: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+        identifier: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }, {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }>, "many">;
+    consumes: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+        identifier: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }, {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    produces: {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }[];
+    consumes: {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }[];
+}, {
+    produces: {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }[];
+    consumes: {
+        kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+        identifier: string;
+        description?: string | undefined;
+    }[];
+}>;
+export declare const InterfaceContractSchema: z.ZodObject<{
+    name: z.ZodString;
+    provider: z.ZodString;
+    consumer: z.ZodString;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    name: string;
+    provider: string;
+    consumer: string;
+}, {
+    description: string;
+    name: string;
+    provider: string;
+    consumer: string;
+}>;
+export declare const StrategyDesignUnitSchema: z.ZodObject<{
+    tempId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    techContext: z.ZodString;
+    priorityRank: z.ZodNumber;
+    dependsOn: z.ZodArray<z.ZodString, "many">;
+    interfaceContract: z.ZodObject<{
+        produces: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+            identifier: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }>, "many">;
+        consumes: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+            identifier: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    }, {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    name: string;
+    tempId: string;
+    techContext: string;
+    priorityRank: number;
+    dependsOn: string[];
+    interfaceContract: {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    };
+}, {
+    description: string;
+    name: string;
+    tempId: string;
+    techContext: string;
+    priorityRank: number;
+    dependsOn: string[];
+    interfaceContract: {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    };
+}>;
+export declare const StrategyDesignPlanSchema: z.ZodObject<{
+    strategies: z.ZodArray<z.ZodObject<{
+        tempId: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        techContext: z.ZodString;
+        priorityRank: z.ZodNumber;
+        dependsOn: z.ZodArray<z.ZodString, "many">;
+        interfaceContract: z.ZodObject<{
+            produces: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+                identifier: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }>, "many">;
+            consumes: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+                identifier: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        }, {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        name: string;
+        tempId: string;
+        techContext: string;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        };
+    }, {
+        description: string;
+        name: string;
+        tempId: string;
+        techContext: string;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        };
+    }>, "many">;
+    interfaceContracts: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodString;
+        consumer: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        name: string;
+        provider: string;
+        consumer: string;
+    }, {
+        description: string;
+        name: string;
+        provider: string;
+        consumer: string;
+    }>, "many">;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    strategies: {
+        description: string;
+        name: string;
+        tempId: string;
+        techContext: string;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        };
+    }[];
+    interfaceContracts: {
+        description: string;
+        name: string;
+        provider: string;
+        consumer: string;
+    }[];
+    summary: string;
+}, {
+    strategies: {
+        description: string;
+        name: string;
+        tempId: string;
+        techContext: string;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        };
+    }[];
+    interfaceContracts: {
+        description: string;
+        name: string;
+        provider: string;
+        consumer: string;
+    }[];
+    summary: string;
+}>;
+/** Zod schema for validating getStrategiesByFactoryInstance response. */
+export declare const PersistedStrategySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    techContext: z.ZodNullable<z.ZodString>;
+    priorityRank: z.ZodNumber;
+    status: z.ZodString;
+    executionStatus: z.ZodNullable<z.ZodEnum<["pending", "in_progress", "completed", "failed", "gating_deterministic", "gating_behavioral", "gating_adversarial", "gate_fix_pending"]>>;
+    interfaceContract: z.ZodNullable<z.ZodObject<{
+        produces: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+            identifier: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }>, "many">;
+        consumes: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+            identifier: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }, {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    }, {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    }>>;
+    dependsOn: z.ZodArray<z.ZodString, "many">;
+    gateFixStartedAt: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    description: string | null;
+    name: string;
+    techContext: string | null;
+    priorityRank: number;
+    dependsOn: string[];
+    interfaceContract: {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    } | null;
+    id: string;
+    executionStatus: "pending" | "completed" | "failed" | "in_progress" | "gating_deterministic" | "gating_behavioral" | "gating_adversarial" | "gate_fix_pending" | null;
+    gateFixStartedAt: string | null;
+}, {
+    status: string;
+    description: string | null;
+    name: string;
+    techContext: string | null;
+    priorityRank: number;
+    dependsOn: string[];
+    interfaceContract: {
+        produces: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+        consumes: {
+            kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+            identifier: string;
+            description?: string | undefined;
+        }[];
+    } | null;
+    id: string;
+    executionStatus: "pending" | "completed" | "failed" | "in_progress" | "gating_deterministic" | "gating_behavioral" | "gating_adversarial" | "gate_fix_pending" | null;
+    gateFixStartedAt?: string | null | undefined;
+}>;
+export declare const GetInstanceStrategiesResponseSchema: z.ZodObject<{
+    strategies: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        techContext: z.ZodNullable<z.ZodString>;
+        priorityRank: z.ZodNumber;
+        status: z.ZodString;
+        executionStatus: z.ZodNullable<z.ZodEnum<["pending", "in_progress", "completed", "failed", "gating_deterministic", "gating_behavioral", "gating_adversarial", "gate_fix_pending"]>>;
+        interfaceContract: z.ZodNullable<z.ZodObject<{
+            produces: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+                identifier: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }>, "many">;
+            consumes: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<["file", "export", "api_endpoint", "db_table", "type"]>;
+                identifier: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }, {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        }, {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        }>>;
+        dependsOn: z.ZodArray<z.ZodString, "many">;
+        gateFixStartedAt: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        description: string | null;
+        name: string;
+        techContext: string | null;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        } | null;
+        id: string;
+        executionStatus: "pending" | "completed" | "failed" | "in_progress" | "gating_deterministic" | "gating_behavioral" | "gating_adversarial" | "gate_fix_pending" | null;
+        gateFixStartedAt: string | null;
+    }, {
+        status: string;
+        description: string | null;
+        name: string;
+        techContext: string | null;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        } | null;
+        id: string;
+        executionStatus: "pending" | "completed" | "failed" | "in_progress" | "gating_deterministic" | "gating_behavioral" | "gating_adversarial" | "gate_fix_pending" | null;
+        gateFixStartedAt?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    strategies: {
+        status: string;
+        description: string | null;
+        name: string;
+        techContext: string | null;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        } | null;
+        id: string;
+        executionStatus: "pending" | "completed" | "failed" | "in_progress" | "gating_deterministic" | "gating_behavioral" | "gating_adversarial" | "gate_fix_pending" | null;
+        gateFixStartedAt: string | null;
+    }[];
+}, {
+    strategies: {
+        status: string;
+        description: string | null;
+        name: string;
+        techContext: string | null;
+        priorityRank: number;
+        dependsOn: string[];
+        interfaceContract: {
+            produces: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+            consumes: {
+                kind: "type" | "file" | "export" | "api_endpoint" | "db_table";
+                identifier: string;
+                description?: string | undefined;
+            }[];
+        } | null;
+        id: string;
+        executionStatus: "pending" | "completed" | "failed" | "in_progress" | "gating_deterministic" | "gating_behavioral" | "gating_adversarial" | "gate_fix_pending" | null;
+        gateFixStartedAt?: string | null | undefined;
+    }[];
+}>;
+/**
+ * Validate that all dependsOn references point to valid tempIds within the plan,
+ * and that interface contract provider/consumer references are valid.
+ *
+ * Also checks for self-dependencies and cycles (via topological sort).
+ * Returns an error message if validation fails, null if valid.
+ */
+export declare function validateStrategyDependencies(plan: StrategyDesignPlan): string | null;
+import type { ParsedTokenUsage } from './queries/shared.js';
+export type { ParsedTokenUsage };
+//# sourceMappingURL=strategy-design-schema.d.ts.map