k0ntext 3.3.1 → 3.6.0

package/dist/template-sync/scanner.js.map

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

package/dist/template-sync/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Template Sync Types
+ *
+ * All type definitions for the template sync system.
+ */
+/**
+ * Template file metadata
+ */
+export interface TemplateFile {
+    /** Relative path from .claude/ or templates/base/.claude/ */
+    relativePath: string;
+    /** Content hash (SHA-256, 16 chars) */
+    hash: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified time */
+    mtime: Date;
+}
+/**
+ * Template manifest structure (stored in DB and .claude/.k0ntext-manifest.json)
+ */
+export interface TemplateManifest {
+    /** k0ntext version that generated this manifest */
+    k0ntextVersion: string;
+    /** Template source version */
+    templateVersion: string;
+    /** Timestamp when manifest was created */
+    createdAt: string;
+    /** Timestamp when manifest was last updated */
+    updatedAt?: string;
+    /** All tracked template files keyed by relative path */
+    files: Record<string, TemplateFileEntry>;
+}
+/**
+ * Single file entry in manifest
+ */
+export interface TemplateFileEntry {
+    /** Content hash */
+    hash: string;
+    /** Template version when file was last updated */
+    templateVersion: string;
+    /** Whether user has modified this file */
+    userModified: boolean;
+    /** Last sync timestamp */
+    lastSyncedAt?: string;
+    /** Original template hash (before user modification) */
+    originalHash?: string;
+}
+/**
+ * Comparison result for a single file
+ */
+export interface FileComparison {
+    /** Relative path from .claude/ */
+    path: string;
+    /** Current state */
+    state: FileState;
+    /** Template hash (from package) */
+    templateHash: string;
+    /** Local hash (from .claude/) */
+    localHash: string;
+    /** Whether user has modified (from manifest) */
+    userModified: boolean;
+    /** Original template hash (if user modified) */
+    originalHash?: string;
+}
+/**
+ * File state after comparison
+ */
+export type FileState = 'identical' | 'safe-update' | 'conflict' | 'new' | 'deleted' | 'user-only';
+/**
+ * Sync operation result
+ */
+export interface SyncResult {
+    /** Total files processed */
+    total: number;
+    /** Files updated (safe merge) */
+    updated: number;
+    /** Files skipped (user modified/conflict) */
+    skipped: string[];
+    /** New files created */
+    created: number;
+    /** Files in conflict requiring resolution */
+    conflicts: FileComparison[];
+    /** User-only files (deleted from template) */
+    userOnly: string[];
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Whether this was a dry run */
+    dryRun?: boolean;
+}
+/**
+ * Sync options
+ */
+export interface SyncOptions {
+    /** Dry run - don't make changes */
+    dryRun?: boolean;
+    /** Force update all files (skip prompts, overwrite user modifications) */
+    force?: boolean;
+    /** Specific subdirectories to sync */
+    subdirectories?: TemplateSubdir[];
+    /** Verbose output */
+    verbose?: boolean;
+    /** Whether to archive removed files */
+    archiveRemoved?: boolean;
+}
+/**
+ * Template subdirectories (synced from package)
+ */
+export type TemplateSubdir = 'commands' | 'agents' | 'schemas' | 'standards' | 'tools' | 'automation';
+/**
+ * Excluded subdirectories (user-specific, not synced)
+ */
+export type ExcludedSubdir = 'context' | 'indexes';
+/**
+ * Template source configuration
+ */
+export interface TemplateSource {
+    /** Root path to templates (e.g., templates/base/.claude/) */
+    rootPath: string;
+    /** Subdirectories to sync */
+    subdirectories: TemplateSubdir[];
+}
+/**
+ * Merge result for a single file
+ */
+export interface MergeResult {
+    /** File path */
+    path: string;
+    /** Whether merge was successful */
+    success: boolean;
+    /** Merge method used */
+    method: MergeMethod;
+    /** Diff if available */
+    diff?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Merge method used
+ */
+export type MergeMethod = 'auto-safe' | 'auto-create' | 'overwrite' | 'skip' | 'conflict';
+/**
+ * Resolution choice for conflicts
+ */
+export type ResolutionChoice = 'skip' | 'overwrite' | 'keep-local' | 'show-diff';
+/**
+ * Resolution result for a single conflict
+ */
+export interface ResolutionResult {
+    /** File path */
+    path: string;
+    /** User's choice */
+    choice: ResolutionChoice;
+}
+/**
+ * Archive result for removed files
+ */
+export interface ArchiveResult {
+    /** Files that were archived */
+    archived: string[];
+    /** Archive path */
+    archivePath: string;
+}
+/**
+ * Template file record from database
+ */
+export interface TemplateFileRecord {
+    id: string;
+    relativePath: string;
+    templateHash: string;
+    templateVersion: string;
+    userModified: boolean;
+    lastSyncedAt?: string;
+    syncedAt: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Template manifest record from database
+ */
+export interface TemplateManifestRecord {
+    id: string;
+    k0ntextVersion: string;
+    templateVersion: string;
+    manifest: string;
+    createdAt: string;
+}
+/**
+ * All template subdirectories
+ */
+export declare const TEMPLATE_SUBDIRS: TemplateSubdir[];
+/**
+ * All excluded subdirectories
+ */
+export declare const EXCLUDED_SUBDIRS: ExcludedSubdir[];
+/**
+ * Default sync options
+ */
+export declare const DEFAULT_SYNC_OPTIONS: SyncOptions;
+//# sourceMappingURL=types.d.ts.map

package/dist/template-sync/types.d.ts.map

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

package/dist/template-sync/types.js

@@ -0,0 +1,30 @@
+/**
+ * Template Sync Types
+ *
+ * All type definitions for the template sync system.
+ */
+/**
+ * All template subdirectories
+ */
+export const TEMPLATE_SUBDIRS = [
+    'commands',
+    'agents',
+    'schemas',
+    'standards',
+    'tools',
+    'automation'
+];
+/**
+ * All excluded subdirectories
+ */
+export const EXCLUDED_SUBDIRS = ['context', 'indexes'];
+/**
+ * Default sync options
+ */
+export const DEFAULT_SYNC_OPTIONS = {
+    dryRun: false,
+    force: false,
+    verbose: false,
+    archiveRemoved: true
+};
+//# sourceMappingURL=types.js.map

package/dist/template-sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/template-sync/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyNH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,UAAU;IACV,QAAQ;IACR,SAAS;IACT,WAAW;IACX,OAAO;IACP,YAAY;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,KAAK;IACd,cAAc,EAAE,IAAI;CACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "k0ntext",
-  "version": "3.3.1",
+  "version": "3.6.0",
   "description": "Unified AI Context Engineering - Intelligent context for Claude, Copilot, Cline, and more with OpenRouter-powered initialization",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -77,6 +77,7 @@
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
     "glob": "^10.5.0",
+    "handlebars": "^4.7.8",
     "ora": "^8.0.1",
     "sqlite-vec": "^0.1.3",
     "sqlite-vec-windows-x64": "^0.1.7-alpha.2",

package/src/agents/cleanup-agent.ts

@@ -54,19 +54,27 @@ export class CleanupAgent {
     const cwd = options.cwd || this.config.cwd;
     const entries = fs.readdirSync(cwd, { withFileTypes: true });
 
-    const toolFolders = entries
+    const allToolFolders = entries
       .filter(e => e.isDirectory() && e.name.startsWith('.'))
-      .filter(e => this.KNOWN_TOOL_FOLDERS.includes(e.name))
-      .filter(e => !options.keep?.includes(e.name) && !this.config.defaultKeep.includes(e.name));
+      .filter(e => this.KNOWN_TOOL_FOLDERS.includes(e.name));
+
+    // Separate folders to remove vs folders to keep
+    const keepList = [
+      ...(options.keep || []),
+      ...this.config.defaultKeep
+    ];
+
+    const foldersToRemove = allToolFolders.filter(e => !keepList.includes(e.name));
+    const foldersToKeep = allToolFolders.filter(e => keepList.includes(e.name));
 
     const results: CleanupResult = {
-      scanned: toolFolders.length,
+      scanned: allToolFolders.length,
       removed: [],
-      kept: [],
+      kept: foldersToKeep.map(f => f.name),
       errors: [],
     };
 
-    for (const folder of toolFolders) {
+    for (const folder of foldersToRemove) {
       try {
         const folderPath = path.join(cwd, folder.name);
 
@@ -83,6 +91,13 @@ export class CleanupAgent {
       }
     }
 
+    // Log kept folders in verbose mode
+    if ((options.verbose || this.config.verbose) && foldersToKeep.length > 0) {
+      for (const folder of foldersToKeep) {
+        console.log(`Kept: ${folder.name} (preserved)`);
+      }
+    }
+
     return results;
   }
 

package/src/agents/drift-agent.ts

@@ -43,6 +43,10 @@ export interface DriftResult {
   filesChecked: number;
   /** Time taken in milliseconds */
   duration: number;
+  /** Files that failed due to authentication errors */
+  authFailures?: string[];
+  /** Files that failed due to other errors */
+  errors?: Array<{ file: string; error: string }>;
 }
 
 /**
@@ -131,6 +135,8 @@ export class DriftAgent {
     const startTime = Date.now();
     const drifts: DriftIssue[] = [];
     let fixed = 0;
+    const authFailures: string[] = [];
+    const errors: Array<{ file: string; error: string }> = [];
 
     // Get list of files to check
     const filesToCheck = options.paths
@@ -147,14 +153,29 @@ export class DriftAgent {
 
     // Analyze each file for drift
     for (const relativePath of filesToProcess) {
-      const drift = await this.checkFileForDrift(relativePath, sourceFiles);
-      if (drift) {
-        drifts.push(drift);
-
-        if (options.autoFix && drift.suggestion) {
-          const didFix = await this.fixDrift(relativePath, drift);
-          if (didFix) fixed++;
+      try {
+        const drift = await this.checkFileForDrift(relativePath, sourceFiles);
+        if (drift) {
+          drifts.push(drift);
+
+          if (options.autoFix && drift.suggestion) {
+            const didFix = await this.fixDrift(relativePath, drift);
+            if (didFix) fixed++;
+          }
+        }
+      } catch (error) {
+        // Check for authentication errors
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('401') ||
+            errorMessage.includes('Authentication') ||
+            errorMessage.includes('Unauthorized') ||
+            errorMessage.includes('API key')) {
+          authFailures.push(relativePath);
+        } else {
+          errors.push({ file: relativePath, error: errorMessage });
         }
+        // Log error but continue
+        console.error(`Failed to analyze ${relativePath}: ${errorMessage}`);
       }
     }
 
@@ -162,7 +183,9 @@ export class DriftAgent {
       drifts,
       fixed,
       filesChecked: filesToProcess.length,
-      duration: Date.now() - startTime
+      duration: Date.now() - startTime,
+      authFailures,
+      errors
     };
   }
 

package/src/cli/commands/cleanup.ts

@@ -98,7 +98,15 @@ Respond with JSON:
 
     console.log(chalk.bold(`\nCleanup complete:`));
     console.log(`  Scanned: ${chalk.cyan(result.scanned.toString())} tool folders`);
-    console.log(`  Removed: ${chalk.cyan(result.removed.length.toString())}`);
+
+    // Use different messaging for dry-run
+    if (options.dryRun) {
+      const wouldRemoveCount = result.removed.filter(r => r.includes('(dry-run)')).length;
+      console.log(`  Would remove: ${chalk.cyan(wouldRemoveCount.toString())}`);
+    } else {
+      console.log(`  Removed: ${chalk.cyan(result.removed.length.toString())}`);
+    }
+
     console.log(`  Kept: ${chalk.cyan(result.kept.length.toString())}`);
 
     if (result.errors.length > 0) {

package/src/cli/commands/drift-detect.ts

@@ -53,7 +53,30 @@ export const driftDetectCommand = new Command('drift-detect')
       console.log(`Duration: ${chalk.dim(`${result.duration}ms`)}`);
       console.log(`Drifts found: ${result.drifts.length > 0 ? chalk.red(result.drifts.length.toString()) : chalk.green('0')}`);
 
-      if (result.drifts.length === 0) {
+      // Show auth failures if any
+      if (result.authFailures && result.authFailures.length > 0) {
+        console.log(chalk.red(`Authentication failures: ${result.authFailures.length}`));
+        console.log(chalk.dim(`  ${result.authFailures.slice(0, 5).join(', ')}${result.authFailures.length > 5 ? '...' : ''}`));
+        console.log(chalk.yellow(`\n⚠ Check your OPENROUTER_API_KEY`));
+
+        // Exit with error if all files failed auth
+        if (result.authFailures.length === result.filesChecked) {
+          console.log(chalk.red('\n✖ All files failed authentication. Cannot detect drift.'));
+          process.exit(1);
+        }
+      }
+
+      // Show other errors if any
+      if (result.errors && result.errors.length > 0) {
+        console.log(chalk.yellow(`Other errors: ${result.errors.length}`));
+        if (options.verbose) {
+          for (const err of result.errors.slice(0, 3)) {
+            console.log(chalk.dim(`  ${err.file}: ${err.error.substring(0, 60)}...`));
+          }
+        }
+      }
+
+      if (result.drifts.length === 0 && (!result.authFailures || result.authFailures.length === 0)) {
         console.log(chalk.green('\n✓ No drift detected!'));
         agent.close();
         return;

package/src/cli/commands/embeddings-refresh.ts

@@ -0,0 +1,135 @@
+/**
+ * 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() as { name: string } | undefined;
+
+      let currentDimension = 0;
+      if (tableExists) {
+        const embedding = rawDb.prepare('SELECT embedding FROM embeddings LIMIT 1').get() as { embedding: Buffer } | undefined;
+        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);
+    }
+  });