borda/ai-rig/result

Read Bridge Job Result

Require one job identifier. Run python "${CLAUDE_PLUGIN_ROOT}/bin/bridge_call.py" result --job-id "<job-id>"; always pass the same --workspace value the originating detached call used; a different or omitted value can resolve to another default workspace and report missing for a job still running elsewhere. Return compact JSON envelope. Preserve workspace-relative transcript_path and incident references; never inline the bounded transcript or peer details.

If the Bash call fails before producing JSON (missing interpreter, non-zero exit, malformed stdout), stop and report the raw failure; never fabricate a status. If status=blocked, open the JSON file referenced by incident and inspect its fault; incident may be null — then report blocked with no incident detail. For output-limit, report incomplete; inspect bounded transcript and, for write-capable work, delta, changed files, and checks, then request verified remaining work as a fresh bounded task. If status=timeout, report the returned effort and the incomplete work, then request a fresh call, optionally narrower in scope or with a larger --timeout-seconds — never a higher effort against the same budget. If status=refused, report its fault (for example recursion-depth); never retry. Never replay the original task automatically.

Lifecycle states without an envelope: queued, running or cancel_requested — not finished; check again once when there is a reason to. failed — the supervisor errored before writing a result; report its error. stalled — the supervisor died or never started; report no result. For failed or stalled implement jobs, inspect the worktree delta and changed files: the child may have edited files before it stopped. missing — mismatched --workspace or unknown job. A status=error object (exit 2) is a refused CLI call, such as a malformed job id: report its error, never retry unchanged. When the originating call omitted --workspace, pass the absolute directory it ran from, never ..