@memfork/cli 0.1.46 → 0.1.48

package/dist/cli.js

@@ -66,6 +66,16 @@ program
     .command("status")
     .description("show current tree, network, branch, and signer")
     .action(wrap(cmdStatus));
+program
+    .command("namespace [branch]")
+    .description("print the MemWal namespace for a branch (use with memwal_recall namespace= arg)")
+    .action(wrap(async (branch) => {
+    const { cfg } = await import("./config.js").then((m) => ({ cfg: m.resolveConfig() }));
+    const { resolveBranch } = await import("./branch.js");
+    const { branchNamespace } = await import("@memfork/core");
+    const b = resolveBranch({ explicit: branch, configDefault: cfg.defaultBranch });
+    console.log(branchNamespace(cfg.treeId, b));
+}));
 program
     .command("log")
     .description("show recent commits on a branch")
@@ -85,6 +95,7 @@ program
     .requiredOption("-m, --message <msg>", "commit message")
     .option("-b, --branch <name>", "branch (default: current git branch)")
     .option("-f, --facts <facts...>", "one or more fact strings")
+    .option("--tool <tool>", "tool that wrote this commit: codex | cursor | sdk")
     .option("--from-response <text>", "extract facts from a full response text")
     .option("--auto-extract", "use LLM to extract durable facts (requires --from-response)")
     .option("--file <path>", "attach a file as a Walrus artifact (repeatable). Requires artifacts.enabled = true in config.", (v, acc) => [...acc, v], [])

package/dist/commands/ops.d.ts

@@ -16,6 +16,7 @@ export declare function cmdCommit(opts: {
     branch?: string;
     message: string;
     facts?: string[];
+    tool?: string;
     fromResponse?: string;
     autoExtract?: boolean;
     /**

package/dist/commands/ops.js

@@ -155,6 +155,7 @@ export async function cmdCommit(opts) {
     const { blobId, artifacts: refs } = await client.commit(branch, {
         facts,
         message: opts.message,
+        ...(opts.tool ? { tool: opts.tool } : {}),
         ...(artifacts.length > 0 ? { artifacts } : {}),
     });
     const out = { blobId, branch, artifacts: refs };

package/dist/commands/ui-server.js

@@ -242,6 +242,19 @@ async function handleApiHistory(res, url) {
                     message: facts?.length ? facts[0] : `commit ${entry.blob_id.slice(0, 8)}`,
                     delta: payload["delta"] ?? {},
                     ...(artifacts?.length ? { artifacts } : {}),
+                    // author is stored as base64-encoded bytes; decode to 0x-prefixed hex address.
+                    ...(payload["author"] ? {
+                        author: (() => {
+                            try {
+                                const hex = Buffer.from(String(payload["author"]), "base64").toString("hex");
+                                return `0x${hex}`;
+                            }
+                            catch {
+                                return undefined;
+                            }
+                        })(),
+                    } : {}),
+                    ...(payload["tool"] ? { tool: payload["tool"] } : {}),
                 }];
         });
         commits.sort((a, b) => a.ts_ms - b.ts_ms);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memfork/cli",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "description": "MemForks CLI — init, commit, recall, merge, install plugins",
   "repository": {
     "type": "git",

package/plugins/codex/plugins/memforks/README.md

@@ -54,7 +54,8 @@ memfork doctor
 | `memfork merge <src> <dst>` | Propose a cross-branch memory merge |
 | `memfork status / log / proposals` | Inspect the on-chain DAG |
 
-Memory is namespaced by Git branch — `namespace="branch/<branch-name>"`.
+Memory is namespaced by Git branch in the form `memforks/<treeId>/<branch>`.
+Run `memfork namespace` to get the exact string for the current branch.
 
 ## What gets installed
 

package/plugins/codex/plugins/memforks/skills/memory-recall/SKILL.md

@@ -12,24 +12,38 @@ Do not run `memfork recall` from the shell; the MCP tool is faster and context-a
 
 ## Usage
 
+MemWal namespaces are scoped to the tree in the form `memforks/<treeId>/<branch>`.
+Get the correct namespace first:
+
+```bash
+memfork namespace                  # current branch
+memfork namespace feat/auth        # specific branch
+```
+
+Then recall:
+
 ```
 memwal_recall(
   query="<natural language — what you want to find>",
-  namespace="branch/<current-git-branch>",
+  namespace="memforks/<treeId>/<current-git-branch>",
   limit=5
 )
 ```
 
+If you cannot run `memfork namespace`, omit `namespace` entirely — MemWal will search
+the full account across all branches.
+
 Examples:
 ```
-memwal_recall(query="auth system design", namespace="branch/main")
-memwal_recall(query="database schema decisions", namespace="branch/feature/payments")
+memwal_recall(query="auth system design", namespace="memforks/<treeId>/main")
+memwal_recall(query="database schema decisions", namespace="memforks/<treeId>/feature/payments")
 memwal_recall(query="what do we know about the API rate limits?", limit=10)
 ```
 
 ## Rules
 
 - Always scope to the current Git branch namespace unless the user asks for cross-branch context.
+  Use `memfork namespace` to get the exact string; never guess `branch/<name>`.
 - High relevance scores = verified prior context.
 - If recall returns nothing, tell the user memory is empty for this branch and offer to start capturing.
 - Never fabricate facts — only use what `memwal_recall` returns.

package/plugins/cursor/rules/memforks.mdc

@@ -21,11 +21,20 @@ have been discussed before, call the MCP tool:
 memwal_recall(query="<natural language query>", limit=5)
 ```
 
-Use the namespace matching the current Git branch:
+Use the namespace matching the current Git branch. Get the exact value from the CLI first:
 
+```bash
+memfork namespace              # prints: memforks/<treeId>/<current-branch>
+memfork namespace feat/auth    # prints namespace for a specific branch
 ```
-memwal_recall(query="auth system design decisions", namespace="branch/<current-branch>")
+
+Then pass it to the MCP tool:
+
 ```
+memwal_recall(query="auth system design decisions", namespace="memforks/<treeId>/feat/auth")
+```
+
+If you cannot run the CLI, omit `namespace` — MemWal will search the full account across all branches.
 
 Results with high relevance scores are verified context from prior sessions.
 
@@ -111,7 +120,9 @@ human governance act.
 ## Branch awareness
 
 - The `memfork` CLI auto-detects the current Git branch; pass `--branch` only to override it.
-- The `memwal_*` MCP tools have no Git context, so pass `namespace="branch/<current-branch>"` explicitly.
+- The `memwal_*` MCP tools have no Git context. MemWal namespaces are in the form
+  `memforks/<treeId>/<branch>` — get the exact value with `memfork namespace <branch>`,
+  then pass it as `namespace=` to recall. Without it, omit namespace to search all branches.
 - When the user switches branches, recall from the new branch namespace.
 - Use `memfork status` to see the current branch, on-chain tree state, and open merge proposals.