#1035 Add lifecycle workspace with the canonical envelope, vocabulary & lane fold

[williamthorsen]

What

Introduces @codeassembly/lifecycle, a shared workspace package that houses the canonical lifecycle-event envelope, the event vocabulary, and the fold that turns a lane's events into session and lane state. The package is dependency-free and browser-bundle-safe.

Why

The canonical event envelope and vocabulary lived only on the write side, and the only fold from events to lane state was throwaway spike code, so the planned lane and watching surfaces had no reusable foundation to build on. The repo's own history shows the cost of leaving a shared schema uncentralized: run-log-schema and event-folder each drifted into divergent duplicate copies across run-core and factory. Consolidating the envelope, vocabulary, and fold into one dependency-free, browser-safe package gives readers and writers a single source and forecloses that drift.

Details

🏗️ Internal features

• @codeassembly/lifecycle defines the lifecycle-event envelope and the v0 event vocabulary once, for both writers (the emit helper, the hook relay) and readers (watching surfaces).
• Tolerant readers: parseEventLine turns a JSONL line into an envelope, and parseLanePath turns an event-file path into lane and session identity — each returning null for malformed or foreign input rather than throwing, as befits append-only telemetry.
• The pure lane fold derives session and lane state from a lane's events: working/waiting from turn boundaries, work narration from skill events, the pending ask a waiting session holds, session end and resume, and lane closure from a worktree probe, all sessions ending, or lane-wide staleness. Time and probe results arrive as inputs, so the derivation runs identically in a browser, a server, or a test.
• Branch-name ticket attribution: a Jira-style key anywhere in the name, or a numeric prefix, each with an optional .N revisit suffix, yields a lane ticket ref; other names yield none. The pattern contract is defined once here.
• The package carries no runtime dependencies, and its public surface is browser-bundle-safe.

♻️ Refactoring

• The envelope and vocabulary move out of the agents emit-event module; the emit helper and hook relay now import them from @codeassembly/lifecycle.
• The agents session-context ticket-id extractor now composes the branch-name pattern from the shared package, keeping only its configured ticket_ref_prefix formatting and PR-sentinel handling.

🧪 Tests

• A browser-bundle test esbuild-bundles the public surface for the browser platform, so a stray Node-builtin import fails the unit suite rather than the first downstream web build.

Closes #1035

[github-actions]

Dependency audit

Production dependency audit passed.