@shepai/cli 1.116.3 → 1.117.0

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/035-add-stage-timeout-ms.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Migration 035: Add per-stage timeout columns to settings table.
+ *
+ * Replaces the single stage_timeout_ms column with individual per-stage
+ * timeout columns. Each is a nullable INTEGER (milliseconds). When NULL,
+ * the application falls back to the hardcoded default of 600_000 ms
+ * (10 minutes).
+ *
+ * Columns added:
+ *  - stage_timeout_analyze_ms
+ *  - stage_timeout_requirements_ms
+ *  - stage_timeout_research_ms
+ *  - stage_timeout_plan_ms
+ *  - stage_timeout_implement_ms
+ *  - stage_timeout_merge_ms
+ *  - analyze_repo_timeout_analyze_ms
+ */
+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=035-add-stage-timeout-ms.d.ts.map

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/035-add-stage-timeout-ms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"035-add-stage-timeout-ms.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/migrations/035-add-stage-timeout-ms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAY3C,wBAAsB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB3F;AAED,wBAAsB,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7F"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/035-add-stage-timeout-ms.js

@@ -0,0 +1,53 @@
+/**
+ * Migration 035: Add per-stage timeout columns to settings table.
+ *
+ * Replaces the single stage_timeout_ms column with individual per-stage
+ * timeout columns. Each is a nullable INTEGER (milliseconds). When NULL,
+ * the application falls back to the hardcoded default of 600_000 ms
+ * (10 minutes).
+ *
+ * Columns added:
+ *  - stage_timeout_analyze_ms
+ *  - stage_timeout_requirements_ms
+ *  - stage_timeout_research_ms
+ *  - stage_timeout_plan_ms
+ *  - stage_timeout_implement_ms
+ *  - stage_timeout_merge_ms
+ *  - analyze_repo_timeout_analyze_ms
+ */
+const STAGE_COLUMNS = [
+    'stage_timeout_analyze_ms',
+    'stage_timeout_requirements_ms',
+    'stage_timeout_research_ms',
+    'stage_timeout_plan_ms',
+    'stage_timeout_implement_ms',
+    'stage_timeout_merge_ms',
+    'analyze_repo_timeout_analyze_ms',
+];
+export async function up({ context: db }) {
+    const columns = db.pragma('table_info(settings)');
+    const existingNames = new Set(columns.map((c) => c.name));
+    for (const col of STAGE_COLUMNS) {
+        if (!existingNames.has(col)) {
+            db.exec(`ALTER TABLE settings ADD COLUMN ${col} INTEGER`);
+        }
+    }
+    // Migrate existing stage_timeout_ms value to all per-stage columns
+    if (existingNames.has('stage_timeout_ms')) {
+        db.exec(`
+      UPDATE settings SET
+        stage_timeout_analyze_ms = COALESCE(stage_timeout_analyze_ms, stage_timeout_ms),
+        stage_timeout_requirements_ms = COALESCE(stage_timeout_requirements_ms, stage_timeout_ms),
+        stage_timeout_research_ms = COALESCE(stage_timeout_research_ms, stage_timeout_ms),
+        stage_timeout_plan_ms = COALESCE(stage_timeout_plan_ms, stage_timeout_ms),
+        stage_timeout_implement_ms = COALESCE(stage_timeout_implement_ms, stage_timeout_ms),
+        stage_timeout_merge_ms = COALESCE(stage_timeout_merge_ms, stage_timeout_ms)
+      WHERE stage_timeout_ms IS NOT NULL
+    `);
+    }
+}
+export async function down({ context: db }) {
+    // SQLite does not support DROP COLUMN before 3.35.0; the columns are
+    // nullable and ignored when absent, so this is a no-op.
+    void db;
+}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/persistence/sqlite/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAwFxC;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9E"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/persistence/sqlite/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAoGxC;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9E"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations.js

@@ -11,7 +11,7 @@
  */
 import { readdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { Umzug } from 'umzug';
 import { SQLiteMigrationStorage } from './sqlite-migration-storage.js';
 import { LEGACY_MIGRATIONS, LEGACY_MIGRATION_NAMES } from './legacy-migrations.js';
@@ -27,7 +27,7 @@ export const LATEST_SCHEMA_VERSION = 34;
 function getMigrationsDir() {
     // import.meta.url is available in ESM; fallback to __dirname for CJS
     // The migrations/ directory is a sibling of this file
-    return join(dirname(new URL(import.meta.url).pathname), 'migrations');
+    return join(dirname(fileURLToPath(import.meta.url)), 'migrations');
 }
 /**
  * Discovers new migration files (035+) in the migrations/ directory.
@@ -41,9 +41,18 @@ function getMigrationsDir() {
 async function discoverNewMigrations(migrationsDir) {
     let files;
     try {
-        files = readdirSync(migrationsDir)
-            .filter((f) => f.endsWith('.js') && !f.endsWith('.d.js'))
-            .sort();
+        const allFiles = readdirSync(migrationsDir);
+        // Accept .js (compiled) and .ts (dev via tsx) but exclude .d.ts declaration files
+        const candidates = allFiles.filter((f) => (f.endsWith('.js') || f.endsWith('.ts')) && !f.endsWith('.d.ts') && !f.endsWith('.d.js'));
+        // Deduplicate: if both .ts and .js exist for the same migration, prefer .js
+        const byName = new Map();
+        for (const f of candidates) {
+            const base = f.replace(/\.(js|ts)$/, '');
+            if (!byName.has(base) || f.endsWith('.js')) {
+                byName.set(base, f);
+            }
+        }
+        files = [...byName.values()].sort();
     }
     catch {
         // Directory doesn't exist or is unreadable — no new migrations
@@ -52,7 +61,7 @@ async function discoverNewMigrations(migrationsDir) {
     const migrations = [];
     for (const file of files) {
         const filePath = join(migrationsDir, file);
-        const name = file.replace(/\.js$/, '');
+        const name = file.replace(/\.(js|ts)$/, '');
         const mod = (await import(pathToFileURL(filePath).href));
         migrations.push({
             name,

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

@@ -1 +1 @@
-{"version":3,"file":"sqlite-settings.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-settings.repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8EAA8E,CAAC;AACxH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAOjE;;;GAGG;AACH,qBACa,wBAAyB,YAAW,mBAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAElD;;;;;;OAMG;IACG,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DnD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAgBtC;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAqEhD"}
+{"version":3,"file":"sqlite-settings.repository.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/repositories/sqlite-settings.repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8EAA8E,CAAC;AACxH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAOjE;;;GAGG;AACH,qBACa,wBAAyB,YAAW,mBAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAElD;;;;;;OAMG;IACG,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEnD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAgBtC;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA4EhD"}

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

@@ -57,6 +57,10 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         notif_evt_pr_blocked, notif_evt_merge_review_ready,
         workflow_open_pr_on_impl_complete,
         ci_max_fix_attempts, ci_watch_timeout_ms, ci_log_max_chars,
+        stage_timeout_analyze_ms, stage_timeout_requirements_ms,
+        stage_timeout_research_ms, stage_timeout_plan_ms,
+        stage_timeout_implement_ms, stage_timeout_merge_ms,
+        analyze_repo_timeout_analyze_ms,
         onboarding_complete,
         approval_gate_allow_prd, approval_gate_allow_plan,
         approval_gate_allow_merge, approval_gate_push_on_impl_complete,
@@ -77,6 +81,10 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         @notif_evt_pr_blocked, @notif_evt_merge_review_ready,
         @workflow_open_pr_on_impl_complete,
         @ci_max_fix_attempts, @ci_watch_timeout_ms, @ci_log_max_chars,
+        @stage_timeout_analyze_ms, @stage_timeout_requirements_ms,
+        @stage_timeout_research_ms, @stage_timeout_plan_ms,
+        @stage_timeout_implement_ms, @stage_timeout_merge_ms,
+        @analyze_repo_timeout_analyze_ms,
         @onboarding_complete,
         @approval_gate_allow_prd, @approval_gate_allow_plan,
         @approval_gate_allow_merge, @approval_gate_push_on_impl_complete,
@@ -156,6 +164,13 @@ let SQLiteSettingsRepository = class SQLiteSettingsRepository {
         ci_max_fix_attempts = @ci_max_fix_attempts,
         ci_watch_timeout_ms = @ci_watch_timeout_ms,
         ci_log_max_chars = @ci_log_max_chars,
+        stage_timeout_analyze_ms = @stage_timeout_analyze_ms,
+        stage_timeout_requirements_ms = @stage_timeout_requirements_ms,
+        stage_timeout_research_ms = @stage_timeout_research_ms,
+        stage_timeout_plan_ms = @stage_timeout_plan_ms,
+        stage_timeout_implement_ms = @stage_timeout_implement_ms,
+        stage_timeout_merge_ms = @stage_timeout_merge_ms,
+        analyze_repo_timeout_analyze_ms = @analyze_repo_timeout_analyze_ms,
         onboarding_complete = @onboarding_complete,
         approval_gate_allow_prd = @approval_gate_allow_prd,
         approval_gate_allow_plan = @approval_gate_allow_plan,

package/dist/packages/core/src/infrastructure/services/agents/analyze-repo/analyze-repository-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-repository-graph.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/analyze-repo/analyze-repository-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AAGpG;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,OAAO,sBAAsB,CAAC,KAAK,CAAC;AAyB7E;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAQnC"}
+{"version":3,"file":"analyze-repository-graph.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/analyze-repo/analyze-repository-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AAkBpG;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,OAAO,sBAAsB,CAAC,KAAK,CAAC;AA0B7E;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAQnC"}

package/dist/packages/core/src/infrastructure/services/agents/analyze-repo/analyze-repository-graph.js

@@ -1,5 +1,19 @@
 import { Annotation, StateGraph, START, END } from '@langchain/langgraph';
 import { buildAnalyzePrompt } from './prompts/analyze-repository.prompt.js';
+import { hasSettings, getSettings } from '../../../services/settings.service.js';
+/** Default timeout for analyze-repo agent (10 minutes) — prevents infinite hangs. */
+const DEFAULT_ANALYZE_REPO_TIMEOUT_MS = 600_000;
+/**
+ * Resolve the timeout for the analyze-repository agent.
+ * Reads from settings (workflow.analyzeRepoTimeouts.analyzeMs),
+ * falling back to DEFAULT_ANALYZE_REPO_TIMEOUT_MS when not configured.
+ */
+function getAnalyzeRepoTimeoutMs() {
+    if (!hasSettings())
+        return DEFAULT_ANALYZE_REPO_TIMEOUT_MS;
+    const timeouts = getSettings().workflow?.analyzeRepoTimeouts;
+    return timeouts?.analyzeMs ?? DEFAULT_ANALYZE_REPO_TIMEOUT_MS;
+}
 /**
  * State annotation for the analyze-repository graph.
  *
@@ -23,6 +37,7 @@ function createAnalyzeNode(executor) {
         const prompt = buildAnalyzePrompt(state.repositoryPath);
         const result = await executor.execute(prompt, {
             cwd: state.repositoryPath,
+            timeout: getAnalyzeRepoTimeoutMs(),
         });
         return {
             analysisMarkdown: result.result,

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/node-helpers.d.ts

@@ -23,10 +23,20 @@ export type NodeLogger = ReturnType<typeof createNodeLogger>;
  * Safely read a file from the spec directory. Returns empty string if file doesn't exist.
  */
 export declare function readSpecFile(specDir: string, filename: string): string;
+/**
+ * Resolve the timeout for a specific stage.
+ * Reads per-stage timeout from settings (workflow.stageTimeouts.<stage>Ms),
+ * falling back to DEFAULT_STAGE_TIMEOUT_MS when not configured.
+ */
+export declare function getStageTimeoutMs(nodeName: string): number;
 /**
  * Build executor options with cwd. Each node gets a clean agent context.
+ * The timeout is resolved per-stage from settings (workflow.stageTimeouts)
+ * with a fallback to DEFAULT_STAGE_TIMEOUT_MS (10 min).
+ *
+ * When no `nodeName` is provided, the current node from state is used.
  */
-export declare function buildExecutorOptions(state: FeatureAgentState, overrides?: Partial<Pick<AgentExecutionOptions, 'timeout'>>): AgentExecutionOptions;
+export declare function buildExecutorOptions(state: FeatureAgentState, overrides?: Partial<Pick<AgentExecutionOptions, 'timeout'>>, nodeName?: string): AgentExecutionOptions;
 /**
  * Parse YAML with automatic sanitization of common AI-generated issues.
  * First attempts normal parsing; on failure, sanitizes unquoted braces

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/node-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/node-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/node-helpers.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/node-helpers.js

@@ -8,6 +8,7 @@ import yaml from 'js-yaml';
 import { readFileSync, writeFileSync, renameSync, unlinkSync } from 'node:fs';
 import { join } from 'node:path';
 import { interrupt, isGraphBubbleUp } from '@langchain/langgraph';
+import { hasSettings, getSettings } from '../../../../services/settings.service.js';
 import { reportNodeStart } from '../heartbeat.js';
 import { recordPhaseStart, recordPhaseEnd, recordApprovalWaitStart, } from '../phase-timing-context.js';
 import { updateNodeLifecycle } from '../lifecycle-context.js';
@@ -44,14 +45,52 @@ export function readSpecFile(specDir, filename) {
         return '';
     }
 }
+/** Default timeout per agent call (30 minutes) — prevents infinite hangs. */
+const DEFAULT_STAGE_TIMEOUT_MS = 1_800_000;
+/**
+ * Map from node name to the corresponding StageTimeouts field.
+ * `fast-implement` reuses the implement timeout; `evidence` also reuses implement.
+ */
+const STAGE_TIMEOUT_KEY = {
+    analyze: 'analyzeMs',
+    requirements: 'requirementsMs',
+    research: 'researchMs',
+    plan: 'planMs',
+    implement: 'implementMs',
+    'fast-implement': 'implementMs',
+    evidence: 'implementMs',
+    merge: 'mergeMs',
+};
+/**
+ * Resolve the timeout for a specific stage.
+ * Reads per-stage timeout from settings (workflow.stageTimeouts.<stage>Ms),
+ * falling back to DEFAULT_STAGE_TIMEOUT_MS when not configured.
+ */
+export function getStageTimeoutMs(nodeName) {
+    if (!hasSettings())
+        return DEFAULT_STAGE_TIMEOUT_MS;
+    const timeouts = getSettings().workflow?.stageTimeouts;
+    if (!timeouts)
+        return DEFAULT_STAGE_TIMEOUT_MS;
+    const key = STAGE_TIMEOUT_KEY[nodeName];
+    if (!key)
+        return DEFAULT_STAGE_TIMEOUT_MS;
+    return timeouts[key] ?? DEFAULT_STAGE_TIMEOUT_MS;
+}
 /**
  * Build executor options with cwd. Each node gets a clean agent context.
+ * The timeout is resolved per-stage from settings (workflow.stageTimeouts)
+ * with a fallback to DEFAULT_STAGE_TIMEOUT_MS (10 min).
+ *
+ * When no `nodeName` is provided, the current node from state is used.
  */
-export function buildExecutorOptions(state, overrides) {
+export function buildExecutorOptions(state, overrides, nodeName) {
+    const stage = nodeName ?? state.currentNode ?? '';
+    const stageTimeout = getStageTimeoutMs(stage);
     return {
         cwd: state.worktreePath || state.repositoryPath,
         maxTurns: 5000,
-        timeout: 1_800_000, // 30 minutes per agent call — prevents infinite hangs
+        timeout: stageTimeout,
         ...(state.model ? { model: state.model } : {}),
         ...overrides,
     };
@@ -373,7 +412,7 @@ export function executeNode(nodeName, executor, buildPrompt) {
         try {
             const resumePrefix = buildResumeContext(state.resumeReason);
             const prompt = resumePrefix + buildPrompt(state, log);
-            const options = buildExecutorOptions(state);
+            const options = buildExecutorOptions(state, undefined, nodeName);
             log.info(`Executing agent at cwd=${options.cwd}`);
             log.info(`Prompt length: ${prompt.length} chars`);
             const result = await executor.execute(prompt, options);

package/dist/src/presentation/cli/commands/feat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAa3C"}

package/dist/src/presentation/cli/commands/feat/index.js

@@ -15,6 +15,7 @@ import { createLsCommand } from './ls.command.js';
 import { createShowCommand } from './show.command.js';
 import { createDelCommand } from './del.command.js';
 import { createResumeCommand } from './resume.command.js';
+import { createStartCommand } from './start.command.js';
 import { createReviewCommand } from './review.command.js';
 import { createApproveCommand } from './approve.command.js';
 import { createRejectCommand } from './reject.command.js';
@@ -30,6 +31,7 @@ export function createFeatCommand() {
         .addCommand(createShowCommand())
         .addCommand(createDelCommand())
         .addCommand(createResumeCommand())
+        .addCommand(createStartCommand())
         .addCommand(createReviewCommand())
         .addCommand(createApproveCommand())
         .addCommand(createRejectCommand())

package/dist/src/presentation/cli/commands/feat/ls.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ls.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/ls.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyKpC,wBAAgB,eAAe,IAAI,OAAO,CAsGzC"}
+{"version":3,"file":"ls.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/ls.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6KpC,wBAAgB,eAAe,IAAI,OAAO,CAsGzC"}

package/dist/src/presentation/cli/commands/feat/ls.command.js

@@ -54,6 +54,9 @@ function formatStatus(feature, run) {
     if (feature.lifecycle === 'Blocked') {
         return `${colors.warning(symbols.dotEmpty)} ${colors.warning('Blocked')}`;
     }
+    if (feature.lifecycle === 'Pending') {
+        return `${colors.muted(symbols.dotEmpty)} ${colors.muted('Pending')}`;
+    }
     if (!run) {
         return `${colors.muted(symbols.dotEmpty)} ${colors.muted(feature.lifecycle)}`;
     }

package/dist/src/presentation/cli/commands/feat/new.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/new.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4DpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAwI1C"}
+{"version":3,"file":"new.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/new.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6DpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAmJ1C"}

package/dist/src/presentation/cli/commands/feat/new.command.js

@@ -55,6 +55,7 @@ export function createNewCommand() {
         .option('--allow-merge', 'Auto-approve merge phase')
         .option('--allow-all', 'Run fully autonomous (no approval pauses)')
         .option('--parent <fid>', 'Parent feature ID (full or partial prefix)')
+        .option('--pending', 'Create feature without starting the agent')
         .option('--fast', 'Skip SDLC phases and implement directly from your prompt')
         .option('--model <model>', 'LLM model identifier for this run (e.g. claude-opus-4-6)')
         .option('--attach <path>', 'Attach a file (repeatable)', collect, [])
@@ -113,6 +114,7 @@ export function createNewCommand() {
                 push,
                 openPr,
                 ...(parentId !== undefined && { parentId }),
+                ...(options.pending && { pending: true }),
                 ...(options.fast && { fast: true }),
                 ...(options.model !== undefined && { model: options.model }),
                 ...(attachmentPaths.length > 0 && { attachmentPaths }),
@@ -129,6 +131,9 @@ export function createNewCommand() {
             if (feature.lifecycle === SdlcLifecycle.Blocked) {
                 messages.info(`Feature created in Blocked state — waiting for parent to reach Implementation`);
             }
+            if (feature.lifecycle === SdlcLifecycle.Pending) {
+                messages.info(`Feature created in Pending state — run ${colors.accent(`shep feat start ${feature.id.slice(0, 8)}`)} to begin`);
+            }
             console.log(`  ${colors.muted('ID:')}       ${colors.accent(feature.id)}`);
             console.log(`  ${colors.muted('Name:')}     ${feature.name}`);
             console.log(`  ${colors.muted('Branch:')}   ${colors.accent(feature.branch)}`);
@@ -138,7 +143,10 @@ export function createNewCommand() {
                 console.log(`  ${colors.muted('Spec:')}     ${feature.specPath}`);
             }
             if (feature.agentRunId) {
-                console.log(`  ${colors.muted('Agent:')}    ${colors.success('spawned')} (run ${feature.agentRunId.slice(0, 8)})`);
+                const agentStatus = feature.lifecycle === SdlcLifecycle.Pending
+                    ? colors.muted('pending')
+                    : colors.success('spawned');
+                console.log(`  ${colors.muted('Agent:')}    ${agentStatus} (run ${feature.agentRunId.slice(0, 8)})`);
             }
             if (push || openPr) {
                 const pushHint = openPr ? 'push + PR' : 'push only';

package/dist/src/presentation/cli/commands/feat/start.command.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Feature Start Command
+ *
+ * Starts a pending feature by transitioning it to its active lifecycle
+ * and spawning the agent.
+ *
+ * Usage:
+ *   shep feat start <id>
+ */
+import { Command } from 'commander';
+export declare function createStartCommand(): Command;
+//# sourceMappingURL=start.command.d.ts.map

package/dist/src/presentation/cli/commands/feat/start.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/start.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,kBAAkB,IAAI,OAAO,CAgC5C"}

package/dist/src/presentation/cli/commands/feat/start.command.js

@@ -0,0 +1,43 @@
+/**
+ * Feature Start Command
+ *
+ * Starts a pending feature by transitioning it to its active lifecycle
+ * and spawning the agent.
+ *
+ * Usage:
+ *   shep feat start <id>
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { StartFeatureUseCase } from '../../../../../packages/core/src/application/use-cases/features/start-feature.use-case.js';
+import { colors, messages, spinner } from '../../ui/index.js';
+export function createStartCommand() {
+    return new Command('start')
+        .description('Start a pending feature (spawn the agent)')
+        .argument('<id>', 'Feature ID (or prefix)')
+        .action(async (id) => {
+        try {
+            const useCase = container.resolve(StartFeatureUseCase);
+            const { feature, agentRun } = await spinner('Starting feature', () => useCase.execute(id));
+            messages.newline();
+            if (feature.lifecycle === 'Blocked') {
+                messages.warning(`Feature transitioned to Blocked — parent has not reached Implementation`);
+            }
+            else {
+                messages.success('Feature started');
+            }
+            console.log(`  ${colors.muted('Feature:')} ${feature.name}`);
+            console.log(`  ${colors.muted('Branch:')}  ${colors.accent(feature.branch)}`);
+            console.log(`  ${colors.muted('Status:')}  ${feature.lifecycle}`);
+            if (feature.lifecycle !== 'Blocked') {
+                console.log(`  ${colors.muted('Agent:')}   ${colors.success('spawned')} (run ${agentRun.id.slice(0, 8)})`);
+            }
+            messages.newline();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to start feature', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/web/app/actions/create-feature.d.ts

@@ -18,6 +18,8 @@ interface CreateFeatureInput {
     parentId?: string;
     /** When true, skip SDLC phases and implement directly from the prompt. */
     fast?: boolean;
+    /** When true, create the feature in pending state (no agent spawned). */
+    pending?: boolean;
     /** Optional agent type override for this feature run */
     agentType?: string;
     /** Optional model identifier for this feature run */

package/dist/src/presentation/web/app/actions/create-feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/create-feature.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAGpE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4EhD"}
+{"version":3,"file":"create-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/create-feature.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAGpE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+EhD"}

package/dist/src/presentation/web/app/actions/create-feature.js

@@ -2,7 +2,7 @@
 import { resolve } from '../../lib/server-container.js';
 import { composeUserInput } from './compose-user-input.js';
 export async function createFeature(input) {
-    const { description, repositoryPath, attachments, sessionId, approvalGates, push, openPr, parentId, fast, agentType, model, } = input;
+    const { description, repositoryPath, attachments, sessionId, approvalGates, push, openPr, parentId, fast, pending, agentType, model, } = input;
     if (!description?.trim()) {
         return { error: 'description is required' };
     }
@@ -27,6 +27,7 @@ export async function createFeature(input) {
             ...(parentId ? { parentId } : {}),
             description,
             ...(fast ? { fast } : {}),
+            ...(pending ? { pending } : {}),
             ...(agentType ? { agentType } : {}),
             ...(model ? { model } : {}),
         });
@@ -41,6 +42,7 @@ export async function createFeature(input) {
             openPr: openPr ?? false,
             ...(parentId ? { parentId } : {}),
             ...(fast ? { fast } : {}),
+            ...(pending ? { pending } : {}),
             ...(agentType ? { agentType } : {}),
             ...(model ? { model } : {}),
             ...(sessionId ? { sessionId } : {}),

package/dist/src/presentation/web/app/actions/start-feature.d.ts

@@ -0,0 +1,5 @@
+export declare function startFeature(featureId: string): Promise<{
+    started: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=start-feature.d.ts.map

package/dist/src/presentation/web/app/actions/start-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/start-feature.ts"],"names":[],"mappings":"AAKA,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/C"}

package/dist/src/presentation/web/app/actions/start-feature.js

@@ -0,0 +1,16 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+export async function startFeature(featureId) {
+    if (!featureId.trim()) {
+        return { started: false, error: 'Feature id is required' };
+    }
+    try {
+        const useCase = resolve('StartFeatureUseCase');
+        await useCase.execute(featureId);
+        return { started: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to start feature';
+        return { started: false, error: message };
+    }
+}

package/dist/src/presentation/web/app/api/agent-events/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/app/api/agent-events/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAqEvC,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA4R9C"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/app/api/agent-events/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAsEvC,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA4R9C"}

package/dist/src/presentation/web/app/api/agent-events/route.js

@@ -34,6 +34,7 @@ const LIFECYCLE_TO_NODE = {
     [SdlcLifecycle.Review]: 'merge',
     [SdlcLifecycle.Maintain]: 'maintain',
     [SdlcLifecycle.Blocked]: 'blocked',
+    [SdlcLifecycle.Pending]: 'pending',
     [SdlcLifecycle.Deleting]: 'blocked',
 };
 const STATUS_TO_EVENT = {

package/dist/src/presentation/web/components/common/base-drawer/base-drawer.js

@@ -15,7 +15,7 @@ const drawerVariants = cva('', {
     variants: {
         size: {
             sm: 'w-96',
-            md: 'w-xl',
+            md: 'w-2xl',
         },
     },
     defaultVariants: {

package/dist/src/presentation/web/components/common/base-drawer/base-drawer.stories.js

@@ -32,7 +32,7 @@ export const SmallSize = {
 };
 /** Medium size with content-rich review-style content. */
 export const MediumSize = {
-    render: () => (_jsx(DrawerTrigger, { size: "md", children: _jsxs("div", { className: "flex flex-col gap-4 p-4", children: [_jsx("h3", { className: "text-sm font-semibold", children: "Review Content" }), _jsx("p", { className: "text-muted-foreground text-sm", children: "This drawer uses size=\"md\" (w-xl / 576px) for content-rich review panels that need more horizontal space for diff summaries, tables, and code blocks." }), _jsx("div", { className: "bg-muted rounded-md p-3", children: _jsx("pre", { className: "text-xs", children: `+ Added authentication middleware\n- Removed legacy session handler\n  Updated user model schema` }) })] }) })),
+    render: () => (_jsx(DrawerTrigger, { size: "md", children: _jsxs("div", { className: "flex flex-col gap-4 p-4", children: [_jsx("h3", { className: "text-sm font-semibold", children: "Review Content" }), _jsx("p", { className: "text-muted-foreground text-sm", children: "This drawer uses size=\"md\" (w-2xl / 672px) for content-rich review panels that need more horizontal space for diff summaries, tables, and code blocks." }), _jsx("div", { className: "bg-muted rounded-md p-3", children: _jsx("pre", { className: "text-xs", children: `+ Added authentication middleware\n- Removed legacy session handler\n  Updated user model schema` }) })] }) })),
 };
 /** Modal drawer with overlay. */
 export const Modal = {

package/dist/src/presentation/web/components/common/control-center-drawer/feature-drawer-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-drawer-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/control-center-drawer/feature-drawer-client.tsx"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,wBAAwB,2CA8iB1F"}
+{"version":3,"file":"feature-drawer-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/control-center-drawer/feature-drawer-client.tsx"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,wBAAwB,2CA+jB1F"}

package/dist/src/presentation/web/components/common/control-center-drawer/feature-drawer-client.js

@@ -6,6 +6,7 @@ import { toast } from 'sonner';
 import { Loader2, Trash2, Play, Square, Copy, Check, Code2, ExternalLink } from 'lucide-react';
 import { approveFeature } from '../../../app/actions/approve-feature.js';
 import { resumeFeature } from '../../../app/actions/resume-feature.js';
+import { startFeature } from '../../../app/actions/start-feature.js';
 import { rejectFeature } from '../../../app/actions/reject-feature.js';
 import { getFeatureArtifact } from '../../../app/actions/get-feature-artifact.js';
 import { getResearchArtifact } from '../../../app/actions/get-research-artifact.js';
@@ -281,6 +282,20 @@ export function FeatureDrawerClient({ view: initialView, urlTab }) {
             return { ...prev, node: { ...prev.node, state: 'running' } };
         });
     }, []);
+    const handleStart = useCallback(async (featureId) => {
+        const result = await startFeature(featureId);
+        if (result.error) {
+            toast.error(result.error);
+            return;
+        }
+        toast.success('Feature started');
+        // Optimistically update the drawer view
+        setView((prev) => {
+            if (prev.type !== 'feature')
+                return prev;
+            return { ...prev, node: { ...prev.node, state: 'running' } };
+        });
+    }, []);
     // ── Hooks (always called unconditionally per Rules of Hooks) ──────────
     const featureActionsInput = featureNode?.repositoryPath && featureNode?.branch
         ? {
@@ -322,7 +337,11 @@ export function FeatureDrawerClient({ view: initialView, urlTab }) {
     // ── Body ──────────────────────────────────────────────────────────────
     let body = null;
     if (view.type === 'feature' && featureNode) {
-        const enrichedNode = featureNode.state === 'error' ? { ...featureNode, onRetry: handleRetry } : featureNode;
+        const enrichedNode = {
+            ...featureNode,
+            ...(featureNode.state === 'error' && { onRetry: handleRetry }),
+            ...(featureNode.state === 'pending' && { onStart: handleStart }),
+        };
         body = (_jsx(FeatureDrawerTabs, { featureNode: enrichedNode, featureId: featureNode.featureId, initialTab: view.initialTab, urlTab: urlTab, sseEvents: events, prdData: prdData, prdSelections: prdSelections, onPrdSelect: (qId, oId) => setPrdSelections((prev) => ({ ...prev, [qId]: oId })), onPrdApprove: handlePrdApprove, onPrdReject: handlePrdReject, isPrdLoading: isLoadingPrd, techData: techData, onTechApprove: handleTechApprove, onTechReject: handleTechReject, isTechLoading: isLoadingTech, productData: isLoadingTechProduct ? null : techProductData, mergeData: mergeData, onMergeApprove: handleMergeApprove, onMergeReject: handleMergeReject, isMergeLoading: isLoadingMerge, isRejecting: isRejecting, chatInput: chatInput, onChatInputChange: setChatInput }));
     }
     return (_jsx(BaseDrawer, { open: isOpen, onClose: attemptClose, size: "md", modal: false, header: header, "data-testid": view.type === 'feature' ? 'feature-drawer' : 'repository-drawer', children: body }));