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,443 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* workspace-lock.ts — Per-cwd workspace lock with startTime-safe liveness (P1g).
|
|
3
|
-
*
|
|
4
|
-
* RFC: research-findings/goal-workflow/13-VISION-RFC.md v0.5 §P1g + D10.
|
|
5
|
-
*
|
|
6
|
-
* Closes #8 (multi-goal clobber) and the B-2 PID-recycling gap. Each
|
|
7
|
-
* `workspaceMode:"single"` goal acquires this lock for its entire lifetime,
|
|
8
|
-
* serializing concurrent goals that share a cwd.
|
|
9
|
-
*
|
|
10
|
-
* Lockfile location: `<crewRoot>/state/workspace-locks/<sha256(absCwd)>.lock`
|
|
11
|
-
* Lockfile contents: { pid, startTime, heartbeat, goalId, acquiredAt }
|
|
12
|
-
*
|
|
13
|
-
* ─── LIVENESS = stale-reconciler startTime pattern (D10, B-2 fix) ───
|
|
14
|
-
* A lock is STALE iff EITHER:
|
|
15
|
-
* (a) the recorded pid's CURRENT startTime ≠ the lockfile startTime
|
|
16
|
-
* (the PID was recycled to a different process), OR
|
|
17
|
-
* (b) the heartbeat is older than HEARTBEAT_STALE_MS (default 60s)
|
|
18
|
-
* (the process crashed without exiting / heartbeat stopped).
|
|
19
|
-
*
|
|
20
|
-
* Why NOT child-pi.ts killProcessPid (B-2): killProcessPid uses
|
|
21
|
-
* process.kill(pid, 0) which is PID-only — vulnerable to PID recycling. The
|
|
22
|
-
* startTime + before/after re-verify pattern is TOCTOU-correct.
|
|
23
|
-
*
|
|
24
|
-
* getProcessStartTime is NOT exported from stale-reconciler.ts, so its logic
|
|
25
|
-
* is REPLICATED here (RFC §P1g explicitly permits importing OR replicating).
|
|
26
|
-
* The replication matches stale-reconciler.ts:112 field-for-field.
|
|
27
|
-
*
|
|
28
|
-
* Granularity: per-goal, held for the goal's lifetime (release() on goal end).
|
|
29
|
-
* Contention: default QUEUE (poll until released or stale);
|
|
30
|
-
* opts.failOnWorkspaceBusy:true → THROW instead of queue.
|
|
31
|
-
*/
|
|
32
|
-
|
|
33
|
-
import { createHash } from "node:crypto";
|
|
34
|
-
import { closeSync, existsSync, mkdirSync, openSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
|
|
35
|
-
import * as path from "node:path";
|
|
36
|
-
import { atomicWriteJson } from "../state/atomic-write.ts";
|
|
37
|
-
import { projectCrewRoot, userCrewRoot } from "../utils/paths.ts";
|
|
38
|
-
|
|
39
|
-
/** Heartbeat staleness threshold (ms). Default 60s per RFC §P1g. */
|
|
40
|
-
const DEFAULT_HEARTBEAT_STALE_MS = 60_000;
|
|
41
|
-
|
|
42
|
-
/** Polling interval while queued waiting for a held lock (ms). */
|
|
43
|
-
const DEFAULT_LOCK_POLL_MS = 500;
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* Resolve a pid's process start time in ms, reusing the stale-reconciler
|
|
47
|
-
* pattern (src/runtime/stale-reconciler.ts:112). Returns undefined if the
|
|
48
|
-
* process is gone or /proc is unavailable (non-Linux). The absolute value
|
|
49
|
-
* matters less than its uniqueness per PID lifecycle. Used to detect PID
|
|
50
|
-
* recycling: a recycled PID has a different startTime than the recorded one.
|
|
51
|
-
*
|
|
52
|
-
* Callers (esp. tests) may inject a custom resolver to simulate PID recycling
|
|
53
|
-
* deterministically without spawning real processes.
|
|
54
|
-
*/
|
|
55
|
-
export type StartTimeResolver = (pid: number) => number | undefined;
|
|
56
|
-
|
|
57
|
-
export const defaultStartTimeResolver: StartTimeResolver = (pid: number): number | undefined => {
|
|
58
|
-
try {
|
|
59
|
-
const stat = readFileSync(`/proc/${pid}/stat`, "utf-8");
|
|
60
|
-
const lastParen = stat.lastIndexOf(")");
|
|
61
|
-
if (lastParen === -1) return undefined;
|
|
62
|
-
const fieldsAfterComm = stat
|
|
63
|
-
.slice(lastParen + 1)
|
|
64
|
-
.trim()
|
|
65
|
-
.split(/\s+/);
|
|
66
|
-
// starttime is at index 19 (the 20th field after comm) of /proc/<pid>/stat.
|
|
67
|
-
const startTimeClockTicks = Number(fieldsAfterComm[19]);
|
|
68
|
-
if (!Number.isFinite(startTimeClockTicks)) return undefined;
|
|
69
|
-
// Convert clock ticks to ms (~CLK_TCK). Absolute uniqueness is what matters.
|
|
70
|
-
return Math.floor(startTimeClockTicks * 10);
|
|
71
|
-
} catch {
|
|
72
|
-
return undefined;
|
|
73
|
-
}
|
|
74
|
-
};
|
|
75
|
-
|
|
76
|
-
/** Lockfile contents (persisted as JSON). */
|
|
77
|
-
export interface WorkspaceLockContents {
|
|
78
|
-
pid: number;
|
|
79
|
-
startTime: number | undefined;
|
|
80
|
-
heartbeat: number;
|
|
81
|
-
goalId: string;
|
|
82
|
-
acquiredAt: string;
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
/**
|
|
86
|
-
* Opaque handle returned by acquireWorkspaceLock. Call release() to free the
|
|
87
|
-
* lock when the goal ends. release() is a no-op if the lock was already
|
|
88
|
-
* reclaimed/re-acquired by another goal (guarded by goalId + pid + startTime).
|
|
89
|
-
*/
|
|
90
|
-
export interface WorkspaceLockHandle {
|
|
91
|
-
readonly cwd: string;
|
|
92
|
-
readonly goalId: string;
|
|
93
|
-
readonly lockPath: string;
|
|
94
|
-
/** The startTime value written to the lockfile at acquire (release guard). */
|
|
95
|
-
readonly startTime: number | undefined;
|
|
96
|
-
release(): void;
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
export interface AcquireWorkspaceLockOptions {
|
|
100
|
-
/** Throw instead of queue when the workspace is already held (default: queue). */
|
|
101
|
-
failOnWorkspaceBusy?: boolean;
|
|
102
|
-
/** Override the heartbeat-staleness threshold (ms). */
|
|
103
|
-
heartbeatStaleMs?: number;
|
|
104
|
-
/** Override the polling interval while queued (ms). */
|
|
105
|
-
pollMs?: number;
|
|
106
|
-
/** Test injection: override process start time resolution. */
|
|
107
|
-
startTimeResolver?: StartTimeResolver;
|
|
108
|
-
/** Test injection: override current time (ms). Default Date.now(). */
|
|
109
|
-
now?: () => number;
|
|
110
|
-
/** Test injection: override the current pid. Default process.pid. */
|
|
111
|
-
pid?: number;
|
|
112
|
-
/** Abort waiting when this signal aborts. */
|
|
113
|
-
signal?: AbortSignal;
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
/**
|
|
117
|
-
* Resolve the lockfile path for a cwd. Lockfiles live under the project's
|
|
118
|
-
* `.crew/state/workspace-locks/` (or user crew-root fallback) and are named by
|
|
119
|
-
* the sha256 of the absolute cwd to avoid filesystem-unsafe characters and to
|
|
120
|
-
* normalize symlink-equivalent paths.
|
|
121
|
-
*/
|
|
122
|
-
export function workspaceLockPath(cwd: string): string {
|
|
123
|
-
const absCwd = path.resolve(cwd);
|
|
124
|
-
const crewRoot = projectCrewRoot(absCwd) ?? userCrewRoot();
|
|
125
|
-
const locksDir = path.join(crewRoot, "state", "workspace-locks");
|
|
126
|
-
const hash = createHash("sha256").update(absCwd).digest("hex");
|
|
127
|
-
return path.join(locksDir, `${hash}.lock`);
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
/** Read + parse a lockfile. Returns undefined if missing/corrupt. */
|
|
131
|
-
function readLock(lockPath: string): WorkspaceLockContents | undefined {
|
|
132
|
-
if (!existsSync(lockPath)) return undefined;
|
|
133
|
-
try {
|
|
134
|
-
const parsed = JSON.parse(readFileSync(lockPath, "utf-8"));
|
|
135
|
-
if (!parsed || typeof parsed !== "object") return undefined;
|
|
136
|
-
return parsed as WorkspaceLockContents;
|
|
137
|
-
} catch {
|
|
138
|
-
return undefined;
|
|
139
|
-
}
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
/**
|
|
143
|
-
* Write the lockfile atomically (temp+rename+fsync via atomicWriteJson).
|
|
144
|
-
* Used for HEARTBEAT refresh only (a claim that already owns the lock is refreshing its
|
|
145
|
-
* timestamp — overwrite is correct because the owner verified ownership first).
|
|
146
|
-
*/
|
|
147
|
-
function writeLock(lockPath: string, contents: WorkspaceLockContents): void {
|
|
148
|
-
mkdirSync(path.dirname(lockPath), { recursive: true });
|
|
149
|
-
atomicWriteJson(lockPath, contents);
|
|
150
|
-
}
|
|
151
|
-
|
|
152
|
-
/**
|
|
153
|
-
* CLAIM the lockfile atomically via O_EXCL (cold-review #3 NIT #N1 fix).
|
|
154
|
-
* The previous claim used temp+rename (writeLock), which is NOT cross-process atomic —
|
|
155
|
-
* two goals that both observed a free lock in the same tick could both writeLock and
|
|
156
|
-
* both believe they own it (the same class of TOCTOU cold-review #2 caught for CAS).
|
|
157
|
-
* O_EXCL (openSync "wx") IS atomic at the OS level: only one process can create the
|
|
158
|
-
* file. Returns true on success, false if the file already exists (EEXIST). Stale
|
|
159
|
-
* lockfiles older than the threshold are force-deleted + retried once.
|
|
160
|
-
*/
|
|
161
|
-
/**
|
|
162
|
-
* CLAIM the lockfile atomically via O_EXCL (cold-review #3 NIT #N1 fix).
|
|
163
|
-
* The previous claim used temp+rename (writeLock), which is NOT cross-process atomic —
|
|
164
|
-
* two goals that both observed a free/stale lock in the same tick could both writeLock
|
|
165
|
-
* and both believe they own it (the same class of TOCTOU cold-review #2 caught for CAS).
|
|
166
|
-
* O_EXCL (openSync "wx") IS atomic at the OS level: only one process can create the file.
|
|
167
|
-
*
|
|
168
|
-
* `forceOverwrite`: when the caller has ALREADY verified (via isLockStale) that the existing
|
|
169
|
-
* lock is logically stale (e.g. PID recycled — a stronger signal than mtime age), the caller
|
|
170
|
-
* passes forceOverwrite:true and claimLock unlinks then claims, bypassing the mtime age check.
|
|
171
|
-
* (Without this, a stale-by-PID-recycling lock whose mtime is recent would never be claimed,
|
|
172
|
-
* because tryCreate sees EEXIST and the mtime age check fails — infinite re-queue = hang.)
|
|
173
|
-
*
|
|
174
|
-
* Returns true on success, false if the file already exists and is not stale.
|
|
175
|
-
*/
|
|
176
|
-
function claimLock(lockPath: string, contents: WorkspaceLockContents, staleReclaimMs: number, forceOverwrite = false): boolean {
|
|
177
|
-
mkdirSync(path.dirname(lockPath), { recursive: true });
|
|
178
|
-
const json = JSON.stringify(contents);
|
|
179
|
-
const tryCreate = (): boolean => {
|
|
180
|
-
try {
|
|
181
|
-
const fd = openSync(lockPath, "wx"); // O_EXCL — throws EEXIST if it exists.
|
|
182
|
-
try {
|
|
183
|
-
writeFileSync(fd, json);
|
|
184
|
-
} finally {
|
|
185
|
-
closeSync(fd);
|
|
186
|
-
}
|
|
187
|
-
return true;
|
|
188
|
-
} catch (error) {
|
|
189
|
-
const code = (error as NodeJS.ErrnoException).code;
|
|
190
|
-
if (code !== "EEXIST") throw error;
|
|
191
|
-
return false;
|
|
192
|
-
}
|
|
193
|
-
};
|
|
194
|
-
if (forceOverwrite) {
|
|
195
|
-
// Caller verified the existing lock is logically stale; remove it and claim. A concurrent
|
|
196
|
-
// reclaimer might re-create between our unlink and our open — that's fine, we lose the race
|
|
197
|
-
// and return false, falling through to the queue path.
|
|
198
|
-
try {
|
|
199
|
-
unlinkSync(lockPath);
|
|
200
|
-
} catch {
|
|
201
|
-
/* best-effort */
|
|
202
|
-
}
|
|
203
|
-
return tryCreate();
|
|
204
|
-
}
|
|
205
|
-
if (tryCreate()) return true;
|
|
206
|
-
// Stale recovery by mtime age: if the lockfile is older than staleReclaimMs, force-delete + retry.
|
|
207
|
-
try {
|
|
208
|
-
const stat = statSync(lockPath);
|
|
209
|
-
if (Date.now() - stat.mtimeMs > staleReclaimMs) {
|
|
210
|
-
try {
|
|
211
|
-
unlinkSync(lockPath);
|
|
212
|
-
} catch {
|
|
213
|
-
/* fall through */
|
|
214
|
-
}
|
|
215
|
-
return tryCreate();
|
|
216
|
-
}
|
|
217
|
-
} catch {
|
|
218
|
-
/* fall through to false */
|
|
219
|
-
}
|
|
220
|
-
return false;
|
|
221
|
-
}
|
|
222
|
-
|
|
223
|
-
/**
|
|
224
|
-
* Is the lock STALE? RFC §P1g + D10 dual-check:
|
|
225
|
-
* (a) startTime mismatch → PID recycled to a different process, OR
|
|
226
|
-
* (b) heartbeat older than heartbeatStaleMs → crash w/o exit / abandoned.
|
|
227
|
-
*
|
|
228
|
-
* On platforms where startTime is unavailable (non-Linux), only the heartbeat
|
|
229
|
-
* check applies (weaker PID-reuse detection — documented platform limitation,
|
|
230
|
-
* matching stale-reconciler.ts).
|
|
231
|
-
*/
|
|
232
|
-
function isLockStale(
|
|
233
|
-
lock: WorkspaceLockContents,
|
|
234
|
-
resolveStartTime: StartTimeResolver,
|
|
235
|
-
heartbeatStaleMs: number,
|
|
236
|
-
now: number,
|
|
237
|
-
): { stale: boolean; reason?: string } {
|
|
238
|
-
// (a) startTime mismatch → PID recycled to a different process.
|
|
239
|
-
if (lock.startTime !== undefined) {
|
|
240
|
-
const currentStartTime = resolveStartTime(lock.pid);
|
|
241
|
-
if (currentStartTime !== undefined && currentStartTime !== lock.startTime) {
|
|
242
|
-
return { stale: true, reason: "pid_recycled" };
|
|
243
|
-
}
|
|
244
|
-
// currentStartTime === undefined: process gone OR /proc unavailable →
|
|
245
|
-
// fall through to the heartbeat check (corroborating evidence).
|
|
246
|
-
}
|
|
247
|
-
// (b) heartbeat older than threshold → crash without exit / abandoned.
|
|
248
|
-
const heartbeatAge = now - lock.heartbeat;
|
|
249
|
-
if (heartbeatAge > heartbeatStaleMs) {
|
|
250
|
-
return { stale: true, reason: "heartbeat_stale" };
|
|
251
|
-
}
|
|
252
|
-
return { stale: false };
|
|
253
|
-
}
|
|
254
|
-
|
|
255
|
-
/**
|
|
256
|
-
* Acquire the workspace lock for `goalId` at `cwd`. If the lock is held by a
|
|
257
|
-
* live goal, the default behavior is QUEUE (poll until released or the holder
|
|
258
|
-
* goes stale); with opts.failOnWorkspaceBusy:true, throws instead.
|
|
259
|
-
*
|
|
260
|
-
* Stale locks (PID recycled or heartbeat expired) are reclaimed transparently.
|
|
261
|
-
*
|
|
262
|
-
* The returned handle's release() deletes the lockfile ONLY if it still
|
|
263
|
-
* belongs to this goal+pid+startTime — so a stale handle cannot clobber a
|
|
264
|
-
* lock reclaimed and re-acquired by another goal after this goal went stale.
|
|
265
|
-
*
|
|
266
|
-
* In-process serialization: the read→stale-check→write sequence is
|
|
267
|
-
* synchronous within one event-loop tick, so concurrent in-process acquires
|
|
268
|
-
* cannot both observe a free lock and both write (no interleave between the
|
|
269
|
-
* sync read and sync write).
|
|
270
|
-
*/
|
|
271
|
-
export async function acquireWorkspaceLock(
|
|
272
|
-
cwd: string,
|
|
273
|
-
goalId: string,
|
|
274
|
-
opts: AcquireWorkspaceLockOptions = {},
|
|
275
|
-
): Promise<WorkspaceLockHandle> {
|
|
276
|
-
const lockPath = workspaceLockPath(cwd);
|
|
277
|
-
const resolveStartTime = opts.startTimeResolver ?? defaultStartTimeResolver;
|
|
278
|
-
const heartbeatStaleMs = opts.heartbeatStaleMs ?? DEFAULT_HEARTBEAT_STALE_MS;
|
|
279
|
-
const pollMs = opts.pollMs ?? DEFAULT_LOCK_POLL_MS;
|
|
280
|
-
const now = opts.now ?? Date.now;
|
|
281
|
-
const pid = opts.pid ?? process.pid;
|
|
282
|
-
const writtenStartTime = resolveStartTime(pid);
|
|
283
|
-
|
|
284
|
-
while (true) {
|
|
285
|
-
// Poll-loop: re-check the lock each tick until free/stale or aborted.
|
|
286
|
-
if (opts.signal?.aborted) {
|
|
287
|
-
throw new Error(`workspace lock acquisition aborted for goal ${goalId} (cwd=${cwd})`);
|
|
288
|
-
}
|
|
289
|
-
const existing = readLock(lockPath);
|
|
290
|
-
// Classify the existing lock: "absent" / "stale" (PID recycled or heartbeat dead) / "live".
|
|
291
|
-
// Cold-review #3 NIT #N1 fix: when stale, pass forceOverwrite:true to claimLock so it
|
|
292
|
-
// unlinks the stale file before claiming. Without this, a stale-by-PID lock whose mtime
|
|
293
|
-
// is recent would never pass claimLock's mtime age check (it would return false) and the
|
|
294
|
-
// acquireWorkspaceLock poll loop would re-queue forever = hang.
|
|
295
|
-
const existingKind: "absent" | "stale" | "live" = !existing
|
|
296
|
-
? "absent"
|
|
297
|
-
: isLockStale(existing, resolveStartTime, heartbeatStaleMs, now()).stale
|
|
298
|
-
? "stale"
|
|
299
|
-
: "live";
|
|
300
|
-
if (existingKind !== "live") {
|
|
301
|
-
// Claim the lock (covers both no-lock and stale-lock cases).
|
|
302
|
-
// Cold-review #3 NIT #N1 fix: claim via O_EXCL (claimLock), NOT temp+rename — two
|
|
303
|
-
// processes racing past the isLockStale check could both writeLock and both believe
|
|
304
|
-
// they own the lock. claimLock atomically creates the file; if it returns false we
|
|
305
|
-
// lost the race, so fall through to the queue/re-throw path below.
|
|
306
|
-
const contents: WorkspaceLockContents = {
|
|
307
|
-
pid,
|
|
308
|
-
startTime: writtenStartTime,
|
|
309
|
-
heartbeat: now(),
|
|
310
|
-
goalId,
|
|
311
|
-
acquiredAt: new Date(now()).toISOString(),
|
|
312
|
-
};
|
|
313
|
-
const claimed = claimLock(lockPath, contents, heartbeatStaleMs, existingKind === "stale");
|
|
314
|
-
if (claimed) {
|
|
315
|
-
return {
|
|
316
|
-
cwd,
|
|
317
|
-
goalId,
|
|
318
|
-
lockPath,
|
|
319
|
-
startTime: writtenStartTime,
|
|
320
|
-
release(): void {
|
|
321
|
-
safeRelease(lockPath, goalId, pid, writtenStartTime);
|
|
322
|
-
},
|
|
323
|
-
};
|
|
324
|
-
}
|
|
325
|
-
// claimLock lost the race (another process claimed between our stale-check and
|
|
326
|
-
// our claim). Fall through to the busy path (throw or queue) — re-check next tick.
|
|
327
|
-
}
|
|
328
|
-
// Lock is held and live.
|
|
329
|
-
if (opts.failOnWorkspaceBusy) {
|
|
330
|
-
throw new Error(`workspace busy: cwd=${cwd} held by goalId=${existing!.goalId} (pid=${existing!.pid})`);
|
|
331
|
-
}
|
|
332
|
-
// Queue: wait for the next poll interval, then re-check.
|
|
333
|
-
await sleepOrAbort(pollMs, opts.signal);
|
|
334
|
-
}
|
|
335
|
-
}
|
|
336
|
-
|
|
337
|
-
/**
|
|
338
|
-
* Delete the lockfile at `lockPath` only if it still belongs to
|
|
339
|
-
* (goalId, pid, startTime). A stale handle (whose lock was reclaimed and
|
|
340
|
-
* re-acquired by another goal) must NOT delete the new owner's lock.
|
|
341
|
-
*/
|
|
342
|
-
function safeRelease(lockPath: string, goalId: string, pid: number, writtenStartTime: number | undefined): void {
|
|
343
|
-
try {
|
|
344
|
-
const current = readLock(lockPath);
|
|
345
|
-
if (current && current.goalId === goalId && current.pid === pid && current.startTime === writtenStartTime) {
|
|
346
|
-
unlinkSync(lockPath);
|
|
347
|
-
}
|
|
348
|
-
} catch {
|
|
349
|
-
/* best-effort — release must never throw into a finally block */
|
|
350
|
-
}
|
|
351
|
-
}
|
|
352
|
-
|
|
353
|
-
/** Sleep that resolves after `ms`, or rejects early if `signal` aborts. */
|
|
354
|
-
function sleepOrAbort(ms: number, signal?: AbortSignal): Promise<void> {
|
|
355
|
-
if (!signal) return new Promise<void>((r) => setTimeout(r, ms));
|
|
356
|
-
return new Promise<void>((resolve, reject) => {
|
|
357
|
-
const timer = setTimeout(resolve, ms);
|
|
358
|
-
signal.addEventListener(
|
|
359
|
-
"abort",
|
|
360
|
-
() => {
|
|
361
|
-
clearTimeout(timer);
|
|
362
|
-
reject(new Error("workspace lock acquisition aborted"));
|
|
363
|
-
},
|
|
364
|
-
{ once: true },
|
|
365
|
-
);
|
|
366
|
-
});
|
|
367
|
-
}
|
|
368
|
-
|
|
369
|
-
/**
|
|
370
|
-
* Reclaim all stale locks under `dir` (the workspace-locks directory). Returns
|
|
371
|
-
* the list of reclaimed lock paths. Stale = PID recycled OR heartbeat older
|
|
372
|
-
* than threshold. Corrupt/unreadable locks are also reclaimed.
|
|
373
|
-
*
|
|
374
|
-
* Useful as a startup or periodic sweep to clear locks left by crashed
|
|
375
|
-
* processes before any goal tries to acquire them.
|
|
376
|
-
*/
|
|
377
|
-
/**
|
|
378
|
-
* Peek whether the workspace is currently locked by a live owner (without acquiring).
|
|
379
|
-
* Used by `goal start` / `goal resume` to fail-fast with a clear error BEFORE spawning.
|
|
380
|
-
* Returns the goalId of the current owner if busy, undefined if free (or lock missing).
|
|
381
|
-
*/
|
|
382
|
-
export function isWorkspaceBusy(
|
|
383
|
-
cwd: string,
|
|
384
|
-
opts: {
|
|
385
|
-
startTimeResolver?: StartTimeResolver;
|
|
386
|
-
heartbeatStaleMs?: number;
|
|
387
|
-
now?: () => number;
|
|
388
|
-
} = {},
|
|
389
|
-
): string | undefined {
|
|
390
|
-
const lockPath = workspaceLockPath(cwd);
|
|
391
|
-
const resolveStartTime = opts.startTimeResolver ?? defaultStartTimeResolver;
|
|
392
|
-
const heartbeatStaleMs = opts.heartbeatStaleMs ?? DEFAULT_HEARTBEAT_STALE_MS;
|
|
393
|
-
const now = opts.now ?? Date.now;
|
|
394
|
-
const existing = readLock(lockPath);
|
|
395
|
-
if (!existing) return undefined;
|
|
396
|
-
const { stale } = isLockStale(existing, resolveStartTime, heartbeatStaleMs, now());
|
|
397
|
-
return stale ? undefined : existing.goalId;
|
|
398
|
-
}
|
|
399
|
-
|
|
400
|
-
export function reclaimStaleLocks(
|
|
401
|
-
dir: string,
|
|
402
|
-
opts: {
|
|
403
|
-
heartbeatStaleMs?: number;
|
|
404
|
-
startTimeResolver?: StartTimeResolver;
|
|
405
|
-
now?: () => number;
|
|
406
|
-
} = {},
|
|
407
|
-
): string[] {
|
|
408
|
-
const resolveStartTime = opts.startTimeResolver ?? defaultStartTimeResolver;
|
|
409
|
-
const heartbeatStaleMs = opts.heartbeatStaleMs ?? DEFAULT_HEARTBEAT_STALE_MS;
|
|
410
|
-
const now = opts.now ?? Date.now;
|
|
411
|
-
const reclaimed: string[] = [];
|
|
412
|
-
if (!existsSync(dir)) return reclaimed;
|
|
413
|
-
let entries: string[];
|
|
414
|
-
try {
|
|
415
|
-
entries = readdirSync(dir);
|
|
416
|
-
} catch {
|
|
417
|
-
return reclaimed;
|
|
418
|
-
}
|
|
419
|
-
for (const entry of entries) {
|
|
420
|
-
if (!entry.endsWith(".lock")) continue;
|
|
421
|
-
const lockPath = path.join(dir, entry);
|
|
422
|
-
const lock = readLock(lockPath);
|
|
423
|
-
if (!lock) {
|
|
424
|
-
// Corrupt/empty — reclaim.
|
|
425
|
-
try {
|
|
426
|
-
unlinkSync(lockPath);
|
|
427
|
-
reclaimed.push(lockPath);
|
|
428
|
-
} catch {
|
|
429
|
-
/* best-effort */
|
|
430
|
-
}
|
|
431
|
-
continue;
|
|
432
|
-
}
|
|
433
|
-
if (isLockStale(lock, resolveStartTime, heartbeatStaleMs, now()).stale) {
|
|
434
|
-
try {
|
|
435
|
-
unlinkSync(lockPath);
|
|
436
|
-
reclaimed.push(lockPath);
|
|
437
|
-
} catch {
|
|
438
|
-
/* best-effort */
|
|
439
|
-
}
|
|
440
|
-
}
|
|
441
|
-
}
|
|
442
|
-
return reclaimed;
|
|
443
|
-
}
|