@chankov/agent-fleet 0.0.5 → 0.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +10 -10
- package/.pi/extensions/btw/index.ts +11 -11
- package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/pi-voice-stt/README.md +7 -7
- package/.pi/extensions/pi-voice-stt/index.ts +4 -4
- package/.pi/harnesses/agent-hub/README.md +133 -74
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +61 -12
- package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +970 -406
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +30 -4
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +6 -5
- package/.pi/harnesses/coms/index.ts +92 -70
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +9 -9
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
- package/.versions/0.0.6/.claude/commands/build.md +44 -0
- package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.6/.claude/commands/plan.md +16 -0
- package/.versions/0.0.6/.claude/commands/prime.md +22 -0
- package/.versions/0.0.6/.claude/commands/review.md +16 -0
- package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.6/.claude/commands/ship.md +72 -0
- package/.versions/0.0.6/.claude/commands/spec.md +15 -0
- package/.versions/0.0.6/.claude/commands/test.md +19 -0
- package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.6/.pi/extensions/package.json +9 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.6/.version +1 -0
- package/.versions/0.0.6/agents/architect.md +23 -0
- package/.versions/0.0.6/agents/bowser.md +26 -0
- package/.versions/0.0.6/agents/builder.md +53 -0
- package/.versions/0.0.6/agents/code-reviewer.md +205 -0
- package/.versions/0.0.6/agents/deep-researcher.md +31 -0
- package/.versions/0.0.6/agents/documenter.md +18 -0
- package/.versions/0.0.6/agents/orchestrator.md +54 -0
- package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.6/agents/planner.md +69 -0
- package/.versions/0.0.6/agents/releaser.md +24 -0
- package/.versions/0.0.6/agents/researcher.md +28 -0
- package/.versions/0.0.6/agents/security-auditor.md +166 -0
- package/.versions/0.0.6/agents/test-engineer.md +151 -0
- package/.versions/0.0.6/agents/web-debugger.md +42 -0
- package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.6/docs/getting-started.md +183 -0
- package/.versions/0.0.6/docs/npm-install.md +337 -0
- package/.versions/0.0.6/docs/opencode-setup.md +249 -0
- package/.versions/0.0.6/docs/pi-extensions.md +293 -0
- package/.versions/0.0.6/docs/pi-setup.md +476 -0
- package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.6/hermes/README.md +231 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +140 -0
- package/README.md +198 -40
- package/agents/code-reviewer.md +2 -2
- package/agents/documenter.md +1 -1
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/releaser.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +60 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +67 -15
- package/docs/agent-fleet-setup.md +13 -13
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +18 -8
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/docs/npm-install.md +21 -21
- package/docs/pi-extensions.md +7 -7
- package/docs/pi-setup.md +51 -47
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/references/fleet-coordination-patterns.md +2 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/skills/compound-learning/SKILL.md +3 -3
- package/skills/guided-workspace-setup/SKILL.md +16 -14
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- /package/.pi/prompts/{build.md → af-build.md} +0 -0
- /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
- /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
- /package/.pi/prompts/{review.md → af-review.md} +0 -0
- /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
- /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
- /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
- /package/.pi/prompts/{test.md → af-test.md} +0 -0
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
"""Closed typed invoke admission; watcher never calls tools or shell."""
|
|
2
|
+
import hashlib
|
|
3
|
+
import json
|
|
4
|
+
|
|
5
|
+
from watchdog_contract import gate_o_valid
|
|
6
|
+
|
|
7
|
+
# Exact plan table: a deviation can only request its declared maximum action.
|
|
8
|
+
MAXIMUM_ACTION = {
|
|
9
|
+
'stalled_progress': 'request_status', 'silent_progress': 'request_status',
|
|
10
|
+
'blocked_waiting_human': 'none', 'verification_gap': 'request_verification',
|
|
11
|
+
'scope_drift': 'narrow_scope', 'repeated_failure': 'request_specialist',
|
|
12
|
+
'research_gap': 'request_research', 'queue_starvation': 'request_status',
|
|
13
|
+
'capacity_mismatch': 'none', 'recovery_loop': 'none', 'owner_offline': 'none',
|
|
14
|
+
'stale_generation': 'none', 'route_unavailable': 'none', 'unsafe_action_request': 'none',
|
|
15
|
+
}
|
|
16
|
+
ACTIONS = set(MAXIMUM_ACTION.values()) - {'none'}
|
|
17
|
+
IDENTITY_KEYS = ('profileKey', 'ownerSessionId', 'hubInstanceId')
|
|
18
|
+
TERMINAL_STATES = {'completed', 'failed', 'cancelled', 'orphaned'}
|
|
19
|
+
# Authority a typed request must never carry, whatever the caller supplies.
|
|
20
|
+
FORBIDDEN_REQUEST_KEYS = ('token', 'origin', 'route', 'routeId', 'prompt', 'command', 'shell', 'herdr', 'tool')
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def request_digest(request):
|
|
24
|
+
"""Canonical digest over the exact request that will be transported."""
|
|
25
|
+
canonical = json.dumps(request, sort_keys=True, separators=(',', ':')).encode()
|
|
26
|
+
return 'sha256:' + hashlib.sha256(canonical).hexdigest()
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def transport_identity(transport):
|
|
30
|
+
"""Identity as the live discovery/transport reports it, not as a caller claims."""
|
|
31
|
+
return {
|
|
32
|
+
'profileKey': getattr(transport, 'profile_key', None),
|
|
33
|
+
'ownerSessionId': getattr(transport, 'owner', None),
|
|
34
|
+
'hubInstanceId': getattr(transport, 'hub_instance_id', None),
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def _identity_matches(config, request, identity):
|
|
39
|
+
"""Config, request, and the live transport must agree on every identity key."""
|
|
40
|
+
for key in IDENTITY_KEYS:
|
|
41
|
+
expected = config.get(key)
|
|
42
|
+
if not isinstance(expected, str) or not expected:
|
|
43
|
+
return False
|
|
44
|
+
if request.get(key) != expected:
|
|
45
|
+
return False
|
|
46
|
+
if identity.get(key) != expected:
|
|
47
|
+
return False
|
|
48
|
+
return True
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
def allow(config, request, transport, online=True):
|
|
52
|
+
"""Pure admission check. Makes no transport call, so observe/shadow stay silent."""
|
|
53
|
+
if not online or not gate_o_valid(config.get('gateO')):
|
|
54
|
+
return False
|
|
55
|
+
autonomy = config.get('autonomy', 'observe')
|
|
56
|
+
maximum = config.get('maximumAutonomy', 'observe')
|
|
57
|
+
if autonomy not in ('steer', 'surgical') or maximum not in ('steer', 'surgical'):
|
|
58
|
+
return False
|
|
59
|
+
if request.get('action') not in ACTIONS or request.get('cancel'):
|
|
60
|
+
return False
|
|
61
|
+
basis = request.get('basis')
|
|
62
|
+
if not isinstance(basis, dict) or basis.get('deviation') not in MAXIMUM_ACTION:
|
|
63
|
+
return False
|
|
64
|
+
if request['action'] != MAXIMUM_ACTION[basis['deviation']]:
|
|
65
|
+
return False
|
|
66
|
+
if not isinstance(request.get('taskId'), str) or not request['taskId']:
|
|
67
|
+
return False
|
|
68
|
+
if not isinstance(request.get('generation'), int) or request['generation'] <= 0:
|
|
69
|
+
return False
|
|
70
|
+
parameters = request.get('parameters')
|
|
71
|
+
if not isinstance(parameters, dict) or set(parameters) - {'assertionIds', 'evidenceEventIds', 'instruction'}:
|
|
72
|
+
return False
|
|
73
|
+
for key, maximum in (('assertionIds', 20), ('evidenceEventIds', 20)):
|
|
74
|
+
values = parameters.get(key)
|
|
75
|
+
if not isinstance(values, list) or len(values) > maximum or not all(isinstance(value, str) and 0 < len(value) <= 128 for value in values):
|
|
76
|
+
return False
|
|
77
|
+
if not isinstance(parameters.get('instruction'), str) or not parameters['instruction'] or len(parameters['instruction']) > 1024:
|
|
78
|
+
return False
|
|
79
|
+
if any(key in request for key in FORBIDDEN_REQUEST_KEYS):
|
|
80
|
+
return False
|
|
81
|
+
return _identity_matches(config, request, transport_identity(transport))
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
def _target_current(transport, request):
|
|
85
|
+
"""Fresh read: the exact generation must still exist, be owned, and not be terminal."""
|
|
86
|
+
try:
|
|
87
|
+
rows = transport.snapshot(request['taskId'])
|
|
88
|
+
except Exception:
|
|
89
|
+
return False
|
|
90
|
+
if not isinstance(rows, list):
|
|
91
|
+
return False
|
|
92
|
+
if any(isinstance(row, dict) and row.get('generation', 0) > request['generation'] for row in rows):
|
|
93
|
+
return False
|
|
94
|
+
exact = next((row for row in rows if isinstance(row, dict) and row.get('generation') == request['generation']), None)
|
|
95
|
+
if not isinstance(exact, dict) or exact.get('state') in TERMINAL_STATES:
|
|
96
|
+
return False
|
|
97
|
+
# Snapshot rows name the Hub-authoritative owner session explicitly. Never
|
|
98
|
+
# accept a similarly named caller-provided `ownerId`.
|
|
99
|
+
return exact.get('ownerSessionId') == request['ownerSessionId']
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
def admit(config, request, transport, online=True, persist=None):
|
|
103
|
+
"""
|
|
104
|
+
Durability precedes transport: the canonical digest and the proposed decision
|
|
105
|
+
are persisted before the first transport call. Ambiguous failure is refusal,
|
|
106
|
+
never a retry.
|
|
107
|
+
"""
|
|
108
|
+
if not allow(config, request, transport, online):
|
|
109
|
+
return {'status': 'refused'}
|
|
110
|
+
if persist is None:
|
|
111
|
+
return {'status': 'refused'}
|
|
112
|
+
try:
|
|
113
|
+
persist({'decision': 'invoke_proposed', 'requestId': request.get('requestId'),
|
|
114
|
+
'parametersDigest': request_digest(request), 'hubInstanceId': request['hubInstanceId'],
|
|
115
|
+
'taskRef': {'taskId': request['taskId'], 'generation': request['generation']}})
|
|
116
|
+
except Exception:
|
|
117
|
+
return {'status': 'refused'}
|
|
118
|
+
if not _target_current(transport, request):
|
|
119
|
+
return {'status': 'refused'}
|
|
120
|
+
try:
|
|
121
|
+
result = transport.invoke(request)
|
|
122
|
+
except Exception:
|
|
123
|
+
return {'status': 'refused'}
|
|
124
|
+
return result if isinstance(result, dict) else {'status': 'refused'}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
"""Closed, stdlib-only contracts for the fail-closed watchdog."""
|
|
2
|
+
import hashlib
|
|
3
|
+
import json
|
|
4
|
+
import re
|
|
5
|
+
import stat
|
|
6
|
+
from datetime import datetime, timezone
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
|
|
9
|
+
MAX_FRAME = 65536
|
|
10
|
+
SECRET_MARKER = re.compile(r'(?:token|bearer|secret|password|authorization|api[_-]?key)\s*[=:]', re.I)
|
|
11
|
+
|
|
12
|
+
REQUIRED_GATE_O_OBSERVATIONS = frozenset({
|
|
13
|
+
'opaqueOrigin', 'threeIncrementalUpdates', 'wakeReconnect',
|
|
14
|
+
'profileIsolation', 'twoChatIsolation', 'structuredInvocation',
|
|
15
|
+
})
|
|
16
|
+
|
|
17
|
+
def safe_file(path: Path, root: Path):
|
|
18
|
+
root = root.resolve(strict=True)
|
|
19
|
+
if path.is_symlink():
|
|
20
|
+
raise ValueError('unsafe_file')
|
|
21
|
+
path = path.resolve(strict=True)
|
|
22
|
+
if root not in (path, *path.parents):
|
|
23
|
+
raise ValueError('path_escape')
|
|
24
|
+
value = path.stat()
|
|
25
|
+
if not stat.S_ISREG(value.st_mode) or value.st_mode & 0o077:
|
|
26
|
+
raise ValueError('unsafe_file')
|
|
27
|
+
return path
|
|
28
|
+
|
|
29
|
+
def _parse_time(value):
|
|
30
|
+
if not isinstance(value, str):
|
|
31
|
+
raise ValueError('expired')
|
|
32
|
+
try:
|
|
33
|
+
return datetime.fromisoformat(value.replace('Z', '+00:00')).astimezone(timezone.utc)
|
|
34
|
+
except ValueError as error:
|
|
35
|
+
raise ValueError('expired') from error
|
|
36
|
+
|
|
37
|
+
def validate_discovery(root, value, now):
|
|
38
|
+
if not isinstance(value, dict) or set(value) != {'owner', 'socket', 'token', 'lease'}:
|
|
39
|
+
raise ValueError('discovery')
|
|
40
|
+
if not isinstance(value['owner'], str) or not value['owner']:
|
|
41
|
+
raise ValueError('discovery')
|
|
42
|
+
if not isinstance(value['socket'], str) or not value['socket'].startswith('@runtime/s/') or not value['socket'].endswith('/s'):
|
|
43
|
+
raise ValueError('discovery')
|
|
44
|
+
if not isinstance(value['token'], str) or not value['token'].startswith('token-'):
|
|
45
|
+
raise ValueError('discovery')
|
|
46
|
+
lease = value['lease']
|
|
47
|
+
if not isinstance(lease, dict) or not isinstance(lease.get('hub'), str):
|
|
48
|
+
raise ValueError('discovery')
|
|
49
|
+
current = _parse_time(now) if isinstance(now, str) else now.astimezone(timezone.utc)
|
|
50
|
+
if _parse_time(lease.get('expiresAt')) <= current:
|
|
51
|
+
raise ValueError('expired')
|
|
52
|
+
return value
|
|
53
|
+
|
|
54
|
+
def route_hash(profile, origin):
|
|
55
|
+
if not isinstance(origin, dict) or not {'channel', 'chatId', 'sessionId'} <= set(origin):
|
|
56
|
+
raise ValueError('origin')
|
|
57
|
+
return 'sha256:' + hashlib.sha256((profile + '\0' + json.dumps(origin, sort_keys=True, separators=(',', ':'))).encode()).hexdigest()
|
|
58
|
+
|
|
59
|
+
def gate_o_valid(artifact):
|
|
60
|
+
"""Match the TypeScript Gate O validator; self-declared validity is not trust."""
|
|
61
|
+
if not isinstance(artifact, dict) or artifact.get('unsupported') is True or artifact.get('synthetic') is True:
|
|
62
|
+
return False
|
|
63
|
+
api = artifact.get('api')
|
|
64
|
+
observations = artifact.get('observations')
|
|
65
|
+
evidence_ids = artifact.get('evidenceIds')
|
|
66
|
+
def safe(value, maximum):
|
|
67
|
+
return (isinstance(value, str) and value == value.strip() and 0 < len(value) <= maximum
|
|
68
|
+
and SECRET_MARKER.search(value) is None)
|
|
69
|
+
api_safe = (isinstance(api, dict) and safe(api.get('kind'), 64) and safe(api.get('name'), 128)
|
|
70
|
+
and safe(api.get('argumentShape'), 256) and not re.search(r'\bsend\s+--to\b', api['name'], re.I))
|
|
71
|
+
evidence_safe = (isinstance(evidence_ids, list) and len(evidence_ids) >= 2
|
|
72
|
+
and all(safe(item, 256) for item in evidence_ids))
|
|
73
|
+
return bool(api_safe and isinstance(observations, dict)
|
|
74
|
+
and all(observations.get(key) is True for key in REQUIRED_GATE_O_OBSERVATIONS)
|
|
75
|
+
and evidence_safe and artifact.get('originDelivery') is True
|
|
76
|
+
and safe(artifact.get('liveRunId'), 256))
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
from watchdog_contract import gate_o_valid
|
|
2
|
+
|
|
3
|
+
def delivery_state(artifact):
|
|
4
|
+
valid=gate_o_valid(artifact)
|
|
5
|
+
return {'originDelivery':valid,'disposition':'origin-delivery-enabled' if valid else 'journal-only-no-steering'}
|
|
6
|
+
def deliver(artifact,route,message,adapter=None):
|
|
7
|
+
# There is intentionally no built-in Hermes API. A live-proven adapter is required.
|
|
8
|
+
if not gate_o_valid(artifact) or adapter is None: raise RuntimeError('origin delivery unavailable without live Gate O')
|
|
9
|
+
if not isinstance(route,dict) or not {'channel','chatId','sessionId'}<=set(route): raise RuntimeError('invalid_origin_route')
|
|
10
|
+
return adapter(route,message)
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
"""Pure deterministic material-event reducer; it never selects an action."""
|
|
2
|
+
from collections import deque
|
|
3
|
+
from datetime import datetime, timezone
|
|
4
|
+
import time
|
|
5
|
+
|
|
6
|
+
TRANSITIONS = {'task.state_changed', 'task.started', 'hub.turn_started', 'hub.turn_completed',
|
|
7
|
+
'owner.lease_changed', 'action.accepted', 'action.rejected'}
|
|
8
|
+
# The complete plan deviation table. These names are facts/candidates only, never actions.
|
|
9
|
+
DEVIATIONS = frozenset({'stalled_progress', 'silent_progress', 'blocked_waiting_human',
|
|
10
|
+
'verification_gap', 'scope_drift', 'repeated_failure', 'research_gap', 'queue_starvation',
|
|
11
|
+
'capacity_mismatch', 'recovery_loop', 'owner_offline', 'stale_generation',
|
|
12
|
+
'route_unavailable', 'unsafe_action_request'})
|
|
13
|
+
CRITICAL = frozenset({'owner_offline', 'route_unavailable', 'unsafe_action_request', 'recovery_loop'})
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def _state(value):
|
|
17
|
+
value = dict(value)
|
|
18
|
+
value.setdefault('seen_ids', deque(maxlen=4096)); value.setdefault('seen_set', set(value['seen_ids']))
|
|
19
|
+
value.setdefault('latest_generation', {}); value.setdefault('last_material', {}); value.setdefault('last_output', {})
|
|
20
|
+
value.setdefault('task_state', {}); value.setdefault('cooldowns', {}); value.setdefault('route_times', deque())
|
|
21
|
+
value.setdefault('offline', deque()); value.setdefault('offline_bytes', 0); value.setdefault('last_monotonic', float('-inf'))
|
|
22
|
+
return value
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
def _candidate(event, task, newest):
|
|
26
|
+
kind, target = event.get('kind'), task.get('toState')
|
|
27
|
+
if task.get('generation', 0) < newest or kind == 'task.generation_superseded': return 'stale_generation'
|
|
28
|
+
if kind == 'task.state_changed' and target == 'blocked': return 'blocked_waiting_human'
|
|
29
|
+
if kind == 'task.state_changed' and target == 'failed': return 'repeated_failure'
|
|
30
|
+
if kind == 'hub.capability_changed': return 'capacity_mismatch'
|
|
31
|
+
if kind == 'owner.orphaned': return 'owner_offline'
|
|
32
|
+
if kind == 'owner.recovering': return 'recovery_loop'
|
|
33
|
+
if kind == 'action.rejected': return 'unsafe_action_request'
|
|
34
|
+
if kind == 'hub.queue_depth_changed' and event.get('queueDepth', 0) > 0: return 'queue_starvation'
|
|
35
|
+
if kind == 'task.output_advanced' and event.get('completionIntent') and not event.get('assertionEvidence'): return 'verification_gap'
|
|
36
|
+
if kind == 'task.output_advanced' and event.get('scopeWatchdog'): return 'scope_drift'
|
|
37
|
+
if kind == 'task.output_advanced' and event.get('researchMissing'): return 'research_gap'
|
|
38
|
+
if kind == 'route.unavailable': return 'route_unavailable'
|
|
39
|
+
return None
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
def _allowed(state, record, now):
|
|
43
|
+
deviation = record.get('candidateDeviation')
|
|
44
|
+
if not deviation: return True
|
|
45
|
+
severity = 'critical' if deviation in CRITICAL else 'info' if deviation == 'blocked_waiting_human' else 'warning'
|
|
46
|
+
task = record['taskRef']; key = (task['taskId'], task['generation'], deviation)
|
|
47
|
+
# per-task policy: info 60s, warning 15s, critical duplicate 5m
|
|
48
|
+
floor = 300 if severity == 'critical' else 60 if severity == 'info' else 15
|
|
49
|
+
if now - state['cooldowns'].get(key, float('-inf')) < floor: return False
|
|
50
|
+
route = state['route_times']
|
|
51
|
+
while route and now - route[0] > 3600: route.popleft()
|
|
52
|
+
if len(route) >= 30 or sum(item > now - 60 for item in route) >= 6: return False
|
|
53
|
+
state['cooldowns'][key] = now; route.append(now); record['severity'] = severity
|
|
54
|
+
return True
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def _buffer_offline(state, record):
|
|
58
|
+
raw = str(record).encode('utf-8')
|
|
59
|
+
if len(raw) > 262144: return
|
|
60
|
+
state['offline'].append(record); state['offline_bytes'] += len(raw)
|
|
61
|
+
while len(state['offline']) > 100 or state['offline_bytes'] > 262144:
|
|
62
|
+
state['offline_bytes'] -= len(str(state['offline'].popleft()).encode('utf-8'))
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
def drain_offline(value):
|
|
66
|
+
state = _state(value); records = list(state['offline'])
|
|
67
|
+
state['offline'].clear(); state['offline_bytes'] = 0
|
|
68
|
+
return state, records
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def reduce_event(value, event, now, online=True):
|
|
72
|
+
state = _state(value)
|
|
73
|
+
# monotonic rollback must never reopen cooldowns/timers.
|
|
74
|
+
now = max(now, state['last_monotonic']); state['last_monotonic'] = now
|
|
75
|
+
sequence, event_id = event.get('eventSequence'), event.get('eventId')
|
|
76
|
+
if not isinstance(sequence, int) or sequence <= state.get('sequence', 0) or not isinstance(event_id, str) or event_id in state['seen_set']:
|
|
77
|
+
return state, []
|
|
78
|
+
state['sequence'] = sequence
|
|
79
|
+
if len(state['seen_ids']) == state['seen_ids'].maxlen: state['seen_set'].discard(state['seen_ids'][0])
|
|
80
|
+
state['seen_ids'].append(event_id); state['seen_set'].add(event_id)
|
|
81
|
+
task = event.get('task') or {}; task_id, generation = task.get('id'), task.get('generation')
|
|
82
|
+
if not isinstance(task_id, str) or not isinstance(generation, int): return state, []
|
|
83
|
+
key = (task_id, generation); newest = max(state['latest_generation'].get(task_id, 0), generation)
|
|
84
|
+
state['latest_generation'][task_id] = newest
|
|
85
|
+
occurred = event.get('occurredAt')
|
|
86
|
+
try:
|
|
87
|
+
occurred_at = datetime.fromisoformat(occurred.replace('Z', '+00:00')).astimezone(timezone.utc).timestamp()
|
|
88
|
+
except (AttributeError, ValueError):
|
|
89
|
+
# Missing/malformed Hub time is history only: never an actionable candidate.
|
|
90
|
+
occurred_at = float('-inf')
|
|
91
|
+
age = max(0, time.time() - occurred_at)
|
|
92
|
+
material = event.get('kind') in TRANSITIONS or event.get('kind') in {'hub.capability_changed', 'owner.orphaned', 'owner.recovering', 'task.generation_superseded', 'route.unavailable', 'hub.queue_depth_changed'}
|
|
93
|
+
if event.get('kind') == 'task.output_advanced':
|
|
94
|
+
material = now - state['last_output'].get(key, float('-inf')) >= 2
|
|
95
|
+
state['last_output'][key] = now
|
|
96
|
+
if not material: return state, []
|
|
97
|
+
target_state = task.get('toState', state['task_state'].get(key))
|
|
98
|
+
state['task_state'][key] = target_state
|
|
99
|
+
if event.get('kind') == 'task.state_changed' and target_state in {'completed', 'blocked', 'failed', 'cancelled', 'orphaned'}:
|
|
100
|
+
# Terminal generations cannot stall; retaining them grows this state forever.
|
|
101
|
+
state['last_material'].pop(key, None)
|
|
102
|
+
state['last_output'].pop(key, None)
|
|
103
|
+
else:
|
|
104
|
+
state['last_material'][key] = now
|
|
105
|
+
candidate = _candidate(event, task, newest)
|
|
106
|
+
stale = age > 120 or generation < newest
|
|
107
|
+
if stale: candidate = None
|
|
108
|
+
record = {'eventId': event_id, 'taskRef': {'taskId': task_id, 'generation': generation}, 'candidateDeviation': candidate, 'stale': stale}
|
|
109
|
+
if not _allowed(state, record, now): return state, []
|
|
110
|
+
if not online: _buffer_offline(state, record); return state, []
|
|
111
|
+
return state, [record]
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
def due_deviations(value, now, stall_seconds=600, online=True):
|
|
115
|
+
state = _state(value); now = max(now, state['last_monotonic']); state['last_monotonic'] = now; output = []
|
|
116
|
+
for key, last in state['last_material'].items():
|
|
117
|
+
candidate = 'silent_progress' if key in state['last_output'] and now - state['last_output'][key] >= 300 and state['last_output'][key] >= last else 'stalled_progress'
|
|
118
|
+
if now - last >= stall_seconds:
|
|
119
|
+
record = {'taskRef': {'taskId': key[0], 'generation': key[1]}, 'candidateDeviation': candidate}
|
|
120
|
+
if _allowed(state, record, now):
|
|
121
|
+
if online: output.append(record)
|
|
122
|
+
else: _buffer_offline(state, record)
|
|
123
|
+
return output
|
|
124
|
+
|
|
125
|
+
|
|
126
|
+
def bulgarian_summary(record):
|
|
127
|
+
ref = record.get('taskRef', {})
|
|
128
|
+
return f"ℹ️ задача `{ref.get('taskId', '?')}`, поколение {ref.get('generation', '?')}: {record.get('candidateDeviation') or 'съществена промяна'}."
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
"""Bounded semantic classification contract; invalid answers are no-ops."""
|
|
2
|
+
import json
|
|
3
|
+
|
|
4
|
+
from watchdog_actions import MAXIMUM_ACTION
|
|
5
|
+
ACTIONS = {'none', 'request_status', 'request_verification', 'narrow_scope', 'request_research', 'request_specialist'}
|
|
6
|
+
FORBIDDEN = ('token', 'route', 'prompt', 'transcript', 'toolarg', 'chatid', 'sessionid')
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def request(candidate, events, output='', task_ref=None):
|
|
10
|
+
if not isinstance(candidate, str) or not isinstance(events, list) or len(events) > 20:
|
|
11
|
+
raise ValueError('evidence_bounds')
|
|
12
|
+
if not isinstance(output, str) or len(output.encode()) > 4096:
|
|
13
|
+
raise ValueError('evidence_bounds')
|
|
14
|
+
if not isinstance(task_ref or {}, dict) or not isinstance((task_ref or {}).get('generation'), (int, type(None))):
|
|
15
|
+
raise ValueError('evidence_bounds')
|
|
16
|
+
if any(not isinstance(item, str) or any(word in item.lower() for word in FORBIDDEN) for item in events):
|
|
17
|
+
raise ValueError('unsafe_evidence')
|
|
18
|
+
evidence = json.dumps(events, separators=(',', ':')).encode()
|
|
19
|
+
if len(evidence) > 8192 or any(word in output.lower() for word in FORBIDDEN):
|
|
20
|
+
raise ValueError('evidence_bounds')
|
|
21
|
+
return {'schema': 'agent-fleet.watchdog-judgment-request', 'schemaVersion': 1,
|
|
22
|
+
'candidateDeviation': candidate, 'taskRef': task_ref or {},
|
|
23
|
+
'evidence': {'events': events, 'publicOutputSuffix': output, 'truncated': False},
|
|
24
|
+
'allowedRecommendations': sorted({'none', MAXIMUM_ACTION.get(candidate, 'none')})}
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def response(value, deviation, event_ids):
|
|
28
|
+
try:
|
|
29
|
+
parsed = json.loads(value) if isinstance(value, str) else value
|
|
30
|
+
confidence = parsed.get('confidence') if isinstance(parsed, dict) else None
|
|
31
|
+
supplied = parsed.get('evidenceEventIds') if isinstance(parsed, dict) else None
|
|
32
|
+
if (not isinstance(parsed, dict) or parsed.get('deviation') != deviation or
|
|
33
|
+
parsed.get('verdict') != 'confirmed' or parsed.get('recommendedAction') not in ACTIONS or
|
|
34
|
+
parsed.get('recommendedAction') not in {'none', MAXIMUM_ACTION.get(deviation, 'none')} or
|
|
35
|
+
isinstance(confidence, bool) or not isinstance(confidence, (float, int)) or confidence < .8 or
|
|
36
|
+
not isinstance(supplied, list) or not supplied or not all(isinstance(item, str) for item in supplied) or
|
|
37
|
+
not set(supplied).issubset(set(event_ids))):
|
|
38
|
+
raise ValueError('invalid_judgment')
|
|
39
|
+
return parsed
|
|
40
|
+
except Exception:
|
|
41
|
+
return {'verdict': 'none', 'recommendedAction': 'none'}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
"""Exact-generation surgical transaction. No retargeting, retries, or shell execution."""
|
|
2
|
+
import time
|
|
3
|
+
|
|
4
|
+
from watchdog_actions import transport_identity
|
|
5
|
+
|
|
6
|
+
TERMINAL = {'completed', 'failed', 'cancelled', 'orphaned'}
|
|
7
|
+
IDENTITY_KEYS = ('profileKey', 'hubInstanceId', 'ownerSessionId')
|
|
8
|
+
CANCEL_TIMEOUT_SECONDS = 15
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def _identity_bound(tx, api):
|
|
12
|
+
"""Exact identity is mandatory; a missing field is a refusal, not a wildcard."""
|
|
13
|
+
identity = transport_identity(api)
|
|
14
|
+
for key in IDENTITY_KEYS:
|
|
15
|
+
value = tx.get(key)
|
|
16
|
+
if not isinstance(value, str) or not value:
|
|
17
|
+
return False
|
|
18
|
+
if identity.get(key) != value:
|
|
19
|
+
return False
|
|
20
|
+
return True
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def _compare_and_swap(tx, api):
|
|
24
|
+
"""
|
|
25
|
+
Fresh snapshot read before every step. Returns ('ok', exact_row),
|
|
26
|
+
('superseded', None) when an N+1 generation exists, or ('refused', None).
|
|
27
|
+
"""
|
|
28
|
+
rows = api.snapshot(tx['taskId'])
|
|
29
|
+
if not isinstance(rows, list):
|
|
30
|
+
return 'refused', None
|
|
31
|
+
if any(isinstance(row, dict) and row.get('generation', 0) > tx['generation'] for row in rows):
|
|
32
|
+
return 'superseded', None
|
|
33
|
+
exact = next((row for row in rows if isinstance(row, dict) and row.get('generation') == tx['generation']), None)
|
|
34
|
+
if not isinstance(exact, dict):
|
|
35
|
+
return 'refused', None
|
|
36
|
+
if exact.get('ownerSessionId') != tx['ownerSessionId']:
|
|
37
|
+
return 'refused', None
|
|
38
|
+
return 'ok', exact
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
def _start_cancel(tx, api, now, persist):
|
|
42
|
+
"""Persist the proposal, re-check the generation, then cancel exactly N."""
|
|
43
|
+
if persist is None:
|
|
44
|
+
return {**tx, 'state': 'refused'}
|
|
45
|
+
try:
|
|
46
|
+
persist({'decision': 'recovery_proposed', 'hubInstanceId': tx['hubInstanceId'],
|
|
47
|
+
'taskRef': {'taskId': tx['taskId'], 'generation': tx['generation']}})
|
|
48
|
+
except Exception:
|
|
49
|
+
return {**tx, 'state': 'refused'}
|
|
50
|
+
verdict, _ = _compare_and_swap(tx, api)
|
|
51
|
+
if verdict != 'ok':
|
|
52
|
+
return {**tx, 'state': verdict}
|
|
53
|
+
result = api.cancel(tx['taskId'], tx['generation'])
|
|
54
|
+
if not isinstance(result, dict) or not result.get('cancelled'):
|
|
55
|
+
return {**tx, 'state': 'refused'}
|
|
56
|
+
return {**tx, 'state': 'cancelling', 'cancelStartedAt': now}
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def _observe_cancel(tx, api, now):
|
|
60
|
+
"""Wait for the exact generation to reach a terminal state, bounded by a timeout."""
|
|
61
|
+
verdict, exact = _compare_and_swap(tx, api)
|
|
62
|
+
if verdict != 'ok':
|
|
63
|
+
return {**tx, 'state': verdict}
|
|
64
|
+
if exact.get('state') in TERMINAL:
|
|
65
|
+
return {**tx, 'state': 'cancel_observed'}
|
|
66
|
+
if now - tx.get('cancelStartedAt', now) >= CANCEL_TIMEOUT_SECONDS:
|
|
67
|
+
return {**tx, 'state': 'timed_out'}
|
|
68
|
+
return tx
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def _enqueue_recovery(tx, api):
|
|
72
|
+
"""One recovery enqueue, gated on a fresh no-N+1 terminal observation."""
|
|
73
|
+
verdict, exact = _compare_and_swap(tx, api)
|
|
74
|
+
if verdict != 'ok':
|
|
75
|
+
return {**tx, 'state': verdict}
|
|
76
|
+
if exact.get('state') not in TERMINAL:
|
|
77
|
+
return {**tx, 'state': 'refused'}
|
|
78
|
+
outcome = api.invoke_recovery(tx['taskId'], tx['generation'])
|
|
79
|
+
if isinstance(outcome, dict) and outcome.get('status') in ('accepted', 'duplicate'):
|
|
80
|
+
return {**tx, 'state': 'recovery_queued'}
|
|
81
|
+
return {**tx, 'state': 'refused'}
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
def recover(tx, api, allowlist, gate_o, now=None, persist=None):
|
|
85
|
+
"""
|
|
86
|
+
Advance the local recovery state machine by exactly one step. Terminal
|
|
87
|
+
states are absorbing, so a restart can never repeat a completed step.
|
|
88
|
+
"""
|
|
89
|
+
now = time.monotonic() if now is None else now
|
|
90
|
+
if not gate_o or tx.get('taskId') not in allowlist or tx.get('kind') != 'native':
|
|
91
|
+
return {**tx, 'state': 'refused'}
|
|
92
|
+
if not isinstance(tx.get('generation'), int) or tx['generation'] <= 0:
|
|
93
|
+
return {**tx, 'state': 'refused'}
|
|
94
|
+
if not _identity_bound(tx, api):
|
|
95
|
+
return {**tx, 'state': 'refused'}
|
|
96
|
+
state = tx.get('state', 'proposed')
|
|
97
|
+
if state == 'proposed':
|
|
98
|
+
return _start_cancel(tx, api, now, persist)
|
|
99
|
+
if state == 'cancelling':
|
|
100
|
+
return _observe_cancel(tx, api, now)
|
|
101
|
+
if state == 'cancel_observed':
|
|
102
|
+
return _enqueue_recovery(tx, api)
|
|
103
|
+
return tx
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
"""Private, owner-only watcher state and append-only decision audit."""
|
|
2
|
+
import hashlib
|
|
3
|
+
import json
|
|
4
|
+
import os
|
|
5
|
+
import stat
|
|
6
|
+
import tempfile
|
|
7
|
+
from datetime import datetime, timedelta, timezone
|
|
8
|
+
from pathlib import Path
|
|
9
|
+
|
|
10
|
+
AUDIT_LIMIT = 1000
|
|
11
|
+
AUDIT_DAYS = 7
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def _safe(path):
|
|
15
|
+
path = Path(path)
|
|
16
|
+
if path.exists():
|
|
17
|
+
mode = path.lstat().st_mode
|
|
18
|
+
if stat.S_ISLNK(mode) or not stat.S_ISREG(mode) or mode & 0o077:
|
|
19
|
+
raise ValueError('unsafe_state')
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def _safe_parent(path):
|
|
23
|
+
parent = Path(path).parent
|
|
24
|
+
parent.mkdir(mode=0o700, parents=True, exist_ok=True)
|
|
25
|
+
mode = parent.lstat().st_mode
|
|
26
|
+
if stat.S_ISLNK(mode) or not stat.S_ISDIR(mode) or mode & 0o077:
|
|
27
|
+
raise ValueError('unsafe_state')
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def atomic_json(path, value):
|
|
31
|
+
path = Path(path)
|
|
32
|
+
_safe_parent(path)
|
|
33
|
+
_safe(path)
|
|
34
|
+
fd, temporary = tempfile.mkstemp(dir=path.parent)
|
|
35
|
+
try:
|
|
36
|
+
os.fchmod(fd, 0o600)
|
|
37
|
+
with os.fdopen(fd, 'w', encoding='utf-8') as stream:
|
|
38
|
+
json.dump(value, stream, sort_keys=True, separators=(',', ':'))
|
|
39
|
+
stream.flush()
|
|
40
|
+
os.fsync(stream.fileno())
|
|
41
|
+
os.replace(temporary, path)
|
|
42
|
+
os.chmod(path, 0o600)
|
|
43
|
+
directory = os.open(path.parent, os.O_RDONLY)
|
|
44
|
+
try:
|
|
45
|
+
os.fsync(directory)
|
|
46
|
+
finally:
|
|
47
|
+
os.close(directory)
|
|
48
|
+
finally:
|
|
49
|
+
if os.path.exists(temporary):
|
|
50
|
+
os.unlink(temporary)
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def load_json(path):
|
|
54
|
+
_safe(path)
|
|
55
|
+
return json.loads(Path(path).read_text(encoding='utf-8'))
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
def _audit_record(record, previous, sequence):
|
|
59
|
+
if not isinstance(record, dict):
|
|
60
|
+
raise ValueError('sensitive_audit')
|
|
61
|
+
# Store only correlation and decision fields: no raw route/output/prompt/token fields.
|
|
62
|
+
allowed = {'watchId', 'hubInstanceId', 'taskRef', 'eventIds', 'deviation', 'tier',
|
|
63
|
+
'decision', 'requestId', 'parametersDigest', 'recoveryState', 'occurredAt'}
|
|
64
|
+
if set(record) - allowed:
|
|
65
|
+
raise ValueError('sensitive_audit')
|
|
66
|
+
task = record.get('taskRef')
|
|
67
|
+
if task is not None and (not isinstance(task, dict) or set(task) - {'taskId', 'generation'}):
|
|
68
|
+
raise ValueError('sensitive_audit')
|
|
69
|
+
event_ids = record.get('eventIds')
|
|
70
|
+
if event_ids is not None and (not isinstance(event_ids, list) or not all(isinstance(item, str) for item in event_ids)):
|
|
71
|
+
raise ValueError('sensitive_audit')
|
|
72
|
+
clean = {key: value for key, value in record.items() if value is not None}
|
|
73
|
+
clean.update({'schema': 'agent-fleet.watchdog-audit', 'schemaVersion': 1,
|
|
74
|
+
'authority': 'watcher_decision_trace', 'auditSequence': sequence,
|
|
75
|
+
'occurredAt': clean.get('occurredAt') or datetime.now(timezone.utc).isoformat().replace('+00:00', 'Z'),
|
|
76
|
+
'previousHash': previous})
|
|
77
|
+
body = json.dumps(clean, sort_keys=True, separators=(',', ':'))
|
|
78
|
+
clean['recordHash'] = 'sha256:' + hashlib.sha256((previous + body).encode()).hexdigest()
|
|
79
|
+
return clean
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def _read_audit(path):
|
|
83
|
+
_safe(path)
|
|
84
|
+
if not Path(path).exists():
|
|
85
|
+
return []
|
|
86
|
+
rows = []
|
|
87
|
+
previous = ''
|
|
88
|
+
for index, line in enumerate(Path(path).read_text(encoding='utf-8').splitlines(), 1):
|
|
89
|
+
try:
|
|
90
|
+
row = json.loads(line)
|
|
91
|
+
if row.get('previousHash') != previous or not isinstance(row.get('recordHash'), str):
|
|
92
|
+
raise ValueError('audit_tampered')
|
|
93
|
+
copy = dict(row); actual = copy.pop('recordHash')
|
|
94
|
+
body = json.dumps(copy, sort_keys=True, separators=(',', ':'))
|
|
95
|
+
expected = 'sha256:' + hashlib.sha256((previous + body).encode()).hexdigest()
|
|
96
|
+
if actual != expected:
|
|
97
|
+
raise ValueError('audit_tampered')
|
|
98
|
+
previous = actual
|
|
99
|
+
rows.append(row)
|
|
100
|
+
except (ValueError, json.JSONDecodeError) as error:
|
|
101
|
+
# A final torn line is recoverable only if it is the final physical record.
|
|
102
|
+
if index and index == len(Path(path).read_text(encoding='utf-8').splitlines()) and not line.strip():
|
|
103
|
+
break
|
|
104
|
+
raise ValueError('audit_tampered') from error
|
|
105
|
+
return rows
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
def _retain(rows):
|
|
109
|
+
cutoff = datetime.now(timezone.utc) - timedelta(days=AUDIT_DAYS)
|
|
110
|
+
retained = []
|
|
111
|
+
for row in rows:
|
|
112
|
+
try:
|
|
113
|
+
timestamp = datetime.fromisoformat(row['occurredAt'].replace('Z', '+00:00'))
|
|
114
|
+
except (KeyError, ValueError):
|
|
115
|
+
raise ValueError('audit_tampered')
|
|
116
|
+
pending = row.get('recoveryState') in {'proposed', 'cancelling', 'cancel_observed'}
|
|
117
|
+
if pending or timestamp >= cutoff:
|
|
118
|
+
retained.append(row)
|
|
119
|
+
normal = [row for row in retained if row.get('recoveryState') not in {'proposed', 'cancelling', 'cancel_observed'}]
|
|
120
|
+
pending = [row for row in retained if row not in normal]
|
|
121
|
+
return pending + normal[-AUDIT_LIMIT:]
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
def _rehash(rows):
|
|
125
|
+
"""Compaction creates a new self-contained chain; never retain a deleted predecessor hash."""
|
|
126
|
+
previous = ''
|
|
127
|
+
compacted = []
|
|
128
|
+
for row in rows:
|
|
129
|
+
copy = dict(row)
|
|
130
|
+
copy.pop('recordHash', None)
|
|
131
|
+
copy['previousHash'] = previous
|
|
132
|
+
body = json.dumps(copy, sort_keys=True, separators=(',', ':'))
|
|
133
|
+
copy['recordHash'] = 'sha256:' + hashlib.sha256((previous + body).encode()).hexdigest()
|
|
134
|
+
previous = copy['recordHash']
|
|
135
|
+
compacted.append(copy)
|
|
136
|
+
return compacted
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
def audit(path, record, previous=''):
|
|
140
|
+
"""Append one fsynced hash-linked NDJSON record and return its record hash."""
|
|
141
|
+
path = Path(path)
|
|
142
|
+
_safe_parent(path)
|
|
143
|
+
rows = _read_audit(path)
|
|
144
|
+
prior = rows[-1]['recordHash'] if rows else previous
|
|
145
|
+
row = _audit_record(record, prior, len(rows) + 1)
|
|
146
|
+
rows = _retain(rows + [row])
|
|
147
|
+
# Rewrite atomically so compaction cannot leave a partially appended chain.
|
|
148
|
+
# If records were removed their old predecessor is gone, therefore re-link.
|
|
149
|
+
rows = _rehash(rows)
|
|
150
|
+
payload = '\n'.join(json.dumps(item, sort_keys=True, separators=(',', ':')) for item in rows) + '\n'
|
|
151
|
+
fd, temporary = tempfile.mkstemp(dir=path.parent)
|
|
152
|
+
try:
|
|
153
|
+
os.fchmod(fd, 0o600)
|
|
154
|
+
with os.fdopen(fd, 'w', encoding='utf-8') as stream:
|
|
155
|
+
stream.write(payload); stream.flush(); os.fsync(stream.fileno())
|
|
156
|
+
os.replace(temporary, path); os.chmod(path, 0o600)
|
|
157
|
+
finally:
|
|
158
|
+
if os.path.exists(temporary): os.unlink(temporary)
|
|
159
|
+
return row['recordHash']
|
|
160
|
+
|
|
161
|
+
|
|
162
|
+
def profile_root(base, profile):
|
|
163
|
+
return Path(base) / hashlib.sha256(profile.encode()).hexdigest()
|