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.
- package/CHANGELOG.md +150 -0
- package/README.md +216 -20
- package/dist/build-meta.json +2222 -1761
- package/dist/index.mjs +18636 -17603
- package/docs/actions-reference.md +431 -1
- package/package.json +19 -9
- package/schema.json +41 -0
- package/scripts/check-bundle-size.mjs +38 -0
- package/scripts/test-runner.mjs +11 -1
- package/skills/distill-software/SKILL.md +24 -1
- package/dist/index.mjs.map +0 -7
- package/docs/FEATURE_INTAKE.md +0 -126
- package/docs/HARNESS.md +0 -87
- package/docs/HARNESS_BACKLOG.md +0 -89
- package/docs/PROJECT_REVIEW.md +0 -270
- package/docs/PROJECT_REVIEW_FIXES.md +0 -342
- package/docs/PROJECT_REVIEW_ROUND4.md +0 -156
- package/docs/PROJECT_REVIEW_ROUND5.md +0 -86
- package/docs/REVIEW-FINDINGS-2026-06 +0 -357
- package/docs/REVIEW-FINDINGS-2026-07-CORE.md +0 -139
- package/docs/REVIEW-FINDINGS-2026-07.md +0 -125
- package/docs/TEST_MATRIX.md +0 -51
- package/docs/archive/README.md +0 -91
- package/docs/archive/followup-review-round3-2026-05-12.md +0 -342
- package/docs/archive/followup-review-round4-2026-05-13.md +0 -107
- package/docs/archive/pi-crew-bugs.md +0 -961
- package/docs/archive/pi-crew-test-final.md +0 -120
- package/docs/archive/pi-crew-test-results.md +0 -260
- package/docs/archive/pi-crew-test-round2.md +0 -136
- package/docs/archive/pi-crew-test-round4.md +0 -100
- package/docs/archive/pi-crew-test-round5.md +0 -70
- package/docs/archive/pi-crew-test-round6.md +0 -110
- package/docs/archive/pi-crew-v0.5.10-audit-fix-plan.md +0 -60
- package/docs/archive/pi-crew-v0.5.11-audit-fix-plan.md +0 -92
- package/docs/archive/pi-crew-v0.5.12-audit-fix-plan.md +0 -76
- package/docs/archive/pi-crew-v0.5.13-audit-fix-plan.md +0 -75
- package/docs/archive/pi-crew-v0.5.14-audit-fix-plan.md +0 -75
- package/docs/archive/pi-crew-v0.5.16-audit-fix-plan.md +0 -35
- package/docs/archive/pi-crew-v0.5.17-audit-fix-plan.md +0 -80
- package/docs/archive/pi-crew-v0.5.5-audit-fix-plan.md +0 -133
- package/docs/archive/pi-crew-v0.5.9-audit-fix-plan.md +0 -88
- package/docs/archive/pi-mono-opportunities.md +0 -969
- package/docs/archive/pi-mono-review.md +0 -291
- package/docs/archive/pi-subagent4-comparison.md +0 -261
- package/docs/archive/pi-subagents3-deep-analysis.md +0 -508
- package/docs/bugs/bug-021-notification-badge-counter-misleading.md +0 -293
- package/docs/bugs/bug-023-chain-windows-path-resolution.md +0 -106
- package/docs/bugs/bug-quota-display-truncation.md +0 -223
- package/docs/bugs/cross-session-notification-leakage.md +0 -82
- package/docs/code-review-2026-05-11.md +0 -592
- package/docs/coding-agent-optimization.md +0 -268
- package/docs/comparison-pi-subagents-vs-pi-crew.md +0 -303
- package/docs/decisions/0001-durable-state.md +0 -41
- package/docs/decisions/0002-child-process-for-async.md +0 -42
- package/docs/decisions/0003-depth-guard.md +0 -36
- package/docs/decisions/0004-execfile-over-exec.md +0 -34
- package/docs/decisions/0005-no-parameter-properties.md +0 -49
- package/docs/decisions/0006-publish-bundled-esm.md +0 -63
- package/docs/decisions/0007-active-run-binary-index.md +0 -54
- package/docs/decisions/0008-child-pi-warm-pool.md +0 -61
- package/docs/decisions/2026-07-21-broker-phase4-default-on.md +0 -77
- package/docs/decisions/2026-07-21-broker-windows-perms.md +0 -91
- package/docs/decisions/2026-07-22-broker-phase4-gated-on.md +0 -99
- package/docs/decisions/2026-07-24-oidc-trusted-publishing.md +0 -112
- package/docs/decisions/README.md +0 -26
- package/docs/deep-review-report.md +0 -384
- package/docs/distillation/cybersecurity-patterns.md +0 -294
- package/docs/feature-analysis-subagent4.md +0 -305
- package/docs/fix-plan-disabletools-exit-null.md +0 -219
- package/docs/fixes/BATCH_A_H1_H2.md +0 -86
- package/docs/fixes/bug-006-foreground-cancel-concurrent.md +0 -78
- package/docs/fixes/bug-007-async-notifier-stale-ctx.md +0 -112
- package/docs/fixes/bug-008-child-process-silent-timeout.md +0 -100
- package/docs/fixes/bug-009-executor-yield-limit-needs-attention.md +0 -75
- package/docs/fixes/bug-010-child-process-api-key-filtered.md +0 -109
- package/docs/fixes/bug-011-spawn-pi-enoent.md +0 -92
- package/docs/fixes/bug-012-essential-env-stripped.md +0 -89
- package/docs/fixes/bug-013-background-runner-death.md +0 -84
- package/docs/fixes/bug-014-infinite-retry-loop-needs-attention.md +0 -82
- package/docs/fixes/bug-015-background-runner-sigterm.md +0 -65
- package/docs/fixes/bug-017-background-runner-session-shutdown.md +0 -66
- package/docs/fixes/bug-017-background-runner-sigkill-double-fork.md +0 -28
- package/docs/fixes/bug-018-child-pi-worker-stdin-hang.md +0 -61
- package/docs/fixes/bug-019-phantom-runs-temp-workspace.md +0 -52
- package/docs/fixes/bug-020-infinite-retry-loop-needs-attention.md +0 -47
- package/docs/fixes/v0.9.10/locks-fix-verify.md +0 -3
- package/docs/fixes/v0.9.10/smoke-test.md +0 -12
- package/docs/followup-plan-2026-05-12.md +0 -463
- package/docs/followup-review-2026-05-12.md +0 -297
- package/docs/goals.md +0 -59
- package/docs/implementation-plan-top3.md +0 -333
- package/docs/issue-29-analysis.md +0 -189
- package/docs/live-mailbox-runtime.md +0 -36
- package/docs/migration/atomic-write-v2-migration.md +0 -299
- package/docs/next-upgrade-roadmap.md +0 -808
- package/docs/oh-my-pi-research.md +0 -509
- package/docs/optimization-plan-2026-07.md +0 -366
- package/docs/optimization-plan.md +0 -644
- package/docs/patterns/command-agent-skill.md +0 -71
- package/docs/perf/baseline-2026-05.md +0 -113
- package/docs/perf/final-report-2026-05.md +0 -206
- package/docs/perf/optimization-plan-2026-07-verified.md +0 -396
- package/docs/perf/performance-audit-report-2026-07.md +0 -948
- package/docs/perf/performance-review-2026-07.md +0 -287
- package/docs/perf/sprint-1-report.md +0 -71
- package/docs/perf/sprint-2-report.md +0 -81
- package/docs/perf/sprint-2.5-report.md +0 -53
- package/docs/perf/sprint-3-report.md +0 -36
- package/docs/perf/sprint-4-report.md +0 -47
- package/docs/perf/sprint-5-report.md +0 -51
- package/docs/perf/sprint-6-report.md +0 -94
- package/docs/perf/sprint-7-report.md +0 -74
- package/docs/perf/upgrade-plan-2026-05.md +0 -147
- package/docs/performance-optimization-execution-plan.md +0 -520
- package/docs/phase4-triage.md +0 -58
- package/docs/pi-crew-investigation-report.md +0 -411
- package/docs/product/README.md +0 -31
- package/docs/product/platform.md +0 -27
- package/docs/product/runtime-safety.md +0 -37
- package/docs/product/team-run.md +0 -39
- package/docs/product/team-tool.md +0 -37
- package/docs/runtime-analysis-child-vs-live.md +0 -171
- package/docs/runtime-migration-in-process-analysis.md +0 -250
- package/docs/skills/REFERENCE.md +0 -138
- package/docs/stories/README.md +0 -32
- package/docs/stories/US-DEPS-major-upgrade.md +0 -62
- package/docs/stories/backlog.md +0 -36
- package/docs/superpowers/plans/2026-06-09-fallow-patterns-adoption.md +0 -1270
- package/docs/templates/decision.md +0 -27
- package/docs/templates/story.md +0 -44
- package/docs/templates/validation-report.md +0 -32
- package/docs/ui-optimization-plan.md +0 -447
- package/src/adapters/claude-adapter.ts +0 -23
- package/src/adapters/codex-adapter.ts +0 -21
- package/src/adapters/cursor-adapter.ts +0 -17
- package/src/adapters/export-util.ts +0 -143
- package/src/adapters/index.ts +0 -15
- package/src/adapters/registry.ts +0 -18
- package/src/adapters/types.ts +0 -23
- package/src/agents/agent-config.ts +0 -194
- package/src/agents/agent-search.ts +0 -98
- package/src/agents/agent-serializer.ts +0 -38
- package/src/agents/discover-agents.ts +0 -623
- package/src/benchmark/benchmark-runner.ts +0 -313
- package/src/benchmark/feedback-loop.ts +0 -73
- package/src/config/config.ts +0 -1269
- package/src/config/defaults.ts +0 -193
- package/src/config/drift-detector.ts +0 -290
- package/src/config/markers.ts +0 -330
- package/src/config/resilient-parser.ts +0 -117
- package/src/config/role-tools.ts +0 -118
- package/src/config/suggestions.ts +0 -75
- package/src/config/types.ts +0 -278
- package/src/errors.ts +0 -194
- package/src/extension/action-suggestions.ts +0 -117
- package/src/extension/async-notifier.ts +0 -179
- package/src/extension/autonomous-policy.ts +0 -209
- package/src/extension/command-completions.ts +0 -120
- package/src/extension/context-status-injection.ts +0 -185
- package/src/extension/crew-autocomplete.ts +0 -131
- package/src/extension/crew-cleanup.ts +0 -168
- package/src/extension/crew-input-router.ts +0 -93
- package/src/extension/crew-shortcuts.ts +0 -87
- package/src/extension/crew-vibes/cat-frames.ts +0 -18
- package/src/extension/crew-vibes/config.ts +0 -195
- package/src/extension/crew-vibes/figures.ts +0 -101
- package/src/extension/crew-vibes/font-detect.ts +0 -71
- package/src/extension/crew-vibes/footer.ts +0 -292
- package/src/extension/crew-vibes/index.ts +0 -432
- package/src/extension/crew-vibes/provider-usage.ts +0 -396
- package/src/extension/crew-vibes/render.ts +0 -206
- package/src/extension/crew-vibes/speed.ts +0 -286
- package/src/extension/cross-extension-rpc.ts +0 -350
- package/src/extension/help.ts +0 -62
- package/src/extension/import-index.ts +0 -74
- package/src/extension/knowledge-injection.ts +0 -402
- package/src/extension/management.ts +0 -571
- package/src/extension/message-renderers.ts +0 -108
- package/src/extension/notification-router.ts +0 -152
- package/src/extension/notification-sink.ts +0 -54
- package/src/extension/pi-api.ts +0 -56
- package/src/extension/plan-orchestrate.ts +0 -302
- package/src/extension/project-init.ts +0 -170
- package/src/extension/register.ts +0 -113
- package/src/extension/registration/artifact-cleanup.ts +0 -20
- package/src/extension/registration/command-registration.ts +0 -58
- package/src/extension/registration/command-utils.ts +0 -58
- package/src/extension/registration/commands.ts +0 -1228
- package/src/extension/registration/compaction-guard.ts +0 -333
- package/src/extension/registration/context-builder.ts +0 -135
- package/src/extension/registration/crash-recovery-cache.ts +0 -54
- package/src/extension/registration/foreground-run-controller.ts +0 -238
- package/src/extension/registration/hook-registration.ts +0 -119
- package/src/extension/registration/lazy-configurers.ts +0 -124
- package/src/extension/registration/lifecycle-handlers.ts +0 -923
- package/src/extension/registration/lifecycle.ts +0 -259
- package/src/extension/registration/observability.ts +0 -322
- package/src/extension/registration/registration-types.ts +0 -158
- package/src/extension/registration/runtime-cleanup.ts +0 -230
- package/src/extension/registration/subagent-helpers.ts +0 -125
- package/src/extension/registration/subagent-manager-setup.ts +0 -330
- package/src/extension/registration/subagent-tools.ts +0 -456
- package/src/extension/registration/team-tool.ts +0 -220
- package/src/extension/registration/tool-registration.ts +0 -50
- package/src/extension/registration/ui.ts +0 -172
- package/src/extension/registration/viewers.ts +0 -121
- package/src/extension/registration/wire-cross-extension.ts +0 -37
- package/src/extension/result-watcher.ts +0 -139
- package/src/extension/rpc-hmac.ts +0 -256
- package/src/extension/run-bundle-schema.ts +0 -104
- package/src/extension/run-export.ts +0 -97
- package/src/extension/run-import.ts +0 -168
- package/src/extension/run-index.ts +0 -131
- package/src/extension/run-maintenance.ts +0 -190
- package/src/extension/session-summary.ts +0 -18
- package/src/extension/team-manager-command.ts +0 -153
- package/src/extension/team-onboard.ts +0 -177
- package/src/extension/team-recommendation.ts +0 -288
- package/src/extension/team-tool/anchor.ts +0 -172
- package/src/extension/team-tool/api.ts +0 -1244
- package/src/extension/team-tool/auto-summarize.ts +0 -142
- package/src/extension/team-tool/cache-control.ts +0 -19
- package/src/extension/team-tool/cancel.ts +0 -337
- package/src/extension/team-tool/chain-dispatch.ts +0 -95
- package/src/extension/team-tool/chain-executor.ts +0 -379
- package/src/extension/team-tool/config-patch.ts +0 -50
- package/src/extension/team-tool/context.ts +0 -149
- package/src/extension/team-tool/destructive-gate.ts +0 -52
- package/src/extension/team-tool/doctor.ts +0 -431
- package/src/extension/team-tool/explain.ts +0 -282
- package/src/extension/team-tool/failure-patterns.ts +0 -118
- package/src/extension/team-tool/goal-wrap.ts +0 -330
- package/src/extension/team-tool/goal.ts +0 -556
- package/src/extension/team-tool/handle-schedule.ts +0 -332
- package/src/extension/team-tool/handle-settings.ts +0 -520
- package/src/extension/team-tool/health-monitor.ts +0 -481
- package/src/extension/team-tool/inspect.ts +0 -88
- package/src/extension/team-tool/intent-policy.ts +0 -45
- package/src/extension/team-tool/lifecycle-actions.ts +0 -615
- package/src/extension/team-tool/orchestrate.ts +0 -98
- package/src/extension/team-tool/parallel-dispatch.ts +0 -183
- package/src/extension/team-tool/plan.ts +0 -50
- package/src/extension/team-tool/respond.ts +0 -150
- package/src/extension/team-tool/run-not-found.ts +0 -49
- package/src/extension/team-tool/run.ts +0 -1035
- package/src/extension/team-tool/status.ts +0 -260
- package/src/extension/team-tool/workflow-manage.ts +0 -261
- package/src/extension/team-tool-types.ts +0 -26
- package/src/extension/team-tool.ts +0 -1116
- package/src/extension/tool-result.ts +0 -16
- package/src/extension/validate-resources.ts +0 -108
- package/src/hooks/registry.ts +0 -200
- package/src/hooks/types.ts +0 -69
- package/src/i18n.ts +0 -212
- package/src/observability/correlation.ts +0 -50
- package/src/observability/event-bus.ts +0 -86
- package/src/observability/event-to-metric.ts +0 -170
- package/src/observability/exporters/adapter.ts +0 -27
- package/src/observability/exporters/otlp-exporter.ts +0 -356
- package/src/observability/exporters/prometheus-exporter.ts +0 -54
- package/src/observability/metric-registry.ts +0 -100
- package/src/observability/metric-retention.ts +0 -64
- package/src/observability/metric-sink.ts +0 -99
- package/src/observability/metrics-primitives.ts +0 -219
- package/src/plugins/plugin-define.ts +0 -6
- package/src/plugins/plugin-registry.ts +0 -32
- package/src/plugins/plugins/index.ts +0 -3
- package/src/plugins/plugins/nextjs.ts +0 -19
- package/src/plugins/plugins/vite.ts +0 -10
- package/src/plugins/plugins/vitest.ts +0 -9
- package/src/prompt/prompt-runtime.ts +0 -380
- package/src/runtime/adaptive-plan.ts +0 -563
- package/src/runtime/agent-control.ts +0 -215
- package/src/runtime/agent-memory.ts +0 -81
- package/src/runtime/agent-observability.ts +0 -122
- package/src/runtime/anchor-manager.ts +0 -475
- package/src/runtime/async-marker.ts +0 -32
- package/src/runtime/async-runner.ts +0 -381
- package/src/runtime/attention-events.ts +0 -28
- package/src/runtime/auto-summarize.ts +0 -344
- package/src/runtime/background-runner.ts +0 -837
- package/src/runtime/batch-barrier.ts +0 -147
- package/src/runtime/broker-issuer.ts +0 -37
- package/src/runtime/cancellation-token.ts +0 -99
- package/src/runtime/cancellation.ts +0 -99
- package/src/runtime/capability-inventory.ts +0 -137
- package/src/runtime/chain-parser.ts +0 -237
- package/src/runtime/chain-runner.ts +0 -606
- package/src/runtime/checkpoint.ts +0 -291
- package/src/runtime/child-pi-constants.ts +0 -42
- package/src/runtime/child-pi-kill.ts +0 -180
- package/src/runtime/child-pi-pool.ts +0 -68
- package/src/runtime/child-pi-spawn.ts +0 -287
- package/src/runtime/child-pi-steering.ts +0 -128
- package/src/runtime/child-pi-streams.ts +0 -296
- package/src/runtime/child-pi-transcript.ts +0 -169
- package/src/runtime/child-pi.ts +0 -1105
- package/src/runtime/coalesce-tasks.ts +0 -268
- package/src/runtime/code-summary.ts +0 -292
- package/src/runtime/command-trace.ts +0 -105
- package/src/runtime/compact-pipeline.ts +0 -56
- package/src/runtime/compact-stages/ansi-strip-stage.ts +0 -25
- package/src/runtime/compact-stages/blank-collapse-stage.ts +0 -31
- package/src/runtime/compact-stages/deduplicate-stage.ts +0 -34
- package/src/runtime/compact-stages/head-snap-stage.ts +0 -57
- package/src/runtime/compact-stages/index.ts +0 -23
- package/src/runtime/compact-stages/tail-capture-stage.ts +0 -77
- package/src/runtime/compact-stages/truncation-stage.ts +0 -74
- package/src/runtime/compaction-summary.ts +0 -278
- package/src/runtime/completion-guard.ts +0 -207
- package/src/runtime/concurrency.ts +0 -58
- package/src/runtime/crash-classification.ts +0 -229
- package/src/runtime/crash-recovery.ts +0 -577
- package/src/runtime/crew-agent-records.ts +0 -593
- package/src/runtime/crew-agent-runtime.ts +0 -62
- package/src/runtime/crew-broker-child.ts +0 -88
- package/src/runtime/crew-broker-client.ts +0 -673
- package/src/runtime/crew-broker-tokens.ts +0 -84
- package/src/runtime/crew-broker.ts +0 -1276
- package/src/runtime/crew-hooks.ts +0 -227
- package/src/runtime/cross-extension-rpc.ts +0 -143
- package/src/runtime/custom-tools/irc-tool.ts +0 -282
- package/src/runtime/custom-tools/submit-result-tool.ts +0 -102
- package/src/runtime/deadletter.ts +0 -47
- package/src/runtime/delivery-coordinator.ts +0 -211
- package/src/runtime/delta-conflict.ts +0 -348
- package/src/runtime/deterministic-ast.ts +0 -161
- package/src/runtime/diagnostic-export.ts +0 -171
- package/src/runtime/direct-run.ts +0 -45
- package/src/runtime/dwf-state-store.ts +0 -102
- package/src/runtime/dynamic-workflow-context.ts +0 -1016
- package/src/runtime/dynamic-workflow-runner.ts +0 -310
- package/src/runtime/effectiveness.ts +0 -90
- package/src/runtime/errors/crew-errors.ts +0 -162
- package/src/runtime/event-stream-bridge.ts +0 -98
- package/src/runtime/foreground-control.ts +0 -193
- package/src/runtime/foreground-watchdog.ts +0 -132
- package/src/runtime/global-worker-cap.ts +0 -96
- package/src/runtime/goal-achievement.ts +0 -148
- package/src/runtime/goal-evaluator.ts +0 -361
- package/src/runtime/goal-loop-runner.ts +0 -828
- package/src/runtime/goal-state-store.ts +0 -219
- package/src/runtime/green-contract.ts +0 -55
- package/src/runtime/group-join.ts +0 -267
- package/src/runtime/handoff-manager.ts +0 -598
- package/src/runtime/heartbeat-gradient.ts +0 -36
- package/src/runtime/heartbeat-watcher.ts +0 -239
- package/src/runtime/hidden-handoff.ts +0 -407
- package/src/runtime/important-line-classifier.ts +0 -140
- package/src/runtime/intercom-bridge.ts +0 -187
- package/src/runtime/iteration-hooks.ts +0 -305
- package/src/runtime/live-agent-control.ts +0 -136
- package/src/runtime/live-agent-manager.ts +0 -704
- package/src/runtime/live-control-realtime.ts +0 -56
- package/src/runtime/live-extension-bridge.ts +0 -148
- package/src/runtime/live-irc.ts +0 -97
- package/src/runtime/live-session-health.ts +0 -108
- package/src/runtime/live-session-runtime.ts +0 -1139
- package/src/runtime/loop-gates.ts +0 -128
- package/src/runtime/manifest-cache.ts +0 -375
- package/src/runtime/mcp-proxy.ts +0 -105
- package/src/runtime/metric-parser.ts +0 -36
- package/src/runtime/model-fallback.ts +0 -409
- package/src/runtime/model-resolver.ts +0 -126
- package/src/runtime/model-scope.ts +0 -158
- package/src/runtime/orphan-worker-registry.ts +0 -465
- package/src/runtime/output-validator.ts +0 -202
- package/src/runtime/overflow-recovery.ts +0 -206
- package/src/runtime/parallel-research.ts +0 -68
- package/src/runtime/parallel-utils.ts +0 -160
- package/src/runtime/parent-guard.ts +0 -134
- package/src/runtime/path-overlap.ts +0 -150
- package/src/runtime/peer-dep.ts +0 -292
- package/src/runtime/per-write-validator.ts +0 -181
- package/src/runtime/phase-progress.ts +0 -217
- package/src/runtime/phase-tracker.ts +0 -385
- package/src/runtime/pi-args.ts +0 -655
- package/src/runtime/pi-json-output.ts +0 -170
- package/src/runtime/pi-spawn.ts +0 -273
- package/src/runtime/pipeline-runner.ts +0 -523
- package/src/runtime/plan-templates.ts +0 -201
- package/src/runtime/policy-engine.ts +0 -115
- package/src/runtime/post-checks.ts +0 -142
- package/src/runtime/post-exit-stdio-guard.ts +0 -104
- package/src/runtime/process-lifecycle.ts +0 -491
- package/src/runtime/process-status.ts +0 -154
- package/src/runtime/progress-event-coalescer.ts +0 -44
- package/src/runtime/progress-tracker.ts +0 -124
- package/src/runtime/prose-compressor.ts +0 -162
- package/src/runtime/recovery-recipes.ts +0 -203
- package/src/runtime/replace.ts +0 -570
- package/src/runtime/resilient-edit.ts +0 -153
- package/src/runtime/result-extractor.ts +0 -213
- package/src/runtime/retry-executor.ts +0 -100
- package/src/runtime/retry-runner.ts +0 -336
- package/src/runtime/role-permission.ts +0 -59
- package/src/runtime/run-coalesced-task-group.ts +0 -308
- package/src/runtime/run-drift.ts +0 -219
- package/src/runtime/run-tracker.ts +0 -116
- package/src/runtime/runtime-policy.ts +0 -29
- package/src/runtime/runtime-resolver.ts +0 -172
- package/src/runtime/runtime-warmup.ts +0 -160
- package/src/runtime/scheduler.ts +0 -353
- package/src/runtime/semaphore.ts +0 -141
- package/src/runtime/sensitive-paths.ts +0 -93
- package/src/runtime/session-resources.ts +0 -25
- package/src/runtime/session-snapshot.ts +0 -59
- package/src/runtime/session-usage.ts +0 -79
- package/src/runtime/settings-store.ts +0 -155
- package/src/runtime/sidechain-output.ts +0 -35
- package/src/runtime/single-agent-compose.ts +0 -84
- package/src/runtime/skill-effectiveness.ts +0 -524
- package/src/runtime/skill-instructions.ts +0 -391
- package/src/runtime/stale-reconciler.ts +0 -680
- package/src/runtime/stream-preview.ts +0 -184
- package/src/runtime/streaming-output.ts +0 -50
- package/src/runtime/subagent-manager.ts +0 -561
- package/src/runtime/subprocess-tool-registry.ts +0 -70
- package/src/runtime/supervisor-contact.ts +0 -64
- package/src/runtime/task-display.ts +0 -52
- package/src/runtime/task-graph-scheduler.ts +0 -227
- package/src/runtime/task-graph.ts +0 -290
- package/src/runtime/task-health.ts +0 -83
- package/src/runtime/task-id.ts +0 -161
- package/src/runtime/task-output-context.ts +0 -602
- package/src/runtime/task-packet.ts +0 -268
- package/src/runtime/task-quality.ts +0 -199
- package/src/runtime/task-runner/capabilities.ts +0 -78
- package/src/runtime/task-runner/context-retrieval.ts +0 -163
- package/src/runtime/task-runner/live-executor.ts +0 -227
- package/src/runtime/task-runner/output-splitter.ts +0 -152
- package/src/runtime/task-runner/progress.ts +0 -157
- package/src/runtime/task-runner/prompt-builder.ts +0 -278
- package/src/runtime/task-runner/prompt-pipeline.ts +0 -88
- package/src/runtime/task-runner/result-utils.ts +0 -16
- package/src/runtime/task-runner/retrieval-orchestrator.ts +0 -310
- package/src/runtime/task-runner/run-projection.ts +0 -125
- package/src/runtime/task-runner/state-helpers.ts +0 -176
- package/src/runtime/task-runner/tail-read.ts +0 -34
- package/src/runtime/task-runner.ts +0 -1420
- package/src/runtime/team-runner-artifacts.ts +0 -13
- package/src/runtime/team-runner.ts +0 -1993
- package/src/runtime/tool-output-pruner.ts +0 -333
- package/src/runtime/tool-progress.ts +0 -278
- package/src/runtime/usage-tracker.ts +0 -73
- package/src/runtime/verification-gates.ts +0 -571
- package/src/runtime/verification-integrity.ts +0 -105
- package/src/runtime/verification-worktree.ts +0 -186
- package/src/runtime/worker-heartbeat.ts +0 -25
- package/src/runtime/worker-startup.ts +0 -83
- package/src/runtime/workflow-state.ts +0 -195
- package/src/runtime/workspace-lock.ts +0 -443
- package/src/runtime/workspace-tree.ts +0 -312
- package/src/runtime/yield-handler.ts +0 -224
- package/src/runtime/zombie-scanner.ts +0 -298
- package/src/schema/config-schema.ts +0 -327
- package/src/schema/team-tool-schema.ts +0 -415
- package/src/schema/validation-types.ts +0 -159
- package/src/skills/discover-skills.ts +0 -197
- package/src/skills/skill-templates.ts +0 -456
- package/src/skills/validate.ts +0 -285
- package/src/state/active-run-registry.ts +0 -439
- package/src/state/artifact-store.ts +0 -176
- package/src/state/atomic-write.ts +0 -903
- package/src/state/blob-store.ts +0 -308
- package/src/state/contracts.ts +0 -158
- package/src/state/crew-init.ts +0 -269
- package/src/state/decision-ledger.ts +0 -345
- package/src/state/event-log-rotation.ts +0 -342
- package/src/state/event-log.ts +0 -1311
- package/src/state/event-reconstructor.ts +0 -229
- package/src/state/gitignore-manager.ts +0 -46
- package/src/state/health-store.ts +0 -79
- package/src/state/hook-instinct-bridge.ts +0 -94
- package/src/state/hook-integrations.ts +0 -51
- package/src/state/instinct-store.ts +0 -275
- package/src/state/jsonl-writer.ts +0 -107
- package/src/state/locks.ts +0 -562
- package/src/state/mailbox.ts +0 -916
- package/src/state/observation-store.ts +0 -176
- package/src/state/run-cache.ts +0 -193
- package/src/state/run-graph.ts +0 -183
- package/src/state/run-metrics.ts +0 -165
- package/src/state/schedule.ts +0 -166
- package/src/state/session-state-map.ts +0 -51
- package/src/state/state-store.ts +0 -958
- package/src/state/task-claims.ts +0 -61
- package/src/state/tiered-eval.ts +0 -480
- package/src/state/types-eval.ts +0 -58
- package/src/state/types.ts +0 -440
- package/src/state/usage.ts +0 -138
- package/src/state/worker-atomic-writer.ts +0 -194
- package/src/subagents/async-entry.ts +0 -1
- package/src/subagents/index.ts +0 -3
- package/src/subagents/live/control.ts +0 -1
- package/src/subagents/live/manager.ts +0 -1
- package/src/subagents/live/realtime.ts +0 -1
- package/src/subagents/live/session-runtime.ts +0 -1
- package/src/subagents/manager.ts +0 -1
- package/src/subagents/spawn.ts +0 -1
- package/src/teams/discover-teams.ts +0 -187
- package/src/teams/team-config.ts +0 -27
- package/src/teams/team-serializer.ts +0 -38
- package/src/tools/safe-bash-extension.ts +0 -54
- package/src/tools/safe-bash.ts +0 -505
- package/src/types/diff.d.ts +0 -18
- package/src/types/new-api-types.ts +0 -35
- package/src/ui/agent-management-overlay.ts +0 -160
- package/src/ui/card-colors.ts +0 -139
- package/src/ui/crew-footer.ts +0 -102
- package/src/ui/crew-select-list.ts +0 -111
- package/src/ui/dashboard-panes/agents-pane.ts +0 -164
- package/src/ui/dashboard-panes/cancellation-pane.ts +0 -66
- package/src/ui/dashboard-panes/capability-pane.ts +0 -77
- package/src/ui/dashboard-panes/health-pane.ts +0 -31
- package/src/ui/dashboard-panes/mailbox-pane.ts +0 -35
- package/src/ui/dashboard-panes/metrics-pane.ts +0 -37
- package/src/ui/dashboard-panes/progress-pane.ts +0 -38
- package/src/ui/dashboard-panes/transcript-pane.ts +0 -10
- package/src/ui/deploy-bundled-themes.ts +0 -71
- package/src/ui/dwf-phase-display.ts +0 -151
- package/src/ui/dynamic-border.ts +0 -35
- package/src/ui/heartbeat-aggregator.ts +0 -74
- package/src/ui/key-utils.ts +0 -42
- package/src/ui/keybinding-map.ts +0 -248
- package/src/ui/layout-primitives.ts +0 -106
- package/src/ui/live-conversation-overlay.ts +0 -183
- package/src/ui/live-duration.ts +0 -55
- package/src/ui/live-run-sidebar.ts +0 -301
- package/src/ui/loaders.ts +0 -176
- package/src/ui/mascot.ts +0 -436
- package/src/ui/overlays/agent-picker-overlay.ts +0 -65
- package/src/ui/overlays/confirm-overlay.ts +0 -60
- package/src/ui/overlays/help-overlay.ts +0 -177
- package/src/ui/overlays/mailbox-compose-overlay.ts +0 -181
- package/src/ui/overlays/mailbox-compose-preview.ts +0 -78
- package/src/ui/overlays/mailbox-detail-overlay.ts +0 -154
- package/src/ui/pi-ui-compat.ts +0 -68
- package/src/ui/powerbar-publisher.ts +0 -459
- package/src/ui/render-coalescer.ts +0 -101
- package/src/ui/render-diff.ts +0 -160
- package/src/ui/render-scheduler.ts +0 -224
- package/src/ui/run-action-dispatcher.ts +0 -182
- package/src/ui/run-dashboard.ts +0 -913
- package/src/ui/run-event-bus.ts +0 -381
- package/src/ui/run-snapshot-cache.ts +0 -1057
- package/src/ui/settings-overlay.ts +0 -1067
- package/src/ui/snapshot-types.ts +0 -90
- package/src/ui/spinner.ts +0 -17
- package/src/ui/status-colors.ts +0 -143
- package/src/ui/syntax-highlight.ts +0 -136
- package/src/ui/terminal-status.ts +0 -269
- package/src/ui/theme-adapter.ts +0 -271
- package/src/ui/theme-discovery.ts +0 -199
- package/src/ui/tool-progress-formatter.ts +0 -93
- package/src/ui/tool-render.ts +0 -453
- package/src/ui/tool-renderers/brief-mode.ts +0 -225
- package/src/ui/tool-renderers/index.ts +0 -726
- package/src/ui/transcript-cache.ts +0 -128
- package/src/ui/transcript-entries.ts +0 -256
- package/src/ui/transcript-viewer.ts +0 -424
- package/src/ui/widget/index.ts +0 -357
- package/src/ui/widget/widget-formatters.ts +0 -182
- package/src/ui/widget/widget-model.ts +0 -110
- package/src/ui/widget/widget-renderer.ts +0 -182
- package/src/ui/widget/widget-types.ts +0 -36
- package/src/utils/bm25-search.ts +0 -235
- package/src/utils/completion-dedupe.ts +0 -63
- package/src/utils/conflict-detect.ts +0 -668
- package/src/utils/env-allowlist.ts +0 -30
- package/src/utils/env-filter.ts +0 -155
- package/src/utils/file-coalescer.ts +0 -98
- package/src/utils/fingerprint.ts +0 -180
- package/src/utils/frontmatter.ts +0 -70
- package/src/utils/fs-watch.ts +0 -37
- package/src/utils/gh-protocol.ts +0 -556
- package/src/utils/git.ts +0 -260
- package/src/utils/guards.ts +0 -107
- package/src/utils/ids.ts +0 -24
- package/src/utils/incremental-reader.ts +0 -220
- package/src/utils/internal-error.ts +0 -10
- package/src/utils/names.ts +0 -36
- package/src/utils/ndjson.ts +0 -115
- package/src/utils/paths.ts +0 -227
- package/src/utils/project-detector.ts +0 -160
- package/src/utils/redaction.ts +0 -347
- package/src/utils/resolve-shell.ts +0 -36
- package/src/utils/run-watcher-registry.ts +0 -152
- package/src/utils/safe-paths.ts +0 -383
- package/src/utils/scan-cache.ts +0 -144
- package/src/utils/session-utils.ts +0 -110
- package/src/utils/sleep.ts +0 -54
- package/src/utils/socket-path.ts +0 -127
- package/src/utils/sse-parser.ts +0 -129
- package/src/utils/task-name-generator.ts +0 -337
- package/src/utils/timings.ts +0 -33
- package/src/utils/token-counter.ts +0 -200
- package/src/utils/visual.ts +0 -207
- package/src/workflows/cost-estimator.ts +0 -34
- package/src/workflows/discover-workflows.ts +0 -290
- package/src/workflows/intermediate-store.ts +0 -166
- package/src/workflows/preflight-validator.ts +0 -168
- package/src/workflows/topology-analyzer.ts +0 -203
- package/src/workflows/validate-workflow.ts +0 -50
- package/src/workflows/workflow-config.ts +0 -70
- package/src/workflows/workflow-serializer.ts +0 -32
- package/src/worktree/branch-freshness.ts +0 -112
- package/src/worktree/cleanup.ts +0 -341
- package/src/worktree/worktree-manager.ts +0 -1200
|
@@ -1,1200 +0,0 @@
|
|
|
1
|
-
import { execFile, execFileSync, spawnSync } from "node:child_process";
|
|
2
|
-
import { randomBytes } from "node:crypto";
|
|
3
|
-
import * as fs from "node:fs";
|
|
4
|
-
import * as path from "node:path";
|
|
5
|
-
import { promisify } from "node:util";
|
|
6
|
-
import { loadConfig } from "../config/config.ts";
|
|
7
|
-
import { DEFAULT_PATHS } from "../config/defaults.ts";
|
|
8
|
-
import { writeArtifact } from "../state/artifact-store.ts";
|
|
9
|
-
import type { TeamRunManifest, TeamTaskState } from "../state/types.ts";
|
|
10
|
-
import { WINDOWS_ESSENTIAL_ENV_VARS } from "../utils/env-allowlist.ts";
|
|
11
|
-
import { sanitizeEnvSecrets } from "../utils/env-filter.ts";
|
|
12
|
-
import { logInternalError } from "../utils/internal-error.ts";
|
|
13
|
-
import { projectCrewRoot } from "../utils/paths.ts";
|
|
14
|
-
|
|
15
|
-
export interface PreparedTaskWorkspace {
|
|
16
|
-
cwd: string;
|
|
17
|
-
worktreePath?: string;
|
|
18
|
-
branch?: string;
|
|
19
|
-
reused?: boolean;
|
|
20
|
-
nodeModulesLinked?: boolean;
|
|
21
|
-
syntheticPaths?: string[];
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
const execFileAsync = promisify(execFile);
|
|
25
|
-
|
|
26
|
-
export interface WorktreeDiffStat {
|
|
27
|
-
filesChanged: number;
|
|
28
|
-
insertions: number;
|
|
29
|
-
deletions: number;
|
|
30
|
-
diffStat: string;
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
function git(cwd: string, args: string[]): string {
|
|
34
|
-
// SECURITY: PI_* and PI_CREW_* wildcards removed — they could match secret vars like PI_PASSWORD.
|
|
35
|
-
// Git operations do not need PI_CREW_* execution-control vars.
|
|
36
|
-
return execFileSync("git", args, {
|
|
37
|
-
cwd,
|
|
38
|
-
encoding: "utf-8",
|
|
39
|
-
stdio: ["ignore", "pipe", "pipe"],
|
|
40
|
-
env: {
|
|
41
|
-
...sanitizeEnvSecrets(process.env, {
|
|
42
|
-
allowList: [
|
|
43
|
-
"PATH",
|
|
44
|
-
"HOME",
|
|
45
|
-
"USER",
|
|
46
|
-
...WINDOWS_ESSENTIAL_ENV_VARS,
|
|
47
|
-
"SHELL",
|
|
48
|
-
"TERM",
|
|
49
|
-
"LANG",
|
|
50
|
-
"LC_ALL",
|
|
51
|
-
"LC_COLLATE",
|
|
52
|
-
"LC_CTYPE",
|
|
53
|
-
"LC_MESSAGES",
|
|
54
|
-
"XDG_CONFIG_HOME",
|
|
55
|
-
"XDG_DATA_HOME",
|
|
56
|
-
"XDG_CACHE_HOME",
|
|
57
|
-
"NVM_BIN",
|
|
58
|
-
"NVM_DIR",
|
|
59
|
-
"NODE_PATH",
|
|
60
|
-
"GIT_CONFIG_GLOBAL",
|
|
61
|
-
"GIT_CONFIG_SYSTEM",
|
|
62
|
-
"GIT_AUTHOR_NAME",
|
|
63
|
-
"GIT_AUTHOR_EMAIL",
|
|
64
|
-
"GIT_COMMITTER_NAME",
|
|
65
|
-
"GIT_COMMITTER_EMAIL",
|
|
66
|
-
],
|
|
67
|
-
}),
|
|
68
|
-
LANG: "en_US.UTF-8",
|
|
69
|
-
LC_ALL: "en_US.UTF-8",
|
|
70
|
-
},
|
|
71
|
-
windowsHide: true,
|
|
72
|
-
}).trim();
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
/** Build the sanitized env object shared by all git operations. */
|
|
76
|
-
function gitEnv(): Record<string, string> {
|
|
77
|
-
return {
|
|
78
|
-
...sanitizeEnvSecrets(process.env, {
|
|
79
|
-
allowList: [
|
|
80
|
-
"PATH",
|
|
81
|
-
"HOME",
|
|
82
|
-
"USER",
|
|
83
|
-
...WINDOWS_ESSENTIAL_ENV_VARS,
|
|
84
|
-
"SHELL",
|
|
85
|
-
"TERM",
|
|
86
|
-
"LANG",
|
|
87
|
-
"LC_ALL",
|
|
88
|
-
"LC_COLLATE",
|
|
89
|
-
"LC_CTYPE",
|
|
90
|
-
"LC_MESSAGES",
|
|
91
|
-
"XDG_CONFIG_HOME",
|
|
92
|
-
"XDG_DATA_HOME",
|
|
93
|
-
"XDG_CACHE_HOME",
|
|
94
|
-
"NVM_BIN",
|
|
95
|
-
"NVM_DIR",
|
|
96
|
-
"NODE_PATH",
|
|
97
|
-
"GIT_CONFIG_GLOBAL",
|
|
98
|
-
"GIT_CONFIG_SYSTEM",
|
|
99
|
-
"GIT_AUTHOR_NAME",
|
|
100
|
-
"GIT_AUTHOR_EMAIL",
|
|
101
|
-
"GIT_COMMITTER_NAME",
|
|
102
|
-
"GIT_COMMITTER_EMAIL",
|
|
103
|
-
],
|
|
104
|
-
}),
|
|
105
|
-
LANG: "en_US.UTF-8",
|
|
106
|
-
LC_ALL: "en_US.UTF-8",
|
|
107
|
-
};
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
async function gitAsync(cwd: string, args: string[]): Promise<string> {
|
|
111
|
-
const { stdout } = await execFileAsync("git", args, {
|
|
112
|
-
cwd,
|
|
113
|
-
encoding: "utf-8",
|
|
114
|
-
env: gitEnv(),
|
|
115
|
-
windowsHide: true,
|
|
116
|
-
});
|
|
117
|
-
return stdout.trim();
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
// Dots are removed from branch names since they are used in path construction,
|
|
121
|
-
// and dots could cause ambiguity with relative path handling on some platforms.
|
|
122
|
-
// Branch names themselves support dots in git, but we strip them for safe path use.
|
|
123
|
-
function sanitizeBranchPart(value: string): string {
|
|
124
|
-
return (
|
|
125
|
-
value
|
|
126
|
-
.toLowerCase()
|
|
127
|
-
.replace(/[^a-z0-9_/-]+/g, "-")
|
|
128
|
-
.replace(/^-+|-+$/g, "") || "task"
|
|
129
|
-
);
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
export function findGitRoot(cwd: string): string {
|
|
133
|
-
return git(cwd, ["rev-parse", "--show-toplevel"]);
|
|
134
|
-
}
|
|
135
|
-
|
|
136
|
-
export function assertCleanLeader(repoRoot: string): void {
|
|
137
|
-
// H-7 follow-up: --untracked-files=no so pi-crew's own auto-created .gitignore
|
|
138
|
-
// (and any other untracked files the user hasn't staged) doesn't block worktree mode.
|
|
139
|
-
// The worktree contract is "no tracked changes" — untracked files are safe since
|
|
140
|
-
// they're either in .gitignore or the user can decide later.
|
|
141
|
-
const status = git(repoRoot, ["status", "--porcelain", "--untracked-files=no"]);
|
|
142
|
-
if (status.trim()) {
|
|
143
|
-
throw new Error("Worktree mode requires a clean leader repository. Commit/stash changes or use workspaceMode: 'single'.");
|
|
144
|
-
}
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
// --- Async versions ---
|
|
148
|
-
|
|
149
|
-
/** Cache for findGitRoot results keyed by cwd. Cleared per-run. */
|
|
150
|
-
const _gitRootCache = new Map<string, string>();
|
|
151
|
-
|
|
152
|
-
/** Clear the findGitRoot cache. Call at the start of each team run. */
|
|
153
|
-
export function clearGitRootCache(): void {
|
|
154
|
-
_gitRootCache.clear();
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
export async function findGitRootAsync(cwd: string): Promise<string> {
|
|
158
|
-
const cached = _gitRootCache.get(cwd);
|
|
159
|
-
if (cached) return cached;
|
|
160
|
-
const root = await gitAsync(cwd, ["rev-parse", "--show-toplevel"]);
|
|
161
|
-
_gitRootCache.set(cwd, root);
|
|
162
|
-
return root;
|
|
163
|
-
}
|
|
164
|
-
|
|
165
|
-
/** Cache for assertCleanLeader results keyed by repoRoot. Cleared per-run. */
|
|
166
|
-
const _cleanLeaderCache = new Set<string>();
|
|
167
|
-
|
|
168
|
-
/** Clear the assertCleanLeader cache. Call at the start of each team run. */
|
|
169
|
-
export function clearCleanLeaderCache(): void {
|
|
170
|
-
_cleanLeaderCache.clear();
|
|
171
|
-
}
|
|
172
|
-
|
|
173
|
-
export async function assertCleanLeaderAsync(repoRoot: string): Promise<void> {
|
|
174
|
-
if (_cleanLeaderCache.has(repoRoot)) return;
|
|
175
|
-
// H-7 follow-up: --untracked-files=no so pi-crew's own auto-created .gitignore
|
|
176
|
-
// (and any other untracked files the user hasn't staged) doesn't block worktree mode.
|
|
177
|
-
const status = await gitAsync(repoRoot, ["status", "--porcelain", "--untracked-files=no"]);
|
|
178
|
-
if (status.trim()) {
|
|
179
|
-
throw new Error("Worktree mode requires a clean leader repository. Commit/stash changes or use workspaceMode: 'single'.");
|
|
180
|
-
}
|
|
181
|
-
_cleanLeaderCache.add(repoRoot);
|
|
182
|
-
}
|
|
183
|
-
|
|
184
|
-
function linkNodeModulesIfPresent(repoRoot: string, worktreePath: string): boolean {
|
|
185
|
-
const source = path.join(repoRoot, "node_modules");
|
|
186
|
-
const target = path.join(worktreePath, "node_modules");
|
|
187
|
-
let sourceStat: fs.Stats;
|
|
188
|
-
try {
|
|
189
|
-
sourceStat = fs.statSync(source);
|
|
190
|
-
} catch {
|
|
191
|
-
return false;
|
|
192
|
-
}
|
|
193
|
-
if (!sourceStat.isDirectory()) return false;
|
|
194
|
-
if (fs.existsSync(target)) return false;
|
|
195
|
-
// M5 fix: log symlink failure reason, especially on Windows non-admin.
|
|
196
|
-
try {
|
|
197
|
-
fs.symlinkSync(source, target, process.platform === "win32" ? "junction" : "dir");
|
|
198
|
-
return true;
|
|
199
|
-
} catch (error) {
|
|
200
|
-
const isWindows = process.platform === "win32";
|
|
201
|
-
logInternalError(
|
|
202
|
-
"worktree.symlink-fail",
|
|
203
|
-
error,
|
|
204
|
-
isWindows ? "Windows non-admin: SeCreateSymbolicLinkPrivilege needed for node_modules symlink" : String(error),
|
|
205
|
-
);
|
|
206
|
-
return false;
|
|
207
|
-
}
|
|
208
|
-
}
|
|
209
|
-
|
|
210
|
-
function normalizeSyntheticPath(worktreePath: string, rawPath: string): string {
|
|
211
|
-
const resolved = path.resolve(worktreePath, rawPath);
|
|
212
|
-
const relative = path.relative(worktreePath, resolved);
|
|
213
|
-
if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`synthetic path escapes worktree: ${rawPath}`);
|
|
214
|
-
return path.normalize(relative);
|
|
215
|
-
}
|
|
216
|
-
|
|
217
|
-
/**
|
|
218
|
-
* Validates that a worktree setupHook script path is within an allowed directory.
|
|
219
|
-
* Allowed paths:
|
|
220
|
-
* - Relative paths starting with ".hooks/" (case-sensitive)
|
|
221
|
-
* - Absolute paths under $HOME/.pi/hooks/
|
|
222
|
-
* Rejects all other paths to prevent arbitrary script execution.
|
|
223
|
-
* @param hookPath - The hook script path to validate
|
|
224
|
-
* @returns true if the path is allowed, false otherwise
|
|
225
|
-
*/
|
|
226
|
-
function isAllowedSetupHook(hookPath: string): boolean {
|
|
227
|
-
if (!hookPath || hookPath.trim().length === 0) return false;
|
|
228
|
-
if (!path.isAbsolute(hookPath)) {
|
|
229
|
-
// Use path.posix.normalize for consistent forward-slash handling on all platforms.
|
|
230
|
-
const normalized = path.posix.normalize(hookPath);
|
|
231
|
-
return normalized === ".hooks" || normalized.startsWith(".hooks/");
|
|
232
|
-
}
|
|
233
|
-
// Normalize to forward slashes for consistent cross-platform comparison.
|
|
234
|
-
const normalizedHookPath = hookPath.replace(/\\/g, "/");
|
|
235
|
-
const homeHooksNormalized = (process.env.HOME ?? "").replace(/\\/g, "/") + "/.pi/hooks";
|
|
236
|
-
return normalizedHookPath === homeHooksNormalized || normalizedHookPath.startsWith(homeHooksNormalized + "/");
|
|
237
|
-
}
|
|
238
|
-
|
|
239
|
-
/**
|
|
240
|
-
* SECURITY: Verify a hook script path remains within the allowed directory after
|
|
241
|
-
* real-path resolution. This prevents symlink-based escape where repoRoot is a
|
|
242
|
-
* symlink and the hook path would resolve outside the repository.
|
|
243
|
-
* @param repoRoot - The repository root (resolved to real path)
|
|
244
|
-
* @param hookPath - The resolved absolute hook path
|
|
245
|
-
* @returns true if the hook is safely contained within repoRoot
|
|
246
|
-
*/
|
|
247
|
-
function isHookPathContainedInRepoRoot(repoRoot: string, hookPath: string): boolean {
|
|
248
|
-
try {
|
|
249
|
-
const realRepoRoot = fs.realpathSync(repoRoot);
|
|
250
|
-
const realHookPath = fs.realpathSync(path.dirname(hookPath));
|
|
251
|
-
return realHookPath.startsWith(realRepoRoot + path.sep) || realHookPath === realRepoRoot;
|
|
252
|
-
} catch {
|
|
253
|
-
return false;
|
|
254
|
-
}
|
|
255
|
-
}
|
|
256
|
-
|
|
257
|
-
function runSetupHook(manifest: TeamRunManifest, task: TeamTaskState, repoRoot: string, worktreePath: string, branch: string): string[] {
|
|
258
|
-
const cfg = loadConfig(manifest.cwd).config.worktree;
|
|
259
|
-
if (!cfg?.setupHook) return [];
|
|
260
|
-
const rawHookPath = cfg.setupHook;
|
|
261
|
-
if (!isAllowedSetupHook(rawHookPath)) {
|
|
262
|
-
logInternalError("worktree.setupHook.rejected", new Error("hook path not allowed: " + rawHookPath), `cwd=${manifest.cwd}`);
|
|
263
|
-
return [];
|
|
264
|
-
}
|
|
265
|
-
// SECURITY WARNING: Home directory hooks (~/.pi/hooks/) are user-writable and not project-scoped.
|
|
266
|
-
// A rogue npm postinstall script could place malicious hooks there. Log for visibility.
|
|
267
|
-
//
|
|
268
|
-
// SECURITY ASSUMPTION: This function trusts that the hook scripts themselves are not malicious.
|
|
269
|
-
// Hook scripts are executed with the same privileges as the Pi process. The caller is responsible
|
|
270
|
-
// for ensuring that only trusted hook scripts are configured. Path containment validation
|
|
271
|
-
// (isAllowedSetupHook, isHookPathContainedInRepoRoot) prevents hook scripts from writing outside
|
|
272
|
-
// the worktree, but cannot prevent a trusted hook from performing harmful operations within it.
|
|
273
|
-
if (path.isAbsolute(rawHookPath)) {
|
|
274
|
-
logInternalError(
|
|
275
|
-
"worktree.setupHook.homeHook",
|
|
276
|
-
new Error("Home directory hook used — ensure ~/.pi/hooks/ is trusted"),
|
|
277
|
-
`hookPath=${rawHookPath}`,
|
|
278
|
-
);
|
|
279
|
-
}
|
|
280
|
-
const hookPath = path.isAbsolute(rawHookPath) ? rawHookPath : path.resolve(repoRoot, rawHookPath);
|
|
281
|
-
// SECURITY: Verify the resolved hook path is contained within the real repoRoot.
|
|
282
|
-
// This prevents symlink-based escape where repoRoot is a symlink.
|
|
283
|
-
if (!path.isAbsolute(rawHookPath) && !isHookPathContainedInRepoRoot(repoRoot, hookPath)) {
|
|
284
|
-
logInternalError(
|
|
285
|
-
"worktree.setupHook.contained",
|
|
286
|
-
new Error("hook path escapes repoRoot after realpath resolution: " + hookPath),
|
|
287
|
-
`repoRoot=${repoRoot}`,
|
|
288
|
-
);
|
|
289
|
-
return [];
|
|
290
|
-
}
|
|
291
|
-
try {
|
|
292
|
-
const hookStat = fs.lstatSync(hookPath);
|
|
293
|
-
if (!hookStat.isFile()) {
|
|
294
|
-
logInternalError("worktree.setupHook.missing", new Error("hook not found or is directory: " + hookPath), `cwd=${manifest.cwd}`);
|
|
295
|
-
return [];
|
|
296
|
-
}
|
|
297
|
-
} catch {
|
|
298
|
-
logInternalError("worktree.setupHook.missing", new Error("hook not found: " + hookPath), `cwd=${manifest.cwd}`);
|
|
299
|
-
return [];
|
|
300
|
-
}
|
|
301
|
-
const nodeHook = hookPath.endsWith(".js") || hookPath.endsWith(".cjs") || hookPath.endsWith(".mjs");
|
|
302
|
-
// For .bat/.cmd files on Windows, execute via cmd.exe /c directly
|
|
303
|
-
const isBatchFile = hookPath.endsWith(".bat") || hookPath.endsWith(".cmd");
|
|
304
|
-
// SECURITY: Never use shell:true — prevents command injection from untrusted hooks.
|
|
305
|
-
// Non-node, non-batch hooks on Windows will fail to execute rather than
|
|
306
|
-
// running through a shell that could interpret malicious filenames.
|
|
307
|
-
const useShell = false;
|
|
308
|
-
if (process.platform === "win32" && !nodeHook && !isBatchFile) {
|
|
309
|
-
logInternalError(
|
|
310
|
-
"worktree.setupHook.windowsNoShell",
|
|
311
|
-
new Error("Non-node, non-batch hook skipped on Windows (shell:true disabled for security)"),
|
|
312
|
-
`hook=${hookPath}`,
|
|
313
|
-
);
|
|
314
|
-
}
|
|
315
|
-
// SECURITY: Resolve the hook to its real path before execution to close the TOCTOU window.
|
|
316
|
-
// This prevents a symlink swap between the containment check and actual execution.
|
|
317
|
-
// KNOWN LIMITATION: There is a residual TOCTOU window between realpathSync validation
|
|
318
|
-
// (line 166) and spawnSync execution (line 183). A sufficiently fast attacker could
|
|
319
|
-
// theoretically swap the symlink between these two operations. The realpathSync + O_NOFOLLOW
|
|
320
|
-
// approach minimizes but does not eliminate this window. To fully close it, consider
|
|
321
|
-
// opening the hook file once via a file descriptor and executing via fd passing (not available
|
|
322
|
-
// in Node.js spawnSync). This is documented as a known limitation rather than a bug.
|
|
323
|
-
let realHookPath: string;
|
|
324
|
-
try {
|
|
325
|
-
realHookPath = fs.realpathSync(hookPath);
|
|
326
|
-
} catch {
|
|
327
|
-
logInternalError("worktree.setupHook.realpath", new Error("hook realpath resolution failed: " + hookPath), `cwd=${manifest.cwd}`);
|
|
328
|
-
return [];
|
|
329
|
-
}
|
|
330
|
-
const result = isBatchFile
|
|
331
|
-
? spawnSync("cmd.exe", ["/c", realHookPath], {
|
|
332
|
-
cwd: worktreePath,
|
|
333
|
-
encoding: "utf-8",
|
|
334
|
-
input: JSON.stringify({
|
|
335
|
-
version: 1,
|
|
336
|
-
repoRoot,
|
|
337
|
-
worktreePath,
|
|
338
|
-
agentCwd: worktreePath,
|
|
339
|
-
branch,
|
|
340
|
-
runId: manifest.runId,
|
|
341
|
-
taskId: task.id,
|
|
342
|
-
agent: task.agent,
|
|
343
|
-
}),
|
|
344
|
-
timeout: cfg.setupHookTimeoutMs ?? 30_000,
|
|
345
|
-
shell: false, // cmd.exe /c handles batch files safely
|
|
346
|
-
env: sanitizeEnvSecrets(process.env, {
|
|
347
|
-
allowList: ["PATH", "HOME", ...WINDOWS_ESSENTIAL_ENV_VARS, "TMPDIR", "LANG", "LC_ALL"],
|
|
348
|
-
}),
|
|
349
|
-
windowsHide: true,
|
|
350
|
-
})
|
|
351
|
-
: spawnSync(nodeHook ? process.execPath : realHookPath, nodeHook ? [realHookPath] : [], {
|
|
352
|
-
cwd: worktreePath,
|
|
353
|
-
encoding: "utf-8",
|
|
354
|
-
input: JSON.stringify({
|
|
355
|
-
version: 1,
|
|
356
|
-
repoRoot,
|
|
357
|
-
worktreePath,
|
|
358
|
-
agentCwd: worktreePath,
|
|
359
|
-
branch,
|
|
360
|
-
runId: manifest.runId,
|
|
361
|
-
taskId: task.id,
|
|
362
|
-
agent: task.agent,
|
|
363
|
-
}),
|
|
364
|
-
timeout: cfg.setupHookTimeoutMs ?? 30_000,
|
|
365
|
-
shell: false,
|
|
366
|
-
env: sanitizeEnvSecrets(process.env, {
|
|
367
|
-
allowList: ["PATH", "HOME", ...WINDOWS_ESSENTIAL_ENV_VARS, "TMPDIR", "LANG", "LC_ALL"],
|
|
368
|
-
}),
|
|
369
|
-
windowsHide: true,
|
|
370
|
-
});
|
|
371
|
-
if (result.error) throw new Error(`worktree setup hook failed: ${result.error.message}`);
|
|
372
|
-
if (result.status !== 0)
|
|
373
|
-
throw new Error(`worktree setup hook failed with exit code ${result.status}: ${result.stderr || result.stdout || "no output"}`);
|
|
374
|
-
const trimmed = result.stdout.trim();
|
|
375
|
-
if (!trimmed) return [];
|
|
376
|
-
try {
|
|
377
|
-
// Extract JSON — hooks may output debug logging before JSON.
|
|
378
|
-
// M4 fix: try full trimmed (multi-line JSON object) before falling back to last line.
|
|
379
|
-
const lines = trimmed.split(/\r?\n/);
|
|
380
|
-
let parsed: { syntheticPaths?: unknown } | null = null;
|
|
381
|
-
try {
|
|
382
|
-
parsed = JSON.parse(trimmed) as { syntheticPaths?: unknown };
|
|
383
|
-
} catch {
|
|
384
|
-
/* fall through — try last line */
|
|
385
|
-
}
|
|
386
|
-
if (!parsed && lines.length > 0) {
|
|
387
|
-
const lastLine = lines[lines.length - 1];
|
|
388
|
-
try {
|
|
389
|
-
parsed = JSON.parse(lastLine) as { syntheticPaths?: unknown };
|
|
390
|
-
} catch {
|
|
391
|
-
/* give up */
|
|
392
|
-
}
|
|
393
|
-
}
|
|
394
|
-
if (!parsed || !Array.isArray(parsed.syntheticPaths)) return [];
|
|
395
|
-
return [
|
|
396
|
-
...new Set(
|
|
397
|
-
parsed.syntheticPaths
|
|
398
|
-
.filter((entry): entry is string => typeof entry === "string")
|
|
399
|
-
.map((entry) => normalizeSyntheticPath(worktreePath, entry)),
|
|
400
|
-
),
|
|
401
|
-
];
|
|
402
|
-
} catch (error) {
|
|
403
|
-
logInternalError("worktree.setupHook.parse", error, `lastLine=${(trimmed.split(/\r?\n/).pop() ?? "").slice(0, 200)}`);
|
|
404
|
-
return [];
|
|
405
|
-
}
|
|
406
|
-
}
|
|
407
|
-
|
|
408
|
-
function branchExists(repoRoot: string, branch: string): { local: boolean; remoteOnly: boolean } {
|
|
409
|
-
let local = false;
|
|
410
|
-
try {
|
|
411
|
-
git(repoRoot, ["rev-parse", "--verify", `refs/heads/${branch}`]);
|
|
412
|
-
local = true;
|
|
413
|
-
} catch {}
|
|
414
|
-
if (local) return { local: true, remoteOnly: false };
|
|
415
|
-
// Check remote-tracking branch
|
|
416
|
-
try {
|
|
417
|
-
const out = execFileSync("git", ["for-each-ref", "--format=%(refname)", `refs/remotes/*/${branch}`], {
|
|
418
|
-
cwd: repoRoot,
|
|
419
|
-
encoding: "utf-8",
|
|
420
|
-
stdio: ["ignore", "pipe", "pipe"],
|
|
421
|
-
windowsHide: true,
|
|
422
|
-
}).trim();
|
|
423
|
-
return { local: false, remoteOnly: out.length > 0 };
|
|
424
|
-
} catch {
|
|
425
|
-
return { local: false, remoteOnly: false };
|
|
426
|
-
}
|
|
427
|
-
}
|
|
428
|
-
|
|
429
|
-
function pruneStaleWorktrees(repoRoot: string): void {
|
|
430
|
-
try {
|
|
431
|
-
execFileSync("git", ["worktree", "prune"], {
|
|
432
|
-
cwd: repoRoot,
|
|
433
|
-
stdio: "ignore",
|
|
434
|
-
});
|
|
435
|
-
} catch {
|
|
436
|
-
/* best-effort */
|
|
437
|
-
}
|
|
438
|
-
}
|
|
439
|
-
|
|
440
|
-
async function branchExistsAsync(repoRoot: string, branch: string): Promise<{ local: boolean; remoteOnly: boolean }> {
|
|
441
|
-
let local = false;
|
|
442
|
-
try {
|
|
443
|
-
await gitAsync(repoRoot, ["rev-parse", "--verify", `refs/heads/${branch}`]);
|
|
444
|
-
local = true;
|
|
445
|
-
} catch {}
|
|
446
|
-
if (local) return { local: true, remoteOnly: false };
|
|
447
|
-
// Check remote-tracking branch
|
|
448
|
-
try {
|
|
449
|
-
const out = (
|
|
450
|
-
await execFileAsync("git", ["for-each-ref", "--format=%(refname)", `refs/remotes/*/${branch}`], {
|
|
451
|
-
cwd: repoRoot,
|
|
452
|
-
encoding: "utf-8",
|
|
453
|
-
windowsHide: true,
|
|
454
|
-
})
|
|
455
|
-
).stdout.trim();
|
|
456
|
-
return { local: false, remoteOnly: out.length > 0 };
|
|
457
|
-
} catch {
|
|
458
|
-
return { local: false, remoteOnly: false };
|
|
459
|
-
}
|
|
460
|
-
}
|
|
461
|
-
|
|
462
|
-
async function pruneStaleWorktreesAsync(repoRoot: string): Promise<void> {
|
|
463
|
-
try {
|
|
464
|
-
await execFileAsync("git", ["worktree", "prune"], {
|
|
465
|
-
cwd: repoRoot,
|
|
466
|
-
windowsHide: true,
|
|
467
|
-
});
|
|
468
|
-
} catch {
|
|
469
|
-
/* best-effort */
|
|
470
|
-
}
|
|
471
|
-
}
|
|
472
|
-
|
|
473
|
-
/**
|
|
474
|
-
* Normalize and validate seed paths — ensure all paths stay within repoRoot.
|
|
475
|
-
* Rejects path traversal (../) and absolute paths.
|
|
476
|
-
*/
|
|
477
|
-
export function normalizeSeedPaths(seedPaths: string[], repoRoot: string): string[] {
|
|
478
|
-
const resolvedRepoRoot = path.resolve(repoRoot);
|
|
479
|
-
const entries = Array.isArray(seedPaths) ? seedPaths : [];
|
|
480
|
-
const seen = new Set<string>();
|
|
481
|
-
const normalized: string[] = [];
|
|
482
|
-
|
|
483
|
-
for (const entry of entries) {
|
|
484
|
-
if (typeof entry !== "string" || entry.trim().length === 0) continue;
|
|
485
|
-
|
|
486
|
-
const absolutePath = path.resolve(resolvedRepoRoot, entry);
|
|
487
|
-
const relativePath = path.relative(resolvedRepoRoot, absolutePath);
|
|
488
|
-
|
|
489
|
-
if (relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
|
|
490
|
-
throw new Error(`seedPaths entries must stay inside repoRoot: ${entry}`);
|
|
491
|
-
}
|
|
492
|
-
|
|
493
|
-
// Reject symlinks to prevent escape via symlink-based path traversal.
|
|
494
|
-
// This check is also performed in overlaySeedPaths for defense-in-depth.
|
|
495
|
-
// ENOENT is acceptable — seed paths may reference files that don't exist yet
|
|
496
|
-
// (they are validated at copy time by overlaySeedPaths).
|
|
497
|
-
try {
|
|
498
|
-
const stat = fs.lstatSync(absolutePath);
|
|
499
|
-
if (stat.isSymbolicLink()) {
|
|
500
|
-
throw new Error(`seedPaths entries cannot be symlinks: ${entry}`);
|
|
501
|
-
}
|
|
502
|
-
} catch (error) {
|
|
503
|
-
if (error instanceof Error && error.message.startsWith("seedPaths entries")) throw error;
|
|
504
|
-
// ENOENT is acceptable — seed paths may reference files that don't exist yet.
|
|
505
|
-
// Skip symlink check but still include the path in results.
|
|
506
|
-
if (!(error instanceof Error && "code" in error && (error as NodeJS.ErrnoException).code === "ENOENT")) {
|
|
507
|
-
throw new Error(`seedPaths entries must be accessible: ${entry}`);
|
|
508
|
-
}
|
|
509
|
-
}
|
|
510
|
-
|
|
511
|
-
const normalizedPath = relativePath.split(path.sep).join("/");
|
|
512
|
-
if (seen.has(normalizedPath)) continue;
|
|
513
|
-
seen.add(normalizedPath);
|
|
514
|
-
normalized.push(normalizedPath);
|
|
515
|
-
}
|
|
516
|
-
|
|
517
|
-
return normalized;
|
|
518
|
-
}
|
|
519
|
-
|
|
520
|
-
/**
|
|
521
|
-
* Overlay seed paths from repoRoot into worktreePath.
|
|
522
|
-
* Copies files and directories, creating parent dirs as needed.
|
|
523
|
-
* Skips non-existent sources with logInternalError (non-fatal).
|
|
524
|
-
*/
|
|
525
|
-
export function overlaySeedPaths(repoRoot: string, worktreePath: string, seedPaths: string[]): void {
|
|
526
|
-
const normalized = normalizeSeedPaths(seedPaths, repoRoot);
|
|
527
|
-
|
|
528
|
-
for (const seedPath of normalized) {
|
|
529
|
-
const sourcePath = path.join(repoRoot, seedPath);
|
|
530
|
-
const destinationPath = path.join(worktreePath, seedPath);
|
|
531
|
-
|
|
532
|
-
let sourceStat: fs.Stats;
|
|
533
|
-
try {
|
|
534
|
-
sourceStat = fs.lstatSync(sourcePath);
|
|
535
|
-
} catch {
|
|
536
|
-
logInternalError("worktree.seedPaths.missing", new Error(`Seed path does not exist: ${seedPath}`));
|
|
537
|
-
continue;
|
|
538
|
-
}
|
|
539
|
-
// Reject symlinks in seed paths to prevent copying symlinks into worktree (which could point outside repoRoot).
|
|
540
|
-
if (sourceStat.isSymbolicLink()) {
|
|
541
|
-
logInternalError("worktree.seedPaths.symlink", new Error(`Seed path is a symlink — rejected: ${seedPath}`));
|
|
542
|
-
continue;
|
|
543
|
-
}
|
|
544
|
-
if (!sourceStat.isFile() && !sourceStat.isDirectory()) {
|
|
545
|
-
logInternalError("worktree.seedPaths.invalid", new Error(`Seed path is neither file nor directory: ${seedPath}`));
|
|
546
|
-
continue;
|
|
547
|
-
}
|
|
548
|
-
|
|
549
|
-
fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
|
|
550
|
-
fs.rmSync(destinationPath, { force: true, recursive: true });
|
|
551
|
-
fs.cpSync(sourcePath, destinationPath, {
|
|
552
|
-
dereference: true,
|
|
553
|
-
force: true,
|
|
554
|
-
preserveTimestamps: true,
|
|
555
|
-
recursive: true,
|
|
556
|
-
});
|
|
557
|
-
}
|
|
558
|
-
}
|
|
559
|
-
|
|
560
|
-
/**
|
|
561
|
-
* Snapshot uncommitted work in a reused worktree to a recovery artifact BEFORE
|
|
562
|
-
* discarding it, so the data is never silently lost. Captures tracked changes
|
|
563
|
-
* (git diff HEAD) and inlines untracked file contents so the work can be
|
|
564
|
-
* recovered via `git apply` / manual restore. Best-effort: a snapshot failure
|
|
565
|
-
* only logs (it must not block the clean-slate reuse flow).
|
|
566
|
-
*/
|
|
567
|
-
function snapshotDirtyWorktree(manifest: TeamRunManifest, task: TeamTaskState, worktreePath: string, dirtyStatus: string): boolean {
|
|
568
|
-
try {
|
|
569
|
-
const parts: string[] = [
|
|
570
|
-
`# Worktree recovery snapshot`,
|
|
571
|
-
`runId: ${manifest.runId} taskId: ${task.id} path: ${worktreePath}`,
|
|
572
|
-
`capturedAt: ${new Date().toISOString()}`,
|
|
573
|
-
"",
|
|
574
|
-
];
|
|
575
|
-
let trackedDiff = "";
|
|
576
|
-
try {
|
|
577
|
-
trackedDiff = git(worktreePath, ["diff", "HEAD"]);
|
|
578
|
-
} catch {
|
|
579
|
-
trackedDiff = "";
|
|
580
|
-
}
|
|
581
|
-
if (trackedDiff.trim()) {
|
|
582
|
-
parts.push("## Tracked changes (`git diff HEAD`)", "```diff", trackedDiff, "```", "");
|
|
583
|
-
}
|
|
584
|
-
for (const line of dirtyStatus.split("\n")) {
|
|
585
|
-
if (!line.startsWith("?? ")) continue;
|
|
586
|
-
// Strip the "?? " prefix and surrounding git quotes.
|
|
587
|
-
const rel = line.slice(3).replace(/^"|"$/g, "");
|
|
588
|
-
if (!rel) continue;
|
|
589
|
-
try {
|
|
590
|
-
const abs = path.join(worktreePath, rel);
|
|
591
|
-
if (!fs.existsSync(abs) || fs.statSync(abs).isDirectory()) continue;
|
|
592
|
-
const content = fs.readFileSync(abs, "utf-8");
|
|
593
|
-
parts.push(`## Untracked file: ${rel}`, "```", content, "```", "");
|
|
594
|
-
} catch {
|
|
595
|
-
/* skip unreadable/unstat-able entry */
|
|
596
|
-
}
|
|
597
|
-
}
|
|
598
|
-
writeArtifact(manifest.artifactsRoot, {
|
|
599
|
-
kind: "diff",
|
|
600
|
-
relativePath: `worktree-recovery/${task.id}-${Date.now()}.md`,
|
|
601
|
-
content: parts.join("\n"),
|
|
602
|
-
producer: "worktree-manager.snapshotDirtyWorktree",
|
|
603
|
-
retention: "run",
|
|
604
|
-
});
|
|
605
|
-
return true;
|
|
606
|
-
} catch (err) {
|
|
607
|
-
logInternalError(
|
|
608
|
-
"worktree.recovery.snapshotFailed",
|
|
609
|
-
err instanceof Error ? err : new Error(String(err)),
|
|
610
|
-
`runId=${manifest.runId}, taskId=${task.id}`,
|
|
611
|
-
);
|
|
612
|
-
return false;
|
|
613
|
-
}
|
|
614
|
-
}
|
|
615
|
-
|
|
616
|
-
/**
|
|
617
|
-
* Best-effort removal of a just-created worktree + its branch. Used when a
|
|
618
|
-
* post-creation step (setup hook, node_modules link, seed overlay) fails, so
|
|
619
|
-
* the run does not leak an orphaned worktree dir + branch that would block the
|
|
620
|
-
* next run with an "already checked out" error.
|
|
621
|
-
*/
|
|
622
|
-
function cleanupCreatedWorktree(repoRoot: string, worktreePath: string, branch: string): void {
|
|
623
|
-
try {
|
|
624
|
-
git(repoRoot, ["worktree", "remove", "--force", worktreePath]);
|
|
625
|
-
} catch {
|
|
626
|
-
try {
|
|
627
|
-
if (fs.existsSync(worktreePath)) fs.rmSync(worktreePath, { recursive: true, force: true });
|
|
628
|
-
} catch {
|
|
629
|
-
/* best-effort */
|
|
630
|
-
}
|
|
631
|
-
}
|
|
632
|
-
try {
|
|
633
|
-
git(repoRoot, ["branch", "-D", branch]);
|
|
634
|
-
} catch {
|
|
635
|
-
/* best-effort */
|
|
636
|
-
}
|
|
637
|
-
}
|
|
638
|
-
|
|
639
|
-
async function cleanupCreatedWorktreeAsync(repoRoot: string, worktreePath: string, branch: string): Promise<void> {
|
|
640
|
-
try {
|
|
641
|
-
await gitAsync(repoRoot, ["worktree", "remove", "--force", worktreePath]);
|
|
642
|
-
} catch {
|
|
643
|
-
try {
|
|
644
|
-
if (fs.existsSync(worktreePath)) fs.rmSync(worktreePath, { recursive: true, force: true });
|
|
645
|
-
} catch {
|
|
646
|
-
/* best-effort */
|
|
647
|
-
}
|
|
648
|
-
}
|
|
649
|
-
try {
|
|
650
|
-
await gitAsync(repoRoot, ["branch", "-D", branch]);
|
|
651
|
-
} catch {
|
|
652
|
-
/* best-effort */
|
|
653
|
-
}
|
|
654
|
-
}
|
|
655
|
-
|
|
656
|
-
export function prepareTaskWorkspace(manifest: TeamRunManifest, task: TeamTaskState, stepSeedPaths?: string[]): PreparedTaskWorkspace {
|
|
657
|
-
if (manifest.workspaceMode !== "worktree") return { cwd: task.cwd };
|
|
658
|
-
const repoRoot = findGitRoot(manifest.cwd);
|
|
659
|
-
const loadedConfig = loadConfig(manifest.cwd);
|
|
660
|
-
if (loadedConfig.config.requireCleanWorktreeLeader !== false) assertCleanLeader(repoRoot);
|
|
661
|
-
const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
|
|
662
|
-
const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
|
|
663
|
-
fs.mkdirSync(worktreeRoot, { recursive: true });
|
|
664
|
-
// Resolve through realpathSync.native to get long-name form on Windows.
|
|
665
|
-
// git worktree uses long-name paths, so we must match. If .native fails,
|
|
666
|
-
// fall back to non-native (preserves input form).
|
|
667
|
-
let resolvedWorktreeRoot = worktreeRoot;
|
|
668
|
-
try {
|
|
669
|
-
const r = fs.realpathSync.native(worktreeRoot);
|
|
670
|
-
resolvedWorktreeRoot = r.startsWith("\\\\?\\") ? r.slice(4) : r;
|
|
671
|
-
} catch {
|
|
672
|
-
try {
|
|
673
|
-
resolvedWorktreeRoot = fs.realpathSync(worktreeRoot);
|
|
674
|
-
} catch {
|
|
675
|
-
/* keep as-is */
|
|
676
|
-
}
|
|
677
|
-
}
|
|
678
|
-
const sanitizedTaskId = sanitizeBranchPart(task.id);
|
|
679
|
-
const worktreePath = path.join(resolvedWorktreeRoot, sanitizedTaskId);
|
|
680
|
-
const branch = `pi-crew/${sanitizeBranchPart(manifest.runId)}/${sanitizeBranchPart(task.id)}`;
|
|
681
|
-
// Use `git worktree list --porcelain` to atomically verify the worktree exists.
|
|
682
|
-
// This avoids a TOCTOU race between fs.existsSync and git branch verification.
|
|
683
|
-
let worktreeExists = false;
|
|
684
|
-
try {
|
|
685
|
-
const worktreeList = git(repoRoot, ["worktree", "list", "--porcelain"]);
|
|
686
|
-
// `git worktree list --porcelain` outputs "worktree /path" per entry.
|
|
687
|
-
// We must compare against the path part (after "worktree ").
|
|
688
|
-
// On Windows, git may return forward-slash long-name paths while
|
|
689
|
-
// worktreePath uses short-name backslash form. Resolve both through
|
|
690
|
-
// realpathSync.native (which always returns long-name on Windows)
|
|
691
|
-
// for consistent comparison.
|
|
692
|
-
const normalizedWtPath =
|
|
693
|
-
process.platform === "win32"
|
|
694
|
-
? (() => {
|
|
695
|
-
try {
|
|
696
|
-
const r = fs.realpathSync.native(worktreePath);
|
|
697
|
-
return r.startsWith("\\\\?\\") ? r.slice(4) : r;
|
|
698
|
-
} catch {
|
|
699
|
-
return worktreePath;
|
|
700
|
-
}
|
|
701
|
-
})()
|
|
702
|
-
.replace(/\\/g, "/")
|
|
703
|
-
.toLowerCase()
|
|
704
|
-
: worktreePath;
|
|
705
|
-
worktreeExists = worktreeList.split("\n").some((line) => {
|
|
706
|
-
const trimmed = line.trim();
|
|
707
|
-
const matchPath = trimmed.startsWith("worktree ") ? trimmed.slice(9) : trimmed;
|
|
708
|
-
if (process.platform === "win32") {
|
|
709
|
-
return matchPath.replace(/\\/g, "/").toLowerCase() === normalizedWtPath;
|
|
710
|
-
}
|
|
711
|
-
return matchPath === worktreePath;
|
|
712
|
-
});
|
|
713
|
-
} catch {
|
|
714
|
-
worktreeExists = false;
|
|
715
|
-
}
|
|
716
|
-
if (worktreeExists) {
|
|
717
|
-
let currentBranch: string;
|
|
718
|
-
try {
|
|
719
|
-
currentBranch = git(worktreePath, ["rev-parse", "--abbrev-ref", "HEAD"]);
|
|
720
|
-
} catch (gitError) {
|
|
721
|
-
throw new Error(
|
|
722
|
-
`Existing worktree at ${worktreePath} is not a valid git repository; cannot verify branch: ${gitError instanceof Error ? gitError.message : String(gitError)}`,
|
|
723
|
-
);
|
|
724
|
-
}
|
|
725
|
-
if (currentBranch !== branch) {
|
|
726
|
-
throw new Error(`Existing worktree branch mismatch at ${worktreePath}: expected '${branch}', got '${currentBranch}'.`);
|
|
727
|
-
}
|
|
728
|
-
// Check for uncommitted changes from previous run before reusing
|
|
729
|
-
const dirtyStatus = git(worktreePath, ["status", "--porcelain"]);
|
|
730
|
-
if (dirtyStatus.trim()) {
|
|
731
|
-
// Snapshot uncommitted work to a recovery artifact BEFORE discarding, so the
|
|
732
|
-
// previous run's changes are never silently destroyed on reuse.
|
|
733
|
-
const snapshotOk = snapshotDirtyWorktree(manifest, task, worktreePath, dirtyStatus);
|
|
734
|
-
if (snapshotOk) {
|
|
735
|
-
logInternalError(
|
|
736
|
-
"worktree.reused.dirty",
|
|
737
|
-
new Error(`Discarding uncommitted changes in reused worktree at ${worktreePath} (snapshot saved to artifacts)`),
|
|
738
|
-
`runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
|
|
739
|
-
);
|
|
740
|
-
git(worktreePath, ["checkout", "--", "."]);
|
|
741
|
-
git(worktreePath, ["clean", "-fd"]);
|
|
742
|
-
} else {
|
|
743
|
-
logInternalError(
|
|
744
|
-
"worktree.reused.dirtyPreserved",
|
|
745
|
-
new Error(
|
|
746
|
-
`Snapshot failed — preserving dirty worktree at ${worktreePath} (skipping git checkout/clean to prevent data loss)`,
|
|
747
|
-
),
|
|
748
|
-
`runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
|
|
749
|
-
);
|
|
750
|
-
}
|
|
751
|
-
}
|
|
752
|
-
// Overlay seed paths from config + step-level seedPaths (reused worktree)
|
|
753
|
-
const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
|
|
754
|
-
const mergedReused = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
|
|
755
|
-
if (mergedReused.length > 0) {
|
|
756
|
-
overlaySeedPaths(repoRoot, worktreePath, mergedReused);
|
|
757
|
-
}
|
|
758
|
-
// Re-validate leader is still clean before reusing — leader state may have changed since first preparation
|
|
759
|
-
assertCleanLeader(repoRoot);
|
|
760
|
-
return { cwd: worktreePath, worktreePath, branch, reused: true };
|
|
761
|
-
}
|
|
762
|
-
pruneStaleWorktrees(repoRoot);
|
|
763
|
-
const exists = branchExists(repoRoot, branch);
|
|
764
|
-
let worktreeCreated = false;
|
|
765
|
-
try {
|
|
766
|
-
if (exists.local) {
|
|
767
|
-
git(repoRoot, ["worktree", "add", worktreePath, branch]);
|
|
768
|
-
} else {
|
|
769
|
-
if (exists.remoteOnly) {
|
|
770
|
-
logInternalError(
|
|
771
|
-
"worktree.branchRemoteOnly",
|
|
772
|
-
new Error(`Branch '${branch}' exists only on remote; creating local from HEAD instead of tracking remote.`),
|
|
773
|
-
`branch=${branch}`,
|
|
774
|
-
);
|
|
775
|
-
}
|
|
776
|
-
git(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
|
|
777
|
-
}
|
|
778
|
-
worktreeCreated = true;
|
|
779
|
-
} catch (error) {
|
|
780
|
-
// Clean up orphaned worktree directory if git worktree add failed
|
|
781
|
-
if (fs.existsSync(worktreePath)) {
|
|
782
|
-
try {
|
|
783
|
-
fs.rmSync(worktreePath, { recursive: true, force: true });
|
|
784
|
-
} catch {
|
|
785
|
-
/* best-effort cleanup */
|
|
786
|
-
}
|
|
787
|
-
}
|
|
788
|
-
const msg = error instanceof Error ? error.message : String(error);
|
|
789
|
-
if (/already checked out|is already used by worktree/i.test(msg)) {
|
|
790
|
-
throw new Error(
|
|
791
|
-
`Branch '${branch}' is checked out at another worktree. Run \`team cleanup runId=${manifest.runId} force=true\` or manually remove the conflicting worktree.`,
|
|
792
|
-
);
|
|
793
|
-
}
|
|
794
|
-
throw error;
|
|
795
|
-
}
|
|
796
|
-
try {
|
|
797
|
-
const syntheticPaths = runSetupHook(manifest, task, repoRoot, worktreePath, branch);
|
|
798
|
-
const nodeModulesLinked =
|
|
799
|
-
loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
|
|
800
|
-
// Overlay seed paths from config + step-level seedPaths
|
|
801
|
-
const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
|
|
802
|
-
const merged = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
|
|
803
|
-
if (merged.length > 0) {
|
|
804
|
-
overlaySeedPaths(repoRoot, worktreePath, merged);
|
|
805
|
-
}
|
|
806
|
-
return {
|
|
807
|
-
cwd: worktreePath,
|
|
808
|
-
worktreePath,
|
|
809
|
-
branch,
|
|
810
|
-
reused: false,
|
|
811
|
-
nodeModulesLinked,
|
|
812
|
-
syntheticPaths,
|
|
813
|
-
};
|
|
814
|
-
} catch (setupError) {
|
|
815
|
-
// Hook/link/seed failure AFTER worktree+branch creation: clean up to avoid
|
|
816
|
-
// an orphaned worktree dir + branch that would block the next run.
|
|
817
|
-
cleanupCreatedWorktree(repoRoot, worktreePath, branch);
|
|
818
|
-
throw setupError;
|
|
819
|
-
}
|
|
820
|
-
}
|
|
821
|
-
|
|
822
|
-
/** Async version of prepareTaskWorkspace — yields the event loop during git operations. */
|
|
823
|
-
export async function prepareTaskWorkspaceAsync(
|
|
824
|
-
manifest: TeamRunManifest,
|
|
825
|
-
task: TeamTaskState,
|
|
826
|
-
stepSeedPaths?: string[],
|
|
827
|
-
): Promise<PreparedTaskWorkspace> {
|
|
828
|
-
if (manifest.workspaceMode !== "worktree") return { cwd: task.cwd };
|
|
829
|
-
const repoRoot = await findGitRootAsync(manifest.cwd);
|
|
830
|
-
const loadedConfig = loadConfig(manifest.cwd);
|
|
831
|
-
if (loadedConfig.config.requireCleanWorktreeLeader !== false) await assertCleanLeaderAsync(repoRoot);
|
|
832
|
-
const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
|
|
833
|
-
const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
|
|
834
|
-
fs.mkdirSync(worktreeRoot, { recursive: true });
|
|
835
|
-
let resolvedWorktreeRoot = worktreeRoot;
|
|
836
|
-
try {
|
|
837
|
-
const r = fs.realpathSync.native(worktreeRoot);
|
|
838
|
-
resolvedWorktreeRoot = r.startsWith("\\\\?\\") ? r.slice(4) : r;
|
|
839
|
-
} catch {
|
|
840
|
-
try {
|
|
841
|
-
resolvedWorktreeRoot = fs.realpathSync(worktreeRoot);
|
|
842
|
-
} catch {
|
|
843
|
-
/* keep as-is */
|
|
844
|
-
}
|
|
845
|
-
}
|
|
846
|
-
const sanitizedTaskId = sanitizeBranchPart(task.id);
|
|
847
|
-
const worktreePath = path.join(resolvedWorktreeRoot, sanitizedTaskId);
|
|
848
|
-
const branch = `pi-crew/${sanitizeBranchPart(manifest.runId)}/${sanitizeBranchPart(task.id)}`;
|
|
849
|
-
let worktreeExists = false;
|
|
850
|
-
try {
|
|
851
|
-
const worktreeList = await gitAsync(repoRoot, ["worktree", "list", "--porcelain"]);
|
|
852
|
-
const normalizedWtPath =
|
|
853
|
-
process.platform === "win32"
|
|
854
|
-
? (() => {
|
|
855
|
-
try {
|
|
856
|
-
const r = fs.realpathSync.native(worktreePath);
|
|
857
|
-
return r.startsWith("\\\\?\\") ? r.slice(4) : r;
|
|
858
|
-
} catch {
|
|
859
|
-
return worktreePath;
|
|
860
|
-
}
|
|
861
|
-
})()
|
|
862
|
-
.replace(/\\/g, "/")
|
|
863
|
-
.toLowerCase()
|
|
864
|
-
: worktreePath;
|
|
865
|
-
worktreeExists = worktreeList.split("\n").some((line) => {
|
|
866
|
-
const trimmed = line.trim();
|
|
867
|
-
const matchPath = trimmed.startsWith("worktree ") ? trimmed.slice(9) : trimmed;
|
|
868
|
-
if (process.platform === "win32") {
|
|
869
|
-
return matchPath.replace(/\\/g, "/").toLowerCase() === normalizedWtPath;
|
|
870
|
-
}
|
|
871
|
-
return matchPath === worktreePath;
|
|
872
|
-
});
|
|
873
|
-
} catch {
|
|
874
|
-
worktreeExists = false;
|
|
875
|
-
}
|
|
876
|
-
if (worktreeExists) {
|
|
877
|
-
let currentBranch: string;
|
|
878
|
-
try {
|
|
879
|
-
currentBranch = await gitAsync(worktreePath, ["rev-parse", "--abbrev-ref", "HEAD"]);
|
|
880
|
-
} catch (gitError) {
|
|
881
|
-
throw new Error(
|
|
882
|
-
`Existing worktree at ${worktreePath} is not a valid git repository; cannot verify branch: ${gitError instanceof Error ? gitError.message : String(gitError)}`,
|
|
883
|
-
);
|
|
884
|
-
}
|
|
885
|
-
if (currentBranch !== branch) {
|
|
886
|
-
throw new Error(`Existing worktree branch mismatch at ${worktreePath}: expected '${branch}', got '${currentBranch}'.`);
|
|
887
|
-
}
|
|
888
|
-
const dirtyStatus = await gitAsync(worktreePath, ["status", "--porcelain"]);
|
|
889
|
-
if (dirtyStatus.trim()) {
|
|
890
|
-
const snapshotOk = snapshotDirtyWorktree(manifest, task, worktreePath, dirtyStatus);
|
|
891
|
-
if (snapshotOk) {
|
|
892
|
-
logInternalError(
|
|
893
|
-
"worktree.reused.dirty",
|
|
894
|
-
new Error(`Discarding uncommitted changes in reused worktree at ${worktreePath} (snapshot saved to artifacts)`),
|
|
895
|
-
`runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
|
|
896
|
-
);
|
|
897
|
-
await gitAsync(worktreePath, ["checkout", "--", "."]);
|
|
898
|
-
await gitAsync(worktreePath, ["clean", "-fd"]);
|
|
899
|
-
} else {
|
|
900
|
-
logInternalError(
|
|
901
|
-
"worktree.reused.dirtyPreserved",
|
|
902
|
-
new Error(
|
|
903
|
-
`Snapshot failed — preserving dirty worktree at ${worktreePath} (skipping git checkout/clean to prevent data loss)`,
|
|
904
|
-
),
|
|
905
|
-
`runId=${manifest.runId}, taskId=${task.id}, dirtyStatus=${dirtyStatus.trim()}`,
|
|
906
|
-
);
|
|
907
|
-
}
|
|
908
|
-
}
|
|
909
|
-
const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
|
|
910
|
-
const mergedReused = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
|
|
911
|
-
if (mergedReused.length > 0) {
|
|
912
|
-
overlaySeedPaths(repoRoot, worktreePath, mergedReused);
|
|
913
|
-
}
|
|
914
|
-
// Re-validate leader is still clean before reusing
|
|
915
|
-
// Note: this intentionally skips the cache to re-check the live state.
|
|
916
|
-
_cleanLeaderCache.delete(repoRoot);
|
|
917
|
-
await assertCleanLeaderAsync(repoRoot);
|
|
918
|
-
return { cwd: worktreePath, worktreePath, branch, reused: true };
|
|
919
|
-
}
|
|
920
|
-
await pruneStaleWorktreesAsync(repoRoot);
|
|
921
|
-
const exists = await branchExistsAsync(repoRoot, branch);
|
|
922
|
-
let worktreeCreated = false;
|
|
923
|
-
try {
|
|
924
|
-
if (exists.local) {
|
|
925
|
-
await gitAsync(repoRoot, ["worktree", "add", worktreePath, branch]);
|
|
926
|
-
} else {
|
|
927
|
-
if (exists.remoteOnly) {
|
|
928
|
-
logInternalError(
|
|
929
|
-
"worktree.branchRemoteOnly",
|
|
930
|
-
new Error(`Branch '${branch}' exists only on remote; creating local from HEAD instead of tracking remote.`),
|
|
931
|
-
`branch=${branch}`,
|
|
932
|
-
);
|
|
933
|
-
}
|
|
934
|
-
await gitAsync(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
|
|
935
|
-
}
|
|
936
|
-
worktreeCreated = true;
|
|
937
|
-
} catch (error) {
|
|
938
|
-
if (fs.existsSync(worktreePath)) {
|
|
939
|
-
try {
|
|
940
|
-
fs.rmSync(worktreePath, { recursive: true, force: true });
|
|
941
|
-
} catch {
|
|
942
|
-
/* best-effort cleanup */
|
|
943
|
-
}
|
|
944
|
-
}
|
|
945
|
-
const msg = error instanceof Error ? error.message : String(error);
|
|
946
|
-
if (/already checked out|is already used by worktree/i.test(msg)) {
|
|
947
|
-
throw new Error(
|
|
948
|
-
`Branch '${branch}' is checked out at another worktree. Run \`team cleanup runId=${manifest.runId} force=true\` or manually remove the conflicting worktree.`,
|
|
949
|
-
);
|
|
950
|
-
}
|
|
951
|
-
throw error;
|
|
952
|
-
}
|
|
953
|
-
try {
|
|
954
|
-
const syntheticPaths = runSetupHook(manifest, task, repoRoot, worktreePath, branch);
|
|
955
|
-
const nodeModulesLinked =
|
|
956
|
-
loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
|
|
957
|
-
const globalSeedPaths = loadedConfig.config.worktree?.seedPaths ?? [];
|
|
958
|
-
const merged = normalizeSeedPaths([...globalSeedPaths, ...(stepSeedPaths ?? [])], repoRoot);
|
|
959
|
-
if (merged.length > 0) {
|
|
960
|
-
overlaySeedPaths(repoRoot, worktreePath, merged);
|
|
961
|
-
}
|
|
962
|
-
return {
|
|
963
|
-
cwd: worktreePath,
|
|
964
|
-
worktreePath,
|
|
965
|
-
branch,
|
|
966
|
-
reused: false,
|
|
967
|
-
nodeModulesLinked,
|
|
968
|
-
syntheticPaths,
|
|
969
|
-
};
|
|
970
|
-
} catch (setupError) {
|
|
971
|
-
// Hook/link/seed failure AFTER worktree+branch creation: clean up to avoid
|
|
972
|
-
// an orphaned worktree dir + branch that would block the next run.
|
|
973
|
-
await cleanupCreatedWorktreeAsync(repoRoot, worktreePath, branch);
|
|
974
|
-
throw setupError;
|
|
975
|
-
}
|
|
976
|
-
}
|
|
977
|
-
|
|
978
|
-
export function captureWorktreeDiffStat(worktreePath: string): WorktreeDiffStat {
|
|
979
|
-
try {
|
|
980
|
-
const diffStat = git(worktreePath, ["diff", "--stat"]);
|
|
981
|
-
const numstat = git(worktreePath, ["diff", "--numstat"]);
|
|
982
|
-
let filesChanged = 0;
|
|
983
|
-
let insertions = 0;
|
|
984
|
-
let deletions = 0;
|
|
985
|
-
for (const line of numstat.split(/\r?\n/).filter(Boolean)) {
|
|
986
|
-
const [add, del] = line.split(/\s+/);
|
|
987
|
-
filesChanged += 1;
|
|
988
|
-
insertions += Number(add) || 0;
|
|
989
|
-
deletions += Number(del) || 0;
|
|
990
|
-
}
|
|
991
|
-
return { filesChanged, insertions, deletions, diffStat };
|
|
992
|
-
} catch {
|
|
993
|
-
return { filesChanged: 0, insertions: 0, deletions: 0, diffStat: "" };
|
|
994
|
-
}
|
|
995
|
-
}
|
|
996
|
-
|
|
997
|
-
export async function captureWorktreeDiffStatAsync(worktreePath: string): Promise<WorktreeDiffStat> {
|
|
998
|
-
try {
|
|
999
|
-
const diffStat = await gitAsync(worktreePath, ["diff", "--stat"]);
|
|
1000
|
-
const numstat = await gitAsync(worktreePath, ["diff", "--numstat"]);
|
|
1001
|
-
let filesChanged = 0;
|
|
1002
|
-
let insertions = 0;
|
|
1003
|
-
let deletions = 0;
|
|
1004
|
-
for (const line of numstat.split(/\r?\n/).filter(Boolean)) {
|
|
1005
|
-
const [add, del] = line.split(/\s+/);
|
|
1006
|
-
filesChanged += 1;
|
|
1007
|
-
insertions += Number(add) || 0;
|
|
1008
|
-
deletions += Number(del) || 0;
|
|
1009
|
-
}
|
|
1010
|
-
return { filesChanged, insertions, deletions, diffStat };
|
|
1011
|
-
} catch {
|
|
1012
|
-
return { filesChanged: 0, insertions: 0, deletions: 0, diffStat: "" };
|
|
1013
|
-
}
|
|
1014
|
-
}
|
|
1015
|
-
|
|
1016
|
-
export function captureWorktreeDiff(worktreePath: string): string {
|
|
1017
|
-
try {
|
|
1018
|
-
return git(worktreePath, ["diff", "--stat"]) + "\n\n" + git(worktreePath, ["diff"]);
|
|
1019
|
-
} catch (error) {
|
|
1020
|
-
const message = error instanceof Error ? error.message : String(error);
|
|
1021
|
-
return `Failed to capture worktree diff: ${message}`;
|
|
1022
|
-
}
|
|
1023
|
-
}
|
|
1024
|
-
|
|
1025
|
-
export async function captureWorktreeDiffAsync(worktreePath: string): Promise<string> {
|
|
1026
|
-
try {
|
|
1027
|
-
const [stat, full] = await Promise.all([gitAsync(worktreePath, ["diff", "--stat"]), gitAsync(worktreePath, ["diff"])]);
|
|
1028
|
-
return stat + "\n\n" + full;
|
|
1029
|
-
} catch (error) {
|
|
1030
|
-
const message = error instanceof Error ? error.message : String(error);
|
|
1031
|
-
return `Failed to capture worktree diff: ${message}`;
|
|
1032
|
-
}
|
|
1033
|
-
}
|
|
1034
|
-
|
|
1035
|
-
/**
|
|
1036
|
-
* round-17 P2-4: Create an isolated git worktree for a single DWF agent call.
|
|
1037
|
-
*
|
|
1038
|
-
* Lightweight — does NOT require a TeamTaskState and does NOT depend on
|
|
1039
|
-
* `manifest.workspaceMode === "worktree"` (DWF manifests use `single`). It
|
|
1040
|
-
* reuses the same internal helpers as `prepareTaskWorkspace` (git, findGitRoot,
|
|
1041
|
-
* assertCleanLeader, pruneStaleWorktrees, sanitizeBranchPart,
|
|
1042
|
-
* linkNodeModulesIfPresent) but with a minimal, task-free signature.
|
|
1043
|
-
*
|
|
1044
|
-
* Returns `undefined` when worktree creation is unavailable (no git repo, dirty
|
|
1045
|
-
* leader, git error) so the caller (`ctx.agent`) can fall back gracefully.
|
|
1046
|
-
*/
|
|
1047
|
-
export function prepareAgentWorktree(manifest: TeamRunManifest, agentId: string): PreparedTaskWorkspace | undefined {
|
|
1048
|
-
try {
|
|
1049
|
-
const repoRoot = findGitRoot(manifest.cwd);
|
|
1050
|
-
const loadedConfig = loadConfig(manifest.cwd);
|
|
1051
|
-
if (loadedConfig.config.requireCleanWorktreeLeader !== false) assertCleanLeader(repoRoot);
|
|
1052
|
-
const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
|
|
1053
|
-
const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
|
|
1054
|
-
fs.mkdirSync(worktreeRoot, { recursive: true });
|
|
1055
|
-
const sanitizedAgentId = sanitizeBranchPart(agentId);
|
|
1056
|
-
const worktreePath = path.join(worktreeRoot, sanitizedAgentId);
|
|
1057
|
-
const branch = `pi-crew/${sanitizedRunId}/${sanitizedAgentId}`;
|
|
1058
|
-
pruneStaleWorktrees(repoRoot);
|
|
1059
|
-
git(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
|
|
1060
|
-
const nodeModulesLinked =
|
|
1061
|
-
loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
|
|
1062
|
-
return { cwd: worktreePath, worktreePath, branch, nodeModulesLinked };
|
|
1063
|
-
} catch {
|
|
1064
|
-
// Graceful fallback: no git repo, dirty leader, or git error → run normally.
|
|
1065
|
-
return undefined;
|
|
1066
|
-
}
|
|
1067
|
-
}
|
|
1068
|
-
|
|
1069
|
-
/** Async version of prepareAgentWorktree — yields the event loop during git operations. */
|
|
1070
|
-
export async function prepareAgentWorktreeAsync(manifest: TeamRunManifest, agentId: string): Promise<PreparedTaskWorkspace | undefined> {
|
|
1071
|
-
try {
|
|
1072
|
-
const repoRoot = await findGitRootAsync(manifest.cwd);
|
|
1073
|
-
const loadedConfig = loadConfig(manifest.cwd);
|
|
1074
|
-
if (loadedConfig.config.requireCleanWorktreeLeader !== false) await assertCleanLeaderAsync(repoRoot);
|
|
1075
|
-
const sanitizedRunId = manifest.runId.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/^-+|-+$/g, "") || "run";
|
|
1076
|
-
const worktreeRoot = path.join(projectCrewRoot(manifest.cwd), DEFAULT_PATHS.state.worktreesSubdir, sanitizedRunId);
|
|
1077
|
-
fs.mkdirSync(worktreeRoot, { recursive: true });
|
|
1078
|
-
const sanitizedAgentId = sanitizeBranchPart(agentId);
|
|
1079
|
-
const worktreePath = path.join(worktreeRoot, sanitizedAgentId);
|
|
1080
|
-
const branch = `pi-crew/${sanitizedRunId}/${sanitizedAgentId}`;
|
|
1081
|
-
await pruneStaleWorktreesAsync(repoRoot);
|
|
1082
|
-
await gitAsync(repoRoot, ["worktree", "add", "-b", branch, worktreePath, "HEAD"]);
|
|
1083
|
-
const nodeModulesLinked =
|
|
1084
|
-
loadedConfig.config.worktree?.linkNodeModules === true ? linkNodeModulesIfPresent(repoRoot, worktreePath) : false;
|
|
1085
|
-
return { cwd: worktreePath, worktreePath, branch, nodeModulesLinked };
|
|
1086
|
-
} catch {
|
|
1087
|
-
// Graceful fallback: no git repo, dirty leader, or git error → run normally.
|
|
1088
|
-
return undefined;
|
|
1089
|
-
}
|
|
1090
|
-
}
|
|
1091
|
-
|
|
1092
|
-
/**
|
|
1093
|
-
* round-17 P2-4: Remove a DWF agent worktree after the agent completes.
|
|
1094
|
-
*
|
|
1095
|
-
* Captures the worktree diff as an artifact before removal (best-effort), then
|
|
1096
|
-
* removes the worktree, deletes the ephemeral branch, and prunes stale refs.
|
|
1097
|
-
* NEVER throws — cleanup failures are logged via `logInternalError` so a
|
|
1098
|
-
* worktree/branch leak never crashes a workflow.
|
|
1099
|
-
*/
|
|
1100
|
-
export function cleanupAgentWorktree(manifest: TeamRunManifest, worktreePath: string, branch?: string): void {
|
|
1101
|
-
// Capture diff as artifact (best-effort).
|
|
1102
|
-
try {
|
|
1103
|
-
const diff = captureWorktreeDiff(worktreePath);
|
|
1104
|
-
if (diff.trim() && !diff.startsWith("Failed to capture worktree diff")) {
|
|
1105
|
-
writeArtifact(manifest.artifactsRoot, {
|
|
1106
|
-
kind: "diff",
|
|
1107
|
-
relativePath: `wf/worktree-diff-${Date.now()}-${randomBytes(2).toString("hex")}.diff`,
|
|
1108
|
-
content: diff,
|
|
1109
|
-
producer: "dynamic-workflow",
|
|
1110
|
-
});
|
|
1111
|
-
}
|
|
1112
|
-
} catch (error) {
|
|
1113
|
-
logInternalError("worktree.agent-cleanup.diff", error, `worktreePath=${worktreePath}`);
|
|
1114
|
-
}
|
|
1115
|
-
// Remove worktree (best-effort). Try git first, then fall back to fs.rm.
|
|
1116
|
-
try {
|
|
1117
|
-
const repoRoot = findGitRoot(manifest.cwd);
|
|
1118
|
-
git(repoRoot, ["worktree", "remove", "--force", worktreePath]);
|
|
1119
|
-
} catch (error) {
|
|
1120
|
-
logInternalError("worktree.agent-cleanup.remove", error, `worktreePath=${worktreePath}`);
|
|
1121
|
-
try {
|
|
1122
|
-
fs.rmSync(worktreePath, { recursive: true, force: true });
|
|
1123
|
-
} catch (rmError) {
|
|
1124
|
-
logInternalError("worktree.agent-cleanup.rm", rmError, `worktreePath=${worktreePath}`);
|
|
1125
|
-
}
|
|
1126
|
-
}
|
|
1127
|
-
// Delete the ephemeral agent branch (best-effort) to avoid accumulation across
|
|
1128
|
-
// many agent calls. The diff is already captured above; the branch holds no value.
|
|
1129
|
-
if (branch) {
|
|
1130
|
-
try {
|
|
1131
|
-
const repoRoot = findGitRoot(manifest.cwd);
|
|
1132
|
-
git(repoRoot, ["branch", "-D", branch]);
|
|
1133
|
-
} catch (error) {
|
|
1134
|
-
logInternalError("worktree.agent-cleanup.branch", error, `branch=${branch}`);
|
|
1135
|
-
}
|
|
1136
|
-
}
|
|
1137
|
-
// Prune stale worktree refs (best-effort).
|
|
1138
|
-
try {
|
|
1139
|
-
const repoRoot = findGitRoot(manifest.cwd);
|
|
1140
|
-
git(repoRoot, ["worktree", "prune"]);
|
|
1141
|
-
} catch (error) {
|
|
1142
|
-
logInternalError("worktree.agent-cleanup.prune", error, `worktreePath=${worktreePath}`);
|
|
1143
|
-
}
|
|
1144
|
-
}
|
|
1145
|
-
|
|
1146
|
-
/** Async version of cleanupAgentWorktree — caches findGitRoot and yields during git operations. */
|
|
1147
|
-
export async function cleanupAgentWorktreeAsync(manifest: TeamRunManifest, worktreePath: string, branch?: string): Promise<void> {
|
|
1148
|
-
// Capture diff as artifact (best-effort).
|
|
1149
|
-
try {
|
|
1150
|
-
const diff = await captureWorktreeDiffAsync(worktreePath);
|
|
1151
|
-
if (diff.trim() && !diff.startsWith("Failed to capture worktree diff")) {
|
|
1152
|
-
writeArtifact(manifest.artifactsRoot, {
|
|
1153
|
-
kind: "diff",
|
|
1154
|
-
relativePath: `wf/worktree-diff-${Date.now()}-${randomBytes(2).toString("hex")}.diff`,
|
|
1155
|
-
content: diff,
|
|
1156
|
-
producer: "dynamic-workflow",
|
|
1157
|
-
});
|
|
1158
|
-
}
|
|
1159
|
-
} catch (error) {
|
|
1160
|
-
logInternalError("worktree.agent-cleanup.diff", error, `worktreePath=${worktreePath}`);
|
|
1161
|
-
}
|
|
1162
|
-
// Resolve repoRoot once and reuse (cache optimization).
|
|
1163
|
-
let repoRoot: string | undefined;
|
|
1164
|
-
try {
|
|
1165
|
-
repoRoot = await findGitRootAsync(manifest.cwd);
|
|
1166
|
-
} catch {
|
|
1167
|
-
// Cannot resolve repoRoot — fall back to fs.rm for the worktree.
|
|
1168
|
-
try {
|
|
1169
|
-
fs.rmSync(worktreePath, { recursive: true, force: true });
|
|
1170
|
-
} catch (rmError) {
|
|
1171
|
-
logInternalError("worktree.agent-cleanup.rm", rmError, `worktreePath=${worktreePath}`);
|
|
1172
|
-
}
|
|
1173
|
-
return;
|
|
1174
|
-
}
|
|
1175
|
-
// Remove worktree (best-effort). Try git first, then fall back to fs.rm.
|
|
1176
|
-
try {
|
|
1177
|
-
await gitAsync(repoRoot, ["worktree", "remove", "--force", worktreePath]);
|
|
1178
|
-
} catch (error) {
|
|
1179
|
-
logInternalError("worktree.agent-cleanup.remove", error, `worktreePath=${worktreePath}`);
|
|
1180
|
-
try {
|
|
1181
|
-
fs.rmSync(worktreePath, { recursive: true, force: true });
|
|
1182
|
-
} catch (rmError) {
|
|
1183
|
-
logInternalError("worktree.agent-cleanup.rm", rmError, `worktreePath=${worktreePath}`);
|
|
1184
|
-
}
|
|
1185
|
-
}
|
|
1186
|
-
// Delete the ephemeral agent branch (best-effort).
|
|
1187
|
-
if (branch) {
|
|
1188
|
-
try {
|
|
1189
|
-
await gitAsync(repoRoot, ["branch", "-D", branch]);
|
|
1190
|
-
} catch (error) {
|
|
1191
|
-
logInternalError("worktree.agent-cleanup.branch", error, `branch=${branch}`);
|
|
1192
|
-
}
|
|
1193
|
-
}
|
|
1194
|
-
// Prune stale worktree refs (best-effort).
|
|
1195
|
-
try {
|
|
1196
|
-
await gitAsync(repoRoot, ["worktree", "prune"]);
|
|
1197
|
-
} catch (error) {
|
|
1198
|
-
logInternalError("worktree.agent-cleanup.prune", error, `worktreePath=${worktreePath}`);
|
|
1199
|
-
}
|
|
1200
|
-
}
|