feat: add northflank smoke workflow

README.md

@@ -34,6 +34,7 @@ Implementation status:
 - [x] Add a post-terminal guard so `step()` is a no-op after `done=True`
 - [x] Re-run the baseline comparison on the `constellaration`-backed branch state
 - [x] Replace the synthetic evaluator with `constellaration`
+- [x] Add a runnable Northflank smoke workflow and note
 - [ ] Add tracked `P1` fixtures under `server/data/p1/`
 - [ ] Run manual playtesting and record the first reward pathology
 - [ ] Refresh the heuristic baseline for the real verifier path

docs/FUSION_DELIVERABLES_MAP.md

@@ -11,6 +11,7 @@ Use this map to sequence execution, not to reopen already-locked task choices.
 - [x] `P1` contract is frozen in code
 - [x] official `constellaration` verifier loop is wired
 - [x] baseline comparison has been rerun on the real verifier path
+- [x] Northflank smoke workflow and note are committed
 - [ ] tracked fixtures are checked in
 - [ ] manual playtest evidence exists
 - [ ] heuristic baseline has been refreshed for the real verifier path

docs/FUSION_DESIGN_LAB_PLAN_V2.md

@@ -12,6 +12,7 @@
 - [x] low-fidelity `run` plus high-fidelity `submit` split is documented
 - [x] post-terminal `step()` guard is in place
 - [x] baseline comparison has been rerun on the real verifier path
+- [x] Northflank smoke workflow and note are committed
 - [ ] tracked `P1` fixtures are added
 - [ ] manual playtest evidence is recorded
 - [ ] heuristic baseline is refreshed for the real verifier path

docs/FUSION_NEXT_12_HOURS_CHECKLIST.md

@@ -14,6 +14,7 @@ Do not expand scope beyond one stable task. Training is supporting evidence, not
 - [x] add a post-terminal guard in `step()`
 - [x] replace the synthetic evaluator with `constellaration`
 - [x] re-run baselines on the real verifier path
+- [x] commit the Northflank smoke workflow and note
 - [ ] add tracked fixtures and manual playtest evidence
 - [ ] refresh the heuristic baseline after the real-verifier rerun
 

training/notebooks/NORTHFLANK_SMOKE_NOTE.md

@@ -0,0 +1,59 @@
+# Northflank Smoke Note
+
+This is the concrete smoke path for the repo's Northflank compute gate.
+
+## Goal
+
+Prove all four required conditions in the Northflank Jupyter workspace:
+
+1. `constellaration` imports
+2. one rotating-ellipse boundary is generated
+3. one low-fidelity verifier call succeeds
+4. one JSON artifact is written to persistent storage
+
+## Repo Entry Point
+
+Use [northflank_smoke.py](/Users/suhjungdae/code/fusion-design-lab/training/notebooks/northflank_smoke.py).
+
+It uses the repo SSOT values from:
+
+- [server/environment.py](/Users/suhjungdae/code/fusion-design-lab/server/environment.py)
+- [server/physics.py](/Users/suhjungdae/code/fusion-design-lab/server/physics.py)
+
+## Northflank Run
+
+Run from the repo root after the notebook container is up and the persistent volume is mounted:
+
+```bash
+uv sync --extra notebooks
+uv run python training/notebooks/northflank_smoke.py \
+  --output-dir /path/to/northflank/persistent-storage/fusion-design-lab/smoke
+```
+
+Replace `/path/to/northflank/persistent-storage/...` with the real mounted path in the workspace.
+
+## Expected Output
+
+The command prints the artifact path it wrote, for example:
+
+```text
+/path/to/northflank/persistent-storage/fusion-design-lab/smoke/northflank_smoke_20260308T000000Z.json
+```
+
+The JSON artifact records:
+
+- UTC timestamp
+- `constellaration` version
+- generated boundary type
+- rotating-ellipse baseline parameters
+- low-fidelity verifier metrics
+
+## Local Dry Run
+
+The same script can be exercised locally with:
+
+```bash
+uv run python training/notebooks/northflank_smoke.py
+```
+
+That writes a small artifact under `training/notebooks/artifacts/`.

training/notebooks/README.md

@@ -14,7 +14,8 @@ Recommended split:
 
 ## Status
 
-- [ ] Northflank smoke notebook note saved
+- [x] Northflank smoke notebook note saved
+- [x] runnable Northflank smoke script saved
 - [ ] manual-playtest notebook or trace notebook saved
 - [ ] thin public Colab notebook saved
 
@@ -32,4 +33,9 @@ Northflank smoke gate:
 - run one low-fidelity verifier call
 - write one artifact to persistent storage
 
+Runnable repo path:
+
+- `uv run python training/notebooks/northflank_smoke.py --output-dir <mounted-persistent-storage-path>`
+- note: `training/notebooks/NORTHFLANK_SMOKE_NOTE.md`
+
 The notebooks are supporting evidence for the environment, not the primary product.

training/notebooks/northflank_smoke.py

@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+import argparse
+import json
+from dataclasses import asdict, dataclass
+from datetime import UTC, datetime
+from importlib.metadata import version
+from pathlib import Path
+
+from constellaration.initial_guess import generate_rotating_ellipse
+
+from server.environment import BASELINE_PARAMS, N_FIELD_PERIODS
+from server.physics import EvaluationMetrics, evaluate_params
+
+
+DEFAULT_OUTPUT_DIR = Path("training/notebooks/artifacts")
+
+
+@dataclass(frozen=True)
+class SmokeArtifact:
+    created_at_utc: str
+    constellaration_version: str
+    boundary_type: str
+    n_field_periods: int
+    params: dict[str, float]
+    metrics: dict[str, float | bool]
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description=(
+            "Run the Fusion Design Lab Northflank smoke check: generate one "
+            "rotating-ellipse boundary, run one low-fidelity verifier call, "
+            "and write a JSON artifact."
+        )
+    )
+    parser.add_argument(
+        "--output-dir",
+        type=Path,
+        default=DEFAULT_OUTPUT_DIR,
+        help=(
+            "Directory where the smoke artifact should be written. On Northflank, "
+            "point this at the mounted persistent storage path."
+        ),
+    )
+    return parser.parse_args()
+
+
+def build_artifact() -> SmokeArtifact:
+    boundary = generate_rotating_ellipse(
+        aspect_ratio=BASELINE_PARAMS.aspect_ratio,
+        elongation=BASELINE_PARAMS.elongation,
+        rotational_transform=BASELINE_PARAMS.rotational_transform,
+        n_field_periods=N_FIELD_PERIODS,
+    )
+    metrics = evaluate_params(
+        BASELINE_PARAMS,
+        n_field_periods=N_FIELD_PERIODS,
+        fidelity="low",
+    )
+    return SmokeArtifact(
+        created_at_utc=datetime.now(UTC).isoformat(),
+        constellaration_version=version("constellaration"),
+        boundary_type=type(boundary).__name__,
+        n_field_periods=N_FIELD_PERIODS,
+        params=BASELINE_PARAMS.model_dump(),
+        metrics=_metrics_payload(metrics),
+    )
+
+
+def write_artifact(output_dir: Path, artifact: SmokeArtifact) -> Path:
+    output_dir.mkdir(parents=True, exist_ok=True)
+    timestamp = datetime.now(UTC).strftime("%Y%m%dT%H%M%SZ")
+    output_path = output_dir / f"northflank_smoke_{timestamp}.json"
+    output_path.write_text(json.dumps(asdict(artifact), indent=2, sort_keys=True) + "\n")
+    return output_path
+
+
+def _metrics_payload(metrics: EvaluationMetrics) -> dict[str, float | bool]:
+    return {
+        "max_elongation": metrics.max_elongation,
+        "aspect_ratio": metrics.aspect_ratio,
+        "average_triangularity": metrics.average_triangularity,
+        "edge_iota_over_nfp": metrics.edge_iota_over_nfp,
+        "p1_score": metrics.p1_score,
+        "p1_feasibility": metrics.p1_feasibility,
+        "constraints_satisfied": metrics.constraints_satisfied,
+        "vacuum_well": metrics.vacuum_well,
+    }
+
+
+def main() -> None:
+    args = parse_args()
+    artifact = build_artifact()
+    output_path = write_artifact(args.output_dir, artifact)
+    print(output_path)
+
+
+if __name__ == "__main__":
+    main()