@lumenflow/cli 3.8.6 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/README.md +11 -15
  2. package/dist/cli-entry-point.js +7 -0
  3. package/dist/cli-entry-point.js.map +1 -1
  4. package/dist/gate-defaults.js +5 -0
  5. package/dist/gate-defaults.js.map +1 -1
  6. package/dist/gates-runners.js +77 -1
  7. package/dist/gates-runners.js.map +1 -1
  8. package/dist/guard-main-branch.js +3 -2
  9. package/dist/guard-main-branch.js.map +1 -1
  10. package/dist/hooks/enforcement-checks.js +3 -2
  11. package/dist/hooks/enforcement-checks.js.map +1 -1
  12. package/dist/hooks/path-utils.js +2 -1
  13. package/dist/hooks/path-utils.js.map +1 -1
  14. package/dist/init-detection.js +3 -3
  15. package/dist/init-detection.js.map +1 -1
  16. package/dist/lane-create.js +223 -0
  17. package/dist/lane-create.js.map +1 -0
  18. package/dist/mem-signal.js +1 -1
  19. package/dist/mem-signal.js.map +1 -1
  20. package/dist/public-manifest.js +7 -0
  21. package/dist/public-manifest.js.map +1 -1
  22. package/dist/signal-middleware.js +192 -0
  23. package/dist/signal-middleware.js.map +1 -0
  24. package/dist/state-doctor.js +135 -0
  25. package/dist/state-doctor.js.map +1 -1
  26. package/dist/state-emit.js +72 -10
  27. package/dist/state-emit.js.map +1 -1
  28. package/dist/validate.js +2 -2
  29. package/dist/validate.js.map +1 -1
  30. package/dist/wu-claim.js +75 -10
  31. package/dist/wu-claim.js.map +1 -1
  32. package/dist/wu-done-already-merged.js +2 -7
  33. package/dist/wu-done-already-merged.js.map +1 -1
  34. package/dist/wu-done-gates.js +296 -0
  35. package/dist/wu-done-gates.js.map +1 -0
  36. package/dist/wu-done-memory-telemetry.js +145 -0
  37. package/dist/wu-done-memory-telemetry.js.map +1 -0
  38. package/dist/wu-done-mode-execution.js +136 -0
  39. package/dist/wu-done-mode-execution.js.map +1 -0
  40. package/dist/wu-done-policies.js +206 -1
  41. package/dist/wu-done-policies.js.map +1 -1
  42. package/dist/wu-done-preflight.js +207 -0
  43. package/dist/wu-done-preflight.js.map +1 -0
  44. package/dist/wu-done.js +48 -888
  45. package/dist/wu-done.js.map +1 -1
  46. package/dist/wu-edit-validators.js +30 -1
  47. package/dist/wu-edit-validators.js.map +1 -1
  48. package/dist/wu-edit.js +7 -2
  49. package/dist/wu-edit.js.map +1 -1
  50. package/dist/wu-prep.js +17 -1
  51. package/dist/wu-prep.js.map +1 -1
  52. package/dist/wu-spawn-prompt-builders.js +65 -10
  53. package/dist/wu-spawn-prompt-builders.js.map +1 -1
  54. package/package.json +9 -8
  55. package/packs/sidekick/.turbo/turbo-build.log +1 -1
  56. package/packs/sidekick/package.json +1 -1
  57. package/packs/software-delivery/.turbo/turbo-build.log +1 -1
  58. package/packs/software-delivery/package.json +1 -1
  59. package/templates/core/.lumenflow/constraints.md.template +12 -14
  60. package/templates/core/LUMENFLOW.md.template +7 -4
  61. package/templates/core/ai/onboarding/agent-invocation-guide.md.template +2 -2
  62. package/templates/core/ai/onboarding/docs-generation.md.template +1 -1
  63. package/templates/core/ai/onboarding/first-wu-mistakes.md.template +40 -0
  64. package/templates/core/ai/onboarding/initiative-orchestration.md.template +402 -0
  65. package/templates/core/ai/onboarding/quick-ref-commands.md.template +129 -56
  66. package/templates/core/ai/onboarding/release-process.md.template +102 -39
  67. package/templates/core/ai/onboarding/starting-prompt.md.template +1 -0
  68. package/templates/core/ai/onboarding/test-ratchet.md.template +2 -8
  69. package/templates/vendors/claude/.claude/CLAUDE.md.template +1 -1
  70. package/templates/vendors/claude/.claude/skills/bug-classification/SKILL.md.template +2 -2
  71. package/templates/vendors/claude/.claude/skills/code-quality/SKILL.md.template +3 -3
  72. package/templates/vendors/claude/.claude/skills/context-management/SKILL.md.template +1 -1
  73. package/templates/vendors/claude/.claude/skills/frontend-design/SKILL.md.template +1 -1
  74. package/templates/vendors/claude/.claude/skills/lumenflow-gates/SKILL.md.template +4 -4
  75. package/templates/vendors/claude/.claude/skills/tdd-workflow/SKILL.md.template +4 -4
  76. package/templates/vendors/claude/.claude/skills/worktree-discipline/SKILL.md.template +5 -5
  77. package/templates/vendors/claude/.claude/skills/wu-lifecycle/SKILL.md.template +4 -4
  78. package/templates/vendors/cline/.clinerules.template +1 -1
  79. package/templates/vendors/cursor/.cursor/rules/lumenflow.md.template +22 -2
  80. package/templates/vendors/windsurf/.windsurf/rules/lumenflow.md.template +22 -2
@@ -2,8 +2,8 @@
2
2
  name: worktree-discipline
3
3
  description: Prevents the "absolute path trap" in Write/Edit/Read tools. Use when working in worktrees, before file operations, or when changes don't appear in git status.
4
4
  version: 2.0.0
5
- source: docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md
6
- source_sections: §2.4 (Worktree Discipline), §4.1 (Tool Usage)
5
+ source: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
6
+ source_sections: Worktree Discipline, Tool Usage
7
7
  last_updated: {{DATE}}
8
8
  allowed-tools: Read, Bash, Grep
9
9
  ---
@@ -12,7 +12,7 @@ allowed-tools: Read, Bash, Grep
12
12
 
13
13
  **Purpose**: Prevent AI agents from bypassing worktree isolation via absolute file paths.
14
14
 
15
- **For full worktree workflow**: See `wu-lifecycle` skill or `lumenflow-complete.md` §2.4.
15
+ **For full worktree workflow**: See `wu-lifecycle` skill or `lumenflow-agent-capsule.md`.
16
16
 
17
17
  ## The Absolute Path Trap
18
18
 
@@ -134,9 +134,9 @@ About to use Write/Edit/Read?
134
134
  ## Cross-References
135
135
 
136
136
  - **Full worktree workflow**: `wu-lifecycle` skill
137
- - **Git command restrictions**: `lumenflow-complete.md` §2.4
137
+ - **Git command restrictions**: `lumenflow-agent-capsule.md`
138
138
 
139
139
  ## Version History
140
140
 
141
141
  - **v2.0.0** ({{DATE}}): Refactored to focus on absolute path trap (per Anthropic one-capability-per-skill guideline)
142
- - **v1.0.0** ({{DATE}}): Initial skill from lumenflow-complete.md
142
+ - **v1.0.0** ({{DATE}}): Initial skill from lumenflow-agent-capsule.md
@@ -2,15 +2,15 @@
2
2
  name: wu-lifecycle
3
3
  description: Work Unit claim/block/done workflow automation. Use when claiming WUs, blocking/unblocking, running wu:prep + wu:done, or understanding WU state transitions.
4
4
  version: 2.2.0
5
- source: docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md
6
- source_sections: §2.4, §6 (WU Lifecycle)
5
+ source: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
6
+ source_sections: WU Lifecycle
7
7
  last_updated: {{DATE}}
8
8
  allowed-tools: Read, Bash, Grep
9
9
  ---
10
10
 
11
11
  # WU Lifecycle Skill
12
12
 
13
- **Source**: `docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md` §2.4, §6 (canonical)
13
+ **Source**: `docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
14
14
 
15
15
  ## When to Use
16
16
 
@@ -116,4 +116,4 @@ pnpm wu:done --id WU-XXX --skip-gates --reason "Pre-existing" --fix-wu WU-YYY
116
116
 
117
117
  ---
118
118
 
119
- **Full spec**: [lumenflow-complete.md](../../../docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md)
119
+ **Full spec**: [LumenFlow Agent Capsule](../../../docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md)
@@ -31,7 +31,7 @@ cd {{PROJECT_ROOT}}
31
31
  pnpm wu:done --id WU-XXX
32
32
  ```
33
33
 
34
- > **Complete CLI reference (60+ commands):** See [quick-ref-commands.md](ai/onboarding/quick-ref-commands.md)
34
+ > **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](ai/onboarding/quick-ref-commands.md)
35
35
 
36
36
  ---
37
37
 
@@ -31,7 +31,7 @@ cd {{PROJECT_ROOT}}
31
31
  pnpm wu:done --id WU-XXX
32
32
  ```
33
33
 
34
- > **Complete CLI reference (60+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
34
+ > **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
35
35
 
36
36
  ## CLI Commands
37
37
 
@@ -43,7 +43,7 @@ pnpm wu:done --id WU-XXX
43
43
  | `pnpm wu:claim --id WU-XXX --lane <Lane>` | Claim WU and create worktree |
44
44
  | `pnpm wu:prep --id WU-XXX` | Run gates in worktree |
45
45
  | `pnpm wu:done --id WU-XXX` | Complete WU (from main) |
46
- | `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt (no execution) |
46
+ | `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt + record evidence |
47
47
  | `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
48
48
  | `pnpm wu:recover --id WU-XXX` | Fix WU state inconsistencies |
49
49
  | `pnpm wu:escalate --id WU-XXX` | Show or resolve WU escalation status |
@@ -57,3 +57,23 @@ pnpm wu:done --id WU-XXX
57
57
  | `pnpm lumenflow:commands` | List all public commands (primary + alias + legacy) |
58
58
  | `pnpm mem:checkpoint --wu WU-XXX` | Save progress checkpoint |
59
59
  | `pnpm mem:recover --wu WU-XXX` | Generate recovery context |
60
+
61
+ ---
62
+
63
+ ## Workflow Summary
64
+
65
+ | Step | Command |
66
+ | ------------ | ---------------------------------------------------------------- |
67
+ | 1. Create WU | `pnpm wu:create --lane <Lane> --title "..."` (ID auto-generated) |
68
+ | 2. Claim | `pnpm wu:claim --id WU-XXX --lane <Lane>` |
69
+ | 3. Work | `cd worktrees/<lane>-wu-xxx` |
70
+ | 4. Gates | `pnpm gates` |
71
+ | 5. Prep | `pnpm wu:prep --id WU-XXX` |
72
+ | 6. Complete | `pnpm wu:done --id WU-XXX` |
73
+
74
+ ## Safety Reminders
75
+
76
+ - **Worktree Discipline**: After claiming a WU, immediately `cd` to the worktree
77
+ - **Main is read-only**: Do not edit files in the main checkout after claiming
78
+ - **Gates before done**: Always run `pnpm gates` before `wu:done`
79
+ - **Never skip hooks**: The `--no-verify` flag is forbidden
@@ -31,7 +31,7 @@ cd {{PROJECT_ROOT}}
31
31
  pnpm wu:done --id WU-XXX
32
32
  ```
33
33
 
34
- > **Complete CLI reference (60+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
34
+ > **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
35
35
 
36
36
  ## CLI Commands
37
37
 
@@ -43,7 +43,7 @@ pnpm wu:done --id WU-XXX
43
43
  | `pnpm wu:claim --id WU-XXX --lane <Lane>` | Claim WU and create worktree |
44
44
  | `pnpm wu:prep --id WU-XXX` | Run gates in worktree |
45
45
  | `pnpm wu:done --id WU-XXX` | Complete WU (from main) |
46
- | `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt (no execution) |
46
+ | `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt + record evidence |
47
47
  | `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
48
48
  | `pnpm wu:recover --id WU-XXX` | Fix WU state inconsistencies |
49
49
  | `pnpm wu:escalate --id WU-XXX` | Show or resolve WU escalation status |
@@ -57,3 +57,23 @@ pnpm wu:done --id WU-XXX
57
57
  | `pnpm lumenflow:commands` | List all public commands (primary + alias + legacy) |
58
58
  | `pnpm mem:checkpoint --wu WU-XXX` | Save progress checkpoint |
59
59
  | `pnpm mem:recover --wu WU-XXX` | Generate recovery context |
60
+
61
+ ---
62
+
63
+ ## Workflow Summary
64
+
65
+ | Step | Command |
66
+ | ------------ | ---------------------------------------------------------------- |
67
+ | 1. Create WU | `pnpm wu:create --lane <Lane> --title "..."` (ID auto-generated) |
68
+ | 2. Claim | `pnpm wu:claim --id WU-XXX --lane <Lane>` |
69
+ | 3. Work | `cd worktrees/<lane>-wu-xxx` |
70
+ | 4. Gates | `pnpm gates` |
71
+ | 5. Prep | `pnpm wu:prep --id WU-XXX` |
72
+ | 6. Complete | `pnpm wu:done --id WU-XXX` |
73
+
74
+ ## Safety Reminders
75
+
76
+ - **Worktree Discipline**: After claiming a WU, immediately `cd` to the worktree
77
+ - **Main is read-only**: Do not edit files in the main checkout after claiming
78
+ - **Gates before done**: Always run `pnpm gates` before `wu:done`
79
+ - **Never skip hooks**: The `--no-verify` flag is forbidden