local-agent-memory 1.0.3 → 1.0.5

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
@@ -44,7 +45,16 @@ Comprueba el estado de sincronización del proyecto de memoria actual, mostrando
 memory status
 ```
 
-### 4. `reindex` (o `prune`)
+### 4. `list` (o `projects`)
+Muestra de forma interactiva una lista de todos los proyectos registrados globalmente en tu máquina. Permite seleccionar un proyecto y ver detalles como el total de archivos indexados, los registros de decisiones (ADRs) y los resúmenes de sesión (Ledgers) para ese proyecto.
+
+```bash
+memory list
+# o
+memory projects
+```
+
+### 5. `reindex` (o `prune`)
 Reconstruye los índices FTS (texto completo) y vectoriales desde cero. Útil si sospechas que hay corrupción o desincronización en la base de datos local.
 
 ```bash
@@ -53,7 +63,7 @@ memory reindex
 memory prune
 ```
 
-### 5. `record-session`
+### 6. `record-session`
 Registra un resumen de tu sesión de trabajo actual en el "ledger" (libro mayor) de memoria, documentando las tareas completadas y el contexto para retomarlo más adelante.
 
 **Opciones:**
@@ -63,14 +73,14 @@ Registra un resumen de tu sesión de trabajo actual en el "ledger" (libro mayor)
 memory record-session -s "Implementación del comando sync y corrección de bugs en SQLite"
 ```
 
-### 6. `install-hook`
+### 7. `install-hook`
 Instala ganchos de Git (Git hooks) en tu repositorio local para recordar automáticamente a los desarrolladores registrar sesiones al hacer commits, o para automatizar el registro.
 
 ```bash
 memory install-hook
 ```
 
-### 7. `template <action>`
+### 8. `template <action>`
 Gestiona las plantillas de memoria (permite listar, crear o exportar plantillas desde el proyecto).
 
 **Opciones:**

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.d.ts

@@ -0,0 +1 @@
+export declare function listProjects(): Promise<void>;

package/dist/cli/commands/list.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listProjects = listProjects;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const ora_1 = __importDefault(require("ora"));
+const project_1 = require("../../db/project");
+const registry_1 = require("../../db/registry");
+async function listProjects() {
+    const spinner = (0, ora_1.default)("Cargando proyectos registrados...").start();
+    try {
+        const projects = await (0, registry_1.getAllProjectsFromRegistry)();
+        if (!projects || projects.length === 0) {
+            spinner.info("No hay proyectos registrados en la memoria global.");
+            return;
+        }
+        spinner.stop();
+        const { selectedPath } = await inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "selectedPath",
+                message: "Selecciona un proyecto para ver sus detalles:",
+                choices: projects.map((p) => ({
+                    name: `${p.project_id} (${p.file_path}) - Creado: ${new Date(p.created_at).toLocaleString()}`,
+                    value: p.file_path,
+                })),
+            },
+        ]);
+        console.log(`\nCargando datos para el proyecto en: ${selectedPath}`);
+        const memoryDir = node_path_1.default.join(selectedPath, ".memory");
+        if (!node_fs_1.default.existsSync(memoryDir)) {
+            console.log(`❌ La carpeta .memory no existe en el proyecto seleccionado (${memoryDir}).`);
+            return;
+        }
+        const localDbPath = (0, project_1.getLocalDbPath)(selectedPath);
+        let manifests = [];
+        if (node_fs_1.default.existsSync(localDbPath)) {
+            manifests = await (0, project_1.getAllManifests)(localDbPath);
+        }
+        console.log(`\n=== Registros del Proyecto ===`);
+        console.log(`Total de archivos Markdown registrados en la base de datos local: ${manifests.length}`);
+        if (manifests.length > 0) {
+            console.log(`\nArchivos registrados:`);
+            manifests.forEach((m) => {
+                console.log(`  - ${m.file_path}`);
+            });
+        }
+        // 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"));
+            if (decisions.length > 0) {
+                console.log(`\nDecisiones Arquitectónicas (ADRs):`);
+                decisions.forEach((d) => 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"));
+            if (ledgers.length > 0) {
+                console.log(`\nRegistros de Sesión (Ledger):`);
+                ledgers.forEach((l) => console.log(`  - ledger/${l}`));
+            }
+        }
+        console.log("\n==============================");
+    }
+    catch (err) {
+        spinner.fail("Error al listar proyectos.");
+        console.error(err.message);
+        process.exit(1);
+    }
+}

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

@@ -19,16 +19,23 @@ program
     .version(require("../../package.json").version);
 const hook_1 = require("./commands/hook");
 const init_1 = require("./commands/init");
+const list_1 = require("./commands/list");
 const record_1 = require("./commands/record");
 const status_1 = require("./commands/status");
 const sync_1 = require("./commands/sync");
 const template_1 = require("./commands/template");
+program
+    .command("list")
+    .alias("projects")
+    .description("List registered projects and view their records")
+    .action(list_1.listProjects);
 program
     .command("init")
     .description("Initialize a new memory project")
     .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/db/registry.d.ts

@@ -7,3 +7,9 @@ export declare function getProjectRootFromRegistry(activePath: string, dbPath?:
     path: string;
     fallback: boolean;
 } | null>;
+export interface RegistryProject {
+    project_id: string;
+    file_path: string;
+    created_at: string;
+}
+export declare function getAllProjectsFromRegistry(dbPath?: string): Promise<RegistryProject[]>;

package/dist/db/registry.js

@@ -8,6 +8,7 @@ exports.initRegistryDb = initRegistryDb;
 exports.registerProject = registerProject;
 exports.getProjectByPath = getProjectByPath;
 exports.getProjectRootFromRegistry = getProjectRootFromRegistry;
+exports.getAllProjectsFromRegistry = getAllProjectsFromRegistry;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const sqlite3_1 = __importDefault(require("sqlite3"));
@@ -90,3 +91,15 @@ async function getProjectRootFromRegistry(activePath, dbPath = getRegistryDbPath
         });
     });
 }
+async function getAllProjectsFromRegistry(dbPath = getRegistryDbPath()) {
+    return new Promise((resolve, reject) => {
+        const db = initRegistryDb(dbPath);
+        db.all("SELECT project_id, file_path, created_at FROM projects ORDER BY created_at DESC", [], (err, rows) => {
+            db.close();
+            if (err) {
+                return reject(err);
+            }
+            resolve(rows);
+        });
+    });
+}

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.js

@@ -38,6 +38,7 @@ 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 +58,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 +77,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")

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.3",
+  "version": "1.0.5",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",