| name | ci-fix-monitor |
| audience | swarm-plugin |
| description | Codex adapter for monitoring and fixing CI failures on opencode-swarm PRs. Use when diagnosing failed checks, fixing `package-check` (npm tarball) failures, resolving quality/lint/format errors, fixing macOS cross-platform file I/O failures, or watching a PR until all checks are green. |
CI Fix Monitor
Read .opencode/skills/ci-fix-monitor/SKILL.md for the full protocol.
Also load:
.agents/skills/commit-pr/SKILL.md before committing or pushing any fix.agents/skills/engineering-conventions/SKILL.md if the fix touches source files.agents/skills/running-tests/SKILL.md before running any test suite as part of a fix
Codex-specific execution notes:
- MCP tool names (
mcp__github__*) are injected by the runtime harness and may differ across environments. Verify availability via ToolSearch before first use in a session.
- No
gh CLI available. Use mcp__github__pull_request_read (method get_check_runs) to list check status and mcp__github__get_job_logs (with return_content: true) to fetch failure logs.
- For
package-check failures: package-check validates the npm tarball (npm pack + tarball contents). A failure is a source/build/package-manifest problem, not generated-file drift. dist/ is generated and NOT committed — do not stage it; run bun run build locally only when you need the bundle to verify (e.g. node --input-type=module -e "await import('./dist/index.js'); console.log('dist import OK')"). There is no longer a committed-dist drift check.
- For a branch behind main (version-drift):
git fetch origin main && git rebase origin/main (abort with git rebase --abort if conflicts occur and escalate to user), then git push --force-with-lease origin <branch>. Force-push is required and expected after rebase.
- For format violations:
bunx biome format --write <specific-file> — do NOT run biome format --write . on the whole repo.
- After any source fix, run the focused test file (
bun test <file>) before committing.
- Do not declare victory until ALL required checks show green;
skipped is acceptable only if the same check was skipped on the base branch.
