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 ac0949afd0
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 1s
Details
feat: join audit-storage usage without inventing a booked Scaleway fact 
Ingest resource-control's August technical usage, omit nulls, and
reconcile forecast + usage + booked facts. Commissioning month reports
missing_booked_fact instead of 0.00. T05 still waits on the first invoice.
2026-08-15 20:32:55 +02:00

2 KiB
Raw Permalink 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
uv run finhub import-ai-plan tests/fixtures/ai-plans.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 import ai-plan tests/fixtures/ai-plans.csv
uv run finhub ledger ingest-usage --resource resource:platform:audit-storage --source resource-control:data/actuals/2026-08.json tests/fixtures/platform-audit-storage-usage-2026-08.json
uv run finhub ledger reconcile-resource --resource resource:platform:audit-storage --period 2026-08
uv run finhub ledger commitments
uv run finhub ledger set-entitlement --provider anthropic --plan claude-max --period 2026-08 --unit plan --plan-label "Max 20x" --source vendor-plan
uv run finhub ledger plan-month --period 2026-08
uv run finhub ledger ingest-session-tokens tests/fixtures/session-tokens-2026-08.json
uv run finhub ledger session-tokens --period 2026-08
uv run finhub ledger allocate-plan --fact FACT --method measured_token_share
uv run finhub ledger plan-allocations
uv run finhub ledger effectiveness --period 2026-08
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

# HTTP read API
uv run finhub serve
# GET http://127.0.0.1:8080/runway/summary
# GET http://127.0.0.1:8080/runway/monthly-burn

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