Repository navigation
fix(swarm): align local swarm.json anchors and ketchup plan.json with agy 1.5.9 - #6
Merged
Merged
Conversation
Update skills/ketchup/SKILL.md (frontmatter description, ro-swarm, and ro-history) and the /ketchup row in README.md so Swarm UI Overview inspection checks .system_generated/swarm/plan.json and board.jsonl Screenshot lines alongside optional narrator view.json. Refine the agy CLI fallback note to state that agy CLI sessions omit both swarm_pane and swarm_narrator from <skills>, so ketchup falls back to board.jsonl and members.json when neither plan.json nor view.json exists. Verified with agy plugin validate --strict . and agy plugin validate --strict --json . (exit 0, 13 skills, 1 hook, 0 findings).
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
Our compatibility audit against
agy1.5.9native swarm surfaced two minor maintenance gaps in local swarm anchor parsing and/ketchupOverview inspection.agy1.5.9writes.system_generated/swarm/swarm.jsonwithbackendset to"local"andswarm_idset to the coordinator conversation ID on local swarms, and writes.system_generated/swarm/plan.jsonwhenswarm_paneis active. This PR alignshooks/guard.mjsand/ketchupwith bothagy1.5.9runtime artifacts.What changed
getAnchorCoordinatorId,parseRemoteSwarmAnchor, andinspectSwarmDirectoryinhooks/guard.mjssobackend"local"swarm.jsonanchors resolveswarm_idlocally, never invoke remote swarm CLIs, and allownon-worker-roots.jsoncaching whenmembers.jsonis absent.hooks/guard.test.mjscovering full local swarms, orphanedtitle-only localswarm.jsonanchors, plain-swarm suppression, and resolved or unresolved remotespanneranchors.skills/ketchup/SKILL.mdandREADME.mdsoro-swarmandro-historyinspect.system_generated/swarm/plan.jsonand boardScreenshotlines alongside optional narratorview.json, while documenting theagyCLI fallback whenswarm_paneandswarm_narratorare omitted from<skills>.Scope
swarm.jsonanchor handling inhooks/guard.mjsandplan.jsoninspection guidance inskills/ketchup/SKILL.mdandREADME.md.spannerroster resolution and existing worker role-capsule rules unchanged.Blast Radius
hooks/guard.mjsruns onSessionStart,PreInvocation, andPreToolUseacross coordinator and swarm worker sessions. Existing local swarms withmembers.jsonand remotespanneranchors retain identical behavior, while orphaned localswarm.jsonfiles stop bypassingnon-worker-roots.jsoncaching or probing remote board CLIs.Verification
hooks/guard.test.mjsfails before thehooks/guard.mjsfix (1failed) and passes onHEAD(TMPDIR=/tmp node --test hooks/guard.test.mjs,30/30passed across10suites).agy plugin validate --strict --json .and a clean temporaryHOMEagy plugin install .plus manifest and permissions check (13skills,4capsules,6topologies,1hook,0findings)../skills/pstack/scripts/watch-pr --help(exit 0).