Skip to content

condemned.md

Latest commit

 

History

History
121 lines (105 loc) · 8.33 KB

condemned.md

File metadata and controls

121 lines (105 loc) · 8.33 KB
Raw

Condemned material

The catalog of condemned self-material — stale branches, git stash entries, dead code and retired tests that a hygiene / repo_cleanup sweep is 95%-but-not-100% sure is trash. Symmetric to parked.md: parked.md holds work that is paused and will resume; this file holds material that is spent and awaiting elimination, recoverable right up until it is voided.

This is the index; the payload is durable git refs, not markdown. Fragile forms (local unmerged branches, stashes) are first materialised as real commits and pushed under the archive namespace refs/heads/archive/condemned/<name> (a branch prefix — GitHub only accepts pushes to refs/heads/* and refs/tags/*, so a custom refs/archive/* namespace is unpushable; filter with git branch --list 'archive/condemned/*') into PyAutoGut as the attic remote — before the local copy is deleted. Recovery is a checkout. The organ (PyAutoGut) holds and voids; the Brain hygiene conductor drives (decides what to condemn, triggers a sweep), mirroring the Heart ↔ vitals template. See the decision: research/pyautobrain/pyautogut_organ_decision.md.

Lifecycle

  1. Condemn — the hygiene tidy pass files an entry here (async, no synchronous per-item gate). Fragile forms are archived to a durable ref first; merged branches and committed deletions need only a SHA recorded.
  2. Transit — the entry sits with a sweep-after date. Until then it is recoverable (reabsorption): restore the branch/stash from its archive ref.
  3. Void — a batch sweep runs the existing repo_cleanup safety gates against entries past sweep-after and eliminates them; the entry moves out of this file (to a voided log or is deleted).

Entry schema

One ## block per item. Fields:

  • type — branch | stash | file | test
  • locator — the local name/path (e.g. feature/old-thing, stash@{2}, src/legacy/foo.py)
  • confidence — how sure it is trash (e.g. 0.95)
  • reason — why it is condemned
  • merged — yes | no (a merged branch is reachable from main forever → skips the pen; near-zero risk)
  • condemned — date filed (YYYY-MM-DD)
  • sweep-after — earliest date it may be voided (the transit clock)
  • breaks-if-wrong — what is lost if this was a false positive (informs the gate)
  • archive-ref — the durable ref + SHA to recover from (refs/heads/archive/condemned/<name> @ <sha>), or n/a for a merged branch / committed deletion whose bytes live in remote history (record the pre-delete SHA instead)

Recoverability is not uniform

  • Merged branches — reachable from main forever; archive-ref: n/a, a note is enough. The conductor recommends these straight to deletion without staging.
  • Committed code / test deletions — the old bytes live in remote history; record only the pre-delete SHA.
  • Local-only unmerged branches / stashes — exist in one machine's reflog and are gc-pruned. These must be materialised as an archive ref before deletion; a manifest that merely points at a stash is worthless the moment it is dropped.

release-datasets/autolens-regenerable

  • type: file
  • locator: autolens_workspace dataset/ (28 non-allowlisted simulated dirs, PR#272) — cat A+multi: group/{dark_matter_subhalo,operated,simple,simple__no_lens_light,sky_background}, imaging/{dark_matter_subhalo,extra_galaxies,lens_light_asymmetric,light_operated,simple,simple__no_lens_light,sky_background}, interferometer/{extra_galaxies,simple}, point_source/{deblending,simple}, weak/simple, multi/{imaging,interferometer}; + producer-output/guarded: cluster/csv_api_example, imaging/{dark_matter_subhalo_no_lens_light,misc,simulated_lens}, interferometer/{datacube,simulated_lens}, point_source/{simulated_lens,start_here_example}; + simpleold (dead, user-confirmed kill)
  • confidence: 0.98 (0.90 for interferometer/simpleold — dead)
  • reason: force-committed by pre_build's old git add -f (fixed PyAutoBuild#150); each is regenerated on demand by a guarded example script (should_simulate()/not dataset_path.exists() → simulator subprocess) or is scratch script-output with no consumer. simpleold is a stale old dataset with zero references. Removing from tracking so the tree matches .gitignore. #126 leg 3.
  • merged: no
  • condemned: 2026-07-13
  • sweep-after: 2026-08-13
  • breaks-if-wrong: a consumer that does not self-provision would hit missing data at runtime; smoke (9/9) confirms the example entries regenerate post-purge; datacube/ellipse have guarded consumers; producer-output dirs have no consumer
  • archive-ref: n/a — committed deletion; bytes recoverable from remote history at pre-purge SHA 8625a1de (autolens_workspace) via git checkout 8625a1de -- dataset/<dir>

release-datasets/autogalaxy-regenerable

  • type: file
  • locator: autogalaxy_workspace dataset/ (17 non-allowlisted simulated dirs, PR#129) — cat A+multi: imaging/{asymmetric,clumpy,extra_galaxies,operated,sersic_x2,simple,simple__sersic,sky_background}, interferometer/{clumpy,extra_galaxies,simple}, multi/{imaging,interferometer}; + producer-output/guarded: imaging/{ellipse,misc,simulated_galaxy}, interferometer/simulated_galaxy
  • confidence: 0.98
  • reason: as above (#126 leg 3); regenerated on demand by guarded example scripts or scratch script-output.
  • merged: no
  • condemned: 2026-07-13
  • sweep-after: 2026-08-13
  • breaks-if-wrong: as above; smoke (8/8) confirms regeneration post-purge
  • archive-ref: n/a — committed deletion; bytes recoverable from remote history at pre-purge SHA e940f8cd (autogalaxy_workspace)

release-datasets-group-b/all-four

  • type: file
  • locator: bare-dataset/ Group B repos (PyAutoBuild#151) — autofit_workspace (408 files, dataset/example_1d/), HowToFit (408, example_1d/), HowToGalaxy (21, imaging/), HowToLens (27, imaging/). Full dataset/ purge — nothing real was committed.
  • confidence: 0.98
  • reason: force-committed by pre_build's old git add -f (fixed PyAutoBuild#150). All four repos self-provision every dataset via if not dataset_path.exists(): subprocess.run([sys.executable, ".../simulator(s).py"]) (autofit/HowToFit path.exists()+from_json; HowToGalaxy/HowToLens dataset_path.exists()+from_fits). Bare dataset/ intent = nothing committed. #151.
  • merged: no
  • condemned: 2026-07-13
  • sweep-after: 2026-08-13
  • breaks-if-wrong: a non-self-provisioning script would hit missing data; smoke confirms regeneration (autofit 10/10, HowToFit 10/10, HowToGalaxy 4/4, HowToLens 6/6)
  • archive-ref: n/a — committed deletion; bytes recoverable from remote history at pre-purge SHAs autofit_workspace 1254a2fe, HowToFit ccc19584, HowToGalaxy caf1657c, HowToLens 554be8b4

pj011646-wfc3-parity/superseded-branch

  • type: branch
  • locator: feature/pj011646-wfc3-parity (PyAutoReduce, tip bd9806b) — scripts/reduce_pj011646.py (wfc3_ir production reduction) + prototypes/pj011646_parity_fit.py (model-parity fit); PyAutoReduce#25.
  • confidence: 0.9
  • reason: superseded — the human is redoing the PJ011646 WFC3-IR reduction fresh via a new autolens-assistant approach (not the PyAutoReduce prototype path). Branch never pushed / no PR; pixel-parity verdict already captured on #25 (closed superseded). Kept recoverable in case the fresh redo wants the reduction/fit scripts as reference.
  • merged: no
  • condemned: 2026-07-13
  • sweep-after: 2026-10-11
  • breaks-if-wrong: loses the working wfc3_ir reduction script (program 14653, F160W, final_bits=512 workaround) + the model-parity fit harness; recoverable via pyauto-gut recover pj011646-wfc3-parity until voided.
  • archive-ref: refs/heads/archive/condemned/pj011646-wfc3-parity on PyAutoReduce origin (bd9806b)