agent-log-viewer 1.0.2 → 1.0.3

package/README.md

@@ -36,6 +36,22 @@ and shown above the terminal output).
 ![The chat feed: user bubbles, assistant prose, and tool-call cards with
 statuses and expandable output](docs/media/chat-feed.png)
 
+### Hand a project to an orchestrator
+
+![The orchestrator dock beside its project board](docs/media/orchestrator-dock.png)
+
+Each project can designate one agent as its **orchestrator**. Press
+**Orchestrator** in the project header, tell it what you want shipped, and it
+opens a lane per issue, spawns the implementer, runs a fresh reviewer each
+round and merges on APPROVE. Its mandate and any handoff from a predecessor are
+written for you — there is no "you are an orchestrator" prompt to compose — and
+you come back to the board when an agent needs a decision.
+
+[docs/orchestrator.md](docs/orchestrator.md) walks the whole flow on a fresh
+install: the dock, the board, pipelines, tasks, the attention queue, the
+model/effort matrix the conveyor uses, and when three tasks a week does not
+need any of it.
+
 ### Spawn agents from the board
 
 Each project is a pannable, zoomable scheme — root conversations on top,
@@ -408,6 +424,8 @@ All optional. Transcription variables are documented in full in
 | `LLV_SCHEME_CARDS_PER_PROJECT` | Maximum scanner entries rendered per scheme project (default `80`). List and search remain complete. |
 | `NEXT_PUBLIC_LLV_SCHEME_AGE_HORIZON_HOURS` | Age horizon in hours for automatic card placement on the project scheme (default `48`). A root conversation with activity inside the horizon keeps an automatic card even while idle; older roots leave the canvas for quiet history and «All conversations». Live or running conversations and manually placed cards are never removed by the horizon. Inlined at build time (`NEXT_PUBLIC_*`). |
 | `LLV_HEADLESS_REAPER_THRESHOLD_MS` | Minimum age in milliseconds for the always-active leaked Codex/MCP safety reaper (default `7200000`, two hours; minimum accepted value `60000`). |
+| `LLV_HOST_RETIREMENT_IDLE_HOURS` | How long a structured host's transcript must have been quiet before the automatic retirement sweep may end it (default `6`). `0` turns the sweep off. Staleness is transcript modification time, never process age, and the sweep still refuses any host with a turn in flight, a pending question, an undelivered handoff entry, an open spawn receipt, an unflushed event tail, a realtime binding, or an orchestrator seat. Every qualification is re-proved one step before the signal, and each retirement is written to `state/host-retirement-report.json` and appended to `state/host-retirement-journal.ndjson`. |
+| `LLV_HOST_RETIREMENT_GRACE_MS` | How long a retiring host may take to honour SIGTERM before its tree is force-killed (default `5000`, capped at `60000`). Raising it lowers how many hosts one sweep attempts, so a sweep's terminations still fit well inside the interval before the next one; whatever is skipped is reported as deferred and picked up by the following sweep. |
 | `LLV_DOCKER_NSENTER_SHIMS` | `1` makes the agent CLI resolver prefer the container's `/usr/local/bin` nsenter shims for host CLIs. Set automatically by the Docker image; leave unset on a host runtime. See [docs/docker.md](docs/docker.md). |
 
 ## Config paths