docs(arch): add decentralized bot mesh design#1
Merged
Conversation
Capture the converged design for replacing the central coordinator with a decentralized @mention-routed bot mesh: - no scheduler: channel forwards @, falls back to default_bot, else silent - per-channel gap-free channel_seq event clock (allocated at finalize) - two-class resource consistency (Class 1 append-only / Class 2 fs workspace), relaxed to monotonic completeness; read-current + cursor + index recovery - independent channel_operations log unioned via channel_seq, no fan-out - Environment template plugin layered above the resource API - Bot@Bot task chains: dispatch gate (authoritative) + reuse per-msg cancel frame - opt-in channel-level runaway budget reusing the chain status gate Design intent ahead of code; includes the gap vs the current gateway and a step-by-step implementation sequence. Indexed from ARCHITECTURE_OVERVIEW. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This was referenced Jul 16, 2026
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
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.
Capture the converged design for replacing the central coordinator with a decentralized @mention-routed bot mesh:
Design intent ahead of code; includes the gap vs the current gateway and a step-by-step implementation sequence. Indexed from ARCHITECTURE_OVERVIEW.
Change description
Change type
Test
pytestpassed in fullnpm run buildno error reportednpm run lint/npm test/npm run buildof the corresponding package has passedDatabase migration
alembic headshas one head, thenalembic upgrade head)Security and Release Impact
.env, logs, databases, uploaded files, private keys, tokens or production configurationsRelated Issues
Closes #