reviewflow 3.27.0 → 3.29.0

package/dist/dashboard/modules/setupWizardStream.js

@@ -0,0 +1,158 @@
+/**
+ * Dashboard module — Setup Wizard stream client (SPEC-184, Iteration A).
+ * Splits into pure decision functions (unit-tested) and a thin wiring function
+ * `connectSetupWizardStream` that binds them to injected browser globals
+ * (EventSource, document, localStorage). The pure half holds all the logic;
+ * the wiring half is a humble glue object with no branching of its own.
+ *
+ * Transport: per-run SSE via EventSource (NOT the dashboard WebSocket bus).
+ * Iteration A is read-only: awaiting_input renders informational only.
+ */
+
+const STORAGE_COMPLETION_KEY = 'reviewflow.setup.completed';
+
+/**
+ * @param {string} data
+ * @returns {Record<string, unknown> | null}
+ */
+export function parseStreamMessage(data) {
+  try {
+    const parsed = JSON.parse(data);
+    if (parsed && typeof parsed === 'object' && typeof parsed.step === 'string') {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * @param {Array<Record<string, unknown>>} events
+ * @param {Record<string, unknown>} event
+ * @returns {Array<Record<string, unknown>>}
+ */
+export function appendEvent(events, event) {
+  return [...events, event];
+}
+
+/**
+ * @param {{ disconnected: boolean; complete: boolean }} input
+ * @returns {boolean}
+ */
+export function shouldStartPolling(input) {
+  return input.disconnected && !input.complete;
+}
+
+/**
+ * Maps a polled setup-state.json snapshot into the degraded completion events
+ * the view model can fold. Persisted state only carries terminal outcomes
+ * (R8), so this can never reconstruct an in_progress cursor.
+ *
+ * @param {Record<string, unknown> | null} state
+ * @returns {Array<Record<string, unknown>>}
+ */
+export function pollingStateToEvents(state) {
+  if (state === null || typeof state !== 'object') {
+    return [];
+  }
+  const steps = state.steps;
+  if (steps === null || typeof steps !== 'object') {
+    return [];
+  }
+  return Object.entries(steps).map(([step, value]) => {
+    const outcome = value && typeof value === 'object' ? value : {};
+    return {
+      step,
+      status: 'status' in outcome ? outcome.status : null,
+      message: 'message' in outcome ? outcome.message : null,
+      remediation: 'remediation' in outcome ? outcome.remediation : null,
+    };
+  });
+}
+
+/**
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {boolean}
+ */
+export function isRunComplete(events) {
+  return events.some((event) => event.step === 'done' && event.status === 'completed');
+}
+
+/**
+ * @param {{ isPrimaryTab: boolean; hasActiveRun: boolean }} input
+ * @returns {{ readOnly: boolean; notice: string | null }}
+ */
+export function buildMultiTabViewState(input) {
+  if (!input.isPrimaryTab && input.hasActiveRun) {
+    return {
+      readOnly: true,
+      notice: '// SETUP DÉJÀ EN COURS dans un autre onglet',
+    };
+  }
+  return { readOnly: false, notice: null };
+}
+
+/**
+ * @param {{ matches: boolean } | null} mediaQuery
+ * @returns {boolean}
+ */
+export function prefersReducedMotion(mediaQuery) {
+  return mediaQuery !== null && mediaQuery.matches === true;
+}
+
+/**
+ * Thin wiring: binds the pure decisions above to injected browser globals.
+ * Not unit-tested (humble glue) — exercised in the browser only.
+ *
+ * @param {Object} options
+ * @param {string} options.runId
+ * @param {(events: Array<Record<string, unknown>>) => void} options.onEvents
+ * @param {() => void} options.onDisconnected
+ * @param {() => void} options.onComplete
+ * @param {typeof EventSource} [options.eventSourceFactory]
+ * @param {Storage} [options.storage]
+ * @returns {{ close: () => void }}
+ */
+export function connectSetupWizardStream(options) {
+  const EventSourceCtor = options.eventSourceFactory ?? globalThis.EventSource;
+  const storage = options.storage ?? globalThis.localStorage ?? null;
+
+  /** @type {Array<Record<string, unknown>>} */
+  let events = [];
+  const source = new EventSourceCtor(`/api/setup/events?runId=${encodeURIComponent(options.runId)}`);
+
+  source.onmessage = (message) => {
+    const event = parseStreamMessage(message.data);
+    if (event === null) {
+      return;
+    }
+    events = appendEvent(events, event);
+    options.onEvents(events);
+    if (isRunComplete(events)) {
+      if (storage) {
+        storage.setItem(STORAGE_COMPLETION_KEY, String(Date.now()));
+      }
+      source.close();
+      options.onComplete();
+    }
+  };
+
+  source.addEventListener('end', () => {
+    source.close();
+    if (shouldStartPolling({ disconnected: true, complete: isRunComplete(events) })) {
+      options.onDisconnected();
+    }
+  });
+
+  source.onerror = () => {
+    source.close();
+    if (shouldStartPolling({ disconnected: true, complete: isRunComplete(events) })) {
+      options.onDisconnected();
+    }
+  };
+
+  return {
+    close: () => source.close(),
+  };
+}

package/dist/dashboard/modules/setupWizardStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizardStream.js","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizardStream.js"],"names":[],"mappings":"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"}

package/dist/dashboard/modules/worktreePanel.d.ts

@@ -82,7 +82,7 @@ export type LastSweepViewModel = {
     failures: number;
     scanned: number;
 };
-export type DegradedReasonCode = "stale" | "orphan-git-lock" | "unresolved-conflict" | "missing-build-artifacts";
+export type DegradedReasonCode = "stale" | "orphan-git-lock" | "unresolved-conflict";
 export type CleanupEndpointPayload = {
     platform: "gitlab" | "github";
     projectPath: string;

package/dist/dashboard/modules/worktreePanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktreePanel.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/worktreePanel.js"],"names":[],"mappings":"AAsHA;;;GAGG;AACH,mCAHW,MAAM,GAAG,IAAI,GACX,MAAM,CAWlB;AAED;;;GAGG;AACH,8CAHW,MAAM,GACJ,MAAM,CAUlB;AAwBD;;;GAGG;AACH,kDAHW,iBAAiB,GACf,MAAM,CAUlB;AAED;;GAEG;AACH,4CAFa,MAAM,CAyBlB;AAmCD;;;;;;;GAOG;AACH,0CAHW,sBAAsB,GACpB,cAAc,CAS1B;AAED;;;;;;;;GAQG;AACH,mDAJW,sBAAsB,QACtB,cAAc,GACZ,KAAK,CAAC,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,CAUxD;AA0DD;;;GAGG;AACH,+CAHW,oBAAoB,EAAE,GACpB,MAAM,CAKlB;AAED;;;GAGG;AACH,iDAHW,sBAAsB,GACpB,MAAM,CAmElB;AAED;;;GAGG;AACH,kDAHW,OAAO,KAAK,GACV,OAAO,CAAC,sBAAsB,CAAC,CAQ3C;AAED;;;GAGG;AACH,+CAHW,OAAO,KAAK,GACV,OAAO,CAAC,iBAAiB,CAAC,CActC;AAED;;;;GAIG;AACH,6CAJW,sBAAsB,cACtB,OAAO,KAAK,GACV,OAAO,CAAC,kBAAkB,CAAC,CAoBvC;gCA5cY,QAAQ,GAAG,MAAM,GAAG,OAAO;;cAK1B,MAAM;UACN,MAAM;WACN,MAAM;gBACN,MAAM;eACN,MAAM,GAAG,IAAI;YACb,iBAAiB;;;cAKjB,QAAQ,GAAG,QAAQ;iBACnB,MAAM;eACN,oBAAoB,EAAE;;;WAKtB,MAAM;aACN,MAAM;cACN,MAAM;aACN,MAAM;;iCAIP,OAAO,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,yBAAyB;;cAK9E,QAAQ,GAAG,QAAQ;iBACnB,MAAM;cACN,MAAM;;;cAKN,MAAM;cACN,QAAQ,GAAG,QAAQ;iBACnB,MAAM;UACN,MAAM;gBACN,kBAAkB;iBAClB,MAAM;mBACN,MAAM;uBACN,MAAM;4BACN,sBAAsB;;;gBAKtB,MAAM;oBACN,MAAM;iBACN,MAAM;eACN,MAAM;gBACN,MAAM;iBACN,MAAM;eACN,kBAAkB,GAAG,IAAI;YACzB,sBAAsB,EAAE;mBACxB,MAAM;cACN,oBAAoB,EAAE;;iCAIvB;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;WAKlC,MAAM;YACN,MAAM;UACN,MAAM;WACN,MAAM;;;WAKN,MAAM,GAAG,IAAI;YACb,MAAM,GAAG,IAAI;UACb,MAAM,GAAG,IAAI;WACb,MAAM,GAAG,IAAI;;gCAId;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE"}
+{"version":3,"file":"worktreePanel.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/worktreePanel.js"],"names":[],"mappings":"AAsHA;;;GAGG;AACH,mCAHW,MAAM,GAAG,IAAI,GACX,MAAM,CAWlB;AAED;;;GAGG;AACH,8CAHW,MAAM,GACJ,MAAM,CAUlB;AAwBD;;;GAGG;AACH,kDAHW,iBAAiB,GACf,MAAM,CAUlB;AAED;;GAEG;AACH,4CAFa,MAAM,CAyBlB;AAmCD;;;;;;;GAOG;AACH,0CAHW,sBAAsB,GACpB,cAAc,CAS1B;AAED;;;;;;;;GAQG;AACH,mDAJW,sBAAsB,QACtB,cAAc,GACZ,KAAK,CAAC,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,CAUxD;AA0DD;;;GAGG;AACH,+CAHW,oBAAoB,EAAE,GACpB,MAAM,CAKlB;AAED;;;GAGG;AACH,iDAHW,sBAAsB,GACpB,MAAM,CAmElB;AAED;;;GAGG;AACH,kDAHW,OAAO,KAAK,GACV,OAAO,CAAC,sBAAsB,CAAC,CAQ3C;AAED;;;GAGG;AACH,+CAHW,OAAO,KAAK,GACV,OAAO,CAAC,iBAAiB,CAAC,CActC;AAED;;;;GAIG;AACH,6CAJW,sBAAsB,cACtB,OAAO,KAAK,GACV,OAAO,CAAC,kBAAkB,CAAC,CAoBvC;gCA5cY,QAAQ,GAAG,MAAM,GAAG,OAAO;;cAK1B,MAAM;UACN,MAAM;WACN,MAAM;gBACN,MAAM;eACN,MAAM,GAAG,IAAI;YACb,iBAAiB;;;cAKjB,QAAQ,GAAG,QAAQ;iBACnB,MAAM;eACN,oBAAoB,EAAE;;;WAKtB,MAAM;aACN,MAAM;cACN,MAAM;aACN,MAAM;;iCAIP,OAAO,GAAG,iBAAiB,GAAG,qBAAqB;;cAKlD,QAAQ,GAAG,QAAQ;iBACnB,MAAM;cACN,MAAM;;;cAKN,MAAM;cACN,QAAQ,GAAG,QAAQ;iBACnB,MAAM;UACN,MAAM;gBACN,kBAAkB;iBAClB,MAAM;mBACN,MAAM;uBACN,MAAM;4BACN,sBAAsB;;;gBAKtB,MAAM;oBACN,MAAM;iBACN,MAAM;eACN,MAAM;gBACN,MAAM;iBACN,MAAM;eACN,kBAAkB,GAAG,IAAI;YACzB,sBAAsB,EAAE;mBACxB,MAAM;cACN,oBAAoB,EAAE;;iCAIvB;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;WAKlC,MAAM;YACN,MAAM;UACN,MAAM;WACN,MAAM;;;WAKN,MAAM,GAAG,IAAI;YACb,MAAM,GAAG,IAAI;UACb,MAAM,GAAG,IAAI;WACb,MAAM,GAAG,IAAI;;gCAId;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE"}

package/dist/dashboard/modules/worktreePanel.js

@@ -36,7 +36,7 @@
  */
 
 /**
- * @typedef {'stale' | 'orphan-git-lock' | 'unresolved-conflict' | 'missing-build-artifacts'} DegradedReasonCode
+ * @typedef {'stale' | 'orphan-git-lock' | 'unresolved-conflict'} DegradedReasonCode
  */
 
 /**

package/dist/dashboard/setup.html

@@ -0,0 +1,350 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Reviewflow — Setup Wizard</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body class="setup-body">
+  <main class="setup-shell" data-boot="pending">
+    <span class="setup-corner setup-corner--tl" aria-hidden="true"></span>
+    <span class="setup-corner setup-corner--tr" aria-hidden="true"></span>
+    <span class="setup-corner setup-corner--bl" aria-hidden="true"></span>
+    <span class="setup-corner setup-corner--br" aria-hidden="true"></span>
+
+    <header class="setup-header">
+      <div class="setup-boot" aria-hidden="true">
+        <span class="setup-boot-bar"></span>
+        <span class="setup-boot-bar"></span>
+        <span class="setup-boot-bar"></span>
+      </div>
+      <div class="setup-title-block">
+        <p class="setup-eyebrow">// REVIEWFLOW SETUP</p>
+        <h1 id="setup-heading" class="setup-heading">// SÉQUENCE DE DÉMARRAGE</h1>
+      </div>
+    </header>
+
+    <div id="setup-banners" class="setup-banners"></div>
+
+    <div id="setup-disconnect" class="setup-disconnect" hidden role="alert">
+      <span class="setup-banner-title">// CONNEXION PERDUE</span>
+      <span class="setup-disconnect-detail">Lecture dégradée via interrogation périodique de l'état.</span>
+      <a class="btn btn-secondary" href="/setup">Relancer le wizard</a>
+    </div>
+
+    <div id="setup-readonly" class="setup-readonly" hidden role="status"></div>
+
+    <div id="setup-avatar" class="setup-avatar" hidden>
+      <span class="setup-corner setup-corner--tl" aria-hidden="true"></span>
+      <span class="setup-corner setup-corner--tr" aria-hidden="true"></span>
+      <span class="setup-corner setup-corner--bl" aria-hidden="true"></span>
+      <span class="setup-corner setup-corner--br" aria-hidden="true"></span>
+      <canvas id="setup-avatar-canvas" class="setup-avatar-canvas" width="220" height="220" aria-hidden="true"></canvas>
+      <div class="setup-avatar-side">
+        <div id="setup-avatar-status" class="setup-avatar-status">// ÉTAT — INITIALISATION</div>
+        <div id="setup-avatar-form" class="setup-avatar-form"></div>
+      </div>
+    </div>
+
+    <ol id="setup-steps" class="setup-steps" aria-label="Étapes de configuration"></ol>
+
+    <div id="setup-live" class="setup-visually-hidden" role="status" aria-live="polite" aria-atomic="true"></div>
+  </main>
+
+  <script type="module">
+    import {
+      buildStepRowsModel,
+      buildBannerModel,
+      renderStepRow,
+      renderBanner,
+      buildAriaAnnouncement,
+    } from './modules/setupWizard.js';
+    import {
+      connectSetupWizardStream,
+      pollingStateToEvents,
+      buildMultiTabViewState,
+      prefersReducedMotion,
+    } from './modules/setupWizardStream.js';
+    import {
+      buildFormModel,
+      renderForm,
+      buildInputPayload,
+    } from './modules/setupWizardForms.js';
+    import {
+      avatarStateFromEvents,
+      shouldUseAvatar,
+    } from './modules/setupWizardAvatar.js';
+    import { mountSetupWizardAvatar } from './modules/setupWizardAvatarRenderer.js';
+
+    const stepsContainer = document.getElementById('setup-steps');
+    const bannersContainer = document.getElementById('setup-banners');
+    const disconnectBanner = document.getElementById('setup-disconnect');
+    const readOnlyBanner = document.getElementById('setup-readonly');
+    const liveRegion = document.getElementById('setup-live');
+    const shell = document.querySelector('.setup-shell');
+    const headingElement = document.getElementById('setup-heading');
+    const avatarContainer = document.getElementById('setup-avatar');
+    const avatarCanvas = document.getElementById('setup-avatar-canvas');
+    const avatarStatusSlot = document.getElementById('setup-avatar-status');
+    const avatarFormSlot = document.getElementById('setup-avatar-form');
+
+    const reducedMotion = prefersReducedMotion(
+      typeof window.matchMedia === 'function'
+        ? window.matchMedia('(prefers-reduced-motion: reduce)')
+        : null,
+    );
+    if (reducedMotion) {
+      shell.setAttribute('data-reduced-motion', 'true');
+    }
+
+    const canvasSupported =
+      typeof document.createElement('canvas').getContext === 'function' &&
+      document.createElement('canvas').getContext('2d') !== null;
+    const useAvatar = shouldUseAvatar({ canvasSupported, reducedMotion });
+    let avatar = null;
+
+    let lastAnnouncedKey = '';
+    let activeRunId = null;
+    let activeRunReadOnly = false;
+
+    function announce(rows) {
+      const active = rows.find((row) => row.status === 'in_progress')
+        ?? [...rows].reverse().find((row) => row.status !== 'pending');
+      if (!active) {
+        return;
+      }
+      const key = `${active.id}:${active.status}`;
+      if (key === lastAnnouncedKey) {
+        return;
+      }
+      lastAnnouncedKey = key;
+      liveRegion.textContent = buildAriaAnnouncement(active);
+    }
+
+    function applyResumeHeading(banners) {
+      const resume = banners.find((banner) => banner.kind === 'resume');
+      if (resume && resume.position !== null && resume.total !== null) {
+        headingElement.textContent = `// REPRISE — Étape ${resume.position}/${resume.total}`;
+      }
+    }
+
+    function latestAwaitingInput(events) {
+      const last = events[events.length - 1];
+      return last && last.status === 'awaiting_input' ? last : null;
+    }
+
+    async function submitForm(form, model) {
+      const errorSlot = form.querySelector('.setup-form-error');
+      const raw = 'fixedValue' in model ? model.fixedValue : readFormValue(form, model.kind);
+      const result = buildInputPayload(model.kind, activeRunId, raw, model.options);
+      if (!result.ok) {
+        showFormError(errorSlot, result.error);
+        return;
+      }
+      try {
+        const response = await fetch('/api/setup/input', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(result.body),
+        });
+        if (!response.ok) {
+          const payload = await response.json().catch(() => ({}));
+          showFormError(errorSlot, payload.error === 'no-active-run'
+            ? '// SESSION EXPIRÉE — relancez le wizard'
+            : '// ENTRÉE REFUSÉE par le serveur');
+        }
+      } catch {
+        showFormError(errorSlot, '// ENVOI IMPOSSIBLE — vérifiez la connexion');
+      }
+    }
+
+    function readFormValue(form, kind) {
+      if (kind === 'text') {
+        const input = form.querySelector('.setup-form-input');
+        return input ? input.value : '';
+      }
+      if (kind === 'multiSelect') {
+        return [...form.querySelectorAll('.setup-form-checkbox:checked')].map((box) => box.value);
+      }
+      return '';
+    }
+
+    function showFormError(slot, message) {
+      if (!slot) {
+        return;
+      }
+      slot.textContent = message;
+      slot.hidden = false;
+    }
+
+    function bindForm(form, model) {
+      form.addEventListener('submit', (formEvent) => {
+        formEvent.preventDefault();
+        submitForm(form, model);
+      });
+      for (const button of form.querySelectorAll('[data-confirm-value]')) {
+        button.addEventListener('click', () => {
+          submitForm(form, { ...model, fixedValue: button.dataset.confirmValue === 'true' });
+        });
+      }
+      for (const button of form.querySelectorAll('[data-choice-value]')) {
+        button.addEventListener('click', () => {
+          submitForm(form, { ...model, fixedValue: button.dataset.choiceValue });
+        });
+      }
+    }
+
+    function renderActiveForm(events) {
+      if (activeRunReadOnly || activeRunId === null) {
+        return;
+      }
+      const awaiting = latestAwaitingInput(events);
+      const model = buildFormModel(awaiting);
+      if (model === null) {
+        return;
+      }
+      const row = stepsContainer.querySelector(`[data-step-id="${model.stepId}"] .setup-step-body`);
+      if (!row) {
+        return;
+      }
+      row.insertAdjacentHTML('beforeend', renderForm(model));
+      const form = row.querySelector('.setup-form');
+      if (form) {
+        bindForm(form, model);
+      }
+    }
+
+    function renderAvatarForm(events) {
+      const awaiting = latestAwaitingInput(events);
+      const model = activeRunReadOnly || activeRunId === null ? null : buildFormModel(awaiting);
+      if (model === null) {
+        avatarFormSlot.innerHTML = '';
+        return;
+      }
+      avatarFormSlot.innerHTML = renderForm(model);
+      const form = avatarFormSlot.querySelector('.setup-form');
+      if (form) {
+        bindForm(form, model);
+      }
+    }
+
+    function render(events) {
+      const rows = buildStepRowsModel(events);
+      const banners = buildBannerModel(events);
+      stepsContainer.innerHTML = rows.map(renderStepRow).join('');
+      bannersContainer.innerHTML = banners.map(renderBanner).join('');
+      applyResumeHeading(banners);
+      renderActiveForm(events);
+      announce(rows);
+    }
+
+    function renderAvatar(events) {
+      const rows = buildStepRowsModel(events);
+      const banners = buildBannerModel(events);
+      const state = avatarStateFromEvents(events);
+      if (avatar) {
+        avatar.setState(state);
+      }
+      avatarStatusSlot.textContent = `// ÉTAT — ${state.toUpperCase()}`;
+      bannersContainer.innerHTML = banners.map(renderBanner).join('');
+      applyResumeHeading(banners);
+      renderAvatarForm(events);
+      announce(rows);
+    }
+
+    const renderEvents = useAvatar ? renderAvatar : render;
+
+    function showDisconnect() {
+      disconnectBanner.hidden = false;
+    }
+
+    function showReadOnly(notice) {
+      readOnlyBanner.hidden = false;
+      readOnlyBanner.textContent = notice;
+    }
+
+    async function pollOnce() {
+      try {
+        const response = await fetch('/api/setup/state');
+        if (!response.ok) {
+          return;
+        }
+        const payload = await response.json();
+        renderEvents(pollingStateToEvents(payload.state));
+      } catch {
+        /* polling is best-effort; the disconnect banner already informs the user */
+      }
+    }
+
+    function startPolling() {
+      showDisconnect();
+      pollOnce();
+      window.setInterval(pollOnce, 2000);
+    }
+
+    async function startRun() {
+      const response = await fetch('/api/setup/start', { method: 'POST' });
+      if (response.status === 409) {
+        const body = await response.json();
+        const viewState = buildMultiTabViewState({ isPrimaryTab: false, hasActiveRun: true });
+        if (viewState.notice) {
+          showReadOnly(viewState.notice);
+        }
+        subscribe(body.runId, true);
+        return;
+      }
+      const body = await response.json();
+      subscribe(body.runId, false);
+    }
+
+    function subscribe(runId, readOnly) {
+      activeRunId = runId;
+      activeRunReadOnly = readOnly;
+      shell.setAttribute('data-boot', 'ready');
+      connectSetupWizardStream({
+        runId,
+        onEvents: renderEvents,
+        onDisconnected: () => {
+          if (!readOnly) {
+            startPolling();
+          } else {
+            pollOnce();
+          }
+        },
+        onComplete: () => {
+          window.setTimeout(() => {
+            if (avatar) {
+              avatar.destroy();
+              avatar = null;
+            }
+            window.location.href = '/dashboard/';
+          }, reducedMotion ? 0 : 3000);
+        },
+      });
+    }
+
+    window.addEventListener('storage', (event) => {
+      if (event.key === 'reviewflow.setup.completed') {
+        if (avatar) {
+          avatar.destroy();
+          avatar = null;
+        }
+        window.location.href = '/dashboard/';
+      }
+    });
+
+    if (useAvatar) {
+      avatarContainer.hidden = false;
+      stepsContainer.hidden = true;
+      avatar = mountSetupWizardAvatar({ canvas: avatarCanvas, initialState: 'idle' });
+    }
+
+    renderEvents([]);
+    startRun();
+  </script>
+</body>
+</html>