k0ntext 3.3.1 → 3.6.0

package/dist/cli/commands/embeddings-refresh.js

@@ -0,0 +1,114 @@
+/**
+ * Embeddings Refresh Command
+ *
+ * Regenerate embeddings with optional dimension validation.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { confirm } from '@inquirer/prompts';
+import { createIntelligentAnalyzer } from '../../analyzer/intelligent-analyzer.js';
+import { hasOpenRouterKey } from '../../embeddings/openrouter.js';
+import { DatabaseClient } from '../../db/client.js';
+/**
+ * Embeddings refresh command
+ */
+export const embeddingsRefreshCommand = new Command('embeddings:refresh')
+    .description('Regenerate embeddings for all indexed content')
+    .option('--force', 'Force refresh even if dimensions change')
+    .option('--batch-size <n>', 'Process in batches', '50')
+    .option('-v, --verbose', 'Show detailed output')
+    .action(async (options) => {
+    const spinner = ora();
+    try {
+        // Check for OpenRouter API key
+        if (!hasOpenRouterKey()) {
+            spinner.fail('OPENROUTER_API_KEY not found');
+            console.log(chalk.yellow('  Set OPENROUTER_API_KEY for embeddings generation'));
+            console.log(chalk.dim('  Get your key at: https://openrouter.ai/keys\n'));
+            process.exit(1);
+        }
+        const db = await DatabaseClient.create(process.cwd());
+        const analyzer = createIntelligentAnalyzer(process.cwd());
+        spinner.start('Checking embeddings status...');
+        const rawDb = db.getRawDb();
+        // Check if embeddings table exists and has data
+        const tableExists = rawDb.prepare(`
+        SELECT name FROM sqlite_master WHERE type='table' AND name='embeddings'
+      `).get();
+        let currentDimension = 0;
+        if (tableExists) {
+            const embedding = rawDb.prepare('SELECT embedding FROM embeddings LIMIT 1').get();
+            if (embedding) {
+                currentDimension = embedding.embedding.length / 4; // Float32Array
+            }
+        }
+        const expectedDimension = 1536; // OpenRouter text-embedding-3-small
+        if (currentDimension > 0 && currentDimension !== expectedDimension && !options.force) {
+            spinner.fail('Embedding dimension mismatch');
+            console.log(chalk.red(`  Current: ${currentDimension}, Expected: ${expectedDimension}`));
+            console.log(chalk.dim('\nUse --force to override (requires full re-index)\n'));
+            db.close();
+            process.exit(1);
+        }
+        // Get all items
+        spinner.text = 'Fetching items...';
+        const items = db.getAllItems();
+        if (items.length === 0) {
+            spinner.succeed('No items to index');
+            db.close();
+            return;
+        }
+        spinner.stop();
+        console.log('');
+        console.log(chalk.bold('Embeddings Refresh:'));
+        console.log(`  Items to process: ${chalk.cyan(items.length.toString())}`);
+        console.log(`  Batch size: ${chalk.cyan(options.batchSize)}`);
+        console.log('');
+        const confirmed = await confirm({
+            message: 'Refresh all embeddings?',
+            default: true
+        });
+        if (!confirmed) {
+            console.log(chalk.dim('\nRefresh cancelled.\n'));
+            db.close();
+            return;
+        }
+        spinner.start('Refreshing embeddings...');
+        // Process in batches
+        const batchSize = parseInt(options.batchSize, 10);
+        let processed = 0;
+        for (let i = 0; i < items.length; i += batchSize) {
+            const batch = items.slice(i, i + batchSize);
+            const batchNum = Math.floor(i / batchSize) + 1;
+            const totalBatches = Math.ceil(items.length / batchSize);
+            for (const item of batch) {
+                if (options.verbose) {
+                    spinner.stop();
+                    console.log(chalk.dim(`  Embedding: ${item.name}`));
+                    spinner.start();
+                }
+                // Generate and store embedding
+                try {
+                    const embedding = await analyzer.embedText(item.content);
+                    db.storeEmbedding(item.id, embedding);
+                    processed++;
+                }
+                catch (error) {
+                    if (options.verbose) {
+                        console.log(chalk.yellow(`  Warning: Failed to embed ${item.name}`));
+                    }
+                }
+            }
+            spinner.text = `Processing batch ${batchNum}/${totalBatches} (${processed}/${items.length})...`;
+        }
+        spinner.succeed(chalk.green(`Refreshed ${processed} embeddings`));
+        db.close();
+    }
+    catch (error) {
+        spinner.fail('Embedding refresh failed');
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=embeddings-refresh.js.map

package/dist/cli/commands/embeddings-refresh.js.map

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

package/dist/cli/commands/migrate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migrate Command
+ *
+ * Database schema migration command with interactive prompts.
+ */
+import { Command } from 'commander';
+/**
+ * Main migrate command
+ */
+export declare const migrateCommand: Command;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/cli/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/migrate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;GAEG;AACH,eAAO,MAAM,cAAc,SAoNvB,CAAC"}

package/dist/cli/commands/migrate.js

@@ -0,0 +1,195 @@
+/**
+ * Migrate Command
+ *
+ * Database schema migration command with interactive prompts.
+ */
+import { Command } from 'commander';
+import path from 'path';
+import fs from 'fs/promises';
+import chalk from 'chalk';
+import ora from 'ora';
+import { confirm, select } from '@inquirer/prompts';
+import { DatabaseClient } from '../../db/client.js';
+import { MigrationRunner } from '../../db/migrations/index.js';
+/**
+ * Main migrate command
+ */
+export const migrateCommand = new Command('migrate')
+    .description('Manage database schema migrations')
+    // Status subcommand
+    .command('status')
+    .description('Show migration status')
+    .action(async () => {
+    const spinner = ora();
+    try {
+        const db = await DatabaseClient.create(process.cwd());
+        const runner = new MigrationRunner(db, process.cwd());
+        const status = await runner.getStatus();
+        spinner.stop();
+        console.log(chalk.bold('\nMigration Status:\n'));
+        console.log(`  Current: ${chalk.cyan(status.currentVersion || 'none')}`);
+        console.log(`  Target:   ${chalk.cyan(status.targetVersion)}`);
+        console.log(`  Pending:  ${chalk.yellow(status.pending.length)} migration(s)\n`);
+        if (status.pending.length > 0) {
+            console.log(chalk.bold('Pending Migrations:'));
+            for (const migration of status.pending) {
+                const breaks = migration.breaks ? chalk.red(' [breaking]') : '';
+                console.log(`  ${chalk.cyan(migration.version)}: ${migration.description}${breaks}`);
+            }
+            console.log('');
+        }
+        if (status.applied.length > 0) {
+            console.log(chalk.bold('Applied Migrations:'));
+            for (const applied of status.applied.slice(0, 5)) {
+                console.log(chalk.dim(`  ${applied.version} (${applied.appliedAt})`));
+            }
+            if (status.applied.length > 5) {
+                console.log(chalk.dim(`  ... and ${status.applied.length - 5} more`));
+            }
+            console.log('');
+        }
+        db.close();
+    }
+    catch (error) {
+        spinner.fail('Status check failed');
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+})
+    // Up subcommand
+    .command('up')
+    .description('Apply pending migrations')
+    .option('--dry-run', 'Show what would be done')
+    .option('--force', 'Apply even if validation fails')
+    .option('--no-backup', 'Skip creating backup')
+    .action(async (options) => {
+    const spinner = ora();
+    try {
+        const db = await DatabaseClient.create(process.cwd());
+        const runner = new MigrationRunner(db, process.cwd());
+        const status = await runner.getStatus();
+        if (!status.needsMigration) {
+            spinner.succeed('Database is up to date');
+            db.close();
+            return;
+        }
+        // Check for breaking changes
+        const breaking = status.pending.filter(m => m.breaks);
+        if (breaking.length > 0 && !options.force) {
+            console.log(chalk.yellow(`\n⚠ ${breaking.length} breaking change(s) detected:\n`));
+            for (const m of breaking) {
+                console.log(chalk.red(`  ${m.version}: ${m.description}`));
+            }
+            console.log();
+            const shouldContinue = await confirm({
+                message: 'Continue with breaking changes?',
+                default: false
+            });
+            if (!shouldContinue) {
+                console.log(chalk.dim('\nMigration cancelled.\n'));
+                db.close();
+                return;
+            }
+        }
+        // Summary
+        console.log(chalk.bold(`\nApplying ${status.pending.length} migration(s):\n`));
+        for (const migration of status.pending) {
+            console.log(chalk.dim(`  ${migration.version}: ${migration.description}`));
+        }
+        console.log();
+        const confirmed = options.dryRun || await confirm({
+            message: 'Proceed?',
+            default: true
+        });
+        if (!confirmed) {
+            console.log(chalk.dim('\nMigration cancelled.\n'));
+            db.close();
+            return;
+        }
+        spinner.start('Applying migrations...');
+        const results = await runner.migrate({
+            dryRun: options.dryRun,
+            force: options.force,
+            backup: options.backup !== false,
+            onProgress: (current, total, migration) => {
+                spinner.text = `Applying ${current}/${total}: ${migration.description}`;
+            }
+        });
+        spinner.stop();
+        // Show results
+        const successful = results.filter(r => r.success);
+        const failed = results.filter(r => !r.success);
+        if (successful.length > 0) {
+            console.log(chalk.green(`\n✓ Applied ${successful.length} migration(s)`));
+        }
+        if (failed.length > 0) {
+            console.log(chalk.red(`\n✖ ${failed.length} migration(s) failed:\n`));
+            for (const result of failed) {
+                console.log(chalk.red(`  ${result.version}: ${result.error}`));
+            }
+            console.log(chalk.dim(`\nRollback using: k0ntext migrate rollback`));
+        }
+        db.close();
+    }
+    catch (error) {
+        spinner.fail('Migration failed');
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+})
+    // Rollback subcommand
+    .command('rollback')
+    .description('Rollback to a previous backup')
+    .option('--backup <path>', 'Specific backup to restore')
+    .action(async (options) => {
+    const spinner = ora();
+    const projectRoot = process.cwd();
+    try {
+        const db = await DatabaseClient.create(projectRoot);
+        const runner = new MigrationRunner(db, projectRoot);
+        const backups = await runner.getMigrationBackups();
+        if (backups.length === 0) {
+            console.log(chalk.yellow('\nNo migration backups found.\n'));
+            db.close();
+            return;
+        }
+        let selectedBackup;
+        if (options.backup) {
+            selectedBackup = options.backup;
+        }
+        else {
+            spinner.stop();
+            selectedBackup = await select({
+                message: 'Select backup to restore:',
+                choices: backups.map(b => ({
+                    name: b.replace('.k0ntext.db.pre-', '').replace('.bak', ''),
+                    value: b
+                }))
+            });
+        }
+        const confirmed = await confirm({
+            message: 'This will replace your current database. Continue?',
+            default: false
+        });
+        if (!confirmed) {
+            console.log(chalk.dim('\nRollback cancelled.\n'));
+            db.close();
+            return;
+        }
+        spinner.start('Restoring backup...');
+        // Close database first
+        db.close();
+        // Restore from backup
+        const backupPath = path.join(projectRoot, '.k0ntext', 'backups', selectedBackup);
+        const dbPath = path.join(projectRoot, '.k0ntext.db');
+        await fs.copyFile(backupPath, dbPath);
+        spinner.succeed(chalk.green('Database restored from backup'));
+        console.log(chalk.dim(`\nBackup: ${selectedBackup}\n`));
+    }
+    catch (error) {
+        spinner.fail('Rollback failed');
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=migrate.js.map

package/dist/cli/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/cli/commands/migrate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KACjD,WAAW,CAAC,mCAAmC,CAAC;IAEjD,oBAAoB;KACnB,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,uBAAuB,CAAC;KACpC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;IAEtB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAExC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEjF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,WAAW,GAAG,MAAM,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;IAEF,gBAAgB;KACf,OAAO,CAAC,IAAI,CAAC;KACb,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,WAAW,EAAE,yBAAyB,CAAC;KAC9C,MAAM,CAAC,SAAS,EAAE,gCAAgC,CAAC;KACnD,MAAM,CAAC,aAAa,EAAE,sBAAsB,CAAC;KAC7C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;IAEtB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;YAC1C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,QAAQ,CAAC,MAAM,iCAAiC,CAAC,CAAC,CAAC;YACnF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;YAEd,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC;gBACnC,OAAO,EAAE,iCAAiC;gBAC1C,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YAEH,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;gBACnD,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;QACH,CAAC;QAED,UAAU;QACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,MAAM,kBAAkB,CAAC,CAAC,CAAC;QAC/E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,OAAO,CAAC;YAChD,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;YACnD,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAExC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YACnC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,KAAK;YAChC,UAAU,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;gBACxC,OAAO,CAAC,IAAI,GAAG,YAAY,OAAO,IAAI,KAAK,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;YAC1E,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,eAAe;QACf,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAE/C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,UAAU,CAAC,MAAM,eAAe,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,yBAAyB,CAAC,CAAC,CAAC;YACtE,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;IAEF,sBAAsB;KACrB,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,+BAA+B,CAAC;KAC5C,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;IACtB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAEpD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAEnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC,CAAC;YAC7D,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,IAAI,cAAsB,CAAC;QAE3B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,cAAc,GAAG,MAAM,MAAM,CAAC;gBAC5B,OAAO,EAAE,2BAA2B;gBACpC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACzB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC3D,KAAK,EAAE,CAAC;iBACT,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC;YAC9B,OAAO,EAAE,oDAAoD;YAC7D,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;YAClD,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAErC,uBAAuB;QACvB,EAAE,CAAC,KAAK,EAAE,CAAC;QAEX,sBAAsB;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAErD,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,cAAc,IAAI,CAAC,CAAC,CAAC;IAE1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/restore.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Restore Command
+ *
+ * CLI command to restore AI tool config files from backups.
+ * Supports listing backups and restoring from specific backups.
+ */
+import { Command } from 'commander';
+/**
+ * Restore command
+ */
+export declare const restoreCommand: Command;
+//# sourceMappingURL=restore.d.ts.map

package/dist/cli/commands/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/restore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkFpC;;GAEG;AACH,eAAO,MAAM,cAAc,SAsLvB,CAAC"}

package/dist/cli/commands/restore.js

@@ -0,0 +1,261 @@
+/**
+ * Restore Command
+ *
+ * CLI command to restore AI tool config files from backups.
+ * Supports listing backups and restoring from specific backups.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import fs from 'fs/promises';
+import { select, confirm } from '@inquirer/prompts';
+import { BackupManager } from '../utils/backup-manager.js';
+/**
+ * Parse git stash reference from backup path
+ */
+function parseGitStashRef(backupPath) {
+    if (backupPath.startsWith('git-stash:')) {
+        return { stashRef: backupPath.replace('git-stash:', '') };
+    }
+    return null;
+}
+/**
+ * Restore from git stash
+ */
+async function restoreFromGitStash(stashRef, projectRoot, filePath) {
+    try {
+        const { execSync } = await import('child_process');
+        const relativePath = path.relative(projectRoot, filePath);
+        // Try to apply the stash
+        execSync(`git stash apply ${stashRef} -- "${relativePath}"`, {
+            cwd: projectRoot,
+            stdio: 'pipe'
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Format backup info for display
+ */
+function formatBackupInfo(backupPath, tool) {
+    const gitStash = parseGitStashRef(backupPath);
+    if (gitStash) {
+        return `${chalk.cyan(tool.padEnd(12))} ${chalk.dim('Git stash:')} ${chalk.yellow(gitStash.stashRef)}`;
+    }
+    const fileName = path.basename(backupPath);
+    const dateMatch = fileName.match(/\.(\d{4}-\d{2}-\d{2}T[\d:.-]+)\.bak$/);
+    if (dateMatch) {
+        const date = new Date(dateMatch[1].replace(/-/g, ':'));
+        const formatted = date.toLocaleString();
+        return `${chalk.cyan(tool.padEnd(12))} ${chalk.dim('File:')} ${chalk.yellow(fileName)} ${chalk.dim(`(${formatted})`)}`;
+    }
+    return `${chalk.cyan(tool.padEnd(12))} ${chalk.yellow(backupPath)}`;
+}
+/**
+ * List available backups for a tool
+ */
+async function listBackupsForTool(db, projectRoot, tool) {
+    const generatedFiles = db.getGeneratedFiles(tool);
+    return generatedFiles
+        .filter(f => f.backupPath)
+        .map(f => ({
+        tool,
+        backupPath: f.backupPath,
+        filePath: f.filePath,
+        generatedAt: f.generatedAt
+    }));
+}
+/**
+ * Restore command
+ */
+export const restoreCommand = new Command('restore')
+    .description('Restore AI tool config files from backups')
+    .option('--list', 'List available backups')
+    .option('--backup <path>', 'Restore from specific backup path')
+    .option('--tool <name>', 'Filter by tool name')
+    .option('--force', 'Restore without confirmation')
+    .action(async (options) => {
+    const spinner = ora();
+    const projectRoot = process.cwd();
+    try {
+        // Load database
+        const { DatabaseClient } = await import('../../db/client.js');
+        const db = new DatabaseClient(projectRoot);
+        const backupManager = new BackupManager(db, projectRoot);
+        // List mode
+        if (options.list) {
+            spinner.start('Finding backups...');
+            const tools = options.tool
+                ? [options.tool]
+                : ['claude', 'copilot', 'cline', 'antigravity', 'windsurf', 'aider', 'continue', 'cursor', 'gemini'];
+            const allBackups = [];
+            for (const tool of tools) {
+                const backups = await listBackupsForTool(db, projectRoot, tool);
+                allBackups.push(...backups);
+            }
+            spinner.stop();
+            if (allBackups.length === 0) {
+                console.log(chalk.yellow('\nNo backups found.'));
+                console.log(chalk.dim('Generate context files first to create backups.\n'));
+                return;
+            }
+            console.log(chalk.bold('\nAvailable Backups'));
+            console.log(chalk.dim('─'.repeat(60)));
+            for (const backup of allBackups) {
+                console.log(formatBackupInfo(backup.backupPath, backup.tool));
+                console.log(chalk.dim(`  Target: ${backup.filePath}\n`));
+            }
+            console.log(chalk.dim(`Run ${chalk.white('k0ntext restore --backup <path>')} to restore from a backup.\n`));
+            db.close();
+            return;
+        }
+        // Restore from specific backup
+        if (options.backup) {
+            const backupPath = options.backup;
+            const targetPath = await findTargetForBackup(db, backupPath, options.tool);
+            if (!targetPath) {
+                spinner.fail(chalk.red('Backup not found in database'));
+                console.log(chalk.dim('\nUse --list to see available backups.\n'));
+                db.close();
+                return;
+            }
+            // Confirm unless --force
+            if (!options.force) {
+                const confirmed = await confirm({
+                    message: `Restore ${targetPath.filePath} from backup?`,
+                    default: false
+                });
+                if (!confirmed) {
+                    console.log(chalk.dim('\nRestore cancelled.\n'));
+                    db.close();
+                    return;
+                }
+            }
+            spinner.start('Restoring from backup...');
+            const success = await restoreFromBackup(backupPath, targetPath.filePath, projectRoot);
+            if (success) {
+                spinner.succeed(chalk.green('File restored successfully!'));
+                // Clear the user_modified flag since we restored the generated version
+                const tool = targetPath.tool;
+                db.upsertGeneratedFile({
+                    tool,
+                    filePath: targetPath.filePath,
+                    contentHash: db.hashContent(await fs.readFile(targetPath.filePath, 'utf-8')),
+                    backupPath: undefined // Clear backup after restore
+                });
+            }
+            else {
+                spinner.fail(chalk.red('Restore failed'));
+            }
+            db.close();
+            return;
+        }
+        // Interactive mode
+        spinner.start('Loading backups...');
+        const tools = ['claude', 'copilot', 'cline', 'antigravity', 'windsurf', 'aider', 'continue', 'cursor', 'gemini'];
+        const allBackups = [];
+        for (const tool of tools) {
+            const backups = await listBackupsForTool(db, projectRoot, tool);
+            for (const backup of backups) {
+                allBackups.push({
+                    ...backup,
+                    label: `${tool}: ${path.basename(backup.filePath)} (${backup.backupPath.split(':').pop()})`
+                });
+            }
+        }
+        spinner.stop();
+        if (allBackups.length === 0) {
+            console.log(chalk.yellow('\nNo backups found.'));
+            console.log(chalk.dim('Generate context files first to create backups.\n'));
+            db.close();
+            return;
+        }
+        // Prompt user to select backup
+        const selected = await select({
+            message: 'Select a backup to restore:',
+            choices: [
+                ...allBackups.map(b => ({
+                    name: b.label,
+                    value: b
+                })),
+                { name: 'Cancel', value: null }
+            ]
+        });
+        if (!selected) {
+            console.log(chalk.dim('\nRestore cancelled.\n'));
+            db.close();
+            return;
+        }
+        // Confirm restore
+        const confirmed = await confirm({
+            message: `Restore ${selected.filePath} from backup?`,
+            default: true
+        });
+        if (!confirmed) {
+            console.log(chalk.dim('\nRestore cancelled.\n'));
+            db.close();
+            return;
+        }
+        spinner.start('Restoring from backup...');
+        const success = await restoreFromBackup(selected.backupPath, selected.filePath, projectRoot);
+        if (success) {
+            spinner.succeed(chalk.green('File restored successfully!'));
+            // Clear the user_modified flag
+            const content = await fs.readFile(selected.filePath, 'utf-8');
+            db.upsertGeneratedFile({
+                tool: selected.tool,
+                filePath: selected.filePath,
+                contentHash: db.hashContent(content),
+                backupPath: undefined
+            });
+        }
+        else {
+            spinner.fail(chalk.red('Restore failed'));
+        }
+        db.close();
+    }
+    catch (error) {
+        spinner.fail('Restore failed');
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+});
+/**
+ * Find the target file path for a backup
+ */
+async function findTargetForBackup(db, backupPath, toolFilter) {
+    const tools = toolFilter
+        ? [toolFilter]
+        : ['claude', 'copilot', 'cline', 'antigravity', 'windsurf', 'aider', 'continue', 'cursor', 'gemini'];
+    for (const tool of tools) {
+        const files = db.getGeneratedFiles(tool);
+        for (const file of files) {
+            if (file.backupPath === backupPath) {
+                return { tool, filePath: file.filePath };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Restore from a backup (file or git stash)
+ */
+async function restoreFromBackup(backupPath, targetPath, projectRoot) {
+    const gitStash = parseGitStashRef(backupPath);
+    if (gitStash) {
+        return await restoreFromGitStash(gitStash.stashRef, projectRoot, targetPath);
+    }
+    // File copy restore
+    try {
+        await fs.copyFile(backupPath, targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/cli/commands/restore.js.map

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

package/dist/cli/commands/sync-templates.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template Sync Command
+ *
+ * CLI command for syncing .claude/ templates from package templates/base/
+ */
+import { Command } from 'commander';
+/**
+ * Sync templates command
+ */
+export declare const syncTemplatesCommand: Command;
+/**
+ * Template status command (shows current sync status)
+ */
+export declare const templateStatusCommand: Command;
+//# sourceMappingURL=sync-templates.d.ts.map