@shepai/cli 1.5.0 → 1.6.1

package/dist/src/infrastructure/services/agents/agent-validator.service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Agent Validator Service
+ *
+ * Infrastructure implementation of the IAgentValidator port.
+ * Checks if AI agent binaries are available on the system by
+ * executing `<binary> --version` via subprocess.
+ *
+ * Uses constructor dependency injection for the command executor
+ * to enable testability without mocking node:child_process directly.
+ */
+import type { AgentType } from '../../../domain/generated/output.js';
+import type { IAgentValidator, AgentValidationResult } from '../../../application/ports/output/agent-validator.interface.js';
+/**
+ * Type for the command executor dependency.
+ * Matches the promisified signature of child_process.execFile.
+ * Injected via constructor to avoid direct node module mocking in tests.
+ */
+export type ExecFunction = (file: string, args: string[]) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Service that validates agent tool availability on the system.
+ *
+ * Checks if the agent binary exists and is executable by running
+ * `<binary> --version` and parsing the output.
+ */
+export declare class AgentValidatorService implements IAgentValidator {
+    private readonly execFn;
+    /**
+     * @param execFn - Command executor function (injectable for testing).
+     *   Uses execFile semantics (no shell) to prevent command injection.
+     */
+    constructor(execFn: ExecFunction);
+    /**
+     * Check if the specified agent tool is available on the system.
+     *
+     * @param agentType - The agent type to check
+     * @returns Validation result with availability status and version
+     */
+    isAvailable(agentType: AgentType): Promise<AgentValidationResult>;
+}
+//# sourceMappingURL=agent-validator.service.d.ts.map

package/dist/src/infrastructure/services/agents/agent-validator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-validator.service.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/agents/agent-validator.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,gEAAgE,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,KACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AASjD;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC;;;OAGG;gBACS,MAAM,EAAE,YAAY;IAIhC;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA2BxE"}

package/dist/src/infrastructure/services/agents/agent-validator.service.js

@@ -0,0 +1,62 @@
+/**
+ * Agent Validator Service
+ *
+ * Infrastructure implementation of the IAgentValidator port.
+ * Checks if AI agent binaries are available on the system by
+ * executing `<binary> --version` via subprocess.
+ *
+ * Uses constructor dependency injection for the command executor
+ * to enable testability without mocking node:child_process directly.
+ */
+/**
+ * Map of supported agent types to their binary command names.
+ */
+const AGENT_BINARY_MAP = {
+    'claude-code': 'claude',
+};
+/**
+ * Service that validates agent tool availability on the system.
+ *
+ * Checks if the agent binary exists and is executable by running
+ * `<binary> --version` and parsing the output.
+ */
+export class AgentValidatorService {
+    execFn;
+    /**
+     * @param execFn - Command executor function (injectable for testing).
+     *   Uses execFile semantics (no shell) to prevent command injection.
+     */
+    constructor(execFn) {
+        this.execFn = execFn;
+    }
+    /**
+     * Check if the specified agent tool is available on the system.
+     *
+     * @param agentType - The agent type to check
+     * @returns Validation result with availability status and version
+     */
+    async isAvailable(agentType) {
+        const binary = AGENT_BINARY_MAP[agentType];
+        if (!binary) {
+            return {
+                available: false,
+                error: `Agent type "${agentType}" is not supported yet`,
+            };
+        }
+        try {
+            const { stdout } = await this.execFn(binary, ['--version']);
+            const version = stdout.trim();
+            return {
+                available: true,
+                version,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                available: false,
+                error: `Binary "${binary}" not found or not executable: ${message}`,
+            };
+        }
+    }
+}

package/dist/src/presentation/cli/commands/settings/agent.command.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agent Configuration Command
+ *
+ * Configures the AI coding agent used by Shep for all LLM-powered operations.
+ *
+ * Usage:
+ *   shep settings agent                                          # Interactive wizard
+ *   shep settings agent --agent claude-code --auth session       # Non-interactive
+ *   shep settings agent --agent claude-code --auth token --token sk-xxx  # Token auth
+ */
+import { Command } from 'commander';
+/**
+ * Create the agent configuration command
+ */
+export declare function createAgentCommand(): Command;
+//# sourceMappingURL=agent.command.d.ts.map

package/dist/src/presentation/cli/commands/settings/agent.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/agent.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAgE5C"}

package/dist/src/presentation/cli/commands/settings/agent.command.js

@@ -0,0 +1,75 @@
+/**
+ * Agent Configuration Command
+ *
+ * Configures the AI coding agent used by Shep for all LLM-powered operations.
+ *
+ * Usage:
+ *   shep settings agent                                          # Interactive wizard
+ *   shep settings agent --agent claude-code --auth session       # Non-interactive
+ *   shep settings agent --agent claude-code --auth token --token sk-xxx  # Token auth
+ */
+import { Command } from 'commander';
+import { container } from '../../../../infrastructure/di/container.js';
+import { ConfigureAgentUseCase, } from '../../../../application/use-cases/agents/configure-agent.use-case.js';
+import { agentConfigWizard } from '../../../tui/wizards/agent-config.wizard.js';
+import { resetSettings, initializeSettings, } from '../../../../infrastructure/services/settings.service.js';
+import { messages } from '../../ui/index.js';
+/**
+ * Create the agent configuration command
+ */
+export function createAgentCommand() {
+    return new Command('agent')
+        .description('Configure AI coding agent')
+        .option('--agent <type>', 'Agent type (e.g., claude-code)')
+        .option('--auth <method>', 'Auth method (session or token)')
+        .option('--token <key>', 'API token for token-based auth')
+        .addHelpText('after', `
+Examples:
+  $ shep settings agent                                          Interactive wizard
+  $ shep settings agent --agent claude-code --auth session       Non-interactive
+  $ shep settings agent --agent claude-code --auth token --token sk-xxx  Token auth`)
+        .action(async (options) => {
+        try {
+            const isNonInteractive = options.agent !== undefined;
+            let input;
+            if (isNonInteractive) {
+                // Non-interactive: require --auth when --agent is provided
+                if (!options.auth) {
+                    messages.error('--auth is required when using --agent flag');
+                    process.exitCode = 1;
+                    return;
+                }
+                input = {
+                    type: options.agent,
+                    authMethod: options.auth,
+                    ...(options.token !== undefined && { token: options.token }),
+                };
+            }
+            else {
+                // Interactive: launch wizard
+                const wizardResult = await agentConfigWizard();
+                input = {
+                    type: wizardResult.type,
+                    authMethod: wizardResult.authMethod,
+                    ...(wizardResult.token !== undefined && { token: wizardResult.token }),
+                };
+            }
+            const useCase = container.resolve(ConfigureAgentUseCase);
+            const updatedSettings = await useCase.execute(input);
+            // Update the in-memory settings singleton
+            resetSettings();
+            initializeSettings(updatedSettings);
+            messages.success(`Agent configured: ${input.type} (${input.authMethod})`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            // Handle user cancellation (Ctrl+C) gracefully
+            if (err.message.includes('force closed') || err.message.includes('User force closed')) {
+                messages.info('Configuration cancelled.');
+                return;
+            }
+            messages.error('Failed to configure agent', err);
+            process.exitCode = 1;
+        }
+    });
+}

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

@@ -6,6 +6,7 @@
  * Usage:
  *   shep settings show     # Display current settings
  *   shep settings init     # Initialize settings to defaults
+ *   shep settings agent    # Configure AI coding agent
  */
 import { Command } from 'commander';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAK/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAM/C"}

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

@@ -6,10 +6,12 @@
  * Usage:
  *   shep settings show     # Display current settings
  *   shep settings init     # Initialize settings to defaults
+ *   shep settings agent    # Configure AI coding agent
  */
 import { Command } from 'commander';
 import { createShowCommand } from './show.command.js';
 import { createInitCommand } from './init.command.js';
+import { createAgentCommand } from './agent.command.js';
 /**
  * Create the settings command group
  */
@@ -17,5 +19,6 @@ export function createSettingsCommand() {
     return new Command('settings')
         .description('Manage Shep global settings')
         .addCommand(createShowCommand())
-        .addCommand(createInitCommand());
+        .addCommand(createInitCommand())
+        .addCommand(createAgentCommand());
 }

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

@@ -1 +1 @@
-{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAO5C;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA6C3C"}
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAO5C;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA+B3C"}

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

@@ -13,7 +13,7 @@ import { OutputFormatter } from '../../ui/output.js';
 import { getShepDbPath } from '../../../../infrastructure/services/filesystem/shep-directory.service.js';
 import { getSettings } from '../../../../infrastructure/services/settings.service.js';
 import { statSync } from 'node:fs';
-import { messages, fmt } from '../../ui/index.js';
+import { messages } from '../../ui/index.js';
 /**
  * Create the show settings command
  */
@@ -31,24 +31,10 @@ Examples:
         .action((options) => {
         try {
             const settings = getSettings();
-            const output = OutputFormatter.format(settings, options.output);
+            // Build database metadata for table format
+            const dbMeta = options.output === 'table' ? getDatabaseMeta() : undefined;
+            const output = OutputFormatter.format(settings, options.output, dbMeta);
             console.log(output);
-            // Show database metadata for table format
-            if (options.output === 'table') {
-                const dbPath = getShepDbPath();
-                let sizeStr = 'unknown';
-                try {
-                    const stats = statSync(dbPath);
-                    sizeStr = formatFileSize(stats.size);
-                }
-                catch {
-                    // File may not be accessible
-                }
-                messages.newline();
-                console.log(fmt.heading('Database'));
-                console.log(`  ${fmt.label('Path:')}  ${dbPath}`);
-                console.log(`  ${fmt.label('Size:')}  ${sizeStr}`);
-            }
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
@@ -57,6 +43,18 @@ Examples:
         }
     });
 }
+function getDatabaseMeta() {
+    const dbPath = getShepDbPath();
+    let size = 'unknown';
+    try {
+        const stats = statSync(dbPath);
+        size = formatFileSize(stats.size);
+    }
+    catch {
+        // File may not be accessible
+    }
+    return { path: dbPath, size };
+}
 function formatFileSize(bytes) {
     if (bytes < 1024)
         return `${bytes} B`;

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

@@ -15,6 +15,6 @@ export { colors, type Colors } from './colors.js';
 export { symbols, type Symbols } from './symbols.js';
 export { fmt, type Formatters } from './formatters.js';
 export { messages, type Messages } from './messages.js';
-export { TableFormatter } from './tables.js';
+export { TableFormatter, type DatabaseMeta } from './tables.js';
 export { OutputFormatter, type OutputFormat } from './output.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,MAAM,aAAa,CAAC;AAC7C,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"}

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

@@ -2,12 +2,13 @@
  * Output Format Utilities
  *
  * Provides utilities for formatting output in multiple formats:
- * - Table (default, using cli-table3)
+ * - Table (default, clean text-based layout)
  * - JSON (structured data)
  * - YAML (human-readable structured data)
  *
  * @module output
  */
+import { type DatabaseMeta } from './tables.js';
 export type OutputFormat = 'table' | 'json' | 'yaml';
 /**
  * Output formatter for multiple formats
@@ -16,11 +17,11 @@ export declare class OutputFormatter {
     /**
      * Formats data according to the specified output format
      */
-    static format(data: unknown, format: OutputFormat): string;
+    static format(data: unknown, format: OutputFormat, dbMeta?: DatabaseMeta): string;
     /**
-     * Formats data as a table
+     * Formats data as a clean text display
      */
-    static formatAsTable(data: unknown): string;
+    static formatAsTable(data: unknown, dbMeta?: DatabaseMeta): string;
     /**
      * Formats data as JSON
      */

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

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;IAW1D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAK3C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAI1C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;CAG3C"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAWjF;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAIlE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAI1C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;CAG3C"}

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

@@ -2,7 +2,7 @@
  * Output Format Utilities
  *
  * Provides utilities for formatting output in multiple formats:
- * - Table (default, using cli-table3)
+ * - Table (default, clean text-based layout)
  * - JSON (structured data)
  * - YAML (human-readable structured data)
  *
@@ -17,10 +17,10 @@ export class OutputFormatter {
     /**
      * Formats data according to the specified output format
      */
-    static format(data, format) {
+    static format(data, format, dbMeta) {
         switch (format) {
             case 'table':
-                return OutputFormatter.formatAsTable(data);
+                return OutputFormatter.formatAsTable(data, dbMeta);
             case 'json':
                 return OutputFormatter.formatAsJSON(data);
             case 'yaml':
@@ -28,11 +28,10 @@ export class OutputFormatter {
         }
     }
     /**
-     * Formats data as a table
+     * Formats data as a clean text display
      */
-    static formatAsTable(data) {
-        const table = TableFormatter.createSettingsTable(data);
-        return table.toString();
+    static formatAsTable(data, dbMeta) {
+        return TableFormatter.createSettingsTable(data, dbMeta);
     }
     /**
      * Formats data as JSON

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

@@ -1,19 +1,24 @@
 /**
  * Table Formatting Utilities
  *
- * Provides utilities for rendering structured data as formatted tables
- * in the terminal using cli-table3.
+ * Provides clean text-based rendering for structured CLI output.
+ * Uses alignment, whitespace, and colors instead of box-drawing borders.
  *
  * @module tables
  */
-import Table from 'cli-table3';
+export interface DatabaseMeta {
+    path: string;
+    size: string;
+}
 /**
  * Table formatter for CLI output
  */
 export declare class TableFormatter {
+    private static readonly LABEL_WIDTH;
     /**
-     * Creates a formatted table for settings data
+     * Creates a clean, formatted settings display string.
      */
-    static createSettingsTable(settings: unknown): InstanceType<typeof Table>;
+    static createSettingsTable(settings: unknown, dbMeta?: DatabaseMeta): string;
+    private static section;
 }
 //# sourceMappingURL=tables.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/tables.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,YAAY,CAAC;AAG/B;;GAEG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,CAAC,OAAO,KAAK,CAAC;CAwC1E"}
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/tables.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAM;IAEzC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAgE5E,OAAO,CAAC,MAAM,CAAC,OAAO;CAcvB"}

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

@@ -1,32 +1,77 @@
 /**
  * Table Formatting Utilities
  *
- * Provides utilities for rendering structured data as formatted tables
- * in the terminal using cli-table3.
+ * Provides clean text-based rendering for structured CLI output.
+ * Uses alignment, whitespace, and colors instead of box-drawing borders.
  *
  * @module tables
  */
-import Table from 'cli-table3';
+import { colors } from './colors.js';
+import pc from 'picocolors';
 /**
  * Table formatter for CLI output
  */
 export class TableFormatter {
+    static LABEL_WIDTH = 15;
     /**
-     * Creates a formatted table for settings data
+     * Creates a clean, formatted settings display string.
      */
-    static createSettingsTable(settings) {
+    static createSettingsTable(settings, dbMeta) {
         const s = settings;
-        const table = new Table({
-            style: { head: [], border: [] },
-        });
-        // Models section
-        table.push([{ colSpan: 2, content: 'Models', hAlign: 'center' }], ['Analyze', s.models.analyze], ['Requirements', s.models.requirements], ['Plan', s.models.plan], ['Implement', s.models.implement]);
-        // User section
-        table.push([{ colSpan: 2, content: 'User', hAlign: 'center' }], ['Name', s.user.name ?? '(not set)'], ['Email', s.user.email ?? '(not set)'], ['GitHub', s.user.githubUsername ?? '(not set)']);
-        // Environment section
-        table.push([{ colSpan: 2, content: 'Environment', hAlign: 'center' }], ['Editor', s.environment.defaultEditor], ['Shell', s.environment.shellPreference]);
-        // System section
-        table.push([{ colSpan: 2, content: 'System', hAlign: 'center' }], ['Auto-Update', String(s.system.autoUpdate)], ['Log Level', s.system.logLevel]);
-        return table;
+        const lines = [];
+        lines.push(`  ${pc.bold(colors.brand('Settings'))}`);
+        lines.push('');
+        // Models
+        lines.push(...TableFormatter.section('Models', [
+            ['Analyze', s.models.analyze],
+            ['Requirements', s.models.requirements],
+            ['Plan', s.models.plan],
+            ['Implement', s.models.implement],
+        ]));
+        // User
+        lines.push(...TableFormatter.section('User', [
+            ['Name', s.user.name],
+            ['Email', s.user.email],
+            ['GitHub', s.user.githubUsername],
+        ]));
+        // Environment
+        lines.push(...TableFormatter.section('Environment', [
+            ['Editor', s.environment.defaultEditor],
+            ['Shell', s.environment.shellPreference],
+        ]));
+        // System
+        lines.push(...TableFormatter.section('System', [
+            ['Auto-Update', String(s.system.autoUpdate)],
+            ['Log Level', s.system.logLevel],
+        ]));
+        // Agent
+        lines.push(...TableFormatter.section('Agent', [
+            ['Type', s.agent.type],
+            ['Auth', s.agent.authMethod],
+            ...(s.agent.token ? [['Token', '••••••••']] : []),
+        ]));
+        // Database
+        if (dbMeta) {
+            lines.push(...TableFormatter.section('Database', [
+                ['Path', dbMeta.path],
+                ['Size', dbMeta.size],
+            ]));
+        }
+        return lines.join('\n');
+    }
+    static section(title, rows) {
+        const lines = [];
+        lines.push(`  ${pc.bold(title)}`);
+        for (const [label, value] of rows) {
+            const paddedLabel = label.padEnd(TableFormatter.LABEL_WIDTH);
+            if (value === undefined || value === null) {
+                lines.push(`    ${colors.muted(paddedLabel)}${pc.italic(colors.muted('(not set)'))}`);
+            }
+            else {
+                lines.push(`    ${colors.muted(paddedLabel)}${value}`);
+            }
+        }
+        lines.push('');
+        return lines;
     }
 }

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

@@ -0,0 +1,3 @@
+export { agentConfigWizard, type AgentConfigResult } from './wizards/agent-config.wizard.js';
+export { shepTheme } from './themes/shep.theme.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/tui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { agentConfigWizard } from './wizards/agent-config.wizard.js';
+export { shepTheme } from './themes/shep.theme.js';

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

@@ -0,0 +1,48 @@
+/**
+ * Agent Select Prompt Configuration
+ *
+ * Configuration for the @inquirer/select prompt that lets users
+ * choose their AI coding agent.
+ */
+import { AgentType } from '@/domain/generated/output.js';
+/**
+ * Creates the @inquirer/select configuration for selecting an AI coding agent.
+ *
+ * Only Claude Code is currently available. Other agents are shown as
+ * disabled with a "Coming Soon" badge.
+ */
+export declare function createAgentSelectConfig(): {
+    readonly message: "Select your AI coding agent";
+    readonly choices: readonly [{
+        readonly name: "Claude Code";
+        readonly value: AgentType.ClaudeCode;
+        readonly description: "Anthropic Claude Code CLI";
+    }, {
+        readonly name: "Gemini CLI";
+        readonly value: AgentType.GeminiCli;
+        readonly disabled: "(Coming Soon)";
+    }, {
+        readonly name: "Aider";
+        readonly value: AgentType.Aider;
+        readonly disabled: "(Coming Soon)";
+    }, {
+        readonly name: "Continue";
+        readonly value: AgentType.Continue;
+        readonly disabled: "(Coming Soon)";
+    }, {
+        readonly name: "Cursor";
+        readonly value: AgentType.Cursor;
+        readonly disabled: "(Coming Soon)";
+    }];
+    readonly theme: {
+        readonly prefix: {
+            readonly idle: string;
+            readonly done: string;
+        };
+        readonly style: {
+            readonly highlight: import("picocolors/types.js").Formatter;
+            readonly answer: import("picocolors/types.js").Formatter;
+        };
+    };
+};
+//# sourceMappingURL=agent-select.prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-select.prompt.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/tui/prompts/agent-select.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD;;;;;GAKG;AACH,wBAAgB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCtC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Agent Select Prompt Configuration
+ *
+ * Configuration for the @inquirer/select prompt that lets users
+ * choose their AI coding agent.
+ */
+import { AgentType } from '@/domain/generated/output.js';
+import { shepTheme } from '../themes/shep.theme.js';
+/**
+ * Creates the @inquirer/select configuration for selecting an AI coding agent.
+ *
+ * Only Claude Code is currently available. Other agents are shown as
+ * disabled with a "Coming Soon" badge.
+ */
+export function createAgentSelectConfig() {
+    return {
+        message: 'Select your AI coding agent',
+        choices: [
+            {
+                name: 'Claude Code',
+                value: AgentType.ClaudeCode,
+                description: 'Anthropic Claude Code CLI',
+            },
+            {
+                name: 'Gemini CLI',
+                value: AgentType.GeminiCli,
+                disabled: '(Coming Soon)',
+            },
+            {
+                name: 'Aider',
+                value: AgentType.Aider,
+                disabled: '(Coming Soon)',
+            },
+            {
+                name: 'Continue',
+                value: AgentType.Continue,
+                disabled: '(Coming Soon)',
+            },
+            {
+                name: 'Cursor',
+                value: AgentType.Cursor,
+                disabled: '(Coming Soon)',
+            },
+        ],
+        theme: shepTheme,
+    };
+}