@neat.is/core 0.9.18-dev.20260918 → 0.9.19

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   resolveNeatVersion,
   startK8sSubstratePolling,
   writeDaemonRecord
-} from "./chunk-MGQSR6QZ.js";
+} from "./chunk-NTVHVZYC.js";
 import {
   buildSearchIndex
 } from "./chunk-BC53SCT7.js";
@@ -99,6 +99,107 @@ import { promises as fs16 } from "fs";
 import path from "path";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
+
+// src/style.ts
+import { Provenance } from "@neat.is/types";
+var RESET = "\x1B[0m";
+function computeEnabled(env = process.env) {
+  if (env.FORCE_COLOR !== void 0 && env.FORCE_COLOR !== "0" && env.FORCE_COLOR !== "") {
+    return true;
+  }
+  if (env.NO_COLOR !== void 0) return false;
+  if (env.TERM === "dumb") return false;
+  return Boolean(process.stdout && process.stdout.isTTY);
+}
+var enabled = computeEnabled();
+function wrap(open, s) {
+  return enabled ? `${open}${s}${RESET}` : s;
+}
+var bold = (s) => wrap("\x1B[1m", s);
+var dim = (s) => wrap("\x1B[2m", s);
+var OBSERVED_GREEN = "\x1B[38;2;95;207;158m";
+var STALE_AMBER = "\x1B[38;2;214;164;92m";
+var ERROR_RED = "\x1B[38;2;224;108;108m";
+var INFERRED_CYAN = "\x1B[38;2;122;162;247m";
+var green = (s) => wrap(OBSERVED_GREEN, s);
+var amber = (s) => wrap(STALE_AMBER, s);
+var red = (s) => wrap(ERROR_RED, s);
+var cyan = (s) => wrap(INFERRED_CYAN, s);
+var accent = green;
+var ok = green;
+var warn = amber;
+var error = red;
+var sym = {
+  ok: "\u2713",
+  fail: "\u2717",
+  warn: "\u26A0",
+  bullet: "\u2022",
+  arrow: "\u2192",
+  stale: "\u22EF",
+  add: "+",
+  dot: "\u25CF",
+  chevron: "\u25B8"
+};
+function heading(label) {
+  return bold(label);
+}
+function provenanceToken(token) {
+  switch (token.trim().toUpperCase()) {
+    case Provenance.OBSERVED:
+      return green(token);
+    case Provenance.STALE:
+      return amber(token);
+    case Provenance.INFERRED:
+      return cyan(token);
+    case Provenance.EXTRACTED:
+      return dim(token);
+    default:
+      return token;
+  }
+}
+function provenance(value) {
+  return value.split(",").map((part, i) => i === 0 ? provenanceToken(part) : " " + provenanceToken(part.replace(/^\s+/, ""))).join(",");
+}
+var ANSI = /\x1b\[[0-9;]*m/g;
+function visibleWidth(s) {
+  return s.replace(ANSI, "").length;
+}
+function table(rows, gap = 2) {
+  if (rows.length === 0) return [];
+  const cols = Math.max(...rows.map((r) => r.length));
+  const widths = [];
+  for (let c = 0; c < cols - 1; c++) {
+    widths[c] = Math.max(...rows.map((r) => r[c] ? visibleWidth(r[c]) : 0));
+  }
+  const pad = " ".repeat(gap);
+  return rows.map(
+    (r) => r.map((cell, c) => {
+      if (c === r.length - 1) return cell;
+      const extra = widths[c] - visibleWidth(cell);
+      return cell + " ".repeat(Math.max(0, extra));
+    }).join(pad)
+  );
+}
+function styleBlock(block) {
+  return block.split("\n").map((line) => {
+    let out = line.replace(/\b(OBSERVED|STALE|INFERRED|EXTRACTED)\b/g, (m) => provenanceToken(m));
+    out = out.replace(/^(\s*)•/, (_all, indent2) => `${indent2}${dim(sym.bullet)}`);
+    return out;
+  }).join("\n");
+}
+function footer(confidence, provenanceValue) {
+  const prov = provenanceValue === "n/a" ? dim(provenanceValue) : provenance(provenanceValue);
+  return `${dim("confidence:")} ${confidence} ${dim("\xB7")} ${dim("provenance:")} ${prov}`;
+}
+function wordmark(version) {
+  const mark = `${accent(sym.chevron)} ${bold("neat")}`;
+  const expansion = dim("Network Environment Architecture Tools");
+  const meta = dim(`neat.is \xB7 v${version} \xB7 Apache 2.0`);
+  return `${mark}  ${expansion}
+${meta}`;
+}
+
+// src/banner.ts
 function readPackageVersion() {
   const here = typeof __dirname !== "undefined" ? __dirname : path.dirname(fileURLToPath(import.meta.url));
   const candidates = [
@@ -118,15 +219,8 @@ function readPackageVersion() {
   return "unknown";
 }
 function printBanner() {
-  console.log("\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557");
-  console.log("\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D");
-  console.log("\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ");
-  console.log("\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ");
-  console.log("\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ");
-  console.log("\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ");
   console.log("");
-  console.log("  Network Expressive Architecting Tool");
-  console.log(`  neat.is  \xB7  v${readPackageVersion()}  \xB7  Apache 2.0`);
+  console.log(wordmark(readPackageVersion()));
   console.log("");
 }
 function isNpxInvocation() {
@@ -177,7 +271,7 @@ ${NEAT_OUT_LINE}
 }
 
 // src/summary.ts
-import { NodeType, Provenance } from "@neat.is/types";
+import { NodeType, Provenance as Provenance2 } from "@neat.is/types";
 function renderOtelEnvBlock() {
   return [
     "for prod OTel routing, set these in your deploy platform's env:",
@@ -193,7 +287,7 @@ function findIncompatServices(nodes) {
 function servicesWithoutObserved(nodes, edges) {
   const seen = /* @__PURE__ */ new Set();
   for (const e of edges) {
-    if (e.provenance === Provenance.OBSERVED) {
+    if (e.provenance === Provenance2.OBSERVED) {
       seen.add(e.source);
       seen.add(e.target);
     }
@@ -213,7 +307,7 @@ function renderValueForwardSummary(input) {
   const edges = [];
   graph.forEachEdge((_id, attrs) => edges.push(attrs));
   const lines = [];
-  lines.push("=== neat: findings ===");
+  lines.push(heading("neat \xB7 findings"));
   lines.push("");
   const incompatServices = findIncompatServices(nodes);
   const totalIncompats = incompatServices.reduce(
@@ -3965,8 +4059,8 @@ var PROBE_INTERVAL_MS = 500;
 async function fetchDaemonHealth(restPort) {
   return new Promise((resolve) => {
     const req = http.get(`http://127.0.0.1:${restPort}/health`, (res) => {
-      const ok = res.statusCode !== void 0 && res.statusCode >= 200 && res.statusCode < 300;
-      if (!ok) {
+      const ok2 = res.statusCode !== void 0 && res.statusCode >= 200 && res.statusCode < 300;
+      if (!ok2) {
         res.resume();
         resolve(null);
         return;
@@ -5377,7 +5471,7 @@ import { promises as fs11 } from "fs";
 import path12 from "path";
 
 // src/cli-client.ts
-import { Provenance as Provenance2 } from "@neat.is/types";
+import { Provenance as Provenance3 } from "@neat.is/types";
 var HttpError = class extends Error {
   constructor(status, message, responseBody = "") {
     super(message);
@@ -5519,7 +5613,7 @@ async function runBlastRadius(client, input) {
   }
 }
 function formatBlastEntry(n) {
-  const tag = n.edgeProvenance === Provenance2.STALE ? " [STALE \u2014 last seen too long ago]" : "";
+  const tag = n.edgeProvenance === Provenance3.STALE ? " [STALE \u2014 last seen too long ago]" : "";
   return `  \u2022 ${n.nodeId} (distance ${n.distance}, ${n.edgeProvenance})${tag}`;
 }
 async function runDependencies(client, input) {
@@ -5576,7 +5670,7 @@ async function runObservedDependencies(client, input) {
       if (result.observed) {
         return {
           summary: `${input.nodeId} makes no outbound runtime calls, but OTel has observed it receiving traffic on ${result.inboundObservedCount} inbound call path${result.inboundObservedCount === 1 ? "" : "s"} \u2014 it's a pure receiver.`,
-          provenance: Provenance2.OBSERVED
+          provenance: Provenance3.OBSERVED
         };
       }
       const note = result.hasExtractedOutbound ? " Static (EXTRACTED) dependencies exist but no runtime traffic has been seen \u2014 is OTel running?" : "";
@@ -5586,7 +5680,7 @@ async function runObservedDependencies(client, input) {
     return {
       summary: `${input.nodeId} has ${result.dependencies.length} runtime dependenc${result.dependencies.length === 1 ? "y" : "ies"} confirmed by OTel.`,
       block: blockLines.join("\n"),
-      provenance: Provenance2.OBSERVED
+      provenance: Provenance3.OBSERVED
     };
   } catch (err) {
     if (err instanceof HttpError && err.status === 404) {
@@ -5640,7 +5734,7 @@ async function runIncidents(client, input) {
     return {
       summary: `${target} has ${body.total} recorded incident${body.total === 1 ? "" : "s"}; showing the ${ordered.length} most recent.`,
       block: blockLines.join("\n"),
-      provenance: Provenance2.OBSERVED
+      provenance: Provenance3.OBSERVED
     };
   } catch (err) {
     if (err instanceof HttpError && err.status === 404) {
@@ -5749,7 +5843,7 @@ async function runStaleEdges(client, input) {
   return {
     summary: `${events.length} stale-edge transition${events.length === 1 ? "" : "s"} recorded${input.edgeType ? ` for ${input.edgeType}` : ""}.`,
     block: blockLines.join("\n"),
-    provenance: Provenance2.STALE
+    provenance: Provenance3.STALE
   };
 }
 async function runPolicies(client, input) {
@@ -5910,14 +6004,14 @@ async function runAsk(client, input) {
     ...result.provenance.length > 0 ? { provenance: result.provenance } : {}
   };
 }
-function formatFooter(confidence, provenance) {
+function formatFooter(confidence, provenance2) {
   const c = confidence === void 0 ? "n/a" : confidence.toFixed(2);
-  const p = provenance === void 0 ? "n/a" : Array.isArray(provenance) ? [...new Set(provenance)].join(", ") : provenance;
-  return `confidence: ${c} \xB7 provenance: ${p}`;
+  const p = provenance2 === void 0 ? "n/a" : Array.isArray(provenance2) ? [...new Set(provenance2)].join(", ") : provenance2;
+  return footer(c, p);
 }
 function formatHuman(result) {
   const sections = [result.summary.trim()];
-  if (result.block && result.block.trim().length > 0) sections.push(result.block.trimEnd());
+  if (result.block && result.block.trim().length > 0) sections.push(styleBlock(result.block.trimEnd()));
   sections.push(formatFooter(result.confidence, result.provenance));
   return sections.join("\n\n");
 }
@@ -5977,10 +6071,10 @@ var NODE_FLOOR = 20;
 var HEALTH_TIMEOUT_MS = 3e3;
 function checkNode(nodeVersion) {
   const major = Number.parseInt(nodeVersion.split(".")[0] ?? "", 10);
-  const ok = Number.isFinite(major) && major >= NODE_FLOOR;
-  return ok ? { name: "node", ok, detail: `v${nodeVersion} (>= ${NODE_FLOOR} required)` } : {
+  const ok2 = Number.isFinite(major) && major >= NODE_FLOOR;
+  return ok2 ? { name: "node", ok: ok2, detail: `v${nodeVersion} (>= ${NODE_FLOOR} required)` } : {
     name: "node",
-    ok,
+    ok: ok2,
     detail: `v${nodeVersion} \u2014 NEAT needs Node ${NODE_FLOOR} or newer`,
     fix: `install Node ${NODE_FLOOR}.x (e.g. \`nvm install ${NODE_FLOOR}\`) and re-run`
   };
@@ -6072,16 +6166,16 @@ async function runDoctorChecks(deps = {}) {
 }
 var NAME_COL = "project".length;
 function renderHuman(checks, out) {
-  out("neat doctor \u2014 checking this project's setup");
+  out(heading("neat doctor") + dim(" \u2014 checking this project's setup"));
   out("");
   for (const c of checks) {
-    const mark = c.ok ? "\u2713" : "\u2717";
-    out(`  ${mark}  ${c.name.padEnd(NAME_COL)}  ${c.detail}`);
-    if (!c.ok && c.fix) out(`  ${" ".repeat(NAME_COL + 3)}fix: ${c.fix}`);
+    const mark = c.ok ? ok(sym.ok) : error(sym.fail);
+    out(`  ${mark}  ${dim(c.name.padEnd(NAME_COL))}  ${c.detail}`);
+    if (!c.ok && c.fix) out(`  ${" ".repeat(NAME_COL + 3)}${dim("fix:")} ${warn(c.fix)}`);
   }
   out("");
   const failed = checks.filter((c) => !c.ok).length;
-  out(failed === 0 ? "all good." : `${failed} check${failed === 1 ? "" : "s"} failed.`);
+  out(failed === 0 ? ok("all good.") : warn(`${failed} check${failed === 1 ? "" : "s"} failed.`));
 }
 async function runDoctorCommand(argv, deps = {}) {
   const out = deps.out ?? ((line) => console.log(line));
@@ -7438,7 +7532,7 @@ async function runEditorCommand(clientId, args, projectDir = process.cwd()) {
 }
 
 // src/monitor.ts
-import { EdgeType, parseEdgeId, Provenance as Provenance3 } from "@neat.is/types";
+import { EdgeType, parseEdgeId, Provenance as Provenance4 } from "@neat.is/types";
 var OBSERVED_DEP_EDGE_TYPES = /* @__PURE__ */ new Set([
   EdgeType.CALLS,
   EdgeType.CONNECTS_TO,
@@ -7600,7 +7694,7 @@ var MonitorEmitter = class {
   // ignores non-OBSERVED edges and non-dependency edge types (structural
   // ownership), so only real runtime dependencies reach stdout.
   emitObservedEdge(edge) {
-    if (edge.provenance !== Provenance3.OBSERVED) return false;
+    if (edge.provenance !== Provenance4.OBSERVED) return false;
     if (!OBSERVED_DEP_EDGE_TYPES.has(edge.type)) return false;
     const key = `edge|${edge.id}`;
     if (this.seen.has(key)) return false;
@@ -7781,7 +7875,7 @@ async function runMonitor(opts) {
       case "edge-added": {
         const payload = safeParse(frame.data);
         const edge = payload?.edge;
-        if (edge && edge.provenance === Provenance3.OBSERVED) {
+        if (edge && edge.provenance === Provenance4.OBSERVED) {
           emitter.emitObservedEdge(edge);
           divergences.schedule();
         }
@@ -7928,7 +8022,7 @@ function emitResult(result, json) {
   } else {
     console.log("skipped instrumentation (--no-instrument)");
   }
-  for (const warn of result.warnings) console.error(warn);
+  for (const warn2 of result.warnings) console.error(warn2);
 }
 async function runSync(opts) {
   const entry2 = await resolveProjectEntry(opts);
@@ -8064,7 +8158,7 @@ function usage5() {
   console.log(`The run stays in your terminal \u2014 query the graph over MCP or the CLI. For a visual`);
   console.log(`dashboard, log in to hosted NEAT; \`--open\` launches the local preview one by choice.`);
   console.log("");
-  console.log("lifecycle commands:");
+  console.log(heading("lifecycle commands:"));
   console.log("  welcome        Open the first-run menu: log in to a hosted NEAT, or set up");
   console.log("                 self-hosted (print an agent-setup prompt, then build the graph");
   console.log("                 for the current directory).");
@@ -8206,7 +8300,7 @@ function usage5() {
   console.log("  logout         Clear the active hosted profile (back to your local daemon);");
   console.log("                 --name <name> removes that profile entirely.");
   console.log("");
-  console.log("query commands (mirror the MCP tools, ADR-050):");
+  console.log(heading("query commands (mirror the MCP tools, ADR-050):"));
   console.log("  ask <question>                   Plain-language door: resolves the question to");
   console.log("                                   nodes and routes it to the right traversal, with");
   console.log("                                   a compact provenance-tagged answer. Reach here first.");
@@ -8391,19 +8485,36 @@ function printVersion() {
   process.stdout.write(`${readPackageVersion()}
 `);
 }
-function formatMachineProjectRow(r) {
+function styleState(state) {
+  switch (state) {
+    case "running":
+    case "active":
+      return ok(state);
+    case "paused":
+      return warn(state);
+    case "broken":
+      return error(state);
+    case "stopped":
+    case "registered":
+      return dim(state);
+    default:
+      return state;
+  }
+}
+function machineProjectCells(r) {
   if (r.ports) {
-    const where = r.pid !== void 0 ? `	pid=${r.pid}` : "";
-    return `${r.project}	${r.state}	rest=${r.ports.rest} otlp=${r.ports.otlp} web=${r.ports.web}	${r.projectPath}${where}`;
+    const ports = dim(`rest=${r.ports.rest} otlp=${r.ports.otlp} web=${r.ports.web}`);
+    const where = r.pid !== void 0 ? `${r.projectPath}  ${dim(`pid=${r.pid}`)}` : r.projectPath;
+    return [r.project, styleState(r.state), ports, where];
   }
-  const status = r.registryStatus ? `	(${r.registryStatus})` : "";
-  return `${r.project}	${r.state}${status}	${r.projectPath}`;
+  const status = r.registryStatus ? `${dim("(")}${styleState(r.registryStatus)}${dim(")")}` : "";
+  return [r.project, styleState(r.state), status, r.projectPath];
 }
 function printDiscoveryReport(opts, services) {
   const languages = [...new Set(services.map((s) => s.node.language))].sort();
   const mode = opts.dryRun ? "dry-run" : opts.apply ? "apply" : "patch-only";
   printBanner();
-  console.log("=== neat init: discovery ===");
+  console.log(heading("neat init \xB7 discovery"));
   console.log(`scan path: ${opts.scanPath}`);
   console.log(`project:   ${opts.project}`);
   console.log(`mode:      ${mode}`);
@@ -8809,9 +8920,9 @@ async function main() {
       console.log("no daemons running and no projects registered. run `neat init <path>` to register one.");
       return;
     }
-    for (const r of rows) {
-      console.log(formatMachineProjectRow(r));
-    }
+    const header = ["project", "state", "ports", "path"].map((h) => dim(h));
+    const body = rows.map(machineProjectCells);
+    for (const line of table([header, ...body])) console.log(line);
     return;
   }
   if (cmd === "pause") {