pi-crew 0.9.51 → 0.9.53

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 (611) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/README.md +216 -20
  3. package/dist/build-meta.json +2090 -1638
  4. package/dist/index.mjs +18057 -17119
  5. package/docs/actions-reference.md +431 -1
  6. package/index.ts +39 -10
  7. package/package.json +19 -9
  8. package/schema.json +41 -0
  9. package/scripts/check-bundle-size.mjs +38 -0
  10. package/scripts/test-runner.mjs +11 -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/2026-07-26-c6-mascot-visibility-not-wired.md +0 -84
  66. package/docs/decisions/README.md +0 -26
  67. package/docs/deep-review-report.md +0 -384
  68. package/docs/distillation/cybersecurity-patterns.md +0 -294
  69. package/docs/feature-analysis-subagent4.md +0 -305
  70. package/docs/fix-plan-disabletools-exit-null.md +0 -219
  71. package/docs/fixes/BATCH_A_H1_H2.md +0 -86
  72. package/docs/fixes/bug-006-foreground-cancel-concurrent.md +0 -78
  73. package/docs/fixes/bug-007-async-notifier-stale-ctx.md +0 -112
  74. package/docs/fixes/bug-008-child-process-silent-timeout.md +0 -100
  75. package/docs/fixes/bug-009-executor-yield-limit-needs-attention.md +0 -75
  76. package/docs/fixes/bug-010-child-process-api-key-filtered.md +0 -109
  77. package/docs/fixes/bug-011-spawn-pi-enoent.md +0 -92
  78. package/docs/fixes/bug-012-essential-env-stripped.md +0 -89
  79. package/docs/fixes/bug-013-background-runner-death.md +0 -84
  80. package/docs/fixes/bug-014-infinite-retry-loop-needs-attention.md +0 -82
  81. package/docs/fixes/bug-015-background-runner-sigterm.md +0 -65
  82. package/docs/fixes/bug-017-background-runner-session-shutdown.md +0 -66
  83. package/docs/fixes/bug-017-background-runner-sigkill-double-fork.md +0 -28
  84. package/docs/fixes/bug-018-child-pi-worker-stdin-hang.md +0 -61
  85. package/docs/fixes/bug-019-phantom-runs-temp-workspace.md +0 -52
  86. package/docs/fixes/bug-020-infinite-retry-loop-needs-attention.md +0 -47
  87. package/docs/fixes/v0.9.10/locks-fix-verify.md +0 -3
  88. package/docs/fixes/v0.9.10/smoke-test.md +0 -12
  89. package/docs/followup-plan-2026-05-12.md +0 -463
  90. package/docs/followup-review-2026-05-12.md +0 -297
  91. package/docs/goals.md +0 -59
  92. package/docs/implementation-plan-top3.md +0 -333
  93. package/docs/issue-29-analysis.md +0 -189
  94. package/docs/live-mailbox-runtime.md +0 -36
  95. package/docs/migration/atomic-write-v2-migration.md +0 -299
  96. package/docs/next-upgrade-roadmap.md +0 -808
  97. package/docs/oh-my-pi-research.md +0 -509
  98. package/docs/optimization-plan-2026-07.md +0 -366
  99. package/docs/optimization-plan.md +0 -644
  100. package/docs/patterns/command-agent-skill.md +0 -71
  101. package/docs/perf/baseline-2026-05.md +0 -113
  102. package/docs/perf/final-report-2026-05.md +0 -206
  103. package/docs/perf/optimization-plan-2026-07-verified.md +0 -396
  104. package/docs/perf/performance-audit-report-2026-07.md +0 -948
  105. package/docs/perf/performance-review-2026-07.md +0 -287
  106. package/docs/perf/sprint-1-report.md +0 -71
  107. package/docs/perf/sprint-2-report.md +0 -81
  108. package/docs/perf/sprint-2.5-report.md +0 -53
  109. package/docs/perf/sprint-3-report.md +0 -36
  110. package/docs/perf/sprint-4-report.md +0 -47
  111. package/docs/perf/sprint-5-report.md +0 -51
  112. package/docs/perf/sprint-6-report.md +0 -94
  113. package/docs/perf/sprint-7-report.md +0 -74
  114. package/docs/perf/upgrade-plan-2026-05.md +0 -147
  115. package/docs/performance-optimization-execution-plan.md +0 -520
  116. package/docs/phase4-triage.md +0 -58
  117. package/docs/pi-crew-investigation-report.md +0 -411
  118. package/docs/product/README.md +0 -31
  119. package/docs/product/platform.md +0 -27
  120. package/docs/product/runtime-safety.md +0 -37
  121. package/docs/product/team-run.md +0 -39
  122. package/docs/product/team-tool.md +0 -37
  123. package/docs/runtime-analysis-child-vs-live.md +0 -171
  124. package/docs/runtime-migration-in-process-analysis.md +0 -250
  125. package/docs/skills/REFERENCE.md +0 -138
  126. package/docs/stories/README.md +0 -32
  127. package/docs/stories/US-DEPS-major-upgrade.md +0 -62
  128. package/docs/stories/backlog.md +0 -36
  129. package/docs/superpowers/plans/2026-06-09-fallow-patterns-adoption.md +0 -1270
  130. package/docs/templates/decision.md +0 -27
  131. package/docs/templates/story.md +0 -44
  132. package/docs/templates/validation-report.md +0 -32
  133. package/docs/ui-optimization-plan.md +0 -447
  134. package/src/adapters/claude-adapter.ts +0 -23
  135. package/src/adapters/codex-adapter.ts +0 -21
  136. package/src/adapters/cursor-adapter.ts +0 -17
  137. package/src/adapters/export-util.ts +0 -143
  138. package/src/adapters/index.ts +0 -15
  139. package/src/adapters/registry.ts +0 -18
  140. package/src/adapters/types.ts +0 -23
  141. package/src/agents/agent-config.ts +0 -194
  142. package/src/agents/agent-search.ts +0 -98
  143. package/src/agents/agent-serializer.ts +0 -38
  144. package/src/agents/discover-agents.ts +0 -623
  145. package/src/benchmark/benchmark-runner.ts +0 -313
  146. package/src/benchmark/feedback-loop.ts +0 -73
  147. package/src/config/config.ts +0 -1269
  148. package/src/config/defaults.ts +0 -193
  149. package/src/config/drift-detector.ts +0 -290
  150. package/src/config/markers.ts +0 -330
  151. package/src/config/resilient-parser.ts +0 -117
  152. package/src/config/role-tools.ts +0 -118
  153. package/src/config/suggestions.ts +0 -75
  154. package/src/config/types.ts +0 -278
  155. package/src/errors.ts +0 -194
  156. package/src/extension/action-suggestions.ts +0 -117
  157. package/src/extension/async-notifier.ts +0 -179
  158. package/src/extension/autonomous-policy.ts +0 -209
  159. package/src/extension/command-completions.ts +0 -120
  160. package/src/extension/context-status-injection.ts +0 -185
  161. package/src/extension/crew-autocomplete.ts +0 -131
  162. package/src/extension/crew-cleanup.ts +0 -168
  163. package/src/extension/crew-input-router.ts +0 -93
  164. package/src/extension/crew-shortcuts.ts +0 -87
  165. package/src/extension/crew-vibes/cat-frames.ts +0 -18
  166. package/src/extension/crew-vibes/config.ts +0 -195
  167. package/src/extension/crew-vibes/figures.ts +0 -101
  168. package/src/extension/crew-vibes/font-detect.ts +0 -71
  169. package/src/extension/crew-vibes/footer.ts +0 -292
  170. package/src/extension/crew-vibes/index.ts +0 -432
  171. package/src/extension/crew-vibes/provider-usage.ts +0 -396
  172. package/src/extension/crew-vibes/render.ts +0 -206
  173. package/src/extension/crew-vibes/speed.ts +0 -286
  174. package/src/extension/cross-extension-rpc.ts +0 -350
  175. package/src/extension/help.ts +0 -62
  176. package/src/extension/import-index.ts +0 -74
  177. package/src/extension/knowledge-injection.ts +0 -402
  178. package/src/extension/management.ts +0 -571
  179. package/src/extension/message-renderers.ts +0 -108
  180. package/src/extension/notification-router.ts +0 -152
  181. package/src/extension/notification-sink.ts +0 -54
  182. package/src/extension/pi-api.ts +0 -56
  183. package/src/extension/plan-orchestrate.ts +0 -302
  184. package/src/extension/project-init.ts +0 -170
  185. package/src/extension/register.ts +0 -113
  186. package/src/extension/registration/artifact-cleanup.ts +0 -20
  187. package/src/extension/registration/command-registration.ts +0 -58
  188. package/src/extension/registration/command-utils.ts +0 -58
  189. package/src/extension/registration/commands.ts +0 -1228
  190. package/src/extension/registration/compaction-guard.ts +0 -333
  191. package/src/extension/registration/context-builder.ts +0 -135
  192. package/src/extension/registration/crash-recovery-cache.ts +0 -54
  193. package/src/extension/registration/foreground-run-controller.ts +0 -238
  194. package/src/extension/registration/hook-registration.ts +0 -119
  195. package/src/extension/registration/lazy-configurers.ts +0 -124
  196. package/src/extension/registration/lifecycle-handlers.ts +0 -923
  197. package/src/extension/registration/lifecycle.ts +0 -259
  198. package/src/extension/registration/observability.ts +0 -322
  199. package/src/extension/registration/registration-types.ts +0 -158
  200. package/src/extension/registration/runtime-cleanup.ts +0 -230
  201. package/src/extension/registration/subagent-helpers.ts +0 -125
  202. package/src/extension/registration/subagent-manager-setup.ts +0 -330
  203. package/src/extension/registration/subagent-tools.ts +0 -456
  204. package/src/extension/registration/team-tool.ts +0 -220
  205. package/src/extension/registration/tool-registration.ts +0 -50
  206. package/src/extension/registration/ui.ts +0 -172
  207. package/src/extension/registration/viewers.ts +0 -121
  208. package/src/extension/registration/wire-cross-extension.ts +0 -37
  209. package/src/extension/result-watcher.ts +0 -139
  210. package/src/extension/rpc-hmac.ts +0 -256
  211. package/src/extension/run-bundle-schema.ts +0 -104
  212. package/src/extension/run-export.ts +0 -97
  213. package/src/extension/run-import.ts +0 -168
  214. package/src/extension/run-index.ts +0 -131
  215. package/src/extension/run-maintenance.ts +0 -190
  216. package/src/extension/session-summary.ts +0 -18
  217. package/src/extension/team-manager-command.ts +0 -153
  218. package/src/extension/team-onboard.ts +0 -177
  219. package/src/extension/team-recommendation.ts +0 -288
  220. package/src/extension/team-tool/anchor.ts +0 -172
  221. package/src/extension/team-tool/api.ts +0 -1244
  222. package/src/extension/team-tool/auto-summarize.ts +0 -142
  223. package/src/extension/team-tool/cache-control.ts +0 -19
  224. package/src/extension/team-tool/cancel.ts +0 -337
  225. package/src/extension/team-tool/chain-dispatch.ts +0 -95
  226. package/src/extension/team-tool/chain-executor.ts +0 -379
  227. package/src/extension/team-tool/config-patch.ts +0 -50
  228. package/src/extension/team-tool/context.ts +0 -149
  229. package/src/extension/team-tool/destructive-gate.ts +0 -52
  230. package/src/extension/team-tool/doctor.ts +0 -431
  231. package/src/extension/team-tool/explain.ts +0 -282
  232. package/src/extension/team-tool/failure-patterns.ts +0 -118
  233. package/src/extension/team-tool/goal-wrap.ts +0 -330
  234. package/src/extension/team-tool/goal.ts +0 -556
  235. package/src/extension/team-tool/handle-schedule.ts +0 -332
  236. package/src/extension/team-tool/handle-settings.ts +0 -520
  237. package/src/extension/team-tool/health-monitor.ts +0 -481
  238. package/src/extension/team-tool/inspect.ts +0 -88
  239. package/src/extension/team-tool/intent-policy.ts +0 -45
  240. package/src/extension/team-tool/lifecycle-actions.ts +0 -615
  241. package/src/extension/team-tool/orchestrate.ts +0 -98
  242. package/src/extension/team-tool/parallel-dispatch.ts +0 -183
  243. package/src/extension/team-tool/plan.ts +0 -50
  244. package/src/extension/team-tool/respond.ts +0 -150
  245. package/src/extension/team-tool/run-not-found.ts +0 -49
  246. package/src/extension/team-tool/run.ts +0 -1035
  247. package/src/extension/team-tool/status.ts +0 -260
  248. package/src/extension/team-tool/workflow-manage.ts +0 -261
  249. package/src/extension/team-tool-types.ts +0 -26
  250. package/src/extension/team-tool.ts +0 -1116
  251. package/src/extension/tool-result.ts +0 -16
  252. package/src/extension/validate-resources.ts +0 -108
  253. package/src/hooks/registry.ts +0 -200
  254. package/src/hooks/types.ts +0 -69
  255. package/src/i18n.ts +0 -212
  256. package/src/observability/correlation.ts +0 -50
  257. package/src/observability/event-bus.ts +0 -86
  258. package/src/observability/event-to-metric.ts +0 -170
  259. package/src/observability/exporters/adapter.ts +0 -27
  260. package/src/observability/exporters/otlp-exporter.ts +0 -356
  261. package/src/observability/exporters/prometheus-exporter.ts +0 -54
  262. package/src/observability/metric-registry.ts +0 -100
  263. package/src/observability/metric-retention.ts +0 -64
  264. package/src/observability/metric-sink.ts +0 -99
  265. package/src/observability/metrics-primitives.ts +0 -219
  266. package/src/plugins/plugin-define.ts +0 -6
  267. package/src/plugins/plugin-registry.ts +0 -32
  268. package/src/plugins/plugins/index.ts +0 -3
  269. package/src/plugins/plugins/nextjs.ts +0 -19
  270. package/src/plugins/plugins/vite.ts +0 -10
  271. package/src/plugins/plugins/vitest.ts +0 -9
  272. package/src/prompt/prompt-runtime.ts +0 -380
  273. package/src/runtime/adaptive-plan.ts +0 -563
  274. package/src/runtime/agent-control.ts +0 -215
  275. package/src/runtime/agent-memory.ts +0 -81
  276. package/src/runtime/agent-observability.ts +0 -122
  277. package/src/runtime/anchor-manager.ts +0 -475
  278. package/src/runtime/async-marker.ts +0 -32
  279. package/src/runtime/async-runner.ts +0 -381
  280. package/src/runtime/attention-events.ts +0 -28
  281. package/src/runtime/auto-summarize.ts +0 -344
  282. package/src/runtime/background-runner.ts +0 -837
  283. package/src/runtime/batch-barrier.ts +0 -147
  284. package/src/runtime/broker-issuer.ts +0 -37
  285. package/src/runtime/cancellation-token.ts +0 -99
  286. package/src/runtime/cancellation.ts +0 -99
  287. package/src/runtime/capability-inventory.ts +0 -137
  288. package/src/runtime/chain-parser.ts +0 -237
  289. package/src/runtime/chain-runner.ts +0 -606
  290. package/src/runtime/checkpoint.ts +0 -291
  291. package/src/runtime/child-pi-constants.ts +0 -42
  292. package/src/runtime/child-pi-kill.ts +0 -180
  293. package/src/runtime/child-pi-pool.ts +0 -68
  294. package/src/runtime/child-pi-spawn.ts +0 -287
  295. package/src/runtime/child-pi-steering.ts +0 -128
  296. package/src/runtime/child-pi-streams.ts +0 -296
  297. package/src/runtime/child-pi-transcript.ts +0 -169
  298. package/src/runtime/child-pi.ts +0 -1105
  299. package/src/runtime/coalesce-tasks.ts +0 -268
  300. package/src/runtime/code-summary.ts +0 -292
  301. package/src/runtime/command-trace.ts +0 -105
  302. package/src/runtime/compact-pipeline.ts +0 -56
  303. package/src/runtime/compact-stages/ansi-strip-stage.ts +0 -25
  304. package/src/runtime/compact-stages/blank-collapse-stage.ts +0 -31
  305. package/src/runtime/compact-stages/deduplicate-stage.ts +0 -34
  306. package/src/runtime/compact-stages/head-snap-stage.ts +0 -57
  307. package/src/runtime/compact-stages/index.ts +0 -23
  308. package/src/runtime/compact-stages/tail-capture-stage.ts +0 -77
  309. package/src/runtime/compact-stages/truncation-stage.ts +0 -74
  310. package/src/runtime/compaction-summary.ts +0 -278
  311. package/src/runtime/completion-guard.ts +0 -207
  312. package/src/runtime/concurrency.ts +0 -58
  313. package/src/runtime/crash-classification.ts +0 -229
  314. package/src/runtime/crash-recovery.ts +0 -577
  315. package/src/runtime/crew-agent-records.ts +0 -593
  316. package/src/runtime/crew-agent-runtime.ts +0 -62
  317. package/src/runtime/crew-broker-child.ts +0 -88
  318. package/src/runtime/crew-broker-client.ts +0 -673
  319. package/src/runtime/crew-broker-tokens.ts +0 -84
  320. package/src/runtime/crew-broker.ts +0 -1276
  321. package/src/runtime/crew-hooks.ts +0 -227
  322. package/src/runtime/cross-extension-rpc.ts +0 -143
  323. package/src/runtime/custom-tools/irc-tool.ts +0 -282
  324. package/src/runtime/custom-tools/submit-result-tool.ts +0 -102
  325. package/src/runtime/deadletter.ts +0 -47
  326. package/src/runtime/delivery-coordinator.ts +0 -211
  327. package/src/runtime/delta-conflict.ts +0 -348
  328. package/src/runtime/deterministic-ast.ts +0 -161
  329. package/src/runtime/diagnostic-export.ts +0 -171
  330. package/src/runtime/direct-run.ts +0 -45
  331. package/src/runtime/dwf-state-store.ts +0 -102
  332. package/src/runtime/dynamic-workflow-context.ts +0 -1016
  333. package/src/runtime/dynamic-workflow-runner.ts +0 -310
  334. package/src/runtime/effectiveness.ts +0 -90
  335. package/src/runtime/errors/crew-errors.ts +0 -162
  336. package/src/runtime/event-stream-bridge.ts +0 -98
  337. package/src/runtime/foreground-control.ts +0 -193
  338. package/src/runtime/foreground-watchdog.ts +0 -132
  339. package/src/runtime/global-worker-cap.ts +0 -96
  340. package/src/runtime/goal-achievement.ts +0 -148
  341. package/src/runtime/goal-evaluator.ts +0 -361
  342. package/src/runtime/goal-loop-runner.ts +0 -828
  343. package/src/runtime/goal-state-store.ts +0 -219
  344. package/src/runtime/green-contract.ts +0 -55
  345. package/src/runtime/group-join.ts +0 -267
  346. package/src/runtime/handoff-manager.ts +0 -598
  347. package/src/runtime/heartbeat-gradient.ts +0 -36
  348. package/src/runtime/heartbeat-watcher.ts +0 -239
  349. package/src/runtime/hidden-handoff.ts +0 -407
  350. package/src/runtime/important-line-classifier.ts +0 -140
  351. package/src/runtime/intercom-bridge.ts +0 -187
  352. package/src/runtime/iteration-hooks.ts +0 -305
  353. package/src/runtime/live-agent-control.ts +0 -136
  354. package/src/runtime/live-agent-manager.ts +0 -704
  355. package/src/runtime/live-control-realtime.ts +0 -56
  356. package/src/runtime/live-extension-bridge.ts +0 -148
  357. package/src/runtime/live-irc.ts +0 -97
  358. package/src/runtime/live-session-health.ts +0 -108
  359. package/src/runtime/live-session-runtime.ts +0 -1139
  360. package/src/runtime/loop-gates.ts +0 -128
  361. package/src/runtime/manifest-cache.ts +0 -375
  362. package/src/runtime/mcp-proxy.ts +0 -105
  363. package/src/runtime/metric-parser.ts +0 -36
  364. package/src/runtime/model-fallback.ts +0 -409
  365. package/src/runtime/model-resolver.ts +0 -126
  366. package/src/runtime/model-scope.ts +0 -158
  367. package/src/runtime/orphan-worker-registry.ts +0 -465
  368. package/src/runtime/output-validator.ts +0 -202
  369. package/src/runtime/overflow-recovery.ts +0 -206
  370. package/src/runtime/parallel-research.ts +0 -68
  371. package/src/runtime/parallel-utils.ts +0 -160
  372. package/src/runtime/parent-guard.ts +0 -134
  373. package/src/runtime/path-overlap.ts +0 -150
  374. package/src/runtime/peer-dep.ts +0 -292
  375. package/src/runtime/per-write-validator.ts +0 -181
  376. package/src/runtime/phase-progress.ts +0 -217
  377. package/src/runtime/phase-tracker.ts +0 -385
  378. package/src/runtime/pi-args.ts +0 -655
  379. package/src/runtime/pi-json-output.ts +0 -170
  380. package/src/runtime/pi-spawn.ts +0 -273
  381. package/src/runtime/pipeline-runner.ts +0 -523
  382. package/src/runtime/plan-templates.ts +0 -201
  383. package/src/runtime/policy-engine.ts +0 -115
  384. package/src/runtime/post-checks.ts +0 -142
  385. package/src/runtime/post-exit-stdio-guard.ts +0 -104
  386. package/src/runtime/process-lifecycle.ts +0 -491
  387. package/src/runtime/process-status.ts +0 -154
  388. package/src/runtime/progress-event-coalescer.ts +0 -44
  389. package/src/runtime/progress-tracker.ts +0 -124
  390. package/src/runtime/prose-compressor.ts +0 -162
  391. package/src/runtime/recovery-recipes.ts +0 -203
  392. package/src/runtime/replace.ts +0 -570
  393. package/src/runtime/resilient-edit.ts +0 -153
  394. package/src/runtime/result-extractor.ts +0 -213
  395. package/src/runtime/retry-executor.ts +0 -100
  396. package/src/runtime/retry-runner.ts +0 -336
  397. package/src/runtime/role-permission.ts +0 -59
  398. package/src/runtime/run-coalesced-task-group.ts +0 -308
  399. package/src/runtime/run-drift.ts +0 -219
  400. package/src/runtime/run-tracker.ts +0 -116
  401. package/src/runtime/runtime-policy.ts +0 -29
  402. package/src/runtime/runtime-resolver.ts +0 -172
  403. package/src/runtime/runtime-warmup.ts +0 -160
  404. package/src/runtime/scheduler.ts +0 -353
  405. package/src/runtime/semaphore.ts +0 -141
  406. package/src/runtime/sensitive-paths.ts +0 -93
  407. package/src/runtime/session-resources.ts +0 -25
  408. package/src/runtime/session-snapshot.ts +0 -59
  409. package/src/runtime/session-usage.ts +0 -79
  410. package/src/runtime/settings-store.ts +0 -155
  411. package/src/runtime/sidechain-output.ts +0 -35
  412. package/src/runtime/single-agent-compose.ts +0 -84
  413. package/src/runtime/skill-effectiveness.ts +0 -524
  414. package/src/runtime/skill-instructions.ts +0 -391
  415. package/src/runtime/stale-reconciler.ts +0 -680
  416. package/src/runtime/stream-preview.ts +0 -184
  417. package/src/runtime/streaming-output.ts +0 -50
  418. package/src/runtime/subagent-manager.ts +0 -561
  419. package/src/runtime/subprocess-tool-registry.ts +0 -70
  420. package/src/runtime/supervisor-contact.ts +0 -64
  421. package/src/runtime/task-display.ts +0 -52
  422. package/src/runtime/task-graph-scheduler.ts +0 -227
  423. package/src/runtime/task-graph.ts +0 -290
  424. package/src/runtime/task-health.ts +0 -83
  425. package/src/runtime/task-id.ts +0 -161
  426. package/src/runtime/task-output-context.ts +0 -602
  427. package/src/runtime/task-packet.ts +0 -268
  428. package/src/runtime/task-quality.ts +0 -199
  429. package/src/runtime/task-runner/capabilities.ts +0 -78
  430. package/src/runtime/task-runner/context-retrieval.ts +0 -163
  431. package/src/runtime/task-runner/live-executor.ts +0 -227
  432. package/src/runtime/task-runner/output-splitter.ts +0 -152
  433. package/src/runtime/task-runner/progress.ts +0 -157
  434. package/src/runtime/task-runner/prompt-builder.ts +0 -278
  435. package/src/runtime/task-runner/prompt-pipeline.ts +0 -88
  436. package/src/runtime/task-runner/result-utils.ts +0 -16
  437. package/src/runtime/task-runner/retrieval-orchestrator.ts +0 -310
  438. package/src/runtime/task-runner/run-projection.ts +0 -125
  439. package/src/runtime/task-runner/state-helpers.ts +0 -176
  440. package/src/runtime/task-runner/tail-read.ts +0 -34
  441. package/src/runtime/task-runner.ts +0 -1420
  442. package/src/runtime/team-runner-artifacts.ts +0 -13
  443. package/src/runtime/team-runner.ts +0 -1993
  444. package/src/runtime/tool-output-pruner.ts +0 -333
  445. package/src/runtime/tool-progress.ts +0 -278
  446. package/src/runtime/usage-tracker.ts +0 -73
  447. package/src/runtime/verification-gates.ts +0 -571
  448. package/src/runtime/verification-integrity.ts +0 -105
  449. package/src/runtime/verification-worktree.ts +0 -186
  450. package/src/runtime/worker-heartbeat.ts +0 -25
  451. package/src/runtime/worker-startup.ts +0 -83
  452. package/src/runtime/workflow-state.ts +0 -195
  453. package/src/runtime/workspace-lock.ts +0 -443
  454. package/src/runtime/workspace-tree.ts +0 -312
  455. package/src/runtime/yield-handler.ts +0 -224
  456. package/src/runtime/zombie-scanner.ts +0 -298
  457. package/src/schema/config-schema.ts +0 -327
  458. package/src/schema/team-tool-schema.ts +0 -415
  459. package/src/schema/validation-types.ts +0 -159
  460. package/src/skills/discover-skills.ts +0 -197
  461. package/src/skills/skill-templates.ts +0 -456
  462. package/src/skills/validate.ts +0 -285
  463. package/src/state/active-run-registry.ts +0 -439
  464. package/src/state/artifact-store.ts +0 -176
  465. package/src/state/atomic-write.ts +0 -903
  466. package/src/state/blob-store.ts +0 -308
  467. package/src/state/contracts.ts +0 -158
  468. package/src/state/crew-init.ts +0 -269
  469. package/src/state/decision-ledger.ts +0 -345
  470. package/src/state/event-log-rotation.ts +0 -342
  471. package/src/state/event-log.ts +0 -1311
  472. package/src/state/event-reconstructor.ts +0 -229
  473. package/src/state/gitignore-manager.ts +0 -46
  474. package/src/state/health-store.ts +0 -79
  475. package/src/state/hook-instinct-bridge.ts +0 -94
  476. package/src/state/hook-integrations.ts +0 -51
  477. package/src/state/instinct-store.ts +0 -275
  478. package/src/state/jsonl-writer.ts +0 -107
  479. package/src/state/locks.ts +0 -562
  480. package/src/state/mailbox.ts +0 -916
  481. package/src/state/observation-store.ts +0 -176
  482. package/src/state/run-cache.ts +0 -193
  483. package/src/state/run-graph.ts +0 -183
  484. package/src/state/run-metrics.ts +0 -165
  485. package/src/state/schedule.ts +0 -166
  486. package/src/state/session-state-map.ts +0 -51
  487. package/src/state/state-store.ts +0 -958
  488. package/src/state/task-claims.ts +0 -61
  489. package/src/state/tiered-eval.ts +0 -480
  490. package/src/state/types-eval.ts +0 -58
  491. package/src/state/types.ts +0 -440
  492. package/src/state/usage.ts +0 -138
  493. package/src/state/worker-atomic-writer.ts +0 -194
  494. package/src/subagents/async-entry.ts +0 -1
  495. package/src/subagents/index.ts +0 -3
  496. package/src/subagents/live/control.ts +0 -1
  497. package/src/subagents/live/manager.ts +0 -1
  498. package/src/subagents/live/realtime.ts +0 -1
  499. package/src/subagents/live/session-runtime.ts +0 -1
  500. package/src/subagents/manager.ts +0 -1
  501. package/src/subagents/spawn.ts +0 -1
  502. package/src/teams/discover-teams.ts +0 -187
  503. package/src/teams/team-config.ts +0 -27
  504. package/src/teams/team-serializer.ts +0 -38
  505. package/src/tools/safe-bash-extension.ts +0 -54
  506. package/src/tools/safe-bash.ts +0 -505
  507. package/src/types/diff.d.ts +0 -18
  508. package/src/types/new-api-types.ts +0 -35
  509. package/src/ui/agent-management-overlay.ts +0 -160
  510. package/src/ui/card-colors.ts +0 -139
  511. package/src/ui/crew-footer.ts +0 -102
  512. package/src/ui/crew-select-list.ts +0 -111
  513. package/src/ui/dashboard-panes/agents-pane.ts +0 -164
  514. package/src/ui/dashboard-panes/cancellation-pane.ts +0 -66
  515. package/src/ui/dashboard-panes/capability-pane.ts +0 -77
  516. package/src/ui/dashboard-panes/health-pane.ts +0 -31
  517. package/src/ui/dashboard-panes/mailbox-pane.ts +0 -35
  518. package/src/ui/dashboard-panes/metrics-pane.ts +0 -37
  519. package/src/ui/dashboard-panes/progress-pane.ts +0 -38
  520. package/src/ui/dashboard-panes/transcript-pane.ts +0 -10
  521. package/src/ui/deploy-bundled-themes.ts +0 -71
  522. package/src/ui/dwf-phase-display.ts +0 -151
  523. package/src/ui/dynamic-border.ts +0 -35
  524. package/src/ui/heartbeat-aggregator.ts +0 -74
  525. package/src/ui/key-utils.ts +0 -42
  526. package/src/ui/keybinding-map.ts +0 -248
  527. package/src/ui/layout-primitives.ts +0 -106
  528. package/src/ui/live-conversation-overlay.ts +0 -183
  529. package/src/ui/live-duration.ts +0 -55
  530. package/src/ui/live-run-sidebar.ts +0 -293
  531. package/src/ui/loaders.ts +0 -6
  532. package/src/ui/mascot.ts +0 -449
  533. package/src/ui/overlays/agent-picker-overlay.ts +0 -65
  534. package/src/ui/overlays/confirm-overlay.ts +0 -60
  535. package/src/ui/overlays/help-overlay.ts +0 -177
  536. package/src/ui/overlays/mailbox-compose-overlay.ts +0 -181
  537. package/src/ui/overlays/mailbox-compose-preview.ts +0 -78
  538. package/src/ui/overlays/mailbox-detail-overlay.ts +0 -154
  539. package/src/ui/pi-ui-compat.ts +0 -68
  540. package/src/ui/powerbar-publisher.ts +0 -459
  541. package/src/ui/render-coalescer.ts +0 -101
  542. package/src/ui/render-diff.ts +0 -160
  543. package/src/ui/render-scheduler.ts +0 -278
  544. package/src/ui/run-action-dispatcher.ts +0 -182
  545. package/src/ui/run-dashboard.ts +0 -904
  546. package/src/ui/run-event-bus.ts +0 -381
  547. package/src/ui/run-snapshot-cache.ts +0 -1057
  548. package/src/ui/settings-overlay.ts +0 -1067
  549. package/src/ui/shared-overlay-scheduler.ts +0 -96
  550. package/src/ui/snapshot-types.ts +0 -90
  551. package/src/ui/spinner.ts +0 -17
  552. package/src/ui/status-colors.ts +0 -143
  553. package/src/ui/syntax-highlight.ts +0 -136
  554. package/src/ui/terminal-status.ts +0 -269
  555. package/src/ui/theme-adapter.ts +0 -271
  556. package/src/ui/theme-discovery.ts +0 -199
  557. package/src/ui/tool-progress-formatter.ts +0 -93
  558. package/src/ui/tool-render.ts +0 -453
  559. package/src/ui/tool-renderers/brief-mode.ts +0 -225
  560. package/src/ui/tool-renderers/index.ts +0 -726
  561. package/src/ui/transcript-cache.ts +0 -128
  562. package/src/ui/transcript-entries.ts +0 -256
  563. package/src/ui/transcript-viewer.ts +0 -424
  564. package/src/ui/widget/index.ts +0 -391
  565. package/src/ui/widget/widget-formatters.ts +0 -182
  566. package/src/ui/widget/widget-model.ts +0 -110
  567. package/src/ui/widget/widget-renderer.ts +0 -182
  568. package/src/ui/widget/widget-types.ts +0 -36
  569. package/src/utils/bm25-search.ts +0 -235
  570. package/src/utils/completion-dedupe.ts +0 -63
  571. package/src/utils/conflict-detect.ts +0 -668
  572. package/src/utils/env-allowlist.ts +0 -30
  573. package/src/utils/env-filter.ts +0 -155
  574. package/src/utils/file-coalescer.ts +0 -98
  575. package/src/utils/fingerprint.ts +0 -180
  576. package/src/utils/frontmatter.ts +0 -70
  577. package/src/utils/fs-watch.ts +0 -37
  578. package/src/utils/gh-protocol.ts +0 -556
  579. package/src/utils/git.ts +0 -260
  580. package/src/utils/guards.ts +0 -107
  581. package/src/utils/ids.ts +0 -24
  582. package/src/utils/incremental-reader.ts +0 -220
  583. package/src/utils/internal-error.ts +0 -10
  584. package/src/utils/names.ts +0 -36
  585. package/src/utils/ndjson.ts +0 -115
  586. package/src/utils/paths.ts +0 -227
  587. package/src/utils/project-detector.ts +0 -160
  588. package/src/utils/redaction.ts +0 -347
  589. package/src/utils/resolve-shell.ts +0 -36
  590. package/src/utils/run-watcher-registry.ts +0 -152
  591. package/src/utils/safe-paths.ts +0 -383
  592. package/src/utils/scan-cache.ts +0 -144
  593. package/src/utils/session-utils.ts +0 -110
  594. package/src/utils/sleep.ts +0 -54
  595. package/src/utils/socket-path.ts +0 -127
  596. package/src/utils/sse-parser.ts +0 -129
  597. package/src/utils/task-name-generator.ts +0 -337
  598. package/src/utils/timings.ts +0 -33
  599. package/src/utils/token-counter.ts +0 -200
  600. package/src/utils/visual.ts +0 -207
  601. package/src/workflows/cost-estimator.ts +0 -34
  602. package/src/workflows/discover-workflows.ts +0 -290
  603. package/src/workflows/intermediate-store.ts +0 -166
  604. package/src/workflows/preflight-validator.ts +0 -168
  605. package/src/workflows/topology-analyzer.ts +0 -203
  606. package/src/workflows/validate-workflow.ts +0 -50
  607. package/src/workflows/workflow-config.ts +0 -70
  608. package/src/workflows/workflow-serializer.ts +0 -32
  609. package/src/worktree/branch-freshness.ts +0 -112
  610. package/src/worktree/cleanup.ts +0 -341
  611. package/src/worktree/worktree-manager.ts +0 -1200
@@ -1,680 +0,0 @@
1
- import * as fs from "node:fs";
2
- import * as os from "node:os";
3
- import * as path from "node:path";
4
- import { errors } from "../errors.ts";
5
- import { atomicWriteFile, atomicWriteJson } from "../state/atomic-write.ts";
6
- import { saveRunManifest } from "../state/state-store.ts";
7
- import type { TeamRunManifest, TeamTaskState } from "../state/types.ts";
8
- import { recordFromTask, upsertCrewAgent } from "./crew-agent-records.ts";
9
- import { checkProcessLiveness } from "./process-status.ts";
10
-
11
- /** Age threshold for orphaned temp directory cleanup: 1 hour. */
12
- const ORPHAN_TEMP_DIR_AGE_THRESHOLD_MS = 60 * 60 * 1000;
13
- /** Defense-in-depth: cap the number of /tmp/pi-crew-* entries processed per
14
- * reconcile tick. With a few thousand accumulated dirs, processing them all
15
- * synchronously can block the main thread for many seconds, causing the
16
- * terminal to appear hung. We process in batches; the rest are handled on
17
- * subsequent ticks. */
18
- const ORPHAN_TEMP_SCAN_BATCH_SIZE = 50;
19
-
20
- /**
21
- * Result of reconciling a single stale run.
22
- */
23
- export interface ReconcileResult {
24
- runId: string;
25
- /** What was found and what action was taken */
26
- verdict: "healthy" | "blocked_awaiting_approval" | "result_exists" | "pid_dead" | "pid_alive_stale" | "no_status";
27
- /** Whether repair was applied */
28
- repaired: boolean;
29
- /** Human-readable detail */
30
- detail: string;
31
- /** Repaired task state, returned to a locked caller for persistence. */
32
- repairedTasks?: TeamTaskState[];
33
- }
34
-
35
- /**
36
- * Is this run intentionally waiting for human plan approval?
37
- *
38
- * Such runs are NOT stale even if their owning session died or their async PID
39
- * is no longer live — they are blocked on a human decision, not a crash. Crash
40
- * recovery and stale reconciliation must preserve them rather than mark them
41
- * failed or orphan-cancel them. See PR #32 (gustavo-pelissaro) for the
42
- * original analysis of this failure mode.
43
- */
44
- export function isPlanApprovalPending(manifest: TeamRunManifest): boolean {
45
- return manifest.status === "blocked" && manifest.planApproval?.required === true && manifest.planApproval.status === "pending";
46
- }
47
-
48
- const STALE_ALIVE_PID_MS = 24 * 60 * 60 * 1000; // 24 hours
49
- const ACTIVE_EVIDENCE_TTL_MS = 5 * 60 * 1000;
50
- /** For no-PID runs, repair when ALL running tasks have heartbeat stale beyond this threshold. */
51
- const NO_PID_HEARTBEAT_STALE_MS = 5 * 60 * 1000; // 5 minutes — same as heartbeat-gradient deadMs
52
-
53
- /**
54
- * Phase 1: Check if a result file already exists for the run.
55
- * If so, the run completed but status wasn't updated — repair it.
56
- */
57
- function checkResultFile(manifest: TeamRunManifest, tasks: TeamTaskState[]): { found: boolean; repaired: boolean } {
58
- // Check if all tasks already have terminal status (result was written but manifest wasn't updated)
59
- const allTerminal =
60
- tasks.length > 0 &&
61
- tasks.every(
62
- (t) =>
63
- t.status === "completed" ||
64
- t.status === "failed" ||
65
- t.status === "cancelled" ||
66
- t.status === "skipped" ||
67
- t.status === "needs_attention",
68
- );
69
- if (allTerminal) {
70
- // All tasks are terminal but manifest status was not updated — repair it.
71
- // Derive the run status from task outcomes instead of blindly marking
72
- // "completed": a run where every task failed/cancelled is NOT a success.
73
- const hasFailed = tasks.some((t) => t.status === "failed" || t.status === "needs_attention");
74
- const onlyCancelledOrSkipped = tasks.every((t) => t.status === "cancelled" || t.status === "skipped");
75
- manifest.status = hasFailed ? "failed" : onlyCancelledOrSkipped ? "cancelled" : "completed";
76
- // Persist manifest status change immediately to make checkResultFile self-contained.
77
- // NOTE (OPT-02): Remains sync — reconcileStaleRun → checkResultFile is called from
78
- // withRunLockSync in crash-recovery.ts and from sync reconcileOrphanedTempWorkspaces.
79
- // Converting to async would require cascading through all callers including sync UI hooks.
80
- saveRunManifest(manifest);
81
- // Sync agent records even when tasks are already terminal
82
- // (e.g., a previous reconcile fixed tasks but crashed before updating agents)
83
- for (const task of tasks) {
84
- try {
85
- upsertCrewAgent(manifest, recordFromTask(manifest, task, "scaffold"));
86
- } catch {
87
- /* non-critical */
88
- }
89
- }
90
- return { found: true, repaired: false };
91
- }
92
- return { found: false, repaired: false };
93
- }
94
-
95
- /**
96
- * Get process start time in milliseconds since boot from /proc/<pid>/stat.
97
- * Returns undefined if the process is gone or /proc is unavailable.
98
- *
99
- * Platform limitation: Relies on Linux's /proc filesystem. On macOS/Windows,
100
- * startTime will be undefined and PID reuse detection is weaker.
101
- *
102
- * The start time is in the 22nd field (index 21 after comm) of /proc/<pid>/stat.
103
- */
104
- function getProcessStartTime(pid: number): number | undefined {
105
- try {
106
- const stat = fs.readFileSync(`/proc/${pid}/stat`, "utf-8");
107
- const lastParen = stat.lastIndexOf(")");
108
- if (lastParen === -1) return undefined;
109
- const fieldsAfterComm = stat
110
- .slice(lastParen + 1)
111
- .trim()
112
- .split(/\s+/);
113
- // starttime is at index 19 (the 20th field after comm)
114
- const startTimeClockTicks = Number(fieldsAfterComm[19]);
115
- if (!Number.isFinite(startTimeClockTicks)) return undefined;
116
- // Convert clock ticks to ms using ~100 ticks/sec (CLK_TCK).
117
- // The absolute value matters less than uniqueness per PID lifecycle.
118
- return Math.floor(startTimeClockTicks * 10);
119
- } catch {
120
- return undefined;
121
- }
122
- }
123
-
124
- /**
125
- * Phase 2: Check PID liveness.
126
- * Uses process.kill(pid, 0) for the authoritative check, but also verifies
127
- * startTime before and after to detect PID recycling. If the OS recycles
128
- * the PID between the kill(0) call and the repair action, a newly spawned
129
- * unrelated process could be incorrectly identified as the async worker.
130
- * The heartbeat file is used as corroborating evidence when the process
131
- * appears dead per kill(0).
132
- */
133
- function checkPidLiveness(
134
- pid: number | undefined,
135
- stateRoot?: string,
136
- ): {
137
- alive: boolean;
138
- detail: string;
139
- } {
140
- if (pid === undefined || !Number.isInteger(pid) || pid <= 0) {
141
- return { alive: false, detail: "no pid recorded" };
142
- }
143
- // Capture startTime before kill(0) to detect PID recycling.
144
- const startTimeBefore = getProcessStartTime(pid);
145
- const liveness = checkProcessLiveness(pid);
146
- // Re-verify startTime after kill(0) to close the TOCTOU window.
147
- // If startTime changed, the PID was recycled to a different process.
148
- const startTimeAfter = getProcessStartTime(pid);
149
- if (startTimeBefore !== undefined && startTimeAfter !== undefined && startTimeBefore !== startTimeAfter) {
150
- // PID was recycled — treat as dead to avoid acting on wrong process.
151
- return { alive: false, detail: "pid_recycled" };
152
- }
153
- // If process is alive per kill(0), we're done.
154
- if (liveness.alive) return { alive: true, detail: liveness.detail };
155
- // Process is dead per kill(0). ESRCH is AUTHORITATIVE — the PID does not exist.
156
- // A frozen/zombie process still has a PID (kill(0) returns 0, or EPERM if we lack
157
- // permission to signal it), so reaching here with alive=false means the process
158
- // is genuinely gone. PID recycling is already handled above via the startTime
159
- // TOCTOU check, so the heartbeat file must NOT override the dead verdict.
160
- //
161
- // HISTORY: a <5min-old heartbeat.json previously OVERRRODE this verdict (returned
162
- // alive:true "process dead but heartbeat Xs old"), delaying repair by ~5min.
163
- // Combined with the 60s reconcile cadence this produced a ~300-360s detection lag
164
- // for dead workers (observed 353s in production). The heartbeat is now used only
165
- // to enrich the detail string, never to override the authoritative kill(0) verdict.
166
- let heartbeatNote = "";
167
- if (stateRoot) {
168
- try {
169
- const heartbeatPath = path.join(stateRoot, "heartbeat.json");
170
- if (fs.existsSync(heartbeatPath)) {
171
- const hb = JSON.parse(fs.readFileSync(heartbeatPath, "utf-8")) as { pid?: number; at?: number };
172
- if (hb?.pid === pid && hb?.at) {
173
- heartbeatNote = ` (heartbeat was ${Math.round((Date.now() - hb.at) / 1000)}s old)`;
174
- }
175
- }
176
- } catch {
177
- /* ignore — best-effort */
178
- }
179
- }
180
- return { alive: false, detail: `${liveness.detail}${heartbeatNote}` };
181
- }
182
-
183
- /**
184
- * Phase 3: For dead PIDs, repair immediately.
185
- * For alive PIDs, only mark stale if status hasn't updated in STALE_ALIVE_PID_MS.
186
- */
187
- function evaluateStaleness(manifest: TeamRunManifest, pidAlive: boolean, now: number): { stale: boolean; reason: string } {
188
- if (!pidAlive) {
189
- return { stale: true, reason: "pid_dead" };
190
- }
191
- const updatedAt = new Date(manifest.updatedAt).getTime();
192
- if (!Number.isFinite(updatedAt)) {
193
- return { stale: false, reason: "updated_at_invalid" };
194
- }
195
- if (now - updatedAt > STALE_ALIVE_PID_MS) {
196
- return {
197
- stale: true,
198
- reason: `alive_but_stale_${Math.round((now - updatedAt) / 3600_000)}h`,
199
- };
200
- }
201
- return { stale: false, reason: "alive_and_recent" };
202
- }
203
-
204
- function hasRecentActiveEvidence(tasks: TeamTaskState[], now: number): boolean {
205
- return tasks.some((task) => {
206
- if (task.status !== "running" && task.status !== "waiting") return false;
207
- const heartbeatAt = task.heartbeat?.lastSeenAt ? new Date(task.heartbeat.lastSeenAt).getTime() : Number.NaN;
208
- if (task.heartbeat?.alive !== false && Number.isFinite(heartbeatAt) && now - heartbeatAt <= ACTIVE_EVIDENCE_TTL_MS) return true;
209
- const activityAt = task.agentProgress?.lastActivityAt ? new Date(task.agentProgress.lastActivityAt).getTime() : Number.NaN;
210
- return Number.isFinite(activityAt) && now - activityAt <= ACTIVE_EVIDENCE_TTL_MS;
211
- });
212
- }
213
-
214
- /**
215
- * Check if a single task is stale (heartbeat AND activity both stale beyond
216
- * NO_PID_HEARTBEAT_STALE_MS). Tasks with no heartbeat AND no agent progress
217
- * are considered NOT stale (they may be newly spawned and haven't reported yet).
218
- */
219
- function isTaskHeartbeatStale(task: TeamTaskState, now: number): boolean {
220
- const heartbeatAt = task.heartbeat?.lastSeenAt ? new Date(task.heartbeat.lastSeenAt).getTime() : Number.NaN;
221
- const activityAt = task.agentProgress?.lastActivityAt ? new Date(task.agentProgress.lastActivityAt).getTime() : Number.NaN;
222
- // If no heartbeat AND no activity, we can't determine staleness — not stale
223
- if (!Number.isFinite(heartbeatAt) && !Number.isFinite(activityAt)) return false;
224
- // Compute elapsed from both sources and use the fresher (minimum) one,
225
- // mirroring heartbeat-watcher logic: if either source has recent activity,
226
- // the task is not stale even if the other is stale.
227
- const heartbeatAge = Number.isFinite(heartbeatAt) ? now - heartbeatAt : Infinity;
228
- const activityAge = Number.isFinite(activityAt) ? now - activityAt : Infinity;
229
- const elapsed = Math.min(heartbeatAge, activityAge);
230
- return elapsed > NO_PID_HEARTBEAT_STALE_MS;
231
- }
232
-
233
- /**
234
- * For no-PID runs: check if ALL running tasks have heartbeats stale beyond
235
- * the no-PID heartbeat threshold, and return the list of individually stale
236
- * task IDs. This detects zombie tasks where the worker process died but no
237
- * PID was recorded (e.g. live-session /tmp/ workspaces).
238
- * Merged from the former allRunningTasksHeartbeatStale and
239
- * findIndividuallyStaleTaskIds to avoid redundant duplicate checks.
240
- */
241
- function getRunningTaskStaleness(tasks: TeamTaskState[], now: number): { allStale: boolean; staleTaskIds: string[] } {
242
- const runningTasks = tasks.filter((t) => t.status === "running" || t.status === "waiting");
243
- if (runningTasks.length === 0) return { allStale: false, staleTaskIds: [] };
244
- const staleTaskIds: string[] = [];
245
- for (const task of runningTasks) {
246
- if (isTaskHeartbeatStale(task, now)) {
247
- staleTaskIds.push(task.id);
248
- }
249
- }
250
- return {
251
- allStale: staleTaskIds.length === runningTasks.length,
252
- staleTaskIds,
253
- };
254
- }
255
-
256
- /**
257
- * Repair a stale run by marking it as failed and cancelling running tasks.
258
- */
259
- /**
260
- * E3/E1 (Round 15): Build a human-actionable error string for a stale-reconciled
261
- * task. Explains WHY the run was marked stale (the detected reason) and gives
262
- * concrete remediation, instead of the bare 'Stale run reconciled: <reason>'.
263
- * Now returns a structured CrewError (E012) so callers also get a machine-
264
- * readable code + help hint; `.message` carries the same rich text as before.
265
- */
266
- function buildStaleReconcileError(task: TeamTaskState, reason: string): Error {
267
- const heartbeatAgeSeconds = task.heartbeat?.lastSeenAt
268
- ? Math.round((Date.now() - new Date(task.heartbeat.lastSeenAt).getTime()) / 1000)
269
- : undefined;
270
- return errors.runStale(reason, heartbeatAgeSeconds);
271
- }
272
-
273
- function repairStaleRun(manifest: TeamRunManifest, tasks: TeamTaskState[], reason: string): TeamTaskState[] {
274
- const now = new Date().toISOString();
275
- const repairedTasks = tasks.map((task) => {
276
- if (task.status === "running" || task.status === "queued" || task.status === "waiting") {
277
- return {
278
- ...task,
279
- status: "cancelled" as const,
280
- finishedAt: now,
281
- // E3/E1 (Round 15): structured CrewError (E012) with code + help hint.
282
- error: buildStaleReconcileError(task, reason).message,
283
- };
284
- }
285
- return task;
286
- });
287
- // Update agent records so widget sees cancelled status immediately
288
- for (const task of repairedTasks) {
289
- try {
290
- upsertCrewAgent(manifest, recordFromTask(manifest, task, "scaffold"));
291
- } catch {
292
- /* non-critical */
293
- }
294
- }
295
- return repairedTasks;
296
- }
297
-
298
- /**
299
- * Three-phase stale run reconciliation.
300
- *
301
- * 1. Check if result already exists → use it
302
- * 2. Check PID liveness
303
- * 3. Dead PID → repair immediately; alive PID → only fail if stale > 24h
304
- *
305
- * NOTE: Callers must provide locking via withRunLock/withRunLockSync when
306
- * calling from contexts where concurrent reconciliation of the same runId
307
- * could occur (e.g., the auto-repair timer). The crash-recovery.ts caller
308
- * already provides this. The reconcileOrphanedTempWorkspaces caller handles
309
- * /tmp workspaces where concurrent access is a known benign race (separate
310
- * dirs, low consequence of redundant repair).
311
- */
312
- export function reconcileStaleRun(manifest: TeamRunManifest, tasks: TeamTaskState[], now = Date.now()): ReconcileResult {
313
- const runId = manifest.runId;
314
-
315
- // Preserve runs intentionally blocked on human plan approval. These are not
316
- // crashes even if the owning PID is gone — they are waiting for a decision.
317
- // Must short-circuit before Phase 1 (result check) and Phase 2 (PID liveness).
318
- if (isPlanApprovalPending(manifest)) {
319
- return {
320
- runId,
321
- verdict: "blocked_awaiting_approval",
322
- repaired: false,
323
- detail: "Plan approval is pending; blocked run is intentionally waiting and must not be stale-repaired",
324
- };
325
- }
326
-
327
- // Phase 1: Check if results already exist
328
- const phase1 = checkResultFile(manifest, tasks);
329
- if (phase1.found) {
330
- // checkResultFile sets manifest.status='completed' and saves it,
331
- // but we re-save to ensure the completed status is persisted
332
- // before returning (avoids TOCTOU where caller might re-read stale data)
333
- // NOTE (OPT-02): Remains sync — reconcileStaleRun is called from withRunLockSync in
334
- // crash-recovery.ts and from sync reconcileOrphanedTempWorkspaces; cannot await here.
335
- saveRunManifest(manifest);
336
- return {
337
- runId,
338
- verdict: "result_exists",
339
- repaired: false,
340
- detail: "All tasks already terminal — no repair needed",
341
- };
342
- }
343
-
344
- // Phase 2: Check PID liveness
345
- const pid = manifest.async?.pid;
346
- const pidStatus = checkPidLiveness(pid, manifest.stateRoot);
347
-
348
- if (pidStatus.detail === "no pid recorded") {
349
- // No async PID may be a foreground/live run. Preserve it if task heartbeat
350
- // or agent progress proves active work even when manifest.updatedAt is old.
351
- if (hasRecentActiveEvidence(tasks, now)) {
352
- return {
353
- runId,
354
- verdict: "no_status",
355
- repaired: false,
356
- detail: "No PID recorded, but recent task heartbeat/progress exists; not repairing",
357
- };
358
- }
359
- // No PID and no recent activity. If ALL running tasks have stale heartbeats
360
- // (beyond NO_PID_HEARTBEAT_STALE_MS = 5min), repair immediately — the worker
361
- // process is dead but we have no PID to check. This handles /tmp/ live-session
362
- // workspaces where agents exit without calling submit_result.
363
- // Merged with individual stale task check to avoid redundant duplicate checks.
364
- const { allStale, staleTaskIds } = getRunningTaskStaleness(tasks, now);
365
- if (allStale) {
366
- const repaired = repairStaleRun(manifest, tasks, "no_pid_heartbeat_stale");
367
- return {
368
- runId,
369
- verdict: "no_status",
370
- repaired: true,
371
- detail: `No PID; all running task heartbeats stale >${Math.round(NO_PID_HEARTBEAT_STALE_MS / 60_000)}min; repaired ${repaired.filter((t) => t.status === "cancelled").length} tasks`,
372
- repairedTasks: repaired,
373
- };
374
- }
375
- // Check for individually stale tasks even when not all are stale.
376
- // This handles the case where task A is healthy but task B is a zombie.
377
- // We repair only the zombie tasks, not the whole run.
378
- // NOTE: Individual stale task repair (this branch) is intentionally
379
- // separate from run-level repair (the allStale branch above). Both
380
- // paths can coexist — the allStale path cancels the entire run when
381
- // ALL tasks are zombies, while this path repairs only the zombie
382
- // subset when some tasks are still healthy.
383
- if (staleTaskIds.length > 0) {
384
- const repaired = repairStaleRun(manifest, tasks, "no_pid_individual_stale_task");
385
- // Only return the individually repaired tasks in detail
386
- return {
387
- runId,
388
- verdict: "no_status",
389
- repaired: true,
390
- detail: `No PID; ${staleTaskIds.length} individually stale task(s) repaired: ${staleTaskIds.join(", ")}`,
391
- repairedTasks: repaired.filter((t) => staleTaskIds.includes(t.id)),
392
- };
393
- }
394
- // Fall through: no recent activity but not all tasks stale enough yet.
395
- // Check the longer STALE_ALIVE_PID_MS threshold for very old runs.
396
- const updatedAt = new Date(manifest.updatedAt).getTime();
397
- if (Number.isFinite(updatedAt) && now - updatedAt > STALE_ALIVE_PID_MS) {
398
- const repaired = repairStaleRun(manifest, tasks, "no_pid_stale");
399
- return {
400
- runId,
401
- verdict: "no_status",
402
- repaired: true,
403
- detail: `No PID; stale ${Math.round((now - updatedAt) / 3600_000)}h; repaired ${repaired.filter((t) => t.status === "cancelled").length} tasks`,
404
- repairedTasks: repaired,
405
- };
406
- }
407
- return {
408
- runId,
409
- verdict: "no_status",
410
- repaired: false,
411
- detail: "No PID recorded; not stale enough to repair",
412
- };
413
- }
414
-
415
- // Phase 3: Evaluate staleness
416
- const staleness = evaluateStaleness(manifest, pidStatus.alive, now);
417
- if (!staleness.stale) {
418
- return {
419
- runId,
420
- verdict: "healthy",
421
- repaired: false,
422
- detail: `PID ${pid}: ${pidStatus.detail}, ${staleness.reason}`,
423
- };
424
- }
425
-
426
- // Repair
427
- const repaired = repairStaleRun(manifest, tasks, staleness.reason);
428
- return {
429
- runId,
430
- verdict: pidStatus.alive ? "pid_alive_stale" : "pid_dead",
431
- repaired: true,
432
- detail: `PID ${pid}: ${pidStatus.detail}; ${staleness.reason}; repaired ${repaired.filter((t) => t.status === "cancelled").length} tasks`,
433
- repairedTasks: repaired,
434
- };
435
- }
436
-
437
- /**
438
- * Result of orphaned temp workspace reconciliation.
439
- */
440
- export interface OrphanReconcileResult {
441
- /** Number of runs repaired (manifests cancelled). */
442
- repaired: number;
443
- /** Number of /tmp/pi-crew-* directories removed. */
444
- cleanedDirs: number;
445
- }
446
-
447
- /**
448
- * Scan /tmp (os.tmpdir()) for orphaned pi-crew-* workspaces and reconcile
449
- * any stale runs found. This catches runs created by tests or crashed sessions
450
- * that the per-CWD auto-repair timer would miss.
451
- *
452
- * When `cleanupOrphanedTempDirs` is not explicitly set to `false`, directories
453
- * older than 1 hour with no remaining running manifests are deleted after
454
- * their runs are reconciled.
455
- *
456
- * @returns Number of runs repaired and directories cleaned.
457
- */
458
- export function reconcileOrphanedTempWorkspaces(
459
- now = Date.now(),
460
- options?: {
461
- cleanupOrphanedTempDirs?: boolean;
462
- tmpDir?: string;
463
- scanBatchSize?: number;
464
- },
465
- ): OrphanReconcileResult {
466
- // Injectable tmpDir + scanBatchSize for deterministic unit testing
467
- // (Round 19: tests must not depend on global /tmp cleanliness; the
468
- // production ORPHAN_TEMP_SCAN_BATCH_SIZE cap could exclude a test's dir
469
- // when leftover dirs accumulate). Defaults remain os.tmpdir() + the cap.
470
- const tmpDir = options?.tmpDir ?? getSafeTempDir();
471
- if (!tmpDir) return { repaired: 0, cleanedDirs: 0 };
472
- let repaired = 0;
473
- let cleanedDirs = 0;
474
- try {
475
- const entries = fs.readdirSync(tmpDir, { withFileTypes: true });
476
- // Sort for deterministic order; cap to ORPHAN_TEMP_SCAN_BATCH_SIZE per
477
- // tick to avoid main-thread stalls when /tmp has thousands of
478
- // pi-crew-* dirs from past interrupted test runs.
479
- const scanBatch = options?.scanBatchSize ?? ORPHAN_TEMP_SCAN_BATCH_SIZE;
480
- const candidates = entries
481
- .filter((e) => e.isDirectory() && e.name.startsWith("pi-crew-"))
482
- .sort((a, b) => a.name.localeCompare(b.name))
483
- .slice(0, scanBatch);
484
- for (const entry of candidates) {
485
- if (!entry.isDirectory() || !entry.name.startsWith("pi-crew-")) continue;
486
- const workspaceDir = path.join(tmpDir, entry.name);
487
- const crewDir = path.join(workspaceDir, ".crew");
488
- if (!fs.existsSync(crewDir)) continue;
489
- const stateRunsDir = path.join(crewDir, "state", "runs");
490
- if (!fs.existsSync(stateRunsDir)) continue;
491
- let hasRunning = false;
492
- try {
493
- for (const runDir of fs.readdirSync(stateRunsDir)) {
494
- const manifestPath = path.join(stateRunsDir, runDir, "manifest.json");
495
- const tasksPath = path.join(stateRunsDir, runDir, "tasks.json");
496
- if (!fs.existsSync(manifestPath) || !fs.existsSync(tasksPath)) continue;
497
- try {
498
- const manifest: TeamRunManifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
499
- if (manifest.status !== "running") continue;
500
- const tasks: TeamTaskState[] = JSON.parse(fs.readFileSync(tasksPath, "utf-8"));
501
- const result = reconcileStaleRun(manifest, tasks, now);
502
- if (result.repaired && result.repairedTasks) {
503
- // Persist repaired tasks (atomic — temp+rename to survive mid-write crash)
504
- atomicWriteJson(tasksPath, result.repairedTasks);
505
- // Update manifest status
506
- const updated = {
507
- ...manifest,
508
- status: "cancelled" as const,
509
- updatedAt: new Date(now).toISOString(),
510
- summary: `Stale run reconciled: ${result.detail}`,
511
- };
512
- atomicWriteJson(manifestPath, updated);
513
- // Update agent records
514
- for (const task of result.repairedTasks) {
515
- try {
516
- upsertCrewAgent(updated, recordFromTask(updated, task, "scaffold"));
517
- } catch {
518
- /* non-critical */
519
- }
520
- }
521
- repaired++;
522
- }
523
- // Persist result_exists manifest status update
524
- if (result.verdict === "result_exists") {
525
- // checkResultFile (called by reconcileStaleRun at line 518)
526
- // already saved manifest.status='completed' at line 66.
527
- // No additional manifest write needed here — avoids TOCTOU
528
- // window between checkResultFile save and re-write.
529
- // Sync agent records (checkResultFile also does this but
530
- // we sync here for consistency)
531
- for (const task of tasks) {
532
- try {
533
- upsertCrewAgent(manifest, recordFromTask(manifest, task, "scaffold"));
534
- } catch {
535
- /* non-critical */
536
- }
537
- }
538
- }
539
- // If still running after reconciliation attempt, mark for dir-preserving
540
- if (result.verdict === "healthy" || (result.verdict === "no_status" && !result.repaired)) {
541
- hasRunning = true;
542
- }
543
- } catch (err) {
544
- // Log warning when skipping a directory due to error.
545
- // Note: manifestPath here refers to the variable defined in the
546
- // for loop at line 442 (outer scope of this catch block).
547
- const scanManifestPath = manifestPath;
548
- console.warn(`[stale-reconciler] Skipping manifest due to parse error: ${scanManifestPath}: ${err}`);
549
- }
550
- }
551
- } catch (err) {
552
- // Cannot determine running state — treat as if running to prevent
553
- // premature cleanup of a potentially active workspace.
554
- hasRunning = true;
555
- console.warn(`[stale-reconciler] Skipping unreadable runs dir: ${stateRunsDir}: ${err}`);
556
- }
557
-
558
- // Post-loop: check if this workspace dir can be cleaned up.
559
- // Eligible when cleanup is enabled, no running manifests remain, and
560
- // the directory is older than the age threshold.
561
- // Re-scan manifests to confirm no running runs remain BEFORE the
562
- // cleanup decision (fixes TOCTOU race where a manifest may have
563
- // transitioned from 'running' to 'completed' between the main loop
564
- // and this re-scan).
565
- //
566
- // TOCTOU fix: Create a sentinel file before the re-scan. New run
567
- // creation should check for this sentinel and refuse/wait if present.
568
- // Additionally, do a final check right before cleanup to catch any
569
- // new runs created between the re-scan and the cleanup decision.
570
- const sentinelPath = path.join(workspaceDir, ".cleanup-in-progress");
571
- let canCleanup = !hasRunning;
572
-
573
- // FIX: Capture dirAge BEFORE creating the sentinel file, because writing
574
- // .cleanup-in-progress inside workspaceDir updates its mtime, making the
575
- // directory appear fresh and defeating the age check.
576
- const cleanupEnabled = options?.cleanupOrphanedTempDirs !== false;
577
- let dirAge = 0;
578
- if (cleanupEnabled && !hasRunning) {
579
- try {
580
- const stat = fs.statSync(workspaceDir);
581
- dirAge = now - stat.mtimeMs;
582
- } catch {
583
- // Directory disappeared
584
- }
585
- }
586
- if (canCleanup) {
587
- // Create sentinel file before re-scan to signal cleanup in progress.
588
- // O_EXCL requires workspaceDir to exist — ensure it before writing.
589
- try {
590
- if (!fs.existsSync(workspaceDir)) {
591
- fs.mkdirSync(workspaceDir, { recursive: true });
592
- }
593
- // Atomic exclusive-create: reserve the sentinel (fails with EEXIST if
594
- // another cleanup is in progress), then fill it atomically. The brief
595
- // empty-file window is safe — the sentinel "exists" (correctly
596
- // signalling in-progress cleanup).
597
- const sentinelFd = fs.openSync(sentinelPath, "wx");
598
- fs.closeSync(sentinelFd);
599
- atomicWriteFile(sentinelPath, JSON.stringify({ startedAt: now }));
600
- } catch {
601
- // Sentinel already exists (another cleanup in progress) — skip
602
- canCleanup = false;
603
- }
604
- }
605
- if (canCleanup) {
606
- if (fs.existsSync(stateRunsDir)) {
607
- try {
608
- for (const runDir of fs.readdirSync(stateRunsDir)) {
609
- const manifestPath = path.join(stateRunsDir, runDir, "manifest.json");
610
- if (!fs.existsSync(manifestPath)) continue;
611
- let manifest: TeamRunManifest | undefined;
612
- try {
613
- manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
614
- } catch (err) {
615
- // Log warning when skipping a directory due to error
616
- console.warn(`[stale-reconciler] Skipping manifest due to parse error: ${manifestPath}: ${err}`);
617
- continue;
618
- }
619
- if (manifest?.status === "running") {
620
- canCleanup = false;
621
- break;
622
- }
623
- }
624
- } catch (err) {
625
- console.warn(`[stale-reconciler] Skipping unreadable runs dir: ${stateRunsDir}: ${err}`);
626
- }
627
- }
628
- }
629
- if (canCleanup) {
630
- if (dirAge > ORPHAN_TEMP_DIR_AGE_THRESHOLD_MS) {
631
- // Final check: re-verify no running manifests appeared since re-scan.
632
- let stillClean = true;
633
- if (fs.existsSync(stateRunsDir)) {
634
- try {
635
- for (const runDir of fs.readdirSync(stateRunsDir)) {
636
- const manifestPath = path.join(stateRunsDir, runDir, "manifest.json");
637
- if (!fs.existsSync(manifestPath)) continue;
638
- try {
639
- const manifest: TeamRunManifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
640
- if (manifest.status === "running") {
641
- stillClean = false;
642
- break;
643
- }
644
- } catch {
645
- /* skip on parse error */
646
- }
647
- }
648
- } catch {
649
- stillClean = false;
650
- }
651
- }
652
- if (stillClean) {
653
- fs.rmSync(workspaceDir, {
654
- recursive: true,
655
- force: true,
656
- });
657
- cleanedDirs++;
658
- }
659
- }
660
- // Clean up sentinel file regardless of outcome
661
- try {
662
- fs.unlinkSync(sentinelPath);
663
- } catch {
664
- /* ignore if already gone */
665
- }
666
- }
667
- }
668
- } catch {
669
- /* skip if tmpdir unreadable */
670
- }
671
- return { repaired, cleanedDirs };
672
- }
673
-
674
- function getSafeTempDir(): string | undefined {
675
- try {
676
- return fs.existsSync(os.tmpdir()) ? os.tmpdir() : undefined;
677
- } catch {
678
- return undefined;
679
- }
680
- }