@egentica/codemap 0.1.5

package/dist/mcp/operations/writes.js

@@ -0,0 +1,287 @@
+"use strict";
+// operations/writes.ts
+// Write operations: create, append, replace_text, replace_many, delete, rename
+// Follows Prime's operation handler pattern with okEnvelope/errorEnvelope
+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.renameFile = exports.deleteFile = exports.replaceMany = exports.replaceText = exports.appendFile = exports.createFile = void 0;
+const FuzzyMatcher_1 = require("../../core/FuzzyMatcher");
+const path = __importStar(require("node:path"));
+// ── Envelope helpers ─────────────────────────────────────────────────────────
+function okEnvelope(data) {
+    return { success: true, data };
+}
+function errorEnvelope(code, message) {
+    return { success: false, error: { code, message } };
+}
+// ── Write-specific path resolution ──────────────────────────────────────────
+/**
+ * Resolve write paths without dot-notation.
+ * For writes, dots are NEVER directory separators - only / and \ are.
+ * This bypasses all dot-notation logic.
+ */
+function resolveWritePath(target, rootPath) {
+    // If already absolute, use as-is
+    if (path.isAbsolute(target)) {
+        return path.normalize(target);
+    }
+    // Otherwise, join with root path
+    // Standard path.join handles / and \ as separators, treats dots as literal
+    return path.resolve(rootPath, target);
+}
+// ── create_file ──────────────────────────────────────────────────────────────
+const createFile = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    const content = args.content ? String(args.content) : '';
+    const type = args.type === 'directory' ? 'directory' : 'file';
+    try {
+        // Use write-specific path resolution (no dot-notation)
+        const absolutePath = resolveWritePath(target, ctx.rootPath);
+        // Check if exists
+        const exists = await ctx.codemap.fs.exists(absolutePath);
+        if (exists) {
+            return errorEnvelope('FILE_EXISTS', `File already exists: ${target}`);
+        }
+        if (type === 'directory') {
+            await ctx.codemap.io.mkdir(absolutePath);
+            // Return just the path for directories
+            return okEnvelope({ created: absolutePath, type: 'directory' });
+        }
+        else {
+            await ctx.codemap.fs.write(absolutePath, content);
+            return okEnvelope({ created: absolutePath, type: 'file', bytes: content.length });
+        }
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.createFile = createFile;
+// ── append_file ──────────────────────────────────────────────────────────────
+const appendFile = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    const content = args.content ? String(args.content) : '';
+    if (!content)
+        return errorEnvelope('MISSING_ARGS', 'content is required');
+    try {
+        const absolutePath = resolveWritePath(target, ctx.rootPath);
+        const existing = await ctx.codemap.fs.read(absolutePath);
+        // Use I/O gateway's append method (emits events)
+        await ctx.codemap.io.append(absolutePath, content);
+        return okEnvelope({
+            updated: absolutePath,
+            appendedBytes: content.length,
+            totalBytes: existing.length + content.length,
+        });
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.appendFile = appendFile;
+// ── replace_text ─────────────────────────────────────────────────────────────
+const replaceText = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    const oldString = args.oldString ? String(args.oldString) : '';
+    const newString = args.newString ? String(args.newString) : '';
+    try {
+        // Parse range first (target:10-20) - parseRange just splits on ':'
+        const parsed = ctx.codemap.resolver.parseRange(target);
+        const absolutePath = resolveWritePath(parsed.target, ctx.rootPath);
+        const content = await ctx.codemap.fs.read(absolutePath);
+        const lines = content.split(/\r?\n/);
+        const fuzzy = new FuzzyMatcher_1.FuzzyMatcher();
+        // Extract range from parsed target
+        const range = parsed.range;
+        if (!oldString && !range) {
+            return errorEnvelope('MISSING_ARGS', 'Either oldString or line range must be provided');
+        }
+        let updated;
+        let matchInfo;
+        if (oldString) {
+            // Mode 1: oldString provided - use fuzzy matching
+            // Try exact match first (gentle normalization)
+            if (fuzzy.textMatches(content, oldString)) {
+                // Perfect match - just replace entire content
+                updated = newString;
+                matchInfo = { confidence: 1.0 };
+            }
+            else {
+                // Search for best match
+                const searchRange = range ? { start: range.start - 1, end: range.end - 1 } : undefined;
+                const match = fuzzy.findBestTextMatch(lines, oldString, searchRange);
+                if (!match) {
+                    // This should never happen since findBestTextMatch always returns best attempt
+                    return errorEnvelope('NOT_FOUND', `No text to search in file`);
+                }
+                // ALWAYS PERFORM REPLACEMENT with best match
+                // No confidence threshold - we show what we found and do it
+                const before = lines.slice(0, match.startLine);
+                const after = lines.slice(match.endLine + 1);
+                const newLines = newString.split(/\r?\n/);
+                updated = [...before, ...newLines, ...after].join('\n');
+                matchInfo = {
+                    confidence: match.confidence,
+                    diff: match.diff,
+                    location: `lines ${match.startLine + 1}-${match.endLine + 1}`
+                };
+            }
+        }
+        else if (range) {
+            // Mode 2: Range provided without oldString - direct line replacement
+            const startIdx = range.start - 1;
+            const endIdx = range.end - 1;
+            if (startIdx < 0 || endIdx >= lines.length) {
+                return errorEnvelope('INVALID_RANGE', `Line range ${range.start}-${range.end} out of bounds for file with ${lines.length} lines`);
+            }
+            const before = lines.slice(0, startIdx);
+            const after = lines.slice(endIdx + 1);
+            const newLines = newString.split(/\r?\n/);
+            updated = [...before, ...newLines, ...after].join('\n');
+            matchInfo = { confidence: 1.0, location: `lines ${range.start}-${range.end}` };
+        }
+        else {
+            return errorEnvelope('INVALID_ARGS', 'Internal error: unexpected argument combination');
+        }
+        await ctx.codemap.fs.write(absolutePath, updated);
+        // Build response with match quality information
+        const response = {
+            updated: absolutePath,
+            replacements: 1,
+            oldLength: oldString.length,
+            newLength: newString.length,
+            fuzzyMatch: !!oldString && matchInfo !== undefined,
+        };
+        // Add match quality info if available
+        if (matchInfo) {
+            response.confidence = matchInfo.confidence;
+            if (matchInfo.location) {
+                response.location = matchInfo.location;
+            }
+            // If not perfect match, include diff for debugging
+            if (matchInfo.confidence < 1.0 && matchInfo.diff) {
+                response.diff = matchInfo.diff;
+                response.warning = matchInfo.confidence < 0.8
+                    ? `Low confidence match (${(matchInfo.confidence * 100).toFixed(1)}%). Replacement made with best match found. Review diff to verify correctness.`
+                    : `Fuzzy match (${(matchInfo.confidence * 100).toFixed(1)}%). Minor differences detected.`;
+            }
+        }
+        return okEnvelope(response);
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.replaceText = replaceText;
+// ── replace_many ─────────────────────────────────────────────────────────────
+const replaceMany = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    const replacementsStr = args.replacements ? String(args.replacements) : '';
+    if (!replacementsStr)
+        return errorEnvelope('MISSING_ARGS', 'replacements (JSON array) is required');
+    try {
+        const absolutePath = resolveWritePath(target, ctx.rootPath);
+        let content = await ctx.codemap.fs.read(absolutePath);
+        const replacements = JSON.parse(replacementsStr);
+        let totalReplacements = 0;
+        for (const { oldString, newString } of replacements) {
+            const before = content;
+            content = content.replace(oldString, newString);
+            if (before !== content)
+                totalReplacements++;
+        }
+        if (totalReplacements === 0) {
+            return errorEnvelope('NO_MATCHES', 'No replacements were made');
+        }
+        await ctx.codemap.fs.write(absolutePath, content);
+        return okEnvelope({
+            updated: absolutePath,
+            replacements: totalReplacements,
+            requested: replacements.length,
+        });
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.replaceMany = replaceMany;
+// ── delete_file ──────────────────────────────────────────────────────────────
+const deleteFile = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    try {
+        const absolutePath = resolveWritePath(target, ctx.rootPath);
+        // Use I/O gateway's remove method (emits file:delete event)
+        await ctx.codemap.io.remove(absolutePath);
+        return okEnvelope({ deleted: absolutePath });
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.deleteFile = deleteFile;
+// ── rename_file ──────────────────────────────────────────────────────────────
+const renameFile = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    const newPath = args.newPath ? String(args.newPath) : '';
+    if (!newPath)
+        return errorEnvelope('MISSING_ARGS', 'newPath is required');
+    try {
+        const fromPath = resolveWritePath(target, ctx.rootPath);
+        const toPath = resolveWritePath(newPath, ctx.rootPath);
+        // Use I/O gateway's rename method (emits file:rename event)
+        await ctx.codemap.io.rename(fromPath, toPath);
+        return okEnvelope({
+            from: fromPath,
+            to: toPath,
+        });
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.renameFile = renameFile;
+//# sourceMappingURL=writes.js.map

package/dist/mcp/operations/writes.js.map

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

package/dist/mcp/registry/ToolRegistry.d.ts

@@ -0,0 +1,54 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolDefinition, OperationContext, PluginToolDefinition } from './types.js';
+/**
+ * Simple event bus interface for plugin communication
+ */
+export interface EventBus {
+    on(event: string, handler: (data: any) => void): void;
+    off(event: string, handler: (data: any) => void): void;
+    emit(event: string, data: any): void;
+}
+export declare class ToolRegistry {
+    private tools;
+    private eventBus?;
+    constructor(eventBus?: EventBus);
+    /**
+     * Recursively find all .tool.js files (compiled from .tool.ts)
+     */
+    private findToolFiles;
+    /**
+     * Auto-discover and load all *.tool.ts files
+     */
+    loadTools(toolsDir: string): Promise<void>;
+    /**
+     * Register a tool from a plugin via event bus
+     * Plugins call this by emitting 'plugin:register-tool' events
+     */
+    private registerPluginTool;
+    /**
+     * Public method for direct plugin tool registration
+     * Allows plugins to register tools without event bus
+     */
+    registerTool(toolDef: PluginToolDefinition): void;
+    /**
+     * Register all loaded tools with the MCP server
+     */
+    registerAll(server: McpServer, ctx: OperationContext): void;
+    /**
+     * Get tools by category
+     */
+    getByCategory(category: string): ToolDefinition[];
+    /**
+     * Get tools by tag
+     */
+    getByTag(tag: string): ToolDefinition[];
+    /**
+     * List all tools
+     */
+    listAll(): ToolDefinition[];
+    /**
+     * Get tool count
+     */
+    get count(): number;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/mcp/registry/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/mcp/registry/ToolRegistry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAc,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACtD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;CACtC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,QAAQ,CAAC,CAAW;gBAEhB,QAAQ,CAAC,EAAE,QAAQ;IAS/B;;OAEG;YACW,aAAa;IAuB3B;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoChD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;;OAGG;IACI,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAIxD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI;IA0C3D;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAWjD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE;IAWvC;;OAEG;IACH,OAAO,IAAI,cAAc,EAAE;IAU3B;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/mcp/registry/ToolRegistry.js

@@ -0,0 +1,219 @@
+"use strict";
+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.ToolRegistry = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+class ToolRegistry {
+    tools = new Map();
+    eventBus;
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+        // Listen for plugin tool registrations
+        if (this.eventBus) {
+            this.eventBus.on('plugin:register-tool', this.registerPluginTool.bind(this));
+        }
+    }
+    /**
+     * Recursively find all .tool.js files (compiled from .tool.ts)
+     */
+    async findToolFiles(dir, baseDir = dir) {
+        const files = [];
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    const subFiles = await this.findToolFiles(fullPath, baseDir);
+                    files.push(...subFiles);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.tool.js')) {
+                    files.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`[ToolRegistry] Error reading directory ${dir}:`, error);
+        }
+        return files;
+    }
+    /**
+     * Auto-discover and load all *.tool.ts files
+     */
+    async loadTools(toolsDir) {
+        console.error('[ToolRegistry] Loading tools from:', toolsDir);
+        // Find all .tool.ts files
+        const toolFiles = await this.findToolFiles(toolsDir);
+        console.error(`[ToolRegistry] Found ${toolFiles.length} tool files`);
+        for (const fullPath of toolFiles) {
+            try {
+                const module = await Promise.resolve(`${fullPath}`).then(s => __importStar(require(s)));
+                const { inputSchema, metadata, handler, outputSchema } = module;
+                if (!metadata || !handler || !inputSchema) {
+                    console.error(`[ToolRegistry] Skipping ${fullPath}: missing required exports`);
+                    continue;
+                }
+                this.tools.set(metadata.name, {
+                    ...metadata,
+                    inputSchema,
+                    outputSchema,
+                    handler,
+                    source: 'filesystem'
+                });
+                console.error(`[ToolRegistry] ✓ Loaded: ${metadata.name} (${metadata.category})`);
+            }
+            catch (error) {
+                console.error(`[ToolRegistry] ✗ Failed to load ${fullPath}:`, error);
+            }
+        }
+        console.error(`[ToolRegistry] Loaded ${this.tools.size} tools`);
+    }
+    /**
+     * Register a tool from a plugin via event bus
+     * Plugins call this by emitting 'plugin:register-tool' events
+     */
+    registerPluginTool(toolDef) {
+        const { pluginName, name, description, category, tags, inputSchema, outputSchema, handler } = toolDef;
+        if (this.tools.has(name)) {
+            console.error(`[ToolRegistry] ⚠ Tool '${name}' already registered, skipping plugin tool from '${pluginName}'`);
+            return;
+        }
+        this.tools.set(name, {
+            name,
+            description,
+            category,
+            tags,
+            inputSchema,
+            outputSchema,
+            handler,
+            source: 'plugin',
+            pluginName
+        });
+        console.error(`[ToolRegistry] ✓ Registered plugin tool: ${name} (from ${pluginName})`);
+    }
+    /**
+     * Public method for direct plugin tool registration
+     * Allows plugins to register tools without event bus
+     */
+    registerTool(toolDef) {
+        this.registerPluginTool(toolDef);
+    }
+    /**
+     * Register all loaded tools with the MCP server
+     */
+    registerAll(server, ctx) {
+        console.error('[ToolRegistry] Registering tools with MCP server...');
+        // Tools that can be called before initialization
+        const initTools = new Set(['codemap_orient', 'codemap_session_start']);
+        for (const [name, tool] of this.tools) {
+            try {
+                server.registerTool(name, {
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                    outputSchema: tool.outputSchema
+                }, async (args, extra) => {
+                    // Check if CodeMap is initialized (except for init tools)
+                    if (!initTools.has(name) && (!ctx.codemap || !ctx.rootPath)) {
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: false,
+                                        error: {
+                                            code: 'NOT_INITIALIZED',
+                                            message: 'CodeMap not initialized. Call codemap_orient(rootPath: "...") or codemap_session_start(rootPath: "...") first.'
+                                        }
+                                    }, null, 2)
+                                }],
+                            isError: true
+                        };
+                    }
+                    return await tool.handler(args, ctx, extra);
+                });
+                console.error(`[ToolRegistry] ✓ Registered: ${name}`);
+            }
+            catch (error) {
+                console.error(`[ToolRegistry] ✗ Failed to register ${name}:`, error);
+            }
+        }
+        console.error(`[ToolRegistry] Registered ${this.tools.size} tools`);
+    }
+    /**
+     * Get tools by category
+     */
+    getByCategory(category) {
+        return Array.from(this.tools.values())
+            .filter(t => t.category === category)
+            .map(({ name, description, category, tags }) => ({
+            name,
+            description,
+            category,
+            tags
+        }));
+    }
+    /**
+     * Get tools by tag
+     */
+    getByTag(tag) {
+        return Array.from(this.tools.values())
+            .filter(t => t.tags.includes(tag))
+            .map(({ name, description, category, tags }) => ({
+            name,
+            description,
+            category,
+            tags
+        }));
+    }
+    /**
+     * List all tools
+     */
+    listAll() {
+        return Array.from(this.tools.values())
+            .map(({ name, description, category, tags }) => ({
+            name,
+            description,
+            category,
+            tags
+        }));
+    }
+    /**
+     * Get tool count
+     */
+    get count() {
+        return this.tools.size;
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/mcp/registry/ToolRegistry.js.map

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

package/dist/mcp/registry/context-guard.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context guard - ensures CodeMap is initialized before tool execution
+ */
+import type { OperationContext } from './types.js';
+/**
+ * Verify that CodeMap has been initialized.
+ * Throws a helpful error if not, directing user to call orient or session_start.
+ *
+ * @param ctx - Operation context to check
+ * @throws Error if CodeMap is not initialized
+ */
+export declare function ensureContext(ctx: OperationContext): asserts ctx is Required<OperationContext>;
+//# sourceMappingURL=context-guard.d.ts.map

package/dist/mcp/registry/context-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-guard.d.ts","sourceRoot":"","sources":["../../../src/mcp/registry/context-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAM9F"}

package/dist/mcp/registry/context-guard.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Context guard - ensures CodeMap is initialized before tool execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureContext = ensureContext;
+/**
+ * Verify that CodeMap has been initialized.
+ * Throws a helpful error if not, directing user to call orient or session_start.
+ *
+ * @param ctx - Operation context to check
+ * @throws Error if CodeMap is not initialized
+ */
+function ensureContext(ctx) {
+    if (!ctx.codemap || !ctx.rootPath) {
+        throw new Error('CodeMap not initialized. Call codemap_orient(rootPath: "...") or codemap_session_start(rootPath: "...") first.');
+    }
+}
+//# sourceMappingURL=context-guard.js.map

package/dist/mcp/registry/context-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-guard.js","sourceRoot":"","sources":["../../../src/mcp/registry/context-guard.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAWH,sCAMC;AAbD;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,GAAqB;IACjD,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,gHAAgH,CACjH,CAAC;IACJ,CAAC;AACH,CAAC"}