faf-taf-git 2.0.4 → 2.2.1

package/dist/licenses.txt

@@ -59,28 +59,6 @@ The above copyright notice and this permission notice shall be included in all c
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-@fastify/busboy
-MIT
-Copyright Brian White. All rights reserved.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to
-deal in the Software without restriction, including without limitation the
-rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-sell copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-IN THE SOFTWARE.
-
 tunnel
 MIT
 The MIT License (MIT)

package/dist/parsers/bun.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Bun test output parser
+ *
+ * Extracts test counts from `bun test` CLI output.
+ */
+import { TestResults } from './jest';
+/**
+ * Parse Bun test output to extract test results.
+ *
+ * Bun output format (summary block at the end of a run):
+ *
+ * ```
+ *    232 pass
+ *    1 skip
+ *    1 todo
+ *    0 fail
+ *    848 expect() calls
+ *   Ran 234 tests across 9 files. [21.53s]
+ * ```
+ *
+ * Notes:
+ * - Anchored on `Ran <N> tests across <M> files.` — the canonical truthful
+ *   total (includes skip + todo + pass + fail). Without this line, the parser
+ *   returns null and the dispatcher falls through to jest/vitest.
+ * - Per-category counts (`pass`, `fail`, `skip`, `todo`) come from their own
+ *   lines elsewhere in the same output. Singular forms — bun does not use
+ *   `passed`/`failed`/`skipped` (intentional differentiator from jest/vitest).
+ * - `skipped` aggregates `skip` + `todo` (matches the convention vitest.ts
+ *   already uses for parity in the shared TestResults shape).
+ */
+export declare function parseBunOutput(output: string): TestResults | null;
+/**
+ * Example Bun outputs for testing:
+ *
+ * All passing:
+ * ```
+ *  173 pass
+ *  0 fail
+ *  Ran 173 tests across 8 files. [4.2s]
+ * ```
+ *
+ * Mixed (the grok-faf-mcp 1.4.9 shape):
+ * ```
+ *  232 pass
+ *  1 skip
+ *  1 todo
+ *  0 fail
+ *  848 expect() calls
+ *  Ran 234 tests across 9 files. [21.53s]
+ * ```
+ *
+ * Failing:
+ * ```
+ *  170 pass
+ *  3 fail
+ *  Ran 173 tests across 8 files. [5.1s]
+ * ```
+ */
+//# sourceMappingURL=bun.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["file:///Users/wolfejam/FAF/faf-taf-git/src/parsers/bun.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA0CjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/parsers/bun.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Bun test output parser
+ *
+ * Extracts test counts from `bun test` CLI output.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBunOutput = parseBunOutput;
+/**
+ * Parse Bun test output to extract test results.
+ *
+ * Bun output format (summary block at the end of a run):
+ *
+ * ```
+ *    232 pass
+ *    1 skip
+ *    1 todo
+ *    0 fail
+ *    848 expect() calls
+ *   Ran 234 tests across 9 files. [21.53s]
+ * ```
+ *
+ * Notes:
+ * - Anchored on `Ran <N> tests across <M> files.` — the canonical truthful
+ *   total (includes skip + todo + pass + fail). Without this line, the parser
+ *   returns null and the dispatcher falls through to jest/vitest.
+ * - Per-category counts (`pass`, `fail`, `skip`, `todo`) come from their own
+ *   lines elsewhere in the same output. Singular forms — bun does not use
+ *   `passed`/`failed`/`skipped` (intentional differentiator from jest/vitest).
+ * - `skipped` aggregates `skip` + `todo` (matches the convention vitest.ts
+ *   already uses for parity in the shared TestResults shape).
+ */
+function parseBunOutput(output) {
+    // Strip ANSI color codes + normalize line endings (parity with siblings).
+    // eslint-disable-next-line no-control-regex
+    let cleanOutput = output.replace(/\x1b\[[0-9;]*m/g, '');
+    cleanOutput = cleanOutput.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    // Canonical anchor: bun-unique "Ran N tests across M files." summary line.
+    // Without this, this isn't bun output — let the dispatcher try the others.
+    const ranMatch = cleanOutput.match(/^Ran\s+(\d+)\s+tests?\s+across\s+\d+\s+files?/m);
+    if (!ranMatch)
+        return null;
+    const total = parseInt(ranMatch[1], 10);
+    if (total === 0)
+        return null;
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    // Per-line counts. Each line is `<leading-ws><N> <singular-word>` on its own.
+    // Anchored with ^...$ + multiline to avoid catching the "expect() calls" line
+    // or any noise inside test descriptions.
+    const passedMatch = cleanOutput.match(/^\s*(\d+)\s+pass\s*$/m);
+    if (passedMatch)
+        passed = parseInt(passedMatch[1], 10);
+    const failedMatch = cleanOutput.match(/^\s*(\d+)\s+fail\s*$/m);
+    if (failedMatch)
+        failed = parseInt(failedMatch[1], 10);
+    const skipMatch = cleanOutput.match(/^\s*(\d+)\s+skip\s*$/m);
+    if (skipMatch)
+        skipped += parseInt(skipMatch[1], 10);
+    const todoMatch = cleanOutput.match(/^\s*(\d+)\s+todo\s*$/m);
+    if (todoMatch)
+        skipped += parseInt(todoMatch[1], 10);
+    const result = failed > 0 ? 'FAILED' : 'PASSED';
+    return {
+        total,
+        passed,
+        failed,
+        skipped: skipped > 0 ? skipped : undefined,
+        result,
+    };
+}
+/**
+ * Example Bun outputs for testing:
+ *
+ * All passing:
+ * ```
+ *  173 pass
+ *  0 fail
+ *  Ran 173 tests across 8 files. [4.2s]
+ * ```
+ *
+ * Mixed (the grok-faf-mcp 1.4.9 shape):
+ * ```
+ *  232 pass
+ *  1 skip
+ *  1 todo
+ *  0 fail
+ *  848 expect() calls
+ *  Ran 234 tests across 9 files. [21.53s]
+ * ```
+ *
+ * Failing:
+ * ```
+ *  170 pass
+ *  3 fail
+ *  Ran 173 tests across 8 files. [5.1s]
+ * ```
+ */
+//# sourceMappingURL=bun.js.map

package/dist/parsers/bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.js","sourceRoot":"","sources":["../../src/parsers/bun.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA4BH,wCA0CC;AAlED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,0EAA0E;IAC1E,4CAA4C;IAC5C,IAAI,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACxD,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEtE,2EAA2E;IAC3E,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACrF,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,8EAA8E;IAC9E,8EAA8E;IAC9E,yCAAyC;IACzC,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC/D,IAAI,WAAW;QAAE,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC/D,IAAI,WAAW;QAAE,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7D,IAAI,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAErD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7D,IAAI,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAErD,MAAM,MAAM,GAAwB,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAErE,OAAO;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC1C,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Unified test output parser
+ *
+ * Tries each framework parser in order until one succeeds.
+ */
+import { TestResults } from './jest';
+export { TestResults } from './jest';
+/**
+ * Parse test output from any supported framework.
+ *
+ * Order matters: Bun is tried first because its `Ran N tests across M files`
+ * anchor is bun-unique — it never false-matches on jest/vitest output. Putting
+ * it first also lets bun consumers ship truthful totals even when their CI
+ * still has a legacy `Tests: N passed, N total` jest-shim line appended to the
+ * test output (the bun parser ignores it and reads the canonical `Ran` line).
+ *
+ * Tries parsers in order: Bun, Jest, Vitest.
+ */
+export declare function parseTestOutput(output: string): TestResults | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;AAKrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAElE"}

package/dist/parsers/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Unified test output parser
+ *
+ * Tries each framework parser in order until one succeeds.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTestOutput = parseTestOutput;
+const bun_1 = require("./bun");
+const jest_1 = require("./jest");
+const vitest_1 = require("./vitest");
+/**
+ * Parse test output from any supported framework.
+ *
+ * Order matters: Bun is tried first because its `Ran N tests across M files`
+ * anchor is bun-unique — it never false-matches on jest/vitest output. Putting
+ * it first also lets bun consumers ship truthful totals even when their CI
+ * still has a legacy `Tests: N passed, N total` jest-shim line appended to the
+ * test output (the bun parser ignores it and reads the canonical `Ran` line).
+ *
+ * Tries parsers in order: Bun, Jest, Vitest.
+ */
+function parseTestOutput(output) {
+    return (0, bun_1.parseBunOutput)(output) || (0, jest_1.parseJestOutput)(output) || (0, vitest_1.parseVitestOutput)(output);
+}
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAoBH,0CAEC;AAnBD,+BAAuC;AACvC,iCAAyC;AACzC,qCAA6C;AAI7C;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAA,oBAAc,EAAC,MAAM,CAAC,IAAI,IAAA,sBAAe,EAAC,MAAM,CAAC,IAAI,IAAA,0BAAiB,EAAC,MAAM,CAAC,CAAC;AACxF,CAAC"}

package/dist/parsers/vitest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Vitest output parser
+ *
+ * Extracts test counts from Vitest CLI output
+ */
+import { TestResults } from './jest';
+/**
+ * Parse Vitest output to extract test results
+ *
+ * Vitest output formats:
+ * - " Tests  8 passed (8)"
+ * - " Tests  2 failed | 6 passed (8)"
+ * - " Tests  1 skipped | 7 passed (8)"
+ * - " Tests  1 failed | 2 skipped | 5 passed (8)"
+ */
+export declare function parseVitestOutput(output: string): TestResults | null;
+//# sourceMappingURL=vitest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["file:///Users/wolfejam/FAF/faf-taf-git/src/parsers/vitest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA+CpE"}

package/dist/parsers/vitest.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Vitest output parser
+ *
+ * Extracts test counts from Vitest CLI output
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVitestOutput = parseVitestOutput;
+/**
+ * Parse Vitest output to extract test results
+ *
+ * Vitest output formats:
+ * - " Tests  8 passed (8)"
+ * - " Tests  2 failed | 6 passed (8)"
+ * - " Tests  1 skipped | 7 passed (8)"
+ * - " Tests  1 failed | 2 skipped | 5 passed (8)"
+ */
+function parseVitestOutput(output) {
+    // Strip ANSI color codes
+    // eslint-disable-next-line no-control-regex
+    let cleanOutput = output.replace(/\x1b\[[0-9;]*m/g, '');
+    cleanOutput = cleanOutput.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    // Vitest summary pattern: " Tests  ... (N)" where N is total in parens
+    const testSummaryPattern = /^\s*Tests\s+(.+?\(\d+\))/m;
+    const testLineMatch = cleanOutput.match(testSummaryPattern);
+    if (!testLineMatch || !testLineMatch[1]) {
+        return null;
+    }
+    const testLine = testLineMatch[1];
+    // Extract total from parentheses at end
+    const totalMatch = testLine.match(/\((\d+)\)\s*$/);
+    if (!totalMatch)
+        return null;
+    const total = parseInt(totalMatch[1], 10);
+    if (total === 0)
+        return null;
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    const passedMatch = testLine.match(/(\d+)\s+passed/i);
+    if (passedMatch)
+        passed = parseInt(passedMatch[1], 10);
+    const failedMatch = testLine.match(/(\d+)\s+failed/i);
+    if (failedMatch)
+        failed = parseInt(failedMatch[1], 10);
+    const skippedMatch = testLine.match(/(\d+)\s+skipped/i);
+    if (skippedMatch)
+        skipped = parseInt(skippedMatch[1], 10);
+    const todoMatch = testLine.match(/(\d+)\s+todo/i);
+    if (todoMatch)
+        skipped += parseInt(todoMatch[1], 10);
+    let result = failed > 0 ? 'FAILED' : 'PASSED';
+    return {
+        total,
+        passed,
+        failed,
+        skipped: skipped > 0 ? skipped : undefined,
+        result,
+    };
+}
+//# sourceMappingURL=vitest.js.map

package/dist/parsers/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","sourceRoot":"","sources":["../../src/parsers/vitest.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAaH,8CA+CC;AAxDD;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,yBAAyB;IACzB,4CAA4C;IAC5C,IAAI,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACxD,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEtE,uEAAuE;IACvE,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;IACvD,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAE5D,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAElC,wCAAwC;IACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACtD,IAAI,WAAW;QAAE,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACtD,IAAI,WAAW;QAAE,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACxD,IAAI,YAAY;QAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE1D,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAClD,IAAI,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAErD,IAAI,MAAM,GAAwB,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEnE,OAAO;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC1C,MAAM;KACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "faf-taf-git",
-  "version": "2.0.4",
-  "description": "Platform-agnostic TAF (Testing Activity Feed) updater - works in ANY CI/CD",
+  "version": "2.2.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.",
   "main": "dist/cli.js",
   "bin": {
     "faf-taf-git": "dist/cli.js"
   },
   "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "package": "ncc build src/index.ts -o dist --source-map --license licenses.txt"
+    "build": "tsc && ncc build src/index.ts -o dist --source-map --license licenses.txt",
+    "test": "jest"
   },
   "repository": {
     "type": "git",
@@ -31,9 +30,9 @@
   "author": "wolfejam",
   "license": "MIT",
   "dependencies": {
-    "@actions/core": "^1.10.1",
+    "@actions/core": "^2.0.3",
     "@actions/exec": "^1.1.1",
-    "@actions/github": "^6.0.0",
+    "@actions/github": "^6.0.1",
     "yaml": "^2.3.4"
   },
   "devDependencies": {

package/project.faf

@@ -4,7 +4,7 @@ ai_score: 65%
 ai_confidence: MODERATE
 ai_value: 30_seconds_replaces_20_minutes_of_questions
 ai_tldr:
-  project: faf-taf-git v2.0.4 - Git-tracked testing timelines for ANY CI/CD
+  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)
@@ -12,15 +12,13 @@ ai_tldr:
   current_focus: Ecosystem adoption and user onboarding
   your_role: Support users, fix bugs, add test framework support
 instant_context:
-  what_building: Platform-agnostic CLI + GitHub Action for TAF updates
+  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
+  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)
@@ -40,19 +38,18 @@ context_quality:
   missing_context: []
 project:
   name: faf-taf-git
-  goal: Platform-agnostic TAF (Testing Activity Feed) updater - works in ANY CI/CD
+  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)
   main_language: TypeScript
-  type: 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
+  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
@@ -71,13 +68,14 @@ ai_instructions:
     - All TypeScript must pass strict mode
     - Test coverage required for new features
 stack:
-  frontend: None
-  css_framework: None
-  ui_library: None
-  state_management: None
-  backend: None
+  frontend: slotignored
+  css_framework: slotignored
+  ui_library: slotignored
+  state_management: slotignored
+  backend: slotignored
   runtime: Node.js
-  database: None
+  database: slotignored
+  connection: slotignored
   build: TypeScript Compiler
   package_manager: npm
   api_type: REST
@@ -130,8 +128,8 @@ taf_format:
   snapshots_faf_score: true
   closed_loop_system: .faf (DNA) + repo (code) + .taf (proof) = Golden Triangle
 deployment:
-  npm_package: faf-taf-git@2.0.4
-  github_action: Wolfe-Jam/faf-taf-git@v2.0.4
+  npm_package: faf-taf-git@2.1.1
+  github_action: Wolfe-Jam/faf-taf-git@v2.1.1
   marketplaces:
     - npm Registry
     - GitHub Actions Marketplace
@@ -184,7 +182,7 @@ resources:
   discussions: https://github.com/Wolfe-Jam/faf/discussions
 state:
   phase: production
-  version: 2.0.4
+  version: 2.1.1
   focus: ecosystem_adoption
   status: production_ready
   achievements:
@@ -208,15 +206,13 @@ tags:
     - open-source
   user_defined: null
 human_context:
-  who: Development teams
+  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.
+  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%
@@ -242,7 +238,7 @@ faf_dna:
   birth_date: 2025-10-28T01:26:05.692Z
   current_score: 50
 projectName: faf-taf-git
-projectGoal: Platform-agnostic TAF (Testing Activity Feed) updater - works in ANY CI/CD
+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

package/src/badge.ts

@@ -0,0 +1,138 @@
+/**
+ * Badge Generator for faf-taf-git
+ *
+ * Generates shields.io-style SVG badges from .taf test history.
+ * Self-contained SVG with Verdana font, no external dependencies.
+ */
+
+import * as fs from 'fs';
+import * as yaml from 'yaml';
+
+export interface BadgeOptions {
+  tafPath?: string;
+  label?: string;
+}
+
+export interface BadgeResult {
+  success: boolean;
+  svg?: string;
+  error?: string;
+}
+
+interface LatestRun {
+  passed: number;
+  total: number;
+  failed: number;
+  skipped: number;
+}
+
+const COLOR_PASS = '#003366';  // Navy blue (deep — white-text contrast; cyan was too light)
+const COLOR_FAIL = '#E32400';  // Red
+const COLOR_NONE = '#9F9F9F';  // Gray
+
+/**
+ * Render a shields.io flat-style SVG badge.
+ */
+export function renderBadgeSvg(label: string, value: string, color: string): string {
+  // Approximate text widths using Verdana 11px (6.5px per char average)
+  const charWidth = 6.5;
+  const padding = 10;
+  const labelWidth = Math.round(label.length * charWidth + padding * 2);
+  const valueWidth = Math.round(value.length * charWidth + padding * 2);
+  const totalWidth = labelWidth + valueWidth;
+  const height = 20;
+
+  const labelX = labelWidth / 2;
+  const valueX = labelWidth + valueWidth / 2;
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${totalWidth}" height="${height}" role="img" aria-label="${label}: ${value}">
+  <title>${label}: ${value}</title>
+  <linearGradient id="s" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="r">
+    <rect width="${totalWidth}" height="${height}" rx="3" fill="#fff"/>
+  </clipPath>
+  <g clip-path="url(#r)">
+    <rect width="${labelWidth}" height="${height}" fill="#555"/>
+    <rect x="${labelWidth}" width="${valueWidth}" height="${height}" fill="${color}"/>
+    <rect width="${totalWidth}" height="${height}" fill="url(#s)"/>
+  </g>
+  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="11">
+    <text x="${labelX}" y="14" fill="#010101" fill-opacity=".3">${label}</text>
+    <text x="${labelX}" y="13" fill="#fff">${label}</text>
+    <text x="${valueX}" y="14" fill="#010101" fill-opacity=".3">${value}</text>
+    <text x="${valueX}" y="13" fill="#fff">${value}</text>
+  </g>
+</svg>`;
+}
+
+/**
+ * Read a .taf file and extract the latest test run.
+ */
+function getLatestRun(tafPath: string): LatestRun | null {
+  if (!fs.existsSync(tafPath)) {
+    return null;
+  }
+
+  const content = fs.readFileSync(tafPath, 'utf-8');
+
+  // Handle YAML document separators (same logic as taf-core.ts)
+  const lines = content.split('\n');
+  const yamlLines: string[] = [];
+  for (const line of lines) {
+    if (line.trim() === '---' && yamlLines.length > 0) break;
+    if (line.trim() === '---' && yamlLines.length === 0) continue;
+    yamlLines.push(line);
+  }
+
+  const parsed = yaml.parse(yamlLines.join('\n'));
+
+  if (!parsed || typeof parsed !== 'object') return null;
+  if (!Array.isArray(parsed.test_history) || parsed.test_history.length === 0) return null;
+
+  const latest = parsed.test_history[parsed.test_history.length - 1];
+  if (!latest.tests || typeof latest.tests.total !== 'number') return null;
+
+  return {
+    passed: latest.tests.passed ?? 0,
+    total: latest.tests.total,
+    failed: latest.tests.failed ?? 0,
+    skipped: latest.tests.skipped ?? 0,
+  };
+}
+
+/**
+ * Generate a badge SVG from a .taf file.
+ */
+export function generateBadge(options: BadgeOptions = {}): BadgeResult {
+  const label = options.label || 'TAF';
+  const tafPath = options.tafPath || '.taf';
+
+  try {
+    const run = getLatestRun(tafPath);
+
+    if (!run) {
+      return {
+        success: true,
+        svg: renderBadgeSvg(label, 'no data', COLOR_NONE),
+      };
+    }
+
+    const skippedSuffix = run.skipped > 0 ? ` (${run.skipped} skipped)` : '';
+    const displayPassed = run.failed === 0 ? run.total : run.passed;
+    const value = `${displayPassed}/${run.total} passing${skippedSuffix}`;
+    const color = run.failed === 0 ? COLOR_PASS : COLOR_FAIL;
+
+    return {
+      success: true,
+      svg: renderBadgeSvg(label, value, color),
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to generate badge',
+    };
+  }
+}