rahman-resources 1.5.1 → 1.7.0

package/bin/cli.js

@@ -34,6 +34,7 @@ import { runGraph } from "./graph.mjs";
 import { runCompose, preflight as composePreflight } from "./compose.mjs";
 import { runUpdate as runUpdate3Way } from "./update.mjs";
 import { runMigrate } from "./migrate.mjs";
+import { augmentConsumerEnv } from "../lib/env-augment.mjs";
 
 const require = createRequire(import.meta.url);
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -141,9 +142,10 @@ ${kleur.bold("Init flags:")}
                           (heavy; ~50 components — use only if you'll customize beyond the template)
 
 ${kleur.bold("Add flags:")}
-  --at root               install template AT app/(public)/ + app/admin/ (recommended; rewrites
+  --at root               install template AT app/(public)/ + app/admin/ (default — rewrites
                           /preview/<slug> path constants in nav-config/robots/sitemap)
-  --at preview            install template AT app/preview/<slug>/ (default — sandbox style)
+  --at preview            install template AT app/preview/<slug>/ (sandbox; keeps hardcoded
+                          /preview/<slug> URLs — only useful for parallel demo of multiple templates)
   --with-shadcn-all       same as init flag
   --strict                enforce strict compose pre-flight (uncontracted/env-missing → blocker)
   --force                 skip compose pre-flight entirely
@@ -516,7 +518,22 @@ async function runAdd(rest) {
     console.log(kleur.yellow(`  ⚠ --force: skipping compose pre-flight.`));
   }
 
-  if (kind === "slice") return runLift([`rahman:${entry.slug}`, ...(targetArg !== "." ? ["--target", targetArg] : [])]);
+  if (kind === "slice") {
+    console.log(
+      kleur.bold(`\n→ Adding slice ${kleur.cyan(entry.slug)} `) +
+      kleur.dim(`[SLICE — drop-in feature]`) +
+      kleur.bold(` to ${kleur.dim(target)}\n`),
+    );
+    await runLift([`rahman:${entry.slug}`, ...(targetArg !== "." ? ["--target", targetArg] : [])]);
+    // Augment consumer .env.example with this slice's env requirements.
+    // Idempotent — re-running `add` does not duplicate entries.
+    try {
+      augmentConsumerEnv(entry, target);
+    } catch (err) {
+      console.error(kleur.yellow(`  ⚠ env augment skipped: ${err.message ?? err}`));
+    }
+    return;
+  }
   if (kind === "layout") return addLayout(entry, target, targetArg, flags);
   if (kind === "feature") return addFeature(entry, target, targetArg);
   if (kind === "recipe") return addRecipe(entry);
@@ -558,14 +575,26 @@ async function runUpdate(rest) {
 }
 
 async function addLayout(t, target, targetArg, flags = {}) {
-  console.log(kleur.bold(`\n→ Installing ${kleur.cyan(t.title)} into ${kleur.dim(target)}\n`));
+  console.log(
+    kleur.bold(`\n→ Installing ${kleur.cyan(t.title)} `) +
+    kleur.dim(`[TEMPLATE — full-app scaffold]`) +
+    kleur.bold(` into ${kleur.dim(target)}\n`),
+  );
   if (!t.pullPaths || t.pullPaths.length === 0) {
     throw new Error(`Layout "${t.slug}" has no valid pullPaths in manifest.`);
   }
-  const at = typeof flags.at === "string" ? flags.at : "preview";
+  const at = typeof flags.at === "string" ? flags.at : "root";
   if (!["root", "preview"].includes(at)) {
     throw new Error(`--at must be "root" or "preview" (got "${at}").`);
   }
+  if (at === "preview") {
+    console.log(
+      kleur.yellow(
+        `  ⚠ --at preview: routes stay under /preview/${t.slug}/* (sandbox).\n` +
+        `    For a production-ready install, omit --at or pass --at root.\n`,
+      ),
+    );
+  }
 
   for (const p of t.pullPaths) {
     const dest = path.join(target, p);
@@ -756,7 +785,11 @@ function rewritePreviewPaths(target, slug) {
 }
 
 async function addFeature(t, target, targetArg) {
-  console.log(kleur.bold(`\n→ Adding feature ${kleur.cyan(t.title)} to ${kleur.dim(target)}\n`));
+  console.log(
+    kleur.bold(`\n→ Adding feature ${kleur.cyan(t.title)} `) +
+    kleur.dim(`[SLICE — drop-in feature]`) +
+    kleur.bold(` to ${kleur.dim(target)}\n`),
+  );
   if (!t.npmPackages || t.npmPackages.length === 0) {
     console.log(kleur.dim(`  No npm packages to install (${t.install}).`));
   } else {

package/bin/compose-print.mjs

@@ -0,0 +1,83 @@
+// compose-print.mjs — human ASCII renderer for `rr compose`.
+//
+// Extracted from compose.mjs.
+
+import path from "node:path";
+import kleur from "kleur";
+
+import { hasBlocker } from "./compose-state.mjs";
+
+export function printHuman(result, { rrPath, repoRoot }) {
+  const blocker = hasBlocker(result);
+  const head = blocker
+    ? kleur.red("✖ compose blocked")
+    : kleur.green("✓ compose ok");
+  console.log(
+    `\n${head}  ${kleur.dim(`rr.json: ${path.relative(repoRoot, rrPath) || rrPath}`)}\n`,
+  );
+
+  console.log(kleur.bold("Proof"));
+  if (result.proof.length === 0) {
+    console.log("  " + kleur.dim("(no decisions — empty desired set)"));
+  } else {
+    for (const line of result.proof) {
+      const colored = line.startsWith("+ ")
+        ? kleur.green(line)
+        : line.startsWith("- ")
+          ? kleur.red(line)
+          : line;
+      console.log("  " + colored);
+    }
+  }
+
+  if (result.accepted.length > 0) {
+    console.log(`\n${kleur.bold("Accepted")} ${kleur.dim(`(${result.accepted.length})`)}`);
+    for (const s of result.accepted) console.log("  " + kleur.cyan(s));
+  }
+
+  if (result.rejected.length > 0) {
+    console.log(`\n${kleur.bold("Rejected")} ${kleur.dim(`(${result.rejected.length})`)}`);
+    for (const r of result.rejected) {
+      console.log("  " + kleur.red(r.slug));
+      for (const reason of r.reasons) {
+        console.log(
+          "    " +
+            kleur.dim(`[${reason.type}]`) +
+            "  " +
+            reason.detail,
+        );
+      }
+    }
+  }
+
+  const warnings = result.conflicts.filter((c) => c.severity === "warning");
+  if (warnings.length > 0) {
+    console.log(`\n${kleur.bold("Warnings")} ${kleur.dim(`(${warnings.length})`)}`);
+    for (const w of warnings) {
+      console.log("  " + kleur.yellow(`[${w.type}]`) + "  " + w.detail);
+    }
+  }
+
+  if (result.envMissing.length > 0) {
+    console.log(`\n${kleur.bold("Env needed")}`);
+    for (const e of result.envMissing) console.log("  " + kleur.yellow(e));
+  }
+
+  if (result.rbacToCreate.length > 0) {
+    console.log(`\n${kleur.bold("RBAC to create")}`);
+    for (const p of result.rbacToCreate) console.log("  " + kleur.yellow(p));
+  }
+
+  if (result.tablesAdded.length > 0) {
+    console.log(`\n${kleur.bold("Tables added")}`);
+    for (const t of result.tablesAdded) {
+      console.log(
+        "  " + kleur.cyan(t.slug) + ": " + kleur.dim(t.tables.join(", ")),
+      );
+    }
+  }
+
+  console.log(
+    `\n${kleur.dim("appendix: pass --json for machine-readable output")}\n`,
+  );
+}

package/bin/compose-state.mjs

@@ -0,0 +1,105 @@
+// compose-state.mjs — rr.json reader + strict-mode helper + repo-root finder.
+//
+// Extracted from compose.mjs.
+
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+
+/**
+ * Walk up from `start` looking for the directory that contains a `packages/`
+ * folder + `package.json`. Falls back to cwd.
+ */
+export function findRepoRoot(start) {
+  let dir = start;
+  for (let i = 0; i < 8; i++) {
+    if (
+      existsSync(path.join(dir, "packages")) &&
+      existsSync(path.join(dir, "package.json"))
+    ) {
+      return dir;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return process.cwd();
+}
+
+/**
+ * Parse rr.json (if present) into a {@link RrJsonState}. Tolerates a
+ * missing file by returning an empty state.
+ *
+ * Maps `rr.json#/auth.provider` to the solver's `auth` enum:
+ *   "convex-auth" → "convex"
+ *   "clerk" / "next-auth" / "none" → passthrough
+ */
+export function readStateFromRr(rrPath) {
+  if (!existsSync(rrPath)) return {};
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync(rrPath, "utf8"));
+  } catch {
+    return {};
+  }
+  const provider = raw?.auth?.provider;
+  const authMap = {
+    "convex-auth": "convex",
+    clerk: "clerk",
+    "next-auth": "next-auth",
+    none: "none",
+  };
+  const auth = provider ? authMap[provider] ?? undefined : undefined;
+
+  const slicesInstalled = [
+    ...(raw?.slices ?? []).map((s) => s.slug).filter(Boolean),
+    ...(raw?.features ?? []).map((f) => f.slug).filter(Boolean),
+  ];
+
+  return {
+    auth,
+    slicesInstalled,
+    envExisting: Array.isArray(raw?.envExisting) ? raw.envExisting : [],
+    rbacRolesExisting: Array.isArray(raw?.rbacRolesExisting)
+      ? raw.rbacRolesExisting
+      : [],
+    convexTablesExisting: Array.isArray(raw?.convexTablesExisting)
+      ? raw.convexTablesExisting
+      : [],
+  };
+}
+
+export function hasBlocker(result) {
+  return result.conflicts.some((c) => c.severity === "blocker");
+}
+
+/**
+ * Elevate every `warning`-level conflict to `blocker`, then re-derive the
+ * accepted / rejected sets so the slice that triggered any warning gets
+ * rejected. Used for `--strict` / CI gating.
+ *
+ * @param {import("../lib/compose-solver").ComposeResult} result
+ * @returns {import("../lib/compose-solver").ComposeResult}
+ */
+export function applyStrictMode(result) {
+  const conflicts = result.conflicts.map((c) =>
+    c.severity === "warning" ? { ...c, severity: "blocker" } : c,
+  );
+  const blockersBySlug = new Map();
+  for (const c of conflicts) {
+    if (c.severity !== "blocker") continue;
+    const cur = blockersBySlug.get(c.slug) ?? [];
+    cur.push(c);
+    blockersBySlug.set(c.slug, cur);
+  }
+  const newRejected = [...result.rejected];
+  const newAccepted = [];
+  for (const slug of result.accepted) {
+    const bl = blockersBySlug.get(slug);
+    if (bl && bl.length > 0) {
+      newRejected.push({ slug, reasons: bl, note: "strict-mode" });
+    } else {
+      newAccepted.push(slug);
+    }
+  }
+  return { ...result, conflicts, accepted: newAccepted, rejected: newRejected };
+}

package/bin/compose.mjs

@@ -7,14 +7,24 @@
 //
 // Dispatched from bin/cli.js. Imports the pure solver from
 // ../lib/compose-solver.mjs and only handles I/O + presentation.
+//
+// Module split (kept ≤200 LOC each):
+//   - compose-state.mjs  — rr.json reader + strict-mode + repo-root finder
+//   - compose-print.mjs  — ASCII renderer for the human output mode
 
-import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
 import kleur from "kleur";
 
 import { loadAllContracts, compose } from "../lib/compose-solver.mjs";
+import {
+  findRepoRoot,
+  readStateFromRr,
+  hasBlocker,
+  applyStrictMode,
+} from "./compose-state.mjs";
+import { printHuman } from "./compose-print.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -68,6 +78,25 @@ export async function runCompose(rest) {
   if (hasBlocker(result)) process.exit(1);
 }
 
+/**
+ * Programmatic helper used by `rr add` for the pre-flight gate.
+ *
+ * @param {string} slug
+ * @param {string} repoRoot
+ * @param {string} targetDir Directory holding rr.json (cwd by default).
+ * @param {{ strict?: boolean }} [opts]
+ * @returns {Promise<{ result: import("../lib/compose-solver").ComposeResult; rrPath: string }>}
+ */
+export async function preflight(slug, repoRoot, targetDir = process.cwd(), opts = {}) {
+  const rrPath = path.join(targetDir, "rr.json");
+  const state = readStateFromRr(rrPath);
+  if (opts.strict) state.allowUnknownSlices = false;
+  const contracts = await loadAllContracts(repoRoot);
+  let result = compose({ state, desired: [slug], resolveDeps: true }, contracts);
+  if (opts.strict) result = applyStrictMode(result);
+  return { result, rrPath };
+}
+
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -92,196 +121,3 @@ function parseFlags(rest) {
   }
   return { positional, flags };
 }
-
-/**
- * Walk up from `start` looking for the directory that contains a `packages/`
- * folder + `package.json`. Falls back to cwd.
- */
-function findRepoRoot(start) {
-  let dir = start;
-  for (let i = 0; i < 8; i++) {
-    if (
-      existsSync(path.join(dir, "packages")) &&
-      existsSync(path.join(dir, "package.json"))
-    ) {
-      return dir;
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return process.cwd();
-}
-
-/**
- * Parse rr.json (if present) into a {@link RrJsonState}. Tolerates a
- * missing file by returning an empty state.
- *
- * Maps `rr.json#/auth.provider` to the solver's `auth` enum:
- *   "convex-auth" → "convex"
- *   "clerk" / "next-auth" / "none" → passthrough
- */
-function readStateFromRr(rrPath) {
-  if (!existsSync(rrPath)) return {};
-  let raw;
-  try {
-    raw = JSON.parse(readFileSync(rrPath, "utf8"));
-  } catch {
-    return {};
-  }
-  const provider = raw?.auth?.provider;
-  const authMap = {
-    "convex-auth": "convex",
-    clerk: "clerk",
-    "next-auth": "next-auth",
-    none: "none",
-  };
-  const auth = provider ? authMap[provider] ?? undefined : undefined;
-
-  const slicesInstalled = [
-    ...(raw?.slices ?? []).map((s) => s.slug).filter(Boolean),
-    ...(raw?.features ?? []).map((f) => f.slug).filter(Boolean),
-  ];
-
-  return {
-    auth,
-    slicesInstalled,
-    envExisting: Array.isArray(raw?.envExisting) ? raw.envExisting : [],
-    rbacRolesExisting: Array.isArray(raw?.rbacRolesExisting)
-      ? raw.rbacRolesExisting
-      : [],
-    convexTablesExisting: Array.isArray(raw?.convexTablesExisting)
-      ? raw.convexTablesExisting
-      : [],
-  };
-}
-
-function hasBlocker(result) {
-  return result.conflicts.some((c) => c.severity === "blocker");
-}
-
-function printHuman(result, { rrPath, repoRoot }) {
-  const blocker = hasBlocker(result);
-  const head = blocker
-    ? kleur.red("✖ compose blocked")
-    : kleur.green("✓ compose ok");
-  console.log(
-    `\n${head}  ${kleur.dim(`rr.json: ${path.relative(repoRoot, rrPath) || rrPath}`)}\n`,
-  );
-
-  console.log(kleur.bold("Proof"));
-  if (result.proof.length === 0) {
-    console.log("  " + kleur.dim("(no decisions — empty desired set)"));
-  } else {
-    for (const line of result.proof) {
-      const colored = line.startsWith("+ ")
-        ? kleur.green(line)
-        : line.startsWith("- ")
-          ? kleur.red(line)
-          : line;
-      console.log("  " + colored);
-    }
-  }
-
-  if (result.accepted.length > 0) {
-    console.log(`\n${kleur.bold("Accepted")} ${kleur.dim(`(${result.accepted.length})`)}`);
-    for (const s of result.accepted) console.log("  " + kleur.cyan(s));
-  }
-
-  if (result.rejected.length > 0) {
-    console.log(`\n${kleur.bold("Rejected")} ${kleur.dim(`(${result.rejected.length})`)}`);
-    for (const r of result.rejected) {
-      console.log("  " + kleur.red(r.slug));
-      for (const reason of r.reasons) {
-        console.log(
-          "    " +
-            kleur.dim(`[${reason.type}]`) +
-            "  " +
-            reason.detail,
-        );
-      }
-    }
-  }
-
-  const warnings = result.conflicts.filter((c) => c.severity === "warning");
-  if (warnings.length > 0) {
-    console.log(`\n${kleur.bold("Warnings")} ${kleur.dim(`(${warnings.length})`)}`);
-    for (const w of warnings) {
-      console.log("  " + kleur.yellow(`[${w.type}]`) + "  " + w.detail);
-    }
-  }
-
-  if (result.envMissing.length > 0) {
-    console.log(`\n${kleur.bold("Env needed")}`);
-    for (const e of result.envMissing) console.log("  " + kleur.yellow(e));
-  }
-
-  if (result.rbacToCreate.length > 0) {
-    console.log(`\n${kleur.bold("RBAC to create")}`);
-    for (const p of result.rbacToCreate) console.log("  " + kleur.yellow(p));
-  }
-
-  if (result.tablesAdded.length > 0) {
-    console.log(`\n${kleur.bold("Tables added")}`);
-    for (const t of result.tablesAdded) {
-      console.log(
-        "  " + kleur.cyan(t.slug) + ": " + kleur.dim(t.tables.join(", ")),
-      );
-    }
-  }
-
-  console.log(
-    `\n${kleur.dim("appendix: pass --json for machine-readable output")}\n`,
-  );
-}
-
-/**
- * Programmatic helper used by `rr add` for the pre-flight gate.
- *
- * @param {string} slug
- * @param {string} repoRoot
- * @param {string} targetDir Directory holding rr.json (cwd by default).
- * @param {{ strict?: boolean }} [opts]
- * @returns {Promise<{ result: import("../lib/compose-solver").ComposeResult; rrPath: string }>}
- */
-export async function preflight(slug, repoRoot, targetDir = process.cwd(), opts = {}) {
-  const rrPath = path.join(targetDir, "rr.json");
-  const state = readStateFromRr(rrPath);
-  if (opts.strict) state.allowUnknownSlices = false;
-  const contracts = await loadAllContracts(repoRoot);
-  let result = compose({ state, desired: [slug], resolveDeps: true }, contracts);
-  if (opts.strict) result = applyStrictMode(result);
-  return { result, rrPath };
-}
-
-/**
- * Elevate every `warning`-level conflict to `blocker`, then re-derive the
- * accepted / rejected sets so the slice that triggered any warning gets
- * rejected. Used for `--strict` / CI gating.
- *
- * @param {import("../lib/compose-solver").ComposeResult} result
- * @returns {import("../lib/compose-solver").ComposeResult}
- */
-function applyStrictMode(result) {
-  const conflicts = result.conflicts.map((c) =>
-    c.severity === "warning" ? { ...c, severity: "blocker" } : c,
-  );
-  const blockersBySlug = new Map();
-  for (const c of conflicts) {
-    if (c.severity !== "blocker") continue;
-    const cur = blockersBySlug.get(c.slug) ?? [];
-    cur.push(c);
-    blockersBySlug.set(c.slug, cur);
-  }
-  const newRejected = [...result.rejected];
-  const newAccepted = [];
-  for (const slug of result.accepted) {
-    const bl = blockersBySlug.get(slug);
-    if (bl && bl.length > 0) {
-      newRejected.push({ slug, reasons: bl, note: "strict-mode" });
-    } else {
-      newAccepted.push(slug);
-    }
-  }
-  return { ...result, conflicts, accepted: newAccepted, rejected: newRejected };
-}

package/bin/graph-render.mjs

@@ -0,0 +1,179 @@
+// graph-render.mjs — ASCII renderers for `rr graph`.
+//
+// Extracted from graph.mjs.
+
+import kleur from "kleur";
+
+import { listAllDNA, readDNA } from "../lib/dna.mjs";
+
+export function printSummary() {
+  const slices = listAllDNA();
+  if (slices.length === 0) {
+    console.log(
+      kleur.yellow("No DNA files in .kitab/lineage/. ") +
+        kleur.dim("Seed some via `rr graph` integrations or manual write."),
+    );
+    return;
+  }
+  console.log(kleur.bold(`\nDNA graph — ${slices.length} slice(s)\n`));
+
+  // Header table: slug | lineage count | consumers | newest source
+  const rows = [];
+  for (const dna of slices) {
+    const newest = dna.lineage[dna.lineage.length - 1];
+    rows.push({
+      slug: dna.id,
+      lineage: dna.lineage.length,
+      consumers: Object.keys(dna.consumers).length,
+      source: newest ? newest.from : "—",
+    });
+  }
+  const w1 = Math.max(4, ...rows.map((r) => r.slug.length));
+  const w4 = Math.max(6, ...rows.map((r) => String(r.source).length));
+  console.log(
+    "  " +
+      kleur.bold("slug".padEnd(w1)) +
+      "  " +
+      kleur.bold("hops".padEnd(4)) +
+      "  " +
+      kleur.bold("adopts".padEnd(6)) +
+      "  " +
+      kleur.bold("latest source".padEnd(w4)),
+  );
+  console.log(
+    "  " +
+      kleur.dim("-".repeat(w1)) +
+      "  " +
+      kleur.dim("----") +
+      "  " +
+      kleur.dim("------") +
+      "  " +
+      kleur.dim("-".repeat(w4)),
+  );
+  for (const r of rows) {
+    console.log(
+      "  " +
+        kleur.cyan(r.slug.padEnd(w1)) +
+        "  " +
+        String(r.lineage).padEnd(4) +
+        "  " +
+        String(r.consumers).padEnd(6) +
+        "  " +
+        kleur.dim(r.source),
+    );
+  }
+
+  // Consumer adoption matrix.
+  /** @type {Set<string>} */
+  const consumerSet = new Set();
+  for (const dna of slices) {
+    for (const c of Object.keys(dna.consumers)) consumerSet.add(c);
+  }
+  const consumers = [...consumerSet].sort();
+  if (consumers.length > 0) {
+    console.log(kleur.bold(`\nAdoption matrix\n`));
+    const cw = Math.max(4, ...rows.map((r) => r.slug.length));
+    console.log(
+      "  " +
+        " ".repeat(cw) +
+        "  " +
+        consumers
+          .map((c) => kleur.bold(c.slice(0, 10).padEnd(10)))
+          .join("  "),
+    );
+    for (const dna of slices) {
+      const cells = consumers
+        .map((c) => {
+          const ad = dna.consumers[c];
+          if (!ad) return kleur.dim("·".padEnd(10));
+          const drift = ad.drift_score;
+          const tag = `v${ad.version} ${drift}%`.slice(0, 10).padEnd(10);
+          if (drift >= 40) return kleur.red(tag);
+          if (drift >= 15) return kleur.yellow(tag);
+          return kleur.green(tag);
+        })
+        .join("  ");
+      console.log("  " + kleur.cyan(dna.id.padEnd(cw)) + "  " + cells);
+    }
+    console.log(
+      kleur.dim(
+        `\n  legend: green <15% drift, yellow 15-39%, red >=40%, · = not adopted`,
+      ),
+    );
+  }
+
+  console.log(
+    kleur.dim(
+      `\nRun \`rr graph <slug>\` for the full lineage tree, \`--json\` for machine output.\n`,
+    ),
+  );
+}
+
+export function printSliceTree(slug) {
+  const dna = readDNA(slug);
+  if (!dna) {
+    console.error(
+      kleur.red(`✖ No DNA found for "${slug}".`) +
+        kleur.dim(`  (expected .kitab/lineage/${slug}.dna.json)`),
+    );
+    process.exit(1);
+  }
+  console.log(
+    `\n${kleur.bold(dna.id)}  ${kleur.dim(
+      `created ${dna.created_at}`,
+    )}\n`,
+  );
+
+  // Lineage chain — chronological top-down tree.
+  console.log(kleur.bold("Lineage"));
+  if (dna.lineage.length === 0) {
+    console.log("  " + kleur.dim("(no lineage entries)"));
+  } else {
+    const sorted = [...dna.lineage].sort((a, b) =>
+      String(a.at).localeCompare(String(b.at)),
+    );
+    sorted.forEach((entry, i) => {
+      const isLast = i === sorted.length - 1;
+      const bullet = isLast ? "└─" : "├─";
+      const cont = isLast ? "  " : "│ ";
+      console.log(
+        `  ${kleur.dim(bullet)} ${kleur.cyan(entry.from)}` +
+          (entry.to ? ` ${kleur.dim("→")} ${kleur.green(entry.to)}` : "") +
+          `  ${kleur.dim(entry.at)}`,
+      );
+      if (entry.transforms?.length) {
+        console.log(
+          `  ${kleur.dim(cont)}   ${kleur.dim("transforms:")} ${entry.transforms.join(", ")}`,
+        );
+      }
+      if (entry.actor) {
+        console.log(`  ${kleur.dim(cont)}   ${kleur.dim("actor:")} ${entry.actor}`);
+      }
+    });
+  }
+
+  // Consumer adoption rows.
+  console.log(`\n${kleur.bold("Consumers")}`);
+  const consumers = Object.entries(dna.consumers);
+  if (consumers.length === 0) {
+    console.log("  " + kleur.dim("(no consumers recorded)"));
+  } else {
+    const w = Math.max(4, ...consumers.map(([c]) => c.length));
+    for (const [name, ad] of consumers) {
+      const drift = ad.drift_score;
+      const driftStr =
+        drift >= 40
+          ? kleur.red(`${drift}%`)
+          : drift >= 15
+            ? kleur.yellow(`${drift}%`)
+            : kleur.green(`${drift}%`);
+      const sync = ad.last_synced_at ? ` synced ${ad.last_synced_at}` : "";
+      console.log(
+        `  ${kleur.cyan(name.padEnd(w))}  v${ad.version}  drift ${driftStr}  ${kleur.dim(
+          `adopted ${ad.adopted_at}${sync}`,
+        )}`,
+      );
+    }
+  }
+  console.log("");
+}