coherence-cli 0.7.1 → 0.8.1

package/lib/commands/friction.mjs

@@ -0,0 +1,86 @@
+/**
+ * Friction commands: friction, friction events, friction categories
+ */
+
+import { get } from "../api.mjs";
+
+function truncate(str, len) {
+  if (!str) return "";
+  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+}
+
+export async function showFrictionReport() {
+  const data = await get("/api/friction/report");
+  if (!data) {
+    console.log("Could not fetch friction report.");
+    return;
+  }
+
+  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}`);
+    }
+  }
+  // Fallback: print all keys
+  const shown = new Set(["total_friction", "top_categories"]);
+  for (const [key, val] of Object.entries(data)) {
+    if (!shown.has(key) && val != null) {
+      console.log(`  ${key}: ${JSON.stringify(val)}`);
+    }
+  }
+  console.log();
+}
+
+export async function listFrictionEvents(args) {
+  const limit = parseInt(args[0]) || 20;
+  const raw = await get("/api/friction/events", { limit });
+  const data = Array.isArray(raw) ? raw : raw?.events;
+  if (!data || !Array.isArray(data)) {
+    console.log("Could not fetch friction events.");
+    return;
+  }
+  if (data.length === 0) {
+    console.log("No friction events found.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  FRICTION EVENTS\x1b[0m (${data.length})`);
+  console.log(`  ${"─".repeat(60)}`);
+  for (const e of data) {
+    const desc = truncate(e.description || e.type || e.id || "?", 45);
+    const category = (e.category || "").padEnd(15);
+    console.log(`  ${category} ${desc}`);
+  }
+  console.log();
+}
+
+export async function showFrictionCategories() {
+  const raw = await get("/api/friction/categories");
+  const data = Array.isArray(raw) ? raw : raw?.categories;
+  if (!data || !Array.isArray(data)) {
+    console.log("Could not fetch friction categories.");
+    return;
+  }
+  if (data.length === 0) {
+    console.log("No friction categories found.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  FRICTION CATEGORIES\x1b[0m (${data.length})`);
+  console.log(`  ${"─".repeat(50)}`);
+  for (const c of data) {
+    const name = typeof c === "string" ? c : c.name || c.category || "?";
+    const count = typeof c === "object" && c.count != null ? `(${c.count})` : "";
+    console.log(`  ${name} ${count}`);
+  }
+  console.log();
+}

package/lib/commands/governance.mjs

@@ -0,0 +1,90 @@
+/**
+ * Governance commands: governance, governance vote, governance propose
+ */
+
+import { get, post } from "../api.mjs";
+
+function truncate(str, len) {
+  if (!str) return "";
+  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+}
+
+export async function listChangeRequests() {
+  const raw = await get("/api/governance/change-requests");
+  const data = Array.isArray(raw) ? raw : raw?.change_requests || raw?.items;
+  if (!data || !Array.isArray(data)) {
+    console.log("Could not fetch change requests.");
+    return;
+  }
+  if (data.length === 0) {
+    console.log("No change requests found.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  GOVERNANCE\x1b[0m (${data.length} change requests)`);
+  console.log(`  ${"─".repeat(60)}`);
+  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}`);
+  }
+  console.log();
+}
+
+export async function showChangeRequest(args) {
+  const id = args[0];
+  if (!id) {
+    console.log("Usage: cc governance <id>");
+    return;
+  }
+  const data = await get(`/api/governance/change-requests/${encodeURIComponent(id)}`);
+  if (!data) {
+    console.log(`Change request '${id}' not found.`);
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  ${data.title || data.id}\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (data.id) console.log(`  ID:          ${data.id}`);
+  if (data.status) console.log(`  Status:      ${data.status}`);
+  if (data.description) console.log(`  Description: ${truncate(data.description, 60)}`);
+  if (data.votes_for != null) console.log(`  Votes For:   ${data.votes_for}`);
+  if (data.votes_against != null) console.log(`  Against:     ${data.votes_against}`);
+  if (data.created_at) console.log(`  Created:     ${data.created_at}`);
+  console.log();
+}
+
+export async function vote(args) {
+  const id = args[0];
+  const choice = args[1];
+  if (!id || !choice || !["yes", "no"].includes(choice)) {
+    console.log("Usage: cc governance vote <id> <yes|no>");
+    return;
+  }
+  const result = await post(`/api/governance/change-requests/${encodeURIComponent(id)}/votes`, {
+    vote: choice,
+  });
+  if (result) {
+    console.log(`\x1b[32m✓\x1b[0m Vote '${choice}' recorded on ${id}`);
+  } else {
+    console.log("Vote failed.");
+  }
+}
+
+export async function propose(args) {
+  const title = args[0];
+  const desc = args.slice(1).join(" ");
+  if (!title || !desc) {
+    console.log("Usage: cc governance propose <title> <description>");
+    return;
+  }
+  const result = await post("/api/governance/change-requests", { title, description: desc });
+  if (result) {
+    console.log(`\x1b[32m✓\x1b[0m Proposal created: ${result.id || title}`);
+  } else {
+    console.log("Failed to create proposal.");
+  }
+}

package/lib/commands/lineage.mjs

@@ -0,0 +1,101 @@
+/**
+ * Lineage commands: lineage, lineage valuation, lineage payout
+ */
+
+import { get, post } from "../api.mjs";
+
+function truncate(str, len) {
+  if (!str) return "";
+  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+}
+
+export async function listLinks(args) {
+  const limit = parseInt(args[0]) || 20;
+  const raw = await get("/api/value-lineage/links", { limit });
+  const data = Array.isArray(raw) ? raw : raw?.links;
+  if (!data || !Array.isArray(data)) {
+    console.log("Could not fetch lineage links.");
+    return;
+  }
+  if (data.length === 0) {
+    console.log("No lineage links found.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  VALUE LINEAGE\x1b[0m (${data.length})`);
+  console.log(`  ${"─".repeat(60)}`);
+  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}`);
+  }
+  console.log();
+}
+
+export async function showLink(args) {
+  const id = args[0];
+  if (!id) {
+    console.log("Usage: cc lineage <id>");
+    return;
+  }
+  const data = await get(`/api/value-lineage/links/${encodeURIComponent(id)}`);
+  if (!data) {
+    console.log(`Link '${id}' not found.`);
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  LINEAGE LINK\x1b[0m ${data.id || id}`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (data.from_id || data.source) console.log(`  From:        ${data.from_id || data.source}`);
+  if (data.to_id || data.target) console.log(`  To:          ${data.to_id || data.target}`);
+  if (data.weight != null) console.log(`  Weight:      ${data.weight}`);
+  if (data.type) console.log(`  Type:        ${data.type}`);
+  if (data.created_at) console.log(`  Created:     ${data.created_at}`);
+  console.log();
+}
+
+export async function showValuation(args) {
+  const id = args[0];
+  if (!id) {
+    console.log("Usage: cc lineage <id> valuation");
+    return;
+  }
+  const data = await get(`/api/value-lineage/links/${encodeURIComponent(id)}/valuation`);
+  if (!data) {
+    console.log(`No valuation for link '${id}'.`);
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  VALUATION\x1b[0m for ${id}`);
+  console.log(`  ${"─".repeat(50)}`);
+  for (const [key, val] of Object.entries(data)) {
+    console.log(`  ${key}: ${JSON.stringify(val)}`);
+  }
+  console.log();
+}
+
+export async function payoutPreview(args) {
+  const id = args[0];
+  const amount = parseFloat(args[1]);
+  if (!id || isNaN(amount)) {
+    console.log("Usage: cc lineage <id> payout <amount>");
+    return;
+  }
+  const data = await post(`/api/value-lineage/links/${encodeURIComponent(id)}/payout-preview`, { amount });
+  if (!data) {
+    console.log("Payout preview failed.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  PAYOUT PREVIEW\x1b[0m for ${id}`);
+  console.log(`  ${"─".repeat(50)}`);
+  for (const [key, val] of Object.entries(data)) {
+    console.log(`  ${key}: ${JSON.stringify(val)}`);
+  }
+  console.log();
+}

package/lib/commands/news.mjs

@@ -0,0 +1,121 @@
+/**
+ * News commands: news, news trending, news sources, news resonance
+ */
+
+import { get, post } from "../api.mjs";
+
+function truncate(str, len) {
+  if (!str) return "";
+  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+}
+
+export async function showNewsFeed() {
+  const data = await get("/api/news/feed");
+  const items = Array.isArray(data) ? data : data?.items || data?.articles;
+  if (!items || !Array.isArray(items)) {
+    console.log("Could not fetch news feed.");
+    return;
+  }
+  if (items.length === 0) {
+    console.log("No news items.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  NEWS FEED\x1b[0m (${items.length})`);
+  console.log(`  ${"─".repeat(60)}`);
+  for (const item of items) {
+    const title = truncate(item.title || item.headline || "?", 55);
+    const source = item.source ? `\x1b[2m${truncate(item.source, 15)}\x1b[0m` : "";
+    console.log(`  ${title}  ${source}`);
+  }
+  console.log();
+}
+
+export async function showTrending() {
+  const data = await get("/api/news/trending");
+  const items = Array.isArray(data) ? data : data?.trending || data?.items;
+  if (!items || !Array.isArray(items)) {
+    console.log("Could not fetch trending news.");
+    return;
+  }
+  if (items.length === 0) {
+    console.log("Nothing trending right now.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  TRENDING\x1b[0m (${items.length})`);
+  console.log(`  ${"─".repeat(60)}`);
+  for (const item of items) {
+    const title = truncate(item.title || item.headline || "?", 55);
+    console.log(`  \x1b[33m~\x1b[0m ${title}`);
+  }
+  console.log();
+}
+
+export async function showSources() {
+  const data = await get("/api/news/sources");
+  const sources = Array.isArray(data) ? data : data?.sources;
+  if (!sources || !Array.isArray(sources)) {
+    console.log("Could not fetch news sources.");
+    return;
+  }
+  if (sources.length === 0) {
+    console.log("No news sources configured.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  NEWS SOURCES\x1b[0m (${sources.length})`);
+  console.log(`  ${"─".repeat(60)}`);
+  for (const s of sources) {
+    const name = truncate(s.name || s.url || "?", 30);
+    const url = s.url ? `\x1b[2m${truncate(s.url, 40)}\x1b[0m` : "";
+    console.log(`  ${name.padEnd(32)} ${url}`);
+  }
+  console.log();
+}
+
+export async function addSource(args) {
+  const url = args[0];
+  const name = args.slice(1).join(" ");
+  if (!url || !name) {
+    console.log("Usage: cc news source add <url> <name>");
+    return;
+  }
+  const result = await post("/api/news/sources", { url, name });
+  if (result) {
+    console.log(`\x1b[32m✓\x1b[0m Source added: ${result.name || name}`);
+  } else {
+    console.log("Failed to add source.");
+  }
+}
+
+export async function showNewsResonance(args) {
+  const contributor = args[0];
+  const path = contributor
+    ? `/api/news/resonance/${encodeURIComponent(contributor)}`
+    : "/api/news/resonance";
+  const data = await get(path);
+  if (!data) {
+    console.log("Could not fetch news resonance.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  NEWS RESONANCE\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (Array.isArray(data)) {
+    for (const item of data.slice(0, 15)) {
+      const name = item.title || item.topic || item.id || "?";
+      const score = item.score != null ? `\x1b[32m${item.score.toFixed(2)}\x1b[0m` : "";
+      console.log(`  ${truncate(name, 45).padEnd(47)} ${score}`);
+    }
+  } else if (typeof data === "object") {
+    for (const [key, val] of Object.entries(data)) {
+      console.log(`  ${key}: ${JSON.stringify(val)}`);
+    }
+  }
+  console.log();
+}

package/lib/commands/providers.mjs

@@ -0,0 +1,57 @@
+/**
+ * Providers commands: providers, providers stats
+ */
+
+import { get } from "../api.mjs";
+
+function truncate(str, len) {
+  if (!str) return "";
+  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+}
+
+export async function listProviders() {
+  const raw = await get("/api/providers");
+  const data = Array.isArray(raw) ? raw : raw?.providers;
+  if (!data || !Array.isArray(data)) {
+    console.log("Could not fetch providers.");
+    return;
+  }
+  if (data.length === 0) {
+    console.log("No providers found.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  PROVIDERS\x1b[0m (${data.length})`);
+  console.log(`  ${"─".repeat(50)}`);
+  for (const p of data) {
+    const name = truncate(p.name || p.id || "?", 30);
+    const type = (p.type || p.category || "").padEnd(15);
+    console.log(`  ${type} ${name}`);
+  }
+  console.log();
+}
+
+export async function showProviderStats() {
+  const data = await get("/api/providers/stats");
+  if (!data) {
+    console.log("Could not fetch provider stats.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  PROVIDER STATS\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (Array.isArray(data)) {
+    for (const p of data) {
+      const name = (p.name || p.provider || "?").padEnd(20);
+      const count = p.count != null ? `${p.count} uses` : "";
+      console.log(`  ${name} ${count}`);
+    }
+  } else if (typeof data === "object") {
+    for (const [key, val] of Object.entries(data)) {
+      console.log(`  ${key}: ${JSON.stringify(val)}`);
+    }
+  }
+  console.log();
+}

package/lib/commands/services.mjs

@@ -0,0 +1,106 @@
+/**
+ * Services commands: services, service, services health, services deps
+ */
+
+import { get } from "../api.mjs";
+
+function truncate(str, len) {
+  if (!str) return "";
+  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+}
+
+export async function listServices() {
+  const raw = await get("/api/services");
+  const data = Array.isArray(raw) ? raw : raw?.services;
+  if (!data || !Array.isArray(data)) {
+    console.log("Could not fetch services.");
+    return;
+  }
+  if (data.length === 0) {
+    console.log("No services found.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  SERVICES\x1b[0m (${data.length})`);
+  console.log(`  ${"─".repeat(60)}`);
+  for (const s of data) {
+    const name = truncate(s.name || s.id, 30);
+    const status = s.status || "?";
+    const dot = status === "healthy" || status === "up" ? "\x1b[32m●\x1b[0m" : status === "degraded" ? "\x1b[33m●\x1b[0m" : "\x1b[31m●\x1b[0m";
+    console.log(`  ${dot} ${name.padEnd(32)} ${status}`);
+  }
+  console.log();
+}
+
+export async function showService(args) {
+  const id = args[0];
+  if (!id) {
+    console.log("Usage: cc service <id>");
+    return;
+  }
+  const data = await get(`/api/services/${encodeURIComponent(id)}`);
+  if (!data) {
+    console.log(`Service '${id}' not found.`);
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  ${data.name || data.id}\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (data.id) console.log(`  ID:          ${data.id}`);
+  if (data.status) console.log(`  Status:      ${data.status}`);
+  if (data.version) console.log(`  Version:     ${data.version}`);
+  if (data.url) console.log(`  URL:         ${data.url}`);
+  if (data.uptime) console.log(`  Uptime:      ${data.uptime}`);
+  console.log();
+}
+
+export async function showServicesHealth() {
+  const data = await get("/api/services/health");
+  if (!data) {
+    console.log("Could not fetch services health.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  SERVICES HEALTH\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (Array.isArray(data)) {
+    for (const s of data) {
+      const name = truncate(s.name || s.id, 25);
+      const status = s.status || s.health || "?";
+      const dot = status === "healthy" || status === "up" ? "\x1b[32m●\x1b[0m" : "\x1b[31m●\x1b[0m";
+      console.log(`  ${dot} ${name.padEnd(27)} ${status}`);
+    }
+  } else if (typeof data === "object") {
+    for (const [key, val] of Object.entries(data)) {
+      console.log(`  ${key}: ${JSON.stringify(val)}`);
+    }
+  }
+  console.log();
+}
+
+export async function showServicesDeps() {
+  const data = await get("/api/services/dependencies");
+  if (!data) {
+    console.log("Could not fetch service dependencies.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  SERVICE DEPENDENCIES\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (Array.isArray(data)) {
+    for (const d of data) {
+      const from = truncate(d.from || d.service || "?", 20);
+      const to = truncate(d.to || d.depends_on || "?", 20);
+      console.log(`  ${from.padEnd(22)} \x1b[2m→\x1b[0m ${to}`);
+    }
+  } else if (typeof data === "object") {
+    for (const [key, val] of Object.entries(data)) {
+      console.log(`  ${key}: ${JSON.stringify(val)}`);
+    }
+  }
+  console.log();
+}

package/lib/commands/traceability.mjs

@@ -0,0 +1,107 @@
+/**
+ * Traceability commands: trace, trace coverage, trace idea, trace spec
+ */
+
+import { get } from "../api.mjs";
+
+function truncate(str, len) {
+  if (!str) return "";
+  return str.length > len ? str.slice(0, len - 1) + "\u2026" : str;
+}
+
+export async function showTraceability() {
+  const data = await get("/api/traceability");
+  if (!data) {
+    console.log("Could not fetch traceability.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  TRACEABILITY\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  for (const [key, val] of Object.entries(data)) {
+    console.log(`  ${key}: ${JSON.stringify(val)}`);
+  }
+  console.log();
+}
+
+export async function showCoverage() {
+  const data = await get("/api/traceability/coverage");
+  if (!data) {
+    console.log("Could not fetch traceability coverage.");
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  TRACEABILITY COVERAGE\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (data.coverage != null) {
+    const pct = typeof data.coverage === "number" ? `${(data.coverage * 100).toFixed(1)}%` : data.coverage;
+    console.log(`  Coverage:    ${pct}`);
+  }
+  for (const [key, val] of Object.entries(data)) {
+    if (key !== "coverage") console.log(`  ${key}: ${JSON.stringify(val)}`);
+  }
+  console.log();
+}
+
+export async function traceIdea(args) {
+  const id = args[0];
+  if (!id) {
+    console.log("Usage: cc trace idea <id>");
+    return;
+  }
+  const data = await get(`/api/traceability/idea/${encodeURIComponent(id)}`);
+  if (!data) {
+    console.log(`No traceability data for idea '${id}'.`);
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  TRACE: IDEA\x1b[0m ${id}`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (data.specs && Array.isArray(data.specs)) {
+    console.log(`  Linked specs: ${data.specs.length}`);
+    for (const s of data.specs) {
+      console.log(`    ${truncate(s.id || s.name || JSON.stringify(s), 50)}`);
+    }
+  }
+  if (data.contributions && Array.isArray(data.contributions)) {
+    console.log(`  Contributions: ${data.contributions.length}`);
+  }
+  // Fallback
+  const shown = new Set(["specs", "contributions"]);
+  for (const [key, val] of Object.entries(data)) {
+    if (!shown.has(key)) console.log(`  ${key}: ${JSON.stringify(val)}`);
+  }
+  console.log();
+}
+
+export async function traceSpec(args) {
+  const id = args[0];
+  if (!id) {
+    console.log("Usage: cc trace spec <id>");
+    return;
+  }
+  const data = await get(`/api/traceability/spec/${encodeURIComponent(id)}`);
+  if (!data) {
+    console.log(`No traceability data for spec '${id}'.`);
+    return;
+  }
+
+  console.log();
+  console.log(`\x1b[1m  TRACE: SPEC\x1b[0m ${id}`);
+  console.log(`  ${"─".repeat(50)}`);
+  if (data.ideas && Array.isArray(data.ideas)) {
+    console.log(`  Linked ideas: ${data.ideas.length}`);
+    for (const i of data.ideas) {
+      console.log(`    ${truncate(i.id || i.name || JSON.stringify(i), 50)}`);
+    }
+  }
+  // Fallback
+  const shown = new Set(["ideas"]);
+  for (const [key, val] of Object.entries(data)) {
+    if (!shown.has(key)) console.log(`  ${key}: ${JSON.stringify(val)}`);
+  }
+  console.log();
+}