# Third-Party Notices, Upstream Pins & Data Governance

This repository integrates three **strictly separated** battery verification modules.
No third-party datasets, assets, or verdict authorities are merged or combined.

---

## Module 1 — Battery Health (Sandia Real Laboratory Cell Data)

- **Upstream Software Subset (`upstream/bess-evidence-lab-mvp`):**
  - Repository: `VolMax-Studio/bess-evidence-lab-mvp`
  - Pinned Commit: `2dd708e871b872cb3dc2bd3dab8a20a2d923b9f7` (`2dd708e`)
  - Pinned Entrypoint: `verifier/verify.py` (SHA-256 `ea1f682429b8f1126509edc936d7bdd3948034ed59e922a67eb0ebbe2873139d`)
  - Note: Only the deterministic L1 verifier, claim definition, and source metadata are vendored (`upstream/bess-evidence-lab-mvp`). The raw source CSV is excluded.
- **External Dataset Provenance:**
  - Subject: `SNL_18650_NMC_25C_0-100_0.5-2C_a` (LG Chem 18650HG2 3.0 Ah NMC single cell, 660 cycles)
  - Source: Sandia National Laboratories (U.S. DOE) / [BatteryArchive.org](https://www.batteryarchive.org/)
  - Publication: Yuliya Preger et al., *"Degradation of Commercial Lithium-Ion Cells as a Function of Chemistry and Cycling Conditions"*, *Journal of The Electrochemical Society*, 167 (2020) 120532
  - DOI: [`10.1149/1945-7111/abae37`](https://doi.org/10.1149/1945-7111/abae37) · OSTI ID: `1650174`
  - License / Redistribution Status: Associated JES publication is `CC BY-NC-ND 4.0`; BatteryArchive provides public research downloads. Because `cell.csv` lacks an explicit unrestricted commercial redistribution grant, **the raw CSV is not redistributed in this repository**. Pre-computed verified dossiers/manifests/charts are published statically; local scientific reproduction verifies a user-supplied CSV against SHA-256 `e34c2a5ee32c9922e2def6f387d9ba553c27d07ae5a99452f3b15640b339bfc6`.
- **Classification & Limitations:** Single laboratory 18650 cell only. Not commercial pack/plant BESS SoH, DCIR, RUL, or system AC RTE. Not an EU Digital Battery Passport.

---

## Module 2 — BESS Field Performance (PNNL / EPRI ENW Real Operational Data)

- **Upstream Software (`upstream/bess-field-evidence`):**
  - Repository: `VolMax-Studio/bess-field-evidence` (Public, MIT License)
  - Pinned Commit: `833c467c492fb424f54340ca4616dc7e2c6d42e7` (`833c467`)
  - Pinned Entrypoint: `enw-pnnl-epri/reproduce.py` (SHA-256 `63b1acf311ccf46534268e2d2abbff0ae43090f07d7179c7e630da69989f3c23`)
- **External Dataset Provenance:**
  - Subject: `ENW` anonymized stationary grid-scale BESS operational 1-minute telemetry (`85,858` intervals per meter, `59.62` days)
  - Source: PNNL / EPRI — *"Grid-Scale BESS Operational Datasets for Battery Modeling Research"*, Zenodo Record `22947521`
  - Creators: Alasdair Crawford, Joe Thompson (2026-09-25)
  - DOI: [`10.5281/zenodo.22947521`](https://doi.org/10.5281/zenodo.22947521)
  - License: **Creative Commons Attribution 4.0 International (`CC-BY-4.0`)**
  - Redistribution Practice: Following `VolMax-Studio/bess-field-evidence`, `ENW.feather` (`6.9 MB`) is not committed to git; local reproduction downloads it directly from Zenodo on demand and verifies MD5 `d2d58c153d6674ce8ef8242e497dd9b1` and SHA-256 `99dea934c5bfbf1fd6c88365275b41194351eae5a9ccb899b863bb2f75cad943`.
- **Classification & Limitations:** Real anonymized field telemetry (C-rate normalized; unclosed SoC `15.8% -> 92.0%`; rated kWh/kW, chemistry, OEM serial, and UTC timestamps withheld). Emitted ratios (`74.486%` to `88.865%`) are **descriptive exported/imported energy ratios only** — NOT verified contractual round-trip efficiency (RTE), NOT Site Acceptance Test (SAT) pass/fail verdicts, and NOT an EU Digital Battery Passport.

---

## Module 3 — Second-Life Screening (Illustrative P10 S1 Evidence Explorer)

- **Upstream Component (`second-life-explorer/`):**
  - Repository: `VolMax-Studio/p10-second-life-battery-screening-s1` (`explorer/` subtree from `4cdc223`, MIT-licensed VolMax Studio Lab interface)
  - Ratified Reference Tag: `v0.1.0-s1-ratified` (`tag_object`: `9d674e697251bc6ca310574d3944a619c75fda98`)
  - Ratified Implementation Commit: `9589dd28ae02009d3a82c140c77208a554f2f199`
  - Frozen Preregistration Commit: `fea64dbec1ab89666d4d7d12f8c04d13560fd8a8`
  - Frozen Profile: `SL-SCREEN-ILLUSTRATIVE-v1` (SHA-256 `792c2b71f19b34eff2e6653ffcfc844e65c8d36268de0aea8920fb9c1107119d`)
  - Corpus Manifest SHA-256: `9a9047ad30dd1d39d14f9457cf4e61d3f884011dea003ca0f62fed450aad6f83`
  - Signer Key Fingerprint: `SHA256:5aVclA4mSj525gNohpxgBArgTo8qWvUbftMsGUs2TLw` (SSH Ed25519 signature verified at build time by `scripts/verify-evidence.mjs`)
- **Classification & Limitations:**
  - Vectors `e101.json`–`e104.json` (`MOD-101`–`MOD-104`) are **synthetic illustrative demonstration evidence**, NOT manufacturer field telemetry.
  - **NOT a UL 1974 requirement, interpretation, certification, or normative screening procedure.**
  - Strict authority split preserved: **RATIFIED REPLAY** renders only committed Lean `lake exe adjudicate` outputs (`generated/*.json`); **EXPLORATORY CRUCIBLE** is a browser-only interactive model and never emits `P10_ADJUDICATION_STATEMENT`.
  - Only the self-contained `explorer/` frontend and its ratified `generated/` evidence bundle are included here (the Lean source/build artifacts `.lake/` and full private research tree are not copied).

---

## Runtime & Build Dependencies

- **Python scientific toolchain (`requirements.txt`):** `pandas` (BSD-3-Clause), `numpy` (BSD-3-Clause), `pyarrow` (Apache-2.0), `matplotlib` (PSF-based), `pytest` (MIT).
- **Web explorer toolchain (`second-life-explorer/package.json`):** `react` & `react-dom` 18.3.1 (MIT), `vite` 5.4.11 (MIT), `typescript` 5.6.3 (Apache-2.0).

---

## Regulatory Non-Compliance / Non-Certification Notice

Nothing in this repository or its hosted static demonstration constitutes:
- An EU Digital Battery Passport or statutory economic-operator conformity filing under Regulation (EU) 2023/1542;
- UL 1974 second-life battery certification;
- Site Acceptance Test (SAT) or Factory Acceptance Test (FAT) sign-off; or
- A verified contractual round-trip efficiency (RTE) guarantee.
