stack/docs/scratchpads/747-wsa-dehardcode.md

#747 — De-hardcode orchestrator and interaction agent names

Objective

Replace branded Mos/Tess symbols, filenames, DI tokens, and error prose with role-neutral orchestrator/interaction vocabulary without changing env-driven runtime identity behavior. Add optional roster alias and provider fields and show aliases in mosaic fleet ps with name fallback.

Scope and constraints

• Requirements: /home/hermes/agent-work/reviews/747-wsa-dehardcode-brief.md.
• Branch: feat/747-dehardcode-orchestrator-interaction-names from main at e72388b2.
• Keep MOSAIC_AGENT_NAME and MOSAIC_ORCHESTRATOR_AGENT_NAME unchanged.
• Sample/test data may retain operator display names.
• No behavior change beyond optional roster metadata and alias display.
• Budget: no explicit cap; conservative mechanical-rename scope only.
• TDD: optional and skipped because this is a mechanical rename with existing focused coverage; add focused alias/schema regression coverage before completion.

Plan

1. Rename coordination and durable-session files and symbols using canonical vocabulary.
2. Scrub branded symbol names and error prose in the assigned source trees while preserving allowed sample data.
3. Extend roster schema with optional alias and provider; update fleet roster typing/rendering and focused tests.
4. Run grep-clean verification, build, typecheck, lint/format, focused coord/durable-session/fleet tests, and roster validation.
5. Commit, queue-guard, push, open a Gitea PR closing #747, and report to the coordinator.

Progress

• 2026-07-13: Task resumed from coordinator brief; repository clean at e72388b2.
• Renamed coordination and durable-session files, exports, gateway DI symbols, DTOs, services, repositories, and tests.
• Replaced branded authority/error prose while preserving the existing /api/coord/mos compatibility route and env-variable identity inputs.
• Added optional roster alias/provider support and alias-first fleet ps display with canonical-name fallback.

Verification

• pnpm typecheck: passed (42 tasks).
• pnpm build: passed (23 tasks).
• pnpm lint: passed (23 tasks).
• pnpm format:check: passed.
• Coordination tests: 7 passed.
• Agent durable-session/runtime tests: 23 passed.
• Gateway coordination/durable-session/integration tests: 20 passed.
• Full fleet.spec.ts: 192 passed, including alias/provider parsing and alias display.
• JSON Schema 2020 validation: legacy minimal roster and extended alias/provider roster passed; alias and provider remain absent from required.
• Grep verification: no branded symbol/type/file/DI names or error prose remain in assigned source trees; one allowed Tess Owner test-data display name remains.