generated from coulomb/repo-seed
75 lines
2.2 KiB
Markdown
75 lines
2.2 KiB
Markdown
# Railiance Fabric
|
|
|
|
Railiance Fabric defines the repo-owned declaration model for the Railiance
|
|
ecosystem graph.
|
|
|
|
It will hold schemas, seed declarations, validation tools, graph queries, and
|
|
State Hub export contracts for services, capabilities, interfaces,
|
|
dependencies, and bindings across Railiance repositories.
|
|
|
|
## Validate Declarations
|
|
|
|
From a checkout with the Python dependencies installed:
|
|
|
|
```bash
|
|
railiance-fabric validate .
|
|
```
|
|
|
|
During early bootstrapping, the local module entry point works too:
|
|
|
|
```bash
|
|
PYTHONPATH=. python -m railiance_fabric.cli validate .
|
|
```
|
|
|
|
The validator loads `fabric/` declarations, checks schema conformance, verifies
|
|
catalog type names, catches missing references/providers, checks active
|
|
production dependency source links, and warns about dependency cycles.
|
|
|
|
## Query The Graph
|
|
|
|
```bash
|
|
railiance-fabric providers runtime-secrets
|
|
railiance-fabric consumers railiance-platform.openbao.kv-v2
|
|
railiance-fabric dependency-path flex-auth.api
|
|
railiance-fabric unresolved
|
|
railiance-fabric blast-radius openbao-kv-v2-mount
|
|
railiance-fabric export --format json
|
|
railiance-fabric export --format mermaid
|
|
```
|
|
|
|
See `docs/discovery-queries.md` for command details.
|
|
|
|
## Adopt In Another Repo
|
|
|
|
See `docs/adoption-guide.md` for the declaration workflow and
|
|
`docs/first-rollout.md` for the initial Railiance repo rollout.
|
|
|
|
## Next: Ecosystem Registry Service
|
|
|
|
See `docs/ecosystem-registry-service.md` for the standards comparison and
|
|
service direction for registering repos and interacting with the combined
|
|
ecosystem model.
|
|
|
|
Start the first registry service slice with:
|
|
|
|
```bash
|
|
railiance-fabric-registry --db .railiance-fabric/registry.sqlite3 --port 8765
|
|
```
|
|
|
|
The initial service exposes repository registration, graph snapshot ingestion,
|
|
artifact attachment, graph query endpoints, State Hub export, and early
|
|
Backstage/xRegistry projection endpoints. It stores snapshots in SQLite and
|
|
reuses the Fabric graph export shape.
|
|
|
|
Feed the running service from this checkout:
|
|
|
|
```bash
|
|
railiance-fabric registry sync --repo-slug railiance-fabric .
|
|
```
|
|
|
|
Ingest a CycloneDX SBOM as queryable library inventory:
|
|
|
|
```bash
|
|
railiance-fabric registry ingest-cyclonedx bom.json --repo-slug railiance-fabric
|
|
```
|