test: validar localmente y separar smoke real

docs/development/LOCAL_VALIDATION.md

@@ -23,3 +23,14 @@ bash scripts/run_real_media_smoke.sh
 El wrapper fuerza `RUN_EXTERNAL_PROVIDER_TESTS=0`; cualquier ejecución real
 requiere la confirmación explícita. Los artefactos y tiempos deben anotarse en
 `comunicaciones/review.md` (fuera de Git).
+
+Para probar únicamente ACE-Step y no renderizar el videoclip:
+
+```bash
+NIGHTLY_MEDIA_SCOPE=song \
+RUN_GPU_TESTS=1 HOCUSPOCUS_SMOKE_CONFIRM=GENERATE_REAL_MEDIA \
+HOCUSPOCUS_SMOKE_BASE_URL=http://127.0.0.1:42003 \
+bash scripts/run_real_media_smoke.sh
+```
+
+El valor `all` (por defecto) continúa con análisis, planificación y videoclip.

scripts/nightly_wizard_smoke.mjs

@@ -135,6 +135,7 @@ function smokeProject(projectId, cueId, now) {
 
 export async function runMediaSmoke({
   baseUrl, workspace = 'nightly-smoke', runGpu = false, runExternal = false, confirm,
+  mediaScope = 'all',
   fetchImpl = globalThis.fetch, timeoutMs = 6 * 60 * 60 * 1000, pollIntervalMs = 5_000,
 } = {}) {
   const root = validateSmokeOptIn({ runGpu, runExternal, baseUrl, confirm })
@@ -192,6 +193,17 @@ export async function runMediaSmoke({
       library: { ...saved, activeId: projectId, projects: { ...saved.projects, [projectId]: project } },
     }, controller.signal)
 
+    if (mediaScope === 'song') {
+      return {
+        workspace,
+        identifiers: {
+          projectIds: [projectId], cueIds: [cueId], outputIds: [filename],
+          taskIds: [song.task_id || startedSong.task_id].filter(Boolean), pipelineIds: [],
+        },
+        songStatus: song.status, pipelineStatus: 'not_requested', semantic,
+      }
+    }
+
     const analysis = await requestJson(fetchImpl, root, 'POST', '/api/v1/audio/analyze', {
       audio_path: audioPath, transcribe: true, extract_vocals: true, lyrics_hint: cue.lyrics, workspace,
     }, controller.signal)
@@ -241,6 +253,7 @@ if (invokedPath === new URL(import.meta.url).pathname) {
       workspace: process.env.HOCUSPOCUS_SMOKE_WORKSPACE || 'nightly-smoke',
       runGpu: process.env.RUN_GPU_TESTS === '1', runExternal: process.env.RUN_EXTERNAL_PROVIDER_TESTS === '1',
       confirm: process.env.HOCUSPOCUS_SMOKE_CONFIRM,
+      mediaScope: process.env.NIGHTLY_MEDIA_SCOPE || 'all',
       timeoutMs: Number(process.env.NIGHTLY_SMOKE_TIMEOUT_MS || 6 * 60 * 60 * 1000),
     })
     process.stdout.write(`SMOKE_RESULT ${JSON.stringify(result)}\n`)

scripts/run_real_media_smoke.sh

@@ -13,4 +13,5 @@ fi
 # Level 8 is deliberately local for music: ACE-Step, never MiniMax Music.
 export RUN_EXTERNAL_PROVIDER_TESTS=0
 export NIGHTLY_LEVELS=8
+export NIGHTLY_MEDIA_SCOPE="${NIGHTLY_MEDIA_SCOPE:-all}"
 exec "$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts/nightly_wizard_validation.sh" "$@"

scripts/validate_local.sh

@@ -12,6 +12,19 @@ echo '[local] Python contracts'
   "$ROOT/tests/test_tools_upscale_contract.py" \
   "$ROOT/tests/test_architecture_contracts.py"
 
+echo '[local] code-health ratchet against origin/main'
+BASE_SHA="$(git -C "$ROOT" merge-base HEAD origin/main 2>/dev/null || true)"
+if [[ -n "$BASE_SHA" ]]; then
+  BASE_DIR="$(mktemp -d "${TMPDIR:-/tmp}/hocus-health.XXXXXX")"
+  trap 'git -C "$ROOT" worktree remove --force "$BASE_DIR" >/dev/null 2>&1 || true' EXIT
+  git -C "$ROOT" worktree add --detach "$BASE_DIR" "$BASE_SHA" >/dev/null
+  ln -s "$UI/node_modules" "$BASE_DIR/ui/node_modules" 2>/dev/null || true
+  (cd "$BASE_DIR" && python scripts/code_health.py --json) > "$BASE_DIR/code-health-base.json"
+  "$PYTHON" "$ROOT/scripts/code_health.py" --check --baseline "$BASE_DIR/code-health-base.json" >/dev/null
+  trap - EXIT
+  git -C "$ROOT" worktree remove --force "$BASE_DIR" >/dev/null 2>&1 || true
+fi
+
 echo '[local] UI tests, lint and build'
 (cd "$UI" && npm test && npm run lint -- --max-warnings=0 && npm run build)