fix(dwh): release snapshots before job startup

.superpowers/sdd/evidence-task-6-report.md

@@ -28,3 +28,8 @@ pickle bytes can neither pass validation nor enter the snapshot. Reconciliation
 generation descriptor in a `finally` block on matches, mismatches, and exceptions. Pipeline-owned
 snapshot directories are removed and deregistered after `run_job` on both successful and failed
 runs, preventing repeated pipeline use from accumulating temporary directories or registry entries.
+
+The cleanup boundary now begins immediately after snapshot materialization. Resume checkpoint
+validation and `JobSpec` construction are guarded by the same release routine as `run_job`, so
+corrupt/mismatched resume state or constructor failure clears the pipeline holder, removes the
+private directory, and restores the snapshot registry to its prior state before propagating.

harness/tests/test_dwh_preprocess_job.py

@@ -608,6 +608,61 @@ def test_pipeline_releases_materialized_snapshot_after_every_run(tmp_path):
     assert pipeline._snapshot_holder is None
 
 
+def test_corrupt_resume_checkpoint_releases_materialized_snapshot(tmp_path):
+    import tht.jobs.dwh_pipeline as module
+    import pytest
+
+    pipeline = DwhPreprocessPipeline(
+        workspace_id="demo", workspace_root=tmp_path,
+        config_fingerprint=FP, input_fingerprint=FP,
+        introspect=lambda output: output.write_text("catalog"),
+        build_lsh=lambda physical, output: _write_lsh([], physical, output),
+    )
+    assert pipeline.run().status == "succeeded"
+    baseline = set(module._SNAPSHOT_DIRS)
+    run_id = "e" * 32
+    run_dir = tmp_path / ".tht-jobs" / "dwh" / "runs" / run_id
+    run_dir.mkdir(parents=True)
+    (run_dir / "checkpoint.json").write_text("not-json")
+
+    with pytest.raises(Exception, match="checkpoint is invalid"):
+        pipeline.run(resume_run_id=run_id)
+    assert pipeline._snapshot_holder is None
+    assert set(module._SNAPSHOT_DIRS) == baseline
+
+
+def test_job_spec_construction_failure_releases_materialized_snapshot(monkeypatch, tmp_path):
+    import tht.jobs.dwh_pipeline as module
+    import pytest
+
+    pipeline = DwhPreprocessPipeline(
+        workspace_id="demo", workspace_root=tmp_path,
+        config_fingerprint=FP, input_fingerprint=FP,
+        introspect=lambda output: output.write_text("catalog"),
+        build_lsh=lambda physical, output: _write_lsh([], physical, output),
+    )
+    assert pipeline.run().status == "succeeded"
+    baseline = set(module._SNAPSHOT_DIRS)
+    captured = []
+    real_materialize = module._materialize_generation_fd
+
+    def capture(*args, **kwargs):
+        holder, root = real_materialize(*args, **kwargs)
+        captured.append(holder)
+        return holder, root
+
+    monkeypatch.setattr(module, "_materialize_generation_fd", capture)
+    monkeypatch.setattr(
+        module, "JobSpec",
+        lambda **kwargs: (_ for _ in ()).throw(RuntimeError("job spec injected")),
+    )
+    with pytest.raises(RuntimeError, match="job spec injected"):
+        pipeline.run()
+    assert pipeline._snapshot_holder is None
+    assert set(module._SNAPSHOT_DIRS) == baseline
+    assert captured and all(not path.exists() for path in captured)
+
+
 def test_publish_root_swap_after_lease_never_writes_replacement(monkeypatch, tmp_path):
     import tht.jobs.dwh_pipeline as module
 

harness/tht/jobs/dwh_pipeline.py

@@ -601,19 +601,23 @@ class DwhPreprocessPipeline:
                 self.current_lsh_dir = snapshot_root
         finally:
             lease.close()
-        if resume_run_id is not None:
+        try:
-            self._validate_resume_publication(resume_run_id)
+            if resume_run_id is not None:
-        spec = JobSpec(
+                self._validate_resume_publication(resume_run_id)
-            workspace_id=self.workspace_id,
+            spec = JobSpec(
-            job_type="dwh",
+                workspace_id=self.workspace_id,
-            workspace_root=self.workspace_root,
+                job_type="dwh",
-            spec_version="jobs-v1",
+                workspace_root=self.workspace_root,
-            pipeline_version="dwh-v2",
+                spec_version="jobs-v1",
-            config_fingerprint=self.config_fingerprint,
+                pipeline_version="dwh-v2",
-            input_fingerprint=self.input_fingerprint,
+                config_fingerprint=self.config_fingerprint,
-            stage_ids=steps,
+                input_fingerprint=self.input_fingerprint,
-            resume_run_id=resume_run_id,
+                stage_ids=steps,
-        )
+                resume_run_id=resume_run_id,
+            )
+        except BaseException:
+            self._release_pipeline_snapshot()
+            raise
 
         def introspect_stage(context: JobContext):
             artifacts = self._artifacts(context)
@@ -651,16 +655,19 @@ class DwhPreprocessPipeline:
                 reconcile_effects=self._reconcile_effects,
             )
         finally:
-            holder, self._snapshot_holder = self._snapshot_holder, None
+            self._release_pipeline_snapshot()
-            if isinstance(holder, Path):
+
-                shutil.rmtree(holder, ignore_errors=True)
+    def _release_pipeline_snapshot(self) -> None:
-                _SNAPSHOT_DIRS.discard(holder)
+        holder, self._snapshot_holder = self._snapshot_holder, None
-                if self.current_physical is not None and holder in self.current_physical.parents:
+        if isinstance(holder, Path):
-                    self.current_physical = None
+            shutil.rmtree(holder, ignore_errors=True)
-                if self.current_lsh_dir is not None and (
+            _SNAPSHOT_DIRS.discard(holder)
-                    self.current_lsh_dir == holder or holder in self.current_lsh_dir.parents
+            if self.current_physical is not None and holder in self.current_physical.parents:
-                ):
+                self.current_physical = None
-                    self.current_lsh_dir = None
+            if self.current_lsh_dir is not None and (
+                self.current_lsh_dir == holder or holder in self.current_lsh_dir.parents
+            ):
+                self.current_lsh_dir = None
 
     def _reconcile_effects(self, source, run_dir: Path) -> set[str]:
         running = next(