v0.1.9: per-company progress reviews + deck-quality guidance

progress.py reads the whole graded ledger and answers two questions the
per-deck scorecard can't: is the company actually progressing (composite/
BDEF-category/KPI trajectories, recurring vs resolved flags), and is the
material good enough to judge them by — a deterministic gap engine spots
what the decks are NOT showing (no profitability visibility, untargeted
KPIs, no forward guidance, broken forecast chain, silently dropped KPIs,
thin-evidence BDEF categories, no board asks) and renders each gap as a
concrete, paste-ready request for the next deck.

Served live from the ledger (no GPU) at /api/companies/{slug}/progress(.md),
written to /data/ledger/<slug>/PROGRESS.md + /data/reports/latest-progress.md
after each graded deck, and viewable/downloadable from the dashboard company
card ("View progress review"). 18 new tests.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Jonathan Kirkwood
2026-07-31 20:50:41 -05:00
co-authored by Claude Fable 5
parent 506e6c79bd
commit 9b9c7e58c1
8 changed files with 792 additions and 14 deletions
+3 -2
View File
@@ -8,9 +8,10 @@ import { v_0_1_5 } from './v_0_1_5'
import { v_0_1_6 } from './v_0_1_6'
import { v_0_1_7 } from './v_0_1_7'
import { v_0_1_8 } from './v_0_1_8'
import { v_0_1_9 } from './v_0_1_9'
/** The current version MUST be the first argument (`current`). */
export const versions = VersionGraph.of({
current: v_0_1_8,
other: [v_0_1_7, v_0_1_6, v_0_1_5, v_0_1_4, v_0_1_3, v_0_1_2, v_0_1_1, v_0_1_0],
current: v_0_1_9,
other: [v_0_1_8, v_0_1_7, v_0_1_6, v_0_1_5, v_0_1_4, v_0_1_3, v_0_1_2, v_0_1_1, v_0_1_0],
})
+20
View File
@@ -0,0 +1,20 @@
import { VersionInfo } from '@start9labs/start-sdk'
/** Progress reviews + deck-quality guidance. ExVer form `<upstream>:<downstream>`. */
export const v_0_1_9 = VersionInfo.of({
version: '0.1.9:0',
releaseNotes:
'Per-company progress reviews: a new PROGRESS.md (and "View progress ' +
'review" on the dashboard company card) reads the whole graded ledger and ' +
'reports the trajectory — composite trend with per-deck deltas, which BDEF ' +
'categories and KPIs are improving or declining, and which red flags are ' +
'recurring, new, or resolved. It also grades the material itself: a ' +
'deterministic gap engine spots what the decks are NOT showing (no ' +
'profitability visibility, KPIs without targets, no forward guidance, a ' +
'broken forecast chain, silently dropped KPIs, BDEF categories scored on ' +
'thin evidence, no board asks) and turns every gap into a concrete, ' +
'paste-ready request list for the next deck. Served live from the ledger ' +
'at /api/companies/{slug}/progress(.md) — no GPU needed — and written to ' +
'/data/ledger/<company>/PROGRESS.md after each grading run.',
migrations: {},
})