coherence-cli 0.3.0 → 0.4.1

package/bin/cc.mjs

@@ -12,6 +12,7 @@ import { listSpecs, showSpec } from "../lib/commands/specs.mjs";
 import { contribute } from "../lib/commands/contribute.mjs";
 import { showStatus, showResonance } from "../lib/commands/status.mjs";
 import { showIdentity, linkIdentity, unlinkIdentity, lookupIdentity, setupIdentity, setIdentity } from "../lib/commands/identity.mjs";
+import { listNodes, sendMessage, readMessages } from "../lib/commands/nodes.mjs";
 
 const [command, ...args] = process.argv.slice(2);
 
@@ -27,6 +28,10 @@ const COMMANDS = {
   status:     () => showStatus(),
   resonance:  () => showResonance(),
   identity:   () => handleIdentity(args),
+  nodes:      () => listNodes(),
+  msg:        () => sendMessage(args),
+  messages:   () => readMessages(args),
+  inbox:      () => readMessages(args),
   help:       () => showHelp(),
 };
 
@@ -78,6 +83,11 @@ function showHelp() {
   identity unlink <p>     Unlink a provider
   identity lookup <p> <id> Find contributor by identity
 
+\x1b[1mFederation:\x1b[0m
+  nodes                   List federation nodes
+  msg <node|broadcast> <text>  Send message to a node
+  inbox                   Read your messages
+
 \x1b[1mProviders:\x1b[0m
   github, x, discord, telegram, mastodon, bluesky, linkedin, reddit,
   youtube, twitch, instagram, tiktok, gitlab, bitbucket, npm, crates,

package/lib/commands/nodes.mjs

@@ -0,0 +1,141 @@
+/**
+ * Federation node commands: nodes, msg, broadcast
+ */
+
+import { get, post } from "../api.mjs";
+import { hostname } from "node:os";
+
+export async function listNodes() {
+  const nodes = await get("/api/federation/nodes");
+  if (!nodes || !Array.isArray(nodes)) {
+    console.log("Could not fetch federation nodes.");
+    return;
+  }
+
+  console.log();
+  console.log("\x1b[1m  FEDERATION NODES\x1b[0m");
+  console.log(`  ${"─".repeat(50)}`);
+
+  const now = Date.now();
+  for (const node of nodes) {
+    const lastSeen = node.last_seen_at ? new Date(node.last_seen_at) : null;
+    const ageMs = lastSeen ? now - lastSeen.getTime() : Infinity;
+    const ageMin = Math.floor(ageMs / 60000);
+
+    // Status dot
+    let dot = "\x1b[31m●\x1b[0m"; // red
+    if (ageMin < 5) dot = "\x1b[32m●\x1b[0m"; // green
+    else if (ageMin < 60) dot = "\x1b[33m●\x1b[0m"; // yellow
+
+    // OS icon
+    const os = node.os_type || "?";
+    const icon = os === "macos" ? "🍎" : os === "windows" ? "🪟" : os === "linux" ? "🐧" : "🖥️";
+
+    // Providers
+    let providers = [];
+    try {
+      providers = typeof node.providers_json === "string"
+        ? JSON.parse(node.providers_json)
+        : (node.providers || []);
+    } catch { providers = []; }
+
+    const ago = ageMin < 1 ? "now" : ageMin < 60 ? `${ageMin}m ago` : `${Math.floor(ageMin / 60)}h ago`;
+
+    console.log(`  ${dot} ${icon}  \x1b[1m${node.hostname || "?"}\x1b[0m  ${ago}`);
+    console.log(`     ${providers.join(", ")}`);
+    console.log(`     id: ${node.node_id}`);
+    console.log();
+  }
+}
+
+export async function sendMessage(args) {
+  const [targetOrBroadcast, ...textParts] = args;
+  const text = textParts.join(" ");
+
+  if (!targetOrBroadcast || !text) {
+    console.log("Usage: cc msg <node_id|broadcast> <message text>");
+    console.log("  cc msg broadcast Hello all nodes!");
+    console.log("  cc msg e66ff3d35dd4ccb1 Hello Mac node!");
+    return;
+  }
+
+  // Determine our node ID from hostname
+  const myHost = hostname();
+  const nodes = await get("/api/federation/nodes");
+  let myNodeId = null;
+  if (Array.isArray(nodes)) {
+    const mine = nodes.find(n => n.hostname === myHost);
+    if (mine) myNodeId = mine.node_id;
+  }
+  if (!myNodeId) {
+    // Fallback: use first 16 chars of hostname hash
+    myNodeId = myHost;
+  }
+
+  if (targetOrBroadcast === "broadcast" || targetOrBroadcast === "all") {
+    const result = await post("/api/federation/broadcast", {
+      from_node: myNodeId,
+      to_node: null,
+      type: "text",
+      text,
+      payload: {},
+    });
+    if (result) {
+      console.log(`\x1b[32m✓\x1b[0m Broadcast sent: ${text.slice(0, 60)}`);
+    } else {
+      console.log("\x1b[31m✗\x1b[0m Failed to broadcast");
+    }
+  } else {
+    const result = await post(`/api/federation/nodes/${myNodeId}/messages`, {
+      from_node: myNodeId,
+      to_node: targetOrBroadcast,
+      type: "text",
+      text,
+      payload: {},
+    });
+    if (result) {
+      console.log(`\x1b[32m✓\x1b[0m Message sent to ${targetOrBroadcast.slice(0, 12)}: ${text.slice(0, 60)}`);
+    } else {
+      console.log("\x1b[31m✗\x1b[0m Failed to send message");
+    }
+  }
+}
+
+export async function readMessages(args) {
+  const myHost = hostname();
+  const nodes = await get("/api/federation/nodes");
+  let myNodeId = null;
+  if (Array.isArray(nodes)) {
+    const mine = nodes.find(n => n.hostname === myHost);
+    if (mine) myNodeId = mine.node_id;
+  }
+  if (!myNodeId) {
+    console.log("Could not determine your node ID. Register first.");
+    return;
+  }
+
+  const data = await get(`/api/federation/nodes/${myNodeId}/messages?unread_only=false&limit=20`);
+  if (!data || !data.messages) {
+    console.log("No messages.");
+    return;
+  }
+
+  console.log();
+  console.log("\x1b[1m  MESSAGES\x1b[0m");
+  console.log(`  ${"─".repeat(50)}`);
+
+  if (data.messages.length === 0) {
+    console.log("  No messages yet.");
+  }
+
+  for (const msg of data.messages) {
+    const ts = msg.timestamp ? new Date(msg.timestamp).toLocaleString() : "?";
+    const from = msg.from_node ? msg.from_node.slice(0, 12) : "?";
+    const type = msg.type || "text";
+    const unread = !msg.read_by?.includes(myNodeId) ? " \x1b[33m(new)\x1b[0m" : "";
+
+    console.log(`  \x1b[2m${ts}\x1b[0m  [${type}] from ${from}${unread}`);
+    console.log(`  ${msg.text || "(no text)"}`);
+    console.log();
+  }
+}

package/lib/commands/status.mjs

@@ -7,31 +7,137 @@ import { getContributorId, getHubUrl } from "../config.mjs";
 import { hostname } from "node:os";
 
 export async function showStatus() {
-  const health = await get("/api/health");
-  const ideas = await get("/api/ideas/count");
-  const nodes = await get("/api/federation/nodes");
+  // Fetch everything in parallel
+  const [health, ideas, nodes, pendingData, runningData, completedData, coherence, ledger, messages] =
+    await Promise.all([
+      get("/api/health"),
+      get("/api/ideas/count"),
+      get("/api/federation/nodes"),
+      get("/api/agent/tasks", { status: "pending", limit: 100 }),
+      get("/api/agent/tasks", { status: "running", limit: 100 }),
+      get("/api/agent/tasks", { status: "completed", limit: 5 }),
+      get("/api/coherence/score"),
+      getContributorId() ? get(`/api/contributions/ledger/${encodeURIComponent(getContributorId())}`) : null,
+      getContributorId() ? get(`/api/federation/nodes/${encodeURIComponent(getContributorId())}/messages`, { unread_only: true, limit: 10 }) : null,
+    ]);
+
+  const taskList = (d) => {
+    if (!d) return [];
+    if (Array.isArray(d)) return d;
+    return d.tasks || [];
+  };
+
+  const pending = taskList(pendingData);
+  const running = taskList(runningData);
+  const completed = taskList(completedData);
+
+  /** Extract a human-readable name from a task */
+  function _taskName(t) {
+    const ctx = t.context || {};
+    if (ctx.idea_name) return ctx.idea_name.slice(0, 45);
+    if (t.direction) {
+      // Extract the idea name from "Write a spec for: <name>." pattern
+      const match = t.direction.match(/for:\s*(.+?)[\.\n]/);
+      if (match) return match[1].slice(0, 45);
+      return t.direction.slice(0, 45);
+    }
+    return t.id?.slice(0, 20) || "?";
+  }
 
   console.log();
   console.log("\x1b[1m  COHERENCE NETWORK STATUS\x1b[0m");
-  console.log(`  ${"─".repeat(40)}`);
+  console.log(`  ${"─".repeat(50)}`);
 
+  // API health
   if (health) {
-    console.log(`  API:        \x1b[32m${health.status}\x1b[0m (${health.version || "?"})`);
-    console.log(`  Uptime:     ${health.uptime_human || "?"}`);
+    const schemaIcon = health.schema_ok === false ? "\x1b[31m✗\x1b[0m" : "\x1b[32m✓\x1b[0m";
+    console.log(`  API:         \x1b[32m${health.status}\x1b[0m (${health.version || "?"}) ${schemaIcon} schema`);
+    console.log(`  Uptime:      ${health.uptime_human || "?"}`);
   } else {
-    console.log(`  API:        \x1b[31moffline\x1b[0m`);
+    console.log(`  API:         \x1b[31moffline\x1b[0m`);
   }
 
-  console.log(`  Hub:        ${getHubUrl()}`);
-  console.log(`  Node:       ${hostname()}`);
-  console.log(`  Identity:   ${getContributorId() || "(not set — run: cc identity setup)"}`);
+  // Coherence score
+  if (coherence && coherence.score != null) {
+    const score = coherence.score.toFixed(2);
+    const color = coherence.score >= 0.7 ? "\x1b[32m" : coherence.score >= 0.4 ? "\x1b[33m" : "\x1b[31m";
+    console.log(`  Coherence:   ${color}${score}\x1b[0m (${coherence.signals_with_data || 0}/${coherence.total_signals || 0} signals)`);
+  }
+
+  console.log(`  Hub:         ${getHubUrl()}`);
+  console.log(`  Node:        ${hostname()}`);
+  console.log(`  Identity:    ${getContributorId() || "\x1b[33m(not set — run: cc identity set <id>)\x1b[0m"}`);
 
-  if (ideas?.count != null) {
-    console.log(`  Ideas:      ${ideas.count}`);
+  // Ideas
+  if (ideas) {
+    const byStatus = ideas.by_status || {};
+    console.log(`  Ideas:       ${ideas.total || 0} (${byStatus.validated || 0} validated, ${byStatus.none || 0} open)`);
   }
 
+  // Nodes
   if (Array.isArray(nodes) && nodes.length > 0) {
-    console.log(`  Fed. Nodes: ${nodes.length}`);
+    const now = Date.now();
+    const alive = nodes.filter((n) => {
+      const last = n.last_seen_at || n.last_heartbeat || n.registered_at || "";
+      if (!last) return false;
+      return now - new Date(last).getTime() < 600_000; // 10 min
+    });
+    console.log(`  Nodes:       ${nodes.length} registered (${alive.length} live)`);
+    for (const n of nodes) {
+      const last = n.last_seen_at || n.last_heartbeat || n.registered_at || "";
+      const ago = last ? Math.round((now - new Date(last).getTime()) / 60000) : 9999;
+      const icon = ago < 10 ? "\x1b[32m●\x1b[0m" : ago < 60 ? "\x1b[33m●\x1b[0m" : "\x1b[31m○\x1b[0m";
+      const agoStr = ago < 60 ? `${ago}m` : `${Math.round(ago / 60)}h`;
+      console.log(`    ${icon} ${(n.hostname || n.node_id || "?").slice(0, 20).padEnd(22)} ${(n.os_type || "?").padEnd(8)} ${agoStr} ago`);
+    }
+  }
+
+  // Pipeline
+  console.log();
+  console.log("\x1b[1m  PIPELINE\x1b[0m");
+  console.log(`  ${"─".repeat(50)}`);
+  console.log(`  Pending:     ${pending.length}`);
+  console.log(`  Running:     ${running.length}`);
+
+  if (running.length > 0) {
+    for (const t of running.slice(0, 3)) {
+      const name = _taskName(t);
+      const age = t.created_at ? Math.round((Date.now() - new Date(t.created_at).getTime()) / 60000) : 0;
+      const ageColor = age > 15 ? "\x1b[31m" : age > 5 ? "\x1b[33m" : "\x1b[32m";
+      console.log(`    \x1b[33m▸\x1b[0m ${(t.task_type || "?").padEnd(6)} ${ageColor}${age}m\x1b[0m  ${name}`);
+    }
+    if (running.length > 3) console.log(`    ... and ${running.length - 3} more`);
+  }
+
+  // Recent completions
+  if (completed.length > 0) {
+    console.log(`  Recent:      last ${completed.length} completed`);
+    for (const t of completed.slice(0, 3)) {
+      const name = _taskName(t);
+      console.log(`    \x1b[32m✓\x1b[0m ${t.task_type || "?"}  ${name}`);
+    }
+  }
+
+  // My ledger
+  if (ledger && ledger.balance) {
+    console.log();
+    console.log("\x1b[1m  MY LEDGER\x1b[0m");
+    console.log(`  ${"─".repeat(50)}`);
+    console.log(`  Total:       ${ledger.balance.grand_total || 0} CC`);
+    const types = ledger.balance.totals_by_type || {};
+    const sorted = Object.entries(types).sort((a, b) => b[1] - a[1]);
+    for (const [type, amount] of sorted) {
+      console.log(`    ${type.padEnd(14)} ${amount} CC`);
+    }
+  }
+
+  // Messages
+  if (messages && messages.count > 0) {
+    console.log();
+    console.log(`\x1b[33m  📬 ${messages.count} unread message(s)\x1b[0m`);
+    for (const m of (messages.messages || []).slice(0, 3)) {
+      console.log(`    from ${(m.from_node || "?").slice(0, 12)}: ${(m.text || "").slice(0, 60)}`);
+    }
   }
 
   console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coherence-cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Coherence Network CLI — trace ideas from inception to payout, with fair attribution, coherence scoring, and 37 identity providers. No signup needed.",
   "type": "module",
   "bin": {