@memfork/cli 0.1.48 → 0.1.50

package/dist/branch.d.ts

@@ -28,6 +28,26 @@
  * than writing memory into a bogus namespace literally named "HEAD".
  */
 export declare function gitBranch(cwd?: string): string | undefined;
+/**
+ * Read `git config user.name`, or undefined when unset / not in a repo.
+ * Used as the automatic default display name for commit authorship.
+ */
+export declare function gitUserName(cwd?: string): string | undefined;
+/**
+ * Resolve the display name to attribute a commit to.
+ *
+ * Precedence (highest wins):
+ *   1. explicit       — the `--author` flag
+ *   2. MEMFORK_AUTHOR — env override
+ *   3. configAuthor   — `author` from .memfork/config.json (persistent persona)
+ *   4. git config user.name
+ *   5. undefined      — caller falls back to the on-chain signer address
+ */
+export declare function resolveAuthor(opts?: {
+    explicit?: string;
+    configAuthor?: string;
+    cwd?: string;
+}): string | undefined;
 export interface BranchSources {
     /** --branch / --from flag (highest priority). */
     explicit?: string;

package/dist/branch.js

@@ -44,6 +44,43 @@ export function gitBranch(cwd = process.cwd()) {
         return undefined;
     }
 }
+/**
+ * Read `git config user.name`, or undefined when unset / not in a repo.
+ * Used as the automatic default display name for commit authorship.
+ */
+export function gitUserName(cwd = process.cwd()) {
+    try {
+        const out = execSync("git config user.name", {
+            encoding: "utf8",
+            cwd,
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        return out || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve the display name to attribute a commit to.
+ *
+ * Precedence (highest wins):
+ *   1. explicit       — the `--author` flag
+ *   2. MEMFORK_AUTHOR — env override
+ *   3. configAuthor   — `author` from .memfork/config.json (persistent persona)
+ *   4. git config user.name
+ *   5. undefined      — caller falls back to the on-chain signer address
+ */
+export function resolveAuthor(opts = {}) {
+    const clean = (s) => {
+        const t = s?.trim();
+        return t ? t : undefined;
+    };
+    return (clean(opts.explicit) ??
+        clean(process.env["MEMFORK_AUTHOR"]) ??
+        clean(opts.configAuthor) ??
+        clean(gitUserName(opts.cwd)));
+}
 /**
  * Pure precedence resolver — no I/O. Exposed separately so the precedence
  * rules can be unit-tested exhaustively without a git repo or env mutation.

package/dist/cli.js

@@ -96,6 +96,7 @@ program
     .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("--author <name>", "display name for the author (default: git user.name)")
     .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

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

package/dist/commands/ops.js

@@ -7,7 +7,7 @@ import fs from "node:fs";
 import path from "node:path";
 import chalk from "chalk";
 import { resolveConfig, toClientConfig, readProjectConfig, writeProjectConfig, MEMWAL_CONSTANTS, } from "../config.js";
-import { resolveBranch } from "../branch.js";
+import { resolveBranch, resolveAuthor } from "../branch.js";
 import { MemForksClient } from "@memfork/core";
 // ─── Shared helpers ───────────────────────────────────────────────────────────
 async function getClient() {
@@ -116,6 +116,7 @@ export async function cmdRecall(query, opts) {
 export async function cmdCommit(opts) {
     const { client, cfg } = await getClient();
     const branch = resolveBranch({ explicit: opts.branch, configDefault: cfg.defaultBranch });
+    const authorName = resolveAuthor({ explicit: opts.author, configAuthor: cfg.author });
     let facts = opts.facts ?? [];
     // --from-response + --auto-extract: stub for LLM extraction
     // In production this calls the configured LLM to distil durable facts.
@@ -152,10 +153,11 @@ export async function cmdCommit(opts) {
             });
         }
     }
-    const { blobId, artifacts: refs } = await client.commit(branch, {
+    const { blobId, artifacts: refs = [] } = await client.commit(branch, {
         facts,
         message: opts.message,
         ...(opts.tool ? { tool: opts.tool } : {}),
+        ...(authorName ? { authorName } : {}),
         ...(artifacts.length > 0 ? { artifacts } : {}),
     });
     const out = { blobId, branch, artifacts: refs };

package/dist/commands/ui-server.js

@@ -242,18 +242,21 @@ 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: (() => {
+                    // Prefer the human display name; fall back to the signer address (stored
+                    // as base64-encoded bytes → 0x-prefixed hex).
+                    author: (() => {
+                        if (payload["author_name"])
+                            return String(payload["author_name"]);
+                        if (payload["author"]) {
                             try {
-                                const hex = Buffer.from(String(payload["author"]), "base64").toString("hex");
-                                return `0x${hex}`;
+                                return `0x${Buffer.from(String(payload["author"]), "base64").toString("hex")}`;
                             }
                             catch {
                                 return undefined;
                             }
-                        })(),
-                    } : {}),
+                        }
+                        return undefined;
+                    })(),
                     ...(payload["tool"] ? { tool: payload["tool"] } : {}),
                 }];
         });

package/dist/config.d.ts

@@ -43,6 +43,8 @@ export interface ProjectConfig {
     network?: 'testnet' | 'mainnet' | 'devnet' | 'localnet';
     /** Default branch name. Default: "main". */
     defaultBranch?: string;
+    /** Display name attributed to commits (e.g. "Dev A"). Falls back to git user / signer. */
+    author?: string;
     /** Override Sui RPC URL. */
     rpcUrl?: string;
     /** Override package ID (post-upgrade). */
@@ -88,6 +90,8 @@ export interface ResolvedConfig {
     memwalRelayer: string;
     network: 'testnet' | 'mainnet' | 'devnet' | 'localnet';
     defaultBranch: string;
+    /** Display name attributed to commits. Undefined when no override is set. */
+    author?: string;
     rpcUrl?: string;
     packageId?: string;
     sponsorUrl?: string;

package/dist/config.js

@@ -188,6 +188,7 @@ export function resolveConfig(opts = {}) {
             defaultRelayer(network),
         network,
         defaultBranch: project?.defaultBranch ?? 'main',
+        author: env['MEMFORK_AUTHOR'] ?? project?.author,
         rpcUrl: env['MEMFORK_RPC_URL'] ?? project?.rpcUrl,
         packageId: env['MEMFORK_PACKAGE_ID'] ?? project?.packageId,
         sponsorUrl: env['MEMFORK_SPONSOR_URL'] ??

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memfork/cli",
-  "version": "0.1.48",
+  "version": "0.1.50",
   "description": "MemForks CLI — init, commit, recall, merge, install plugins",
   "repository": {
     "type": "git",
@@ -35,7 +35,7 @@
   ],
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
-    "@memfork/core": "^0.1.11",
+    "@memfork/core": "^0.1.14",
     "chalk": "^5.6.2",
     "commander": "^15.0.0"
   },