O8E Report 08 — F1 / F2 residual matrix (G8)

• macro: v0.6-o8e-pre-production-hardening-bundle
• date_utc: 2026-05-21 · host: Contabo vmi3080463
• gate covered: G8 — F1 / F2 residual gap matrix
• result: G8 PASS — residuals classified with exact next actions

Status legend: CLOSED / PARTIAL / OPEN.

F1 — full ProductionLiveExecutionAdapter method bodies end-to-end

status: PARTIAL  (unchanged since O8D — correctly gated)
closed_already:
  - psycopg2→psycopg3 residue CLOSED — Psycopg2ConnectionShim shipped in
    live_execution.py and real-DB-proven (O8D PROOF-3/5); re-imported OK in O8E.
  - connection_provider seam proven to reach the live directus DB as
    cutter_exec/cutter_verify (O8C PROOF-4).
  - cut_leg_a's exact fn_iu_create SQL contract proven real-DB rollback-only
    (O8C/O8D — 158→159→ROLLBACK).
  - all 6 adapter methods verified to refuse before any DB connect while the
    kill-switch is OFF (O8E G1 proof + 412/412 tests).
residue:
  - the adapter METHOD BODIES (cut_leg_a / leg_b_record / write_verify /
    lifecycle_enact) executing end-to-end AS METHODS vs. the live DB — still
    gated by the kill-switch first line; needs the GAP7 sovereign flip.
  - leg_b_record / write_verify ship the txn-owning SEAM only; their concrete
    governance_writer / verify_writer collaborators are the F3 deliverable
    (Report 05) — the default collaborators fail closed.
next_action:
  at the first sovereign-gated run (post-GAP7), exercise the full adapter
  method bodies in a rollback-only transaction FIRST, with
  connection_provider = lambda role: Psycopg2ConnectionShim(
      psycopg2.connect(**cutter_<role>_kwargs)).
needs_mac_source_patch: NO for the shim/seam; YES for the F3 writers (Report 09).
blocks_first_run: YES — method bodies need the GAP7 flip + F3 writers.

F2 — cutplan body/title content enrichment

status: PARTIAL  (contract CLOSED by O8D; live-text residual OPEN)
closed_already:
  - CutplanRow / MarkRow carry body/title/owner_ref/parent_ref (O8D P3).
  - the cutplan phase serialises body/title/owner_ref/parent_ref into the
    cutplan_rows pin.
  - cut_leg_a's pre-flight guard checks body + title + unit_kind + section_type
    and fails fast (StopInvariantFailed) before any DB connect — verified in
    O8E by reading live_execution.py:326-336.
  - an F2-enriched CutplanRow drove fn_iu_create to status='created' real-DB
    rollback-only (O8D PROOF-4/5).
residue:
  - the LIVE discoverer (LiveDryRunDiscoverer._shadow_mark_rows) still carries
    deterministic PLACEHOLDER body/title labelled 'O4-DRYRUN-SHADOW'. Sourcing
    the REAL document body/title from the live information_unit / source text
    is not yet wired.
next_action:
  wire LiveReadOnlyDiscoverer / LiveDryRunDiscoverer to source the actual unit
  body/title from the live source text (replace the placeholder); then real-DB
  rollback-only-prove a multi-row cut from genuine content.
needs_mac_source_patch: YES — localised to discover.py (Report 09).
blocks_first_run: YES — a real cut needs real body/title text.

Roll-up

Item	O8D	O8E	Needs Mac patch?	Blocks first run?
F1 method bodies	PARTIAL	PARTIAL	F3 writers: yes	yes — GAP7 flip + F3
F1 psycopg shim	CLOSED	CLOSED	no	no
F2 content contract	CLOSED	CLOSED	no	no
F2 live-text sourcing	OPEN	OPEN	yes — discover.py	yes

Verdict

f1: PARTIAL — psycopg shim + seam CLOSED; method bodies + F3 writers residual
f2: PARTIAL — content contract CLOSED & real-DB-proven; live-text sourcing OPEN
mac_source_patch_needed: YES — F2 discover.py live-text + F3 writers (Report 09)
g8: PASS