From 3743858cb21cdfdc2e1b7fe923e3a3c3ceb319a5 Mon Sep 17 00:00:00 2001
From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com>
Date: Mon, 1 Jun 2026 12:55:32 +0100
Subject: [PATCH] docs(topology): correct cartridge counts to match filesystem
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`find cartridges -name cartridge.json | wc -l` returns 125 — the
canonical count, also mirrored in STATE.a2ml (per the 2026-05-26
CHANGELOG entry that corrected STATE.a2ml from 112 to 125).

Three count fixes:

- Header `Cartridge Matrix (112 total)` → `(125 total)` so it matches
  filesystem + STATE.a2ml + CHANGELOG.
- Top-of-file comment `Updated 2026-04-30. 115 cartridges …` → current
  date + count. (115 was yet another stale figure separate from 112.)
- `Infrastructure & Utility (10)` → `(19)` — the section label said 10
  but the table actually rows-out as 19.

Per-tier sums now: 11 + 10 + 8 + 13 + 8 + 6 + 27 + 19 = 102. That is
still 23 short of the actual 125 — added an HTML-comment audit note
documenting the inventory deficit so readers don't take 102 as
ground-truth. The source-of-truth list remains the cartridges/
directory itself.

Also fills in the missing `Copyright (c) 2026 …` line that the
pre-commit hook now requires on every file (pre-existing gap; surfaced
when staging this change).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 TOPOLOGY.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/TOPOLOGY.md b/TOPOLOGY.md
index d9275942..ad49c804 100644
--- a/TOPOLOGY.md
+++ b/TOPOLOGY.md
@@ -1,7 +1,9 @@
 # SPDX-License-Identifier: MPL-2.0
+# Copyright (c) 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
+#
 # TOPOLOGY.md — BoJ Server Component Matrix
 #
-# Updated 2026-04-30. 115 cartridges across 6 tiers (111 with `.so` built, 4 pending).
+# Updated 2026-06-01. 125 cartridges (per `find cartridges -name cartridge.json | wc -l`).
 
 ## Ports
 
@@ -13,7 +15,14 @@
 | 7703 | SSE (Server-Sent Events) | Running |
 | 7745 | local-coord-mcp (loopback only) | Running |
 
-## Cartridge Matrix (112 total)
+## Cartridge Matrix (125 total)
+
+<!-- 125 = `find cartridges -name cartridge.json | wc -l` on origin/main.
+     The per-tier tables below currently inventory 102 of those 125
+     (Tiers 1–6 = 56 + Hyperpolymath Ecosystem = 27 + Infrastructure &
+     Utility = 19). The 23-cartridge inventory deficit is tracked
+     separately; the source-of-truth count is the cartridges/ directory
+     itself (mirrored in `.machine_readable/STATE.a2ml`). -->
 
 ### Tier 1 — High-Value APIs (11)
 | Cartridge | Domain |
@@ -126,7 +135,7 @@
 | panic-attack-mcp | Security scanning |
 | proof-mcp | Formal verification |
 
-### Infrastructure & Utility (10)
+### Infrastructure & Utility (19)
 | Cartridge | Domain |
 |-----------|--------|
 | queues-mcp | Message queues |