reviewflow 3.28.0 → 3.30.0

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.30.0](https://github.com/DGouron/review-flow/compare/reviewflow-v3.29.0...reviewflow-v3.30.0) (2026-05-28)
+
+
+### Added
+
+* **dashboard:** SPEC-189 Ember flame wireframe avatar + sidebar layout ([#248](https://github.com/DGouron/review-flow/issues/248)) ([7e82a2f](https://github.com/DGouron/review-flow/commit/7e82a2fb385c8990558e3fd15e103b2e8bbd40e7))
+
+## [3.29.0](https://github.com/DGouron/review-flow/compare/reviewflow-v3.28.0...reviewflow-v3.29.0) (2026-05-28)
+
+
+### Added
+
+* **dashboard:** SPEC-189 Ember read-only review chat (Phase A) ([#244](https://github.com/DGouron/review-flow/issues/244)) ([4e0d5b9](https://github.com/DGouron/review-flow/commit/4e0d5b9bb37a68cc2c91454412a35ce34107f1ed))
+
+
+### Fixed
+
+* **docs:** unblock vitepress build and refresh setup-wizard docs ([83ce3bb](https://github.com/DGouron/review-flow/commit/83ce3bbbea6e80851742c8af08cfbb912bdc66d5))
+* **docs:** unblock vitepress build and refresh setup-wizard docs ([fc5896d](https://github.com/DGouron/review-flow/commit/fc5896d14cc378d51bf17c9f51ebc01360cbc6bb))
+
 ## [3.28.0](https://github.com/DGouron/review-flow/compare/reviewflow-v3.27.0...reviewflow-v3.28.0) (2026-05-28)
 
 
@@ -16,6 +36,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 * **setup-wizard:** SPEC-184 Iteration B — dashboard wizard interactive forms ([#238](https://github.com/DGouron/review-flow/issues/238)) ([806515b](https://github.com/DGouron/review-flow/commit/806515b4a69efbfaf8022185e545393dc7525623))
 * **setup-wizard:** SPEC-187 read wizard answers from stdin in JSON mode ([#237](https://github.com/DGouron/review-flow/issues/237)) ([8476550](https://github.com/DGouron/review-flow/commit/8476550edbfce72743e882e2c4a907d60c5ab9a4))
 
+
+### Fixed
+
+* **worktree:** drop false-positive missing-build-artifacts signal ([#239](https://github.com/DGouron/review-flow/issues/239)) ([41a3a79](https://github.com/DGouron/review-flow/commit/41a3a79b5bec924f895ebfa35197d003fde95dd3))
+
 ## [3.27.0](https://github.com/DGouron/review-flow/compare/reviewflow-v3.26.0...reviewflow-v3.27.0) (2026-05-27)
 
 

package/dist/dashboard/index.html

@@ -101,18 +101,39 @@
 
     <div class="dashboard-layout">
       <aside class="dashboard-sidebar" aria-label="Project tools">
-        <button type="button" id="open-settings-modal-btn" class="sidebar-settings-button" hidden>
-          <span class="sidebar-settings-button__prefix">// SETTINGS</span>
-        </button>
-        <button type="button" id="open-economics-sheet-btn" class="sidebar-settings-button" onclick="openEconomicsSheet()">
-          <span class="sidebar-settings-button__prefix">// CLAUDE ECONOMICS</span>
-        </button>
-        <button type="button" id="open-stats-sheet-btn" class="sidebar-settings-button" onclick="openStatsSheet()" disabled aria-disabled="true">
-          <span class="sidebar-settings-button__prefix">// PROJECT STATS</span>
-        </button>
+        <div class="sidebar-tool-buttons">
+          <button type="button" id="open-settings-modal-btn" class="sidebar-settings-button" hidden>
+            <span class="sidebar-settings-button__prefix">// SETTINGS</span>
+          </button>
+          <button type="button" id="open-economics-sheet-btn" class="sidebar-settings-button" onclick="openEconomicsSheet()">
+            <span class="sidebar-settings-button__prefix">// ECONOMICS</span>
+          </button>
+          <button type="button" id="open-stats-sheet-btn" class="sidebar-settings-button" onclick="openStatsSheet()" disabled aria-disabled="true">
+            <span class="sidebar-settings-button__prefix">// STATS</span>
+          </button>
+        </div>
 
         <span id="config-status" class="config-status hidden"></span>
 
+        <section id="ember-chat-panel" class="ember-chat-panel" aria-label="Ember">
+          <div class="ember-chat-panel__header">
+            <span class="ember-chat-panel__prefix">// EMBER</span>
+            <canvas id="ember-avatar" class="ember-chat-panel__avatar" width="360" height="360" aria-hidden="true"></canvas>
+          </div>
+          <output id="ember-answer" class="ember-chat-panel__answer" aria-live="polite"></output>
+          <div id="ember-status" class="ember-chat-panel__status" role="status" aria-live="polite"></div>
+          <button type="button" id="ember-retry" class="ember-chat-panel__retry" hidden>// RÉESSAYER</button>
+          <form id="ember-form" class="ember-chat-panel__form" autocomplete="off">
+            <label class="visually-hidden" for="ember-question">Posez une question à Ember</label>
+            <input
+              type="text"
+              id="ember-question"
+              class="ember-chat-panel__input"
+              placeholder="Posez une question sur vos reviews…"
+            />
+          </form>
+        </section>
+
         <section id="worktree-section" aria-label="Worktree pool"></section>
       </aside>
 
@@ -429,6 +450,8 @@
       buildHeaderCapacityViewModel,
       renderHeaderCapacityBadgeHtml,
     } from './modules/headerCapacityBadge.js';
+    import { connectEmberStream, shouldSendQuestion } from './modules/emberChat.js';
+    import { mountEmberAvatar } from './modules/emberAvatarRenderer.js';
 
     const API_URL = window.location.origin;
     const WS_URL = `ws://${window.location.host}/ws`;
@@ -3838,6 +3861,47 @@
       }).catch(() => {});
     });
 
+    // Ember read-only chat (SPEC-189). The pure decisions + SSE fold live in
+    // emberChat.js; this humble init just binds DOM and the reused avatar.
+    function initEmberChat() {
+      const form = document.getElementById('ember-form');
+      const input = document.getElementById('ember-question');
+      const answer = document.getElementById('ember-answer');
+      const status = document.getElementById('ember-status');
+      const retry = document.getElementById('ember-retry');
+      const canvas = document.getElementById('ember-avatar');
+      const panel = document.getElementById('ember-chat-panel');
+      if (!form || !input || !answer || !status || !canvas) return;
+
+      const avatar = mountEmberAvatar({ canvas, initialState: 'idle' });
+
+      const ask = async () => {
+        const question = input.value;
+        if (!shouldSendQuestion(question)) {
+          input.focus();
+          return;
+        }
+        panel?.classList.add('ember-chat-panel--active');
+        answer.textContent = '';
+        status.textContent = '';
+        retry.hidden = true;
+        await connectEmberStream({
+          question,
+          onAnswer: (text) => { answer.textContent = text; },
+          onAvatarState: (state) => avatar.setState(state),
+          onAnnounce: (text) => { status.textContent = text; },
+          onRetryVisible: (visible) => { retry.hidden = !visible; },
+        });
+        input.focus();
+      };
+
+      form.addEventListener('submit', (event) => {
+        event.preventDefault();
+        void ask();
+      });
+      retry.addEventListener('click', () => { void ask(); });
+    }
+
     // Boot animations & observers exactly once, regardless of readyState timing
     let __animationsBooted = false;
     function bootOnce() {
@@ -3845,6 +3909,7 @@
       __animationsBooted = true;
       bootAnimations();
       observeCounters();
+      initEmberChat();
     }
     if (document.readyState !== 'loading') {
       bootOnce();

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

@@ -0,0 +1,134 @@
+/**
+ * Maps an ember state to its stroke/animation parameters. Keeps the renderer
+ * humble: every per-state decision lives here, not in the canvas loop.
+ *
+ * @param {EmberState} state
+ * @returns {EmberVisual}
+ */
+export function emberStateToVisual(state: EmberState): EmberVisual;
+/**
+ * Builds the flame wireframe as a surface of revolution: a single tip vertex
+ * (index 0) plus `rings` × `meridians` body vertices, joined by tip spokes,
+ * vertical meridian lines and horizontal ring loops. Pure and deterministic.
+ *
+ * @param {{ rings: number; meridians: number }} options
+ * @returns {{ vertices: Vertex[]; edges: Array<[number, number]> }}
+ */
+export function buildFlameWireframe(options: {
+    rings: number;
+    meridians: number;
+}): {
+    vertices: Vertex[];
+    edges: Array<[number, number]>;
+};
+/**
+ * @typedef {Object} Projection
+ * @property {number} tilt Fixed X-axis tilt in radians.
+ * @property {number} distance Camera distance for the perspective divide.
+ * @property {number} scale Pixels per unit at the projection plane.
+ * @property {number} centerX Canvas-space x offset.
+ * @property {number} centerY Canvas-space y offset.
+ */
+/**
+ * Projects a flame vertex to a 2D canvas point: rotates around Y, leans the
+ * upper body sideways by `swayOffset` scaled by height (a candle flame bends at
+ * the tip, not the base), applies the fixed tilt, then a perspective divide.
+ * Pure and deterministic.
+ *
+ * @param {Vertex} vertex
+ * @param {number} rotationRadians
+ * @param {number} swayOffset
+ * @param {Projection} projection
+ * @returns {{ x: number; y: number }}
+ */
+export function projectFlameVertex(vertex: Vertex, rotationRadians: number, swayOffset: number, projection: Projection): {
+    x: number;
+    y: number;
+};
+export function emberRadiusFactor(visual: any, time: any): number;
+/**
+ * The horizontal lean of the flame tip at a given time. Pure — 0 at time 0,
+ * always within ± swayAmount.
+ *
+ * @param {EmberVisual} visual
+ * @param {number} time Milliseconds since the loop started.
+ * @returns {number}
+ */
+export function emberSwayOffset(visual: EmberVisual, time: number): number;
+/**
+ * Dashboard module — Ember flame wireframe avatar (SPEC-189).
+ * Humble object: pure functions, no DOM, no global state. Holds the flame-shaped
+ * wireframe geometry and every per-state visual decision, so the
+ * requestAnimationFrame loop in emberAvatarRenderer.js carries no branching.
+ *
+ * Ember is a warm wireframe BRAISE, not the setup wizard's abstract icosahedron:
+ * a teardrop flame mesh (pointed tip, rounded base) stroked in amber, that leans
+ * and flickers like a live coal — livelier and warmer when spoken to.
+ *
+ * Visual DNA: "Agentic OS" — dark warm near-black + amber. See
+ * project_agentic_os_design_dna.md.
+ */
+/**
+ * @typedef {'idle' | 'working' | 'error'} EmberState
+ */
+/** @type {EmberState[]} */
+export const EMBER_STATES: EmberState[];
+/** Top of the flame (the tip) in model space. */
+export const FLAME_TIP_Y: 1.5;
+/** Bottom of the flame (the rounded base) in model space. */
+export const FLAME_BASE_Y: -1.15;
+export type Vertex = [number, number, number];
+export type Projection = {
+    /**
+     * Fixed X-axis tilt in radians.
+     */
+    tilt: number;
+    /**
+     * Camera distance for the perspective divide.
+     */
+    distance: number;
+    /**
+     * Pixels per unit at the projection plane.
+     */
+    scale: number;
+    /**
+     * Canvas-space x offset.
+     */
+    centerX: number;
+    /**
+     * Canvas-space y offset.
+     */
+    centerY: number;
+};
+export type EmberState = "idle" | "working" | "error";
+export type EmberVisual = {
+    /**
+     * CSS custom-property name driving the warm stroke.
+     */
+    color: string;
+    /**
+     * Stroke width in device pixels.
+     */
+    lineWidth: number;
+    /**
+     * Radians per second of the slow Y rotation.
+     */
+    rotationSpeed: number;
+    /**
+     * Radians per millisecond of the candle-lean sway.
+     */
+    swaySpeed: number;
+    /**
+     * Horizontal lean amplitude at the flame tip.
+     */
+    swayAmount: number;
+    /**
+     * Amplitude of the scale shimmer (the coal breathing).
+     */
+    flicker: number;
+    /**
+     * Stroke shadow-blur in pixels (the warm halo around lines).
+     */
+    glow: number;
+};
+//# sourceMappingURL=emberAvatar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emberAvatar.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/emberAvatar.js"],"names":[],"mappings":"AA4CA;;;;;;GAMG;AACH,0CAHW,UAAU,GACR,WAAW,CAIvB;AAmBD;;;;;;;GAOG;AACH,6CAHW;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAmClE;AAED;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,2CANW,MAAM,mBACN,MAAM,cACN,MAAM,cACN,UAAU,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAuBpC;AAgBD,kEAMC;AAED;;;;;;;GAOG;AACH,wCAJW,WAAW,QACX,MAAM,GACJ,MAAM,CAIlB;AA/LD;;;;;;;;;;;;GAYG;AAEH;;GAEG;AAEH,2BAA2B;AAC3B,2BADW,UAAU,EAAE,CACkC;AAEzD,iDAAiD;AACjD,0BAA2B,GAAG,CAAC;AAC/B,6DAA6D;AAC7D,2BAA4B,CAAC,IAAI,CAAC;qBAgCrB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;;;;;UA6DvB,MAAM;;;;cACN,MAAM;;;;WACN,MAAM;;;;aACN,MAAM;;;;aACN,MAAM;;yBA1GP,MAAM,GAAG,SAAS,GAAG,OAAO;;;;;WAa3B,MAAM;;;;eACN,MAAM;;;;mBACN,MAAM;;;;eACN,MAAM;;;;gBACN,MAAM;;;;aACN,MAAM;;;;UACN,MAAM"}

package/dist/dashboard/modules/emberAvatar.js

@@ -0,0 +1,192 @@
+/**
+ * Dashboard module — Ember flame wireframe avatar (SPEC-189).
+ * Humble object: pure functions, no DOM, no global state. Holds the flame-shaped
+ * wireframe geometry and every per-state visual decision, so the
+ * requestAnimationFrame loop in emberAvatarRenderer.js carries no branching.
+ *
+ * Ember is a warm wireframe BRAISE, not the setup wizard's abstract icosahedron:
+ * a teardrop flame mesh (pointed tip, rounded base) stroked in amber, that leans
+ * and flickers like a live coal — livelier and warmer when spoken to.
+ *
+ * Visual DNA: "Agentic OS" — dark warm near-black + amber. See
+ * project_agentic_os_design_dna.md.
+ */
+
+/**
+ * @typedef {'idle' | 'working' | 'error'} EmberState
+ */
+
+/** @type {EmberState[]} */
+export const EMBER_STATES = ['idle', 'working', 'error'];
+
+/** Top of the flame (the tip) in model space. */
+export const FLAME_TIP_Y = 1.5;
+/** Bottom of the flame (the rounded base) in model space. */
+export const FLAME_BASE_Y = -1.15;
+
+/**
+ * @typedef {Object} EmberVisual
+ * @property {string} color CSS custom-property name driving the warm stroke.
+ * @property {number} lineWidth Stroke width in device pixels.
+ * @property {number} rotationSpeed Radians per second of the slow Y rotation.
+ * @property {number} swaySpeed Radians per millisecond of the candle-lean sway.
+ * @property {number} swayAmount Horizontal lean amplitude at the flame tip.
+ * @property {number} flicker Amplitude of the scale shimmer (the coal breathing).
+ * @property {number} glow Stroke shadow-blur in pixels (the warm halo around lines).
+ */
+
+/** @type {Record<EmberState, EmberVisual>} */
+const EMBER_VISUALS = {
+  idle: { color: '--accent', lineWidth: 1.5, rotationSpeed: 0.3, swaySpeed: 0.0011, swayAmount: 0.08, flicker: 0.025, glow: 10 },
+  working: { color: '--accent', lineWidth: 1.8, rotationSpeed: 0.6, swaySpeed: 0.0026, swayAmount: 0.22, flicker: 0.16, glow: 16 },
+  error: { color: '--danger', lineWidth: 2, rotationSpeed: 0.18, swaySpeed: 0.0018, swayAmount: 0.14, flicker: 0.22, glow: 12 },
+};
+
+/**
+ * Maps an ember state to its stroke/animation parameters. Keeps the renderer
+ * humble: every per-state decision lives here, not in the canvas loop.
+ *
+ * @param {EmberState} state
+ * @returns {EmberVisual}
+ */
+export function emberStateToVisual(state) {
+  return EMBER_VISUALS[state];
+}
+
+/**
+ * @typedef {[number, number, number]} Vertex
+ */
+
+/**
+ * The flame radius at a normalised height ringT ∈ [0,1] (0 near the tip, 1 at the
+ * base). A teardrop profile: pointed at the top, bulging in the lower third, a
+ * small rounded base — the silhouette that reads as a coal/flame rather than a
+ * ball.
+ *
+ * @param {number} ringT
+ * @returns {number}
+ */
+function flameRadius(ringT) {
+  return Math.sin(Math.PI * ringT ** 1.3) * 0.9 + 0.06;
+}
+
+/**
+ * Builds the flame wireframe as a surface of revolution: a single tip vertex
+ * (index 0) plus `rings` × `meridians` body vertices, joined by tip spokes,
+ * vertical meridian lines and horizontal ring loops. Pure and deterministic.
+ *
+ * @param {{ rings: number; meridians: number }} options
+ * @returns {{ vertices: Vertex[]; edges: Array<[number, number]> }}
+ */
+export function buildFlameWireframe(options) {
+  const { rings, meridians } = options;
+  /** @type {Vertex[]} */
+  const vertices = [[0, FLAME_TIP_Y, 0]];
+  const indexAt = (ring, meridian) => 1 + ring * meridians + meridian;
+
+  for (let ring = 0; ring < rings; ring += 1) {
+    const ringT = (ring + 1) / rings;
+    const y = FLAME_TIP_Y + (FLAME_BASE_Y - FLAME_TIP_Y) * ringT;
+    const radius = flameRadius(ringT);
+    for (let meridian = 0; meridian < meridians; meridian += 1) {
+      const angle = (meridian / meridians) * Math.PI * 2;
+      vertices.push([Math.cos(angle) * radius, y, Math.sin(angle) * radius]);
+    }
+  }
+
+  /** @type {Array<[number, number]>} */
+  const edges = [];
+  for (let meridian = 0; meridian < meridians; meridian += 1) {
+    edges.push([0, indexAt(0, meridian)]);
+  }
+  for (let ring = 0; ring < rings - 1; ring += 1) {
+    for (let meridian = 0; meridian < meridians; meridian += 1) {
+      edges.push([indexAt(ring, meridian), indexAt(ring + 1, meridian)]);
+    }
+  }
+  for (let ring = 0; ring < rings; ring += 1) {
+    for (let meridian = 0; meridian < meridians; meridian += 1) {
+      edges.push([indexAt(ring, meridian), indexAt(ring, (meridian + 1) % meridians)]);
+    }
+  }
+
+  return { vertices, edges };
+}
+
+/**
+ * @typedef {Object} Projection
+ * @property {number} tilt Fixed X-axis tilt in radians.
+ * @property {number} distance Camera distance for the perspective divide.
+ * @property {number} scale Pixels per unit at the projection plane.
+ * @property {number} centerX Canvas-space x offset.
+ * @property {number} centerY Canvas-space y offset.
+ */
+
+/**
+ * Projects a flame vertex to a 2D canvas point: rotates around Y, leans the
+ * upper body sideways by `swayOffset` scaled by height (a candle flame bends at
+ * the tip, not the base), applies the fixed tilt, then a perspective divide.
+ * Pure and deterministic.
+ *
+ * @param {Vertex} vertex
+ * @param {number} rotationRadians
+ * @param {number} swayOffset
+ * @param {Projection} projection
+ * @returns {{ x: number; y: number }}
+ */
+export function projectFlameVertex(vertex, rotationRadians, swayOffset, projection) {
+  const [x, y, z] = vertex;
+
+  const cosY = Math.cos(rotationRadians);
+  const sinY = Math.sin(rotationRadians);
+  const rotatedX = x * cosY + z * sinY;
+  const rotatedZ = -x * sinY + z * cosY;
+
+  const heightFactor = (y - FLAME_BASE_Y) / (FLAME_TIP_Y - FLAME_BASE_Y);
+  const leanedX = rotatedX + swayOffset * heightFactor;
+
+  const cosTilt = Math.cos(projection.tilt);
+  const sinTilt = Math.sin(projection.tilt);
+  const tiltedY = y * cosTilt - rotatedZ * sinTilt;
+  const tiltedZ = y * sinTilt + rotatedZ * cosTilt;
+
+  const perspective = projection.scale / (tiltedZ + projection.distance);
+  return {
+    x: projection.centerX + leanedX * perspective,
+    y: projection.centerY - tiltedY * perspective,
+  };
+}
+
+/**
+ * The breathing multiplier applied to the flame scale at a given time: a slow
+ * pulse plus a faster two-tone shimmer that reads as flicker. Pure — 1 at time 0,
+ * always within 1 ± flicker.
+ *
+ * @param {EmberVisual} visual
+ * @param {number} time Milliseconds since the loop started.
+ * @returns {number}
+ */
+const SHIMMER_SLOW_FREQUENCY = 0.013;
+const SHIMMER_FAST_FREQUENCY = 0.031;
+const SHIMMER_SLOW_WEIGHT = 0.6;
+const SHIMMER_FAST_WEIGHT = 0.4;
+
+export function emberRadiusFactor(visual, time) {
+  const shimmer =
+    visual.flicker *
+    (SHIMMER_SLOW_WEIGHT * Math.sin(time * SHIMMER_SLOW_FREQUENCY) +
+      SHIMMER_FAST_WEIGHT * Math.sin(time * SHIMMER_FAST_FREQUENCY));
+  return 1 + shimmer;
+}
+
+/**
+ * The horizontal lean of the flame tip at a given time. Pure — 0 at time 0,
+ * always within ± swayAmount.
+ *
+ * @param {EmberVisual} visual
+ * @param {number} time Milliseconds since the loop started.
+ * @returns {number}
+ */
+export function emberSwayOffset(visual, time) {
+  return visual.swayAmount * Math.sin(time * visual.swaySpeed);
+}

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * The structural slice of a canvas the renderer depends on. A real
+ * HTMLCanvasElement satisfies it; tests pass a lightweight fake without casts.
+ *
+ * @typedef {Object} EmberCanvas
+ * @property {number} width
+ * @property {number} height
+ * @property {(contextId: '2d') => CanvasRenderingContext2D | null} getContext
+ */
+/**
+ * Mounts the animated flame wireframe avatar on a 2D canvas and returns its
+ * controls. The page calls setState() on each stream event and destroy() before
+ * any teardown so the rAF loop never leaks.
+ *
+ * @param {Object} options
+ * @param {EmberCanvas} options.canvas
+ * @param {import('./emberAvatar.js').EmberState} [options.initialState]
+ * @param {(callback: FrameRequestCallback) => number} [options.requestFrame]
+ * @param {(handle: number) => void} [options.cancelFrame]
+ * @param {() => number} [options.now]
+ * @returns {{ setState: (state: import('./emberAvatar.js').EmberState) => void; destroy: () => void }}
+ */
+export function mountEmberAvatar(options: {
+    canvas: EmberCanvas;
+    initialState?: import("./emberAvatar.js").EmberState | undefined;
+    requestFrame?: ((callback: FrameRequestCallback) => number) | undefined;
+    cancelFrame?: ((handle: number) => void) | undefined;
+    now?: (() => number) | undefined;
+}): {
+    setState: (state: import("./emberAvatar.js").EmberState) => void;
+    destroy: () => void;
+};
+/**
+ * The structural slice of a canvas the renderer depends on. A real
+ * HTMLCanvasElement satisfies it; tests pass a lightweight fake without casts.
+ */
+export type EmberCanvas = {
+    width: number;
+    height: number;
+    getContext: (contextId: "2d") => CanvasRenderingContext2D | null;
+};
+//# sourceMappingURL=emberAvatarRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emberAvatarRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/emberAvatarRenderer.js"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;GAYG;AACH,0CAPG;IAA6B,MAAM,EAA3B,WAAW;IACqC,YAAY;IACP,YAAY,eAAtD,oBAAoB,KAAK,MAAM;IACP,WAAW,aAArC,MAAM,KAAK,IAAI;IACD,GAAG,UAApB,MAAM;CACpB,GAAU;IAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,kBAAkB,EAAE,UAAU,KAAK,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAmErG;;;;;;WAnFa,MAAM;YACN,MAAM;gBACN,CAAC,SAAS,EAAE,IAAI,KAAK,wBAAwB,GAAG,IAAI"}

package/dist/dashboard/modules/emberAvatarRenderer.js

@@ -0,0 +1,119 @@
+/**
+ * Dashboard module — Ember flame wireframe renderer (SPEC-189).
+ * Humble glue: a thin requestAnimationFrame loop that strokes the flame
+ * wireframe with a warm amber glow (shadowBlur), a slow Y rotation, a candle
+ * lean and a flicker breathing. It owns the rAF handle and its teardown, and
+ * delegates EVERY decision (geometry, colour, line width, rotation, sway,
+ * flicker, glow) to the pure emberAvatar.js module. Lifecycle-tested only
+ * (browser-only drawing), mirroring setupWizardAvatarRenderer.
+ *
+ * Visual DNA: "Agentic OS" — dark warm near-black + amber.
+ */
+
+import {
+  emberStateToVisual,
+  buildFlameWireframe,
+  projectFlameVertex,
+  emberRadiusFactor,
+  emberSwayOffset,
+} from './emberAvatar.js';
+
+/**
+ * @param {CanvasRenderingContext2D} context
+ * @param {string} colorToken
+ * @returns {string}
+ */
+function resolveColor(context, colorToken) {
+  const value = getComputedStyle(context.canvas).getPropertyValue(colorToken).trim();
+  return value === '' ? '#F4A93D' : value;
+}
+
+/**
+ * The structural slice of a canvas the renderer depends on. A real
+ * HTMLCanvasElement satisfies it; tests pass a lightweight fake without casts.
+ *
+ * @typedef {Object} EmberCanvas
+ * @property {number} width
+ * @property {number} height
+ * @property {(contextId: '2d') => CanvasRenderingContext2D | null} getContext
+ */
+
+/**
+ * Mounts the animated flame wireframe avatar on a 2D canvas and returns its
+ * controls. The page calls setState() on each stream event and destroy() before
+ * any teardown so the rAF loop never leaks.
+ *
+ * @param {Object} options
+ * @param {EmberCanvas} options.canvas
+ * @param {import('./emberAvatar.js').EmberState} [options.initialState]
+ * @param {(callback: FrameRequestCallback) => number} [options.requestFrame]
+ * @param {(handle: number) => void} [options.cancelFrame]
+ * @param {() => number} [options.now]
+ * @returns {{ setState: (state: import('./emberAvatar.js').EmberState) => void; destroy: () => void }}
+ */
+export function mountEmberAvatar(options) {
+  const requestFrame = options.requestFrame ?? globalThis.requestAnimationFrame.bind(globalThis);
+  const cancelFrame = options.cancelFrame ?? globalThis.cancelAnimationFrame.bind(globalThis);
+  const now = options.now ?? (() => performance.now());
+  const context = options.canvas.getContext('2d');
+  const startTime = now();
+  const flame = buildFlameWireframe({ rings: 7, meridians: 10 });
+
+  let currentState = options.initialState ?? 'idle';
+  /** @type {number | null} */
+  let frameHandle = null;
+
+  const projection = {
+    tilt: 0.12,
+    distance: 4,
+    scale: Math.min(options.canvas.width, options.canvas.height) * 0.55,
+    centerX: options.canvas.width / 2,
+    centerY: options.canvas.height / 2,
+  };
+
+  /**
+   * @param {number} time
+   */
+  function draw(time) {
+    if (context === null) {
+      return;
+    }
+    const elapsed = time - startTime;
+    const visual = emberStateToVisual(currentState);
+    const rotation = (elapsed * visual.rotationSpeed) / 1000;
+    const sway = emberSwayOffset(visual, elapsed);
+    const framedProjection = { ...projection, scale: projection.scale * emberRadiusFactor(visual, elapsed) };
+
+    context.clearRect(0, 0, options.canvas.width, options.canvas.height);
+    const color = resolveColor(context, visual.color);
+    context.lineWidth = visual.lineWidth;
+    context.lineCap = 'round';
+    context.strokeStyle = color;
+    context.shadowColor = color;
+    context.shadowBlur = visual.glow;
+    context.beginPath();
+    for (const [from, to] of flame.edges) {
+      const start = projectFlameVertex(flame.vertices[from], rotation, sway, framedProjection);
+      const end = projectFlameVertex(flame.vertices[to], rotation, sway, framedProjection);
+      context.moveTo(start.x, start.y);
+      context.lineTo(end.x, end.y);
+    }
+    context.stroke();
+
+    frameHandle = requestFrame(draw);
+  }
+
+  frameHandle = requestFrame(draw);
+
+  return {
+    setState: (state) => {
+      currentState = state;
+    },
+    destroy: () => {
+      if (frameHandle !== null) {
+        cancelFrame(frameHandle);
+        frameHandle = null;
+      }
+    },
+  };
+}

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

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