@shepai/cli 1.19.0 → 1.20.1

package/dist/eslint.config.mjs

@@ -28,11 +28,14 @@ export default tseslint.config(
         // Build outputs
         'dist/**',
         'build/**',
+        'web/**',
         '**/.next/**',
         'out/**',
         '**/storybook-static/**',
         // Dependencies
         'node_modules/**',
+        // Git worktrees (parallel development checkouts)
+        '.worktrees/**',
         // Generated files
         'apis/**',
         '*.generated.*',
@@ -50,6 +53,7 @@ export default tseslint.config(
         '*.config.js',
         '*.config.mjs',
         '*.config.cjs',
+        '*.config.ts',
     ],
 }, 
 // =============================================================================

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

@@ -9,6 +9,7 @@
  * - Application layer depends on this interface
  * - Infrastructure layer provides concrete implementation
  */
+import type { ApprovalGates } from '../../../../domain/generated/output.js';
 /**
  * Service interface for feature agent background process management.
  */
@@ -23,7 +24,7 @@ export interface IFeatureAgentProcessService {
      * @returns The PID of the spawned process
      */
     spawn(featureId: string, runId: string, repoPath: string, specDir: string, worktreePath?: string, options?: {
-        approvalMode?: string;
+        approvalGates?: ApprovalGates;
         resume?: boolean;
         threadId?: string;
         resumeFromInterrupt?: boolean;

package/dist/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":["../../../../../../src/application/ports/output/agents/feature-agent-process.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;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,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,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":["../../../../../../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;KAC/B,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/src/application/ports/output/agents/index.d.ts

@@ -9,6 +9,7 @@ export type { IAgentExecutorProvider } from './agent-executor-provider.interface
 export type { IAgentRegistry, AgentDefinitionWithFactory } from './agent-registry.interface.js';
 export type { IAgentRunner, AgentRunOptions } from './agent-runner.interface.js';
 export type { IAgentRunRepository } from './agent-run-repository.interface.js';
+export type { IPhaseTimingRepository } from './phase-timing-repository.interface.js';
 export type { IAgentValidator, AgentValidationResult } from './agent-validator.interface.js';
 export type { IFeatureAgentProcessService } from './feature-agent-process.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/application/ports/output/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/src/application/ports/output/agents/phase-timing-repository.interface.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Phase Timing Repository Interface
+ *
+ * Output port for PhaseTiming persistence operations.
+ * Records timing data for each agent graph node execution.
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+import type { PhaseTiming } from '../../../../domain/generated/output.js';
+/**
+ * Repository interface for PhaseTiming entity persistence.
+ */
+export interface IPhaseTimingRepository {
+    /**
+     * Save a new phase timing record.
+     *
+     * @param phaseTiming - The phase timing to persist
+     */
+    save(phaseTiming: PhaseTiming): Promise<void>;
+    /**
+     * Update a phase timing record (typically to set completedAt and durationMs).
+     *
+     * @param id - The phase timing ID
+     * @param updates - Fields to update
+     */
+    update(id: string, updates: Partial<Pick<PhaseTiming, 'completedAt' | 'durationMs'>>): Promise<void>;
+    /**
+     * Find all phase timings for an agent run.
+     *
+     * @param agentRunId - The agent run ID
+     * @returns Array of phase timings ordered by creation
+     */
+    findByRunId(agentRunId: string): Promise<PhaseTiming[]>;
+    /**
+     * Find all phase timings for a feature (via agent_runs join).
+     *
+     * @param featureId - The feature ID
+     * @returns Array of phase timings ordered by creation
+     */
+    findByFeatureId(featureId: string): Promise<PhaseTiming[]>;
+}
+//# sourceMappingURL=phase-timing-repository.interface.d.ts.map

package/dist/src/application/ports/output/agents/phase-timing-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-timing-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/agents/phase-timing-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC,GAChE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAExD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC5D"}

package/dist/src/application/ports/output/agents/phase-timing-repository.interface.js

@@ -0,0 +1,11 @@
+/**
+ * Phase Timing Repository Interface
+ *
+ * Output port for PhaseTiming persistence operations.
+ * Records timing data for each agent graph node execution.
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+export {};

package/dist/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":["../../../../../src/application/use-cases/agents/approve-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,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,eAAe;gBANf,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,2BAA2B,EAE3C,iBAAiB,EAAE,kBAAkB,EAErC,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAsC1E"}
+{"version":3,"file":"approve-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/approve-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,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,eAAe;gBANf,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,2BAA2B,EAE3C,iBAAiB,EAAE,kBAAkB,EAErC,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CA0C1E"}

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

@@ -48,11 +48,15 @@ let ApproveAgentRunUseCase = class ApproveAgentRunUseCase {
             : repoPath;
         const now = new Date();
         await this.agentRunRepository.updateStatus(id, AgentRunStatus.running, {
-            approvalStatus: 'approved',
             updatedAt: now,
         });
         this.processService.spawn(run.featureId ?? '', id, repoPath, worktreePath, // specDir = worktree path (same as initial spawn)
-        worktreePath, { resume: true, approvalMode: run.approvalMode });
+        worktreePath, {
+            resume: true,
+            approvalGates: run.approvalGates,
+            threadId: run.threadId,
+            resumeFromInterrupt: true,
+        });
         return { approved: true, reason: 'Approved and resumed' };
     }
 };

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

@@ -1 +1 @@
-{"version":3,"file":"reject-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/reject-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAGvG,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAGpD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAuB3F"}
+{"version":3,"file":"reject-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/agents/reject-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAGvG,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAGpD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAsB3F"}

package/dist/src/application/use-cases/agents/reject-agent-run.use-case.js

@@ -36,7 +36,6 @@ let RejectAgentRunUseCase = class RejectAgentRunUseCase {
         }
         const now = new Date();
         await this.agentRunRepository.updateStatus(id, AgentRunStatus.cancelled, {
-            approvalStatus: 'rejected',
             error: reason ?? 'Rejected by user',
             completedAt: now,
             updatedAt: now,

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

@@ -0,0 +1,37 @@
+/**
+ * Create Feature Use Case
+ *
+ * Creates a new feature entity with a git worktree for isolated development,
+ * initializes the spec directory with YAML templates, then spawns the
+ * feature agent to begin autonomous SDLC processing.
+ *
+ * Business Rules:
+ * - Metadata generation delegated to MetadataGenerator service
+ * - Slug uniqueness delegated to SlugResolver service
+ * - Full user input is preserved as-is in spec.yaml
+ * - A git worktree is created at ~/.shep/repos/HASH/wt/SLUG/
+ * - Spec YAML files are scaffolded at WORKTREE/specs/NNN-SLUG/
+ * - Feature agent is spawned with the spec dir path
+ * - specPath is persisted on the Feature record
+ * - Initial lifecycle is Requirements
+ */
+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';
+import type { IAgentRunRepository } from '../../../ports/output/agents/agent-run-repository.interface.js';
+import type { ISpecInitializerService } from '../../../ports/output/services/spec-initializer.interface.js';
+import { MetadataGenerator } from './metadata-generator.js';
+import { SlugResolver } from './slug-resolver.js';
+import type { CreateFeatureInput, CreateFeatureResult } from './types.js';
+export declare class CreateFeatureUseCase {
+    private readonly featureRepo;
+    private readonly worktreeService;
+    private readonly agentProcess;
+    private readonly runRepository;
+    private readonly specInitializer;
+    private readonly metadataGenerator;
+    private readonly slugResolver;
+    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, metadataGenerator: MetadataGenerator, slugResolver: SlugResolver);
+    execute(input: CreateFeatureInput): Promise<CreateFeatureResult>;
+}
+//# sourceMappingURL=create-feature.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../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;AAE5G,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;gBAZZ,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;IAGvC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAyEvE"}

package/dist/src/application/use-cases/features/{create-feature.use-case.js → create/create-feature.use-case.js}

@@ -6,10 +6,9 @@
  * feature agent to begin autonomous SDLC processing.
  *
  * Business Rules:
- * - AI generates slug/name/description from user's free-text input
- * - Falls back to regex-based slug if AI fails
+ * - Metadata generation delegated to MetadataGenerator service
+ * - Slug uniqueness delegated to SlugResolver service
  * - Full user input is preserved as-is in spec.yaml
- * - Slug must be unique within the repository
  * - A git worktree is created at ~/.shep/repos/HASH/wt/SLUG/
  * - Spec YAML files are scaffolded at WORKTREE/specs/NNN-SLUG/
  * - Feature agent is spawned with the spec dir path
@@ -30,34 +29,32 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from 'tsyringe';
 import { randomUUID } from 'node:crypto';
-import { SdlcLifecycle } from '../../../domain/generated/output.js';
-import { AgentRunStatus } from '../../../domain/generated/output.js';
-import { getSettings } from '../../../infrastructure/services/settings.service.js';
-/** Maximum characters of user input sent to the AI for metadata generation. */
-const MAX_INPUT_FOR_AI = 500;
+import { SdlcLifecycle, AgentRunStatus } from '../../../../domain/generated/output.js';
+import { getSettings } from '../../../../infrastructure/services/settings.service.js';
+import { MetadataGenerator } from './metadata-generator.js';
+import { SlugResolver } from './slug-resolver.js';
 let CreateFeatureUseCase = class CreateFeatureUseCase {
     featureRepo;
     worktreeService;
     agentProcess;
     runRepository;
     specInitializer;
-    executorProvider;
-    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, executorProvider) {
+    metadataGenerator;
+    slugResolver;
+    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, metadataGenerator, slugResolver) {
         this.featureRepo = featureRepo;
         this.worktreeService = worktreeService;
         this.agentProcess = agentProcess;
         this.runRepository = runRepository;
         this.specInitializer = specInitializer;
-        this.executorProvider = executorProvider;
+        this.metadataGenerator = metadataGenerator;
+        this.slugResolver = slugResolver;
     }
     async execute(input) {
-        const metadata = await this.generateMetadata(input.userInput);
-        const slug = metadata.slug;
-        const branch = `feat/${slug}`;
-        const existing = await this.featureRepo.findBySlug(slug, input.repositoryPath);
-        if (existing) {
-            throw new Error(`Feature with slug "${slug}" already exists in this repository`);
-        }
+        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, input.repositoryPath);
         // Determine next feature number for this repo
         const existingFeatures = await this.featureRepo.list({
             repositoryPath: input.repositoryPath,
@@ -97,63 +94,16 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             threadId: randomUUID(),
             featureId: feature.id,
             repositoryPath: input.repositoryPath,
-            ...(input.approvalMode ? { approvalMode: input.approvalMode } : {}),
+            ...(input.approvalGates ? { approvalGates: input.approvalGates } : {}),
             createdAt: now.toISOString(),
             updatedAt: now.toISOString(),
         };
         await this.runRepository.create(agentRun);
         this.agentProcess.spawn(feature.id, runId, input.repositoryPath, specDir, worktreePath, {
-            ...(input.approvalMode ? { approvalMode: input.approvalMode } : {}),
+            ...(input.approvalGates ? { approvalGates: input.approvalGates } : {}),
             threadId: agentRun.threadId,
         });
-        return feature;
-    }
-    async generateMetadata(userInput) {
-        try {
-            const executor = this.executorProvider.getExecutor();
-            const truncated = userInput.length > MAX_INPUT_FOR_AI
-                ? `${userInput.slice(0, MAX_INPUT_FOR_AI)}...`
-                : userInput;
-            const prompt = `Generate feature metadata from this user request:
-"${truncated}"
-
-Return ONLY a JSON object with these fields:
-- slug: kebab-case identifier, 2-4 words max (e.g., "github-oauth-login")
-- name: short human-readable title (e.g., "GitHub OAuth Login")
-- description: refined 1-2 sentence description
-
-JSON only, no markdown fences.`;
-            const result = await executor.execute(prompt, {
-                maxTurns: 1,
-                allowedTools: [],
-                silent: true,
-            });
-            const parsed = JSON.parse(result.result);
-            if (!parsed.slug || !parsed.name || !parsed.description) {
-                throw new Error('Missing required fields in AI response');
-            }
-            return {
-                slug: this.toSlug(parsed.slug),
-                name: parsed.name,
-                description: parsed.description,
-            };
-        }
-        catch {
-            // Fallback to regex-based slug generation
-            return {
-                slug: this.toSlug(userInput),
-                name: userInput,
-                description: userInput,
-            };
-        }
-    }
-    toSlug(text) {
-        return text
-            .toLowerCase()
-            .replace(/[^a-z0-9\s-]/g, '')
-            .replace(/\s+/g, '-')
-            .replace(/-+/g, '-')
-            .replace(/^-|-$/g, '');
+        return { feature, warning };
     }
 };
 CreateFeatureUseCase = __decorate([
@@ -163,7 +113,9 @@ CreateFeatureUseCase = __decorate([
     __param(2, inject('IFeatureAgentProcessService')),
     __param(3, inject('IAgentRunRepository')),
     __param(4, inject('ISpecInitializerService')),
-    __param(5, inject('IAgentExecutorProvider')),
-    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, Object])
+    __param(5, inject(MetadataGenerator)),
+    __param(6, inject(SlugResolver)),
+    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, MetadataGenerator,
+        SlugResolver])
 ], CreateFeatureUseCase);
 export { CreateFeatureUseCase };

package/dist/src/application/use-cases/features/create/metadata-generator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * MetadataGenerator
+ *
+ * Generates feature metadata (slug, name, description) from user input
+ * via AI call through IAgentExecutorProvider.
+ * Errors are propagated to the caller.
+ */
+import type { IAgentExecutorProvider } from '../../../ports/output/agents/agent-executor-provider.interface.js';
+import type { FeatureMetadata } from './types.js';
+export declare class MetadataGenerator {
+    private readonly executorProvider;
+    constructor(executorProvider: IAgentExecutorProvider);
+    /**
+     * Generate feature metadata from user input via AI.
+     * Errors are propagated to the caller.
+     */
+    generateMetadata(userInput: string): Promise<FeatureMetadata>;
+    /**
+     * Strip markdown code fence wrappers (```lang ... ```) if present at start/end.
+     */
+    private stripCodeFence;
+    /**
+     * Convert text to kebab-case slug with 50-char limit.
+     * Removes special characters, collapses spaces, limits length.
+     */
+    private toSlug;
+}
+//# sourceMappingURL=metadata-generator.d.ts.map

package/dist/src/application/use-cases/features/create/metadata-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-generator.d.ts","sourceRoot":"","sources":["../../../../../../src/application/use-cases/features/create/metadata-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mEAAmE,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAG3D;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAyCnE;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf"}

package/dist/src/application/use-cases/features/create/metadata-generator.js

@@ -0,0 +1,109 @@
+/**
+ * MetadataGenerator
+ *
+ * Generates feature metadata (slug, name, description) from user input
+ * via AI call through IAgentExecutorProvider.
+ * Errors are propagated to the caller.
+ */
+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';
+/** Maximum characters of user input sent to the AI for metadata generation. */
+const MAX_INPUT_FOR_AI = 500;
+let MetadataGenerator = class MetadataGenerator {
+    executorProvider;
+    constructor(executorProvider) {
+        this.executorProvider = executorProvider;
+    }
+    /**
+     * Generate feature metadata from user input via AI.
+     * Errors are propagated to the caller.
+     */
+    async generateMetadata(userInput) {
+        const executor = this.executorProvider.getExecutor();
+        const truncated = userInput.length > MAX_INPUT_FOR_AI
+            ? `${userInput.slice(0, MAX_INPUT_FOR_AI)}...`
+            : userInput;
+        const prompt = `Analyze this user request and extract the CORE feature intent. Condense to essential concepts.
+
+User request:
+"${truncated}"
+
+IMPORTANT: Don't use the request as-is. Extract the key feature being requested and improve the wording.
+
+Return ONLY a JSON object with these fields:
+- slug: kebab-case identifier, 2-4 words MAX. Extract the core feature name (e.g., "github-oauth-login" from "add github oauth")
+- name: polished, professional title (improve upon user's wording)
+- description: refined 1-2 sentence description that captures the feature essence (not the request verbatim)
+
+JSON only, no markdown fences.`;
+        const result = await executor.execute(prompt, {
+            maxTurns: 1,
+            allowedTools: [],
+            silent: true,
+        });
+        const cleaned = this.stripCodeFence(result.result);
+        const parsed = JSON.parse(cleaned);
+        if (!parsed.slug || !parsed.name || !parsed.description) {
+            throw new Error('Missing required fields in AI response');
+        }
+        return {
+            slug: this.toSlug(parsed.slug),
+            name: parsed.name,
+            description: parsed.description,
+        };
+    }
+    /**
+     * Strip markdown code fence wrappers (```lang ... ```) if present at start/end.
+     */
+    stripCodeFence(text) {
+        const trimmed = text.trim();
+        if (!trimmed.startsWith('```')) {
+            return trimmed;
+        }
+        // Find end of first line (```json or ```anything)
+        const firstNewline = trimmed.indexOf('\n');
+        if (firstNewline === -1) {
+            return trimmed;
+        }
+        if (!trimmed.endsWith('```')) {
+            return trimmed;
+        }
+        return trimmed.slice(firstNewline + 1, trimmed.length - 3).trim();
+    }
+    /**
+     * Convert text to kebab-case slug with 50-char limit.
+     * Removes special characters, collapses spaces, limits length.
+     */
+    toSlug(text) {
+        const slug = text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-|-$/g, '');
+        // Limit to ~50 chars, cutting at a word boundary
+        if (slug.length <= 50) {
+            return slug;
+        }
+        const truncated = slug.slice(0, 50);
+        const lastDash = truncated.lastIndexOf('-');
+        return lastDash > 10 ? truncated.slice(0, lastDash) : truncated;
+    }
+};
+MetadataGenerator = __decorate([
+    injectable(),
+    __param(0, inject('IAgentExecutorProvider')),
+    __metadata("design:paramtypes", [Object])
+], MetadataGenerator);
+export { MetadataGenerator };

package/dist/src/application/use-cases/features/create/slug-resolver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SlugResolver
+ *
+ * Resolves unique slugs by checking against database and git branches.
+ * Ensures no slug collision by appending numeric suffixes (-2, -3, etc.)
+ */
+import type { IFeatureRepository } from '../../../ports/output/repositories/feature-repository.interface.js';
+import type { IWorktreeService } from '../../../ports/output/services/worktree-service.interface.js';
+export interface SlugResolutionResult {
+    slug: string;
+    branch: string;
+    warning?: string;
+}
+export declare class SlugResolver {
+    private readonly featureRepo;
+    private readonly worktreeService;
+    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService);
+    /**
+     * Find a unique slug by checking both the feature DB and git branches.
+     * If the original slug conflicts, appends -2, -3, etc. until a free one is found.
+     */
+    resolveUniqueSlug(originalSlug: string, repositoryPath: string): Promise<SlugResolutionResult>;
+}
+//# sourceMappingURL=slug-resolver.d.ts.map

package/dist/src/application/use-cases/features/create/slug-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/application/use-cases/features/create/slug-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AAKrG,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,YAAY;IAGrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAFf,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB;IAGpD;;;OAGG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,oBAAoB,CAAC;CA+BjC"}

package/dist/src/application/use-cases/features/create/slug-resolver.js

@@ -0,0 +1,66 @@
+/**
+ * SlugResolver
+ *
+ * Resolves unique slugs by checking against database and git branches.
+ * Ensures no slug collision by appending numeric suffixes (-2, -3, etc.)
+ */
+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';
+/** Maximum number of suffix attempts before giving up */
+const MAX_SUFFIX = 10;
+let SlugResolver = class SlugResolver {
+    featureRepo;
+    worktreeService;
+    constructor(featureRepo, worktreeService) {
+        this.featureRepo = featureRepo;
+        this.worktreeService = worktreeService;
+    }
+    /**
+     * Find a unique slug by checking both the feature DB and git branches.
+     * If the original slug conflicts, appends -2, -3, etc. until a free one is found.
+     */
+    async resolveUniqueSlug(originalSlug, repositoryPath) {
+        for (let suffix = 0; suffix <= MAX_SUFFIX; suffix++) {
+            const slug = suffix === 0 ? originalSlug : `${originalSlug}-${suffix + 1}`;
+            const branch = `feat/${slug}`;
+            // Check if a feature with this slug already exists in the DB
+            const existing = await this.featureRepo.findBySlug(slug, repositoryPath);
+            if (existing) {
+                if (suffix === 0)
+                    continue; // try suffixed version
+                continue;
+            }
+            // Check if the git branch already exists (leftover from deleted feature)
+            const branchInUse = await this.worktreeService.exists(repositoryPath, branch);
+            if (branchInUse)
+                continue;
+            if (suffix > 0) {
+                return {
+                    slug,
+                    branch,
+                    warning: `Branch "feat/${originalSlug}" already exists, using "${branch}" instead`,
+                };
+            }
+            return { slug, branch };
+        }
+        throw new Error(`Could not find a unique slug for "${originalSlug}" after ${MAX_SUFFIX} attempts`);
+    }
+};
+SlugResolver = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IWorktreeService')),
+    __metadata("design:paramtypes", [Object, Object])
+], SlugResolver);
+export { SlugResolver };

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

@@ -0,0 +1,16 @@
+import type { ApprovalGates, Feature } from '../../../../domain/generated/output.js';
+export interface CreateFeatureInput {
+    userInput: string;
+    repositoryPath: string;
+    approvalGates?: ApprovalGates;
+}
+export interface CreateFeatureResult {
+    feature: Feature;
+    warning?: string;
+}
+export interface FeatureMetadata {
+    slug: string;
+    name: string;
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../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;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/src/application/use-cases/features/create/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -72,7 +72,7 @@ let ResumeFeatureUseCase = class ResumeFeatureUseCase {
             threadId: lastRun.threadId, // Same thread for checkpoint continuity
             featureId: feature.id,
             repositoryPath: feature.repositoryPath,
-            approvalMode: lastRun.approvalMode,
+            approvalGates: lastRun.approvalGates,
             createdAt: now,
             updatedAt: now,
         };
@@ -87,7 +87,7 @@ let ResumeFeatureUseCase = class ResumeFeatureUseCase {
         const worktreePath = this.worktreeService.getWorktreePath(feature.repositoryPath, feature.branch);
         this.processService.spawn(feature.id, newRunId, feature.repositoryPath, worktreePath, worktreePath, {
             resume: true,
-            approvalMode: lastRun.approvalMode,
+            approvalGates: lastRun.approvalGates,
             threadId: lastRun.threadId,
             resumeFromInterrupt: lastRun.status === AgentRunStatus.waitingApproval,
         });