ibrahim1023/ci-rootcause

Deterministic CI root cause analysis with optional guarded fix PR creation.

Trust Signals

name	description	required	default
github_token	Token for GitHub API operations.	yes	—
create_fix_pr	Whether to open a guarded fix PR.	no	false
offline_only	Whether to force offline-only mode (skip remote PR creation).	no	false
post_pr_comment	Whether to post RCA summary comment.	no	true
base_ref	Explicit base ref override for diff analysis.	no	—
head_ref	Explicit head ref override for diff analysis.	no	—
config_path	Project config path.	no	.ci-rootcause.yml
max_fix_files	Maximum files allowed in generated fix patch.	no	5
min_pr_confidence	Minimum confidence required before creating a fix PR.	no	0.75
rollout_profile	Optional rollout profile (supported: safe-github-rollout).	no	""
mode	Execution mode (deterministic, agentic_assist, agentic_full).	no	deterministic
enable_agentic_full	Explicit opt-in gate for agentic_full mode.	no	false
provider	Agentic provider (openai, gemini, anthropic, local).	no	local
model	Optional provider model id.	no	""
provider_api_key	Optional API key for hosted providers; required in agentic modes.	no	""
validation_commands	Optional agentic validation commands (';' or newline separated).	no	""

name	description
classification	Deterministic failure classification.
confidence	Deterministic confidence score.
primary_root_cause_title	Primary root cause title.
rca_json_path	Path to ci-rca.json.
rca_md_path	Path to ci-rca.md.
pr_created	Whether PR was created.
pr_url	URL of created PR when available.
pr_number	Number of created PR when available.
pr_failure_reason_code	Machine-readable reason code when PR creation is skipped or fails.
pr_failure_reason	Reason PR creation was skipped or failed guardrail checks.