@wcag-checkr/ci 1.0.0-rc.98 → 1.0.0

package/dist/side-panel/format-component-id.test.ts

@@ -1,89 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { displayComponentId } from './format-component-id';
-
-describe('displayComponentId', () => {
-  it('formats Storybook story id', () => {
-    const r = displayComponentId('::story:atoms-button--primary');
-    expect(r.primary).toBe('Atoms Button / Primary');
-    expect(r.secondary).toBe('storybook');
-  });
-
-  it('formats testid with URL scope', () => {
-    const r = displayComponentId('https://example.com/login::testid:email-input');
-    expect(r.primary).toBe('email-input');
-    expect(r.secondary).toBe('https://example.com/login');
-  });
-
-  it('formats explicit data-componentid', () => {
-    const r = displayComponentId('https://example.com::explicit:my-card');
-    expect(r.primary).toBe('my-card');
-    expect(r.secondary).toBe('https://example.com');
-  });
-
-  it('formats custom element', () => {
-    const r = displayComponentId('https://example.com::customelement:my-button');
-    expect(r.primary).toBe('my-button');
-    expect(r.secondary).toBe('https://example.com');
-  });
-
-  it('formats aria id with role:name', () => {
-    const r = displayComponentId('https://example.com::aria:button:Submit form');
-    // value contains a colon; we keep everything after the first colon as the value
-    expect(r.primary).toBe('button:Submit form');
-    expect(r.secondary).toBe('https://example.com');
-  });
-
-  it('falls back gracefully when no separator', () => {
-    const r = displayComponentId('weird-id');
-    expect(r.primary).toBe('weird-id');
-  });
-
-  it('handles aria value with multiple colons (kept verbatim after first colon)', () => {
-    const r = displayComponentId('https://example.com::aria:button:Foo: bar: baz');
-    // Strategy is "aria"; value is "button:Foo: bar: baz" (preserves colons after the first).
-    expect(r.primary).toBe('button:Foo: bar: baz');
-    expect(r.secondary).toBe('https://example.com');
-  });
-
-  it('handles unicode story names', () => {
-    const r = displayComponentId('::story:atoms-bütton--primary');
-    expect(r.primary).toBe('Atoms Bütton / Primary');
-  });
-
-  it('handles emoji in story names', () => {
-    const r = displayComponentId('::story:atoms-button--🚀-primary');
-    expect(r.primary).toContain('🚀');
-  });
-
-  it('handles very long story id without crashing', () => {
-    const longSegment = 'a'.repeat(200);
-    const r = displayComponentId(`::story:${longSegment}--variant`);
-    expect(r.primary.length).toBeGreaterThan(0);
-    expect(r.primary).toContain('Variant');
-  });
-
-  it('handles single-segment story id without "--" separator', () => {
-    const r = displayComponentId('::story:single-segment-only');
-    // No "--" separator → entire value is one segment, gets capitalized.
-    expect(r.primary).toBe('Single Segment Only');
-  });
-
-  it('handles testid with special characters', () => {
-    const r = displayComponentId('https://example.com::testid:btn-#$@-special');
-    expect(r.primary).toBe('btn-#$@-special');
-    expect(r.secondary).toBe('https://example.com');
-  });
-
-  it('handles empty url scope (storybook-style separator with no URL)', () => {
-    const r = displayComponentId('::testid:button-x');
-    expect(r.primary).toBe('button-x');
-    // Empty URL scope falls back to strategy as the secondary label.
-    expect(r.secondary).toBe('testid');
-  });
-
-  it('handles trailing :: with empty rest', () => {
-    const r = displayComponentId('https://example.com::');
-    // No strategy:value content after the separator; should not crash.
-    expect(r.primary).toBe('');
-  });
-});

package/dist/side-panel/format-component-id.ts

@@ -1,40 +0,0 @@
-// Pretty-print a canonical componentId for display in the UI.
-// Spec: phase-1-specs.md §2 (componentId format).
-
-export type ComponentIdDisplay = {
-  primary: string;          // Headline label
-  secondary?: string;       // Smaller subtext (URL or strategy)
-};
-
-export function displayComponentId(id: string): ComponentIdDisplay {
-  // Format: {urlScope}::{strategy}:{value}    (urlScope may be empty for storybook)
-  const sepIdx = id.indexOf('::');
-  if (sepIdx === -1) {
-    return { primary: id };
-  }
-  const url = id.slice(0, sepIdx);
-  const rest = id.slice(sepIdx + 2);
-
-  // rest is "{strategy}:{value}". Strategy is the first segment up to the FIRST colon.
-  const colonIdx = rest.indexOf(':');
-  if (colonIdx === -1) {
-    return { primary: rest };
-  }
-  const strategy = rest.slice(0, colonIdx);
-  const value = rest.slice(colonIdx + 1);
-
-  if (strategy === 'story') {
-    // storyId like "atoms-button--primary" → "Atoms / Button / Primary"
-    const niceStory = value
-      .split('--')
-      .map((seg) => seg.split('-').map(cap).join(' '))
-      .join(' / ');
-    return { primary: niceStory, secondary: 'storybook' };
-  }
-
-  return { primary: value, secondary: url || strategy };
-}
-
-function cap(word: string): string {
-  return word.length === 0 ? word : word[0]!.toUpperCase() + word.slice(1);
-}

package/dist/side-panel/github-issue.test.ts

@@ -1,102 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { buildGithubIssueUrl } from './github-issue';
-import { DEFAULT_BREAKPOINT_PRESETS } from '../types/state';
-import type { Violation } from '../types/audit';
-
-const desktop = DEFAULT_BREAKPOINT_PRESETS.find((p) => p.id === 'desktop')!;
-
-function v(overrides: Partial<Violation> = {}): Violation {
-  return {
-    ruleId: 'color-contrast',
-    wcagCriterion: 'wcag143',
-    wcagLevel: 'AA',
-    impact: 'serious',
-    description: 'Insufficient contrast',
-    helpUrl: 'https://example.com/r',
-    target: {
-      selector: '#btn',
-      outerHTML: '<button id="btn">Go</button>',
-      failureSummary: '',
-      tagName: 'BUTTON',
-      role: null,
-      accessibleName: 'Go',
-      textSnippet: 'Go',
-      attrId: 'btn',
-      attrTestid: null,
-    },
-    componentId: '::cmp::btn',
-    currentState: {
-      pseudoState: 'default',
-      ariaVariation: null,
-      theme: 'light',
-      direction: 'ltr',
-      breakpoint: desktop,
-    },
-    axeVersion: '4.11.4',
-    detectedAt: '2026-05-04T00:00:00Z',
-    matchKey: 'mk-1',
-    ...overrides,
-  };
-}
-
-describe('buildGithubIssueUrl', () => {
-  it('produces a /issues/new URL pointing at the configured repo', () => {
-    const r = buildGithubIssueUrl('https://github.com/foo/bar', '::cmp::x', [v()]);
-    expect(r.url.startsWith('https://github.com/foo/bar/issues/new?')).toBe(true);
-  });
-
-  it('strips trailing slash from repo URL', () => {
-    const r = buildGithubIssueUrl('https://github.com/foo/bar/', '::x', [v()]);
-    expect(r.url.startsWith('https://github.com/foo/bar/issues/new?')).toBe(true);
-  });
-
-  it('puts violation count in the title', () => {
-    const r = buildGithubIssueUrl('https://github.com/foo/bar', '::x', [
-      v({ matchKey: 'm1' }),
-      v({ matchKey: 'm2', ruleId: 'image-alt' }),
-    ]);
-    expect(r.title).toMatch(/2 new violations/);
-  });
-
-  it('singular vs plural in title', () => {
-    const r = buildGithubIssueUrl('https://github.com/foo/bar', '::x', [v()]);
-    expect(r.title).toMatch(/1 new violation in/);
-    expect(r.title).not.toMatch(/violations/);
-  });
-
-  it('dedupes violations sharing the same logical key (rule + selector)', () => {
-    const a = v({ matchKey: 'm1', currentState: { ...v().currentState, pseudoState: 'hover' } });
-    const b = v({ matchKey: 'm2', currentState: { ...v().currentState, pseudoState: 'focus' } });
-    const r = buildGithubIssueUrl('https://github.com/foo/bar', '::x', [a, b]);
-    // Title says 1 violation (deduped), body lists both states.
-    expect(r.title).toMatch(/1 new violation/);
-    expect(r.body).toMatch(/:hover/);
-    expect(r.body).toMatch(/:focus/);
-  });
-
-  it('includes selector, helpUrl, and outerHTML in the body', () => {
-    const r = buildGithubIssueUrl('https://github.com/foo/bar', '::x', [
-      v({
-        target: {
-          ...v().target,
-          selector: '.my-thing',
-          outerHTML: '<button class="my-thing">x</button>',
-        },
-        helpUrl: 'https://example.com/help-link',
-      }),
-    ]);
-    expect(r.body).toContain('.my-thing');
-    expect(r.body).toContain('https://example.com/help-link');
-    expect(r.body).toContain('<button class="my-thing">x</button>');
-  });
-
-  it('truncates the URL when it gets absurdly long', () => {
-    const huge = 'x'.repeat(20000);
-    const r = buildGithubIssueUrl('https://github.com/foo/bar', '::x', [
-      v({
-        target: { ...v().target, outerHTML: huge },
-      }),
-    ]);
-    expect(r.url.length).toBeLessThanOrEqual(7800);
-  });
-});

package/dist/side-panel/github-issue.ts

@@ -1,66 +0,0 @@
-// Builds a pre-filled GitHub new-issue URL from a set of NEW violations.
-// Pure function — extracted from DeltaView so the URL/body shape is testable.
-
-import type { Violation } from '../types/audit';
-
-export type IssueBuild = { url: string; title: string; body: string };
-
-const URL_LIMIT = 7800;
-
-export function buildGithubIssueUrl(
-  repoUrl: string,
-  componentId: string | null,
-  newViolations: Violation[]
-): IssueBuild {
-  const cleaned = repoUrl.replace(/\/$/, '');
-
-  // Dedup violations by logical key (rule + selector); aggregate states.
-  const groups: Array<Violation & { _states: string[] }> = [];
-  for (const v of newViolations) {
-    const key = `${v.ruleId}::${v.target.selector}`;
-    const stateLabel = `:${v.currentState.pseudoState} · ${v.currentState.theme} · ${v.currentState.direction}`;
-    const existing = groups.find((g) => `${g.ruleId}::${g.target.selector}` === key);
-    if (existing) {
-      if (!existing._states.includes(stateLabel)) existing._states.push(stateLabel);
-      continue;
-    }
-    groups.push({ ...v, _states: [stateLabel] });
-  }
-
-  const title = `a11y: ${groups.length} new violation${groups.length === 1 ? '' : 's'} in ${componentId ?? 'audited component'}`;
-
-  const lines: string[] = [];
-  lines.push(`**Component:** \`${componentId ?? 'unknown'}\``);
-  lines.push('');
-  lines.push(
-    `Detected by WCAG Component Auditor as **new** vs the saved baseline — these are violations introduced since the last accepted baseline.`
-  );
-  lines.push('');
-  lines.push('---');
-  lines.push('');
-  for (const v of groups) {
-    lines.push(`### \`${v.ruleId}\` — ${v.impact}`);
-    lines.push('');
-    lines.push(v.description);
-    lines.push('');
-    lines.push(`- **WCAG:** ${v.wcagCriterion} (${v.wcagLevel})`);
-    lines.push(`- **Selector:** \`${v.target.selector}\``);
-    lines.push(`- **Found in state(s):** ${v._states.join(', ')}`);
-    if (v.helpUrl) lines.push(`- **More info:** ${v.helpUrl}`);
-    lines.push('');
-    lines.push('```html');
-    lines.push(v.target.outerHTML);
-    lines.push('```');
-    lines.push('');
-  }
-  lines.push('---');
-  lines.push('');
-  lines.push('_Filed via WCAG Component Auditor (delta-only — inherited debt not included)._');
-
-  const body = lines.join('\n');
-  const params = new URLSearchParams({ title, body });
-  let url = `${cleaned}/issues/new?${params.toString()}`;
-  if (url.length > URL_LIMIT) url = url.slice(0, URL_LIMIT);
-
-  return { url, title, body };
-}

package/dist/side-panel/jira-issue.ts

@@ -1,64 +0,0 @@
-// Builds a pre-filled Jira create-issue URL from a set of NEW violations.
-// Mirrors the GitHub flow but targets Jira Cloud's CreateIssue URL params.
-// Description field is plain text; we keep formatting minimal so it reads
-// cleanly in Jira's default text view (markdown won't render natively).
-
-import type { Violation } from '../types/audit';
-
-export type JiraIssueBuild = { url: string; summary: string; description: string };
-
-const URL_LIMIT = 7800;
-
-export function buildJiraIssueUrl(
-  instanceUrl: string,
-  componentId: string | null,
-  newViolations: Violation[]
-): JiraIssueBuild {
-  const cleaned = instanceUrl.replace(/\/$/, '');
-
-  // Dedup violations by logical key (rule + selector); aggregate states.
-  const groups: Array<Violation & { _states: string[] }> = [];
-  for (const v of newViolations) {
-    const key = `${v.ruleId}::${v.target.selector}`;
-    const stateLabel = `:${v.currentState.pseudoState} · ${v.currentState.theme} · ${v.currentState.direction}`;
-    const existing = groups.find((g) => `${g.ruleId}::${g.target.selector}` === key);
-    if (existing) {
-      if (!existing._states.includes(stateLabel)) existing._states.push(stateLabel);
-      continue;
-    }
-    groups.push({ ...v, _states: [stateLabel] });
-  }
-
-  const summary = `a11y: ${groups.length} new violation${groups.length === 1 ? '' : 's'} in ${componentId ?? 'audited component'}`;
-
-  const lines: string[] = [];
-  lines.push(`Component: ${componentId ?? 'unknown'}`);
-  lines.push('');
-  lines.push(
-    `Detected by WCAG Component Auditor as NEW vs the saved baseline — these are violations introduced since the last accepted baseline.`
-  );
-  lines.push('');
-  lines.push('---');
-  lines.push('');
-  for (const v of groups) {
-    lines.push(`Rule: ${v.ruleId} (${v.impact})`);
-    lines.push(`WCAG: ${v.wcagCriterion} ${v.wcagLevel}`);
-    lines.push(`Description: ${v.description}`);
-    lines.push(`Selector: ${v.target.selector}`);
-    lines.push(`Found in state(s): ${v._states.join(', ')}`);
-    if (v.helpUrl) lines.push(`More info: ${v.helpUrl}`);
-    lines.push('');
-    lines.push(`HTML: ${v.target.outerHTML}`);
-    lines.push('');
-    lines.push('---');
-    lines.push('');
-  }
-  lines.push('Filed via WCAG Component Auditor (delta-only — inherited debt not included).');
-
-  const description = lines.join('\n');
-  const params = new URLSearchParams({ summary, description });
-  let url = `${cleaned}/secure/CreateIssue!default.jspa?${params.toString()}`;
-  if (url.length > URL_LIMIT) url = url.slice(0, URL_LIMIT);
-
-  return { url, summary, description };
-}

package/dist/side-panel/main.tsx

@@ -1,19 +0,0 @@
-import React from 'react';
-import { createRoot } from 'react-dom/client';
-import { App } from './App';
-import { ErrorBoundary } from './components/ErrorBoundary';
-import { installCrashReporter } from '../modules/crash-reporter';
-import './styles.css';
-
-installCrashReporter('side-panel');
-
-const root = document.getElementById('root');
-if (!root) throw new Error('side-panel: #root not found');
-
-createRoot(root).render(
-  <React.StrictMode>
-    <ErrorBoundary>
-      <App />
-    </ErrorBoundary>
-  </React.StrictMode>
-);

package/dist/side-panel/store.ts

@@ -1,289 +0,0 @@
-// Zustand store for side panel state.
-// Spec: phase-1-specs.md §9.
-
-import { create } from 'zustand';
-import type { AuditResult, DeltaResult } from '../types/audit';
-import type { StateConfig } from '../types/state';
-import type { LicenseTier } from '../shared/messages';
-import type { InAppMessage } from '../modules/messages-client';
-import type { SiteCrawlReport } from '../shared/site-aggregator';
-
-export type AuditStatus = 'idle' | 'running' | 'complete' | 'failed' | 'interrupted';
-export type View = 'matrix' | 'report' | 'delta' | 'activity' | 'guided' | 'flows' | 'scorecard' | 'crawl' | 'forensic' | 'compliance';
-/** Two distinct personas: site owners (mom-and-pop, no code) vs developers
- * (full feature surface, CLI-friendly outputs, baselines, exports). */
-export type UserMode = 'owner' | 'dev';
-
-type Store = {
-  // audit
-  status: AuditStatus;
-  progress: { current: number; total: number; currentState?: StateConfig } | null;
-  results: AuditResult[];
-  delta: DeltaResult | null;
-  componentId: string | null;
-  errorMessage: string | null;
-  /** True only when results came from a scan that completed during this side-panel
-   * session. False when results were rehydrated from `loadLastAudit` — in that case
-   * the score UI should mark the grade as "stale, re-scan to refresh" rather than
-   * imply it reflects the page's current state. */
-  freshThisSession: boolean;
-
-  // baselines
-  baselineList: Array<{
-    componentId: string;
-    violationCount: number;
-    lastUpdated: string;
-    seenOnUrlsCount?: number;
-    metrics?: import('../shared/messages').BaselineSummaryMetrics;
-  }>;
-
-  // license
-  tier: LicenseTier;
-  /** Trial-tier countdown. null = unknown / not on trial. */
-  trialDaysRemaining: number | null;
-  /** Team-tier seat consumption. null = server hasn't emitted seat info. */
-  seatsUsed: number | null;
-  seatsTotal: number | null;
-  /** Server's actual plan code for the active license — `solo`, `solo-yearly`,
-   *  `solo-single-month`, `team`, `team-15`. Lets the UpgradeCard tell apart
-   *  the recurring SKUs from the one-time single-month pass even though they
-   *  all map to tier='solo' or tier='team' for capability gating. */
-  planCode: string | null;
-  /** Days until the active one-time license (e.g. solo-single-month) expires.
-   *  null for recurring subscriptions. */
-  licenseDaysRemaining: number | null;
-  /** True when Stripe reported the most recent invoice payment as failed.
-   *  License stays valid during the grace period but UI surfaces the
-   *  failure prominently so the user updates their card before access cuts. */
-  pastDue: boolean;
-
-  // in-app messages
-  messages: InAppMessage[];
-  unreadMessageCount: number;
-  criticalUnacked: boolean;
-
-  // ui
-  view: View;
-  /** Persona-driven UI mode. `null` = first-launch (wizard not yet answered). */
-  userMode: UserMode | null;
-
-  // site crawl
-  siteCrawlStatus: 'idle' | 'running' | 'complete' | 'failed';
-  siteCrawlProgress: { current: number; total: number; url: string; lastViolations?: number } | null;
-  siteCrawlReport: SiteCrawlReport | null;
-  siteCrawlError: string | null;
-
-  // highlight pin: which violation row is currently showing its overlay on the page,
-  // and whether its selector resolved (false → render "not in current state" hint).
-  pinnedMatchKey: string | null;
-  pinnedFound: boolean;
-
-  // AI augmentation failure surface — shown as a dismissible banner above the
-  // results area when an audit's AI portion errored despite a configured key.
-  // Cleared whenever a new audit starts or completes cleanly.
-  aiFailure: {
-    severity: 'total' | 'partial';
-    reason: string;
-    checksAttempted: number;
-    checksSucceeded: number;
-    checksErrored: number;
-    errorDetails: string[];
-  } | null;
-
-  // AI augmentation in-flight progress. Drives the post-matrix progress line:
-  // matrix loop owns 1..N states, then AI augmentation takes over and the bar
-  // shows e.g. "AI: 3/8 — Verifying alt text…". Cleared when AUDIT_COMPLETE
-  // fires or a new scan starts.
-  aiProgress: {
-    currentCheckLabel: string;
-    current: number;
-    total: number;
-    /** Optional sub-progress within the current check: which candidate is
-     *  being judged (e.g. image 3 of 10). When present the UI shows
-     *  "AI: 7/9 — Reviewing link clarity… (3/10)" so the user can see
-     *  movement inside a single check that judges many candidates. */
-    candidatesDone?: number;
-    candidatesTotal?: number;
-  } | null;
-
-  // actions
-  setStatus: (s: AuditStatus) => void;
-  /** Begin a new scan: flips status to 'running' AND clears prior results,
-   * delta, error, and progress so the panel doesn't show stale data from the
-   * previous site under the new "Scanning…" indicator. Use this from every
-   * START_AUDIT dispatch site instead of setStatus('running') alone. */
-  startNewScan: () => void;
-  setProgress: (p: Store['progress']) => void;
-  setResults: (results: AuditResult[], delta: DeltaResult | null, componentId: string) => void;
-  setDelta: (delta: DeltaResult | null) => void;
-  setError: (message: string) => void;
-  setBaselineList: (list: Store['baselineList']) => void;
-  /** Wipe the current audit (results, delta, componentId, error, progress).
-   *  Used by the user-triggered Clear button and by auto-clear when the user
-   *  navigates the audit target to a different URL. Baselines + forensic
-   *  history are NOT touched — those are persistent records. */
-  clearResults: () => void;
-  setTier: (
-    tier: LicenseTier,
-    extras?: {
-      trialDaysRemaining?: number;
-      seatsUsed?: number;
-      seatsTotal?: number;
-      planCode?: string | null;
-      licenseDaysRemaining?: number;
-      pastDue?: boolean;
-    }
-  ) => void;
-  setView: (v: View) => void;
-  setUserMode: (m: UserMode | null) => void;
-  setSiteCrawlStatus: (s: Store['siteCrawlStatus']) => void;
-  setSiteCrawlProgress: (p: Store['siteCrawlProgress']) => void;
-  setSiteCrawlReport: (r: SiteCrawlReport | null) => void;
-  setSiteCrawlError: (e: string | null) => void;
-  setPinned: (matchKey: string | null, found?: boolean) => void;
-  setAiFailure: (failure: Store['aiFailure']) => void;
-  clearAiFailure: () => void;
-  setAiProgress: (progress: Store['aiProgress']) => void;
-  /** rc.37 — matchKeys the user has acknowledged as "not an issue." Loaded
-   *  from chrome.storage at mount. Every ViolationCard reads this directly
-   *  so the "Acknowledged" pill appears immediately on click, in every
-   *  view (Matrix, Delta, WCAG-em, Owner — anywhere a card renders),
-   *  before the SW round-trip to refresh the delta. */
-  acknowledgedKeys: Set<string>;
-  setAcknowledgedKeys: (keys: Set<string>) => void;
-  markAcknowledged: (matchKey: string) => void;
-  markUnacknowledged: (matchKey: string) => void;
-  /** Replace the in-app messages list + counters. Called by wire-messaging
-   *  after a refresh from the server. */
-  setMessages: (messages: InAppMessage[], unreadCount: number, criticalUnacked: boolean) => void;
-  /** Mark a message as locally seen/dismissed/acknowledged so the UI updates
-   *  immediately without waiting for the next server refresh. */
-  applyMessageAck: (messageId: number, action: 'seen' | 'dismissed' | 'acknowledged' | 'clicked') => void;
-};
-
-export const useStore = create<Store>((set) => ({
-  status: 'idle',
-  progress: null,
-  results: [],
-  delta: null,
-  componentId: null,
-  errorMessage: null,
-  freshThisSession: false,
-  baselineList: [],
-  tier: 'trial',
-  trialDaysRemaining: null,
-  seatsUsed: null,
-  seatsTotal: null,
-  planCode: null,
-  licenseDaysRemaining: null,
-  pastDue: false,
-  messages: [],
-  unreadMessageCount: 0,
-  criticalUnacked: false,
-  view: 'matrix',
-  userMode: null,
-  siteCrawlStatus: 'idle',
-  siteCrawlProgress: null,
-  siteCrawlReport: null,
-  siteCrawlError: null,
-  pinnedMatchKey: null,
-  pinnedFound: true,
-  aiFailure: null,
-  aiProgress: null,
-  acknowledgedKeys: new Set<string>(),
-
-  setStatus: (status) => set({ status }),
-  startNewScan: () =>
-    set({
-      status: 'running',
-      results: [],
-      delta: null,
-      errorMessage: null,
-      progress: null,
-      componentId: null,
-      pinnedMatchKey: null,
-      pinnedFound: true,
-      aiFailure: null,
-      aiProgress: null,
-      // freshThisSession stays false until setResults fires.
-    }),
-  setProgress: (progress) => set({ progress }),
-  setResults: (results, delta, componentId) =>
-    set({
-      results,
-      delta,
-      componentId,
-      status: 'complete',
-      errorMessage: null,
-      freshThisSession: true,
-      aiProgress: null,
-      // New audit invalidates any prior pin.
-      pinnedMatchKey: null,
-      pinnedFound: true,
-    }),
-  setDelta: (delta) => set({ delta }),
-  setError: (errorMessage) => set({ errorMessage, status: 'failed' }),
-  setBaselineList: (baselineList) => set({ baselineList }),
-  clearResults: () =>
-    set({
-      results: [],
-      delta: null,
-      componentId: null,
-      errorMessage: null,
-      progress: null,
-      status: 'idle',
-      freshThisSession: false,
-      pinnedMatchKey: null,
-      pinnedFound: true,
-      aiFailure: null,
-      aiProgress: null,
-    }),
-  setTier: (tier, extras) =>
-    set({
-      tier,
-      trialDaysRemaining: extras?.trialDaysRemaining ?? null,
-      seatsUsed: extras?.seatsUsed ?? null,
-      seatsTotal: extras?.seatsTotal ?? null,
-      planCode: extras?.planCode ?? null,
-      licenseDaysRemaining: extras?.licenseDaysRemaining ?? null,
-      pastDue: extras?.pastDue ?? false,
-    }),
-  setView: (view) => set({ view }),
-  setUserMode: (userMode) => set({ userMode }),
-  setSiteCrawlStatus: (siteCrawlStatus) => set({ siteCrawlStatus }),
-  setSiteCrawlProgress: (siteCrawlProgress) => set({ siteCrawlProgress }),
-  setSiteCrawlReport: (siteCrawlReport) => set({ siteCrawlReport }),
-  setSiteCrawlError: (siteCrawlError) => set({ siteCrawlError }),
-  setPinned: (matchKey, found = true) => set({ pinnedMatchKey: matchKey, pinnedFound: found }),
-  setAiFailure: (aiFailure) => set({ aiFailure }),
-  clearAiFailure: () => set({ aiFailure: null }),
-  setAiProgress: (aiProgress) => set({ aiProgress }),
-  setAcknowledgedKeys: (acknowledgedKeys) => set({ acknowledgedKeys }),
-  markAcknowledged: (matchKey) =>
-    set((s) => ({ acknowledgedKeys: new Set(s.acknowledgedKeys).add(matchKey) })),
-  markUnacknowledged: (matchKey) =>
-    set((s) => {
-      const next = new Set(s.acknowledgedKeys);
-      next.delete(matchKey);
-      return { acknowledgedKeys: next };
-    }),
-  setMessages: (messages, unreadMessageCount, criticalUnacked) =>
-    set({ messages, unreadMessageCount, criticalUnacked }),
-  applyMessageAck: (messageId, action) =>
-    set((s) => {
-      const next = s.messages
-        .map((m) => {
-          if (m.id !== messageId) return m;
-          if (action === 'seen') return { ...m, seen: true };
-          if (action === 'dismissed') return { ...m, dismissed: true };
-          if (action === 'acknowledged') return { ...m, acknowledged: true };
-          if (action === 'clicked') return { ...m, clicked: true };
-          return m;
-        })
-        // Drop fully-handled non-critical messages (mirrors server visibility).
-        .filter((m) => (m.severity === 'critical' ? !m.acknowledged : !m.dismissed));
-      const unread = next.filter((m) => !m.seen).length;
-      const critUnacked = next.some((m) => m.severity === 'critical' && !m.acknowledged);
-      return { messages: next, unreadMessageCount: unread, criticalUnacked: critUnacked };
-    }),
-}));