@chankov/agent-fleet 2.0.6 → 2.0.7
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/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +11 -0
- package/.pi/harnesses/damage-control-continue/index.ts +5 -0
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
- package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
- package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
- package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.7/.pi/extensions/package.json +9 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.7/.version +1 -0
- package/.versions/2.0.7/agents/architect.md +25 -0
- package/.versions/2.0.7/agents/bowser.md +28 -0
- package/.versions/2.0.7/agents/builder.md +56 -0
- package/.versions/2.0.7/agents/code-reviewer.md +210 -0
- package/.versions/2.0.7/agents/deep-researcher.md +33 -0
- package/.versions/2.0.7/agents/documenter.md +23 -0
- package/.versions/2.0.7/agents/orchestrator.md +23 -0
- package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.7/agents/planner.md +106 -0
- package/.versions/2.0.7/agents/releaser.md +25 -0
- package/.versions/2.0.7/agents/researcher.md +31 -0
- package/.versions/2.0.7/agents/security-auditor.md +168 -0
- package/.versions/2.0.7/agents/test-engineer.md +154 -0
- package/.versions/2.0.7/agents/web-debugger.md +44 -0
- package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
- package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
- package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
- package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.7/docs/getting-started.md +126 -0
- package/.versions/2.0.7/docs/npm-install.md +327 -0
- package/.versions/2.0.7/docs/pi-extensions.md +446 -0
- package/.versions/2.0.7/docs/pi-setup.md +76 -0
- package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.7/hermes/README.md +347 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.7/install-manifest.json +2886 -0
- package/.versions/2.0.7/justfile +247 -0
- package/.versions/2.0.7/manifest-meta.json +958 -0
- package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.7/references/communication-contract.md +26 -0
- package/.versions/2.0.7/references/definition-of-done.md +67 -0
- package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.7/references/observability-checklist.md +91 -0
- package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.7/references/performance-checklist.md +153 -0
- package/.versions/2.0.7/references/prompting-patterns.md +380 -0
- package/.versions/2.0.7/references/security-checklist.md +179 -0
- package/.versions/2.0.7/references/testing-patterns.md +236 -0
- package/.versions/2.0.7/references/workflow-authoring.md +304 -0
- package/.versions/2.0.7/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.7/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.7/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.7/scripts/fleet-codex-read.py +146 -0
- package/.versions/2.0.7/scripts/fleet.ts +216 -0
- package/.versions/2.0.7/scripts/flow.ts +137 -0
- package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.7/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.7/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.7/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.7/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.7/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.7/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.7/scripts/package-lock.json +35 -0
- package/.versions/2.0.7/scripts/package.json +9 -0
- package/.versions/2.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.7/scripts/peer-launch.ts +285 -0
- package/.versions/2.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.7/scripts/team-up.ts +378 -0
- package/.versions/2.0.7/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.7/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.7/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.7/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.7/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +8 -0
- package/README.md +14 -7
- package/bin/cli.js +149 -78
- package/bin/lib/apply.js +53 -62
- package/bin/lib/features.js +2 -2
- package/bin/lib/public-plan.js +17 -0
- package/bin/lib/purge.js +9 -3
- package/bin/lib/reconcile.js +4 -10
- package/bin/lib/repair-desired.js +73 -0
- package/bin/lib/stt-wizard.js +25 -11
- package/bin/lib/transaction.js +118 -108
- package/bin/lib/tui.js +70 -65
- package/bin/lib/update-notifier.js +2 -2
- package/bin/lib/workspace-safety.js +72 -0
- package/docs/npm-install.md +41 -15
- package/docs/pi-extensions.md +3 -3
- package/docs/pi-setup.md +2 -2
- package/install-manifest.json +1 -39
- package/justfile +3 -3
- package/manifest-meta.json +2 -20
- package/package.json +2 -2
- package/scripts/fleet.ts +1 -1
- package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
- package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
package/bin/lib/transaction.js
CHANGED
|
@@ -1,42 +1,26 @@
|
|
|
1
|
-
// transaction.js — crash-recoverable managed workspace commits.
|
|
2
|
-
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import { dirname, join, resolve, relative, sep } from "node:path";
|
|
1
|
+
// transaction.js — durable, crash-recoverable managed workspace commits.
|
|
2
|
+
import { closeSync, cpSync, existsSync, fsyncSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, statSync, writeSync } from "node:fs";
|
|
3
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
4
|
+
import { dirname, join } from "node:path";
|
|
6
5
|
import { STATE_REL_PATH, LEGACY_RECORD_REL_PATH } from "./state.js";
|
|
6
|
+
import { acquireWorkspaceLock, assertSafeWorkspaceTarget, ownedRelativePath } from "./workspace-safety.js";
|
|
7
7
|
|
|
8
8
|
export const JOURNAL_REL_PATH = ".ai/agent-fleet-transaction.json";
|
|
9
|
+
export const RECOVERY_REL_PATH = ".ai/.agent-fleet-recovery";
|
|
9
10
|
const DESIRED_REL_PATH = ".ai/agent-fleet.json";
|
|
10
11
|
const OVERRIDES_REL_PATH = ".ai/agent-fleet-overrides.md";
|
|
11
12
|
const STT_REL_PATH = ".ai/stt.json";
|
|
12
|
-
|
|
13
13
|
export function journalPath(workspace) { return join(workspace, JOURNAL_REL_PATH); }
|
|
14
14
|
|
|
15
|
-
function relativeOwnedPath(workspace, path) {
|
|
16
|
-
const rel = relative(workspace, resolve(workspace, path));
|
|
17
|
-
if (!rel || rel === ".." || rel.startsWith(`..${sep}`) || rel.split(sep).includes("..")) {
|
|
18
|
-
throw new Error(`transaction path is outside the workspace: ${path}`);
|
|
19
|
-
}
|
|
20
|
-
return rel;
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
// Never snapshot the workspace root or a broad target directory: a transaction
|
|
24
|
-
// owns only the exact files its plan can alter. This deliberately leaves .git,
|
|
25
|
-
// foreign files, and concurrently-created siblings untouched.
|
|
26
15
|
function sourceLeaves(path) {
|
|
27
16
|
if (!statSync(path).isDirectory()) return [""];
|
|
28
|
-
|
|
29
|
-
for (const entry of readdirSync(path, { withFileTypes: true })) {
|
|
30
|
-
const child = join(path, entry.name);
|
|
31
|
-
for (const leaf of sourceLeaves(child)) leaves.push(join(entry.name, leaf));
|
|
32
|
-
}
|
|
33
|
-
return leaves;
|
|
17
|
+
return readdirSync(path, { withFileTypes: true }).flatMap((entry) => sourceLeaves(join(path, entry.name)).map((leaf) => join(entry.name, leaf)));
|
|
34
18
|
}
|
|
35
19
|
|
|
36
|
-
function touchedPaths(plan, manifest) {
|
|
20
|
+
export function touchedPaths(plan, manifest) {
|
|
37
21
|
const paths = new Set([STATE_REL_PATH, LEGACY_RECORD_REL_PATH]);
|
|
38
22
|
const catalogue = new Map((manifest?.items ?? []).map((item) => [item.id, item]));
|
|
39
|
-
for (const action of plan
|
|
23
|
+
for (const action of plan?.actions ?? []) {
|
|
40
24
|
for (const file of action.files ?? []) if (file.path) paths.add(file.path);
|
|
41
25
|
for (const path of action.paths ?? []) if (path) paths.add(path);
|
|
42
26
|
const binding = catalogue.get(action.id)?.agents?.[plan.agent];
|
|
@@ -45,118 +29,144 @@ function touchedPaths(plan, manifest) {
|
|
|
45
29
|
for (const rel of binding.source ?? []) {
|
|
46
30
|
const source = join(plan.sourceRoot, rel);
|
|
47
31
|
if (!existsSync(source)) continue;
|
|
48
|
-
if (binding.strategy === "copy-tree" && statSync(source).isDirectory())
|
|
49
|
-
|
|
50
|
-
} else {
|
|
51
|
-
paths.add(rel);
|
|
52
|
-
}
|
|
32
|
+
if (binding.strategy === "copy-tree" && statSync(source).isDirectory()) for (const leaf of sourceLeaves(source)) paths.add(join(rel, leaf));
|
|
33
|
+
else paths.add(rel);
|
|
53
34
|
}
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
if (binding.strategy === "copy-tree" && source) {
|
|
59
|
-
for (const leaf of sourceLeaves(source)) paths.add(join(binding.target, leaf));
|
|
60
|
-
} else {
|
|
61
|
-
paths.add(binding.target);
|
|
35
|
+
} else if (binding.target) {
|
|
36
|
+
const source = (binding.source ?? []).map((path) => join(plan.sourceRoot, path)).find(existsSync);
|
|
37
|
+
if (binding.strategy === "copy-tree" && source) for (const leaf of sourceLeaves(source)) paths.add(join(binding.target, leaf));
|
|
38
|
+
else paths.add(binding.target);
|
|
62
39
|
}
|
|
63
40
|
}
|
|
64
|
-
if (plan
|
|
65
|
-
if (plan
|
|
66
|
-
if (plan
|
|
67
|
-
if (plan
|
|
68
|
-
|
|
41
|
+
if (plan?.writeDesired) paths.add(ownedRelativePath(plan.workspace, plan.desiredPath ?? DESIRED_REL_PATH));
|
|
42
|
+
if (plan?.overrides?.write) paths.add(ownedRelativePath(plan.workspace, plan.overrides.path ?? OVERRIDES_REL_PATH));
|
|
43
|
+
if (plan?.stt?.write) paths.add(ownedRelativePath(plan.workspace, plan.stt.path ?? STT_REL_PATH));
|
|
44
|
+
if (plan?.stt?.env?.missing?.length) paths.add(ownedRelativePath(plan.workspace, plan.stt.env.path));
|
|
45
|
+
const collapseManagedLink = (value) => {
|
|
46
|
+
const rel = ownedRelativePath(plan.workspace, value); const parts = rel.split(/[/\\]/); let cursor = plan.workspace;
|
|
47
|
+
for (let i = 0; i < parts.length - 1; i++) { cursor = join(cursor, parts[i]); if (existsSync(cursor) && lstatSync(cursor).isSymbolicLink()) return parts.slice(0, i + 1).join("/"); }
|
|
48
|
+
return rel;
|
|
49
|
+
};
|
|
50
|
+
return [...new Set([...paths].map(collapseManagedLink))].sort();
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function fingerprint(path) {
|
|
54
|
+
if (!existsSync(path)) return "absent";
|
|
55
|
+
const stat = lstatSync(path);
|
|
56
|
+
if (stat.isSymbolicLink()) return `link:${readlinkSync(path)}`;
|
|
57
|
+
if (stat.isDirectory()) return `dir:${readdirSync(path).sort().join("\0")}`;
|
|
58
|
+
return `file:${createHash("sha256").update(readFileSync(path)).digest("hex")}:${stat.mode & 0o777}`;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export function capturePlanFingerprints(plan, manifest) {
|
|
62
|
+
return Object.fromEntries(touchedPaths(plan, manifest).map((rel) => [rel, fingerprint(join(plan.workspace, rel))]));
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export function assertPlanFingerprints(plan, manifest) {
|
|
66
|
+
if (!plan.fingerprints) return;
|
|
67
|
+
for (const [rel, expected] of Object.entries(plan.fingerprints)) {
|
|
68
|
+
assertSafeWorkspaceTarget(plan.workspace, rel);
|
|
69
|
+
if (fingerprint(join(plan.workspace, rel)) !== expected) throw new Error(`workspace changed since preview: ${rel}; re-run setup`);
|
|
70
|
+
}
|
|
69
71
|
}
|
|
70
72
|
|
|
73
|
+
function fsyncPath(path) {
|
|
74
|
+
const fd = openSync(path, "r");
|
|
75
|
+
try { fsyncSync(fd); } finally { closeSync(fd); }
|
|
76
|
+
}
|
|
77
|
+
function durableJson(path, value) {
|
|
78
|
+
const temp = `${path}.tmp-${process.pid}`;
|
|
79
|
+
const fd = openSync(temp, "wx", 0o600);
|
|
80
|
+
try { writeSync(fd, JSON.stringify(value, null, 2) + "\n"); fsyncSync(fd); } finally { closeSync(fd); }
|
|
81
|
+
renameSync(temp, path);
|
|
82
|
+
// Persist the directory entry after the atomic replacement.
|
|
83
|
+
fsyncPath(dirname(path));
|
|
84
|
+
}
|
|
85
|
+
function validateJournal(workspace, value) {
|
|
86
|
+
if (!value || value.schemaVersion !== 3 || !["prepared", "applying", "committed"].includes(value.phase)) throw new Error("transaction journal schema or phase is invalid");
|
|
87
|
+
if (!Array.isArray(value.paths) || !Array.isArray(value.present) || !value.paths.every((x) => typeof x === "string") || !value.present.every((x) => value.paths.includes(x))) throw new Error("transaction journal paths are invalid");
|
|
88
|
+
value.paths = value.paths.map((rel) => ownedRelativePath(workspace, rel, "journal path"));
|
|
89
|
+
value.present = value.present.map((rel) => ownedRelativePath(workspace, rel, "journal present path"));
|
|
90
|
+
value.backup = ownedRelativePath(workspace, value.backup, "journal backup");
|
|
91
|
+
if (!value.backup.startsWith(`${RECOVERY_REL_PATH}/`) && value.backup !== RECOVERY_REL_PATH) throw new Error("transaction backup is not installer-owned");
|
|
92
|
+
for (const rel of value.paths) assertSafeWorkspaceTarget(workspace, rel);
|
|
93
|
+
assertSafeWorkspaceTarget(workspace, value.backup, { allowLeafSymlink: false });
|
|
94
|
+
return value;
|
|
95
|
+
}
|
|
71
96
|
function backupTouchedPaths(workspace, paths) {
|
|
72
|
-
const
|
|
97
|
+
const rootRel = join(RECOVERY_REL_PATH, randomUUID());
|
|
98
|
+
const backupRel = join(rootRel, "backup");
|
|
99
|
+
const backup = assertSafeWorkspaceTarget(workspace, backupRel, { allowLeafSymlink: false });
|
|
73
100
|
mkdirSync(backup, { recursive: true });
|
|
74
101
|
const present = [];
|
|
75
102
|
for (const rel of paths) {
|
|
103
|
+
assertSafeWorkspaceTarget(workspace, rel);
|
|
76
104
|
const source = join(workspace, rel);
|
|
77
105
|
if (!existsSync(source)) continue;
|
|
78
|
-
const destination = join(backup, rel);
|
|
79
|
-
|
|
80
|
-
cpSync(source, destination, { recursive: true, dereference: false });
|
|
81
|
-
present.push(rel);
|
|
106
|
+
const destination = join(backup, rel); mkdirSync(dirname(destination), { recursive: true });
|
|
107
|
+
cpSync(source, destination, { recursive: true, dereference: false }); present.push(rel);
|
|
82
108
|
}
|
|
83
|
-
|
|
109
|
+
// Durably materialize every regular backup leaf and the recovery directory metadata.
|
|
110
|
+
const syncTree = (path) => { for (const entry of readdirSync(path, { withFileTypes: true })) { const child = join(path, entry.name); if (entry.isDirectory()) syncTree(child); else if (!entry.isSymbolicLink()) fsyncPath(child); } fsyncPath(path); };
|
|
111
|
+
syncTree(join(workspace, rootRel));
|
|
112
|
+
return { backup: backupRel, present, rootRel };
|
|
84
113
|
}
|
|
85
|
-
|
|
86
114
|
function restoreTouchedPaths(workspace, journal) {
|
|
87
|
-
for (const rel of journal.paths
|
|
88
|
-
for (const rel of journal.present
|
|
89
|
-
const source = join(journal.backup, rel);
|
|
90
|
-
if (!existsSync(source))
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
115
|
+
for (const rel of journal.paths) { assertSafeWorkspaceTarget(workspace, rel); rmSync(join(workspace, rel), { recursive: true, force: true }); }
|
|
116
|
+
for (const rel of journal.present) {
|
|
117
|
+
const source = assertSafeWorkspaceTarget(workspace, join(journal.backup, rel));
|
|
118
|
+
if (!existsSync(source)) throw Object.assign(new Error(`transaction backup is missing ${rel}; journal preserved for diagnosis`), { unrecoverable: true });
|
|
119
|
+
// The prior target was removed above. Reject any newly introduced leaf or
|
|
120
|
+
// parent link before copying; a backed-up leaf symlink itself remains a
|
|
121
|
+
// legitimate object because cpSync does not dereference it.
|
|
122
|
+
const destination = assertSafeWorkspaceTarget(workspace, rel, { allowLeafSymlink: false });
|
|
123
|
+
mkdirSync(dirname(destination), { recursive: true }); cpSync(source, destination, { recursive: true, dereference: false });
|
|
94
124
|
}
|
|
95
125
|
}
|
|
96
|
-
|
|
126
|
+
function readJournal(workspace) { return validateJournal(workspace, JSON.parse(readFileSync(journalPath(workspace), "utf8"))); }
|
|
97
127
|
export function transactionRecovery(workspace) {
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
const journal = JSON.parse(readFileSync(path, "utf8"));
|
|
102
|
-
return { pending: true, recoverable: Boolean(journal.backup && existsSync(journal.backup)) };
|
|
103
|
-
} catch {
|
|
104
|
-
return { pending: true, recoverable: false };
|
|
105
|
-
}
|
|
128
|
+
if (!existsSync(journalPath(workspace))) return { pending: false, recoverable: false };
|
|
129
|
+
try { const journal = readJournal(workspace); return { pending: true, recoverable: journal.phase === "committed" || existsSync(join(workspace, journal.backup)), phase: journal.phase }; }
|
|
130
|
+
catch (error) { return { pending: true, recoverable: false, error: error.message }; }
|
|
106
131
|
}
|
|
107
|
-
|
|
108
|
-
/** Restore an interrupted transaction, returning false when none exists. */
|
|
109
132
|
export function recoverTransaction(workspace) {
|
|
110
|
-
const path = journalPath(workspace);
|
|
111
|
-
if (!existsSync(path)) return false;
|
|
133
|
+
const path = journalPath(workspace); if (!existsSync(path)) return false;
|
|
112
134
|
let journal;
|
|
113
|
-
try { journal =
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
135
|
+
try { journal = readJournal(workspace); } catch (error) { throw Object.assign(new Error(`transaction journal is unreadable: ${error.message}; preserved for diagnosis`), { unrecoverable: true }); }
|
|
136
|
+
if (journal.phase !== "committed") {
|
|
137
|
+
if (!existsSync(join(workspace, journal.backup))) throw Object.assign(new Error("transaction backup is missing; journal preserved for diagnosis"), { unrecoverable: true });
|
|
138
|
+
restoreTouchedPaths(workspace, journal);
|
|
117
139
|
}
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
rmSync(path, { force: true });
|
|
121
|
-
return true;
|
|
140
|
+
rmSync(join(workspace, dirname(journal.backup)), { recursive: true, force: true }); rmSync(path, { force: true });
|
|
141
|
+
return { recovered: journal.phase !== "committed", finalized: journal.phase === "committed", phase: journal.phase };
|
|
122
142
|
}
|
|
143
|
+
/** Explicit diagnostic discard; never called automatically. */
|
|
144
|
+
export function discardUnrecoverableTransaction(workspace) { rmSync(journalPath(workspace), { force: true }); }
|
|
123
145
|
|
|
124
|
-
|
|
125
|
-
export function discardUnrecoverableTransaction(workspace) {
|
|
126
|
-
rmSync(journalPath(workspace), { force: true });
|
|
127
|
-
}
|
|
128
|
-
|
|
129
|
-
/**
|
|
130
|
-
* Journal before mutation; restore only managed paths if commit throws.
|
|
131
|
-
* `validate` runs before journal creation, which is critical for conflicts,
|
|
132
|
-
* unsupported snapshot metadata, and rejected migrations.
|
|
133
|
-
*/
|
|
134
|
-
export function runTransaction({ workspace, plan, manifest, validate = () => {}, commit, failAt = null }) {
|
|
146
|
+
export function runTransaction({ workspace, plan, manifest, validate = () => {}, commit, failAt = null, lockHeld = false }) {
|
|
135
147
|
validate();
|
|
136
|
-
|
|
137
|
-
const
|
|
138
|
-
|
|
139
|
-
mkdirSync(dirname(path), { recursive: true });
|
|
140
|
-
const journal = { schemaVersion: 2, backup, paths, present };
|
|
141
|
-
// Durable pre-image: fsync the journal before any managed workspace write.
|
|
142
|
-
const fd = openSync(path, "w");
|
|
143
|
-
try {
|
|
144
|
-
writeSync(fd, JSON.stringify(journal, null, 2) + "\n");
|
|
145
|
-
fsyncSync(fd);
|
|
146
|
-
} finally {
|
|
147
|
-
closeSync(fd);
|
|
148
|
-
}
|
|
148
|
+
if (existsSync(journalPath(workspace))) throw new Error("pending transaction journal exists; run doctor --fix before replanning");
|
|
149
|
+
const lock = lockHeld ? null : acquireWorkspaceLock(workspace, plan?.verb ?? "transaction");
|
|
150
|
+
let journal;
|
|
149
151
|
try {
|
|
152
|
+
assertPlanFingerprints(plan ?? { workspace }, manifest);
|
|
153
|
+
const paths = plan ? touchedPaths(plan, manifest) : [];
|
|
154
|
+
const saved = backupTouchedPaths(workspace, paths);
|
|
155
|
+
journal = { schemaVersion: 3, phase: "prepared", backup: saved.backup, paths, present: saved.present };
|
|
156
|
+
mkdirSync(dirname(journalPath(workspace)), { recursive: true }); durableJson(journalPath(workspace), journal);
|
|
150
157
|
if (failAt === "after-journal") throw new Error("injected transaction interruption");
|
|
158
|
+
journal.phase = "applying"; durableJson(journalPath(workspace), journal);
|
|
151
159
|
const result = commit();
|
|
152
160
|
if (failAt === "after-commit") throw new Error("injected transaction interruption");
|
|
153
|
-
|
|
154
|
-
|
|
161
|
+
journal.phase = "committed"; durableJson(journalPath(workspace), journal);
|
|
162
|
+
if (failAt === "after-durable-commit") throw Object.assign(new Error("files committed; cleanup incomplete"), { postCommit: true });
|
|
163
|
+
rmSync(join(workspace, dirname(journal.backup)), { recursive: true, force: true }); rmSync(journalPath(workspace), { force: true });
|
|
155
164
|
return result;
|
|
156
165
|
} catch (error) {
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
166
|
+
if (journal && journal.phase !== "committed") {
|
|
167
|
+
try { restoreTouchedPaths(workspace, journal); rmSync(join(workspace, dirname(journal.backup)), { recursive: true, force: true }); rmSync(journalPath(workspace), { force: true }); }
|
|
168
|
+
catch (rollback) { throw Object.assign(new Error(`apply failed: ${error.message}; rollback failed: ${rollback.message}; recovery diagnostics preserved`), { rollbackFailed: true }); }
|
|
169
|
+
}
|
|
160
170
|
throw error;
|
|
161
|
-
}
|
|
171
|
+
} finally { lock?.release(); }
|
|
162
172
|
}
|
package/bin/lib/tui.js
CHANGED
|
@@ -1,71 +1,76 @@
|
|
|
1
|
-
// tui.js — dependency-free
|
|
2
|
-
|
|
1
|
+
// tui.js — dependency-free prompt ownership and setup selection.
|
|
2
|
+
import { resolveDesiredFeatures, resolveFeatures } from "./features.js";
|
|
3
3
|
const CANCEL = /^(c|cancel|q|quit)$/i;
|
|
4
|
-
|
|
5
|
-
function
|
|
6
|
-
return Object.
|
|
7
|
-
|
|
8
|
-
.
|
|
9
|
-
|
|
4
|
+
function enabledFeatures(desired) { return Object.entries(desired?.features ?? {}).filter(([, on]) => on).map(([name]) => name).sort(); }
|
|
5
|
+
function availability(manifest, platform) {
|
|
6
|
+
return Object.keys(manifest.features ?? {}).sort().map((name) => {
|
|
7
|
+
try { resolveDesiredFeatures(manifest, { preset: "default", features: [name], platform }); return { name, available: true, stability: manifest.features[name].stability ?? "stable" }; }
|
|
8
|
+
catch (error) { return { name, available: false, stability: manifest.features[name].stability ?? "stable", reason: error.message }; }
|
|
9
|
+
});
|
|
10
10
|
}
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
11
|
+
export function selectionSummary(manifest, preset, selected, platform = process.platform) {
|
|
12
|
+
const effective = resolveFeatures(manifest, selected, { platform });
|
|
13
|
+
const direct = [...selected].sort(); const deps = effective.filter((name) => !direct.includes(name));
|
|
14
|
+
const label = preset === "full" ? "Full" : "Default";
|
|
15
|
+
const describe = (values) => values.length ? values.map((name) => `${name} (${manifest.features[name].stability ?? "stable"})`).join(", ") : "none";
|
|
16
|
+
return `Preset: ${label}\nSelected features: ${describe(direct)}\nDependency features: ${describe(deps)}\n`;
|
|
16
17
|
}
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
output.write(question);
|
|
27
|
-
return readLine();
|
|
28
|
-
};
|
|
29
|
-
|
|
30
|
-
let preset;
|
|
31
|
-
while (!preset) {
|
|
32
|
-
const answer = await ask(
|
|
33
|
-
"Choose a preset:\n" +
|
|
34
|
-
" [1] Default — recommended stable Fleet basics\n" +
|
|
35
|
-
" [2] Full — every stable integration (experimental features excluded)\n" +
|
|
36
|
-
`Preset [${currentPreset}]: `,
|
|
37
|
-
);
|
|
38
|
-
if (answer === null || CANCEL.test(answer.trim())) return { cancelled: true };
|
|
39
|
-
const value = answer.trim().toLowerCase();
|
|
40
|
-
preset = value === "" ? currentPreset : value === "1" || value === "default" ? "default" : value === "2" || value === "full" ? "full" : null;
|
|
41
|
-
if (!preset) output.write('Invalid preset. Enter 1 (Default), 2 (Full), or cancel.\n');
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
const known = new Set(Object.keys(manifest.features ?? {}));
|
|
45
|
-
let features;
|
|
46
|
-
while (!features) {
|
|
47
|
-
const current = currentFeatures.length ? currentFeatures.join(",") : "none";
|
|
48
|
-
const answer = await ask(
|
|
49
|
-
`Optional features (comma-separated; blank keeps ${current}; "none" disables all):\n` +
|
|
50
|
-
`${featureList(manifest)}\n` +
|
|
51
|
-
"Experimental features are opt-in only and are never included by Full.\n" +
|
|
52
|
-
"Features: ",
|
|
53
|
-
);
|
|
54
|
-
if (answer === null || CANCEL.test(answer.trim())) return { cancelled: true };
|
|
18
|
+
export async function askChoice({ output, readLine, prompt, validate }) {
|
|
19
|
+
while (true) {
|
|
20
|
+
// A real readline interface must own the prompt so its redraw/erase cycle
|
|
21
|
+
// cannot clear text printed separately just before question(""). Test and
|
|
22
|
+
// non-readline adapters retain the explicit output path.
|
|
23
|
+
if (!readLine.ownsPrompt) output.write(prompt);
|
|
24
|
+
const answer = await readLine(prompt);
|
|
25
|
+
if (answer === null) return { cancelled: true, reason: "EOF" };
|
|
26
|
+
if (answer === "__AGENT_FLEET_INTERRUPT__") return { cancelled: true, reason: "Ctrl+C" };
|
|
55
27
|
const value = answer.trim();
|
|
56
|
-
|
|
57
|
-
const
|
|
58
|
-
if (
|
|
59
|
-
|
|
60
|
-
continue;
|
|
61
|
-
}
|
|
62
|
-
features = selected;
|
|
28
|
+
if (CANCEL.test(value)) return { cancelled: true, reason: "cancel" };
|
|
29
|
+
const result = validate(value);
|
|
30
|
+
if (result.ok) return { cancelled: false, value: result.value };
|
|
31
|
+
output.write(`${result.error}\n`);
|
|
63
32
|
}
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
};
|
|
33
|
+
}
|
|
34
|
+
export async function askFinalApproval({ output, readLine }) {
|
|
35
|
+
return askChoice({ output, readLine, prompt: "Apply this setup plan? yes/y | no/n; Enter = no (cancel without applying) > ", validate: (value) => {
|
|
36
|
+
if (/^y(?:es)?$/i.test(value)) return { ok: true, value: true };
|
|
37
|
+
if (value === "" || /^n(?:o)?$/i.test(value)) return { ok: true, value: false };
|
|
38
|
+
return { ok: false, error: "Invalid answer. Enter yes/y to apply or no/n to cancel." };
|
|
39
|
+
} });
|
|
40
|
+
}
|
|
41
|
+
/** Collect editable desired state; the caller owns final exact-plan approval. */
|
|
42
|
+
export async function chooseSetup({ output, readLine, manifest, currentDesired = null, platform = process.platform }) {
|
|
43
|
+
const currentPreset = currentDesired?.preset ?? "default";
|
|
44
|
+
const currentFeatures = enabledFeatures(currentDesired);
|
|
45
|
+
const available = availability(manifest, platform); const all = available.filter((x) => x.available).map((x) => x.name);
|
|
46
|
+
const presetResult = await askChoice({ output, readLine,
|
|
47
|
+
prompt: "Choose a preset:\n [1] Default — recommended stable Fleet basics\n [2] Full — every stable integration\n [3] Full + all features — includes platform-compatible experimental features\n" +
|
|
48
|
+
`Choose: 1 | 2 | 3 | cancel; Enter = ${currentPreset === "full" ? "Full" : "Default"} > `,
|
|
49
|
+
validate(value) {
|
|
50
|
+
if (value === "") return { ok: true, value: { preset: currentPreset, allFeatures: false } };
|
|
51
|
+
if (value === "1" || value.toLowerCase() === "default") return { ok: true, value: { preset: "default", allFeatures: false } };
|
|
52
|
+
if (value === "2" || value.toLowerCase() === "full") return { ok: true, value: { preset: "full", allFeatures: false } };
|
|
53
|
+
if (value === "3" || /^full\s*\+\s*all/i.test(value)) return { ok: true, value: { preset: "full", allFeatures: true } };
|
|
54
|
+
return { ok: false, error: "Invalid preset. Enter 1 (Default), 2 (Full), 3 (Full + all features), or cancel." };
|
|
55
|
+
},
|
|
56
|
+
});
|
|
57
|
+
if (presetResult.cancelled) return presetResult;
|
|
58
|
+
const preset = presetResult.value.preset;
|
|
59
|
+
const featureDefault = presetResult.value.allFeatures ? all : currentFeatures;
|
|
60
|
+
const listed = available.map((x) => ` - ${x.name} (${x.stability})${x.available ? "" : ` — unavailable: ${x.reason}`}`).join("\n");
|
|
61
|
+
const featureResult = await askChoice({ output, readLine,
|
|
62
|
+
prompt: `Available features:\n${listed}\nFeatures: <name>[,<name>...] | none | cancel; Enter = keep [${featureDefault.length ? featureDefault.join(",") : "none"}] > `,
|
|
63
|
+
validate(value) {
|
|
64
|
+
const selected = value === "" ? featureDefault : value.toLowerCase() === "none" ? [] : [...new Set(value.split(",").map((x) => x.trim()).filter(Boolean))].sort();
|
|
65
|
+
const found = selected.find((name) => !available.some((entry) => entry.name === name));
|
|
66
|
+
if (found) return { ok: false, error: `Unknown feature "${found}". Try again using a listed feature ID.` };
|
|
67
|
+
const blocked = selected.find((name) => !available.find((entry) => entry.name === name)?.available);
|
|
68
|
+
if (blocked) return { ok: false, error: `Feature "${blocked}" is unavailable on ${platform}.` };
|
|
69
|
+
return { ok: true, value: selected };
|
|
70
|
+
},
|
|
71
|
+
});
|
|
72
|
+
if (featureResult.cancelled) return featureResult;
|
|
73
|
+
const features = featureResult.value;
|
|
74
|
+
output.write(selectionSummary(manifest, preset, features, platform));
|
|
75
|
+
return { cancelled: false, preset, features, allFeaturesSnapshot: presetResult.value.allFeatures, changed: preset !== currentPreset || features.join(",") !== currentFeatures.join(",") };
|
|
71
76
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// update-notifier — zero-dependency check for newer versions on the npm
|
|
2
|
-
// registry, shared by the CLI, the Claude Code session hook, and the
|
|
3
|
-
//
|
|
2
|
+
// registry, shared by the CLI, the Claude Code session hook, and the Fleet
|
|
3
|
+
// Core helper (`.pi/harnesses/lib/update-check.ts`).
|
|
4
4
|
//
|
|
5
5
|
// Behaviour:
|
|
6
6
|
// - Cache lives at $XDG_CACHE_HOME/agent-fleet/latest-version.json
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
// Shared workspace path and single-writer safety.
|
|
2
|
+
import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, rmdirSync, rmSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
4
|
+
|
|
5
|
+
export const LOCK_REL_PATH = ".ai/agent-fleet.lock";
|
|
6
|
+
|
|
7
|
+
export function ownedRelativePath(workspace, value, label = "path") {
|
|
8
|
+
if (typeof value !== "string" || !value) throw new Error(`${label} must be a non-empty workspace path`);
|
|
9
|
+
const rel = relative(resolve(workspace), isAbsolute(value) ? resolve(value) : resolve(workspace, value));
|
|
10
|
+
if (rel === "") return ".";
|
|
11
|
+
if (rel === ".." || rel.startsWith(`..${sep}`) || rel.split(sep).includes("..")) throw new Error(`${label} is outside the workspace: ${value}`);
|
|
12
|
+
return rel;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/** Refuse writes through any existing parent symlink. Leaf symlinks remain valid managed targets. */
|
|
16
|
+
export function assertSafeWorkspaceTarget(workspace, value, { allowLeafSymlink = true } = {}) {
|
|
17
|
+
const rel = ownedRelativePath(workspace, value, "target path");
|
|
18
|
+
let cursor = resolve(workspace);
|
|
19
|
+
for (const [index, part] of rel.split(sep).entries()) {
|
|
20
|
+
cursor = join(cursor, part);
|
|
21
|
+
if (!existsSync(cursor)) continue;
|
|
22
|
+
const leaf = index === rel.split(sep).length - 1;
|
|
23
|
+
if (lstatSync(cursor).isSymbolicLink() && !(leaf && allowLeafSymlink)) {
|
|
24
|
+
throw new Error(`refusing target through symlink: ${rel}`);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
return join(resolve(workspace), rel);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export function lockPath(workspace) { return join(workspace, LOCK_REL_PATH); }
|
|
31
|
+
export function breakWorkspaceLock(workspace) {
|
|
32
|
+
const path = assertSafeWorkspaceTarget(workspace, LOCK_REL_PATH, { allowLeafSymlink: false });
|
|
33
|
+
if (!existsSync(path)) return false;
|
|
34
|
+
rmSync(path, { force: true });
|
|
35
|
+
return true;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** No stale-lock stealing: recovery is an explicit operator decision. */
|
|
39
|
+
export function acquireWorkspaceLock(workspace, operation) {
|
|
40
|
+
const path = lockPath(workspace);
|
|
41
|
+
assertSafeWorkspaceTarget(workspace, LOCK_REL_PATH, { allowLeafSymlink: false });
|
|
42
|
+
const parentExisted = existsSync(dirname(path));
|
|
43
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
44
|
+
let fd;
|
|
45
|
+
try { fd = openSync(path, "wx", 0o600); }
|
|
46
|
+
catch (error) {
|
|
47
|
+
if (error.code !== "EEXIST") throw error;
|
|
48
|
+
let owner = "unknown owner";
|
|
49
|
+
try { owner = readFileSync(path, "utf8").trim() || owner; } catch {}
|
|
50
|
+
throw Object.assign(new Error(`workspace is locked (${owner}); locks are never stolen automatically`), { exitCode: 4 });
|
|
51
|
+
}
|
|
52
|
+
const body = JSON.stringify({ schemaVersion: 1, pid: process.pid, operation, createdAt: new Date().toISOString() }) + "\n";
|
|
53
|
+
writeFileSync(fd, body); closeSync(fd);
|
|
54
|
+
let released = false;
|
|
55
|
+
return {
|
|
56
|
+
path,
|
|
57
|
+
release() {
|
|
58
|
+
if (released) return;
|
|
59
|
+
released = true;
|
|
60
|
+
try {
|
|
61
|
+
const current = JSON.parse(readFileSync(path, "utf8"));
|
|
62
|
+
if (current.pid === process.pid) rmSync(path, { force: true });
|
|
63
|
+
if (!parentExisted) try { rmdirSync(dirname(path)); } catch {}
|
|
64
|
+
} catch {}
|
|
65
|
+
},
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export function assertWorkspaceRootSafe(workspace) {
|
|
70
|
+
const root = realpathSync(workspace);
|
|
71
|
+
if (root !== resolve(workspace)) throw new Error("workspace root must not be a symlink");
|
|
72
|
+
}
|
package/docs/npm-install.md
CHANGED
|
@@ -22,9 +22,7 @@ cd ~/projects/my-app
|
|
|
22
22
|
npx @chankov/agent-fleet@latest setup
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
-
In a real TTY this opens the installer: pick **Default** or **Full**,
|
|
26
|
-
optional comma-separated features, read the exact reconciliation plan, and
|
|
27
|
-
confirm once to apply. For automation, name the selection and consent up front:
|
|
25
|
+
In a real TTY this opens the installer: pick **Default**, **Full**, or **Full + all features**, edit the exact feature list, read the complete reconciliation plan, and answer `yes` to apply. Enter never approves mutation. For automation, name the selection and consent up front:
|
|
28
26
|
|
|
29
27
|
```bash
|
|
30
28
|
npx @chankov/agent-fleet@latest setup --preset default --features none --yes
|
|
@@ -36,16 +34,13 @@ Pin the exact version when the run has to be reproducible:
|
|
|
36
34
|
npx @chankov/agent-fleet@1.0.0 setup --preset default --features none --yes
|
|
37
35
|
```
|
|
38
36
|
|
|
39
|
-
**Default** is the
|
|
40
|
-
nor voice configuration. **Full** selects every stable, platform-applicable
|
|
41
|
-
catalogue root; it may install the recorded Claude Code coms bridge. Features
|
|
42
|
-
are additive named capabilities (`browser`, `voice`, `hermes`, `telegram`,
|
|
37
|
+
**Default** is the stable Fleet Core selection and creates neither `.claude/` nor voice configuration. **Full** selects every stable, platform-applicable catalogue root; it may install the recorded Claude Code coms bridge. **Full + all features** is not a permanent preset: it stores `preset: "full"` and an explicit snapshot of every currently platform-compatible feature, including experimental ones, so future features are not silently enabled. Features are named capabilities (`browser`, `voice`, `hermes`, `telegram`,
|
|
43
38
|
`claude-bridge`, and the experimental `chatgpt-client`), not an arbitrary
|
|
44
39
|
package-entry mode — `setup --help` lists them.
|
|
45
40
|
|
|
46
41
|
### Then install the runtime dependencies
|
|
47
42
|
|
|
48
|
-
Setup writes files; it does not run commands for you. The three `npm` steps for
|
|
43
|
+
Setup writes files; it does not run commands for you, and a successful file commit is not reported as runtime readiness unless the existing dependency checks pass. The three `npm` steps for
|
|
49
44
|
`.pi/extensions`, `.pi/harnesses`, and `scripts` are planned as `skip` with the
|
|
50
45
|
reason *"runs a command — re-run with `--allow-exec` to include it"*. **A
|
|
51
46
|
workspace is not launchable until they run.** Either let setup run them:
|
|
@@ -93,12 +88,21 @@ node bin/cli.js setup --workspace ~/projects/my-app --preset default --features
|
|
|
93
88
|
|
|
94
89
|
### 1. Notice there is one
|
|
95
90
|
|
|
96
|
-
A
|
|
97
|
-
banner
|
|
98
|
-
|
|
91
|
+
A `just fleet` session started from a workspace with an install record prints a
|
|
92
|
+
banner at session start when a newer package is published (the shared helper in
|
|
93
|
+
`damage-control-continue`, not a standalone pi extension):
|
|
99
94
|
|
|
100
95
|
```
|
|
101
|
-
agent-fleet update available: 0.1.0 → 0.2.0
|
|
96
|
+
agent-fleet update available: 0.1.0 → 0.2.0
|
|
97
|
+
|
|
98
|
+
In the workspace root:
|
|
99
|
+
npx @chankov/agent-fleet@latest setup
|
|
100
|
+
|
|
101
|
+
Preview without writing:
|
|
102
|
+
npx @chankov/agent-fleet@latest setup --dry-run
|
|
103
|
+
|
|
104
|
+
Releases:
|
|
105
|
+
https://github.com/chankov/agent-fleet/releases
|
|
102
106
|
```
|
|
103
107
|
|
|
104
108
|
To ask directly, without a session — it prints one line when an update exists
|
|
@@ -113,7 +117,7 @@ this installer or anything it wrote.
|
|
|
113
117
|
|
|
114
118
|
### 2. Preview the reconcile
|
|
115
119
|
|
|
116
|
-
Always worth it, always free — `--dry-run`
|
|
120
|
+
Always worth it, always free — `--dry-run` creates no lock, backup, journal, or target write and needs no consent. JSON preview uses a versioned public model that deliberately omits internal write buffers (including complete `.env` and config before/after text):
|
|
117
121
|
|
|
118
122
|
```bash
|
|
119
123
|
just fleet setup --dry-run
|
|
@@ -148,8 +152,8 @@ you do not restate the preset on every update. Flags passed on an update are
|
|
|
148
152
|
ephemeral for that run only unless you add `--save-desired`:
|
|
149
153
|
|
|
150
154
|
```bash
|
|
151
|
-
just fleet setup --features voice,browser --yes # this run only
|
|
152
|
-
just fleet setup --features voice,browser --save-desired --yes # persisted
|
|
155
|
+
just fleet setup --features voice,browser --stt-provider groq --yes # this run only
|
|
156
|
+
just fleet setup --features voice,browser --stt-provider groq --save-desired --yes # persisted
|
|
153
157
|
```
|
|
154
158
|
|
|
155
159
|
### 4. Handle a conflict
|
|
@@ -245,6 +249,14 @@ state-owned legacy artifacts. Foreign or locally modified files survive.
|
|
|
245
249
|
dispatch to `setup`; `install` and `upgrade` keep their historical selection and
|
|
246
250
|
three-way-merge semantics and warn. New scripts should use `setup`.
|
|
247
251
|
|
|
252
|
+
## Transaction and recovery contract
|
|
253
|
+
|
|
254
|
+
Mutating lifecycle commands hold `.ai/agent-fleet.lock`; locks are never stolen automatically. Planning refuses an existing `.ai/agent-fleet-transaction.json`. Recovery pre-images live durably under `.ai/.agent-fleet-recovery/`, and journal phases are `prepared`, `applying`, and `committed`. `doctor --fix` restores pre-commit phases or only finalizes cleanup for a durable committed phase. A missing/corrupt backup leaves diagnostics in place and fails honestly. After an operator has verified that the recorded process is gone, `doctor --fix --force` is the explicit stale-lock recovery path.
|
|
255
|
+
|
|
256
|
+
Plans fingerprint every touched target before approval and re-check immediately before writing. Absolute/`..` journal paths, non-installer backup roots, and target paths crossing parent symlinks are refused. Runtime subprocesses have a 120-second bound and visible start/completion output. Retry state stores an action ID, but the command is always reloaded from the trusted current manifest; saved argv never grants execution authority.
|
|
257
|
+
|
|
258
|
+
JSON stdout is one clean document. Public plan schema `1` adds a `stage` (`preview`, `config-repair-preview`, or `apply`) while retaining safe plan fields for consumers. Secret-bearing buffers (`text`, complete before/after/original/replacement bodies, and recovery locations) are never serialized.
|
|
259
|
+
|
|
248
260
|
## Doctor and uninstall
|
|
249
261
|
|
|
250
262
|
```bash
|
|
@@ -299,3 +311,17 @@ reads.
|
|
|
299
311
|
| `3` | `setup` hit unresolved conflicts and wrote nothing |
|
|
300
312
|
|
|
301
313
|
See [Migration](MIGRATION-agent-fleet.md) for the full major-release matrix.
|
|
314
|
+
|
|
315
|
+
## Release operator verification
|
|
316
|
+
|
|
317
|
+
CI runs the installer and packed-artifact regression suite on Linux and macOS, including the narrow PTY path, then checks `npm pack --dry-run`. Publishing remains a separate protected step. After publishing, the operator must smoke the exact immutable version in a disposable repository before checking the tag:
|
|
318
|
+
|
|
319
|
+
```bash
|
|
320
|
+
version=2.0.7 # released version, never `latest` for the first probe
|
|
321
|
+
repo="$(mktemp -d)"
|
|
322
|
+
(cd "$repo" && npx "@chankov/agent-fleet@$version" setup --preset default --features none --dry-run --json)
|
|
323
|
+
npm view "@chankov/agent-fleet@$version" version
|
|
324
|
+
npm view @chankov/agent-fleet@latest version # must equal $version only after the exact-version smoke passes
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
No release verification should target a real application workspace.
|
package/docs/pi-extensions.md
CHANGED
|
@@ -28,7 +28,7 @@ not vendor that code; the mechanisms are rebuilt on Agent Fleet seams.
|
|
|
28
28
|
## What these extensions are
|
|
29
29
|
|
|
30
30
|
`.pi/extensions/` contains utility extensions. Fleet Core explicitly loads
|
|
31
|
-
`compact-and-continue
|
|
31
|
+
`compact-and-continue` and `btw`; browser and voice are
|
|
32
32
|
feature-gated: after setup installs them, launch with `just fleet --browser` or
|
|
33
33
|
`just fleet --voice`. This keeps Default deterministic even though pi can auto-discover
|
|
34
34
|
extensions outside Fleet Core. `btw` adds a
|
|
@@ -56,8 +56,8 @@ see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/READM
|
|
|
56
56
|
The documented harnesses below are different: each is a **session harness**. They
|
|
57
57
|
reshape the whole pi session — some set orchestration/UI surfaces and some gate every
|
|
58
58
|
tool call. The unified `just fleet` entry point composes them with a deterministic
|
|
59
|
-
Fleet Core: `damage-control-continue
|
|
60
|
-
|
|
59
|
+
Fleet Core: `damage-control-continue` (which also runs the shared package update
|
|
60
|
+
check once per session), `ask-user-remote`, Compact & Continue, and BTW. Voice is an optional feature, not Default Fleet Core.
|
|
61
61
|
Every public Pi launch through bare `just fleet` also loads
|
|
62
62
|
`agent-hub`; operator/orchestrator work mode changes its direct tool surface without changing
|
|
63
63
|
process or session. `just fleet peer` starts a standalone coms peer. Harnesses live in
|