faf-taf-git 2.0.4

package/dist/taf-core.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * TAF Core - Simplified for GitHub Action
+ *
+ * Pure functions for reading, parsing, and updating .taf files
+ * Derived from faf-cli TAF implementation (MCP-portable)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateTafFile = updateTafFile;
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("yaml"));
+/**
+ * Update .taf file with new test results
+ * Creates the file if it doesn't exist
+ */
+function updateTafFile(tafPath, testResults) {
+    try {
+        let taf;
+        // Check if .taf exists, create if not
+        if (fs.existsSync(tafPath)) {
+            const content = fs.readFileSync(tafPath, 'utf-8');
+            taf = parseTAF(content);
+        }
+        else {
+            // Create new .taf file
+            const projectName = require('path').basename(require('path').dirname(tafPath));
+            taf = createTAF(projectName);
+        }
+        // Create test run entry
+        const run = {
+            timestamp: new Date().toISOString(),
+            result: testResults.result,
+            tests: {
+                total: testResults.total,
+                passed: testResults.passed,
+                failed: testResults.failed,
+                skipped: testResults.skipped,
+            },
+            trigger: 'github-actions',
+        };
+        // Append to history
+        taf.test_history.push(run);
+        // Serialize and write back
+        const updated = serializeTAF(taf);
+        fs.writeFileSync(tafPath, updated, 'utf-8');
+        return true;
+    }
+    catch (error) {
+        console.error('Failed to update .taf file:', error);
+        return false;
+    }
+}
+/**
+ * Create a new TAF file structure
+ */
+function createTAF(projectName) {
+    return {
+        format_version: '1.0.0',
+        project: projectName,
+        created: new Date().toISOString(),
+        last_updated: new Date().toISOString(),
+        test_history: [],
+    };
+}
+/**
+ * Parse .taf file content
+ */
+function parseTAF(content) {
+    // Split on document separator and take only first document
+    const lines = content.split('\n');
+    const yamlLines = [];
+    for (const line of lines) {
+        // Stop at document separator (but skip initial one if present)
+        if (line.trim() === '---' && yamlLines.length > 0) {
+            break;
+        }
+        // Skip initial document separator
+        if (line.trim() === '---' && yamlLines.length === 0) {
+            continue;
+        }
+        yamlLines.push(line);
+    }
+    const parsed = yaml.parse(yamlLines.join('\n'));
+    // Basic validation
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('Invalid .taf file: not a valid YAML object');
+    }
+    if (!parsed.test_history || !Array.isArray(parsed.test_history)) {
+        throw new Error('Invalid .taf file: missing or invalid test_history');
+    }
+    return parsed;
+}
+/**
+ * Serialize TAF object back to YAML
+ * Uses yaml library to maintain existing format
+ */
+function serializeTAF(taf) {
+    // Update last_updated timestamp
+    taf.last_updated = new Date().toISOString();
+    // Use yaml.stringify to preserve format
+    return yaml.stringify(taf);
+}
+//# sourceMappingURL=taf-core.js.map

package/dist/taf-core.js.map

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

package/docs/RELEASE-NOTES.md

@@ -0,0 +1,200 @@
+# Release Notes
+
+## v1.0.0 - Initial Release (2025-10-27)
+
+### The Golden Triangle is Complete
+
+First stable release of the FAF TAF Action - automatic .taf file updates for permanent, git-tracked test quality records.
+
+### Features
+
+**Core Functionality:**
+- Automatic .taf file updates from CI/CD pipelines
+- Jest output parsing (173/173 tests validated)
+- Git integration with auto-commit support
+- Configurable test commands and commit messages
+
+**Outputs:**
+- Test result status (PASSED, FAILED, IMPROVED, DEGRADED)
+- Test counts (total, passed, failed)
+- Update confirmation
+
+**Architecture:**
+- MCP-portable core (374 lines of TypeScript)
+- Zero external dependencies for TAF operations
+- Championship-grade validation
+- Strict TypeScript throughout
+
+### Supported Test Frameworks
+
+- Jest (all output formats)
+
+Coming soon:
+- Mocha
+- Vitest
+- Pytest
+- Go test
+
+### Installation
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+```
+
+### Prerequisites
+
+1. Install FAF CLI: `npm install -g faf-cli` or `brew install faf-cli`
+2. Initialize .taf: `faf taf init`
+3. Commit .taf to git
+
+### Quick Start
+
+```yaml
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Wolfe-Jam/faf-taf-action@v1
+```
+
+### Testing
+
+**Unit Tests:**
+- 7/7 tests passing
+- Jest parser validation
+- All output formats covered
+
+**Integration Tests:**
+- Validated with faf-cli (173 tests)
+- Validated with claude-faf-mcp (15 tests)
+- Format consistency verified
+
+**WJTTC Certification:**
+- 1 bug found during testing (format mismatch)
+- Fixed immediately
+- Championship standards maintained
+
+### Philosophy
+
+This release implements the Golden Triangle vision:
+
+```
+        .faf
+      (WHAT IT IS)
+         /    \
+        /      \
+       /        \
+    repo    ←→   .taf
+(IMPLEMENTATION) (PROOF IT WORKS)
+```
+
+**Format Authority:**
+You don't negotiate with a format. The format describes itself.
+
+**Software Accountability:**
+Every test run becomes permanent, git-tracked proof that your code works.
+
+### Known Limitations
+
+- Jest only (for now)
+- No test trend analysis yet
+- No failure pattern detection
+- Simple result detection (no history comparison)
+
+These are planned for v1.1.0+
+
+### Breaking Changes
+
+None (initial release)
+
+### Migration Guide
+
+Not applicable (initial release)
+
+### Documentation
+
+- [README.md](../README.md) - Quick start guide
+- [USER-GUIDE.md](USER-GUIDE.md) - Comprehensive documentation
+- [CLAUDE.md](../CLAUDE.md) - Project DNA
+
+### Links
+
+- Repository: https://github.com/Wolfe-Jam/faf-taf-action
+- Issues: https://github.com/Wolfe-Jam/faf-taf-action/issues
+- Discussions: https://github.com/Wolfe-Jam/faf/discussions
+- FAF Website: https://faf.one
+
+### Credits
+
+Built methodically with championship standards by the FAF team.
+
+"We break things so others never know they were broken." - WJTTC Philosophy
+
+### License
+
+MIT - Free forever
+
+---
+
+## Roadmap
+
+### v1.1.0 (Planned)
+
+**Additional Test Frameworks:**
+- Mocha support
+- Vitest support
+- Pytest support
+
+**Enhanced Analysis:**
+- Test trend detection
+- Failure pattern recognition
+- Flaky test identification
+
+**Improved Outputs:**
+- Pass rate trends
+- Duration tracking
+- Historical comparison
+
+### v1.2.0 (Planned)
+
+**Advanced Features:**
+- Custom result detection rules
+- .faf integration scoring
+- Automated issue creation on degradation
+- Slack/Discord notifications
+
+**Performance:**
+- Faster parsing
+- Incremental updates
+- Caching support
+
+### v2.0.0 (Future)
+
+**Framework Agnostic:**
+- Generic test output parser
+- Custom format support
+- Multi-framework projects
+
+**Enterprise Features:**
+- Team dashboards
+- Quality gates
+- Compliance reporting
+
+---
+
+## Support
+
+Report bugs, request features, or ask questions:
+
+- GitHub Issues: https://github.com/Wolfe-Jam/faf-taf-action/issues
+- GitHub Discussions: https://github.com/Wolfe-Jam/faf/discussions
+- Email: team@faf.one
+
+---
+
+**Championship-grade engineering. F1-inspired performance. Built with care.**

package/docs/USER-GUIDE.md

@@ -0,0 +1,301 @@
+# FAF TAF Action - User Guide
+
+## Introduction
+
+The FAF TAF Action automatically maintains a `.taf` (Testing Activity Feed) file that tracks your test runs over time. This creates a permanent, git-tracked record of your project's test quality.
+
+### The Golden Triangle
+
+```
+        .faf
+      (WHAT IT IS)
+         /    \
+        /      \
+       /        \
+    repo    ←→   .taf
+(IMPLEMENTATION) (PROOF IT WORKS)
+```
+
+- **.faf** - Project DNA that tells AI what your project is
+- **repo** - Your actual implementation (code doesn't lie)
+- **.taf** - Permanent proof that your code works (formats don't negotiate)
+
+## Prerequisites
+
+### 1. Install FAF CLI
+
+```bash
+npm install -g faf-cli
+# or
+brew install faf-cli
+```
+
+### 2. Initialize .taf File
+
+In your project root:
+
+```bash
+faf taf init
+```
+
+This creates a `.taf` file that tracks your testing timeline.
+
+### 3. Commit .taf to Git
+
+```bash
+git add .taf
+git commit -m "feat: add testing timeline"
+```
+
+## Basic Setup
+
+### Minimal Configuration
+
+Add to `.github/workflows/test.yml`:
+
+```yaml
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests and update .taf
+        uses: Wolfe-Jam/faf-taf-action@v1
+```
+
+That's it! The action will:
+1. Run `npm test` (default)
+2. Parse Jest output
+3. Update `.taf` file
+4. Commit changes automatically
+
+## Advanced Configuration
+
+### Custom Test Command
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+  with:
+    test-command: 'npm run test:coverage'
+```
+
+### Custom Commit Message
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+  with:
+    commit-message: 'test: update .taf timeline [skip ci]'
+```
+
+### Disable Auto-Commit
+
+Handle commits yourself:
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+  id: taf
+  with:
+    auto-commit: false
+
+- name: Custom commit logic
+  if: steps.taf.outputs.taf-updated == 'true'
+  run: |
+    git add .taf
+    git commit -m "test: $(date +'%Y-%m-%d') test results"
+    git push
+```
+
+## Using Outputs
+
+The action provides several outputs you can use:
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+  id: taf
+
+- name: Check test results
+  run: |
+    echo "Result: ${{ steps.taf.outputs.result }}"
+    echo "Tests: ${{ steps.taf.outputs.passed }}/${{ steps.taf.outputs.total }}"
+
+- name: Fail if tests failed
+  if: steps.taf.outputs.result == 'FAILED'
+  run: exit 1
+
+- name: Celebrate improvement
+  if: steps.taf.outputs.result == 'IMPROVED'
+  run: echo "Tests are improving!"
+```
+
+### Available Outputs
+
+- `result` - PASSED, FAILED, IMPROVED, or DEGRADED
+- `passed` - Number of passing tests
+- `failed` - Number of failing tests
+- `total` - Total test count
+- `taf-updated` - Whether .taf was modified
+
+## Workflow Patterns
+
+### Skip CI on .taf Updates
+
+Prevent infinite loops:
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+  with:
+    commit-message: 'test: update .taf [skip ci]'
+```
+
+### Only Update on Main Branch
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+  if: github.ref == 'refs/heads/main'
+```
+
+### Different Commands per Environment
+
+```yaml
+- uses: Wolfe-Jam/faf-taf-action@v1
+  with:
+    test-command: ${{ matrix.os == 'ubuntu-latest' && 'npm test' || 'npm run test:unit' }}
+```
+
+### Combine with Coverage
+
+```yaml
+- name: Run tests with coverage
+  uses: Wolfe-Jam/faf-taf-action@v1
+  with:
+    test-command: 'npm run test:coverage'
+
+- name: Upload coverage
+  uses: codecov/codecov-action@v3
+  if: always()
+```
+
+## Permissions
+
+For auto-commit to work, ensure your workflow has write permissions:
+
+```yaml
+permissions:
+  contents: write
+```
+
+If using a fine-grained PAT:
+
+```yaml
+- uses: actions/checkout@v4
+  with:
+    token: ${{ secrets.GITHUB_TOKEN }}
+
+- uses: Wolfe-Jam/faf-taf-action@v1
+```
+
+## Troubleshooting
+
+### "No .taf file found"
+
+Run `faf taf init` in your project root and commit the file.
+
+### "Could not parse test output"
+
+Currently only Jest is supported. Check that your test command outputs Jest format.
+
+### Tests pass but action fails
+
+Check the action logs for parsing errors. The action needs the standard Jest summary line:
+
+```
+Tests: 173 passed, 173 total
+```
+
+### Commits not pushing
+
+1. Verify `permissions: contents: write` in workflow
+2. Check that `.taf` is not in `.gitignore`
+3. Ensure git is configured properly in the workflow
+
+### Action shows "up to date" but .taf wasn't updated
+
+The action may have determined there were no changes. Check:
+- Did tests actually run?
+- Was there Jest output to parse?
+- Check action logs for details
+
+## Best Practices
+
+### 1. Run on Every Push
+
+Keep your .taf file current:
+
+```yaml
+on: [push, pull_request]
+```
+
+### 2. Use [skip ci] for .taf Commits
+
+Prevent infinite loops:
+
+```yaml
+commit-message: 'test: update .taf [skip ci]'
+```
+
+### 3. Track .taf in Git
+
+Never add `.taf` to `.gitignore`. It's meant to be tracked!
+
+### 4. Review .taf Changes
+
+When reviewing PRs, check .taf changes to see test quality trends.
+
+### 5. Combine with .faf
+
+Use both `.faf` (project context) and `.taf` (proof of quality) together for maximum value.
+
+## Philosophy
+
+### You Don't Negotiate with a Format
+
+.taf files are structured data, not prose. They describe themselves. No interpretation needed.
+
+### Software Accountability
+
+Every test run becomes permanent, git-tracked proof that your code works (or doesn't). No hiding, no forgetting.
+
+### The Format Describes Itself
+
+Open your `.taf` file. You'll immediately understand what it tracks and why it matters.
+
+## Learn More
+
+- [.taf Format Specification](https://faf.one/docs/taf)
+- [FAF CLI Documentation](https://faf.one/docs)
+- [Example .taf Files](https://github.com/Wolfe-Jam/faf-cli/blob/main/.taf)
+- [GitHub Discussions](https://github.com/Wolfe-Jam/faf/discussions)
+
+## Support
+
+- Report issues: [GitHub Issues](https://github.com/Wolfe-Jam/faf-taf-action/issues)
+- Ask questions: [GitHub Discussions](https://github.com/Wolfe-Jam/faf/discussions)
+- Email: team@faf.one
+
+## License
+
+MIT - Free forever, no strings attached.

package/jest.config.js

@@ -0,0 +1,13 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/tests'],
+  testMatch: ['**/*.test.ts'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  verbose: true,
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "faf-taf-git",
+  "version": "2.0.4",
+  "description": "Platform-agnostic TAF (Testing Activity Feed) updater - works in ANY CI/CD",
+  "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"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Wolfe-Jam/faf-taf-git.git"
+  },
+  "keywords": [
+    "testing",
+    "taf",
+    "ci-cd",
+    "github-actions",
+    "gitlab-ci",
+    "bitbucket-pipelines",
+    "test-automation",
+    "jest",
+    "faf",
+    "git",
+    "platform-agnostic"
+  ],
+  "author": "wolfejam",
+  "license": "MIT",
+  "dependencies": {
+    "@actions/core": "^1.10.1",
+    "@actions/exec": "^1.1.1",
+    "@actions/github": "^6.0.0",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.6",
+    "@vercel/ncc": "^0.38.1",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  }
+}