| name | ci-debug |
| description | Use when GitHub Actions CI is red, matrix failures need isolated repair, or repeated full reruns make remote diagnosis inefficient. |
Generated from blueprint.yaml. Do not edit this block by hand.
Executable Interfaces:
Call famulus.invoke with required caller (caller skill), interface, version, and arguments; optional dry_run defaults to false. Compact uses ordered positionals plus an option mapping; ordered raw argv uses positionals: [] plus every argv token in list options. Never mix forms.
ci-debug._rtx.interface.run-ci — Run the complete remote CI matrix for an exact pushed candidate.
- Caller:
ci-debug
- Version: 1
- Alternative:
default
Arguments JSON (replace labels with actual values). Omit optional positionals and options that are not needed.
{"options": {"--context": "DIR", "--expected-sha": "SHA", "--ref": "REF", "--repo-root": "REPO", "--timeout": "SECONDS"}, "positionals": [], "stdin": null}
Required options: ["--context", "--expected-sha", "--ref", "--repo-root"]; positional arity: 0..0; stdin: forbidden
ci-debug._rtx.interface.run-targeted-tests — Run one selected failure set or complete matrix element for an exact candidate.
- Caller:
ci-debug
- Version: 1
- Alternative:
default
Arguments JSON (replace labels with actual values). Omit optional positionals and options that are not needed.
{"options": {"--context": "DIR", "--expected-sha": "SHA", "--jobs": "N", "--os": "OS", "--profile": "PROFILE", "--ref": "REF", "--repo-root": "REPO", "--selector": "NODE", "--task": "TASK", "--timeout": "SECONDS"}, "positionals": [], "stdin": null}
Required options: ["--context", "--expected-sha", "--os", "--ref", "--repo-root", "--selector", "--task"]; positional arity: 0..0; stdin: forbidden
- Alternative:
default
Arguments JSON (replace labels with actual values). Omit optional positionals and options that are not needed.
{"options": {"--context": "DIR", "--expected-sha": "SHA", "--jobs": "N", "--os": "OS", "--profile": "PROFILE", "--ref": "REF", "--repo-root": "REPO", "--selectors-json": "JSON", "--task": "TASK", "--timeout": "SECONDS"}, "positionals": [], "stdin": null}
Required options: ["--context", "--expected-sha", "--os", "--ref", "--repo-root", "--selectors-json", "--task"]; positional arity: 0..0; stdin: forbidden
- Alternative:
default
Arguments JSON (replace labels with actual values). Omit optional positionals and options that are not needed.
{"options": {"--context": "DIR", "--expected-sha": "SHA", "--from-report": "PATH", "--jobs": "N", "--os": "OS", "--profile": "PROFILE", "--ref": "REF", "--repo-root": "REPO", "--task": "TASK", "--timeout": "SECONDS"}, "positionals": [], "stdin": null}
Required options: ["--context", "--expected-sha", "--from-report", "--os", "--ref", "--repo-root", "--task"]; positional arity: 0..0; stdin: forbidden
- Alternative:
default
Arguments JSON (replace labels with actual values). Omit optional positionals and options that are not needed.
{"options": {"--context": "DIR", "--expected-sha": "SHA", "--jobs": "N", "--os": "OS", "--profile": "PROFILE", "--ref": "REF", "--repo-root": "REPO", "--task": "TASK", "--timeout": "SECONDS", "--whole-element": true}, "positionals": [], "stdin": null}
Required options: ["--context", "--expected-sha", "--os", "--ref", "--repo-root", "--task", "--whole-element"]; positional arity: 0..0; stdin: forbidden
Instruction Interfaces:
These are LLM-readable instruction surfaces. Read and follow them directly; do not invoke the MCP server for them.
ci-debug.source.instructions-repair-element.interface.repair-element@1 — Repair and verify one assigned CI matrix element without integrating it or claiming overall CI success.git-workflow.interface.default@1 — Check branch and ownership boundaries first, then perform only explicitly authorized and exactly scoped Git mutations.
CI Debug
Create or reuse one non-secret debug context and supply it to every
ci-debug._rtx.interface.run-ci and repair-element invocation. The context
owns stable repository/workflow identity and immutable request-scoped reports;
it never owns credentials, credential-bearing URLs, or raw authentication
output. Persisted setup is a handoff aid, not authority: each invocation must
still revalidate authentication, repository identity, and the exact pushed
candidate. Keep the coordinator's failure ledger, branch assignments, and agent
state outside the machine-owned context; do not extend its schema ad hoc.
Use ci-debug._rtx.interface.run-ci for the exact pushed candidate.
Retire superseded runs before dispatching replacement work through the
already-authorized CI control surface. If cancellation authority is
unavailable, record the capacity blocker and do not duplicate the full run.
While a matrix remains active, consume completed matrix-element reports and
logs as soon as an already-authorized CI surface exposes them. Do not wait for
the enclosing matrix before diagnosing a completed failure or routing a stalled
element into the failure ledger.
While its report is red:
- Group failures by matrix element. Give each repair subagent one element, the
shared debug context, smallest selector set containing its known failures,
the report, and an allowed path scope. Prefer exact failing test nodes, then
the smallest set of containing test files when exact nodes are unavailable.
Do not include selectors already known to pass.
- Run independent repair elements in bounded parallel through
ci-debug.interface.repair-element; use a sequential fallback when workers
are unavailable.
- Review returned commits, diffs, and targeted-test evidence. Integrate accepted
patches sequentially under
git-workflow.interface.default.
- Push the integrated candidate and record its exact SHA.
- Before the next complete matrix, use
ci-debug._rtx.interface.run-targeted-tests on the exact integrated
candidate for every affected matrix element. Start with the smallest
selectors needed to detect integration interactions, then run each whole
affected element. Return new failures to the ledger.
- Only after every affected matrix element is green, use
ci-debug._rtx.interface.run-ci again for the complete matrix.
Stop only when the full report is green or a repair element returns a concrete
blocked reason. Targeted tests and whole-element tests never establish overall
green. Machine reports are evidence, not Git authority; machine interfaces do
not create branches, commit, push, integrate, or clean worktrees.
After the full report is green, REQUIRED: read prevention.md
and complete its prevention review before closing the CI repair.
