docs: record hub-core utilities slice

This commit is contained in:
2026-06-06 22:14:02 +02:00
parent bd0f9164b5
commit 9d5c13abb6
2 changed files with 35 additions and 0 deletions

View File

@@ -63,6 +63,9 @@ Current implementation status:
- 2026-06-06: router factory functions were added for domains, repos, messages, - 2026-06-06: router factory functions were added for domains, repos, messages,
TPSC, and policy lookup. These factories accept host-supplied dependencies TPSC, and policy lookup. These factories accept host-supplied dependencies
instead of importing State Hub globals. instead of importing State Hub globals.
- 2026-06-06: shared utilities and migration scaffold were added: slug
normalization, pagination, repo path resolution, trailing-slash path
normalization, Alembic templates, and an initial core-schema migration.
## Extract Now ## Extract Now
@@ -95,6 +98,31 @@ app.include_router(create_domains_router(get_session))
That shape lets each hub keep its own database session configuration and mount That shape lets each hub keep its own database session configuration and mount
only the generic routers it wants. only the generic routers it wants.
## Shared Utilities
The initial utility set is intentionally small and dependency-light:
| Module | Purpose |
| --- | --- |
| `hub_core.utils.slugs` | Convert user-facing names into stable lowercase slugs. |
| `hub_core.utils.pagination` | Shared limit/offset bounds and SQLAlchemy pagination. |
| `hub_core.utils.paths` | Resolve repo paths from `host_paths` before falling back to `local_path`. |
| `hub_core.utils.routing` | Normalize a path or URL path component while preserving query strings and fragments. |
## Migration Scaffold
`/home/worsch/hub-core` now carries Alembic template files under
`hub_core/migrations/` plus `versions/0001_core_schema.py`. The first migration
covers only the currently extracted core tables:
- `domains`
- `managed_repos`
- `agent_messages`
- `capability_catalog`
- `tpsc_catalog`
- `tpsc_snapshots`
- `tpsc_entries`
## Needs An Adapter Seam ## Needs An Adapter Seam
These are still part of the target architecture, but the current State Hub These are still part of the target architecture, but the current State Hub

View File

@@ -171,6 +171,13 @@ binding to State Hub globals, preserving the package boundary for future hubs.
Verification currently covers package compilation, SQLAlchemy metadata Verification currently covers package compilation, SQLAlchemy metadata
registration, and router factory construction. registration, and router factory construction.
Implementation slice 3 (2026-06-06): added hub-core shared utilities for slug
normalization, pagination, repo path resolution, and trailing-slash path
normalization. Added Alembic migration templates plus an initial core schema
migration covering domains, managed repos, agent messages, capability catalog,
and TPSC tables. Hub-core verification now covers package compilation, router
construction, registered metadata, and utility behavior.
### T06 — Hub-core FastMCP base server ### T06 — Hub-core FastMCP base server
```task ```task