ci-fix-monitor git:20260711.5972d3eA

Immutable. This exact content is served forever at /api/v1/blob/f48f554bb9b84363.

---
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:

1. `.agents/skills/commit-pr/SKILL.md` before committing or pushing any fix
2. `.agents/skills/engineering-conventions/SKILL.md` if the fix touches source files
3. `.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.