faultline-cli/faultline-action

Diagnose CI failures with faultline — deterministic, evidence-backed analysis from your build log

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Apr 30, 2026
License: None

Pinned Snippet

workflow.ymlSHA-pinned

uses: faultline-cli/action@b31ce2a41a3ce73cd2629974e96719f63c0e12e5 # 0.2.0

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
log	Path to the failing build log file	yes	—
version	Faultline version to install (e.g. v0.4.3). Defaults to the latest release.	no	""
format	Output format for the human-readable summary: 'text' or 'markdown'	no	markdown
annotations	Emit GitHub-native CI annotations alongside the summary	no	false
json	Produce a machine-readable JSON analysis artifact	no	true
bayes	Add Bayesian ranking hints to the JSON analysis output	no	false
workflow	Produce a deterministic workflow.v1 handoff artifact via faultline workflow	no	true
workflow-mode	Mode passed to faultline workflow: 'agent' or 'human'	no	agent
fail-on-silent	Exit non-zero if silent failure detectors fire	no	false
delta	Enable experimental delta analysis against the last successful run on the same branch	no	false
github-token	GitHub token used by the delta provider. Required when delta is true.	no	""
upload-artifacts	Upload the JSON and markdown outputs as GitHub Actions workflow artifacts	no	true
artifact-retention-days	Number of days to retain uploaded artifacts	no	30
job-summary	Append the markdown analysis to the GitHub Actions job summary	no	true

Outputs

name	description
summary-markdown	Path to the markdown analysis summary file
analysis-json	Path to the JSON analysis artifact (set when json input is true)
workflow-json	Path to the workflow.v1 JSON artifact (set when workflow input is true)
failure-id	The matched failure ID from the top diagnosis (empty when no match)