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,1200 +0,0 @@
1
- import { execFile, execFileSync, spawnSync } from "node:child_process";
2
- import { randomBytes } from "node:crypto";
3
- import * as fs from "node:fs";
4
- import * as path from "node:path";
5
- import { promisify } from "node:util";
6
- import { loadConfig } from "../config/config.ts";
7
- import { DEFAULT_PATHS } from "../config/defaults.ts";
8
- import { writeArtifact } from "../state/artifact-store.ts";
9
- import type { TeamRunManifest, TeamTaskState } from "../state/types.ts";
10
- import { WINDOWS_ESSENTIAL_ENV_VARS } from "../utils/env-allowlist.ts";
11
- import { sanitizeEnvSecrets } from "../utils/env-filter.ts";
12
- import { logInternalError } from "../utils/internal-error.ts";
13
- import { projectCrewRoot } from "../utils/paths.ts";
14
-
15
- export interface PreparedTaskWorkspace {
16
- cwd: string;
17
- worktreePath?: string;
18
- branch?: string;
19
- reused?: boolean;
20
- nodeModulesLinked?: boolean;
21
- syntheticPaths?: string[];
22
- }
23
-
24
- const execFileAsync = promisify(execFile);
25
-
26
- export interface WorktreeDiffStat {
27
- filesChanged: number;
28
- insertions: number;
29
- deletions: number;
30
- diffStat: string;
31
- }
32
-
33
- function git(cwd: string, args: string[]): string {
34
- // SECURITY: PI_* and PI_CREW_* wildcards removed — they could match secret vars like PI_PASSWORD.
35
- // Git operations do not need PI_CREW_* execution-control vars.
36
- return execFileSync("git", args, {
37
- cwd,
38
- encoding: "utf-8",
39
- stdio: ["ignore", "pipe", "pipe"],
40
- env: {
41
- ...sanitizeEnvSecrets(process.env, {
42
- allowList: [
43
- "PATH",
44
- "HOME",
45
- "USER",
46
- ...WINDOWS_ESSENTIAL_ENV_VARS,
47
- "SHELL",
48
- "TERM",
49
- "LANG",
50
- "LC_ALL",
51
- "LC_COLLATE",
52
- "LC_CTYPE",
53
- "LC_MESSAGES",
54
- "XDG_CONFIG_HOME",
55
- "XDG_DATA_HOME",
56
- "XDG_CACHE_HOME",
57
- "NVM_BIN",
58
- "NVM_DIR",
59
- "NODE_PATH",
60
- "GIT_CONFIG_GLOBAL",
61
- "GIT_CONFIG_SYSTEM",
62
- "GIT_AUTHOR_NAME",
63
- "GIT_AUTHOR_EMAIL",
64
- "GIT_COMMITTER_NAME",
65
- "GIT_COMMITTER_EMAIL",
66
- ],
67
- }),
68
- LANG: "en_US.UTF-8",
69
- LC_ALL: "en_US.UTF-8",
70
- },
71
- windowsHide: true,
72
- }).trim();
73
- }
74
-
75
- /** Build the sanitized env object shared by all git operations. */
76
- function gitEnv(): Record<string, string> {
77
- return {
78
- ...sanitizeEnvSecrets(process.env, {
79
- allowList: [
80
- "PATH",
81
- "HOME",
82
- "USER",
83
- ...WINDOWS_ESSENTIAL_ENV_VARS,
84
- "SHELL",
85
- "TERM",
86
- "LANG",
87
- "LC_ALL",
88
- "LC_COLLATE",
89
- "LC_CTYPE",
90
- "LC_MESSAGES",
91
- "XDG_CONFIG_HOME",
92
- "XDG_DATA_HOME",
93
- "XDG_CACHE_HOME",
94
- "NVM_BIN",
95
- "NVM_DIR",
96
- "NODE_PATH",
97
- "GIT_CONFIG_GLOBAL",
98
- "GIT_CONFIG_SYSTEM",
99
- "GIT_AUTHOR_NAME",
100
- "GIT_AUTHOR_EMAIL",
101
- "GIT_COMMITTER_NAME",
102
- "GIT_COMMITTER_EMAIL",
103
- ],
104
- }),
105
- LANG: "en_US.UTF-8",
106
- LC_ALL: "en_US.UTF-8",
107
- };
108
- }
109
-
110
- async function gitAsync(cwd: string, args: string[]): Promise<string> {
111
- const { stdout } = await execFileAsync("git", args, {
112
- cwd,
113
- encoding: "utf-8",
114
- env: gitEnv(),
115
- windowsHide: true,
116
- });
117
- return stdout.trim();
118
- }
119
-
120
- // Dots are removed from branch names since they are used in path construction,
121
- // and dots could cause ambiguity with relative path handling on some platforms.
122
- // Branch names themselves support dots in git, but we strip them for safe path use.
123
- function sanitizeBranchPart(value: string): string {
124
- return (
125
- value
126
- .toLowerCase()
127
- .replace(/[^a-z0-9_/-]+/g, "-")
128
- .replace(/^-+|-+$/g, "") || "task"
129
- );
130
- }
131
-
132
- export function findGitRoot(cwd: string): string {
133
- return git(cwd, ["rev-parse", "--show-toplevel"]);
134
- }
135
-
136
- export function assertCleanLeader(repoRoot: string): void {
137
- // H-7 follow-up: --untracked-files=no so pi-crew's own auto-created .gitignore
138
- // (and any other untracked files the user hasn't staged) doesn't block worktree mode.
139
- // The worktree contract is "no tracked changes" — untracked files are safe since
140
- // they're either in .gitignore or the user can decide later.
141
- const status = git(repoRoot, ["status", "--porcelain", "--untracked-files=no"]);
142
- if (status.trim()) {
143
- throw new Error("Worktree mode requires a clean leader repository. Commit/stash changes or use workspaceMode: 'single'.");
144
- }
145
- }
146
-
147
- // --- Async versions ---
148
-
149
- /** Cache for findGitRoot results keyed by cwd. Cleared per-run. */
150
- const _gitRootCache = new Map<string, string>();
151
-
152
- /** Clear the findGitRoot cache. Call at the start of each team run. */
153
- export function clearGitRootCache(): void {
154
- _gitRootCache.clear();
155
- }
156
-
157
- export async function findGitRootAsync(cwd: string): Promise<string> {
158
- const cached = _gitRootCache.get(cwd);
159
- if (cached) return cached;
160
- const root = await gitAsync(cwd, ["rev-parse", "--show-toplevel"]);
161
- _gitRootCache.set(cwd, root);
162
- return root;
163
- }
164
-
165
- /** Cache for assertCleanLeader results keyed by repoRoot. Cleared per-run. */
166
- const _cleanLeaderCache = new Set<string>();
167
-
168
- /** Clear the assertCleanLeader cache. Call at the start of each team run. */
169
- export function clearCleanLeaderCache(): void {
170
- _cleanLeaderCache.clear();
171
- }
172
-
173
- export async function assertCleanLeaderAsync(repoRoot: string): Promise<void> {
174
- if (_cleanLeaderCache.has(repoRoot)) return;
175
- // H-7 follow-up: --untracked-files=no so pi-crew's own auto-created .gitignore
176
- // (and any other untracked files the user hasn't staged) doesn't block worktree mode.
177
- const status = await gitAsync(repoRoot, ["status", "--porcelain", "--untracked-files=no"]);
178
- if (status.trim()) {
179
- throw new Error("Worktree mode requires a clean leader repository. Commit/stash changes or use workspaceMode: 'single'.");
180
- }
181
- _cleanLeaderCache.add(repoRoot);
182
- }
183
-
184
- function linkNodeModulesIfPresent(repoRoot: string, worktreePath: string): boolean {
185
- const source = path.join(repoRoot, "node_modules");
186
- const target = path.join(worktreePath, "node_modules");
187
- let sourceStat: fs.Stats;
188
- try {
189
- sourceStat = fs.statSync(source);
190
- } catch {
191
- return false;
192
- }
193
- if (!sourceStat.isDirectory()) return false;
194
- if (fs.existsSync(target)) return false;
195
- // M5 fix: log symlink failure reason, especially on Windows non-admin.
196
- try {
197
- fs.symlinkSync(source, target, process.platform === "win32" ? "junction" : "dir");
198
- return true;
199
- } catch (error) {
200
- const isWindows = process.platform === "win32";
201
- logInternalError(
202
- "worktree.symlink-fail",
203
- error,
204
- isWindows ? "Windows non-admin: SeCreateSymbolicLinkPrivilege needed for node_modules symlink" : String(error),
205
- );
206
- return false;
207
- }
208
- }
209
-
210
- function normalizeSyntheticPath(worktreePath: string, rawPath: string): string {
211
- const resolved = path.resolve(worktreePath, rawPath);
212
- const relative = path.relative(worktreePath, resolved);
213
- if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`synthetic path escapes worktree: ${rawPath}`);
214
- return path.normalize(relative);
215
- }
216
-
217
- /**
218
- * Validates that a worktree setupHook script path is within an allowed directory.
219
- * Allowed paths:
220
- * - Relative paths starting with ".hooks/" (case-sensitive)
221
- * - Absolute paths under $HOME/.pi/hooks/
222
- * Rejects all other paths to prevent arbitrary script execution.
223
- * @param hookPath - The hook script path to validate
224
- * @returns true if the path is allowed, false otherwise
225
- */
226
- function isAllowedSetupHook(hookPath: string): boolean {
227
- if (!hookPath || hookPath.trim().length === 0) return false;
228
- if (!path.isAbsolute(hookPath)) {
229
- // Use path.posix.normalize for consistent forward-slash handling on all platforms.
230
- const normalized = path.posix.normalize(hookPath);
231
- return normalized === ".hooks" || normalized.startsWith(".hooks/");
232
- }
233
- // Normalize to forward slashes for consistent cross-platform comparison.
234
- const normalizedHookPath = hookPath.replace(/\\/g, "/");
235
- const homeHooksNormalized = (process.env.HOME ?? "").replace(/\\/g, "/") + "/.pi/hooks";
236
- return normalizedHookPath === homeHooksNormalized || normalizedHookPath.startsWith(homeHooksNormalized + "/");
237
- }
238
-
239
- /**
240
- * SECURITY: Verify a hook script path remains within the allowed directory after
241
- * real-path resolution. This prevents symlink-based escape where repoRoot is a
242
- * symlink and the hook path would resolve outside the repository.
243
- * @param repoRoot - The repository root (resolved to real path)
244
- * @param hookPath - The resolved absolute hook path
245
- * @returns true if the hook is safely contained within repoRoot
246
- */
247
- function isHookPathContainedInRepoRoot(repoRoot: string, hookPath: string): boolean {
248
- try {
249
- const realRepoRoot = fs.realpathSync(repoRoot);
250
- const realHookPath = fs.realpathSync(path.dirname(hookPath));
251
- return realHookPath.startsWith(realRepoRoot + path.sep) || realHookPath === realRepoRoot;
252
- } catch {
253
- return false;
254
- }
255
- }
256
-
257
- function runSetupHook(manifest: TeamRunManifest, task: TeamTaskState, repoRoot: string, worktreePath: string, branch: string): string[] {
258
- const cfg = loadConfig(manifest.cwd).config.worktree;
259
- if (!cfg?.setupHook) return [];
260
- const rawHookPath = cfg.setupHook;
261
- if (!isAllowedSetupHook(rawHookPath)) {
262
- logInternalError("worktree.setupHook.rejected", new Error("hook path not allowed: " + rawHookPath), `cwd=${manifest.cwd}`);
263
- return [];
264
- }
265
- // SECURITY WARNING: Home directory hooks (~/.pi/hooks/) are user-writable and not project-scoped.
266
- // A rogue npm postinstall script could place malicious hooks there. Log for visibility.
267
- //
268
- // SECURITY ASSUMPTION: This function trusts that the hook scripts themselves are not malicious.
269
- // Hook scripts are executed with the same privileges as the Pi process. The caller is responsible
270
- // for ensuring that only trusted hook scripts are configured. Path containment validation
271
- // (isAllowedSetupHook, isHookPathContainedInRepoRoot) prevents hook scripts from writing outside
272
- // the worktree, but cannot prevent a trusted hook from performing harmful operations within it.
273
- if (path.isAbsolute(rawHookPath)) {
274
- logInternalError(
275
- "worktree.setupHook.homeHook",
276
- new Error("Home directory hook used — ensure ~/.pi/hooks/ is trusted"),
277
- `hookPath=${rawHookPath}`,
278
- );
279
- }
280
- const hookPath = path.isAbsolute(rawHookPath) ? rawHookPath : path.resolve(repoRoot, rawHookPath);
281
- // SECURITY: Verify the resolved hook path is contained within the real repoRoot.
282
- // This prevents symlink-based escape where repoRoot is a symlink.
283
- if (!path.isAbsolute(rawHookPath) && !isHookPathContainedInRepoRoot(repoRoot, hookPath)) {
284
- logInternalError(
285
- "worktree.setupHook.contained",
286
- new Error("hook path escapes repoRoot after realpath resolution: " + hookPath),
287
- `repoRoot=${repoRoot}`,
288
- );
289
- return [];
290
- }
291
- try {
292
- const hookStat = fs.lstatSync(hookPath);
293
- if (!hookStat.isFile()) {
294
- logInternalError("worktree.setupHook.missing", new Error("hook not found or is directory: " + hookPath), `cwd=${manifest.cwd}`);
295
- return [];
296
- }
297
- } catch {
298
- logInternalError("worktree.setupHook.missing", new Error("hook not found: " + hookPath), `cwd=${manifest.cwd}`);
299
- return [];
300
- }
301
- const nodeHook = hookPath.endsWith(".js") || hookPath.endsWith(".cjs") || hookPath.endsWith(".mjs");
302
- // For .bat/.cmd files on Windows, execute via cmd.exe /c directly
303
- const isBatchFile = hookPath.endsWith(".bat") || hookPath.endsWith(".cmd");
304
- // SECURITY: Never use shell:true — prevents command injection from untrusted hooks.
305
- // Non-node, non-batch hooks on Windows will fail to execute rather than
306
- // running through a shell that could interpret malicious filenames.
307
- const useShell = false;
308
- if (process.platform === "win32" && !nodeHook && !isBatchFile) {
309
- logInternalError(
310
- "worktree.setupHook.windowsNoShell",
311
- new Error("Non-node, non-batch hook skipped on Windows (shell:true disabled for security)"),
312
- `hook=${hookPath}`,
313
- );
314
- }
315
- // SECURITY: Resolve the hook to its real path before execution to close the TOCTOU window.
316
- // This prevents a symlink swap between the containment check and actual execution.
317
- // KNOWN LIMITATION: There is a residual TOCTOU window between realpathSync validation
318
- // (line 166) and spawnSync execution (line 183). A sufficiently fast attacker could
319
- // theoretically swap the symlink between these two operations. The realpathSync + O_NOFOLLOW
320
- // approach minimizes but does not eliminate this window. To fully close it, consider
321
- // opening the hook file once via a file descriptor and executing via fd passing (not available
322
- // in Node.js spawnSync). This is documented as a known limitation rather than a bug.
323
- let realHookPath: string;
324
- try {
325
- realHookPath = fs.realpathSync(hookPath);
326
- } catch {
327
- logInternalError("worktree.setupHook.realpath", new Error("hook realpath resolution failed: " + hookPath), `cwd=${manifest.cwd}`);
328
- return [];
329
- }
330
- const result = isBatchFile
331
- ? spawnSync("cmd.exe", ["/c", realHookPath], {
332
- cwd: worktreePath,
333
- encoding: "utf-8",
334
- input: JSON.stringify({
335
- version: 1,
336
- repoRoot,
337
- worktreePath,
338
- agentCwd: worktreePath,
339
- branch,
340
- runId: manifest.runId,
341
- taskId: task.id,
342
- agent: task.agent,
343
- }),
344
- timeout: cfg.setupHookTimeoutMs ?? 30_000,
345
- shell: false, // cmd.exe /c handles batch files safely
346
- env: sanitizeEnvSecrets(process.env, {
347
- allowList: ["PATH", "HOME", ...WINDOWS_ESSENTIAL_ENV_VARS, "TMPDIR", "LANG", "LC_ALL"],
348
- }),
349
- windowsHide: true,
350
- })
351
- : spawnSync(nodeHook ? process.execPath : realHookPath, nodeHook ? [realHookPath] : [], {
352
- cwd: worktreePath,
353
- encoding: "utf-8",
354
- input: JSON.stringify({
355
- version: 1,
356
- repoRoot,
357
- worktreePath,
358
- agentCwd: worktreePath,
359
- branch,
360
- runId: manifest.runId,
361
- taskId: task.id,
362
- agent: task.agent,
363
- }),
364
- timeout: cfg.setupHookTimeoutMs ?? 30_000,
365
- shell: false,
366
- env: sanitizeEnvSecrets(process.env, {
367
- allowList: ["PATH", "HOME", ...WINDOWS_ESSENTIAL_ENV_VARS, "TMPDIR", "LANG", "LC_ALL"],
368
- }),
369
- windowsHide: true,
370
- });
371
- if (result.error) throw new Error(`worktree setup hook failed: ${result.error.message}`);
372
- if (result.status !== 0)
373
- throw new Error(`worktree setup hook failed with exit code ${result.status}: ${result.stderr || result.stdout || "no output"}`);
374
- const trimmed = result.stdout.trim();
375
- if (!trimmed) return [];
376
- try {
377
- // Extract JSON — hooks may output debug logging before JSON.
378
- // M4 fix: try full trimmed (multi-line JSON object) before falling back to last line.
379
- const lines = trimmed.split(/\r?\n/);
380
- let parsed: { syntheticPaths?: unknown } | null = null;
381
- try {
382
- parsed = JSON.parse(trimmed) as { syntheticPaths?: unknown };
383
- } catch {
384
- /* fall through — try last line */
385
- }
386
- if (!parsed && lines.length > 0) {
387
- const lastLine = lines[lines.length - 1];
388
- try {
389
- parsed = JSON.parse(lastLine) as { syntheticPaths?: unknown };
390
- } catch {
391
- /* give up */
392
- }
393
- }
394
- if (!parsed || !Array.isArray(parsed.syntheticPaths)) return [];
395
- return [
396
- ...new Set(
397
- parsed.syntheticPaths
398
- .filter((entry): entry is string => typeof entry === "string")
399
- .map((entry) => normalizeSyntheticPath(worktreePath, entry)),
400
- ),
401
- ];
402
- } catch (error) {
403
- logInternalError("worktree.setupHook.parse", error, `lastLine=${(trimmed.split(/\r?\n/).pop() ?? "").slice(0, 200)}`);
404
- return [];
405
- }
406
- }
407
-
408
- function branchExists(repoRoot: string, branch: string): { local: boolean; remoteOnly: boolean } {
409
- let local = false;
410
- try {
411
- git(repoRoot, ["rev-parse", "--verify", `refs/heads/${branch}`]);
412
- local = true;
413
- } catch {}
414
- if (local) return { local: true, remoteOnly: false };
415
- // Check remote-tracking branch
416
- try {
417
- const out = execFileSync("git", ["for-each-ref", "--format=%(refname)", `refs/remotes/*/${branch}`], {
418
- cwd: repoRoot,
419
- encoding: "utf-8",
420
- stdio: ["ignore", "pipe", "pipe"],
421
- windowsHide: true,
422
- }).trim();
423
- return { local: false, remoteOnly: out.length > 0 };
424
- } catch {
425
- return { local: false, remoteOnly: false };
426
- }
427
- }
428
-
429
- function pruneStaleWorktrees(repoRoot: string): void {
430
- try {
431
- execFileSync("git", ["worktree", "prune"], {
432
- cwd: repoRoot,
433
- stdio: "ignore",
434
- });
435
- } catch {
436
- /* best-effort */
437
- }
438
- }
439
-
440
- async function branchExistsAsync(repoRoot: string, branch: string): Promise<{ local: boolean; remoteOnly: boolean }> {
441
- let local = false;
442
- try {
443
- await gitAsync(repoRoot, ["rev-parse", "--verify", `refs/heads/${branch}`]);
444
- local = true;
445
- } catch {}
446
- if (local) return { local: true, remoteOnly: false };
447
- // Check remote-tracking branch
448
- try {
449
- const out = (
450
- await execFileAsync("git", ["for-each-ref", "--format=%(refname)", `refs/remotes/*/${branch}`], {
451
- cwd: repoRoot,
452
- encoding: "utf-8",
453
- windowsHide: true,
454
- })
455
- ).stdout.trim();
456
- return { local: false, remoteOnly: out.length > 0 };
457
- } catch {
458
- return { local: false, remoteOnly: false };
459
- }
460
- }
461
-
462
- async function pruneStaleWorktreesAsync(repoRoot: string): Promise<void> {
463
- try {
464
- await execFileAsync("git", ["worktree", "prune"], {
465
- cwd: repoRoot,
466
- windowsHide: true,
467
- });
468
- } catch {
469
- /* best-effort */
470
- }
471
- }
472
-
473
- /**
474
- * Normalize and validate seed paths — ensure all paths stay within repoRoot.
475
- * Rejects path traversal (../) and absolute paths.
476
- */
477
- export function normalizeSeedPaths(seedPaths: string[], repoRoot: string): string[] {
478
- const resolvedRepoRoot = path.resolve(repoRoot);
479
- const entries = Array.isArray(seedPaths) ? seedPaths : [];
480
- const seen = new Set<string>();
481
- const normalized: string[] = [];
482
-
483
- for (const entry of entries) {
484
- if (typeof entry !== "string" || entry.trim().length === 0) continue;
485
-
486
- const absolutePath = path.resolve(resolvedRepoRoot, entry);
487
- const relativePath = path.relative(resolvedRepoRoot, absolutePath);
488
-
489
- if (relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
490
- throw new Error(`seedPaths entries must stay inside repoRoot: ${entry}`);
491
- }
492
-
493
- // Reject symlinks to prevent escape via symlink-based path traversal.
494
- // This check is also performed in overlaySeedPaths for defense-in-depth.
495
- // ENOENT is acceptable — seed paths may reference files that don't exist yet
496
- // (they are validated at copy time by overlaySeedPaths).
497
- try {
498
- const stat = fs.lstatSync(absolutePath);
499
- if (stat.isSymbolicLink()) {
500
- throw new Error(`seedPaths entries cannot be symlinks: ${entry}`);
501
- }
502
- } catch (error) {
503
- if (error instanceof Error && error.message.startsWith("seedPaths entries")) throw error;
504
- // ENOENT is acceptable — seed paths may reference files that don't exist yet.
505
- // Skip symlink check but still include the path in results.
506
- if (!(error instanceof Error && "code" in error && (error as NodeJS.ErrnoException).code === "ENOENT")) {
507
- throw new Error(`seedPaths entries must be accessible: ${entry}`);
508
- }
509
- }
510
-
511
- const normalizedPath = relativePath.split(path.sep).join("/");
512
- if (seen.has(normalizedPath)) continue;
513
- seen.add(normalizedPath);
514
- normalized.push(normalizedPath);
515
- }
516
-
517
- return normalized;
518
- }
519
-
520
- /**
521
- * Overlay seed paths from repoRoot into worktreePath.
522
- * Copies files and directories, creating parent dirs as needed.
523
- * Skips non-existent sources with logInternalError (non-fatal).
524
- */
525
- export function overlaySeedPaths(repoRoot: string, worktreePath: string, seedPaths: string[]): void {
526
- const normalized = normalizeSeedPaths(seedPaths, repoRoot);
527
-
528
- for (const seedPath of normalized) {
529
- const sourcePath = path.join(repoRoot, seedPath);
530
- const destinationPath = path.join(worktreePath, seedPath);
531
-
532
- let sourceStat: fs.Stats;
533
- try {
534
- sourceStat = fs.lstatSync(sourcePath);
535
- } catch {
536
- logInternalError("worktree.seedPaths.missing", new Error(`Seed path does not exist: ${seedPath}`));
537
- continue;
538
- }
539
- // Reject symlinks in seed paths to prevent copying symlinks into worktree (which could point outside repoRoot).
540
- if (sourceStat.isSymbolicLink()) {
541
- logInternalError("worktree.seedPaths.symlink", new Error(`Seed path is a symlink — rejected: ${seedPath}`));
542
- continue;
543
- }
544
- if (!sourceStat.isFile() && !sourceStat.isDirectory()) {
545
- logInternalError("worktree.seedPaths.invalid", new Error(`Seed path is neither file nor directory: ${seedPath}`));
546
- continue;
547
- }
548
-
549
- fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
550
- fs.rmSync(destinationPath, { force: true, recursive: true });
551
- fs.cpSync(sourcePath, destinationPath, {
552
- dereference: true,
553
- force: true,
554
- preserveTimestamps: true,
555
- recursive: true,
556
- });
557
- }
558
- }
559
-
560
- /**
561
- * Snapshot uncommitted work in a reused worktree to a recovery artifact BEFORE
562
- * discarding it, so the data is never silently lost. Captures tracked changes
563
- * (git diff HEAD) and inlines untracked file contents so the work can be
564
- * recovered via `git apply` / manual restore. Best-effort: a snapshot failure
565
- * only logs (it must not block the clean-slate reuse flow).
566
- */
567
- function snapshotDirtyWorktree(manifest: TeamRunManifest, task: TeamTaskState, worktreePath: string, dirtyStatus: string): boolean {
568
- try {
569
- const parts: string[] = [
570
- `# Worktree recovery snapshot`,
571
- `runId: ${manifest.runId} taskId: ${task.id} path: ${worktreePath}`,
572
- `capturedAt: ${new Date().toISOString()}`,
573
- "",
574
- ];
575
- let trackedDiff = "";
576
- try {
577
- trackedDiff = git(worktreePath, ["diff", "HEAD"]);
578
- } catch {
579
- trackedDiff = "";
580
- }
581
- if (trackedDiff.trim()) {
582
- parts.push("## Tracked changes (`git diff HEAD`)", "```diff", trackedDiff, "```", "");
583
- }
584
- for (const line of dirtyStatus.split("\n")) {
585
- if (!line.startsWith("?? ")) continue;
586
- // Strip the "?? " prefix and surrounding git quotes.
587
- const rel = line.slice(3).replace(/^"|"$/g, "");
588
- if (!rel) continue;
589
- try {
590
- const abs = path.join(worktreePath, rel);
591
- if (!fs.existsSync(abs) || fs.statSync(abs).isDirectory()) continue;
592
- const content = fs.readFileSync(abs, "utf-8");
593
- parts.push(`## Untracked file: ${rel}`, "```", content, "```", "");
594
- } catch {
595
- /* skip unreadable/unstat-able entry */
596
- }
597
- }
598
- writeArtifact(manifest.artifactsRoot, {
599
- kind: "diff",
600
- relativePath: `worktree-recovery/${task.id}-${Date.now()}.md`,
601
- content: parts.join("\n"),
602
- producer: "worktree-manager.snapshotDirtyWorktree",
603
- retention: "run",
604
- });
605
- return true;
606
- } catch (err) {
607
- logInternalError(
608
- "worktree.recovery.snapshotFailed",
609
- err instanceof Error ? err : new Error(String(err)),
610
- `runId=${manifest.runId}, taskId=${task.id}`,
611
- );
612
- return false;
613
- }
614
- }
615
-
616
- /**
617
- * Best-effort removal of a just-created worktree + its branch. Used when a
618
- * post-creation step (setup hook, node_modules link, seed overlay) fails, so
619
- * the run does not leak an orphaned worktree dir + branch that would block the
620
- * next run with an "already checked out" error.
621
- */
622
- function cleanupCreatedWorktree(repoRoot: string, worktreePath: string, branch: string): void {
623
- try {
624
- git(repoRoot, ["worktree", "remove", "--force", worktreePath]);
625
- } catch {
626
- try {
627
- if (fs.existsSync(worktreePath)) fs.rmSync(worktreePath, { recursive: true, force: true });
628
- } catch {
629
- /* best-effort */
630
- }
631
- }
632
- try {
633
- git(repoRoot, ["branch", "-D", branch]);
634
- } catch {
635
- /* best-effort */
636
- }
637
- }
638
-
639
- async function cleanupCreatedWorktreeAsync(repoRoot: string, worktreePath: string, branch: string): Promise<void> {
640
- try {
641
- await gitAsync(repoRoot, ["worktree", "remove", "--force", worktreePath]);
642
- } catch {
643
- try {
644
- if (fs.existsSync(worktreePath)) fs.rmSync(worktreePath, { recursive: true, force: true });
645
- } catch {
646
- /* best-effort */
647
- }
648
- }
649
- try {
650
- await gitAsync(repoRoot, ["branch", "-D", branch]);
651
- } catch {
652
- /* best-effort */
653
- }
654
- }
655
-
656
- export function prepareTaskWorkspace(manifest: TeamRunManifest, task: TeamTaskState, stepSeedPaths?: string[]): PreparedTaskWorkspace {
657
- if (manifest.workspaceMode !== "worktree") return { cwd: task.cwd };
658
- const repoRoot = findGitRoot(manifest.cwd);
659
- const loadedConfig = loadConfig(manifest.cwd);
660
- if (loadedConfig.config.requireCleanWorktreeLeader !== false) assertCleanLeader(repoRoot);
661
- const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
662
- const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
663
- fs.mkdirSync(worktreeRoot, { recursive: true });
664
- // Resolve through realpathSync.native to get long-name form on Windows.
665
- // git worktree uses long-name paths, so we must match. If .native fails,
666
- // fall back to non-native (preserves input form).
667
- let resolvedWorktreeRoot = worktreeRoot;
668
- try {
669
- const r = fs.realpathSync.native(worktreeRoot);
670
- resolvedWorktreeRoot = r.startsWith("\\\\?\\") ? r.slice(4) : r;
671
- } catch {
672
- try {
673
- resolvedWorktreeRoot = fs.realpathSync(worktreeRoot);
674
- } catch {
675
- /* keep as-is */
676
- }
677
- }
678
- const sanitizedTaskId = sanitizeBranchPart(task.id);
679
- const worktreePath = path.join(resolvedWorktreeRoot, sanitizedTaskId);
680
- const branch = `pi-crew/${sanitizeBranchPart(manifest.runId)}/${sanitizeBranchPart(task.id)}`;
681
- // Use `git worktree list --porcelain` to atomically verify the worktree exists.
682
- // This avoids a TOCTOU race between fs.existsSync and git branch verification.
683
- let worktreeExists = false;
684
- try {
685
- const worktreeList = git(repoRoot, ["worktree", "list", "--porcelain"]);
686
- // `git worktree list --porcelain` outputs "worktree /path" per entry.
687
- // We must compare against the path part (after "worktree ").
688
- // On Windows, git may return forward-slash long-name paths while
689
- // worktreePath uses short-name backslash form. Resolve both through
690
- // realpathSync.native (which always returns long-name on Windows)
691
- // for consistent comparison.
692
- const normalizedWtPath =
693
- process.platform === "win32"
694
- ? (() => {
695
- try {
696
- const r = fs.realpathSync.native(worktreePath);
697
- return r.startsWith("\\\\?\\") ? r.slice(4) : r;
698
- } catch {
699
- return worktreePath;
700
- }
701
- })()
702
- .replace(/\\/g, "/")
703
- .toLowerCase()
704
- : worktreePath;
705
- worktreeExists = worktreeList.split("\n").some((line) => {
706
- const trimmed = line.trim();
707
- const matchPath = trimmed.startsWith("worktree ") ? trimmed.slice(9) : trimmed;
708
- if (process.platform === "win32") {
709
- return matchPath.replace(/\\/g, "/").toLowerCase() === normalizedWtPath;
710
- }
711
- return matchPath === worktreePath;
712
- });
713
- } catch {
714
- worktreeExists = false;
715
- }
716
- if (worktreeExists) {
717
- let currentBranch: string;
718
- try {
719
- currentBranch = git(worktreePath, ["rev-parse", "--abbrev-ref", "HEAD"]);
720
- } catch (gitError) {
721
- throw new Error(
722
- `Existing worktree at ${worktreePath} is not a valid git repository; cannot verify branch: ${gitError instanceof Error ? gitError.message : String(gitError)}`,
723
- );
724
- }
725
- if (currentBranch !== branch) {
726
- throw new Error(`Existing worktree branch mismatch at ${worktreePath}: expected '${branch}', got '${currentBranch}'.`);
727
- }
728
- // Check for uncommitted changes from previous run before reusing
729
- const dirtyStatus = git(worktreePath, ["status", "--porcelain"]);
730
- if (dirtyStatus.trim()) {
731
- // Snapshot uncommitted work to a recovery artifact BEFORE discarding, so the
732
- // previous run's changes are never silently destroyed on reuse.
733
- const snapshotOk = snapshotDirtyWorktree(manifest, task, worktreePath, dirtyStatus);
734
- if (snapshotOk) {
735
- logInternalError(
736
- "worktree.reused.dirty",
737
- new Error(`Discarding uncommitted changes in reused worktree at ${worktreePath} (snapshot saved to artifacts)`),
738
- `runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
739
- );
740
- git(worktreePath, ["checkout", "--", "."]);
741
- git(worktreePath, ["clean", "-fd"]);
742
- } else {
743
- logInternalError(
744
- "worktree.reused.dirtyPreserved",
745
- new Error(
746
- `Snapshot failed — preserving dirty worktree at ${worktreePath} (skipping git checkout/clean to prevent data loss)`,
747
- ),
748
- `runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
749
- );
750
- }
751
- }
752
- // Overlay seed paths from config + step-level seedPaths (reused worktree)
753
- const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
754
- const mergedReused = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
755
- if (mergedReused.length > 0) {
756
- overlaySeedPaths(repoRoot, worktreePath, mergedReused);
757
- }
758
- // Re-validate leader is still clean before reusing — leader state may have changed since first preparation
759
- assertCleanLeader(repoRoot);
760
- return { cwd: worktreePath, worktreePath, branch, reused: true };
761
- }
762
- pruneStaleWorktrees(repoRoot);
763
- const exists = branchExists(repoRoot, branch);
764
- let worktreeCreated = false;
765
- try {
766
- if (exists.local) {
767
- git(repoRoot, ["worktree", "add", worktreePath, branch]);
768
- } else {
769
- if (exists.remoteOnly) {
770
- logInternalError(
771
- "worktree.branchRemoteOnly",
772
- new Error(`Branch '${branch}' exists only on remote; creating local from HEAD instead of tracking remote.`),
773
- `branch=${branch}`,
774
- );
775
- }
776
- git(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
777
- }
778
- worktreeCreated = true;
779
- } catch (error) {
780
- // Clean up orphaned worktree directory if git worktree add failed
781
- if (fs.existsSync(worktreePath)) {
782
- try {
783
- fs.rmSync(worktreePath, { recursive: true, force: true });
784
- } catch {
785
- /* best-effort cleanup */
786
- }
787
- }
788
- const msg = error instanceof Error ? error.message : String(error);
789
- if (/already checked out|is already used by worktree/i.test(msg)) {
790
- throw new Error(
791
- `Branch '${branch}' is checked out at another worktree. Run \`team cleanup runId=${manifest.runId} force=true\` or manually remove the conflicting worktree.`,
792
- );
793
- }
794
- throw error;
795
- }
796
- try {
797
- const syntheticPaths = runSetupHook(manifest, task, repoRoot, worktreePath, branch);
798
- const nodeModulesLinked =
799
- loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
800
- // Overlay seed paths from config + step-level seedPaths
801
- const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
802
- const merged = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
803
- if (merged.length > 0) {
804
- overlaySeedPaths(repoRoot, worktreePath, merged);
805
- }
806
- return {
807
- cwd: worktreePath,
808
- worktreePath,
809
- branch,
810
- reused: false,
811
- nodeModulesLinked,
812
- syntheticPaths,
813
- };
814
- } catch (setupError) {
815
- // Hook/link/seed failure AFTER worktree+branch creation: clean up to avoid
816
- // an orphaned worktree dir + branch that would block the next run.
817
- cleanupCreatedWorktree(repoRoot, worktreePath, branch);
818
- throw setupError;
819
- }
820
- }
821
-
822
- /** Async version of prepareTaskWorkspace — yields the event loop during git operations. */
823
- export async function prepareTaskWorkspaceAsync(
824
- manifest: TeamRunManifest,
825
- task: TeamTaskState,
826
- stepSeedPaths?: string[],
827
- ): Promise<PreparedTaskWorkspace> {
828
- if (manifest.workspaceMode !== "worktree") return { cwd: task.cwd };
829
- const repoRoot = await findGitRootAsync(manifest.cwd);
830
- const loadedConfig = loadConfig(manifest.cwd);
831
- if (loadedConfig.config.requireCleanWorktreeLeader !== false) await assertCleanLeaderAsync(repoRoot);
832
- const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
833
- const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
834
- fs.mkdirSync(worktreeRoot, { recursive: true });
835
- let resolvedWorktreeRoot = worktreeRoot;
836
- try {
837
- const r = fs.realpathSync.native(worktreeRoot);
838
- resolvedWorktreeRoot = r.startsWith("\\\\?\\") ? r.slice(4) : r;
839
- } catch {
840
- try {
841
- resolvedWorktreeRoot = fs.realpathSync(worktreeRoot);
842
- } catch {
843
- /* keep as-is */
844
- }
845
- }
846
- const sanitizedTaskId = sanitizeBranchPart(task.id);
847
- const worktreePath = path.join(resolvedWorktreeRoot, sanitizedTaskId);
848
- const branch = `pi-crew/${sanitizeBranchPart(manifest.runId)}/${sanitizeBranchPart(task.id)}`;
849
- let worktreeExists = false;
850
- try {
851
- const worktreeList = await gitAsync(repoRoot, ["worktree", "list", "--porcelain"]);
852
- const normalizedWtPath =
853
- process.platform === "win32"
854
- ? (() => {
855
- try {
856
- const r = fs.realpathSync.native(worktreePath);
857
- return r.startsWith("\\\\?\\") ? r.slice(4) : r;
858
- } catch {
859
- return worktreePath;
860
- }
861
- })()
862
- .replace(/\\/g, "/")
863
- .toLowerCase()
864
- : worktreePath;
865
- worktreeExists = worktreeList.split("\n").some((line) => {
866
- const trimmed = line.trim();
867
- const matchPath = trimmed.startsWith("worktree ") ? trimmed.slice(9) : trimmed;
868
- if (process.platform === "win32") {
869
- return matchPath.replace(/\\/g, "/").toLowerCase() === normalizedWtPath;
870
- }
871
- return matchPath === worktreePath;
872
- });
873
- } catch {
874
- worktreeExists = false;
875
- }
876
- if (worktreeExists) {
877
- let currentBranch: string;
878
- try {
879
- currentBranch = await gitAsync(worktreePath, ["rev-parse", "--abbrev-ref", "HEAD"]);
880
- } catch (gitError) {
881
- throw new Error(
882
- `Existing worktree at ${worktreePath} is not a valid git repository; cannot verify branch: ${gitError instanceof Error ? gitError.message : String(gitError)}`,
883
- );
884
- }
885
- if (currentBranch !== branch) {
886
- throw new Error(`Existing worktree branch mismatch at ${worktreePath}: expected '${branch}', got '${currentBranch}'.`);
887
- }
888
- const dirtyStatus = await gitAsync(worktreePath, ["status", "--porcelain"]);
889
- if (dirtyStatus.trim()) {
890
- const snapshotOk = snapshotDirtyWorktree(manifest, task, worktreePath, dirtyStatus);
891
- if (snapshotOk) {
892
- logInternalError(
893
- "worktree.reused.dirty",
894
- new Error(`Discarding uncommitted changes in reused worktree at ${worktreePath} (snapshot saved to artifacts)`),
895
- `runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
896
- );
897
- await gitAsync(worktreePath, ["checkout", "--", "."]);
898
- await gitAsync(worktreePath, ["clean", "-fd"]);
899
- } else {
900
- logInternalError(
901
- "worktree.reused.dirtyPreserved",
902
- new Error(
903
- `Snapshot failed — preserving dirty worktree at ${worktreePath} (skipping git checkout/clean to prevent data loss)`,
904
- ),
905
- `runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
906
- );
907
- }
908
- }
909
- const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
910
- const mergedReused = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
911
- if (mergedReused.length > 0) {
912
- overlaySeedPaths(repoRoot, worktreePath, mergedReused);
913
- }
914
- // Re-validate leader is still clean before reusing
915
- // Note: this intentionally skips the cache to re-check the live state.
916
- _cleanLeaderCache.delete(repoRoot);
917
- await assertCleanLeaderAsync(repoRoot);
918
- return { cwd: worktreePath, worktreePath, branch, reused: true };
919
- }
920
- await pruneStaleWorktreesAsync(repoRoot);
921
- const exists = await branchExistsAsync(repoRoot, branch);
922
- let worktreeCreated = false;
923
- try {
924
- if (exists.local) {
925
- await gitAsync(repoRoot, ["worktree", "add", worktreePath, branch]);
926
- } else {
927
- if (exists.remoteOnly) {
928
- logInternalError(
929
- "worktree.branchRemoteOnly",
930
- new Error(`Branch '${branch}' exists only on remote; creating local from HEAD instead of tracking remote.`),
931
- `branch=${branch}`,
932
- );
933
- }
934
- await gitAsync(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
935
- }
936
- worktreeCreated = true;
937
- } catch (error) {
938
- if (fs.existsSync(worktreePath)) {
939
- try {
940
- fs.rmSync(worktreePath, { recursive: true, force: true });
941
- } catch {
942
- /* best-effort cleanup */
943
- }
944
- }
945
- const msg = error instanceof Error ? error.message : String(error);
946
- if (/already checked out|is already used by worktree/i.test(msg)) {
947
- throw new Error(
948
- `Branch '${branch}' is checked out at another worktree. Run \`team cleanup runId=${manifest.runId} force=true\` or manually remove the conflicting worktree.`,
949
- );
950
- }
951
- throw error;
952
- }
953
- try {
954
- const syntheticPaths = runSetupHook(manifest, task, repoRoot, worktreePath, branch);
955
- const nodeModulesLinked =
956
- loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
957
- const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
958
- const merged = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
959
- if (merged.length > 0) {
960
- overlaySeedPaths(repoRoot, worktreePath, merged);
961
- }
962
- return {
963
- cwd: worktreePath,
964
- worktreePath,
965
- branch,
966
- reused: false,
967
- nodeModulesLinked,
968
- syntheticPaths,
969
- };
970
- } catch (setupError) {
971
- // Hook/link/seed failure AFTER worktree+branch creation: clean up to avoid
972
- // an orphaned worktree dir + branch that would block the next run.
973
- await cleanupCreatedWorktreeAsync(repoRoot, worktreePath, branch);
974
- throw setupError;
975
- }
976
- }
977
-
978
- export function captureWorktreeDiffStat(worktreePath: string): WorktreeDiffStat {
979
- try {
980
- const diffStat = git(worktreePath, ["diff", "--stat"]);
981
- const numstat = git(worktreePath, ["diff", "--numstat"]);
982
- let filesChanged = 0;
983
- let insertions = 0;
984
- let deletions = 0;
985
- for (const line of numstat.split(/\r?\n/).filter(Boolean)) {
986
- const [add, del] = line.split(/\s+/);
987
- filesChanged += 1;
988
- insertions += Number(add) || 0;
989
- deletions += Number(del) || 0;
990
- }
991
- return { filesChanged, insertions, deletions, diffStat };
992
- } catch {
993
- return { filesChanged: 0, insertions: 0, deletions: 0, diffStat: "" };
994
- }
995
- }
996
-
997
- export async function captureWorktreeDiffStatAsync(worktreePath: string): Promise<WorktreeDiffStat> {
998
- try {
999
- const diffStat = await gitAsync(worktreePath, ["diff", "--stat"]);
1000
- const numstat = await gitAsync(worktreePath, ["diff", "--numstat"]);
1001
- let filesChanged = 0;
1002
- let insertions = 0;
1003
- let deletions = 0;
1004
- for (const line of numstat.split(/\r?\n/).filter(Boolean)) {
1005
- const [add, del] = line.split(/\s+/);
1006
- filesChanged += 1;
1007
- insertions += Number(add) || 0;
1008
- deletions += Number(del) || 0;
1009
- }
1010
- return { filesChanged, insertions, deletions, diffStat };
1011
- } catch {
1012
- return { filesChanged: 0, insertions: 0, deletions: 0, diffStat: "" };
1013
- }
1014
- }
1015
-
1016
- export function captureWorktreeDiff(worktreePath: string): string {
1017
- try {
1018
- return git(worktreePath, ["diff", "--stat"]) + "\n\n" + git(worktreePath, ["diff"]);
1019
- } catch (error) {
1020
- const message = error instanceof Error ? error.message : String(error);
1021
- return `Failed to capture worktree diff: ${message}`;
1022
- }
1023
- }
1024
-
1025
- export async function captureWorktreeDiffAsync(worktreePath: string): Promise<string> {
1026
- try {
1027
- const [stat, full] = await Promise.all([gitAsync(worktreePath, ["diff", "--stat"]), gitAsync(worktreePath, ["diff"])]);
1028
- return stat + "\n\n" + full;
1029
- } catch (error) {
1030
- const message = error instanceof Error ? error.message : String(error);
1031
- return `Failed to capture worktree diff: ${message}`;
1032
- }
1033
- }
1034
-
1035
- /**
1036
- * round-17 P2-4: Create an isolated git worktree for a single DWF agent call.
1037
- *
1038
- * Lightweight — does NOT require a TeamTaskState and does NOT depend on
1039
- * `manifest.workspaceMode === "worktree"` (DWF manifests use `single`). It
1040
- * reuses the same internal helpers as `prepareTaskWorkspace` (git, findGitRoot,
1041
- * assertCleanLeader, pruneStaleWorktrees, sanitizeBranchPart,
1042
- * linkNodeModulesIfPresent) but with a minimal, task-free signature.
1043
- *
1044
- * Returns `undefined` when worktree creation is unavailable (no git repo, dirty
1045
- * leader, git error) so the caller (`ctx.agent`) can fall back gracefully.
1046
- */
1047
- export function prepareAgentWorktree(manifest: TeamRunManifest, agentId: string): PreparedTaskWorkspace | undefined {
1048
- try {
1049
- const repoRoot = findGitRoot(manifest.cwd);
1050
- const loadedConfig = loadConfig(manifest.cwd);
1051
- if (loadedConfig.config.requireCleanWorktreeLeader !== false) assertCleanLeader(repoRoot);
1052
- const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
1053
- const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
1054
- fs.mkdirSync(worktreeRoot, { recursive: true });
1055
- const sanitizedAgentId = sanitizeBranchPart(agentId);
1056
- const worktreePath = path.join(worktreeRoot, sanitizedAgentId);
1057
- const branch = `pi-crew/${sanitizedRunId}/${sanitizedAgentId}`;
1058
- pruneStaleWorktrees(repoRoot);
1059
- git(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
1060
- const nodeModulesLinked =
1061
- loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
1062
- return { cwd: worktreePath, worktreePath, branch, nodeModulesLinked };
1063
- } catch {
1064
- // Graceful fallback: no git repo, dirty leader, or git error → run normally.
1065
- return undefined;
1066
- }
1067
- }
1068
-
1069
- /** Async version of prepareAgentWorktree — yields the event loop during git operations. */
1070
- export async function prepareAgentWorktreeAsync(manifest: TeamRunManifest, agentId: string): Promise<PreparedTaskWorkspace | undefined> {
1071
- try {
1072
- const repoRoot = await findGitRootAsync(manifest.cwd);
1073
- const loadedConfig = loadConfig(manifest.cwd);
1074
- if (loadedConfig.config.requireCleanWorktreeLeader !== false) await assertCleanLeaderAsync(repoRoot);
1075
- const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
1076
- const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
1077
- fs.mkdirSync(worktreeRoot, { recursive: true });
1078
- const sanitizedAgentId = sanitizeBranchPart(agentId);
1079
- const worktreePath = path.join(worktreeRoot, sanitizedAgentId);
1080
- const branch = `pi-crew/${sanitizedRunId}/${sanitizedAgentId}`;
1081
- await pruneStaleWorktreesAsync(repoRoot);
1082
- await gitAsync(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
1083
- const nodeModulesLinked =
1084
- loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
1085
- return { cwd: worktreePath, worktreePath, branch, nodeModulesLinked };
1086
- } catch {
1087
- // Graceful fallback: no git repo, dirty leader, or git error → run normally.
1088
- return undefined;
1089
- }
1090
- }
1091
-
1092
- /**
1093
- * round-17 P2-4: Remove a DWF agent worktree after the agent completes.
1094
- *
1095
- * Captures the worktree diff as an artifact before removal (best-effort), then
1096
- * removes the worktree, deletes the ephemeral branch, and prunes stale refs.
1097
- * NEVER throws — cleanup failures are logged via `logInternalError` so a
1098
- * worktree/branch leak never crashes a workflow.
1099
- */
1100
- export function cleanupAgentWorktree(manifest: TeamRunManifest, worktreePath: string, branch?: string): void {
1101
- // Capture diff as artifact (best-effort).
1102
- try {
1103
- const diff = captureWorktreeDiff(worktreePath);
1104
- if (diff.trim() && !diff.startsWith("Failed to capture worktree diff")) {
1105
- writeArtifact(manifest.artifactsRoot, {
1106
- kind: "diff",
1107
- relativePath: `wf/worktree-diff-${Date.now()}-${randomBytes(2).toString("hex")}.diff`,
1108
- content: diff,
1109
- producer: "dynamic-workflow",
1110
- });
1111
- }
1112
- } catch (error) {
1113
- logInternalError("worktree.agent-cleanup.diff", error, `worktreePath=${worktreePath}`);
1114
- }
1115
- // Remove worktree (best-effort). Try git first, then fall back to fs.rm.
1116
- try {
1117
- const repoRoot = findGitRoot(manifest.cwd);
1118
- git(repoRoot, ["worktree", "remove", "--force", worktreePath]);
1119
- } catch (error) {
1120
- logInternalError("worktree.agent-cleanup.remove", error, `worktreePath=${worktreePath}`);
1121
- try {
1122
- fs.rmSync(worktreePath, { recursive: true, force: true });
1123
- } catch (rmError) {
1124
- logInternalError("worktree.agent-cleanup.rm", rmError, `worktreePath=${worktreePath}`);
1125
- }
1126
- }
1127
- // Delete the ephemeral agent branch (best-effort) to avoid accumulation across
1128
- // many agent calls. The diff is already captured above; the branch holds no value.
1129
- if (branch) {
1130
- try {
1131
- const repoRoot = findGitRoot(manifest.cwd);
1132
- git(repoRoot, ["branch", "-D", branch]);
1133
- } catch (error) {
1134
- logInternalError("worktree.agent-cleanup.branch", error, `branch=${branch}`);
1135
- }
1136
- }
1137
- // Prune stale worktree refs (best-effort).
1138
- try {
1139
- const repoRoot = findGitRoot(manifest.cwd);
1140
- git(repoRoot, ["worktree", "prune"]);
1141
- } catch (error) {
1142
- logInternalError("worktree.agent-cleanup.prune", error, `worktreePath=${worktreePath}`);
1143
- }
1144
- }
1145
-
1146
- /** Async version of cleanupAgentWorktree — caches findGitRoot and yields during git operations. */
1147
- export async function cleanupAgentWorktreeAsync(manifest: TeamRunManifest, worktreePath: string, branch?: string): Promise<void> {
1148
- // Capture diff as artifact (best-effort).
1149
- try {
1150
- const diff = await captureWorktreeDiffAsync(worktreePath);
1151
- if (diff.trim() && !diff.startsWith("Failed to capture worktree diff")) {
1152
- writeArtifact(manifest.artifactsRoot, {
1153
- kind: "diff",
1154
- relativePath: `wf/worktree-diff-${Date.now()}-${randomBytes(2).toString("hex")}.diff`,
1155
- content: diff,
1156
- producer: "dynamic-workflow",
1157
- });
1158
- }
1159
- } catch (error) {
1160
- logInternalError("worktree.agent-cleanup.diff", error, `worktreePath=${worktreePath}`);
1161
- }
1162
- // Resolve repoRoot once and reuse (cache optimization).
1163
- let repoRoot: string | undefined;
1164
- try {
1165
- repoRoot = await findGitRootAsync(manifest.cwd);
1166
- } catch {
1167
- // Cannot resolve repoRoot — fall back to fs.rm for the worktree.
1168
- try {
1169
- fs.rmSync(worktreePath, { recursive: true, force: true });
1170
- } catch (rmError) {
1171
- logInternalError("worktree.agent-cleanup.rm", rmError, `worktreePath=${worktreePath}`);
1172
- }
1173
- return;
1174
- }
1175
- // Remove worktree (best-effort). Try git first, then fall back to fs.rm.
1176
- try {
1177
- await gitAsync(repoRoot, ["worktree", "remove", "--force", worktreePath]);
1178
- } catch (error) {
1179
- logInternalError("worktree.agent-cleanup.remove", error, `worktreePath=${worktreePath}`);
1180
- try {
1181
- fs.rmSync(worktreePath, { recursive: true, force: true });
1182
- } catch (rmError) {
1183
- logInternalError("worktree.agent-cleanup.rm", rmError, `worktreePath=${worktreePath}`);
1184
- }
1185
- }
1186
- // Delete the ephemeral agent branch (best-effort).
1187
- if (branch) {
1188
- try {
1189
- await gitAsync(repoRoot, ["branch", "-D", branch]);
1190
- } catch (error) {
1191
- logInternalError("worktree.agent-cleanup.branch", error, `branch=${branch}`);
1192
- }
1193
- }
1194
- // Prune stale worktree refs (best-effort).
1195
- try {
1196
- await gitAsync(repoRoot, ["worktree", "prune"]);
1197
- } catch (error) {
1198
- logInternalError("worktree.agent-cleanup.prune", error, `worktreePath=${worktreePath}`);
1199
- }
1200
- }