docs: record hub-core adapter seams
This commit is contained in:
@@ -34,12 +34,17 @@ hub_core/
|
|||||||
domain.py
|
domain.py
|
||||||
managed_repo.py
|
managed_repo.py
|
||||||
agent_message.py
|
agent_message.py
|
||||||
|
capability_catalog.py
|
||||||
|
capability_request.py
|
||||||
|
progress_event.py
|
||||||
tpsc.py
|
tpsc.py
|
||||||
schemas/
|
schemas/
|
||||||
__init__.py
|
__init__.py
|
||||||
domain.py
|
domain.py
|
||||||
managed_repo.py
|
managed_repo.py
|
||||||
agent_message.py
|
agent_message.py
|
||||||
|
capability.py
|
||||||
|
progress_event.py
|
||||||
tpsc.py
|
tpsc.py
|
||||||
routers/
|
routers/
|
||||||
__init__.py
|
__init__.py
|
||||||
@@ -66,6 +71,9 @@ Current implementation status:
|
|||||||
- 2026-06-06: shared utilities and migration scaffold were added: slug
|
- 2026-06-06: shared utilities and migration scaffold were added: slug
|
||||||
normalization, pagination, repo path resolution, trailing-slash path
|
normalization, pagination, repo path resolution, trailing-slash path
|
||||||
normalization, Alembic templates, and an initial core-schema migration.
|
normalization, Alembic templates, and an initial core-schema migration.
|
||||||
|
- 2026-06-06: progress event and capability request adapter seams were added.
|
||||||
|
Hub-core uses generic JSON context fields where State Hub currently has
|
||||||
|
dev-specific workstream/task/topic/decision foreign keys.
|
||||||
|
|
||||||
## Extract Now
|
## Extract Now
|
||||||
|
|
||||||
@@ -119,6 +127,8 @@ covers only the currently extracted core tables:
|
|||||||
- `managed_repos`
|
- `managed_repos`
|
||||||
- `agent_messages`
|
- `agent_messages`
|
||||||
- `capability_catalog`
|
- `capability_catalog`
|
||||||
|
- `capability_requests`
|
||||||
|
- `progress_events`
|
||||||
- `tpsc_catalog`
|
- `tpsc_catalog`
|
||||||
- `tpsc_snapshots`
|
- `tpsc_snapshots`
|
||||||
- `tpsc_entries`
|
- `tpsc_entries`
|
||||||
@@ -132,10 +142,17 @@ implementation is coupled to dev-hub concepts:
|
|||||||
| --- | --- |
|
| --- | --- |
|
||||||
| `Domain` and `domains.py` detail views | Counts topics, workstreams, extension points, and technical debt. Hub-core should expose a domain summary hook that dev-hub can implement. |
|
| `Domain` and `domains.py` detail views | Counts topics, workstreams, extension points, and technical debt. Hub-core should expose a domain summary hook that dev-hub can implement. |
|
||||||
| `ManagedRepo` | Contains `topic_id`, SBOM fields, and state-sync timestamps. Keep minimal repo identity in core, then add dev-hub extensions. |
|
| `ManagedRepo` | Contains `topic_id`, SBOM fields, and state-sync timestamps. Keep minimal repo identity in core, then add dev-hub extensions. |
|
||||||
| `CapabilityRequest` | Points at workstreams and tasks. Hub-core needs generic context fields or optional extension references before extraction. |
|
| `CapabilityRequest` | Adapter seam implemented with generic `request_context` and `fulfillment_context`; State Hub still needs a later refactor to map workstream/task references into those fields or a dev-hub extension table. |
|
||||||
| `ProgressEvent` | Points at topics, workstreams, tasks, and decisions. Hub-core should define event identity, type, summary, detail, author, and timestamps, with hub-specific subject references added by each hub. |
|
| `ProgressEvent` | Adapter seam implemented with generic `subject_refs`; State Hub still needs a later refactor to map topic/workstream/task/decision foreign keys into that field or a dev-hub extension table. |
|
||||||
| MCP tools in `mcp_server/server.py` | Generic tools are mixed into a single dev-hub server module. T06 should create a base registration class that receives API client/config dependencies and lets dev-hub add its own tools. |
|
| MCP tools in `mcp_server/server.py` | Generic tools are mixed into a single dev-hub server module. T06 should create a base registration class that receives API client/config dependencies and lets dev-hub add its own tools. |
|
||||||
|
|
||||||
|
The first two adapter seams are now implemented in hub-core:
|
||||||
|
|
||||||
|
- `ProgressEvent.subject_refs`: generic JSON references for hub-local subjects.
|
||||||
|
- `CapabilityRequest.request_context` and `fulfillment_context`: generic JSON
|
||||||
|
context for hub-local workstreams, tasks, incidents, services, budgets, or
|
||||||
|
other future hub entities.
|
||||||
|
|
||||||
## Keep In Dev-Hub
|
## Keep In Dev-Hub
|
||||||
|
|
||||||
The following State Hub areas should not move into hub-core during T05:
|
The following State Hub areas should not move into hub-core during T05:
|
||||||
|
|||||||
@@ -178,6 +178,13 @@ migration covering domains, managed repos, agent messages, capability catalog,
|
|||||||
and TPSC tables. Hub-core verification now covers package compilation, router
|
and TPSC tables. Hub-core verification now covers package compilation, router
|
||||||
construction, registered metadata, and utility behavior.
|
construction, registered metadata, and utility behavior.
|
||||||
|
|
||||||
|
Implementation slice 4 (2026-06-06): added progress event and capability
|
||||||
|
request adapter seams to `/home/worsch/hub-core`. The core progress event uses
|
||||||
|
generic `subject_refs` JSON instead of dev-hub foreign keys, and capability
|
||||||
|
requests use JSON request/fulfillment context fields instead of workstream/task
|
||||||
|
columns. This keeps hub-core reusable while giving State Hub a migration path
|
||||||
|
for its dev-specific references.
|
||||||
|
|
||||||
### T06 — Hub-core FastMCP base server
|
### T06 — Hub-core FastMCP base server
|
||||||
|
|
||||||
```task
|
```task
|
||||||
|
|||||||
Reference in New Issue
Block a user