@vuau/agent-memory 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/dist/bin/cli.js +2 -0
  2. package/dist/index.js +3 -0
  3. package/package.json +1 -1
  4. package/templates/AGENTS.md +4 -3
  5. package/templates/MEMORY-DETAIL.md +16 -0
  6. package/templates/copilot-instructions.md +4 -3
  7. package/templates/cursorrules.md +4 -3
  8. package/templates/windsurfrules.md +4 -3
package/dist/bin/cli.js CHANGED
@@ -14,6 +14,7 @@ import { fileURLToPath } from "url";
14
14
  var AGENTS_DIR = ".agents";
15
15
  var SPEC_DIR = ".agents/spec";
16
16
  var MEMORY_FILE = ".agents/MEMORY.md";
17
+ var MEMORY_DETAIL_FILE = ".agents/MEMORY-DETAIL.md";
17
18
  var TASKS_FILE = ".agents/TASKS.md";
18
19
  var AGENTS_MD = "AGENTS.md";
19
20
  var COPILOT_INSTRUCTIONS = ".github/copilot-instructions.md";
@@ -68,6 +69,7 @@ function scaffold(projectDir, options = {}) {
68
69
  }
69
70
  const coreFiles = [
70
71
  { target: MEMORY_FILE, template: "MEMORY.md" },
72
+ { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
71
73
  { target: TASKS_FILE, template: "TASKS.md" }
72
74
  ];
73
75
  for (const { target, template } of coreFiles) {
package/dist/index.js CHANGED
@@ -7,6 +7,7 @@ import { fileURLToPath } from "url";
7
7
  var AGENTS_DIR = ".agents";
8
8
  var SPEC_DIR = ".agents/spec";
9
9
  var MEMORY_FILE = ".agents/MEMORY.md";
10
+ var MEMORY_DETAIL_FILE = ".agents/MEMORY-DETAIL.md";
10
11
  var TASKS_FILE = ".agents/TASKS.md";
11
12
  var AGENTS_MD = "AGENTS.md";
12
13
  var COPILOT_INSTRUCTIONS = ".github/copilot-instructions.md";
@@ -61,6 +62,7 @@ function scaffold(projectDir, options = {}) {
61
62
  }
62
63
  const coreFiles = [
63
64
  { target: MEMORY_FILE, template: "MEMORY.md" },
65
+ { target: MEMORY_DETAIL_FILE, template: "MEMORY-DETAIL.md" },
64
66
  { target: TASKS_FILE, template: "TASKS.md" }
65
67
  ];
66
68
  for (const { target, template } of coreFiles) {
@@ -351,6 +353,7 @@ export {
351
353
  AGENTS_MD,
352
354
  COPILOT_INSTRUCTIONS,
353
355
  CURSOR_RULES,
356
+ MEMORY_DETAIL_FILE,
354
357
  MEMORY_FILE,
355
358
  SPEC_DIR,
356
359
  TASKS_FILE,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vuau/agent-memory",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "Structured AI memory for codebases — scaffolding CLI for OpenCode, Copilot, Cursor, Windsurf",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
package/templates/AGENTS.md CHANGED
@@ -12,7 +12,8 @@ Router file for AI agents. Keep under 150 lines.
12
12
 
13
13
  | Task | Spec File |
14
14
  |------|-----------|
15
- | Past decisions & patterns | `.agents/MEMORY.md` |
15
+ | Past decisions (1-line) | `.agents/MEMORY.md` |
16
+ | Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
16
17
  | Current work in progress | `.agents/TASKS.md` |
17
18
 
18
19
  > 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.
26
27
 
27
28
  ### MEMORY.md entry format
28
29
  ```
29
- - YYYY-MM-DD: <1-line decision or pattern>
30
+ - YYYY-MM-DD: <1-line decision or pattern> → detail
30
31
  ```
31
- Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
32
+ Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
32
33
 
33
34
  ### TASKS.md update
34
35
  Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.
package/templates/MEMORY-DETAIL.md ADDED
@@ -0,0 +1,16 @@
1
+ # Memory Detail
2
+
3
+ Full Problem/Solution context for entries in MEMORY.md. Read on-demand when needing to understand *why* a decision was made.
4
+
5
+ ---
6
+
7
+ ## Example Category
8
+
9
+ ### Example decision title
10
+ - **Date**: YYYY-MM-DD
11
+ - **Problem**: What issue or question prompted this decision
12
+ - **Solution**: What was decided and why
13
+
14
+ ---
15
+
16
+ <!-- Add new detailed entries below. Use the format above. -->
package/templates/copilot-instructions.md CHANGED
@@ -12,7 +12,8 @@ Router file for GitHub Copilot. Points to shared agent documentation.
12
12
 
13
13
  | Task | Spec File |
14
14
  |------|-----------|
15
- | Past decisions & patterns | `.agents/MEMORY.md` |
15
+ | Past decisions (1-line) | `.agents/MEMORY.md` |
16
+ | Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
16
17
  | Current work in progress | `.agents/TASKS.md` |
17
18
 
18
19
  > Add your own spec files to `.agents/spec/` and reference them here.
@@ -25,6 +26,6 @@ Router file for GitHub Copilot. Points to shared agent documentation.
25
26
 
26
27
  ## Memory Protocol
27
28
  - When user approves a decision → append 1-line entry to `.agents/MEMORY.md` under appropriate category.
28
- - Format: `- YYYY-MM-DD: <decision>`.
29
- - Read `.agents/MEMORY.md` before implementing; follow spec file pointers for details.
29
+ - Format: `- YYYY-MM-DD: <decision> → detail` (add `→ detail` when full context exists in MEMORY-DETAIL.md).
30
+ - Read `.agents/MEMORY.md` before implementing; follow pointers for details.
30
31
  - Do not create additional memory files.
package/templates/cursorrules.md CHANGED
@@ -12,7 +12,8 @@ Instructions for Cursor AI. Keep under 150 lines.
12
12
 
13
13
  | Task | Location |
14
14
  |------|----------|
15
- | Past decisions & patterns | `.agents/MEMORY.md` |
15
+ | Past decisions (1-line) | `.agents/MEMORY.md` |
16
+ | Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
16
17
  | Current work in progress | `.agents/TASKS.md` |
17
18
  | Detailed specs | `.agents/spec/*.md` |
18
19
 
@@ -25,9 +26,9 @@ Instructions for Cursor AI. Keep under 150 lines.
25
26
 
26
27
  ### MEMORY.md entry format
27
28
  ```
28
- - YYYY-MM-DD: <1-line decision or pattern>
29
+ - YYYY-MM-DD: <1-line decision or pattern> → detail
29
30
  ```
30
- Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
31
+ Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
31
32
 
32
33
  ### TASKS.md update
33
34
  Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.
package/templates/windsurfrules.md CHANGED
@@ -12,7 +12,8 @@ Instructions for Windsurf AI. Keep under 150 lines.
12
12
 
13
13
  | Task | Location |
14
14
  |------|----------|
15
- | Past decisions & patterns | `.agents/MEMORY.md` |
15
+ | Past decisions (1-line) | `.agents/MEMORY.md` |
16
+ | Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
16
17
  | Current work in progress | `.agents/TASKS.md` |
17
18
  | Detailed specs | `.agents/spec/*.md` |
18
19
 
@@ -25,9 +26,9 @@ Instructions for Windsurf AI. Keep under 150 lines.
25
26
 
26
27
  ### MEMORY.md entry format
27
28
  ```
28
- - YYYY-MM-DD: <1-line decision or pattern>
29
+ - YYYY-MM-DD: <1-line decision or pattern> → detail
29
30
  ```
30
- Place under the appropriate category. Add `→ spec file` pointer if details belong in a spec.
31
+ Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
31
32
 
32
33
  ### TASKS.md update
33
34
  Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.