diff --git a/README.md b/README.md index 5a772a6ba3..a503e287de 100644 --- a/README.md +++ b/README.md @@ -288,7 +288,7 @@ Start with **[docs/index.md](docs/index.md)**, which has task-specific lookup ta | **Slice-DAG implement phase** | [Slice-DAG Implement Phase](docs/architecture/slice-dag.md) | | **SDLC pipeline** | [SDLC Pipeline Guide](docs/guides/sdlc-pipeline.md) | | **Human-in-the-loop decisions** | [HITL Decisions](docs/hitl-decisions.md) | -| **Orchestrator & overseer** | [Orchestrator Architecture](docs/architecture/orchestrator.md) | +| **Orchestrator & overseer** | [Orchestrator Architecture](docs/architecture/orchestrator.md) · [On-Demand Agent Lifecycle](docs/architecture/on-demand-agent-lifecycle.md) | | **Health monitoring** | [Pipeline Health Monitoring](docs/guides/pipeline-health-monitoring.md) | | **Agent roles & permissions** | [Agent Roles Reference](docs/reference/agent-roles.md) | | **Non-Claude model routing** | [Upstream Routing](docs/architecture/upstream-routing.md) · [Per-Agent Models](docs/guides/per-agent-models.md) | diff --git a/docs/architecture/README.md b/docs/architecture/README.md index 1386912e97..1b2e367d59 100644 --- a/docs/architecture/README.md +++ b/docs/architecture/README.md @@ -53,7 +53,7 @@ See the [main README](../../README.md) for the architecture diagram. | **Shared Libraries** | Config, logging, git utilities, orchestrator types | [Shared README](../../shared/README.md) | | **egg_contracts** | SDLC contract models, role-based mutation validation, multi-agent orchestration | `shared/egg_contracts/` | | **egg_orchestrator** | Shared orchestrator types and sandbox-to-orchestrator communication | `shared/egg_orchestrator/` | -| **Multi-Agent Orchestration** | Concurrent agent execution (Coder, Tester, Documenter, Reviewers) | `orchestrator/concurrent_executor.py`, `orchestrator/kubernetes_spawner.py` | +| **Multi-Agent Orchestration** | Concurrent agent execution (Coder, Tester, Documenter, Reviewers) | `orchestrator/concurrent_executor.py`, `orchestrator/kubernetes_spawner.py`, `orchestrator/event_loop.py`, `orchestrator/supervision_policy.py` | ## SDLC Contracts @@ -148,6 +148,7 @@ The SDLC pipeline orchestrates agent-based development with structurally enforce - [Integration-Test Trust Boundary](integration-test-trust-boundary.md) - Test execution contexts (in-sandbox-agent / trusted-CI-runner / human-operator), fixture tier table, and hard-NACK rules for plan-phase Primitive-Existence (§9) and Trust-Boundary (§10) audits - [BRC Memory Artifact](brc-memory.md) - Per-role-per-pipeline distilled memory file (`.egg-state/agent-outputs//brc-memory-.md`) written by `brc_ack`/`brc_nack`; schema, three `EGG_BRC_MEMORY` modes, atomic-write contract, fail-closed path constructor, distill-on-write cap at 20, and the role-allowlist coverage that makes the path writable for every participant role ([#2908](https://github.com/jwbron/egg/issues/2908)) - [BRC Consensus Wrapper](orchestrator.md#brc-consensus-wrapper) - Deterministic event-pump wrapper loop, wrapper-side heartbeat + gateway-session keep-alive subshells, the idle/no-progress safety budget that replaced the 3-restart FAIL cap, and the `git revert` rollback plan after slice-4 deleted the legacy capped-restart template (`_CONSENSUS_WRAPPER_TEMPLATE` / `_RECOVERY_SYSTEM_PROMPT` / SSE `consensus.reached` / `MAX_CONSENSUS_RESTARTS`) and the agent-side heartbeat path. Wait-side companion in [agent-wait-patterns §10](../reference/agent-wait-patterns.md#10-brc-consensus-wrapper-event-pump-model) ([#2908](https://github.com/jwbron/egg/issues/2908)) +- [On-Demand Agent Lifecycle](on-demand-agent-lifecycle.md) - Event-loop ownership modes (`EGG_EVENT_LOOP_OWNER` pod vs orchestrator), the sha256 dedupe-key contract, `JobSupervisor` failure supervision (streak/backoff/alert via shared `supervision_policy.py`), lifecycle-aware monitor matrix, worktree re-attach + session-reuse rules, live proving-run checklist ([#3064](https://github.com/jwbron/egg/issues/3064)) ## Why Wrappers, Not MCP