pi-crew 0.9.50 → 0.9.52

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 (609) hide show
  1. package/CHANGELOG.md +150 -0
  2. package/README.md +216 -20
  3. package/dist/build-meta.json +2222 -1761
  4. package/dist/index.mjs +18636 -17603
  5. package/docs/actions-reference.md +431 -1
  6. package/package.json +19 -9
  7. package/schema.json +41 -0
  8. package/scripts/check-bundle-size.mjs +38 -0
  9. package/scripts/test-runner.mjs +11 -1
  10. package/skills/distill-software/SKILL.md +24 -1
  11. package/dist/index.mjs.map +0 -7
  12. package/docs/FEATURE_INTAKE.md +0 -126
  13. package/docs/HARNESS.md +0 -87
  14. package/docs/HARNESS_BACKLOG.md +0 -89
  15. package/docs/PROJECT_REVIEW.md +0 -270
  16. package/docs/PROJECT_REVIEW_FIXES.md +0 -342
  17. package/docs/PROJECT_REVIEW_ROUND4.md +0 -156
  18. package/docs/PROJECT_REVIEW_ROUND5.md +0 -86
  19. package/docs/REVIEW-FINDINGS-2026-06 +0 -357
  20. package/docs/REVIEW-FINDINGS-2026-07-CORE.md +0 -139
  21. package/docs/REVIEW-FINDINGS-2026-07.md +0 -125
  22. package/docs/TEST_MATRIX.md +0 -51
  23. package/docs/archive/README.md +0 -91
  24. package/docs/archive/followup-review-round3-2026-05-12.md +0 -342
  25. package/docs/archive/followup-review-round4-2026-05-13.md +0 -107
  26. package/docs/archive/pi-crew-bugs.md +0 -961
  27. package/docs/archive/pi-crew-test-final.md +0 -120
  28. package/docs/archive/pi-crew-test-results.md +0 -260
  29. package/docs/archive/pi-crew-test-round2.md +0 -136
  30. package/docs/archive/pi-crew-test-round4.md +0 -100
  31. package/docs/archive/pi-crew-test-round5.md +0 -70
  32. package/docs/archive/pi-crew-test-round6.md +0 -110
  33. package/docs/archive/pi-crew-v0.5.10-audit-fix-plan.md +0 -60
  34. package/docs/archive/pi-crew-v0.5.11-audit-fix-plan.md +0 -92
  35. package/docs/archive/pi-crew-v0.5.12-audit-fix-plan.md +0 -76
  36. package/docs/archive/pi-crew-v0.5.13-audit-fix-plan.md +0 -75
  37. package/docs/archive/pi-crew-v0.5.14-audit-fix-plan.md +0 -75
  38. package/docs/archive/pi-crew-v0.5.16-audit-fix-plan.md +0 -35
  39. package/docs/archive/pi-crew-v0.5.17-audit-fix-plan.md +0 -80
  40. package/docs/archive/pi-crew-v0.5.5-audit-fix-plan.md +0 -133
  41. package/docs/archive/pi-crew-v0.5.9-audit-fix-plan.md +0 -88
  42. package/docs/archive/pi-mono-opportunities.md +0 -969
  43. package/docs/archive/pi-mono-review.md +0 -291
  44. package/docs/archive/pi-subagent4-comparison.md +0 -261
  45. package/docs/archive/pi-subagents3-deep-analysis.md +0 -508
  46. package/docs/bugs/bug-021-notification-badge-counter-misleading.md +0 -293
  47. package/docs/bugs/bug-023-chain-windows-path-resolution.md +0 -106
  48. package/docs/bugs/bug-quota-display-truncation.md +0 -223
  49. package/docs/bugs/cross-session-notification-leakage.md +0 -82
  50. package/docs/code-review-2026-05-11.md +0 -592
  51. package/docs/coding-agent-optimization.md +0 -268
  52. package/docs/comparison-pi-subagents-vs-pi-crew.md +0 -303
  53. package/docs/decisions/0001-durable-state.md +0 -41
  54. package/docs/decisions/0002-child-process-for-async.md +0 -42
  55. package/docs/decisions/0003-depth-guard.md +0 -36
  56. package/docs/decisions/0004-execfile-over-exec.md +0 -34
  57. package/docs/decisions/0005-no-parameter-properties.md +0 -49
  58. package/docs/decisions/0006-publish-bundled-esm.md +0 -63
  59. package/docs/decisions/0007-active-run-binary-index.md +0 -54
  60. package/docs/decisions/0008-child-pi-warm-pool.md +0 -61
  61. package/docs/decisions/2026-07-21-broker-phase4-default-on.md +0 -77
  62. package/docs/decisions/2026-07-21-broker-windows-perms.md +0 -91
  63. package/docs/decisions/2026-07-22-broker-phase4-gated-on.md +0 -99
  64. package/docs/decisions/2026-07-24-oidc-trusted-publishing.md +0 -112
  65. package/docs/decisions/README.md +0 -26
  66. package/docs/deep-review-report.md +0 -384
  67. package/docs/distillation/cybersecurity-patterns.md +0 -294
  68. package/docs/feature-analysis-subagent4.md +0 -305
  69. package/docs/fix-plan-disabletools-exit-null.md +0 -219
  70. package/docs/fixes/BATCH_A_H1_H2.md +0 -86
  71. package/docs/fixes/bug-006-foreground-cancel-concurrent.md +0 -78
  72. package/docs/fixes/bug-007-async-notifier-stale-ctx.md +0 -112
  73. package/docs/fixes/bug-008-child-process-silent-timeout.md +0 -100
  74. package/docs/fixes/bug-009-executor-yield-limit-needs-attention.md +0 -75
  75. package/docs/fixes/bug-010-child-process-api-key-filtered.md +0 -109
  76. package/docs/fixes/bug-011-spawn-pi-enoent.md +0 -92
  77. package/docs/fixes/bug-012-essential-env-stripped.md +0 -89
  78. package/docs/fixes/bug-013-background-runner-death.md +0 -84
  79. package/docs/fixes/bug-014-infinite-retry-loop-needs-attention.md +0 -82
  80. package/docs/fixes/bug-015-background-runner-sigterm.md +0 -65
  81. package/docs/fixes/bug-017-background-runner-session-shutdown.md +0 -66
  82. package/docs/fixes/bug-017-background-runner-sigkill-double-fork.md +0 -28
  83. package/docs/fixes/bug-018-child-pi-worker-stdin-hang.md +0 -61
  84. package/docs/fixes/bug-019-phantom-runs-temp-workspace.md +0 -52
  85. package/docs/fixes/bug-020-infinite-retry-loop-needs-attention.md +0 -47
  86. package/docs/fixes/v0.9.10/locks-fix-verify.md +0 -3
  87. package/docs/fixes/v0.9.10/smoke-test.md +0 -12
  88. package/docs/followup-plan-2026-05-12.md +0 -463
  89. package/docs/followup-review-2026-05-12.md +0 -297
  90. package/docs/goals.md +0 -59
  91. package/docs/implementation-plan-top3.md +0 -333
  92. package/docs/issue-29-analysis.md +0 -189
  93. package/docs/live-mailbox-runtime.md +0 -36
  94. package/docs/migration/atomic-write-v2-migration.md +0 -299
  95. package/docs/next-upgrade-roadmap.md +0 -808
  96. package/docs/oh-my-pi-research.md +0 -509
  97. package/docs/optimization-plan-2026-07.md +0 -366
  98. package/docs/optimization-plan.md +0 -644
  99. package/docs/patterns/command-agent-skill.md +0 -71
  100. package/docs/perf/baseline-2026-05.md +0 -113
  101. package/docs/perf/final-report-2026-05.md +0 -206
  102. package/docs/perf/optimization-plan-2026-07-verified.md +0 -396
  103. package/docs/perf/performance-audit-report-2026-07.md +0 -948
  104. package/docs/perf/performance-review-2026-07.md +0 -287
  105. package/docs/perf/sprint-1-report.md +0 -71
  106. package/docs/perf/sprint-2-report.md +0 -81
  107. package/docs/perf/sprint-2.5-report.md +0 -53
  108. package/docs/perf/sprint-3-report.md +0 -36
  109. package/docs/perf/sprint-4-report.md +0 -47
  110. package/docs/perf/sprint-5-report.md +0 -51
  111. package/docs/perf/sprint-6-report.md +0 -94
  112. package/docs/perf/sprint-7-report.md +0 -74
  113. package/docs/perf/upgrade-plan-2026-05.md +0 -147
  114. package/docs/performance-optimization-execution-plan.md +0 -520
  115. package/docs/phase4-triage.md +0 -58
  116. package/docs/pi-crew-investigation-report.md +0 -411
  117. package/docs/product/README.md +0 -31
  118. package/docs/product/platform.md +0 -27
  119. package/docs/product/runtime-safety.md +0 -37
  120. package/docs/product/team-run.md +0 -39
  121. package/docs/product/team-tool.md +0 -37
  122. package/docs/runtime-analysis-child-vs-live.md +0 -171
  123. package/docs/runtime-migration-in-process-analysis.md +0 -250
  124. package/docs/skills/REFERENCE.md +0 -138
  125. package/docs/stories/README.md +0 -32
  126. package/docs/stories/US-DEPS-major-upgrade.md +0 -62
  127. package/docs/stories/backlog.md +0 -36
  128. package/docs/superpowers/plans/2026-06-09-fallow-patterns-adoption.md +0 -1270
  129. package/docs/templates/decision.md +0 -27
  130. package/docs/templates/story.md +0 -44
  131. package/docs/templates/validation-report.md +0 -32
  132. package/docs/ui-optimization-plan.md +0 -447
  133. package/src/adapters/claude-adapter.ts +0 -23
  134. package/src/adapters/codex-adapter.ts +0 -21
  135. package/src/adapters/cursor-adapter.ts +0 -17
  136. package/src/adapters/export-util.ts +0 -143
  137. package/src/adapters/index.ts +0 -15
  138. package/src/adapters/registry.ts +0 -18
  139. package/src/adapters/types.ts +0 -23
  140. package/src/agents/agent-config.ts +0 -194
  141. package/src/agents/agent-search.ts +0 -98
  142. package/src/agents/agent-serializer.ts +0 -38
  143. package/src/agents/discover-agents.ts +0 -623
  144. package/src/benchmark/benchmark-runner.ts +0 -313
  145. package/src/benchmark/feedback-loop.ts +0 -73
  146. package/src/config/config.ts +0 -1269
  147. package/src/config/defaults.ts +0 -193
  148. package/src/config/drift-detector.ts +0 -290
  149. package/src/config/markers.ts +0 -330
  150. package/src/config/resilient-parser.ts +0 -117
  151. package/src/config/role-tools.ts +0 -118
  152. package/src/config/suggestions.ts +0 -75
  153. package/src/config/types.ts +0 -278
  154. package/src/errors.ts +0 -194
  155. package/src/extension/action-suggestions.ts +0 -117
  156. package/src/extension/async-notifier.ts +0 -179
  157. package/src/extension/autonomous-policy.ts +0 -209
  158. package/src/extension/command-completions.ts +0 -120
  159. package/src/extension/context-status-injection.ts +0 -185
  160. package/src/extension/crew-autocomplete.ts +0 -131
  161. package/src/extension/crew-cleanup.ts +0 -168
  162. package/src/extension/crew-input-router.ts +0 -93
  163. package/src/extension/crew-shortcuts.ts +0 -87
  164. package/src/extension/crew-vibes/cat-frames.ts +0 -18
  165. package/src/extension/crew-vibes/config.ts +0 -195
  166. package/src/extension/crew-vibes/figures.ts +0 -101
  167. package/src/extension/crew-vibes/font-detect.ts +0 -71
  168. package/src/extension/crew-vibes/footer.ts +0 -292
  169. package/src/extension/crew-vibes/index.ts +0 -432
  170. package/src/extension/crew-vibes/provider-usage.ts +0 -396
  171. package/src/extension/crew-vibes/render.ts +0 -206
  172. package/src/extension/crew-vibes/speed.ts +0 -286
  173. package/src/extension/cross-extension-rpc.ts +0 -350
  174. package/src/extension/help.ts +0 -62
  175. package/src/extension/import-index.ts +0 -74
  176. package/src/extension/knowledge-injection.ts +0 -402
  177. package/src/extension/management.ts +0 -571
  178. package/src/extension/message-renderers.ts +0 -108
  179. package/src/extension/notification-router.ts +0 -152
  180. package/src/extension/notification-sink.ts +0 -54
  181. package/src/extension/pi-api.ts +0 -56
  182. package/src/extension/plan-orchestrate.ts +0 -302
  183. package/src/extension/project-init.ts +0 -170
  184. package/src/extension/register.ts +0 -113
  185. package/src/extension/registration/artifact-cleanup.ts +0 -20
  186. package/src/extension/registration/command-registration.ts +0 -58
  187. package/src/extension/registration/command-utils.ts +0 -58
  188. package/src/extension/registration/commands.ts +0 -1228
  189. package/src/extension/registration/compaction-guard.ts +0 -333
  190. package/src/extension/registration/context-builder.ts +0 -135
  191. package/src/extension/registration/crash-recovery-cache.ts +0 -54
  192. package/src/extension/registration/foreground-run-controller.ts +0 -238
  193. package/src/extension/registration/hook-registration.ts +0 -119
  194. package/src/extension/registration/lazy-configurers.ts +0 -124
  195. package/src/extension/registration/lifecycle-handlers.ts +0 -923
  196. package/src/extension/registration/lifecycle.ts +0 -259
  197. package/src/extension/registration/observability.ts +0 -322
  198. package/src/extension/registration/registration-types.ts +0 -158
  199. package/src/extension/registration/runtime-cleanup.ts +0 -230
  200. package/src/extension/registration/subagent-helpers.ts +0 -125
  201. package/src/extension/registration/subagent-manager-setup.ts +0 -330
  202. package/src/extension/registration/subagent-tools.ts +0 -456
  203. package/src/extension/registration/team-tool.ts +0 -220
  204. package/src/extension/registration/tool-registration.ts +0 -50
  205. package/src/extension/registration/ui.ts +0 -172
  206. package/src/extension/registration/viewers.ts +0 -121
  207. package/src/extension/registration/wire-cross-extension.ts +0 -37
  208. package/src/extension/result-watcher.ts +0 -139
  209. package/src/extension/rpc-hmac.ts +0 -256
  210. package/src/extension/run-bundle-schema.ts +0 -104
  211. package/src/extension/run-export.ts +0 -97
  212. package/src/extension/run-import.ts +0 -168
  213. package/src/extension/run-index.ts +0 -131
  214. package/src/extension/run-maintenance.ts +0 -190
  215. package/src/extension/session-summary.ts +0 -18
  216. package/src/extension/team-manager-command.ts +0 -153
  217. package/src/extension/team-onboard.ts +0 -177
  218. package/src/extension/team-recommendation.ts +0 -288
  219. package/src/extension/team-tool/anchor.ts +0 -172
  220. package/src/extension/team-tool/api.ts +0 -1244
  221. package/src/extension/team-tool/auto-summarize.ts +0 -142
  222. package/src/extension/team-tool/cache-control.ts +0 -19
  223. package/src/extension/team-tool/cancel.ts +0 -337
  224. package/src/extension/team-tool/chain-dispatch.ts +0 -95
  225. package/src/extension/team-tool/chain-executor.ts +0 -379
  226. package/src/extension/team-tool/config-patch.ts +0 -50
  227. package/src/extension/team-tool/context.ts +0 -149
  228. package/src/extension/team-tool/destructive-gate.ts +0 -52
  229. package/src/extension/team-tool/doctor.ts +0 -431
  230. package/src/extension/team-tool/explain.ts +0 -282
  231. package/src/extension/team-tool/failure-patterns.ts +0 -118
  232. package/src/extension/team-tool/goal-wrap.ts +0 -330
  233. package/src/extension/team-tool/goal.ts +0 -556
  234. package/src/extension/team-tool/handle-schedule.ts +0 -332
  235. package/src/extension/team-tool/handle-settings.ts +0 -520
  236. package/src/extension/team-tool/health-monitor.ts +0 -481
  237. package/src/extension/team-tool/inspect.ts +0 -88
  238. package/src/extension/team-tool/intent-policy.ts +0 -45
  239. package/src/extension/team-tool/lifecycle-actions.ts +0 -615
  240. package/src/extension/team-tool/orchestrate.ts +0 -98
  241. package/src/extension/team-tool/parallel-dispatch.ts +0 -183
  242. package/src/extension/team-tool/plan.ts +0 -50
  243. package/src/extension/team-tool/respond.ts +0 -150
  244. package/src/extension/team-tool/run-not-found.ts +0 -49
  245. package/src/extension/team-tool/run.ts +0 -1035
  246. package/src/extension/team-tool/status.ts +0 -260
  247. package/src/extension/team-tool/workflow-manage.ts +0 -261
  248. package/src/extension/team-tool-types.ts +0 -26
  249. package/src/extension/team-tool.ts +0 -1116
  250. package/src/extension/tool-result.ts +0 -16
  251. package/src/extension/validate-resources.ts +0 -108
  252. package/src/hooks/registry.ts +0 -200
  253. package/src/hooks/types.ts +0 -69
  254. package/src/i18n.ts +0 -212
  255. package/src/observability/correlation.ts +0 -50
  256. package/src/observability/event-bus.ts +0 -86
  257. package/src/observability/event-to-metric.ts +0 -170
  258. package/src/observability/exporters/adapter.ts +0 -27
  259. package/src/observability/exporters/otlp-exporter.ts +0 -356
  260. package/src/observability/exporters/prometheus-exporter.ts +0 -54
  261. package/src/observability/metric-registry.ts +0 -100
  262. package/src/observability/metric-retention.ts +0 -64
  263. package/src/observability/metric-sink.ts +0 -99
  264. package/src/observability/metrics-primitives.ts +0 -219
  265. package/src/plugins/plugin-define.ts +0 -6
  266. package/src/plugins/plugin-registry.ts +0 -32
  267. package/src/plugins/plugins/index.ts +0 -3
  268. package/src/plugins/plugins/nextjs.ts +0 -19
  269. package/src/plugins/plugins/vite.ts +0 -10
  270. package/src/plugins/plugins/vitest.ts +0 -9
  271. package/src/prompt/prompt-runtime.ts +0 -380
  272. package/src/runtime/adaptive-plan.ts +0 -563
  273. package/src/runtime/agent-control.ts +0 -215
  274. package/src/runtime/agent-memory.ts +0 -81
  275. package/src/runtime/agent-observability.ts +0 -122
  276. package/src/runtime/anchor-manager.ts +0 -475
  277. package/src/runtime/async-marker.ts +0 -32
  278. package/src/runtime/async-runner.ts +0 -381
  279. package/src/runtime/attention-events.ts +0 -28
  280. package/src/runtime/auto-summarize.ts +0 -344
  281. package/src/runtime/background-runner.ts +0 -837
  282. package/src/runtime/batch-barrier.ts +0 -147
  283. package/src/runtime/broker-issuer.ts +0 -37
  284. package/src/runtime/cancellation-token.ts +0 -99
  285. package/src/runtime/cancellation.ts +0 -99
  286. package/src/runtime/capability-inventory.ts +0 -137
  287. package/src/runtime/chain-parser.ts +0 -237
  288. package/src/runtime/chain-runner.ts +0 -606
  289. package/src/runtime/checkpoint.ts +0 -291
  290. package/src/runtime/child-pi-constants.ts +0 -42
  291. package/src/runtime/child-pi-kill.ts +0 -180
  292. package/src/runtime/child-pi-pool.ts +0 -68
  293. package/src/runtime/child-pi-spawn.ts +0 -287
  294. package/src/runtime/child-pi-steering.ts +0 -128
  295. package/src/runtime/child-pi-streams.ts +0 -296
  296. package/src/runtime/child-pi-transcript.ts +0 -169
  297. package/src/runtime/child-pi.ts +0 -1105
  298. package/src/runtime/coalesce-tasks.ts +0 -268
  299. package/src/runtime/code-summary.ts +0 -292
  300. package/src/runtime/command-trace.ts +0 -105
  301. package/src/runtime/compact-pipeline.ts +0 -56
  302. package/src/runtime/compact-stages/ansi-strip-stage.ts +0 -25
  303. package/src/runtime/compact-stages/blank-collapse-stage.ts +0 -31
  304. package/src/runtime/compact-stages/deduplicate-stage.ts +0 -34
  305. package/src/runtime/compact-stages/head-snap-stage.ts +0 -57
  306. package/src/runtime/compact-stages/index.ts +0 -23
  307. package/src/runtime/compact-stages/tail-capture-stage.ts +0 -77
  308. package/src/runtime/compact-stages/truncation-stage.ts +0 -74
  309. package/src/runtime/compaction-summary.ts +0 -278
  310. package/src/runtime/completion-guard.ts +0 -207
  311. package/src/runtime/concurrency.ts +0 -58
  312. package/src/runtime/crash-classification.ts +0 -229
  313. package/src/runtime/crash-recovery.ts +0 -577
  314. package/src/runtime/crew-agent-records.ts +0 -593
  315. package/src/runtime/crew-agent-runtime.ts +0 -62
  316. package/src/runtime/crew-broker-child.ts +0 -88
  317. package/src/runtime/crew-broker-client.ts +0 -673
  318. package/src/runtime/crew-broker-tokens.ts +0 -84
  319. package/src/runtime/crew-broker.ts +0 -1276
  320. package/src/runtime/crew-hooks.ts +0 -227
  321. package/src/runtime/cross-extension-rpc.ts +0 -143
  322. package/src/runtime/custom-tools/irc-tool.ts +0 -282
  323. package/src/runtime/custom-tools/submit-result-tool.ts +0 -102
  324. package/src/runtime/deadletter.ts +0 -47
  325. package/src/runtime/delivery-coordinator.ts +0 -211
  326. package/src/runtime/delta-conflict.ts +0 -348
  327. package/src/runtime/deterministic-ast.ts +0 -161
  328. package/src/runtime/diagnostic-export.ts +0 -171
  329. package/src/runtime/direct-run.ts +0 -45
  330. package/src/runtime/dwf-state-store.ts +0 -102
  331. package/src/runtime/dynamic-workflow-context.ts +0 -1016
  332. package/src/runtime/dynamic-workflow-runner.ts +0 -310
  333. package/src/runtime/effectiveness.ts +0 -90
  334. package/src/runtime/errors/crew-errors.ts +0 -162
  335. package/src/runtime/event-stream-bridge.ts +0 -98
  336. package/src/runtime/foreground-control.ts +0 -193
  337. package/src/runtime/foreground-watchdog.ts +0 -132
  338. package/src/runtime/global-worker-cap.ts +0 -96
  339. package/src/runtime/goal-achievement.ts +0 -148
  340. package/src/runtime/goal-evaluator.ts +0 -361
  341. package/src/runtime/goal-loop-runner.ts +0 -828
  342. package/src/runtime/goal-state-store.ts +0 -219
  343. package/src/runtime/green-contract.ts +0 -55
  344. package/src/runtime/group-join.ts +0 -267
  345. package/src/runtime/handoff-manager.ts +0 -598
  346. package/src/runtime/heartbeat-gradient.ts +0 -36
  347. package/src/runtime/heartbeat-watcher.ts +0 -239
  348. package/src/runtime/hidden-handoff.ts +0 -407
  349. package/src/runtime/important-line-classifier.ts +0 -140
  350. package/src/runtime/intercom-bridge.ts +0 -187
  351. package/src/runtime/iteration-hooks.ts +0 -305
  352. package/src/runtime/live-agent-control.ts +0 -136
  353. package/src/runtime/live-agent-manager.ts +0 -704
  354. package/src/runtime/live-control-realtime.ts +0 -56
  355. package/src/runtime/live-extension-bridge.ts +0 -148
  356. package/src/runtime/live-irc.ts +0 -97
  357. package/src/runtime/live-session-health.ts +0 -108
  358. package/src/runtime/live-session-runtime.ts +0 -1139
  359. package/src/runtime/loop-gates.ts +0 -128
  360. package/src/runtime/manifest-cache.ts +0 -375
  361. package/src/runtime/mcp-proxy.ts +0 -105
  362. package/src/runtime/metric-parser.ts +0 -36
  363. package/src/runtime/model-fallback.ts +0 -409
  364. package/src/runtime/model-resolver.ts +0 -126
  365. package/src/runtime/model-scope.ts +0 -158
  366. package/src/runtime/orphan-worker-registry.ts +0 -465
  367. package/src/runtime/output-validator.ts +0 -202
  368. package/src/runtime/overflow-recovery.ts +0 -206
  369. package/src/runtime/parallel-research.ts +0 -68
  370. package/src/runtime/parallel-utils.ts +0 -160
  371. package/src/runtime/parent-guard.ts +0 -134
  372. package/src/runtime/path-overlap.ts +0 -150
  373. package/src/runtime/peer-dep.ts +0 -292
  374. package/src/runtime/per-write-validator.ts +0 -181
  375. package/src/runtime/phase-progress.ts +0 -217
  376. package/src/runtime/phase-tracker.ts +0 -385
  377. package/src/runtime/pi-args.ts +0 -655
  378. package/src/runtime/pi-json-output.ts +0 -170
  379. package/src/runtime/pi-spawn.ts +0 -273
  380. package/src/runtime/pipeline-runner.ts +0 -523
  381. package/src/runtime/plan-templates.ts +0 -201
  382. package/src/runtime/policy-engine.ts +0 -115
  383. package/src/runtime/post-checks.ts +0 -142
  384. package/src/runtime/post-exit-stdio-guard.ts +0 -104
  385. package/src/runtime/process-lifecycle.ts +0 -491
  386. package/src/runtime/process-status.ts +0 -154
  387. package/src/runtime/progress-event-coalescer.ts +0 -44
  388. package/src/runtime/progress-tracker.ts +0 -124
  389. package/src/runtime/prose-compressor.ts +0 -162
  390. package/src/runtime/recovery-recipes.ts +0 -203
  391. package/src/runtime/replace.ts +0 -570
  392. package/src/runtime/resilient-edit.ts +0 -153
  393. package/src/runtime/result-extractor.ts +0 -213
  394. package/src/runtime/retry-executor.ts +0 -100
  395. package/src/runtime/retry-runner.ts +0 -336
  396. package/src/runtime/role-permission.ts +0 -59
  397. package/src/runtime/run-coalesced-task-group.ts +0 -308
  398. package/src/runtime/run-drift.ts +0 -219
  399. package/src/runtime/run-tracker.ts +0 -116
  400. package/src/runtime/runtime-policy.ts +0 -29
  401. package/src/runtime/runtime-resolver.ts +0 -172
  402. package/src/runtime/runtime-warmup.ts +0 -160
  403. package/src/runtime/scheduler.ts +0 -353
  404. package/src/runtime/semaphore.ts +0 -141
  405. package/src/runtime/sensitive-paths.ts +0 -93
  406. package/src/runtime/session-resources.ts +0 -25
  407. package/src/runtime/session-snapshot.ts +0 -59
  408. package/src/runtime/session-usage.ts +0 -79
  409. package/src/runtime/settings-store.ts +0 -155
  410. package/src/runtime/sidechain-output.ts +0 -35
  411. package/src/runtime/single-agent-compose.ts +0 -84
  412. package/src/runtime/skill-effectiveness.ts +0 -524
  413. package/src/runtime/skill-instructions.ts +0 -391
  414. package/src/runtime/stale-reconciler.ts +0 -680
  415. package/src/runtime/stream-preview.ts +0 -184
  416. package/src/runtime/streaming-output.ts +0 -50
  417. package/src/runtime/subagent-manager.ts +0 -561
  418. package/src/runtime/subprocess-tool-registry.ts +0 -70
  419. package/src/runtime/supervisor-contact.ts +0 -64
  420. package/src/runtime/task-display.ts +0 -52
  421. package/src/runtime/task-graph-scheduler.ts +0 -227
  422. package/src/runtime/task-graph.ts +0 -290
  423. package/src/runtime/task-health.ts +0 -83
  424. package/src/runtime/task-id.ts +0 -161
  425. package/src/runtime/task-output-context.ts +0 -602
  426. package/src/runtime/task-packet.ts +0 -268
  427. package/src/runtime/task-quality.ts +0 -199
  428. package/src/runtime/task-runner/capabilities.ts +0 -78
  429. package/src/runtime/task-runner/context-retrieval.ts +0 -163
  430. package/src/runtime/task-runner/live-executor.ts +0 -227
  431. package/src/runtime/task-runner/output-splitter.ts +0 -152
  432. package/src/runtime/task-runner/progress.ts +0 -157
  433. package/src/runtime/task-runner/prompt-builder.ts +0 -278
  434. package/src/runtime/task-runner/prompt-pipeline.ts +0 -88
  435. package/src/runtime/task-runner/result-utils.ts +0 -16
  436. package/src/runtime/task-runner/retrieval-orchestrator.ts +0 -310
  437. package/src/runtime/task-runner/run-projection.ts +0 -125
  438. package/src/runtime/task-runner/state-helpers.ts +0 -176
  439. package/src/runtime/task-runner/tail-read.ts +0 -34
  440. package/src/runtime/task-runner.ts +0 -1420
  441. package/src/runtime/team-runner-artifacts.ts +0 -13
  442. package/src/runtime/team-runner.ts +0 -1993
  443. package/src/runtime/tool-output-pruner.ts +0 -333
  444. package/src/runtime/tool-progress.ts +0 -278
  445. package/src/runtime/usage-tracker.ts +0 -73
  446. package/src/runtime/verification-gates.ts +0 -571
  447. package/src/runtime/verification-integrity.ts +0 -105
  448. package/src/runtime/verification-worktree.ts +0 -186
  449. package/src/runtime/worker-heartbeat.ts +0 -25
  450. package/src/runtime/worker-startup.ts +0 -83
  451. package/src/runtime/workflow-state.ts +0 -195
  452. package/src/runtime/workspace-lock.ts +0 -443
  453. package/src/runtime/workspace-tree.ts +0 -312
  454. package/src/runtime/yield-handler.ts +0 -224
  455. package/src/runtime/zombie-scanner.ts +0 -298
  456. package/src/schema/config-schema.ts +0 -327
  457. package/src/schema/team-tool-schema.ts +0 -415
  458. package/src/schema/validation-types.ts +0 -159
  459. package/src/skills/discover-skills.ts +0 -197
  460. package/src/skills/skill-templates.ts +0 -456
  461. package/src/skills/validate.ts +0 -285
  462. package/src/state/active-run-registry.ts +0 -439
  463. package/src/state/artifact-store.ts +0 -176
  464. package/src/state/atomic-write.ts +0 -903
  465. package/src/state/blob-store.ts +0 -308
  466. package/src/state/contracts.ts +0 -158
  467. package/src/state/crew-init.ts +0 -269
  468. package/src/state/decision-ledger.ts +0 -345
  469. package/src/state/event-log-rotation.ts +0 -342
  470. package/src/state/event-log.ts +0 -1311
  471. package/src/state/event-reconstructor.ts +0 -229
  472. package/src/state/gitignore-manager.ts +0 -46
  473. package/src/state/health-store.ts +0 -79
  474. package/src/state/hook-instinct-bridge.ts +0 -94
  475. package/src/state/hook-integrations.ts +0 -51
  476. package/src/state/instinct-store.ts +0 -275
  477. package/src/state/jsonl-writer.ts +0 -107
  478. package/src/state/locks.ts +0 -562
  479. package/src/state/mailbox.ts +0 -916
  480. package/src/state/observation-store.ts +0 -176
  481. package/src/state/run-cache.ts +0 -193
  482. package/src/state/run-graph.ts +0 -183
  483. package/src/state/run-metrics.ts +0 -165
  484. package/src/state/schedule.ts +0 -166
  485. package/src/state/session-state-map.ts +0 -51
  486. package/src/state/state-store.ts +0 -958
  487. package/src/state/task-claims.ts +0 -61
  488. package/src/state/tiered-eval.ts +0 -480
  489. package/src/state/types-eval.ts +0 -58
  490. package/src/state/types.ts +0 -440
  491. package/src/state/usage.ts +0 -138
  492. package/src/state/worker-atomic-writer.ts +0 -194
  493. package/src/subagents/async-entry.ts +0 -1
  494. package/src/subagents/index.ts +0 -3
  495. package/src/subagents/live/control.ts +0 -1
  496. package/src/subagents/live/manager.ts +0 -1
  497. package/src/subagents/live/realtime.ts +0 -1
  498. package/src/subagents/live/session-runtime.ts +0 -1
  499. package/src/subagents/manager.ts +0 -1
  500. package/src/subagents/spawn.ts +0 -1
  501. package/src/teams/discover-teams.ts +0 -187
  502. package/src/teams/team-config.ts +0 -27
  503. package/src/teams/team-serializer.ts +0 -38
  504. package/src/tools/safe-bash-extension.ts +0 -54
  505. package/src/tools/safe-bash.ts +0 -505
  506. package/src/types/diff.d.ts +0 -18
  507. package/src/types/new-api-types.ts +0 -35
  508. package/src/ui/agent-management-overlay.ts +0 -160
  509. package/src/ui/card-colors.ts +0 -139
  510. package/src/ui/crew-footer.ts +0 -102
  511. package/src/ui/crew-select-list.ts +0 -111
  512. package/src/ui/dashboard-panes/agents-pane.ts +0 -164
  513. package/src/ui/dashboard-panes/cancellation-pane.ts +0 -66
  514. package/src/ui/dashboard-panes/capability-pane.ts +0 -77
  515. package/src/ui/dashboard-panes/health-pane.ts +0 -31
  516. package/src/ui/dashboard-panes/mailbox-pane.ts +0 -35
  517. package/src/ui/dashboard-panes/metrics-pane.ts +0 -37
  518. package/src/ui/dashboard-panes/progress-pane.ts +0 -38
  519. package/src/ui/dashboard-panes/transcript-pane.ts +0 -10
  520. package/src/ui/deploy-bundled-themes.ts +0 -71
  521. package/src/ui/dwf-phase-display.ts +0 -151
  522. package/src/ui/dynamic-border.ts +0 -35
  523. package/src/ui/heartbeat-aggregator.ts +0 -74
  524. package/src/ui/key-utils.ts +0 -42
  525. package/src/ui/keybinding-map.ts +0 -248
  526. package/src/ui/layout-primitives.ts +0 -106
  527. package/src/ui/live-conversation-overlay.ts +0 -183
  528. package/src/ui/live-duration.ts +0 -55
  529. package/src/ui/live-run-sidebar.ts +0 -301
  530. package/src/ui/loaders.ts +0 -176
  531. package/src/ui/mascot.ts +0 -436
  532. package/src/ui/overlays/agent-picker-overlay.ts +0 -65
  533. package/src/ui/overlays/confirm-overlay.ts +0 -60
  534. package/src/ui/overlays/help-overlay.ts +0 -177
  535. package/src/ui/overlays/mailbox-compose-overlay.ts +0 -181
  536. package/src/ui/overlays/mailbox-compose-preview.ts +0 -78
  537. package/src/ui/overlays/mailbox-detail-overlay.ts +0 -154
  538. package/src/ui/pi-ui-compat.ts +0 -68
  539. package/src/ui/powerbar-publisher.ts +0 -459
  540. package/src/ui/render-coalescer.ts +0 -101
  541. package/src/ui/render-diff.ts +0 -160
  542. package/src/ui/render-scheduler.ts +0 -224
  543. package/src/ui/run-action-dispatcher.ts +0 -182
  544. package/src/ui/run-dashboard.ts +0 -913
  545. package/src/ui/run-event-bus.ts +0 -381
  546. package/src/ui/run-snapshot-cache.ts +0 -1057
  547. package/src/ui/settings-overlay.ts +0 -1067
  548. package/src/ui/snapshot-types.ts +0 -90
  549. package/src/ui/spinner.ts +0 -17
  550. package/src/ui/status-colors.ts +0 -143
  551. package/src/ui/syntax-highlight.ts +0 -136
  552. package/src/ui/terminal-status.ts +0 -269
  553. package/src/ui/theme-adapter.ts +0 -271
  554. package/src/ui/theme-discovery.ts +0 -199
  555. package/src/ui/tool-progress-formatter.ts +0 -93
  556. package/src/ui/tool-render.ts +0 -453
  557. package/src/ui/tool-renderers/brief-mode.ts +0 -225
  558. package/src/ui/tool-renderers/index.ts +0 -726
  559. package/src/ui/transcript-cache.ts +0 -128
  560. package/src/ui/transcript-entries.ts +0 -256
  561. package/src/ui/transcript-viewer.ts +0 -424
  562. package/src/ui/widget/index.ts +0 -357
  563. package/src/ui/widget/widget-formatters.ts +0 -182
  564. package/src/ui/widget/widget-model.ts +0 -110
  565. package/src/ui/widget/widget-renderer.ts +0 -182
  566. package/src/ui/widget/widget-types.ts +0 -36
  567. package/src/utils/bm25-search.ts +0 -235
  568. package/src/utils/completion-dedupe.ts +0 -63
  569. package/src/utils/conflict-detect.ts +0 -668
  570. package/src/utils/env-allowlist.ts +0 -30
  571. package/src/utils/env-filter.ts +0 -155
  572. package/src/utils/file-coalescer.ts +0 -98
  573. package/src/utils/fingerprint.ts +0 -180
  574. package/src/utils/frontmatter.ts +0 -70
  575. package/src/utils/fs-watch.ts +0 -37
  576. package/src/utils/gh-protocol.ts +0 -556
  577. package/src/utils/git.ts +0 -260
  578. package/src/utils/guards.ts +0 -107
  579. package/src/utils/ids.ts +0 -24
  580. package/src/utils/incremental-reader.ts +0 -220
  581. package/src/utils/internal-error.ts +0 -10
  582. package/src/utils/names.ts +0 -36
  583. package/src/utils/ndjson.ts +0 -115
  584. package/src/utils/paths.ts +0 -227
  585. package/src/utils/project-detector.ts +0 -160
  586. package/src/utils/redaction.ts +0 -347
  587. package/src/utils/resolve-shell.ts +0 -36
  588. package/src/utils/run-watcher-registry.ts +0 -152
  589. package/src/utils/safe-paths.ts +0 -383
  590. package/src/utils/scan-cache.ts +0 -144
  591. package/src/utils/session-utils.ts +0 -110
  592. package/src/utils/sleep.ts +0 -54
  593. package/src/utils/socket-path.ts +0 -127
  594. package/src/utils/sse-parser.ts +0 -129
  595. package/src/utils/task-name-generator.ts +0 -337
  596. package/src/utils/timings.ts +0 -33
  597. package/src/utils/token-counter.ts +0 -200
  598. package/src/utils/visual.ts +0 -207
  599. package/src/workflows/cost-estimator.ts +0 -34
  600. package/src/workflows/discover-workflows.ts +0 -290
  601. package/src/workflows/intermediate-store.ts +0 -166
  602. package/src/workflows/preflight-validator.ts +0 -168
  603. package/src/workflows/topology-analyzer.ts +0 -203
  604. package/src/workflows/validate-workflow.ts +0 -50
  605. package/src/workflows/workflow-config.ts +0 -70
  606. package/src/workflows/workflow-serializer.ts +0 -32
  607. package/src/worktree/branch-freshness.ts +0 -112
  608. package/src/worktree/cleanup.ts +0 -341
  609. package/src/worktree/worktree-manager.ts +0 -1200
@@ -1,443 +0,0 @@
1
- /**
2
- * workspace-lock.ts — Per-cwd workspace lock with startTime-safe liveness (P1g).
3
- *
4
- * RFC: research-findings/goal-workflow/13-VISION-RFC.md v0.5 §P1g + D10.
5
- *
6
- * Closes #8 (multi-goal clobber) and the B-2 PID-recycling gap. Each
7
- * `workspaceMode:"single"` goal acquires this lock for its entire lifetime,
8
- * serializing concurrent goals that share a cwd.
9
- *
10
- * Lockfile location: `<crewRoot>/state/workspace-locks/<sha256(absCwd)>.lock`
11
- * Lockfile contents: { pid, startTime, heartbeat, goalId, acquiredAt }
12
- *
13
- * ─── LIVENESS = stale-reconciler startTime pattern (D10, B-2 fix) ───
14
- * A lock is STALE iff EITHER:
15
- * (a) the recorded pid's CURRENT startTime ≠ the lockfile startTime
16
- * (the PID was recycled to a different process), OR
17
- * (b) the heartbeat is older than HEARTBEAT_STALE_MS (default 60s)
18
- * (the process crashed without exiting / heartbeat stopped).
19
- *
20
- * Why NOT child-pi.ts killProcessPid (B-2): killProcessPid uses
21
- * process.kill(pid, 0) which is PID-only — vulnerable to PID recycling. The
22
- * startTime + before/after re-verify pattern is TOCTOU-correct.
23
- *
24
- * getProcessStartTime is NOT exported from stale-reconciler.ts, so its logic
25
- * is REPLICATED here (RFC §P1g explicitly permits importing OR replicating).
26
- * The replication matches stale-reconciler.ts:112 field-for-field.
27
- *
28
- * Granularity: per-goal, held for the goal's lifetime (release() on goal end).
29
- * Contention: default QUEUE (poll until released or stale);
30
- * opts.failOnWorkspaceBusy:true → THROW instead of queue.
31
- */
32
-
33
- import { createHash } from "node:crypto";
34
- import { closeSync, existsSync, mkdirSync, openSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
35
- import * as path from "node:path";
36
- import { atomicWriteJson } from "../state/atomic-write.ts";
37
- import { projectCrewRoot, userCrewRoot } from "../utils/paths.ts";
38
-
39
- /** Heartbeat staleness threshold (ms). Default 60s per RFC §P1g. */
40
- const DEFAULT_HEARTBEAT_STALE_MS = 60_000;
41
-
42
- /** Polling interval while queued waiting for a held lock (ms). */
43
- const DEFAULT_LOCK_POLL_MS = 500;
44
-
45
- /**
46
- * Resolve a pid's process start time in ms, reusing the stale-reconciler
47
- * pattern (src/runtime/stale-reconciler.ts:112). Returns undefined if the
48
- * process is gone or /proc is unavailable (non-Linux). The absolute value
49
- * matters less than its uniqueness per PID lifecycle. Used to detect PID
50
- * recycling: a recycled PID has a different startTime than the recorded one.
51
- *
52
- * Callers (esp. tests) may inject a custom resolver to simulate PID recycling
53
- * deterministically without spawning real processes.
54
- */
55
- export type StartTimeResolver = (pid: number) => number | undefined;
56
-
57
- export const defaultStartTimeResolver: StartTimeResolver = (pid: number): number | undefined => {
58
- try {
59
- const stat = readFileSync(`/proc/${pid}/stat`, "utf-8");
60
- const lastParen = stat.lastIndexOf(")");
61
- if (lastParen === -1) return undefined;
62
- const fieldsAfterComm = stat
63
- .slice(lastParen + 1)
64
- .trim()
65
- .split(/\s+/);
66
- // starttime is at index 19 (the 20th field after comm) of /proc/<pid>/stat.
67
- const startTimeClockTicks = Number(fieldsAfterComm[19]);
68
- if (!Number.isFinite(startTimeClockTicks)) return undefined;
69
- // Convert clock ticks to ms (~CLK_TCK). Absolute uniqueness is what matters.
70
- return Math.floor(startTimeClockTicks * 10);
71
- } catch {
72
- return undefined;
73
- }
74
- };
75
-
76
- /** Lockfile contents (persisted as JSON). */
77
- export interface WorkspaceLockContents {
78
- pid: number;
79
- startTime: number | undefined;
80
- heartbeat: number;
81
- goalId: string;
82
- acquiredAt: string;
83
- }
84
-
85
- /**
86
- * Opaque handle returned by acquireWorkspaceLock. Call release() to free the
87
- * lock when the goal ends. release() is a no-op if the lock was already
88
- * reclaimed/re-acquired by another goal (guarded by goalId + pid + startTime).
89
- */
90
- export interface WorkspaceLockHandle {
91
- readonly cwd: string;
92
- readonly goalId: string;
93
- readonly lockPath: string;
94
- /** The startTime value written to the lockfile at acquire (release guard). */
95
- readonly startTime: number | undefined;
96
- release(): void;
97
- }
98
-
99
- export interface AcquireWorkspaceLockOptions {
100
- /** Throw instead of queue when the workspace is already held (default: queue). */
101
- failOnWorkspaceBusy?: boolean;
102
- /** Override the heartbeat-staleness threshold (ms). */
103
- heartbeatStaleMs?: number;
104
- /** Override the polling interval while queued (ms). */
105
- pollMs?: number;
106
- /** Test injection: override process start time resolution. */
107
- startTimeResolver?: StartTimeResolver;
108
- /** Test injection: override current time (ms). Default Date.now(). */
109
- now?: () => number;
110
- /** Test injection: override the current pid. Default process.pid. */
111
- pid?: number;
112
- /** Abort waiting when this signal aborts. */
113
- signal?: AbortSignal;
114
- }
115
-
116
- /**
117
- * Resolve the lockfile path for a cwd. Lockfiles live under the project's
118
- * `.crew/state/workspace-locks/` (or user crew-root fallback) and are named by
119
- * the sha256 of the absolute cwd to avoid filesystem-unsafe characters and to
120
- * normalize symlink-equivalent paths.
121
- */
122
- export function workspaceLockPath(cwd: string): string {
123
- const absCwd = path.resolve(cwd);
124
- const crewRoot = projectCrewRoot(absCwd) ?? userCrewRoot();
125
- const locksDir = path.join(crewRoot, "state", "workspace-locks");
126
- const hash = createHash("sha256").update(absCwd).digest("hex");
127
- return path.join(locksDir, `${hash}.lock`);
128
- }
129
-
130
- /** Read + parse a lockfile. Returns undefined if missing/corrupt. */
131
- function readLock(lockPath: string): WorkspaceLockContents | undefined {
132
- if (!existsSync(lockPath)) return undefined;
133
- try {
134
- const parsed = JSON.parse(readFileSync(lockPath, "utf-8"));
135
- if (!parsed || typeof parsed !== "object") return undefined;
136
- return parsed as WorkspaceLockContents;
137
- } catch {
138
- return undefined;
139
- }
140
- }
141
-
142
- /**
143
- * Write the lockfile atomically (temp+rename+fsync via atomicWriteJson).
144
- * Used for HEARTBEAT refresh only (a claim that already owns the lock is refreshing its
145
- * timestamp — overwrite is correct because the owner verified ownership first).
146
- */
147
- function writeLock(lockPath: string, contents: WorkspaceLockContents): void {
148
- mkdirSync(path.dirname(lockPath), { recursive: true });
149
- atomicWriteJson(lockPath, contents);
150
- }
151
-
152
- /**
153
- * CLAIM the lockfile atomically via O_EXCL (cold-review #3 NIT #N1 fix).
154
- * The previous claim used temp+rename (writeLock), which is NOT cross-process atomic —
155
- * two goals that both observed a free lock in the same tick could both writeLock and
156
- * both believe they own it (the same class of TOCTOU cold-review #2 caught for CAS).
157
- * O_EXCL (openSync "wx") IS atomic at the OS level: only one process can create the
158
- * file. Returns true on success, false if the file already exists (EEXIST). Stale
159
- * lockfiles older than the threshold are force-deleted + retried once.
160
- */
161
- /**
162
- * CLAIM the lockfile atomically via O_EXCL (cold-review #3 NIT #N1 fix).
163
- * The previous claim used temp+rename (writeLock), which is NOT cross-process atomic —
164
- * two goals that both observed a free/stale lock in the same tick could both writeLock
165
- * and both believe they own it (the same class of TOCTOU cold-review #2 caught for CAS).
166
- * O_EXCL (openSync "wx") IS atomic at the OS level: only one process can create the file.
167
- *
168
- * `forceOverwrite`: when the caller has ALREADY verified (via isLockStale) that the existing
169
- * lock is logically stale (e.g. PID recycled — a stronger signal than mtime age), the caller
170
- * passes forceOverwrite:true and claimLock unlinks then claims, bypassing the mtime age check.
171
- * (Without this, a stale-by-PID-recycling lock whose mtime is recent would never be claimed,
172
- * because tryCreate sees EEXIST and the mtime age check fails — infinite re-queue = hang.)
173
- *
174
- * Returns true on success, false if the file already exists and is not stale.
175
- */
176
- function claimLock(lockPath: string, contents: WorkspaceLockContents, staleReclaimMs: number, forceOverwrite = false): boolean {
177
- mkdirSync(path.dirname(lockPath), { recursive: true });
178
- const json = JSON.stringify(contents);
179
- const tryCreate = (): boolean => {
180
- try {
181
- const fd = openSync(lockPath, "wx"); // O_EXCL — throws EEXIST if it exists.
182
- try {
183
- writeFileSync(fd, json);
184
- } finally {
185
- closeSync(fd);
186
- }
187
- return true;
188
- } catch (error) {
189
- const code = (error as NodeJS.ErrnoException).code;
190
- if (code !== "EEXIST") throw error;
191
- return false;
192
- }
193
- };
194
- if (forceOverwrite) {
195
- // Caller verified the existing lock is logically stale; remove it and claim. A concurrent
196
- // reclaimer might re-create between our unlink and our open — that's fine, we lose the race
197
- // and return false, falling through to the queue path.
198
- try {
199
- unlinkSync(lockPath);
200
- } catch {
201
- /* best-effort */
202
- }
203
- return tryCreate();
204
- }
205
- if (tryCreate()) return true;
206
- // Stale recovery by mtime age: if the lockfile is older than staleReclaimMs, force-delete + retry.
207
- try {
208
- const stat = statSync(lockPath);
209
- if (Date.now() - stat.mtimeMs > staleReclaimMs) {
210
- try {
211
- unlinkSync(lockPath);
212
- } catch {
213
- /* fall through */
214
- }
215
- return tryCreate();
216
- }
217
- } catch {
218
- /* fall through to false */
219
- }
220
- return false;
221
- }
222
-
223
- /**
224
- * Is the lock STALE? RFC §P1g + D10 dual-check:
225
- * (a) startTime mismatch → PID recycled to a different process, OR
226
- * (b) heartbeat older than heartbeatStaleMs → crash w/o exit / abandoned.
227
- *
228
- * On platforms where startTime is unavailable (non-Linux), only the heartbeat
229
- * check applies (weaker PID-reuse detection — documented platform limitation,
230
- * matching stale-reconciler.ts).
231
- */
232
- function isLockStale(
233
- lock: WorkspaceLockContents,
234
- resolveStartTime: StartTimeResolver,
235
- heartbeatStaleMs: number,
236
- now: number,
237
- ): { stale: boolean; reason?: string } {
238
- // (a) startTime mismatch → PID recycled to a different process.
239
- if (lock.startTime !== undefined) {
240
- const currentStartTime = resolveStartTime(lock.pid);
241
- if (currentStartTime !== undefined && currentStartTime !== lock.startTime) {
242
- return { stale: true, reason: "pid_recycled" };
243
- }
244
- // currentStartTime === undefined: process gone OR /proc unavailable →
245
- // fall through to the heartbeat check (corroborating evidence).
246
- }
247
- // (b) heartbeat older than threshold → crash without exit / abandoned.
248
- const heartbeatAge = now - lock.heartbeat;
249
- if (heartbeatAge > heartbeatStaleMs) {
250
- return { stale: true, reason: "heartbeat_stale" };
251
- }
252
- return { stale: false };
253
- }
254
-
255
- /**
256
- * Acquire the workspace lock for `goalId` at `cwd`. If the lock is held by a
257
- * live goal, the default behavior is QUEUE (poll until released or the holder
258
- * goes stale); with opts.failOnWorkspaceBusy:true, throws instead.
259
- *
260
- * Stale locks (PID recycled or heartbeat expired) are reclaimed transparently.
261
- *
262
- * The returned handle's release() deletes the lockfile ONLY if it still
263
- * belongs to this goal+pid+startTime — so a stale handle cannot clobber a
264
- * lock reclaimed and re-acquired by another goal after this goal went stale.
265
- *
266
- * In-process serialization: the read→stale-check→write sequence is
267
- * synchronous within one event-loop tick, so concurrent in-process acquires
268
- * cannot both observe a free lock and both write (no interleave between the
269
- * sync read and sync write).
270
- */
271
- export async function acquireWorkspaceLock(
272
- cwd: string,
273
- goalId: string,
274
- opts: AcquireWorkspaceLockOptions = {},
275
- ): Promise<WorkspaceLockHandle> {
276
- const lockPath = workspaceLockPath(cwd);
277
- const resolveStartTime = opts.startTimeResolver ?? defaultStartTimeResolver;
278
- const heartbeatStaleMs = opts.heartbeatStaleMs ?? DEFAULT_HEARTBEAT_STALE_MS;
279
- const pollMs = opts.pollMs ?? DEFAULT_LOCK_POLL_MS;
280
- const now = opts.now ?? Date.now;
281
- const pid = opts.pid ?? process.pid;
282
- const writtenStartTime = resolveStartTime(pid);
283
-
284
- while (true) {
285
- // Poll-loop: re-check the lock each tick until free/stale or aborted.
286
- if (opts.signal?.aborted) {
287
- throw new Error(`workspace lock acquisition aborted for goal ${goalId} (cwd=${cwd})`);
288
- }
289
- const existing = readLock(lockPath);
290
- // Classify the existing lock: "absent" / "stale" (PID recycled or heartbeat dead) / "live".
291
- // Cold-review #3 NIT #N1 fix: when stale, pass forceOverwrite:true to claimLock so it
292
- // unlinks the stale file before claiming. Without this, a stale-by-PID lock whose mtime
293
- // is recent would never pass claimLock's mtime age check (it would return false) and the
294
- // acquireWorkspaceLock poll loop would re-queue forever = hang.
295
- const existingKind: "absent" | "stale" | "live" = !existing
296
- ? "absent"
297
- : isLockStale(existing, resolveStartTime, heartbeatStaleMs, now()).stale
298
- ? "stale"
299
- : "live";
300
- if (existingKind !== "live") {
301
- // Claim the lock (covers both no-lock and stale-lock cases).
302
- // Cold-review #3 NIT #N1 fix: claim via O_EXCL (claimLock), NOT temp+rename — two
303
- // processes racing past the isLockStale check could both writeLock and both believe
304
- // they own the lock. claimLock atomically creates the file; if it returns false we
305
- // lost the race, so fall through to the queue/re-throw path below.
306
- const contents: WorkspaceLockContents = {
307
- pid,
308
- startTime: writtenStartTime,
309
- heartbeat: now(),
310
- goalId,
311
- acquiredAt: new Date(now()).toISOString(),
312
- };
313
- const claimed = claimLock(lockPath, contents, heartbeatStaleMs, existingKind === "stale");
314
- if (claimed) {
315
- return {
316
- cwd,
317
- goalId,
318
- lockPath,
319
- startTime: writtenStartTime,
320
- release(): void {
321
- safeRelease(lockPath, goalId, pid, writtenStartTime);
322
- },
323
- };
324
- }
325
- // claimLock lost the race (another process claimed between our stale-check and
326
- // our claim). Fall through to the busy path (throw or queue) — re-check next tick.
327
- }
328
- // Lock is held and live.
329
- if (opts.failOnWorkspaceBusy) {
330
- throw new Error(`workspace busy: cwd=${cwd} held by goalId=${existing!.goalId} (pid=${existing!.pid})`);
331
- }
332
- // Queue: wait for the next poll interval, then re-check.
333
- await sleepOrAbort(pollMs, opts.signal);
334
- }
335
- }
336
-
337
- /**
338
- * Delete the lockfile at `lockPath` only if it still belongs to
339
- * (goalId, pid, startTime). A stale handle (whose lock was reclaimed and
340
- * re-acquired by another goal) must NOT delete the new owner's lock.
341
- */
342
- function safeRelease(lockPath: string, goalId: string, pid: number, writtenStartTime: number | undefined): void {
343
- try {
344
- const current = readLock(lockPath);
345
- if (current && current.goalId === goalId && current.pid === pid && current.startTime === writtenStartTime) {
346
- unlinkSync(lockPath);
347
- }
348
- } catch {
349
- /* best-effort — release must never throw into a finally block */
350
- }
351
- }
352
-
353
- /** Sleep that resolves after `ms`, or rejects early if `signal` aborts. */
354
- function sleepOrAbort(ms: number, signal?: AbortSignal): Promise<void> {
355
- if (!signal) return new Promise<void>((r) => setTimeout(r, ms));
356
- return new Promise<void>((resolve, reject) => {
357
- const timer = setTimeout(resolve, ms);
358
- signal.addEventListener(
359
- "abort",
360
- () => {
361
- clearTimeout(timer);
362
- reject(new Error("workspace lock acquisition aborted"));
363
- },
364
- { once: true },
365
- );
366
- });
367
- }
368
-
369
- /**
370
- * Reclaim all stale locks under `dir` (the workspace-locks directory). Returns
371
- * the list of reclaimed lock paths. Stale = PID recycled OR heartbeat older
372
- * than threshold. Corrupt/unreadable locks are also reclaimed.
373
- *
374
- * Useful as a startup or periodic sweep to clear locks left by crashed
375
- * processes before any goal tries to acquire them.
376
- */
377
- /**
378
- * Peek whether the workspace is currently locked by a live owner (without acquiring).
379
- * Used by `goal start` / `goal resume` to fail-fast with a clear error BEFORE spawning.
380
- * Returns the goalId of the current owner if busy, undefined if free (or lock missing).
381
- */
382
- export function isWorkspaceBusy(
383
- cwd: string,
384
- opts: {
385
- startTimeResolver?: StartTimeResolver;
386
- heartbeatStaleMs?: number;
387
- now?: () => number;
388
- } = {},
389
- ): string | undefined {
390
- const lockPath = workspaceLockPath(cwd);
391
- const resolveStartTime = opts.startTimeResolver ?? defaultStartTimeResolver;
392
- const heartbeatStaleMs = opts.heartbeatStaleMs ?? DEFAULT_HEARTBEAT_STALE_MS;
393
- const now = opts.now ?? Date.now;
394
- const existing = readLock(lockPath);
395
- if (!existing) return undefined;
396
- const { stale } = isLockStale(existing, resolveStartTime, heartbeatStaleMs, now());
397
- return stale ? undefined : existing.goalId;
398
- }
399
-
400
- export function reclaimStaleLocks(
401
- dir: string,
402
- opts: {
403
- heartbeatStaleMs?: number;
404
- startTimeResolver?: StartTimeResolver;
405
- now?: () => number;
406
- } = {},
407
- ): string[] {
408
- const resolveStartTime = opts.startTimeResolver ?? defaultStartTimeResolver;
409
- const heartbeatStaleMs = opts.heartbeatStaleMs ?? DEFAULT_HEARTBEAT_STALE_MS;
410
- const now = opts.now ?? Date.now;
411
- const reclaimed: string[] = [];
412
- if (!existsSync(dir)) return reclaimed;
413
- let entries: string[];
414
- try {
415
- entries = readdirSync(dir);
416
- } catch {
417
- return reclaimed;
418
- }
419
- for (const entry of entries) {
420
- if (!entry.endsWith(".lock")) continue;
421
- const lockPath = path.join(dir, entry);
422
- const lock = readLock(lockPath);
423
- if (!lock) {
424
- // Corrupt/empty — reclaim.
425
- try {
426
- unlinkSync(lockPath);
427
- reclaimed.push(lockPath);
428
- } catch {
429
- /* best-effort */
430
- }
431
- continue;
432
- }
433
- if (isLockStale(lock, resolveStartTime, heartbeatStaleMs, now()).stale) {
434
- try {
435
- unlinkSync(lockPath);
436
- reclaimed.push(lockPath);
437
- } catch {
438
- /* best-effort */
439
- }
440
- }
441
- }
442
- return reclaimed;
443
- }