@appfire-ux/audit-agent 0.2026.70-2.1 → 0.2026.702

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appfire-ux/audit-agent",
-  "version": "0.2026.702.1",
+  "version": "0.2026.702",
   "description": "Claude Code UX audit agent for Appfire apps — installs the ux-auditor agent and /ux-audit command that audit a repo against @appfire-ux/guidelines",
   "license": "MIT",
   "publishConfig": {
@@ -22,10 +22,6 @@
   },
   "files": [
     "bin/",
-    "templates/",
-    "scripts/"
-  ],
-  "optionalDependencies": {
-    "playwright": "^1.47.0"
-  }
+    "templates/"
+  ]
 }

package/templates/agents/ux-auditor.md

@@ -99,20 +99,9 @@ Run each pass over the scoped source. For each pass: start with the greps below
 Attempt only if the environment allows; NEVER let this phase break the audit — on any failure, fall back to static-only and record the limitation.
 
 1. Find the dev command (`package.json` scripts: `dev`/`start`/`storybook`). Install deps if needed, start it in the background, wait for the port to answer.
-2. Capture screenshots in this explicit order — stop at the first that works:
-   1. **Browser MCP/tool available in this session** (Playwright MCP, Chrome DevTools, Claude in Chrome) → use it directly: visit the main surfaces, capture screenshots of key screens and states (save under `docs/ux-audit/assets/`), tab through primary flows to verify focus order and visible focus, trigger error/empty states where cheap to do, spot-check computed colors/contrast of flagged elements, toggle reduced-motion emulation if possible.
-   2. **No browser tool/MCP available** → you always have Bash, so shell out to the bundled Playwright capture script instead of skipping screenshots:
-      ```bash
-      npx playwright install chromium   # one-time, skip if already installed
-      node node_modules/@appfire-ux/audit-agent/scripts/ux-audit-capture.mjs \
-        --url http://localhost:5173 \
-        --out docs/ux-audit/assets \
-        --routes /,/dashboard/teams
-      ```
-      This only covers screenshots (no focus/contrast/reduced-motion checks — note that limitation in the report). If the script errors (e.g. `playwright` not installed and install fails, or every route fails), fall through to 2.3.
-   3. **Both unavailable** → static-only. Record the limitation explicitly in the report appendix (Phase 6) instead of silently skipping runtime checks.
-3. If Storybook exists, prefer it for isolated component states (still via the MCP tool if available, otherwise the same Playwright script pointed at the Storybook URL).
-4. Attach evidence: reference screenshots in findings; runtime-confirmed findings get higher confidence. Screenshots captured via the Playwright script fallback are `verified-runtime` for visual findings only — accessibility findings that need interaction (focus order, keyboard reachability) stay `suspected` unless a browser MCP tool confirmed them.
+2. If a browser tool/MCP is available in this session (Playwright, Chrome DevTools, Claude in Chrome), visit the main surfaces and: capture screenshots of key screens and states (save under `docs/ux-audit/assets/`), tab through primary flows to verify focus order and visible focus, trigger error/empty states where cheap to do, spot-check computed colors/contrast of flagged elements, toggle reduced-motion emulation if possible.
+3. If Storybook exists, prefer it for isolated component states.
+4. Attach evidence: reference screenshots in findings; runtime-confirmed findings get higher confidence.
 
 ## Phase 5 — Synthesis & scoring
 

package/scripts/ux-audit-capture.mjs

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-/**
- * Playwright fallback for the ux-auditor agent's Phase 4 (runtime verification).
- * Used when no browser MCP/tool is available in the session — the agent always
- * has Bash, so it can shell out to this script instead of skipping screenshots.
- *
- * Usage:
- *   npx playwright install chromium   # once, if not already installed
- *   node scripts/ux-audit-capture.mjs --url http://localhost:5173 \
- *     --out docs/ux-audit/assets --routes /,/dashboard/teams
- *
- * Requires the optional "playwright" dependency (see package.json).
- */
-
-'use strict';
-
-import fs from 'node:fs';
-import path from 'node:path';
-
-function parseArgs(argv) {
-  const opts = { url: null, out: null, routes: ['/'] };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === '--url') opts.url = argv[++i];
-    else if (arg === '--out') opts.out = argv[++i];
-    else if (arg === '--routes') opts.routes = argv[++i].split(',').map((r) => r.trim()).filter(Boolean);
-  }
-  return opts;
-}
-
-function routeToFilename(route) {
-  const slug = route === '/' ? 'root' : route.replace(/^\//, '').replace(/[/?#]+/g, '-');
-  return `${slug}.png`;
-}
-
-async function main() {
-  const { url, out, routes } = parseArgs(process.argv.slice(2));
-
-  if (!url || !out) {
-    console.error('[ux-audit-capture] Usage: --url <base-url> --out <dir> [--routes /,/foo,/bar]');
-    process.exit(1);
-  }
-
-  let chromium;
-  try {
-    ({ chromium } = await import('playwright'));
-  } catch {
-    console.error('[ux-audit-capture] "playwright" is not installed. Run: npm install -D playwright && npx playwright install chromium');
-    process.exit(1);
-  }
-
-  fs.mkdirSync(out, { recursive: true });
-
-  const browser = await chromium.launch();
-  const page = await browser.newPage();
-
-  const results = [];
-  for (const route of routes) {
-    const target = new URL(route, url).toString();
-    const file = path.join(out, routeToFilename(route));
-    try {
-      await page.goto(target, { waitUntil: 'networkidle', timeout: 15000 });
-      await page.screenshot({ path: file, fullPage: true });
-      results.push({ route, file, ok: true });
-      console.log(`[ux-audit-capture] captured ${route} -> ${file}`);
-    } catch (err) {
-      results.push({ route, file: null, ok: false, error: err.message });
-      console.error(`[ux-audit-capture] failed ${route}: ${err.message}`);
-    }
-  }
-
-  await browser.close();
-
-  const failed = results.filter((r) => !r.ok);
-  if (failed.length === results.length) {
-    console.error('[ux-audit-capture] all routes failed — falling back to static-only is recommended.');
-    process.exit(1);
-  }
-  process.exit(0);
-}
-
-main();