@north-light/crouter 0.3.317 → 0.3.319

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 (1305) hide show
  1. package/README.md +0 -3
  2. package/dist/api/client.d.ts +1 -1
  3. package/dist/api/client.js +2 -912
  4. package/dist/api/dto/attach.js +0 -13
  5. package/dist/api/dto/bash-jobs.js +1 -9
  6. package/dist/api/dto/broker-ops.js +0 -6
  7. package/dist/api/dto/broker.js +0 -20
  8. package/dist/api/dto/canvas.js +0 -2
  9. package/dist/api/dto/chat-inventory.js +0 -11
  10. package/dist/api/dto/common.js +1 -15
  11. package/dist/api/dto/config.js +0 -3
  12. package/dist/api/dto/crons.js +1 -10
  13. package/dist/api/dto/files.js +0 -7
  14. package/dist/api/dto/focus.js +0 -10
  15. package/dist/api/dto/health.js +0 -2
  16. package/dist/api/dto/human-requests.js +0 -4
  17. package/dist/api/dto/human.js +0 -4
  18. package/dist/api/dto/inbox.js +0 -4
  19. package/dist/api/dto/lifecycle.js +0 -3
  20. package/dist/api/dto/mail.js +0 -1
  21. package/dist/api/dto/memory.js +0 -6
  22. package/dist/api/dto/messages.js +0 -2
  23. package/dist/api/dto/model-config.js +0 -1
  24. package/dist/api/dto/modelauth.js +0 -4
  25. package/dist/api/dto/node-outcomes.js +0 -2
  26. package/dist/api/dto/nodes.js +0 -3
  27. package/dist/api/dto/profiles.js +1 -4
  28. package/dist/api/dto/recovery.js +0 -1
  29. package/dist/api/dto/reports.js +0 -2
  30. package/dist/api/dto/review-comments.js +0 -5
  31. package/dist/api/dto/reviews.js +0 -5
  32. package/dist/api/dto/subscriptions.js +0 -2
  33. package/dist/api/dto/worktree.js +0 -6
  34. package/dist/api/errors.js +1 -40
  35. package/dist/api/index.js +1 -33
  36. package/dist/api/plugin-manifest-schema.js +0 -23
  37. package/dist/api/routes.js +1 -147
  38. package/dist/build-root.js +1 -198
  39. package/dist/cli.js +3 -99
  40. package/dist/clients/attach/ansi-cells.js +1 -137
  41. package/dist/clients/attach/chrome/bash-jobs.js +1 -31
  42. package/dist/clients/attach/chrome/canvas-panels.js +1 -194
  43. package/dist/clients/attach/chrome/completion-bell.js +1 -89
  44. package/dist/clients/attach/chrome/cron-wait.js +1 -34
  45. package/dist/clients/attach/chrome/git-info.js +2 -44
  46. package/dist/clients/attach/chrome/header.js +1 -30
  47. package/dist/clients/attach/chrome/inbox-strip.js +1 -199
  48. package/dist/clients/attach/chrome/recap.js +1 -19
  49. package/dist/clients/attach/chrome/review-wait.js +1 -22
  50. package/dist/clients/attach/chrome/roster.js +4 -275
  51. package/dist/clients/attach/chrome/status-line.js +1 -117
  52. package/dist/clients/attach/chrome/ticket-panel.js +1 -280
  53. package/dist/clients/attach/chrome/widgets.js +1 -51
  54. package/dist/clients/attach/command.js +1 -107
  55. package/dist/clients/attach/config.js +1 -274
  56. package/dist/clients/attach/input/capabilities.js +1 -104
  57. package/dist/clients/attach/input/clipboard-image.js +3 -220
  58. package/dist/clients/attach/input/completion-frecency.js +1 -141
  59. package/dist/clients/attach/input/controller.js +7 -377
  60. package/dist/clients/attach/input/overlay-owner.js +1 -199
  61. package/dist/clients/attach/input/ref-autocomplete.js +2 -176
  62. package/dist/clients/attach/input/titled-editor.js +4 -859
  63. package/dist/clients/attach/overlays/auth.js +2 -271
  64. package/dist/clients/attach/overlays/dialogs.js +2 -102
  65. package/dist/clients/attach/overlays/file-review.js +2 -128
  66. package/dist/clients/attach/overlays/graph.js +1 -661
  67. package/dist/clients/attach/overlays/help.js +1 -211
  68. package/dist/clients/attach/overlays/mcp.js +1 -302
  69. package/dist/clients/attach/overlays/pickers.js +1 -163
  70. package/dist/clients/attach/render/activity-slot.js +1 -13
  71. package/dist/clients/attach/render/assistant-message.js +1 -56
  72. package/dist/clients/attach/render/card-presentation.js +5 -218
  73. package/dist/clients/attach/render/chat-view.js +5 -1708
  74. package/dist/clients/attach/render/condensed-history.js +1 -60
  75. package/dist/clients/attach/render/context-message.js +1 -63
  76. package/dist/clients/attach/render/crtr-output.js +17 -905
  77. package/dist/clients/attach/render/diagram.js +7 -111
  78. package/dist/clients/attach/render/edit-diff.js +5 -304
  79. package/dist/clients/attach/render/glyph-codepoints.js +1 -42
  80. package/dist/clients/attach/render/group-activity.js +2 -263
  81. package/dist/clients/attach/render/group-recap.js +1 -152
  82. package/dist/clients/attach/render/markdown-source.js +5 -266
  83. package/dist/clients/attach/render/measured-container.js +1 -322
  84. package/dist/clients/attach/render/page-block.js +1 -183
  85. package/dist/clients/attach/render/scroll-animation.js +1 -80
  86. package/dist/clients/attach/render/tool-calls.js +3 -361
  87. package/dist/clients/attach/render/transcript-copy.js +2 -81
  88. package/dist/clients/attach/render/transcript-search.js +1 -152
  89. package/dist/clients/attach/render/viewport.js +1 -184
  90. package/dist/clients/attach/session/banner.js +1 -29
  91. package/dist/clients/attach/session/bindings.js +1 -71
  92. package/dist/clients/attach/session/chrome-refresh.js +1 -94
  93. package/dist/clients/attach/session/connection.js +1 -186
  94. package/dist/clients/attach/session/context.js +0 -16
  95. package/dist/clients/attach/session/editor-frame.js +1 -142
  96. package/dist/clients/attach/session/editor-inventory.js +6 -160
  97. package/dist/clients/attach/session/file-links.js +1 -68
  98. package/dist/clients/attach/session/focus-events.js +1 -12
  99. package/dist/clients/attach/session/frame.js +1 -214
  100. package/dist/clients/attach/session/frames.js +1 -188
  101. package/dist/clients/attach/session/identity.js +1 -26
  102. package/dist/clients/attach/session/input-wiring.js +1 -140
  103. package/dist/clients/attach/session/invariant.js +1 -15
  104. package/dist/clients/attach/session/keys.js +1 -77
  105. package/dist/clients/attach/session/layout.js +1 -59
  106. package/dist/clients/attach/session/mouse.js +1 -78
  107. package/dist/clients/attach/session/pane-focus.js +1 -42
  108. package/dist/clients/attach/session/pane-tag.js +1 -112
  109. package/dist/clients/attach/session/pi-assets.js +1 -24
  110. package/dist/clients/attach/session/pi-oauth-flows.js +1 -21
  111. package/dist/clients/attach/session/profile-files.js +1 -228
  112. package/dist/clients/attach/session/reconnect.js +1 -175
  113. package/dist/clients/attach/session/selection.js +3 -108
  114. package/dist/clients/attach/session/state-sync.js +1 -67
  115. package/dist/clients/attach/session/surface-frame.js +1 -73
  116. package/dist/clients/attach/session/surface-host.js +1 -255
  117. package/dist/clients/attach/session/teardown.js +5 -94
  118. package/dist/clients/attach/session/transcript-search.js +3 -151
  119. package/dist/clients/attach/session/whip-achievements.js +2 -145
  120. package/dist/clients/attach/session/whip.js +1 -362
  121. package/dist/clients/attach/slash/dispatch.js +1 -706
  122. package/dist/clients/attach/slash/prompt-preview.js +1 -121
  123. package/dist/clients/attach/viewer.js +1 -1
  124. package/dist/clients/conversation/projection.js +1 -324
  125. package/dist/clients/conversation/submit.js +1 -51
  126. package/dist/clients/inbox/controller.js +1 -701
  127. package/dist/clients/inbox/dto-adapt.js +1 -93
  128. package/dist/clients/inbox/layout.js +1 -9
  129. package/dist/clients/inbox/page-adapter.js +1 -55
  130. package/dist/clients/inbox/resolve.js +1 -35
  131. package/dist/clients/inbox/review/anchors.js +1 -89
  132. package/dist/clients/inbox/review/comments-client.js +1 -98
  133. package/dist/clients/inbox/review/companion-pane.js +1 -82
  134. package/dist/clients/inbox/review/document-surface.js +2 -1188
  135. package/dist/clients/inbox/review/frame.js +1 -216
  136. package/dist/clients/inbox/review/keys.js +1 -123
  137. package/dist/clients/inbox/review/launch.js +1 -151
  138. package/dist/clients/inbox/review/live-source.js +1 -160
  139. package/dist/clients/inbox/review/nvim.js +1 -44
  140. package/dist/clients/inbox/review/remap.js +1 -157
  141. package/dist/clients/inbox/review/review-client.js +1 -123
  142. package/dist/clients/inbox/review/roundtrip.js +3 -36
  143. package/dist/clients/inbox/review/state.js +4 -315
  144. package/dist/clients/inbox/review-adapter.js +1 -43
  145. package/dist/clients/inbox/surface.js +1 -152
  146. package/dist/clients/inbox/tui/ansi.js +3 -321
  147. package/dist/clients/inbox/tui/input.js +5 -392
  148. package/dist/clients/inbox/tui/keys.js +1 -104
  149. package/dist/clients/inbox/tui/page-body.js +1 -66
  150. package/dist/clients/inbox/tui/panel.js +1 -84
  151. package/dist/clients/inbox/tui/render.js +2 -368
  152. package/dist/clients/inbox/tui/slots.js +3 -134
  153. package/dist/clients/inbox/tui/types.js +0 -1
  154. package/dist/clients/inbox/tui.js +1 -86
  155. package/dist/clients/surfaces/host.js +0 -1
  156. package/dist/commands/api-client.js +4 -290
  157. package/dist/commands/attention.js +1 -215
  158. package/dist/commands/canvas-browse.js +1 -70
  159. package/dist/commands/canvas-config.js +2 -192
  160. package/dist/commands/canvas-history/grep.js +7 -85
  161. package/dist/commands/canvas-history/read.js +3 -50
  162. package/dist/commands/canvas-history/search.js +10 -99
  163. package/dist/commands/canvas-history/shared.js +1 -139
  164. package/dist/commands/canvas-history/stats.js +6 -68
  165. package/dist/commands/canvas-history.js +1 -32
  166. package/dist/commands/canvas-issue.js +14 -149
  167. package/dist/commands/canvas-prune.js +1 -108
  168. package/dist/commands/canvas-roster.js +1 -69
  169. package/dist/commands/canvas-snapshot.js +1 -34
  170. package/dist/commands/canvas-use.js +1 -61
  171. package/dist/commands/canvas.js +1 -49
  172. package/dist/commands/chord.js +1 -241
  173. package/dist/commands/cron.js +11 -534
  174. package/dist/commands/dashboard.js +1 -85
  175. package/dist/commands/human/components.js +3 -77
  176. package/dist/commands/human/feedback.js +1 -112
  177. package/dist/commands/human/prompts.js +1 -331
  178. package/dist/commands/human/queue.js +1 -191
  179. package/dist/commands/human/request.js +1 -266
  180. package/dist/commands/human/review.js +1 -288
  181. package/dist/commands/human/shared.js +1 -67
  182. package/dist/commands/human.js +4 -60
  183. package/dist/commands/memory/delete.js +1 -100
  184. package/dist/commands/memory/edit.js +21 -219
  185. package/dist/commands/memory/find.js +2 -244
  186. package/dist/commands/memory/history.js +5 -199
  187. package/dist/commands/memory/lint.js +1 -107
  188. package/dist/commands/memory/list.js +1 -142
  189. package/dist/commands/memory/move.js +1 -223
  190. package/dist/commands/memory/origin.js +1 -130
  191. package/dist/commands/memory/read.js +6 -232
  192. package/dist/commands/memory/shared.js +12 -802
  193. package/dist/commands/memory/write.js +13 -235
  194. package/dist/commands/memory.js +1 -30
  195. package/dist/commands/node/bash.js +5 -245
  196. package/dist/commands/node/create.js +3 -332
  197. package/dist/commands/node/inspect.js +12 -300
  198. package/dist/commands/node/lifecycle.js +2 -453
  199. package/dist/commands/node/message.js +1 -161
  200. package/dist/commands/node/outcome.js +4 -134
  201. package/dist/commands/node/pyramid.js +2 -79
  202. package/dist/commands/node/subscription.js +1 -78
  203. package/dist/commands/node/wait.js +7 -163
  204. package/dist/commands/node-context.js +2 -159
  205. package/dist/commands/node-inspect-artifacts.js +8 -109
  206. package/dist/commands/node-lifecycle-revive.js +1 -217
  207. package/dist/commands/node-snapshot.js +1 -37
  208. package/dist/commands/node-transcript.js +1 -62
  209. package/dist/commands/node-worktree.js +1 -138
  210. package/dist/commands/node.js +1 -29
  211. package/dist/commands/pkg/browse/actions.js +1 -198
  212. package/dist/commands/pkg/browse/catalog.js +1 -466
  213. package/dist/commands/pkg/browse/command-view.js +1 -191
  214. package/dist/commands/pkg/browse/detail-panel.js +1 -402
  215. package/dist/commands/pkg/browse/doc-view.js +1 -89
  216. package/dist/commands/pkg/browse/list-panel.js +2 -168
  217. package/dist/commands/pkg/browse/model.js +1 -36
  218. package/dist/commands/pkg/browse/shell.js +1 -640
  219. package/dist/commands/pkg/browse.js +1 -27
  220. package/dist/commands/pkg/market-inspect.js +1 -141
  221. package/dist/commands/pkg/market-manage.js +1 -327
  222. package/dist/commands/pkg/market.js +1 -14
  223. package/dist/commands/pkg/plugin-inspect.js +1 -168
  224. package/dist/commands/pkg/plugin-manage.js +17 -1109
  225. package/dist/commands/pkg/plugin.js +1 -14
  226. package/dist/commands/pkg/shared.js +1 -62
  227. package/dist/commands/pkg.js +1 -21
  228. package/dist/commands/profile/default.js +1 -139
  229. package/dist/commands/profile/delete.js +1 -66
  230. package/dist/commands/profile/env.js +3 -188
  231. package/dist/commands/profile/kind.js +2 -35
  232. package/dist/commands/profile/list.js +1 -43
  233. package/dist/commands/profile/meta.js +1 -67
  234. package/dist/commands/profile/new.js +1 -115
  235. package/dist/commands/profile/pause.js +1 -59
  236. package/dist/commands/profile/project.js +1 -113
  237. package/dist/commands/profile/rename.js +1 -38
  238. package/dist/commands/profile/show.js +1 -52
  239. package/dist/commands/profile.js +1 -35
  240. package/dist/commands/push.js +9 -265
  241. package/dist/commands/revive.js +10 -181
  242. package/dist/commands/surface/node/cycle.js +1 -83
  243. package/dist/commands/surface/node/focus.js +1 -81
  244. package/dist/commands/surface/node/id.js +1 -38
  245. package/dist/commands/surface/node/pin.js +1 -42
  246. package/dist/commands/surface/node/placement.js +1 -134
  247. package/dist/commands/surface-edit.js +1 -157
  248. package/dist/commands/surface-inbox.js +1 -98
  249. package/dist/commands/surface-inspect.js +1 -39
  250. package/dist/commands/surface-node.js +1 -19
  251. package/dist/commands/surface-reload.js +2 -134
  252. package/dist/commands/surface-tmux-spread.js +1 -214
  253. package/dist/commands/surface.js +1 -28
  254. package/dist/commands/sys/branch.js +1 -19
  255. package/dist/commands/sys/config.js +1 -353
  256. package/dist/commands/sys/context/admin/actions.js +2 -246
  257. package/dist/commands/sys/context/admin/detail-panel.js +1 -247
  258. package/dist/commands/sys/context/admin/docs-panel.js +1 -191
  259. package/dist/commands/sys/context/admin/list-view.js +1 -183
  260. package/dist/commands/sys/context/admin/model.js +1 -229
  261. package/dist/commands/sys/context/admin/rail-panel.js +1 -227
  262. package/dist/commands/sys/context/admin/read-view.js +2 -194
  263. package/dist/commands/sys/context/admin/shell.js +1 -910
  264. package/dist/commands/sys/context/admin.js +2 -126
  265. package/dist/commands/sys/context/doc.js +3 -197
  266. package/dist/commands/sys/context/prompt-review.js +11 -291
  267. package/dist/commands/sys/context/resolve.js +10 -489
  268. package/dist/commands/sys/context/sysprompt.js +5 -96
  269. package/dist/commands/sys/context.js +1 -20
  270. package/dist/commands/sys/daemon.js +1 -313
  271. package/dist/commands/sys/doctor.js +1 -617
  272. package/dist/commands/sys/feedback.js +7 -228
  273. package/dist/commands/sys/logs.js +3 -129
  274. package/dist/commands/sys/migrate.js +1 -94
  275. package/dist/commands/sys/panels/broker-limits-panel.js +2 -110
  276. package/dist/commands/sys/panels/dependencies-panel.js +1 -80
  277. package/dist/commands/sys/panels/keybindings-panel.js +1 -703
  278. package/dist/commands/sys/panels/models-panel.js +1 -1133
  279. package/dist/commands/sys/panels/plugins-panel.js +1 -80
  280. package/dist/commands/sys/panels/prefs-panel.js +1 -85
  281. package/dist/commands/sys/panels/profiles-panel.js +1 -601
  282. package/dist/commands/sys/panels/provider-panel.js +1 -538
  283. package/dist/commands/sys/settings-shell.js +1 -400
  284. package/dist/commands/sys/settings.js +1 -46
  285. package/dist/commands/sys/setup-core.js +6 -579
  286. package/dist/commands/sys/setup-settings-runner.js +1 -16
  287. package/dist/commands/sys/setup-wizard.js +1 -279
  288. package/dist/commands/sys/setup.js +1 -34
  289. package/dist/commands/sys/shared.js +1 -81
  290. package/dist/commands/sys/support/prepare.js +3 -239
  291. package/dist/commands/sys/support/submit.js +6 -524
  292. package/dist/commands/sys/support.js +1 -18
  293. package/dist/commands/sys/sync-deps.js +15 -498
  294. package/dist/commands/sys/sync-project-guidance.js +4 -481
  295. package/dist/commands/sys/sync-shared.js +1 -49
  296. package/dist/commands/sys/sync-skills.js +2 -311
  297. package/dist/commands/sys/sync.js +1 -18
  298. package/dist/commands/sys/update.js +1 -147
  299. package/dist/commands/sys/worktrees.js +5 -53
  300. package/dist/commands/sys.js +1 -18
  301. package/dist/core/activity-signal.js +2 -38
  302. package/dist/core/asset-root.js +1 -18
  303. package/dist/core/auth-file.js +2 -179
  304. package/dist/core/auth-interaction.js +3 -94
  305. package/dist/core/auto-update.js +4 -94
  306. package/dist/core/bash-guard.js +11 -393
  307. package/dist/core/bash-jobs.js +7 -411
  308. package/dist/core/bootstrap.js +2 -53
  309. package/dist/core/broker-client/client.js +1 -184
  310. package/dist/core/broker-client/index.js +1 -13
  311. package/dist/core/broker-client/transport-relay.js +1 -157
  312. package/dist/core/broker-client/transport-socket.js +1 -179
  313. package/dist/core/broker-client/transport.js +1 -26
  314. package/dist/core/canvas/attention.js +1 -47
  315. package/dist/core/canvas/boot-id.js +1 -26
  316. package/dist/core/canvas/boot.js +1 -186
  317. package/dist/core/canvas/browse/app.js +3 -919
  318. package/dist/core/canvas/browse/model.js +1 -477
  319. package/dist/core/canvas/browse/pins.js +1 -29
  320. package/dist/core/canvas/browse/render.js +3 -1055
  321. package/dist/core/canvas/canvas.js +15 -922
  322. package/dist/core/canvas/crons.js +11 -481
  323. package/dist/core/canvas/daemon-owner.js +2 -146
  324. package/dist/core/canvas/db.js +2 -100
  325. package/dist/core/canvas/deliveries.js +22 -283
  326. package/dist/core/canvas/delivery-contract.js +1 -8
  327. package/dist/core/canvas/executions.js +1 -68
  328. package/dist/core/canvas/extensions.js +1 -83
  329. package/dist/core/canvas/focuses.js +1 -77
  330. package/dist/core/canvas/history.js +24 -860
  331. package/dist/core/canvas/index.js +1 -15
  332. package/dist/core/canvas/install-id.js +1 -84
  333. package/dist/core/canvas/labels.js +1 -43
  334. package/dist/core/canvas/meta-file.js +1 -89
  335. package/dist/core/canvas/migrations.js +41 -1150
  336. package/dist/core/canvas/nav-model.js +1 -231
  337. package/dist/core/canvas/nav-render.js +1 -260
  338. package/dist/core/canvas/node-order.js +1 -37
  339. package/dist/core/canvas/node-recap.js +2 -67
  340. package/dist/core/canvas/node-sql-migration.js +2 -209
  341. package/dist/core/canvas/paths.js +1 -153
  342. package/dist/core/canvas/pid.js +4 -683
  343. package/dist/core/canvas/recovery.js +3 -565
  344. package/dist/core/canvas/remote-canvas-source.js +1 -288
  345. package/dist/core/canvas/remote-transport.js +1 -57
  346. package/dist/core/canvas/render-source.js +10 -635
  347. package/dist/core/canvas/sessions.js +1 -78
  348. package/dist/core/canvas/source.js +1 -47
  349. package/dist/core/canvas/status-glyph.js +1 -132
  350. package/dist/core/canvas/telemetry.js +1 -35
  351. package/dist/core/canvas/types.js +1 -6
  352. package/dist/core/canvas/waits.js +4 -68
  353. package/dist/core/canvas/worktrees.js +1 -93
  354. package/dist/core/clipboard-text.js +1 -57
  355. package/dist/core/command-hooks/artifact.js +1 -145
  356. package/dist/core/command-hooks/catalog.js +1 -38
  357. package/dist/core/command-hooks/compose.js +1 -99
  358. package/dist/core/command-hooks/discovery.js +1 -228
  359. package/dist/core/command-hooks/help.js +1 -18
  360. package/dist/core/command-hooks/index.js +1 -7
  361. package/dist/core/command-hooks/lifecycle-catalog.js +1 -9
  362. package/dist/core/command-hooks/lifecycle-create.js +1 -51
  363. package/dist/core/command-hooks/report.js +1 -28
  364. package/dist/core/command-hooks/schema.js +1 -157
  365. package/dist/core/command-hooks/transport/exec-invoke.js +1 -276
  366. package/dist/core/command-hooks/transport/exec-lifecycle.js +1 -211
  367. package/dist/core/command-manifests/manifest.js +1 -324
  368. package/dist/core/command-manifests/registry.js +1 -118
  369. package/dist/core/command-manifests/schema.js +1 -736
  370. package/dist/core/command-plugins/bundle.js +1 -261
  371. package/dist/core/command-plugins/compose.js +1 -65
  372. package/dist/core/command-plugins/discovery.js +1 -245
  373. package/dist/core/command-plugins/endpoint.js +1 -48
  374. package/dist/core/command-plugins/extensions.js +1 -166
  375. package/dist/core/command-plugins/help-addenda.js +1 -44
  376. package/dist/core/command-plugins/presence.js +1 -17
  377. package/dist/core/command-plugins/revalidate.js +2 -152
  378. package/dist/core/command-plugins/transport/exec-invoke.js +1 -215
  379. package/dist/core/command-plugins/transport/http-fetch.js +1 -68
  380. package/dist/core/command-plugins/transport/http-invoke.js +3 -546
  381. package/dist/core/command.js +10 -739
  382. package/dist/core/config.js +1 -1059
  383. package/dist/core/document-lines.js +3 -6
  384. package/dist/core/env-name.js +1 -9
  385. package/dist/core/errors.js +1 -52
  386. package/dist/core/events/emit.js +1 -17
  387. package/dist/core/events/envelope.js +1 -84
  388. package/dist/core/events/errors.js +1 -69
  389. package/dist/core/events/index.js +1 -4
  390. package/dist/core/events/operation-id.js +1 -24
  391. package/dist/core/events/read.js +1 -623
  392. package/dist/core/events/serialize.js +1 -199
  393. package/dist/core/events/source.js +1 -31
  394. package/dist/core/events/types.js +1 -11
  395. package/dist/core/exclusive-lock.js +1 -197
  396. package/dist/core/fault-classifier.js +1 -96
  397. package/dist/core/feed/feed.js +7 -202
  398. package/dist/core/feed/inbox-migrate.js +3 -135
  399. package/dist/core/feed/inbox.js +10 -122
  400. package/dist/core/feed/messages.js +6 -212
  401. package/dist/core/frontmatter.js +1 -35
  402. package/dist/core/fs-utils.js +3 -202
  403. package/dist/core/git.js +2 -103
  404. package/dist/core/help.js +9 -310
  405. package/dist/core/host-exports/builtins.js +9 -68
  406. package/dist/core/host-exports/export.js +3 -124
  407. package/dist/core/human/action-binding.js +1 -40
  408. package/dist/core/human/answer-text.js +5 -100
  409. package/dist/core/human/answer.js +1 -119
  410. package/dist/core/human/claim.js +3 -67
  411. package/dist/core/human/completion.js +1 -27
  412. package/dist/core/human/component-docs.js +78 -272
  413. package/dist/core/human/convention.js +2 -82
  414. package/dist/core/human/feedback-companion.js +1 -106
  415. package/dist/core/human/feedback.js +1 -88
  416. package/dist/core/human/page-authoring.js +1 -19
  417. package/dist/core/human/page-catalog.js +1 -172
  418. package/dist/core/human/page-errors.js +1 -7
  419. package/dist/core/human/page-eval.js +1 -125
  420. package/dist/core/human/page-html-markdown.js +8 -260
  421. package/dist/core/human/page-markdown.js +17 -295
  422. package/dist/core/human/page-schema.js +1 -373
  423. package/dist/core/human/page-synth.js +8 -27
  424. package/dist/core/human/page.js +1 -198
  425. package/dist/core/human/requests.js +15 -466
  426. package/dist/core/human/review-schema.js +1 -34
  427. package/dist/core/human/root.js +1 -11
  428. package/dist/core/human/scan.js +1 -69
  429. package/dist/core/human/summary.js +1 -5
  430. package/dist/core/human/tickets.js +1 -171
  431. package/dist/core/human/types.js +0 -1
  432. package/dist/core/human/visible-paths.js +1 -77
  433. package/dist/core/human-actions.js +1 -101
  434. package/dist/core/inspector/chrome.js +1 -14
  435. package/dist/core/inspector/contract.js +0 -1
  436. package/dist/core/inspector/core.js +2 -295
  437. package/dist/core/inspector/host.js +4 -538
  438. package/dist/core/inspector/model.js +2 -226
  439. package/dist/core/inspector/text.js +6 -45
  440. package/dist/core/inspector/transport.js +1 -36
  441. package/dist/core/inspector/tui.js +2 -295
  442. package/dist/core/installed-plugins.js +1 -78
  443. package/dist/core/io.js +7 -356
  444. package/dist/core/keybindings/attach-control.js +1 -42
  445. package/dist/core/keybindings/background-bash.js +1 -33
  446. package/dist/core/keybindings/catalog.js +1 -256
  447. package/dist/core/keybindings/inbox.js +1 -25
  448. package/dist/core/keybindings/index.js +1 -7
  449. package/dist/core/keybindings/match.js +1 -127
  450. package/dist/core/keybindings/persistence.js +1 -49
  451. package/dist/core/keybindings/resolve.js +1 -348
  452. package/dist/core/keybindings/types.js +0 -1
  453. package/dist/core/locked-file.js +1 -118
  454. package/dist/core/log.js +3 -27
  455. package/dist/core/manifest-recovery.js +1 -72
  456. package/dist/core/manifest-stale.js +1 -39
  457. package/dist/core/manifest.js +1 -20
  458. package/dist/core/memory/doc-link-grammar.js +2 -109
  459. package/dist/core/memory/extensions.js +1 -221
  460. package/dist/core/memory/history.js +6 -268
  461. package/dist/core/memory/identity.js +1 -181
  462. package/dist/core/memory/inline-ref-grammar.js +1 -98
  463. package/dist/core/memory/inline-ref-guidance.js +2 -35
  464. package/dist/core/memory/inline-ref-inventory.js +1 -59
  465. package/dist/core/memory/lint.js +2 -671
  466. package/dist/core/memory/project-namespace.js +2 -85
  467. package/dist/core/memory/repository-association.js +1 -129
  468. package/dist/core/memory/tree.js +1 -93
  469. package/dist/core/memory-resolver.js +2 -611
  470. package/dist/core/model-config.js +1 -107
  471. package/dist/core/model-routes.js +1 -201
  472. package/dist/core/nested-stores.js +2 -166
  473. package/dist/core/output.js +7 -99
  474. package/dist/core/pagination.js +1 -88
  475. package/dist/core/plugin-swap-lock.js +1 -31
  476. package/dist/core/pool-credential-store.js +1 -116
  477. package/dist/core/predicate.js +1 -191
  478. package/dist/core/preview-registry.js +2 -411
  479. package/dist/core/preview-result-path.js +1 -26
  480. package/dist/core/profiles/default-binding.js +1 -24
  481. package/dist/core/profiles/deletion-reservation.js +1 -42
  482. package/dist/core/profiles/env-store.js +2 -162
  483. package/dist/core/profiles/fuzzy-match.js +1 -92
  484. package/dist/core/profiles/manifest.js +1 -574
  485. package/dist/core/profiles/select.js +35 -741
  486. package/dist/core/profiles/state-block.js +3 -17
  487. package/dist/core/provider-error-recognition.js +1 -74
  488. package/dist/core/provider-failure.js +1 -86
  489. package/dist/core/provider-management.js +1 -22
  490. package/dist/core/remote-canvas-target.js +1 -30
  491. package/dist/core/render.js +18 -138
  492. package/dist/core/resolver.js +1 -111
  493. package/dist/core/review/birth.js +1 -52
  494. package/dist/core/review/comments.js +5 -279
  495. package/dist/core/review/companion.js +1 -215
  496. package/dist/core/review/document.js +2 -138
  497. package/dist/core/review/project.js +1 -36
  498. package/dist/core/review/realize.js +1 -71
  499. package/dist/core/review/remap.js +4 -141
  500. package/dist/core/review/signal.js +1 -12
  501. package/dist/core/review/stage.js +1 -184
  502. package/dist/core/review/store.js +1 -168
  503. package/dist/core/review/types.js +1 -23
  504. package/dist/core/runtime/advertised-command-invocation.js +1 -233
  505. package/dist/core/runtime/auth-reload.js +1 -67
  506. package/dist/core/runtime/banner.js +1 -51
  507. package/dist/core/runtime/bearings-render.js +18 -250
  508. package/dist/core/runtime/bearings.js +7 -194
  509. package/dist/core/runtime/bin-contributions.js +2 -186
  510. package/dist/core/runtime/boot-root.js +1 -107
  511. package/dist/core/runtime/branded-host.js +2 -264
  512. package/dist/core/runtime/broker/auth-reload.js +1 -157
  513. package/dist/core/runtime/broker/client-registry.js +1 -179
  514. package/dist/core/runtime/broker/daemon-ops.js +1 -88
  515. package/dist/core/runtime/broker/engine-drive.js +1 -354
  516. package/dist/core/runtime/broker/engine-routing.js +1 -211
  517. package/dist/core/runtime/broker/event-projection.js +1 -193
  518. package/dist/core/runtime/broker/extension-abort.js +1 -36
  519. package/dist/core/runtime/broker/fault-retry.js +1 -588
  520. package/dist/core/runtime/broker/frame-client.js +1 -132
  521. package/dist/core/runtime/broker/frame-dispatch.js +1 -183
  522. package/dist/core/runtime/broker/frame-engine-control.js +1 -231
  523. package/dist/core/runtime/broker/frame-memory-refs.js +1 -41
  524. package/dist/core/runtime/broker/frame-model-query.js +1 -69
  525. package/dist/core/runtime/broker/frame-read.js +1 -116
  526. package/dist/core/runtime/broker/frame-replies.js +1 -64
  527. package/dist/core/runtime/broker/frame-session.js +4 -203
  528. package/dist/core/runtime/broker/held-deferred-inbox.js +1 -13
  529. package/dist/core/runtime/broker/inbox.js +13 -163
  530. package/dist/core/runtime/broker/node-named.js +1 -27
  531. package/dist/core/runtime/broker/read-ops.js +1 -171
  532. package/dist/core/runtime/broker/rebind.js +1 -318
  533. package/dist/core/runtime/broker/tool-groups.js +1 -246
  534. package/dist/core/runtime/broker/turn-admission.js +1 -31
  535. package/dist/core/runtime/broker/turn-ignition.js +1 -84
  536. package/dist/core/runtime/broker-cli.js +3 -81
  537. package/dist/core/runtime/broker-extension-render.js +5 -135
  538. package/dist/core/runtime/broker-inventory.js +1 -116
  539. package/dist/core/runtime/broker-persona-guidance.js +4 -154
  540. package/dist/core/runtime/broker-protocol.js +3 -152
  541. package/dist/core/runtime/broker-request.js +1 -85
  542. package/dist/core/runtime/broker-sdk.js +1 -129
  543. package/dist/core/runtime/broker.js +1 -1214
  544. package/dist/core/runtime/canvas-extensions.js +1 -96
  545. package/dist/core/runtime/chat-inventory-rows.js +1 -105
  546. package/dist/core/runtime/close.js +1 -265
  547. package/dist/core/runtime/command-expansion.js +9 -104
  548. package/dist/core/runtime/command-surface.js +1 -117
  549. package/dist/core/runtime/connectivity.js +1 -73
  550. package/dist/core/runtime/deliver-live.js +1 -88
  551. package/dist/core/runtime/fault-recovery.js +1 -83
  552. package/dist/core/runtime/fault.js +1 -17
  553. package/dist/core/runtime/fleet.js +1 -58
  554. package/dist/core/runtime/front-door-env.js +1 -16
  555. package/dist/core/runtime/front-door.js +7 -183
  556. package/dist/core/runtime/headless-pi.js +1 -161
  557. package/dist/core/runtime/host.js +1 -457
  558. package/dist/core/runtime/interactive-deliver.js +1 -51
  559. package/dist/core/runtime/invocation.js +0 -10
  560. package/dist/core/runtime/kickoff.js +30 -327
  561. package/dist/core/runtime/launch-config-worker.js +1 -12
  562. package/dist/core/runtime/launch-prompt.js +4 -13
  563. package/dist/core/runtime/launch-target.js +1 -55
  564. package/dist/core/runtime/launch.js +1 -483
  565. package/dist/core/runtime/lifecycle.js +2 -213
  566. package/dist/core/runtime/managed-provider-cooling.js +1 -62
  567. package/dist/core/runtime/memory.js +1 -17
  568. package/dist/core/runtime/model-registry.js +1 -13
  569. package/dist/core/runtime/model-selection.js +1 -135
  570. package/dist/core/runtime/model-swap.js +1 -86
  571. package/dist/core/runtime/naming.js +14 -298
  572. package/dist/core/runtime/nerd-font.js +2 -127
  573. package/dist/core/runtime/node-read.js +2 -386
  574. package/dist/core/runtime/nodes.js +1 -331
  575. package/dist/core/runtime/outcome-document.js +1 -97
  576. package/dist/core/runtime/package-health.js +4 -99
  577. package/dist/core/runtime/persona.js +2 -55
  578. package/dist/core/runtime/pi-cli.js +1 -65
  579. package/dist/core/runtime/pi-vendored.js +1 -66
  580. package/dist/core/runtime/placement-tmux.js +1 -81
  581. package/dist/core/runtime/placement.js +1 -386
  582. package/dist/core/runtime/promote.js +1 -174
  583. package/dist/core/runtime/prospective-inventory-cli.js +3 -61
  584. package/dist/core/runtime/prospective-inventory.js +2 -88
  585. package/dist/core/runtime/recap.js +27 -103
  586. package/dist/core/runtime/recycle.js +1 -190
  587. package/dist/core/runtime/reopen.js +1 -138
  588. package/dist/core/runtime/reset.js +1 -245
  589. package/dist/core/runtime/resume-root.js +10 -290
  590. package/dist/core/runtime/revive-all.js +1 -107
  591. package/dist/core/runtime/revive.js +4 -544
  592. package/dist/core/runtime/roadmap.js +4 -38
  593. package/dist/core/runtime/session-branch.js +1 -46
  594. package/dist/core/runtime/session-cycles.js +1 -110
  595. package/dist/core/runtime/session-list-cache.js +1 -406
  596. package/dist/core/runtime/session-visibility.js +1 -99
  597. package/dist/core/runtime/shell-expansion.js +9 -100
  598. package/dist/core/runtime/situational-context.js +2 -67
  599. package/dist/core/runtime/situational-live.js +1 -41
  600. package/dist/core/runtime/spawn-env.js +1 -255
  601. package/dist/core/runtime/spawn.js +3 -577
  602. package/dist/core/runtime/stamp/channel.js +1 -76
  603. package/dist/core/runtime/stamp/protocol.js +1 -113
  604. package/dist/core/runtime/stop-guard.js +7 -116
  605. package/dist/core/runtime/stop-signals.js +1 -46
  606. package/dist/core/runtime/stream-watchdog.js +1 -134
  607. package/dist/core/runtime/structured-output.js +4 -156
  608. package/dist/core/runtime/surface-bg.js +1 -85
  609. package/dist/core/runtime/tmux-bindings.js +4 -730
  610. package/dist/core/runtime/tmux-chrome.js +1 -5
  611. package/dist/core/runtime/tmux-driver.js +7 -637
  612. package/dist/core/runtime/tool-group-summary.js +6 -85
  613. package/dist/core/runtime/turn-visibility.js +1 -31
  614. package/dist/core/runtime/view-socket.js +1 -83
  615. package/dist/core/runtime/warm-pool.d.ts +3 -2
  616. package/dist/core/runtime/warm-pool.js +1 -385
  617. package/dist/core/scope.js +1 -254
  618. package/dist/core/scoped-state/db.js +1 -135
  619. package/dist/core/scoped-state/migrate.js +3 -181
  620. package/dist/core/scoped-state/paths.js +1 -27
  621. package/dist/core/scoped-state/profiles.js +1 -62
  622. package/dist/core/scoped-state/providers.js +1 -8
  623. package/dist/core/scoped-state/schema.js +3 -16
  624. package/dist/core/scoped-state/settings.js +1 -82
  625. package/dist/core/secrets.js +2 -55
  626. package/dist/core/self-update.js +1 -71
  627. package/dist/core/session-model/session-state.js +1 -180
  628. package/dist/core/shell-segments.js +4 -169
  629. package/dist/core/spawn.js +1 -26
  630. package/dist/core/stdout-errors.js +1 -14
  631. package/dist/core/subscription-state.js +3 -193
  632. package/dist/core/substrate/frontmatter-validation.js +1 -105
  633. package/dist/core/substrate/gate-explain.js +1 -424
  634. package/dist/core/substrate/gate.js +1 -26
  635. package/dist/core/substrate/index.js +1 -30
  636. package/dist/core/substrate/injected-store.js +1 -249
  637. package/dist/core/substrate/listings.js +1 -115
  638. package/dist/core/substrate/on-read-node.js +1 -36
  639. package/dist/core/substrate/on-read.js +9 -315
  640. package/dist/core/substrate/plan.js +1 -266
  641. package/dist/core/substrate/render-node.js +1 -30
  642. package/dist/core/substrate/render.js +65 -689
  643. package/dist/core/substrate/schema.js +1 -186
  644. package/dist/core/substrate/session-cache.js +1 -83
  645. package/dist/core/substrate/subject-fields.js +1 -35
  646. package/dist/core/substrate/subject.js +1 -47
  647. package/dist/core/substrate/surface-match.js +1 -242
  648. package/dist/core/termrender/code-doc.js +5 -92
  649. package/dist/core/termrender/display.js +2 -56
  650. package/dist/core/termrender/termrender.js +14 -719
  651. package/dist/core/termrender/version.js +1 -1
  652. package/dist/core/timing.js +2 -94
  653. package/dist/core/tui/draw.js +2 -378
  654. package/dist/core/tui/fuzzy.js +1 -38
  655. package/dist/core/tui/markdown.js +3 -407
  656. package/dist/core/tui/page-host.js +1 -74
  657. package/dist/core/tui/panel.js +1 -137
  658. package/dist/core/tui/terminal.js +2 -100
  659. package/dist/core/user-settings.js +1 -454
  660. package/dist/core/wake.js +1 -296
  661. package/dist/core/worktree-close.js +6 -228
  662. package/dist/core/worktree-containment.js +3 -48
  663. package/dist/core/worktree-landing.js +4 -56
  664. package/dist/core/worktree-mutation-async.js +10 -280
  665. package/dist/core/worktree-quarantine.js +1 -54
  666. package/dist/core/worktree-sweep.js +6 -453
  667. package/dist/core/worktree.js +18 -899
  668. package/dist/daemon/api/bridge.js +8 -418
  669. package/dist/daemon/api/handlers/attach.js +1 -65
  670. package/dist/daemon/api/handlers/bash-jobs.js +2 -91
  671. package/dist/daemon/api/handlers/broker-ops.js +1 -447
  672. package/dist/daemon/api/handlers/broker-recovery.js +1 -251
  673. package/dist/daemon/api/handlers/canvas.js +6 -490
  674. package/dist/daemon/api/handlers/chat-inventory.js +1 -25
  675. package/dist/daemon/api/handlers/crons.js +1 -373
  676. package/dist/daemon/api/handlers/daemon.js +1 -76
  677. package/dist/daemon/api/handlers/feedback-comments.js +3 -199
  678. package/dist/daemon/api/handlers/files.js +1 -63
  679. package/dist/daemon/api/handlers/focus.js +1 -92
  680. package/dist/daemon/api/handlers/health.js +1 -76
  681. package/dist/daemon/api/handlers/human-requests.js +1 -379
  682. package/dist/daemon/api/handlers/human.js +1 -3
  683. package/dist/daemon/api/handlers/inbox-page.js +1 -89
  684. package/dist/daemon/api/handlers/inbox.js +1 -301
  685. package/dist/daemon/api/handlers/memory.js +1 -50
  686. package/dist/daemon/api/handlers/messages.js +2 -506
  687. package/dist/daemon/api/handlers/model-config.js +1 -44
  688. package/dist/daemon/api/handlers/modelauth.js +1 -165
  689. package/dist/daemon/api/handlers/node-outcomes.js +1 -181
  690. package/dist/daemon/api/handlers/nodes.js +1 -943
  691. package/dist/daemon/api/handlers/profiles.js +1 -140
  692. package/dist/daemon/api/handlers/prospective-chat-inventory.js +1 -59
  693. package/dist/daemon/api/handlers/reports.js +16 -332
  694. package/dist/daemon/api/handlers/review-comments.js +1 -465
  695. package/dist/daemon/api/handlers/reviews.js +1 -200
  696. package/dist/daemon/api/handlers/subscriptions.js +1 -53
  697. package/dist/daemon/api/handlers/validate.js +1 -58
  698. package/dist/daemon/api/handlers/worktree.js +1 -39
  699. package/dist/daemon/api/map.js +2 -735
  700. package/dist/daemon/api/router.js +1 -190
  701. package/dist/daemon/api/server.js +11 -408
  702. package/dist/daemon/boot-migrations.js +1 -31
  703. package/dist/daemon/companion-retire.js +1 -34
  704. package/dist/daemon/control.js +1 -22
  705. package/dist/daemon/cron/armed-context.js +1 -100
  706. package/dist/daemon/cron/capture.js +2 -45
  707. package/dist/daemon/cron/disposition.js +1 -55
  708. package/dist/daemon/cron/escalation.js +3 -124
  709. package/dist/daemon/cron/held.js +1 -20
  710. package/dist/daemon/cron/lease-recovery.js +1 -119
  711. package/dist/daemon/cron/live-runs.js +1 -23
  712. package/dist/daemon/cron/passes.js +1 -58
  713. package/dist/daemon/cron/settle.js +1 -61
  714. package/dist/daemon/cron/sinks.js +2 -59
  715. package/dist/daemon/cron-run.js +1 -405
  716. package/dist/daemon/crtrd-cli.js +1 -23
  717. package/dist/daemon/crtrd.js +8 -854
  718. package/dist/daemon/delivery/run-delivery.js +1 -164
  719. package/dist/daemon/fleet.js +17 -475
  720. package/dist/daemon/human/finish.js +10 -179
  721. package/dist/daemon/human/settle.js +1 -89
  722. package/dist/daemon/human/sweep.js +1 -66
  723. package/dist/daemon/manage.js +2 -595
  724. package/dist/daemon/messaging/node-message.js +1 -99
  725. package/dist/daemon/park-activity.js +1 -30
  726. package/dist/daemon/park-pending.js +1 -52
  727. package/dist/daemon/pidfile.js +1 -37
  728. package/dist/daemon/profile-delete.js +1 -306
  729. package/dist/daemon/reconcilers/bash-deadline.js +1 -80
  730. package/dist/daemon/reconcilers/broker-supervision.js +4 -761
  731. package/dist/daemon/reconcilers/controller-death.js +1 -14
  732. package/dist/daemon/reconcilers/cron-lane.js +1 -29
  733. package/dist/daemon/reconcilers/delivery-lane.js +1 -130
  734. package/dist/daemon/reconcilers/live-obligation.js +1 -87
  735. package/dist/daemon/reconcilers/managed-worktree-sweep.js +1 -202
  736. package/dist/daemon/reconcilers/node-deadline.js +1 -82
  737. package/dist/daemon/reconcilers/node-lifecycle/freeze-lane.js +1 -172
  738. package/dist/daemon/reconcilers/node-lifecycle/respawn-policy.js +1 -59
  739. package/dist/daemon/reconcilers/node-lifecycle/terminating.js +1 -12
  740. package/dist/daemon/reconcilers/node-lifecycle/tick.js +1 -146
  741. package/dist/daemon/reconcilers/node-lifecycle/wants-execution.js +1 -11
  742. package/dist/daemon/reconcilers/pending-review-submit.js +1 -36
  743. package/dist/daemon/reconcilers/storage-maintenance.js +1 -207
  744. package/dist/daemon/review/comment-notify.js +2 -109
  745. package/dist/daemon/review/companion.js +1 -29
  746. package/dist/daemon/review/deliver.js +3 -8
  747. package/dist/daemon/review/finish.js +1 -122
  748. package/dist/daemon/review/sweep.js +1 -18
  749. package/dist/daemon/startup-policy.js +1 -1
  750. package/dist/daemon/supervise-cadence.js +1 -6
  751. package/dist/hook-authoring.js +5 -447
  752. package/dist/hook-process.js +1 -34
  753. package/dist/index.js +1 -52
  754. package/dist/migrations/001-surfaces-frontmatter.js +1 -161
  755. package/dist/migrations/002-profile-project-memory.js +1 -72
  756. package/dist/migrations/003-repository-root-memory-identity/front-door.js +11 -231
  757. package/dist/migrations/003-repository-root-memory-identity/index.js +5 -513
  758. package/dist/migrations/003-repository-root-memory-identity/references.js +5 -469
  759. package/dist/migrations/003-repository-root-memory-identity/repository-facts.js +3 -349
  760. package/dist/migrations/activation.js +2 -89
  761. package/dist/migrations/convergent.js +2 -82
  762. package/dist/migrations/corpus.js +3 -483
  763. package/dist/migrations/frontmatter-splice.js +8 -176
  764. package/dist/migrations/profile-manifests.js +2 -70
  765. package/dist/migrations/registry.js +1 -42
  766. package/dist/migrations/runner.js +1 -85
  767. package/dist/migrations/types.js +0 -24
  768. package/dist/pi-extensions/broker-local.js +2 -106
  769. package/dist/pi-extensions/canvas-bash-valve.js +7 -461
  770. package/dist/pi-extensions/canvas-context-intro.js +2 -113
  771. package/dist/pi-extensions/canvas-doc-substrate.js +9 -178
  772. package/dist/pi-extensions/canvas-goal-capture.js +1 -83
  773. package/dist/pi-extensions/canvas-inbox-watcher.js +1 -1010
  774. package/dist/pi-extensions/canvas-passive-context.js +14 -203
  775. package/dist/pi-extensions/canvas-preview-result.js +2 -72
  776. package/dist/pi-extensions/canvas-prompt-scrub.js +2 -54
  777. package/dist/pi-extensions/canvas-recap.js +11 -405
  778. package/dist/pi-extensions/canvas-review-boundary.js +3 -63
  779. package/dist/pi-extensions/canvas-stamp.js +2 -77
  780. package/dist/pi-extensions/canvas-stophook.js +1 -643
  781. package/dist/pi-extensions/canvas-structured-output.js +13 -35
  782. package/dist/pi-extensions/canvas-tool-guide.js +9 -78
  783. package/dist/pi-extensions/envelope-merge.js +8 -29
  784. package/dist/prompts/review.js +20 -42
  785. package/dist/shared/birth-announcement.js +1 -25
  786. package/dist/shared/crtr-version.js +1 -18
  787. package/dist/shared/env.js +1 -214
  788. package/dist/shared/generated-context.js +11 -226
  789. package/dist/shared/predicates.js +1 -4
  790. package/dist/shared/shell-quote.js +1 -5
  791. package/dist/shared/tool-groups.js +1 -64
  792. package/dist/shared/working-activity.js +1 -27
  793. package/dist/suppress-experimental-warnings.js +1 -15
  794. package/dist/types.js +1 -185
  795. package/docs/public-api.md +10 -9
  796. package/package.json +6 -5
  797. package/runtime.lock.json +5 -5
  798. package/dist/api/__tests__/integration/client.test.d.ts +0 -1
  799. package/dist/api/__tests__/integration/client.test.js +0 -163
  800. package/dist/builtin-pi-packages/pi-crtr-extensions/__tests__/insights-active-init.test.ts +0 -98
  801. package/dist/builtin-pi-packages/pi-crtr-extensions/extensions/__tests__/crtr-commands.test.ts +0 -93
  802. package/dist/builtin-pi-packages/pi-crtr-extensions/extensions/__tests__/integration/provider-rotation.test.ts +0 -2530
  803. package/dist/clients/__tests__/helpers/human-daemon.d.ts +0 -11
  804. package/dist/clients/__tests__/helpers/human-daemon.js +0 -60
  805. package/dist/clients/attach/__tests__/attach-remote-readonly.test.d.ts +0 -1
  806. package/dist/clients/attach/__tests__/attach-remote-readonly.test.js +0 -97
  807. package/dist/clients/attach/__tests__/bash-call-width.test.d.ts +0 -1
  808. package/dist/clients/attach/__tests__/bash-call-width.test.js +0 -38
  809. package/dist/clients/attach/__tests__/chat-view-snapshot-ordering.test.d.ts +0 -1
  810. package/dist/clients/attach/__tests__/chat-view-snapshot-ordering.test.js +0 -175
  811. package/dist/clients/attach/__tests__/completion-frecency.test.d.ts +0 -1
  812. package/dist/clients/attach/__tests__/completion-frecency.test.js +0 -35
  813. package/dist/clients/attach/__tests__/context-message.test.d.ts +0 -1
  814. package/dist/clients/attach/__tests__/context-message.test.js +0 -130
  815. package/dist/clients/attach/__tests__/crtr-output.test.d.ts +0 -1
  816. package/dist/clients/attach/__tests__/crtr-output.test.js +0 -68
  817. package/dist/clients/attach/__tests__/diagram.test.d.ts +0 -1
  818. package/dist/clients/attach/__tests__/diagram.test.js +0 -42
  819. package/dist/clients/attach/__tests__/edit-diff.test.d.ts +0 -1
  820. package/dist/clients/attach/__tests__/edit-diff.test.js +0 -31
  821. package/dist/clients/attach/__tests__/frame-selection.test.d.ts +0 -1
  822. package/dist/clients/attach/__tests__/frame-selection.test.js +0 -84
  823. package/dist/clients/attach/__tests__/group-activity.test.d.ts +0 -1
  824. package/dist/clients/attach/__tests__/group-activity.test.js +0 -165
  825. package/dist/clients/attach/__tests__/oauth-dialog-lifecycle.test.d.ts +0 -1
  826. package/dist/clients/attach/__tests__/oauth-dialog-lifecycle.test.js +0 -83
  827. package/dist/clients/attach/__tests__/pane-tag-successor.test.d.ts +0 -1
  828. package/dist/clients/attach/__tests__/pane-tag-successor.test.js +0 -56
  829. package/dist/clients/attach/__tests__/profile-files.test.d.ts +0 -1
  830. package/dist/clients/attach/__tests__/profile-files.test.js +0 -21
  831. package/dist/clients/attach/__tests__/prompt-preview.test.d.ts +0 -1
  832. package/dist/clients/attach/__tests__/prompt-preview.test.js +0 -21
  833. package/dist/clients/attach/__tests__/ref-autocomplete.test.d.ts +0 -1
  834. package/dist/clients/attach/__tests__/ref-autocomplete.test.js +0 -64
  835. package/dist/clients/attach/__tests__/titled-editor-paste.test.d.ts +0 -1
  836. package/dist/clients/attach/__tests__/titled-editor-paste.test.js +0 -114
  837. package/dist/clients/attach/__tests__/titled-editor-preview.test.d.ts +0 -1
  838. package/dist/clients/attach/__tests__/titled-editor-preview.test.js +0 -83
  839. package/dist/clients/inbox/__tests__/integration/inbox-controller.test.d.ts +0 -1
  840. package/dist/clients/inbox/__tests__/integration/inbox-controller.test.js +0 -81
  841. package/dist/clients/inbox/__tests__/integration/mount-panel.test.d.ts +0 -1
  842. package/dist/clients/inbox/__tests__/integration/mount-panel.test.js +0 -135
  843. package/dist/clients/inbox/__tests__/integration/stale-row-activation.test.d.ts +0 -1
  844. package/dist/clients/inbox/__tests__/integration/stale-row-activation.test.js +0 -66
  845. package/dist/clients/inbox/review/__tests__/editor-roundtrip.test.d.ts +0 -1
  846. package/dist/clients/inbox/review/__tests__/editor-roundtrip.test.js +0 -35
  847. package/dist/clients/inbox/review/__tests__/review-core.test.d.ts +0 -1
  848. package/dist/clients/inbox/review/__tests__/review-core.test.js +0 -52
  849. package/dist/clients/inbox/review/__tests__/teardown-notice.test.d.ts +0 -1
  850. package/dist/clients/inbox/review/__tests__/teardown-notice.test.js +0 -100
  851. package/dist/commands/__tests__/api-client-cold-start-diagnostic.test.d.ts +0 -1
  852. package/dist/commands/__tests__/api-client-cold-start-diagnostic.test.js +0 -69
  853. package/dist/commands/__tests__/human.test.d.ts +0 -1
  854. package/dist/commands/__tests__/human.test.js +0 -172
  855. package/dist/commands/__tests__/integration/dashboard-snapshot.test.d.ts +0 -1
  856. package/dist/commands/__tests__/integration/dashboard-snapshot.test.js +0 -237
  857. package/dist/commands/__tests__/integration/migrate.test.d.ts +0 -1
  858. package/dist/commands/__tests__/integration/migrate.test.js +0 -1330
  859. package/dist/commands/__tests__/node-message.test.d.ts +0 -1
  860. package/dist/commands/__tests__/node-message.test.js +0 -112
  861. package/dist/commands/__tests__/node-new.test.d.ts +0 -1
  862. package/dist/commands/__tests__/node-new.test.js +0 -58
  863. package/dist/commands/__tests__/revive-now-gate.test.d.ts +0 -1
  864. package/dist/commands/__tests__/revive-now-gate.test.js +0 -62
  865. package/dist/commands/__tests__/seam/daemon-status.test.d.ts +0 -1
  866. package/dist/commands/__tests__/seam/daemon-status.test.js +0 -29
  867. package/dist/commands/__tests__/surface-reload-target.test.d.ts +0 -1
  868. package/dist/commands/__tests__/surface-reload-target.test.js +0 -21
  869. package/dist/commands/memory/__tests__/command-selector-and-mutation-guards.test.d.ts +0 -1
  870. package/dist/commands/memory/__tests__/command-selector-and-mutation-guards.test.js +0 -379
  871. package/dist/commands/memory/__tests__/memory-list-and-lint-ignore.test.d.ts +0 -1
  872. package/dist/commands/memory/__tests__/memory-list-and-lint-ignore.test.js +0 -124
  873. package/dist/commands/memory/__tests__/repository-root-lint.test.d.ts +0 -1
  874. package/dist/commands/memory/__tests__/repository-root-lint.test.js +0 -148
  875. package/dist/commands/sys/__tests__/config-model-ladders.test.d.ts +0 -1
  876. package/dist/commands/sys/__tests__/config-model-ladders.test.js +0 -114
  877. package/dist/commands/sys/__tests__/setup-core.test.d.ts +0 -1
  878. package/dist/commands/sys/__tests__/setup-core.test.js +0 -45
  879. package/dist/commands/sys/__tests__/sync-project-guidance.test.d.ts +0 -1
  880. package/dist/commands/sys/__tests__/sync-project-guidance.test.js +0 -244
  881. package/dist/core/__tests__/bash-guard.test.d.ts +0 -1
  882. package/dist/core/__tests__/bash-guard.test.js +0 -190
  883. package/dist/core/__tests__/boot-fault-attempt.test.d.ts +0 -1
  884. package/dist/core/__tests__/boot-fault-attempt.test.js +0 -105
  885. package/dist/core/__tests__/boot.test.d.ts +0 -1
  886. package/dist/core/__tests__/boot.test.js +0 -274
  887. package/dist/core/__tests__/branded-host-concurrency.test.d.ts +0 -1
  888. package/dist/core/__tests__/branded-host-concurrency.test.js +0 -72
  889. package/dist/core/__tests__/broker-extension-canvas-db-boundary.test.d.ts +0 -1
  890. package/dist/core/__tests__/broker-extension-canvas-db-boundary.test.js +0 -75
  891. package/dist/core/__tests__/broker-launch-candidates.test.d.ts +0 -1
  892. package/dist/core/__tests__/broker-launch-candidates.test.js +0 -311
  893. package/dist/core/__tests__/broker-preflight.test.d.ts +0 -1
  894. package/dist/core/__tests__/broker-preflight.test.js +0 -95
  895. package/dist/core/__tests__/broker-stream-watchdog-floor.test.d.ts +0 -1
  896. package/dist/core/__tests__/broker-stream-watchdog-floor.test.js +0 -82
  897. package/dist/core/__tests__/broker-turn-admission.test.d.ts +0 -1
  898. package/dist/core/__tests__/broker-turn-admission.test.js +0 -44
  899. package/dist/core/__tests__/canvas-db-boundary.test.d.ts +0 -1
  900. package/dist/core/__tests__/canvas-db-boundary.test.js +0 -46
  901. package/dist/core/__tests__/canvas-inbox-watcher-hold.test.d.ts +0 -1
  902. package/dist/core/__tests__/canvas-inbox-watcher-hold.test.js +0 -710
  903. package/dist/core/__tests__/canvas-inbox-watcher-naming.test.d.ts +0 -1
  904. package/dist/core/__tests__/canvas-inbox-watcher-naming.test.js +0 -310
  905. package/dist/core/__tests__/canvas-inbox-watcher.test.d.ts +0 -1
  906. package/dist/core/__tests__/canvas-inbox-watcher.test.js +0 -397
  907. package/dist/core/__tests__/canvas.test.d.ts +0 -1
  908. package/dist/core/__tests__/canvas.test.js +0 -138
  909. package/dist/core/__tests__/child-death-wake.test.d.ts +0 -1
  910. package/dist/core/__tests__/child-death-wake.test.js +0 -153
  911. package/dist/core/__tests__/cli-help-contract.test.d.ts +0 -1
  912. package/dist/core/__tests__/cli-help-contract.test.js +0 -152
  913. package/dist/core/__tests__/close.test.d.ts +0 -1
  914. package/dist/core/__tests__/close.test.js +0 -284
  915. package/dist/core/__tests__/collectible.test.d.ts +0 -1
  916. package/dist/core/__tests__/collectible.test.js +0 -89
  917. package/dist/core/__tests__/config-change-delta.test.d.ts +0 -1
  918. package/dist/core/__tests__/config-change-delta.test.js +0 -108
  919. package/dist/core/__tests__/context-intro.test.d.ts +0 -1
  920. package/dist/core/__tests__/context-intro.test.js +0 -123
  921. package/dist/core/__tests__/cron-armed-context-failure.test.d.ts +0 -1
  922. package/dist/core/__tests__/cron-armed-context-failure.test.js +0 -150
  923. package/dist/core/__tests__/cron-held-settlement.test.d.ts +0 -1
  924. package/dist/core/__tests__/cron-held-settlement.test.js +0 -240
  925. package/dist/core/__tests__/cron-node-sink-parked-root.test.d.ts +0 -1
  926. package/dist/core/__tests__/cron-node-sink-parked-root.test.js +0 -166
  927. package/dist/core/__tests__/cron-self-cancel-delivery.test.d.ts +0 -1
  928. package/dist/core/__tests__/cron-self-cancel-delivery.test.js +0 -84
  929. package/dist/core/__tests__/cron-timeout-descendants.test.d.ts +0 -1
  930. package/dist/core/__tests__/cron-timeout-descendants.test.js +0 -114
  931. package/dist/core/__tests__/daemon-boot.test.d.ts +0 -1
  932. package/dist/core/__tests__/daemon-boot.test.js +0 -422
  933. package/dist/core/__tests__/daemon-wedge.test.d.ts +0 -1
  934. package/dist/core/__tests__/daemon-wedge.test.js +0 -106
  935. package/dist/core/__tests__/dead-node-policy-table.test.d.ts +0 -1
  936. package/dist/core/__tests__/dead-node-policy-table.test.js +0 -77
  937. package/dist/core/__tests__/events-contract.test.d.ts +0 -1
  938. package/dist/core/__tests__/events-contract.test.js +0 -76
  939. package/dist/core/__tests__/extension-abort.test.d.ts +0 -1
  940. package/dist/core/__tests__/extension-abort.test.js +0 -21
  941. package/dist/core/__tests__/fault-classifier.test.d.ts +0 -1
  942. package/dist/core/__tests__/fault-classifier.test.js +0 -138
  943. package/dist/core/__tests__/fixtures/api-server-host.d.ts +0 -1
  944. package/dist/core/__tests__/fixtures/api-server-host.js +0 -47
  945. package/dist/core/__tests__/fixtures/c3-custom-provider-ext.d.ts +0 -2
  946. package/dist/core/__tests__/fixtures/c3-custom-provider-ext.js +0 -34
  947. package/dist/core/__tests__/fixtures/c5-command-boundary-ext.d.ts +0 -2
  948. package/dist/core/__tests__/fixtures/c5-command-boundary-ext.js +0 -32
  949. package/dist/core/__tests__/fixtures/fake-engine.d.ts +0 -347
  950. package/dist/core/__tests__/fixtures/fake-engine.js +0 -1509
  951. package/dist/core/__tests__/fixtures/fake-pi-host.d.ts +0 -2
  952. package/dist/core/__tests__/fixtures/fake-pi-host.js +0 -311
  953. package/dist/core/__tests__/fixtures/memory-slash-live-probe.d.ts +0 -1
  954. package/dist/core/__tests__/fixtures/memory-slash-live-probe.js +0 -75
  955. package/dist/core/__tests__/fixtures/metadata-migration-race.d.ts +0 -1
  956. package/dist/core/__tests__/fixtures/metadata-migration-race.js +0 -49
  957. package/dist/core/__tests__/focuses.test.d.ts +0 -1
  958. package/dist/core/__tests__/focuses.test.js +0 -113
  959. package/dist/core/__tests__/fs-utils.test.d.ts +0 -1
  960. package/dist/core/__tests__/fs-utils.test.js +0 -50
  961. package/dist/core/__tests__/helpers/broker-clients.d.ts +0 -43
  962. package/dist/core/__tests__/helpers/broker-clients.js +0 -174
  963. package/dist/core/__tests__/helpers/fleet.d.ts +0 -12
  964. package/dist/core/__tests__/helpers/fleet.js +0 -50
  965. package/dist/core/__tests__/helpers/harness.d.ts +0 -124
  966. package/dist/core/__tests__/helpers/harness.js +0 -806
  967. package/dist/core/__tests__/helpers/viewer-panes.d.ts +0 -12
  968. package/dist/core/__tests__/helpers/viewer-panes.js +0 -133
  969. package/dist/core/__tests__/history-inbox.test.d.ts +0 -1
  970. package/dist/core/__tests__/history-inbox.test.js +0 -121
  971. package/dist/core/__tests__/human-action-delivery.test.d.ts +0 -1
  972. package/dist/core/__tests__/human-action-delivery.test.js +0 -162
  973. package/dist/core/__tests__/human-actions.test.d.ts +0 -1
  974. package/dist/core/__tests__/human-actions.test.js +0 -120
  975. package/dist/core/__tests__/inline-memory-refs.test.d.ts +0 -1
  976. package/dist/core/__tests__/inline-memory-refs.test.js +0 -225
  977. package/dist/core/__tests__/integration/broker-fork-seam.test.d.ts +0 -1
  978. package/dist/core/__tests__/integration/broker-fork-seam.test.js +0 -193
  979. package/dist/core/__tests__/integration/broker-sdk-wiring.test.d.ts +0 -1
  980. package/dist/core/__tests__/integration/broker-sdk-wiring.test.js +0 -750
  981. package/dist/core/__tests__/integration/broker-snapshot-history.test.d.ts +0 -1
  982. package/dist/core/__tests__/integration/broker-snapshot-history.test.js +0 -288
  983. package/dist/core/__tests__/integration/broker-wedge-supervision.test.d.ts +0 -1
  984. package/dist/core/__tests__/integration/broker-wedge-supervision.test.js +0 -103
  985. package/dist/core/__tests__/integration/command-plugins.test.d.ts +0 -1
  986. package/dist/core/__tests__/integration/command-plugins.test.js +0 -1200
  987. package/dist/core/__tests__/integration/deferred-no-wake.test.d.ts +0 -1
  988. package/dist/core/__tests__/integration/deferred-no-wake.test.js +0 -610
  989. package/dist/core/__tests__/integration/flagship-lifecycle.test.d.ts +0 -1
  990. package/dist/core/__tests__/integration/flagship-lifecycle.test.js +0 -264
  991. package/dist/core/__tests__/integration/fresh-home-commands.test.d.ts +0 -1
  992. package/dist/core/__tests__/integration/fresh-home-commands.test.js +0 -49
  993. package/dist/core/__tests__/integration/git-optional-locks.test.d.ts +0 -1
  994. package/dist/core/__tests__/integration/git-optional-locks.test.js +0 -81
  995. package/dist/core/__tests__/integration/host-teardown-process-group.test.d.ts +0 -1
  996. package/dist/core/__tests__/integration/host-teardown-process-group.test.js +0 -480
  997. package/dist/core/__tests__/integration/lifecycle-hooks.test.d.ts +0 -1
  998. package/dist/core/__tests__/integration/lifecycle-hooks.test.js +0 -498
  999. package/dist/core/__tests__/integration/live-mutation-verbs.test.d.ts +0 -1
  1000. package/dist/core/__tests__/integration/live-mutation-verbs.test.js +0 -180
  1001. package/dist/core/__tests__/integration/live-mutation.test.d.ts +0 -1
  1002. package/dist/core/__tests__/integration/live-mutation.test.js +0 -173
  1003. package/dist/core/__tests__/integration/plugin-revalidate.test.d.ts +0 -1
  1004. package/dist/core/__tests__/integration/plugin-revalidate.test.js +0 -359
  1005. package/dist/core/__tests__/integration/profile-pause.test.d.ts +0 -1
  1006. package/dist/core/__tests__/integration/profile-pause.test.js +0 -115
  1007. package/dist/core/__tests__/integration/refresh-stall-recycle.test.d.ts +0 -1
  1008. package/dist/core/__tests__/integration/refresh-stall-recycle.test.js +0 -151
  1009. package/dist/core/__tests__/integration/revive.test.d.ts +0 -1
  1010. package/dist/core/__tests__/integration/revive.test.js +0 -615
  1011. package/dist/core/__tests__/integration/spawn-root.test.d.ts +0 -1
  1012. package/dist/core/__tests__/integration/spawn-root.test.js +0 -536
  1013. package/dist/core/__tests__/integration/subscription-delivery.test.d.ts +0 -1
  1014. package/dist/core/__tests__/integration/subscription-delivery.test.js +0 -132
  1015. package/dist/core/__tests__/integration/tmux-surface.test.d.ts +0 -1
  1016. package/dist/core/__tests__/integration/tmux-surface.test.js +0 -330
  1017. package/dist/core/__tests__/integration/worktree-land.test.d.ts +0 -1
  1018. package/dist/core/__tests__/integration/worktree-land.test.js +0 -607
  1019. package/dist/core/__tests__/integration/worktree-reap.test.d.ts +0 -1
  1020. package/dist/core/__tests__/integration/worktree-reap.test.js +0 -842
  1021. package/dist/core/__tests__/kickoff.test.d.ts +0 -1
  1022. package/dist/core/__tests__/kickoff.test.js +0 -196
  1023. package/dist/core/__tests__/lifecycle-terminal-reasons.test.d.ts +0 -1
  1024. package/dist/core/__tests__/lifecycle-terminal-reasons.test.js +0 -62
  1025. package/dist/core/__tests__/lifecycle.test.d.ts +0 -1
  1026. package/dist/core/__tests__/lifecycle.test.js +0 -176
  1027. package/dist/core/__tests__/live-lifecycle-prompt.test.d.ts +0 -1
  1028. package/dist/core/__tests__/live-lifecycle-prompt.test.js +0 -63
  1029. package/dist/core/__tests__/memory-resolver-precedence.test.d.ts +0 -1
  1030. package/dist/core/__tests__/memory-resolver-precedence.test.js +0 -228
  1031. package/dist/core/__tests__/migration.test.d.ts +0 -1
  1032. package/dist/core/__tests__/migration.test.js +0 -946
  1033. package/dist/core/__tests__/model-pin-durability.test.d.ts +0 -1
  1034. package/dist/core/__tests__/model-pin-durability.test.js +0 -195
  1035. package/dist/core/__tests__/model-routes-config.test.d.ts +0 -1
  1036. package/dist/core/__tests__/model-routes-config.test.js +0 -150
  1037. package/dist/core/__tests__/nested-store-discovery.test.d.ts +0 -1
  1038. package/dist/core/__tests__/nested-store-discovery.test.js +0 -89
  1039. package/dist/core/__tests__/node-outcome.test.d.ts +0 -1
  1040. package/dist/core/__tests__/node-outcome.test.js +0 -246
  1041. package/dist/core/__tests__/on-read-crouter-home-fence.test.d.ts +0 -1
  1042. package/dist/core/__tests__/on-read-crouter-home-fence.test.js +0 -66
  1043. package/dist/core/__tests__/on-read-dedup-resume.test.d.ts +0 -1
  1044. package/dist/core/__tests__/on-read-dedup-resume.test.js +0 -132
  1045. package/dist/core/__tests__/on-read-nested-store.test.d.ts +0 -1
  1046. package/dist/core/__tests__/on-read-nested-store.test.js +0 -135
  1047. package/dist/core/__tests__/parse-argv-stdin-secret.test.d.ts +0 -1
  1048. package/dist/core/__tests__/parse-argv-stdin-secret.test.js +0 -68
  1049. package/dist/core/__tests__/passive-subscription.test.d.ts +0 -1
  1050. package/dist/core/__tests__/passive-subscription.test.js +0 -120
  1051. package/dist/core/__tests__/pid-identity-match.test.d.ts +0 -1
  1052. package/dist/core/__tests__/pid-identity-match.test.js +0 -145
  1053. package/dist/core/__tests__/pid-zombie.test.d.ts +0 -1
  1054. package/dist/core/__tests__/pid-zombie.test.js +0 -42
  1055. package/dist/core/__tests__/plugin-kinds.test.d.ts +0 -1
  1056. package/dist/core/__tests__/plugin-kinds.test.js +0 -182
  1057. package/dist/core/__tests__/plugin-link-symlinked-scope-root.test.d.ts +0 -1
  1058. package/dist/core/__tests__/plugin-link-symlinked-scope-root.test.js +0 -43
  1059. package/dist/core/__tests__/plugin-page-components.test.d.ts +0 -1
  1060. package/dist/core/__tests__/plugin-page-components.test.js +0 -159
  1061. package/dist/core/__tests__/preview-mirror-cap.test.d.ts +0 -1
  1062. package/dist/core/__tests__/preview-mirror-cap.test.js +0 -53
  1063. package/dist/core/__tests__/preview-registry-sync.test.d.ts +0 -1
  1064. package/dist/core/__tests__/preview-registry-sync.test.js +0 -107
  1065. package/dist/core/__tests__/profile-project-memory-delivery.test.d.ts +0 -1
  1066. package/dist/core/__tests__/profile-project-memory-delivery.test.js +0 -644
  1067. package/dist/core/__tests__/prospective-inventory-capability-parity.test.d.ts +0 -1
  1068. package/dist/core/__tests__/prospective-inventory-capability-parity.test.js +0 -91
  1069. package/dist/core/__tests__/prune.test.d.ts +0 -1
  1070. package/dist/core/__tests__/prune.test.js +0 -243
  1071. package/dist/core/__tests__/push-final-guard.test.d.ts +0 -1
  1072. package/dist/core/__tests__/push-final-guard.test.js +0 -191
  1073. package/dist/core/__tests__/relaunch-root.test.d.ts +0 -1
  1074. package/dist/core/__tests__/relaunch-root.test.js +0 -249
  1075. package/dist/core/__tests__/remote-canvas-target.test.d.ts +0 -1
  1076. package/dist/core/__tests__/remote-canvas-target.test.js +0 -93
  1077. package/dist/core/__tests__/repository-association.test.d.ts +0 -1
  1078. package/dist/core/__tests__/repository-association.test.js +0 -153
  1079. package/dist/core/__tests__/repository-root-identity.test.d.ts +0 -1
  1080. package/dist/core/__tests__/repository-root-identity.test.js +0 -223
  1081. package/dist/core/__tests__/respawn-throttle.test.d.ts +0 -1
  1082. package/dist/core/__tests__/respawn-throttle.test.js +0 -20
  1083. package/dist/core/__tests__/review-model-floor.test.d.ts +0 -1
  1084. package/dist/core/__tests__/review-model-floor.test.js +0 -83
  1085. package/dist/core/__tests__/revive-all.test.d.ts +0 -1
  1086. package/dist/core/__tests__/revive-all.test.js +0 -157
  1087. package/dist/core/__tests__/revive-capacity.test.d.ts +0 -1
  1088. package/dist/core/__tests__/revive-capacity.test.js +0 -184
  1089. package/dist/core/__tests__/revive-parked-fresh.test.d.ts +0 -1
  1090. package/dist/core/__tests__/revive-parked-fresh.test.js +0 -176
  1091. package/dist/core/__tests__/scope-crouter-home-fence.test.d.ts +0 -1
  1092. package/dist/core/__tests__/scope-crouter-home-fence.test.js +0 -55
  1093. package/dist/core/__tests__/seam/broker-attach-multiclient.test.d.ts +0 -1
  1094. package/dist/core/__tests__/seam/broker-attach-multiclient.test.js +0 -262
  1095. package/dist/core/__tests__/seam/broker-attach-stream.test.d.ts +0 -1
  1096. package/dist/core/__tests__/seam/broker-attach-stream.test.js +0 -176
  1097. package/dist/core/__tests__/seam/broker-cap-freeze.test.d.ts +0 -1
  1098. package/dist/core/__tests__/seam/broker-cap-freeze.test.js +0 -155
  1099. package/dist/core/__tests__/seam/broker-crash-teardown.test.d.ts +0 -1
  1100. package/dist/core/__tests__/seam/broker-crash-teardown.test.js +0 -131
  1101. package/dist/core/__tests__/seam/broker-pane-resolution.test.d.ts +0 -1
  1102. package/dist/core/__tests__/seam/broker-pane-resolution.test.js +0 -204
  1103. package/dist/core/__tests__/seam/broker-provider-retry.test.d.ts +0 -1
  1104. package/dist/core/__tests__/seam/broker-provider-retry.test.js +0 -686
  1105. package/dist/core/__tests__/seam/broker-startup-diagnostics.test.d.ts +0 -1
  1106. package/dist/core/__tests__/seam/broker-startup-diagnostics.test.js +0 -82
  1107. package/dist/core/__tests__/seam/broker-whip-interrupt.test.d.ts +0 -1
  1108. package/dist/core/__tests__/seam/broker-whip-interrupt.test.js +0 -50
  1109. package/dist/core/__tests__/seam/deadline-wake-delivery.test.d.ts +0 -1
  1110. package/dist/core/__tests__/seam/deadline-wake-delivery.test.js +0 -138
  1111. package/dist/core/__tests__/seam/dormancy-release.test.d.ts +0 -1
  1112. package/dist/core/__tests__/seam/dormancy-release.test.js +0 -516
  1113. package/dist/core/__tests__/seam/held-deferred-human-prompt.test.d.ts +0 -1
  1114. package/dist/core/__tests__/seam/held-deferred-human-prompt.test.js +0 -65
  1115. package/dist/core/__tests__/seam/inbox-reference-guidance.test.d.ts +0 -1
  1116. package/dist/core/__tests__/seam/inbox-reference-guidance.test.js +0 -84
  1117. package/dist/core/__tests__/seam/memory-slash-node-relative-inventory.test.d.ts +0 -1
  1118. package/dist/core/__tests__/seam/memory-slash-node-relative-inventory.test.js +0 -160
  1119. package/dist/core/__tests__/seam/node-outcome-delivery.test.d.ts +0 -1
  1120. package/dist/core/__tests__/seam/node-outcome-delivery.test.js +0 -177
  1121. package/dist/core/__tests__/seam/prospective-inventory-stdout.test.d.ts +0 -1
  1122. package/dist/core/__tests__/seam/prospective-inventory-stdout.test.js +0 -31
  1123. package/dist/core/__tests__/seam/reopen-invalidated-worktree.test.d.ts +0 -1
  1124. package/dist/core/__tests__/seam/reopen-invalidated-worktree.test.js +0 -60
  1125. package/dist/core/__tests__/seam/self-close-teardown.test.d.ts +0 -1
  1126. package/dist/core/__tests__/seam/self-close-teardown.test.js +0 -49
  1127. package/dist/core/__tests__/seam/yield-refresh-transaction.test.d.ts +0 -1
  1128. package/dist/core/__tests__/seam/yield-refresh-transaction.test.js +0 -100
  1129. package/dist/core/__tests__/secrets.test.d.ts +0 -1
  1130. package/dist/core/__tests__/secrets.test.js +0 -49
  1131. package/dist/core/__tests__/self-update.test.d.ts +0 -1
  1132. package/dist/core/__tests__/self-update.test.js +0 -46
  1133. package/dist/core/__tests__/session-branch.test.d.ts +0 -1
  1134. package/dist/core/__tests__/session-branch.test.js +0 -61
  1135. package/dist/core/__tests__/session-cycles.test.d.ts +0 -1
  1136. package/dist/core/__tests__/session-cycles.test.js +0 -133
  1137. package/dist/core/__tests__/session-model.test.d.ts +0 -1
  1138. package/dist/core/__tests__/session-model.test.js +0 -111
  1139. package/dist/core/__tests__/spawn-worktree-id-conflict.test.d.ts +0 -1
  1140. package/dist/core/__tests__/spawn-worktree-id-conflict.test.js +0 -71
  1141. package/dist/core/__tests__/stdin-body-no-discard.test.d.ts +0 -1
  1142. package/dist/core/__tests__/stdin-body-no-discard.test.js +0 -33
  1143. package/dist/core/__tests__/stdout-errors.test.d.ts +0 -1
  1144. package/dist/core/__tests__/stdout-errors.test.js +0 -16
  1145. package/dist/core/__tests__/stop-guard.test.d.ts +0 -1
  1146. package/dist/core/__tests__/stop-guard.test.js +0 -237
  1147. package/dist/core/__tests__/stream-watchdog.test.d.ts +0 -1
  1148. package/dist/core/__tests__/stream-watchdog.test.js +0 -154
  1149. package/dist/core/__tests__/subscription-pool-credential-guard.test.d.ts +0 -1
  1150. package/dist/core/__tests__/subscription-pool-credential-guard.test.js +0 -95
  1151. package/dist/core/__tests__/tmux-driver-boundary.test.d.ts +0 -1
  1152. package/dist/core/__tests__/tmux-driver-boundary.test.js +0 -50
  1153. package/dist/core/__tests__/warm-claim-preference-snapshot.test.d.ts +0 -1
  1154. package/dist/core/__tests__/warm-claim-preference-snapshot.test.js +0 -54
  1155. package/dist/core/__tests__/worktree-landing.test.d.ts +0 -1
  1156. package/dist/core/__tests__/worktree-landing.test.js +0 -11
  1157. package/dist/core/__tests__/yield-ensures-daemon.test.d.ts +0 -1
  1158. package/dist/core/__tests__/yield-ensures-daemon.test.js +0 -55
  1159. package/dist/core/broker-client/__tests__/transport-relay.test.d.ts +0 -1
  1160. package/dist/core/broker-client/__tests__/transport-relay.test.js +0 -214
  1161. package/dist/core/broker-client/__tests__/transport-socket.test.d.ts +0 -1
  1162. package/dist/core/broker-client/__tests__/transport-socket.test.js +0 -73
  1163. package/dist/core/canvas/__tests__/attention.test.d.ts +0 -1
  1164. package/dist/core/canvas/__tests__/attention.test.js +0 -83
  1165. package/dist/core/canvas/__tests__/history-transcript.test.d.ts +0 -1
  1166. package/dist/core/canvas/__tests__/history-transcript.test.js +0 -102
  1167. package/dist/core/canvas/__tests__/remote-canvas-source.test.d.ts +0 -1
  1168. package/dist/core/canvas/__tests__/remote-canvas-source.test.js +0 -328
  1169. package/dist/core/canvas/__tests__/remote-transport.test.d.ts +0 -1
  1170. package/dist/core/canvas/__tests__/remote-transport.test.js +0 -97
  1171. package/dist/core/canvas/__tests__/render-remote.test.d.ts +0 -1
  1172. package/dist/core/canvas/__tests__/render-remote.test.js +0 -243
  1173. package/dist/core/canvas/__tests__/session-window.test.d.ts +0 -1
  1174. package/dist/core/canvas/__tests__/session-window.test.js +0 -70
  1175. package/dist/core/feed/__tests__/inbox-migrate.test.d.ts +0 -1
  1176. package/dist/core/feed/__tests__/inbox-migrate.test.js +0 -49
  1177. package/dist/core/human/__tests__/page-catalog.test.d.ts +0 -1
  1178. package/dist/core/human/__tests__/page-catalog.test.js +0 -20
  1179. package/dist/core/human/__tests__/page-html-markdown.test.d.ts +0 -1
  1180. package/dist/core/human/__tests__/page-html-markdown.test.js +0 -48
  1181. package/dist/core/human/__tests__/page.test.d.ts +0 -1
  1182. package/dist/core/human/__tests__/page.test.js +0 -92
  1183. package/dist/core/keybindings/__tests__/resolve.test.d.ts +0 -1
  1184. package/dist/core/keybindings/__tests__/resolve.test.js +0 -171
  1185. package/dist/core/profiles/__tests__/env-store.test.d.ts +0 -1
  1186. package/dist/core/profiles/__tests__/env-store.test.js +0 -99
  1187. package/dist/core/profiles/__tests__/fuzzy-match.test.d.ts +0 -1
  1188. package/dist/core/profiles/__tests__/fuzzy-match.test.js +0 -51
  1189. package/dist/core/profiles/__tests__/root-profile.test.d.ts +0 -1
  1190. package/dist/core/profiles/__tests__/root-profile.test.js +0 -59
  1191. package/dist/core/review/__tests__/capture-origin.test.d.ts +0 -1
  1192. package/dist/core/review/__tests__/capture-origin.test.js +0 -150
  1193. package/dist/core/review/__tests__/comments.test.d.ts +0 -1
  1194. package/dist/core/review/__tests__/comments.test.js +0 -116
  1195. package/dist/core/review/__tests__/remap.test.d.ts +0 -1
  1196. package/dist/core/review/__tests__/remap.test.js +0 -177
  1197. package/dist/core/review/__tests__/stage-identity.test.d.ts +0 -1
  1198. package/dist/core/review/__tests__/stage-identity.test.js +0 -150
  1199. package/dist/core/runtime/__tests__/engine-route.test.d.ts +0 -1
  1200. package/dist/core/runtime/__tests__/engine-route.test.js +0 -36
  1201. package/dist/core/runtime/__tests__/install-id-cache-scoping.test.d.ts +0 -1
  1202. package/dist/core/runtime/__tests__/install-id-cache-scoping.test.js +0 -45
  1203. package/dist/core/runtime/__tests__/node-env.test.d.ts +0 -1
  1204. package/dist/core/runtime/__tests__/node-env.test.js +0 -73
  1205. package/dist/core/runtime/__tests__/spawn-env.test.d.ts +0 -1
  1206. package/dist/core/runtime/__tests__/spawn-env.test.js +0 -259
  1207. package/dist/core/substrate/__tests__/surface-match-command.test.d.ts +0 -1
  1208. package/dist/core/substrate/__tests__/surface-match-command.test.js +0 -89
  1209. package/dist/core/substrate/__tests__/surface-match-memory-read.test.d.ts +0 -1
  1210. package/dist/core/substrate/__tests__/surface-match-memory-read.test.js +0 -28
  1211. package/dist/core/substrate/__tests__/surface-match-pre-command.test.d.ts +0 -1
  1212. package/dist/core/substrate/__tests__/surface-match-pre-command.test.js +0 -92
  1213. package/dist/daemon/__tests__/autostart-storm.test.d.ts +0 -1
  1214. package/dist/daemon/__tests__/autostart-storm.test.js +0 -128
  1215. package/dist/daemon/__tests__/broker-ownership.test.d.ts +0 -1
  1216. package/dist/daemon/__tests__/broker-ownership.test.js +0 -25
  1217. package/dist/daemon/__tests__/daemon-ownership.test.d.ts +0 -1
  1218. package/dist/daemon/__tests__/daemon-ownership.test.js +0 -27
  1219. package/dist/daemon/__tests__/helpers/source-daemon.d.ts +0 -30
  1220. package/dist/daemon/__tests__/helpers/source-daemon.js +0 -176
  1221. package/dist/daemon/__tests__/integration/api-startup-readiness.test.d.ts +0 -1
  1222. package/dist/daemon/__tests__/integration/api-startup-readiness.test.js +0 -83
  1223. package/dist/daemon/__tests__/integration/migration-startup.test.d.ts +0 -1
  1224. package/dist/daemon/__tests__/integration/migration-startup.test.js +0 -127
  1225. package/dist/daemon/__tests__/node-deadline-lane.test.d.ts +0 -1
  1226. package/dist/daemon/__tests__/node-deadline-lane.test.js +0 -77
  1227. package/dist/daemon/__tests__/node-outcome-birth-invariants.test.d.ts +0 -1
  1228. package/dist/daemon/__tests__/node-outcome-birth-invariants.test.js +0 -146
  1229. package/dist/daemon/__tests__/node-outcome-delivery.test.d.ts +0 -1
  1230. package/dist/daemon/__tests__/node-outcome-delivery.test.js +0 -116
  1231. package/dist/daemon/__tests__/reconciler-signature.test.d.ts +0 -1
  1232. package/dist/daemon/__tests__/reconciler-signature.test.js +0 -37
  1233. package/dist/daemon/__tests__/subtree-filter-freshness.test.d.ts +0 -1
  1234. package/dist/daemon/__tests__/subtree-filter-freshness.test.js +0 -63
  1235. package/dist/daemon/__tests__/thaw-order.test.d.ts +0 -1
  1236. package/dist/daemon/__tests__/thaw-order.test.js +0 -55
  1237. package/dist/daemon/api/__tests__/bridge-heartbeat.test.d.ts +0 -1
  1238. package/dist/daemon/api/__tests__/bridge-heartbeat.test.js +0 -58
  1239. package/dist/daemon/api/__tests__/broker-settle-park.test.d.ts +0 -1
  1240. package/dist/daemon/api/__tests__/broker-settle-park.test.js +0 -175
  1241. package/dist/daemon/api/__tests__/canvas-snapshot-fields.test.d.ts +0 -1
  1242. package/dist/daemon/api/__tests__/canvas-snapshot-fields.test.js +0 -216
  1243. package/dist/daemon/api/__tests__/error-seam.test.d.ts +0 -1
  1244. package/dist/daemon/api/__tests__/error-seam.test.js +0 -83
  1245. package/dist/daemon/api/__tests__/model-config.test.d.ts +0 -1
  1246. package/dist/daemon/api/__tests__/model-config.test.js +0 -73
  1247. package/dist/daemon/api/__tests__/node-create-description.test.d.ts +0 -1
  1248. package/dist/daemon/api/__tests__/node-create-description.test.js +0 -107
  1249. package/dist/daemon/api/__tests__/node-model-validation.test.d.ts +0 -1
  1250. package/dist/daemon/api/__tests__/node-model-validation.test.js +0 -183
  1251. package/dist/daemon/api/__tests__/nodes-activity-query.test.d.ts +0 -1
  1252. package/dist/daemon/api/__tests__/nodes-activity-query.test.js +0 -99
  1253. package/dist/daemon/api/__tests__/profile-launch-gates.test.d.ts +0 -1
  1254. package/dist/daemon/api/__tests__/profile-launch-gates.test.js +0 -172
  1255. package/dist/daemon/api/__tests__/profile-metadata-route.test.d.ts +0 -1
  1256. package/dist/daemon/api/__tests__/profile-metadata-route.test.js +0 -95
  1257. package/dist/daemon/api/__tests__/reopen-delivery.test.d.ts +0 -1
  1258. package/dist/daemon/api/__tests__/reopen-delivery.test.js +0 -260
  1259. package/dist/daemon/api/__tests__/seam/api-server.test.d.ts +0 -1
  1260. package/dist/daemon/api/__tests__/seam/api-server.test.js +0 -442
  1261. package/dist/daemon/api/__tests__/seam/b10-attach-modelauth.test.d.ts +0 -1
  1262. package/dist/daemon/api/__tests__/seam/b10-attach-modelauth.test.js +0 -310
  1263. package/dist/daemon/api/__tests__/seam/leaf-api-parity.test.d.ts +0 -1
  1264. package/dist/daemon/api/__tests__/seam/leaf-api-parity.test.js +0 -351
  1265. package/dist/daemon/api/__tests__/seam/node-outcome-api.test.d.ts +0 -1
  1266. package/dist/daemon/api/__tests__/seam/node-outcome-api.test.js +0 -159
  1267. package/dist/daemon/api/__tests__/seam/profile-delete.test.d.ts +0 -1
  1268. package/dist/daemon/api/__tests__/seam/profile-delete.test.js +0 -372
  1269. package/dist/daemon/api/__tests__/submit-result.test.d.ts +0 -1
  1270. package/dist/daemon/api/__tests__/submit-result.test.js +0 -215
  1271. package/dist/migrations/__tests__/activation-concurrency.test.d.ts +0 -1
  1272. package/dist/migrations/__tests__/activation-concurrency.test.js +0 -146
  1273. package/dist/migrations/__tests__/activation.test.d.ts +0 -1
  1274. package/dist/migrations/__tests__/activation.test.js +0 -152
  1275. package/dist/migrations/__tests__/deletion-and-root-declaration.test.d.ts +0 -1
  1276. package/dist/migrations/__tests__/deletion-and-root-declaration.test.js +0 -149
  1277. package/dist/pi-extensions/__tests__/canvas-bash-valve.test.d.ts +0 -1
  1278. package/dist/pi-extensions/__tests__/canvas-bash-valve.test.js +0 -86
  1279. package/dist/pi-extensions/__tests__/canvas-context-intro.test.d.ts +0 -1
  1280. package/dist/pi-extensions/__tests__/canvas-context-intro.test.js +0 -364
  1281. package/dist/pi-extensions/__tests__/canvas-goal-capture-envelope.test.d.ts +0 -1
  1282. package/dist/pi-extensions/__tests__/canvas-goal-capture-envelope.test.js +0 -106
  1283. package/dist/pi-extensions/__tests__/canvas-recap.test.d.ts +0 -1
  1284. package/dist/pi-extensions/__tests__/canvas-recap.test.js +0 -62
  1285. package/dist/pi-extensions/__tests__/canvas-stophook-agentend.test.d.ts +0 -1
  1286. package/dist/pi-extensions/__tests__/canvas-stophook-agentend.test.js +0 -432
  1287. package/dist/pi-extensions/__tests__/canvas-stophook-context-nudge.test.d.ts +0 -1
  1288. package/dist/pi-extensions/__tests__/canvas-stophook-context-nudge.test.js +0 -152
  1289. package/dist/pi-extensions/__tests__/canvas-structured-output.test.d.ts +0 -1
  1290. package/dist/pi-extensions/__tests__/canvas-structured-output.test.js +0 -88
  1291. package/dist/pi-extensions/__tests__/canvas-tool-guide.test.d.ts +0 -1
  1292. package/dist/pi-extensions/__tests__/canvas-tool-guide.test.js +0 -96
  1293. package/dist/pi-extensions/__tests__/integration/canvas-bash-valve.test.d.ts +0 -1
  1294. package/dist/pi-extensions/__tests__/integration/canvas-bash-valve.test.js +0 -133
  1295. package/dist/pi-extensions/__tests__/pre-command-gate.test.d.ts +0 -1
  1296. package/dist/pi-extensions/__tests__/pre-command-gate.test.js +0 -232
  1297. package/dist/shared/__tests__/env-boundary.test.d.ts +0 -1
  1298. package/dist/shared/__tests__/env-boundary.test.js +0 -95
  1299. package/dist/shared/__tests__/generated-context-grammar.test.d.ts +0 -1
  1300. package/dist/shared/__tests__/generated-context-grammar.test.js +0 -80
  1301. package/docs/compat/hearth-crtr-v1.md +0 -179
  1302. package/docs/compat/hearth-crtr-v2.md +0 -177
  1303. package/docs/compat/hearth-crtr-v3.md +0 -176
  1304. package/docs/compat/hearth-crtr-v4.md +0 -182
  1305. package/docs/compat/hearth-crtr-v5.md +0 -169
@@ -1,842 +0,0 @@
1
- // Managed worktrees: the reap half — auto-drop of clean checkouts, absent or
2
- // relocated checkouts, and the atomic branch delete's re-verified predicates
3
- // against commits landing mid-cleanup. Split from its land half
4
- // (worktree-land.test.ts) only so the two run as two parallel files.
5
- import { test, before, after, beforeEach } from 'node:test';
6
- import assert from 'node:assert/strict';
7
- import { mkdtempSync, mkdirSync, renameSync, rmSync, existsSync, writeFileSync, chmodSync, realpathSync } from 'node:fs';
8
- import { spawn } from 'node:child_process';
9
- import { homedir, tmpdir } from 'node:os';
10
- import { join } from 'node:path';
11
- import { gitSync } from '../../git.js';
12
- import { withExclusiveDirectoryLockAsync } from '../../exclusive-lock.js';
13
- import { createManagedWorktree, closeManagedWorktree, worktreeLockPathForCommonDir } from '../../worktree.js';
14
- import { abandonManagedWorktreeAsync } from '../../worktree-mutation-async.js';
15
- import { reconcileManagedWorktree } from '../../worktree-sweep.js';
16
- import { createApiServer } from '../../../daemon/api/server.js';
17
- import { ManagedWorktreeSweepReconciler } from '../../../daemon/reconcilers/managed-worktree-sweep.js';
18
- import { apiSocketPath } from '../../canvas/paths.js';
19
- import { ApiError, CrtrClient } from '../../../api/index.js';
20
- import { createNode, getNode } from '../../canvas/canvas.js';
21
- import { headlessBrokerHost } from '../../runtime/host.js';
22
- import { reviveNode } from '../../runtime/revive.js';
23
- import { bindTestFleet } from '../helpers/fleet.js';
24
- import { resetFleetForTests } from '../../runtime/fleet.js';
25
- import { closeDb, migrate, openDb } from '../../canvas/db.js';
26
- import { closeScopedStores } from '../../scoped-state/db.js';
27
- import { initializeFreshScopedStore } from '../../scoped-state/migrate.js';
28
- import { userScopeRoot } from '../../scope.js';
29
- let home;
30
- let remoteDir;
31
- let sourceDir;
32
- let previousHome;
33
- const scratchRoot = join(homedir(), '.crouter', 'canvas', 'scratch');
34
- function run(args, cwd) {
35
- const res = gitSync(args, cwd);
36
- if (res.status !== 0) {
37
- throw new Error(`git ${args.join(' ')} failed in ${cwd}: ${res.stderr || res.stdout}`);
38
- }
39
- }
40
- function node(id, over = {}) {
41
- return {
42
- node_id: id,
43
- name: id,
44
- created: new Date().toISOString(),
45
- cwd: '/tmp/work',
46
- kind: 'general',
47
- mode: 'base',
48
- lifecycle: 'terminal',
49
- status: 'active',
50
- ...over,
51
- };
52
- }
53
- before(() => {
54
- // NOT realpath'd on purpose: the macOS tmpdir is reached through the
55
- // `/var` → `/private/var` symlink, so the recorded managed-worktree path and
56
- // git's canonical `worktree list` output differ as strings while naming one
57
- // directory. Every path-ownership check must judge identity, not spelling.
58
- mkdirSync(scratchRoot, { recursive: true });
59
- home = mkdtempSync(join(scratchRoot, 'crtr-worktree-home-'));
60
- previousHome = process.env['HOME'];
61
- process.env['HOME'] = home;
62
- process.env['CRTR_HOME'] = home;
63
- // Bare "remote" wired up as origin so the test can prove landing NEVER pushes
64
- // to it (managed worktrees are based on and land onto local `main` only).
65
- remoteDir = mkdtempSync(join(tmpdir(), 'crtr-worktree-remote-'));
66
- run(['init', '--bare'], remoteDir);
67
- sourceDir = mkdtempSync(join(tmpdir(), 'crtr-worktree-source-'));
68
- run(['init', '-b', 'main'], sourceDir);
69
- run(['config', 'user.email', 'test@example.com'], sourceDir);
70
- run(['config', 'user.name', 'Test'], sourceDir);
71
- writeFileSync(join(sourceDir, 'README.md'), 'hello\n');
72
- run(['add', '.'], sourceDir);
73
- run(['commit', '-m', 'init'], sourceDir);
74
- run(['remote', 'add', 'origin', remoteDir], sourceDir);
75
- run(['push', '-u', 'origin', 'main'], sourceDir);
76
- });
77
- beforeEach(() => {
78
- closeDb();
79
- closeScopedStores();
80
- rmSync(home, { recursive: true, force: true });
81
- process.env['CRTR_HOME'] = home;
82
- migrate(openDb());
83
- initializeFreshScopedStore({ kind: 'user', root: userScopeRoot() });
84
- });
85
- after(() => {
86
- closeDb();
87
- closeScopedStores();
88
- rmSync(home, { recursive: true, force: true });
89
- rmSync(remoteDir, { recursive: true, force: true });
90
- rmSync(sourceDir, { recursive: true, force: true });
91
- delete process.env['CRTR_HOME'];
92
- if (previousHome === undefined)
93
- delete process.env['HOME'];
94
- else
95
- process.env['HOME'] = previousHome;
96
- });
97
- // Fix B (#327/#333): a managed worktree with zero commits ahead of its base
98
- // and nothing uncommitted has nothing to land — push-final's auto-drop path
99
- // (autoDropCleanManagedWorktree) must close it without requiring an explicit
100
- // `node worktree close`.
101
- test('autoDropCleanManagedWorktree drops a clean, zero-commit worktree', async () => {
102
- const { autoDropCleanManagedWorktree } = await import('../../worktree.js');
103
- const nodeId = 'wt-auto-drop-empty';
104
- const wt = createManagedWorktree(sourceDir, nodeId);
105
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
106
- const result = autoDropCleanManagedWorktree(nodeId);
107
- assert.ok(result !== null, 'a worktree with zero commits and a clean tree must be droppable');
108
- assert.equal(result?.worktree_removed, false);
109
- assert.match(result?.worktree_remove_error ?? '', /cleanup pending/);
110
- const meta = getNode(nodeId);
111
- assert.equal(meta?.managed_worktree?.state, 'closed');
112
- assert.equal(meta?.managed_worktree?.cleanup, 'pending');
113
- assert.ok(gitSync(['worktree', 'list', '--porcelain'], sourceDir).stdout.includes(wt.path), 'Git keeps the caller checkout registered until it exits');
114
- assert.equal(meta?.cwd, wt.repo_root, 'auto-dropped node cwd repoints to the durable base checkout');
115
- assert.equal(gitSync(['rev-parse', '--git-dir'], meta.cwd).status, 0, 'repointed cwd resolves to a real git checkout');
116
- assert.ok(existsSync(join(wt.path, '.git')), 'the intact caller worktree remains a git checkout');
117
- const outcome = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
118
- assert.equal(outcome.status, 'complete', 'the daemon-owned sweep consumes pending cleanup after the caller exits');
119
- assert.equal(existsSync(wt.path), false, 'the sweep removes the deferred caller checkout');
120
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], sourceDir).status, 1, 'the sweep deletes the clean managed branch');
121
- const swept = getNode(nodeId)?.managed_worktree;
122
- assert.deepEqual({ state: swept?.state, cleanup: swept?.cleanup }, { state: 'closed', cleanup: 'complete' });
123
- });
124
- test('a dead managed child keeps its open checkout through the sweep and revives there (#962)', async () => {
125
- const repo = mkdtempSync(join(scratchRoot, 'crtr-worktree-962-'));
126
- const nodeId = 'wt-sweep-dead-open';
127
- const originalLaunch = headlessBrokerHost.launch;
128
- try {
129
- run(['init', '-b', 'main'], repo);
130
- run(['config', 'user.email', 'test@example.com'], repo);
131
- run(['config', 'user.name', 'Test'], repo);
132
- writeFileSync(join(repo, 'README.md'), 'hello\n');
133
- run(['add', '.'], repo);
134
- run(['commit', '-m', 'init'], repo);
135
- const wt = createManagedWorktree(repo, nodeId);
136
- createNode(node(nodeId, { cwd: wt.path, status: 'dead', managed_worktree: wt }));
137
- const reconciler = new ManagedWorktreeSweepReconciler();
138
- let pass;
139
- reconciler.run(Date.now(), {
140
- lifecycle: {
141
- acceptsDetachedWork: () => true,
142
- registerDetached: (work) => { pass = work; },
143
- },
144
- fleet: { isClaimed: () => false },
145
- });
146
- await pass;
147
- const afterSweep = getNode(nodeId);
148
- assert.equal(afterSweep.managed_worktree?.state, 'open', 'a failed launch does not authorize disposal');
149
- assert.equal(afterSweep.cwd, wt.path, 'the sweep leaves the durable launch cwd unchanged');
150
- assert.ok(existsSync(wt.path), 'the isolated checkout remains available for recovery');
151
- const testFleet = bindTestFleet();
152
- const launchCwds = [];
153
- headlessBrokerHost.launch = (id, _inv, options) => {
154
- launchCwds.push(options.cwd);
155
- const handle = { pid: process.pid, exited: new Promise(() => { }) };
156
- testFleet.fleet.register(id, handle);
157
- return handle;
158
- };
159
- const revived = await reviveNode(nodeId, { resume: false, capacity: 'freeze' });
160
- assert.equal(revived.outcome, 'launched');
161
- assert.deepEqual(launchCwds, [wt.path], 'a fresh revive launches in the retained managed checkout');
162
- const closedId = 'wt-sweep-closed';
163
- const closedWt = createManagedWorktree(repo, closedId);
164
- createNode(node(closedId, { cwd: closedWt.path, status: 'done', managed_worktree: closedWt }));
165
- closeManagedWorktree(closedId);
166
- const cleanup = await reconcileManagedWorktree(closedId, { stillEligible: () => true });
167
- assert.equal(cleanup.status, 'complete', 'a successful close is still physically cleaned after its engine exits');
168
- assert.equal(getNode(closedId)?.cwd, repo, 'a successful close deliberately repoints future launch cwd to the repository root');
169
- launchCwds.length = 0;
170
- const closedRevive = await reviveNode(closedId, { resume: false, capacity: 'freeze' });
171
- assert.equal(closedRevive.outcome, 'launched');
172
- assert.deepEqual(launchCwds, [repo], 'a closed node still revives against the repository root');
173
- }
174
- finally {
175
- headlessBrokerHost.launch = originalLaunch;
176
- resetFleetForTests();
177
- rmSync(repo, { recursive: true, force: true });
178
- }
179
- });
180
- test('the sweep does not conclude a missing record while its branch survives in a moved repository', async () => {
181
- const repo = mkdtempSync(join(scratchRoot, 'crtr-worktree-moved-root-'));
182
- const movedRepo = join(scratchRoot, `crtr-worktree-moved-root-destination-${Date.now()}`);
183
- const nodeId = 'wt-sweep-moved-root';
184
- try {
185
- run(['init', '-b', 'main'], repo);
186
- run(['config', 'user.email', 'test@example.com'], repo);
187
- run(['config', 'user.name', 'Test'], repo);
188
- writeFileSync(join(repo, 'README.md'), 'hello\n');
189
- run(['add', '.'], repo);
190
- run(['commit', '-m', 'init'], repo);
191
- const wt = createManagedWorktree(repo, nodeId);
192
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
193
- run(['worktree', 'remove', wt.path], repo);
194
- renameSync(repo, movedRepo);
195
- const outcome = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
196
- assert.deepEqual(outcome.status === 'refused' ? outcome.reason : undefined, 'repo_unavailable');
197
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'a missing recorded path cannot prove the worktree branch is gone');
198
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], movedRepo).status, 0, 'the moved repository still holds the managed branch');
199
- }
200
- finally {
201
- rmSync(repo, { recursive: true, force: true });
202
- rmSync(movedRepo, { recursive: true, force: true });
203
- }
204
- });
205
- test('the sweep retries containment when the base upstream advances', async () => {
206
- const nodeId = 'wt-sweep-upstream-advance';
207
- const wt = createManagedWorktree(sourceDir, nodeId);
208
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
209
- writeFileSync(join(wt.path, 'delivered.txt'), 'delivered remotely\n');
210
- run(['add', 'delivered.txt'], wt.path);
211
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'delivered work'], wt.path);
212
- const refused = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
213
- assert.equal(refused.status, 'refused');
214
- const before = getNode(nodeId)?.managed_worktree?.sweep?.observed;
215
- assert.ok(before, 'the initial refusal records the observation that caused backoff');
216
- run(['push', 'origin', `${wt.branch}:main`], wt.path);
217
- run(['fetch', 'origin'], sourceDir);
218
- const completed = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
219
- assert.equal(completed.status, 'complete', 'a newly contained branch is re-proved instead of remaining in backoff');
220
- assert.equal(existsSync(wt.path), false, 'the newly contained checkout is removed');
221
- });
222
- test('the sweep refuses a managed checkout with uncommitted changes', async () => {
223
- const nodeId = 'wt-sweep-dirty';
224
- const wt = createManagedWorktree(sourceDir, nodeId);
225
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
226
- writeFileSync(join(wt.path, 'uncommitted.txt'), 'must survive\n');
227
- const outcome = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
228
- assert.equal(outcome.status, 'refused');
229
- assert.equal(outcome.status === 'refused' ? outcome.reason : undefined, 'dirty_worktree');
230
- assert.ok(existsSync(join(wt.path, 'uncommitted.txt')), 'the uncommitted file remains in the checkout');
231
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], sourceDir).status, 0, 'the managed branch remains');
232
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'the record remains unreconciled');
233
- });
234
- // The lock the sweep holds serializes worktree operations, NOT node lifecycle:
235
- // a revive can land in any await between the containment proof and the removal.
236
- // So eligibility is re-asked immediately before every destructive step, and a
237
- // node that came back keeps the checkout it is now running in.
238
- test('the sweep stops before removing a checkout whose node revived mid-pass', async () => {
239
- const nodeId = 'wt-sweep-revived-mid-pass';
240
- const wt = createManagedWorktree(sourceDir, nodeId);
241
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
242
- // True on the first ask (the pass starts), false afterwards (the revive won).
243
- // Everything about this worktree is otherwise disposable: it is clean and its
244
- // tip is its base, so ONLY the recheck can save it.
245
- let asks = 0;
246
- const outcome = await reconcileManagedWorktree(nodeId, {
247
- stillEligible: () => {
248
- asks += 1;
249
- return asks === 1;
250
- },
251
- });
252
- assert.ok(asks > 1, 'eligibility is re-asked before the destructive steps, not once per pass');
253
- assert.equal(outcome.status, 'skipped');
254
- assert.equal(outcome.status === 'skipped' ? outcome.reason : undefined, 'node_no_longer_terminal');
255
- assert.ok(existsSync(join(wt.path, '.git')), 'the revived node keeps the checkout it is running in');
256
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], sourceDir).status, 0, 'its branch survives');
257
- const record = getNode(nodeId)?.managed_worktree;
258
- assert.equal(record?.state, 'open', 'the record is untouched, so a later pass can resume it');
259
- assert.equal(record?.sweep, undefined, 'a revived node is not charged a refusal or a backoff');
260
- });
261
- test('the sweep refuses unlanded commits when close never recorded land intent', async () => {
262
- const nodeId = 'wt-sweep-no-land-intent';
263
- const wt = createManagedWorktree(sourceDir, nodeId);
264
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
265
- writeFileSync(join(wt.path, 'unlanded.txt'), 'must survive\n');
266
- run(['add', 'unlanded.txt'], wt.path);
267
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'unlanded work'], wt.path);
268
- const branchSha = gitSync(['rev-parse', 'HEAD'], wt.path).stdout.trim();
269
- const outcome = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
270
- assert.equal(outcome.status, 'refused');
271
- assert.equal(outcome.status === 'refused' ? outcome.reason : undefined, 'unlanded_work');
272
- assert.ok(existsSync(wt.path), 'the checkout remains available for a human');
273
- assert.equal(gitSync(['rev-parse', wt.branch], sourceDir).stdout.trim(), branchSha, 'the unlanded branch remains intact');
274
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'the record remains unreconciled');
275
- });
276
- test('the sweep removes a rebased branch whose patches already landed', async () => {
277
- const nodeId = 'wt-sweep-patch-identity';
278
- const wt = createManagedWorktree(sourceDir, nodeId);
279
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
280
- writeFileSync(join(wt.path, 'patch-identity.txt'), 'same content\n');
281
- run(['add', 'patch-identity.txt'], wt.path);
282
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'child patch'], wt.path);
283
- const childSha = gitSync(['rev-parse', 'HEAD'], wt.path).stdout.trim();
284
- writeFileSync(join(sourceDir, 'patch-identity.txt'), 'same content\n');
285
- run(['add', 'patch-identity.txt'], sourceDir);
286
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'landed independently'], sourceDir);
287
- assert.notEqual(gitSync(['rev-parse', 'main'], sourceDir).stdout.trim(), childSha, 'the independently landed patch has a different commit identity');
288
- const outcome = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
289
- assert.equal(outcome.status, 'complete', 'patch identity proves the rebased branch content is already present');
290
- assert.equal(existsSync(wt.path), false, 'the redundant checkout is removed');
291
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], sourceDir).status, 1, 'the redundant branch is deleted');
292
- assert.equal(getNode(nodeId)?.managed_worktree?.cleanup, 'complete');
293
- });
294
- test('the sweep removes a squash-merged branch whose merge is a content no-op', async () => {
295
- const nodeId = 'wt-sweep-content-noop';
296
- const wt = createManagedWorktree(sourceDir, nodeId);
297
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
298
- writeFileSync(join(wt.path, 'squash-one.txt'), 'one\n');
299
- run(['add', 'squash-one.txt'], wt.path);
300
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'first child patch'], wt.path);
301
- writeFileSync(join(wt.path, 'squash-two.txt'), 'two\n');
302
- run(['add', 'squash-two.txt'], wt.path);
303
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'second child patch'], wt.path);
304
- run(['merge', '--squash', wt.branch], sourceDir);
305
- run(['commit', '-m', 'squash landed child work'], sourceDir);
306
- const outcome = await reconcileManagedWorktree(nodeId, { stillEligible: () => true });
307
- assert.equal(outcome.status, 'complete', 'a content-no-op merge proves squash-landed work is safe to remove');
308
- assert.equal(existsSync(wt.path), false, 'the redundant checkout is removed');
309
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], sourceDir).status, 1, 'the squash-landed branch is deleted');
310
- assert.equal(getNode(nodeId)?.managed_worktree?.cleanup, 'complete');
311
- });
312
- // The same real-commit case close already protects: a worktree with actual
313
- // unlanded work must NEVER be auto-dropped by push-final.
314
- // #671 also makes the explicit close terminal: once the checkout was safely
315
- // removed after remote delivery, close concludes the record rather than
316
- // sending the node to a recovery command that cannot address an absent path.
317
- test('closeManagedWorktree concludes an absent checkout whose branch is delivered to its base upstream (#671)', () => {
318
- const repo = mkdtempSync(join(tmpdir(), 'crtr-worktree-671-close-'));
319
- const remote = mkdtempSync(join(tmpdir(), 'crtr-worktree-671-close-remote-'));
320
- try {
321
- run(['init', '-b', 'main'], repo);
322
- run(['config', 'user.email', 'test@example.com'], repo);
323
- run(['config', 'user.name', 'Test'], repo);
324
- writeFileSync(join(repo, 'README.md'), 'hello\n');
325
- run(['add', '.'], repo);
326
- run(['commit', '-m', 'init'], repo);
327
- run(['init', '--bare'], remote);
328
- run(['remote', 'add', 'origin', remote], repo);
329
- run(['push', '-u', 'origin', 'main'], repo);
330
- const nodeId = 'wt-671-close';
331
- const wt = createManagedWorktree(repo, nodeId);
332
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
333
- writeFileSync(join(wt.path, 'delivered.txt'), 'delivered remotely\n');
334
- run(['add', '.'], wt.path);
335
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'delivered remotely'], wt.path);
336
- const deliveredSha = gitSync(['rev-parse', 'HEAD'], wt.path).stdout.trim();
337
- run(['push', 'origin', `${wt.branch}:main`], wt.path);
338
- run(['fetch', 'origin'], repo);
339
- run(['worktree', 'remove', wt.path], repo);
340
- const result = closeManagedWorktree(nodeId);
341
- assert.equal(result.landed_sha, deliveredSha, 'close reports the already-delivered branch tip');
342
- assert.equal(result.worktree_removed, true, 'the absent path is already removed');
343
- assert.equal(result.branch_deleted, true, 'the redundant local branch is deleted with upstream proof');
344
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'closed');
345
- assert.equal(getNode(nodeId)?.cwd, wt.repo_root, 'the closed record repoints revive to the durable base checkout');
346
- }
347
- finally {
348
- rmSync(repo, { recursive: true, force: true });
349
- rmSync(remote, { recursive: true, force: true });
350
- }
351
- });
352
- // #671 review finding (Major): the recorded path being absent does not mean
353
- // the branch has no live checkout — `git worktree move` can relocate it
354
- // elsewhere. The branch must never be low-level-deleted while still checked
355
- // out somewhere, even when its tip is already contained in the base upstream.
356
- test('closeManagedWorktree refuses when the recorded path is absent but the branch is checked out elsewhere with uncommitted work', () => {
357
- const repo = mkdtempSync(join(tmpdir(), 'crtr-worktree-671-moved-'));
358
- const remote = mkdtempSync(join(tmpdir(), 'crtr-worktree-671-moved-remote-'));
359
- const movedPath = mkdtempSync(join(tmpdir(), 'crtr-worktree-671-moved-dest-'));
360
- rmSync(movedPath, { recursive: true, force: true });
361
- try {
362
- run(['init', '-b', 'main'], repo);
363
- run(['config', 'user.email', 'test@example.com'], repo);
364
- run(['config', 'user.name', 'Test'], repo);
365
- writeFileSync(join(repo, 'README.md'), 'hello\n');
366
- run(['add', '.'], repo);
367
- run(['commit', '-m', 'init'], repo);
368
- run(['init', '--bare'], remote);
369
- run(['remote', 'add', 'origin', remote], repo);
370
- run(['push', '-u', 'origin', 'main'], repo);
371
- const nodeId = 'wt-671-moved';
372
- const wt = createManagedWorktree(repo, nodeId);
373
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
374
- writeFileSync(join(wt.path, 'delivered.txt'), 'delivered remotely\n');
375
- run(['add', '.'], wt.path);
376
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'delivered remotely'], wt.path);
377
- run(['push', 'origin', `${wt.branch}:main`], wt.path);
378
- run(['fetch', 'origin'], repo);
379
- // Relocate the checkout — the recorded `wt.path` is now absent, but the
380
- // branch is still live at `movedPath`, and unrelated new work is added
381
- // there AFTER the move, so it is not reachable from origin/main.
382
- run(['worktree', 'move', wt.path, movedPath], repo);
383
- assert.equal(existsSync(wt.path), false, 'the recorded path must actually be absent for this test to be meaningful');
384
- writeFileSync(join(movedPath, 'uncommitted-after-move.txt'), 'must not be lost\n');
385
- assert.throws(() => closeManagedWorktree(nodeId), (error) => error instanceof Error && 'code' in error && error.code === 'worktree_missing', 'a branch still checked out elsewhere must never be concluded from the absent recorded path alone');
386
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'the record must stay open — the branch has a live checkout with uncommitted work');
387
- const refCheck = gitSync(['rev-parse', '--verify', `refs/heads/${wt.branch}`], repo);
388
- assert.equal(refCheck.status, 0, 'the branch must be preserved — it is still checked out');
389
- assert.ok(existsSync(join(movedPath, 'uncommitted-after-move.txt')), 'the uncommitted work at the relocated checkout must remain intact');
390
- }
391
- finally {
392
- rmSync(repo, { recursive: true, force: true });
393
- rmSync(remote, { recursive: true, force: true });
394
- rmSync(movedPath, { recursive: true, force: true });
395
- }
396
- });
397
- test('autoDropCleanManagedWorktree refuses a worktree with a real commit ahead of base', async () => {
398
- const { autoDropCleanManagedWorktree } = await import('../../worktree.js');
399
- const nodeId = 'wt-auto-drop-real-work';
400
- const wt = createManagedWorktree(sourceDir, nodeId);
401
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
402
- writeFileSync(join(wt.path, 'real-work.txt'), 'work\n');
403
- run(['add', '.'], wt.path);
404
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'real work'], wt.path);
405
- const result = autoDropCleanManagedWorktree(nodeId);
406
- assert.equal(result, null, 'a worktree with a real commit ahead of base must never be silently dropped');
407
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'the worktree must remain open for an explicit close');
408
- assert.ok(existsSync(wt.path), 'the checkout with real work must remain intact');
409
- });
410
- // Real uncommitted (non-crtr-bookkeeping) changes must also refuse auto-drop,
411
- // even with zero commits.
412
- test('autoDropCleanManagedWorktree refuses a worktree with real uncommitted changes', async () => {
413
- const { autoDropCleanManagedWorktree } = await import('../../worktree.js');
414
- const nodeId = 'wt-auto-drop-dirty';
415
- const wt = createManagedWorktree(sourceDir, nodeId);
416
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
417
- writeFileSync(join(wt.path, 'uncommitted.txt'), 'not yet committed\n');
418
- const result = autoDropCleanManagedWorktree(nodeId);
419
- assert.equal(result, null, 'real uncommitted changes must never be silently dropped');
420
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open');
421
- });
422
- test('async close returns the typed lock refusal before the client socket timeout (#1024)', async () => {
423
- const nodeId = 'wt-async-close-busy';
424
- const wt = createManagedWorktree(sourceDir, nodeId);
425
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
426
- const commonDir = realpathSync(join(sourceDir, gitSync(['rev-parse', '--git-common-dir'], sourceDir).stdout.trim()));
427
- const lockModule = new URL('../../exclusive-lock.ts', import.meta.url).href;
428
- const child = spawn(process.execPath, ['--import', 'tsx/esm', '--input-type=module', '--eval', `
429
- const { withExclusiveDirectoryLockAsync } = await import(${JSON.stringify(lockModule)});
430
- await withExclusiveDirectoryLockAsync(${JSON.stringify(worktreeLockPathForCommonDir(commonDir))}, async () => {
431
- console.log('locked');
432
- await new Promise((resolve) => setTimeout(resolve, 40_000));
433
- });
434
- `], { env: { ...process.env, CRTR_HOME: home }, stdio: ['ignore', 'pipe', 'pipe'] });
435
- try {
436
- await new Promise((resolve, reject) => {
437
- let output = '';
438
- child.stdout.on('data', (chunk) => { output += chunk; if (output.includes('locked'))
439
- resolve(); });
440
- child.once('error', reject);
441
- child.once('exit', (code) => reject(new Error(`lock holder exited before acquiring the lock (${code})`)));
442
- });
443
- const server = createApiServer();
444
- try {
445
- await new Promise((resolve) => setTimeout(resolve, 25));
446
- const client = new CrtrClient({ socketPath: apiSocketPath(), autostart: false });
447
- const started = Date.now();
448
- await assert.rejects(client.closeWorktree(nodeId), (error) => error instanceof ApiError && error.code === 'worktree_lock_timeout');
449
- assert.ok(Date.now() - started < 30_000, 'the daemon must serialize the typed busy refusal before the 30s client timeout');
450
- }
451
- finally {
452
- await server.close();
453
- }
454
- }
455
- finally {
456
- child.kill('SIGTERM');
457
- }
458
- });
459
- test('async close yields while an async repository holder runs, keeping API requests responsive (#1024)', async () => {
460
- const zeroId = 'wt-async-close-zero';
461
- const committedId = 'wt-async-close-committed';
462
- const zero = createManagedWorktree(sourceDir, zeroId);
463
- const committed = createManagedWorktree(sourceDir, committedId);
464
- createNode(node(zeroId, { cwd: zero.path, managed_worktree: zero }));
465
- createNode(node(committedId, { cwd: committed.path, managed_worktree: committed }));
466
- writeFileSync(join(committed.path, 'committed.txt'), 'work\n');
467
- run(['add', 'committed.txt'], committed.path);
468
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'work'], committed.path);
469
- const commonDir = realpathSync(join(sourceDir, gitSync(['rev-parse', '--git-common-dir'], sourceDir).stdout.trim()));
470
- let release;
471
- const held = new Promise((resolve) => { release = resolve; });
472
- const holder = withExclusiveDirectoryLockAsync(worktreeLockPathForCommonDir(commonDir), async () => { await held; });
473
- await new Promise((resolve) => setTimeout(resolve, 25));
474
- const server = createApiServer();
475
- try {
476
- await new Promise((resolve) => setTimeout(resolve, 25));
477
- const client = new CrtrClient({ socketPath: apiSocketPath(), autostart: false });
478
- const zeroClose = client.closeWorktree(zeroId);
479
- const committedClose = client.closeWorktree(committedId);
480
- const responsive = await Promise.race([client.listNodes().then(() => true), new Promise((resolve) => setTimeout(() => resolve(false), 250))]);
481
- assert.equal(responsive, true, 'a waiting close must not block another daemon request');
482
- release();
483
- await holder;
484
- const [zeroResult, committedResult] = await Promise.all([zeroClose, committedClose]);
485
- assert.equal(zeroResult.landed_sha, zero.base_sha, 'the zero-commit close returns its actual result after the holder releases');
486
- assert.equal(committedResult.landed_sha, gitSync(['rev-parse', 'HEAD'], committed.path).stdout.trim(), 'the committed close returns its actual landed result after the holder releases');
487
- }
488
- finally {
489
- release();
490
- await holder;
491
- await server.close();
492
- }
493
- });
494
- test('async abandon retains clean committed work after its base branch is deleted without a remote (#929)', async () => {
495
- const repo = mkdtempSync(join(tmpdir(), 'crtr-worktree-929-'));
496
- try {
497
- run(['init', '-b', 'main'], repo);
498
- run(['config', 'user.email', 'test@example.com'], repo);
499
- run(['config', 'user.name', 'Test'], repo);
500
- writeFileSync(join(repo, 'README.md'), 'hello\n');
501
- run(['add', '.'], repo);
502
- run(['commit', '-m', 'init'], repo);
503
- const nodeId = 'wt-abandon-missing-base';
504
- const wt = createManagedWorktree(repo, nodeId);
505
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
506
- writeFileSync(join(wt.path, 'committed.txt'), 'committed work\n');
507
- run(['add', 'committed.txt'], wt.path);
508
- run(['commit', '-m', 'real work'], wt.path);
509
- const tipSha = gitSync(['rev-parse', 'HEAD'], wt.path).stdout.trim();
510
- assert.equal(gitSync(['remote'], repo).stdout.trim(), '', 'the repository has no remote that could prove delivery');
511
- run(['checkout', '--detach'], repo);
512
- run(['branch', '-D', 'main'], repo);
513
- const result = await abandonManagedWorktreeAsync(nodeId, 'test-invoker');
514
- assert.equal(result.branch_deleted, false, 'without containment proof the committed branch must be retained');
515
- assert.equal(result.tip_sha, tipSha, 'abandon must retain the exact committed tip');
516
- assert.equal(existsSync(wt.path), false, 'abandon removes only the checkout');
517
- assert.equal(gitSync(['rev-parse', wt.branch], repo).stdout.trim(), tipSha, 'the retained branch still reaches the committed work');
518
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'abandoned', 'the node records the abandoned disposition');
519
- }
520
- finally {
521
- rmSync(repo, { recursive: true, force: true });
522
- }
523
- });
524
- test('abandon preserves committed and dirty work, records its retained tip, and releases finalization', async () => {
525
- const nodeId = 'wt-abandon';
526
- const wt = createManagedWorktree(sourceDir, nodeId);
527
- writeFileSync(join(wt.path, 'committed.txt'), 'committed work\n');
528
- run(['add', '.'], wt.path);
529
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'real work'], wt.path);
530
- writeFileSync(join(wt.path, 'dirty.txt'), 'dirty work\n');
531
- createNode(node(nodeId, { cwd: wt.path, status: 'done', managed_worktree: wt }));
532
- const server = createApiServer();
533
- try {
534
- await new Promise((resolve) => setTimeout(resolve, 25));
535
- const client = new CrtrClient({ socketPath: apiSocketPath(), autostart: false });
536
- const result = await client.abandonWorktree(nodeId, { by: 'test-invoker' });
537
- const meta = getNode(nodeId);
538
- assert.equal(gitSync(['rev-parse', wt.branch], sourceDir).stdout.trim(), result.tip_sha, 'the retained branch names the recorded tip');
539
- assert.equal(gitSync(['show', `${result.tip_sha}:committed.txt`], sourceDir).stdout, 'committed work\n', 'the pre-existing commit remains reachable');
540
- assert.equal(gitSync(['show', `${result.tip_sha}:dirty.txt`], sourceDir).stdout, 'dirty work\n', 'the WIP commit preserves dirty work');
541
- assert.equal(gitSync(['show', '-s', '--format=%an <%ae>%n%s%n%(trailers:only)', result.tip_sha], sourceDir).stdout, `crtr-abandon <crtr-abandon@localhost>\ncrtr-abandon\nCrtr-Abandon: ${nodeId} ${meta?.managed_worktree?.abandoned?.at}\n\n`, 'the WIP commit has the reserved author, subject sentinel, and durable trailer');
542
- assert.equal(existsSync(wt.path), false, 'the checkout is removed');
543
- assert.equal(meta?.managed_worktree?.state, 'abandoned', 'the node records the abandoned disposition');
544
- assert.deepEqual(meta?.managed_worktree?.abandoned, { branch: wt.branch, tip_sha: result.tip_sha, at: meta?.managed_worktree?.abandoned?.at, by: 'test-invoker' }, 'the metadata names the retained tip and invoker');
545
- assert.equal(meta?.cwd, wt.repo_root, 'the node cwd repoints to the repository root');
546
- await client.pushReport(nodeId, { tier: 'final', body: 'abandoned work preserved' });
547
- assert.ok(getNode(nodeId)?.final_report, 'push final proceeds after abandon releases the worktree gate');
548
- }
549
- finally {
550
- await server.close();
551
- }
552
- });
553
- // The actual #327 positive case: a branch with REAL commits whose tip is
554
- // already contained in a base that moved forward past this worktree's
555
- // original base_sha (a manager landed the same change another way, without
556
- // ever going through crtr's own close path). This must auto-drop and, above
557
- // all, must never lose the work — it stays reachable from the moved base.
558
- test('autoDropCleanManagedWorktree drops a branch with real commits already contained in a moved base (#327)', async () => {
559
- const { autoDropCleanManagedWorktree } = await import('../../worktree.js');
560
- const repo = mkdtempSync(join(tmpdir(), 'crtr-worktree-327-'));
561
- run(['init', '-b', 'main'], repo);
562
- run(['config', 'user.email', 'test@example.com'], repo);
563
- run(['config', 'user.name', 'Test'], repo);
564
- writeFileSync(join(repo, 'README.md'), 'hello\n');
565
- run(['add', '.'], repo);
566
- run(['commit', '-m', 'init'], repo);
567
- const nodeId = 'wt-327-positive';
568
- const wt = createManagedWorktree(repo, nodeId);
569
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
570
- writeFileSync(join(wt.path, 'feature.txt'), 'landed elsewhere\n');
571
- run(['add', '.'], wt.path);
572
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'feature'], wt.path);
573
- const branchSha = gitSync(['rev-parse', 'HEAD'], wt.path).stdout.trim();
574
- // A manager fast-forwards main past this branch's own tip directly in the
575
- // primary checkout — the base moved AFTER the worktree was created, and
576
- // this branch's commits are now redundant, not lost.
577
- run(['merge', '--ff-only', branchSha], repo);
578
- assert.equal(gitSync(['rev-parse', 'main'], repo).stdout.trim(), branchSha);
579
- const result = autoDropCleanManagedWorktree(nodeId);
580
- assert.ok(result !== null, 'a branch whose commits are already contained in a moved base has nothing left to land');
581
- assert.equal(result?.branch_deleted, false);
582
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'closed');
583
- assert.equal(getNode(nodeId)?.managed_worktree?.cleanup, 'pending');
584
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], repo).status, 0, 'the caller branch remains checked out until cleanup runs after exit');
585
- // The work itself is NOT lost — it stays reachable from main, which is the point.
586
- assert.equal(gitSync(['merge-base', '--is-ancestor', branchSha, 'main'], repo).status, 0, 'the landed commit must remain reachable from main after the drop');
587
- rmSync(repo, { recursive: true, force: true });
588
- });
589
- // A clean child whose recorded base branch vanished has nothing to land only
590
- // when its live HEAD exactly matches the persisted creation SHA.
591
- test('autoDropCleanManagedWorktree drops a clean worktree at base_sha when its recorded base branch no longer resolves', async () => {
592
- const { autoDropCleanManagedWorktree } = await import('../../worktree.js');
593
- const repo = mkdtempSync(join(tmpdir(), 'crtr-worktree-missingbase-'));
594
- run(['init', '-b', 'main'], repo);
595
- run(['config', 'user.email', 'test@example.com'], repo);
596
- run(['config', 'user.name', 'Test'], repo);
597
- writeFileSync(join(repo, 'README.md'), 'hello\n');
598
- run(['add', '.'], repo);
599
- run(['commit', '-m', 'init'], repo);
600
- const nodeId = 'wt-missing-base';
601
- const wt = createManagedWorktree(repo, nodeId);
602
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
603
- // The recorded base branch ('main') has been renamed away since creation.
604
- run(['branch', '-m', 'main', 'renamed-main'], repo);
605
- const result = autoDropCleanManagedWorktree(nodeId);
606
- assert.ok(result !== null, 'a clean worktree exactly at its recorded base SHA has nothing to land');
607
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'closed');
608
- assert.ok(existsSync(wt.path));
609
- rmSync(repo, { recursive: true, force: true });
610
- });
611
- // Reap may take the same missing-base no-op only after show-ref completed with
612
- // its documented absent-ref status; inspection failures must remain visible.
613
- test('autoDropCleanManagedWorktree surfaces a failed base ref inspection', async () => {
614
- const { autoDropCleanManagedWorktree } = await import('../../worktree.js');
615
- const nodeId = 'wt-reap-base-ref-inspection-failure';
616
- const wt = createManagedWorktree(sourceDir, nodeId);
617
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
618
- const wrapperDir = mkdtempSync(join(tmpdir(), 'crtr-git-wrapper-'));
619
- const wrapperPath = join(wrapperDir, 'git');
620
- const originalPath = process.env['PATH'] ?? '';
621
- writeFileSync(wrapperPath, `#!/bin/sh
622
- if [ "$1" = "show-ref" ] && [ "$2" = "--verify" ] && [ "$3" = "--quiet" ] && [ "$4" = "refs/heads/main" ]; then
623
- echo "simulated unreadable ref store" >&2
624
- exit 128
625
- fi
626
- PATH="$CRTR_TEST_REAL_PATH" exec git "$@"
627
- `);
628
- chmodSync(wrapperPath, 0o755);
629
- process.env['CRTR_TEST_REAL_PATH'] = originalPath;
630
- process.env['PATH'] = `${wrapperDir}:${originalPath}`;
631
- try {
632
- assert.throws(() => autoDropCleanManagedWorktree(nodeId), (error) => error instanceof Error
633
- && 'code' in error
634
- && error.code === 'base_branch_inspection_failed'
635
- && 'detail' in error
636
- && typeof error.detail === 'string'
637
- && error.detail.includes('status: 128')
638
- && error.detail.includes('stderr: simulated unreadable ref store'));
639
- }
640
- finally {
641
- process.env['PATH'] = originalPath;
642
- delete process.env['CRTR_TEST_REAL_PATH'];
643
- rmSync(wrapperDir, { recursive: true, force: true });
644
- run(['worktree', 'remove', wt.path], sourceDir);
645
- run(['branch', '-D', wt.branch], sourceDir);
646
- }
647
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'the failed inspection must not mark a clean worktree closed');
648
- assert.ok(!existsSync(wt.path), 'the test must clean up its temporary checkout');
649
- });
650
- // The Critical fix: the TOCTOU race between proving clean-and-contained and
651
- // the destructive branch delete. `proveCleanEmptyManagedWorktree` and
652
- // `autoDropCleanManagedWorktreeLocked` are exported specifically so these
653
- // tests can inject a race deterministically in the window between them —
654
- // exactly the window the repository lock does NOT close (it only serializes
655
- // crtr's own worktree mutations, not ordinary `git commit`/`git reset`/an
656
- // external base rewrite run by any other process against the checkout).
657
- // A concurrent commit lands on the managed branch after the predicate proved
658
- // it clean-and-contained, but before cleanup deletes it. The atomic
659
- // compare-and-delete must refuse, leaving the branch (and the new commit)
660
- // fully intact.
661
- test('the atomic delete refuses when a commit lands on the branch between the predicate and cleanup', async () => {
662
- const { proveCleanEmptyManagedWorktree, autoDropCleanManagedWorktreeLocked } = await import('../../worktree.js');
663
- const nodeId = 'wt-race-branch-commit';
664
- const wt = createManagedWorktree(sourceDir, nodeId);
665
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
666
- const proof = proveCleanEmptyManagedWorktree(wt);
667
- assert.ok(proof !== null, 'a fresh clean, zero-commit worktree must prove droppable');
668
- // Simulate a concurrent process committing new work on the managed branch
669
- // in the window between the predicate and cleanup.
670
- writeFileSync(join(wt.path, 'concurrent-work.txt'), 'a real commit landed mid-cleanup\n');
671
- run(['add', '.'], wt.path);
672
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'concurrent work'], wt.path);
673
- const concurrentSha = gitSync(['rev-parse', 'HEAD'], wt.path).stdout.trim();
674
- assert.notEqual(concurrentSha, proof?.branchSha, 'the branch must have actually moved past the proven SHA for this test to be meaningful');
675
- const result = autoDropCleanManagedWorktreeLocked(nodeId, wt, proof);
676
- assert.equal(result, null, 'the atomic delete must refuse once the branch has moved past the proven SHA');
677
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'state must stay open — nothing may be marked safely dropped');
678
- assert.ok(existsSync(wt.path), 'the path must still resolve (tombstoned if the checkout itself was removed) — never left dangling');
679
- // The actual safety property: the branch ref, and the concurrent commit it
680
- // now names, are fully preserved — regardless of whether the checkout
681
- // itself survived (git requires removing it before the ref delete can even
682
- // be attempted; see the ordering note on autoDropCleanManagedWorktreeLocked).
683
- const refCheck = gitSync(['rev-parse', '--verify', `refs/heads/${wt.branch}`], wt.repo_root);
684
- assert.equal(refCheck.status, 0, 'the branch ref must still exist');
685
- assert.equal(refCheck.stdout.trim(), concurrentSha, 'the branch, and the concurrent commit it names, must still be reachable — nothing was lost');
686
- });
687
- // An external rewrite of the base branch (e.g. a force-reset) invalidates the
688
- // containment proof in the same window. The re-verification immediately
689
- // before the delete must catch this even though the branch itself never
690
- // moved.
691
- test('the re-verified base containment refuses when the base is rewritten between the predicate and cleanup', async () => {
692
- const { proveCleanEmptyManagedWorktree, autoDropCleanManagedWorktreeLocked } = await import('../../worktree.js');
693
- const repo = mkdtempSync(join(tmpdir(), 'crtr-worktree-race-base-'));
694
- run(['init', '-b', 'main'], repo);
695
- run(['config', 'user.email', 'test@example.com'], repo);
696
- run(['config', 'user.name', 'Test'], repo);
697
- writeFileSync(join(repo, 'README.md'), 'hello\n');
698
- run(['add', '.'], repo);
699
- run(['commit', '-m', 'init'], repo);
700
- const nodeId = 'wt-race-base-rewrite';
701
- const wt = createManagedWorktree(repo, nodeId);
702
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
703
- const proof = proveCleanEmptyManagedWorktree(wt);
704
- assert.ok(proof !== null, 'a fresh clean, zero-commit worktree must prove droppable');
705
- // Simulate an external force-reset of the base branch in the same window —
706
- // an unrelated rewrite (not a fast-forward), so the proven branch tip is no
707
- // longer an ancestor of the new base tip.
708
- writeFileSync(join(repo, 'rewritten.txt'), 'unrelated history\n');
709
- run(['add', '.'], repo);
710
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '--amend', '-m', 'rewritten base tip'], repo);
711
- const rewrittenBaseSha = gitSync(['rev-parse', 'main'], repo).stdout.trim();
712
- assert.notEqual(rewrittenBaseSha, proof?.baseSha, 'the base must have actually moved for this test to be meaningful');
713
- const stillAncestor = gitSync(['merge-base', '--is-ancestor', proof.branchSha, rewrittenBaseSha], repo);
714
- assert.notEqual(stillAncestor.status, 0, 'the rewrite must actually break containment for this test to be meaningful');
715
- const result = autoDropCleanManagedWorktreeLocked(nodeId, wt, proof);
716
- assert.equal(result, null, 'a base rewrite that breaks containment must refuse the drop');
717
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'state must stay open — nothing may be marked safely dropped');
718
- assert.ok(existsSync(wt.path), 'the checkout must remain intact');
719
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], repo).status, 0, 'the branch ref must still exist — nothing was lost');
720
- rmSync(repo, { recursive: true, force: true });
721
- });
722
- // The base-ref TOCTOU: a branch-only compare-and-delete refuses when the
723
- // BRANCH moves, but a base force-reset between the containment proof and the
724
- // delete could still leave the delete's own condition (the branch equals the
725
- // proven SHA) satisfied while the branch is no longer contained in anything.
726
- // `bestEffortDeleteBranchWithBaseProof` closes this by binding the base's
727
- // live value into the SAME atomic transaction as the branch delete. These
728
- // tests reproduce the race against real Git by wrapping the `git worktree
729
- // remove` call each cleanup path makes strictly between its live ancestry
730
- // re-check and its ref-deletion transaction — the same technique used above
731
- // for the branch-only race, and the same one the independent re-review used
732
- // to reproduce this exact Critical against `6de1c8d`.
733
- test('close-landed atomic delete refuses when the base is force-reset between landing and the cleanup delete', () => {
734
- const repo = mkdtempSync(join(tmpdir(), 'crtr-worktree-close-base-window-'));
735
- run(['init', '-b', 'main'], repo);
736
- run(['config', 'user.email', 'test@example.com'], repo);
737
- run(['config', 'user.name', 'Test'], repo);
738
- writeFileSync(join(repo, 'README.md'), 'hello\n');
739
- run(['add', '.'], repo);
740
- run(['commit', '-m', 'init'], repo);
741
- const preLandMainSha = gitSync(['rev-parse', 'main'], repo).stdout.trim();
742
- const nodeId = 'wt-close-base-window';
743
- const wt = createManagedWorktree(repo, nodeId);
744
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
745
- writeFileSync(join(wt.path, 'feature.txt'), 'work\n');
746
- run(['add', '.'], wt.path);
747
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'feature'], wt.path);
748
- // Wrap `git worktree remove` — the call `bestEffortRemoveWorktreeCheckout`
749
- // makes right after landing (fast-forwarding main to the new tip) but
750
- // strictly before the atomic base+branch delete transaction — to reset main
751
- // away from the just-landed tip in exactly that window.
752
- const wrapperDir = mkdtempSync(join(tmpdir(), 'crtr-git-wrapper-'));
753
- const wrapperPath = join(wrapperDir, 'git');
754
- const originalPath = process.env['PATH'] ?? '';
755
- writeFileSync(wrapperPath, `#!/bin/sh
756
- if [ "$1" = "worktree" ] && [ "$2" = "remove" ] && [ "$3" = "${wt.path}" ]; then
757
- PATH="$CRTR_TEST_REAL_PATH" git -C "${repo}" update-ref refs/heads/main "${preLandMainSha}"
758
- fi
759
- PATH="$CRTR_TEST_REAL_PATH" exec git "$@"
760
- `);
761
- chmodSync(wrapperPath, 0o755);
762
- process.env['CRTR_TEST_REAL_PATH'] = originalPath;
763
- process.env['PATH'] = `${wrapperDir}:${originalPath}`;
764
- let result;
765
- try {
766
- result = closeManagedWorktree(nodeId);
767
- }
768
- finally {
769
- process.env['PATH'] = originalPath;
770
- delete process.env['CRTR_TEST_REAL_PATH'];
771
- rmSync(wrapperDir, { recursive: true, force: true });
772
- }
773
- assert.equal(result.branch_deleted, false, 'a base reset in the window between landing and cleanup must refuse the branch delete');
774
- assert.ok(result.branch_delete_error, 'the refusal must be surfaced as a non-fatal cleanup error');
775
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'closed', 'the land already succeeded — a cleanup refusal must not un-close it');
776
- const refCheck = gitSync(['rev-parse', '--verify', `refs/heads/${wt.branch}`], repo);
777
- assert.equal(refCheck.status, 0, 'the source branch must be preserved when cleanup refuses');
778
- assert.equal(refCheck.stdout.trim(), result.landed_sha, 'the preserved branch must still name the landed commit — no orphaned landed commit');
779
- rmSync(repo, { recursive: true, force: true });
780
- });
781
- // Checkout-removal refusal: `bestEffortRemoveWorktreeCheckout` can report
782
- // `worktreeRemoved: false` (real Git refused `worktree remove` because a
783
- // file reappeared after the clean predicate ran). That refusal must itself
784
- // refuse the whole cleanup — never reach the low-level ref-deletion
785
- // transaction, which bypasses Git's own checked-out-branch protection.
786
- test('auto-drop refuses and preserves the branch and checkout when checkout removal is refused after the clean predicate', async () => {
787
- const { proveCleanEmptyManagedWorktree, autoDropCleanManagedWorktreeLocked } = await import('../../worktree.js');
788
- const nodeId = 'wt-auto-drop-removal-refused';
789
- const wt = createManagedWorktree(sourceDir, nodeId);
790
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
791
- const proof = proveCleanEmptyManagedWorktree(wt);
792
- assert.ok(proof !== null, 'a fresh clean, zero-commit worktree must prove droppable');
793
- // A file appears after the clean predicate ran — real `git worktree
794
- // remove` (no --force) correctly refuses to remove a dirty checkout.
795
- writeFileSync(join(wt.path, 'late-arrival.txt'), 'appeared after the clean predicate\n');
796
- const result = autoDropCleanManagedWorktreeLocked(nodeId, wt, proof);
797
- assert.equal(result, null, 'a checkout-removal refusal must refuse the whole drop, not just skip the branch delete');
798
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'open', 'refused cleanup must never mutate managed-worktree state');
799
- assert.equal(gitSync(['show-ref', '--verify', '--quiet', `refs/heads/${wt.branch}`], sourceDir).status, 0, 'the branch must never reach the ref-deletion transaction');
800
- const list = gitSync(['worktree', 'list', '--porcelain'], sourceDir);
801
- assert.ok(list.stdout.includes(wt.path), 'the checkout must remain registered and recoverable');
802
- assert.ok(existsSync(join(wt.path, 'late-arrival.txt')), 'the live checkout, including its uncommitted file, must remain intact');
803
- });
804
- test('close-landed never low-level-deletes the source branch when checkout removal is refused', () => {
805
- const nodeId = 'wt-close-removal-refused';
806
- const wt = createManagedWorktree(sourceDir, nodeId);
807
- createNode(node(nodeId, { cwd: wt.path, managed_worktree: wt }));
808
- writeFileSync(join(wt.path, 'removal-refused-work.txt'), 'work\n');
809
- run(['add', '.'], wt.path);
810
- run(['-c', 'user.email=test@example.com', '-c', 'user.name=Test', 'commit', '-m', 'feature'], wt.path);
811
- // Wrap `git worktree remove` to drop an untracked file into the checkout
812
- // immediately before delegating to the real removal, so the real
813
- // `git worktree remove` (no --force) refuses — exactly as it would if a
814
- // process wrote into the checkout after close's own dirty check ran.
815
- const wrapperDir = mkdtempSync(join(tmpdir(), 'crtr-git-wrapper-'));
816
- const wrapperPath = join(wrapperDir, 'git');
817
- const originalPath = process.env['PATH'] ?? '';
818
- writeFileSync(wrapperPath, `#!/bin/sh
819
- if [ "$1" = "worktree" ] && [ "$2" = "remove" ] && [ "$3" = "${wt.path}" ]; then
820
- echo "late arrival" > "${wt.path}/late-arrival.txt"
821
- fi
822
- PATH="$CRTR_TEST_REAL_PATH" exec git "$@"
823
- `);
824
- chmodSync(wrapperPath, 0o755);
825
- process.env['CRTR_TEST_REAL_PATH'] = originalPath;
826
- process.env['PATH'] = `${wrapperDir}:${originalPath}`;
827
- let result;
828
- try {
829
- result = closeManagedWorktree(nodeId);
830
- }
831
- finally {
832
- process.env['PATH'] = originalPath;
833
- delete process.env['CRTR_TEST_REAL_PATH'];
834
- rmSync(wrapperDir, { recursive: true, force: true });
835
- }
836
- assert.equal(result.worktree_removed, false, 'the real checkout removal must genuinely refuse');
837
- assert.equal(result.branch_deleted, false, 'a checkout-removal refusal must never be treated as safe to low-level-delete the branch');
838
- assert.equal(getNode(nodeId)?.managed_worktree?.state, 'closed', 'the land already succeeded — a cleanup refusal must not un-close it');
839
- const refCheck = gitSync(['rev-parse', '--verify', `refs/heads/${wt.branch}`], sourceDir);
840
- assert.equal(refCheck.status, 0, 'the source branch must be preserved when its checkout could not be removed');
841
- assert.equal(refCheck.stdout.trim(), result.landed_sha, 'the preserved branch must still name the landed commit');
842
- });