@narrativetrace/cli 0.1.3 → 0.2.0

package/dist/chunk-WUK4GWFW.js

@@ -1,523 +0,0 @@
-// 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/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/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/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);
-}
-
-// src/doctor/environment.ts
-import { readdirSync, readFileSync, statSync } from "fs";
-import { createRequire } from "module";
-import { join, relative } from "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(readFileSync(path, "utf8"));
-  } catch {
-    return void 0;
-  }
-}
-function resolvePackageJson(name, cwd) {
-  try {
-    const require2 = createRequire(join(cwd, "package.json"));
-    return readJson(require2.resolve(`${name}/package.json`));
-  } catch {
-    return void 0;
-  }
-}
-function isDirectorySafe(path) {
-  try {
-    return statSync(path).isDirectory();
-  } catch {
-    return void 0;
-  }
-}
-function safeRead(path) {
-  try {
-    return readFileSync(path, "utf8");
-  } catch {
-    return "";
-  }
-}
-function listDirectory(dir) {
-  try {
-    return 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 = 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 = 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(join(cwd, "package.json")),
-    sourceFiles,
-    outputFiles,
-    approvedDirFiles,
-    installedPackages: resolveInstalledPackages(cwd)
-  };
-}
-
-export {
-  parseVersion,
-  compareVersions,
-  satisfiesRange,
-  DOCTOR_CHECKS,
-  runDoctor,
-  renderHuman,
-  renderJson,
-  buildSnapshot
-};
-//# sourceMappingURL=chunk-WUK4GWFW.js.map

package/dist/chunk-WUK4GWFW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/semver-lite.ts","../src/doctor/doc-urls.ts","../src/doctor/finding.ts","../src/doctor/checks/approval-traces.ts","../src/doctor/checks/llms-before-you-start.ts","../src/doctor/checks/node-engine.ts","../src/doctor/checks/output-env.ts","../src/doctor/checks/parameter-arg0.ts","../src/doctor/checks/redaction-proof.ts","../src/doctor/checks/reporter-subpath.ts","../src/doctor/checks/sibling-packages.ts","../src/doctor/checks/silent-sink.ts","../src/doctor/checks/trace-object-keys.ts","../src/doctor/checks/vitest-peer.ts","../src/doctor/doctor.ts","../src/doctor/render.ts","../src/doctor/environment.ts"],"sourcesContent":["// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\n/**\n * Minimal semver range matcher covering exactly the range shapes this repository's own\n * `package.json` files use (`>=20`, `^1.0.0 || ^2.0.0 || ^3.0.0`, `1.x`): the doctor never needs to\n * parse an arbitrary npm range, only the ones NarrativeTrace itself declares in `engines` and\n * `peerDependencies`. A real `semver` dependency would cover forms this codebase never emits.\n */\n\nexport interface Version {\n  readonly major: number;\n  readonly minor: number;\n  readonly patch: number;\n}\n\n/** Parses `\"20.11.0\"`, `\"v20.11.0\"`, `\"20\"`, or `\"20.11\"` — missing parts default to zero. */\nexport function parseVersion(raw: string): Version | undefined {\n  const cleaned = raw.trim().replace(/^v/, \"\");\n  const match = /^(\\d+)(?:\\.(\\d+))?(?:\\.(\\d+))?/.exec(cleaned);\n  if (!match) return undefined;\n  return {\n    major: Number(match[1]),\n    minor: match[2] === undefined ? 0 : Number(match[2]),\n    patch: match[3] === undefined ? 0 : Number(match[3]),\n  };\n}\n\n/** Three-way compare, standard sign convention: negative if `left` < `right`, positive if greater. */\nexport function compareVersions(left: Version, right: Version): number {\n  if (left.major !== right.major) return left.major - right.major;\n  if (left.minor !== right.minor) return left.minor - right.minor;\n  return left.patch - right.patch;\n}\n\nfunction satisfiesGte(version: Version, floor: Version): boolean {\n  return compareVersions(version, floor) >= 0;\n}\n\n/** Standard caret semantics: `^1.2.3` := `>=1.2.3 <2.0.0`; `^0.2.3` := `>=0.2.3 <0.3.0`; `^0.0.3` := `>=0.0.3 <0.0.4`. */\nfunction satisfiesCaret(version: Version, base: Version): boolean {\n  if (compareVersions(version, base) < 0) return false;\n  if (base.major > 0) return version.major === base.major;\n  if (base.minor > 0) return version.major === 0 && version.minor === base.minor;\n  return version.major === 0 && version.minor === 0 && version.patch === base.patch;\n}\n\n/**\n * One `||`-separated clause: `^x.y.z`, `>=x.y.z`, `x.x`/`x.y.x` (caret-equivalent), or an exact\n * version. `trimmed` must already be whitespace-trimmed — {@link satisfiesRange} does that once\n * for every clause it splits out, so the prefix checks below (`startsWith(\"^\")`) see it without a\n * leading space.\n */\nfunction satisfiesClause(version: Version, trimmed: string): boolean {\n  if (trimmed.startsWith(\"^\")) {\n    const base = parseVersion(trimmed.slice(1));\n    return base !== undefined && satisfiesCaret(version, base);\n  }\n  if (trimmed.startsWith(\">=\")) {\n    const floor = parseVersion(trimmed.slice(2));\n    return floor !== undefined && satisfiesGte(version, floor);\n  }\n  if (/\\.x\\b/.test(trimmed)) {\n    const base = parseVersion(trimmed.replace(/\\.x/g, \".0\"));\n    return base !== undefined && satisfiesCaret(version, base);\n  }\n  const exact = parseVersion(trimmed);\n  return exact !== undefined && compareVersions(version, exact) === 0;\n}\n\n/**\n * Whether `versionRaw` satisfies `range` (`||`-separated clauses; a version satisfies the range if\n * it satisfies any one clause). Unparseable input on either side is a mismatch, never a throw — a\n * doctor check reports a finding, it does not crash the run.\n */\nexport function satisfiesRange(versionRaw: string, range: string): boolean {\n  const version = parseVersion(versionRaw);\n  if (!version) return false;\n  // Stryker disable next-line MethodExpression: dropping .filter(Boolean) is equivalent here —\n  // an empty clause (from \"||\" or a trailing/leading \"||\") only ever adds a `satisfiesClause(v,\n  // \"\")` call to the .some() chain, and that always returns false (parseVersion(\"\") is\n  // undefined, and \"\" matches none of the prefix checks either), so it can never flip the\n  // overall result. The filter is documentation of intent, not a behavior the type checker or a\n  // mutation test can observe.\n  return range\n    .split(\"||\")\n    .map((clause) => clause.trim())\n    .filter(Boolean)\n    .some((clause) => satisfiesClause(version, clause));\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\n/**\n * Public doc anchors every finding points at. The TypeScript runtime's guides are not yet\n * published on narrativetrace.ai (only the Java docs are, as of 2026-09 — see the doctor P1 run's\n * report for the amendment note); this repository is public on GitHub\n * (`publishConfig.access: \"public\"` on every package), so a stable blob link into `documentation/`\n * on `main` is the honest \"public docs URL\" today. Swap the base once the TS guides land on the\n * site — the anchors (GitHub's own heading slugs) do not change.\n */\nconst BASE = \"https://github.com/narrativetrace/narrativetrace-typescript/blob/main/documentation/\";\n\nexport const DOC = {\n  installationPrerequisites: `${BASE}installation-guide.md#prerequisites`,\n  installationDependencies: `${BASE}installation-guide.md#1-add-dependencies`,\n  vitestConfiguration: `${BASE}configuration-guide.md#2-vitest-configuration`,\n  whereSettingsComeFrom: `${BASE}configuration-guide.md#2b-where-settings-come-from`,\n  proxyOptions: `${BASE}configuration-guide.md#6-proxy-options`,\n  eventPipelineBuffering: `${BASE}configuration-guide.md#8-event-pipeline-buffering-bufferedeventconsumer`,\n  noTraceFilesWritten: `${BASE}troubleshooting.md#no-trace-files-are-written`,\n  manualParameterNames: `${BASE}troubleshooting.md#parameters-show-as-arg0-arg1`,\n  redactionSurfaceBySurface: `${BASE}privacy-and-redaction.md#redaction-surface-by-surface`,\n  approvalTracesEndToEnd: `${BASE}structural-trace-format.md#approval-traces-end-to-end`,\n  sixtySecondsNewProject: `${BASE}sixty-seconds.md#1-new-project-add-the-packages`,\n} as const;\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport type { Finding, FindingStatus } from \"./types.js\";\n\n/** A passing finding: no fix needed, by construction (see {@link Finding.fix}). */\nexport function pass(id: string, message: string, docUrl: string): Finding {\n  return { id, status: \"pass\" as FindingStatus, message, fix: \"\", docUrl };\n}\n\n/** A failing finding: `fix` is mandatory — a fail with nothing to do about it is a wording bug. */\nexport function fail(id: string, message: string, fix: string, docUrl: string): Finding {\n  return { id, status: \"fail\" as FindingStatus, message, fix, docUrl };\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"trap.approval-traces\";\nconst FIX =\n  \"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 — never commit a .received.nt file.\";\n\n/**\n * Approval traces (`.approved.nt` reviewed baselines, `.received.nt` written on a mismatch) landed\n * in the runtime's structural-trace layer. A `.received.nt` sitting in the approved directory is a\n * reviewed-but-not-yet-resolved diff — stale ones are exactly what `what-to-commit.md` warns never\n * to commit, and exactly what a doctor run should surface before someone else does.\n */\nexport const checkApprovalTraces: DoctorCheck = (snapshot) => {\n  const paths = [...snapshot.approvedDirFiles.keys()];\n  if (paths.length === 0) {\n    return pass(\n      ID,\n      \"no approval traces configured yet — nothing to check\",\n      DOC.approvalTracesEndToEnd,\n    );\n  }\n  const received = paths.filter((p) => p.endsWith(\".received.nt\"));\n  if (received.length > 0) {\n    const message = `${received.length} stale received trace(s) found: ${received.join(\", \")}`;\n    return fail(ID, message, FIX, DOC.approvalTracesEndToEnd);\n  }\n  const approved = paths.filter((p) => p.endsWith(\".approved.nt\"));\n  const message = `${approved.length} approved trace(s) found, no pending received diffs`;\n  return pass(ID, message, DOC.approvalTracesEndToEnd);\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"trap.llms-before-you-start\";\nconst PLAIN_JS = /\\.js$/;\nconst ESM_IMPORT = /^\\s*import\\s/m;\nconst FIX =\n  \"Run `npm pkg set type=module` before `npm add` — without it, Node throws SyntaxError: Cannot use import statement outside a module (pnpm/yarn default to it and never hit this).\";\n\n/**\n * `llms.txt`'s first \"before you start\" trap: a plain `.js` file using `import` syntax with no\n * `\"type\": \"module\"` in `package.json` throws `SyntaxError: Cannot use import statement outside a\n * module` the moment Node loads it — npm's default (unlike pnpm/yarn) does not set this for you.\n */\nexport const checkLlmsBeforeYouStart: DoctorCheck = (snapshot) => {\n  if (snapshot.rootPackageJson?.type === \"module\") {\n    return pass(ID, 'package.json declares \"type\": \"module\"', DOC.sixtySecondsNewProject);\n  }\n  const offender = [...snapshot.sourceFiles].find(\n    ([path, content]) => PLAIN_JS.test(path) && ESM_IMPORT.test(content),\n  );\n  if (!offender) {\n    const message = 'no plain .js file uses ESM import syntax without \"type\": \"module\"';\n    return pass(ID, message, DOC.sixtySecondsNewProject);\n  }\n  const [path] = offender;\n  const message = `${path} uses ESM import syntax but package.json has no \"type\": \"module\"`;\n  return fail(ID, message, FIX, DOC.sixtySecondsNewProject);\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { satisfiesRange } from \"../../semver-lite.js\";\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"toolchain.node-engine\";\nconst DEFAULT_ENGINE_RANGE = \">=20\";\n\n/** Node version required by whichever core NarrativeTrace package is installed, else the repo default. */\nfunction requiredRange(snapshot: Parameters<DoctorCheck>[0]): string {\n  const core = snapshot.installedPackages.get(\"@narrativetrace/core\");\n  const coreNode = snapshot.installedPackages.get(\"@narrativetrace/core-node\");\n  return core?.engines?.node ?? coreNode?.engines?.node ?? DEFAULT_ENGINE_RANGE;\n}\n\n/** Node engines (Installation Guide §Prerequisites): the running Node must satisfy the installed package's `engines.node`. */\nexport const checkNodeEngine: DoctorCheck = (snapshot) => {\n  const required = requiredRange(snapshot);\n  if (satisfiesRange(snapshot.nodeVersion, required)) {\n    return pass(\n      ID,\n      `Node ${snapshot.nodeVersion} satisfies the required ${required}`,\n      DOC.installationPrerequisites,\n    );\n  }\n  return fail(\n    ID,\n    `Node ${snapshot.nodeVersion} does not satisfy the required ${required}`,\n    `Upgrade Node to a version satisfying ${required} (nvm, volta, asdf, or your CI image).`,\n    DOC.installationPrerequisites,\n  );\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"config.output-env\";\nconst VALID_VALUES = new Set([\"true\", \"false\"]);\n\n/** `NARRATIVETRACE_OUTPUT`, if set, must be exactly `\"true\"` or `\"false\"` (case-insensitive). */\nexport const checkOutputEnv: DoctorCheck = (snapshot) => {\n  const raw = snapshot.env.NARRATIVETRACE_OUTPUT;\n  if (raw === undefined) {\n    return pass(\n      ID,\n      \"NARRATIVETRACE_OUTPUT is not set — output stays on its default (on)\",\n      DOC.whereSettingsComeFrom,\n    );\n  }\n  if (VALID_VALUES.has(raw.toLowerCase())) {\n    return pass(ID, `NARRATIVETRACE_OUTPUT=${raw}`, DOC.whereSettingsComeFrom);\n  }\n  return fail(\n    ID,\n    `NARRATIVETRACE_OUTPUT is set to '${raw}', which is neither \"true\" nor \"false\"`,\n    \"Set NARRATIVETRACE_OUTPUT=true or NARRATIVETRACE_OUTPUT=false (or unset it) — any other value is read as a truthy string, most likely turning output on when you meant to turn it off.\",\n    DOC.whereSettingsComeFrom,\n  );\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"trap.parameter-arg0\";\nconst ARG_PLACEHOLDER = /\\barg0\\b/;\nconst FIX =\n  'Pass parameter names explicitly: traceObject(target, context, { methodName: [\"paramA\", \"paramB\"] }) — required for classes you do not own, or when a build tool strips them.';\n\n/**\n * Parameter names of classes you don't own (or a build that strips them) are lost at compile\n * time and render as `arg0`, `arg1`, ... Doctor reads already-rendered output, if any exists, and\n * flags the tell-tale placeholder rather than guessing from source.\n */\nexport const checkParameterArg0: DoctorCheck = (snapshot) => {\n  if (snapshot.outputFiles.size === 0) {\n    const message = \"no rendered output found yet — run your tests or app once to check this\";\n    return pass(ID, message, DOC.manualParameterNames);\n  }\n  const offender = [...snapshot.outputFiles].find(([, content]) => ARG_PLACEHOLDER.test(content));\n  if (!offender) {\n    const message = \"rendered output carries real parameter names — no arg0 placeholders found\";\n    return pass(ID, message, DOC.manualParameterNames);\n  }\n  const [path] = offender;\n  const message = `rendered output shows arg0-style placeholders (first seen in ${path}) — parameter names were not captured`;\n  return fail(ID, message, FIX, DOC.manualParameterNames);\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"trap.redaction-proof\";\nconst TEST_FILE = /\\.(test|spec)\\.[cm]?[jt]sx?$/;\nconst REDACTED_ASSERTION = /\\[REDACTED\\]/;\n\n/**\n * Redaction is a security property; the trap named across every study is trusting it by\n * inspection rather than proving it — importing the redaction primitives and never asserting on\n * their output. This looks for a test that actually asserts the literal `[REDACTED]` marker.\n */\nexport const checkRedactionProof: DoctorCheck = (snapshot) => {\n  const testFiles = [...snapshot.sourceFiles].filter(([path]) => TEST_FILE.test(path));\n  const proven = testFiles.some(([, content]) => REDACTED_ASSERTION.test(content));\n  if (proven) {\n    return pass(\n      ID,\n      \"a test asserts [REDACTED] for a deny-listed parameter name\",\n      DOC.redactionSurfaceBySurface,\n    );\n  }\n  return fail(\n    ID,\n    \"no test asserts [REDACTED] — redaction is unproven\",\n    'Render a call with a deny-listed parameter name (e.g. \"password\", \"token\") in a test and assert the output contains \"[REDACTED]\" — and that a neighboring, non-sensitive value is still present, so an over-broad redaction also fails.',\n    DOC.redactionSurfaceBySurface,\n  );\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"config.reporter-subpath\";\nconst VITEST_CONFIG_NAME = /(^|\\/)vitest\\.config\\.[cm]?[jt]s$/;\nconst REPORTER_NAMES = /\\b(ClaritySuiteReporter|GlossarySuiteReporter|StructuralSuiteReporter)\\b/;\nconst ROOT_IMPORT = /from\\s+[\"']@narrativetrace\\/vitest[\"']/;\nconst SUBPATH_IMPORT = /from\\s+[\"']@narrativetrace\\/vitest\\/reporters[\"']/;\n\nfunction importsFromRoot(content: string): boolean {\n  return REPORTER_NAMES.test(content) && ROOT_IMPORT.test(content) && !SUBPATH_IMPORT.test(content);\n}\n\n/**\n * `ClaritySuiteReporter`/`GlossarySuiteReporter`/`StructuralSuiteReporter` must be imported from\n * the `/reporters` subpath — importing them from the package root also loads `vitest` itself,\n * which crashes config loading on every version (llms.txt \"Before you start\").\n */\nexport const checkReporterSubpath: DoctorCheck = (snapshot) => {\n  const configs = [...snapshot.sourceFiles].filter(([path]) => VITEST_CONFIG_NAME.test(path));\n  const offender = configs.find(([, content]) => importsFromRoot(content));\n  if (offender) {\n    const [path] = offender;\n    return fail(\n      ID,\n      `${path} imports a NarrativeTrace vitest reporter from the package root, not the /reporters subpath`,\n      'Import reporters from \"@narrativetrace/vitest/reporters\" — importing from the package root also loads vitest itself and crashes config loading.',\n      DOC.vitestConfiguration,\n    );\n  }\n  const message =\n    configs.length === 0\n      ? \"no vitest.config found — nothing to check\"\n      : \"every registered reporter is imported from the /reporters subpath\";\n  return pass(ID, message, DOC.vitestConfiguration);\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"toolchain.sibling-packages\";\n\n/**\n * `@narrativetrace/vitest` depends on five sibling `@narrativetrace/*` packages (clarity,\n * core-node, diagrams, glossary, proxy — not peers, regular dependencies). Under pnpm's default\n * strict layout those resolve fine from inside `@narrativetrace/vitest`'s own `node_modules`, but a\n * consumer that also imports one of them directly needs it resolvable from ITS OWN root too, or\n * pnpm's non-hoisting layout hands the app a second, unrelated copy. This check reads the sibling\n * list from the installed package itself (never a hardcoded list — it tracks the dependency as it\n * grows) and confirms each one resolves from the consumer.\n */\nexport const checkSiblingPackages: DoctorCheck = (snapshot) => {\n  const ntVitest = snapshot.installedPackages.get(\"@narrativetrace/vitest\");\n  if (!ntVitest) {\n    const message = \"@narrativetrace/vitest is not installed — nothing to check\";\n    return pass(ID, message, DOC.installationDependencies);\n  }\n  const siblings = Object.keys(ntVitest.dependencies ?? {}).filter((n) =>\n    n.startsWith(\"@narrativetrace/\"),\n  );\n  const unresolved = siblings.filter((name) => !snapshot.installedPackages.has(name));\n  if (unresolved.length === 0) {\n    const message = `all ${siblings.length} sibling package(s) of @narrativetrace/vitest resolve from the consumer`;\n    return pass(ID, message, DOC.installationDependencies);\n  }\n  const message = `${unresolved.length} sibling package(s) of @narrativetrace/vitest do not resolve from the consumer: ${unresolved.join(\", \")}`;\n  const fix = `Add ${unresolved.join(\", \")} as explicit direct dependencies — pnpm's strict layout does not hoist a dependency's own transitive dependencies to your project root.`;\n  return fail(ID, message, fix, DOC.installationDependencies);\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"trap.silent-sink\";\nconst TRACE_OBJECT_CALL = /\\btraceObject\\s*\\(/;\nconst SINK_SIGNAL =\n  /\\b(BufferedEventConsumer|captureTrace|registerConsumer|createNarrativeTest|narrativeTest)\\b|@narrativetrace\\/(vitest|pino|winston|opentelemetry|observability)\\b/;\n\n/**\n * The silent-sink trap: `traceObject()` proxies calls into events, but nothing narrates unless a\n * consumer/sink is attached (`BufferedEventConsumer`, `captureTrace()`, a log/OTel bridge, or the\n * vitest integration, which is its own sink). Wrapping without one of these is a project that looks\n * instrumented and narrates to nowhere.\n */\nexport const checkSilentSink: DoctorCheck = (snapshot) => {\n  const contents = [...snapshot.sourceFiles.values()];\n  if (!contents.some((content) => TRACE_OBJECT_CALL.test(content))) {\n    return pass(ID, \"traceObject() is not used — nothing to check\", DOC.noTraceFilesWritten);\n  }\n  if (contents.some((content) => SINK_SIGNAL.test(content))) {\n    return pass(\n      ID,\n      \"traceObject() is used and a consumer/sink is attached\",\n      DOC.noTraceFilesWritten,\n    );\n  }\n  return fail(\n    ID,\n    \"traceObject() is used but no consumer or sink (BufferedEventConsumer, captureTrace(), a log/OTel bridge, or @narrativetrace/vitest) was found\",\n    \"Attach a sink: pass a BufferedEventConsumer to your pipeline, call captureTrace() and do something with the tree, or wire a log/OTel bridge — otherwise every traced call narrates to nowhere.\",\n    DOC.noTraceFilesWritten,\n  );\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck } from \"../types.js\";\n\nconst ID = \"config.trace-object-keys\";\n\n// The valid nested shape is `methods: { methodName: { params: [...], ... } }` — a per-method\n// config OBJECT. The trap is skipping the method-config level and putting the param array\n// straight under a method name (`methods: { methodName: [...] }`), which now throws naming the\n// accepted per-method keys rather than the silent no-op it used to be. `[^{}]*` stops the match at\n// the first nested `{`, so the legitimate form (an object, not an array, under the method name)\n// never matches here.\nconst OLD_SHAPE = /\\bmethods\\s*:\\s*\\{[^{}]*:\\s*\\[/;\n\n/**\n * `traceObject`'s options used to silently no-op when a per-method entry skipped straight to an\n * array instead of the `{ params: [...] }` object (now throws, naming the accepted keys) — a\n * source file still shaped that way needs the method-config object added back, not just an\n * upgrade.\n */\nexport const checkTraceObjectKeys: DoctorCheck = (snapshot) => {\n  const offender = [...snapshot.sourceFiles].find(([, content]) => OLD_SHAPE.test(content));\n  if (offender) {\n    const [path] = offender;\n    return fail(\n      ID,\n      `${path} calls traceObject(...) with a method entry that skips the per-method config object`,\n      \"Nest the parameter names under params: traceObject(target, context, { methods: { methodName: { params: [...] } } }) — a bare array under the method name throws.\",\n      DOC.proxyOptions,\n    );\n  }\n  return pass(\n    ID,\n    \"no traceObject(...) call uses the old { methods: { ... } } option shape\",\n    DOC.proxyOptions,\n  );\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { satisfiesRange } from \"../../semver-lite.js\";\nimport { DOC } from \"../doc-urls.js\";\nimport { fail, pass } from \"../finding.js\";\nimport type { DoctorCheck, Finding, PackageJsonLike } from \"../types.js\";\n\nconst ID = \"toolchain.vitest-peer\";\n\nfunction noVitestInstalled(range: string): Finding {\n  const message = `@narrativetrace/vitest requires a peer vitest@${range}, but no vitest install was found`;\n  const fix = `Install a vitest version satisfying ${range} (npm add -D vitest, then npm ci for a clean lockfile install).`;\n  return fail(ID, message, fix, DOC.vitestConfiguration);\n}\n\nfunction mismatchedVitest(range: string, installed: string): Finding {\n  const message = `vitest@${installed} does not satisfy @narrativetrace/vitest's declared peer range ${range}`;\n  const fix = `Install a vitest version satisfying ${range}, then reinstall clean (rm -rf node_modules && npm ci) — a mismatched peer here is the one failure mode that breaks the library's own build.`;\n  return fail(ID, message, fix, DOC.vitestConfiguration);\n}\n\nfunction evaluateInstalledVitest(range: string, vitest: PackageJsonLike | undefined): Finding {\n  if (!vitest?.version) return noVitestInstalled(range);\n  if (satisfiesRange(vitest.version, range)) {\n    const message = `vitest@${vitest.version} satisfies the declared peer range ${range}`;\n    return pass(ID, message, DOC.vitestConfiguration);\n  }\n  return mismatchedVitest(range, vitest.version);\n}\n\n/** The installed `vitest` version must satisfy `@narrativetrace/vitest`'s declared peer range. */\nexport const checkVitestPeer: DoctorCheck = (snapshot) => {\n  const ntVitest = snapshot.installedPackages.get(\"@narrativetrace/vitest\");\n  const range = ntVitest?.peerDependencies?.vitest;\n  if (!ntVitest || !range) {\n    return pass(\n      ID,\n      \"@narrativetrace/vitest is not installed — nothing to check\",\n      DOC.vitestConfiguration,\n    );\n  }\n  return evaluateInstalledVitest(range, snapshot.installedPackages.get(\"vitest\"));\n};\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { checkApprovalTraces } from \"./checks/approval-traces.js\";\nimport { checkLlmsBeforeYouStart } from \"./checks/llms-before-you-start.js\";\nimport { checkNodeEngine } from \"./checks/node-engine.js\";\nimport { checkOutputEnv } from \"./checks/output-env.js\";\nimport { checkParameterArg0 } from \"./checks/parameter-arg0.js\";\nimport { checkRedactionProof } from \"./checks/redaction-proof.js\";\nimport { checkReporterSubpath } from \"./checks/reporter-subpath.js\";\nimport { checkSiblingPackages } from \"./checks/sibling-packages.js\";\nimport { checkSilentSink } from \"./checks/silent-sink.js\";\nimport { checkTraceObjectKeys } from \"./checks/trace-object-keys.js\";\nimport { checkVitestPeer } from \"./checks/vitest-peer.js\";\nimport type { DoctorCheck, DoctorReport, DoctorSnapshot } from \"./types.js\";\n\n/**\n * Every check `narrativetrace doctor` runs, in stable, documented order. Adding a check means\n * appending here — the id is what stays stable across releases, not the position.\n */\nexport const DOCTOR_CHECKS: readonly DoctorCheck[] = [\n  checkNodeEngine,\n  checkVitestPeer,\n  checkSiblingPackages,\n  checkOutputEnv,\n  checkReporterSubpath,\n  checkTraceObjectKeys,\n  checkSilentSink,\n  checkParameterArg0,\n  checkRedactionProof,\n  checkApprovalTraces,\n  checkLlmsBeforeYouStart,\n];\n\n/** Runs every check over `snapshot` and derives the process exit code. Read-only: mutates nothing. */\nexport function runDoctor(snapshot: DoctorSnapshot): DoctorReport {\n  const findings = DOCTOR_CHECKS.map((check) => check(snapshot));\n  const exitCode = findings.some((f) => f.status === \"fail\") ? 1 : 0;\n  return { findings, exitCode };\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport type { DoctorReport, Finding } from \"./types.js\";\n\nfunction renderFinding(finding: Finding): string[] {\n  const tag = finding.status === \"fail\" ? \"FAIL\" : \"PASS\";\n  const lines = [`[${tag}] ${finding.id} — ${finding.message}`];\n  if (finding.status === \"fail\") {\n    lines.push(`  fix:  ${finding.fix}`, `  docs: ${finding.docUrl}`);\n  }\n  lines.push(\"\");\n  return lines;\n}\n\n/** Human-readable default output: one block per finding, worst-first (failures before passes). */\nexport function renderHuman(report: DoctorReport): string {\n  const failing = report.findings.filter((f) => f.status === \"fail\");\n  const passing = report.findings.filter((f) => f.status === \"pass\");\n  const header = `narrativetrace doctor — ${report.findings.length} check(s), ${failing.length} finding(s)`;\n  const summary =\n    failing.length === 0\n      ? \"All checks passed.\"\n      : `${failing.length} finding(s). Exit code ${report.exitCode}.`;\n  const body = [...failing, ...passing].flatMap(renderFinding);\n  return [header, \"\", ...body, summary].join(\"\\n\");\n}\n\n/** Machine-readable `--json` output: the report verbatim, stable field names. */\nexport function renderJson(report: DoctorReport): string {\n  return JSON.stringify(report, null, 2);\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join, relative } from \"node:path\";\nimport type { DoctorSnapshot, Env, PackageJsonLike } from \"./types.js\";\n\nconst EXCLUDED_DIRS = new Set([\n  // Stryker disable next-line StringLiteral: equivalent — every dot-prefixed entry name is\n  // already excluded earlier, in visitEntry's leading-dot check (the only exception there is\n  // \".env\", which isn't a directory this set would ever mention), so \".git\" never actually\n  // reaches this set's `.has()` check.\n  \".git\",\n  // Stryker disable next-line StringLiteral: same equivalence as \".git\" above.\n  \".turbo\",\n  // Stryker disable next-line StringLiteral: same equivalence as \".git\" above.\n  \".stryker-tmp\",\n  // Not dot-prefixed, so NOT equivalent — reaching this set's `.has()` check is the only thing\n  // that excludes each of the four names below; each is covered by a real test.\n  \"node_modules\",\n  \"dist\",\n  \"build\",\n  \"coverage\",\n]);\n\nconst SOURCE_EXTENSIONS = [\".ts\", \".tsx\", \".js\", \".jsx\", \".mjs\", \".cjs\", \".mts\", \".cts\"];\n\n/** Well-known package names the checks resolve directly; siblings of @narrativetrace/vitest are added dynamically. */\nconst BASE_PACKAGES = [\n  \"vitest\",\n  \"@narrativetrace/core\",\n  \"@narrativetrace/core-node\",\n  \"@narrativetrace/vitest\",\n];\n\nconst MAX_FILES = 20_000;\n\ntype Bucket = \"output\" | \"approved\" | \"source\" | \"skip\";\n\ninterface WalkState {\n  readonly sourceFiles: Map<string, string>;\n  readonly outputFiles: Map<string, string>;\n  readonly approvedDirFiles: Map<string, string>;\n  visited: number;\n}\n\n// Stryker disable BlockStatement: the three functions below whose catch block is just `return\n// undefined;` are equivalent under mutation — an emptied `catch {}` falls off the end of the\n// function and implicitly returns `undefined` too. No test can observe a difference between the\n// explicit and implicit forms. Restored below, before safeRead/listDirectory, whose catch blocks\n// return \"\" / [] respectively and are NOT equivalent (a real behavior change is observable there).\n\nfunction readJson(path: string): PackageJsonLike | undefined {\n  try {\n    return JSON.parse(readFileSync(path, \"utf8\")) as PackageJsonLike;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolvePackageJson(name: string, cwd: string): PackageJsonLike | undefined {\n  try {\n    const require = createRequire(join(cwd, \"package.json\"));\n    return readJson(require.resolve(`${name}/package.json`));\n  } catch {\n    return undefined;\n  }\n}\n\n/** `undefined` when `path` cannot be stat'd at all (a dangling symlink, a permission error, a race). */\nfunction isDirectorySafe(path: string): boolean | undefined {\n  try {\n    return statSync(path).isDirectory();\n  } catch {\n    return undefined;\n  }\n}\n\n// Stryker restore BlockStatement\n\nfunction safeRead(path: string): string {\n  try {\n    return readFileSync(path, \"utf8\");\n  } catch {\n    return \"\";\n  }\n}\n\nfunction listDirectory(dir: string): string[] {\n  try {\n    return readdirSync(dir);\n  } catch {\n    return [];\n  }\n}\n\nfunction classify(rel: string, outputDirName: string, approvedDirName: string): Bucket {\n  const topSegment = rel.split(\"/\")[0];\n  if (topSegment === outputDirName) return \"output\";\n  if (topSegment === approvedDirName) return \"approved\";\n  // Stryker disable next-line StringLiteral: the \"source\" branch string is equivalent — bucketFor\n  // below routes anything that isn't \"output\" or \"approved\" into sourceFiles by default, so\n  // whether this literal reads \"source\" or something else never changes which map a file lands\n  // in. The \"skip\" branch is NOT equivalent (a real behavior change is observable there) and is\n  // exercised by a real test.\n  return SOURCE_EXTENSIONS.some((ext) => rel.endsWith(ext)) ? \"source\" : \"skip\";\n}\n\nfunction bucketFor(state: WalkState, kind: Bucket): Map<string, string> {\n  return kind === \"output\"\n    ? state.outputFiles\n    : kind === \"approved\"\n      ? state.approvedDirFiles\n      : state.sourceFiles;\n}\n\ninterface WalkContext {\n  readonly state: WalkState;\n  readonly root: string;\n  readonly output: string;\n  readonly approved: string;\n  readonly queue: string[];\n}\n\n/** Visits one directory entry: enqueues a subdirectory, or files it into the right bucket. */\nfunction visitEntry(ctx: WalkContext, dir: string, entry: string): void {\n  if (entry.startsWith(\".\") && entry !== \".env\") return;\n  const full = join(dir, entry);\n  const isDir = isDirectorySafe(full);\n  if (isDir === undefined) return;\n  if (isDir) {\n    if (!EXCLUDED_DIRS.has(entry)) ctx.queue.push(full);\n    return;\n  }\n  ctx.state.visited++;\n  const rel = relative(ctx.root, full);\n  const kind = classify(rel, ctx.output, ctx.approved);\n  if (kind === \"skip\") return;\n  bucketFor(ctx.state, kind).set(rel, safeRead(full));\n}\n\n/**\n * Walks `root` breadth-first, bucketing files into source (extension-filtered), the output\n * directory, and the approved-trace directory — excluding `node_modules`/build/coverage noise.\n * Bounded by {@link MAX_FILES} so a doctor run in a huge repo degrades to a partial scan rather\n * than hanging. The outer loop's own `state.visited < MAX_FILES` half of that bound is equivalent\n * under mutation — the inner loop's `if (state.visited >= MAX_FILES) break;` enforces the exact\n * same cap on its own, before any further entry is ever visited, so weakening the outer guard only\n * costs a few extra, immediately aborted `listDirectory` calls on already-queued directories; no\n * test can observe a different `WalkState`.\n */\nfunction walk(root: string, output: string, approved: string): WalkState {\n  const state: WalkState = {\n    sourceFiles: new Map(),\n    outputFiles: new Map(),\n    approvedDirFiles: new Map(),\n    visited: 0,\n  };\n  const ctx: WalkContext = { state, root, output, approved, queue: [root] };\n  // Stryker disable next-line ConditionalExpression,EqualityOperator: see the doc comment above.\n  while (ctx.queue.length > 0 && state.visited < MAX_FILES) {\n    const dir = ctx.queue.shift() as string;\n    for (const entry of listDirectory(dir)) {\n      if (state.visited >= MAX_FILES) break;\n      visitEntry(ctx, dir, entry);\n    }\n  }\n  return state;\n}\n\nfunction resolveBasePackages(cwd: string): Map<string, PackageJsonLike> {\n  const installed = new Map<string, PackageJsonLike>();\n  for (const name of BASE_PACKAGES) {\n    const pkg = resolvePackageJson(name, cwd);\n    if (pkg) installed.set(name, pkg);\n  }\n  return installed;\n}\n\n/** Resolves `@narrativetrace/vitest`'s own `@narrativetrace/*` dependencies — the sibling check's data. */\nfunction resolveVitestSiblings(cwd: string, installed: Map<string, PackageJsonLike>): void {\n  const ntVitest = installed.get(\"@narrativetrace/vitest\");\n  for (const name of Object.keys(ntVitest?.dependencies ?? {})) {\n    if (!name.startsWith(\"@narrativetrace/\") || installed.has(name)) continue;\n    const pkg = resolvePackageJson(name, cwd);\n    if (pkg) installed.set(name, pkg);\n  }\n}\n\nfunction resolveInstalledPackages(cwd: string): Map<string, PackageJsonLike> {\n  const installed = resolveBasePackages(cwd);\n  resolveVitestSiblings(cwd, installed);\n  return installed;\n}\n\n/** Builds a {@link DoctorSnapshot} from the real filesystem rooted at `cwd`. The one impure module. */\nexport function buildSnapshot(cwd: string, env: Env): DoctorSnapshot {\n  const output = env.NARRATIVETRACE_OUTPUT_DIR ?? \"narrativetrace-output\";\n  const approved = env.NARRATIVETRACE_APPROVED_DIR ?? \"narratives\";\n  const { sourceFiles, outputFiles, approvedDirFiles } = walk(cwd, output, approved);\n  return {\n    cwd,\n    nodeVersion: process.version.replace(/^v/, \"\"),\n    env,\n    rootPackageJson: readJson(join(cwd, \"package.json\")),\n    sourceFiles,\n    outputFiles,\n    approvedDirFiles,\n    installedPackages: resolveInstalledPackages(cwd),\n  };\n}\n"],"mappings":"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","names":["message","ID","FIX","path","message","ID","ID","ID","FIX","message","ID","ID","ID","message","ID","ID","ID","require"]}