coulomb/hub-core
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A library boundary between shared hub infrastructure and host-specific hub implementations.
19 commits 1 branch 0 tags 845 KiB
Find a file
tegwick c804f06b67
All checks were successful
CI Smoke / host-smoke (push) Successful in 1s
Details
CI Smoke / container-smoke (push) Successful in 4s
Details
Add optional legacy workstream_id metering hook to progress router 
create_progress_router accepts meter_legacy_workstream_id so host apps
like state-hub can record Deprecation usage when callers filter progress
events with the legacy query param.
2026-07-08 22:29:21 +02:00
.claude/rules docs: workplan-first agent guidance prose (CUST-WP-0055 T04) 2026-07-08 16:35:51 +02:00
.forgejo/workflows Add Forgejo CI smoke workflow (enablement template) 2026-07-06 12:33:03 +02:00
hub_core Add optional legacy workstream_id metering hook to progress router 2026-07-08 22:29:21 +02:00
registry Draft capability entry (reuse-surface REUSE-WP-0017-T04, cohort 1) 2026-07-06 19:03:42 +02:00
tests feat(capabilities): add write router factory and MCP composition (HUB-WP-0002) 2026-06-22 19:52:22 +02:00
workplans feat(capabilities): add write router factory and MCP composition (HUB-WP-0002) 2026-06-22 19:52:22 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-06-22 19:52:37 +02:00
.gitignore Initial commit 2026-06-16 00:31:20 +00:00
.repo-classification.yaml Mark .repo-classification.yaml human-reviewed (CUST-WP-0050 T02) 2026-06-22 11:40:43 +02:00
AGENTS.md Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) 2026-07-08 14:50:24 +02:00
CLAUDE.md Regenerate agent instruction files for dev-hub MCP name 2026-06-22 21:24:35 +02:00
INTENT.md docs: workplan-first agent guidance prose (CUST-WP-0055 T04) 2026-07-08 16:35:51 +02:00
LICENSE Initial commit 2026-06-16 00:31:20 +00:00
pyproject.toml Add hub-core package, docs, and State Hub integration scaffold 2026-06-16 02:39:36 +02:00
README.md docs: workplan-first agent guidance prose (CUST-WP-0055 T04) 2026-07-08 16:35:51 +02:00
SCOPE.md docs: workplan-first agent guidance prose (CUST-WP-0055 T04) 2026-07-08 16:35:51 +02:00

README.md

Hub Core

Reusable FastAPI, SQLAlchemy, and MCP primitives for FOS hubs.

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 topics, workplans, tasks, decisions, SBOM, or token accounting.

Source boundary notes live in:

/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.