From 8a376431bd47b9925805eb06c6ac99aa21d12c93 Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 6 Jul 2026 19:03:42 +0200 Subject: [PATCH] Draft capability entry (reuse-surface REUSE-WP-0017-T04, cohort 1) Honest first-pass maturity vector grounded in README/docs/tests present in this repo; no invented evidence. Flagged for human review before publish. See reuse-surface history/2026-07-06-coverage-classification.md. Co-Authored-By: Claude Sonnet 5 --- .../capability.infotech.hub-core-library.md | 126 ++++++++++++++++++ registry/indexes/capabilities.yaml | 20 ++- 2 files changed, 144 insertions(+), 2 deletions(-) create mode 100644 registry/capabilities/capability.infotech.hub-core-library.md diff --git a/registry/capabilities/capability.infotech.hub-core-library.md b/registry/capabilities/capability.infotech.hub-core-library.md new file mode 100644 index 0000000..842be90 --- /dev/null +++ b/registry/capabilities/capability.infotech.hub-core-library.md @@ -0,0 +1,126 @@ +--- +id: capability.infotech.hub-core-library +name: Reusable FOS Hub Core Primitives +summary: Reusable FastAPI, SQLAlchemy, and MCP primitives extracted from the State Hub for use by other + FOS (Federation of Services) hubs. +owner: hub-core +status: draft +domain: infotech +tags: +- hub +- fastapi +- sqlalchemy +- mcp +maturity: + discovery: + current: D2 + target: D4 + confidence: medium + rationale: 'README documents the extraction boundary from State Hub (CUST-WP-0025) and the first slice: + base metadata, domain/repo registry primitives, agent inbox, progress-event/capability-request primitives, + service catalog, DoI schemas.' + availability: + current: A1 + target: A3 + confidence: medium + rationale: Python package (`hub-core`), pip-installable/importable; already has a `.forgejo/workflows/ci-smoke.yaml` + CI check (ahead of most siblings on the Forgejo transition). +external_evidence: + completeness: + level: C1 + confidence: low + basis: scope_vs_intent_and_consumer_expectations + satisfied_expectations: + - SQLAlchemy base metadata/timestamp helpers + - domain and managed-repo registry primitives + - agent message inbox primitives + - progress-event/capability-request primitives + - Forgejo Actions CI smoke check + broken_expectations: [] + out_of_scope_expectations: [] + reliability: + level: R1 + confidence: low + basis: consumer_quality_signals + known_reliability_risks: + - first extraction slice only; hub-specific concepts (topics, workstreams, tasks, decisions, SBOM, + token accounting) intentionally excluded so far +discovery: + intent: Let new FOS hubs reuse the generic primitives State Hub already built, without importing State-Hub-specific + domain concepts. + includes: + - SQLAlchemy base metadata/timestamp helpers + - domain/repo registry and agent-inbox primitives + - progress-event/capability-request primitives with generic JSON context + - service catalog and DoI schemas + excludes: + - 'State-Hub-specific concepts: topics, workstreams, tasks, decisions, SBOM, token accounting' + assumptions: [] + use_cases: [] + research_memos: [] +availability: + current_level: A1 + target_level: A3 + current_artifacts: + - '`hub-core` Python package' + target_artifacts: [] + consumption_modes: + - library import +relations: + depends_on: [] + supports: [] + related_to: [] +evidence: + documentation: + - README.md + - the-custodian:docs/hub-core-extraction-boundary.md + tests: + - tests/ + - .forgejo/workflows/ci-smoke.yaml + consumer_feedback: [] + bug_reports: [] + incidents: [] +consumer_guidance: + recommended_for: + - new FOS hub services wanting shared FastAPI/SQLAlchemy/MCP primitives + not_recommended_for: + - consumers needing State-Hub-specific domain concepts (not extracted yet) + known_limitations: + - first extraction slice; boundary still evolving alongside State Hub +promotion_history: [] +--- + +# Reusable FOS Hub Core Primitives + +## Overview + +`hub-core` is being extracted from the standalone State Hub repository (CUST-WP-0025) to give other FOS hubs reusable FastAPI/SQLAlchemy/MCP primitives without pulling in State-Hub-specific domain concepts. + +## Assessment notes + +### Discovery + +README documents the extraction boundary from State Hub (CUST-WP-0025) and the first slice: base metadata, domain/repo registry primitives, agent inbox, progress-event/capability-request primitives, service catalog, DoI schemas. + +### Availability + +Python package (`hub-core`), pip-installable/importable; already has a `.forgejo/workflows/ci-smoke.yaml` CI check (ahead of most siblings on the Forgejo transition). + +### Completeness + +First-pass honest assessment from the REUSE-WP-0017 coverage campaign +(reuse-surface). No external consumer feedback exists yet; levels reflect +scope-vs-intent documentation quality, not internal code quality. + +### Reliability + +No production consumer telemetry exists yet; reliability level is +intentionally conservative pending REUSE-WP-0019 reuse-telemetry evidence. + +## Promotion checklist + +- [x] ID follows `capability..` pattern +- [x] Maturity enums match `specs/CapabilityMaturityStandard.md` +- [x] `external_evidence` is populated separately from `maturity` +- [ ] Relations reference valid capability IDs (none yet) +- [x] Index entry added in `registry/indexes/capabilities.yaml` diff --git a/registry/indexes/capabilities.yaml b/registry/indexes/capabilities.yaml index b4f581b..433d107 100644 --- a/registry/indexes/capabilities.yaml +++ b/registry/indexes/capabilities.yaml @@ -1,4 +1,20 @@ version: 1 -updated: '2026-06-16' +updated: '2026-07-06' domain: inter_hub -capabilities: [] +capabilities: +- id: capability.infotech.hub-core-library + name: Reusable FOS Hub Core Primitives + summary: Reusable FastAPI, SQLAlchemy, and MCP primitives extracted from the State Hub for use by other + FOS (Federation of Services) hubs. + vector: D2 / A1 / C1 / R1 + domain: infotech + status: draft + owner: hub-core + path: registry/capabilities/capability.infotech.hub-core-library.md + tags: + - hub + - fastapi + - sqlalchemy + - mcp + consumption_modes: + - library import