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,128 +0,0 @@
1
- /**
2
- * Dual-gate loop control — determines whether a task should auto-resume
3
- * based on meaningful progress and turn limits.
4
- *
5
- * Gate 1: At least one signal of meaningful progress must be true.
6
- * Gate 2: The auto-resume turn count must be below the maximum.
7
- *
8
- * Distilled from pi-autoresearch's dual-gate loop pattern.
9
- */
10
- import * as fs from "node:fs";
11
- import type { TeamTaskState } from "../state/types.ts";
12
-
13
- /**
14
- * Signal indicating what kind of progress a task has made.
15
- */
16
- export interface TaskProgressSignal {
17
- /** Whether the task has edited files or produced non-empty results. */
18
- editedFiles: boolean;
19
- /** Whether the task has produced artifacts in the artifacts directory. */
20
- producedArtifacts: boolean;
21
- /** Whether the task has run tests (detected via result text). */
22
- ranTests: boolean;
23
- }
24
-
25
- /**
26
- * Runtime state for auto-resume turn tracking.
27
- */
28
- export interface AutoResumeRuntime {
29
- /** Current number of auto-resume turns taken. */
30
- autoResumeTurns: number;
31
- /** Maximum allowed auto-resume turns. */
32
- maxTurns: number;
33
- }
34
-
35
- /** Keywords in result text that indicate tests were run. */
36
- const TEST_KEYWORDS = [
37
- "test passed",
38
- "test failed",
39
- "tests passed",
40
- "tests failed",
41
- "test results",
42
- "jest",
43
- "vitest",
44
- "mocha",
45
- "pytest",
46
- "npx test",
47
- "npm test",
48
- "cargo test",
49
- "all tests",
50
- "test suite",
51
- "✓",
52
- "✗",
53
- "PASS ",
54
- " FAIL ",
55
- ] as const;
56
-
57
- /**
58
- * Determine whether a task should auto-resume based on dual-gate logic.
59
- *
60
- * Gate 1 (meaningful progress): at least one of editedFiles, producedArtifacts,
61
- * or ranTests must be true.
62
- * Gate 2 (turn limit): autoResumeTurns must be strictly less than maxTurns.
63
- *
64
- * Both gates must pass for auto-resume to be allowed.
65
- */
66
- export function shouldAutoResume(runtime: AutoResumeRuntime, taskProgress: TaskProgressSignal): boolean {
67
- // Gate 2: Turn limit check (check first — cheaper)
68
- if (runtime.autoResumeTurns >= runtime.maxTurns) {
69
- return false;
70
- }
71
-
72
- // Gate 1: Meaningful progress check
73
- const hasProgress = taskProgress.editedFiles || taskProgress.producedArtifacts || taskProgress.ranTests;
74
- if (!hasProgress) {
75
- return false;
76
- }
77
-
78
- return true;
79
- }
80
-
81
- /**
82
- * Compute the task progress signal from a task's state and artifacts directory.
83
- *
84
- * - editedFiles: true if task has artifact files or a non-empty result
85
- * - producedArtifacts: true if artifacts directory contains task-specific files
86
- * - ranTests: true if result text contains test-related keywords
87
- *
88
- * @param task - The task state to analyze
89
- * @param artifactsDir - Path to the artifacts directory
90
- * @returns TaskProgressSignal indicating what progress was made
91
- */
92
- export function computeTaskProgressSignal(task: TeamTaskState, artifactsDir: string): TaskProgressSignal {
93
- // editedFiles: check if task has artifact descriptors or a non-empty result
94
- const hasResultArtifact = task.resultArtifact !== undefined;
95
- const hasNonEmptyResult = task.resultArtifact?.path !== undefined;
96
- const editedFiles = hasResultArtifact || hasNonEmptyResult;
97
-
98
- // producedArtifacts: check artifacts directory for task-specific files
99
- let producedArtifacts = false;
100
- if (artifactsDir && fs.existsSync(artifactsDir)) {
101
- try {
102
- const entries = fs.readdirSync(artifactsDir);
103
- // Look for files/directories that START with the task ID prefix.
104
- // Using startsWith instead of includes to avoid false positives
105
- // from short task IDs like "01" matching unrelated entries.
106
- const taskPrefix = task.id.replace(/[^a-zA-Z0-9_-]/g, "");
107
- producedArtifacts = entries.some((entry) => {
108
- const baseName = entry.split(".")[0] ?? entry;
109
- return baseName.startsWith(taskPrefix);
110
- });
111
- } catch {
112
- producedArtifacts = false;
113
- }
114
- }
115
-
116
- // ranTests: check if result-related fields contain test keywords
117
- let ranTests = false;
118
- const textToSearch = [
119
- task.error ?? "",
120
- task.terminalEvidence ? JSON.stringify(task.terminalEvidence) : "",
121
- task.diagnostics ? JSON.stringify(task.diagnostics) : "",
122
- ].join(" ");
123
-
124
- const lowerText = textToSearch.toLowerCase();
125
- ranTests = TEST_KEYWORDS.some((keyword) => lowerText.includes(keyword.toLowerCase()));
126
-
127
- return { editedFiles, producedArtifacts, ranTests };
128
- }
@@ -1,375 +0,0 @@
1
- import * as fs from "node:fs";
2
- import * as path from "node:path";
3
- import { DEFAULT_CACHE, DEFAULT_PATHS } from "../config/defaults.ts";
4
- import { activeRunEntries } from "../state/active-run-registry.ts";
5
- import type { TeamRunManifest } from "../state/types.ts";
6
- import { closeWatcher, watchWithErrorHandler } from "../utils/fs-watch.ts";
7
- import { findRepoRoot, projectCrewRoot, userCrewRoot } from "../utils/paths.ts";
8
- import { isSafePathId, resolveContainedRelativePath, resolveRealContainedPath } from "../utils/safe-paths.ts";
9
-
10
- export interface ManifestCache {
11
- list(limit?: number): TeamRunManifest[];
12
- /**
13
- * Return ONLY running manifests, capped only by `limit`.
14
- *
15
- * RT-F3: unlike `list(limit)`, this filters `status === "running"` BEFORE
16
- * the limit is applied so stale orphaned runs that have been pushed past
17
- * the top-N by recent activity are not silently hidden from crash-recovery
18
- * and zombie-detection scans.
19
- */
20
- listActive(limit: number): TeamRunManifest[];
21
- get(runId: string): TeamRunManifest | undefined;
22
- clear(runId?: string): void;
23
- dispose(): void;
24
- }
25
-
26
- interface CachedManifest {
27
- path: string;
28
- manifest: TeamRunManifest;
29
- mtimeMs: number;
30
- size: number;
31
- loadedAtMs: number;
32
- }
33
-
34
- interface CachedList {
35
- runs: TeamRunManifest[];
36
- limit?: number;
37
- expireAtMs: number;
38
- }
39
-
40
- export interface ManifestCacheOptions {
41
- debounceMs?: number;
42
- watch?: boolean;
43
- maxEntries?: number;
44
- }
45
-
46
- const DEFAULT_TTL_MS = 500;
47
-
48
- interface ParsedEntry {
49
- runId: string;
50
- path: string;
51
- manifest?: TeamRunManifest;
52
- }
53
-
54
- function manifestPathForRun(root: string, runId: string): string | undefined {
55
- if (!isSafePathId(runId)) return undefined;
56
- try {
57
- return path.join(resolveRealContainedPath(root, runId), DEFAULT_PATHS.state.manifestFile);
58
- } catch {
59
- return undefined;
60
- }
61
- }
62
-
63
- function parseManifest(filePath: string): TeamRunManifest | undefined {
64
- try {
65
- return JSON.parse(fs.readFileSync(filePath, "utf-8")) as TeamRunManifest;
66
- } catch {
67
- return undefined;
68
- }
69
- }
70
-
71
- function sameFilesystemPath(left: string, right: string): boolean {
72
- if (path.resolve(left) === path.resolve(right)) return true;
73
- try {
74
- return fs.realpathSync.native(left) === fs.realpathSync.native(right);
75
- } catch {
76
- return false;
77
- }
78
- }
79
-
80
- function validateManifestForRoot(root: string, runId: string, manifest: TeamRunManifest): boolean {
81
- try {
82
- if (!isSafePathId(runId)) return false;
83
- const stateRoot = resolveContainedRelativePath(root, runId, "runId");
84
- const crewRoot = path.dirname(path.dirname(root));
85
- const artifactsRoot = resolveContainedRelativePath(path.join(crewRoot, DEFAULT_PATHS.state.artifactsSubdir), runId, "runId");
86
- if (
87
- manifest.runId !== runId ||
88
- !sameFilesystemPath(manifest.stateRoot, stateRoot) ||
89
- !sameFilesystemPath(manifest.tasksPath, path.join(stateRoot, DEFAULT_PATHS.state.tasksFile)) ||
90
- !sameFilesystemPath(manifest.eventsPath, path.join(stateRoot, DEFAULT_PATHS.state.eventsFile)) ||
91
- !sameFilesystemPath(manifest.artifactsRoot, artifactsRoot)
92
- )
93
- return false;
94
- if (fs.existsSync(artifactsRoot)) {
95
- if (fs.lstatSync(artifactsRoot).isSymbolicLink()) return false;
96
- resolveRealContainedPath(path.dirname(artifactsRoot), path.basename(artifactsRoot));
97
- }
98
- return true;
99
- } catch {
100
- return false;
101
- }
102
- }
103
-
104
- function parseManifestIfChanged(root: string, runId: string, filePath: string, previous?: CachedManifest): CachedManifest | undefined {
105
- let stat: fs.Stats;
106
- try {
107
- stat = fs.statSync(filePath);
108
- } catch {
109
- return undefined;
110
- }
111
- if (previous && previous.mtimeMs === stat.mtimeMs && previous.size === stat.size) {
112
- return validateManifestForRoot(root, runId, previous.manifest) ? previous : undefined;
113
- }
114
- const manifest = parseManifest(filePath);
115
- if (!manifest || !validateManifestForRoot(root, runId, manifest)) return undefined;
116
- return {
117
- path: filePath,
118
- manifest,
119
- mtimeMs: stat.mtimeMs,
120
- size: stat.size,
121
- loadedAtMs: Date.now(),
122
- };
123
- }
124
-
125
- function listRunRoots(cwd: string): string[] {
126
- const roots = new Set<string>();
127
- // Always include user-level runs (fast-fix, direct-agent, etc. write here)
128
- roots.add(path.join(userCrewRoot(), DEFAULT_PATHS.state.runsSubdir));
129
- const projectRoot = findRepoRoot(cwd);
130
- if (projectRoot) roots.add(path.join(projectCrewRoot(cwd), DEFAULT_PATHS.state.runsSubdir));
131
- return [...roots];
132
- }
133
-
134
- function collectRoots(root: string): ParsedEntry[] {
135
- if (!fs.existsSync(root)) return [];
136
- let entries: string[];
137
- try {
138
- entries = fs.readdirSync(root);
139
- } catch {
140
- return [];
141
- }
142
- return entries
143
- .filter((entry) => entry.length > 0 && isSafePathId(entry))
144
- .map((entry) => ({
145
- runId: entry,
146
- path: manifestPathForRun(root, entry),
147
- }))
148
- .filter((entry): entry is ParsedEntry => entry.path !== undefined);
149
- }
150
-
151
- export function createManifestCache(cwd: string, options: ManifestCacheOptions = {}): ManifestCache {
152
- const ttlMs = options.debounceMs ?? DEFAULT_TTL_MS;
153
- const maxEntries = options.maxEntries ?? DEFAULT_CACHE.manifestMaxEntries;
154
- const roots = listRunRoots(cwd);
155
- const manifestIndex = new Map<string, CachedManifest>();
156
- const listCache = new Map<number, CachedList>();
157
- let listTimer: ReturnType<typeof setTimeout> | undefined;
158
- let watchers: fs.FSWatcher[] = [];
159
-
160
- function invalidate(runId?: string): void {
161
- if (runId) {
162
- manifestIndex.delete(runId);
163
- } else {
164
- manifestIndex.clear();
165
- }
166
- listCache.clear();
167
- invalidateListActive();
168
- }
169
-
170
- function scheduleListRefresh(): void {
171
- if (listTimer) {
172
- clearTimeout(listTimer);
173
- }
174
- listTimer = setTimeout(() => {
175
- const timer = listTimer;
176
- listTimer = undefined;
177
- listCache.clear();
178
- invalidateListActive();
179
- timer?.unref();
180
- }, ttlMs);
181
- // Unref immediately so the timer never blocks process exit (defense in
182
- // depth: the in-callback unref above may not run if shutdown happens
183
- // before the timer fires).
184
- listTimer.unref();
185
- // FIND-03: invalidate the listActive() cache eagerly on every watcher
186
- // tick. The TTL is the fallback for missed events; the watcher-driven
187
- // path gives the tightest possible invalidation.
188
- invalidateListActive();
189
- }
190
-
191
- function loadManifest(runId: string, rootsToCheck: string[]): CachedManifest | undefined {
192
- const cached = manifestIndex.get(runId);
193
- if (!isSafePathId(runId)) return undefined;
194
- const activeEntry = activeRunEntries().find((entry) => entry.runId === runId);
195
- if (activeEntry) {
196
- const activeRoot = path.dirname(activeEntry.stateRoot);
197
- const parsed = parseManifestIfChanged(activeRoot, runId, activeEntry.manifestPath, cached);
198
- if (parsed) {
199
- manifestIndex.set(runId, parsed);
200
- return parsed;
201
- }
202
- }
203
- for (const root of rootsToCheck) {
204
- const manifestPath = manifestPathForRun(root, runId);
205
- if (!manifestPath) continue;
206
- const parsed = parseManifestIfChanged(root, runId, manifestPath, cached);
207
- if (parsed) {
208
- if (!cached || parsed.mtimeMs !== cached.mtimeMs || parsed.size !== cached.size) {
209
- manifestIndex.set(runId, parsed);
210
- if (manifestIndex.size > maxEntries) {
211
- const oldest = [...manifestIndex.values()].sort((a, b) => a.loadedAtMs - b.loadedAtMs)[0];
212
- if (oldest) manifestIndex.delete(oldest.manifest.runId);
213
- }
214
- }
215
- return manifestIndex.get(runId);
216
- }
217
- }
218
- return undefined;
219
- }
220
-
221
- /**
222
- * NOTE (RT-F10): This function performs a full FS scan + JSON.parse of all
223
- * manifests on every TTL expiry (default 500ms). This is a known performance
224
- * tradeoff: fs.watch provides real-time invalidation (see constructor above)
225
- * so the TTL cache is only consulted when the watcher fires, but the list()
226
- * call itself still re-reads all entries to pick up changes. Incremental
227
- * updates via fs.watch-driven delta tracking are planned for a future
228
- * iteration to avoid the full scan on each expiry.
229
- */
230
- function list(limit = DEFAULT_CACHE.manifestMaxEntries): TeamRunManifest[] {
231
- const now = Date.now();
232
- const cached = listCache.get(limit);
233
- if (cached && cached.expireAtMs > now) {
234
- return cached.runs;
235
- }
236
- const parsedEntries = [
237
- ...roots.flatMap((root) => collectRoots(root)),
238
- ...activeRunEntries().map((entry) => ({
239
- runId: entry.runId,
240
- path: entry.manifestPath,
241
- })),
242
- ];
243
- const unique = new Map<string, CachedManifest | undefined>();
244
- for (const entry of parsedEntries) {
245
- if (entry.runId.length === 0) continue;
246
- let cached = manifestIndex.get(entry.runId);
247
- const root = path.dirname(path.dirname(entry.path));
248
- const parsed = parseManifestIfChanged(root, entry.runId, entry.path, cached);
249
- if (parsed) {
250
- cached = parsed;
251
- manifestIndex.set(entry.runId, cached);
252
- }
253
- if (cached) unique.set(entry.runId, cached);
254
- }
255
-
256
- const runs = [...unique.values()].filter((value): value is CachedManifest => value !== undefined).map((value) => value.manifest);
257
- const sorted = runs.sort((a, b) => (b.createdAt ?? "").localeCompare(a.createdAt ?? ""));
258
- const limited = sorted.slice(0, Math.max(0, limit));
259
- if (manifestIndex.size > maxEntries) {
260
- const removeCount = manifestIndex.size - maxEntries;
261
- const oldest = [...manifestIndex.values()].sort((a, b) => a.loadedAtMs - b.loadedAtMs).slice(0, removeCount);
262
- for (const entry of oldest) manifestIndex.delete(entry.manifest.runId);
263
- }
264
- const result = limited;
265
- listCache.set(limit, { runs: result, limit, expireAtMs: now + ttlMs });
266
- return result;
267
- }
268
-
269
- function get(runId: string): TeamRunManifest | undefined {
270
- const cached = loadManifest(runId, roots);
271
- if (cached) return cached.manifest;
272
- return undefined;
273
- }
274
-
275
- // FIND-03: short-TTL cache for listActive(). Mirrors the listCache pattern
276
- // used by list(): we cache the un-capped running set and apply the caller's
277
- // `limit` post-hoc on every return. Storing the full set (not a
278
- // limit-sliced array) is what preserves the RT-F3 contract — callers with
279
- // different `limit` values all see the same underlying "every running run"
280
- // result, never a top-N createdAt-filtered view.
281
- let listActiveCache: { result: TeamRunManifest[] | null; expiresAt: number } = { result: null, expiresAt: 0 };
282
-
283
- function invalidateListActive(): void {
284
- listActiveCache = { result: null, expiresAt: 0 };
285
- }
286
-
287
- /**
288
- * RT-F3: filter to `status === "running"` BEFORE applying the limit so an
289
- * orphaned run that has been pushed past the top-N by recent successful
290
- * runs is still surfaced to crash-recovery. The cap is the LIMIT, not the
291
- * "top-N most recent"; callers (e.g. zombie detection) explicitly want
292
- * EVERY currently-running run, in any order.
293
- *
294
- * Internally performs a full scan (NOT via list()) so the cap doesn't
295
- * silently drop "running" runs that fell past the top-N createdAt cutoff.
296
- * Still goes through parseManifestIfChanged for stat+size memoization, so
297
- * the per-run I/O cost is the same as list().
298
- *
299
- * FIND-03 perf: the full scan is memoized behind a 500ms TTL (same TTL as
300
- * list()). fs.watch-driven scheduleListRefresh() invalidates the cache
301
- * immediately so the next call re-scans. The cap is applied AFTER the
302
- * cache lookup so a cached scan result can be sliced to ANY limit without
303
- * re-scanning.
304
- */
305
- function listActive(limit: number): TeamRunManifest[] {
306
- const cap = Math.max(0, limit);
307
- const now = Date.now();
308
- if (listActiveCache.result !== null && listActiveCache.expiresAt > now) {
309
- return listActiveCache.result.slice(0, cap);
310
- }
311
- const parsedEntries = [
312
- ...roots.flatMap((root) => collectRoots(root)),
313
- ...activeRunEntries().map((entry) => ({
314
- runId: entry.runId,
315
- path: entry.manifestPath,
316
- })),
317
- ];
318
- const unique = new Map<string, CachedManifest | undefined>();
319
- for (const entry of parsedEntries) {
320
- if (entry.runId.length === 0) continue;
321
- let cached = manifestIndex.get(entry.runId);
322
- const root = path.dirname(path.dirname(entry.path));
323
- const parsed = parseManifestIfChanged(root, entry.runId, entry.path, cached);
324
- if (parsed) {
325
- cached = parsed;
326
- manifestIndex.set(entry.runId, cached);
327
- }
328
- if (cached) unique.set(entry.runId, cached);
329
- }
330
- const running = [...unique.values()]
331
- .filter((value): value is CachedManifest => value !== undefined)
332
- .map((value) => value.manifest)
333
- .filter((manifest) => manifest.status === "running");
334
- listActiveCache = { result: running, expiresAt: now + ttlMs };
335
- return running.slice(0, cap);
336
- }
337
-
338
- if (options.watch ?? true) {
339
- for (const root of roots) {
340
- const watcher = watchWithErrorHandler(
341
- root,
342
- () => {
343
- scheduleListRefresh();
344
- },
345
- () => {
346
- scheduleListRefresh();
347
- },
348
- );
349
- if (watcher) {
350
- watcher.unref();
351
- watchers.push(watcher);
352
- }
353
- }
354
- }
355
-
356
- return {
357
- list,
358
- listActive,
359
- get,
360
- clear(runId) {
361
- invalidate(runId);
362
- },
363
- dispose() {
364
- if (listTimer) {
365
- clearTimeout(listTimer);
366
- listTimer = undefined;
367
- }
368
- for (const watcher of watchers) closeWatcher(watcher);
369
- watchers = [];
370
- manifestIndex.clear();
371
- listCache.clear();
372
- invalidateListActive();
373
- },
374
- };
375
- }
@@ -1,105 +0,0 @@
1
- /**
2
- * G2: MCP Proxy for live-session workers.
3
- *
4
- * When the parent process has MCP servers configured, live-session workers
5
- * can reuse those connections instead of establishing their own. This module
6
- * discovers MCP tools available in the parent environment and creates proxy
7
- * tool definitions that forward calls through the parent's connections.
8
- *
9
- * Strategy:
10
- * 1. If the Pi SDK session has MCP tools after bindExtensions → use them directly
11
- * 2. If not → create proxy custom tools that wrap MCP calls
12
- * 3. If no MCP config exists → disable MCP in the session
13
- *
14
- * The Pi SDK's `createAgentSession` accepts a `customTools` array for injecting
15
- * proxy tools. The session also accepts `enableMCP: false` to skip MCP discovery
16
- * when proxying from the parent.
17
- */
18
-
19
- import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
20
- import type { TSchema } from "@sinclair/typebox";
21
-
22
- export interface McpProxyConfig {
23
- /** Whether to enable MCP in the child session. */
24
- enableMcp: boolean;
25
- /** Proxy tools to inject via customTools (replaces MCP connection). */
26
- proxyTools: Array<ToolDefinition<TSchema, unknown>>;
27
- /** Names of MCP tools available (for metadata/tracking). */
28
- proxyToolNames: string[];
29
- }
30
-
31
- /**
32
- * Build MCP proxy configuration for a live-session worker.
33
- *
34
- * @param options.parentMcpTools — MCP tool names from the parent session (if available)
35
- * @param options.shareMcp — Whether to share MCP connections (default: true)
36
- */
37
- export function buildMcpProxyConfig(options: { parentMcpTools?: string[]; shareMcp?: boolean }): McpProxyConfig {
38
- if (options.shareMcp === false) {
39
- return { enableMcp: true, proxyTools: [], proxyToolNames: [] };
40
- }
41
-
42
- const parentTools = options.parentMcpTools ?? [];
43
- if (parentTools.length === 0) {
44
- // No MCP tools in parent — let session discover on its own
45
- return { enableMcp: true, proxyTools: [], proxyToolNames: [] };
46
- }
47
-
48
- // MCP tools exist in parent — try to create proxy tools.
49
- // If proxy tools are not available (stub), keep enableMcp: true
50
- // so the child session can self-discover MCP instead of losing all access.
51
- const proxyTools = createMcpProxyTools(parentTools);
52
- if (proxyTools.length === 0) {
53
- // No proxy tools available — let child discover MCP on its own
54
- return { enableMcp: true, proxyTools: [], proxyToolNames: parentTools };
55
- }
56
- return {
57
- enableMcp: false,
58
- proxyTools,
59
- proxyToolNames: parentTools,
60
- };
61
- }
62
-
63
- /**
64
- * Create lightweight proxy tools that represent MCP tools from the parent.
65
- *
66
- * These tools tell the model that the MCP tools are available, but actual
67
- * execution is forwarded through the parent's MCP connections. Since we
68
- * can't directly access the parent's MCP manager from a child session,
69
- * the tools return a message indicating the model should use them normally.
70
- *
71
- * In a future iteration, these can be wired to the actual MCP connections
72
- * via an inter-process bridge.
73
- */
74
- function createMcpProxyTools(toolNames: string[]): Array<ToolDefinition<TSchema, unknown>> {
75
- // For now, we don't create individual proxy tools because we can't
76
- // forward MCP calls without the parent's MCP manager reference.
77
- //
78
- // Instead, we let the child session discover MCP on its own (enableMcp: true)
79
- // or share the parent's MCP config directory.
80
- //
81
- // This will be enhanced when we add inter-process MCP call forwarding.
82
- return [];
83
- }
84
-
85
- /**
86
- * Discover MCP tool names from a live session's active tools.
87
- * MCP tools typically have names containing "__" (e.g., "mcp__filesystem__read_file").
88
- */
89
- export function discoverMcpToolNames(activeToolNames: string[]): string[] {
90
- return activeToolNames.filter(
91
- (name) => name.startsWith("mcp__") || name.startsWith("mcp-") || (name.includes("__") && !name.startsWith("submit_result")),
92
- );
93
- }
94
-
95
- /**
96
- * Build MCP proxy config from a real Pi SDK session's active tools.
97
- * This is the preferred way — inspect what the parent session has available.
98
- */
99
- export function buildMcpProxyFromSession(activeToolNames: string[], options?: { shareMcp?: boolean }): McpProxyConfig {
100
- const mcpTools = discoverMcpToolNames(activeToolNames);
101
- return buildMcpProxyConfig({
102
- parentMcpTools: mcpTools,
103
- shareMcp: options?.shareMcp,
104
- });
105
- }
@@ -1,36 +0,0 @@
1
- /**
2
- * Metric names that are denied to prevent prototype pollution.
3
- */
4
- export const DENIED_METRIC_NAMES: ReadonlySet<string> = new Set(["__proto__", "constructor", "prototype"]);
5
-
6
- const METRIC_LINE_RE = /^CREW_METRIC\s+(\w+)=(\S+)$/;
7
-
8
- /**
9
- * Parse CREW_METRIC lines from worker stdout.
10
- *
11
- * Lines must match the pattern: `CREW_METRIC name=value`
12
- * - `name` must be a word character sequence (alphanumeric + underscore)
13
- * - `value` must parse as a valid finite number
14
- * - Denied names (__proto__, constructor, prototype) are silently skipped
15
- *
16
- * @param output - Raw worker stdout text
17
- * @returns Map of metric name → numeric value
18
- */
19
- export function parseMetricLines(output: string): Record<string, number> {
20
- const metrics: Record<string, number> = {};
21
-
22
- for (const line of output.split("\n")) {
23
- const match = METRIC_LINE_RE.exec(line);
24
- if (!match) continue;
25
-
26
- const [, name, rawValue] = match;
27
- if (DENIED_METRIC_NAMES.has(name)) continue;
28
-
29
- const value = Number(rawValue);
30
- if (!Number.isFinite(value)) continue;
31
-
32
- metrics[name] = value;
33
- }
34
-
35
- return metrics;
36
- }