repository_final batch 1/1

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DAIRLab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,36 @@
+---
+license: mit
+datasets:
+- DAIRLab/phystwin_dataset
+---
+
+# PhysTwin fitted models: DAIRLab lab sessions
+
+Complete project-produced PhysTwin-style spring-mass fits of DAIRLab/phystwin_dataset lab sessions, one folder per recorded session and fit run, with every saved checkpoint.
+
+## License and attribution
+
+MIT (owner decision D9) applies to the project-produced fit packages in this repository: native checkpoints, run records and the generated metadata. It does not relicense the linked DAIRLab/phystwin_dataset recordings, which declare no license, or any third-party code or data.
+
+- The fits follow the PhysTwin method (Jianghanxiao/PhysTwin, MIT); keep its notice wherever its code is redistributed.
+
+## Runs
+
+| Location | Run | Stages | Status | Parent | BEST / FINAL | Budget (completed/configured) | Code revision |
+|---|---|---|---|---|---|---|---|
+| `session_20260921_225630_786148/sync0402-0893` | [lab-a-faithful-tracking](sessions/session_20260921_225630_786148/runs/lab-a-faithful-tracking/README.md) | cma, adam | complete | — | adam/c0489 / adam/c0500 | cma:  (completed_generations 250, issued_asks 2750, told_asks 2750, center_evaluations 1, physical_failures 0); adam: traversals 500/500, updates 245500/245500 | `2b53aa2040ed` |
+
+## What a run package contains
+
+- `native/`: every saved checkpoint and state file of the run, byte for byte, with its run records and logs (CMA generations, candidates and strategy state; Adam snapshots, continuation state and per-update losses; or Deform360 boundary, optimizer, RNG and role records).
+- `evidence/`: launch, parent-selection and qualification records that the run's records cite.
+- `run.json`: stages, actual objectives, optimized and fixed parameters, configured versus completed budgets, labels with their scoring conditions, code revisions and dirty-state reports, capabilities and unknowns — each value names the native record it came from.
+- `checkpoints.tsv`: one row per checkpoint file (stage, step, parent, labels, status, size, sha256).
+- `dependencies.json`: model parents in this repository, dataset inputs to be pinned at a verified dataset revision, upstream archive members, and environment paths that are not package content.
+
+## Not claimed
+
+- No model here was loaded, rendered, resumed or re-evaluated for this card; clean-destination use is a separate validated step (plan PR4).
+- BEST and FINAL are the labels the fits recorded under their stated scoring conditions; packaging selects no preferred model.
+- Interrupted-run recovery is qualified by each run's recorded execution identity and inputs; extending a completed run's horizon and full reproduction are not supported or claimed.
+- Historical clamp-at-use stiffness runs are not reinterpreted as projected-update runs.