prakharsingh/Audit Packs

Map IaC findings to compliance controls and post an evidence-backed PR summary comment.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
frameworksNewline-separated (or comma-separated) list of framework IDs to assess. Supported: GDPR, HIPAA, SOC2, ISO27001, PCI-DSS, NIST-800-53, FedRAMP, org-policy. yes
min-confidenceComposite score threshold (0.0–1.0). Findings below this are suppressed in enforce mode.0.70
adjudication-modeoff (no LLM calls) | advisory (score shown, nothing suppressed) | enforce (suppress below threshold)off
models-configPath to a model routing YAML file (relative to repo root). Defines provider, model, base_url, and api_key_env for each role. Supports cloud APIs and local endpoints (Ollama, vLLM). If omitted, uses audit-models.yaml at repo root if present, otherwise falls back to built-in defaults (cloud models). audit-models.yaml
detector-modelOverride the detector role's model (sets DETECTOR_MODEL env).""
verifier-modelOverride the verifier role's model (sets VERIFIER_MODEL env).""
adversarial-modelOverride the challenger role's model (sets CHALLENGER_MODEL env).""
judge-modelOverride the consensus role's model (sets CONSENSUS_MODEL env).""
codeql-sarifPath to directory of CodeQL SARIF files from github/codeql-action/analyze. If absent or empty, CodeQL findings are skipped (graceful degradation). ""
ast-rulesPath to custom AST rule modules (executed by the built-in AST engine).ast-rules
trivy-enabledRun Trivy filesystem scan for IaC misconfigs (container image scan also via trivy-image)true
trivy-imageDocker image tag to scan with Trivy (e.g. myapp:latest). Empty = skip image scan.""
tfsec-enabledRun tfsec for Terraform security checkstrue
gitleaks-enabledRun gitleaks to detect hardcoded secrets and credentialstrue
fail-onMinimum severity that blocks the PR: low | medium | high | criticalhigh
base-refGit ref to diff against.origin/main
scan-modediff | full | bothboth
emit-oscalEmit OSCAL assessment-results JSONtrue
emit-coverageEmit coverage matrix as Markdown and HTMLtrue
seo-titleHTML title for coverage.html.Audit Packs Control Coverage Matrix
seo-descriptionHTML meta description for coverage.html.Compliance control coverage report generated by audit-packs.
seo-canonical-urlCanonical URL for coverage.html when published.""
emit-sarifEmit aggregate SARIF for uploadtrue
allow-repo-configTrust repo-supplied configuration (ast-rules/, scanner plugins, audit-models.yaml base_url/api_key_env). The scanned repository is untrusted by default — only enable for repositories you fully control.nofalse
redact-enginesComma-separated list of scanner engines whose raw output is fully masked before reaching any output sink (PR comments, Slack, Jira, OSCAL). Note: masking is applied post-adjudication; the LLM still sees raw evidence for these engines.no""
baseline-fileRepo-relative path to a baseline JSON file created by `audit-packs baseline`. When provided, findings already in the baseline are excluded from the severity gate (shown in a separate 'Baselined' PR comment section).no""
baseline-gate-severitySafety valve: baseline entries at or above this severity still gate the PR even when baselined. One of low | medium | high | critical. Leave empty (default) to excuse all baselined findings regardless of severity.no""
github-tokenGitHub token used to post the PR summary comment. Defaults to the workflow's automatic token.no${{ github.token }}
pr-numberPull request number to comment on. Defaults to the number of the triggering pull_request event (empty on non-PR events).no${{ github.event.pull_request.number }}
namedescription
oscal-pathWorkspace-relative path to the OSCAL JSON output file.
coverage-md-pathWorkspace-relative path to the Markdown coverage matrix.
coverage-html-pathWorkspace-relative path to the HTML coverage matrix.
sarif-pathWorkspace-relative path to the aggregate SARIF file.