Build local Every Code worker handoff

[cbusillo]

Objective

Build the local Mac worker handoff that claims Launchplane Every Code work requests and launches visible Code sessions.

Finish Line

A local Mac worker claims Launchplane work requests and runs visible Code/tmux sessions

Current Status

State: Local worker handoff is complete. PRs #289, #292, and #293 are merged, covering polling, visible tmux handoff, start/status/stop controls, immediate blocked states, and terminal done/blocked reporting through every-code finish.
Next action: Use the merged flow operationally: keep the local worker running with uv run launchplane every-code start, inspect with status, and stop with stop. Future UI surfacing belongs under the broader Launchplane Every Code automation plan (#278).
Blocked by: None.
Last verified: 2026-05-06 - PR #293 was green on GitHub and merged as 4d75735; local start/status/stop smoke passed on this Mac; local finish smoke marked a running request done with a PR URL.

Scope

• Poll or long-poll Launchplane for pending work assigned to this host.
• Validate local checkout presence and tmux session/window idempotency.
• Run code exec visibly and leave the session open for inspection.
• Report running/done/blocked status and PR URL/error summary when available.
• Avoid using GitHub API scans as the primary trigger.

Acceptance Criteria

• Worker can process one queued request end to end from Launchplane claim to reported terminal status.
• Existing visible sessions are not duplicated.
• Local checkout missing or command failure becomes a blocked request with a useful operator message.
• Worker can be started/stopped cleanly on the Mac.

Relationships

• Sub-issue of Build Launchplane-backed Every Code automation #278.
• Uses prototype material from feat(scripts): add local Every Code issue poller code#26.

Validation

• Local smoke test with a manually seeded Launchplane work request.
• Tests or scripted dry-run for checkout resolution and tmux window naming.

Decisions

• Local execution remains local; Launchplane does not directly open terminal sessions.

Open Questions

• Should the worker live in launchplane, code, or a tiny shared script/package?
• What is the initial worker auth mechanism?

[cbusillo]

Closed after PR #288 deployed. The first local worker handoff now claims a queued request, starts or reuses a visible tmux session, and records running/blocked status. Main CI/Security/CodeQL passed and Deploy Launchplane succeeded for 598b4bf.