docs(swarm_map_policy): name the plugin's counterpart Swarm Map, not HSM - #124
Merged
Merged
Conversation
The control plane is now NimbleCoOrg/swarm-map. Prose and the repo link only. Deliberately NOT renamed — these are wired into every deployed agent's config.yaml plugin list and .env, and group checks are fail-CLOSED, so a rename is a fleet-wide breaking change that denies all group messages: - the `swarm_map_policy` plugin dir name - `HSM_URL`, `HERMES_AGENT_NAME` - the "HSM API URL" prompt and HSM-prefixed identifiers in the body Refs: memory/plans/2026-07-18-swarm-map-org-transfer-runbook.md §2D
Extends the plugin-docs change with the misses an audit found. - GHCR (the one with teeth): FORK-NOTICE and README told users to pull `ghcr.io/nimblecoai/hermes-agent-mt`. That package is retained read-only and frozen at 2026-07-21, but it is still PUBLIC — so `docker pull` against it SUCCEEDS and silently returns pre-move code with no error. CI has published to `ghcr.io/nimblecoorg/...` since the transfer (ghcr-publish.yml:50 derives the namespace from `github.repository_owner`, verified). Repointed, and the banner now says plainly that the old path still resolves and is therefore a trap. - Both rename banners described the superseded `hermes-agent` -> `hermes-agent-mt` rename under the OLD owner, and carried alias guidance that expired 2026-07-15. Rewritten to describe the current NimbleCoAI -> NimbleCoOrg move, with the earlier rename kept as one line of history. - Five live current-tense references to "Hermes Swarm Map" -> `[Swarm Map](https://github.com/NimbleCoOrg/swarm-map)`, including two in patches/README.md that the first pass missed. Deliberately NOT done: the audit suggested creating a placeholder repo at NimbleCoAI/hermes-swarm-map to "remove the redirect dependency". That would PERMANENTLY delete the transfer redirect every existing link depends on — the documented kill-switch. Rejected. The old path must stay unclaimed. Still not renamed (fleet-breaking, fail-closed group checks): the swarm_map_policy dir, HSM_URL, HERMES_AGENT_NAME. patches/000*.patch untouched.
Audit finding: rewriting the banners dropped the old bullet's warning about `ghcr.io/nimblecoai/hermes-agent` (the PRE-rename path), leaving the stalest pins of all undocumented. Verified before publishing the claim: that package is still public, `:latest` returns manifest 200, its newest dated tag is 2026-07-21, and ghcr-publish.yml now targets only `hermes-agent-mt` — so it receives nothing new while still serving successful pulls. Same trap as the -mt package, one rename older. Both old packages stay; they are the intended read-only grace window.
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.
Companion to
NimbleCoOrg/swarm-map#187. The control plane is nowNimbleCoOrg/swarm-map; this updates the plugin's prose and repo link.Docs-only, on purpose. These stay exactly as they are:
swarm_map_policyplugin dir nameHSM_URL,HERMES_AGENT_NAME"HSM API URL"prompt and HSM-prefixed identifiers in the bodyThey're wired into every deployed agent's
config.yamlplugin list and.env, and group checks are fail-closed — renaming any of them is a fleet-wide breaking change that would deny all group messages. "HSM" is the correct heritage shorthand here.Refs:
memory/plans/2026-07-18-swarm-map-org-transfer-runbook.md§2D🤖 Generated with Claude Code