Rch

RCH — remote compilation specialist

RCH can offload one explicit compilation command or inspect the remote compiler path. This skill reports what happened; it does not govern retries or repair.

Staged diagnosis works because the offload pipeline fails in order — availability, configuration, hook, classification, sync, remote compile, worker pressure — so the first failing stage localizes the fault and every later stage is noise until it passes. Remediate in irreversibility order: read-only probes and config inspection before daemon restarts, restarts before cleanup, and destructive cleanup or worker mutation only with explicit caller authority.

Named failure mode — green-local blindness: a passing [RCH] local (...) build read as offload success; the local fallback hid that the remote claim was never proved.

Anti-pattern: re-running the build hoping the fallback reason disappears. Corrective: read the recorded fallback reason and fix that stage; the pipeline fails deterministically, not moodily.

Procedure

1. Capture rch check, rch doctor --json, worker status, and the relevant [RCH] summary before mutation.
2. For diagnosis, identify the first failing stage: availability, configuration, hook, classification, sync, remote compile, or worker pressure.
3. Run only the caller-authorized command or documented safe diagnostic once.
4. Capture the exact command, worker when known, exit code, local-fallback reason, and post-action status.
5. Stop and return the evidence.

[RCH] local (...) means the requested remote-offload claim was not proved even when the local build succeeds. Destructive cleanup, worker deployment, daemon configuration, and remote mutation require explicit caller authority.

Output

Return a factual packet with status (remote, local_fallback, failed, or not_proven), commands and exit codes, worker, summary line, and checked/not checked surfaces. Do not include a next action.

References

• Fail-open reasons
• Error catalog
• Troubleshooting
• Recovery playbooks
• Worker operations
• Configuration
• Machine-readable surfaces