@shepai/cli 1.169.1 → 1.170.0-pr513.cff27cb

package/dist/packages/core/src/infrastructure/services/skill-injector.service.js

@@ -0,0 +1,201 @@
+/**
+ * Skill Injector Service Implementation
+ *
+ * Injects curated agent skills into worktrees during feature creation.
+ * Handles local skill copying via fs.cp, remote skill installation via npx,
+ * SKILL.md idempotency checks, and .gitignore management.
+ *
+ * Uses constructor-injected ExecFunction for process execution (npx, git)
+ * and direct fs/promises imports for filesystem operations, following
+ * the established codebase conventions.
+ */
+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 { access, cp, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { injectable, inject } from 'tsyringe';
+import { SkillSourceType } from '../../domain/generated/output.js';
+const SKILLS_DIR = '.claude/skills';
+const SKILL_MARKER = 'SKILL.md';
+const REMOTE_SKILL_TIMEOUT_MS = 30_000;
+/** Shell metacharacters that must not appear in skill source strings */
+const SHELL_METACHAR_PATTERN = /[;|&$`\\(){}< >]/;
+/** Patterns that indicate path traversal in skill names */
+const PATH_TRAVERSAL_PATTERN = /\.\./;
+let SkillInjectorService = class SkillInjectorService {
+    execFile;
+    constructor(execFile) {
+        this.execFile = execFile;
+    }
+    async inject(worktreePath, config, repoRoot) {
+        // Validate worktree path exists
+        await access(worktreePath);
+        const result = {
+            injected: [],
+            skipped: [],
+            failed: [],
+        };
+        if (!config.skills.length) {
+            return result;
+        }
+        // Bootstrap .claude/skills/ directory
+        const skillsDir = join(worktreePath, SKILLS_DIR);
+        await mkdir(skillsDir, { recursive: true });
+        // Process each skill
+        for (const skill of config.skills) {
+            // Validate skill name and source
+            const validationError = this.validateSkill(skill);
+            if (validationError) {
+                result.failed.push({ name: skill.name, error: validationError });
+                continue;
+            }
+            // Idempotency check: skip if SKILL.md already exists
+            if (await this.isSkillPresent(worktreePath, skill.name)) {
+                result.skipped.push(skill.name);
+                continue;
+            }
+            // Inject based on type
+            if (skill.type === SkillSourceType.Local) {
+                await this.injectLocalSkill(worktreePath, skill, repoRoot, result);
+            }
+            else {
+                await this.injectRemoteSkill(worktreePath, skill, result);
+            }
+        }
+        // Update .gitignore for injected and skipped untracked skills
+        const allSkillNames = [...result.injected, ...result.skipped];
+        await this.updateGitignore(worktreePath, allSkillNames);
+        return result;
+    }
+    validateSkill(skill) {
+        // Validate skill name
+        if (PATH_TRAVERSAL_PATTERN.test(skill.name)) {
+            return `invalid skill name '${skill.name}': contains path traversal`;
+        }
+        if (skill.name.startsWith('/')) {
+            return `invalid skill name '${skill.name}': absolute path not allowed`;
+        }
+        if (skill.name.includes('\\')) {
+            return `invalid skill name '${skill.name}': backslash not allowed`;
+        }
+        // Validate source for remote skills (shell injection prevention)
+        if (skill.type === SkillSourceType.Remote && SHELL_METACHAR_PATTERN.test(skill.source)) {
+            return `invalid source '${skill.source}': contains shell metacharacters`;
+        }
+        return undefined;
+    }
+    async isSkillPresent(worktreePath, skillName) {
+        try {
+            await access(join(worktreePath, SKILLS_DIR, skillName, SKILL_MARKER));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async injectLocalSkill(worktreePath, skill, repoRoot, result) {
+        const sourcePath = repoRoot ? join(repoRoot, skill.source) : skill.source;
+        const destPath = join(worktreePath, SKILLS_DIR, skill.name);
+        try {
+            await cp(sourcePath, destPath, { recursive: true });
+            result.injected.push(skill.name);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            result.failed.push({ name: skill.name, error: message });
+        }
+    }
+    async injectRemoteSkill(worktreePath, skill, result) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), REMOTE_SKILL_TIMEOUT_MS);
+        try {
+            const args = ['skills', 'add', skill.source, '--yes'];
+            if (skill.remoteSkillName) {
+                args.push('--skill', skill.remoteSkillName);
+            }
+            await this.execFile('npx', args, {
+                cwd: worktreePath,
+                signal: controller.signal,
+            });
+            result.injected.push(skill.name);
+        }
+        catch (error) {
+            const isTimeout = error instanceof Error && error.name === 'AbortError';
+            const message = isTimeout
+                ? `timeout: remote skill installation exceeded ${REMOTE_SKILL_TIMEOUT_MS / 1000}s`
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            result.failed.push({ name: skill.name, error: message });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async isTrackedInGit(worktreePath, skillName) {
+        try {
+            await this.execFile('git', ['ls-files', '--error-unmatch', `${SKILLS_DIR}/${skillName}/`], {
+                cwd: worktreePath,
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async updateGitignore(worktreePath, skillNames) {
+        if (!skillNames.length)
+            return;
+        // Determine which skills need .gitignore entries (untracked only)
+        const untrackedSkills = [];
+        for (const name of skillNames) {
+            if (!(await this.isTrackedInGit(worktreePath, name))) {
+                untrackedSkills.push(name);
+            }
+        }
+        if (!untrackedSkills.length)
+            return;
+        const gitignorePath = join(worktreePath, '.gitignore');
+        // Read existing .gitignore (or start with empty string)
+        let existingContent = '';
+        try {
+            const content = await readFile(gitignorePath, 'utf-8');
+            existingContent = typeof content === 'string' ? content : '';
+        }
+        catch {
+            // File doesn't exist — will create it
+        }
+        // Determine which entries are new
+        const existingLines = new Set(existingContent.split('\n').map((line) => line.trim()));
+        const newEntries = [];
+        for (const name of untrackedSkills) {
+            const pattern = `${SKILLS_DIR}/${name}/`;
+            if (!existingLines.has(pattern)) {
+                newEntries.push(pattern);
+            }
+        }
+        if (!newEntries.length)
+            return;
+        // Append new entries, ensuring trailing newline
+        const needsNewline = existingContent.length > 0 && !existingContent.endsWith('\n');
+        const separator = needsNewline ? '\n' : '';
+        const updatedContent = `${existingContent + separator + newEntries.join('\n')}\n`;
+        await writeFile(gitignorePath, updatedContent);
+    }
+};
+SkillInjectorService = __decorate([
+    injectable(),
+    __param(0, inject('ExecFunction')),
+    __metadata("design:paramtypes", [Function])
+], SkillInjectorService);
+export { SkillInjectorService };

package/dist/packages/core/src/infrastructure/services/spec/spec-initializer.service.d.ts

@@ -7,7 +7,7 @@
  */
 import type { ISpecInitializerService, SpecInitializerResult } from '../../../application/ports/output/services/spec-initializer.interface.js';
 export declare class SpecInitializerService implements ISpecInitializerService {
-    initialize(basePath: string, slug: string, featureNumber: number, description: string, mode?: 'fast'): Promise<SpecInitializerResult>;
+    initialize(basePath: string, slug: string, featureNumber: number, description: string, mode?: 'fast' | 'exploration'): Promise<SpecInitializerResult>;
     /**
      * Scan specs/ for existing NNN-* directories and return the next available number.
      * Uses the DB-derived hint as a minimum, but always respects filesystem state.

package/dist/packages/core/src/infrastructure/services/spec/spec-initializer.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-initializer.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/spec/spec-initializer.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,mEAAmE,CAAC;AA8P3E,qBAAa,sBAAuB,YAAW,uBAAuB;IAC9D,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC;IAqCjC;;;OAGG;YACW,iBAAiB;CAoBhC"}
+{"version":3,"file":"spec-initializer.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/spec/spec-initializer.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,mEAAmE,CAAC;AA8P3E,qBAAa,sBAAuB,YAAW,uBAAuB;IAC9D,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAwCjC;;;OAGG;YACW,iBAAiB;CAoBhC"}

package/dist/packages/core/src/infrastructure/services/spec/spec-initializer.service.js

@@ -254,10 +254,13 @@ export class SpecInitializerService {
         const timestamp = now.toISOString().replace(/\.\d{3}Z$/, 'Z');
         const vars = { nnn, slug, featureNumber: resolvedNumber, date, timestamp, description };
         // In fast mode, write feature.yaml + spec.yaml (spec.yaml stores the user query
-        // which the fast-implement node reads; no research/plan/tasks needed)
-        const templates = mode === 'fast'
-            ? TEMPLATES.filter(({ filename }) => filename === 'feature.yaml' || filename === 'spec.yaml')
-            : TEMPLATES;
+        // which the fast-implement node reads; no research/plan/tasks needed).
+        // In exploration mode, write only feature.yaml (no SDLC spec artifacts).
+        const templates = mode === 'exploration'
+            ? TEMPLATES.filter(({ filename }) => filename === 'feature.yaml')
+            : mode === 'fast'
+                ? TEMPLATES.filter(({ filename }) => filename === 'feature.yaml' || filename === 'spec.yaml')
+                : TEMPLATES;
         // Write template files
         await Promise.all(templates.map(({ filename, content }) => writeFile(join(specDir, filename), applyTemplate(content, vars), 'utf-8')));
         return { specDir, featureNumber: nnn };

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

@@ -0,0 +1,12 @@
+/**
+ * Feature Feedback Command
+ *
+ * Sends feedback on an exploration prototype to iterate on the design.
+ * Resumes the interrupted exploration agent graph with the provided feedback.
+ *
+ * Usage:
+ *   shep feat feedback <id> <feedback-text>
+ */
+import { Command } from 'commander';
+export declare function createFeedbackCommand(): Command;
+//# sourceMappingURL=feedback.command.d.ts.map

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * Feature Feedback Command
+ *
+ * Sends feedback on an exploration prototype to iterate on the design.
+ * Resumes the interrupted exploration agent graph with the provided feedback.
+ *
+ * Usage:
+ *   shep feat feedback <id> <feedback-text>
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { RejectAgentRunUseCase } from '../../../../../packages/core/src/application/use-cases/agents/reject-agent-run.use-case.js';
+import { FeatureMode, SdlcLifecycle } from '../../../../../packages/core/src/domain/generated/output.js';
+import { colors, messages } from '../../ui/index.js';
+import { getCliI18n } from '../../i18n.js';
+export function createFeedbackCommand() {
+    const t = getCliI18n().t;
+    return new Command('feedback')
+        .description(t('cli:commands.feat.feedback.description'))
+        .argument('<id>', t('cli:commands.feat.feedback.idArgument'))
+        .argument('<feedback>', t('cli:commands.feat.feedback.feedbackArgument'))
+        .action(async (featureId, feedback) => {
+        try {
+            const featureRepo = container.resolve('IFeatureRepository');
+            const runRepo = container.resolve('IAgentRunRepository');
+            const feature = (await featureRepo.findById(featureId)) ?? (await featureRepo.findByIdPrefix(featureId));
+            if (!feature) {
+                throw new Error(`Feature not found: ${featureId}`);
+            }
+            if (feature.mode !== FeatureMode.Exploration ||
+                feature.lifecycle !== SdlcLifecycle.Exploring) {
+                messages.error(t('cli:commands.feat.feedback.notExploration', {
+                    name: feature.name,
+                    mode: feature.mode,
+                    lifecycle: feature.lifecycle,
+                }));
+                process.exitCode = 1;
+                return;
+            }
+            if (!feature.agentRunId) {
+                throw new Error(`Feature "${feature.name}" has no agent run`);
+            }
+            const run = await runRepo.findById(feature.agentRunId);
+            if (!run) {
+                throw new Error(`Agent run not found: ${feature.agentRunId}`);
+            }
+            const rejectUseCase = container.resolve(RejectAgentRunUseCase);
+            const result = await rejectUseCase.execute(run.id, feedback);
+            if (!result.rejected) {
+                throw new Error(result.reason);
+            }
+            messages.newline();
+            messages.success(t('cli:commands.feat.feedback.feedbackSubmitted', { name: feature.name }));
+            console.log(`  ${colors.muted(t('cli:commands.feat.feedback.iterationLabel'))} ${result.iteration}`);
+            console.log(`  ${colors.muted(t('cli:commands.feat.feedback.agentLabel'))}     ${t('cli:commands.feat.feedback.agentIterating')}`);
+            messages.newline();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error(t('cli:commands.feat.feedback.failedToSubmit'), err);
+            process.exitCode = 1;
+        }
+    });
+}

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

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

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

@@ -24,6 +24,8 @@ import { createLogsCommand } from './logs.command.js';
 import { createAdoptCommand } from './adopt.command.js';
 import { createArchiveCommand } from './archive.command.js';
 import { createUnarchiveCommand } from './unarchive.command.js';
+import { createFeedbackCommand } from './feedback.command.js';
+import { createPromoteCommand } from './promote.command.js';
 /**
  * Create the feat command group
  */
@@ -42,5 +44,7 @@ export function createFeatCommand() {
         .addCommand(createLogsCommand())
         .addCommand(createAdoptCommand())
         .addCommand(createArchiveCommand())
-        .addCommand(createUnarchiveCommand());
+        .addCommand(createUnarchiveCommand())
+        .addCommand(createFeedbackCommand())
+        .addCommand(createPromoteCommand());
 }

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

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

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

@@ -15,7 +15,7 @@ import { existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
 import { CreateFeatureUseCase } from '../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.js';
-import { SdlcLifecycle } from '../../../../../packages/core/src/domain/generated/output.js';
+import { SdlcLifecycle, FeatureMode } from '../../../../../packages/core/src/domain/generated/output.js';
 import { colors, messages, spinner } from '../../ui/index.js';
 import { getCliI18n } from '../../i18n.js';
 import { getShepHomeDir } from '../../../../../packages/core/src/infrastructure/services/filesystem/shep-directory.service.js';
@@ -34,7 +34,7 @@ function getWorkflowDefaults() {
             allowPlan: false,
             allowMerge: false,
             push: false,
-            fast: true,
+            defaultMode: FeatureMode.Fast,
         };
     }
     const settings = getSettings();
@@ -45,7 +45,7 @@ function getWorkflowDefaults() {
         allowPlan: gates.allowPlan,
         allowMerge: gates.allowMerge,
         push: gates.pushOnImplementationComplete,
-        fast: settings.workflow.defaultFastMode,
+        defaultMode: settings.workflow.defaultMode ?? FeatureMode.Fast,
     };
 }
 /**
@@ -68,8 +68,11 @@ export function createNewCommand() {
         .option('--pending', t('cli:commands.feat.new.pendingOption'))
         .option('--fast', t('cli:commands.feat.new.fastOption'))
         .option('--no-fast', t('cli:commands.feat.new.noFastOption'))
+        .option('--explore', t('cli:commands.feat.new.exploreOption'))
         .option('--model <model>', t('cli:commands.feat.new.modelOption'))
         .option('--no-rebase', t('cli:commands.feat.new.noRebaseOption'))
+        .option('--inject-skills', t('cli:commands.feat.new.injectSkillsOption'))
+        .option('--no-inject-skills', t('cli:commands.feat.new.noInjectSkillsOption'))
         .option('--attach <path>', t('cli:commands.feat.new.attachOption'), collect, [])
         .action(async (description, options) => {
         try {
@@ -119,7 +122,19 @@ export function createNewCommand() {
                     attachmentPaths.push(resolved);
                 }
             }
-            const fast = options.fast ?? defaults.fast;
+            // Validate mutually exclusive mode flags
+            if (options.explore && options.fast) {
+                messages.error(t('cli:commands.feat.new.exploreAndFastConflict'));
+                process.exitCode = 1;
+                return;
+            }
+            const mode = options.explore
+                ? FeatureMode.Exploration
+                : options.fast
+                    ? FeatureMode.Fast
+                    : options.fast === false
+                        ? FeatureMode.Regular
+                        : defaults.defaultMode;
             const result = await spinner(t('cli:commands.feat.new.spinnerText'), () => useCase.execute({
                 userInput: description,
                 repositoryPath: repoPath,
@@ -128,9 +143,10 @@ export function createNewCommand() {
                 openPr,
                 ...(parentId !== undefined && { parentId }),
                 ...(options.pending && { pending: true }),
-                ...(fast && { fast: true }),
+                mode,
                 ...(options.model !== undefined && { model: options.model }),
                 ...(attachmentPaths.length > 0 && { attachmentPaths }),
+                ...(options.injectSkills !== undefined && { injectSkills: options.injectSkills }),
                 rebaseBeforeBranch: options.rebase,
             }));
             const { feature, warning } = result;

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

@@ -0,0 +1,13 @@
+/**
+ * Feature Promote Command
+ *
+ * Promotes an exploration feature to Regular or Fast mode via
+ * in-place mode transition using PromoteExplorationUseCase.
+ *
+ * Usage:
+ *   shep feat promote <id>          # Promote to Regular mode
+ *   shep feat promote <id> --fast   # Promote to Fast mode
+ */
+import { Command } from 'commander';
+export declare function createPromoteCommand(): Command;
+//# sourceMappingURL=promote.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promote.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/promote.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,oBAAoB,IAAI,OAAO,CAiC9C"}

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

@@ -0,0 +1,41 @@
+/**
+ * Feature Promote Command
+ *
+ * Promotes an exploration feature to Regular or Fast mode via
+ * in-place mode transition using PromoteExplorationUseCase.
+ *
+ * Usage:
+ *   shep feat promote <id>          # Promote to Regular mode
+ *   shep feat promote <id> --fast   # Promote to Fast mode
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { PromoteExplorationUseCase } from '../../../../../packages/core/src/application/use-cases/features/promote/promote-exploration.use-case.js';
+import { FeatureMode } from '../../../../../packages/core/src/domain/generated/output.js';
+import { colors, messages, spinner } from '../../ui/index.js';
+import { getCliI18n } from '../../i18n.js';
+export function createPromoteCommand() {
+    const t = getCliI18n().t;
+    return new Command('promote')
+        .description(t('cli:commands.feat.promote.description'))
+        .argument('<id>', t('cli:commands.feat.promote.idArgument'))
+        .option('--fast', t('cli:commands.feat.promote.fastOption'))
+        .action(async (featureId, options) => {
+        try {
+            const targetMode = options.fast ? FeatureMode.Fast : FeatureMode.Regular;
+            const useCase = container.resolve(PromoteExplorationUseCase);
+            const { feature } = await spinner(t('cli:commands.feat.promote.description'), () => useCase.execute({ featureId, targetMode }));
+            messages.newline();
+            messages.success(t('cli:commands.feat.promote.promoted', { name: feature.name }));
+            console.log(`  ${colors.muted(t('cli:commands.feat.promote.modeLabel'))}   ${feature.mode}`);
+            console.log(`  ${colors.muted(t('cli:commands.feat.promote.statusLabel'))} ${feature.lifecycle}`);
+            console.log(`  ${colors.muted(t('cli:commands.feat.promote.agentLabel'))}  ${t('cli:commands.feat.promote.agentSpawned', { mode: targetMode })}`);
+            messages.newline();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error(t('cli:commands.feat.promote.failedToPromote'), err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/web/app/actions/add-injected-skill.d.ts

@@ -0,0 +1,7 @@
+import type { SkillSource } from '../../../../../packages/core/src/domain/generated/output.js';
+export interface AddInjectedSkillResult {
+    success: boolean;
+    error?: string;
+}
+export declare function addInjectedSkill(skill: SkillSource): Promise<AddInjectedSkillResult>;
+//# sourceMappingURL=add-injected-skill.d.ts.map

package/dist/src/presentation/web/app/actions/add-injected-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-injected-skill.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/add-injected-skill.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgC1F"}

package/dist/src/presentation/web/app/actions/add-injected-skill.js

@@ -0,0 +1,34 @@
+'use server';
+import { revalidatePath } from 'next/cache';
+import { resolve } from '../../lib/server-container.js';
+import { updateSettings as updateSettingsSingleton } from '../../../../../packages/core/src/infrastructure/services/settings.service.js';
+export async function addInjectedSkill(skill) {
+    try {
+        const loadUseCase = resolve('LoadSettingsUseCase');
+        const current = await loadUseCase.execute();
+        const existingSkills = current.workflow.skillInjection?.skills ?? [];
+        if (existingSkills.some((s) => s.name === skill.name)) {
+            return { success: false, error: `Skill "${skill.name}" is already configured` };
+        }
+        const updated = {
+            ...current,
+            workflow: {
+                ...current.workflow,
+                skillInjection: {
+                    enabled: current.workflow.skillInjection?.enabled ?? true,
+                    skills: [...existingSkills, skill],
+                },
+            },
+            updatedAt: new Date(),
+        };
+        const updateUseCase = resolve('UpdateSettingsUseCase');
+        await updateUseCase.execute(updated);
+        updateSettingsSingleton(updated);
+        revalidatePath('/skills');
+        return { success: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to add skill';
+        return { success: false, error: message };
+    }
+}

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

@@ -1,4 +1,5 @@
 import type { Feature } from '../../../../../packages/core/src/domain/generated/output.js';
+import { type FeatureMode } from '../../../../../packages/core/src/domain/generated/output.js';
 interface Attachment {
     path: string;
     name: string;
@@ -17,8 +18,8 @@ interface CreateFeatureInput {
     push?: boolean;
     openPr?: boolean;
     parentId?: string;
-    /** When true, skip SDLC phases and implement directly from the prompt. */
-    fast?: boolean;
+    /** Execution mode: Regular (full SDLC), Fast (direct implementation), or Exploration (iterative prototyping). */
+    mode?: FeatureMode;
     /** When true, create the feature in pending state (no agent spawned). */
     pending?: boolean;
     /** Fork repo and create PR to upstream at merge time. */
@@ -37,6 +38,8 @@ interface CreateFeatureInput {
     model?: string;
     /** Sync main from remote before creating the feature branch (default: true). */
     rebaseBeforeBranch?: boolean;
+    /** Inject curated skills into the feature worktree. */
+    injectSkills?: boolean;
 }
 export declare function createFeature(input: CreateFeatureInput): Promise<{
     feature?: Feature;

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

@@ -1 +1 @@
-{"version":3,"file":"create-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/create-feature.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAGpE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiGhD"}
+{"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;AACpE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGxE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iHAAiH;IACjH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoGhD"}

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

@@ -2,7 +2,7 @@
 import { resolve } from '../../lib/server-container.js';
 import { composeUserInput } from './compose-user-input.js';
 export async function createFeature(input) {
-    const { description, repositoryPath, attachments, sessionId, approvalGates, push, openPr, parentId, fast, pending, forkAndPr, commitSpecs, ciWatchEnabled, enableEvidence, commitEvidence, agentType, model, rebaseBeforeBranch, } = input;
+    const { description, repositoryPath, attachments, sessionId, approvalGates, push, openPr, parentId, mode, pending, forkAndPr, commitSpecs, ciWatchEnabled, enableEvidence, commitEvidence, agentType, model, rebaseBeforeBranch, injectSkills, } = input;
     if (!description?.trim()) {
         return { error: 'description is required' };
     }
@@ -26,7 +26,7 @@ export async function createFeature(input) {
             openPr: openPr ?? false,
             ...(parentId ? { parentId } : {}),
             description,
-            ...(fast ? { fast } : {}),
+            ...(mode ? { mode } : {}),
             ...(pending ? { pending } : {}),
             ...(forkAndPr != null ? { forkAndPr } : {}),
             ...(commitSpecs != null ? { commitSpecs } : {}),
@@ -36,6 +36,7 @@ export async function createFeature(input) {
             ...(agentType ? { agentType } : {}),
             ...(model ? { model } : {}),
             ...(rebaseBeforeBranch != null ? { rebaseBeforeBranch } : {}),
+            ...(injectSkills != null ? { injectSkills } : {}),
         });
         // Phase 2 (background): metadata generation, worktree, spec, agent spawn
         // Fire-and-forget — the UI gets the real feature ID immediately
@@ -47,7 +48,7 @@ export async function createFeature(input) {
             push: push ?? false,
             openPr: openPr ?? false,
             ...(parentId ? { parentId } : {}),
-            ...(fast ? { fast } : {}),
+            ...(mode ? { mode } : {}),
             ...(pending ? { pending } : {}),
             ...(forkAndPr != null ? { forkAndPr } : {}),
             ...(commitSpecs != null ? { commitSpecs } : {}),
@@ -58,6 +59,7 @@ export async function createFeature(input) {
             ...(model ? { model } : {}),
             ...(sessionId ? { sessionId } : {}),
             ...(rebaseBeforeBranch != null ? { rebaseBeforeBranch } : {}),
+            ...(injectSkills != null ? { injectSkills } : {}),
         }, shouldSpawn)
             .catch((err) => {
             // eslint-disable-next-line no-console

package/dist/src/presentation/web/app/actions/discard-exploration.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Discard an exploration feature, cleaning up the worktree and branch.
+ * Validates the feature is in exploration mode before deleting.
+ */
+export declare function discardExploration(featureId: string): Promise<{
+    discarded: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=discard-exploration.d.ts.map

package/dist/src/presentation/web/app/actions/discard-exploration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discard-exploration.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/discard-exploration.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBjD"}