k0ntext 3.3.1 → 3.6.0

package/dist/template-sync/merger.js

@@ -0,0 +1,371 @@
+/**
+ * Template Merger
+ *
+ * Auto-merge strategies for template updates.
+ * Handles safe updates, new file creation, and diff generation.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+/**
+ * Auto-merge strategies for template updates
+ */
+export class TemplateMerger {
+    projectRoot;
+    templateRoot;
+    options;
+    constructor(projectRoot = process.cwd(), templateRoot, options = {}) {
+        this.projectRoot = projectRoot;
+        this.templateRoot = templateRoot;
+        this.options = options;
+        // Default options
+        this.options = {
+            createBackups: true,
+            generateDiffs: true,
+            diffContext: 3,
+            ...options
+        };
+    }
+    /**
+     * Process multiple files for merging
+     *
+     * @param comparisons - File comparisons to process
+     * @returns Array of merge results
+     */
+    async mergeFiles(comparisons) {
+        const results = [];
+        for (const comparison of comparisons) {
+            const result = await this.mergeFile(comparison);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Merge a single file based on comparison state
+     *
+     * @param comparison - File comparison
+     * @returns Merge result
+     */
+    async mergeFile(comparison) {
+        const templatePath = path.join(this.templateRoot, comparison.path);
+        const localPath = path.join(this.projectRoot, '.claude', comparison.path);
+        try {
+            switch (comparison.state) {
+                case 'new':
+                    return await this.createNewFile(templatePath, localPath, comparison);
+                case 'safe-update':
+                    return await this.safeUpdate(templatePath, localPath, comparison);
+                case 'identical':
+                    return {
+                        path: comparison.path,
+                        success: true,
+                        method: 'auto-safe'
+                    };
+                case 'conflict':
+                    return {
+                        path: comparison.path,
+                        success: false,
+                        method: 'conflict',
+                        diff: this.options.generateDiffs ? await this.generateDiff(localPath, templatePath) : undefined
+                    };
+                case 'deleted':
+                case 'user-only':
+                    return {
+                        path: comparison.path,
+                        success: false,
+                        method: 'skip',
+                        error: `File state '${comparison.state}' cannot be auto-merged`
+                    };
+                default:
+                    return {
+                        path: comparison.path,
+                        success: false,
+                        method: 'skip',
+                        error: `Unknown state: ${comparison.state}`
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                path: comparison.path,
+                success: false,
+                method: 'skip',
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Create new file (no local version exists)
+     *
+     * @param templatePath - Path to template file
+     * @param localPath - Path where local file should be created
+     * @param comparison - File comparison
+     * @returns Merge result
+     */
+    async createNewFile(templatePath, localPath, comparison) {
+        try {
+            // Read template content
+            const content = await fs.readFile(templatePath, 'utf8');
+            // Create directory if needed
+            await fs.mkdir(path.dirname(localPath), { recursive: true });
+            // Write file
+            await fs.writeFile(localPath, content, 'utf8');
+            return {
+                path: comparison.path,
+                success: true,
+                method: 'auto-create'
+            };
+        }
+        catch (error) {
+            return {
+                path: comparison.path,
+                success: false,
+                method: 'skip',
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Safe update (local exists but not user-modified)
+     *
+     * @param templatePath - Path to template file
+     * @param localPath - Path to local file
+     * @param comparison - File comparison
+     * @returns Merge result
+     */
+    async safeUpdate(templatePath, localPath, comparison) {
+        try {
+            // Read template content
+            const content = await fs.readFile(templatePath, 'utf8');
+            // Generate diff before updating
+            const diff = this.options.generateDiffs
+                ? await this.generateDiff(localPath, templatePath)
+                : undefined;
+            // Create backup if enabled
+            if (this.options.createBackups) {
+                await this.createBackup(localPath);
+            }
+            // Write file
+            await fs.writeFile(localPath, content, 'utf8');
+            return {
+                path: comparison.path,
+                success: true,
+                method: 'auto-safe',
+                diff
+            };
+        }
+        catch (error) {
+            return {
+                path: comparison.path,
+                success: false,
+                method: 'skip',
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Overwrite file with template (for conflict resolution)
+     *
+     * @param templatePath - Path to template file
+     * @param localPath - Path to local file
+     * @returns Merge result
+     */
+    async overwriteFile(templatePath, localPath) {
+        try {
+            // Read template content
+            const content = await fs.readFile(templatePath, 'utf8');
+            // Create backup if enabled
+            if (this.options.createBackups) {
+                await this.createBackup(localPath);
+            }
+            // Write file
+            await fs.writeFile(localPath, content, 'utf8');
+            return {
+                path: path.relative(this.projectRoot, localPath),
+                success: true,
+                method: 'overwrite'
+            };
+        }
+        catch (error) {
+            return {
+                path: path.relative(this.projectRoot, localPath),
+                success: false,
+                method: 'skip',
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Create backup of a file
+     *
+     * @param filePath - Path to file to backup
+     */
+    async createBackup(filePath) {
+        const backupDir = this.options.backupDir ?? path.join(this.projectRoot, '.k0ntext', 'backups');
+        await fs.mkdir(backupDir, { recursive: true });
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupPath = path.join(backupDir, `${path.basename(filePath)}.${timestamp}.bak`);
+        await fs.copyFile(filePath, backupPath);
+    }
+    /**
+     * Generate unified diff between two files
+     *
+     * @param localPath - Path to local file
+     * @param templatePath - Path to template file
+     * @returns Unified diff string
+     */
+    async generateDiff(localPath, templatePath) {
+        try {
+            const localContent = await this.readFileSafe(localPath);
+            const templateContent = await this.readFileSafe(templatePath);
+            const localLines = localContent.split('\n');
+            const templateLines = templateContent.split('\n');
+            return this.unifiedDiff(localLines, templateLines, localPath, templatePath);
+        }
+        catch {
+            return '(diff unavailable)';
+        }
+    }
+    /**
+     * Read file safely, return empty string if not found
+     *
+     * @param filePath - Path to file
+     * @returns File content
+     */
+    async readFileSafe(filePath) {
+        try {
+            return await fs.readFile(filePath, 'utf8');
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Generate unified diff (simplified implementation)
+     *
+     * @param localLines - Local file lines
+     * @param templateLines - Template file lines
+     * @param localPath - Local file path (for header)
+     * @param templatePath - Template file path (for header)
+     * @returns Unified diff string
+     */
+    unifiedDiff(localLines, templateLines, localPath, templatePath) {
+        const context = this.options.diffContext ?? 3;
+        const lines = [];
+        // Simple diff header
+        lines.push(`--- ${path.basename(localPath)}`);
+        lines.push(`+++ ${path.basename(templatePath)}`);
+        // Find differences
+        let i = 0;
+        let j = 0;
+        while (i < localLines.length || j < templateLines.length) {
+            if (i < localLines.length && j < templateLines.length) {
+                if (localLines[i] === templateLines[j]) {
+                    // Context line (show only first few around changes)
+                    if (this.shouldShowContext(i, localLines, templateLines)) {
+                        lines.push(` ${localLines[i]}`);
+                    }
+                    i++;
+                    j++;
+                }
+                else {
+                    // Difference found - show context
+                    this.showContext(lines, localLines, templateLines, i, j, context);
+                    // Show changes
+                    const localEnd = this.findChangeEnd(localLines, i, templateLines[j]);
+                    const templateEnd = this.findChangeEnd(templateLines, j, localLines[i]);
+                    for (let k = i; k < localEnd; k++) {
+                        lines.push(`-${localLines[k]}`);
+                    }
+                    for (let k = j; k < templateEnd; k++) {
+                        lines.push(`+${templateLines[k]}`);
+                    }
+                    i = localEnd;
+                    j = templateEnd;
+                }
+            }
+            else if (i < localLines.length) {
+                // Remaining lines in local (deletions)
+                lines.push(`-${localLines[i]}`);
+                i++;
+            }
+            else {
+                // Remaining lines in template (additions)
+                lines.push(`+${templateLines[j]}`);
+                j++;
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Check if context should be shown
+     */
+    shouldShowContext(i, localLines, templateLines) {
+        // Show context if we're near a change or at the start/end
+        const context = this.options.diffContext ?? 3;
+        // Check if there's a change nearby
+        for (let offset = 1; offset <= context; offset++) {
+            if (i + offset < localLines.length && i + offset < templateLines.length) {
+                if (localLines[i + offset] !== templateLines[i + offset]) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Show context lines before a change
+     */
+    showContext(lines, localLines, templateLines, i, j, context) {
+        const start = Math.max(0, i - context);
+        // Show context lines if not already shown
+        for (let k = start; k < i; k++) {
+            if (localLines[k] === templateLines[k]) {
+                const lastLine = lines[lines.length - 1];
+                if (!lastLine || lastLine[0] !== ' ') {
+                    lines.push(` ${localLines[k]}`);
+                }
+            }
+        }
+    }
+    /**
+     * Find end of a change block
+     */
+    findChangeEnd(lines, start, otherValue) {
+        let end = start + 1;
+        while (end < lines.length && lines[end] !== otherValue) {
+            end++;
+        }
+        return end;
+    }
+    /**
+     * Get merge statistics from results
+     *
+     * @param results - Array of merge results
+     * @returns Statistics
+     */
+    static getStatistics(results) {
+        const stats = {
+            total: results.length,
+            successful: 0,
+            failed: 0,
+            byMethod: {
+                'auto-safe': 0,
+                'auto-create': 0,
+                overwrite: 0,
+                skip: 0,
+                conflict: 0
+            }
+        };
+        for (const result of results) {
+            if (result.success) {
+                stats.successful++;
+            }
+            else {
+                stats.failed++;
+            }
+            stats.byMethod[result.method]++;
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=merger.js.map

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

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

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

@@ -0,0 +1,106 @@
+/**
+ * Template Scanner
+ *
+ * Scans template directories for files to sync.
+ * Recursively discovers files while respecting exclude patterns.
+ */
+import type { TemplateFile, TemplateSubdir } from './types.js';
+/**
+ * Scan result with metadata
+ */
+export interface ScanResult {
+    /** Files found */
+    files: TemplateFile[];
+    /** Subdirectories scanned */
+    subdirectories: TemplateSubdir[];
+    /** Files skipped due to exclude patterns */
+    skipped: string[];
+    /** Scan duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Scans template directories for files
+ */
+export declare class TemplateScanner {
+    /**
+     * Scan a directory for template files recursively
+     *
+     * @param rootPath - Root directory to scan (e.g., templates/base/.claude/)
+     * @param subdirectories - Subdirectories to include
+     * @param excludePatterns - Patterns to exclude
+     * @returns Array of template files found
+     */
+    static scanDirectory(rootPath: string, subdirectories?: TemplateSubdir[], excludePatterns?: string[]): Promise<TemplateFile[]>;
+    /**
+     * Scan with detailed result metadata
+     *
+     * @param rootPath - Root directory to scan
+     * @param subdirectories - Subdirectories to include
+     * @param excludePatterns - Patterns to exclude
+     * @returns Detailed scan result
+     */
+    static scan(rootPath: string, subdirectories?: TemplateSubdir[], excludePatterns?: string[]): Promise<ScanResult>;
+    /**
+     * Recursively scan directory
+     *
+     * @param dirPath - Current directory path
+     * @param basePath - Base path for relative path calculation
+     * @param excludePatterns - Patterns to exclude
+     * @returns Array of template files found
+     */
+    private static scanRecursive;
+    /**
+     * Check if a file/directory should be excluded
+     *
+     * @param name - File or directory name
+     * @param excludePatterns - Patterns to check against
+     * @returns true if should be excluded
+     */
+    private static shouldExclude;
+    /**
+     * Get all template subdirectories to sync
+     */
+    static getSyncedSubdirs(): TemplateSubdir[];
+    /**
+     * Get excluded subdirectories
+     */
+    static getExcludedSubdirs(): string[];
+    /**
+     * Check if a subdirectory should be synced
+     *
+     * @param subdir - Subdirectory name
+     * @returns true if subdirectory should be synced
+     */
+    static isSyncedSubdir(subdir: string): subdir is TemplateSubdir;
+    /**
+     * Check if a subdirectory should be excluded
+     *
+     * @param subdir - Subdirectory name
+     * @returns true if subdirectory should be excluded
+     */
+    static isExcludedSubdir(subdir: string): boolean;
+    /**
+     * Scan and hash files in one pass
+     *
+     * @param rootPath - Root directory to scan
+     * @param subdirectories - Subdirectories to include
+     * @returns Array of template files with hashes
+     */
+    static scanAndHash(rootPath: string, subdirectories?: TemplateSubdir[]): Promise<TemplateFile[]>;
+    /**
+     * Get file count by subdirectory
+     *
+     * @param files - Array of template files
+     * @returns Map of subdirectory to file count
+     */
+    static getFileCountBySubdir(files: TemplateFile[]): Map<string, number>;
+    /**
+     * Filter files by subdirectory
+     *
+     * @param files - Array of template files
+     * @param subdir - Subdirectory to filter by
+     * @returns Filtered array of files
+     */
+    static filterBySubdir(files: TemplateFile[], subdir: string): TemplateFile[];
+}
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/template-sync/scanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,6BAA6B;IAC7B,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;;OAOG;WACU,aAAa,CACxB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,cAAc,EAAqB,EACnD,eAAe,GAAE,MAAM,EAA6B,GACnD,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1B;;;;;;;OAOG;WACU,IAAI,CACf,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,cAAc,EAAqB,EACnD,eAAe,GAAE,MAAM,EAA6B,GACnD,OAAO,CAAC,UAAU,CAAC;IActB;;;;;;;OAOG;mBACkB,aAAa;IA8ClC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,cAAc,EAAE;IAI3C;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,cAAc;IAI/D;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;;OAMG;WACU,WAAW,CACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,cAAc,EAAE,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC;IAgB1B;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAWvE;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;CAG7E"}

package/dist/template-sync/scanner.js

@@ -0,0 +1,196 @@
+/**
+ * Template Scanner
+ *
+ * Scans template directories for files to sync.
+ * Recursively discovers files while respecting exclude patterns.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { TEMPLATE_SUBDIRS, EXCLUDED_SUBDIRS } from './types.js';
+import { TemplateHasher } from './hasher.js';
+/**
+ * Default exclude patterns for directory scanning
+ */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    'node_modules',
+    '.git',
+    '.DS_Store',
+    '*.log',
+    '.k0ntext-manifest.json'
+];
+/**
+ * Scans template directories for files
+ */
+export class TemplateScanner {
+    /**
+     * Scan a directory for template files recursively
+     *
+     * @param rootPath - Root directory to scan (e.g., templates/base/.claude/)
+     * @param subdirectories - Subdirectories to include
+     * @param excludePatterns - Patterns to exclude
+     * @returns Array of template files found
+     */
+    static async scanDirectory(rootPath, subdirectories = TEMPLATE_SUBDIRS, excludePatterns = DEFAULT_EXCLUDE_PATTERNS) {
+        const results = [];
+        for (const subdir of subdirectories) {
+            const dirPath = path.join(rootPath, subdir);
+            const files = await this.scanRecursive(dirPath, rootPath, excludePatterns);
+            results.push(...files);
+        }
+        return results;
+    }
+    /**
+     * Scan with detailed result metadata
+     *
+     * @param rootPath - Root directory to scan
+     * @param subdirectories - Subdirectories to include
+     * @param excludePatterns - Patterns to exclude
+     * @returns Detailed scan result
+     */
+    static async scan(rootPath, subdirectories = TEMPLATE_SUBDIRS, excludePatterns = DEFAULT_EXCLUDE_PATTERNS) {
+        const startTime = Date.now();
+        const skipped = [];
+        const files = await this.scanDirectory(rootPath, subdirectories, excludePatterns);
+        return {
+            files,
+            subdirectories,
+            skipped,
+            durationMs: Date.now() - startTime
+        };
+    }
+    /**
+     * Recursively scan directory
+     *
+     * @param dirPath - Current directory path
+     * @param basePath - Base path for relative path calculation
+     * @param excludePatterns - Patterns to exclude
+     * @returns Array of template files found
+     */
+    static async scanRecursive(dirPath, basePath, excludePatterns) {
+        const results = [];
+        try {
+            const entries = await fs.readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                // Skip excluded patterns
+                if (this.shouldExclude(entry.name, excludePatterns)) {
+                    continue;
+                }
+                const fullPath = path.join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    // Recursively scan subdirectories
+                    const subdirResults = await this.scanRecursive(fullPath, basePath, excludePatterns);
+                    results.push(...subdirResults);
+                }
+                else if (entry.isFile()) {
+                    // Get file stats
+                    const stats = await fs.stat(fullPath);
+                    const relativePath = path.relative(basePath, fullPath).split(path.sep).join('/');
+                    results.push({
+                        relativePath,
+                        hash: '', // Hashed later to avoid double work
+                        size: stats.size,
+                        mtime: stats.mtime
+                    });
+                }
+            }
+        }
+        catch (error) {
+            // Directory doesn't exist or cannot be read - skip silently
+            if (error.code !== 'ENOENT') {
+                // Log non-ENOINT errors but don't fail
+                console.warn(`Warning: Could not scan directory ${dirPath}: ${error}`);
+            }
+        }
+        return results;
+    }
+    /**
+     * Check if a file/directory should be excluded
+     *
+     * @param name - File or directory name
+     * @param excludePatterns - Patterns to check against
+     * @returns true if should be excluded
+     */
+    static shouldExclude(name, excludePatterns) {
+        return excludePatterns.some(pattern => {
+            if (pattern.includes('*')) {
+                // Glob pattern
+                const regex = new RegExp('^' + pattern.replace(/\*/g, '.*').replace(/\?/g, '.') + '$');
+                return regex.test(name);
+            }
+            return name === pattern || name.includes(pattern);
+        });
+    }
+    /**
+     * Get all template subdirectories to sync
+     */
+    static getSyncedSubdirs() {
+        return [...TEMPLATE_SUBDIRS];
+    }
+    /**
+     * Get excluded subdirectories
+     */
+    static getExcludedSubdirs() {
+        return [...EXCLUDED_SUBDIRS];
+    }
+    /**
+     * Check if a subdirectory should be synced
+     *
+     * @param subdir - Subdirectory name
+     * @returns true if subdirectory should be synced
+     */
+    static isSyncedSubdir(subdir) {
+        return TEMPLATE_SUBDIRS.includes(subdir);
+    }
+    /**
+     * Check if a subdirectory should be excluded
+     *
+     * @param subdir - Subdirectory name
+     * @returns true if subdirectory should be excluded
+     */
+    static isExcludedSubdir(subdir) {
+        return EXCLUDED_SUBDIRS.includes(subdir);
+    }
+    /**
+     * Scan and hash files in one pass
+     *
+     * @param rootPath - Root directory to scan
+     * @param subdirectories - Subdirectories to include
+     * @returns Array of template files with hashes
+     */
+    static async scanAndHash(rootPath, subdirectories) {
+        // Use scan() to get files, then hash them
+        const result = await this.scan(rootPath, subdirectories);
+        // Hash files in parallel
+        const hashedFiles = await Promise.all(result.files.map(async (file) => {
+            const fullPath = path.join(rootPath, file.relativePath);
+            const hash = await TemplateHasher.hashFileSafe(fullPath);
+            return { ...file, hash };
+        }));
+        return hashedFiles;
+    }
+    /**
+     * Get file count by subdirectory
+     *
+     * @param files - Array of template files
+     * @returns Map of subdirectory to file count
+     */
+    static getFileCountBySubdir(files) {
+        const counts = new Map();
+        for (const file of files) {
+            const subdir = file.relativePath.split(path.sep)[0];
+            counts.set(subdir, (counts.get(subdir) ?? 0) + 1);
+        }
+        return counts;
+    }
+    /**
+     * Filter files by subdirectory
+     *
+     * @param files - Array of template files
+     * @param subdir - Subdirectory to filter by
+     * @returns Filtered array of files
+     */
+    static filterBySubdir(files, subdir) {
+        return files.filter(file => file.relativePath.startsWith(subdir + path.sep));
+    }
+}
+//# sourceMappingURL=scanner.js.map