Files
blackroad-os-archive/covers/blackroad-os-core.cover.md
2025-11-24 04:32:13 -06:00

1.7 KiB
Raw Blame History

id, title, type, status, timeframe, primary_repo, linked_repos, summary, why_it_matters, risk_if_lost, recommended_action
id title type status timeframe primary_repo linked_repos summary why_it_matters risk_if_lost recommended_action
blackroad-os-core BlackRoad OS Core repo active 2023- blackroad-os-core
blackroad-os-api
blackroad-os-operator
blackroad-os-infra
Core substrate for orchestrating services, identity, and platform runtime across the constellation. Anchor for platform primitives, routing, and shared libraries that other repos depend on. Core service graph and shared contracts would fragment, slowing every other repo. keep-live

BlackRoad OS Core Archive Cover Sheet

Narrative

BlackRoad OS Core holds the foundational runtime, shared contracts, and base services that knit together the constellation. It provides stable libraries, identity primitives, and platform APIs used by every pack and edge surface.

History

The repo emerged as the convergence point for early BlackRoad services when separate prototypes needed common auth, logging, and configuration. It replaced ad-hoc glue with maintained modules and deployment conventions.

Current Role

Today the core repo anchors platform dependencies and publishes reusable packages consumed by the API layer, operator pipelines, and packs. It acts as the canonical source for base images and common schema definitions.

Dependencies

  • Relies on blackroad-os-operator for deployment workflows.
  • Publishes interfaces consumed by blackroad-os-api and blackroad-os-web.
  • Shares infrastructure modules with blackroad-os-infra.

Migration / Future

Continue hardening shared modules, keep release cadence aligned with operator rollouts, and prepare migration guides for any breaking changes so packs can update smoothly.