@heyanon-arp/cli 0.0.25 → 0.0.27

package/dist/cli.js

@@ -322,6 +322,9 @@ var init_api = __esm({
       async getReputation(did) {
         return this.get(`/v1/agents/${encodeURIComponent(did)}/reputation`);
       }
+      async getStats(did) {
+        return this.get(`/v1/agents/${encodeURIComponent(did)}/stats`);
+      }
       /**
        * Public `GET /v1/discovery/search`. Reputation-ranked agent search
        * with creator / liveness / accepted-asset filters. No auth.
@@ -733,7 +736,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "@heyanon-arp/cli",
-  version: "0.0.25",
+  version: "0.0.27",
   description: "Command-line client for the Agent Relationship Protocol \u2014 register agents, sign envelopes, run escrowed work cycles on Solana.",
   license: "MIT",
   keywords: ["arp", "agent-relationship-protocol", "did", "solana", "escrow", "ed25519", "agents", "a2a", "cli"],
@@ -4722,8 +4725,8 @@ function formatEscrowConfigStatus(serverUrl, s) {
     lines.push("");
     lines.push(import_chalk14.default.dim(`  New locks will snapshot fee_bps=0 \u2014 payee receives 100% on claim.`));
   } else {
-    const pct = (s.feeBps / 100).toFixed(2);
-    lines.push(`  ${import_chalk14.default.yellow("ENABLED")} \u2014 ${pct}% of payee slice (${s.feeBps} bps)`);
+    const pct2 = (s.feeBps / 100).toFixed(2);
+    lines.push(`  ${import_chalk14.default.yellow("ENABLED")} \u2014 ${pct2}% of payee slice (${s.feeBps} bps)`);
     lines.push(`  ${import_chalk14.default.dim("fee_recipient:")} ${s.feeRecipient}`);
     lines.push("");
     lines.push(import_chalk14.default.dim(`  New locks will snapshot fee_bps=${s.feeBps} onto themselves.`));
@@ -7400,9 +7403,258 @@ function bar(score) {
   return `${"\u2588".repeat(filled)}${"\u2591".repeat(10 - filled)}`;
 }
 
+// src/commands/selftest.ts
+var import_node_fs10 = require("fs");
+var import_node_os2 = require("os");
+var import_node_path7 = require("path");
+var import_web33 = require("@solana/web3.js");
+var import_chalk31 = __toESM(require("chalk"));
+init_api();
+var LIVENESS_THRESHOLD_SECONDS = 15 * 60;
+var DEFAULT_MIN_SOL = { worker: 1, both: 1, buyer: 1 };
+function registerSelftestCommand(root) {
+  root.command("selftest").description(
+    "Self-check: is THIS agent set up + operational (shield, login, registration, funding, skills, worker monitor)? No DID arg. Exit 1 only on a definite failure."
+  ).option("--role <role>", "buyer | worker | both \u2014 scopes role-specific checks (default: inferred from installed skills, else both)").option("--skills-dir <path>", "Extra directory to search for the arp-*-flow skill files (in addition to $ARP_SKILLS_DIR and known framework dirs)").option("--min-sol <n>", "Minimum settlement balance in SOL to pass the funding check (default: 1.0)").option("--stall-min <n>", "Worker heartbeat freshness window in minutes; the file must be newer than 2\xD7 this (default: 5)", "5").option("--rpc-url <url>", "Solana RPC for the funding check (default: --rpc-url > ARP_ESCROW_RPC_URL > config rpcUrl > built-in)").option("--server <url>", "Override ARP server base URL").option("--json", "Machine-readable: single JSON object on stdout. Pipe-safe.", false).action(async (opts) => {
+    await runSelftest(opts);
+  });
+}
+async function runSelftest(opts) {
+  const result = await selftest(opts);
+  if (opts.json) {
+    console.log(JSON.stringify(result));
+  } else {
+    console.log(formatSelftestReport(result));
+  }
+  if (!result.ok) process.exitCode = 1;
+}
+async function selftest(opts, deps = {}) {
+  const api = deps.api ?? new ArpApiClient(opts.server);
+  const server = api.serverUrl;
+  const skillDirs = skillSearchDirs(opts.skillsDir);
+  const role = resolveRole(opts.role, skillDirs);
+  const checks = [];
+  checks.push(checkOpengrep());
+  checks.push(await checkLogin(api));
+  checks.push(checkSkills(skillDirs, role));
+  const agents = deps.agents ?? listAgents().filter((r) => r.serverUrl === server).map((r) => r.agent);
+  if (agents.length === 0) {
+    checks.push({ id: "registration", status: "fail", detail: `no local agent registered for ${server}`, fix: "heyarp register (or heyarp recover --from-keys)" });
+  } else {
+    for (const agent of agents) {
+      checks.push(await checkRegistration(api, agent));
+      checks.push(await checkFunding(agent, role, opts));
+      if (role === "worker" || role === "both") checks.push(await checkWorkerLiveness(api, agent, opts));
+    }
+  }
+  const ok = !checks.some((c) => c.status === "fail");
+  return { server, role, ok, checks };
+}
+function checkOpengrep() {
+  const heyshieldHome = process.env.HEYSHIELD_HOME && process.env.HEYSHIELD_HOME.length > 0 ? process.env.HEYSHIELD_HOME : (0, import_node_path7.join)((0, import_node_os2.homedir)(), ".heyshield");
+  const bin = (0, import_node_path7.join)(heyshieldHome, "opengrep", "bin", "opengrep");
+  if ((0, import_node_fs10.existsSync)(bin)) return { id: "opengrep", status: "pass", detail: `opengrep present (${bin})` };
+  return { id: "opengrep", status: "warn", detail: `opengrep not found at ${bin} \u2014 L2 code/script scan unavailable (L0/L4 still active)`, fix: "heyshield install-opengrep" };
+}
+async function checkLogin(api) {
+  const cred = readCredential(api.serverUrl);
+  if (!cred) return { id: "login", status: "fail", detail: `not logged in to ${api.serverUrl}`, fix: "heyarp login" };
+  try {
+    await api.accountWhoami(cred.token);
+    return { id: "login", status: "pass", detail: `logged in as ${cred.wallet} (token valid)` };
+  } catch (err) {
+    if (err instanceof ApiError && (err.status === 401 || err.status === 403)) {
+      return {
+        id: "login",
+        status: "fail",
+        detail: `login token for ${api.serverUrl} was rejected (${err.message}) \u2014 revoked/expired`,
+        fix: "heyarp login (then re-register with --from-keys if the agent is also gone)"
+      };
+    }
+    return {
+      id: "login",
+      status: "unknown",
+      detail: `credential present (${cred.wallet}) but token NOT verified \u2014 server unreachable (${msg(err)})`,
+      fix: "re-run online; if a later request is rejected, run `heyarp login`"
+    };
+  }
+}
+async function checkRegistration(api, agent) {
+  try {
+    await api.getDidDocument(agent.did);
+    return { id: "registration", did: agent.did, status: "pass", detail: `${agent.did} registered on ${api.serverUrl}` };
+  } catch (err) {
+    if (err instanceof ApiError && err.status === 404) {
+      return {
+        id: "registration",
+        did: agent.did,
+        status: "fail",
+        detail: `${agent.did} not found on ${api.serverUrl} \u2014 local keys exist but the server doesn't know this DID (server reset?)`,
+        fix: "heyarp login + heyarp register --from-keys <exported-keys>"
+      };
+    }
+    return { id: "registration", did: agent.did, status: "unknown", detail: `${agent.did} present locally; server registration not verified (${msg(err)})` };
+  }
+}
+async function checkFunding(agent, role, opts) {
+  const min = parseMinSol(opts.minSol, role);
+  try {
+    const rpc = resolveRpcUrl({ rpcUrl: opts.rpcUrl });
+    const conn = new import_web33.Connection(rpc, "confirmed");
+    const lamports = await conn.getBalance(new import_web33.PublicKey(agent.settlementPublicKeyB58));
+    const sol = lamports / 1e9;
+    if (sol >= min) return { id: "funding", did: agent.did, status: "pass", detail: `settlement ${agent.settlementPublicKeyB58} has ${sol} SOL (>= ${min})` };
+    const low = role === "buyer" ? "warn" : "fail";
+    return {
+      id: "funding",
+      did: agent.did,
+      status: low,
+      detail: `settlement ${agent.settlementPublicKeyB58} has ${sol} SOL (< ${min} needed)`,
+      fix: "fund the settlement key with SOL (faucet / transfer)"
+    };
+  } catch (err) {
+    return {
+      id: "funding",
+      did: agent.did,
+      status: "unknown",
+      detail: `could not read settlement balance for ${agent.did} (${msg(err)})`,
+      fix: "set a reachable RPC: heyarp config set rpcUrl <url> (or --rpc-url)"
+    };
+  }
+}
+function checkSkills(dirs, role) {
+  const roles = role === "both" ? ["worker", "buyer"] : [role];
+  const missing = [];
+  const foundAt = [];
+  for (const r of roles) {
+    const hit = findSkill(dirs, r);
+    if (hit) foundAt.push(`${r}\u2192${hit}`);
+    else missing.push(r);
+  }
+  if (missing.length === 0) return { id: "skills", status: "pass", detail: `found: ${foundAt.join(", ")}` };
+  return {
+    id: "skills",
+    status: "unknown",
+    detail: `skill(s) not found in known dirs for: ${missing.map((r) => `arp-${r}-flow`).join(", ")} (searched ${dirs.join(", ")})`,
+    fix: "install the skill, or point selftest at it: --skills-dir <path> / export ARP_SKILLS_DIR=<path>"
+  };
+}
+async function checkWorkerLiveness(api, agent, opts) {
+  const stallMin = parsePositive(opts.stallMin, 5);
+  const windowSec = stallMin * 60 * 2;
+  const hbPath = process.env.ARP_WORKER_DISPATCHED && process.env.ARP_WORKER_DISPATCHED.length > 0 ? process.env.ARP_WORKER_DISPATCHED : (0, import_node_path7.join)((0, import_node_os2.homedir)(), ".heyarp-worker", "dispatched.txt");
+  let hbFresh = false;
+  let hbNote = "no local heartbeat file";
+  const hbExists = (0, import_node_fs10.existsSync)(hbPath);
+  if (hbExists) {
+    const ageSec = Math.max(0, Math.floor((Date.now() - (0, import_node_fs10.statSync)(hbPath).mtimeMs) / 1e3));
+    hbFresh = ageSec <= windowSec;
+    hbNote = `heartbeat ${Math.floor(ageSec / 60)}m old`;
+  }
+  let serverSeen = "unknown";
+  let serverNote = "server activity not checked";
+  try {
+    const s = await api.getActivitySummary(agent.did);
+    const asOf = new Date(s.asOf).getTime();
+    const seenAge = s.lastSeenAt ? Math.floor((asOf - new Date(s.lastSeenAt).getTime()) / 1e3) : null;
+    const evtAge = s.lastEventAt ? Math.floor((asOf - new Date(s.lastEventAt).getTime()) / 1e3) : null;
+    const recent = seenAge !== null && seenAge <= LIVENESS_THRESHOLD_SECONDS || evtAge !== null && evtAge <= LIVENESS_THRESHOLD_SECONDS || s.inboxStreamActive === true;
+    serverSeen = recent ? "listening" : "dormant";
+    serverNote = recent ? `server saw activity ${seenAge ?? evtAge ?? 0}s ago` : "server: no recent activity";
+  } catch (err) {
+    serverSeen = "unknown";
+    serverNote = `server activity not available (${msg(err)})`;
+  }
+  const detail = `${hbNote}; ${serverNote}`;
+  if (hbFresh || serverSeen === "listening") return { id: "worker_liveness", did: agent.did, status: "pass", detail };
+  if (serverSeen === "dormant" || hbExists) {
+    return {
+      id: "worker_liveness",
+      did: agent.did,
+      status: "warn",
+      detail: `${detail} \u2014 monitor may not be running`,
+      fix: "start the worker / verify your cron is invoking arp_worker_watch.sh every ~1m"
+    };
+  }
+  return {
+    id: "worker_liveness",
+    did: agent.did,
+    status: "unknown",
+    detail: `${detail} \u2014 no liveness signal yet (fresh install or offline)`,
+    fix: "start the worker and re-run selftest"
+  };
+}
+var msg = (err) => err instanceof Error ? err.message : String(err);
+function skillSearchDirs(extra) {
+  const dirs = [];
+  if (process.env.ARP_SKILLS_DIR && process.env.ARP_SKILLS_DIR.length > 0) dirs.push(process.env.ARP_SKILLS_DIR);
+  if (extra && extra.length > 0) dirs.push(extra);
+  const home = (0, import_node_os2.homedir)();
+  dirs.push((0, import_node_path7.join)(home, ".claude", "skills"), (0, import_node_path7.join)(home, ".hermes", "skills"), (0, import_node_path7.join)(home, ".openclaw", "skills"));
+  return dirs;
+}
+function findSkill(dirs, role) {
+  const base = `arp-${role}-flow`;
+  for (const d of dirs) {
+    const candidates = [(0, import_node_path7.join)(d, base, "SKILL.md"), (0, import_node_path7.join)(d, `${base}.md`), (0, import_node_path7.join)(d, base)];
+    for (const c of candidates) {
+      if ((0, import_node_fs10.existsSync)(c)) return c;
+    }
+  }
+  return null;
+}
+function resolveRole(flag, skillDirs) {
+  if (flag === "worker" || flag === "buyer" || flag === "both") return flag;
+  const hasWorker = findSkill(skillDirs, "worker") !== null;
+  const hasBuyer = findSkill(skillDirs, "buyer") !== null;
+  if (hasWorker && !hasBuyer) return "worker";
+  if (hasBuyer && !hasWorker) return "buyer";
+  return "both";
+}
+function parseMinSol(raw, role) {
+  if (raw !== void 0 && raw !== "") {
+    const n = Number.parseFloat(raw);
+    if (Number.isFinite(n) && n >= 0) return n;
+  }
+  return DEFAULT_MIN_SOL[role];
+}
+function parsePositive(raw, fallback) {
+  if (raw !== void 0 && raw !== "") {
+    const n = Number.parseFloat(raw);
+    if (Number.isFinite(n) && n > 0) return n;
+  }
+  return fallback;
+}
+var ICON = { pass: import_chalk31.default.green("\u2713"), warn: import_chalk31.default.yellow("\u26A0"), unknown: import_chalk31.default.dim("?"), fail: import_chalk31.default.red("\u2717") };
+function formatSelftestReport(r) {
+  const lines = [];
+  lines.push(`${import_chalk31.default.dim("Server:")} ${r.server}    ${import_chalk31.default.dim("Role:")} ${r.role}`);
+  const render = (c, indent) => {
+    lines.push(`${indent}${ICON[c.status]} ${import_chalk31.default.bold(c.id)}  ${c.detail}`);
+    if (c.fix && c.status !== "pass") lines.push(`${indent}    ${import_chalk31.default.dim("fix:")} ${c.fix}`);
+  };
+  lines.push("");
+  for (const c of r.checks.filter((c2) => !c2.did)) render(c, "  ");
+  const dids = [...new Set(r.checks.filter((c) => c.did).map((c) => c.did))];
+  for (const did of dids) {
+    lines.push("");
+    lines.push(`  ${import_chalk31.default.dim("agent")} ${did}`);
+    for (const c of r.checks.filter((c2) => c2.did === did)) render(c, "    ");
+  }
+  lines.push("");
+  const fails = r.checks.filter((c) => c.status === "fail").length;
+  const advisories = r.checks.filter((c) => c.status === "warn" || c.status === "unknown").length;
+  if (r.ok) {
+    lines.push(`${import_chalk31.default.bold("Verdict:")} ${import_chalk31.default.green("READY")}${advisories > 0 ? import_chalk31.default.dim(` (${advisories} advisory)`) : ""}`);
+  } else {
+    lines.push(`${import_chalk31.default.bold("Verdict:")} ${import_chalk31.default.red("NOT READY")} \u2014 ${fails} blocking check(s) failed`);
+  }
+  return lines.join("\n");
+}
+
 // src/commands/send-handshake.ts
 var import_sdk28 = require("@heyanon-arp/sdk");
-var import_chalk31 = __toESM(require("chalk"));
+var import_chalk32 = __toESM(require("chalk"));
 init_api();
 function registerSendHandshakeCommand(root) {
   root.command("send-handshake").description("Send a handshake envelope to a recipient (agent name or DID). Server creates the relationship row on first contact.").argument("<recipient>", "Recipient \u2014 agent name (handle) or DID (did:arp:...)").option("--server <url>", "Override ARP server base URL").option("--from-did <did>", "Sender DID \u2014 required only if multiple agents are registered against this server").option("--from <name>", "Signer agent NAME (handle) \u2014 alternative to --from-did, resolved against your local agents").option("--greeting <s>", "Optional greeting text included in body.content").option("--intent <s>", "Optional intent text included in body.content").option("--ttl <seconds>", `Envelope TTL in seconds (max ${import_sdk28.MAX_ENVELOPE_TTL_SECONDS} = 24h)`, "3600").option("--require-online", "Abort (exit 1, CLI_RECIPIENT_OFFLINE) if the recipient is not reachable now, instead of warning and sending to their inbox", false).option("--verbose", "Print the full envelope before sending and the full server response. Mutually exclusive with --json.", false).option(
@@ -7422,10 +7674,10 @@ async function runSendHandshake(recipientDid, opts) {
   recipientDid = await resolveRecipient(opts.server, "send-handshake", recipientDid, { json: opts.json });
   const ttlSeconds = parseTtl3(opts.ttl);
   const api = new ArpApiClient(opts.server);
-  progress(opts.json, import_chalk31.default.dim(`Server: ${api.serverUrl}`));
+  progress(opts.json, import_chalk32.default.dim(`Server: ${api.serverUrl}`));
   const sender = resolveSenderAgent("send-handshake", opts.server, opts.fromDid, opts.from);
-  progress(opts.json, import_chalk31.default.dim(`Sender: ${sender.did}`));
-  progress(opts.json, import_chalk31.default.dim(`Recipient: ${recipientDid}`));
+  progress(opts.json, import_chalk32.default.dim(`Sender: ${sender.did}`));
+  progress(opts.json, import_chalk32.default.dim(`Recipient: ${recipientDid}`));
   await guardRecipientReachable(api, recipientDid, { requireOnline: opts.requireOnline });
   const content = {};
   if (opts.greeting) content.greeting = opts.greeting;
@@ -7452,7 +7704,7 @@ async function runSendHandshake(recipientDid, opts) {
     identitySecretKey: signer.identitySecretKey
   });
   if (opts.verbose) {
-    console.log(import_chalk31.default.bold("\nEnvelope (pre-send):"));
+    console.log(import_chalk32.default.bold("\nEnvelope (pre-send):"));
     console.log(formatJson(envelope));
   }
   const result = await api.ingest(envelope);
@@ -7472,23 +7724,23 @@ async function runSendHandshake(recipientDid, opts) {
     });
     return;
   }
-  console.log(import_chalk31.default.green("\nDelivered."));
-  console.log(`${import_chalk31.default.bold("Event id")}: ${import_chalk31.default.cyan(result.eventId)}`);
-  console.log(`${import_chalk31.default.bold("Relationship id")}: ${import_chalk31.default.cyan(result.relationshipId)}`);
-  console.log(`${import_chalk31.default.bold("Chain index")}: ${import_chalk31.default.cyan(String(result.relationshipEventIndex))}`);
-  console.log(`${import_chalk31.default.bold("Server timestamp")}: ${import_chalk31.default.cyan(result.serverTimestamp)}`);
-  console.log(`${import_chalk31.default.bold("Signed message hash")}: ${import_chalk31.default.cyan(result.signedMessageHash)}`);
-  console.log(`${import_chalk31.default.bold("Server event hash")}: ${import_chalk31.default.cyan(result.serverEventHash)}`);
+  console.log(import_chalk32.default.green("\nDelivered."));
+  console.log(`${import_chalk32.default.bold("Event id")}: ${import_chalk32.default.cyan(result.eventId)}`);
+  console.log(`${import_chalk32.default.bold("Relationship id")}: ${import_chalk32.default.cyan(result.relationshipId)}`);
+  console.log(`${import_chalk32.default.bold("Chain index")}: ${import_chalk32.default.cyan(String(result.relationshipEventIndex))}`);
+  console.log(`${import_chalk32.default.bold("Server timestamp")}: ${import_chalk32.default.cyan(result.serverTimestamp)}`);
+  console.log(`${import_chalk32.default.bold("Signed message hash")}: ${import_chalk32.default.cyan(result.signedMessageHash)}`);
+  console.log(`${import_chalk32.default.bold("Server event hash")}: ${import_chalk32.default.cyan(result.serverEventHash)}`);
   if (result.prevServerEventHash) {
-    console.log(`${import_chalk31.default.bold("Prev server event hash")}: ${import_chalk31.default.cyan(result.prevServerEventHash)}`);
+    console.log(`${import_chalk32.default.bold("Prev server event hash")}: ${import_chalk32.default.cyan(result.prevServerEventHash)}`);
   } else {
-    console.log(`${import_chalk31.default.bold("Prev server event hash")}: ${import_chalk31.default.dim("(null \u2014 first event of this relationship)")}`);
+    console.log(`${import_chalk32.default.bold("Prev server event hash")}: ${import_chalk32.default.dim("(null \u2014 first event of this relationship)")}`);
   }
   if (opts.verbose) {
-    console.log(import_chalk31.default.bold("\nFull server response:"));
+    console.log(import_chalk32.default.bold("\nFull server response:"));
     console.log(formatJson(result));
   }
-  console.log(import_chalk31.default.dim(`
+  console.log(import_chalk32.default.dim(`
 Local sender_sequence advanced to ${nextSequence}.`));
 }
 function parseTtl3(raw) {
@@ -7502,7 +7754,7 @@ function parseTtl3(raw) {
 
 // src/commands/send-handshake-response.ts
 var import_sdk29 = require("@heyanon-arp/sdk");
-var import_chalk32 = __toESM(require("chalk"));
+var import_chalk33 = __toESM(require("chalk"));
 init_api();
 var ALLOWED_DECISIONS = new Set(import_sdk29.HANDSHAKE_DECISIONS);
 function registerSendHandshakeResponseCommand(root) {
@@ -7543,11 +7795,11 @@ async function runSendHandshakeResponse(recipientDid, opts) {
     declinePayload = detail ? { reason, reasonDetail: detail } : { reason };
   }
   const api = new ArpApiClient(opts.server);
-  progress(opts.json, import_chalk32.default.dim(`Server: ${api.serverUrl}`));
+  progress(opts.json, import_chalk33.default.dim(`Server: ${api.serverUrl}`));
   const sender = resolveSenderAgent("send-handshake-response", opts.server, opts.fromDid, opts.from);
-  progress(opts.json, import_chalk32.default.dim(`Sender: ${sender.did}`));
-  progress(opts.json, import_chalk32.default.dim(`Recipient: ${recipientDid}`));
-  progress(opts.json, import_chalk32.default.dim(`Decision: ${decision}`));
+  progress(opts.json, import_chalk33.default.dim(`Sender: ${sender.did}`));
+  progress(opts.json, import_chalk33.default.dim(`Recipient: ${recipientDid}`));
+  progress(opts.json, import_chalk33.default.dim(`Decision: ${decision}`));
   const signer = makeSigner(sender);
   if (!opts.force) {
     try {
@@ -7577,13 +7829,13 @@ async function runSendHandshakeResponse(recipientDid, opts) {
             });
             return;
           }
-          progress(opts.json, import_chalk32.default.yellow(`
+          progress(opts.json, import_chalk33.default.yellow(`
 [--idempotency] Relationship ${existing.relationshipId} with ${recipientDid} is already 'active'.`));
           progress(
             opts.json,
-            import_chalk32.default.dim(`A previous accept from this signer (event ${previousResponseFromMe.eventId}) landed successfully. Skipping re-send (use --force to override).`)
+            import_chalk33.default.dim(`A previous accept from this signer (event ${previousResponseFromMe.eventId}) landed successfully. Skipping re-send (use --force to override).`)
           );
-          progress(opts.json, import_chalk32.default.dim(`Last event index: ${existing.lastEventIndex}, last server event hash: ${existing.lastServerEventHash ?? "(none)"}`));
+          progress(opts.json, import_chalk33.default.dim(`Last event index: ${existing.lastEventIndex}, last server event hash: ${existing.lastServerEventHash ?? "(none)"}`));
           return;
         }
         throw new Error(
@@ -7594,7 +7846,7 @@ async function runSendHandshakeResponse(recipientDid, opts) {
       if (probeErr instanceof Error && /CLOSED|terminated|already 'active' from a previous ACCEPT|original initiator/i.test(probeErr.message)) {
         throw probeErr;
       }
-      progress(opts.json, import_chalk32.default.dim(`(idempotency probe failed; proceeding anyway: ${probeErr.message})`));
+      progress(opts.json, import_chalk33.default.dim(`(idempotency probe failed; proceeding anyway: ${probeErr.message})`));
     }
   }
   const content = { decision };
@@ -7624,7 +7876,7 @@ async function runSendHandshakeResponse(recipientDid, opts) {
     identitySecretKey: signer.identitySecretKey
   });
   if (opts.verbose) {
-    console.log(import_chalk32.default.bold("\nEnvelope (pre-send):"));
+    console.log(import_chalk33.default.bold("\nEnvelope (pre-send):"));
     console.log(formatJson(envelope));
   }
   const result = await api.ingest(envelope);
@@ -7645,23 +7897,23 @@ async function runSendHandshakeResponse(recipientDid, opts) {
     });
     return;
   }
-  console.log(import_chalk32.default.green("\nDelivered."));
-  console.log(`${import_chalk32.default.bold("Event id")}: ${import_chalk32.default.cyan(result.eventId)}`);
-  console.log(`${import_chalk32.default.bold("Relationship id")}: ${import_chalk32.default.cyan(result.relationshipId)}`);
-  console.log(`${import_chalk32.default.bold("Chain index")}: ${import_chalk32.default.cyan(String(result.relationshipEventIndex))}`);
-  console.log(`${import_chalk32.default.bold("Server timestamp")}: ${import_chalk32.default.cyan(result.serverTimestamp)}`);
-  console.log(`${import_chalk32.default.bold("Signed message hash")}: ${import_chalk32.default.cyan(result.signedMessageHash)}`);
-  console.log(`${import_chalk32.default.bold("Server event hash")}: ${import_chalk32.default.cyan(result.serverEventHash)}`);
+  console.log(import_chalk33.default.green("\nDelivered."));
+  console.log(`${import_chalk33.default.bold("Event id")}: ${import_chalk33.default.cyan(result.eventId)}`);
+  console.log(`${import_chalk33.default.bold("Relationship id")}: ${import_chalk33.default.cyan(result.relationshipId)}`);
+  console.log(`${import_chalk33.default.bold("Chain index")}: ${import_chalk33.default.cyan(String(result.relationshipEventIndex))}`);
+  console.log(`${import_chalk33.default.bold("Server timestamp")}: ${import_chalk33.default.cyan(result.serverTimestamp)}`);
+  console.log(`${import_chalk33.default.bold("Signed message hash")}: ${import_chalk33.default.cyan(result.signedMessageHash)}`);
+  console.log(`${import_chalk33.default.bold("Server event hash")}: ${import_chalk33.default.cyan(result.serverEventHash)}`);
   if (result.prevServerEventHash) {
-    console.log(`${import_chalk32.default.bold("Prev server event hash")}: ${import_chalk32.default.cyan(result.prevServerEventHash)}`);
+    console.log(`${import_chalk33.default.bold("Prev server event hash")}: ${import_chalk33.default.cyan(result.prevServerEventHash)}`);
   } else {
-    console.log(`${import_chalk32.default.bold("Prev server event hash")}: ${import_chalk32.default.dim("(null \u2014 first event of this relationship)")}`);
+    console.log(`${import_chalk33.default.bold("Prev server event hash")}: ${import_chalk33.default.dim("(null \u2014 first event of this relationship)")}`);
   }
   if (opts.verbose) {
-    console.log(import_chalk32.default.bold("\nFull server response:"));
+    console.log(import_chalk33.default.bold("\nFull server response:"));
     console.log(formatJson(result));
   }
-  console.log(import_chalk32.default.dim(`
+  console.log(import_chalk33.default.dim(`
 Local sender_sequence advanced to ${nextSequence}.`));
 }
 function parseDecision(raw) {
@@ -7711,8 +7963,64 @@ async function findExistingRelationship(api, signer, senderDid, recipientDid) {
   return void 0;
 }
 
+// src/commands/stats.ts
+var import_chalk34 = __toESM(require("chalk"));
+init_api();
+function registerStatsCommand(root) {
+  root.command("stats").description("Show an agent's public stats \u2014 counters, 0..100 scores, derived rates, and settled on-chain volume by asset. Public, no auth.").argument("<agent>", "Agent name (handle) or did:arp:<base58btc>").option("--server <url>", "Override ARP server base URL").option("--json", "Emit the stats as JSON on stdout.", false).action(async (agent, opts) => {
+    const did = await resolveRecipient(opts.server, "stats", agent, { json: opts.json });
+    const api = new ArpApiClient(opts.server);
+    const stats = await api.getStats(did);
+    if (opts.json) {
+      jsonOut(stats);
+      return;
+    }
+    const j = false;
+    const { counters: c, scores: s, rates: r, volume: v } = stats;
+    progress(j, import_chalk34.default.bold(`Stats \u2014 ${did}`));
+    progress(j, import_chalk34.default.dim(`  ${stats.computed ? "computed" : "cold-start (no settled cycle yet)"}`));
+    progress(j, "");
+    progress(
+      j,
+      `  scores   composite ${s.composite.toFixed(0)} \xB7 reliability ${s.reliability.toFixed(0)} \xB7 settlement ${s.settlement.toFixed(0)} \xB7 disputeHealth ${s.disputeHealth.toFixed(0)}`
+    );
+    progress(j, `  rates    completion ${pct(r.completionRate)} \xB7 dispute ${pct(r.disputeRate)} \xB7 adverse ${pct(r.adverseDisputeRate)}`);
+    progress(
+      j,
+      `  cycles   on-chain ${c.onchainCycles} \xB7 completed ${c.completedDelegations} (payer ${c.completedAsPayer} / payee ${c.completedAsPayee}) \xB7 failed ${c.failedDelegations}`
+    );
+    progress(j, `  escrows  settled ${c.settledEscrows} / refunded ${c.refundedEscrows} \xB7 disputed ${c.disputedEscrows} (adverse ${c.disputesAdverse})`);
+    progress(j, `  network  distinct counterparts ${c.distinctCounterparts} \xB7 active relationships ${c.activeRelationships}`);
+    progress(j, "");
+    progress(j, import_chalk34.default.dim("  earned (as payee):"));
+    renderAssets(v.earnedByAsset);
+    progress(j, import_chalk34.default.dim("  paid (as payer):"));
+    renderAssets(v.paidByAsset);
+    if (v.firstSettledAt || v.lastSettledAt) {
+      progress(j, "");
+      progress(j, import_chalk34.default.dim(`  settled span: ${v.firstSettledAt ?? "?"} \u2192 ${v.lastSettledAt ?? "?"}`));
+    }
+    progress(j, "");
+    progress(j, import_chalk34.default.dim("  Public, informational \u2014 derived from on-chain settlement; cached briefly."));
+  });
+}
+function pct(r) {
+  return r == null ? "n/a" : `${(r * 100).toFixed(0)}%`;
+}
+function renderAssets(assets) {
+  if (assets.length === 0) {
+    progress(false, import_chalk34.default.dim("    (none)"));
+    return;
+  }
+  for (const a of assets) {
+    const label = a.symbol ?? `${a.mint.slice(0, 6)}\u2026`;
+    const amount = a.amountDecimal ?? `${a.amountBaseUnits} base-units`;
+    progress(false, `    ${amount} ${label}  ${import_chalk34.default.dim(`(${a.lockCount} lock${a.lockCount === 1 ? "" : "s"})`)}`);
+  }
+}
+
 // src/commands/watch.ts
-var import_chalk33 = __toESM(require("chalk"));
+var import_chalk35 = __toESM(require("chalk"));
 init_api();
 function registerWatchCommand(root) {
   root.command("watch").description("Live tail filtered to a single relationship (SSE). Server-side $match; only envelopes belonging to <rel-id> are streamed.").argument("<relationship-id>", "Relationship UUID to watch").option("--server <url>", "Override ARP server base URL").option("--from-did <did>", "Signer DID \u2014 required only if multiple agents are registered against this server").option("--from <name>", "Signer agent NAME (handle) \u2014 alternative to --from-did, resolved against your local agents").option("--verbose", "After each envelope, print the full JSON with a per-row label including eventId + serverEventHash", false).option("--json", "Machine-readable: one NDJSON object per line. Pipe-safe into `jq -c`.", false).option("--full-ids", "Print DIDs + serverEventHash in full (no truncation).", false).action(async (relationshipId, opts) => {
@@ -7723,9 +8031,9 @@ async function runWatch(relationshipId, opts) {
   const local = resolveSenderAgent("watch", opts.server, opts.fromDid, opts.from);
   const api = new ArpApiClient(opts.server);
   if (!opts.json) {
-    console.log(import_chalk33.default.dim(`Server: ${api.serverUrl}`));
-    console.log(import_chalk33.default.dim(`Signer: ${local.did}`));
-    console.log(import_chalk33.default.dim(`Watching: ${relationshipId}`));
+    console.log(import_chalk35.default.dim(`Server: ${api.serverUrl}`));
+    console.log(import_chalk35.default.dim(`Signer: ${local.did}`));
+    console.log(import_chalk35.default.dim(`Watching: ${relationshipId}`));
   }
   const controller = new AbortController();
   let userAborted = false;
@@ -7744,7 +8052,7 @@ async function runWatch(relationshipId, opts) {
       }
       if (event.type === "heartbeat") continue;
       if (event.type === "connected") {
-        console.log(import_chalk33.default.green(`\u25CF stream open \u2014 watching ${relationshipId}`));
+        console.log(import_chalk35.default.green(`\u25CF stream open \u2014 watching ${relationshipId}`));
         continue;
       }
       if (event.type === "envelope") {
@@ -7758,7 +8066,7 @@ async function runWatch(relationshipId, opts) {
         }
         continue;
       }
-      console.log(import_chalk33.default.dim(`(unknown event: ${event.type})`));
+      console.log(import_chalk35.default.dim(`(unknown event: ${event.type})`));
     }
     if (!userAborted) {
       throw new Error(`watch ${relationshipId}: stream ended unexpectedly (server may have restarted, or the change stream errored). Re-run to reconnect.`);
@@ -7766,7 +8074,7 @@ async function runWatch(relationshipId, opts) {
   } catch (err) {
     const name = err.name;
     if (name === "AbortError" || userAborted) {
-      if (!opts.json) console.log(import_chalk33.default.dim("\nstream closed."));
+      if (!opts.json) console.log(import_chalk35.default.dim("\nstream closed."));
       return;
     }
     throw err;
@@ -7780,21 +8088,21 @@ function formatWatchLine(ev, selfDid, opts = {}) {
   const type = ev.type.padEnd(20);
   const direction = directionLabel2(ev, selfDid, opts);
   const hash = opts.fullIds ? ev.serverEventHash : hashHead4(ev.serverEventHash);
-  return `${import_chalk33.default.dim(`[${ts}]`)}  ${type}  ${direction}    ${import_chalk33.default.cyan(hash)}`;
+  return `${import_chalk35.default.dim(`[${ts}]`)}  ${type}  ${direction}    ${import_chalk35.default.cyan(hash)}`;
 }
 function directionLabel2(ev, selfDid, opts = {}) {
   const senderHead = opts.fullIds ? ev.senderDid : didHead4(ev.senderDid);
   const recipientHead = opts.fullIds ? ev.recipientDid : didHead4(ev.recipientDid);
-  if (ev.senderDid === selfDid) return `${import_chalk33.default.bold("me")} \u2192 ${import_chalk33.default.dim(recipientHead)}`;
-  if (ev.recipientDid === selfDid) return `${import_chalk33.default.dim(senderHead)} \u2192 ${import_chalk33.default.bold("me")}`;
-  return `${import_chalk33.default.dim(senderHead)} \u2192 ${import_chalk33.default.dim(recipientHead)}`;
+  if (ev.senderDid === selfDid) return `${import_chalk35.default.bold("me")} \u2192 ${import_chalk35.default.dim(recipientHead)}`;
+  if (ev.recipientDid === selfDid) return `${import_chalk35.default.dim(senderHead)} \u2192 ${import_chalk35.default.bold("me")}`;
+  return `${import_chalk35.default.dim(senderHead)} \u2192 ${import_chalk35.default.dim(recipientHead)}`;
 }
 function didHead4(did) {
   if (did.length <= 20) return did;
   return `${did.slice(0, 20)}...`;
 }
 function hashHead4(hash) {
-  if (!hash) return import_chalk33.default.dim("(none)");
+  if (!hash) return import_chalk35.default.dim("(none)");
   if (hash.length <= 14) return hash;
   return `${hash.slice(0, 14)}...`;
 }
@@ -7806,7 +8114,7 @@ function formatClock(iso) {
 }
 
 // src/commands/whoami.ts
-var import_chalk34 = __toESM(require("chalk"));
+var import_chalk36 = __toESM(require("chalk"));
 init_api();
 function registerWhoamiCommand(root) {
   root.command("whoami").description(
@@ -7837,12 +8145,12 @@ function registerWhoamiCommand(root) {
         if (opts.json) {
           console.log(formatJson({ ...localJson, account: credential ? { wallet: credential.wallet } : null }));
         } else {
-          console.log(import_chalk34.default.bold("Local agent:"));
-          console.log(`  DID:                ${import_chalk34.default.cyan(local.did)}`);
-          console.log(`  Settlement pubkey:  ${import_chalk34.default.cyan(local.settlementPublicKeyB58)}`);
-          console.log(`  Identity pubkey:    ${import_chalk34.default.cyan(local.identityPublicKeyB58)}`);
+          console.log(import_chalk36.default.bold("Local agent:"));
+          console.log(`  DID:                ${import_chalk36.default.cyan(local.did)}`);
+          console.log(`  Settlement pubkey:  ${import_chalk36.default.cyan(local.settlementPublicKeyB58)}`);
+          console.log(`  Identity pubkey:    ${import_chalk36.default.cyan(local.identityPublicKeyB58)}`);
           if (local.name) console.log(`  Name:               ${local.name}`);
-          console.log(`  Account:            ${credential ? import_chalk34.default.cyan(credential.wallet) : import_chalk34.default.dim("not logged in (heyarp login)")}`);
+          console.log(`  Account:            ${credential ? import_chalk36.default.cyan(credential.wallet) : import_chalk36.default.dim("not logged in (heyarp login)")}`);
         }
         return;
       }
@@ -7860,19 +8168,19 @@ function registerWhoamiCommand(root) {
       if (opts.json) {
         console.log(formatJson({ local: localJson, account, server: agent }));
       } else {
-        console.log(import_chalk34.default.dim(`Server: ${api.serverUrl}`));
-        console.log(import_chalk34.default.bold("\nLocal agent:"));
-        console.log(`  DID:                ${import_chalk34.default.cyan(local.did)}`);
-        console.log(`  Settlement pubkey:  ${import_chalk34.default.cyan(local.settlementPublicKeyB58)}`);
-        console.log(`  Identity pubkey:    ${import_chalk34.default.cyan(local.identityPublicKeyB58)}`);
-        console.log(import_chalk34.default.bold("\nAccount:"));
+        console.log(import_chalk36.default.dim(`Server: ${api.serverUrl}`));
+        console.log(import_chalk36.default.bold("\nLocal agent:"));
+        console.log(`  DID:                ${import_chalk36.default.cyan(local.did)}`);
+        console.log(`  Settlement pubkey:  ${import_chalk36.default.cyan(local.settlementPublicKeyB58)}`);
+        console.log(`  Identity pubkey:    ${import_chalk36.default.cyan(local.identityPublicKeyB58)}`);
+        console.log(import_chalk36.default.bold("\nAccount:"));
         if (account) {
-          console.log(`  Wallet:             ${import_chalk34.default.cyan(account.wallet)}`);
+          console.log(`  Wallet:             ${import_chalk36.default.cyan(account.wallet)}`);
           console.log(`  Agents registered:  ${account.agentCount}`);
         } else {
-          console.log(`  ${import_chalk34.default.dim("not logged in (heyarp login)")}`);
+          console.log(`  ${import_chalk36.default.dim("not logged in (heyarp login)")}`);
         }
-        console.log(import_chalk34.default.bold("\nServer profile:"));
+        console.log(import_chalk36.default.bold("\nServer profile:"));
         console.log(formatJson(agent));
       }
     } catch (err) {
@@ -7884,12 +8192,12 @@ function registerWhoamiCommand(root) {
 
 // src/commands/whois.ts
 var import_sdk30 = require("@heyanon-arp/sdk");
-var import_chalk35 = __toESM(require("chalk"));
+var import_chalk37 = __toESM(require("chalk"));
 init_api();
 function registerWhoisCommand(root) {
   root.command("whois").description("Resolve an agent name (handle) or DID to its public profile \u2014 DID, description, reputation, liveness.").argument("<name-or-did>", "Agent name (handle) or DID (did:arp:...)").option("--server <url>", "Override ARP server base URL").option("--json", "Emit the full composed profile (DiscoveryProfile) as a single JSON object on stdout.", false).action(async (input, opts) => {
     const api = new ArpApiClient(opts.server);
-    progress(opts.json, import_chalk35.default.dim(`Server: ${api.serverUrl}`));
+    progress(opts.json, import_chalk37.default.dim(`Server: ${api.serverUrl}`));
     const profile = await resolveProfile(api, input);
     if (opts.json) {
       jsonOut(profile);
@@ -7912,19 +8220,19 @@ async function resolveProfile(api, input) {
   return api.discoverByName(name);
 }
 function printProfile(p) {
-  console.log(`${import_chalk35.default.bold("Name")}:        ${import_chalk35.default.cyan(p.name ?? "(unnamed)")}`);
-  console.log(`${import_chalk35.default.bold("DID")}:         ${import_chalk35.default.cyan(p.did)}`);
-  if (p.description) console.log(`${import_chalk35.default.bold("Description")}: ${p.description}`);
-  if (p.tags.length > 0) console.log(`${import_chalk35.default.bold("Tags")}:        ${p.tags.join(", ")}`);
-  console.log(`${import_chalk35.default.bold("Registered")}:  ${p.registeredAt}`);
+  console.log(`${import_chalk37.default.bold("Name")}:        ${import_chalk37.default.cyan(p.name ?? "(unnamed)")}`);
+  console.log(`${import_chalk37.default.bold("DID")}:         ${import_chalk37.default.cyan(p.did)}`);
+  if (p.description) console.log(`${import_chalk37.default.bold("Description")}: ${p.description}`);
+  if (p.tags.length > 0) console.log(`${import_chalk37.default.bold("Tags")}:        ${p.tags.join(", ")}`);
+  console.log(`${import_chalk37.default.bold("Registered")}:  ${p.registeredAt}`);
   const rep = p.reputation;
-  console.log(`${import_chalk35.default.bold("Reputation")}:  composite ${rep.scores.composite}/100${rep.computed ? "" : import_chalk35.default.dim(" (cold-start \u2014 no settled cycles yet)")}`);
-  console.log(`${import_chalk35.default.bold("Online")}:      ${p.liveness.online ? import_chalk35.default.green("yes") : import_chalk35.default.dim("no")}`);
+  console.log(`${import_chalk37.default.bold("Reputation")}:  composite ${rep.scores.composite}/100${rep.computed ? "" : import_chalk37.default.dim(" (cold-start \u2014 no settled cycles yet)")}`);
+  console.log(`${import_chalk37.default.bold("Online")}:      ${p.liveness.online ? import_chalk37.default.green("yes") : import_chalk37.default.dim("no")}`);
 }
 
 // src/commands/work.ts
 var import_sdk31 = require("@heyanon-arp/sdk");
-var import_chalk36 = __toESM(require("chalk"));
+var import_chalk38 = __toESM(require("chalk"));
 init_api();
 function registerWorkCommands(root) {
   const cmd = root.command("work").description("Work envelopes inside an ACCEPTED delegation: request / respond");
@@ -7965,11 +8273,11 @@ async function runRequest(recipientDid, delegationId, opts) {
     params
   };
   const body = { type: "work_request", content };
-  progress(opts.json, import_chalk36.default.dim(`Server: ${api.serverUrl}`));
-  progress(opts.json, import_chalk36.default.dim(`Sender: ${sender.did}`));
-  progress(opts.json, import_chalk36.default.dim(`Recipient: ${recipientDid}`));
-  progress(opts.json, import_chalk36.default.dim(`Delegation: ${delegationId}`));
-  progress(opts.json, import_chalk36.default.dim(`Request id: ${requestId}`));
+  progress(opts.json, import_chalk38.default.dim(`Server: ${api.serverUrl}`));
+  progress(opts.json, import_chalk38.default.dim(`Sender: ${sender.did}`));
+  progress(opts.json, import_chalk38.default.dim(`Recipient: ${recipientDid}`));
+  progress(opts.json, import_chalk38.default.dim(`Delegation: ${delegationId}`));
+  progress(opts.json, import_chalk38.default.dim(`Request id: ${requestId}`));
   const result = await sendWorkEnvelope({ api, sender, recipientDid, body, ttlSeconds, verbose: opts.verbose, server: opts.server });
   if (opts.json) {
     jsonOut({
@@ -7986,10 +8294,10 @@ async function runRequest(recipientDid, delegationId, opts) {
     });
   } else {
     printIngestResult3(result);
-    console.log(import_chalk36.default.dim(`
+    console.log(import_chalk38.default.dim(`
 The payee can reply with:`));
-    console.log(import_chalk36.default.dim(`  heyarp work respond ${result.relationshipId} ${delegationId} ${requestId} --output '<json>'`));
-    console.log(import_chalk36.default.dim(`  heyarp work respond ${result.relationshipId} ${delegationId} ${requestId} --error CODE:message`));
+    console.log(import_chalk38.default.dim(`  heyarp work respond ${result.relationshipId} ${delegationId} ${requestId} --output '<json>'`));
+    console.log(import_chalk38.default.dim(`  heyarp work respond ${result.relationshipId} ${delegationId} ${requestId} --error CODE:message`));
   }
 }
 function registerRespond(parent) {
@@ -8024,13 +8332,13 @@ async function runRespond(relationshipId, delegationId, requestId, opts) {
     ...responsePayload
   };
   const body = { type: "work_response", content };
-  progress(opts.json, import_chalk36.default.dim(`Server: ${api.serverUrl}`));
-  progress(opts.json, import_chalk36.default.dim(`Sender: ${sender.did}`));
-  progress(opts.json, import_chalk36.default.dim(`Recipient: ${recipientDid}`));
-  progress(opts.json, import_chalk36.default.dim(`Relationship: ${relationshipId}`));
-  progress(opts.json, import_chalk36.default.dim(`Delegation: ${delegationId}`));
-  progress(opts.json, import_chalk36.default.dim(`Request id: ${requestId}`));
-  progress(opts.json, import_chalk36.default.dim(`Outcome: ${responsePayload.output ? "success" : "error"}`));
+  progress(opts.json, import_chalk38.default.dim(`Server: ${api.serverUrl}`));
+  progress(opts.json, import_chalk38.default.dim(`Sender: ${sender.did}`));
+  progress(opts.json, import_chalk38.default.dim(`Recipient: ${recipientDid}`));
+  progress(opts.json, import_chalk38.default.dim(`Relationship: ${relationshipId}`));
+  progress(opts.json, import_chalk38.default.dim(`Delegation: ${delegationId}`));
+  progress(opts.json, import_chalk38.default.dim(`Request id: ${requestId}`));
+  progress(opts.json, import_chalk38.default.dim(`Outcome: ${responsePayload.output ? "success" : "error"}`));
   const result = await sendWorkEnvelope({ api, sender, recipientDid, body, ttlSeconds, verbose: opts.verbose, server: opts.server });
   if (opts.json) {
     jsonOut({
@@ -8071,7 +8379,7 @@ async function sendWorkEnvelope(args) {
     identitySecretKey: signer.identitySecretKey
   });
   if (args.verbose) {
-    console.log(import_chalk36.default.bold("\nEnvelope (pre-send):"));
+    console.log(import_chalk38.default.bold("\nEnvelope (pre-send):"));
     console.log(formatJson(envelope));
   }
   try {
@@ -8111,12 +8419,12 @@ async function resolveResponseRecipient(cmdName, api, signer, args) {
   );
 }
 function printIngestResult3(result) {
-  console.log(import_chalk36.default.green("\nDelivered."));
-  console.log(`${import_chalk36.default.bold("Event id")}: ${import_chalk36.default.cyan(result.eventId)}`);
-  console.log(`${import_chalk36.default.bold("Relationship id")}: ${import_chalk36.default.cyan(result.relationshipId)}`);
-  console.log(`${import_chalk36.default.bold("Chain index")}: ${import_chalk36.default.cyan(String(result.relationshipEventIndex))}`);
-  console.log(`${import_chalk36.default.bold("Server timestamp")}: ${import_chalk36.default.cyan(result.serverTimestamp)}`);
-  console.log(`${import_chalk36.default.bold("Server event hash")}: ${import_chalk36.default.cyan(result.serverEventHash)}`);
+  console.log(import_chalk38.default.green("\nDelivered."));
+  console.log(`${import_chalk38.default.bold("Event id")}: ${import_chalk38.default.cyan(result.eventId)}`);
+  console.log(`${import_chalk38.default.bold("Relationship id")}: ${import_chalk38.default.cyan(result.relationshipId)}`);
+  console.log(`${import_chalk38.default.bold("Chain index")}: ${import_chalk38.default.cyan(String(result.relationshipEventIndex))}`);
+  console.log(`${import_chalk38.default.bold("Server timestamp")}: ${import_chalk38.default.cyan(result.serverTimestamp)}`);
+  console.log(`${import_chalk38.default.bold("Server event hash")}: ${import_chalk38.default.cyan(result.serverEventHash)}`);
 }
 function parseJsonObject(cmdName, flagName, raw) {
   let parsed;
@@ -8154,8 +8462,8 @@ function parseParamsInput(cmdName, opts) {
   return parseJsonObject(cmdName, "--params", opts.params ?? "{}");
 }
 function readJsonObjectFile(cmdName, flagName, path) {
-  const { existsSync: existsSync7, readFileSync: readFileSync10 } = require("fs");
-  if (!existsSync7(path)) {
+  const { existsSync: existsSync8, readFileSync: readFileSync10 } = require("fs");
+  if (!existsSync8(path)) {
     throw new Error(`${cmdName}: ${flagName} file not found at ${path}`);
   }
   let raw;
@@ -8218,7 +8526,7 @@ function parseRequestId(cmdName, raw) {
 
 // src/commands/work-list.ts
 var import_sdk32 = require("@heyanon-arp/sdk");
-var import_chalk37 = __toESM(require("chalk"));
+var import_chalk39 = __toESM(require("chalk"));
 init_api();
 var ALLOWED_STATES3 = new Set(import_sdk32.WORK_LOG_STATES);
 function registerWorkListCommand(root) {
@@ -8245,9 +8553,9 @@ async function runWorkList(relationshipId, opts) {
   const api = new ArpApiClient(opts.server);
   const sender = resolveSenderAgent("work-list", opts.server, opts.fromDid, opts.from);
   if (!opts.json) {
-    console.log(import_chalk37.default.dim(`Server: ${api.serverUrl}`));
-    console.log(import_chalk37.default.dim(`Signer: ${sender.did}`));
-    console.log(import_chalk37.default.dim(`Relationship: ${relationshipId}`));
+    console.log(import_chalk39.default.dim(`Server: ${api.serverUrl}`));
+    console.log(import_chalk39.default.dim(`Signer: ${sender.did}`));
+    console.log(import_chalk39.default.dim(`Relationship: ${relationshipId}`));
   }
   const query = { limit };
   if (state) query.state = state;
@@ -8260,7 +8568,7 @@ async function runWorkList(relationshipId, opts) {
     return;
   }
   if (rows.length === 0) {
-    console.log(import_chalk37.default.dim("\n(no work-logs for this relationship)"));
+    console.log(import_chalk39.default.dim("\n(no work-logs for this relationship)"));
     return;
   }
   console.log("");
@@ -8277,36 +8585,36 @@ async function runWorkList(relationshipId, opts) {
     }));
   }
   const lastId = rows[rows.length - 1].id;
-  console.log(import_chalk37.default.dim(`
+  console.log(import_chalk39.default.dim(`
 ${rows.length} work-log row(s). Paginate with --after ${lastId}.`));
 }
 function formatWorkLogLine(w, selfDid, opts = {}) {
   const delegationPart = opts.fullIds ? w.delegationId : idHead3(w.delegationId);
   const requestPart = opts.fullIds ? w.requestId : truncate3(w.requestId, 16);
-  const id = import_chalk37.default.bold(`${delegationPart}/${requestPart}`);
+  const id = import_chalk39.default.bold(`${delegationPart}/${requestPart}`);
   const state = colorState2(w.state).padEnd(stateColumnWidth2());
   const peerCallerHead = opts.fullIds ? w.callerDid : didHead5(w.callerDid);
   const peerPayeeHead = opts.fullIds ? w.payeeDid : didHead5(w.payeeDid);
-  const direction = w.callerDid === selfDid ? `${import_chalk37.default.bold("me")} \u2192 ${import_chalk37.default.dim(peerPayeeHead)}` : `${import_chalk37.default.dim(peerCallerHead)} \u2192 ${import_chalk37.default.bold("me")}`;
+  const direction = w.callerDid === selfDid ? `${import_chalk39.default.bold("me")} \u2192 ${import_chalk39.default.dim(peerPayeeHead)}` : `${import_chalk39.default.dim(peerCallerHead)} \u2192 ${import_chalk39.default.bold("me")}`;
   const outcome = formatOutcome(w);
   return `${id}  ${state}  ${direction}  ${outcome}`;
 }
 function colorState2(s) {
   switch (s) {
     case import_sdk32.WorkLogStates.REQUESTED:
-      return import_chalk37.default.yellow("requested");
+      return import_chalk39.default.yellow("requested");
     case import_sdk32.WorkLogStates.RESPONDED:
-      return import_chalk37.default.green("responded");
+      return import_chalk39.default.green("responded");
   }
 }
 function stateColumnWidth2() {
   return 9;
 }
 function formatOutcome(w) {
-  if (w.state === import_sdk32.WorkLogStates.REQUESTED) return import_chalk37.default.dim("(in flight)");
-  if (w.responseError) return import_chalk37.default.red(`error ${w.responseError.code}: ${truncate3(w.responseError.message, 32)}`);
-  if (w.responseOutput) return import_chalk37.default.cyan("ok");
-  return import_chalk37.default.dim("(empty response)");
+  if (w.state === import_sdk32.WorkLogStates.REQUESTED) return import_chalk39.default.dim("(in flight)");
+  if (w.responseError) return import_chalk39.default.red(`error ${w.responseError.code}: ${truncate3(w.responseError.message, 32)}`);
+  if (w.responseOutput) return import_chalk39.default.cyan("ok");
+  return import_chalk39.default.dim("(empty response)");
 }
 function idHead3(id) {
   if (id.length <= 12) return id;
@@ -8374,12 +8682,12 @@ function unknownOptionHint(program, err) {
 }
 
 // src/version-gate.ts
-var import_node_fs10 = require("fs");
-var import_node_path7 = require("path");
+var import_node_fs11 = require("fs");
+var import_node_path8 = require("path");
 init_paths();
 var CHECK_INTERVAL_MS = 60 * 60 * 1e3;
 var REGISTRY_TIMEOUT_MS = 1500;
-var cacheFile = () => (0, import_node_path7.join)(arpHomeDir(), "update-check.json");
+var cacheFile = () => (0, import_node_path8.join)(arpHomeDir(), "update-check.json");
 function majorOf(version) {
   return Number.parseInt(version.split(".")[0] ?? "0", 10) || 0;
 }
@@ -8411,7 +8719,7 @@ async function fetchLatest(pkgName) {
 }
 async function resolveLatest(pkgName) {
   try {
-    const cached = JSON.parse((0, import_node_fs10.readFileSync)(cacheFile(), "utf8"));
+    const cached = JSON.parse((0, import_node_fs11.readFileSync)(cacheFile(), "utf8"));
     if (typeof cached.latest === "string" && typeof cached.checkedAt === "number" && Date.now() - cached.checkedAt < CHECK_INTERVAL_MS) {
       return cached.latest;
     }
@@ -8421,8 +8729,8 @@ async function resolveLatest(pkgName) {
   if (!fresh) return null;
   try {
     const file = cacheFile();
-    (0, import_node_fs10.mkdirSync)((0, import_node_path7.dirname)(file), { recursive: true });
-    (0, import_node_fs10.writeFileSync)(file, JSON.stringify({ checkedAt: Date.now(), latest: fresh }));
+    (0, import_node_fs11.mkdirSync)((0, import_node_path8.dirname)(file), { recursive: true });
+    (0, import_node_fs11.writeFileSync)(file, JSON.stringify({ checkedAt: Date.now(), latest: fresh }));
   } catch {
   }
   return fresh;
@@ -8486,6 +8794,7 @@ async function main() {
   registerDidDocCommand(program);
   registerProfileCommand(program);
   registerDoctorCommand(program);
+  registerSelftestCommand(program);
   registerAssetsCommand(program);
   registerEscrowCommands(program);
   registerWhoamiCommand(program);
@@ -8508,6 +8817,7 @@ async function main() {
   registerReceiptCommands(program);
   registerReceiptsCommand(program);
   registerReputationCommand(program);
+  registerStatsCommand(program);
   registerWalletCommands(program);
   (0, import_shield3.installMiddleware)(program);
   try {