coulomb/fin-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
fin-hub/README.md
tegwick 7e53c21feb Complete fin-hub repo integration (FIN-WP-0000) 
Link the DB-first onboarding workstream to FIN-WP-0000-repo-integration.md,
finish agent orientation (rules stubs, remove first-session), add repo
classification, and close all four custodian onboarding tasks.
2026-07-08 22:39:22 +02:00

1.2 KiB
Raw Blame History

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

MVP complete (CUST-WP-0025 T22–T26): models, CSV ingest, runway CLI, FOS coupling, RaaS packaging draft. Operational hardening tracked in workplans/FIN-WP-0001-runway-operations-lane.md.

Quick Start

cd /home/worsch/fin-hub
uv sync
uv run pytest
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

Cross-hub coupling (--emit) posts non-secret progress events to dev-hub when STATE_HUB_API is reachable.

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