Skip to content
LumenFlow

Changelog

This is the narrative changelog — a hand-curated view grouped by initiative and release theme. For the mechanically generated per-release feed (every wu:done across every tag, newest first), see the auto-generated changelog.

The current published stable version is v5.3.2. All @lumenflow/* packages ship together; see the Compatibility Matrix for Node.js and package-manager support.

INIT-057 — Conductor-mode kernel surfaces (v4.24)

Section titled “INIT-057 — Conductor-mode kernel surfaces (v4.24)”

Released 2026-04-18. Ten work units across five phases that turn the kernel’s outbound sync pipe from a 3-kind lifecycle stream into a 14-kind tagged-union event contract, plus a scope-gated tool surface and an agent-host reachability registry. This is the foundation that lets external control surfaces drive LumenFlow orchestration remotely without tailing agent-local files.

Phase 1 — Architectural ratification

Section titled “Phase 1 — Architectural ratification”
  • WU-2636 — ADR-011 ratified: package boundary, tagged-union discriminant, schema versioning, sync cadence, scope grammar, and agent-host reachability classes pinned before downstream implementation. (6bf67bc63)

Phase 2 — SDK contract + emitters

Section titled “Phase 2 — SDK contract + emitters”
  • WU-2637 — SDK contract: delegation registry, WUEvent mirror, and tagged-union SdkKernelEvent with 30 variants; schema_version bumped to 2. (155fb4468)
  • WU-2638 — Emitter module kernel-event-sync/ with buildKernelEventV2 factory for the 14 conductor kinds, including event_id idempotency. (59adc657a)

Phase 3 — Inbound control surface

Section titled “Phase 3 — Inbound control surface”
  • WU-2639 — GET /tools discovery endpoint on the kernel HTTP surface with pack-aware metadata. (fae015778)
  • WU-2640 — Per-tool auth scopes on POST /tools/:name, capability-scoped tokens, and the 403 missing_scopes response shape. (2652491a9)

Phase 4 — Reachability + sync cadence

Section titled “Phase 4 — Reachability + sync cadence”
  • WU-2641 — Agent-host enrollment registers reachable HTTP URL and reachability class (reverse-tunnel, public, lan, unreachable). (756556cc0)
  • WU-2642 — Sub-minute sync cadence: the control-plane event subscriber now runs in sidecar mode, started by wu:claim / agent:session, driven by control_plane.sync_interval. (7c17252ac)
  • WU-2643 — Narrow conductor emissions (orchestration:next_safe_actions_updated, org:capacity_snapshot) wired into orchestrate:init-status. (c53389e67)

Phase 5 — Follow-ups

Section titled “Phase 5 — Follow-ups”
  • WU-2649 — Coverage backfill to 94% on the agent-session heartbeat path. (df497db3d)
  • WU-2650 — wu:prep commit-order gate: test(…) must precede feat(…) under software_delivery.gates.tdd_ordering. (ae18766f5)

v4.23 — Orchestration becomes its own feature area

Section titled “v4.23 — Orchestration becomes its own feature area”

Released 2026-04. Three work units that complete INIT-056 Phase 3: orchestration docs move to their own top-level section, reconciliation learns capacity and integrity, and the control-plane SDK becomes the single contract every surface speaks.

  • WU-2632 — Unify the orchestration contract on @lumenflow/control-plane-sdk: CLI, MCP, and tests all import the same shapes. (13113bd59)
  • WU-2633 — Elevate /orchestration/ to a top-level Starlight feature area with five pages (overview, lifecycle, state machine, artifact bundle, capacity + integrity, SDK). (9e2aca9f6)
  • WU-2634 — Wire capacity + integrity evidence into reconciliation so orchestration refuses to advance on contaminated or over-capacity workspaces. (ef192d1f8)

v4.22 — Evidence-based control plane lands

Section titled “v4.22 — Evidence-based control plane lands”

Released 2026-04. The bulk of INIT-056 ships: ADR-010 is ratified, launch receipts become durable artifacts, the 10-state classifier replaces the collapsed-to-in_progress story, MCP coordination tools expose the same JSON the CLI writes, and the docs catch up.

Control-plane foundation

Section titled “Control-plane foundation”
  • WU-2616 — ADR-010 ratified: one initiative state model, many launchers. (8047ec90c)
  • WU-2617 — Persist launch receipts and logical-wave artifacts for initiative orchestration. (3f2d1bad2)
  • WU-2618 — Reconcile orchestration status surfaces from execution evidence. (3d23e7fda)
  • WU-2619 — Reconciliation, integrity checks, and capacity-aware advancement. (989aeff09)
  • WU-2620 — Publish the orchestration state contract in @lumenflow/control-plane-sdk. (a0ef4b1fb)
  • WU-2621 — Expose the orchestration JSON through MCP coordination tools. (d5e916076)
  • WU-2622 — Update orchestration docs and templates for the evidence-based control plane. (06809fcd5)
  • WU-2626 — Align Starlight orchestration docs with the control-plane contract. (033d3494e)

Drift repairs + docs plumbing

Section titled “Drift repairs + docs plumbing”
  • WU-2623 — Repair CLI test drift blocking template-backed docs WUs. (f571d87f7)
  • WU-2624 — Scope docs-only test planning for template-backed docs WUs. (cd9ca4d00)
  • WU-2625 — Allow template-backed markdown docs in documentation WUs. (ca3559723)
  • WU-2627 — Repair core test drift blocking orchestration docs source updates. (781833e6c)
  • WU-2628 — Repair methodology regression drift blocking docs-source gates. (21421a953)
  • WU-2629 — Repair MCP parity drift. (6943ce79b)
  • WU-2630 — Repair MCP / CLI integration parity drift. (5fce38b01)
  • WU-2631 — Repair CLI truth drift blocking docs-source gates. (1194ed7cb)

Earlier releases

Section titled “Earlier releases”

For the full history from v1.0.0 through current, including patch releases and version-alignment bumps, see the auto-generated changelog. Every wu:done since the first tag is represented there.