docs: manual test runbook for fork-style diagnostic exploration#92
Merged
Conversation
Closes #78. Companion to #67. Documents how to run the coordinator in multi-fork mode (STREAMOPS_AGENT_DIAGNOSTIC_FORKS), what to expect in the logs and the audit trail (with the real emitted strings: fan-out line, per-fork hypothesis spawn lines, merged confidence distribution, cross-fork xf- conflicts, the escalation surfacing), and four concrete ways to prove it actually forked (shared cid with interleaved spawn lines, distinct hypotheses, f{i}: namespaced ids, xf- conflict ids). Includes the single-agent baseline to diff against and pointers to the follow-ups (#91 dynamic hypotheses, #77 cross-cycle change awareness). Also refreshes the README topology: the Monitor->Diagnostic edge now shows the typed DetectedAnomaly handoff (was "full text", stale since #80), the report edge notes it is attributed (#88), and a note + link points to the runbook.
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 free
to 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.
Closes #78. Companion to #67.
Documents how to run and verify fork-style parallel diagnostic exploration:
STREAMOPS_AGENT_DIAGNOSTIC_FORKS=3, viascripts/demo_scenario.pyor--single-cycle.Fanning out N diagnostic forksline, per-forkSpawning Diagnostic Agent (hypothesis: ...)lines, the merged confidence distribution, cross-forkxf-conflicts withf{i}:namespaced claim ids, and the escalation surfacing (UNRESOLVED diagnostic conflict(s); forcing review).cid=with interleaved spawn lines (concurrent, not sequential), distinct hypotheses per fork,f{i}:namespaced ids in the merged diagnosis,xf-cross-fork conflict ids. Cross-references theasyncio.Barrierunit test.forks=1) to diff against.Also refreshes the README topology: the Monitor->Diagnostic edge now shows the typed
DetectedAnomalyhandoff (was "full text", stale since #80), the report edge notes it is attributed (#88), and a note + link points to the runbook.Docs only; no code change.
https://claude.ai/code/session_01R5VygSzbGTggW7mHd3PVwE