Skip to content

the-supervisor-advises - #816

Merged
VeryComplexAndLongName merged 2 commits into
mainfrom
the-supervisor-advises
Oct 5, 2026
Merged

VeryComplexAndLongName merged 2 commits into
mainfrom
the-supervisor-advises

Conversation

@VeryComplexAndLongName

Copy link
Copy Markdown
Owner

Implements the-supervisor-advises (ADR 0039, accepted).

The supervisor is rules over records that already exist: no process, no model, no timer. It suggests and changes nothing, and is on by default (supervisor.mode: advise, or off).

  • A failed run says why. The agent runner matches the failure's reason and the last 8 KiB of output against seen causes: not installed, not signed in, blocked by the machine, network, rate-limited, server error. The diagnosis says whether repeating helps, quotes the line and gives a remedy; an unseen failure is unknown. It rides the failed event (one optional field), the audit entry, the chain's ending, the run log and the change's last run.
  • Three new suggestions beside the others, in the Pipeline (both hosts) and openspec-ui-cli advise: a run that has said nothing new past silentAfterSeconds (600), a run waiting on a person past waitingAfterSeconds (60), and a change whose last run failed for a cause repeating cannot fix. A stop is only recommended, with the command.
  • Diagnosis shown beneath a failure in the chain panel, the AI panel, the run log, on the card and in openspec-ui-cli run. A Supervisor choice in both Harness Settings views.

Checks: typecheck and lint 0; every test project passes (see tasks 6.1, including why the root test was run in parts); openspec validate --strict. Live (6.3): run with an agent not on the PATH printed the diagnosis, recorded it in the audit log, and advise then pointed the change out.

Open: 6.4 is Human-only (the Pipeline and Harness Settings in a host), so the merge gate waits on it.

🤖 Generated with Claude Code

…pervisor-advises)

ADR 0039. Rules over records that already exist, which suggest and change
nothing; on by default (supervisor.mode: advise).

- A failed run is diagnosed once, in the agent runner, from its reason and
  the last 8 KiB of its output: not installed, not signed in, blocked by
  the machine, network, rate-limited, server error, or unknown. The
  diagnosis says whether repeating helps, quotes the line, and gives a
  remedy. It rides the failed event, the audit entry, the chain's ending,
  the run log and the change's last run.
- The supervisor points out a run that says nothing new past
  silentAfterSeconds (600), a run waiting on a person past
  waitingAfterSeconds (60), and a change whose last run cannot be
  repeated. Shown in the Pipeline in both hosts and by advise.
- Diagnosis beneath a failure in the chain panel, the AI panel, the run
  log, on the card and in `openspec-ui-cli run`.
- Supervisor choice in both Harness Settings views.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@VeryComplexAndLongName
VeryComplexAndLongName enabled auto-merge (squash) October 4, 2026 10:41
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@VeryComplexAndLongName
VeryComplexAndLongName merged commit 5f45ce9 into main Oct 5, 2026
10 checks passed
@VeryComplexAndLongName
VeryComplexAndLongName deleted the the-supervisor-advises branch October 5, 2026 05:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant