@lumenflow/cli 4.20.2 → 4.22.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 (131) hide show
  1. package/README.md +30 -27
  2. package/dist/config-set.js +54 -36
  3. package/dist/config-set.js.map +1 -1
  4. package/dist/delegation-list.js +86 -53
  5. package/dist/delegation-list.js.map +1 -1
  6. package/dist/gate-conditional.js +476 -0
  7. package/dist/gate-conditional.js.map +1 -0
  8. package/dist/gates-plan-resolvers.js +24 -1
  9. package/dist/gates-plan-resolvers.js.map +1 -1
  10. package/dist/init-templates.js +13 -0
  11. package/dist/init-templates.js.map +1 -1
  12. package/dist/initiative-create.js +1 -1
  13. package/dist/orchestrate-init-status.js +24 -31
  14. package/dist/orchestrate-init-status.js.map +1 -1
  15. package/dist/orchestrate-initiative.js +31 -2
  16. package/dist/orchestrate-initiative.js.map +1 -1
  17. package/dist/orchestrate-monitor.js +433 -1
  18. package/dist/orchestrate-monitor.js.map +1 -1
  19. package/dist/public-manifest.js +11 -4
  20. package/dist/public-manifest.js.map +1 -1
  21. package/package.json +9 -8
  22. package/packs/agent-runtime/.turbo/turbo-build.log +1 -1
  23. package/packs/agent-runtime/package.json +1 -1
  24. package/packs/sidekick/.turbo/turbo-build.log +1 -1
  25. package/packs/sidekick/package.json +1 -1
  26. package/packs/software-delivery/.turbo/turbo-build.log +1 -1
  27. package/packs/software-delivery/package.json +1 -1
  28. package/templates/core/LUMENFLOW.md.template +6 -3
  29. package/templates/core/ai/onboarding/first-wu-mistakes.md.template +2 -2
  30. package/templates/core/ai/onboarding/initiative-orchestration.md.template +83 -27
  31. package/templates/core/ai/onboarding/quick-ref-commands.md.template +9 -5
  32. package/templates/core/ai/onboarding/starting-prompt.md.template +1 -1
  33. package/templates/core/ai/onboarding/vendor-support.md.template +13 -0
  34. package/dist/chunk-2D2VOCA4.js +0 -37
  35. package/dist/chunk-2D5KFYGX.js +0 -284
  36. package/dist/chunk-2GXVIN57.js +0 -14072
  37. package/dist/chunk-2MQ7HZWZ.js +0 -26
  38. package/dist/chunk-2UFQ3A3C.js +0 -643
  39. package/dist/chunk-3RG5ZIWI.js +0 -10
  40. package/dist/chunk-4N74J3UT.js +0 -15
  41. package/dist/chunk-5GTOXFYR.js +0 -392
  42. package/dist/chunk-5VY6MQMC.js +0 -240
  43. package/dist/chunk-67XVPMRY.js +0 -1297
  44. package/dist/chunk-6HO4GWJE.js +0 -164
  45. package/dist/chunk-6W5XHWYV.js +0 -1890
  46. package/dist/chunk-6X4EMYJQ.js +0 -64
  47. package/dist/chunk-6XYXI2NQ.js +0 -772
  48. package/dist/chunk-7ANSOV6Q.js +0 -285
  49. package/dist/chunk-A624LFLB.js +0 -1380
  50. package/dist/chunk-ADN5NHG4.js +0 -126
  51. package/dist/chunk-B7YJYJKG.js +0 -33
  52. package/dist/chunk-CCLHCPKG.js +0 -210
  53. package/dist/chunk-CK36VROC.js +0 -1584
  54. package/dist/chunk-D3UOFRSB.js +0 -81
  55. package/dist/chunk-DFR4DJBM.js +0 -230
  56. package/dist/chunk-DSYBDHYH.js +0 -79
  57. package/dist/chunk-DWMLTXKQ.js +0 -1176
  58. package/dist/chunk-E3REJTAJ.js +0 -28
  59. package/dist/chunk-EA3IVO64.js +0 -633
  60. package/dist/chunk-EK2AKZKD.js +0 -55
  61. package/dist/chunk-ELD7JTTT.js +0 -343
  62. package/dist/chunk-EX6TT2XI.js +0 -195
  63. package/dist/chunk-EXINSFZE.js +0 -82
  64. package/dist/chunk-EZ6ZBYBM.js +0 -510
  65. package/dist/chunk-FBKAPTJ2.js +0 -16
  66. package/dist/chunk-FVLV5RYH.js +0 -1118
  67. package/dist/chunk-GDNSBQVK.js +0 -2485
  68. package/dist/chunk-GPQHMBNN.js +0 -278
  69. package/dist/chunk-GTFJB67L.js +0 -68
  70. package/dist/chunk-HANJXVKW.js +0 -1127
  71. package/dist/chunk-HEVS5YLD.js +0 -269
  72. package/dist/chunk-HMEVZKPQ.js +0 -9
  73. package/dist/chunk-HRGSYNLM.js +0 -3511
  74. package/dist/chunk-ISZR5N4K.js +0 -60
  75. package/dist/chunk-J6SUPR2C.js +0 -226
  76. package/dist/chunk-JERYVEIZ.js +0 -244
  77. package/dist/chunk-JHHWGL2N.js +0 -87
  78. package/dist/chunk-JONWQUB5.js +0 -775
  79. package/dist/chunk-K2DIWWDM.js +0 -1766
  80. package/dist/chunk-KY4PGL5V.js +0 -969
  81. package/dist/chunk-L737LQ4C.js +0 -1285
  82. package/dist/chunk-LFTWYIB2.js +0 -497
  83. package/dist/chunk-LV47RFNJ.js +0 -41
  84. package/dist/chunk-MKSAITI7.js +0 -15
  85. package/dist/chunk-MZ7RKIX4.js +0 -212
  86. package/dist/chunk-NAP6CFSO.js +0 -84
  87. package/dist/chunk-ND6MY37M.js +0 -16
  88. package/dist/chunk-NMG736UR.js +0 -683
  89. package/dist/chunk-NRAXROED.js +0 -32
  90. package/dist/chunk-NRIZR3A7.js +0 -690
  91. package/dist/chunk-NX43BG3M.js +0 -233
  92. package/dist/chunk-O645XLSI.js +0 -297
  93. package/dist/chunk-OMJD6A3S.js +0 -235
  94. package/dist/chunk-QB6SJD4T.js +0 -430
  95. package/dist/chunk-QFSTL4J3.js +0 -276
  96. package/dist/chunk-QLGDFMFX.js +0 -212
  97. package/dist/chunk-RIAAGL2E.js +0 -13
  98. package/dist/chunk-RWO5XMZ6.js +0 -86
  99. package/dist/chunk-RXRKBBSM.js +0 -149
  100. package/dist/chunk-RZOZMML6.js +0 -363
  101. package/dist/chunk-U7I7FS7T.js +0 -113
  102. package/dist/chunk-UI42RODY.js +0 -717
  103. package/dist/chunk-UTVMVSCO.js +0 -519
  104. package/dist/chunk-V6OJGLBA.js +0 -1746
  105. package/dist/chunk-W2JHVH7D.js +0 -152
  106. package/dist/chunk-WD3Y7VQN.js +0 -280
  107. package/dist/chunk-WOCTQ5MS.js +0 -303
  108. package/dist/chunk-WZR3ZUNN.js +0 -696
  109. package/dist/chunk-XGI665H7.js +0 -150
  110. package/dist/chunk-XKY65P2T.js +0 -304
  111. package/dist/chunk-Y4CQZY65.js +0 -57
  112. package/dist/chunk-YFEXKLVE.js +0 -194
  113. package/dist/chunk-YHO3HS5X.js +0 -287
  114. package/dist/chunk-YLS7AZSX.js +0 -738
  115. package/dist/chunk-ZE473AO6.js +0 -49
  116. package/dist/chunk-ZF747T3O.js +0 -644
  117. package/dist/chunk-ZHCZHZH3.js +0 -43
  118. package/dist/chunk-ZZNZX2XY.js +0 -87
  119. package/dist/constants-7QAP3VQ4.js +0 -23
  120. package/dist/dist-IY3UUMWK.js +0 -33
  121. package/dist/invariants-runner-W5RGHCSU.js +0 -27
  122. package/dist/lane-lock-6J36HD5O.js +0 -35
  123. package/dist/mem-checkpoint-core-EANG2GVN.js +0 -14
  124. package/dist/mem-signal-core-2LZ2WYHW.js +0 -19
  125. package/dist/memory-store-OLB5FO7K.js +0 -18
  126. package/dist/service-6BYCOCO5.js +0 -13
  127. package/dist/spawn-policy-resolver-NTSZYQ6R.js +0 -17
  128. package/dist/spawn-task-builder-R4E2BHSW.js +0 -22
  129. package/dist/wu-done-pr-WLFFFEPJ.js +0 -25
  130. package/dist/wu-done-validation-3J5E36FE.js +0 -30
  131. package/dist/wu-duplicate-id-detector-5S7JHELK.js +0 -232
@@ -1,717 +0,0 @@
1
- import {
2
- listTrackedWUStampIds
3
- } from "./chunk-LV47RFNJ.js";
4
- import {
5
- WU_EVENT_TYPE,
6
- withMicroWorktree
7
- } from "./chunk-2GXVIN57.js";
8
- import {
9
- createGitForPath
10
- } from "./chunk-2UFQ3A3C.js";
11
- import {
12
- normalizeToDateString,
13
- parseYAML,
14
- stringifyYAML,
15
- todayISO
16
- } from "./chunk-NRIZR3A7.js";
17
- import {
18
- createWuPaths
19
- } from "./chunk-6HO4GWJE.js";
20
- import {
21
- CONSISTENCY_MESSAGES,
22
- CONSISTENCY_TYPES,
23
- LOG_PREFIX,
24
- LUMENFLOW_PATHS,
25
- REMOTES,
26
- STRING_LITERALS,
27
- YAML_OPTIONS,
28
- toKebab
29
- } from "./chunk-DWMLTXKQ.js";
30
- import {
31
- WU_STATUS
32
- } from "./chunk-V6OJGLBA.js";
33
- import {
34
- ErrorCodes,
35
- createError
36
- } from "./chunk-RXRKBBSM.js";
37
-
38
- // ../core/dist/wu-consistency-detector.js
39
- import { readFile, readdir, access } from "fs/promises";
40
- import { constants } from "fs";
41
- import path from "path";
42
- var UNKNOWN_WU_STATUS = "unknown";
43
- function readOptionalStringField(value, fieldName) {
44
- if (typeof value !== "object" || value === null || Array.isArray(value)) {
45
- return void 0;
46
- }
47
- const fieldValue = Reflect.get(value, fieldName);
48
- return typeof fieldValue === "string" ? fieldValue : void 0;
49
- }
50
- function parseWUConsistencyDoc(content) {
51
- const parsed = parseYAML(content);
52
- return {
53
- status: readOptionalStringField(parsed, "status"),
54
- lane: readOptionalStringField(parsed, "lane"),
55
- title: readOptionalStringField(parsed, "title"),
56
- worktree_path: readOptionalStringField(parsed, "worktree_path")
57
- };
58
- }
59
- async function checkWUConsistency(id, projectRoot = process.cwd(), options = {}) {
60
- const errors = [];
61
- const paths = createWuPaths({ projectRoot });
62
- const wuPath = path.join(projectRoot, paths.WU(id));
63
- const stampPath = path.join(projectRoot, paths.STAMP(id));
64
- const backlogPath = path.join(projectRoot, paths.BACKLOG());
65
- const statusPath = path.join(projectRoot, paths.STATUS());
66
- try {
67
- await access(wuPath, constants.R_OK);
68
- } catch {
69
- return { valid: true, errors: [], stats: { wuExists: false } };
70
- }
71
- const wuContent = await readFile(wuPath, { encoding: "utf-8" });
72
- const wuDoc = parseWUConsistencyDoc(wuContent);
73
- const yamlStatus = wuDoc.status || UNKNOWN_WU_STATUS;
74
- const lane = wuDoc.lane || "";
75
- const title = wuDoc.title || "";
76
- const worktreePathFromYaml = wuDoc.worktree_path || "";
77
- let hasStampFile;
78
- try {
79
- await access(stampPath, constants.R_OK);
80
- hasStampFile = true;
81
- } catch {
82
- hasStampFile = false;
83
- }
84
- const trackedStampIds = options.trackedStampIds ?? await listTrackedWUStampIds({ projectRoot, stampsDir: paths.STAMPS_DIR() });
85
- const hasStamp = hasStampFile && (trackedStampIds === null || trackedStampIds.has(id));
86
- let backlogContent;
87
- try {
88
- backlogContent = await readFile(backlogPath, { encoding: "utf-8" });
89
- } catch {
90
- backlogContent = "";
91
- }
92
- const { inDone: backlogInDone, inProgress: backlogInProgress } = parseBacklogSections(backlogContent, id);
93
- let statusContent;
94
- try {
95
- statusContent = await readFile(statusPath, { encoding: "utf-8" });
96
- } catch {
97
- statusContent = "";
98
- }
99
- const { inProgress: statusInProgress } = parseStatusSections(statusContent, id);
100
- const normalizedId = id.toUpperCase();
101
- const hasWorktree = options.activeWorktreeIds !== void 0 ? options.activeWorktreeIds !== null && options.activeWorktreeIds.has(normalizedId) : await checkWorktreeExists(id, projectRoot);
102
- const worktreePathExists = await checkWorktreePathExists(worktreePathFromYaml);
103
- if (yamlStatus === WU_STATUS.DONE && statusInProgress) {
104
- errors.push({
105
- type: CONSISTENCY_TYPES.YAML_DONE_STATUS_IN_PROGRESS,
106
- wuId: id,
107
- description: `WU ${id} has status '${WU_STATUS.DONE}' in YAML but still appears in status.md In Progress section`,
108
- repairAction: "Remove from status.md In Progress section",
109
- canAutoRepair: true
110
- });
111
- }
112
- if (backlogInDone && backlogInProgress) {
113
- errors.push({
114
- type: CONSISTENCY_TYPES.BACKLOG_DUAL_SECTION,
115
- wuId: id,
116
- description: `WU ${id} appears in both Done and In Progress sections of backlog.md`,
117
- repairAction: "Remove from In Progress section (Done wins)",
118
- canAutoRepair: true
119
- });
120
- }
121
- if (yamlStatus === WU_STATUS.DONE && !hasStamp) {
122
- errors.push({
123
- type: CONSISTENCY_TYPES.YAML_DONE_NO_STAMP,
124
- wuId: id,
125
- title,
126
- description: `WU ${id} has status '${WU_STATUS.DONE}' but no stamp file exists`,
127
- repairAction: "Create stamp file",
128
- canAutoRepair: true
129
- });
130
- }
131
- if (yamlStatus === WU_STATUS.DONE && hasWorktree) {
132
- errors.push({
133
- type: CONSISTENCY_TYPES.ORPHAN_WORKTREE_DONE,
134
- wuId: id,
135
- lane,
136
- description: `WU ${id} has status '${WU_STATUS.DONE}' but still has an associated worktree`,
137
- repairAction: "Remove orphan worktree and lane branch",
138
- canAutoRepair: true
139
- });
140
- }
141
- if (hasStamp && yamlStatus !== WU_STATUS.DONE) {
142
- errors.push({
143
- type: CONSISTENCY_TYPES.STAMP_EXISTS_YAML_NOT_DONE,
144
- wuId: id,
145
- title,
146
- description: `WU ${id} has stamp file but YAML status is '${yamlStatus}' (not done)`,
147
- repairAction: "Update YAML to done+locked+completed",
148
- canAutoRepair: true
149
- });
150
- }
151
- if (worktreePathFromYaml && !worktreePathExists && (yamlStatus === WU_STATUS.IN_PROGRESS || yamlStatus === WU_STATUS.BLOCKED)) {
152
- errors.push({
153
- type: CONSISTENCY_TYPES.MISSING_WORKTREE_CLAIMED,
154
- wuId: id,
155
- title,
156
- description: CONSISTENCY_MESSAGES.MISSING_WORKTREE_CLAIMED(id, yamlStatus, worktreePathFromYaml),
157
- repairAction: CONSISTENCY_MESSAGES.MISSING_WORKTREE_CLAIMED_REPAIR,
158
- canAutoRepair: false
159
- });
160
- }
161
- return {
162
- valid: errors.length === 0,
163
- errors,
164
- stats: {
165
- yamlStatus,
166
- hasStamp,
167
- backlogInDone,
168
- backlogInProgress,
169
- statusInProgress,
170
- hasWorktree,
171
- worktreePathExists
172
- }
173
- };
174
- }
175
- async function checkAllWUConsistency(projectRoot = process.cwd()) {
176
- const paths = createWuPaths({ projectRoot });
177
- const wuDir = path.join(projectRoot, paths.WU_DIR());
178
- try {
179
- await access(wuDir, constants.R_OK);
180
- } catch {
181
- return { valid: true, errors: [], checked: 0 };
182
- }
183
- const allErrors = [];
184
- const wuFiles = (await readdir(wuDir)).filter((f) => /^WU-\d+\.yaml$/.test(f));
185
- const trackedStampIds = await listTrackedWUStampIds({
186
- projectRoot,
187
- stampsDir: paths.STAMPS_DIR()
188
- });
189
- const activeWorktreeIds = await listActiveWorktreeIds(projectRoot);
190
- for (const file of wuFiles) {
191
- const id = file.replace(".yaml", "");
192
- const report = await checkWUConsistency(id, projectRoot, {
193
- trackedStampIds,
194
- activeWorktreeIds
195
- });
196
- allErrors.push(...report.errors);
197
- }
198
- return {
199
- valid: allErrors.length === 0,
200
- errors: allErrors,
201
- checked: wuFiles.length
202
- };
203
- }
204
- async function checkLaneForOrphanDoneWU(lane, excludeId, projectRoot = process.cwd()) {
205
- const paths = createWuPaths({ projectRoot });
206
- const wuDir = path.join(projectRoot, paths.WU_DIR());
207
- const trackedStampIds = await listTrackedWUStampIds({
208
- projectRoot,
209
- stampsDir: paths.STAMPS_DIR()
210
- });
211
- try {
212
- await access(wuDir, constants.R_OK);
213
- } catch {
214
- return { valid: true, orphans: [] };
215
- }
216
- const orphans = [];
217
- const wuFiles = (await readdir(wuDir)).filter((f) => /^WU-\d+\.yaml$/.test(f));
218
- for (const file of wuFiles) {
219
- const id = file.replace(".yaml", "");
220
- if (id === excludeId)
221
- continue;
222
- const wuPath = path.join(wuDir, file);
223
- let wuContent;
224
- try {
225
- wuContent = await readFile(wuPath, { encoding: "utf-8" });
226
- } catch {
227
- continue;
228
- }
229
- let wuDoc;
230
- try {
231
- wuDoc = parseYAML(wuContent);
232
- } catch {
233
- continue;
234
- }
235
- if (wuDoc?.lane === lane && wuDoc?.status === WU_STATUS.DONE) {
236
- const report = await checkWUConsistency(id, projectRoot, { trackedStampIds });
237
- if (!report.valid) {
238
- orphans.push({ id, errors: report.errors });
239
- }
240
- }
241
- }
242
- return {
243
- valid: orphans.length === 0,
244
- orphans: orphans.map((o) => o.id),
245
- reports: orphans
246
- };
247
- }
248
- function parseBacklogSections(content, id) {
249
- const lines = content.split(/\r?\n/);
250
- let inDone = false;
251
- let inProgress = false;
252
- let currentSection = null;
253
- const exactPattern = `(wu/${id}.yaml)`;
254
- for (const line of lines) {
255
- if (line.trim() === "## \u2705 Done") {
256
- currentSection = WU_STATUS.DONE;
257
- continue;
258
- }
259
- if (line.trim() === "## \u{1F527} In progress") {
260
- currentSection = WU_STATUS.IN_PROGRESS;
261
- continue;
262
- }
263
- if (line.trim().startsWith("## ")) {
264
- currentSection = null;
265
- continue;
266
- }
267
- if (line.includes(exactPattern)) {
268
- if (currentSection === WU_STATUS.DONE)
269
- inDone = true;
270
- if (currentSection === WU_STATUS.IN_PROGRESS)
271
- inProgress = true;
272
- }
273
- }
274
- return { inDone, inProgress };
275
- }
276
- function parseStatusSections(content, id) {
277
- const lines = content.split(/\r?\n/);
278
- let inProgress = false;
279
- let currentSection = null;
280
- const exactPattern = `(wu/${id}.yaml)`;
281
- for (const line of lines) {
282
- if (line.trim() === "## In Progress") {
283
- currentSection = WU_STATUS.IN_PROGRESS;
284
- continue;
285
- }
286
- if (line.trim().startsWith("## ")) {
287
- currentSection = null;
288
- continue;
289
- }
290
- if (currentSection === WU_STATUS.IN_PROGRESS && line.includes(exactPattern)) {
291
- inProgress = true;
292
- }
293
- }
294
- return { inProgress };
295
- }
296
- async function checkWorktreeExists(id, projectRoot) {
297
- try {
298
- const git = createGitForPath(projectRoot);
299
- const output = await git.worktreeList();
300
- const pattern = new RegExp(`${id.toLowerCase()}(?![0-9])`, "i");
301
- return pattern.test(output);
302
- } catch {
303
- return false;
304
- }
305
- }
306
- async function listActiveWorktreeIds(projectRoot) {
307
- try {
308
- const git = createGitForPath(projectRoot);
309
- const output = await git.worktreeList();
310
- const matches = output.match(/\bwu-\d+\b/gi) ?? [];
311
- const ids = /* @__PURE__ */ new Set();
312
- for (const match of matches) {
313
- ids.add(match.toUpperCase());
314
- }
315
- return ids;
316
- } catch {
317
- return null;
318
- }
319
- }
320
- async function checkWorktreePathExists(worktreePath) {
321
- if (!worktreePath) {
322
- return false;
323
- }
324
- try {
325
- await access(worktreePath, constants.R_OK);
326
- return true;
327
- } catch {
328
- return false;
329
- }
330
- }
331
-
332
- // ../core/dist/wu-consistency-file-repairs.js
333
- import path2 from "path";
334
- import { existsSync, mkdirSync, writeFileSync, readFileSync, constants as constants2 } from "fs";
335
- import { access as access2 } from "fs/promises";
336
- async function createStampInWorktree(id, title, worktreePath, projectRoot) {
337
- const paths = createWuPaths({ projectRoot });
338
- const stampsDir = path2.join(worktreePath, paths.STAMPS_DIR());
339
- const stampRelPath = paths.STAMP(id);
340
- const stampAbsPath = path2.join(worktreePath, stampRelPath);
341
- if (!existsSync(stampsDir)) {
342
- mkdirSync(stampsDir, { recursive: true });
343
- }
344
- if (existsSync(stampAbsPath)) {
345
- return [];
346
- }
347
- const body = `WU ${id} \u2014 ${title}
348
- Completed: ${todayISO()}
349
- `;
350
- writeFileSync(stampAbsPath, body, { encoding: "utf-8" });
351
- return [stampRelPath];
352
- }
353
- async function updateYamlToDoneInWorktree(id, worktreePath, projectRoot) {
354
- const paths = createWuPaths({ projectRoot });
355
- const wuRelPath = paths.WU(id);
356
- const wuSrcPath = path2.join(projectRoot, wuRelPath);
357
- const wuDestPath = path2.join(worktreePath, wuRelPath);
358
- const wuReadPath = existsSync(wuDestPath) ? wuDestPath : wuSrcPath;
359
- const content = readFileSync(wuReadPath, { encoding: "utf-8" });
360
- const wuDoc = parseYAML(content);
361
- if (!wuDoc) {
362
- throw createError(ErrorCodes.YAML_PARSE_ERROR, `Failed to parse WU YAML: ${wuReadPath}`);
363
- }
364
- wuDoc.status = WU_STATUS.DONE;
365
- wuDoc.locked = true;
366
- const existingCompletedAt = wuDoc.completed_at;
367
- const completionTimestamp = typeof existingCompletedAt === "string" ? existingCompletedAt : existingCompletedAt instanceof Date ? existingCompletedAt.toISOString() : (/* @__PURE__ */ new Date()).toISOString();
368
- wuDoc.completed_at = completionTimestamp;
369
- wuDoc.completed = normalizeToDateString(wuDoc.completed ?? completionTimestamp) ?? completionTimestamp.slice(0, 10);
370
- const wuDir = path2.dirname(wuDestPath);
371
- if (!existsSync(wuDir)) {
372
- mkdirSync(wuDir, { recursive: true });
373
- }
374
- const updatedContent = stringifyYAML(wuDoc, { lineWidth: YAML_OPTIONS.LINE_WIDTH });
375
- writeFileSync(wuDestPath, updatedContent, { encoding: "utf-8" });
376
- const eventFiles = appendReconciliationEventsInWorktree({
377
- id,
378
- lane: wuDoc.lane,
379
- title: wuDoc.title,
380
- projectRoot,
381
- worktreePath
382
- });
383
- return [wuRelPath, ...eventFiles];
384
- }
385
- function deriveStatusFromEvents(eventsContent, wuId) {
386
- let status;
387
- const lines = eventsContent.split(/\r?\n/);
388
- for (const line of lines) {
389
- if (!line.trim())
390
- continue;
391
- try {
392
- const event = JSON.parse(line);
393
- if (event.wuId !== wuId || !event.type)
394
- continue;
395
- switch (event.type) {
396
- case WU_EVENT_TYPE.CLAIM:
397
- case WU_EVENT_TYPE.CREATE:
398
- status = WU_STATUS.IN_PROGRESS;
399
- break;
400
- case WU_EVENT_TYPE.RELEASE:
401
- status = WU_STATUS.READY;
402
- break;
403
- case WU_EVENT_TYPE.COMPLETE:
404
- status = WU_STATUS.DONE;
405
- break;
406
- case WU_EVENT_TYPE.BLOCK:
407
- status = WU_STATUS.BLOCKED;
408
- break;
409
- case WU_EVENT_TYPE.UNBLOCK:
410
- status = WU_STATUS.IN_PROGRESS;
411
- break;
412
- }
413
- } catch {
414
- }
415
- }
416
- return status;
417
- }
418
- function appendReconciliationEventsInWorktree({ id, lane, title, projectRoot, worktreePath }) {
419
- const eventsRelPath = LUMENFLOW_PATHS.WU_EVENTS;
420
- const eventsSrcPath = path2.join(projectRoot, eventsRelPath);
421
- const eventsDestPath = path2.join(worktreePath, eventsRelPath);
422
- const eventsReadPath = existsSync(eventsDestPath) ? eventsDestPath : eventsSrcPath;
423
- const existingContent = existsSync(eventsReadPath) ? readFileSync(eventsReadPath, { encoding: "utf-8" }) : "";
424
- const derivedStatus = deriveStatusFromEvents(existingContent, id);
425
- if (derivedStatus === WU_STATUS.DONE) {
426
- return [];
427
- }
428
- const now = (/* @__PURE__ */ new Date()).toISOString();
429
- const appendEvents = [];
430
- if (derivedStatus !== WU_STATUS.IN_PROGRESS) {
431
- appendEvents.push({
432
- type: WU_EVENT_TYPE.CLAIM,
433
- wuId: id,
434
- lane: typeof lane === "string" && lane.trim().length > 0 ? lane : "Operations: Tooling",
435
- title: typeof title === "string" && title.trim().length > 0 ? title : `WU ${id}`,
436
- timestamp: now
437
- });
438
- }
439
- appendEvents.push({
440
- type: WU_EVENT_TYPE.COMPLETE,
441
- wuId: id,
442
- reason: "wu:repair consistency reconciliation for stamp/yaml mismatch",
443
- timestamp: now
444
- });
445
- const destDir = path2.dirname(eventsDestPath);
446
- if (!existsSync(destDir)) {
447
- mkdirSync(destDir, { recursive: true });
448
- }
449
- const suffix = appendEvents.map((event) => JSON.stringify(event)).join(STRING_LITERALS.NEWLINE);
450
- const normalizedExisting = existingContent ? existingContent.endsWith(STRING_LITERALS.NEWLINE) ? existingContent : `${existingContent}${STRING_LITERALS.NEWLINE}` : "";
451
- writeFileSync(eventsDestPath, `${normalizedExisting}${suffix}${STRING_LITERALS.NEWLINE}`, {
452
- encoding: "utf-8"
453
- });
454
- return [eventsRelPath];
455
- }
456
- async function removeWUFromSectionInWorktree(relFilePath, id, sectionHeading, worktreePath, projectRoot) {
457
- const srcPath = path2.join(projectRoot, relFilePath);
458
- const destPath = path2.join(worktreePath, relFilePath);
459
- if (!existsSync(srcPath)) {
460
- return [];
461
- }
462
- const content = readFileSync(srcPath, { encoding: "utf-8" });
463
- const lines = content.split(/\r?\n/);
464
- let inTargetSection = false;
465
- let nextSectionIdx = -1;
466
- let sectionStartIdx = -1;
467
- const normalizedHeading = sectionHeading.toLowerCase().trim();
468
- for (let i = 0; i < lines.length; i++) {
469
- const currentLine = lines[i] ?? "";
470
- const normalizedLine = currentLine.toLowerCase().trim();
471
- if (normalizedLine === normalizedHeading || normalizedLine.startsWith(normalizedHeading)) {
472
- inTargetSection = true;
473
- sectionStartIdx = i;
474
- continue;
475
- }
476
- if (inTargetSection && currentLine.trim().startsWith("## ")) {
477
- nextSectionIdx = i;
478
- break;
479
- }
480
- }
481
- if (sectionStartIdx === -1)
482
- return [];
483
- const endIdx = nextSectionIdx === -1 ? lines.length : nextSectionIdx;
484
- const newLines = [];
485
- let modified = false;
486
- for (let i = 0; i < lines.length; i++) {
487
- const currentLine = lines[i] ?? "";
488
- if (i > sectionStartIdx && i < endIdx && currentLine.includes(id)) {
489
- modified = true;
490
- continue;
491
- }
492
- newLines.push(currentLine);
493
- }
494
- if (!modified)
495
- return [];
496
- const destDir = path2.dirname(destPath);
497
- if (!existsSync(destDir)) {
498
- mkdirSync(destDir, { recursive: true });
499
- }
500
- writeFileSync(destPath, newLines.join(STRING_LITERALS.NEWLINE), { encoding: "utf-8" });
501
- return [relFilePath];
502
- }
503
- async function removeOrphanWorktree(id, lane, projectRoot) {
504
- const laneKebab = toKebab(lane);
505
- const worktreeName = `${laneKebab}-${id.toLowerCase()}`;
506
- const worktreePath = path2.join(projectRoot, "worktrees", worktreeName);
507
- const cwd = process.cwd();
508
- if (cwd.startsWith(worktreePath)) {
509
- return { skipped: true, reason: "Cannot delete worktree while inside it" };
510
- }
511
- try {
512
- await access2(worktreePath, constants2.R_OK);
513
- try {
514
- const gitWorktree = createGitForPath(worktreePath);
515
- const status = await gitWorktree.getStatus();
516
- if (status.trim().length > 0) {
517
- return { skipped: true, reason: "Worktree has uncommitted changes" };
518
- }
519
- } catch {
520
- }
521
- } catch {
522
- }
523
- const paths = createWuPaths({ projectRoot });
524
- const stampPath = path2.join(projectRoot, paths.STAMP(id));
525
- try {
526
- await access2(stampPath, constants2.R_OK);
527
- } catch {
528
- return { skipped: true, reason: "WU marked done but no stamp - possible rollback state" };
529
- }
530
- const git = createGitForPath(projectRoot);
531
- try {
532
- await access2(worktreePath, constants2.R_OK);
533
- await git.worktreeRemove(worktreePath, { force: true });
534
- } catch {
535
- }
536
- const branchName = `lane/${laneKebab}/${id.toLowerCase()}`;
537
- try {
538
- await git.deleteBranch(branchName, { force: true });
539
- } catch {
540
- }
541
- try {
542
- await git.raw(["push", REMOTES.ORIGIN, "--delete", branchName]);
543
- } catch {
544
- }
545
- return { success: true };
546
- }
547
-
548
- // ../core/dist/wu-inconsistency-repairer.js
549
- var FILE_REPAIR_STRATEGIES = {
550
- [CONSISTENCY_TYPES.YAML_DONE_NO_STAMP]: async (error, worktreePath, projectRoot) => {
551
- const files = await createStampInWorktree(error.wuId, error.title || `WU ${error.wuId}`, worktreePath, projectRoot);
552
- return { success: true, files };
553
- },
554
- [CONSISTENCY_TYPES.YAML_DONE_STATUS_IN_PROGRESS]: async (error, worktreePath, projectRoot) => {
555
- const paths = createWuPaths({ projectRoot });
556
- const files = await removeWUFromSectionInWorktree(paths.STATUS(), error.wuId, "## In Progress", worktreePath, projectRoot);
557
- return { success: true, files };
558
- },
559
- [CONSISTENCY_TYPES.BACKLOG_DUAL_SECTION]: async (error, worktreePath, projectRoot) => {
560
- const paths = createWuPaths({ projectRoot });
561
- const files = await removeWUFromSectionInWorktree(paths.BACKLOG(), error.wuId, "## \u{1F527} In progress", worktreePath, projectRoot);
562
- return { success: true, files };
563
- },
564
- [CONSISTENCY_TYPES.STAMP_EXISTS_YAML_NOT_DONE]: async (error, worktreePath, projectRoot) => {
565
- const files = await updateYamlToDoneInWorktree(error.wuId, worktreePath, projectRoot);
566
- return { success: true, files };
567
- }
568
- };
569
- var GIT_REPAIR_STRATEGIES = {
570
- [CONSISTENCY_TYPES.ORPHAN_WORKTREE_DONE]: async (error, projectRoot) => {
571
- if (!error.lane) {
572
- return { skipped: true, reason: "Missing lane metadata for orphan worktree cleanup" };
573
- }
574
- return await removeOrphanWorktree(error.wuId, error.lane, projectRoot);
575
- }
576
- };
577
- function categorizeErrors(errors) {
578
- const fileRepairs = [];
579
- const gitOnlyRepairs = [];
580
- const nonRepairable = [];
581
- for (const error of errors) {
582
- if (!error.canAutoRepair) {
583
- nonRepairable.push(error);
584
- continue;
585
- }
586
- if (error.type in GIT_REPAIR_STRATEGIES) {
587
- gitOnlyRepairs.push(error);
588
- } else {
589
- fileRepairs.push(error);
590
- }
591
- }
592
- return { fileRepairs, gitOnlyRepairs, nonRepairable };
593
- }
594
- async function repairSingleErrorInWorktree(error, worktreePath, projectRoot) {
595
- const strategy = FILE_REPAIR_STRATEGIES[error.type];
596
- if (!strategy) {
597
- return { skipped: true, reason: `Unknown error type: ${error.type}` };
598
- }
599
- return strategy(error, worktreePath, projectRoot);
600
- }
601
- async function repairGitOnlyError(error, projectRoot) {
602
- const strategy = GIT_REPAIR_STRATEGIES[error.type];
603
- if (!strategy) {
604
- return { skipped: true, reason: `Unknown git-only error type: ${error.type}` };
605
- }
606
- return strategy(error, projectRoot);
607
- }
608
- async function repairWUInconsistency(report, options = {}) {
609
- const { dryRun = false, projectRoot } = options;
610
- const isInsideMicroWorktree = projectRoot !== void 0;
611
- const effectiveProjectRoot = projectRoot ?? process.cwd();
612
- if (report.valid) {
613
- return { repaired: 0, skipped: 0, failed: 0 };
614
- }
615
- const { fileRepairs, gitOnlyRepairs, nonRepairable } = categorizeErrors(report.errors);
616
- let repaired = 0;
617
- let skipped = nonRepairable.length;
618
- let failed = 0;
619
- if (dryRun) {
620
- return {
621
- repaired: fileRepairs.length + gitOnlyRepairs.length,
622
- skipped,
623
- failed: 0
624
- };
625
- }
626
- if (fileRepairs.length > 0) {
627
- if (isInsideMicroWorktree) {
628
- for (const error of fileRepairs) {
629
- try {
630
- const result = await repairSingleErrorInWorktree(error, effectiveProjectRoot, effectiveProjectRoot);
631
- if (result.success && result.files) {
632
- repaired++;
633
- } else if (result.skipped) {
634
- skipped++;
635
- if (result.reason) {
636
- console.warn(`${LOG_PREFIX.REPAIR} Skipped ${error.type}: ${result.reason}`);
637
- }
638
- } else {
639
- failed++;
640
- }
641
- } catch (err) {
642
- const errMessage = err instanceof Error ? err.message : String(err);
643
- console.error(`${LOG_PREFIX.REPAIR} Failed to repair ${error.type}: ${errMessage}`);
644
- failed++;
645
- }
646
- }
647
- } else {
648
- try {
649
- const batchId = `batch-${fileRepairs.map((e) => e.wuId).join("-")}`.slice(0, 50);
650
- await withMicroWorktree({
651
- operation: "wu-repair",
652
- id: batchId,
653
- logPrefix: LOG_PREFIX.REPAIR,
654
- execute: async ({ worktreePath }) => {
655
- const filesModified = [];
656
- for (const error of fileRepairs) {
657
- try {
658
- const result = await repairSingleErrorInWorktree(error, worktreePath, worktreePath);
659
- if (result.success && result.files) {
660
- filesModified.push(...result.files);
661
- repaired++;
662
- } else if (result.skipped) {
663
- skipped++;
664
- if (result.reason) {
665
- console.warn(`${LOG_PREFIX.REPAIR} Skipped ${error.type}: ${result.reason}`);
666
- }
667
- } else {
668
- failed++;
669
- }
670
- } catch (err) {
671
- const errMessage = err instanceof Error ? err.message : String(err);
672
- console.error(`${LOG_PREFIX.REPAIR} Failed to repair ${error.type}: ${errMessage}`);
673
- failed++;
674
- }
675
- }
676
- const uniqueFiles = [...new Set(filesModified)];
677
- return {
678
- commitMessage: `fix: repair ${repaired} WU inconsistencies`,
679
- files: uniqueFiles
680
- };
681
- }
682
- });
683
- } catch (err) {
684
- const errMessage = err instanceof Error ? err.message : String(err);
685
- console.error(`${LOG_PREFIX.REPAIR} Micro-worktree operation failed: ${errMessage}`);
686
- failed += fileRepairs.length - repaired;
687
- }
688
- }
689
- }
690
- for (const error of gitOnlyRepairs) {
691
- try {
692
- const result = await repairGitOnlyError(error, effectiveProjectRoot);
693
- if (result.success) {
694
- repaired++;
695
- } else if (result.skipped) {
696
- skipped++;
697
- if (result.reason) {
698
- console.warn(`${LOG_PREFIX.REPAIR} Skipped ${error.type}: ${result.reason}`);
699
- }
700
- } else {
701
- failed++;
702
- }
703
- } catch (err) {
704
- const errMessage = err instanceof Error ? err.message : String(err);
705
- console.error(`${LOG_PREFIX.REPAIR} Failed to repair ${error.type}: ${errMessage}`);
706
- failed++;
707
- }
708
- }
709
- return { repaired, skipped, failed };
710
- }
711
-
712
- export {
713
- checkWUConsistency,
714
- checkAllWUConsistency,
715
- checkLaneForOrphanDoneWU,
716
- repairWUInconsistency
717
- };