Live-validation (Lead, w-jarvis) found the native heartbeat was INERT in
production: the Pi extension gates on MOSAIC_AGENT_NAME, but tmux panes
inherit the tmux SERVER environment (not this script's env, nor the systemd
unit's), so the name was empty in-pane for BOTH ad-hoc and systemd agents.
Result: no native .hb, no model self-report — only the sidecar fallback ran.
Fix: %q-quote the agent name and export it into the pane command alongside
PATH, so the extension sees it -> nativeHbEnabled() -> writes <name>.hb with
model + busy/ok turn state.
Re-validated live via the launcher (isolated socket, real pi on glm-5.2):
- pane env now carries MOSAIC_AGENT_NAME
- <name>.hb written with status=ok + model=glm-5.2 + .hb.native marker
- status flips ok -> busy on a real turn -> ok on turn end
- sidecar defers to the fresh native marker
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83
WIP — not for merge yet. Implements the core of the custom Pi harness (R14/R15):
- runtime/pi/mosaic-extension.ts: native heartbeat — writes the same .hb contract
(ts/pid/status[/model]) on a MOSAIC_HEARTBEAT_INTERVAL timer; turn_start/turn_end
flip status busy/ok; model self-report via ctx.model; touches a .hb.native
precedence marker. Also FIXES a latent bug: session_end -> session_shutdown (the
old handler never fired) + corrects the import scope to @earendil-works/pi-coding-agent.
- start-agent-session.sh: sidecar DEFERS when the .hb.native marker is fresh
(< 2x interval), else writes the fallback — native precedence, sidecar fallback,
same contract so fleet ps is agnostic (per Lead's design). Generated script
validated (bash -n) + deferral/fallback behavior tested.
REMAINING before PR: surface model in `fleet ps` (parseHeartbeat + row); vitest for
the native-HB writer; "proper tool usage" (registerTool) piece; rebase onto #599's
%q sidecar (overlap on the printf line).
Refs #588
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
