arc402-cli 0.3.4 → 0.4.1

package/src/commands/config.ts

@@ -2,31 +2,48 @@ import { Command } from "commander";
 import prompts from "prompts";
 import chalk from "chalk";
 import { Arc402Config, NETWORK_DEFAULTS, configExists, loadConfig, saveConfig, getSubdomainApi } from "../config";
+import { c } from '../ui/colors';
 
 export function registerConfigCommands(program: Command): void {
   const config = program.command("config").description("Manage ARC-402 CLI configuration");
   config.command("init").description("Interactive setup for ~/.arc402/config.json").action(async () => {
     const existing: Partial<Arc402Config> = configExists() ? loadConfig() : {};
     const answers = await prompts([
-      { type: "select", name: "network", message: "Network", choices: [{ title: "Base Sepolia", value: "base-sepolia" }, { title: "Base Mainnet", value: "base-mainnet" }], initial: existing.network === "base-mainnet" ? 1 : 0 },
-      { type: "text", name: "rpcUrl", message: "RPC URL", initial: (_: unknown, values: Record<string, string>) => existing.rpcUrl ?? NETWORK_DEFAULTS[values.network]?.rpcUrl ?? "" },
-      { type: "text", name: "agentRegistryAddress", message: "AgentRegistry address (optional)", initial: existing.agentRegistryAddress ?? "" },
-      { type: "text", name: "serviceAgreementAddress", message: "ServiceAgreement address (optional)", initial: existing.serviceAgreementAddress ?? "" },
-      { type: "text", name: "trustRegistryAddress", message: "TrustRegistry / TrustRegistryV3 address", initial: (_: unknown, values: Record<string, string>) => existing.trustRegistryAddress ?? NETWORK_DEFAULTS[values.network]?.trustRegistryAddress ?? "" },
-      { type: "text", name: "reputationOracleAddress", message: "ReputationOracle address (optional)", initial: existing.reputationOracleAddress ?? "" },
-      { type: "text", name: "sponsorshipAttestationAddress", message: "SponsorshipAttestation address (optional)", initial: existing.sponsorshipAttestationAddress ?? "" },
-      { type: "text", name: "capabilityRegistryAddress", message: "CapabilityRegistry address (optional)", initial: existing.capabilityRegistryAddress ?? "" },
-      { type: "text", name: "governanceAddress", message: "ARC402Governance address (optional)", initial: existing.governanceAddress ?? "" },
-      { type: "confirm", name: "storeKey", message: "Store private key in config?", initial: false },
-      { type: (prev: boolean) => prev ? "password" : null, name: "privateKey", message: "Private key (0x...)" },
-      { type: "text", name: "subdomainApi", message: "Subdomain API endpoint (optional, default: https://api.arc402.xyz):", initial: existing.subdomainApi ?? "" },
-      { type: "text", name: "telegramBotToken", message: "Telegram bot token (optional, for approval notifications):", initial: existing.telegramBotToken ?? "" },
-      { type: "text", name: "telegramChatId", message: "Telegram chat ID (optional):", initial: existing.telegramChatId ?? "" },
-      { type: "text", name: "telegramThreadId", message: "Telegram thread ID (optional, for forum topics):", initial: existing.telegramThreadId?.toString() ?? "" },
+      { type: "select", name: "network", message: "Network", choices: [{ title: "Base Mainnet", value: "base-mainnet" }, { title: "Base Sepolia (testnet)", value: "base-sepolia" }], initial: existing.network === "base-sepolia" ? 1 : 0 },
     ]);
-    const cfg: Arc402Config = { network: answers.network, rpcUrl: answers.rpcUrl, trustRegistryAddress: answers.trustRegistryAddress, agentRegistryAddress: answers.agentRegistryAddress || undefined, serviceAgreementAddress: answers.serviceAgreementAddress || undefined, reputationOracleAddress: answers.reputationOracleAddress || undefined, sponsorshipAttestationAddress: answers.sponsorshipAttestationAddress || undefined, capabilityRegistryAddress: answers.capabilityRegistryAddress || undefined, governanceAddress: answers.governanceAddress || undefined, ...(answers.storeKey && answers.privateKey ? { privateKey: answers.privateKey } : {}), ...(answers.subdomainApi ? { subdomainApi: answers.subdomainApi } : {}), ...(answers.telegramBotToken ? { telegramBotToken: answers.telegramBotToken } : {}), ...(answers.telegramChatId ? { telegramChatId: answers.telegramChatId } : {}), ...(answers.telegramThreadId ? { telegramThreadId: Number(answers.telegramThreadId) } : {}) };
+
+    if (!answers.network) { console.log(chalk.red("✗ Setup cancelled")); return; }
+
+    const defaults = NETWORK_DEFAULTS[answers.network] ?? {};
+    const cfg: Arc402Config = {
+      network: answers.network,
+      walletConnectProjectId: "2bc39e3b38de7ef7deeed1e3dbbe6ad6",
+      rpcUrl: defaults.rpcUrl ?? "https://mainnet.base.org",
+      trustRegistryAddress: defaults.trustRegistryAddress ?? "",
+      agentRegistryAddress: defaults.agentRegistryV2Address ?? defaults.agentRegistryAddress,
+      serviceAgreementAddress: defaults.serviceAgreementAddress,
+      reputationOracleAddress: defaults.reputationOracleAddress,
+      sponsorshipAttestationAddress: defaults.sponsorshipAttestationAddress,
+      capabilityRegistryAddress: defaults.capabilityRegistryAddress,
+      governanceAddress: defaults.governanceAddress,
+      ...(existing.privateKey ? { privateKey: existing.privateKey } : {}),
+      ...(existing.subdomainApi ? { subdomainApi: existing.subdomainApi } : {}),
+      ...(existing.telegramBotToken ? { telegramBotToken: existing.telegramBotToken } : {}),
+      ...(existing.telegramChatId ? { telegramChatId: existing.telegramChatId } : {}),
+      ...(existing.telegramThreadId ? { telegramThreadId: existing.telegramThreadId } : {}),
+      ...(existing.walletContractAddress ? { walletContractAddress: existing.walletContractAddress } : {}),
+    };
     saveConfig(cfg);
-    console.log(chalk.green("✓ Config saved"));
+
+    console.log();
+    console.log(' ' + c.success + c.white(' Config saved'));
+    console.log();
+    console.log(chalk.dim("  Network          ") + chalk.white(answers.network === "base-mainnet" ? "Base Mainnet" : "Base Sepolia"));
+    console.log(chalk.dim("  RPC              ") + chalk.white(cfg.rpcUrl!));
+    console.log(chalk.dim("  Contracts        ") + chalk.white("All protocol addresses loaded"));
+    console.log();
+    console.log(chalk.dim("  Next: ") + chalk.white("arc402 wallet deploy"));
+    console.log();
   });
   config.command("show").description("Print current config").action(() => {
     const cfg = loadConfig();

package/src/commands/daemon.ts

@@ -8,6 +8,9 @@ import { ethers } from "ethers";
 import prompts from "prompts";
 import { loadConfig } from "../config";
 import { requireSigner } from "../client";
+import { startSpinner } from "../ui/spinner";
+import { renderTree } from "../ui/tree";
+import { c } from "../ui/colors";
 import { SERVICE_AGREEMENT_ABI } from "../abis";
 import {
   DAEMON_DIR,
@@ -344,15 +347,21 @@ async function startDaemonBackground(sandboxName?: string, runtimeRemoteRoot?: s
     if (sandboxName) {
       const remotePid = await readRemotePid(sandboxName);
       if (remotePid) {
-        console.log(`ARC-402 daemon started inside OpenShell. PID: ${remotePid}`);
-        console.log(`Remote log: ${REMOTE_DAEMON_LOG}`);
+        console.log(` ${c.success} ARC-402 daemon started (OpenShell)`);
+        renderTree([
+          { label: "PID", value: String(remotePid) },
+          { label: "Log", value: REMOTE_DAEMON_LOG, last: true },
+        ]);
         return;
       }
     } else {
       const pid = readPid();
       if (pid && isProcessAlive(pid)) {
-        console.log(`ARC-402 daemon started. PID: ${pid}`);
-        console.log(`Log: ${DAEMON_LOG}`);
+        console.log(` ${c.success} ARC-402 daemon started`);
+        renderTree([
+          { label: "PID", value: String(pid) },
+          { label: "Log", value: DAEMON_LOG, last: true },
+        ]);
         return;
       }
     }
@@ -408,34 +417,31 @@ async function stopDaemon(opts: { wait?: boolean } = {}): Promise<boolean> {
 // ─── Output formatters ────────────────────────────────────────────────────────
 
 function formatStatus(data: Record<string, unknown>): void {
-  const line = (label: string, value: string) =>
-    console.log(`${label.padEnd(20)}${value}`);
-
-  console.log("ARC-402 Daemon Status");
-  console.log("─────────────────────");
-  line("State:", String(data.state ?? "unknown"));
-  line("PID:", String(data.pid ?? "unknown"));
-  line("Uptime:", String(data.uptime ?? "unknown"));
-  line("Wallet:", String(data.wallet ?? "unknown"));
-  line("Machine Key:", String(data.machine_key_address ?? "unknown"));
-  console.log();
-  console.log("Subsystems:");
   const relayStatus = data.relay_enabled
     ? `active — polling ${data.relay_url || "relay"} every ${data.relay_poll_seconds}s`
     : "disabled";
   const watchtowerStatus = data.watchtower_enabled ? "active" : "disabled";
   const bundlerStatus = `${data.bundler_mode} — ${data.bundler_endpoint || "default"}`;
-  console.log(`  Relay:      ${relayStatus}`);
-  console.log(`  Watchtower: ${watchtowerStatus}`);
-  console.log(`  Bundler:    ${bundlerStatus}`);
-  console.log();
   const pending = Number(data.pending_approval ?? 0);
-  console.log(`Active Agreements:  ${data.active_agreements ?? 0}`);
-  if (pending > 0) {
-    console.log(`Pending Approval:   ${pending}  ← (review with: arc402 daemon pending)`);
-  } else {
-    console.log(`Pending Approval:   0`);
-  }
+
+  console.log(`${c.mark}  ARC-402  Daemon Status`);
+  console.log();
+  renderTree([
+    { label: "State", value: String(data.state ?? "unknown") },
+    { label: "PID", value: String(data.pid ?? "unknown") },
+    { label: "Uptime", value: String(data.uptime ?? "unknown") },
+    { label: "Wallet", value: String(data.wallet ?? "unknown") },
+    { label: "Key", value: String(data.machine_key_address ?? "unknown") },
+    { label: "Relay", value: relayStatus },
+    { label: "Watchtower", value: watchtowerStatus },
+    { label: "Bundler", value: bundlerStatus },
+    { label: "Agreements", value: String(data.active_agreements ?? 0) },
+    {
+      label: "Pending",
+      value: pending > 0 ? `${pending}  ← arc402 daemon pending` : "0",
+      last: true,
+    },
+  ]);
 }
 
 interface HireRow {
@@ -585,9 +591,9 @@ export function registerDaemonCommands(program: Command): void {
           process.exit(0);
         }
         const { configPath, host } = buildOpenShellSshConfig(openShellCfg.sandbox.name);
-        console.log(`Stopping daemon (OpenShell PID ${remotePid})...`);
+        const stopSpinnerRemote = startSpinner(`Stopping daemon (OpenShell PID ${remotePid})...`);
         runCmd("ssh", ["-F", configPath, host, `kill ${remotePid}`], { timeout: 20000 });
-        console.log("Stop signal sent.");
+        stopSpinnerRemote.succeed("Stop signal sent");
         return;
       }
 
@@ -597,11 +603,12 @@ export function registerDaemonCommands(program: Command): void {
         process.exit(0);
       }
 
-      console.log(`Stopping daemon (PID ${pid})...`);
+      const stopSpinner = startSpinner(`Stopping daemon (PID ${pid})...`);
       const stopped = await stopDaemon({ wait: true });
       if (stopped) {
-        console.log("Daemon stopped.");
+        stopSpinner.succeed("Daemon stopped");
       } else {
+        stopSpinner.fail("Failed to stop daemon cleanly");
         console.error("Failed to stop daemon cleanly.");
         process.exit(1);
       }
@@ -656,15 +663,15 @@ export function registerDaemonCommands(program: Command): void {
           console.log("Launch path: arc402 openshell init, then arc402 daemon start");
           process.exit(1);
         }
-        console.log("ARC-402 Daemon Status");
-        console.log("─────────────────────");
-        console.log(`State:               running (OpenShell sandbox)`);
-        console.log(`PID:                 ${remotePid}`);
-        console.log(`Sandbox:             ${openShellCfg.sandbox.name}`);
-        console.log(`Runtime root:        ${openShellCfg.runtime?.remote_root ?? DEFAULT_RUNTIME_REMOTE_ROOT}`);
-        console.log(`Log path:            ${REMOTE_DAEMON_LOG}`);
+        console.log(`${c.mark}  ARC-402  Daemon Status`);
         console.log();
-        console.log("Note: remote daemon control plane is active; deep status still flows through the in-sandbox IPC socket.");
+        renderTree([
+          { label: "State", value: "running (OpenShell sandbox)" },
+          { label: "PID", value: String(remotePid) },
+          { label: "Sandbox", value: openShellCfg.sandbox.name },
+          { label: "Runtime", value: openShellCfg.runtime?.remote_root ?? DEFAULT_RUNTIME_REMOTE_ROOT },
+          { label: "Log", value: REMOTE_DAEMON_LOG, last: true },
+        ]);
         return;
       }
 

package/src/commands/deliver.ts

@@ -9,6 +9,9 @@ import { SERVICE_AGREEMENT_ABI } from "../abis";
 import { readFile } from "fs/promises";
 import prompts from "prompts";
 import { resolveAgentEndpoint, notifyAgent, DEFAULT_REGISTRY_ADDRESS } from "../endpoint-notify";
+import { c } from '../ui/colors';
+import { startSpinner } from '../ui/spinner';
+import { renderTree } from '../ui/tree';
 
 export function registerDeliverCommand(program: Command): void {
   program
@@ -88,8 +91,9 @@ export function registerDeliverCommand(program: Command): void {
         const { ethers } = await import("ethers");
         const hash = ethers.keccak256(buffer);
 
-        console.log(`encrypted upload: ${uri} (CID: ${cid})`);
+        console.log(' ' + c.dim('Encrypted upload:') + ' ' + c.white(uri));
 
+        const encSpinner = startSpinner('Committing deliverable…');
         if (config.walletContractAddress) {
           await executeContractWriteViaWallet(
             config.walletContractAddress, signer, config.serviceAgreementAddress,
@@ -99,11 +103,17 @@ export function registerDeliverCommand(program: Command): void {
           const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
           await client.commitDeliverable(BigInt(id), hash);
         }
-        console.log(`committed ${id} hash=${hash} (plaintext hash; encrypted at ${uri})`);
+        encSpinner.succeed(` Delivered — agreement #${id}`);
+        renderTree([
+          { label: 'Hash', value: hash },
+          { label: 'CID', value: cid },
+          { label: 'URI', value: uri, last: true },
+        ]);
         return;
       }
 
       const hash = opts.output ? hashFile(opts.output) : hashString(opts.message ?? `agreement:${id}`);
+      const deliverSpinner = startSpinner(`${opts.fulfill ? 'Fulfilling' : 'Committing deliverable for'} agreement #${id}…`);
       if (config.walletContractAddress) {
         const fn = opts.fulfill ? "fulfill" : "commitDeliverable";
         await executeContractWriteViaWallet(
@@ -114,7 +124,10 @@ export function registerDeliverCommand(program: Command): void {
         const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
         if (opts.fulfill) await client.fulfill(BigInt(id), hash); else await client.commitDeliverable(BigInt(id), hash);
       }
-      console.log(`${opts.fulfill ? 'fulfilled' : 'committed'} ${id} hash=${hash}`);
+      deliverSpinner.succeed(` ${opts.fulfill ? 'Fulfilled' : 'Delivered'} — agreement #${id}`);
+      renderTree([
+        { label: 'Hash', value: hash, last: true },
+      ]);
 
       // Notify client's HTTP endpoint (non-blocking)
       if (clientAddress) {

package/src/commands/discover.ts

@@ -4,6 +4,7 @@ import { AgentRegistryClient, CapabilityRegistryClient, ReputationOracleClient,
 import { loadConfig } from "../config";
 import { getClient } from "../client";
 import { getTrustTier, printTable, truncateAddress } from "../utils/format";
+import { c } from '../ui/colors';
 
 // Minimal ABI for the new getAgentsWithCapability function (Spec 18)
 const CAPABILITY_REGISTRY_EXTRA_ABI = [
@@ -273,6 +274,7 @@ export function registerDiscoverCommand(program: Command): void {
         ));
       }
 
+      console.log('\n ' + c.mark + c.white(' Discover Results') + c.dim(` — ${scored.length} agent${scored.length !== 1 ? 's' : ''} found`));
       printTable(
         ["RANK", "ADDRESS", "NAME", "SERVICE", "TRUST", "SCORE", "CAPABILITIES"],
         scored.map((agent) => {

package/src/commands/dispute.ts

@@ -7,6 +7,8 @@ import { getClient, requireSigner } from "../client";
 import { hashFile, hashString } from "../utils/hash";
 import { printSenderInfo, executeContractWriteViaWallet } from "../wallet-router";
 import { SERVICE_AGREEMENT_ABI } from "../abis";
+import { c } from '../ui/colors';
+import { startSpinner } from '../ui/spinner';
 
 export function registerDisputeCommand(program: Command): void {
   const dispute = program.command("dispute").description("Formal dispute workflow; remediation-first by default, with narrow hard-fail direct-dispute exceptions");
@@ -33,7 +35,7 @@ export function registerDisputeCommand(program: Command): void {
       const disputeClass = classMap[String(opts.class).toLowerCase()];
       if (!mode || !disputeClass) throw new Error("Invalid --mode or --class");
       const feeInTokens = await client.getFeeQuote(BigInt(opts.price), opts.token, mode, disputeClass);
-      console.log(`Fee quote for agreement ${agreementId}: ${feeInTokens.toString()} tokens`);
+      console.log(' ' + c.mark + c.white(` Fee quote — agreement #${agreementId}: ${feeInTokens.toString()} tokens`));
     });
 
   // Open with explicit mode/class
@@ -68,7 +70,7 @@ export function registerDisputeCommand(program: Command): void {
         const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
         await client.openDisputeWithMode(BigInt(agreementId), mode, disputeClass, opts.reason, BigInt(opts.fee));
       }
-      console.log(`dispute opened for ${agreementId} (${opts.mode} / ${opts.class})`);
+      console.log(' ' + c.success + c.white(` Dispute opened — agreement #${agreementId}`));
     });
 
   // Join mutual dispute (respondent pays their half) — DisputeArbitration contract, no wallet routing
@@ -81,7 +83,7 @@ export function registerDisputeCommand(program: Command): void {
       const { signer } = await requireSigner(config);
       const client = new DisputeArbitrationClient(config.disputeArbitrationAddress, signer);
       await client.joinMutualDispute(BigInt(agreementId), BigInt(opts.fee));
-      console.log(`joined mutual dispute ${agreementId}`);
+      console.log(' ' + c.success + c.white(` Joined mutual dispute — agreement #${agreementId}`));
     });
 
   dispute.command("open <id>")
@@ -177,7 +179,7 @@ export function registerDisputeCommand(program: Command): void {
           await client.dispute(BigInt(id), opts.reason);
         }
       }
-      console.log(`dispute opened for ${id}`);
+      console.log(' ' + c.success + c.white(` Dispute opened — agreement #${id}`));
 
       // J4-04: Display arbitration selection window deadline
       try {
@@ -210,7 +212,7 @@ export function registerDisputeCommand(program: Command): void {
       const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
       await client.submitDisputeEvidence(BigInt(id), evidenceType, hash, opts.uri);
     }
-    console.log(`evidence submitted for ${id} hash=${hash}`);
+    console.log(' ' + c.success + c.white(` Evidence submitted — agreement #${id}`));
   });
 
   // status — read-only, no wallet routing needed
@@ -263,7 +265,7 @@ export function registerDisputeCommand(program: Command): void {
         const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
         await client.nominateArbitrator(BigInt(id), opts.arbitrator);
       }
-      console.log(`arbitrator nominated for ${id}: ${opts.arbitrator}`);
+      console.log(' ' + c.success + c.white(` Arbitrator nominated — agreement #${id}`));
     });
 
   dispute.command("vote <id>")
@@ -309,7 +311,7 @@ export function registerDisputeCommand(program: Command): void {
         const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
         await client.castArbitrationVote(BigInt(id), vote, BigInt(opts.providerAward), BigInt(opts.clientAward));
       }
-      console.log(`arbitration vote recorded for ${id}`);
+      console.log(' ' + c.success + c.white(` Vote recorded — agreement #${id}`));
     });
 
   dispute.command("human <id>")
@@ -329,7 +331,7 @@ export function registerDisputeCommand(program: Command): void {
         const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
         await client.requestHumanEscalation(BigInt(id), opts.reason);
       }
-      console.log(`human escalation requested for ${id}`);
+      console.log(' ' + c.success + c.white(` Escalated to human — agreement #${id}`));
     });
 
   dispute.command("resolve <id>").description("Owner-only admin path if you are operating the dispute contract").requiredOption("--outcome <outcome>", "provider|refund|partial-provider|partial-client|mutual-cancel|human-review").option("--provider-award <amount>", "Wei/token units", "0").option("--client-award <amount>", "Wei/token units", "0").action(async (id, opts) => {
@@ -348,7 +350,7 @@ export function registerDisputeCommand(program: Command): void {
       const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
       await client.resolveDisputeDetailed(BigInt(id), mapping[String(opts.outcome)], BigInt(opts.providerAward), BigInt(opts.clientAward));
     }
-    console.log(`resolved ${id}`);
+    console.log(' ' + c.success + c.white(` Resolved — agreement #${id}`));
   });
 
   dispute.command("owner-resolve <agreementId>")
@@ -368,6 +370,6 @@ export function registerDisputeCommand(program: Command): void {
         const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
         await client.ownerResolveDispute(BigInt(agreementId), !!opts.favorProvider);
       }
-      console.log(`owner resolved agreement ${agreementId} — favor provider: ${!!opts.favorProvider}`);
+      console.log(' ' + c.success + c.white(` Owner resolved — agreement #${agreementId}`));
     });
 }

package/src/commands/endpoint.ts

@@ -17,6 +17,7 @@ import * as dns from "dns/promises";
 import * as fs from "fs";
 import * as net from "net";
 import chalk from "chalk";
+import { c } from '../ui/colors';
 
 interface DoctorCheck {
   layer: string;
@@ -477,7 +478,7 @@ export function registerEndpointCommands(program: Command): void {
       });
       saveEndpointConfig(cfg);
 
-      console.log(chalk.green(`✓ Endpoint scaffold written: ${ENDPOINT_CONFIG_PATH}`));
+      console.log(c.success + c.white(' Endpoint scaffold written: ' + ENDPOINT_CONFIG_PATH));
       console.log(`  Agent name:    ${cfg.agentName}`);
       console.log(`  Hostname:      ${cfg.hostname}`);
       console.log(`  Public URL:    ${cfg.publicUrl}`);
@@ -510,7 +511,7 @@ export function registerEndpointCommands(program: Command): void {
       const allGood = checks.every((check) => check.ok);
       const brokenLayers = Array.from(new Set(checks.filter((check) => !check.ok).map((check) => check.layer)));
 
-      console.log("ARC-402 Endpoint Status");
+      console.log('\n ' + c.mark + c.white(' ARC-402 Endpoint Status'));
       console.log("─────────────────────");
       console.log(`Agent name:      ${cfg.agentName}`);
       console.log(`Hostname:        ${cfg.hostname}`);
@@ -571,7 +572,7 @@ export function registerEndpointCommands(program: Command): void {
       });
       saveEndpointConfig(cfg);
 
-      console.log(chalk.green(`✓ Endpoint config locked to ${cfg.publicUrl}`));
+      console.log(c.success + c.white(' Endpoint config locked to ' + cfg.publicUrl));
       console.log(`  Hostname:      ${cfg.hostname}`);
       console.log(`  Tunnel target: ${cfg.tunnelTarget}`);
       console.log(`  Wallet:        ${cfg.walletAddress}`);

package/src/commands/feed.ts

@@ -1,5 +1,6 @@
 import { Command } from "commander";
 import chalk from "chalk";
+import { c } from '../ui/colors';
 
 const SUBGRAPH_URL = "https://api.studio.thegraph.com/query/1744310/arc-402/v0.2.0";
 

package/src/commands/hire.ts

@@ -7,6 +7,10 @@ import { hashFile, hashString } from "../utils/hash";
 import { parseDuration } from "../utils/time";
 import { printSenderInfo, executeContractWriteViaWallet } from "../wallet-router";
 import { AGENT_REGISTRY_ABI, SERVICE_AGREEMENT_ABI } from "../abis";
+import { c } from '../ui/colors';
+import { startSpinner } from '../ui/spinner';
+import { renderTree, TreeItem } from '../ui/tree';
+import { formatAddress } from '../ui/format';
 
 const DEFAULT_REGISTRY_ADDRESS = "0xD5c2851B00090c92Ba7F4723FB548bb30C9B6865";
 
@@ -132,6 +136,8 @@ export function registerHireCommand(program: Command): void {
 
       let agreementId: bigint;
 
+      const hireSpinner = startSpinner('Submitting agreement...');
+
       if (config.walletContractAddress) {
         // Smart wallet path — wallet handles per-tx USDC approval via maxApprovalAmount
         const tx = await executeContractWriteViaWallet(
@@ -185,6 +191,8 @@ export function registerHireCommand(program: Command): void {
         agreementId = result.agreementId;
       }
 
+      hireSpinner.succeed('Agreement proposed');
+
       // Notify provider's HTTP endpoint (non-blocking)
       const hireRegistryAddress = config.agentRegistryV2Address ?? config.agentRegistryAddress ?? DEFAULT_REGISTRY_ADDRESS;
       try {
@@ -224,7 +232,14 @@ export function registerHireCommand(program: Command): void {
         return console.log(JSON.stringify(output, null, 2));
       }
 
-      console.log(`agreementId=${agreementId!} deliverablesHash=${deliverablesHash}`);
-      if (transcriptHash) console.log(`transcriptHash=${transcriptHash}`);
+      console.log(' ' + c.success + c.white(` Agreement #${agreementId!} proposed`));
+      const hireTreeItems: TreeItem[] = [
+        { label: 'Agent', value: formatAddress(opts.agent) },
+        { label: 'Task', value: opts.task.slice(0, 60) + (opts.task.length > 60 ? '...' : '') },
+        { label: 'Service', value: opts.serviceType },
+        { label: 'Hash', value: String(deliverablesHash), last: !transcriptHash },
+      ];
+      if (transcriptHash) hireTreeItems.push({ label: 'Transcript', value: transcriptHash, last: true });
+      renderTree(hireTreeItems);
     });
 }

package/src/commands/migrate.ts

@@ -2,6 +2,10 @@ import { Command } from "commander";
 import { ethers } from "ethers";
 import { loadConfig } from "../config";
 import { getClient, requireSigner } from "../client";
+import { c } from '../ui/colors';
+import { startSpinner } from '../ui/spinner';
+import { renderTree } from '../ui/tree';
+import { formatAddress } from '../ui/format';
 
 const MIGRATION_REGISTRY_ABI = [
   "function registerMigration(address oldWallet, address newWallet) external",
@@ -35,8 +39,10 @@ export function registerMigrateCommands(program: Command): void {
       const { signer } = await requireSigner(config);
       const contract = new ethers.Contract(config.migrationRegistryAddress, MIGRATION_REGISTRY_ABI, signer);
 
+      const migrateSpinner = startSpinner('Registering migration...');
       const tx = await contract.registerMigration(oldWallet, newWallet);
       const receipt = await tx.wait();
+      migrateSpinner.succeed('Migration registered');
 
       const payload = {
         oldWallet,
@@ -44,11 +50,11 @@ export function registerMigrateCommands(program: Command): void {
         txHash: receipt.hash,
       };
       if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-      console.log(`migration registered`);
-      console.log(`  old: ${oldWallet}`);
-      console.log(`  new: ${newWallet}`);
-      console.log(`  note: 10% trust score decay applied on migration`);
-      console.log(`  tx: ${receipt.hash}`);
+      renderTree([
+        { label: 'Old', value: formatAddress(oldWallet) },
+        { label: 'New', value: formatAddress(newWallet) },
+        { label: 'Note', value: '10% trust score decay applied', last: true },
+      ]);
     });
 
   // ─── migrate status <address> ──────────────────────────────────────────────
@@ -85,15 +91,15 @@ export function registerMigrateCommands(program: Command): void {
         migratedFrom: wasSource ? migratedFrom : null,
       };
       if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-      console.log(`address=${address}`);
-      console.log(`  active wallet: ${activeWallet}`);
-      if (isCurrent) {
-        console.log(`  status: current (no further migration)`);
-      } else {
-        console.log(`  status: migrated — score queries resolve to ${activeWallet}`);
-      }
-      if (hasMigrated) console.log(`  migrated to:   ${migratedTo}`);
-      if (wasSource)   console.log(`  migrated from: ${migratedFrom}`);
+      const statusItems: import('../ui/tree').TreeItem[] = [
+        { label: 'Address', value: formatAddress(address) },
+        { label: 'Active', value: formatAddress(activeWallet) },
+        { label: 'Status', value: isCurrent ? 'current (no further migration)' : `migrated — resolves to ${formatAddress(activeWallet)}` },
+      ];
+      if (hasMigrated) statusItems.push({ label: 'Migrated to', value: formatAddress(migratedTo) });
+      if (wasSource) statusItems.push({ label: 'Migrated from', value: formatAddress(migratedFrom) });
+      statusItems[statusItems.length - 1].last = true;
+      renderTree(statusItems);
     });
 
   // ─── migrate lineage <address> ────────────────────────────────────────────
@@ -158,18 +164,14 @@ export function registerMigrateCommands(program: Command): void {
       };
       if (opts.json) return console.log(JSON.stringify(payload, null, 2));
 
-      console.log(`address=${address}`);
-      console.log(`  lineage depth: ${lineage.length} wallet${lineage.length !== 1 ? "s" : ""}`);
-      console.log(`  migrations:    ${entries.length}`);
-      console.log();
-      lineage.forEach((addr, i) => {
-        const label = i === 0 ? " (origin)" : i === lineage.length - 1 ? " (current)" : "";
-        console.log(`  [${i}] ${addr}${label}`);
-        if (i < entries.length) {
-          const e = entries[i];
-          if (e.timestamp) console.log(`      migrated: ${e.timestamp}`);
-          if (e.scoreAtMigration) console.log(`      score at migration: ${e.scoreAtMigration} (decay: ${Number(e.decayBps) / 100}%)`);
-        }
+      const lineageItems = lineage.map((addr, i) => {
+        const roleLabel = i === 0 ? ' (origin)' : i === lineage.length - 1 ? ' (current)' : '';
+        const e = i < entries.length ? entries[i] : null;
+        let value = formatAddress(addr) + roleLabel;
+        if (e?.timestamp) value += `  · ${e.timestamp}`;
+        if (e?.scoreAtMigration) value += `  · score: ${e.scoreAtMigration} (decay: ${Number(e.decayBps) / 100}%)`;
+        return { label: `[${i}]`, value, last: i === lineage.length - 1 };
       });
+      renderTree(lineageItems);
     });
 }

package/src/commands/negotiate.ts

@@ -11,6 +11,7 @@ import {
 import { loadConfig } from "../config";
 import { requireSigner, getClient } from "../client";
 import { hashFile, hashString } from "../utils/hash";
+import { c } from '../ui/colors';
 
 const sessionManager = new SessionManager();
 
@@ -102,7 +103,7 @@ export function registerNegotiateCommands(program: Command): void {
       if (opts.json) {
         console.log(JSON.stringify({ sessionId: session.sessionId, message: proposal }));
       } else {
-        console.log(`Session started: ${session.sessionId}`);
+        console.log(' ' + c.success + c.white(' Session started: ' + session.sessionId.slice(0, 12) + '...'));
         console.log(`Signed PROPOSE:`);
         console.log(JSON.stringify(proposal, null, 2));
       }
@@ -138,7 +139,7 @@ export function registerNegotiateCommands(program: Command): void {
       if (opts.json) {
         console.log(JSON.stringify(counter));
       } else {
-        console.log(`Signed COUNTER added to session ${sessionId.slice(0, 10)}...`);
+        console.log(' ' + c.success + c.white(' Counter added to session'));
         console.log(JSON.stringify(counter, null, 2));
       }
     });
@@ -177,8 +178,8 @@ export function registerNegotiateCommands(program: Command): void {
           message: accept,
         }));
       } else {
-        console.log(`✓ Session ${sessionId.slice(0, 10)}... ACCEPTED`);
-        console.log(`✓ Transcript hash: ${updatedSession.transcriptHash}`);
+        console.log(' ' + c.success + c.white(' Session ACCEPTED — transcript locked'));
+        console.log(' ' + c.dim('  Transcript:') + ' ' + c.white(updatedSession.transcriptHash ?? ''));
         if (opts.record) {
           console.log(`\nTranscript hash is ready to commit on-chain.`);
           console.log(`Run: arc402 hire --session ${sessionId} to propose() and record the transcript hash.`);
@@ -212,7 +213,7 @@ export function registerNegotiateCommands(program: Command): void {
       if (opts.json) {
         console.log(JSON.stringify(reject));
       } else {
-        console.log(`✗ Session ${sessionId.slice(0, 10)}... REJECTED`);
+        console.log(' ' + c.failure + c.white(' Session REJECTED'));
         console.log(`Reason: ${opts.reason}`);
       }
     });
@@ -239,9 +240,9 @@ export function registerNegotiateCommands(program: Command): void {
       if (opts.json) {
         console.log(JSON.stringify(result));
       } else if (result.valid) {
-        console.log(`✓ Valid — signer: ${result.recoveredSigner}`);
+        console.log(' ' + c.success + c.white(' Valid — signer: ' + result.recoveredSigner));
       } else {
-        console.error(`✗ Invalid — ${result.error}`);
+        console.error(' ' + c.failure + c.white(' Invalid — ' + result.error));
         process.exit(1);
       }
     });