@memfork/cli 0.1.22 → 0.1.24

package/dist/commands/init.js

@@ -79,11 +79,15 @@ async function cmdInitQuick() {
             network,
             existingKey: existingKey || undefined,
         });
-        // Persist
+        // Persist — include sponsor URL on mainnet so all subsequent commands
+        // (branch, commit, merge) use sponsored gas automatically.
+        const sponsorBase = (process.env.MEMFORK_SPONSOR_URL ?? "https://memforks-sponsor-production.up.railway.app")
+            .replace(/\/sponsor\/?$/, "");
         writeProjectConfig({
             treeId: result.treeId,
             network: result.network,
             defaultBranch: "main",
+            ...(result.network === "mainnet" ? { sponsorUrl: `${sponsorBase}/sponsor` } : {}),
         });
         upsertCredential(result.treeId, {
             privateKey: result.privateKey,

package/dist/commands/ops.js

@@ -14,6 +14,26 @@ async function getClient() {
     const client = await MemForksClient.connect(toClientConfig(cfg));
     return { client, cfg };
 }
+function isTransientSuiError(e) {
+    const msg = String(e);
+    return (msg.includes("needs to be rebuilt") ||
+        msg.includes("unavailable for consumption") ||
+        msg.includes("object version"));
+}
+async function withRetry(fn, retries = 2, delayMs = 1500) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (e) {
+            if (isTransientSuiError(e) && attempt < retries) {
+                await new Promise((r) => setTimeout(r, delayMs));
+                continue;
+            }
+            throw e;
+        }
+    }
+}
 function currentGitBranch() {
     try {
         return execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf8" }).trim();
@@ -112,7 +132,7 @@ export async function cmdCommit(opts) {
         console.error(chalk.red("No facts to commit. Pass --facts or --from-response."));
         process.exit(1);
     }
-    const { blobId } = await client.commit(branch, { facts, message: opts.message });
+    const { blobId } = await withRetry(() => client.commit(branch, { facts, message: opts.message }));
     const out = { blobId, branch };
     if (process.stdout.isTTY) {
         console.log("");
@@ -138,7 +158,7 @@ export async function cmdMerge(from, into, opts) {
     process.stdout.write(chalk.dim(`Merging ${chalk.green(from)} → ${chalk.green(into)}`) +
         chalk.dim(governed ? "  (governed — awaiting resolver…)" : "  (LWW — self-finalizing…)") +
         "  ");
-    const { digest, mergedCount, blobId, proposalId } = await client.merge(from, into);
+    const { digest, mergedCount, blobId, proposalId } = await withRetry(() => client.merge(from, into));
     console.log(chalk.green("done"));
     console.log("");
     console.log(chalk.dim(`  facts merged: ${mergedCount}`));
@@ -574,7 +594,7 @@ export async function cmdBranch(name, opts = {}) {
     const { client, cfg } = await getClient();
     const from = opts.from ?? cfg.defaultBranch ?? currentGitBranch();
     process.stdout.write(chalk.dim(`Creating branch ${chalk.green(name)} from ${chalk.green(from)} …  `));
-    const digest = await client.branch(name, { from });
+    const digest = await withRetry(() => client.branch(name, { from }));
     console.log(chalk.green("done"));
     console.log("");
     console.log(chalk.dim(`  tx: ${digest}`));

package/dist/config.d.ts

@@ -47,6 +47,8 @@ export interface ProjectConfig {
     rpcUrl?: string;
     /** Override package ID (post-upgrade). */
     packageId?: string;
+    /** Gas sponsor URL. When set, all on-chain txs are sponsored (no SUI balance needed). */
+    sponsorUrl?: string;
 }
 export interface TreeCredential {
     /** Ed25519 private key in bech32 suiprivkey1… format. */

package/dist/config.js

@@ -180,7 +180,7 @@ export function resolveConfig(opts = {}) {
         rpcUrl: env['MEMFORK_RPC_URL'] ?? project?.rpcUrl,
         packageId: env['MEMFORK_PACKAGE_ID'] ?? project?.packageId,
         sponsorUrl: env['MEMFORK_SPONSOR_URL'] ??
-            project?.['sponsorUrl'],
+            project?.sponsorUrl,
     };
 }
 /**

package/package.json

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

package/plugins/codex/README.md

@@ -11,27 +11,25 @@ cryptographically anchored to Sui with branch context and a full commit DAG.
 ## Setup (one time, per machine)
 
 ```bash
+# 1. Install the MemForks CLI
 npm install -g @memfork/cli
 
-# Recommended — zero copy-paste, ~30 seconds on testnet:
+# 2. Initialise your on-chain tree (provisions a Sui key + MemWal account)
 memfork init --quick
-
-# Or manual if you already have a Sui key + MemWal account:
-memfork init
 ```
 
-## Install the plugin
+## Install the plugin in Codex
 
 ```bash
 memfork install codex
 ```
 
-This does two things:
+This reads the credentials provisioned by `memfork init` and does two things:
 
-1. **Writes `~/.codex/config.toml`** — adds a `[mcp_servers.memwal]` entry using
-   the delegate key provisioned by `memfork init`. No browser login needed.
+1. **Writes `~/.codex/config.toml`** — adds `[mcp_servers.memwal]` using the delegate key
+   already on disk. No browser login, no extra auth step.
 
-2. **Copies `.codex-plugin/`** — installs the plugin skills into the current project.
+2. **Copies the plugin skills** into `.codex-plugin/` in the current project.
 
 Then register with Codex:
 
@@ -61,21 +59,35 @@ Memory is namespaced by Git branch — `namespace="branch/<branch-name>"`.
 ## What gets installed
 
 ```
-~/.codex/config.toml       ← MemWal MCP server entry (auto-configured)
+~/.codex/config.toml       ← [mcp_servers.memwal] entry (HTTP relayer + delegate key)
 .codex-plugin/
   plugin.json              ← plugin metadata
   skills/
     memory-recall/         ← when/how to use memwal_recall
     memforks-status/       ← when/how to use memfork commit/merge/status
+    memory-fork/           ← multi-hypothesis branch forking
 ```
 
-No shell hooks. The MCP server is the transport.
+MCP credentials come from `~/.memfork/credentials.json` (written by `memfork init`).
+No separate browser login. No bearer tokens to copy-paste.
+
+## Architecture
+
+```
+Codex agent
+  │
+  ├── memwal_recall / memwal_remember  →  @mysten-incubation/memwal-mcp
+  │                                         (Walrus-backed encrypted memory)
+  │
+  └── memfork commit / merge / branch  →  @memfork/cli
+                                            (on-chain version control on Sui)
+```
 
 ## Override for CI / headless use
 
 ```bash
 MEMFORK_TREE_ID=0x…
 MEMFORK_PRIVATE_KEY=suiprivkey1…
-MEMFORK_MEMWAL_ACCOUNT=0x…
-MEMFORK_MEMWAL_KEY=<hex>
+MEMWAL_ACCOUNT_ID=0x…
+MEMWAL_API_TOKEN=<token>
 ```