aetos/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(standards): assign Hexa MCP port 8008; mark Auth Server deferred

Browse Source
This commit is contained in:
Vishesh 'ironeagle' Bangotra
2026-10-12 21:05:34 +05:30
parent 7d1694148a
commit 9390839d9b
2 changed files with 11 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
standards/mcp/libraries.json
View File

@@ -16,7 +16,7 @@
"purpose": "Declarative dependency injection and composition-root tooling.", "purpose": "Declarative dependency injection and composition-root tooling.",
"use_instead_of": "manual wiring, hand-written factories, manual composition roots", "use_instead_of": "manual wiring, hand-written factories, manual composition roots",
"capabilities": ["di", "dependency-injection", "composition", "wiring", "ports"], "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", "name": "Mongo Ops",
@@ -72,7 +72,8 @@
"purpose": "Central identity service (register/login/me/introspect).", "purpose": "Central identity service (register/login/me/introspect).",
"use_instead_of": "building authentication endpoints yourself", "use_instead_of": "building authentication endpoints yourself",
"capabilities": ["auth", "identity", "service", "register", "login", "introspect"], "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" }
} }
] ]
} }

13
standards/src/lib/13_library_registry.md
View File

@@ -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 | | Library | Import | Purpose | Use instead of | MCP |
|---|---|---|---|---| |---|---|---|---|---|
| DAG Pipe | `dagpipe` | Deterministic state-transformation DAG engine | hand-rolled orchestration/topological ordering | `:8006` | | 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` | | 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` | | 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` | | 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` | | 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` | | 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` | | 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 ## How to choose
@@ -47,8 +47,11 @@ endpoint. Query it before writing any infrastructure.
## Notes ## Notes
- **Hexa** ships an MCP bundle but is not yet assigned a dedicated port in the - **Hexa** is a full library with its own MCP server on `:8008`: read
hub config; it is reachable via the standards registry entry and will be `doc://index`, `doc://nav`, and `doc://modules/{module}` (e.g.
wired to a port. `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): - Library MCP servers expose **documentation resources** (not executable tools):
they tell an agent the available API surface so it does not invent code. they tell an agent the available API surface so it does not invent code.