deploy: update Space from deploy_preflight --push

.codeboarding/.codeboardingignore

@@ -0,0 +1,130 @@
+# CodeBoarding Ignore File
+# Add patterns here for files and directories that should be excluded from CodeBoarding analysis.
+# Use the same format as .gitignore (gitignore syntax / gitwildmatch patterns).
+#
+# To stop ignoring a pattern, prefix it with ! (e.g., !important_file.txt)
+#
+# NOTE: The following are ALWAYS excluded (not configurable):
+#   - Hidden directories (starting with .)
+#   - .git/, .codeboarding/, node_modules/, __pycache__/
+#   - Build output: build/, dist/, coverage/
+#
+# This file is automatically loaded by CodeBoarding analysis tools to exclude
+# specified paths from code analysis, architecture generation, and other processing.
+
+# ============================================================================
+# Ignored directories (customizable — remove lines to include them)
+# ============================================================================
+
+# Python virtual environments
+venv/
+env/
+*.egg-info/
+
+# Java (Maven/Gradle) and Rust (Cargo) build output. Both ecosystems
+# produce a top-level ``target/`` directory full of compiled artifacts —
+# kept here as well as in ``_ALWAYS_IGNORED_DIRS`` so users who customize
+# their ``.codeboardingignore`` continue to skip it even after edits.
+target/
+bin/
+out/
+
+# .NET / C# build output
+obj/
+
+# Go
+vendor/
+testdata/
+
+# PHP
+cache/
+
+# Custom
+temp/
+repos/
+runs/
+
+# ============================================================================
+# Test and infrastructure files
+# ============================================================================
+
+# Test directories
+**/__tests__/**
+**/tests/**
+**/test/**
+**/__test__/**
+**/testing/**
+**/testutil/**
+
+# Java/Kotlin test directories (Maven/Gradle structure)
+**/src/test/**
+**/src/testFixtures/**
+**/src/integration-test/**
+**/src/jmh/**
+**/src/contractTest/**
+**/osgi-tests/**
+
+# Test files by naming convention
+*.test.*
+*.spec.*
+*_test.*
+*test_*.py
+test_*.py
+*Test.java
+*IT.java
+*Test.kt
+*IT.kt
+*Tests.java
+
+# Mock, fixture, and stub directories
+**/__mocks__/**
+**/mocks/**
+**/fixtures/**
+**/fixture/**
+**/stubs/**
+**/stub/**
+**/fakes/**
+**/fake/**
+
+# E2E and integration test directories
+**/e2e/**
+**/integration-tests/**
+**/integration_test*/**
+
+# ============================================================================
+# Non-production code
+# ============================================================================
+
+# Example and documentation code
+**/examples/**
+**/documentation/examples/**
+
+# Generated code
+*.pb.go
+**/generated_parser*
+
+# Java/Kotlin metadata files
+module-info.java
+
+# ============================================================================
+# Build artifacts and minified files
+# ============================================================================
+
+*.bundle.js
+*.bundle.js.map
+*.min.js
+*.min.css
+*.chunk.js
+*.chunk.js.map
+
+# ============================================================================
+# Build tool configs and infrastructure
+# ============================================================================
+
+esbuild*
+webpack*
+rollup*
+vite.config.*
+gulpfile*
+gruntfile*
+*.config.*

.codeboarding/logs/wrapper-server.log

@@ -0,0 +1,25 @@
+[stderr] INFO:     Started server process [95234]
+[stderr] INFO:     Waiting for application startup.
+[stderr] INFO:     Application startup complete.
+[stderr] INFO:     Uvicorn running on http://127.0.0.1:8765 (Press CTRL+C to quit)
+INFO:     127.0.0.1:50676 - "GET /health HTTP/1.1" 200 OK
+[stderr] INFO:     ('127.0.0.1', 50686) - "WebSocket /ws" [accepted]
+[stderr] 2026-06-13 13:34:27 INFO     [codeboarding_pro.ws.server:226] WebSocket connected: session ce9a8523-69cd-43d2-81c9-3cce7f7414f9
+[stderr] INFO:     connection open
+[stderr] 2026-06-13 13:34:27 INFO     [tool_registry.installers:451] Installing Node.js packages: ['pyright@1.1.400', 'typescript-language-server@4.3.4', 'typescript@5.7', 'intelephense@1.16.5']
+[stderr] 2026-06-13 13:34:29 INFO     [tool_registry.installers:465] Node.js packages installed successfully
+[stderr] 2026-06-13 13:34:29 INFO     [tool_registry.installers:225]   tokei: already installed, skipping
+[stderr] 2026-06-13 13:34:29 INFO     [tool_registry.installers:225]   gopls: already installed, skipping
+[stderr] 2026-06-13 13:34:29 INFO     [tool_registry.installers:225]   rust-analyzer: already installed, skipping
+[stderr] 2026-06-13 13:34:29 INFO     [tool_registry.installers:489] java already installed
+[stderr] 2026-06-13 13:34:29 WARNING  [tool_registry.installers:367]   csharp-ls: dotnet not found on PATH; skipping install. Users must install it before running analysis.
+[stderr] 2026-06-13 13:34:29 INFO     [static_analyzer.java_utils:125] Found Java 21 at /usr/lib/jvm/java-21-openjdk-amd64
+[stderr] 2026-06-13 13:34:29 INFO     [codeboarding_pro.lsp.bootstrap:56] LSP startup attempt 1/3
+[stderr] 2026-06-13 13:34:29 INFO     [codeboarding_pro.session:185] Session ce9a8523-69cd-43d2-81c9-3cce7f7414f9 initialized: repo=/home/kylebrodeur/projects/microfactory-lab/chief-engineer, project=chief-engineer, output=/home/kylebrodeur/projects/microfactory-lab/chief-engineer/.codeboarding
+[stderr] 2026-06-13 13:34:29 INFO     [static_analyzer:227] Starting engine LSP client for Python at /home/kylebrodeur/projects/microfactory-lab/chief-engineer
+[stderr] 2026-06-13 13:34:30 INFO     [static_analyzer:252] Python LSP start: 0.3s
+[stderr] 2026-06-13 13:34:30 INFO     [codeboarding_pro.file_monitor:106] FileMonitor started for /home/kylebrodeur/projects/microfactory-lab/chief-engineer
+[stderr] 2026-06-13 13:34:30 INFO     [codeboarding_pro.session:203] Session ce9a8523-69cd-43d2-81c9-3cce7f7414f9: FileMonitor activated
+[stderr] 2026-06-13 13:34:30 INFO     [codeboarding_pro.head_watcher:48] HeadWatcher started on /home/kylebrodeur/projects/microfactory-lab/.git/HEAD
+[stderr] 2026-06-13 13:34:30 INFO     [codeboarding_pro.session:248] Session ce9a8523-69cd-43d2-81c9-3cce7f7414f9: LSP wiring complete
+[stderr] 2026-06-13 13:34:30 INFO     [codeboarding_pro.lsp.bootstrap:67] LSP clients started successfully (attempt 1)

.gitattributes

@@ -35,3 +35,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 assets/benchy.glb filter=lfs diff=lfs merge=lfs -text
 a5c557efbc56.cap/content/segments/segment-0/display.mp4 filter=lfs diff=lfs merge=lfs -text
+3ca9c96d1d92.cap/content/segments/segment-0/display.mp4 filter=lfs diff=lfs merge=lfs -text
+3ca9c96d1d92.cap/screenshots/display.jpg filter=lfs diff=lfs merge=lfs -text

3ca9c96d1d92.cap/content/segments/segment-0/cursor.json

@@ -0,0 +1,4 @@
+{
+  "clicks": [],
+  "moves": []
+}

3ca9c96d1d92.cap/content/segments/segment-0/display.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:663a6075dcceca04cc0843d031353ed1110a8008de58fb6a16fb81e15cae7774
+size 5982983

3ca9c96d1d92.cap/content/segments/segment-0/keyboard.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e5cc23716d9b28b4661a952cb0f768a4babdcd0a0b5eac73110d2fac232bef41
+size 7

3ca9c96d1d92.cap/project-config.json

@@ -0,0 +1,113 @@
+{
+  "aspectRatio": null,
+  "background": {
+    "source": {
+      "type": "color",
+      "value": [
+        255,
+        255,
+        255
+      ],
+      "alpha": 255
+    },
+    "blur": 0.0,
+    "padding": 0.0,
+    "rounding": 0.0,
+    "roundingType": "squircle",
+    "inset": 0,
+    "crop": null,
+    "shadow": 73.6,
+    "advancedShadow": {
+      "size": 14.4,
+      "opacity": 68.1,
+      "blur": 3.8
+    },
+    "border": null
+  },
+  "camera": {
+    "hide": false,
+    "mirror": false,
+    "position": {
+      "x": "right",
+      "y": "bottom"
+    },
+    "size": 30.0,
+    "zoomSize": 60.0,
+    "rounding": 100.0,
+    "shadow": 62.5,
+    "advancedShadow": {
+      "size": 33.9,
+      "opacity": 44.2,
+      "blur": 10.5
+    },
+    "shape": "square",
+    "roundingType": "squircle",
+    "scaleDuringZoom": 0.7,
+    "backgroundBlur": {
+      "mode": "off"
+    }
+  },
+  "audio": {
+    "mute": false,
+    "improve": false,
+    "micVolumeDb": 0.0,
+    "micStereoMode": "stereo",
+    "systemVolumeDb": 0.0
+  },
+  "cursor": {
+    "hide": false,
+    "hideWhenIdle": false,
+    "hideWhenIdleDelay": 2.0,
+    "size": 100,
+    "type": "auto",
+    "animationStyle": "mellow",
+    "tension": 470.0,
+    "mass": 3.0,
+    "friction": 70.0,
+    "raw": false,
+    "motionBlur": 0.5,
+    "useSvg": true,
+    "rotationAmount": 0.15,
+    "baseRotation": 0.0,
+    "clickSpring": null,
+    "stopMovementInLastSeconds": null
+  },
+  "hotkeys": {
+    "show": false
+  },
+  "timeline": {
+    "segments": [
+      {
+        "recordingSegment": 0,
+        "timescale": 1.0,
+        "start": 0.0,
+        "end": 69.656689
+      }
+    ],
+    "zoomSegments": [],
+    "sceneSegments": [],
+    "maskSegments": [],
+    "textSegments": [],
+    "captionSegments": [],
+    "keyboardSegments": []
+  },
+  "captions": null,
+  "keyboard": null,
+  "clips": [
+    {
+      "index": 0,
+      "offsets": {
+        "camera": 0.0,
+        "mic": 0.0,
+        "system_audio": 0.0
+      }
+    }
+  ],
+  "annotations": [],
+  "screenMotionBlur": 0.5,
+  "screenMovementSpring": {
+    "stiffness": 200.0,
+    "damping": 40.0,
+    "mass": 2.25
+  }
+}

3ca9c96d1d92.cap/recording-meta.json

@@ -0,0 +1,29 @@
+{
+  "platform": "Windows",
+  "pretty_name": "Cap 2026-06-13 at 13.15.50",
+  "sharing": null,
+  "segments": [
+    {
+      "display": {
+        "path": "content/segments/segment-0/display.mp4",
+        "fps": 33,
+        "start_time": 0.2475809
+      },
+      "cursor": "content/segments/segment-0/cursor.json",
+      "keyboard": "content/segments/segment-0/keyboard.bin"
+    }
+  ],
+  "cursors": {
+    "0": {
+      "imagePath": "content/cursors/cursor_0.png",
+      "hotspot": {
+        "x": 0.34375,
+        "y": 0.3125
+      },
+      "shape": "Windows|Hand"
+    }
+  },
+  "status": {
+    "status": "Complete"
+  }
+}

Makefile

@@ -1,4 +1,4 @@
-.PHONY: setup setup-zerogpu assets run test demo bench trace preflight record record-check
+.PHONY: setup setup-zerogpu assets run test demo bench trace preflight deploy-check deploy record record-check record-auto
 
 # Local dev uses uv (fast, locked). The HF Space still installs via pip+requirements.txt.
 # Entrypoints: app.py + test_core.py at root; helper scripts live in scripts/ and run
@@ -23,9 +23,12 @@ test:       ## headless core tests (no Ollama required)
 preflight:  ## GO/NO-GO gate on the real stack (see RUNBOOK)
 	uv run python -m scripts.preflight
 
-deploy-check: ## deploy/record readiness gate (offline: build + files + creds + Space)
+deploy-check: ## deploy/record readiness gate (offline: build + files + creds + Space + dataset)
 	uv run python -m scripts.deploy_preflight
 
+deploy:     ## run the gates, then UPDATE the Space files (hf upload) + factory reboot (needs HF_TOKEN)
+	uv run python -m scripts.deploy_preflight --push
+
 demo:       ## scripted integration run / video-beat dry run
 	uv run python -m scripts.scripted_demo
 
@@ -41,5 +44,8 @@ record-check: ## recording preflight (cap-cli + Space + playwright gates)
 record:     ## full recording (manual mode): preflight → cap → beat cues → export mp4
 	uv run python -m scripts.record
 
-record-auto: ## recording with Playwright auto-driver (WSL only, may crash)
+record-cues: ## beat cues only (no cap) — you record with Cap desktop at high quality
+	uv run python -m scripts.record --mode cues
+
+record-auto: ## recording with Playwright auto-driver (WSL only)
 	uv run python -m scripts.record --mode auto

README.md

@@ -139,7 +139,7 @@ Astrometrics UI lands (see `../DESIGN.md`). **Not** Well-Tuned — fine-tuning i
 - **Ledger dataset:** [kylebrodeur/chief-engineer-ledger](https://huggingface.co/datasets/kylebrodeur/chief-engineer-ledger)
 - **Demo video:** [<!-- TODO: add video URL after recording -->]()
 - **Social post:** [<!-- TODO: add social post URL after publishing -->]()
-- **Judge's 2-min tour:** [`docs/writeup/JUDGE-GUIDE.md`](https://github.com/kylebrodeur/microfactory-lab/blob/main/chief-engineer/docs/writeup/JUDGE-GUIDE.md)
+- **How to use it (guided tour):** [`docs/RUNBOOK.md` §2](https://github.com/kylebrodeur/microfactory-lab/blob/main/chief-engineer/docs/RUNBOOK.md#2--use-the-tool-the-guided-tour--also-the-judges-tour)
 - **Source:** [kylebrodeur/microfactory-lab](https://github.com/kylebrodeur/microfactory-lab)
 
 ## License

app.py

@@ -293,7 +293,8 @@ def second_opinion(state):
     advice = Advice(**state["advice"])
     verdict = inspector.second_opinion(job, env, settings, advice)
     field_log.log_event("second_opinion", {"material": job.material, "geometry": job.geometry_type,
-                                            "stance": verdict.stance, "headline": verdict.headline})
+                                            "inspector_stance": verdict.stance,
+                                            "inspector_headline": verdict.headline})
     panel = inspector_panel(verdict, label="LA FORGE · SECOND OPINION (PRE-PRINT)")
     if verdict.stance.lower() == "dispute":
         panel += ("<div style='margin-top:6px;padding:6px 10px;border-left:3px solid var(--ao-red,#d9534f);"
@@ -345,7 +346,7 @@ def run_print(state, iterations):
                                        "env_temp": env.temp, "env_humidity": env.humidity,
                                        "iterations": len(sess.records), "q_start": round(traj[0], 3),
                                        "q_end": round(traj[-1], 3), "first_clean": first,
-                                       "verdict": run_summary.stance})
+                                       "inspector_stance": run_summary.stance})
     headline = (
         f"**{state.get('label') or geometry_type} · {material} @ {env.temp:.0f}°C / {env.humidity:.0f}% RH** — "
         f"started at quality **{traj[0]:.2f}** ({sess.records[0].result.outcome}); "

core/field_log.py

@@ -62,56 +62,28 @@ def is_active() -> bool:
     return _get_scheduler() is not None
 
 
-def log_build(job: dict, env: dict, settings: dict, advice: dict,
-              backend: str, used_fallback: bool) -> bool:
-    """Append one BUILD interaction row. Returns True if logged."""
-    sched = _get_scheduler()
-    if sched is None:
-        return False
-
-    row = {
-        "ts": datetime.now(timezone.utc).isoformat(),
-        "material": job.get("material"),
-        "geometry": job.get("geometry_type"),
-        "env_temp": env.get("temp"),
-        "env_humidity": env.get("humidity"),
-        "bed_position": job.get("bed_position"),
-        "printer": job.get("printer", "Creality Ender 3 V2"),
-        "backend": backend,
-        "used_fallback": used_fallback,
-        "settings": {
-            k: v for k, v in settings.items()
-            if k in ("nozzle_temp", "bed_temp", "retraction_mm", "fan_pct",
-                     "first_layer_fan_pct", "print_speed")
-        },
-        "risks": advice.get("risks", []),
-        "inspector_verdict": None,   # filled later if visitor runs Second Opinion
-        "simulated_outcome": None,   # filled later if visitor clicks Simulate
-    }
-
-    with _lock:
-        with FIELD_LOG_FILE.open("a", encoding="utf-8") as f:
-            f.write(json.dumps(row, ensure_ascii=False) + "\n")
-
-    # Tell the scheduler we have new data (it normally scans on a timer,
-    # but this nudges it to notice the append).
-    try:
-        sched.trigger()
-    except Exception:
-        pass  # trigger is best-effort; the timer will catch it
-
-    return True
-
-
-def log_event(kind: str, payload: dict) -> bool:
-    """Append one interaction row of any KIND — build | second_opinion | simulate |
-    record | print_run — so EVERY run (not just BUILD) lands in the shared dataset.
-    Same gate (HF_TOKEN) + privacy rules: config/outcomes only, never PII or files."""
+# Canonical FLAT schema — every row carries exactly these keys (None when N/A), all
+# scalars/strings (no nested dicts/lists). This is what makes the HF dataset viewer
+# render cleanly: a rectangular, well-typed table instead of ragged/nested JSON.
+_CANON = (
+    "ts", "kind", "material", "geometry", "env_temp", "env_humidity",
+    "bed_position", "printer", "backend", "used_fallback",
+    "nozzle_temp", "bed_temp", "fan_pct", "retraction_mm", "first_layer_fan_pct",
+    "risks", "risk_count", "inspector_stance", "inspector_headline", "agreement",
+    "outcome", "quality", "iterations", "q_start", "q_end", "first_clean",
+)
+
+
+def _write_row(fields: dict) -> bool:
+    """Normalize to the canonical flat schema (drop unknown keys, fill missing with
+    None) and append one JSONL line. Gated + exception-safe — never breaks a run."""
     try:
         sched = _get_scheduler()
         if sched is None:
             return False
-        row = {"ts": datetime.now(timezone.utc).isoformat(), "kind": kind, **payload}
+        row = {k: None for k in _CANON}
+        row.update({k: v for k, v in fields.items() if k in _CANON})
+        row["ts"] = datetime.now(timezone.utc).isoformat()
         with _lock:
             with FIELD_LOG_FILE.open("a", encoding="utf-8") as f:
                 f.write(json.dumps(row, ensure_ascii=False) + "\n")
@@ -124,6 +96,32 @@ def log_event(kind: str, payload: dict) -> bool:
         return False  # logging is best-effort — never break a run
 
 
+def log_event(kind: str, payload: dict) -> bool:
+    """Append one interaction row of any KIND — build | second_opinion | simulate |
+    record | print_run — normalized to the canonical flat schema. Same gate (HF_TOKEN)
+    + privacy rules: config/outcomes only, never PII or files."""
+    return _write_row({**payload, "kind": kind})
+
+
+def log_build(job: dict, env: dict, settings: dict, advice: dict,
+              backend: str, used_fallback: bool) -> bool:
+    """Append one BUILD row (flattened settings + risks-as-string for the viewer)."""
+    risks = advice.get("risks", []) or []
+    return _write_row({
+        "kind": "build",
+        "material": job.get("material"), "geometry": job.get("geometry_type"),
+        "env_temp": env.get("temp"), "env_humidity": env.get("humidity"),
+        "bed_position": job.get("bed_position"),
+        "printer": job.get("printer", "Creality Ender 3 V2"),
+        "backend": backend, "used_fallback": used_fallback,
+        "nozzle_temp": settings.get("nozzle_temp"), "bed_temp": settings.get("bed_temp"),
+        "fan_pct": settings.get("fan_pct"), "retraction_mm": settings.get("retraction_mm"),
+        "first_layer_fan_pct": settings.get("first_layer_fan_pct"),
+        "risks": ", ".join(str(r.get("risk")) for r in risks if isinstance(r, dict)) or None,
+        "risk_count": len(risks),
+    })
+
+
 def privacy_notice() -> str:
     """One-line UI disclosure, shown only when logging is active."""
     return (

scripts/deploy_preflight.py

@@ -16,6 +16,7 @@ GO  → safe to `hf upload` + reboot + record.   Run:  make deploy-check
 from __future__ import annotations
 
 import json
+import argparse
 import os
 import re
 import shutil
@@ -25,6 +26,14 @@ from pathlib import Path
 
 ROOT = Path(__file__).resolve().parent.parent
 SPACE = "build-small-hackathon/microfactory-lab"
+FIELD_LOG_DATASET = "build-small-hackathon/chief-engineer-field-log"
+# Uploaded to the Space = everything EXCEPT these (keeps learn/ + assets/ + data/*.jsonl,
+# which the app imports/needs; drops docs, spikes, secrets, caches, runtime/transient files).
+SPACE_IGNORE = [
+    "docs/**", "spike/**", "field_logs/**", ".venv/**", "**/__pycache__/**",
+    "**/*.pyc", ".git/**", ".env", "data/policy.json", "data/_generated.glb",
+    "data/_vprint.gif", "uv.lock", ".pytest_cache/**",
+]
 _fail: list[str] = []
 _warn: list[str] = []
 
@@ -208,7 +217,59 @@ def d9_space(authed: bool) -> None:
         warn("D9 space", f"could not query Space: {e!r}")
 
 
+# ── D10 · the field-log dataset is set + reachable (Sharing-is-Caring / all-runs) ──
+def d10_dataset(authed: bool) -> None:
+    if not authed:
+        warn("D10 dataset", "skipped — no credentials to verify the field-log dataset")
+        return
+    try:
+        from huggingface_hub import HfApi
+        api = HfApi()
+        if api.repo_exists(FIELD_LOG_DATASET, repo_type="dataset"):
+            files = api.list_repo_files(FIELD_LOG_DATASET, repo_type="dataset")
+            logged = any(f.endswith("interactions.jsonl") for f in files)
+            ok("D10 dataset", f"{FIELD_LOG_DATASET} exists"
+               + (" · interactions.jsonl present (runs are logging)" if logged
+                  else " · no interactions.jsonl yet (do one BUILD on the Space to confirm)"))
+        else:
+            warn("D10 dataset", f"{FIELD_LOG_DATASET} not found — create it, or let CommitScheduler "
+                                "make it on first run (needs HF_TOKEN as a Space secret).")
+    except Exception as e:  # noqa: BLE001
+        warn("D10 dataset", f"could not verify dataset: {e!r}")
+
+
+# ── push: actually update the Space files (gated on green + auth) ─────────────
+def push_space(factory_reboot: bool = True) -> None:
+    """Upload the app to the Space (everything except SPACE_IGNORE) and reboot.
+    Only runs after the gates pass + credentials are present."""
+    try:
+        from huggingface_hub import HfApi
+    except Exception as e:  # noqa: BLE001
+        fail("PUSH", f"huggingface_hub unavailable: {e!r}")
+        return
+    api = HfApi()
+    print(f"\n⏫ uploading {ROOT.name}/ → {SPACE} (excluding docs, spike, caches, secrets)…")
+    try:
+        api.upload_folder(repo_id=SPACE, repo_type="space", folder_path=str(ROOT),
+                          ignore_patterns=SPACE_IGNORE,
+                          commit_message="deploy: update Space from deploy_preflight --push")
+        ok("PUSH", "files uploaded")
+        if factory_reboot:
+            api.restart_space(SPACE, factory_reboot=True)
+            ok("PUSH", "factory reboot requested — Space rebuilding (~1-2 min)")
+        print("   Next: wait for build, then smoke-test (BUILD shows reasoning not Error; "
+              "O'Brien/La Forge; reset button; wide UI).")
+    except Exception as e:  # noqa: BLE001
+        fail("PUSH", f"upload/restart failed: {e!r}")
+
+
 def main() -> None:
+    ap = argparse.ArgumentParser(description="Deploy/record readiness gate (+ optional Space push).")
+    ap.add_argument("--push", action="store_true",
+                    help="after the gates pass, UPDATE the Space files (hf upload) + factory reboot")
+    ap.add_argument("--no-reboot", action="store_true", help="with --push, skip the factory reboot")
+    args = ap.parse_args()
+
     print("Deploy / record preflight — " + SPACE)
     print("=" * 70)
     d1_build()
@@ -221,16 +282,24 @@ def main() -> None:
     d7_data()
     authed = d8_credentials()
     d9_space(authed)
+    d10_dataset(authed)
     print("=" * 70)
     if _fail:
         print(f"🔴 NO-GO: fix {len(_fail)} blocker(s) — {', '.join(_fail)}")
         sys.exit(1)
+    if args.push:
+        if not authed:
+            print("🔴 --push needs HF credentials (HF_TOKEN or `hf auth login`). Nothing pushed.")
+            sys.exit(1)
+        push_space(factory_reboot=not args.no_reboot)
+        sys.exit(1 if _fail else 0)
     if _warn:
         print(f"🟡 GO with warnings ({', '.join(_warn)}) — read them; credentials/Space "
-              "warnings just mean 'deploy from an authenticated machine'.")
+              "warnings just mean 'deploy from an authenticated machine'. "
+              "Run with --push (authenticated) to update the Space.")
         sys.exit(0)
     print("🟢 GO — local build clean, files + frontmatter ready, authenticated. "
-          "hf upload → --factory-reboot → smoke-test → record.")
+          "Re-run with --push to update the Space + reboot, then smoke-test → record.")
 
 
 if __name__ == "__main__":

scripts/record.py

@@ -39,6 +39,8 @@ EXPORT_DIR_WIN = "D:\\workspace\\recordings"  # must exist from Windows side
 EXPORT_DIR_WSL = "/mnt/d/workspace/recordings"    # WSL equivalent
 SLOWMO_DEFAULT = 400  # ms between Playwright actions
 CAP_FPS = "60"  # recording quality (1-120)
+EXPORT_QUALITY = "maximum"  # mp4 compression: maximum, social, web, potato
+EXPORT_RES = "1707x1067"  # native screen resolution
 
 
 # ---------------------------------------------------------------------------
@@ -472,21 +474,29 @@ MANUAL_BEATS: dict[str, list[dict]] = {
 # record
 # ---------------------------------------------------------------------------
 
-def record_manual(beat_name: str, url: str = SPACE_URL) -> Path | None:
-    """Manual mode: start cap, print beat cues with countdowns, stop cap, export.
-    You drive the Windows browser — Playwright stays out of it."""
+def record_manual(beat_name: str, url: str = SPACE_URL, no_cap: bool = False) -> Path | None:
+    """Manual mode: print beat cues with countdowns. If no_cap=False, also
+    starts/stops/exports via cap CLI. If no_cap=True, just prints cues — you
+    handle recording yourself (e.g. Cap desktop at higher quality)."""
     print(f"\n=== RECORD (manual): beat '{beat_name}' ===\n")
 
-    # 1) Start detached Cap recording
-    print("  starting Cap recording (detached)...")
-    screen_id = _get_screen_id()
-    started = _cap_json("record", "start", "--screen", screen_id, "--detach", "--json")
-    if not started or "recordingId" not in started:
-        print("  ✗ failed to start recording")
-        return None
-    rec_id = started["recordingId"]
-    cap_path = started.get("path", "unknown")
-    print(f"  ✓ recording started  (id={rec_id})")
+    rec_id = None
+    cap_path = None
+
+    if not no_cap:
+        # 1) Start detached Cap recording
+        print("  starting Cap recording (detached)...")
+        screen_id = _get_screen_id()
+        started = _cap_json("record", "start", "--screen", screen_id, "--fps", CAP_FPS, "--detach", "--json")
+        if not started or "recordingId" not in started:
+            print("  ✗ failed to start recording")
+            return None
+        rec_id = started["recordingId"]
+        cap_path = started.get("path", "unknown")
+        print(f"  ✓ recording started  (id={rec_id})")
+    else:
+        print("  🎬 Start your Cap desktop recording NOW (high quality).")
+        time.sleep(2)
 
     # 2) Print beat cues — user drives the browser
     beats = MANUAL_BEATS.get(beat_name, MANUAL_BEATS["all"])
@@ -512,6 +522,11 @@ def record_manual(beat_name: str, url: str = SPACE_URL) -> Path | None:
         time.sleep(1)
     print(f"  ✓ cut{' ' * 20}")
 
+    if no_cap:
+        print("\n  🛑 Stop your Cap desktop recording now.")
+        print(f"  📁 Export from Cap desktop to: D:\\workspace\\recordings\\demo-{beat_name}-<ts>.mp4")
+        return None
+
     # 3) Stop recording
     print("\n  stopping recording...")
     stopped = _cap_json("record", "stop", "--id", rec_id, "--json")
@@ -524,7 +539,7 @@ def record_manual(beat_name: str, url: str = SPACE_URL) -> Path | None:
     ts = time.strftime("%Y%m%d-%H%M%S")
     out_win = f"{EXPORT_DIR_WIN}\\demo-{beat_name}-{ts}.mp4"
     print(f"  exporting to {out_win} ...")
-    export_result = _cap("export", cap_path, "--output", out_win, "--json")
+    export_result = _cap("export", cap_path, "--output", out_win, "--quality", EXPORT_QUALITY, "--resolution", EXPORT_RES, "--json")
     if "Completed" in export_result.stdout or "Progress" in export_result.stdout:
         print(f"  ✓ exported → {out_win}")
         return Path(EXPORT_DIR_WSL) / f"demo-{beat_name}-{ts}.mp4"
@@ -559,6 +574,10 @@ def record_auto(beat_name: str, slowmo: int, pause: float, url: str = SPACE_URL)
             page = browser.new_page()
         page.set_viewport_size({"width": 1707, "height": 1067})  # native screen res
 
+        # Go fullscreen (F11) — hides taskbar + title bar for clean recording
+        page.keyboard.press("F11")
+        time.sleep(0.5)
+
         # Dismiss Chrome restore bubble + any initial popups
         time.sleep(1.0)
         _dismiss_popups(page)
@@ -610,7 +629,7 @@ def record_auto(beat_name: str, slowmo: int, pause: float, url: str = SPACE_URL)
     ts = time.strftime("%Y%m%d-%H%M%S")
     out_win = f"{EXPORT_DIR_WIN}\\demo-{beat_name}-{ts}.mp4"
     print(f"  exporting to {out_win} ...")
-    export_result = _cap("export", cap_path, "--output", out_win, "--json")
+    export_result = _cap("export", cap_path, "--output", out_win, "--quality", EXPORT_QUALITY, "--resolution", EXPORT_RES, "--json")
     if "Completed" in export_result.stdout or "Progress" in export_result.stdout:
         print(f"  ✓ exported → {out_win}")
         return Path(EXPORT_DIR_WSL) / f"demo-{beat_name}-{ts}.mp4"
@@ -629,8 +648,8 @@ def main() -> None:
     )
     ap.add_argument("--beat", default="all", choices=sorted(MANUAL_BEATS),
                     help="which beat(s) to record (default: all)")
-    ap.add_argument("--mode", default="manual", choices=["manual", "auto"],
-                    help="manual=you drive the Windows browser (default); auto=Playwright (WSL only, unreliable)")
+    ap.add_argument("--mode", default="manual", choices=["manual", "auto", "cues"],
+                    help="manual=cap CLI + cues; auto=Playwright; cues=just print beat cues (you record with Cap desktop)")
     ap.add_argument("--preflight-only", action="store_true",
                     help="run preflight checks and exit")
     ap.add_argument("--slowmo", type=int, default=SLOWMO_DEFAULT,
@@ -652,6 +671,8 @@ def main() -> None:
 
     if args.mode == "auto":
         result = record_auto(args.beat, args.slowmo, args.pause, url)
+    elif args.mode == "cues":
+        result = record_manual(args.beat, url, no_cap=True)
     else:
         result = record_manual(args.beat, url)