@vuau/agent-memory 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,7 +1,3 @@
-// src/opencode/plugin.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } 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";
@@ -14,22 +10,24 @@ var MEMORY_FILE = ".agents/MEMORY.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() {
-  try {
-    const thisDir = dirname(fileURLToPath(import.meta.url));
-    const candidate = resolve(thisDir, "../../templates");
-    if (existsSync(candidate)) return candidate;
-  } catch {
-  }
-  const candidate2 = resolve(__dirname, "../../templates");
-  if (existsSync(candidate2)) return candidate2;
-  throw new Error("Cannot locate templates directory");
+  const thisDir = dirname(fileURLToPath(import.meta.url));
+  const fromSource = resolve(thisDir, "../../templates");
+  if (existsSync(fromSource)) return fromSource;
+  const fromDist = resolve(thisDir, "../templates");
+  if (existsSync(fromDist)) return fromDist;
+  throw new Error(`Cannot locate templates directory (checked ${fromSource} and ${fromDist})`);
 }
 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) {
@@ -39,15 +37,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) {
@@ -55,18 +59,11 @@ 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: 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);
@@ -81,56 +78,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");
@@ -144,88 +136,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 = [];
-  return {
-    event: async ({ event }) => {
-      if (event.type === "session.created") {
-        const hasAgentsMd = existsSync2(agentsFile);
-        const hasMemory = existsSync2(memoryFile);
-        if (!hasMemory && hasAgentsMd) {
-          try {
-            const result = scaffold(directory, { copilotInstructions: false });
-            if (result.created.length > 0) {
-              await client.tui.showToast({
-                body: {
-                  message: `Agent memory initialized: ${result.created.join(", ")}`,
-                  variant: "success"
-                }
-              });
-            }
-          } catch (err) {
-            await client.app.log({
-              body: {
-                service: "agent-memory",
-                level: "warn",
-                message: `Auto-scaffold failed: ${err}`
-              }
-            });
-          }
-        }
-        editCount = 0;
-        specFilesEdited = [];
-        await client.app.log({
-          body: {
-            service: "agent-memory",
-            level: "info",
-            message: `Memory: ${hasMemory}, Tasks: ${existsSync2(tasksFile)}`
-          }
-        });
-      }
-      if (event.type === "session.idle" && editCount >= 3) {
-        if (existsSync2(tasksFile)) {
-          const content = readFileSync2(tasksFile, "utf-8");
-          const inProgressSection = content.split("## In Progress")[1];
-          if (inProgressSection?.trim()) {
-            await client.tui.showToast({
-              body: {
-                message: `${editCount} edits this session. Update .agents/TASKS.md before ending.`,
-                variant: "info"
-              }
-            });
-          }
-        }
-      }
-    },
-    "tool.execute.after": async (input) => {
-      if (input.tool === "edit" || input.tool === "write") {
-        editCount++;
-        const filePath = input.args?.filePath || "";
-        if (filePath.includes(SPEC_DIR)) {
-          const shortPath = filePath.split(SPEC_DIR + "/").pop() || filePath;
-          if (!specFilesEdited.includes(shortPath)) {
-            specFilesEdited.push(shortPath);
-          }
-        }
-      }
-    }
-  };
-};
-
 // 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}`;
@@ -249,8 +168,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")) {
@@ -269,7 +188,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);
@@ -278,8 +197,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")) {
@@ -321,7 +240,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 = [];
@@ -332,17 +251,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,
@@ -350,8 +269,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",
@@ -368,8 +287,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",
@@ -380,9 +299,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",
@@ -390,7 +309,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({
@@ -403,7 +322,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",
@@ -411,7 +330,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({
@@ -430,11 +349,12 @@ function doctor(projectDir) {
 export {
   AGENTS_DIR,
   AGENTS_MD,
-  MemoryLifecyclePlugin as AgentMemoryPlugin,
   COPILOT_INSTRUCTIONS,
+  CURSOR_RULES,
   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.0",
-  "description": "Structured AI memory for codebases — OpenCode plugin + scaffolding CLI",
+  "version": "0.3.0",
+  "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/cursorrules.md

@@ -0,0 +1,43 @@
+# {{PROJECT_NAME}} - Cursor Rules
+
+Instructions for Cursor AI. Keep under 150 lines.
+
+## Priority
+1. User request first.
+2. These rules.
+3. Spec files in `.agents/spec/`.
+4. If conflict remains, choose smallest safe change and state assumption.
+
+## Documentation Map
+
+| Task | Location |
+|------|----------|
+| Past decisions & patterns | `.agents/MEMORY.md` |
+| Current work in progress | `.agents/TASKS.md` |
+| Detailed specs | `.agents/spec/*.md` |
+
+## Memory Protocol
+
+### When to write
+- User approves a decision or pattern → append to `.agents/MEMORY.md`
+- Explore codebase/architecture → update relevant `.agents/spec/*.md`
+- Start/finish a large task → update `.agents/TASKS.md`
+
+### MEMORY.md entry format
+```
+- YYYY-MM-DD: <1-line decision or pattern>
+```
+Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
+
+### TASKS.md update
+Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.
+
+### Rules
+- Keep MEMORY.md entries to 1 line each. Details go in spec files.
+- If MEMORY.md > 150 lines, archive old entries.
+- Do not create additional memory files outside `.agents/`.
+
+## Response Style
+- Concise, concrete, implementation-focused.
+- If uncertain, say `I don't know`, then give fastest verification step.
+- Do not invent files, APIs, or command outputs.