@lumenflow/cli 3.22.0 → 4.0.1

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 (136) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +1 -1
  3. package/dist/task-claim.js +1 -1
  4. package/dist/task-claim.js.map +1 -1
  5. package/dist/wu-cleanup.js +18 -2
  6. package/dist/wu-cleanup.js.map +1 -1
  7. package/dist/wu-done-gates.js +67 -12
  8. package/dist/wu-done-gates.js.map +1 -1
  9. package/dist/wu-done-preflight.js +4 -3
  10. package/dist/wu-done-preflight.js.map +1 -1
  11. package/dist/wu-done.js +1 -1
  12. package/dist/wu-done.js.map +1 -1
  13. package/dist/wu-prep.js +13 -3
  14. package/dist/wu-prep.js.map +1 -1
  15. package/dist/wu-recover.js +13 -0
  16. package/dist/wu-recover.js.map +1 -1
  17. package/dist/wu-release.js +1 -0
  18. package/dist/wu-release.js.map +1 -1
  19. package/dist/wu-state-mutation-ownership.js +11 -1
  20. package/dist/wu-state-mutation-ownership.js.map +1 -1
  21. package/dist/wu-verify.js +1 -1
  22. package/package.json +12 -12
  23. package/packs/agent-runtime/.turbo/turbo-build.log +1 -1
  24. package/packs/agent-runtime/package.json +5 -5
  25. package/packs/sidekick/.turbo/turbo-build.log +1 -1
  26. package/packs/sidekick/package.json +5 -5
  27. package/packs/software-delivery/.turbo/turbo-build.log +1 -1
  28. package/packs/software-delivery/LICENSE.md +18 -0
  29. package/packs/software-delivery/README.md +15 -0
  30. package/packs/software-delivery/package.json +5 -5
  31. package/templates/core/AGENTS.md.template +1 -24
  32. package/templates/core/LUMENFLOW.md.template +188 -34
  33. package/templates/core/UPGRADING.md.template +2 -2
  34. package/templates/core/ai/onboarding/release-process.md.template +13 -13
  35. package/dist/chunk-2D2VOCA4.js +0 -37
  36. package/dist/chunk-2D5KFYGX.js +0 -284
  37. package/dist/chunk-2GXVIN57.js +0 -14072
  38. package/dist/chunk-2MQ7HZWZ.js +0 -26
  39. package/dist/chunk-2UFQ3A3C.js +0 -643
  40. package/dist/chunk-3RG5ZIWI.js +0 -10
  41. package/dist/chunk-4N74J3UT.js +0 -15
  42. package/dist/chunk-5GTOXFYR.js +0 -392
  43. package/dist/chunk-5VY6MQMC.js +0 -240
  44. package/dist/chunk-67XVPMRY.js +0 -1297
  45. package/dist/chunk-6HO4GWJE.js +0 -164
  46. package/dist/chunk-6W5XHWYV.js +0 -1890
  47. package/dist/chunk-6X4EMYJQ.js +0 -64
  48. package/dist/chunk-6XYXI2NQ.js +0 -772
  49. package/dist/chunk-7ANSOV6Q.js +0 -285
  50. package/dist/chunk-A624LFLB.js +0 -1380
  51. package/dist/chunk-ADN5NHG4.js +0 -126
  52. package/dist/chunk-B7YJYJKG.js +0 -33
  53. package/dist/chunk-CCLHCPKG.js +0 -210
  54. package/dist/chunk-CK36VROC.js +0 -1584
  55. package/dist/chunk-D3UOFRSB.js +0 -81
  56. package/dist/chunk-DFR4DJBM.js +0 -230
  57. package/dist/chunk-DSYBDHYH.js +0 -79
  58. package/dist/chunk-DWMLTXKQ.js +0 -1176
  59. package/dist/chunk-E3REJTAJ.js +0 -28
  60. package/dist/chunk-EA3IVO64.js +0 -633
  61. package/dist/chunk-EK2AKZKD.js +0 -55
  62. package/dist/chunk-ELD7JTTT.js +0 -343
  63. package/dist/chunk-EX6TT2XI.js +0 -195
  64. package/dist/chunk-EXINSFZE.js +0 -82
  65. package/dist/chunk-EZ6ZBYBM.js +0 -510
  66. package/dist/chunk-FBKAPTJ2.js +0 -16
  67. package/dist/chunk-FVLV5RYH.js +0 -1118
  68. package/dist/chunk-GDNSBQVK.js +0 -2485
  69. package/dist/chunk-GPQHMBNN.js +0 -278
  70. package/dist/chunk-GTFJB67L.js +0 -68
  71. package/dist/chunk-HANJXVKW.js +0 -1127
  72. package/dist/chunk-HEVS5YLD.js +0 -269
  73. package/dist/chunk-HMEVZKPQ.js +0 -9
  74. package/dist/chunk-HRGSYNLM.js +0 -3511
  75. package/dist/chunk-ISZR5N4K.js +0 -60
  76. package/dist/chunk-J6SUPR2C.js +0 -226
  77. package/dist/chunk-JERYVEIZ.js +0 -244
  78. package/dist/chunk-JHHWGL2N.js +0 -87
  79. package/dist/chunk-JONWQUB5.js +0 -775
  80. package/dist/chunk-K2DIWWDM.js +0 -1766
  81. package/dist/chunk-KY4PGL5V.js +0 -969
  82. package/dist/chunk-L737LQ4C.js +0 -1285
  83. package/dist/chunk-LFTWYIB2.js +0 -497
  84. package/dist/chunk-LV47RFNJ.js +0 -41
  85. package/dist/chunk-MKSAITI7.js +0 -15
  86. package/dist/chunk-MZ7RKIX4.js +0 -212
  87. package/dist/chunk-NAP6CFSO.js +0 -84
  88. package/dist/chunk-ND6MY37M.js +0 -16
  89. package/dist/chunk-NMG736UR.js +0 -683
  90. package/dist/chunk-NRAXROED.js +0 -32
  91. package/dist/chunk-NRIZR3A7.js +0 -690
  92. package/dist/chunk-NX43BG3M.js +0 -233
  93. package/dist/chunk-O645XLSI.js +0 -297
  94. package/dist/chunk-OMJD6A3S.js +0 -235
  95. package/dist/chunk-QB6SJD4T.js +0 -430
  96. package/dist/chunk-QFSTL4J3.js +0 -276
  97. package/dist/chunk-QLGDFMFX.js +0 -212
  98. package/dist/chunk-RIAAGL2E.js +0 -13
  99. package/dist/chunk-RWO5XMZ6.js +0 -86
  100. package/dist/chunk-RXRKBBSM.js +0 -149
  101. package/dist/chunk-RZOZMML6.js +0 -363
  102. package/dist/chunk-U7I7FS7T.js +0 -113
  103. package/dist/chunk-UI42RODY.js +0 -717
  104. package/dist/chunk-UTVMVSCO.js +0 -519
  105. package/dist/chunk-V6OJGLBA.js +0 -1746
  106. package/dist/chunk-W2JHVH7D.js +0 -152
  107. package/dist/chunk-WD3Y7VQN.js +0 -280
  108. package/dist/chunk-WOCTQ5MS.js +0 -303
  109. package/dist/chunk-WZR3ZUNN.js +0 -696
  110. package/dist/chunk-XGI665H7.js +0 -150
  111. package/dist/chunk-XKY65P2T.js +0 -304
  112. package/dist/chunk-Y4CQZY65.js +0 -57
  113. package/dist/chunk-YFEXKLVE.js +0 -194
  114. package/dist/chunk-YHO3HS5X.js +0 -287
  115. package/dist/chunk-YLS7AZSX.js +0 -738
  116. package/dist/chunk-ZE473AO6.js +0 -49
  117. package/dist/chunk-ZF747T3O.js +0 -644
  118. package/dist/chunk-ZHCZHZH3.js +0 -43
  119. package/dist/chunk-ZZNZX2XY.js +0 -87
  120. package/dist/constants-7QAP3VQ4.js +0 -23
  121. package/dist/dist-IY3UUMWK.js +0 -33
  122. package/dist/invariants-runner-W5RGHCSU.js +0 -27
  123. package/dist/lane-lock-6J36HD5O.js +0 -35
  124. package/dist/mem-checkpoint-core-EANG2GVN.js +0 -14
  125. package/dist/mem-signal-core-2LZ2WYHW.js +0 -19
  126. package/dist/memory-store-OLB5FO7K.js +0 -18
  127. package/dist/service-6BYCOCO5.js +0 -13
  128. package/dist/spawn-policy-resolver-NTSZYQ6R.js +0 -17
  129. package/dist/spawn-task-builder-R4E2BHSW.js +0 -22
  130. package/dist/wu-done-pr-WLFFFEPJ.js +0 -25
  131. package/dist/wu-done-validation-3J5E36FE.js +0 -30
  132. package/dist/wu-duplicate-id-detector-5S7JHELK.js +0 -232
  133. package/packs/agent-runtime/.turbo/turbo-typecheck.log +0 -4
  134. package/packs/sidekick/.turbo/turbo-test.log +0 -12
  135. package/packs/sidekick/.turbo/turbo-typecheck.log +0 -4
  136. package/packs/software-delivery/.turbo/turbo-typecheck.log +0 -4
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lumenflow/cli",
3
- "version": "3.22.0",
3
+ "version": "4.0.1",
4
4
  "description": "Command-line interface for LumenFlow workflow framework",
5
5
  "keywords": [
6
6
  "lumenflow",
@@ -9,16 +9,16 @@
9
9
  "wu",
10
10
  "work-unit"
11
11
  ],
12
- "homepage": "https://github.com/hellmai/lumenflow-dev",
12
+ "homepage": "https://github.com/hellmai/lumenflow",
13
13
  "repository": {
14
14
  "type": "git",
15
- "url": "https://github.com/hellmai/lumenflow-dev.git",
15
+ "url": "https://github.com/hellmai/lumenflow.git",
16
16
  "directory": "packages/@lumenflow/cli"
17
17
  },
18
18
  "license": "AGPL-3.0-only",
19
19
  "author": {
20
- "name": "HellmAI",
21
- "url": "https://hellm.ai"
20
+ "name": "LumenFlow Contributors",
21
+ "url": "https://lumenflow.dev"
22
22
  },
23
23
  "type": "module",
24
24
  "main": "./dist/index.js",
@@ -186,13 +186,13 @@
186
186
  "xstate": "^5.28.0",
187
187
  "yaml": "^2.8.2",
188
188
  "zod": "^4.3.6",
189
- "@lumenflow/agent": "3.22.0",
190
- "@lumenflow/control-plane-sdk": "3.22.0",
191
- "@lumenflow/core": "3.22.0",
192
- "@lumenflow/initiatives": "3.22.0",
193
- "@lumenflow/memory": "3.22.0",
194
- "@lumenflow/metrics": "3.22.0",
195
- "@lumenflow/kernel": "3.22.0"
189
+ "@lumenflow/control-plane-sdk": "4.0.1",
190
+ "@lumenflow/core": "4.0.1",
191
+ "@lumenflow/kernel": "4.0.1",
192
+ "@lumenflow/agent": "4.0.1",
193
+ "@lumenflow/memory": "4.0.1",
194
+ "@lumenflow/metrics": "4.0.1",
195
+ "@lumenflow/initiatives": "4.0.1"
196
196
  },
197
197
  "devDependencies": {
198
198
  "@vitest/coverage-v8": "^4.0.18",
@@ -1,4 +1,4 @@
1
1
 
2
- > @lumenflow/packs-agent-runtime@3.21.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/agent-runtime
2
+ > @lumenflow/packs-agent-runtime@4.0.1 build /home/runner/work/lumenflow-dev/lumenflow-dev/packages/@lumenflow/packs/agent-runtime
3
3
  > tsc
4
4
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lumenflow/packs-agent-runtime",
3
- "version": "3.22.0",
3
+ "version": "4.0.1",
4
4
  "description": "Agent runtime pack scaffold for LumenFlow — governed model-turn execution, pack config, and provider capability baselines",
5
5
  "keywords": [
6
6
  "lumenflow",
@@ -9,16 +9,16 @@
9
9
  "orchestration",
10
10
  "policy"
11
11
  ],
12
- "homepage": "https://github.com/hellmai/lumenflow-dev",
12
+ "homepage": "https://github.com/hellmai/lumenflow",
13
13
  "repository": {
14
14
  "type": "git",
15
- "url": "https://github.com/hellmai/lumenflow-dev.git",
15
+ "url": "https://github.com/hellmai/lumenflow.git",
16
16
  "directory": "packages/@lumenflow/packs/agent-runtime"
17
17
  },
18
18
  "license": "AGPL-3.0-only",
19
19
  "author": {
20
- "name": "HellmAI",
21
- "url": "https://hellm.ai"
20
+ "name": "LumenFlow Contributors",
21
+ "url": "https://lumenflow.dev"
22
22
  },
23
23
  "type": "module",
24
24
  "exports": {
@@ -1,4 +1,4 @@
1
1
 
2
- > @lumenflow/packs-sidekick@3.21.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
2
+ > @lumenflow/packs-sidekick@4.0.1 build /home/runner/work/lumenflow-dev/lumenflow-dev/packages/@lumenflow/packs/sidekick
3
3
  > tsc
4
4
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lumenflow/packs-sidekick",
3
- "version": "3.22.0",
3
+ "version": "4.0.1",
4
4
  "description": "Sidekick personal assistant pack for LumenFlow — 16 tools for task management, typed memory, channels, routines, and audit",
5
5
  "keywords": [
6
6
  "lumenflow",
@@ -10,16 +10,16 @@
10
10
  "task-management",
11
11
  "memory"
12
12
  ],
13
- "homepage": "https://github.com/hellmai/lumenflow-dev",
13
+ "homepage": "https://github.com/hellmai/lumenflow",
14
14
  "repository": {
15
15
  "type": "git",
16
- "url": "https://github.com/hellmai/lumenflow-dev.git",
16
+ "url": "https://github.com/hellmai/lumenflow.git",
17
17
  "directory": "packages/@lumenflow/packs/sidekick"
18
18
  },
19
19
  "license": "AGPL-3.0-only",
20
20
  "author": {
21
- "name": "HellmAI",
22
- "url": "https://hellm.ai"
21
+ "name": "LumenFlow Contributors",
22
+ "url": "https://lumenflow.dev"
23
23
  },
24
24
  "type": "module",
25
25
  "exports": {
@@ -1,4 +1,4 @@
1
1
 
2
- > @lumenflow/packs-software-delivery@3.21.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/software-delivery
2
+ > @lumenflow/packs-software-delivery@4.0.1 build /home/runner/work/lumenflow-dev/lumenflow-dev/packages/@lumenflow/packs/software-delivery
3
3
  > tsc
4
4
 
@@ -0,0 +1,18 @@
1
+ Copyright (C) 2026 HellmAI
2
+
3
+ This program is free software: you can redistribute it and/or modify
4
+ it under the terms of the GNU Affero General Public License as
5
+ published by the Free Software Foundation, version 3 of the License.
6
+
7
+ This program is distributed in the hope that it will be useful,
8
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
9
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10
+ GNU Affero General Public License for more details.
11
+
12
+ You should have received a copy of the GNU Affero General Public License
13
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
14
+
15
+ SPDX-License-Identifier: AGPL-3.0-only
16
+
17
+ For the full license text, see the LICENSE file in the root of the
18
+ LumenFlow repository: https://github.com/hellmai/lumenflow
@@ -0,0 +1,15 @@
1
+ # @lumenflow/packs-software-delivery
2
+
3
+ Software delivery pack for LumenFlow — work units, gates, lanes, initiatives, and agent coordination.
4
+
5
+ ## What It Provides
6
+
7
+ - Work unit lifecycle management (create, claim, prep, done)
8
+ - Quality gates (format, lint, typecheck, test)
9
+ - Lane-based WIP limits and parallel execution
10
+ - Initiative orchestration across multiple work units
11
+ - Agent coordination and handoff protocols
12
+
13
+ ## License
14
+
15
+ AGPL-3.0-only. See [LICENSE.md](./LICENSE.md).
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lumenflow/packs-software-delivery",
3
- "version": "3.22.0",
3
+ "version": "4.0.1",
4
4
  "description": "Software delivery pack for LumenFlow — work units, gates, lanes, initiatives, and agent coordination",
5
5
  "keywords": [
6
6
  "lumenflow",
@@ -10,16 +10,16 @@
10
10
  "gates",
11
11
  "lanes"
12
12
  ],
13
- "homepage": "https://github.com/hellmai/lumenflow-dev",
13
+ "homepage": "https://github.com/hellmai/lumenflow",
14
14
  "repository": {
15
15
  "type": "git",
16
- "url": "https://github.com/hellmai/lumenflow-dev.git",
16
+ "url": "https://github.com/hellmai/lumenflow.git",
17
17
  "directory": "packages/@lumenflow/packs/software-delivery"
18
18
  },
19
19
  "license": "AGPL-3.0-only",
20
20
  "author": {
21
- "name": "HellmAI",
22
- "url": "https://hellm.ai"
21
+ "name": "LumenFlow Contributors",
22
+ "url": "https://lumenflow.dev"
23
23
  },
24
24
  "type": "module",
25
25
  "exports": {
@@ -94,30 +94,7 @@ pnpm wu:cleanup --id WU-XXXX
94
94
 
95
95
  ## CLI Commands and Lifecycle Reference
96
96
 
97
- For complete CLI command documentation (100+ commands), see [quick-ref-commands.md]({{QUICK_REF_LINK}}).
98
-
99
- **Essential commands:**
100
-
101
- | Command | Description |
102
- | ------------------------- | ----------------------------------------------------------------------- |
103
- | `pnpm wu:create` | Create new WU spec (ID auto-generated) |
104
- | `pnpm wu:claim` | Claim WU and create worktree (or `--cloud`) |
105
- | `pnpm wu:prep` | Run gates in worktree, prep for wu:done |
106
- | `pnpm wu:done` | Complete WU (merge or PR, stamp, cleanup) |
107
- | `pnpm wu:status` | Show WU status, location, valid commands |
108
- | `pnpm wu:brief` | **MANDATORY after wu:claim.** Generate handoff prompt + record evidence |
109
- | `pnpm wu:delegate` | Generate prompt + record lineage + brief hash attestation |
110
- | `pnpm wu:recover` | Analyze and fix WU state inconsistencies |
111
- | `pnpm wu:escalate` | Show or resolve WU escalation status |
112
- | `pnpm wu:verify` | Verify WU completion (stamp, commit, clean tree) |
113
- | `pnpm wu:delete` | Delete WU spec and cleanup |
114
- | `pnpm gates` | Run all quality gates (`--docs-only` for docs) |
115
- | `pnpm lumenflow:commands` | List all public commands (primary + aliases + legacy) |
116
- | `pnpm lane:status` | Show lane lifecycle status and next step |
117
- | `pnpm lane:setup` | Create/update draft lane artifacts |
118
- | `pnpm lane:lock` | Lock lane lifecycle for delivery WUs |
119
- | `pnpm mem:checkpoint` | Save progress checkpoint |
120
- | `pnpm mem:recover` | Generate recovery context |
97
+ For the **complete CLI command reference** (130+ commands across all categories), see the [CLI Command Reference in LUMENFLOW.md](LUMENFLOW.md#cli-command-reference).
121
98
 
122
99
  **Two-step completion (wu:prep then wu:done):**
123
100
 
@@ -265,40 +265,194 @@ For the full worktree lifecycle (parallel execution, bootstrap, isolation guaran
265
265
 
266
266
  ---
267
267
 
268
- ## Core Commands
269
-
270
- > **Complete CLI reference (100+ commands):** See [quick-ref-commands.md]({{QUICK_REF_LINK}}). Always run `<command> --help` for the authoritative option list.
271
-
272
- | Command | Description |
273
- | ------------------------- | ------------------------------------------------------------------------------- |
274
- | `pnpm wu:create` | Create new WU spec |
275
- | `pnpm wu:claim` | Claim WU, update canonical state, create worktree |
276
- | `pnpm wu:prep` | Run gates in worktree, prep for wu:done |
277
- | `pnpm wu:done` | Complete WU (merge, stamp, cleanup) |
278
- | `pnpm wu:status` | Show WU status, location, and valid commands |
279
- | `pnpm wu:recover` | Analyze and fix WU state inconsistencies |
280
- | `pnpm wu:block` | Block WU (transitions to blocked, frees lane) |
281
- | `pnpm wu:unblock` | Unblock WU (transitions to in_progress) |
282
- | `pnpm wu:release` | Release orphaned WU (in_progress to ready for reclaim) |
283
- | `pnpm wu:brief` | **MANDATORY after wu:claim.** Generate handoff prompt + record evidence |
284
- | `pnpm wu:delegate` | Generate prompt + record lineage + brief hash attestation |
285
- | `pnpm wu:escalate` | Show or resolve WU escalation status |
286
- | `pnpm wu:verify` | Verify WU completion (stamp, commit, clean tree) |
287
- | `pnpm wu:delete` | Delete WU spec and cleanup |
288
- | `pnpm gates` | Run quality gates (`pnpm gates:docs` for docs WUs; `--docs-only` is equivalent) |
289
- | `pnpm lumenflow:commands` | List all public commands (primary + alias + legacy) |
290
- | `pnpm docs:generate` | Regenerate CLI/config reference docs from source |
291
- | `pnpm docs:validate` | Verify generated docs are up-to-date |
292
- | `pnpm lane:status` | Show lane lifecycle status + next step |
293
- | `pnpm lane:setup` | Create/update draft lane artifacts |
294
- | `pnpm lane:validate` | Validate lane artifacts before lock |
295
- | `pnpm lane:lock` | Lock lane lifecycle for delivery WUs |
296
- | `pnpm mem:checkpoint` | Save memory checkpoint |
297
-
298
- Commands include **context-aware validation** that checks location, WU status, and git state. When validation fails, commands provide copy-paste ready fix commands. Configure in `workspace.yaml` under `software_delivery.experimental.context_validation`.
299
- The Starlight CLI reference page is intentionally curated to primary commands; use `pnpm lumenflow:commands` for complete discovery.
300
-
301
- For recovery commands, state management, memory coordination, and orchestration tools, see [quick-ref-commands.md]({{QUICK_REF_LINK}}).
268
+ ## CLI Command Reference
269
+
270
+ > **This is the canonical command reference.** All agent docs (AGENTS.md, vendor rules, onboarding) point here. Always run `<command> --help` for authoritative options. Run `pnpm lumenflow:commands` to verify against the live CLI.
271
+
272
+ ### WU Lifecycle
273
+
274
+ | Command | Description |
275
+ | ----------------------- | ----------------------------------------------------------------------- |
276
+ | `pnpm wu:create` | Create new WU spec (ID auto-generated) |
277
+ | `pnpm wu:claim` | Claim WU, update canonical state, create worktree (or `--cloud`) |
278
+ | `pnpm wu:sandbox` | Run command through hardened WU sandbox backend |
279
+ | `pnpm wu:prep` | Run gates in worktree, prep for wu:done |
280
+ | `pnpm wu:done` | Complete WU (merge, stamp, cleanup) |
281
+ | `pnpm wu:edit` | Edit WU spec fields |
282
+ | `pnpm wu:block` | Block WU (transitions to blocked, frees lane) |
283
+ | `pnpm wu:unblock` | Unblock WU (transitions to in_progress) |
284
+ | `pnpm wu:release` | Release orphaned WU (in_progress to ready for reclaim) |
285
+ | `pnpm wu:status` | Show WU status, location, and valid commands |
286
+ | `pnpm wu:brief` | **MANDATORY after wu:claim.** Generate handoff prompt + record evidence |
287
+ | `pnpm wu:delegate` | Generate prompt + record lineage + brief hash attestation |
288
+ | `pnpm wu:validate` | Validate WU spec completeness and schema |
289
+ | `pnpm wu:recover` | Analyze and fix WU state inconsistencies |
290
+ | `pnpm wu:verify` | Verify WU completion (stamp, commit, clean tree) |
291
+ | `pnpm wu:escalate` | Show or resolve WU escalation status |
292
+ | `pnpm wu:delete` | Delete WU spec and cleanup |
293
+ | `pnpm approval:request` | Request control-plane approval for a workflow action |
294
+ | `pnpm approval:review` | Resolve a control-plane approval decision |
295
+ | `pnpm approval:list` | List control-plane approvals with optional filters |
296
+
297
+ ### WU Maintenance
298
+
299
+ | Command | Description |
300
+ | --------------------- | ---------------------------------------------------------------- |
301
+ | `pnpm wu:preflight` | Pre-flight checks before wu:done |
302
+ | `pnpm wu:repair` | Repair WU state issues (claim, admin, state, duplicate-ids mode) |
303
+ | `pnpm wu:prune` | Clean stale worktrees |
304
+ | `pnpm wu:cleanup` | Cleanup after PR merge (branch-pr mode) |
305
+ | `pnpm wu:deps` | Show WU dependencies |
306
+ | `pnpm wu:infer-lane` | Infer lane from code paths/description |
307
+ | `pnpm wu:unlock-lane` | Unlock stuck lane |
308
+ | `pnpm wu:proto` | Create WU prototype |
309
+
310
+ ### Gates & Quality
311
+
312
+ | Command | Description |
313
+ | --------------------------------- | ----------------------------------------------------- |
314
+ | `pnpm gates` | Run all quality gates (`--docs-only` for docs WUs) |
315
+ | `pnpm gates:docs` | Run docs-only quality gates (alias) |
316
+ | `pnpm validate` | Run validation checks |
317
+ | `pnpm lumenflow:pre-commit-check` | Run enforcement checks used by pre-commit and CI |
318
+ | `pnpm gate:co-change` | Manage co-change gate rules (add, remove, edit, list) |
319
+ | `pnpm format` | Format all files (Prettier) |
320
+ | `pnpm lint` | Run ESLint |
321
+ | `pnpm typecheck` | Run TypeScript type checking |
322
+ | `pnpm test` | Run all tests (Vitest) |
323
+
324
+ ### Lane Management
325
+
326
+ | Command | Description |
327
+ | -------------------- | ------------------------------------------------- |
328
+ | `pnpm lane:create` | Create a new lane definition |
329
+ | `pnpm lane:edit` | Edit a lane definition (rename, wip-limit, paths) |
330
+ | `pnpm lane:health` | Check lane config health |
331
+ | `pnpm lane:suggest` | Suggest workspace lane definitions from context |
332
+ | `pnpm lane:status` | Show lane lifecycle status and next step |
333
+ | `pnpm lane:setup` | Create/update draft lane artifacts |
334
+ | `pnpm lane:validate` | Validate lane artifacts before lock |
335
+ | `pnpm lane:lock` | Lock lane lifecycle for delivery WUs |
336
+
337
+ ### Memory & Sessions
338
+
339
+ | Command | Description |
340
+ | --------------------- | ------------------------------------------ |
341
+ | `pnpm mem:init` | Initialize memory for WU |
342
+ | `pnpm mem:checkpoint` | Save progress checkpoint |
343
+ | `pnpm mem:start` | Start a memory session |
344
+ | `pnpm mem:ready` | Check pending memory nodes |
345
+ | `pnpm mem:export` | Export memory as markdown |
346
+ | `pnpm mem:signal` | Broadcast coordination signal |
347
+ | `pnpm mem:cleanup` | Clean up stale memory data |
348
+ | `pnpm mem:context` | Get context for current lane/WU |
349
+ | `pnpm mem:create` | Create memory node (bug discovery) |
350
+ | `pnpm mem:inbox` | Check coordination signals |
351
+ | `pnpm mem:summarize` | Summarize memory context |
352
+ | `pnpm mem:triage` | Triage discovered bugs |
353
+ | `pnpm mem:delete` | Delete/archive a memory node |
354
+ | `pnpm mem:recover` | Generate recovery context after compaction |
355
+ | `pnpm signal:cleanup` | Clean up stale signals |
356
+
357
+ ### Initiatives
358
+
359
+ | Command | Description |
360
+ | ----------------------------- | ----------------------------------------- |
361
+ | `pnpm initiative:create` | Create new initiative |
362
+ | `pnpm initiative:edit` | Edit initiative fields and phase metadata |
363
+ | `pnpm initiative:list` | List all initiatives |
364
+ | `pnpm initiative:status` | Show initiative status |
365
+ | `pnpm initiative:add-wu` | Add WU to initiative |
366
+ | `pnpm initiative:remove-wu` | Remove WU from initiative |
367
+ | `pnpm initiative:plan` | Link plan to initiative |
368
+ | `pnpm initiative:bulk-assign` | Bulk assign WUs to initiative |
369
+
370
+ ### Plans
371
+
372
+ | Command | Description |
373
+ | ------------------- | ----------------------------- |
374
+ | `pnpm plan:create` | Create a new plan |
375
+ | `pnpm plan:link` | Link plan to WU or initiative |
376
+ | `pnpm plan:edit` | Edit plan content |
377
+ | `pnpm plan:promote` | Promote plan to WU |
378
+
379
+ ### Orchestration
380
+
381
+ | Command | Description |
382
+ | ------------------------------ | ------------------------------------------- |
383
+ | `pnpm orchestrate:initiative` | Orchestrate initiative execution |
384
+ | `pnpm orchestrate:init-status` | Compact initiative progress view |
385
+ | `pnpm orchestrate:monitor` | Monitor spawn/agent activity |
386
+ | `pnpm delegation:list` | List active delegation records |
387
+ | `pnpm task:claim` | Claim a task directly through KernelRuntime |
388
+ | `pnpm agent:session` | Start agent session |
389
+ | `pnpm agent:session-end` | End agent session |
390
+ | `pnpm agent:log-issue` | Log issue during agent session |
391
+ | `pnpm agent:issues-query` | Query GitHub issues for agent work |
392
+
393
+ ### Setup & Configuration
394
+
395
+ | Command | Description |
396
+ | ------------------------------- | ----------------------------------------------------- |
397
+ | `pnpm setup` | Install deps and build CLI (first time) |
398
+ | `pnpm lumenflow` | Initialize LumenFlow in a project |
399
+ | `pnpm lumenflow:doctor` | Diagnose LumenFlow configuration |
400
+ | `pnpm lumenflow:commands` | List all available CLI commands |
401
+ | `pnpm lumenflow:release` | Run release workflow |
402
+ | `pnpm lumenflow:docs-sync` | Refresh core docs, onboarding docs, and vendor assets |
403
+ | `pnpm lumenflow:sync-templates` | Sync templates to project |
404
+ | `pnpm lumenflow:upgrade` | Upgrade LumenFlow packages |
405
+ | `pnpm lumenflow:integrate` | Generate enforcement hooks for client |
406
+ | `pnpm config:set` | Safely update workspace.yaml via micro-worktree |
407
+ | `pnpm config:get` | Read a value from workspace.yaml |
408
+ | `pnpm cloud:connect` | Connect workspace.yaml to cloud control plane |
409
+ | `pnpm backlog:prune` | Clean stale backlog entries |
410
+
411
+ ### Metrics & Flow
412
+
413
+ | Command | Description |
414
+ | ----------------------- | ------------------------------------------------------ |
415
+ | `pnpm flow:report` | Generate flow metrics report |
416
+ | `pnpm flow:bottlenecks` | Identify flow bottlenecks |
417
+ | `pnpm metrics:snapshot` | Capture metrics snapshot |
418
+ | `pnpm cost:summary` | Summarize local cost telemetry |
419
+ | `pnpm strict:progress` | Report strict TypeScript backlog and guard regressions |
420
+
421
+ ### State Management
422
+
423
+ | Command | Description |
424
+ | ---------------------- | ------------------------------------ |
425
+ | `pnpm state:doctor` | Diagnose state store issues |
426
+ | `pnpm state:cleanup` | Clean up stale state data |
427
+ | `pnpm state:bootstrap` | Bootstrap state store |
428
+ | `pnpm state:emit` | Emit corrective event to state store |
429
+
430
+ ### Packs
431
+
432
+ | Command | Description |
433
+ | -------------------- | ------------------------------------------ |
434
+ | `pnpm pack:author` | Author a secure domain pack from templates |
435
+ | `pnpm pack:scaffold` | Scaffold a new domain pack |
436
+ | `pnpm pack:validate` | Validate a domain pack for integrity |
437
+ | `pnpm pack:hash` | Compute integrity hash for a domain pack |
438
+ | `pnpm pack:publish` | Publish a domain pack to a registry |
439
+ | `pnpm pack:install` | Install a domain pack into workspace |
440
+ | `pnpm pack:search` | Search for domain packs in a registry |
441
+
442
+ ### Audited Wrappers
443
+
444
+ | Command | Description |
445
+ | ------------------ | -------------------------------- |
446
+ | `pnpm file:read` | Read file with audit trail |
447
+ | `pnpm file:write` | Write file with audit trail |
448
+ | `pnpm file:edit` | Edit file with audit trail |
449
+ | `pnpm file:delete` | Delete file with audit trail |
450
+ | `pnpm git:status` | Show git status with audit trail |
451
+ | `pnpm git:diff` | Show git diff with audit trail |
452
+ | `pnpm git:log` | Show git log with audit trail |
453
+ | `pnpm git:branch` | Show git branch with audit trail |
454
+
455
+ Commands include **context-aware validation** that checks location, WU status, and git state. When validation fails, commands provide copy-paste ready fix commands.
302
456
 
303
457
  ---
304
458
 
@@ -43,7 +43,7 @@ pnpm list @lumenflow/*
43
43
 
44
44
  Before upgrading, review the changelog for breaking changes:
45
45
 
46
- - [GitHub Releases](https://github.com/hellmai/lumenflow-dev/releases)
46
+ - [GitHub Releases](https://github.com/hellmai/lumenflow/releases)
47
47
  - [lumenflow.dev/changelog](https://lumenflow.dev/changelog)
48
48
 
49
49
  ### 3. Update Packages
@@ -140,5 +140,5 @@ For major version upgrades, see version-specific migration guides:
140
140
 
141
141
  ## Getting Help
142
142
 
143
- - [GitHub Issues](https://github.com/hellmai/lumenflow-dev/issues)
143
+ - [GitHub Issues](https://github.com/hellmai/lumenflow/issues)
144
144
  - [lumenflow.dev/docs](https://lumenflow.dev/docs)
@@ -262,11 +262,11 @@ vercel --prod
262
262
 
263
263
  - **Project**: `lumenflow-docs` (ID: `prj_myK4BzfHKctGhxfvALJaMOXVLx4g`)
264
264
  - **Domain**: lumenflow.dev
265
- - **Team**: hellm-ai
265
+ - **Team**: lumenflow
266
266
 
267
267
  ### Important Notes
268
268
 
269
- - **No private repo links**: Starlight docs are public; never link to `github.com/hellmai/lumenflow-dev`
269
+ - **No private repo links**: Starlight docs are public; never link to `github.com/hellmai/lumenflow`
270
270
  - **Link to npm**: Use <https://www.npmjs.com/org/lumenflow> for package links
271
271
 
272
272
  ---
@@ -286,8 +286,8 @@ Packs are published to the registry at <https://registry.lumenflow.dev>. The reg
286
286
  The `apps/web` Vercel project has `Root Directory: apps/web` configured. To deploy from the CLI, link the repo root to the `web` project:
287
287
 
288
288
  ```bash
289
- # From repo root — link to the 'web' project (not 'lumenflow-dev')
290
- vercel link --project web --scope hellm-ai --yes
289
+ # From repo root — link to the 'web' project (not the monorepo project)
290
+ vercel link --project web --scope lumenflow --yes
291
291
 
292
292
  # Deploy to production
293
293
  vercel --prod --yes
@@ -295,12 +295,12 @@ vercel --prod --yes
295
295
 
296
296
  **Gotcha:** Do NOT run `vercel` from inside `apps/web/` — the Vercel root directory setting doubles the path (`apps/web/apps/web`). Always deploy from the repo root.
297
297
 
298
- **Gotcha:** The repo root `.vercel/project.json` may be linked to `lumenflow-dev` (the monorepo project). You must re-link to `web` before deploying the registry.
298
+ **Gotcha:** The repo root `.vercel/project.json` may be linked to the monorepo project. You must re-link to `web` before deploying the registry.
299
299
 
300
300
  After deploying, restore the link if needed:
301
301
 
302
302
  ```bash
303
- vercel link --project lumenflow-dev --scope hellm-ai --yes
303
+ vercel link --project lumenflow --scope lumenflow --yes
304
304
  ```
305
305
 
306
306
  ### Step 2: Build the Tarball
@@ -345,12 +345,12 @@ rm packages/@lumenflow/packs/software-delivery/lumenflow-packs-software-delivery
345
345
 
346
346
  ### Vercel Projects Reference
347
347
 
348
- | Project | Domain | Purpose |
349
- | --------------- | ------------------------ | ----------------------- |
350
- | `web` | registry.lumenflow.dev | Pack registry + web app |
351
- | `docs` | lumenflow.dev | Starlight documentation |
352
- | `lumenflow-dev` | lumenflow-dev.vercel.app | Monorepo preview |
353
- | `cloud` | cloud.lumenflow.dev | Control plane |
348
+ | Project | Domain | Purpose |
349
+ | ----------- | ---------------------- | ----------------------- |
350
+ | `web` | registry.lumenflow.dev | Pack registry + web app |
351
+ | `docs` | lumenflow.dev | Starlight documentation |
352
+ | `lumenflow` | lumenflow.vercel.app | Monorepo preview |
353
+ | `cloud` | cloud.lumenflow.dev | Control plane |
354
354
 
355
355
  ### Troubleshooting Pack Publishing
356
356
 
@@ -368,7 +368,7 @@ Missing or wrong `Origin` header. Must be `https://registry.lumenflow.dev`.
368
368
 
369
369
  #### Vercel build fails with d2 error
370
370
 
371
- The `@lumenflow/docs` package requires `d2` (diagramming tool) which is not available on Vercel. Ensure you are deploying the `web` project (which uses `turbo build --filter=@lumenflow/web`) not the `lumenflow-dev` project (which builds all packages).
371
+ The `@lumenflow/docs` package requires `d2` (diagramming tool) which is not available on Vercel. Ensure you are deploying the `web` project (which uses `turbo build --filter=@lumenflow/web`) not the monorepo project (which builds all packages).
372
372
 
373
373
  ---
374
374
 
@@ -1,37 +0,0 @@
1
- import {
2
- TEST_TYPES,
3
- WU_TYPES
4
- } from "./chunk-V6OJGLBA.js";
5
-
6
- // ../core/dist/wu-type-helpers.js
7
- function isNonEmptyArray(value) {
8
- return Array.isArray(value) && value.length > 0;
9
- }
10
- function isDocumentationType(type) {
11
- return typeof type === "string" && type === WU_TYPES.DOCUMENTATION;
12
- }
13
- function isProcessType(type) {
14
- return typeof type === "string" && type === WU_TYPES.PROCESS;
15
- }
16
- function isDocsOrProcessType(type) {
17
- return isDocumentationType(type) || isProcessType(type);
18
- }
19
- function hasAnyTests(tests) {
20
- if (!tests || typeof tests !== "object")
21
- return false;
22
- const t = tests;
23
- return isNonEmptyArray(t[TEST_TYPES.MANUAL]) || isNonEmptyArray(t[TEST_TYPES.UNIT]) || isNonEmptyArray(t[TEST_TYPES.E2E]) || isNonEmptyArray(t[TEST_TYPES.INTEGRATION]);
24
- }
25
- function hasManualTests(tests) {
26
- if (!tests || typeof tests !== "object")
27
- return false;
28
- const t = tests;
29
- return isNonEmptyArray(t[TEST_TYPES.MANUAL]);
30
- }
31
-
32
- export {
33
- isDocumentationType,
34
- isDocsOrProcessType,
35
- hasAnyTests,
36
- hasManualTests
37
- };