pi-crew 0.9.51 → 0.9.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (611) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/README.md +216 -20
  3. package/dist/build-meta.json +2090 -1638
  4. package/dist/index.mjs +18057 -17119
  5. package/docs/actions-reference.md +431 -1
  6. package/index.ts +39 -10
  7. package/package.json +19 -9
  8. package/schema.json +41 -0
  9. package/scripts/check-bundle-size.mjs +38 -0
  10. package/scripts/test-runner.mjs +11 -1
  11. package/dist/index.mjs.map +0 -7
  12. package/docs/FEATURE_INTAKE.md +0 -126
  13. package/docs/HARNESS.md +0 -87
  14. package/docs/HARNESS_BACKLOG.md +0 -89
  15. package/docs/PROJECT_REVIEW.md +0 -270
  16. package/docs/PROJECT_REVIEW_FIXES.md +0 -342
  17. package/docs/PROJECT_REVIEW_ROUND4.md +0 -156
  18. package/docs/PROJECT_REVIEW_ROUND5.md +0 -86
  19. package/docs/REVIEW-FINDINGS-2026-06 +0 -357
  20. package/docs/REVIEW-FINDINGS-2026-07-CORE.md +0 -139
  21. package/docs/REVIEW-FINDINGS-2026-07.md +0 -125
  22. package/docs/TEST_MATRIX.md +0 -51
  23. package/docs/archive/README.md +0 -91
  24. package/docs/archive/followup-review-round3-2026-05-12.md +0 -342
  25. package/docs/archive/followup-review-round4-2026-05-13.md +0 -107
  26. package/docs/archive/pi-crew-bugs.md +0 -961
  27. package/docs/archive/pi-crew-test-final.md +0 -120
  28. package/docs/archive/pi-crew-test-results.md +0 -260
  29. package/docs/archive/pi-crew-test-round2.md +0 -136
  30. package/docs/archive/pi-crew-test-round4.md +0 -100
  31. package/docs/archive/pi-crew-test-round5.md +0 -70
  32. package/docs/archive/pi-crew-test-round6.md +0 -110
  33. package/docs/archive/pi-crew-v0.5.10-audit-fix-plan.md +0 -60
  34. package/docs/archive/pi-crew-v0.5.11-audit-fix-plan.md +0 -92
  35. package/docs/archive/pi-crew-v0.5.12-audit-fix-plan.md +0 -76
  36. package/docs/archive/pi-crew-v0.5.13-audit-fix-plan.md +0 -75
  37. package/docs/archive/pi-crew-v0.5.14-audit-fix-plan.md +0 -75
  38. package/docs/archive/pi-crew-v0.5.16-audit-fix-plan.md +0 -35
  39. package/docs/archive/pi-crew-v0.5.17-audit-fix-plan.md +0 -80
  40. package/docs/archive/pi-crew-v0.5.5-audit-fix-plan.md +0 -133
  41. package/docs/archive/pi-crew-v0.5.9-audit-fix-plan.md +0 -88
  42. package/docs/archive/pi-mono-opportunities.md +0 -969
  43. package/docs/archive/pi-mono-review.md +0 -291
  44. package/docs/archive/pi-subagent4-comparison.md +0 -261
  45. package/docs/archive/pi-subagents3-deep-analysis.md +0 -508
  46. package/docs/bugs/bug-021-notification-badge-counter-misleading.md +0 -293
  47. package/docs/bugs/bug-023-chain-windows-path-resolution.md +0 -106
  48. package/docs/bugs/bug-quota-display-truncation.md +0 -223
  49. package/docs/bugs/cross-session-notification-leakage.md +0 -82
  50. package/docs/code-review-2026-05-11.md +0 -592
  51. package/docs/coding-agent-optimization.md +0 -268
  52. package/docs/comparison-pi-subagents-vs-pi-crew.md +0 -303
  53. package/docs/decisions/0001-durable-state.md +0 -41
  54. package/docs/decisions/0002-child-process-for-async.md +0 -42
  55. package/docs/decisions/0003-depth-guard.md +0 -36
  56. package/docs/decisions/0004-execfile-over-exec.md +0 -34
  57. package/docs/decisions/0005-no-parameter-properties.md +0 -49
  58. package/docs/decisions/0006-publish-bundled-esm.md +0 -63
  59. package/docs/decisions/0007-active-run-binary-index.md +0 -54
  60. package/docs/decisions/0008-child-pi-warm-pool.md +0 -61
  61. package/docs/decisions/2026-07-21-broker-phase4-default-on.md +0 -77
  62. package/docs/decisions/2026-07-21-broker-windows-perms.md +0 -91
  63. package/docs/decisions/2026-07-22-broker-phase4-gated-on.md +0 -99
  64. package/docs/decisions/2026-07-24-oidc-trusted-publishing.md +0 -112
  65. package/docs/decisions/2026-07-26-c6-mascot-visibility-not-wired.md +0 -84
  66. package/docs/decisions/README.md +0 -26
  67. package/docs/deep-review-report.md +0 -384
  68. package/docs/distillation/cybersecurity-patterns.md +0 -294
  69. package/docs/feature-analysis-subagent4.md +0 -305
  70. package/docs/fix-plan-disabletools-exit-null.md +0 -219
  71. package/docs/fixes/BATCH_A_H1_H2.md +0 -86
  72. package/docs/fixes/bug-006-foreground-cancel-concurrent.md +0 -78
  73. package/docs/fixes/bug-007-async-notifier-stale-ctx.md +0 -112
  74. package/docs/fixes/bug-008-child-process-silent-timeout.md +0 -100
  75. package/docs/fixes/bug-009-executor-yield-limit-needs-attention.md +0 -75
  76. package/docs/fixes/bug-010-child-process-api-key-filtered.md +0 -109
  77. package/docs/fixes/bug-011-spawn-pi-enoent.md +0 -92
  78. package/docs/fixes/bug-012-essential-env-stripped.md +0 -89
  79. package/docs/fixes/bug-013-background-runner-death.md +0 -84
  80. package/docs/fixes/bug-014-infinite-retry-loop-needs-attention.md +0 -82
  81. package/docs/fixes/bug-015-background-runner-sigterm.md +0 -65
  82. package/docs/fixes/bug-017-background-runner-session-shutdown.md +0 -66
  83. package/docs/fixes/bug-017-background-runner-sigkill-double-fork.md +0 -28
  84. package/docs/fixes/bug-018-child-pi-worker-stdin-hang.md +0 -61
  85. package/docs/fixes/bug-019-phantom-runs-temp-workspace.md +0 -52
  86. package/docs/fixes/bug-020-infinite-retry-loop-needs-attention.md +0 -47
  87. package/docs/fixes/v0.9.10/locks-fix-verify.md +0 -3
  88. package/docs/fixes/v0.9.10/smoke-test.md +0 -12
  89. package/docs/followup-plan-2026-05-12.md +0 -463
  90. package/docs/followup-review-2026-05-12.md +0 -297
  91. package/docs/goals.md +0 -59
  92. package/docs/implementation-plan-top3.md +0 -333
  93. package/docs/issue-29-analysis.md +0 -189
  94. package/docs/live-mailbox-runtime.md +0 -36
  95. package/docs/migration/atomic-write-v2-migration.md +0 -299
  96. package/docs/next-upgrade-roadmap.md +0 -808
  97. package/docs/oh-my-pi-research.md +0 -509
  98. package/docs/optimization-plan-2026-07.md +0 -366
  99. package/docs/optimization-plan.md +0 -644
  100. package/docs/patterns/command-agent-skill.md +0 -71
  101. package/docs/perf/baseline-2026-05.md +0 -113
  102. package/docs/perf/final-report-2026-05.md +0 -206
  103. package/docs/perf/optimization-plan-2026-07-verified.md +0 -396
  104. package/docs/perf/performance-audit-report-2026-07.md +0 -948
  105. package/docs/perf/performance-review-2026-07.md +0 -287
  106. package/docs/perf/sprint-1-report.md +0 -71
  107. package/docs/perf/sprint-2-report.md +0 -81
  108. package/docs/perf/sprint-2.5-report.md +0 -53
  109. package/docs/perf/sprint-3-report.md +0 -36
  110. package/docs/perf/sprint-4-report.md +0 -47
  111. package/docs/perf/sprint-5-report.md +0 -51
  112. package/docs/perf/sprint-6-report.md +0 -94
  113. package/docs/perf/sprint-7-report.md +0 -74
  114. package/docs/perf/upgrade-plan-2026-05.md +0 -147
  115. package/docs/performance-optimization-execution-plan.md +0 -520
  116. package/docs/phase4-triage.md +0 -58
  117. package/docs/pi-crew-investigation-report.md +0 -411
  118. package/docs/product/README.md +0 -31
  119. package/docs/product/platform.md +0 -27
  120. package/docs/product/runtime-safety.md +0 -37
  121. package/docs/product/team-run.md +0 -39
  122. package/docs/product/team-tool.md +0 -37
  123. package/docs/runtime-analysis-child-vs-live.md +0 -171
  124. package/docs/runtime-migration-in-process-analysis.md +0 -250
  125. package/docs/skills/REFERENCE.md +0 -138
  126. package/docs/stories/README.md +0 -32
  127. package/docs/stories/US-DEPS-major-upgrade.md +0 -62
  128. package/docs/stories/backlog.md +0 -36
  129. package/docs/superpowers/plans/2026-06-09-fallow-patterns-adoption.md +0 -1270
  130. package/docs/templates/decision.md +0 -27
  131. package/docs/templates/story.md +0 -44
  132. package/docs/templates/validation-report.md +0 -32
  133. package/docs/ui-optimization-plan.md +0 -447
  134. package/src/adapters/claude-adapter.ts +0 -23
  135. package/src/adapters/codex-adapter.ts +0 -21
  136. package/src/adapters/cursor-adapter.ts +0 -17
  137. package/src/adapters/export-util.ts +0 -143
  138. package/src/adapters/index.ts +0 -15
  139. package/src/adapters/registry.ts +0 -18
  140. package/src/adapters/types.ts +0 -23
  141. package/src/agents/agent-config.ts +0 -194
  142. package/src/agents/agent-search.ts +0 -98
  143. package/src/agents/agent-serializer.ts +0 -38
  144. package/src/agents/discover-agents.ts +0 -623
  145. package/src/benchmark/benchmark-runner.ts +0 -313
  146. package/src/benchmark/feedback-loop.ts +0 -73
  147. package/src/config/config.ts +0 -1269
  148. package/src/config/defaults.ts +0 -193
  149. package/src/config/drift-detector.ts +0 -290
  150. package/src/config/markers.ts +0 -330
  151. package/src/config/resilient-parser.ts +0 -117
  152. package/src/config/role-tools.ts +0 -118
  153. package/src/config/suggestions.ts +0 -75
  154. package/src/config/types.ts +0 -278
  155. package/src/errors.ts +0 -194
  156. package/src/extension/action-suggestions.ts +0 -117
  157. package/src/extension/async-notifier.ts +0 -179
  158. package/src/extension/autonomous-policy.ts +0 -209
  159. package/src/extension/command-completions.ts +0 -120
  160. package/src/extension/context-status-injection.ts +0 -185
  161. package/src/extension/crew-autocomplete.ts +0 -131
  162. package/src/extension/crew-cleanup.ts +0 -168
  163. package/src/extension/crew-input-router.ts +0 -93
  164. package/src/extension/crew-shortcuts.ts +0 -87
  165. package/src/extension/crew-vibes/cat-frames.ts +0 -18
  166. package/src/extension/crew-vibes/config.ts +0 -195
  167. package/src/extension/crew-vibes/figures.ts +0 -101
  168. package/src/extension/crew-vibes/font-detect.ts +0 -71
  169. package/src/extension/crew-vibes/footer.ts +0 -292
  170. package/src/extension/crew-vibes/index.ts +0 -432
  171. package/src/extension/crew-vibes/provider-usage.ts +0 -396
  172. package/src/extension/crew-vibes/render.ts +0 -206
  173. package/src/extension/crew-vibes/speed.ts +0 -286
  174. package/src/extension/cross-extension-rpc.ts +0 -350
  175. package/src/extension/help.ts +0 -62
  176. package/src/extension/import-index.ts +0 -74
  177. package/src/extension/knowledge-injection.ts +0 -402
  178. package/src/extension/management.ts +0 -571
  179. package/src/extension/message-renderers.ts +0 -108
  180. package/src/extension/notification-router.ts +0 -152
  181. package/src/extension/notification-sink.ts +0 -54
  182. package/src/extension/pi-api.ts +0 -56
  183. package/src/extension/plan-orchestrate.ts +0 -302
  184. package/src/extension/project-init.ts +0 -170
  185. package/src/extension/register.ts +0 -113
  186. package/src/extension/registration/artifact-cleanup.ts +0 -20
  187. package/src/extension/registration/command-registration.ts +0 -58
  188. package/src/extension/registration/command-utils.ts +0 -58
  189. package/src/extension/registration/commands.ts +0 -1228
  190. package/src/extension/registration/compaction-guard.ts +0 -333
  191. package/src/extension/registration/context-builder.ts +0 -135
  192. package/src/extension/registration/crash-recovery-cache.ts +0 -54
  193. package/src/extension/registration/foreground-run-controller.ts +0 -238
  194. package/src/extension/registration/hook-registration.ts +0 -119
  195. package/src/extension/registration/lazy-configurers.ts +0 -124
  196. package/src/extension/registration/lifecycle-handlers.ts +0 -923
  197. package/src/extension/registration/lifecycle.ts +0 -259
  198. package/src/extension/registration/observability.ts +0 -322
  199. package/src/extension/registration/registration-types.ts +0 -158
  200. package/src/extension/registration/runtime-cleanup.ts +0 -230
  201. package/src/extension/registration/subagent-helpers.ts +0 -125
  202. package/src/extension/registration/subagent-manager-setup.ts +0 -330
  203. package/src/extension/registration/subagent-tools.ts +0 -456
  204. package/src/extension/registration/team-tool.ts +0 -220
  205. package/src/extension/registration/tool-registration.ts +0 -50
  206. package/src/extension/registration/ui.ts +0 -172
  207. package/src/extension/registration/viewers.ts +0 -121
  208. package/src/extension/registration/wire-cross-extension.ts +0 -37
  209. package/src/extension/result-watcher.ts +0 -139
  210. package/src/extension/rpc-hmac.ts +0 -256
  211. package/src/extension/run-bundle-schema.ts +0 -104
  212. package/src/extension/run-export.ts +0 -97
  213. package/src/extension/run-import.ts +0 -168
  214. package/src/extension/run-index.ts +0 -131
  215. package/src/extension/run-maintenance.ts +0 -190
  216. package/src/extension/session-summary.ts +0 -18
  217. package/src/extension/team-manager-command.ts +0 -153
  218. package/src/extension/team-onboard.ts +0 -177
  219. package/src/extension/team-recommendation.ts +0 -288
  220. package/src/extension/team-tool/anchor.ts +0 -172
  221. package/src/extension/team-tool/api.ts +0 -1244
  222. package/src/extension/team-tool/auto-summarize.ts +0 -142
  223. package/src/extension/team-tool/cache-control.ts +0 -19
  224. package/src/extension/team-tool/cancel.ts +0 -337
  225. package/src/extension/team-tool/chain-dispatch.ts +0 -95
  226. package/src/extension/team-tool/chain-executor.ts +0 -379
  227. package/src/extension/team-tool/config-patch.ts +0 -50
  228. package/src/extension/team-tool/context.ts +0 -149
  229. package/src/extension/team-tool/destructive-gate.ts +0 -52
  230. package/src/extension/team-tool/doctor.ts +0 -431
  231. package/src/extension/team-tool/explain.ts +0 -282
  232. package/src/extension/team-tool/failure-patterns.ts +0 -118
  233. package/src/extension/team-tool/goal-wrap.ts +0 -330
  234. package/src/extension/team-tool/goal.ts +0 -556
  235. package/src/extension/team-tool/handle-schedule.ts +0 -332
  236. package/src/extension/team-tool/handle-settings.ts +0 -520
  237. package/src/extension/team-tool/health-monitor.ts +0 -481
  238. package/src/extension/team-tool/inspect.ts +0 -88
  239. package/src/extension/team-tool/intent-policy.ts +0 -45
  240. package/src/extension/team-tool/lifecycle-actions.ts +0 -615
  241. package/src/extension/team-tool/orchestrate.ts +0 -98
  242. package/src/extension/team-tool/parallel-dispatch.ts +0 -183
  243. package/src/extension/team-tool/plan.ts +0 -50
  244. package/src/extension/team-tool/respond.ts +0 -150
  245. package/src/extension/team-tool/run-not-found.ts +0 -49
  246. package/src/extension/team-tool/run.ts +0 -1035
  247. package/src/extension/team-tool/status.ts +0 -260
  248. package/src/extension/team-tool/workflow-manage.ts +0 -261
  249. package/src/extension/team-tool-types.ts +0 -26
  250. package/src/extension/team-tool.ts +0 -1116
  251. package/src/extension/tool-result.ts +0 -16
  252. package/src/extension/validate-resources.ts +0 -108
  253. package/src/hooks/registry.ts +0 -200
  254. package/src/hooks/types.ts +0 -69
  255. package/src/i18n.ts +0 -212
  256. package/src/observability/correlation.ts +0 -50
  257. package/src/observability/event-bus.ts +0 -86
  258. package/src/observability/event-to-metric.ts +0 -170
  259. package/src/observability/exporters/adapter.ts +0 -27
  260. package/src/observability/exporters/otlp-exporter.ts +0 -356
  261. package/src/observability/exporters/prometheus-exporter.ts +0 -54
  262. package/src/observability/metric-registry.ts +0 -100
  263. package/src/observability/metric-retention.ts +0 -64
  264. package/src/observability/metric-sink.ts +0 -99
  265. package/src/observability/metrics-primitives.ts +0 -219
  266. package/src/plugins/plugin-define.ts +0 -6
  267. package/src/plugins/plugin-registry.ts +0 -32
  268. package/src/plugins/plugins/index.ts +0 -3
  269. package/src/plugins/plugins/nextjs.ts +0 -19
  270. package/src/plugins/plugins/vite.ts +0 -10
  271. package/src/plugins/plugins/vitest.ts +0 -9
  272. package/src/prompt/prompt-runtime.ts +0 -380
  273. package/src/runtime/adaptive-plan.ts +0 -563
  274. package/src/runtime/agent-control.ts +0 -215
  275. package/src/runtime/agent-memory.ts +0 -81
  276. package/src/runtime/agent-observability.ts +0 -122
  277. package/src/runtime/anchor-manager.ts +0 -475
  278. package/src/runtime/async-marker.ts +0 -32
  279. package/src/runtime/async-runner.ts +0 -381
  280. package/src/runtime/attention-events.ts +0 -28
  281. package/src/runtime/auto-summarize.ts +0 -344
  282. package/src/runtime/background-runner.ts +0 -837
  283. package/src/runtime/batch-barrier.ts +0 -147
  284. package/src/runtime/broker-issuer.ts +0 -37
  285. package/src/runtime/cancellation-token.ts +0 -99
  286. package/src/runtime/cancellation.ts +0 -99
  287. package/src/runtime/capability-inventory.ts +0 -137
  288. package/src/runtime/chain-parser.ts +0 -237
  289. package/src/runtime/chain-runner.ts +0 -606
  290. package/src/runtime/checkpoint.ts +0 -291
  291. package/src/runtime/child-pi-constants.ts +0 -42
  292. package/src/runtime/child-pi-kill.ts +0 -180
  293. package/src/runtime/child-pi-pool.ts +0 -68
  294. package/src/runtime/child-pi-spawn.ts +0 -287
  295. package/src/runtime/child-pi-steering.ts +0 -128
  296. package/src/runtime/child-pi-streams.ts +0 -296
  297. package/src/runtime/child-pi-transcript.ts +0 -169
  298. package/src/runtime/child-pi.ts +0 -1105
  299. package/src/runtime/coalesce-tasks.ts +0 -268
  300. package/src/runtime/code-summary.ts +0 -292
  301. package/src/runtime/command-trace.ts +0 -105
  302. package/src/runtime/compact-pipeline.ts +0 -56
  303. package/src/runtime/compact-stages/ansi-strip-stage.ts +0 -25
  304. package/src/runtime/compact-stages/blank-collapse-stage.ts +0 -31
  305. package/src/runtime/compact-stages/deduplicate-stage.ts +0 -34
  306. package/src/runtime/compact-stages/head-snap-stage.ts +0 -57
  307. package/src/runtime/compact-stages/index.ts +0 -23
  308. package/src/runtime/compact-stages/tail-capture-stage.ts +0 -77
  309. package/src/runtime/compact-stages/truncation-stage.ts +0 -74
  310. package/src/runtime/compaction-summary.ts +0 -278
  311. package/src/runtime/completion-guard.ts +0 -207
  312. package/src/runtime/concurrency.ts +0 -58
  313. package/src/runtime/crash-classification.ts +0 -229
  314. package/src/runtime/crash-recovery.ts +0 -577
  315. package/src/runtime/crew-agent-records.ts +0 -593
  316. package/src/runtime/crew-agent-runtime.ts +0 -62
  317. package/src/runtime/crew-broker-child.ts +0 -88
  318. package/src/runtime/crew-broker-client.ts +0 -673
  319. package/src/runtime/crew-broker-tokens.ts +0 -84
  320. package/src/runtime/crew-broker.ts +0 -1276
  321. package/src/runtime/crew-hooks.ts +0 -227
  322. package/src/runtime/cross-extension-rpc.ts +0 -143
  323. package/src/runtime/custom-tools/irc-tool.ts +0 -282
  324. package/src/runtime/custom-tools/submit-result-tool.ts +0 -102
  325. package/src/runtime/deadletter.ts +0 -47
  326. package/src/runtime/delivery-coordinator.ts +0 -211
  327. package/src/runtime/delta-conflict.ts +0 -348
  328. package/src/runtime/deterministic-ast.ts +0 -161
  329. package/src/runtime/diagnostic-export.ts +0 -171
  330. package/src/runtime/direct-run.ts +0 -45
  331. package/src/runtime/dwf-state-store.ts +0 -102
  332. package/src/runtime/dynamic-workflow-context.ts +0 -1016
  333. package/src/runtime/dynamic-workflow-runner.ts +0 -310
  334. package/src/runtime/effectiveness.ts +0 -90
  335. package/src/runtime/errors/crew-errors.ts +0 -162
  336. package/src/runtime/event-stream-bridge.ts +0 -98
  337. package/src/runtime/foreground-control.ts +0 -193
  338. package/src/runtime/foreground-watchdog.ts +0 -132
  339. package/src/runtime/global-worker-cap.ts +0 -96
  340. package/src/runtime/goal-achievement.ts +0 -148
  341. package/src/runtime/goal-evaluator.ts +0 -361
  342. package/src/runtime/goal-loop-runner.ts +0 -828
  343. package/src/runtime/goal-state-store.ts +0 -219
  344. package/src/runtime/green-contract.ts +0 -55
  345. package/src/runtime/group-join.ts +0 -267
  346. package/src/runtime/handoff-manager.ts +0 -598
  347. package/src/runtime/heartbeat-gradient.ts +0 -36
  348. package/src/runtime/heartbeat-watcher.ts +0 -239
  349. package/src/runtime/hidden-handoff.ts +0 -407
  350. package/src/runtime/important-line-classifier.ts +0 -140
  351. package/src/runtime/intercom-bridge.ts +0 -187
  352. package/src/runtime/iteration-hooks.ts +0 -305
  353. package/src/runtime/live-agent-control.ts +0 -136
  354. package/src/runtime/live-agent-manager.ts +0 -704
  355. package/src/runtime/live-control-realtime.ts +0 -56
  356. package/src/runtime/live-extension-bridge.ts +0 -148
  357. package/src/runtime/live-irc.ts +0 -97
  358. package/src/runtime/live-session-health.ts +0 -108
  359. package/src/runtime/live-session-runtime.ts +0 -1139
  360. package/src/runtime/loop-gates.ts +0 -128
  361. package/src/runtime/manifest-cache.ts +0 -375
  362. package/src/runtime/mcp-proxy.ts +0 -105
  363. package/src/runtime/metric-parser.ts +0 -36
  364. package/src/runtime/model-fallback.ts +0 -409
  365. package/src/runtime/model-resolver.ts +0 -126
  366. package/src/runtime/model-scope.ts +0 -158
  367. package/src/runtime/orphan-worker-registry.ts +0 -465
  368. package/src/runtime/output-validator.ts +0 -202
  369. package/src/runtime/overflow-recovery.ts +0 -206
  370. package/src/runtime/parallel-research.ts +0 -68
  371. package/src/runtime/parallel-utils.ts +0 -160
  372. package/src/runtime/parent-guard.ts +0 -134
  373. package/src/runtime/path-overlap.ts +0 -150
  374. package/src/runtime/peer-dep.ts +0 -292
  375. package/src/runtime/per-write-validator.ts +0 -181
  376. package/src/runtime/phase-progress.ts +0 -217
  377. package/src/runtime/phase-tracker.ts +0 -385
  378. package/src/runtime/pi-args.ts +0 -655
  379. package/src/runtime/pi-json-output.ts +0 -170
  380. package/src/runtime/pi-spawn.ts +0 -273
  381. package/src/runtime/pipeline-runner.ts +0 -523
  382. package/src/runtime/plan-templates.ts +0 -201
  383. package/src/runtime/policy-engine.ts +0 -115
  384. package/src/runtime/post-checks.ts +0 -142
  385. package/src/runtime/post-exit-stdio-guard.ts +0 -104
  386. package/src/runtime/process-lifecycle.ts +0 -491
  387. package/src/runtime/process-status.ts +0 -154
  388. package/src/runtime/progress-event-coalescer.ts +0 -44
  389. package/src/runtime/progress-tracker.ts +0 -124
  390. package/src/runtime/prose-compressor.ts +0 -162
  391. package/src/runtime/recovery-recipes.ts +0 -203
  392. package/src/runtime/replace.ts +0 -570
  393. package/src/runtime/resilient-edit.ts +0 -153
  394. package/src/runtime/result-extractor.ts +0 -213
  395. package/src/runtime/retry-executor.ts +0 -100
  396. package/src/runtime/retry-runner.ts +0 -336
  397. package/src/runtime/role-permission.ts +0 -59
  398. package/src/runtime/run-coalesced-task-group.ts +0 -308
  399. package/src/runtime/run-drift.ts +0 -219
  400. package/src/runtime/run-tracker.ts +0 -116
  401. package/src/runtime/runtime-policy.ts +0 -29
  402. package/src/runtime/runtime-resolver.ts +0 -172
  403. package/src/runtime/runtime-warmup.ts +0 -160
  404. package/src/runtime/scheduler.ts +0 -353
  405. package/src/runtime/semaphore.ts +0 -141
  406. package/src/runtime/sensitive-paths.ts +0 -93
  407. package/src/runtime/session-resources.ts +0 -25
  408. package/src/runtime/session-snapshot.ts +0 -59
  409. package/src/runtime/session-usage.ts +0 -79
  410. package/src/runtime/settings-store.ts +0 -155
  411. package/src/runtime/sidechain-output.ts +0 -35
  412. package/src/runtime/single-agent-compose.ts +0 -84
  413. package/src/runtime/skill-effectiveness.ts +0 -524
  414. package/src/runtime/skill-instructions.ts +0 -391
  415. package/src/runtime/stale-reconciler.ts +0 -680
  416. package/src/runtime/stream-preview.ts +0 -184
  417. package/src/runtime/streaming-output.ts +0 -50
  418. package/src/runtime/subagent-manager.ts +0 -561
  419. package/src/runtime/subprocess-tool-registry.ts +0 -70
  420. package/src/runtime/supervisor-contact.ts +0 -64
  421. package/src/runtime/task-display.ts +0 -52
  422. package/src/runtime/task-graph-scheduler.ts +0 -227
  423. package/src/runtime/task-graph.ts +0 -290
  424. package/src/runtime/task-health.ts +0 -83
  425. package/src/runtime/task-id.ts +0 -161
  426. package/src/runtime/task-output-context.ts +0 -602
  427. package/src/runtime/task-packet.ts +0 -268
  428. package/src/runtime/task-quality.ts +0 -199
  429. package/src/runtime/task-runner/capabilities.ts +0 -78
  430. package/src/runtime/task-runner/context-retrieval.ts +0 -163
  431. package/src/runtime/task-runner/live-executor.ts +0 -227
  432. package/src/runtime/task-runner/output-splitter.ts +0 -152
  433. package/src/runtime/task-runner/progress.ts +0 -157
  434. package/src/runtime/task-runner/prompt-builder.ts +0 -278
  435. package/src/runtime/task-runner/prompt-pipeline.ts +0 -88
  436. package/src/runtime/task-runner/result-utils.ts +0 -16
  437. package/src/runtime/task-runner/retrieval-orchestrator.ts +0 -310
  438. package/src/runtime/task-runner/run-projection.ts +0 -125
  439. package/src/runtime/task-runner/state-helpers.ts +0 -176
  440. package/src/runtime/task-runner/tail-read.ts +0 -34
  441. package/src/runtime/task-runner.ts +0 -1420
  442. package/src/runtime/team-runner-artifacts.ts +0 -13
  443. package/src/runtime/team-runner.ts +0 -1993
  444. package/src/runtime/tool-output-pruner.ts +0 -333
  445. package/src/runtime/tool-progress.ts +0 -278
  446. package/src/runtime/usage-tracker.ts +0 -73
  447. package/src/runtime/verification-gates.ts +0 -571
  448. package/src/runtime/verification-integrity.ts +0 -105
  449. package/src/runtime/verification-worktree.ts +0 -186
  450. package/src/runtime/worker-heartbeat.ts +0 -25
  451. package/src/runtime/worker-startup.ts +0 -83
  452. package/src/runtime/workflow-state.ts +0 -195
  453. package/src/runtime/workspace-lock.ts +0 -443
  454. package/src/runtime/workspace-tree.ts +0 -312
  455. package/src/runtime/yield-handler.ts +0 -224
  456. package/src/runtime/zombie-scanner.ts +0 -298
  457. package/src/schema/config-schema.ts +0 -327
  458. package/src/schema/team-tool-schema.ts +0 -415
  459. package/src/schema/validation-types.ts +0 -159
  460. package/src/skills/discover-skills.ts +0 -197
  461. package/src/skills/skill-templates.ts +0 -456
  462. package/src/skills/validate.ts +0 -285
  463. package/src/state/active-run-registry.ts +0 -439
  464. package/src/state/artifact-store.ts +0 -176
  465. package/src/state/atomic-write.ts +0 -903
  466. package/src/state/blob-store.ts +0 -308
  467. package/src/state/contracts.ts +0 -158
  468. package/src/state/crew-init.ts +0 -269
  469. package/src/state/decision-ledger.ts +0 -345
  470. package/src/state/event-log-rotation.ts +0 -342
  471. package/src/state/event-log.ts +0 -1311
  472. package/src/state/event-reconstructor.ts +0 -229
  473. package/src/state/gitignore-manager.ts +0 -46
  474. package/src/state/health-store.ts +0 -79
  475. package/src/state/hook-instinct-bridge.ts +0 -94
  476. package/src/state/hook-integrations.ts +0 -51
  477. package/src/state/instinct-store.ts +0 -275
  478. package/src/state/jsonl-writer.ts +0 -107
  479. package/src/state/locks.ts +0 -562
  480. package/src/state/mailbox.ts +0 -916
  481. package/src/state/observation-store.ts +0 -176
  482. package/src/state/run-cache.ts +0 -193
  483. package/src/state/run-graph.ts +0 -183
  484. package/src/state/run-metrics.ts +0 -165
  485. package/src/state/schedule.ts +0 -166
  486. package/src/state/session-state-map.ts +0 -51
  487. package/src/state/state-store.ts +0 -958
  488. package/src/state/task-claims.ts +0 -61
  489. package/src/state/tiered-eval.ts +0 -480
  490. package/src/state/types-eval.ts +0 -58
  491. package/src/state/types.ts +0 -440
  492. package/src/state/usage.ts +0 -138
  493. package/src/state/worker-atomic-writer.ts +0 -194
  494. package/src/subagents/async-entry.ts +0 -1
  495. package/src/subagents/index.ts +0 -3
  496. package/src/subagents/live/control.ts +0 -1
  497. package/src/subagents/live/manager.ts +0 -1
  498. package/src/subagents/live/realtime.ts +0 -1
  499. package/src/subagents/live/session-runtime.ts +0 -1
  500. package/src/subagents/manager.ts +0 -1
  501. package/src/subagents/spawn.ts +0 -1
  502. package/src/teams/discover-teams.ts +0 -187
  503. package/src/teams/team-config.ts +0 -27
  504. package/src/teams/team-serializer.ts +0 -38
  505. package/src/tools/safe-bash-extension.ts +0 -54
  506. package/src/tools/safe-bash.ts +0 -505
  507. package/src/types/diff.d.ts +0 -18
  508. package/src/types/new-api-types.ts +0 -35
  509. package/src/ui/agent-management-overlay.ts +0 -160
  510. package/src/ui/card-colors.ts +0 -139
  511. package/src/ui/crew-footer.ts +0 -102
  512. package/src/ui/crew-select-list.ts +0 -111
  513. package/src/ui/dashboard-panes/agents-pane.ts +0 -164
  514. package/src/ui/dashboard-panes/cancellation-pane.ts +0 -66
  515. package/src/ui/dashboard-panes/capability-pane.ts +0 -77
  516. package/src/ui/dashboard-panes/health-pane.ts +0 -31
  517. package/src/ui/dashboard-panes/mailbox-pane.ts +0 -35
  518. package/src/ui/dashboard-panes/metrics-pane.ts +0 -37
  519. package/src/ui/dashboard-panes/progress-pane.ts +0 -38
  520. package/src/ui/dashboard-panes/transcript-pane.ts +0 -10
  521. package/src/ui/deploy-bundled-themes.ts +0 -71
  522. package/src/ui/dwf-phase-display.ts +0 -151
  523. package/src/ui/dynamic-border.ts +0 -35
  524. package/src/ui/heartbeat-aggregator.ts +0 -74
  525. package/src/ui/key-utils.ts +0 -42
  526. package/src/ui/keybinding-map.ts +0 -248
  527. package/src/ui/layout-primitives.ts +0 -106
  528. package/src/ui/live-conversation-overlay.ts +0 -183
  529. package/src/ui/live-duration.ts +0 -55
  530. package/src/ui/live-run-sidebar.ts +0 -293
  531. package/src/ui/loaders.ts +0 -6
  532. package/src/ui/mascot.ts +0 -449
  533. package/src/ui/overlays/agent-picker-overlay.ts +0 -65
  534. package/src/ui/overlays/confirm-overlay.ts +0 -60
  535. package/src/ui/overlays/help-overlay.ts +0 -177
  536. package/src/ui/overlays/mailbox-compose-overlay.ts +0 -181
  537. package/src/ui/overlays/mailbox-compose-preview.ts +0 -78
  538. package/src/ui/overlays/mailbox-detail-overlay.ts +0 -154
  539. package/src/ui/pi-ui-compat.ts +0 -68
  540. package/src/ui/powerbar-publisher.ts +0 -459
  541. package/src/ui/render-coalescer.ts +0 -101
  542. package/src/ui/render-diff.ts +0 -160
  543. package/src/ui/render-scheduler.ts +0 -278
  544. package/src/ui/run-action-dispatcher.ts +0 -182
  545. package/src/ui/run-dashboard.ts +0 -904
  546. package/src/ui/run-event-bus.ts +0 -381
  547. package/src/ui/run-snapshot-cache.ts +0 -1057
  548. package/src/ui/settings-overlay.ts +0 -1067
  549. package/src/ui/shared-overlay-scheduler.ts +0 -96
  550. package/src/ui/snapshot-types.ts +0 -90
  551. package/src/ui/spinner.ts +0 -17
  552. package/src/ui/status-colors.ts +0 -143
  553. package/src/ui/syntax-highlight.ts +0 -136
  554. package/src/ui/terminal-status.ts +0 -269
  555. package/src/ui/theme-adapter.ts +0 -271
  556. package/src/ui/theme-discovery.ts +0 -199
  557. package/src/ui/tool-progress-formatter.ts +0 -93
  558. package/src/ui/tool-render.ts +0 -453
  559. package/src/ui/tool-renderers/brief-mode.ts +0 -225
  560. package/src/ui/tool-renderers/index.ts +0 -726
  561. package/src/ui/transcript-cache.ts +0 -128
  562. package/src/ui/transcript-entries.ts +0 -256
  563. package/src/ui/transcript-viewer.ts +0 -424
  564. package/src/ui/widget/index.ts +0 -391
  565. package/src/ui/widget/widget-formatters.ts +0 -182
  566. package/src/ui/widget/widget-model.ts +0 -110
  567. package/src/ui/widget/widget-renderer.ts +0 -182
  568. package/src/ui/widget/widget-types.ts +0 -36
  569. package/src/utils/bm25-search.ts +0 -235
  570. package/src/utils/completion-dedupe.ts +0 -63
  571. package/src/utils/conflict-detect.ts +0 -668
  572. package/src/utils/env-allowlist.ts +0 -30
  573. package/src/utils/env-filter.ts +0 -155
  574. package/src/utils/file-coalescer.ts +0 -98
  575. package/src/utils/fingerprint.ts +0 -180
  576. package/src/utils/frontmatter.ts +0 -70
  577. package/src/utils/fs-watch.ts +0 -37
  578. package/src/utils/gh-protocol.ts +0 -556
  579. package/src/utils/git.ts +0 -260
  580. package/src/utils/guards.ts +0 -107
  581. package/src/utils/ids.ts +0 -24
  582. package/src/utils/incremental-reader.ts +0 -220
  583. package/src/utils/internal-error.ts +0 -10
  584. package/src/utils/names.ts +0 -36
  585. package/src/utils/ndjson.ts +0 -115
  586. package/src/utils/paths.ts +0 -227
  587. package/src/utils/project-detector.ts +0 -160
  588. package/src/utils/redaction.ts +0 -347
  589. package/src/utils/resolve-shell.ts +0 -36
  590. package/src/utils/run-watcher-registry.ts +0 -152
  591. package/src/utils/safe-paths.ts +0 -383
  592. package/src/utils/scan-cache.ts +0 -144
  593. package/src/utils/session-utils.ts +0 -110
  594. package/src/utils/sleep.ts +0 -54
  595. package/src/utils/socket-path.ts +0 -127
  596. package/src/utils/sse-parser.ts +0 -129
  597. package/src/utils/task-name-generator.ts +0 -337
  598. package/src/utils/timings.ts +0 -33
  599. package/src/utils/token-counter.ts +0 -200
  600. package/src/utils/visual.ts +0 -207
  601. package/src/workflows/cost-estimator.ts +0 -34
  602. package/src/workflows/discover-workflows.ts +0 -290
  603. package/src/workflows/intermediate-store.ts +0 -166
  604. package/src/workflows/preflight-validator.ts +0 -168
  605. package/src/workflows/topology-analyzer.ts +0 -203
  606. package/src/workflows/validate-workflow.ts +0 -50
  607. package/src/workflows/workflow-config.ts +0 -70
  608. package/src/workflows/workflow-serializer.ts +0 -32
  609. package/src/worktree/branch-freshness.ts +0 -112
  610. package/src/worktree/cleanup.ts +0 -341
  611. package/src/worktree/worktree-manager.ts +0 -1200
@@ -1,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
- }