feat: let operators request a pending lineage reconstruction (v0.85.0)

.github/workflows/tests.yml

@@ -4,7 +4,6 @@ on:
   push:
     branches: [main]
   pull_request:
-    branches: [main]
 
 permissions:
   contents: read

ARCHITECTURE.md

@@ -475,15 +475,19 @@ labeled detail (cutoff, requested date, counts, status history)
 without exposing a DSN or raw record. Status history is detail-only
 and uses lookup labels plus occurrence times; a failure event keeps
 its machine `failure_code` rather than an invented caption. Failed
-list rows add a next-action line (open the run, then connect the
+TEPP list rows add a next-action line (open the run, then connect the
 measurement service) so `tepp_not_available` is not mistaken for a
-calibrated negative result. The
+calibrated negative result. A failed lineage row tells the operator
+to retry reconstruction, not to connect TEPP. The
 payload is lookup labels plus non-negative aggregate counts -- never
 source SQL, a DSN, a raw record, or a provider body. After `make seed`,
 Demo Analyst and Demo Admin see "Lineage reconstruction · Succeeded ·
 Demo Corp" with "3 documents" and Pending / Running / Succeeded times,
 and "TEPP measurement · Failed · Demo Corp" whose detail history ends
 in Failed / `tepp_not_available`.
+`POST /api/analysis-runs` records a new Pending lineage run on that
+same captured snapshot (ADR 0017). Open Analysis runs, then click
+Request lineage reconstruction. TEPP stays a wire client.
 
 ## Phase 6a: fast-mlsirm dependency + Rust toolchain (infra only)
 

CHANGELOG.d/0.84.0-tepp-analysis-run.md

@@ -1,6 +1,6 @@
 # 0.84.0 TEPP analysis-run seed
 
 Seed writes `analysis_run_tepp` via `tepp_client` on the shared Demo
-Corp snapshot. The home list shows Failed and the next action; detail
-history keeps `tepp_not_available`. Missing transport is not a fake
-measurement.
+Corp snapshot. The home list shows Failed and a kind-specific next
+action; detail history keeps `tepp_not_available`. Missing transport
+is not a fake measurement. A failed lineage row does not mention TEPP.

CHANGELOG.d/0.85.0-analysis-run-write.md

@@ -0,0 +1,8 @@
+# 0.85.0 Analysis-run write
+
+`POST /api/analysis-runs` records a pending lineage reconstruction on a
+snapshot already bound to the caller's corporate entity (ADR 0017). The
+home page button is Request lineage reconstruction. TEPP and period-report
+kinds are rejected so this path cannot invent a measurement. A failed
+period-report row points at the Reports panel. A pending TEPP corpus hint
+does not say the run already measured.

CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.85.0] - 2026-08-16
+
+### Added
+
+- `POST /api/analysis-runs` records a pending lineage reconstruction on
+  a snapshot already bound to the caller's corporate entity (ADR 0017).
+  Open Analysis runs, then click **Request lineage reconstruction**.
+  The same account/key replays; a drifted cutoff is 409. TEPP and
+  period-report kinds are rejected so this path cannot invent a
+  measurement. A missing snapshot tells the operator to ask an
+  administrator to capture one.
+
+### Fixed
+
+- A pending or running TEPP corpus hint no longer says the run already
+  measured. A failed period-report row tells the operator to rebuild
+  from the Reports panel.
+
 ## [0.84.0] - 2026-08-16
 
 ### Added
@@ -16,7 +34,9 @@ All notable changes to this project are documented here. Format follows
   keeps `tepp_not_available` -- never a fabricated theta. TEPP stays
   a wire client, not a local psychometric engine. `make seed` skips
   snapshot-count inserts once counts exist so a re-run does not hit
-  the freeze trigger.
+  the freeze trigger. A failed lineage row tells the operator to retry
+  reconstruction; only a failed TEPP row mentions the measurement
+  service. Stacked PRs now run the same GitHub Checks as PRs to main.
 
 ## [0.83.0] - 2026-08-16
 

CLAUDE.md

@@ -3,12 +3,15 @@
 Tool-specific pointer. Policy lives in [AGENTS.md](AGENTS.md) and the
 ADRs under `docs/adr/`. Do not fork those rules here.
 
-## Analysis-run seed (v0.84.0)
+## Analysis-run seed (v0.85.0)
 
 `make seed` writes a Demo Corp lineage run and a TEPP run on the same
 snapshot (ADR 0013). The TEPP path goes through `tepp_client`. A missing
 transport or an unused accepted envelope is Failed
 (`tepp_not_available` / `tepp_result_not_persisted`). Do not invent a
 theta or a local psychometric substitute. The home list caption stays
 `kind · status · entity`; the machine failure code is detail-only
-(ADR 0014). Open the Failed row, then connect a live TEPP transport.
+(ADR 0014). Open a Failed TEPP row, then connect a live TEPP
+transport. A failed lineage row retries reconstruction -- it does not
+mention TEPP. `POST /api/analysis-runs` records Pending lineage only
+(ADR 0017); it does not invent a TEPP theta.