@lumenflow/cli 5.4.0 → 5.7.12

package/dist/wu-status.js

@@ -106,6 +106,32 @@ function formatValidCommands(context) {
     }
     return lines;
 }
+/**
+ * WU-2941: Build a structured remediation hint when YAML and the worktree
+ * branch disagree. Output pattern matches the wu:done preflight error
+ * format so both surfaces feel like one story:
+ *
+ *   WU-X: main shows ready, branch shows in_progress.
+ *   Run pnpm wu:recover --id WU-X --action reset to reconcile.
+ *
+ * Returns empty string when there is no WU context or state is consistent.
+ */
+export function formatDriftRemediationHint(context) {
+    const { wu } = context;
+    if (!wu || wu.isConsistent)
+        return '';
+    const reason = wu.inconsistencyReason ?? '';
+    // Extract YAML-side and branch-side statuses from the structured reason
+    // string emitted by readWuState (see context/wu-state-reader.ts).
+    const mainMatch = reason.match(/Main shows ['"]?([^'"\s]+)['"]?/);
+    const branchMatch = reason.match(/branch[^']*shows ['"]?([^'"\s]+)['"]?/);
+    const mainStatus = mainMatch ? mainMatch[1] : wu.status;
+    const branchStatus = branchMatch ? branchMatch[1] : 'unknown';
+    return [
+        `${wu.id}: main shows '${mainStatus}', branch shows '${branchStatus}'.`,
+        `Run pnpm wu:recover --id ${wu.id} --action reset to reconcile.`,
+    ].join(' ');
+}
 /**
  * Format complete status output
  */
@@ -130,6 +156,13 @@ export function formatStatusOutput(context) {
     lines.push('## WU State');
     lines.push(...formatWuState(context));
     lines.push('');
+    // WU-2941: Drift remediation hint — structured, inline, before commands.
+    const driftHint = formatDriftRemediationHint(context);
+    if (driftHint) {
+        lines.push('## Remediation');
+        lines.push(`  ${EMOJI.WARNING} ${driftHint}`);
+        lines.push('');
+    }
     // Valid commands section
     lines.push('## Valid Commands');
     lines.push(...formatValidCommands(context));

package/dist/wu-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"wu-status.js","sourceRoot":"","sources":["../src/wu-status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wu-status.js","sourceRoot":"","sources":["../src/wu-status.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/cli",
-  "version": "5.4.0",
+  "version": "5.7.12",
   "description": "Command-line interface for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -43,6 +43,7 @@
     "config-get": "./dist/config-get.js",
     "config-set": "./dist/config-set.js",
     "cost-summary": "./dist/cost-summary.js",
+    "db-journal-recover": "./dist/db-journal-recover.js",
     "delegation-list": "./dist/delegation-list.js",
     "distribution-preflight": "./dist/distribution-preflight.js",
     "file-delete": "./dist/file-delete.js",
@@ -92,6 +93,7 @@
     "lumenflow-onboard": "./dist/onboard.js",
     "lumenflow-pre-commit-check": "./dist/pre-commit-check.js",
     "lumenflow-release": "./dist/release.js",
+    "lumenflow-setup-prereqs": "./dist/lumenflow-setup.js",
     "lumenflow-sync-templates": "./dist/sync-templates.js",
     "lumenflow-uninstall": "./dist/lumenflow-uninstall.js",
     "lumenflow-upgrade": "./dist/lumenflow-upgrade.js",
@@ -200,16 +202,16 @@
     "xstate": "^5.28.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lumenflow/core": "5.4.0",
-    "@lumenflow/host": "^5.4.0",
-    "@lumenflow/initiatives": "5.4.0",
-    "@lumenflow/kernel": "5.4.0",
-    "@lumenflow/memory": "5.4.0",
-    "@lumenflow/agent": "5.4.0",
-    "@lumenflow/packs-software-delivery": "^5.4.0",
-    "@lumenflow/metrics": "5.4.0",
-    "@lumenflow/packs-agent-runtime": "^5.4.0",
-    "@lumenflow/control-plane-sdk": "5.4.0"
+    "@lumenflow/agent": "5.7.12",
+    "@lumenflow/core": "5.7.12",
+    "@lumenflow/control-plane-sdk": "5.7.12",
+    "@lumenflow/initiatives": "5.7.12",
+    "@lumenflow/host": "^5.7.12",
+    "@lumenflow/kernel": "5.7.12",
+    "@lumenflow/memory": "5.7.12",
+    "@lumenflow/packs-agent-runtime": "^5.7.12",
+    "@lumenflow/packs-software-delivery": "^5.7.12",
+    "@lumenflow/metrics": "5.7.12"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

package/packs/agent-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-agent-runtime",
-  "version": "5.4.0",
+  "version": "5.7.12",
   "description": "Agent runtime pack scaffold for LumenFlow — governed model-turn execution, pack config, and provider capability baselines",
   "keywords": [
     "lumenflow",

package/packs/sidekick/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-sidekick",
-  "version": "5.4.0",
+  "version": "5.7.12",
   "description": "Sidekick personal assistant pack for LumenFlow — 16 tools for task management, typed memory, channels, routines, and audit",
   "keywords": [
     "lumenflow",

package/packs/software-delivery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-software-delivery",
-  "version": "5.4.0",
+  "version": "5.7.12",
   "description": "Software delivery pack for LumenFlow — work units, gates, lanes, initiatives, and agent coordination",
   "keywords": [
     "lumenflow",

package/templates/core/AGENTS.md.template

@@ -1,6 +1,8 @@
+<!-- LUMENFLOW:START -->
+
 # Universal Agent Instructions
 
-**Last updated:** {{DATE}}
+**Last updated:** {{DATE}} (5.6.0 — INIT-069 vocabulary: `--estimated-files`, `--interrupt-class`, `test-over-deletion`, `monolithic-file-contention`, `prod-migration-drift`, `db:journal-recover`, file-overlap & lane-fit preflight)
 
 > **Works with any AI coding assistant.** This file provides instructions that work regardless of which AI tool you're using -- Claude Code, Cursor, Windsurf, Cline, Codex, Aider, or any other. Just read this file and follow the workflow.
 
@@ -70,7 +72,7 @@ cd <project-root> && pnpm wu:done --id WU-XXXX
 Step 2 above is not optional:
 
 - `wu:brief` records checkpoint evidence; `wu:done` **blocks** without it for feature/bug WUs.
-- `wu:brief` also auto-loads shared memory and an Inbox Snapshot into the generated prompt (WU-1240, WU-2607) — read the `## Memory Context` section in the brief output before coding. Manual `mem:context`/`mem:inbox` calls are still available as ad-hoc lookups mid-WU.
+- `wu:brief` also auto-loads shared memory and coordination signals into the generated prompt (WU-1240, WU-2607) — read the `## Memory Context` section in the brief output before coding. Manual `mem:context`/`mem:inbox` calls are still available as ad-hoc lookups mid-WU.
 - Load relevant skills (`design-first`, `tdd-workflow`, `frontend-design`, `worktree-discipline`, `lumenflow-gates`) via your vendor's skill primitive. Claude Code, Codex, Cursor, and Windsurf all support `SKILL.md`-based skills (with minor invocation differences); Aider uses `CONVENTIONS.md`; Cline uses `.clinerules`. See [LUMENFLOW.md "Skills & Agents"](LUMENFLOW.md#skills--agents) for the invocation table, and your per-vendor rules file for specifics.
 
 ### During the WU
@@ -79,24 +81,64 @@ Capture findings in shared memory so other agents (and other vendors) can see th
 
 ```bash
 pnpm mem:create --type discovery --wu WU-XXXX --tags <csv> --priority P? --title '<prose>'
+# Pre-Phase Audits (WU-2940): omit --wu to capture findings before any WU exists.
+pnpm mem:create --type discovery --tags pre-phase-audit --title 'orchestrator finding'
 pnpm mem:signal '<short status>' --wu WU-XXXX
+# WU-2940: --interrupt-class is canonical; --interrupt remains a back-compat alias.
+pnpm mem:signal 'urgent: build break on main' --wu WU-XXXX --interrupt-class urgent
 pnpm mem:checkpoint --wu WU-XXXX --note '<progress>' --next-steps '<what is next>'
 ```
 
-### Inbox Signals Are Decision Points
-
-At `wu:brief`, after every `mem:checkpoint`, and before `wu:prep`, inspect unread coordination
-signals for your WU/session. A signal is not noise: read it, decide whether it changes or blocks the
-WU, and reply, acknowledge, or dismiss it before continuing.
-
-This convention applies to Claude Code, Codex, Cursor, Gemini CLI, and Windsurf briefs. Aider and
-Cline do not use `wu:brief` client variants, but they must follow the same polling rule through this
-onboarding guidance and their generated rules surfaces.
+For mid-flight scope correction (WU-2940), `pnpm wu:edit` accepts sizing flags
+(`--estimated-files`, `--estimated-tool-calls`, `--sizing-strategy`,
+`--sizing-exception-type`, `--sizing-exception-reason`) and allows
+non-destructive edits (`--description`, `--notes`, sizing) on in-progress WUs
+**from the main checkout** without the wu:release/wu:recover dance. Structural
+edits (`--lane`, `--code-paths` replace, `--priority`, `--type`,
+`--initiative`) still require the dance.
 
 **Classification rule:** if the fact would help _another_ agent vendor working this repo, it belongs in shared memory (`mem:create`), not your vendor's personal memory folder. Examples of shared: bug discoveries, architecture decisions, CI/gates gotchas, initiative direction, cross-WU scope flags. Examples of vendor-personal: behavioural feedback, user preferences, tool-invocation mechanics.
 
 **Shell-quoting footgun:** always **single-quote** the `--title` value. Bash expands `$var`, `$0`, backticks, and `!hist` inside double-quoted strings, silently corrupting prose containing prices (`$49`), positional refs, or exclamation marks. See [Memory section in LUMENFLOW.md](LUMENFLOW.md#memory-shared-vs-vendor-personal) for the full mem:\* contract.
 
+### Agent-to-Agent Coordination
+
+The shared memory signal layer now speaks the exported `A2A.V1` contract from
+`@lumenflow/control-plane-sdk/a2a`. Local JSONL, generated Claude hooks, and
+`mem:watch` are adapters; lumenflow.cloud uses the same contract over hosted
+tenant/workspace transport (`workspace_id` is optional locally and required in
+hosted buses).
+
+Use stable identities when a role should keep receipt state across restarts:
+
+```bash
+pnpm agent:session --agent-identity codex:implementer:init-066 --wu WU-XXXX
+pnpm mem:signal 'approve this boundary' --wu WU-XXXX --to claude:reviewer:init-066 --intent PROPOSE --requires-ack
+pnpm mem:inbox --for codex:implementer:init-066
+```
+
+Signals addressed with `--to` persist canonical `recipients[]`; legacy
+`target_agent` is only a read-compatible single-recipient alias. Receipts are
+per reader identity, so one agent reading a signal does not hide it from another
+recipient. Threads and `INFO|PROPOSE|COUNTER|AGREE|REJECT` intents make
+coordination decisions machine-readable, `requires_ack` expects a same-thread
+`AGREE` or `REJECT`, and interrupt classes are
+`advisory|priority|urgent` with `soon|immediate` accepted as compatibility
+aliases.
+
+Claude Code receives addressed `signal:received` events through generated
+`PostToolUse` hooks. Other clients should run the daemon fallback in a side
+terminal when they need active delivery:
+
+```bash
+pnpm mem:watch --session <session_id|display_name|agent_identity>
+```
+
+Before `mem:checkpoint`, `wu:prep`, or a handoff, unread directed signals are a
+decision point. Read and ACK/REJECT them before continuing, or use
+`pnpm wu:prep --allow-unread-signals --reason '<audit reason>'` only when the
+override is intentional and auditable.
+
 ### Before wu:done
 
 ```bash
@@ -107,6 +149,17 @@ pnpm mem:triage --archive mem-XXXX --reason '<why>'             # drop non-actio
 
 `wu:done` does not auto-triage. Unreviewed discoveries rot — always check the list before completing.
 
+### Database Workflow Primitives (WU-2945)
+
+```bash
+pnpm db:journal-recover            # detect drizzle journal collisions (dry-run by default)
+pnpm db:journal-recover --confirm  # apply resequence + write audit log under .lumenflow/db-recovery/
+pnpm lumenflow:setup-prereqs       # show external prereqs (e.g. Supabase CLI) — runs at end of pnpm setup
+```
+
+- `db:journal-recover` is idempotent — re-running on a healthy chain is a no-op.
+- If your project uses Supabase, install the Supabase CLI before `pnpm db:reset`.
+
 ## Quick Start (Cloud / Branch-PR)
 
 Cloud agents (Codex, Claude web, CI bots) that cannot use local worktrees use the **branch-pr** mode. This is a first-class lifecycle, not a workaround.
@@ -156,13 +209,85 @@ The completion workflow is a two-step process. Run `wu:prep` from the worktree (
 
 For detailed troubleshooting, see [troubleshooting-wu-done.md]({{DOCS_ONBOARDING_PATH}}/troubleshooting-wu-done.md).
 
+**Plan-time preflight (WU-2942):** `pnpm orchestrate:initiative` emits two extra sections after the wave breakdown:
+
+- _File-overlap preflight_ — WU pairs sharing a `code_paths` entry inside the same wave (silently serial; resolve before claim).
+- _Lane-fit suggestions_ — WUs stacked on a WIP=1 lane with concrete re-lane recommendations from `wu:infer-lane`.
+
+Read these BEFORE claiming a wave. Default mode is advisory; configure via `software_delivery.orchestrate.preflight: 'advisory' | 'strict' | 'off'` or pass `--strict-preflight` to make warnings blocking for one run. See [LUMENFLOW.md "Plan-time preflight"](LUMENFLOW.md#plan-time-preflight-wu-2942).
+
 ---
 
 ## Core Principles
 
 1. **Fit-For-Surface Verification**: Choose the least brittle verification that gives strong confidence. Prefer TDD for runtime logic when policy requires it; avoid brittle UI implementation-detail tests.
 2. **Worktree Discipline**: After `wu:claim`, work ONLY in the worktree
-3. **Gates Before Done**: Run `pnpm gates` before `wu:done`
+3. **Gates Before Done**: Run `pnpm gates` before `wu:done`. Per-gate skip
+   (`--skip-gate <name>`, repeatable) is the preferred bypass surface as of
+   WU-2925; legacy `--skip-gates` is deprecated for one minor cycle. Only gates
+   marked `skippable: true` (allow-list: `migration-verify`, `lane-health`,
+   `tdd-diff-evidence`, the WU-2927 opt-in local-prep gates `build`,
+   `integration-test`, `e2e-smoke`, the WU-2943 advisory heuristic gates
+   `test-over-deletion`, `monolithic-file-contention`, and the WU-2944
+   opt-in `prod-migration-drift` gate) or overridden via
+   `software_delivery.gates.overrides.<gate_id>.skippable=true` may be skipped.
+   Both flags require `--reason` and `--fix-wu`.
+
+   **Safety-critical gates (NEVER skippable, no override):** `format`, `lint`,
+   `typecheck`, `co-change`, `spec:linter`, `claim-validation`,
+   `unread-directed-signal`, `invariants`, `safety-critical-test`. To narrow
+   their reach without flipping the default, set
+   `software_delivery.gates.overrides.<gate_id>.applicability_paths` to a
+   glob list — never flip `skippable` on these.
+
+   **`GateResult` state legend (WU-2926).** Each gate produces one of six
+   discriminated `GateResult` states with stable glyphs:
+   - `passed` ✅ — gate ran successfully
+   - `failed` ❌ — gate ran and failed (or applicable + missing + skippable + `'fail'`)
+   - `skipped-by-agent` ⏭ — explicit `--skip-gate <name>` (audit `source: 'agent'`)
+   - `skipped-auto-not-applicable` ⊘ — gate doesn't apply to this change set
+   - `skipped-auto-missing-prereq` ⊘ — applicable + missing prereq + skippable + auto-skip
+   - `blocked-missing-prereq` 🚫 — applicable + missing prereq + `skippable: false`
+     (silent-bypass guard; exits non-zero, cannot be `--skip-gate`'d). Override
+     per-repo via `software_delivery.gates.overrides.<gate_id>.skippable=true`
+     only when the missing prerequisite is genuinely environmental.
+
+   Auto-skip + blocked states write audit NDJSON with the discriminated
+   `source` field; CFR only counts `source: 'agent'` rows. Public reference:
+   [Gates Reference](https://lumenflow.dev/reference/gates).
+
+   **Local-prep profile (WU-2927).** The opt-in
+   `software_delivery.gates.local_prep` profile extends `wu:prep` with
+   `build`, `integration-test`, and `e2e-smoke` gates that previously only ran
+   in CI. All three are `skippable: true` and on the per-gate skip allow-list.
+   See [LUMENFLOW.md gates section](LUMENFLOW.md#extended-local-prep-profile-wu-2927)
+   for the schema and latency budget.
+
+   **Heuristic guard gates (WU-2943).** Two advisory gates run on every
+   `wu:prep`, both `skippable: true` (allow-listed) with
+   `prereq_strategy: 'auto-skip'`:
+   - `test-over-deletion` — flags deleted `.test.ts(x)` whose `describe()` /
+     `describe.each()` strings reference symbols outside the current WU's
+     `code_paths` (scope-creep deletion).
+   - `monolithic-file-contention` — flags files appearing in 2+ active WUs'
+     `code_paths` (statuses `in_progress` + `ready`) when the current WU is
+     one of the claimants. Output names the file, the contending WUs, and
+     suggests splitting the module to enable parallelism.
+
+   Both auto-skip cleanly when the heuristic does not fire. Per-repo override
+   to BLOCK on trigger:
+   `pnpm config:set software_delivery.gates.overrides.<gate>.skippable=false`.
+
+   **Prod-migration-drift gate (WU-2944).** Optional CI-scheduled gate that
+   detects when the production database is N+ migrations behind the canonical
+   `migrations/` directory on main. Auto-skips `not-applicable` until the
+   repo opts in by setting
+   `software_delivery.gates.overrides.prod-migration-drift.connection_string_env_var`
+   (e.g. `PROD_DATABASE_URL`). Requires the configured env var to be set and
+   the prod DB to be reachable; otherwise auto-skips under
+   `prereq_strategy: 'auto-skip'`. Threshold is configurable
+   (`overrides.prod-migration-drift.threshold`, default 5).
+
 4. **Never Bypass Hooks**: No `--no-verify`
 5. **Vendor-Agnostic Dirty-Main Guard**: `wu:prep` and `wu:done` hard-block when main has non-allowlisted dirty files during worktree WUs (including MCP/tool-originated writes). `branch-pr` mode is exempt.
 6. **Docs Parity For Behavior Changes**: If you change LumenFlow behavior or workflow guidance, update internal docs, Starlight docs, or both as appropriate. Generated reference docs do not cover narrative behavior changes by themselves.
@@ -208,6 +333,13 @@ LumenFlow enforces safety at the repository level via git wrappers and hooks. Fo
 
 **Key rule:** Always use `wu:` commands for worktree and branch management -- never raw `git worktree` or `git branch -D` commands. Use `wu:recover` for state inconsistencies, `wu:release` for abandoned WUs, and `wu:prune` for stale worktrees.
 
+**WU-2941:** `wu:release` resets both the YAML status and the lane branch
+(default: delete branch locally + on `origin`). Pass `--keep-branch` to retain
+the branch for diagnostic recovery, or set
+`software_delivery.wu_release.branch_action: 'keep'` in `workspace.yaml` for
+air-gapped/offline repos. `wu:status` surfaces residual main↔worktree drift
+inline with a `Run pnpm wu:recover --id WU-X --action reset` hint.
+
 ---
 
 ## Vendor-Specific Overlays
@@ -215,21 +347,23 @@ LumenFlow enforces safety at the repository level via git wrappers and hooks. Fo
 This file provides universal guidance for all AI agents. LumenFlow skills live in `.lumenflow/skills/` as `SKILL.md` files and are projected to each vendor via `pnpm lumenflow:integrate --client <x>`.
 
 Agent plugins are a discovery and invocation on-ramp, not a replacement for repo-level LumenFlow
-integration. If a plugin is installed alongside standalone projections, use the surface-specific
-name: standalone skills keep local names such as `design-first`, Claude plugin skills use names such
-as `/lumenflow:design-first`, and Codex plugin use should select the installed `lumenflow` plugin or
-bundled skill through Codex's `@` plugin selection surface. Plugin installation must not delete
-`.claude/skills/` or `.agents/skills/`, and governed repo enforcement still requires
-`npx lumenflow init`, `pnpm lumenflow:integrate`, or `pnpm lumenflow:integrate --sync`.
-
-| Vendor       | Skill / rules surface                               | Invocation                                                             |
-| ------------ | --------------------------------------------------- | ---------------------------------------------------------------------- |
-| Claude Code  | `.claude/skills/` + `.claude/CLAUDE.md`             | `Skill` tool call, or `/skill <name>` in interactive CLI               |
+integration. **Plugin packaging is scoped under INIT-065 and not yet shipped as of 5.4.0** — the
+guidance below applies once the packaging WUs land. If a plugin is installed alongside standalone
+projections, use the surface-specific name: standalone skills keep local names such as
+`design-first`, Claude plugin skills use names such as `/lumenflow:design-first`, and Codex plugin
+use should select the installed `lumenflow` plugin or bundled skill through Codex's `@` plugin
+selection surface. Plugin installation must not delete `.claude/skills/` or `.agents/skills/`, and
+governed repo enforcement still requires `npx lumenflow init`, `pnpm lumenflow:integrate`, or
+`pnpm lumenflow:integrate --sync`.
+
+| Vendor       | Skill / rules surface                              | Invocation                                                             |
+| ------------ | -------------------------------------------------- | ---------------------------------------------------------------------- |
+| Claude Code  | `.claude/skills/` + `.claude/CLAUDE.md`            | `Skill` tool call, or `/skill <name>` in interactive CLI               |
 | OpenAI Codex | `AGENTS.md` + `.agents/skills/` + `.codex/agents/` | `/skills`, `$<name>` mention, implicit skills, explicit subagent usage |
-| Cursor       | `.cursor/rules/` + `.agents/skills/`                | `/skills` or auto-discovery                                            |
-| Windsurf     | `.windsurf/rules/` + `.agents/skills/`              | Auto-discovery; workflows via `/<workflow-name>`                       |
-| Aider        | `CONVENTIONS.md`                                    | `/read CONVENTIONS.md` or `aider --read CONVENTIONS.md`                |
-| Cline        | `.clinerules`                                       | Auto-loaded                                                            |
+| Cursor       | `.cursor/rules/` + `.agents/skills/`               | `/skills` or auto-discovery                                            |
+| Windsurf     | `.windsurf/rules/` + `.agents/skills/`             | Auto-discovery; workflows via `/<workflow-name>`                       |
+| Aider        | `CONVENTIONS.md`                                   | `/read CONVENTIONS.md` or `aider --read CONVENTIONS.md`                |
+| Cline        | `.clinerules`                                      | Auto-loaded                                                            |
 
 Shared cross-vendor surfaces: `AGENTS.md` and `.agents/skills/`.
 Vendor-specific overlays: `.claude/agents/`, `.codex/agents/`, `.cursor/rules/`, and `.windsurf/rules/`.
@@ -333,3 +467,5 @@ pnpm wu:brief --id WU-XXX --client codex-cli
 
 Recovery files contain your last checkpoint, acceptance criteria, code paths, and changed files.
 Always save checkpoints before long operations: `pnpm mem:checkpoint "progress note" --wu WU-XXX`
+
+<!-- LUMENFLOW:END -->