@shepai/cli 1.14.2 → 1.15.0

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

@@ -0,0 +1,11 @@
+/**
+ * Feature Show Command
+ *
+ * Displays detailed information about a specific feature.
+ * Derives real-time status from the agent run.
+ *
+ * Usage: shep feat show <id>
+ */
+import { Command } from 'commander';
+export declare function createShowCommand(): Command;
+//# sourceMappingURL=show.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4DpC,wBAAgB,iBAAiB,IAAI,OAAO,CAyE3C"}

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

@@ -0,0 +1,128 @@
+/**
+ * Feature Show Command
+ *
+ * Displays detailed information about a specific feature.
+ * Derives real-time status from the agent run.
+ *
+ * Usage: shep feat show <id>
+ */
+import { Command } from 'commander';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { container } from '../../../../infrastructure/di/container.js';
+import { ShowFeatureUseCase } from '../../../../application/use-cases/features/show-feature.use-case.js';
+import { colors, symbols, messages, renderDetailView } from '../../ui/index.js';
+import { SHEP_HOME_DIR } from '../../../../infrastructure/services/filesystem/shep-directory.service.js';
+function computeWorktreePath(repoPath, branch) {
+    const repoHash = createHash('sha256').update(repoPath).digest('hex').slice(0, 16);
+    const slug = branch.replace(/\//g, '-');
+    return join(SHEP_HOME_DIR, 'repos', repoHash, 'wt', slug);
+}
+/** Map graph node names to human-readable phase labels. */
+const NODE_TO_PHASE = {
+    analyze: 'Analyzing',
+    requirements: 'Requirements',
+    research: 'Researching',
+    plan: 'Planning',
+    implement: 'Implementing',
+};
+function formatStatus(feature, run) {
+    if (!run) {
+        return `${colors.muted(symbols.dotEmpty)} ${colors.muted(feature.lifecycle)}`;
+    }
+    const isRunning = run.status === 'running' || run.status === 'pending';
+    const phase = run.result?.startsWith('node:')
+        ? (NODE_TO_PHASE[run.result.slice(5)] ?? run.result.slice(5))
+        : feature.lifecycle;
+    if (isRunning) {
+        if (run.pid && !isProcessAlive(run.pid)) {
+            return `${colors.error(symbols.error)} ${colors.error('crashed')}`;
+        }
+        return `${colors.info(symbols.spinner[0])} ${colors.info(phase)}`;
+    }
+    if (run.status === 'completed')
+        return `${colors.success(symbols.success)} ${colors.success('Completed')}`;
+    if (run.status === 'failed')
+        return `${colors.error(symbols.error)} ${colors.error('Failed')}`;
+    if (run.status === 'waiting_approval')
+        return `${colors.warning(symbols.warning)} ${colors.warning(phase)}`;
+    if (run.status === 'interrupted')
+        return `${colors.error(symbols.error)} ${colors.error('Interrupted')}`;
+    return `${colors.muted(symbols.dotEmpty)} ${colors.muted(phase)}`;
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function createShowCommand() {
+    return new Command('show')
+        .description('Show feature details')
+        .argument('<id>', 'Feature ID')
+        .action(async (featureId) => {
+        try {
+            const useCase = container.resolve(ShowFeatureUseCase);
+            const runRepo = container.resolve('IAgentRunRepository');
+            const feature = await useCase.execute(featureId);
+            const run = feature.agentRunId ? await runRepo.findById(feature.agentRunId) : null;
+            const worktreePath = computeWorktreePath(feature.repositoryPath, feature.branch);
+            const formatTs = (ts) => {
+                if (ts instanceof Date)
+                    return ts.toLocaleString();
+                return String(ts);
+            };
+            const textBlocks = [];
+            if (feature.plan) {
+                textBlocks.push({
+                    title: 'Plan',
+                    content: [`State   ${feature.plan.state}`, `Tasks   ${feature.plan.tasks.length}`].join('\n'),
+                });
+            }
+            if (feature.messages.length > 0) {
+                const last5 = feature.messages
+                    .slice(-5)
+                    .map((m) => `${colors.muted(`${m.role}:`)} ${m.content.slice(0, 80)}`)
+                    .join('\n');
+                textBlocks.push({
+                    title: `Messages (${feature.messages.length})`,
+                    content: last5,
+                });
+            }
+            renderDetailView({
+                title: `Feature: ${feature.name}`,
+                sections: [
+                    {
+                        fields: [
+                            { label: 'ID', value: feature.id },
+                            { label: 'Slug', value: feature.slug },
+                            { label: 'Description', value: feature.description },
+                            { label: 'Repository', value: feature.repositoryPath },
+                            { label: 'Branch', value: colors.accent(feature.branch) },
+                            { label: 'Status', value: formatStatus(feature, run) },
+                            { label: 'Worktree', value: worktreePath },
+                            { label: 'Spec Dir', value: feature.specPath ?? null },
+                            { label: 'Agent Run', value: feature.agentRunId ?? null },
+                        ],
+                    },
+                    {
+                        title: 'Timestamps',
+                        fields: [
+                            { label: 'Created', value: formatTs(feature.createdAt) },
+                            { label: 'Updated', value: formatTs(feature.updatedAt) },
+                        ],
+                    },
+                ],
+                textBlocks,
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to show feature', err);
+            process.exitCode = 1;
+        }
+    });
+}

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

@@ -8,10 +8,14 @@
  *   shep [command] [options]
  *
  * Commands:
- *   shep           Show help
- *   shep version   Display version information
- *   shep ui        Start the web UI
- *   shep --version Display version number only
+ *   shep              Show help
+ *   shep version      Display version information
+ *   shep ui           Start the web UI
+ *   shep run          Run an AI agent workflow
+ *   shep agent        Manage and view agent runs
+ *   shep feat         Manage features through the SDLC lifecycle
+ *   shep settings     Configure Shep settings
+ *   shep --version    Display version number only
  *
  * Global Options:
  *   -v, --version  Display version number

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,kBAAkB,CAAC"}

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

@@ -8,10 +8,14 @@
  *   shep [command] [options]
  *
  * Commands:
- *   shep           Show help
- *   shep version   Display version information
- *   shep ui        Start the web UI
- *   shep --version Display version number only
+ *   shep              Show help
+ *   shep version      Display version information
+ *   shep ui           Start the web UI
+ *   shep run          Run an AI agent workflow
+ *   shep agent        Manage and view agent runs
+ *   shep feat         Manage features through the SDLC lifecycle
+ *   shep settings     Configure Shep settings
+ *   shep --version    Display version number only
  *
  * Global Options:
  *   -v, --version  Display version number
@@ -24,6 +28,8 @@ import { createVersionCommand } from './commands/version.command.js';
 import { createSettingsCommand } from './commands/settings/index.js';
 import { createUiCommand } from './commands/ui.command.js';
 import { createRunCommand } from './commands/run.command.js';
+import { createAgentCommand } from './commands/agent/index.js';
+import { createFeatCommand } from './commands/feat/index.js';
 import { messages } from './ui/index.js';
 // DI container and settings
 import { initializeContainer, container } from '../../infrastructure/di/container.js';
@@ -70,6 +76,8 @@ async function bootstrap() {
         program.addCommand(createSettingsCommand());
         program.addCommand(createUiCommand());
         program.addCommand(createRunCommand());
+        program.addCommand(createAgentCommand());
+        program.addCommand(createFeatCommand());
         // Parse arguments (parseAsync needed for async command actions like init)
         await program.parseAsync();
     }

package/dist/src/presentation/cli/ui/detail-view.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CLI Design System - Detail View
+ *
+ * Renders clean KEY  VALUE displays for "show" commands.
+ * Aligned labels in muted color, grouped into optional sections,
+ * with support for text blocks (prompts, results, errors).
+ *
+ * @example
+ * renderDetailView({
+ *   title: 'Agent Run',
+ *   sections: [
+ *     { fields: [{ label: 'ID', value: '123' }, { label: 'Status', value: colors.success('completed') }] },
+ *     { title: 'Timing', fields: [{ label: 'Started', value: '...' }] },
+ *   ],
+ *   textBlocks: [{ title: 'Result', content: 'output here' }],
+ * });
+ */
+export interface DetailField {
+    label: string;
+    value: string | undefined | null;
+}
+export interface DetailSection {
+    title?: string;
+    fields: DetailField[];
+}
+export interface DetailTextBlock {
+    title: string;
+    content: string;
+    color?: (text: string) => string;
+}
+export interface DetailViewConfig {
+    title: string;
+    sections: DetailSection[];
+    textBlocks?: DetailTextBlock[];
+}
+/**
+ * Render a detail view to stdout.
+ *
+ * Fields with null/undefined values are silently skipped.
+ * Each section auto-aligns labels to the longest visible label in that section.
+ */
+export declare function renderDetailView(config: DetailViewConfig): void;
+//# sourceMappingURL=detail-view.d.ts.map

package/dist/src/presentation/cli/ui/detail-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-view.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/detail-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAoC/D"}

package/dist/src/presentation/cli/ui/detail-view.js

@@ -0,0 +1,57 @@
+/**
+ * CLI Design System - Detail View
+ *
+ * Renders clean KEY  VALUE displays for "show" commands.
+ * Aligned labels in muted color, grouped into optional sections,
+ * with support for text blocks (prompts, results, errors).
+ *
+ * @example
+ * renderDetailView({
+ *   title: 'Agent Run',
+ *   sections: [
+ *     { fields: [{ label: 'ID', value: '123' }, { label: 'Status', value: colors.success('completed') }] },
+ *     { title: 'Timing', fields: [{ label: 'Started', value: '...' }] },
+ *   ],
+ *   textBlocks: [{ title: 'Result', content: 'output here' }],
+ * });
+ */
+import pc from 'picocolors';
+import { colors } from './colors.js';
+import { fmt } from './formatters.js';
+/**
+ * Render a detail view to stdout.
+ *
+ * Fields with null/undefined values are silently skipped.
+ * Each section auto-aligns labels to the longest visible label in that section.
+ */
+export function renderDetailView(config) {
+    const lines = [];
+    lines.push('');
+    lines.push(`  ${fmt.heading(config.title)}`);
+    for (const section of config.sections) {
+        const visible = section.fields.filter((f) => f.value != null);
+        if (visible.length === 0)
+            continue;
+        lines.push('');
+        if (section.title) {
+            lines.push(`  ${pc.bold(section.title)}`);
+        }
+        const labelWidth = Math.max(...visible.map((f) => f.label.length)) + 2;
+        for (const field of visible) {
+            const padded = field.label.padEnd(labelWidth);
+            lines.push(`  ${colors.muted(padded)}${field.value}`);
+        }
+    }
+    if (config.textBlocks) {
+        for (const block of config.textBlocks) {
+            lines.push('');
+            lines.push(`  ${pc.bold(block.title)}`);
+            const text = block.color ? block.color(block.content) : block.content;
+            for (const line of text.split('\n')) {
+                lines.push(`  ${line}`);
+            }
+        }
+    }
+    lines.push('');
+    console.log(lines.join('\n'));
+}

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

@@ -17,4 +17,6 @@ export { fmt, type Formatters } from './formatters.js';
 export { messages, type Messages } from './messages.js';
 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';
 //# 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"}
+{"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"}

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

@@ -17,3 +17,5 @@ export { fmt } from './formatters.js';
 export { messages } from './messages.js';
 export { TableFormatter } from './tables.js';
 export { OutputFormatter } from './output.js';
+export { renderDetailView, } from './detail-view.js';
+export { renderListView } from './list-view.js';

package/dist/src/presentation/cli/ui/list-view.d.ts

@@ -0,0 +1,34 @@
+/**
+ * CLI Design System - List View
+ *
+ * Renders clean, borderless columnar tables for "ls" commands.
+ * Muted column headers, aligned values, no ASCII grid lines.
+ *
+ * @example
+ * renderListView({
+ *   title: 'Agent Runs',
+ *   columns: [
+ *     { label: 'ID', width: 10 },
+ *     { label: 'Status', width: 14 },
+ *   ],
+ *   rows: [['9144a138', colors.info('running')]],
+ * });
+ */
+export interface ListColumn {
+    label: string;
+    width: number;
+}
+export interface ListViewConfig {
+    title: string;
+    columns: ListColumn[];
+    rows: string[][];
+    emptyMessage?: string;
+}
+/**
+ * Render a list view to stdout.
+ *
+ * Columns are padded to their declared width (ANSI-aware).
+ * The last column is never padded so long values don't waste space.
+ */
+export declare function renderListView(config: ListViewConfig): void;
+//# sourceMappingURL=list-view.d.ts.map

package/dist/src/presentation/cli/ui/list-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-view.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/list-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CA+B3D"}

package/dist/src/presentation/cli/ui/list-view.js

@@ -0,0 +1,65 @@
+/**
+ * CLI Design System - List View
+ *
+ * Renders clean, borderless columnar tables for "ls" commands.
+ * Muted column headers, aligned values, no ASCII grid lines.
+ *
+ * @example
+ * renderListView({
+ *   title: 'Agent Runs',
+ *   columns: [
+ *     { label: 'ID', width: 10 },
+ *     { label: 'Status', width: 14 },
+ *   ],
+ *   rows: [['9144a138', colors.info('running')]],
+ * });
+ */
+import { colors } from './colors.js';
+import { fmt } from './formatters.js';
+import { messages } from './messages.js';
+/**
+ * Render a list view to stdout.
+ *
+ * Columns are padded to their declared width (ANSI-aware).
+ * The last column is never padded so long values don't waste space.
+ */
+export function renderListView(config) {
+    if (config.rows.length === 0) {
+        messages.newline();
+        messages.info(config.emptyMessage ?? 'No items found');
+        messages.newline();
+        return;
+    }
+    const lines = [];
+    lines.push('');
+    lines.push(`  ${fmt.heading(`${config.title} (${config.rows.length})`)}`);
+    lines.push('');
+    // Header
+    const header = config.columns.map((col) => colors.muted(col.label.padEnd(col.width))).join('  ');
+    lines.push(`  ${header}`);
+    // Data rows
+    for (const row of config.rows) {
+        const cells = row.map((cell, i) => {
+            // Don't pad the last column
+            if (i === row.length - 1)
+                return cell;
+            const width = config.columns[i]?.width ?? 10;
+            return ansiPad(cell, width);
+        });
+        lines.push(`  ${cells.join('  ')}`);
+    }
+    lines.push('');
+    console.log(lines.join('\n'));
+}
+/** Pad a string that may contain ANSI escape codes to a visible width. */
+function ansiPad(text, width) {
+    const visible = stripAnsi(text).length;
+    if (visible >= width)
+        return text;
+    return text + ' '.repeat(width - visible);
+}
+/** Strip ANSI escape sequences to get visible character count. */
+function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1B\[[0-9;]*m/g, '');
+}

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

@@ -28,8 +28,12 @@ export declare const symbols: {
     readonly pointer: "❯" | ">";
     /** Ellipsis for loading/truncation */
     readonly ellipsis: "…" | "...";
+    /** Filled status dot */
+    readonly dot: "*" | "●";
+    /** Empty status dot */
+    readonly dotEmpty: "○" | "o";
     /** Line separator */
-    readonly line: "─" | "-";
+    readonly line: "-" | "─";
     /** Spinner frames for loading animation */
     readonly spinner: string[];
 };

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

@@ -1 +1 @@
-{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB,wBAAwB;;IAExB,kBAAkB;;IAElB,uBAAuB;;IAEvB,kBAAkB;;IAElB,oBAAoB;;IAEpB,mBAAmB;;IAEnB,oBAAoB;;IAEpB,sCAAsC;;IAEtC,qBAAqB;;IAErB,2CAA2C;;CAEnC,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC"}
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB,wBAAwB;;IAExB,kBAAkB;;IAElB,uBAAuB;;IAEvB,kBAAkB;;IAElB,oBAAoB;;IAEpB,mBAAmB;;IAEnB,oBAAoB;;IAEpB,sCAAsC;;IAEtC,wBAAwB;;IAExB,uBAAuB;;IAEvB,qBAAqB;;IAErB,2CAA2C;;CAEnC,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC"}

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

@@ -58,6 +58,10 @@ export const symbols = {
     pointer: unicode ? '❯' : '>',
     /** Ellipsis for loading/truncation */
     ellipsis: unicode ? '…' : '...',
+    /** Filled status dot */
+    dot: unicode ? '●' : '*',
+    /** Empty status dot */
+    dotEmpty: unicode ? '○' : 'o',
     /** Line separator */
     line: unicode ? '─' : '-',
     /** Spinner frames for loading animation */