coulomb/fin-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
fin-hub/.claude/rules/stack-and-commands.md
tegwick 277c2d05ca Implement FIN-WP-0001 ledger, evaluate, and evidence lane (T03–T05) 
Add SQLite-backed cost ledger with import/summary CLI, cron-friendly
evaluate command with federation emit, and dogfood evidence artefact
generation from fixture CSVs.
2026-07-08 22:44:07 +02:00

998 B
Raw Blame History

Stack

  • Language: Python 3.12+
  • Package manager: uv
  • Key deps: hub-core (generic hub primitives), pydantic, httpx

Dev Commands

# Install dependencies
uv sync

# Run tests
uv run pytest

# CLI — runway projection
uv run finhub runway --balance 12000 --monthly-burn 2100,2200,2000

# CLI — import cost CSVs
uv run finhub import-cloud tests/fixtures/cloud-costs.csv
uv run finhub import-anthropic tests/fixtures/anthropic-billing.csv
uv run finhub import-hosteurope tests/fixtures/hosteurope.csv

# CLI — ledger (SQLite at .fin-hub/ledger.db)
uv run finhub ledger set-balance 12000
uv run finhub ledger import cloud tests/fixtures/cloud-costs.csv
uv run finhub ledger summary

# CLI — scheduled evaluation (cron/systemd friendly)
uv run finhub evaluate --emit

# CLI — dogfood evidence artefact
uv run finhub evidence --seed-fixtures

# CLI — emit cross-hub signals (requires STATE_HUB_API)
uv run finhub runway --balance 12000 --monthly-burn 2100 --emit