# Citation And Provenance TODO

This package is an independent bilingual draft package. It is not yet a submission-ready citation package.

## Citation Discipline

The copied reports in `references/` are working materials, not final bibliographic authorities. Before submission, every formal citation should be checked against the original paper, book, DOI, arXiv page, or dataset.

## Required Citation Tasks

| Topic | Needed Formal Source Type | Current Package Anchor | Action |
|---|---|---|---|
| Nonnormality, transient growth, pseudospectra | Original control/math references or books | `references/final_report.md`, `references/deep-research-report (49).md` | Extract verified BibTeX entries from DOI/original sources. |
| Covariance propagation in linear systems | Original stochastic linear systems/control references | `evidence/evidence_bank.md`, E01-E03 | Add formal citations to the model section. |
| Koopman / EDMDc surrogate modeling | Original Koopman and EDMDc papers | `evidence/evidence_bank.md`, E07 | Add citations for local lifted surrogate fitting. |
| Action smoothing / action regularization in RL | Original smooth-RL and action-regularization papers | `references/final_report.md` | Add citations in the smoothing critique section. |
| Safe RL, shielding, and projection | Original safe-RL and safety-filter references | `references/final_report.md`, E08 | Add citations in response and limitations sections. |
| CG-RVC internal evidence | Internal experiment files and raw outputs | `evidence/project_evidence_dossier.md`, `evidence/experiment_claim_matrix.md` | Link final figures/tables to raw CSV/JSON and plotting scripts. |

## Figure Provenance Tasks

| Figure | Current File | Required Before Submission |
|---|---|---|
| Source-amplifier diagram | `figures/source_amplifier_layers.png` | Decide whether to redraw in final style and include source file. |
| CI-1 | `figures/fig1_ci1_amplifier_isolation.png` | Link to exact result data and plotting script from causal-isolation output. |
| CI-2 | `figures/fig2_ci2_source_intervention.png` | Link to exact result data and colored-input interpretation notes. |
| 2D ablation | `figures/suite_high_noise_comparison.png` or `figures/caps_style_method_comparison_v4_1.png` | Link to matched ablation table data and seed protocol. |
| Residual-feedback proxy | `figures/conditional_variance_proxy_summary.png` | Link to finite-difference actor-Jacobian script and output CSV. |
| Full3D | `figures/full3d_5seed_high_noise_summary.png` | Link to Full3D metrics and clarify simulation-only status. |
| ControlGym | `figures/controlgym_suite_high_noise_comparison.png` | Link to AC3/CM2 raw outputs and preserve boundary-case wording. |

## Experimental Decision Still Open

CI-3 source-direction scan is currently described as a desired enhancement rather than verified completed evidence. Before submission, choose one:

1. Run CI-3 and include it as a direct test of direction-aware residual covariance.
2. Keep CI-3 as future work and do not present it as existing evidence.

## Claim Boundaries To Preserve

- Do not claim global nonlinear stability.
- Do not claim global safety guarantees.
- Do not claim hardware validation.
- Do not claim that P-ALE directly reduces nonnormality.
- Do not claim ordinary action smoothing is useless in general.
