@shepai/cli 1.15.1 → 1.17.0

package/dist/src/infrastructure/services/agents/feature-agent/nodes/implement.node.js

@@ -1,23 +1,146 @@
-import { createNodeLogger } from './node-helpers.js';
-import { reportNodeStart } from '../heartbeat.js';
-import { getImplementPlaceholderJoke } from './prompts/implement.prompt.js';
 /**
- * Creates the implement node — PLACEHOLDER.
+ * Implement Node — Phase-Level Orchestrator
  *
- * Implementation execution is not yet wired up.
- * Returns a programming joke to clearly signal this is a placeholder
- * while keeping the graph pipeline intact.
+ * Reads plan.yaml and tasks.yaml, then executes each phase by building
+ * a focused implementation prompt and calling the executor. Parallel
+ * phases spawn concurrent executor calls. Progress is tracked in
+ * feature.yaml between phases.
+ */
+import yaml from 'js-yaml';
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { interrupt, isGraphBubbleUp } from '@langchain/langgraph';
+import { createNodeLogger, readSpecFile, buildExecutorOptions, shouldInterrupt, safeYamlLoad, } from './node-helpers.js';
+import { reportNodeStart } from '../heartbeat.js';
+import { buildImplementPhasePrompt, } from './prompts/implement.prompt.js';
+/**
+ * Update feature.yaml with current implementation progress.
+ * Silently no-ops if the file is missing or unparseable.
  */
-export function createImplementNode(_executor) {
+function updateFeatureProgress(specDir, completedCount, totalCount, currentPhase, currentTaskId, log) {
+    try {
+        const content = readSpecFile(specDir, 'feature.yaml');
+        if (!content)
+            return;
+        const data = yaml.load(content);
+        if (!data || typeof data !== 'object')
+            return;
+        const status = (data.status ?? {});
+        data.status = {
+            ...status,
+            phase: currentPhase,
+            progress: {
+                completed: completedCount,
+                total: totalCount,
+                percentage: totalCount > 0 ? Math.round((completedCount / totalCount) * 100) : 0,
+            },
+            currentTask: currentTaskId,
+            lastUpdated: new Date().toISOString(),
+            lastUpdatedBy: 'feature-agent:implement',
+        };
+        writeFileSync(join(specDir, 'feature.yaml'), yaml.dump(data, { indent: 2, lineWidth: -1 }), 'utf-8');
+    }
+    catch (err) {
+        log.error(`Failed to update feature.yaml: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function createImplementNode(executor) {
     const log = createNodeLogger('implement');
-    return async (_state) => {
-        log.info('Starting... (placeholder — implementation not yet wired)');
+    return async (state) => {
+        log.info('Starting implementation phase orchestration');
         reportNodeStart('implement');
-        const joke = getImplementPlaceholderJoke();
-        log.info(`Placeholder complete. ${joke}`);
-        return {
-            currentNode: 'implement',
-            messages: [`[implement] Placeholder — ${joke}`],
-        };
+        const startTime = Date.now();
+        const messages = [];
+        try {
+            // --- Parse plan & tasks ---
+            const planContent = readSpecFile(state.specDir, 'plan.yaml');
+            const tasksContent = readSpecFile(state.specDir, 'tasks.yaml');
+            if (!planContent || !tasksContent) {
+                const msg = 'Missing plan.yaml or tasks.yaml — cannot implement';
+                log.error(msg);
+                return { currentNode: 'implement', error: msg, messages: [`[implement] Error: ${msg}`] };
+            }
+            const planData = safeYamlLoad(planContent);
+            const tasksData = safeYamlLoad(tasksContent);
+            if (!planData?.phases?.length || !tasksData?.tasks?.length) {
+                const msg = 'Empty phases or tasks — nothing to implement';
+                log.error(msg);
+                return { currentNode: 'implement', error: msg, messages: [`[implement] Error: ${msg}`] };
+            }
+            const taskMap = new Map(tasksData.tasks.map((t) => [t.id, t]));
+            const totalTasks = tasksData.tasks.length;
+            let completedTasks = 0;
+            const totalPhases = planData.phases.length;
+            // --- Execute phases in order ---
+            for (let i = 0; i < totalPhases; i++) {
+                const phase = planData.phases[i];
+                const isLastPhase = i === totalPhases - 1;
+                // Resolve tasks: use explicit taskIds if present, otherwise match by phaseId
+                const phaseTasks = phase.taskIds?.length
+                    ? phase.taskIds
+                        .map((id) => taskMap.get(id))
+                        .filter((t) => t !== undefined)
+                    : tasksData.tasks.filter((t) => t.phaseId === phase.id);
+                if (phaseTasks.length === 0) {
+                    log.info(`Phase ${phase.id} "${phase.name}" — no tasks, skipping`);
+                    continue;
+                }
+                log.info(`Phase ${phase.id} "${phase.name}" — ${phaseTasks.length} task(s), parallel: ${phase.parallel}`);
+                updateFeatureProgress(state.specDir, completedTasks, totalTasks, `implementing-${phase.id}`, phaseTasks[0].id, log);
+                const options = buildExecutorOptions(state);
+                const promptContext = { isLastPhase, phaseIndex: i, totalPhases };
+                if (phase.parallel && phaseTasks.length > 1) {
+                    // Parallel: one executor call per task
+                    log.info(`Spawning ${phaseTasks.length} parallel executor calls`);
+                    const results = await Promise.all(phaseTasks.map((task) => {
+                        const singleTaskPhase = {
+                            ...phase,
+                            taskIds: [task.id],
+                        };
+                        const prompt = buildImplementPhasePrompt(state, singleTaskPhase, [task], promptContext);
+                        log.info(`  [parallel] Task ${task.id}: "${task.title}" — ${prompt.length} chars`);
+                        return executor.execute(prompt, options);
+                    }));
+                    for (let j = 0; j < results.length; j++) {
+                        log.info(`  [parallel] Task ${phaseTasks[j].id} complete (${results[j].result.length} chars)`);
+                    }
+                }
+                else {
+                    // Sequential: single executor call with all phase tasks
+                    const prompt = buildImplementPhasePrompt(state, phase, phaseTasks, promptContext);
+                    log.info(`Executing phase prompt — ${prompt.length} chars`);
+                    const result = await executor.execute(prompt, options);
+                    log.info(`Phase complete (${result.result.length} chars)`);
+                }
+                completedTasks += phaseTasks.length;
+                const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+                messages.push(`[implement] Phase ${phase.id} "${phase.name}" — ${phaseTasks.length} task(s) done (${elapsed}s)`);
+                updateFeatureProgress(state.specDir, completedTasks, totalTasks, `implementing-${phase.id}`, null, log);
+            }
+            // --- Final ---
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            log.info(`All phases complete — ${completedTasks}/${totalTasks} tasks (${elapsed}s)`);
+            updateFeatureProgress(state.specDir, totalTasks, totalTasks, 'implementation-complete', null, log);
+            messages.push(`[implement] Complete: ${totalTasks} tasks across ${totalPhases} phases (${elapsed}s)`);
+            if (shouldInterrupt('implement', state.approvalMode)) {
+                log.info('Interrupting for human approval');
+                interrupt({
+                    node: 'implement',
+                    message: `Implementation complete: ${totalTasks} tasks across ${totalPhases} phases. Approve to finish.`,
+                });
+            }
+            return { currentNode: 'implement', messages };
+        }
+        catch (err) {
+            if (isGraphBubbleUp(err))
+                throw err;
+            const message = err instanceof Error ? err.message : String(err);
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            log.error(`${message} (after ${elapsed}s)`);
+            // Throw so LangGraph does NOT checkpoint this node as "completed".
+            // The worker catch block marks the run as failed, and on resume
+            // LangGraph re-executes from the last successfully checkpointed node.
+            throw new Error(`[implement] ${message}`);
+        }
     };
 }

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

@@ -23,6 +23,12 @@ export declare function readSpecFile(specDir: string, filename: string): string;
  * Build executor options with cwd. Each node gets a clean agent context.
  */
 export declare function buildExecutorOptions(state: FeatureAgentState): AgentExecutionOptions;
+/**
+ * Parse YAML with automatic sanitization of common AI-generated issues.
+ * First attempts normal parsing; on failure, sanitizes unquoted braces
+ * in list items and retries.
+ */
+export declare function safeYamlLoad(content: string): unknown;
 /**
  * Determine whether the current node should trigger an interrupt
  * for human approval given the configured approval mode.

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

@@ -1 +1 @@
-{"version":3,"file":"node-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/node-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM;kBAE/B,MAAM,GAAG,IAAI;mBAIZ,MAAM,GAAG,IAAI;EAK/B;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,qBAAqB,CAIpF;AAUD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI3F;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,UAAU,KAAK,MAAM,GACjE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAiDnE"}
+{"version":3,"file":"node-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/node-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM;kBAE/B,MAAM,GAAG,IAAI;mBAIZ,MAAM,GAAG,IAAI;EAK/B;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,qBAAqB,CAIpF;AAeD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQrD;AAUD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI3F;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,UAAU,KAAK,MAAM,GACjE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAgDnE"}

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

@@ -4,6 +4,7 @@
  * Provides consistent logging, spec file reading, executor invocation,
  * and error handling so every node follows the same patterns.
  */
+import yaml from 'js-yaml';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { interrupt, isGraphBubbleUp } from '@langchain/langgraph';
@@ -43,6 +44,30 @@ export function buildExecutorOptions(state) {
         cwd: state.worktreePath || state.repositoryPath,
     };
 }
+/**
+ * Sanitize YAML content to handle common AI-generated issues.
+ * Quotes unquoted list items containing `{` or `}` characters
+ * which js-yaml interprets as flow mappings.
+ */
+function sanitizeYamlBraces(content) {
+    return content.replace(/^(\s*- )(?!['"])(.+[{}].+)$/gm, (_match, prefix, value) => `${prefix}"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`);
+}
+/**
+ * Parse YAML with automatic sanitization of common AI-generated issues.
+ * First attempts normal parsing; on failure, sanitizes unquoted braces
+ * in list items and retries.
+ */
+export function safeYamlLoad(content) {
+    try {
+        return yaml.load(content);
+    }
+    catch (firstError) {
+        const sanitized = sanitizeYamlBraces(content);
+        if (sanitized === content)
+            throw firstError; // nothing to sanitize
+        return yaml.load(sanitized);
+    }
+}
 /** Nodes that are auto-approved (no interrupt) for each approval mode. */
 const AUTO_APPROVED_NODES = {
     interactive: [],
@@ -104,11 +129,10 @@ export function executeNode(nodeName, executor, buildPrompt) {
             const message = err instanceof Error ? err.message : String(err);
             const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
             log.error(`${message} (after ${elapsed}s)`);
-            return {
-                currentNode: nodeName,
-                error: message,
-                messages: [`[${nodeName}] Error: ${message}`],
-            };
+            // Throw so LangGraph does NOT checkpoint this node as "completed".
+            // The worker catch block marks the run as failed, and on resume
+            // LangGraph re-executes from the last successfully checkpointed node.
+            throw new Error(`[${nodeName}] ${message}`);
         }
     };
 }

package/dist/src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.d.ts

@@ -1,8 +1,48 @@
 /**
- * Implement Phase Prompt — PLACEHOLDER
+ * Implement Phase Prompt
  *
- * The implement phase is not yet wired up. This returns a programming joke
- * to clearly signal it's a placeholder while keeping the graph pipeline intact.
+ * Builds per-phase implementation prompts that include full spec/research/plan
+ * context plus the specific tasks for the current phase, with TDD guidance
+ * and verification instructions.
  */
-export declare function getImplementPlaceholderJoke(): string;
+import type { FeatureAgentState } from '../../state.js';
+export interface PhaseTask {
+    id: string;
+    phaseId?: string;
+    title: string;
+    description: string;
+    state: string;
+    dependencies: string[];
+    acceptanceCriteria: string[];
+    tdd: {
+        red: string[];
+        green: string[];
+        refactor: string[];
+    } | null;
+    estimatedEffort: string;
+}
+export interface PlanPhase {
+    id: string;
+    name: string;
+    description?: string;
+    parallel: boolean;
+    /** Optional — if absent, tasks are matched via their phaseId field */
+    taskIds?: string[];
+}
+export interface PlanYaml {
+    phases: PlanPhase[];
+}
+export interface TasksYaml {
+    tasks: PhaseTask[];
+}
+/**
+ * Build the implementation prompt for a single phase (or a single task
+ * within a parallel phase). Includes full project context so each
+ * executor session is self-contained.
+ */
+export declare function buildImplementPhasePrompt(state: FeatureAgentState, phase: PlanPhase, tasks: PhaseTask[], context: {
+    isLastPhase: boolean;
+    phaseIndex: number;
+    totalPhases: number;
+}): string;
 //# sourceMappingURL=implement.prompt.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implement.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}
+{"version":3,"file":"implement.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAwBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzE,MAAM,CA8DR"}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.js

@@ -1,18 +1,90 @@
 /**
- * Implement Phase Prompt — PLACEHOLDER
+ * Implement Phase Prompt
  *
- * The implement phase is not yet wired up. This returns a programming joke
- * to clearly signal it's a placeholder while keeping the graph pipeline intact.
+ * Builds per-phase implementation prompts that include full spec/research/plan
+ * context plus the specific tasks for the current phase, with TDD guidance
+ * and verification instructions.
  */
-const JOKES = [
-    'Why do programmers prefer dark mode? Because light attracts bugs.',
-    'A SQL query walks into a bar, walks up to two tables and asks... "Can I JOIN you?"',
-    "There are only 10 types of people: those who understand binary, and those who don't.",
-    "Why was the JavaScript developer sad? Because he didn't Node how to Express himself.",
-    "What's a programmer's favorite hangout place? Foo Bar.",
-    'To understand recursion, you must first understand recursion.',
-    "!false — it's funny because it's true.",
-];
-export function getImplementPlaceholderJoke() {
-    return JOKES[Math.floor(Math.random() * JOKES.length)];
+import { readSpecFile } from '../node-helpers.js';
+function formatTaskSection(task) {
+    let section = `### Task ${task.id}: ${task.title}\n${task.description}\n`;
+    section += `\n**Acceptance Criteria:**\n`;
+    for (const criterion of task.acceptanceCriteria) {
+        section += `- ${criterion}\n`;
+    }
+    if (task.tdd) {
+        section += `\n**TDD Guidance:**\n`;
+        section += `- Write tests for: ${task.tdd.red.join('; ')}\n`;
+        section += `- Implement: ${task.tdd.green.join('; ')}\n`;
+        section += `- Then consider: ${task.tdd.refactor.join('; ')}\n`;
+    }
+    if (task.dependencies.length > 0) {
+        section += `\nDepends on: ${task.dependencies.join(', ')}\n`;
+    }
+    return section;
+}
+/**
+ * Build the implementation prompt for a single phase (or a single task
+ * within a parallel phase). Includes full project context so each
+ * executor session is self-contained.
+ */
+export function buildImplementPhasePrompt(state, phase, tasks, context) {
+    const specContent = readSpecFile(state.specDir, 'spec.yaml');
+    const researchContent = readSpecFile(state.specDir, 'research.yaml');
+    const planContent = readSpecFile(state.specDir, 'plan.yaml');
+    const cwd = state.worktreePath || state.repositoryPath;
+    const taskSections = tasks.map(formatTaskSection).join('\n');
+    const verificationBlock = context.isLastPhase
+        ? `4. Run full project validation:
+   - \`pnpm test\` (all tests must pass)
+   - \`pnpm lint\` (no lint errors)
+   - \`pnpm typecheck\` (no type errors)
+   - Fix any issues before finishing`
+        : `4. Run tests relevant to what you changed:
+   - Run targeted tests for modified files (e.g. \`pnpm test:single <test-file>\`)
+   - Fix any test failures before moving on`;
+    return `You are a senior software engineer performing autonomous implementation.
+You are executing phase ${context.phaseIndex + 1} of ${context.totalPhases}: "${phase.name}".
+
+## Feature Specification
+
+\`\`\`yaml
+${specContent}
+\`\`\`
+
+## Research Decisions
+
+\`\`\`yaml
+${researchContent}
+\`\`\`
+
+## Implementation Plan
+
+\`\`\`yaml
+${planContent}
+\`\`\`
+
+## Your Tasks for This Phase: "${phase.name}"
+
+${taskSections}
+
+## Implementation Instructions
+
+1. Work through each task in dependency order
+2. For tasks with TDD guidance: write tests alongside implementation following the hints provided — use them as guidance, not rigid steps
+3. Follow existing codebase conventions for file placement, naming patterns, and architecture layers
+${verificationBlock}
+5. Commit your work with descriptive conventional commit messages (e.g. \`feat(scope): description\`)
+
+## Working Directory
+
+${cwd}
+
+## Constraints
+
+- Implement ONLY the tasks listed above — do not work ahead to future phases
+- Follow existing codebase conventions and architecture patterns
+- Do NOT modify any spec YAML files (spec.yaml, research.yaml, plan.yaml, tasks.yaml, feature.yaml)
+- Do NOT skip writing tests for tasks that have TDD guidance
+- Keep changes focused and minimal — avoid unnecessary refactoring beyond what the tasks specify`;
 }

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

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

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

@@ -10,6 +10,7 @@
  * $ shep feat ls
  * $ shep feat ls --repo /path/to/project
  */
+import path from 'node:path';
 import { Command } from 'commander';
 import { container } from '../../../../infrastructure/di/container.js';
 import { ListFeaturesUseCase } from '../../../../application/use-cases/features/list-features.use-case.js';
@@ -65,6 +66,39 @@ function isProcessAlive(pid) {
         return false;
     }
 }
+/** Format a duration in ms to a compact human-readable string. */
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    const remMin = minutes % 60;
+    if (hours < 24)
+        return remMin > 0 ? `${hours}h ${remMin}m` : `${hours}h`;
+    const days = Math.floor(hours / 24);
+    return `${days}d`;
+}
+/** Format the time column based on run status. */
+function formatTime(feature, run) {
+    const now = Date.now();
+    if (run) {
+        const isRunning = run.status === 'running' || run.status === 'pending';
+        if (isRunning && run.startedAt) {
+            const started = new Date(run.startedAt).getTime();
+            return colors.info(formatDuration(now - started));
+        }
+        if (run.status === 'completed' && run.completedAt) {
+            const completed = new Date(run.completedAt).getTime();
+            return colors.muted(`${formatDuration(now - completed)} ago`);
+        }
+    }
+    // Fallback to updatedAt
+    const updated = new Date(feature.updatedAt).getTime();
+    return colors.muted(`${formatDuration(now - updated)} ago`);
+}
 export function createLsCommand() {
     return new Command('ls')
         .description('List features')
@@ -79,15 +113,15 @@ export function createLsCommand() {
             const runs = await Promise.all(features.map((f) => f.agentRunId ? runRepo.findById(f.agentRunId) : Promise.resolve(null)));
             const rows = features.map((feature, i) => {
                 const run = runs[i];
-                const updated = feature.updatedAt instanceof Date
-                    ? feature.updatedAt.toLocaleDateString()
-                    : String(feature.updatedAt);
+                const repo = path.basename(feature.repositoryPath);
+                const agent = run?.agentType ?? colors.muted('—');
                 return [
                     feature.id.slice(0, 8),
                     feature.name.slice(0, 30),
                     formatStatus(feature, run),
-                    colors.muted(feature.branch),
-                    colors.muted(updated),
+                    colors.muted(repo),
+                    agent,
+                    formatTime(feature, run),
                 ];
             });
             renderListView({
@@ -96,8 +130,9 @@ export function createLsCommand() {
                     { label: 'ID', width: 10 },
                     { label: 'Name', width: 32 },
                     { label: 'Status', width: 20 },
-                    { label: 'Branch', width: 28 },
-                    { label: 'Updated', width: 12 },
+                    { label: 'Repo', width: 20 },
+                    { label: 'Agent', width: 14 },
+                    { label: 'Time', width: 12 },
                 ],
                 rows,
                 emptyMessage: 'No features found',

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;AAapC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CA6C1C"}
+{"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;AAapC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CA+C1C"}

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

@@ -12,7 +12,7 @@
 import { Command } from 'commander';
 import { container } from '../../../../infrastructure/di/container.js';
 import { CreateFeatureUseCase } from '../../../../application/use-cases/features/create-feature.use-case.js';
-import { colors, messages } from '../../ui/index.js';
+import { colors, messages, spinner } from '../../ui/index.js';
 /**
  * Create the feat new command
  */
@@ -39,11 +39,11 @@ export function createNewCommand() {
                 approvalMode = 'allow-plan';
             if (options.allowAll)
                 approvalMode = 'allow-all';
-            const feature = await useCase.execute({
+            const feature = await spinner('Thinking', () => useCase.execute({
                 userInput: description,
                 repositoryPath: repoPath,
                 approvalMode,
-            });
+            }));
             messages.newline();
             messages.success('Feature created');
             console.log(`  ${colors.muted('ID:')}     ${colors.accent(feature.id)}`);

package/dist/src/presentation/cli/ui/index.d.ts

@@ -19,4 +19,5 @@ export { TableFormatter, type DatabaseMeta } from './tables.js';
 export { OutputFormatter, type OutputFormat } from './output.js';
 export { renderDetailView, type DetailViewConfig, type DetailSection, type DetailField, type DetailTextBlock, } from './detail-view.js';
 export { renderListView, type ListViewConfig, type ListColumn } from './list-view.js';
+export { spinner } from './spinner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/presentation/cli/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/presentation/cli/ui/index.js

@@ -19,3 +19,4 @@ export { TableFormatter } from './tables.js';
 export { OutputFormatter } from './output.js';
 export { renderDetailView, } from './detail-view.js';
 export { renderListView } from './list-view.js';
+export { spinner } from './spinner.js';

package/dist/src/presentation/cli/ui/spinner.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI Design System - Spinner
+ *
+ * Lightweight terminal spinner for async operations.
+ * Uses the braille spinner frames from the symbols module.
+ *
+ * @example
+ * import { spinner } from './spinner';
+ * const result = await spinner('Thinking', async () => {
+ *   return await someAsyncWork();
+ * });
+ */
+/**
+ * Show a spinner while an async operation runs, then clear it.
+ *
+ * @param label - Text shown next to the spinner (e.g. "Thinking")
+ * @param fn - Async function to execute
+ * @returns The result of the async function
+ */
+export declare function spinner<T>(label: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/src/presentation/cli/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAyBhF"}

package/dist/src/presentation/cli/ui/spinner.js

@@ -0,0 +1,45 @@
+/**
+ * CLI Design System - Spinner
+ *
+ * Lightweight terminal spinner for async operations.
+ * Uses the braille spinner frames from the symbols module.
+ *
+ * @example
+ * import { spinner } from './spinner';
+ * const result = await spinner('Thinking', async () => {
+ *   return await someAsyncWork();
+ * });
+ */
+import { symbols } from './symbols.js';
+import { colors } from './colors.js';
+/**
+ * Show a spinner while an async operation runs, then clear it.
+ *
+ * @param label - Text shown next to the spinner (e.g. "Thinking")
+ * @param fn - Async function to execute
+ * @returns The result of the async function
+ */
+export async function spinner(label, fn) {
+    const frames = symbols.spinner;
+    let i = 0;
+    // Write initial frame
+    const write = () => {
+        const frame = frames[i % frames.length];
+        process.stderr.write(`\r${colors.muted(`${frame} ${label}...`)}`);
+        i++;
+    };
+    write();
+    const interval = setInterval(write, 80);
+    try {
+        const result = await fn();
+        clearInterval(interval);
+        // Clear the spinner line
+        process.stderr.write(`\r${' '.repeat(label.length + 6)}\r`);
+        return result;
+    }
+    catch (error) {
+        clearInterval(interval);
+        process.stderr.write(`\r${' '.repeat(label.length + 6)}\r`);
+        throw error;
+    }
+}

package/dist/src/presentation/tui/prompts/agent-select.prompt.d.ts

@@ -32,7 +32,7 @@ export declare function createAgentSelectConfig(): {
     }, {
         readonly name: "Cursor";
         readonly value: AgentType.Cursor;
-        readonly disabled: "(Coming Soon)";
+        readonly description: "Cursor AI coding agent";
     }];
     readonly theme: {
         readonly prefix: {

package/dist/src/presentation/tui/prompts/agent-select.prompt.js

@@ -39,7 +39,7 @@ export function createAgentSelectConfig() {
             {
                 name: 'Cursor',
                 value: AgentType.Cursor,
-                disabled: '(Coming Soon)',
+                description: 'Cursor AI coding agent',
             },
         ],
         theme: shepTheme,