coulomb/hub-core
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
hub-core/README.md

47 lines
1.8 KiB
Markdown
Raw Normal View History

Add hub-core package, docs, and State Hub integration scaffold Extract the first reusable slice (models, schemas, routers, MCP, migrations) from state-hub with INTENT/SCOPE, agent instructions, workplan, and aligned inter_hub capability registry index.
2026-06-16 02:39:36 +02:00
# Hub Core
Initial commit
2026-06-16 00:31:20 +00:00
Add hub-core package, docs, and State Hub integration scaffold Extract the first reusable slice (models, schemas, routers, MCP, migrations) from state-hub with INTENT/SCOPE, agent instructions, workplan, and aligned inter_hub capability registry index.
2026-06-16 02:39:36 +02:00
Reusable FastAPI, SQLAlchemy, and MCP primitives for FOS hubs.
feat(ecosystem): hub-core library lane for three-repo stack (HUB-WP-0003) Add slugify_or_default for core-hub parity, bump to 0.2.0, document ecosystem position in INTENT/SCOPE/README, wire capability relations to state-hub and core-hub, and extend utils tests. Part of CUST-WP-0057 consolidation.
2026-07-11 01:26:47 +02:00
## Hub stack glossary
| Name | Role |
| --- | --- |
| **hub-core** | This repo — shared Python library (`hub_core`) |
| **state-hub** | Dev coordination host (workplans, MCP) |
| **core-hub** | Production framework (`/api/v2`, operator console) |
Ecosystem architecture: `/home/worsch/the-custodian/docs/hub-ecosystem-architecture.md`
Add hub-core package, docs, and State Hub integration scaffold Extract the first reusable slice (models, schemas, routers, MCP, migrations) from state-hub with INTENT/SCOPE, agent instructions, workplan, and aligned inter_hub capability registry index.
2026-06-16 02:39:36 +02:00
`hub-core` is being extracted from the standalone State Hub repository as part
of `CUST-WP-0025`. The initial package slice contains only the generic database
models and schemas that can move without importing dev-hub concepts such as
docs: workplan-first agent guidance prose (CUST-WP-0055 T04)
2026-07-08 16:35:51 +02:00
topics, workplans, tasks, decisions, SBOM, or token accounting.
Add hub-core package, docs, and State Hub integration scaffold Extract the first reusable slice (models, schemas, routers, MCP, migrations) from state-hub with INTENT/SCOPE, agent instructions, workplan, and aligned inter_hub capability registry index.
2026-06-16 02:39:36 +02:00
Source boundary notes live in:
```text
/home/worsch/the-custodian/docs/hub-core-extraction-boundary.md
```
## First Slice
- SQLAlchemy base metadata and timestamp helpers.
- Domain and managed-repository registry primitives.
- Agent message inbox primitives.
- Progress-event and capability-request primitives with generic JSON context
fields for hub-specific references.
- Third-party service catalog and snapshot primitives.
- Matching Pydantic schemas for those primitives.
- Generic DoI report and summary schemas used by the MCP DoI tools.
- Router factory functions for domains, repos, messages, policy lookup, and
progress, capability, and TPSC catalog/snapshot/report endpoints.
- Canonical FOS §10 risk and alert event types with `/progress/risks` and
`/progress/alerts` read views.
- Shared utility helpers for slugs, pagination, repo path resolution, and
trailing-slash path normalization.
- Alembic templates plus an initial core-schema migration for hub adopters.
- FastMCP base-server wrapper for generic orientation, messaging, capability,
repo, DoI, TPSC/GDPR, risk/alert, and progress tools.
Domain-specific MCP tools follow in each hub package.
Reference in a new issue Copy permalink