sensorium-mcp 3.1.2 → 3.1.3-board.10

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 (625) hide show
  1. package/Install-Sensorium.ps1 +257 -43
  2. package/README.md +2 -0
  3. package/dist/board/api/api.js +84 -0
  4. package/dist/board/api/api.test.ts +23 -0
  5. package/dist/board/api/client.js +113 -0
  6. package/dist/board/components/BottomNav.js +32 -0
  7. package/dist/board/components/Card.js +78 -0
  8. package/dist/board/components/Combobox.js +79 -0
  9. package/dist/board/components/CommentComposer.js +29 -0
  10. package/dist/board/components/CommentList.js +42 -0
  11. package/dist/board/components/DirTreePicker.js +128 -0
  12. package/dist/board/components/Dropdown.js +67 -0
  13. package/dist/board/components/Lane.js +47 -0
  14. package/dist/board/components/PriorityChip.js +20 -0
  15. package/dist/board/components/ProfileSummary.js +89 -0
  16. package/dist/board/components/StateBanner.js +24 -0
  17. package/dist/board/components/StatusChip.js +26 -0
  18. package/dist/board/components/rateLimit.js +32 -0
  19. package/dist/board/components/rateLimit.test.ts +16 -0
  20. package/dist/board/components/time.js +14 -0
  21. package/dist/board/config.js +56 -0
  22. package/dist/board/index.html +18 -0
  23. package/dist/board/main.js +37 -0
  24. package/dist/board/mock/api.mock.js +491 -0
  25. package/dist/board/mock/api.mock.test.ts +460 -0
  26. package/dist/board/mock/fixtures.js +512 -0
  27. package/dist/board/schema/policy.js +261 -0
  28. package/dist/board/state/recur.js +24 -0
  29. package/dist/board/state/recur.test.ts +24 -0
  30. package/dist/board/state/useBoard.js +161 -0
  31. package/dist/board/state/useBuilder.js +357 -0
  32. package/dist/board/state/useBuilder.test.ts +468 -0
  33. package/dist/board/state/useCard.js +193 -0
  34. package/dist/board/state/useCard.test.ts +435 -0
  35. package/dist/board/state/useDirBrowser.js +23 -0
  36. package/dist/board/styles/board.css +2885 -0
  37. package/dist/board/styles/tokens.css +72 -0
  38. package/dist/board/vendor/vue.esm-browser.js +9 -0
  39. package/dist/board/views/App.js +61 -0
  40. package/dist/board/views/BoardView.js +153 -0
  41. package/dist/board/views/BuilderView.js +582 -0
  42. package/dist/board/views/CardView.js +382 -0
  43. package/dist/board/views/SettingsView.js +152 -0
  44. package/dist/config/agent-settings.d.ts +11 -0
  45. package/dist/config/agent-settings.d.ts.map +1 -1
  46. package/dist/config/agent-settings.js +79 -0
  47. package/dist/config/agent-settings.js.map +1 -1
  48. package/dist/config/detail-grant.d.ts +7 -16
  49. package/dist/config/detail-grant.d.ts.map +1 -1
  50. package/dist/config/detail-grant.js +12 -35
  51. package/dist/config/detail-grant.js.map +1 -1
  52. package/dist/config/index.d.ts +2 -0
  53. package/dist/config/index.d.ts.map +1 -1
  54. package/dist/config/index.js +17 -0
  55. package/dist/config/index.js.map +1 -1
  56. package/dist/config/mcp-settings.d.ts +7 -1
  57. package/dist/config/mcp-settings.d.ts.map +1 -1
  58. package/dist/config/mcp-settings.js +9 -0
  59. package/dist/config/mcp-settings.js.map +1 -1
  60. package/dist/config/misc-settings.d.ts +22 -1
  61. package/dist/config/misc-settings.d.ts.map +1 -1
  62. package/dist/config/misc-settings.js +93 -3
  63. package/dist/config/misc-settings.js.map +1 -1
  64. package/dist/config/operator-grant.d.ts +9 -0
  65. package/dist/config/operator-grant.d.ts.map +1 -0
  66. package/dist/config/operator-grant.js +24 -0
  67. package/dist/config/operator-grant.js.map +1 -0
  68. package/dist/config/voice-grant.d.ts +10 -0
  69. package/dist/config/voice-grant.d.ts.map +1 -0
  70. package/dist/config/voice-grant.js +18 -0
  71. package/dist/config/voice-grant.js.map +1 -0
  72. package/dist/dashboard/board-static.d.ts +22 -0
  73. package/dist/dashboard/board-static.d.ts.map +1 -0
  74. package/dist/dashboard/board-static.js +130 -0
  75. package/dist/dashboard/board-static.js.map +1 -0
  76. package/dist/dashboard/presets.d.ts +1 -1
  77. package/dist/dashboard/presets.d.ts.map +1 -1
  78. package/dist/dashboard/presets.js +1 -1
  79. package/dist/dashboard/presets.js.map +1 -1
  80. package/dist/dashboard/routes/agent-templates.d.ts.map +1 -1
  81. package/dist/dashboard/routes/agent-templates.js +6 -9
  82. package/dist/dashboard/routes/agent-templates.js.map +1 -1
  83. package/dist/dashboard/routes/board-body.d.ts +8 -0
  84. package/dist/dashboard/routes/board-body.d.ts.map +1 -0
  85. package/dist/dashboard/routes/board-body.js +20 -0
  86. package/dist/dashboard/routes/board-body.js.map +1 -0
  87. package/dist/dashboard/routes/board-dir-listing.d.ts +70 -0
  88. package/dist/dashboard/routes/board-dir-listing.d.ts.map +1 -0
  89. package/dist/dashboard/routes/board-dir-listing.js +192 -0
  90. package/dist/dashboard/routes/board-dir-listing.js.map +1 -0
  91. package/dist/dashboard/routes/board-lane-groups.d.ts +6 -0
  92. package/dist/dashboard/routes/board-lane-groups.d.ts.map +1 -0
  93. package/dist/dashboard/routes/board-lane-groups.js +52 -0
  94. package/dist/dashboard/routes/board-lane-groups.js.map +1 -0
  95. package/dist/dashboard/routes/board-policy.d.ts +224 -0
  96. package/dist/dashboard/routes/board-policy.d.ts.map +1 -0
  97. package/dist/dashboard/routes/board-policy.js +214 -0
  98. package/dist/dashboard/routes/board-policy.js.map +1 -0
  99. package/dist/dashboard/routes/board-profile-parse.d.ts +32 -0
  100. package/dist/dashboard/routes/board-profile-parse.d.ts.map +1 -0
  101. package/dist/dashboard/routes/board-profile-parse.js +338 -0
  102. package/dist/dashboard/routes/board-profile-parse.js.map +1 -0
  103. package/dist/dashboard/routes/board.d.ts +90 -0
  104. package/dist/dashboard/routes/board.d.ts.map +1 -0
  105. package/dist/dashboard/routes/board.js +721 -0
  106. package/dist/dashboard/routes/board.js.map +1 -0
  107. package/dist/dashboard/routes/codex.d.ts +14 -0
  108. package/dist/dashboard/routes/codex.d.ts.map +1 -0
  109. package/dist/dashboard/routes/codex.js +92 -0
  110. package/dist/dashboard/routes/codex.js.map +1 -0
  111. package/dist/dashboard/routes/prompts.d.ts +2 -2
  112. package/dist/dashboard/routes/prompts.d.ts.map +1 -1
  113. package/dist/dashboard/routes/prompts.js +2 -2
  114. package/dist/dashboard/routes/prompts.js.map +1 -1
  115. package/dist/dashboard/routes/settings.d.ts +2 -0
  116. package/dist/dashboard/routes/settings.d.ts.map +1 -1
  117. package/dist/dashboard/routes/settings.js +24 -1
  118. package/dist/dashboard/routes/settings.js.map +1 -1
  119. package/dist/dashboard/routes/skills.d.ts +7 -1
  120. package/dist/dashboard/routes/skills.d.ts.map +1 -1
  121. package/dist/dashboard/routes/skills.js +6 -6
  122. package/dist/dashboard/routes/skills.js.map +1 -1
  123. package/dist/dashboard/routes/snapshots.d.ts +2 -1
  124. package/dist/dashboard/routes/snapshots.d.ts.map +1 -1
  125. package/dist/dashboard/routes/snapshots.js +24 -18
  126. package/dist/dashboard/routes/snapshots.js.map +1 -1
  127. package/dist/dashboard/routes/templates.js +5 -5
  128. package/dist/dashboard/routes/templates.js.map +1 -1
  129. package/dist/dashboard/routes/threads-create.d.ts +17 -0
  130. package/dist/dashboard/routes/threads-create.d.ts.map +1 -1
  131. package/dist/dashboard/routes/threads-create.js +32 -10
  132. package/dist/dashboard/routes/threads-create.js.map +1 -1
  133. package/dist/dashboard/routes/threads-helpers.d.ts +11 -2
  134. package/dist/dashboard/routes/threads-helpers.d.ts.map +1 -1
  135. package/dist/dashboard/routes/threads-helpers.js +20 -3
  136. package/dist/dashboard/routes/threads-helpers.js.map +1 -1
  137. package/dist/dashboard/routes/threads-read.d.ts +16 -4
  138. package/dist/dashboard/routes/threads-read.d.ts.map +1 -1
  139. package/dist/dashboard/routes/threads-read.js +61 -55
  140. package/dist/dashboard/routes/threads-read.js.map +1 -1
  141. package/dist/dashboard/routes/threads.d.ts +2 -2
  142. package/dist/dashboard/routes/threads.d.ts.map +1 -1
  143. package/dist/dashboard/routes/threads.js +143 -29
  144. package/dist/dashboard/routes/threads.js.map +1 -1
  145. package/dist/dashboard/routes/types.d.ts +6 -0
  146. package/dist/dashboard/routes/types.d.ts.map +1 -1
  147. package/dist/dashboard/routes/types.js.map +1 -1
  148. package/dist/dashboard/routes.d.ts +2 -2
  149. package/dist/dashboard/routes.d.ts.map +1 -1
  150. package/dist/dashboard/routes.js +85 -7
  151. package/dist/dashboard/routes.js.map +1 -1
  152. package/dist/dashboard/spa.html +15 -12
  153. package/dist/data/board/board-schema.d.ts +29 -0
  154. package/dist/data/board/board-schema.d.ts.map +1 -0
  155. package/dist/data/board/board-schema.js +202 -0
  156. package/dist/data/board/board-schema.js.map +1 -0
  157. package/dist/data/board/board-types.d.ts +175 -0
  158. package/dist/data/board/board-types.d.ts.map +1 -0
  159. package/dist/data/board/board-types.js +9 -0
  160. package/dist/data/board/board-types.js.map +1 -0
  161. package/dist/data/board/card.repository.d.ts +137 -0
  162. package/dist/data/board/card.repository.d.ts.map +1 -0
  163. package/dist/data/board/card.repository.js +470 -0
  164. package/dist/data/board/card.repository.js.map +1 -0
  165. package/dist/data/board/comment.repository.d.ts +14 -0
  166. package/dist/data/board/comment.repository.d.ts.map +1 -0
  167. package/dist/data/board/comment.repository.js +42 -0
  168. package/dist/data/board/comment.repository.js.map +1 -0
  169. package/dist/data/board/lane-group.repository.d.ts +19 -0
  170. package/dist/data/board/lane-group.repository.d.ts.map +1 -0
  171. package/dist/data/board/lane-group.repository.js +66 -0
  172. package/dist/data/board/lane-group.repository.js.map +1 -0
  173. package/dist/data/board/profile-defaults.d.ts +17 -0
  174. package/dist/data/board/profile-defaults.d.ts.map +1 -0
  175. package/dist/data/board/profile-defaults.js +107 -0
  176. package/dist/data/board/profile-defaults.js.map +1 -0
  177. package/dist/data/interfaces.d.ts +1 -0
  178. package/dist/data/interfaces.d.ts.map +1 -1
  179. package/dist/data/memory/bootstrap.d.ts +1 -8
  180. package/dist/data/memory/bootstrap.d.ts.map +1 -1
  181. package/dist/data/memory/bootstrap.js +27 -37
  182. package/dist/data/memory/bootstrap.js.map +1 -1
  183. package/dist/data/memory/consolidation.d.ts +9 -31
  184. package/dist/data/memory/consolidation.d.ts.map +1 -1
  185. package/dist/data/memory/consolidation.js +22 -32
  186. package/dist/data/memory/consolidation.js.map +1 -1
  187. package/dist/data/memory/db-maintenance.d.ts +54 -0
  188. package/dist/data/memory/db-maintenance.d.ts.map +1 -0
  189. package/dist/data/memory/db-maintenance.js +81 -0
  190. package/dist/data/memory/db-maintenance.js.map +1 -0
  191. package/dist/data/memory/episodes.d.ts +2 -1
  192. package/dist/data/memory/episodes.d.ts.map +1 -1
  193. package/dist/data/memory/episodes.js +5 -1
  194. package/dist/data/memory/episodes.js.map +1 -1
  195. package/dist/data/memory/index.d.ts +0 -4
  196. package/dist/data/memory/index.d.ts.map +1 -1
  197. package/dist/data/memory/index.js +0 -4
  198. package/dist/data/memory/index.js.map +1 -1
  199. package/dist/data/memory/key-knowledge.d.ts +51 -0
  200. package/dist/data/memory/key-knowledge.d.ts.map +1 -0
  201. package/dist/data/memory/key-knowledge.js +128 -0
  202. package/dist/data/memory/key-knowledge.js.map +1 -0
  203. package/dist/data/memory/migration-runner.d.ts +1 -1
  204. package/dist/data/memory/migration-runner.d.ts.map +1 -1
  205. package/dist/data/memory/migration-runner.js +407 -1
  206. package/dist/data/memory/migration-runner.js.map +1 -1
  207. package/dist/data/memory/narrative-lint.d.ts +2 -2
  208. package/dist/data/memory/narrative-lint.d.ts.map +1 -1
  209. package/dist/data/memory/narrative-lint.js +23 -13
  210. package/dist/data/memory/narrative-lint.js.map +1 -1
  211. package/dist/data/memory/narrative-resolutions.d.ts +9 -2
  212. package/dist/data/memory/narrative-resolutions.d.ts.map +1 -1
  213. package/dist/data/memory/narrative-resolutions.js +9 -8
  214. package/dist/data/memory/narrative-resolutions.js.map +1 -1
  215. package/dist/data/memory/narrative-sources.d.ts +1 -1
  216. package/dist/data/memory/narrative-sources.d.ts.map +1 -1
  217. package/dist/data/memory/narrative-sources.js +8 -3
  218. package/dist/data/memory/narrative-sources.js.map +1 -1
  219. package/dist/data/memory/narrative-store.d.ts +24 -0
  220. package/dist/data/memory/narrative-store.d.ts.map +1 -1
  221. package/dist/data/memory/narrative-store.js +73 -35
  222. package/dist/data/memory/narrative-store.js.map +1 -1
  223. package/dist/data/memory/narrative.d.ts.map +1 -1
  224. package/dist/data/memory/narrative.js +47 -29
  225. package/dist/data/memory/narrative.js.map +1 -1
  226. package/dist/data/memory/note-archival.d.ts +1 -1
  227. package/dist/data/memory/note-archival.d.ts.map +1 -1
  228. package/dist/data/memory/note-archival.js +7 -3
  229. package/dist/data/memory/note-archival.js.map +1 -1
  230. package/dist/data/memory/note-embeddings.d.ts +7 -0
  231. package/dist/data/memory/note-embeddings.d.ts.map +1 -1
  232. package/dist/data/memory/note-embeddings.js +6 -2
  233. package/dist/data/memory/note-embeddings.js.map +1 -1
  234. package/dist/data/memory/passive-notice.repository.d.ts +70 -0
  235. package/dist/data/memory/passive-notice.repository.d.ts.map +1 -0
  236. package/dist/data/memory/passive-notice.repository.js +85 -0
  237. package/dist/data/memory/passive-notice.repository.js.map +1 -0
  238. package/dist/data/memory/schema-ddl.d.ts +120 -1
  239. package/dist/data/memory/schema-ddl.d.ts.map +1 -1
  240. package/dist/data/memory/schema-ddl.js +171 -4
  241. package/dist/data/memory/schema-ddl.js.map +1 -1
  242. package/dist/data/memory/schema-guard.d.ts.map +1 -1
  243. package/dist/data/memory/schema-guard.js +5 -41
  244. package/dist/data/memory/schema-guard.js.map +1 -1
  245. package/dist/data/memory/schema.d.ts.map +1 -1
  246. package/dist/data/memory/schema.js +10 -34
  247. package/dist/data/memory/schema.js.map +1 -1
  248. package/dist/data/memory/semantic-notes.d.ts +13 -8
  249. package/dist/data/memory/semantic-notes.d.ts.map +1 -1
  250. package/dist/data/memory/semantic-notes.js +12 -17
  251. package/dist/data/memory/semantic-notes.js.map +1 -1
  252. package/dist/data/memory/thread-registry.d.ts +330 -15
  253. package/dist/data/memory/thread-registry.d.ts.map +1 -1
  254. package/dist/data/memory/thread-registry.js +523 -67
  255. package/dist/data/memory/thread-registry.js.map +1 -1
  256. package/dist/data/memory/utils.d.ts +6 -0
  257. package/dist/data/memory/utils.d.ts.map +1 -1
  258. package/dist/data/memory/utils.js +13 -0
  259. package/dist/data/memory/utils.js.map +1 -1
  260. package/dist/data/memory/worker-lifecycle.repository.d.ts +308 -0
  261. package/dist/data/memory/worker-lifecycle.repository.d.ts.map +1 -0
  262. package/dist/data/memory/worker-lifecycle.repository.js +428 -0
  263. package/dist/data/memory/worker-lifecycle.repository.js.map +1 -0
  264. package/dist/data/optional.d.ts +16 -0
  265. package/dist/data/optional.d.ts.map +1 -0
  266. package/dist/data/optional.js +47 -0
  267. package/dist/data/optional.js.map +1 -0
  268. package/dist/index.js +156 -24
  269. package/dist/index.js.map +1 -1
  270. package/dist/integrations/openai/speech.d.ts.map +1 -1
  271. package/dist/integrations/openai/speech.js +52 -19
  272. package/dist/integrations/openai/speech.js.map +1 -1
  273. package/dist/integrations/openai/video.d.ts +1 -1
  274. package/dist/integrations/openai/video.d.ts.map +1 -1
  275. package/dist/integrations/openai/video.js +13 -8
  276. package/dist/integrations/openai/video.js.map +1 -1
  277. package/dist/integrations/telegram/types.d.ts +11 -0
  278. package/dist/integrations/telegram/types.d.ts.map +1 -1
  279. package/dist/lib/http-retry.d.ts +91 -0
  280. package/dist/lib/http-retry.d.ts.map +1 -0
  281. package/dist/lib/http-retry.js +177 -0
  282. package/dist/lib/http-retry.js.map +1 -0
  283. package/dist/lib/mcp-http-port.d.ts +12 -0
  284. package/dist/lib/mcp-http-port.d.ts.map +1 -0
  285. package/dist/lib/mcp-http-port.js +19 -0
  286. package/dist/lib/mcp-http-port.js.map +1 -0
  287. package/dist/lib/paths.d.ts +29 -4
  288. package/dist/lib/paths.d.ts.map +1 -1
  289. package/dist/lib/paths.js +31 -4
  290. package/dist/lib/paths.js.map +1 -1
  291. package/dist/lib/types.d.ts +2 -0
  292. package/dist/lib/types.d.ts.map +1 -1
  293. package/dist/lib/usage-metering/pricing.js +1 -1
  294. package/dist/lib/usage-metering/pricing.js.map +1 -1
  295. package/dist/lib/usage-metering/sink.d.ts +4 -0
  296. package/dist/lib/usage-metering/sink.d.ts.map +1 -1
  297. package/dist/lib/usage-metering/sink.js +6 -4
  298. package/dist/lib/usage-metering/sink.js.map +1 -1
  299. package/dist/lib/utils.d.ts +31 -0
  300. package/dist/lib/utils.d.ts.map +1 -1
  301. package/dist/lib/utils.js +49 -0
  302. package/dist/lib/utils.js.map +1 -1
  303. package/dist/llm/prompts/narrative.d.ts.map +1 -1
  304. package/dist/llm/prompts/narrative.js +27 -86
  305. package/dist/llm/prompts/narrative.js.map +1 -1
  306. package/dist/log-parsing/log-events.d.ts +38 -0
  307. package/dist/log-parsing/log-events.d.ts.map +1 -0
  308. package/dist/log-parsing/log-events.js +2 -0
  309. package/dist/log-parsing/log-events.js.map +1 -0
  310. package/dist/log-parsing/parser-registry.d.ts +4 -0
  311. package/dist/log-parsing/parser-registry.d.ts.map +1 -0
  312. package/dist/log-parsing/parser-registry.js +18 -0
  313. package/dist/log-parsing/parser-registry.js.map +1 -0
  314. package/dist/log-parsing/parsers/claude.d.ts +6 -0
  315. package/dist/log-parsing/parsers/claude.d.ts.map +1 -0
  316. package/dist/log-parsing/parsers/claude.js +100 -0
  317. package/dist/log-parsing/parsers/claude.js.map +1 -0
  318. package/dist/log-parsing/parsers/codex.d.ts +6 -0
  319. package/dist/log-parsing/parsers/codex.d.ts.map +1 -0
  320. package/dist/log-parsing/parsers/codex.js +116 -0
  321. package/dist/log-parsing/parsers/codex.js.map +1 -0
  322. package/dist/log-parsing/parsers/copilot.d.ts +6 -0
  323. package/dist/log-parsing/parsers/copilot.d.ts.map +1 -0
  324. package/dist/log-parsing/parsers/copilot.js +65 -0
  325. package/dist/log-parsing/parsers/copilot.js.map +1 -0
  326. package/dist/log-parsing/parsers/json-lines.d.ts +9 -0
  327. package/dist/log-parsing/parsers/json-lines.d.ts.map +1 -0
  328. package/dist/log-parsing/parsers/json-lines.js +25 -0
  329. package/dist/log-parsing/parsers/json-lines.js.map +1 -0
  330. package/dist/log-parsing/render.d.ts +33 -0
  331. package/dist/log-parsing/render.d.ts.map +1 -0
  332. package/dist/log-parsing/render.js +113 -0
  333. package/dist/log-parsing/render.js.map +1 -0
  334. package/dist/log-parsing/text.d.ts +8 -0
  335. package/dist/log-parsing/text.d.ts.map +1 -0
  336. package/dist/log-parsing/text.js +20 -0
  337. package/dist/log-parsing/text.js.map +1 -0
  338. package/dist/server/http-server.d.ts +8 -1
  339. package/dist/server/http-server.d.ts.map +1 -1
  340. package/dist/server/http-server.js +41 -19
  341. package/dist/server/http-server.js.map +1 -1
  342. package/dist/server/port-holder.d.ts +94 -0
  343. package/dist/server/port-holder.d.ts.map +1 -0
  344. package/dist/server/port-holder.js +122 -0
  345. package/dist/server/port-holder.js.map +1 -0
  346. package/dist/services/agent-spawn.service.d.ts +50 -5
  347. package/dist/services/agent-spawn.service.d.ts.map +1 -1
  348. package/dist/services/agent-spawn.service.js +59 -66
  349. package/dist/services/agent-spawn.service.js.map +1 -1
  350. package/dist/services/background-runner.d.ts +0 -1
  351. package/dist/services/background-runner.d.ts.map +1 -1
  352. package/dist/services/background-runner.js +0 -58
  353. package/dist/services/background-runner.js.map +1 -1
  354. package/dist/services/board/board-signals.d.ts +45 -0
  355. package/dist/services/board/board-signals.d.ts.map +1 -0
  356. package/dist/services/board/board-signals.js +170 -0
  357. package/dist/services/board/board-signals.js.map +1 -0
  358. package/dist/services/board/card-briefing.d.ts +24 -0
  359. package/dist/services/board/card-briefing.d.ts.map +1 -0
  360. package/dist/services/board/card-briefing.js +132 -0
  361. package/dist/services/board/card-briefing.js.map +1 -0
  362. package/dist/services/board/card-diagnostics.d.ts +25 -0
  363. package/dist/services/board/card-diagnostics.d.ts.map +1 -0
  364. package/dist/services/board/card-diagnostics.js +50 -0
  365. package/dist/services/board/card-diagnostics.js.map +1 -0
  366. package/dist/services/board/live-root-thread.d.ts +8 -0
  367. package/dist/services/board/live-root-thread.d.ts.map +1 -0
  368. package/dist/services/board/live-root-thread.js +2 -0
  369. package/dist/services/board/live-root-thread.js.map +1 -0
  370. package/dist/services/board/orchestrator.service.d.ts +119 -0
  371. package/dist/services/board/orchestrator.service.d.ts.map +1 -0
  372. package/dist/services/board/orchestrator.service.js +387 -0
  373. package/dist/services/board/orchestrator.service.js.map +1 -0
  374. package/dist/services/board/release-worker.d.ts +43 -0
  375. package/dist/services/board/release-worker.d.ts.map +1 -0
  376. package/dist/services/board/release-worker.js +96 -0
  377. package/dist/services/board/release-worker.js.map +1 -0
  378. package/dist/services/board/report-capture.d.ts +94 -0
  379. package/dist/services/board/report-capture.d.ts.map +1 -0
  380. package/dist/services/board/report-capture.js +398 -0
  381. package/dist/services/board/report-capture.js.map +1 -0
  382. package/dist/services/board/worker-spawn.d.ts +89 -0
  383. package/dist/services/board/worker-spawn.d.ts.map +1 -0
  384. package/dist/services/board/worker-spawn.js +177 -0
  385. package/dist/services/board/worker-spawn.js.map +1 -0
  386. package/dist/services/board/worktree.d.ts +45 -0
  387. package/dist/services/board/worktree.d.ts.map +1 -0
  388. package/dist/services/board/worktree.js +183 -0
  389. package/dist/services/board/worktree.js.map +1 -0
  390. package/dist/services/broker-client.d.ts +84 -2
  391. package/dist/services/broker-client.d.ts.map +1 -1
  392. package/dist/services/broker-client.js +72 -6
  393. package/dist/services/broker-client.js.map +1 -1
  394. package/dist/services/claude-spawn.service.d.ts +5 -0
  395. package/dist/services/claude-spawn.service.d.ts.map +1 -1
  396. package/dist/services/claude-spawn.service.js +37 -21
  397. package/dist/services/claude-spawn.service.js.map +1 -1
  398. package/dist/services/codex-spawn.service.d.ts +8 -3
  399. package/dist/services/codex-spawn.service.d.ts.map +1 -1
  400. package/dist/services/codex-spawn.service.js +84 -67
  401. package/dist/services/codex-spawn.service.js.map +1 -1
  402. package/dist/services/consolidation.service.d.ts.map +1 -1
  403. package/dist/services/consolidation.service.js +5 -49
  404. package/dist/services/consolidation.service.js.map +1 -1
  405. package/dist/services/copilot-spawn.service.d.ts +1 -1
  406. package/dist/services/copilot-spawn.service.d.ts.map +1 -1
  407. package/dist/services/copilot-spawn.service.js +10 -5
  408. package/dist/services/copilot-spawn.service.js.map +1 -1
  409. package/dist/services/daily-session.d.ts +24 -11
  410. package/dist/services/daily-session.d.ts.map +1 -1
  411. package/dist/services/daily-session.js +113 -33
  412. package/dist/services/daily-session.js.map +1 -1
  413. package/dist/services/death-alert.service.d.ts +55 -0
  414. package/dist/services/death-alert.service.d.ts.map +1 -0
  415. package/dist/services/death-alert.service.js +64 -0
  416. package/dist/services/death-alert.service.js.map +1 -0
  417. package/dist/services/dispatcher/broker.d.ts +66 -0
  418. package/dist/services/dispatcher/broker.d.ts.map +1 -1
  419. package/dist/services/dispatcher/broker.js +60 -52
  420. package/dist/services/dispatcher/broker.js.map +1 -1
  421. package/dist/services/dispatcher/poller.d.ts.map +1 -1
  422. package/dist/services/dispatcher/poller.js +31 -24
  423. package/dist/services/dispatcher/poller.js.map +1 -1
  424. package/dist/services/http-retry.d.ts +1 -90
  425. package/dist/services/http-retry.d.ts.map +1 -1
  426. package/dist/services/http-retry.js +1 -176
  427. package/dist/services/http-retry.js.map +1 -1
  428. package/dist/services/intent.d.ts +15 -1
  429. package/dist/services/intent.d.ts.map +1 -1
  430. package/dist/services/intent.js +39 -27
  431. package/dist/services/intent.js.map +1 -1
  432. package/dist/services/keeper.service.d.ts +76 -3
  433. package/dist/services/keeper.service.d.ts.map +1 -1
  434. package/dist/services/keeper.service.js +112 -35
  435. package/dist/services/keeper.service.js.map +1 -1
  436. package/dist/services/mcp-config.service.d.ts.map +1 -1
  437. package/dist/services/mcp-config.service.js +14 -1
  438. package/dist/services/mcp-config.service.js.map +1 -1
  439. package/dist/services/memory-briefing.service.d.ts +1 -1
  440. package/dist/services/memory-briefing.service.d.ts.map +1 -1
  441. package/dist/services/memory-briefing.service.js +28 -73
  442. package/dist/services/memory-briefing.service.js.map +1 -1
  443. package/dist/services/passive-notice.service.d.ts +56 -0
  444. package/dist/services/passive-notice.service.d.ts.map +1 -0
  445. package/dist/services/passive-notice.service.js +92 -0
  446. package/dist/services/passive-notice.service.js.map +1 -0
  447. package/dist/services/predefined-prompts.d.ts +11 -0
  448. package/dist/services/predefined-prompts.d.ts.map +1 -0
  449. package/dist/services/predefined-prompts.js +25 -0
  450. package/dist/services/predefined-prompts.js.map +1 -0
  451. package/dist/services/process.service.d.ts +111 -27
  452. package/dist/services/process.service.d.ts.map +1 -1
  453. package/dist/services/process.service.js +245 -173
  454. package/dist/services/process.service.js.map +1 -1
  455. package/dist/services/spawn-common.d.ts +281 -5
  456. package/dist/services/spawn-common.d.ts.map +1 -1
  457. package/dist/services/spawn-common.js +884 -188
  458. package/dist/services/spawn-common.js.map +1 -1
  459. package/dist/services/spawn-exit-watcher.d.ts +45 -35
  460. package/dist/services/spawn-exit-watcher.d.ts.map +1 -1
  461. package/dist/services/spawn-exit-watcher.js +120 -100
  462. package/dist/services/spawn-exit-watcher.js.map +1 -1
  463. package/dist/services/telegram.d.ts +31 -8
  464. package/dist/services/telegram.d.ts.map +1 -1
  465. package/dist/services/telegram.js +58 -26
  466. package/dist/services/telegram.js.map +1 -1
  467. package/dist/services/thread-health.service.d.ts +8 -0
  468. package/dist/services/thread-health.service.d.ts.map +1 -1
  469. package/dist/services/thread-health.service.js +14 -10
  470. package/dist/services/thread-health.service.js.map +1 -1
  471. package/dist/services/thread-lifecycle.service.d.ts +17 -1
  472. package/dist/services/thread-lifecycle.service.d.ts.map +1 -1
  473. package/dist/services/thread-lifecycle.service.js +47 -6
  474. package/dist/services/thread-lifecycle.service.js.map +1 -1
  475. package/dist/services/thread-log-reader.d.ts +81 -0
  476. package/dist/services/thread-log-reader.d.ts.map +1 -0
  477. package/dist/services/thread-log-reader.js +141 -0
  478. package/dist/services/thread-log-reader.js.map +1 -0
  479. package/dist/services/thread-purge.service.d.ts +200 -0
  480. package/dist/services/thread-purge.service.d.ts.map +1 -0
  481. package/dist/services/thread-purge.service.js +644 -0
  482. package/dist/services/thread-purge.service.js.map +1 -0
  483. package/dist/services/topic.service.d.ts +44 -2
  484. package/dist/services/topic.service.d.ts.map +1 -1
  485. package/dist/services/topic.service.js +74 -13
  486. package/dist/services/topic.service.js.map +1 -1
  487. package/dist/services/usage/usage-inbox-notifier.d.ts +50 -0
  488. package/dist/services/usage/usage-inbox-notifier.d.ts.map +1 -0
  489. package/dist/services/usage/usage-inbox-notifier.js +118 -0
  490. package/dist/services/usage/usage-inbox-notifier.js.map +1 -0
  491. package/dist/services/usage/usage-poller.service.d.ts +41 -0
  492. package/dist/services/usage/usage-poller.service.d.ts.map +1 -0
  493. package/dist/services/usage/usage-poller.service.js +67 -0
  494. package/dist/services/usage/usage-poller.service.js.map +1 -0
  495. package/dist/services/usage/usage-snapshot-provider.d.ts +40 -0
  496. package/dist/services/usage/usage-snapshot-provider.d.ts.map +1 -0
  497. package/dist/services/usage/usage-snapshot-provider.js +89 -0
  498. package/dist/services/usage/usage-snapshot-provider.js.map +1 -0
  499. package/dist/services/usage/usage-types.d.ts +28 -0
  500. package/dist/services/usage/usage-types.d.ts.map +1 -0
  501. package/dist/services/usage/usage-types.js +14 -0
  502. package/dist/services/usage/usage-types.js.map +1 -0
  503. package/dist/services/worker-birth.d.ts +154 -0
  504. package/dist/services/worker-birth.d.ts.map +1 -0
  505. package/dist/services/worker-birth.js +274 -0
  506. package/dist/services/worker-birth.js.map +1 -0
  507. package/dist/services/worker-cleanup.service.d.ts +242 -19
  508. package/dist/services/worker-cleanup.service.d.ts.map +1 -1
  509. package/dist/services/worker-cleanup.service.js +893 -355
  510. package/dist/services/worker-cleanup.service.js.map +1 -1
  511. package/dist/services/worker-lifecycle-executor.d.ts +42 -0
  512. package/dist/services/worker-lifecycle-executor.d.ts.map +1 -0
  513. package/dist/services/worker-lifecycle-executor.js +63 -0
  514. package/dist/services/worker-lifecycle-executor.js.map +1 -0
  515. package/dist/services/worker-single-use.d.ts +92 -0
  516. package/dist/services/worker-single-use.d.ts.map +1 -0
  517. package/dist/services/worker-single-use.js +155 -0
  518. package/dist/services/worker-single-use.js.map +1 -0
  519. package/dist/sessions/mcp-registry.d.ts +33 -2
  520. package/dist/sessions/mcp-registry.d.ts.map +1 -1
  521. package/dist/sessions/mcp-registry.js +153 -30
  522. package/dist/sessions/mcp-registry.js.map +1 -1
  523. package/dist/test-bootstrap.d.ts +19 -12
  524. package/dist/test-bootstrap.d.ts.map +1 -1
  525. package/dist/test-bootstrap.js +69 -21
  526. package/dist/test-bootstrap.js.map +1 -1
  527. package/dist/test-tripwire.test-support.d.ts +75 -0
  528. package/dist/test-tripwire.test-support.d.ts.map +1 -0
  529. package/dist/test-tripwire.test-support.js +353 -0
  530. package/dist/test-tripwire.test-support.js.map +1 -0
  531. package/dist/tools/defs/memory-defs.d.ts.map +1 -1
  532. package/dist/tools/defs/memory-defs.js +12 -4
  533. package/dist/tools/defs/memory-defs.js.map +1 -1
  534. package/dist/tools/defs/session-defs.d.ts.map +1 -1
  535. package/dist/tools/defs/session-defs.js +26 -10
  536. package/dist/tools/defs/session-defs.js.map +1 -1
  537. package/dist/tools/defs/utility-defs.js +1 -1
  538. package/dist/tools/defs/utility-defs.js.map +1 -1
  539. package/dist/tools/delegate-tool.d.ts +81 -1
  540. package/dist/tools/delegate-tool.d.ts.map +1 -1
  541. package/dist/tools/delegate-tool.js +840 -219
  542. package/dist/tools/delegate-tool.js.map +1 -1
  543. package/dist/tools/memory-tools.d.ts.map +1 -1
  544. package/dist/tools/memory-tools.js +66 -9
  545. package/dist/tools/memory-tools.js.map +1 -1
  546. package/dist/tools/response-builders.d.ts.map +1 -1
  547. package/dist/tools/response-builders.js +12 -8
  548. package/dist/tools/response-builders.js.map +1 -1
  549. package/dist/tools/session-tools.d.ts.map +1 -1
  550. package/dist/tools/session-tools.js +3 -32
  551. package/dist/tools/session-tools.js.map +1 -1
  552. package/dist/tools/skill-tools.js +1 -1
  553. package/dist/tools/skill-tools.js.map +1 -1
  554. package/dist/tools/start-session-tool.d.ts.map +1 -1
  555. package/dist/tools/start-session-tool.js +66 -20
  556. package/dist/tools/start-session-tool.js.map +1 -1
  557. package/dist/tools/utility-tools.d.ts.map +1 -1
  558. package/dist/tools/utility-tools.js +38 -3
  559. package/dist/tools/utility-tools.js.map +1 -1
  560. package/dist/tools/wait/auto-forward.d.ts.map +1 -1
  561. package/dist/tools/wait/auto-forward.js +8 -3
  562. package/dist/tools/wait/auto-forward.js.map +1 -1
  563. package/dist/tools/wait/consolidation-strategy.d.ts +42 -0
  564. package/dist/tools/wait/consolidation-strategy.d.ts.map +1 -0
  565. package/dist/tools/wait/consolidation-strategy.js +50 -0
  566. package/dist/tools/wait/consolidation-strategy.js.map +1 -0
  567. package/dist/tools/wait/drive-handler.d.ts +5 -7
  568. package/dist/tools/wait/drive-handler.d.ts.map +1 -1
  569. package/dist/tools/wait/drive-handler.js +45 -59
  570. package/dist/tools/wait/drive-handler.js.map +1 -1
  571. package/dist/tools/wait/media-processor.d.ts.map +1 -1
  572. package/dist/tools/wait/media-processor.js +8 -4
  573. package/dist/tools/wait/media-processor.js.map +1 -1
  574. package/dist/tools/wait/message-delivery.d.ts +9 -6
  575. package/dist/tools/wait/message-delivery.d.ts.map +1 -1
  576. package/dist/tools/wait/message-delivery.js +77 -58
  577. package/dist/tools/wait/message-delivery.js.map +1 -1
  578. package/dist/tools/wait/message-processing.d.ts.map +1 -1
  579. package/dist/tools/wait/message-processing.js +2 -1
  580. package/dist/tools/wait/message-processing.js.map +1 -1
  581. package/dist/tools/wait/poll-loop.d.ts.map +1 -1
  582. package/dist/tools/wait/poll-loop.js +339 -239
  583. package/dist/tools/wait/poll-loop.js.map +1 -1
  584. package/package.json +4 -3
  585. package/templates/azure-devops-securevault.default.md +20 -6
  586. package/templates/board-quality-checklist.default.md +121 -0
  587. package/templates/buildless-vue-preview.default.md +47 -0
  588. package/templates/expert-code-review.default.md +12 -0
  589. package/templates/handoff.default.md +41 -18
  590. package/templates/increment-pr-pipeline.default.md +79 -0
  591. package/templates/swarm.default.md +1 -0
  592. package/templates/worker-autonomous.default.md +1 -0
  593. package/templates/worker-delegate.default.md +1 -0
  594. package/dist/dashboard/log-parser.d.ts +0 -65
  595. package/dist/dashboard/log-parser.d.ts.map +0 -1
  596. package/dist/dashboard/log-parser.js +0 -219
  597. package/dist/dashboard/log-parser.js.map +0 -1
  598. package/dist/data/memory/reflection-dedup.d.ts +0 -17
  599. package/dist/data/memory/reflection-dedup.d.ts.map +0 -1
  600. package/dist/data/memory/reflection-dedup.js +0 -55
  601. package/dist/data/memory/reflection-dedup.js.map +0 -1
  602. package/dist/data/memory/reflection-gates.d.ts +0 -40
  603. package/dist/data/memory/reflection-gates.d.ts.map +0 -1
  604. package/dist/data/memory/reflection-gates.js +0 -220
  605. package/dist/data/memory/reflection-gates.js.map +0 -1
  606. package/dist/data/memory/reflection-sources.d.ts +0 -13
  607. package/dist/data/memory/reflection-sources.d.ts.map +0 -1
  608. package/dist/data/memory/reflection-sources.js +0 -115
  609. package/dist/data/memory/reflection-sources.js.map +0 -1
  610. package/dist/data/memory/reflection.d.ts +0 -43
  611. package/dist/data/memory/reflection.d.ts.map +0 -1
  612. package/dist/data/memory/reflection.js +0 -329
  613. package/dist/data/memory/reflection.js.map +0 -1
  614. package/dist/llm/prompts/reflection.d.ts +0 -6
  615. package/dist/llm/prompts/reflection.d.ts.map +0 -1
  616. package/dist/llm/prompts/reflection.js +0 -77
  617. package/dist/llm/prompts/reflection.js.map +0 -1
  618. package/dist/services/memory-pruning.service.d.ts +0 -12
  619. package/dist/services/memory-pruning.service.d.ts.map +0 -1
  620. package/dist/services/memory-pruning.service.js +0 -179
  621. package/dist/services/memory-pruning.service.js.map +0 -1
  622. package/templates/daily-review.default.md +0 -26
  623. package/templates/fire-and-forget.default.md +0 -76
  624. package/templates/offload.default.md +0 -33
  625. package/templates/sensorium-repair.default.md +0 -114
@@ -1,179 +0,0 @@
1
- /**
2
- * Memory pruning — LLM-driven review of low-value semantic notes that
3
- * expires vague/outdated notes and merges duplicates. Runs as a phase of
4
- * the all-threads consolidation cycle and on its own schedule.
5
- */
6
- import { getCandidateNotesForPruning, getActiveNoteContent, hasActiveNote, expireNote, mergeDuplicateNote, } from "../data/memory/consolidation.js";
7
- import { chatCompletionJson } from "../llm/json.js";
8
- import { log } from "../lib/logger.js";
9
- import { nowISO } from "../data/memory/utils.js";
10
- import { errorMessage } from "../lib/utils.js";
11
- export async function runMemoryPruning(db, options) {
12
- const pruningEnabled = process.env.PRUNING_ENABLED;
13
- if (pruningEnabled === "false" || pruningEnabled === "0") {
14
- return {
15
- notesScanned: 0,
16
- notesExpired: 0,
17
- notesMerged: 0,
18
- durationMs: 0,
19
- details: ["Pruning disabled via PRUNING_ENABLED env var."],
20
- };
21
- }
22
- const apiKey = process.env.OPENAI_API_KEY;
23
- if (!apiKey) {
24
- return {
25
- notesScanned: 0,
26
- notesExpired: 0,
27
- notesMerged: 0,
28
- durationMs: 0,
29
- details: ["Pruning skipped — OPENAI_API_KEY not set."],
30
- };
31
- }
32
- const startMs = Date.now();
33
- const envSampleSize = parseInt(process.env.PRUNING_SAMPLE_SIZE ?? "", 10);
34
- const maxNotes = options?.maxNotes ?? (Number.isFinite(envSampleSize) && envSampleSize > 0 ? envSampleSize : 60);
35
- const dryRun = options?.dryRun ?? false;
36
- const details = [];
37
- const candidates = getCandidateNotesForPruning(db, maxNotes);
38
- if (candidates.length < 5) {
39
- return {
40
- notesScanned: 0,
41
- notesExpired: 0,
42
- notesMerged: 0,
43
- durationMs: Date.now() - startMs,
44
- details: ["Too few candidate notes for pruning (< 5)."],
45
- };
46
- }
47
- const now = new Date();
48
- const notesText = candidates
49
- .map((row) => {
50
- const ageMs = now.getTime() - new Date(row.created_at).getTime();
51
- const ageDays = Math.round(ageMs / (1000 * 60 * 60 * 24));
52
- return `[${row.note_id}] (${row.type}, conf: ${row.confidence}, accesses: ${row.access_count}, age: ${ageDays}d) ${row.content}`;
53
- })
54
- .join("\n");
55
- const systemPrompt = `You are a memory quality manager. Review these semantic notes and identify problems.
56
-
57
- Notes to review:
58
- ${notesText}
59
-
60
- Output a JSON object:
61
- {
62
- "expire": [
63
- { "noteId": "sn_xxx", "reason": "Brief explanation" }
64
- ],
65
- "merge": [
66
- { "keepId": "sn_xxx", "expireId": "sn_yyy", "mergedContent": "Best combined version", "reason": "Brief explanation" }
67
- ]
68
- }
69
-
70
- Decision criteria:
71
- - EXPIRE if: the note is vague/non-actionable ("the system has issues"), trivially obvious, or clearly outdated (references old versions, completed tasks still marked pending)
72
- - MERGE if: two or more notes convey the same information — keep the more specific/accurate one. Provide mergedContent combining the best of both when useful.
73
- - KEEP (omit from output) if: the note contains unique, specific, actionable information
74
-
75
- Be conservative — when in doubt, keep the note. Only expire notes you are confident are low-value.
76
- Do NOT expire preferences or guardrails unless they clearly contradict each other.
77
- Return {"expire": [], "merge": []} if nothing needs pruning.`;
78
- try {
79
- const messages = [
80
- { role: "system", content: systemPrompt },
81
- {
82
- role: "user",
83
- content: "Review the notes above and identify any that should be expired or merged.",
84
- },
85
- ];
86
- const parsed = await chatCompletionJson(messages, apiKey, {
87
- model: process.env.CONSOLIDATION_MODEL ?? "gpt-4o",
88
- // Cross-thread pruning — no originating thread to attribute this to.
89
- category: "pruning",
90
- maxTokens: 4096,
91
- responseFormat: { type: "json_object" },
92
- timeoutMs: 60_000,
93
- });
94
- if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) {
95
- throw new Error(`LLM returned non-object response: ${typeof parsed}`);
96
- }
97
- const result = parsed;
98
- const expireActions = (Array.isArray(result.expire) ? result.expire : []);
99
- const mergeActions = (Array.isArray(result.merge) ? result.merge : []);
100
- const candidateIds = new Set(candidates.map((candidate) => candidate.note_id));
101
- let expired = 0;
102
- let merged = 0;
103
- const nowStr = nowISO();
104
- if (!dryRun) {
105
- db.transaction(() => {
106
- for (const action of expireActions) {
107
- if (!action.noteId)
108
- continue;
109
- if (!candidateIds.has(action.noteId)) {
110
- details.push(`[skip-expire] ${action.noteId} not in candidate set`);
111
- continue;
112
- }
113
- if (!hasActiveNote(db, action.noteId)) {
114
- details.push(`[skip-expire] ${action.noteId} not found or already expired`);
115
- continue;
116
- }
117
- expireNote(db, action.noteId, nowStr, "pruned");
118
- expired++;
119
- details.push(`[pruned] ${action.noteId}: ${action.reason}`);
120
- }
121
- for (const action of mergeActions) {
122
- if (!action.keepId || !action.expireId)
123
- continue;
124
- if (action.keepId === action.expireId) {
125
- details.push(`[skip-merge] ${action.keepId}: keepId === expireId`);
126
- continue;
127
- }
128
- if (!candidateIds.has(action.keepId) || !candidateIds.has(action.expireId)) {
129
- details.push(`[skip-merge] ${action.keepId}/${action.expireId} not in candidate set`);
130
- continue;
131
- }
132
- const keepNote = getActiveNoteContent(db, action.keepId);
133
- const expireNoteRow = getActiveNoteContent(db, action.expireId);
134
- if (!keepNote || !expireNoteRow) {
135
- details.push(`[skip-merge] ${action.keepId}/${action.expireId} not found`);
136
- continue;
137
- }
138
- mergeDuplicateNote(db, keepNote.noteId, expireNoteRow.noteId, nowStr, action.mergedContent && action.mergedContent !== keepNote.content
139
- ? action.mergedContent
140
- : undefined);
141
- merged++;
142
- details.push(`[merged] ${action.expireId} → ${action.keepId}: ${action.reason}`);
143
- }
144
- })();
145
- }
146
- else {
147
- for (const action of expireActions) {
148
- details.push(`[dry-run] [prune] ${action.noteId}: ${action.reason}`);
149
- expired++;
150
- }
151
- for (const action of mergeActions) {
152
- details.push(`[dry-run] [merge] ${action.expireId} → ${action.keepId}: ${action.reason}`);
153
- merged++;
154
- }
155
- }
156
- if (expired + merged > 0) {
157
- log.info(`[memory] Pruning: expired ${expired}, merged ${merged} note(s)`);
158
- }
159
- return {
160
- notesScanned: candidates.length,
161
- notesExpired: expired,
162
- notesMerged: merged,
163
- durationMs: Date.now() - startMs,
164
- details,
165
- };
166
- }
167
- catch (err) {
168
- const msg = errorMessage(err);
169
- log.error(`[memory] Pruning failed: ${msg}`);
170
- return {
171
- notesScanned: candidates.length,
172
- notesExpired: 0,
173
- notesMerged: 0,
174
- durationMs: Date.now() - startMs,
175
- details: [`Pruning failed: ${msg}`],
176
- };
177
- }
178
- }
179
- //# sourceMappingURL=memory-pruning.service.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"memory-pruning.service.js","sourceRoot":"","sources":["../../src/services/memory-pruning.service.ts"],"names":[],"mappings":"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"}
@@ -1,26 +0,0 @@
1
- <!--
2
- Default daily code review template for remote-copilot-mcp.
3
-
4
- Copy this file to ~/.remote-copilot-mcp/templates/daily-review.md to activate.
5
- Use with schedule_wake_up cron tasks, e.g.:
6
- schedule_wake_up({ label: "daily code review", cron: "0 9 * * *",
7
- prompt: "<contents of this template>" })
8
-
9
- Supported variables (replaced at render time):
10
- {{TIME}} — formatted timestamp
11
- -->
12
-
13
- 🔍 **Daily Code Review** — {{TIME}}
14
-
15
- Run the following checks and report the results:
16
-
17
- 1. **Architecture lint** — Run `node scripts/lint-architecture.mjs` to verify:
18
- - No source file exceeds 300 lines
19
- - No circular imports exist
20
- If any violations are found, list them and propose fixes.
21
-
22
- 2. **Compile check** — Run `npx tsc --noEmit` and report any type errors.
23
-
24
- 3. **Quick scan** — Skim recent git changes (`git log --oneline -10`) for anything that might need follow-up.
25
-
26
- Report progress when done, then call wait_for_instructions.
@@ -1,76 +0,0 @@
1
- ---
2
- name: Fire and Forget
3
- triggers:
4
- - fire and forget
5
- - background task
6
- - spawn autonomous thread
7
- - thread delegation no wait
8
- replaces_orchestrator: true
9
- ---
10
-
11
- ## Fire and Forget — Autonomous Worker Pattern
12
-
13
- ### Overview
14
- This skill describes the **fire-and-forget** pattern: you spawn a worker thread, send it a task, and **continue working immediately**. The worker executes autonomously and reports progress directly to the **operator** (not back to you).
15
-
16
- ### When to Use
17
- - Background cleanup tasks (log rotation, stale file removal)
18
- - Scheduled improvements that don't affect current work
19
- - Logging, monitoring, metrics collection
20
- - Any task where the result does NOT gate your next step
21
- - Long-running tasks you don't need to wait on
22
-
23
- ### When NOT to Use
24
- - Code reviews (you need the findings)
25
- - Any task where the output determines your next action
26
- - Tasks that modify files you're also editing (conflict risk)
27
- - Work with acceptance criteria you need to verify → use **Handoff** instead
28
-
29
- ### Core Pattern
30
-
31
- #### Step 1 — Spawn the worker thread
32
- ```
33
- start_thread(
34
- name: "Background Cleanup",
35
- task: "You handle background maintenance tasks autonomously."
36
- )
37
- → returns { threadId: <WORKER_THREAD_ID> }
38
- ```
39
-
40
- #### Step 2 — Send the task with worker skill
41
- ```
42
- send_message_to_thread(
43
- threadId: <WORKER_THREAD_ID>,
44
- message: "Load the 'Worker — Autonomous' skill via get_skill for reporting instructions.
45
-
46
- Task: Clean up stale log files older than 30 days in ~/.remote-copilot-mcp/logs/."
47
- )
48
- ```
49
-
50
- **KEY**: The task includes `Load the 'Worker — Autonomous' skill via get_skill` which teaches the worker to report to the **operator** directly using `report_progress` or `send_voice` — not back to the orchestrator.
51
-
52
- #### Step 3 — Continue working immediately
53
- Do NOT call `wait_for_instructions` for this worker. Continue with your own work. The worker runs independently.
54
-
55
- ### Worker Behavior
56
- The autonomous worker should:
57
- - Execute the task independently
58
- - Report progress to the **operator** via `report_progress` or `send_voice`
59
- - NOT send messages back to the orchestrator thread
60
- - Handle errors gracefully and notify the operator if something fails
61
-
62
- ### Rules
63
-
64
- - **NEVER** call `wait_for_instructions` after a fire-and-forget delegation.
65
- - **ALWAYS** tell the worker to report to the operator, not back to the orchestrator.
66
- - **ALWAYS** include explicit instructions like "Do NOT message the sender back."
67
- - Use this pattern only when the result doesn't affect your immediate work.
68
- - If you later realize you need the result, spawn a new **Handoff** task instead.
69
-
70
- ### Anti-Patterns
71
-
72
- - ❌ Waiting on a fire-and-forget worker (defeats the purpose)
73
- - ❌ Worker sending results back to the orchestrator instead of the operator
74
- - ❌ Using fire-and-forget for tasks that gate your next step
75
- - ❌ Spawning fire-and-forget workers that modify files you're actively editing
76
- - ❌ Forgetting to tell the worker how to report progress (operator gets no visibility)
@@ -1,33 +0,0 @@
1
- ---
2
- name: Offload
3
- triggers:
4
- - offload
5
- - use subagents
6
- - use a subagent
7
- - delegate to subagents
8
- - run subagent
9
- - keep context lean
10
- - protect context
11
- ---
12
-
13
- # CORE
14
- Protect your own context by pushing work into **in-process subagents** (the Agent/Task tool) instead of doing it inline. A subagent burns its OWN context on the raw material and returns only a distilled result — your main thread stays lean.
15
-
16
- **Offload vs Swarm — don't confuse them.** Swarm fans out to worker *threads*: separate processes, truly parallel, own memory, visible in Telegram, can push a wake-up. Offload uses in-process *subagents*: ephemeral, same session, no topic/no memory, returning into your current turn. Use Offload for context hygiene inside one session; use Swarm for parallel cross-process work.
17
-
18
- # When to offload
19
- - **Read-heavy exploration:** broad greps, reading many files, tracing call graphs, doc/web research — offload it, keep only the summary.
20
- - **Trial-and-error or verbose tool output** you don't need to retain.
21
- - **Implementation on a long-running thread:** hand the edit + build/typecheck to a subagent and get back a summary, so diffs and logs don't bloat your context.
22
-
23
- # How
24
- - Give the subagent a **self-contained** task and state exactly what to RETURN (a distilled answer, not raw dumps). It has no memory of this conversation — brief it fully.
25
- - Run subagents **synchronously within the turn**: dispatch, wait for the result inline, then act. Do NOT park in `wait_for_instructions` with a subagent in flight — a subagent's completion cannot wake a parked long-poll (only worker-thread replies can).
26
- - **Scope:** one subagent per coherent unit. Parallelize only genuinely independent read/exploration tasks.
27
-
28
- # When NOT to offload
29
- - Trivial single lookups where the round-trip costs more context than it saves.
30
- - Work whose intermediate detail you actually need to keep in the main thread.
31
-
32
- # Self-check
33
- Did raw exploration or tool output land in my main context when a subagent could have absorbed it and returned only the distillate?
@@ -1,114 +0,0 @@
1
- ---
2
- name: Sensorium Self-Repair
3
- triggers:
4
- - debug sensorium
5
- - fix sensorium
6
- - repair sensorium
7
- - sensorium crashing
8
- - sensorium is crashing
9
- - sensorium down
10
- - sensorium broken
11
- - mcp crashing
12
- - mcp is dead
13
- - supervisor loop
14
- - restart loop
15
- - emergency repair
16
- - sensorium не працює
17
- - сенсоріум крешить
18
- replaces_orchestrator: true
19
- ---
20
-
21
- # Sensorium Self-Repair Skill
22
-
23
- You are repairing **Sensorium itself** (this MCP server + its .NET supervisor) — a live production system the operator depends on. Move deliberately: **establish ground truth from logs and processes before changing anything**, distinguish real crashes from false-death loops, fix the root cause, validate, then ship. Do NOT guess. Do NOT restart blindly.
24
-
25
- ## Golden rules (read first)
26
-
27
- - **Root cause over symptoms.** A restart "fixes" nothing if the bug recurs. Find the exact file:line and the commit that introduced it.
28
- - **Verify file contents via terminal, never trust cached reads.** The `read_file` tool can serve a STALE copy (it served an old `package.json` version during a real incident). For anything you will edit or reason about critically, confirm with `git show HEAD:<path>` or `Get-Content <path>`.
29
- - **Never trust a subagent's described diff.** Subagents have hallucinated multi-hundred-line diffs for files that were clean. Always confirm with `git diff` / `git status` in a terminal yourself.
30
- - **Phantom working-tree changes = stale VS Code editor buffers.** Files silently reverting to OLD versions on disk (a committed fix undone, `package.json` version rolled back) is caused by VS Code `files.autoSave` + `files.hotExit` writing a stale editor buffer to disk — NOT an agent, NOT you editing manually. It's the same mechanism that "clobbers" AI-edited files mid-session. Confirm: `git status`/`git diff` shows a stale revert; check `%APPDATA%\Code\Backups\**` for hot-exit backups whose mtime is *after* your last save (⇒ an unreloaded window is holding a stale buffer). Fix permanently: set `"files.autoSave": "off"` + `"files.hotExit": "off"` in User settings, then `Revert File` on the stale tabs and reload the window. Until the window reloads, the risk persists for it.
31
- - **Watch for concurrent autonomous agents.** A Sensorium worker may be committing to this repo *while you work*. Re-check `git HEAD`, branch, and `git log` before and after edits; a fix you were about to write may already be committed. (But a spontaneous working-tree revert is usually the VS-Code-buffer issue above, not an agent — verify file mtimes: an agent write shows a recent mtime, a buffer flush may not.)
32
- - **Git safety:** stage explicit paths only. NEVER `git add -A/./-u`, `git commit -a`. NEVER commit `tmp_*`, dumps, screenshots, or binaries.
33
- - **Deploy ≠ push.** Pushing to git does not update the running system (see "Ship & deploy").
34
-
35
- ## Key facts & locations
36
-
37
- - **Repo:** the workspace root (e.g. `c:\src\remote-copilot-mcp`). **Runtime data dir:** `~/.remote-copilot-mcp` (`$HOME`/`%USERPROFILE%`).
38
- - **Logs** under `~/.remote-copilot-mcp/logs/`:
39
- - `mcp/server.log` — MCP app log (rotated ~5 MB).
40
- - `mcp/mcp-stderr-YYYYMMDD.log` — captured MCP stderr (fatal errors, startup banners, `[wait]`/`[telegram]` activity).
41
- - `supervisor/supervisor-YYYYMMDD.log` — supervisor restart/health decisions (very noisy with Telegram `getUpdates`; filter it out). **Timezone caveat:** MCP logs (`server.log`, `mcp-stderr`) are **UTC** (`...Z`); the supervisor log was historically **LOCAL**, but a `UtcTimestampFormatter` change can switch it to UTC — always cross-reference one shared event (e.g. "MCP server is ready" vs the node startup banner) to confirm which, before correlating timestamps.
42
- - **Process model:** the .NET supervisor process `sensorium-supervisor` supervises a Node MCP server (**HTTP port 3847**) + watcher (**3848**). MCP start command is either `node dist/index.js` (local build) or `npx -y sensorium-mcp@latest` (published). Workers are `claude`/`codex`/`copilot` processes whose command line references `.remote-copilot-mcp` — **a process check that queries only `node`/`sensorium-supervisor` will MISS every worker and falsely report "no threads running." Always include `claude,codex,copilot`.**
43
- - **`~/.remote-copilot-mcp/server.pid`** holds `{"pid":N}` — should match the port-3847 owner. A mismatch is the signature of a false-death loop.
44
- - **Windows: `git` is often NOT on PATH.** Locate it (`%LOCALAPPDATA%\Programs\Git\cmd\git.exe` or `C:\Program Files\Git\cmd\git.exe`) and call it by full path.
45
- - **Prior root causes are logged in memory:** read `/memories/repo/critical-fixes-log.md`, `/memories/repo/keeper-stuck-detection-bug.md`, `/memories/repo/sensorium-architecture.md` before theorizing — the bug may be known.
46
-
47
- ## Triage workflow
48
-
49
- 1. **Ground truth first.** `git rev-parse --abbrev-ref HEAD`, `git log --oneline -20`, `git status --short`. Correlate the symptom's start time with recent commits (a bad push is the usual cause).
50
- 2. **Real crash vs. false-death loop.** In `supervisor-YYYYMMDD.log`, count `MCP server process is dead — restarting` events and their cadence. Then in `mcp-stderr-YYYYMMDD.log` check whether ONE process kept serving across those times (continuous `[wait]`/`[telegram]` activity, message-ids incrementing, **no startup banner between restarts**). Continuous serving ⇒ the server never actually died ⇒ **false-death loop** (see failure modes), not a code crash.
51
- 3. **Runtime state.** Enumerate node processes + port owners; compare `server.pid` to the port-3847 owner:
52
- ```powershell
53
- Get-Process node,sensorium-supervisor -EA SilentlyContinue | Select Id,ProcessName,StartTime
54
- Get-NetTCPConnection -LocalPort 3847,3848 -State Listen -EA SilentlyContinue
55
- Get-Content ~/.remote-copilot-mcp/server.pid
56
- ```
57
- `server.pid` ≠ port owner (but port owner alive) confirms a stale-pid false-death loop.
58
- 4. **Find the real fatal error.** In `mcp-stderr-YYYYMMDD.log` search the crash window for `uncaughtException|unhandledRejection|Error:|EADDRINUSE|ECONNREFUSED|Cannot find module|out of memory`. In `supervisor` log, filter noise: `Get-Content <log> | Where-Object { $_ -notmatch 'getUpdates|api.telegram|processing HTTP|response headers' }`.
59
-
60
- ## Known failure modes
61
-
62
- - **False-death restart loop (supervisor).** Health loop declared the MCP dead from a stale `server.pid` without an HTTP cross-check, then spawned a duplicate that couldn't bind 3847 → died → `server.pid` repointed to the dead duplicate → loop every health interval, while the real server kept serving. Fix pattern: probe HTTP (`IsServerReadyAsync`) before killing — restart only when PID dead **and** port silent (`SupervisorWorker.cs`).
63
- - **Cascade restart after MCP restart.** In-memory `spawnedThreads` empties → `isThreadRunning()` false for all → keeper restarts everything. Fix: rebuild tracking from PID files on startup.
64
- - **Keeper "stuck" kills keepAlive threads.** `wait_for_instructions` long-poll didn't refresh the per-thread heartbeat → keeper declared stuck → killed. Fix: write `writeThreadHeartbeat()` in the poll loop.
65
- - **Duplicate thread spawns.** Keeper checks the root threadId but `start_thread` creates a worker with a different id → always "not running" → re-spawns. Fix: track the worker id from the `start_thread` response.
66
- - **Copilot process dies / no memory.** `copilot.bat` (VS Code wrapper) spawned detached dies silently — prefer `copilot.exe`; and a missing `thread_id` column crashed bootstrap. See critical-fixes-log.
67
- - **Reads but no reply — Claude worker answers into invisible stdout.** 👀 is set on message *consume*, not on reply (so 👀 ≠ answered). With Claude tool search active, reply tools (`report_progress`/`send_voice`/`send_message_to_thread`) are deferred, so a conversational agent emits answers as plain `text` → its stdout transcript, never delivered. Signature: `server.log` `Read N messages … Processing…` with no following delivery `tool_use`. First rule out routing (operator's topic must equal the thread's `thread_registry.telegram_topic_id`; inbound `resolveThreadForTopic`/outbound `resolveTelegramTopicId` are symmetric). Fix: `ENABLE_TOOL_SEARCH=false` so tools load upfront, then **respawn the worker** (see Deploy).
68
- - **Self-update port-handoff race (real but often MIS-attributed — do not over-chase).** In theory a new node self-registers its pid asynchronously, so `server.pid` can transiently name a dead pid while HTTP is healthy. BUT the self-update poller is gated behind a ~10-min min-uptime **AND** `remoteVersion !== currentVersion`, so at the latest published version it is a silent no-op. Before blaming self-update, confirm it is ACTUALLY firing: look for `[self-update] Channel version changed` / `Closing HTTP server` and a non-empty `update-spawn.log`; a `[self-update] Deferring — uptime …s < min 600s` line proves it is NOT updating. In practice the recent restart loops were **event-loop freeze** (heavy startup work) and **network outages to Telegram**, not self-update.
69
- - **False `hung-mcp-restart` from a stale probe socket.** The supervisor's liveness probe (`OPTIONS /mcp`, `McpClient.IsServerReadyAsync`) reused a **dead keep-alive socket** from the pooled `HttpClient` after a prior restart, so it failed at the connection level (~2s) while the server was healthy and serving `POST /mcp` — `HealthFailThresh` such failures → needless restart + `hung-mcp-restart` maintenance flag. Tell-tale: `report_progress`/tool calls succeed within seconds of the `not responding to HTTP` verdict, AND a **freshly spawned replacement also fails the probe for ~2 min** while `POST /mcp` returns 200. Fix: force a fresh connection on the probe (`req.Headers.ConnectionClose = true`) and cross-check thread activity before killing. The same stale-probe defect also flapped supervisor `/ready` 503 (per-request live probe, no hysteresis) → debounced with a 15s last-good window.
70
- - **Full briefing after a supervisor-triggered restart = missing reconnect snapshot.** `start_session` gives a *lightweight* reconnect only if the maintenance flag OR the `active-sessions.json` snapshot is present. Self-update writes the snapshot in-process; but supervisor force-restarts (`taskkill /F` for hung/dead/orphan/cmd) deliver **no signal**, so the graceful `shutdown()` snapshot never runs, and the supervisor's `POST /api/prepare-shutdown` used to be a **404 no-op**. Result: reconnecting workers that still have context get a full re-briefing (token/time waste, mass-reconnect freeze risk). Symptom: `preexisting but no reconnect signal (maintenance=false, snapshot=false) — full briefing` + `[reconnect-snapshot] Miss`. Fix: implement `POST /api/prepare-shutdown` to write the snapshot (one endpoint covers all force-restart paths).
71
- - **Post-restart reconnect fragility.** The `hung-mcp-restart` maintenance response makes the AGENT run a *blocking* PowerShell poll of supervisor `/ready` (8848), then manually `start_session`. While in that poll the worker is blind to the operator, and the only recovery net is the keeper's **~1h** stuck threshold (by design: `wait_for_instructions` long-polls refresh the heartbeat, so 1h avoids false-killing idle workers). A worker that never cleanly reconnects looks frozen for up to an hour — **respawn it to recover fast**.
72
-
73
- ## Emergency stop & restart
74
-
75
- Kill in this order so nothing auto-respawns; be **targeted** (never blanket-kill `node`/`claude`/`copilot` — the operator has an interactive coding session):
76
-
77
- 1. **Supervisor first** (`sensorium-supervisor`) — otherwise it restarts the MCP you kill.
78
- 2. **MCP server + watcher** — the Node processes owning ports 3847/3848 or whose command line matches `sensorium-mcp` / `remote-copilot-mcp`.
79
- 3. **Worker agents** — only `claude`/`codex`/`copilot` whose command line contains `.remote-copilot-mcp`.
80
-
81
- ```powershell
82
- Get-CimInstance Win32_Process |
83
- Where-Object { $_.CommandLine -match 'remote-copilot-mcp|sensorium-mcp' -or $_.Name -eq 'sensorium-supervisor.exe' } |
84
- Select-Object ProcessId,Name,CommandLine # ENUMERATE and confirm BEFORE killing
85
- ```
86
-
87
- Then `Stop-Process -Id <pid> -Force` in the order above. Verify ports 3847/3848 are free afterward. Do NOT delete lock/PID/data files unless the operator asked. If a process is unkillable (`Access denied`), report it — the operator must intervene.
88
-
89
- ## Fix, validate, ship
90
-
91
- - **Validate before pushing:**
92
- - TypeScript: `npx tsc --noEmit` (must exit 0).
93
- - Supervisor: `dotnet test supervisor-dotnet/tests/Sensorium.Supervisor.Tests.csproj`.
94
- - Node tests: `npm test` — **requires Node ≥ 21** (`node --test` glob). CI matrix runs Node 22/24.
95
- - **Expert review** the change (dispatch a review subagent; verify security: command injection, path traversal, secrets).
96
- - **Ship:** `npm version patch --no-git-tag-version` → commit explicit paths (`fix(...)` then `chore(release): x.y.z`) → `git push origin main`.
97
- - **CI:** confirm green — `gh run watch <run-id> --repo <owner>/<repo> --exit-status`. Fix and re-push until green.
98
- - **Deploy at runtime (push alone does NOT deploy):**
99
- - **MCP server** running via `npx sensorium-mcp@latest` picks up a new version only after **`npm publish`** (the watcher auto-updates). A local `node dist/index.js` needs `npm run build`. **Already-running workers keep their old spawn behavior even after the server updates — respawn them to apply spawn-side fixes.** `ENABLE_TOOL_SEARCH=false` is the right knob (Claude ≥2.1.7), but an `env` block in `~/.claude/settings.json` overrides the spawn env, and the spawn copies that file wholesale into the per-thread `CLAUDE_CONFIG_DIR` (dragging in the operator's own MCP servers).
100
- - **Supervisor** (.NET) needs a **rebuild + reinstall via `Install-Sensorium.ps1`** to apply supervisor code changes — a running supervisor keeps its old binary in memory.
101
-
102
- ## Field notes (hard-won — check these before deep code work)
103
-
104
- - **"No threads connected" / a thread won't respond is usually NOT a dead thread.** First confirm liveness, don't assume: heartbeats in `~/.remote-copilot-mcp/heartbeats/{threadId}` fresh (age < ~5s) + a live `claude` worker per `pids/{threadId}.pid` = the thread IS alive. If threads are alive but the operator can't reach them, the break is the **Telegram delivery path** or the agent replying into stdout (see failure modes), not the thread.
105
- - **The Claude worker's stream-json transcript is ground truth for agent behavior** — `~/.remote-copilot-mcp/logs/threads/<Name>_<threadId>_<YYYY-MM-DD>.json` (NDJSON; file-fd stdout+stderr, survives server restarts). Per `type:"assistant"` block: `text` = invisible to operator, `tool_use` of a delivery tool = actually sent. `type:"rate_limit_event"` = Claude 5-hour cap (`resetsAt` = epoch secs); `subtype:"api_retry"` = transient API errors. Fresh MCP heartbeat + **stale transcript mtime** = worker idle in the long-poll (normal), not frozen.
106
- - **`[dispatcher] Poll error: fetch failed` (repeating every ~6s) + `.NET` supervisor `SocketException 10054 "connection forcibly closed by remote host"` = a NETWORK outage to `api.telegram.org`, not a code bug.** On laptops this correlates with Wi-Fi drops / Modern Standby / power-source flapping (see Windows Event Log `Kernel-Power` 105/506/507). Test reachability directly: `Resolve-DnsName api.telegram.org`, `Test-NetConnection api.telegram.org -Port 443`, `Invoke-WebRequest https://api.telegram.org -Method Head`. If those pass but the MCP still shows no successful polls, the dispatcher may not have recovered from the socket reset → **restart the MCP** to re-establish polling.
107
- - **Responsive vs frozen vs exited — three different states, check explicitly.** `Invoke-WebRequest -Method Options http://127.0.0.1:3847/{health,ready,mcp}` returning **204** + `Get-Process -Id <pid>` `Responding=True` = event loop ALIVE (so any "silence" is a stuck sub-loop like the Telegram poller, not a freeze). No HTTP answer but port still LISTENing = frozen. Port CLOSED (`connection refused`) = process EXITED.
108
- - **Use the lifecycle instrumentation (shipped 3.0.79+).** On a death, `server.log` gets `[lifecycle] process exit code=N uptime=Ns`; a real OS signal logs `[lifecycle] received signal ...`; a native fatal error writes `report*.json` in `logs/mcp/`; an internal self-kill attempt logs `[process] killProcessTree pid=… caller=…` or `[process] REFUSED kill … self-protection`. **`exit code=0 uptime=0-2s` markers are BENIGN** — short-lived launcher/duplicate processes that found the port taken and bailed cleanly, not the real server dying.
109
- - **Windows Event Log is decisive for native crash vs external kill.** No `Application Error` (Event 1000) for `node.exe` at the death time ⇒ **not** a native crash (e.g. not `better_sqlite3`). No `[lifecycle]`/`[shutdown]`/`[fatal]` line either ⇒ the process was hard-killed externally (`taskkill /F` / `TerminateProcess`, which bypass signal handlers and WER) — audit the internal kill paths (`killProcessTree caller=…`) and any second supervisor doing `KillByPort`.
110
- - **Event-loop freeze death-spiral.** Heavy synchronous startup work (better-sqlite3 consolidation, narrative backfill, per-thread `start_session` bootstrap embeddings across many reconnecting threads) blocks the loop past the supervisor's ~3s HTTP readiness probe → supervisor kills+respawns → the fresh process re-runs the same work → re-freeze. Mitigations: persist a per-day marker so consolidation/rotation run **once per day** across restarts (`src/data/daily-marker.ts`); defer/chunk heavy startup work off the readiness window.
111
-
112
- ## After an incident
113
-
114
- Record the root cause, the fix, the commit hash, and the version in `/memories/repo/critical-fixes-log.md` (append, don't rewrite) so the next repair starts from knowledge, not zero.