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

54 lines
2 KiB
Markdown
Raw Normal View History

Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) Sync AGENTS.md, CLAUDE.md, and .claude/rules from updated project_rules templates: workplan-first session protocol, legacy terminology footnote, and GET /workplans/ examples.
2026-07-08 14:50:21 +02:00
## Stack
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
- **Language:** Python 3.12+
- **Package manager:** uv
- **Key deps:** hub-core (generic hub primitives), pydantic, httpx
Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) Sync AGENTS.md, CLAUDE.md, and .claude/rules from updated project_rules templates: workplan-first session protocol, legacy terminology footnote, and GET /workplans/ examples.
2026-07-08 14:50:21 +02:00
## Dev Commands
```bash
# Install dependencies
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
uv sync
Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) Sync AGENTS.md, CLAUDE.md, and .claude/rules from updated project_rules templates: workplan-first session protocol, legacy terminology footnote, and GET /workplans/ examples.
2026-07-08 14:50:21 +02:00
# Run tests
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
uv run pytest
# CLI — runway projection
uv run finhub runway --balance 12000 --monthly-burn 2100,2200,2000
Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) Sync AGENTS.md, CLAUDE.md, and .claude/rules from updated project_rules templates: workplan-first session protocol, legacy terminology footnote, and GET /workplans/ examples.
2026-07-08 14:50:21 +02:00
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
# 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
feat: book monthly AI-plan invoices as facts and commitments Add ai-plan ingest that stores one current booked fact per provider-account × plan × period. Subscriptions become recurring commitments; usage top-ups do not. Session-level rows are rejected.
2026-08-15 19:09:14 +02:00
uv run finhub import-ai-plan tests/fixtures/ai-plans.csv
Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) Sync AGENTS.md, CLAUDE.md, and .claude/rules from updated project_rules templates: workplan-first session protocol, legacy terminology footnote, and GET /workplans/ examples.
2026-07-08 14:50:21 +02:00
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
# 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
feat: book monthly AI-plan invoices as facts and commitments Add ai-plan ingest that stores one current booked fact per provider-account × plan × period. Subscriptions become recurring commitments; usage top-ups do not. Session-level rows are rejected.
2026-08-15 19:09:14 +02:00
uv run finhub ledger import ai-plan tests/fixtures/ai-plans.csv
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
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
feat: book monthly AI-plan invoices as facts and commitments Add ai-plan ingest that stores one current booked fact per provider-account × plan × period. Subscriptions become recurring commitments; usage top-ups do not. Session-level rows are rejected.
2026-08-15 19:09:14 +02:00
uv run finhub ledger commitments
feat: record AI-plan entitlements without inventing token ceilings Add append-only plan entitlements (token, multiplier, or named plan). Unknown capacity stays unknown and requires a plan label. Plan-month reporting joins booked euros to entitlement without session logs.
2026-08-15 19:15:29 +02:00
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
feat: ingest State Hub session tokens without booking them Store mixed measured/estimated/superseded aggregates as session-token evidence. Map kinds onto the evidence-basis vocabulary, keep unknown months unknown, and refuse to post the snapshot as booked spend or resource-control usage.
2026-08-15 19:21:41 +02:00
uv run finhub ledger ingest-session-tokens tests/fixtures/session-tokens-2026-08.json
uv run finhub ledger session-tokens --period 2026-08
feat: reporting-allocate AI-plan cost across work Split a booked AI-plan fact across workplans or repos using measured tokens, measured+estimated tokens, session counts, or an even split. Unmeasured remainder stays a residual. The record is not resource-control AllocationEvidence and does not create booked spend.
2026-08-15 19:35:43 +02:00
uv run finhub ledger allocate-plan --fact FACT --method measured_token_share
uv run finhub ledger plan-allocations
feat: publish unblended AI-plan effectiveness series Report booked cost, entitlement, token coverage, and work as three series: work per measured token, work per measured+estimated token, and work per euro. Months below 50% coverage are unfit for token trends. There is no blended efficiency number.
2026-08-15 19:53:28 +02:00
uv run finhub ledger effectiveness --period 2026-08
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
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
Implement FIN-WP-0001-T06 HTTP runway read surface Add create_runway_router() following the hub-core factory pattern, expose GET /runway/summary and /runway/monthly-burn via create_app, and add finhub serve for local operation.
2026-07-08 22:46:24 +02:00
# 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
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
# CLI — emit cross-hub signals (requires STATE_HUB_API)
uv run finhub runway --balance 12000 --monthly-burn 2100 --emit
```
Reference in a new issue Copy permalink