@researai/deepscientist 1.5.16 → 1.6.0

package/AISB/catalog/aisb.t3.044_rgvi.yaml

@@ -0,0 +1,224 @@
+id: aisb.t3.044_rgvi
+name: Reference-Guided Video Inpainting (RGVI)
+version: 0.1.0
+one_line: Flow-guided video inpainting combining one-shot pixel propagation with Stable
+  Diffusion reference generation, evaluated on the HQVI benchmark.
+task_description: 'RGVI is a video inpainting framework that decouples content propagation
+  from generation using a four-stage pipeline: (1) internal pixel propagation via
+  one-shot pulling with optical flows computed by RAFT, (2) high-quality reference
+  generation using Stable Diffusion Inpainting with text guidance, (3) reference propagation
+  across frames, and (4) per-frame completion for remaining missing regions. The framework
+  introduces one-shot pixel pulling that combines flow tracing and grid warping to
+  maintain sub-pixel accuracy while avoiding re-sampling artifacts inherent in recurrent
+  warping approaches. The accompanying HQVI benchmark evaluates VI methods on realistically
+  composed videos generated via alpha matte composition, providing ground truth for
+  object removal tasks. Supports inference at 240p, 480p, and 2K resolutions.
+
+  '
+task_mode: experiment_driven
+requires_execution: true
+requires_paper: true
+integrity_level: cas_plus_canary
+snapshot_status: external_eval_required
+support_level: recovery
+time_band: 1-3d
+cost_band: high
+difficulty: hard
+data_access: public
+primary_outputs:
+- psnr
+- ssim
+- lpips
+- vfid
+- video_inpainting_results
+launch_profiles:
+- id: quick_eval
+  label: Quick Eval
+  description: Run RGVI inference and evaluation on a single video sequence. Validates
+    pipeline functionality and metric computation.
+- id: full_eval
+  label: Full Eval
+  description: Run the complete evaluation workflow across HQVI and supplementary
+    benchmarks (DAVIS, DAVI, YTVI). Produces comprehensive comparison tables against
+    baseline methods including STTN, FGVC, FuseFormer, E2FGVI, and ProPainter.
+- id: hqvi_only
+  label: HQVI Benchmark
+  description: Execute the standard HQVI evaluation route only, including both positive
+    and negative annotation masks for object removal scenarios.
+dataset_download:
+  primary_method: external_links
+  sources:
+  - name: HQVI Benchmark
+    url: https://drive.google.com/file/d/1eiscxJO2o8qVlHX52sul2Pz8elOwSWUP/view?usp=drive_link
+    size_gb: null
+    required: true
+  - name: DAVIS
+    url: https://drive.google.com/file/d/1fBdMdhyStDGurVqgIp8_1SMVb0uIRqIH/view?usp=drive_link
+    required: true
+  - name: DAVI
+    url: https://drive.google.com/file/d/1i-hNki4Jrmiqg6226AIgN1v5PIL1Epm6/view?usp=drive_link
+    required: false
+  - name: YTVI
+    url: https://drive.google.com/file/d/1MpJCdakKkMZIHg3cqQ2epVxRo0YKCrGY/view?usp=drive_link
+    required: false
+  - name: YouTube-VOS (for PFCNet training only)
+    url: https://competitions.codalab.org/competitions/19544
+    required: false
+  - name: FCNet Weights
+    url: https://drive.google.com/file/d/1KNetMWeYVlgrhgguw45uRfoJDmljw5hT/view?usp=drive_link
+    required: true
+  - name: I3D Weights
+    url: https://drive.google.com/file/d/1NhI0rDu7BeqNm0oyxS0jHxjQqhfelx8I/view?usp=drive_link
+    required: true
+  - name: Stable Diffusion Inpainting Weights
+    url: https://huggingface.co/runwayml/stable-diffusion-inpainting
+    required: true
+  - name: RAFT Optical Flow (pretrained)
+    url: bundled_with_torchvision
+    required: true
+  - name: PFCNet Weights (optional)
+    url: https://drive.google.com/file/d/1wknOIQmOnzPtLpN1Ydfb698tUZVOYuKF/view?usp=drive_link
+    required: false
+  notes:
+  - Stable Diffusion Inpainting weights must be placed at /sd2_inpaint or configured
+    in rgvi.py
+  - FCNet and I3D weights must be placed in the weights/ directory
+  - Pre-computed results for baseline methods (STTN, FGVC, FuseFormer, E2FGVI, ProPainter)
+    available for download
+credential_requirements:
+  mode: external_access
+  items:
+  - Google Drive access for dataset downloads
+  - Hugging Face access for Stable Diffusion weights
+  notes:
+  - Some links may require institutional Google account for access
+resources:
+  minimum:
+    cpu_cores: 16
+    ram_gb: 64
+    disk_gb: 200
+    gpu_count: 1
+    gpu_vram_gb: 24
+    notes: Single GPU capable of running Stable Diffusion in float16
+  recommended:
+    cpu_cores: 32
+    ram_gb: 128
+    disk_gb: 400
+    gpu_count: 2
+    gpu_vram_gb: 48
+    notes: Dual GPU recommended for faster inference at 2K resolution; Stable Diffusion
+      runs on primary GPU with float16
+environment:
+  python: '3.8'
+  cuda: '11.7'
+  pytorch: 1.11.0
+  flash_attn: null
+  key_packages:
+  - torch>=1.11.0
+  - torchvision>=0.16.0
+  - transformers==4.30.2
+  - diffusers==0.21.0
+  - lpips
+  - scikit-image>=0.19.0
+  - opencv-python
+  - pillow
+  - numpy
+  notes:
+  - PyTorch with torchvision required for RAFT optical flow model (tv.models.optical_flow.raft_large)
+  - Stable Diffusion Inpainting loaded via StableDiffusionInpaintPipeline
+  - See bundled requirements.txt for complete dependency list
+risk_flags:
+- large_model_download
+- non_commercial_only
+- external_data_dependency
+risk_notes:
+- Stable Diffusion weights are large; ensure sufficient disk space and download time
+- CC BY-NC License restricts commercial use of RGVI components
+- FCNet and I3D from ProPainter are under NTU S-Lab License 1.0
+- Google Drive links may expire or require authentication
+recommended_when: 'Use this benchmark when evaluating video inpainting methods on
+  realistic object removal and content generation tasks. Particularly suited for methods
+  leveraging flow-based propagation with generative completion. Appropriate for research
+  on temporal consistency in video editing, optical flow-guided methods, and diffusion-based
+  video synthesis. HQVI benchmark provides ground truth for quantitative evaluation
+  of object removal quality.
+
+  '
+not_recommended_when: 'Do not use this benchmark if the target application is strictly
+  image-level inpainting, as the framework requires multi-frame video processing and
+  optical flow computation. Avoid if storage constraints prevent hosting large video
+  datasets (HQVI, DAVIS, DAVI, YTVI combined). Not appropriate for real-time applications;
+  inference time scales with video length and resolution. Do not use for commercial
+  products due to CC BY-NC licensing restrictions on core components and Stable Diffusion
+  licensing terms.
+
+  '
+paper:
+  title: Elevating Flow-Guided Video Inpainting with Reference Generation
+  venue: AAAI 2025
+  year: 2025
+  url: https://arxiv.org/abs/2412.08975
+  arxiv_id: '2412.08975'
+  authors:
+  - Suhwan Cho (Yonsei University)
+  - Seoung Wug Oh (Adobe Research)
+  - Sangyoun Lee (Yonsei University)
+  - Joon-Young Lee (Adobe Research)
+  license: CC BY-NC 4.0
+download:
+  url: https://github.com/ResearAI/DeepScientist/releases/download/aisb-v0.0.1/aisb.t3.044_rgvi.zip
+  archive_type: zip
+  local_dir_name: paper-44-RGVI
+  provider: github_release
+  repo: ResearAI/DeepScientist
+  tag: aisb-v0.0.1
+  asset_name: aisb.t3.044_rgvi.zip
+  sha256: 419a85def288a9e4928a0de7c5fd4593207ee4b467964394feb4422d5d3828d2
+  size_bytes: 40445
+display:
+  palette_seed: forest-indigo-frame
+  art_style: cinematic-repair
+  accent_priority: high
+  tags:
+  - video-inpainting
+  - flow-guidance
+  - diffusion-models
+  - optical-flow
+  - temporal-consistency
+image_path: ../image/044_aisb.t3.044_rgvi.jpg
+operational_notes: 'Execution workflow:
+
+  1. Place pretrained weights in weights/ directory (FCNet.pth, i3d_rgb_imagenet.pth)
+
+  2. Configure Stable Diffusion Inpainting path in rgvi.py (default: /sd2_inpaint)
+
+  3. For inference: python run.py --root <dataset_path> --res <240p|480p|2K> --seq
+  <sequence_name>
+
+  4. For evaluation: python post.py --root <dataset_path> --res <resolution>
+
+
+  Resolution support: 240p (fast evaluation), 480p (balanced), 2K (high-quality)
+
+  Pre-computed baselines available for comparison without full re-runs
+
+  LPIPS and I3D models loaded at startup; first inference may be slow
+
+  '
+verification_checklist: 'Before execution, verify:
+
+  - [ ] Testing dataset selection (HQVI, DAVIS, DAVI, YTVI)
+
+  - [ ] GPU availability and CUDA configuration
+
+  - [ ] Input resolution selection (240p/480p/2K)
+
+  - [ ] Text prompt for generation mode (optional)
+
+  - [ ] Pre-trained model paths (SDI, FCNet, I3D)
+
+  - [ ] Dataset root directory specification for post.py
+
+  - [ ] Sufficient disk space for outputs
+
+  '

package/AISB/catalog/aisb.t3.044_rgvi.zh.yaml

@@ -0,0 +1,176 @@
+id: aisb.t3.044_rgvi
+name: Reference-Guided Video Inpainting (RGVI)
+version: 0.1.0
+one_line: 结合单次像素传播与Stable Diffusion参考生成的光流引导视频修复，在HQVI基准上评估。
+task_description: |
+  RGVI是一个视频修复框架，通过四阶段流程将内容传播与生成解耦：(1) 使用RAFT计算光流进行单次拉取实现内部像素传播，(2) 使用Stable Diffusion修复模型结合文本引导生成高质量参考图像，(3) 参考图像跨帧传播，(4) 对剩余缺失区域逐帧补全。该框架引入的单次像素拉取结合了流追踪和网格变形，在保持亚像素精度的同时避免了循环变形方法固有的重采样伪影。随附的HQVI基准通过Alpha抠图合成生成逼真的视频来评估VI方法，为目标移除任务提供真值。支持240p、480p和2K分辨率的推理。
+task_mode: experiment_driven
+requires_execution: true
+requires_paper: true
+integrity_level: cas_plus_canary
+snapshot_status: external_eval_required
+support_level: recovery
+time_band: 1-3d
+cost_band: high
+difficulty: hard
+data_access: public
+primary_outputs:
+- psnr
+- ssim
+- lpips
+- vfid
+- video_inpainting_results
+launch_profiles:
+- id: quick_eval
+  label: 快速评估
+  description: 在单个视频序列上运行RGVI推理和评估。验证流程功能和指标计算。
+- id: full_eval
+  label: 完整评估
+  description: 在HQVI及补充基准（DAVIS、DAVI、YTVI）上运行完整评估流程。生成与STTN、FGVC、FuseFormer、E2FGVI、ProPainter等基线方法的综合对比表。
+- id: hqvi_only
+  label: HQVI基准
+  description: 仅执行标准HQVI评估流程，包括目标移除场景的正负标注掩码。
+dataset_download:
+  primary_method: external_links
+  sources:
+  - name: HQVI Benchmark
+    url: https://drive.google.com/file/d/1eiscxJO2o8qVlHX52sul2Pz8elOwSWUP/view?usp=drive_link
+    size_gb: null
+    required: true
+  - name: DAVIS
+    url: https://drive.google.com/file/d/1fBdMdhyStDGurVqgIp8_1SMVb0uIRqIH/view?usp=drive_link
+    required: true
+  - name: DAVI
+    url: https://drive.google.com/file/d/1i-hNki4Jrmiqg6226AIgN1v5PIL1Epm6/view?usp=drive_link
+    required: false
+  - name: YTVI
+    url: https://drive.google.com/file/d/1MpJCdakKkMZIHg3cqQ2epVxRo0YKCrGY/view?usp=drive_link
+    required: false
+  - name: YouTube-VOS (for PFCNet training only)
+    url: https://competitions.codalab.org/competitions/19544
+    required: false
+  - name: FCNet Weights
+    url: https://drive.google.com/file/d/1KNetMWeYVlgrhgguw45uRfoJDmljw5hT/view?usp=drive_link
+    required: true
+  - name: I3D Weights
+    url: https://drive.google.com/file/d/1NhI0rDu7BeqNm0oyxS0jHxjQqhfelx8I/view?usp=drive_link
+    required: true
+  - name: Stable Diffusion Inpainting Weights
+    url: https://huggingface.co/runwayml/stable-diffusion-inpainting
+    required: true
+  - name: RAFT Optical Flow (pretrained)
+    url: bundled_with_torchvision
+    required: true
+  - name: PFCNet Weights (optional)
+    url: https://drive.google.com/file/d/1wknOIQmOnzPtLpN1Ydfb698tUZVOYuKF/view?usp=drive_link
+    required: false
+  notes:
+  - Stable Diffusion修复权重必须放置在/sd2_inpaint或配置于rgvi.py中
+  - FCNet和I3D权重必须放置在weights/目录下
+  - STTN、FGVC、FuseFormer、E2FGVI、ProPainter等基线方法的预计算结果可下载
+credential_requirements:
+  mode: external_access
+  items:
+  - Google Drive access for dataset downloads
+  - Hugging Face access for Stable Diffusion weights
+  notes:
+  - 部分链接可能需要机构Google账号才能访问
+resources:
+  minimum:
+    cpu_cores: 16
+    ram_gb: 64
+    disk_gb: 200
+    gpu_count: 1
+    gpu_vram_gb: 24
+    notes: 单GPU需能以float16运行Stable Diffusion
+  recommended:
+    cpu_cores: 32
+    ram_gb: 128
+    disk_gb: 400
+    gpu_count: 2
+    gpu_vram_gb: 48
+    notes: 建议双GPU以加速2K分辨率推理；Stable Diffusion在主GPU上以float16运行
+environment:
+  python: '3.8'
+  cuda: '11.7'
+  pytorch: 1.11.0
+  flash_attn: null
+  key_packages:
+  - torch>=1.11.0
+  - torchvision>=0.16.0
+  - transformers==4.30.2
+  - diffusers==0.21.0
+  - lpips
+  - scikit-image>=0.19.0
+  - opencv-python
+  - pillow
+  - numpy
+  notes:
+  - 需要PyTorch配合torchvision以支持RAFT光流模型（tv.models.optical_flow.raft_large）
+  - Stable Diffusion修复通过StableDiffusionInpaintPipeline加载
+  - 完整依赖列表见绑定的requirements.txt
+risk_flags:
+- large_model_download
+- non_commercial_only
+- external_data_dependency
+risk_notes:
+- Stable Diffusion权重文件较大；确保有足够的磁盘空间和下载时间
+- CC BY-NC许可限制RGVI组件的商业使用
+- FCNet和I3D来自ProPainter，采用NTU S-Lab许可1.0版本
+- Google Drive链接可能过期或需要认证
+recommended_when: |
+  在评估视频修复方法处理逼真目标移除和内容生成任务时使用此基准。尤其适用于结合光流传播与生成式补全的方法。适用于视频编辑中的时序一致性、基于光流引导的方法以及基于扩散的视频合成研究。HQVI基准为客观评估目标移除质量提供真值数据。
+not_recommended_when: |
+  如果目标应用严格限于图像级修复，请勿使用此基准，因为框架需要多帧视频处理和光流计算。若存储限制无法托管大型视频数据集（HQVI、DAVIS、DAVI、YTVI合计），请避免使用。不适用于实时应用；推理时间随视频长度和分辨率增长。由于核心组件和Stable Diffusion许可条款的CC BY-NC许可限制，请勿用于商业产品。
+paper:
+  title: Elevating Flow-Guided Video Inpainting with Reference Generation
+  venue: AAAI 2025
+  year: 2025
+  url: https://arxiv.org/abs/2412.08975
+  arxiv_id: '2412.08975'
+  authors:
+  - Suhwan Cho (Yonsei University)
+  - Seoung Wug Oh (Adobe Research)
+  - Sangyoun Lee (Yonsei University)
+  - Joon-Young Lee (Adobe Research)
+  license: CC BY-NC 4.0
+download:
+  url: https://github.com/ResearAI/DeepScientist/releases/download/aisb-v0.0.1/aisb.t3.044_rgvi.zip
+  archive_type: zip
+  local_dir_name: paper-44-RGVI
+  provider: github_release
+  repo: ResearAI/DeepScientist
+  tag: aisb-v0.0.1
+  asset_name: aisb.t3.044_rgvi.zip
+  sha256: 419a85def288a9e4928a0de7c5fd4593207ee4b467964394feb4422d5d3828d2
+  size_bytes: 40445
+display:
+  palette_seed: forest-indigo-frame
+  art_style: cinematic-repair
+  accent_priority: high
+  tags:
+  - video-inpainting
+  - flow-guidance
+  - diffusion-models
+  - optical-flow
+  - temporal-consistency
+image_path: ../image/044_aisb.t3.044_rgvi.jpg
+operational_notes: |
+  执行流程：
+  1. 将预训练权重放入weights/目录（FCNet.pth、i3d_rgb_imagenet.pth）
+  2. 在rgvi.py中配置Stable Diffusion修复路径（默认：/sd2_inpaint）
+  3. 推理：python run.py --root <数据集路径> --res <240p|480p|2K> --seq <序列名>
+  4. 评估：python post.py --root <数据集路径> --res <分辨率>
+
+  分辨率支持：240p（快速评估）、480p（平衡）、2K（高质量）
+  预计算基线可用于对比，无需完整重跑
+  LPIPS和I3D模型在启动时加载；首次推理可能较慢
+verification_checklist: |
+  执行前请验证：
+  - [ ] 测试数据集选择（HQVI、DAVIS、DAVI、YTVI）
+  - [ ] GPU可用性和CUDA配置
+  - [ ] 输入分辨率选择（240p/480p/2K）
+  - [ ] 生成模式的文本提示词（可选）
+  - [ ] 预训练模型路径（SDI、FCNet、I3D）
+  - [ ] post.py的数据集根目录指定
+  - [ ] 输出有足够的磁盘空间

package/AISB/catalog/aisb.t3.045_pslstm.yaml

@@ -0,0 +1,203 @@
+id: aisb.t3.045_pslstm
+name: P-sLSTM Long-Term Time Series Forecasting
+version: 0.1.0
+one_line: Optimize a patched sLSTM with channel independence for competitive long-horizon
+  time series forecasting on public benchmarks.
+task_description: 'P-sLSTM adapts the exponential-gating sLSTM architecture from NLP
+  to multivariate time series forecasting by incorporating two modifications: (1)
+  patching—segmenting the input into local temporal patches to overcome sLSTM''s short-memory
+  limitation—and (2) channel independence—processing each variate independently with
+  a shared backbone to prevent overfitting. This benchmark evaluates forecasting accuracy
+  (MSE, MAE) across standard public datasets including ETTh1/ETTm1, Weather, Electricity,
+  and others from the Time-Series-Library. The experimental workflow uses shell scripts
+  per dataset and a centralized run_longExp.py entry point.
+
+  '
+task_mode: experiment_driven
+requires_execution: true
+requires_paper: true
+integrity_level: cas_plus_canary
+snapshot_status: runnable
+support_level: advanced
+time_band: 6-24h
+cost_band: medium
+difficulty: medium
+data_access: public
+primary_outputs:
+- mse
+- mae
+- forecast_checkpoint
+- rse
+- corr
+launch_profiles:
+- id: quick_eval
+  label: Quick Eval
+  description: Run P-sLSTM forecasting on a single prepared public dataset (e.g.,
+    Weather) using the provided shell script in scripts/EXP-LongForecasting/P_sLSTM/.
+- id: full_benchmark
+  label: Full Benchmark
+  description: Run the full packaged long-horizon forecasting workflow across all
+    supported datasets, logging MSE/MAE for each.
+dataset_download:
+  primary_method: external
+  sources:
+  - label: Time-Series-Library
+    url: https://github.com/thuml/Time-Series-Library
+    license: null
+  - label: iTransformer
+    url: https://github.com/thuml/iTransformer
+    license: null
+  notes:
+  - Datasets (ETTh1.csv, ETTm1.csv, weather.csv, electricity.csv, etc.) must be placed
+    in the ./dataset/ directory.
+  - Expected structure: P-sLSTM/dataset/*.csv with matching root_path and data_path
+      arguments.
+credential_requirements:
+  mode: none
+  items: []
+  notes: []
+resources:
+  minimum:
+    cpu_cores: 8
+    ram_gb: 32
+    disk_gb: 80
+    gpu_count: 1
+    gpu_vram_gb: 12
+  recommended:
+    cpu_cores: 16
+    ram_gb: 64
+    disk_gb: 150
+    gpu_count: 1
+    gpu_vram_gb: 24
+environment:
+  python: '3.10'
+  cuda: '12.1'
+  pytorch: 2.1.0
+  flash_attn: null
+  key_packages:
+  - name: torch
+    version: '>=2.1.0'
+  - name: ninja
+    version: null
+  - name: matplotlib
+    version: null
+  notes:
+  - Validated alternative: Python 3.12 with PyTorch 2.3.0 on CUDA 12.1.
+  - Full dependency set is listed in requirements.txt.
+  - ninja package is required separately (pip install ninja).
+risk_flags:
+- data_alignment
+- memory_bounded
+risk_notes:
+- Ensure dataset alignment with forecasting horizon arguments (--label_len, --pred_len)
+  to avoid silent mismatches.
+- GPU memory scales with sequence length and number of channels; 24GB VRAM recommended
+  for full benchmark runs.
+recommended_when: 'Use this benchmark to evaluate efficient recurrent-sequence forecasting
+  that avoids transformer scaling costs while achieving competitive accuracy on long-horizon
+  multivariate TSF tasks.
+
+  '
+not_recommended_when: 'Do not use this if you need multimodal inputs (e.g., vision-language),
+  very large language model pretraining, or non-forecasting sequence tasks.
+
+  '
+paper:
+  title: Unlocking the Power of LSTM for Long Term Time Series Forecasting
+  venue: AAAI
+  year: 2025
+  url: https://ojs.aaai.org/index.php/AAAI/article/view/33303
+  authors:
+  - Kong, Yaxuan
+  - Wang, Zepu
+  - Nie, Yuqi
+  - Zhou, Tian
+  - Zohren, Stefan
+  - Liang, Yuxuan
+  - Sun, Peng
+  - Wen, Qingsong
+  bibtex: "@inproceedings{kong2025unlocking,\n  title={Unlocking the power of lstm\
+    \ for long term time series forecasting},\n  author={Kong, Yaxuan and Wang, Zepu\
+    \ and Nie, Yuqi and Zhou, Tian and Zohren, Stefan and Liang, Yuxuan and Sun, Peng\
+    \ and Wen, Qingsong},\n  booktitle={Proceedings of the AAAI Conference on Artificial\
+    \ Intelligence},\n  volume={39},\n  number={11},\n  pages={11968--11976},\n  year={2025}\n\
+    }\n"
+download:
+  url: https://github.com/ResearAI/DeepScientist/releases/download/aisb-v0.0.1/aisb.t3.045_pslstm.zip
+  archive_type: zip
+  local_dir_name: paper-45-PsLSTM
+  provider: github_release
+  repo: ResearAI/DeepScientist
+  tag: aisb-v0.0.1
+  asset_name: aisb.t3.045_pslstm.zip
+  sha256: 27a81f0bd5307f83bd05c52a8332d2d71c1ff6de8eb7c3e04826a0337c201fe5
+  size_bytes: 1001820
+display:
+  palette_seed: olive-sky-lstm
+  art_style: recurrent-signal
+  accent_priority: medium
+image_path: ../image/045_aisb.t3.045_pslstm.jpg
+capability_tags:
+- research_code_optimization
+- time_series_forecasting
+- recurrent_models
+- forecasting
+- scientific_ml
+track_fit:
+- paper_track
+- benchmark_track
+aisb_direction: T3
+executable_anchors:
+- path: run_longExp.py
+  role: main entry point
+  description: Parses CLI arguments for model, dataset, and training configuration;
+    orchestrates Exp_Main.
+- path: exp/exp_main.py
+  role: experiment driver
+  description: Exp_Main class builds models (P_sLSTM, LSTM, sLSTM, Informer, Autoformer,
+    DLinear, Transformer), loads data, trains, and evaluates.
+- path: utils/metrics.py
+  role: metric computation
+  description: Implements MAE, MSE, RMSE, MAPE, MSPE, RSE, CORR metrics; metric()
+    returns (mae, mse, rmse, mape, mspe, rse, corr).
+code_roots:
+- data_provider/
+- exp/
+- layers/
+- models/
+- scripts/
+- utils/
+metric_contract:
+  mse:
+    origin_path: utils/metrics.py
+    function: MSE
+    source_ref: code-backed
+    status: executable
+  mae:
+    origin_path: utils/metrics.py
+    function: MAE
+    source_ref: code-backed
+    status: executable
+  rse:
+    origin_path: utils/metrics.py
+    function: RSE
+    source_ref: code-backed
+    status: executable
+  corr:
+    origin_path: utils/metrics.py
+    function: CORR
+    source_ref: code-backed
+    status: executable
+recovery_notes: 'Static code audit found executable anchors for all staged metrics.
+  Runtime execution has not been performed; metric values are not yet trusted. Recover
+  existing code files over README-only claims when choosing origin_path, source_ref,
+  and evaluation_protocol.code_paths.
+
+  '
+caveat_snapshot: 'Packaged snapshot is runnable via provided shell scripts. Full benchmark
+  execution across all datasets is required before metric values can be trusted for
+  comparative reporting.
+
+  '
+commercial:
+  annual_fee: null