@vuau/agent-memory 0.4.1 → 0.5.0

package/dist/bin/cli.js

@@ -1,19 +1,24 @@
 #!/usr/bin/env node
 
-// src/core/scaffold.ts
+// bin/cli.ts
+import { existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+
+// src/scaffold.ts
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 
-// src/core/types.ts
+// src/types.ts
 var AGENTS_DIR = ".agents";
 var SPEC_DIR = ".agents/spec";
 var MEMORY_FILE = ".agents/MEMORY.md";
 var MEMORY_DETAIL_FILE = ".agents/MEMORY-DETAIL.md";
 var TASKS_FILE = ".agents/TASKS.md";
+var CUSTOM_FILE = ".agents/CUSTOM.md";
 var AGENTS_MD = "AGENTS.md";
 
-// src/core/scaffold.ts
+// src/scaffold.ts
 function getTemplatesDir() {
   const thisDir = dirname(fileURLToPath(import.meta.url));
   const fromSource = resolve(thisDir, "../../templates");
@@ -54,7 +59,8 @@ function scaffold(projectDir, options = {}) {
   const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
     { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
-    { target: TASKS_FILE, template: "TASKS.md" }
+    { target: TASKS_FILE, template: "TASKS.md" },
+    { target: CUSTOM_FILE, template: "CUSTOM.md" }
   ];
   for (const { target, template } of coreFiles) {
     const targetPath = join(projectDir, target);
@@ -99,14 +105,24 @@ function guessProjectName(dir) {
   }
   return dir.split("/").pop() || "Project";
 }
+function updateRouter(projectDir) {
+  const targetPath = join(projectDir, AGENTS_MD);
+  if (!existsSync(targetPath)) return false;
+  const projectName = guessProjectName(projectDir);
+  const vars = { PROJECT_NAME: projectName };
+  const content = applyVars(readTemplate("AGENTS.md"), vars);
+  writeFileSync(targetPath, content);
+  return true;
+}
 
-// src/core/doctor.ts
+// src/doctor.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import { join as join2 } from "path";
 function doctor(projectDir) {
   const issues = [];
   const required = [
     { file: AGENTS_MD, desc: "Root router file" },
+    { file: CUSTOM_FILE, desc: "Project specific rules" },
     { file: MEMORY_FILE, desc: "Long-term memory" },
     { file: TASKS_FILE, desc: "Working memory" }
   ];
@@ -162,6 +178,7 @@ function printUsage() {
 
 Usage:
   agent-memory init [options]    Scaffold .agents/ structure and AGENTS.md
+  agent-memory update            Update AGENTS.md router to latest version
   agent-memory doctor            Validate .agents/ structure
   agent-memory help              Show this help
 
@@ -208,6 +225,26 @@ Initializing agent memory in ${cwd}...
   console.log("  3. Agent will read rules and write to .agents/MEMORY.md automatically");
   console.log("");
 }
+async function runUpdate() {
+  const cwd = process.cwd();
+  const agentsMdPath = join3(cwd, AGENTS_MD);
+  if (!existsSync3(agentsMdPath)) {
+    console.error("\u2717 AGENTS.md not found. Please run 'agent-memory init' first.");
+    process.exit(1);
+  }
+  console.log(`
+Updating ${AGENTS_MD} in ${cwd}...
+`);
+  const updated = updateRouter(cwd);
+  if (updated) {
+    console.log(`  \u2713 ${AGENTS_MD} updated to the latest template.`);
+    console.log(`  (Note: Your custom rules in .agents/CUSTOM.md were not affected)`);
+  } else {
+    console.error("\u2717 Failed to update AGENTS.md");
+    process.exit(1);
+  }
+  console.log("");
+}
 function runDoctor() {
   const cwd = process.cwd();
   const result = doctor(cwd);
@@ -234,6 +271,12 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "update":
+    runUpdate().catch((err) => {
+      console.error("Error:", err.message);
+      process.exit(1);
+    });
+    break;
   case "doctor":
     runDoctor();
     break;

package/dist/index.js

@@ -1,17 +1,18 @@
-// src/core/scaffold.ts
+// src/scaffold.ts
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 
-// src/core/types.ts
+// src/types.ts
 var AGENTS_DIR = ".agents";
 var SPEC_DIR = ".agents/spec";
 var MEMORY_FILE = ".agents/MEMORY.md";
 var MEMORY_DETAIL_FILE = ".agents/MEMORY-DETAIL.md";
 var TASKS_FILE = ".agents/TASKS.md";
+var CUSTOM_FILE = ".agents/CUSTOM.md";
 var AGENTS_MD = "AGENTS.md";
 
-// src/core/scaffold.ts
+// src/scaffold.ts
 function getTemplatesDir() {
   const thisDir = dirname(fileURLToPath(import.meta.url));
   const fromSource = resolve(thisDir, "../../templates");
@@ -52,7 +53,8 @@ function scaffold(projectDir, options = {}) {
   const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
     { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
-    { target: TASKS_FILE, template: "TASKS.md" }
+    { target: TASKS_FILE, template: "TASKS.md" },
+    { target: CUSTOM_FILE, template: "CUSTOM.md" }
   ];
   for (const { target, template } of coreFiles) {
     const targetPath = join(projectDir, target);
@@ -97,134 +99,41 @@ function guessProjectName(dir) {
   }
   return dir.split("/").pop() || "Project";
 }
-
-// src/core/memory.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join2 } from "path";
-function appendMemory(projectDir, entry) {
-  const filePath = join2(projectDir, MEMORY_FILE);
-  if (!existsSync2(filePath)) {
-    throw new Error(`${MEMORY_FILE} not found. Run 'agent-memory init' first.`);
-  }
-  const content = readFileSync2(filePath, "utf-8");
-  const category = entry.category || "Decisions";
-  const line = `- ${entry.date}: ${entry.content}`;
-  const categoryHeader = `## ${category}`;
-  const headerIndex = content.indexOf(categoryHeader);
-  let updated;
-  if (headerIndex === -1) {
-    updated = content.trimEnd() + `
-
-${categoryHeader}
-${line}
-`;
-  } else {
-    const afterHeader = headerIndex + categoryHeader.length;
-    const nextHeaderIndex = content.indexOf("\n## ", afterHeader);
-    const insertAt = nextHeaderIndex === -1 ? content.length : nextHeaderIndex;
-    const categoryContent = content.slice(afterHeader, insertAt);
-    const lastLineEnd = afterHeader + categoryContent.trimEnd().length;
-    updated = content.slice(0, lastLineEnd) + "\n" + line + content.slice(lastLineEnd);
-  }
-  writeFileSync2(filePath, updated);
-}
-function readMemory(projectDir) {
-  const filePath = join2(projectDir, MEMORY_FILE);
-  if (!existsSync2(filePath)) return {};
-  const content = readFileSync2(filePath, "utf-8");
-  const categories = {};
-  let currentCategory = "_uncategorized";
-  for (const line of content.split("\n")) {
-    const headerMatch = line.match(/^## (.+)/);
-    if (headerMatch) {
-      currentCategory = headerMatch[1];
-      categories[currentCategory] = categories[currentCategory] || [];
-      continue;
-    }
-    if (line.startsWith("- ") && currentCategory) {
-      categories[currentCategory] = categories[currentCategory] || [];
-      categories[currentCategory].push(line.slice(2));
-    }
-  }
-  return categories;
-}
-
-// src/core/tasks.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join3 } from "path";
-function readTasks(projectDir) {
-  const filePath = join3(projectDir, TASKS_FILE);
-  const result = {
-    in_progress: [],
-    up_next: [],
-    completed: []
-  };
-  if (!existsSync3(filePath)) return result;
-  const content = readFileSync3(filePath, "utf-8");
-  let currentSection = null;
-  for (const line of content.split("\n")) {
-    if (line.startsWith("## In Progress")) {
-      currentSection = "in_progress";
-      continue;
-    }
-    if (line.startsWith("## Up Next")) {
-      currentSection = "up_next";
-      continue;
-    }
-    if (line.startsWith("## Completed")) {
-      currentSection = "completed";
-      continue;
-    }
-    if (currentSection && line.startsWith("- ")) {
-      result[currentSection].push(line.slice(2));
-    }
-  }
-  return result;
-}
-function writeTasks(projectDir, tasks) {
-  const filePath = join3(projectDir, TASKS_FILE);
-  const content = `# Current Tasks
-
-Working memory for cross-session continuity. Update before ending a session.
-
----
-
-## In Progress
-${tasks.in_progress.map((t) => `- ${t}`).join("\n") || ""}
-
-## Up Next
-${tasks.up_next.map((t) => `- ${t}`).join("\n") || ""}
-
-## Completed
-${tasks.completed.map((t) => `- ${t}`).join("\n") || ""}
-`;
-  writeFileSync3(filePath, content);
+function updateRouter(projectDir) {
+  const targetPath = join(projectDir, AGENTS_MD);
+  if (!existsSync(targetPath)) return false;
+  const projectName = guessProjectName(projectDir);
+  const vars = { PROJECT_NAME: projectName };
+  const content = applyVars(readTemplate("AGENTS.md"), vars);
+  writeFileSync(targetPath, content);
+  return true;
 }
 
-// src/core/doctor.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
-import { join as join4 } from "path";
+// src/doctor.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
 function doctor(projectDir) {
   const issues = [];
   const required = [
     { file: AGENTS_MD, desc: "Root router file" },
+    { file: CUSTOM_FILE, desc: "Project specific rules" },
     { file: MEMORY_FILE, desc: "Long-term memory" },
     { file: TASKS_FILE, desc: "Working memory" }
   ];
   for (const { file, desc } of required) {
-    const filePath = join4(projectDir, file);
-    if (!existsSync4(filePath)) {
+    const filePath = join2(projectDir, file);
+    if (!existsSync2(filePath)) {
       issues.push({ level: "error", file, message: `Missing ${desc}` });
     }
   }
   for (const dir of [AGENTS_DIR, SPEC_DIR]) {
-    if (!existsSync4(join4(projectDir, dir))) {
+    if (!existsSync2(join2(projectDir, dir))) {
       issues.push({ level: "error", file: dir, message: "Directory missing" });
     }
   }
-  const agentsPath = join4(projectDir, AGENTS_MD);
-  if (existsSync4(agentsPath)) {
-    const content = readFileSync4(agentsPath, "utf-8");
+  const agentsPath = join2(projectDir, AGENTS_MD);
+  if (existsSync2(agentsPath)) {
+    const content = readFileSync2(agentsPath, "utf-8");
     if (!content.includes(".agents/")) {
       issues.push({
         level: "warning",
@@ -240,9 +149,9 @@ function doctor(projectDir) {
       });
     }
   }
-  const memoryPath = join4(projectDir, MEMORY_FILE);
-  if (existsSync4(memoryPath)) {
-    const lines = readFileSync4(memoryPath, "utf-8").split("\n").length;
+  const memoryPath = join2(projectDir, MEMORY_FILE);
+  if (existsSync2(memoryPath)) {
+    const lines = readFileSync2(memoryPath, "utf-8").split("\n").length;
     if (lines > 150) {
       issues.push({
         level: "warning",
@@ -256,14 +165,12 @@ function doctor(projectDir) {
 export {
   AGENTS_DIR,
   AGENTS_MD,
+  CUSTOM_FILE,
   MEMORY_DETAIL_FILE,
   MEMORY_FILE,
   SPEC_DIR,
   TASKS_FILE,
-  appendMemory,
   doctor,
-  readMemory,
-  readTasks,
   scaffold,
-  writeTasks
+  updateRouter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vuau/agent-memory",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Structured AI memory for codebases — scaffolding CLI for OpenCode, Copilot, Cursor, Windsurf",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,7 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
+    "@types/node": "^25.6.0",
     "tsup": "^8.0.0",
     "typescript": "^6.0.3"
   },

package/templates/AGENTS.md

@@ -1,22 +1,18 @@
 # {{PROJECT_NAME}} - AGENTS
 
-Router file for AI agents. Keep under 150 lines.
+Router file for AI agents.
+
+> **Note**: This file is automatically managed by `@vuau/agent-memory`.
+> Do not add project-specific rules here, as they may be overwritten by `agent-memory update`.
+>
+> 👉 **For project-specific rules, context, and document mapping, see `.agents/CUSTOM.md`**
 
 ## Priority
 1. User request first.
-2. This `AGENTS.md`.
-3. Spec files in `.agents/spec/`.
-4. If conflict remains, choose smallest safe change and state assumption.
-
-## Documentation Map
-
-| Task | Spec File |
-|------|-----------|
-| Past decisions (1-line) | `.agents/MEMORY.md` |
-| Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
-| Current work in progress | `.agents/TASKS.md` |
-
-> Add your own spec files to `.agents/spec/` and reference them here.
+2. The rules in `.agents/CUSTOM.md`.
+3. This `AGENTS.md`.
+4. Spec files in `.agents/spec/`.
+5. If conflict remains, choose smallest safe change and state assumption.
 
 ## Memory Protocol
 
@@ -41,5 +37,6 @@ Before ending a session with unfinished work, move items to `## In Progress` or
 
 ## Response Style
 - Concise, concrete, implementation-focused.
+- Propose the simplest solution first (KISS & YAGNI) before writing code.
 - If uncertain, say `I don't know`, then give fastest verification step.
 - Do not invent files, APIs, or command outputs.

package/templates/CUSTOM.md

@@ -0,0 +1,18 @@
+# Project Rules & Document Map
+
+This file contains project-specific rules, architectural decisions, and document mappings.
+Feel free to modify this file to suit your project's needs.
+
+## Documentation Map
+
+| Task | Spec File |
+|------|-----------|
+| Past decisions (1-line) | `.agents/MEMORY.md` |
+| Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
+| Current work in progress | `.agents/TASKS.md` |
+
+> Add your own spec files to `.agents/spec/` and reference them here.
+
+## Custom Rules
+
+- Add your project-specific rules here.