@chankov/agent-fleet 0.0.11 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +26 -25
- package/.pi/extensions/btw/index.ts +80 -83
- package/.pi/extensions/pi-voice-stt/README.md +4 -3
- package/.pi/extensions/pi-voice-stt/config.ts +1 -1
- package/.pi/harnesses/agent-hub/README.md +106 -54
- package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
- package/.pi/harnesses/agent-hub/footer.ts +4 -0
- package/.pi/harnesses/agent-hub/helpers.ts +18 -0
- package/.pi/harnesses/agent-hub/index.ts +537 -369
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.pi/harnesses/ask-user-remote/README.md +37 -3
- package/.pi/harnesses/ask-user-remote/index.ts +173 -17
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.pi/harnesses/package-lock.json +2011 -0
- package/.pi/harnesses/package.json +1 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
- package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
- package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
- package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
- package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
- package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
- package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
- package/.versions/0.0.11/docs/getting-started.md +26 -237
- package/.versions/0.0.11/docs/npm-install.md +60 -478
- package/.versions/0.0.11/docs/pi-extensions.md +4 -4
- package/.versions/0.0.11/docs/pi-setup.md +37 -551
- package/.versions/0.0.11/hermes/README.md +1 -1
- package/.versions/0.0.11/install-manifest.json +375 -1247
- package/.versions/0.0.11/justfile +13 -6
- package/.versions/0.0.11/manifest-meta.json +543 -134
- package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
- package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
- package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
- package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
- package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
- package/.versions/1.0.0/.pi/extensions/package.json +9 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
- package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
- package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
- package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
- package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
- package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
- package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
- package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.0/.version +1 -0
- package/.versions/1.0.0/agents/architect.md +24 -0
- package/.versions/1.0.0/agents/bowser.md +27 -0
- package/.versions/1.0.0/agents/builder.md +54 -0
- package/.versions/1.0.0/agents/code-reviewer.md +208 -0
- package/.versions/1.0.0/agents/deep-researcher.md +32 -0
- package/.versions/1.0.0/agents/documenter.md +18 -0
- package/.versions/1.0.0/agents/orchestrator.md +72 -0
- package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.0/agents/planner.md +70 -0
- package/.versions/1.0.0/agents/releaser.md +24 -0
- package/.versions/1.0.0/agents/researcher.md +28 -0
- package/.versions/1.0.0/agents/security-auditor.md +167 -0
- package/.versions/1.0.0/agents/test-engineer.md +153 -0
- package/.versions/1.0.0/agents/web-debugger.md +43 -0
- package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
- package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
- package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.0/docs/getting-started.md +98 -0
- package/.versions/1.0.0/docs/npm-install.md +292 -0
- package/.versions/1.0.0/docs/pi-extensions.md +412 -0
- package/.versions/1.0.0/docs/pi-setup.md +74 -0
- package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.0/hermes/README.md +347 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.0/install-manifest.json +2745 -0
- package/.versions/1.0.0/justfile +272 -0
- package/.versions/1.0.0/manifest-meta.json +882 -0
- package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.0/references/definition-of-done.md +67 -0
- package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.0/references/observability-checklist.md +91 -0
- package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.0/references/performance-checklist.md +153 -0
- package/.versions/1.0.0/references/prompting-patterns.md +380 -0
- package/.versions/1.0.0/references/security-checklist.md +179 -0
- package/.versions/1.0.0/references/testing-patterns.md +236 -0
- package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.0/scripts/fleet.ts +185 -0
- package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.0/scripts/team-up.ts +406 -0
- package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +142 -0
- package/README.md +117 -79
- package/agents/orchestrator.md +1 -1
- package/bin/cli.js +289 -359
- package/bin/force-patch-changesets.js +18 -2
- package/bin/lib/apply.js +86 -32
- package/bin/lib/desired.js +87 -0
- package/bin/lib/detect-agent.js +22 -38
- package/bin/lib/doctor.js +283 -33
- package/bin/lib/features.js +78 -0
- package/bin/lib/manifest.js +127 -48
- package/bin/lib/overrides.js +35 -0
- package/bin/lib/personas.js +37 -0
- package/bin/lib/plan.js +18 -9
- package/bin/lib/purge.js +11 -0
- package/bin/lib/reconcile.js +68 -0
- package/bin/lib/scan.js +24 -0
- package/bin/lib/state.js +25 -1
- package/bin/lib/stt-wizard.js +33 -0
- package/bin/lib/transaction.js +149 -0
- package/bin/lib/tui.js +71 -0
- package/bin/lib/verify.js +9 -26
- package/bin/snapshot-version.js +3 -6
- package/docs/ARCHITECTURE.md +55 -21
- package/docs/MIGRATION-agent-fleet.md +222 -0
- package/docs/agent-fleet-setup.md +124 -64
- package/docs/claude-code-coms-bridge.md +21 -2
- package/docs/coms-hermes-bridge.md +1 -1
- package/docs/getting-started.md +61 -217
- package/docs/npm-install.md +207 -429
- package/docs/pi-extensions.md +85 -41
- package/docs/pi-setup.md +48 -545
- package/hermes/README.md +1 -1
- package/install-manifest.json +385 -1255
- package/justfile +45 -27
- package/manifest-meta.json +544 -134
- package/node_modules/pi-ask-user/README.md +43 -5
- package/node_modules/pi-ask-user/index.ts +630 -75
- package/node_modules/pi-ask-user/package.json +1 -1
- package/package.json +5 -11
- package/scripts/coms-claude-bridge.ts +10 -0
- package/scripts/fleet.ts +107 -90
- package/scripts/lib/claude-bridge-core.ts +45 -0
- package/scripts/lib/fleet-command.ts +170 -15
- package/scripts/lib/monitor-env.ts +18 -6
- package/scripts/lib/peer-launch.ts +6 -2
- package/scripts/lib/team-project.ts +24 -4
- package/scripts/team-up.ts +57 -11
- package/skills/designing-agents/SKILL.md +1 -1
- package/skills/designing-agents/pi-harness-authoring.md +3 -3
- package/.claude/commands/build.md +0 -44
- package/.claude/commands/design-agent.md +0 -14
- package/.claude/commands/doctor-agent-fleet.md +0 -22
- package/.claude/commands/orchestrate.md +0 -112
- package/.claude/commands/prime.md +0 -22
- package/.claude/commands/review.md +0 -16
- package/.claude/commands/set-hermes-telegram.md +0 -15
- package/.claude/commands/set-hermes-watchdog.md +0 -6
- package/.claude/commands/setup-agent-fleet.md +0 -17
- package/.claude/commands/ship.md +0 -72
- package/.claude/commands/spec.md +0 -15
- package/.claude/commands/test.md +0 -19
- package/.claude/commands/webperf.md +0 -32
- package/.claude/orchestrate-teams.yaml +0 -24
- package/.opencode/commands/af-build.md +0 -17
- package/.opencode/commands/af-code-simplify.md +0 -16
- package/.opencode/commands/af-compound.md +0 -16
- package/.opencode/commands/af-design-agent.md +0 -15
- package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.opencode/commands/af-orchestrate.md +0 -112
- package/.opencode/commands/af-plan.md +0 -16
- package/.opencode/commands/af-prime.md +0 -22
- package/.opencode/commands/af-review.md +0 -15
- package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
- package/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.opencode/commands/af-ship.md +0 -16
- package/.opencode/commands/af-spec.md +0 -16
- package/.opencode/commands/af-test.md +0 -21
- package/.opencode/commands/af-webperf.md +0 -32
- package/.opencode/orchestrate-teams.yaml +0 -24
- package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
- package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
- package/.versions/0.0.11/.claude/commands/build.md +0 -44
- package/.versions/0.0.11/.claude/commands/code-simplify.md +0 -22
- package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
- package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
- package/.versions/0.0.11/.claude/commands/plan.md +0 -16
- package/.versions/0.0.11/.claude/commands/prime.md +0 -22
- package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
- package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
- package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
- package/.versions/0.0.11/.claude/commands/ship.md +0 -72
- package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
- package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
- package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
- package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
- package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
- package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
- package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
- package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
- package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
- package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.11/docs/opencode-setup.md +0 -281
- package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
- package/.versions/0.0.11/hooks/hooks.json +0 -14
- package/.versions/0.0.11/hooks/session-start.sh +0 -74
- package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
- package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
- package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
- package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
- package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
- package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
- package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
- package/bin/lib/bootstrap.js +0 -323
- package/bin/lib/transform-persona.js +0 -180
- package/docs/opencode-setup.md +0 -281
- package/hooks/SIMPLIFY-IGNORE.md +0 -90
- package/hooks/hooks.json +0 -14
- package/hooks/session-start.sh +0 -74
- package/hooks/simplify-ignore.sh +0 -302
- package/skills/guided-workspace-setup/SKILL.md +0 -226
- /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
- /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
- /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
- /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
- /package/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
// transaction.js — crash-recoverable managed workspace commits.
|
|
2
|
+
|
|
3
|
+
import { closeSync, cpSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
|
|
4
|
+
import { tmpdir } from "node:os";
|
|
5
|
+
import { dirname, join, resolve, relative, sep } from "node:path";
|
|
6
|
+
import { STATE_REL_PATH, LEGACY_RECORD_REL_PATH } from "./state.js";
|
|
7
|
+
|
|
8
|
+
export const JOURNAL_REL_PATH = ".ai/agent-fleet-transaction.json";
|
|
9
|
+
const DESIRED_REL_PATH = ".ai/agent-fleet.json";
|
|
10
|
+
const OVERRIDES_REL_PATH = ".ai/agent-fleet-overrides.md";
|
|
11
|
+
const STT_REL_PATH = ".ai/stt.json";
|
|
12
|
+
|
|
13
|
+
export function journalPath(workspace) { return join(workspace, JOURNAL_REL_PATH); }
|
|
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
|
+
function sourceLeaves(path) {
|
|
27
|
+
if (!statSync(path).isDirectory()) return [""];
|
|
28
|
+
const leaves = [];
|
|
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;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function touchedPaths(plan, manifest) {
|
|
37
|
+
const paths = new Set([STATE_REL_PATH, LEGACY_RECORD_REL_PATH]);
|
|
38
|
+
const catalogue = new Map((manifest?.items ?? []).map((item) => [item.id, item]));
|
|
39
|
+
for (const action of plan.actions ?? []) {
|
|
40
|
+
for (const file of action.files ?? []) if (file.path) paths.add(file.path);
|
|
41
|
+
for (const path of action.paths ?? []) if (path) paths.add(path);
|
|
42
|
+
const binding = catalogue.get(action.id)?.agents?.[plan.agent];
|
|
43
|
+
if (!binding?.target) continue;
|
|
44
|
+
const source = (binding.source ?? []).map((path) => join(plan.sourceRoot, path)).find(existsSync);
|
|
45
|
+
if (binding.strategy === "copy-tree" && source) {
|
|
46
|
+
for (const leaf of sourceLeaves(source)) paths.add(join(binding.target, leaf));
|
|
47
|
+
} else {
|
|
48
|
+
paths.add(binding.target);
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
if (plan.writeDesired) paths.add(relativeOwnedPath(plan.workspace, plan.desiredPath ?? DESIRED_REL_PATH));
|
|
52
|
+
if (plan.overrides?.write) paths.add(relativeOwnedPath(plan.workspace, plan.overrides.path ?? OVERRIDES_REL_PATH));
|
|
53
|
+
if (plan.stt?.path) paths.add(relativeOwnedPath(plan.workspace, plan.stt.path ?? STT_REL_PATH));
|
|
54
|
+
if (plan.stt?.env?.missing?.length) paths.add(relativeOwnedPath(plan.workspace, plan.stt.env.path));
|
|
55
|
+
return [...paths].map((path) => relativeOwnedPath(plan.workspace, path)).sort();
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function backupTouchedPaths(workspace, paths) {
|
|
59
|
+
const backup = join(tmpdir(), `agent-fleet-tx-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);
|
|
60
|
+
mkdirSync(backup, { recursive: true });
|
|
61
|
+
const present = [];
|
|
62
|
+
for (const rel of paths) {
|
|
63
|
+
const source = join(workspace, rel);
|
|
64
|
+
if (!existsSync(source)) continue;
|
|
65
|
+
const destination = join(backup, rel);
|
|
66
|
+
mkdirSync(dirname(destination), { recursive: true });
|
|
67
|
+
cpSync(source, destination, { recursive: true, dereference: false });
|
|
68
|
+
present.push(rel);
|
|
69
|
+
}
|
|
70
|
+
return { backup, present };
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function restoreTouchedPaths(workspace, journal) {
|
|
74
|
+
for (const rel of journal.paths ?? []) rmSync(join(workspace, rel), { recursive: true, force: true });
|
|
75
|
+
for (const rel of journal.present ?? []) {
|
|
76
|
+
const source = join(journal.backup, rel);
|
|
77
|
+
if (!existsSync(source)) continue;
|
|
78
|
+
const destination = join(workspace, rel);
|
|
79
|
+
mkdirSync(dirname(destination), { recursive: true });
|
|
80
|
+
cpSync(source, destination, { recursive: true, dereference: false });
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export function transactionRecovery(workspace) {
|
|
85
|
+
const path = journalPath(workspace);
|
|
86
|
+
if (!existsSync(path)) return { pending: false, recoverable: false };
|
|
87
|
+
try {
|
|
88
|
+
const journal = JSON.parse(readFileSync(path, "utf8"));
|
|
89
|
+
return { pending: true, recoverable: Boolean(journal.backup && existsSync(journal.backup)) };
|
|
90
|
+
} catch {
|
|
91
|
+
return { pending: true, recoverable: false };
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Restore an interrupted transaction, returning false when none exists. */
|
|
96
|
+
export function recoverTransaction(workspace) {
|
|
97
|
+
const path = journalPath(workspace);
|
|
98
|
+
if (!existsSync(path)) return false;
|
|
99
|
+
let journal;
|
|
100
|
+
try { journal = JSON.parse(readFileSync(path, "utf8")); }
|
|
101
|
+
catch { throw Object.assign(new Error("transaction journal is unreadable or has no recoverable backup"), { unrecoverable: true }); }
|
|
102
|
+
if (!journal.backup || !existsSync(journal.backup)) {
|
|
103
|
+
throw Object.assign(new Error("transaction journal has no recoverable backup"), { unrecoverable: true });
|
|
104
|
+
}
|
|
105
|
+
restoreTouchedPaths(workspace, journal);
|
|
106
|
+
rmSync(journal.backup, { recursive: true, force: true });
|
|
107
|
+
rmSync(path, { force: true });
|
|
108
|
+
return true;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** The backup was reaped, so only the installer-owned journal can be discarded. */
|
|
112
|
+
export function discardUnrecoverableTransaction(workspace) {
|
|
113
|
+
rmSync(journalPath(workspace), { force: true });
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* Journal before mutation; restore only managed paths if commit throws.
|
|
118
|
+
* `validate` runs before journal creation, which is critical for conflicts,
|
|
119
|
+
* unsupported snapshot metadata, and rejected migrations.
|
|
120
|
+
*/
|
|
121
|
+
export function runTransaction({ workspace, plan, manifest, validate = () => {}, commit, failAt = null }) {
|
|
122
|
+
validate();
|
|
123
|
+
const paths = plan ? touchedPaths(plan, manifest) : [];
|
|
124
|
+
const { backup, present } = backupTouchedPaths(workspace, paths);
|
|
125
|
+
const path = journalPath(workspace);
|
|
126
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
127
|
+
const journal = { schemaVersion: 2, backup, paths, present };
|
|
128
|
+
// Durable pre-image: fsync the journal before any managed workspace write.
|
|
129
|
+
const fd = openSync(path, "w");
|
|
130
|
+
try {
|
|
131
|
+
writeSync(fd, JSON.stringify(journal, null, 2) + "\n");
|
|
132
|
+
fsyncSync(fd);
|
|
133
|
+
} finally {
|
|
134
|
+
closeSync(fd);
|
|
135
|
+
}
|
|
136
|
+
try {
|
|
137
|
+
if (failAt === "after-journal") throw new Error("injected transaction interruption");
|
|
138
|
+
const result = commit();
|
|
139
|
+
if (failAt === "after-commit") throw new Error("injected transaction interruption");
|
|
140
|
+
rmSync(path, { force: true });
|
|
141
|
+
rmSync(backup, { recursive: true, force: true });
|
|
142
|
+
return result;
|
|
143
|
+
} catch (error) {
|
|
144
|
+
restoreTouchedPaths(workspace, journal);
|
|
145
|
+
rmSync(path, { force: true });
|
|
146
|
+
rmSync(backup, { recursive: true, force: true });
|
|
147
|
+
throw error;
|
|
148
|
+
}
|
|
149
|
+
}
|
package/bin/lib/tui.js
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
// tui.js — dependency-free, readline-driven setup selection.
|
|
2
|
+
|
|
3
|
+
const CANCEL = /^(c|cancel|q|quit)$/i;
|
|
4
|
+
|
|
5
|
+
function enabledFeatures(desired) {
|
|
6
|
+
return Object.entries(desired?.features ?? {})
|
|
7
|
+
.filter(([, enabled]) => enabled)
|
|
8
|
+
.map(([name]) => name)
|
|
9
|
+
.sort();
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
function featureList(manifest) {
|
|
13
|
+
return Object.keys(manifest.features ?? {}).sort()
|
|
14
|
+
.map((name) => ` - ${name} (${manifest.features[name].stability ?? "stable"})`)
|
|
15
|
+
.join("\n");
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Collect an editable desired-state selection. Application confirmation belongs
|
|
20
|
+
* to the caller after it has rendered the complete reconciliation plan.
|
|
21
|
+
*/
|
|
22
|
+
export async function chooseSetup({ output, readLine, manifest, currentDesired = null }) {
|
|
23
|
+
const currentPreset = currentDesired?.preset ?? "default";
|
|
24
|
+
const currentFeatures = enabledFeatures(currentDesired);
|
|
25
|
+
const ask = async (question) => {
|
|
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 };
|
|
55
|
+
const value = answer.trim();
|
|
56
|
+
const selected = value === "" ? currentFeatures : value === "none" ? [] : [...new Set(value.split(",").map((name) => name.trim()).filter(Boolean))].sort();
|
|
57
|
+
const unknown = selected.find((name) => !known.has(name));
|
|
58
|
+
if (unknown) {
|
|
59
|
+
output.write(`Unknown feature "${unknown}". Try again using one of the listed feature IDs.\n`);
|
|
60
|
+
continue;
|
|
61
|
+
}
|
|
62
|
+
features = selected;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
return {
|
|
66
|
+
cancelled: false,
|
|
67
|
+
preset,
|
|
68
|
+
features,
|
|
69
|
+
changed: preset !== currentPreset || features.join(",") !== currentFeatures.join(","),
|
|
70
|
+
};
|
|
71
|
+
}
|
package/bin/lib/verify.js
CHANGED
|
@@ -14,7 +14,6 @@ import { basename, join } from "node:path";
|
|
|
14
14
|
|
|
15
15
|
import { itemsForAgent } from "./manifest.js";
|
|
16
16
|
import { extractRegion, leafPaths, getPath, canonicalJson } from "./merge-forms.js";
|
|
17
|
-
import { transformPersona } from "./transform-persona.js";
|
|
18
17
|
import { runDoctor } from "./doctor.js";
|
|
19
18
|
import {
|
|
20
19
|
readState,
|
|
@@ -24,6 +23,7 @@ import {
|
|
|
24
23
|
walkTree,
|
|
25
24
|
inspectPath,
|
|
26
25
|
isInside,
|
|
26
|
+
linkPointsInside,
|
|
27
27
|
isVolatileSourceRoot,
|
|
28
28
|
isAgentFleetCheckout,
|
|
29
29
|
STATE_SCHEMA_VERSION,
|
|
@@ -48,6 +48,7 @@ export const ADVISORY_FINDINGS = new Set([
|
|
|
48
48
|
"legacy-target",
|
|
49
49
|
"overrides",
|
|
50
50
|
"yaml-shape",
|
|
51
|
+
"pi-package-ownership",
|
|
51
52
|
]);
|
|
52
53
|
|
|
53
54
|
// Worst-wins ordering when a tree item's files disagree.
|
|
@@ -145,7 +146,7 @@ export async function runVerify({
|
|
|
145
146
|
type: "agent-unknown",
|
|
146
147
|
path: STATE_REL_PATH,
|
|
147
148
|
issue: "no recorded or detected coding agent — cannot resolve install targets",
|
|
148
|
-
fix: "re-run with --agent
|
|
149
|
+
fix: "re-run with --agent pi",
|
|
149
150
|
});
|
|
150
151
|
} else {
|
|
151
152
|
items = evaluateWorkspace({
|
|
@@ -339,7 +340,7 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
|
|
|
339
340
|
continue;
|
|
340
341
|
}
|
|
341
342
|
const recordedRoot = recorded?.sourceRoot ?? sourceRoot;
|
|
342
|
-
if (
|
|
343
|
+
if (linkPointsInside(sourceRoot, found.linkTarget) || linkPointsInside(recordedRoot, found.linkTarget)) {
|
|
343
344
|
results.push({ state: "linked", linkTarget: found.linkTarget });
|
|
344
345
|
continue;
|
|
345
346
|
}
|
|
@@ -357,21 +358,14 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
|
|
|
357
358
|
rel: `${pair.targetRel}/${rel}`,
|
|
358
359
|
ours: hashFile(join(targetAbs, rel)),
|
|
359
360
|
theirs: hashFile(join(pair.sourceAbs, rel)),
|
|
360
|
-
base: baseHashOf({ baseRoot, sourceRel: `${pair.sourceRel}/${rel}
|
|
361
|
+
base: baseHashOf({ baseRoot, sourceRel: `${pair.sourceRel}/${rel}` }),
|
|
361
362
|
recorded: recordedHashes.get(`${pair.targetRel}/${rel}`) ?? null,
|
|
362
363
|
}))
|
|
363
364
|
: [compareOne({
|
|
364
365
|
rel: pair.targetRel,
|
|
365
366
|
ours: hashFile(targetAbs),
|
|
366
|
-
theirs:
|
|
367
|
-
|
|
368
|
-
: hashFile(pair.sourceAbs),
|
|
369
|
-
base: baseHashOf({
|
|
370
|
-
baseRoot,
|
|
371
|
-
sourceRel: pair.sourceRel,
|
|
372
|
-
agent,
|
|
373
|
-
transform: binding.strategy === "transform-persona",
|
|
374
|
-
}),
|
|
367
|
+
theirs: hashFile(pair.sourceAbs),
|
|
368
|
+
base: baseHashOf({ baseRoot, sourceRel: pair.sourceRel }),
|
|
375
369
|
recorded: recordedHashes.get(pair.targetRel) ?? null,
|
|
376
370
|
})];
|
|
377
371
|
|
|
@@ -536,22 +530,11 @@ function compareOne({ rel, ours, theirs, base, recorded }) {
|
|
|
536
530
|
return { path: rel, state: "conflict" };
|
|
537
531
|
}
|
|
538
532
|
|
|
539
|
-
function baseHashOf({ baseRoot, sourceRel
|
|
533
|
+
function baseHashOf({ baseRoot, sourceRel }) {
|
|
540
534
|
if (!baseRoot) return null;
|
|
541
535
|
const path = join(baseRoot, sourceRel);
|
|
542
536
|
if (!existsSync(path)) return null;
|
|
543
|
-
return
|
|
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; }
|
|
537
|
+
return hashFile(path);
|
|
555
538
|
}
|
|
556
539
|
|
|
557
540
|
function agentOf(item, binding) {
|
package/bin/snapshot-version.js
CHANGED
|
@@ -30,10 +30,6 @@ const ARTIFACT_PATHS = [
|
|
|
30
30
|
"codex",
|
|
31
31
|
"hermes",
|
|
32
32
|
"systemd",
|
|
33
|
-
".claude/commands",
|
|
34
|
-
".claude/orchestrate-teams.yaml",
|
|
35
|
-
".opencode/commands",
|
|
36
|
-
".opencode/orchestrate-teams.yaml",
|
|
37
33
|
".pi/prompts",
|
|
38
34
|
".pi/extensions",
|
|
39
35
|
".pi/harnesses",
|
|
@@ -45,7 +41,7 @@ const ARTIFACT_PATHS = [
|
|
|
45
41
|
// dev-only.
|
|
46
42
|
"scripts",
|
|
47
43
|
// justfile carries the pi harness launch recipes. It is a companion of the
|
|
48
|
-
// harness group in
|
|
44
|
+
// harness group in the deterministic installer, so the snapshot must hold a
|
|
49
45
|
// per-version copy for the upgrade three-way diff (retired-harness recipes
|
|
50
46
|
// pruned, new-harness recipes added on refresh).
|
|
51
47
|
"justfile",
|
|
@@ -60,7 +56,6 @@ const ARTIFACT_PATHS = [
|
|
|
60
56
|
"docs/npm-install.md",
|
|
61
57
|
"docs/skill-anatomy.md",
|
|
62
58
|
"docs/getting-started.md",
|
|
63
|
-
"docs/opencode-setup.md",
|
|
64
59
|
"docs/pi-setup.md",
|
|
65
60
|
"references",
|
|
66
61
|
"hooks",
|
|
@@ -69,6 +64,8 @@ const ARTIFACT_PATHS = [
|
|
|
69
64
|
// retired now is only resolvable from the base catalogue.
|
|
70
65
|
"install-manifest.json",
|
|
71
66
|
"manifest-meta.json",
|
|
67
|
+
// Installer-owned harness closure data, independent of the setup skill.
|
|
68
|
+
"bin/catalog/harness-runtime-closure.json",
|
|
72
69
|
];
|
|
73
70
|
|
|
74
71
|
if (existsSync(snapDir)) {
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -17,7 +17,43 @@ the runtime responsibilities and where each module lives in the repository.
|
|
|
17
17
|
| **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
|
|
18
18
|
| **Codex remote-control conductor** | Experimental outbound-only, user-systemd-managed Android conductor; verified on Codex CLI 0.144.x | `scripts/codex-remote-control.ts`, `scripts/codex-conductor.ts`, `codex/CONDUCTOR.md`, `systemd/user/`; runtime under `~/.local/state/agent-fleet/codex-conductor/` — see [codex-remote-conductor.md](codex-remote-conductor.md) |
|
|
19
19
|
| **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
|
|
20
|
-
| **Personas** | Reusable specialist definitions,
|
|
20
|
+
| **Personas** | Reusable specialist definitions, installed verbatim | `agents/`, `bin/lib/personas.js` |
|
|
21
|
+
|
|
22
|
+
## One Hub runtime, independent axes
|
|
23
|
+
|
|
24
|
+
Every public Pi launch through `just fleet` loads Fleet Core and the `agent-hub`
|
|
25
|
+
harness. Four independent choices shape that runtime:
|
|
26
|
+
|
|
27
|
+
| Axis | Choices | What it controls |
|
|
28
|
+
| --- | --- | --- |
|
|
29
|
+
| **Posture** | `operator`, `orchestrator` | Whether the main agent may use direct coding tools. Operator retains the captured `read`/`bash`/`edit`/`write` and approved extension surface; orchestrator removes direct coding tools and keeps dispatch, research, assertions, `ask_user`, and available coms/Herdr tools. |
|
|
30
|
+
| **Hub mode** | `fast`, `standard`, `strict` | Dispatch/research budgets and Verification Contract rigor. `/af-hub-mode` never grants or revokes coding tools. |
|
|
31
|
+
| **Native roster** | empty or one entry from `.pi/agents/teams.yaml` | Which in-process Pi specialist personas `dispatch_agent` may start. Roster changes do not change posture in a live session. |
|
|
32
|
+
| **Peer topology** | current terminal, Hub-only Herdr workspace, or Hub plus a `.pi/agents/peers.yaml` preset | Which separate, addressable Pi/Claude processes occupy sibling panes. Starting or spawning peers does not change posture or the native roster. |
|
|
33
|
+
|
|
34
|
+
Bare `just fleet` therefore means operator posture, an empty native roster, and
|
|
35
|
+
the current terminal. At startup an explicit `--posture` wins; otherwise
|
|
36
|
+
`--agents <roster>` implies orchestrator; otherwise operator is used. An
|
|
37
|
+
orchestrator startup requires a roster. `/af-posture` switches only posture in
|
|
38
|
+
the live session, while `/af-agents-*` changes only the native roster.
|
|
39
|
+
|
|
40
|
+
All Hub-owned slash commands remain registered in both postures. Runtime gates
|
|
41
|
+
control whether an action can proceed: without coms, Herdr, a visible target,
|
|
42
|
+
or an active roster, the corresponding command refuses with an actionable
|
|
43
|
+
message rather than disappearing. `--browser` and `--all-extensions` expand the
|
|
44
|
+
captured operator surface only when those optional extensions are installed.
|
|
45
|
+
|
|
46
|
+
The project selected by `--project <name>` is the coms namespace for the Hub
|
|
47
|
+
and every standing or dynamically spawned peer. The Hub-facing peer spawn API
|
|
48
|
+
cannot override it. Native subagents remain children of that Hub and inherit
|
|
49
|
+
its repository context; peers are separate processes in their own panes.
|
|
50
|
+
|
|
51
|
+
At dispatch time, `backend: "auto"` applies
|
|
52
|
+
`.pi/agents/dispatch-policy.yaml`; `backend: "native"` bypasses same-name peer
|
|
53
|
+
substitution; and `backend: "coms"` requires a visible same-name peer and never
|
|
54
|
+
falls back to a native child. `.pi/agents/peers.yaml` owns how a peer runs
|
|
55
|
+
(`runner`, persona, model, extensions, and declared `env_file`), not whether a
|
|
56
|
+
dispatch uses it.
|
|
21
57
|
|
|
22
58
|
## Fleet hierarchy
|
|
23
59
|
|
|
@@ -27,12 +63,12 @@ Agent Fleet is layered on purpose. Work flows **down** (delegate); evidence and
|
|
|
27
63
|
flowchart TD
|
|
28
64
|
You(["You · Hermes inbound relay · Codex outbound conductor on your phone"])
|
|
29
65
|
|
|
30
|
-
subgraph HUBL["HUB —
|
|
31
|
-
Hub["agent-hub harness
|
|
66
|
+
subgraph HUBL["HUB — guarded runtime (bare just fleet)"]
|
|
67
|
+
Hub["agent-hub harness<br/>operator or orchestrator posture · routes tasks<br/>owns the Verification Contract on disk · keeps research dumps out of its own context"]
|
|
32
68
|
end
|
|
33
69
|
|
|
34
|
-
subgraph TEAML["
|
|
35
|
-
Team["default:
|
|
70
|
+
subgraph TEAML["OPTIONAL NATIVE ROSTER (.pi/agents/teams.yaml)"]
|
|
71
|
+
Team["default: builder · test-engineer · code-reviewer · documenter<br/>also: plan · debug · frontend · security · hotfix · release · info"]
|
|
36
72
|
end
|
|
37
73
|
|
|
38
74
|
subgraph RESL["RESEARCH HELPERS — read-only, always available"]
|
|
@@ -58,10 +94,8 @@ Every specialist session is one persona from [`agents/`](../agents/) — *skills
|
|
|
58
94
|
The same idea as a tree:
|
|
59
95
|
|
|
60
96
|
```text
|
|
61
|
-
hub (orchestrator)
|
|
62
|
-
├──
|
|
63
|
-
│ ├── planner → scout · rules · risk
|
|
64
|
-
│ ├── plan-reviewer → feasibility · deps
|
|
97
|
+
hub (operator by default; orchestrator when selected)
|
|
98
|
+
├── optional native roster (empty by default; example: default)
|
|
65
99
|
│ ├── builder → recon · verifier
|
|
66
100
|
│ ├── test-engineer → coverage-scout · conventions
|
|
67
101
|
│ ├── code-reviewer → preflight · quality · perf · docs
|
|
@@ -169,8 +203,7 @@ flowchart TD
|
|
|
169
203
|
AF["<b>Agent Fleet</b><br/>agent-hub · personas · skills · coms · bridges · CLI"]
|
|
170
204
|
AF -->|primary runtime| PI["<b>pi</b><br/>coding agent — loads harnesses,<br/>extensions, prompts, personas"]
|
|
171
205
|
AF -->|control plane| HERDR["<b>herdr</b><br/>tiled peer workspaces,<br/>presence, snapshot/resume"]
|
|
172
|
-
AF -->|peer
|
|
173
|
-
AF -->|install target| OC["<b>OpenCode</b><br/>skill-driven execution<br/>(AGENTS.md + skill tool)"]
|
|
206
|
+
AF -->|coms peer only| CC["<b>Claude Code</b><br/>bidirectional peer via<br/>the coms bridge<br/><i>not an install target</i>"]
|
|
174
207
|
AF -->|remote human| HERMES["<b>Hermes</b><br/>hub questions relayed to your phone,<br/>plus the Desktop fleet panel"]
|
|
175
208
|
AF -->|outbound remote delegation| CODEX["<b>Codex Remote Control</b><br/>Android-approved calls to<br/>listed coms peers (experimental)"]
|
|
176
209
|
```
|
|
@@ -181,10 +214,9 @@ These are the external systems Agent Fleet assumes or integrates with — not np
|
|
|
181
214
|
|
|
182
215
|
| Dependency | Role | Required? |
|
|
183
216
|
| --- | --- | --- |
|
|
184
|
-
| **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for
|
|
185
|
-
| **[herdr](https://herdr.dev)** | Workspace control plane:
|
|
186
|
-
| **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class peer via the [coms bridge](claude-code-coms-bridge.md)
|
|
187
|
-
| **[OpenCode](https://opencode.ai)** | Skill-driven execution target (`AGENTS.md` + `skill` tool); `af-*` slash commands | Optional alternate harness |
|
|
217
|
+
| **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for `just fleet` |
|
|
218
|
+
| **[herdr](https://herdr.dev)** | Workspace control plane: Hub/peer panes, presence push events, team snapshot/resume | Required for `--herdr` or `--peers`; optional for bare `just fleet` |
|
|
219
|
+
| **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class coms peer via the [coms bridge](claude-code-coms-bridge.md) — cross-model review and analysis. Never an install target: it hosts no skills, commands, or personas | Optional peer |
|
|
188
220
|
| **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions — [coms-hermes-bridge](coms-hermes-bridge.md)) and the Desktop fleet panel ([hermes-desktop-plugins](hermes-desktop-plugins.md), needs v0.19.0+ and the Desktop app) | Optional |
|
|
189
221
|
| **Codex CLI + ChatGPT Android** | Experimental outbound remote-control conductor on supported `0.144.x`; requires Node `22.6+`, user systemd, interactive pairing, and per-command mobile approvals — [runbook](codex-remote-conductor.md) | Optional / revalidate after minor-version or mobile-client changes |
|
|
190
222
|
| **[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)** | Upstream skill library (manually vendored) | Bundled (vendored) |
|
|
@@ -204,9 +236,9 @@ hermes/ # Hermes-facing skills/integration assets
|
|
|
204
236
|
codex/ # Canonical Codex conductor contract (runtime copy lives outside checkout)
|
|
205
237
|
systemd/user/ # Owned user-unit template for Codex remote control
|
|
206
238
|
vendor/agent-skills-upstream/ # Manually imported upstream skills (pinned SHA)
|
|
207
|
-
bin/ # npm CLI: init/update/doctor
|
|
208
|
-
hooks/ #
|
|
209
|
-
references/ # Supplementary checklists
|
|
239
|
+
bin/ # npm CLI: init/update/doctor + the installer engine
|
|
240
|
+
hooks/ # The coms bridge Stop hook
|
|
241
|
+
references/ # Supplementary checklists, installed with the skills that cite them
|
|
210
242
|
docs/ # This file, setup guides, bridge references, vendoring policy
|
|
211
243
|
```
|
|
212
244
|
|
|
@@ -259,9 +291,11 @@ packages/hermes-bridge/ # future Hermes integration package
|
|
|
259
291
|
— collided two ways at once and made a post-mortem record eleven specialist
|
|
260
292
|
returns and two reviews as NOT RECOVERABLE. A failed archive leaves the
|
|
261
293
|
artifacts in place: a stale tree is recoverable, a deleted one is not.
|
|
262
|
-
- **Herdr owns panes, presence, and lifecycle; coms owns messages.**
|
|
263
|
-
recipes
|
|
264
|
-
message otherwise
|
|
294
|
+
- **Herdr owns panes, presence, and lifecycle; coms owns messages.** Herdr
|
|
295
|
+
topology recipes (`--herdr` or `--peers`) require a running server and refuse
|
|
296
|
+
with an actionable message otherwise. Bare Fleet does not require Herdr.
|
|
297
|
+
`--no-coms` leaves direct/native execution available but disables peer
|
|
298
|
+
messaging, peer-backed dispatch, and handoff from the Hub.
|
|
265
299
|
- **External agents are peers, not plugins.** Claude Code (and future CLI
|
|
266
300
|
agents) join the fleet through bridge adaptors that speak coms envelopes —
|
|
267
301
|
the fleet core stays agent-agnostic. Hermes remains the inbound `ask_user`/
|