2026-07-08 00:50:24 +02:00
|
|
|
|
# Fin Hub
|
|
|
|
|
|
|
|
|
|
|
|
Resource viability hub for the FOS federation — budgets, commitments, burn rate,
|
|
|
|
|
|
runway projection, and token spend tracking.
|
|
|
|
|
|
|
|
|
|
|
|
Fin-hub extends `hub-core` with financial models and read surfaces. Generic hub
|
|
|
|
|
|
primitives (domains, repos, messages, progress events) come from hub-core;
|
|
|
|
|
|
fin-specific models (budget, commitment, burn rate, runway, token spend) live
|
|
|
|
|
|
here.
|
|
|
|
|
|
|
|
|
|
|
|
## Status
|
|
|
|
|
|
|
|
|
|
|
|
Bootstrap scaffold (`CUST-WP-0025-T22`). Models and ingestion pipelines are
|
|
|
|
|
|
tracked in `CUST-WP-0025-T23`–`T24`.
|
|
|
|
|
|
|
|
|
|
|
|
## Quick Start
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
cd /home/worsch/fin-hub
|
|
|
|
|
|
uv sync
|
|
|
|
|
|
uv run pytest
|
2026-07-08 00:59:39 +02:00
|
|
|
|
uv run finhub runway --balance 12000 --monthly-burn 2100,2200,2000
|
|
|
|
|
|
uv run finhub import-cloud tests/fixtures/cloud-costs.csv
|
|
|
|
|
|
uv run finhub ops-costs tests/fixtures/hosteurope.csv
|
2026-07-08 00:50:24 +02:00
|
|
|
|
```
|
|
|
|
|
|
|
2026-07-08 00:59:39 +02:00
|
|
|
|
Cross-hub coupling (`--emit`) posts non-secret progress events to dev-hub when
|
|
|
|
|
|
`STATE_HUB_API` is reachable.
|
|
|
|
|
|
|
2026-07-08 00:50:24 +02:00
|
|
|
|
## Related Workplans
|
|
|
|
|
|
|
|
|
|
|
|
- `the-custodian/workplans/CUST-WP-0025-fos-hub-bootstrap.md` — umbrella
|
|
|
|
|
|
- `canon/constitution/bootstrap-protocol_v0.1.md` — funding and roles
|
|
|
|
|
|
- `canon/projects/railiance/business-model-canvas_v0.1.md` — monetization path
|
