faf-taf-git 2.3.1 → 2.4.1

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,7 +1,7 @@
 {
   "name": "faf-taf-git",
-  "version": "2.3.1",
-  "description": "A Test Receipt Printer for git. Every CI run prints a receipt to .taf — append-only, timestamped, cannot be gamed. Proof over time.",
+  "version": "2.4.1",
+  "description": "A Test Receipt Printer for git. Every CI run prints a receipt to .taf — append-only, timestamped, kept in git. Proof over time.",
   "main": "dist/cli.js",
   "bin": {
     "faf-taf-git": "dist/cli.js"
@@ -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

@@ -1,255 +1,57 @@
-faf_version: 2.5.0
-ai_scoring_system: 2025-09-20
-ai_score: 65%
-ai_confidence: MODERATE
-ai_value: 30_seconds_replaces_20_minutes_of_questions
-ai_tldr:
-  project: faf-taf-git v2.1.1 - A Test Receipt Printer for git. Proof over time, cannot be gamed.
-  stack: TypeScript CLI + GitHub Action (pre-capture architecture)
-  quality_bar: ZERO_ERRORS_F1_STANDARDS
-  status: PRODUCTION_READY (working in faf-cli repo)
-  breakthrough: v2.0.0 pre-capture pattern (tested 19 methods before this)
-  current_focus: Ecosystem adoption and user onboarding
-  your_role: Support users, fix bugs, add test framework support
-instant_context:
-  what_building: A Test Receipt Printer for git. CLI runs on any CI/CD; prints append-only test receipts to .taf, kept in git. FAF-aware optionally — receipts can carry FAF score/identity, but TAF works on any repo.
-  tech_stack: TypeScript
-  main_language: TypeScript
-  deployment: npm + GitHub Actions Marketplace
-  architecture: v2.0.0 pre-capture pattern (separate test execution from receipt generation)
-  use_cases: Standalone CLI, GitHub Action, GitLab CI, Jenkins, CircleCI, Local development
-  test_support: Jest (fully supported) with plans for Mocha, Vitest, Pytest, Go test, Rust cargo
-  golden_triangle: .faf (project DNA) + repo (code) + .taf (test proof)
-  key_files:
-    - src/index.ts (v2.0.0 rewrite - reads test output file)
-    - src/parsers/jest.ts (v2.0.4 fix - correct pattern matching)
-    - src/taf-core.ts (MCP-portable core)
-    - action.yml (v2.0.2 fix - correct bundle path)
-    - README.md (6Ws format)
-    - CHANGELOG.md (22 versions documented)
-  documentation:
-    - README: 6Ws format (What/Who/Why/Where/When/How)
-    - CHANGELOG: Complete debugging journey (v1.0.4 → v2.0.4)
-    - Migration guide: v1.x → v2.x breaking changes
-context_quality:
-  slots_filled: 11/21 (52%)
-  ai_confidence: MODERATE
-  handoff_ready: true
-  missing_context: []
+faf_version: "3.0"
 project:
   name: faf-taf-git
-  goal: Platform-agnostic CLI + GitHub Action for TAF updates
-  innovation: On-the-fly Testing Audit Files - Unheard of in CI/CD
-  taf_meaning:
-    file: Testing Audit File (.taf)
-    feed: Testing Activity Feed (live updates)
+  goal: "A Test Receipt Printer for git. Every CI run prints a receipt to .taf: append-only, timestamped, kept in git. Proof over time."
   main_language: TypeScript
-  type: cli
-  generated: 2025-10-28T01:26:05.656Z
-  repository: https://github.com/Wolfe-Jam/faf-taf-git
-  license: MIT
-  author: wolfejam
-  keywords: testing, taf, ci-cd, github-actions, gitlab-ci, platform-agnostic, jest, faf, git
-  mission: 🚀 Make Your AI Happy! 🧡 Trust-Driven 🤖
-  revolution: 30 seconds replaces 20 minutes of questions
-  brand: F1-Inspired Software Engineering - Championship AI Context
-ai_instructions:
-  priority_order:
-    - 1. Read THIS .faf file first
-    - 2. Check CLAUDE.md for session context
-    - 3. Review package.json for dependencies
-  working_style:
-    code_first: true
-    explanations: minimal
-    quality_bar: zero_errors
-    testing: required
-  warnings:
-    - Never modify dial components without approval
-    - All TypeScript must pass strict mode
-    - Test coverage required for new features
+  type: cli  # found: package.json bin
 stack:
   frontend: slotignored
   css_framework: slotignored
   ui_library: slotignored
   state_management: slotignored
   backend: slotignored
-  runtime: Node.js
+  api_type: slotignored
+  runtime: slotignored
   database: slotignored
   connection: slotignored
-  build: TypeScript Compiler
-  package_manager: npm
-  api_type: REST
-  hosting: npm Registry
+  hosting: npm registry + GitHub Actions Marketplace
+  build: TypeScript (tsc)
   cicd: GitHub Actions
-  targetUser: developers
-  coreProblem: understanding project
-  missionPurpose: project documentation
-  packageManager: npm/yarn/pnpm
-  mainLanguage: JavaScript/TypeScript
-cli_features:
-  commands:
-    - npx faf-taf-git
-    - --file (test output file - v2.0.0+)
-    - --command (custom test command - legacy v1.x)
-    - --commit (auto-commit .taf changes)
-    - --verbose (detailed output)
-    - --message (custom commit message)
-    - --cwd (working directory)
-  github_action_inputs:
-    test-output-file: required (v2.0.0+)
-    auto-commit: true (default)
-    commit-message: "chore(taf): update .taf receipt [skip ci] (default)"
-  architecture:
-    version: v2.0.0
-    pattern: pre-capture
-    breakthrough: Separate test execution from receipt generation
-    why: Avoids GitHub Actions execution context corruption
-    reliability: Tested 19 methods before this solution
-    benefits:
-      - More reliable (no execution context issues)
-      - Platform-agnostic (works everywhere)
-      - Simpler (400+ lines removed, 11KB smaller)
-  test_frameworks:
-    - Jest (fully supported)
-  supported_platforms:
-    - GitHub Actions
-    - GitLab CI
-    - Bitbucket Pipelines
-    - Jenkins
-    - CircleCI
-    - Travis CI
-    - Azure Pipelines
-    - Local development
-taf_format:
-  format: YAML
-  file_location: .taf (hidden dotfile)
-  purpose: Git-tracked testing timeline - permanent proof your code works
-  links_to_faf: true
-  snapshots_faf_score: true
-  closed_loop_system: .faf (DNA) + repo (code) + .taf (proof) = Golden Triangle
-deployment:
-  npm_package: faf-taf-git@2.1.1
-  github_action: Wolfe-Jam/faf-taf-git@v2.1.1
-  marketplaces:
-    - npm Registry
-    - GitHub Actions Marketplace
-  install: npx faf-taf-git
-  production_users:
-    - faf-cli (working in CI)
-testing:
-  framework: Jest
-  coverage: Core functionality
-  ci_integration: GitHub Actions
-  test_files:
-    - tests/ (unit tests)
-  quality_gates:
-    - All tests must pass
-    - TypeScript strict mode
-    - Zero build errors
-examples:
-  github_actions: README.md Quick Start section
-  standalone_cli: README.md Standalone CLI section
-  gitlab_ci: README.md GitLab CI section
-  jenkins: README.md Jenkins section
-  migration: README.md Migration from v1.x section
-performance:
-  bundle_size: 1.2MB (v2.0.0 - reduced 11KB from v1.x)
-  startup_time: <100ms
-  parse_time: <10ms for typical Jest output
-  reliability: 100% success rate in faf-cli CI (after v2.0.4)
-preferences:
-  quality_bar: zero_errors
-  commit_style: conventional_emoji
-  response_style: concise_code_first
-  explanation_level: minimal
-  communication: direct
-  testing: required
-  documentation: as_needed
-contributing:
-  guidelines: CONTRIBUTING.md
-  code_style: TypeScript strict mode
-  pr_process: Fork, branch, PR with tests
-  commit_format: Conventional commits with Co-Authored-By
-  testing_required: true
-  documentation_required: For new features
-resources:
-  readme: README.md (6Ws format)
-  changelog: CHANGELOG.md (22 versions documented)
-  license: MIT
-  repository: https://github.com/Wolfe-Jam/faf-taf-git
-  npm: https://npmjs.com/package/faf-taf-git
-  issues: https://github.com/Wolfe-Jam/faf-taf-git/issues
-  discussions: https://github.com/Wolfe-Jam/faf/discussions
-state:
-  phase: production
-  version: 2.3.1
-  focus: ecosystem_adoption
-  status: production_ready
-  achievements:
-    - v2.0.0 architectural redesign (pre-capture pattern)
-    - v2.0.4 parser fix (working in CI)
-    - Updated README (6Ws format)
-    - Updated CHANGELOG (22 versions documented)
-    - TAF Receipt generating successfully in faf-cli repo
-  next_milestone: user_adoption
-  blockers: null
-tags:
-  auto_generated:
-    - faf-taf-action
-    - none
-    - typescript
-  smart_defaults:
-    - .faf
-    - ai-ready
-    - "2025"
-    - software
-    - open-source
-  user_defined: null
+  monorepo_tool: slotignored
+  package_manager: slotignored
+  workspaces: slotignored
+  admin: slotignored
+  cache: slotignored
+  search: slotignored
+  storage: slotignored
 human_context:
-  who: Development teams adopting test-receipt provenance — open-source maintainers proving honest test history, regulated industries (SOC 2 / ISO / HIPAA) needing append-only audit trails, supply-chain verifiers proving tests ran before artifacts shipped, AI-agent reviewers verifying agent code passes tests consistently, and FAF-ecosystem projects completing the CAR Framework (Claim → Audit → Receipt).
-  what: TAF file updates in CI/CD pipelines
-  why: Improve development efficiency
-  where: Any CI/CD platform (GitHub, GitLab, Bitbucket)
-  when: During CI/CD test runs
-  how: Test-driven development
-  additional_context: Part of Golden Triangle (.faf + repo + .taf). Tracks test runs permanently in git. Supports Jest, works as CLI or GitHub Action. Platform-agnostic core - runs on ANY CI/CD with Node.js.
-  context_score: 0
-  total_prd_score: 65
-  success_rate: 50%
-scores:
-  faf_score: 50
-  slot_based_percentage: 52
-  ai_score: 65
-  total_slots: 21
-  filled_slots: 11
-  scoring_method: Honest percentage - no fake minimums
-  trust_embedded: COUNT ONCE architecture - trust MY embedded scores
-ai_scoring_details:
-  system_date: 2025-09-20
-  slot_based_percentage: 52
-  ai_score: 65
-  total_slots: 21
-  filled_slots: 11
-  scoring_method: Honest percentage - no fake minimums
-  trust_embedded: COUNT ONCE architecture - trust MY embedded scores
-faf_dna:
-  birth_dna: 22
-  birth_certificate: FAF-2025-FAFTAFAC-TMZU
-  birth_date: 2025-10-28T01:26:05.692Z
-  current_score: 50
-projectName: faf-taf-git
-projectGoal: A Test Receipt Printer for git — append-only test receipts on every CI run. Proof over time, cannot be gamed.
-generated: 2026-02-17T20:14:09.215Z
-last_major_update: v2.0.4 (2026-02-17)
-production_status: Working in faf-cli repository
-stack_signature: typescript-nodejs-javascript
-detected_frameworks:
-  - Claude Code
-  - Jest
-  - Node.js
-  - JavaScript
+  who: Maintainers and teams who want proof their tests kept passing on main, and the reviewers, auditors and AI agents who check it
+  what: "A Test Receipt Printer for git. Every CI run prints a receipt to .taf: append-only, timestamped, kept in git. Proof over time."
+  why: Test results vanish when CI logs expire. Receipts stay in git, so anyone can look back and check whether main was green before a release.
+  where: https://github.com/Wolfe-Jam/faf-taf-git
+  when: v2.4.1 (2026-10-30), --version fix; v2.4.0 (2026-10-29) JUnit XML parser; live since v1.0.0 (2025-10-27)
+  how: "Run tests, save the output (or a JUnit XML report), then `uses: Wolfe-Jam/faf-taf-git@v2.4.1` with `target-branch: taf-receipts`. Anywhere else: `npx faf-taf-git --file test-output.txt --commit`. The taf-receipts branch only grows: never rewrite it."
+monorepo:
+  packages_count: slotignored
+  build_orchestrator: slotignored
+  versioning_strategy: slotignored
+  shared_configs: slotignored
+  remote_cache: slotignored
+tech_stack:
   - TypeScript
-turbo_cat_intelligence: 260
-stats:
-  last_auto_time: 0.6
-  times_run: 1
+  - "@actions/core"
+  - "@actions/exec"
+  - "@actions/github"
+  - yaml
+key_files:
+  - package.json
+  - src/index.ts
+  - src/cli.ts
+  - src/parsers/
+  - action.yml
+  - RECEIPT-FORMAT.md
+  - README.md
+  - tsconfig.json
+commands:
+  build: npm run build
+  test: npm run test

package/src/cli.ts

@@ -222,12 +222,26 @@ function handleBadgeCommand(args: string[]): void {
   }
 }
 
+/**
+ * The installed package's version. package.json sits one level above both
+ * src/ (tests) and dist/ (the published bin).
+ */
+export function cliVersion(): string {
+  return JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8')).version;
+}
+
 /**
  * CLI entry point
  */
 async function main() {
   const args = process.argv.slice(2);
 
+  // --version / -V (-v is --verbose)
+  if (args.includes('--version') || args.includes('-V')) {
+    console.log(cliVersion());
+    return;
+  }
+
   // Subcommand: badge
   if (args[0] === 'badge') {
     handleBadgeCommand(args.slice(1));
@@ -236,7 +250,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  --version, -V       Print the version\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],