collect-live-evidence.mjs

#!/usr/bin/env node

import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { dirname, isAbsolute, join, relative, resolve } from "node:path";
import { fileURLToPath } from "node:url";
import { buildGraph, serializeGraph } from "../skills/codebase-visualize/lib/scanner.mjs";
import { buildHtml } from "../skills/codebase-visualize/lib/renderer.mjs";

const configPath = process.env.CODEBASE_VISUALIZE_LIVE_CONFIG;
if (!configPath) {
  console.error("collect:live failed - set CODEBASE_VISUALIZE_LIVE_CONFIG to a JSON config path");
  process.exit(1);
}

const config = JSON.parse(readFileSync(configPath, "utf8").replace(/^\uFEFF/, ""));
if (!Array.isArray(config.targets) || config.targets.length === 0) {
  throw new Error("live evidence config requires a non-empty targets array");
}

const outputRoot = resolve(process.env.CODEBASE_VISUALIZE_EVIDENCE_ROOT || join(tmpdir(), "codebase-visualize-live-evidence"));
const repositoryRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
const outputRelative = relative(repositoryRoot, outputRoot);
if (outputRelative === "" || (!outputRelative.startsWith("..") && !isAbsolute(outputRelative))) {
  throw new Error("live evidence output must remain outside the tracked repository");
}
mkdirSync(outputRoot, { recursive: true });
const reports = [];
const labels = new Set();

for (const target of config.targets) {
  if (!/^[a-z0-9][a-z0-9-]*$/.test(target.label)) {
    throw new Error(`target label must be generic lowercase kebab-case: ${target.label}`);
  }
  if (labels.has(target.label)) {
    throw new Error(`target label must be unique: ${target.label}`);
  }
  labels.add(target.label);
  const graph = buildGraph(resolve(target.path), { generatedAt: new Date().toISOString() });
  const html = buildHtml(graph);
  const graphText = serializeGraph(graph);
  const targetDir = join(outputRoot, target.label);
  mkdirSync(targetDir, { recursive: true });
  writeFileSync(join(targetDir, "codebase-graph.json"), graphText, "utf8");
  writeFileSync(join(targetDir, "codebase-map.html"), html, "utf8");

  const files = graph.nodes.filter((node) => node.type === "file");
  const report = {
    label: target.label,
    files: graph.metadata.counts.files,
    folders: graph.metadata.counts.folders,
    edges: graph.edges.length,
    references: graph.metadata.counts.references_edges,
    unknowns: files.filter((node) => node.kind === "unknown").length,
    warnings: graph.metadata.scan_warnings.length,
    graph_bytes: Buffer.byteLength(graphText),
    map_bytes: Buffer.byteLength(html),
    orient_docs: files.filter((node) => node.risk_hints?.includes("orient-docs")).length,
  };
  reports.push(report);
  console.log(`LIVE ${target.label} - ${Object.entries(report).filter(([key]) => key !== "label").map(([key, value]) => `${key}=${value}`).join(" ")}`);
}

const summary = {
  generated_at: new Date().toISOString(),
  target_count: reports.length,
  reports,
};
writeFileSync(join(outputRoot, "summary.json"), JSON.stringify(summary, null, 2) + "\n", "utf8");
console.log(`collect:live OK - sanitized summary and raw artifacts written outside tracked source (${statSync(outputRoot).isDirectory() ? "directory ready" : "unexpected output"}).`);