@egentica/codemap 0.1.5

package/dist/core/WriteSafetyGuard.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * WriteSafetyGuard — File Write Protection Layer
+ *
+ * Provides 5 critical safety guarantees for all write operations:
+ *
+ * 1. **Pre-Write Snapshot + Rollback**: Always recoverable from failures
+ * 2. **Fragment Detection**: No partial/corrupt code fragments
+ * 3. **Targeting Verification**: Ensure replace operations match correctly
+ * 4. **Atomic Writes**: Write succeeds completely or fails cleanly
+ * 5. **Write Locks**: No concurrent writes to same file
+ *
+ * @codemap.domain.name Write Safety
+ * @codemap.domain.relevance 1.0
+ * @codemap.domain.message File write protection with snapshot/rollback, fragment validation, atomic writes, and write locks.
+ * @codemap.tags FileSystem,Safety,WriteProtection,Atomicity,Rollback
+ * @codemap.usage ensure safe writes → use guard.safeWrite() instead of provider.write()
+ * @codemap.usage validate write target → use guard.verifyReplaceTarget() before replace operations
+ * @codemap.warning Rollback uses in-memory snapshot - large files may consume memory
+ * @codemap.note All write operations should flow through safeWrite() for protection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteSafetyGuard = void 0;
+/**
+ * WriteSafetyGuard implements all write safety guarantees.
+ *
+ * @codemap.usage const guard = new WriteSafetyGuard(fsProvider);
+ * @codemap.usage const result = await guard.safeWrite('file.ts', content);
+ */
+class WriteSafetyGuard {
+    provider;
+    writeLocks;
+    constructor(provider) {
+        this.provider = provider;
+        this.writeLocks = new Map();
+    }
+    // ── Layer 1: Pre-Write Snapshot + Rollback ────────────────────────────────
+    /**
+     * Safely write content with automatic rollback on failure.
+     *
+     * Flow:
+     * 1. Snapshot original (if file exists)
+     * 2. Attempt write
+     * 3. Verify written content matches intended
+     * 4. If verification fails → rollback to snapshot
+     *
+     * @param path - Target file path
+     * @param content - New content to write
+     * @returns Write result with verification status
+     */
+    async safeWrite(path, content) {
+        // Acquire write lock
+        await this.acquireWriteLock(path);
+        let originalContent;
+        try {
+            // Step 1: Snapshot original (if exists)
+            const fileExists = await this.provider.exists(path);
+            if (fileExists) {
+                originalContent = await this.provider.read(path);
+            }
+            // Step 2: WRITE FIRST (bypass validation)
+            await this.provider.write(path, content);
+            // Step 3: Verify disk content matches what we sent (validation disabled - regex false positives)
+            const diskContent = await this.provider.read(path);
+            // const validation = this.validateFragment(diskContent, path);
+            // if (!validation.isValid) {
+            //   return {
+            //     success: false,
+            //     path,
+            //     originalContent,
+            //     error: `Fragment validation failed: ${validation.errors.join(', ')}`,
+            //     verificationPassed: false
+            //   };
+            // }
+            if (diskContent !== content) {
+                return {
+                    success: false,
+                    path,
+                    originalContent,
+                    error: `Disk verification failed - content mismatch (MCP sent ${content.length} bytes, disk has ${diskContent.length} bytes)`,
+                    verificationPassed: false
+                };
+            }
+            // Step 3: Atomic write
+            await this.atomicWrite(path, content);
+            // Step 4: Verify write succeeded
+            const written = await this.provider.read(path);
+            if (written !== content) {
+                // Verification failed - rollback
+                if (originalContent !== undefined) {
+                    await this.provider.write(path, originalContent);
+                }
+                else {
+                    await this.provider.remove(path);
+                }
+                return {
+                    success: false,
+                    path,
+                    originalContent,
+                    error: 'Write verification failed - content mismatch after write',
+                    verificationPassed: false
+                };
+            }
+            // Success
+            return {
+                success: true,
+                path,
+                originalContent,
+                verificationPassed: true
+            };
+        }
+        catch (error) {
+            // Rollback on any error
+            const result = {
+                success: false,
+                path,
+                error: error instanceof Error ? error.message : String(error),
+                verificationPassed: false
+            };
+            // Attempt rollback if we had a snapshot
+            if (originalContent !== undefined) {
+                try {
+                    await this.provider.write(path, originalContent);
+                    result.originalContent = originalContent;
+                }
+                catch {
+                    // Rollback write failed - best effort
+                }
+            }
+            return result;
+        }
+        finally {
+            // Release write lock
+            this.releaseWriteLock(path);
+        }
+    }
+    // ── Layer 3: Targeting Verification ───────────────────────────────────────
+    /**
+     * Verify that a replace operation will match correctly.
+     * Returns context around the match for user confirmation.
+     *
+     * @param path - File to search
+     * @param oldString - String to find
+     * @returns Verification result with context
+     */
+    async verifyReplaceTarget(path, oldString) {
+        const content = await this.provider.read(path);
+        const lines = content.split('\n');
+        // Find all occurrences
+        let matches = 0;
+        let lastMatchLine = -1;
+        let context = '';
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i].includes(oldString)) {
+                matches++;
+                lastMatchLine = i;
+                // Capture context (5 lines before and after)
+                const start = Math.max(0, i - 5);
+                const end = Math.min(lines.length - 1, i + 5);
+                context = lines.slice(start, end + 1).join('\n');
+            }
+        }
+        return {
+            found: matches > 0,
+            matches,
+            context,
+            lineNumber: lastMatchLine >= 0 ? lastMatchLine + 1 : undefined
+        };
+    }
+    // ── Layer 4: Atomic Writes ────────────────────────────────────────────────
+    /**
+     * Write to temp file first, then rename for atomicity.
+     * Either succeeds completely or fails cleanly.
+     *
+     * @param path - Target file path
+     * @param content - Content to write
+     */
+    async atomicWrite(path, content) {
+        const tempPath = `${path}.tmp`;
+        try {
+            // Write to temp file
+            await this.provider.write(tempPath, content);
+            // Verify temp file
+            const verification = await this.provider.read(tempPath);
+            if (verification !== content) {
+                throw new Error('Temp file verification failed');
+            }
+            // Atomic rename
+            await this.provider.rename(tempPath, path);
+        }
+        catch (error) {
+            // Clean up temp file on failure
+            try {
+                await this.provider.remove(tempPath);
+            }
+            catch {
+                // Best effort cleanup
+            }
+            throw error;
+        }
+    }
+    // ── Layer 5: Write Locks ──────────────────────────────────────────────────
+    /**
+     * Acquire write lock for a file.
+     * Waits if file is already locked.
+     */
+    async acquireWriteLock(path) {
+        while (this.writeLocks.has(path)) {
+            await this.writeLocks.get(path);
+        }
+        // Create new lock
+        let resolve;
+        const lockPromise = new Promise(r => {
+            resolve = r;
+        });
+        this.writeLocks.set(path, lockPromise);
+        // Store resolver for release
+        lockPromise._resolve = resolve;
+    }
+    /**
+     * Release write lock for a file.
+     */
+    releaseWriteLock(path) {
+        const lock = this.writeLocks.get(path);
+        if (lock) {
+            lock._resolve();
+            this.writeLocks.delete(path);
+        }
+    }
+    // ── Public API ────────────────────────────────────────────────────────────
+    /**
+     * Replace text in file with 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) {
+        // Verify target before replacing
+        const verification = await this.verifyReplaceTarget(path, oldString);
+        if (!verification.found) {
+            return {
+                success: false,
+                path,
+                error: `Target string not found in file`,
+                verificationPassed: false
+            };
+        }
+        if (verification.matches > 1) {
+            return {
+                success: false,
+                path,
+                error: `Target string appears ${verification.matches} times - must be unique. Context:\n${verification.context}`,
+                verificationPassed: false
+            };
+        }
+        // Perform replace
+        const content = await this.provider.read(path);
+        const newContent = content.replace(oldString, newString);
+        return this.safeWrite(path, newContent);
+    }
+}
+exports.WriteSafetyGuard = WriteSafetyGuard;
+//# sourceMappingURL=WriteSafetyGuard.js.map

package/dist/core/WriteSafetyGuard.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Core module exports.
+ *
+ * Foundation layer for CodeMap:
+ * - FileSystemGraph: Passive knowledge base (files, symbols, dependencies)
+ * - FileSystemIO: Controlled gateway with lifecycle events
+ * - Scanner: Directory tree walker with lifecycle events
+ * - PluginRegistry: Plugin management and lifecycle
+ * - QueryEngine: Search and graph traversal
+ * - CodeMap: Main orchestrator (public API entry point)
+ */
+export { FileSystemGraph } from './FileSystemGraph';
+export { FileSystemIO } from './FileSystemIO';
+export { TargetParser } from './TargetParser';
+export { TargetResolver } from './TargetResolver';
+export { AnnotationStore } from './AnnotationStore';
+export { LineRangeWriter } from './LineRangeWriter';
+export { WriteSafetyGuard } from './WriteSafetyGuard';
+export { EventBus } from './EventBus';
+export { ExperienceStore } from './ExperienceStore';
+export { ExperienceTracker } from './ExperienceTracker';
+export { Scanner } from './Scanner';
+export { PluginRegistry } from './PluginRegistry';
+export { ParserRegistry } from './ParserRegistry';
+export { QueryEngine } from './QueryEngine';
+export { CodeMap } from './CodeMap';
+export { HelpRegistry } from './HelpRegistry';
+export { GroupStore } from './GroupStore';
+export { HintRegistry } from './HintRegistry';
+export type { ScannerConfig, ScanStartPayload, ScanFilePayload, ScanCompletePayload } from './Scanner';
+export type { QueryEngineConfig } from './QueryEngine';
+export type { PathFormat, ResolvedTarget, ParsedTarget } from './TargetResolver';
+export type { CodeMapConfig } from './CodeMap';
+export type { HelpTopic, HelpTopicMetadata } from './HelpRegistry';
+export type { Group, GroupMember, GroupNotation, GroupsData } from './GroupStore';
+export type { HintCondition, HintContext } from './HintRegistry';
+export type { SafeWriteResult, ReplaceVerification } from './WriteSafetyGuard';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,YAAY,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACb,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,YAAY,EACV,SAAS,EACT,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,KAAK,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACX,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,aAAa,EACb,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Core module exports.
+ *
+ * Foundation layer for CodeMap:
+ * - FileSystemGraph: Passive knowledge base (files, symbols, dependencies)
+ * - FileSystemIO: Controlled gateway with lifecycle events
+ * - Scanner: Directory tree walker with lifecycle events
+ * - PluginRegistry: Plugin management and lifecycle
+ * - QueryEngine: Search and graph traversal
+ * - CodeMap: Main orchestrator (public API entry point)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HintRegistry = exports.GroupStore = exports.HelpRegistry = exports.CodeMap = exports.QueryEngine = exports.ParserRegistry = exports.PluginRegistry = exports.Scanner = exports.ExperienceTracker = exports.ExperienceStore = exports.EventBus = exports.WriteSafetyGuard = exports.LineRangeWriter = exports.AnnotationStore = exports.TargetResolver = exports.TargetParser = exports.FileSystemIO = exports.FileSystemGraph = void 0;
+var FileSystemGraph_1 = require("./FileSystemGraph");
+Object.defineProperty(exports, "FileSystemGraph", { enumerable: true, get: function () { return FileSystemGraph_1.FileSystemGraph; } });
+var FileSystemIO_1 = require("./FileSystemIO");
+Object.defineProperty(exports, "FileSystemIO", { enumerable: true, get: function () { return FileSystemIO_1.FileSystemIO; } });
+var TargetParser_1 = require("./TargetParser");
+Object.defineProperty(exports, "TargetParser", { enumerable: true, get: function () { return TargetParser_1.TargetParser; } });
+var TargetResolver_1 = require("./TargetResolver");
+Object.defineProperty(exports, "TargetResolver", { enumerable: true, get: function () { return TargetResolver_1.TargetResolver; } });
+var AnnotationStore_1 = require("./AnnotationStore");
+Object.defineProperty(exports, "AnnotationStore", { enumerable: true, get: function () { return AnnotationStore_1.AnnotationStore; } });
+var LineRangeWriter_1 = require("./LineRangeWriter");
+Object.defineProperty(exports, "LineRangeWriter", { enumerable: true, get: function () { return LineRangeWriter_1.LineRangeWriter; } });
+var WriteSafetyGuard_1 = require("./WriteSafetyGuard");
+Object.defineProperty(exports, "WriteSafetyGuard", { enumerable: true, get: function () { return WriteSafetyGuard_1.WriteSafetyGuard; } });
+var EventBus_1 = require("./EventBus");
+Object.defineProperty(exports, "EventBus", { enumerable: true, get: function () { return EventBus_1.EventBus; } });
+var ExperienceStore_1 = require("./ExperienceStore");
+Object.defineProperty(exports, "ExperienceStore", { enumerable: true, get: function () { return ExperienceStore_1.ExperienceStore; } });
+var ExperienceTracker_1 = require("./ExperienceTracker");
+Object.defineProperty(exports, "ExperienceTracker", { enumerable: true, get: function () { return ExperienceTracker_1.ExperienceTracker; } });
+var Scanner_1 = require("./Scanner");
+Object.defineProperty(exports, "Scanner", { enumerable: true, get: function () { return Scanner_1.Scanner; } });
+var PluginRegistry_1 = require("./PluginRegistry");
+Object.defineProperty(exports, "PluginRegistry", { enumerable: true, get: function () { return PluginRegistry_1.PluginRegistry; } });
+var ParserRegistry_1 = require("./ParserRegistry");
+Object.defineProperty(exports, "ParserRegistry", { enumerable: true, get: function () { return ParserRegistry_1.ParserRegistry; } });
+var QueryEngine_1 = require("./QueryEngine");
+Object.defineProperty(exports, "QueryEngine", { enumerable: true, get: function () { return QueryEngine_1.QueryEngine; } });
+var CodeMap_1 = require("./CodeMap");
+Object.defineProperty(exports, "CodeMap", { enumerable: true, get: function () { return CodeMap_1.CodeMap; } });
+var HelpRegistry_1 = require("./HelpRegistry");
+Object.defineProperty(exports, "HelpRegistry", { enumerable: true, get: function () { return HelpRegistry_1.HelpRegistry; } });
+var GroupStore_1 = require("./GroupStore");
+Object.defineProperty(exports, "GroupStore", { enumerable: true, get: function () { return GroupStore_1.GroupStore; } });
+var HintRegistry_1 = require("./HintRegistry");
+Object.defineProperty(exports, "HintRegistry", { enumerable: true, get: function () { return HintRegistry_1.HintRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}

package/dist/core/query/DependencyTraversal.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DependencyTraversal - Graph traversal operations.
+ *
+ * Handles dependency graph navigation:
+ * - Find importers (what imports this file)
+ * - Find imports (what this file imports)
+ * - BFS traversal with depth limiting
+ * - Related files discovery
+ */
+import type { FileSystemGraph } from '../FileSystemGraph';
+import type { FileEntry } from '../../types/core';
+export declare class DependencyTraversal {
+    private graph;
+    constructor(graph: FileSystemGraph);
+    findImporters(relativePath: string): FileEntry[];
+    findImports(relativePath: string): FileEntry[];
+    getRelated(relativePath: string): {
+        imports: FileEntry[];
+        importers: FileEntry[];
+    };
+    traverse(startPath: string, direction: 'imports' | 'importers', maxDepth?: number): FileEntry[];
+}
+//# sourceMappingURL=DependencyTraversal.d.ts.map

package/dist/core/query/DependencyTraversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyTraversal.d.ts","sourceRoot":"","sources":["../../../src/core/query/DependencyTraversal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE1C,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE;IAIhD,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE;IAI9C,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAAC,SAAS,EAAE,SAAS,EAAE,CAAA;KAAE;IAOlF,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GAAG,WAAW,EAClC,QAAQ,GAAE,MAAU,GACnB,SAAS,EAAE;CA2Bf"}

package/dist/core/query/DependencyTraversal.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * DependencyTraversal - Graph traversal operations.
+ *
+ * Handles dependency graph navigation:
+ * - Find importers (what imports this file)
+ * - Find imports (what this file imports)
+ * - BFS traversal with depth limiting
+ * - Related files discovery
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyTraversal = void 0;
+class DependencyTraversal {
+    graph;
+    constructor(graph) {
+        this.graph = graph;
+    }
+    findImporters(relativePath) {
+        return this.graph.findImporters(relativePath);
+    }
+    findImports(relativePath) {
+        return this.graph.findImports(relativePath);
+    }
+    getRelated(relativePath) {
+        return {
+            imports: this.findImports(relativePath),
+            importers: this.findImporters(relativePath)
+        };
+    }
+    traverse(startPath, direction, maxDepth = 3) {
+        const visited = new Set();
+        const queue = [{ path: startPath, depth: 0 }];
+        const results = [];
+        while (queue.length > 0) {
+            const { path, depth } = queue.shift();
+            if (visited.has(path) || depth > maxDepth)
+                continue;
+            visited.add(path);
+            const file = this.graph.getFile(path);
+            if (file)
+                results.push(file);
+            const neighbors = direction === 'imports'
+                ? this.findImports(path)
+                : this.findImporters(path);
+            for (const neighbor of neighbors) {
+                if (!visited.has(neighbor.relativePath)) {
+                    queue.push({ path: neighbor.relativePath, depth: depth + 1 });
+                }
+            }
+        }
+        return results;
+    }
+}
+exports.DependencyTraversal = DependencyTraversal;
+//# sourceMappingURL=DependencyTraversal.js.map

package/dist/core/query/DependencyTraversal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyTraversal.js","sourceRoot":"","sources":["../../../src/core/query/DependencyTraversal.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAKH,MAAa,mBAAmB;IACV;IAApB,YAAoB,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAE9C,aAAa,CAAC,YAAoB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,WAAW,CAAC,YAAoB;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU,CAAC,YAAoB;QAC7B,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC;YACvC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED,QAAQ,CACN,SAAiB,EACjB,SAAkC,EAClC,WAAmB,CAAC;QAEpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAA2C,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACtF,MAAM,OAAO,GAAgB,EAAE,CAAC;QAEhC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAEvC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,QAAQ;gBAAE,SAAS;YACpD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAElB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE7B,MAAM,SAAS,GAAG,SAAS,KAAK,SAAS;gBACvC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;gBACxB,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAE7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAjDD,kDAiDC"}

package/dist/core/query/ResultProcessor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ResultProcessor - Post-processing and enrichment of search results.
+ *
+ * Handles:
+ * - Result merging and deduplication
+ * - Symbol limiting and compacting
+ * - Group membership enrichment
+ * - File metadata stripping for token efficiency
+ */
+import type { SearchResult } from '../../types/query';
+export declare class ResultProcessor {
+    private groupStore?;
+    constructor(groupStore?: any | undefined);
+    mergeResults(a: SearchResult[], b: SearchResult[]): SearchResult[];
+    limitSymbolsPerFile(results: SearchResult[], maxSymbols: number): SearchResult[];
+    compactSymbols(results: SearchResult[], maxSymbols: number): SearchResult[];
+    stripFileSymbols(results: SearchResult[]): SearchResult[];
+    enrichWithGroups(results: SearchResult[]): SearchResult[];
+}
+//# sourceMappingURL=ResultProcessor.d.ts.map

package/dist/core/query/ResultProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultProcessor.d.ts","sourceRoot":"","sources":["../../../src/core/query/ResultProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,qBAAa,eAAe;IACd,OAAO,CAAC,UAAU,CAAC;gBAAX,UAAU,CAAC,EAAE,GAAG,YAAA;IAEpC,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAalE,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE;IAoBhF,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE;IAsB3E,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAUzD,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;CAoC1D"}

package/dist/core/query/ResultProcessor.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * ResultProcessor - Post-processing and enrichment of search results.
+ *
+ * Handles:
+ * - Result merging and deduplication
+ * - Symbol limiting and compacting
+ * - Group membership enrichment
+ * - File metadata stripping for token efficiency
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResultProcessor = void 0;
+class ResultProcessor {
+    groupStore;
+    constructor(groupStore) {
+        this.groupStore = groupStore;
+    }
+    mergeResults(a, b) {
+        const map = new Map();
+        for (const result of [...a, ...b]) {
+            const existing = map.get(result.file.relativePath);
+            if (!existing || result.relevance > existing.relevance) {
+                map.set(result.file.relativePath, result);
+            }
+        }
+        return Array.from(map.values());
+    }
+    limitSymbolsPerFile(results, maxSymbols) {
+        for (const result of results) {
+            if (result.matchedSymbols && result.matchedSymbols.length > maxSymbols) {
+                const scoredSymbols = result.matchedSymbols.map((symbol, index) => ({
+                    symbol,
+                    score: result.relevance * (1 - index * 0.05)
+                }));
+                scoredSymbols.sort((a, b) => b.score - a.score);
+                result.matchedSymbols = scoredSymbols.slice(0, maxSymbols).map(s => s.symbol);
+                const hiddenCount = scoredSymbols.length - maxSymbols;
+                result.reasons.push(`Showing ${maxSymbols} of ${scoredSymbols.length} matching symbols (+${hiddenCount} more)`);
+            }
+        }
+        return results;
+    }
+    compactSymbols(results, maxSymbols) {
+        for (const result of results) {
+            if (result.matchedSymbols && result.matchedSymbols.length > 0) {
+                const symbolNames = result.matchedSymbols
+                    .slice(0, maxSymbols)
+                    .map(s => `${s.name} (${s.kind})`)
+                    .join(', ');
+                const hasMore = result.matchedSymbols.length > maxSymbols;
+                const moreCount = result.matchedSymbols.length - maxSymbols;
+                result.symbolSummary = hasMore
+                    ? `${symbolNames}, +${moreCount} more`
+                    : symbolNames;
+                delete result.matchedSymbols;
+            }
+        }
+        return results;
+    }
+    stripFileSymbols(results) {
+        for (const result of results) {
+            if (result.file.symbols) {
+                delete result.file.symbols;
+            }
+        }
+        return results;
+    }
+    enrichWithGroups(results) {
+        if (!this.groupStore)
+            return results;
+        for (const result of results) {
+            const fileGroups = this.groupStore.findGroupsForMember('file', result.file.relativePath);
+            const symbolGroups = [];
+            if (result.matchedSymbols) {
+                for (const symbol of result.matchedSymbols) {
+                    const symbolPath = `${result.file.relativePath}$${symbol.name}`;
+                    const groups = this.groupStore.findGroupsForMember('symbol', symbolPath);
+                    symbolGroups.push(...groups);
+                }
+            }
+            const allGroups = [...fileGroups, ...symbolGroups];
+            const uniqueGroups = Array.from(new Map(allGroups.map(g => [g.name, g])).values());
+            if (uniqueGroups.length > 0) {
+                result.groups = uniqueGroups.map(group => ({
+                    name: group.name,
+                    description: group.description,
+                    firstNotation: group.notations.length > 0
+                        ? group.notations[0].text
+                        : group.description
+                }));
+                const groupNames = uniqueGroups.map(g => g.name).join(', ');
+                result.reasons.push(`Groups: ${groupNames}`);
+            }
+        }
+        return results;
+    }
+}
+exports.ResultProcessor = ResultProcessor;
+//# sourceMappingURL=ResultProcessor.js.map

package/dist/core/query/ResultProcessor.js.map

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

package/dist/core/query/SymbolSearchEngine.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SymbolSearchEngine - Symbol name matching strategy.
+ *
+ * Handles symbol-based search with support for:
+ * - Symbol name matching (exact, contains, fuzzy)
+ * - Symbol kind filtering
+ * - Regex patterns
+ * - Relevance scoring
+ */
+import type { FileSystemGraph } from '../FileSystemGraph';
+import type { SearchRequest, SearchResult } from '../../types/query';
+export declare class SymbolSearchEngine {
+    private graph;
+    constructor(graph: FileSystemGraph);
+    search(request: SearchRequest, useRegex: boolean): SearchResult[];
+    private regexSearch;
+    private keywordSearch;
+    private fuzzyMatch;
+}
+//# sourceMappingURL=SymbolSearchEngine.d.ts.map

package/dist/core/query/SymbolSearchEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SymbolSearchEngine.d.ts","sourceRoot":"","sources":["../../../src/core/query/SymbolSearchEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,qBAAa,kBAAkB;IACjB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE1C,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY,EAAE;IAQjE,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,aAAa;IA0CrB,OAAO,CAAC,UAAU;CAUnB"}