@egentica/codemap 0.1.5

package/dist/core/FileSystemIO.js

@@ -0,0 +1,403 @@
+"use strict";
+/**
+ * FileSystemIO — The Controlled Gateway
+ *
+ * All file operations in CodeMap flow through this gateway.
+ * Wraps FileSystemProvider and emits lifecycle events for plugins.
+ *
+ * NEW FEATURES:
+ * - Line range writes via LineRangeWriter
+ * - Target parsing with wildcards and line ranges
+ * - Annotation metadata via AnnotationStore
+ *
+ * This is where TimeWarp hooks into file:write:before to capture snapshots.
+ * Plugins CANNOT bypass this gateway — no direct FS access allowed.
+ *
+ * @codemap.domain.name File System Gateway
+ * @codemap.usage Add new file operation types (copy, move, chmod, etc)
+ * @codemap.usage Modify event emission logic for lifecycle hooks (file:write:before, file:write:after)
+ * @codemap.usage Integrate new features (line range operations, wildcards, safety guards)
+ * @codemap.usage Fix file operation bugs or add validation/safety checks
+ * @codemap.usage Change how FileSystemProvider is wrapped or called
+ * @codemap.policy This is the ONLY place in CodeMap that touches FileSystemProvider.
+ * @codemap.policy All plugins must use codemap.fs — no bypass, no history gaps.
+ * @codemap.warning Event handlers are async. await emit() before continuing.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemIO = void 0;
+const path = __importStar(require("node:path"));
+const TargetParser_1 = require("./TargetParser");
+const LineRangeWriter_1 = require("./LineRangeWriter");
+const AnnotationStore_1 = require("./AnnotationStore");
+const WriteSafetyGuard_1 = require("./WriteSafetyGuard");
+/**
+ * FileSystemIO wraps a storage provider and emits lifecycle events.
+ *
+ * Lifecycle flow:
+ * 1. Plugin registers handler via codemap.on('file:write:before', handler)
+ * 2. User calls codemap.fs.write(path, content)
+ * 3. FileSystemIO emits 'file:write:before' → handlers run (TimeWarp captures)
+ * 4. FileSystemIO calls provider.write(path, content)
+ * 5. FileSystemIO emits 'file:write:after' → handlers run (graph updates)
+ *
+ * Result: No writes can bypass history tracking.
+ */
+class FileSystemIO {
+    provider;
+    eventHandlers;
+    targetParser;
+    lineRangeWriter;
+    annotationStore;
+    safetyGuard;
+    codemap = null; // Reference to CodeMap for parser access
+    constructor(provider, codemapRoot = '.codemap') {
+        this.provider = provider;
+        this.eventHandlers = new Map();
+        this.targetParser = new TargetParser_1.TargetParser();
+        this.lineRangeWriter = new LineRangeWriter_1.LineRangeWriter(provider);
+        this.annotationStore = new AnnotationStore_1.AnnotationStore(provider, codemapRoot);
+        this.safetyGuard = new WriteSafetyGuard_1.WriteSafetyGuard(provider);
+    }
+    /**
+     * Set CodeMap reference for parser access.
+     * Called during CodeMap initialization.
+     *
+     * @param codemap - CodeMap instance
+     */
+    setCodeMap(codemap) {
+        this.codemap = codemap;
+    }
+    /**
+     * Register an event handler.
+     * Used internally by CodeMap to wire up plugin hooks.
+     */
+    on(event, handler) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, []);
+        }
+        this.eventHandlers.get(event).push(handler);
+    }
+    /**
+     * Emit an event to all registered handlers.
+     * Handlers run sequentially (await each before next).
+     */
+    async emit(event, payload) {
+        const handlers = this.eventHandlers.get(event) || [];
+        for (const handler of handlers) {
+            await handler(payload);
+        }
+    }
+    // ── Target Parsing ─────────────────────────────────────────────────────────
+    /**
+     * Parse a target string (supports wildcards and line ranges).
+     *
+     * @param target - Target string (e.g., "file.ts:10-20" or "src/*.vue")
+     * @returns Parsed target structure
+     */
+    parseTarget(target) {
+        return this.targetParser.parse(target);
+    }
+    /**
+     * Resolve wildcards to concrete file paths.
+     *
+     * @param _pattern - Wildcard pattern (e.g., "src/components/*.vue")
+     * @returns Array of matching file paths
+     */
+    async resolveWildcard(_pattern) {
+        // TODO: Implement glob matching
+        // For now, return empty array (will be implemented in Scanner)
+        return [];
+    }
+    // ── Read Operations ────────────────────────────────────────────────────────
+    /**
+     * Read file content.
+     * Supports line range extraction via target parsing.
+     *
+     * @param target - File path or "file.ts:10-20" for line range
+     * @returns File content (full or line range)
+     */
+    async read(target) {
+        // Check if target contains line range syntax
+        const hasLineRange = /:\d+(-\d+)?$/.test(target);
+        // If target is an absolute path without line range, skip parsing
+        // (TargetParser.normalizePath() converts dots to slashes, breaking paths like .codemap)
+        if (!hasLineRange && path.isAbsolute(target)) {
+            return await this.provider.read(target);
+        }
+        // Otherwise parse target (may have line range or dot notation)
+        const parsed = this.targetParser.parse(target);
+        // Read full file
+        const content = await this.provider.read(parsed.basePath);
+        // Extract line range if specified
+        if (parsed.lineRange) {
+            return this.targetParser.extractLineRange(content, parsed.lineRange);
+        }
+        return content;
+    }
+    /**
+     * Check if file/directory exists.
+     * No lifecycle events — read is passive.
+     */
+    async exists(path) {
+        return this.provider.exists(path);
+    }
+    /**
+     * Read directory contents.
+     * No lifecycle events — read is passive.
+     */
+    async readdir(path) {
+        return this.provider.readdir(path);
+    }
+    /**
+     * Get file/directory stats.
+     * No lifecycle events — read is passive.
+     */
+    async stat(path) {
+        return this.provider.stat(path);
+    }
+    // ── Write Operations ───────────────────────────────────────────────────────
+    /**
+     * Write file content.
+     * Supports line range replacement via target parsing.
+     *
+     * @param target - File path or "file.ts:10-20" for line range replacement
+     * @param content - Content to write
+     * @param options - Write options
+     * @returns Line range result if applicable, otherwise void
+     *
+     * @example
+     * // Full file write
+     * await fs.write("file.ts", "content")
+     *
+     * // Line range replacement
+     * await fs.write("file.ts:10-15", "new content")
+     * // → Replaces lines 10-15 with new content
+     */
+    async write(target, content, options = {}) {
+        // SESSION VALIDATION - all write operations require active session
+        if (this.codemap && !this.codemap.sessionLog.isSessionActive()) {
+            throw new Error('No active session. Run codemap_orient or codemap_session_start first.');
+        }
+        const parsed = this.targetParser.parse(target);
+        const emitEvents = options.emitEvents !== false;
+        // Determine if this is a line range write
+        const lineRange = options.lineRange || parsed.lineRange;
+        // SYNTAX VALIDATION (before any write operations)
+        // Only validate full-file writes (not line range replacements)
+        if (!lineRange && !options.skipValidation && this.codemap) {
+            const parser = this.codemap.getParserForFile(parsed.basePath);
+            if (parser?.validateSyntax) {
+                try {
+                    const result = await parser.validateSyntax(content, parsed.basePath);
+                    if (!result.valid && result.errors && result.errors.length > 0) {
+                        // Format error messages
+                        const errorMessages = result.errors.map((err) => `  Line ${err.line}, Col ${err.column}: ${err.message}${err.suggestion ? `\n    Suggestion: ${err.suggestion}` : ''}`).join('\n');
+                        throw new Error(`Syntax validation failed for ${parsed.basePath}:\n\n` +
+                            errorMessages +
+                            `\n\nFile was NOT written to prevent corruption.\n` +
+                            `To force write despite errors, pass { skipValidation: true }.`);
+                    }
+                }
+                catch (validationError) {
+                    // Re-throw validation errors (they already have good messages)
+                    if (validationError.message?.includes('Syntax validation failed')) {
+                        throw validationError;
+                    }
+                    // Log but don't block on parser errors (parser might be broken)
+                    console.warn(`Warning: Syntax validation error for ${parsed.basePath}:`, validationError.message);
+                }
+            }
+        }
+        if (lineRange) {
+            // Line range replacement
+            const payload = {
+                path: parsed.basePath,
+                content,
+                lineRange,
+                operation: 'write_line_range'
+            };
+            if (emitEvents) {
+                await this.emit('file:write:before', payload);
+            }
+            const result = await this.lineRangeWriter.replaceLines(parsed.basePath, lineRange, content);
+            if (emitEvents) {
+                await this.emit('file:write:after', { ...payload, result });
+            }
+            return result;
+        }
+        else {
+            // Full file write with safety guarantees
+            const payload = {
+                path: parsed.basePath,
+                content,
+                operation: 'write_full'
+            };
+            if (emitEvents) {
+                await this.emit('file:write:before', payload);
+            }
+            // Use safety guard for protected write
+            const result = await this.safetyGuard.safeWrite(parsed.basePath, content);
+            if (!result.success) {
+                throw new Error(`Write failed: ${result.error}`);
+            }
+            if (emitEvents) {
+                await this.emit('file:write:after', { ...payload, safetyResult: result });
+            }
+        }
+    }
+    /**
+     * Append content to file.
+     *
+     * @param path - File path
+     * @param content - Content to append
+     * @param options - Write options (including skipValidation)
+     */
+    async append(path, content, options) {
+        const existing = await this.provider.read(path);
+        await this.write(path, existing + content, options);
+    }
+    /**
+     * Remove file.
+     * Emits: file:delete
+     *
+     * TimeWarp can hook into this for deletion tracking.
+     */
+    async remove(path) {
+        // SESSION VALIDATION - all delete operations require active session
+        if (this.codemap && !this.codemap.sessionLog.isSessionActive()) {
+            throw new Error('No active session. Run codemap_orient or codemap_session_start first.');
+        }
+        const payload = { path, operation: 'delete' };
+        // Perform deletion
+        await this.provider.remove(path);
+        // Notify plugins (graph cleanup, history tracking)
+        await this.emit('file:delete', payload);
+    }
+    /**
+     * Create directory.
+     * No lifecycle events — directory creation is structural.
+     */
+    async mkdir(path) {
+        return this.provider.mkdir(path);
+    }
+    /**
+     * Remove directory.
+     * No lifecycle events for now — can add if needed.
+     */
+    async rmdir(path, options) {
+        return this.provider.rmdir(path, options);
+    }
+    /**
+     * Rename/move file.
+     * Emits: file:rename
+     *
+     * TimeWarp can hook into this for history continuity across renames.
+     */
+    async rename(oldPath, newPath) {
+        // SESSION VALIDATION - all rename operations require active session
+        if (this.codemap && !this.codemap.sessionLog.isSessionActive()) {
+            throw new Error('No active session. Run codemap_orient or codemap_session_start first.');
+        }
+        const payload = {
+            oldPath,
+            newPath,
+            operation: 'rename'
+        };
+        // Perform rename
+        await this.provider.rename(oldPath, newPath);
+        // Notify plugins (graph updates, history tracking)
+        await this.emit('file:rename', payload);
+    }
+    // ── Annotation Operations ──────────────────────────────────────────────────
+    /**
+     * Get annotation store for direct access.
+     * Used by higher-level operations that manage annotations.
+     */
+    getAnnotationStore() {
+        return this.annotationStore;
+    }
+    /**
+     * Attach annotations to a file (convenience method).
+     *
+     * @param target - File path
+     * @param annotations - Array of annotation strings
+     * @returns Attachment result
+     */
+    async attachAnnotations(target, annotations) {
+        return this.annotationStore.attach(target, annotations);
+    }
+    /**
+     * Get annotations for a file (convenience method).
+     *
+     * @param target - File path
+     * @returns Annotation set (inline + meta)
+     */
+    async getAnnotations(target) {
+        return this.annotationStore.get(target);
+    }
+    // ── Public Safety API ──────────────────────────────────────────────────────
+    /**
+     * Verify a replace operation before executing.
+     * Returns context around matches for user confirmation.
+     *
+     * @param path - File path
+     * @param oldString - String to find
+     * @returns Verification result
+     */
+    async verifyReplace(path, oldString) {
+        return this.safetyGuard.verifyReplaceTarget(path, oldString);
+    }
+    /**
+     * Safely replace text in file.
+     * Uses all write safety guarantees.
+     *
+     * @param path - File path
+     * @param oldString - Text to find (must be unique)
+     * @param newString - Replacement text
+     * @returns Write result
+     */
+    async safeReplace(path, oldString, newString) {
+        return this.safetyGuard.safeReplace(path, oldString, newString);
+    }
+    /**
+     * Get the safety guard instance for advanced operations.
+     */
+    getSafetyGuard() {
+        return this.safetyGuard;
+    }
+}
+exports.FileSystemIO = FileSystemIO;
+//# sourceMappingURL=FileSystemIO.js.map

package/dist/core/FileSystemIO.js.map

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

package/dist/core/FuzzyMatcher.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Fuzzy text matching with edit distance and character-level diffs.
+ *
+ * IMPROVEMENTS OVER OLD VERSION:
+ * - Uses Levenshtein edit distance for accurate similarity scoring
+ * - Generates character-level diffs: {-removed-}{+added+}
+ * - Gentler normalization (preserves structure, only normalizes line endings)
+ * - Never rejects matches - always shows best attempt
+ * - Detailed diff output for debugging
+ *
+ * @codemap.domain.name Fuzzy Matching
+ * @codemap.domain.relevance 1.0
+ * @codemap.domain.message Edit-distance-based text matching with visual diffs
+ */
+export interface LineMatchResult {
+    lineIndex: number;
+    confidence: number;
+    matchedText: string;
+    diff?: string;
+}
+export interface TextMatchResult {
+    startLine: number;
+    endLine: number;
+    confidence: number;
+    matchedText: string;
+    diff?: string;
+}
+export declare class FuzzyMatcher {
+    /**
+     * Find best matching line near a center point with tolerance.
+     * Returns best match regardless of confidence - never returns null unless no lines to search.
+     */
+    findBestLineMatch(lines: string[], targetLine: string, centerLine: number, tolerance?: number): LineMatchResult | null;
+    /**
+     * Find best matching multi-line text block.
+     * Returns best match regardless of confidence - never returns null unless no text to search.
+     */
+    findBestTextMatch(lines: string[], targetText: string, range?: {
+        start: number;
+        end: number;
+    }): TextMatchResult | null;
+    /**
+     * Check if two texts match (gentle normalization only).
+     */
+    textMatches(text1: string, text2: string): boolean;
+    /**
+     * Count matching lines between two texts.
+     */
+    countMatchingLines(text1: string, text2: string): number;
+}
+//# sourceMappingURL=FuzzyMatcher.d.ts.map

package/dist/core/FuzzyMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FuzzyMatcher.d.ts","sourceRoot":"","sources":["../../src/core/FuzzyMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwGH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;IAEvB;;;OAGG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAU,GACpB,eAAe,GAAG,IAAI;IA4EzB;;;OAGG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GACrC,eAAe,GAAG,IAAI;IAwFzB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlD;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAezD"}