centient 2.20.0

package/dist/tools/memory-bank/memoryBankList.js

@@ -0,0 +1,108 @@
+import * as os from "os";
+import * as path from "path";
+import { runPythonScriptJSON } from "../../utils/pythonRunner.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const memoryBankListTool = {
+    name: "memory_bank_list",
+    description: "List all memories stored for a project. Returns all extracted facts from past sessions. Use this to see what the Memory Bank knows about a project.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            projectName: {
+                type: "string",
+                description: "Project name (e.g., 'claudedev', 'privatelanguage')",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of memories to return (default: 50)",
+                default: 50,
+            },
+        },
+        required: ["projectName"],
+    },
+};
+export async function memoryBankListHandler(args) {
+    const startTime = Date.now();
+    try {
+        const result = await memoryBankList(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        const result = {
+            success: false,
+            error: {
+                code: "MEMORY_BANK_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+                source: "memory_bank",
+            },
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+}
+async function memoryBankList(input) {
+    const startTime = Date.now();
+    if (!input.projectName || typeof input.projectName !== "string") {
+        return {
+            success: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: "Project name is required and must be a string",
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+                source: "memory_bank",
+            },
+        };
+    }
+    const limit = input.limit ?? 50;
+    const scriptPath = path.join(os.homedir(), "Dev/ClaudeDev/scripts/memory-bank/query-memories.py");
+    const result = await runPythonScriptJSON(scriptPath, [
+        "--list",
+        "--project-name",
+        input.projectName,
+        "--limit",
+        String(limit),
+        "--format",
+        "json",
+    ]);
+    if (!result.success) {
+        return {
+            success: false,
+            error: {
+                code: "MEMORY_BANK_ERROR",
+                message: result.error ?? "Unknown error from memory bank",
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+                source: "memory_bank",
+            },
+        };
+    }
+    const data = {
+        project: input.projectName,
+        count: result.count ?? 0,
+        memories: result.memories ?? [],
+    };
+    const tokensUsed = estimateTokensFromJSON(data);
+    return {
+        success: true,
+        data,
+        metadata: {
+            tokensUsed,
+            duration: Date.now() - startTime,
+            source: "memory_bank",
+        },
+    };
+}
+//# sourceMappingURL=memoryBankList.js.map

package/dist/tools/memory-bank/memoryBankList.js.map

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

package/dist/tools/memory-bank/memoryBankSearch.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const memoryBankSearchTool: Tool;
+export declare function memoryBankSearchHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=memoryBankSearch.d.ts.map

package/dist/tools/memory-bank/memoryBankSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryBankSearch.d.ts","sourceRoot":"","sources":["../../../src/tools/memory-bank/memoryBankSearch.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAO1D,eAAO,MAAM,oBAAoB,EAAE,IAyBlC,CAAC;AA6CF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA2B7D"}

package/dist/tools/memory-bank/memoryBankSearch.js

@@ -0,0 +1,128 @@
+import * as os from "os";
+import * as path from "path";
+import { runPythonScriptJSON } from "../../utils/pythonRunner.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const memoryBankSearchTool = {
+    name: "memory_bank_search",
+    description: "Search project memories using semantic similarity. Returns relevant facts extracted from past sessions. Use this to find decisions, learnings, and patterns from previous work.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query (e.g., 'authentication decisions', 'database migration patterns')",
+            },
+            projectName: {
+                type: "string",
+                description: "Project name (e.g., 'claudedev', 'privatelanguage', 'mermaid')",
+            },
+            topK: {
+                type: "number",
+                description: "Maximum number of results to return (default: 5)",
+                default: 5,
+            },
+        },
+        required: ["query", "projectName"],
+    },
+};
+export async function memoryBankSearchHandler(args) {
+    const startTime = Date.now();
+    try {
+        const result = await memoryBankSearch(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        const result = {
+            success: false,
+            error: {
+                code: "MEMORY_BANK_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+                source: "memory_bank",
+            },
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+}
+async function memoryBankSearch(input) {
+    const startTime = Date.now();
+    if (!input.query || typeof input.query !== "string") {
+        return {
+            success: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: "Query is required and must be a string",
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+                source: "memory_bank",
+            },
+        };
+    }
+    if (!input.projectName || typeof input.projectName !== "string") {
+        return {
+            success: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: "Project name is required and must be a string",
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+                source: "memory_bank",
+            },
+        };
+    }
+    const topK = input.topK ?? 5;
+    const scriptPath = path.join(os.homedir(), "Dev/ClaudeDev/scripts/memory-bank/query-memories.py");
+    const result = await runPythonScriptJSON(scriptPath, [
+        "--query",
+        input.query,
+        "--project-name",
+        input.projectName,
+        "--top-k",
+        String(topK),
+        "--format",
+        "json",
+    ]);
+    if (!result.success) {
+        return {
+            success: false,
+            error: {
+                code: "MEMORY_BANK_ERROR",
+                message: result.error ?? "Unknown error from memory bank",
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+                source: "memory_bank",
+            },
+        };
+    }
+    const data = {
+        query: input.query,
+        project: input.projectName,
+        count: result.count ?? 0,
+        memories: result.memories ?? [],
+    };
+    const tokensUsed = estimateTokensFromJSON(data);
+    return {
+        success: true,
+        data,
+        metadata: {
+            tokensUsed,
+            duration: Date.now() - startTime,
+            source: "memory_bank",
+        },
+    };
+}
+//# sourceMappingURL=memoryBankSearch.js.map

package/dist/tools/memory-bank/memoryBankSearch.js.map

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

package/dist/tools/metrics/getAuditLog.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const getAuditLogTool: Tool;
+export declare function getAuditLogHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=getAuditLog.d.ts.map

package/dist/tools/metrics/getAuditLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAuditLog.d.ts","sourceRoot":"","sources":["../../../src/tools/metrics/getAuditLog.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAU1D,eAAO,MAAM,eAAe,EAAE,IAoE7B,CAAC;AAkCF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwC7D"}

package/dist/tools/metrics/getAuditLog.js

@@ -0,0 +1,172 @@
+import { getAuditLogger, } from "../../utils/AuditLogger.js";
+export const getAuditLogTool = {
+    name: "getAuditLog",
+    description: "Query the security audit log for pattern/skill access events. " +
+        "Returns event history with filtering by time, tool, outcome, or pattern. " +
+        'Use mode="summary" for aggregated statistics or mode="events" for detailed logs.',
+    inputSchema: {
+        type: "object",
+        properties: {
+            mode: {
+                type: "string",
+                enum: ["summary", "events"],
+                description: 'Output mode: "summary" for statistics, "events" for detailed logs (default: summary)',
+            },
+            period: {
+                type: "string",
+                enum: ["hour", "day", "week", "month", "all"],
+                description: "Time period for summary mode (default: day)",
+            },
+            eventType: {
+                type: "string",
+                enum: [
+                    "pattern_search",
+                    "pattern_load",
+                    "pattern_find",
+                    "skill_execute",
+                    "pattern_index",
+                    "pattern_version_create",
+                    "pattern_version_deprecate",
+                    "artifact_search",
+                    "artifact_load",
+                    "artifact_code_extract",
+                    "session_start",
+                    "session_note",
+                    "session_search",
+                    "session_finalize",
+                    "research_plan",
+                    "consultation",
+                    "branch_create",
+                    "branch_close",
+                ],
+                description: "Filter by event type (optional)",
+            },
+            tool: {
+                type: "string",
+                description: "Filter by tool name (optional)",
+            },
+            outcome: {
+                type: "string",
+                enum: ["success", "failure", "partial"],
+                description: "Filter by outcome (optional)",
+            },
+            patternId: {
+                type: "string",
+                description: "Filter by pattern ID (optional)",
+            },
+            projectPath: {
+                type: "string",
+                description: "Filter by project path (optional)",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of events to return in events mode (default: 50)",
+            },
+        },
+    },
+};
+export async function getAuditLogHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        const result = await getAuditLog(input);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "AUDIT_LOG_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function getAuditLog(input) {
+    const startTime = Date.now();
+    const mode = input.mode || "summary";
+    const logger = getAuditLogger();
+    try {
+        if (mode === "summary") {
+            const period = input.period || "day";
+            const summary = await logger.getSummary(period);
+            const totalEvents = await logger.getEventCount();
+            const duration = Date.now() - startTime;
+            const tokensUsed = Math.ceil(JSON.stringify(summary).length / 4);
+            return {
+                success: true,
+                data: {
+                    mode: "summary",
+                    summary,
+                    totalEvents,
+                },
+                metadata: {
+                    tokensUsed,
+                    duration,
+                },
+            };
+        }
+        else {
+            const events = await logger.query({
+                eventType: input.eventType,
+                tool: input.tool,
+                outcome: input.outcome,
+                patternId: input.patternId,
+                projectPath: input.projectPath,
+                limit: input.limit || 50,
+            });
+            const totalEvents = await logger.getEventCount();
+            const duration = Date.now() - startTime;
+            const tokensUsed = Math.ceil(JSON.stringify(events).length / 4);
+            return {
+                success: true,
+                data: {
+                    mode: "events",
+                    events,
+                    totalEvents,
+                },
+                metadata: {
+                    tokensUsed,
+                    duration,
+                },
+            };
+        }
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "AUDIT_LOG_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=getAuditLog.js.map

package/dist/tools/metrics/getAuditLog.js.map

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

package/dist/tools/metrics/getCompressionRatio.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const getCompressionRatioTool: Tool;
+export declare function getCompressionRatioHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=getCompressionRatio.d.ts.map

package/dist/tools/metrics/getCompressionRatio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCompressionRatio.d.ts","sourceRoot":"","sources":["../../../src/tools/metrics/getCompressionRatio.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAY1D,eAAO,MAAM,uBAAuB,EAAE,IAwBrC,CAAC;AAiCF,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA+C7D"}

package/dist/tools/metrics/getCompressionRatio.js

@@ -0,0 +1,112 @@
+import { calculateCompressionRatio, getProjectCompressionMetrics, calculateAggregateCompression, } from "../../utils/metrics.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const getCompressionRatioTool = {
+    name: "getCompressionRatio",
+    description: "Calculate token compression metrics for sessions. Shows context savings through finalization.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            projectPath: {
+                type: "string",
+                description: "Absolute path to project directory",
+            },
+            sessionId: {
+                type: "string",
+                description: "Specific session ID to analyze (optional - returns all if omitted)",
+            },
+            aggregate: {
+                type: "boolean",
+                description: "Return aggregate statistics across all sessions",
+                default: false,
+            },
+        },
+        required: ["projectPath"],
+    },
+};
+export async function getCompressionRatioHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.projectPath) {
+            throw new Error("projectPath is required");
+        }
+        const result = await getCompressionRatio(input);
+        const responseText = JSON.stringify(result, null, 2);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "METRICS_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function getCompressionRatio(input) {
+    const startTime = Date.now();
+    try {
+        let data;
+        if (input.aggregate === true) {
+            data = await calculateAggregateCompression(input.projectPath);
+        }
+        else if (input.sessionId) {
+            const sessionMetrics = await calculateCompressionRatio(input.projectPath, input.sessionId);
+            if (!sessionMetrics) {
+                throw new Error(`No metrics found for session: ${input.sessionId}`);
+            }
+            data = sessionMetrics;
+        }
+        else {
+            data = await getProjectCompressionMetrics(input.projectPath);
+        }
+        const tokensUsed = estimateTokensFromJSON(data);
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data,
+            metadata: {
+                tokensUsed,
+                duration,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "METRICS_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=getCompressionRatio.js.map

package/dist/tools/metrics/getCompressionRatio.js.map

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

package/dist/tools/metrics/getCostDashboard.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const getCostDashboardTool: Tool;
+export declare function getCostDashboardHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=getCostDashboard.d.ts.map

package/dist/tools/metrics/getCostDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCostDashboard.d.ts","sourceRoot":"","sources":["../../../src/tools/metrics/getCostDashboard.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAa1D,eAAO,MAAM,oBAAoB,EAAE,IAmClC,CAAC;AA4BF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA0C7D"}