@chankov/agent-fleet 0.0.6 → 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/harnesses/agent-hub/README.md +75 -16
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +58 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +54 -8
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +723 -159
- 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 +29 -3
- 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 +4 -3
- package/.pi/harnesses/coms/index.ts +80 -58
- package/.pi/harnesses/coms/package.json +1 -1
- 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/af-set-hermes-watchdog.md +6 -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 +134 -0
- package/README.md +175 -18
- package/agents/code-reviewer.md +2 -2
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +40 -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 +64 -12
- package/docs/agent-fleet-setup.md +2 -2
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +10 -0
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- 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/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/.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/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
|
@@ -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()
|