faf-taf-git 2.3.1 → 2.4.0

package/dist/parsers/index.d.ts

@@ -5,6 +5,7 @@
  */
 import { TestResults } from './jest';
 export { TestResults } from './jest';
+export { parseJunitOutput } from './junit';
 export { parseWjttcOutput } from './wjttc';
 export declare const SUPPORTED_PARSERS: readonly string[];
 /** What the CLI and the Action report when no parser matches. */

package/dist/parsers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["file:///Users/wolfejam/FAF/faf-taf-git/src/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAMrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgB3C,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAkC,CAAC;AAElF,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,QAA6E,CAAC;AAE7G;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["file:///Users/wolfejam/FAF/faf-taf-git/src/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAOrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAmB3C,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAkC,CAAC;AAElF,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,QAA6E,CAAC;AAE7G;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMlE"}

package/dist/parsers/index.js

@@ -5,22 +5,28 @@
  * Tries each framework parser in order until one succeeds.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNPARSEABLE_OUTPUT = exports.SUPPORTED_PARSERS = exports.parseWjttcOutput = void 0;
+exports.UNPARSEABLE_OUTPUT = exports.SUPPORTED_PARSERS = exports.parseWjttcOutput = exports.parseJunitOutput = void 0;
 exports.parseTestOutput = parseTestOutput;
 const bun_1 = require("./bun");
 const jest_1 = require("./jest");
+const junit_1 = require("./junit");
 const vitest_1 = require("./vitest");
 const wjttc_1 = require("./wjttc");
+var junit_2 = require("./junit");
+Object.defineProperty(exports, "parseJunitOutput", { enumerable: true, get: function () { return junit_2.parseJunitOutput; } });
 var wjttc_2 = require("./wjttc");
 Object.defineProperty(exports, "parseWjttcOutput", { enumerable: true, get: function () { return wjttc_2.parseWjttcOutput; } });
 /**
  * Every parser, in the order parseTestOutput tries them. Order matters:
- * 1. Bun — `Ran N tests across M files` is bun-unique.
- * 2. WJTTC — `pc-ai WJTTC` / suite `pc-ai-wjttc` (FAF bar; not Jest-shaped).
- * 3. Jest — `Tests: … total`.
- * 4. Vitest — `Tests  … (N)`.
+ * 1. JUnit XML — a `<testsuite>` element; first, because a report's captured
+ *    stdout can hold another runner's summary line.
+ * 2. Bun — `Ran N tests across M files` is bun-unique.
+ * 3. WJTTC — `pc-ai WJTTC` / suite `pc-ai-wjttc` (FAF bar; not Jest-shaped).
+ * 4. Jest — `Tests: … total`.
+ * 5. Vitest — `Tests  … (N)`.
  */
 const PARSERS = [
+    ['JUnit XML', junit_1.parseJunitOutput],
     ['Bun', bun_1.parseBunOutput],
     ['WJTTC', wjttc_1.parseWjttcOutput],
     ['Jest', jest_1.parseJestOutput],

package/dist/parsers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAkCH,0CAMC;AArCD,+BAAuC;AACvC,iCAAyC;AACzC,qCAA6C;AAC7C,mCAA2C;AAG3C,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA;AAEzB;;;;;;GAMG;AACH,MAAM,OAAO,GAA0F;IACrG,CAAC,KAAK,EAAE,oBAAc,CAAC;IACvB,CAAC,OAAO,EAAE,wBAAgB,CAAC;IAC3B,CAAC,MAAM,EAAE,sBAAe,CAAC;IACzB,CAAC,QAAQ,EAAE,0BAAiB,CAAC;CAC9B,CAAC;AAEW,QAAA,iBAAiB,GAAsB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAElF,iEAAiE;AACpD,QAAA,kBAAkB,GAAG,2CAA2C,yBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAE7G;;;GAGG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAuCH,0CAMC;AA1CD,+BAAuC;AACvC,iCAAyC;AACzC,mCAA2C;AAC3C,qCAA6C;AAC7C,mCAA2C;AAG3C,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA;AACzB,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA;AAEzB;;;;;;;;GAQG;AACH,MAAM,OAAO,GAA0F;IACrG,CAAC,WAAW,EAAE,wBAAgB,CAAC;IAC/B,CAAC,KAAK,EAAE,oBAAc,CAAC;IACvB,CAAC,OAAO,EAAE,wBAAgB,CAAC;IAC3B,CAAC,MAAM,EAAE,sBAAe,CAAC;IACzB,CAAC,QAAQ,EAAE,0BAAiB,CAAC;CAC9B,CAAC;AAEW,QAAA,iBAAiB,GAAsB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAElF,iEAAiE;AACpD,QAAA,kBAAkB,GAAG,2CAA2C,yBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAE7G;;;GAGG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/parsers/junit.d.ts

@@ -0,0 +1,22 @@
+/**
+ * JUnit XML parser
+ *
+ * Extracts test counts from a JUnit XML report — the common format nearly every
+ * test runner can write: pytest (--junitxml), cargo (nextest, cargo2junit), Go
+ * (go-junit-report, gotestsum), Maven/Gradle, .NET, PHPUnit, Jest (jest-junit).
+ */
+import { TestResults } from './jest';
+/**
+ * Parse a JUnit XML report to extract test results
+ *
+ * Handles:
+ * - a <testsuites> root that carries the totals (gotestsum, Maven)
+ * - a <testsuites> root without totals, around counted <testsuite>s (pytest)
+ * - a single <testsuite> root
+ * - nested <testsuite>s (only the outermost level is counted, never twice)
+ * - suites with no counts at all (the <testcase> elements are counted instead)
+ *
+ * failures + errors count as failed; skipped + disabled count as skipped.
+ */
+export declare function parseJunitOutput(output: string): TestResults | null;
+//# sourceMappingURL=junit.d.ts.map

package/dist/parsers/junit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"junit.d.ts","sourceRoot":"","sources":["file:///Users/wolfejam/FAF/faf-taf-git/src/parsers/junit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAyCrC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgDnE"}

package/dist/parsers/junit.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * JUnit XML parser
+ *
+ * Extracts test counts from a JUnit XML report — the common format nearly every
+ * test runner can write: pytest (--junitxml), cargo (nextest, cargo2junit), Go
+ * (go-junit-report, gotestsum), Maven/Gradle, .NET, PHPUnit, Jest (jest-junit).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJunitOutput = parseJunitOutput;
+const SUITE_TAG = /<(\/?)testsuite\b([^>]*?)(\/?)>/g;
+/** Read one numeric attribute; undefined when the attribute is absent. */
+function attr(attrs, name) {
+    const match = attrs.match(new RegExp(`\\b${name}\\s*=\\s*["'](\\d+)["']`));
+    return match ? parseInt(match[1], 10) : undefined;
+}
+/** Counts from a <testsuite> or <testsuites> attribute list, or null without a `tests` count. */
+function countsFromAttrs(attrs) {
+    const tests = attr(attrs, 'tests');
+    if (tests === undefined)
+        return null;
+    return {
+        tests,
+        failed: (attr(attrs, 'failures') ?? 0) + (attr(attrs, 'errors') ?? 0),
+        skipped: (attr(attrs, 'skipped') ?? 0) + (attr(attrs, 'disabled') ?? 0),
+    };
+}
+/** Fallback when suites carry no counts: walk the <testcase> elements themselves. */
+function countsFromTestcases(xml) {
+    const counts = { tests: 0, failed: 0, skipped: 0 };
+    const testcase = /<testcase\b[^>]*?(?:\/>|>([\s\S]*?)<\/testcase>)/g;
+    let match;
+    while ((match = testcase.exec(xml)) !== null) {
+        counts.tests++;
+        const body = match[1] ?? '';
+        if (/<(failure|error)\b/.test(body))
+            counts.failed++;
+        else if (/<skipped\b/.test(body))
+            counts.skipped++;
+    }
+    return counts;
+}
+/**
+ * Parse a JUnit XML report to extract test results
+ *
+ * Handles:
+ * - a <testsuites> root that carries the totals (gotestsum, Maven)
+ * - a <testsuites> root without totals, around counted <testsuite>s (pytest)
+ * - a single <testsuite> root
+ * - nested <testsuite>s (only the outermost level is counted, never twice)
+ * - suites with no counts at all (the <testcase> elements are counted instead)
+ *
+ * failures + errors count as failed; skipped + disabled count as skipped.
+ */
+function parseJunitOutput(output) {
+    const xml = output.replace(/<!--[\s\S]*?-->/g, '');
+    if (!/<testsuites?\b/.test(xml))
+        return null;
+    let counts = null;
+    const root = xml.match(/<testsuites\b([^>]*)>/);
+    if (root)
+        counts = countsFromAttrs(root[1]);
+    if (!counts) {
+        // Sum the outermost <testsuite>s; a suite without counts sends us to the testcases.
+        let depth = 0;
+        let summed = { tests: 0, failed: 0, skipped: 0 };
+        let seen = 0;
+        let match;
+        SUITE_TAG.lastIndex = 0;
+        while ((match = SUITE_TAG.exec(xml)) !== null) {
+            const [, closing, attrs, selfClosing] = match;
+            if (closing) {
+                depth--;
+                continue;
+            }
+            if (depth === 0 && summed) {
+                seen++;
+                const suite = countsFromAttrs(attrs);
+                if (suite) {
+                    summed.tests += suite.tests;
+                    summed.failed += suite.failed;
+                    summed.skipped += suite.skipped;
+                }
+                else {
+                    summed = null;
+                }
+            }
+            if (!selfClosing)
+                depth++;
+        }
+        counts = seen > 0 && summed ? summed : countsFromTestcases(xml);
+    }
+    if (counts.tests === 0)
+        return null;
+    const passed = Math.max(0, counts.tests - counts.failed - counts.skipped);
+    return {
+        total: counts.tests,
+        passed,
+        failed: counts.failed,
+        skipped: counts.skipped > 0 ? counts.skipped : undefined,
+        result: counts.failed > 0 ? 'FAILED' : 'PASSED',
+    };
+}
+//# sourceMappingURL=junit.js.map

package/dist/parsers/junit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"junit.js","sourceRoot":"","sources":["../../src/parsers/junit.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-taf-git",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "A Test Receipt Printer for git. Every CI run prints a receipt to .taf — append-only, timestamped, cannot be gamed. Proof over time.",
   "main": "dist/cli.js",
   "bin": {
@@ -36,11 +36,11 @@
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.11",
+    "@types/jest": "^30.0.0",
     "@types/node": "^20.10.6",
     "@vercel/ncc": "^0.38.1",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.1",
+    "jest": "^30.5.2",
+    "ts-jest": "^29.4.15",
     "typescript": "^5.3.3"
   },
   "overrides": {

package/project.faf

@@ -81,11 +81,23 @@ stack:
   api_type: REST
   hosting: npm Registry
   cicd: GitHub Actions
+  monorepo_tool: slotignored
+  workspaces: slotignored
+  admin: slotignored
+  cache: slotignored
+  search: slotignored
+  storage: slotignored
   targetUser: developers
   coreProblem: understanding project
   missionPurpose: project documentation
   packageManager: npm/yarn/pnpm
   mainLanguage: JavaScript/TypeScript
+monorepo:
+  packages_count: slotignored
+  build_orchestrator: slotignored
+  versioning_strategy: slotignored
+  shared_configs: slotignored
+  remote_cache: slotignored
 cli_features:
   commands:
     - npx faf-taf-git
@@ -182,7 +194,7 @@ resources:
   discussions: https://github.com/Wolfe-Jam/faf/discussions
 state:
   phase: production
-  version: 2.3.1
+  version: 2.4.0
   focus: ecosystem_adoption
   status: production_ready
   achievements:

package/src/cli.ts

@@ -236,7 +236,7 @@ async function main() {
 
   // Show help
   if (args.includes('--help') || args.includes('-h')) {
-    console.log(`\nfaf-taf-git - The Git-Native Receipt Printer\n\nUSAGE:\n  npm test 2>&1 | tee test-output.txt\n  npx faf-taf-git --file test-output.txt [OPTIONS]\n\n  # WJTTC / pc-ai bar\n  node tests/wjttc/run-wjttc.mjs 2>&1 | tee wjttc-out.txt\n  npx faf-taf-git --file wjttc-out.txt\n\nCOMMANDS:\n  badge               Generate a shields.io-style SVG badge from .taf\n\nOPTIONS:\n  --file <path>       Path to test output file (required)\n  --commit            Auto-commit .taf changes to git\n  --message <msg>     Custom commit message\n  --cwd <dir>         Working directory (default: current)\n  --verbose, -v       Verbose output\n  --help, -h          Show this help\n\nPARSERS:\n  Bun, WJTTC (pc-ai bar), Jest, Vitest\n\nEXAMPLES:\n  npm test 2>&1 | tee test-output.txt\n  npx faf-taf-git --file test-output.txt\n\n  npx faf-taf-git --file test-output.txt --commit\n\n  npx faf-taf-git badge --output badge.svg\n\nPLATFORM SUPPORT:\n  Works in ANY CI/CD that runs Node.js:\n  GitHub Actions, GitLab CI, Jenkins, CircleCI,\n  Bitbucket Pipelines, Azure Pipelines, local dev\n\nLEARN MORE:\n  https://github.com/Wolfe-Jam/faf-taf-git\n`);
+    console.log(`\nfaf-taf-git - The Git-Native Receipt Printer\n\nUSAGE:\n  npm test 2>&1 | tee test-output.txt\n  npx faf-taf-git --file test-output.txt [OPTIONS]\n\n  # WJTTC / pc-ai bar\n  node tests/wjttc/run-wjttc.mjs 2>&1 | tee wjttc-out.txt\n  npx faf-taf-git --file wjttc-out.txt\n\nCOMMANDS:\n  badge               Generate a shields.io-style SVG badge from .taf\n\nOPTIONS:\n  --file <path>       Path to test output file (required)\n  --commit            Auto-commit .taf changes to git\n  --message <msg>     Custom commit message\n  --cwd <dir>         Working directory (default: current)\n  --verbose, -v       Verbose output\n  --help, -h          Show this help\n\nPARSERS:\n  JUnit XML (pytest, cargo, Go, Java, .NET ...), Bun, WJTTC (pc-ai bar), Jest, Vitest\n\nEXAMPLES:\n  npm test 2>&1 | tee test-output.txt\n  npx faf-taf-git --file test-output.txt\n\n  npx faf-taf-git --file test-output.txt --commit\n\n  npx faf-taf-git badge --output badge.svg\n\nPLATFORM SUPPORT:\n  Works in ANY CI/CD that runs Node.js:\n  GitHub Actions, GitLab CI, Jenkins, CircleCI,\n  Bitbucket Pipelines, Azure Pipelines, local dev\n\nLEARN MORE:\n  https://github.com/Wolfe-Jam/faf-taf-git\n`);
     process.exit(0);
   }
 

package/src/index.ts

@@ -149,6 +149,7 @@ async function run(): Promise<void> {
     core.setOutput('passed', testResults.passed.toString());
     core.setOutput('failed', testResults.failed.toString());
     core.setOutput('total', testResults.total.toString());
+    core.setOutput('skipped', (testResults.skipped ?? 0).toString());
 
     // If target-branch is set, save .taf seed and switch branches
     let tafSeed: string | null = null;

package/src/parsers/index.ts

@@ -7,20 +7,25 @@
 import { TestResults } from './jest';
 import { parseBunOutput } from './bun';
 import { parseJestOutput } from './jest';
+import { parseJunitOutput } from './junit';
 import { parseVitestOutput } from './vitest';
 import { parseWjttcOutput } from './wjttc';
 
 export { TestResults } from './jest';
+export { parseJunitOutput } from './junit';
 export { parseWjttcOutput } from './wjttc';
 
 /**
  * Every parser, in the order parseTestOutput tries them. Order matters:
- * 1. Bun — `Ran N tests across M files` is bun-unique.
- * 2. WJTTC — `pc-ai WJTTC` / suite `pc-ai-wjttc` (FAF bar; not Jest-shaped).
- * 3. Jest — `Tests: … total`.
- * 4. Vitest — `Tests  … (N)`.
+ * 1. JUnit XML — a `<testsuite>` element; first, because a report's captured
+ *    stdout can hold another runner's summary line.
+ * 2. Bun — `Ran N tests across M files` is bun-unique.
+ * 3. WJTTC — `pc-ai WJTTC` / suite `pc-ai-wjttc` (FAF bar; not Jest-shaped).
+ * 4. Jest — `Tests: … total`.
+ * 5. Vitest — `Tests  … (N)`.
  */
 const PARSERS: ReadonlyArray<readonly [name: string, parse: (output: string) => TestResults | null]> = [
+  ['JUnit XML', parseJunitOutput],
   ['Bun', parseBunOutput],
   ['WJTTC', parseWjttcOutput],
   ['Jest', parseJestOutput],

package/src/parsers/junit.ts

@@ -0,0 +1,110 @@
+/**
+ * JUnit XML parser
+ *
+ * Extracts test counts from a JUnit XML report — the common format nearly every
+ * test runner can write: pytest (--junitxml), cargo (nextest, cargo2junit), Go
+ * (go-junit-report, gotestsum), Maven/Gradle, .NET, PHPUnit, Jest (jest-junit).
+ */
+
+import { TestResults } from './jest';
+
+const SUITE_TAG = /<(\/?)testsuite\b([^>]*?)(\/?)>/g;
+
+/** Read one numeric attribute; undefined when the attribute is absent. */
+function attr(attrs: string, name: string): number | undefined {
+  const match = attrs.match(new RegExp(`\\b${name}\\s*=\\s*["'](\\d+)["']`));
+  return match ? parseInt(match[1], 10) : undefined;
+}
+
+interface Counts {
+  tests: number;
+  failed: number;
+  skipped: number;
+}
+
+/** Counts from a <testsuite> or <testsuites> attribute list, or null without a `tests` count. */
+function countsFromAttrs(attrs: string): Counts | null {
+  const tests = attr(attrs, 'tests');
+  if (tests === undefined) return null;
+  return {
+    tests,
+    failed: (attr(attrs, 'failures') ?? 0) + (attr(attrs, 'errors') ?? 0),
+    skipped: (attr(attrs, 'skipped') ?? 0) + (attr(attrs, 'disabled') ?? 0),
+  };
+}
+
+/** Fallback when suites carry no counts: walk the <testcase> elements themselves. */
+function countsFromTestcases(xml: string): Counts {
+  const counts: Counts = { tests: 0, failed: 0, skipped: 0 };
+  const testcase = /<testcase\b[^>]*?(?:\/>|>([\s\S]*?)<\/testcase>)/g;
+  let match: RegExpExecArray | null;
+  while ((match = testcase.exec(xml)) !== null) {
+    counts.tests++;
+    const body = match[1] ?? '';
+    if (/<(failure|error)\b/.test(body)) counts.failed++;
+    else if (/<skipped\b/.test(body)) counts.skipped++;
+  }
+  return counts;
+}
+
+/**
+ * Parse a JUnit XML report to extract test results
+ *
+ * Handles:
+ * - a <testsuites> root that carries the totals (gotestsum, Maven)
+ * - a <testsuites> root without totals, around counted <testsuite>s (pytest)
+ * - a single <testsuite> root
+ * - nested <testsuite>s (only the outermost level is counted, never twice)
+ * - suites with no counts at all (the <testcase> elements are counted instead)
+ *
+ * failures + errors count as failed; skipped + disabled count as skipped.
+ */
+export function parseJunitOutput(output: string): TestResults | null {
+  const xml = output.replace(/<!--[\s\S]*?-->/g, '');
+  if (!/<testsuites?\b/.test(xml)) return null;
+
+  let counts: Counts | null = null;
+
+  const root = xml.match(/<testsuites\b([^>]*)>/);
+  if (root) counts = countsFromAttrs(root[1]);
+
+  if (!counts) {
+    // Sum the outermost <testsuite>s; a suite without counts sends us to the testcases.
+    let depth = 0;
+    let summed: Counts | null = { tests: 0, failed: 0, skipped: 0 };
+    let seen = 0;
+    let match: RegExpExecArray | null;
+    SUITE_TAG.lastIndex = 0;
+    while ((match = SUITE_TAG.exec(xml)) !== null) {
+      const [, closing, attrs, selfClosing] = match;
+      if (closing) {
+        depth--;
+        continue;
+      }
+      if (depth === 0 && summed) {
+        seen++;
+        const suite = countsFromAttrs(attrs);
+        if (suite) {
+          summed.tests += suite.tests;
+          summed.failed += suite.failed;
+          summed.skipped += suite.skipped;
+        } else {
+          summed = null;
+        }
+      }
+      if (!selfClosing) depth++;
+    }
+    counts = seen > 0 && summed ? summed : countsFromTestcases(xml);
+  }
+
+  if (counts.tests === 0) return null;
+
+  const passed = Math.max(0, counts.tests - counts.failed - counts.skipped);
+  return {
+    total: counts.tests,
+    passed,
+    failed: counts.failed,
+    skipped: counts.skipped > 0 ? counts.skipped : undefined,
+    result: counts.failed > 0 ? 'FAILED' : 'PASSED',
+  };
+}

package/tests/junit-parser.test.ts

@@ -0,0 +1,109 @@
+/**
+ * JUnit XML Parser Tests
+ */
+
+import { parseJunitOutput } from '../src/parsers/junit';
+import { parseTestOutput, SUPPORTED_PARSERS } from '../src/parsers';
+
+describe('JUnit XML Parser', () => {
+  describe('parseJunitOutput', () => {
+    test('should parse a pytest report (<testsuites> root without totals)', () => {
+      const output = `<?xml version="1.0" encoding="utf-8"?>
+<testsuites name="pytest tests"><testsuite name="pytest" errors="0" failures="1" skipped="2" tests="12" time="0.4" timestamp="2026-10-29T20:00:00" hostname="runner">
+<testcase classname="tests.test_a" name="test_ok" time="0.001" />
+<testcase classname="tests.test_a" name="test_bad" time="0.002"><failure message="assert 1 == 2">assert 1 == 2</failure></testcase>
+</testsuite></testsuites>`;
+      const result = parseJunitOutput(output);
+      expect(result).toEqual({ total: 12, passed: 9, failed: 1, skipped: 2, result: 'FAILED' });
+    });
+
+    test('should use the totals on a <testsuites> root (gotestsum, Maven)', () => {
+      const output = `<testsuites tests="40" failures="0" errors="0" skipped="3">
+  <testsuite name="pkg/a" tests="25" failures="0" errors="0" skipped="1"></testsuite>
+  <testsuite name="pkg/b" tests="15" failures="0" errors="0" skipped="2"></testsuite>
+</testsuites>`;
+      expect(parseJunitOutput(output)).toEqual({ total: 40, passed: 37, failed: 0, skipped: 3, result: 'PASSED' });
+    });
+
+    test('should sum the suites when the root has no totals (cargo2junit)', () => {
+      const output = `<testsuites>
+  <testsuite id="0" name="faf_rust_sdk" package="testsuite/faf_rust_sdk" tests="30" errors="0" failures="0" hostname="localhost" timestamp="2026-10-29T20:00:00Z" time="0">
+    <testcase name="parses_minimal" time="0" />
+  </testsuite>
+  <testsuite id="1" name="integration" tests="8" errors="1" failures="0" skipped="0" time="0"></testsuite>
+</testsuites>`;
+      expect(parseJunitOutput(output)).toEqual({ total: 38, passed: 37, failed: 1, skipped: undefined, result: 'FAILED' });
+    });
+
+    test('should parse a single <testsuite> root', () => {
+      const output = `<?xml version="1.0"?>
+<testsuite name="jest tests" tests="7" failures="0" errors="0" skipped="0"></testsuite>`;
+      expect(parseJunitOutput(output)).toEqual({ total: 7, passed: 7, failed: 0, skipped: undefined, result: 'PASSED' });
+    });
+
+    test('should count nested suites once (outermost level only)', () => {
+      const output = `<testsuites>
+  <testsuite name="outer" tests="5" failures="0" errors="0">
+    <testsuite name="inner" tests="5" failures="0" errors="0"></testsuite>
+  </testsuite>
+</testsuites>`;
+      expect(parseJunitOutput(output)!.total).toBe(5);
+    });
+
+    test('should count failures and errors together as failed', () => {
+      const output = `<testsuite tests="10" failures="2" errors="1" skipped="1"></testsuite>`;
+      expect(parseJunitOutput(output)).toEqual({ total: 10, passed: 6, failed: 3, skipped: 1, result: 'FAILED' });
+    });
+
+    test('should count disabled tests as skipped', () => {
+      const output = `<testsuites tests="6" failures="0" errors="0" disabled="2"></testsuites>`;
+      expect(parseJunitOutput(output)).toEqual({ total: 6, passed: 4, failed: 0, skipped: 2, result: 'PASSED' });
+    });
+
+    test('should count <testcase> elements when the suites carry no counts', () => {
+      const output = `<testsuites><testsuite name="bare">
+  <testcase name="a" />
+  <testcase name="b"><failure message="boom" /></testcase>
+  <testcase name="c"><skipped /></testcase>
+  <testcase name="d"><error message="crash" /></testcase>
+</testsuite></testsuites>`;
+      expect(parseJunitOutput(output)).toEqual({ total: 4, passed: 1, failed: 2, skipped: 1, result: 'FAILED' });
+    });
+
+    test('should accept single-quoted attributes', () => {
+      expect(parseJunitOutput(`<testsuite tests='3' failures='0'></testsuite>`)!.total).toBe(3);
+    });
+
+    test('should ignore a commented-out suite', () => {
+      const output = `<!-- <testsuite tests="99" failures="9"></testsuite> -->
+<testsuite tests="2" failures="0"></testsuite>`;
+      expect(parseJunitOutput(output)).toEqual({ total: 2, passed: 2, failed: 0, skipped: undefined, result: 'PASSED' });
+    });
+
+    test('should return null for a report with zero tests', () => {
+      expect(parseJunitOutput(`<testsuites><testsuite tests="0" failures="0"></testsuite></testsuites>`)).toBeNull();
+    });
+
+    test('should return null for output that is not JUnit XML', () => {
+      expect(parseJunitOutput('Tests: 173 passed, 173 total')).toBeNull();
+      expect(parseJunitOutput('')).toBeNull();
+    });
+  });
+
+  describe('parseTestOutput routing', () => {
+    test('should list JUnit XML first among the supported parsers', () => {
+      expect(SUPPORTED_PARSERS[0]).toBe('JUnit XML');
+    });
+
+    test('should read the XML counts even when captured stdout holds another summary line', () => {
+      const output = `<testsuite tests="20" failures="0" errors="0" skipped="0">
+  <system-out>Tests: 3 passed, 3 total</system-out>
+</testsuite>`;
+      expect(parseTestOutput(output)!.total).toBe(20);
+    });
+
+    test('should still route plain Jest output to the Jest parser', () => {
+      expect(parseTestOutput('Tests: 1 failed, 172 passed, 173 total')!.total).toBe(173);
+    });
+  });
+});