From 9390839d9b8b3bd8b392872de27ac68fa3516d64 Mon Sep 17 00:00:00 2001
From: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com>
Date: Mon, 12 Oct 2026 21:05:34 +0530
Subject: [PATCH] docs(standards): assign Hexa MCP port 8008; mark Auth Server
 deferred

---
 standards/mcp/libraries.json             |  5 +++--
 standards/src/lib/13_library_registry.md | 13 ++++++++-----
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/standards/mcp/libraries.json b/standards/mcp/libraries.json
index ba58017..f020ea4 100644
--- a/standards/mcp/libraries.json
+++ b/standards/mcp/libraries.json
@@ -16,7 +16,7 @@
       "purpose": "Declarative dependency injection and composition-root tooling.",
       "use_instead_of": "manual wiring, hand-written factories, manual composition roots",
       "capabilities": ["di", "dependency-injection", "composition", "wiring", "ports"],
-      "mcp": { "server": "hexa", "port": null, "note": "bundle exists; port not yet assigned" }
+      "mcp": { "server": "hexa", "port": 8008 }
     },
     {
       "name": "Mongo Ops",
@@ -72,7 +72,8 @@
       "purpose": "Central identity service (register/login/me/introspect).",
       "use_instead_of": "building authentication endpoints yourself",
       "capabilities": ["auth", "identity", "service", "register", "login", "introspect"],
-      "mcp": { "server": null, "port": null, "note": "service; no MCP bundle" }
+      "status": "deferred",
+      "mcp": { "server": null, "port": null, "note": "service; no MCP bundle; deferred" }
     }
   ]
 }
diff --git a/standards/src/lib/13_library_registry.md b/standards/src/lib/13_library_registry.md
index 5e8ef84..3fc36a7 100644
--- a/standards/src/lib/13_library_registry.md
+++ b/standards/src/lib/13_library_registry.md
@@ -17,14 +17,14 @@ can read a library's full API by connecting to its MCP and reading
 | Library | Import | Purpose | Use instead of | MCP |
 |---|---|---|---|---|
 | DAG Pipe | `dagpipe` | Deterministic state-transformation DAG engine | hand-rolled orchestration/topological ordering | `:8006` |
-| Hexa | `hexa` | Declarative DI / composition-root tooling | manual wiring, hand-written factories | *(see note)* |
+| Hexa | `hexa` | Declarative DI / composition-root tooling | manual wiring, hand-written factories | `:8008` |
 | Mongo Ops | `mongo_ops` | Async MongoDB repositories, cache, populate, transactions | raw Motor CRUD and connection lifecycle | `:8007` |
 | Omniread | `omniread` | Format-agnostic fetch + parse (HTML, PDF, CSV, XLSX) | custom scrapers/parsers | `:8003` |
 | OpenAPI First | `openapi_first` | Spec-first FastAPI bootstrap, client, codegen | decorator routers and hand-written clients | `:8004` |
 | Mail Intake | `mail_intake` | Provider-agnostic read-only email ingestion | Gmail OAuth + MIME parsing | `:8002` |
 | Py JWT | `jwtlib` | JWT auth primitives (register/login/introspect) | password hashing + token code | `:8005` |
 | Doc Forge | `docforge` | Docstring compiler → MkDocs + MCP docs | custom doc generators | `:8001` |
-| Auth Server | *(service)* | Central identity service (register/login/me/introspect) | building auth endpoints yourself | — |
+| Auth Server | *(service)* | Central identity service (register/login/me/introspect) | building auth endpoints yourself | *(deferred)* |
 
 ## How to choose
 
@@ -47,8 +47,11 @@ endpoint. Query it before writing any infrastructure.
 
 ## Notes
 
-- **Hexa** ships an MCP bundle but is not yet assigned a dedicated port in the
-  hub config; it is reachable via the standards registry entry and will be
-  wired to a port.
+- **Hexa** is a full library with its own MCP server on `:8008`: read
+  `doc://index`, `doc://nav`, and `doc://modules/{module}` (e.g.
+  `doc://modules/hexa.container`) to discover the DI surface — `build(cls, *,
+  instances, config)` and the `PortNode` model.
+- **Auth Server** is deferred: it has no `pyproject.toml`/importable package and
+  no MCP bundle. Do not reach for it yet; `py-jwt` covers token primitives.
 - Library MCP servers expose **documentation resources** (not executable tools):
   they tell an agent the available API surface so it does not invent code.