Docs: agent-lifecycle activity monitor + tmux contract fixes - #862
Merged
Conversation
…e tmux contract claims - Add an Activity Monitor section: pane-digest change detection, the two corrections (active pane -> working, 3-min-silent -> idle), the conditional-write guard, and the metadata.source tag. - Note that orphan-session cleanup runs only in the startup pass, not on the 30s periodic tick, and that missing-session transitions emit a system latest_event. - Fix the launch contract to show the real bash -c wrapper (stderr tee to the setup log + exit-code capture file the reconciler reads). - Drop the stale 'Window name: main' claim (never set) and note edge-hyphen trimming in session-name sanitization. - Add the missing 'review' value to the AgentRole list. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Uh oh!
There was an error while loading. Please reload this page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Nightly docs audit (deep-dive:
docs/04-agent-lifecycle.md, from Brain next_focus).Audited: the lifecycle doc's state machine, reconciliation, and tmux contract sections against
agents/reconciler.ts,agents/activity-monitor.ts,agents/tmux/runtime.ts,agents/tmux/session-name.ts,agents/manager.ts, andserver/agent-lifecycle-runtime.ts. Diff since last audit (9d3913d) was refactor/test-only (#860, #861), so no diff-driven work.Changed (all in
docs/04-agent-lifecycle.md):working"Activity detected"; 3-min-silent →idle"No recent activity detected"), theupsertLatestEventIfCurrentconditional-write guard, andmetadata.source: "activity-monitor".reconcileAgents()) — the 30s tick is status-only.bash -cwrapper (stderr tee to/tmp/dispatch_setup_<id>.log, exit capture to/tmp/dispatch_<session>.exit) thatreadSetupLogTail/readExitInfoconsume, plus the post-launch tmux options.Window name: mainclaim (never set anywhere).reviewvalue to theAgentRolelist and fixed thestandardbullet (persona launches get rolereview, notstandard).Deferred: nothing new backlogged; next run deep-dives
docs/10-operations-runbook.md(not audited since ~June 12 — deploy-mechanism drift is a known pattern there).🤖 Generated with Claude Code