@shepai/cli 1.72.8 → 1.72.9-pr220.e1bfec0

package/dist/packages/core/src/application/ports/output/agents/feature-agent-process.interface.d.ts

@@ -9,7 +9,7 @@
  * - Application layer depends on this interface
  * - Infrastructure layer provides concrete implementation
  */
-import type { ApprovalGates } from '../../../../domain/generated/output.js';
+import type { ApprovalGates, AgentType } from '../../../../domain/generated/output.js';
 /**
  * Service interface for feature agent background process management.
  */
@@ -31,6 +31,7 @@ export interface IFeatureAgentProcessService {
         push?: boolean;
         openPr?: boolean;
         resumePayload?: string;
+        agentType?: AgentType;
     }): number;
     /**
      * Check if a process is still alive.

package/dist/packages/core/src/application/ports/output/agents/feature-agent-process.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-process.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/feature-agent-process.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GACA,MAAM,CAAC;IAEV;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}
+{"version":3,"file":"feature-agent-process.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/feature-agent-process.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GACA,MAAM,CAAC;IAEV;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/dist/packages/core/src/application/use-cases/agents/approve-agent-run.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approve-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/approve-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AAC7G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAE1G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAI9E,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBANrB,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,2BAA2B,EAE3C,iBAAiB,EAAE,kBAAkB,EAErC,qBAAqB,EAAE,sBAAsB;IAG1D,OAAO,CACX,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CA6FlD"}
+{"version":3,"file":"approve-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/approve-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AAC7G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAE1G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAI9E,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBANrB,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,2BAA2B,EAE3C,iBAAiB,EAAE,kBAAkB,EAErC,qBAAqB,EAAE,sBAAsB;IAG1D,OAAO,CACX,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CA8FlD"}

package/dist/packages/core/src/application/use-cases/agents/approve-agent-run.use-case.js

@@ -107,6 +107,7 @@ let ApproveAgentRunUseCase = class ApproveAgentRunUseCase {
             push: feature?.push ?? false,
             openPr: feature?.openPr ?? false,
             ...(payload ? { resumePayload: JSON.stringify(payload) } : {}),
+            agentType: run.agentType,
         });
         return { approved: true, reason: 'Approved and resumed' };
     }

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

@@ -15,6 +15,7 @@
  * - specPath is persisted on the Feature record
  * - Initial lifecycle is Requirements
  */
+import type { Feature } from '../../../../domain/generated/output.js';
 import type { IFeatureRepository } from '../../../ports/output/repositories/feature-repository.interface.js';
 import type { IWorktreeService } from '../../../ports/output/services/worktree-service.interface.js';
 import type { IFeatureAgentProcessService } from '../../../ports/output/agents/feature-agent-process.interface.js';
@@ -24,7 +25,7 @@ import type { IRepositoryRepository } from '../../../ports/output/repositories/r
 import type { IGitPrService } from '../../../ports/output/services/git-pr-service.interface.js';
 import { MetadataGenerator } from './metadata-generator.js';
 import { SlugResolver } from './slug-resolver.js';
-import type { CreateFeatureInput, CreateFeatureResult } from './types.js';
+import type { CreateFeatureInput, CreateFeatureResult, CreateRecordResult } from './types.js';
 export declare class CreateFeatureUseCase {
     private readonly featureRepo;
     private readonly worktreeService;
@@ -36,6 +37,24 @@ export declare class CreateFeatureUseCase {
     private readonly repositoryRepo;
     private readonly gitPrService;
     constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, metadataGenerator: MetadataGenerator, slugResolver: SlugResolver, repositoryRepo: IRepositoryRepository, gitPrService: IGitPrService);
+    /**
+     * Full synchronous execution: creates record, initializes worktree/spec, spawns agent.
+     * Used by the CLI which shows a spinner and needs everything done before returning.
+     */
     execute(input: CreateFeatureInput): Promise<CreateFeatureResult>;
+    /**
+     * Phase 1 (fast): Creates the feature + agent run records in DB and returns immediately.
+     * The feature has a real UUID and a preliminary slug derived from the provided name.
+     * No AI calls, no git operations — just DB writes.
+     */
+    createRecord(input: CreateFeatureInput): Promise<CreateRecordResult>;
+    /**
+     * Phase 2 (slow): AI metadata generation, git worktree, spec init, agent spawn.
+     * Updates the feature record with refined metadata, branch, and specPath.
+     */
+    initializeAndSpawn(feature: Feature, input: CreateFeatureInput, shouldSpawn: boolean): Promise<{
+        warning?: string;
+        updatedFeature: Feature;
+    }>;
 }
 //# sourceMappingURL=create-feature.use-case.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,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,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAGhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAhBZ,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa;IAGxC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA8JvE"}
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,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,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAGhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9F,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAhBZ,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa;IAG9C;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgH1E;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAiE1D"}

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

@@ -55,22 +55,31 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         this.repositoryRepo = repositoryRepo;
         this.gitPrService = gitPrService;
     }
+    /**
+     * Full synchronous execution: creates record, initializes worktree/spec, spawns agent.
+     * Used by the CLI which shows a spinner and needs everything done before returning.
+     */
     async execute(input) {
-        // Resolve parent feature and determine child initial lifecycle (FR-8, FR-9, FR-12, FR-19)
+        const { feature, shouldSpawn } = await this.createRecord(input);
+        const { warning, updatedFeature } = await this.initializeAndSpawn(feature, input, shouldSpawn);
+        return { feature: updatedFeature, warning };
+    }
+    /**
+     * Phase 1 (fast): Creates the feature + agent run records in DB and returns immediately.
+     * The feature has a real UUID and a preliminary slug derived from the provided name.
+     * No AI calls, no git operations — just DB writes.
+     */
+    async createRecord(input) {
         let initialLifecycle = SdlcLifecycle.Requirements;
         let shouldSpawn = true;
-        // When creating a child feature, always use the parent's repositoryPath (the
-        // original repo root), not the caller's cwd which may be a worktree (FR-10).
         let effectiveRepoPath = input.repositoryPath;
         if (input.parentId) {
             const parent = await this.featureRepo.findById(input.parentId);
             if (!parent) {
                 throw new Error(`Parent feature not found: ${input.parentId}`);
             }
-            // Use the parent's repositoryPath so the child worktree branches from the
-            // original repo, not from inside another worktree.
             effectiveRepoPath = parent.repositoryPath;
-            // Cycle detection — O(depth) upward walk through ancestor chain (FR-19)
+            // Cycle detection — O(depth) upward walk through ancestor chain
             const visited = new Set([input.parentId]);
             let cursor = parent.parentId;
             while (cursor) {
@@ -81,10 +90,6 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 const ancestor = await this.featureRepo.findById(cursor);
                 cursor = ancestor?.parentId ?? undefined;
             }
-            // Two-gate lifecycle logic (FR-9):
-            //   parent.lifecycle === Blocked → cascade block (FR-12)
-            //   parent.lifecycle not in POST_IMPLEMENTATION → early gate not met → Blocked
-            //   parent.lifecycle in POST_IMPLEMENTATION → gate satisfied → Started
             if (parent.lifecycle === SdlcLifecycle.Blocked ||
                 !POST_IMPLEMENTATION.has(parent.lifecycle)) {
                 initialLifecycle = SdlcLifecycle.Blocked;
@@ -95,29 +100,10 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 shouldSpawn = true;
             }
         }
-        // Ensure the target directory is a git repository (auto-init if needed)
-        // Must run before slug resolution which needs git commands
-        await this.worktreeService.ensureGitRepository(effectiveRepoPath);
-        const metadata = await this.metadataGenerator.generateMetadata(input.userInput);
-        const originalSlug = metadata.slug;
-        // Find a unique slug — the branch may exist from a previous (deleted) feature
-        const { slug, branch, warning } = await this.slugResolver.resolveUniqueSlug(originalSlug, effectiveRepoPath);
-        // Determine next feature number for this repo
-        const existingFeatures = await this.featureRepo.list({
-            repositoryPath: effectiveRepoPath,
-        });
-        const featureNumber = existingFeatures.length + 1;
-        const now = new Date();
-        const runId = randomUUID();
-        // Create git worktree branching from the repo's default branch
-        const defaultBranch = await this.gitPrService.getDefaultBranch(effectiveRepoPath);
-        const worktreePath = this.worktreeService.getWorktreePath(effectiveRepoPath, branch);
-        await this.worktreeService.create(effectiveRepoPath, branch, worktreePath, defaultBranch);
-        // Initialize spec directory — full user input goes into spec.yaml as-is
-        const { specDir } = await this.specInitializer.initialize(worktreePath, slug, featureNumber, input.userInput);
         // Resolve or create repository entity for this path
         const normalizedPath = effectiveRepoPath.replace(/\/+$/, '') || effectiveRepoPath;
         let repository = await this.repositoryRepo.findByPath(normalizedPath);
+        const now = new Date();
         if (!repository) {
             const repoName = normalizedPath.split('/').pop() ?? normalizedPath;
             repository = {
@@ -132,14 +118,19 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 throw new Error(`Failed to create or retrieve repository record for path: ${normalizedPath}`);
             }
         }
+        const featureName = input.name ?? input.userInput.slice(0, 100);
+        const runId = randomUUID();
+        const featureId = randomUUID();
+        // Use the feature ID as a temporary slug so it never collides with the
+        // AI-generated slug in initializeAndSpawn() → resolveUniqueSlug().
         const feature = {
-            id: randomUUID(),
-            name: metadata.name,
-            slug,
-            description: metadata.description,
+            id: featureId,
+            name: featureName,
+            slug: featureId,
+            description: input.description ?? '',
             userQuery: input.userInput,
             repositoryPath: effectiveRepoPath,
-            branch,
+            branch: '',
             lifecycle: initialLifecycle,
             messages: [],
             relatedArtifacts: [],
@@ -151,14 +142,14 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 allowMerge: false,
             },
             agentRunId: runId,
-            specPath: specDir,
+            specPath: '',
             repositoryId: repository.id,
             ...(input.parentId ? { parentId: input.parentId } : {}),
             createdAt: now,
             updatedAt: now,
         };
         await this.featureRepo.create(feature);
-        // Create agent run record and spawn background worker
+        // Create agent run record (pending state — agent not spawned yet)
         const settings = getSettings();
         const agentRun = {
             id: runId,
@@ -174,16 +165,52 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             updatedAt: now.toISOString(),
         };
         await this.runRepository.create(agentRun);
-        // Only spawn the agent immediately if the child is not blocked (FR-9, FR-16)
+        return { feature, shouldSpawn };
+    }
+    /**
+     * Phase 2 (slow): AI metadata generation, git worktree, spec init, agent spawn.
+     * Updates the feature record with refined metadata, branch, and specPath.
+     */
+    async initializeAndSpawn(feature, input, shouldSpawn) {
+        const effectiveRepoPath = feature.repositoryPath;
+        // Ensure the target directory is a git repository (auto-init if needed)
+        await this.worktreeService.ensureGitRepository(effectiveRepoPath);
+        const metadata = await this.metadataGenerator.generateMetadata(input.userInput);
+        const originalSlug = metadata.slug;
+        const { slug, branch, warning } = await this.slugResolver.resolveUniqueSlug(originalSlug, effectiveRepoPath);
+        // Determine next feature number for this repo
+        const existingFeatures = await this.featureRepo.list({
+            repositoryPath: effectiveRepoPath,
+        });
+        const featureNumber = existingFeatures.length;
+        // Create git worktree branching from the repo's default branch
+        const defaultBranch = await this.gitPrService.getDefaultBranch(effectiveRepoPath);
+        const worktreePath = this.worktreeService.getWorktreePath(effectiveRepoPath, branch);
+        await this.worktreeService.create(effectiveRepoPath, branch, worktreePath, defaultBranch);
+        // Initialize spec directory — full user input goes into spec.yaml as-is
+        const { specDir } = await this.specInitializer.initialize(worktreePath, slug, featureNumber, input.userInput);
+        // Update feature record with refined metadata, branch, and specPath
+        const updatedFeature = {
+            ...feature,
+            name: metadata.name,
+            slug,
+            description: metadata.description,
+            branch,
+            specPath: specDir,
+            updatedAt: new Date(),
+        };
+        await this.featureRepo.update(updatedFeature);
+        // Spawn agent if not blocked
         if (shouldSpawn) {
-            this.agentProcess.spawn(feature.id, runId, effectiveRepoPath, specDir, worktreePath, {
+            const agentRun = await this.runRepository.findById(feature.agentRunId);
+            this.agentProcess.spawn(feature.id, feature.agentRunId, effectiveRepoPath, specDir, worktreePath, {
                 ...(input.approvalGates ? { approvalGates: input.approvalGates } : {}),
-                threadId: agentRun.threadId,
+                threadId: agentRun?.threadId ?? randomUUID(),
                 push: input.push ?? false,
                 openPr: input.openPr ?? false,
             });
         }
-        return { feature, warning };
+        return { warning, updatedFeature };
     }
 };
 CreateFeatureUseCase = __decorate([

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

@@ -7,9 +7,19 @@ export interface CreateFeatureInput {
     openPr?: boolean;
     /** Optional ID of the parent feature. When set, child may be created in Blocked state. */
     parentId?: string;
+    /** Pre-supplied name (skips AI metadata extraction for name). */
+    name?: string;
+    /** Pre-supplied description (skips AI metadata extraction for description). */
+    description?: string;
 }
 export interface CreateFeatureResult {
     feature: Feature;
     warning?: string;
 }
+/** Result of the fast createRecord phase (before metadata/worktree/agent). */
+export interface CreateRecordResult {
+    feature: Feature;
+    /** Whether the agent should be spawned (false when child is blocked). */
+    shouldSpawn: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

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,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAErF,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;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"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,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAErF,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;CACtB;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/resume-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resume-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/resume-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,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;AAQlG,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,qBACa,oBAAoB;IAG7B,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,mBAAmB,CAAC;CAgG/D"}
+{"version":3,"file":"resume-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/resume-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,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;AAQlG,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,qBACa,oBAAoB;IAG7B,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,mBAAmB,CAAC;CAiG/D"}

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

@@ -106,6 +106,7 @@ let ResumeFeatureUseCase = class ResumeFeatureUseCase {
             resumeFromInterrupt: lastRun.status === AgentRunStatus.waitingApproval,
             push: feature.push,
             openPr: feature.openPr,
+            agentType: lastRun.agentType,
         });
         return { feature, newRun };
     }

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

@@ -88,7 +88,7 @@ export function createDefaultSettings() {
     const notifications = {
         inApp: { enabled: true },
         browser: { enabled: true },
-        desktop: { enabled: true },
+        desktop: { enabled: false },
         events: {
             agentStarted: true,
             phaseCompleted: true,

package/dist/packages/core/src/infrastructure/services/agents/common/executors/dev-executor.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/dev-executor.service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AAqDpF,qBAAa,uBAAwB,YAAW,cAAc;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;;IAM3B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOvF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IAK3C,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;IAIhD,OAAO,CAAC,QAAQ;CAmEjB"}
+{"version":3,"file":"dev-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/dev-executor.service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AAmIpF,qBAAa,uBAAwB,YAAW,cAAc;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;;IAM3B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOvF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IAK3C,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;IAIhD,OAAO,CAAC,QAAQ;CAmEjB"}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/dev-executor.service.js

@@ -9,15 +9,90 @@ import { RESEARCH_FIXTURE } from './fixtures/research.fixture.js';
 import { PLAN_FIXTURE } from './fixtures/plan.fixture.js';
 import { TASKS_FIXTURE } from './fixtures/tasks.fixture.js';
 const DEFAULT_DELAY_MS = 2000;
-const METADATA_RESULT = JSON.stringify({
-    slug: 'dark-mode-toggle',
-    name: 'Dark Mode Toggle',
-    description: 'Add a dark-mode toggle to the Shep web UI settings panel',
-});
-// Satisfies merge-output-parser.ts COMMIT_SHA_RE and PR_URL_RE patterns
-const MERGE_COMMIT_RESULT = '[feat/042-dark-mode-toggle abc1234f] feat(ui): add dark-mode toggle\n' +
-    'https://github.com/shep-ai/shep/pull/42\nPull request #42 created successfully.';
-const MERGE_SQUASH_RESULT = 'Merged PR #42 with squash merge. Branch feat/042-dark-mode-toggle deleted.';
+const ADJECTIVES = [
+    'quantum',
+    'blazing',
+    'cosmic',
+    'fuzzy',
+    'turbo',
+    'hyperbolic',
+    'spectral',
+    'chromatic',
+    'orbital',
+    'fractal',
+    'velvet',
+    'neon',
+    'arctic',
+    'molten',
+    'prismatic',
+    'phantom',
+    'galactic',
+    'atomic',
+    'sonic',
+    'ethereal',
+];
+const NOUNS = [
+    'widget',
+    'pipeline',
+    'dashboard',
+    'renderer',
+    'compiler',
+    'beacon',
+    'transformer',
+    'navigator',
+    'interceptor',
+    'gateway',
+    'synthesizer',
+    'orchestrator',
+    'resolver',
+    'dispatcher',
+    'emitter',
+    'detector',
+    'aggregator',
+    'scheduler',
+    'validator',
+    'serializer',
+];
+const VERBS = [
+    'add',
+    'implement',
+    'integrate',
+    'build',
+    'create',
+    'wire up',
+    'introduce',
+    'scaffold',
+    'bootstrap',
+    'enable',
+];
+function randomMetadata() {
+    const adj = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+    const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+    const verb = VERBS[Math.floor(Math.random() * VERBS.length)];
+    const slug = `${adj}-${noun}`;
+    const name = `${adj.charAt(0).toUpperCase() + adj.slice(1)} ${noun.charAt(0).toUpperCase() + noun.slice(1)}`;
+    return JSON.stringify({
+        slug,
+        name,
+        description: `${verb.charAt(0).toUpperCase() + verb.slice(1)} a ${adj} ${noun} to the application`,
+    });
+}
+function randomPrNumber() {
+    return Math.floor(Math.random() * 900) + 100;
+}
+function randomCommitHash() {
+    return Math.random().toString(16).slice(2, 10);
+}
+function mergeCommitResult() {
+    const pr = randomPrNumber();
+    const hash = randomCommitHash();
+    return (`[feat/dev-branch ${hash}] feat: dev implementation\n` +
+        `https://github.com/shep-ai/shep/pull/${pr}\nPull request #${pr} created successfully.`);
+}
+function mergeSquashResult() {
+    const pr = randomPrNumber();
+    return `Merged PR #${pr} with squash merge. Branch feat/dev-branch deleted.`;
+}
 const IMPLEMENT_RESULT = 'Implementation complete. All tests pass.\npnpm test: 47 passed, 0 failed';
 const CI_FIX_RESULT = 'Fixed CI failure: corrected import path. All checks now passing.';
 /**
@@ -66,7 +141,7 @@ export class DevAgentExecutorService {
     dispatch(prompt) {
         // Metadata: mock-executor.service.ts extractUserInput pattern
         if (prompt.includes('User request:\n"'))
-            return METADATA_RESULT;
+            return randomMetadata();
         // Analyze: analyze.prompt.ts:39
         if (prompt.includes('Write your analysis to:')) {
             const specDir = extractSpecDir(prompt);
@@ -113,13 +188,13 @@ export class DevAgentExecutorService {
             return IMPLEMENT_RESULT;
         // Merge commit/push/PR: merge-prompts.ts:88
         if (prompt.includes('performing git operations in a feature worktree'))
-            return MERGE_COMMIT_RESULT;
+            return mergeCommitResult();
         // Merge squash (PR): merge-prompts.ts:131
         if (prompt.includes('merging a pull request via the GitHub CLI'))
-            return MERGE_SQUASH_RESULT;
+            return mergeSquashResult();
         // Merge squash (local): merge-prompts.ts:168
         if (prompt.includes('performing a local merge'))
-            return MERGE_SQUASH_RESULT;
+            return mergeSquashResult();
         // CI fix: merge.prompt.ts:28
         if (prompt.includes('fixing a CI failure'))
             return CI_FIX_RESULT;

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

@@ -71,7 +71,7 @@ export declare function createFeatureAgentGraph(depsOrExecutor: FeatureAgentGrap
     ciFixAttempts?: number | undefined;
     ciFixHistory?: import("../../../../domain/index.js").CiFixRecord[] | undefined;
     ciFixStatus?: "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted" | undefined;
-}, "__start__" | "analyze" | "requirements" | "research" | "plan" | "implement" | "validate_spec_analyze" | "validate_spec_requirements" | "validate_research" | "validate_plan_tasks" | "repair_spec_analyze" | "repair_spec_requirements" | "repair_research" | "repair_plan_tasks", {
+}, "implement" | "__start__" | "analyze" | "requirements" | "research" | "plan" | "validate_spec_analyze" | "validate_spec_requirements" | "validate_research" | "validate_plan_tasks" | "repair_spec_analyze" | "repair_spec_requirements" | "repair_research" | "repair_plan_tasks", {
     featureId: {
         (): import("@langchain/langgraph").LastValue<string>;
         (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.d.ts

@@ -7,7 +7,7 @@
  */
 import type { IFeatureAgentProcessService } from '../../../../application/ports/output/agents/feature-agent-process.interface.js';
 import type { IAgentRunRepository } from '../../../../application/ports/output/agents/agent-run-repository.interface.js';
-import { type ApprovalGates } from '../../../../domain/generated/output.js';
+import { type ApprovalGates, type AgentType } from '../../../../domain/generated/output.js';
 export declare class FeatureAgentProcessService implements IFeatureAgentProcessService {
     private readonly runRepository;
     constructor(runRepository: IAgentRunRepository);
@@ -19,6 +19,7 @@ export declare class FeatureAgentProcessService implements IFeatureAgentProcessS
         push?: boolean;
         openPr?: boolean;
         resumePayload?: string;
+        agentType?: AgentType;
     }): number;
     isAlive(pid: number): boolean;
     checkAndMarkCrashed(runId: string): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-process.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AACxH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qEAAqE,CAAC;AAC/G,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAYlF,qBAAa,0BAA2B,YAAW,2BAA2B;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,mBAAmB;IAE/D,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GACA,MAAM;IA0DT,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IASvB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAexD"}
+{"version":3,"file":"feature-agent-process.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AACxH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qEAAqE,CAAC;AAC/G,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAYlG,qBAAa,0BAA2B,YAAW,2BAA2B;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,mBAAmB;IAE/D,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GACA,MAAM;IA6DT,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IASvB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAexD"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.js

@@ -62,6 +62,9 @@ export class FeatureAgentProcessService {
         if (options?.resumePayload) {
             args.push('--resume-payload', options.resumePayload);
         }
+        if (options?.agentType) {
+            args.push('--agent-type', options.agentType);
+        }
         // Create log file for worker output (for debugging)
         const logsDir = join(homedir(), '.shep', 'logs');
         mkdirSync(logsDir, { recursive: true });

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

@@ -9,6 +9,7 @@
  * CLI Args: --feature-id <id> --run-id <id> --repo <path> --spec-dir <path>
  */
 import 'reflect-metadata';
+import { type AgentType } from '../../../../domain/generated/output.js';
 import type { ApprovalGates } from '../../../../domain/generated/output.js';
 export interface WorkerArgs {
     featureId: string;
@@ -23,6 +24,7 @@ export interface WorkerArgs {
     push?: boolean;
     openPr?: boolean;
     resumePayload?: string;
+    agentType?: AgentType;
 }
 /**
  * Parse CLI arguments into a WorkerArgs object.

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

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-worker.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,kBAAkB,CAAC;AAqB1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAoD1D;AAgCD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0M/D"}
+{"version":3,"file":"feature-agent-worker.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,kBAAkB,CAAC;AAa1B,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2D1D;AAgCD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiN/D"}

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

@@ -53,6 +53,10 @@ export function parseWorkerArgs(args) {
     const openPr = args.includes('--open-pr');
     const threadIdx = args.indexOf('--thread-id');
     const threadId = threadIdx !== -1 && threadIdx + 1 < args.length ? args[threadIdx + 1] : undefined;
+    const agentTypeIdx = args.indexOf('--agent-type');
+    const agentType = agentTypeIdx !== -1 && agentTypeIdx + 1 < args.length
+        ? args[agentTypeIdx + 1]
+        : undefined;
     const resumePayloadIdx = args.indexOf('--resume-payload');
     const resumePayload = resumePayloadIdx !== -1 && resumePayloadIdx + 1 < args.length
         ? args[resumePayloadIdx + 1]
@@ -70,6 +74,7 @@ export function parseWorkerArgs(args) {
         push,
         openPr,
         resumePayload,
+        agentType,
     };
 }
 /** Simple worker logger — writes to stdout which is redirected to log file by the parent. */
@@ -119,9 +124,17 @@ export async function runWorker(args) {
     initializeSettings(settings);
     const runRepository = container.resolve('IAgentRunRepository');
     const executorProvider = container.resolve('IAgentExecutorProvider');
-    // Create executor from configured agent settings
-    log('Creating executor from configured agent settings...');
-    const executor = executorProvider.getExecutor();
+    // Create executor — use pinned agentType when resuming, otherwise fall back to settings
+    let executor;
+    if (args.agentType) {
+        log(`Creating executor from pinned agent type: ${args.agentType}`);
+        const factory = container.resolve('IAgentExecutorFactory');
+        executor = factory.createExecutor(args.agentType, settings.agent);
+    }
+    else {
+        log('Creating executor from configured agent settings...');
+        executor = executorProvider.getExecutor();
+    }
     // Resolve merge node dependencies
     const gitPrService = container.resolve('IGitPrService');
     const featureRepository = container.resolve('IFeatureRepository');

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

@@ -1 +1 @@
-{"version":3,"file":"merge.node.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/merge/merge.node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yEAAyE,CAAC;AAClH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACd,MAAM,iEAAiE,CAAC;AAmBzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;IACnE;;;OAGG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,YAAY,EAAE,aAAa,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,IAGnC,OAAO,iBAAiB,KAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAkQ7E"}
+{"version":3,"file":"merge.node.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/merge/merge.node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yEAAyE,CAAC;AAClH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACd,MAAM,iEAAiE,CAAC;AAmBzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;IACnE;;;OAGG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,YAAY,EAAE,aAAa,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,IAGnC,OAAO,iBAAiB,KAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAsQ7E"}

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

@@ -36,9 +36,13 @@ export function createMergeNode(deps) {
         // --- Rejection detection on resume ---
         // Use DB lifecycle (Review) instead of feature.yaml completedPhases to detect
         // resume, because feature.yaml is in the worktree which was already pushed.
+        // Also require _approvalAction to be set — this distinguishes a genuine resume
+        // (where the worker sets _approvalAction via Command({update})) from a first run
+        // where updateNodeLifecycle('merge') already set lifecycle=Review in the DB.
         const featureForResume = await deps.featureRepository.findById(state.featureId);
         const isResumeAfterInterrupt = featureForResume?.lifecycle === SdlcLifecycle.Review &&
-            shouldInterrupt('merge', state.approvalGates);
+            shouldInterrupt('merge', state.approvalGates) &&
+            state._approvalAction !== null;
         if (isResumeAfterInterrupt && state._approvalAction === 'rejected') {
             const feedback = state._rejectionFeedback ?? '(no feedback)';
             log.info(`Merge rejected with feedback: "${feedback}" — scheduling re-execution`);

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;AAEpE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,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;CACnB;AAqBD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkChD"}
+{"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;AAEpE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,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;CACnB;AAqBD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2DhD"}