{"id":50454006,"url":"https://github.com/mizcausevic-dev/kg-suite-spec-version-tracker-action","last_synced_at":"2026-06-01T01:05:32.773Z","repository":{"id":360817318,"uuid":"1250898292","full_name":"mizcausevic-dev/kg-suite-spec-version-tracker-action","owner":"mizcausevic-dev","description":"GitHub Action wrapping kg-suite-spec-version-tracker. Walks mixed-protocol dir, flags fleet-wide spec-version drift across A2A/MCP/prompts/evidence/OTel. PR comment + fail-on-drift. Cross-protocol governance gate.","archived":false,"fork":false,"pushed_at":"2026-05-28T00:50:15.000Z","size":247,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T02:22:52.911Z","etag":null,"topics":["actions","ai-governance","drift","fleet","github-action","kinetic-gain-suite","protocol-detect","spec-version","typescript"],"latest_commit_sha":null,"homepage":"https://suite.kineticgain.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mizcausevic-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-27T04:13:42.000Z","updated_at":"2026-05-28T00:50:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mizcausevic-dev/kg-suite-spec-version-tracker-action","commit_stats":null,"previous_names":["mizcausevic-dev/kg-suite-spec-version-tracker-action"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mizcausevic-dev/kg-suite-spec-version-tracker-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fkg-suite-spec-version-tracker-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fkg-suite-spec-version-tracker-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fkg-suite-spec-version-tracker-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fkg-suite-spec-version-tracker-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mizcausevic-dev","download_url":"https://codeload.github.com/mizcausevic-dev/kg-suite-spec-version-tracker-action/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fkg-suite-spec-version-tracker-action/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33755379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","ai-governance","drift","fleet","github-action","kinetic-gain-suite","protocol-detect","spec-version","typescript"],"created_at":"2026-06-01T01:05:32.705Z","updated_at":"2026-06-01T01:05:32.764Z","avatar_url":"https://github.com/mizcausevic-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kg-suite-spec-version-tracker-action\n\n[![CI](https://github.com/mizcausevic-dev/kg-suite-spec-version-tracker-action/actions/workflows/ci.yml/badge.svg)](https://github.com/mizcausevic-dev/kg-suite-spec-version-tracker-action/actions/workflows/ci.yml)\n[![License: AGPL-3.0-or-later](https://img.shields.io/badge/License-AGPL--3.0--or--later-blue.svg)](LICENSE)\n\nGitHub Action that walks a **mixed-protocol** directory of [Kinetic Gain Suite](https://suite.kineticgain.com/) JSON documents (AgentCards, MCP Tool Cards, prompt-provenance, evidence bundles, OTLP traces, MCP `tools/list`), groups each doc by `(protocol, spec_version)`, and **fails the build** when one protocol has ≥ 2 distinct spec versions in use (silent migration debt).\n\nWraps [`kg-suite-spec-version-tracker`](https://github.com/mizcausevic-dev/kg-suite-spec-version-tracker) — same routing + drift detection, vendored into the action for self-contained execution.\n\n**Cross-protocol governance gate** — different from the per-protocol fleet-summary actions, this one looks at the *fleet of protocols* and catches the case where some teams are on v0.1 of a spec while others are on v0.2.\n\nPart of the [Kinetic Gain Suite](https://suite.kineticgain.com/).\n\n---\n\n## Usage\n\n```yaml\nname: Suite spec-version governance\non:\n  pull_request:\n    paths: [\"governance-docs/**\"]\n\njobs:\n  spec-tracker:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: mizcausevic-dev/kg-suite-spec-version-tracker-action@v0.1-shipped\n        with:\n          dir: governance-docs/\n          fail-on-drift: true   # default\n```\n\n## Inputs\n\n| input            | required | default       | description |\n|---|---|---|---|\n| `dir`            | ✓        | —             | Directory containing `*.json` Suite documents (mixed protocols supported). |\n| `comment-on-pr`  |          | `auto`        | `auto` posts only on `pull_request` events; `true`/`false` force the behavior. |\n| `fail-on-drift`  |          | `true`        | Fail the run when any protocol has ≥ 2 distinct spec versions in use. |\n| `github-token`   |          | `${{ github.token }}` | Token used to post the PR comment. |\n\n## Outputs\n\n| output               | description |\n|---|---|\n| `total-files`        | Number of JSON files analyzed. |\n| `protocols-detected` | Number of distinct Suite protocols detected. |\n| `drift-buckets`      | Number of protocols with version drift. |\n| `unknown-docs`       | Number of JSON files that did not match any known Suite spec. |\n\n## What it flags\n\n| Code | Severity | Rule |\n|---|---|---|\n| `version-drift` | 🟠 | A protocol has ≥ 2 distinct spec versions in use (e.g., AgentCard v0.1 + v0.2 mixed). **The fail trigger.** |\n| `low-confidence-routing` | 🟡 | A doc was routed by shape signals only (no version discriminator). |\n| `unknown-protocol-document` | 🟡 | A JSON file in the dir didn't match any known Suite spec. |\n| `no-version-discriminator` | ℹ️ | A doc has no explicit `*_version` field. |\n\n## Composes with\n\n- [**`kg-suite-spec-version-tracker`**](https://github.com/mizcausevic-dev/kg-suite-spec-version-tracker) — the library this wraps.\n- [**`kg-protocol-detect`**](https://github.com/mizcausevic-dev/kg-protocol-detect) — the routing primitive used internally.\n- [**`kg-suite-conformance-runner`**](https://github.com/mizcausevic-dev/kg-suite-conformance-runner) — companion validator (required blocks per spec).\n- [**`agent-card-fleet-summary-action`**](https://github.com/mizcausevic-dev/agent-card-fleet-summary-action) · [**`mcp-tool-card-fleet-summary-action`**](https://github.com/mizcausevic-dev/mcp-tool-card-fleet-summary-action) · [**`prompt-provenance-fleet-summary-action`**](https://github.com/mizcausevic-dev/prompt-provenance-fleet-summary-action) · [**`evidence-bundle-fleet-summary-action`**](https://github.com/mizcausevic-dev/evidence-bundle-fleet-summary-action) — per-protocol governance gates.\n\n## License\n\n[AGPL-3.0-or-later](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Fkg-suite-spec-version-tracker-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmizcausevic-dev%2Fkg-suite-spec-version-tracker-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Fkg-suite-spec-version-tracker-action/lists"}