coulomb/fin-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Resource viability hub for budgets, commitments, burn rate, runway projection, and token spend tracking.
9 commits 1 branch 0 tags 769 KiB
Find a file
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
.claude/rules Complete fin-hub repo integration (FIN-WP-0000) 2026-07-08 22:39:22 +02:00
.forgejo/workflows Add Forgejo CI smoke workflow (enablement template) 2026-07-08 12:43:08 +02:00
docs Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
src/fin_hub Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
tests Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
workplans Complete fin-hub repo integration (FIN-WP-0000) 2026-07-08 22:39:22 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-07-08 22:38:11 +02:00
.gitignore Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00
.repo-classification.yaml Complete fin-hub repo integration (FIN-WP-0000) 2026-07-08 22:39:22 +02:00
AGENTS.md docs: workplan-first agent guidance prose (CUST-WP-0055 T04 batch 4) 2026-07-08 17:22:15 +02:00
CLAUDE.md Complete fin-hub repo integration (FIN-WP-0000) 2026-07-08 22:39:22 +02:00
INTENT.md Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00
pyproject.toml Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
README.md Complete fin-hub repo integration (FIN-WP-0000) 2026-07-08 22:39:22 +02:00
SCOPE.md Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00
uv.lock Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00

README.md

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