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,56 +0,0 @@
1
- /**
2
- * Stage-chain compression pipeline (P0-A).
3
- *
4
- * Composable, monotonic-shrink-safe text compression. Each stage declares an
5
- * `id` and an `apply(text): string` method. The pipeline runs stages in
6
- * order, applying each stage's output ONLY if it is no longer than the
7
- * stage's input. This is the safety property that prevents the family of
8
- * bugs the old L4 caveman-shrink refactor surfaced (24/27 artifacts corrupted
9
- * with null bytes because a regex-based shrink expanded its input in some
10
- * cases — knowledge.md "L4 output-handling"). With the monotonic-shrink gate,
11
- * a buggy stage implementation can NEVER cause output growth, and therefore
12
- * cannot corrupt downstream structure.
13
- *
14
- * Ported from Hypa's `src/Hypa.Infrastructure/Compression/GenericOutputCompressor.cs`
15
- * (stage loop with `if (next.Length <= text.Length)` gate).
16
- */
17
-
18
- export interface ICompactStage {
19
- /** Stable identifier; surfaced in `PipelineResult.applied` for observability. */
20
- readonly id: string;
21
- /**
22
- * Transform `text`. MUST be pure (no side effects, deterministic for a
23
- * given input). MAY return the input unchanged when nothing to do — the
24
- * pipeline will skip it via the monotonic-shrink gate regardless, but
25
- * returning the same string keeps `applied` honest.
26
- */
27
- apply(text: string): string;
28
- }
29
-
30
- export interface PipelineResult {
31
- text: string;
32
- /** ids of stages whose output was accepted (shorter-or-equal than their input). */
33
- applied: readonly string[];
34
- }
35
-
36
- /**
37
- * Run `stages` in order. Each stage is applied only if its output is no
38
- * longer than its current input. The pipeline NEVER expands text — if a
39
- * stage would expand, it is silently skipped (its id is not added to
40
- * `applied`).
41
- */
42
- export function applyCompactPipeline(text: string, stages: readonly ICompactStage[]): PipelineResult {
43
- let current = text;
44
- const applied: string[] = [];
45
- for (const stage of stages) {
46
- if (!stage || typeof stage.apply !== "function") continue; // defensive: skip malformed entries
47
- const next = stage.apply(current);
48
- if (typeof next !== "string") continue; // defensive: skip non-string output
49
- if (next.length <= current.length) {
50
- current = next;
51
- applied.push(stage.id);
52
- }
53
- // else: stage attempted to expand input — silently drop (monotonic-shrink gate).
54
- }
55
- return { text: current, applied };
56
- }
@@ -1,25 +0,0 @@
1
- /**
2
- * AnsiStripStage — strip ANSI CSI escape sequences.
3
- *
4
- * Matches the common CSI pattern: ESC `[` followed by parameter bytes
5
- * (0-9 ; ?), intermediate bytes (space - /), and a final byte (@-~).
6
- * Sufficient for the color/cursor codes emitted by npm, cargo, jest, etc.
7
- * Does not attempt to handle OSC / DCS / private modes (rare in CLI output
8
- * captured into artifacts; can be added later if real-world signal emerges).
9
- *
10
- * Idempotent (no ANSI in → no change; ANSI in → ANSI out).
11
- */
12
- import type { ICompactStage } from "../compact-pipeline.ts";
13
-
14
- // CSI: ESC [ <params 0-9;> <intermediates space-/ > <final @-~>
15
- const ANSI_CSI_PATTERN = /\x1b\[[0-9;?]*[ -/]*[@-~]/g;
16
-
17
- export class AnsiStripStage implements ICompactStage {
18
- readonly id = "ansi-strip";
19
- apply(text: string): string {
20
- if (text.indexOf("\x1b") === -1) return text; // fast path: no ESC at all
21
- return text.replace(ANSI_CSI_PATTERN, "");
22
- }
23
- }
24
-
25
- export const ANSI_STRIP_STAGE = new AnsiStripStage();
@@ -1,31 +0,0 @@
1
- /**
2
- * BlankCollapseStage — collapse runs of 3+ consecutive newlines to a single
3
- * blank line (i.e., 2 newlines).
4
- *
5
- * Reduces whitespace noise in long command output (npm install, cargo build,
6
- * jest, etc. frequently emit blocks of blank lines between sections). Does
7
- * NOT touch 1 or 2 consecutive newlines — those are legitimate paragraph
8
- * breaks in prose.
9
- *
10
- * Idempotent (already-collapsed input → unchanged).
11
- */
12
- import type { ICompactStage } from "../compact-pipeline.ts";
13
-
14
- export class BlankCollapseStage implements ICompactStage {
15
- readonly id = "blank-collapse";
16
- // NOTE: deliberately NOT using parameter-property shorthand here because
17
- // Node's --experimental-strip-types does not support it. Field + ctor
18
- // assignment is the portable shape.
19
- private readonly minConsecutive: number;
20
- constructor(minConsecutive = 3) {
21
- this.minConsecutive = minConsecutive;
22
- }
23
- apply(text: string): string {
24
- if (this.minConsecutive < 2) return text;
25
- // {minConsecutive,} matches minConsecutive or more; replace with "\n\n" (one blank line).
26
- const pattern = new RegExp(`\\n{${this.minConsecutive},}`, "g");
27
- return text.replace(pattern, "\n\n");
28
- }
29
- }
30
-
31
- export const BLANK_COLLAPSE_STAGE = new BlankCollapseStage();
@@ -1,34 +0,0 @@
1
- /**
2
- * DeduplicateStage — collapse CONSECUTIVE duplicate lines into one.
3
- *
4
- * Useful for log output where the same line repeats (retry attempts, poll
5
- * loops, etc.). Only collapses CONSECUTIVE duplicates — non-adjacent
6
- * repetitions are kept (they may be legitimately repeated later). Does NOT
7
- * touch whitespace-only differences.
8
- *
9
- * Idempotent.
10
- *
11
- * SAFETY: do NOT enable this stage on assistant prose. "I I I went to the
12
- * store" would lose emphasis. compactString's default pipeline does NOT
13
- * include this stage for that reason; it is opt-in only.
14
- */
15
- import type { ICompactStage } from "../compact-pipeline.ts";
16
-
17
- export class DeduplicateStage implements ICompactStage {
18
- readonly id = "deduplicate";
19
- apply(text: string): string {
20
- if (text.length === 0) return text;
21
- const lines = text.split(/\r?\n/);
22
- if (lines.length < 2) return text;
23
- const out: string[] = [lines[0]!];
24
- for (let i = 1; i < lines.length; i++) {
25
- const cur = lines[i]!;
26
- if (cur !== out[out.length - 1]) out.push(cur);
27
- }
28
- // Preserve original line ending style: if input used \r\n, restore that.
29
- const sep = text.includes("\r\n") ? "\r\n" : "\n";
30
- return out.join(sep);
31
- }
32
- }
33
-
34
- export const DEDUPLICATE_STAGE = new DeduplicateStage();
@@ -1,57 +0,0 @@
1
- /**
2
- * HeadSnapStage — keep the first N bytes of the input, optionally snapping to
3
- * the last newline within that region for clean line boundaries.
4
- *
5
- * Distinct from TruncationStage (head + important-middle + tail, P0-B / P0-A):
6
- * this stage is pure head-only with optional newline-snap, used by the
7
- * iteration-hooks hook-output capture where the goal is "first N bytes
8
- * snapped to a clean line" rather than head + tail.
9
- *
10
- * Use case in pi-crew:
11
- * - `iteration-hooks.ts` truncateToLimit — hook stdout capture capped at
12
- * MAX_STDOUT_BYTES (8KB), snapped to the last newline in the head region
13
- * so partial lines never appear in the captured preview.
14
- *
15
- * Byte cap (not char cap) to preserve the original memory budget semantic:
16
- * the input is converted from Buffer to string once, then this stage ensures
17
- * the output never exceeds the byte cap by walking back any partial UTF-8
18
- * sequence at the cut boundary.
19
- */
20
- import type { ICompactStage } from "../compact-pipeline.ts";
21
-
22
- export interface HeadSnapStageConfig {
23
- /** Maximum output size in bytes. */
24
- maxBytes: number;
25
- /** When true, snap the cut to the last newline within the head region. */
26
- snapToNewline?: boolean;
27
- /** Optional explicit id; defaults to "head-snap". */
28
- id?: string;
29
- }
30
-
31
- export class HeadSnapStage implements ICompactStage {
32
- readonly id: string;
33
- private readonly maxBytes: number;
34
- private readonly snapToNewline: boolean;
35
- constructor(config: HeadSnapStageConfig) {
36
- if (!Number.isFinite(config.maxBytes) || config.maxBytes <= 0) {
37
- throw new Error(`HeadSnapStage: maxBytes must be a positive finite number, got ${config.maxBytes}`);
38
- }
39
- this.maxBytes = config.maxBytes;
40
- this.snapToNewline = config.snapToNewline !== false;
41
- this.id = config.id ?? "head-snap";
42
- }
43
- apply(text: string): string {
44
- if (Buffer.byteLength(text, "utf-8") <= this.maxBytes) return text;
45
- // Approximate: slice by char count, then walk back any partial UTF-8
46
- // sequence to keep byte-length <= maxBytes.
47
- let slice = text.slice(0, this.maxBytes);
48
- while (Buffer.byteLength(slice, "utf-8") > this.maxBytes) {
49
- slice = slice.slice(0, slice.length - 1);
50
- }
51
- if (this.snapToNewline) {
52
- const lastNewline = slice.lastIndexOf("\n");
53
- if (lastNewline >= 0) return slice.slice(0, lastNewline);
54
- }
55
- return slice;
56
- }
57
- }
@@ -1,23 +0,0 @@
1
- /**
2
- * Barrel re-exports for the compact-stages module.
3
- *
4
- * Callers import from `../../runtime/compact-stages/index.ts` (or just
5
- * `../../runtime/compact-stages/`) rather than reaching into individual
6
- * stage files, so internal refactors do not break the public surface.
7
- */
8
- export { ANSI_STRIP_STAGE, AnsiStripStage } from "./ansi-strip-stage.ts";
9
- export {
10
- BLANK_COLLAPSE_STAGE,
11
- BlankCollapseStage,
12
- } from "./blank-collapse-stage.ts";
13
- export { DEDUPLICATE_STAGE, DeduplicateStage } from "./deduplicate-stage.ts";
14
- export { HeadSnapStage, type HeadSnapStageConfig } from "./head-snap-stage.ts";
15
- export {
16
- TAIL_CAPTURE_STREAM_STAGE,
17
- TailCaptureStage,
18
- type TailCaptureStageConfig,
19
- } from "./tail-capture-stage.ts";
20
- export {
21
- type TruncationMarkerConfig,
22
- TruncationStage,
23
- } from "./truncation-stage.ts";
@@ -1,77 +0,0 @@
1
- /**
2
- * TailCaptureStage — keep the last N characters/bytes of the input, prepend
3
- * an optional marker when truncation fires.
4
- *
5
- * Distinct from TruncationStage (head + important-middle + tail, P0-B / P0-A):
6
- * this stage is pure tail-capture, used by streaming accumulators that need to
7
- * keep the most recent N chars/bytes and drop the oldest. No important-line
8
- * preservation, no head — just the tail + optional marker.
9
- *
10
- * Use cases in pi-crew:
11
- * - `appendBoundedTail` (child-pi.ts) — stdout/stderr streaming accumulator
12
- * with byte cap and a `[pi-crew captured output truncated to last X KiB]`
13
- * marker.
14
- * - `stream-preview.ts` textBuffer — incremental text buffer for the live UI
15
- * preview, char cap, NO marker (the UI shows raw text without a prefix).
16
- *
17
- * Two cap modes:
18
- * - `maxChars`: character-based cap (UTF-8 safe by definition).
19
- * - `maxBytes`: byte-based cap (legacy, used when memory budget matters
20
- * more than UTF-8 safety). The tail is snapped to the last byte that
21
- * keeps the result ≤ maxBytes to avoid splitting a multi-byte sequence.
22
- */
23
- import type { ICompactStage } from "../compact-pipeline.ts";
24
-
25
- export interface TailCaptureStageConfig {
26
- /** Character cap (UTF-8 safe). Mutually exclusive with maxBytes. */
27
- maxChars?: number;
28
- /** Byte cap (legacy, used by streaming accumulators). Mutually exclusive with maxChars. */
29
- maxBytes?: number;
30
- /** Marker prepended (with a newline separator) when truncation fires. Empty string = no marker. */
31
- marker?: string;
32
- /** Optional explicit id; defaults to "tail-capture" (or "tail-capture-stream" if maxBytes mode). */
33
- id?: string;
34
- }
35
-
36
- export class TailCaptureStage implements ICompactStage {
37
- readonly id: string;
38
- private readonly maxChars: number | undefined;
39
- private readonly maxBytes: number | undefined;
40
- private readonly marker: string;
41
- constructor(config: TailCaptureStageConfig) {
42
- const hasChars = typeof config.maxChars === "number";
43
- const hasBytes = typeof config.maxBytes === "number";
44
- if (hasChars === hasBytes) {
45
- throw new Error(
46
- `TailCaptureStage requires exactly one of maxChars or maxBytes (got chars=${config.maxChars} bytes=${config.maxBytes})`,
47
- );
48
- }
49
- if (hasChars && (config.maxChars as number) <= 0) throw new Error(`TailCaptureStage: maxChars must be > 0, got ${config.maxChars}`);
50
- if (hasBytes && (config.maxBytes as number) <= 0) throw new Error(`TailCaptureStage: maxBytes must be > 0, got ${config.maxBytes}`);
51
- this.maxChars = config.maxChars;
52
- this.maxBytes = config.maxBytes;
53
- this.marker = config.marker ?? "";
54
- this.id = config.id ?? (hasBytes ? "tail-capture" : "tail-capture");
55
- }
56
- apply(text: string): string {
57
- if (this.maxBytes !== undefined) {
58
- // Byte cap mode — snap tail to a UTF-8 char boundary so the result
59
- // never contains a partial multi-byte sequence.
60
- if (Buffer.byteLength(text, "utf-8") <= this.maxBytes) return text;
61
- let tail = text.slice(Math.max(0, text.length - this.maxBytes));
62
- while (Buffer.byteLength(tail, "utf-8") > this.maxBytes) tail = tail.slice(0, -1);
63
- return this.marker ? `${this.marker}\n${tail}` : tail;
64
- }
65
- // Char cap mode.
66
- const max = this.maxChars as number;
67
- if (text.length <= max) return text;
68
- const tail = text.slice(text.length - max);
69
- return this.marker ? `${this.marker}\n${tail}` : tail;
70
- }
71
- }
72
-
73
- /** Singleton: char-cap tail capture with no marker (for `stream-preview.ts` textBuffer). */
74
- export const TAIL_CAPTURE_STREAM_STAGE = new TailCaptureStage({
75
- maxChars: 16_384,
76
- id: "tail-capture-stream",
77
- });
@@ -1,74 +0,0 @@
1
- /**
2
- * TruncationStage — head(75%) + important-middle + tail(25%) compression.
3
- *
4
- * Wraps the head/tail/important-line split (from P0-B's `important-line-classifier.ts`)
5
- * as a pipeline stage so it composes with other stages (ANSI strip, blank
6
- * collapse, etc.). When the input is at or below `maxChars`, returns the
7
- * input unchanged (idempotent — the pipeline gate then marks this stage as
8
- * a no-op).
9
- *
10
- * Marker wording is parameterized so the SAME stage serves both `compactString`
11
- * ("compacted ... chars") and `readIfSmall` ("truncated ... chars") with
12
- * their distinct separators. Defaults match `compactString`'s pre-P0-A output
13
- * exactly so that callers that do not opt into additional stages get
14
- * bit-identical output (L4 backward-compat safety).
15
- */
16
- import type { ICompactStage } from "../compact-pipeline.ts";
17
- import { splitWithImportantLines } from "../important-line-classifier.ts";
18
-
19
- export interface TruncationMarkerConfig {
20
- /** "compacted" (compactString default) or "truncated" (readIfSmall default). */
21
- verb: "compacted" | "truncated";
22
- /** Unit reported in the marker. Both callers currently use "chars" post-Sprint 1. */
23
- unit: "chars" | "bytes";
24
- /** Newline(s) between `head` and the marker line. compactString uses "\n"; readIfSmall uses "\n\n". */
25
- headSeparator: string;
26
- /** Newline(s) between the marker (or joined important lines) and `tail`. Both callers use "\n". */
27
- tailSeparator: string;
28
- }
29
-
30
- const DEFAULT_MARKER: TruncationMarkerConfig = {
31
- verb: "compacted",
32
- unit: "chars",
33
- headSeparator: "\n",
34
- tailSeparator: "\n",
35
- };
36
-
37
- export class TruncationStage implements ICompactStage {
38
- readonly id = "truncation";
39
- private readonly maxChars: number;
40
- private readonly preserveImportant: boolean;
41
- private readonly marker: TruncationMarkerConfig;
42
- constructor(
43
- maxChars: number,
44
- opts: {
45
- preserveImportant?: boolean;
46
- marker?: Partial<TruncationMarkerConfig>;
47
- } = {},
48
- ) {
49
- if (!Number.isFinite(maxChars) || maxChars <= 0) {
50
- throw new Error(`TruncationStage: maxChars must be a positive finite number, got ${maxChars}`);
51
- }
52
- this.maxChars = maxChars;
53
- this.preserveImportant = opts.preserveImportant !== false;
54
- this.marker = { ...DEFAULT_MARKER, ...(opts.marker ?? {}) };
55
- }
56
- apply(text: string): string {
57
- if (text.length <= this.maxChars) return text;
58
- const { head, tail, importantLines, baseDropped } = splitWithImportantLines(text, this.maxChars, {
59
- preserveImportant: this.preserveImportant,
60
- });
61
- let result: string;
62
- if (importantLines.length === 0) {
63
- result = `${head}${this.marker.headSeparator}...[pi-crew ${this.marker.verb} ${baseDropped} ${this.marker.unit}, head+tail preserved]...${this.marker.tailSeparator}${tail}`;
64
- } else {
65
- const joined = importantLines.join("\n");
66
- const remaining = text.length - head.length - tail.length - joined.length;
67
- result = `${head}${this.marker.headSeparator}...[pi-crew ${this.marker.verb} ${baseDropped} ${this.marker.unit}, head+tail + ${importantLines.length} important lines preserved, ${remaining} ${this.marker.unit} remaining dropped]...\n${joined}${this.marker.tailSeparator}${tail}`;
68
- }
69
- // Defense-in-depth: this stage's own monotonic-shrink invariant. The
70
- // pipeline gate is a SECOND line of defense.
71
- if (result.length >= text.length) return text;
72
- return result;
73
- }
74
- }
@@ -1,278 +0,0 @@
1
- /**
2
- * Deterministic compaction summary — builds a markdown summary of a pi-crew run
3
- * from manifest.json, tasks.json, and the tail of events.jsonl.
4
- *
5
- * Distilled from pi-autoresearch's compaction-summary pattern.
6
- */
7
-
8
- class GiantLineFallbackError extends Error {
9
- constructor() {
10
- super("GIANT_LINE_FALLBACK");
11
- this.name = "GiantLineFallbackError";
12
- }
13
- }
14
-
15
- import * as fs from "node:fs";
16
- import * as path from "node:path";
17
- import { readJsonFile } from "../state/atomic-write.ts";
18
- import type { TeamEvent } from "../state/event-log.ts";
19
- import type { TeamRunManifest, TeamTaskState } from "../state/types.ts";
20
-
21
- /** Maximum number of events to read from the tail of events.jsonl. */
22
- const MAX_TAIL_EVENTS = 100;
23
-
24
- /** Maximum number of completed tasks to include in the "Recent Results" section. */
25
- const MAX_RECENT_RESULTS = 10;
26
-
27
- /** Paths relevant to building a compaction summary for a run. */
28
- export interface SummaryPaths {
29
- manifestPath: string;
30
- tasksPath: string;
31
- eventsPath: string;
32
- stateRoot: string;
33
- }
34
-
35
- /**
36
- * Derive the standard summary-relevant paths from a state root directory.
37
- * Mirrors pi-autoresearch's `autoresearchSummaryPathsFor()`.
38
- */
39
- export function summaryPathsFor(stateRoot: string): SummaryPaths {
40
- return {
41
- stateRoot,
42
- manifestPath: path.join(stateRoot, "manifest.json"),
43
- tasksPath: path.join(stateRoot, "tasks.json"),
44
- eventsPath: path.join(stateRoot, "events.jsonl"),
45
- };
46
- }
47
-
48
- /**
49
- * Read the last N lines from a text file.
50
- * Uses reverse buffer reading to avoid loading the entire file into memory.
51
- * For files larger than TAIL_MAX_READ bytes, only the last chunk is read.
52
- */
53
- const TAIL_MAX_READ = 256 * 1024; // 256KB — enough for ~1000 lines of JSONL
54
- const MAX_FALLBACK_READ = 2 * 1024 * 1024; // 2MB — safety limit for giant-line fallback
55
- function readTailLines(filePath: string, maxLines: number): string[] {
56
- if (!fs.existsSync(filePath)) return [];
57
- try {
58
- const stat = fs.statSync(filePath);
59
- const fileSize = stat.size;
60
- if (fileSize === 0) return [];
61
-
62
- // For small files, just read everything
63
- if (fileSize <= TAIL_MAX_READ) {
64
- const content = fs.readFileSync(filePath, "utf-8");
65
- return content
66
- .split("\n")
67
- .filter((line) => line.trim().length > 0)
68
- .slice(-maxLines);
69
- }
70
-
71
- // For large files, read only the last chunk.
72
- // Search backwards from the read boundary for a newline to avoid
73
- // splitting mid-line or mid-multibyte UTF-8 character.
74
- const fd = fs.openSync(filePath, "r");
75
- try {
76
- const readSize = Math.min(fileSize, TAIL_MAX_READ);
77
- const readOffset = fileSize - readSize;
78
- const buf = Buffer.alloc(readSize);
79
- fs.readSync(fd, buf, 0, readSize, readOffset);
80
-
81
- // Find the first newline in the buffer to avoid partial lines.
82
- // This also handles multibyte UTF-8 safety — we start after a
83
- // newline boundary which is always a clean character boundary.
84
- let start = 0;
85
- if (readOffset > 0) {
86
- const firstNewline = buf.indexOf("\n");
87
- if (firstNewline >= 0) {
88
- start = firstNewline + 1;
89
- } else {
90
- // No newline found in the entire tail chunk — single giant line.
91
- // Fall back to reading the full file to avoid data loss.
92
- // Note: fd will be closed by the outer finally block.
93
- throw new GiantLineFallbackError();
94
- }
95
- }
96
-
97
- const content = buf.toString("utf-8", start, readSize);
98
- const lines = content.split("\n").filter((line) => line.trim().length > 0);
99
- return lines.slice(-maxLines);
100
- } finally {
101
- fs.closeSync(fd);
102
- }
103
- } catch (err) {
104
- // Giant-line fallback: fd already closed by finally above.
105
- if (err instanceof GiantLineFallbackError) {
106
- const stat = fs.statSync(filePath);
107
- if (stat.size > MAX_FALLBACK_READ) return [];
108
- const content = fs.readFileSync(filePath, "utf-8");
109
- return content
110
- .split("\n")
111
- .filter((line) => line.trim().length > 0)
112
- .slice(-maxLines);
113
- }
114
- return [];
115
- }
116
- }
117
-
118
- /**
119
- * Parse JSONL lines into TeamEvent objects, skipping malformed lines.
120
- */
121
- function parseEvents(lines: string[]): TeamEvent[] {
122
- const events: TeamEvent[] = [];
123
- for (const line of lines) {
124
- try {
125
- const parsed = JSON.parse(line.trim());
126
- if (typeof parsed === "object" && parsed !== null && typeof parsed.type === "string" && typeof parsed.runId === "string") {
127
- events.push(parsed as TeamEvent);
128
- }
129
- } catch {
130
- // Skip malformed lines
131
- }
132
- }
133
- return events;
134
- }
135
-
136
- /**
137
- * Compute a human-readable duration between two ISO timestamp strings.
138
- */
139
- function formatDuration(startIso?: string, endIso?: string): string {
140
- if (!startIso) return "—";
141
- const start = new Date(startIso).getTime();
142
- if (Number.isNaN(start)) return "—";
143
- const end = endIso ? new Date(endIso).getTime() : Date.now();
144
- if (Number.isNaN(end)) return "—";
145
- const diffMs = end - start;
146
- if (diffMs < 0) return "—";
147
- const seconds = Math.floor(diffMs / 1000);
148
- if (seconds < 60) return `${seconds}s`;
149
- const minutes = Math.floor(seconds / 60);
150
- const remainingSeconds = seconds % 60;
151
- if (minutes < 60) return `${minutes}m ${remainingSeconds}s`;
152
- const hours = Math.floor(minutes / 60);
153
- const remainingMinutes = minutes % 60;
154
- return `${hours}h ${remainingMinutes}m`;
155
- }
156
-
157
- /**
158
- * Build a deterministic compaction summary for a pi-crew run.
159
- *
160
- * Reads manifest.json, tasks.json, and the tail of events.jsonl to produce
161
- * a self-contained markdown summary suitable for context injection.
162
- *
163
- * @param stateRoot - Path to the run's state root directory
164
- * @returns Markdown-formatted compaction summary
165
- */
166
- export function buildCompactionSummary(stateRoot: string): string {
167
- const paths = summaryPathsFor(stateRoot);
168
-
169
- // Read manifest
170
- const manifest = readJsonFile<TeamRunManifest>(paths.manifestPath);
171
-
172
- // Read tasks
173
- const tasks = readJsonFile<TeamTaskState[]>(paths.tasksPath) ?? [];
174
-
175
- // Read tail events
176
- const tailLines = readTailLines(paths.eventsPath, MAX_TAIL_EVENTS);
177
- const tailEvents = parseEvents(tailLines);
178
-
179
- const sections: string[] = [];
180
-
181
- // Section: Run Metadata
182
- sections.push("# Run Summary");
183
- if (manifest) {
184
- sections.push("");
185
- sections.push("## Run Metadata");
186
- sections.push(`- **Run ID**: ${manifest.runId}`);
187
- sections.push(`- **Team**: ${manifest.team}`);
188
- if (manifest.workflow) {
189
- sections.push(`- **Workflow**: ${manifest.workflow}`);
190
- }
191
- if (manifest.goal) {
192
- sections.push(`- **Goal**: ${manifest.goal.replace(/\n/g, " ").slice(0, 500)}`);
193
- }
194
- sections.push(`- **Status**: ${manifest.status}`);
195
- sections.push(`- **Created**: ${manifest.createdAt}`);
196
- sections.push(`- **Updated**: ${manifest.updatedAt}`);
197
- if (manifest.workspaceMode) {
198
- sections.push(`- **Workspace Mode**: ${manifest.workspaceMode}`);
199
- }
200
- } else {
201
- sections.push("");
202
- sections.push("## Run Metadata");
203
- sections.push("- **Status**: manifest unavailable");
204
- }
205
-
206
- // Section: Task Progress Table
207
- sections.push("");
208
- sections.push("## Task Progress");
209
- if (tasks.length > 0) {
210
- sections.push("");
211
- sections.push("| ID | Role | Status | Duration |");
212
- sections.push("|---|---|---|---|");
213
- for (const task of tasks) {
214
- const taskId = task.id;
215
- const role = task.role || "—";
216
- const status = task.status || "—";
217
- const duration = formatDuration(task.startedAt, task.finishedAt);
218
- sections.push(`| ${taskId} | ${role} | ${status} | ${duration} |`);
219
- }
220
- } else {
221
- sections.push("");
222
- sections.push("No tasks recorded.");
223
- }
224
-
225
- // Section: Recent Task Results
226
- const completedTasks = tasks.filter((t) => t.status === "completed" || t.status === "failed").slice(-MAX_RECENT_RESULTS);
227
-
228
- if (completedTasks.length > 0) {
229
- sections.push("");
230
- sections.push("## Recent Task Results");
231
- for (const task of completedTasks) {
232
- sections.push("");
233
- sections.push(`### ${task.id} (${task.status})`);
234
- if (task.error) {
235
- sections.push(`- **Error**: ${task.error}`);
236
- }
237
- if (task.diagnostics && Object.keys(task.diagnostics).length > 0) {
238
- sections.push("- **Diagnostics**:");
239
- for (const [key, value] of Object.entries(task.diagnostics)) {
240
- sections.push(` - ${key}: ${JSON.stringify(value)}`);
241
- }
242
- }
243
- if (task.metrics && Object.keys(task.metrics).length > 0) {
244
- sections.push("- **Metrics**:");
245
- for (const [key, value] of Object.entries(task.metrics)) {
246
- sections.push(` - ${key}: ${value}`);
247
- }
248
- }
249
- }
250
- }
251
-
252
- // Section: Next Steps (pending/queued tasks)
253
- const pendingStatuses = new Set(["queued", "waiting", "running"]);
254
- const pendingTasks = tasks.filter((t) => pendingStatuses.has(t.status));
255
- if (pendingTasks.length > 0) {
256
- sections.push("");
257
- sections.push("## Next Steps");
258
- sections.push("");
259
- for (const task of pendingTasks) {
260
- const title = task.title || task.role || "Untitled";
261
- sections.push(`- [${task.status}] ${task.id}: ${title}`);
262
- }
263
- }
264
-
265
- // Section: Tail Events Summary
266
- if (tailEvents.length > 0) {
267
- sections.push("");
268
- sections.push(`## Recent Events (last ${tailEvents.length})`);
269
- sections.push("");
270
- for (const event of tailEvents.slice(-10)) {
271
- const taskPart = event.taskId ? ` task=${event.taskId}` : "";
272
- const msgPart = event.message ? ` — ${event.message}` : "";
273
- sections.push(`- [${event.time}] ${event.type}${taskPart}${msgPart}`);
274
- }
275
- }
276
-
277
- return sections.join("\n");
278
- }