@ace-sdk/cli 2.0.0

package/dist/commands/bootstrap.js

@@ -0,0 +1,157 @@
+/**
+ * Bootstrap playbook from codebase
+ */
+import { globalOptions } from '../cli.js';
+import { createContext } from '../types/config.js';
+import { ACEServerClient } from '../services/server-client.js';
+import { InitializationService } from '../services/initialization.js';
+import { THOROUGHNESS_PRESETS } from '../types/pattern.js';
+import { Logger } from '../services/logger.js';
+import chalk from 'chalk';
+/**
+ * Initialize playbook from codebase
+ */
+export async function bootstrapCommand(options) {
+    const logger = new Logger(globalOptions);
+    // Fetch server config to get defaults
+    let serverDefaults = {
+        mode: 'hybrid',
+        thoroughness: 'medium'
+    };
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const tempClient = new ACEServerClient(context, logger);
+        const serverConfig = await tempClient.getConfig();
+        if (serverConfig?.runtime_settings) {
+            const configMode = serverConfig.runtime_settings.bootstrapDefaultMode;
+            if (configMode === 'hybrid' || configMode === 'local-files' || configMode === 'git-history' || configMode === 'docs-only') {
+                serverDefaults.mode = configMode;
+            }
+            const configThoroughness = serverConfig.runtime_settings.bootstrapDefaultThoroughness;
+            if (configThoroughness === 'light' || configThoroughness === 'medium' || configThoroughness === 'deep') {
+                serverDefaults.thoroughness = configThoroughness;
+            }
+            logger.debug(`Using server config: mode=${serverDefaults.mode}, thoroughness=${serverDefaults.thoroughness}`);
+        }
+    }
+    catch (error) {
+        logger.debug('Failed to fetch server config, using hardcoded defaults');
+    }
+    // Apply thoroughness preset (CLI option > server default > hardcoded)
+    const thoroughnessLevel = options.thoroughness || serverDefaults.thoroughness;
+    const preset = THOROUGHNESS_PRESETS[thoroughnessLevel];
+    const effectiveMaxFiles = options.maxFiles ?? preset.max_files;
+    const effectiveCommitLimit = options.commitLimit ?? preset.commit_limit;
+    const effectiveDaysBack = options.daysBack ?? preset.days_back;
+    const analysisMode = options.mode || serverDefaults.mode;
+    const projectPath = options.repoPath || process.cwd();
+    if (!logger.isJson()) {
+        logger.info(chalk.bold(`\n🚀 Bootstrapping Playbook\n`));
+        logger.info(`  ${chalk.cyan('Mode:')}           ${analysisMode}`);
+        logger.info(`  ${chalk.cyan('Thoroughness:')}   ${thoroughnessLevel}`);
+        logger.info(`  ${chalk.cyan('Max Files:')}      ${effectiveMaxFiles === -1 ? 'unlimited' : effectiveMaxFiles}`);
+        logger.info(`  ${chalk.cyan('Commits:')}        ${effectiveCommitLimit}`);
+        logger.info(`  ${chalk.cyan('Days Back:')}      ${effectiveDaysBack}`);
+        logger.info(`  ${chalk.cyan('Repository:')}     ${projectPath}\n`);
+    }
+    let spinner = logger.spinner('Analyzing codebase...');
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        const initService = new InitializationService();
+        // Run local codebase analysis
+        spinner = logger.spinner('Running local codebase analysis...');
+        const playbook = await initService.initializeFromCodebase(projectPath, {
+            mode: analysisMode,
+            commitLimit: effectiveCommitLimit,
+            daysBack: effectiveDaysBack,
+            maxFiles: effectiveMaxFiles
+        });
+        // Count total patterns discovered
+        const allBullets = [
+            ...playbook.strategies_and_hard_rules,
+            ...playbook.useful_code_snippets,
+            ...playbook.troubleshooting_and_pitfalls,
+            ...playbook.apis_to_use
+        ];
+        spinner = logger.spinner(`Discovered ${allBullets.length} patterns locally`);
+        if (allBullets.length === 0) {
+            spinner?.warn('No patterns found in codebase');
+            if (logger.isJson()) {
+                logger.output({
+                    success: true,
+                    patternsExtracted: 0,
+                    message: 'No patterns found in codebase'
+                });
+            }
+            else {
+                logger.info(chalk.yellow('\n⚠️  No patterns found in codebase'));
+                logger.info(chalk.dim('Try working on real tasks to build the playbook through online learning\n'));
+            }
+            return;
+        }
+        // Send to server for processing
+        spinner = logger.spinner('Sending patterns to ACE server for processing...');
+        // Build code blocks array for bootstrap endpoint
+        const codeBlocks = [];
+        for (const snippet of playbook.useful_code_snippets) {
+            if (snippet.evidence && snippet.evidence.length > 0) {
+                codeBlocks.push(`File: ${snippet.evidence[0]}\n\n${snippet.content}`);
+            }
+            else {
+                codeBlocks.push(snippet.content);
+            }
+        }
+        // Also include strategies, troubleshooting, and API patterns
+        for (const strategy of playbook.strategies_and_hard_rules) {
+            codeBlocks.push(`[STRATEGY] ${strategy.content}`);
+        }
+        for (const trouble of playbook.troubleshooting_and_pitfalls) {
+            codeBlocks.push(`[TROUBLESHOOTING] ${trouble.content}`);
+        }
+        for (const api of playbook.apis_to_use) {
+            codeBlocks.push(`[API] ${api.content}`);
+        }
+        // Call server bootstrap endpoint
+        const result = await client.bootstrap({
+            mode: analysisMode,
+            code_blocks: codeBlocks,
+            metadata: {
+                blocks_extracted: codeBlocks.length,
+                thoroughness: thoroughnessLevel
+            }
+        });
+        // Invalidate cache
+        client.invalidateCache();
+        spinner?.succeed('Bootstrap complete');
+        if (logger.isJson()) {
+            logger.output({
+                success: true,
+                patternsExtracted: allBullets.length,
+                patternsAfterDedup: result.patterns_after_dedup || allBullets.length,
+                compressionRatio: result.compression_ratio,
+                message: 'Playbook initialized successfully'
+            });
+        }
+        else {
+            logger.info(chalk.green('\n✅ Playbook initialized successfully\n'));
+            logger.info(`  ${chalk.cyan('Patterns Extracted:')}      ${allBullets.length}`);
+            logger.info(`  ${chalk.cyan('After Deduplication:')}     ${result.patterns_after_dedup || allBullets.length}`);
+            if (result.compression_ratio) {
+                logger.info(`  ${chalk.cyan('Compression Ratio:')}       ${result.compression_ratio}`);
+            }
+            logger.info('');
+        }
+    }
+    catch (error) {
+        spinner?.fail('Bootstrap failed');
+        if (logger.isJson()) {
+            logger.error(JSON.stringify({ 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);
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/commands/bootstrap.js.map

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

package/dist/commands/cache.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cache management command
+ */
+interface CacheOptions {
+    type?: 'ram' | 'sqlite' | 'all';
+}
+interface CacheRecallOptions {
+    session: string;
+}
+/**
+ * Clear local cache
+ */
+export declare function cacheCommand(options: CacheOptions): Promise<void>;
+/**
+ * Recall patterns from a pinned session
+ */
+export declare function cacheRecallCommand(options: CacheRecallOptions): Promise<void>;
+export {};
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/commands/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;CACjC;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,iBA+BvD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,iBA2DnE"}

package/dist/commands/cache.js

@@ -0,0 +1,101 @@
+/**
+ * Cache management command
+ */
+import { globalOptions } from '../cli.js';
+import { createContext } from '../types/config.js';
+import { ACEServerClient } from '../services/server-client.js';
+import { SessionStorage } from '../services/session-storage.js';
+import { Logger } from '../services/logger.js';
+import chalk from 'chalk';
+/**
+ * Clear local cache
+ */
+export async function cacheCommand(options) {
+    const logger = new Logger(globalOptions);
+    const spinner = logger.spinner('Clearing cache...');
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        // The client only has invalidateCache() which clears all caches
+        client.invalidateCache();
+        spinner?.succeed('Cache cleared');
+        if (logger.isJson()) {
+            logger.output({
+                success: true,
+                message: `Cache cleared (type: ${options.type || 'all'})`
+            });
+        }
+        else {
+            logger.info(chalk.green(`\n✅ ${options.type || 'all'} cache cleared successfully\n`));
+        }
+    }
+    catch (error) {
+        spinner?.fail('Failed to clear cache');
+        if (logger.isJson()) {
+            logger.output({ error: error instanceof Error ? error.message : String(error) });
+        }
+        else {
+            logger.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Recall patterns from a pinned session
+ */
+export async function cacheRecallCommand(options) {
+    const logger = new Logger(globalOptions);
+    if (!options.session) {
+        if (logger.isJson()) {
+            logger.output({ error: 'Session ID is required' });
+        }
+        else {
+            logger.error(chalk.red('Error: Session ID is required (--session <sessionId>)'));
+        }
+        process.exit(1);
+    }
+    const spinner = logger.spinner('Recalling session...');
+    try {
+        const sessionStorage = new SessionStorage(logger);
+        await sessionStorage.initialize();
+        const result = await sessionStorage.recallSession(options.session);
+        if (!result) {
+            spinner?.fail('Session not found or expired');
+            if (logger.isJson()) {
+                logger.output({
+                    error: 'Session not found or expired',
+                    session_id: options.session
+                });
+            }
+            else {
+                logger.error(chalk.red(`\nError: Session "${options.session}" not found or expired\n`));
+                logger.info(chalk.dim('Sessions expire after 24 hours\n'));
+            }
+            process.exit(1);
+        }
+        sessionStorage.close();
+        spinner?.succeed(`Recalled ${result.count} patterns from session`);
+        if (logger.isJson()) {
+            logger.output(result);
+        }
+        else {
+            logger.info(chalk.green(`\n✅ Recalled ${result.count} patterns from session: ${options.session}\n`));
+            logger.info(chalk.dim(`Query: ${result.similar_patterns[0]?.content.substring(0, 60)}...\n`));
+            logger.info(chalk.dim(`Threshold: ${result.threshold}`));
+            logger.info(chalk.dim(`Top-K: ${result.top_k}`));
+            logger.info(chalk.dim(`Pinned: ${new Date(result.pinned_at).toLocaleString()}`));
+            logger.info(chalk.dim(`Expires: ${new Date(result.expires_at).toLocaleString()}\n`));
+        }
+    }
+    catch (error) {
+        spinner?.fail('Failed to recall session');
+        if (logger.isJson()) {
+            logger.output({ 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=cache.js.map

package/dist/commands/cache.js.map

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

package/dist/commands/clear.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Clear playbook command
+ */
+interface ClearOptions {
+    yes?: boolean;
+}
+/**
+ * Clear the playbook
+ */
+export declare function clearCommand(options: ClearOptions): Promise<void>;
+export {};
+//# sourceMappingURL=clear.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,iBAwCvD"}

package/dist/commands/clear.js

@@ -0,0 +1,50 @@
+/**
+ * Clear playbook command
+ */
+import * as readline from 'readline/promises';
+import { stdin, stdout } from 'process';
+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';
+/**
+ * Clear the playbook
+ */
+export async function clearCommand(options) {
+    const logger = new Logger(globalOptions);
+    // Confirm if --yes not provided
+    if (!options.yes && !logger.isJson()) {
+        const rl = readline.createInterface({ input: stdin, output: stdout });
+        const answer = await rl.question(chalk.yellow('⚠️  Are you sure you want to clear the entire playbook? This cannot be undone! (y/N): '));
+        rl.close();
+        if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
+            logger.info(chalk.dim('Cancelled'));
+            return;
+        }
+    }
+    let spinner = logger.spinner('Clearing playbook...');
+    try {
+        const context = await createContext({ org: globalOptions.org, project: globalOptions.project });
+        const client = new ACEServerClient(context, logger);
+        await client.clearPlaybook();
+        spinner?.succeed('Playbook cleared');
+        if (logger.isJson()) {
+            logger.output({ success: true, message: 'Playbook cleared' });
+        }
+        else {
+            logger.info(chalk.green('\n✅ Playbook cleared successfully\n'));
+        }
+    }
+    catch (error) {
+        spinner?.fail('Failed to clear playbook');
+        if (logger.isJson()) {
+            logger.error(JSON.stringify({ 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);
+    }
+}
+//# sourceMappingURL=clear.js.map

package/dist/commands/clear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAqB;IACtD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAEzC,gCAAgC;IAChC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,wFAAwF,CAAC,CAAC,CAAC;QACzI,EAAE,CAAC,KAAK,EAAE,CAAC;QAEX,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;IACH,CAAC;IAED,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEpD,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAE7B,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAErC,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAE1C,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAClG,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACpG,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Configuration commands
+ */
+/**
+ * Configuration wizard - Interactive or non-interactive
+ */
+export declare function configCommand(options?: {
+    serverUrl?: string;
+    apiToken?: string;
+    orgId?: string;
+    projectId?: string;
+}): Promise<void>;
+/**
+ * Display current configuration
+ */
+export declare function configShowCommand(): Promise<void>;
+/**
+ * Set a configuration value
+ */
+export declare function configSetCommand(key: string, value: string): Promise<void>;
+/**
+ * Reset configuration to defaults
+ */
+export declare function configResetCommand(options: {
+    yes?: boolean;
+}): Promise<void>;
+/**
+ * Validate token and return organization/project info (non-destructive)
+ */
+export declare function configValidateCommand(options: {
+    serverUrl?: string;
+    apiToken?: string;
+}): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4IH;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,iBAgJA;AAED;;GAEG;AACH,wBAAsB,iBAAiB,kBAgCtC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAuChE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,iBA0ClE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,iBAwDA"}