feat(catalog): configurable cartridges root + canonical schema + category field sweep

cartridges/007-mcp/cartridge.json

@@ -33,8 +33,9 @@
     "graceful_degrade": true
   },
   "copyright": "Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>",
-  "description": "007 agent meta-language cartridge — exposes the full oo7 CLI surface (parse/run/trace/build/test/lint/verify/contractile verbs/canonical-proof-suite/groove/self-assess) plus on-enter and on-exit lifecycle hooks that register the session as a coord peer, load the 6a2 methodology pack (STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK), and perform drift checks on exit.",
+  "description": "007 agent meta-language cartridge \u2014 exposes the full oo7 CLI surface (parse/run/trace/build/test/lint/verify/contractile verbs/canonical-proof-suite/groove/self-assess) plus on-enter and on-exit lifecycle hooks that register the session as a coord peer, load the 6a2 methodology pack (STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK), and perform drift checks on exit.",
   "domain": "dezig",
+  "category": "domain",
   "federation": "none",
   "memory_autolift": {
     "base_tags": [
@@ -58,7 +59,7 @@
   "tier": "Ayo",
   "tools": [
     {
-      "description": "Lifecycle hook — invoke when entering the 007-lang context. Registers this session as a coord peer (graceful degrade if local-coord-mcp is down), loads the 6a2 methodology pack (STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK), runs the memory auto-lift using repo-derived tags, and returns a structured A2ML payload with peer_id, session_token, methodology digests, and memory hits. Idempotent: calling twice returns the same peer_id/token.",
+      "description": "Lifecycle hook \u2014 invoke when entering the 007-lang context. Registers this session as a coord peer (graceful degrade if local-coord-mcp is down), loads the 6a2 methodology pack (STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK), runs the memory auto-lift using repo-derived tags, and returns a structured A2ML payload with peer_id, session_token, methodology digests, and memory hits. Idempotent: calling twice returns the same peer_id/token.",
       "inputSchema": {
         "properties": {
           "session_hint": {
@@ -72,7 +73,7 @@
       "name": "oo7_on_enter"
     },
     {
-      "description": "Lifecycle hook — invoke before leaving the 007-lang context. Updates STATE.a2ml's last-session fields, runs a drift check (open claims? uncommitted contractile edits? stale 6a2 files?), releases any coord task claims held by this peer, and deregisters from local-coord-mcp. Returns A2ML summary with drift findings. Safe to call even if on_enter was never invoked.",
+      "description": "Lifecycle hook \u2014 invoke before leaving the 007-lang context. Updates STATE.a2ml's last-session fields, runs a drift check (open claims? uncommitted contractile edits? stale 6a2 files?), releases any coord task claims held by this peer, and deregisters from local-coord-mcp. Returns A2ML summary with drift findings. Safe to call even if on_enter was never invoked.",
       "inputSchema": {
         "properties": {
           "reason": {
@@ -556,7 +557,7 @@
       "name": "oo7_dust_status_local"
     },
     {
-      "description": "Revert all source changes to last commit. DESTRUCTIVE — the adapter rejects this tool unless the caller holds a Tier-3 master approval. Wraps `just dust-source-rollback`.",
+      "description": "Revert all source changes to last commit. DESTRUCTIVE \u2014 the adapter rejects this tool unless the caller holds a Tier-3 master approval. Wraps `just dust-source-rollback`.",
       "inputSchema": {
         "properties": {},
         "required": [],
@@ -565,7 +566,7 @@
       "name": "oo7_dust_source_rollback"
     },
     {
-      "description": "Verify OpenSSF Best Practices prerequisites — fails if required files are missing. Wraps `just verify`.",
+      "description": "Verify OpenSSF Best Practices prerequisites \u2014 fails if required files are missing. Wraps `just verify`.",
       "inputSchema": {
         "properties": {},
         "required": [],
@@ -574,7 +575,7 @@
       "name": "oo7_verify"
     },
     {
-      "description": "Verify the Harvard architecture invariant — data expressions must not contain control flow. Wraps `just verify-harvard`.",
+      "description": "Verify the Harvard architecture invariant \u2014 data expressions must not contain control flow. Wraps `just verify-harvard`.",
       "inputSchema": {
         "properties": {},
         "required": [],

cartridges/academic-workflow-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "1.0.0",
   "description": "Academic workflow \u2014 Zotero integration, citations, paper review",
   "domain": "Research",
+  "category": "domain",
   "tier": "Ayo",
   "auth": {
     "method": "none"

cartridges/aerie-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "Aerie environment lifecycle manager",
   "domain": "infrastructure",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/affinescript-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "AffineScript language cartridge -- type checking, parsing, formatting, linting, compiling, hover/goto-def/completion queries, error explanation, stdlib browsing, and syntax reference for the AffineScript language (substructural type system with affine/linear types, algebraic effects)",
   "domain": "Languages",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",
@@ -195,7 +196,7 @@
     },
     {
       "name": "affinescript_hover",
-      "description": "Return type and symbol information for the symbol at a cursor position in AffineScript source code. Runs the full pipeline (parse → resolve → typecheck) and returns JSON hover info.",
+      "description": "Return type and symbol information for the symbol at a cursor position in AffineScript source code. Runs the full pipeline (parse \u2192 resolve \u2192 typecheck) and returns JSON hover info.",
       "inputSchema": {
         "type": "object",
         "properties": {

cartridges/agent-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "OODA loop agent session enforcer",
   "domain": "ai",
+  "category": "cross-cutting",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/airtable-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.2.0",
   "description": "Airtable cartridge -- base listing, table schema retrieval, record search, record creation, record update, field listing, view browsing, webhook management, comment access, and revision history via the Airtable REST API",
   "domain": "Productivity",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",
@@ -149,7 +150,7 @@
     },
     {
       "name": "airtable_update_record",
-      "description": "Update an existing record's field values (PATCH — only specified fields are updated)",
+      "description": "Update an existing record's field values (PATCH \u2014 only specified fields are updated)",
       "inputSchema": {
         "type": "object",
         "properties": {

cartridges/arango-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "ArangoDB multi-model database gateway. AQL queries, document operations, graph traversals, and collection management.",
   "domain": "Database",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/aws-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "AWS cloud gateway. Session-based authentication with per-region slots, throttle management, and multi-service action routing.",
   "domain": "Cloud",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/bofig-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "1.0.0",
   "description": "Bofig Cartridge \u2014 Evidence graph query tools for investigative workflows",
   "domain": "Research",
+  "category": "domain",
   "tier": "Ayo",
   "auth": {
     "method": "none"

cartridges/boj-health/cartridge.json

@@ -5,10 +5,13 @@
   "name": "boj-health",
   "version": "0.1.0",
   "status": "ffi_only",
-  "description": "BoJ server self-health cartridge — status, ping, and uptime queries. Self-contained Zig FFI (.so) reference implementation: no external services required.",
+  "description": "BoJ server self-health cartridge \u2014 status, ping, and uptime queries. Self-contained Zig FFI (.so) reference implementation: no external services required.",
   "domain": "infrastructure",
+  "category": "cross-cutting",
   "tier": "Ayo",
-  "protocols": ["MCP"],
+  "protocols": [
+    "MCP"
+  ],
   "auth": {
     "method": "none",
     "env_var": null,
@@ -21,7 +24,13 @@
   "ffi": {
     "so_path": "ffi/zig-out/lib/libboj_health.so",
     "abi_version": "ADR-0006",
-    "symbols": ["boj_cartridge_init", "boj_cartridge_deinit", "boj_cartridge_name", "boj_cartridge_version", "boj_cartridge_invoke"]
+    "symbols": [
+      "boj_cartridge_init",
+      "boj_cartridge_deinit",
+      "boj_cartridge_name",
+      "boj_cartridge_version",
+      "boj_cartridge_invoke"
+    ]
   },
   "tools": [
     {
@@ -34,7 +43,7 @@
     },
     {
       "name": "boj_health_ping",
-      "description": "Ping the BoJ health cartridge — always returns pong",
+      "description": "Ping the BoJ health cartridge \u2014 always returns pong",
       "inputSchema": {
         "type": "object",
         "properties": {}

cartridges/browser-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "Firefox browser automation via Marionette",
   "domain": "automation",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/bsp-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "Generic Build Server Protocol (BSP 2.x) gateway. Spawns any BSP server as a persistent subprocess and exposes build lifecycle operations (initialize, targets, compile, test, run, clean, diagnostics) as MCP tools.",
   "domain": "Language Tools",
+  "category": "cross-cutting",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/buildkite-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "Buildkite CI/CD cartridge -- pipeline listing, build management, job inspection, artifact retrieval, agent listing, annotation creation, build triggering, log retrieval, environment listing, and build cancellation via the Buildkite REST API",
   "domain": "CI/CD",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/burble-admin-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "Burble WebRTC server administration",
   "domain": "communications",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",

cartridges/chromadb-mcp/cartridge.json

@@ -5,19 +5,167 @@
   "name": "chromadb-mcp",
   "version": "0.1.0",
   "status": "stub",
-  "description": "Chroma vector DB — embedded (local persistent) or client/server; LLM-app-focused; metadata + document storage alongside vectors.",
+  "description": "Chroma vector DB \u2014 embedded (local persistent) or client/server; LLM-app-focused; metadata + document storage alongside vectors.",
   "domain": "vector",
+  "category": "domain",
   "tier": "Teranga",
-  "protocols": ["MCP", "REST"],
-  "auth": { "method": "optional_bearer", "env_var": "CHROMA_AUTH_TOKEN", "credential_source": "Optional — embedded mode has no auth; client/server may use bearer token." },
-  "api": { "base_url": "local://chromadb-mcp", "content_type": "application/json" },
+  "protocols": [
+    "MCP",
+    "REST"
+  ],
+  "auth": {
+    "method": "optional_bearer",
+    "env_var": "CHROMA_AUTH_TOKEN",
+    "credential_source": "Optional \u2014 embedded mode has no auth; client/server may use bearer token."
+  },
+  "api": {
+    "base_url": "local://chromadb-mcp",
+    "content_type": "application/json"
+  },
   "tools": [
-    { "name": "vector_authenticate", "description": "Store Chroma endpoint URL (or 'embedded' for in-process) + optional bearer.", "inputSchema": { "type": "object", "properties": { "endpoint": { "type": "string" }, "auth_token": { "type": "string" }, "embedding_function": { "type": "string" } }, "required": ["endpoint"] } },
-    { "name": "vector_list_collections", "description": "List collections.", "inputSchema": { "type": "object", "properties": {} } },
-    { "name": "vector_create_collection", "description": "Create a collection with optional embedding function + metadata.", "inputSchema": { "type": "object", "properties": { "name": { "type": "string" }, "metadata": { "type": "object" }, "embedding_function": { "type": "string" } }, "required": ["name"] } },
-    { "name": "vector_delete_collection", "description": "Delete a collection.", "inputSchema": { "type": "object", "properties": { "name": { "type": "string" } }, "required": ["name"] } },
-    { "name": "vector_upsert", "description": "Add documents + vectors + metadata. Chroma computes embeddings if not provided.", "inputSchema": { "type": "object", "properties": { "collection": { "type": "string" }, "ids": { "type": "array" }, "documents": { "type": "array" }, "embeddings": { "type": "array" }, "metadatas": { "type": "array" } }, "required": ["collection", "ids"] } },
-    { "name": "vector_query", "description": "Query by text or embedding with where-filter + document-content filter.", "inputSchema": { "type": "object", "properties": { "collection": { "type": "string" }, "query_texts": { "type": "array" }, "query_embeddings": { "type": "array" }, "n_results": { "type": "integer" }, "where": { "type": "object" }, "where_document": { "type": "object" } }, "required": ["collection"] } },
-    { "name": "vector_delete", "description": "Delete documents by id or where-filter.", "inputSchema": { "type": "object", "properties": { "collection": { "type": "string" }, "ids": { "type": "array" }, "where": { "type": "object" } }, "required": ["collection"] } }
+    {
+      "name": "vector_authenticate",
+      "description": "Store Chroma endpoint URL (or 'embedded' for in-process) + optional bearer.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "endpoint": {
+            "type": "string"
+          },
+          "auth_token": {
+            "type": "string"
+          },
+          "embedding_function": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "endpoint"
+        ]
+      }
+    },
+    {
+      "name": "vector_list_collections",
+      "description": "List collections.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "vector_create_collection",
+      "description": "Create a collection with optional embedding function + metadata.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "metadata": {
+            "type": "object"
+          },
+          "embedding_function": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ]
+      }
+    },
+    {
+      "name": "vector_delete_collection",
+      "description": "Delete a collection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ]
+      }
+    },
+    {
+      "name": "vector_upsert",
+      "description": "Add documents + vectors + metadata. Chroma computes embeddings if not provided.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "collection": {
+            "type": "string"
+          },
+          "ids": {
+            "type": "array"
+          },
+          "documents": {
+            "type": "array"
+          },
+          "embeddings": {
+            "type": "array"
+          },
+          "metadatas": {
+            "type": "array"
+          }
+        },
+        "required": [
+          "collection",
+          "ids"
+        ]
+      }
+    },
+    {
+      "name": "vector_query",
+      "description": "Query by text or embedding with where-filter + document-content filter.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "collection": {
+            "type": "string"
+          },
+          "query_texts": {
+            "type": "array"
+          },
+          "query_embeddings": {
+            "type": "array"
+          },
+          "n_results": {
+            "type": "integer"
+          },
+          "where": {
+            "type": "object"
+          },
+          "where_document": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "collection"
+        ]
+      }
+    },
+    {
+      "name": "vector_delete",
+      "description": "Delete documents by id or where-filter.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "collection": {
+            "type": "string"
+          },
+          "ids": {
+            "type": "array"
+          },
+          "where": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "collection"
+        ]
+      }
+    }
   ]
 }

cartridges/circleci-mcp/cartridge.json

@@ -6,6 +6,7 @@
   "version": "0.1.0",
   "description": "CircleCI CI/CD cartridge -- pipeline listing, workflow management, job inspection, artifact retrieval, project listing, environment variable browsing, pipeline triggering, job cancellation, and insight queries via the CircleCI API v2",
   "domain": "CI/CD",
+  "category": "domain",
   "tier": "Ayo",
   "protocols": [
     "MCP",