@shepai/cli 1.3.0 → 1.4.0

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

@@ -0,0 +1,15 @@
+/**
+ * Settings Command Group
+ *
+ * Provides subcommands for managing Shep global settings.
+ *
+ * Usage:
+ *   shep settings show     # Display current settings
+ *   shep settings init     # Initialize settings to defaults
+ */
+import { Command } from 'commander';
+/**
+ * Create the settings command group
+ */
+export declare function createSettingsCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,21 @@
+/**
+ * Settings Command Group
+ *
+ * Provides subcommands for managing Shep global settings.
+ *
+ * Usage:
+ *   shep settings show     # Display current settings
+ *   shep settings init     # Initialize settings to defaults
+ */
+import { Command } from 'commander';
+import { createShowCommand } from './show.command.js';
+import { createInitCommand } from './init.command.js';
+/**
+ * Create the settings command group
+ */
+export function createSettingsCommand() {
+    return new Command('settings')
+        .description('Manage Shep global settings')
+        .addCommand(createShowCommand())
+        .addCommand(createInitCommand());
+}

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

@@ -0,0 +1,15 @@
+/**
+ * Init Settings Command
+ *
+ * Re-initializes Shep settings to defaults with confirmation prompt.
+ *
+ * Usage:
+ *   shep settings init          # Prompt for confirmation
+ *   shep settings init --force  # Skip confirmation
+ */
+import { Command } from 'commander';
+/**
+ * Create the init settings command
+ */
+export declare function createInitCommand(): Command;
+//# sourceMappingURL=init.command.d.ts.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * Init Settings Command
+ *
+ * Re-initializes Shep settings to defaults with confirmation prompt.
+ *
+ * Usage:
+ *   shep settings init          # Prompt for confirmation
+ *   shep settings init --force  # Skip confirmation
+ */
+import { Command } from 'commander';
+import { createInterface } from 'node:readline';
+import { createDefaultSettings } from '../../../../domain/factories/settings-defaults.factory.js';
+import { resetSettings, initializeSettings, } from '../../../../infrastructure/services/settings.service.js';
+import { messages } from '../../ui/index.js';
+/**
+ * Prompt user for yes/no confirmation.
+ * Returns false on EOF (no stdin) to prevent silent modifications.
+ */
+function confirm(message) {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        let answered = false;
+        rl.question(message, (answer) => {
+            answered = true;
+            rl.close();
+            resolve(answer.toLowerCase() === 'y');
+        });
+        rl.on('close', () => {
+            if (!answered) {
+                resolve(false);
+            }
+        });
+    });
+}
+/**
+ * Create the init settings command
+ */
+export function createInitCommand() {
+    return new Command('init')
+        .description('Initialize settings to defaults')
+        .option('-f, --force', 'Skip confirmation prompt')
+        .addHelpText('after', `
+Examples:
+  $ shep settings init           Prompt for confirmation before reset
+  $ shep settings init --force   Reset settings without prompting
+  $ shep settings init -f        Same as --force (short flag)`)
+        .action(async (options) => {
+        try {
+            if (!options.force) {
+                messages.warning('This will reset all settings to defaults. Consider backing up ~/.shep/data first.');
+                const confirmed = await confirm('Are you sure? (y/N): ');
+                if (!confirmed) {
+                    messages.info('Operation cancelled.');
+                    return;
+                }
+            }
+            const newSettings = createDefaultSettings();
+            resetSettings();
+            initializeSettings(newSettings);
+            messages.success('Settings initialized to defaults.');
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to initialize settings', err);
+            process.exitCode = 1;
+        }
+    });
+}

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

@@ -0,0 +1,16 @@
+/**
+ * Show Settings Command
+ *
+ * Displays current Shep settings with multiple output format support.
+ *
+ * Usage:
+ *   shep settings show                 # Display as table (default)
+ *   shep settings show --output json   # Display as JSON
+ *   shep settings show -o yaml         # Display as YAML
+ */
+import { Command } from 'commander';
+/**
+ * Create the show settings command
+ */
+export declare function createShowCommand(): Command;
+//# sourceMappingURL=show.command.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,66 @@
+/**
+ * Show Settings Command
+ *
+ * Displays current Shep settings with multiple output format support.
+ *
+ * Usage:
+ *   shep settings show                 # Display as table (default)
+ *   shep settings show --output json   # Display as JSON
+ *   shep settings show -o yaml         # Display as YAML
+ */
+import { Command, Option } from 'commander';
+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';
+/**
+ * Create the show settings command
+ */
+export function createShowCommand() {
+    return new Command('show')
+        .description('Display current settings')
+        .addOption(new Option('-o, --output <format>', 'Output format: table|json|yaml')
+        .choices(['table', 'json', 'yaml'])
+        .default('table'))
+        .addHelpText('after', `
+Examples:
+  $ shep settings show                 Display settings as table
+  $ shep settings show --output json   Display settings as JSON
+  $ shep settings show -o yaml         Display settings as YAML`)
+        .action((options) => {
+        try {
+            const settings = getSettings();
+            const output = OutputFormatter.format(settings, options.output);
+            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));
+            messages.error('Failed to load settings', err);
+            process.exitCode = 1;
+        }
+    });
+}
+function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}

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

@@ -21,6 +21,7 @@ import 'reflect-metadata';
 import { Command } from 'commander';
 import { VersionService } from '../../infrastructure/services/version.service.js';
 import { createVersionCommand } from './commands/version.command.js';
+import { createSettingsCommand } from './commands/settings/index.js';
 import { messages } from './ui/index.js';
 // DI container and settings
 import { initializeContainer, container } from '../../infrastructure/di/container.js';
@@ -64,8 +65,9 @@ async function bootstrap() {
         });
         // Register commands
         program.addCommand(createVersionCommand());
-        // Parse arguments
-        program.parse();
+        program.addCommand(createSettingsCommand());
+        // Parse arguments (parseAsync needed for async command actions like init)
+        await program.parseAsync();
     }
     catch (_error) {
         // Final catch - already logged specific error above

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

@@ -15,4 +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 { 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"}
+{"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"}

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

@@ -15,3 +15,5 @@ export { colors } from './colors.js';
 export { symbols } from './symbols.js';
 export { fmt } from './formatters.js';
 export { messages } from './messages.js';
+export { TableFormatter } from './tables.js';
+export { OutputFormatter } from './output.js';

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

@@ -0,0 +1,33 @@
+/**
+ * Output Format Utilities
+ *
+ * Provides utilities for formatting output in multiple formats:
+ * - Table (default, using cli-table3)
+ * - JSON (structured data)
+ * - YAML (human-readable structured data)
+ *
+ * @module output
+ */
+export type OutputFormat = 'table' | 'json' | 'yaml';
+/**
+ * Output formatter for multiple formats
+ */
+export declare class OutputFormatter {
+    /**
+     * Formats data according to the specified output format
+     */
+    static format(data: unknown, format: OutputFormat): string;
+    /**
+     * Formats data as a table
+     */
+    static formatAsTable(data: unknown): string;
+    /**
+     * Formats data as JSON
+     */
+    static formatAsJSON(data: unknown): string;
+    /**
+     * Formats data as YAML
+     */
+    static formatAsYAML(data: unknown): string;
+}
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,49 @@
+/**
+ * Output Format Utilities
+ *
+ * Provides utilities for formatting output in multiple formats:
+ * - Table (default, using cli-table3)
+ * - JSON (structured data)
+ * - YAML (human-readable structured data)
+ *
+ * @module output
+ */
+import yaml from 'js-yaml';
+import { TableFormatter } from './tables.js';
+/**
+ * Output formatter for multiple formats
+ */
+export class OutputFormatter {
+    /**
+     * Formats data according to the specified output format
+     */
+    static format(data, format) {
+        switch (format) {
+            case 'table':
+                return OutputFormatter.formatAsTable(data);
+            case 'json':
+                return OutputFormatter.formatAsJSON(data);
+            case 'yaml':
+                return OutputFormatter.formatAsYAML(data);
+        }
+    }
+    /**
+     * Formats data as a table
+     */
+    static formatAsTable(data) {
+        const table = TableFormatter.createSettingsTable(data);
+        return table.toString();
+    }
+    /**
+     * Formats data as JSON
+     */
+    static formatAsJSON(data) {
+        return JSON.stringify(data, null, 2);
+    }
+    /**
+     * Formats data as YAML
+     */
+    static formatAsYAML(data) {
+        return yaml.dump(data, { indent: 2, lineWidth: -1 });
+    }
+}

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

@@ -0,0 +1,19 @@
+/**
+ * Table Formatting Utilities
+ *
+ * Provides utilities for rendering structured data as formatted tables
+ * in the terminal using cli-table3.
+ *
+ * @module tables
+ */
+import Table from 'cli-table3';
+/**
+ * Table formatter for CLI output
+ */
+export declare class TableFormatter {
+    /**
+     * Creates a formatted table for settings data
+     */
+    static createSettingsTable(settings: unknown): InstanceType<typeof Table>;
+}
+//# sourceMappingURL=tables.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,32 @@
+/**
+ * Table Formatting Utilities
+ *
+ * Provides utilities for rendering structured data as formatted tables
+ * in the terminal using cli-table3.
+ *
+ * @module tables
+ */
+import Table from 'cli-table3';
+/**
+ * Table formatter for CLI output
+ */
+export class TableFormatter {
+    /**
+     * Creates a formatted table for settings data
+     */
+    static createSettingsTable(settings) {
+        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;
+    }
+}