@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,49 +0,0 @@
1
- import {
2
- MS_PER_DAY
3
- } from "./chunk-V6OJGLBA.js";
4
-
5
- // ../memory/dist/decay/scoring.js
6
- var DEFAULT_HALF_LIFE_MS = 30 * MS_PER_DAY;
7
- var IMPORTANCE_BY_PRIORITY = {
8
- P0: 2,
9
- P1: 1.5,
10
- P2: 1,
11
- P3: 0.5
12
- };
13
- var DEFAULT_IMPORTANCE = 1;
14
- function getNodeTimestamp(node) {
15
- const createdAt = new Date(node.created_at).getTime();
16
- if (!node.updated_at) {
17
- return createdAt;
18
- }
19
- const updatedAt = new Date(node.updated_at).getTime();
20
- return Math.max(createdAt, updatedAt);
21
- }
22
- function computeRecencyScore(node, halfLifeMs = DEFAULT_HALF_LIFE_MS, now = Date.now()) {
23
- const nodeTimestamp = getNodeTimestamp(node);
24
- const age = now - nodeTimestamp;
25
- return Math.exp(-age / halfLifeMs);
26
- }
27
- function computeAccessScore(node) {
28
- const accessCount = node.metadata?.access?.count ?? 0;
29
- return Math.log1p(accessCount) / 10;
30
- }
31
- function computeImportanceScore(node) {
32
- const priority = node.metadata?.priority;
33
- if (!priority) {
34
- return DEFAULT_IMPORTANCE;
35
- }
36
- return IMPORTANCE_BY_PRIORITY[priority] ?? DEFAULT_IMPORTANCE;
37
- }
38
- function computeDecayScore(node, options = {}) {
39
- const { now = Date.now(), halfLifeMs = DEFAULT_HALF_LIFE_MS } = options;
40
- const recencyScore = computeRecencyScore(node, halfLifeMs, now);
41
- const accessScore = computeAccessScore(node);
42
- const importanceScore = computeImportanceScore(node);
43
- return recencyScore * (1 + accessScore) * importanceScore;
44
- }
45
-
46
- export {
47
- DEFAULT_HALF_LIFE_MS,
48
- computeDecayScore
49
- };
@@ -1,644 +0,0 @@
1
- import {
2
- detectLaneOverlaps,
3
- loadLaneDefinitions
4
- } from "./chunk-XKY65P2T.js";
5
- import {
6
- createWUParser,
7
- detectMissingTrackedWorktrees,
8
- detectOrphanWorktrees,
9
- runCLI
10
- } from "./chunk-2GXVIN57.js";
11
- import {
12
- createWuPaths
13
- } from "./chunk-6HO4GWJE.js";
14
- import {
15
- CONFIG_FILES
16
- } from "./chunk-DWMLTXKQ.js";
17
- import {
18
- WORKSPACE_CONFIG_FILE_NAME,
19
- getConfig,
20
- getConfigFilePresence,
21
- getResolvedPaths
22
- } from "./chunk-V6OJGLBA.js";
23
-
24
- // src/doctor.ts
25
- import * as fs from "fs";
26
- import * as path from "path";
27
- import { execFileSync } from "child_process";
28
- var MANAGED_FILE_PATTERNS = [
29
- WORKSPACE_CONFIG_FILE_NAME,
30
- CONFIG_FILES.LANE_INFERENCE,
31
- "AGENTS.md",
32
- "CLAUDE.md"
33
- ];
34
- var DOCTOR_OPTIONS = {
35
- verbose: {
36
- name: "verbose",
37
- flags: "-v, --verbose",
38
- description: "Show detailed output including all checks"
39
- },
40
- json: {
41
- name: "json",
42
- flags: "--json",
43
- description: "Output results as JSON"
44
- },
45
- deep: {
46
- name: "deep",
47
- flags: "--deep",
48
- description: "Run heavier checks including WU validation (slower)"
49
- }
50
- };
51
- function parseDoctorOptions() {
52
- const opts = createWUParser({
53
- name: "lumenflow-doctor",
54
- description: "Check LumenFlow safety components and configuration",
55
- options: Object.values(DOCTOR_OPTIONS)
56
- });
57
- return {
58
- verbose: opts.verbose ?? false,
59
- json: opts.json ?? false,
60
- deep: opts.deep ?? false
61
- };
62
- }
63
- function checkHusky(projectDir) {
64
- const huskyDir = path.join(projectDir, ".husky");
65
- const preCommit = path.join(huskyDir, "pre-commit");
66
- if (!fs.existsSync(huskyDir)) {
67
- return {
68
- passed: false,
69
- message: "Husky hooks not installed",
70
- details: "Run: pnpm install && pnpm prepare"
71
- };
72
- }
73
- if (!fs.existsSync(preCommit)) {
74
- return {
75
- passed: false,
76
- message: "Husky pre-commit hook missing",
77
- details: "Run: pnpm prepare"
78
- };
79
- }
80
- return {
81
- passed: true,
82
- message: "Husky hooks installed (.husky/pre-commit)"
83
- };
84
- }
85
- function checkSafeGit(projectDir) {
86
- let safeGitPath;
87
- try {
88
- const resolved = getResolvedPaths({ projectRoot: projectDir, strictWorkspace: true });
89
- safeGitPath = resolved.safeGitPath;
90
- } catch {
91
- safeGitPath = path.join(projectDir, "scripts", "safe-git");
92
- }
93
- const relativePath = path.relative(projectDir, safeGitPath);
94
- if (!fs.existsSync(safeGitPath)) {
95
- return {
96
- passed: false,
97
- message: "Safe-git wrapper missing",
98
- details: `The ${relativePath} file should exist to block destructive git commands`
99
- };
100
- }
101
- return {
102
- passed: true,
103
- message: `Safe-git wrapper present (${relativePath})`
104
- };
105
- }
106
- function checkAgentsMd(projectDir) {
107
- const agentsMdPath = path.join(projectDir, "AGENTS.md");
108
- if (!fs.existsSync(agentsMdPath)) {
109
- return {
110
- passed: false,
111
- message: "AGENTS.md missing",
112
- details: "Run: lumenflow init to create universal agent instructions"
113
- };
114
- }
115
- return {
116
- passed: true,
117
- message: "AGENTS.md exists"
118
- };
119
- }
120
- function checkLumenflowConfig(projectDir) {
121
- const { workspaceConfigExists } = getConfigFilePresence(projectDir);
122
- if (!workspaceConfigExists) {
123
- return {
124
- passed: false,
125
- message: `${WORKSPACE_CONFIG_FILE_NAME} missing`,
126
- details: `Run: pnpm workspace-init --yes`
127
- };
128
- }
129
- return {
130
- passed: true,
131
- message: `Workspace config present (${WORKSPACE_CONFIG_FILE_NAME})`
132
- };
133
- }
134
- function checkVendorConfigs(projectDir) {
135
- const claudeMdPath = path.join(projectDir, "CLAUDE.md");
136
- const cursorRulesPath = path.join(projectDir, ".cursor", "rules", "lumenflow.md");
137
- const windsurfRulesPath = path.join(projectDir, ".windsurf", "rules", "lumenflow.md");
138
- const clineRulesPath = path.join(projectDir, ".clinerules");
139
- const agentsMdPath = path.join(projectDir, "AGENTS.md");
140
- return {
141
- claude: {
142
- present: fs.existsSync(claudeMdPath),
143
- path: "CLAUDE.md"
144
- },
145
- cursor: {
146
- present: fs.existsSync(cursorRulesPath),
147
- path: ".cursor/rules/lumenflow.md"
148
- },
149
- windsurf: {
150
- present: fs.existsSync(windsurfRulesPath),
151
- path: ".windsurf/rules/lumenflow.md"
152
- },
153
- cline: {
154
- present: fs.existsSync(clineRulesPath),
155
- path: ".clinerules"
156
- },
157
- codex: {
158
- // Codex reads AGENTS.md directly
159
- present: fs.existsSync(agentsMdPath),
160
- path: "AGENTS.md"
161
- }
162
- };
163
- }
164
- function getCommandVersion(command, args) {
165
- try {
166
- const output = execFileSync(command, args, {
167
- encoding: "utf-8",
168
- stdio: ["pipe", "pipe", "pipe"]
169
- }).trim();
170
- return output;
171
- } catch {
172
- return "not found";
173
- }
174
- }
175
- function parseVersion(versionStr) {
176
- const match = versionStr.match(/(\d+)\.(\d+)\.?(\d+)?/);
177
- if (!match) {
178
- return [0, 0, 0];
179
- }
180
- return [parseInt(match[1], 10), parseInt(match[2], 10), parseInt(match[3] || "0", 10)];
181
- }
182
- function compareVersions(actual, required) {
183
- const actualParts = parseVersion(actual);
184
- const requiredParts = parseVersion(required);
185
- for (let i = 0; i < 3; i++) {
186
- if (actualParts[i] > requiredParts[i]) {
187
- return true;
188
- }
189
- if (actualParts[i] < requiredParts[i]) {
190
- return false;
191
- }
192
- }
193
- return true;
194
- }
195
- function checkLaneHealth(projectDir) {
196
- const lanes = loadLaneDefinitions(projectDir);
197
- if (lanes.length === 0) {
198
- return {
199
- passed: true,
200
- message: "No lane definitions found - skipping lane health check"
201
- };
202
- }
203
- const overlapResult = detectLaneOverlaps(lanes);
204
- if (overlapResult.hasOverlaps) {
205
- const overlapCount = overlapResult.overlaps.length;
206
- const firstOverlap = overlapResult.overlaps[0];
207
- const laneNames = firstOverlap.lanes.join(" <-> ");
208
- return {
209
- passed: false,
210
- message: `Lane overlap detected: ${overlapCount} overlap(s) found`,
211
- details: `First overlap: ${laneNames}. Run 'pnpm lane:health' for full report.`
212
- };
213
- }
214
- return {
215
- passed: true,
216
- message: `Lane configuration healthy (${lanes.length} lanes, no overlaps)`
217
- };
218
- }
219
- function checkPrerequisites() {
220
- const nodeVersion = getCommandVersion("node", ["--version"]);
221
- const pnpmVersion = getCommandVersion("pnpm", ["--version"]);
222
- const gitVersion = getCommandVersion("git", ["--version"]);
223
- const requiredNode = "22.0.0";
224
- const requiredPnpm = "9.0.0";
225
- const requiredGit = "2.0.0";
226
- const nodeOk = nodeVersion !== "not found" && compareVersions(nodeVersion, requiredNode);
227
- const pnpmOk = pnpmVersion !== "not found" && compareVersions(pnpmVersion, requiredPnpm);
228
- const gitOk = gitVersion !== "not found" && compareVersions(gitVersion, requiredGit);
229
- return {
230
- node: {
231
- passed: nodeOk,
232
- version: nodeVersion,
233
- required: `>=${requiredNode}`,
234
- message: nodeOk ? void 0 : `Node.js ${requiredNode}+ required`
235
- },
236
- pnpm: {
237
- passed: pnpmOk,
238
- version: pnpmVersion,
239
- required: `>=${requiredPnpm}`,
240
- message: pnpmOk ? void 0 : `pnpm ${requiredPnpm}+ required`
241
- },
242
- git: {
243
- passed: gitOk,
244
- version: gitVersion,
245
- required: `>=${requiredGit}`,
246
- message: gitOk ? void 0 : `Git ${requiredGit}+ required`
247
- }
248
- };
249
- }
250
- function getGitRepoRoot(projectDir) {
251
- try {
252
- const repoRoot = execFileSync("git", ["rev-parse", "--show-toplevel"], {
253
- cwd: projectDir,
254
- encoding: "utf-8",
255
- stdio: ["pipe", "pipe", "pipe"]
256
- }).trim();
257
- return repoRoot;
258
- } catch {
259
- return null;
260
- }
261
- }
262
- async function checkManagedFilesDirty(projectDir) {
263
- try {
264
- const repoRoot = getGitRepoRoot(projectDir);
265
- if (!repoRoot) {
266
- return {
267
- passed: true,
268
- files: [],
269
- message: "Git status check skipped (not a git repository)"
270
- };
271
- }
272
- const statusOutput = execFileSync("git", ["status", "--porcelain"], {
273
- cwd: repoRoot,
274
- encoding: "utf-8",
275
- stdio: ["pipe", "pipe", "pipe"]
276
- });
277
- const config = getConfig({ projectRoot: repoRoot });
278
- const managedDirPrefix = `${config.directories.wuDir.replace(/\\/g, "/").replace(/\/wu\/?$/, "/")}`;
279
- const dirtyFiles = [];
280
- const lines = statusOutput.split("\n").filter((line) => line.trim());
281
- for (const line of lines) {
282
- const filePath = line.slice(3).trim();
283
- if (!filePath) continue;
284
- const isManaged = MANAGED_FILE_PATTERNS.some((pattern) => filePath === pattern) || filePath.startsWith(managedDirPrefix);
285
- if (isManaged) {
286
- dirtyFiles.push(filePath);
287
- }
288
- }
289
- if (dirtyFiles.length > 0) {
290
- return {
291
- passed: false,
292
- files: dirtyFiles,
293
- message: `${dirtyFiles.length} managed file(s) have uncommitted changes`
294
- };
295
- }
296
- return {
297
- passed: true,
298
- files: [],
299
- message: "No uncommitted changes to managed files"
300
- };
301
- } catch {
302
- return {
303
- passed: true,
304
- files: [],
305
- message: "Git status check skipped (not a git repository)"
306
- };
307
- }
308
- }
309
- async function checkWorktreeSanity(projectDir) {
310
- try {
311
- execFileSync("git", ["rev-parse", "--git-dir"], {
312
- cwd: projectDir,
313
- encoding: "utf-8",
314
- stdio: ["pipe", "pipe", "pipe"]
315
- });
316
- const orphanResult = await detectOrphanWorktrees(projectDir);
317
- const missingTracked = await detectMissingTrackedWorktrees(projectDir);
318
- const orphanCount = orphanResult.orphans.length;
319
- const missingCount = missingTracked.length;
320
- const errorCount = orphanResult.errors.length;
321
- const totalIssues = orphanCount + missingCount + errorCount;
322
- const passed = totalIssues === 0;
323
- let message = "All worktrees are valid";
324
- if (!passed) {
325
- const parts = [];
326
- if (orphanCount > 0) parts.push(`${orphanCount} orphan(s)`);
327
- if (missingCount > 0) parts.push(`${missingCount} missing`);
328
- if (errorCount > 0) parts.push(`${errorCount} error(s)`);
329
- message = `Worktree issues: ${parts.join(", ")}`;
330
- }
331
- return {
332
- passed,
333
- orphans: orphanCount,
334
- stale: missingCount,
335
- // Combined non-orphan issues for API compat
336
- message
337
- };
338
- } catch {
339
- return {
340
- passed: true,
341
- orphans: 0,
342
- stale: 0,
343
- message: "Worktree check skipped (not a git repository)"
344
- };
345
- }
346
- }
347
- async function checkWUValidity(projectDir) {
348
- const wuDir = path.join(projectDir, createWuPaths({ projectRoot: projectDir }).WU_DIR());
349
- if (!fs.existsSync(wuDir)) {
350
- return {
351
- passed: true,
352
- total: 0,
353
- valid: 0,
354
- invalid: 0,
355
- warnings: 0,
356
- message: "No WU directory found"
357
- };
358
- }
359
- try {
360
- let validateOutput;
361
- let cliError = false;
362
- let cliErrorMessage = "";
363
- try {
364
- validateOutput = execFileSync("pnpm", ["wu:validate", "--all", "--no-strict"], {
365
- cwd: projectDir,
366
- encoding: "utf-8",
367
- stdio: ["pipe", "pipe", "pipe"],
368
- timeout: 6e4
369
- // 60 second timeout for full validation
370
- });
371
- } catch (e) {
372
- const execError = e;
373
- validateOutput = (execError.stdout || "") + (execError.stderr || "");
374
- const errorMsg = execError.message || "";
375
- if (errorMsg.includes("ERR_PNPM") || errorMsg.includes("ENOENT") || errorMsg.includes("Missing script") || errorMsg.includes("command not found") || execError.code === "ENOENT" || // If no recognizable wu:validate output, assume CLI failed
376
- !validateOutput.includes("[wu:validate]") && !validateOutput.includes("Valid:")) {
377
- cliError = true;
378
- cliErrorMessage = errorMsg.includes("Missing script") ? "wu:validate script not found" : errorMsg.includes("ENOENT") ? "pnpm command not available" : "wu:validate could not run";
379
- }
380
- }
381
- if (cliError) {
382
- return {
383
- passed: false,
384
- total: 0,
385
- valid: 0,
386
- invalid: 0,
387
- warnings: 0,
388
- message: `WU validation failed: ${cliErrorMessage}`
389
- };
390
- }
391
- const validMatch = validateOutput.match(/Valid:\s*(\d+)/);
392
- const invalidMatch = validateOutput.match(/Invalid:\s*(\d+)/);
393
- const warningMatch = validateOutput.match(/Warnings:\s*(\d+)/);
394
- const validCount = validMatch ? parseInt(validMatch[1], 10) : 0;
395
- const invalidCount = invalidMatch ? parseInt(invalidMatch[1], 10) : 0;
396
- const warningCount = warningMatch ? parseInt(warningMatch[1], 10) : 0;
397
- const total = validCount + invalidCount;
398
- const passed = invalidCount === 0;
399
- return {
400
- passed,
401
- total,
402
- valid: validCount,
403
- invalid: invalidCount,
404
- warnings: warningCount,
405
- message: passed ? total > 0 ? `All ${total} WU(s) valid${warningCount > 0 ? ` (${warningCount} warning(s))` : ""}` : "No WUs to validate" : `${invalidCount}/${total} WU(s) have issues`
406
- };
407
- } catch (e) {
408
- const error = e;
409
- return {
410
- passed: false,
411
- total: 0,
412
- valid: 0,
413
- invalid: 0,
414
- warnings: 0,
415
- message: `WU validation failed: ${error.message || "unknown error"}`
416
- };
417
- }
418
- }
419
- async function runDoctor(projectDir, options = {}) {
420
- const checks = {
421
- husky: checkHusky(projectDir),
422
- safeGit: checkSafeGit(projectDir),
423
- agentsMd: checkAgentsMd(projectDir),
424
- lumenflowConfig: checkLumenflowConfig(projectDir),
425
- // WU-1191: Lane health check
426
- laneHealth: checkLaneHealth(projectDir)
427
- };
428
- const vendorConfigs = checkVendorConfigs(projectDir);
429
- const prerequisites = checkPrerequisites();
430
- const managedFilesDirty = await checkManagedFilesDirty(projectDir);
431
- const worktreeSanity = await checkWorktreeSanity(projectDir);
432
- const workflowHealth = {
433
- managedFilesDirty,
434
- worktreeSanity
435
- };
436
- if (options.deep) {
437
- workflowHealth.wuValidity = await checkWUValidity(projectDir);
438
- }
439
- const criticalChecks = [checks.husky, checks.safeGit, checks.agentsMd, checks.lumenflowConfig];
440
- const allCriticalPassed = criticalChecks.every((check) => check.passed);
441
- let exitCode = 0;
442
- if (!allCriticalPassed) {
443
- exitCode = 2;
444
- } else if (!managedFilesDirty.passed || !worktreeSanity.passed || workflowHealth.wuValidity && !workflowHealth.wuValidity.passed) {
445
- exitCode = 1;
446
- }
447
- return {
448
- status: allCriticalPassed ? "ACTIVE" : "INCOMPLETE",
449
- exitCode,
450
- checks,
451
- vendorConfigs,
452
- prerequisites,
453
- workflowHealth
454
- };
455
- }
456
- async function runDoctorForInit(projectDir) {
457
- const result = await runDoctor(projectDir, { deep: false });
458
- let warnings = 0;
459
- let errors = 0;
460
- const criticalCheckKeys = ["husky", "safeGit", "agentsMd", "lumenflowConfig"];
461
- for (const [key, check] of Object.entries(result.checks)) {
462
- if (!check.passed) {
463
- if (criticalCheckKeys.includes(key)) {
464
- errors++;
465
- } else {
466
- warnings++;
467
- }
468
- }
469
- }
470
- for (const [, prereq] of Object.entries(result.prerequisites)) {
471
- if (!prereq.passed) {
472
- warnings++;
473
- }
474
- }
475
- if (result.workflowHealth) {
476
- if (!result.workflowHealth.managedFilesDirty.passed) warnings++;
477
- if (!result.workflowHealth.worktreeSanity.passed) warnings++;
478
- }
479
- const lines = [];
480
- lines.push("[lumenflow doctor] Quick health check...");
481
- if (result.exitCode === 0 && warnings === 0) {
482
- lines.push(" All checks passed");
483
- } else {
484
- if (!result.checks.husky.passed) {
485
- lines.push(" Error: Husky hooks not installed");
486
- }
487
- if (!result.checks.safeGit.passed) {
488
- lines.push(" Error: safe-git script not found");
489
- }
490
- if (!result.checks.agentsMd.passed) {
491
- lines.push(" Error: AGENTS.md not found");
492
- }
493
- if (!result.checks.lumenflowConfig.passed) {
494
- lines.push(` Error: ${result.checks.lumenflowConfig.message}`);
495
- if (result.checks.lumenflowConfig.details) {
496
- lines.push(` ${result.checks.lumenflowConfig.details}`);
497
- }
498
- }
499
- if (!result.checks.laneHealth.passed) {
500
- lines.push(` Warning: Lane overlap detected - ${result.checks.laneHealth.message}`);
501
- }
502
- if (!result.prerequisites.node.passed) {
503
- lines.push(
504
- ` Warning: Node.js version ${result.prerequisites.node.version} (required: ${result.prerequisites.node.required})`
505
- );
506
- }
507
- if (!result.prerequisites.pnpm.passed) {
508
- lines.push(
509
- ` Warning: pnpm version ${result.prerequisites.pnpm.version} (required: ${result.prerequisites.pnpm.required})`
510
- );
511
- }
512
- if (!result.prerequisites.git.passed) {
513
- lines.push(
514
- ` Warning: Git version ${result.prerequisites.git.version} (required: ${result.prerequisites.git.required})`
515
- );
516
- }
517
- if (result.workflowHealth?.managedFilesDirty.files.length) {
518
- lines.push(
519
- ` Warning: ${result.workflowHealth.managedFilesDirty.files.length} managed file(s) have uncommitted changes`
520
- );
521
- for (const file of result.workflowHealth.managedFilesDirty.files.slice(0, 3)) {
522
- lines.push(` -> ${file}`);
523
- }
524
- }
525
- if (result.workflowHealth?.worktreeSanity.orphans) {
526
- lines.push(
527
- ` Warning: ${result.workflowHealth.worktreeSanity.orphans} orphan worktree(s) found`
528
- );
529
- }
530
- if (result.workflowHealth && !result.workflowHealth.worktreeSanity.passed) {
531
- const wsSanity = result.workflowHealth.worktreeSanity;
532
- if (wsSanity.stale > 0 && wsSanity.orphans === 0) {
533
- lines.push(` Warning: ${wsSanity.message}`);
534
- }
535
- }
536
- }
537
- return {
538
- blocked: false,
539
- // Never blocks init
540
- warnings,
541
- errors,
542
- output: lines.join("\n")
543
- };
544
- }
545
- function formatDoctorOutput(result) {
546
- const lines = [];
547
- lines.push("");
548
- lines.push("LumenFlow Health Check");
549
- lines.push("\u2500".repeat(45));
550
- lines.push("");
551
- lines.push("Core Safety Components:");
552
- const formatCheck = (check) => {
553
- const symbol = check.passed ? "\u2713" : "\u2717";
554
- return ` ${symbol} ${check.message}`;
555
- };
556
- lines.push(formatCheck(result.checks.husky));
557
- lines.push(formatCheck(result.checks.safeGit));
558
- lines.push(formatCheck(result.checks.agentsMd));
559
- lines.push(formatCheck(result.checks.lumenflowConfig));
560
- lines.push("");
561
- lines.push("Lane Health:");
562
- lines.push(formatCheck(result.checks.laneHealth));
563
- if (result.workflowHealth) {
564
- lines.push("");
565
- lines.push("Workflow Health:");
566
- const mfd = result.workflowHealth.managedFilesDirty;
567
- const mfdSymbol = mfd.passed ? "\u2713" : "\u26A0";
568
- lines.push(` ${mfdSymbol} ${mfd.message}`);
569
- if (!mfd.passed && mfd.files.length > 0) {
570
- for (const file of mfd.files.slice(0, 5)) {
571
- lines.push(` \u2192 ${file}`);
572
- }
573
- if (mfd.files.length > 5) {
574
- lines.push(` \u2192 ... and ${mfd.files.length - 5} more`);
575
- }
576
- }
577
- const ws = result.workflowHealth.worktreeSanity;
578
- const wsSymbol = ws.passed ? "\u2713" : "\u26A0";
579
- lines.push(` ${wsSymbol} ${ws.message}`);
580
- if (result.workflowHealth.wuValidity) {
581
- const wv = result.workflowHealth.wuValidity;
582
- const wvSymbol = wv.passed ? "\u2713" : "\u26A0";
583
- lines.push(` ${wvSymbol} ${wv.message}`);
584
- }
585
- }
586
- lines.push("");
587
- lines.push("Vendor Configs:");
588
- const vendors = ["claude", "cursor", "windsurf", "cline", "codex"];
589
- for (const vendor of vendors) {
590
- const config = result.vendorConfigs[vendor];
591
- const symbol = config.present ? "\u2713" : "\u25CB";
592
- const status = config.present ? "present" : "not configured";
593
- lines.push(` ${symbol} ${vendor}: ${status} (${config.path})`);
594
- }
595
- lines.push("");
596
- lines.push("Prerequisites:");
597
- const prereqs = ["node", "pnpm", "git"];
598
- for (const prereq of prereqs) {
599
- const check = result.prerequisites[prereq];
600
- const symbol = check.passed ? "\u2713" : "\u2717";
601
- const versionDisplay = check.version === "not found" ? "not found" : check.version;
602
- lines.push(` ${symbol} ${prereq}: ${versionDisplay} (required: ${check.required})`);
603
- }
604
- lines.push("");
605
- lines.push("\u2500".repeat(45));
606
- lines.push(`LumenFlow safety: ${result.status}`);
607
- if (result.exitCode === 1) {
608
- lines.push("");
609
- lines.push("Warnings detected (exit code 1). Use --deep for full WU validation.");
610
- } else if (result.exitCode === 2) {
611
- lines.push("");
612
- lines.push("To fix missing components:");
613
- lines.push(" pnpm install && pnpm prepare # Install Husky hooks");
614
- lines.push(" pnpm workspace-init --yes # Create canonical workspace.yaml");
615
- }
616
- lines.push("");
617
- return lines.join("\n");
618
- }
619
- function formatDoctorJson(result) {
620
- return JSON.stringify(result, null, 2);
621
- }
622
- async function main() {
623
- const opts = parseDoctorOptions();
624
- const projectDir = process.cwd();
625
- const result = await runDoctor(projectDir, { deep: opts.deep });
626
- if (opts.json) {
627
- console.log(formatDoctorJson(result));
628
- } else {
629
- console.log(formatDoctorOutput(result));
630
- }
631
- process.exit(result.exitCode);
632
- }
633
- if (import.meta.main) {
634
- void runCLI(main);
635
- }
636
-
637
- export {
638
- parseDoctorOptions,
639
- runDoctor,
640
- runDoctorForInit,
641
- formatDoctorOutput,
642
- formatDoctorJson,
643
- main
644
- };