Changelog

Folder Hierarchy Changelog

This page records changes to the APPN folder hierarchy only — that is, the structure described in Folder-Structure and the diagram on the Home page. Code-only changes, refactors, documentation tweaks, and CLI flag additions that do not alter what gets created on disk are intentionally excluded.

Each entry should describe:

• What changed in the on-disk folder layout
• Which sensors / levels are affected
• Why the change was made (one line is fine)
• A link to the relevant commit / PR if available

Entries are listed newest-first.

---

2026-04-22 — Add RunOverview.csv at the date level

• A new RunOverview.csv file is now created inside each YYYYMMDD/ date folder, alongside FieldNotes.txt and the run_XX/ subfolders.
• One row per run, seeded with a Run index column and a RunFailed boolean column. Operators can add further columns (e.g. APEx experimental info) and they are preserved on subsequent script runs.
• Creation is controlled per field-day by the MakeTableFile column in FieldLog.csv (defaults to True when blank/NaN; set False to skip).

Affected path:

.../<sensor>/YYYYMMDD/RunOverview.csv

---

2026-04-22 — Add T0_raw/Vault/ for GOBI and CALVIS

• A new Vault/ folder is now created inside T0_raw/ whenever the sensor is GOBI or CALVIS.
• Files placed inside Vault/ are reserved as protected: they will be excluded from any future programmatic file cleanup or deletion routines.
• Mirrors the existing T1_proc/QC_data/ carve-out for the same sensor set.
• .graw folders should now be placed in T0_raw not T1_proc

Affected path:

.../<sensor>/YYYYMMDD/run_XX/T0_raw/Vault/   # GOBI, CALVIS only

---

Template for new entries

## YYYY-MM-DD — Short title

- What changed on disk.
- Sensors / levels affected.
- Rationale (1 line).

**Affected path:**

` ` `
.../path/that/changed/
` ` `