@lumenflow/cli 3.12.8 → 3.12.10

package/packs/sidekick/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-sidekick@3.12.8 build /home/runner/work/lumenflow-dev/lumenflow-dev/packages/@lumenflow/packs/sidekick
+> @lumenflow/packs-sidekick@3.12.10 build /home/runner/work/lumenflow-dev/lumenflow-dev/packages/@lumenflow/packs/sidekick
 > tsc
 

package/packs/sidekick/package.json

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

package/packs/software-delivery/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-software-delivery@3.12.8 build /home/runner/work/lumenflow-dev/lumenflow-dev/packages/@lumenflow/packs/software-delivery
+> @lumenflow/packs-software-delivery@3.12.10 build /home/runner/work/lumenflow-dev/lumenflow-dev/packages/@lumenflow/packs/software-delivery
 > tsc
 

package/packs/software-delivery/package.json

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

package/templates/core/ai/onboarding/quick-ref-commands.md.template

@@ -158,6 +158,7 @@ automatically, and `.lumenflow/templates/` remains optional unless you want cust
 | -------------------------------- | ---------------------------------------- |
 | `pnpm wu:validate --id WU-XXX`   | Validate WU spec                         |
 | `pnpm wu:preflight --id WU-XXX`  | Pre-flight checks before wu:done         |
+| `pnpm wu:verify --id WU-XXX`    | Verify WU completion (stamp, commit, clean tree) |
 | `pnpm wu:recover --id WU-XXX`    | Analyze and fix WU state inconsistencies |
 | `pnpm wu:repair --id WU-XXX`     | Repair WU state issues                   |
 | `pnpm wu:prune`                  | Clean stale worktrees                    |
@@ -193,8 +194,10 @@ automatically, and `.lumenflow/templates/` remains optional unless you want cust
 ¹ **Script aliases:** `spec:linter` and `tasks:validate` are pnpm script aliases
 for `wu:validate --all`. They are not standalone CLI commands.
 
-Before rerunning `wu:prep` after docs-heavy edits, format touched docs first:
-`pnpm prettier --write <changed-doc-paths...>`.
+**Formatting: always scope to changed files only.**
+Use `pnpm prettier --write <changed-files...>` — never unscoped `pnpm format`.
+Running `pnpm format` reformats every file in the repo, creating hundreds of
+dirty YAML/initiative changes that pollute the worktree and block `wu:done`.
 
 ---
 
@@ -330,8 +333,9 @@ stub in `$LUMENFLOW_HOME/plans/` and automatically set the WU's `plan` field to
 | `pnpm plan:edit --id INIT-XXX --section Goal --content "..."`            | Edit a section in a plan file                                       |
 | `pnpm plan:link --id INIT-XXX --plan lumenflow://plans/INIT-XXX-plan.md` | Link plan URI to initiative or WU                                   |
 | `pnpm plan:promote --id INIT-XXX`                                        | Promote plan status to approved                                     |
-| `pnpm initiative:plan --initiative INIT-XXX --plan <path>`               | Legacy-compatible initiative linking command                        |
-| `pnpm initiative:plan --initiative INIT-XXX --create`                    | Legacy-compatible create-and-link flow                              |
+| `pnpm initiative:plan --initiative INIT-XXX --plan <path>`               | Link plan to initiative (auto-imports external files into repo)     |
+| `pnpm initiative:plan --initiative INIT-XXX --create`                    | Create blank plan template and link to initiative                   |
+| `pnpm initiative:plan --initiative INIT-XXX --create --plan <path>`      | Import external plan content into new template and link             |
 
 ### Linking Plans
 
@@ -348,14 +352,21 @@ pnpm plan:create --id INIT-001 --title "Auth System Rollout" --from ~/.claude/pl
 pnpm plan:link --id INIT-001 --plan lumenflow://plans/INIT-001-plan.md
 ```
 
-**Legacy-compatible initiative command:**
+**initiative:plan command (supports external import):**
 
 ```bash
-# Create a new plan template
-pnpm initiative:plan --initiative INIT-001 --create
+# Import an external plan (e.g. from ~/.claude/plans/) and link to initiative
+# The file is copied into the repo's configured plansDir automatically
+pnpm initiative:plan --initiative INIT-001 --plan ~/.claude/plans/my-plan.md
 
-# Link an existing plan file
+# Link an existing repo plan file
 pnpm initiative:plan --initiative INIT-001 --plan docs/plans/my-plan.md
+
+# Create a blank plan template and link
+pnpm initiative:plan --initiative INIT-001 --create
+
+# Import external file content into a new initiative plan file
+pnpm initiative:plan --initiative INIT-001 --create --plan ~/.claude/plans/my-plan.md
 ```
 
 **To a WU (via `plan` field, WU-1683):**

package/templates/core/ai/onboarding/starting-prompt.md.template

@@ -561,6 +561,7 @@ Domain-specific commands must come from local configuration, not core framework
 | `pnpm wu:cleanup --id WU-XXX`                  | Post-merge cleanup (branch-pr)                  | After PR merge (cloud only) |
 | `pnpm wu:escalate --id WU-XXX`                 | Show or resolve escalation status               | Escalation-triggered WUs    |
 | `pnpm wu:escalate --resolve --id WU-XXX`       | Resolve human escalation                        | Before wu:done (escalation) |
+| `pnpm wu:verify --id WU-XXX`                   | Verify WU completion (stamp, commit, clean tree) | After wu:done               |
 | `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup                      | Cancel stale/throwaway WUs  |
 | `pnpm wu:recover --id WU-XXX`                  | Fix inconsistent WU state                       | When state is broken        |
 

package/templates/vendors/claude/.claude/skills/lumenflow-gates/SKILL.md.template

@@ -33,12 +33,17 @@ pnpm gates = format:check → lint → typecheck → spec:linter → tests
 
 ## Fix Patterns
 
-| Gate      | Auto-fix        | Manual                              |
-| --------- | --------------- | ----------------------------------- |
-| Format    | `pnpm format`   | -                                   |
-| Lint      | `pnpm lint:fix` | Fix reported issues                 |
-| Typecheck | -               | Fix type errors (first error first) |
-| Tests     | -               | Debug, fix mocks, update snapshots  |
+| Gate      | Auto-fix                                   | Manual                              |
+| --------- | ------------------------------------------ | ----------------------------------- |
+| Format    | `pnpm prettier --write <changed-files...>` | -                                   |
+| Lint      | `pnpm lint:fix`                            | Fix reported issues                 |
+| Typecheck | -                                          | Fix type errors (first error first) |
+| Tests     | -                                          | Debug, fix mocks, update snapshots  |
+
+> **NEVER run `pnpm format` (unscoped).** It reformats every file in the repo,
+> creating hundreds of dirty changes that pollute your worktree. Always scope
+> formatting to your changed files only:
+> `pnpm prettier --write src/my-file.ts src/other-file.ts`
 
 ## Decision Tree
 

package/templates/vendors/cursor/.cursor/rules/lumenflow.md.template

@@ -47,6 +47,7 @@ pnpm wu:done --id WU-XXX
 | `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
 | `pnpm wu:recover --id WU-XXX`                  | Fix WU state inconsistencies                |
 | `pnpm wu:escalate --id WU-XXX`                 | Show or resolve WU escalation status        |
+| `pnpm wu:verify --id WU-XXX`                   | Verify WU completion (stamp, commit, clean tree) |
 | `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup                  |
 
 ### Gates & Orchestration

package/templates/vendors/windsurf/.windsurf/rules/lumenflow.md.template

@@ -47,6 +47,7 @@ pnpm wu:done --id WU-XXX
 | `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
 | `pnpm wu:recover --id WU-XXX`                  | Fix WU state inconsistencies                |
 | `pnpm wu:escalate --id WU-XXX`                 | Show or resolve WU escalation status        |
+| `pnpm wu:verify --id WU-XXX`                   | Verify WU completion (stamp, commit, clean tree) |
 | `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup                  |
 
 ### Gates & Orchestration