reviewflow 3.29.0 → 3.30.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ 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)
 
 

package/dist/dashboard/index.html

@@ -101,24 +101,24 @@
 
     <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="worktree-section" aria-label="Worktree pool"></section>
-
         <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="72" height="72" aria-hidden="true"></canvas>
+            <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>
@@ -133,6 +133,8 @@
             />
           </form>
         </section>
+
+        <section id="worktree-section" aria-label="Worktree pool"></section>
       </aside>
 
       <main class="dashboard-main">
@@ -449,7 +451,7 @@
       renderHeaderCapacityBadgeHtml,
     } from './modules/headerCapacityBadge.js';
     import { connectEmberStream, shouldSendQuestion } from './modules/emberChat.js';
-    import { mountSetupWizardAvatar } from './modules/setupWizardAvatarRenderer.js';
+    import { mountEmberAvatar } from './modules/emberAvatarRenderer.js';
 
     const API_URL = window.location.origin;
     const WS_URL = `ws://${window.location.host}/ws`;
@@ -3868,9 +3870,10 @@
       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 = mountSetupWizardAvatar({ canvas, initialState: 'idle' });
+      const avatar = mountEmberAvatar({ canvas, initialState: 'idle' });
 
       const ask = async () => {
         const question = input.value;
@@ -3878,6 +3881,7 @@
           input.focus();
           return;
         }
+        panel?.classList.add('ember-chat-panel--active');
         answer.textContent = '';
         status.textContent = '';
         retry.hidden = true;

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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"}

package/dist/dashboard/styles.css

@@ -5442,6 +5442,20 @@ body.overview-tab-active .dashboard-main > *:not(#overview-section) {
 
 /* SPEC-179 — Settings modal + sidebar Settings button (Agentic OS DNA) */
 
+.sidebar-tool-buttons {
+  display: flex;
+  gap: 0.4rem;
+}
+
+.sidebar-tool-buttons .sidebar-settings-button {
+  flex: 1 1 0;
+  min-width: 0;
+  margin-top: 0;
+  padding: 0.45rem 0.3rem;
+  justify-content: center;
+  font-size: 0.68rem;
+}
+
 .sidebar-settings-button {
   display: flex;
   align-items: center;
@@ -6388,20 +6402,47 @@ input:focus-visible,
 
 .ember-chat-panel__header {
   display: flex;
+  flex-direction: column;
   align-items: center;
-  justify-content: space-between;
-  margin-bottom: 8px;
+  gap: 10px;
+  margin-bottom: 12px;
 }
 
 .ember-chat-panel__prefix {
+  align-self: flex-start;
   color: var(--accent);
   font-size: 12px;
   letter-spacing: 0.04em;
 }
 
 .ember-chat-panel__avatar {
-  width: 48px;
-  height: 48px;
+  width: 260px;
+  height: 260px;
+  transition: width 0.45s ease, height 0.45s ease;
+}
+
+.ember-chat-panel--active .ember-chat-panel__header {
+  flex-direction: row;
+  align-items: flex-start;
+  justify-content: space-between;
+}
+
+.ember-chat-panel--active .ember-chat-panel__avatar {
+  width: 104px;
+  height: 104px;
+}
+
+.ember-chat-panel:not(.ember-chat-panel--active) .ember-chat-panel__answer,
+.ember-chat-panel:not(.ember-chat-panel--active) .ember-chat-panel__status,
+.ember-chat-panel:not(.ember-chat-panel--active) .ember-chat-panel__retry {
+  display: none;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ember-chat-panel__avatar {
+    transition: none;
+    animation: none;
+  }
 }
 
 .ember-chat-panel__answer {

package/dist/tests/units/dashboard/modules/emberAvatar.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=emberAvatar.test.d.ts.map

package/dist/tests/units/dashboard/modules/emberAvatar.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emberAvatar.test.d.ts","sourceRoot":"","sources":["../../../../../src/tests/units/dashboard/modules/emberAvatar.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/dashboard/modules/emberAvatar.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { EMBER_STATES, emberStateToVisual, buildFlameWireframe, projectFlameVertex, emberRadiusFactor, emberSwayOffset, FLAME_TIP_Y, FLAME_BASE_Y, } from '../../../../dashboard/modules/emberAvatar.js';
+describe('EMBER_STATES', () => {
+    it('exposes exactly the three chat-driven states in narrative order', () => {
+        expect(EMBER_STATES).toEqual(['idle', 'working', 'error']);
+    });
+});
+describe('emberStateToVisual', () => {
+    it('makes the working state lean, flicker and glow harder than idle', () => {
+        const idle = emberStateToVisual('idle');
+        const working = emberStateToVisual('working');
+        expect(working.swayAmount).toBeGreaterThan(idle.swayAmount);
+        expect(working.flicker).toBeGreaterThan(idle.flicker);
+        expect(working.glow).toBeGreaterThan(idle.glow);
+    });
+    it('paints the error state with a distinct colour token from idle', () => {
+        expect(emberStateToVisual('error').color).not.toBe(emberStateToVisual('idle').color);
+    });
+});
+describe('buildFlameWireframe', () => {
+    it('has one tip vertex plus a rings × meridians body', () => {
+        const { vertices } = buildFlameWireframe({ rings: 6, meridians: 8 });
+        expect(vertices).toHaveLength(1 + 6 * 8);
+        expect(vertices[0]).toEqual([0, FLAME_TIP_Y, 0]);
+        for (const vertex of vertices) {
+            expect(vertex).toHaveLength(3);
+        }
+    });
+    it('connects the tip, the meridians and the ring loops with edges', () => {
+        const { edges } = buildFlameWireframe({ rings: 6, meridians: 8 });
+        const tipSpokes = 8;
+        const verticalLines = (6 - 1) * 8;
+        const ringLoops = 6 * 8;
+        expect(edges).toHaveLength(tipSpokes + verticalLines + ringLoops);
+    });
+});
+describe('projectFlameVertex', () => {
+    const projection = { tilt: 0.12, distance: 4, scale: 50, centerX: 120, centerY: 120 };
+    it('is deterministic for the same inputs', () => {
+        const vertex = [0.5, 0.2, -0.3];
+        expect(projectFlameVertex(vertex, 1.1, 0.2, projection)).toEqual(projectFlameVertex(vertex, 1.1, 0.2, projection));
+    });
+    it('leans the tip far more than the base for a positive sway', () => {
+        const tip = [0, FLAME_TIP_Y, 0];
+        const base = [0, FLAME_BASE_Y, 0];
+        const tipShift = projectFlameVertex(tip, 0, 0.4, projection).x - projectFlameVertex(tip, 0, 0, projection).x;
+        const baseShift = projectFlameVertex(base, 0, 0.4, projection).x - projectFlameVertex(base, 0, 0, projection).x;
+        expect(tipShift).toBeGreaterThan(baseShift);
+        expect(baseShift).toBeCloseTo(0, 6);
+    });
+});
+describe('emberRadiusFactor', () => {
+    it('returns the neutral factor of 1 at time 0', () => {
+        expect(emberRadiusFactor(emberStateToVisual('idle'), 0)).toBeCloseTo(1, 5);
+    });
+    it('stays within the flicker envelope', () => {
+        const visual = emberStateToVisual('working');
+        for (const time of [120, 900, 1750, 5000]) {
+            const factor = emberRadiusFactor(visual, time);
+            expect(factor).toBeGreaterThanOrEqual(1 - visual.flicker - 1e-6);
+            expect(factor).toBeLessThanOrEqual(1 + visual.flicker + 1e-6);
+        }
+    });
+});
+describe('emberSwayOffset', () => {
+    it('is zero at time 0 and bounded by the sway amplitude', () => {
+        const visual = emberStateToVisual('working');
+        expect(emberSwayOffset(visual, 0)).toBeCloseTo(0, 6);
+        for (const time of [200, 1234, 4321]) {
+            expect(Math.abs(emberSwayOffset(visual, time))).toBeLessThanOrEqual(visual.swayAmount + 1e-6);
+        }
+    });
+});
+//# sourceMappingURL=emberAvatar.test.js.map

package/dist/tests/units/dashboard/modules/emberAvatar.test.js.map

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

package/dist/tests/units/dashboard/modules/emberAvatarRenderer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=emberAvatarRenderer.test.d.ts.map

package/dist/tests/units/dashboard/modules/emberAvatarRenderer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emberAvatarRenderer.test.d.ts","sourceRoot":"","sources":["../../../../../src/tests/units/dashboard/modules/emberAvatarRenderer.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/dashboard/modules/emberAvatarRenderer.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { mountEmberAvatar } from '../../../../dashboard/modules/emberAvatarRenderer.js';
+function fakeCanvas() {
+    return { width: 240, height: 240, getContext: () => null };
+}
+describe('mountEmberAvatar (lifecycle glue)', () => {
+    it('schedules an animation frame on mount', () => {
+        const requested = [];
+        mountEmberAvatar({
+            canvas: fakeCanvas(),
+            requestFrame: (callback) => {
+                requested.push(callback);
+                return requested.length;
+            },
+            cancelFrame: () => undefined,
+            now: () => 0,
+        });
+        expect(requested).toHaveLength(1);
+    });
+    it('cancels the scheduled frame on destroy so the loop cannot leak', () => {
+        const cancelled = [];
+        const controls = mountEmberAvatar({
+            canvas: fakeCanvas(),
+            requestFrame: () => 42,
+            cancelFrame: (handle) => {
+                cancelled.push(handle);
+            },
+            now: () => 0,
+        });
+        controls.destroy();
+        expect(cancelled).toEqual([42]);
+    });
+    it('exposes setState and destroy controls', () => {
+        const controls = mountEmberAvatar({
+            canvas: fakeCanvas(),
+            requestFrame: () => 1,
+            cancelFrame: () => undefined,
+            now: () => 0,
+        });
+        expect(typeof controls.setState).toBe('function');
+        expect(typeof controls.destroy).toBe('function');
+    });
+});
+//# sourceMappingURL=emberAvatarRenderer.test.js.map

package/dist/tests/units/dashboard/modules/emberAvatarRenderer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emberAvatarRenderer.test.js","sourceRoot":"","sources":["../../../../../src/tests/units/dashboard/modules/emberAvatarRenderer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAQ9E,SAAS,UAAU;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,SAAS,GAAkC,EAAE,CAAC;QAEpD,gBAAgB,CAAC;YACf,MAAM,EAAE,UAAU,EAAE;YACpB,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACzB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzB,OAAO,SAAS,CAAC,MAAM,CAAC;YAC1B,CAAC;YACD,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;YAC5B,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,MAAM,QAAQ,GAAG,gBAAgB,CAAC;YAChC,MAAM,EAAE,UAAU,EAAE;YACpB,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE;YACtB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE;gBACtB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;YACD,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;SACb,CAAC,CAAC;QAEH,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEnB,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC;YAChC,MAAM,EAAE,UAAU,EAAE;YACpB,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;YACrB,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;YAC5B,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reviewflow",
-  "version": "3.29.0",
+  "version": "3.30.0",
   "description": "AI-powered code review automation for GitLab/GitHub using Claude Code",
   "type": "module",
   "main": "dist/main/server.js",