@narrativetrace/cli 0.1.3 → 0.2.0

package/dist/index.cjs

@@ -20,528 +20,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  DOCTOR_CHECKS: () => DOCTOR_CHECKS,
-  buildSnapshot: () => buildSnapshot,
-  compareVersions: () => compareVersions,
-  parseVersion: () => parseVersion,
-  renderHuman: () => renderHuman,
-  renderJson: () => renderJson,
-  runDoctor: () => runDoctor,
-  satisfiesRange: () => satisfiesRange
+  DOCTOR_CHECKS: () => import_tooling.DOCTOR_CHECKS,
+  buildSnapshot: () => import_tooling.buildSnapshot,
+  compareVersions: () => import_tooling.compareVersions,
+  parseVersion: () => import_tooling.parseVersion,
+  renderHuman: () => import_tooling.renderHuman,
+  renderJson: () => import_tooling.renderJson,
+  runDoctor: () => import_tooling.runDoctor,
+  satisfiesRange: () => import_tooling.satisfiesRange
 });
 module.exports = __toCommonJS(index_exports);
-
-// src/doctor/doc-urls.ts
-var BASE = "https://github.com/narrativetrace/narrativetrace-typescript/blob/main/documentation/";
-var DOC = {
-  installationPrerequisites: `${BASE}installation-guide.md#prerequisites`,
-  installationDependencies: `${BASE}installation-guide.md#1-add-dependencies`,
-  vitestConfiguration: `${BASE}configuration-guide.md#2-vitest-configuration`,
-  whereSettingsComeFrom: `${BASE}configuration-guide.md#2b-where-settings-come-from`,
-  proxyOptions: `${BASE}configuration-guide.md#6-proxy-options`,
-  eventPipelineBuffering: `${BASE}configuration-guide.md#8-event-pipeline-buffering-bufferedeventconsumer`,
-  noTraceFilesWritten: `${BASE}troubleshooting.md#no-trace-files-are-written`,
-  manualParameterNames: `${BASE}troubleshooting.md#parameters-show-as-arg0-arg1`,
-  redactionSurfaceBySurface: `${BASE}privacy-and-redaction.md#redaction-surface-by-surface`,
-  approvalTracesEndToEnd: `${BASE}structural-trace-format.md#approval-traces-end-to-end`,
-  sixtySecondsNewProject: `${BASE}sixty-seconds.md#1-new-project-add-the-packages`
-};
-
-// src/doctor/finding.ts
-function pass(id, message, docUrl) {
-  return { id, status: "pass", message, fix: "", docUrl };
-}
-function fail(id, message, fix, docUrl) {
-  return { id, status: "fail", message, fix, docUrl };
-}
-
-// src/doctor/checks/approval-traces.ts
-var ID = "trap.approval-traces";
-var FIX = "Review each .received.nt diff against its .approved.nt baseline, then run pnpm run approve-narratives (or narrativetrace-approve) to promote it, or delete it if the change was wrong \u2014 never commit a .received.nt file.";
-var checkApprovalTraces = (snapshot) => {
-  const paths = [...snapshot.approvedDirFiles.keys()];
-  if (paths.length === 0) {
-    return pass(
-      ID,
-      "no approval traces configured yet \u2014 nothing to check",
-      DOC.approvalTracesEndToEnd
-    );
-  }
-  const received = paths.filter((p) => p.endsWith(".received.nt"));
-  if (received.length > 0) {
-    const message2 = `${received.length} stale received trace(s) found: ${received.join(", ")}`;
-    return fail(ID, message2, FIX, DOC.approvalTracesEndToEnd);
-  }
-  const approved = paths.filter((p) => p.endsWith(".approved.nt"));
-  const message = `${approved.length} approved trace(s) found, no pending received diffs`;
-  return pass(ID, message, DOC.approvalTracesEndToEnd);
-};
-
-// src/doctor/checks/llms-before-you-start.ts
-var ID2 = "trap.llms-before-you-start";
-var PLAIN_JS = /\.js$/;
-var ESM_IMPORT = /^\s*import\s/m;
-var FIX2 = "Run `npm pkg set type=module` before `npm add` \u2014 without it, Node throws SyntaxError: Cannot use import statement outside a module (pnpm/yarn default to it and never hit this).";
-var checkLlmsBeforeYouStart = (snapshot) => {
-  if (snapshot.rootPackageJson?.type === "module") {
-    return pass(ID2, 'package.json declares "type": "module"', DOC.sixtySecondsNewProject);
-  }
-  const offender = [...snapshot.sourceFiles].find(
-    ([path2, content]) => PLAIN_JS.test(path2) && ESM_IMPORT.test(content)
-  );
-  if (!offender) {
-    const message2 = 'no plain .js file uses ESM import syntax without "type": "module"';
-    return pass(ID2, message2, DOC.sixtySecondsNewProject);
-  }
-  const [path] = offender;
-  const message = `${path} uses ESM import syntax but package.json has no "type": "module"`;
-  return fail(ID2, message, FIX2, DOC.sixtySecondsNewProject);
-};
-
-// src/semver-lite.ts
-function parseVersion(raw) {
-  const cleaned = raw.trim().replace(/^v/, "");
-  const match = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(cleaned);
-  if (!match) return void 0;
-  return {
-    major: Number(match[1]),
-    minor: match[2] === void 0 ? 0 : Number(match[2]),
-    patch: match[3] === void 0 ? 0 : Number(match[3])
-  };
-}
-function compareVersions(left, right) {
-  if (left.major !== right.major) return left.major - right.major;
-  if (left.minor !== right.minor) return left.minor - right.minor;
-  return left.patch - right.patch;
-}
-function satisfiesGte(version, floor) {
-  return compareVersions(version, floor) >= 0;
-}
-function satisfiesCaret(version, base) {
-  if (compareVersions(version, base) < 0) return false;
-  if (base.major > 0) return version.major === base.major;
-  if (base.minor > 0) return version.major === 0 && version.minor === base.minor;
-  return version.major === 0 && version.minor === 0 && version.patch === base.patch;
-}
-function satisfiesClause(version, trimmed) {
-  if (trimmed.startsWith("^")) {
-    const base = parseVersion(trimmed.slice(1));
-    return base !== void 0 && satisfiesCaret(version, base);
-  }
-  if (trimmed.startsWith(">=")) {
-    const floor = parseVersion(trimmed.slice(2));
-    return floor !== void 0 && satisfiesGte(version, floor);
-  }
-  if (/\.x\b/.test(trimmed)) {
-    const base = parseVersion(trimmed.replace(/\.x/g, ".0"));
-    return base !== void 0 && satisfiesCaret(version, base);
-  }
-  const exact = parseVersion(trimmed);
-  return exact !== void 0 && compareVersions(version, exact) === 0;
-}
-function satisfiesRange(versionRaw, range) {
-  const version = parseVersion(versionRaw);
-  if (!version) return false;
-  return range.split("||").map((clause) => clause.trim()).filter(Boolean).some((clause) => satisfiesClause(version, clause));
-}
-
-// src/doctor/checks/node-engine.ts
-var ID3 = "toolchain.node-engine";
-var DEFAULT_ENGINE_RANGE = ">=20";
-function requiredRange(snapshot) {
-  const core = snapshot.installedPackages.get("@narrativetrace/core");
-  const coreNode = snapshot.installedPackages.get("@narrativetrace/core-node");
-  return core?.engines?.node ?? coreNode?.engines?.node ?? DEFAULT_ENGINE_RANGE;
-}
-var checkNodeEngine = (snapshot) => {
-  const required = requiredRange(snapshot);
-  if (satisfiesRange(snapshot.nodeVersion, required)) {
-    return pass(
-      ID3,
-      `Node ${snapshot.nodeVersion} satisfies the required ${required}`,
-      DOC.installationPrerequisites
-    );
-  }
-  return fail(
-    ID3,
-    `Node ${snapshot.nodeVersion} does not satisfy the required ${required}`,
-    `Upgrade Node to a version satisfying ${required} (nvm, volta, asdf, or your CI image).`,
-    DOC.installationPrerequisites
-  );
-};
-
-// src/doctor/checks/output-env.ts
-var ID4 = "config.output-env";
-var VALID_VALUES = /* @__PURE__ */ new Set(["true", "false"]);
-var checkOutputEnv = (snapshot) => {
-  const raw = snapshot.env.NARRATIVETRACE_OUTPUT;
-  if (raw === void 0) {
-    return pass(
-      ID4,
-      "NARRATIVETRACE_OUTPUT is not set \u2014 output stays on its default (on)",
-      DOC.whereSettingsComeFrom
-    );
-  }
-  if (VALID_VALUES.has(raw.toLowerCase())) {
-    return pass(ID4, `NARRATIVETRACE_OUTPUT=${raw}`, DOC.whereSettingsComeFrom);
-  }
-  return fail(
-    ID4,
-    `NARRATIVETRACE_OUTPUT is set to '${raw}', which is neither "true" nor "false"`,
-    "Set NARRATIVETRACE_OUTPUT=true or NARRATIVETRACE_OUTPUT=false (or unset it) \u2014 any other value is read as a truthy string, most likely turning output on when you meant to turn it off.",
-    DOC.whereSettingsComeFrom
-  );
-};
-
-// src/doctor/checks/parameter-arg0.ts
-var ID5 = "trap.parameter-arg0";
-var ARG_PLACEHOLDER = /\barg0\b/;
-var FIX3 = 'Pass parameter names explicitly: traceObject(target, context, { methodName: ["paramA", "paramB"] }) \u2014 required for classes you do not own, or when a build tool strips them.';
-var checkParameterArg0 = (snapshot) => {
-  if (snapshot.outputFiles.size === 0) {
-    const message2 = "no rendered output found yet \u2014 run your tests or app once to check this";
-    return pass(ID5, message2, DOC.manualParameterNames);
-  }
-  const offender = [...snapshot.outputFiles].find(([, content]) => ARG_PLACEHOLDER.test(content));
-  if (!offender) {
-    const message2 = "rendered output carries real parameter names \u2014 no arg0 placeholders found";
-    return pass(ID5, message2, DOC.manualParameterNames);
-  }
-  const [path] = offender;
-  const message = `rendered output shows arg0-style placeholders (first seen in ${path}) \u2014 parameter names were not captured`;
-  return fail(ID5, message, FIX3, DOC.manualParameterNames);
-};
-
-// src/doctor/checks/redaction-proof.ts
-var ID6 = "trap.redaction-proof";
-var TEST_FILE = /\.(test|spec)\.[cm]?[jt]sx?$/;
-var REDACTED_ASSERTION = /\[REDACTED\]/;
-var checkRedactionProof = (snapshot) => {
-  const testFiles = [...snapshot.sourceFiles].filter(([path]) => TEST_FILE.test(path));
-  const proven = testFiles.some(([, content]) => REDACTED_ASSERTION.test(content));
-  if (proven) {
-    return pass(
-      ID6,
-      "a test asserts [REDACTED] for a deny-listed parameter name",
-      DOC.redactionSurfaceBySurface
-    );
-  }
-  return fail(
-    ID6,
-    "no test asserts [REDACTED] \u2014 redaction is unproven",
-    'Render a call with a deny-listed parameter name (e.g. "password", "token") in a test and assert the output contains "[REDACTED]" \u2014 and that a neighboring, non-sensitive value is still present, so an over-broad redaction also fails.',
-    DOC.redactionSurfaceBySurface
-  );
-};
-
-// src/doctor/checks/reporter-subpath.ts
-var ID7 = "config.reporter-subpath";
-var VITEST_CONFIG_NAME = /(^|\/)vitest\.config\.[cm]?[jt]s$/;
-var REPORTER_NAMES = /\b(ClaritySuiteReporter|GlossarySuiteReporter|StructuralSuiteReporter)\b/;
-var ROOT_IMPORT = /from\s+["']@narrativetrace\/vitest["']/;
-var SUBPATH_IMPORT = /from\s+["']@narrativetrace\/vitest\/reporters["']/;
-function importsFromRoot(content) {
-  return REPORTER_NAMES.test(content) && ROOT_IMPORT.test(content) && !SUBPATH_IMPORT.test(content);
-}
-var checkReporterSubpath = (snapshot) => {
-  const configs = [...snapshot.sourceFiles].filter(([path]) => VITEST_CONFIG_NAME.test(path));
-  const offender = configs.find(([, content]) => importsFromRoot(content));
-  if (offender) {
-    const [path] = offender;
-    return fail(
-      ID7,
-      `${path} imports a NarrativeTrace vitest reporter from the package root, not the /reporters subpath`,
-      'Import reporters from "@narrativetrace/vitest/reporters" \u2014 importing from the package root also loads vitest itself and crashes config loading.',
-      DOC.vitestConfiguration
-    );
-  }
-  const message = configs.length === 0 ? "no vitest.config found \u2014 nothing to check" : "every registered reporter is imported from the /reporters subpath";
-  return pass(ID7, message, DOC.vitestConfiguration);
-};
-
-// src/doctor/checks/sibling-packages.ts
-var ID8 = "toolchain.sibling-packages";
-var checkSiblingPackages = (snapshot) => {
-  const ntVitest = snapshot.installedPackages.get("@narrativetrace/vitest");
-  if (!ntVitest) {
-    const message2 = "@narrativetrace/vitest is not installed \u2014 nothing to check";
-    return pass(ID8, message2, DOC.installationDependencies);
-  }
-  const siblings = Object.keys(ntVitest.dependencies ?? {}).filter(
-    (n) => n.startsWith("@narrativetrace/")
-  );
-  const unresolved = siblings.filter((name) => !snapshot.installedPackages.has(name));
-  if (unresolved.length === 0) {
-    const message2 = `all ${siblings.length} sibling package(s) of @narrativetrace/vitest resolve from the consumer`;
-    return pass(ID8, message2, DOC.installationDependencies);
-  }
-  const message = `${unresolved.length} sibling package(s) of @narrativetrace/vitest do not resolve from the consumer: ${unresolved.join(", ")}`;
-  const fix = `Add ${unresolved.join(", ")} as explicit direct dependencies \u2014 pnpm's strict layout does not hoist a dependency's own transitive dependencies to your project root.`;
-  return fail(ID8, message, fix, DOC.installationDependencies);
-};
-
-// src/doctor/checks/silent-sink.ts
-var ID9 = "trap.silent-sink";
-var TRACE_OBJECT_CALL = /\btraceObject\s*\(/;
-var SINK_SIGNAL = /\b(BufferedEventConsumer|captureTrace|registerConsumer|createNarrativeTest|narrativeTest)\b|@narrativetrace\/(vitest|pino|winston|opentelemetry|observability)\b/;
-var checkSilentSink = (snapshot) => {
-  const contents = [...snapshot.sourceFiles.values()];
-  if (!contents.some((content) => TRACE_OBJECT_CALL.test(content))) {
-    return pass(ID9, "traceObject() is not used \u2014 nothing to check", DOC.noTraceFilesWritten);
-  }
-  if (contents.some((content) => SINK_SIGNAL.test(content))) {
-    return pass(
-      ID9,
-      "traceObject() is used and a consumer/sink is attached",
-      DOC.noTraceFilesWritten
-    );
-  }
-  return fail(
-    ID9,
-    "traceObject() is used but no consumer or sink (BufferedEventConsumer, captureTrace(), a log/OTel bridge, or @narrativetrace/vitest) was found",
-    "Attach a sink: pass a BufferedEventConsumer to your pipeline, call captureTrace() and do something with the tree, or wire a log/OTel bridge \u2014 otherwise every traced call narrates to nowhere.",
-    DOC.noTraceFilesWritten
-  );
-};
-
-// src/doctor/checks/trace-object-keys.ts
-var ID10 = "config.trace-object-keys";
-var OLD_SHAPE = /\bmethods\s*:\s*\{[^{}]*:\s*\[/;
-var checkTraceObjectKeys = (snapshot) => {
-  const offender = [...snapshot.sourceFiles].find(([, content]) => OLD_SHAPE.test(content));
-  if (offender) {
-    const [path] = offender;
-    return fail(
-      ID10,
-      `${path} calls traceObject(...) with a method entry that skips the per-method config object`,
-      "Nest the parameter names under params: traceObject(target, context, { methods: { methodName: { params: [...] } } }) \u2014 a bare array under the method name throws.",
-      DOC.proxyOptions
-    );
-  }
-  return pass(
-    ID10,
-    "no traceObject(...) call uses the old { methods: { ... } } option shape",
-    DOC.proxyOptions
-  );
-};
-
-// src/doctor/checks/vitest-peer.ts
-var ID11 = "toolchain.vitest-peer";
-function noVitestInstalled(range) {
-  const message = `@narrativetrace/vitest requires a peer vitest@${range}, but no vitest install was found`;
-  const fix = `Install a vitest version satisfying ${range} (npm add -D vitest, then npm ci for a clean lockfile install).`;
-  return fail(ID11, message, fix, DOC.vitestConfiguration);
-}
-function mismatchedVitest(range, installed) {
-  const message = `vitest@${installed} does not satisfy @narrativetrace/vitest's declared peer range ${range}`;
-  const fix = `Install a vitest version satisfying ${range}, then reinstall clean (rm -rf node_modules && npm ci) \u2014 a mismatched peer here is the one failure mode that breaks the library's own build.`;
-  return fail(ID11, message, fix, DOC.vitestConfiguration);
-}
-function evaluateInstalledVitest(range, vitest) {
-  if (!vitest?.version) return noVitestInstalled(range);
-  if (satisfiesRange(vitest.version, range)) {
-    const message = `vitest@${vitest.version} satisfies the declared peer range ${range}`;
-    return pass(ID11, message, DOC.vitestConfiguration);
-  }
-  return mismatchedVitest(range, vitest.version);
-}
-var checkVitestPeer = (snapshot) => {
-  const ntVitest = snapshot.installedPackages.get("@narrativetrace/vitest");
-  const range = ntVitest?.peerDependencies?.vitest;
-  if (!ntVitest || !range) {
-    return pass(
-      ID11,
-      "@narrativetrace/vitest is not installed \u2014 nothing to check",
-      DOC.vitestConfiguration
-    );
-  }
-  return evaluateInstalledVitest(range, snapshot.installedPackages.get("vitest"));
-};
-
-// src/doctor/doctor.ts
-var DOCTOR_CHECKS = [
-  checkNodeEngine,
-  checkVitestPeer,
-  checkSiblingPackages,
-  checkOutputEnv,
-  checkReporterSubpath,
-  checkTraceObjectKeys,
-  checkSilentSink,
-  checkParameterArg0,
-  checkRedactionProof,
-  checkApprovalTraces,
-  checkLlmsBeforeYouStart
-];
-function runDoctor(snapshot) {
-  const findings = DOCTOR_CHECKS.map((check) => check(snapshot));
-  const exitCode = findings.some((f) => f.status === "fail") ? 1 : 0;
-  return { findings, exitCode };
-}
-
-// src/doctor/environment.ts
-var import_node_fs = require("fs");
-var import_node_module = require("module");
-var import_node_path = require("path");
-var EXCLUDED_DIRS = /* @__PURE__ */ new Set([
-  // Stryker disable next-line StringLiteral: equivalent — every dot-prefixed entry name is
-  // already excluded earlier, in visitEntry's leading-dot check (the only exception there is
-  // ".env", which isn't a directory this set would ever mention), so ".git" never actually
-  // reaches this set's `.has()` check.
-  ".git",
-  // Stryker disable next-line StringLiteral: same equivalence as ".git" above.
-  ".turbo",
-  // Stryker disable next-line StringLiteral: same equivalence as ".git" above.
-  ".stryker-tmp",
-  // Not dot-prefixed, so NOT equivalent — reaching this set's `.has()` check is the only thing
-  // that excludes each of the four names below; each is covered by a real test.
-  "node_modules",
-  "dist",
-  "build",
-  "coverage"
-]);
-var SOURCE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts"];
-var BASE_PACKAGES = [
-  "vitest",
-  "@narrativetrace/core",
-  "@narrativetrace/core-node",
-  "@narrativetrace/vitest"
-];
-var MAX_FILES = 2e4;
-function readJson(path) {
-  try {
-    return JSON.parse((0, import_node_fs.readFileSync)(path, "utf8"));
-  } catch {
-    return void 0;
-  }
-}
-function resolvePackageJson(name, cwd) {
-  try {
-    const require2 = (0, import_node_module.createRequire)((0, import_node_path.join)(cwd, "package.json"));
-    return readJson(require2.resolve(`${name}/package.json`));
-  } catch {
-    return void 0;
-  }
-}
-function isDirectorySafe(path) {
-  try {
-    return (0, import_node_fs.statSync)(path).isDirectory();
-  } catch {
-    return void 0;
-  }
-}
-function safeRead(path) {
-  try {
-    return (0, import_node_fs.readFileSync)(path, "utf8");
-  } catch {
-    return "";
-  }
-}
-function listDirectory(dir) {
-  try {
-    return (0, import_node_fs.readdirSync)(dir);
-  } catch {
-    return [];
-  }
-}
-function classify(rel, outputDirName, approvedDirName) {
-  const topSegment = rel.split("/")[0];
-  if (topSegment === outputDirName) return "output";
-  if (topSegment === approvedDirName) return "approved";
-  return SOURCE_EXTENSIONS.some((ext) => rel.endsWith(ext)) ? "source" : "skip";
-}
-function bucketFor(state, kind) {
-  return kind === "output" ? state.outputFiles : kind === "approved" ? state.approvedDirFiles : state.sourceFiles;
-}
-function visitEntry(ctx, dir, entry) {
-  if (entry.startsWith(".") && entry !== ".env") return;
-  const full = (0, import_node_path.join)(dir, entry);
-  const isDir = isDirectorySafe(full);
-  if (isDir === void 0) return;
-  if (isDir) {
-    if (!EXCLUDED_DIRS.has(entry)) ctx.queue.push(full);
-    return;
-  }
-  ctx.state.visited++;
-  const rel = (0, import_node_path.relative)(ctx.root, full);
-  const kind = classify(rel, ctx.output, ctx.approved);
-  if (kind === "skip") return;
-  bucketFor(ctx.state, kind).set(rel, safeRead(full));
-}
-function walk(root, output, approved) {
-  const state = {
-    sourceFiles: /* @__PURE__ */ new Map(),
-    outputFiles: /* @__PURE__ */ new Map(),
-    approvedDirFiles: /* @__PURE__ */ new Map(),
-    visited: 0
-  };
-  const ctx = { state, root, output, approved, queue: [root] };
-  while (ctx.queue.length > 0 && state.visited < MAX_FILES) {
-    const dir = ctx.queue.shift();
-    for (const entry of listDirectory(dir)) {
-      if (state.visited >= MAX_FILES) break;
-      visitEntry(ctx, dir, entry);
-    }
-  }
-  return state;
-}
-function resolveBasePackages(cwd) {
-  const installed = /* @__PURE__ */ new Map();
-  for (const name of BASE_PACKAGES) {
-    const pkg = resolvePackageJson(name, cwd);
-    if (pkg) installed.set(name, pkg);
-  }
-  return installed;
-}
-function resolveVitestSiblings(cwd, installed) {
-  const ntVitest = installed.get("@narrativetrace/vitest");
-  for (const name of Object.keys(ntVitest?.dependencies ?? {})) {
-    if (!name.startsWith("@narrativetrace/") || installed.has(name)) continue;
-    const pkg = resolvePackageJson(name, cwd);
-    if (pkg) installed.set(name, pkg);
-  }
-}
-function resolveInstalledPackages(cwd) {
-  const installed = resolveBasePackages(cwd);
-  resolveVitestSiblings(cwd, installed);
-  return installed;
-}
-function buildSnapshot(cwd, env) {
-  const output = env.NARRATIVETRACE_OUTPUT_DIR ?? "narrativetrace-output";
-  const approved = env.NARRATIVETRACE_APPROVED_DIR ?? "narratives";
-  const { sourceFiles, outputFiles, approvedDirFiles } = walk(cwd, output, approved);
-  return {
-    cwd,
-    nodeVersion: process.version.replace(/^v/, ""),
-    env,
-    rootPackageJson: readJson((0, import_node_path.join)(cwd, "package.json")),
-    sourceFiles,
-    outputFiles,
-    approvedDirFiles,
-    installedPackages: resolveInstalledPackages(cwd)
-  };
-}
-
-// src/doctor/render.ts
-function renderFinding(finding) {
-  const tag = finding.status === "fail" ? "FAIL" : "PASS";
-  const lines = [`[${tag}] ${finding.id} \u2014 ${finding.message}`];
-  if (finding.status === "fail") {
-    lines.push(`  fix:  ${finding.fix}`, `  docs: ${finding.docUrl}`);
-  }
-  lines.push("");
-  return lines;
-}
-function renderHuman(report) {
-  const failing = report.findings.filter((f) => f.status === "fail");
-  const passing = report.findings.filter((f) => f.status === "pass");
-  const header = `narrativetrace doctor \u2014 ${report.findings.length} check(s), ${failing.length} finding(s)`;
-  const summary = failing.length === 0 ? "All checks passed." : `${failing.length} finding(s). Exit code ${report.exitCode}.`;
-  const body = [...failing, ...passing].flatMap(renderFinding);
-  return [header, "", ...body, summary].join("\n");
-}
-function renderJson(report) {
-  return JSON.stringify(report, null, 2);
-}
+var import_tooling = require("@narrativetrace/tooling");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DOCTOR_CHECKS,