@xzzpig/pi-subagents 0.21.0 → 0.24.0
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 +356 -0
- package/README.md +2 -2
- package/agents/evidence-auditor.md +1 -0
- package/agents/oracle.md +1 -0
- package/agents/reviewer.md +1 -0
- package/bundle/agent-management.js +16 -0
- package/bundle/agents.js +41 -0
- package/bundle/background-work.js +16 -0
- package/bundle/capability-ceiling.js +22 -0
- package/bundle/child-tool-plan.js +11 -0
- package/bundle/chunk-355ECEP2.js +1321 -0
- package/bundle/chunk-35GII5EF.js +637 -0
- package/bundle/chunk-3G4JXNZ4.js +4130 -0
- package/bundle/chunk-3U633XDZ.js +749 -0
- package/bundle/chunk-4QFZZV3O.js +57 -0
- package/bundle/chunk-62OCY2S4.js +14 -0
- package/bundle/chunk-7J4ZXMY7.js +18 -0
- package/bundle/chunk-7K3Z6DM7.js +276 -0
- package/bundle/chunk-BGIYHF2W.js +138 -0
- package/bundle/chunk-CTPAE36Y.js +94 -0
- package/bundle/chunk-D4EHT5SJ.js +14 -0
- package/bundle/chunk-ED55MIC2.js +1681 -0
- package/bundle/chunk-F3NSN7UH.js +7331 -0
- package/bundle/chunk-FJWI64H7.js +490 -0
- package/bundle/chunk-H36HBZB2.js +753 -0
- package/bundle/chunk-ICNYIALB.js +7347 -0
- package/bundle/chunk-KD2IMFN4.js +1310 -0
- package/bundle/chunk-LCDJWBVM.js +57 -0
- package/bundle/chunk-LPVUHUZ7.js +5503 -0
- package/bundle/chunk-MYCL5QEJ.js +1372 -0
- package/bundle/chunk-NCWCVJLT.js +1768 -0
- package/bundle/chunk-NIXWDZZV.js +9 -0
- package/bundle/chunk-NTRJDXBC.js +4175 -0
- package/bundle/chunk-OFGSZBHP.js +16924 -0
- package/bundle/chunk-OTLRAB22.js +143 -0
- package/bundle/chunk-QXASAHIA.js +173 -0
- package/bundle/chunk-RB4GELQA.js +458 -0
- package/bundle/chunk-RK2HDPLK.js +1234 -0
- package/bundle/chunk-SW2VMNIU.js +526 -0
- package/bundle/chunk-T65XRVVM.js +940 -0
- package/bundle/chunk-U4ODUYAG.js +235 -0
- package/bundle/chunk-UFNSLL5D.js +9796 -0
- package/bundle/chunk-UKG4V45O.js +228 -0
- package/bundle/chunk-UQDHXMUG.js +264 -0
- package/bundle/chunk-V2KFIGFH.js +8774 -0
- package/bundle/chunk-VO3G7HI3.js +85 -0
- package/bundle/chunk-WPW4V6HM.js +227 -0
- package/bundle/chunk-WW76JRIX.js +175 -0
- package/bundle/chunk-XA3DY6UG.js +161 -0
- package/bundle/chunk-YFCK7H2S.js +129 -0
- package/bundle/chunk-YYREO77V.js +137 -0
- package/bundle/chunk-Z6TFJ6BR.js +400 -0
- package/bundle/control-channel.js +11 -0
- package/bundle/delegation.js +14 -0
- package/bundle/external-job-provider.js +20 -0
- package/bundle/external-runs.js +21 -0
- package/bundle/index.js +30 -0
- package/bundle/inspectors.js +8 -0
- package/bundle/intercom-bridge.js +11 -0
- package/bundle/preflight.js +468 -0
- package/bundle/project-panes.js +28 -0
- package/bundle/required-child-extensions.js +6 -0
- package/bundle/shared-types.js +8 -0
- package/bundle/supervisor-routing.js +12 -0
- package/bundle/workflow-resources.js +7 -0
- package/docs/agents.md +42 -10
- package/docs/configuration.md +59 -14
- package/docs/extension-api.md +61 -9
- package/docs/fork-supervisor-routing.md +77 -0
- package/docs/missions.md +2 -0
- package/docs/observability.md +20 -5
- package/docs/standalone-background.md +8 -6
- package/docs/tool-reference.md +18 -5
- package/docs/workflows.md +25 -7
- package/index.d.ts +3 -0
- package/index.js +14 -0
- package/node_modules/@xzzpig/pi-components/package.json +1 -2
- package/package.json +107 -86
- package/skills/council-mode/SKILL.md +1 -4
- package/skills/pi-subagents/SKILL.md +130 -106
- package/skills/pi-subagents/references/orchestration.md +124 -0
- package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
- package/src/agents/advertised-agent-prompt.d.ts +13 -0
- package/src/agents/advertised-agent-prompt.js +68 -0
- package/src/agents/agent-eject.d.ts +39 -0
- package/src/agents/agent-eject.js +263 -0
- package/src/agents/agent-management.d.ts +33 -0
- package/src/agents/agent-management.js +1541 -0
- package/src/agents/agent-memory.d.ts +48 -0
- package/src/agents/agent-memory.js +350 -0
- package/src/agents/agent-refinements.d.ts +99 -0
- package/src/agents/agent-refinements.js +568 -0
- package/src/agents/agent-scope.d.ts +3 -0
- package/src/agents/agent-scope.js +8 -0
- package/src/agents/agent-selection.d.ts +2 -0
- package/src/agents/agent-selection.js +22 -0
- package/src/agents/agent-serializer.d.ts +7 -0
- package/src/agents/agent-serializer.js +213 -0
- package/src/agents/agents.d.ts +352 -0
- package/src/agents/agents.js +2817 -0
- package/src/agents/builtin-names.d.ts +1 -0
- package/src/agents/builtin-names.js +16 -0
- package/src/agents/chain-serializer.d.ts +6 -0
- package/src/agents/chain-serializer.js +318 -0
- package/src/agents/frontmatter.d.ts +19 -0
- package/src/agents/frontmatter.js +166 -0
- package/src/agents/global-npm-root.d.ts +6 -0
- package/src/agents/global-npm-root.js +57 -0
- package/src/agents/identity.d.ts +7 -0
- package/src/agents/identity.js +29 -0
- package/src/agents/proactive-skills.d.ts +35 -0
- package/src/agents/proactive-skills.js +155 -0
- package/src/agents/runtime-agent-events.d.ts +26 -0
- package/src/agents/runtime-agent-events.js +52 -0
- package/src/agents/runtime-agent-registry.d.ts +66 -0
- package/src/agents/runtime-agent-registry.js +415 -0
- package/src/agents/runtime-discovery.d.ts +13 -0
- package/src/agents/runtime-discovery.js +27 -0
- package/src/agents/skills.d.ts +34 -0
- package/src/agents/skills.js +718 -0
- package/src/api/agent-management.d.ts +2 -0
- package/src/api/agent-management.js +2 -0
- package/src/api/agents.d.ts +6 -0
- package/src/api/agents.js +3 -0
- package/src/api/background-work.d.ts +41 -0
- package/src/api/background-work.js +171 -0
- package/src/api/capability-ceiling.d.ts +1 -0
- package/src/api/capability-ceiling.js +1 -0
- package/src/api/child-tool-plan.d.ts +1 -0
- package/src/api/child-tool-plan.js +1 -0
- package/src/api/control-channel.d.ts +1 -0
- package/src/api/control-channel.js +1 -0
- package/src/api/delegation.d.ts +132 -0
- package/src/api/delegation.js +8 -0
- package/src/api/external-job-provider.d.ts +57 -0
- package/src/api/external-job-provider.js +139 -0
- package/src/api/external-runs.d.ts +47 -0
- package/src/api/external-runs.js +245 -0
- package/src/api/inspectors.d.ts +20 -0
- package/src/api/inspectors.js +11 -0
- package/src/api/intercom-bridge.d.ts +1 -0
- package/src/api/intercom-bridge.js +1 -0
- package/src/api/preflight.d.ts +183 -0
- package/src/api/preflight.js +455 -0
- package/src/api/project-panes.d.ts +7 -0
- package/src/api/project-panes.js +7 -0
- package/src/api/required-child-extensions.d.ts +1 -0
- package/src/api/required-child-extensions.js +1 -0
- package/src/api/shared-types.d.ts +1 -0
- package/src/api/shared-types.js +1 -0
- package/src/api/supervisor-routing.d.ts +110 -0
- package/src/api/supervisor-routing.js +95 -0
- package/src/api/workflow-resources.d.ts +2 -0
- package/src/api/workflow-resources.js +1 -0
- package/src/extension/active-runs-prompt.d.ts +7 -0
- package/src/extension/active-runs-prompt.js +29 -0
- package/src/extension/config.d.ts +7 -0
- package/src/extension/config.js +290 -0
- package/src/extension/context-injection.d.ts +52 -0
- package/src/extension/context-injection.js +102 -0
- package/src/extension/control-notices.d.ts +18 -0
- package/src/extension/control-notices.js +29 -0
- package/src/extension/declaration-pinning.d.ts +18 -0
- package/src/extension/declaration-pinning.js +167 -0
- package/src/extension/doctor.d.ts +34 -0
- package/src/extension/doctor.js +236 -0
- package/src/extension/fanout-child.d.ts +6 -0
- package/src/extension/fanout-child.js +278 -0
- package/src/extension/herdr-pi-bridge.d.ts +16 -0
- package/src/extension/herdr-pi-bridge.js +261 -0
- package/src/extension/index.d.ts +18 -0
- package/src/extension/index.js +1288 -0
- package/src/extension/public-execution.d.ts +71 -0
- package/src/extension/public-execution.js +214 -0
- package/src/extension/reply-workflow-script.d.ts +11 -0
- package/src/extension/reply-workflow-script.js +71 -0
- package/src/extension/rpc.d.ts +84 -0
- package/src/extension/rpc.js +729 -0
- package/src/extension/schemas.d.ts +276 -0
- package/src/extension/schemas.js +311 -0
- package/src/extension/steering-notices.d.ts +14 -0
- package/src/extension/steering-notices.js +22 -0
- package/src/extension/subagent-guide.d.ts +4 -0
- package/src/extension/subagent-guide.js +114 -0
- package/src/extension/subagent-options.d.ts +7 -0
- package/src/extension/subagent-options.js +64 -0
- package/src/extension/tool-activation.d.ts +7 -0
- package/src/extension/tool-activation.js +185 -0
- package/src/extension/tool-description.d.ts +19 -0
- package/src/extension/tool-description.js +169 -0
- package/src/extension/tool-result.d.ts +9 -0
- package/src/extension/tool-result.js +16 -0
- package/src/extension/upgrade-notice.d.ts +6 -0
- package/src/extension/upgrade-notice.js +42 -0
- package/src/inspectors/actions.d.ts +24 -0
- package/src/inspectors/actions.js +182 -0
- package/src/inspectors/ghostty/actions.d.ts +11 -0
- package/src/inspectors/ghostty/actions.js +62 -0
- package/src/inspectors/ghostty/plugin.d.ts +7 -0
- package/src/inspectors/ghostty/plugin.js +23 -0
- package/src/inspectors/herdr/actions.d.ts +25 -0
- package/src/inspectors/herdr/actions.js +133 -0
- package/src/inspectors/herdr/client.d.ts +41 -0
- package/src/inspectors/herdr/client.js +129 -0
- package/src/inspectors/herdr/focus.d.ts +24 -0
- package/src/inspectors/herdr/focus.js +49 -0
- package/src/inspectors/herdr/plugin.d.ts +6 -0
- package/src/inspectors/herdr/plugin.js +14 -0
- package/src/inspectors/herdr/project-panes.d.ts +136 -0
- package/src/inspectors/herdr/project-panes.js +610 -0
- package/src/inspectors/inspector-runner.d.ts +23 -0
- package/src/inspectors/inspector-runner.js +161 -0
- package/src/inspectors/plugins.d.ts +8 -0
- package/src/inspectors/plugins.js +82 -0
- package/src/inspectors/session-roots-codec.d.ts +15 -0
- package/src/inspectors/session-roots-codec.js +32 -0
- package/src/inspectors/shell-command.d.ts +1 -0
- package/src/inspectors/shell-command.js +16 -0
- package/src/inspectors/tmux/actions.d.ts +25 -0
- package/src/inspectors/tmux/actions.js +181 -0
- package/src/inspectors/tmux/client.d.ts +27 -0
- package/src/inspectors/tmux/client.js +64 -0
- package/src/inspectors/tmux/plugin.d.ts +7 -0
- package/src/inspectors/tmux/plugin.js +14 -0
- package/src/inspectors/types.d.ts +48 -0
- package/src/inspectors/types.js +1 -0
- package/src/integrations/herdr-status.d.ts +47 -0
- package/src/integrations/herdr-status.js +350 -0
- package/src/integrations/pi-web-session-liveness.d.ts +19 -0
- package/src/integrations/pi-web-session-liveness.js +53 -0
- package/src/integrations/program-status.d.ts +30 -0
- package/src/integrations/program-status.js +188 -0
- package/src/intercom/fork-supervisor-routing.d.ts +90 -0
- package/src/intercom/fork-supervisor-routing.js +392 -0
- package/src/intercom/intercom-bridge.d.ts +58 -0
- package/src/intercom/intercom-bridge.js +193 -0
- package/src/intercom/native-supervisor-channel.d.ts +97 -0
- package/src/intercom/native-supervisor-channel.js +1184 -0
- package/src/intercom/result-intercom.d.ts +35 -0
- package/src/intercom/result-intercom.js +376 -0
- package/src/intercom/supervisor-ui.d.ts +29 -0
- package/src/intercom/supervisor-ui.js +49 -0
- package/src/missions/actions.d.ts +54 -0
- package/src/missions/actions.js +400 -0
- package/src/missions/goal-driver.d.ts +16 -0
- package/src/missions/goal-driver.js +171 -0
- package/src/missions/lifecycle.d.ts +50 -0
- package/src/missions/lifecycle.js +388 -0
- package/src/missions/store.d.ts +21 -0
- package/src/missions/store.js +605 -0
- package/src/missions/types.d.ts +169 -0
- package/src/missions/types.js +9 -0
- package/src/missions/workflow-state.d.ts +14 -0
- package/src/missions/workflow-state.js +273 -0
- package/src/policy/authority.d.ts +9 -0
- package/src/policy/authority.js +41 -0
- package/src/profiles/profiles.d.ts +134 -0
- package/src/profiles/profiles.js +526 -0
- package/src/runs/background/active-async-capacity.d.ts +115 -0
- package/src/runs/background/active-async-capacity.js +517 -0
- package/src/runs/background/active-run-index.d.ts +12 -0
- package/src/runs/background/active-run-index.js +157 -0
- package/src/runs/background/async-execution.d.ts +304 -0
- package/src/runs/background/async-execution.js +2206 -0
- package/src/runs/background/async-job-tracker.d.ts +37 -0
- package/src/runs/background/async-job-tracker.js +921 -0
- package/src/runs/background/async-resume.d.ts +60 -0
- package/src/runs/background/async-resume.js +707 -0
- package/src/runs/background/async-retention.d.ts +45 -0
- package/src/runs/background/async-retention.js +932 -0
- package/src/runs/background/async-status-snapshot.d.ts +9 -0
- package/src/runs/background/async-status-snapshot.js +26 -0
- package/src/runs/background/async-status.d.ts +177 -0
- package/src/runs/background/async-status.js +710 -0
- package/src/runs/background/auto-drain.d.ts +16 -0
- package/src/runs/background/auto-drain.js +71 -0
- package/src/runs/background/await-async-run.d.ts +26 -0
- package/src/runs/background/await-async-run.js +83 -0
- package/src/runs/background/binary-bootstrap.d.ts +8 -0
- package/src/runs/background/binary-bootstrap.js +69 -0
- package/src/runs/background/boot-id.d.ts +12 -0
- package/src/runs/background/boot-id.js +47 -0
- package/src/runs/background/calendar-schedule.d.ts +26 -0
- package/src/runs/background/calendar-schedule.js +93 -0
- package/src/runs/background/chain-append.d.ts +34 -0
- package/src/runs/background/chain-append.js +299 -0
- package/src/runs/background/chain-root-attachment.d.ts +51 -0
- package/src/runs/background/chain-root-attachment.js +186 -0
- package/src/runs/background/completion-batcher.d.ts +51 -0
- package/src/runs/background/completion-batcher.js +119 -0
- package/src/runs/background/completion-dedupe.d.ts +13 -0
- package/src/runs/background/completion-dedupe.js +48 -0
- package/src/runs/background/completion-replay.d.ts +47 -0
- package/src/runs/background/completion-replay.js +266 -0
- package/src/runs/background/control-channel.d.ts +170 -0
- package/src/runs/background/control-channel.js +610 -0
- package/src/runs/background/fleet-view.d.ts +63 -0
- package/src/runs/background/fleet-view.js +666 -0
- package/src/runs/background/index-segment.d.ts +16 -0
- package/src/runs/background/index-segment.js +58 -0
- package/src/runs/background/inspect-rpc.d.ts +64 -0
- package/src/runs/background/inspect-rpc.js +422 -0
- package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
- package/src/runs/background/interrupted-elsewhere.js +68 -0
- package/src/runs/background/notify.d.ts +214 -0
- package/src/runs/background/notify.js +1001 -0
- package/src/runs/background/owned-process-tree.d.ts +10 -0
- package/src/runs/background/owned-process-tree.js +116 -0
- package/src/runs/background/parallel-groups.d.ts +3 -0
- package/src/runs/background/parallel-groups.js +46 -0
- package/src/runs/background/pid-namespace.d.ts +2 -0
- package/src/runs/background/pid-namespace.js +19 -0
- package/src/runs/background/process-terminal-candidate.d.ts +17 -0
- package/src/runs/background/process-terminal-candidate.js +96 -0
- package/src/runs/background/process-terminal.d.ts +21 -0
- package/src/runs/background/process-terminal.js +227 -0
- package/src/runs/background/result-delivery-ownership.d.ts +14 -0
- package/src/runs/background/result-delivery-ownership.js +38 -0
- package/src/runs/background/result-files.d.ts +63 -0
- package/src/runs/background/result-files.js +629 -0
- package/src/runs/background/result-watcher.d.ts +92 -0
- package/src/runs/background/result-watcher.js +819 -0
- package/src/runs/background/resume-guidance.d.ts +4 -0
- package/src/runs/background/resume-guidance.js +57 -0
- package/src/runs/background/retained-children.d.ts +24 -0
- package/src/runs/background/retained-children.js +128 -0
- package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
- package/src/runs/background/retained-nested-route-tracker.js +90 -0
- package/src/runs/background/run-child-session.d.ts +123 -0
- package/src/runs/background/run-child-session.js +670 -0
- package/src/runs/background/run-id-query.d.ts +3 -0
- package/src/runs/background/run-id-query.js +6 -0
- package/src/runs/background/run-id-resolver.d.ts +22 -0
- package/src/runs/background/run-id-resolver.js +172 -0
- package/src/runs/background/run-status.d.ts +25 -0
- package/src/runs/background/run-status.js +850 -0
- package/src/runs/background/runner-aliases.d.ts +17 -0
- package/src/runs/background/runner-aliases.js +191 -0
- package/src/runs/background/runner-child-launch.d.ts +24 -0
- package/src/runs/background/runner-child-launch.js +72 -0
- package/src/runs/background/runner-child-sessions.d.ts +6 -0
- package/src/runs/background/runner-child-sessions.js +34 -0
- package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
- package/src/runs/background/runner-http-dispatcher.js +115 -0
- package/src/runs/background/runner-startup-failure.d.ts +13 -0
- package/src/runs/background/runner-startup-failure.js +46 -0
- package/src/runs/background/scheduled-runs.d.ts +127 -0
- package/src/runs/background/scheduled-runs.js +1265 -0
- package/src/runs/background/stale-run-reconciler.d.ts +62 -0
- package/src/runs/background/stale-run-reconciler.js +509 -0
- package/src/runs/background/steering.d.ts +51 -0
- package/src/runs/background/steering.js +246 -0
- package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
- package/src/runs/background/subagent-runner-bootstrap.js +283 -0
- package/src/runs/background/subagent-runner.d.ts +210 -0
- package/src/runs/background/subagent-runner.js +4963 -0
- package/src/runs/background/subagent-wait.d.ts +124 -0
- package/src/runs/background/subagent-wait.js +756 -0
- package/src/runs/background/terminal-run-index.d.ts +10 -0
- package/src/runs/background/terminal-run-index.js +209 -0
- package/src/runs/background/top-level-async.d.ts +7 -0
- package/src/runs/background/top-level-async.js +5 -0
- package/src/runs/background/wait-completions.d.ts +28 -0
- package/src/runs/background/wait-completions.js +264 -0
- package/src/runs/background/wait-config.d.ts +8 -0
- package/src/runs/background/wait-config.js +46 -0
- package/src/runs/background/wait-subscriptions.d.ts +26 -0
- package/src/runs/background/wait-subscriptions.js +339 -0
- package/src/runs/background/wait-tool.d.ts +6 -0
- package/src/runs/background/wait-tool.js +48 -0
- package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
- package/src/runs/background/workflow-terminal-proof.js +116 -0
- package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
- package/src/runs/foreground/async-dismiss-action.js +82 -0
- package/src/runs/foreground/async-steering-action.d.ts +31 -0
- package/src/runs/foreground/async-steering-action.js +294 -0
- package/src/runs/foreground/async-stop-action.d.ts +13 -0
- package/src/runs/foreground/async-stop-action.js +213 -0
- package/src/runs/foreground/command-action.d.ts +12 -0
- package/src/runs/foreground/command-action.js +38 -0
- package/src/runs/foreground/execution.d.ts +10 -0
- package/src/runs/foreground/execution.js +2322 -0
- package/src/runs/foreground/foreground-control.d.ts +24 -0
- package/src/runs/foreground/foreground-control.js +138 -0
- package/src/runs/foreground/foreground-history.d.ts +25 -0
- package/src/runs/foreground/foreground-history.js +267 -0
- package/src/runs/foreground/prompt-audit.d.ts +32 -0
- package/src/runs/foreground/prompt-audit.js +138 -0
- package/src/runs/foreground/subagent-executor.d.ts +316 -0
- package/src/runs/foreground/subagent-executor.js +7986 -0
- package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
- package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
- package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
- package/src/runs/foreground/workflow-foreground-steering.js +148 -0
- package/src/runs/shared/abort-recovery.d.ts +26 -0
- package/src/runs/shared/abort-recovery.js +108 -0
- package/src/runs/shared/acceptance.d.ts +144 -0
- package/src/runs/shared/acceptance.js +1616 -0
- package/src/runs/shared/agent-contract.d.ts +5 -0
- package/src/runs/shared/agent-contract.js +35 -0
- package/src/runs/shared/async-status-projection.d.ts +100 -0
- package/src/runs/shared/async-status-projection.js +566 -0
- package/src/runs/shared/background-process-options.d.ts +4 -0
- package/src/runs/shared/background-process-options.js +6 -0
- package/src/runs/shared/capability-ceiling.d.ts +58 -0
- package/src/runs/shared/capability-ceiling.js +179 -0
- package/src/runs/shared/chain-outputs.d.ts +18 -0
- package/src/runs/shared/chain-outputs.js +104 -0
- package/src/runs/shared/child-commands.d.ts +29 -0
- package/src/runs/shared/child-commands.js +254 -0
- package/src/runs/shared/child-hooks.d.ts +31 -0
- package/src/runs/shared/child-hooks.js +173 -0
- package/src/runs/shared/child-identity.d.ts +23 -0
- package/src/runs/shared/child-identity.js +40 -0
- package/src/runs/shared/child-launch-plan.d.ts +70 -0
- package/src/runs/shared/child-launch-plan.js +88 -0
- package/src/runs/shared/child-launch.d.ts +128 -0
- package/src/runs/shared/child-launch.js +262 -0
- package/src/runs/shared/child-lifecycle.d.ts +13 -0
- package/src/runs/shared/child-lifecycle.js +22 -0
- package/src/runs/shared/child-runtime-config.d.ts +111 -0
- package/src/runs/shared/child-runtime-config.js +44 -0
- package/src/runs/shared/child-session.d.ts +178 -0
- package/src/runs/shared/child-session.js +726 -0
- package/src/runs/shared/child-tool-plan.d.ts +101 -0
- package/src/runs/shared/child-tool-plan.js +430 -0
- package/src/runs/shared/claude-code-adapter.d.ts +80 -0
- package/src/runs/shared/claude-code-adapter.js +255 -0
- package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
- package/src/runs/shared/codex-exec-adapter.js +127 -0
- package/src/runs/shared/context-mode.d.ts +12 -0
- package/src/runs/shared/context-mode.js +38 -0
- package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
- package/src/runs/shared/cursor-agent-adapter.js +99 -0
- package/src/runs/shared/dynamic-fanout.d.ts +49 -0
- package/src/runs/shared/dynamic-fanout.js +273 -0
- package/src/runs/shared/effective-system-prompt.d.ts +17 -0
- package/src/runs/shared/effective-system-prompt.js +23 -0
- package/src/runs/shared/extension-bindings.d.ts +25 -0
- package/src/runs/shared/extension-bindings.js +96 -0
- package/src/runs/shared/external-cli-contract.d.ts +29 -0
- package/src/runs/shared/external-cli-contract.js +145 -0
- package/src/runs/shared/external-cli-preflight.d.ts +41 -0
- package/src/runs/shared/external-cli-preflight.js +159 -0
- package/src/runs/shared/external-cli-runner.d.ts +65 -0
- package/src/runs/shared/external-cli-runner.js +425 -0
- package/src/runs/shared/external-job-bridge.d.ts +24 -0
- package/src/runs/shared/external-job-bridge.js +486 -0
- package/src/runs/shared/external-job-runner.d.ts +44 -0
- package/src/runs/shared/external-job-runner.js +352 -0
- package/src/runs/shared/fast-mode-extension.d.ts +3 -0
- package/src/runs/shared/fast-mode-extension.js +8 -0
- package/src/runs/shared/fork-placed-env.d.ts +4 -0
- package/src/runs/shared/fork-placed-env.js +13 -0
- package/src/runs/shared/git-environment.d.ts +2 -0
- package/src/runs/shared/git-environment.js +27 -0
- package/src/runs/shared/herdr-connection.d.ts +79 -0
- package/src/runs/shared/herdr-connection.js +269 -0
- package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
- package/src/runs/shared/herdr-external-adapters.js +404 -0
- package/src/runs/shared/herdr-machine.d.ts +59 -0
- package/src/runs/shared/herdr-machine.js +294 -0
- package/src/runs/shared/herdr-pane-host.d.ts +88 -0
- package/src/runs/shared/herdr-pane-host.js +155 -0
- package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
- package/src/runs/shared/herdr-pi-protocol.js +57 -0
- package/src/runs/shared/herdr-placed-run.d.ts +144 -0
- package/src/runs/shared/herdr-placed-run.js +380 -0
- package/src/runs/shared/host-step-status.d.ts +33 -0
- package/src/runs/shared/host-step-status.js +244 -0
- package/src/runs/shared/lane-metadata.d.ts +23 -0
- package/src/runs/shared/lane-metadata.js +126 -0
- package/src/runs/shared/launch-cwd.d.ts +1 -0
- package/src/runs/shared/launch-cwd.js +16 -0
- package/src/runs/shared/local-machine-access.d.ts +5 -0
- package/src/runs/shared/local-machine-access.js +28 -0
- package/src/runs/shared/long-running-guard.d.ts +34 -0
- package/src/runs/shared/long-running-guard.js +256 -0
- package/src/runs/shared/mcp-config-sources.d.ts +33 -0
- package/src/runs/shared/mcp-config-sources.js +418 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
- package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
- package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
- package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
- package/src/runs/shared/model-resolution-diagnostic.js +116 -0
- package/src/runs/shared/model-resolution.d.ts +109 -0
- package/src/runs/shared/model-resolution.js +411 -0
- package/src/runs/shared/model-scope.d.ts +68 -0
- package/src/runs/shared/model-scope.js +171 -0
- package/src/runs/shared/mutation-evidence.d.ts +18 -0
- package/src/runs/shared/mutation-evidence.js +198 -0
- package/src/runs/shared/nested-events.d.ts +135 -0
- package/src/runs/shared/nested-events.js +1090 -0
- package/src/runs/shared/nested-path.d.ts +8 -0
- package/src/runs/shared/nested-path.js +34 -0
- package/src/runs/shared/nested-render.d.ts +20 -0
- package/src/runs/shared/nested-render.js +115 -0
- package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
- package/src/runs/shared/orca-progress-tabs.js +503 -0
- package/src/runs/shared/parallel-handoff.d.ts +78 -0
- package/src/runs/shared/parallel-handoff.js +783 -0
- package/src/runs/shared/parallel-utils.d.ts +177 -0
- package/src/runs/shared/parallel-utils.js +125 -0
- package/src/runs/shared/partial-output.d.ts +24 -0
- package/src/runs/shared/partial-output.js +35 -0
- package/src/runs/shared/permissions.d.ts +12 -0
- package/src/runs/shared/permissions.js +92 -0
- package/src/runs/shared/pi-spawn.d.ts +31 -0
- package/src/runs/shared/pi-spawn.js +211 -0
- package/src/runs/shared/placed-run-owner.d.ts +49 -0
- package/src/runs/shared/placed-run-owner.js +93 -0
- package/src/runs/shared/placement-host.d.ts +99 -0
- package/src/runs/shared/placement-host.js +157 -0
- package/src/runs/shared/process-signal.d.ts +15 -0
- package/src/runs/shared/process-signal.js +21 -0
- package/src/runs/shared/profile-extensions.d.ts +21 -0
- package/src/runs/shared/profile-extensions.js +122 -0
- package/src/runs/shared/profile-launch-env.d.ts +26 -0
- package/src/runs/shared/profile-launch-env.js +90 -0
- package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
- package/src/runs/shared/readonly-drain-observation.js +50 -0
- package/src/runs/shared/rex-machine.d.ts +25 -0
- package/src/runs/shared/rex-machine.js +83 -0
- package/src/runs/shared/rex-pane-host.d.ts +62 -0
- package/src/runs/shared/rex-pane-host.js +327 -0
- package/src/runs/shared/run-fanout-budget.d.ts +14 -0
- package/src/runs/shared/run-fanout-budget.js +258 -0
- package/src/runs/shared/run-ownership.d.ts +3 -0
- package/src/runs/shared/run-ownership.js +8 -0
- package/src/runs/shared/runner-launcher.d.ts +11 -0
- package/src/runs/shared/runner-launcher.js +24 -0
- package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
- package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
- package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
- package/src/runs/shared/sandbox-profile-guard.js +106 -0
- package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
- package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
- package/src/runs/shared/session-lease.d.ts +69 -0
- package/src/runs/shared/session-lease.js +250 -0
- package/src/runs/shared/single-output.d.ts +90 -0
- package/src/runs/shared/single-output.js +349 -0
- package/src/runs/shared/spawn-budget.d.ts +20 -0
- package/src/runs/shared/spawn-budget.js +93 -0
- package/src/runs/shared/structured-output.d.ts +66 -0
- package/src/runs/shared/structured-output.js +483 -0
- package/src/runs/shared/subagent-control.d.ts +50 -0
- package/src/runs/shared/subagent-control.js +247 -0
- package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
- package/src/runs/shared/subagent-prompt-runtime.js +776 -0
- package/src/runs/shared/tool-availability.d.ts +16 -0
- package/src/runs/shared/tool-availability.js +29 -0
- package/src/runs/shared/tool-budget.d.ts +21 -0
- package/src/runs/shared/tool-budget.js +78 -0
- package/src/runs/shared/tool-timeout.d.ts +31 -0
- package/src/runs/shared/tool-timeout.js +73 -0
- package/src/runs/shared/usage-budget.d.ts +7 -0
- package/src/runs/shared/usage-budget.js +74 -0
- package/src/runs/shared/usage-reconciliation.d.ts +8 -0
- package/src/runs/shared/usage-reconciliation.js +71 -0
- package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
- package/src/runs/shared/workflow-async-child-guidance.js +17 -0
- package/src/runs/shared/workflow-graph.d.ts +31 -0
- package/src/runs/shared/workflow-graph.js +221 -0
- package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
- package/src/runs/shared/worktree-cleanup-apply.js +178 -0
- package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
- package/src/runs/shared/worktree-cleanup-plan.js +803 -0
- package/src/runs/shared/worktree-lock.d.ts +5 -0
- package/src/runs/shared/worktree-lock.js +40 -0
- package/src/runs/shared/worktree-setup-command.d.ts +38 -0
- package/src/runs/shared/worktree-setup-command.js +200 -0
- package/src/runs/shared/worktree.d.ts +181 -0
- package/src/runs/shared/worktree.js +1346 -0
- package/src/shared/accessible-dir.d.ts +11 -0
- package/src/shared/accessible-dir.js +39 -0
- package/src/shared/agent-stream-options.d.ts +5 -0
- package/src/shared/agent-stream-options.js +3 -0
- package/src/shared/artifacts.d.ts +22 -0
- package/src/shared/artifacts.js +272 -0
- package/src/shared/atomic-json.d.ts +19 -0
- package/src/shared/atomic-json.js +61 -0
- package/src/shared/capacity-resilient-json.d.ts +26 -0
- package/src/shared/capacity-resilient-json.js +86 -0
- package/src/shared/child-cache-retention.d.ts +29 -0
- package/src/shared/child-cache-retention.js +40 -0
- package/src/shared/child-session-name.d.ts +8 -0
- package/src/shared/child-session-name.js +40 -0
- package/src/shared/child-transcript.d.ts +37 -0
- package/src/shared/child-transcript.js +225 -0
- package/src/shared/completion-owner.d.ts +7 -0
- package/src/shared/completion-owner.js +13 -0
- package/src/shared/disabled-features.d.ts +93 -0
- package/src/shared/disabled-features.js +120 -0
- package/src/shared/display-text.d.ts +5 -0
- package/src/shared/display-text.js +154 -0
- package/src/shared/edit-distance.d.ts +4 -0
- package/src/shared/edit-distance.js +32 -0
- package/src/shared/extension-context.d.ts +21 -0
- package/src/shared/extension-context.js +39 -0
- package/src/shared/file-coalescer.d.ts +11 -0
- package/src/shared/file-coalescer.js +34 -0
- package/src/shared/file-lease.d.ts +10 -0
- package/src/shared/file-lease.js +106 -0
- package/src/shared/file-system-retry.d.ts +31 -0
- package/src/shared/file-system-retry.js +84 -0
- package/src/shared/fork-context.d.ts +64 -0
- package/src/shared/fork-context.js +185 -0
- package/src/shared/fork-session-cwd.d.ts +2 -0
- package/src/shared/fork-session-cwd.js +23 -0
- package/src/shared/formatters.d.ts +35 -0
- package/src/shared/formatters.js +137 -0
- package/src/shared/jsonl-writer.d.ts +20 -0
- package/src/shared/jsonl-writer.js +67 -0
- package/src/shared/launch-contract.d.ts +65 -0
- package/src/shared/launch-contract.js +145 -0
- package/src/shared/model-info.d.ts +55 -0
- package/src/shared/model-info.js +103 -0
- package/src/shared/model-response-aliases.d.ts +1 -0
- package/src/shared/model-response-aliases.js +15 -0
- package/src/shared/node-executable.d.ts +1 -0
- package/src/shared/node-executable.js +20 -0
- package/src/shared/opencode-session-headers.d.ts +12 -0
- package/src/shared/opencode-session-headers.js +26 -0
- package/src/shared/package-version.d.ts +2 -0
- package/src/shared/package-version.js +14 -0
- package/src/shared/parent-wake.d.ts +26 -0
- package/src/shared/parent-wake.js +68 -0
- package/src/shared/permission-profile.d.ts +26 -0
- package/src/shared/permission-profile.js +49 -0
- package/src/shared/prompt-resources.d.ts +5 -0
- package/src/shared/prompt-resources.js +10 -0
- package/src/shared/provider-diagnostics.d.ts +9 -0
- package/src/shared/provider-diagnostics.js +75 -0
- package/src/shared/pruned-fork.d.ts +34 -0
- package/src/shared/pruned-fork.js +434 -0
- package/src/shared/required-child-extensions.d.ts +34 -0
- package/src/shared/required-child-extensions.js +105 -0
- package/src/shared/runtime-module-path.d.ts +10 -0
- package/src/shared/runtime-module-path.js +16 -0
- package/src/shared/sandbox-profile.d.ts +12 -0
- package/src/shared/sandbox-profile.js +35 -0
- package/src/shared/session-file-trust.d.ts +1 -0
- package/src/shared/session-file-trust.js +20 -0
- package/src/shared/session-identity.d.ts +8 -0
- package/src/shared/session-identity.js +32 -0
- package/src/shared/session-succession.d.ts +4 -0
- package/src/shared/session-succession.js +24 -0
- package/src/shared/session-tokens.d.ts +2 -0
- package/src/shared/session-tokens.js +58 -0
- package/src/shared/settings-file-lease.d.ts +4 -0
- package/src/shared/settings-file-lease.js +38 -0
- package/src/shared/settings.d.ts +146 -0
- package/src/shared/settings.js +247 -0
- package/src/shared/shortcuts.d.ts +1 -0
- package/src/shared/shortcuts.js +17 -0
- package/src/shared/status-format.d.ts +9 -0
- package/src/shared/status-format.js +60 -0
- package/src/shared/thinking-ceiling.d.ts +13 -0
- package/src/shared/thinking-ceiling.js +37 -0
- package/src/shared/types.d.ts +2840 -0
- package/src/shared/types.js +276 -0
- package/src/shared/utf8.d.ts +5 -0
- package/src/shared/utf8.js +12 -0
- package/src/shared/utils.d.ts +83 -0
- package/src/shared/utils.js +612 -0
- package/src/shared/watch-strategy.d.ts +2 -0
- package/src/shared/watch-strategy.js +5 -0
- package/src/shared/workflow-child-permit.d.ts +58 -0
- package/src/shared/workflow-child-permit.js +159 -0
- package/src/slash/delegation-adapters.d.ts +154 -0
- package/src/slash/delegation-adapters.js +316 -0
- package/src/slash/delegation-json.d.ts +10 -0
- package/src/slash/delegation-json.js +117 -0
- package/src/slash/delegation-request.d.ts +12 -0
- package/src/slash/delegation-request.js +174 -0
- package/src/slash/prompt-template-bridge.d.ts +29 -0
- package/src/slash/prompt-template-bridge.js +399 -0
- package/src/slash/prompt-workflows.d.ts +21 -0
- package/src/slash/prompt-workflows.js +274 -0
- package/src/slash/selector.d.ts +47 -0
- package/src/slash/selector.js +117 -0
- package/src/slash/slash-bridge.d.ts +30 -0
- package/src/slash/slash-bridge.js +132 -0
- package/src/slash/slash-commands.d.ts +10 -0
- package/src/slash/slash-commands.js +1059 -0
- package/src/slash/slash-live-state.d.ts +21 -0
- package/src/slash/slash-live-state.js +263 -0
- package/src/slash/subagent-cost.d.ts +29 -0
- package/src/slash/subagent-cost.js +310 -0
- package/src/slash/subagents-admin.d.ts +3 -0
- package/src/slash/subagents-admin.js +481 -0
- package/src/tui/fleet-layout.d.ts +20 -0
- package/src/tui/fleet-layout.js +17 -0
- package/src/tui/fleet-native-transcript.d.ts +53 -0
- package/src/tui/fleet-native-transcript.js +339 -0
- package/src/tui/fleet-status.d.ts +92 -0
- package/src/tui/fleet-status.js +1132 -0
- package/src/tui/fleet-transcript.d.ts +64 -0
- package/src/tui/fleet-transcript.js +544 -0
- package/src/tui/fleet-viewport.d.ts +12 -0
- package/src/tui/fleet-viewport.js +35 -0
- package/src/tui/fleet.d.ts +196 -0
- package/src/tui/fleet.js +1588 -0
- package/src/tui/mouse-events.d.ts +21 -0
- package/src/tui/mouse-events.js +26 -0
- package/src/tui/render-helpers.d.ts +23 -0
- package/src/tui/render-helpers.js +100 -0
- package/src/tui/render.d.ts +66 -0
- package/src/tui/render.js +3707 -0
- package/src/tui/running-tone.d.ts +10 -0
- package/src/tui/running-tone.js +22 -0
- package/src/tui/subagent-messages.d.ts +22 -0
- package/src/tui/subagent-messages.js +270 -0
- package/src/ui-silent-marker.d.ts +20 -0
- package/src/ui-silent-marker.js +25 -0
- package/src/watchdog/change-signature.d.ts +7 -0
- package/src/watchdog/change-signature.js +243 -0
- package/src/watchdog/child-status.d.ts +53 -0
- package/src/watchdog/child-status.js +187 -0
- package/src/watchdog/diff-tool.d.ts +25 -0
- package/src/watchdog/diff-tool.js +104 -0
- package/src/watchdog/emission-guard.d.ts +36 -0
- package/src/watchdog/emission-guard.js +97 -0
- package/src/watchdog/guidance.d.ts +3 -0
- package/src/watchdog/guidance.js +19 -0
- package/src/watchdog/lsp-diagnostics.d.ts +17 -0
- package/src/watchdog/lsp-diagnostics.js +489 -0
- package/src/watchdog/model-selection.d.ts +24 -0
- package/src/watchdog/model-selection.js +167 -0
- package/src/watchdog/permission-arbiter.d.ts +20 -0
- package/src/watchdog/permission-arbiter.js +135 -0
- package/src/watchdog/register-child.d.ts +13 -0
- package/src/watchdog/register-child.js +128 -0
- package/src/watchdog/register-main.d.ts +11 -0
- package/src/watchdog/register-main.js +400 -0
- package/src/watchdog/render.d.ts +3 -0
- package/src/watchdog/render.js +33 -0
- package/src/watchdog/review.d.ts +36 -0
- package/src/watchdog/review.js +319 -0
- package/src/watchdog/rules.d.ts +21 -0
- package/src/watchdog/rules.js +58 -0
- package/src/watchdog/runtime.d.ts +195 -0
- package/src/watchdog/runtime.js +864 -0
- package/src/watchdog/scope.d.ts +14 -0
- package/src/watchdog/scope.js +44 -0
- package/src/watchdog/settings.d.ts +29 -0
- package/src/watchdog/settings.js +480 -0
- package/src/watchdog/tool-actions.d.ts +17 -0
- package/src/watchdog/tool-actions.js +150 -0
- package/src/watchdog/turn-delta.d.ts +15 -0
- package/src/watchdog/turn-delta.js +188 -0
- package/src/watchdog/types.d.ts +141 -0
- package/src/watchdog/types.js +27 -0
- package/src/watchdog/warning-format.d.ts +7 -0
- package/src/watchdog/warning-format.js +59 -0
- package/src/workflows/chat-progress.d.ts +37 -0
- package/src/workflows/chat-progress.js +129 -0
- package/src/workflows/host-command.d.ts +30 -0
- package/src/workflows/host-command.js +227 -0
- package/src/workflows/scripted-workflow.d.ts +204 -0
- package/src/workflows/scripted-workflow.js +1673 -0
- package/src/workflows/structured-workflow-scripts.d.ts +10 -0
- package/src/workflows/structured-workflow-scripts.js +179 -0
- package/src/workflows/workflow-auto-resume.d.ts +32 -0
- package/src/workflows/workflow-auto-resume.js +102 -0
- package/src/workflows/workflow-checklist.d.ts +127 -0
- package/src/workflows/workflow-checklist.js +314 -0
- package/src/workflows/workflow-child-summary.d.ts +24 -0
- package/src/workflows/workflow-child-summary.js +195 -0
- package/src/workflows/workflow-launch-record.d.ts +27 -0
- package/src/workflows/workflow-launch-record.js +48 -0
- package/src/workflows/workflow-preflight.d.ts +58 -0
- package/src/workflows/workflow-preflight.js +288 -0
- package/src/workflows/workflow-receipt.d.ts +34 -0
- package/src/workflows/workflow-receipt.js +454 -0
- package/src/workflows/workflow-resources.d.ts +55 -0
- package/src/workflows/workflow-resources.js +271 -0
- package/src/workflows/workflow-resume-claim.d.ts +82 -0
- package/src/workflows/workflow-resume-claim.js +210 -0
- package/src/workflows/workflow-resume.d.ts +56 -0
- package/src/workflows/workflow-resume.js +106 -0
- package/src/workflows/workflow-reuse.d.ts +61 -0
- package/src/workflows/workflow-reuse.js +186 -0
- package/src/workflows/workflow-revival.d.ts +33 -0
- package/src/workflows/workflow-revival.js +111 -0
- package/src/workflows/workflow-settlement.d.ts +84 -0
- package/src/workflows/workflow-settlement.js +203 -0
- package/src/workflows/workflow-stop-cause.d.ts +6 -0
- package/src/workflows/workflow-stop-cause.js +8 -0
- package/workflow-script-worker.cjs +1342 -0
- package/index.ts +0 -18
- package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
- package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
- package/skills/pi-subagents/references/execution-controls.md +0 -561
- package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
- package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
- package/skills/pi-subagents/references/review-and-validation.md +0 -73
- package/src/agents/advertised-agent-prompt.ts +0 -82
- package/src/agents/agent-eject.ts +0 -339
- package/src/agents/agent-management.ts +0 -1442
- package/src/agents/agent-memory.ts +0 -341
- package/src/agents/agent-refinements.ts +0 -624
- package/src/agents/agent-scope.ts +0 -10
- package/src/agents/agent-selection.ts +0 -25
- package/src/agents/agent-serializer.ts +0 -195
- package/src/agents/agents.ts +0 -3169
- package/src/agents/builtin-names.ts +0 -16
- package/src/agents/chain-serializer.ts +0 -285
- package/src/agents/frontmatter.ts +0 -153
- package/src/agents/global-npm-root.ts +0 -58
- package/src/agents/identity.ts +0 -30
- package/src/agents/proactive-skills.ts +0 -197
- package/src/agents/runtime-agent-events.ts +0 -70
- package/src/agents/runtime-agent-registry.ts +0 -457
- package/src/agents/runtime-discovery.ts +0 -39
- package/src/agents/skills.ts +0 -787
- package/src/api/agent-management.ts +0 -9
- package/src/api/agents.ts +0 -19
- package/src/api/background-work.ts +0 -206
- package/src/api/capability-ceiling.ts +0 -16
- package/src/api/child-tool-plan.ts +0 -5
- package/src/api/control-channel.ts +0 -4
- package/src/api/delegation.ts +0 -131
- package/src/api/external-job-provider.ts +0 -195
- package/src/api/external-runs.ts +0 -282
- package/src/api/inspectors.ts +0 -27
- package/src/api/intercom-bridge.ts +0 -3
- package/src/api/preflight.ts +0 -641
- package/src/api/project-panes.ts +0 -32
- package/src/api/required-child-extensions.ts +0 -6
- package/src/api/shared-types.ts +0 -29
- package/src/api/workflow-resources.ts +0 -6
- package/src/extension/config.ts +0 -262
- package/src/extension/context-injection.ts +0 -123
- package/src/extension/control-notices.ts +0 -53
- package/src/extension/declaration-pinning.ts +0 -164
- package/src/extension/doctor.ts +0 -284
- package/src/extension/fanout-child.ts +0 -282
- package/src/extension/herdr-pi-bridge.ts +0 -166
- package/src/extension/index.ts +0 -1185
- package/src/extension/public-execution.ts +0 -262
- package/src/extension/reply-workflow-script.ts +0 -67
- package/src/extension/rpc.ts +0 -881
- package/src/extension/schemas.ts +0 -337
- package/src/extension/steering-notices.ts +0 -35
- package/src/extension/subagent-guide.ts +0 -127
- package/src/extension/subagent-options.ts +0 -47
- package/src/extension/tool-activation.ts +0 -147
- package/src/extension/tool-description.ts +0 -193
- package/src/extension/tool-result.ts +0 -19
- package/src/extension/upgrade-notice.ts +0 -40
- package/src/inspectors/actions.ts +0 -174
- package/src/inspectors/ghostty/actions.ts +0 -74
- package/src/inspectors/ghostty/plugin.ts +0 -29
- package/src/inspectors/herdr/actions.ts +0 -155
- package/src/inspectors/herdr/client.ts +0 -130
- package/src/inspectors/herdr/focus.ts +0 -55
- package/src/inspectors/herdr/plugin.ts +0 -20
- package/src/inspectors/herdr/project-panes.ts +0 -733
- package/src/inspectors/inspector-runner.ts +0 -153
- package/src/inspectors/plugins.ts +0 -76
- package/src/inspectors/session-roots-codec.ts +0 -31
- package/src/inspectors/shell-command.ts +0 -16
- package/src/inspectors/tmux/actions.ts +0 -204
- package/src/inspectors/tmux/client.ts +0 -85
- package/src/inspectors/tmux/plugin.ts +0 -21
- package/src/inspectors/types.ts +0 -51
- package/src/integrations/herdr-status.ts +0 -385
- package/src/integrations/pi-web-session-liveness.ts +0 -73
- package/src/integrations/program-status.ts +0 -215
- package/src/intercom/intercom-bridge.ts +0 -235
- package/src/intercom/native-supervisor-channel.ts +0 -1000
- package/src/intercom/result-intercom.ts +0 -433
- package/src/intercom/supervisor-ui.ts +0 -72
- package/src/missions/actions.ts +0 -433
- package/src/missions/goal-driver.ts +0 -177
- package/src/missions/lifecycle.ts +0 -367
- package/src/missions/store.ts +0 -613
- package/src/missions/types.ts +0 -190
- package/src/missions/workflow-state.ts +0 -281
- package/src/policy/authority.ts +0 -50
- package/src/profiles/profiles.ts +0 -674
- package/src/runs/background/active-async-capacity.ts +0 -548
- package/src/runs/background/active-run-index.ts +0 -155
- package/src/runs/background/async-execution.ts +0 -2479
- package/src/runs/background/async-job-tracker.ts +0 -869
- package/src/runs/background/async-resume.ts +0 -686
- package/src/runs/background/async-retention.ts +0 -953
- package/src/runs/background/async-status-snapshot.ts +0 -46
- package/src/runs/background/async-status.ts +0 -787
- package/src/runs/background/auto-drain.ts +0 -92
- package/src/runs/background/await-async-run.ts +0 -83
- package/src/runs/background/binary-bootstrap.ts +0 -67
- package/src/runs/background/calendar-schedule.ts +0 -90
- package/src/runs/background/chain-append.ts +0 -321
- package/src/runs/background/chain-root-attachment.ts +0 -263
- package/src/runs/background/completion-batcher.ts +0 -168
- package/src/runs/background/completion-dedupe.ts +0 -58
- package/src/runs/background/completion-replay.ts +0 -287
- package/src/runs/background/control-channel.ts +0 -659
- package/src/runs/background/fleet-view.ts +0 -692
- package/src/runs/background/index-segment.ts +0 -59
- package/src/runs/background/inspect-rpc.ts +0 -443
- package/src/runs/background/notify.ts +0 -1083
- package/src/runs/background/owned-process-tree.ts +0 -131
- package/src/runs/background/parallel-groups.ts +0 -45
- package/src/runs/background/pid-namespace.ts +0 -18
- package/src/runs/background/process-terminal-candidate.ts +0 -98
- package/src/runs/background/process-terminal.ts +0 -231
- package/src/runs/background/result-delivery-ownership.ts +0 -45
- package/src/runs/background/result-files.ts +0 -634
- package/src/runs/background/result-watcher.ts +0 -842
- package/src/runs/background/resume-guidance.ts +0 -56
- package/src/runs/background/retained-children.ts +0 -136
- package/src/runs/background/retained-nested-route-tracker.ts +0 -96
- package/src/runs/background/run-child-session.ts +0 -725
- package/src/runs/background/run-id-query.ts +0 -7
- package/src/runs/background/run-id-resolver.ts +0 -183
- package/src/runs/background/run-status.ts +0 -803
- package/src/runs/background/runner-aliases.ts +0 -183
- package/src/runs/background/runner-child-launch.ts +0 -96
- package/src/runs/background/runner-child-sessions.ts +0 -32
- package/src/runs/background/runner-http-dispatcher.ts +0 -122
- package/src/runs/background/runner-startup-failure.ts +0 -56
- package/src/runs/background/scheduled-runs.ts +0 -1222
- package/src/runs/background/stale-run-reconciler.ts +0 -463
- package/src/runs/background/steering.ts +0 -260
- package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
- package/src/runs/background/subagent-runner.ts +0 -5251
- package/src/runs/background/subagent-wait.ts +0 -895
- package/src/runs/background/terminal-run-index.ts +0 -183
- package/src/runs/background/top-level-async.ts +0 -14
- package/src/runs/background/wait-completions.ts +0 -262
- package/src/runs/background/wait-config.ts +0 -50
- package/src/runs/background/wait-subscriptions.ts +0 -354
- package/src/runs/background/wait-tool.ts +0 -57
- package/src/runs/background/workflow-terminal-proof.ts +0 -85
- package/src/runs/foreground/async-dismiss-action.ts +0 -86
- package/src/runs/foreground/async-steering-action.ts +0 -276
- package/src/runs/foreground/async-stop-action.ts +0 -216
- package/src/runs/foreground/command-action.ts +0 -41
- package/src/runs/foreground/execution.ts +0 -2315
- package/src/runs/foreground/foreground-control.ts +0 -157
- package/src/runs/foreground/foreground-history.ts +0 -164
- package/src/runs/foreground/prompt-audit.ts +0 -172
- package/src/runs/foreground/subagent-executor.ts +0 -8227
- package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
- package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
- package/src/runs/shared/abort-recovery.ts +0 -119
- package/src/runs/shared/acceptance.ts +0 -1664
- package/src/runs/shared/agent-contract.ts +0 -38
- package/src/runs/shared/async-status-projection.ts +0 -664
- package/src/runs/shared/background-process-options.ts +0 -9
- package/src/runs/shared/capability-ceiling.ts +0 -214
- package/src/runs/shared/chain-outputs.ts +0 -116
- package/src/runs/shared/child-commands.ts +0 -229
- package/src/runs/shared/child-hooks.ts +0 -175
- package/src/runs/shared/child-identity.ts +0 -62
- package/src/runs/shared/child-launch-plan.ts +0 -163
- package/src/runs/shared/child-launch.ts +0 -389
- package/src/runs/shared/child-lifecycle.ts +0 -28
- package/src/runs/shared/child-runtime-config.ts +0 -136
- package/src/runs/shared/child-session.ts +0 -699
- package/src/runs/shared/child-tool-plan.ts +0 -599
- package/src/runs/shared/claude-code-adapter.ts +0 -288
- package/src/runs/shared/codex-exec-adapter.ts +0 -129
- package/src/runs/shared/context-mode.ts +0 -44
- package/src/runs/shared/cursor-agent-adapter.ts +0 -114
- package/src/runs/shared/dynamic-fanout.ts +0 -297
- package/src/runs/shared/effective-system-prompt.ts +0 -33
- package/src/runs/shared/extension-bindings.ts +0 -103
- package/src/runs/shared/external-cli-contract.ts +0 -177
- package/src/runs/shared/external-cli-preflight.ts +0 -190
- package/src/runs/shared/external-cli-runner.ts +0 -437
- package/src/runs/shared/external-job-bridge.ts +0 -514
- package/src/runs/shared/external-job-runner.ts +0 -389
- package/src/runs/shared/fast-mode-extension.ts +0 -10
- package/src/runs/shared/fork-command-result.ts +0 -10
- package/src/runs/shared/git-environment.ts +0 -29
- package/src/runs/shared/herdr-connection.ts +0 -134
- package/src/runs/shared/herdr-external-adapters.ts +0 -169
- package/src/runs/shared/herdr-machine.ts +0 -279
- package/src/runs/shared/herdr-pi-protocol.ts +0 -59
- package/src/runs/shared/herdr-placed-run.ts +0 -264
- package/src/runs/shared/host-step-status.ts +0 -231
- package/src/runs/shared/lane-metadata.ts +0 -126
- package/src/runs/shared/launch-cwd.ts +0 -16
- package/src/runs/shared/long-running-guard.ts +0 -221
- package/src/runs/shared/mcp-config-sources.ts +0 -426
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
- package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
- package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
- package/src/runs/shared/model-resolution.ts +0 -503
- package/src/runs/shared/model-scope.ts +0 -224
- package/src/runs/shared/mutation-evidence.ts +0 -199
- package/src/runs/shared/nested-events.ts +0 -1125
- package/src/runs/shared/nested-path.ts +0 -38
- package/src/runs/shared/nested-render.ts +0 -127
- package/src/runs/shared/orca-progress-tabs.ts +0 -511
- package/src/runs/shared/parallel-handoff.ts +0 -789
- package/src/runs/shared/parallel-utils.ts +0 -292
- package/src/runs/shared/partial-output.ts +0 -48
- package/src/runs/shared/permissions.ts +0 -86
- package/src/runs/shared/pi-spawn.ts +0 -205
- package/src/runs/shared/process-signal.ts +0 -35
- package/src/runs/shared/profile-extensions.ts +0 -134
- package/src/runs/shared/profile-launch-env.ts +0 -121
- package/src/runs/shared/readonly-drain-observation.ts +0 -42
- package/src/runs/shared/run-fanout-budget.ts +0 -267
- package/src/runs/shared/run-history.ts +0 -288
- package/src/runs/shared/runner-launcher.ts +0 -25
- package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
- package/src/runs/shared/sandbox-profile-guard.ts +0 -119
- package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
- package/src/runs/shared/session-lease.ts +0 -293
- package/src/runs/shared/single-output.ts +0 -366
- package/src/runs/shared/spawn-budget.ts +0 -128
- package/src/runs/shared/structured-output.ts +0 -463
- package/src/runs/shared/subagent-control.ts +0 -295
- package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
- package/src/runs/shared/tool-availability.ts +0 -37
- package/src/runs/shared/tool-budget.ts +0 -87
- package/src/runs/shared/tool-timeout.ts +0 -93
- package/src/runs/shared/usage-budget.ts +0 -65
- package/src/runs/shared/usage-reconciliation.ts +0 -73
- package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
- package/src/runs/shared/workflow-graph.ts +0 -225
- package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
- package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
- package/src/runs/shared/worktree-lock.ts +0 -29
- package/src/runs/shared/worktree-setup-command.ts +0 -213
- package/src/runs/shared/worktree.ts +0 -1554
- package/src/shared/accessible-dir.ts +0 -47
- package/src/shared/agent-stream-options.ts +0 -5
- package/src/shared/artifacts.ts +0 -281
- package/src/shared/atomic-json.ts +0 -85
- package/src/shared/capacity-resilient-json.ts +0 -102
- package/src/shared/child-cache-retention.ts +0 -43
- package/src/shared/child-session-name.ts +0 -48
- package/src/shared/child-transcript.ts +0 -264
- package/src/shared/completion-owner.ts +0 -14
- package/src/shared/disabled-features.ts +0 -123
- package/src/shared/display-text.ts +0 -150
- package/src/shared/edit-distance.ts +0 -33
- package/src/shared/extension-context.ts +0 -37
- package/src/shared/file-coalescer.ts +0 -49
- package/src/shared/file-lease.ts +0 -74
- package/src/shared/file-system-retry.ts +0 -95
- package/src/shared/fork-context.ts +0 -243
- package/src/shared/fork-session-cwd.ts +0 -27
- package/src/shared/formatters.ts +0 -142
- package/src/shared/jsonl-writer.ts +0 -92
- package/src/shared/launch-contract.ts +0 -206
- package/src/shared/model-info.ts +0 -132
- package/src/shared/model-response-aliases.ts +0 -13
- package/src/shared/node-executable.ts +0 -21
- package/src/shared/opencode-session-headers.ts +0 -30
- package/src/shared/package-version.ts +0 -17
- package/src/shared/parent-wake.ts +0 -79
- package/src/shared/permission-profile.ts +0 -56
- package/src/shared/prompt-resources.ts +0 -11
- package/src/shared/pruned-fork.ts +0 -469
- package/src/shared/required-child-extensions.ts +0 -115
- package/src/shared/runtime-module-path.ts +0 -19
- package/src/shared/sandbox-profile.ts +0 -37
- package/src/shared/session-file-trust.ts +0 -19
- package/src/shared/session-identity.ts +0 -10
- package/src/shared/session-tokens.ts +0 -55
- package/src/shared/settings-file-lease.ts +0 -36
- package/src/shared/settings.ts +0 -412
- package/src/shared/shortcuts.ts +0 -13
- package/src/shared/status-format.ts +0 -55
- package/src/shared/thinking-ceiling.ts +0 -46
- package/src/shared/types.ts +0 -3105
- package/src/shared/utf8.ts +0 -11
- package/src/shared/utils.ts +0 -610
- package/src/shared/watch-strategy.ts +0 -12
- package/src/shared/workflow-child-permit.ts +0 -212
- package/src/slash/delegation-adapters.ts +0 -452
- package/src/slash/delegation-json.ts +0 -108
- package/src/slash/delegation-request.ts +0 -176
- package/src/slash/prompt-template-bridge.ts +0 -434
- package/src/slash/prompt-workflows.ts +0 -298
- package/src/slash/selector.ts +0 -147
- package/src/slash/slash-bridge.ts +0 -192
- package/src/slash/slash-commands.ts +0 -1096
- package/src/slash/slash-live-state.ts +0 -310
- package/src/slash/subagent-cost.ts +0 -317
- package/src/slash/subagents-admin.ts +0 -489
- package/src/tui/fleet-native-transcript.ts +0 -424
- package/src/tui/fleet-status.ts +0 -1139
- package/src/tui/fleet-transcript.ts +0 -591
- package/src/tui/fleet.ts +0 -1618
- package/src/tui/mouse-events.ts +0 -42
- package/src/tui/render-helpers.ts +0 -111
- package/src/tui/render.ts +0 -3824
- package/src/tui/running-tone.ts +0 -28
- package/src/tui/subagent-messages.ts +0 -305
- package/src/ui-silent-marker.ts +0 -32
- package/src/watchdog/change-signature.ts +0 -260
- package/src/watchdog/child-status.ts +0 -225
- package/src/watchdog/diff-tool.ts +0 -112
- package/src/watchdog/emission-guard.ts +0 -125
- package/src/watchdog/guidance.ts +0 -20
- package/src/watchdog/lsp-diagnostics.ts +0 -538
- package/src/watchdog/model-selection.ts +0 -187
- package/src/watchdog/permission-arbiter.ts +0 -154
- package/src/watchdog/register-child.ts +0 -136
- package/src/watchdog/register-main.ts +0 -425
- package/src/watchdog/render.ts +0 -31
- package/src/watchdog/review.ts +0 -362
- package/src/watchdog/rules.ts +0 -70
- package/src/watchdog/runtime.ts +0 -927
- package/src/watchdog/scope.ts +0 -51
- package/src/watchdog/settings.ts +0 -520
- package/src/watchdog/tool-actions.ts +0 -156
- package/src/watchdog/turn-delta.ts +0 -190
- package/src/watchdog/types.ts +0 -186
- package/src/watchdog/warning-format.ts +0 -72
- package/src/workflows/chat-progress.ts +0 -152
- package/src/workflows/host-command.ts +0 -235
- package/src/workflows/scripted-workflow.ts +0 -2733
- package/src/workflows/structured-workflow-scripts.ts +0 -177
- package/src/workflows/workflow-checklist.ts +0 -442
- package/src/workflows/workflow-child-summary.ts +0 -172
- package/src/workflows/workflow-preflight.ts +0 -297
- package/src/workflows/workflow-receipt.ts +0 -390
- package/src/workflows/workflow-resources.ts +0 -275
- package/src/workflows/workflow-reuse.ts +0 -120
- package/src/workflows/workflow-revival.ts +0 -123
- package/src/workflows/workflow-settlement.ts +0 -252
|
@@ -0,0 +1,783 @@
|
|
|
1
|
+
import { withHandoffWriteLock, withRepositoryWorktreeLock } from "./worktree-lock.js";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
import { writeAtomicJson } from "../../shared/atomic-json.js";
|
|
5
|
+
import { stableJsonDigest } from "../../shared/launch-contract.js";
|
|
6
|
+
import { cleanupWorktrees, withWorktreeTransaction } from "./worktree.js";
|
|
7
|
+
import { assertWorkflowLaneKey, normalizeWorkflowLaneMetadata } from "./lane-metadata.js";
|
|
8
|
+
function optionalIdentity(value, label) {
|
|
9
|
+
if (value === undefined)
|
|
10
|
+
return undefined;
|
|
11
|
+
if (typeof value !== "string" || !value.trim())
|
|
12
|
+
throw new Error(`${label} must be a non-empty string.`);
|
|
13
|
+
return value.trim();
|
|
14
|
+
}
|
|
15
|
+
function nonNegativeIndex(value, label) {
|
|
16
|
+
if (!Number.isSafeInteger(value) || value < 0)
|
|
17
|
+
throw new Error(`${label} must be a non-negative integer.`);
|
|
18
|
+
return value;
|
|
19
|
+
}
|
|
20
|
+
function normalizeLaneBinding(value, label) {
|
|
21
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
22
|
+
throw new Error(`${label} must be an object.`);
|
|
23
|
+
const binding = value;
|
|
24
|
+
const unknown = Object.keys(binding).filter((field) => !["index", "taskIndex", "workflowKey", "runId", "lane"].includes(field));
|
|
25
|
+
if (unknown.length > 0)
|
|
26
|
+
throw new Error(`${label} has unsupported fields: ${unknown.join(", ")}.`);
|
|
27
|
+
const index = nonNegativeIndex(binding.index, `${label}.index`);
|
|
28
|
+
const taskIndex = nonNegativeIndex(binding.taskIndex, `${label}.taskIndex`);
|
|
29
|
+
const workflowKey = optionalIdentity(binding.workflowKey, `${label}.workflowKey`);
|
|
30
|
+
const runId = optionalIdentity(binding.runId, `${label}.runId`);
|
|
31
|
+
const lane = normalizeWorkflowLaneMetadata(binding.lane, `${label}.lane`);
|
|
32
|
+
assertWorkflowLaneKey(lane, workflowKey, `${label}.lane`);
|
|
33
|
+
return {
|
|
34
|
+
index,
|
|
35
|
+
taskIndex,
|
|
36
|
+
...(workflowKey ? { workflowKey } : {}),
|
|
37
|
+
...(runId ? { runId } : {}),
|
|
38
|
+
...(lane ? { lane } : {}),
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
function validateManifestIdentity(parsed, manifestPath) {
|
|
42
|
+
if (parsed.version !== 1 || !Array.isArray(parsed.groups)) {
|
|
43
|
+
throw new Error(`Invalid parallel handoff manifest: ${manifestPath}`);
|
|
44
|
+
}
|
|
45
|
+
if (typeof parsed.runId !== "string" || !parsed.runId.trim())
|
|
46
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': runId must be a non-empty string.`);
|
|
47
|
+
parsed.runId = parsed.runId.trim();
|
|
48
|
+
const workflowKeys = new Set();
|
|
49
|
+
const childRunIds = new Set();
|
|
50
|
+
const childIndexes = new Set();
|
|
51
|
+
for (const [groupIndex, group] of parsed.groups.entries()) {
|
|
52
|
+
if (!group || typeof group !== "object" || !Array.isArray(group.children) || !group.cleanup || !Array.isArray(group.cleanup.tasks))
|
|
53
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}] is malformed.`);
|
|
54
|
+
if (group.laneBindings !== undefined) {
|
|
55
|
+
if (!Array.isArray(group.laneBindings))
|
|
56
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].laneBindings must be an array.`);
|
|
57
|
+
const taskIndexes = new Set();
|
|
58
|
+
const cleanupIndexes = new Set(group.cleanup.tasks.map((task) => task.index));
|
|
59
|
+
group.laneBindings = group.laneBindings.map((binding, bindingIndex) => {
|
|
60
|
+
const normalized = normalizeLaneBinding(binding, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].laneBindings[${bindingIndex}]`);
|
|
61
|
+
if (taskIndexes.has(normalized.taskIndex))
|
|
62
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}] has duplicate lane binding taskIndex ${normalized.taskIndex}.`);
|
|
63
|
+
if (!cleanupIndexes.has(normalized.taskIndex))
|
|
64
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].laneBindings[${bindingIndex}] has no cleanup task for taskIndex ${normalized.taskIndex}.`);
|
|
65
|
+
taskIndexes.add(normalized.taskIndex);
|
|
66
|
+
return normalized;
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
const taskIndexes = new Set();
|
|
70
|
+
for (const [childIndex, child] of group.children.entries()) {
|
|
71
|
+
if (!child || typeof child !== "object" || !child.patch || typeof child.patch !== "object")
|
|
72
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}] is malformed.`);
|
|
73
|
+
const childRecord = child;
|
|
74
|
+
const index = nonNegativeIndex(childRecord.index, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].index`);
|
|
75
|
+
const taskIndex = nonNegativeIndex(childRecord.taskIndex, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].taskIndex`);
|
|
76
|
+
if (taskIndexes.has(taskIndex))
|
|
77
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}] has duplicate child taskIndex ${taskIndex}.`);
|
|
78
|
+
taskIndexes.add(taskIndex);
|
|
79
|
+
if (childIndexes.has(index))
|
|
80
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': duplicate child index ${index}.`);
|
|
81
|
+
childIndexes.add(index);
|
|
82
|
+
if (!group.cleanup.tasks.some((task) => task.index === taskIndex))
|
|
83
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}] has no cleanup task for taskIndex ${taskIndex}.`);
|
|
84
|
+
const workflowKey = optionalIdentity(childRecord.workflowKey, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].workflowKey`);
|
|
85
|
+
const runId = optionalIdentity(childRecord.runId, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].runId`);
|
|
86
|
+
const lane = normalizeWorkflowLaneMetadata(childRecord.lane, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].lane`);
|
|
87
|
+
assertWorkflowLaneKey(lane, workflowKey, `Invalid parallel handoff manifest '${manifestPath}': groups[${groupIndex}].children[${childIndex}].lane`);
|
|
88
|
+
if (workflowKey && workflowKeys.has(workflowKey))
|
|
89
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': duplicate workflow key '${workflowKey}'.`);
|
|
90
|
+
if (workflowKey)
|
|
91
|
+
workflowKeys.add(workflowKey);
|
|
92
|
+
if (runId && childRunIds.has(runId))
|
|
93
|
+
throw new Error(`Invalid parallel handoff manifest '${manifestPath}': duplicate child run id '${runId}'.`);
|
|
94
|
+
if (runId)
|
|
95
|
+
childRunIds.add(runId);
|
|
96
|
+
if (lane)
|
|
97
|
+
childRecord.lane = lane;
|
|
98
|
+
if (workflowKey)
|
|
99
|
+
childRecord.workflowKey = workflowKey;
|
|
100
|
+
if (runId)
|
|
101
|
+
childRecord.runId = runId;
|
|
102
|
+
childRecord.index = index;
|
|
103
|
+
childRecord.taskIndex = taskIndex;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
return parsed;
|
|
107
|
+
}
|
|
108
|
+
export function readParallelHandoffManifest(manifestPath) {
|
|
109
|
+
if (!fs.existsSync(manifestPath))
|
|
110
|
+
return undefined;
|
|
111
|
+
const parsed = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
|
|
112
|
+
return validateManifestIdentity(parsed, manifestPath);
|
|
113
|
+
}
|
|
114
|
+
export function resolveParallelHandoffChild(input) {
|
|
115
|
+
const manifest = readParallelHandoffManifest(input.manifestPath);
|
|
116
|
+
if (!manifest)
|
|
117
|
+
return undefined;
|
|
118
|
+
if (manifest.runId !== input.runId)
|
|
119
|
+
throw new Error(`Managed worktree handoff belongs to run '${manifest.runId}', not '${input.runId}'.`);
|
|
120
|
+
const workflowKey = input.workflowKey?.trim() || undefined;
|
|
121
|
+
const childRunId = input.childRunId?.trim() || undefined;
|
|
122
|
+
if (!workflowKey && !childRunId)
|
|
123
|
+
throw new Error("Parallel handoff child resolution requires workflowKey or childRunId.");
|
|
124
|
+
const matches = manifest.groups.flatMap((group) => group.children.map((child) => ({ group, child }))).filter(({ child }) => {
|
|
125
|
+
if (workflowKey && child.workflowKey !== workflowKey)
|
|
126
|
+
return false;
|
|
127
|
+
if (childRunId && child.runId !== childRunId)
|
|
128
|
+
return false;
|
|
129
|
+
return true;
|
|
130
|
+
});
|
|
131
|
+
if (matches.length > 1)
|
|
132
|
+
throw new Error(`Parallel handoff has multiple children matching workflow identity${workflowKey ? ` '${workflowKey}'` : ` '${childRunId}'`}.`);
|
|
133
|
+
return matches[0];
|
|
134
|
+
}
|
|
135
|
+
function resolveExistingPath(candidate) {
|
|
136
|
+
try {
|
|
137
|
+
return fs.realpathSync(candidate);
|
|
138
|
+
}
|
|
139
|
+
catch {
|
|
140
|
+
return path.resolve(candidate);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
function pathInside(root, candidate) {
|
|
144
|
+
const relative = path.relative(root, candidate);
|
|
145
|
+
return relative === "" || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
|
|
146
|
+
}
|
|
147
|
+
export async function protectRetainedWorktreeForResume(manifestPath, runId, childIndex, signal) {
|
|
148
|
+
const original = readParallelHandoffManifest(manifestPath);
|
|
149
|
+
const group = original?.groups.find((item) => item.children.some((child) => child.index === childIndex));
|
|
150
|
+
if (!group)
|
|
151
|
+
throw new Error("Retained worktree handoff disappeared before resume admission.");
|
|
152
|
+
return withWorktreeTransaction(() => withRepositoryWorktreeLock(group.repoRoot, () => withHandoffWriteLock(manifestPath, () => {
|
|
153
|
+
signal?.throwIfAborted();
|
|
154
|
+
const cwd = resolveRetainedWorktreeCwd(manifestPath, runId, childIndex);
|
|
155
|
+
if (!cwd)
|
|
156
|
+
throw new Error("Retained worktree ownership disappeared before resume admission.");
|
|
157
|
+
const manifest = readParallelHandoffManifest(manifestPath);
|
|
158
|
+
const currentGroup = manifest.groups.find((item) => item.children.some((child) => child.index === childIndex));
|
|
159
|
+
const child = currentGroup.children.find((item) => item.index === childIndex);
|
|
160
|
+
const task = currentGroup.cleanup.tasks.find((item) => item.index === child.taskIndex);
|
|
161
|
+
task.preserved = true;
|
|
162
|
+
task.reason = "retained child resume requires managed worktree cwd";
|
|
163
|
+
manifest.updatedAt = Date.now();
|
|
164
|
+
writeAtomicJson(manifestPath, manifest);
|
|
165
|
+
return cwd;
|
|
166
|
+
}), { signal }));
|
|
167
|
+
}
|
|
168
|
+
export function resolveRetainedWorktreeCwd(manifestPath, runId, childIndex, recordedWorktreePath) {
|
|
169
|
+
const manifest = readParallelHandoffManifest(manifestPath);
|
|
170
|
+
if (manifest && manifest.runId !== runId)
|
|
171
|
+
throw new Error(`Managed worktree handoff belongs to run '${manifest.runId}', not '${runId}'.`);
|
|
172
|
+
const match = manifest?.groups
|
|
173
|
+
.flatMap((group) => group.children.map((child) => ({ group, child })))
|
|
174
|
+
.find(({ child }) => child.index === childIndex);
|
|
175
|
+
if (!manifest || !match) {
|
|
176
|
+
if (recordedWorktreePath)
|
|
177
|
+
throw new Error(`Async run '${runId}' child ${childIndex} ran in managed worktree ${recordedWorktreePath}, but its handoff has no resumable record yet. Retry after the run settles; if it already ended, inspect ${manifestPath}.`);
|
|
178
|
+
return undefined;
|
|
179
|
+
}
|
|
180
|
+
const cleanup = match.group.cleanup.tasks.find((task) => task.index === match.child.taskIndex);
|
|
181
|
+
if (!cleanup)
|
|
182
|
+
throw new Error(`Async run '${runId}' child ${childIndex} has no managed worktree cleanup record.`);
|
|
183
|
+
const relativeCwd = path.relative(resolveExistingPath(match.group.repoRoot), resolveExistingPath(manifest.cwd));
|
|
184
|
+
if (path.isAbsolute(relativeCwd) || relativeCwd === ".." || relativeCwd.startsWith(`..${path.sep}`))
|
|
185
|
+
throw new Error(`Async run '${runId}' has an invalid managed worktree cwd.`);
|
|
186
|
+
const requiredCwd = path.join(cleanup.path, relativeCwd);
|
|
187
|
+
if (cleanup.worktreeRemoved || cleanup.branchRemoved)
|
|
188
|
+
throw new Error(`Async run '${runId}' required managed worktree was removed: ${requiredCwd}`);
|
|
189
|
+
// The runner removes the worktree right after this marker, without the locks that guard resume admission.
|
|
190
|
+
if (cleanup.reason?.includes("pending durable handoff capture"))
|
|
191
|
+
throw new Error(`Async run '${runId}' child ${childIndex} is still finalizing its managed worktree: ${requiredCwd}. Retry after the run settles; if it already ended, inspect ${manifestPath}.`);
|
|
192
|
+
let worktreeRoot = "";
|
|
193
|
+
let resolvedRequiredCwd = "";
|
|
194
|
+
try {
|
|
195
|
+
const rootStat = fs.lstatSync(cleanup.path);
|
|
196
|
+
if (!rootStat.isDirectory() || rootStat.isSymbolicLink())
|
|
197
|
+
throw new Error("worktree root is not a directory");
|
|
198
|
+
worktreeRoot = fs.realpathSync(cleanup.path);
|
|
199
|
+
if (!fs.statSync(requiredCwd).isDirectory())
|
|
200
|
+
throw new Error("path is not a directory");
|
|
201
|
+
resolvedRequiredCwd = fs.realpathSync(requiredCwd);
|
|
202
|
+
}
|
|
203
|
+
catch (error) {
|
|
204
|
+
throw new Error(`Async run '${runId}' required managed worktree cwd is missing: ${requiredCwd}`, { cause: error instanceof Error ? error : undefined });
|
|
205
|
+
}
|
|
206
|
+
if (!pathInside(worktreeRoot, resolvedRequiredCwd))
|
|
207
|
+
throw new Error(`Async run '${runId}' has an invalid managed worktree cwd.`);
|
|
208
|
+
return requiredCwd;
|
|
209
|
+
}
|
|
210
|
+
function referenceFor(manifestPath, manifest) {
|
|
211
|
+
const children = manifest.groups.flatMap((group) => group.children);
|
|
212
|
+
return {
|
|
213
|
+
version: 1,
|
|
214
|
+
path: manifestPath,
|
|
215
|
+
groupCount: manifest.groups.length,
|
|
216
|
+
childCount: children.length,
|
|
217
|
+
changedPatches: children.filter((child) => child.patch.changed).length,
|
|
218
|
+
cleanupState: manifest.groups.every((group) => group.cleanup.state === "complete") ? "complete" : "partial",
|
|
219
|
+
...(Object.prototype.hasOwnProperty.call(manifest, "cleanupEligibility")
|
|
220
|
+
? { cleanupEligibility: trustedStoredCleanupEligibility(manifest) }
|
|
221
|
+
: {}),
|
|
222
|
+
};
|
|
223
|
+
}
|
|
224
|
+
const COMMIT_PATTERN = /^[0-9a-f]{40}$/i;
|
|
225
|
+
const MANIFEST_DIGEST_PATTERN = /^[0-9a-f]{64}$/i;
|
|
226
|
+
const MAX_ATTESTATION_ACTOR_LENGTH = 128;
|
|
227
|
+
const MAX_ATTESTATION_TIMESTAMP_LENGTH = 64;
|
|
228
|
+
const MAX_SUPERSESSION_ID_LENGTH = 128;
|
|
229
|
+
function boundedString(value, label, maxBytes) {
|
|
230
|
+
if (typeof value !== "string" || !value.trim())
|
|
231
|
+
throw new Error(`${label} must be a non-empty string.`);
|
|
232
|
+
const normalized = value.trim();
|
|
233
|
+
if (normalized.includes("\n") || normalized.includes("\r"))
|
|
234
|
+
throw new Error(`${label} must not contain newlines.`);
|
|
235
|
+
if (Buffer.byteLength(normalized, "utf-8") > maxBytes)
|
|
236
|
+
throw new Error(`${label} must be at most ${maxBytes} bytes.`);
|
|
237
|
+
return normalized;
|
|
238
|
+
}
|
|
239
|
+
function commitString(value, label) {
|
|
240
|
+
const normalized = boundedString(value, label, 64).toLowerCase();
|
|
241
|
+
if (!COMMIT_PATTERN.test(normalized))
|
|
242
|
+
throw new Error(`${label} must be a full 40-character commit SHA.`);
|
|
243
|
+
return normalized;
|
|
244
|
+
}
|
|
245
|
+
function manifestDigestString(value, label) {
|
|
246
|
+
const normalized = boundedString(value, label, 64).toLowerCase();
|
|
247
|
+
if (!MANIFEST_DIGEST_PATTERN.test(normalized))
|
|
248
|
+
throw new Error(`${label} must be a full 64-character SHA-256 digest.`);
|
|
249
|
+
return normalized;
|
|
250
|
+
}
|
|
251
|
+
function manifestFactsDigest(manifest) {
|
|
252
|
+
return stableJsonDigest({
|
|
253
|
+
version: manifest.version,
|
|
254
|
+
runId: manifest.runId,
|
|
255
|
+
mode: manifest.mode,
|
|
256
|
+
source: manifest.source,
|
|
257
|
+
cwd: manifest.cwd,
|
|
258
|
+
groups: manifest.groups,
|
|
259
|
+
});
|
|
260
|
+
}
|
|
261
|
+
function attestationTimestamp(value) {
|
|
262
|
+
const normalized = boundedString(value, "attestedAt", MAX_ATTESTATION_TIMESTAMP_LENGTH);
|
|
263
|
+
if (!Number.isFinite(Date.parse(normalized)))
|
|
264
|
+
throw new Error("attestedAt must be a valid timestamp.");
|
|
265
|
+
return normalized;
|
|
266
|
+
}
|
|
267
|
+
function normalizeMergeEvidence(value) {
|
|
268
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
269
|
+
throw new Error("merge must be an object.");
|
|
270
|
+
const merge = value;
|
|
271
|
+
const prNumber = merge.prNumber;
|
|
272
|
+
if (typeof prNumber !== "number" || !Number.isInteger(prNumber) || prNumber < 1)
|
|
273
|
+
throw new Error("merge.prNumber must be a positive integer.");
|
|
274
|
+
const treeEquivalent = merge.treeEquivalent;
|
|
275
|
+
if (treeEquivalent !== true && treeEquivalent !== false && treeEquivalent !== "unknown")
|
|
276
|
+
throw new Error("merge.treeEquivalent must be true, false, or 'unknown'.");
|
|
277
|
+
const postMergeChecks = merge.postMergeChecks;
|
|
278
|
+
if (postMergeChecks !== "recorded" && postMergeChecks !== "unknown")
|
|
279
|
+
throw new Error("merge.postMergeChecks must be 'recorded' or 'unknown'.");
|
|
280
|
+
return {
|
|
281
|
+
prNumber,
|
|
282
|
+
reviewedHead: commitString(merge.reviewedHead, "merge.reviewedHead"),
|
|
283
|
+
mergeCommit: commitString(merge.mergeCommit, "merge.mergeCommit"),
|
|
284
|
+
treeEquivalent,
|
|
285
|
+
postMergeChecks,
|
|
286
|
+
attestedBy: boundedString(merge.attestedBy, "merge.attestedBy", MAX_ATTESTATION_ACTOR_LENGTH),
|
|
287
|
+
attestedAt: attestationTimestamp(merge.attestedAt),
|
|
288
|
+
...(merge.manifestDigest === undefined ? {} : { manifestDigest: manifestDigestString(merge.manifestDigest, "merge.manifestDigest") }),
|
|
289
|
+
};
|
|
290
|
+
}
|
|
291
|
+
function normalizeSupersessionEvidence(value) {
|
|
292
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
293
|
+
throw new Error("supersession must be an object.");
|
|
294
|
+
const supersession = value;
|
|
295
|
+
return {
|
|
296
|
+
supersededBy: boundedString(supersession.supersededBy, "supersession.supersededBy", MAX_SUPERSESSION_ID_LENGTH),
|
|
297
|
+
attestedBy: boundedString(supersession.attestedBy, "supersession.attestedBy", MAX_ATTESTATION_ACTOR_LENGTH),
|
|
298
|
+
attestedAt: attestationTimestamp(supersession.attestedAt),
|
|
299
|
+
...(supersession.manifestDigest === undefined ? {} : { manifestDigest: manifestDigestString(supersession.manifestDigest, "supersession.manifestDigest") }),
|
|
300
|
+
};
|
|
301
|
+
}
|
|
302
|
+
function normalizeStoredCleanupEligibility(value) {
|
|
303
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
304
|
+
return { state: "unknown" };
|
|
305
|
+
const eligibility = value;
|
|
306
|
+
if (eligibility.state === "active" || eligibility.state === "terminal-eligible" || eligibility.state === "superseded-eligible" || eligibility.state === "unknown") {
|
|
307
|
+
return { state: eligibility.state };
|
|
308
|
+
}
|
|
309
|
+
if (eligibility.state === "terminal-blocked" && typeof eligibility.reason === "string" && eligibility.reason.trim() && !eligibility.reason.includes("\n") && !eligibility.reason.includes("\r")) {
|
|
310
|
+
return { state: "terminal-blocked", reason: eligibility.reason.trim().slice(0, 256) };
|
|
311
|
+
}
|
|
312
|
+
return { state: "unknown" };
|
|
313
|
+
}
|
|
314
|
+
const STORED_CHILD_STATUSES = new Set(["pending", "running", "completed", "complete", "failed", "paused", "stopped", "detached", "rejected"]);
|
|
315
|
+
export function isTerminalParallelHandoffChildStatus(status) {
|
|
316
|
+
return status === "completed" || status === "complete" || status === "failed" || status === "paused" || status === "stopped" || status === "rejected";
|
|
317
|
+
}
|
|
318
|
+
function hasValidStoredLaneShape(manifest) {
|
|
319
|
+
if (!manifest || typeof manifest !== "object" || manifest.version !== 1 || typeof manifest.runId !== "string" || !manifest.runId.trim() || !Array.isArray(manifest.groups) || manifest.groups.length === 0)
|
|
320
|
+
return false;
|
|
321
|
+
let hasManagedTask = false;
|
|
322
|
+
const valid = manifest.groups.every((group) => {
|
|
323
|
+
if (!group || typeof group !== "object" || typeof group.baseCommit !== "string" || !group.baseCommit.trim() || typeof group.repoRoot !== "string" || !group.repoRoot.trim())
|
|
324
|
+
return false;
|
|
325
|
+
const cleanup = group.cleanup;
|
|
326
|
+
if (!cleanup || typeof cleanup !== "object" || (cleanup.state !== "complete" && cleanup.state !== "partial") || !Array.isArray(cleanup.tasks) || !Array.isArray(group.children))
|
|
327
|
+
return false;
|
|
328
|
+
if (cleanup.tasks.some((task) => !task || typeof task !== "object" || !Number.isSafeInteger(task.index) || task.index < 0 || typeof task.path !== "string" || !task.path.trim() || typeof task.branch !== "string" || !task.branch.trim()))
|
|
329
|
+
return false;
|
|
330
|
+
if (cleanup.tasks.length > 0)
|
|
331
|
+
hasManagedTask = true;
|
|
332
|
+
return group.children.every((child) => Boolean(child) && typeof child === "object" && typeof child.status === "string" && STORED_CHILD_STATUSES.has(child.status));
|
|
333
|
+
});
|
|
334
|
+
return valid && hasManagedTask;
|
|
335
|
+
}
|
|
336
|
+
function trustedStoredCleanupEligibility(manifest) {
|
|
337
|
+
const eligibility = normalizeStoredCleanupEligibility(manifest.cleanupEligibility);
|
|
338
|
+
if (!hasValidStoredLaneShape(manifest))
|
|
339
|
+
return { state: "unknown" };
|
|
340
|
+
if (hasActiveChildren(manifest))
|
|
341
|
+
return { state: "active" };
|
|
342
|
+
if (eligibility.state === "active")
|
|
343
|
+
return cleanupEligibilityForEvidence(manifest);
|
|
344
|
+
if (eligibility.state === "terminal-eligible" || eligibility.state === "superseded-eligible") {
|
|
345
|
+
const current = cleanupEligibilityForEvidence(manifest);
|
|
346
|
+
if (current.state === eligibility.state || (current.state === "terminal-blocked" && / evidence is stale$/.test(current.reason)))
|
|
347
|
+
return current;
|
|
348
|
+
return { state: "unknown" };
|
|
349
|
+
}
|
|
350
|
+
return eligibility;
|
|
351
|
+
}
|
|
352
|
+
function hasActiveChildren(manifest) {
|
|
353
|
+
return Array.isArray(manifest.groups) && manifest.groups.some((group) => {
|
|
354
|
+
if (!group || typeof group !== "object")
|
|
355
|
+
return false;
|
|
356
|
+
const children = Array.isArray(group.children) ? group.children : [];
|
|
357
|
+
if (children.length === 0 && Array.isArray(group.cleanup?.tasks) && group.cleanup.tasks.length > 0)
|
|
358
|
+
return true;
|
|
359
|
+
return children.some((child) => !child || typeof child !== "object" || !isTerminalParallelHandoffChildStatus(child.status));
|
|
360
|
+
});
|
|
361
|
+
}
|
|
362
|
+
function hasManagedWorktreeTasks(manifest) {
|
|
363
|
+
return manifest.groups.length > 0 && manifest.groups.some((group) => Array.isArray(group.cleanup?.tasks) && group.cleanup.tasks.length > 0);
|
|
364
|
+
}
|
|
365
|
+
function validateManifestForLaneEvidence(manifest, laneId) {
|
|
366
|
+
if (manifest.runId !== laneId)
|
|
367
|
+
throw new Error(`Lane '${laneId}' does not match manifest run '${manifest.runId}'.`);
|
|
368
|
+
if (!hasValidStoredLaneShape(manifest))
|
|
369
|
+
throw new Error("Lane manifest is malformed.");
|
|
370
|
+
if (!manifest.groups.length || !hasManagedWorktreeTasks(manifest))
|
|
371
|
+
throw new Error("Lane manifest has no managed worktree tasks.");
|
|
372
|
+
if (hasActiveChildren(manifest))
|
|
373
|
+
throw new Error("Lane has an active child owner; merge evidence must be recorded after local reconciliation.");
|
|
374
|
+
for (const group of manifest.groups) {
|
|
375
|
+
if (typeof group.repoRoot !== "string" || !group.repoRoot.trim())
|
|
376
|
+
throw new Error("Lane manifest has no valid repository root.");
|
|
377
|
+
if (group.cleanup.state !== "complete" && group.cleanup.state !== "partial")
|
|
378
|
+
throw new Error("Lane manifest has an invalid cleanup state.");
|
|
379
|
+
if (!Array.isArray(group.cleanup.tasks) || group.cleanup.tasks.some((task) => typeof task.path !== "string" || !task.path.trim() || typeof task.branch !== "string" || !task.branch.trim())) {
|
|
380
|
+
throw new Error("Lane manifest has an invalid cleanup task.");
|
|
381
|
+
}
|
|
382
|
+
if (!Array.isArray(group.children))
|
|
383
|
+
throw new Error("Lane manifest has invalid child records.");
|
|
384
|
+
for (const child of group.children) {
|
|
385
|
+
if (!STORED_CHILD_STATUSES.has(child.status)) {
|
|
386
|
+
throw new Error("Lane manifest has an invalid child status.");
|
|
387
|
+
}
|
|
388
|
+
}
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
function cleanupEligibilityForEvidence(manifest) {
|
|
392
|
+
if (hasActiveChildren(manifest))
|
|
393
|
+
return { state: "active" };
|
|
394
|
+
let merge;
|
|
395
|
+
if (manifest.merge) {
|
|
396
|
+
try {
|
|
397
|
+
merge = normalizeMergeEvidence(manifest.merge);
|
|
398
|
+
}
|
|
399
|
+
catch {
|
|
400
|
+
return { state: "terminal-blocked", reason: "stored merge evidence is invalid" };
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
if (manifest.supersession) {
|
|
404
|
+
try {
|
|
405
|
+
const supersession = normalizeSupersessionEvidence(manifest.supersession);
|
|
406
|
+
if (supersession.manifestDigest !== manifestFactsDigest(manifest))
|
|
407
|
+
return { state: "terminal-blocked", reason: "stored supersession evidence is stale" };
|
|
408
|
+
}
|
|
409
|
+
catch {
|
|
410
|
+
return { state: "terminal-blocked", reason: "stored supersession evidence is invalid" };
|
|
411
|
+
}
|
|
412
|
+
return { state: "superseded-eligible" };
|
|
413
|
+
}
|
|
414
|
+
if (!merge)
|
|
415
|
+
return { state: "terminal-blocked", reason: "no merge or supersession evidence recorded" };
|
|
416
|
+
if (merge.manifestDigest !== manifestFactsDigest(manifest))
|
|
417
|
+
return { state: "terminal-blocked", reason: "stored merge evidence is stale" };
|
|
418
|
+
if (merge.treeEquivalent !== true) {
|
|
419
|
+
return { state: "terminal-blocked", reason: merge.treeEquivalent === "unknown" ? "merged tree equivalence was not attested" : "merged tree is not equivalent to the reviewed head" };
|
|
420
|
+
}
|
|
421
|
+
if (merge.postMergeChecks !== "recorded")
|
|
422
|
+
return { state: "terminal-blocked", reason: "required post-merge checks were not recorded" };
|
|
423
|
+
return { state: "terminal-eligible" };
|
|
424
|
+
}
|
|
425
|
+
function sameMergeEvidence(left, right) {
|
|
426
|
+
return left.prNumber === right.prNumber
|
|
427
|
+
&& left.reviewedHead === right.reviewedHead
|
|
428
|
+
&& left.mergeCommit === right.mergeCommit
|
|
429
|
+
&& left.treeEquivalent === right.treeEquivalent
|
|
430
|
+
&& left.postMergeChecks === right.postMergeChecks
|
|
431
|
+
&& left.attestedBy === right.attestedBy
|
|
432
|
+
&& left.attestedAt === right.attestedAt;
|
|
433
|
+
}
|
|
434
|
+
function sameSupersessionEvidence(left, right) {
|
|
435
|
+
return left.supersededBy === right.supersededBy && left.attestedBy === right.attestedBy && left.attestedAt === right.attestedAt;
|
|
436
|
+
}
|
|
437
|
+
function firstRepositoryRoot(manifest) {
|
|
438
|
+
const repoRoot = Array.isArray(manifest.groups) ? manifest.groups[0]?.repoRoot : undefined;
|
|
439
|
+
return typeof repoRoot === "string" && repoRoot.trim() ? repoRoot.trim() : undefined;
|
|
440
|
+
}
|
|
441
|
+
function formatCleanupCommand(manifestPath, manifest) {
|
|
442
|
+
const repoRoot = firstRepositoryRoot(manifest);
|
|
443
|
+
return repoRoot ? `subagent({ action: "worktree.cleanup", options: { repo: ${JSON.stringify(repoRoot)}, handoffPath: ${JSON.stringify(manifestPath)}, mode: "plan" } })` : undefined;
|
|
444
|
+
}
|
|
445
|
+
export function formatStoredParallelHandoffCleanup(manifestPath, manifest) {
|
|
446
|
+
let stored = manifest;
|
|
447
|
+
if (!stored) {
|
|
448
|
+
try {
|
|
449
|
+
stored = readParallelHandoffManifest(manifestPath);
|
|
450
|
+
}
|
|
451
|
+
catch {
|
|
452
|
+
stored = undefined;
|
|
453
|
+
}
|
|
454
|
+
}
|
|
455
|
+
if (!stored)
|
|
456
|
+
return ["Cleanup eligibility: unknown", "Reason: lane manifest is missing or invalid; removal is not safe.", `Plan command: subagent({ action: "worktree.cleanup", options: { handoffPath: ${JSON.stringify(manifestPath)}, mode: "plan" } })`].join("\n");
|
|
457
|
+
const eligibility = trustedStoredCleanupEligibility(stored);
|
|
458
|
+
const lines = [`Cleanup eligibility: ${eligibility.state}`];
|
|
459
|
+
if (eligibility.state === "terminal-blocked")
|
|
460
|
+
lines.push(`Reason: ${eligibility.reason}`);
|
|
461
|
+
if (eligibility.state === "unknown")
|
|
462
|
+
lines.push("Reason: stored eligibility is missing or invalid; removal is not safe.");
|
|
463
|
+
if (eligibility.state === "active")
|
|
464
|
+
lines.push("Reason: a child owner is still active; removal is not safe.");
|
|
465
|
+
const command = formatCleanupCommand(manifestPath, stored);
|
|
466
|
+
if (command)
|
|
467
|
+
lines.push(`Plan command: ${command}`);
|
|
468
|
+
return lines.join("\n");
|
|
469
|
+
}
|
|
470
|
+
export function recordParallelHandoffMerge(...args) {
|
|
471
|
+
return withHandoffWriteLock(args[0].manifestPath, () => recordParallelHandoffMergeUnlocked(...args));
|
|
472
|
+
}
|
|
473
|
+
function recordParallelHandoffMergeUnlocked(input) {
|
|
474
|
+
const manifest = readParallelHandoffManifest(input.manifestPath);
|
|
475
|
+
if (!manifest)
|
|
476
|
+
throw new Error(`Parallel handoff manifest not found: ${input.manifestPath}`);
|
|
477
|
+
validateManifestForLaneEvidence(manifest, boundedString(input.laneId, "laneId", MAX_SUPERSESSION_ID_LENGTH));
|
|
478
|
+
if (hasActiveChildren(manifest))
|
|
479
|
+
throw new Error("Lane has an active child owner; merge evidence must be recorded after local reconciliation.");
|
|
480
|
+
const merge = { ...normalizeMergeEvidence(input.merge), manifestDigest: manifestFactsDigest(manifest) };
|
|
481
|
+
if (manifest.merge) {
|
|
482
|
+
const existing = normalizeMergeEvidence(manifest.merge);
|
|
483
|
+
if (existing.reviewedHead !== merge.reviewedHead)
|
|
484
|
+
throw new Error(`Lane manifest is stale: reviewed head is already recorded as ${existing.reviewedHead}.`);
|
|
485
|
+
if (!sameMergeEvidence(existing, merge))
|
|
486
|
+
throw new Error("Lane manifest already contains different merge evidence for this reviewed head.");
|
|
487
|
+
}
|
|
488
|
+
const reconciled = { ...manifest, merge };
|
|
489
|
+
delete reconciled.supersession;
|
|
490
|
+
const updated = { ...reconciled, cleanupEligibility: cleanupEligibilityForEvidence(reconciled), updatedAt: input.now ?? Date.now() };
|
|
491
|
+
writeAtomicJson(input.manifestPath, updated);
|
|
492
|
+
return { manifest: updated, reference: referenceFor(input.manifestPath, updated), text: formatStoredParallelHandoffCleanup(input.manifestPath, updated) };
|
|
493
|
+
}
|
|
494
|
+
export function recordParallelHandoffSupersession(...args) {
|
|
495
|
+
return withHandoffWriteLock(args[0].manifestPath, () => recordParallelHandoffSupersessionUnlocked(...args));
|
|
496
|
+
}
|
|
497
|
+
function recordParallelHandoffSupersessionUnlocked(input) {
|
|
498
|
+
const manifest = readParallelHandoffManifest(input.manifestPath);
|
|
499
|
+
if (!manifest)
|
|
500
|
+
throw new Error(`Parallel handoff manifest not found: ${input.manifestPath}`);
|
|
501
|
+
const laneId = boundedString(input.laneId, "laneId", MAX_SUPERSESSION_ID_LENGTH);
|
|
502
|
+
validateManifestForLaneEvidence(manifest, laneId);
|
|
503
|
+
if (hasActiveChildren(manifest))
|
|
504
|
+
throw new Error("Lane has an active child owner; supersession must be recorded after local reconciliation.");
|
|
505
|
+
const supersession = { ...normalizeSupersessionEvidence(input.supersession), manifestDigest: manifestFactsDigest(manifest) };
|
|
506
|
+
if (supersession.supersededBy === laneId)
|
|
507
|
+
throw new Error("supersession.supersededBy must identify a different replacement lane.");
|
|
508
|
+
if (manifest.supersession) {
|
|
509
|
+
const existing = normalizeSupersessionEvidence(manifest.supersession);
|
|
510
|
+
if (!sameSupersessionEvidence(existing, supersession))
|
|
511
|
+
throw new Error("Lane manifest already contains different supersession evidence.");
|
|
512
|
+
}
|
|
513
|
+
const updated = { ...manifest, supersession, cleanupEligibility: cleanupEligibilityForEvidence({ ...manifest, supersession }), updatedAt: input.now ?? Date.now() };
|
|
514
|
+
writeAtomicJson(input.manifestPath, updated);
|
|
515
|
+
return { manifest: updated, reference: referenceFor(input.manifestPath, updated), text: formatStoredParallelHandoffCleanup(input.manifestPath, updated) };
|
|
516
|
+
}
|
|
517
|
+
function safeHandoffAgentName(agent) {
|
|
518
|
+
return agent.replace(/[^\w.-]/g, "_");
|
|
519
|
+
}
|
|
520
|
+
function missingDiff(input) {
|
|
521
|
+
const patchPath = path.join(path.dirname(input.manifestPath), `missing-diff-step-${input.stepIndex}-task-${input.taskIndex}-${safeHandoffAgentName(input.agent)}.patch`);
|
|
522
|
+
try {
|
|
523
|
+
fs.mkdirSync(path.dirname(patchPath), { recursive: true });
|
|
524
|
+
fs.writeFileSync(patchPath, "", "utf-8");
|
|
525
|
+
}
|
|
526
|
+
catch {
|
|
527
|
+
// Handoff records the artifact failure below; patch creation remains best-effort.
|
|
528
|
+
}
|
|
529
|
+
return {
|
|
530
|
+
index: input.taskIndex,
|
|
531
|
+
agent: input.agent,
|
|
532
|
+
branch: input.branch ?? "",
|
|
533
|
+
diffStat: "",
|
|
534
|
+
filesChanged: 0,
|
|
535
|
+
insertions: 0,
|
|
536
|
+
deletions: 0,
|
|
537
|
+
patchPath,
|
|
538
|
+
error: "diff artifact unavailable; no patch was captured",
|
|
539
|
+
};
|
|
540
|
+
}
|
|
541
|
+
export function writeParallelHandoffGroup(...args) {
|
|
542
|
+
return withHandoffWriteLock(args[0].manifestPath, () => writeParallelHandoffGroupUnlocked(...args));
|
|
543
|
+
}
|
|
544
|
+
function writeParallelHandoffGroupUnlocked(input) {
|
|
545
|
+
const now = input.now ?? Date.now();
|
|
546
|
+
const existing = readParallelHandoffManifest(input.manifestPath);
|
|
547
|
+
if (existing && (existing.runId !== input.runId || existing.mode !== input.mode || existing.source !== input.source)) {
|
|
548
|
+
throw new Error(`Parallel handoff manifest belongs to a different run: ${input.manifestPath}`);
|
|
549
|
+
}
|
|
550
|
+
const laneBindings = input.laneBindings?.map((binding, index) => normalizeLaneBinding(binding, `parallel handoff lane binding ${index}`));
|
|
551
|
+
if (laneBindings) {
|
|
552
|
+
const taskIndexes = new Set();
|
|
553
|
+
for (const binding of laneBindings) {
|
|
554
|
+
if (taskIndexes.has(binding.taskIndex))
|
|
555
|
+
throw new Error(`Parallel handoff has duplicate lane binding taskIndex ${binding.taskIndex}.`);
|
|
556
|
+
if (!input.setup.worktrees.some((worktree) => worktree.index === binding.taskIndex))
|
|
557
|
+
throw new Error(`Parallel handoff lane binding taskIndex ${binding.taskIndex} has no managed worktree.`);
|
|
558
|
+
if (binding.index !== input.flatStartIndex + binding.taskIndex)
|
|
559
|
+
throw new Error(`Parallel handoff lane binding index ${binding.index} does not match taskIndex ${binding.taskIndex}.`);
|
|
560
|
+
taskIndexes.add(binding.taskIndex);
|
|
561
|
+
}
|
|
562
|
+
}
|
|
563
|
+
const bindingForTask = (taskIndex) => laneBindings?.find((binding) => binding.taskIndex === taskIndex);
|
|
564
|
+
const group = {
|
|
565
|
+
stepIndex: input.stepIndex,
|
|
566
|
+
baseCommit: input.setup.baseCommit,
|
|
567
|
+
repoRoot: input.setup.cwd,
|
|
568
|
+
children: input.results.map((result, taskIndex) => {
|
|
569
|
+
const binding = bindingForTask(taskIndex);
|
|
570
|
+
const runId = optionalIdentity(result.runId ?? binding?.runId, `parallel handoff child ${taskIndex}.runId`);
|
|
571
|
+
const lane = normalizeWorkflowLaneMetadata(result.lane ?? binding?.lane, `parallel handoff child ${taskIndex}.lane`);
|
|
572
|
+
const workflowKey = optionalIdentity(result.workflowKey ?? binding?.workflowKey, `parallel handoff child ${taskIndex}.workflowKey`);
|
|
573
|
+
assertWorkflowLaneKey(lane, workflowKey, `parallel handoff child ${taskIndex}.lane`);
|
|
574
|
+
const diff = input.diffs[taskIndex] ?? missingDiff({
|
|
575
|
+
manifestPath: input.manifestPath,
|
|
576
|
+
stepIndex: input.stepIndex,
|
|
577
|
+
taskIndex,
|
|
578
|
+
agent: result.agent,
|
|
579
|
+
branch: input.setup.worktrees[taskIndex]?.branch,
|
|
580
|
+
});
|
|
581
|
+
return {
|
|
582
|
+
index: input.flatStartIndex + taskIndex,
|
|
583
|
+
taskIndex,
|
|
584
|
+
agent: result.agent,
|
|
585
|
+
...(workflowKey ? { workflowKey } : {}),
|
|
586
|
+
...(runId ? { runId } : {}),
|
|
587
|
+
...(lane ? { lane } : {}),
|
|
588
|
+
status: result.status,
|
|
589
|
+
summary: result.summary,
|
|
590
|
+
...(result.outputPath ? { outputPath: result.outputPath } : {}),
|
|
591
|
+
...(result.structuredOutput !== undefined ? { structuredOutput: result.structuredOutput } : {}),
|
|
592
|
+
...(result.structuredOutputPath ? { structuredOutputPath: result.structuredOutputPath } : {}),
|
|
593
|
+
...(result.sessionPath ? { sessionPath: result.sessionPath } : {}),
|
|
594
|
+
patch: {
|
|
595
|
+
path: diff.patchPath,
|
|
596
|
+
branch: diff.branch,
|
|
597
|
+
changed: diff.filesChanged > 0 || diff.insertions > 0 || diff.deletions > 0 || diff.diffStat.trim().length > 0,
|
|
598
|
+
diffStat: diff.diffStat,
|
|
599
|
+
filesChanged: diff.filesChanged,
|
|
600
|
+
insertions: diff.insertions,
|
|
601
|
+
deletions: diff.deletions,
|
|
602
|
+
...(diff.error ? { error: diff.error } : {}),
|
|
603
|
+
},
|
|
604
|
+
};
|
|
605
|
+
}),
|
|
606
|
+
...(laneBindings && laneBindings.length > 0 && input.results.length === 0 ? { laneBindings } : {}),
|
|
607
|
+
cleanup: input.cleanup ?? {
|
|
608
|
+
state: "partial",
|
|
609
|
+
pruned: false,
|
|
610
|
+
tasks: input.setup.worktrees.map((worktree) => ({
|
|
611
|
+
index: worktree.index,
|
|
612
|
+
path: worktree.path,
|
|
613
|
+
branch: worktree.branch,
|
|
614
|
+
...(worktree.provider ? { provider: worktree.provider } : {}),
|
|
615
|
+
...(worktree.naming ? { naming: worktree.naming } : {}),
|
|
616
|
+
...(worktree.recordedBaseDir ? { recordedBaseDir: worktree.recordedBaseDir } : {}),
|
|
617
|
+
worktreeRemoved: false,
|
|
618
|
+
branchRemoved: false,
|
|
619
|
+
preserved: true,
|
|
620
|
+
reason: "cleanup pending durable handoff capture",
|
|
621
|
+
})),
|
|
622
|
+
},
|
|
623
|
+
};
|
|
624
|
+
for (const task of group.cleanup.tasks) {
|
|
625
|
+
const previous = existing?.groups.flatMap((item) => item.cleanup.tasks).find((item) => item.path === task.path && item.branch === task.branch);
|
|
626
|
+
if (previous?.worktreeRemoved)
|
|
627
|
+
task.worktreeRemoved = true;
|
|
628
|
+
if (previous?.branchRemoved)
|
|
629
|
+
task.branchRemoved = true;
|
|
630
|
+
if (!task.worktreeRemoved && previous?.reason?.includes("retained child resume")) {
|
|
631
|
+
task.preserved = true;
|
|
632
|
+
task.reason = previous.reason;
|
|
633
|
+
}
|
|
634
|
+
}
|
|
635
|
+
const groups = existing?.groups.filter((candidate) => candidate.stepIndex !== input.stepIndex) ?? [];
|
|
636
|
+
groups.push(group);
|
|
637
|
+
groups.sort((left, right) => left.stepIndex - right.stepIndex);
|
|
638
|
+
const manifestWithoutEligibility = {
|
|
639
|
+
version: 1,
|
|
640
|
+
runId: input.runId,
|
|
641
|
+
mode: input.mode,
|
|
642
|
+
source: input.source,
|
|
643
|
+
cwd: input.cwd,
|
|
644
|
+
createdAt: existing?.createdAt ?? now,
|
|
645
|
+
updatedAt: now,
|
|
646
|
+
groups,
|
|
647
|
+
...(existing && Object.hasOwn(existing, "merge") ? { merge: existing.merge } : {}),
|
|
648
|
+
...(existing && Object.hasOwn(existing, "supersession") ? { supersession: existing.supersession } : {}),
|
|
649
|
+
};
|
|
650
|
+
const carriesCleanupMetadata = existing !== undefined
|
|
651
|
+
&& (Object.hasOwn(existing, "merge") || Object.hasOwn(existing, "supersession") || Object.hasOwn(existing, "cleanupEligibility"));
|
|
652
|
+
const manifest = {
|
|
653
|
+
...manifestWithoutEligibility,
|
|
654
|
+
...(carriesCleanupMetadata
|
|
655
|
+
? { cleanupEligibility: cleanupEligibilityForEvidence(manifestWithoutEligibility) }
|
|
656
|
+
: {}),
|
|
657
|
+
};
|
|
658
|
+
writeAtomicJson(input.manifestPath, manifest);
|
|
659
|
+
return referenceFor(input.manifestPath, manifest);
|
|
660
|
+
}
|
|
661
|
+
export function parallelHandoffPath(baseDir, runId) {
|
|
662
|
+
return runId ? path.join(baseDir, "handoffs", `${runId}.json`) : path.join(baseDir, "handoff.json");
|
|
663
|
+
}
|
|
664
|
+
/** Synchronous onProgress projection shared by setup owners; snapshots are cumulative. */
|
|
665
|
+
export function writeWorktreeSetupHandoff(input) {
|
|
666
|
+
const { progress, ...handoff } = input;
|
|
667
|
+
const { setup, attempts, cleanup } = progress;
|
|
668
|
+
// Preflight has no allocation identity yet. Its original error belongs to the caller.
|
|
669
|
+
if (attempts.length === 0 && setup.worktrees.length === 0)
|
|
670
|
+
return undefined;
|
|
671
|
+
if (!setup.cwd || !setup.baseCommit)
|
|
672
|
+
throw new Error("Cannot publish worktree allocation evidence without repository and base commit.");
|
|
673
|
+
const diagnostic = (text) => text.slice(0, 512);
|
|
674
|
+
// Never copy argv, environment, Error objects or captured stdout/stderr into artifacts.
|
|
675
|
+
const commandEvidence = (command) => command && ({
|
|
676
|
+
pid: command.pid,
|
|
677
|
+
processGroupId: command.processGroupId,
|
|
678
|
+
...(command.result ? {
|
|
679
|
+
status: command.result.status,
|
|
680
|
+
signal: command.result.signal,
|
|
681
|
+
failed: Boolean(command.result.error),
|
|
682
|
+
outputIncomplete: command.result.outputIncomplete,
|
|
683
|
+
processTree: command.result.processTree?.state,
|
|
684
|
+
} : {}),
|
|
685
|
+
});
|
|
686
|
+
const errors = [
|
|
687
|
+
`Worktree setup ${JSON.stringify({ runId: input.runId, stepIndex: input.stepIndex, phase: progress.phase,
|
|
688
|
+
unknown: Boolean(progress.unknown), command: commandEvidence(progress.command) })}`,
|
|
689
|
+
...attempts.map((attempt) => {
|
|
690
|
+
const task = cleanup?.tasks.find((candidate) => candidate.index === attempt.index);
|
|
691
|
+
return `Allocation attempt ${JSON.stringify({ index: attempt.index, branch: attempt.branch,
|
|
692
|
+
path: attempt.path ?? null, validated: attempt.validated,
|
|
693
|
+
command: commandEvidence(attempt.command), hookCommand: commandEvidence(attempt.hookCommand),
|
|
694
|
+
...(task ? { worktreeRemoved: task.worktreeRemoved, branchRemoved: task.branchRemoved,
|
|
695
|
+
preserved: task.preserved, reason: task.reason && diagnostic(task.reason), errors: task.errors?.map(diagnostic) } : {}),
|
|
696
|
+
})}`;
|
|
697
|
+
}),
|
|
698
|
+
...(cleanup?.errors?.map(diagnostic) ?? []),
|
|
699
|
+
...(progress.unknown ? ["Setup settlement unknown; manual reconciliation required."] : []),
|
|
700
|
+
];
|
|
701
|
+
return writeParallelHandoffGroup({
|
|
702
|
+
...handoff, setup, diffs: [], results: [],
|
|
703
|
+
laneBindings: input.laneBindings?.filter((binding) => setup.worktrees.some((worktree) => worktree.index === binding.taskIndex)),
|
|
704
|
+
cleanup: {
|
|
705
|
+
state: cleanup?.state ?? "partial",
|
|
706
|
+
pruned: cleanup?.pruned ?? false,
|
|
707
|
+
errors,
|
|
708
|
+
// An attempted native path is not a validated recovery task, even during rollback.
|
|
709
|
+
tasks: setup.worktrees.map((worktree) => {
|
|
710
|
+
const task = cleanup?.tasks.find((candidate) => candidate.index === worktree.index);
|
|
711
|
+
return task ? { ...task, reason: task.reason && diagnostic(task.reason), errors: task.errors?.map(diagnostic) } : {
|
|
712
|
+
index: worktree.index, path: worktree.path, branch: worktree.branch,
|
|
713
|
+
provider: worktree.provider, naming: worktree.naming, recordedBaseDir: worktree.recordedBaseDir,
|
|
714
|
+
worktreeRemoved: false, branchRemoved: false, preserved: true,
|
|
715
|
+
reason: "setup pending durable handoff capture",
|
|
716
|
+
};
|
|
717
|
+
}),
|
|
718
|
+
},
|
|
719
|
+
});
|
|
720
|
+
}
|
|
721
|
+
export function formatParallelHandoffReference(reference) {
|
|
722
|
+
return `Worktree handoff: ${reference.path} (${reference.childCount} children, ${reference.changedPatches} changed patches, cleanup ${reference.cleanupState})`;
|
|
723
|
+
}
|
|
724
|
+
export function formatParallelHandoffError(error) {
|
|
725
|
+
return `Worktree handoff unavailable: ${error instanceof Error ? error.message : String(error)}`;
|
|
726
|
+
}
|
|
727
|
+
export function discardPreservedWorktrees(...args) {
|
|
728
|
+
return withHandoffWriteLock(args[0], () => discardPreservedWorktreesUnlocked(...args));
|
|
729
|
+
}
|
|
730
|
+
function discardPreservedWorktreesUnlocked(manifestPath, authorization) {
|
|
731
|
+
const resolvedPath = path.resolve(manifestPath);
|
|
732
|
+
const manifest = readParallelHandoffManifest(resolvedPath);
|
|
733
|
+
if (!manifest)
|
|
734
|
+
throw new Error(`Parallel handoff manifest not found: ${resolvedPath}`);
|
|
735
|
+
let attempted = 0;
|
|
736
|
+
for (const group of manifest.groups) {
|
|
737
|
+
const pending = group.cleanup.tasks.filter((task) => task.preserved && (!task.worktreeRemoved || !task.branchRemoved));
|
|
738
|
+
if (pending.length === 0)
|
|
739
|
+
continue;
|
|
740
|
+
attempted += pending.length;
|
|
741
|
+
const report = cleanupWorktrees({
|
|
742
|
+
cwd: group.repoRoot,
|
|
743
|
+
baseCommit: group.baseCommit,
|
|
744
|
+
worktrees: pending.map((task) => ({
|
|
745
|
+
path: task.path,
|
|
746
|
+
agentCwd: task.path,
|
|
747
|
+
branch: task.branch,
|
|
748
|
+
...(task.provider ? { provider: task.provider } : {}),
|
|
749
|
+
...(task.naming ? { naming: task.naming } : {}),
|
|
750
|
+
...(task.recordedBaseDir ? { recordedBaseDir: task.recordedBaseDir } : {}),
|
|
751
|
+
index: task.index,
|
|
752
|
+
nodeModulesLinked: false,
|
|
753
|
+
syntheticPaths: [],
|
|
754
|
+
})),
|
|
755
|
+
}, { kind: "discard", authorization });
|
|
756
|
+
const updates = new Map(report.tasks.map((task) => [task.index, task.worktreeRemoved && task.branchRemoved
|
|
757
|
+
? task
|
|
758
|
+
: { ...task, preserved: true, reason: task.reason ?? "discard cleanup remains incomplete" }]));
|
|
759
|
+
group.cleanup = {
|
|
760
|
+
state: group.cleanup.tasks.every((task) => {
|
|
761
|
+
const next = updates.get(task.index) ?? task;
|
|
762
|
+
return next.worktreeRemoved && next.branchRemoved;
|
|
763
|
+
}) && report.pruned ? "complete" : "partial",
|
|
764
|
+
tasks: group.cleanup.tasks.map((task) => updates.get(task.index) ?? task),
|
|
765
|
+
pruned: report.pruned,
|
|
766
|
+
...(report.errors ? { errors: report.errors } : {}),
|
|
767
|
+
};
|
|
768
|
+
}
|
|
769
|
+
manifest.updatedAt = Date.now();
|
|
770
|
+
writeAtomicJson(resolvedPath, manifest);
|
|
771
|
+
const remaining = manifest.groups.flatMap((group) => group.cleanup.tasks.map((task) => ({ group, task })))
|
|
772
|
+
.filter(({ task }) => task.preserved && (!task.worktreeRemoved || !task.branchRemoved));
|
|
773
|
+
const lines = attempted === 0
|
|
774
|
+
? [`No preserved worktrees remain in ${resolvedPath}.`]
|
|
775
|
+
: [`Discard processed ${attempted} preserved worktree${attempted === 1 ? "" : "s"}.`, `Manifest: ${resolvedPath}`];
|
|
776
|
+
if (remaining.length > 0) {
|
|
777
|
+
lines.push("", "Some worktrees remain. Inspect and remove them manually if appropriate:");
|
|
778
|
+
for (const { group, task } of remaining) {
|
|
779
|
+
lines.push(` git -C ${JSON.stringify(group.repoRoot)} status --short`, ` git -C ${JSON.stringify(group.repoRoot)} worktree remove --force ${JSON.stringify(task.path)}`, ` git -C ${JSON.stringify(group.repoRoot)} branch -D ${JSON.stringify(task.branch)}`);
|
|
780
|
+
}
|
|
781
|
+
}
|
|
782
|
+
return { manifest, text: lines.join("\n") };
|
|
783
|
+
}
|