[ca] Document CI Cleaner Architecture Limitation

[github-actions]

Issue Summary

The hourly CI cleaner workflow (#278) cannot perform its intended CI cleanup tasks because the agentic execution environment lacks required build tools.

Root Cause

The workflow has a hybrid architecture mismatch:

1. Setup phase (standard GitHub Actions steps 46-65):

   • Installs Make, Go, Node.js
   • Installs npm and dev dependencies

2. Execution phase (agentic workflow):

   • Expects build tools to be available
   • Attempts to run make fmt, make lint, make test-unit, make recompile
   • Problem: Runs in separate container without access to installed tools

Environment Investigation

Checked the agentic execution environment:

✅ Available:

• gh CLI (v2.83.2)
• git
• curl

❌ Missing:

• make - Required for all build commands
• go - Required for compilation and testing
• node/npm - Required for JavaScript formatting/testing

🔍 Attempted:

• /opt/hostedtoolcache/ - Empty
• /usr/local/go/ - Not found
• sudo apt-get install - No sudo access
• apt-get install - Permission denied

Impact

Current status: The hourly CI cleanup workflow is non-functional.

• ❌ Cannot format code automatically
• ❌ Cannot run linters automatically
• ❌ Cannot run tests automatically
• ❌ Cannot recompile workflows automatically

Documentation Added

Created docs/troubleshooting/ci-cleaner-architecture.md documenting:

• The architectural issue
• Environment analysis
• Recommended solution approaches
• Impact assessment

Recommended Solutions

1. Inline commands - Replace make with direct bash commands
2. Pre-build binary - Build gh-aw in setup, cache for agent
3. Custom container - Use image with pre-installed tools
4. Redesign workflow - Split detection and fixing into separate workflows

Next Steps

The team should review this limitation and choose a solution approach to make the CI cleaner functional.

---

Workflow Run: #278
Timestamp: 2025-12-22T14:09:40Z

AI generated by Hourly CI Cleaner

[pelikhan]

@copilot remove docs file and fix the agentic workflow . See ci.yml / build to configure build steps

[Copilot]

@pelikhan I've opened a new pull request, #7261, to work on those changes. Once the pull request is ready, I'll request review from you.