coherence-cli 0.8.3 → 0.9.0

package/bin/cc.mjs

@@ -24,6 +24,9 @@ import { showFrictionReport, listFrictionEvents, showFrictionCategories } from "
 import { listProviders, showProviderStats } from "../lib/commands/providers.mjs";
 import { showTraceability, showCoverage, traceIdea, traceSpec } from "../lib/commands/traceability.mjs";
 import { showDiag, showDiagHealth, showDiagIssues, showDiagRunners, showDiagVisibility } from "../lib/commands/diagnostics.mjs";
+import { deploy } from "../lib/commands/deploy.mjs";
+import { listen } from "../lib/commands/listen.mjs";
+import { listTasks, showTask, claimTask, claimNext, reportTask, seedTask } from "../lib/commands/tasks.mjs";
 
 const [command, ...args] = process.argv.slice(2);
 
@@ -57,6 +60,10 @@ const COMMANDS = {
   providers:     () => handleProviders(args),
   trace:         () => handleTrace(args),
   diag:          () => handleDiag(args),
+  tasks:         () => listTasks(args),
+  task:          () => handleTask(args),
+  deploy:        () => deploy(args),
+  listen:        () => listen(args),
   help:          () => showHelp(),
 };
 
@@ -83,6 +90,17 @@ async function handleContributor(args) {
   return showContributor(args);
 }
 
+async function handleTask(args) {
+  const sub = args[0];
+  switch (sub) {
+    case "next":    return claimNext();
+    case "claim":   return claimTask(args.slice(1));
+    case "report":  return reportTask(args.slice(1));
+    case "seed":    return seedTask(args.slice(1));
+    default:        return showTask(args);
+  }
+}
+
 async function handleAsset(args) {
   if (args[0] === "create") return createAsset(args.slice(1));
   return showAsset(args);
@@ -216,6 +234,14 @@ function showHelp() {
   contributor <id>        View contributor detail
   contributor <id> contributions  View contributions
 
+\x1b[1mTasks (agent work protocol):\x1b[0m
+  tasks [status] [limit]  List tasks (pending, running, completed)
+  task <id>               View task detail
+  task next               Claim highest-priority pending task
+  task claim <id>         Claim a specific task
+  task report <id> <completed|failed> [output]  Report result
+  task seed <idea> [type] Create task from idea (spec|test|impl|review)
+
 \x1b[1mAssets:\x1b[0m
   assets [limit]          List assets
   asset <id>              View asset detail
@@ -274,6 +300,7 @@ function showHelp() {
   diag visibility         Agent visibility
 
 \x1b[2mHub: https://api.coherencycoin.com\x1b[0m
+\x1b[2mDocs: https://coherencycoin.com\x1b[0m
 `);
 }
 

package/lib/commands/assets.mjs

@@ -4,9 +4,21 @@
 
 import { get, post } from "../api.mjs";
 
+/** Truncate at word boundary, append "..." if needed */
 function truncate(str, len) {
   if (!str) return "";
-  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+  if (str.length <= len) return str;
+  const trimmed = str.slice(0, len - 3);
+  const lastSpace = trimmed.lastIndexOf(" ");
+  return (lastSpace > len * 0.4 ? trimmed.slice(0, lastSpace) : trimmed) + "...";
+}
+
+/** Colored type badge */
+function assetBadge(type) {
+  if (!type) return "\x1b[2m[?]\x1b[0m".padEnd(16);
+  const colors = { spec: "\x1b[36m", code: "\x1b[32m", doc: "\x1b[33m", test: "\x1b[35m", data: "\x1b[34m" };
+  const color = colors[type.toLowerCase()] || "\x1b[2m";
+  return `${color}[${type}]\x1b[0m`.padEnd(16);
 }
 
 export async function listAssets(args) {
@@ -24,11 +36,12 @@ export async function listAssets(args) {
 
   console.log();
   console.log(`\x1b[1m  ASSETS\x1b[0m (${data.length})`);
-  console.log(`  ${"─".repeat(60)}`);
+  console.log(`  ${"─".repeat(72)}`);
   for (const a of data) {
-    const name = truncate(a.name || a.description || a.id, 35);
-    const type = (a.type || a.asset_type || "").padEnd(12);
-    console.log(`  ${type} ${name}`);
+    const badge = assetBadge(a.type || a.asset_type);
+    const desc = truncate(a.name || a.description || a.id, 42).padEnd(44);
+    const cost = a.value != null ? String(a.value).padStart(8) : a.cost != null ? String(a.cost).padStart(8) : "";
+    console.log(`  ${badge} ${desc} ${cost}`);
   }
   console.log();
 }

package/lib/commands/contributors.mjs

@@ -4,9 +4,22 @@
 
 import { get } from "../api.mjs";
 
+/** Truncate at word boundary, append "..." if needed */
 function truncate(str, len) {
   if (!str) return "";
-  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+  if (str.length <= len) return str;
+  const trimmed = str.slice(0, len - 3);
+  const lastSpace = trimmed.lastIndexOf(" ");
+  return (lastSpace > len * 0.4 ? trimmed.slice(0, lastSpace) : trimmed) + "...";
+}
+
+/** Colored type badge */
+function typeBadge(type) {
+  if (!type) return "\x1b[2m[?]\x1b[0m".padEnd(17);
+  const upper = type.toUpperCase();
+  if (upper === "HUMAN") return "\x1b[36m[HUMAN]\x1b[0m".padEnd(18);
+  if (upper === "AGENT") return "\x1b[33m[AGENT]\x1b[0m".padEnd(18);
+  return `\x1b[2m[${upper}]\x1b[0m`.padEnd(18);
 }
 
 export async function listContributors(args) {
@@ -24,11 +37,12 @@ export async function listContributors(args) {
 
   console.log();
   console.log(`\x1b[1m  CONTRIBUTORS\x1b[0m (${data.length})`);
-  console.log(`  ${"─".repeat(60)}`);
+  console.log(`  ${"─".repeat(68)}`);
   for (const c of data) {
-    const name = truncate(c.name || c.display_name || c.id, 30);
-    const cc = c.total_cc != null ? `${c.total_cc} CC` : "";
-    console.log(`  ${name.padEnd(32)} ${cc}`);
+    const name = truncate(c.name || c.display_name || c.id, 30).padEnd(32);
+    const badge = typeBadge(c.type || c.role);
+    const cc = c.total_cc != null ? String(c.total_cc.toFixed ? c.total_cc.toFixed(1) : c.total_cc).padStart(8) + " CC" : "";
+    console.log(`  ${name} ${badge} ${cc}`);
   }
   console.log();
 }

package/lib/commands/deploy.mjs

@@ -0,0 +1,163 @@
+/**
+ * Deploy command: deploy latest main to VPS (coherencycoin.com)
+ *
+ * cc deploy         — deploy now (directly if SSH key available, otherwise via node message)
+ * cc deploy status  — check what SHA is deployed vs origin/main
+ */
+
+import { get, post } from "../api.mjs";
+import { existsSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { homedir, hostname as getHostname } from "node:os";
+import { join } from "node:path";
+
+const SSH_KEY = join(homedir(), ".ssh", "hostinger-openclaw");
+const VPS_HOST = "root@187.77.152.42";
+const REPO_DIR = "/docker/coherence-network/repo";
+const COMPOSE_DIR = "/docker/coherence-network";
+
+function ssh(cmd, timeout = 120000) {
+  return execSync(
+    `ssh -i "${SSH_KEY}" -o LogLevel=QUIET -o StrictHostKeyChecking=no ${VPS_HOST} '${cmd}'`,
+    { encoding: "utf-8", timeout },
+  ).trim();
+}
+
+export async function deploy(args) {
+  const sub = args[0];
+  if (sub === "status") return deployStatus();
+
+  console.log("\x1b[1m  DEPLOYING TO VPS\x1b[0m");
+  console.log(`  ${"─".repeat(50)}`);
+
+  // If this machine has SSH key, deploy directly — don't send a message to yourself
+  if (existsSync(SSH_KEY)) {
+    return deployDirect();
+  }
+
+  // No SSH key — ask a node that has one to deploy
+  return deployViaMessage();
+}
+
+async function deployDirect() {
+  console.log("  Deploying directly (SSH key found)...");
+  console.log();
+
+  try {
+    // 1. Capture current SHA
+    const prevSha = ssh(`cd ${REPO_DIR} && git rev-parse --short HEAD`, 15000);
+    console.log(`  Current VPS: ${prevSha}`);
+
+    // 2. Git pull
+    const pullOutput = ssh(`cd ${REPO_DIR} && git pull origin main --ff-only`, 30000);
+    const newSha = ssh(`cd ${REPO_DIR} && git rev-parse --short HEAD`, 15000);
+
+    if (newSha === prevSha) {
+      console.log(`  \x1b[32m✓\x1b[0m VPS already up to date at ${newSha}`);
+      await broadcast(`Deploy: VPS already at ${newSha}, no changes needed.`);
+      return;
+    }
+
+    console.log(`  Pulled: ${prevSha} → ${newSha}`);
+
+    // 3. Build + restart
+    console.log("  Building containers (this may take a minute)...");
+    ssh(`cd ${COMPOSE_DIR} && docker compose build --no-cache api web && docker compose up -d api web`, 300000);
+    console.log("  Containers restarted, waiting 30s for health check...");
+
+    // 4. Wait
+    await new Promise((r) => setTimeout(r, 30000));
+
+    // 5. Health check
+    const health = await get("/api/health");
+    if (health?.status === "ok" && health?.schema_ok) {
+      console.log(`  \x1b[32m✓\x1b[0m Deploy successful: ${prevSha} → ${newSha}`);
+      console.log(`  Health: OK | Schema: OK | Uptime: ${health.uptime_human || "?"}`);
+      await broadcast(`Deploy successful: ${prevSha} → ${newSha}. Health OK, schema OK.`);
+    } else {
+      // Rollback
+      console.log(`  \x1b[31m✗\x1b[0m Health check failed — rolling back to ${prevSha}`);
+      ssh(`cd ${REPO_DIR} && git checkout ${prevSha} && cd ${COMPOSE_DIR} && docker compose build --no-cache api web && docker compose up -d api web`, 300000);
+      console.log(`  Rolled back to ${prevSha}`);
+      await broadcast(`Deploy FAILED health check. Rolled back ${newSha} → ${prevSha}.`);
+    }
+  } catch (e) {
+    console.log(`  \x1b[31m✗\x1b[0m Deploy error: ${e.message}`);
+  }
+}
+
+async function deployViaMessage() {
+  console.log("  No SSH key on this machine — sending deploy command to a node that has one...");
+  console.log();
+
+  const nodes = await get("/api/federation/nodes");
+  if (!nodes || !Array.isArray(nodes)) {
+    console.log("  \x1b[31m✗\x1b[0m Could not fetch nodes");
+    return;
+  }
+
+  // Find any node that might have SSH (prefer macOS)
+  const target = nodes.find((n) => n.os_type === "macos") || nodes[0];
+  if (!target) {
+    console.log("  \x1b[31m✗\x1b[0m No nodes available");
+    return;
+  }
+
+  const myNodeId = nodes.find((n) => n.hostname === getHostname())?.node_id || "cli-user";
+
+  const result = await post(`/api/federation/nodes/${myNodeId}/messages`, {
+    from_node: myNodeId,
+    to_node: target.node_id,
+    type: "command",
+    text: "Deploy latest main to VPS",
+    payload: { command: "deploy" },
+  });
+
+  if (result?.id) {
+    console.log(`  \x1b[32m✓\x1b[0m Deploy command sent to ${target.hostname}`);
+    console.log("  Node will deploy on next poll (~2 min). Check: cc deploy status");
+  } else {
+    console.log("  \x1b[31m✗\x1b[0m Failed to send deploy command");
+  }
+}
+
+async function broadcast(text) {
+  try {
+    const nodes = await get("/api/federation/nodes");
+    const myNodeId = nodes?.find((n) => n.hostname === getHostname())?.node_id || "deployer";
+    await post(`/api/federation/broadcast`, {
+      from_node: myNodeId,
+      type: "deploy",
+      text,
+    });
+  } catch { /* best effort */ }
+}
+
+async function deployStatus() {
+  console.log("\x1b[1m  DEPLOY STATUS\x1b[0m");
+  console.log(`  ${"─".repeat(50)}`);
+
+  const health = await get("/api/health");
+  if (!health) {
+    console.log("  \x1b[31m✗\x1b[0m API unreachable");
+    return;
+  }
+
+  const deployedSha = health.deployed_sha || "unknown";
+  console.log(`  API:         ${health.status === "ok" ? "\x1b[32mok\x1b[0m" : "\x1b[31m" + health.status + "\x1b[0m"}`);
+  console.log(`  Deployed:    ${deployedSha.slice(0, 10)}`);
+  console.log(`  Schema:      ${health.schema_ok ? "\x1b[32m✓\x1b[0m" : "\x1b[31m✗\x1b[0m"}`);
+  console.log(`  Uptime:      ${health.uptime_human || "?"}`);
+
+  const nodes = await get("/api/federation/nodes");
+  if (nodes && Array.isArray(nodes)) {
+    console.log();
+    console.log("  Node SHAs:");
+    for (const n of nodes) {
+      const git = n.capabilities?.git || {};
+      const sha = (git.local_sha || "?").slice(0, 10);
+      const match = sha === deployedSha.slice(0, 10) ? "\x1b[32m✓\x1b[0m" : "\x1b[33m≠\x1b[0m";
+      console.log(`    ${match} ${(n.hostname || "?").padEnd(25)} ${sha}`);
+    }
+  }
+}

package/lib/commands/friction.mjs

@@ -4,9 +4,13 @@
 
 import { get } from "../api.mjs";
 
+/** Truncate at word boundary, append "..." if needed */
 function truncate(str, len) {
   if (!str) return "";
-  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+  if (str.length <= len) return str;
+  const trimmed = str.slice(0, len - 3);
+  const lastSpace = trimmed.lastIndexOf(" ");
+  return (lastSpace > len * 0.4 ? trimmed.slice(0, lastSpace) : trimmed) + "...";
 }
 
 export async function showFrictionReport() {
@@ -16,23 +20,53 @@ export async function showFrictionReport() {
     return;
   }
 
+  const total = data.total_friction ?? data.total_events ?? data.event_count ?? 0;
+  const days = data.period_days ?? data.days ?? 7;
+
   console.log();
   console.log(`\x1b[1m  FRICTION REPORT\x1b[0m`);
   console.log(`  ${"─".repeat(50)}`);
-  if (data.total_friction != null) console.log(`  Total:       ${data.total_friction}`);
-  if (data.top_categories && Array.isArray(data.top_categories)) {
-    console.log(`  Top categories:`);
-    for (const c of data.top_categories) {
-      const name = c.name || c.category || "?";
-      const count = c.count != null ? c.count : "?";
-      console.log(`    ${name.padEnd(25)} ${count}`);
+  console.log(`  \x1b[1m${total}\x1b[0m events in \x1b[1m${days}\x1b[0m days`);
+  console.log();
+
+  // Top block types as bar chart
+  const blockTypes = data.top_block_types || data.top_types || [];
+  if (Array.isArray(blockTypes) && blockTypes.length > 0) {
+    console.log(`  \x1b[1mTop Block Types\x1b[0m`);
+    const maxCount = Math.max(...blockTypes.map(b => b.count || 0), 1);
+    for (const b of blockTypes.slice(0, 8)) {
+      const name = (b.name || b.type || "?").padEnd(20);
+      const count = b.count || 0;
+      const barLen = Math.round((count / maxCount) * 20);
+      const bar = "\x1b[33m" + "\u2593".repeat(barLen) + "\u2591".repeat(20 - barLen) + "\x1b[0m";
+      console.log(`  ${name} ${bar} ${String(count).padStart(5)}`);
     }
+    console.log();
   }
-  // Fallback: print all keys
-  const shown = new Set(["total_friction", "top_categories"]);
+
+  // Top categories/stages as colored list
+  const categories = data.top_categories || data.top_stages || [];
+  if (Array.isArray(categories) && categories.length > 0) {
+    console.log(`  \x1b[1mTop Stages\x1b[0m`);
+    const stageColors = ["\x1b[31m", "\x1b[33m", "\x1b[36m", "\x1b[32m", "\x1b[35m"];
+    categories.forEach((c, i) => {
+      const name = c.name || c.category || c.stage || "?";
+      const count = c.count != null ? c.count : "?";
+      const color = stageColors[i % stageColors.length];
+      console.log(`  ${color}●\x1b[0m ${name.padEnd(25)} ${String(count).padStart(5)}`);
+    });
+    console.log();
+  }
+
+  // Remaining keys (excluding already shown)
+  const shown = new Set(["total_friction", "total_events", "event_count", "period_days", "days", "top_categories", "top_stages", "top_block_types", "top_types"]);
   for (const [key, val] of Object.entries(data)) {
     if (!shown.has(key) && val != null) {
-      console.log(`  ${key}: ${JSON.stringify(val)}`);
+      if (typeof val === "object") {
+        console.log(`  \x1b[2m${key}:\x1b[0m ${JSON.stringify(val)}`);
+      } else {
+        console.log(`  \x1b[2m${key}:\x1b[0m ${val}`);
+      }
     }
   }
   console.log();

package/lib/commands/governance.mjs

@@ -4,9 +4,22 @@
 
 import { get, post } from "../api.mjs";
 
+/** Truncate at word boundary, append "..." if needed */
 function truncate(str, len) {
   if (!str) return "";
-  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+  if (str.length <= len) return str;
+  const trimmed = str.slice(0, len - 3);
+  const lastSpace = trimmed.lastIndexOf(" ");
+  return (lastSpace > len * 0.4 ? trimmed.slice(0, lastSpace) : trimmed) + "...";
+}
+
+/** Colored status label */
+function statusLabel(status) {
+  const s = (status || "?").toLowerCase();
+  if (s === "approved") return "\x1b[32mapproved\x1b[0m";
+  if (s === "rejected") return "\x1b[31mrejected\x1b[0m";
+  if (s === "pending")  return "\x1b[33mpending\x1b[0m";
+  return `\x1b[2m${s}\x1b[0m`;
 }
 
 export async function listChangeRequests() {
@@ -23,12 +36,19 @@ export async function listChangeRequests() {
 
   console.log();
   console.log(`\x1b[1m  GOVERNANCE\x1b[0m (${data.length} change requests)`);
-  console.log(`  ${"─".repeat(60)}`);
+  console.log(`  ${"─".repeat(74)}`);
   for (const cr of data) {
     const status = cr.status || "?";
-    const dot = status === "approved" ? "\x1b[32m●\x1b[0m" : status === "rejected" ? "\x1b[31m●\x1b[0m" : "\x1b[33m●\x1b[0m";
-    const title = truncate(cr.title || cr.id, 45);
-    console.log(`  ${dot} ${title.padEnd(47)} ${status}`);
+    const dot = status === "approved" ? "\x1b[32m●\x1b[0m"
+      : status === "rejected" ? "\x1b[31m●\x1b[0m"
+      : "\x1b[33m●\x1b[0m";
+    const title = truncate(cr.title || cr.id, 35).padEnd(37);
+    const proposer = cr.proposer || cr.proposed_by || "";
+    const proposerStr = proposer ? truncate(proposer, 14).padEnd(16) : "".padEnd(16);
+    const votesFor = cr.votes_for != null ? cr.votes_for : 0;
+    const votesAgainst = cr.votes_against != null ? cr.votes_against : 0;
+    const votes = `\x1b[32m+${votesFor}\x1b[0m/\x1b[31m-${votesAgainst}\x1b[0m`;
+    console.log(`  ${dot} ${title} ${proposerStr} ${votes}  ${statusLabel(status)}`);
   }
   console.log();
 }

package/lib/commands/ideas.mjs

@@ -7,9 +7,19 @@ import { ensureIdentity } from "../identity.mjs";
 import { createInterface } from "node:readline/promises";
 import { stdin, stdout } from "node:process";
 
+/** Truncate at word boundary, append "..." if needed */
 function truncate(str, len) {
   if (!str) return "";
-  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+  if (str.length <= len) return str;
+  const trimmed = str.slice(0, len - 3);
+  const lastSpace = trimmed.lastIndexOf(" ");
+  return (lastSpace > len * 0.4 ? trimmed.slice(0, lastSpace) : trimmed) + "...";
+}
+
+/** Mini bar: filled vs empty blocks for a score out of max */
+function miniBar(value, max, width = 5) {
+  const filled = Math.round((value / max) * width);
+  return "\u2593".repeat(Math.min(filled, width)) + "\u2591".repeat(width - Math.min(filled, width));
 }
 
 export async function listIdeas(args) {
@@ -28,14 +38,20 @@ export async function listIdeas(args) {
 
   console.log();
   console.log(`\x1b[1m  IDEAS\x1b[0m (${data.length})`);
-  console.log(`  ${"─".repeat(72)}`);
+  console.log(`  ${"─".repeat(74)}`);
   for (const idea of data) {
-    const status = idea.manifestation_status || "NONE";
-    const dot = status === "VALIDATED" ? "\x1b[32m●\x1b[0m" : status === "PARTIAL" ? "\x1b[33m●\x1b[0m" : "\x1b[2m○\x1b[0m";
-    const roi = idea.roi_cc != null ? `ROI ${idea.roi_cc.toFixed(1)}` : "";
-    const fe = idea.free_energy_score != null ? `FE ${idea.free_energy_score.toFixed(2)}` : "";
-    console.log(`  ${dot} ${truncate(idea.name || idea.id, 40).padEnd(42)} ${roi.padEnd(12)} ${fe}`);
+    const status = (idea.manifestation_status || "NONE").toUpperCase();
+    const dot = status === "VALIDATED" ? "\x1b[32m●\x1b[0m"
+      : status === "PARTIAL" ? "\x1b[33m●\x1b[0m"
+      : "\x1b[2m○\x1b[0m";
+    const name = truncate(idea.name || idea.id, 45).padEnd(47);
+    const roi = idea.roi_cc != null ? String(idea.roi_cc.toFixed(1)).padStart(6) : "     -";
+    const fe = idea.free_energy_score != null ? idea.free_energy_score.toFixed(2) : null;
+    const feStr = fe != null ? `${String(fe).padStart(5)} ${miniBar(idea.free_energy_score, 20)}` : "";
+    console.log(`  ${dot} ${name} ${roi}  ${feStr}`);
   }
+  console.log(`  ${"─".repeat(74)}`);
+  console.log(`\x1b[2m  ${"Name".padEnd(49)} ${"ROI".padStart(6)}  ${"FE".padStart(5)}\x1b[0m`);
   console.log();
 }
 
@@ -52,7 +68,7 @@ export async function showIdea(args) {
   }
   console.log();
   console.log(`\x1b[1m  ${data.name || data.id}\x1b[0m`);
-  if (data.description) console.log(`  ${truncate(data.description, 72)}`);
+  if (data.description) console.log(`  \x1b[2m${truncate(data.description, 72)}\x1b[0m`);
   console.log(`  ${"─".repeat(50)}`);
   console.log(`  Status:      ${data.manifestation_status || "NONE"}`);
   console.log(`  Potential:    ${data.potential_value ?? "?"}`);

package/lib/commands/lineage.mjs

@@ -4,9 +4,13 @@
 
 import { get, post } from "../api.mjs";
 
+/** Truncate at word boundary, append "..." if needed */
 function truncate(str, len) {
   if (!str) return "";
-  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+  if (str.length <= len) return str;
+  const trimmed = str.slice(0, len - 3);
+  const lastSpace = trimmed.lastIndexOf(" ");
+  return (lastSpace > len * 0.4 ? trimmed.slice(0, lastSpace) : trimmed) + "...";
 }
 
 export async function listLinks(args) {
@@ -24,12 +28,14 @@ export async function listLinks(args) {
 
   console.log();
   console.log(`\x1b[1m  VALUE LINEAGE\x1b[0m (${data.length})`);
-  console.log(`  ${"─".repeat(60)}`);
+  console.log(`  ${"─".repeat(74)}`);
   for (const link of data) {
-    const from = truncate(link.from_id || link.source || "?", 20);
-    const to = truncate(link.to_id || link.target || "?", 20);
-    const weight = link.weight != null ? `w=${link.weight.toFixed(2)}` : "";
-    console.log(`  ${from.padEnd(22)} \x1b[2m→\x1b[0m ${to.padEnd(22)} ${weight}`);
+    const ideaId = truncate(link.idea_id || link.from_id || link.source || "?", 18).padEnd(20);
+    const specId = truncate(link.spec_id || link.to_id || link.target || "?", 18).padEnd(20);
+    const contributor = truncate(link.contributor || link.contributor_id || "", 14).padEnd(16);
+    const cost = link.estimated_cost != null ? String(link.estimated_cost.toFixed ? link.estimated_cost.toFixed(1) : link.estimated_cost).padStart(7)
+      : link.weight != null ? String(link.weight.toFixed(2)).padStart(7) : "";
+    console.log(`  ${ideaId} \x1b[2m->\x1b[0m ${specId} \x1b[2m${contributor}\x1b[0m ${cost}`);
   }
   console.log();
 }

package/lib/commands/listen.mjs

@@ -0,0 +1,106 @@
+/**
+ * cc listen — real-time event stream from the network
+ *
+ * Connects to the SSE endpoint and prints events as they arrive.
+ * Messages, deploys, task completions, status changes — all pushed in real-time.
+ *
+ * Usage:
+ *   cc listen              # Listen for events for this node
+ *   cc listen --all        # Listen for all events (broadcast)
+ */
+
+import { hostname } from "node:os";
+import { get } from "../api.mjs";
+
+const API_BASE = process.env.COHERENCE_API_URL || "https://api.coherencycoin.com";
+
+export async function listen(args) {
+  // Resolve our node ID
+  const nodes = await get("/api/federation/nodes");
+  const myNode = nodes?.find((n) => n.hostname === hostname());
+  const nodeId = myNode?.node_id || "unknown";
+
+  if (nodeId === "unknown") {
+    console.log("\x1b[31m✗\x1b[0m Could not resolve node ID. Is the runner registered?");
+    return;
+  }
+
+  const url = `${API_BASE}/api/federation/nodes/${nodeId}/stream`;
+
+  console.log("\x1b[1m  LISTENING\x1b[0m");
+  console.log(`  ${"─".repeat(50)}`);
+  console.log(`  Node:   ${myNode.hostname} (${nodeId.slice(0, 12)})`);
+  console.log(`  Stream: ${url}`);
+  console.log(`  Press Ctrl+C to stop`);
+  console.log();
+
+  try {
+    const response = await fetch(url, {
+      headers: { Accept: "text/event-stream" },
+      signal: AbortSignal.timeout(3600000), // 1 hour max
+    });
+
+    if (!response.ok) {
+      console.log(`\x1b[31m✗\x1b[0m Stream error: HTTP ${response.status}`);
+      return;
+    }
+
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+
+      for (const line of lines) {
+        if (line.startsWith("data: ")) {
+          try {
+            const event = JSON.parse(line.slice(6));
+            formatEvent(event);
+          } catch {
+            // Not JSON — skip
+          }
+        }
+      }
+    }
+  } catch (e) {
+    if (e.name === "AbortError") {
+      console.log("\n  Stream timed out after 1 hour.");
+    } else {
+      console.log(`\n\x1b[31m✗\x1b[0m Stream error: ${e.message}`);
+    }
+  }
+}
+
+function formatEvent(event) {
+  const ts = new Date().toLocaleTimeString();
+  const type = event.event_type || event.type || "?";
+
+  switch (type) {
+    case "connected":
+      console.log(`  \x1b[32m●\x1b[0m \x1b[2m${ts}\x1b[0m Connected to stream`);
+      break;
+    case "text":
+    case "command":
+    case "command_response":
+      console.log(`  \x1b[33m◆\x1b[0m \x1b[2m${ts}\x1b[0m [${type}] from ${(event.from_node || "?").slice(0, 12)}`);
+      console.log(`    ${event.text || "(no text)"}`);
+      break;
+    case "deploy":
+      console.log(`  \x1b[36m▲\x1b[0m \x1b[2m${ts}\x1b[0m DEPLOY: ${event.text || "?"}`);
+      break;
+    case "task_completed":
+      console.log(`  \x1b[32m✓\x1b[0m \x1b[2m${ts}\x1b[0m Task completed: ${event.task_type || "?"} — ${event.idea_name || "?"}`);
+      break;
+    case "task_failed":
+      console.log(`  \x1b[31m✗\x1b[0m \x1b[2m${ts}\x1b[0m Task failed: ${event.task_type || "?"} — ${event.error || "?"}`);
+      break;
+    default:
+      console.log(`  \x1b[2m${ts}\x1b[0m [${type}] ${JSON.stringify(event).slice(0, 100)}`);
+  }
+}