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,491 +0,0 @@
1
- /**
2
- * Owned-process lifecycle abstraction (P0 item #3).
3
- *
4
- * Distilled and adapted from gajae-code's `runtime/process-lifecycle.ts`.
5
- *
6
- * Two complementary primitives:
7
- *
8
- * F1(a) {@link spawnOwnedProcess} / {@link OwnedProcess} — wraps a
9
- * `child_process.spawn` child with explicit ownership: escalating
10
- * (SIGTERM → grace → SIGKILL) teardown, idempotent `dispose()`, bounded
11
- * `awaitExit()`, abort-signal wiring, and postmortem registration so
12
- * an owned child can never outlive its owner.
13
- *
14
- * F1(b) {@link registerResourceOwner} — a generic postmortem registry for
15
- * NON-process resources (timers, sockets, Workers, VM contexts) with
16
- * `disposeAllOwners()` / `disposeOwner(name)`.
17
- *
18
- * ╔═══════════════════════════════════════════════════════════════════════════╗
19
- * ║ IMPORTANT — INCREMENTAL, NOT FULL MIGRATION ║
20
- * ║ pi-crew ALREADY has sophisticated kill logic in child-pi.ts ║
21
- * ║ (killProcessTree, escalating SIGTERM→grace→SIGKILL, hard-kill timer, ║
22
- * ║ post-exit stdio guard) and async-runner.ts does detached/setsid spawns. ║
23
- * ║ Those paths are NOT rewritten here. This module provides a clean ║
24
- * ║ ownership primitive for NEW code paths that need guaranteed teardown ║
25
- * ║ without re-implementing the escalation dance each time. ║
26
- * ╚═══════════════════════════════════════════════════════════════════════════╝
27
- *
28
- * Cross-platform: on Windows there is no SIGTERM; teardown uses
29
- * `taskkill /F /T /PID` escalation directly (force-kill the whole tree).
30
- * See `.crew/knowledge.md` gotchas: BSD/Windows signal handling differs.
31
- */
32
- import { type ChildProcess, type SpawnOptions, spawn } from "node:child_process";
33
- import { logInternalError } from "../utils/internal-error.ts";
34
-
35
- // ── tunables ──────────────────────────────────────────────────────────────────
36
-
37
- const DEFAULT_GRACEFUL_MS = 2_000;
38
- /** Hard cap on how long dispose() waits after SIGKILL before giving up, so a
39
- * wedged/unkillable child can never block shutdown forever. */
40
- const SIGKILL_REAP_CAP_MS = 2_000;
41
- /** After the root child exits on its own, how long to wait for the process
42
- * group to drain before deregistering. Clean servers drain immediately. */
43
- const ROOT_EXIT_DRAIN_MS = 250;
44
-
45
- const isPosix = process.platform !== "win32";
46
-
47
- const delay = (ms: number): Promise<void> =>
48
- new Promise((resolve) => {
49
- setTimeout(resolve, Math.max(0, ms));
50
- });
51
-
52
- /** Poll `predicate` until true or `timeoutMs` elapses. Returns the final value. */
53
- async function pollUntil(predicate: () => boolean, timeoutMs: number, intervalMs = 20): Promise<boolean> {
54
- if (predicate()) return true;
55
- const deadline = Date.now() + Math.max(0, timeoutMs);
56
- while (Date.now() < deadline) {
57
- await delay(Math.min(intervalMs, Math.max(0, deadline - Date.now())));
58
- if (predicate()) return true;
59
- }
60
- return predicate();
61
- }
62
-
63
- /** Whether a POSIX process group still has any member (zombies count as alive). */
64
- function groupAlive(pgid: number): boolean {
65
- try {
66
- process.kill(-pgid, 0);
67
- return true;
68
- } catch (err) {
69
- // EPERM => the group exists but we cannot signal it; treat as alive.
70
- return (err as NodeJS.ErrnoException).code === "EPERM";
71
- }
72
- }
73
-
74
- // ── F1(a) OwnedProcess ────────────────────────────────────────────────────────
75
-
76
- /** Options for {@link spawnOwnedProcess}. */
77
- export interface SpawnOwnedOptions {
78
- cwd?: string;
79
- env?: Record<string, string | undefined>;
80
- /** stdin mode passed through to the child. Defaults to `"ignore"`. */
81
- stdin?: "pipe" | "ignore";
82
- /** When aborted, the owned process tree is disposed (escalating kill). */
83
- signal?: AbortSignal;
84
- /** Grace period (ms) between SIGTERM and SIGKILL on dispose. Default 2000. */
85
- gracefulMs?: number;
86
- /**
87
- * Spawn the child as its own process-group leader so the whole descendant
88
- * tree can be signalled on dispose. Defaults to `true` on POSIX. Has no
89
- * effect on Windows, where teardown falls back to single-process kill.
90
- */
91
- processGroup?: boolean;
92
- /** Label used in diagnostics. */
93
- name?: string;
94
- /** Extra SpawnOptions merged in (e.g. windowsHide). */
95
- extraOptions?: SpawnOptions;
96
- }
97
-
98
- /** Result of a bounded {@link OwnedProcess.awaitExit}. */
99
- export interface AwaitExitResult {
100
- /** `true` when the process has exited; `false` when the timeout fired first. */
101
- exited: boolean;
102
- /** Exit code if known, else `null`. */
103
- code: number | null;
104
- }
105
-
106
- /** Exit callback signature for {@link OwnedProcess.onExit}. */
107
- export type OwnedExitCallback = (code: number | null, signal: NodeJS.Signals | null) => void;
108
-
109
- /**
110
- * A spawned child process owned by the runtime with guaranteed teardown.
111
- *
112
- * Implemented as a class so callers retain a strong handle and so `dispose()`
113
- * can be idempotent (concurrent/repeated calls return the same in-flight
114
- * promise). Never throws from `dispose()` / `awaitExit()`.
115
- */
116
- export class OwnedProcess {
117
- readonly child: ChildProcess;
118
- readonly pid: number | undefined;
119
- /** Process-group id (POSIX detached only); `undefined` on Windows / opt-out. */
120
- readonly pgid: number | undefined;
121
- private readonly gracefulMs: number;
122
- private readonly name: string | undefined;
123
- private disposed = false;
124
- private disposePromise: Promise<void> | undefined;
125
- private deregistered = false;
126
- /** Terminal once teardown/reconciliation has confirmed the group is gone. */
127
- private terminated = false;
128
- private exitPromise: Promise<{
129
- code: number | null;
130
- signal: NodeJS.Signals | null;
131
- }>;
132
- private exitCallbacks = new Set<OwnedExitCallback>();
133
- private onAbort: (() => void) | undefined;
134
- private readonly abortSignal: AbortSignal | undefined;
135
-
136
- constructor(child: ChildProcess, opts: SpawnOwnedOptions, registerSelf: (owner: OwnedProcess) => () => void) {
137
- this.child = child;
138
- this.pid = child.pid;
139
- this.gracefulMs = opts.gracefulMs ?? DEFAULT_GRACEFUL_MS;
140
- this.name = opts.name;
141
- this.abortSignal = opts.signal;
142
-
143
- const useGroup = (opts.processGroup ?? true) && isPosix;
144
- // On POSIX with `detached`, the child is its own process-group leader,
145
- // so the group id equals its pid.
146
- this.pgid = useGroup ? child.pid : undefined;
147
-
148
- this.exitPromise = new Promise((resolve) => {
149
- child.once("exit", (code, signal) => {
150
- resolve({ code: code, signal: signal });
151
- for (const cb of this.exitCallbacks) {
152
- try {
153
- cb(code, signal);
154
- } catch (err) {
155
- logInternalError("owned-process.onExit-callback", err, this.name ? `name=${this.name}` : undefined);
156
- }
157
- }
158
- });
159
- });
160
-
161
- // Register for postmortem cleanup and wire abort.
162
- const deregister = registerSelf(this);
163
- this.deregisterFn = deregister;
164
-
165
- // When the root exits on its own (not via dispose), reconcile ownership
166
- // by the *group*: after a short drain window, deregister if the group is
167
- // empty, otherwise reap the owned group (no child outlives its owner).
168
- void this.exitPromise
169
- .then(() => {
170
- if (this.disposed) return; // dispose() owns deregistration
171
- if (this.pgid === undefined) {
172
- this.deregisterInternal();
173
- return;
174
- }
175
- void (async () => {
176
- const drained = await pollUntil(() => !groupAlive(this.pgid!), ROOT_EXIT_DRAIN_MS);
177
- if (this.disposed) return;
178
- if (drained) {
179
- this.deregisterInternal();
180
- return;
181
- }
182
- // Root exited but the owned group still has descendants: reap them.
183
- await this.dispose();
184
- })();
185
- })
186
- .catch(() => undefined);
187
-
188
- if (this.abortSignal) {
189
- if (this.abortSignal.aborted) {
190
- void this.dispose();
191
- } else {
192
- this.onAbort = () => void this.dispose();
193
- this.abortSignal.addEventListener("abort", this.onAbort, {
194
- once: true,
195
- });
196
- }
197
- }
198
- }
199
-
200
- private deregisterFn: () => void = () => {};
201
-
202
- /** `true` once `dispose()` has started. */
203
- get isDisposed(): boolean {
204
- return this.disposed;
205
- }
206
-
207
- /**
208
- * Register a callback invoked exactly once when the root child exits.
209
- * If the child has already exited, the callback is invoked synchronously
210
- * with the cached exit info. Returns an unsubscribe function.
211
- */
212
- onExit(callback: OwnedExitCallback): () => void {
213
- this.exitCallbacks.add(callback);
214
- // If already exited, the exitPromise is resolved; fire immediately.
215
- // We race to detect resolution without awaiting.
216
- let settled = false;
217
- this.exitPromise.then((info) => {
218
- if (settled) return; // callback may have been removed
219
- if (this.exitCallbacks.has(callback)) {
220
- try {
221
- callback(info.code, info.signal);
222
- } catch (err) {
223
- logInternalError("owned-process.onExit-immediate", err, this.name ? `name=${this.name}` : undefined);
224
- }
225
- }
226
- });
227
- return () => {
228
- settled = true;
229
- this.exitCallbacks.delete(callback);
230
- };
231
- }
232
-
233
- /**
234
- * Wait for the root child to exit, optionally bounded by `timeoutMs`.
235
- * With no timeout it resolves only when the child exits. Never rejects.
236
- */
237
- async awaitExit(opts?: { timeoutMs?: number }): Promise<AwaitExitResult> {
238
- const exitResult = this.exitPromise.then((info) => ({
239
- exited: true as const,
240
- code: info.code,
241
- }));
242
- if (opts?.timeoutMs === undefined) return exitResult;
243
- let timer: ReturnType<typeof setTimeout> | undefined;
244
- const timeout = new Promise<AwaitExitResult>((resolve) => {
245
- timer = setTimeout(() => resolve({ exited: false, code: this.child.exitCode }), Math.max(0, opts.timeoutMs!));
246
- });
247
- try {
248
- return await Promise.race([exitResult, timeout]);
249
- } finally {
250
- if (timer) clearTimeout(timer);
251
- }
252
- }
253
-
254
- /** Signal the process tree with `signal` (group-aware on POSIX). */
255
- private signalTree(signal: NodeJS.Signals): void {
256
- const pid = this.child.pid;
257
- if (pid === undefined) return;
258
- if (this.pgid !== undefined) {
259
- try {
260
- process.kill(-this.pgid, signal);
261
- return;
262
- } catch {
263
- /* group already gone */
264
- }
265
- return;
266
- }
267
- try {
268
- this.child.kill(signal);
269
- } catch {
270
- /* already gone */
271
- }
272
- }
273
-
274
- private deregisterInternal(): void {
275
- if (this.deregistered) return;
276
- this.deregistered = true;
277
- this.terminated = true;
278
- this.deregisterFn();
279
- if (this.onAbort && this.abortSignal) {
280
- this.abortSignal.removeEventListener("abort", this.onAbort);
281
- this.onAbort = undefined;
282
- }
283
- }
284
-
285
- /**
286
- * Idempotently terminate the owned process *group*: SIGTERM the group, wait
287
- * `gracefulMs`, then SIGKILL, polling liveness throughout. On Windows,
288
- * escalate directly to taskkill /F /T /PID. Removes the abort listener and
289
- * deregisters from the live-owner set only after teardown has completed.
290
- * Repeated/concurrent calls return the same in-flight promise. Never throws.
291
- */
292
- dispose(): Promise<void> {
293
- // Already terminal: never re-probe a recycled pgid.
294
- if (this.terminated) {
295
- this.disposed = true;
296
- if (!this.disposePromise) this.disposePromise = Promise.resolve();
297
- return this.disposePromise;
298
- }
299
- if (this.disposePromise) return this.disposePromise;
300
- this.disposed = true;
301
- if (this.onAbort && this.abortSignal) {
302
- this.abortSignal.removeEventListener("abort", this.onAbort);
303
- this.onAbort = undefined;
304
- }
305
- this.disposePromise = (async () => {
306
- try {
307
- if (!isPosix) {
308
- await this.disposeWindows();
309
- return;
310
- }
311
- if (this.pgid !== undefined) {
312
- // Group ownership: reap until the whole group is gone, even if
313
- // the root has already exited (it may have backgrounded children).
314
- if (!groupAlive(this.pgid)) return;
315
- this.signalTree("SIGTERM");
316
- if (await pollUntil(() => !groupAlive(this.pgid!), this.gracefulMs)) return;
317
- this.signalTree("SIGKILL");
318
- if (!(await pollUntil(() => !groupAlive(this.pgid!), SIGKILL_REAP_CAP_MS))) {
319
- console.warn(
320
- `[pi-crew] owned process group still alive after SIGKILL (name=${this.name ?? "?"}, pgid=${this.pgid})`,
321
- );
322
- }
323
- return;
324
- }
325
- // Single-process fallback (processGroup:false).
326
- if (this.child.exitCode !== null) return;
327
- this.signalTree("SIGTERM");
328
- if ((await this.awaitExit({ timeoutMs: this.gracefulMs })).exited) return;
329
- this.signalTree("SIGKILL");
330
- await this.awaitExit({ timeoutMs: SIGKILL_REAP_CAP_MS });
331
- } catch (err) {
332
- logInternalError("owned-process.dispose", err, this.name ? `name=${this.name}` : undefined);
333
- } finally {
334
- // Deregister only after teardown completes so a postmortem firing
335
- // mid-grace still sees the owner.
336
- this.deregisterInternal();
337
- }
338
- })();
339
- return this.disposePromise;
340
- }
341
-
342
- /** Windows teardown: no SIGTERM; escalate to taskkill /F /T /PID. */
343
- private async disposeWindows(): Promise<void> {
344
- const pid = this.child.pid;
345
- if (pid === undefined) return;
346
- if (this.child.exitCode !== null) return;
347
- // First try a graceful taskkill (no /F), then escalate to /F /T.
348
- const tryTaskkill = (force: boolean): Promise<void> =>
349
- new Promise((resolve) => {
350
- const args = ["/T", "/PID", String(pid), ...(force ? ["/F"] : [])];
351
- const tk = spawn("taskkill", args, {
352
- stdio: "ignore",
353
- windowsHide: true,
354
- });
355
- tk.on("error", () => resolve());
356
- tk.on("exit", () => resolve());
357
- });
358
- await tryTaskkill(false);
359
- if ((await this.awaitExit({ timeoutMs: this.gracefulMs })).exited) return;
360
- await tryTaskkill(true);
361
- await this.awaitExit({ timeoutMs: SIGKILL_REAP_CAP_MS });
362
- }
363
- }
364
-
365
- // ── live-owner set + postmortem ───────────────────────────────────────────────
366
-
367
- const liveOwners = new Set<OwnedProcess>();
368
- let ownedPostmortemRegistered = false;
369
-
370
- function ensureOwnedPostmortem(): void {
371
- if (ownedPostmortemRegistered) return;
372
- ownedPostmortemRegistered = true;
373
- // Register a process-exit handler that disposes every live owned process.
374
- // We wire both beforeExit (event-loop empty) and exit (synchronous final).
375
- const drain = async (): Promise<void> => {
376
- await Promise.all([...liveOwners].map((owner) => owner.dispose().catch(() => undefined)));
377
- };
378
- process.once("beforeExit", () => {
379
- void drain().catch(() => undefined);
380
- });
381
- }
382
-
383
- /**
384
- * Spawn a child process owned by the runtime. The returned {@link OwnedProcess}
385
- * is registered for postmortem cleanup and tears down its whole process group
386
- * on dispose/abort.
387
- *
388
- * NOTE: this is for NEW ownership-scoped spawns. Do NOT use it to replace
389
- * child-pi.ts's runChildPi (which has its own battle-tested escalation logic)
390
- * or async-runner.ts's intentionally-detached background spawns.
391
- */
392
- export function spawnOwnedProcess(command: string, args: readonly string[] = [], opts: SpawnOwnedOptions = {}): OwnedProcess {
393
- ensureOwnedPostmortem();
394
- const useGroup = (opts.processGroup ?? true) && isPosix;
395
- const spawnOpts: SpawnOptions = {
396
- cwd: opts.cwd,
397
- env: opts.env as NodeJS.ProcessEnv | undefined,
398
- stdio: [opts.stdin ?? "ignore", "pipe", "pipe"],
399
- detached: useGroup,
400
- windowsHide: true,
401
- ...opts.extraOptions,
402
- };
403
- const child = spawn(command, args as string[], spawnOpts);
404
- const owner = new OwnedProcess(child, opts, (self) => {
405
- liveOwners.add(self);
406
- return () => {
407
- liveOwners.delete(self);
408
- };
409
- });
410
- return owner;
411
- }
412
-
413
- /** Number of currently live owned processes. Exposed for leak assertions/tests. */
414
- export function liveOwnedProcessCount(): number {
415
- return liveOwners.size;
416
- }
417
-
418
- /** Dispose every live owned process. For owner-scoped teardown and tests. */
419
- export async function disposeAllOwnedProcesses(): Promise<void> {
420
- await Promise.all([...liveOwners].map((owner) => owner.dispose().catch(() => undefined)));
421
- }
422
-
423
- // ── F1(b) generic resource owners ─────────────────────────────────────────────
424
-
425
- type ResourceDisposer = () => void | Promise<void>;
426
-
427
- const resourceOwners = new Map<string, ResourceDisposer>();
428
- let resourcePostmortemRegistered = false;
429
-
430
- function ensureResourcePostmortem(): void {
431
- if (resourcePostmortemRegistered) return;
432
- resourcePostmortemRegistered = true;
433
- process.once("beforeExit", () => {
434
- void disposeAllOwners().catch(() => undefined);
435
- });
436
- }
437
-
438
- /**
439
- * Register a non-process resource for postmortem/fatal-exit cleanup.
440
- *
441
- * Idempotent by `name`: re-registering the same name replaces the prior
442
- * disposer (last wins). Returns an unregister function that removes the owner
443
- * only while it is still the active registration for that name.
444
- */
445
- export function registerResourceOwner(name: string, disposer: ResourceDisposer): () => void {
446
- resourceOwners.set(name, disposer);
447
- ensureResourcePostmortem();
448
- let unregistered = false;
449
- return () => {
450
- if (unregistered) return;
451
- unregistered = true;
452
- if (resourceOwners.get(name) === disposer) {
453
- resourceOwners.delete(name);
454
- }
455
- };
456
- }
457
-
458
- /** Number of registered resource owners. Exposed for leak assertions/tests. */
459
- export function resourceOwnerCount(): number {
460
- return resourceOwners.size;
461
- }
462
-
463
- /**
464
- * Run and clear every registered resource disposer. Attempts all disposers even
465
- * if some throw, then surfaces the failures as an `AggregateError` so callers
466
- * can distinguish "all closed" from "a resource may still be alive".
467
- */
468
- export async function disposeAllOwners(): Promise<void> {
469
- const disposers = [...resourceOwners.values()];
470
- resourceOwners.clear();
471
- const errors: unknown[] = [];
472
- for (const disposer of disposers) {
473
- try {
474
- await disposer();
475
- } catch (err) {
476
- errors.push(err);
477
- }
478
- }
479
- if (errors.length > 0) {
480
- throw new AggregateError(errors, `${errors.length} resource disposer(s) failed during teardown`);
481
- }
482
- }
483
-
484
- /** Dispose a single named resource owner. Returns true if it was registered. */
485
- export async function disposeOwner(name: string): Promise<boolean> {
486
- const disposer = resourceOwners.get(name);
487
- if (!disposer) return false;
488
- resourceOwners.delete(name);
489
- await disposer();
490
- return true;
491
- }
@@ -1,154 +0,0 @@
1
- import type { TeamRunManifest } from "../state/types.ts";
2
- import type { CrewAgentRecord } from "./crew-agent-runtime.ts";
3
-
4
- export { hasAsyncStartMarker } from "./async-marker.ts";
5
-
6
- export interface ProcessLiveness {
7
- pid?: number;
8
- alive: boolean;
9
- detail: string;
10
- }
11
-
12
- /**
13
- * How long (ms) a foreground team run with status "running" but no active agents
14
- * survives before being flagged as orphaned. Reduced from 10min to 2min to
15
- * improve UX: stuck foreground runs (e.g. planner with 0 tool calls) no longer
16
- * linger for 10min before the dashboard shows them as stale.
17
- */
18
- const ORPHANED_ACTIVE_RUN_MS = 2 * 60 * 1000;
19
- /** How long a completed run stays visible in the widget after completion. */
20
- const COMPLETED_VISIBILITY_GRACE_MS = 8_000;
21
- /** Errors (failed/cancelled) linger far longer so a failed run leaves a visible
22
- * trace in the crew widget for ~10 min (F-5). Successful completions vanish
23
- * quickly to keep the widget quiet. */
24
- const ERROR_VISIBILITY_GRACE_MS = 10 * 60 * 1000;
25
- /** Maximum age (ms) for an active run before it's considered stale.
26
- * After this time, PID-only liveness is unreliable due to PID recycling. */
27
- const STALE_ACTIVE_RUN_MS = 30 * 60 * 1000;
28
-
29
- export function checkProcessLiveness(pid: number | undefined): ProcessLiveness {
30
- if (pid === undefined || !Number.isInteger(pid) || pid <= 0) {
31
- return { pid, alive: false, detail: "no pid recorded" };
32
- }
33
- try {
34
- process.kill(pid, 0);
35
- return { pid, alive: true, detail: "process is alive" };
36
- } catch (error) {
37
- const nodeError = error as NodeJS.ErrnoException;
38
- if (nodeError.code === "EPERM")
39
- return {
40
- pid,
41
- alive: true,
42
- detail: "process exists but permission is denied",
43
- };
44
- if (nodeError.code === "ESRCH") return { pid, alive: false, detail: "process does not exist" };
45
- const message = error instanceof Error ? error.message : String(error);
46
- return { pid, alive: false, detail: message };
47
- }
48
- }
49
-
50
- export function isActiveRunStatus(status: string): boolean {
51
- return status === "queued" || status === "planning" || status === "running" || status === "waiting";
52
- }
53
-
54
- export function isFinishedRunStatus(status: string): boolean {
55
- return status === "completed" || status === "failed" || status === "cancelled" || status === "blocked";
56
- }
57
-
58
- /**
59
- * Secondary threshold: runs that have been "running" for more than this without
60
- * any active agents (all queued, no progress) are also considered orphaned.
61
- * This catches foreground team runs where the planner got stuck with 0 tool calls.
62
- */
63
- const ORPHANED_NO_PROGRESS_MS = 5 * 60 * 1000;
64
-
65
- export function isLikelyOrphanedActiveRun(
66
- run: TeamRunManifest,
67
- agents: CrewAgentRecord[] = [],
68
- now = Date.now(),
69
- staleMs = ORPHANED_ACTIVE_RUN_MS,
70
- ): boolean {
71
- if (!isActiveRunStatus(run.status)) return false;
72
- if (run.async?.pid !== undefined) return false;
73
- const updatedAt = new Date(run.updatedAt).getTime();
74
- if (!Number.isFinite(updatedAt)) return false;
75
-
76
- // Primary check: run hasn't been updated in a while
77
- if (now - updatedAt >= staleMs) {
78
- if (agents.length === 0) return run.summary === "Creating workflow prompts and placeholder results.";
79
- return agents.every((agent) => agent.status === "queued" && !agent.completedAt && !agent.progress);
80
- }
81
-
82
- // Secondary check: run has been running without any progress for too long
83
- if (now - updatedAt >= ORPHANED_NO_PROGRESS_MS) {
84
- // If no agent is "running" or has made progress, the run is likely stuck
85
- const hasActiveAgent = agents.some((agent) => agent.status === "running" || agent.progress || agent.toolUses);
86
- if (!hasActiveAgent && agents.length > 0) {
87
- return true;
88
- }
89
- }
90
-
91
- return false;
92
- }
93
-
94
- function hasDurableActiveAgentEvidence(agent: CrewAgentRecord): boolean {
95
- if (agent.status === "running") {
96
- // Running agents are actively executing — trust them.
97
- // Activity evidence is only required for queued agents (zombie prevention).
98
- return true;
99
- }
100
- if (agent.status === "queued") {
101
- // Queued agents need actual activity evidence to distinguish from zombies:
102
- // spawned-but-never-executed agents should not appear as active.
103
- return Boolean(
104
- (agent.progress && (agent.progress.toolCount > 0 || agent.progress.recentOutput.length > 0)) ||
105
- (agent.jsonEvents && agent.jsonEvents > 0) ||
106
- (agent.toolUses && agent.toolUses > 0),
107
- );
108
- }
109
- return false;
110
- }
111
-
112
- export function hasStaleAsyncProcess(run: TeamRunManifest, now = Date.now()): boolean {
113
- if (!isActiveRunStatus(run.status) || !run.async) return false;
114
- const pidAlive = checkProcessLiveness(run.async.pid).alive;
115
- if (!pidAlive) return true;
116
- // PID is alive, but check if the run is suspiciously old.
117
- // PID recycling means a stale PID could point to an unrelated process.
118
- const updatedAt = new Date(run.updatedAt).getTime();
119
- const age = now - updatedAt;
120
- if (Number.isFinite(updatedAt) && age > STALE_ACTIVE_RUN_MS) {
121
- // Additional evidence: if no agent has recent activity, treat as stale.
122
- // The real process would have updated the manifest within 30 minutes.
123
- return true;
124
- }
125
- return false;
126
- }
127
-
128
- export function isDisplayActiveRun(run: TeamRunManifest, agents: CrewAgentRecord[] = [], now = Date.now()): boolean {
129
- if (hasStaleAsyncProcess(run, now) || isLikelyOrphanedActiveRun(run, agents, now)) return false;
130
- // Hard filter: if an active-status run hasn't been updated in > STALE_ACTIVE_RUN_MS
131
- // and has no async PID tracking, it's a ghost from a crashed process.
132
- if (isActiveRunStatus(run.status) && !run.async) {
133
- const updatedAt = new Date(run.updatedAt).getTime();
134
- if (Number.isFinite(updatedAt) && now - updatedAt > STALE_ACTIVE_RUN_MS) return false;
135
- }
136
- // Grace period: show completed runs for a few seconds so users see the result.
137
- if (run.status === "completed" || run.status === "failed" || run.status === "cancelled") {
138
- const grace = run.status === "completed" ? COMPLETED_VISIBILITY_GRACE_MS : ERROR_VISIBILITY_GRACE_MS;
139
- const lastAgentActivity = agents.reduce<number>((max, agent) => {
140
- const ts = agent.completedAt ?? agent.startedAt;
141
- const parsed = ts ? new Date(ts).getTime() : 0;
142
- return Number.isFinite(parsed) && parsed > max ? parsed : max;
143
- }, new Date(run.updatedAt).getTime());
144
- if (Number.isFinite(lastAgentActivity) && now - lastAgentActivity < grace) return true;
145
- return false;
146
- }
147
- if (!isActiveRunStatus(run.status)) return false;
148
- // Keep the always-visible widget quiet until a worker actually exists.
149
- // Empty active manifests can be created briefly at startup, by old fixture/scaffold
150
- // runs, or from cross-cwd registry history; showing them causes noisy 0/0 rows and
151
- // needless spinner redraws. The full dashboard can still list historical runs.
152
- if (agents.length === 0) return false;
153
- return agents.some(hasDurableActiveAgentEvidence);
154
- }
@@ -1,44 +0,0 @@
1
- export interface ProgressEventSummary {
2
- eventType: string;
3
- currentTool?: string;
4
- toolCount?: number;
5
- tokens?: number;
6
- turns?: number;
7
- activityState?: string;
8
- lastActivityAt?: string;
9
- }
10
-
11
- export interface ProgressEventCoalesceDecision {
12
- shouldAppend: boolean;
13
- reason: string;
14
- }
15
-
16
- export interface ProgressEventCoalesceInput {
17
- previous?: ProgressEventSummary;
18
- next: ProgressEventSummary;
19
- nowMs: number;
20
- lastAppendMs?: number;
21
- minIntervalMs: number;
22
- force?: boolean;
23
- tokenThreshold?: number;
24
- }
25
-
26
- const DEFAULT_TOKEN_THRESHOLD = 256;
27
-
28
- function numericIncrease(previous: number | undefined, next: number | undefined): number {
29
- return next !== undefined && previous !== undefined ? next - previous : next !== undefined ? next : 0;
30
- }
31
-
32
- export function shouldAppendProgressEventUpdate(input: ProgressEventCoalesceInput): ProgressEventCoalesceDecision {
33
- if (input.force) return { shouldAppend: true, reason: "force" };
34
- if (!input.previous) return { shouldAppend: true, reason: "first" };
35
- if (input.previous.activityState !== input.next.activityState) return { shouldAppend: true, reason: "activity_changed" };
36
- if (input.previous.currentTool !== input.next.currentTool) return { shouldAppend: true, reason: "tool_changed" };
37
- if (numericIncrease(input.previous.toolCount, input.next.toolCount) > 0) return { shouldAppend: true, reason: "tool_count_increased" };
38
- if (numericIncrease(input.previous.turns, input.next.turns) > 0) return { shouldAppend: true, reason: "turns_increased" };
39
- const tokenIncrease = numericIncrease(input.previous.tokens, input.next.tokens);
40
- if (tokenIncrease >= (input.tokenThreshold ?? DEFAULT_TOKEN_THRESHOLD)) return { shouldAppend: true, reason: "tokens_increased" };
41
- if (input.lastAppendMs === undefined || input.nowMs - input.lastAppendMs >= input.minIntervalMs)
42
- return { shouldAppend: true, reason: "interval" };
43
- return { shouldAppend: false, reason: "coalesced" };
44
- }