{"id":"@lssm-tech/action.validation","slug":"action.validation","name":"@lssm-tech/action.validation","version":"5.0.4","path":"packages/apps/action-validation","manifestPath":"packages/apps/action-validation/package.json","manifestBlobSha":"75aa778007c9d3edd33defe7a63211c9a3b76262","layer":"apps","physicalArea":null,"primaryArea":"delivery-and-infrastructure","classification":{"privateDeclared":null,"catalogFamily":"solutions","catalogKind":"app","catalogStatus":"active","adoptionMode":"operator-only","stability":"stable"},"description":"GitHub Action for running ContractSpec CI checks","descriptionOrigin":"package.json","catalog":{"family":"solutions","kind":"app","status":"active","adoptionMode":"operator-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":["."],"documentation":[{"title":"Action Validation documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Faction.validation","kind":"readme"}],"examples":[],"replacements":[],"nonAdoptableRationale":"This app is published for execution by operators, not as a reusable library dependency."},"canonicalImports":[],"scripts":{"test":"bun test"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-spec":"workspace:^"},"devDependencies":{},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts"},"publishExports":null,"types":null,"files":["package.json","AGENTS.md","CHANGELOG.md","LICENSE","README.md","src"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/action.validation","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/apps/action-validation/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/action-validation/src/index.ts","sourceStatus":"verified source file"}]}],"entryCount":1,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Action Validation documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Faction.validation","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/action-validation","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/action-validation/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/action-validation/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/action.validation.txt"},"readme":{"status":"available","body":"# @lssm-tech/action.validation\n\nWebsite: https://contractspec.io\n\n**ContractSpec GitHub Action for CI/CD integration. Wraps the `contractspec ci` CLI command as a composite action.**\n\n## What It Does\n\n- **Layer**: app (GitHub Action)\n- **Consumers**: external CI/CD pipelines via `lssm/contractspec-action@v1`\n\n## Usage\n\n```yaml\nname: ContractSpec CI\non: pull_request\njobs:\n  contractspec:\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      packages: read\n    steps:\n      - uses: actions/checkout@v6\n      - uses: lssm-tech/contractspec/packages/apps/action-validation@main\n        with:\n          github-packages-token: ${{ secrets.CONTRACTSPEC_PACKAGES_TOKEN }}\n```\n\nFor affected private GitHub Packages dependencies, `github-packages-token` must be a GitHub token that can read the ContractSpec packages granted to the consuming repository, bot, or GitHub App.\n\n## Inputs\n\n- `checks` (default: `all`) — Checks to run (comma-separated: structure,integrity,deps,doctor,handlers,tests) or \"all\"\n- `skip` — Checks to skip (comma-separated)\n- `pattern` — Glob pattern for spec discovery\n- `fail-on-warnings` (default: `false`) — Fail the action on warnings (not just errors)\n- `check-handlers` (default: `false`) — Include handler implementation checks\n- `check-tests` (default: `false`) — Include test coverage checks\n- `upload-sarif` (default: `true`) — Upload SARIF results to GitHub Code Scanning\n- `working-directory` (default: `.`) — Working directory for running checks\n- `bun-version` (default: `latest`) — Bun version to use\n- `mode` (default: `validate`) — Action mode: \"validate\" (run checks) or \"impact\" (detect breaking changes)\n- `baseline` — Git ref to compare against for impact detection (default: base branch from PR context)\n- `pr-comment` (default: `true`) — Post impact results as PR comment\n- `github-token` (default: `${{ github.token }}`) — GitHub token for PR comments and check runs\n- `github-packages-token` — Optional token used to configure private GitHub Packages auth before dependency installs\n\n## Outputs\n\n- `success` — Whether all checks passed\n- `errors` — Number of errors found\n- `warnings` — Number of warnings found\n- `sarif-file` — Path to SARIF output file (if uploaded)\n- `json-file` — Path to JSON output file\n- `impact-status` — Impact status: \"no-impact\" | \"non-breaking\" | \"breaking\"\n- `breaking-count` — Number of breaking changes detected\n- `non-breaking-count` — Number of non-breaking changes detected\n\n## Key Files\n\n- `action.yml` — GitHub Action definition (composite action)\n- `README.md` — Usage documentation\n- `package.json` — Package metadata (private, not published to npm)\n\n## Local Commands\n\n- `bun run test` — bun test\n\n## Recent Updates\n\n- Replace eslint+prettier by biomejs to optimize speed\n- Stability\n- PublishConfig not supported by bun\n\n## Notes\n\n- All input/output changes must be reflected in both `action.yml` and `README.md`.\n- The action is versioned with tags on the repository — breaking input changes require a major version bump.\n- Test locally using `act` or by referencing the local action: `uses: ./packages/apps/action-validation`.\n","sourcePath":"packages/apps/action-validation/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/action-validation/README.md","blobSha":"98aa71ed34d19b7d1ea8e1fca06280b1b56616ee","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"delivery-and-infrastructure","areaTitle":"Delivery, infrastructure and runtime operations","displayName":"action.validation","runtimes":["node"],"platforms":["server"],"kind":"app","scope":"Package manifest","canonicalRoute":"/docs/packages/action.validation/","contextUrl":"/docs/packages/action.validation.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}