@egentica/codemap 0.1.5

package/dist/mcp/operations/graph.js

@@ -0,0 +1,69 @@
+"use strict";
+// operations/graph.ts
+// Graph operations: get_related, impact_analysis
+// Follows Prime's operation handler pattern with okEnvelope/errorEnvelope
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.impactAnalysis = exports.getRelated = void 0;
+// ── Envelope helpers ─────────────────────────────────────────────────────────
+function okEnvelope(data) {
+    return { success: true, data };
+}
+function errorEnvelope(code, message) {
+    return { success: false, error: { code, message } };
+}
+// ── get_related ──────────────────────────────────────────────────────────────
+const getRelated = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    const maxResults = args.maxResults ? Number(args.maxResults) : 20;
+    try {
+        const resolved = await ctx.codemap.resolver.resolve(target);
+        // Standalone's getRelated() returns {imports, importers} only
+        const related = ctx.codemap.query.getRelated(resolved.relativePath);
+        // Convert to relative paths
+        const imports = await Promise.all(related.imports
+            .slice(0, maxResults)
+            .map(async (f) => (await ctx.codemap.resolver.resolve(f.relativePath)).relativePath));
+        const importers = await Promise.all(related.importers
+            .slice(0, maxResults)
+            .map(async (f) => (await ctx.codemap.resolver.resolve(f.relativePath)).relativePath));
+        return okEnvelope({
+            file: resolved.relativePath,
+            imports,
+            importers,
+            totalRelated: imports.length + importers.length,
+        });
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.getRelated = getRelated;
+// ── impact_analysis ──────────────────────────────────────────────────────────
+const impactAnalysis = async (args, ctx) => {
+    const target = args.target ? String(args.target) : '';
+    if (!target)
+        return errorEnvelope('MISSING_TARGET', 'target is required');
+    const depth = args.depth ? Math.min(Number(args.depth), 3) : 2;
+    try {
+        const resolved = await ctx.codemap.resolver.resolve(target);
+        // Use query.traverse() for BFS traversal
+        const affectedFiles = ctx.codemap.query.traverse(resolved.relativePath, 'importers', depth);
+        // Convert to relative paths and exclude the target itself
+        const affectedPaths = await Promise.all(affectedFiles
+            .filter(f => f.relativePath !== resolved.relativePath)
+            .map(async (f) => (await ctx.codemap.resolver.resolve(f.relativePath)).relativePath));
+        return okEnvelope({
+            file: resolved.relativePath,
+            depth,
+            affectedFiles: affectedPaths,
+            affectedCount: affectedPaths.length,
+        });
+    }
+    catch (err) {
+        return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
+    }
+};
+exports.impactAnalysis = impactAnalysis;
+//# sourceMappingURL=graph.js.map

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

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

package/dist/mcp/operations/groups.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Group operations for CodeMap
+ *
+ * Provides CRUD operations for organizing code into groups.
+ * Groups persist in .codemap/groups.json and survive reboots.
+ */
+import type { GroupStore } from '../../core/GroupStore.js';
+declare function okEnvelope(data: unknown): {
+    success: boolean;
+    data: unknown;
+};
+declare function errorEnvelope(error: {
+    code: string;
+    message: string;
+    [key: string]: unknown;
+}): {
+    success: boolean;
+    error: {
+        [key: string]: unknown;
+        code: string;
+        message: string;
+    };
+};
+/**
+ * Add or update a group with members.
+ *
+ * @param groupStore - GroupStore instance
+ * @param name - Group name
+ * @param description - Group description (the initial notation/comment)
+ * @param members - Array of member specifications (file, directory, symbol paths)
+ */
+export declare function addGroup(groupStore: GroupStore, name: string, description: string, members: string[]): Promise<ReturnType<typeof okEnvelope | typeof errorEnvelope>>;
+/**
+ * Add a notation/comment to a group.
+ *
+ * @param groupStore - GroupStore instance
+ * @param groupName - Group name
+ * @param text - Notation text
+ * @param file - Optional file reference
+ * @param line - Optional line number
+ */
+export declare function addNotation(groupStore: GroupStore, groupName: string, text: string, file?: string, line?: number): Promise<ReturnType<typeof okEnvelope | typeof errorEnvelope>>;
+/**
+ * Search and list groups.
+ *
+ * - Empty name: List all groups with one notation each
+ * - Specific name: Show full details for that group
+ * - Query string: Search groups by name/description
+ *
+ * @param groupStore - GroupStore instance
+ * @param groupName - Optional group name or search query
+ */
+export declare function searchGroups(groupStore: GroupStore, groupName?: string): Promise<ReturnType<typeof okEnvelope | typeof errorEnvelope>>;
+export {};
+//# sourceMappingURL=groups.d.ts.map

package/dist/mcp/operations/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../src/mcp/operations/groups.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,0BAA0B,CAAC;AAIxE,iBAAS,UAAU,CAAC,IAAI,EAAE,OAAO;;;EAEhC;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;cAAjD,MAAM;iBAAW,MAAM;;EAE5D;AAID;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,GAAG,OAAO,aAAa,CAAC,CAAC,CAmE/D;AAID;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,GAAG,OAAO,aAAa,CAAC,CAAC,CA4C/D;AAID;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,GAAG,OAAO,aAAa,CAAC,CAAC,CAuF/D"}

package/dist/mcp/operations/groups.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * Group operations for CodeMap
+ *
+ * Provides CRUD operations for organizing code into groups.
+ * Groups persist in .codemap/groups.json and survive reboots.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGroup = addGroup;
+exports.addNotation = addNotation;
+exports.searchGroups = searchGroups;
+// ── Envelope helpers ─────────────────────────────────────────────────────────
+function okEnvelope(data) {
+    return { success: true, data };
+}
+function errorEnvelope(error) {
+    return { success: false, error };
+}
+// ── Add Group ────────────────────────────────────────────────────────────────
+/**
+ * Add or update a group with members.
+ *
+ * @param groupStore - GroupStore instance
+ * @param name - Group name
+ * @param description - Group description (the initial notation/comment)
+ * @param members - Array of member specifications (file, directory, symbol paths)
+ */
+async function addGroup(groupStore, name, description, members) {
+    try {
+        // Validate group name
+        if (!name || name.trim().length === 0) {
+            return errorEnvelope({
+                code: 'INVALID_GROUP_NAME',
+                message: 'Group name cannot be empty'
+            });
+        }
+        // Validate description
+        if (!description || description.trim().length === 0) {
+            return errorEnvelope({
+                code: 'INVALID_DESCRIPTION',
+                message: 'Description cannot be empty (this is the initial group notation)'
+            });
+        }
+        // Parse members
+        const parsedMembers = [];
+        for (const memberPath of members) {
+            if (memberPath.includes('$')) {
+                // Symbol reference (file.ts$symbolName)
+                parsedMembers.push({
+                    type: 'symbol',
+                    path: memberPath
+                });
+            }
+            else if (memberPath.endsWith('/') || memberPath.includes('*')) {
+                // Directory or pattern
+                parsedMembers.push({
+                    type: 'directory',
+                    path: memberPath.replace(/\/$/, '') // Remove trailing slash
+                });
+            }
+            else {
+                // File
+                parsedMembers.push({
+                    type: 'file',
+                    path: memberPath
+                });
+            }
+        }
+        // Create or update group
+        const group = await groupStore.setGroup(name, description, parsedMembers);
+        return okEnvelope({
+            group: {
+                name: group.name,
+                description: group.description,
+                memberCount: group.members.length,
+                notationCount: group.notations.length,
+                members: group.members,
+                notations: group.notations,
+                createdAt: group.createdAt,
+                updatedAt: group.updatedAt
+            },
+            message: groupStore.hasGroup(name)
+                ? `Updated group "${name}" with ${parsedMembers.length} new member(s)`
+                : `Created group "${name}" with ${parsedMembers.length} member(s)`
+        });
+    }
+    catch (error) {
+        return errorEnvelope({
+            code: 'GROUP_ADD_ERROR',
+            message: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+// ── Add Notation ─────────────────────────────────────────────────────────────
+/**
+ * Add a notation/comment to a group.
+ *
+ * @param groupStore - GroupStore instance
+ * @param groupName - Group name
+ * @param text - Notation text
+ * @param file - Optional file reference
+ * @param line - Optional line number
+ */
+async function addNotation(groupStore, groupName, text, file, line) {
+    try {
+        // Validate group exists
+        if (!groupStore.hasGroup(groupName)) {
+            return errorEnvelope({
+                code: 'GROUP_NOT_FOUND',
+                message: `Group "${groupName}" not found`,
+                availableGroups: groupStore.getAllGroups().map(g => g.name)
+            });
+        }
+        // Validate notation text
+        if (!text || text.trim().length === 0) {
+            return errorEnvelope({
+                code: 'INVALID_NOTATION',
+                message: 'Notation text cannot be empty'
+            });
+        }
+        // Add notation
+        await groupStore.addNotation(groupName, text, file ? { file, line } : undefined);
+        const group = groupStore.getGroup(groupName);
+        return okEnvelope({
+            group: groupName,
+            notation: {
+                text,
+                file,
+                line,
+                timestamp: Date.now()
+            },
+            totalNotations: group.notations.length
+        });
+    }
+    catch (error) {
+        return errorEnvelope({
+            code: 'NOTATION_ADD_ERROR',
+            message: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+// ── Search Groups ────────────────────────────────────────────────────────────
+/**
+ * Search and list groups.
+ *
+ * - Empty name: List all groups with one notation each
+ * - Specific name: Show full details for that group
+ * - Query string: Search groups by name/description
+ *
+ * @param groupStore - GroupStore instance
+ * @param groupName - Optional group name or search query
+ */
+async function searchGroups(groupStore, groupName) {
+    try {
+        // Case 1: No group name - list all groups
+        if (!groupName || groupName.trim().length === 0) {
+            const allGroups = groupStore.getAllGroups();
+            const groupSummaries = allGroups.map(group => ({
+                name: group.name,
+                description: group.description,
+                memberCount: group.members.length,
+                notationCount: group.notations.length,
+                // Show first notation (which is often the most important)
+                firstNotation: group.notations.length > 0
+                    ? group.notations[0].text
+                    : group.description,
+                createdAt: group.createdAt,
+                updatedAt: group.updatedAt
+            }));
+            const stats = groupStore.getStats();
+            return okEnvelope({
+                groups: groupSummaries,
+                stats,
+                message: `Found ${allGroups.length} group(s)`
+            });
+        }
+        // Case 2: Specific group name - show full details
+        if (groupStore.hasGroup(groupName)) {
+            const group = groupStore.getGroup(groupName);
+            return okEnvelope({
+                group: {
+                    name: group.name,
+                    description: group.description,
+                    members: group.members.map(m => ({
+                        type: m.type,
+                        path: m.path
+                    })),
+                    notations: group.notations.map(n => ({
+                        text: n.text,
+                        file: n.file,
+                        line: n.line,
+                        timestamp: n.timestamp,
+                        date: new Date(n.timestamp).toISOString()
+                    })),
+                    memberCount: group.members.length,
+                    notationCount: group.notations.length,
+                    createdAt: group.createdAt,
+                    updatedAt: group.updatedAt
+                }
+            });
+        }
+        // Case 3: Search query - find matching groups
+        const matchingGroups = groupStore.searchGroups(groupName);
+        if (matchingGroups.length === 0) {
+            return errorEnvelope({
+                code: 'GROUP_NOT_FOUND',
+                message: `No groups found matching "${groupName}"`,
+                availableGroups: groupStore.getAllGroups().map(g => g.name)
+            });
+        }
+        const groupSummaries = matchingGroups.map(group => ({
+            name: group.name,
+            description: group.description,
+            memberCount: group.members.length,
+            notationCount: group.notations.length,
+            firstNotation: group.notations.length > 0
+                ? group.notations[0].text
+                : group.description
+        }));
+        return okEnvelope({
+            groups: groupSummaries,
+            query: groupName,
+            message: `Found ${matchingGroups.length} group(s) matching "${groupName}"`
+        });
+    }
+    catch (error) {
+        return errorEnvelope({
+            code: 'GROUP_SEARCH_ERROR',
+            message: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+//# sourceMappingURL=groups.js.map

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

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

package/dist/mcp/operations/help.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Help system for CodeMap - provides contextual documentation for agents.
+ *
+ * This tool reads markdown help files from the HelpRegistry and returns
+ * formatted help content to guide agents in using CodeMap effectively.
+ *
+ * Supports both core help topics and plugin-registered topics.
+ */
+import type { HelpRegistry } from '../../core/HelpRegistry.js';
+/**
+ * Register core help topics with the HelpRegistry.
+ * Called during CodeMap initialization to register built-in help content.
+ *
+ * @param registry - HelpRegistry instance
+ * @param docsPath - Optional custom path to docs/help directory
+ */
+export declare function registerCoreHelpTopics(registry: HelpRegistry, docsPath?: string): Promise<void>;
+/**
+ * Get help documentation for a specific topic.
+ *
+ * @param topic - Help topic to lookup (empty string or 'index' for list of topics)
+ * @param registry - HelpRegistry instance
+ * @returns Help content as markdown
+ */
+export declare function getHelp(topic: string | undefined, registry: HelpRegistry): Promise<{
+    success: boolean;
+    data: unknown;
+} | {
+    success: boolean;
+    error: {
+        [key: string]: unknown;
+        code: string;
+        message: string;
+    };
+}>;
+//# sourceMappingURL=help.d.ts.map

package/dist/mcp/operations/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/mcp/operations/help.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuJf;AAYD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY;;;;;;;cAXzC,MAAM;iBAAW,MAAM;;GAwH5D"}