@ace-sdk/cli 2.0.0

package/dist/commands/summarize.js

@@ -0,0 +1,167 @@
+/**
+ * Session summarization command
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { getRecorder } from '../services/recorder.js';
+import { globalOptions } from '../cli.js';
+import { Logger } from '../services/logger.js';
+import { createContext } from '../types/config.js';
+import { ACEServerClient } from '../services/server-client.js';
+import chalk from 'chalk';
+/**
+ * Summarize a recorded session
+ */
+export async function summarizeCommand(sessionIdOrFile, options = {}) {
+    const logger = new Logger(globalOptions);
+    try {
+        // Determine if input is a session ID, file path, or stdin
+        let sessionData;
+        let sessionId;
+        if (options.stdin) {
+            // Read from stdin
+            logger.debug('Loading session from stdin');
+            const stdinData = readFileSync(0, 'utf8'); // fd 0 is stdin
+            sessionData = JSON.parse(stdinData.trim());
+            sessionId = sessionData.metadata?.id || 'stdin';
+        }
+        else if (!sessionIdOrFile) {
+            throw new Error('Must provide either a session ID/file or use --stdin');
+        }
+        else if (existsSync(sessionIdOrFile)) {
+            // It's a file path
+            logger.debug(`Loading session from file: ${sessionIdOrFile}`);
+            const fileContent = readFileSync(sessionIdOrFile, 'utf8');
+            sessionData = JSON.parse(fileContent);
+            sessionId = sessionData.metadata?.id || 'unknown';
+        }
+        else {
+            // It's a session ID - load from recorder
+            logger.debug(`Loading session from recorder: ${sessionIdOrFile}`);
+            const recorder = getRecorder();
+            sessionData = recorder.getSession(sessionIdOrFile);
+            sessionId = sessionIdOrFile;
+        }
+        // Get config and create client
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        // Fetch server config for defaults
+        const serverConfig = await client.getConfig();
+        const runtimeSettings = serverConfig?.runtime_settings || {};
+        const effectiveStyle = runtimeSettings.summarizationStyle || 'short';
+        const effectiveMaxTokens = runtimeSettings.summarizationMaxTokens || 1000;
+        logger.debug(`Summarization settings: style=${effectiveStyle}, max_tokens=${effectiveMaxTokens}`);
+        // Show spinner
+        const spinner = logger.spinner('Analyzing session...');
+        // Send to server for summarization (server will use runtime settings)
+        const summary = await client.summarizeSession(sessionData);
+        spinner?.succeed();
+        // Format output based on requested format (CLI option > 'text' default)
+        const format = options.format || 'text';
+        if (logger.isJson() || format === 'json') {
+            // JSON output
+            const output = {
+                session_id: sessionId,
+                summary: summary.summary,
+                key_events: summary.key_events,
+                insights: summary.insights,
+                duration_ms: summary.duration_ms,
+                event_count: summary.event_count
+            };
+            if (options.output) {
+                writeFileSync(options.output, JSON.stringify(output, null, 2));
+                logger.success(`Summary saved to ${options.output}`);
+            }
+            else {
+                logger.output(output);
+            }
+        }
+        else if (format === 'markdown') {
+            // Markdown output
+            const markdown = formatSummaryAsMarkdown(sessionId, summary);
+            if (options.output) {
+                writeFileSync(options.output, markdown);
+                logger.success(`Summary saved to ${options.output}`);
+            }
+            else {
+                console.log(markdown);
+            }
+        }
+        else {
+            // Text output (default)
+            displaySummaryAsText(logger, sessionId, summary);
+            if (options.output) {
+                const markdown = formatSummaryAsMarkdown(sessionId, summary);
+                writeFileSync(options.output, markdown);
+                logger.success(`\nSummary saved to ${options.output}`);
+            }
+        }
+    }
+    catch (error) {
+        if (logger.isJson()) {
+            logger.output({
+                success: false,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+        else {
+            logger.error('Failed to summarize session', error instanceof Error ? error : String(error));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Display summary as formatted text
+ */
+function displaySummaryAsText(logger, sessionId, summary) {
+    logger.info(chalk.bold(`\n📊 Session Summary: ${sessionId}\n`));
+    // Duration and event count
+    const durationSeconds = (summary.duration_ms / 1000).toFixed(1);
+    logger.info(chalk.dim(`Duration: ${durationSeconds}s | Events: ${summary.event_count}\n`));
+    // Summary
+    logger.info(chalk.bold('Summary:'));
+    logger.info(summary.summary);
+    logger.info('');
+    // Key events
+    if (summary.key_events && summary.key_events.length > 0) {
+        logger.info(chalk.bold('Key Events:'));
+        for (const event of summary.key_events) {
+            const timestamp = new Date(event.timestamp).toLocaleTimeString();
+            logger.info(chalk.dim(`  [${timestamp}]`) + ` ${event.type}: ${event.description}`);
+        }
+        logger.info('');
+    }
+    // Insights
+    if (summary.insights && summary.insights.length > 0) {
+        logger.info(chalk.bold('Insights:'));
+        for (const insight of summary.insights) {
+            logger.info(chalk.cyan(`  • ${insight}`));
+        }
+        logger.info('');
+    }
+}
+/**
+ * Format summary as markdown
+ */
+function formatSummaryAsMarkdown(sessionId, summary) {
+    const durationSeconds = (summary.duration_ms / 1000).toFixed(1);
+    let markdown = `# Session Summary: ${sessionId}\n\n`;
+    markdown += `**Duration:** ${durationSeconds}s | **Events:** ${summary.event_count}\n\n`;
+    markdown += `## Summary\n\n${summary.summary}\n\n`;
+    if (summary.key_events && summary.key_events.length > 0) {
+        markdown += `## Key Events\n\n`;
+        for (const event of summary.key_events) {
+            const timestamp = new Date(event.timestamp).toLocaleTimeString();
+            markdown += `- **[${timestamp}]** ${event.type}: ${event.description}\n`;
+        }
+        markdown += '\n';
+    }
+    if (summary.insights && summary.insights.length > 0) {
+        markdown += `## Insights\n\n`;
+        for (const insight of summary.insights) {
+            markdown += `- ${insight}\n`;
+        }
+        markdown += '\n';
+    }
+    return markdown;
+}
+//# sourceMappingURL=summarize.js.map

package/dist/commands/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../src/commands/summarize.ts"],"names":[],"mappings":"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"}

package/dist/commands/top.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Top patterns command
+ */
+interface TopOptions {
+    section?: string;
+    limit?: number;
+    minHelpful?: number;
+}
+/**
+ * Show top-rated patterns
+ */
+export declare function topCommand(options: TopOptions): Promise<void>;
+export {};
+//# sourceMappingURL=top.d.ts.map

package/dist/commands/top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"top.d.ts","sourceRoot":"","sources":["../../src/commands/top.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,UAAU,UAAU;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,iBAmDnD"}

package/dist/commands/top.js

@@ -0,0 +1,58 @@
+/**
+ * Top patterns command
+ */
+import { globalOptions } from '../cli.js';
+import { createContext } from '../types/config.js';
+import { ACEServerClient } from '../services/server-client.js';
+import { formatSearchResults } from '../formatters/search-formatter.js';
+import { Logger } from '../services/logger.js';
+import chalk from 'chalk';
+/**
+ * Show top-rated patterns
+ */
+export async function topCommand(options) {
+    const logger = new Logger(globalOptions);
+    const spinner = logger.spinner('Fetching top patterns...');
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        // Fetch server config for defaults
+        const serverConfig = await client.getConfig();
+        const runtimeSettings = serverConfig?.runtime_settings || {};
+        // NOTE: search_top_k is a top-level server config field (tune command), not in runtime_settings
+        const effectiveLimit = options.limit ?? serverConfig?.search_top_k ?? 10;
+        const effectiveMinHelpful = options.minHelpful ?? runtimeSettings.patternMinHelpful ?? 0;
+        logger.debug(`Top patterns: limit=${effectiveLimit}, min_helpful=${effectiveMinHelpful}`);
+        const patterns = await client.getTopPatterns({
+            section: options.section,
+            limit: effectiveLimit,
+            min_helpful: effectiveMinHelpful
+        });
+        spinner?.succeed(`Found ${patterns.length} top patterns`);
+        if (logger.isJson()) {
+            logger.output({ patterns });
+        }
+        else {
+            if (!patterns || patterns.length === 0) {
+                logger.info(chalk.yellow('\n⚠️  No patterns found\n'));
+                return;
+            }
+            logger.info(chalk.bold(`\n⭐ Top ${effectiveLimit} Patterns\n`));
+            formatSearchResults(patterns, {
+                showRank: true,
+                verbose: logger.isVerbose()
+            });
+        }
+    }
+    catch (error) {
+        spinner?.fail('Failed to fetch top patterns');
+        if (logger.isJson()) {
+            logger.error(error instanceof Error ? error.message : String(error));
+        }
+        else {
+            logger.error(chalk.red(`\nError: ${error instanceof Error ? error.message : String(error)}\n`));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=top.js.map

package/dist/commands/top.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"top.js","sourceRoot":"","sources":["../../src/commands/top.ts"],"names":[],"mappings":"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"}

package/dist/commands/tune.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tune command - Adjust ACE thresholds and settings
+ */
+/**
+ * Tune command options - maps to actual server ConfigUpdateRequest fields
+ */
+interface TuneOptions {
+    scope?: 'project';
+    dedupSimilarityThreshold?: number;
+    dedupEnabled?: boolean;
+    constitutionThreshold?: number;
+    pruningThreshold?: number;
+    maxPlaybookTokens?: number;
+    tokenBudgetEnforcement?: boolean;
+    maxBatchSize?: number;
+    autoLearningEnabled?: boolean;
+    reflectorEnabled?: boolean;
+    curatorEnabled?: boolean;
+    searchTopK?: number;
+}
+/**
+ * Tune command - Interactive or flags mode
+ */
+export declare function tuneCommand(options?: TuneOptions): Promise<void>;
+/**
+ * Show current effective configuration
+ */
+export declare function tuneShowCommand(): Promise<void>;
+/**
+ * Reset configuration to defaults
+ */
+export declare function tuneResetCommand(options?: {
+    scope?: 'project';
+}): Promise<void>;
+export {};
+//# sourceMappingURL=tune.d.ts.map

package/dist/commands/tune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tune.d.ts","sourceRoot":"","sources":["../../src/commands/tune.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;GAEG;AACH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,iBAa1D;AAoRD;;GAEG;AACH,wBAAsB,eAAe,kBAmDpC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAO,iBA8BzE"}

package/dist/commands/tune.js

@@ -0,0 +1,354 @@
+/**
+ * Tune command - Adjust ACE thresholds and settings
+ */
+import { createInterface } from 'readline';
+import { globalOptions } from '../cli.js';
+import { createContext } from '../types/config.js';
+import { ACEServerClient } from '../services/server-client.js';
+import { Logger } from '../services/logger.js';
+import chalk from 'chalk';
+/**
+ * Tune command - Interactive or flags mode
+ */
+export async function tuneCommand(options = {}) {
+    const logger = new Logger(globalOptions);
+    // Check if any flags were provided (non-interactive mode)
+    const hasFlags = Object.keys(options).length > 1 || (Object.keys(options).length === 1 && !options.scope);
+    if (hasFlags) {
+        // Flags mode (automation-friendly)
+        return await tuneNonInteractive(options, logger);
+    }
+    else {
+        // Interactive mode
+        return await tuneInteractive(options, logger);
+    }
+}
+/**
+ * Non-interactive tune mode (flags)
+ */
+async function tuneNonInteractive(options, logger) {
+    const spinner = logger.spinner('Updating configuration...');
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        // Build settings object from flags using actual server field names
+        const settings = {};
+        if (options.dedupSimilarityThreshold !== undefined)
+            settings.dedup_similarity_threshold = options.dedupSimilarityThreshold;
+        if (options.dedupEnabled !== undefined)
+            settings.dedup_enabled = options.dedupEnabled;
+        if (options.constitutionThreshold !== undefined)
+            settings.constitution_threshold = options.constitutionThreshold;
+        if (options.pruningThreshold !== undefined)
+            settings.pruning_threshold = options.pruningThreshold;
+        if (options.maxPlaybookTokens !== undefined)
+            settings.max_playbook_tokens = options.maxPlaybookTokens;
+        if (options.tokenBudgetEnforcement !== undefined)
+            settings.token_budget_enforcement = options.tokenBudgetEnforcement;
+        if (options.maxBatchSize !== undefined)
+            settings.max_batch_size = options.maxBatchSize;
+        if (options.autoLearningEnabled !== undefined)
+            settings.auto_learning_enabled = options.autoLearningEnabled;
+        if (options.reflectorEnabled !== undefined)
+            settings.reflector_enabled = options.reflectorEnabled;
+        if (options.curatorEnabled !== undefined)
+            settings.curator_enabled = options.curatorEnabled;
+        if (options.searchTopK !== undefined)
+            settings.search_top_k = options.searchTopK;
+        if (Object.keys(settings).length === 0) {
+            throw new Error('No settings provided. Use --dedup-threshold, --constitution-threshold, etc.');
+        }
+        const scope = options.scope || 'project';
+        const result = await client.updateConfig(settings, scope);
+        spinner?.succeed('Configuration updated');
+        if (logger.isJson()) {
+            logger.output({
+                success: true,
+                scope,
+                updated: settings,
+                config: result
+            });
+        }
+        else {
+            logger.info(chalk.green('\n✅ Configuration updated successfully\n'));
+            logger.info(chalk.bold('Updated Settings:'));
+            for (const [key, value] of Object.entries(settings)) {
+                logger.info(`  ${chalk.cyan(key)}: ${value}`);
+            }
+            logger.info('');
+        }
+    }
+    catch (error) {
+        spinner?.fail('Failed to update configuration');
+        if (logger.isJson()) {
+            logger.error(error instanceof Error ? error.message : String(error));
+        }
+        else {
+            logger.error(chalk.red(`\nError: ${error instanceof Error ? error.message : String(error)}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Interactive tune mode (wizard)
+ */
+async function tuneInteractive(_options, logger) {
+    logger.info(chalk.bold('\n🎛️  ACE Configuration Tuner\n'));
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    const question = (prompt) => {
+        return new Promise((resolve) => rl.question(prompt, resolve));
+    };
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        // Fetch current settings
+        logger.info(chalk.dim('Fetching current configuration...'));
+        const serverConfig = await client.getConfig();
+        const current = serverConfig || {};
+        logger.info(chalk.green('✓ Current configuration loaded\n'));
+        // Display current effective values (actual server fields)
+        logger.info(chalk.bold('Current Settings:'));
+        logger.info(chalk.dim('────────────────────────────────────────────────────────────────'));
+        logger.info(`  Constitution Threshold:      ${chalk.cyan(current.constitution_threshold ?? 0.7)} (retrieval similarity)`);
+        logger.info(`  Search Top K:                ${chalk.cyan(current.search_top_k ?? 10)} (max results)`);
+        logger.info(`  Dedup Similarity Threshold:  ${chalk.cyan(current.dedup_similarity_threshold ?? 0.85)}`);
+        logger.info(`  Dedup Enabled:               ${chalk.cyan(current.dedup_enabled ?? true)}`);
+        logger.info(`  Pruning Threshold:           ${chalk.cyan(current.pruning_threshold ?? 0.3)}`);
+        logger.info(`  Max Playbook Tokens:         ${chalk.cyan(current.max_playbook_tokens ?? 'unlimited')}`);
+        logger.info(`  Token Budget Enforcement:    ${chalk.cyan(current.token_budget_enforcement ?? false)}`);
+        logger.info(`  Max Batch Size:              ${chalk.cyan(current.max_batch_size ?? 50)}`);
+        logger.info(`  Auto Learning Enabled:       ${chalk.cyan(current.auto_learning_enabled ?? true)}`);
+        logger.info(`  Reflector Enabled:           ${chalk.cyan(current.reflector_enabled ?? true)}`);
+        logger.info(`  Curator Enabled:             ${chalk.cyan(current.curator_enabled ?? true)}`);
+        logger.info(chalk.dim('────────────────────────────────────────────────────────────────\n'));
+        // Ask which setting to change
+        logger.info(chalk.bold('Which setting would you like to change?\n'));
+        logger.info('  1. Constitution Threshold (retrieval similarity, 0.0-1.0)');
+        logger.info('  2. Search Top K (max search results, 1-100)');
+        logger.info('  3. Dedup Similarity Threshold (0.0-1.0)');
+        logger.info('  4. Pruning Threshold (min confidence to keep pattern)');
+        logger.info('  5. Max Playbook Tokens (token budget limit)');
+        logger.info('  6. Auto Learning Enabled (toggle automatic learning)');
+        logger.info('  7. Max Batch Size (patterns per batch, 1-100)');
+        logger.info('  8. Dedup Enabled (toggle deduplication)');
+        logger.info('  9. Token Budget Enforcement (enforce token limits)');
+        logger.info('  A. Reflector/Curator Enabled (toggle agents)');
+        logger.info('  R. Reset to defaults');
+        logger.info('  0. Cancel\n');
+        const choice = await question(chalk.cyan('Enter choice: '));
+        const settings = {};
+        switch (choice.trim().toLowerCase()) {
+            case '1': {
+                const value = await question(chalk.cyan(`Enter new constitution threshold (0.0-1.0, current: ${current.constitution_threshold ?? 0.7}): `));
+                const threshold = parseFloat(value);
+                if (isNaN(threshold) || threshold < 0 || threshold > 1) {
+                    throw new Error('Invalid threshold. Must be between 0.0 and 1.0');
+                }
+                settings.constitution_threshold = threshold;
+                break;
+            }
+            case '2': {
+                const value = await question(chalk.cyan(`Enter new search top K (1-100, current: ${current.search_top_k ?? 10}): `));
+                const topK = parseInt(value, 10);
+                if (isNaN(topK) || topK < 1 || topK > 100) {
+                    throw new Error('Invalid top K. Must be between 1 and 100');
+                }
+                settings.search_top_k = topK;
+                break;
+            }
+            case '3': {
+                const value = await question(chalk.cyan(`Enter new dedup similarity threshold (0.0-1.0, current: ${current.dedup_similarity_threshold ?? 0.85}): `));
+                const threshold = parseFloat(value);
+                if (isNaN(threshold) || threshold < 0 || threshold > 1) {
+                    throw new Error('Invalid threshold. Must be between 0.0 and 1.0');
+                }
+                settings.dedup_similarity_threshold = threshold;
+                break;
+            }
+            case '4': {
+                const value = await question(chalk.cyan(`Enter new pruning threshold (0.0-1.0, current: ${current.pruning_threshold ?? 0.3}): `));
+                const threshold = parseFloat(value);
+                if (isNaN(threshold) || threshold < 0 || threshold > 1) {
+                    throw new Error('Invalid threshold. Must be between 0.0 and 1.0');
+                }
+                settings.pruning_threshold = threshold;
+                break;
+            }
+            case '5': {
+                const value = await question(chalk.cyan(`Enter max playbook tokens (number or 'null' for unlimited, current: ${current.max_playbook_tokens ?? 'null'}): `));
+                if (value.trim().toLowerCase() === 'null') {
+                    settings.max_playbook_tokens = null;
+                }
+                else {
+                    const tokens = parseInt(value, 10);
+                    if (isNaN(tokens) || tokens < 1) {
+                        throw new Error('Invalid token count. Must be >= 1 or "null"');
+                    }
+                    settings.max_playbook_tokens = tokens;
+                }
+                break;
+            }
+            case '6': {
+                const value = await question(chalk.cyan(`Enable auto learning? (yes/no, current: ${current.auto_learning_enabled ?? true}): `));
+                settings.auto_learning_enabled = value.trim().toLowerCase() === 'yes';
+                break;
+            }
+            case '7': {
+                const value = await question(chalk.cyan(`Enter max batch size (1-100, current: ${current.max_batch_size ?? 50}): `));
+                const size = parseInt(value, 10);
+                if (isNaN(size) || size < 1 || size > 100) {
+                    throw new Error('Invalid batch size. Must be between 1 and 100');
+                }
+                settings.max_batch_size = size;
+                break;
+            }
+            case '8': {
+                const value = await question(chalk.cyan(`Enable deduplication? (yes/no, current: ${current.dedup_enabled ?? true}): `));
+                settings.dedup_enabled = value.trim().toLowerCase() === 'yes';
+                break;
+            }
+            case '9': {
+                const value = await question(chalk.cyan(`Enable token budget enforcement? (yes/no, current: ${current.token_budget_enforcement ?? false}): `));
+                settings.token_budget_enforcement = value.trim().toLowerCase() === 'yes';
+                break;
+            }
+            case 'a': {
+                logger.info(chalk.bold('\nAgent Settings:\n'));
+                const reflector = await question(chalk.cyan(`Enable Reflector? (yes/no, current: ${current.reflector_enabled ?? true}): `));
+                const curator = await question(chalk.cyan(`Enable Curator? (yes/no, current: ${current.curator_enabled ?? true}): `));
+                settings.reflector_enabled = reflector.trim().toLowerCase() === 'yes';
+                settings.curator_enabled = curator.trim().toLowerCase() === 'yes';
+                break;
+            }
+            case 'r': {
+                const confirm = await question(chalk.yellow('\n⚠️  Reset ALL settings to defaults? (yes/no): '));
+                if (confirm.trim().toLowerCase() !== 'yes') {
+                    logger.info(chalk.dim('\nCancelled'));
+                    rl.close();
+                    return;
+                }
+                logger.info(chalk.dim('\nResetting configuration...'));
+                await client.resetConfig('project');
+                rl.close();
+                logger.info(chalk.green('\n✅ Configuration reset to defaults\n'));
+                return;
+            }
+            case '0':
+                logger.info(chalk.dim('\nCancelled'));
+                rl.close();
+                return;
+            default:
+                throw new Error('Invalid choice');
+        }
+        rl.close();
+        if (Object.keys(settings).length === 0) {
+            logger.info(chalk.dim('\nNo changes made'));
+            return;
+        }
+        // Confirm and save
+        logger.info(chalk.dim('\nSaving configuration...'));
+        await client.updateConfig(settings, 'project');
+        logger.info(chalk.green('\n✅ Configuration updated successfully\n'));
+        logger.info(chalk.bold('Updated Settings:'));
+        for (const [key, value] of Object.entries(settings)) {
+            logger.info(`  ${chalk.cyan(key)}: ${value}`);
+        }
+        logger.info('');
+    }
+    catch (error) {
+        rl.close();
+        if (logger.isJson()) {
+            logger.error(error instanceof Error ? error.message : String(error));
+        }
+        else {
+            logger.error(chalk.red(`\n❌ Error: ${error instanceof Error ? error.message : String(error)}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Show current effective configuration
+ */
+export async function tuneShowCommand() {
+    const logger = new Logger(globalOptions);
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        const serverConfig = await client.getConfig();
+        const config = serverConfig || {};
+        if (logger.isJson()) {
+            logger.output({
+                project_id: context.projectId,
+                org_id: context.orgId,
+                config: config
+            });
+        }
+        else {
+            logger.info(chalk.bold('\n🎛️  ACE Configuration\n'));
+            logger.info(chalk.dim(`Project: ${context.projectId}`));
+            logger.info(chalk.dim(`Organization: ${context.orgId}\n`));
+            logger.info(chalk.bold('Search/Retrieval:'));
+            logger.info(`  Constitution Threshold: ${chalk.cyan(config.constitution_threshold ?? 0.7)} (similarity)`);
+            logger.info(`  Search Top K:           ${chalk.cyan(config.search_top_k ?? 10)} (max results)`);
+            logger.info(chalk.bold('\nPattern Quality:'));
+            logger.info(`  Dedup Similarity:       ${chalk.cyan(config.dedup_similarity_threshold ?? 0.85)}`);
+            logger.info(`  Pruning Threshold:      ${chalk.cyan(config.pruning_threshold ?? 0.3)}`);
+            logger.info(chalk.bold('\nToken Management:'));
+            logger.info(`  Max Playbook Tokens:    ${chalk.cyan(config.max_playbook_tokens ?? 'unlimited')}`);
+            logger.info(`  Budget Enforcement:     ${chalk.cyan(config.token_budget_enforcement ?? false)}`);
+            logger.info(chalk.bold('\nProcessing:'));
+            logger.info(`  Dedup Enabled:          ${chalk.cyan(config.dedup_enabled ?? true)}`);
+            logger.info(`  Max Batch Size:         ${chalk.cyan(config.max_batch_size ?? 50)}`);
+            logger.info(chalk.bold('\nACE Agents:'));
+            logger.info(`  Auto Learning:          ${chalk.cyan(config.auto_learning_enabled ?? true)}`);
+            logger.info(`  Reflector:              ${chalk.cyan(config.reflector_enabled ?? true)}`);
+            logger.info(`  Curator:                ${chalk.cyan(config.curator_enabled ?? true)}`);
+            logger.info('');
+        }
+    }
+    catch (error) {
+        if (logger.isJson()) {
+            logger.error(error instanceof Error ? error.message : String(error));
+        }
+        else {
+            logger.error(chalk.red(`\nError: ${error instanceof Error ? error.message : String(error)}\n`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Reset configuration to defaults
+ */
+export async function tuneResetCommand(options = {}) {
+    const logger = new Logger(globalOptions);
+    const spinner = logger.spinner('Resetting configuration...');
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        const scope = options.scope || 'project';
+        const result = await client.resetConfig(scope);
+        spinner?.succeed('Configuration reset');
+        if (logger.isJson()) {
+            logger.output(result);
+        }
+        else {
+            logger.info(chalk.green('\n✅ Configuration reset to defaults\n'));
+            logger.info(chalk.dim(`Scope: ${scope}`));
+            logger.info(chalk.dim('Run "ce-ace tune show" to see current settings\n'));
+        }
+    }
+    catch (error) {
+        spinner?.fail('Failed to reset configuration');
+        if (logger.isJson()) {
+            logger.error(error instanceof Error ? error.message : String(error));
+        }
+        else {
+            logger.error(chalk.red(`\nError: ${error instanceof Error ? error.message : String(error)}\n`));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=tune.js.map