Architecture (fleet CLI integration, Jason ruling 2026-08-28): the
package embeds the command surface; operator-owned implementations stay
in the brain (tools/agent-watch). The command resolves the brain home
via resolveBrainHome (MOSAIC_BRAIN_HOME wins, canonical ~/.mosaic
adoption otherwise) and execs the tool there.
- Pass-through contract: allowUnknownOption + variadic args capture the
full ordered argument list (commander 13 measured behavior; no
passThroughOptions, which would force enablePositionalOptions on the
root program fleet-wide). Args, stdout/stderr, and the exit code
belong to the tool.
- Absent tool: exit 127 naming the resolved path (no guessing).
- Signal death / null spawn status: exit 125.
- Spec (6/6 green): brain-home precedence, exit mapping, absent-tool
path. Live smoke verified through the fleet launcher: mosaic watch list
returns real watcher state with exit-code passthrough.
Pre-existing local vitest failures in fleet-agent-crud/fleet-regen/
compose-contract specs measured identical on a clean origin/next stash;
not caused by this change (PR #1462 CI was terminal-green).
marcie
18f3dd49ec