1. 02 Jun, 2026 40 commits
    • … must reflect fresh observable evidence before restart and avoid staging data artifacts\nRejected: Wait for full reference completion | User asked for immediate delivery package and current checkpoint is already a meaningful stage transition\nConfidence: high\nScope-risk: narrow\nDirective: Treat session 19709 and /tmp/fma_realpath_small_rerun_index2 as the primary continuation path until final reference artifacts or a new traceback appear\nTested: Verified chromaprint 200/200 complete, reference_progress.json 25/200 checkpoint, partial reference numpy artifacts, and updated handoff/changelog files\nNot-tested: Full reference completion and downstream evaluate stage on the active rerun
      cnb.bofCdSsphPA authored
    • Constraint: Real-path investigation exposed decode failures from mpg123/librosa on some MP3s during long index runs
      Rejected: Abort the entire job on first decode error | it turns one bad asset into total index failure
      Confidence: high
      Scope-risk: narrow
      Directive: Keep per-file skip logging and skipped_refs accounting while continuing the real-path root-cause run
      Tested: Verified /tmp/chroma_skip_repro with 1 good MP3 + 1 bad MP3 completes RC=0, logs skip decode failure, writes reference outputs, and records skipped_refs=1
      Not-tested: Full real-path FMA rerun after tolerance change is still pending
      cnb.bofCdSsphPA authored
    • Constraint: The live build-index investigation was blocked by stdout/stderr buffering that left log files at 0 bytes during long runs
      Rejected: Keep diagnosing from progress files alone | they do not preserve traceback or stage-transition context
      Confidence: high
      Scope-risk: narrow
      Directive: Preserve flush-on-progress behavior while chasing the remaining real-path build-index root cause
      Tested: Verified tiny repro /tmp/chroma_repro_tiny12 writes live logs and traceback with RC=1 after flush=True change
      Not-tested: No final fix for the real-path build-index exit yet
      cnb.bofCdSsphPA authored
    • Constraint: Both observable and legacy build-index jobs exited without producing reference_* or evaluate artifacts
      Rejected: Keep treating the run as slow linear progress | no longer matches the fresh ps/pgrep evidence
      Confidence: high
      Scope-risk: narrow
      Directive: Start the next cycle with build-index exit-path diagnosis before launching more long runs
      Tested: Verified ps/pgrep show no active build/evaluate process; verified observable directory still only has chromaprint progress/cache files; reviewed updated handoff docs
      Not-tested: No root-cause reproduction or fix yet
      cnb.bofCdSsphPA authored
    • Constraint: Long-running CPU-only chromaprint indexing has not reached evaluate yet
      Rejected: Keep appending linear refs_done updates | produces noise without a stage transition
      Confidence: high
      Scope-risk: narrow
      Directive: Do not create the next handoff commit until chromaprint completes, reference_* appears, evaluate starts, or the process fails
      Tested: Verified /tmp/chroma_index_observable_smoke progress snapshot; reviewed updated handoff/changelog files
      Not-tested: No new model/evaluation result because build-index has not reached the next stage
      cnb.bofCdSsphPA authored
    • Constraint: the live 8000-reference FMA run is already in flight, so observability had to be added as forward-safe progress and partial-cache outputs for future runs instead of altering the active process
      Rejected: keep waiting on blind build-index runs | hides whether chromaprint is advancing and blocks operational debugging
      Confidence: high
      Scope-risk: narrow
      Directive: Prefer progress JSON plus partial cache evidence for future large-index investigations before assuming a stall
      Tested: py_compile on chromaprint_matcher.py and run_demo.py, verified chromaprint_progress.json and chromaprint.pkl appear in /tmp/chroma_index_observable_smoke at refs_done=50
      Not-tested: end-to-end completion of the new observable build-index flow has not finished yet
      cnb.bofCdSsphPA authored
    • Constraint: the live FMA smoke is still running, so the optimization had to preserve existing hash semantics rather than adopt the faster non-equivalent peak picker
      Rejected: maximum_filter-based peak picking | changed peak/hash outputs despite much larger speedup
      Confidence: high
      Scope-risk: narrow
      Directive: Keep future chromaprint optimizations hash-equivalent unless evaluation baselines are intentionally regenerated
      Tested: compared old vs new peaks and hashes on fma_00000.mp3, measured 2.02x speedup, py_compile passed, rechecked live FMA smoke still in build-index
      Not-tested: full build-index completion on the live 8000-reference FMA run has not finished yet
      cnb.bofCdSsphPA authored
    • Constraint: CPU-only real FMA smoke is still running, so delivery must emphasize resumable evidence instead of final metrics
      Rejected: wait for evaluate completion | would block handoff and delay resumable delivery with no new guaranteed result
      Confidence: high
      Scope-risk: narrow
      Directive: Keep future commits limited to explicit doc files unless index/evaluate artifacts are intentionally being reported
      Tested: verified running PIDs, checked best_model.pt and song_to_idx.json existence, revalidated manifests with validate-splits
      Not-tested: final index artifact emission and evaluate metrics are not available yet
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 13:34 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Leave the 13:34 observation only in chat | would break restart continuity and phase-by-phase commit discipline
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 13:28 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Leave the 13:28 observation only in chat | would break restart continuity and phase-by-phase commit discipline
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 13:22 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Leave the 13:22 observation only in chat | would break restart continuity and phase-by-phase commit discipline
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 13:16 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Leave the 13:16 observation only in chat | would break restart continuity and phase-by-phase commit discipline
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 13:10 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Leave the latest observation only in chat | would break restart continuity and phase-by-phase commit discipline
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 13:04 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Reuse the 12:59 UTC checkpoint | would leave the handoff behind the latest verified downstream state
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 12:59 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Reuse the 12:55 UTC checkpoint | would leave the handoff behind the latest verified downstream state
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index at 12:55 UTC with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Reuse the 12:51 UTC checkpoint | would leave the handoff behind the latest verified downstream state
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the newest verified downstream state so restart docs show that the real FMA smoke still remains in build-index with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Reuse the 12:43 UTC checkpoint | would leave the handoff behind the latest verified downstream state
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Persist the latest downstream checkpoint so restart docs show that the real FMA smoke still remains in build-index, with no evaluate stage or emitted index artifacts yet.
      
      Constraint: Downstream completion evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Reuse the 12:39 UTC checkpoint | would leave the handoff behind the latest verified downstream state
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate before changing the downstream status summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Capture the next downstream checkpoint so restart docs reflect that the real FMA smoke remains in build-index, with no evaluate stage yet and no emitted index artifacts so far.
      
      Constraint: Final downstream evidence is still unavailable because build-index has not produced artifacts or switched to evaluate
      Rejected: Wait silently for evaluate to start | would leave the handoff missing the latest verified downstream state
      Confidence: high
      Scope-risk: narrow
      Directive: Next verify the first index artifact file or the transition into evaluate before changing the delivery summary again
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Update the handoff package with the next downstream checkpoint so a restarted session knows training is done, build-index is active, and evaluate has not started yet.
      
      Constraint: Final evaluation evidence is still unavailable because build-index has not completed
      Rejected: Wait silently for evaluate to start | would lose a useful downstream checkpoint for restart continuity
      Confidence: high
      Scope-risk: narrow
      Directive: Next capture either the first index artifact file or the transition into evaluate
      Tested: process scan showing build-index and no evaluate; presence of /tmp/fma_real_smoke_stopcheck/fma_index_smoke directory; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index output, evaluate, final metrics/report generation
      cnb.bofCdSsphPA authored
    • Record the first decisive runtime milestone so restart docs show that the real FMA smoke has finished training, produced a model, and moved into build-index.
      
      Constraint: Final evaluation metrics are not available yet because the smoke is still running downstream of training
      Rejected: Keep describing the run as training-only | would now be materially inaccurate
      Confidence: high
      Scope-risk: narrow
      Directive: Next verify the transition from build-index into evaluate and then capture the final report artifacts
      Tested: process scan showing build-index; absence of train.py PID 311629; presence of best_model.pt and song_to_idx.json; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Completed build-index, evaluate, and final metrics/report generation
      cnb.bofCdSsphPA authored
    • Persist a wider observation checkpoint so restart docs show continued forward motion across a 180-second window while the real FMA smoke remains inside Epoch 1.
      
      Constraint: Verification is still limited to runtime evidence and manifest revalidation because Epoch 1 has not completed
      Rejected: Stop at the 120-second checkpoint | would miss stronger evidence from the longer observation window
      Confidence: high
      Scope-risk: narrow
      Directive: Keep monitoring until the first saved model file or transition into build-index/evaluate appears
      Tested: ps on PID 311629 after 180s wait; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Persist a wider observation checkpoint so restart docs demonstrate continued forward motion across a longer interval while the real FMA smoke remains inside Epoch 1.
      
      Constraint: Verification is still limited to runtime evidence and manifest revalidation because Epoch 1 has not completed
      Rejected: Stop at the 30-second checkpoint | would miss stronger evidence from a longer observation window
      Confidence: high
      Scope-risk: narrow
      Directive: Keep monitoring until the first saved model file or transition into build-index/evaluate appears
      Tested: ps on PID 311629 after 120s wait; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Capture a more meaningful follow-up checkpoint after an added wait window so the restart docs show continued forward motion rather than trivial second-to-second sampling.
      
      Constraint: Epoch 1 still has not completed, so verification is limited to runtime evidence and manifest revalidation
      Rejected: Skip the wider-window checkpoint | would miss the chance to prove progress across a longer observation gap
      Confidence: high
      Scope-risk: narrow
      Directive: Keep watching for the first saved model file or transition into build-index/evaluate before changing the project status summary
      Tested: ps on PID 311629 after 30s wait; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Persist a newer runtime checkpoint so restart docs continue to prove that the real FMA smoke is still progressing inside Epoch 1 without yet saving a model or entering downstream stages.
      
      Constraint: Verification is still limited to live runtime evidence because Epoch 1 has not completed
      Rejected: Reuse the prior 22:10 checkpoint | would leave handoff docs behind the latest verified state
      Confidence: high
      Scope-risk: narrow
      Directive: Keep monitoring until the first saved model file or stage transition appears
      Tested: ps on PID 311629; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Record a later live checkpoint so restart docs keep proving that the real FMA smoke is still advancing inside Epoch 1 without yet producing a saved model or entering downstream stages.
      
      Constraint: Verification is still limited to live runtime evidence because Epoch 1 has not completed
      Rejected: Reuse the prior 20:08 checkpoint | would leave handoff docs behind the latest verified state
      Confidence: high
      Scope-risk: narrow
      Directive: Keep monitoring until the first saved model file or stage transition appears
      Tested: ps on PID 311629; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Capture a newer live checkpoint so restart docs continue to prove the real FMA smoke is progressing inside Epoch 1 without yet reaching model save or downstream evaluation stages.
      
      Constraint: Verification remains limited to live runtime state because the first epoch has not completed
      Rejected: Stop at the prior 19:12 checkpoint | would leave the handoff behind the latest verified state
      Confidence: high
      Scope-risk: narrow
      Directive: Keep monitoring until the first saved model file or stage transition appears
      Tested: ps on PID 311629; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Preserve a newer restart checkpoint so the next session inherits up-to-date proof that the real FMA smoke continues progressing inside Epoch 1 without yet saving a model or entering downstream stages.
      
      Constraint: Verification is still limited to live runtime evidence because Epoch 1 has not completed
      Rejected: Keep the prior 18:22 checkpoint only | would leave the handoff one monitoring cycle behind reality
      Confidence: high
      Scope-risk: narrow
      Directive: Continue monitoring until the first saved model file or stage transition appears before changing status conclusions
      Tested: ps on PID 311629; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Keep the restart artifacts synchronized with the newest observed elapsed time so the next session can see that the real FMA smoke is still advancing without yet reaching model save or evaluation stages.
      
      Constraint: Training remains inside Epoch 1, so verification is limited to live runtime evidence
      Rejected: Stop at the prior 17:07 checkpoint | would leave handoff docs behind the latest verified state
      Confidence: high
      Scope-risk: narrow
      Directive: Continue monitoring until the first saved model file or stage transition appears
      Tested: ps on PID 311629; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch artifacts, build-index, evaluate, final metrics
      cnb.bofCdSsphPA authored
    • Keep the restart package aligned with the newest observed runtime so the next session inherits proof that the real FMA smoke continues moving forward inside Epoch 1.
      
      Constraint: The only new evidence available was live process progress because training has not finished the epoch
      Rejected: Reuse the 15:12 checkpoint | would leave handoff evidence stale by another monitoring cycle
      Confidence: high
      Scope-risk: narrow
      Directive: Keep watching for first model output or stage transition before changing any roadmap conclusions
      Tested: ps on PID 311629; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: Final checkpoint write, build-index, evaluate, and report generation
      cnb.bofCdSsphPA authored
    • Advance the handoff timestamp so a restarted session inherits the latest proof that the real FMA smoke is still progressing inside Epoch 1 rather than stalling before model output.
      
      Constraint: Only live process evidence was available because the first epoch still has not finished
      Rejected: Skip another checkpoint update | would leave restart docs one verification step behind reality
      Confidence: high
      Scope-risk: narrow
      Directive: Wait for the first saved model file or stage transition before making any accuracy claims
      Tested: ps on PID 311629; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: End-of-epoch checkpoint creation and downstream evaluate output
      cnb.bofCdSsphPA authored
    • Update the handoff package with newer runtime evidence so the next session can distinguish a still-progressing epoch from a hung pipeline while waiting for the first saved model file.
      
      Constraint: Verification had to rely on live process state because Epoch 1 has not completed yet
      Rejected: Leave the prior checkpoint as-is | would force the next session to re-check whether progress continued
      Confidence: high
      Scope-risk: narrow
      Directive: Continue checking for the first transition into saved model output, build-index, or evaluate before drawing quality conclusions
      Tested: ps on PID 311629; process scan for smoke-local/build-index/evaluate; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests; find on /tmp/fma_real_smoke_stopcheck/fma_models_smoke
      Not-tested: Final FMA smoke report and accuracy metrics
      cnb.bofCdSsphPA authored
    • Capture the current real-FMA CPU smoke checkpoint, restart path, and delivery handoff so the next session can resume without re-diagnosing an expected long-running training stage.
      
      Constraint: Real FMA smoke is still running on CPU with no GPU available
      Rejected: Wait for final smoke completion before documenting | would delay a usable handoff artifact
      Confidence: high
      Scope-risk: narrow
      Directive: Keep staging explicit; do not include datasets, smoke outputs, checkpoints, or caches
      Tested: git diff review; live process check; validate-splits on /tmp/fma_real_smoke_stopcheck/fma/manifests
      Not-tested: Final FMA smoke metrics after Epoch 1 completion
      cnb.bofCdSsphPA authored
    • Constraint: This checkpoint records running-smoke evidence only and must not stage data, model artifacts, or tmp outputs
      Rejected: Wait for the full real FMA smoke to finish before updating handoff docs | The running-state evidence is already valuable for the next session and should not be lost
      Confidence: high
      Scope-risk: narrow
      Directive: Keep future restart notes aligned with the live smoke status and continue using explicit file staging
      Tested: Re-verified real FMA smoke is running on CPU, manifests validate, and the documented no-GPU condition explains the long training phase
      Not-tested: Did not wait for Epoch 1 completion, model checkpoint emission, or downstream build-index/evaluate completion
      cnb.bofCdSsphPA authored
    • Constraint: Limit this checkpoint to ignore rules and handoff notes; do not change tracked artifact history
      Rejected: Expand ignore coverage to all noisy data trees immediately | This pass only suppresses well-understood untracked cache noise
      Confidence: high
      Scope-risk: narrow
      Directive: Keep ignore changes incremental and distinguish between untracked cache noise and already-tracked historical artifacts
      Tested: Confirmed untracked __pycache__ and .pyc noise disappeared from git status after the ignore update
      Not-tested: Did not rewrite tracking state for already-versioned cache or data artifacts
      cnb.bofCdSsphPA authored
    • Constraint: Limit this checkpoint to ignore rules and handoff notes; do not alter dataset contents
      Rejected: Ignore broad data or cache trees immediately | This pass only suppresses confirmed local-generated noise with low risk
      Confidence: high
      Scope-risk: narrow
      Directive: Keep adding ignore rules incrementally and only for artifacts proven to be local/generated noise
      Tested: Confirmed the targeted .omx wait files and real-smoke CSV no longer appear in git status after the ignore update
      Not-tested: Did not broaden ignore coverage to larger data/cache trees in this checkpoint
      cnb.bofCdSsphPA authored
    • Constraint: Limit this checkpoint to handoff and changelog documentation consistency
      Rejected: Leave small formatting mismatches across entrypoints | Restart guidance should be byte-level easy to copy and compare
      Confidence: high
      Scope-risk: narrow
      Directive: Keep the first verification command identical across AGENT, README, session handoff, and delivery handoff
      Tested: Verified all four primary entrypoints contain the same runnable command block
      Not-tested: No code or training path executed in this consistency-only checkpoint
      cnb.bofCdSsphPA authored
    • Constraint: Restrict this checkpoint to handoff documentation consistency only
      Rejected: Leave delivery handoff behind the newer restart guidance | All primary restart entrypoints should expose the same first verification command
      Confidence: high
      Scope-risk: narrow
      Directive: Keep the first runnable command identical across AGENT, README, session handoff, and delivery handoff
      Tested: Rechecked relative links in the updated delivery handoff and changelog docs
      Not-tested: No code or training path executed in this handoff-consistency checkpoint
      cnb.bofCdSsphPA authored
    • Constraint: Limit this checkpoint to memory and handoff documentation only
      Rejected: Keep the restart command only in README | New sessions should see the first verification command directly in AGENT memory too
      Confidence: high
      Scope-risk: narrow
      Directive: Keep AGENT memory focused on restart-critical commands and avoid duplicating full workflow specs there
      Tested: Rechecked 174 relative links across AGENT, changelog, and handoff docs
      Not-tested: No code or training path executed in this memory-only checkpoint
      cnb.bofCdSsphPA authored
    • Constraint: Restrict this checkpoint to navigation and handoff documentation backed by fresh local verification
      Rejected: Keep restart guidance read-only without a first command to run | New sessions benefit from an immediate executable sanity check
      Confidence: high
      Scope-risk: narrow
      Directive: Keep README focused on compressed restart guidance and use the offline smoke only as an environment and chain sanity check
      Tested: Re-ran business_export_offline_smoke.py successfully and rechecked 215 relative links across the updated docs
      Not-tested: Did not connect to a live business export or run full training/evaluation beyond dry-run
      cnb.bofCdSsphPA authored