Investigate local agent-program normalization and terminal-default patch set

[mvillmow]

Summary

Local uncommitted changes appear to be an in-progress migration of agent program handling toward a canonical registry plus a default of terminal instead of claude-code.

What Changed

• Added lib/agent-programs.ts to centralize program IDs, labels, commands, aliases, and normalization helpers.
• Updated agent creation, wake, and zoom card flows to use canonical program mapping.
• Updated service-layer session/wake logic to use centralized command resolution instead of scattered string matching.
• Changed several defaults from claude-code to terminal, including orphan/auto-registered agents.
• Added tests covering explicit Codex startup.
• Updated plugin agent-commands.sh defaults/help text to match the new terminal default.
• yarn.lock also changed, but this appears to be lockfile churn rather than a source-level dependency change.

Why This Likely Exists

This looks like an attempt to:

• normalize program naming (claude, claude-code, shell, terminal),
• make non-Claude agents like Codex launch correctly,
• stop implicitly defaulting many flows to Claude,
• align the plugin CLI with the app's program model.

Risk / Follow-up

This migration looks incomplete. Some codepaths and fixtures still reference the old claude-code default, so the codebase may need a broader consistency pass before merge.

Patch Files

Patch files are linked below:

• Program normalization patch: https://gist.githubusercontent.com/mvillmow/b6f3269428fb99b6f581587214690a20/raw/3d83f1c2de462d4b1a512e8c8e903c6404700c97/program-normalization.patch
• Plugin default-program patch: https://gist.githubusercontent.com/mvillmow/b6f3269428fb99b6f581587214690a20/raw/b7ce295554438421b88226b3d4afc59a15d103ca/plugin-default-program.patch
• Lockfile patch: https://gist.githubusercontent.com/mvillmow/b6f3269428fb99b6f581587214690a20/raw/07c1ecb37f27f44f737c68ba4bee502b627af663/yarn-lock.patch
• New helper source: https://gist.githubusercontent.com/mvillmow/b6f3269428fb99b6f581587214690a20/raw/abfcfd501a140989e174dff81b1b588f331a4b24/agent-programs.ts

[Koroqe]

Agent program normalization is tricky — we went through a similar migration and ended up with 12 specialized agent roles (product manager, architect, QA lead, etc.) each with their own command and scope. Having a canonical registry made the whole thing manageable. Open-sourced the structure here: https://github.com/Koroqe/claude-code-sdlc