🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
docs(adr): ADR-453 contract fixes from the build: status.json also carries version:1, startedMs and updatedMs (the Mods scan requires them); rules.json demoted flag; alert id format; hits derived from alerts
ruv7324d3be654e
diff --git a/v3/docs/adr/ADR-453-project-anatole.md b/v3/docs/adr/ADR-453-project-anatole.mdindex 4def20f22a..3aa4fa0118 100644--- a/v3/docs/adr/ADR-453-project-anatole.md+++ b/v3/docs/adr/ADR-453-project-anatole.md@@ -112,10 +112,10 @@ The console's Findings meter on the Security page includes open protector alertsDirectory `.claude-flow/protector-mod/` (the `-mod` suffix is what the console's mod scanner already looks for). Every file carries `"schemaVersion": 1`. Only the mod writes them. A reader refuses anything larger than 64 KB (alerts: the last 200 lines are read).-- **`status.json`**: `{schemaVersion, name:"protector", modVersion, mode, guard, calls, blocked, startedAt, updatedAt, summary, alerts:{open, critical, high, medium, low, total}, baseline:{state:"learning"|"mature", maturity:0-100, events, sessions, firstSeenAt}, rules:{total, block, notify, off}, degraded:false|"<reason>"}`. `calls`, `blocked`, `guard`, `startedAt`, `updatedAt`, `modVersion` and `summary` have the meaning ADR-446 gives the same keys, so the console's existing mod scan reads this file unchanged.-- **`rules.json`**: the person's overrides only, `{schemaVersion, mode?:"off"|"learn"|"notify"|"enforce", rules:{"PR-002":{mode:"off"|"notify"|"block"}}}`. The shipped defaults live in code.+- **`status.json`**: `{schemaVersion, version:1, name:"protector", modVersion, mode, guard, calls, blocked, startedAt, startedMs, updatedAt, updatedMs, summary, alerts:{open, critical, high, medium, low, total}, baseline:{state:"learning"|"mature", maturity:0-100, events, sessions, firstSeenAt}, rules:{total, block, notify, off}, degraded:false|"<reason>"}`. The console's existing mod scan (ADR-446) accepts only `version: 1` and reads `startedMs`/`updatedMs`, so those three keys are written as well as `schemaVersion`/`startedAt`/`updatedAt` (same numbers, epoch milliseconds); without them the Mods page lists Anatole as "refused". `calls`, `blocked`, `guard`, `modVersion` and `summary` have the meaning ADR-446 gives the same keys.+- **`rules.json`**: the person's overrides only, `{schemaVersion, mode?:"off"|"learn"|"notify"|"enforce", rules:{"PR-002":{mode:"off"|"notify"|"block", demoted?:true}}}`. `demoted: true` is written when the 30% acked rule demotes a rule (§3), so the console can say "auto-demoted". The shipped defaults live in code. There is no per-rule hit counter in the files: a reader derives hits and the acked share from the last 200 alerts and says so.- **`baseline.json`**: `{schemaVersion, events, sessions, firstSeenAt, updatedAt, tools:{…}, commands:{…}, hosts:{…}, areas:{…}, spawns:{…}, rate:{p50, p95, max}}`, each map `{token:{n, first, last}}`.-- **`alerts.jsonl`**: one JSON object per line `{id, at, rule, owasp:[…], severity, action:"blocked"|"notified", tool, summary, fp, state:"open"|"acked"|"allowed", session}`. `summary` is at most 160 characters, a shape and never a value; `fp` is a 12-hex fingerprint of `(rule, headToken, hostClass|area)`.+- **`alerts.jsonl`**: one JSON object per line `{id, at, rule, owasp:[…], severity, action:"blocked"|"notified", tool, summary, fp, state:"open"|"acked"|"allowed", session}`; `id` matches `[A-Za-z0-9_.:-]{1,40}`. `summary` is at most 160 characters, a shape and never a value; `fp` is a 12-hex fingerprint of `(rule, headToken, hostClass|area)`.- **`allow.json`**: `{schemaVersion, entries:[{fp, rule, at, note}]}`.`/protector` (the mod answers it locally; no model turn):