@lumenflow/cli 3.18.1 → 3.20.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 (175) hide show
  1. package/dist/docs-sync.js +123 -6
  2. package/dist/docs-sync.js.map +1 -1
  3. package/dist/gate-co-change.js +23 -4
  4. package/dist/gate-co-change.js.map +1 -1
  5. package/dist/gates-runners.js +113 -16
  6. package/dist/gates-runners.js.map +1 -1
  7. package/dist/gates-utils.js +71 -0
  8. package/dist/gates-utils.js.map +1 -1
  9. package/dist/lumenflow-upgrade.js +1 -0
  10. package/dist/lumenflow-upgrade.js.map +1 -1
  11. package/dist/public-manifest.js +1 -1
  12. package/dist/public-manifest.js.map +1 -1
  13. package/dist/sync-templates.js +13 -0
  14. package/dist/sync-templates.js.map +1 -1
  15. package/dist/wu-block.js +10 -0
  16. package/dist/wu-block.js.map +1 -1
  17. package/dist/wu-claim-validation.js +3 -1
  18. package/dist/wu-claim-validation.js.map +1 -1
  19. package/dist/wu-claim.js +3 -1
  20. package/dist/wu-claim.js.map +1 -1
  21. package/dist/wu-done-memory-telemetry.js +5 -1
  22. package/dist/wu-done-memory-telemetry.js.map +1 -1
  23. package/dist/wu-done-ownership.js +6 -0
  24. package/dist/wu-done-ownership.js.map +1 -1
  25. package/dist/wu-edit-operations.js +4 -4
  26. package/dist/wu-edit-operations.js.map +1 -1
  27. package/dist/wu-prep.js +88 -13
  28. package/dist/wu-prep.js.map +1 -1
  29. package/dist/wu-prune.js +2 -2
  30. package/dist/wu-prune.js.map +1 -1
  31. package/dist/wu-recover.js +15 -0
  32. package/dist/wu-recover.js.map +1 -1
  33. package/dist/wu-release.js +10 -1
  34. package/dist/wu-release.js.map +1 -1
  35. package/dist/wu-spawn-prompt-builders.js +27 -2
  36. package/dist/wu-spawn-prompt-builders.js.map +1 -1
  37. package/dist/wu-state-mutation-ownership.js +136 -0
  38. package/dist/wu-state-mutation-ownership.js.map +1 -0
  39. package/dist/wu-unblock.js +10 -0
  40. package/dist/wu-unblock.js.map +1 -1
  41. package/dist/wu-verify.js +22 -17
  42. package/dist/wu-verify.js.map +1 -1
  43. package/package.json +111 -110
  44. package/packs/agent-runtime/.turbo/turbo-build.log +1 -1
  45. package/packs/agent-runtime/package.json +1 -1
  46. package/packs/sidekick/.turbo/turbo-build.log +1 -1
  47. package/packs/sidekick/README.md +118 -113
  48. package/packs/sidekick/manifest-schema.ts +15 -228
  49. package/packs/sidekick/manifest.ts +107 -7
  50. package/packs/sidekick/manifest.yaml +199 -1
  51. package/packs/sidekick/package.json +4 -1
  52. package/packs/sidekick/policy-factory.ts +38 -0
  53. package/packs/sidekick/tool-impl/channel-tools.ts +99 -0
  54. package/packs/sidekick/tool-impl/memory-tools.ts +86 -1
  55. package/packs/sidekick/tool-impl/routine-tools.ts +156 -2
  56. package/packs/sidekick/tool-impl/storage.ts +6 -5
  57. package/packs/sidekick/tool-impl/task-tools.ts +186 -4
  58. package/packs/software-delivery/.turbo/turbo-build.log +1 -1
  59. package/packs/software-delivery/package.json +1 -1
  60. package/templates/core/AGENTS.md.template +157 -32
  61. package/templates/core/LUMENFLOW.md.template +44 -29
  62. package/templates/core/_frameworks/lumenflow/wu-sizing-guide.md.template +644 -0
  63. package/templates/core/ai/onboarding/agent-invocation-guide.md.template +5 -5
  64. package/templates/core/ai/onboarding/agent-safety-card.md.template +1 -0
  65. package/templates/core/ai/onboarding/docs-generation.md.template +94 -4
  66. package/templates/core/ai/onboarding/first-15-mins.md.template +1 -1
  67. package/templates/core/ai/onboarding/first-wu-mistakes.md.template +2 -1
  68. package/templates/core/ai/onboarding/initiative-orchestration.md.template +21 -21
  69. package/templates/core/ai/onboarding/quick-ref-commands.md.template +126 -109
  70. package/templates/core/ai/onboarding/release-process.md.template +12 -12
  71. package/templates/core/ai/onboarding/starting-prompt.md.template +33 -32
  72. package/templates/vendors/claude/.claude/skills/initiative-management/SKILL.md.template +2 -2
  73. package/templates/vendors/claude/.claude/skills/multi-agent-coordination/SKILL.md.template +2 -2
  74. package/templates/vendors/claude/.claude/skills/orchestration/SKILL.md.template +3 -3
  75. package/dist/chunk-2D2VOCA4.js +0 -37
  76. package/dist/chunk-2D5KFYGX.js +0 -284
  77. package/dist/chunk-2GXVIN57.js +0 -14072
  78. package/dist/chunk-2MQ7HZWZ.js +0 -26
  79. package/dist/chunk-2UFQ3A3C.js +0 -643
  80. package/dist/chunk-3RG5ZIWI.js +0 -10
  81. package/dist/chunk-4N74J3UT.js +0 -15
  82. package/dist/chunk-5GTOXFYR.js +0 -392
  83. package/dist/chunk-5VY6MQMC.js +0 -240
  84. package/dist/chunk-67XVPMRY.js +0 -1297
  85. package/dist/chunk-6HO4GWJE.js +0 -164
  86. package/dist/chunk-6W5XHWYV.js +0 -1890
  87. package/dist/chunk-6X4EMYJQ.js +0 -64
  88. package/dist/chunk-6XYXI2NQ.js +0 -772
  89. package/dist/chunk-7ANSOV6Q.js +0 -285
  90. package/dist/chunk-A624LFLB.js +0 -1380
  91. package/dist/chunk-ADN5NHG4.js +0 -126
  92. package/dist/chunk-B7YJYJKG.js +0 -33
  93. package/dist/chunk-CCLHCPKG.js +0 -210
  94. package/dist/chunk-CK36VROC.js +0 -1584
  95. package/dist/chunk-D3UOFRSB.js +0 -81
  96. package/dist/chunk-DFR4DJBM.js +0 -230
  97. package/dist/chunk-DSYBDHYH.js +0 -79
  98. package/dist/chunk-DWMLTXKQ.js +0 -1176
  99. package/dist/chunk-E3REJTAJ.js +0 -28
  100. package/dist/chunk-EA3IVO64.js +0 -633
  101. package/dist/chunk-EK2AKZKD.js +0 -55
  102. package/dist/chunk-ELD7JTTT.js +0 -343
  103. package/dist/chunk-EX6TT2XI.js +0 -195
  104. package/dist/chunk-EXINSFZE.js +0 -82
  105. package/dist/chunk-EZ6ZBYBM.js +0 -510
  106. package/dist/chunk-FBKAPTJ2.js +0 -16
  107. package/dist/chunk-FVLV5RYH.js +0 -1118
  108. package/dist/chunk-GDNSBQVK.js +0 -2485
  109. package/dist/chunk-GPQHMBNN.js +0 -278
  110. package/dist/chunk-GTFJB67L.js +0 -68
  111. package/dist/chunk-HANJXVKW.js +0 -1127
  112. package/dist/chunk-HEVS5YLD.js +0 -269
  113. package/dist/chunk-HMEVZKPQ.js +0 -9
  114. package/dist/chunk-HRGSYNLM.js +0 -3511
  115. package/dist/chunk-ISZR5N4K.js +0 -60
  116. package/dist/chunk-J6SUPR2C.js +0 -226
  117. package/dist/chunk-JERYVEIZ.js +0 -244
  118. package/dist/chunk-JHHWGL2N.js +0 -87
  119. package/dist/chunk-JONWQUB5.js +0 -775
  120. package/dist/chunk-K2DIWWDM.js +0 -1766
  121. package/dist/chunk-KY4PGL5V.js +0 -969
  122. package/dist/chunk-L737LQ4C.js +0 -1285
  123. package/dist/chunk-LFTWYIB2.js +0 -497
  124. package/dist/chunk-LV47RFNJ.js +0 -41
  125. package/dist/chunk-MKSAITI7.js +0 -15
  126. package/dist/chunk-MZ7RKIX4.js +0 -212
  127. package/dist/chunk-NAP6CFSO.js +0 -84
  128. package/dist/chunk-ND6MY37M.js +0 -16
  129. package/dist/chunk-NMG736UR.js +0 -683
  130. package/dist/chunk-NRAXROED.js +0 -32
  131. package/dist/chunk-NRIZR3A7.js +0 -690
  132. package/dist/chunk-NX43BG3M.js +0 -233
  133. package/dist/chunk-O645XLSI.js +0 -297
  134. package/dist/chunk-OMJD6A3S.js +0 -235
  135. package/dist/chunk-QB6SJD4T.js +0 -430
  136. package/dist/chunk-QFSTL4J3.js +0 -276
  137. package/dist/chunk-QLGDFMFX.js +0 -212
  138. package/dist/chunk-RIAAGL2E.js +0 -13
  139. package/dist/chunk-RWO5XMZ6.js +0 -86
  140. package/dist/chunk-RXRKBBSM.js +0 -149
  141. package/dist/chunk-RZOZMML6.js +0 -363
  142. package/dist/chunk-U7I7FS7T.js +0 -113
  143. package/dist/chunk-UI42RODY.js +0 -717
  144. package/dist/chunk-UTVMVSCO.js +0 -519
  145. package/dist/chunk-V6OJGLBA.js +0 -1746
  146. package/dist/chunk-W2JHVH7D.js +0 -152
  147. package/dist/chunk-WD3Y7VQN.js +0 -280
  148. package/dist/chunk-WOCTQ5MS.js +0 -303
  149. package/dist/chunk-WZR3ZUNN.js +0 -696
  150. package/dist/chunk-XGI665H7.js +0 -150
  151. package/dist/chunk-XKY65P2T.js +0 -304
  152. package/dist/chunk-Y4CQZY65.js +0 -57
  153. package/dist/chunk-YFEXKLVE.js +0 -194
  154. package/dist/chunk-YHO3HS5X.js +0 -287
  155. package/dist/chunk-YLS7AZSX.js +0 -738
  156. package/dist/chunk-ZE473AO6.js +0 -49
  157. package/dist/chunk-ZF747T3O.js +0 -644
  158. package/dist/chunk-ZHCZHZH3.js +0 -43
  159. package/dist/chunk-ZZNZX2XY.js +0 -87
  160. package/dist/constants-7QAP3VQ4.js +0 -23
  161. package/dist/dist-IY3UUMWK.js +0 -33
  162. package/dist/invariants-runner-W5RGHCSU.js +0 -27
  163. package/dist/lane-lock-6J36HD5O.js +0 -35
  164. package/dist/mem-checkpoint-core-EANG2GVN.js +0 -14
  165. package/dist/mem-signal-core-2LZ2WYHW.js +0 -19
  166. package/dist/memory-store-OLB5FO7K.js +0 -18
  167. package/dist/service-6BYCOCO5.js +0 -13
  168. package/dist/spawn-policy-resolver-NTSZYQ6R.js +0 -17
  169. package/dist/spawn-task-builder-R4E2BHSW.js +0 -22
  170. package/dist/wu-done-pr-WLFFFEPJ.js +0 -25
  171. package/dist/wu-done-validation-3J5E36FE.js +0 -30
  172. package/dist/wu-duplicate-id-detector-5S7JHELK.js +0 -232
  173. package/packs/sidekick/.turbo/turbo-test.log +0 -12
  174. package/packs/sidekick/.turbo/turbo-typecheck.log +0 -4
  175. package/packs/software-delivery/.turbo/turbo-typecheck.log +0 -4
@@ -1,233 +0,0 @@
1
- import {
2
- normalizeValidationIssue
3
- } from "./chunk-2GXVIN57.js";
4
- import {
5
- REGISTRATION_SURFACES,
6
- RULE_CODES,
7
- validateWURulesSync
8
- } from "./chunk-L737LQ4C.js";
9
- import {
10
- INVARIANT_TYPES,
11
- loadInvariants
12
- } from "./chunk-EZ6ZBYBM.js";
13
- import {
14
- WU_STATUS
15
- } from "./chunk-V6OJGLBA.js";
16
-
17
- // ../core/dist/wu-lint.js
18
- import { existsSync } from "fs";
19
- import { minimatch } from "minimatch";
20
- var WU_LINT_ERROR_TYPES = {
21
- ACCEPTANCE_PATH_NOT_IN_CODE_PATHS: "acceptance_path_not_in_code_paths",
22
- CODE_PATH_CONFLICTS_INVARIANT: "code_path_conflicts_invariant",
23
- ACCEPTANCE_CONFLICTS_INVARIANT: "acceptance_conflicts_invariant",
24
- /** CLI registration parity surface missing */
25
- REGISTRATION_PARITY_MISSING: "registration_parity_missing",
26
- /** Backward-compatible key for minimum test intent */
27
- UNIT_TESTS_REQUIRED: "unit_tests_required",
28
- /** Canonical minimum test intent key */
29
- MINIMUM_TEST_INTENT_REQUIRED: "minimum_test_intent_required"
30
- };
31
- var REGISTRATION_SURFACES2 = {
32
- PUBLIC_MANIFEST: REGISTRATION_SURFACES.PUBLIC_MANIFEST,
33
- MCP_TOOLS: REGISTRATION_SURFACES.MCP_TOOLS
34
- };
35
- var CLI_COMMAND_EXCLUDE_PATTERNS = [
36
- "__tests__/",
37
- "/lib/",
38
- "/shared/",
39
- "/commands/",
40
- "/init.ts",
41
- REGISTRATION_SURFACES2.PUBLIC_MANIFEST,
42
- REGISTRATION_SURFACES2.MCP_TOOLS
43
- ];
44
- var FILE_PATH_PATTERN = /(?:^|[\s'"`])([a-zA-Z0-9_-]+\/[a-zA-Z0-9_./-]+\.[a-zA-Z0-9]+)/g;
45
- function extractFilePaths(text) {
46
- const paths = [];
47
- let match;
48
- while ((match = FILE_PATH_PATTERN.exec(text)) !== null) {
49
- const captured = match[1];
50
- if (captured) {
51
- paths.push(captured);
52
- }
53
- }
54
- FILE_PATH_PATTERN.lastIndex = 0;
55
- return paths;
56
- }
57
- function pathMatchesCodePaths(filePath, codePaths) {
58
- for (const pattern of codePaths) {
59
- if (filePath === pattern) {
60
- return true;
61
- }
62
- if (minimatch(filePath, pattern)) {
63
- return true;
64
- }
65
- }
66
- return false;
67
- }
68
- function validateAcceptanceCodePaths(wu) {
69
- const { id, code_paths = [] } = wu;
70
- const acceptance = Array.isArray(wu.acceptance) ? wu.acceptance : [];
71
- const errors = [];
72
- for (const criterion of acceptance) {
73
- const referencedPaths = extractFilePaths(criterion);
74
- for (const referencedPath of referencedPaths) {
75
- if (!pathMatchesCodePaths(referencedPath, code_paths)) {
76
- errors.push({
77
- type: WU_LINT_ERROR_TYPES.ACCEPTANCE_PATH_NOT_IN_CODE_PATHS,
78
- wuId: id,
79
- path: referencedPath,
80
- criterion,
81
- message: `Acceptance criterion references '${referencedPath}' which is not in code_paths`,
82
- suggestion: `Add '${referencedPath}' to code_paths or remove the reference from acceptance criteria`
83
- });
84
- }
85
- }
86
- }
87
- return {
88
- valid: errors.length === 0,
89
- errors
90
- };
91
- }
92
- function checkForbiddenFileInvariant(invariant, wu) {
93
- const { id, code_paths = [] } = wu;
94
- const acceptance = Array.isArray(wu.acceptance) ? wu.acceptance : [];
95
- const errors = [];
96
- if (code_paths.includes(invariant.path)) {
97
- errors.push({
98
- type: WU_LINT_ERROR_TYPES.CODE_PATH_CONFLICTS_INVARIANT,
99
- wuId: id,
100
- invariantId: invariant.id,
101
- path: invariant.path,
102
- message: `code_paths includes '${invariant.path}' which conflicts with invariant ${invariant.id}: ${invariant.description}`,
103
- suggestion: invariant.message || `Remove '${invariant.path}' from code_paths`
104
- });
105
- }
106
- for (const criterion of acceptance) {
107
- if (criterion.includes(invariant.path)) {
108
- errors.push({
109
- type: WU_LINT_ERROR_TYPES.ACCEPTANCE_CONFLICTS_INVARIANT,
110
- wuId: id,
111
- invariantId: invariant.id,
112
- path: invariant.path,
113
- criterion,
114
- message: `Acceptance criterion references forbidden file '${invariant.path}' (${invariant.id}: ${invariant.description})`,
115
- suggestion: invariant.message
116
- });
117
- }
118
- }
119
- return errors;
120
- }
121
- function checkMutualExclusivityInvariant(invariant, wu) {
122
- const { id, code_paths = [] } = wu;
123
- const errors = [];
124
- const conflictingPaths = invariant.paths.filter((p) => code_paths.includes(p));
125
- if (conflictingPaths.length > 1) {
126
- errors.push({
127
- type: WU_LINT_ERROR_TYPES.CODE_PATH_CONFLICTS_INVARIANT,
128
- wuId: id,
129
- invariantId: invariant.id,
130
- paths: conflictingPaths,
131
- message: `code_paths includes multiple mutually exclusive files (${invariant.id}): ${conflictingPaths.join(", ")}`,
132
- suggestion: invariant.message || `Only one of these files should exist: ${invariant.paths.join(", ")}`
133
- });
134
- }
135
- return errors;
136
- }
137
- function validateInvariantsCompliance(wu, invariants) {
138
- const errors = [];
139
- for (const invariant of invariants) {
140
- if (invariant.type === INVARIANT_TYPES.FORBIDDEN_FILE) {
141
- errors.push(...checkForbiddenFileInvariant(invariant, wu));
142
- } else if (invariant.type === INVARIANT_TYPES.MUTUAL_EXCLUSIVITY) {
143
- errors.push(...checkMutualExclusivityInvariant(invariant, wu));
144
- }
145
- }
146
- return {
147
- valid: errors.length === 0,
148
- errors
149
- };
150
- }
151
- var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
152
- WU_STATUS.DONE,
153
- WU_STATUS.CANCELLED,
154
- WU_STATUS.COMPLETED,
155
- WU_STATUS.ABANDONED,
156
- WU_STATUS.SUPERSEDED
157
- ]);
158
- var LINT_TYPE_BY_RULE_CODE = {
159
- [RULE_CODES.MINIMUM_TEST_INTENT]: WU_LINT_ERROR_TYPES.MINIMUM_TEST_INTENT_REQUIRED,
160
- [RULE_CODES.PARITY_MISSING_SURFACE]: WU_LINT_ERROR_TYPES.REGISTRATION_PARITY_MISSING
161
- };
162
- function toLintIssue(wuId, issue) {
163
- const normalized = normalizeValidationIssue(issue, {
164
- wuId,
165
- typeByCode: LINT_TYPE_BY_RULE_CODE
166
- });
167
- return {
168
- type: normalized.type,
169
- wuId,
170
- message: normalized.message,
171
- suggestion: normalized.suggestion
172
- };
173
- }
174
- function lintWUSpec(wu, options = {}) {
175
- const allErrors = [];
176
- const allWarnings = [];
177
- const phase = options.phase || "structural";
178
- const acceptanceResult = validateAcceptanceCodePaths(wu);
179
- allErrors.push(...acceptanceResult.errors);
180
- let invariants = options.invariants || [];
181
- if (!options.invariants && options.invariantsPath) {
182
- try {
183
- if (existsSync(options.invariantsPath)) {
184
- invariants = loadInvariants(options.invariantsPath);
185
- }
186
- } catch {
187
- }
188
- }
189
- if (invariants.length > 0) {
190
- const invariantsResult = validateInvariantsCompliance(wu, invariants);
191
- allErrors.push(...invariantsResult.errors);
192
- }
193
- const rulesResult = validateWURulesSync({
194
- id: wu.id,
195
- type: wu.type,
196
- status: wu.status,
197
- code_paths: wu.code_paths,
198
- tests: wu.tests || wu.test_paths,
199
- cwd: options.context?.cwd,
200
- baseRef: options.context?.baseRef,
201
- headRef: options.context?.headRef
202
- }, { phase });
203
- for (const issue of rulesResult.errors) {
204
- allErrors.push(toLintIssue(wu.id, issue));
205
- }
206
- for (const issue of rulesResult.warnings) {
207
- allWarnings.push(toLintIssue(wu.id, issue));
208
- }
209
- return {
210
- valid: allErrors.length === 0,
211
- errors: allErrors,
212
- warnings: allWarnings
213
- };
214
- }
215
- function formatLintErrors(errors) {
216
- if (errors.length === 0) {
217
- return "";
218
- }
219
- const lines = ["WU SPEC LINT ERRORS:", ""];
220
- for (const error of errors) {
221
- lines.push(`- ${error.message}`);
222
- if (error.suggestion) {
223
- lines.push(` Fix: ${error.suggestion}`);
224
- }
225
- lines.push("");
226
- }
227
- return lines.join("\n");
228
- }
229
-
230
- export {
231
- lintWUSpec,
232
- formatLintErrors
233
- };
@@ -1,297 +0,0 @@
1
- import {
2
- BLOCKED_EDIT_MODE,
3
- BRANCH_PR_EDIT_MODE,
4
- resolveInProgressEditMode
5
- } from "./chunk-B7YJYJKG.js";
6
- import {
7
- INIT_PATTERNS
8
- } from "./chunk-NAP6CFSO.js";
9
- import {
10
- INIT_PATHS
11
- } from "./chunk-ZHCZHZH3.js";
12
- import {
13
- createGitForPath
14
- } from "./chunk-2UFQ3A3C.js";
15
- import {
16
- parseYAML
17
- } from "./chunk-NRIZR3A7.js";
18
- import {
19
- WU_PATHS,
20
- defaultWorktreeFrom
21
- } from "./chunk-6HO4GWJE.js";
22
- import {
23
- FILE_SYSTEM
24
- } from "./chunk-DWMLTXKQ.js";
25
- import {
26
- WU_EXPOSURE_VALUES,
27
- WU_STATUS,
28
- getConfig
29
- } from "./chunk-V6OJGLBA.js";
30
- import {
31
- die
32
- } from "./chunk-RXRKBBSM.js";
33
-
34
- // src/wu-edit-validators.ts
35
- import { existsSync, readFileSync } from "fs";
36
- import { resolve, join, relative, isAbsolute } from "path";
37
- var EDIT_MODE = {
38
- /** Ready WUs: Use micro-worktree on main (existing behavior) */
39
- MICRO_WORKTREE: "micro_worktree",
40
- /** In-progress worktree WUs: Apply edits directly in active worktree (WU-1365) */
41
- WORKTREE: "worktree",
42
- /** In-progress branch-pr WUs: apply edits directly on the claimed branch */
43
- BRANCH_PR: BRANCH_PR_EDIT_MODE
44
- };
45
- function validateDoneWUEdits(opts) {
46
- const disallowedEdits = [];
47
- if (opts.specFile) disallowedEdits.push("--spec-file");
48
- if (opts.description) disallowedEdits.push("--description");
49
- if (opts.acceptance && Array.isArray(opts.acceptance) && opts.acceptance.length > 0) {
50
- disallowedEdits.push("--acceptance");
51
- }
52
- if (opts.notes) disallowedEdits.push("--notes");
53
- if (opts.codePaths && Array.isArray(opts.codePaths) && opts.codePaths.length > 0) {
54
- disallowedEdits.push("--code-paths");
55
- }
56
- if (opts.risks && Array.isArray(opts.risks) && opts.risks.length > 0) {
57
- disallowedEdits.push("--risks");
58
- }
59
- if (opts.lane) disallowedEdits.push("--lane");
60
- if (opts.type) disallowedEdits.push("--type");
61
- if (opts.priority) disallowedEdits.push("--priority");
62
- if (opts.testPathsManual && Array.isArray(opts.testPathsManual) && opts.testPathsManual.length > 0) {
63
- disallowedEdits.push("--test-paths-manual");
64
- }
65
- if (opts.testPathsUnit && Array.isArray(opts.testPathsUnit) && opts.testPathsUnit.length > 0) {
66
- disallowedEdits.push("--test-paths-unit");
67
- }
68
- if (opts.testPathsE2e && Array.isArray(opts.testPathsE2e) && opts.testPathsE2e.length > 0) {
69
- disallowedEdits.push("--test-paths-e2e");
70
- }
71
- return {
72
- valid: disallowedEdits.length === 0,
73
- disallowedEdits
74
- };
75
- }
76
- function validateExposureValue(exposure) {
77
- const validValues = WU_EXPOSURE_VALUES;
78
- if (!validValues.includes(exposure)) {
79
- return {
80
- valid: false,
81
- error: `Invalid exposure value: "${exposure}"
82
-
83
- Valid values: ${WU_EXPOSURE_VALUES.join(", ")}`
84
- };
85
- }
86
- return { valid: true };
87
- }
88
- function validateInitiativeFormat(initId) {
89
- if (!INIT_PATTERNS.INIT_ID.test(initId)) {
90
- die(
91
- `Invalid Initiative ID format: "${initId}"
92
-
93
- Expected format: INIT-<number> or INIT-<NAME> (e.g., INIT-001, INIT-TOOLING)`
94
- );
95
- }
96
- }
97
- function validateInitiativeExists(initId) {
98
- const initPath = INIT_PATHS.INITIATIVE(initId);
99
- if (!existsSync(initPath)) {
100
- die(`Initiative not found: ${initId}
101
-
102
- File does not exist: ${initPath}`);
103
- }
104
- return initPath;
105
- }
106
- function validateWUEditable(id) {
107
- const wuPath = WU_PATHS.WU(id);
108
- if (!existsSync(wuPath)) {
109
- die(`WU ${id} not found at ${wuPath}
110
-
111
- Ensure the WU exists and you're in the repo root.`);
112
- }
113
- const content = readFileSync(wuPath, { encoding: FILE_SYSTEM.ENCODING });
114
- const wu = parseYAML(content);
115
- if (wu.status === WU_STATUS.DONE) {
116
- return { wu, editMode: EDIT_MODE.MICRO_WORKTREE, isDone: true };
117
- }
118
- if (wu.status === WU_STATUS.IN_PROGRESS) {
119
- const editMode = resolveInProgressEditMode(
120
- typeof wu.claimed_mode === "string" ? wu.claimed_mode : void 0
121
- );
122
- if (editMode === BLOCKED_EDIT_MODE) {
123
- die(
124
- `Cannot edit branch-only WU ${id} via wu:edit.
125
-
126
- WUs claimed with claimed_mode='branch-only' cannot be edited via wu:edit.
127
- To modify the spec, edit the file directly on the lane branch and commit.`
128
- );
129
- }
130
- if (editMode === EDIT_MODE.BRANCH_PR) {
131
- return { wu, editMode: EDIT_MODE.BRANCH_PR, isDone: false };
132
- }
133
- const worktreeRelPath = defaultWorktreeFrom(wu);
134
- if (worktreeRelPath) {
135
- const worktreeWuPath = join(resolve(worktreeRelPath), WU_PATHS.WU(id));
136
- if (existsSync(worktreeWuPath)) {
137
- const worktreeContent = readFileSync(worktreeWuPath, {
138
- encoding: FILE_SYSTEM.ENCODING
139
- });
140
- const worktreeWu = parseYAML(worktreeContent);
141
- return { wu: worktreeWu, editMode: EDIT_MODE.WORKTREE, isDone: false };
142
- }
143
- }
144
- return { wu, editMode: EDIT_MODE.WORKTREE, isDone: false };
145
- }
146
- if (wu.status === WU_STATUS.READY) {
147
- return { wu, editMode: EDIT_MODE.MICRO_WORKTREE, isDone: false };
148
- }
149
- die(
150
- `Cannot edit WU ${id}: status is '${wu.status}'.
151
-
152
- Only WUs in '${WU_STATUS.READY}' or '${WU_STATUS.IN_PROGRESS}' (worktree mode) can be edited.`
153
- );
154
- }
155
- function validateWorktreeExists(worktreePath, id) {
156
- if (!existsSync(worktreePath)) {
157
- die(
158
- `Cannot edit WU ${id}: worktree path missing from disk.
159
-
160
- Expected worktree at: ${worktreePath}
161
-
162
- The worktree may have been removed or the path is incorrect.
163
- If the worktree was accidentally deleted, you may need to re-claim the WU.`
164
- );
165
- }
166
- }
167
- async function validateWorktreeClean(worktreePath, id) {
168
- try {
169
- const gitAdapter = createGitForPath(worktreePath);
170
- const status = (await gitAdapter.raw(["status", "--porcelain"])).trim();
171
- if (status !== "") {
172
- die(
173
- `Cannot edit WU ${id}: worktree has uncommitted changes.
174
-
175
- Uncommitted changes in ${worktreePath}:
176
- ${status}
177
-
178
- Commit or discard your changes before editing the WU spec:
179
- cd ${worktreePath}
180
- git add . && git commit -m "wip: save progress"
181
-
182
- Then retry wu:edit.`
183
- );
184
- }
185
- } catch (err) {
186
- die(
187
- `Cannot edit WU ${id}: failed to check worktree status.
188
-
189
- Error: ${err.message}
190
-
191
- Worktree path: ${worktreePath}`
192
- );
193
- }
194
- }
195
- async function validateWorktreeBranch(worktreePath, expectedBranch, id) {
196
- try {
197
- const gitAdapter = createGitForPath(worktreePath);
198
- const actualBranch = (await gitAdapter.raw(["rev-parse", "--abbrev-ref", "HEAD"])).trim();
199
- if (actualBranch !== expectedBranch) {
200
- die(
201
- `Cannot edit WU ${id}: worktree branch does not match expected lane branch.
202
-
203
- Expected branch: ${expectedBranch}
204
- Actual branch: ${actualBranch}
205
-
206
- This may indicate a corrupted worktree state.
207
- Verify the worktree is correctly set up for this WU.`
208
- );
209
- }
210
- } catch (err) {
211
- die(
212
- `Cannot edit WU ${id}: failed to check worktree branch.
213
-
214
- Error: ${err.message}
215
-
216
- Worktree path: ${worktreePath}`
217
- );
218
- }
219
- }
220
- function isPathWithin(rootPath, candidatePath) {
221
- const relativePath = relative(rootPath, candidatePath);
222
- return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute(relativePath);
223
- }
224
- function validateWorktreeExecutionContext(currentCwd, worktreePath, id, retryCommand) {
225
- const resolvedCwd = resolve(currentCwd);
226
- const resolvedWorktreePath = resolve(worktreePath);
227
- if (isPathWithin(resolvedWorktreePath, resolvedCwd)) {
228
- return;
229
- }
230
- const safeRetryCommand = typeof retryCommand === "string" && retryCommand.trim().length > 0 ? retryCommand.trim() : `pnpm wu:edit --id ${id} <edit-flags>`;
231
- die(
232
- `Cannot edit in_progress WU ${id} from this checkout.
233
-
234
- Current directory: ${resolvedCwd}
235
- Claimed worktree: ${resolvedWorktreePath}
236
-
237
- Run from the claimed worktree and retry:
238
- cd ${resolvedWorktreePath}
239
- ${safeRetryCommand}`
240
- );
241
- }
242
- function toPosixPath(filePath) {
243
- return filePath.replace(/\\/g, "/");
244
- }
245
- function getRuntimePathClassification(projectRoot) {
246
- const config = getConfig({ projectRoot });
247
- const stateEventsPath = toPosixPath(`${config.state.stateDir}/wu-events.jsonl`);
248
- const backlogPath = toPosixPath(config.directories.backlogPath);
249
- const statusPath = toPosixPath(config.directories.statusPath);
250
- const wuDirPrefix = toPosixPath(config.directories.wuDir).replace(/\/?$/, "/");
251
- return {
252
- nonScopeRelevantPaths: /* @__PURE__ */ new Set([stateEventsPath, backlogPath, statusPath]),
253
- wuDirPrefix
254
- };
255
- }
256
- function hasScopeRelevantBranchChanges(changedFiles) {
257
- const { nonScopeRelevantPaths, wuDirPrefix } = getRuntimePathClassification(process.cwd());
258
- return changedFiles.some((filePath) => {
259
- const normalized = toPosixPath(filePath.trim());
260
- if (!normalized) {
261
- return false;
262
- }
263
- if (nonScopeRelevantPaths.has(normalized)) {
264
- return false;
265
- }
266
- return !normalized.startsWith(wuDirPrefix);
267
- });
268
- }
269
- function normalizeReplaceCodePathsArgv(argv) {
270
- const normalized = [...argv];
271
- for (let i = 0; i < normalized.length; i += 1) {
272
- if (normalized[i] !== "--replace-code-paths") {
273
- continue;
274
- }
275
- const next = normalized[i + 1];
276
- if (next && !next.startsWith("-")) {
277
- normalized.splice(i + 1, 0, "--code-paths");
278
- i += 1;
279
- }
280
- }
281
- return normalized;
282
- }
283
-
284
- export {
285
- EDIT_MODE,
286
- validateDoneWUEdits,
287
- validateExposureValue,
288
- validateInitiativeFormat,
289
- validateInitiativeExists,
290
- validateWUEditable,
291
- validateWorktreeExists,
292
- validateWorktreeClean,
293
- validateWorktreeBranch,
294
- validateWorktreeExecutionContext,
295
- hasScopeRelevantBranchChanges,
296
- normalizeReplaceCodePathsArgv
297
- };