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

100 lines
No EOL
2.5 KiB
Markdown

---
id: FIN-WP-0001
type: workplan
title: "Runway Operations and Federation Evidence"
domain: infotech
repo: fin-hub
status: active
owner: fin-hub
topic_slug: infotech
created: "2026-07-08"
updated: "2026-07-08"
state_hub_workstream_id: "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
```task
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
```task
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
```task
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
```task
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
```task
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)
```task
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.