blackroad-os/blackroad-operating-system
9
0
Fork 0
mirror of https://github.com/blackboxprogramming/BlackRoad-Operating-System.git synced 2026-03-17 04:57:15 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
140156999398a700cd74657a89b05e1e1d045cbb
blackroad-operating-system/docs/OS_SPEC.md
Alexa Amundson d65f41b42f Add OS spec, unification guide, and meta tooling
2025-11-20 12:32:56 -06:00

861 B
Raw Blame History

BlackRoad OS Spec

This repository holds the canonical service registry for BlackRoad OS. The machine-readable source of truth lives in os-spec/os-spec.json and is designed to be imported by automation, dashboards, and deployment tooling.

Fields

Each entry under services defines one OS component with the following fields:

  • key: Stable identifier used by tooling.
  • name: Human-readable service name.
  • repoUrl: Canonical GitHub repository for the service.
  • railwayUrl: Production Railway hostname for runtime health checks.
  • cloudflareSubdomain: Public DNS entry managed through Cloudflare.
  • healthPath: Path segment appended to the base URL for health monitoring.

New services should extend the JSON file using the same shape so that dashboards and scripts can discover them automatically.

Reference in New Issue View Git Blame Copy Permalink