swarm-state.json

{
  "schemaVersion": "1.0",
  "updatedAt": "2026-03-28T17:30:00Z",
  "updatedBy": "progress-controller-agent",
  "mode": "normal",
  "recommendedMode": "normal",
  "modeReason": "Progress controller confirms normal mode. v2.9.0 released (Go evaluator wildcard matching, --store none fix, report_intent allow rule). KE-2 (#917) remains the critical path to v3.0 — unstarted for 7 days (warning threshold: 14 days). New HIGH-priority issue #1202 (AAB action-type normalization failure causing 3,825+ unintended blocks) requires immediate attention. Backlog expansion 1.16x (healthy, below 2x threshold). ROADMAP maintenance gap: Phase 9 Codex/Gemini items shipped (v2.8.0) but ROADMAP checkboxes still unchecked.",
  "riskAssessment": {
    "compositeScore": 14,
    "escalationLevel": "NORMAL",
    "assessedAt": "2026-03-28T05:15:00Z",
    "dimensions": {
      "prBlastRadius": {
        "score": 3,
        "max": 25,
        "openPRs": 3,
        "conflictedPRs": 2,
        "note": "PR #1178 (valid fix: Copilot meta-tools), PR #1151/#1150 (EM reports, merge conflicts). Small blast radius."
      },
      "testFailureRate": {
        "score": 0,
        "max": 25,
        "note": "4364 tests passing on main. All 18 packages green."
      },
      "governanceDenialRate": {
        "score": 8,
        "max": 25,
        "highPriorityIssuesOpen": 5,
        "securityBypassVectors": [
          "#640 (path manipulation)",
          "#639 (credential stripping)"
        ],
        "policyGaps": [
          "#1177 (github.pr.* + MCP github-mcp-server missing from allow-list)"
        ],
        "note": "5 HIGH-priority issues open. #618 RESOLVED. CRITICAL policy gap #1177: github.pr.* actions missing from default policy; blocks pr-merger agent entirely. PR #1178 partially addresses (Copilot meta-tools)."
      },
      "mergeConflictRate": {
        "score": 3,
        "max": 25,
        "conflictedPRs": 2,
        "openPRs": 3,
        "note": "PRs #1150/#1151 have merge conflicts; they are EM report docs, low blast radius. PR #1178 is clean."
      }
    },
    "deltaFromPrior": {
      "priorScore": 8,
      "currentScore": 14,
      "delta": 6,
      "direction": "worsened",
      "cause": "New P1 policy gap discovered (#1177): github.pr.* actions missing from default allow-list, blocking pr-merger skill entirely. 2 EM reports with merge conflicts in PR queue. Overall health still NORMAL."
    }
  },
  "phaseTracking": {
    "assessedAt": "2026-03-28T05:15:00Z",
    "completedPhases": [
      {
        "phase": "Phase 0",
        "name": "Architecture Clarity",
        "status": "STABLE",
        "completion": 1.0,
        "checkboxes": "6/6"
      },
      {
        "phase": "Phase 1",
        "name": "Canonical Event Model",
        "status": "STABLE",
        "completion": 1.0,
        "checkboxes": "8/8"
      },
      {
        "phase": "Phase 2",
        "name": "AgentGuard Governance Runtime",
        "status": "STABLE",
        "completion": 1.0,
        "checkboxes": "16/16"
      },
      {
        "phase": "Phase 3",
        "name": "Event Persistence + Replay",
        "status": "STABLE",
        "completion": 1.0,
        "checkboxes": "9/9"
      },
      {
        "phase": "Phase 4",
        "name": "Plugin Ecosystem",
        "status": "STABLE",
        "completion": 1.0,
        "checkboxes": "5/5"
      },
      {
        "phase": "Phase 6.5",
        "name": "Invariant Expansion",
        "status": "STABLE",
        "completion": 1.0,
        "checkboxes": "11/11"
      },
      {
        "phase": "KE-1",
        "name": "Invariant Engine Evolution",
        "status": "DONE",
        "completion": 1.0,
        "checkboxes": "6/6",
        "shippedAt": "2026-03-21"
      },
      {
        "phase": "KE-3",
        "name": "Governance Event Envelope",
        "status": "DONE",
        "completion": 1.0,
        "checkboxes": "5/5",
        "shippedAt": "2026-03-24"
      },
      {
        "phase": "Phase 6",
        "name": "Reference Monitor Hardening",
        "status": "DONE",
        "completion": 1.0,
        "checkboxes": "7/7",
        "completedAt": "2026-03-24",
        "note": "All 7 roadmap items complete. Default-deny shipped 2026-03-24. PAUSE/ROLLBACK enforced 2026-03-18. Performance benchmark gate operational. Commit scope guard (#22) shipped v2.5.0."
      },
      {
        "phase": "Phase 6.75",
        "name": "Studio Runtime",
        "status": "DONE",
        "completion": 1.0,
        "checkboxes": "3/3",
        "completedAt": "2026-03-26",
        "note": "All 3 items shipped ahead of schedule in v2.7.x (PR #987): agentguard init studio wizard, execution profiles (6 total), swarm template schema with zero-dep runtime validator."
      }
    ],
    "activePhases": [
      {
        "phase": "KE Sprint",
        "name": "Kernel Evolution Sprint",
        "status": "IN PROGRESS",
        "kePhases": {
          "KE-1": {
            "status": "DONE",
            "completion": 1.0,
            "checkboxes": "6/6",
            "shippedAt": "2026-03-21"
          },
          "KE-2": {
            "status": "IN PROGRESS",
            "completion": 0.0,
            "checkboxes": "0/4",
            "trackingIssue": 856,
            "note": "ActionContext design — in-progress, priority:high, last updated 2026-03-25"
          },
          "KE-3": {
            "status": "DONE",
            "completion": 1.0,
            "checkboxes": "5/5",
            "shippedAt": "2026-03-24"
          },
          "KE-4": {
            "status": "IN REVIEW",
            "completion": 0.0,
            "checkboxes": "0/5",
            "trackingIssue": 687,
            "note": "Plane Separation — status:review, last updated 2026-03-24"
          },
          "KE-5": {
            "status": "IN PROGRESS",
            "completion": 0.0,
            "checkboxes": "0/6",
            "trackingIssue": 716,
            "note": "Semantic CLI Expansion — in-progress"
          },
          "KE-6": {
            "status": "PLANNED",
            "completion": 0.0,
            "checkboxes": "0/5",
            "trackingIssue": 717
          }
        },
        "overallCompletion": 0.37,
        "checkboxes": "11/30",
        "note": "KE-1 and KE-3 complete. KE-2 is the critical path for v3.0. KE-4 in review. Sprint at 37%. Go fast-path delegation shipped (PRs #1000, #1001) as precursor to full Go kernel."
      },
      {
        "phase": "v3.0",
        "name": "v3.0 Major Release",
        "status": "BLOCKED",
        "completion": 0.125,
        "checkboxes": "1/8",
        "blockedBy": "KE-2 (ActionContext) must ship before v3.0 item 1 can be checked",
        "shippedItems": [
          {
            "item": "Install attribution tracking",
            "shippedAt": "2026-03-26",
            "pr": 991
          }
        ],
        "openIssues": [
          {
            "number": 857,
            "title": "Stranger test validation",
            "status": "pending",
            "priority": "high"
          },
          {
            "number": 938,
            "title": "User capture funnel",
            "status": "pending",
            "priority": "high"
          }
        ],
        "transitionReady": false
      },
      {
        "phase": "Phase 9",
        "name": "Editor & Agent Integrations",
        "status": "IN PROGRESS",
        "completion": 0.55,
        "checkboxes": "5/9",
        "shippedItems": [
          {
            "item": "Monitor mode for claude-hook",
            "shippedAt": "2026-03-21",
            "version": "v2.3.0"
          },
          {
            "item": "Agent SDK for programmatic governance",
            "shippedAt": "2026-03-21",
            "version": "v2.3.0"
          },
          {
            "item": "OpenCode driver support",
            "shippedAt": "2026-03-26",
            "pr": 1019
          },
          {
            "item": "Codex CLI adapter",
            "shippedAt": "2026-03-27",
            "version": "v2.8.0",
            "pr": 1024
          },
          {
            "item": "Gemini CLI adapter",
            "shippedAt": "2026-03-27",
            "version": "v2.8.0",
            "pr": 1024
          }
        ],
        "openIssues": [
          {
            "number": 331,
            "title": "Claude Code deep integration",
            "status": "in-progress",
            "lastUpdated": "2026-03-25"
          },
          {
            "number": 1049,
            "title": "JetBrains plugin (IntelliJ/WebStorm)",
            "status": "pending"
          },
          {
            "number": 1055,
            "title": "DeepAgents framework adapter",
            "status": "pending"
          },
          {
            "number": 1054,
            "title": "OpenCode framework adapter (full)",
            "status": "pending"
          }
        ],
        "transitionReady": false
      },
      {
        "phase": "Go Kernel",
        "name": "Go Kernel Rewrite (Phase 1)",
        "status": "IN PROGRESS",
        "completion": 0.2,
        "checkboxes": "1/6",
        "shippedItems": [
          {
            "item": "Go binary fast-path delegation in claude-hook",
            "shippedAt": "2026-03-26",
            "prs": [
              1000,
              1001
            ]
          }
        ],
        "note": "Fast-path delegation operational (PRs #1000, #1001, v2.7.x). Go evaluator wildcard matching added (v2.9.0, PR #1227). Full architecture validation still pending. v2.9.0 represents incremental progress toward KE sub-goals."
      }
    ],
    "plannedPhases": [
      {
        "phase": "Phase 6.5 (new)",
        "name": "Pull-Based Runner",
        "completion": 0.0,
        "checkboxes": "0/10",
        "note": "Depends on v3.0 release + Cloud Phase 2A",
        "issues": [
          748,
          751,
          752
        ]
      },
      {
        "phase": "Phase 7",
        "name": "Capability-Scoped Sessions",
        "completion": 0.0,
        "checkboxes": "0/6",
        "note": "Depends on Phase 6 (DONE) + KE-2",
        "issues": [
          728
        ]
      },
      {
        "phase": "Phase 8",
        "name": "Policy Ecosystem",
        "completion": 0.29,
        "checkboxes": "2/7",
        "issues": [
          729
        ]
      },
      {
        "phase": "Phase 10-11",
        "name": "Storage & Observability",
        "completion": 0.0,
        "checkboxes": "0/4",
        "issues": [
          727
        ]
      },
      {
        "phase": "Phase 12",
        "name": "CI/CD Enforcement",
        "completion": 0.4,
        "checkboxes": "2/5",
        "issues": [
          131
        ]
      },
      {
        "phase": "Phases 13-18",
        "name": "Advanced Research",
        "completion": 0.0,
        "checkboxes": "0/7"
      }
    ],
    "milestones": [
      {
        "event": "PHASE_COMPLETED",
        "phase": "Phase 6",
        "name": "Reference Monitor Hardening",
        "detectedAt": "2026-03-25T13:10:00Z",
        "significance": "Phase 6 completion transforms AgentGuard from advisory interception to mandatory execution control. Default-deny is now the baseline. This unlocks KE-2 and v3.0 work."
      },
      {
        "event": "KE_PHASE_COMPLETED",
        "phase": "KE-3",
        "name": "Governance Event Envelope",
        "detectedAt": "2026-03-25T13:10:00Z",
        "significance": "All telemetry now follows versioned schema. Cloud ingestion consumes envelopes directly with zero special cases."
      },
      {
        "event": "PHASE_COMPLETED",
        "phase": "Phase 6.75",
        "name": "Studio Runtime",
        "detectedAt": "2026-03-27T02:45:00Z",
        "significance": "Studio wizard, execution profiles, and swarm template schema shipped ahead of schedule in v2.7.x (PR #987). Removes this dependency from v3.1 timeline. Runner is now the sole v3.1 item."
      },
      {
        "event": "VERSION_RELEASED",
        "version": "v2.8.0",
        "releasedAt": "2026-03-27T00:26:00Z",
        "significance": "Added Codex CLI and Gemini CLI adapters. AgentGuard now governs 4 CLI agents: Claude Code, Copilot CLI, Codex CLI, Gemini CLI.",
        "prs": [
          1024,
          1025
        ]
      },
      {
        "event": "VERSION_RELEASED",
        "version": "v2.8.4",
        "releasedAt": "2026-03-28T02:34:00Z",
        "significance": "v2.8.1-v2.8.4 patch series: DeepAgents framework adapter (v2.8.1), driverType telemetry field (v2.8.1), read-only fail-open fix (v2.8.2), CI stability fixes (v2.8.3), heredoc false-positive fix + claude-init idempotent hooks (v2.8.4). AgentGuard now governs 5 CLI agents: Claude Code, Copilot CLI, Codex CLI, Gemini CLI, DeepAgents.",
        "prs": [
          1087,
          1098,
          1114,
          1126,
          1147,
          1153,
          1160,
          1164,
          1168
        ]
      },
      {
        "event": "VERSION_RELEASED",
        "version": "v2.9.0",
        "releasedAt": "2026-03-28T00:00:00Z",
        "significance": "Go evaluator wildcard matching shipped (PR #1227, closes #955). Storage: --store none flag respected to prevent eager SQLite load (PR #1207, closes #1188). Policy: report_intent allow rule added + scope governance self-mod invariant scoped (PR #1212). Incremental Go kernel progress and critical dogfood fixes.",
        "prs": [
          1227,
          1207,
          1212
        ]
      }
    ]
  },
  "backlogExpansionRate": {
    "assessedAt": "2026-03-28T17:30:00Z",
    "totalOpenIssues": 197,
    "actionableWorkItems": 30,
    "createdLast7d": 200,
    "closedLast7d": 172,
    "expansionRate": 1.16,
    "status": "HEALTHY",
    "note": "197 open issues total. Expansion rate 1.16x (below 2x warning threshold). 30 backlog-steward actionable items. Majority of open issues are dogfood/operational. New critical item: #1202 (AAB action-type normalization failure — 3,825+ unintended blocks). PR #1233 (user capture funnel) open — if merged, advances v3.0 to 2/8."
  },
  "stallDetection": {
    "stalledPhases": [],
    "warningPhases": [
      {
        "phase": "KE-2",
        "issue": 917,
        "daysSinceLastActivity": 7,
        "note": "KE-2 (ActionContext, #917) unstarted since ~2026-03-21. 0/4 checkboxes. No assigned PR. Critical path for v3.0. At 7 days — warning tracking. Stall threshold is 14 days."
      }
    ],
    "note": "No phases exceed the 14-day stall threshold. KE-2 is the primary risk — v3.0 cannot ship without it. KE-2 has been unstarted for 7 days (half of stall threshold)."
  },
  "healthChecks": {
    "prQueue": {
      "status": "healthy",
      "openPRs": 3,
      "conflictedPRs": 0,
      "note": "PR #1233 (v3.0 user capture funnel — active, in review). PR #1226 (EM report v2.8.5). PR #1224 (site fixes). CI green on all three."
    },
    "ciOnMain": {
      "status": "healthy",
      "note": "Main branch CI green at HEAD (v2.9.0). All recent workflow runs passing."
    },
    "agentLiveness": {
      "status": "active",
      "note": "Multiple agent branches active. Swarm producing work as of 2026-03-28."
    },
    "mergeConflicts": {
      "status": "warning",
      "conflictedPRs": 2,
      "openPRs": 3,
      "note": "PRs #1150/#1151 have merge conflicts. Low urgency (EM reports); authors should rebase or close stale PRs."
    },
    "swarmStateFreshness": {
      "status": "healthy",
      "note": "Updated by progress-controller-agent 2026-03-28T17:30Z."
    },
    "roadmapProgress": {
      "status": "on-track",
      "completedPhases": 10,
      "activePhases": 4,
      "note": "v2.9.0 released. KE Sprint 11/31 = 35.5% (unchanged). v3.0 at 1/8 = 12.5% (PR #1233 user capture funnel open — advances to 2/8 when merged). ROADMAP maintenance gap: Phase 9 Codex/Gemini unchecked despite shipping."
    }
  },
  "recoveryActions": [
    {
      "type": "swarm-state-update",
      "timestamp": "2026-03-22T08:30:00Z",
      "description": "Updated swarm-state.json: Issues #647 and #636 CLOSED, risk score 22->8, escalation ELEVATED->NORMAL.",
      "agent": "risk-escalation-agent"
    },
    {
      "type": "risk-assessment",
      "timestamp": "2026-03-24T16:05:00Z",
      "description": "Risk score 13->23 (NORMAL->ELEVATED). PR queue grew 3->8. #822 CONFLICTING.",
      "agent": "risk-escalation-agent"
    },
    {
      "type": "progress-assessment",
      "timestamp": "2026-03-25T13:10:00Z",
      "description": "Phase 6 COMPLETED (7/7). KE-3 COMPLETED (5/5). KE Sprint 20%->37%. PR queue 8->0. Risk 23->10 (ELEVATED->NORMAL).",
      "agent": "progress-controller-agent"
    },
    {
      "type": "recovery-check",
      "timestamp": "2026-03-25T14:10:00Z",
      "description": "All 6 health dimensions green. Mode confirmed: normal. No remediation required.",
      "agent": "recovery-controller-agent"
    },
    {
      "type": "roadmap-triage",
      "timestamp": "2026-03-27T02:45:00Z",
      "description": "ROADMAP.md and swarm-state.json updated: v2.8.0 release (Codex+Gemini CLI), Phase 6.75 DONE (studio wizard, execution profiles, swarm template schema), install attribution checked off in v3.0 (1/8), Go kernel fast-path delegation operational, #648 resolved. Issue #1048 closed (shipped via PR #991).",
      "agent": "backlog-hygiene--roadmap-triage-agent"
    },
    {
      "type": "roadmap-triage",
      "timestamp": "2026-03-28T05:15:00Z",
      "description": "ROADMAP.md and swarm-state.json updated: v2.8.4 current release. New entries: DeepAgents adapter (v2.8.1), driverType telemetry (v2.8.1), SQLite fallback (v2.8.3), heredoc fix (v2.8.4). Phase 9 DeepAgents checked. P1 policy gap #1177 (github.pr.* missing from allow-list) flagged as high-priority blocker. Security bypass count 6→5 (#618 resolved via PR #1032). Risk score 8→14 (NORMAL).",
      "agent": "backlog-hygiene--roadmap-triage-agent"
    },
    {
      "type": "progress-assessment",
      "timestamp": "2026-03-28T17:30:00Z",
      "description": "KE Sprint 11/31 = 35.5% (unchanged). v3.0 at 1/8 = 12.5%. Backlog expansion 1.16x (healthy). v2.9.0 released. KE-2 unstarted 7 days (warning). New HIGH: #1202 AAB normalization failure. PR #1233 open for v3.0 user capture funnel.",
      "agent": "progress-controller-agent"
    }
  ],
  "blockers": [
    {
      "type": "correctness-regression",
      "severity": "high",
      "issueNumbers": [
        1202
      ],
      "description": "#1202: AAB action-type normalization failure causing 3,825+ unintended blocks. Agents hitting deny decisions due to a normalization bug in action-type mapping. Impacts all agent drivers.",
      "recommendation": "Assign coder-agent to diagnose and fix the AAB normalization logic. This is actively causing governance false positives at scale."
    },
    {
      "type": "critical-path",
      "severity": "high",
      "description": "KE-2 (ActionContext, #917) is the critical path blocker for v3.0. Status: pending, unstarted. No assigned PR.",
      "recommendation": "Assign to kernel-sr or architect-agent. Single most important engineering work item."
    },
    {
      "type": "policy-gap",
      "severity": "high",
      "issueNumbers": [
        1177
      ],
      "description": "P1: github.pr.* and github.issue.* action types missing from default agentguard.yaml allow-list. Blocks pr-merger and any skill using `gh` CLI entirely. Also github-mcp-server not in MCP allow-list. PR #1178 addresses Copilot meta-tools but not the github.* gap.",
      "recommendation": "Assign coder-agent to add github.pr.*/github.issue.*/github.run.*/github.api allow rules to agentguard.yaml and all policy packs."
    },
    {
      "type": "security",
      "severity": "medium",
      "issueNumbers": [
        640,
        639
      ],
      "description": "2 security issues without assigned PRs: #640 (path manipulation), #639 (credential stripping). #618 RESOLVED via PR #1032.",
      "recommendation": "Assign implementation agent to #640 (path manipulation — most exploitable)."
    },
    {
      "type": "operational",
      "severity": "low",
      "issueNumbers": [
        1128
      ],
      "description": "149 orphaned branches reported by stale-branch-janitor (#1128). Swarm health alert open since 2026-03-27.",
      "recommendation": "Human should run `git worktree prune` + bulk delete orphaned branches via stale-branch-janitor PR."
    }
  ],
  "systemSummary": {
    "overallHealth": "healthy",
    "escalationLevel": "NORMAL",
    "riskScore": 16,
    "riskTrend": "worsened-slightly",
    "mainBranchCI": "green",
    "openPRsCount": 3,
    "conflictedPRsCount": 0,
    "stuckPRsCount": 0,
    "ciFailingPRsCount": 0,
    "highIssuesWithoutPR": 5,
    "regressionDetected": false,
    "completedPhaseCount": 10,
    "activePhaseCount": 4,
    "progressSinceLastRun": "v2.9.0 released: Go evaluator wildcard matching, --store none storage fix, report_intent allow rule + scoped self-mod invariant. PR #1233 (v3.0 user capture funnel) opened. New HIGH issue #1202 (AAB normalization failure, 3,825+ unintended blocks). ROADMAP checkpoint count unchanged (11/31 = 35.5% KE Sprint). Backlog expansion 1.16x — healthy. CI green on main.",
    "modeChangeConditions": {
      "toNormal": "CURRENT STATE — risk score 14, 3 open PRs (2 conflicted docs), main CI green.",
      "toElevated": "Risk score exceeds 20, or PR queue grows above 5, or new critical security regression, or #1177 policy gap causes major agent outage.",
      "toCritical": "Main CI failure rate >30%, 2+ unresolved critical issues, or merge conflict cascade (3+ PRs)."
    }
  }
}