Gateway Module Spec Index
Index of the per-module endpoint specifications for the LisaOS memory gateway. One CS.AK.LISA.Docu.Module.{Name}.md file per directory under memory_gateway/server/, authored during Phase 4 of the LisaOS Full-System Audit Campaign (§5.2).
Ground truth: lisa-os main at 5c9a304. Read-only inventory.
Module count — the correction
23 modules. 22 code-bearing (TypeScript) + dashboard/ (static frontend assets, 0 TS). This is the authoritative count and supersedes both stale figures: the TechSpec's "18" and the campaign plan's "~20". Any document, diagram, or health-card label still asserting 18 or 20 is wrong and must be reconciled to 23 (22 + static).
The "live REST surface" honesty column
Not every directory that Express could route actually serves HTTP. Six modules expose no live REST surface, and one (memory) serves REST from outside its own directory. This is load-bearing for anyone auditing the attack surface or the auth matrix — the mounted-router count is not the module count.
auth— middleware only (createAuthMatrix); it is the authorisation gate, it does not sit behind one.notifications— background Telegram service; no router.shared— utilities (search-utils,zod-error); no router.dashboard— static frontend; pages +express.static+ auth-shim are wired in top-levelindex.ts, not this directory.knowledge-graph+cross-references— internal repositories feeding context assembly (AK-347).routes.tsfiles exist in both but are neverapp.use'd — dead, unmounted router code (clone-3 HIGH finding). Their only live surface is via/api/context/*and the MCP KG tools.memory— has REST, but it is defined inline in top-levelindex.ts(L531–731):/api/health,/api/health/detail,GET/POST /api/memory,GET/PUT/DELETE /api/memory/:id. The directory holdsdb.ts,embeddings,repositories,cache,types— noroutes.ts.
Shard 1 — Memory / Cache / Context core
| # | Directory | Spec file | Router mount | Live REST? |
|---|---|---|---|---|
| 1 | memory | memory | (inline in index.ts L531–731) | Yes — outside module dir |
| 2 | psychic-cache | psychic-cache | /api/psychic-cache | Yes |
| 3 | context | context | /api/context | Yes |
| 4 | search | search | /api/search | Yes |
| 5 | vault-index | vault-index | /api/vault-index | Yes |
| 6 | shared | shared | — | No — utilities |
Shard 2 — Dispatch / Sessions / Agents / MCP
| # | Directory | Spec file | Router mount | Live REST? |
|---|---|---|---|---|
| 7 | dispatch | dispatch | /api/dispatch + /api/timeline | Yes |
| 8 | mcp | mcp | (stdio server, not Express) | Yes — MCP transport |
| 9 | agent-memory | agent-memory | /api/agent-memory | Yes |
| 10 | agent-tune | agent-tune | /api/agent-tune | Yes |
| 11 | sessions | sessions | /api/sessions (+ SSE /events) | Yes |
| 12 | tools | tools | /api/tools | Yes |
| 13 | activity | activity | /api/activity | Yes |
Shard 3 — Analytics / Auth / Ops / Frontend
| # | Directory | Spec file | Router mount | Live REST? |
|---|---|---|---|---|
| 14 | analytics | analytics | /api/analytics | Yes |
| 15 | compute-metering | compute-metering | /api/compute-capture | Yes |
| 16 | auth | auth | (middleware) | No — the gate itself |
| 17 | notifications | notifications | — | No — background service |
| 18 | curator | curator | /api/curator | Yes |
| 19 | cross-references | cross-references | (router UNMOUNTED — dead) | No — internal repo |
| 20 | knowledge-graph | knowledge-graph | (router UNMOUNTED — dead) | No — internal repo |
| 21 | skills-telemetry | skills-telemetry | /api/skills/telemetry | Yes |
| 22 | dashboard-api | dashboard-api | /api/dashboard | Yes |
| 23 | dashboard | dashboard | (static + rendered pages in index.ts) | No — static frontend |
Tally
| Category | Count |
|---|---|
| Total modules | 23 |
| Code-bearing (TypeScript) | 22 |
Static frontend (dashboard) | 1 |
| Mounted Express routers | 15 |
| Live REST from own directory | 14 |
REST inline elsewhere (memory) | 1 |
MCP stdio transport (mcp) | 1 |
| No live REST surface | 6 (auth, notifications, shared, dashboard, knowledge-graph, cross-references) |
| Dead unmounted routers (HIGH finding) | 2 (knowledge-graph, cross-references) |
Change history
| Date | Dispatch | Summary |
|---|---|---|
| 2026-07-04 | 2291 | Index created. 23 module specs authored via 3-way shadow-clone split. Ground-truth count 23 established, supersedes 18/20. |