headlamp 0.1.14 → 0.1.16

package/README.md

@@ -69,6 +69,22 @@ npx headlamp --onlyFailures
 npx headlamp --changed --onlyFailures
 ```
 
+- `--showConsole[=true|false]`:
+  - When enabled, Headlamp prints a dedicated "Logs" section under each failing test and failing file with the full console output captured by the runner.
+  - By default (without this flag), Headlamp shows a condensed "Console errors" snippet with only the most relevant error messages. `--showConsole` includes all console entries (log/info/warn/error).
+  - Supported forms: `--showConsole`, `--showConsole=true`, `--showConsole=false`.
+  - Works alongside `--onlyFailures`, coverage flags, and selection flags.
+
+Examples:
+
+```bash
+# Always include the full console output for each failure
+npx headlamp --showConsole
+
+# Combine with only failures visible during the run
+npx headlamp --onlyFailures --showConsole
+```
+
 ## Changed-file selection
 
 - `--changed[=mode]` selects tests by files changed in your working tree or branch.
@@ -83,6 +99,8 @@ npx headlamp --changed --onlyFailures
   - Effects:
     - Uses changed production files as seeds to discover related tests by import-graph.
     - Coverage tables prioritize and annotate files related to selection/changed files.
+  - Additional flags:
+    - `--changed.depth=<n>`: cap the transitive import scan depth when refining related tests from changed production files. Default: 5. Increase to include more indirectly-related tests (slower), decrease for speed.
 
 Examples:
 
@@ -100,6 +118,16 @@ npx headlamp --changed=branch
 npx headlamp --coverage --changed=branch
 ```
 
+Depth examples:
+
+```bash
+# Scan imports up to 10 levels deep when resolving related tests for changed files
+npx headlamp --changed=all --changed.depth=10
+
+# With branch mode
+npx headlamp --changed=branch --changed.depth=12
+```
+
 ## Coverage flags
 
 - `--coverage`: enables coverage collection and prints merged coverage output after test execution. Uses your project's Jest/Vitest setup and reads coverage JSON from Jest.

package/dist/cli.cjs

@@ -249,6 +249,7 @@ var init_args = __esm({
       coverageUi: (value) => ({ type: "coverageUi", value }),
       coverageAbortOnFailure: (value) => ({ type: "coverageAbortOnFailure", value }),
       onlyFailures: (value) => ({ type: "onlyFailures", value }),
+      showConsole: (value) => ({ type: "showConsole", value }),
       jestArg: (value) => ({ type: "jestArg", value }),
       jestArgs: (values) => ({ type: "jestArgs", values }),
       vitestArg: (value) => ({ type: "vitestArg", value }),
@@ -265,7 +266,8 @@ var init_args = __esm({
       coverageMaxFiles: (value) => ({ type: "coverageMaxFiles", value }),
       coverageMaxHotspots: (value) => ({ type: "coverageMaxHotspots", value }),
       coveragePageFit: (value) => ({ type: "coveragePageFit", value }),
-      changed: (value) => ({ type: "changed", value })
+      changed: (value) => ({ type: "changed", value }),
+      changedDepth: (value) => ({ type: "changedDepth", value })
     };
     Some = (value) => ({ _tag: "some", value });
     None = { _tag: "none" };
@@ -414,6 +416,18 @@ var init_args = __esm({
           "--onlyFailures",
           (_flag, lookahead) => step([ActionBuilders.onlyFailures(isTruthy(String(lookahead)))], true)
         ),
+        // --showConsole flag (boolean)
+        rule.eq("--showConsole", () => step([ActionBuilders.showConsole(true)])),
+        rule.startsWith(
+          "--showConsole=",
+          (value) => step([
+            ActionBuilders.showConsole(isTruthy((value.split("=")[1] ?? "").trim().toLowerCase()))
+          ])
+        ),
+        rule.withLookahead(
+          "--showConsole",
+          (_flag, lookahead) => step([ActionBuilders.showConsole(isTruthy(String(lookahead)))], true)
+        ),
         rule.withLookahead(
           "--testPathPattern",
           (flag, lookahead) => step([ActionBuilders.jestArgs([flag, lookahead])], true)
@@ -486,6 +500,16 @@ var init_args = __esm({
           const mode = raw === "staged" ? "staged" : raw === "unstaged" ? "unstaged" : raw === "branch" ? "branch" : "all";
           return step([ActionBuilders.changed(mode)], true);
         }),
+        // --changed.depth flag: maximum transitive import depth for changed selection refinement
+        rule.startsWith("--changed.depth=", (value) => {
+          const raw = (value.split("=")[1] ?? "").trim();
+          const num = Number(raw);
+          return step(Number.isFinite(num) && num > 0 ? [ActionBuilders.changedDepth(num)] : []);
+        }),
+        rule.withLookahead("--changed.depth", (_flag, lookahead) => {
+          const num = Number(String(lookahead).trim());
+          return step(Number.isFinite(num) && num > 0 ? [ActionBuilders.changedDepth(num)] : [], true);
+        }),
         rule.withLookahead(
           "-t",
           (flag, lookahead) => step(
@@ -562,6 +586,8 @@ var init_args = __esm({
           return { vitest: [], jest: [], coverage: false, coverageAbortOnFailure: action.value };
         case "onlyFailures":
           return { vitest: [], jest: [], coverage: false, onlyFailures: action.value };
+        case "showConsole":
+          return { vitest: [], jest: [], coverage: false, showConsole: action.value };
         case "jestArgs":
           return { vitest: [], jest: action.values, coverage: false };
         case "selectionHint":
@@ -592,6 +618,8 @@ var init_args = __esm({
           return { vitest: [], jest: [], coverage: false, coveragePageFit: action.value };
         case "changed":
           return { vitest: [], jest: [], coverage: false, changed: action.value };
+        case "changedDepth":
+          return { vitest: [], jest: [], coverage: false, changedDepth: action.value };
         case "jestArg":
           return { vitest: [], jest: [action.value], coverage: false };
         case "vitestArg":
@@ -632,8 +660,10 @@ var init_args = __esm({
       return {
         ...next,
         ...right.changed !== void 0 || left.changed !== void 0 ? { changed: right.changed ?? left.changed } : {},
+        ...right.changedDepth !== void 0 || left.changedDepth !== void 0 ? { changedDepth: right.changedDepth ?? left.changedDepth } : {},
         ...right.coverageAbortOnFailure !== void 0 || left.coverageAbortOnFailure !== void 0 ? { coverageAbortOnFailure: right.coverageAbortOnFailure ?? left.coverageAbortOnFailure } : {},
         ...right.onlyFailures !== void 0 || left.onlyFailures !== void 0 ? { onlyFailures: right.onlyFailures ?? left.onlyFailures } : {},
+        ...right.showConsole !== void 0 || left.showConsole !== void 0 ? { showConsole: right.showConsole ?? left.showConsole } : {},
         ...right.coverageDetail !== void 0 || left.coverageDetail !== void 0 ? { coverageDetail: right.coverageDetail ?? left.coverageDetail } : {},
         ...right.coverageShowCode !== void 0 || left.coverageShowCode !== void 0 ? { coverageShowCode: right.coverageShowCode ?? left.coverageShowCode } : {},
         ...right.coverageMode !== void 0 || left.coverageMode !== void 0 ? { coverageMode: right.coverageMode ?? left.coverageMode } : {},
@@ -658,6 +688,7 @@ var init_args = __esm({
       let coverageUi = "both";
       let coverageAbortOnFailure = false;
       let onlyFailures = false;
+      let showConsole = false;
       let coverageShowCode = Boolean(process.stdout.isTTY);
       let coverageMode = "auto";
       const coverageMaxFilesLocalInit = void 0;
@@ -676,6 +707,7 @@ var init_args = __esm({
       coverageUi = contrib.coverageUi ?? coverageUi;
       coverageAbortOnFailure = contrib.coverageAbortOnFailure ?? coverageAbortOnFailure;
       onlyFailures = contrib.onlyFailures ?? onlyFailures;
+      showConsole = contrib.showConsole ?? showConsole;
       coverageShowCode = contrib.coverageShowCode ?? coverageShowCode;
       const coverageDetailComputed = contrib.coverageDetail ?? (contrib.selection ? "auto" : void 0);
       coverageMode = contrib.coverageMode ?? (contrib.selection ? "compact" : "auto");
@@ -710,6 +742,7 @@ var init_args = __esm({
         coverageUi,
         coverageAbortOnFailure,
         onlyFailures,
+        showConsole,
         selectionSpecified: Boolean(contrib.selection),
         selectionPaths: [...contrib.selectionPaths ?? []],
         includeGlobs,
@@ -722,7 +755,8 @@ var init_args = __esm({
         coveragePageFit,
         ...contrib.editorCmd !== void 0 ? { editorCmd: contrib.editorCmd } : {},
         ...contrib.workspaceRoot !== void 0 ? { workspaceRoot: contrib.workspaceRoot } : {},
-        ...contrib.changed !== void 0 ? { changed: contrib.changed } : {}
+        ...contrib.changed !== void 0 ? { changed: contrib.changed } : {},
+        ...contrib.changedDepth !== void 0 ? { changedDepth: contrib.changedDepth } : {}
       };
       return out;
     };
@@ -5074,24 +5108,43 @@ var buildStackSection = (mergedForStack, ctx, fallbackLoc) => {
 };
 var MAX_CONSOLE_ERRORS_TO_SHOW = 3;
 var isConsoleEntry = (candidate) => typeof candidate === "object" && candidate !== null;
-var buildConsoleSection = (maybeConsole) => {
+var buildConsoleSection = (maybeConsole, opts) => {
   const out = [];
   if (!Array.isArray(maybeConsole)) {
     return out;
   }
   const entries = maybeConsole.filter(isConsoleEntry);
-  const errorsOnly = entries.filter((entry) => String(entry?.type ?? "").toLowerCase() === "error");
-  const scored = errorsOnly.map((entry) => {
-    const raw = entry?.message;
-    const msg = Array.isArray(raw) ? raw.map(String).join(" ") : typeof raw === "string" ? raw : String(raw ?? "");
-    return { msg, score: msg.length };
-  }).filter((item) => item.msg.trim().length > 0).sort((left, right) => right.score - left.score).slice(0, MAX_CONSOLE_ERRORS_TO_SHOW);
-  if (scored.length) {
-    out.push(ansi.dim("    Console errors:"));
-    for (const item of scored) {
-      out.push(`      ${ansi.dim("\u2022")} ${item.msg}`);
+  if (opts?.full) {
+    const toMsg = (entry) => {
+      const type = String(entry?.type ?? "").toLowerCase();
+      const raw = entry?.message;
+      const msg = Array.isArray(raw) ? raw.map(String).join(" ") : typeof raw === "string" ? raw : String(raw ?? "");
+      const origin = String(entry?.origin ?? "");
+      const typeFmt = type ? `${ansi.white(type)}: ` : "";
+      const originFmt = origin ? ` ${ansi.dim(`(${origin})`)}` : "";
+      return `      ${ansi.dim("\u2022")} ${typeFmt}${msg}${originFmt}`;
+    };
+    const lines = entries.map(toMsg).filter((ln) => stripAnsiSimple(ln).trim().length > 0);
+    if (lines.length) {
+      out.push(ansi.dim("    Logs:"));
+      out.push(...lines, "");
+    }
+  } else {
+    const errorsOnly = entries.filter(
+      (entry) => String(entry?.type ?? "").toLowerCase() === "error"
+    );
+    const scored = errorsOnly.map((entry) => {
+      const raw = entry?.message;
+      const msg = Array.isArray(raw) ? raw.map(String).join(" ") : typeof raw === "string" ? raw : String(raw ?? "");
+      return { msg, score: msg.length };
+    }).filter((item) => item.msg.trim().length > 0).sort((left, right) => right.score - left.score).slice(0, MAX_CONSOLE_ERRORS_TO_SHOW);
+    if (scored.length) {
+      out.push(ansi.dim("    Console errors:"));
+      for (const item of scored) {
+        out.push(`      ${ansi.dim("\u2022")} ${item.msg}`);
+      }
+      out.push("");
     }
-    out.push("");
   }
   return out;
 };
@@ -5153,8 +5206,8 @@ var buildThrownSection = (details) => {
     }
   };
   const candidates = [];
-  for (const d of details) {
-    const obj = d && typeof d === "object" ? d : null;
+  for (const detailEntry of details) {
+    const obj = detailEntry && typeof detailEntry === "object" ? detailEntry : null;
     if (obj && obj.error && typeof obj.error === "object") {
       const err = obj.error;
       if (typeof err.name === "string") {
@@ -5351,7 +5404,7 @@ var renderChunks = (chunks, ctx, fns, opts) => {
 
 // src/lib/formatter/context.ts
 var fs5 = __toESM(require("node:fs"), 1);
-var makeCtx = (opts, showStacks = false) => {
+var makeCtx = (opts, showStacks = false, showConsole = false) => {
   const cwd = (opts?.cwd ?? process.cwd()).replace(/\\/g, "/");
   const width = Math.max(
     40,
@@ -5367,7 +5420,15 @@ var makeCtx = (opts, showStacks = false) => {
       return [];
     }
   };
-  return { cwd, width, showStacks, projectHint, editorCmd: opts?.editorCmd, readSource: readSource2 };
+  return {
+    cwd,
+    width,
+    showStacks,
+    showConsole,
+    projectHint,
+    editorCmd: opts?.editorCmd,
+    readSource: readSource2
+  };
 };
 
 // src/lib/formatter/bridge/tryBridgeFallback.ts
@@ -5689,7 +5750,9 @@ var renderFileLevelFailure = (file, ctx) => {
     suppressDiff: pretty.length > 0,
     stackPreview
   });
-  const consoleBlock = buildConsoleSection(stripBridgeEventsFromConsole(file.console ?? null));
+  const consoleBlock = buildConsoleSection(stripBridgeEventsFromConsole(file.console ?? null), {
+    full: Boolean(ctx.showConsole)
+  });
   const stackTail = ctx.showStacks && stackPreview.length === 0 ? (() => {
     const tail = mergedForStack.filter((ln) => isStackLine(stripAnsiSimple(ln))).slice(-4).map((ln) => `      ${colorStackLine(String(ln), ctx.projectHint)}`);
     return tail.length ? [ansi.dim("    Stack:"), ...tail, ""] : empty;
@@ -6004,7 +6067,9 @@ var renderFailedAssertion = (args) => {
       return empty;
     }
   })() : empty;
-  const consoleBlock = buildConsoleSection(stripBridgeEventsFromConsole(file.console ?? null));
+  const consoleBlock = buildConsoleSection(stripBridgeEventsFromConsole(file.console ?? null), {
+    full: Boolean(ctx.showConsole)
+  });
   const stackTail = ctx.showStacks && stackPreview.length === 0 ? (() => {
     const merged = collapseStacks([...msgLines, ...details.stacks]);
     const tail = collapseStacks(merged).filter((ln) => isStackLine(stripAnsiSimple(ln))).slice(-4).map((ln) => `      ${colorStackLine(String(ln), ctx.projectHint)}`);
@@ -6101,7 +6166,11 @@ var formatJestOutputVitest = (raw, opts) => pipe(
   { raw, opts },
   (state) => ({
     ...state,
-    ctx: makeCtx(state.opts, /\bFAIL\b/.test(stripAnsiSimple(state.raw)))
+    ctx: makeCtx(
+      state.opts,
+      /\bFAIL\b/.test(stripAnsiSimple(state.raw)),
+      Boolean(state.opts?.showConsole)
+    )
   }),
   (state) => ({ ...state, chunks: parseChunks(state.raw) }),
   (state) => ({
@@ -6456,6 +6525,7 @@ var program = async () => {
     coverageUi,
     coverageAbortOnFailure,
     onlyFailures,
+    showConsole,
     selectionSpecified,
     selectionPaths,
     includeGlobs,
@@ -6468,7 +6538,8 @@ var program = async () => {
     coverageMaxFiles: coverageMaxFilesArg,
     coverageMaxHotspots: coverageMaxHotspotsArg,
     coveragePageFit,
-    changed
+    changed,
+    changedDepth
   } = deriveArgs(argv);
   const getChangedFiles = async (mode, cwd) => {
     const collect = async (cmd, args) => {
@@ -6940,7 +7011,7 @@ var program = async () => {
         resolutionCache.set(key, resolved);
         return resolved;
       };
-      const MAX_DEPTH = 5;
+      const MAX_DEPTH = Number.isFinite(Number(changedDepth)) && Number(changedDepth) > 0 ? Number(changedDepth) : 5;
       const seen = /* @__PURE__ */ new Set();
       const matchesTransitively = async (absTestPath, depth) => {
         if (depth > MAX_DEPTH) {
@@ -7157,7 +7228,8 @@ var program = async () => {
             reordered,
             makeCtx(
               { cwd: repoRootForDiscovery, ...editorCmd !== void 0 ? { editorCmd } : {} },
-              /\bFAIL\b/.test(stripAnsiSimple(output))
+              /\bFAIL\b/.test(stripAnsiSimple(output)),
+              Boolean(showConsole)
             ),
             { onlyFailures }
           );
@@ -7166,7 +7238,8 @@ var program = async () => {
             bridge,
             makeCtx(
               { cwd: repoRootForDiscovery, ...editorCmd !== void 0 ? { editorCmd } : {} },
-              /\bFAIL\b/.test(stripAnsiSimple(output))
+              /\bFAIL\b/.test(stripAnsiSimple(output)),
+              Boolean(showConsole)
             ),
             { onlyFailures }
           );
@@ -7268,7 +7341,8 @@ ${stripFooter(rawAlso)}`.trimEnd();
       unified,
       makeCtx(
         { cwd: repoRootForDiscovery, ...editorCmd !== void 0 ? { editorCmd } : {} },
-        showStacks
+        showStacks,
+        Boolean(showConsole)
       ),
       { onlyFailures }
     );