cranot/roam-code Analysis
Pre-indexed code intelligence for AI coding agents — health scoring, quality gates, SARIF output
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 11, 2026
- License
- Apache 2.0
Pinned Snippet
uses: cranot/roam-code@3332a2ef65c27b8f3f30b994813fbb435ca43529 # v13.8.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| version | Exact roam-code version to install; source installs this action checkout; latest requires allow-latest=true | no | 13.10.0 |
| allow-latest | Explicitly permit the mutable version=latest install path (true/false) | no | false |
| commands | Space-separated roam commands to run (default: "health") | no | health |
| changed-only | Incremental mode: adapt commands to changed files + dependents when possible (true/false) | no | false |
| changed-depth | Transitive depth for changed-only dependent expansion (used by roam affected) | no | 3 |
| base-ref | Optional explicit base ref/SHA for changed-only mode (default: PR base SHA or push before SHA) | no | "" |
| sarif | Upload SARIF results to GitHub Code Scanning (true/false) | no | false |
| sarif-commands | Space-separated commands to export as SARIF (`auto` = SARIF-capable subset of `commands`) | no | auto |
| sarif-category | Base category for SARIF upload (job/python suffixes are auto-appended) | no | roam-code |
| sarif-max-runs | Pre-upload SARIF cap: maximum runs kept in combined payload | no | 20 |
| sarif-max-results | Pre-upload SARIF cap: maximum results per run | no | 25000 |
| sarif-max-bytes | Pre-upload SARIF cap: maximum JSON bytes for combined SARIF | no | 10000000 |
| comment | Post sticky PR comment with results (true/false) | no | true |
| gate | Quality gate expression (supports key ops + trend functions like velocity(metric)<=0). Empty = no gate. | no | "" |
| cache | Cache the SQLite index between runs (true/false) | no | true |
| python-version | Python version to use | no | 3.11 |
Outputs
| name | description |
|---|---|
| health-score | The health score (0-100) if health command was run |
| exit-code | The exit code from roam commands (0=success, 5=gate failure) |
| sarif-file | Path to generated SARIF file (if sarif input is true) |
| sarif-category | Resolved SARIF upload category |
| sarif-truncated | Whether SARIF guardrails truncated runs/results before upload |
| sarif-results | Result count in final SARIF payload after guardrails |
| changed-only | Whether changed-only mode was enabled |
| base-ref | Resolved base ref used for changed-only mode |
| affected-count | Detected changed+dependent file count in changed-only mode |