# Project Evidence Index

Generated from a repository-wide evidence search of `D:/kooopam_rl_low_varience`.

## Scan Scope

The scan walked the project tree while excluding obvious runtime/vendor noise such as `.git`, `.venv`, cache folders, plugin temp folders, and package dependency internals. It indexed:

- 50,201 project files after exclusions;
- 38,671 files with potentially useful extensions;
- 3,591 Markdown/TeX files for manuscript evidence;
- 25,170 code/JSON/CSV/TXT files for implementation and result evidence;
- 4,484 figure/PDF/DrawIO candidates with relevant names.

Machine-readable scan artifacts:

- `project_file_inventory.json`
- `project_markdown_tex_evidence_candidates.json`
- `project_code_result_evidence_candidates.json`
- `project_visual_evidence_candidates.json`

Human-readable project evidence maps copied into this folder:

- `evidence_materials/project_indices/PROJECT_EXPERIMENT_EVIDENCE_MAP.md`
- `evidence_materials/project_indices/PROJECT_COMPLETE_SUMMARY_EVIDENCE_INDEX_20260521.md`
- `project_evidence_dossier.md`
- `experiment_claim_matrix.md`

## Highest-Value Evidence Families

| Family | Canonical Sources | Evidence Type | Use in New Paper |
|---|---|---|---|
| Existing source-amplifier long paper | `paper_spine_tac_source_amplifier_20260521_best/final_paper/main.tex` | Integrated theory, method, experiment tables, limitations | Mine for exact wording, numbers, and caveats; compress into 6-page problem paper. |
| Wiley/TAC submission packages | `paper_spine_tac_source_amplifier_20260521_best/submission_v2_From_Action_Smoothing_to_Source_Amplifier_Control_2026-05-22/` | Finalized figures, selected results, submission assets | Use as the cleanest figure/result source. |
| Early Chinese CG-RVC drafts | `variance_regularized_safe_rl/PAPER_FULL_DRAFT_CN.md`; package retry copies | Chinese explanation of Koopman-Lyapunov proxy certificate and variance-aware residual RL | Use for Chinese reasoning and fallback details. |
| Controlled intervention figures | `fig1_ci1_amplifier_isolation.png`; `fig2_ci2_source_intervention.png` | CI-1 and CI-2 mechanism evidence | Direct support for separating amplifier and source. |
| 2D constrained RL ablation | Existing long paper table and RL summary JSONs | Matched component comparison, projection burden, actor-Jacobian proxy | Direct support for "ordinary smoothing is insufficient" and "source shaping reduces repair." |
| Full3D quadrotor simulation | `full3d_5seed_high_noise_summary.png`, Full3D result table | 12-state, 4-motor simulation evidence | External simulation relevance, not real-flight validation. |
| ControlGym stress test | ControlGym selected results and table | Supportive AC3 case plus CM2 failure/boundary case | Limitations and failure modes. |
| Koopman-Lyapunov stability materials | `koopman_lyapunov_repro_variance_constraint_delivery/.../paper_draft*.tex` | Stability-constrained Koopman/ALE background | Supports surrogate/certificate wording and audit caution. |

## Selected Figures Copied Into This Folder

Copied figures are under `evidence_materials/selected_figures/`.

| Figure File | Original Source | Supports |
|---|---|---|
| `source_amplifier_layers.png` | `variance_regularized_safe_rl/paper_figures/cgrvc_revision_source_amplifier_layers.png` | Conceptual source-amplifier pipeline. |
| `fig1_ci1_amplifier_isolation.png` | `paper_spine_tac_source_amplifier_20260521_best/.../figures_v4_1/fig1_ci1_amplifier_isolation.png` | CI-1 amplifier isolation. |
| `fig2_ci2_source_intervention.png` | `paper_spine_tac_source_amplifier_20260521_best/.../figures_v4_1/fig2_ci2_source_intervention.png` | CI-2 source-side intervention. |
| `full3d_5seed_high_noise_summary.png` | `paper_spine_tac_source_amplifier_20260521_best/.../figures_v4_1/full3d_5seed_high_noise_summary.png` | Full3D 5-seed high-noise summary. |
| `caps_style_method_comparison_v4_1.png` | `paper_spine_tac_source_amplifier_20260521_best/.../figures_v4_1/caps_style_method_comparison_v4_1.png` | Ordinary smoothing vs certificate-guided control. |
| `suite_high_noise_comparison.png` | `paper_spine_tac_source_amplifier_20260521_best/.../figures_v4_1/suite_high_noise_comparison.png` | 2D high-noise method comparison. |
| `conditional_variance_proxy_summary.png` | `paper_spine_tac_source_amplifier_20260521_best/.../results_selected/conditional_variance_proxy/conditional_variance_proxy_summary.png` | Residual feedback / conditional variance proxy. |
| `controlgym_suite_high_noise_comparison.png` | `paper_spine_tac_source_amplifier_20260521_best/.../results_selected/controlgym_5seed/suite_high_noise_comparison.png` | ControlGym stress-test visualization. |

## Key Numeric Evidence

| Claim | Evidence | Source |
|---|---|---|
| Nonnormal geometry can independently amplify covariance under fixed source. | In CI-1, `kappa(V)` increases from about 1.0 to 20.05, state covariance trace increases from about 0.37 to 15.66, and peak transient gain increases from about 1.0 to 5.55. | `paper_spine_tac_source_amplifier_20260521_best/final_paper/main.tex`, CI-1 section. |
| Source-side intervention can reduce downstream covariance under a fixed amplifier. | In CI-2, action variance decreases from 0.03992 to 0.00317 and state covariance trace decreases from 15.849 to 12.393 while peak transient gain remains about 5.5486. | Same long paper, CI-2 section. |
| Ordinary scalar/temporal smoothing is insufficient in the 2D high-noise matched ablation. | Direct TD3, plain `Var(u)`, and action-diff baselines keep dense violation around 0.93 and B-L max around 92-162/109; CG-RVC reaches dense violation 0 and B-L max 5.239. | Table `tab:v3_pale`. |
| P-ALE, smoothing, and projection must be combined. | P-ALE alone has dense violation 0.9389; P-ALE+smoothing has dense violation 0.9278; P-ALE+projection has applied variance 0.0940 and B-L max 128.767; full method has applied variance 0.0060 and B-L max 5.239. | Table `tab:v3_pale`. |
| Source shaping reduces projection repair burden. | Projection-only normalized correction is 0.09362; P-ALE+projection is 0.05426; CG-RVC is 0.01093. | Table `tab:projection_burden`. |
| Full method reduces actor sensitivity in a residual-feedback diagnostic. | Actor-Jacobian proxy drops from 16.23 for Direct TD3 to 0.274 for CG-RVC; total local perturbation variance drops from 1.6078 to 0.000397. | Table `tab:residual_feedback_proxy`. |
| Full3D simulation supports mechanism relevance in a 12-state, 4-motor setting. | Filtering reduces state covariance and motor variance in all four Full3D high-noise scenarios. | Table `tab:full3d_high_noise`; copied Full3D figure. |
| ControlGym gives both support and a boundary case. | AC3 improves: state trace 1.314 to 0.521, applied variance 0.00447 to 0.00180, B-L max 9.243 to 6.428. CM2 is projection-heavy: applied variance rises from 0.01200 to 0.85042 and strict infeasible rate becomes 1.0. | Table `tab:controlgym_stress`. |
| The certificate must be interpreted cautiously. | Surrogate audit reports `rho(K_proj)=0.90` but `gamma_P=1.43` and Gramian condition `1.86e12`; the fitted certificate is empirical diagnostic, not active ISS guarantee. | Evidence-chain table in long paper. |

## Recommended Use in the New 6-Page Paper

1. Use CI-1 and CI-2 as the first empirical figure because they prove the mechanism separation most cleanly.
2. Use one compressed 2D ablation panel/table to show ordinary smoothing and projection-only baselines are insufficient.
3. Use projection burden as a short, high-value diagnostic table or text statistic.
4. Use Full3D only as simulation-level external relevance.
5. Use ControlGym mainly in limitations/failure modes.
6. Keep the surrogate audit in limitations to avoid overclaiming a global certificate.

## Acceptance Checks From the Expanded Scan

| Check | Status | Notes |
|---|---|---|
| Reports copied, not moved. | Done | Original download files remain outside this folder; copied versions are in `references/`. |
| Whole-project scan preserved. | Done | JSON scan artifacts record file inventory, manuscript candidates, code/result candidates, and visual candidates. |
| Source map explains report roles. | Done | `source_map.md`, `source_inventory.md`, and `references/REFERENCE_INDEX.md` divide reference reports from internal project evidence. |
| Every main experiment has manipulated/fixed variables and question. | Done for known evidence | See `experiment_claim_matrix.md`; CI-3 remains planned/unverified. |
| Claim level stays local/simulation-level. | Done in planning artifacts | `claim_register.md`, `project_evidence_dossier.md`, and `experiment_claim_matrix.md` all carry boundary language. |
| CG-RVC remains a response framework, not the only protagonist. | Done in paper plan | The new structure keeps the paper centered on nonnormal source-amplifier diagnosis/control. |
