fin-hub/workplans/FIN-WP-0001-runway-operations-lane.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

2.5 KiB

id type title domain repo status owner topic_slug created updated state_hub_workstream_id
FIN-WP-0001 workplan Runway Operations and Federation Evidence infotech fin-hub active fin-hub infotech 2026-07-08 2026-07-08 f628b9bf-9784-4d68-9a42-62c9e93485c4

FIN-WP-0001 — Runway Operations and Federation Evidence

Post-MVP lane: turn the fin-hub scaffold (CSV ingest, runway calculator, FOS coupling) into repeatable operational evidence for internal dogfood and the RaaS managed-tier runway add-on.

Context

CUST-WP-0025 delivered the fin-hub MVP (models, CSV parsers, CLI, fin→dev and fin→canon coupling, RaaS packaging draft). This workplan covers the next strand: persistent cost ledger, scheduled runway evaluation, and documented federation evidence.

Complete agent orientation stubs

id: FIN-WP-0001-T01
status: done
priority: high
state_hub_task_id: "76b9e17c-405b-46d7-be57-17f991e69b70"

Fill .claude/rules/repo-identity.md, stack-and-commands.md, architecture.md, and repo-boundary.md. Remove first-session.md import from CLAUDE.md once past first session.

Add repo classification

id: FIN-WP-0001-T02
status: done
priority: high
state_hub_task_id: "902633ce-c713-47b8-b1c2-9a5725027ffa"

Commit .repo-classification.yaml and register via state-hub classification spine (resolves C-24).

Persistent cost ledger

id: FIN-WP-0001-T03
status: done
priority: high
state_hub_task_id: "9350d324-6194-44d5-9923-3547d69a2eed"

Add SQLite-backed storage for ingested cost rows with monthly rollup queries. CLI subcommands: ledger import, ledger summary.

Scheduled runway evaluation

id: FIN-WP-0001-T04
status: done
priority: medium
state_hub_task_id: "9574806e-e414-421d-8b58-844ccc9e6af7"

Script or CLI entrypoint that loads ledger balance, computes runway, and emits fin→dev / fin→canon signals when STATE_HUB_API is reachable. Suitable for cron or systemd timer.

Dogfood evidence bundle

id: FIN-WP-0001-T05
status: done
priority: medium
state_hub_task_id: "0b3b5e95-8c72-4e70-9171-14ef23c9e969"

Produce a non-secret runway report artefact under docs/evidence/ using fixture CSVs plus live ledger data. Reference from docs/raas-mvp-packaging.md.

HTTP read surface (optional)

id: FIN-WP-0001-T06
status: wait
priority: low
state_hub_task_id: "40e46ee1-49ee-4c3f-ab6b-9471ea1ab3d9"

Expose runway summary and monthly burn via a minimal FastAPI router (hub-core pattern). Deferred until ledger and scheduled evaluation are stable.