@vuau/agent-memory 0.2.1 → 0.3.1

package/dist/index.js

@@ -1,7 +1,3 @@
-// src/opencode/plugin.ts
-import { existsSync as existsSync2 } from "fs";
-import { resolve as resolve2 } from "path";
-
 // src/core/scaffold.ts
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, resolve, dirname } from "path";
@@ -11,9 +7,12 @@ import { fileURLToPath } from "url";
 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 AGENTS_MD = "AGENTS.md";
 var COPILOT_INSTRUCTIONS = ".github/copilot-instructions.md";
+var CURSOR_RULES = ".cursorrules";
+var WINDSURF_RULES = ".windsurfrules";
 
 // src/core/scaffold.ts
 function getTemplatesDir() {
@@ -27,6 +26,9 @@ function getTemplatesDir() {
 var TEMPLATES_DIR = getTemplatesDir();
 function readTemplate(name) {
   const templatePath = join(TEMPLATES_DIR, name);
+  if (!existsSync(templatePath)) {
+    throw new Error(`Template not found: ${templatePath}`);
+  }
   return readFileSync(templatePath, "utf-8");
 }
 function applyVars(content, vars) {
@@ -36,15 +38,21 @@ function applyVars(content, vars) {
   }
   return result;
 }
-function scaffold(projectDir, config = {}, force = false) {
+function scaffold(projectDir, options = {}) {
   const result = { created: [], skipped: [] };
-  const projectName = config.projectName || guessProjectName(projectDir);
+  const projectName = options.projectName || guessProjectName(projectDir);
   const vars = { PROJECT_NAME: projectName };
+  const force = options.force || false;
+  const hasAnyIde = options.opencode || options.copilot || options.cursor || options.windsurf;
+  const useOpencode = hasAnyIde ? options.opencode : true;
+  const useCopilot = options.copilot || false;
+  const useCursor = options.cursor || false;
+  const useWindsurf = options.windsurf || false;
   const dirs = [
     join(projectDir, AGENTS_DIR),
     join(projectDir, SPEC_DIR)
   ];
-  if (config.copilotInstructions !== false) {
+  if (useCopilot) {
     dirs.push(join(projectDir, ".github"));
   }
   for (const dir of dirs) {
@@ -52,18 +60,12 @@ function scaffold(projectDir, config = {}, force = false) {
       mkdirSync(dir, { recursive: true });
     }
   }
-  const files = [
-    { target: AGENTS_MD, template: "AGENTS.md" },
+  const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
+    { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
     { target: TASKS_FILE, template: "TASKS.md" }
   ];
-  if (config.copilotInstructions !== false) {
-    files.push({
-      target: COPILOT_INSTRUCTIONS,
-      template: "copilot-instructions.md"
-    });
-  }
-  for (const { target, template } of files) {
+  for (const { target, template } of coreFiles) {
     const targetPath = join(projectDir, target);
     if (existsSync(targetPath) && !force) {
       result.skipped.push(target);
@@ -78,56 +80,51 @@ function scaffold(projectDir, config = {}, force = false) {
     writeFileSync(specKeep, "");
     result.created.push(`${SPEC_DIR}/.gitkeep`);
   }
-  if (config.opencode) {
-    scaffoldOpenCode(projectDir, result, force);
+  if (useOpencode) {
+    writeFileIfNeeded(
+      join(projectDir, AGENTS_MD),
+      applyVars(readTemplate("AGENTS.md"), vars),
+      AGENTS_MD,
+      result,
+      force
+    );
   }
-  return result;
-}
-function scaffoldOpenCode(projectDir, result, force) {
-  const PACKAGE_NAME = "@vuau/agent-memory";
-  const opencodePkgPath = join(projectDir, ".opencode", "package.json");
-  const opencodeDir = join(projectDir, ".opencode");
-  if (!existsSync(opencodeDir)) {
-    mkdirSync(opencodeDir, { recursive: true });
+  if (useCopilot) {
+    writeFileIfNeeded(
+      join(projectDir, COPILOT_INSTRUCTIONS),
+      applyVars(readTemplate("copilot-instructions.md"), vars),
+      COPILOT_INSTRUCTIONS,
+      result,
+      force
+    );
   }
-  if (!existsSync(opencodePkgPath)) {
-    writeFileSync(
-      opencodePkgPath,
-      JSON.stringify({ dependencies: { [PACKAGE_NAME]: "latest" } }, null, 2) + "\n"
+  if (useCursor) {
+    writeFileIfNeeded(
+      join(projectDir, CURSOR_RULES),
+      applyVars(readTemplate("cursorrules.md"), vars),
+      CURSOR_RULES,
+      result,
+      force
     );
-    result.created.push(".opencode/package.json");
-  } else {
-    const pkg = JSON.parse(readFileSync(opencodePkgPath, "utf-8"));
-    const deps = pkg.dependencies || {};
-    if (!deps[PACKAGE_NAME] || force) {
-      deps[PACKAGE_NAME] = "latest";
-      pkg.dependencies = deps;
-      writeFileSync(opencodePkgPath, JSON.stringify(pkg, null, 2) + "\n");
-      if (!deps[PACKAGE_NAME]) {
-        result.created.push(".opencode/package.json");
-      }
-    } else {
-      result.skipped.push(".opencode/package.json");
-    }
   }
-  const opencodeJsonPath = join(projectDir, "opencode.json");
-  if (!existsSync(opencodeJsonPath)) {
-    writeFileSync(
-      opencodeJsonPath,
-      JSON.stringify({ plugin: [PACKAGE_NAME] }, null, 2) + "\n"
+  if (useWindsurf) {
+    writeFileIfNeeded(
+      join(projectDir, WINDSURF_RULES),
+      applyVars(readTemplate("windsurfrules.md"), vars),
+      WINDSURF_RULES,
+      result,
+      force
     );
-    result.created.push("opencode.json");
-  } else {
-    const config = JSON.parse(readFileSync(opencodeJsonPath, "utf-8"));
-    const plugins = config.plugin || [];
-    if (!plugins.includes(PACKAGE_NAME)) {
-      config.plugin = [...plugins, PACKAGE_NAME];
-      writeFileSync(opencodeJsonPath, JSON.stringify(config, null, 2) + "\n");
-      result.created.push("opencode.json (merged plugin)");
-    } else {
-      result.skipped.push("opencode.json");
-    }
   }
+  return result;
+}
+function writeFileIfNeeded(targetPath, content, displayName, result, force) {
+  if (existsSync(targetPath) && !force) {
+    result.skipped.push(displayName);
+    return;
+  }
+  writeFileSync(targetPath, content);
+  result.created.push(displayName);
 }
 function guessProjectName(dir) {
   const pkgPath = join(dir, "package.json");
@@ -141,112 +138,15 @@ function guessProjectName(dir) {
   return dir.split("/").pop() || "Project";
 }
 
-// src/opencode/plugin.ts
-var MemoryLifecyclePlugin = async ({ client, directory }) => {
-  const memoryFile = resolve2(directory, MEMORY_FILE);
-  const tasksFile = resolve2(directory, TASKS_FILE);
-  const agentsFile = resolve2(directory, AGENTS_MD);
-  let editCount = 0;
-  let specFilesEdited = [];
-  let sessionStartTime = null;
-  const showToast = async (message, variant = "info") => {
-    try {
-      await client.tui.showToast({
-        body: { message, variant }
-      });
-    } catch {
-      await log("info", message);
-    }
-  };
-  const log = async (level, message, extra) => {
-    try {
-      await client.app.log({
-        body: {
-          service: "agent-memory",
-          level,
-          message,
-          extra
-        }
-      });
-    } catch {
-    }
-  };
-  return {
-    event: async ({ event }) => {
-      if (event.type === "session.created") {
-        sessionStartTime = Date.now();
-        editCount = 0;
-        specFilesEdited = [];
-        const hasAgentsMd = existsSync2(agentsFile);
-        const hasMemory = existsSync2(memoryFile);
-        const hasTasks = existsSync2(tasksFile);
-        if (!hasMemory && hasAgentsMd) {
-          try {
-            const result = scaffold(directory, { copilotInstructions: false });
-            if (result.created.length > 0) {
-              await showToast(`Agent memory initialized: ${result.created.join(", ")}`, "success");
-              await log("info", "Auto-scaffolded .agents/ structure", { created: result.created });
-            }
-          } catch (err) {
-            await log("warn", `Auto-scaffold failed: ${err}`);
-          }
-        }
-        await log("debug", "Session started", {
-          hasAgentsMd,
-          hasMemory,
-          hasTasks,
-          directory
-        });
-      }
-      if (event.type === "session.idle") {
-        if (editCount >= 3 && existsSync2(tasksFile)) {
-          const sessionDuration = sessionStartTime ? Math.round((Date.now() - sessionStartTime) / 1e3 / 60) : 0;
-          await showToast(
-            `${editCount} file edits (${sessionDuration}m). Consider updating .agents/TASKS.md`,
-            "info"
-          );
-          await log("info", "Session idle with significant edits", {
-            editCount,
-            specFilesEdited,
-            sessionDurationMinutes: sessionDuration
-          });
-        }
-      }
-    },
-    // ─────────────────────────────────────────────────────────────
-    // TOOL EXECUTE AFTER — track edits
-    // ─────────────────────────────────────────────────────────────
-    "tool.execute.after": async (input, _output) => {
-      const toolName = input.tool;
-      const filePath = input.args?.filePath || "";
-      if (toolName === "edit" || toolName === "write") {
-        editCount++;
-        if (filePath.includes(SPEC_DIR)) {
-          const shortPath = filePath.split(SPEC_DIR + "/").pop() || filePath;
-          if (!specFilesEdited.includes(shortPath)) {
-            specFilesEdited.push(shortPath);
-          }
-        }
-        if (editCount % 5 === 0) {
-          await log("debug", `Edit milestone: ${editCount} files modified`, {
-            latestFile: filePath,
-            specFilesEdited
-          });
-        }
-      }
-    }
-  };
-};
-
 // src/core/memory.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+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 (!existsSync3(filePath)) {
+  if (!existsSync2(filePath)) {
     throw new Error(`${MEMORY_FILE} not found. Run 'agent-memory init' first.`);
   }
-  const content = readFileSync3(filePath, "utf-8");
+  const content = readFileSync2(filePath, "utf-8");
   const category = entry.category || "Decisions";
   const line = `- ${entry.date}: ${entry.content}`;
   const categoryHeader = `## ${category}`;
@@ -270,8 +170,8 @@ ${line}
 }
 function readMemory(projectDir) {
   const filePath = join2(projectDir, MEMORY_FILE);
-  if (!existsSync3(filePath)) return {};
-  const content = readFileSync3(filePath, "utf-8");
+  if (!existsSync2(filePath)) return {};
+  const content = readFileSync2(filePath, "utf-8");
   const categories = {};
   let currentCategory = "_uncategorized";
   for (const line of content.split("\n")) {
@@ -290,7 +190,7 @@ function readMemory(projectDir) {
 }
 
 // src/core/tasks.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+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);
@@ -299,8 +199,8 @@ function readTasks(projectDir) {
     up_next: [],
     completed: []
   };
-  if (!existsSync4(filePath)) return result;
-  const content = readFileSync4(filePath, "utf-8");
+  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")) {
@@ -342,7 +242,7 @@ ${tasks.completed.map((t) => `- ${t}`).join("\n") || ""}
 }
 
 // src/core/doctor.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
 import { join as join4 } from "path";
 function doctor(projectDir) {
   const issues = [];
@@ -353,17 +253,17 @@ function doctor(projectDir) {
   ];
   for (const { file, desc } of required) {
     const filePath = join4(projectDir, file);
-    if (!existsSync5(filePath)) {
+    if (!existsSync4(filePath)) {
       issues.push({ level: "error", file, message: `Missing ${desc}` });
     }
   }
   for (const dir of [AGENTS_DIR, SPEC_DIR]) {
-    if (!existsSync5(join4(projectDir, dir))) {
+    if (!existsSync4(join4(projectDir, dir))) {
       issues.push({ level: "error", file: dir, message: "Directory missing" });
     }
   }
   const copilotPath = join4(projectDir, COPILOT_INSTRUCTIONS);
-  if (!existsSync5(copilotPath)) {
+  if (!existsSync4(copilotPath)) {
     issues.push({
       level: "warning",
       file: COPILOT_INSTRUCTIONS,
@@ -371,8 +271,8 @@ function doctor(projectDir) {
     });
   }
   const agentsPath = join4(projectDir, AGENTS_MD);
-  if (existsSync5(agentsPath)) {
-    const content = readFileSync5(agentsPath, "utf-8");
+  if (existsSync4(agentsPath)) {
+    const content = readFileSync4(agentsPath, "utf-8");
     if (!content.includes(".agents/")) {
       issues.push({
         level: "warning",
@@ -389,8 +289,8 @@ function doctor(projectDir) {
     }
   }
   const memoryPath = join4(projectDir, MEMORY_FILE);
-  if (existsSync5(memoryPath)) {
-    const lines = readFileSync5(memoryPath, "utf-8").split("\n").length;
+  if (existsSync4(memoryPath)) {
+    const lines = readFileSync4(memoryPath, "utf-8").split("\n").length;
     if (lines > 150) {
       issues.push({
         level: "warning",
@@ -401,9 +301,9 @@ function doctor(projectDir) {
   }
   const opencodePkgPath = join4(projectDir, ".opencode", "package.json");
   const opencodeJsonPath = join4(projectDir, "opencode.json");
-  const opencodeExists = existsSync5(join4(projectDir, ".opencode"));
+  const opencodeExists = existsSync4(join4(projectDir, ".opencode"));
   if (opencodeExists) {
-    if (!existsSync5(opencodePkgPath)) {
+    if (!existsSync4(opencodePkgPath)) {
       issues.push({
         level: "warning",
         file: ".opencode/package.json",
@@ -411,7 +311,7 @@ function doctor(projectDir) {
       });
     } else {
       try {
-        const pkg = JSON.parse(readFileSync5(opencodePkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync4(opencodePkgPath, "utf-8"));
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
         if (!deps["@vuau/agent-memory"]) {
           issues.push({
@@ -424,7 +324,7 @@ function doctor(projectDir) {
         issues.push({ level: "warning", file: ".opencode/package.json", message: "Invalid JSON" });
       }
     }
-    if (!existsSync5(opencodeJsonPath)) {
+    if (!existsSync4(opencodeJsonPath)) {
       issues.push({
         level: "warning",
         file: "opencode.json",
@@ -432,7 +332,7 @@ function doctor(projectDir) {
       });
     } else {
       try {
-        const config = JSON.parse(readFileSync5(opencodeJsonPath, "utf-8"));
+        const config = JSON.parse(readFileSync4(opencodeJsonPath, "utf-8"));
         const plugins = config.plugin || [];
         if (!plugins.includes("@vuau/agent-memory")) {
           issues.push({
@@ -451,11 +351,13 @@ function doctor(projectDir) {
 export {
   AGENTS_DIR,
   AGENTS_MD,
-  MemoryLifecyclePlugin as AgentMemoryPlugin,
   COPILOT_INSTRUCTIONS,
+  CURSOR_RULES,
+  MEMORY_DETAIL_FILE,
   MEMORY_FILE,
   SPEC_DIR,
   TASKS_FILE,
+  WINDSURF_RULES,
   appendMemory,
   doctor,
   readMemory,

package/docs/ARCHITECTURE.md

@@ -253,18 +253,15 @@ This document proposes a generalizable architecture for AI memory across codebas
 
 ## Tooling Support
 
-### OpenCode Plugin (Current)
-- ✓ session.created → log memory file status
-- ✓ tool.execute.after → track spec file edits
-- ✓ session.idle → remind update TASKS.md
-- Planned: ✗ Auto-inject MEMORY.md into next agent session
-
-### CLI (Current)
-- ✓ `npx @vuau/agent-memory init` — scaffold structure
+### CLI
+- ✓ `npx @vuau/agent-memory init` — scaffold structure (interactive or with flags)
+- ✓ `npx @vuau/agent-memory init --opencode` — OpenCode only
+- ✓ `npx @vuau/agent-memory init --copilot --cursor` — multiple IDEs
+- ✓ `npx @vuau/agent-memory init --all` — all IDEs
 - ✓ `npx @vuau/agent-memory doctor` — validate structure
 - Planned: ✗ `report` — generate memory stats, archival suggestions
 
-### VSCode Extension (Planned Phase 3)
+### VSCode Extension (Planned)
 - Sidebar showing MEMORY.md categories
 - Copilot Chat integration → inject relevant spec file on user request
 - Quick commands: "Add decision", "Update task"

package/docs/ARCHITECTURE.vi.md

@@ -111,7 +111,7 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
 **Agent behavior**:
 - Read khi session start → hiểu context, resume work
 - Update trước session end → gì done, gì next
-- Plugin reminds nếu tasks exist nhưng không update
+- Rules trong AGENTS.md nhắc agent update tasks
 
 ---
 
@@ -171,16 +171,15 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
 ## IDE Integration Points
 
 ### OpenCode
-- Reads: AGENTS.md (via plugin hook)
-- Plugin auto-injects: `.agents/MEMORY.md` context khi session start
-- Plugin reminds: Update TASKS.md khi session idle
+- Reads: `AGENTS.md` (native)
+- Agents follow rules trong AGENTS.md
 - Writes: Agent appends đến MEMORY.md/TASKS.md/spec/
 
 ### GitHub Copilot (VSCode)
 - Reads: `.github/copilot-instructions.md` (GitHub convention)
 - copilot-instructions.md = cùng router format với AGENTS.md
 - Points đến `.agents/MEMORY.md` + spec files
-- Writes: User includes `@save memory: <decision>` trong chat → agent appends
+- Writes: Agent follows rules → appends khi appropriate
 
 ### Cursor / Windsurf
 - Reads: `.cursorrules` / `.windsurfrules` (IDE convention)
@@ -253,18 +252,15 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
 
 ## Công cụ Support
 
-### OpenCode Plugin (Hiện tại)
-- ✓ session.created → log memory file status
-- ✓ tool.execute.after → track spec file edits
-- ✓ session.idle → remind update TASKS.md
-- Planned: ✗ Auto-inject MEMORY.md vào next agent session
-
-### CLI (Hiện tại)
-- ✓ `npx @vuau/agent-memory init` — scaffold structure
+### CLI
+- ✓ `npx @vuau/agent-memory init` — scaffold structure (interactive hoặc với flags)
+- ✓ `npx @vuau/agent-memory init --opencode` — chỉ OpenCode
+- ✓ `npx @vuau/agent-memory init --copilot --cursor` — nhiều IDEs
+- ✓ `npx @vuau/agent-memory init --all` — tất cả IDEs
 - ✓ `npx @vuau/agent-memory doctor` — validate structure
 - Planned: ✗ `report` — generate memory stats, archival suggestions
 
-### VSCode Extension (Planned Phase 3)
+### VSCode Extension (Planned)
 - Sidebar showing MEMORY.md categories
 - Copilot Chat integration → inject relevant spec file trên user request
 - Quick commands: "Add decision", "Update task"

package/docs/RESEARCH.md

@@ -19,8 +19,6 @@ AI assistants (OpenCode, Copilot, Cursor, Windsurf) lose context between session
 | **mem0** | ✅ (hooks) | ❌ | Requires OpenAI API key or HuggingFace models | ❌ Failed |
 | **memories.sh** | ✅ (MCP) | ✅ | Auto-generates 10+ IDE config files (bloats repo) | ⚠️ Rejected |
 | **codemem** | ❌ | ❌ | Flaky (unreliable save/recall) | ⚠️ Rejected |
-| **OpenCode plugin** | ✅ (lifecycle hooks) | ✅ | None | ✅ **Viable** |
-| **GitHub Copilot native** | Partial (skills) | ✅ | No lifecycle hooks; no direct session integration | ⚠️ Limited |
 | **File-based + rules** | Manual (via rules) | ✅ | None | ✅ **CHOSEN** |
 
 ---
@@ -84,13 +82,12 @@ AI assistants (OpenCode, Copilot, Cursor, Windsurf) lose context between session
 ### 4. **IDE Portability**
 | IDE | Integration | Works Now |
 |-----|-------------|-----------|
-| OpenCode | Plugin hooks | ✅ Yes |
+| OpenCode | Reads `AGENTS.md` | ✅ Yes |
 | GitHub Copilot | Reads `.github/copilot-instructions.md` | ✅ Yes |
 | Cursor | Reads `.cursorrules` | ✅ Yes |
 | Windsurf | Reads `.windsurfrules` | ✅ Yes |
-| VS Code | Reads markdown in workspace | ✅ Yes |
 
-No custom driver needed per IDE. Markdown is portable.
+No custom plugin needed per IDE. Markdown is portable.
 
 ### 5. **Sharing & Sync**
 - Lives in git repo → automatically shared via Git/Rsync/Dropbox
@@ -175,7 +172,7 @@ TOTAL:                          700 tokens
 - ✅ Context aware: Agent writes when they understand
 - ✅ Curated: Only important decisions survive
 - ✅ Portable: Works everywhere (no dependencies)
-- ❌ Needs agent discipline (mitigated by plugin reminders)
+- ✅ No plugin maintenance burden
 
 **Verdict**: Quality + Portability > Automation for teams of 1-10.
 
@@ -184,16 +181,12 @@ TOTAL:                          700 tokens
 ## Cross-IDE Reality Check
 
 ### ✅ What Works Now
-- OpenCode: Plugin hooks + session lifecycle
+- OpenCode: Reads `AGENTS.md` natively
 - Copilot: Reads `.github/copilot-instructions.md` natively
 - Cursor: Reads `.cursorrules`
 - Windsurf: Reads `.windsurfrules`
-- VS Code: Reads markdown files
 
-### ⚠️ Limitations
-- Copilot doesn't have lifecycle hooks (can't auto-remind to update tasks)
-- Cursor/Windsurf limited to reading rules, not injecting context
-- **Solution**: VSCode extension (Phase 3) to provide unified sidebar
+All IDEs follow rules in their config file → agent writes to `.agents/MEMORY.md` when appropriate.
 
 ---
 

package/docs/RESEARCH.vi.md

@@ -19,8 +19,6 @@ AI assistants (OpenCode, Copilot, Cursor, Windsurf) mất context giữa session
 | **mem0** | ✅ (hooks) | ❌ | Cần OpenAI API key hoặc HuggingFace models | ❌ Failed |
 | **memories.sh** | ✅ (MCP) | ✅ | Auto-generate 10+ IDE config files (bloat repo) | ⚠️ Rejected |
 | **codemem** | ❌ | ❌ | Flaky (unreliable save/recall) | ⚠️ Rejected |
-| **OpenCode plugin** | ✅ (lifecycle hooks) | ✅ | None | ✅ **Viable** |
-| **GitHub Copilot native** | Partial (skills) | ✅ | Không có lifecycle hooks | ⚠️ Limited |
 | **File-based + rules** | Manual (via rules) | ✅ | None | ✅ **CHOSEN** |
 
 ---
@@ -84,13 +82,12 @@ AI assistants (OpenCode, Copilot, Cursor, Windsurf) mất context giữa session
 ### 4. **IDE Portability**
 | IDE | Integration | Works Now |
 |-----|-------------|-----------|
-| OpenCode | Plugin hooks | ✅ Yes |
+| OpenCode | Reads `AGENTS.md` | ✅ Yes |
 | GitHub Copilot | Reads `.github/copilot-instructions.md` | ✅ Yes |
 | Cursor | Reads `.cursorrules` | ✅ Yes |
 | Windsurf | Reads `.windsurfrules` | ✅ Yes |
-| VS Code | Reads markdown | ✅ Yes |
 
-Không cần custom driver per IDE. Markdown portable.
+Không cần custom plugin per IDE. Markdown portable.
 
 ### 5. **Sharing & Sync**
 - Live trong git repo → auto-shared via Git/Rsync/Dropbox
@@ -175,7 +172,7 @@ TOTAL:                          700 tokens
 - ✅ Context aware: Agent ghi khi họ hiểu
 - ✅ Curated: Chỉ important decisions sống sót
 - ✅ Portable: Hoạt động everywhere (no dependencies)
-- ❌ Cần agent discipline (mitigated bởi plugin reminders)
+- ✅ Không cần maintain plugin
 
 **Verdict**: Quality + Portability > Automation cho teams 1-10.
 
@@ -184,16 +181,12 @@ TOTAL:                          700 tokens
 ## Cross-IDE Reality Check
 
 ### ✅ Gì hoạt động ngay
-- OpenCode: Plugin hooks + session lifecycle
+- OpenCode: Read `AGENTS.md` natively
 - Copilot: Read `.github/copilot-instructions.md` natively
 - Cursor: Read `.cursorrules`
 - Windsurf: Read `.windsurfrules`
-- VS Code: Read markdown files
 
-### ⚠️ Limitations
-- Copilot không có lifecycle hooks (cannot auto-remind update tasks)
-- Cursor/Windsurf limited tới read rules, không inject context
-- **Solution**: VSCode extension (Phase 3) để provide unified sidebar
+Tất cả IDEs follow rules trong config file → agent ghi vào `.agents/MEMORY.md` khi appropriate.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vuau/agent-memory",
-  "version": "0.2.1",
-  "description": "Structured AI memory for codebases — OpenCode plugin + scaffolding CLI",
+  "version": "0.3.1",
+  "description": "Structured AI memory for codebases — scaffolding CLI for OpenCode, Copilot, Cursor, Windsurf",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -25,27 +25,20 @@
     "typescript": "^6.0.3"
   },
   "keywords": [
-    "opencode",
-    "opencode-plugin",
     "agent-memory",
     "ai-memory",
     "agents",
+    "opencode",
     "copilot",
     "cursor",
-    "windsurf"
+    "windsurf",
+    "claude",
+    "cli"
   ],
   "author": "Au Pham <phamvuau@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vuau/agent-memory.git"
-  },
-  "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@opencode-ai/plugin": {
-      "optional": true
-    }
   }
 }

package/templates/AGENTS.md

@@ -12,7 +12,8 @@ Router file for AI agents. Keep under 150 lines.
 
 | Task | Spec File |
 |------|-----------|
-| Past decisions & patterns | `.agents/MEMORY.md` |
+| 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.
@@ -26,9 +27,9 @@ Router file for AI agents. Keep under 150 lines.
 
 ### MEMORY.md entry format
 ```
-- YYYY-MM-DD: <1-line decision or pattern>
+- YYYY-MM-DD: <1-line decision or pattern> → detail
 ```
-Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
+Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
 
 ### TASKS.md update
 Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.