reviewflow 3.27.0 → 3.28.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.28.0](https://github.com/DGouron/review-flow/compare/reviewflow-v3.27.0...reviewflow-v3.28.0) (2026-05-28)
+
+
+### Added
+
+* **dashboard:** setup wizard HUD (SPEC-184 iteration A) ([#235](https://github.com/DGouron/review-flow/issues/235)) ([3cc3755](https://github.com/DGouron/review-flow/commit/3cc3755f019573f869a133c7cd1aae7e1b355ad4))
+* **dashboard:** spec-188 wizard wireframe avatar (phase 1) ([#240](https://github.com/DGouron/review-flow/issues/240)) ([98b0bfd](https://github.com/DGouron/review-flow/commit/98b0bfd5d1bf6227ddcb47595ae2d9ffec5f42cc))
+* **setup-wizard:** SPEC-183 setup wizard CLI orchestrator ([#233](https://github.com/DGouron/review-flow/issues/233)) ([4d9d0d3](https://github.com/DGouron/review-flow/commit/4d9d0d3be624a7c63d92d4e422f1e58515aeed4e))
+* **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))
+
 ## [3.27.0](https://github.com/DGouron/review-flow/compare/reviewflow-v3.26.0...reviewflow-v3.27.0) (2026-05-27)
 
 

package/dist/cli/parseCliArgs.d.ts

@@ -42,10 +42,19 @@ interface FollowupImportantsArgs {
     project: string | undefined;
     yes: boolean;
 }
+interface SetupArgs {
+    command: 'setup';
+    path: string | undefined;
+    json: boolean;
+    force: boolean;
+    ai: boolean;
+    yes: boolean;
+    showSecrets: boolean;
+}
 interface HelpArgs {
     command: 'help';
 }
-export type CliArgs = StartArgs | StopArgs | StatusArgs | LogsArgs | InitArgs | DiscoverArgs | ValidateArgs | FollowupImportantsArgs | VersionArgs | HelpArgs;
+export type CliArgs = StartArgs | StopArgs | StatusArgs | LogsArgs | InitArgs | DiscoverArgs | ValidateArgs | FollowupImportantsArgs | SetupArgs | VersionArgs | HelpArgs;
 export declare function parseCliArgs(args: string[]): CliArgs;
 export {};
 //# sourceMappingURL=parseCliArgs.d.ts.map

package/dist/cli/parseCliArgs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseCliArgs.d.ts","sourceRoot":"","sources":["../../src/cli/parseCliArgs.ts"],"names":[],"mappings":"AAAA,UAAU,SAAS;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,EAAE,OAAO,CAAC;CACd;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,sBAAsB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAwG9J,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA6BpD"}
+{"version":3,"file":"parseCliArgs.d.ts","sourceRoot":"","sources":["../../src/cli/parseCliArgs.ts"],"names":[],"mappings":"AAAA,UAAU,SAAS;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,EAAE,OAAO,CAAC;CACd;AAED,UAAU,SAAS;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,sBAAsB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AA4H1K,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA+BpD"}

package/dist/cli/parseCliArgs.js

@@ -1,4 +1,4 @@
-const KNOWN_COMMANDS = ['start', 'stop', 'status', 'logs', 'init', 'discover', 'validate', 'followup-importants'];
+const KNOWN_COMMANDS = ['start', 'stop', 'status', 'logs', 'init', 'discover', 'validate', 'followup-importants', 'setup'];
 function hasFlag(args, long, short) {
     return args.includes(long) || (short !== undefined && args.includes(short));
 }
@@ -86,6 +86,26 @@ function parseValidateArgs(args) {
         fix: hasFlag(args, '--fix'),
     };
 }
+function isPositionalPath(arg, index, args) {
+    if (arg.startsWith('-'))
+        return false;
+    if (arg === 'setup')
+        return false;
+    return index === 0 || args[index - 1] !== '--path';
+}
+function parseSetupArgs(args) {
+    const positional = args.find((arg, index) => isPositionalPath(arg, index, args));
+    const flagPath = getFlagValue(args, '--path');
+    return {
+        command: 'setup',
+        path: flagPath ?? positional,
+        json: hasFlag(args, '--json'),
+        force: hasFlag(args, '--force'),
+        ai: hasFlag(args, '--ai'),
+        yes: hasFlag(args, '--yes', '-y'),
+        showSecrets: hasFlag(args, '--show-secrets'),
+    };
+}
 export function parseCliArgs(args) {
     if (hasFlag(args, '--version', '-v')) {
         return { command: 'version' };
@@ -111,6 +131,8 @@ export function parseCliArgs(args) {
             return parseValidateArgs(args);
         case 'followup-importants':
             return parseFollowupImportantsArgs(args);
+        case 'setup':
+            return parseSetupArgs(args);
     }
 }
 //# sourceMappingURL=parseCliArgs.js.map

package/dist/cli/parseCliArgs.js.map

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

package/dist/dashboard/index.html

@@ -44,6 +44,10 @@
     </header>
 
     <div class="project-bar" role="region" aria-label="Project navigation">
+      <a href="/setup" class="setup-cta" id="setup-cta">
+        <span class="setup-cta-label">// SETUP REQUIRED</span>
+        <span class="setup-cta-action">Lancer le wizard</span>
+      </a>
       <button type="button" id="manage-projects-toggle" class="manage-projects-toggle" aria-expanded="false" aria-controls="manage-panel">
         <span class="manage-projects-toggle-label">// MANAGE PROJECTS</span>
         <i data-lucide="chevron-down" class="manage-projects-toggle-icon"></i>

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

@@ -0,0 +1,93 @@
+/**
+ * Folds the ordered event stream into the 10 step rows. Banner events are
+ * never folded into rows (they drive buildBannerModel instead).
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {StepRowViewModel[]}
+ */
+export function buildStepRowsModel(events: Array<Record<string, unknown>>): StepRowViewModel[];
+/**
+ * Extracts the banner events (instructions / warning / resume / done) in order.
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {BannerViewModel[]}
+ */
+export function buildBannerModel(events: Array<Record<string, unknown>>): BannerViewModel[];
+/**
+ * @param {StepRowStatus} status
+ * @returns {string}
+ */
+export function statusToDotClass(status: StepRowStatus): string;
+/**
+ * @param {StepRowStatus} status
+ * @returns {string}
+ */
+export function statusToLabel(status: StepRowStatus): string;
+/**
+ * @param {StepRowViewModel} row
+ * @returns {string}
+ */
+export function buildAriaAnnouncement(row: StepRowViewModel): string;
+/**
+ * @param {StepRowViewModel} row
+ * @returns {string}
+ */
+export function renderStepRow(row: StepRowViewModel): string;
+/**
+ * @param {BannerViewModel} banner
+ * @returns {string}
+ */
+export function renderBanner(banner: BannerViewModel): string;
+/**
+ * @typedef {'dependencies' | 'claude-login' | 'daemon' | 'secrets' | 'add-project'
+ *        | 'pipeline' | 'generate-files' | 'register-project' | 'validate' | 'next-actions'} StepId
+ */
+/**
+ * @typedef {'pending' | 'in_progress' | 'succeeded' | 'skipped' | 'blocked'
+ *        | 'warning' | 'awaiting_input'} StepRowStatus
+ */
+/**
+ * @typedef {Object} StepRowViewModel
+ * @property {StepId} id
+ * @property {string} label
+ * @property {StepRowStatus} status
+ * @property {string | null} message
+ * @property {string | null} remediation
+ * @property {number} position
+ * @property {number} total
+ */
+/**
+ * @typedef {Object} BannerViewModel
+ * @property {'instructions' | 'warning' | 'resume' | 'done'} kind
+ * @property {string | null} message
+ * @property {string[]} lines
+ * @property {string | null} resumeAt
+ * @property {number | null} position
+ * @property {number | null} total
+ */
+/**
+ * The 10 SPEC-183 step ids, in execution order. Kept in sync with
+ * entities/stepId/stepId.schema.ts (the backend source of truth).
+ * @type {StepId[]}
+ */
+export const STEP_ROW_IDS: StepId[];
+export type StepId = "dependencies" | "claude-login" | "daemon" | "secrets" | "add-project" | "pipeline" | "generate-files" | "register-project" | "validate" | "next-actions";
+export type StepRowStatus = "pending" | "in_progress" | "succeeded" | "skipped" | "blocked" | "warning" | "awaiting_input";
+export type StepRowViewModel = {
+    id: StepId;
+    label: string;
+    status: StepRowStatus;
+    message: string | null;
+    remediation: string | null;
+    position: number;
+    total: number;
+};
+export type BannerViewModel = {
+    kind: "instructions" | "warning" | "resume" | "done";
+    message: string | null;
+    lines: string[];
+    resumeAt: string | null;
+    position: number | null;
+    total: number | null;
+};
+//# sourceMappingURL=setupWizard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizard.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizard.js"],"names":[],"mappings":"AAsHA;;;;;;GAMG;AACH,2CAHW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5B,gBAAgB,EAAE,CAiC9B;AAED;;;;;GAKG;AACH,yCAHW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5B,eAAe,EAAE,CAoB7B;AAED;;;GAGG;AACH,yCAHW,aAAa,GACX,MAAM,CAKlB;AAED;;;GAGG;AACH,sCAHW,aAAa,GACX,MAAM,CAIlB;AAED;;;GAGG;AACH,2CAHW,gBAAgB,GACd,MAAM,CAKlB;AAED;;;GAGG;AACH,mCAHW,gBAAgB,GACd,MAAM,CA4BlB;AAED;;;GAGG;AACH,qCAHW,eAAe,GACb,MAAM,CAgBlB;AAxPD;;;GAGG;AAEH;;;GAGG;AAEH;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,2BAFU,MAAM,EAAE,CAahB;qBA9CW,cAAc,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GACvE,UAAU,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,UAAU,GAAG,cAAc;4BAI/E,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAChE,SAAS,GAAG,gBAAgB;;QAK1B,MAAM;WACN,MAAM;YACN,aAAa;aACb,MAAM,GAAG,IAAI;iBACb,MAAM,GAAG,IAAI;cACb,MAAM;WACN,MAAM;;;UAKN,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM;aAC9C,MAAM,GAAG,IAAI;WACb,MAAM,EAAE;cACR,MAAM,GAAG,IAAI;cACb,MAAM,GAAG,IAAI;WACb,MAAM,GAAG,IAAI"}

package/dist/dashboard/modules/setupWizard.js

@@ -0,0 +1,261 @@
+/**
+ * Dashboard module — Setup Wizard HUD view model (SPEC-184, Iteration A).
+ * Humble object: pure functions, no global state, no direct DOM access.
+ * Maps the SPEC-183 wizard stream events into the 10-step boot sequence rows
+ * and the banner model. Animation choreography lives in styles.css; the stream
+ * client wiring lives in setupWizardStream.js.
+ *
+ * Visual DNA: "Agentic OS" — see project_agentic_os_design_dna.md.
+ */
+
+import { escapeHtml } from './html.js';
+
+/**
+ * @typedef {'dependencies' | 'claude-login' | 'daemon' | 'secrets' | 'add-project'
+ *        | 'pipeline' | 'generate-files' | 'register-project' | 'validate' | 'next-actions'} StepId
+ */
+
+/**
+ * @typedef {'pending' | 'in_progress' | 'succeeded' | 'skipped' | 'blocked'
+ *        | 'warning' | 'awaiting_input'} StepRowStatus
+ */
+
+/**
+ * @typedef {Object} StepRowViewModel
+ * @property {StepId} id
+ * @property {string} label
+ * @property {StepRowStatus} status
+ * @property {string | null} message
+ * @property {string | null} remediation
+ * @property {number} position
+ * @property {number} total
+ */
+
+/**
+ * @typedef {Object} BannerViewModel
+ * @property {'instructions' | 'warning' | 'resume' | 'done'} kind
+ * @property {string | null} message
+ * @property {string[]} lines
+ * @property {string | null} resumeAt
+ * @property {number | null} position
+ * @property {number | null} total
+ */
+
+/**
+ * The 10 SPEC-183 step ids, in execution order. Kept in sync with
+ * entities/stepId/stepId.schema.ts (the backend source of truth).
+ * @type {StepId[]}
+ */
+export const STEP_ROW_IDS = [
+  'dependencies',
+  'claude-login',
+  'daemon',
+  'secrets',
+  'add-project',
+  'pipeline',
+  'generate-files',
+  'register-project',
+  'validate',
+  'next-actions',
+];
+
+/** @type {Record<StepId, string>} */
+const STEP_LABELS = {
+  dependencies: 'Dependencies',
+  'claude-login': 'Claude login',
+  daemon: 'Daemon',
+  secrets: 'Secrets',
+  'add-project': 'Add project',
+  pipeline: 'Pipeline',
+  'generate-files': 'Generate files',
+  'register-project': 'Register project',
+  validate: 'Validate',
+  'next-actions': 'Next actions',
+};
+
+const BANNER_STEPS = new Set(['instructions', 'warning', 'resume', 'done']);
+
+/**
+ * @param {string} step
+ * @returns {boolean}
+ */
+function isStepRowId(step) {
+  return STEP_ROW_IDS.includes(step);
+}
+
+const ROW_STATUSES = new Set([
+  'pending',
+  'in_progress',
+  'succeeded',
+  'skipped',
+  'blocked',
+  'warning',
+  'awaiting_input',
+]);
+
+/**
+ * @param {Record<string, unknown>} event
+ * @returns {StepRowStatus}
+ */
+function statusFromEvent(event) {
+  const status = event.status;
+  if (typeof status === 'string' && ROW_STATUSES.has(status)) {
+    return status;
+  }
+  return 'pending';
+}
+
+/**
+ * @param {Record<string, unknown>} event
+ * @returns {string | null}
+ */
+function messageFromEvent(event) {
+  if (event.status === 'awaiting_input') {
+    return typeof event.prompt === 'string' ? event.prompt : null;
+  }
+  return typeof event.message === 'string' ? event.message : null;
+}
+
+/**
+ * Folds the ordered event stream into the 10 step rows. Banner events are
+ * never folded into rows (they drive buildBannerModel instead).
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {StepRowViewModel[]}
+ */
+export function buildStepRowsModel(events) {
+  const total = STEP_ROW_IDS.length;
+  /** @type {StepRowViewModel[]} */
+  const rows = STEP_ROW_IDS.map((id, index) => ({
+    id,
+    label: STEP_LABELS[id],
+    status: 'pending',
+    message: null,
+    remediation: null,
+    position: index + 1,
+    total,
+  }));
+
+  const indexById = new Map(rows.map((row, index) => [row.id, index]));
+
+  for (const event of events) {
+    const step = typeof event.step === 'string' ? event.step : '';
+    if (!isStepRowId(step)) {
+      continue;
+    }
+    const rowIndex = indexById.get(step);
+    if (rowIndex === undefined) {
+      continue;
+    }
+    const row = rows[rowIndex];
+    row.status = statusFromEvent(event);
+    row.message = messageFromEvent(event);
+    row.remediation = typeof event.remediation === 'string' ? event.remediation : null;
+  }
+
+  return rows;
+}
+
+/**
+ * Extracts the banner events (instructions / warning / resume / done) in order.
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {BannerViewModel[]}
+ */
+export function buildBannerModel(events) {
+  /** @type {BannerViewModel[]} */
+  const banners = [];
+  for (const event of events) {
+    const step = typeof event.step === 'string' ? event.step : '';
+    if (!BANNER_STEPS.has(step)) {
+      continue;
+    }
+    banners.push({
+      kind: step,
+      message: typeof event.message === 'string' ? event.message : null,
+      lines: Array.isArray(event.lines) ? event.lines.map((line) => String(line)) : [],
+      resumeAt: typeof event.resumeAt === 'string' ? event.resumeAt : null,
+      position: typeof event.position === 'number' ? event.position : null,
+      total: typeof event.total === 'number' ? event.total : null,
+    });
+  }
+  return banners;
+}
+
+/**
+ * @param {StepRowStatus} status
+ * @returns {string}
+ */
+export function statusToDotClass(status) {
+  const suffix = status.replace(/_/g, '-');
+  return `setup-step-dot setup-step-dot--${suffix}`;
+}
+
+/**
+ * @param {StepRowStatus} status
+ * @returns {string}
+ */
+export function statusToLabel(status) {
+  return status.replace(/_/g, ' ').toUpperCase();
+}
+
+/**
+ * @param {StepRowViewModel} row
+ * @returns {string}
+ */
+export function buildAriaAnnouncement(row) {
+  const statusLabel = statusToLabel(row.status).toLowerCase();
+  return `Step ${row.position} of ${row.total}, ${statusLabel}: ${row.label}`;
+}
+
+/**
+ * @param {StepRowViewModel} row
+ * @returns {string}
+ */
+export function renderStepRow(row) {
+  const dotClass = statusToDotClass(row.status);
+  const labelPrefix = `// ${row.label.toUpperCase()}`;
+  const messageMarkup = row.message
+    ? `<div class="setup-step-message">${escapeHtml(row.message)}</div>`
+    : '';
+  const remediationMarkup = row.remediation
+    ? `<div class="setup-step-remediation">${escapeHtml(row.remediation)}</div>`
+    : '';
+  return `
+    <li class="setup-step setup-step--${row.status.replace(/_/g, '-')}" data-step-id="${escapeHtml(row.id)}" data-status="${escapeHtml(row.status)}">
+      <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>
+      <span class="${dotClass}" aria-hidden="true"></span>
+      <div class="setup-step-body">
+        <div class="setup-step-header">
+          <span class="setup-step-label">${escapeHtml(labelPrefix)}</span>
+          <span class="setup-step-status" data-status="${escapeHtml(row.status)}">${escapeHtml(statusToLabel(row.status))}</span>
+        </div>
+        ${messageMarkup}
+        ${remediationMarkup}
+      </div>
+    </li>
+  `;
+}
+
+/**
+ * @param {BannerViewModel} banner
+ * @returns {string}
+ */
+export function renderBanner(banner) {
+  if (banner.kind === 'resume') {
+    const position = banner.position ?? 0;
+    const total = banner.total ?? STEP_ROW_IDS.length;
+    return `<div class="setup-banner setup-banner--resume" role="status">// REPRISE — Étape ${position}/${total}</div>`;
+  }
+  if (banner.kind === 'done') {
+    return `<div class="setup-banner setup-banner--done" role="status">// SETUP TERMINÉ</div>`;
+  }
+  if (banner.kind === 'instructions') {
+    const items = banner.lines.map((line) => `<li>${escapeHtml(line)}</li>`).join('');
+    return `<div class="setup-banner setup-banner--instructions" role="status"><div class="setup-banner-title">// INSTRUCTIONS</div><ul>${items}</ul></div>`;
+  }
+  return `<div class="setup-banner setup-banner--warning" role="status"><span class="setup-banner-title">// ATTENTION</span> ${escapeHtml(banner.message)}</div>`;
+}

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

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

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

@@ -0,0 +1,126 @@
+/**
+ * Folds the ordered event list to the avatar state of the latest relevant event.
+ * Nothing relevant yet → idle.
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {AvatarState}
+ */
+export function avatarStateFromEvents(events: Array<Record<string, unknown>>): AvatarState;
+/**
+ * Decides whether the animated wireframe avatar applies. Phase 1 renders on a
+ * plain 2D canvas (no WebGL), so the capability gate is "can we get a 2D
+ * context"; reduced motion always routes to the static 2D fallback.
+ *
+ * @param {{ canvasSupported: boolean; reducedMotion: boolean }} capabilities
+ * @returns {boolean}
+ */
+export function shouldUseAvatar(capabilities: {
+    canvasSupported: boolean;
+    reducedMotion: boolean;
+}): boolean;
+/**
+ * Maps an avatar state to its stroke/animation parameters. Keeps the renderer
+ * humble: every per-state visual decision lives here, not in the canvas loop.
+ *
+ * @param {AvatarState} state
+ * @returns {AvatarVisual}
+ */
+export function avatarStateToVisual(state: AvatarState): AvatarVisual;
+/**
+ * @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 3D vertex to a 2D canvas point: rotates around Y by
+ * `rotationRadians`, applies the fixed X tilt, then a trivial perspective
+ * divide and scale. Pure and deterministic.
+ *
+ * @param {Vertex} vertex
+ * @param {number} rotationRadians
+ * @param {Projection} projection
+ * @returns {{ x: number; y: number }}
+ */
+export function projectVertex(vertex: Vertex, rotationRadians: number, projection: Projection): {
+    x: number;
+    y: number;
+};
+/**
+ * Dashboard module — Setup Wizard wireframe avatar (SPEC-188, Phase 1).
+ * Humble object: pure functions, no global state, no direct DOM access.
+ * Holds ALL the avatar logic: maps the SPEC-183/187 wizard stream into one of
+ * six avatar states, decides whether the avatar or the 2D fallback applies, and
+ * projects the procedural wireframe geometry. The requestAnimationFrame canvas
+ * loop lives in setupWizardAvatarRenderer.js and delegates every decision here.
+ *
+ * Visual DNA: "Agentic OS" — see project_agentic_os_design_dna.md.
+ */
+/**
+ * @typedef {'idle' | 'working' | 'success' | 'error' | 'listening' | 'celebrating'} AvatarState
+ */
+/**
+ * The six avatar states a wireframe core can be in, in narrative order.
+ * @type {AvatarState[]}
+ */
+export const AVATAR_STATES: AvatarState[];
+/**
+ * @typedef {[number, number, number]} Vertex
+ */
+/**
+ * The 12 vertices of a unit icosahedron (golden-ratio rectangles). A fixed,
+ * abstract wireframe core — the six avatar states reuse this same geometry and
+ * differ only by colour/line-width/rotation-speed/pulse.
+ * @type {Vertex[]}
+ */
+export const WIREFRAME_VERTICES: Vertex[];
+/**
+ * The 30 edges of the icosahedron, as index pairs into WIREFRAME_VERTICES.
+ * @type {Array<[number, number]>}
+ */
+export const WIREFRAME_EDGES: Array<[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 AvatarState = "idle" | "working" | "success" | "error" | "listening" | "celebrating";
+export type AvatarVisual = {
+    /**
+     * CSS custom-property name driving the stroke colour.
+     */
+    color: string;
+    /**
+     * Stroke width in device pixels.
+     */
+    lineWidth: number;
+    /**
+     * Radians per second of the Y rotation.
+     */
+    rotationSpeed: number;
+    /**
+     * Amplitude of the radius/opacity breathing envelope.
+     */
+    pulse: number;
+};
+export type Vertex = [number, number, number];
+//# sourceMappingURL=setupWizardAvatar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizardAvatar.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizardAvatar.js"],"names":[],"mappings":"AAyDA;;;;;;GAMG;AACH,8CAHW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5B,WAAW,CAUvB;AAED;;;;;;;GAOG;AACH,8CAHW;IAAE,eAAe,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,GAClD,OAAO,CAInB;AAoBD;;;;;;GAMG;AACH,2CAHW,WAAW,GACT,YAAY,CAIxB;AAkED;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,sCALW,MAAM,mBACN,MAAM,cACN,UAAU,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBpC;AAxND;;;;;;;;;GASG;AAEH;;GAEG;AAEH;;;GAGG;AACH,4BAFU,WAAW,EAAE,CAE0E;AAkGjG;;GAEG;AAEH;;;;;GAKG;AACH,iCAFU,MAAM,EAAE,CAehB;AAEF;;;GAGG;AACH,8BAFU,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiC/B;;;;;UAIY,MAAM;;;;cACN,MAAM;;;;WACN,MAAM;;;;aACN,MAAM;;;;aACN,MAAM;;0BA7KP,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa;;;;;WA4ErE,MAAM;;;;eACN,MAAM;;;;mBACN,MAAM;;;;WACN,MAAM;;qBA2BP,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC"}