Files
Charon/docs/implementation/DOCS_TO_ISSUES_FIX_2026-01-11.md
akanealw eec8c28fb3
Some checks are pending
Go Benchmark / Performance Regression Check (push) Waiting to run
Cerberus Integration / Cerberus Security Stack Integration (push) Waiting to run
Upload Coverage to Codecov / Backend Codecov Upload (push) Waiting to run
Upload Coverage to Codecov / Frontend Codecov Upload (push) Waiting to run
CodeQL - Analyze / CodeQL analysis (go) (push) Waiting to run
CodeQL - Analyze / CodeQL analysis (javascript-typescript) (push) Waiting to run
CrowdSec Integration / CrowdSec Bouncer Integration (push) Waiting to run
Docker Build, Publish & Test / build-and-push (push) Waiting to run
Docker Build, Publish & Test / Security Scan PR Image (push) Blocked by required conditions
Quality Checks / Auth Route Protection Contract (push) Waiting to run
Quality Checks / Codecov Trigger/Comment Parity Guard (push) Waiting to run
Quality Checks / Backend (Go) (push) Waiting to run
Quality Checks / Frontend (React) (push) Waiting to run
Rate Limit integration / Rate Limiting Integration (push) Waiting to run
Security Scan (PR) / Trivy Binary Scan (push) Waiting to run
Supply Chain Verification (PR) / Verify Supply Chain (push) Waiting to run
WAF integration / Coraza WAF Integration (push) Waiting to run
changed perms
2026-04-22 18:19:14 +00:00

2.6 KiB
Executable File

Docs-to-Issues Workflow Fix - Implementation Summary

Date: 2026-01-11 Status: Complete Related PR: #461 QA Report: qa_docs_to_issues_workflow_fix.md


Problem

The docs-to-issues.yml workflow was preventing CI status checks from appearing on PRs, blocking the merge process.

Root Cause: Workflow used [skip ci] in commit messages to prevent infinite loops, but this also skipped ALL CI workflows for the commit, leaving PRs without required status checks.


Solution

Removed [skip ci] flag from workflow commit message while maintaining robust infinite loop protection through existing mechanisms:

  1. Path Filter: Workflow excludes docs/issues/created/** from triggering
  2. Bot Guard: if: github.actor != 'github-actions[bot]' prevents bot-triggered runs
  3. File Movement: Processed files moved OUT of trigger path

Changes Made

File Modified

.github/workflows/docs-to-issues.yml (Line 346)

Before:

git commit -m "chore: move processed issue files to created/ [skip ci]"

After:

git commit -m "chore: move processed issue files to created/"
# Removed [skip ci] to allow CI checks to run on PRs
# Infinite loop protection: path filter excludes docs/issues/created/** AND github.actor guard prevents bot loops

Validation Results

  • YAML syntax valid
  • All pre-commit hooks passed (12/12)
  • Security analysis: ZERO findings
  • Regression testing: All workflow behaviors verified
  • Loop protection: Path filters + bot guard confirmed working
  • Documentation: Inline comments added

Benefits

  • CI checks now run on PRs created by workflow
  • Maintains all existing loop protection
  • Aligns with CI/CD best practices
  • Zero security risks introduced
  • Improves code quality assurance

Risk Assessment

Level: LOW

Justification:

  • Workflow-only change (no application code modified)
  • Multiple loop protection mechanisms (path filter + bot guard)
  • Enables CI validation (improves security posture)
  • Minimal blast radius (only affects docs-to-issues automation)
  • Easily reversible if needed

References