@vuau/agent-memory 0.4.0 → 0.4.1

package/README.md

@@ -1,6 +1,6 @@
 # @vuau/agent-memory
 
-Structured AI memory for codebases. Works with GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, and [25+ other AI coding tools](#supported-tools).
+Structured AI memory for codebases. Uses `AGENTS.md` to work with OpenCode, GitHub Copilot, Cursor, Windsurf, and any AI coding assistant that reads markdown files.
 
 **[Tiếng Việt →](./README.vi.md)**
 
@@ -19,28 +19,26 @@ AI coding assistants lose context between sessions. They can't remember:
 npx @vuau/agent-memory init
 ```
 
-That's it. Creates `AGENTS.md` + `.agents/` structure.
-
 ## What It Creates
 
 ```
 / (Project Root)
-├── AGENTS.md           # Universal agent instructions
+├── AGENTS.md                    # Root agent rules
 └── .agents/
-    ├── MEMORY.md       # Long-term memory (decisions, patterns)
-    ├── TASKS.md        # Working memory (current tasks)
-    └── spec/           # Detailed specs (on-demand)
+    ├── MEMORY.md                # Long-term memory (decisions, patterns)
+    ├── TASKS.md                 # Working memory (current tasks)
+    └── spec/                    # Detailed specs (on-demand)
 ```
 
 ## How It Works
 
 1. **You run `init`** → Creates `AGENTS.md` + `.agents/` structure
-2. **Agent reads AGENTS.md** → Finds documentation map pointing to `.agents/`
+2. **Agent reads rules** → Finds documentation map pointing to `.agents/`
 3. **Agent works** → Reads MEMORY.md before implementing, updates TASKS.md
 4. **You approve decision** → Agent writes 1-line entry to MEMORY.md
 5. **Next session** → Agent reads memory, continues where you left off
 
-**No plugin required.** The instructions in AGENTS.md tell the agent what to do.
+**No plugin required.** The rules in `AGENTS.md` instruct the agent what to do.
 
 ## CLI Options
 
@@ -48,8 +46,8 @@ That's it. Creates `AGENTS.md` + `.agents/` structure.
 npx @vuau/agent-memory init [options]
 
 Options:
-  --force        Overwrite existing files without asking
-  --name <n>     Project name (default: from package.json)
+  --force       Overwrite existing files without asking
+  --name <n>    Project name (default: from package.json)
 
 npx @vuau/agent-memory doctor   # Validate structure
 npx @vuau/agent-memory help     # Show help
@@ -57,7 +55,7 @@ npx @vuau/agent-memory help     # Show help
 
 ## Memory Protocol
 
-Agents follow this protocol (defined in AGENTS.md):
+Agents follow this protocol (defined in config files):
 
 ```markdown
 ## When to write
@@ -82,11 +80,11 @@ Agents follow this protocol (defined in AGENTS.md):
 
 ## Architecture
 
-### 3-Layer Design
+### 4-Layer Design
 
 | Layer | File | Purpose |
 |-------|------|---------|
-| Instructions | AGENTS.md | Rules + pointers (~100 lines) |
+| Router | AGENTS.md | Rules + pointers (~100 lines) |
 | Memory | .agents/MEMORY.md | Curated decisions (1-line each) |
 | Tasks | .agents/TASKS.md | Current work, next steps |
 | Specs | .agents/spec/*.md | Detailed docs (on-demand) |
@@ -104,17 +102,21 @@ File-based solution:
 - Plain markdown (portable, git-versionable, human-readable)
 - No dependencies (works everywhere)
 
-## Supported Tools
+## Cross-IDE Compatibility
+
+By default, we only scaffold `AGENTS.md`, which is an emerging standard router file.
 
-AGENTS.md is the universal format, supported by **25+ AI coding tools**:
+If your tool requires a specific file (e.g. Cursor requires `.cursorrules`, GitHub Copilot requires `.github/copilot-instructions.md`), you can simply symlink or copy `AGENTS.md`:
 
-| Category | Tools |
-|----------|-------|
-| **IDEs** | Cursor, Windsurf, VS Code, Zed, RooCode, Kilo Code |
-| **CLI Tools** | OpenCode, Aider, goose, Gemini CLI, Warp, Augment Code |
-| **AI Agents** | GitHub Copilot, Codex (OpenAI), Jules (Google), Junie (JetBrains), Devin, Factory, Amp, Phoenix, Semgrep, Ona, UiPath Autopilot |
+```bash
+# For Cursor
+ln -s AGENTS.md .cursorrules
+
+# For GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
 
-See [agents.md](https://agents.md) for the full list.
+All tools will read from the same underlying `.agents/` memory structure.
 
 ## Documentation
 

package/README.vi.md

@@ -1,6 +1,6 @@
 # @vuau/agent-memory
 
-Bộ nhớ AI có cấu trúc cho các codebase. Hoạt động với GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, và [25+ AI coding tools khác](#supported-tools).
+Bộ nhớ AI có cấu trúc cho các codebase. Sử dụng `AGENTS.md` để hoạt động với OpenCode, GitHub Copilot, Cursor, Windsurf, và bất kỳ AI coding assistant nào đọc markdown files.
 
 ## Bài toán
 
@@ -17,28 +17,26 @@ AI coding assistants mất bối cảnh giữa các phiên. Họ không thể nh
 npx @vuau/agent-memory init
 ```
 
-Đơn giản vậy thôi. Tạo `AGENTS.md` + `.agents/` structure.
-
 ## Cấu trúc tạo ra
 
 ```
 / (Project Root)
-├── AGENTS.md           # Universal agent instructions
+├── AGENTS.md                    # Root agent rules
 └── .agents/
-    ├── MEMORY.md       # Long-term memory (decisions, patterns)
-    ├── TASKS.md        # Working memory (current tasks)
-    └── spec/           # Detailed specs (on-demand)
+    ├── MEMORY.md                # Long-term memory (decisions, patterns)
+    ├── TASKS.md                 # Working memory (current tasks)
+    └── spec/                    # Detailed specs (on-demand)
 ```
 
 ## Cách hoạt động
 
 1. **Bạn chạy `init`** → Tạo `AGENTS.md` + `.agents/` structure
-2. **Agent đọc AGENTS.md** → Tìm documentation map trỏ đến `.agents/`
+2. **Agent đọc rules** → Tìm documentation map trỏ đến `.agents/`
 3. **Agent làm việc** → Đọc MEMORY.md trước khi implement, update TASKS.md
 4. **Bạn approve decision** → Agent ghi 1-line entry vào MEMORY.md
 5. **Phiên tiếp theo** → Agent đọc memory, tiếp tục từ nơi dừng lại
 
-**Không cần plugin.** Instructions trong AGENTS.md hướng dẫn agent phải làm gì.
+**Không cần plugin.** Rules trong `AGENTS.md` hướng dẫn agent phải làm gì.
 
 ## CLI Options
 
@@ -46,8 +44,8 @@ npx @vuau/agent-memory init
 npx @vuau/agent-memory init [options]
 
 Options:
-  --force        Ghi đè files có sẵn mà không hỏi
-  --name <n>     Tên project (mặc định: từ package.json)
+  --force       Ghi đè files có sẵn mà không hỏi
+  --name <n>    Tên project (mặc định: từ package.json)
 
 npx @vuau/agent-memory doctor   # Validate structure
 npx @vuau/agent-memory help     # Hiện help
@@ -55,7 +53,7 @@ npx @vuau/agent-memory help     # Hiện help
 
 ## Memory Protocol
 
-Agents follow protocol này (defined trong AGENTS.md):
+Agents follow protocol này (defined trong config files):
 
 ```markdown
 ## Khi nào ghi
@@ -80,11 +78,11 @@ Agents follow protocol này (defined trong AGENTS.md):
 
 ## Kiến trúc
 
-### Thiết kế 3-Layer
+### Thiết kế 4-Layer
 
 | Layer | File | Mục đích |
 |-------|------|----------|
-| Instructions | AGENTS.md | Rules + pointers (~100 dòng) |
+| Router | AGENTS.md | Rules + pointers (~100 dòng) |
 | Memory | .agents/MEMORY.md | Curated decisions (1-line each) |
 | Tasks | .agents/TASKS.md | Current work, next steps |
 | Specs | .agents/spec/*.md | Detailed docs (on-demand) |
@@ -102,17 +100,21 @@ File-based solution:
 - Plain markdown (portable, git-versionable, human-readable)
 - Không dependencies (works everywhere)
 
-## Supported Tools
+## Cross-IDE Compatibility
+
+Mặc định, công cụ chỉ scaffold `AGENTS.md`, một chuẩn router file đang phổ biến.
 
-AGENTS.md là format universal, được hỗ trợ bởi **25+ AI coding tools**:
+Nếu công cụ của bạn yêu cầu một file cụ thể (vd: Cursor yêu cầu `.cursorrules`, GitHub Copilot yêu cầu `.github/copilot-instructions.md`), bạn có thể đơn giản dùng symlink hoặc copy `AGENTS.md`:
 
-| Category | Tools |
-|----------|-------|
-| **IDEs** | Cursor, Windsurf, VS Code, Zed, RooCode, Kilo Code |
-| **CLI Tools** | OpenCode, Aider, goose, Gemini CLI, Warp, Augment Code |
-| **AI Agents** | GitHub Copilot, Codex (OpenAI), Jules (Google), Junie (JetBrains), Devin, Factory, Amp, Phoenix, Semgrep, Ona, UiPath Autopilot |
+```bash
+# Cho Cursor
+ln -s AGENTS.md .cursorrules
+
+# Cho GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
 
-Xem [agents.md](https://agents.md) để có danh sách đầy đủ.
+Tất cả các công cụ sẽ cùng đọc chung cấu trúc bộ nhớ bên trong thư mục `.agents/`.
 
 ## Tài liệu
 

package/dist/bin/cli.js

@@ -1,10 +1,5 @@
 #!/usr/bin/env node
 
-// bin/cli.ts
-import * as readline from "readline";
-import { existsSync as existsSync3 } from "fs";
-import { join as join3 } from "path";
-
 // src/core/scaffold.ts
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, resolve, dirname } from "path";
@@ -56,13 +51,6 @@ function scaffold(projectDir, options = {}) {
       mkdirSync(dir, { recursive: true });
     }
   }
-  writeFileIfNeeded(
-    join(projectDir, AGENTS_MD),
-    applyVars(readTemplate("AGENTS.md"), vars),
-    AGENTS_MD,
-    result,
-    force
-  );
   const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
     { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
@@ -83,6 +71,13 @@ function scaffold(projectDir, options = {}) {
     writeFileSync(specKeep, "");
     result.created.push(`${SPEC_DIR}/.gitkeep`);
   }
+  writeFileIfNeeded(
+    join(projectDir, AGENTS_MD),
+    applyVars(readTemplate("AGENTS.md"), vars),
+    AGENTS_MD,
+    result,
+    force
+  );
   return result;
 }
 function writeFileIfNeeded(targetPath, content, displayName, result, force) {
@@ -111,7 +106,7 @@ import { join as join2 } from "path";
 function doctor(projectDir) {
   const issues = [];
   const required = [
-    { file: AGENTS_MD, desc: "Root agent instructions" },
+    { file: AGENTS_MD, desc: "Root router file" },
     { file: MEMORY_FILE, desc: "Long-term memory" },
     { file: TASKS_FILE, desc: "Working memory" }
   ];
@@ -140,7 +135,7 @@ function doctor(projectDir) {
       issues.push({
         level: "warning",
         file: AGENTS_MD,
-        message: "Over 150 lines \u2014 consider keeping it concise"
+        message: "Over 150 lines \u2014 consider keeping it concise as a router"
       });
     }
   }
@@ -161,28 +156,12 @@ function doctor(projectDir) {
 // bin/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
-var rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-function ask(question) {
-  return new Promise((resolve2) => {
-    rl.question(question, (answer) => resolve2(answer.trim()));
-  });
-}
-function askYesNo(question, defaultYes = true) {
-  const hint = defaultYes ? "(Y/n)" : "(y/N)";
-  return ask(`${question} ${hint} `).then((answer) => {
-    if (!answer) return defaultYes;
-    return answer.toLowerCase().startsWith("y");
-  });
-}
 function printUsage() {
   console.log(`
 @vuau/agent-memory \u2014 Structured AI memory for codebases
 
 Usage:
-  agent-memory init [options]    Scaffold AGENTS.md + .agents/ structure
+  agent-memory init [options]    Scaffold .agents/ structure and AGENTS.md
   agent-memory doctor            Validate .agents/ structure
   agent-memory help              Show this help
 
@@ -191,14 +170,8 @@ Options (init):
   --name <name>                  Project name (default: from package.json)
 
 Examples:
-  npx @vuau/agent-memory init              # Create AGENTS.md + .agents/
-  npx @vuau/agent-memory init --force      # Overwrite existing files
-  npx @vuau/agent-memory doctor            # Check structure
-
-AGENTS.md is the universal format supported by 25+ AI coding tools:
-  GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, Codex, Jules,
-  Junie, Gemini CLI, Devin, Aider, goose, Factory, Amp, RooCode,
-  Zed, Warp, Kilo Code, Phoenix, Semgrep, Ona, UiPath, Augment Code...
+  npx @vuau/agent-memory init
+  npx @vuau/agent-memory init --force
 `);
 }
 async function runInit() {
@@ -207,31 +180,9 @@ async function runInit() {
   const nameIdx = args.indexOf("--name");
   const projectName = nameIdx !== -1 ? args[nameIdx + 1] : void 0;
   const options = {
-    projectName
+    projectName,
+    force
   };
-  if (!force) {
-    const filesToCheck = [
-      { path: AGENTS_MD, name: "AGENTS.md" },
-      { path: MEMORY_FILE, name: ".agents/MEMORY.md" },
-      { path: TASKS_FILE, name: ".agents/TASKS.md" }
-    ];
-    const existingFiles = filesToCheck.filter((f) => existsSync3(join3(cwd, f.path)));
-    if (existingFiles.length > 0) {
-      console.log("\nExisting files found:");
-      for (const f of existingFiles) {
-        console.log(`  - ${f.name}`);
-      }
-      const overwrite = await askYesNo("\nOverwrite these files?", false);
-      if (!overwrite) {
-        console.log("\nAborted. Use --force to overwrite without asking.\n");
-        rl.close();
-        return;
-      }
-      options.force = true;
-    }
-  } else {
-    options.force = true;
-  }
   console.log(`
 Initializing agent memory in ${cwd}...
 `);
@@ -247,13 +198,15 @@ Initializing agent memory in ${cwd}...
     for (const f of result.skipped) {
       console.log(`  - ${f}`);
     }
+    if (!force) {
+      console.log("\nTip: Use --force to overwrite existing files.");
+    }
   }
   console.log("\nNext steps:");
   console.log("  1. Edit AGENTS.md \u2014 add project-specific rules");
   console.log("  2. Add spec files to .agents/spec/ for detailed documentation");
-  console.log("  3. AI agents will read AGENTS.md and write to .agents/ automatically");
+  console.log("  3. Agent will read rules and write to .agents/MEMORY.md automatically");
   console.log("");
-  rl.close();
 }
 function runDoctor() {
   const cwd = process.cwd();
@@ -278,7 +231,6 @@ switch (command) {
   case "init":
     runInit().catch((err) => {
       console.error("Error:", err.message);
-      rl.close();
       process.exit(1);
     });
     break;
@@ -293,7 +245,6 @@ switch (command) {
   case void 0:
     runInit().catch((err) => {
       console.error("Error:", err.message);
-      rl.close();
       process.exit(1);
     });
     break;

package/dist/index.js

@@ -49,13 +49,6 @@ function scaffold(projectDir, options = {}) {
       mkdirSync(dir, { recursive: true });
     }
   }
-  writeFileIfNeeded(
-    join(projectDir, AGENTS_MD),
-    applyVars(readTemplate("AGENTS.md"), vars),
-    AGENTS_MD,
-    result,
-    force
-  );
   const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
     { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
@@ -76,6 +69,13 @@ function scaffold(projectDir, options = {}) {
     writeFileSync(specKeep, "");
     result.created.push(`${SPEC_DIR}/.gitkeep`);
   }
+  writeFileIfNeeded(
+    join(projectDir, AGENTS_MD),
+    applyVars(readTemplate("AGENTS.md"), vars),
+    AGENTS_MD,
+    result,
+    force
+  );
   return result;
 }
 function writeFileIfNeeded(targetPath, content, displayName, result, force) {
@@ -207,7 +207,7 @@ import { join as join4 } from "path";
 function doctor(projectDir) {
   const issues = [];
   const required = [
-    { file: AGENTS_MD, desc: "Root agent instructions" },
+    { file: AGENTS_MD, desc: "Root router file" },
     { file: MEMORY_FILE, desc: "Long-term memory" },
     { file: TASKS_FILE, desc: "Working memory" }
   ];
@@ -236,7 +236,7 @@ function doctor(projectDir) {
       issues.push({
         level: "warning",
         file: AGENTS_MD,
-        message: "Over 150 lines \u2014 consider keeping it concise"
+        message: "Over 150 lines \u2014 consider keeping it concise as a router"
       });
     }
   }

package/docs/ARCHITECTURE.md

@@ -168,28 +168,21 @@ This document proposes a generalizable architecture for AI memory across codebas
 
 ---
 
-## IDE Integration Points
+## Integration Points
 
-### OpenCode
-- Reads: AGENTS.md (via plugin hook)
-- Plugin auto-injects: `.agents/MEMORY.md` context on session start
-- Plugin reminds: Update TASKS.md on session idle
-- Writes: Agent appends to MEMORY.md/TASKS.md/spec/
+By default, we scaffold `AGENTS.md` which acts as the root router for your AI coding assistant. This file contains rules and documentation maps that point to the `.agents/` folder.
 
-### GitHub Copilot (VSCode)
-- Reads: `.github/copilot-instructions.md` (GitHub convention)
-- copilot-instructions.md = same router format as AGENTS.md
-- Points to `.agents/MEMORY.md` + spec files
-- Writes: User includes `@save memory: <decision>` in chat → agent appends
+If your specific AI tool requires a different file name, you can simply symlink the `AGENTS.md` file:
 
-### Cursor / Windsurf
-- Reads: `.cursorrules` / `.windsurfrules` (IDE convention)
-- Same router format, points to `.agents/`
-- Writes: Agent rules instruct direct append
+```bash
+# Example: For Cursor
+ln -s AGENTS.md .cursorrules
 
-### CLI / Non-IDE Workflows
-- Humans can read/edit `.agents/` files directly
-- No special IDE integration needed
+# Example: For GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
+
+This ensures a single source of truth (`AGENTS.md`) is maintained while providing backward compatibility with any tool.
 
 ---
 
@@ -219,12 +212,12 @@ This document proposes a generalizable architecture for AI memory across codebas
    - Keep `.memsearch/memory/` as archive (1 year retention)
    - Delete milvus.db
 
-### From .github/copilot-instructions.md (monolithic)
+### From Monolithic Config Files (e.g. .cursorrules)
 
 1. **Extract decisions** → `.agents/MEMORY.md`
 2. **Extract patterns** → `.agents/spec/patterns.md`
 3. **Extract commands** → `AGENTS.md`
-4. **Keep router** → update `.github/copilot-instructions.md` to point to `.agents/`
+4. **Keep router** → Create symlink from your old config file to `AGENTS.md`
 
 ---
 
@@ -254,10 +247,8 @@ This document proposes a generalizable architecture for AI memory across codebas
 ## Tooling Support
 
 ### 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 init` — scaffold structure (`AGENTS.md` + `.agents/`)
+- ✓ `npx @vuau/agent-memory init --force` — overwrite existing files
 - ✓ `npx @vuau/agent-memory doctor` — validate structure
 - Planned: ✗ `report` — generate memory stats, archival suggestions
 

package/docs/ARCHITECTURE.vi.md

@@ -168,27 +168,21 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
 
 ---
 
-## IDE Integration Points
+## Điểm Tích Hợp
 
-### OpenCode
-- Reads: `AGENTS.md` (native)
-- Agents follow rules trong AGENTS.md
-- Writes: Agent appends đến MEMORY.md/TASKS.md/spec/
+Mặc định, chúng tôi scaffold `AGENTS.md` hoạt động như root router cho AI coding assistant của bạn. File này chứa các rules và documentation maps trỏ đến thư mục `.agents/`.
 
-### 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: Agent follows rules → appends khi appropriate
+Nếu công cụ AI cụ thể của bạn yêu cầu một tên file khác, bạn có thể dễ dàng dùng symlink file `AGENTS.md`:
 
-### Cursor / Windsurf
-- Reads: `.cursorrules` / `.windsurfrules` (IDE convention)
-- Cùng router format, points đến `.agents/`
-- Writes: Agent rules instruct direct append
+```bash
+# Ví dụ: Cho Cursor
+ln -s AGENTS.md .cursorrules
 
-### CLI / Non-IDE Workflows
-- Humans có thể read/edit `.agents/` files trực tiếp
-- Không cần special IDE integration
+# Ví dụ: Cho GitHub Copilot
+mkdir -p .github && ln -s ../AGENTS.md .github/copilot-instructions.md
+```
+
+Điều này đảm bảo single source of truth (`AGENTS.md`) được duy trì trong khi cung cấp khả năng tương thích ngược với mọi công cụ.
 
 ---
 
@@ -218,12 +212,12 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
    - Keep `.memsearch/memory/` như archive (1 year retention)
    - Delete milvus.db
 
-### Từ .github/copilot-instructions.md (monolithic)
+### Từ Monolithic Config Files (vd: .cursorrules)
 
 1. **Extract decisions** → `.agents/MEMORY.md`
 2. **Extract patterns** → `.agents/spec/patterns.md`
 3. **Extract commands** → `AGENTS.md`
-4. **Keep router** → update `.github/copilot-instructions.md` để point đến `.agents/`
+4. **Keep router** → Tạo symlink từ config file cũ của bạn trỏ tới `AGENTS.md`
 
 ---
 
@@ -253,10 +247,8 @@ Tài liệu này đề xuất kiến trúc khả năng skalabiliti cho AI memory
 ## Công cụ Support
 
 ### 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 init` — scaffold structure (`AGENTS.md` + `.agents/`)
+- ✓ `npx @vuau/agent-memory init --force` — ghi đè files có sẵn
 - ✓ `npx @vuau/agent-memory doctor` — validate structure
 - Planned: ✗ `report` — generate memory stats, archival suggestions
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vuau/agent-memory",
-  "version": "0.4.0",
-  "description": "Structured AI memory for codebases — works with GitHub Copilot, Cursor, Windsurf, VS Code, OpenCode, and 25+ AI tools",
+  "version": "0.4.1",
+  "description": "Structured AI memory for codebases — scaffolding CLI for OpenCode, Copilot, Cursor, Windsurf",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {