docs(scarab): dedupe brake — scarab IS seed_agent, no second crate#108
Open
gHashTag wants to merge 1 commit into
Open
docs(scarab): dedupe brake — scarab IS seed_agent, no second crate#108gHashTag wants to merge 1 commit into
gHashTag wants to merge 1 commit into
Conversation
Documents why crates/scarab/ should never exist as a separate crate. Everything the Stateless Scarab Pattern needs already lives in crates/trios-igla-race/ (fungible pull_queue.rs, worker_tick in bin/seed_agent.rs, shared asha/ema/sampler). The local-only crates/scarab/ on the operator's machine drifted — it kept 'AND account = $1' while trios-igla-race removed the filter — and caused the 2026-04-30 seed=45 starvation on acc3. If a rename is desired (scarab vs seed_agent), the correct edit is one [[bin]] name change in Cargo.toml, not a second crate. Refs: trios-railway#101 Scarabaeus umbrella trios-railway#106 fungible CLAIM_SQL (merged) trios-trainer-igla#64 fungible scarab.rs (merged)
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.
🪲 One-page doc explaining why
crates/scarab/should never exist as a separate crate.Diagnosis
Operator's local checkout has a
crates/scarab/with parallelclaim.rs,trainer.rs,config.rsfiles duplicatingcrates/trios-igla-race/. That local fork drifted: it keptAND account = $1whiletrios-igla-race/pull_queue.rsshipped the fungible claim. Whenacc3died at 2026-04-30 18:15 UTC,seed=45starved waiting for it whileacc5idled.What this PR ships
Just a doc:
crates/trios-igla-race/docs/SCARAB_DEDUPE.md— explainspull_queue.rs::pull_experimentIS the fungible claim.bin/seed_agent.rsIS the scarab (worker loop).[[bin]]rename inCargo.toml, not a second crate.No binary change
I deliberately did NOT add a thin
bin/scarab.rswrapper. Reason:seed_agent::worker_tickis currentlybin/-private. Exposing it to a second bin requires moving it intolib.rs+ makingClipublic, which expands API surface for zero behavioural gain. A one-line[[bin]]rename is cheaper, safer, and tracked under trios-railway#101 Khepri-3 when ready.Runway
Does not block current Gate-2 drain. Existing
bin/seed-agent(fungible after #106) andtrios-trainer-igla/src/bin/scarab.rs(fungible after #64) are already deployed; operator'srailway upis the only remaining step.Anchor:
phi² + phi⁻² = 3.