36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
---
|
||
id: blackroad-os-core
|
||
title: BlackRoad OS Core
|
||
type: repo
|
||
status: active
|
||
timeframe: 2023-
|
||
primary_repo: blackroad-os-core
|
||
linked_repos:
|
||
- blackroad-os-api
|
||
- blackroad-os-operator
|
||
- blackroad-os-infra
|
||
summary: Core substrate for orchestrating services, identity, and platform runtime across the constellation.
|
||
why_it_matters: Anchor for platform primitives, routing, and shared libraries that other repos depend on.
|
||
risk_if_lost: Core service graph and shared contracts would fragment, slowing every other repo.
|
||
recommended_action: 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.
|