@shepai/cli 1.169.1 → 1.170.0-pr513.cff27cb

package/dist/packages/core/src/application/use-cases/features/create/types.d.ts

@@ -1,4 +1,5 @@
 import type { ApprovalGates, Attachment, Feature } from '../../../../domain/generated/output.js';
+import { type FeatureMode } from '../../../../domain/generated/output.js';
 export interface CreateFeatureInput {
     userInput: string;
     repositoryPath: string;
@@ -11,8 +12,8 @@ export interface CreateFeatureInput {
     name?: string;
     /** Pre-supplied description (skips AI metadata extraction for description). */
     description?: string;
-    /** When true, skip SDLC phases and implement directly from the user prompt. */
-    fast?: boolean;
+    /** Execution mode: Regular (full SDLC), Fast (direct implementation), or Exploration (iterative prototyping). */
+    mode?: FeatureMode;
     /** Fork repo and create PR to upstream at merge time (default: false). */
     forkAndPr?: boolean;
     /** Commit specs/evidences into the repo (default: true, auto-false when forkAndPr). */
@@ -37,6 +38,8 @@ export interface CreateFeatureInput {
     attachmentPaths?: string[];
     /** Sync the default branch from remote before creating the feature branch (default: true). */
     rebaseBeforeBranch?: boolean;
+    /** Inject curated skills into the worktree (overrides settings.workflow.skillInjection.enabled). */
+    injectSkills?: boolean;
 }
 export interface CreateFeatureResult {
     feature: Feature;

package/dist/packages/core/src/application/use-cases/features/create/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAEjG,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iHAAiH;IACjH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/packages/core/src/application/use-cases/features/delete-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBALP,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB,EAClC,YAAY,EAAE,aAAa;IAGjE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BlF,oGAAoG;YACtF,gBAAgB;IAW9B,0DAA0D;YAC5C,iBAAiB;IAQ/B,6DAA6D;YAC/C,yBAAyB;IAevC,sDAAsD;YACxC,sBAAsB;IAYpC,6EAA6E;YAC/D,oBAAoB;CA+EnC"}
+{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBALP,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB,EAClC,YAAY,EAAE,aAAa;IAGjE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BlF,oGAAoG;YACtF,gBAAgB;IAW9B,0DAA0D;YAC5C,iBAAiB;IAQ/B,6DAA6D;YAC/C,yBAAyB;IAevC,sDAAsD;YACxC,sBAAsB;IAYpC,6EAA6E;YAC/D,oBAAoB;CAyFnC"}

package/dist/packages/core/src/application/use-cases/features/delete-feature.use-case.js

@@ -25,6 +25,9 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { unlink } from 'node:fs/promises';
 import { AgentRunStatus, PrStatus, SdlcLifecycle } from '../../../domain/generated/output.js';
 let DeleteFeatureUseCase = class DeleteFeatureUseCase {
     featureRepo;
@@ -123,6 +126,16 @@ let DeleteFeatureUseCase = class DeleteFeatureUseCase {
                 }
                 await this.runRepo.updateStatus(run.id, AgentRunStatus.cancelled);
             }
+            // Clean up checkpoint database file (used by LangGraph for state persistence)
+            if (run?.threadId) {
+                const checkpointPath = join(homedir(), '.shep', 'checkpoints', `${run.threadId}.db`);
+                try {
+                    await unlink(checkpointPath);
+                }
+                catch {
+                    // Checkpoint file may not exist or already be removed
+                }
+            }
         }
         // Cleanup worktree and branches directly using the feature data we already
         // have (CleanupFeatureWorktreeUseCase.execute() would fail because

package/dist/packages/core/src/application/use-cases/features/promote/promote-exploration.use-case.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Promote Exploration Use Case
+ *
+ * Transitions an exploration feature to Regular or Fast mode via in-place
+ * mode transition. Changes the mode field, transitions lifecycle from
+ * Exploring to Requirements (regular) or Implementation (fast), optionally
+ * scaffolds missing spec YAMLs when promoting to regular, and spawns the
+ * appropriate agent graph.
+ *
+ * Business Rules:
+ * - Feature must be in Exploration mode and Exploring lifecycle
+ * - Promotion preserves existing worktree and branch (prototype code)
+ * - Promoting to Regular scaffolds missing spec YAMLs (spec, research, plan, tasks)
+ * - Promoting to Fast does not scaffold spec YAMLs
+ * - Spawns the appropriate agent graph after transition
+ */
+import type { Feature } from '../../../../domain/generated/output.js';
+import { FeatureMode } from '../../../../domain/generated/output.js';
+import type { IFeatureRepository } from '../../../ports/output/repositories/feature-repository.interface.js';
+import type { IFeatureAgentProcessService } from '../../../ports/output/agents/feature-agent-process.interface.js';
+import type { IAgentRunRepository } from '../../../ports/output/agents/agent-run-repository.interface.js';
+import type { ISpecInitializerService } from '../../../ports/output/services/spec-initializer.interface.js';
+import type { IWorktreeService } from '../../../ports/output/services/worktree-service.interface.js';
+export interface PromoteExplorationInput {
+    featureId: string;
+    targetMode: FeatureMode.Regular | FeatureMode.Fast;
+}
+export interface PromoteExplorationResult {
+    feature: Feature;
+}
+export declare class PromoteExplorationUseCase {
+    private readonly featureRepo;
+    private readonly processService;
+    private readonly runRepo;
+    private readonly specInitializer;
+    private readonly worktreeService;
+    constructor(featureRepo: IFeatureRepository, processService: IFeatureAgentProcessService, runRepo: IAgentRunRepository, specInitializer: ISpecInitializerService, worktreeService: IWorktreeService);
+    execute(input: PromoteExplorationInput): Promise<PromoteExplorationResult>;
+}
+//# sourceMappingURL=promote-exploration.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/features/promote/promote-exploration.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote-exploration.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/promote/promote-exploration.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAiB,WAAW,EAAkB,MAAM,wCAAwC,CAAC;AAEpG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AAGrG,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBACa,yBAAyB;IAGlC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBARf,WAAW,EAAE,kBAAkB,EAE/B,cAAc,EAAE,2BAA2B,EAE3C,OAAO,EAAE,mBAAmB,EAE5B,eAAe,EAAE,uBAAuB,EAExC,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAiGjF"}

package/dist/packages/core/src/application/use-cases/features/promote/promote-exploration.use-case.js

@@ -0,0 +1,125 @@
+/**
+ * Promote Exploration Use Case
+ *
+ * Transitions an exploration feature to Regular or Fast mode via in-place
+ * mode transition. Changes the mode field, transitions lifecycle from
+ * Exploring to Requirements (regular) or Implementation (fast), optionally
+ * scaffolds missing spec YAMLs when promoting to regular, and spawns the
+ * appropriate agent graph.
+ *
+ * Business Rules:
+ * - Feature must be in Exploration mode and Exploring lifecycle
+ * - Promotion preserves existing worktree and branch (prototype code)
+ * - Promoting to Regular scaffolds missing spec YAMLs (spec, research, plan, tasks)
+ * - Promoting to Fast does not scaffold spec YAMLs
+ * - Spawns the appropriate agent graph after transition
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { randomUUID } from 'node:crypto';
+import { SdlcLifecycle, FeatureMode, AgentRunStatus } from '../../../../domain/generated/output.js';
+import { EXPLORING_TRANSITIONS } from '../../../../domain/lifecycle-gates.js';
+import { getSettings } from '../../../../infrastructure/services/settings.service.js';
+let PromoteExplorationUseCase = class PromoteExplorationUseCase {
+    featureRepo;
+    processService;
+    runRepo;
+    specInitializer;
+    worktreeService;
+    constructor(featureRepo, processService, runRepo, specInitializer, worktreeService) {
+        this.featureRepo = featureRepo;
+        this.processService = processService;
+        this.runRepo = runRepo;
+        this.specInitializer = specInitializer;
+        this.worktreeService = worktreeService;
+    }
+    async execute(input) {
+        const feature = (await this.featureRepo.findById(input.featureId)) ??
+            (await this.featureRepo.findByIdPrefix(input.featureId));
+        if (!feature) {
+            throw new Error(`Feature not found: ${input.featureId}`);
+        }
+        if (feature.mode !== FeatureMode.Exploration) {
+            throw new Error(`Feature "${feature.name}" is not in Exploration mode (current: ${feature.mode}). Only exploration features can be promoted.`);
+        }
+        if (feature.lifecycle !== SdlcLifecycle.Exploring) {
+            throw new Error(`Feature "${feature.name}" is not in Exploring lifecycle (current: ${feature.lifecycle}). Only features in Exploring state can be promoted.`);
+        }
+        const targetLifecycle = input.targetMode === FeatureMode.Fast
+            ? SdlcLifecycle.Implementation
+            : SdlcLifecycle.Requirements;
+        // Validate the transition is allowed
+        if (!EXPLORING_TRANSITIONS.has(targetLifecycle)) {
+            throw new Error(`Invalid promotion target lifecycle: ${targetLifecycle}`);
+        }
+        // Scaffold missing spec YAMLs when promoting to regular mode
+        if (input.targetMode === FeatureMode.Regular && feature.specPath) {
+            const worktreePath = feature.worktreePath ??
+                this.worktreeService.getWorktreePath(feature.repositoryPath, feature.branch);
+            await this.specInitializer.initialize(worktreePath, feature.slug, 0, // Feature number hint — resolveNextNumber will use existing dir
+            feature.userQuery);
+        }
+        // Create a new agent run for the promoted mode
+        const settings = getSettings();
+        const runId = randomUUID();
+        const agentRun = {
+            id: runId,
+            agentType: settings.agent.type,
+            agentName: 'feature-agent',
+            status: AgentRunStatus.pending,
+            prompt: feature.userQuery,
+            threadId: randomUUID(),
+            featureId: feature.id,
+            repositoryPath: feature.repositoryPath,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        await this.runRepo.create(agentRun);
+        // Update the feature: mode, lifecycle, and agent run reference
+        const updatedFeature = {
+            ...feature,
+            mode: input.targetMode,
+            lifecycle: targetLifecycle,
+            agentRunId: runId,
+            updatedAt: new Date(),
+        };
+        await this.featureRepo.update(updatedFeature);
+        // Spawn the appropriate agent graph
+        const worktreePath = feature.worktreePath ??
+            this.worktreeService.getWorktreePath(feature.repositoryPath, feature.branch);
+        this.processService.spawn(feature.id, runId, feature.repositoryPath, feature.specPath ?? '', worktreePath, {
+            approvalGates: feature.approvalGates,
+            threadId: agentRun.threadId,
+            push: feature.push,
+            openPr: feature.openPr,
+            forkAndPr: feature.forkAndPr,
+            commitSpecs: feature.commitSpecs,
+            ciWatchEnabled: feature.ciWatchEnabled,
+            enableEvidence: feature.enableEvidence,
+            commitEvidence: feature.commitEvidence,
+            ...(input.targetMode !== FeatureMode.Regular ? { mode: input.targetMode } : {}),
+        });
+        return { feature: updatedFeature };
+    }
+};
+PromoteExplorationUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IFeatureAgentProcessService')),
+    __param(2, inject('IAgentRunRepository')),
+    __param(3, inject('ISpecInitializerService')),
+    __param(4, inject('IWorktreeService')),
+    __metadata("design:paramtypes", [Object, Object, Object, Object, Object])
+], PromoteExplorationUseCase);
+export { PromoteExplorationUseCase };

package/dist/packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rebase-feature-on-main.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAK7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AAE7G,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4FAA4F,CAAC;AAE5I,qBACa,0BAA0B;IAGnC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAE1C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAVf,WAAW,EAAE,kBAAkB,EAE/B,YAAY,EAAE,aAAa,EAE3B,eAAe,EAAE,gBAAgB,EAEjC,yBAAyB,EAAE,yBAAyB,EAEpD,YAAY,EAAE,mBAAmB,EAEjC,eAAe,EAAE,sBAAsB;IAGpD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA+EjC,cAAc;IAwB5B;;;;OAIG;YACW,UAAU;CAOzB"}
+{"version":3,"file":"rebase-feature-on-main.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAK7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AAE7G,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4FAA4F,CAAC;AAE5I,qBACa,0BAA0B;IAGnC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAE1C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAVf,WAAW,EAAE,kBAAkB,EAE/B,YAAY,EAAE,aAAa,EAE3B,eAAe,EAAE,gBAAgB,EAEjC,yBAAyB,EAAE,yBAAyB,EAEpD,YAAY,EAAE,mBAAmB,EAEjC,eAAe,EAAE,sBAAsB;IAGpD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAyGjC,cAAc;IAwB5B;;;;OAIG;YACW,UAAU;CAOzB"}

package/dist/packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.js

@@ -77,7 +77,8 @@ let RebaseFeatureOnMainUseCase = class RebaseFeatureOnMainUseCase {
             const cwd = await this.resolveCwd(feature.repositoryPath, feature.branch);
             const defaultBranch = await this.gitPrService.getDefaultBranch(feature.repositoryPath);
             // Stash uncommitted changes if present (smart rebase)
-            const didStash = await this.gitPrService.stash(cwd, 'shep-rebase: auto-stash before rebase');
+            const didStash = await this.gitPrService.stash(cwd, `shep-auto-stash: ${feature.branch}`);
+            let stashPopError;
             try {
                 // Auto-sync main before rebasing (per spec decision)
                 await this.gitPrService.syncMain(cwd, defaultBranch);
@@ -98,9 +99,29 @@ let RebaseFeatureOnMainUseCase = class RebaseFeatureOnMainUseCase {
             finally {
                 // Restore stashed changes after rebase (whether it succeeded or failed)
                 if (didStash) {
-                    await this.gitPrService.stashPop(cwd);
+                    try {
+                        await this.gitPrService.stashPop(cwd);
+                    }
+                    catch {
+                        // Stash pop failed — likely conflicts between rebased code and stashed changes.
+                        // Invoke agent-powered resolution, then drop the stash entry on success.
+                        try {
+                            await this.conflictResolutionService.resolveStashPop(cwd, feature.branch, defaultBranch);
+                            await this.gitPrService.stashDrop(cwd);
+                        }
+                        catch {
+                            stashPopError = new Error(`Rebase succeeded but failed to restore your uncommitted changes. ` +
+                                `The rebase is complete, but your stashed work-in-progress could not be applied cleanly. ` +
+                                `Run \`git stash pop\` manually to resolve the remaining conflicts. ` +
+                                `Your stash entry is preserved.`);
+                        }
+                    }
                 }
             }
+            // Throw stash pop error after the finally block to satisfy no-unsafe-finally
+            if (stashPopError) {
+                throw stashPopError;
+            }
             // Rebase succeeded (possibly with resolved conflicts)
             await this.completeTiming(agentRunId, phaseTimingId, startMs, 'success');
         }

package/dist/packages/core/src/application/use-cases/features/resume-feature.use-case.js

@@ -18,7 +18,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from 'tsyringe';
 import { randomUUID } from 'node:crypto';
-import { AgentRunStatus } from '../../../domain/generated/output.js';
+import { AgentRunStatus, FeatureMode } from '../../../domain/generated/output.js';
 const RESUMABLE_STATUSES = new Set([
     AgentRunStatus.interrupted,
     AgentRunStatus.failed,
@@ -115,7 +115,7 @@ let ResumeFeatureUseCase = class ResumeFeatureUseCase {
             enableEvidence: feature.enableEvidence,
             commitEvidence: feature.commitEvidence,
             agentType: lastRun.agentType,
-            ...(feature.fast ? { fast: true } : {}),
+            ...(feature.mode !== FeatureMode.Regular ? { mode: feature.mode } : {}),
             ...(lastRun.modelId ? { model: lastRun.modelId } : {}),
             resumeReason: lastRun.status,
         });

package/dist/packages/core/src/application/use-cases/features/start-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/start-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,qBACa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,WAAW,EAAE,kBAAkB,EAE/B,OAAO,EAAE,mBAAmB,EAE5B,cAAc,EAAE,2BAA2B,EAE3C,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAyG9D"}
+{"version":3,"file":"start-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/start-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,qBACa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,WAAW,EAAE,kBAAkB,EAE/B,OAAO,EAAE,mBAAmB,EAE5B,cAAc,EAAE,2BAA2B,EAE3C,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA4G9D"}

package/dist/packages/core/src/application/use-cases/features/start-feature.use-case.js

@@ -18,7 +18,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-import { SdlcLifecycle } from '../../../domain/generated/output.js';
+import { SdlcLifecycle, FeatureMode } from '../../../domain/generated/output.js';
 import { POST_IMPLEMENTATION } from '../../../domain/lifecycle-gates.js';
 let StartFeatureUseCase = class StartFeatureUseCase {
     featureRepo;
@@ -71,7 +71,9 @@ let StartFeatureUseCase = class StartFeatureUseCase {
             }
         }
         // Check parent gate if feature has a parent
-        let targetLifecycle = resolved.fast ? SdlcLifecycle.Implementation : SdlcLifecycle.Requirements;
+        let targetLifecycle = resolved.mode === FeatureMode.Fast
+            ? SdlcLifecycle.Implementation
+            : SdlcLifecycle.Requirements;
         let shouldSpawn = true;
         if (resolved.parentId) {
             const parent = await this.featureRepo.findById(resolved.parentId);
@@ -103,7 +105,7 @@ let StartFeatureUseCase = class StartFeatureUseCase {
                 enableEvidence: resolved.enableEvidence,
                 commitEvidence: resolved.commitEvidence,
                 agentType: agentRun.agentType,
-                ...(resolved.fast ? { fast: true } : {}),
+                ...(resolved.mode !== FeatureMode.Regular ? { mode: resolved.mode } : {}),
                 ...(agentRun.modelId ? { model: agentRun.modelId } : {}),
             });
         }

package/dist/packages/core/src/domain/factories/settings-defaults.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-defaults.factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/domain/factories/settings-defaults.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,QAAQ,EAUT,MAAM,qBAAqB,CAAC;AA6C7B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAuFhD"}
+{"version":3,"file":"settings-defaults.factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/domain/factories/settings-defaults.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,QAAQ,EAWT,MAAM,qBAAqB,CAAC;AAmD7B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CA+IhD"}

package/dist/packages/core/src/domain/factories/settings-defaults.factory.js

@@ -11,7 +11,7 @@
  * - Auto-update enabled, log level set to info
  * - Unique IDs and timestamps generated for each instance
  */
-import { AgentType, AgentAuthMethod, EditorType, TerminalType } from '../generated/output.js';
+import { AgentType, AgentAuthMethod, EditorType, SkillSourceType, TerminalType, } from '../generated/output.js';
 /**
  * Default AI model for all SDLC agents.
  * Provides balanced performance and cost for all workflow stages.
@@ -112,14 +112,69 @@ export function createDefaultSettings() {
         allowMerge: false,
         pushOnImplementationComplete: false,
     };
+    const skillInjection = {
+        enabled: false,
+        skills: [
+            {
+                name: 'architecture-reviewer',
+                type: SkillSourceType.Remote,
+                source: 'shep-ai/shep',
+                remoteSkillName: 'architecture-reviewer',
+            },
+            {
+                name: 'cross-validate-artifacts',
+                type: SkillSourceType.Remote,
+                source: 'shep-ai/shep',
+                remoteSkillName: 'cross-validate-artifacts',
+            },
+            {
+                name: 'mermaid-diagrams',
+                type: SkillSourceType.Remote,
+                source: 'shep-ai/shep',
+                remoteSkillName: 'mermaid-diagrams',
+            },
+            {
+                name: 'react-flow',
+                type: SkillSourceType.Remote,
+                source: 'shep-ai/shep',
+                remoteSkillName: 'react-flow',
+            },
+            {
+                name: 'shadcn-ui',
+                type: SkillSourceType.Remote,
+                source: 'shep-ai/shep',
+                remoteSkillName: 'shadcn-ui',
+            },
+            {
+                name: 'tsp-model',
+                type: SkillSourceType.Remote,
+                source: 'shep-ai/shep',
+                remoteSkillName: 'tsp-model',
+            },
+            {
+                name: 'vercel-react-best-practices',
+                type: SkillSourceType.Remote,
+                source: 'shep-ai/shep',
+                remoteSkillName: 'vercel-react-best-practices',
+            },
+            {
+                name: 'frontend-design',
+                type: SkillSourceType.Remote,
+                source: 'anthropics/claude-code',
+                remoteSkillName: 'frontend-design',
+            },
+        ],
+    };
     const workflow = {
         openPrOnImplementationComplete: false,
         approvalGateDefaults,
         ciWatchEnabled: true,
         enableEvidence: false,
         commitEvidence: false,
-        defaultFastMode: true,
+        defaultMode: 'Fast',
+        explorationMaxIterations: 10,
         autoArchiveDelayMinutes: 10,
+        skillInjection,
     };
     const featureFlags = {
         skills: false,

package/dist/packages/core/src/domain/generated/output.d.ts

@@ -379,6 +379,44 @@ export type AnalyzeRepoTimeouts = {
      */
     analyzeMs?: number;
 };
+export declare enum SkillSourceType {
+    Local = "local",
+    Remote = "remote"
+}
+/**
+ * A skill source for injection into feature worktrees
+ */
+export type SkillSource = {
+    /**
+     * Unique skill directory name (e.g. 'architecture-reviewer')
+     */
+    name: string;
+    /**
+     * How this skill is provisioned (local copy or remote install)
+     */
+    type: SkillSourceType;
+    /**
+     * Source path (local) or npm package/URL (remote)
+     */
+    source: string;
+    /**
+     * Remote skill name passed to --skill flag (remote type only)
+     */
+    remoteSkillName?: string;
+};
+/**
+ * Skill injection configuration for feature worktrees
+ */
+export type SkillInjectionConfig = {
+    /**
+     * Whether skill injection is enabled (default: false, opt-in)
+     */
+    enabled: boolean;
+    /**
+     * List of skills to inject into feature worktrees
+     */
+    skills: SkillSource[];
+};
 /**
  * Global workflow configuration defaults
  */
@@ -436,13 +474,21 @@ export type WorkflowConfig = {
      */
     hideCiStatus?: boolean;
     /**
-     * Default new features to fast mode (default: true)
+     * Default feature mode for new features: 'Regular', 'Fast', or 'Exploration' (default: 'Fast')
      */
-    defaultFastMode: boolean;
+    defaultMode: string;
+    /**
+     * Maximum exploration feedback iterations (default: 10, 0 = unlimited)
+     */
+    explorationMaxIterations?: number;
     /**
      * Minutes after completion before auto-archiving a feature (default: 10, 0 = disabled)
      */
     autoArchiveDelayMinutes?: number;
+    /**
+     * Skill injection configuration (optional, disabled by default)
+     */
+    skillInjection?: SkillInjectionConfig;
 };
 export declare enum AgentType {
     ClaudeCode = "claude-code",
@@ -808,10 +854,16 @@ export declare enum SdlcLifecycle {
     Maintain = "Maintain",
     Blocked = "Blocked",
     Pending = "Pending",
+    Exploring = "Exploring",
     Deleting = "Deleting",
     AwaitingUpstream = "AwaitingUpstream",
     Archived = "Archived"
 }
+export declare enum FeatureMode {
+    Regular = "Regular",
+    Fast = "Fast",
+    Exploration = "Exploration"
+}
 /**
  * Configuration for human-in-the-loop approval gates
  */
@@ -990,6 +1042,10 @@ export type Feature = SoftDeletableEntity & {
      * Associated agent run ID for process tracking (optional)
      */
     agentRunId?: string;
+    /**
+     * Skills that were injected into this feature's worktree during creation
+     */
+    injectedSkills?: string[];
     /**
      * Absolute path to the feature spec directory inside the worktree
      */
@@ -999,9 +1055,9 @@ export type Feature = SoftDeletableEntity & {
      */
     repositoryId?: UUID;
     /**
-     * When true, SDLC phases were skipped and the feature was implemented directly from the prompt
+     * Execution mode determining the workflow: Regular (full SDLC), Fast (direct implementation), or Exploration (iterative prototyping)
      */
-    fast: boolean;
+    mode: FeatureMode;
     /**
      * Push branch to remote after implementation (default: false)
      */
@@ -1026,6 +1082,10 @@ export type Feature = SoftDeletableEntity & {
      * Enable evidence collection after implementation (default: false)
      */
     enableEvidence: boolean;
+    /**
+     * Inject curated skills into the feature worktree (default: false)
+     */
+    injectSkills: boolean;
     /**
      * Commit evidence to PR (default: false, requires enableEvidence)
      */
@@ -1038,6 +1098,14 @@ export type Feature = SoftDeletableEntity & {
      * Absolute path to the git worktree for this feature
      */
     worktreePath?: string;
+    /**
+     * Current feedback iteration count in exploration mode (0 when not exploring)
+     */
+    iterationCount: number;
+    /**
+     * Maximum allowed iterations for exploration mode (only set when mode is Exploration)
+     */
+    maxIterations?: number;
     /**
      * Pull request data (null until PR created)
      */