@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,276 +0,0 @@
1
- import {
2
- DEFAULT_HALF_LIFE_MS,
3
- computeDecayScore
4
- } from "./chunk-ZE473AO6.js";
5
- import {
6
- MEMORY_FILE_NAME,
7
- loadMemory,
8
- loadMemoryAll
9
- } from "./chunk-DFR4DJBM.js";
10
- import {
11
- LUMENFLOW_MEMORY_PATHS
12
- } from "./chunk-4N74J3UT.js";
13
- import {
14
- ErrorCodes,
15
- createError
16
- } from "./chunk-RXRKBBSM.js";
17
-
18
- // ../memory/dist/decay/archival.js
19
- import fs from "fs/promises";
20
- import path from "path";
21
- var DEFAULT_DECAY_THRESHOLD = 0.1;
22
- var ARCHIVED_STATUS = "archived";
23
- var PROTECTED_LIFECYCLE = "project";
24
- function isArchived(node) {
25
- return node.metadata?.status === ARCHIVED_STATUS;
26
- }
27
- function isProtected(node) {
28
- return node.lifecycle === PROTECTED_LIFECYCLE;
29
- }
30
- function markAsArchived(node, score, threshold, now) {
31
- const timestamp = new Date(now).toISOString();
32
- return {
33
- ...node,
34
- metadata: {
35
- ...node.metadata,
36
- status: ARCHIVED_STATUS,
37
- archived_at: timestamp,
38
- decay: {
39
- ...node.metadata?.decay,
40
- score,
41
- reason: `Score ${score.toFixed(4)} below threshold ${threshold}`,
42
- computed_at: timestamp
43
- }
44
- }
45
- };
46
- }
47
- async function writeMemoryFile(baseDir, nodes) {
48
- const filePath = path.join(baseDir, MEMORY_FILE_NAME);
49
- const content = nodes.map((n) => JSON.stringify(n)).join("\n") + (nodes.length > 0 ? "\n" : "");
50
- await fs.writeFile(filePath, content, { encoding: "utf-8" });
51
- }
52
- async function archiveByDecay(baseDir, options = {}) {
53
- const { threshold = DEFAULT_DECAY_THRESHOLD, now = Date.now(), halfLifeMs = DEFAULT_HALF_LIFE_MS, dryRun = false } = options;
54
- const memory = await loadMemory(baseDir, { includeArchived: true });
55
- const archivedIds = [];
56
- const retainedIds = [];
57
- const skippedIds = [];
58
- const updatedNodes = memory.nodes.map((node) => {
59
- if (isArchived(node)) {
60
- skippedIds.push(node.id);
61
- return node;
62
- }
63
- if (isProtected(node)) {
64
- skippedIds.push(node.id);
65
- return node;
66
- }
67
- const score = computeDecayScore(node, { now, halfLifeMs });
68
- if (score < threshold) {
69
- archivedIds.push(node.id);
70
- return markAsArchived(node, score, threshold, now);
71
- }
72
- retainedIds.push(node.id);
73
- return node;
74
- });
75
- if (!dryRun && archivedIds.length > 0) {
76
- await writeMemoryFile(baseDir, updatedNodes);
77
- }
78
- return {
79
- archivedIds,
80
- retainedIds,
81
- skippedIds,
82
- totalProcessed: memory.nodes.length,
83
- ...dryRun ? { dryRun: true } : {}
84
- };
85
- }
86
-
87
- // ../memory/dist/mem-cleanup-core.js
88
- import fs2 from "fs/promises";
89
- import path2 from "path";
90
- import { createRequire } from "module";
91
- var require2 = createRequire(import.meta.url);
92
- var ms = require2("ms");
93
- var LIFECYCLE_POLICY = {
94
- /** Ephemeral nodes are always removed - scratch pad data */
95
- ephemeral: { alwaysRemove: true, requiresSummarized: false },
96
- /** Session nodes removed when session is closed */
97
- session: { alwaysRemove: false, requiresSummarized: true },
98
- /** WU nodes removed only when summarized_into is set */
99
- wu: { alwaysRemove: false, requiresSummarized: true },
100
- /** Project nodes are never removed - architectural knowledge */
101
- project: { alwaysRemove: false, requiresSummarized: false, protected: true }
102
- };
103
- var SENSITIVE_FLAG = "sensitive";
104
- var ACTIVE_SESSION_STATUS = "active";
105
- function parseTtl(ttlString) {
106
- if (!ttlString || typeof ttlString !== "string") {
107
- throw createError(ErrorCodes.INVALID_DURATION, "Invalid TTL format: TTL string is required");
108
- }
109
- const trimmed = ttlString.trim();
110
- if (!trimmed) {
111
- throw createError(ErrorCodes.INVALID_DURATION, "Invalid TTL format: TTL string is required");
112
- }
113
- const result = ms(trimmed);
114
- if (result == null || result <= 0) {
115
- throw createError(ErrorCodes.INVALID_DURATION, `Invalid TTL format: "${ttlString}" is not a valid duration`);
116
- }
117
- return result;
118
- }
119
- function isNodeExpired(node, ttlMs, now = Date.now()) {
120
- if (!node.created_at) {
121
- return false;
122
- }
123
- const createdAt = new Date(node.created_at).getTime();
124
- if (Number.isNaN(createdAt)) {
125
- return false;
126
- }
127
- const age = now - createdAt;
128
- return age > ttlMs;
129
- }
130
- function isActiveSession(node) {
131
- if (node.type !== "session") {
132
- return false;
133
- }
134
- if (!node.metadata) {
135
- return false;
136
- }
137
- return node.metadata.status === ACTIVE_SESSION_STATUS;
138
- }
139
- function hasSensitiveFlag(node) {
140
- if (!node.metadata) {
141
- return false;
142
- }
143
- return Object.hasOwn(node.metadata, SENSITIVE_FLAG) && node.metadata[SENSITIVE_FLAG] === true;
144
- }
145
- function getLifecyclePolicy(lifecycle) {
146
- if (!Object.hasOwn(LIFECYCLE_POLICY, lifecycle)) {
147
- return void 0;
148
- }
149
- return LIFECYCLE_POLICY[lifecycle];
150
- }
151
- function shouldRemoveNode(node, options = {}) {
152
- const { sessionId, ttlMs, now = Date.now() } = options;
153
- if (isActiveSession(node)) {
154
- return { remove: false, reason: "active-session-protected" };
155
- }
156
- if (hasSensitiveFlag(node)) {
157
- return { remove: false, reason: "sensitive-retained" };
158
- }
159
- const policy = getLifecyclePolicy(node.lifecycle);
160
- if (!policy) {
161
- return { remove: false, reason: "unknown-lifecycle" };
162
- }
163
- if (policy.protected) {
164
- return { remove: false, reason: "protected-lifecycle" };
165
- }
166
- if (ttlMs && isNodeExpired(node, ttlMs, now)) {
167
- return { remove: true, reason: "ttl-expired" };
168
- }
169
- if (policy.alwaysRemove) {
170
- return { remove: true, reason: "ephemeral-cleanup" };
171
- }
172
- if (node.lifecycle === "session" && sessionId && node.session_id === sessionId) {
173
- return { remove: true, reason: "session-closed" };
174
- }
175
- if (policy.requiresSummarized && node.metadata?.summarized_into) {
176
- return { remove: true, reason: "summarized-archived" };
177
- }
178
- return { remove: false, reason: "policy-retained" };
179
- }
180
- function estimateNodeBytes(node) {
181
- return JSON.stringify(node).length + 1;
182
- }
183
- function getCompactionRatio(removedCount, totalCount) {
184
- if (totalCount === 0) {
185
- return 0;
186
- }
187
- return removedCount / totalCount;
188
- }
189
- var REASON_TO_BREAKDOWN_KEY = {
190
- "ephemeral-cleanup": "ephemeral",
191
- "session-closed": "session",
192
- "summarized-archived": "wu",
193
- "sensitive-retained": "sensitive",
194
- "ttl-expired": "ttlExpired",
195
- "active-session-protected": "activeSessionProtected"
196
- };
197
- function updateBreakdown(breakdown, decision) {
198
- const key = REASON_TO_BREAKDOWN_KEY[decision.reason];
199
- if (key && Object.hasOwn(breakdown, key)) {
200
- breakdown[key]++;
201
- }
202
- }
203
- async function writeRetainedNodes(memoryDir, retainedNodes) {
204
- const filePath = path2.join(memoryDir, MEMORY_FILE_NAME);
205
- const content = retainedNodes.map((n) => JSON.stringify(n)).join("\n") + (retainedNodes.length > 0 ? "\n" : "");
206
- await fs2.writeFile(filePath, content, { encoding: "utf-8" });
207
- }
208
- async function cleanupMemory(baseDir, options = {}) {
209
- const { dryRun = false, sessionId, ttl, ttlMs: providedTtlMs, now = Date.now(), decay = false, decayThreshold = DEFAULT_DECAY_THRESHOLD, halfLifeMs = DEFAULT_HALF_LIFE_MS } = options;
210
- const memoryDir = path2.join(baseDir, LUMENFLOW_MEMORY_PATHS.MEMORY_DIR);
211
- let ttlMs = providedTtlMs;
212
- if (ttl && !ttlMs) {
213
- ttlMs = parseTtl(ttl);
214
- }
215
- let decayResult;
216
- if (decay) {
217
- decayResult = await archiveByDecay(memoryDir, {
218
- threshold: decayThreshold,
219
- now,
220
- halfLifeMs,
221
- dryRun
222
- });
223
- }
224
- const memory = await loadMemoryAll(memoryDir);
225
- const removedIds = [];
226
- const retainedIds = [];
227
- const retainedNodes = [];
228
- let bytesFreed = 0;
229
- const breakdown = {
230
- ephemeral: 0,
231
- session: 0,
232
- wu: 0,
233
- sensitive: 0,
234
- ttlExpired: 0,
235
- activeSessionProtected: 0,
236
- decayArchived: decayResult?.archivedIds.length ?? 0
237
- };
238
- for (const node of memory.nodes) {
239
- const decision = shouldRemoveNode(node, { sessionId, ttlMs, now });
240
- if (decision.remove) {
241
- removedIds.push(node.id);
242
- bytesFreed += estimateNodeBytes(node);
243
- } else {
244
- retainedIds.push(node.id);
245
- retainedNodes.push(node);
246
- }
247
- updateBreakdown(breakdown, decision);
248
- }
249
- const compactionRatio = getCompactionRatio(removedIds.length, memory.nodes.length);
250
- const baseResult = {
251
- success: true,
252
- removedIds,
253
- retainedIds,
254
- bytesFreed,
255
- compactionRatio,
256
- breakdown
257
- };
258
- if (ttlMs) {
259
- baseResult.ttlMs = ttlMs;
260
- }
261
- if (decayResult) {
262
- baseResult.decayResult = decayResult;
263
- }
264
- if (dryRun) {
265
- return { ...baseResult, dryRun: true };
266
- }
267
- if (removedIds.length > 0) {
268
- await writeRetainedNodes(memoryDir, retainedNodes);
269
- }
270
- return baseResult;
271
- }
272
-
273
- export {
274
- archiveByDecay,
275
- cleanupMemory
276
- };
@@ -1,212 +0,0 @@
1
- import {
2
- MEMORY_PATTERNS,
3
- loadMemory
4
- } from "./chunk-DFR4DJBM.js";
5
- import {
6
- LUMENFLOW_MEMORY_PATHS
7
- } from "./chunk-4N74J3UT.js";
8
- import {
9
- ErrorCodes,
10
- createError
11
- } from "./chunk-RXRKBBSM.js";
12
-
13
- // ../memory/dist/mem-recover-core.js
14
- import fs from "fs/promises";
15
- import path from "path";
16
- import { parse as parseYaml } from "yaml";
17
- var DEFAULT_MAX_SIZE = 8192;
18
- var NODE_TYPE_CHECKPOINT = "checkpoint";
19
- var CONSTRAINTS_FILENAME = "constraints.md";
20
- var TIMESTAMP_UNKNOWN = "unknown";
21
- var MAX_ACCEPTANCE_ITEMS = 8;
22
- var MAX_CODE_PATH_ITEMS = 10;
23
- var ERROR_MESSAGES = {
24
- WU_ID_REQUIRED: "wuId is required",
25
- WU_ID_EMPTY: "wuId cannot be empty",
26
- WU_ID_INVALID: "Invalid WU ID format. Expected pattern: WU-XXX (e.g., WU-1234)"
27
- };
28
- var SECTION_HEADERS = {
29
- RECOVERY_TITLE: "POST-COMPACTION RECOVERY",
30
- LAST_CHECKPOINT: "Last Checkpoint",
31
- ACCEPTANCE_CRITERIA: "Acceptance Criteria",
32
- CODE_PATHS: "Code Paths",
33
- FILES_CHANGED: "Files Changed",
34
- CRITICAL_RULES: "Critical Rules (DO NOT FORGET)",
35
- CLI_COMMANDS: "CLI Commands",
36
- NEXT_ACTION: "Next Action"
37
- };
38
- var ESSENTIAL_CLI_COMMANDS = `| Command | Purpose |
39
- |---------|---------|
40
- | pnpm wu:status --id WU-XXX | Check WU status and location |
41
- | pnpm wu:brief --id WU-XXX | Generate fresh agent handoff prompt |
42
- | pnpm gates | Run quality gates before completion |
43
- | pnpm mem:checkpoint | Save progress checkpoint |`;
44
- var FALLBACK_CONSTRAINTS = `1. **Worktree Discipline**: Work only in worktrees, treat main as read-only
45
- 2. **WUs Are Specs**: Respect code_paths boundaries, no feature creep
46
- 3. **Docs-Only vs Code**: Documentation WUs use --docs-only gates
47
- 4. **LLM-First Inference**: Use LLMs for semantic tasks, no brittle regex
48
- 5. **Gates Required**: Run pnpm gates before wu:done
49
- 6. **Safety & Governance**: No secrets in code, stop-and-ask for sensitive ops
50
- 7. **Test Ratchet**: NEW test failures block, pre-existing show warning only`;
51
- function validateWuId(wuId) {
52
- if (wuId == null) {
53
- throw createError(ErrorCodes.VALIDATION_ERROR, ERROR_MESSAGES.WU_ID_REQUIRED);
54
- }
55
- if (wuId === "") {
56
- throw createError(ErrorCodes.VALIDATION_ERROR, ERROR_MESSAGES.WU_ID_EMPTY);
57
- }
58
- if (!MEMORY_PATTERNS.WU_ID.test(wuId)) {
59
- throw createError(ErrorCodes.INVALID_WU_ID, ERROR_MESSAGES.WU_ID_INVALID);
60
- }
61
- }
62
- async function getLastCheckpoint(baseDir, wuId) {
63
- const memoryDir = path.join(baseDir, LUMENFLOW_MEMORY_PATHS.MEMORY_DIR);
64
- try {
65
- const memory = await loadMemory(memoryDir);
66
- const wuNodes = memory.byWu.get(wuId) ?? [];
67
- const checkpoints = wuNodes.filter((node) => node.type === NODE_TYPE_CHECKPOINT).sort((a, b) => {
68
- const aTime = new Date(a.created_at).getTime();
69
- const bTime = new Date(b.created_at).getTime();
70
- return bTime - aTime;
71
- });
72
- if (checkpoints.length === 0) {
73
- return null;
74
- }
75
- const latest = checkpoints[0];
76
- if (!latest)
77
- return null;
78
- return {
79
- content: latest.content,
80
- timestamp: latest.created_at,
81
- progress: latest.metadata?.progress,
82
- nextSteps: latest.metadata?.nextSteps,
83
- gitDiffStat: latest.metadata?.gitDiffStat
84
- };
85
- } catch {
86
- return null;
87
- }
88
- }
89
- async function loadCompactConstraints(baseDir) {
90
- const constraintsPath = path.join(baseDir, LUMENFLOW_MEMORY_PATHS.BASE, CONSTRAINTS_FILENAME);
91
- try {
92
- const content = await fs.readFile(constraintsPath, "utf-8");
93
- const rules = [];
94
- const sectionPattern = /### (\d+)\. ([^\n]+)\n\n\*\*Rule:\*\* ([^\n]+)/g;
95
- let match;
96
- while ((match = sectionPattern.exec(content)) !== null) {
97
- const [, num, title, rule] = match;
98
- rules.push(`${num}. **${title}**: ${rule}`);
99
- }
100
- if (rules.length > 0) {
101
- return rules.join("\n");
102
- }
103
- return FALLBACK_CONSTRAINTS;
104
- } catch {
105
- return FALLBACK_CONSTRAINTS;
106
- }
107
- }
108
- async function loadWuMetadata(baseDir, wuId) {
109
- const wuYamlPath = path.join(baseDir, "docs", "04-operations", "tasks", "wu", `${wuId}.yaml`);
110
- try {
111
- const content = await fs.readFile(wuYamlPath, "utf-8");
112
- const doc = parseYaml(content);
113
- const acceptance = Array.isArray(doc.acceptance) ? doc.acceptance.filter((s) => typeof s === "string") : [];
114
- const codePaths = Array.isArray(doc.code_paths) ? doc.code_paths.filter((s) => typeof s === "string") : [];
115
- if (acceptance.length === 0 && codePaths.length === 0) {
116
- return null;
117
- }
118
- return { acceptance, codePaths };
119
- } catch {
120
- return null;
121
- }
122
- }
123
- function formatRecoveryPrompt(wuId, checkpoint, constraints, cliRef, wuMetadata, maxSize) {
124
- const header = `# ${SECTION_HEADERS.RECOVERY_TITLE}
125
-
126
- You are resuming work after context compaction. Your previous context was lost.
127
- **WU:** ${wuId}
128
-
129
- `;
130
- const checkpointSection = checkpoint ? `## ${SECTION_HEADERS.LAST_CHECKPOINT}
131
- - **Progress:** ${checkpoint.content}
132
- - **Timestamp:** ${checkpoint.timestamp}
133
- ${checkpoint.nextSteps ? `- **Next Steps:** ${checkpoint.nextSteps}` : ""}
134
-
135
- ` : `## ${SECTION_HEADERS.LAST_CHECKPOINT}
136
- No checkpoint found for this WU.
137
-
138
- `;
139
- const acceptanceItems = wuMetadata?.acceptance.slice(0, MAX_ACCEPTANCE_ITEMS) ?? [];
140
- const acceptanceTruncated = (wuMetadata?.acceptance.length ?? 0) > MAX_ACCEPTANCE_ITEMS;
141
- const acceptanceSection = acceptanceItems.length > 0 ? `## ${SECTION_HEADERS.ACCEPTANCE_CRITERIA}
142
- ${acceptanceItems.map((ac) => `- [ ] ${ac}`).join("\n")}${acceptanceTruncated ? `
143
- - ... (${(wuMetadata?.acceptance.length ?? 0) - MAX_ACCEPTANCE_ITEMS} more \u2014 run wu:brief for full list)` : ""}
144
-
145
- ` : "";
146
- const codePathItems = wuMetadata?.codePaths.slice(0, MAX_CODE_PATH_ITEMS) ?? [];
147
- const codePathsTruncated = (wuMetadata?.codePaths.length ?? 0) > MAX_CODE_PATH_ITEMS;
148
- const codePathsSection = codePathItems.length > 0 ? `## ${SECTION_HEADERS.CODE_PATHS}
149
- ${codePathItems.map((cp) => `- ${cp}`).join("\n")}${codePathsTruncated ? `
150
- - ... (${(wuMetadata?.codePaths.length ?? 0) - MAX_CODE_PATH_ITEMS} more)` : ""}
151
-
152
- ` : "";
153
- const gitDiffSection = checkpoint?.gitDiffStat ? `## ${SECTION_HEADERS.FILES_CHANGED}
154
- \`\`\`
155
- ${checkpoint.gitDiffStat}
156
- \`\`\`
157
-
158
- ` : "";
159
- const constraintsSection = constraints ? `## ${SECTION_HEADERS.CRITICAL_RULES}
160
- ${constraints}
161
-
162
- ` : "";
163
- const cliSection = cliRef ? `## ${SECTION_HEADERS.CLI_COMMANDS}
164
- ${cliRef}
165
-
166
- ` : "";
167
- const footer = `## ${SECTION_HEADERS.NEXT_ACTION}
168
- Continue working on the WU using the acceptance criteria and code paths above.
169
- If you need full context: \`pnpm wu:brief --id ${wuId}\`
170
- `;
171
- const fixedContent = header + acceptanceSection + codePathsSection + gitDiffSection + constraintsSection + cliSection + footer;
172
- const fixedSize = Buffer.byteLength(fixedContent, "utf-8");
173
- if (fixedSize > maxSize) {
174
- const minimal = `# ${SECTION_HEADERS.RECOVERY_TITLE}
175
- WU: ${wuId}
176
- Run: pnpm wu:brief --id ${wuId}
177
- `;
178
- return { context: minimal, truncated: true };
179
- }
180
- const remainingBudget = maxSize - fixedSize;
181
- const checkpointSize = Buffer.byteLength(checkpointSection, "utf-8");
182
- if (checkpointSize <= remainingBudget) {
183
- const fullContext = header + checkpointSection + acceptanceSection + codePathsSection + gitDiffSection + constraintsSection + cliSection + footer;
184
- return { context: fullContext, truncated: false };
185
- }
186
- const truncatedCheckpoint = `## ${SECTION_HEADERS.LAST_CHECKPOINT}
187
- - **Progress:** (truncated - run mem:ready --wu ${wuId} for details)
188
- - **Timestamp:** ${checkpoint?.timestamp ?? TIMESTAMP_UNKNOWN}
189
-
190
- `;
191
- const context = header + truncatedCheckpoint + acceptanceSection + codePathsSection + gitDiffSection + constraintsSection + cliSection + footer;
192
- return { context, truncated: true };
193
- }
194
- async function generateRecoveryContext(options) {
195
- const { wuId, baseDir = ".", maxSize = DEFAULT_MAX_SIZE, includeConstraints = true, includeCLIRef = true, includeWuMetadata = true } = options;
196
- validateWuId(wuId);
197
- const checkpoint = await getLastCheckpoint(baseDir, wuId);
198
- const constraints = includeConstraints ? await loadCompactConstraints(baseDir) : "";
199
- const cliRef = includeCLIRef ? ESSENTIAL_CLI_COMMANDS : "";
200
- const wuMetadata = includeWuMetadata ? await loadWuMetadata(baseDir, wuId) : null;
201
- const { context, truncated } = formatRecoveryPrompt(wuId, checkpoint, constraints, cliRef, wuMetadata, maxSize);
202
- return {
203
- success: true,
204
- context,
205
- size: Buffer.byteLength(context, "utf-8"),
206
- truncated
207
- };
208
- }
209
-
210
- export {
211
- generateRecoveryContext
212
- };
@@ -1,13 +0,0 @@
1
- // ../memory/dist/mem-id.js
2
- import { createHash } from "crypto";
3
- var MEM_ID_PREFIX = "mem-";
4
- var HEX_SUFFIX_LENGTH = 4;
5
- function generateMemId(content) {
6
- const hash = createHash("sha256").update(content, "utf-8").digest("hex");
7
- const suffix = hash.slice(0, HEX_SUFFIX_LENGTH);
8
- return `${MEM_ID_PREFIX}${suffix}`;
9
- }
10
-
11
- export {
12
- generateMemId
13
- };
@@ -1,86 +0,0 @@
1
- import {
2
- ensureMemoryDir
3
- } from "./chunk-ND6MY37M.js";
4
- import {
5
- generateMemId
6
- } from "./chunk-RIAAGL2E.js";
7
- import {
8
- MEMORY_PATTERNS,
9
- appendNode
10
- } from "./chunk-DFR4DJBM.js";
11
- import {
12
- ErrorCodes,
13
- createError
14
- } from "./chunk-RXRKBBSM.js";
15
-
16
- // ../memory/dist/mem-checkpoint-core.js
17
- var ERROR_MESSAGES = {
18
- NOTE_REQUIRED: "note is required",
19
- NOTE_EMPTY: "note cannot be empty",
20
- WU_ID_INVALID: "Invalid WU ID format. Expected pattern: WU-XXX (e.g., WU-123)"
21
- };
22
- var NODE_TYPE_CHECKPOINT = "checkpoint";
23
- var LIFECYCLE_SESSION = "session";
24
- function isValidWuId(wuId) {
25
- if (!wuId)
26
- return true;
27
- return MEMORY_PATTERNS.WU_ID.test(wuId);
28
- }
29
- function generateCheckpointContent(note) {
30
- return `Checkpoint: ${note}`;
31
- }
32
- async function createCheckpoint(baseDir, options) {
33
- const { note, sessionId, wuId, progress, nextSteps, trigger, gitDiffStat } = options;
34
- if (note == null) {
35
- throw createError(ErrorCodes.VALIDATION_ERROR, ERROR_MESSAGES.NOTE_REQUIRED);
36
- }
37
- if (note === "") {
38
- throw createError(ErrorCodes.VALIDATION_ERROR, ERROR_MESSAGES.NOTE_EMPTY);
39
- }
40
- if (wuId && !isValidWuId(wuId)) {
41
- throw createError(ErrorCodes.INVALID_WU_ID, ERROR_MESSAGES.WU_ID_INVALID);
42
- }
43
- const memoryDir = await ensureMemoryDir(baseDir);
44
- const timestamp = (/* @__PURE__ */ new Date()).toISOString();
45
- const content = generateCheckpointContent(note);
46
- const idContent = `${content}-${timestamp}`;
47
- const id = generateMemId(idContent);
48
- const metadata = {};
49
- if (progress) {
50
- metadata.progress = progress;
51
- }
52
- if (nextSteps) {
53
- metadata.nextSteps = nextSteps;
54
- }
55
- if (trigger) {
56
- metadata.trigger = trigger;
57
- }
58
- if (gitDiffStat) {
59
- metadata.gitDiffStat = gitDiffStat;
60
- }
61
- const checkpointNode = {
62
- id,
63
- type: NODE_TYPE_CHECKPOINT,
64
- lifecycle: LIFECYCLE_SESSION,
65
- content,
66
- created_at: timestamp
67
- };
68
- if (wuId) {
69
- checkpointNode.wu_id = wuId;
70
- }
71
- if (sessionId) {
72
- checkpointNode.session_id = sessionId;
73
- }
74
- if (Object.keys(metadata).length > 0) {
75
- checkpointNode.metadata = metadata;
76
- }
77
- await appendNode(memoryDir, checkpointNode);
78
- return {
79
- success: true,
80
- checkpoint: checkpointNode
81
- };
82
- }
83
-
84
- export {
85
- createCheckpoint
86
- };