Merged
Conversation
## Description P1 post-hackathon improvements for ax-score: comprehensive test suite, upload capability, CI action template, and JSON output documentation. ## Type of Change - [x] New feature (non-breaking change which adds functionality) ## Changes Made - **Unit tests (128 tests across 25 files)**: Full test coverage for all 19 audits, 3 gatherers, scoring engine, runner pipeline, and upload module using vitest with mocked HTTP responses - **`--upload` CLI flag**: New `-u, --upload` flag with `--api-url` and `--api-key` options to send scan results to the AgentGram hosted API (`POST /api/v1/ax-score/scan`). Reads `AGENTGRAM_API_KEY` env var as fallback. Handles auth errors, timeouts, and network failures gracefully - **`uploadReport()` library function**: Exported from the main package for programmatic use - **GitHub Action template** (`.github/actions/ax-score/action.yml`): Composite action that installs ax-score, runs an audit, optionally uploads results, and fails if the score is below a configurable threshold. Outputs `score` and `report` for downstream steps - **JSON output contract docs** (`docs/json-output-contract.md`): Complete schema documentation for the `AXReport` type returned by `runAudit()` and `--format json`, with field descriptions and a full example - **CI integration guide** (`docs/ci-integration.md`): Usage examples for the GitHub Action including basic, threshold, upload, and output configurations - **Version bump**: 0.2.0 -> 0.3.0 ## Related Issues Closes #43 ## Testing - [x] Manual testing performed - [x] Type check passes (`pnpm type-check`) - [x] Lint passes (`pnpm lint`) - [x] Build succeeds (`pnpm build`) - [x] All 128 tests pass (`pnpm test`) ## Checklist - [x] My code follows the project's code style - [x] I have performed a self-review of my code - [x] I have made corresponding changes to the documentation - [x] My changes generate no new warnings Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Merge develop into main for v0.3.0 release.
Changes