Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/reference/conditional-ack.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,5 +125,5 @@ Resolution does not retroactively un-persist a `contract.pr.deferred_actions` en
- MCP tool: [`sandbox/egg_agent_tools/tools/brc.py`](../../sandbox/egg_agent_tools/tools/brc.py) — `mcp__brc__resolve_obligation`.
- PR body renderer: [`orchestrator/pr_obligations.py`](../../orchestrator/pr_obligations.py) — `render_obligations_section`, `render_obligations_section_from_normalized`, `normalize_deferred_actions`. Shared by the single-PR path (`_build_pre_merge_obligations_section` in `routes/pipelines.py`) and the slice-DAG context-PR path (the obligations section is rendered into the `egg/<id>/work → main` context PR body opened at the plan→implement boundary, [#2777](https://github.com/jwbron/egg/issues/2777); the legacy terminal-slice "umbrella PR" treatment was removed).
- Contract: [`shared/egg_contracts/models.py`](../../shared/egg_contracts/models.py) — `PRMetadata.deferred_actions`, `DeferredAction`.
- CLI: [`sandbox/egg_lib/orch_cli.py`](../../sandbox/egg_lib/orch_cli.py) — `cmd_consensus_ack`, `cmd_consensus_status`.
- CLI: [`sandbox/egg_lib/orch_cli.py`](../../sandbox/egg_lib/orch_cli.py) — `cmd_consensus_ack`, `cmd_consensus_status`, `cmd_brc_resolve_obligation` (`egg-orch brc resolve-obligation`, added in slice-5 of #2908).
- Related: [Concurrent Execution: Reviewer verdict variants](../guides/concurrent-execution.md#reviewer-verdict-variants), [HITL Decisions](../hitl-decisions.md), [Orchestrator CLI](orchestrator-cli.md), [Reviewer Sync](../../shared/prompts/REVIEWER-SYNC.md).
6 changes: 3 additions & 3 deletions sandbox/agent-config/rules/orchestrator.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,12 +71,12 @@ Progress + overseer (iter-2 added the overseer surface):
- `mcp__progress__overseer_alert` — Prefer this over `egg-orch overseer alert`. Broadcast an `OVERSEER_ALERT` to all agents in the pipeline. **Producers blocked by reviewer NACKs (or proactive scope questions) on operator-decidable architectural choices — use `mcp__sdlc__register_open_question`, not this. Alerts are informational; decisions are HITL gates. See [`mission.md`](mission.md) → "HITL Decisions vs. Operational Alerts".**
- `mcp__progress__query_status` — Prefer this over `egg-orch pipeline status`. Read structured pipeline status (agent matrix, BRC phase, blocked roles). Note: the MCP tool lives in the `progress` namespace per decision-5; the CLI lives in the `pipeline` subcommand subtree (decision-17 keeps the drift-gate symmetric with `overseer_alert`).

No-CLI BRC introspection (iteration 1 + 2):
BRC introspection (#2908):

- `mcp__brc__get_state` — Returns the full structured BRC consensus state as JSON.
- `mcp__brc__list_blocking` — Returns the list of agent roles currently blocking consensus.
- `mcp__brc__read_peer_artifact` — Reads `.egg-state/brc-history/<pipeline>-<phase>.json` filtered by `peer_role` with `limit`/`cursor` pagination. No CLI by design (reviewer-forensics helper; operators inspect the files directly).
- `mcp__brc__resolve_obligation` — Mark a reviewer's conditional-ACK obligation as satisfied in-cycle (#2338). Required: `reviewer_role`, `producer_role`. Optional: `commit_sha`, `note`. The orchestrator rejects self-resolution (`resolver_role == producer_role`), so the producer cannot drive their own resolution — typically the tester (or any non-producer satisfier) calls this after cherry-picking the conditioning commit. No CLI by design; in-cycle resolution flows through the MCP surface.
- `mcp__brc__read_peer_artifact` — Reads `.egg-state/brc-history/<identifier>-<phase>.json` filtered by `peer_role` with `limit`/`cursor` pagination (default `limit=50`, max 500). CLI alias: `egg-orch brc read-peer-artifact` (slice-5 of #2908; registration still `cli_command=None` — see agent-tools.md).
- `mcp__brc__resolve_obligation` — Mark a reviewer's conditional-ACK obligation as satisfied in-cycle (#2338). Required: `reviewer_role`, `producer_role`. Optional: `commit_sha`, `note`. The orchestrator rejects self-resolution (`resolver_role == producer_role`), so the producer cannot drive their own resolution — typically the tester (or any non-producer satisfier) calls this after cherry-picking the conditioning commit. CLI alias: `egg-orch brc resolve-obligation` (slice-5 of #2908; registration still `cli_command=None` — see agent-tools.md).

See [`docs/reference/agent-tools.md`](../../../docs/reference/agent-tools.md)
for the full 29-verb inventory.
Loading