local-agent-memory 1.0.4 → 1.0.6

package/README.md

@@ -25,6 +25,7 @@ Inicializa el entorno de memoria en el repositorio actual. Esto crea las bases d
 - `-f, --force`: Fuerza la inicialización incluso si el proyecto ya fue inicializado.
 - `-r, --rules <rules>`: Inyecta reglas específicas para tu IDE (opciones: `cursor`, `claude`, `copilot`, `antigravity-ide`, `antigravity-cli`, `all`).
 - `-d, --docs <path>`: Ruta opcional a un directorio de documentación existente para mapearlo/indexarlo automáticamente.
+- `--no-log`: Desactiva el registro automático de llamadas del agente en `.memory/usage.log` (activado por defecto vía `"log_usage": true` en `.memory/config.json`).
 
 ```bash
 memory init --rules all --docs ./docs

package/dist/cli/commands/init.d.ts

@@ -2,4 +2,5 @@ export declare function initProject(options?: {
     force?: boolean;
     rules?: string;
     docs?: string;
+    log?: boolean;
 }): Promise<void>;

package/dist/cli/commands/init.js

@@ -47,6 +47,7 @@ async function initProject(options = {}) {
             project_id: projectId,
             created_at: new Date().toISOString(),
             include_paths: [".memory"],
+            log_usage: options.log !== false,
         };
         if (options.docs) {
             configData.include_paths.push(options.docs);

package/dist/cli/commands/list.js

@@ -52,18 +52,26 @@ async function listProjects() {
         // You could also list recent decisions or ledgers specifically if needed
         const decisionsDir = node_path_1.default.join(memoryDir, "decisions");
         if (node_fs_1.default.existsSync(decisionsDir)) {
-            const decisions = node_fs_1.default.readdirSync(decisionsDir).filter(f => f.endsWith(".md"));
+            const decisions = node_fs_1.default
+                .readdirSync(decisionsDir)
+                .filter((f) => f.endsWith(".md"));
             if (decisions.length > 0) {
                 console.log(`\nDecisiones Arquitectónicas (ADRs):`);
-                decisions.forEach(d => console.log(`  - decisions/${d}`));
+                for (const d of decisions) {
+                    console.log(`  - decisions/${d}`);
+                }
             }
         }
         const ledgerDir = node_path_1.default.join(memoryDir, "ledger");
         if (node_fs_1.default.existsSync(ledgerDir)) {
-            const ledgers = node_fs_1.default.readdirSync(ledgerDir).filter(f => f.endsWith(".md"));
+            const ledgers = node_fs_1.default
+                .readdirSync(ledgerDir)
+                .filter((f) => f.endsWith(".md"));
             if (ledgers.length > 0) {
                 console.log(`\nRegistros de Sesión (Ledger):`);
-                ledgers.forEach(l => console.log(`  - ledger/${l}`));
+                for (const l of ledgers) {
+                    console.log(`  - ledger/${l}`);
+                }
             }
         }
         console.log("\n==============================");

package/dist/cli/commands/status.js

@@ -78,6 +78,9 @@ async function getAllMarkdownFiles(dirPath, arrayOfFiles = []) {
     const files = await node_fs_1.default.promises.readdir(dirPath, { withFileTypes: true });
     for (const file of files) {
         if (file.isDirectory()) {
+            if (file.name === "node_modules" || file.name === ".git") {
+                continue;
+            }
             arrayOfFiles = await getAllMarkdownFiles(node_path_1.default.join(dirPath, file.name), arrayOfFiles);
         }
         else if (file.name.endsWith(".md")) {

package/dist/cli/commands/sync.js

@@ -115,6 +115,9 @@ async function getAllMarkdownFiles(dirPath, arrayOfFiles = []) {
     const files = await node_fs_1.default.promises.readdir(dirPath, { withFileTypes: true });
     for (const file of files) {
         if (file.isDirectory()) {
+            if (file.name === "node_modules" || file.name === ".git") {
+                continue;
+            }
             arrayOfFiles = await getAllMarkdownFiles(node_path_1.default.join(dirPath, file.name), arrayOfFiles);
         }
         else if (file.name.endsWith(".md")) {

package/dist/cli/index.js

@@ -35,6 +35,7 @@ program
     .option("-f, --force", "Force initialization even if already exists")
     .option("-r, --rules <rules>", "Comma-separated IDE rules to inject (cursor,claude,copilot,antigravity-ide,antigravity-cli,all)")
     .option("-d, --docs <path>", "Optional path to an existing docs directory to map/index automatically")
+    .option("--no-log", "Disable automatic agent memory usage logging in .memory/usage.log")
     .action(init_1.initProject);
 program
     .command("template <action>")

package/dist/core/parser.js

@@ -76,13 +76,15 @@ async function parseMarkdown(content, path, maxTokens = 450, overlapTokens = 50)
         if (currentBlocks.length > 0) {
             const first = currentBlocks[0];
             const last = currentBlocks[currentBlocks.length - 1];
-            chunks.push({
-                path,
-                text: currentBlocks.map((b) => b.text).join("\n\n"),
-                breadcrumbs: first.breadcrumb,
-                startLine: first.startLine,
-                endLine: last.endLine,
-            });
+            if (first && last) {
+                chunks.push({
+                    path,
+                    text: currentBlocks.map((b) => b.text).join("\n\n"),
+                    breadcrumbs: first.breadcrumb,
+                    startLine: first.startLine,
+                    endLine: last.endLine,
+                });
+            }
         }
     }
     if (ast?.children) {
@@ -131,7 +133,7 @@ async function parseMarkdown(content, path, maxTokens = 450, overlapTokens = 50)
                     let overlapTokensCount = 0;
                     for (let i = currentBlocks.length - 1; i >= 0; i--) {
                         const b = currentBlocks[i];
-                        if (overlapTokensCount + b.tokens <= overlapTokens) {
+                        if (b && overlapTokensCount + b.tokens <= overlapTokens) {
                             overlapBlocks.unshift(b);
                             overlapTokensCount += b.tokens;
                         }

package/dist/core/sync.js

@@ -113,6 +113,8 @@ async function syncFile(path, content, db) {
             for (let j = 0; j < batch.length; j++) {
                 const chunk = batch[j];
                 const embedding = embeddings[j];
+                if (!chunk || !embedding)
+                    continue;
                 // Store in main table
                 await asyncDb.run("INSERT INTO chunks (path, text, breadcrumbs, startLine, endLine) VALUES (?, ?, ?, ?, ?)", [
                     chunk.path,

package/dist/mcp/logger.d.ts

@@ -0,0 +1,10 @@
+export interface MemoryConfig {
+    project_id?: string;
+    created_at?: string;
+    include_paths?: string[];
+    log_usage?: boolean;
+    usage_log_file?: string;
+    [key: string]: unknown;
+}
+export declare function getMemoryConfig(cwd: string): MemoryConfig | null;
+export declare function logUsage(cwd: string, action: string, details?: Record<string, unknown>): void;

package/dist/mcp/logger.js

@@ -0,0 +1,78 @@
+"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.getMemoryConfig = getMemoryConfig;
+exports.logUsage = logUsage;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+function getMemoryConfig(cwd) {
+    const configPath = path.join(cwd, ".memory", "config.json");
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(configPath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function logUsage(cwd, action, details) {
+    try {
+        const config = getMemoryConfig(cwd);
+        if (!config?.log_usage) {
+            return;
+        }
+        const logRelativePath = config.usage_log_file || path.join(".memory", "usage.log");
+        const logFilePath = path.isAbsolute(logRelativePath)
+            ? logRelativePath
+            : path.join(cwd, logRelativePath);
+        const logDir = path.dirname(logFilePath);
+        if (!fs.existsSync(logDir)) {
+            fs.mkdirSync(logDir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString();
+        let detailsStr = "";
+        if (details && Object.keys(details).length > 0) {
+            detailsStr = ` | ${JSON.stringify(details)}`;
+        }
+        const entry = `[${timestamp}] ${action}${detailsStr}\n`;
+        fs.appendFileSync(logFilePath, entry, "utf8");
+    }
+    catch {
+        // Fail silently to avoid breaking any MCP operation
+    }
+}

package/dist/mcp/server.d.ts

@@ -1,2 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 export declare function setupMCPServer(): Promise<McpServer>;
+export declare function setupProcessLifecycle(transport: StdioServerTransport, log?: (msg: string) => void): void;

package/dist/mcp/server.js

@@ -34,10 +34,12 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupMCPServer = setupMCPServer;
+exports.setupProcessLifecycle = setupProcessLifecycle;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const logger_1 = require("./logger");
 const tools_1 = require("./tools");
 const utils_1 = require("./utils");
 async function setupMCPServer() {
@@ -57,6 +59,9 @@ async function setupMCPServer() {
     });
     server.resource("agent-guidelines", "memory://agent-guidelines", { description: "Agent guidelines and memory core rules" }, async (uri) => {
         const { cwd: resolvedCwd } = await (0, utils_1.resolveCwd)();
+        (0, logger_1.logUsage)(resolvedCwd, "RESOURCE_READ: agent-guidelines", {
+            uri: uri.href,
+        });
         const corePath = path.join(resolvedCwd, ".memory", "core.md");
         const text = fs.existsSync(corePath)
             ? fs.readFileSync(corePath, "utf8")
@@ -73,6 +78,7 @@ async function setupMCPServer() {
     });
     server.prompt("agent-guidelines", "Get the agent guidelines and memory core rules", async () => {
         const { cwd: resolvedCwd } = await (0, utils_1.resolveCwd)();
+        (0, logger_1.logUsage)(resolvedCwd, "PROMPT_GET: agent-guidelines");
         const corePath = path.join(resolvedCwd, ".memory", "core.md");
         const text = fs.existsSync(corePath)
             ? fs.readFileSync(corePath, "utf8")
@@ -94,9 +100,37 @@ async function setupMCPServer() {
     transport.onerror = (err) => {
         log(`Transport error: ${err}`);
     };
+    setupProcessLifecycle(transport, log);
     await server.connect(transport);
     log("MCP Server connected via stdio");
     // Opcionalmente podemos exponer log para ser usado por tools si se lo pasamos,
     // pero el servidor ya está funcionando y registrando arranque y errores.
     return server;
 }
+function setupProcessLifecycle(transport, log = () => { }) {
+    let isExiting = false;
+    const exitHandler = (reason) => {
+        if (isExiting)
+            return;
+        isExiting = true;
+        log(`Shutting down MCP server: ${reason}`);
+        process.exit(0);
+    };
+    process.stdin.on("close", () => exitHandler("stdin closed"));
+    process.stdin.on("end", () => exitHandler("stdin ended"));
+    transport.onclose = () => exitHandler("transport closed");
+    process.on("SIGINT", () => exitHandler("SIGINT received"));
+    process.on("SIGTERM", () => exitHandler("SIGTERM received"));
+    if (process.ppid && process.ppid !== 1) {
+        const parentCheckInterval = setInterval(() => {
+            try {
+                process.kill(process.ppid, 0);
+            }
+            catch (_e) {
+                clearInterval(parentCheckInterval);
+                exitHandler(`parent process ${process.ppid} exited`);
+            }
+        }, 2000);
+        parentCheckInterval.unref();
+    }
+}

package/dist/mcp/tools.js

@@ -39,6 +39,7 @@ const path = __importStar(require("node:path"));
 const zod_1 = require("zod");
 const search_1 = require("../core/search");
 const project_1 = require("../db/project");
+const logger_1 = require("./logger");
 const middleware_1 = require("./middleware");
 const utils_1 = require("./utils");
 function registerTools(server) {
@@ -50,6 +51,9 @@ function registerTools(server) {
             .describe("Ruta absoluta del proyecto (usar si MCP es global)"),
     }, async (args) => {
         const { cwd, fallbackUsed } = await (0, utils_1.resolveCwd)(args.projectRoot, server);
+        (0, logger_1.logUsage)(cwd, "TOOL_CALL: get_project_context", {
+            projectRoot: args.projectRoot,
+        });
         await (0, middleware_1.syncMiddleware)(cwd);
         const memoryDir = path.join(cwd, ".memory");
         const corePath = path.join(memoryDir, "core.md");
@@ -88,6 +92,11 @@ function registerTools(server) {
             .describe("Ruta absoluta del proyecto (usar si MCP es global)"),
     }, async (args) => {
         const { cwd, fallbackUsed } = await (0, utils_1.resolveCwd)(args.projectRoot, server);
+        (0, logger_1.logUsage)(cwd, "TOOL_CALL: search_memory", {
+            query: args.query,
+            filter: args.filter,
+            limit: args.limit,
+        });
         await (0, middleware_1.syncMiddleware)(cwd);
         const dbPath = (0, project_1.getLocalDbPath)(cwd);
         const db = (0, project_1.initLocalDb)(dbPath);
@@ -138,6 +147,10 @@ function registerTools(server) {
             .replace(/(^-|-$)/g, "");
         const filename = `${date}-${slug}.md`;
         const { cwd, fallbackUsed } = await (0, utils_1.resolveCwd)(args.projectRoot, server);
+        (0, logger_1.logUsage)(cwd, "TOOL_CALL: log_decision", {
+            title: args.title,
+            status: args.status,
+        });
         const memoryDir = path.join(cwd, ".memory");
         const decisionsDir = path.join(memoryDir, "decisions");
         if (!fs.existsSync(decisionsDir)) {
@@ -186,6 +199,9 @@ ${args.consequences}
             .describe("Ruta absoluta del proyecto (usar si MCP es global)"),
     }, async (args) => {
         const { cwd, fallbackUsed } = await (0, utils_1.resolveCwd)(args.projectRoot, server);
+        (0, logger_1.logUsage)(cwd, "TOOL_CALL: update_core_rules", {
+            charsAdded: args.changes_to_append.length,
+        });
         const memoryDir = path.join(cwd, ".memory");
         const corePath = path.join(memoryDir, "core.md");
         if (!fs.existsSync(memoryDir)) {
@@ -213,6 +229,9 @@ ${args.consequences}
             .describe("Ruta absoluta del proyecto (usar si MCP es global)"),
     }, async (args) => {
         const { cwd, fallbackUsed } = await (0, utils_1.resolveCwd)(args.projectRoot, server);
+        (0, logger_1.logUsage)(cwd, "TOOL_CALL: end_session", {
+            summaryLength: args.summary.length,
+        });
         const memoryDir = path.join(cwd, ".memory");
         const ledgerDir = path.join(memoryDir, "ledger");
         const dateObj = new Date();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-agent-memory",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",