@memfork/cli 0.1.64 → 0.1.65

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@memfork/cli",
3
- "version": "0.1.64",
3
+ "version": "0.1.65",
4
4
  "description": "MemForks CLI — init, commit, recall, merge, install plugins",
5
5
  "repository": {
6
6
  "type": "git",
@@ -21,20 +21,32 @@ have been discussed before, call the MCP tool:
21
21
  memwal_recall(query="<natural language query>", limit=5)
22
22
  ```
23
23
 
24
- Use the namespace matching the current Git branch. Get the exact value from the CLI first:
24
+ ### Ancestor-fallback protocol (always follow this order)
25
25
 
26
- ```bash
27
- memfork namespace # prints: memforks/<treeId>/<current-branch>
28
- memfork namespace feat/auth # prints namespace for a specific branch
29
- ```
26
+ MemForks branches inherit memory from their parent. When the current branch has no
27
+ matching memories, walk up to `main` before concluding nothing exists.
30
28
 
31
- Then pass it to the MCP tool:
29
+ **Step 1 recall on the current branch:**
30
+ ```
31
+ memwal_recall(query="...", namespace="memforks/<treeId>/<current-branch>", limit=5)
32
+ ```
32
33
 
34
+ **Step 2 — if step 1 returns no results, recall on `main`:**
33
35
  ```
34
- memwal_recall(query="auth system design decisions", namespace="memforks/<treeId>/feat/auth")
36
+ memwal_recall(query="...", namespace="memforks/<treeId>/main", limit=5)
35
37
  ```
36
38
 
37
- If you cannot run the CLI, omit `namespace` MemWal will search the full account across all branches.
39
+ **Step 3 if step 2 returns results, cite the inheritance explicitly:**
40
+ > "I found this in `main`'s memory (originally established on `feat/auth`, inherited here):"
41
+
42
+ **Never skip to step 2 without trying step 1 first.**
43
+ **Never answer from model knowledge if step 2 also returns nothing — say so instead.**
44
+
45
+ Get namespace values from the CLI:
46
+ ```bash
47
+ memfork namespace # current branch
48
+ memfork namespace main # main branch
49
+ ```
38
50
 
39
51
  Results with high relevance scores are verified context from prior sessions.
40
52