---
id: FIN-WP-0001
type: workplan
title: "Runway Operations and Federation Evidence"
domain: infotech
repo: fin-hub
status: finished
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: done
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.