@egentica/codemap 0.1.5

package/dist/mcp/tools/session/audit.tool.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.metadata = exports.inputSchema = void 0;
+// tools/session/audit.tool.ts
+const zod_1 = require("zod");
+// ── Input Schema ─────────────────────────────────────────────────────────────
+exports.inputSchema = zod_1.z.object({});
+// ── Metadata ─────────────────────────────────────────────────────────────────
+exports.metadata = {
+    name: 'codemap_audit',
+    description: 'Check for architecture violations (systempolicy rules).',
+    category: 'session',
+    tags: ['session', 'audit', 'policy']
+};
+// ── Handler ──────────────────────────────────────────────────────────────────
+const handler = async (_args, ctx) => {
+    try {
+        // Placeholder: would check architecture violations using annotations
+        const allFiles = ctx.codemap.query['graph'].getAllFiles();
+        const violations = [];
+        for (const file of allFiles) {
+            const annotations = file.categorizedAnnotations || [];
+            // Audit logic would go here
+            // For now, just report files with policy annotations
+            if (annotations.length > 0) {
+                const resolved = await ctx.codemap.resolver.resolve(file.relativePath);
+                violations.push({
+                    file: resolved.relativePath,
+                    message: `${annotations.length} annotations found`
+                });
+            }
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        data: {
+                            violations,
+                            violationCount: violations.length,
+                            clean: violations.length === 0
+                        }
+                    }, null, 2)
+                }]
+        };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: {
+                            code: 'AUDIT_ERROR',
+                            message: err instanceof Error ? err.message : String(err)
+                        }
+                    }, null, 2)
+                }],
+            isError: true
+        };
+    }
+};
+exports.handler = handler;
+//# sourceMappingURL=audit.tool.js.map

package/dist/mcp/tools/session/audit.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.tool.js","sourceRoot":"","sources":["../../../../src/mcp/tools/session/audit.tool.ts"],"names":[],"mappings":";;;AAAA,8BAA8B;AAC9B,6BAAwB;AAGxB,gFAAgF;AACnE,QAAA,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAExC,gFAAgF;AACnE,QAAA,QAAQ,GAAmB;IACtC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,yDAAyD;IACtE,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC;CACrC,CAAC;AAEF,gFAAgF;AACzE,MAAM,OAAO,GAAoC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAC3E,IAAI,CAAC;QACH,qEAAqE;QACrE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,UAAU,GAA6C,EAAE,CAAC;QAEhE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,IAAI,EAAE,CAAC;YAEtD,4BAA4B;YAC5B,qDAAqD;YACrD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACvE,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,QAAQ,CAAC,YAAY;oBAC3B,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,oBAAoB;iBACnD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE;4BACJ,UAAU;4BACV,cAAc,EAAE,UAAU,CAAC,MAAM;4BACjC,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;yBAC/B;qBACF,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE;4BACL,IAAI,EAAE,aAAa;4BACnB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBAC1D;qBACF,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAhDW,QAAA,OAAO,WAgDlB"}

package/dist/mcp/tools/session/close.tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @codemap.note Resets DisplayFilter: Calls resetGroups() to clear group display state for next session. Ensures fresh context on next orient/start.
+ */
+import { z } from 'zod';
+import type { ToolDefinition, ToolHandler } from '../../registry/types.js';
+export declare const inputSchema: z.ZodObject<{
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const metadata: ToolDefinition;
+export declare const handler: ToolHandler<typeof inputSchema>;
+//# sourceMappingURL=close.tool.d.ts.map

package/dist/mcp/tools/session/close.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/session/close.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3E,eAAO,MAAM,WAAW;;iBAEtB,CAAC;AAGH,eAAO,MAAM,QAAQ,EAAE,cAKtB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,OAAO,WAAW,CA4DnD,CAAC"}

package/dist/mcp/tools/session/close.tool.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.metadata = exports.inputSchema = void 0;
+/**
+ * @codemap.note Resets DisplayFilter: Calls resetGroups() to clear group display state for next session. Ensures fresh context on next orient/start.
+ */
+// tools/session/close.tool.ts
+const zod_1 = require("zod");
+// ── Input Schema ─────────────────────────────────────────────────────────────
+exports.inputSchema = zod_1.z.object({
+    summary: zod_1.z.string().optional().describe('Optional summary of what was accomplished this session')
+});
+// ── Metadata ─────────────────────────────────────────────────────────────────
+exports.metadata = {
+    name: 'codemap_close',
+    description: 'Session close: run audit, verify compiles, create checkpoint.',
+    category: 'session',
+    tags: ['session', 'close']
+};
+// ── Handler ──────────────────────────────────────────────────────────────────
+const handler = async (args, ctx) => {
+    try {
+        // Get session summary with optional user-provided summary
+        const sessionSummary = ctx.codemap.sessionLog.getSummary(args.summary);
+        // Get session:close checklist
+        const checklists = ctx.codemap.checklistStore.getByTrigger('session:close');
+        const checklist = checklists[0]; // Get default checklist
+        // Get retention count from config (default: 5, 0 = unlimited)
+        const retentionCount = ctx.codemap.config.session?.summaryRetention ?? 5;
+        // Close the session (saves summary, cleans up old summaries, deletes session-transactions.json)
+        await ctx.codemap.sessionLog.closeSession(args.summary, retentionCount);
+        // Reset group display state on close (fresh context for next session)
+        await ctx.codemap.displayFilter.resetGroups();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        sessionSummary: {
+                            sessionId: sessionSummary.sessionId,
+                            startedAt: sessionSummary.startedAt,
+                            duration: sessionSummary.duration,
+                            summary: sessionSummary.summary,
+                            filesCreated: sessionSummary.filesCreated,
+                            filesUpdated: sessionSummary.filesUpdated,
+                            filesDeleted: sessionSummary.filesDeleted,
+                            filesRenamed: sessionSummary.filesRenamed,
+                            groupsModified: sessionSummary.groupsModified,
+                            notationsAdded: sessionSummary.notationsAdded,
+                            annotationsAdded: sessionSummary.annotationsAdded
+                        },
+                        checklist: checklist ? {
+                            items: checklist.items.map(item => ({
+                                text: item.text,
+                                priority: item.priority
+                            }))
+                        } : undefined
+                    }, null, 2)
+                }]
+        };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: {
+                            code: 'CLOSE_ERROR',
+                            message: err instanceof Error ? err.message : String(err)
+                        }
+                    }, null, 2)
+                }],
+            isError: true
+        };
+    }
+};
+exports.handler = handler;
+//# sourceMappingURL=close.tool.js.map

package/dist/mcp/tools/session/close.tool.js.map

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

package/dist/mcp/tools/session/execute-shell.tool.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { ToolDefinition, ToolHandler } from '../../registry/types.js';
+export declare const inputSchema: z.ZodObject<{
+    cmd: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    shell: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const metadata: ToolDefinition;
+export declare const handler: ToolHandler<typeof inputSchema>;
+//# sourceMappingURL=execute-shell.tool.d.ts.map

package/dist/mcp/tools/session/execute-shell.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-shell.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/session/execute-shell.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAQ3E,eAAO,MAAM,WAAW;;;;;iBAKtB,CAAC;AAGH,eAAO,MAAM,QAAQ,EAAE,cAKtB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,OAAO,WAAW,CA8DnD,CAAC"}

package/dist/mcp/tools/session/execute-shell.tool.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.metadata = exports.inputSchema = void 0;
+// tools/session/execute-shell.tool.ts
+const zod_1 = require("zod");
+const schemas_js_1 = require("../../registry/schemas.js");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+// ── Input Schema ─────────────────────────────────────────────────────────────
+exports.inputSchema = zod_1.z.object({
+    cmd: schemas_js_1.shellCommandSchema,
+    cwd: schemas_js_1.cwdSchema,
+    timeout: schemas_js_1.timeoutSchema,
+    shell: zod_1.z.string().optional().describe('Shell to use: "cmd", "powershell", "pwsh", "bash", or "sh" (default: cmd on Windows, sh on Unix)')
+});
+// ── Metadata ─────────────────────────────────────────────────────────────────
+exports.metadata = {
+    name: 'codemap_execute_shell',
+    description: 'Execute shell command (compile checks, npm scripts, etc.).',
+    category: 'session',
+    tags: ['session', 'shell', 'exec']
+};
+// ── Handler ──────────────────────────────────────────────────────────────────
+const handler = async (args, ctx) => {
+    try {
+        const { cmd, timeout = 30000, cwd = ctx.rootPath, shell } = args;
+        if (!cmd) {
+            throw new Error('cmd is required');
+        }
+        // Build exec options with shell if specified
+        const execOptions = { cwd, timeout };
+        if (shell) {
+            execOptions.shell = shell;
+        }
+        try {
+            const { stdout, stderr } = await execAsync(cmd, execOptions);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            data: {
+                                stdout,
+                                stderr,
+                                exitCode: 0
+                            }
+                        }, null, 2)
+                    }]
+            };
+        }
+        catch (err) {
+            // Even on error, return the output
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            data: {
+                                stdout: err.stdout || '',
+                                stderr: err.stderr || '',
+                                exitCode: err.code || 1,
+                                error: err.message
+                            }
+                        }, null, 2)
+                    }]
+            };
+        }
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: {
+                            code: 'EXECUTE_SHELL_ERROR',
+                            message: err instanceof Error ? err.message : String(err)
+                        }
+                    }, null, 2)
+                }],
+            isError: true
+        };
+    }
+};
+exports.handler = handler;
+//# sourceMappingURL=execute-shell.tool.js.map

package/dist/mcp/tools/session/execute-shell.tool.js.map

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

package/dist/mcp/tools/session/help.tool.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { ToolDefinition, ToolHandler } from '../../registry/types.js';
+export declare const inputSchema: z.ZodObject<{
+    topic: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const metadata: ToolDefinition;
+export declare const handler: ToolHandler<typeof inputSchema>;
+//# sourceMappingURL=help.tool.d.ts.map

package/dist/mcp/tools/session/help.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/session/help.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3E,eAAO,MAAM,WAAW;;iBAEtB,CAAC;AAGH,eAAO,MAAM,QAAQ,EAAE,cAKtB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,OAAO,WAAW,CAgCnD,CAAC"}

package/dist/mcp/tools/session/help.tool.js

@@ -0,0 +1,84 @@
+"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.handler = exports.metadata = exports.inputSchema = void 0;
+// tools/session/help.tool.ts
+const zod_1 = require("zod");
+const schemas_js_1 = require("../../registry/schemas.js");
+// ── Input Schema ─────────────────────────────────────────────────────────────
+exports.inputSchema = zod_1.z.object({
+    topic: schemas_js_1.helpTopicSchema
+});
+// ── Metadata ─────────────────────────────────────────────────────────────────
+exports.metadata = {
+    name: 'codemap_help',
+    description: 'Get help documentation for CodeMap tools and workflows.',
+    category: 'session',
+    tags: ['session', 'help', 'docs']
+};
+// ── Handler ──────────────────────────────────────────────────────────────────
+const handler = async (args, ctx) => {
+    try {
+        const { topic = '' } = args;
+        // Get HelpRegistry from CodeMap context
+        const registry = ctx.codemap.helpRegistry;
+        // Dynamically import the help operation
+        const { getHelp } = await Promise.resolve().then(() => __importStar(require('../../operations/help.js')));
+        const result = await getHelp(topic, registry);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: {
+                            code: 'HELP_ERROR',
+                            message: err instanceof Error ? err.message : String(err)
+                        }
+                    }, null, 2)
+                }],
+            isError: true
+        };
+    }
+};
+exports.handler = handler;
+//# sourceMappingURL=help.tool.js.map

package/dist/mcp/tools/session/help.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.tool.js","sourceRoot":"","sources":["../../../../src/mcp/tools/session/help.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6BAA6B;AAC7B,6BAAwB;AAExB,0DAA4D;AAE5D,gFAAgF;AACnE,QAAA,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,4BAAe;CACvB,CAAC,CAAC;AAEH,gFAAgF;AACnE,QAAA,QAAQ,GAAmB;IACtC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,yDAAyD;IACtE,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,gFAAgF;AACzE,MAAM,OAAO,GAAoC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1E,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QAE5B,wCAAwC;QACxC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC;QAE1C,wCAAwC;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,wDAAa,0BAA0B,GAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE;4BACL,IAAI,EAAE,YAAY;4BAClB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBAC1D;qBACF,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAhCW,QAAA,OAAO,WAgClB"}

package/dist/mcp/tools/session/list.tool.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { ToolDefinition, ToolHandler } from '../../registry/types.js';
+export declare const inputSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const metadata: ToolDefinition;
+export declare const handler: ToolHandler<typeof inputSchema>;
+//# sourceMappingURL=list.tool.d.ts.map

package/dist/mcp/tools/session/list.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/session/list.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3E,eAAO,MAAM,WAAW;;;iBAGtB,CAAC;AAGH,eAAO,MAAM,QAAQ,EAAE,cAKtB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,OAAO,WAAW,CA4BnD,CAAC"}

package/dist/mcp/tools/session/list.tool.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.metadata = exports.inputSchema = void 0;
+// tools/session/list.tool.ts
+const zod_1 = require("zod");
+// ── Input Schema ─────────────────────────────────────────────────────────────
+exports.inputSchema = zod_1.z.object({
+    page: zod_1.z.number().min(1).default(1).describe('Page number (default: 1)'),
+    pageSize: zod_1.z.number().min(1).max(50).default(10).describe('Sessions per page (default: 10, max: 50)')
+});
+// ── Metadata ─────────────────────────────────────────────────────────────────
+exports.metadata = {
+    name: 'codemap_session_list',
+    description: 'List archived session summaries with pagination. Shows session ID, date, duration, and summary text.',
+    category: 'session',
+    tags: ['session', 'history', 'list']
+};
+// ── Handler ──────────────────────────────────────────────────────────────────
+const handler = async (args, ctx) => {
+    try {
+        const result = await ctx.codemap.sessionLog.listSessions(args.page, args.pageSize);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        ...result
+                    }, null, 2)
+                }]
+        };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: {
+                            code: 'SESSION_LIST_ERROR',
+                            message: err instanceof Error ? err.message : String(err)
+                        }
+                    }, null, 2)
+                }],
+            isError: true
+        };
+    }
+};
+exports.handler = handler;
+//# sourceMappingURL=list.tool.js.map

package/dist/mcp/tools/session/list.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.tool.js","sourceRoot":"","sources":["../../../../src/mcp/tools/session/list.tool.ts"],"names":[],"mappings":";;;AAAA,6BAA6B;AAC7B,6BAAwB;AAGxB,gFAAgF;AACnE,QAAA,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACvE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACrG,CAAC,CAAC;AAEH,gFAAgF;AACnE,QAAA,QAAQ,GAAmB;IACtC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,sGAAsG;IACnH,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,gFAAgF;AACzE,MAAM,OAAO,GAAoC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnF,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,IAAI;wBACb,GAAG,MAAM;qBACV,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE;4BACL,IAAI,EAAE,oBAAoB;4BAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBAC1D;qBACF,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA5BW,QAAA,OAAO,WA4BlB"}

package/dist/mcp/tools/session/next-session.tool.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { ToolDefinition, ToolHandler } from '../../registry/types.js';
+export declare const inputSchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const metadata: ToolDefinition;
+export declare const handler: ToolHandler<typeof inputSchema>;
+//# sourceMappingURL=next-session.tool.d.ts.map

package/dist/mcp/tools/session/next-session.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-session.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/session/next-session.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3E,eAAO,MAAM,WAAW;;iBAEtB,CAAC;AAGH,eAAO,MAAM,QAAQ,EAAE,cAKtB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,OAAO,WAAW,CAmCnD,CAAC"}

package/dist/mcp/tools/session/next-session.tool.js

@@ -0,0 +1,87 @@
+"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.handler = exports.metadata = exports.inputSchema = void 0;
+// tools/session/next-session.tool.ts
+const zod_1 = require("zod");
+const path = __importStar(require("node:path"));
+// ── Input Schema ─────────────────────────────────────────────────────────────
+exports.inputSchema = zod_1.z.object({
+    text: zod_1.z.string().describe('Markdown text for handoff')
+});
+// ── Metadata ─────────────────────────────────────────────────────────────────
+exports.metadata = {
+    name: 'codemap_next_session',
+    description: 'Write next-session handoff document (.codemap/sessions/NEXT_SESSION.md).',
+    category: 'session',
+    tags: ['session', 'handoff', 'documentation']
+};
+// ── Handler ──────────────────────────────────────────────────────────────────
+const handler = async (args, ctx) => {
+    try {
+        const { text } = args;
+        // Construct path to NEXT_SESSION.md
+        const sessionPath = path.resolve(ctx.rootPath, '.codemap', 'sessions', 'NEXT_SESSION.md');
+        // Write the file (overwrite mode)
+        await ctx.codemap.io.write(sessionPath, text);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        path: sessionPath,
+                        size: text.length
+                    }, null, 2)
+                }]
+        };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: {
+                            code: 'WRITE_ERROR',
+                            message: err instanceof Error ? err.message : String(err)
+                        }
+                    }, null, 2)
+                }],
+            isError: true
+        };
+    }
+};
+exports.handler = handler;
+//# sourceMappingURL=next-session.tool.js.map

package/dist/mcp/tools/session/next-session.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-session.tool.js","sourceRoot":"","sources":["../../../../src/mcp/tools/session/next-session.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qCAAqC;AACrC,6BAAwB;AAExB,gDAAkC;AAElC,gFAAgF;AACnE,QAAA,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACvD,CAAC,CAAC;AAEH,gFAAgF;AACnE,QAAA,QAAQ,GAAmB;IACtC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,0EAA0E;IACvF,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC;CAC9C,CAAC;AAEF,gFAAgF;AACzE,MAAM,OAAO,GAAoC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1E,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,oCAAoC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAE1F,kCAAkC;QAClC,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE,WAAW;wBACjB,IAAI,EAAE,IAAI,CAAC,MAAM;qBAClB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE;4BACL,IAAI,EAAE,aAAa;4BACnB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBAC1D;qBACF,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAnCW,QAAA,OAAO,WAmClB"}

package/dist/mcp/tools/session/orient.tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @codemap.note Resets DisplayFilter: Calls resetGroups() to clear group display state. This provides fresh context at session start - all group descriptions+notations will show again on first access.
+ */
+import { z } from 'zod';
+import type { ToolDefinition, ToolHandler } from '../../registry/types.js';
+export declare const inputSchema: z.ZodObject<{
+    rootPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const metadata: ToolDefinition;
+export declare const handler: ToolHandler<typeof inputSchema>;
+//# sourceMappingURL=orient.tool.d.ts.map

package/dist/mcp/tools/session/orient.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/session/orient.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3E,eAAO,MAAM,WAAW;;iBAEtB,CAAC;AAGH,eAAO,MAAM,QAAQ,EAAE,cAKtB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,OAAO,WAAW,CAuMnD,CAAC"}