headlamp 0.1.8 → 0.1.10

package/README.md

@@ -52,11 +52,60 @@ npx headlamp --coverage
 npx headlamp --coverage src/services/user.ts src/components/UserCard.tsx
 ```
 
+## Output flags
+
+- `--onlyFailures[=true|false]`:
+  - When enabled, the CLI prints only failing tests during execution across all views, while still printing the final test summary (files/tests/time) at the end.
+  - Supported forms: `--onlyFailures`, `--onlyFailures=true`, `--onlyFailures=false`.
+  - Works with other selection flags (e.g., `-t`, `--changed`).
+
+Examples:
+
+```bash
+# Show only failures during the run, but still print the final summary
+npx headlamp --onlyFailures
+
+# Combine with changed-file selection
+npx headlamp --changed --onlyFailures
+```
+
+## Changed-file selection
+
+- `--changed[=mode]` selects tests by files changed in your working tree or branch.
+  - Modes:
+    - `all` (default when `--changed` is passed without a value): includes staged + unstaged + untracked files.
+    - `staged`: only staged changes.
+    - `unstaged`: only unstaged + untracked files.
+    - `branch`: union of
+      - files changed on the current branch relative to the default branch (via merge-base), and
+      - your current uncommitted changes (staged, unstaged tracked, and untracked files).
+      - Default branch is resolved via `origin/HEAD` when available, falling back to `origin/main` or `origin/master`.
+  - 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.
+
+Examples:
+
+```bash
+# Staged changes only
+npx headlamp --changed=staged
+
+# All working tree changes
+npx headlamp --changed
+
+# Diff current branch against default branch (merge-base)
+npx headlamp --changed=branch
+
+# Combine with coverage
+npx headlamp --coverage --changed=branch
+```
+
 ## 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.
   - Prints a compact per-file table with hotspots and optionally detailed per-file breakdowns.
   - Honors file selection and include/exclude globs when rendering coverage tables.
+  - When `--changed` is specified, coverage views factor in those changed files as selection seeds, influencing relevancy ordering and the “changed-related” highlighting.
 - `--coverage.abortOnFailure`: if tests fail, exit immediately with the test exit code and skip coverage printing. Useful in CI when failures should short-circuit.
 - `--coverage.ui=jest|both`:
   - `jest`: write Istanbul text report to `coverage/merged/coverage.txt` only.

package/dist/cli.cjs

@@ -248,6 +248,7 @@ var init_args = __esm({
       coverage: (coverageValue) => ({ type: "coverage", coverageValue }),
       coverageUi: (value) => ({ type: "coverageUi", value }),
       coverageAbortOnFailure: (value) => ({ type: "coverageAbortOnFailure", value }),
+      onlyFailures: (value) => ({ type: "onlyFailures", value }),
       jestArg: (value) => ({ type: "jestArg", value }),
       jestArgs: (values) => ({ type: "jestArgs", values }),
       vitestArg: (value) => ({ type: "vitestArg", value }),
@@ -401,6 +402,18 @@ var init_args = __esm({
           "--coverage.pageFit",
           (_flag, lookahead) => step([ActionBuilders.coveragePageFit(isTruthy(String(lookahead)))], true)
         ),
+        // --onlyFailures flag (boolean)
+        rule.eq("--onlyFailures", () => step([ActionBuilders.onlyFailures(true)])),
+        rule.startsWith(
+          "--onlyFailures=",
+          (value) => step([
+            ActionBuilders.onlyFailures(isTruthy((value.split("=")[1] ?? "").trim().toLowerCase()))
+          ])
+        ),
+        rule.withLookahead(
+          "--onlyFailures",
+          (_flag, lookahead) => step([ActionBuilders.onlyFailures(isTruthy(String(lookahead)))], true)
+        ),
         rule.withLookahead(
           "--testPathPattern",
           (flag, lookahead) => step([ActionBuilders.jestArgs([flag, lookahead])], true)
@@ -465,12 +478,12 @@ var init_args = __esm({
         rule.eq("--changed", () => step([ActionBuilders.changed("all")])),
         rule.startsWith("--changed=", (value) => {
           const raw = (value.split("=")[1] ?? "").trim().toLowerCase();
-          const mode = raw === "staged" ? "staged" : raw === "unstaged" ? "unstaged" : "all";
+          const mode = raw === "staged" ? "staged" : raw === "unstaged" ? "unstaged" : raw === "branch" ? "branch" : "all";
           return step([ActionBuilders.changed(mode)]);
         }),
         rule.withLookahead("--changed", (_flag, lookahead) => {
           const raw = String(lookahead).trim().toLowerCase();
-          const mode = raw === "staged" ? "staged" : raw === "unstaged" ? "unstaged" : "all";
+          const mode = raw === "staged" ? "staged" : raw === "unstaged" ? "unstaged" : raw === "branch" ? "branch" : "all";
           return step([ActionBuilders.changed(mode)], true);
         }),
         rule.withLookahead(
@@ -547,6 +560,8 @@ var init_args = __esm({
           return { vitest: [], jest: [], coverage: false, coverageUi: action.value };
         case "coverageAbortOnFailure":
           return { vitest: [], jest: [], coverage: false, coverageAbortOnFailure: action.value };
+        case "onlyFailures":
+          return { vitest: [], jest: [], coverage: false, onlyFailures: action.value };
         case "jestArgs":
           return { vitest: [], jest: action.values, coverage: false };
         case "selectionHint":
@@ -618,6 +633,7 @@ var init_args = __esm({
         ...next,
         ...right.changed !== void 0 || left.changed !== void 0 ? { changed: right.changed ?? left.changed } : {},
         ...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.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 } : {},
@@ -641,6 +657,7 @@ var init_args = __esm({
       let collectCoverage = false;
       let coverageUi = "both";
       let coverageAbortOnFailure = false;
+      let onlyFailures = false;
       let coverageShowCode = Boolean(process.stdout.isTTY);
       let coverageMode = "auto";
       const coverageMaxFilesLocalInit = void 0;
@@ -658,6 +675,7 @@ var init_args = __esm({
       collectCoverage ||= contrib.coverage;
       coverageUi = contrib.coverageUi ?? coverageUi;
       coverageAbortOnFailure = contrib.coverageAbortOnFailure ?? coverageAbortOnFailure;
+      onlyFailures = contrib.onlyFailures ?? onlyFailures;
       coverageShowCode = contrib.coverageShowCode ?? coverageShowCode;
       const coverageDetailComputed = contrib.coverageDetail ?? (contrib.selection ? "auto" : void 0);
       coverageMode = contrib.coverageMode ?? (contrib.selection ? "compact" : "auto");
@@ -691,6 +709,7 @@ var init_args = __esm({
         collectCoverage,
         coverageUi,
         coverageAbortOnFailure,
+        onlyFailures,
         selectionSpecified: Boolean(contrib.selection),
         selectionPaths: [...contrib.selectionPaths ?? []],
         includeGlobs,
@@ -4694,6 +4713,7 @@ var formatJestOutputVitest = (raw, opts) => {
   const projectHint = new RegExp(
     `(${cwd.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\$&")})|(/gigworx-node/)`
   );
+  const onlyFailures = Boolean(opts?.onlyFailures);
   const lines = raw.split(/\r?\n/);
   const out = [];
   const seenFailures = /* @__PURE__ */ new Set();
@@ -4781,8 +4801,10 @@ var formatJestOutputVitest = (raw, opts) => {
         continue;
       }
       seenFiles.add(rel);
-      const pill = badge === "PASS" ? colorTokens.passPill("PASS") : colorTokens.failPill("FAIL");
-      out.push(`${pill} ${ansi.white(rel)}`);
+      if (!(onlyFailures && badge === "PASS")) {
+        const pill = badge === "PASS" ? colorTokens.passPill("PASS") : colorTokens.failPill("FAIL");
+        out.push(`${pill} ${ansi.white(rel)}`);
+      }
       lineIndex += 1;
       continue;
     }
@@ -4895,14 +4917,21 @@ function renderVitestFromJestJSON(data, opts) {
     `(${cwd.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\$&")})|(/gigworx-node/)`
   );
   const ctx = { projectHint, editorCmd: opts?.editorCmd, showStacks: true };
+  const onlyFailures = Boolean(opts?.onlyFailures);
   const out = [];
-  out.push(renderRunLine(cwd));
-  out.push("");
+  if (!onlyFailures) {
+    out.push(renderRunLine(cwd));
+    out.push("");
+  }
   for (const file of data.testResults) {
     const rel = file.testFilePath.replace(/\\/g, "/").replace(`${cwd}/`, "");
     const failed = file.testResults.filter((assertion) => assertion.status === "failed");
-    out.push(...buildPerFileOverview(rel, file.testResults));
-    out.push(buildFileBadgeLine(rel, failed.length));
+    if (!onlyFailures) {
+      out.push(...buildPerFileOverview(rel, file.testResults));
+    }
+    if (!(onlyFailures && failed.length === 0)) {
+      out.push(buildFileBadgeLine(rel, failed.length));
+    }
     if (file.failureMessage && failed.length === 0) {
       const lines = file.failureMessage.split(/\r?\n/);
       const details = linesFromDetails(file.failureDetails);
@@ -5290,6 +5319,7 @@ var program = async () => {
     collectCoverage,
     coverageUi,
     coverageAbortOnFailure,
+    onlyFailures,
     selectionSpecified,
     selectionPaths,
     includeGlobs,
@@ -5317,6 +5347,52 @@ var program = async () => {
         return [];
       }
     };
+    if (mode === "branch") {
+      const resolveDefaultBranch = async () => {
+        const candidates = [];
+        try {
+          const sym = await collect("git", ["symbolic-ref", "refs/remotes/origin/HEAD"]);
+          const headRef = sym.find((ln) => ln.includes("refs/remotes/origin/"));
+          if (headRef) {
+            const m = /refs\/remotes\/(.+)/.exec(headRef);
+            if (m && m[1]) {
+              candidates.push(m[1]);
+            }
+          }
+        } catch {
+        }
+        candidates.push("origin/main", "origin/master");
+        for (const cand of candidates) {
+          const exists = await collect("git", ["rev-parse", "--verify", cand]);
+          if (exists.length > 0) {
+            return cand;
+          }
+        }
+        return void 0;
+      };
+      const defaultBranch = await resolveDefaultBranch();
+      const mergeBase = defaultBranch ? (await collect("git", ["merge-base", "HEAD", defaultBranch]))[0] : void 0;
+      const diffBase = mergeBase ?? "HEAD^";
+      const branchDiff = await collect("git", [
+        "diff",
+        "--name-only",
+        "--diff-filter=ACMRTUXB",
+        diffBase,
+        "HEAD"
+      ]);
+      const stagedNow = await collect("git", [
+        "diff",
+        "--name-only",
+        "--diff-filter=ACMRTUXB",
+        "--cached"
+      ]);
+      const unstagedNow = await collect("git", ["diff", "--name-only", "--diff-filter=ACMRTUXB"]);
+      const untrackedNow = await collect("git", ["ls-files", "--others", "--exclude-standard"]);
+      const rels2 = Array.from(
+        /* @__PURE__ */ new Set([...branchDiff, ...stagedNow, ...unstagedNow, ...untrackedNow])
+      );
+      return rels2.map((rel) => path10.resolve(cwd, rel).replace(/\\/g, "/")).filter((abs) => !abs.includes("/node_modules/") && !abs.includes("/coverage/"));
+    }
     const staged = mode === "staged" || mode === "all" ? await collect("git", ["diff", "--name-only", "--diff-filter=ACMRTUXB", "--cached"]) : [];
     const unstagedTracked = mode === "unstaged" || mode === "all" ? await collect("git", ["diff", "--name-only", "--diff-filter=ACMRTUXB"]) : [];
     const untracked = mode === "unstaged" || mode === "all" ? await collect("git", ["ls-files", "--others", "--exclude-standard"]) : [];
@@ -5628,6 +5704,23 @@ var program = async () => {
     }
     if (effectiveJestFiles.length === 0) {
       const repoRoot = repoRootForRefinement;
+      if (jestFiles.length === 0) {
+        try {
+          const allAcross = [];
+          for (const cfg of projectConfigs) {
+            const cfgCwd = path10.dirname(cfg);
+            const listed = await discoverJestResilient([...jestDiscoveryArgs, "--config", cfg], {
+              cwd: cfgCwd
+            });
+            allAcross.push(...listed);
+          }
+          const uniqAll = Array.from(new Set(allAcross.map((p) => p.replace(/\\/g, "/"))));
+          if (uniqAll.length > 0) {
+            jestFiles = uniqAll;
+          }
+        } catch {
+        }
+      }
       const seeds = prodSelections.map(
         (abs) => path10.relative(repoRoot, abs).replace(/\\/g, "/").replace(/\.(m?[tj]sx?)$/i, "")
       ).flatMap((rel) => {
@@ -5906,12 +5999,14 @@ var program = async () => {
           };
           pretty = renderVitestFromJestJSON(reordered, {
             cwd: repoRootForDiscovery,
-            ...editorCmd !== void 0 ? { editorCmd } : {}
+            ...editorCmd !== void 0 ? { editorCmd } : {},
+            onlyFailures
           });
         } catch {
           pretty = renderVitestFromJestJSON(bridge, {
             cwd: repoRootForDiscovery,
-            ...editorCmd !== void 0 ? { editorCmd } : {}
+            ...editorCmd !== void 0 ? { editorCmd } : {},
+            onlyFailures
           });
         }
         if (debug) {
@@ -5928,7 +6023,8 @@ ${preview}${pretty.includes("\n") ? "\n\u2026" : ""}`);
         }
         const renderOpts = {
           cwd: repoRootForDiscovery,
-          ...editorCmd !== void 0 ? { editorCmd } : {}
+          ...editorCmd !== void 0 ? { editorCmd } : {},
+          onlyFailures
         };
         pretty = formatJestOutputVitest(output, renderOpts);
         if (debug) {
@@ -5994,7 +6090,8 @@ ${preview}${pretty.includes("\n") ? "\n\u2026" : ""}`);
     }
     const text = renderVitestFromJestJSON(unified, {
       cwd: repoRootForDiscovery,
-      ...editorCmd !== void 0 ? { editorCmd } : {}
+      ...editorCmd !== void 0 ? { editorCmd } : {},
+      onlyFailures
     });
     if (text.trim().length > 0) {
       process.stdout.write(text.endsWith("\n") ? text : `${text}