feat: align semantic Hermes swarm agents

[Cossackx]

Summary

• Replace legacy numbered swarm assumptions with semantic worker IDs while retaining legacy-compatible validation.
• Add the 10-agent semantic roster: orchestrator, km-agent, builder, reviewer, qa, researcher, ops-watch, maintainer, strategist, inbox-triage.
• Document each semantic agent and align swarm metadata, route affordances, lifecycle/health/checkpoint routes, and one-shot checkpoint parsing.
• Fix /api/swarm-health and /api/swarm-runtime to resolve semantic worker wrappers from swarm.yaml.wrapper instead of assuming executable names equal worker ids.
• Route worker checkpoints to the semantic orchestrator by default instead of legacy swarm3.
• Add regression coverage for semantic wrapper names such as builder:task and semantic orchestrator notification routing.
• Add durable dispatch / alignment-health guidance to Workspace docs and SOP surfaces, including docs/swarm/ALIGNMENT_HEALTH.md as the source-owned SOP.
• Refresh Swarm docs to use semantic worker names instead of stale numbered/legacy role examples.

Test Plan

• pnpm exec vitest run src/server/swarm-roster.test.ts
• pnpm exec vitest run src/server/swarm-roster.test.ts src/server/swarm-health.test.ts
• pnpm exec vitest run src/server/swarm-notifications.test.ts src/server/swarm-foundation.test.ts src/server/swarm-health.test.ts src/server/swarm-roster.test.ts
• pnpm exec eslint src/routes/api/swarm-health.ts src/server/swarm-health.ts src/server/swarm-health.test.ts
• pnpm exec eslint src/server/swarm-notifications.ts src/server/swarm-notifications.test.ts src/server/swarm-foundation.ts src/server/swarm-foundation.test.ts src/routes/api/swarm-runtime.ts src/routes/api/swarm-health.ts src/server/swarm-health.ts src/server/swarm-health.test.ts src/server/swarm-roster.ts src/server/swarm-roster.test.ts
• git diff --check
• Local roster API returned all 10 semantic workers.
• Local health API returned wrappersConfigured: 10 and all workers wrapperFound: true.
• Local runtime API returned builder wrapper path ending in /builder:task and supportsOneShotDispatch: true.
• Local one-shot dispatch smoke to qa returned checkpointStatus: checkpointed.
• Browser checked /swarm: semantic cards visible, Route to agent buttons render, no console errors.
• Alignment SOP doc smoke: verified worker.wrapper || worker.id, builder:task, wrappersConfigured, and durable dispatch guidance are present.
• Swarm docs stale-term scan: no swarm-swarm3, qa:verify, or GPT-5.4 remains in docs/swarm/*.md.

Notes

• This PR intentionally keeps legacy worker ID compatibility while enabling semantic profile IDs.
• Runtime-only local profile/SOUL/wrapper changes are not included in this repository PR.
• Full repo pnpm exec vitest run and pnpm exec eslint . still have unrelated pre-existing failures; changed-file tests and lint are green.
• I reviewed whether to split this PR. Recommendation for now is to keep it as one semantic-swarm PR because the docs, roster, route affordances, and health/runtime fixes now describe one coherent migration. If maintainers want smaller diffs, the task/Kanban UX work is the separable slice.

[outsourc-e]

Closing as superseded by #432. The validated fix was folded into the consolidated batch branch fix/issue-sweep-batch-20260514 for one review/merge path.