docs(jfm): establish traceable manuscript planning baseline

Track the research dossiers, section freezes, supporting manuscript materials, and round-aware agent controls so future drafting decisions can be reviewed across both repository mirrors.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/JFM_WYQ/ROUND3_BOTTOM_UP/00_MASTER_AGENT_PROMPT.md

@@ -0,0 +1,29 @@
+# Round 3 Master Agent Prompt
+
+Use this reusable prompt for one assigned module. Replace every bracketed field before dispatch.
+
+## Prompt template
+
+You are the Round-3 section agent for **[MODULE ID — MODULE FILENAME]** in *Interpreting learned hydrodynamic cloaking and illusion in a fluidic pinball*.
+
+**Assigned scope:** [NON-OVERLAPPING SECTION QUESTION]. **Bounded answer ceiling:** [ONE GREEN/AMBER SENTENCE]. **Paragraph target and space:** [TARGET]. **Imports:** [DEFINITIONS, EVIDENCE, BRIDGES]. **Exports:** [DEFINITIONS, RESULT, NEXT QUESTION]. **Relevant figures/equations/tables:** [LIST].
+
+Read before drafting: the Round-2 freeze and style guide; relevant Round-1 dossiers; and relevant current package authority documents/manifests. External literature supplies narrative/method precedent only, never internal results. Do not infer facts from memory. Preserve Legacy/V5, solver, geometry, Re convention, case/seed/role, comparator, metric/estimand, ROI/mask, window and artifact boundaries.
+
+Use fixed terminology: concept `hydrodynamic cloaking/illusion`; execution `wake-signature matching`; evaluation `field matching`, spatial L2 primary and DTW complementary/case-specific; interpretation `control skeleton`; CCD `action-correlated correction-field modes`, descriptive/noncausal. Distinguish pipeline `Level-2/Level-3` and `Stage-3 short/standard gate` from spatial L2; never write `L2 gate` for validation level. Preserve positive SR Kármán/cloak only, negative Illusion SR, claim-free OID, qualitative experiment and compact CFD.
+
+## Deliver exactly
+
+1. Section question and bounded answer.
+2. **Layer 1 — narrative:** prose-like paragraph drafts/maps with a clear argumentative job, short source tags (for example `[R1-SR; authority]`), substantive transitions, and local caveats. Do not insert giant inline `Evidence contract:` blocks, package-path inventories or bold template labels into the narrative.
+3. **Layer 2 — local provenance:** immediately after the narrative, provide compact paragraph notes or a claim-to-evidence ledger. For each quantitative/physical claim record exact source/artifact, chain, solver/geometry, case/seed/role, Re convention, comparator, metric/estimand, ROI/window, status, and whether `artifact-audit deferred`.
+4. Figure, equation and table contracts: role, evidence/artifact, caption-level limitation, and what each does not establish.
+5. Claim ladder: supported/green, bounded/amber, prohibited/red; imports, exports, final bridge, genuine blockers, and concise coverage ledger (`read`, `mapped`, `not-covered`, `external-inaccessible`, with reasons and evidence status).
+6. Cross-module near-collision check: for numerically similar results, compare role acquisition, role set, ROI/domain, mask, weighting/normalization and window; classify them as `same estimand`, `related diagnostic` or `different estimand`. Prohibit arithmetic combination and replication/validation/agreement/triangulation wording unless exact authority licenses it.
+7. Anti-index/anti-AI audit, including metric pooling, citation invention, silent chain transfer, redundancy, source-path dominance, paragraph/sentence overload, and repeated mega-paragraphs.
+
+Authority-led hidden/external artifact deferral is not automatically a blocker. If authority docs/manifests explicitly bind the artifact and exact claim/number without conflict, record `artifact-audit deferred` and continue. Block only when the missing leaf/raw artifact is needed to resolve a conflicting authority, identify an exact role/comparator/window, substantiate a proposed number/panel, or answer the section question. Do not demand universal hash recomputation.
+
+Respect scope interfaces: contextual facts from another module may be one bridge sentence or export, not a duplicate result block. In particular, SR must not absorb full steady results; field/CCD must not reproduce SR derivation; contracts must define contracts, not become results.
+
+Edit **exactly** `[OUTPUT FILE]` and no other file. Do not modify Round-1/2, source code, archives or evidence packages. Report inspected sources and deferrals. This is a first pass: do not label it manuscript-ready; await parent audit and targeted revision.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/00_MODULE_INTERFACE_LEDGER.md

@@ -0,0 +1,25 @@
+# Round 3 Module Interface Ledger
+
+Coordinator-owned dispatch order. Each module writes only its assigned file and imports/exports definitions explicitly. Statuses are `planned`, `first-pass`, `revise`, `second-audit`, `ready`, or `blocked`.
+
+| Order | Module / output filename | Primary question and dependency | Export to | Status | Coordinator audit note |
+|---:|---|---|---|---|---|
+| 1 | `03_CONTRACTS_METRICS.md` | What are the plant, chain, action, role and case-specific evaluation contracts? | all modules | `ready` | Second-audit PASS; chain, role, metric and Level/Stage interfaces are reconciled. |
+| 2 | `04_KARMAN_PERFORMANCE.md` | Under the Legacy Kármán contract, what does independent field matching show? | 05, 06, synthesis | `ready` | Second-audit PASS; DTW orientation and M04/M06 different-estimand boundary are reconciled. |
+| 3 | `05_KARMAN_SR_LAW.md` | What executable SR structure is supported, and what do bounded deletions test? | 06, 08, conclusion | `ready` | Section text ready; standardized PPO/SR/Zero panel remains optional/dependency-gated and must be dropped unless exact role artifacts are bound. |
+| 4 | `06_KARMAN_FIELD_CCD.md` | What do mean/dynamic estimands and CCD action-correlated correction-field modes organize? | 08, 10 | `ready` | Second-audit PASS; corrected four-role estimand and M04 non-equivalence boundary are reconciled. |
+| 5 | `07_CROSS_CASE_EXTENSIONS.md` | What changes across vortex, Illusion and Erase under distinct contracts? | 08, 10 | `ready` | Second-audit PASS; ready for Wave C imports; Vortex event-L2 and Erase quantitative panels remain dependency-gated/blocked, and Illusion field L2 remains conditional. |
+| 6 | `08_STEADY_SYNTHESIS.md` | What bounded steady context can be related retrospectively to Kármán? | 09, 10 | `ready` | Second-audit PASS; text ready for Wave C imports; optional steady/MFS/evidence-map panels are dependency-gated and nonblocking. |
+| 7 | `01_INTRODUCTION.md` | What concept, gap and bounded contribution frame the paper? | 02, all | `ready` | Second-audit PASS; five-paragraph JFM-facing introduction ready, three claim levels and asymmetric cross-case scope reconciled, exact literature identities/read levels retained, and Fig. 1 correctly bridged to the capability section. |
+| 8 | `02_CAPABILITY_PROGRESSION.md` | How does steady discovery → Kármán → vortex → illusion/erase establish capability breadth? | 04, 07 | `ready` | Second-audit PASS; bounded progression text ready, Kármán dominant, steady q_ctl/q_in contract corrected, Vortex/Illusion roles bounded; raw/redrawn Fig1 panels remain artifact-dependency-gated and optional Re400 marker is subordinate/drop-first. |
+| 9 | `09_EXPERIMENT_AUTHOR_INTERFACE.md` | What qualitative open-loop experiment interface is reserved for Frank? | 10 | `ready` | Second-audit PASS as author interface; ready for Frank/M10 imports, but final prose and any experiment figure remain blocked by the author-supply/raw-provenance gate. |
+| 10 | `10_LIMITATIONS_CONCLUSION.md` | What is the integrated claim ceiling and decisive next test? | final audit | `ready` | Second-audit PASS; three claim levels separated (named cross-task capability, Legacy Kármán-only independent field matching, bounded Legacy Kármán control skeleton); M09 imported; final experiment prose/panel remains author-provenance-gated. |
+| 11 | `11_FINAL_CONSISTENCY_AUDIT.md` | Are terminology, chains, metrics, bridges, provenance and redundancy consistent? | manuscript handoff | `ready` | Final consistency audit PASS for author manuscript synthesis; all Modules 01–10 are text-ready under the fixed claim ladder. Remaining REVISE items are assembly-stage deduplication/ownership edits; BLOCK items are optional panel/artifact or author-provenance gates and do not block bounded text. |
+
+## Coordinator-owned near-collision interface note
+
+Although the standardized PPO and corrected CCD mean errors are numerically close and share the same nominal x extent, they arise from different role acquisitions, retained windows, masks and quadrature/normalization contracts; they are separate estimands, not replication or validation, and are not combined arithmetically.
+
+## Interface rules
+
+The coordinator records imported definitions and exported claims after each audit. No export may exceed the source module's claim ceiling or cross Legacy/V5, periodic/transient/steady, or capability/interpretation boundaries without explicit authority. A `second-audit` may be conditionally passed, but `ready` requires imported interfaces to be reconciled. Optional figure dependencies do not block section text unless the panel or claim is retained; missing artifacts, exact roles or unresolved conflicts otherwise become blockers, not inferred content.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/00_QUALITY_GATE.md

@@ -0,0 +1,29 @@
+# Round 3 Quality Gate
+
+The parent coordinator assigns one status per module: **PASS**, **REVISE**, or **BLOCK**. `PASS` means ready for a second audit, never final manuscript approval. Only after the second audit may the coordinator mark a module `ready`.
+
+## First-pass audit protocol
+
+Before revising a module, classify each defect as **systematic prompt defect** (also observed or likely in other modules) or **module-specific defect** (local evidence, scope or reasoning problem). Update the rule/master prompt/quality control first for systematic defects, then issue targeted revisions to affected modules. Do not conceal a control-plane defect as an agent failure.
+
+## PASS checks
+
+- [ ] Two-layer delivery: readable prose-like paragraph drafts/maps with short source tags first; compact local paragraph notes or claim-to-evidence ledger immediately afterward. Full provenance is local and traceable without giant inline contract blocks, package-path dumps, bold template labels or source/status language dominating the argument.
+- [ ] Paragraph cadence is readable: one argumentative job per paragraph, substantive bridges, reasonable sentence/paragraph load, and observation → comparator → physical reading → limit → consequence where applicable. Flag repeated mega-paragraphs or overloaded sentences; do not use rigid word-count automation.
+- [ ] Reads and names the controlling Round-2 freeze/style guide, relevant Round-1 dossiers and current package authorities; ledger distinguishes `read`, `mapped`, `not-covered`, `external-inaccessible` with reasons.
+- [ ] Every number and physical claim has exact provenance: authority/artifact, Legacy/V5 chain, solver/geometry, case/seed/role, Re convention, comparator, metric/estimand, ROI/window and status.
+- [ ] Authority-led hidden/external artifacts explicitly bound by conflict-free authority are marked `artifact-audit deferred`, not automatically blocked. BLOCK applies only when the missing artifact is necessary to resolve authority conflict, identify exact role/comparator/window, substantiate a proposed number/panel, or answer the section question.
+- [ ] Distinguishes pipeline `Level-2/Level-3` or `Stage-3 short/standard gate` from spatial L2 field-error metric; no validation level is called an `L2 gate`. Spatial L2 remains primary for field matching; DTW is complementary/case-specific, with no silent metric pooling or phase relabelling.
+- [ ] Enforces scope interfaces: bridge/context is brief; SR does not duplicate full steady results; field/CCD does not duplicate SR derivation; contracts do not become a results section.
+- [ ] Runs a near-collision check for numerically similar cross-module results: compare role acquisition, role set, ROI/domain, mask, weighting/normalization and window; classify `same estimand`, `related diagnostic` or `different estimand`. Prohibit arithmetic combination and replication/validation/agreement/triangulation wording unless exact authority licenses it.
+- [ ] Defines figure/equation/table roles and caption limits; states imports, exports, section bridge, conflicts, non-claims and genuine blockers.
+- [ ] Uses fixed terminology and claim ceiling: positive SR Kármán/cloak only; negative Illusion SR; descriptive/noncausal CCD action-correlated correction-field modes; claim-free OID; qualitative experiment.
+- [ ] Passes anti-index and anti-AI checks: no inventory/package handoff/card stack, generic prose, caption narration, citation/number/artifact invention, or delayed limitations.
+
+## REVISE
+
+Use when evidence is traceable but narrative cadence, layer separation, style, interfaces, terminology, redundancy, provenance, local caveats or exact metric semantics are incomplete. Return targeted paragraph-level prompts, not a general wish list. Re-audit after revision.
+
+## BLOCK
+
+Use when a controlling source was not read without a justified ledger entry, an authority conflict affects the answer, a required artifact/role is absent, a number lacks provenance, Legacy/V5 are merged, metrics are pooled, or the draft requires unsupported causality/mechanism/generalization. An authority-led artifact deferral alone is not a blocker when its claim and role are explicitly bound without conflict. Preserve the blocker; do not fill it from memory.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/00_WAVE_A_COORDINATOR_AUDIT.md

@@ -0,0 +1,90 @@
+# Wave A independent coordinator audit
+
+## Scope, gate and overall disposition
+
+This audit read in full the revised Round-3 drafting rule, master prompt, quality gate and interface ledger; the Round-2 revised structure freeze and section-level style guide; and current revised Modules 03–06. Current authority was consulted only for two concrete interface questions: `wake_l2.py` and the corrected CCD contract/results for the near-colliding field estimands, and the frozen SR pipeline for July formula-parent versus August standardized-role windows. Evidence status is therefore `read`, not independently recomputed or universally artifact-audited. Working memory was used only as a scope warning and did not establish a result.
+
+**Gate verdicts:** Module 03 — **PASS**; Module 04 — **REVISE**; Module 05 — **PASS, conditionally ready after ledger reconciliation**; Module 06 — **REVISE**. No true scientific blocker remains for the bounded text. Wave B **may begin now** because the core chain, role, metric, SR and CCD interfaces are stable; optional field or standardized PPO/SR/zero panels remain dependency-gated.
+
+| Module | Narrative | Provenance | Scope / claim ceiling | Interface | Gate |
+|---|---|---|---|---|---|
+| 03 Contracts/metrics | Clear six-job cadence; compact qualification | Exact local ledger and honest deferrals | Correctly defines rather than reports results | Canonical exports are usable verbatim; V5 signs are explicitly non-Legacy; Level/Stage is distinct from spatial L2 | **PASS** |
+| 04 Kármán performance | L2-first and readable, but one DTW sentence is internally ambiguous | Strong role/ROI/window ledger; target-hash distinction retained | Legacy principal, V5 secondary; no pooling or causal claim | Imports M03 correctly; export to M06 needs an explicit non-equivalence warning | **REVISE** |
+| 05 Kármán SR law | Correct five-step argument and local limits | Formula, deployment and deletion contracts are traceable; leaf audit honestly deferred | Kármán/cloak only; deletion is not causal ablation; no positive Illusion transfer | Correctly separates July formula-parent DTW/deletion from August same-protocol roles; no same-protocol PPO/SR/zero values invented | **PASS** (conditional `ready`) |
+| 06 Field/CCD | Mean→share→residual→CCD→POD order is strong | Exact corrected authority identities, roles, mask, window and lineage | Descriptive/noncausal; no pairing, energy share, mechanism, OID or superiority claim | SR/CCD separation is correct, but M04 near-collision is not explicitly reconciled and “spatial-L2 context” is too loose | **REVISE** |
+
+## Exact cross-module interface matrix
+
+| Producer | Exact export | Importers and permitted use | Reusable verbatim wording |
+|---|---|---|---|
+| M03 | Legacy and V5 are separate executable chains; chain-specific plant, body/action/Re, calibration, role, comparator, metric and window | M04–06; contracts only, never numerical continuation | “Legacy and V5 define separate executable evidence chains; never pool their numbers or imply numerical continuation/equivalence.” |
+| M03 | V5 `(front, top, bottom)`, `omega=-(12a+b)U0/R`, zero bias, weight-0.1 smoothing; Legacy `(front, upper, lower)`, `alpha=omega/U0`, `Re_D=Re_code/2` | M04–06; Legacy modules import only the Legacy branch | “The V5 map does not apply to Legacy SR.” |
+| M03 | Spatial L2 primary; DTW complementary/signal-level/case-specific; periodic mean, phase8, event, mean-field and steady estimands distinct | M04 owns standardized PPO field evaluation; M05 imports only the distinction; M06 defines its own corrected mean estimand | “Field matching uses spatial L2 as primary evidence and DTW as complementary, signal-level and case-specific evidence.” |
+| M04 | Standardized Legacy PPO target/controlled/zero field roles; ROI `-6..+14D` from `x_s`, `|y-y0|/D<=5`; geometry guard; complete-cycle mean and independent phase8 | M05 as performance context; M06 only as a separate prior field result | “The field result is a performance arbiter for any reduced law; it does not itself identify a necessary, causal or unique action component.” |
+| M05 | Canonical mapped-shared Legacy SR formula, imposed `G`, July 200/400-step formula-parent DTW, and 40-step parent-relative deletion ranking | M06 and synthesis; action-law interpretation only | “These are deletion tests, not causal ablations: they do not establish term necessity, sufficiency, mechanism, uniqueness or universal sensitivity.” |
+| M05 | August Target/PPO/SR/Zero is a separate standardized `480+160` acquisition | Any direct same-protocol panel only | “Exact PPO/SR/zero comparator numbers are not asserted here unless the current role artifacts and proposed panel supply them.” |
+| M06 | Corrected four-role mean ledger; exact common mask; non-paired `19x10` residual; rank-3 action coordinates; POD-equivalent tested subspace | Later synthesis only under corrected estimand | “The percentages are scalar error-difference shares, not explained variance, energy share, causal contribution or term attribution.” |
+
+## Numerical near-collision: mandatory reconciliation
+
+The Module 04 and Module 06 numbers are **different estimands**, despite their close magnitudes. Current authority does not call them replication or validation.
+
+- **M04 standardized PPO field metric:** three independently acquired roles (`target`, frozen-PPO `controlled`, physical `zero`); registered lattice rectangle relative to sensor station, `-6 <= (x-x_s)/D <= 14` with `x_s=800`, equivalent in x extent to `34 <= x/D <= 54`; geometry guard only, with no persisted solver-exact mask; unweighted lattice-cell RMS after division by `U0`; role-local complete-cycle means over accepted crossings, plus a separate eight-nearest-snapshot phase diagnostic. Values: `E_mean_ctl=0.0857710225`, `E_mean_zero=0.4752063239`.
+- **M06 corrected CCD mean ledger:** four roles (`target`, `zero`, `constant mean`, `DRL`) in the corrected CCD acquisition/lineage; inclusive `34 <= x/D <= 54`, `|y/D| <= 5`; **exact intersection of all four solver-fluid masks**; coordinate-weighted RMS; persisted velocities already nondimensional and not divided by `U0` again; retained four-role mean window that also supports the constant comparator. Values: `E_DRL=0.0857787860`, `E_zero=0.4694352273`, `E_constant=0.1110140739`.
+
+The x extents coincide after substituting M04's Legacy `x_s/D=40`, which explains only geometric similarity. Role acquisitions, role set, retained windows, masks and quadrature/normalization differ. Consequently the values must **never be equated, subtracted across modules, averaged, used to compute a cross-module discrepancy, or described as replication, validation, agreement, closure or independent triangulation**. M04's complete-cycle and phase8 results do not validate M06's corrected four-role ledger; M06's `93.42/6.58` decomposition exists only inside its own ledger.
+
+Recommended shared sentence, reusable verbatim in the interface ledger and later synthesis: **“Although the standardized PPO and corrected CCD mean errors are numerically close and share the same nominal x extent, they arise from different role acquisitions, retained windows, masks and quadrature/normalization contracts; they are separate estimands, not replication or validation, and are not combined arithmetically.”**
+
+## SR interface finding
+
+Module 05 passes this interface. Its July formula-parent evidence uses native Legacy DTW over Stage-3/deletion windows (40-step deletions; 200-step standard deployment; finite 400-step extension). The August standardized collector instead acquires Target/PPO/SR/Zero after 480 warm-up intervals plus 160 retained boundaries. Module 04's PPO field values come from standardized target/controlled/zero field roles and spatial estimands, not from the July formula-parent deletion contract. Module 05 explicitly avoids claiming a same-protocol PPO/SR/zero numerical comparison and makes the panel conditional on exact standardized artifacts. No formula-parent DTW or deletion delta is relabelled as M04 spatial L2.
+
+## Targeted revision prompts
+
+### Module 04 — REVISE
+
+1. **Layer 1 paragraph 2, first quantitative sentence:** replace the wording that says controlled normalized DTW is `0.932899` “compared with `0.625127` for zero” and then says “its native ... mean is `0.952132`.” Higher similarity appears to be favorable, so remove any ambiguity introduced by calling these “DTW” without the authority's similarity orientation. State explicitly that these are normalized/native **similarity scores** (if that is the authority label), that controlled is higher than zero, and preserve the exact formula/window. Do not call a higher value an error or distance. Mirror the same nomenclature in ledger row 31 and the DTW figure contract.
+2. **Layer 1 paragraph 5 or M06 export:** append the mandatory reconciliation sentence above after the M06 handoff. This is an interface caveat, not a new result. It may instead be recorded in the coordinator ledger/audit if later synthesis is required to import it verbatim; M04 prose need not duplicate M06's values.
+
+`ready` condition: correct the DTW metric orientation/naming in narrative, ledger and figure contract; retain the target-hash clarification; and bind the non-equivalence sentence in the coordinator interface ledger or M04 export. No raw-field access is required for textual readiness. A redrawn field panel remains optional and artifact-dependent.
+
+### Module 06 — REVISE
+
+1. **Layer 1 paragraph 1, after the estimand definition:** insert the mandatory reconciliation sentence above, shortened only by retaining all four distinctions: role acquisition, retained window, exact mask versus geometry guard, and coordinate-weighted/already-nondimensional versus unweighted `U0`-normalized metric. Do not say the M04 and M06 errors agree.
+2. **Layer 2 SR-bridge row and Interfaces paragraph:** replace generic “spatial field-error context” with “M06's corrected four-role coordinate-weighted mean-field estimand.” Add that M04's standardized PPO `E_mean`/phase8 values are separate and cannot validate or numerically close the M06 ledger.
+
+`ready` condition: make this estimand boundary explicit in either M06 prose plus ledger, or in M06 ledger plus the coordinator interface ledger with mandatory downstream import. All corrected authority-led array/hash deferrals remain nonblocking. Optional panel redraw becomes a blocker only if the panel is retained and cannot be sourced under its documented contract.
+
+## Non-revision findings
+
+- **M03 definitions:** no silent V5-to-Legacy sign or normalization transfer occurs. The V5 negative action map and observation-only `VecNormalize` are explicitly chain-local; Legacy uses native `alpha`, order and compatibility scaling. Pipeline `Level-2/Level-3` and `Stage-3 short/standard` are explicitly distinct from spatial L2. This module can become `ready` after this second-audit PASS is recorded; no prose edit is required.
+- **M05:** narrative, provenance, scope and interface checks pass. It can become `ready` once the coordinator records reconciled M03/M04 imports and either drops the optional standardized PPO/SR/zero panel or binds exact same-protocol role artifacts before retaining it. This reconciliation can be performed in the ledger/audit without editing M05 prose.
+- **Deferrals:** absent raw fields, solver-exact mask for M04, leaf-hash recomputation, model/normalizer payloads, and dense CCD arrays are correctly nonblocking where current conflict-free authority binds the exact bounded text. They become blocking only for a retained new panel, a reproducibility claim, or resolution of a concrete authority conflict. The Kan99b lift-sign issue is quarantined to affected lift claims and does not block Modules 03–06. No current true blocker remains.
+
+## Systematic prompt audit and Wave B decision
+
+One repeated defect remains across **Modules 04 and 06**: the prompt/gate requires exact local provenance but does not require an explicit **near-collision check across modules when similar numbers occupy nearby narrative roles**. Add one coordinator-level check to the master/quality/interface controls for future waves: “For numerically similar cross-module results, compare role acquisition, role set, ROI, mask, weighting/normalization and window; explicitly classify same estimand, related diagnostic or different estimand, and prohibit arithmetic or validation language unless exact authority licenses it.” This recommendation meets the two-module threshold. No broader prompt change is justified for DTW orientation, which is local to Module 04.
+
+**Wave A readiness:** core interfaces are stable enough for Wave B. Record M03 and M05 as second-audit PASS/`ready` under the conditions above; retain M04 and M06 as `revise` until the two targeted wording fixes are re-audited. Wave B agents may proceed using the canonical exports and mandatory non-equivalence sentence, while treating new field figures and a standardized PPO/SR/zero panel as optional dependencies rather than section-text blockers.
+
+## Coverage ledger
+
+- `read`: revised Round-3 rule/master/quality/interface ledger; Round-2 freeze/style; revised Modules 03–06; targeted current `wake_l2.py`, corrected CCD math/results, and SR pipeline authority.
+- `mapped`: module-linked manifests and external artifact identities, only to understand documented bindings.
+- `not-covered`: broad Round-1/package re-exploration, raw NPZ/dense arrays, universal hash recomputation, new CFD/training and external literature; unnecessary for the identified inconsistencies.
+- `external-inaccessible`: authority-bound external/symlink payloads; artifact audit deferred and nonblocking for this bounded audit.
+
+
+## Second-audit closure — targeted Modules 04 and 06
+
+This closure re-audits only the targeted revisions against the ready conditions above and the updated cross-module near-collision gate; it does not reopen the first audit.
+
+- **Module 04 — PASS; `ready`.** The narrative, provenance row, figure contract and claim ladder now identify the normalized and native DTW quantities as similarity scores, state that higher is better, provide controlled and zero values under both contracts, and prohibit error/distance wording. The target-hash clarification remains intact. Its Module 06 export now binds the mandatory non-equivalence rule and names different acquisitions/role sets, windows, masks and weighting/normalization; it prohibits arithmetic combination and replication/validation/agreement/triangulation language. All M04 ready conditions are met.
+- **Module 06 — PASS; `ready`.** Layer 1 now distinguishes the standardized PPO and corrected CCD ledgers by role acquisition/set, retained window, geometry guard versus exact four-role common mask, and unweighted `U0` normalization versus coordinate weighting on already nondimensional velocity. The provenance bridge and interface paragraph explicitly identify M06's corrected four-role coordinate-weighted mean-field estimand and prohibit using M04 `E_mean`/phase8 to validate or numerically close it. All M06 ready conditions are met.
+- **Module 03 — PASS; `ready`, unchanged.** No targeted change alters its chain-local action/normalization definitions, Legacy/V5 separation, or Level/Stage versus spatial-L2 distinction.
+- **Module 05 — PASS; conditional-ready state unchanged.** M03/M04 imports are now coordinator-reconciled, but a direct standardized PPO/SR/zero panel remains optional and may be retained only after exact same-protocol role artifacts, comparator values, metric and window are bound. If that panel is omitted, no prose or scientific blocker remains.
+
+**Remaining optional dependencies, exactly scoped:** (1) a newly redrawn M04 Legacy field panel requires raw role payload access plus manifest/hash audit; (2) a reproduced/redrawn V5 selected-policy panel requires the same-selection `best_model.zip` and matching VecNormalize artifact; (3) an M05 direct PPO/SR/zero panel requires complete standardized same-protocol Target/PPO/SR/Zero role artifacts and exact comparator values; and (4) a newly redrawn M06 figure must remain sourceable under the documented publication/data contract. These dependencies condition only retained optional panels or reproducibility/artifact-audit claims, not the bounded section text. Canonical CCD alias promotion, universal leaf-hash recomputation, M04 solver-exact-mask reconstruction and the quarantined Kan99b lift-sign issue remain nonblocking at the present claim ceiling.
+
+**Final Wave A disposition:** the core Modules 03, 04 and 06 are `ready`; Module 05 is conditionally ready solely on the optional direct-comparator panel decision. No true core blocker remains, the near-collision interface is closed, and **Wave A core modules are ready for Wave B**.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/01_INTRODUCTION.md

@@ -0,0 +1,69 @@
+# Round 3 revised candidate — Section 1: Introduction
+
+**Working title:** *Interpreting learned hydrodynamic cloaking and illusion in a fluidic pinball*
+
+**Status:** ready for coordinator second-audit closure; not manuscript approval.
+
+## Section question and bounded answer
+
+**Question.** What physical problem, literature gap and bounded contribution justify this paper without overpromising applications, mechanism or priority?
+
+**Bounded answer.** The paper separates three evidence levels: (a) named wake-signature or visual PPO capability across the declared Kármán, Vortex and Illusion tasks under distinct contracts; (b) independent spatial field matching only for named Legacy Kármán Re100; and (c) a bounded Legacy Kármán control-skeleton interpretation. The latter combines executable action-law evidence with a corrected four-role constant-mean comparator and a separately centred, non-paired residual organized descriptively by action-correlated correction-field modes. This does not establish linear-cloak/Navier–Stokes equivalence, a causal mechanism, universal transfer, positive Illusion symbolic regression, priority or quantitative experimental validation.
+
+## Layer 1 — five-paragraph near-prose draft
+
+### Paragraph 1 — concept and compact genealogy
+
+Hydrodynamic cloaking and illusion are observer-centred matching objectives. Cloaking asks a controlled body to approach a declared background or incident signature in the field or signal space seen by an observer; illusion instead asks it to approach a declared non-zero signature associated with another target. A compact genealogy runs from transformation-based and conformal optical cloaks to active exterior cloaking and non-zero-target illusion in linear field equations, with later wave analogues and active hydrodynamic proposals showing how cancellation or retargeting can be formulated under restricted assumptions (Pendry, Schurig & Smith 2006; Leonhardt 2006; Vasquez, Milton & Onofrei 2009; Ma et al. 2013; Urzhumov & Smith 2012). This history supplies vocabulary for declared references, active sources and target signatures; it does not make a linear cloak equivalent to a finite-Reynolds-number Navier–Stokes wake, nor does “cloaking” mean invisibility to every possible observer. [R1-Introduction literature]
+
+### Paragraph 2 — finite-Reynolds-number pinball difficulty
+
+The fluidic pinball makes the distinction concrete. Three interacting circular bodies generate separated shear layers, vortex shedding, symmetry breaking and multiple temporal organisations; independent rotation must modify a spatially extended wake rather than a single scalar force. The pinball therefore supplies a compact but nonlinear benchmark in which mean deficit, phase, frequency and downstream spatial organisation need not change together (Deng et al. 2020, 2021, 2022). Earlier rotating-cylinder and machine-learning control studies establish that actuation can alter separation, wake structure and force, but their objectives and observables do not by themselves answer whether a specified downstream signature has been matched (Cornejo Maceda et al. 2021; Gautier et al. 2015). The physical problem here is finite-Re wake-signature matching with limited actuation and sensing, not scalar drag optimisation relabelled as cloaking.
+
+### Paragraph 3 — capability and explanation gap
+
+Deep reinforcement learning offers a way to search this nonlinear control problem from forces and sparse downstream velocity observations. It can discover effective feedback in settings where a tractable controlled-flow model is unavailable, as shown for cylinder control and later studies of robustness, stability and partial observation (Rabault et al. 2019; Paris, Beneddine & Dandois 2021; Li & Zhang 2022; Xia et al. 2024; Wang et al. 2024). That capability leaves a scientific gap. A reward or sparse-signal similarity score establishes performance only in its declared observer space; it does not independently establish field matching, reveal which action structure survives closed-loop deployment, or explain how a persistent wake correction is organised. Adjacent active hydrodynamic stealth work and sparse-model approaches sharpen the motivation, but do not supply this paper’s rotating-pinball evidence chain or a basis for a priority claim (Ren, Wang & Tang 2021; Loiseau, Noack & Brunton 2018). The question is how to interpret learned capability without promoting policy correlation into a physical law.
+
+### Paragraph 4 — evidence chain needed for a bounded interpretation
+
+Answering that question requires linked but non-equivalent tests. The execution problem is wake-signature matching, whereas independent spatial field matching is reserved for the named Legacy Kármán Re100 comparison, with L2 primary and DTW complementary, signal-level and case-specific. The learned action must be tested as an executable closed-loop law under the same Legacy plant and action convention, rather than accepted from offline action fit alone. The corrected four-role analysis then compares a constant-role mean field with zero and DRL target errors, while a separately centred, non-paired dynamic residual is organized descriptively by action-correlated correction-field modes. These tests address distinct performance, action-law and field-role questions; they do not independently confirm one another or establish a mechanism.
+
+### Paragraph 5 — question, contribution, scope and bridge
+
+This paper asks whether named force-plus-sparse-signature control can produce hydrodynamic cloaking and illusion in the fluidic pinball, and what can be learned about the Kármán cloak without confusing capability with mechanism. Its contribution has three levels: named wake-signature or visual PPO capability across declared Kármán, Vortex and Illusion tasks; independent spatial field matching only for Legacy Kármán Re100; and a bounded Legacy Kármán control-skeleton interpretation. The interpretation is Kármán/cloak-only: Vortex and Illusion remain bounded capability demonstrations, Erase is unsupported quantitatively, positive Illusion SR is historical/negative, and any experiment is author-described qualitative, open-loop and provenance-gated. Applications are prospective only. The next section fixes the plant, action, chain, role and metric contracts; the following capability section presents the Kármán-dominant Fig. 1 progression, with no experiment. [Round-2 freeze; M02; M03–M10]
+
+## Layer 2 — provenance, literature identities and style recommendation
+
+| Paragraph | Exact identity / read level | Boundary |
+|---|---|---|
+| P1 | Pendry, Schurig & Smith, “Controlling Electromagnetic Fields,” *Science* 312, 1780–1782 (2006), DOI `10.1126/science.1125907`; Leonhardt, “Optical Conformal Mapping,” *Science* 312, 1777–1780 (2006), DOI `10.1126/science.1126493`; Vasquez, Milton & Onofrei, “Active exterior cloaking for the 2D Laplace and Helmholtz equations,” *PRL* 103, 073901 (2009), DOI `10.1103/PhysRevLett.103.073901`; Ma et al., “Experiments on active cloaking and illusion for Laplace equation,” *PRL* 111, 173901 (2013), DOI `10.1103/PHYSREVLETT.111.173901`; Urzhumov & Smith, “Flow stabilization with active hydrodynamic cloaks,” *PRE* 86, 056313 (2012), DOI `10.1103/PhysRevE.86.056313`. Full-PDF per R1 index. | Linear genealogy is vocabulary/method precedent only; no Navier–Stokes equivalence. |
+| P2 | Deng et al., “Low-order model for successive bifurcations of the fluidic pinball,” *JFM* 884, A37 (2020), DOI `10.1017/jfm.2019.959`; Deng et al., *JFM* 918, A4 (2021), DOI `10.1017/jfm.2021.299`; Deng et al., *JFM* 934, A24 (2022), DOI `10.1017/jfm.2021.1105`; Cornejo Maceda et al., *JFM* 917, A42 (2021), DOI `10.1017/jfm.2021.301`; Gautier et al., *JFM* 770, 442–457 (2015), DOI `10.1017/jfm.2015.95`. Full-PDF per style guide. | External precedent only; no project threshold, solver, Re or result imported. |
+| P3 | Rabault et al., *JFM* 865, 281–302 (2019), DOI `10.1017/jfm.2019.62`; Paris et al., *JFM* 913, A25 (2021), DOI `10.1017/jfm.2020.1170`; Li & Zhang, *JFM* 932, A44 (2022), DOI `10.1017/jfm.2021.1045`; Xia et al., *JFM* 981, A17 (2024), DOI `10.1017/jfm.2024.69`; Wang et al., *JFM* 988, A4 (2024), DOI `10.1017/jfm.2024.333`; Ren et al., *Physics of Fluids* 33, 093602 (2021), DOI `10.1063/5.0060690`; Loiseau et al., *JFM* 844, 459–490 (2018), DOI `10.1017/jfm.2018.147`. Full-PDF per R1/style records. | Capability and interpretation motivation only; unresolved `Ren19b` excluded; no priority claim. |
+| P4–P5 | Round-2 freeze/style; R1 Introduction, DRL, SR, field/CCD/OID, steady/theory and metrics dossiers; current Modules 03–08, ready M09 and M10, and current authorities. Full-report/read for repositories; not independently recomputed or universally artifact-audited. | Three levels remain separate: named wake-signature/visual PPO capability across declared tasks; Legacy Kármán Re100 spatial field matching only; bounded Legacy Kármán control-skeleton interpretation. Vortex has no event L2; Illusion field L2 is conditional and Illusion SR historical/negative; Erase has no supported quantitative route; experiment is qualitative/open-loop and provenance-gated. |
+
+**Observed literature style.** The supplied JFM papers generally move from physical problem and comparator to evidence, interpretation and a local limitation. Deng uses physical chronology and transition to motivate refinement; Rabault and Paris reach the control gap quickly; Gautier places an explicit law beside closed-loop behaviour; Loiseau moves from sparse observations toward fuller representation. Strong words follow dedicated tests, and bridges introduce the next scientific question.
+
+**Manuscript recommendation.** Use that rhythm at a lower claim register: concept and gap → finite-Re difficulty → named capability and explanation gap → independent evidence chain → bounded question and bridge. Keep genealogy compact, cite around physical transitions, state dangerous limits here, reference Figure 1 prospectively without panel narration, and organize the contribution as capability, field matching and Kármán interpretation rather than a package list.
+
+## Figure, claim and interface contracts
+
+- **Figure 1:** presented in the following capability section as a Kármán-dominant progression across named contracts; it does not establish a common score, independent field matching beyond Legacy Kármán Re100, positive Illusion SR, interpretation transfer or pooled Legacy/V5 evidence. It contains no experiment.
+- **Definitions next:** cloak/illusion as declared reference matching; wake-signature matching as execution; spatial L2 primary and DTW complementary. No project equations or numbers belong here.
+- **Green:** named wake-signature or visual PPO capability across the declared Kármán, Vortex and Illusion tasks; independent spatial field matching only for named Legacy Kármán Re100; and bounded Legacy Kármán control-skeleton interpretation.
+- **Amber:** a constant-role mean-field comparator accounts for most of the measured zero-to-DRL target-error reduction, while a smaller separately centred, non-paired residual is organized descriptively by action-correlated correction-field modes under the Legacy Kármán contract; steady is contextual.
+- **Red:** linear-cloak/Navier–Stokes equivalence, all-observer invisibility, universal/causal/mechanistic/necessary/unique/optimal/robust/priority claims, positive Illusion SR, pooled chains, DTW-as-delay, causal CCD, application catalogues or quantitative experiment validation.
+
+## Imports, exports, bridge and coverage ledger
+
+**Imports:** frozen title and vocabulary; R1 literature and motivation; current Round3 controls and ready Modules 02–10, including M09’s author-described experiment/provenance gate and M10’s three-level manuscript-wide claim ladder. **Exports:** cloak/background and illusion/non-zero-target definitions; wake-signature matching; L2-primary/DTW-complementary evaluation only for the named Legacy Kármán Re100 field comparison; Kármán/cloak-only control skeleton; broad capability versus asymmetric interpretation depth. **Bridge:** declare plant, chain, action, role, Re, comparator, metric and window before comparing cases, then present Fig. 1 in the capability section.
+
+| Status | Coverage and reason | Boundary |
+|---|---|---|
+| `read` | Round3 controls/interface/Wave-A audit; Round2 freeze/style; R1 Introduction and current-document audit; ready Modules 02–10, including M09 and M10; current Confirmation Introduction; cited JFM/Confirmation material | Read directly; not independently verified or artifact-audited |
+| `mapped` | Broader manifests, archive navigation and authority-linked external payload identities | Mapped only; not promoted as read evidence |
+| `not-covered` | New literature search; unresolved Ren19b; raw fields/NPZ/models; new CFD/training; hashes; Figure 1 generation; quantitative experiment | Unnecessary for bounded introduction; no claims inferred |
+| `external-inaccessible` | External/symlink-backed fields and hidden raw artifacts | Authority-led `artifact-audit deferred`; no raw-artifact claim made |
+
+## Final targeted self-audit
+
+The narrative retains five argumentative paragraphs and explicitly separates the three manuscript-wide levels: named wake-signature/visual PPO capability; Legacy Kármán Re100 spatial field matching; and bounded Legacy Kármán control-skeleton interpretation. The constant-role CCD comparator, non-paired residual, cross-case gaps and provenance-gated qualitative experiment are bounded without causal or action-magnitude language. Literature identities and DOI/read levels are preserved; no new result or citation was added. Figure 1 is correctly bridged to the following capability section. This final targeted revision passes the paragraph-boundary, claim-ladder, provenance and interface checks; the module is ready for coordinator second-audit closure, not manuscript approval.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/02_CAPABILITY_PROGRESSION.md

@@ -0,0 +1,131 @@
+# Round 3 first-pass module — Section 3: capability and progression
+
+**Status:** revised candidate for second audit; not self-ready and not final manuscript prose. The bounded narrative is text-ready for parent review, while raw and redrawn Fig. 1 panels remain artifact-dependency-gated. This module does not add experiment or reopen the analytical modules.
+
+## Section question and bounded answer
+
+**Question.** How should Fig. 1 and its accompanying text establish the progression from steady discovery through periodic Kármán cloaking, nonperiodic vortex response and the `075` Illusion objective extension while reserving analytical depth for Kármán?
+
+**Bounded answer.** Named visual and quantitative cases establish a progression in temporal dynamics and objective, while only Legacy Kármán Re100 has the full evidence intersection for deep interpretation; the figure therefore demonstrates breadth of execution under distinct contracts, not a pooled score, arbitrary-flow/generalization result or positive Illusion SR.
+
+## Layer 1 — readable paragraph draft/map
+
+### Paragraph 1 — viewing contract and figure composition
+
+Fig. 1 should answer a capability question before the paper turns to interpretation: can the same broad force-plus-sparse-observation execution be used for named targets whose temporal and objective contracts differ? The answer is presented as a left-to-right progression, not as a common efficacy ranking. A small steady panel supplies the historical discovery seed; the visually dominant Kármán block establishes the principal field-matching comparison; smaller Vortex and `075` Illusion panels show, respectively, an event-relative transient extension and a non-zero-target objective extension. Legacy and V5 lanes must be printed in the panel labels and caption. Each panel names its case, chain, role, comparator and metric status, and the composition contains no experiment. [R2 freeze/style; M03; M04; M07; M08]
+
+**Figure placement:** place Fig. 1 beside this opening paragraph. Allocate approximately 50–55% of the visual area to Kármán, with the steady, Vortex and `075` Illusion panels subordinate. Use visual juxtaposition to show the progression; do not place a common efficacy bar, pooled score, or gallery inventory beside it.
+
+### Paragraph 2 — short steady discovery seed
+
+The first capability seed is steady control: near-uniform or constant rear rotation was explored before the periodic Kármán analysis. In this opening section it should be stated only as historical discovery and visible low-deficit capability under its own steady contract, not as a temporal performance score or as evidence for the Legacy SR/CCD chain. The full V5 steady/free-slip result, accepted sign, profile metric and theory limits belong to the later steady return. This ordering preserves the physical chronology—steady discovery followed by Kármán interpretation—without allowing the early seed to pre-empt the Kármán analysis. [R1 DRL/cases; R1 steady dossier; M08]
+
+**Seed panel contract:** V5 steady/free-slip, accepted steady q_ctl against uniform/no-body q_in under E_inf_vector/profile status; q_blk is nonranking, and stationary/reverse views are contextual only. The panel establishes discovery chronology and a bounded visual endpoint only. It does not establish periodic phase matching, Legacy numerical continuation, mechanism, stability, optimum or pooled efficacy.
+
+### Paragraph 3 — Kármán headline and reason for depth
+
+The headline comparison is the Legacy `karman_re100` target, physical-zero and frozen PPO roles under one Legacy solver and geometry contract. Here `Re100` is the Legacy code convention `U_0(2D)/\nu=100`, equivalent to single-cylinder `Re_D=50`; it is not a V5 numerical continuation. In the registered downstream rectangle, the controlled field is closer to the target than physical zero in both principal complete-cycle mean-field L2 and the separately defined eight-slot phase diagnostic: `E_mean=0.085771` versus `0.475206` for zero, and `E_phase8=0.112680` versus `0.630878`. The corresponding zero-relative values are `\eta_mean=0.819508` and `\eta_phase8=0.821392`. The exact principal field claim is spatial L2 under the Legacy `drl-pinball-wake-l2-v2` contract; one concise complementary annotation is the six-channel target-normalized DTW similarity, `0.932899` controlled versus `0.625127` zero under the 30-step cycle contract (higher is better), not a field norm or physical delay. [M03; M04]
+
+Kármán is selected for depth because it has the evidence intersection needed for interpretation: a named Legacy target/zero/controlled field comparison, executable Legacy SR evidence, corrected mean/dynamic field roles and CCD description, with V5 Re100 seed/retention information as secondary context. The selection is not a claim that steady, Vortex or Illusion are less important, nor an inference that they failed. It is the case in which capability, independent field matching and bounded action/field interpretation coexist under traceable contracts. [M04; M05; M06; M08]
+
+### Paragraph 4 — Kármán to Vortex, then cloak to Illusion
+
+The smaller Vortex lane changes the temporal coordinate: periodic phase is removed and named Lamb/Taylor disturbances are read at event-relative offsets. The visual should retain the event labels and offsets—rather than relabelling them phase—and may show pulse-like action and downstream fields; target/control/zero roles are conditional and are not treated as audited together. A quantitative event-relative ROI L2 is not currently available in the authority chain, so no event L2 number should appear in Fig. 1; current Vortex DTW remains a case-specific signal comparison and is not a physical delay. The bounded reading is a named comparable-scale transient capability hypothesis, not arbitrary-flow control or transfer of the Kármán control skeleton. [M07; R1 metrics] The `075` Illusion lane changes the objective instead: the policy is asked to match a declared non-zero target signature rather than approach the physical background. The geometry is the target **radius ratio 0.75** (physical radius 15 at `L0=20`), even where historical labels use diameter-like names. Use the retained V5 `ill_075L`, seed 43, as PPO capability evidence with target and controlled visual roles; physical zero and any field metric are conditional on exact role artifacts and must not be implied by the visual alone. This is a V5 historical capability lane, not a Legacy numerical continuation and not positive Illusion SR. The negative Legacy Illusion SR result may be stated locally as the reason SR is not promoted, without allowing that historical caveat to overwhelm the opening capability progression. [M07; R1 DRL/cases]
+
+### Paragraph 5 — boundary, degradation and bridge to Kármán depth
+
+The breadth preview must carry its boundary beside its claim. If space permits after the steady, Vortex and Illusion progression is readable, one evidence-backed degradation indicator may be retained as a small optional secondary mark; otherwise it is dropped: in the V5 `kar_re400`, seed 43, the mean field improved relative to zero (`E_mean=0.177469` versus `0.221541`) while the phase diagnostic worsened (`E_phase8=0.490471` versus `0.450626`, `\eta_phase8=-0.08842`). This is a named-condition warning that mean and phase behavior can diverge, not a cross-Re law or a failure explanation. The figure must not combine this value with the Legacy Re100 L2 values, the corrected CCD mean ledger, Vortex event observations, steady profile quantities or Illusion PPO scores. With the progression and its limits visible, the text bridges to the Kármán sections: Kármán is the sole deep case because its evidence intersection permits performance, executable SR and descriptive mean/dynamic organization to be examined together; the later cross-case section returns to Vortex and Illusion under their own contracts. [M04; M06; M07]
+
+## Layer 2 — panel, provenance and claim ledger
+
+### Fig. 1 panel contracts
+
+| Panel / visual role | Chain, case, roles and comparator | Metric/status shown | Caption-level limit |
+|---|---|---|---|
+| **A. steady discovery seed** | V5 steady/free-slip; accepted steady q_ctl against uniform/no-body q_in under E_inf_vector/profile status; q_blk is nonranking; stationary/reverse views are contextual only; late/profile view | Visual steady endpoint or profile; nonperiodic late/profile status; no periodic score | Contextual historical seed only; not Legacy SR/CCD evidence, phase evidence, mechanism, stability, optimum or pooled efficacy |
+| **B. Kármán headline (dominant, 50–55%)** | Legacy `karman_re100`; target, physical zero and frozen PPO controlled roles; each role is under the Legacy solver/API and geometry; target is the comparator | Principal spatial L2: complete-cycle `E_mean`; secondary separately reported `E_phase8`; exact values `0.085771` vs `0.475206` and `0.112680` vs `0.630878`; `\eta` values optional in text/caption; DTW similarity only as complementary signal annotation (`0.932899` vs `0.625127`, target-normalized) | Geometry-guarded ROI; solver-exact common mask not persisted. L2 is not a validation Level/Stage, DTW is not field equivalence/delay/causality. No V5 pooling |
+| **C. Vortex extension** | Legacy `vortex_lamb`/`vortex_taylor` named visual roles; target/controlled/zero roles are conditional on exact artifact binding and are not presumed jointly audited; event offsets remain literal | Event-relative visual and action trace; no quantitative event L2 currently. DTW, if annotated, is native Vortex signal comparison with its own window | Offsets are event-relative, not phase. No invented event L2; no arbitrary-flow, universal or Kármán-skeleton transfer claim. Quantitative event panel remains dependency-gated |
+| **D. `075` Illusion objective extension** | V5 `ill_075L`, seed 43; separately constructed non-zero target and controlled PPO; physical zero only where exact role is bound; target radius ratio 0.75 | PPO capability visual, with reward/force/DTW status only under exact V5 role and calibration identity; physical zero and field metrics are conditional on exact role artifacts | Historical V5 capability only; target matching is not full-state equivalence, common efficacy or positive Illusion SR. Negative Legacy Illusion SR is separate historical evidence |
+| **E. one degradation indicator (small, optional)** | V5 `kar_re400`, seed 43; controlled versus zero under the V5 periodic field contract | `E_mean` improves while `E_phase8` worsens: `0.177469` vs `0.221541`; `0.490471` vs `0.450626`; `\eta_phase8=-0.08842` | Named diagnostic only, n=1; demonstrates estimand divergence, not cross-Re generalization, failure cause, or a pooled comparison |
+
+**Fixed composition and density hierarchy:** A–D are left-to-right; B is visually dominant. The steady, Vortex and Illusion progression has priority over E. E is optional, may be dropped if it compromises that progression, and if retained is only a small marker/inset attached to B or its caption, never a fifth gallery panel. Explicitly show Legacy/V5 lanes and role labels. Do not include experiment.
+
+### Quantitative provenance rows
+
+| Claim | Exact authority/artifact | Chain, solver/geometry, case/seed/role, Re | Comparator, metric, ROI/window | Evidence state |
+|---|---|---|---|---|
+| Steady discovery chronology | `ROUND1_BOTTOM_UP/01_DRL_CONTROL_AND_CASES.md` chronology; `ROUND1_BOTTOM_UP/04_STEADY_THEORY_AND_CROSSMAP.md`; current steady README/RESULTS and M08 | V5 steady/free-slip, three-cylinder pinball, `Re_D=50`; separate from Legacy Kármán | Accepted steady q_ctl versus uniform/no-body q_in under E_inf_vector/profile status; q_blk nonranking; stationary/reverse contextual only; late/profile, nonperiodic | `read`; authority-bound; not independently recomputed or artifact-audited; full theory deferred to M08 |
+| Legacy Kármán mean/phase headline | M04 §2 ledger; `src/drl_pinball/eval/wake_l2.py`, schema `drl-pinball-wake-l2-v2`; bound Legacy role metadata | Legacy API/solver, `1280×512`, `karman_re100`, code Re100 = `Re_D=50`; target/zero/controlled, frozen Legacy PPO | Registered `-6≤(x-x_s)/D≤14`, `|(y-y_0)/D|≤5`, `x_s=800`; complete-cycle mean `E_mean`; eight independently phased nearest-snapshot `E_phase8`; accepted-crossing window | `read`; current authority values; raw payload and solver-exact mask `artifact-audit deferred` |
+| Legacy Kármán DTW | M04 `dtw_summary.json` rows and `legacy_test/core/dtw_metrics.py` contract | Legacy `karman_re100`; target/controlled/zero; target-normalized six-channel cycle | 30-step window, lag channel 3, target-channel max-abs normalization; similarity, higher is better; native score separate | `read`; role authority; artifact audit deferred; complementary signal metric only |
+| V5 seed/retention context supporting selection | M04 §2; V5 `latest_results_summary.json`, `latest_eval_summary.csv`, Re100 metadata | V5/CelerisLab `2000×600`, `kar_re100`, seeds 41–45, selected seed 45; code Re100 = `Re_D=50` | Best-checkpoint discovery and retained evaluation; no Legacy numerical continuation | `read`; retained historical authority; same-selection model/normalizer audit deferred for a redraw |
+| Vortex visual/event boundary | M07 §§2 and ledger; `DATA_DICTIONARY.md`; reproduction plot manifest; `legacy_test/core/dtw_metrics.py` | Legacy Vortex named Lamb/Taylor cases; transient `SI=800`, `MAX_STEPS=150`; target/control/zero roles conditional | `event_fields.npz`, `relative_offsets=[-10,-5,0,5,10]`; current evaluator lacks event-field L2; native Vortex DTW has no lag and uses final-window roll | `read`; visual navigation and contract authority; raw events not independently verified; event-L2 artifact/evaluator `not-covered`, external roots `external-inaccessible` where applicable |
+| V5 `ill_075L` PPO capability | M07 §3 and ledger; `env_illusion.py`, V5 training/result authorities | V5/CelerisLab `ill_075L`, seed 43; target cylinder radius ratio 0.75, physical radius 15; target and controlled roles | PPO reward/force/DTW capability view under V5 target/calibration; no field L2 unless exact roles pass | `read`; retained historical capability; model/normalizer/target leaf audit deferred |
+| Illusion negative SR boundary | M07 ledger; `src/SR_analysis/CLAIMS.md`, `HANDOFF.md`, standardized Illusion role authority | Legacy `illusion_1L`; SR versus physical zero; separate historical standardized acquisition | Long `480+160` window, native/normalized DTW and mean/phase L2 near equal or slightly worse for SR; historical/negative | `read`; authority-bound negative evidence; not a comparator to V5 PPO and not positive SR |
+| Optional V5 degradation marker | M04 §2 ledger and current field summary | V5/CelerisLab `kar_re400`, seed 43; controlled versus zero; code Re400 | Same periodic field contract; `E_mean=0.177469` vs `0.221541`; `E_phase8=0.490471` vs `0.450626`; `\eta_phase8=-0.08842` | `read`; bounded diagnostic; artifact audit deferred; n=1 and not generalization evidence |
+
+### Figure caption requirements
+
+The caption must say that Fig. 1 is a capability/progression composition, not a common metric comparison. It must identify for every panel: chain (Legacy or V5), solver/geometry where relevant, case and seed, target/reference and role, temporal coordinate (steady late/profile, periodic cycle/phase, or event-relative offset), metric status and comparator. It must explicitly state that the Kármán L2 values are Legacy Re100 field estimands, that DTW is complementary signal similarity, that Vortex offsets are event-relative and have no current quantitative event L2, and that `ill_075L` is V5 PPO capability with target radius ratio 0.75. The caption must prohibit pooled efficacy, arbitrary-flow generalization, positive Illusion SR and experiment-as-evidence. Any retained E marker must be labelled a named V5 diagnostic showing mean/phase divergence, not a failure cause or cross-Re law.
+
+## Claim ladder
+
+**Green — supported at named scope**
+
+- The historical progression is steady discovery → periodic Kármán cloaking → event-relative Vortex demonstration → non-zero-target Illusion PPO capability.
+- Legacy Kármán Re100 target/controlled/zero is closer to its target under both the declared complete-cycle mean-field and eight-slot phase L2 rows, with the exact values and ROI above.
+- Legacy Kármán DTW similarity is higher for controlled than zero under its own target-normalized cycle contract; it complements, rather than replaces, spatial L2.
+- Named Vortex visual roles and V5 `ill_075L` PPO provide bounded extension evidence under separate contracts.
+- Kármán is the selected deep case because it has the full evidence intersection for performance and interpretation.
+
+**Amber — bounded interpretation**
+
+- The cases establish breadth in temporal dynamics and objective: steady is nonperiodic, Kármán periodic, Vortex event-relative and Illusion non-zero-target periodic.
+- Pulse-like Vortex actuation supports a comparable-scale event-response hypothesis in the named cases.
+- The V5 degradation marker shows that mean and phase estimands can diverge under a named cross-Re case.
+- A force-centred sparse-observation execution can be retargeted under named cases, while the positive control-skeleton interpretation remains Kármán/cloak-specific.
+
+**Red — prohibited in this section**
+
+- A pooled efficacy score, common bar, arithmetic combination, replication, validation, agreement or triangulation across these panels or with M06 CCD values.
+- Arbitrary-flow control, continuous/general Re or offset/scale generalization, robustness or universality.
+- Positive Illusion SR, target tracking by SR, or V5/Legacy numerical continuation/equivalence.
+- Vortex event offsets called phase, Vortex event L2 invented, DTW called a physical delay or field equivalence.
+- Illusion visual similarity called full-state equivalence or efficacy over physical zero without exact role artifacts.
+- Steady discovery promoted to Legacy SR/CCD evidence, mechanism, stability or optimum.
+- Experiment included in Fig. 1 or used as quantitative validation.
+
+## Imports, exports and bridge
+
+**Imports.** M03 supplies the chain, role, action, ROI and metric vocabulary. M04 supplies the exact Legacy Re100 L2/DTW headline and V5 seed/retention boundary. M05 supplies positive SR scope limited to Legacy Kármán/cloak. M06 supplies descriptive Kármán mean/dynamic and CCD boundaries, but no numbers are imported into Fig. 1. M07 supplies Vortex event semantics, Illusion PPO capability and negative Illusion SR. M08 supplies steady chronology and the later full steady/theory return.
+
+**Exports to M04/M07.** This section selects Legacy Kármán Re100 as the principal depth case while preserving M04’s field estimands and M07’s event/Illusion boundaries. It exports no cross-case score and no Kármán interpretation to Vortex or Illusion.
+
+**Final bridge.** Fig. 1 establishes capability breadth under named, non-pooled contracts. The next section can therefore begin with the Legacy Kármán field comparison and ask what independent spatial matching shows beyond the wake-signature objective; later modules return to SR/field interpretation and full cross-case metrics without treating the progression figure as a results gallery.
+
+## Genuine blockers, deferrals and coverage ledger
+
+**Genuine blockers for retained figure content:** a quantitative Vortex event-L2 panel is blocked until exact target/control/zero event roles, target identity, common ROI/mask, event window and evaluator output are bound. A quantitative Erase panel is not part of Fig. 1 and remains unsupported under the current historical route. An independently redrawn V5 selected-policy panel requires the matching model, VecNormalize and target artifacts. These blockers do not block the bounded text or the Vortex visual/Illusion capability panels.
+
+**Authority-led deferrals:** raw Legacy Kármán fields, external/symlink-backed Vortex/Illusion payloads, exact solver masks and model/normalizer leaf audits are `artifact-audit deferred` where current authorities bind the role and summary without conflict. No publication-ready figure is claimed to exist.
+
+| Status | Sources inspected and reason | Evidence state |
+|---|---|---|
+| `read` | Round3 rule, master prompt, quality gate, interface ledger and Wave-A audit; Round2 freeze and section style guide; ready Modules 03–08 (especially M04/M07/M08); Round1 DRL/cases, current-document coverage, field/CCD/OID, steady and case-metrics dossiers; current DRL, Legacy acquisition, SR, wake-L2 and steady authorities/manifests | Read directly for this first pass; not independently verified or artifact-audited |
+| `mapped` | Existing reproduction-plot navigation and external role links used to identify candidate visual roles and panel dependencies | Indexed/mapped only; not treated as read or numerical authority |
+| `not-covered` | New CFD/training, new offline Vortex event evaluator, raw NPZ/field arrays, exact event-L2 results, publication panel generation, experiment package, new literature search | Outside scope; no claim or number inferred from these omissions |
+| `external-inaccessible` | Symlink/external raw Vortex/Illusion/Kármán payloads and selected model bundles not exposed in ordinary checkout inspection | Authority-led `artifact-audit deferred`; nonblocking for bounded text, blocking for any new artifact-audit/reproducibility claim |
+
+## Cross-module near-collision check
+
+The Legacy M04 principal PPO field errors (`0.085771`, `0.475206`) must not be compared arithmetically with M06 corrected CCD errors (`0.0857787860`, `0.4694352273`) despite similar magnitudes and nominal x extent. M04 uses three independently acquired target/controlled/physical-zero roles, a geometry guard, unweighted lattice-cell RMS after `U0` normalization, and a complete-cycle/phase8 contract; M06 uses four roles, a retained four-role window, an exact common solver-fluid mask and coordinate-weighted RMS on already nondimensional velocities. They are **different estimands**, not replication, validation, agreement or triangulation. The same prohibition applies to steady profiles, Vortex event observations, Illusion PPO reward/DTW and any proposed common figure bar.
+
+## Self-audit under the current gate
+
+- **Two layers:** Layer 1 has five argumentative paragraphs with transitions and local limitations; Layer 2 carries panel contracts, exact provenance, roles, chains, Re conventions, comparators, estimands, ROI/windows and evidence status. This is a revised candidate for second audit, not a self-readiness declaration; the narrative may be text-ready while retained panels remain artifact-gated.
+- **Coverage:** the controlling Round2 documents, Round1 dossiers and all ready Modules 03–08 were read. The ledger distinguishes read, mapped, not-covered and external-inaccessible; read is not independent verification or artifact audit.
+- **Progression fidelity:** steady appears only as a short historical seed; Kármán is visually dominant and quantitatively exact; Vortex uses event-relative semantics with no invented event L2; Illusion is V5 PPO capability at target radius ratio 0.75; experiment is excluded.
+- **Claim boundaries:** no pooled score, arbitrary-flow/generalization, positive Illusion SR, Kármán interpretation transfer, CCD number import or experiment claim. The negative Illusion SR caveat is local and does not replace the PPO capability statement.
+- **Figure integrity:** every proposed panel has chain, role, comparator and metric status. The Kármán and optional degradation values are not merged with M06 or other estimands. No gallery inventory or common efficacy bar is proposed.
+- **Anti-index / anti-AI check:** the narrative is progression-led rather than a package inventory; numbers appear only when they establish the headline or a visible boundary; figure contracts follow the narrative rather than replacing it; no citation, number, artifact, mechanism or generalization was invented.
+
+**Disposition:** revised candidate for second audit. The bounded text is text-ready for parent review; raw/redrawn panels remain artifact-dependency-gated. Do not label this module self-ready or manuscript-ready.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/03_CONTRACTS_METRICS.md

@@ -0,0 +1,109 @@
+# Round 3 Wave-A revised candidate — Section 2 contracts and metrics
+
+## Section question and bounded answer
+
+**Question.** What must be fixed about the plant, executable chain, actuation, observations, roles and estimands before later comparisons answer the same physical question rather than merely share a label?
+
+**Bounded answer.** Valid comparisons use separate Legacy and V5 executable chains, each with its own plant, action convention, calibration and role artifacts. The policy performs wake-signature matching from forces and sparse downstream velocities; independent field matching uses spatial L2 as the primary evidence and DTW only as complementary, case-specific signal evidence, with periodic, event, mean-field and steady windows kept distinct. This is a revised candidate for second audit, not a ready module.
+
+## Layer 1 — six-paragraph near-prose section draft
+
+### Paragraph 1 — plant and chain
+
+The comparison begins with a declared plant, not with a policy score. The fluidic pinball comprises three ordered circular bodies and a downstream three-probe signature plane, while Kármán and Illusion introduce different target constructions. In the active V5 Kármán chain, CelerisLab uses a `2000×600` D2Q9 FP32 MRT configuration with double-buffer streaming, uniform regularized inflow, `neq_extrap` outlet and free-slip lateral walls. The V5 body order is front, top, bottom; its common lattice convention is `L0=20`, `D=20`, `U0=0.01`, and `Re_code=U0(2L0)/nu`, so `re100` corresponds to `Re_D=50`. V5 Illusion translates the pinball and obtains the non-zero target from a separate target-cylinder acquisition; its historical `target_diam` parameter is passed as a radius ratio. Legacy uses the separate LegacyCelerisLab plant and historical geometry/API, so a shared case label never licenses numerical pooling. [V5 train/env; Legacy role authority]
+
+### Paragraph 2 — actuation, sign and readback
+
+A normalized action becomes a physical rotation only after body order, sign and persistence have been fixed. In V5, `a=(a_front,a_top,a_bottom)` lies in `[-1,1]^3` and maps to
+
+\[
+\omega_i=-\frac{(12a_i+b_i)U_0}{R},\qquad b_i=0,
+\]
+
+with `R=L0/2` and an explicit weight-`0.1` exponential smoother. The negative sign and front/top/bottom order belong in the plant schematic and every downstream action-law comparison. They must not be transferred to Legacy: Legacy SR and acquisition use the native `(front, upper, lower)` ordering, `\alpha=\omega/U_0`, and `Re_D=Re_code/2` for its Kármán notation, with its own action scale/bias and `FlowField.run` persistence. CelerisLab uploads a host-side `set_body` value at the next run; force readback is an `[f_x,f_y]` vector whose time normalization is explicit, while sensor readback is footprint-area averaged and optionally time averaged. [V5 environments; Legacy SR/action authority; CelerisLab API]
+
+### Paragraph 3 — observations, calibration and objective
+
+The execution contract is wake-signature matching rather than an assertion of full-field observability. V5 Kármán supplies six controlled-body force components followed by six velocity channels, ordered as the two components of each of the three probes; V5 Illusion appends reconstructed target drag and lift. Solver readback, calibrated force and sensor scales, and online observation whitening are separate operations: active V5 calibration stores native units, while SB3 `VecNormalize` whitens observations only and must travel with the selected policy. The historical Legacy compatibility path may use `SENSOR_CC=78` before its old-policy scaling; that factor is not active V5 calibration. Roles are likewise explicit: `target` is a reference trajectory, `zero` is physical-zero/uncontrolled, `controlled` is the policy trajectory, and `constant` is a contextual comparator where acquired. Force terms and six-channel sensor similarity form the reward; aggregation and target comparison are case-specific, with V5 Kármán averaging controlled-body forces against zero and V5 Illusion summing them against one target body. [V5 training pipeline; Legacy acquisition authority]
+
+### Paragraph 4 — field matching and signal complement
+
+The independent field comparison is registered before performance is inspected. The current downstream ROI is the fixed rectangle `-6≤(x-x_s)/D≤14` and `|(y-y_0)/D|≤5`, a `20D×10D` box guarded against known solids but not proven by persisted solver masks. For periodic roles, the primary estimand is the `U0`-normalised area-RMS difference between complete-cycle mean velocity fields, reported both absolutely and relative to the same-case zero comparator through `η=1-E_controlled/E_zero`. The eight-slot phase diagnostic uses independently phased centre-probe transverse-velocity crossings and nearest saved snapshots; it is not a repeated-crossing ensemble. DTW remains a complementary sparse-signal measure, not a spatial L2 surrogate, physical delay or causal test. This hierarchy asks separately whether the persistent field and the evolving signature approach the target. [wake-L2 authority]
+
+### Paragraph 5 — case-specific evaluation windows
+
+The estimand changes with the dynamics and must be named in every result row. Periodic Kármán and periodic Illusion can use complete-cycle mean-field L2 and a separately reported eight-slot phase diagnostic, with native or normalized DTW labelled by its own window and formula. Vortex comparisons, if exact roles exist, use event-relative downstream snapshots at declared offsets and retain event labels rather than calling them phase. Erase uses a mean-field comparison only when target, controlled and zero roles are exact; the historical unsupported route is not repaired by relabelling. Steady comparisons use a late snapshot or profile, not a temporal periodic mean. Pipeline `Level-2/Level-3` or `Stage-3 short/standard` terminology must also remain separate from the spatial L2 metric. [case-metric authority; wake-L2 authority]
+
+### Paragraph 6 — compact CFD qualification and scope
+
+The numerical qualification is a compact contract check, not a second results section. The retained CelerisLab K2 rotating-cylinder package uses D2Q9 MRT, FP32, double-buffer streaming, Bouzidi moving boundaries, no LES and `neq_extrap` outlet under the Kan99b open-flow convention; it is a partial pass because the stored mean-lift sign disagrees with the reference even though the accepted frequency, drag and fluctuation observables fall within their declared bands. The retained Sah04 S2 confined-cylinder package provides a named Strouhal check under its parabolic/channel-stabilised, no-slip and realised-Re convention. These anchors qualify selected solver observables only; they do not qualify a DRL policy, SR law, CCD interpretation or cloaking mechanism. Full matrices, hashes, sensitivity rows and smoke diagnostics belong in the supplement. [CelerisLab validation dossier; Kan99b/Sah04 authorities]
+
+## Layer 2 — paragraph and claim-to-evidence ledger
+
+| Paragraph / claim | Exact provenance and contract | Comparator, metric, ROI/window and status |
+|---|---|---|
+| P1: V5 plant | `src/drl_pinball/train/TRAIN_PIPELINE.md` §§1–2; `train/env_karman.py`; `DATA_DICTIONARY.md`; active V5 Kármán, CelerisLab `2000×600`, D2Q9 FP32 MRT, double buffer, regularized uniform inlet, `neq_extrap`, free-slip; body order front/top/bottom; `L0=20`, `D=20`, `U0=.01`; `Re_code=U0(2L0)/nu` | Same matched config/calibration/target for target, zero and controlled; case/seed/role-specific; field window is the registered downstream ROI below; supported executable contract, not independently rerun |
+| P1: V5 Illusion geometry | `train/env_illusion.py` lines 50–60, 157–184; active V5 Illusion target acquisition and translated controlled plant; target cylinder exists only during target construction; `target_diam*L0` is passed as radius | Target versus controlled only under matched target/calibration identity; periodic or case-specific metric later; supported executable contract |
+| P1: Legacy separation | `ROUND1_BOTTOM_UP/01_DRL_CONTROL_AND_CASES.md` §§4–5; `src/drl_pinball/legacy_test/README.md`; Legacy Kármán/Illusion role artifacts and LegacyCelerisLab API | No cross-chain score pooling; Legacy evidence is retained historical unless current artifact says otherwise; read authority, raw payload artifact-audit deferred |
+| P2: V5 action | `train/env_karman.py` `_action_to_omega`; `env_illusion.py` `_action_to_omega`; active V5, action `(front,top,bottom)`, `[-1,1]`, `b=0`, `\omega=-(12a+b)U0/R`, `R=L0/2`, EMA weight `.1` | Record command, applied omega, body ID/order and sign per trajectory; supported source contract |
+| P2: Legacy action/SR convention | `ROUND1_BOTTOM_UP/01_DRL_CONTROL_AND_CASES.md` §§6–7; `src/SR_analysis` current Kármán authority; Legacy Kármán SR, native `(front,upper,lower)`, `\alpha=\omega/U0`, `Re_D=Re_code/2`, distinct scale/bias and `FlowField.run` EMA | Legacy SR comparisons remain Legacy-only; formula/action artifacts and closed-loop trajectory are the comparator; active Kármán scope, read authority |
+| P2: readback | `CelerisLab/README.md` §§API/telemetry; `CELERISLAB_VALIDATION_DOSSIER.md` §§3–4; CelerisLab current solver/API, `set_body` host action uploaded at next run; force `[f_x,f_y]`, `normalize=True` per-step average, sensor area normalization always applied and time normalization separate | Record sampling interval and normalization; no force-tensor transpose; array/API orientation safeguard is stated once here; read authority, implementation not rerun |
+| P3: V5 observations | `train/env_karman.py` module contract and `_normalize_obs`; `env_illusion.py`; active V5, Kármán 12-vector = six forces then six sensor components; Illusion 14-vector adds target `C_D,C_L` | Reward uses the corresponding target role; observation order is not field metric; supported source contract |
+| P3: normalization | `TRAIN_PIPELINE.md` §§4–5; `DESIGN_DECISIONS.md`; active V5 native calibration-v2 scales plus observation-only `VecNormalize`; Legacy compatibility `SENSOR_CC=78` path | Selected policy requires matching normalizer; inference freezes `training=False`; native V5 and Legacy scaling not comparable; supported contract, retained-policy compatibility artifact-audit deferred |
+| P3: roles/reward | `legacy_test/README.md` §§standardized acquisition; `TRAIN_PIPELINE.md` §§3–5; `DESIGN_DECISIONS.md`; target, zero, controlled, constant; Kármán controlled-force mean versus zero, Illusion controlled-force sum versus one target; sensor similarity is reward-adjacent | Target has no policy reward; native DTW and normalized offline DTW retain separate formulas/windows; reward is not field error; supported role contract, exact selected artifacts artifact-audit deferred |
+| P4: ROI | `WAKE_L2_AND_SENSOR_PLACEMENT_RESEARCH_NOTES.md` §§3–5; `src/drl_pinball/eval/wake_l2.py`, schema `drl-pinball-wake-l2-v2`; registered `-6≤(x-x_s)/D≤14`, `|(y-y0)/D|≤5`, `D=20`; geometry guard because solver masks not persisted | Controlled and zero versus target on same case/role window; `U0`-normalised area-RMS; exact solver-mask audit deferred, not a blocker when authority binds ROI |
+| P4: periodic L2 hierarchy | Wake-L2 note §§5–6; `wake_l2.py`; periodic target/controlled/zero roles; `E_mean` is complete-cycle arithmetic mean-field error; `E_phase8` is eight independently phased nearest snapshots; `η=1-E_ctl/E_zero` | L2 primary field matching; mean and phase windows distinct; phase8 not ensemble and DTW not L2; implemented where role schema passes, raw external fields artifact-audit deferred |
+| P5: case-specific semantics | `ROUND1_BOTTOM_UP/08_EXPERIMENT_AND_CASE_METRICS.md` §§4–5; `ROUND2_TOP_DOWN/05_REVISED_STRUCTURE_FREEZE.md` §§2,5; wake-L2 note §§5–7; periodic, vortex event-offset, Illusion, Erase mean-field and steady late/profile contracts | No pooled efficacy/phase score; exact Vortex/Erase roles are needed only for future quantitative panels; current authority defines semantics, event/role payloads artifact-audit deferred |
+| P5: pipeline terminology | `.cursor/rules/jfm-round3-section-drafting.mdc` line 11; relevant package stage/level documentation | `Level-2/Level-3` and `Stage-3 short/standard` are pipeline labels; spatial `L2` is field error; no “L2 gate” wording; current drafting rule |
+| P6: CelerisLab qualification | `docs/JFM_WYQ/CELERISLAB_VALIDATION_DOSSIER.md` §§3,6–10; Kan99b K2 and Sah04 S2 manifest-backed full artifacts; current solver revision recorded by dossier | K2: Kan99b `Re=U∞D/nu`, partial pass due mean-lift sign; S2: Sah04 realised-Re Strouhal check; named windows and artifacts in manifest; qualification evidence, selected artifacts not rerun here |
+| P6: qualification boundary | Same dossier §§5,10–12; `CelerisLab/README.md` FP16S/EsoPull limitations | Selected numerical observables only; no DRL/SR/CCD/mechanism validation; full matrix and hashes supplement; K2 sign issue remains a genuine blocker only for claims using affected lift convention |
+
+## Figure, equation and table contracts
+
+1. **Plant/action/sensor/ROI schematic.** Shows the two lanes, body order, V5 negative action sign, Legacy action distinction, probe plane and registered ROI. It does not establish optimal placement, observability, chain equivalence or a solver-exact mask.
+2. **Legacy/V5 contract table.** Defines solver, geometry, body/action/Re convention, normalization and role names. It does not authorize pooled statistics or transfer of the V5 action map to Legacy SR.
+3. **Definitions block.** Reuses chain-specific Re/action equations, observation/reward role definitions, `E_mean`, `E_phase8` and `η`. It does not turn reward into field error or DTW into delay.
+4. **Compact CFD table.** Gives the selected K2/S2 qualification status and essential configuration; full matrices and artifact identities belong in the supplement. It does not validate policy, SR, CCD or cloaking mechanism.
+
+## Claim ladder
+
+**Green.** Legacy and V5 are separate executable chains; each later comparison must carry its plant, body/action/Re convention, calibration, role, comparator, metric and window. V5 action order/sign/smoothing, readback semantics, observation normalization, role definitions, wake-signature reward, and L2-primary/DTW-complementary hierarchy are executable contracts. K2 is a partial Kan99b qualification and S2 is a named-condition Sah04 solver anchor.
+
+**Amber.** Sparse probes are physically motivated signature monitors, not optimal or fully observable. Reward/DTW can define wake-signature matching, while L2 independently tests registered field matching. Mean, phase, event and steady estimands may support different bounded comparisons under their own roles.
+
+**Red.** Do not pool Legacy/V5 values or transfer V5 action signs/maps to Legacy SR; call DTW a physical delay, causal test or field equivalence; relabel event snapshots as phase; call steady late snapshots temporal means; use a validation Level/Stage as an “L2 gate”; claim solver qualification proves DRL/SR/CCD/cloaking mechanism; or call all Kan99b/Sah04 matrix cases completed.
+
+## Imports, exports, bridge and genuine blockers
+
+**Imports.** Round-2 frozen terminology and hierarchy; Round-1 DRL/action/role and metric dossiers; current V5 environments, training/evaluation and data-dictionary authorities; Legacy acquisition/SR authority; wake-L2 implementation/rationale; and the CelerisLab validation dossier and benchmark specifications.
+
+**Audited exports — exact canonical wording for Modules 04–06.**
+
+- **Legacy/V5:** Legacy and V5 define separate executable evidence chains; never pool their numbers or imply numerical continuation/equivalence.
+- **Action:** V5 uses body order `(front, top, bottom)` and `\omega=-(12a+b)U0/R` with zero bias and weight-0.1 smoothing. Legacy SR uses native `(front, upper, lower)`, `\alpha=\omega/U0` and `Re_D=Re_code/2`; the V5 map does not apply to Legacy SR.
+- **Observation/reward:** Wake-signature matching uses forces plus six sparse downstream velocity observations. Force aggregation and target comparison are case-specific; calibration scales, Legacy `SENSOR_CC=78` compatibility, and V5 observation-only `VecNormalize` are distinct layers.
+- **Evaluation:** Field matching uses spatial L2 as primary evidence and DTW as complementary, signal-level and case-specific evidence. Periodic complete-cycle mean L2, eight-slot phase diagnostics, transient event-offset L2, Illusion/Erase mean-field comparisons and steady late/profile errors are distinct estimands.
+- **Qualification:** CelerisLab qualification is compact and configuration-specific; Kan99b K2 is a partial pass because the mean-lift sign/convention remains unresolved, while qualification does not establish a control or mechanism claim.
+
+**Final bridge.** With these definitions fixed, Module 04 can lead with independent Kármán field matching, while Modules 05–06 can interpret Legacy SR and field structure without silently changing plant, action sign, Reynolds convention, role or metric.
+
+**Genuine blockers.** The Kan99b force/lift sign remains a blocker only for claims that use that affected lift comparison. Exact Vortex/Erase target-control-zero roles remain blockers only for proposed future quantitative panels. A selected-policy reproducibility claim is blocked if its exact model/normalizer/target identity is not bound; authority-led external fields, masks and hashes are `artifact-audit deferred`, not blockers.
+
+## Concise source coverage ledger
+
+| Status | Sources and reason | Evidence state / boundary |
+|---|---|---|
+| `read` | Round-3 revised rule, master and quality gate; Round-2 freeze/style guide; Round-1 DRL, coverage and metrics dossiers; current V5 environment/training/evaluation/data-dictionary authorities; Legacy acquisition/SR authorities; wake-L2 note/code; CelerisLab dossier, README and Kan99b/Sah04 specifications | Read in full for this revision; not independently rerun or universally artifact-audited |
+| `mapped` | Broader package indexes and manifests referenced by the read authorities | Mapped only; not claimed read-full or artifact-audited |
+| `not-covered` | Raw selected model/normalizer/target bundles, external reproduction payloads, solver-exact masks and unretained benchmark matrix cases | Authority-led `artifact-audit deferred`; no values inferred |
+| `external-inaccessible` | External/symlink-backed field roots and source exports not exposed in the visible checkout | Authority-led deferral; no essential internal contract is established from inaccessible material |
+
+## Anti-index / anti-AI audit
+
+- Layer 1 now contains six concise near-prose paragraphs with short source tags; repeated template labels and inline evidence blocks have been removed.
+- Layer 2 carries exact provenance, chain, geometry, role, Re, comparator, metric, ROI/window and status without making the narrative a path inventory.
+- Contracts no longer narrate Kármán performance, SR, CCD or cross-case success; detailed outcomes are retained only where needed to define qualification boundaries.
+- Pipeline Level/Stage terminology is separated from spatial L2, and no validation item is called an “L2 gate”.
+- Authority-led artifact gaps are marked `artifact-audit deferred`; only affected lift-sign claims, exact future Vortex/Erase roles and selected-policy identity can block downstream claims.
+- The action-sign/body-order warning is preserved; the force-array orientation safeguard appears once in the ledger rather than as a repeated `tyx/txy` theme.
+- This is a revised candidate for second audit, not a readiness declaration.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/04_KARMAN_PERFORMANCE.md

@@ -0,0 +1,108 @@
+# Round-3 revised candidate — Kármán performance
+
+**Status:** targeted M04 revision completed; second-audit candidate, not final manuscript approval and not self-declared ready. This revision separates near-prose from provenance, makes Legacy Kármán Re100 the principal result, and retains V5 Re100 only as secondary support.
+
+## Section question and bounded answer
+
+**Question.** Under the named Kármán contracts, what does learned wake-signature matching achieve, and what independent field-matching evidence remains after the signal objective is separated from spatial evaluation?
+
+**Bounded answer.** Under the Legacy `karman_re100` target/controlled/zero contract and its registered downstream ROI, the frozen PPO trajectory is closer to the target than physical zero in both complete-cycle mean-field and eight-slot phase-resolved L2; its normalized six-channel DTW is complementary evidence, not the field claim. V5 Re100 supplies secondary evidence that high-scoring checkpoint discovery repeats across five seeds while late retention varies, so the result remains named-condition field matching rather than a pooled or robust cross-chain conclusion.
+
+## Layer 1 — concise near-prose draft
+
+The principal comparison is the Legacy Kármán Re100 target, physical zero and frozen PPO trajectory, evaluated within one Legacy solver and geometry contract. Here `Re100` is the code convention `U_0(2D)/\nu=100` (`U_0=0.01`, `D=20`, `\nu=0.004`), equivalent to single-cylinder `Re_D=50`; it is not the V5 Re100 case under another name. In the registered rectangle `-6\le (x-x_s)/D\le14`, `|(y-y_0)/D|\le5`, with Legacy `x_s=800`, the controlled field is closer to the Legacy target than the corresponding physical-zero field. [Legacy field authority; Module 03]
+
+The signal result is consistent with that field comparison but does not define it. Under the same 30-step window, lag channel and target-channel normalization, the Legacy controlled role has a six-channel target-normalized DTW similarity score of `0.932899`, higher than the zero role’s `0.625127`; the corresponding native reward-compatible similarity scores are `0.952132` for controlled and `0.688244` for zero. Higher scores indicate greater similarity. These are role-local Legacy quantities, not V5 scores, and they are never interpreted as errors or distances. DTW records signal alignment and similarity; it is not a spatial norm, physical delay or causal response. [Legacy Re100 `dtw_summary.json`; Module 03]
+
+The independent field result is carried by spatial L2. For complete accepted cycles, the Legacy controlled mean-field error is `E_mean=0.085771`, versus `0.475206` for zero, giving `\eta_mean=0.819508`. The corresponding eight-slot phase diagnostic is `E_phase8=0.112680`, versus `0.630878` for zero, giving `\eta_phase8=0.821392`. Here `E_mean` is the `U_0`-normalized area-RMS difference between complete-cycle arithmetic mean fields, whereas `E_phase8` is the RMS over eight independently phased nearest saved boundary snapshots; neither uses a solver-exact persisted common-fluid mask. Thus, for this named Legacy comparator and ROI, the field result agrees across persistent mean and phase-resolved diagnostics, without implying that all downstream flow states are identical. [Legacy `wake_l2.py` row; Module 03]
+
+The agreement has a defined dynamic boundary. Legacy target and controlled roles each contain eight complete-cycle fields and nine accepted crossings, while zero contains four complete cycles and five crossings; the controlled relative frequency mismatch is `0.004831`, compared with `0.376794` for zero. This supports the bounded reading that the controlled trajectory is closer to the target under both declared field estimands, but the phase metric remains a one-snapshot-per-slot diagnostic rather than a repeated-crossing ensemble. The companion V5 `kar_re100` package is secondary: five seeds repeatedly found high-reward checkpoints, and the retained deterministic evaluation selected seed 45 with reward `0.931258` and DTW `0.918458`; late retention ratios ranged from `0.162632` to `0.858143`. This supports a discovery/retention distinction, not Legacy/V5 pooling or a general convergence claim. [Legacy metadata; V5 retained evaluation authority]
+
+The result therefore hands two bounded questions forward. To Module 05, the Legacy Re100 field comparison establishes the performance target for testing whether a reduced action law reproduces the controlled trajectory under the same Legacy plant and window; it does not identify action-law complexity. To Module 06, the exact Legacy mean/phase L2 roles and their separate windows provide the performance baseline for mean/dynamic field organization, while the field metric remains geometry-guarded and descriptive rather than causal. [Module 03; current field authorities]
+
+## Layer 2 — compact provenance ledger
+
+| Claim / quantity | Exact source and artifact | Chain; solver/geometry; case/seed/role; Re | Comparator and metric/estimand | ROI/window and status |
+|---|---|---|---|---|
+| Principal target/zero/controlled roles | `src/drl_pinball/data/reproduction/legacy/karman_re100/{target,zero,controlled}/metadata.json`; schema `drl-pinball-legacy-acquisition-v2` | Legacy solver/API; `1280×512`; `karman_re100`; controlled frozen model `d1a3o12_re100.zip` with frozen `norm.json`; Re code 100 = `U0(2D)/nu=100`, `Re_D=50` | target live builder trajectory; zero physical-zero/uncontrolled counter-bias trajectory; controlled frozen-policy trajectory | `SI=800`, 480 warm-up, 160 post-step boundaries; 8 phase fields; read, authority-bound, artifact-audit deferred for raw payloads |
+| Registered field ROI | `src/drl_pinball/eval/wake_l2.py`, schema `drl-pinball-wake-l2-v2`; Module 03 §4 | Legacy; `D=20`, `x_s=800`, conservative solid extent 636 | fixed inclusive ROI; no outcome-dependent mask | lattice bounds `x=680..1080`, `y=156..355`; geometry-guarded ROI, solver-exact mask not persisted; read and agreed with Module 03 |
+| Legacy complete-cycle mean L2 | Exact `_evaluate` row from current Legacy roles, using `wake_l2.py`; row values reproduced from bound role artifacts | Legacy; Re code 100; controlled vs target and zero vs target; no seed field in Legacy role | `E_mean_ctl=0.08577102245825166`; `E_mean_zero=0.47520632385441813`; `eta_mean=0.8195078260689812`; `U0`-normalized ROI RMS difference of complete-cycle mean fields | accepted rising centre-probe `u_y` crossings; target 9, controlled 9, zero 5; 8, 8 and 4 complete cycles; current authority value, raw artifact audit deferred |
+| Legacy phase L2 | Same exact `_evaluate` row and `phase_fields.npz` role schema | Legacy; Re code 100; controlled/zero versus target | `E_phase8_ctl=0.11267999504986256`; `E_phase8_zero=0.6308775162147815`; `eta_phase8=0.8213916455195072`; eight-slot nearest-boundary RMS | independent role phasing, canonical slots; one snapshot per slot, not repeated-crossing ensemble; current authority value, artifact-audit deferred |
+| Legacy current/normalized DTW similarity | `controlled/dtw_summary.json`, `zero/dtw_summary.json`, `target/dtw_summary.json`; native implementation `legacy_test/core/dtw_metrics.py` and offline metrics contract | Legacy; `karman_re100`; controlled and zero role histories versus target; no V5 transfer | target-normalized six-channel cycle DTW similarity score: controlled `0.9328993565511687`, zero `0.6251268882807846`; native similarity score: controlled `0.9521319744438127`, zero `0.6882437288676819`; higher is better and controlled is higher under both contracts; these are not errors or distances | historical window/`CONV_LEN=30`, lag channel 3, target-channel max-abs normalization; read, current role authority, artifact-audit deferred |
+| Dynamic boundary | Legacy role metadata plus the exact field-evaluation row | Legacy Re100; target/controlled/zero | controlled relative frequency mismatch `0.004831181571494927`; zero `0.3767940098934097`; period CV controlled `0.00020952970987246327`, zero `0.06474211289191471` | physical time is Legacy-relative; relative same-case diagnostic only; bounded observation, not cross-chain frequency evidence |
+| V5 secondary five-seed support | `src/drl_pinball/train/results/latest/tables/latest_results_summary.json`; `latest_eval_summary.csv`; `train/output/kar_re100_seed41–45/meta.json` | V5/CelerisLab; `2000×600`; `kar_re100`; seeds 41–45; code Re100 = `Re_D=50` | best rewards `0.9266385, 0.9301960, 0.9160065, 0.9221958, 0.9411612`; selected retained evaluation seed 45 reward `0.931258`, DTW `0.918458` | 500 iterations; retained evaluation 360 steps, last-180 tail; historical `legacy-policy-v1` compatibility, not current-contract retraining; read authority, artifact-audit deferred |
+| V5 retention support | Same V5 `latest_results_summary.json` retention records | V5; same five named seeds and case | validated last-50 retention ratios `0.6703388, 0.2004286, 0.1626321, 0.8581434, 0.6373129` | training-retention diagnostic; best-versus-retained distinction explicit; normalizer pairing required only for reproducibility/selected-policy panel, not for this textual seed-retention claim |
+| V5 Re400 boundary, if retained in figure | Current summary authority and current wake-L2 summary authority | V5/CelerisLab; `kar_re400`, seed 43; code Re400; support chain only | `E_mean_ctl=0.177469` vs zero `0.221541`, but `E_phase8_ctl=0.490471` vs zero `0.450626`; `eta_mean≈0.1989`, `eta_phase8=-0.08842` | same periodic field contract; current authority diagnostic, artifact-audit deferred; do not use as Legacy principal evidence |
+
+### Authority/interface reconciliation with Module 03
+
+- **Agreement:** Module 03 and `wake_l2.py` agree on `drl-pinball-wake-l2-v2`, registered `[-6D,+14D]×[-5D,+5D]` ROI, `D=20`, `E_mean` as complete-cycle mean-field RMS, `E_phase8` as eight independently phased nearest-snapshot diagnostic, `eta=1-E_role/E_zero`, and geometry-guarded/no-persisted-exact-mask status.
+- **Agreement:** Module 03’s Legacy Re100 role semantics agree with the current metadata: Legacy target is live builder-generated, zero is physical-zero/uncontrolled, controlled is frozen Legacy PPO; Legacy roles use their own chain and are not V5 continuations.
+- **Conflict/clarification:** Module 03 says every role must carry target identity/hash when available; Legacy metadata binds run-generated target-array hashes separately for target, controlled and zero. These hashes differ because the trajectories are independently generated; they must not be treated as one shared target identity without an explicit target-role reconciliation. This is a provenance clarification, not a numerical conflict.
+- **Deferral:** Module 03’s normalizer/VecNormalize contract applies to V5 retained policy reproducibility. It does not condition the Legacy field text above, whose frozen Legacy `norm.json` is directly bound in the controlled and zero metadata. Same-selection V5 model/normalizer verification is therefore a selected-policy reproducibility/panel dependency, not a blocker to the Legacy principal result.
+
+## Figure, equation and table contracts
+
+1. **Principal target/zero/controlled Legacy plate.** Show Legacy Re100 target, zero and controlled fields with chain, role, phase slot/window and fixed vorticity limits. It supports visual comparator context and can accompany the exact L2 rows; it does not prove mask exactness, causality or V5 equivalence.
+2. **L2-first result panel.** Report Legacy Re100 absolute `E_mean`, `E_phase8` and zero-relative `eta` before the DTW companion. Caption must state ROI, `U0`, accepted-crossing window, eight-slot nearest-snapshot semantics and geometry-guarded mask status. It does not establish a universal cloak score or repeated-crossing uncertainty.
+3. **DTW companion.** Show Legacy controlled/zero target-normalized DTW similarity scores and label native versus target-normalized similarity pipelines. State explicitly that higher is better (`0.932899` controlled versus `0.625127` zero normalized; `0.952132` controlled versus `0.688244` zero native) and never label these values as errors or distances. The panel supports signal-level matching under the declared window; it does not become field L2, a delay or a causal test.
+4. **V5 seed/retention inset.** Show best discovery and late-retention spread only as secondary support, with selected seed 45, historical compatibility path and best/retained labels. A same-selection model/normalizer pair is required for a reproducibility or selected-policy panel, not for the textual statement that retention varies.
+5. **Equations.** Use Module 03 canonical `E_mean`, `E_phase8` and `eta` definitions; do not add a second DTW equation here unless Module 03 requires it. Distinguish spatial L2 from any pipeline Level-2/Level-3 or Stage-3 validation gate.
+
+## Claim ladder
+
+**Green — supported at named scope**
+
+- Legacy `karman_re100` controlled is closer to its target than its physical-zero comparator in both the complete-cycle mean-field and eight-slot phase-resolved registered spatial L2 rows above.
+- Legacy controlled target-normalized DTW similarity is higher than zero under the declared role-local normalized cycle contract; native similarity is reported separately, and higher is better for both.
+- V5 Re100 has five retained seeds with repeated best-checkpoint discovery and seed-dependent late retention; this is secondary support, not pooled field evidence.
+
+**Amber — bounded interpretation**
+
+- The Legacy Re100 result is consistent with learned wake-signature matching producing a controlled trajectory whose declared downstream field is closer to target over the registered ROI.
+- Agreement of mean and phase L2 under this Legacy role supports a stronger named-case reading than DTW alone, while phase-slot and mask limitations remain attached.
+- The V5 seed pattern motivates separating discovery from retention and does not transfer a V5 result into the Legacy action-law interpretation.
+
+**Red — prohibited without new evidence**
+
+- A global statement that field matching always survives beyond reward, pooled Legacy/V5 values, or a single cross-chain Kármán score.
+- DTW as physical delay, causal response, field equivalence or mechanism.
+- Robust/general convergence, universal Re transfer, stability, optimal sensor placement, exact solver-mask L2, or statistical uncertainty from the current phase slots.
+- V5 selected-policy reproducibility claims without the matching model/normalizer pair; this restriction does not block the Legacy principal text.
+
+## Imports, exports and bridge
+
+**Imports from Module 03:** canonical role/chain vocabulary; Legacy/V5 solver and Re boundaries; registered ROI; `E_mean`, `E_phase8`, `eta`, phase and mask semantics; spatial-L2 versus pipeline validation-level distinction. This revision reconciles those definitions above and records the one target-hash clarification.
+
+**Exact exports to Module 05 — Kármán action law:** use Legacy `karman_re100` target/zero/controlled as the principal closed-loop performance comparator; preserve its Legacy solver/API, `Re_code=100`/`Re_D=50`, frozen policy and `norm.json`, `SI=800`, 480 warm-up plus 160 retained boundaries, complete-cycle window and role-local target/zero semantics. The field result is a performance arbiter for any reduced law; it does not itself identify a necessary, causal or unique action component.
+
+**Exact exports to Module 06 — Kármán field/CCD:** use Legacy Re100 `E_mean_ctl=0.08577102245825166` versus zero `0.47520632385441813`, `eta_mean=0.8195078260689812`, and `E_phase8_ctl=0.11267999504986256` versus zero `0.6308775162147815`, `eta_phase8=0.8213916455195072`, with the registered Legacy ROI and geometry-guarded mask status. Treat these as separate mean and phase estimands; do not infer action correlation or causality from them. V5 seed/retention and Re400 disagreement remain support-chain context only. Although the standardized PPO and corrected CCD mean errors are numerically close and share the same nominal x extent, they arise from different role acquisitions and role sets, retained windows, masks, and weighting/normalization contracts; they are different estimands, are not combined arithmetically, and must not be described as replication, validation, agreement or triangulation.
+
+**Final bridge.** The named Legacy comparator establishes what the learned policy achieved in the registered Kármán wake; Module 05 can now test action-law compression against that same result, and Module 06 can organize mean and phase field differences without turning the field metric into a causal explanation.
+
+## Genuine blockers and scope-local deferrals
+
+- **No blocker to this section text:** external/symlink-backed raw fields and absent solver-exact masks are `artifact-audit deferred` because current metadata, evaluator code and authority-bound rows identify the roles, comparator, window and exact summary values without conflict.
+- **Panel/raw-audit dependency:** a newly redrawn field panel or independent artifact audit still requires access to the raw role payloads and exact manifest/hash check. Do not claim that this pass performed that audit.
+- **V5 reproducibility dependency only:** same-selection `best_model.zip` plus matching VecNormalize is required to reproduce or redraw a selected V5 policy panel; it does not condition the Legacy principal field/DTW text or the textual seed-retention observation.
+- **No unresolved Module 03 metric conflict:** canonical definitions agree; the target-array hash distinction is recorded as a clarification.
+
+## Coverage ledger
+
+| Status | Sources inspected | Evidence status / reason |
+|---|---|---|
+| `read` | Revised `.cursor/rules/jfm-round3-section-drafting.mdc`; Round3 master and quality; current Module 03; Round1 DRL/control, coverage audit and case-metrics dossiers; `WAKE_L2_AND_SENSOR_PLACEMENT_RESEARCH_NOTES.md`; `RESULTS.md`, `CLAIMS.md`, `WRITING_HANDOFF.md`, `eval/README.md`; `wake_l2.py`; Legacy Re100 metadata and DTW summaries; V5 result tables and Re100 metadata/calibration | Full read; current authority values extracted where stated; raw NPZ/model binaries not independently audited |
+| `mapped` | `data/reproduction_plots/manifest.json`; current plot navigation and external role paths | Role/phase-slot mapping read; derived views, not numerical authority |
+| `not-covered` | New CFD, retraining, external literature, independent mask reconstruction, new panel generation | Outside this revision; no claim depends on them |
+| `external-inaccessible` | External Optane root is symlink-backed and raw field payloads are permission-restricted in ordinary inspection | Authority-led `artifact-audit deferred`; exact role/summary rows were still obtained through the bound evaluator and metadata |
+
+## Anti-index / anti-AI audit
+
+- Layer 1 is five concise prose-like paragraphs with source tags and scientific cadence; it does not contain repeated bold template labels, giant inline evidence blocks or training-path inventories.
+- Layer 2 carries the complete provenance ledger, including chain, solver/geometry, case/role/seed, Re, comparator, metric, ROI/window, status and deferral state.
+- The principal result is Legacy Re100; V5 is visibly secondary, and the 23-row aggregate is not used as the principal claim.
+- L2 remains primary and DTW complementary; native and normalized DTW, mean and phase8, Legacy and V5 are not pooled.
+- Best checkpoint, retained evaluation and late retention are separated; VecNormalize is scoped to V5 reproducibility/panel dependency rather than treated as a universal blocker.
+- No global beyond-reward claim, causal language, generalization claim, invented number or silent target-hash merge is used.
+
+**Disposition:** revised candidate submitted for second audit; not self-declared ready.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/05_KARMAN_SR_LAW.md

@@ -0,0 +1,153 @@
+# Section 5 — Kármán action law: dominant near-constant core and smaller correction
+
+> **Revised candidate — second coordinator audit required.** This module owns the executable Legacy Kármán SR law, its deployment symmetry and bounded term tests. It does not self-declare ready; full steady results belong to Module 08 and field/CCD accounting to Module 06.
+
+## Section question and bounded answer
+
+**Question.** What executable symbolic-regression structure is supported for Legacy Kármán cloaking, and what do its closed-loop arbitration and fixed-window term tests establish?
+
+**Bounded answer.** A symmetry-mapped SR surrogate is documented and passes the named Legacy Kármán formula-deployment validations; its parent-relative deletion tests identify persistent rear counter-rotation as the largest tested contribution, with smaller but non-zero rear-lift feedback. This supports a bounded control-skeleton interpretation under the declared contract, not necessity, uniqueness, mechanism or Illusion transfer.
+
+## Layer 1 — five-paragraph near-prose draft/map
+
+### 1. Question and estimand
+
+Symbolic regression asks whether the frozen PPO action can be represented by a compact, executable observation-to-action surrogate for the named Legacy Kármán cloaking cases. The estimand is controller-level: finite closed-loop wake-signature matching under an unchanged Legacy plant, rather than a model of the flow field or its cause. The imported interface is provisional pending coordinator audit: native action order `(front, upper, lower)`, `alpha=omega/U0`, `Re_D=re_code/2`, force-plus-sparse-sensor observations, and Module 04’s separation of spatial L2 field matching from complementary, case-specific DTW. Offline action error remains a fit diagnostic on PPO-visited states; deployment behavior is the arbiter. [R1-SR; SR authority; provisional Modules 03–04 interface]
+
+This framing makes the next distinction essential: recovering PPO actions is not the same test as executing the recovered law.
+
+### 2. Recovery contract and imposed symmetry
+
+The executable route is Stage 1 trajectory capture, Stage 2 topology discovery and coefficient refit, followed by Stage 3 static checks, a **Stage-3 short gate (40 control steps)** and **Stage-3 standard validation (200 control steps)**. Causal fitting pairs post-state `i` with next action `i+1`, while contiguous trajectory-local splits prevent boundary leakage. The deployed map is
+
+\[
+G(\alpha_F,\alpha_U,\alpha_L)=(-\alpha_F,-\alpha_L,-\alpha_U),
+\qquad
+\alpha_F(x)=\frac{h_F(x)-h_F(Gx)}{2},\quad
+\alpha_U(x)=h_R(x),\quad
+\alpha_L(x)=-h_R(Gx).
+\]
+
+The map imposes reflection symmetry at deployment; it does not show PPO equivariance. Stage-3 CFD, finiteness, action/order/schema compliance and provenance decide whether the formula is executable. [SR pipeline; Legacy interface]
+
+The symmetry map fixes the action space; the canonical expression gives the resulting structure.
+
+### 3. Canonical law and physical translation
+
+The mapped-shared topology A is
+
+\[
+\boxed{\alpha_F=\operatorname{odd}\!\left(-0.381391\,C_{d,\mathrm{rear},a}\right)},
+\qquad
+\boxed{\alpha_U=1.307782\,C_{l,\mathrm{rear},s}-3.431209},
+\qquad
+\boxed{\alpha_L=-\alpha_U(Gx)}.
+\]
+
+Here `Cd_rear,a=(Cd_upper-Cd_lower)/2` and `Cl_rear,s=(Cl_upper+Cl_lower)/2`. The rear law therefore combines a persistent negative upper-action constant with rear-mean-lift feedback, while the front action is an odd-projected rear drag-asymmetry correction. Because `alpha=omega/U0`, the constant corresponds to opposite-sign rear rotations of approximately `3.431209 U0`; the wording describes executable action structure, not a unique physical mechanism. The separate steady analysis supplies only a brief contextual bridge: its disturbance-free deployments are consistent with the order of this rear-rotation magnitude and are owned in detail by Module 08. [SR claims; canonical formula authority; steady context]
+
+The formula’s acceptance must still be stated with the correct comparator semantics.
+
+### 4. Closed-loop arbitration and comparator boundary
+
+The formula-parent evidence is a Legacy SR deployment against the declared Kármán target using the native Legacy DTW contract; it should not be described as though every validation were a same-window PPO/SR/zero acquisition. The reported canonical SR similarities for the 200-control-step named cases are `0.9543, 0.9427, 0.8560, 0.7827` at re-codes `50,100,200,400`; the frozen law also has finite 400-control-step observations `0.952178, 0.944339, 0.863850, 0.833365`. These are formula-deployment results at named cases and windows. Separately, the standardized collector defines comparable `Target`, `PPO`, `SR` and `Zero` roles using 480 warm-up intervals and 160 retained boundaries; exact PPO/SR/zero comparator numbers are not asserted here unless the current role artifacts and proposed panel supply them. The native DTW lag is alignment metadata, not a physical delay, and neither DTW result alone is field matching. [SR claims; Stage-3 runs; standardized Legacy acquisition]
+
+Thus the law is supported as a finite executable surrogate, while the direct role comparison remains a distinct visualization/data dependency.
+
+### 5. Fixed-window term tests and inference ceiling
+
+Parent-relative term deletion keeps the canonical topology, coefficients, Legacy solver/geometry, four named Kármán cases and native DTW window fixed. Removing the rear constant gives the largest listed degradation across re-codes 50/100/200/400 (`ΔDTW≈−0.1065,−0.0939,−0.1785,−0.1911`); removing rear-lift feedback gives smaller but non-zero changes (`≈−0.0288,−0.0417,−0.0614,−0.0489`); the tested front correction has small mixed changes (`≈−0.0065,+0.0006,−0.0052,−0.0252`). The bounded interpretation is therefore a largest-tested persistent rear contribution, secondary rear feedback and weak tested front correction under one fixed short window. These are deletion tests, not causal ablations: they do not establish term necessity, sufficiency, mechanism, uniqueness or universal sensitivity. Illusion SR remains historical/negative and supplies no positive transfer. [SR deletion table; claim ledger]
+
+This action-space ranking exports a narrower field question to Module 06: how do the persistent and smaller dynamic components relate to independently defined field estimands?
+
+## Layer 2 — paragraph notes and claim–evidence ledger
+
+### Paragraph notes
+
+| Paragraph | Claim/role | Exact evidence identity | Chain; solver/geometry | Case/seed/role; Re | Comparator; metric/estimand; window | Status and audit state |
+|---|---|---|---|---|---|---|
+| 1 | SR is an observation-to-action surrogate; offline fit is not acceptance | `src/SR_analysis/README.md`, `CLAIMS.md`, `PIPELINE.md`, `results/README.md`; `tables/offline_action_rmse.md` | LegacyCelerisLab; Legacy Kármán plant; action `front,upper,lower` | `karman_re50/100/200/400`; re-code uses `2D`, so `Re_D=re_code/2`; 197 causally aligned PPO rows/case | PPO-visited next-action RMSE: `1.4435,1.0895,2.2860,2.1699`; diagnostic only; no closed-loop window | Current authority; displayed RMSE is derived view; artifact-audit deferred, non-blocking |
+| 2 | Recovery and deployment contract | `stage_1_infer.py`, `stage_2_fit.py`, `stage_3_validate.py`; `utils/data_contracts.py`, `feature_builder.py`, `g_operator.py`, `formula_schema.py`, `metrics.py`, `provenance.py`; `src/drl_pinball/legacy_test/README.md` | LegacyCelerisLab; Legacy solver/geometry; native action order | Four named Kármán cases; Stage 1 post-state `i`→action `i+1`; formula deployment under `G` | Stage-3 short gate `40` control steps; Stage-3 standard validation `200` control steps; standardized collector `480` warm-up + `160` retained boundaries | Current contract documentation; exact leaf recomputation artifact-audit deferred, non-blocking |
+| 3 | Canonical law and action translation | `article-refit-karman-topology-a-20260718`; `results/catalog.json`; `src/SR_analysis/CLAIMS.md` | LegacyCelerisLab; Legacy Kármán plant | re-code `50/100/200/400`; canonical mapped-shared topology A; `alpha=omega/U0` | Formula is evaluated in closed loop against declared Kármán target; native Legacy DTW where quoted; steady only contextual | Current documented formula identity; formula leaf hash audit deferred, non-blocking; steady details owned by Module 08 |
+| 4 | Formula-parent deployment is distinct from standardized role acquisition | `article-L2-karman-20260718`, `article-L3-karman-20260718`, `article2-long-karman-20260720`; `src/drl_pinball/legacy_test/acquire.py`; `src/SR_analysis/CLAIMS.md` | LegacyCelerisLab; Legacy solver/geometry | Named Kármán cases; formula-parent SR role for July runs; standardized collector roles Target/PPO/SR/Zero | July native `legacy_dtw_v1_abs_n_unclipped` / `legacy_reference_cycle_vs_last_recorded_cycle`; 200 control steps: `0.9543,0.9427,0.8560,0.7827`; 400: `0.952178,0.944339,0.863850,0.833365`; standardized window `480+160` | Current finite/pointwise formula evidence; direct PPO/SR/zero panel numbers are a future dependency if claimed; artifact-audit deferred |
+| 5 | Rear constant ranks largest in fixed-window deletion tests | `article-ablation-formulas-v2-20260718`; `article-ablation-L2-k_front0-20260718`; `article-ablation-L2-k_rear0-20260718`; `article-ablation-L2-k_rear1-20260718`; `article-scaling-L1-v2-20260718`; derived `article2-plotting-package-20260721/tables/term_deletion.md` | LegacyCelerisLab; Legacy solver/geometry | `karman_re50/100/200/400`; canonical parent vs named deletion variants | Same parent-relative native DTW; 40 control steps; rear constant deltas `−0.1065,−0.0939,−0.1785,−0.1911`; rear feedback `−0.0288,−0.0417,−0.0614,−0.0489`; front `−0.0065,+0.0006,−0.0052,−0.0252` | Current bounded ranking; deletion is not causal ablation/necessity; parent/deletion artifact audit deferred |
+
+### Exact canonical formula and symmetry identity
+
+- Formula run: `article-refit-karman-topology-a-20260718` (documented current authority; leaf hash recomputation `artifact-audit deferred`).
+- Native action order: `(front, upper, lower)`.
+- Reflection/action map:
+
+\[
+G(\alpha_F,\alpha_U,\alpha_L)=(-\alpha_F,-\alpha_L,-\alpha_U),
+\quad
+\alpha_F(x)=\frac{h_F(x)-h_F(Gx)}{2},
+\quad
+\alpha_U(x)=h_R(x),
+\quad
+\alpha_L(x)=-h_R(Gx).
+\]
+
+- Canonical deployed law:
+
+\[
+\alpha_F=\operatorname{odd}(-0.381391 C_{d,\mathrm{rear},a}),
+\quad
+\alpha_U=1.307782 C_{l,\mathrm{rear},s}-3.431209,
+\quad
+\alpha_L=-\alpha_U(Gx).
+\]
+
+- `alpha=omega/U0`; rear constant translates to opposite-sign rear physical angular velocities of magnitude approximately `3.431209 U0`. Exact coefficient/formula/source/deployment hashes are bound by current authority/manifests but were not recomputed in this documentation pass: `artifact-audit deferred`, not a blocker.
+
+### Comparator and metric ledger
+
+- **Formula-parent July evidence:** canonical formula deployment against the declared Legacy Kármán target; native Legacy DTW `legacy_dtw_v1_abs_n_unclipped` / `legacy_reference_cycle_vs_last_recorded_cycle`; Stage-3 short gate `40` control steps, Stage-3 standard validation `200`, finite extension `400`; named re-codes `50/100/200/400`; finite/pointwise current evidence.
+- **Standardized August role acquisition:** separately reruns `Target`, `PPO`, `SR` and `Zero` under one Legacy contract, with `480` warm-up intervals and `160` retained post-step boundaries, independent role phase and complete-cycle outputs. It is the appropriate source for a same-protocol PPO/SR/zero comparison. Exact comparator numbers are not claimed in Layer 1 because the current SR authority read here does not expose a complete PPO/SR/zero table for the proposed visual.
+- **Spatial field matching:** Module 04 owns field matching, with spatial L2 primary and DTW complementary/case-specific. The SR native DTW numbers above must not be relabelled as spatial L2 or as field equivalence.
+- **Deletion:** parent-relative formula variants, same Legacy Kármán cases and same 40-control-step native-DTW window. It ranks tested terms; it does not establish causal effect or necessity.
+
+### Claim ladder
+
+**Green — documented/current:** the exact mapped-shared formula and imposed deployment symmetry are documented by current SR authority; the formula-parent Kármán deployments have the named finite DTW observations; fixed-window deletion ranks the rear constant largest among tested terms, with smaller non-zero rear feedback and weak/mixed tested front correction.
+
+**Amber — bounded interpretation:** the law can be organized as a Kármán/cloaking control skeleton with a persistent rear component and smaller observation-dependent corrections; 400-step and named-condition runs are finite/pointwise evidence only.
+
+**Red — prohibited without new evidence:** necessity, sufficiency, causal ablation, mechanism, uniqueness, global optimality, universal Reynolds behavior, DTW as physical delay, SR action fit as field matching, or positive Illusion SR transfer/target tracking/generalization.
+
+## Figure, equation and table contracts
+
+- **Canonical law equation:** defines the deployed surrogate and action signs; it does not establish a governing flow law, mechanism, uniqueness or PPO equivariance.
+- **Symmetry schematic:** makes native order and imposed `G` mapping auditable; it does not prove plant symmetry or training equivariance.
+- **Compact Stage-3 arbitration panel:** separates short gate, standard validation and finite extension from spatial L2 field matching; failed formula candidates remain visible. It does not imply PPO/SR/zero role equivalence.
+- **PPO/SR/zero trace/table:** if included, must use standardized same-protocol role artifacts and state case, role, window, phase and metric; exact comparator data are currently a future panel dependency, not invented here.
+- **Deletion table:** reports parent, variant, deleted term, native DTW, delta, case and 40-step window; caption must say parent-relative term deletion, not causal ablation.
+
+## Imports, exports and bridge
+
+**Imports, provisional pending coordinator audit:** Module 03 plant/action/Re/role/metric definitions and Module 04 Kármán performance/comparator framing. This section imports no modern V5, CCD, OID or positive Illusion SR evidence.
+
+**Exports:** canonical law identity; exact symmetry map and action order/sign; distinction between formula-parent SR deployment and standardized PPO/SR/zero acquisition; finite 200/400 DTW observations; and fixed-window deletion ranking. Module 06 receives the field-accounting question without inheriting a causal interpretation.
+
+**Steady bridge:** the separate steady chain provides contextual magnitude correspondence for the rear constant; detailed steady sweep and theory interpretation are exported to Module 08.
+
+## Coverage, conflicts and deferrals
+
+| Coverage status | Sources/reason | Evidence status |
+|---|---|---|
+| `read` | Revised Round-3 rule/master prompt/quality gate; Round-2 freeze/style guide; Round-1 SR, DRL and coverage dossiers; current SR README/CLAIMS/HANDOFF/PIPELINE/results README/INDEX/catalog; Legacy interface README; SR deletion/RMSE/steady/per-case reader views | Read-full reader authorities; not independently verified or artifact-audited |
+| `mapped` | Archive and historical Illusion navigation, used only for boundary status; current formula/role leaf families identified through authority/catalog | Indexed/mapped is not read or independently verified |
+| `not-covered` | No new literature or CFD; no exhaustive leaf hash recomputation; no complete standardized PPO/SR/zero table asserted | Literature cannot establish internal results; formula identity remains current authority documentation |
+| `external-inaccessible` | External/symlink-backed standardized role payloads and hidden raw fields are not exposed in the normal workspace | Authority-led `artifact-audit deferred`; not a blocker unless needed for a proposed comparator/panel or conflict |
+
+**Conflict/gap:** no authority conflict is currently identified for the canonical Kármán law or deletion ranking. Exact Module 03/04 interface reconciliation remains a coordinator task. A proposed PPO/SR/zero visual additionally requires the complete standardized role comparator/panel data; this module does not invent them.
+
+## Revised-gate self-audit
+
+- **Two layers:** passed structurally; Layer 1 uses short source tags, Layer 2 carries exact provenance and numbers.
+- **Narrative cadence:** five shorter paragraphs, with transitions and local caveats; steady detail removed from the narrative.
+- **Validation vocabulary:** uses Stage-3 short gate/standard validation; spatial L2 remains Module 04’s field metric.
+- **Comparator boundary:** formula-parent SR deployment is separated from standardized Target/PPO/SR/Zero acquisition; missing direct role numbers are marked as a future panel dependency.
+- **Claim discipline:** green wording follows documented authority; hash/leaf audit is deferred, not a blocker; Illusion SR is historical/negative.
+- **Scope/interfaces:** steady is a one-sentence bridge to Module 08; field/CCD interpretation is exported to Module 06; Module 03/04 imports remain provisional.
+- **Status:** revised candidate for second coordinator audit; not self-declared ready.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/06_KARMAN_FIELD_CCD.md

@@ -0,0 +1,111 @@
+# Round 3 revised candidate — Section 6: Kármán correction fields and action-correlated modes
+
+**Status:** REVISE completed; candidate for second audit, not ready.
+
+## Section question and bounded answer
+
+Under the exact Legacy Kármán field-error estimand, what share of the declared zero-to-DRL improvement is associated with the constant reference, what smaller residual remains, and what do CCD modes organize?
+
+Under the stated Legacy ROI, common mask and mean-field window, the constant mean accounts for `93.42%` of the measured zero-to-DRL target-error reduction, leaving a `6.58%` constant-to-DRL increment. A separately centred, non-paired residual is phase-coherent and descriptively organized into **action-correlated correction-field modes**; in the preferred pinball-inclusive derived sibling, raw weighted POD spans essentially the same rank-3 field subspace. These are scalar estimand and descriptive association statements, not energy or explained-variance partitions, paired counterfactuals, causal effects, response times, mechanisms or CCD superiority.
+
+## Layer 1 — six concise near-prose paragraphs
+
+### 1. Four roles define the comparison
+
+The field comparison starts with four roles: the target mean, passive zero-action mean, constant-mean control and DRL control. In the Legacy `karman_re100` case, with `Re_D=Re_code/2` under the Legacy `2D` reference and body order `(front, upper, lower)`, all four means are compared on the inclusive wake ROI `34 <= x/D <= 54`, `|y/D| <= 5`, using the exact intersection of their solver-fluid masks and a coordinate-weighted velocity error relative to the target mean. The constant arm is therefore a reference comparator in one declared estimand, not a paired intervention. [M03; CCD authority]
+
+Although Module 04's standardized PPO errors and this corrected CCD ledger have the same nominal x extent and numerically close values, they use different role acquisitions and role sets, retained windows, a geometry guard versus an exact four-role common mask, and an unweighted `U0`-normalized metric versus a coordinate-weighted metric on already nondimensional velocity. They are different estimands: their values are never combined or described as replication, validation, agreement or triangulation. [M04–M06 reconciliation]
+
+This fixes the denominator before the fields or modes are interpreted: the comparison is Legacy-specific and must not be pooled with the V5 contract or with steady, transient or Illusion metrics.
+
+### 2. The mean fields show where the measured reduction occurs
+
+The target error is zero by construction. The corresponding ROI mean errors are `E_zero=0.4694352273`, `E_constant=0.1110140739` and `E_DRL=0.0857787860`. The mean-field comparison therefore shows a large zero-to-constant change and a smaller constant-to-DRL adjustment under the same target comparator. The statement is about registered mean-field error only: it does not identify an actuator cause, establish feedback necessity or close a momentum or energy budget. [CCD ROI authority]
+
+The mean-field panel and scalar ledger should precede the residual and mode panels, so that the dynamic analysis answers a narrower follow-up question rather than replacing the primary field result.
+
+### 3. The 93.42/6.58 values are scalar error-difference shares
+
+The proportions are defined from the ordered scalar differences, not from field energy. With `E_0`, `E_C` and `E_D` denoting the three errors above,
+\[
+S_C=100\frac{E_0-E_C}{E_0-E_D}=93.42\%,
+\qquad
+S_D=100\frac{E_C-E_D}{E_0-E_D}=6.58\% .
+\]
+Thus the precise wording is that the constant mean accounts for `93.42%` of the measured zero-to-DRL ROI target-error reduction, while the remaining DRL increment is `6.58%`. The denominator is the scalar error difference `E_0-E_D`; these percentages are not explained variance, energy share, causal contribution or term attribution. [CCD ROI authority; M03 metric boundary]
+
+The ledger consequently motivates a reference-residual analysis, but does not turn the residual into an isolated physical response.
+
+### 4. Separate centring leaves a non-paired phase-conditioned residual
+
+The corrected CCD uses `19` retained DRL cycles and `10` phase bins (`N=190`). The constant phase template is its own 19-cycle ensemble mean, and each role is centred over its own retained ensemble before subtraction:
+\[
+U_{c,b}=(q^D_{c,b}-\bar q_D)-(\hat q^C_b-\bar q_C).
+\]
+The DRL and constant cycles are not paired. The construction uses no cross-role cycle pairing, Fourier resampling, lag, wrap or temporal-PSD interpretation. It removes the constant-template backbone in the declared reference sense and supplies a descriptive phase-conditioned field for association with the same-boundary DRL effective action; it does not isolate a causal DRL field, additive force or actuator response. [CCD math authority]
+
+The residual is therefore the input to organization analysis, not a counterfactual claim about what DRL changed in a matched realization.
+
+### 5. CCD organizes residual fields by action association and phase
+
+Weighted CCD relates the centred residual snapshots to the centred same-boundary DRL effective-action observable. Its supported output is a rank-3 descriptive field subspace whose action-side coordinates are presented as `front`, `rear-symmetric` and `rear-antisymmetric`, with phase reconstructions used to show how the residual is organized over the retained periodic coordinate. The physical output term is **action-correlated correction-field modes**. Mode signs are globally arbitrary, and body-local rotation or parity displays are diagnostics rather than wall-vorticity or mechanism measurements. [CCD result/figure authority]
+
+This is complementary to, not a derivation of, the SR law. Module 05’s rear-constant and rear-feedback ranking is an observation-to-action result under its own deletion and DTW contracts; CCD action coordinates are field/action association coordinates under the residual contract. The two estimands may be compared only as a brief, descriptive bridge.
+
+### 6. Raw POD sets the boundary on CCD’s added field information
+
+For the same centred residual object in the pinball-inclusive derived sibling, raw full-fit weighted POD is computed without using the action observable to choose its basis. The leading rank-3 principal cosines are approximately `1`, so CCD and POD span essentially the same tested field subspace. CCD’s bounded added information is therefore the action-coordinate association and phase organization of that subspace, not a distinct or superior field basis. This remains one corrected parent lineage and does not establish causality, response time, mechanism, generalization or CCD superiority. [CCD derived publication]
+
+The section exports a mean-dominant field ledger plus a smaller descriptive residual organization; later synthesis must preserve the separate SR, steady, V5 and OID boundaries.
+
+## Layer 2 — compact provenance and diagnostics ledger
+
+| Claim or object | Exact provenance and identity | Contract: chain, solver/geometry, case/role, Re | Comparator, metric/estimand, ROI/window | Status and audit state |
+|---|---|---|---|---|
+| Four-role mean comparison | `src/CCD_analysis/RESULTS_INDEX.md`; `FINAL_RESULTS.md`; ROI result schema `ccd-karman-roi-mean/v2`; manifest `f7f6141042678e52314a4d8f76d589108da8e844c8ce504f8f523a6f88a17e73` | LegacyCelerisLab; Legacy fluidic pinball; `karman_re100`; target, zero, constant mean, DRL; `Re_code=100`, `Re_D=50` | Coordinate-weighted RMS target error of retained role means; exact four-role common solver-fluid mask; inclusive `34<=x/D<=54`, `|y/D|<=5`; retained mean window | Current authority; artifact-audit deferred because authority binds result and manifest without conflict |
+| `E_zero`, `E_constant`, `E_DRL` | Same ROI-mean result and `FINAL_RESULTS.md` | Same Legacy contract; zero, constant mean and DRL roles | `0.4694352273`, `0.1110140739`, `0.0857787860`; target error is zero by construction | Current sourced values; derived share arithmetic is bounded and not independently triangulated |
+| `93.42%` and `6.58%` | Derived scalar ledger from the three current ROI errors; definitions in `MATHEMATICAL_DERIVATION.md` | Same Legacy contract | `(E_0-E_C)/(E_0-E_D)` and `(E_C-E_D)/(E_0-E_D)`; scalar error differences only | Bounded current interpretation; not energy, explained variance, causality or term share |
+| Residual definition | `MATHEMATICAL_DERIVATION.md`; `CORRECTED_MATH_CONTRACT.md`; corrected result schema `ccd-karman-cycle-template/v1`; manifest `b114fbcc5f821034829ca3771ac5ba13df4b75df312b0615b662f81a9e5737d8` | LegacyCelerisLab; Legacy `karman_re100`; 19 DRL cycles, 19 constant cycles, 10 bins; `N=190`, `Q=1`; DRL and constant roles not paired | Separately centred `U_(c,b)` against constant 19-cycle phase template; corrected wake-only field dimension `M=160400`; retained phase/cycle window | Current validated wake-only sibling; artifact-audit deferred, nonblocking |
+| CCD organization | Corrected wake-only result above; preferred derived pinball result `pinball-domain-20260809T1925+0800`, schema `ccd-karman-pinball-domain/v1`, result manifest `7e107a895364ed3e34abf2be513a3ce9e12736766ec6383c5b831891802d5828` | Same corrected Legacy parent lineage; pinball-inclusive domain `29<=x/D<=54`, `|y/D|<=5`; same `19×10` samples and action observable | Weighted CCD action association; descriptive phase reconstructions; coordinates `front`, `rear-symmetric`, `rear-antisymmetric` | Preferred derived result; not independent triangulation or new CFD |
+| Reader-facing mode panels | Preferred derived publication `publication-pinball-domain-20260809T1925+0800`; publication manifest `31888f8eeb6c70dd9f0ff3449fa879f44abf381338ec261b0e45f69603691fdd`; `01`–`04` figure groups | Derived from corrected parent; pinball-inclusive reader domain; plot arrays use `(x index,y index)` | `01_domain_estimand` precedes `02_ccd_mode_identity`, `03_phase_reconstruction`, `04_raw_pod_vs_ccd`; fixed partitions are registered coordinates | Preferred reader view; source arrays remain authority-led `artifact-audit deferred`, nonblocking while documented result/panel claims remain bound |
+| CCD diagnostics moved out of Layer 1 | `RESULTS_INDEX.md`, `FINAL_RESULTS.md`, `EXECUTION_CHECKPOINT.json` | Same Legacy corrected lineage; wake-only `M=160400`; pinball sibling `M=198528` | Wake strengths `0.0174141920`, `0.0069694895`, `0.0010500356`; least-favourable rank-3 projector cosine `0.9947903592`; leave-one-cycle-out leading cosine `0.9997247674`; pinball principal cosines `0.9999616609`, `0.9998971005`, `0.9976439804`; minimum declared pinball stability cosine `0.9974651867` | Descriptive diagnostics; singular strengths are not energy or explained variance; no independent triangulation |
+| Array and sign safeguards | `src/CCD_analysis/FIGURES_AND_DATA.md`; `src/pv_plot/README.md`; `src/OID_analysis/PHYSICS_CONTRACT.md` | Legacy CCD stored field orientation is `txy` (`T,NX,NY`); modern V5 evaluator orientation is `tyx` (`T,NY,NX`); body order `(front, upper, lower)` | Publication arrays `(x,y)` are displayed with transpose; action sign conflict in OID material remains unresolved and is not imported as CCD evidence | Current boundary; no silent transpose or sign reconciliation |
+| SR and performance bridge | Module 05 `05_KARMAN_SR_LAW.md`, especially its exports and deletion boundary; Module 03 `03_CONTRACTS_METRICS.md`; Module 04 standardized PPO mean/phase8 contract | Legacy SR only; executable observation-to-action surrogate, `alpha=omega/U0`, `Re_D=re_code/2`; CCD same Legacy case but distinct residual/action estimand | SR uses formula deployment, native DTW and parent-relative fixed-window deletions; CCD uses weighted field/action association under M06's corrected four-role coordinate-weighted mean-field estimand. M04 standardized PPO `E_mean` and phase8 are separate estimands and cannot validate or numerically close the M06 ledger | Reconciled interface; no SR derivation or numerical SR result duplicated here. Module 05’s direct standardized PPO/SR/zero panel remains a separate dependency if later proposed |
+| OID boundary | `src/OID_analysis/README.md`, `SCIENTIFIC_RESET.md`, `PHYSICS_CONTRACT.md`, `HANDOFF.md` | Active OID method core is claim-free; archived Legacy material remains historical/conditional | No active positive OID result, action importance, mechanism or control-authority comparison | Claim-free boundary; unresolved historical sign conflict retained |
+
+**Source versus derived identity.** The validated wake-only corrected sibling is the primary CCD result authority (`cycle-template-ccd-review-fix-per-cycle-20260808T1736+0800`). The pinball-inclusive result and `publication-pinball-domain-20260809T1925+0800` are preferred derived result and reader publication siblings. The latter do not replace the former, and their near-equivalence does not constitute independent triangulation. Canonical alias/promotion choice is not needed for the manuscript-facing wording because both exact identities are stated.
+
+## Figures, equations and table contracts
+
+- **Mean-field figure and scalar ledger, first.** Shows target/zero/constant/DRL means and the exact error-difference ledger. It cannot establish causality, energy share, mechanism or necessity.
+- **Residual definition/equation.** Defines the separately centred, non-paired phase-conditioned residual. It cannot establish a paired counterfactual, additive force or lag.
+- **Mode identity and phase reconstruction.** Shows action-correlated correction-field modes, action coordinates and phase organization. It cannot establish wall vorticity, action sign authority, response time or mechanism; the rotation proxy is visualization-only.
+- **Raw POD comparison.** Shows near-equivalent rank-3 subspaces in the derived pinball-inclusive object. It cannot establish CCD superiority or explained variance from CCD singular strengths.
+
+## Claim ladder
+
+**Green:** the exact Legacy mean errors, the scalar difference-share definition, the corrected non-paired residual contract, and the documented rank-3/action-coordinate organization under the named artifacts.
+
+**Amber:** the constant mean accounts for most measured reduction; the residual is phase-coherent and organized descriptively by action-correlated correction-field modes; CCD adds action-coordinate interpretation to a POD-equivalent tested field subspace.
+
+**Red without new evidence:** causal response, paired counterfactual, mechanism, response time, momentum restoration, energy/explained variance, term necessity, unique physical modes, CCD superiority, generalization, uncertainty, positive OID, or transfer to V5/steady/Illusion.
+
+## Interfaces, coverage and genuine blockers
+
+**Imports reconciled.** Module 03 fixes the Legacy/V5 separation, Legacy body/action/Re conventions, role semantics and spatial-L2/DTW distinction. Module 05 exports the Legacy SR law, its fixed-window deletion boundary and a brief control-skeleton context. The only interface mismatch requiring parent awareness is scope, not evidence: Module 05 owns the observation-to-action law and term ranking, whereas this module owns M06's corrected four-role coordinate-weighted mean-field estimand and residual organization. The SR law and CCD action coordinates are different estimands and must not be equated. Module 04's standardized PPO `E_mean` and phase8 are also separate estimands and cannot validate or numerically close the M06 ledger.
+
+**Exports.** Exact mean errors and `93.42/6.58` semantics; Legacy ROI/mask/window; non-paired `19×10` residual; rank-3 and action-coordinate identity; source-versus-derived lineage; POD boundary; and the bridge that the residual is descriptively action-correlated. No positive OID export.
+
+**Coverage ledger.** `read`: revised Round3 rule/master/quality; current Modules 03 and 05; Round2 freeze/style; Round1 field/CCD/OID and coverage dossiers; current CCD README, handoff, results index, derivation, claims, figures/data, final results, contracts, checkpoint and catalog; active OID reset/contract docs; current SR claims/handoff. `mapped`: current authority references to external dense result/publication parents and their reader copies; mapping is not read or independently verified. `not-covered`: raw dense arrays and universal leaf-hash recomputation, deferred because current authorities bind exact roles, results and publication identities. `external-inaccessible`: external dense payloads not exposed in the normal workspace; this is an authority-led `artifact-audit deferred` status, not a blocker.
+
+**Genuine blockers.** None for the bounded wording. A blocker would arise only if a proposed figure could not be sourced/redrawn from the documented publication/data contract, or if a source conflict changed the role, comparator, window or claim. The OID sign conflict remains quarantined and does not affect this CCD claim ceiling. Canonical alias/promotion remains outside the wording requirement and is nonblocking.
+
+## Revised-candidate audit
+
+- Layer 1 now contains six concise near-prose paragraphs with short source tags and no inline evidence-contract blocks.
+- Exact hashes, dimensions, singular strengths, stability diagnostics, orientation and source/derived identities are confined to Layer 2 or compact contracts.
+- Module 03/05 coverage is corrected to `read` and reconciled; SR derivation and detailed deletion results are not duplicated.
+- External artifact audit and canonical promotion are recorded as nonblocking deferrals, not blockers.
+- The `93.42/6.58`, non-pairing, descriptive CCD, POD, OID and `tyx/txy` semantics remain explicit.
+
+**Disposition:** revised candidate for second audit; not ready.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/07_CROSS_CASE_EXTENSIONS.md

@@ -0,0 +1,137 @@
+# Round 3 — Cross-case extensions beyond periodic cloaking
+
+**Coordinator disposition — PASS, ready for downstream import but not final prose.** Vortex event-L2 and Erase quantitative panels remain blocked/conditional on the exact dependencies recorded below. This module asks what changes when the periodic Kármán cloaking task is made transient, when the declared target is non-zero, and when the objective is changed again to erasure. It preserves the two-layer architecture: Layer 1 is an author-readable section map; Layer 2 is the local provenance and audit ledger.
+
+## Section question and bounded answer
+
+**Question.** What changes when periodic Kármán cloaking is extended to a nonperiodic incoming vortex and when the objective changes from cloaking to illusion or erase?
+
+**Bounded answer.** Named PPO demonstrations support two distinct extensions: event-relative control beyond periodic phase for comparable-scale vortex disturbances, and retargeting or erasure beyond background matching under their own case-specific roles and metrics. They do not establish arbitrary-flow universality, transfer of the Kármán control skeleton, positive Illusion SR, or one common efficacy score.
+
+## Layer 1 — concise near-prose section draft
+
+### 1. Transition: the task changes in two independent ways
+
+The cross-case comparison should change one contract dimension at a time. Kármán cloaking compares a periodic disturbance with a declared background/reference; the Vortex cases remove the usable cycle coordinate and replace it with an incoming-event coordinate, whereas Illusion keeps a periodic target construction but replaces the near-zero/background objective with a non-zero target signature. Erase changes the reference once more: the desired state is a declared clean or erased signature rather than a Kármán target. The action interface and sparse wake-signature observations remain useful descriptors, but the comparison is no longer a common score. This is a transition from phase-indexed wake-signature matching to event-relative or target-field matching, not a generalized theory of control. [R1-DRL/cases; R1-metrics; R2-freeze; M03]
+
+**Fixed/change ledger for the manuscript.** Keep the Legacy scene and its action/normalization conventions attached to the named demonstrations; keep force and sparse downstream sensing as execution context; and keep spatial L2 primary whenever a valid field role exists. Change the temporal coordinate from complete-cycle phase to event-relative acquisition for Vortex, and change the target from background/near-zero to a declared non-zero field/signature for Illusion. For Erase, change the comparator and target semantics again. Do not import Kármán SR or CCD modes as interpretations of Vortex, Illusion or Erase: Modules 05–06 provide comparison context only. [M03; M05; M06]
+
+### 2. Kármán → Vortex: event-relative extension without arbitrary-flow generality
+
+The Vortex demonstration is best read as a pulse-response extension of the Legacy Kármán execution interface. The current case labels are `vortex_lamb` and `vortex_taylor`, with acquired variants including `vortex_lamb_y000`, `vortex_taylor_ym2L`, `vortex_taylor_ym1L`, `vortex_taylor_y000`, `vortex_taylor_yp1L` and `vortex_taylor_yp2L`; the action scale is the Vortex-specific `\(\omega/U_0=4a+[0,-4,+4]\)`, and the Legacy acquisition is transient with `SI=800` and `MAX_STEPS=150`. These labels and offsets must remain literal. The event artifact is `event_fields.npz`, whose `relative_offsets` are not periodic phase slots; the current plot navigation exposes `relative_offsets=[-10,-5,0,5,10]` around the controlled-role canonical event peak. These are event-relative sample offsets, not periodic phases. Layer 1 therefore retains only the named visual capability and pulse-like action interpretation; any quantitative event comparison is conditional on a later role audit and offline evaluator. [R1-DRL/case matrix; Legacy DATA_DICTIONARY.md; reproduction-plot manifest]
+
+A future quantitative statistic would be a downstream-region event-snapshot L2 at each named event-relative offset, but no quantitative Vortex L2 belongs in Layer 1 now: current `wake_l2.py` does not support `event_fields.npz`. Computing it would require new offline code plus audited target, controlled and physical-zero event roles, target identity, common ROI/mask and event window. The existing/new DTW remains complementary and must retain the Vortex contract: the current Legacy implementation has no lag and rolls the final window by `current_step+1`; it is a signal comparison, not physical delay or field equivalence. If those exact roles are absent, the visual capability remains a bounded observation and the event-L2 result is a drafting gap, not a number inferred from a plot. [R1-metrics; legacy_test/core/dtw_metrics.py; wake_l2.py boundary]
+
+Pulse-like actions make a bounded comparable-scale hypothesis plausible: an incoming Lamb or Taylor disturbance can be met by transient actuation in the named scenes. They do not show that arbitrary incoming flow, arbitrary amplitude, arbitrary offset or unseen vortex family is controlled, and they do not transfer the periodic Kármán action skeleton. The relevant next question is whether matched event acquisitions across disturbance scale and offset preserve the event-relative field comparison—not whether one transient panel establishes universality. [R1-DRL/cases; R2-freeze]
+
+### 3. Cloak → Illusion: a non-zero target changes both reward reading and field evaluation
+
+Illusion should be defined locally as matching a declared non-zero target signature or field, not as reducing a wake toward the physical zero. The target is a separately constructed periodic target-cylinder signature, including target force/harmonic information and the target sensor trajectory; the controlled pinball trajectory is evaluated against that target, with physical zero retained only as a separate comparator where its exact role is acquired. The named historical V5 PPO demonstration `ill_075L` (retained seed 43) is suitable as the main-text capability example. Its documented main-text evidence is capability-level reward/force/DTW and visual material; an independent field-L2 claim or panel is conditional on current field-role authority and should not be implied here. The Legacy `article-joint-data-illusion-20260718` manifest is a separate historical target-construction authority and must not be used to identify or numerically continue the V5 run; the retained size points remain case-specific demonstrations. Their reward/DTW and force behavior show capability and difficulty, not a cross-size law. [V5 env_illusion.py/training authority; article-joint-data-illusion-20260718 manifest; DRL claim ledger]
+
+For a periodic Illusion field panel, report complete-cycle mean L2 and phase8 L2 separately, with target, controlled and physical-zero roles explicitly separated; add normalized DTW only under the exact role, channel-normalization and window contract. Mean L2 asks about the persistent target field, phase8 asks about independently phased nearest snapshots, and normalized DTW asks about the declared sensor/target signal. They are related diagnostics within an Illusion acquisition only if the role set and windows match; they are not one efficacy score and cannot be pooled with Kármán, Vortex event L2, M06’s corrected four-role mean ledger, or steady profiles. Apply the near-collision gate to any similar L2/DTW values: compare acquisition, role set, ROI/domain, mask, weighting/normalization and window before using the values, and classify them as the same estimand, a related diagnostic or a different estimand. [M03; M04; Illusion manifests; near-collision interface]
+
+The Illusion PPO capability should be paired locally with the negative SR boundary, without treating the two as a direct comparator. In a different Legacy chain and role acquisition, the standardized `illusion_1L` SR result was effectively equal to physical zero over the declared long window. This is historical/negative evidence against promoting Illusion SR, while the V5 `ill_075L` PPO result remains a separate named historical capability demonstration. [SR CLAIMS.md; standardized Illusion role authority]
+
+### 4. Illusion → Erase: objective extension, failure envelope and bridge
+
+Erase changes the target/reference again. A defensible Erase result would define the clean or declared erased mean field and compare controlled and physical-zero roles to that target using mean-field L2, with DTW complementary only where the exact target, control and zero streams, normalization and window are documented. The historical Legacy route is explicitly unsupported: its evolving controlled-force FIFO was used as a target and no exact independent target-scale mapping exists. The plot manifest’s `erase` entries therefore do not authorize exact roles merely because filenames are present, nor do they revive unsupported Legacy erase evidence. If an authority later binds exact role artifacts, the figure can include an Erase mean field and case-specific DTW; until then the result is a gap/visual-navigation boundary, not quantitative efficacy. [Legacy legacy_test/README.md; R1-metrics; reproduction-plot manifest]
+
+The force-centred extension is useful but deliberately approximate. Near-zero resultant force motivates cloak as background suppression; target-force matching motivates Illusion and Erase at the observer/reward level. This does not imply that force matching determines the downstream field, and unresolved small structures and higher-Reynolds-number effects bound the approximation. The cross-case lesson is thus about objective and evaluation contracts: the same broad force-plus-sparse-observation execution can be retargeted, but neither the Kármán control skeleton nor a common L2/DTW efficacy score follows with it. The later steady section should return to steady only as contextual reference for the Kármán near-constant component, not as a bridge that closes these transient or objective-transfer gaps. [R1-DRL reward rationale; M05–M06 scope boundaries; R2-freeze]
+
+## Layer 2 — local provenance ledger
+
+| Claim/object | Exact source or artifact | Chain, solver/geometry, case/seed/role, Re | Comparator, metric/estimand, ROI/window | Evidence status and boundary |
+|---|---|---|---|---|
+| Fixed/change architecture | `ROUND2_TOP_DOWN/05_REVISED_STRUCTURE_FREEZE.md` §§2,5; `03_CONTRACTS_METRICS.md` §§4–5 | Legacy/V5 kept separate; periodic Kármán, transient Vortex, periodic Illusion, Erase candidate | Periodic complete-cycle mean/phase8, event-offset L2, Illusion target metrics, Erase mean-field; no pooled score | `read`; definitions and manuscript boundary, not internal result authority |
+| Vortex scene and action labels | `ROUND1_BOTTOM_UP/01_DRL_CONTROL_AND_CASES.md` §§4,6; `src/drl_pinball/DATA_DICTIONARY.md`; `src/drl_pinball/legacy_test/README.md` | LegacyCelerisLab; `vortex_lamb`/`vortex_taylor`; offsets `y000`, `ym2L`, `ym1L`, `yp1L`, `yp2L`; Vortex action `\(\omega/U_0=4a+[0,-4,+4]\)`; Re inherited/documented from Legacy transfer, not reinterpreted here | `SI=800`, `MAX_STEPS=150`; transient event roles, not periodic phase | `read`; named contract. No arbitrary-flow or universal transfer claim |
+| Vortex event artifact/offset | `src/drl_pinball/data/reproduction_plots/manifest.json` entries `vortex_lamb_y000` and `vortex_taylor_*`; `DATA_DICTIONARY.md` `event_fields.npz` | Legacy plot navigation; target/controlled/physical-zero entries; `relative_offsets=[-10,-5,0,5,10]` around the controlled-role canonical event peak | Future per-event downstream ROI L2 at named offsets; current plot is derived navigation only; `wake_l2.py` lacks event-field support | `read`; manifest is navigation, not authority for audited quantitative role comparison; raw event NPZ/evaluator output not independently verified; `artifact-audit deferred` |
+| Vortex DTW semantics | `src/drl_pinball/legacy_test/core/dtw_metrics.py`, summarized in R1 metrics dossier | Legacy transient Vortex; target/state sensor histories; no periodic phase | Native Vortex DTW has no lag and rolls final window by `current_step+1`; complementary signal metric | `read`; code contract, not rerun. Not delay/causality/field equivalence |
+| Vortex quantitative gate | `ROUND1_BOTTOM_UP/08_EXPERIMENT_AND_CASE_METRICS.md` §§4.2,5.2,9; `ROUND1_BOTTOM_UP/01_DRL_CONTROL_AND_CASES.md` §§171–196 | Exact target/control/zero event roles required; same chain and target identity required | Per-event downstream ROI L2 at acquired offsets; event labels preserved; current `wake_l2.py` does not evaluate event fields | `read`; exact roles/evaluator authority are a module-specific blocker for any retained quantitative Vortex number/panel. Visual capability remains documentable |
+| Illusion PPO capability | `src/drl_pinball/train/env_illusion.py`, `TRAIN_PIPELINE.md`; `src/drl_pinball/CLAIMS.md` DRL-C4; `src/SR_analysis/data/runs/article-joint-data-illusion-20260718/illusion/illusion_0.75L/manifest.json`; retained V5 `latest_eval_summary` authority | V5 Illusion `ill_075L`, seed 43 retained demonstration; V5 target construction and controlled plant are separate; target radius ratio `0.75` (physical radius `15`, diameter `30` at `L0=20`); V5 code Re100 / `Re_D=50` where applicable, not Legacy-equivalent | PPO reward/force/DTW capability view; not independent field efficacy row unless exact field roles pass | `read`; retained historical named demonstration; target/model artifact audit deferred |
+| Illusion target definition | `env_illusion.py` contract; Illusion manifest above; `ROUND1_BOTTOM_UP/01_DRL_CONTROL_AND_CASES.md` §52 | V5/Legacy target construction differs by chain; target force and six sensor channels plus target `Cd,Cl` in V5 | Non-zero target signature/field; controlled target comparison; physical zero separate comparator | `read`; target identity must be retained per chain; no full-state equivalence claim |
+| Illusion geometry terminology | V5 `env_illusion.py`; `src/SR_analysis/data/runs/article-joint-data-illusion-20260718/illusion/illusion_0.75L/manifest.json`; `DATA_DICTIONARY.md` | `ill_075L`; `L0=20`; target radius ratio `0.75`, physical radius `15`, diameter `30`; historical labels may use `target_diam` or `D_t/L0` | Geometry identity only; no diameter-ratio relabelling | `read`; explain once that historical variable/plot names do not change the physical radius interpretation; V5/Legacy chains remain separate |
+| Periodic Illusion metrics | `ROUND1_BOTTOM_UP/08_EXPERIMENT_AND_CASE_METRICS.md` §§4.2–4.3; `src/drl_pinball/eval/wake_l2.py`; `DATA_DICTIONARY.md` | Only exact compatible target/controlled/zero roles; V5 or Legacy separately | Complete-cycle mean L2 and independent phase8 separately; normalized DTW only with exact target-channel normalization/window; registered ROI `-6..+14D`, `|y-y0|/D<=5` where evaluator applies | `read`; raw fields/exact masks authority-led `artifact-audit deferred`; no pooling |
+| Illusion historical/negative SR | `src/SR_analysis/CLAIMS.md` I1–I3; `src/SR_analysis/HANDOFF.md`; standardized role artifacts named there | LegacyCelerisLab; `illusion_1L`; SR vs physical zero, one standardized realization; independently phased roles; `Re_D=re_code/2` | Native DTW `0.9117016` vs `0.9119890`; normalized DTW `0.8940190` vs `0.8940537`; mean L2 `0.189990` vs `0.189414`, `eta=-0.00304`; phase8 `0.264176` vs `0.261832`, `eta=-0.00895`; `480+160` window | `read`; current authority-led negative/historical result, raw role audit deferred |
+| Erase role/failure boundary | `src/drl_pinball/legacy_test/README.md` line 13; `ROUND1_BOTTOM_UP/08` §§4.2,5.2,9; manifest `erase` entries | Legacy historical route; `erase`; filenames show navigation but do not establish exact independent roles | Candidate mean-field L2 plus DTW only under exact roles; historical route uses evolving controlled-force FIFO target | `read`; quantitative Erase unsupported/currently module-specific blocker; do not infer roles |
+| Force-centred conceptual bridge | `ROUND1_BOTTOM_UP/01_DRL_CONTROL_AND_CASES.md` §§1,3; `src/drl_pinball/train/env_karman.py`, `env_illusion.py` | Kármán force aggregation is case-specific; Illusion target force aggregation differs; Erase historical reward special | Force terms motivate near-zero cloak and target-force matching, but field L2 is independent | `read`; bounded interpretation only; small structures/higher Re unresolved; not generalized theory |
+| Near-collision gate | `00_QUALITY_GATE.md` §§14–18; `00_WAVE_A_COORDINATOR_AUDIT.md` §§28–37; M03–M06 exports | Compare within exact chain/case/role acquisition; never cross Legacy/V5 silently | Check role acquisition/set, ROI/domain, mask, weighting/normalization, window; classify same estimand/related diagnostic/different estimand | `read`; mandatory downstream control |
+
+## Figure, equation and table contracts
+
+### Cross-case extension figure (one contract, separated subpanels)
+
+**Role.** A single progression figure may contain: (i) Vortex event panels at named event labels and offsets, with action trace and downstream ROI-L2/DTW annotation only if exact roles exist; (ii) Illusion target, physical-zero and controlled panels for `ill_075L`, with visual target/controlled/physical-zero roles and any available complete-cycle mean L2, phase8 or normalized DTW visibly separated; field metrics are conditional on exact current role authority; and (iii) an Erase mean panel only if exact target/control/zero roles are later authority-bound. Each subpanel must state chain, case, role, seed, target/reference, metric, ROI/mask and window.
+
+**Caption limits.** Mark Vortex event labels as event-relative, not phase. Mark Illusion as PPO capability and keep negative Illusion SR visible locally. Mark Erase as unavailable/visual navigation if its quantitative role contract is absent. Similar numerical values across subpanels are not pooled.
+
+**Does not establish.** The figure does not establish a common efficacy score, arbitrary-flow universality, Kármán skeleton transfer, positive Illusion SR, causal force-to-field mapping, or Erase success from filenames/visual similarity.
+
+### Optional compact metric-definition block
+
+Define, only where roles permit,
+
+`E_event(o) = RMS_ROI(q_controlled(o) - q_target(o))`,
+
+and use the existing periodic `E_mean` and `E_phase8` definitions without treating event snapshots as phase fields. The equation defines a candidate event estimand; it does not create missing event roles, common masks or an evaluator result.
+
+### Supplementary case matrix
+
+The full matrix should retain all vortex labels and `relative_offsets=[-10,-5,0,5,10]`, Illusion target sizes, V5/Legacy identifiers, role acquisition status, native/normalized DTW, mean/phase/event/mean-field semantics, and artifact deferrals. It is a supplement contract, not a main-text inventory or pooled bar chart.
+
+## Claim ladder
+
+**Green — supported at named scope**
+
+- Current event artifacts and plot navigation support named transient Vortex visual roles, while the named historical V5 `ill_075L` PPO result supports capability-level Illusion evidence. Neither currently supports a quantitative Vortex target/control/zero event comparison without audited exact role artifacts.
+- Periodic Illusion is a non-zero target problem: target, controlled and physical-zero roles and complete-cycle mean/phase8 metrics are conceptually distinct and can be reported only where their exact authorities exist.
+- Illusion SR is historical/negative under the standardized long-window 1L comparison; Erase’s historical Legacy route is explicitly unsupported for quantitative efficacy.
+
+**Amber — bounded interpretation**
+
+- Pulse-like actuation supports a comparable-scale event-response hypothesis for the named Vortex disturbances.
+- A force-centred observer/reward view motivates the distinction between near-zero cloaking and target-force retargeting, while unresolved small structures and higher-Re effects limit that approximation.
+- Cross-case breadth changes the temporal/target contract, not the evidentiary status of the Kármán control skeleton.
+
+**Red — prohibited without new evidence**
+
+- Arbitrary incoming-flow capability, universal vortex control, continuous scale/offset generalization, or transfer of the Kármán SR/CCD interpretation to Vortex, Illusion or Erase.
+- Positive Illusion SR, target tracking by SR, efficacy over physical zero from old finite-run similarity alone, or one common L2/DTW efficacy score.
+- Quantitative Erase success inferred from filenames, plot existence or unsupported Legacy reward targets.
+- Causal force-to-field theory, exact small-structure suppression, higher-Re universality, DTW as delay, or cross-module numerical agreement/validation from near-collision values.
+
+## Imports, exports and bridge
+
+**Imports.** M03 supplies Legacy/V5, action, role, ROI and L2/DTW semantics. M04 supplies the Kármán performance comparator but not a transferable cross-case score. M05 supplies the positive Kármán/cloak control-skeleton boundary. M06 supplies descriptive Kármán field organization only. Round-1 Vortex, case-metrics and coverage dossiers supply event labels and role gaps; current package authorities control the facts.
+
+**Exports to Module 08 synthesis.** Named PPO demonstrations support event-relative control beyond periodic phase for comparable-scale vortex disturbances and objective retargeting/erasure under case-specific contracts; they do not establish arbitrary-flow universality, Kármán skeleton transfer, positive Illusion SR or one common efficacy score. Export the exact Illusion negative SR comparison and the Erase role/evaluator gap. No Vortex number should be exported until exact event roles and an evaluator authority are bound.
+
+**Exports to Module 10 conclusion.** Cross-case results show capability breadth with asymmetric interpretation: execution can be retargeted under named cases, but the positive control-skeleton reading remains Kármán/cloak-specific. Export the failure envelope—Vortex event-role/evaluator gap if unresolved, Illusion SR negative result, Erase unsupported route, and no pooled score—and the requirement for matched event/target-role acquisitions as the decisive next test.
+
+**Bridge to later steady context.** After these extensions, the manuscript may return to steady as contextual reference for the Kármán near-constant component. That return must not imply that steady evidence closes Vortex transient transfer, Illusion target-field transfer or Erase efficacy.
+
+## Conflicts, deferrals and genuine blockers
+
+- **Authority-led deferrals, nonblocking for bounded prose:** external/symlink-backed raw Vortex and Illusion field payloads, model/normalizer bundles, solver-exact masks and leaf-hash recomputation. The current authorities bind the stated roles or claim boundaries without a conflict; artifact audit is deferred.
+- **Module-specific blocker:** a quantitative Vortex event-L2 panel is blocked unless exact target/control/zero event roles, target identity, event offsets, ROI/mask and evaluator authority are available. Visual capability can remain as a bounded observation.
+- **Module-specific blocker:** an Erase quantitative panel is blocked by the explicitly unsupported Legacy route and absent independently mapped target-scale contract. Do not fill this gap from the plot manifest.
+- **No scientific blocker to the bounded section text:** Illusion can be represented with PPO capability plus locally visible negative SR, provided the metrics are not pooled and role/window contracts remain explicit.
+- **Systematic control already present:** the near-collision gate is a coordinator-level control inherited from Wave A. Applying it here is mandatory; it is not a new module-specific interpretation.
+
+## Coverage ledger
+
+| Status | Sources inspected and reason | Evidence state |
+|---|---|---|
+| `read` | Current Round-3 rule/master/quality/interface ledger and Wave-A audit; Round-2 freeze/style; Modules 03–06; Round-1 `01_DRL_CONTROL_AND_CASES.md`, `06_CURRENT_DOCUMENT_COVERAGE_AUDIT.md`, `08_EXPERIMENT_AND_CASE_METRICS.md`; current DRL README/CLAIMS/RESULTS/DATA_DICTIONARY/WRITING_HANDOFF; Legacy acquisition README; current SR CLAIMS/HANDOFF; Vortex/Illusion manifests and current environment/result authorities | Read directly; not independently verified or artifact-audited |
+| `mapped` | Current plot navigation and package links to external role roots; archive/old Illusion and Vortex routes used only to understand status/history | Mapped is not read, verified or audited; no claim depends on archive leaf material |
+| `not-covered` | Raw event/phase NPZ arrays, exact Vortex event evaluator output, complete Erase target/control/zero independent roles, new offline event adapter, new CFD/training, new figures and external literature | Not covered because outside first-pass drafting; quantitative Vortex/Erase panels remain conditional |
+| `external-inaccessible` | Symlink/external storage roots for selected reproduction fields and some role payloads; model/normalizer bundles where not exposed in ordinary inspection | Authority-led `artifact-audit deferred`; no missing payload is silently treated as absent or present |
+
+## Self-audit under the current gate
+
+**Two layers and cadence.** Layer 1 contains four argumentative modules with local caveats and substantive transitions; Layer 2 carries exact contracts, roles, metrics, windows and status. It is a revised first-pass section dossier for second audit, not polished manuscript prose and not a readiness declaration.
+
+**Systematic versus module-specific defects.** The systematic risk is metric pooling/near-collision language across heterogeneous cases; the draft applies the Wave-A role/ROI/mask/weight/window gate and prohibits arithmetic or validation language. A second systematic risk is source-path dominance; narrative uses short tags and keeps inventories in Layer 2. Module-specific defects are the missing authoritative Vortex event-L2 evaluator/role result and unsupported quantitative Erase route. They are preserved as gaps rather than repaired by inference. No new systematic rule defect was found in this pass.
+
+**Gate checks.** Legacy/V5, periodic/transient/steady and capability/interpretation chains remain separate. Spatial L2 is not a validation Level/Stage; DTW remains complementary and case-specific. Illusion SR is locally visible as negative/historical. Kármán SR/CCD modes are not imported as Vortex/Illusion/Erase interpretations. Figure contracts visibly separate metrics and prohibit pooled bars. No citation, number, causal mechanism, universal claim or artifact was invented.
+
+**Disposition.** Second-audit PASS; ready for Wave C/downstream imports, not final manuscript prose. Quantitative Vortex event-L2 and Erase panels remain blocked/conditional as specified in the figure and blocker contracts.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/08_STEADY_SYNTHESIS.md

@@ -0,0 +1,87 @@
+# Round 3 first-pass module — Section 8: steady context, physical synthesis and theory limits
+
+**Status:** revised candidate for second audit; not self-declared ready. This module is a two-layer author-facing section draft and evidence dossier for the 6% steady return. It does not reverse the historical order: steady discovery is recalled briefly after the Kármán deep analysis, and the full steady/theory analysis appears here retrospectively.
+**Coordinator second-audit disposition:** PASS — ready for downstream Wave C imports, but not final manuscript prose.
+
+## Section question and bounded answer
+
+**Question.** After the Kármán deep analysis, what bounded steady context and theory constraints contextualize why the learned periodic law retains a near-constant rear-rotation core, and where does that interpretation stop?
+
+**Bounded answer.** The independently defined steady V5/free-slip branch supplies historical discovery context, sign and magnitude calibration, and a settling-qualified low-deficit endpoint compatible with the Kármán near-constant core; direct wall-sign checks, the failed potential-circulation sign route and incomplete finite-Re budgets prevent mechanism, stability, optimum and cross-chain validation claims.
+
+## Layer 1 — narrative draft
+
+The steady result returns here because it was discovered first, not because it is a continuation of the Legacy Kármán analysis. The early capability section records the short discovery seed; the Kármán section then shows a dominant near-constant rear-rotation component and a smaller dynamic correction under its own Legacy contract. The present return asks the narrower retrospective question: whether an independently defined steady branch contextualizes why that recurrence is plausible. It does not make the V5 steady result evidence for the Legacy SR or CCD numbers, and the two chains are never numerically pooled. [Round-2 freeze; current steady README/RESULTS; Modules 05–06]
+
+Under the modern V5 uniform-inlet, free-slip-channel contract at `Re_D=50`, the body order is `(front, rear_y_plus, rear_y_minus)` and the wall law is `(U_w,V_w)=(-\omega r_y,\omega r_x)`. The accepted branch is `[0,+\Omega,-\Omega]`, with `\Omega>0` and `s=\Omega R/U_\infty`; the direct cardinal check gives downstream velocity on both gap-facing rear cardinals and upstream velocity on the two outer cardinals. The accepted `s=3.55` endpoint is settling-qualified and has the authoritative downstream full-cross-section relative velocity-deficit `E_inf_vector(q_ctl,q_in)=0.0231672176752314` at `x/D=10`; nearby values are approximately `0.0232525`, `0.0231671` and `0.0312490` at `s=3.45,3.55,3.65`. The spatial profile L2 at `x/D=10` is `0.0153919` and remains a diagnostic, while `q_blk` is non-ranking. Thus `s=3.55` is a qualified endpoint, not a continuous optimum or universal law; the apparent local minimum remains provisional pending restarted bracket, continuation, convergence and held-out qualification. [V5 endpoint manifest; steady v3b report; display/profile authority]
+
+The sign check gives the shortest physical reading available from the endpoint. Positive rotation of the upper rear cylinder drives its gap-bottom cardinal downstream and the lower rear cylinder’s negative rotation drives its gap-top cardinal downstream; the accepted actuation therefore belongs to a base-bleed/gap-jet family, not a boat-tail family. Endpoint gap-flux, near-wake, recirculation, vorticity and downstream-profile diagnostics are compatible with describing a gap-facing or near-wake reorganisation and a low-deficit downstream profile. They remain observations and bounded hypotheses: the available package does not establish the arrows from wall motion through shear or separation to gap momentum, base pressure, force or downstream deficit, and the accepted `s=3.55` and reverse `s=5.2` states are not amplitude-matched. [V5 wall oracle; NS ledger; steady display; Round-1 theory dossier]
+
+The shortest validated theory reference is an outer impermeability calculation, not a finite-Re rotating-wall model. For one circle, the exact uniform-flow-plus-circulation trace is `u_\theta(a,\theta)=-2U\sin\theta+\Gamma/(2\pi a)`: impermeability leaves `\Gamma` independent, and for `U\ne0` no constant circulation can impose the full rotating no-slip tangential trace. The MFS/strip construction therefore supplies a reference family only after its validation gates; the current derivation records the exact-circle and independent unbounded Laurent checks as validated bounded mathematics, while dense off-grid, sector, conditioning, source-radius/order and image-layer gates are required before interpreting a new MFS field, and no publication-ready MFS field is implied here. The attractive cancellation route fails its decisive sign check: the strip outer reference requires `g_opt=+6.147944`, whereas the accepted finite-Re endpoint’s descriptive fit is `g=-12.200554`. The failed route is retained because it limits the interpretation; it cannot be silently replaced by a rotating no-slip closure. [DERIVATION.md; current strip and finite-Re authority; LITERATURE.md]
+
+The integrated map therefore constrains, without explaining, one set of compatible, non-equivalent observations. The Legacy Kármán SR deletion test ranks its persistent rear constant above the tested rear-lift feedback under a fixed parent-relative DTW window; the corrected Legacy CCD ledger says its constant-control mean-field reference accounts for `93.42%` of the measured zero-to-DRL ROI target-error reduction, leaving a `6.58%` increment organized descriptively by action-correlated correction-field modes; the separate V5 steady branch supplies the accepted sign and a low-deficit endpoint at a rear-rotation scale of order `s=3.55`. These analyses organize separate action-space and field-role observations around a persistent/constant reference, without a common estimator or independent triangulation. They use different chains, roles, domains, masks, windows and estimands: they are compatible observations, not replication, validation, agreement, a pooled metric or a closed control skeleton. This bounded synthesis therefore contextualizes, but does not explain, the persistent/constant reference before bridging qualitatively to the planned open-loop experiment—steady operation may be inspected for straighter dye streaklines and the illusion operation for changed shedding frequency. Experiment remains qualitative, and the computational interpretation stops before mechanism, stability, optimum, momentum restoration, causal closure or cross-chain validation. A decisive next test would combine amplitude-matched branches with held-out endpoint evidence, a validated outer-reference comparison and a complete same-control-volume Navier–Stokes momentum/mechanical-energy budget, followed by synchronized quantitative experiment if the claim is to cross the CFD boundary. [Modules 05–06; steady NS/theory authorities; Round-2 experiment boundary]
+
+## Layer 2 — local provenance and claim-to-evidence ledger
+
+| Narrative claim | Exact current authority / artifact | Chain, solver, geometry, case and Re | Comparator, metric/estimand, ROI/window | Status / verification boundary |
+|---|---|---|---|---|
+| Historical steady discovery and distinct contract | Round-2 `05_REVISED_STRUCTURE_FREEZE.md` §§2, 3, 5; `src/steady_pinball_theory/README.md`, `RESULTS.md`; `src/SR_analysis/results/runs/article2-steady-analysis-20260720/interpretation.md` | V5 steady/free-slip versus LegacyCelerisLab Kármán; three-cylinder pinball, body order explicitly separate; V5 `Re_D=50`, Legacy `Re_code=100` means `Re_D=50` only within Legacy’s own convention | Steady is contextual; Legacy SR/CCD retain their own role-local estimands | Current authority read; not independent CFD recomputation or universal artifact audit |
+| Accepted branch and direct sign | `steady-contract-v5-torque-d20-20260808/accepted-s3.55/manifest.json`; `steady-article-publication-v3b-20260809/REPORT.md`; `contract.py`/current steady README | V5 CelerisLab/LBM, `D=20`, `R=10`, uniform inlet, free-slip lateral walls, rotating no-slip cylinders; accepted action `[0,+\Omega,-\Omega]`, `\Omega=0.00355`, x-right/y-up | Cardinal wall velocities; branch/sign oracle, not a field metric | Current manifest-bound contract; direct wall check recorded by authority; artifact leaf audit deferred |
+| Low-deficit endpoint | Same accepted endpoint manifest and publication v3b; `figures/summary/profile_Einf_vector.csv` | V5 free-slip `Re_D=50`, accepted controlled endpoint, settling window 10, final `tU_\infty/D=250` | Full-cross-section two-component `E_inf_vector(q_ctl,q_in)` at `x/D=10`: `0.0231672176752314`; `E_L2_vector=0.0153918657` is diagnostic; nearby `s={3.45,3.55,3.65}` `E_inf_vector≈{0.0232525,0.0231671,0.0312490}`; `q_blk` non-ranking | Qualified endpoint observation; not optimum, uniqueness, attraction, stability or causal intervention; endpoint artifact audit deferred |
+| Reverse boundary | `steady-results-display-v2-20260809/README.md`; current steady `RESULTS.md`; profile CSV | V5 same nominal plant family, reverse branch `s=5.2`, but distinct amplitude and reverse sign | `E_inf_vector(x/D=10)=0.6898418` versus accepted `0.0231672`; this is not an amplitude-matched controlled comparison | Current display/CSV authority; descriptive branch contrast only, no mechanism or stability inference |
+| Gap-facing physical reading | V5 manifest `wall_oracle`; `steady_pinball_theory/LITERATURE.md` sign master map; `ns-ledger-v2-oracle-bound-d20-20260809/analysis.json` | V5 accepted branch, rear gap/outer cardinal samples; endpoint NS diagnostic ledger | Signed gap fluxes, near-wake/recirculation/vorticity and profile diagnostics are endpoint spatial observations; no single pooled score | Bounded observation/hypothesis; no causal arrow, force ownership or closed budget |
+| One-circle outer reference | `DERIVATION.md` §§5, 11; `LITERATURE.md` Crowdy (2006), DOI `10.1016/j.euromechflu.2005.11.005`; Ueda et al. (2003), DOI `10.1017/S002211200300627X` | Irrotational Euler/Neumann outer problem; one-circle exact identity, not V5 finite-Re no-slip solver | Wall normal/tangential trace identity; no downstream V5 metric | Existing derivation; exact-circle mathematics separately checked in the derivation record; no finite-Re mechanism transfer |
+| MFS/strip gate and failed sign | `steady-strip-modal-analysis-20260804-v4/analysis.json`; `steady-finite-re-bridge-analysis-20260804-v4/analysis.json`; `DERIVATION.md` §§11–13 | Outer strip/unbounded potential references with finite-image MFS; finite-Re descriptive contour projection from accepted V5 endpoint | Strip cancellation `g_opt=+6.147944`; finite-Re descriptive fit `g=-12.200554`; `same_sign=false`; strip reference `BOUNDED`, confinement mechanism `FAIL` | Current authority; sign conflict is a genuine interpretation blocker for that route; MFS field interpretation remains gate-dependent and no new field is promoted |
+| Partial NS/budget boundary | `ns-ledger-v2-oracle-bound-d20-20260809/analysis.json`; v3b report/display README | V5 accepted/reverse endpoint diagnostics, one body-enclosing rectangular CV | Endpoint spatial fluxes, dissipation, gap flux and actuator-on-fluid power; storage and body-adjacent terms unavailable, residual `null` | Current partial ledger; mechanical-energy closure `NOT_CLOSED`, causality `NOT_ESTABLISHED`, force ownership not established; authority-led raw-term deferral |
+| Legacy SR magnitude context | `src/SR_analysis/results/runs/article2-steady-analysis-20260720/interpretation.md`, `steady_constant_correspondence.json`; SR current claims and Module 05 | LegacyCelerisLab disturbance-free contextual roles; separate Legacy geometry/API and action convention | Steady sweep `A=0…6`, best listed `A=5`, Legacy DTW similarity `0.9872116`; Kármán law deployment `0.9664944`; rear mean `(-3.430589,+3.431828)`, fitted magnitude `3.431209` | Contextual calibration only; not pooled with V5 `E_inf_vector`, not momentum equality or mechanism |
+| Legacy CCD compatible observation | Module 06 current corrected authority; `src/CCD_analysis/RESULTS_INDEX.md`, `FINAL_RESULTS.md`, corrected manifests | Legacy `karman_re100`, target/zero/constant/DRL roles; `Re_D=50` under Legacy `Re_code=100`; exact four-role common mask | Coordinate-weighted ROI mean errors `E_zero=0.4694352273`, `E_constant=0.1110140739`, `E_DRL=0.0857787860`; `93.42/6.58` scalar error-difference share; separate `19×10` residual | Current descriptive/noncausal result; not steady evidence and not a paired intervention; dense arrays/leaf audit deferred |
+
+### Existing derivation, independent checks and open conjectures
+
+- **Existing derivation:** one-circle Euler trace, fixed-circulation outer uniqueness under stated hypotheses, rear-opposite potential/dipole algebra, MFS construction, strip finite-image relations, `E_inf_vector` definition and partial NS-ledger identity.
+- **Independently checked/validated at bounded level:** current authority records exact-circle failure controls, bounded agreement of independently discretized unbounded MFS and Laurent/Fourier checks, finite-image convergence observations without an asymptotic tail claim, direct wall-cardinal sign, accepted endpoint settling and the finite-Re descriptive sign fit. These do not validate an MFS field as finite-Re physics.
+- **Open conjecture:** accepted gap-facing motion may participate in a base-bleed/gap-jet-family near-wake organisation and may be compatible with a low-deficit endpoint; a persistent rear rotation may provide a mean compensation-like contribution with a smaller dynamic correction. Neither conjecture is a mechanism, momentum restoration, stability statement, optimum or causal law.
+
+## Figures, equations and table contracts
+
+1. **Accepted/reverse profiles and fields plus `E_inf_vector(s)` curve.** Source from the current steady display/profile CSV and endpoint fields; show accepted `s=3.55`, reverse `s=5.2`, stationary reference and nearby accepted sweep values. Caption must state V5/free-slip `Re_D=50`, full-cross-section `q_ctl` versus `q_in`, `x/D=10`, diagnostic L2, reverse amplitude mismatch, and endpoint—not optimum/stability—status. Redraw is dependent on current manifests/field payloads; no new publication-ready figure is claimed.
+2. **Action-sign schematic.** Redraw the body order and four rear cardinal velocities from the accepted manifest. It establishes the sign and gap-facing/outer-facing observation; it does not establish circulation, base-bleed causality or boat-tail equivalence.
+3. **Shortest outer-reference/sign-conflict panel.** Use the validated one-circle trace and a compact `g_opt=+6.147944` versus `g=-12.200554` sign comparison. If an MFS field is retained, all dense off-grid, sector, conditioning, source-radius/order, image-layer, one-circle and independent-reference gates must be visibly complete; otherwise leave the field in the supplement/open ledger. This panel does not establish rotating no-slip finite-Re physics.
+4. **Integrated evidence map.** Nodes are Legacy SR term ranking, Legacy corrected mean/CCD organization, V5 steady endpoint and qualitative experiment bridge. Solid arrows mean same-contract definition or result; dashed arrows mean compatible observation across non-equivalent estimands; broken/unresolved arrows mean mechanism, causality or closure is open. The map must print chain, metric and status and must not be rendered as a causal flow diagram.
+
+**Equation budget:** reuse the wall law/action sign and `s`, the steady `E_inf_vector` definition, and either the one-circle trace or the partial NS-ledger identity. The full MFS, strip-image, multipole and CV derivations belong in the supplement unless their current validation gates are explicitly closed.
+
+## Claim ladder and interfaces
+
+**Green / supported:** accepted V5/free-slip sign contract; direct wall-cardinal check; settling-qualified `s=3.55` endpoint; `E_inf_vector` at `x/D=10`; profile L2 as diagnostic; reverse high-deficit endpoint as a distinct non-amplitude-matched observation; failed potential-cancellation sign; partial rather than closed NS ledger.
+
+**Amber / bounded:** low-deficit endpoint is compatible with the recurrent Kármán near-constant rear-rotation scale; accepted wall motion is in a base-bleed/gap-jet family; steady, SR and corrected mean/CCD observations can be integrated as compatible, non-equivalent context; qualitative experiment is a prospective bridge.
+
+**Red / prohibited without new evidence:** mechanism, causal gap-jet or momentum-restoration claim; `Gamma(Omega)` closure; MFS-to-no-slip transfer; stability, branch attraction, optimum or universal `s` law; Legacy/V5 numerical continuation/equivalence; arithmetic pooling or replication/validation/agreement/triangulation language; quantitative experiment validation.
+
+**Imports:** Modules 03–06 supply chain, metric, Legacy SR, corrected mean/dynamic and CCD boundaries. The current steady authority supplies the V5 contract, accepted sign, endpoint, theory failure and incomplete budget.
+
+**Exports to Module 09/10:** a bounded physical synthesis (`persistent rear rotation + smaller correction` as compatible organization only), the failed potential-sign route and incomplete-budget decisive tests, and a qualitative experiment bridge. No quantitative steady number, sign convention or endpoint metric may be transferred to Legacy without its own contract.
+
+## Near-collision check
+
+The Legacy SR fitted constant magnitude (`3.431209` in `alpha=omega/U_0`) and the V5 steady endpoint (`s=3.55`) are numerically similar dimensionless labels but use different action parameterizations, chains, plants and objectives; they are related contextual diagnostics only, not amplitude agreement, validation or an arithmetic comparison. CCD has no actuator-magnitude comparison here: its constant mean is a field-role reference under the corrected four-role estimand and can join the synthesis only as a non-equivalent mean-field observation. No arithmetic combination, replication, validation, agreement or triangulation wording is permitted.
+
+## Defects, gates and coverage ledger
+
+**Systematic/module-specific classification:** the current Round-3 controls require a cross-module near-collision check; this module applies it explicitly. Module-specific risks are the V5/Legacy sign temptation, provisional `s` minimum, MFS validation status and partial NS budget. No control-plane edit is authorized in this one-file task.
+
+**Genuine blockers:** none for the bounded section text. The potential sign conflict is a genuine blocker to that mechanism route, not to this bounded synthesis. A retained MFS field panel becomes blocked until its listed validation gates are complete; an exact artifact-audit claim becomes blocked if authority cannot bind the panel source.
+
+**Authority-led deferrals:** raw endpoint fields, external/symlink-backed roots, leaf hash recomputation, complete MFS raw arrays and full NS terms are deferred because current authorities bind the roles, numbers, contract and status without conflict. These deferrals do not authorize stronger claims.
+
+| Coverage status | Sources and reason | Evidence status |
+|---|---|---|
+| `read` | Current Round-3 master/rule/quality/interface ledger and Wave-A audit; Round-2 freeze/style; current Modules 03–06; Round-1 steady, SR, CCD/OID and coverage dossiers; current steady README, RESULTS, DERIVATION, LITERATURE, evidence README/INDEX, v3b report, display README, V5 endpoint manifest, strip/finite-Re authorities, NS ledger, validation authority and SR steady correspondence | Read directly; not equivalent to independent recomputation or universal artifact audit |
+| `mapped` | Current figure manifest/CSV and authority-linked external roots used to identify redraw dependencies; archive/history only for replacement navigation | Mapped/indexed, not read as independent evidence; not promoted |
+| `not-covered` | New CFD, new MFS computation, full raw-field/NPZ audit, universal hashes, new literature search, synchronized experiment analysis | Outside first-pass scope; no result inferred |
+| `external-inaccessible` | Symlink-backed/external endpoint and dense theory/NS payloads not fully exposed through ordinary repository reading | Authority-led `artifact-audit deferred`; nonblocking for bounded text, blocking for any retained unsupported panel or reproducibility claim |
+
+## Anti-index / anti-AI audit
+
+The narrative has five argumentative paragraphs with local caveats, not a package inventory. Numbers appear only where they change the inference; chain, comparator and metric distinctions are repeated only at the necessary bridge. No archive result is promoted, no V5 sign is transferred to Legacy, no spatial L2 is pooled with DTW or CCD, no potential field is presented as a mechanism, and no first-pass readiness claim is made.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/09_EXPERIMENT_AUTHOR_INTERFACE.md

@@ -0,0 +1,151 @@
+# Round 3 — Qualitative experiment author interface
+
+**Status:** first pass; author interface for Frank, not manuscript prose and not self-ready. Frank retains authorship of the subsection. This module reserves a concise qualitative open-loop experiment subsection and defines the evidence and provenance needed before any prose, caption or figure is promoted.
+
+**Coordinator second-audit disposition — PASS:** interface ready for Frank/Wave C imports. Final prose and any figure remain blocked by the author-supply/provenance gate; this is not final manuscript prose.
+
+## Section question and bounded answer
+
+**Question.** What does the physical deployment demonstrate qualitatively, and what evidence is still required before it can be presented as an experimental result rather than a feasibility demonstration?
+
+**Answer ceiling.** Under the author-described apparatus and open-loop operation, the experiment can support only bounded qualitative feasibility observations: steady operation appears to produce straighter dye streaklines and illusion operation visibly changes shedding frequency. It does not currently support synchronized force/PIV validation, quantitative field matching, closed-loop experimental validation, or a causal explanation of the observations.
+
+## Source boundary and coverage ledger
+
+The author-described facts below are preserved as `[AUTHOR]`, not independently verified. External facility literature may motivate measurement cautions or future design choices, but cannot establish the DynamisLab apparatus, its conditions or its results.
+
+| Status | Sources inspected | Meaning |
+|---|---|---|
+| `read` | Round-2 `05_REVISED_STRUCTURE_FREEZE.md`, `06_SECTION_LEVEL_JFM_STYLE_GUIDE.md`; Round-3 rule, quality gate and interface ledger; ready M07 `07_CROSS_CASE_EXTENSIONS.md`; ready M08 `08_STEADY_SYNTHESIS.md`; Round-1 `08_EXPERIMENT_AND_CASE_METRICS.md`; Round-1 `06_CURRENT_DOCUMENT_COVERAGE_AUDIT.md` | Read as narrative/claim controls. Read is not independent verification or artifact audit. |
+| `mapped` | Repository experiment references and current case/metric interfaces named by those authorities | Mapped/indexed material is not read evidence and does not establish an experimental result. |
+| `not-covered` | Complete local raw experiment package, synchronized force/PIV data, calibration records, repeatability analysis and new figure generation | Not available or outside this first pass; do not fill gaps from memory, plots or CFD. |
+| `external-inaccessible` | Undermind Oil-tunnel background material and hidden/external raw facility artifacts not exposed in the repository | Context only after identity/reading level is resolved; cannot establish internal apparatus/results; raw audit deferred. |
+
+No current internal experiment document with an auditable apparatus/data package was located beyond the Round-1 authority above. Current status is author-described and provenance-incomplete, not independently verified.
+
+## Layer 1 — author-facing paragraph scaffold
+
+### Paragraph 1 — purpose, facility and apparatus boundary
+
+**Opening job:** establish deployability and the experimental boundary in one compact paragraph, without turning the subsection into a construction diary.
+
+> To assess whether the learned actuation could be deployed physically, [we/Frank] built a system from scratch in a recirculating water tunnel, using an isolated test section as a still-water towing section. A linear guide/rack and gantry carriage moved the [declared geometry] while [force sensor, ADC, Raspberry Pi, motor drivers, cylinders and power system] provided the actuation and acquisition hardware; Python was used for hardware/software deployment. The trials were operated **open loop**, with [exact motor/action waveform and sign convention to be supplied]. Because the towing speed and resulting hydrodynamic force were very low, the available force feedback was below a useful closed-loop level under the present conditions. [Insert only facility dimensions, water conditions, geometry, speed and trial identifiers after the provenance gate passes.]
+
+**Evidence level:** `[AUTHOR]` apparatus and deployment description; not independently verified. This establishes physical feasibility of deployment, not measurement accuracy or policy validation.
+
+**Computational-to-experiment bridge:** this is physical deployment of the steady and illusion actuation objectives, not a reproduction of the Legacy/V5 CFD chain. Do not transfer CFD Reynolds conventions, solver fields, L2/DTW values, SR laws or CCD interpretation without a separate same-plant, calibrated mapping.
+
+### Paragraph 2 — bounded qualitative observations
+
+**Opening job:** state only what archived raw media and trial identity can support, with comparator and observation kept local.
+
+> In the steady comparison, the dye streaklines in [trial/control/reference conditions] appeared [straighter/less deflected] over [declared observation region and time window]. In the illusion comparison, the dye visualization showed a visible change in shedding frequency under [declared open-loop action and trial ID]. These are qualitative image observations, not velocity or force measurements: no synchronized calibrated PIV/force package was available for the present comparison, and no quantitative field matching was performed. [Insert whether the observation was repeated, how frames were selected, and exact raw-media provenance.]
+
+**Evidence level:** `[AUTHOR]` observation, conditional on raw image/video provenance. Keep “appeared” unless a declared image-analysis protocol and uncertainty support stronger wording. “Changed shedding frequency” remains visual/qualitative unless frame rate, timing and event extraction support a physical frequency estimate.
+
+**Comparator rule:** name the actual trial/reference pair. Do not call dye a CFD-to-experiment match, field restoration, force reduction or experimental validation. Steady straightness and illusion shedding-frequency change are separate observations, not one efficacy score.
+
+### Paragraph 3 — limitation and next decisive experiment
+
+**Opening job:** place the main limitation beside the observation and define the next evidence threshold.
+
+> The present setup therefore provides a qualitative open-loop feasibility demonstration rather than a closed-loop experimental validation. Thermal convection is a **suspected confound** under the low-speed, low-force conditions, but the present record does not prove that it was the sole, or even dominant, source of background motion or force contamination. A quantitative comparison would require [synchronized calibrated force and PIV or an explicitly bounded image/sensor protocol], background blank controls, repeat trials, calibration and uncertainty records, and a traceable mapping between the computational target/reference and the physical acquisition. Until those records are available, the experiment should remain a qualitative main-text/supplement decision under the figure gate below.
+
+**Evidence level:** `[AUTHOR]` limitation and `[OPEN]` next-test requirements. The bridge to M10 is feasibility → evidence ceiling → decisive future test, not feasibility → validation.
+
+## Layer 2 — author supply checklist and provenance contract
+
+Frank must supply, or explicitly mark unrecoverable, the following before final prose or a figure request. “Not available” is acceptable; it must not be silently replaced by an estimate.
+
+### A. Facility, fluid and geometry
+
+- [ ] Facility identity and test-section dimensions: tunnel/channel, isolated still-water section, walls/free surface and relevant boundaries.
+- [ ] Water conditions: temperature/variation, preparation, fill/settling procedure, pump state and whether circulation was stopped or isolated.
+- [ ] Cylinder/geometry identity: diameter(s), spacing, body order, span/depth, mounting, blockage and coordinates; distinguish experiment from Legacy/V5 geometry.
+- [ ] Towing direction, carriage origin, travel range, acceleration/deceleration and settling interval.
+- [ ] Nominal and measured towing speed, speed trace if available, intended/estimated experimental `Re_D`, definition and viscosity source. Do not infer it from CFD labels.
+
+### B. Actuation and trial identity
+
+- [ ] Exact motor/action waveform for steady and illusion: amplitude, frequency/timing, phase/offset, duration, command units and physical-motion conversion.
+- [ ] Action signs and body ordering in experimental coordinates; identify directly documented versus reconstructed signs.
+- [ ] Trial IDs, date/time, case label, control/reference condition, geometry/setup version and excluded/failed trials.
+- [ ] Repeat count per condition and rule for selecting the shown trial; state whether the observation is one sequence or replicated.
+- [ ] Open-loop timing: command start, carriage motion, dye injection and what was/was not synchronized.
+
+### C. Raw media and image provenance
+
+- [ ] Raw image/video files, immutable filenames or hashes, camera, view, field of view and trial-ID linkage.
+- [ ] Spatial scale/calibration, frame rate, exposure/shutter, resolution, lens/view geometry and cropping/stabilization/enhancement/frame dropping.
+- [ ] Dye identity/concentration, injection location, volume/rate, timing and repeatability of injection protocol.
+- [ ] Blank/background media for no-tow/no-actuation and, if available, residual-motion and post-settling conditions.
+- [ ] Observation window/region; identify visual judgment versus a declared analysis procedure for “straighter” or “changed shedding frequency”.
+- [ ] Figure permissions, ownership, consent where relevant and permission to archive raw media in the supplement.
+
+### D. Sensors, calibration and synchronization
+
+- [ ] Force sensor model, mounting, axes, range, sampling rate, tare/zero, calibration curve, drift, noise estimate and units.
+- [ ] ADC configuration, Raspberry Pi clock/sample timing, motor-driver/encoder timing and clock offsets/dropped samples.
+- [ ] Carriage position/speed measurement and motor-command logging; distinguish commanded waveform from realized motion.
+- [ ] Synchronization marker shared by camera, force/ADC, carriage and actuation streams; if absent, state so.
+- [ ] Explicitly state that no synchronized calibrated force/PIV data were available if that remains true. Never infer force feedback from deployment software, reward, dye or uncalibrated ADC.
+
+### E. Background controls, uncertainty and recoverability
+
+- [ ] Blank runs, settling/wait times, pump/carriage state and temperature/thermistor records near relevant walls/surfaces if available.
+- [ ] Measured background velocity/dye displacement and method; do not subtract or attribute it without a declared control protocol.
+- [ ] Calibration, timing, scale, registration and repeatability uncertainty actually supported.
+- [ ] What cannot be recovered: raw media, trial IDs, speed, synchronization, calibration, repeat count or geometry. List each explicitly.
+
+### Provenance acceptance rule
+
+A figure or quantitative sentence may use only values/observations whose raw source, trial identity, condition, processing history and permission are traceable. Author memory can describe the setup as author-provided, but cannot supply missing numerical values. Authority-led deferral is acceptable for hidden artifacts only when an authority binds their role without conflict; it does not authorize a new panel or independent-verification claim.
+
+## Figure gate
+
+**Raw provenance must pass before any experiment image enters the main text.** The gate requires raw file/linkage, trial ID, condition, scale, frame rate/exposure, dye timing, processing history, repeat status and permissions. If any required provenance is missing, do not include the image as a main-text result. A supplement-only panel is permitted only if clearly labelled as an uncalibrated qualitative/open-loop demonstration, with available provenance and missing fields stated in the caption, and no quantitative inference. If raw media cannot be recovered, omit the panel rather than digitizing or reconstructing it from a plotted image or memory.
+
+### Candidate figure contracts
+
+1. **Optional apparatus schematic:** may show isolated still-water towing section, guide/rack, gantry, geometry and deployment signal path. It documents apparatus context and deployment feasibility; it does not prove calibration, accuracy, closed-loop operation or force-feedback quality. Avoid a component-by-component hardware diary.
+2. **Optional steady/illusion dye plate:** may show raw, minimally processed media with separate trial IDs. It supports only qualitative streakline/shedding observations; it does not prove field matching, velocity/vorticity agreement, force reduction, causal shedding control or experimental validation.
+3. **No synchronized force/PIV panel in this pass:** reserve it for later calibrated acquisition with clock alignment, common coordinates/mask and uncertainty. Do not register CFD fields onto dye images or imply a quantitative bridge without these inputs.
+
+## Claim ladder and exact nonclaims
+
+### Green — author-described, named qualitative scope
+
+- System built from scratch in a recirculating water tunnel with isolated still-water towing section, linear guide/rack, gantry carriage and listed deployment hardware, **as author-described**.
+- Python hardware/software deployment enabled learned actuation to run on the apparatus, **as author-described**.
+- Operation was open loop; useful closed-loop force feedback was not achieved under described low-speed/small-force conditions, **as author-described**.
+- In named steady media, dye streaklines appeared straighter; in named illusion media, shedding frequency visibly changed, **only after raw-media provenance passes**.
+
+### Amber — bounded interpretation
+
+- Apparatus provides qualitative physical deployment/feasibility demonstration for steady and illusion actuation.
+- Observations are consistent with qualitative wake modification under named open-loop conditions.
+- Background thermal convection is a suspected confound motivating controls, not established as sole cause of force/image contamination.
+- Demonstration motivates future synchronized, calibrated, repeated experiment; it does not raise the computational claim ceiling.
+
+### Red — exact nonclaims without new evidence
+
+Do not write or imply: “experimentally validated cloak/illusion”; “closed-loop experimental control”; “force feedback achieved”; “PIV confirms the CFD”; CFD-field matching; force reduction or field restoration from dye; quantitative shedding frequency, L2, DTW, uncertainty or efficacy percentage without its acquisition contract; thermal convection as proven sole cause; causal mechanism, momentum restoration, stability, optimality, robustness or generalization; or one common metric across dye, CFD, steady profiles, periodic phase and transient events.
+
+## Imports, exports and M10 handoff
+
+**Imports from M03–M08:** use frozen vocabulary `hydrodynamic cloaking`, `hydrodynamic illusion`, `wake-signature matching`, `field matching` and `qualitative open-loop experiment`; preserve Legacy/V5 separation, case-specific metrics, positive SR limited to Kármán/cloaking, negative Illusion SR, descriptive/noncausal CCD and steady as contextual. M07’s Illusion result is PPO capability plus historical/negative SR boundary; M08 supplies only a prospective qualitative bridge. None of these computational results validates apparatus or dye media.
+
+**Export to M10:** the experiment contributes a bounded feasibility observation and provenance-dependent figure option. Carry forward: no synchronized calibrated force/PIV validation, no quantitative field match, no closed-loop experimental validation, low-speed/background susceptibility and unresolved recoverability. The decisive next test is same-geometry, declared-condition, repeated, synchronized and calibrated acquisition with blank/background controls and uncertainty accounting.
+
+**Final bridge:** conclusion must separate “physical deployment was attempted and qualitative wake changes were observed” from “the computational target/reference was quantitatively matched.” The latter remains open.
+
+## Genuine blockers and first-pass disposition
+
+- **No blocker to this author interface:** section can be reserved with author-described facts and explicit slots.
+- **Blocker to final prose/figure inclusion:** missing raw-media provenance, trial linkage or permission; missing conditions needed to identify the observation; or any quantitative/validation claim without synchronized calibration and a case-specific metric contract.
+- **Module-specific evidence gap:** internal apparatus and raw experiment package were not independently audited. Oil-tunnel literature, CFD artifacts, memory and plotted images cannot repair this.
+- **Disposition:** submit for parent audit/revision. Do not mark `ready` or self-ready.
+
+## Anti-pattern audit
+
+No values, hardware performance, citations or raw artifacts are invented; author memory is not upgraded to independent evidence; the section is not a hardware diary; suspected thermal convection is distinct from proven cause; steady/illusion/CFD metrics are not pooled; and limitations sit beside each possible observation. Final manuscript prose remains Frank’s responsibility after the provenance gate is resolved.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/10_LIMITATIONS_CONCLUSION.md

@@ -0,0 +1,88 @@
+# Round 3 revised candidate — Section 9: limitations and conclusions
+
+**Status:** revised candidate for second audit; not ready. This module answers the integrated claim-ceiling question after Modules 03–09. Module 09 is imported as a ready author interface, while final experiment prose and any panel remain blocked by the author-supply/provenance gate.
+
+## Section question and bounded answer
+
+**Question.** What integrated conclusion survives the Legacy/V5, chain, metric, causality, theory and experiment boundaries, and which decisive tests would raise the claim ceiling?
+
+**Bounded answer.** Named learned control provides capability demonstrations across the declared tasks; independent field matching is supported only for named Legacy Kármán Re100; and the Legacy Kármán action and field evidence supports a bounded control-skeleton interpretation organized by dominant persistent rear rotation plus a smaller dynamic correction. Cross-case Vortex and Illusion evidence remains named wake-signature or visual PPO capability under distinct contracts, with no Vortex event L2, conditional Illusion field L2 and unsupported Erase quantification; the author-described experiment interface remains provenance-gated. These levels do not establish a unbounded law or causal explanation.
+
+## Layer 1 — narrative and conclusion map
+
+### Discussion paragraph 1 — capability to Legacy Kármán field matching
+
+The strongest integrated result begins with capability, but its evidence is not a single pooled score. Under the named Legacy and V5 contracts, learned force-plus-sparse-observation control provides named wake-signature capability for the declared Kármán task and extends to named transient Vortex and non-zero-target Illusion demonstrations under distinct contracts. Independent spatial field matching is supported only for the named Legacy Kármán Re100 case: the controlled trajectory is closer to its target than physical zero in both complete-cycle mean-field and eight-slot phase-resolved L2 within the registered downstream ROI. DTW remains complementary, signal-level and case-specific; it does not replace L2, represent a physical delay or establish causality. The V5 seed/retention evidence and the Legacy Kármán field result therefore remain separate support chains, not a pooled convergence claim. [M03; M04; Wave-A audit]
+
+### Discussion paragraph 2 — executable SR and corrected mean/dynamic CCD
+
+The Kármán interpretation becomes narrower, rather than stronger, when the action and field analyses are placed in their own estimands. In the Legacy executable SR route, the mapped-shared law passes its named deployment checks, and parent-relative fixed-window deletions rank the persistent rear counter-rotation as the largest tested contribution, with smaller rear-lift feedback and a weak or mixed tested front correction. These are deletion tests, not causal ablations. In the corrected four-role Legacy CCD ledger, the constant mean accounts for 93.42% of the measured zero-to-DRL target-error reduction and the remaining 6.58% is organized by a separately centred, non-paired residual represented as action-correlated correction-field modes. Together these are compatible, non-equivalent action-space and field-role organizations that motivate a control-skeleton reading—dominant persistent rear rotation plus smaller dynamic correction—but they are not two independent confirmations and neither establishes term necessity, a unique law, a response mechanism or causal field attribution. The standardized PPO and corrected CCD mean errors are different estimands: they use different role acquisitions and role sets, retained windows, masks and weighting/normalization contracts, and are not combined arithmetically or described as replication, validation, agreement or triangulation. [M05; M06; M04–M06 reconciliation]
+
+### Discussion paragraph 3 — breadth, steady context and experiment boundary
+
+The interpretation is asymmetric across cases. The Vortex material supports only a comparable-scale, event-relative extension; no Vortex event L2 is currently available. Illusion PPO remains separate capability evidence, while Illusion SR is historical/negative and must not be used to negate or explain the PPO demonstration. Erase has no supported quantitative route under the historical evolving-force-FIFO target. The steady branch is separate contextual evidence: SR’s fitted constant magnitude 3.431 and the V5 endpoint at s=3.55 are related diagnostics only, not an amplitude comparison, cross-chain continuation or proof of the Kármán law. CCD’s constant mean is a field-role comparator, not an action magnitude. The failed potential sign and incomplete Navier–Stokes/momentum/mechanical-energy accounting leave the physical reading bounded. Finally, Module 09 reserves an author-described qualitative open-loop experiment interface: steady streaklines were described as straighter and Illusion shedding as visibly changed, but those observations remain conditional on raw-media provenance and trial linkage. They are not established paper results and do not provide quantitative field matching, calibrated force evidence or experimental validation. [M07; M08; M09; R1 experiment/case-metrics dossier]
+
+### Discussion paragraph 4 — decisive tests that change the ceiling
+
+The next tests should target the exact unresolved links rather than add cases without matched estimands. First, propose same-protocol Legacy Kármán interventions with predeclared compatible roles, windows and estimands for target, PPO, executable SR, constant and zero; do not assume that all roles can share identical phase semantics. Paired or independently parented realizations should be used where the design requires them. The action roles should then be compared at matched amplitude and sign, with the field evaluator carrying the same-chain L2 and case-specific DTW contracts. Second, Vortex requires an audited target/control/zero event acquisition and an event-relative downstream-ROI evaluator at the declared offsets; Erase requires an independently defined target scale and supported roles before any quantitative panel. Third, the persistent/dynamic interpretation requires a complete control-volume Navier–Stokes, momentum and mechanical-energy budget, including the terms currently missing from the partial ledger. Finally, crossing from CFD to experiment requires synchronized, calibrated PIV and body-resolved force measurements with registration, clocks, background blanks, declared repeats and the Module 09 provenance gate. These tests would raise specific claim ceilings; they would not retroactively merge chains or make non-equivalent metrics interchangeable. [M03; M05–M09; R1 experiment/case-metrics dossier]
+
+## Three-paragraph conclusion map
+
+### Conclusion paragraph 1 — answer in evidence order
+
+Open with the named capability: learned control provides wake-signature or visual PPO capability for the declared Kármán, Vortex and Illusion task demonstrations, with the cross-case contracts kept separate. Move immediately to the independent Legacy Kármán spatial result: field matching is supported only for that named case by the complete-cycle mean and phase-resolved L2 comparisons, while DTW is complementary signal evidence. Do not introduce a new number, citation or figure here.
+
+### Conclusion paragraph 2 — strongest interpretation and ceiling
+
+State that the Legacy Kármán action and field evidence supports a bounded control-skeleton interpretation: dominant persistent rear rotation plus a smaller dynamic correction. Name the SR deletion ranking and corrected four-role mean/dynamic CCD organization only as non-equivalent evidence. Make the mandatory boundary explicit: the M04 standardized PPO and M06 corrected CCD ledgers are different estimands and do not provide independent triangulation. The interpretation remains descriptive and bounded; it does not establish a unbounded law, causal explanation, necessity, sufficiency, uniqueness or claim of time-invariant behaviour.
+
+### Conclusion paragraph 3 — limits and one decisive testing program
+
+Close with the asymmetric envelope: Vortex has no event L2 yet; Illusion PPO is separate from negative Illusion SR; Erase lacks a supported quantitative route; steady 3.431 and s=3.55 are contextual diagnostics; theory and budgets remain incomplete; the experiment interface remains author-described and provenance-gated. Name the decisive program compactly: matched same-protocol interventions and roles, event evaluator/acquisitions, same-chain amplitude/sign comparisons, independent parent realizations where needed, complete budgets, and synchronized calibrated PIV/force measurements. The paper therefore establishes named capability across tasks, Legacy Kármán field matching, and a bounded Legacy Kármán control-skeleton interpretation, with the next ceiling set by direct intervention, closure and measurement tests.
+
+## Layer 2 — claim-to-evidence and interface ledger
+
+| Claim or boundary | Exact source/artifact | Chain, solver/geometry, case/role, Re | Comparator, metric/estimand, ROI/window | Status |
+|---|---|---|---|---|
+| Named capability and Legacy Kármán field matching | `ROUND3_BOTTOM_UP/04_KARMAN_PERFORMANCE.md`; `03_CONTRACTS_METRICS.md` | Legacy Re100 Kármán principal; separate V5 Re100 secondary | Named wake-signature/visual PPO capability under distinct cross-case contracts; Legacy target/controlled/zero complete-cycle mean and eight-slot phase L2 in registered ROI; DTW complement | Read; raw fields/masks artifact-audit deferred |
+| Persistent rear term and smaller feedback | `ROUND3_BOTTOM_UP/05_KARMAN_SR_LAW.md`; `tables/term_deletion.md` | Legacy Kármán re-codes 50/100/200/400; native Legacy action | Parent-relative fixed 40-step native DTW deletion; rear constant largest tested | Read; deletion is not causal ablation |
+| Corrected mean/dynamic organization | `ROUND3_BOTTOM_UP/06_KARMAN_FIELD_CCD.md` | Legacy Re100; target, zero, constant mean, DRL; exact common mask | Coordinate-weighted mean error; separately centred non-paired 19×10 residual; CCD action association | Read; descriptive/noncausal |
+| M04/M06 non-equivalence | `00_WAVE_A_COORDINATOR_AUDIT.md` §§28–37; M04/M06 exports | Distinct acquisitions, role sets, windows, masks and chains/contracts | M04 unweighted U0-normalized geometry guard versus M06 coordinate-weighted exact common mask | Read; never arithmetic combination/triangulation |
+| Cross-case ceiling | `ROUND3_BOTTOM_UP/07_CROSS_CASE_EXTENSIONS.md` | Legacy Vortex; V5 Illusion PPO; Legacy Illusion SR/Erase history | No Vortex event L2; Illusion PPO capability; Illusion SR negative; Erase unsupported | Read; gaps preserved |
+| Steady/theory/experiment limits | `ROUND3_BOTTOM_UP/08_STEADY_SYNTHESIS.md`; `ROUND3_BOTTOM_UP/09_EXPERIMENT_AUTHOR_INTERFACE.md`; `ROUND1_BOTTOM_UP/08_EXPERIMENT_AND_CASE_METRICS.md` | Separate V5 steady and Legacy Kármán; author-described open-loop water-tunnel interface | SR 3.431 and V5 s=3.55 contextual; failed sign; incomplete budgets; experiment observations conditional on raw-media provenance | Read; M09 interface ready, final prose/panel blocked |
+| Decisive tests | M03, M05–M09 exports; R1 experiment/case metrics | Matched same-chain roles/interventions; exact event roles; calibrated experiment | Same-protocol metrics, event L2, amplitude/sign, complete budgets, synchronized PIV/force | Open tests, not results |
+
+### Interface ledger
+
+- **Imports:** M03 chain, role, action, Reynolds and metric contracts; M04 Legacy Kármán field-matching result; M05 executable SR/deletion ceiling; M06 corrected four-role mean/dynamic and CCD boundary; M07 cross-case gaps; M08 steady/theory bridge; M09 author-described experiment interface and provenance gate.
+- **Export to final audit:** named capability across tasks, Legacy Kármán field matching, and a bounded Legacy Kármán control-skeleton interpretation. No export carries a pooled metric, cross-chain continuation, causal mechanism, unbounded law or quantitative experiment result.
+- **Genuine blockers:** none for this bounded first-pass text. Retained quantitative Vortex/Erase panels remain blocked by role/evaluator contracts; quantitative experiment remains blocked by missing synchronized calibrated PIV/force data. Hidden artifacts are `artifact-audit deferred` where authorities bind the current claim without conflict.
+
+### Coverage ledger
+
+- **`read`:** Round-3 controls/interface and Wave-A audit; Round-2 freeze/style; ready Modules 03–09; Round-1 experiment/case-specific metric dossier; current authorities cited above. Evidence is read, not independently recomputed or universally artifact-audited.
+- **`mapped`:** package manifests, figure navigation and authority-linked external result roots referenced by Modules 03–09. Mapped is not read, independently verified or artifact-audited.
+- **`not-covered`:** new literature, CFD, retraining, event evaluator, Vortex/Erase acquisitions, complete budgets, synchronized experiment processing and new figures.
+- **`external-inaccessible`:** hidden/symlink-backed raw fields, selected model/normalizer bundles and dense theory/CCD payloads where current authorities bind bounded statements; artifact audit deferred.
+
+## Figure, table and equation contracts
+
+1. **Integrated evidence map:** orders capability, Legacy L2, SR deletion, corrected mean/dynamic CCD, cross-case, steady, theory and experiment. Dashed links mean compatible but non-equivalent observations; unresolved links mark causality and closure gaps. It does not depict a causal chain or pooled score.
+2. **Compact limitations table:** lists chain, case, role, estimand and blocked claim for Vortex, Illusion SR, Erase, steady, theory and experiment. It does not add results or convert missing artifacts into negative findings.
+3. **No new equation or numerical figure is required for the conclusion.** Existing panels retain their own captions and limitations; this first pass does not imply that all proposed panels already exist.
+
+## Claim ladder
+
+**Supported / green:** named learned control provides wake-signature or visual PPO capability under the declared cross-case contracts; independent Legacy Kármán field matching shows the controlled field is closer to target than physical zero under its mean and phase L2 estimands; executable Legacy SR deletion ranks the persistent rear term largest among tested terms; corrected CCD organizes a smaller residual descriptively as action-correlated correction-field modes.
+
+**Bounded / amber:** these results support a Legacy Kármán control-skeleton interpretation consisting of dominant persistent rear rotation plus a smaller dynamic correction; separate steady diagnostics provide contextual information; cross-case demonstrations show named capability breadth under changed contracts.
+
+**Prohibited / red without new evidence:** unbounded transfer, causal explanation, necessity, sufficiency, uniqueness, claim of time-invariant behaviour, momentum restoration, independent triangulation, cross-chain continuation, quantitative Vortex or Erase efficacy, positive Illusion SR, or quantitative experiment claims.
+
+## Anti-repetition and first-pass audit
+
+- **Evidence order:** named capability → Legacy Kármán L2 → executable SR/deletion → corrected four-role mean/dynamic CCD → cross-case breadth → separate steady context → author-described qualitative experiment interface; the conclusion map follows the same order.
+- **Near-collision:** M04/M06 are explicitly different estimands; no arithmetic, replication, validation, agreement or triangulation wording is used. SR 3.431 and steady s=3.55 are related contextual diagnostics only; CCD constant mean is not action magnitude.
+- **Boundary:** no Vortex event L2 is invented; Illusion PPO is not merged with negative Illusion SR; Erase is not repaired from filenames; steady/theory/experiment do not raise the Kármán ceiling.
+- **Terminology:** wake-signature matching, field matching, spatial L2, complementary DTW, control skeleton and action-correlated correction-field modes are used; causal and unbounded readings are excluded.
+- **Layer control:** Layer 1 has four discussion paragraphs plus a three-paragraph conclusion map; Layer 2 carries provenance, coverage, interfaces and contracts. This is a revised candidate for second audit, not a readiness declaration.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/11_FINAL_CONSISTENCY_AUDIT.md

@@ -0,0 +1,128 @@
+# Round 3 coordinator-level final consistency audit
+
+**Status: audit, not manuscript approval.** This coordinator audit reads the Round-2 freeze/style controls, all active Round-3 controls, and Modules 01–10 in full. It checks cross-module terminology, claims, contracts, bridges, redundancy and readiness; it does not recompute scientific artifacts, edit source modules or ledgers, regenerate figures, reconstruct masks, verify hashes, or validate the experiment.
+
+## 1. Scope and complete coverage ledger
+
+**Controlling identity:** *Interpreting learned hydrodynamic cloaking and illusion in a fluidic pinball*. The active controls are the Round-2 `05_REVISED_STRUCTURE_FREEZE.md` and `06_SECTION_LEVEL_JFM_STYLE_GUIDE.md`; Round-3 `.cursor/rules/jfm-round3-section-drafting.mdc`; `00_MASTER_AGENT_PROMPT.md`; `00_QUALITY_GATE.md`; `00_MODULE_INTERFACE_LEDGER.md`; `00_WAVE_A_COORDINATOR_AUDIT.md`; and active Modules `01_INTRODUCTION.md`–`10_LIMITATIONS_CONCLUSION.md`. Module 11 is this audit, not a manuscript section.
+
+| Status | Complete coverage | Boundary |
+|---|---|---|
+| `read` | Round-2 freeze/style; all five Round-3 controls/audits; Modules 01–10, each in full | Read is not independently verified or artifact-audited |
+| `mapped` | Manifests, figure navigation, authority-linked external/symlink paths and artifact identities named by modules | Mapped is not read or numerical authority |
+| `not-covered` | New CFD/training/SR/CCD; raw NPZ/dense arrays; universal hashes; solver-exact mask reconstruction; event evaluator; new figures; complete Erase roles; synchronized experiment processing; new literature search | Outside consistency audit; no claim inferred |
+| `external-inaccessible` | Hidden/external fields, model/normalizer bundles, dense CCD/theory payloads and external/raw facility artifacts | Authority-led `artifact-audit deferred` only where current authority binds a conflict-free bounded statement; retained new panels remain gated |
+
+All active modules are included in the read ledger: M01 Introduction; M02 capability progression; M03 contracts/metrics; M04 Kármán performance; M05 Kármán SR law; M06 Kármán field/CCD; M07 cross-case extensions; M08 steady synthesis; M09 experiment interface; M10 limitations/conclusion. The interface ledger’s `ready` statuses mean ready for downstream dossier use, not manuscript approval or publication-ready artifacts.
+
+## 2. Global terminology audit
+
+Terminology is consistent and should remain frozen:
+
+- **Concept:** `hydrodynamic cloaking` means approach to a declared background/reference; `hydrodynamic illusion` means approach to a declared non-zero target/signature. Neither means universal invisibility or full-state equivalence.
+- **Execution:** `wake-signature matching using forces plus sparse downstream observations`. This does not establish observability or optimal sensing.
+- **Evaluation:** **field matching**, with spatial **L2** primary where supported. **DTW** is complementary, signal-level and case-specific; it is not spatial L2, physical delay, causal diagnosis or a universal cross-case score. Native/normalized DTW and similarity orientation must stay explicit; a higher similarity must never be called a lower error.
+- **Interpretation:** **control skeleton** is a bounded post-evidence interpretation, not a mechanism, unique law, necessity claim or cross-case result.
+- **Dynamic fields:** use exactly **action-correlated correction-field modes**. CCD is descriptive/noncausal and not superior or unique relative to POD.
+
+Pipeline `Level-2/Level-3` and `Stage-3 short/standard gate` remain distinct from spatial L2. Never call a validation level an “L2 gate.”
+
+## 3. Manuscript claim ladder audit
+
+The dossier preserves exactly this ladder:
+
+1. **Named cross-task capability:** named wake-signature or visual PPO capability across declared Kármán, Vortex and Illusion tasks under distinct contracts.
+2. **Legacy Kármán Re100-only independent field matching:** independent spatial field matching only for named Legacy `karman_re100`/Re100 target, controlled and physical-zero roles in the declared downstream ROI; mean and phase L2 remain separate, with DTW complementary.
+3. **Bounded Legacy Kármán/cloak-only control-skeleton interpretation:** executable Legacy SR, corrected four-role mean comparison and a separately centred non-paired residual organized by action-correlated correction-field modes support a bounded dominant persistent rear-rotation plus smaller dynamic-correction reading. This is not causal, necessary, sufficient, unique, optimal, stable, universal or transferable.
+
+M01 and M10 state this ladder; M02 and M04–M09 respect it. Positive SR remains Kármán/cloak-only. Illusion SR is historical/negative, CCD descriptive/noncausal, OID claim-free and steady contextual.
+
+## 4. Legacy/V5 and metric-boundary audit
+
+Legacy and V5 are separate executable chains: never pool values or imply numerical continuation/equivalence. Preserve solver and geometry, body order, action sign/calibration, case/seed/role, comparator, ROI/mask and window in every result. Legacy `Re_code=100` is `Re_D=50` under its Legacy `2D` convention; V5’s similarly labelled Re100 is its own chain. V5 Illusion `0.75` is a target radius ratio under the declared geometry, not silently a diameter ratio. Best-checkpoint discovery, retained evaluation and seed spread are not robustness.
+
+Periodic complete-cycle mean L2, eight-slot phase L2, transient event snapshots, Illusion mean/phase/DTW, Erase candidate mean fields and steady late/profile errors are non-equivalent estimands. Vortex offsets are event-relative, not phase. Steady profiles are not periodic means. Case-specific DTW windows/formulas cannot be pooled.
+
+### Explicit M04/M06 near-collision prohibition
+
+M04 standardized PPO mean errors and M06 corrected CCD mean errors are **different estimands**, despite close magnitudes and nominally coincident x extent. M04 uses three independently acquired target/controlled/physical-zero roles, a geometry guard, unweighted lattice-cell RMS after `U0` normalization and its complete-cycle/phase8 window. M06 uses target/zero/constant/DRL, a retained four-role window, an exact common solver-fluid mask and coordinate-weighted RMS on already nondimensional velocities. Never equate, subtract, average or cross-normalize them; never call them replication, validation, agreement, closure or independent triangulation. M06’s `93.42/6.58` share exists only in its corrected ledger.
+
+## 5. Section sequence and bridge audit
+
+The frozen order is:
+
+`Introduction → contracts/metrics → capability progression → Kármán performance → Kármán SR law → Kármán correction fields/CCD → Vortex/Illusion/Erase extensions → steady context/theory → qualitative experiment → limitations/conclusion`.
+
+The physical progression is explicitly **steady discovery → Kármán → Vortex → Illusion/Erase → qualitative experiment**. The full steady analysis returns later, after Kármán depth and cross-case extensions; this two-pass use preserves chronology without placing the full steady analysis first.
+
+Bridges are coherent: M01 converts gap to contracts; M03 enables bounded progression; M02 selects Kármán depth; M04 turns performance into action-law complexity; M05 turns term ranking into field-accounting; M06 prevents Kármán interpretation transfer; M07 changes temporal/target contracts; M08 contextualizes the persistent reference and theory limits; M09 separates deployment from validation; M10 closes with claim ceiling and decisive tests.
+
+### Duplicate ownership/deletion recommendations
+
+These are synthesis-stage recommendations only; no module is edited:
+
+- M01 P5, M02 P5 and M10 repeat the three-level ladder. M01 owns the full definition; M02 keeps only progression scope; M10 restates it once in conclusion order. Delete package-list repetition.
+- M02 P3 and M04 P1–3 repeat Kármán L2 values. M02 owns the short Fig. 1 preview; M04 owns all detailed values, roles, ROI, windows and interpretation; remove duplicate result sentences during assembly.
+- M04/M06 interface text, M06 P1–2, M08 P5 and M10 P2 repeat the near-collision rule. Keep the full technical statement in the coordinator/M06 interface and shorten later reminders.
+- M05 owns SR formula/deletion; M08 owns V5 steady sign/magnitude context. Remove repeated formula/sweep or any implication of amplitude agreement.
+- M06 owns residual/CCD/POD detail; M08/M10 retain only synthesis-level noncausal limits.
+- M07 owns Illusion PPO versus negative SR; M10 states only the boundary. M09 owns the experiment provenance checklist; M10 retains only the qualitative/open-loop handoff.
+
+## 6. Figure/table/equation readiness matrix
+
+No status below implies panels already exist.
+
+- **Fig. 1:** text-ready as Kármán-dominant progression; steady, Kármán, Vortex and V5 `ill_075L` panels are dependency-gated. No experiment panel. Optional Re400 marker is drop-first.
+- **Plant/action/ROI contracts:** text/table-ready; redraw is production work and does not prove observability, chain equivalence or exact masks.
+- **Kármán L2:** text-ready from bound summaries; panel-ready only with raw role/target/manifest/rendering support. Geometry-guarded ROI and mask limitation remain captioned.
+- **SR:** equation/text-ready; deletion table is bounded. Standardized PPO/SR/Zero panel is dependency-gated and must be omitted without exact same-protocol artifacts.
+- **CCD:** text-ready under corrected four-role estimand; panels are dependency-gated on source publication arrays. Mean precedes residual/modes; POD cannot imply CCD superiority.
+- **Cross-case:** text-ready for bounded Vortex/Illusion capability. Vortex quantitative event L2 is **blocked** pending exact roles, ROI/mask, offsets and evaluator; Illusion field L2 is conditional; Erase quantitative panel is **blocked**.
+- **Steady:** text-ready as contextual V5 endpoint/sign/theory limit; profiles, reverse/MFS panels are dependency-gated, with MFS blocked until gates close.
+- **Experiment:** author-supply/provenance-gated; no quantitative validation panel.
+- **Integrated map/limitations table:** text-ready as noncausal synthesis aid; not a pooled score or causal graph. Conclusion needs no new equation/figure.
+
+## 7. Literature/citation identity audit
+
+The style guide records ten exact JFM identities at `full-PDF` level: Deng et al. (2020), Cornejo Maceda et al. (2021), Rabault et al. (2019), Paris et al. (2021), Li & Zhang (2022), Xia et al. (2024), Wang et al. (2024), Loiseau et al. (2018), Gautier et al. (2015) and Mao et al. (2015), with DOIs retained there. M01 records the exact DOI identities for Pendry et al. (2006), Leonhardt (2006), Vasquez et al. (2009), Ma et al. (2013) and Urzhumov & Smith (2012). Repository dossiers are labelled `full-report`/`read` where applicable; literature supplies context/style precedent only, never internal evidence or priority.
+
+Unresolved gaps: `Ren19b`, exhaustive sentence-level JFM coding, broader facility literature, and any metadata/read-level identity not already established in the controlling dossiers. Do not invent citations, DOI, quotations or priority language. No new citation or verification is added here.
+
+## 8. Experiment audit
+
+The experiment is **author-described qualitative open-loop dye only**, and provenance-gated. Allowed observations are that steady operation appeared to produce straighter dye streaklines and Illusion operation visibly changed shedding frequency, subject to raw-media provenance and trial linkage. There is no synchronized calibrated force/PIV validation, quantitative field match, closed-loop experimental validation, quantitative shedding frequency or causal explanation. Thermal convection is a suspected confound, not a proven sole cause. Missing apparatus, conditions, action waveform/sign, trial IDs, raw media, scale/timing, calibration, synchronization, repeats and permissions must be supplied or marked unrecoverable; otherwise omit the panel.
+
+## 9. Findings with severity and exact location
+
+`PASS` means text-ready for author synthesis, not manuscript approval. `REVISE` names the targeted file/location. `BLOCK` applies only to required content that cannot responsibly be drafted; artifact blockers are separated from module-text readiness.
+
+### PASS — module text readiness
+
+- M01 `01_INTRODUCTION.md`; M02 `02_CAPABILITY_PROGRESSION.md`; M03 `03_CONTRACTS_METRICS.md`; M04 `04_KARMAN_PERFORMANCE.md`; M05 `05_KARMAN_SR_LAW.md`; M06 `06_KARMAN_FIELD_CCD.md`; M07 `07_CROSS_CASE_EXTENSIONS.md`; M08 `08_STEADY_SYNTHESIS.md`; M09 `09_EXPERIMENT_AUTHOR_INTERFACE.md` as an author interface; and M10 `10_LIMITATIONS_CONCLUSION.md` all preserve their scope and claim ceilings. M09’s final prose is not yet supplied, by design.
+
+### REVISE — exact synthesis changes
+
+- `01_INTRODUCTION.md` P5 and `10_LIMITATIONS_CONCLUSION.md` Discussion/Conclusion: retain the exact three-level ladder once as full definition and once as concise conclusion; delete repeated package-list versions from M02/M04/M08/M10.
+- `02_CAPABILITY_PROGRESSION.md` P3 and `04_KARMAN_PERFORMANCE.md` P1–3: M02 may preview Fig. 1; M04 owns detailed Legacy L2/DTW values and contracts. Delete duplicate numerical result prose during assembly.
+- `06_KARMAN_FIELD_CCD.md` P1–2 and `08_STEADY_SYNTHESIS.md` P5/`10_LIMITATIONS_CONCLUSION.md` P2: retain the full M04/M06 different-estimand prohibition once; later mentions must not imply agreement or independent validation.
+- `05_KARMAN_SR_LAW.md` P3–5 and `08_STEADY_SYNTHESIS.md` P5: keep SR formula/deletion and steady sign/magnitude in separate ownership; delete any amplitude-agreement or continuation implication.
+- `09_EXPERIMENT_AUTHOR_INTERFACE.md` §§2–Figure gate and `10_LIMITATIONS_CONCLUSION.md` P3: M09 owns provenance; M10 keeps only qualitative/open-loop/provenance-gated status.
+- Final manuscript assembly across all files: run a whitespace and LaTeX terminology pass for `Kármán`, `Re_D`, `Re_code`, `L2`, `DTW`, `E_mean`, `E_phase8`, `\text{}` labels, action-order notation and escaped `%`; choose display notation once without changing chain-local conventions.
+
+### BLOCK — retained content only
+
+- `02_CAPABILITY_PROGRESSION.md` Fig. 1 Vortex event-L2 panel: blocked until exact target/control/zero roles, target identity, common ROI/mask, offsets and evaluator output exist.
+- `07_CROSS_CASE_EXTENSIONS.md` Erase quantitative panel/efficacy: blocked by unsupported target-scale and independent-role contract; filenames do not establish results.
+- `05_KARMAN_SR_LAW.md` standardized PPO/SR/Zero numerical panel: blocked unless exact same-protocol role artifacts and comparator/window values are bound; text is unaffected if dropped.
+- `09_EXPERIMENT_AUTHOR_INTERFACE.md` image/result panel: blocked until raw-media provenance, trial linkage, conditions and permission pass; no quantitative validation claim.
+- `08_STEADY_SYNTHESIS.md` new MFS field panel: blocked until listed validation gates close; the bounded theory/sign failure remains usable.
+
+These are panel/artifact blockers, not blockers to the bounded text. No current blocker prevents author synthesis of the text dossier.
+
+## 10. Final disposition
+
+**READY FOR AUTHOR MANUSCRIPT SYNTHESIS, with this file remaining an audit rather than manuscript approval.** Before polished prose, the author must adopt the fixed terminology and exact claim ladder; assemble the frozen sequence and delete duplicated result paragraphs according to the ownership map; make M04 the sole detailed owner of Legacy Kármán independent field matching; preserve the M04/M06 prohibition; decide which optional panels are dropped or sourced; complete the LaTeX/whitespace pass; and supply or omit the experiment provenance-gated material.
+
+**Author supply list:** authority-bound source/rendering for each retained panel; same-protocol PPO/SR/Zero artifacts if retained; audited Vortex event roles/evaluator; independent Erase roles if proposed; validated MFS artifacts if retained; experiment facility/geometry/conditions, action waveform/sign, trial IDs, raw media, calibration/synchronization, repeats and permissions; and final bibliography/read-level confirmation without invented metadata or priority claims.
+
+This is a final **consistency audit**, not manuscript approval.

docs/JFM_WYQ/ROUND3_BOTTOM_UP/README.md

@@ -0,0 +1,16 @@
+# Round 3 — Bottom-Up Section Modules
+
+Round 3 converts the Round-1 evidence dossiers and current package authority into author-readable, section-level drafts/dossiers approaching JFM prose. It is neither another raw index nor polished final manuscript prose. The parent agent coordinates dispatch, interfaces, audits and revisions; section agents do not self-declare manuscript readiness.
+
+## Controlling inputs
+
+Every module reads, in full or with explicit scoped coverage, `ROUND2_TOP_DOWN/05_REVISED_STRUCTURE_FREEZE.md`, `06_SECTION_LEVEL_JFM_STYLE_GUIDE.md`, relevant Round-1 dossiers, and relevant current authority documents/manifests. Hidden/raw/external artifacts may be deferred only when an authority document describes the deferral. Legacy and V5 remain separate, and every number retains its artifact, comparator, metric and window.
+
+## Phases
+
+- **Wave A — hard evidence:** dispatch contracts/metrics, Kármán performance, Kármán SR law, and Kármán field/CCD modules. The parent reviews first passes for evidence completeness, narrative coherence/JFM style, interfaces, claim ceiling and redundancy, then returns targeted revision prompts. A module is ready only after the second audit.
+- **Wave B — extensions and synthesis:** dispatch cross-case vortex/illusion/erase, then steady context/physical synthesis. Keep case-specific metrics distinct; transfer only explicitly licensed definitions or bounded context.
+- **Wave C — framing:** draft introduction, capability/progression, qualitative experiment author interface, and limitations/conclusion after the analytical modules stabilize. Frank retains authorship of the experiment subsection.
+- **Final audit:** coordinator performs whole-manuscript terminology, chain, metric, bridge, claim-ceiling and redundancy consistency audit; no new evidence is invented during synthesis.
+
+See `00_MASTER_AGENT_PROMPT.md`, `00_QUALITY_GATE.md`, and `00_MODULE_INTERFACE_LEDGER.md` for dispatch, review and interface contracts.