pi-crew 0.9.50 → 0.9.52

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (609) hide show
  1. package/CHANGELOG.md +150 -0
  2. package/README.md +216 -20
  3. package/dist/build-meta.json +2222 -1761
  4. package/dist/index.mjs +18636 -17603
  5. package/docs/actions-reference.md +431 -1
  6. package/package.json +19 -9
  7. package/schema.json +41 -0
  8. package/scripts/check-bundle-size.mjs +38 -0
  9. package/scripts/test-runner.mjs +11 -1
  10. package/skills/distill-software/SKILL.md +24 -1
  11. package/dist/index.mjs.map +0 -7
  12. package/docs/FEATURE_INTAKE.md +0 -126
  13. package/docs/HARNESS.md +0 -87
  14. package/docs/HARNESS_BACKLOG.md +0 -89
  15. package/docs/PROJECT_REVIEW.md +0 -270
  16. package/docs/PROJECT_REVIEW_FIXES.md +0 -342
  17. package/docs/PROJECT_REVIEW_ROUND4.md +0 -156
  18. package/docs/PROJECT_REVIEW_ROUND5.md +0 -86
  19. package/docs/REVIEW-FINDINGS-2026-06 +0 -357
  20. package/docs/REVIEW-FINDINGS-2026-07-CORE.md +0 -139
  21. package/docs/REVIEW-FINDINGS-2026-07.md +0 -125
  22. package/docs/TEST_MATRIX.md +0 -51
  23. package/docs/archive/README.md +0 -91
  24. package/docs/archive/followup-review-round3-2026-05-12.md +0 -342
  25. package/docs/archive/followup-review-round4-2026-05-13.md +0 -107
  26. package/docs/archive/pi-crew-bugs.md +0 -961
  27. package/docs/archive/pi-crew-test-final.md +0 -120
  28. package/docs/archive/pi-crew-test-results.md +0 -260
  29. package/docs/archive/pi-crew-test-round2.md +0 -136
  30. package/docs/archive/pi-crew-test-round4.md +0 -100
  31. package/docs/archive/pi-crew-test-round5.md +0 -70
  32. package/docs/archive/pi-crew-test-round6.md +0 -110
  33. package/docs/archive/pi-crew-v0.5.10-audit-fix-plan.md +0 -60
  34. package/docs/archive/pi-crew-v0.5.11-audit-fix-plan.md +0 -92
  35. package/docs/archive/pi-crew-v0.5.12-audit-fix-plan.md +0 -76
  36. package/docs/archive/pi-crew-v0.5.13-audit-fix-plan.md +0 -75
  37. package/docs/archive/pi-crew-v0.5.14-audit-fix-plan.md +0 -75
  38. package/docs/archive/pi-crew-v0.5.16-audit-fix-plan.md +0 -35
  39. package/docs/archive/pi-crew-v0.5.17-audit-fix-plan.md +0 -80
  40. package/docs/archive/pi-crew-v0.5.5-audit-fix-plan.md +0 -133
  41. package/docs/archive/pi-crew-v0.5.9-audit-fix-plan.md +0 -88
  42. package/docs/archive/pi-mono-opportunities.md +0 -969
  43. package/docs/archive/pi-mono-review.md +0 -291
  44. package/docs/archive/pi-subagent4-comparison.md +0 -261
  45. package/docs/archive/pi-subagents3-deep-analysis.md +0 -508
  46. package/docs/bugs/bug-021-notification-badge-counter-misleading.md +0 -293
  47. package/docs/bugs/bug-023-chain-windows-path-resolution.md +0 -106
  48. package/docs/bugs/bug-quota-display-truncation.md +0 -223
  49. package/docs/bugs/cross-session-notification-leakage.md +0 -82
  50. package/docs/code-review-2026-05-11.md +0 -592
  51. package/docs/coding-agent-optimization.md +0 -268
  52. package/docs/comparison-pi-subagents-vs-pi-crew.md +0 -303
  53. package/docs/decisions/0001-durable-state.md +0 -41
  54. package/docs/decisions/0002-child-process-for-async.md +0 -42
  55. package/docs/decisions/0003-depth-guard.md +0 -36
  56. package/docs/decisions/0004-execfile-over-exec.md +0 -34
  57. package/docs/decisions/0005-no-parameter-properties.md +0 -49
  58. package/docs/decisions/0006-publish-bundled-esm.md +0 -63
  59. package/docs/decisions/0007-active-run-binary-index.md +0 -54
  60. package/docs/decisions/0008-child-pi-warm-pool.md +0 -61
  61. package/docs/decisions/2026-07-21-broker-phase4-default-on.md +0 -77
  62. package/docs/decisions/2026-07-21-broker-windows-perms.md +0 -91
  63. package/docs/decisions/2026-07-22-broker-phase4-gated-on.md +0 -99
  64. package/docs/decisions/2026-07-24-oidc-trusted-publishing.md +0 -112
  65. package/docs/decisions/README.md +0 -26
  66. package/docs/deep-review-report.md +0 -384
  67. package/docs/distillation/cybersecurity-patterns.md +0 -294
  68. package/docs/feature-analysis-subagent4.md +0 -305
  69. package/docs/fix-plan-disabletools-exit-null.md +0 -219
  70. package/docs/fixes/BATCH_A_H1_H2.md +0 -86
  71. package/docs/fixes/bug-006-foreground-cancel-concurrent.md +0 -78
  72. package/docs/fixes/bug-007-async-notifier-stale-ctx.md +0 -112
  73. package/docs/fixes/bug-008-child-process-silent-timeout.md +0 -100
  74. package/docs/fixes/bug-009-executor-yield-limit-needs-attention.md +0 -75
  75. package/docs/fixes/bug-010-child-process-api-key-filtered.md +0 -109
  76. package/docs/fixes/bug-011-spawn-pi-enoent.md +0 -92
  77. package/docs/fixes/bug-012-essential-env-stripped.md +0 -89
  78. package/docs/fixes/bug-013-background-runner-death.md +0 -84
  79. package/docs/fixes/bug-014-infinite-retry-loop-needs-attention.md +0 -82
  80. package/docs/fixes/bug-015-background-runner-sigterm.md +0 -65
  81. package/docs/fixes/bug-017-background-runner-session-shutdown.md +0 -66
  82. package/docs/fixes/bug-017-background-runner-sigkill-double-fork.md +0 -28
  83. package/docs/fixes/bug-018-child-pi-worker-stdin-hang.md +0 -61
  84. package/docs/fixes/bug-019-phantom-runs-temp-workspace.md +0 -52
  85. package/docs/fixes/bug-020-infinite-retry-loop-needs-attention.md +0 -47
  86. package/docs/fixes/v0.9.10/locks-fix-verify.md +0 -3
  87. package/docs/fixes/v0.9.10/smoke-test.md +0 -12
  88. package/docs/followup-plan-2026-05-12.md +0 -463
  89. package/docs/followup-review-2026-05-12.md +0 -297
  90. package/docs/goals.md +0 -59
  91. package/docs/implementation-plan-top3.md +0 -333
  92. package/docs/issue-29-analysis.md +0 -189
  93. package/docs/live-mailbox-runtime.md +0 -36
  94. package/docs/migration/atomic-write-v2-migration.md +0 -299
  95. package/docs/next-upgrade-roadmap.md +0 -808
  96. package/docs/oh-my-pi-research.md +0 -509
  97. package/docs/optimization-plan-2026-07.md +0 -366
  98. package/docs/optimization-plan.md +0 -644
  99. package/docs/patterns/command-agent-skill.md +0 -71
  100. package/docs/perf/baseline-2026-05.md +0 -113
  101. package/docs/perf/final-report-2026-05.md +0 -206
  102. package/docs/perf/optimization-plan-2026-07-verified.md +0 -396
  103. package/docs/perf/performance-audit-report-2026-07.md +0 -948
  104. package/docs/perf/performance-review-2026-07.md +0 -287
  105. package/docs/perf/sprint-1-report.md +0 -71
  106. package/docs/perf/sprint-2-report.md +0 -81
  107. package/docs/perf/sprint-2.5-report.md +0 -53
  108. package/docs/perf/sprint-3-report.md +0 -36
  109. package/docs/perf/sprint-4-report.md +0 -47
  110. package/docs/perf/sprint-5-report.md +0 -51
  111. package/docs/perf/sprint-6-report.md +0 -94
  112. package/docs/perf/sprint-7-report.md +0 -74
  113. package/docs/perf/upgrade-plan-2026-05.md +0 -147
  114. package/docs/performance-optimization-execution-plan.md +0 -520
  115. package/docs/phase4-triage.md +0 -58
  116. package/docs/pi-crew-investigation-report.md +0 -411
  117. package/docs/product/README.md +0 -31
  118. package/docs/product/platform.md +0 -27
  119. package/docs/product/runtime-safety.md +0 -37
  120. package/docs/product/team-run.md +0 -39
  121. package/docs/product/team-tool.md +0 -37
  122. package/docs/runtime-analysis-child-vs-live.md +0 -171
  123. package/docs/runtime-migration-in-process-analysis.md +0 -250
  124. package/docs/skills/REFERENCE.md +0 -138
  125. package/docs/stories/README.md +0 -32
  126. package/docs/stories/US-DEPS-major-upgrade.md +0 -62
  127. package/docs/stories/backlog.md +0 -36
  128. package/docs/superpowers/plans/2026-06-09-fallow-patterns-adoption.md +0 -1270
  129. package/docs/templates/decision.md +0 -27
  130. package/docs/templates/story.md +0 -44
  131. package/docs/templates/validation-report.md +0 -32
  132. package/docs/ui-optimization-plan.md +0 -447
  133. package/src/adapters/claude-adapter.ts +0 -23
  134. package/src/adapters/codex-adapter.ts +0 -21
  135. package/src/adapters/cursor-adapter.ts +0 -17
  136. package/src/adapters/export-util.ts +0 -143
  137. package/src/adapters/index.ts +0 -15
  138. package/src/adapters/registry.ts +0 -18
  139. package/src/adapters/types.ts +0 -23
  140. package/src/agents/agent-config.ts +0 -194
  141. package/src/agents/agent-search.ts +0 -98
  142. package/src/agents/agent-serializer.ts +0 -38
  143. package/src/agents/discover-agents.ts +0 -623
  144. package/src/benchmark/benchmark-runner.ts +0 -313
  145. package/src/benchmark/feedback-loop.ts +0 -73
  146. package/src/config/config.ts +0 -1269
  147. package/src/config/defaults.ts +0 -193
  148. package/src/config/drift-detector.ts +0 -290
  149. package/src/config/markers.ts +0 -330
  150. package/src/config/resilient-parser.ts +0 -117
  151. package/src/config/role-tools.ts +0 -118
  152. package/src/config/suggestions.ts +0 -75
  153. package/src/config/types.ts +0 -278
  154. package/src/errors.ts +0 -194
  155. package/src/extension/action-suggestions.ts +0 -117
  156. package/src/extension/async-notifier.ts +0 -179
  157. package/src/extension/autonomous-policy.ts +0 -209
  158. package/src/extension/command-completions.ts +0 -120
  159. package/src/extension/context-status-injection.ts +0 -185
  160. package/src/extension/crew-autocomplete.ts +0 -131
  161. package/src/extension/crew-cleanup.ts +0 -168
  162. package/src/extension/crew-input-router.ts +0 -93
  163. package/src/extension/crew-shortcuts.ts +0 -87
  164. package/src/extension/crew-vibes/cat-frames.ts +0 -18
  165. package/src/extension/crew-vibes/config.ts +0 -195
  166. package/src/extension/crew-vibes/figures.ts +0 -101
  167. package/src/extension/crew-vibes/font-detect.ts +0 -71
  168. package/src/extension/crew-vibes/footer.ts +0 -292
  169. package/src/extension/crew-vibes/index.ts +0 -432
  170. package/src/extension/crew-vibes/provider-usage.ts +0 -396
  171. package/src/extension/crew-vibes/render.ts +0 -206
  172. package/src/extension/crew-vibes/speed.ts +0 -286
  173. package/src/extension/cross-extension-rpc.ts +0 -350
  174. package/src/extension/help.ts +0 -62
  175. package/src/extension/import-index.ts +0 -74
  176. package/src/extension/knowledge-injection.ts +0 -402
  177. package/src/extension/management.ts +0 -571
  178. package/src/extension/message-renderers.ts +0 -108
  179. package/src/extension/notification-router.ts +0 -152
  180. package/src/extension/notification-sink.ts +0 -54
  181. package/src/extension/pi-api.ts +0 -56
  182. package/src/extension/plan-orchestrate.ts +0 -302
  183. package/src/extension/project-init.ts +0 -170
  184. package/src/extension/register.ts +0 -113
  185. package/src/extension/registration/artifact-cleanup.ts +0 -20
  186. package/src/extension/registration/command-registration.ts +0 -58
  187. package/src/extension/registration/command-utils.ts +0 -58
  188. package/src/extension/registration/commands.ts +0 -1228
  189. package/src/extension/registration/compaction-guard.ts +0 -333
  190. package/src/extension/registration/context-builder.ts +0 -135
  191. package/src/extension/registration/crash-recovery-cache.ts +0 -54
  192. package/src/extension/registration/foreground-run-controller.ts +0 -238
  193. package/src/extension/registration/hook-registration.ts +0 -119
  194. package/src/extension/registration/lazy-configurers.ts +0 -124
  195. package/src/extension/registration/lifecycle-handlers.ts +0 -923
  196. package/src/extension/registration/lifecycle.ts +0 -259
  197. package/src/extension/registration/observability.ts +0 -322
  198. package/src/extension/registration/registration-types.ts +0 -158
  199. package/src/extension/registration/runtime-cleanup.ts +0 -230
  200. package/src/extension/registration/subagent-helpers.ts +0 -125
  201. package/src/extension/registration/subagent-manager-setup.ts +0 -330
  202. package/src/extension/registration/subagent-tools.ts +0 -456
  203. package/src/extension/registration/team-tool.ts +0 -220
  204. package/src/extension/registration/tool-registration.ts +0 -50
  205. package/src/extension/registration/ui.ts +0 -172
  206. package/src/extension/registration/viewers.ts +0 -121
  207. package/src/extension/registration/wire-cross-extension.ts +0 -37
  208. package/src/extension/result-watcher.ts +0 -139
  209. package/src/extension/rpc-hmac.ts +0 -256
  210. package/src/extension/run-bundle-schema.ts +0 -104
  211. package/src/extension/run-export.ts +0 -97
  212. package/src/extension/run-import.ts +0 -168
  213. package/src/extension/run-index.ts +0 -131
  214. package/src/extension/run-maintenance.ts +0 -190
  215. package/src/extension/session-summary.ts +0 -18
  216. package/src/extension/team-manager-command.ts +0 -153
  217. package/src/extension/team-onboard.ts +0 -177
  218. package/src/extension/team-recommendation.ts +0 -288
  219. package/src/extension/team-tool/anchor.ts +0 -172
  220. package/src/extension/team-tool/api.ts +0 -1244
  221. package/src/extension/team-tool/auto-summarize.ts +0 -142
  222. package/src/extension/team-tool/cache-control.ts +0 -19
  223. package/src/extension/team-tool/cancel.ts +0 -337
  224. package/src/extension/team-tool/chain-dispatch.ts +0 -95
  225. package/src/extension/team-tool/chain-executor.ts +0 -379
  226. package/src/extension/team-tool/config-patch.ts +0 -50
  227. package/src/extension/team-tool/context.ts +0 -149
  228. package/src/extension/team-tool/destructive-gate.ts +0 -52
  229. package/src/extension/team-tool/doctor.ts +0 -431
  230. package/src/extension/team-tool/explain.ts +0 -282
  231. package/src/extension/team-tool/failure-patterns.ts +0 -118
  232. package/src/extension/team-tool/goal-wrap.ts +0 -330
  233. package/src/extension/team-tool/goal.ts +0 -556
  234. package/src/extension/team-tool/handle-schedule.ts +0 -332
  235. package/src/extension/team-tool/handle-settings.ts +0 -520
  236. package/src/extension/team-tool/health-monitor.ts +0 -481
  237. package/src/extension/team-tool/inspect.ts +0 -88
  238. package/src/extension/team-tool/intent-policy.ts +0 -45
  239. package/src/extension/team-tool/lifecycle-actions.ts +0 -615
  240. package/src/extension/team-tool/orchestrate.ts +0 -98
  241. package/src/extension/team-tool/parallel-dispatch.ts +0 -183
  242. package/src/extension/team-tool/plan.ts +0 -50
  243. package/src/extension/team-tool/respond.ts +0 -150
  244. package/src/extension/team-tool/run-not-found.ts +0 -49
  245. package/src/extension/team-tool/run.ts +0 -1035
  246. package/src/extension/team-tool/status.ts +0 -260
  247. package/src/extension/team-tool/workflow-manage.ts +0 -261
  248. package/src/extension/team-tool-types.ts +0 -26
  249. package/src/extension/team-tool.ts +0 -1116
  250. package/src/extension/tool-result.ts +0 -16
  251. package/src/extension/validate-resources.ts +0 -108
  252. package/src/hooks/registry.ts +0 -200
  253. package/src/hooks/types.ts +0 -69
  254. package/src/i18n.ts +0 -212
  255. package/src/observability/correlation.ts +0 -50
  256. package/src/observability/event-bus.ts +0 -86
  257. package/src/observability/event-to-metric.ts +0 -170
  258. package/src/observability/exporters/adapter.ts +0 -27
  259. package/src/observability/exporters/otlp-exporter.ts +0 -356
  260. package/src/observability/exporters/prometheus-exporter.ts +0 -54
  261. package/src/observability/metric-registry.ts +0 -100
  262. package/src/observability/metric-retention.ts +0 -64
  263. package/src/observability/metric-sink.ts +0 -99
  264. package/src/observability/metrics-primitives.ts +0 -219
  265. package/src/plugins/plugin-define.ts +0 -6
  266. package/src/plugins/plugin-registry.ts +0 -32
  267. package/src/plugins/plugins/index.ts +0 -3
  268. package/src/plugins/plugins/nextjs.ts +0 -19
  269. package/src/plugins/plugins/vite.ts +0 -10
  270. package/src/plugins/plugins/vitest.ts +0 -9
  271. package/src/prompt/prompt-runtime.ts +0 -380
  272. package/src/runtime/adaptive-plan.ts +0 -563
  273. package/src/runtime/agent-control.ts +0 -215
  274. package/src/runtime/agent-memory.ts +0 -81
  275. package/src/runtime/agent-observability.ts +0 -122
  276. package/src/runtime/anchor-manager.ts +0 -475
  277. package/src/runtime/async-marker.ts +0 -32
  278. package/src/runtime/async-runner.ts +0 -381
  279. package/src/runtime/attention-events.ts +0 -28
  280. package/src/runtime/auto-summarize.ts +0 -344
  281. package/src/runtime/background-runner.ts +0 -837
  282. package/src/runtime/batch-barrier.ts +0 -147
  283. package/src/runtime/broker-issuer.ts +0 -37
  284. package/src/runtime/cancellation-token.ts +0 -99
  285. package/src/runtime/cancellation.ts +0 -99
  286. package/src/runtime/capability-inventory.ts +0 -137
  287. package/src/runtime/chain-parser.ts +0 -237
  288. package/src/runtime/chain-runner.ts +0 -606
  289. package/src/runtime/checkpoint.ts +0 -291
  290. package/src/runtime/child-pi-constants.ts +0 -42
  291. package/src/runtime/child-pi-kill.ts +0 -180
  292. package/src/runtime/child-pi-pool.ts +0 -68
  293. package/src/runtime/child-pi-spawn.ts +0 -287
  294. package/src/runtime/child-pi-steering.ts +0 -128
  295. package/src/runtime/child-pi-streams.ts +0 -296
  296. package/src/runtime/child-pi-transcript.ts +0 -169
  297. package/src/runtime/child-pi.ts +0 -1105
  298. package/src/runtime/coalesce-tasks.ts +0 -268
  299. package/src/runtime/code-summary.ts +0 -292
  300. package/src/runtime/command-trace.ts +0 -105
  301. package/src/runtime/compact-pipeline.ts +0 -56
  302. package/src/runtime/compact-stages/ansi-strip-stage.ts +0 -25
  303. package/src/runtime/compact-stages/blank-collapse-stage.ts +0 -31
  304. package/src/runtime/compact-stages/deduplicate-stage.ts +0 -34
  305. package/src/runtime/compact-stages/head-snap-stage.ts +0 -57
  306. package/src/runtime/compact-stages/index.ts +0 -23
  307. package/src/runtime/compact-stages/tail-capture-stage.ts +0 -77
  308. package/src/runtime/compact-stages/truncation-stage.ts +0 -74
  309. package/src/runtime/compaction-summary.ts +0 -278
  310. package/src/runtime/completion-guard.ts +0 -207
  311. package/src/runtime/concurrency.ts +0 -58
  312. package/src/runtime/crash-classification.ts +0 -229
  313. package/src/runtime/crash-recovery.ts +0 -577
  314. package/src/runtime/crew-agent-records.ts +0 -593
  315. package/src/runtime/crew-agent-runtime.ts +0 -62
  316. package/src/runtime/crew-broker-child.ts +0 -88
  317. package/src/runtime/crew-broker-client.ts +0 -673
  318. package/src/runtime/crew-broker-tokens.ts +0 -84
  319. package/src/runtime/crew-broker.ts +0 -1276
  320. package/src/runtime/crew-hooks.ts +0 -227
  321. package/src/runtime/cross-extension-rpc.ts +0 -143
  322. package/src/runtime/custom-tools/irc-tool.ts +0 -282
  323. package/src/runtime/custom-tools/submit-result-tool.ts +0 -102
  324. package/src/runtime/deadletter.ts +0 -47
  325. package/src/runtime/delivery-coordinator.ts +0 -211
  326. package/src/runtime/delta-conflict.ts +0 -348
  327. package/src/runtime/deterministic-ast.ts +0 -161
  328. package/src/runtime/diagnostic-export.ts +0 -171
  329. package/src/runtime/direct-run.ts +0 -45
  330. package/src/runtime/dwf-state-store.ts +0 -102
  331. package/src/runtime/dynamic-workflow-context.ts +0 -1016
  332. package/src/runtime/dynamic-workflow-runner.ts +0 -310
  333. package/src/runtime/effectiveness.ts +0 -90
  334. package/src/runtime/errors/crew-errors.ts +0 -162
  335. package/src/runtime/event-stream-bridge.ts +0 -98
  336. package/src/runtime/foreground-control.ts +0 -193
  337. package/src/runtime/foreground-watchdog.ts +0 -132
  338. package/src/runtime/global-worker-cap.ts +0 -96
  339. package/src/runtime/goal-achievement.ts +0 -148
  340. package/src/runtime/goal-evaluator.ts +0 -361
  341. package/src/runtime/goal-loop-runner.ts +0 -828
  342. package/src/runtime/goal-state-store.ts +0 -219
  343. package/src/runtime/green-contract.ts +0 -55
  344. package/src/runtime/group-join.ts +0 -267
  345. package/src/runtime/handoff-manager.ts +0 -598
  346. package/src/runtime/heartbeat-gradient.ts +0 -36
  347. package/src/runtime/heartbeat-watcher.ts +0 -239
  348. package/src/runtime/hidden-handoff.ts +0 -407
  349. package/src/runtime/important-line-classifier.ts +0 -140
  350. package/src/runtime/intercom-bridge.ts +0 -187
  351. package/src/runtime/iteration-hooks.ts +0 -305
  352. package/src/runtime/live-agent-control.ts +0 -136
  353. package/src/runtime/live-agent-manager.ts +0 -704
  354. package/src/runtime/live-control-realtime.ts +0 -56
  355. package/src/runtime/live-extension-bridge.ts +0 -148
  356. package/src/runtime/live-irc.ts +0 -97
  357. package/src/runtime/live-session-health.ts +0 -108
  358. package/src/runtime/live-session-runtime.ts +0 -1139
  359. package/src/runtime/loop-gates.ts +0 -128
  360. package/src/runtime/manifest-cache.ts +0 -375
  361. package/src/runtime/mcp-proxy.ts +0 -105
  362. package/src/runtime/metric-parser.ts +0 -36
  363. package/src/runtime/model-fallback.ts +0 -409
  364. package/src/runtime/model-resolver.ts +0 -126
  365. package/src/runtime/model-scope.ts +0 -158
  366. package/src/runtime/orphan-worker-registry.ts +0 -465
  367. package/src/runtime/output-validator.ts +0 -202
  368. package/src/runtime/overflow-recovery.ts +0 -206
  369. package/src/runtime/parallel-research.ts +0 -68
  370. package/src/runtime/parallel-utils.ts +0 -160
  371. package/src/runtime/parent-guard.ts +0 -134
  372. package/src/runtime/path-overlap.ts +0 -150
  373. package/src/runtime/peer-dep.ts +0 -292
  374. package/src/runtime/per-write-validator.ts +0 -181
  375. package/src/runtime/phase-progress.ts +0 -217
  376. package/src/runtime/phase-tracker.ts +0 -385
  377. package/src/runtime/pi-args.ts +0 -655
  378. package/src/runtime/pi-json-output.ts +0 -170
  379. package/src/runtime/pi-spawn.ts +0 -273
  380. package/src/runtime/pipeline-runner.ts +0 -523
  381. package/src/runtime/plan-templates.ts +0 -201
  382. package/src/runtime/policy-engine.ts +0 -115
  383. package/src/runtime/post-checks.ts +0 -142
  384. package/src/runtime/post-exit-stdio-guard.ts +0 -104
  385. package/src/runtime/process-lifecycle.ts +0 -491
  386. package/src/runtime/process-status.ts +0 -154
  387. package/src/runtime/progress-event-coalescer.ts +0 -44
  388. package/src/runtime/progress-tracker.ts +0 -124
  389. package/src/runtime/prose-compressor.ts +0 -162
  390. package/src/runtime/recovery-recipes.ts +0 -203
  391. package/src/runtime/replace.ts +0 -570
  392. package/src/runtime/resilient-edit.ts +0 -153
  393. package/src/runtime/result-extractor.ts +0 -213
  394. package/src/runtime/retry-executor.ts +0 -100
  395. package/src/runtime/retry-runner.ts +0 -336
  396. package/src/runtime/role-permission.ts +0 -59
  397. package/src/runtime/run-coalesced-task-group.ts +0 -308
  398. package/src/runtime/run-drift.ts +0 -219
  399. package/src/runtime/run-tracker.ts +0 -116
  400. package/src/runtime/runtime-policy.ts +0 -29
  401. package/src/runtime/runtime-resolver.ts +0 -172
  402. package/src/runtime/runtime-warmup.ts +0 -160
  403. package/src/runtime/scheduler.ts +0 -353
  404. package/src/runtime/semaphore.ts +0 -141
  405. package/src/runtime/sensitive-paths.ts +0 -93
  406. package/src/runtime/session-resources.ts +0 -25
  407. package/src/runtime/session-snapshot.ts +0 -59
  408. package/src/runtime/session-usage.ts +0 -79
  409. package/src/runtime/settings-store.ts +0 -155
  410. package/src/runtime/sidechain-output.ts +0 -35
  411. package/src/runtime/single-agent-compose.ts +0 -84
  412. package/src/runtime/skill-effectiveness.ts +0 -524
  413. package/src/runtime/skill-instructions.ts +0 -391
  414. package/src/runtime/stale-reconciler.ts +0 -680
  415. package/src/runtime/stream-preview.ts +0 -184
  416. package/src/runtime/streaming-output.ts +0 -50
  417. package/src/runtime/subagent-manager.ts +0 -561
  418. package/src/runtime/subprocess-tool-registry.ts +0 -70
  419. package/src/runtime/supervisor-contact.ts +0 -64
  420. package/src/runtime/task-display.ts +0 -52
  421. package/src/runtime/task-graph-scheduler.ts +0 -227
  422. package/src/runtime/task-graph.ts +0 -290
  423. package/src/runtime/task-health.ts +0 -83
  424. package/src/runtime/task-id.ts +0 -161
  425. package/src/runtime/task-output-context.ts +0 -602
  426. package/src/runtime/task-packet.ts +0 -268
  427. package/src/runtime/task-quality.ts +0 -199
  428. package/src/runtime/task-runner/capabilities.ts +0 -78
  429. package/src/runtime/task-runner/context-retrieval.ts +0 -163
  430. package/src/runtime/task-runner/live-executor.ts +0 -227
  431. package/src/runtime/task-runner/output-splitter.ts +0 -152
  432. package/src/runtime/task-runner/progress.ts +0 -157
  433. package/src/runtime/task-runner/prompt-builder.ts +0 -278
  434. package/src/runtime/task-runner/prompt-pipeline.ts +0 -88
  435. package/src/runtime/task-runner/result-utils.ts +0 -16
  436. package/src/runtime/task-runner/retrieval-orchestrator.ts +0 -310
  437. package/src/runtime/task-runner/run-projection.ts +0 -125
  438. package/src/runtime/task-runner/state-helpers.ts +0 -176
  439. package/src/runtime/task-runner/tail-read.ts +0 -34
  440. package/src/runtime/task-runner.ts +0 -1420
  441. package/src/runtime/team-runner-artifacts.ts +0 -13
  442. package/src/runtime/team-runner.ts +0 -1993
  443. package/src/runtime/tool-output-pruner.ts +0 -333
  444. package/src/runtime/tool-progress.ts +0 -278
  445. package/src/runtime/usage-tracker.ts +0 -73
  446. package/src/runtime/verification-gates.ts +0 -571
  447. package/src/runtime/verification-integrity.ts +0 -105
  448. package/src/runtime/verification-worktree.ts +0 -186
  449. package/src/runtime/worker-heartbeat.ts +0 -25
  450. package/src/runtime/worker-startup.ts +0 -83
  451. package/src/runtime/workflow-state.ts +0 -195
  452. package/src/runtime/workspace-lock.ts +0 -443
  453. package/src/runtime/workspace-tree.ts +0 -312
  454. package/src/runtime/yield-handler.ts +0 -224
  455. package/src/runtime/zombie-scanner.ts +0 -298
  456. package/src/schema/config-schema.ts +0 -327
  457. package/src/schema/team-tool-schema.ts +0 -415
  458. package/src/schema/validation-types.ts +0 -159
  459. package/src/skills/discover-skills.ts +0 -197
  460. package/src/skills/skill-templates.ts +0 -456
  461. package/src/skills/validate.ts +0 -285
  462. package/src/state/active-run-registry.ts +0 -439
  463. package/src/state/artifact-store.ts +0 -176
  464. package/src/state/atomic-write.ts +0 -903
  465. package/src/state/blob-store.ts +0 -308
  466. package/src/state/contracts.ts +0 -158
  467. package/src/state/crew-init.ts +0 -269
  468. package/src/state/decision-ledger.ts +0 -345
  469. package/src/state/event-log-rotation.ts +0 -342
  470. package/src/state/event-log.ts +0 -1311
  471. package/src/state/event-reconstructor.ts +0 -229
  472. package/src/state/gitignore-manager.ts +0 -46
  473. package/src/state/health-store.ts +0 -79
  474. package/src/state/hook-instinct-bridge.ts +0 -94
  475. package/src/state/hook-integrations.ts +0 -51
  476. package/src/state/instinct-store.ts +0 -275
  477. package/src/state/jsonl-writer.ts +0 -107
  478. package/src/state/locks.ts +0 -562
  479. package/src/state/mailbox.ts +0 -916
  480. package/src/state/observation-store.ts +0 -176
  481. package/src/state/run-cache.ts +0 -193
  482. package/src/state/run-graph.ts +0 -183
  483. package/src/state/run-metrics.ts +0 -165
  484. package/src/state/schedule.ts +0 -166
  485. package/src/state/session-state-map.ts +0 -51
  486. package/src/state/state-store.ts +0 -958
  487. package/src/state/task-claims.ts +0 -61
  488. package/src/state/tiered-eval.ts +0 -480
  489. package/src/state/types-eval.ts +0 -58
  490. package/src/state/types.ts +0 -440
  491. package/src/state/usage.ts +0 -138
  492. package/src/state/worker-atomic-writer.ts +0 -194
  493. package/src/subagents/async-entry.ts +0 -1
  494. package/src/subagents/index.ts +0 -3
  495. package/src/subagents/live/control.ts +0 -1
  496. package/src/subagents/live/manager.ts +0 -1
  497. package/src/subagents/live/realtime.ts +0 -1
  498. package/src/subagents/live/session-runtime.ts +0 -1
  499. package/src/subagents/manager.ts +0 -1
  500. package/src/subagents/spawn.ts +0 -1
  501. package/src/teams/discover-teams.ts +0 -187
  502. package/src/teams/team-config.ts +0 -27
  503. package/src/teams/team-serializer.ts +0 -38
  504. package/src/tools/safe-bash-extension.ts +0 -54
  505. package/src/tools/safe-bash.ts +0 -505
  506. package/src/types/diff.d.ts +0 -18
  507. package/src/types/new-api-types.ts +0 -35
  508. package/src/ui/agent-management-overlay.ts +0 -160
  509. package/src/ui/card-colors.ts +0 -139
  510. package/src/ui/crew-footer.ts +0 -102
  511. package/src/ui/crew-select-list.ts +0 -111
  512. package/src/ui/dashboard-panes/agents-pane.ts +0 -164
  513. package/src/ui/dashboard-panes/cancellation-pane.ts +0 -66
  514. package/src/ui/dashboard-panes/capability-pane.ts +0 -77
  515. package/src/ui/dashboard-panes/health-pane.ts +0 -31
  516. package/src/ui/dashboard-panes/mailbox-pane.ts +0 -35
  517. package/src/ui/dashboard-panes/metrics-pane.ts +0 -37
  518. package/src/ui/dashboard-panes/progress-pane.ts +0 -38
  519. package/src/ui/dashboard-panes/transcript-pane.ts +0 -10
  520. package/src/ui/deploy-bundled-themes.ts +0 -71
  521. package/src/ui/dwf-phase-display.ts +0 -151
  522. package/src/ui/dynamic-border.ts +0 -35
  523. package/src/ui/heartbeat-aggregator.ts +0 -74
  524. package/src/ui/key-utils.ts +0 -42
  525. package/src/ui/keybinding-map.ts +0 -248
  526. package/src/ui/layout-primitives.ts +0 -106
  527. package/src/ui/live-conversation-overlay.ts +0 -183
  528. package/src/ui/live-duration.ts +0 -55
  529. package/src/ui/live-run-sidebar.ts +0 -301
  530. package/src/ui/loaders.ts +0 -176
  531. package/src/ui/mascot.ts +0 -436
  532. package/src/ui/overlays/agent-picker-overlay.ts +0 -65
  533. package/src/ui/overlays/confirm-overlay.ts +0 -60
  534. package/src/ui/overlays/help-overlay.ts +0 -177
  535. package/src/ui/overlays/mailbox-compose-overlay.ts +0 -181
  536. package/src/ui/overlays/mailbox-compose-preview.ts +0 -78
  537. package/src/ui/overlays/mailbox-detail-overlay.ts +0 -154
  538. package/src/ui/pi-ui-compat.ts +0 -68
  539. package/src/ui/powerbar-publisher.ts +0 -459
  540. package/src/ui/render-coalescer.ts +0 -101
  541. package/src/ui/render-diff.ts +0 -160
  542. package/src/ui/render-scheduler.ts +0 -224
  543. package/src/ui/run-action-dispatcher.ts +0 -182
  544. package/src/ui/run-dashboard.ts +0 -913
  545. package/src/ui/run-event-bus.ts +0 -381
  546. package/src/ui/run-snapshot-cache.ts +0 -1057
  547. package/src/ui/settings-overlay.ts +0 -1067
  548. package/src/ui/snapshot-types.ts +0 -90
  549. package/src/ui/spinner.ts +0 -17
  550. package/src/ui/status-colors.ts +0 -143
  551. package/src/ui/syntax-highlight.ts +0 -136
  552. package/src/ui/terminal-status.ts +0 -269
  553. package/src/ui/theme-adapter.ts +0 -271
  554. package/src/ui/theme-discovery.ts +0 -199
  555. package/src/ui/tool-progress-formatter.ts +0 -93
  556. package/src/ui/tool-render.ts +0 -453
  557. package/src/ui/tool-renderers/brief-mode.ts +0 -225
  558. package/src/ui/tool-renderers/index.ts +0 -726
  559. package/src/ui/transcript-cache.ts +0 -128
  560. package/src/ui/transcript-entries.ts +0 -256
  561. package/src/ui/transcript-viewer.ts +0 -424
  562. package/src/ui/widget/index.ts +0 -357
  563. package/src/ui/widget/widget-formatters.ts +0 -182
  564. package/src/ui/widget/widget-model.ts +0 -110
  565. package/src/ui/widget/widget-renderer.ts +0 -182
  566. package/src/ui/widget/widget-types.ts +0 -36
  567. package/src/utils/bm25-search.ts +0 -235
  568. package/src/utils/completion-dedupe.ts +0 -63
  569. package/src/utils/conflict-detect.ts +0 -668
  570. package/src/utils/env-allowlist.ts +0 -30
  571. package/src/utils/env-filter.ts +0 -155
  572. package/src/utils/file-coalescer.ts +0 -98
  573. package/src/utils/fingerprint.ts +0 -180
  574. package/src/utils/frontmatter.ts +0 -70
  575. package/src/utils/fs-watch.ts +0 -37
  576. package/src/utils/gh-protocol.ts +0 -556
  577. package/src/utils/git.ts +0 -260
  578. package/src/utils/guards.ts +0 -107
  579. package/src/utils/ids.ts +0 -24
  580. package/src/utils/incremental-reader.ts +0 -220
  581. package/src/utils/internal-error.ts +0 -10
  582. package/src/utils/names.ts +0 -36
  583. package/src/utils/ndjson.ts +0 -115
  584. package/src/utils/paths.ts +0 -227
  585. package/src/utils/project-detector.ts +0 -160
  586. package/src/utils/redaction.ts +0 -347
  587. package/src/utils/resolve-shell.ts +0 -36
  588. package/src/utils/run-watcher-registry.ts +0 -152
  589. package/src/utils/safe-paths.ts +0 -383
  590. package/src/utils/scan-cache.ts +0 -144
  591. package/src/utils/session-utils.ts +0 -110
  592. package/src/utils/sleep.ts +0 -54
  593. package/src/utils/socket-path.ts +0 -127
  594. package/src/utils/sse-parser.ts +0 -129
  595. package/src/utils/task-name-generator.ts +0 -337
  596. package/src/utils/timings.ts +0 -33
  597. package/src/utils/token-counter.ts +0 -200
  598. package/src/utils/visual.ts +0 -207
  599. package/src/workflows/cost-estimator.ts +0 -34
  600. package/src/workflows/discover-workflows.ts +0 -290
  601. package/src/workflows/intermediate-store.ts +0 -166
  602. package/src/workflows/preflight-validator.ts +0 -168
  603. package/src/workflows/topology-analyzer.ts +0 -203
  604. package/src/workflows/validate-workflow.ts +0 -50
  605. package/src/workflows/workflow-config.ts +0 -70
  606. package/src/workflows/workflow-serializer.ts +0 -32
  607. package/src/worktree/branch-freshness.ts +0 -112
  608. package/src/worktree/cleanup.ts +0 -341
  609. package/src/worktree/worktree-manager.ts +0 -1200
@@ -1,383 +0,0 @@
1
- import * as fs from "node:fs";
2
- import * as path from "node:path";
3
-
4
- export function isSafePathId(value: string): boolean {
5
- return /^[A-Za-z0-9_-]+$/.test(value);
6
- }
7
-
8
- export function assertSafePathId(kind: string, value: string): string {
9
- if (!isSafePathId(value)) throw new Error(`Invalid ${kind}: ${value}`);
10
- return value;
11
- }
12
-
13
- export function resolveContainedPath(baseDir: string, targetPath: string): string {
14
- if (targetPath.includes("\0")) {
15
- throw new Error(`Security: path contains null byte`);
16
- }
17
- const base = path.resolve(baseDir);
18
- const resolved = path.isAbsolute(targetPath) ? path.resolve(targetPath) : path.resolve(base, targetPath);
19
- // Normalize BOTH paths to canonical form on ALL platforms. This resolves
20
- // symlinks so that a base and target that refer to the same physical dir
21
- // via different paths (Windows 8.3 short-name; macOS /var → /private/var)
22
- // compare equal. Without this, a legitimately-contained target under an
23
- // OS-managed symlink is wrongly rejected as "outside" the base.
24
- const baseNorm = resolveCanonicalPath(base);
25
- const resolvedNorm = resolveCanonicalPath(resolved);
26
- const relative =
27
- process.platform === "win32"
28
- ? path.relative(baseNorm.toLowerCase(), resolvedNorm.toLowerCase())
29
- : path.relative(baseNorm, resolvedNorm);
30
- if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`Path is outside ${baseDir}: ${targetPath}`);
31
- return resolved;
32
- }
33
-
34
- /**
35
- * Platform-agnostic canonical path resolution. Resolves symlinks (via
36
- * realpathSync) to normalize paths so the same physical location always
37
- * yields the same string regardless of how it was referenced.
38
- *
39
- * - Windows: delegates to resolveWindowsCanonical (canonical LONG-NAME form,
40
- * resolving 8.3 short-name aliases like RUNNER~1 → runneradmin).
41
- * - POSIX: uses realpathSync, which resolves system symlinks such as the
42
- * macOS /var → /private/var mapping.
43
- *
44
- * For non-existent paths (write targets), walks up to the deepest existing
45
- * ancestor and joins the remaining components, so the canonical prefix is
46
- * still comparable.
47
- */
48
- function resolveCanonicalPath(p: string): string {
49
- if (process.platform === "win32") return resolveWindowsCanonical(p);
50
- try {
51
- return fs.realpathSync(p);
52
- } catch {
53
- const parts: string[] = [];
54
- let current = p;
55
- while (current !== path.dirname(current)) {
56
- try {
57
- const real = fs.realpathSync(current);
58
- let acc = real;
59
- for (let i = parts.length - 1; i >= 0; i--) acc = path.join(acc, parts[i]);
60
- return acc;
61
- } catch {
62
- /* keep walking up */
63
- }
64
- parts.push(path.basename(current));
65
- current = path.dirname(current);
66
- }
67
- return p;
68
- }
69
- }
70
-
71
- /**
72
- * On Windows, resolve a path to its canonical (long-name) form.
73
- * Walks up ancestors until finding one that exists, then joins back down.
74
- * This handles paths where intermediate directories don't exist yet but
75
- * their ancestors do (and may use short-name aliases).
76
- *
77
- * Uses fs.realpathSync.native (canonical long-name form) as the primary
78
- * resolver, falling back to non-native realpathSync if .native fails.
79
- */
80
- function resolveWindowsCanonical(p: string): string {
81
- try {
82
- // Use the NATIVE realpath to resolve to canonical LONG-NAME form.
83
- // On Windows, fs.realpathSync.native resolves 8.3 short-name aliases
84
- // (e.g. RUNNER~1) to long-name (runneradmin). This is essential for
85
- // containment checks: base (from cwd, often long-name) and target
86
- // (from os.tmpdir()/mkdtempSync, often short-name) must normalize to
87
- // the SAME form or a contained target is wrongly rejected as "outside".
88
- const real = fs.realpathSync.native(p);
89
- // Guard against NTFS internal paths (e.g. C:\$Extend\$Deleted)
90
- if (real.includes("$Extend") || real.includes("$Deleted")) throw new Error("NTFS internal path");
91
- return real;
92
- } catch {
93
- // Fallback: try realpathSync (non-native) which may succeed where .native fails
94
- try {
95
- const real = fs.realpathSync(p);
96
- return real;
97
- } catch {
98
- /* proceed to ancestor walk */
99
- }
100
- // Walk up to find the deepest existing ancestor
101
- const parts: string[] = [];
102
- let current = p;
103
- while (current !== path.dirname(current)) {
104
- try {
105
- let real: string;
106
- try {
107
- real = fs.realpathSync.native(current);
108
- } catch {
109
- real = fs.realpathSync(current);
110
- }
111
- // Guard against NTFS internal paths
112
- if (real.includes("$Extend") || real.includes("$Deleted")) throw new Error("NTFS internal path");
113
- // Found existing ancestor — join with remaining parts in reverse order
114
- // (parts were pushed bottom-up, so iterate from last to first)
115
- for (let i = parts.length - 1; i >= 0; i--) {
116
- real = path.join(real, parts[i]);
117
- }
118
- return real;
119
- } catch {
120
- /* keep walking */
121
- }
122
- parts.push(path.basename(current));
123
- current = path.dirname(current);
124
- }
125
- // Couldn't resolve any ancestor — return original
126
- return p;
127
- }
128
- }
129
-
130
- /**
131
- * Resolve a target path to its real (symlink-resolved) absolute path while
132
- * guaranteeing the result stays inside `baseDir`.
133
- *
134
- * ## Security model — asymmetric ancestor handling
135
- *
136
- * `baseDir` and `targetPath` are validated with different policies because
137
- * they play different roles:
138
- *
139
- * - **baseDir** (the container): all ancestors MUST exist and MUST NOT be
140
- * symlinks. We refuse to operate if any component is missing or symlinked,
141
- * because a symlinked container could point the caller outside the
142
- * intended trust boundary (e.g. `/var/run -> /run` resolving into an
143
- * attacker-controlled directory).
144
- *
145
- * - **targetPath** (the contained file): the FINAL component may be
146
- * non-existent (for write operations creating a new file) and EXISTING
147
- * ancestors of the target may also be missing. We DO require that any
148
- * ancestor that DOES exist must not be a symlink — an attacker who can
149
- * create a directory in the container must not be able to redirect the
150
- * file being created.
151
- *
152
- * This asymmetry is intentional: callers that need to create a new file
153
- * pass a non-existent targetPath. Callers that operate on an existing file
154
- * get full symlink protection. Callers MUST NOT pass a symlinked
155
- * intermediate component; if you need to, use `resolveContainedPath`
156
- * instead (which only checks the resolved path, not the chain).
157
- *
158
- * Throws on:
159
- * - null byte in targetPath
160
- * - targetPath resolves outside baseDir
161
- * - any existing ancestor (base or target) is a symlink
162
- * - baseDir itself does not exist
163
- *
164
- * Returns the resolved real path on success, or the resolved (but not
165
- * realpathed) path when the target does not exist yet.
166
- *
167
- * NOTE: There is a race condition window between validation and use where an
168
- * attacker could create a directory component after validation but before the
169
- * file is created. Callers MUST create parent directories atomically
170
- * (e.g., mkdirSync with { recursive: true }) and use O_CREAT | O_NOFOLLOW | O_EXCL
171
- * for atomic file creation, as atomicWriteFile does. This ensures the entire
172
- * operation is atomic and prevents TOCTOU attacks.
173
- */
174
- export function resolveRealContainedPath(baseDir: string, targetPath: string): string {
175
- if (targetPath.includes("\0")) {
176
- throw new Error(`Security: path contains null byte`);
177
- }
178
- const resolved = resolveContainedPath(baseDir, targetPath);
179
-
180
- // Open baseDir with O_NOFOLLOW to atomically validate no symlinks in the path.
181
- // O_NOFOLLOW makes the open fail with ELOOP if any path component is a symlink.
182
- let baseFd: number | undefined;
183
- try {
184
- baseFd = fs.openSync(baseDir, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
185
- } catch (error) {
186
- const errCode = (error as NodeJS.ErrnoException).code;
187
- if (errCode === "ENOENT") {
188
- // baseDir doesn't exist yet — create it and retry
189
- try {
190
- fs.mkdirSync(baseDir, { recursive: true });
191
- baseFd = fs.openSync(baseDir, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
192
- } catch (retryError) {
193
- throw new Error(
194
- `Cannot open base directory ${baseDir}: ${retryError instanceof Error ? retryError.message : String(retryError)}`,
195
- );
196
- }
197
- } else if (errCode === "ELOOP") {
198
- // On macOS, system directories like /var → /private/var contain symlinks.
199
- // If baseDir is under such a path, resolve through realpath and retry.
200
- if (process.platform === "darwin") {
201
- try {
202
- const realBaseDir = fs.realpathSync(baseDir);
203
- if (realBaseDir !== baseDir) {
204
- baseFd = fs.openSync(realBaseDir, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
205
- baseDir = realBaseDir; // update for later use
206
- // Fall through to fstatSync below
207
- }
208
- } catch {
209
- /* throw original */
210
- }
211
- }
212
- if (baseFd === undefined) throw new Error("Refusing to resolve: baseDir path contains a symlink: " + baseDir);
213
- } else {
214
- throw new Error(`Cannot open base directory ${baseDir}: ${error instanceof Error ? error.message : String(error)}`);
215
- }
216
- }
217
- let realBase: string;
218
- try {
219
- const stat = fs.fstatSync(baseFd);
220
- if (!stat.isDirectory()) throw new Error(`baseDir ${baseDir} is not a directory`);
221
- // Use regular realpathSync (not .native) to preserve input path form.
222
- // On Windows CI, .native always returns long-name form (runneradmin)
223
- // while non-native preserves short-name (RUNNER~1). Using non-native
224
- // ensures the result matches what the caller passed in.
225
- realBase = fs.realpathSync(baseDir);
226
- } catch (error) {
227
- // baseDir MUST exist and be resolvable for the containment guarantee to hold.
228
- // Callers creating new directories must create baseDir atomically (e.g.,
229
- // mkdirSync with { recursive: true }) BEFORE calling this function, and use
230
- // O_NOFOLLOW|O_CREAT|O_EXCL for the actual file creation to ensure atomicity.
231
- // The safe-paths validation and the file creation are two separate operations
232
- // with a gap between them — callers must close this gap with atomic primitives.
233
- throw new Error(`Cannot resolve real path of base directory ${baseDir}: ${error instanceof Error ? error.message : String(error)}`);
234
- } finally {
235
- fs.closeSync(baseFd);
236
- }
237
-
238
- // Walk the ancestor chain of the resolved target path, using O_NOFOLLOW
239
- // on each ancestor to atomically validate none are symlinks.
240
- const O_NOFOLLOW = fs.constants.O_NOFOLLOW;
241
- const O_RDONLY = fs.constants.O_RDONLY;
242
- const resolvedParts = resolved.split(path.sep);
243
- let resolvedAccumulated = "";
244
- if (resolvedParts[0] === "") resolvedAccumulated = "/"; // Unix root
245
- for (let i = 1; i < resolvedParts.length; i++) {
246
- if (resolvedParts[i] === "") continue;
247
- resolvedAccumulated = path.join(resolvedAccumulated, resolvedParts[i]);
248
- try {
249
- const fd = fs.openSync(resolvedAccumulated, O_RDONLY | O_NOFOLLOW);
250
- fs.closeSync(fd);
251
- } catch (error) {
252
- if ((error as NodeJS.ErrnoException).code === "ELOOP") {
253
- // On macOS, /var → /private/var, /tmp → /private/tmp, /etc → /private/etc
254
- // are system symlinks managed by the OS. Allow them.
255
- if (process.platform === "darwin") {
256
- const resolvedSymlink = resolvedAccumulated;
257
- const knownDarwinSymlinks = ["/var", "/tmp", "/etc", "/private/var", "/private/tmp", "/private/etc"];
258
- // Use prefix match to handle subdirectories like /var/folders/...
259
- if (knownDarwinSymlinks.some((s) => resolvedSymlink === s || resolvedSymlink.startsWith(s + "/"))) continue;
260
- }
261
- throw new Error("Refusing to resolve: target path ancestor is a symlink: " + resolvedAccumulated);
262
- }
263
- // EPERM on Windows when opening a directory — skip validation
264
- if ((error as NodeJS.ErrnoException).code === "EPERM" && process.platform === "win32") continue;
265
- // ENOENT means component doesn't exist — that's OK. Only existing symlinks
266
- // are a security risk (symlinks to attacker-controlled targets). Non-existent
267
- // paths can be created by the caller and don't pose a symlink risk.
268
- if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
269
- // For the final component (target itself), ENOENT is expected for non-existent targets.
270
- if (i === resolvedParts.length - 1) continue;
271
- }
272
- }
273
-
274
- // Open the target with O_NOFOLLOW to catch any symlinks.
275
- // ENOENT is acceptable for write operations — the file may not exist yet.
276
- let targetFd: number;
277
- try {
278
- targetFd = fs.openSync(resolved, O_RDONLY | O_NOFOLLOW);
279
- } catch (error) {
280
- if ((error as NodeJS.ErrnoException).code === "ELOOP")
281
- throw new Error("Refusing to resolve: target path is a symlink: " + resolved);
282
- // EPERM on Windows when opening a directory — treat as non-existent
283
- if ((error as NodeJS.ErrnoException).code === "EPERM" && process.platform === "win32") return resolved;
284
- if ((error as NodeJS.ErrnoException).code === "ENOENT") {
285
- // Target doesn't exist yet — that's OK for write operations.
286
- // All ancestors have been validated above (no symlinks).
287
- // The caller will create the file with atomic primitives.
288
- return resolved;
289
- }
290
- throw new Error(`Cannot open ${resolved}: ${error instanceof Error ? error.message : String(error)}`);
291
- }
292
-
293
- let realTarget: string;
294
- try {
295
- // Use regular realpathSync (not .native) to preserve input path form.
296
- realTarget = fs.realpathSync(resolved);
297
- } catch (targetError) {
298
- if ((targetError as NodeJS.ErrnoException).code === "ENOENT") {
299
- // Target doesn't exist yet — this is OK for write operations.
300
- // Return the resolved path so the caller can create the file.
301
- // We already validated all ancestors are not symlinks above.
302
- return resolved;
303
- }
304
- throw new Error(
305
- `Cannot resolve real path of ${resolved}: ${targetError instanceof Error ? targetError.message : String(targetError)}`,
306
- );
307
- } finally {
308
- fs.closeSync(targetFd);
309
- }
310
-
311
- // Re-validate the ancestor chain of the resolved path to catch any TOCTOU
312
- // races that occurred between the initial O_NOFOLLOW validation and the
313
- // realpathSync call. An attacker could have replaced a validated ancestor
314
- // with a symlink during this window.
315
- //
316
- // Skip the final path component (realTarget itself) — we just successfully
317
- // realpathSync'd it, so it exists. Re-validating it can spuriously fail on
318
- // Windows where the resolved path uses short-name (8.3) form that
319
- // openSync cannot reopen, or where the realpathSync result differs in
320
- // case/separator form from the original.
321
- //
322
- // Walk via path.dirname which is portable across all platforms and
323
- // correctly handles extended-length (\\?\), UNC (\\server\share), and
324
- // short-name paths on Windows without manual parsing.
325
- let ancestor = path.dirname(realTarget);
326
- while (ancestor && ancestor !== path.dirname(ancestor)) {
327
- try {
328
- const fd = fs.openSync(ancestor, O_RDONLY | O_NOFOLLOW);
329
- fs.closeSync(fd);
330
- } catch (error) {
331
- const errCode = (error as NodeJS.ErrnoException).code;
332
- if (errCode === "ELOOP") throw new Error("Refusing to resolve: TOCTOU race detected, path became a symlink: " + ancestor);
333
- // Windows: EPERM can occur when opening system directories (e.g. C:\)
334
- // or NTFS internal paths ($Extend/$Deleted). Skip and continue walking.
335
- if (process.platform === "win32" && errCode === "EPERM") {
336
- if (ancestor.includes("$Extend") || ancestor.includes("$Deleted")) {
337
- // NTFS internal path — stop walking, we've reached the filesystem root
338
- break;
339
- }
340
- // System directory — continue walking up
341
- ancestor = path.dirname(ancestor);
342
- continue;
343
- }
344
- if (errCode !== "ENOENT") throw error;
345
- // ENOENT on an ancestor of realTarget after realpathSync is concerning
346
- // — the path existed when we validated it but now doesn't. This could
347
- // indicate a race or attack. For safety, treat this as an error.
348
- throw new Error(
349
- `Cannot validate resolved path: ${ancestor} disappeared after realpathSync: ${error instanceof Error ? error.message : String(error)}`,
350
- );
351
- }
352
- ancestor = path.dirname(ancestor);
353
- }
354
-
355
- // Verify the resolved real path is still within baseDir.
356
- // On Windows, realpathSync.native may return different short/long-name forms
357
- // for the same physical directory depending on how the path was opened.
358
- // Use resolveWindowsCanonical (same as resolveContainedPath) to normalize
359
- // both paths consistently before comparison.
360
- if (process.platform === "win32") {
361
- const normBase = resolveWindowsCanonical(realBase).replace(/\\/g, "/").toLowerCase();
362
- const normTarget = resolveWindowsCanonical(realTarget).replace(/\\/g, "/").toLowerCase();
363
- if (!normTarget.startsWith(normBase + "/") && normBase !== normTarget) {
364
- throw new Error(`Path is outside ${baseDir}: ${targetPath}`);
365
- }
366
- } else {
367
- const relative = path.relative(realBase, realTarget);
368
- if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`Path is outside ${baseDir}: ${targetPath}`);
369
- }
370
- return realTarget;
371
- }
372
-
373
- export function resolveContainedRelativePath(baseDir: string, relativePath: string, kind = "path"): string {
374
- if (relativePath.includes("\0")) {
375
- throw new Error(`Security: path contains null byte: ${kind}`);
376
- }
377
- const normalized = relativePath.replace(/\\/g, "/").replace(/^\.\/+/, "");
378
- // Detect Windows absolute paths (C:\, \\server\share) that path.isAbsolute may miss after normalization
379
- if (/^[A-Za-z]:/.test(normalized)) throw new Error(`Invalid ${kind}: ${relativePath}`);
380
- if (!normalized || normalized.split("/").some((segment) => segment === "..") || path.isAbsolute(normalized))
381
- throw new Error(`Invalid ${kind}: ${relativePath}`);
382
- return resolveContainedPath(baseDir, path.resolve(baseDir, normalized));
383
- }
@@ -1,144 +0,0 @@
1
- import * as fs from "node:fs";
2
- import * as path from "node:path";
3
-
4
- export interface ScanEntry {
5
- /** Unique key for this entry (e.g., runId, artifactPath) */
6
- key: string;
7
- /** Filesystem path */
8
- path: string;
9
- /** Raw content (parsed JSON or text) */
10
- raw: unknown;
11
- /** File modification time */
12
- mtimeMs: number;
13
- /** File size in bytes */
14
- sizeBytes: number;
15
- /** When this entry was loaded */
16
- loadedAtMs: number;
17
- }
18
-
19
- export interface ScanCacheOptions {
20
- /** TTL in ms for cached entries. Default 1000. */
21
- ttlMs?: number;
22
- /** Maximum number of entries. Default 100. */
23
- maxEntries?: number;
24
- }
25
-
26
- interface CacheBucket {
27
- entries: Map<string, ScanEntry>;
28
- expireAtMs: number;
29
- }
30
-
31
- /**
32
- * Shared raw scan-entry cache for runs, artifacts, mailbox, transcripts.
33
- * Provides deterministic sort order and invalidation on mutation.
34
- */
35
- export class SharedScanCache {
36
- #buckets = new Map<string, CacheBucket>();
37
- #ttlMs: number;
38
- #maxEntries: number;
39
- #now: () => number;
40
-
41
- constructor(options: ScanCacheOptions = {}) {
42
- this.#ttlMs = options.ttlMs ?? 1000;
43
- this.#maxEntries = options.maxEntries ?? 100;
44
- this.#now = () => Date.now();
45
- }
46
-
47
- /** Get a cached entry by bucket and key. Returns undefined if not cached or expired. */
48
- get(bucket: string, key: string): ScanEntry | undefined {
49
- const b = this.#buckets.get(bucket);
50
- if (!b) return undefined;
51
- if (this.#now() > b.expireAtMs) {
52
- this.#buckets.delete(bucket);
53
- return undefined;
54
- }
55
- return b.entries.get(key);
56
- }
57
-
58
- /** Get all entries in a bucket. Returns empty array if expired or missing. */
59
- list(bucket: string): ScanEntry[] {
60
- const b = this.#buckets.get(bucket);
61
- if (!b) return [];
62
- if (this.#now() > b.expireAtMs) {
63
- this.#buckets.delete(bucket);
64
- return [];
65
- }
66
- return [...b.entries.values()].sort((a, b) => a.key.localeCompare(b.key));
67
- }
68
-
69
- /** Set an entry in a bucket. */
70
- set(bucket: string, entry: ScanEntry): void {
71
- let b = this.#buckets.get(bucket);
72
- if (!b || this.#now() > b.expireAtMs) {
73
- b = { entries: new Map(), expireAtMs: this.#now() + this.#ttlMs };
74
- this.#buckets.set(bucket, b);
75
- }
76
- if (b.entries.size >= this.#maxEntries) {
77
- // Evict oldest entry
78
- const firstKey = b.entries.keys().next().value;
79
- if (firstKey !== undefined) b.entries.delete(firstKey);
80
- }
81
- b.entries.set(entry.key, entry);
82
- }
83
-
84
- /** Invalidate a specific key in a bucket. */
85
- invalidate(bucket: string, key: string): void {
86
- const b = this.#buckets.get(bucket);
87
- if (b) b.entries.delete(key);
88
- }
89
-
90
- /** Invalidate an entire bucket. */
91
- invalidateBucket(bucket: string): void {
92
- this.#buckets.delete(bucket);
93
- }
94
-
95
- /** Invalidate all buckets. */
96
- clear(): void {
97
- this.#buckets.clear();
98
- }
99
-
100
- /** Read a file, parse if JSON, and cache the result. */
101
- readAndCache(bucket: string, key: string, filePath: string, parseJson = true): ScanEntry | undefined {
102
- try {
103
- if (!fs.existsSync(filePath)) return undefined;
104
- const stat = fs.statSync(filePath);
105
- const cached = this.get(bucket, key);
106
- if (cached && cached.mtimeMs >= stat.mtimeMs && cached.sizeBytes === stat.size) return cached;
107
- const content = fs.readFileSync(filePath, "utf-8");
108
- const raw = parseJson ? JSON.parse(content) : content;
109
- const entry: ScanEntry = {
110
- key,
111
- path: filePath,
112
- raw,
113
- mtimeMs: stat.mtimeMs,
114
- sizeBytes: stat.size,
115
- loadedAtMs: this.#now(),
116
- };
117
- this.set(bucket, entry);
118
- return entry;
119
- } catch {
120
- return undefined;
121
- }
122
- }
123
-
124
- /** Read a directory and cache entries for each file. */
125
- scanAndCache(bucket: string, dirPath: string, parseJson = true): ScanEntry[] {
126
- try {
127
- if (!fs.existsSync(dirPath)) return [];
128
- const entries = fs.readdirSync(dirPath, { withFileTypes: true });
129
- const results: ScanEntry[] = [];
130
- for (const entry of entries) {
131
- if (!entry.isFile()) continue;
132
- const filePath = path.join(dirPath, entry.name);
133
- const cached = this.readAndCache(bucket, entry.name, filePath, parseJson);
134
- if (cached) results.push(cached);
135
- }
136
- return results.sort((a, b) => a.key.localeCompare(b.key));
137
- } catch {
138
- return [];
139
- }
140
- }
141
- }
142
-
143
- /** Global shared scan cache instance. */
144
- export const sharedScanCache = new SharedScanCache();
@@ -1,110 +0,0 @@
1
- /**
2
- * Session ID utilities for pi-crew / pi session alignment.
3
- *
4
- * pi's session IDs use the format:
5
- * ^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$
6
- *
7
- * This module provides utilities to generate valid pi session IDs
8
- * that align with pi-crew run IDs for easy cross-referencing.
9
- */
10
-
11
- /**
12
- * Validate session ID format per pi's requirements.
13
- * Format: ^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$
14
- */
15
- export function assertValidSessionId(id: string): void {
16
- if (!id || !/^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/.test(id)) {
17
- throw new Error(`Invalid session id: must be non-empty, alphanumeric with '-', '_', '.' and start/end with alphanumeric`);
18
- }
19
- }
20
-
21
- /**
22
- * Convert a pi-crew run ID to a valid pi session ID.
23
- *
24
- * - Strips non-alphanumeric characters
25
- * - Lowercases
26
- * - Prefixes with "crew-"
27
- * - Truncates to 16 chars for safety
28
- *
29
- * @param runId - The pi-crew run ID (e.g., "team_20260528133725_02e05cc5480d0175")
30
- * @returns Valid pi session ID (e.g., "crew-team20260528133")
31
- */
32
- export function toPiSessionId(runId: string): string {
33
- // Strip non-alphanumeric, lowercase, prefix with "crew-"
34
- const sanitized = runId.replace(/[^A-Za-z0-9]/g, "").toLowerCase();
35
- return `crew-${sanitized.slice(0, 16)}`;
36
- }
37
-
38
- /**
39
- * Validate and convert a run ID to a pi session ID.
40
- * Returns the session ID if valid, or undefined if conversion would produce invalid ID.
41
- */
42
- export function safeToPiSessionId(runId: string): string | undefined {
43
- try {
44
- const sessionId = toPiSessionId(runId);
45
- assertValidSessionId(sessionId);
46
- return sessionId;
47
- } catch {
48
- return undefined;
49
- }
50
- }
51
-
52
- /**
53
- * Extract the current Pi session id from an ExtensionContext.
54
- *
55
- * `ExtensionContext` does not declare `sessionId` in its type, but the runtime
56
- * attaches it as an own property. We read it via `getOwnPropertyDescriptor`
57
- * to safely bypass any Proxy traps, then validate it as a non-empty string.
58
- *
59
- * This is the canonical accessor — every site that filters the SHARED
60
- * per-project `.crew/state/` tree down to the current session MUST use this,
61
- * otherwise cross-session state leaks (e.g. compaction-guard resuming another
62
- * session's runs, ambient-status injecting another session's runs).
63
- *
64
- * Returns undefined when the session id is absent or unparseable — callers
65
- * must decide whether to treat that as "no filter" (back-compat) or "no runs".
66
- */
67
- export function extractSessionId(ctx: unknown): string | undefined {
68
- if (typeof ctx !== "object" || ctx === null) return undefined;
69
- let raw: unknown;
70
- try {
71
- raw = Object.getOwnPropertyDescriptor(ctx, "sessionId")?.value;
72
- } catch {
73
- // Defensive: a hostile Proxy or exotic object may trap descriptor
74
- // access. Real Pi ExtensionContext objects are plain, so this is
75
- // only hit by adversarial/degenerate inputs — treat as no session id.
76
- return undefined;
77
- }
78
- if (typeof raw !== "string" || raw.length === 0) return undefined;
79
- return raw;
80
- }
81
-
82
- /**
83
- * Broker-only session id extractor.
84
- *
85
- * Pi's `ExtensionContext` does NOT expose a top-level `sessionId` property on
86
- * its public surface — the id is reachable via `ctx.sessionManager.getSessionId()`.
87
- * This helper is only called from `installCrewBrokerLifecycleController.setSessionId`
88
- * (once per session_start), so the extra method invocation is safe here. It is
89
- * INTENTIONALLY a separate function from `extractSessionId`, which is called on
90
- * every `context` event (before every LLM call) from `context-status-injection.ts`
91
- * — extending that hot path with method calls was observed to freeze the TUI
92
- * (dashboard opens but is unresponsive, footer does not render) during smoke
93
- * testing, so it stays on the trivial property lookup.
94
- *
95
- * Tries the sessionManager path first, then falls back to a direct
96
- * `ctx.sessionId` for test mock compatibility.
97
- */
98
- export function extractBrokerSessionId(ctx: unknown): string | undefined {
99
- if (typeof ctx !== "object" || ctx === null) return undefined;
100
- try {
101
- const sm = (ctx as { sessionManager?: { getSessionId?: () => unknown } }).sessionManager;
102
- const viaManager = sm?.getSessionId?.();
103
- if (typeof viaManager === "string" && viaManager.length > 0) return viaManager;
104
- const direct = Object.getOwnPropertyDescriptor(ctx, "sessionId")?.value;
105
- if (typeof direct === "string" && direct.length > 0) return direct;
106
- return undefined;
107
- } catch {
108
- return undefined;
109
- }
110
- }
@@ -1,54 +0,0 @@
1
- import { execFileSync } from "node:child_process";
2
-
3
- /**
4
- * Synchronous sleep using Atomics.wait (non-busy) with low-CPU fallback.
5
- *
6
- * WARNING: This blocks the Node.js main thread. Only use in sync I/O paths
7
- * where blocking is acceptable (lock acquisition, rename retry).
8
- * NOT safe to call from Pi extension async code paths.
9
- */
10
- export function sleepSync(ms: number): void {
11
- try {
12
- const buffer = new SharedArrayBuffer(4);
13
- Atomics.wait(new Int32Array(buffer), 0, 0, ms);
14
- } catch {
15
- // Fallback for environments without Atomics.wait (e.g. Windows).
16
- // On Unix, try spawning the `sleep` command to avoid CPU busy-wait.
17
- if (process.platform !== "win32" && ms >= 10) {
18
- try {
19
- execFileSync("sleep", [(ms / 1000).toFixed(3)], {
20
- timeout: ms + 1000,
21
- stdio: "pipe",
22
- });
23
- return;
24
- } catch {
25
- // sleep command unavailable — fall through to busy-wait
26
- }
27
- }
28
- // Last resort: busy-wait. This burns CPU but is the only guaranteed
29
- // synchronous delay on Windows without SharedArrayBuffer.
30
- const deadline = Date.now() + ms;
31
- while (Date.now() < deadline) {
32
- // Busy-wait fallback for environments without Atomics.wait.
33
- }
34
- }
35
- }
36
-
37
- /**
38
- * Async sleep with optional AbortSignal support.
39
- * Rejects immediately if the signal is already aborted, or when aborted during wait.
40
- */
41
- export function sleep(ms: number, signal?: AbortSignal): Promise<void> {
42
- if (signal?.aborted) return Promise.reject(new Error("aborted"));
43
- return new Promise<void>((resolve, reject) => {
44
- const timer = setTimeout(resolve, ms);
45
- signal?.addEventListener(
46
- "abort",
47
- () => {
48
- clearTimeout(timer);
49
- reject(new Error("aborted"));
50
- },
51
- { once: true },
52
- );
53
- });
54
- }