reviewflow 3.27.0 → 3.28.0

package/dist/dashboard/modules/setupWizardForms.js

@@ -0,0 +1,273 @@
+/**
+ * Dashboard module — Setup Wizard interactive forms (SPEC-184, Iteration B2).
+ * Humble object: pure functions, no global state, no direct DOM access.
+ * Turns a self-describing `awaiting_input` event (kind/options/defaultValue)
+ * into the matching form markup and into the exact `POST /api/setup/input`
+ * body the SPEC-187 backend parses. The DOM wiring (render/submit/clear) lives
+ * in setupWizardStream.js; the styling lives in styles.css.
+ *
+ * Visual DNA: "Agentic OS" — see project_agentic_os_design_dna.md.
+ */
+
+import { escapeHtml } from './html.js';
+
+/**
+ * @typedef {'text' | 'confirm' | 'choice' | 'multiSelect'} FormKind
+ */
+
+/**
+ * @typedef {Object} FormOption
+ * @property {string} label
+ * @property {string} value
+ */
+
+/**
+ * @typedef {Object} FormModel
+ * @property {string} stepId
+ * @property {FormKind} kind
+ * @property {string} prompt
+ * @property {FormOption[]} options
+ * @property {string | null} defaultValue
+ */
+
+/**
+ * @typedef {Object} TextPayload
+ * @property {string} runId
+ * @property {'text'} kind
+ * @property {string} value
+ */
+
+/**
+ * @typedef {Object} ConfirmPayload
+ * @property {string} runId
+ * @property {'confirm'} kind
+ * @property {boolean} value
+ */
+
+/**
+ * @typedef {Object} ChoicePayload
+ * @property {string} runId
+ * @property {'choice'} kind
+ * @property {string} value
+ */
+
+/**
+ * @typedef {Object} MultiSelectPayload
+ * @property {string} runId
+ * @property {'multiSelect'} kind
+ * @property {string[]} value
+ */
+
+/**
+ * @typedef {TextPayload | ConfirmPayload | ChoicePayload | MultiSelectPayload} InputPayload
+ */
+
+/**
+ * @typedef {{ ok: true, body: InputPayload } | { ok: false, error: string }} PayloadResult
+ */
+
+const FORM_KINDS = new Set(['text', 'confirm', 'choice', 'multiSelect']);
+
+/**
+ * @param {unknown} value
+ * @returns {value is FormOption}
+ */
+function isFormOption(value) {
+  return (
+    value !== null &&
+    typeof value === 'object' &&
+    typeof (/** @type {Record<string, unknown>} */ (value).value) === 'string' &&
+    typeof (/** @type {Record<string, unknown>} */ (value).label) === 'string'
+  );
+}
+
+/**
+ * @param {unknown} options
+ * @returns {FormOption[]}
+ */
+function normalizeOptions(options) {
+  if (!Array.isArray(options)) {
+    return [];
+  }
+  return options.filter(isFormOption);
+}
+
+/**
+ * Maps an awaiting_input event into the form view model, or null when the event
+ * is absent or not an awaiting_input event.
+ *
+ * @param {Record<string, unknown> | null} event
+ * @returns {FormModel | null}
+ */
+export function buildFormModel(event) {
+  if (event === null || typeof event !== 'object') {
+    return null;
+  }
+  if (event.status !== 'awaiting_input') {
+    return null;
+  }
+  const kind = event.kind;
+  if (typeof kind !== 'string' || !FORM_KINDS.has(kind)) {
+    return null;
+  }
+  return {
+    stepId: typeof event.step === 'string' ? event.step : '',
+    kind: /** @type {FormKind} */ (kind),
+    prompt: typeof event.prompt === 'string' ? event.prompt : '',
+    options: normalizeOptions(event.options),
+    defaultValue: typeof event.defaultValue === 'string' ? event.defaultValue : null,
+  };
+}
+
+/**
+ * @returns {string}
+ */
+function renderCornerBrackets() {
+  return `
+      <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>`;
+}
+
+/**
+ * @param {FormModel} model
+ * @returns {string}
+ */
+function renderTextControl(model) {
+  const placeholder = model.defaultValue ? ` placeholder="${escapeHtml(model.defaultValue)}"` : '';
+  return `
+      <input class="setup-form-input" type="text" name="value" autocomplete="off"${placeholder} aria-label="${escapeHtml(model.prompt)}">
+      <button class="setup-form-submit btn btn-primary" type="submit">Valider</button>`;
+}
+
+/**
+ * @returns {string}
+ */
+function renderConfirmControl() {
+  return `
+      <button class="setup-form-confirm btn btn-primary" type="button" data-confirm-value="true">Confirmer</button>
+      <button class="setup-form-cancel btn btn-secondary" type="button" data-confirm-value="false">Annuler</button>`;
+}
+
+/**
+ * @param {FormModel} model
+ * @returns {string}
+ */
+function renderChoiceControl(model) {
+  const items = model.options
+    .map(
+      (option) =>
+        `<button class="setup-form-choice btn btn-secondary" type="button" data-choice-value="${escapeHtml(option.value)}">${escapeHtml(option.label)}</button>`,
+    )
+    .join('');
+  return `<div class="setup-form-choices" role="group">${items}</div>`;
+}
+
+/**
+ * @param {FormModel} model
+ * @returns {string}
+ */
+function renderMultiSelectControl(model) {
+  const items = model.options
+    .map(
+      (option) =>
+        `<label class="setup-form-option"><input class="setup-form-checkbox" type="checkbox" name="value" value="${escapeHtml(option.value)}"> ${escapeHtml(option.label)}</label>`,
+    )
+    .join('');
+  return `
+      <div class="setup-form-checkboxes" role="group">${items}</div>
+      <button class="setup-form-submit btn btn-primary" type="submit">Valider</button>`;
+}
+
+/**
+ * @param {FormModel} model
+ * @returns {string}
+ */
+function renderControl(model) {
+  if (model.kind === 'text') {
+    return renderTextControl(model);
+  }
+  if (model.kind === 'confirm') {
+    return renderConfirmControl();
+  }
+  if (model.kind === 'choice') {
+    return renderChoiceControl(model);
+  }
+  return renderMultiSelectControl(model);
+}
+
+/**
+ * Renders the form markup for the active awaiting_input step. The DOM wiring
+ * binds submit/click handlers afterwards; the markup here is keyboard-reachable
+ * through native inputs and buttons in DOM order.
+ *
+ * @param {FormModel | null} model
+ * @returns {string}
+ */
+export function renderForm(model) {
+  if (model === null) {
+    return '';
+  }
+  const labelPrefix = `// ${model.prompt.toUpperCase()}`;
+  return `
+    <form class="setup-form" data-step-id="${escapeHtml(model.stepId)}" data-kind="${escapeHtml(model.kind)}">
+      ${renderCornerBrackets()}
+      <div class="setup-form-label">${escapeHtml(labelPrefix)}</div>
+      <div class="setup-form-controls">${renderControl(model)}</div>
+      <div class="setup-form-error" role="alert" hidden></div>
+    </form>
+  `;
+}
+
+/**
+ * @param {FormOption[]} options
+ * @param {string} value
+ * @returns {boolean}
+ */
+function isOffered(options, value) {
+  return options.some((option) => option.value === value);
+}
+
+/**
+ * Builds the exact `{ runId, kind, value }` body the SPEC-187 endpoint accepts,
+ * coercing the raw form value to the type the kind requires and rejecting any
+ * choice/multiSelect value that was not offered (so junk is never posted).
+ *
+ * @param {FormKind} kind
+ * @param {string} runId
+ * @param {unknown} rawValue
+ * @param {FormOption[]} options
+ * @returns {PayloadResult}
+ */
+export function buildInputPayload(kind, runId, rawValue, options) {
+  if (kind === 'text') {
+    if (typeof rawValue !== 'string') {
+      return { ok: false, error: 'La valeur du champ texte est invalide' };
+    }
+    return { ok: true, body: { runId, kind, value: rawValue } };
+  }
+  if (kind === 'confirm') {
+    if (typeof rawValue !== 'boolean') {
+      return { ok: false, error: 'La confirmation doit être un booléen' };
+    }
+    return { ok: true, body: { runId, kind, value: rawValue } };
+  }
+  if (kind === 'choice') {
+    if (typeof rawValue !== 'string' || !isOffered(options, rawValue)) {
+      return { ok: false, error: 'Le choix sélectionné ne fait pas partie des options proposées' };
+    }
+    return { ok: true, body: { runId, kind, value: rawValue } };
+  }
+  if (!Array.isArray(rawValue) || !rawValue.every((value) => typeof value === 'string')) {
+    return { ok: false, error: 'La sélection multiple est invalide' };
+  }
+  const offered = rawValue.every((value) => isOffered(options, value));
+  if (!offered) {
+    return {
+      ok: false,
+      error: 'Une valeur sélectionnée ne fait pas partie des options proposées',
+    };
+  }
+  return { ok: true, body: { runId, kind, value: rawValue } };
+}

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * @param {string} data
+ * @returns {Record<string, unknown> | null}
+ */
+export function parseStreamMessage(data: string): Record<string, unknown> | null;
+/**
+ * @param {Array<Record<string, unknown>>} events
+ * @param {Record<string, unknown>} event
+ * @returns {Array<Record<string, unknown>>}
+ */
+export function appendEvent(events: Array<Record<string, unknown>>, event: Record<string, unknown>): Array<Record<string, unknown>>;
+/**
+ * @param {{ disconnected: boolean; complete: boolean }} input
+ * @returns {boolean}
+ */
+export function shouldStartPolling(input: {
+    disconnected: boolean;
+    complete: boolean;
+}): boolean;
+/**
+ * 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: Record<string, unknown> | null): Array<Record<string, unknown>>;
+/**
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {boolean}
+ */
+export function isRunComplete(events: Array<Record<string, unknown>>): boolean;
+/**
+ * @param {{ isPrimaryTab: boolean; hasActiveRun: boolean }} input
+ * @returns {{ readOnly: boolean; notice: string | null }}
+ */
+export function buildMultiTabViewState(input: {
+    isPrimaryTab: boolean;
+    hasActiveRun: boolean;
+}): {
+    readOnly: boolean;
+    notice: string | null;
+};
+/**
+ * @param {{ matches: boolean } | null} mediaQuery
+ * @returns {boolean}
+ */
+export function prefersReducedMotion(mediaQuery: {
+    matches: boolean;
+} | null): boolean;
+/**
+ * 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: {
+    runId: string;
+    onEvents: (events: Array<Record<string, unknown>>) => void;
+    onDisconnected: () => void;
+    onComplete: () => void;
+    eventSourceFactory?: {
+        new (url: string | URL, init?: import("undici-types").EventSourceInit): import("undici-types").EventSource;
+        prototype: import("undici-types").EventSource;
+        readonly CLOSED: 2;
+        readonly CONNECTING: 0;
+        readonly OPEN: 1;
+    } | undefined;
+    storage?: any;
+}): {
+    close: () => void;
+};
+//# sourceMappingURL=setupWizardStream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizardStream.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizardStream.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH,yCAHW,MAAM,GACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAY1C;AAED;;;;GAIG;AACH,oCAJW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAI1C;AAED;;;GAGG;AACH,0CAHW;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC1C,OAAO,CAInB;AAED;;;;;;;GAOG;AACH,4CAHW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmB1C;AAED;;;GAGG;AACH,sCAHW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5B,OAAO,CAInB;AAED;;;GAGG;AACH,8CAHW;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAUxD;AAED;;;GAGG;AACH,iDAHW;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GACzB,OAAO,CAInB;AAED;;;;;;;;;;;;GAYG;AACH,kDARG;IAAwB,KAAK,EAArB,MAAM;IACoD,QAAQ,EAAlE,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI;IAC5B,cAAc,EAAlC,MAAM,IAAI;IACU,UAAU,EAA9B,MAAM,IAAI;IACmB,kBAAkB;;;;;;;IAC7B,OAAO;CACjC,GAAU;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CA2CjC"}

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
  */
 
 /**