@chankov/agent-fleet 0.0.9 → 0.0.10
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/.claude/commands/doctor-agent-fleet.md +12 -7
- package/.claude/commands/setup-agent-fleet.md +7 -15
- package/.opencode/commands/af-doctor-agent-fleet.md +12 -7
- package/.opencode/commands/af-setup-agent-fleet.md +8 -6
- package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
- package/.pi/extensions/btw/README.md +2 -2
- package/.pi/extensions/chrome-devtools-mcp/README.md +3 -6
- package/.pi/extensions/compact-and-continue/README.md +3 -3
- package/.pi/extensions/mcp-bridge/README.md +1 -1
- package/.pi/harnesses/agent-hub/README.md +139 -10
- package/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.pi/harnesses/agent-hub/index.ts +448 -39
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.pi/harnesses/agent-hub/run-budget.js +302 -4
- package/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/prompts/af-doctor-agent-fleet.md +13 -6
- package/.pi/prompts/af-setup-agent-fleet.md +7 -15
- package/.versions/0.0.10/.claude/commands/build.md +44 -0
- package/.versions/0.0.10/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.10/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.10/.claude/commands/doctor-agent-fleet.md +22 -0
- package/.versions/0.0.10/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.10/.claude/commands/plan.md +16 -0
- package/.versions/0.0.10/.claude/commands/prime.md +22 -0
- package/.versions/0.0.10/.claude/commands/review.md +16 -0
- package/.versions/0.0.10/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.10/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.10/.claude/commands/setup-agent-fleet.md +17 -0
- package/.versions/0.0.10/.claude/commands/ship.md +72 -0
- package/.versions/0.0.10/.claude/commands/spec.md +15 -0
- package/.versions/0.0.10/.claude/commands/test.md +19 -0
- package/.versions/0.0.10/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.10/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.10/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.10/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.10/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.10/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.10/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.10/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.10/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +17 -0
- package/.versions/0.0.10/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.10/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.10/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.10/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.10/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/0.0.10/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.10/.pi/agents/teams.yaml +41 -0
- package/.versions/0.0.10/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.10/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.10/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.10/.pi/extensions/package.json +9 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/README.md +1001 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/footer.ts +31 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/index.ts +9111 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/0.0.10/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.10/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.10/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.10/.pi/harnesses/coms/README.md +100 -0
- package/.versions/0.0.10/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.10/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.10/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/0.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/0.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.10/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.10/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.10/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.10/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.10/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.10/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +19 -0
- package/.versions/0.0.10/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.10/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.10/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.10/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.10/.version +1 -0
- package/.versions/0.0.10/agents/architect.md +24 -0
- package/.versions/0.0.10/agents/bowser.md +27 -0
- package/.versions/0.0.10/agents/builder.md +54 -0
- package/.versions/0.0.10/agents/code-reviewer.md +208 -0
- package/.versions/0.0.10/agents/deep-researcher.md +32 -0
- package/.versions/0.0.10/agents/documenter.md +18 -0
- package/.versions/0.0.10/agents/orchestrator.md +72 -0
- package/.versions/0.0.10/agents/plan-reviewer.md +83 -0
- package/.versions/0.0.10/agents/planner.md +70 -0
- package/.versions/0.0.10/agents/releaser.md +24 -0
- package/.versions/0.0.10/agents/researcher.md +28 -0
- package/.versions/0.0.10/agents/security-auditor.md +167 -0
- package/.versions/0.0.10/agents/test-engineer.md +153 -0
- package/.versions/0.0.10/agents/web-debugger.md +43 -0
- package/.versions/0.0.10/agents/web-performance-auditor.md +193 -0
- package/.versions/0.0.10/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.10/docs/ARCHITECTURE.md +303 -0
- package/.versions/0.0.10/docs/agent-fleet-setup.md +377 -0
- package/.versions/0.0.10/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.10/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.10/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.10/docs/getting-started.md +254 -0
- package/.versions/0.0.10/docs/npm-install.md +514 -0
- package/.versions/0.0.10/docs/opencode-setup.md +281 -0
- package/.versions/0.0.10/docs/pi-extensions.md +363 -0
- package/.versions/0.0.10/docs/pi-setup.md +571 -0
- package/.versions/0.0.10/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.10/hermes/README.md +347 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.10/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.10/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.10/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.10/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.10/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.10/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.10/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.10/hooks/hooks.json +14 -0
- package/.versions/0.0.10/hooks/session-start.sh +74 -0
- package/.versions/0.0.10/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.10/install-manifest.json +3615 -0
- package/.versions/0.0.10/justfile +254 -0
- package/.versions/0.0.10/manifest-meta.json +472 -0
- package/.versions/0.0.10/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.10/references/definition-of-done.md +67 -0
- package/.versions/0.0.10/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.10/references/observability-checklist.md +91 -0
- package/.versions/0.0.10/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.10/references/performance-checklist.md +153 -0
- package/.versions/0.0.10/references/prompting-patterns.md +380 -0
- package/.versions/0.0.10/references/security-checklist.md +179 -0
- package/.versions/0.0.10/references/testing-patterns.md +236 -0
- package/.versions/0.0.10/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.10/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.10/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.10/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.10/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.10/scripts/fleet.ts +168 -0
- package/.versions/0.0.10/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.10/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.10/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.10/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.10/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.10/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.10/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.10/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.10/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.10/scripts/lib/fleet-command.ts +111 -0
- package/.versions/0.0.10/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/0.0.10/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.10/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.10/scripts/lib/peer-launch.ts +314 -0
- package/.versions/0.0.10/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.10/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.10/scripts/lib/team-project.ts +193 -0
- package/.versions/0.0.10/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.10/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.10/scripts/peer-launch.ts +259 -0
- package/.versions/0.0.10/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.10/scripts/team-up.ts +360 -0
- package/.versions/0.0.10/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/0.0.10/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.10/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.10/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.10/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.10/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +226 -0
- package/.versions/0.0.10/skills/guided-workspace-setup/companion-manifest.json +38 -0
- package/.versions/0.0.10/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.10/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.10/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.10/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.10/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.10/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.10/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.10/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.10/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.10/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/0.0.10/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.10/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/0.0.10/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.10/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +103 -0
- package/README.md +22 -5
- package/agents/code-reviewer.md +4 -0
- package/agents/orchestrator.md +7 -1
- package/agents/plan-reviewer.md +22 -1
- package/bin/build-manifest.js +68 -0
- package/bin/cli.js +679 -49
- package/bin/lib/apply.js +641 -0
- package/bin/lib/manifest.js +731 -0
- package/bin/lib/merge-forms.js +106 -0
- package/bin/lib/plan.js +569 -0
- package/bin/lib/state.js +213 -0
- package/bin/lib/verify.js +576 -0
- package/bin/snapshot-version.js +5 -0
- package/docs/ARCHITECTURE.md +52 -11
- package/docs/agent-fleet-setup.md +59 -48
- package/docs/getting-started.md +29 -6
- package/docs/npm-install.md +208 -31
- package/docs/opencode-setup.md +32 -0
- package/docs/pi-extensions.md +17 -10
- package/docs/pi-setup.md +164 -69
- package/install-manifest.json +3615 -0
- package/manifest-meta.json +472 -0
- package/package.json +8 -3
- package/skills/browser-testing-with-devtools/SKILL.md +3 -4
- package/skills/guided-workspace-setup/SKILL.md +172 -490
- package/skills/planning-and-task-breakdown/SKILL.md +18 -0
- package/skills/spec-driven-development/SKILL.md +12 -0
|
@@ -0,0 +1,576 @@
|
|
|
1
|
+
// verify.js — read-only workspace inspection.
|
|
2
|
+
//
|
|
3
|
+
// Answers, without writing anything: what does this workspace have installed,
|
|
4
|
+
// how does it differ from the source, and what is broken? It is the shared
|
|
5
|
+
// computation behind `agent-fleet verify` and, from Phase 3 on, behind the
|
|
6
|
+
// planner — `plan()` is this pass plus a decision per item, and `apply()` is
|
|
7
|
+
// that plan executed. Keeping the state computation in one place is what stops
|
|
8
|
+
// setup and doctor from drifting apart.
|
|
9
|
+
//
|
|
10
|
+
// See plans/deterministic-installer-manifest-spec.md §4.1 for the state table.
|
|
11
|
+
|
|
12
|
+
import { existsSync, readFileSync, statSync } from "node:fs";
|
|
13
|
+
import { basename, join } from "node:path";
|
|
14
|
+
|
|
15
|
+
import { itemsForAgent } from "./manifest.js";
|
|
16
|
+
import { extractRegion, leafPaths, getPath, canonicalJson } from "./merge-forms.js";
|
|
17
|
+
import { transformPersona } from "./transform-persona.js";
|
|
18
|
+
import { runDoctor } from "./doctor.js";
|
|
19
|
+
import {
|
|
20
|
+
readState,
|
|
21
|
+
readLegacyRecord,
|
|
22
|
+
hashFile,
|
|
23
|
+
hashText,
|
|
24
|
+
walkTree,
|
|
25
|
+
inspectPath,
|
|
26
|
+
isInside,
|
|
27
|
+
isVolatileSourceRoot,
|
|
28
|
+
isAgentFleetCheckout,
|
|
29
|
+
STATE_SCHEMA_VERSION,
|
|
30
|
+
STATE_REL_PATH,
|
|
31
|
+
} from "./state.js";
|
|
32
|
+
|
|
33
|
+
export const VERIFY_SCHEMA_VERSION = 1;
|
|
34
|
+
|
|
35
|
+
// States that mean the workspace is broken, not merely behind. `outdated` and
|
|
36
|
+
// `modified` are reported but do not fail: an available upgrade and a
|
|
37
|
+
// deliberate local edit are both legitimate resting states.
|
|
38
|
+
export const BROKEN_STATES = new Set(["missing", "broken-link", "foreign-link", "conflict", "gone"]);
|
|
39
|
+
|
|
40
|
+
// Findings that describe a condition rather than a defect. They are printed,
|
|
41
|
+
// but they never fail the run — a workspace installed before `.versions/`
|
|
42
|
+
// retention, or one carrying a hand-edited overrides file, is not broken.
|
|
43
|
+
export const ADVISORY_FINDINGS = new Set([
|
|
44
|
+
"base-snapshot-missing",
|
|
45
|
+
"source-root-volatile",
|
|
46
|
+
"symlink-retired",
|
|
47
|
+
"retired-artifact",
|
|
48
|
+
"legacy-target",
|
|
49
|
+
"overrides",
|
|
50
|
+
"yaml-shape",
|
|
51
|
+
]);
|
|
52
|
+
|
|
53
|
+
// Worst-wins ordering when a tree item's files disagree.
|
|
54
|
+
const SEVERITY = {
|
|
55
|
+
"not-applicable": 0,
|
|
56
|
+
"unchecked": 1,
|
|
57
|
+
"absent": 2,
|
|
58
|
+
"linked": 3,
|
|
59
|
+
"up-to-date": 4,
|
|
60
|
+
"outdated": 5,
|
|
61
|
+
"modified": 6,
|
|
62
|
+
"partial": 7,
|
|
63
|
+
"gone": 8,
|
|
64
|
+
"foreign-link": 9,
|
|
65
|
+
"broken-link": 10,
|
|
66
|
+
"missing": 11,
|
|
67
|
+
"conflict": 12,
|
|
68
|
+
};
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Inspect a workspace against the manifest.
|
|
72
|
+
*
|
|
73
|
+
* @param {object} opts
|
|
74
|
+
* @param {string} opts.workspace target workspace (absolute)
|
|
75
|
+
* @param {string} opts.sourceRoot agent-fleet package root (absolute)
|
|
76
|
+
* @param {string} opts.packageVersion the running package's version
|
|
77
|
+
* @param {object} opts.manifest loaded install manifest
|
|
78
|
+
* @param {string} [opts.agent] override the recorded/detected agent
|
|
79
|
+
* @param {string} [opts.platform] process.platform, for platform-gated items
|
|
80
|
+
* @param {boolean} [opts.includeDoctor] run the legacy doctor scan too (default true)
|
|
81
|
+
* @returns {Promise<object>} report
|
|
82
|
+
*/
|
|
83
|
+
export async function runVerify({
|
|
84
|
+
workspace,
|
|
85
|
+
sourceRoot,
|
|
86
|
+
packageVersion,
|
|
87
|
+
manifest,
|
|
88
|
+
agent = null,
|
|
89
|
+
platform = process.platform,
|
|
90
|
+
includeDoctor = true,
|
|
91
|
+
}) {
|
|
92
|
+
const state = readState(workspace);
|
|
93
|
+
const legacy = readLegacyRecord(workspace);
|
|
94
|
+
const resolvedAgent = agent ?? state?.agent ?? legacy?.agent ?? null;
|
|
95
|
+
const recordedVersion = state?.packageVersion ?? legacy?.version ?? null;
|
|
96
|
+
const stateSource = state ? "state-file" : legacy ? "legacy-record" : "none";
|
|
97
|
+
|
|
98
|
+
const findings = [];
|
|
99
|
+
const baseRoot = resolveBaseRoot(sourceRoot, recordedVersion);
|
|
100
|
+
const baseAvailable = Boolean(baseRoot);
|
|
101
|
+
|
|
102
|
+
if (state && state.schemaVersion !== STATE_SCHEMA_VERSION) {
|
|
103
|
+
findings.push({
|
|
104
|
+
type: "state-schema",
|
|
105
|
+
path: STATE_REL_PATH,
|
|
106
|
+
issue: `state schemaVersion ${state.schemaVersion}, this build speaks ${STATE_SCHEMA_VERSION}`,
|
|
107
|
+
fix: "upgrade agent-fleet, or re-run install to rewrite the state file",
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
if (state?.sourceRoot && !existsSync(state.sourceRoot)) {
|
|
111
|
+
findings.push({
|
|
112
|
+
type: "source-root-missing",
|
|
113
|
+
path: STATE_REL_PATH,
|
|
114
|
+
issue: `recorded source root no longer exists — ${state.sourceRoot}`,
|
|
115
|
+
fix: "re-run install from the current package to re-point the workspace",
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
if (state?.method === "symlink" && !isAgentFleetCheckout(workspace)) {
|
|
119
|
+
findings.push({
|
|
120
|
+
type: "symlink-retired",
|
|
121
|
+
path: STATE_REL_PATH,
|
|
122
|
+
issue: "installed with symlinks, which are now supported only inside an agent-fleet checkout",
|
|
123
|
+
fix: "run `agent-fleet install` or `upgrade` — linked items are re-materialised as copies",
|
|
124
|
+
});
|
|
125
|
+
} else if (state?.method === "symlink" && isVolatileSourceRoot(state.sourceRoot)) {
|
|
126
|
+
findings.push({
|
|
127
|
+
type: "source-root-volatile",
|
|
128
|
+
path: STATE_REL_PATH,
|
|
129
|
+
issue: "symlink install points into an npx cache — a cache clean breaks every link",
|
|
130
|
+
fix: "re-install with --method copy, or from a stable clone / global install",
|
|
131
|
+
});
|
|
132
|
+
}
|
|
133
|
+
if (recordedVersion && !baseAvailable) {
|
|
134
|
+
findings.push({
|
|
135
|
+
type: "base-snapshot-missing",
|
|
136
|
+
path: `.versions/${recordedVersion}`,
|
|
137
|
+
issue: "no snapshot for the recorded version — three-way merges degrade to two-way",
|
|
138
|
+
fix: "informational; the installed copy is treated as canonical on upgrade",
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
let items = [];
|
|
143
|
+
if (!resolvedAgent) {
|
|
144
|
+
findings.push({
|
|
145
|
+
type: "agent-unknown",
|
|
146
|
+
path: STATE_REL_PATH,
|
|
147
|
+
issue: "no recorded or detected coding agent — cannot resolve install targets",
|
|
148
|
+
fix: "re-run with --agent <claude-code|opencode|pi>",
|
|
149
|
+
});
|
|
150
|
+
} else {
|
|
151
|
+
items = evaluateWorkspace({
|
|
152
|
+
workspace, sourceRoot, manifest, agent: resolvedAgent, platform, state, baseRoot,
|
|
153
|
+
});
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
for (const entry of items) {
|
|
157
|
+
for (const rel of entry.legacyTargets ?? []) {
|
|
158
|
+
findings.push({
|
|
159
|
+
type: "legacy-target",
|
|
160
|
+
path: rel,
|
|
161
|
+
issue: `${entry.id} used to install here; the runtime still loads it`,
|
|
162
|
+
fix: `re-run install to retire it (kept if you edited it), or delete ${rel} by hand`,
|
|
163
|
+
});
|
|
164
|
+
}
|
|
165
|
+
if (entry.owned && entry.retired) {
|
|
166
|
+
findings.push({
|
|
167
|
+
type: "retired-artifact",
|
|
168
|
+
path: entry.target ?? entry.id,
|
|
169
|
+
issue: `${entry.id} was retired upstream`,
|
|
170
|
+
fix: "remove it with `agent-fleet uninstall`, or keep it deliberately",
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
if (includeDoctor) {
|
|
176
|
+
findings.push(...(await runDoctor({ workspace, sourceRoot })));
|
|
177
|
+
}
|
|
178
|
+
for (const f of findings) f.severity = ADVISORY_FINDINGS.has(f.type) ? "advisory" : "problem";
|
|
179
|
+
|
|
180
|
+
const byState = {};
|
|
181
|
+
for (const entry of items) byState[entry.state] = (byState[entry.state] ?? 0) + 1;
|
|
182
|
+
|
|
183
|
+
const broken = items.filter((i) => BROKEN_STATES.has(i.state));
|
|
184
|
+
const upgradable = items.filter((i) => i.state === "outdated");
|
|
185
|
+
|
|
186
|
+
return {
|
|
187
|
+
schemaVersion: VERIFY_SCHEMA_VERSION,
|
|
188
|
+
verb: "verify",
|
|
189
|
+
workspace,
|
|
190
|
+
sourceRoot,
|
|
191
|
+
agent: resolvedAgent,
|
|
192
|
+
packageVersion,
|
|
193
|
+
recordedVersion,
|
|
194
|
+
stateSource,
|
|
195
|
+
baseAvailable,
|
|
196
|
+
// The menu metadata travels with the report so a front-end needs exactly
|
|
197
|
+
// one command to build a selection screen: groups give it the headings and
|
|
198
|
+
// ordering, profiles the shortcuts, items the rows and their states.
|
|
199
|
+
groups: (manifest.groups ?? []).filter((g) => !resolvedAgent || (g.agents ?? []).includes(resolvedAgent)),
|
|
200
|
+
profiles: manifest.profiles ?? {},
|
|
201
|
+
items,
|
|
202
|
+
findings,
|
|
203
|
+
summary: {
|
|
204
|
+
total: items.length,
|
|
205
|
+
installed: items.filter((i) => i.owned).length,
|
|
206
|
+
present: items.filter(
|
|
207
|
+
(i) => !["absent", "not-applicable", "unchecked"].includes(i.state),
|
|
208
|
+
).length,
|
|
209
|
+
broken: broken.length,
|
|
210
|
+
upgradable: upgradable.length,
|
|
211
|
+
findings: findings.length,
|
|
212
|
+
problems: findings.filter((f) => f.severity === "problem").length,
|
|
213
|
+
advisories: findings.filter((f) => f.severity === "advisory").length,
|
|
214
|
+
versionDrift: Boolean(recordedVersion && recordedVersion !== packageVersion),
|
|
215
|
+
byState,
|
|
216
|
+
},
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/** True when the report should exit non-zero (code 2). Advisories do not count. */
|
|
221
|
+
export function hasDrift(report) {
|
|
222
|
+
return report.summary.problems > 0 || report.summary.broken > 0;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
// ── per-item evaluation ─────────────────────────────────────────────────────
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* The three-way merge base for a workspace: the snapshot of the source tree at
|
|
229
|
+
* the version the workspace recorded. Null when there is no recorded version or
|
|
230
|
+
* the snapshot is gone (pre-`.versions/` install, or past retention) — callers
|
|
231
|
+
* degrade to a two-way comparison and say so.
|
|
232
|
+
*
|
|
233
|
+
* @returns {string|null} absolute path to `.versions/<recorded>`, or null
|
|
234
|
+
*/
|
|
235
|
+
export function resolveBaseRoot(sourceRoot, recordedVersion) {
|
|
236
|
+
if (!recordedVersion) return null;
|
|
237
|
+
const path = join(sourceRoot, ".versions", recordedVersion);
|
|
238
|
+
return existsSync(path) ? path : null;
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/**
|
|
242
|
+
* Evaluate every manifest item for one agent against the workspace. Shared by
|
|
243
|
+
* `verify` (which reports the result) and `plan` (which decides on it), so the
|
|
244
|
+
* two can never disagree about what state a file is in.
|
|
245
|
+
*
|
|
246
|
+
* Writes nothing.
|
|
247
|
+
*
|
|
248
|
+
* @param {object} opts
|
|
249
|
+
* @param {number} [opts.fileLimit] per-item cap on the reported `files` array.
|
|
250
|
+
* `verify` caps it for display; the planner passes Infinity because it needs
|
|
251
|
+
* every conflicting path to write the `.new` files in Phase 4.
|
|
252
|
+
* @returns {object[]} item evaluations, sorted by id
|
|
253
|
+
*/
|
|
254
|
+
export function evaluateWorkspace({
|
|
255
|
+
workspace,
|
|
256
|
+
sourceRoot,
|
|
257
|
+
manifest,
|
|
258
|
+
agent,
|
|
259
|
+
platform = process.platform,
|
|
260
|
+
state = null,
|
|
261
|
+
baseRoot = null,
|
|
262
|
+
fileLimit = 20,
|
|
263
|
+
}) {
|
|
264
|
+
const items = [];
|
|
265
|
+
for (const item of itemsForAgent(manifest, agent)) {
|
|
266
|
+
if (item.platform !== "any" && item.platform !== platform) continue;
|
|
267
|
+
items.push(evaluateItem({
|
|
268
|
+
item,
|
|
269
|
+
binding: item.binding,
|
|
270
|
+
workspace,
|
|
271
|
+
sourceRoot,
|
|
272
|
+
baseRoot,
|
|
273
|
+
recorded: state?.items?.[item.id] ?? null,
|
|
274
|
+
fileLimit,
|
|
275
|
+
}));
|
|
276
|
+
}
|
|
277
|
+
return items.sort((a, b) => (a.id < b.id ? -1 : 1));
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded, fileLimit = 20 }) {
|
|
281
|
+
const base = {
|
|
282
|
+
id: item.id,
|
|
283
|
+
kind: item.kind,
|
|
284
|
+
group: item.group,
|
|
285
|
+
subcategory: item.subcategory ?? null,
|
|
286
|
+
title: item.title,
|
|
287
|
+
summary: item.summary ?? "",
|
|
288
|
+
recommended: item.recommended,
|
|
289
|
+
consent: item.consent,
|
|
290
|
+
target: binding.target,
|
|
291
|
+
owned: Boolean(recorded),
|
|
292
|
+
// How this item was last installed. The planner compares it against the
|
|
293
|
+
// requested method: content can be up to date while the *form* is wrong,
|
|
294
|
+
// and a copy is not a symlink however identical the bytes are.
|
|
295
|
+
recordedMethod: recorded?.method ?? null,
|
|
296
|
+
retired: Boolean(item.retired),
|
|
297
|
+
// The two consent classes the engine refuses to perform carry what the
|
|
298
|
+
// human needs instead — the exact commands, or the package spec. Without
|
|
299
|
+
// them a report of "operator step" is a dead end.
|
|
300
|
+
...(item.operatorSteps ? { operatorSteps: item.operatorSteps } : {}),
|
|
301
|
+
...(item.package?.spec ? { packageSpec: item.package.spec } : {}),
|
|
302
|
+
};
|
|
303
|
+
|
|
304
|
+
// Nothing on disk to compare: the engine never applies these itself.
|
|
305
|
+
if (["exec", "operator", "external"].includes(binding.strategy)) {
|
|
306
|
+
return { ...base, state: "not-applicable", detail: consentDetail(item) };
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
// Forms that share their file with the user: compare only our part of it.
|
|
310
|
+
if (binding.strategy === "managed-region") {
|
|
311
|
+
return { ...base, ...compareRegion({ binding, workspace, sourceRoot, baseRoot, recorded }) };
|
|
312
|
+
}
|
|
313
|
+
if (binding.strategy === "json-merge") {
|
|
314
|
+
return { ...base, ...compareJsonKeys({ binding, workspace, sourceRoot, baseRoot, recorded }) };
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
const pairs = expandBinding(binding, sourceRoot);
|
|
318
|
+
if (pairs.length === 0) {
|
|
319
|
+
return { ...base, state: "gone", detail: "no source for this item in the current package" };
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
const recordedHashes = new Map((recorded?.files ?? []).map((f) => [f.path, f.sha256]));
|
|
323
|
+
const agent = agentOf(item, binding);
|
|
324
|
+
const results = [];
|
|
325
|
+
const changed = [];
|
|
326
|
+
|
|
327
|
+
for (const pair of pairs) {
|
|
328
|
+
const targetAbs = join(workspace, pair.targetRel);
|
|
329
|
+
const found = inspectPath(targetAbs);
|
|
330
|
+
|
|
331
|
+
if (found.kind === "absent") {
|
|
332
|
+
results.push({ state: "absent" });
|
|
333
|
+
continue;
|
|
334
|
+
}
|
|
335
|
+
if (found.kind === "symlink") {
|
|
336
|
+
if (found.dangling) {
|
|
337
|
+
results.push({ state: "broken-link" });
|
|
338
|
+
changed.push({ path: pair.targetRel, state: "broken-link", detail: "link target does not exist" });
|
|
339
|
+
continue;
|
|
340
|
+
}
|
|
341
|
+
const recordedRoot = recorded?.sourceRoot ?? sourceRoot;
|
|
342
|
+
if (isInside(sourceRoot, found.linkTarget) || isInside(recordedRoot, found.linkTarget)) {
|
|
343
|
+
results.push({ state: "linked", linkTarget: found.linkTarget });
|
|
344
|
+
continue;
|
|
345
|
+
}
|
|
346
|
+
results.push({ state: "foreign-link" });
|
|
347
|
+
changed.push({
|
|
348
|
+
path: pair.targetRel,
|
|
349
|
+
state: "foreign-link",
|
|
350
|
+
detail: `resolves outside the source root — ${found.linkTarget}`,
|
|
351
|
+
});
|
|
352
|
+
continue;
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
const files = pair.isDir
|
|
356
|
+
? walkTree(pair.sourceAbs).map((rel) => compareOne({
|
|
357
|
+
rel: `${pair.targetRel}/${rel}`,
|
|
358
|
+
ours: hashFile(join(targetAbs, rel)),
|
|
359
|
+
theirs: hashFile(join(pair.sourceAbs, rel)),
|
|
360
|
+
base: baseHashOf({ baseRoot, sourceRel: `${pair.sourceRel}/${rel}`, agent, transform: false }),
|
|
361
|
+
recorded: recordedHashes.get(`${pair.targetRel}/${rel}`) ?? null,
|
|
362
|
+
}))
|
|
363
|
+
: [compareOne({
|
|
364
|
+
rel: pair.targetRel,
|
|
365
|
+
ours: hashFile(targetAbs),
|
|
366
|
+
theirs: binding.strategy === "transform-persona"
|
|
367
|
+
? transformedHash(pair.sourceAbs, agent)
|
|
368
|
+
: hashFile(pair.sourceAbs),
|
|
369
|
+
base: baseHashOf({
|
|
370
|
+
baseRoot,
|
|
371
|
+
sourceRel: pair.sourceRel,
|
|
372
|
+
agent,
|
|
373
|
+
transform: binding.strategy === "transform-persona",
|
|
374
|
+
}),
|
|
375
|
+
recorded: recordedHashes.get(pair.targetRel) ?? null,
|
|
376
|
+
})];
|
|
377
|
+
|
|
378
|
+
results.push({ state: worstOf(files.map((f) => f.state)) ?? "up-to-date", fileCount: files.length });
|
|
379
|
+
changed.push(...files.filter((f) => f.state !== "up-to-date"));
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
const absentPairs = results.filter((r) => r.state === "absent").length;
|
|
383
|
+
let state;
|
|
384
|
+
if (absentPairs === results.length) {
|
|
385
|
+
state = recorded ? "missing" : "absent";
|
|
386
|
+
} else {
|
|
387
|
+
state = worstOf(results.filter((r) => r.state !== "absent").map((r) => r.state)) ?? "up-to-date";
|
|
388
|
+
// Some pieces present, some not: broken if we installed it, merely
|
|
389
|
+
// incomplete if we did not.
|
|
390
|
+
if (absentPairs > 0) state = recorded ? "missing" : worstOf([state, "partial"]);
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
const out = {
|
|
394
|
+
...base,
|
|
395
|
+
state,
|
|
396
|
+
fileCount: results.reduce((n, r) => n + (r.fileCount ?? 0), 0),
|
|
397
|
+
changedCount: changed.length,
|
|
398
|
+
};
|
|
399
|
+
// A path this item used to install to that is still occupied. The runtime
|
|
400
|
+
// does not know it is stale — pi will keep offering `/spec` from a legacy
|
|
401
|
+
// `.pi/prompts/spec.md` — so it is reported rather than merely cleaned up on
|
|
402
|
+
// the next apply.
|
|
403
|
+
const stale = (binding.legacyTargets ?? []).filter((rel) => existsSync(join(workspace, rel)));
|
|
404
|
+
if (stale.length > 0) out.legacyTargets = stale;
|
|
405
|
+
if (changed.length > 0) {
|
|
406
|
+
out.files = Number.isFinite(fileLimit) ? changed.slice(0, fileLimit) : changed;
|
|
407
|
+
}
|
|
408
|
+
if (state === "linked") out.linkTarget = results.find((r) => r.linkTarget)?.linkTarget;
|
|
409
|
+
if (!base.owned && state !== "absent") {
|
|
410
|
+
out.detail = "present but not recorded — agent-fleet did not install it";
|
|
411
|
+
}
|
|
412
|
+
return out;
|
|
413
|
+
}
|
|
414
|
+
|
|
415
|
+
/**
|
|
416
|
+
* Turn a binding into concrete (source → target) pairs.
|
|
417
|
+
*
|
|
418
|
+
* `sourceMode: "first"` treats `source` as an ordered candidate list and picks
|
|
419
|
+
* the first that exists (native skills shadowing the vendored copy).
|
|
420
|
+
* `sourceMode: "all"` installs every source, either under `target` by basename
|
|
421
|
+
* or — with `preserveLayout` — at its own repo-relative path.
|
|
422
|
+
*/
|
|
423
|
+
export function expandBinding(binding, sourceRoot) {
|
|
424
|
+
const out = [];
|
|
425
|
+
const push = (sourceRel, targetRel) => {
|
|
426
|
+
const sourceAbs = join(sourceRoot, sourceRel);
|
|
427
|
+
if (!existsSync(sourceAbs)) return;
|
|
428
|
+
out.push({ sourceRel, sourceAbs, targetRel, isDir: statSync(sourceAbs).isDirectory() });
|
|
429
|
+
};
|
|
430
|
+
|
|
431
|
+
if (binding.sourceMode === "all") {
|
|
432
|
+
for (const rel of binding.source ?? []) {
|
|
433
|
+
push(rel, binding.preserveLayout ? rel : `${binding.target}/${basename(rel)}`);
|
|
434
|
+
}
|
|
435
|
+
return out;
|
|
436
|
+
}
|
|
437
|
+
|
|
438
|
+
const first = (binding.source ?? []).find((rel) => existsSync(join(sourceRoot, rel)));
|
|
439
|
+
if (first && binding.target) push(first, binding.target);
|
|
440
|
+
return out;
|
|
441
|
+
}
|
|
442
|
+
|
|
443
|
+
/**
|
|
444
|
+
* A managed region is compared as its sentinel-bounded block, never as the
|
|
445
|
+
* whole file — the user's other recipes are not drift.
|
|
446
|
+
*/
|
|
447
|
+
function compareRegion({ binding, workspace, sourceRoot, baseRoot, recorded }) {
|
|
448
|
+
const blockOf = (path) => {
|
|
449
|
+
const found = extractRegion(readTextOrNull(path));
|
|
450
|
+
return found ? hashText(found.block) : null;
|
|
451
|
+
};
|
|
452
|
+
const theirs = blockOf(join(sourceRoot, binding.source?.[0] ?? ""));
|
|
453
|
+
if (theirs === null) return { state: "gone", detail: "no managed region in the current source" };
|
|
454
|
+
|
|
455
|
+
const targetAbs = join(workspace, binding.target);
|
|
456
|
+
if (!existsSync(targetAbs)) return { state: recorded ? "missing" : "absent" };
|
|
457
|
+
|
|
458
|
+
const ours = blockOf(targetAbs);
|
|
459
|
+
if (ours === null) {
|
|
460
|
+
return recorded
|
|
461
|
+
? { state: "missing", detail: "the managed region is gone from the file" }
|
|
462
|
+
: { state: "absent", detail: "file exists but carries no agent-fleet region" };
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
const result = compareOne({
|
|
466
|
+
rel: binding.target,
|
|
467
|
+
ours,
|
|
468
|
+
theirs,
|
|
469
|
+
base: baseRoot ? blockOf(join(baseRoot, binding.source[0])) : null,
|
|
470
|
+
recorded: recorded?.files?.find((f) => f.path === binding.target)?.sha256 ?? null,
|
|
471
|
+
});
|
|
472
|
+
return result.state === "up-to-date"
|
|
473
|
+
? { state: "up-to-date", fileCount: 1 }
|
|
474
|
+
: { state: result.state, fileCount: 1, changedCount: 1, files: [{ ...result, detail: "managed region" }] };
|
|
475
|
+
}
|
|
476
|
+
|
|
477
|
+
/**
|
|
478
|
+
* A JSON merge is compared key path by key path, so unrelated settings — user
|
|
479
|
+
* permissions, other hooks, third-party MCP servers — are never drift.
|
|
480
|
+
*/
|
|
481
|
+
function compareJsonKeys({ binding, workspace, sourceRoot, baseRoot, recorded }) {
|
|
482
|
+
const fragment = readJsonOrNull(join(sourceRoot, binding.source?.[0] ?? ""));
|
|
483
|
+
if (!fragment) return { state: "gone", detail: "no merge fragment in the current source" };
|
|
484
|
+
|
|
485
|
+
const targetAbs = join(workspace, binding.target);
|
|
486
|
+
if (!existsSync(targetAbs)) return { state: recorded ? "missing" : "absent" };
|
|
487
|
+
|
|
488
|
+
const target = readJsonOrNull(targetAbs);
|
|
489
|
+
if (!target) return { state: "modified", detail: `${binding.target} is not valid JSON` };
|
|
490
|
+
|
|
491
|
+
const baseDoc = baseRoot ? readJsonOrNull(join(baseRoot, binding.source[0])) : null;
|
|
492
|
+
const recordedKeys = new Map((recorded?.jsonKeys ?? []).map((k) => [k.keyPath, k.sha256]));
|
|
493
|
+
const files = [];
|
|
494
|
+
|
|
495
|
+
for (const [path, value] of leafPaths(fragment)) {
|
|
496
|
+
const keyPath = path.join(".");
|
|
497
|
+
const present = getPath(target, path);
|
|
498
|
+
if (present === undefined) { files.push({ path: keyPath, state: "missing" }); continue; }
|
|
499
|
+
files.push(compareOne({
|
|
500
|
+
rel: keyPath,
|
|
501
|
+
ours: hashText(canonicalJson(present)),
|
|
502
|
+
theirs: hashText(canonicalJson(value)),
|
|
503
|
+
base: baseDoc ? hashText(canonicalJson(getPath(baseDoc, path))) : null,
|
|
504
|
+
recorded: recordedKeys.get(keyPath) ?? null,
|
|
505
|
+
}));
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
const changed = files.filter((f) => f.state !== "up-to-date");
|
|
509
|
+
const state = changed.length === 0
|
|
510
|
+
? "up-to-date"
|
|
511
|
+
: (recorded ? worstOf(changed.map((f) => f.state)) : "absent");
|
|
512
|
+
return changed.length === 0
|
|
513
|
+
? { state, fileCount: files.length }
|
|
514
|
+
: { state, fileCount: files.length, changedCount: changed.length, files: changed };
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
function readTextOrNull(path) {
|
|
518
|
+
try { return readFileSync(path, "utf8"); } catch { return null; }
|
|
519
|
+
}
|
|
520
|
+
|
|
521
|
+
function readJsonOrNull(path) {
|
|
522
|
+
try { return JSON.parse(readFileSync(path, "utf8")); } catch { return null; }
|
|
523
|
+
}
|
|
524
|
+
|
|
525
|
+
function compareOne({ rel, ours, theirs, base, recorded }) {
|
|
526
|
+
if (ours === null) return { path: rel, state: "missing" };
|
|
527
|
+
if (theirs === null) return { path: rel, state: "gone" };
|
|
528
|
+
if (ours === theirs) return { path: rel, state: "up-to-date" };
|
|
529
|
+
|
|
530
|
+
// Untracked file: we can say it differs from the source, nothing more.
|
|
531
|
+
if (!recorded) return { path: rel, state: "modified" };
|
|
532
|
+
|
|
533
|
+
if (ours === recorded) return { path: rel, state: "outdated" };
|
|
534
|
+
if (base === null) return { path: rel, state: "modified", detail: "no merge base" };
|
|
535
|
+
if (base === theirs) return { path: rel, state: "modified" };
|
|
536
|
+
return { path: rel, state: "conflict" };
|
|
537
|
+
}
|
|
538
|
+
|
|
539
|
+
function baseHashOf({ baseRoot, sourceRel, agent, transform }) {
|
|
540
|
+
if (!baseRoot) return null;
|
|
541
|
+
const path = join(baseRoot, sourceRel);
|
|
542
|
+
if (!existsSync(path)) return null;
|
|
543
|
+
return transform ? transformedHash(path, agent) : hashFile(path);
|
|
544
|
+
}
|
|
545
|
+
|
|
546
|
+
// Personas are generated, so "theirs" is the transform output — comparing the
|
|
547
|
+
// installed file against the raw canonical source would flag every persona as
|
|
548
|
+
// modified (SKILL.md step 6 makes the same point in prose).
|
|
549
|
+
function transformedHash(sourcePath, agent) {
|
|
550
|
+
if (!agent) return null;
|
|
551
|
+
try {
|
|
552
|
+
const { content } = transformPersona(readFileSync(sourcePath, "utf8"), { agent });
|
|
553
|
+
return hashText(content);
|
|
554
|
+
} catch { return null; }
|
|
555
|
+
}
|
|
556
|
+
|
|
557
|
+
function agentOf(item, binding) {
|
|
558
|
+
return Object.keys(item.agents ?? {}).find((a) => item.agents[a] === binding) ?? null;
|
|
559
|
+
}
|
|
560
|
+
|
|
561
|
+
function worstOf(states) {
|
|
562
|
+
let worst = null;
|
|
563
|
+
for (const s of states) {
|
|
564
|
+
if (worst === null || (SEVERITY[s] ?? 0) > (SEVERITY[worst] ?? 0)) worst = s;
|
|
565
|
+
}
|
|
566
|
+
return worst;
|
|
567
|
+
}
|
|
568
|
+
|
|
569
|
+
function consentDetail(item) {
|
|
570
|
+
switch (item.consent) {
|
|
571
|
+
case "operator": return "operator-applied — the engine reports steps, never performs them";
|
|
572
|
+
case "exec": return "runs a command; requires --allow-exec";
|
|
573
|
+
case "external": return `external package: ${item.package?.spec ?? "unknown"}`;
|
|
574
|
+
default: return "no workspace target";
|
|
575
|
+
}
|
|
576
|
+
}
|
package/bin/snapshot-version.js
CHANGED
|
@@ -64,6 +64,11 @@ const ARTIFACT_PATHS = [
|
|
|
64
64
|
"docs/pi-setup.md",
|
|
65
65
|
"references",
|
|
66
66
|
"hooks",
|
|
67
|
+
// The generated catalogue. The upgrade three-way merge needs the *recorded
|
|
68
|
+
// version's* manifest, not just its files: an item that existed then and is
|
|
69
|
+
// retired now is only resolvable from the base catalogue.
|
|
70
|
+
"install-manifest.json",
|
|
71
|
+
"manifest-meta.json",
|
|
67
72
|
];
|
|
68
73
|
|
|
69
74
|
if (existsSync(snapDir)) {
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -109,13 +109,45 @@ per process (`provider-semaphore.js`: 2 in flight for `custom/*` by default, unl
|
|
|
109
109
|
elsewhere, `AGENT_HUB_PROVIDER_LIMITS` to override) — the cap is per level of the delegation
|
|
110
110
|
tree, and a nested spawn reuses its parent's permit so it can never wait on its own ancestor.
|
|
111
111
|
Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
|
|
112
|
-
`max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs
|
|
113
|
-
switched live with `/af-hub-mode`.
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
and the
|
|
118
|
-
|
|
112
|
+
`max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`,
|
|
113
|
+
`run-history-keep`); switched live with `/af-hub-mode`.
|
|
114
|
+
|
|
115
|
+
A per-message allowance cannot bound a task, so a second envelope sits above the turn one:
|
|
116
|
+
the **task budget** (`run-budget.js`, `3×` the turn envelope) counts dispatches, research
|
|
117
|
+
runs and **active** time across the WHOLE task and is *not* reset by a user message. Active
|
|
118
|
+
time is turns that ran minus `ask_user` waits — a task clock that billed human idle would
|
|
119
|
+
false-stop a normal steered session, and a false stop teaches people to reset the window
|
|
120
|
+
reflexively. The auto-research pipe is exempt from the turn budget but charged against the
|
|
121
|
+
task envelope, so it cannot smuggle 8 helpers per dispatch past the outer bound. Exhausting
|
|
122
|
+
the task budget is a hard stop — only `/af-new-task` (or `set_task_tier` with
|
|
123
|
+
`new_task: true`) opens a new window. This is the guardrail the post-mortem run never hit: every steering message
|
|
124
|
+
reopened the turn window, so one workspace stayed open 47 hours on a change that took 13
|
|
125
|
+
minutes in a narrow one.
|
|
126
|
+
|
|
127
|
+
On top of the mode sit several qualitative guardrails. **Task triage**: the dispatcher
|
|
128
|
+
classifies the current TASK via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
|
|
129
|
+
and the caps drop to min(mode, tier). The tier is task-scoped and **ratcheted** — it survives
|
|
130
|
+
the user's next message, lowering is free, raising needs a stated `reason` — because a
|
|
131
|
+
turn-scoped tier reset to `feature` on every correction. Three refusals enforce
|
|
132
|
+
proportionality in code rather than prose: a duplicate-dispatch guard (near-identical
|
|
133
|
+
re-dispatches within a turn), a **tier persona gate** (`planner`, `plan-reviewer`,
|
|
134
|
+
`architect`, `security-auditor`, `deep-researcher` are refused at trivial/small — each opens
|
|
135
|
+
a document/finding loop), and a **review round cap** (review dispatches per task, by tier).
|
|
136
|
+
Skipping triage assumes `small`, not `feature`: the tier latches for the task, and the case
|
|
137
|
+
where it was never declared is exactly the case where proportionality was not being
|
|
138
|
+
considered. The review **finding** budget is the one thing deliberately left advisory — the
|
|
139
|
+
hub counts blocking findings (`review-findings.js`) and reports an over-budget return, but
|
|
140
|
+
never reclassifies one, because no rule it can evaluate separates an invented manifest from
|
|
141
|
+
a leaked credential; the round cap is what carries the enforcement.
|
|
142
|
+
**Docs lane** (`docs-lane.js`): a dispatch whose whole declared `scope` is documentation
|
|
143
|
+
refuses review personas (overridable with `review_reason`) and tells the dispatcher not to
|
|
144
|
+
open a review gate; an absent scope is never the lighter lane. **External-blocker stop**
|
|
145
|
+
(`external-blocker.js`): a specialist emits `EXTERNAL_BLOCKED: …` when it needs something
|
|
146
|
+
outside the fleet's reach (account, permission, credential, telemetry destination), and the
|
|
147
|
+
hub refuses the next dispatch with an owner-escalation packet until the human is addressed —
|
|
148
|
+
the alternative, observed, is hours spent approximating the missing fact with scripts,
|
|
149
|
+
manifests and fixtures while the assertion still ends UNPROVEN. **Drift watchdog**
|
|
150
|
+
(`drift-watchdog.js`): armed dispatches are
|
|
119
151
|
observed in-flight from the JSON event stream — deterministic rules (out-of-scope writes
|
|
120
152
|
against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
|
|
121
153
|
escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
|
|
@@ -214,10 +246,19 @@ packages/hermes-bridge/ # future Hermes integration package
|
|
|
214
246
|
at 8 — an id nobody can trace back to a plan line costs a dispatch and an
|
|
215
247
|
ASK_USER cycle to re-derive.
|
|
216
248
|
- **Pre-flight validation is free.** Anything the hub can reject before spawning
|
|
217
|
-
— an unresolvable artifact path, an unknown research persona
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
under `returns/` while
|
|
249
|
+
— an unresolvable artifact path, an unknown research persona, a heavy persona
|
|
250
|
+
at a low tier, a reviewer on a docs-only scope — is refused without spending a
|
|
251
|
+
budget slot. Artifact paths also resolve across artifact kinds when the name is
|
|
252
|
+
unique, since the hub writes every auto-return under `returns/` while
|
|
253
|
+
dispatchers reasonably guess `reviews/`.
|
|
254
|
+
- **Evidence is archived, never overwritten.** Session start moves the previous
|
|
255
|
+
session's `artifacts/` into an immutable `.pi/agent-sessions/runs/<runId>/`
|
|
256
|
+
namespace with a read-only `meta.json` and an appended `runs/index.json`
|
|
257
|
+
(`run-namespace.js`), retained per `run-history-keep` (default 10). The old
|
|
258
|
+
behaviour — delete `artifacts/` at start, name returns by a per-session counter
|
|
259
|
+
— collided two ways at once and made a post-mortem record eleven specialist
|
|
260
|
+
returns and two reviews as NOT RECOVERABLE. A failed archive leaves the
|
|
261
|
+
artifacts in place: a stale tree is recoverable, a deleted one is not.
|
|
221
262
|
- **Herdr owns panes, presence, and lifecycle; coms owns messages.** Fleet
|
|
222
263
|
recipes hard-require a running herdr server and refuse with an actionable
|
|
223
264
|
message otherwise; non-fleet recipes never touch herdr.
|