Repository navigation
fix(swarm): resolve plain swarm, swarm_pane, disable, and remote roster caveats - #4
Merged
Merged
Conversation
… rosters Update /setup-pstack global hook commands with a test ! -f check and document plugin disable parity, plain /swarm pass-through, swarm_pane plan.json and brain-directory timeline screenshots, and remote --roster-only lookup across capsules, skills, setup guide, and README.
Honor plugin disable flags in config.json before session capsule injection or PreToolUse gating, resolving config paths from PSTACK_CONFIG_DIR, parent plugin directories, or HOME. Leave built-in /swarm sessions and unprefixed plain swarms unmanaged without polluting member-map.json or non-worker-roots.json, while upgrading cleanly when pstack workers or commands join. Allow read-only workers to write Overview timeline screenshots inside explicit or brain/<conversation-id> artifact directories and protect .system_generated metadata across all worker roles. Resolve remote swarm.json anchors through bounded --roster-only CLI probes cached in remote-rosters.json with fail-open fallback.
…tian/.gemini/antigravity-cli/worktrees/dd4f7d38-fa48-4cc7-91e3-a75e80f12bba/swarm-impl-guard-5a016fe3 into fix/swarm-caveats
Reject dotfile and extension-bearing directory segments, directory or non-image copy sources, and recursive directory copies when read-only workers target artifact screenshot paths. Validate Python Path.symlink_to, Path.hardlink_to, and Path.link_to targets across direct, variable-bound, and Path-wrapped expressions. Block rsync delete flags and glob or brace patterns that can reach .system_generated inside worker artifact roots, with behavioral regression coverage.
…tian/.gemini/antigravity-cli/worktrees/dd4f7d38-fa48-4cc7-91e3-a75e80f12bba/swarm-impl-guard-5a016fe3 into fix/swarm-caveats
caelaxie
commented
Nov 14, 2026
caelaxie
left a comment
Contributor
Author
There was a problem hiding this comment.
passes the bar on b1f4f79. hook and docs changes stay scoped to the four agy 1.5.9 caveats (plain /swarm pass-through, ro-* brain-dir screenshots with .system_generated blocked, config.json disable, remote --roster-only rosters). no cursor-team-kit mentions, skills stay in skills/, control-cli and control-ui still load. ci run 10 green on agy 1.5.9: validate+install+list of 13 skills including control-cli and control-ui, guard tests 25/25, statechart 267/0. squash-merging.
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.
Why
Users running
agy-pstack-nextonagy1.5.9hit four remaining native swarm compatibility caveats. Plain/swarmsessions were governed by global pstack hooks, read-onlyro-*verifiers could not save timeline screenshots in<appDataDir>/brain/<conversation-id>/forswarm_pane,agy plugin disableanduninstalldrifted from global~/.gemini/config/hooks.json, and remoteswarm.jsonanchors failed open without resolving worker rosters.What changed
hooks/guard.mjsandhooks/guard.test.mjs. Checkplugins["agy-pstack-next"].enabledinconfig.jsonbefore capsule injection orPreToolUsegating, leave built-in/swarmsessions and unprefixed plain swarmsunmanagedwithout pollutingmember-map.jsonornon-worker-roots.json, allowro-*screenshot writes (.png,.jpg,.jpeg,.webp) and extensionless subdirectories inside each worker's ownbrain/<conversation-id>/artifact folder while blocking.system_generatedmutations across all worker roles, and resolve remoteswarm.jsonanchors via bounded--roster-onlyCLI probes cached inremote-rosters.jsonandmember-map.json.roles/*.md,skills/**,docs/guide/01-setup.md, andREADME.md. Update/setup-pstackglobalhooks.jsoncommands totest ! -f '<abs_guard_path>' || node '<abs_guard_path>'for exit-0 uninstall safety, and documentconfig.jsondisable parity, plain/swarmpass-through,swarm_paneplan.jsonand brain-directoryScreenshot:timeline rules, and remote--roster-onlyresolution.Scope
hooks/guard.mjs,hooks/guard.test.mjs,roles/coordinator.md,roles/research.md,skills/pstack/SKILL.md,skills/control-ui/SKILL.md,skills/setup-pstack/SKILL.md,docs/guide/01-setup.md, andREADME.md.~/.gemini/config/*files on operator machines untouched until the updated plugin is pulled and/setup-pstackis re-run if desired.Blast Radius
Affects
SessionStart,PreInvocation, andPreToolUsedecisions inhooks/guard.mjsplus coordinator and read-only worker documentation. Ordinary non-swarm chats and plain built-in/swarmruns pass throughunmanaged.Verification
node --test hooks/guard.test.mjspassed25/25tests across10suites with0hostplugin_datamutations, alongside44/44live adversarial confinement probes across artifact screenshot paths, symlinks, globs, and.system_generatedmetadata.agy plugin validate --strict .passed (13skills,1hook,0findings),269/269relative markdown links resolved across92.mdfiles,roles/*.mdpassed zero-dash and zero-colon checks, and isolatedagy 1.5.9install, disable, enable, and uninstall lifecycle checks exited0.node --test skills/statechart/scripts/test/*.test.tsexited0(267passed,0failed).