arc402-cli 1.0.0-rc.1 → 1.1.0

package/src/commands/feed.ts

@@ -1,229 +0,0 @@
-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";
-
-const HS_TYPE_LABELS: Record<number, string> = {
-  0: "Respected",
-  1: "Curious",
-  2: "Endorsed",
-  3: "Thanked",
-  4: "Collaborated",
-  5: "Challenged",
-  6: "Referred",
-  7: "Hello",
-};
-
-async function gql(query: string): Promise<Record<string, unknown>> {
-  const res = await fetch(SUBGRAPH_URL, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ query }),
-  });
-  if (!res.ok) throw new Error(`Subgraph HTTP ${res.status}`);
-  const json = (await res.json()) as { data?: Record<string, unknown>; errors?: unknown[] };
-  if (json.errors?.length) throw new Error(`Subgraph error: ${JSON.stringify(json.errors[0])}`);
-  return json.data ?? {};
-}
-
-function shortAddr(addr: string): string {
-  return addr.length > 12 ? `${addr.slice(0, 6)}...${addr.slice(-4)}` : addr;
-}
-
-function utcTime(ts: number): string {
-  const d = new Date(ts * 1000);
-  const h = d.getUTCHours().toString().padStart(2, "0");
-  const m = d.getUTCMinutes().toString().padStart(2, "0");
-  return `${h}:${m} UTC`;
-}
-
-function weiToEth(wei: string): string {
-  return (Number(BigInt(wei)) / 1e18).toFixed(4);
-}
-
-function weiToUsdc(wei: string): string {
-  return (Number(BigInt(wei)) / 1e6).toFixed(2);
-}
-
-type FeedEvent = {
-  type: "handshake" | "hire" | "fulfill" | "vouch";
-  timestamp: number;
-  raw: Record<string, unknown>;
-};
-
-async function fetchFeedEvents(limit: number, typeFilter?: string, sinceTs?: number): Promise<FeedEvent[]> {
-  const includeHandshakes = !typeFilter || typeFilter === "handshake";
-  const includeHire = !typeFilter || typeFilter === "hire";
-  const includeFulfill = !typeFilter || typeFilter === "fulfill";
-  const includeVouch = !typeFilter || typeFilter === "vouch";
-
-  const tsFilt = sinceTs ? `, where: { timestamp_gt: "${sinceTs}" }` : "";
-  const agTsFilt = sinceTs ? `, where: { proposedAt_gt: "${sinceTs}" }` : "";
-
-  const parts: string[] = [];
-
-  if (includeHandshakes) {
-    parts.push(`
-      handshakes(orderBy: timestamp, orderDirection: desc, first: ${limit}${tsFilt}) {
-        id from { id name } to { id name } hsType note timestamp isNewConnection
-      }`);
-  }
-
-  if (includeHire || includeFulfill) {
-    parts.push(`
-      agreements(orderBy: proposedAt, orderDirection: desc, first: ${limit}${agTsFilt}) {
-        id client provider serviceType price state proposedAt updatedAt
-      }`);
-  }
-
-  if (includeVouch) {
-    parts.push(`
-      vouches(orderBy: id, orderDirection: desc, first: ${limit}) {
-        id voucher { id name } newAgent { id name } stakeAmount active
-      }`);
-  }
-
-  const data = await gql(`{ ${parts.join("\n")} }`);
-  const events: FeedEvent[] = [];
-
-  if (includeHandshakes) {
-    for (const h of (data.handshakes as Record<string, unknown>[]) ?? []) {
-      events.push({ type: "handshake", timestamp: Number(h["timestamp"]), raw: h });
-    }
-  }
-
-  if (data["agreements"]) {
-    for (const a of data["agreements"] as Record<string, unknown>[]) {
-      const state = Number(a["state"]);
-      if (includeHire && state === 0) {
-        events.push({ type: "hire", timestamp: Number(a["proposedAt"]), raw: a });
-      }
-      if (includeFulfill && state === 2) {
-        events.push({ type: "fulfill", timestamp: Number(a["updatedAt"]), raw: a });
-      }
-    }
-  }
-
-  if (includeVouch) {
-    for (const v of (data["vouches"] as Record<string, unknown>[]) ?? []) {
-      events.push({ type: "vouch", timestamp: 0, raw: v });
-    }
-  }
-
-  events.sort((a, b) => b.timestamp - a.timestamp);
-  return events.slice(0, limit);
-}
-
-function renderFeedEvent(ev: FeedEvent): string {
-  const ts = ev.timestamp > 0 ? `[${utcTime(ev.timestamp)}]` : "[       ]";
-
-  switch (ev.type) {
-    case "handshake": {
-      const h = ev.raw;
-      const from = h["from"] as Record<string, string>;
-      const to = h["to"] as Record<string, string>;
-      const fromName = from["name"] || shortAddr(from["id"]);
-      const toName = to["name"] || shortAddr(to["id"]);
-      const label = HS_TYPE_LABELS[Number(h["hsType"])] ?? `Type${h["hsType"]}`;
-      const note = h["note"] ? `  "${h["note"]}"` : "";
-      return chalk.cyan(`${ts}  🤝 ${fromName} → ${toName}     ${label}${note}`);
-    }
-    case "hire": {
-      const a = ev.raw;
-      const price = a["price"] ? `  ${weiToEth(a["price"] as string)} ETH` : "";
-      return chalk.yellow(
-        `${ts}  📋 ${shortAddr(a["client"] as string)} hired ${shortAddr(a["provider"] as string)}   ${a["serviceType"]}${price}`,
-      );
-    }
-    case "fulfill": {
-      const a = ev.raw;
-      const price = a["price"] ? `  ${weiToEth(a["price"] as string)} ETH released` : "";
-      return chalk.green(`${ts}  ✅ Agreement #${(a["id"] as string).slice(0, 8)} fulfilled${price}`);
-    }
-    case "vouch": {
-      const v = ev.raw;
-      const voucher = v["voucher"] as Record<string, string>;
-      const newAgent = v["newAgent"] as Record<string, string>;
-      const vName = voucher["name"] || shortAddr(voucher["id"]);
-      const nName = newAgent["name"] || shortAddr(newAgent["id"]);
-      const stake = v["stakeAmount"] ? `  ${weiToUsdc(v["stakeAmount"] as string)} USDC staked` : "";
-      return chalk.magenta(`${ts}  🔗 ${vName} vouched for ${nName}${stake}`);
-    }
-  }
-}
-
-export interface FeedOptions {
-  limit?: string;
-  live?: boolean;
-  type?: string;
-  json?: boolean;
-}
-
-export async function runFeed(opts: FeedOptions): Promise<void> {
-  const limit = parseInt(opts.limit ?? "20", 10);
-  const typeFilter = opts.type;
-
-  const events = await fetchFeedEvents(limit, typeFilter);
-
-  if (opts.json) {
-    console.log(JSON.stringify(events, null, 2));
-    if (!opts.live) return;
-  } else {
-    for (const ev of [...events].reverse()) {
-      console.log(renderFeedEvent(ev));
-    }
-    if (!opts.live) return;
-  }
-
-  // Live mode — keep process alive and poll every 30s
-  process.stdin.resume();
-  let lastTs = events.length > 0 ? events[0].timestamp : Math.floor(Date.now() / 1000);
-
-  const interval = setInterval(async () => {
-    try {
-      const newEvents = await fetchFeedEvents(limit, typeFilter, lastTs);
-      if (newEvents.length > 0) {
-        if (opts.json) {
-          console.log(JSON.stringify(newEvents, null, 2));
-        } else {
-          console.log(chalk.dim("─".repeat(50)));
-          for (const ev of [...newEvents].reverse()) {
-            console.log(renderFeedEvent(ev));
-          }
-        }
-        lastTs = newEvents[0].timestamp;
-      }
-    } catch {
-      if (!opts.json) console.log(chalk.dim("  (subgraph unavailable)"));
-    }
-  }, 30_000);
-
-  process.on("SIGINT", () => {
-    clearInterval(interval);
-    process.exit(0);
-  });
-}
-
-export function registerFeedCommand(program: Command): void {
-  program
-    .command("feed")
-    .description("Live terminal feed of recent Arena events")
-    .option("--limit <n>", "Number of events to show", "20")
-    .option("--live", "Poll every 30s for new events")
-    .option("--type <type>", "Filter by event type: handshake|hire|fulfill|vouch")
-    .option("--json", "Output as JSON")
-    .action(async (opts) => {
-      try {
-        await runFeed(opts as FeedOptions);
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if ((opts as FeedOptions).json) {
-          console.log(JSON.stringify({ error: "Subgraph unavailable", details: msg }));
-        } else {
-          console.error(chalk.red(`Subgraph unavailable: ${msg}`));
-        }
-        process.exit(1);
-      }
-    });
-}

package/src/commands/hire.ts

@@ -1,245 +0,0 @@
-import { Command } from "commander";
-import { ServiceAgreementClient, SessionManager } from "@arc402/sdk";
-import { ethers } from "ethers";
-import { getUsdcAddress, loadConfig } from "../config";
-import { requireSigner } from "../client";
-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";
-
-const sessionManager = new SessionManager();
-
-export function registerHireCommand(program: Command): void {
-  program
-    .command("hire")
-    .description("Create the on-chain commitment after off-chain negotiation")
-    .requiredOption("--agent <address>")
-    .requiredOption("--task <description>")
-    .requiredOption("--service-type <type>")
-    .option("--max <amount>", "Max price in wei (e.g. 1000000000000000) or ETH (e.g. 0.001eth) or USDC (e.g. 1USDC). Required unless --session is provided.")
-    .option("--deadline <duration>", "Deadline as duration (1h, 30m, 7d) or absolute ISO date (2026-04-01). Required unless --session is provided.")
-    .option("--token <token>", "eth or usdc", "eth")
-    .option("--deliverable-spec <filepath>")
-    .option("--session <sessionId>", "Load agreed price and deadline from a completed negotiation session")
-    .option("--json")
-    .action(async (opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { signer, address } = await requireSigner(config);
-      const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
-
-      let maxAmount: string;
-      let deadlineArg: string;
-      let transcriptHash: string | undefined;
-
-      if (opts.session) {
-        const session = sessionManager.load(opts.session);
-        if (session.state !== "ACCEPTED") throw new Error(`Session ${opts.session} is not in ACCEPTED state (state: ${session.state})`);
-        if (!session.agreedPrice || !session.agreedDeadline) throw new Error(`Session ${opts.session} is missing agreedPrice or agreedDeadline`);
-        maxAmount = session.agreedPrice;
-        deadlineArg = session.agreedDeadline;
-        transcriptHash = session.transcriptHash;
-      } else {
-        if (!opts.max) throw new Error("--max is required when --session is not provided. Examples: 0.001eth, 1000000000000000 (wei), 1USDC");
-        if (!opts.deadline) throw new Error("--deadline is required when --session is not provided. Examples: 1h, 30m, 7d, 2026-04-01");
-        maxAmount = opts.max;
-        deadlineArg = opts.deadline;
-      }
-
-      // Normalise --max: strip trailing 'eth' or 'USDC' suffix and convert to correct unit
-      const useUsdc = String(opts.token).toLowerCase() === "usdc";
-      const ethSuffix = /^(\d+(?:\.\d+)?)eth$/i.exec(maxAmount);
-      const usdcSuffix = /^(\d+(?:\.\d+)?)usdc$/i.exec(maxAmount);
-      if (ethSuffix) maxAmount = String(BigInt(Math.round(parseFloat(ethSuffix[1]) * 1e18)));
-      else if (usdcSuffix) maxAmount = usdcSuffix[1]; // keep decimal for USDC path
-      const token = useUsdc ? getUsdcAddress(config) : ethers.ZeroAddress;
-      let price: bigint;
-      try {
-        price = useUsdc ? BigInt(Math.round(Number(maxAmount) * 1_000_000)) : BigInt(maxAmount);
-      } catch {
-        throw new Error(`Invalid --max value "${opts.max}". Use wei (1000000000000000), ETH (0.001eth), or USDC (1USDC)`);
-      }
-      if (price <= 0n) throw new Error(`--max must be greater than zero`);
-
-      // Pre-flight: check client !== provider (J2-03)
-      if (address.toLowerCase() === opts.agent.toLowerCase()) {
-        console.error("Cannot hire yourself: client and provider addresses are the same.");
-        process.exit(1);
-      }
-
-      // Pre-flight: check provider is registered in AgentRegistry (J2-02)
-      const agentRegistryAddress = config.agentRegistryV2Address ?? config.agentRegistryAddress;
-      if (agentRegistryAddress) {
-        const arProvider = new ethers.JsonRpcProvider(config.rpcUrl);
-        const arCheck = new ethers.Contract(
-          agentRegistryAddress,
-          ["function isRegistered(address wallet) external view returns (bool)"],
-          arProvider,
-        );
-        let isRegistered = true;
-        try {
-          isRegistered = await arCheck.isRegistered(opts.agent);
-        } catch { /* assume registered if read fails */ }
-        if (!isRegistered) {
-          console.error(`Provider ${opts.agent} is not registered in AgentRegistry.`);
-          console.error(`Verify the agent address is correct, or check the registry at ${agentRegistryAddress}.`);
-          process.exit(1);
-        }
-      }
-
-      // Pre-flight: check token is allowed on this ServiceAgreement (J2-01)
-      if (useUsdc) {
-        const saProvider = new ethers.JsonRpcProvider(config.rpcUrl);
-        const saCheck = new ethers.Contract(
-          config.serviceAgreementAddress,
-          ["function allowedTokens(address) external view returns (bool)"],
-          saProvider,
-        );
-        let isAllowed = false;
-        try {
-          isAllowed = await saCheck.allowedTokens(token);
-        } catch { isAllowed = true; /* assume allowed if read fails */ }
-        if (!isAllowed) {
-          console.error(`Token ${token} is not allowed on this ServiceAgreement.`);
-          console.error(`Only the SA owner can allowlist tokens via:`);
-          console.error(`  cast send ${config.serviceAgreementAddress} "allowToken(address)" ${token}`);
-          console.error(`For ETH payments, use --token eth`);
-          process.exit(1);
-        }
-      }
-
-      // Use spec hash as deliverables hash; if transcript exists, incorporate it
-      const baseHash = opts.deliverableSpec ? hashFile(opts.deliverableSpec) : hashString(opts.task);
-      const deliverablesHash = transcriptHash
-        ? (ethers.keccak256(ethers.toUtf8Bytes(baseHash + transcriptHash)) as `0x${string}`)
-        : baseHash;
-
-      // Parse deadline: if it looks like an ISO date, convert to seconds from now
-      let deadlineSeconds: number;
-      const isoMatch = deadlineArg.match(/^\d{4}-\d{2}-\d{2}/);
-      if (isoMatch) {
-        const target = Math.floor(new Date(deadlineArg).getTime() / 1000);
-        deadlineSeconds = target - Math.floor(Date.now() / 1000);
-        if (deadlineSeconds <= 0) throw new Error(`Deadline ${deadlineArg} is in the past`);
-      } else {
-        deadlineSeconds = parseDuration(deadlineArg);
-      }
-
-      printSenderInfo(config);
-
-      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(
-          config.walletContractAddress,
-          signer,
-          config.serviceAgreementAddress,
-          SERVICE_AGREEMENT_ABI,
-          "propose",
-          [opts.agent, opts.serviceType, opts.task, price, token, deadlineSeconds, deliverablesHash],
-          useUsdc ? 0n : price,   // ETH value forwarded to SA; 0 for USDC agreements
-          useUsdc ? token : ethers.ZeroAddress,  // approvalToken for USDC
-          useUsdc ? price : 0n,   // maxApprovalAmount for USDC
-        );
-        const receipt = await tx.wait();
-        const saInterface = new ethers.Interface(SERVICE_AGREEMENT_ABI);
-        let found = false;
-        for (const log of receipt!.logs) {
-          if (log.address.toLowerCase() === config.serviceAgreementAddress.toLowerCase()) {
-            try {
-              const parsed = saInterface.parseLog(log);
-              if (parsed?.name === "AgreementProposed") {
-                agreementId = parsed.args[0] as bigint;
-                found = true;
-                break;
-              }
-            } catch { /* skip unparseable logs */ }
-          }
-        }
-        if (!found) throw new Error("AgreementProposed event not found in transaction receipt");
-      } else {
-        // EOA path — existing behaviour
-        if (useUsdc) {
-          const usdc = new ethers.Contract(
-            token,
-            ["function approve(address spender,uint256 amount) external returns (bool)", "function allowance(address owner,address spender) external view returns (uint256)"],
-            signer
-          );
-          const allowance = await usdc.allowance(address, config.serviceAgreementAddress);
-          if (allowance < price) await (await usdc.approve(config.serviceAgreementAddress, price)).wait();
-        }
-
-        const result = await client.propose({
-          provider: opts.agent,
-          serviceType: opts.serviceType,
-          description: opts.task,
-          price,
-          token,
-          deadline: deadlineSeconds,
-          deliverablesHash,
-        });
-        agreementId = result.agreementId;
-      }
-
-      hireSpinner.succeed('Agreement proposed');
-
-      // Notify provider's HTTP endpoint (non-blocking)
-      const hireRegistryAddress = config.agentRegistryV2Address ?? config.agentRegistryAddress ?? DEFAULT_REGISTRY_ADDRESS;
-      try {
-        const hireProvider = new ethers.JsonRpcProvider(config.rpcUrl);
-        const hireRegistry = new ethers.Contract(hireRegistryAddress, AGENT_REGISTRY_ABI, hireProvider);
-        const agentData = await hireRegistry.getAgent(opts.agent);
-        const endpoint = agentData.endpoint as string;
-        if (endpoint) {
-          await fetch(`${endpoint}/hire`, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({
-              agreementId: agreementId!.toString(),
-              from: address,
-              provider: opts.agent,
-              serviceType: opts.serviceType,
-              task: opts.task,
-              price: price.toString(),
-              token,
-              deadline: deadlineSeconds,
-              deliverablesHash,
-            }),
-          });
-        }
-      } catch (err) {
-        console.warn(`Warning: could not notify provider endpoint: ${err instanceof Error ? err.message : String(err)}`);
-      }
-
-      if (opts.session) {
-        sessionManager.setOnChainId(opts.session, agreementId!.toString());
-      }
-
-      if (opts.json) {
-        const output: Record<string, unknown> = { agreementId: agreementId!.toString(), deliverablesHash };
-        if (transcriptHash) output.transcriptHash = transcriptHash;
-        if (opts.session) output.sessionId = opts.session;
-        return console.log(JSON.stringify(output, null, 2));
-      }
-
-      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

@@ -1,177 +0,0 @@
-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",
-  "function resolveActiveWallet(address wallet) external view returns (address)",
-  "function getLineage(address wallet) external view returns (address[])",
-  "function migratedTo(address wallet) external view returns (address)",
-  "function migratedFrom(address wallet) external view returns (address)",
-  "event MigrationRegistered(address indexed oldWallet, address indexed newWallet, address indexed owner, uint256 migratedAt, uint256 scoreAtMigration, uint256 appliedDecay)",
-] as const;
-
-export function registerMigrateCommands(program: Command): void {
-  const migrate = program
-    .command("migrate")
-    .description("Wallet migration — register, query status, or print lineage history")
-    .argument("[oldWallet]", "old wallet address (required for registration)")
-    .argument("[newWallet]", "new wallet address (required for registration)")
-    .option("--json")
-    .action(async (oldWallet, newWallet, opts) => {
-      if (!oldWallet || !newWallet) {
-        console.error("Usage: arc402 migrate <oldWallet> <newWallet>");
-        console.error("Both wallets must share the same registered owner address.");
-        process.exit(1);
-      }
-
-      const config = loadConfig();
-      if (!config.migrationRegistryAddress) {
-        console.error("migrationRegistryAddress not configured. Run `arc402 config set migrationRegistryAddress <address>`.");
-        process.exit(1);
-      }
-
-      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,
-        newWallet,
-        txHash: receipt.hash,
-      };
-      if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-      renderTree([
-        { label: 'Old', value: formatAddress(oldWallet) },
-        { label: 'New', value: formatAddress(newWallet) },
-        { label: 'Note', value: '10% trust score decay applied', last: true },
-      ]);
-    });
-
-  // ─── migrate status <address> ──────────────────────────────────────────────
-
-  migrate
-    .command("status <address>")
-    .description("Show whether a wallet is in a migration lineage and its current active wallet")
-    .option("--json")
-    .action(async (address, opts) => {
-      const config = loadConfig();
-      if (!config.migrationRegistryAddress) {
-        console.error("migrationRegistryAddress not configured. Run `arc402 config set migrationRegistryAddress <address>`.");
-        process.exit(1);
-      }
-
-      const { provider } = await getClient(config);
-      const contract = new ethers.Contract(config.migrationRegistryAddress, MIGRATION_REGISTRY_ABI, provider);
-
-      const [activeWallet, migratedTo, migratedFrom] = await Promise.all([
-        contract.resolveActiveWallet(address),
-        contract.migratedTo(address),
-        contract.migratedFrom(address),
-      ]);
-
-      const isCurrent = activeWallet.toLowerCase() === address.toLowerCase();
-      const hasMigrated = migratedTo !== ethers.ZeroAddress;
-      const wasSource = migratedFrom !== ethers.ZeroAddress;
-
-      const payload = {
-        address,
-        activeWallet,
-        isCurrent,
-        migratedTo: hasMigrated ? migratedTo : null,
-        migratedFrom: wasSource ? migratedFrom : null,
-      };
-      if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-      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> ────────────────────────────────────────────
-
-  migrate
-    .command("lineage <address>")
-    .description("Print full migration lineage history with timestamps")
-    .option("--json")
-    .action(async (address, opts) => {
-      const config = loadConfig();
-      if (!config.migrationRegistryAddress) {
-        console.error("migrationRegistryAddress not configured. Run `arc402 config set migrationRegistryAddress <address>`.");
-        process.exit(1);
-      }
-
-      const { provider } = await getClient(config);
-      const contract = new ethers.Contract(config.migrationRegistryAddress, MIGRATION_REGISTRY_ABI, provider);
-
-      const lineage: string[] = await contract.getLineage(address);
-
-      if (lineage.length === 0) {
-        const payload = { address, lineage: [], migrations: 0 };
-        if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-        console.log(`address=${address}`);
-        console.log(`  no migration history`);
-        return;
-      }
-
-      // Fetch MigrationRegistered events for timestamps and decay info
-      interface MigrationEntry { step: number; from: string; to: string; timestamp: string | null; scoreAtMigration: string | null; decayBps: string | null }
-      const entries: MigrationEntry[] = [];
-
-      for (let i = 0; i < lineage.length - 1; i++) {
-        const from = lineage[i];
-        const to = lineage[i + 1];
-        let timestamp: string | null = null;
-        let scoreAtMigration: string | null = null;
-        let decayBps: string | null = null;
-
-        try {
-          const filter = contract.filters.MigrationRegistered(from, to);
-          const events = await contract.queryFilter(filter);
-          if (events.length > 0) {
-            const ev = events[0] as ethers.EventLog;
-            const block = await provider.getBlock(ev.blockNumber);
-            timestamp = block ? new Date(block.timestamp * 1000).toISOString() : null;
-            scoreAtMigration = ev.args[3]?.toString() ?? null;
-            decayBps = ev.args[4]?.toString() ?? null;
-          }
-        } catch {
-          // event query not critical — continue without timestamps
-        }
-
-        entries.push({ step: i + 1, from, to, timestamp, scoreAtMigration, decayBps });
-      }
-
-      const payload = {
-        address,
-        lineage,
-        migrations: entries.length,
-        history: entries,
-      };
-      if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-
-      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);
-    });
-}