@shepai/cli 1.165.0 → 1.166.0-pr513.7e8c227

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/052-replace-default-fast-mode-with-default-mode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Migration 052: Replace boolean default_fast_mode column with TEXT default_mode column
+ * on the settings table.
+ *
+ * Migrates the settings.default_fast_mode INTEGER column (0/1 boolean) to a TEXT
+ * default_mode column that stores FeatureMode enum values:
+ *  - default_fast_mode = 1 → default_mode = 'Fast'
+ *  - default_fast_mode = 0 → default_mode = 'Regular'
+ *
+ * Default for new rows: default_mode = 'Fast' (preserves backward compatibility).
+ * Guards against duplicate column using PRAGMA table_info.
+ */
+import type { MigrationParams } from 'umzug';
+import type Database from 'better-sqlite3';
+export declare function up({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+export declare function down({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+//# sourceMappingURL=052-replace-default-fast-mode-with-default-mode.d.ts.map

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/052-replace-default-fast-mode-with-default-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"052-replace-default-fast-mode-with-default-mode.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/migrations/052-replace-default-fast-mode-with-default-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,wBAAsB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3F;AAED,wBAAsB,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/052-replace-default-fast-mode-with-default-mode.js

@@ -0,0 +1,37 @@
+/**
+ * Migration 052: Replace boolean default_fast_mode column with TEXT default_mode column
+ * on the settings table.
+ *
+ * Migrates the settings.default_fast_mode INTEGER column (0/1 boolean) to a TEXT
+ * default_mode column that stores FeatureMode enum values:
+ *  - default_fast_mode = 1 → default_mode = 'Fast'
+ *  - default_fast_mode = 0 → default_mode = 'Regular'
+ *
+ * Default for new rows: default_mode = 'Fast' (preserves backward compatibility).
+ * Guards against duplicate column using PRAGMA table_info.
+ */
+export async function up({ context: db }) {
+    const columns = db.pragma('table_info(settings)');
+    const names = new Set(columns.map((c) => c.name));
+    // Step 1: Add new TEXT default_mode column with default 'Fast'
+    if (!names.has('default_mode')) {
+        db.exec("ALTER TABLE settings ADD COLUMN default_mode TEXT NOT NULL DEFAULT 'Fast'");
+    }
+    // Step 2: Migrate data from default_fast_mode → default_mode
+    if (names.has('default_fast_mode')) {
+        db.exec(`
+      UPDATE settings
+      SET default_mode = CASE
+        WHEN default_fast_mode = 1 THEN 'Fast'
+        ELSE 'Regular'
+      END
+    `);
+    }
+    // Step 3: Drop old default_fast_mode column
+    if (names.has('default_fast_mode')) {
+        db.exec('ALTER TABLE settings DROP COLUMN default_fast_mode');
+    }
+}
+export async function down({ context: db }) {
+    void db;
+}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/053-add-exploration-max-iterations.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Migration 053: Add exploration_max_iterations column to the settings table.
+ *
+ * Adds a nullable INTEGER column for the maximum number of feedback iterations
+ * in exploration mode. When NULL, the default of 10 is applied at the application layer.
+ * Guards against duplicate column using PRAGMA table_info.
+ */
+import type { MigrationParams } from 'umzug';
+import type Database from 'better-sqlite3';
+export declare function up({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+export declare function down({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+//# sourceMappingURL=053-add-exploration-max-iterations.d.ts.map

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/053-add-exploration-max-iterations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"053-add-exploration-max-iterations.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/migrations/053-add-exploration-max-iterations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,wBAAsB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3F;AAED,wBAAsB,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/053-add-exploration-max-iterations.js

@@ -0,0 +1,17 @@
+/**
+ * Migration 053: Add exploration_max_iterations column to the settings table.
+ *
+ * Adds a nullable INTEGER column for the maximum number of feedback iterations
+ * in exploration mode. When NULL, the default of 10 is applied at the application layer.
+ * Guards against duplicate column using PRAGMA table_info.
+ */
+export async function up({ context: db }) {
+    const columns = db.pragma('table_info(settings)');
+    const names = new Set(columns.map((c) => c.name));
+    if (!names.has('exploration_max_iterations')) {
+        db.exec('ALTER TABLE settings ADD COLUMN exploration_max_iterations INTEGER');
+    }
+}
+export async function down({ context: db }) {
+    void db;
+}

package/dist/packages/core/src/infrastructure/repositories/sqlite-feature.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-feature.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-feature.repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,6EAA6E,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAOhE;;;GAGG;AACH,qBACa,uBAAwB,YAAW,kBAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAE5C,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAW7C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAcvD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAazE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAa7E,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA8BtD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQpD,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK5C"}
+{"version":3,"file":"sqlite-feature.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-feature.repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,6EAA6E,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAOhE;;;GAGG;AACH,qBACa,uBAAwB,YAAW,kBAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAE5C,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAW7C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAcvD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAazE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAa7E,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA8BtD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQpD,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK5C"}

package/dist/packages/core/src/infrastructure/repositories/sqlite-feature.repository.js

@@ -32,7 +32,7 @@ let SQLiteFeatureRepository = class SQLiteFeatureRepository {
         id, name, slug, description, user_query, repository_path, branch,
         lifecycle, messages, plan, related_artifacts,
         agent_run_id, spec_path,
-        fast,
+        mode, iteration_count, max_iterations,
         push, open_pr, fork_and_pr, commit_specs,
         ci_watch_enabled, enable_evidence, commit_evidence,
         auto_merge, allow_prd, allow_plan, allow_merge,
@@ -46,7 +46,7 @@ let SQLiteFeatureRepository = class SQLiteFeatureRepository {
         @id, @name, @slug, @description, @user_query, @repository_path, @branch,
         @lifecycle, @messages, @plan, @related_artifacts,
         @agent_run_id, @spec_path,
-        @fast,
+        @mode, @iteration_count, @max_iterations,
         @push, @open_pr, @fork_and_pr, @commit_specs,
         @ci_watch_enabled, @enable_evidence, @commit_evidence,
         @auto_merge, @allow_prd, @allow_plan, @allow_merge,
@@ -138,7 +138,9 @@ let SQLiteFeatureRepository = class SQLiteFeatureRepository {
         related_artifacts = @related_artifacts,
         agent_run_id = @agent_run_id,
         spec_path = @spec_path,
-        fast = @fast,
+        mode = @mode,
+        iteration_count = @iteration_count,
+        max_iterations = @max_iterations,
         push = @push,
         open_pr = @open_pr,
         fork_and_pr = @fork_and_pr,

package/dist/packages/core/src/infrastructure/repositories/sqlite-settings.repository.js

@@ -67,7 +67,7 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         feature_flag_skills, feature_flag_env_deploy, feature_flag_debug, feature_flag_github_import, feature_flag_adopt_branch, feature_flag_git_rebase_sync,
         feature_flag_react_file_manager,
         workflow_enable_evidence, workflow_commit_evidence,
-        hide_ci_status, default_fast_mode,
+        hide_ci_status, default_mode,
         interactive_agent_enabled, interactive_agent_auto_timeout_minutes,
         interactive_agent_max_concurrent_sessions,
         auto_archive_delay_minutes
@@ -96,7 +96,7 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         @feature_flag_skills, @feature_flag_env_deploy, @feature_flag_debug, @feature_flag_github_import, @feature_flag_adopt_branch, @feature_flag_git_rebase_sync,
         @feature_flag_react_file_manager,
         @workflow_enable_evidence, @workflow_commit_evidence,
-        @hide_ci_status, @default_fast_mode,
+        @hide_ci_status, @default_mode,
         @interactive_agent_enabled, @interactive_agent_auto_timeout_minutes,
         @interactive_agent_max_concurrent_sessions,
         @auto_archive_delay_minutes
@@ -198,7 +198,7 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         workflow_enable_evidence = @workflow_enable_evidence,
         workflow_commit_evidence = @workflow_commit_evidence,
         hide_ci_status = @hide_ci_status,
-        default_fast_mode = @default_fast_mode,
+        default_mode = @default_mode,
         interactive_agent_enabled = @interactive_agent_enabled,
         interactive_agent_auto_timeout_minutes = @interactive_agent_auto_timeout_minutes,
         interactive_agent_max_concurrent_sessions = @interactive_agent_max_concurrent_sessions,

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/exploration-agent-graph.d.ts

@@ -0,0 +1,362 @@
+/**
+ * Exploration Agent Graph Factory
+ *
+ * Creates a LangGraph StateGraph for exploration/prototyping mode with
+ * the topology:
+ *   START → prototype-generate → (interrupt for feedback)
+ *     → apply-feedback → prototype-generate (loop)
+ *     → END (on promote or discard)
+ *
+ * The graph uses the same FeatureAgentAnnotation state shape as the
+ * full and fast graphs, enabling checkpointing, resume, and identical
+ * worker lifecycle handling.
+ *
+ * Unlike the full SDLC graph which uses executeNode() with approval gates,
+ * the exploration graph uses custom node functions with shared utilities
+ * (retryExecute, createNodeLogger). The feedback loop is driven by
+ * LangGraph interrupt/resume — the same mechanism used for approval gates.
+ */
+import { type BaseCheckpointSaver } from '@langchain/langgraph';
+import type { IAgentExecutor } from '../../../../application/ports/output/agents/agent-executor.interface.js';
+import { type FeatureAgentState } from './state.js';
+export { FeatureAgentAnnotation, type FeatureAgentState } from './state.js';
+/**
+ * Dependencies needed to build the exploration agent graph.
+ * Intentionally minimal — exploration mode does not use merge nodes.
+ */
+export interface ExplorationAgentGraphDeps {
+    executor: IAgentExecutor;
+}
+/**
+ * Routing function that determines the next node after prototype-generate
+ * resumes from interrupt.
+ *
+ * The resume payload (set via Command({update})) controls the flow:
+ * - _approvalAction === 'rejected' → apply-feedback (iterate with feedback)
+ * - _approvalAction === 'approved' or any other → END (promote or discard)
+ *
+ * The 'rejected' action maps to the iterate flow because the existing
+ * worker resume logic already sets _approvalAction='rejected' and
+ * _rejectionFeedback=<text> for rejection payloads. For exploration,
+ * "rejected" means "iterate with feedback" rather than "rejected for merge".
+ */
+export declare function routeAfterPrototypeGenerate(state: FeatureAgentState): string;
+/**
+ * Factory function that creates and compiles the exploration-mode agent graph.
+ *
+ * The graph defines a feedback loop:
+ *   START → prototype-generate → (interrupt) → route:
+ *     - iterate: → apply-feedback → prototype-generate (loop)
+ *     - promote/discard: → END
+ *
+ * @param depsOrExecutor - Graph dependencies or a legacy executor
+ * @param checkpointer - Optional checkpoint saver for state persistence
+ * @returns A compiled LangGraph ready to be invoked
+ */
+export declare function createExplorationAgentGraph(depsOrExecutor: ExplorationAgentGraphDeps | IAgentExecutor, checkpointer?: BaseCheckpointSaver): import("@langchain/langgraph").CompiledStateGraph<{
+    featureId: string;
+    repositoryPath: string;
+    specDir: string;
+    worktreePath: string;
+    currentNode: string;
+    error: string | null;
+    approvalGates: import("../../../../domain/index.js").ApprovalGates | undefined;
+    model: string | undefined;
+    messages: string[];
+    validationRetries: number;
+    lastValidationTarget: string;
+    lastValidationErrors: string[];
+    _approvalAction: string | null;
+    _rejectionFeedback: string | null;
+    _needsReexecution: boolean;
+    prUrl: string | null;
+    prNumber: number | null;
+    commitHash: string | null;
+    ciStatus: string | null;
+    push: boolean;
+    openPr: boolean;
+    forkAndPr: boolean;
+    commitSpecs: boolean;
+    ciWatchEnabled: boolean;
+    enableEvidence: boolean;
+    commitEvidence: boolean;
+    evidence: import("../../../../domain/index.js").Evidence[];
+    evidenceRetries: number;
+    resumeReason: string | undefined;
+    ciFixAttempts: number;
+    ciFixHistory: import("../../../../domain/index.js").CiFixRecord[];
+    ciFixStatus: "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted";
+    iterationCount: number;
+    maxIterations: number;
+    feedbackHistory: string[];
+    explorationStatus: "generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined;
+}, {
+    featureId?: string | undefined;
+    repositoryPath?: string | undefined;
+    specDir?: string | undefined;
+    worktreePath?: string | undefined;
+    currentNode?: string | undefined;
+    error?: string | null | undefined;
+    approvalGates?: import("../../../../domain/index.js").ApprovalGates | undefined;
+    model?: string | undefined;
+    messages?: string[] | undefined;
+    validationRetries?: number | undefined;
+    lastValidationTarget?: string | undefined;
+    lastValidationErrors?: string[] | undefined;
+    _approvalAction?: string | null | undefined;
+    _rejectionFeedback?: string | null | undefined;
+    _needsReexecution?: boolean | undefined;
+    prUrl?: string | null | undefined;
+    prNumber?: number | null | undefined;
+    commitHash?: string | null | undefined;
+    ciStatus?: string | null | undefined;
+    push?: boolean | undefined;
+    openPr?: boolean | undefined;
+    forkAndPr?: boolean | undefined;
+    commitSpecs?: boolean | undefined;
+    ciWatchEnabled?: boolean | undefined;
+    enableEvidence?: boolean | undefined;
+    commitEvidence?: boolean | undefined;
+    evidence?: import("../../../../domain/index.js").Evidence[] | undefined;
+    evidenceRetries?: number | undefined;
+    resumeReason?: string | undefined;
+    ciFixAttempts?: number | undefined;
+    ciFixHistory?: import("../../../../domain/index.js").CiFixRecord[] | undefined;
+    ciFixStatus?: "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted" | undefined;
+    iterationCount?: number | undefined;
+    maxIterations?: number | undefined;
+    feedbackHistory?: string[] | undefined;
+    explorationStatus?: "generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined;
+}, "__start__" | "prototype-generate" | "apply-feedback", {
+    featureId: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    repositoryPath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    specDir: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    worktreePath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    currentNode: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").ApprovalGates | undefined, import("../../../../domain/index.js").ApprovalGates | undefined>;
+    model: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    validationRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    lastValidationTarget: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    lastValidationErrors: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    _approvalAction: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _rejectionFeedback: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _needsReexecution: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    prUrl: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    prNumber: import("@langchain/langgraph").BinaryOperatorAggregate<number | null, number | null>;
+    commitHash: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    forkAndPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    commitSpecs: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    ciWatchEnabled: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    enableEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    commitEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    evidence: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").Evidence[], import("../../../../domain/index.js").Evidence[]>;
+    evidenceRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    resumeReason: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+    ciFixAttempts: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    ciFixHistory: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").CiFixRecord[], import("../../../../domain/index.js").CiFixRecord[]>;
+    ciFixStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted", "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted">;
+    iterationCount: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    maxIterations: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    feedbackHistory: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    explorationStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined, "generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined>;
+}, {
+    featureId: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    repositoryPath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    specDir: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    worktreePath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    currentNode: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").ApprovalGates | undefined, import("../../../../domain/index.js").ApprovalGates | undefined>;
+    model: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    validationRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    lastValidationTarget: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    lastValidationErrors: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    _approvalAction: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _rejectionFeedback: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _needsReexecution: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    prUrl: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    prNumber: import("@langchain/langgraph").BinaryOperatorAggregate<number | null, number | null>;
+    commitHash: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    forkAndPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    commitSpecs: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    ciWatchEnabled: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    enableEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    commitEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    evidence: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").Evidence[], import("../../../../domain/index.js").Evidence[]>;
+    evidenceRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    resumeReason: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+    ciFixAttempts: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    ciFixHistory: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").CiFixRecord[], import("../../../../domain/index.js").CiFixRecord[]>;
+    ciFixStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted", "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted">;
+    iterationCount: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    maxIterations: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    feedbackHistory: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    explorationStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined, "generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined>;
+}, import("@langchain/langgraph").StateDefinition, {
+    "prototype-generate": Partial<import("@langchain/langgraph").StateType<{
+        featureId: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        repositoryPath: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        specDir: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        worktreePath: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        currentNode: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").ApprovalGates | undefined, import("../../../../domain/index.js").ApprovalGates | undefined>;
+        model: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+        messages: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        validationRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        lastValidationTarget: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        lastValidationErrors: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        _approvalAction: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        _rejectionFeedback: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        _needsReexecution: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        prUrl: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        prNumber: import("@langchain/langgraph").BinaryOperatorAggregate<number | null, number | null>;
+        commitHash: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        forkAndPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        commitSpecs: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        ciWatchEnabled: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        enableEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        commitEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        evidence: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").Evidence[], import("../../../../domain/index.js").Evidence[]>;
+        evidenceRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        resumeReason: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+        ciFixAttempts: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        ciFixHistory: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").CiFixRecord[], import("../../../../domain/index.js").CiFixRecord[]>;
+        ciFixStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted", "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted">;
+        iterationCount: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        maxIterations: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        feedbackHistory: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        explorationStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined, "generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined>;
+    }>>;
+    "apply-feedback": Partial<import("@langchain/langgraph").StateType<{
+        featureId: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        repositoryPath: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        specDir: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        worktreePath: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        currentNode: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").ApprovalGates | undefined, import("../../../../domain/index.js").ApprovalGates | undefined>;
+        model: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+        messages: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        validationRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        lastValidationTarget: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        lastValidationErrors: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        _approvalAction: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        _rejectionFeedback: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        _needsReexecution: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        prUrl: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        prNumber: import("@langchain/langgraph").BinaryOperatorAggregate<number | null, number | null>;
+        commitHash: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        forkAndPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        commitSpecs: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        ciWatchEnabled: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        enableEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        commitEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        evidence: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").Evidence[], import("../../../../domain/index.js").Evidence[]>;
+        evidenceRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        resumeReason: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+        ciFixAttempts: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        ciFixHistory: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").CiFixRecord[], import("../../../../domain/index.js").CiFixRecord[]>;
+        ciFixStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted", "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted">;
+        iterationCount: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        maxIterations: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        feedbackHistory: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        explorationStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined, "generating" | "waiting-feedback" | "applying-feedback" | "promoting" | "discarding" | undefined>;
+    }>>;
+}, unknown, unknown>;
+//# sourceMappingURL=exploration-agent-graph.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/exploration-agent-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exploration-agent-graph.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/exploration-agent-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK5E,OAAO,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAO5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,yBAAyB,GAAG,cAAc,EAC1D,YAAY,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAqBnC"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/exploration-agent-graph.js

@@ -0,0 +1,72 @@
+/**
+ * Exploration Agent Graph Factory
+ *
+ * Creates a LangGraph StateGraph for exploration/prototyping mode with
+ * the topology:
+ *   START → prototype-generate → (interrupt for feedback)
+ *     → apply-feedback → prototype-generate (loop)
+ *     → END (on promote or discard)
+ *
+ * The graph uses the same FeatureAgentAnnotation state shape as the
+ * full and fast graphs, enabling checkpointing, resume, and identical
+ * worker lifecycle handling.
+ *
+ * Unlike the full SDLC graph which uses executeNode() with approval gates,
+ * the exploration graph uses custom node functions with shared utilities
+ * (retryExecute, createNodeLogger). The feedback loop is driven by
+ * LangGraph interrupt/resume — the same mechanism used for approval gates.
+ */
+import { StateGraph, START } from '@langchain/langgraph';
+import { FeatureAgentAnnotation } from './state.js';
+import { createPrototypeGenerateNode } from './nodes/prototype-generate.node.js';
+import { createApplyFeedbackNode } from './nodes/apply-feedback.node.js';
+// Re-export for consumers
+export { FeatureAgentAnnotation } from './state.js';
+/**
+ * Routing function that determines the next node after prototype-generate
+ * resumes from interrupt.
+ *
+ * The resume payload (set via Command({update})) controls the flow:
+ * - _approvalAction === 'rejected' → apply-feedback (iterate with feedback)
+ * - _approvalAction === 'approved' or any other → END (promote or discard)
+ *
+ * The 'rejected' action maps to the iterate flow because the existing
+ * worker resume logic already sets _approvalAction='rejected' and
+ * _rejectionFeedback=<text> for rejection payloads. For exploration,
+ * "rejected" means "iterate with feedback" rather than "rejected for merge".
+ */
+export function routeAfterPrototypeGenerate(state) {
+    // If the user provided feedback (rejection = iterate in exploration context)
+    if (state._approvalAction === 'rejected') {
+        return 'apply-feedback';
+    }
+    // Otherwise: approved = promote/discard = exit the loop
+    return '__end__';
+}
+/**
+ * Factory function that creates and compiles the exploration-mode agent graph.
+ *
+ * The graph defines a feedback loop:
+ *   START → prototype-generate → (interrupt) → route:
+ *     - iterate: → apply-feedback → prototype-generate (loop)
+ *     - promote/discard: → END
+ *
+ * @param depsOrExecutor - Graph dependencies or a legacy executor
+ * @param checkpointer - Optional checkpoint saver for state persistence
+ * @returns A compiled LangGraph ready to be invoked
+ */
+export function createExplorationAgentGraph(depsOrExecutor, checkpointer) {
+    // Support legacy signature: createExplorationAgentGraph(executor, checkpointer)
+    const deps = 'execute' in depsOrExecutor ? { executor: depsOrExecutor } : depsOrExecutor;
+    const { executor } = deps;
+    const graph = new StateGraph(FeatureAgentAnnotation)
+        .addNode('prototype-generate', createPrototypeGenerateNode(executor))
+        .addNode('apply-feedback', createApplyFeedbackNode());
+    // START → prototype-generate
+    graph.addEdge(START, 'prototype-generate');
+    // prototype-generate → conditional routing (after resume from interrupt)
+    graph.addConditionalEdges('prototype-generate', routeAfterPrototypeGenerate);
+    // apply-feedback → prototype-generate (loop back)
+    graph.addEdge('apply-feedback', 'prototype-generate');
+    return graph.compile({ checkpointer });
+}