@iamu-dev/iamu 0.8.0-beta.0 → 0.8.0-beta.1

package/dist/index.js

@@ -2534,8 +2534,39 @@ var init_dist = __esm({
 
 // ../../packages/local-store/dist/atomic.js
 import { randomUUID } from "crypto";
-import { closeSync, fsyncSync, mkdirSync, openSync, promises as fs, renameSync, unlinkSync, writeFileSync } from "fs";
+import fsSync, { closeSync, fsyncSync, mkdirSync, openSync, promises as fs, unlinkSync, writeFileSync } from "fs";
 import path from "path";
+function isTransientWindowsRenameError(err) {
+  const code = err?.code;
+  return code === "EPERM" || code === "EACCES";
+}
+function renameSyncWithRetry(src, dest, maxRetries = MAX_RENAME_RETRIES) {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      fsSync.renameSync(src, dest);
+      return;
+    } catch (err) {
+      if (isTransientWindowsRenameError(err) && attempt < maxRetries) {
+        continue;
+      }
+      throw err;
+    }
+  }
+}
+async function renameWithRetry(src, dest, maxRetries = MAX_RENAME_RETRIES) {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      await fs.rename(src, dest);
+      return;
+    } catch (err) {
+      if (isTransientWindowsRenameError(err) && attempt < maxRetries) {
+        await new Promise((resolve3) => setTimeout(resolve3, 15));
+        continue;
+      }
+      throw err;
+    }
+  }
+}
 function atomicWriteFileSync(targetPath, content, opts = {}) {
   const dir = path.dirname(targetPath);
   const base = path.basename(targetPath);
@@ -2549,7 +2580,7 @@ function atomicWriteFileSync(targetPath, content, opts = {}) {
     fsyncSync(fd);
     closeSync(fd);
     fd = null;
-    renameSync(tmpPath, targetPath);
+    renameSyncWithRetry(tmpPath, targetPath);
     renamed2 = true;
   } finally {
     if (fd !== null) {
@@ -2581,7 +2612,7 @@ async function atomicWriteFile(targetPath, content, opts = {}) {
     } finally {
       await handle.close();
     }
-    await fs.rename(tmpPath, targetPath);
+    await renameWithRetry(tmpPath, targetPath);
     renamed2 = true;
   } finally {
     if (!renamed2) {
@@ -2603,9 +2634,11 @@ async function appendJsonLine(targetPath, record) {
     await handle.close();
   }
 }
+var MAX_RENAME_RETRIES;
 var init_atomic = __esm({
   "../../packages/local-store/dist/atomic.js"() {
     "use strict";
+    MAX_RENAME_RETRIES = 4;
   }
 });
 
@@ -10753,6 +10786,7 @@ async function readDesigner(projectRoot, runId, findings2) {
     design_files: raw.design_files ?? [],
     summary: raw.summary ?? "",
     ...raw.skipped ? { skipped: raw.skipped.reason ?? "skipped" } : {},
+    ...raw.screens && raw.screens.length > 0 ? { screens: raw.screens } : {},
     rules_broken: broken,
     rules_held: held,
     issues: (raw.issues ?? []).map((i) => ({
@@ -10821,7 +10855,7 @@ async function buildCanonical(projectRoot, manifest, completedAt, inputs) {
       // Step files record the path relative to the run directory
       // (`screenshots/step-1.png`); older ones recorded the bare file
       // name. Normalize on the file name so the prefix is never doubled.
-      screenshot_ref: s.screenshot ? path20.join("screenshots", path20.basename(s.screenshot)) : null,
+      screenshot_ref: s.screenshot ? path20.posix.join("screenshots", path20.basename(s.screenshot)) : null,
       persona_reasoning: s.note,
       grounding: s.grounding ?? null,
       action: s.action,
@@ -15224,6 +15258,13 @@ function renderDesigner(designer2, lines) {
     }
     lines.push("", designerRuleCounts(designer2));
   }
+  if (designer2.proposals.length > 0) {
+    lines.push("", `Proposed doc edits: ${designer2.proposals.map((p) => `\`${p.slug}\` (${p.outcome})`).join(", ")}. Decide them with \`iamu design proposals\`.`);
+  }
+}
+function renderDesignerFindings(designer2, lines) {
+  if (designer2.skipped)
+    return;
   const own = designer2.issues.filter((i) => !i.design_cause_of);
   lines.push("", own.length === 0 ? "_No designer findings beyond the design causes above._" : `${designerCount(designer2)}, worst first.`);
   for (const g of designerIssuesByScreen(designer2)) {
@@ -15237,9 +15278,35 @@ function renderDesigner(designer2, lines) {
       lines.push(`- ${i.id} **${i.title}** (${designerIssueMeta(i, (t) => `_${t}_`)}).${text.length > 0 ? ` ${text.join(" ")}` : ""}`);
     }
   }
-  if (designer2.proposals.length > 0) {
-    lines.push("", `Proposed doc edits: ${designer2.proposals.map((p) => `\`${p.slug}\` (${p.outcome})`).join(", ")}. Decide them with \`iamu design proposals\`.`);
+}
+function designerScreenReadingsByStep(designer2, steps2) {
+  const out2 = /* @__PURE__ */ new Map();
+  if (!designer2?.screens || designer2.screens.length === 0)
+    return out2;
+  const byKey = new Map(designer2.screens.filter((s) => s.reading?.trim() || s.serves && s.serves.length > 0).map((s) => [s.key, s]));
+  const shown = /* @__PURE__ */ new Set();
+  for (const st of steps2) {
+    const candidates = [
+      pagePath(st.url),
+      st.surface ?? null,
+      `step-${st.step_number}`
+    ].filter((c) => Boolean(c));
+    for (const key of candidates) {
+      if (shown.has(key))
+        continue;
+      const screen = byKey.get(key);
+      if (screen) {
+        shown.add(key);
+        out2.set(st.step_number, {
+          key: screen.key,
+          reading: screen.reading.trim(),
+          serves: (screen.serves ?? []).map((x) => x.what.trim()).filter(Boolean)
+        });
+        break;
+      }
+    }
   }
+  return out2;
 }
 function renderRunDetails(c, lines) {
   lines.push("", "## Run details", "", `- Run ID: ${c.run_id}`, `- Target URL: ${c.target.url}`);
@@ -15277,12 +15344,13 @@ function renderRunDetails(c, lines) {
   if (diff)
     lines.push("", renderJourneyDiffMarkdown(diff));
 }
-function renderSteps(c, lines) {
+function renderSteps(c, designer2, lines) {
   lines.push("", "## Steps");
   if (c.steps.length === 0) {
     lines.push("", "_No steps recorded._");
     return;
   }
+  const readings = designerScreenReadingsByStep(designer2, c.steps);
   for (const s of c.steps) {
     lines.push("", `### ${s.step_number}. ${s.screen_title ?? "(untitled)"} \u2014 ${s.id}`);
     const where = [s.surface, s.url].filter(Boolean).join(" \u2014 ");
@@ -15290,6 +15358,16 @@ function renderSteps(c, lines) {
       lines.push("", `Page: ${where}`);
     if (s.persona_reasoning)
       lines.push("", `> ${s.persona_reasoning.replace(/\n/g, "\n> ")}`);
+    const reading = readings.get(s.step_number);
+    if (reading) {
+      const parts = [
+        reading.reading,
+        reading.serves.length > 0 ? `Serves: ${reading.serves.join("; ")}` : ""
+      ].filter(Boolean);
+      if (parts.length > 0) {
+        lines.push("", `**Designer reading** (\`${reading.key}\`): ${parts.join(" ")}`);
+      }
+    }
     if (s.grounding)
       lines.push("", `Grounding: ${s.grounding}`);
     if (s.screenshot_ref)
@@ -15327,7 +15405,10 @@ function renderCanonicalMarkdown(canonical3) {
   const checks = c.checks;
   if (checks)
     renderChecks(c, checks, lines);
+  const designer2 = canonicalDesignerOf(c);
   renderHumanTest(c, lines);
+  if (designer2)
+    renderDesigner(designer2, lines);
   const verification = c.verification;
   const newIds = new Set(verification?.new_findings.map((n) => n.id) ?? []);
   const problems = c.findings.filter((f) => f.type !== "helps" && !isSetupArtifact(f)).sort((a, b) => rank(a.severity, SEVERITY_ORDER) - rank(b.severity, SEVERITY_ORDER) || rank(a.type, TYPE_ORDER) - rank(b.type, TYPE_ORDER));
@@ -15335,7 +15416,6 @@ function renderCanonicalMarkdown(canonical3) {
   if (verification) {
     renderSince(verification, problems.filter((f) => newIds.has(f.id)).length, strengths.filter((f) => newIds.has(f.id)).length, lines);
   }
-  const designer2 = canonicalDesignerOf(c);
   const causes = designCausesByFinding(designer2);
   lines.push("", "## Findings");
   if (problems.length === 0) {
@@ -15352,11 +15432,11 @@ function renderCanonicalMarkdown(canonical3) {
       renderFinding(c, f, i + 1, since, causes.get(f.id) ?? [], lines);
     });
   }
+  if (designer2)
+    renderDesignerFindings(designer2, lines);
   const analysis = c.analysis;
   if (analysis)
     renderDirections(analysis, lines);
-  if (designer2)
-    renderDesigner(designer2, lines);
   if (analysis)
     renderNotes(analysis, lines);
   const what = c.what_worked ?? [];
@@ -15380,7 +15460,7 @@ function renderCanonicalMarkdown(canonical3) {
     for (const n of setup)
       lines.push(`- ${n}`);
   }
-  renderSteps(c, lines);
+  renderSteps(c, designer2, lines);
   renderRunDetails(c, lines);
   return `${lines.join("\n")}
 `;
@@ -22704,8 +22784,8 @@ import { dirname as dirname3, join as join5, resolve as resolve2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import chalk6 from "chalk";
 function getVersion() {
-  if ("0.8.0-beta.0") {
-    return "0.8.0-beta.0";
+  if ("0.8.0-beta.1") {
+    return "0.8.0-beta.1";
   }
   try {
     const thisDir = dirname3(fileURLToPath2(import.meta.url));
@@ -23649,7 +23729,7 @@ import chalk9 from "chalk";
 function openBrowser(url, run = spawnDetached) {
   try {
     const parsed = new URL(url);
-    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:" && parsed.protocol !== "file:") {
       return;
     }
   } catch {
@@ -24450,6 +24530,7 @@ function renderRunView(v, width = 100) {
       `    ${verdictColor(t.label)(padRight(t.label, 8))} ${truncate(t.question, w - 14)}`
     );
   }
+  if (v.designer) lines.push(...renderDesignerBlock(v.designer, w));
   if (v.since) {
     const s = v.since;
     const parts = [
@@ -24538,6 +24619,9 @@ function renderRunView(v, width = 100) {
       `    ${padRight(chalk12.green("\u2713"), 3)}${padRight("", 8)} ${padRight(chalk12.green("helps"), 9)} ${truncate(s, titleWidth + whereWidth)}`
     );
   }
+  if (v.designer && !v.designer.skipped) {
+    lines.push(...renderDesignerFindingsBlock(v.designer, w));
+  }
   if (v.directions.length > 0) {
     lines.push("", `  ${chalk12.bold("Directions")}`);
     for (const d of v.directions) {
@@ -24549,7 +24633,6 @@ function renderRunView(v, width = 100) {
       );
     }
   }
-  if (v.designer) lines.push(...renderDesignerBlock(v.designer, w));
   if (v.observations.length > 0 || v.setupNotes.length > 0) {
     lines.push("", `  ${chalk12.bold("Also worth knowing")}`);
     for (const n of v.setupNotes) {
@@ -24598,6 +24681,17 @@ function renderDesignerBlock(designer2, w) {
     }
     lines.push(chalk12.dim(`    ${designerRuleCounts(designer2)}`));
   }
+  if (designer2.proposals.length > 0) {
+    lines.push(
+      chalk12.dim(
+        `    ${designer2.proposals.length} proposed doc edit${designer2.proposals.length === 1 ? "" : "s"}: iamu design proposals`
+      )
+    );
+  }
+  return lines;
+}
+function renderDesignerFindingsBlock(designer2, w) {
+  const lines = [];
   for (const g of designerIssuesByScreen(designer2)) {
     lines.push(`    ${g.screen ?? "Across the run"}`);
     for (const i of g.issues) {
@@ -24616,13 +24710,6 @@ function renderDesignerBlock(designer2, w) {
       }
     }
   }
-  if (designer2.proposals.length > 0) {
-    lines.push(
-      chalk12.dim(
-        `    ${designer2.proposals.length} proposed doc edit${designer2.proposals.length === 1 ? "" : "s"}: iamu design proposals`
-      )
-    );
-  }
   return lines;
 }
 function renderOverview(v, width = 100) {
@@ -25777,12 +25864,28 @@ function renderDesigner2(designer2) {
   const rules = designer2.judged_against === "design-docs" ? `${designer2.rules_broken.length > 0 ? `<div class="card-label designer-gap">Rules broken</div>
         <ul class="designer-list">${designer2.rules_broken.map((r) => `<li>${esc(designerBreakLine(r))}</li>`).join("")}</ul>` : ""}
         <div class="finding-meta">${esc(designerRuleCounts(designer2))}</div>` : "";
+  const proposals = designer2.proposals.length > 0 ? `<div class="finding-meta designer-gap">${esc(`Proposed doc edits: ${designer2.proposals.map((p) => p.slug).join(", ")}. Decide them with iamu design proposals.`)}</div>` : "";
+  return `
+    <section>
+      <style>${DESIGNER_CSS}
+      </style>
+      <h2>Designer's review</h2>
+      <div class="card">
+        <div class="finding-meta" style="margin-top:0">${esc(designerLabel(designer2))}</div>
+        ${designer2.summary ? `<p style="font-size:14px;line-height:1.6;margin-top:0.4rem">${esc(designer2.summary)}</p>` : ""}
+        ${rules}
+        ${proposals}
+      </div>
+    </section>`;
+}
+function renderDesignerFindings2(designer2) {
+  if (designer2.skipped) return "";
   const screens = designerIssuesByScreen(designer2).map(
     (g) => `
       <div class="card-label designer-gap">${esc(g.screen ?? "Across the run")}</div>
       ${g.issues.map(
       (i) => `
-        <div class="designer-item">
+        <div class="finding-item designer-item">
           <div class="designer-title">${designerTitle(i)}</div>
           <div class="designer-meta">${esc(designerIssueMeta(i))}</div>
           <div class="designer-text">${esc([i.what, i.why].filter(Boolean).join(" "))}</div>
@@ -25790,19 +25893,18 @@ function renderDesigner2(designer2) {
         </div>`
     ).join("")}`
   ).join("");
-  const proposals = designer2.proposals.length > 0 ? `<div class="finding-meta designer-gap">${esc(`Proposed doc edits: ${designer2.proposals.map((p) => p.slug).join(", ")}. Decide them with iamu design proposals.`)}</div>` : "";
   return `
-    <section>
-      <style>${DESIGNER_CSS}
-      </style>
-      <h2>Designer's review</h2>
-      <div class="finding-meta">${esc(designerCount(designer2))}</div>
-      <div class="finding-meta">${esc(designerLabel(designer2))}</div>
-      ${designer2.summary ? `<p style="font-size:14px;line-height:1.6">${esc(designer2.summary)}</p>` : ""}
-      ${rules}
-      ${screens || '<div class="finding-meta">No designer findings beyond the design causes above.</div>'}
-      ${proposals}
-    </section>`;
+      <div class="finding-meta designer-gap">${esc(designerCount(designer2))}</div>
+      ${screens || '<div class="finding-meta">No designer findings beyond the design causes above.</div>'}`;
+}
+function renderStepDesignerReading(reading) {
+  if (!reading || !reading.reading && reading.serves.length === 0) return "";
+  return `
+                  <div class="designer-item">
+                    <div class="designer-meta">Designer reading \xB7 ${esc(reading.key)}</div>
+                    ${reading.reading ? `<div class="designer-text">${esc(reading.reading)}</div>` : ""}
+                    ${reading.serves.length > 0 ? `<div class="designer-meta">Serves: ${esc(reading.serves.join("; "))}</div>` : ""}
+                  </div>`;
 }
 function generateHtmlReport(data) {
   const {
@@ -25825,6 +25927,14 @@ function generateHtmlReport(data) {
   const dateStr = formatDate(completedAt ?? startedAt);
   const problems = sortProblems(findings2.filter((f) => f.type !== "helps"));
   const causes = designCausesByFinding(data.designer ?? null);
+  const screenReadings = designerScreenReadingsByStep(
+    data.designer ?? null,
+    steps2.map((s) => ({
+      step_number: s.stepNumber,
+      url: s.url,
+      surface: s.screenTitle
+    }))
+  );
   const strengths = findings2.filter((f) => f.type === "helps");
   const criticalCount = problems.filter(
     (f) => f.severity === "critical"
@@ -26344,7 +26454,9 @@ function generateHtmlReport(data) {
     </section>
     ` : ""}
 
-    ${verification ? renderSinceTable(verification) : ""}
+    ${data.designer ? `${renderDesigner2(data.designer)}
+
+    ` : ""}${verification ? renderSinceTable(verification) : ""}
 
     <!-- Findings, worst first -->
     ${problems.length > 0 ? `
@@ -26364,13 +26476,16 @@ function generateHtmlReport(data) {
           ${f.recommendation ? `<div class="finding-meta finding-rec"><strong>Recommendation:</strong> ${inlineMarkdown(f.recommendation)}</div>` : ""}${renderDesignCauses2(causes.get(f.id) ?? [])}
         </div>
       `
-  ).join("")}
+  ).join("")}${data.designer ? renderDesignerFindings2(data.designer) : ""}
+    </section>
+    ` : data.designer && !data.designer.skipped ? `
+    <section>
+      <h2>Findings (0)</h2>${renderDesignerFindings2(data.designer)}
     </section>
     ` : ""}
 
     ${[
     data.analysis ? renderDirections2(data.analysis) : "",
-    data.designer ? renderDesigner2(data.designer) : "",
     data.analysis ? renderNotes2(data.analysis) : ""
   ].filter(Boolean).map((section) => `${section}
 
@@ -26426,7 +26541,7 @@ function generateHtmlReport(data) {
                 ${s.personaReasoning ? `
                   <div class="step-thought">
                     <div class="prose-quote">${esc(s.personaReasoning)}</div>
-                  </div>` : ""}
+                  </div>` : ""}${renderStepDesignerReading(screenReadings.get(s.stepNumber))}
                 ${renderStepScreenshotHtml(s)}
               </div>
             </div>
@@ -26648,6 +26763,7 @@ __export(report_exports, {
   report: () => report
 });
 import path48 from "path";
+import { pathToFileURL } from "url";
 import chalk15 from "chalk";
 async function report(scenario, opts) {
   const ctx = await resolveProject(opts);
@@ -26749,7 +26865,7 @@ async function htmlReport(projectRoot, target, opts) {
   console.log();
   if (opts.open) {
     const { openBrowser: openBrowser2 } = await Promise.resolve().then(() => (init_auth(), auth_exports));
-    openBrowser2(`file://${filePath}`);
+    openBrowser2(pathToFileURL(filePath).href);
   }
 }
 async function jsonRows(projectRoot, runs) {
@@ -26805,6 +26921,7 @@ __export(open_exports, {
 });
 import { existsSync as existsSync12, promises as fs54 } from "fs";
 import path49 from "path";
+import { pathToFileURL as pathToFileURL2 } from "url";
 import { isCancel as isCancel3, select as select3 } from "@clack/prompts";
 import chalk16 from "chalk";
 async function openDashboard(runId, opts) {
@@ -26932,7 +27049,7 @@ async function openLocalReport(projectRoot, runId, opts) {
   console.log(`  ${symbols.success} Opening local walkthrough report:`);
   console.log(`  ${chalk16.cyan(filePath)}`);
   console.log();
-  openBrowser(`file://${filePath}`);
+  openBrowser(pathToFileURL2(filePath).href);
 }
 var init_open = __esm({
   "src/commands/open.ts"() {
@@ -29473,7 +29590,7 @@ __export(init_exports, {
   init: () => init,
   setupCommand: () => setupCommand
 });
-import { existsSync as existsSync13, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync6, readdirSync as readdirSync3 } from "fs";
 import { mkdir as mkdir4, readdir, writeFile as writeFile3 } from "fs/promises";
 import { basename as basename2, join as join6 } from "path";
 import { isCancel as isCancel4, multiselect, select as select4 } from "@clack/prompts";
@@ -29495,13 +29612,9 @@ function setupCommand(projectRoot, hosts) {
   if (hosts.every((h) => h.value === "claude")) return "/iamu:init";
   return "/iamu-setup   (Claude Code: /iamu:init)";
 }
-function detectTargetPort(projectRoot) {
-  if (process.env.PORT) {
-    const p = Number.parseInt(process.env.PORT, 10);
-    if (!Number.isNaN(p) && p > 0 && p <= 65535) return p;
-  }
+function detectDirPort(dir) {
   for (const envFile of [".env.local", ".env.development", ".env"]) {
-    const fullPath = join6(projectRoot, envFile);
+    const fullPath = join6(dir, envFile);
     if (existsSync13(fullPath)) {
       try {
         const content = readFileSync6(fullPath, "utf-8");
@@ -29527,7 +29640,29 @@ function detectTargetPort(projectRoot) {
       }
     }
   }
-  const pkgPath = join6(projectRoot, "package.json");
+  for (const f of [
+    "vite.config.ts",
+    "vite.config.js",
+    "vite.config.mjs",
+    "vite.config.cjs",
+    "astro.config.mjs",
+    "astro.config.ts",
+    "astro.config.js"
+  ]) {
+    const cfgPath = join6(dir, f);
+    if (existsSync13(cfgPath)) {
+      try {
+        const raw = readFileSync6(cfgPath, "utf-8");
+        const portMatch = raw.match(/\bport\s*:\s*(\d{2,5})\b/);
+        if (portMatch) {
+          const p = Number.parseInt(portMatch[1], 10);
+          if (!Number.isNaN(p) && p > 0 && p <= 65535) return p;
+        }
+      } catch {
+      }
+    }
+  }
+  const pkgPath = join6(dir, "package.json");
   if (existsSync13(pkgPath)) {
     try {
       const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
@@ -29546,11 +29681,12 @@ function detectTargetPort(projectRoot) {
       };
       if ("astro" in allDeps) return 4321;
       if ("vite" in allDeps) return 5173;
+      if ("next" in allDeps) return 3e3;
     } catch {
     }
   }
   for (const f of ["astro.config.mjs", "astro.config.ts", "astro.config.js"]) {
-    if (existsSync13(join6(projectRoot, f))) return 4321;
+    if (existsSync13(join6(dir, f))) return 4321;
   }
   for (const f of [
     "vite.config.ts",
@@ -29558,7 +29694,47 @@ function detectTargetPort(projectRoot) {
     "vite.config.mjs",
     "vite.config.cjs"
   ]) {
-    if (existsSync13(join6(projectRoot, f))) return 5173;
+    if (existsSync13(join6(dir, f))) return 5173;
+  }
+  return void 0;
+}
+function detectTargetPort(projectRoot) {
+  if (process.env.PORT) {
+    const p = Number.parseInt(process.env.PORT, 10);
+    if (!Number.isNaN(p) && p > 0 && p <= 65535) return p;
+  }
+  const rootPort = detectDirPort(projectRoot);
+  if (rootPort !== void 0) return rootPort;
+  const preferredSubdirs = [
+    "apps/web",
+    "apps/app",
+    "apps/frontend",
+    "apps/client",
+    "packages/web",
+    "packages/app",
+    "packages/frontend",
+    "web",
+    "frontend",
+    "client"
+  ];
+  for (const rel of preferredSubdirs) {
+    const full = join6(projectRoot, rel);
+    if (existsSync13(full)) {
+      const p = detectDirPort(full);
+      if (p !== void 0) return p;
+    }
+  }
+  for (const parent of ["apps", "packages"]) {
+    const parentDir = join6(projectRoot, parent);
+    if (!existsSync13(parentDir)) continue;
+    try {
+      for (const entry of readdirSync3(parentDir, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        const p = detectDirPort(join6(parentDir, entry.name));
+        if (p !== void 0) return p;
+      }
+    } catch {
+    }
   }
   return void 0;
 }
@@ -29566,8 +29742,9 @@ function detectTargetUrl(projectRoot) {
   const port = detectTargetPort(projectRoot);
   return port ? `http://localhost:${port}` : "http://localhost:3000";
 }
-function createDraftTestabilityContent(targetUrl = "http://localhost:3000") {
+function createDraftTestabilityContent(targetUrl = "http://localhost:3000", status2 = "draft") {
   const doc = emptyTestability(targetUrl);
+  doc.frontmatter.status = status2;
   return serializeFrontmatter(doc.frontmatter, doc.body);
 }
 async function init(opts) {
@@ -29591,12 +29768,28 @@ async function init(opts) {
   if (existsSync13(join6(iamuDir2, "config.json"))) {
     const testabilityPath2 = join6(iamuDir2, "testability.md");
     if (!existsSync13(testabilityPath2)) {
-      const targetUrl = detectTargetUrl(projectRoot);
+      const targetUrl = options.target || detectTargetUrl(projectRoot);
       await writeFile3(
         testabilityPath2,
-        createDraftTestabilityContent(targetUrl)
+        createDraftTestabilityContent(
+          targetUrl,
+          options.target ? "verified" : "draft"
+        )
       );
       backfilled.push("testability.md");
+    } else if (options.target) {
+      const existing = await readTestability(projectRoot);
+      const fm = existing?.frontmatter ?? {
+        schema_version: 1,
+        status: "verified",
+        target_url: options.target
+      };
+      fm.target_url = options.target;
+      fm.status = "verified";
+      await writeFile3(
+        testabilityPath2,
+        serializeFrontmatter(fm, existing?.body ?? "")
+      );
     }
     const contextPath2 = join6(iamuDir2, "context.yml");
     if (!existsSync13(contextPath2)) {
@@ -29684,10 +29877,13 @@ async function init(opts) {
     );
     const testabilityPath2 = join6(iamuDir2, "testability.md");
     if (!existsSync13(testabilityPath2)) {
-      const targetUrl = detectTargetUrl(projectRoot);
+      const targetUrl = options.target || detectTargetUrl(projectRoot);
       await writeFile3(
         testabilityPath2,
-        createDraftTestabilityContent(targetUrl)
+        createDraftTestabilityContent(
+          targetUrl,
+          options.target ? "verified" : "draft"
+        )
       );
     }
   }
@@ -29804,6 +30000,9 @@ async function init(opts) {
       }
     }
   }
+  const testabilityDoc = await readTestability(projectRoot).catch(() => null);
+  const configuredTarget = testabilityDoc?.frontmatter.target_url ?? detectTargetUrl(projectRoot);
+  const targetStatus = testabilityDoc?.frontmatter.status ?? "draft";
   if (options.json) {
     console.log(
       JSON.stringify(
@@ -29813,6 +30012,8 @@ async function init(opts) {
           projectRoot,
           fresh: freshInit,
           backfilled,
+          targetUrl: configuredTarget,
+          targetStatus,
           tools: selectedHosts.map((h) => h.name),
           skillsCount: totalSkills,
           commandsCount: totalCommands,
@@ -29834,6 +30035,9 @@ async function init(opts) {
       )
     );
     console.log();
+    console.log(
+      `  ${chalk27.dim("Target:")}    ${chalk27.cyan(configuredTarget)} ${chalk27.dim(targetStatus === "verified" ? "(verified)" : "(detected \u2014 change anytime with `iamu set testability --target <url>`)")}`
+    );
     if (selectedHosts.length > 0) {
       const toolNames = selectedHosts.map((h) => h.name).join(", ");
       console.log(
@@ -29982,6 +30186,10 @@ async function status(opts) {
   const incompleteRuns = await listIncompleteRuns(projectRoot);
   const { rerun } = await computeFixStates(projectRoot);
   const staleSkills = await findStaleSkills(projectRoot);
+  const testability = await readTestability(projectRoot).catch(() => null);
+  const designState = await readDesignSources(projectRoot).catch(() => null);
+  const designDocs = designState?.file.files.filter((f) => f.kind === "design") ?? [];
+  const offerDesignTemplate = designDocs.length === 0 ? await shouldOfferTemplate(projectRoot).catch(() => false) : false;
   let exploreSummary = null;
   try {
     const maps = await listExploreMaps(projectRoot);
@@ -30007,6 +30215,21 @@ async function status(opts) {
         {
           project: projectStatus.project.name,
           mode: projectStatus.cloud.linked ? "cloud-linked" : "local-only",
+          target: testability ? {
+            url: testability.frontmatter.target_url,
+            status: testability.frontmatter.status ?? "draft",
+            dev_command: testability.frontmatter.dev_command ?? null,
+            auth_strategy: testability.frontmatter.auth_strategy ?? null,
+            access: testability.frontmatter.access ?? null
+          } : null,
+          design: {
+            recorded: designDocs.map((f) => f.path),
+            sources: designState?.file.files.map((f) => ({
+              path: f.path,
+              kind: f.kind
+            })) ?? [],
+            offer_template: offerDesignTemplate
+          },
           entities: Object.fromEntries(
             Object.entries(projectStatus.entities).map(([k, v]) => [
               k,
@@ -30092,6 +30315,18 @@ async function status(opts) {
     console.log(`  ${padRight(label, 14)} ${num2}${inv}`);
   }
   if (!quiet) console.log();
+  if (testability?.frontmatter.target_url) {
+    const tfm = testability.frontmatter;
+    const isVerified = tfm.status === "verified";
+    const meta = [
+      isVerified ? "verified" : "unverified",
+      tfm.auth_strategy ? `auth: ${tfm.auth_strategy}` : null,
+      tfm.dev_command ? `dev: ${tfm.dev_command}` : null
+    ].filter(Boolean).join(" \xB7 ");
+    console.log(
+      `  ${padRight("target", 14)} ${chalk28.cyan(tfm.target_url)}${chalk28.dim(`  (${meta})`)}${!isVerified ? chalk28.dim(" \u2014 `iamu set testability --target <url>`") : ""}`
+    );
+  }
   let ctxLabel = chalk28.dim("none");
   if (projectStatus.context.present) {
     if (projectStatus.context.richness === "thin") {
@@ -30102,6 +30337,19 @@ async function status(opts) {
     }
   }
   console.log(`  ${padRight("context", 14)} ${ctxLabel}`);
+  if (designDocs.length > 0) {
+    console.log(
+      `  ${padRight("design", 14)} ${chalk28.green(designDocs.map((f) => f.path).join(", "))}`
+    );
+  } else if (offerDesignTemplate) {
+    console.log(
+      `  ${padRight("design", 14)} ${chalk28.yellow("none")}${chalk28.dim("  (general craft only \u2014 run `iamu-design` so runs check your own design rules)")}`
+    );
+  } else {
+    console.log(
+      `  ${padRight("design", 14)} ${chalk28.dim("none  (general craft)")}`
+    );
+  }
   console.log(
     `  ${padRight("runs", 14)} ${runs.length === 0 ? chalk28.dim("0") : chalk28.cyan(String(runs.length))}${runs.length > 0 ? chalk28.dim("  last: " + runs.at(-1)) : ""}`
   );
@@ -30441,7 +30689,8 @@ async function fillOrSelect(el, text, submit) {
   if (submit) await el.press("Enter");
 }
 async function markAndQueryIndexedElements(page) {
-  return page.evaluate((selector) => {
+  if (typeof page.evaluate !== "function") return [];
+  const evaluated = await page.evaluate((selector) => {
     const g = globalThis;
     function collectElements(root) {
       const result = [];
@@ -30466,6 +30715,41 @@ async function markAndQueryIndexedElements(page) {
     }
     const elements = collectElements(g.document);
     const results = [];
+    function normalizeText(raw) {
+      return (raw || "").trim().replace(/\s+/g, " ").slice(0, 80);
+    }
+    function getAssociatedLabel(el) {
+      const labelledBy = el.getAttribute("aria-labelledby");
+      if (labelledBy && typeof g.document.getElementById === "function") {
+        const parts = [];
+        for (const id of labelledBy.split(/\s+/)) {
+          if (!id) continue;
+          const node = g.document.getElementById(id);
+          const txt = normalizeText(node?.textContent);
+          if (txt) parts.push(txt);
+        }
+        if (parts.length > 0) return normalizeText(parts.join(" "));
+      }
+      if (el.labels && el.labels.length > 0) {
+        const parts = [];
+        for (let i = 0; i < el.labels.length; i++) {
+          const lbl = el.labels[i];
+          const txt = normalizeText(lbl?.innerText ?? lbl?.textContent);
+          if (txt) parts.push(txt);
+        }
+        if (parts.length > 0) return normalizeText(parts.join(" "));
+      }
+      if (typeof el.closest === "function") {
+        const parentLabel = el.closest("label");
+        if (parentLabel) {
+          const txt = normalizeText(
+            parentLabel.innerText ?? parentLabel.textContent
+          );
+          if (txt) return txt;
+        }
+      }
+      return "";
+    }
     let count = 0;
     for (const el of elements) {
       const style = g.getComputedStyle(el);
@@ -30480,7 +30764,10 @@ async function markAndQueryIndexedElements(page) {
       const roleAttr = el.getAttribute("role");
       const type2 = tag === "input" ? el.type?.toLowerCase() || "text" : void 0;
       const disabled = Boolean(el.disabled) || el.getAttribute("aria-disabled") === "true";
-      const name = el.getAttribute("aria-label") || el.getAttribute("title") || el.placeholder || (tag === "input" || tag === "textarea" ? el.value : "") || (el.textContent || "").trim().slice(0, 80).replace(/\s+/g, " ") || "";
+      const isCheckable = type2 === "radio" || type2 === "checkbox" || roleAttr === "radio" || roleAttr === "checkbox" || roleAttr === "switch";
+      const checked = isCheckable ? Boolean(el.checked) || el.getAttribute("aria-checked") === "true" : void 0;
+      const labelText = tag === "input" || tag === "select" || tag === "textarea" ? getAssociatedLabel(el) : "";
+      const name = normalizeText(el.getAttribute("aria-label")) || labelText || normalizeText(el.getAttribute("title")) || normalizeText(el.placeholder) || (tag === "input" || tag === "textarea" ? normalizeText(el.value) : "") || normalizeText(el.textContent) || "";
       const role = roleAttr || (tag === "button" ? "button" : tag === "a" ? "link" : tag === "input" ? type2 || "textbox" : tag === "select" ? "combobox" : tag);
       results.push({
         index: count,
@@ -30488,11 +30775,38 @@ async function markAndQueryIndexedElements(page) {
         role,
         name,
         ...type2 ? { type: type2 } : {},
-        ...disabled ? { disabled: true } : {}
+        ...disabled ? { disabled: true } : {},
+        ...checked ? { checked: true } : {}
       });
     }
     return results;
   }, INDEXED_SELECTOR);
+  return Array.isArray(evaluated) ? evaluated : [];
+}
+async function clickLocatorWithFallback(loc, timeoutMs = ACTION_TIMEOUT_MS) {
+  if (typeof loc.count !== "function") {
+    await loc.click({ timeout: timeoutMs });
+    return;
+  }
+  const presentCount = await loc.count().catch(() => 0);
+  if (presentCount > 0) {
+    try {
+      await loc.click({ timeout: 250 });
+      return;
+    } catch (err) {
+      if (typeof loc.evaluate === "function") {
+        await loc.evaluate((node) => {
+          const el = node;
+          if (typeof el.click === "function") {
+            el.click();
+          }
+        });
+        return;
+      }
+      throw err;
+    }
+  }
+  await loc.click({ timeout: Math.min(timeoutMs, 1500) });
 }
 async function clickIndexedElement(page, index) {
   let loc = page.locator(`[data-iamu-index="${index}"]`);
@@ -30505,7 +30819,19 @@ async function clickIndexedElement(page, index) {
       `Nothing on the page matches interactive element [#${index}]. Run \`iamu browse snapshot --indexed\` to view available elements.`
     );
   }
-  await loc.first().click({ timeout: ACTION_TIMEOUT_MS });
+  const first = loc.first();
+  try {
+    await first.click({ timeout: 250 });
+  } catch (err) {
+    if (typeof first.evaluate === "function") {
+      await first.evaluate((node) => {
+        const el = node;
+        if (typeof el.click === "function") el.click();
+      });
+      return;
+    }
+    throw err;
+  }
 }
 async function fillIndexedElement(page, index, text, submit) {
   let loc = page.locator(`[data-iamu-index="${index}"]`);
@@ -30639,13 +30965,24 @@ var init_browse_actions = __esm({
         usage: 'click <role> "<name>" [--nth N]',
         minArgs: 2,
         target: roleTarget,
-        run: (p, args2, opts) => byRole(p, args2[0], args2[1], opts).click({ timeout: ACTION_TIMEOUT_MS })
+        run: async (p, args2, opts) => {
+          const [role, name] = args2;
+          const loc = byRole(p, role, name, opts);
+          if ((role === "radio" || role === "checkbox") && typeof loc.count === "function" && await loc.count().catch(() => 1) === 0 && typeof p.locator === "function") {
+            const byValue = p.locator(`input[type="${role}"][value=${JSON.stringify(name)}]`).first();
+            if (await byValue.count().catch(() => 0) > 0) {
+              await clickLocatorWithFallback(byValue, 1500);
+              return;
+            }
+          }
+          await clickLocatorWithFallback(loc, ACTION_TIMEOUT_MS);
+        }
       },
       "click-text": {
         usage: 'click-text "<visible text>"',
         minArgs: 1,
         target: (args2) => `the text \u201C${args2[0]}\u201D`,
-        run: (p, args2) => p.getByText(args2[0]).first().click({ timeout: ACTION_TIMEOUT_MS })
+        run: (p, args2) => clickLocatorWithFallback(p.getByText(args2[0]).first(), ACTION_TIMEOUT_MS)
       },
       fill: fillAction("fill"),
       select: fillAction("select"),
@@ -30740,7 +31077,7 @@ var init_browse_actions = __esm({
 });
 
 // src/commands/browse-driver.ts
-import { execFile as execFile3, spawn } from "child_process";
+import { execFile as execFile3, execFileSync, spawn } from "child_process";
 import { readFile as readFile5 } from "fs/promises";
 async function probeCdp(port, timeoutMs = CDP_PROBE_TIMEOUT_MS) {
   try {
@@ -30755,7 +31092,29 @@ async function probeCdp(port, timeoutMs = CDP_PROBE_TIMEOUT_MS) {
   }
 }
 async function readProcessCommandLine(pid, platform2 = process.platform) {
-  if (!Number.isInteger(pid) || pid <= 0 || platform2 === "win32") return null;
+  if (!Number.isInteger(pid) || pid <= 0) return null;
+  if (platform2 === "win32") {
+    try {
+      const out2 = execFileSync(
+        "powershell.exe",
+        [
+          "-NoProfile",
+          "-NonInteractive",
+          "-Command",
+          `(Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}').CommandLine`
+        ],
+        {
+          encoding: "utf-8",
+          stdio: ["ignore", "pipe", "ignore"],
+          timeout: 3e3,
+          windowsHide: true
+        }
+      );
+      return out2.trim() || null;
+    } catch {
+      return null;
+    }
+  }
   if (platform2 === "linux") {
     const raw = await readFile5(`/proc/${pid}/cmdline`, "utf8").catch(() => "");
     if (raw) return raw.split("\0").join(" ").trim();
@@ -30770,13 +31129,32 @@ async function readProcessCommandLine(pid, platform2 = process.platform) {
   });
 }
 function isOurBrowser(commandLine, profileDir2) {
-  if (!commandLine) return false;
-  const flag = `--user-data-dir=${profileDir2}`;
-  for (let i = commandLine.indexOf(flag); i !== -1; ) {
-    const next = commandLine[i + flag.length];
-    if (next === void 0 || next === " ") return true;
-    i = commandLine.indexOf(flag, i + 1);
-  }
+  if (!commandLine || !BROWSER_NAME_RE.test(commandLine)) return false;
+  if (!profileDir2) return false;
+  const matches = (cmd, dir) => {
+    const flags = [
+      `--user-data-dir=${dir}`,
+      `--user-data-dir="${dir}"`,
+      `--user-data-dir='${dir}'`,
+      `--user-data-dir="${dir}`,
+      `--user-data-dir='${dir}`
+    ];
+    for (const flag of flags) {
+      for (let i = cmd.indexOf(flag); i !== -1; ) {
+        const next = cmd[i + flag.length];
+        if (next === void 0 || next === " " || next === "	" || next === "\r" || next === "\n" || next === `"` || next === `'`) {
+          return true;
+        }
+        i = cmd.indexOf(flag, i + 1);
+      }
+    }
+    return false;
+  };
+  if (matches(commandLine, profileDir2)) return true;
+  const normCmd = commandLine.replace(/\\/g, "/");
+  const normDir = profileDir2.replace(/\\/g, "/");
+  if (matches(normCmd, normDir)) return true;
+  if (matches(normCmd.toLowerCase(), normDir.toLowerCase())) return true;
   return false;
 }
 async function reapBrowser(pid, profileDir2, driver) {
@@ -30785,15 +31163,28 @@ async function reapBrowser(pid, profileDir2, driver) {
   driver.kill(pid);
   return true;
 }
+function selectTargetPage(rawPages, pageIndex) {
+  const nonDevtools = rawPages.filter((p) => !p.url().startsWith("devtools:"));
+  const userPages = nonDevtools.filter(
+    (p) => !/^(?:chrome-extension|chrome|edge):/i.test(p.url())
+  );
+  const pages = userPages.length > 0 ? userPages : nonDevtools;
+  if (pageIndex !== void 0 && pages[pageIndex]) {
+    return { page: pages[pageIndex], pages };
+  }
+  const preferred = pages.filter((p) => p.url() && p.url() !== "about:blank").at(-1);
+  return { page: preferred ?? pages.at(-1), pages };
+}
 async function connect(port) {
   const { chromium } = await import("playwright-core");
   return chromium.connectOverCDP(`http://127.0.0.1:${port}`);
 }
-var CDP_PROBE_TIMEOUT_MS, cdpDriver;
+var CDP_PROBE_TIMEOUT_MS, BROWSER_NAME_RE, cdpDriver;
 var init_browse_driver = __esm({
   "src/commands/browse-driver.ts"() {
     "use strict";
     CDP_PROBE_TIMEOUT_MS = 1e3;
+    BROWSER_NAME_RE = /(?:chrome|chromium|brave|msedge)/i;
     cdpDriver = {
       isRunning: (port) => probeCdp(port),
       launch(chrome, args2) {
@@ -30834,9 +31225,11 @@ var init_browse_driver = __esm({
         });
         try {
           const context = browser.contexts()[0] ?? await browser.newContext();
-          const pages = context.pages().filter((p) => !p.url().startsWith("devtools:"));
-          const targetPage = pageIndex !== void 0 && pages[pageIndex] || pages.at(-1) || await context.newPage();
-          const page = targetPage;
+          const { page: targetPage, pages } = selectTargetPage(
+            context.pages(),
+            pageIndex
+          );
+          const page = targetPage ?? await context.newPage();
           const dialogs = [];
           page.on("dialog", (dialog) => {
             const type2 = dialog.type();
@@ -30869,15 +31262,28 @@ var init_browse_driver = __esm({
         }
       },
       commandLine: (pid) => readProcessCommandLine(pid),
-      kill(pid) {
+      kill(pid, signal = "SIGTERM") {
         try {
-          if (process.platform !== "win32") {
-            try {
-              process.kill(-pid, "SIGTERM");
-            } catch {
+          if (process.platform === "win32") {
+            if (signal === "SIGKILL") {
+              try {
+                execFileSync("taskkill", ["/PID", String(pid), "/T", "/F"], {
+                  stdio: "ignore",
+                  timeout: 3e3,
+                  windowsHide: true
+                });
+                return;
+              } catch {
+              }
             }
+            process.kill(pid, signal);
+            return;
+          }
+          try {
+            process.kill(-pid, signal);
+          } catch {
           }
-          process.kill(pid, "SIGTERM");
+          process.kill(pid, signal);
         } catch {
         }
       }
@@ -30940,7 +31346,7 @@ __export(step_exports, {
   recordStep: () => recordStep,
   stepCommand: () => stepCommand
 });
-import { copyFile, mkdir as mkdir5, stat as stat2 } from "fs/promises";
+import { copyFile, mkdir as mkdir5, rename, stat as stat2 } from "fs/promises";
 import path56 from "path";
 import chalk29 from "chalk";
 function parseMaxSteps(val) {
@@ -30975,11 +31381,18 @@ async function recordStep(input) {
     let finalScreenshotPath = null;
     if (shotSource) {
       const destName = `step-${stepNumber2}.png`;
-      finalScreenshotPath = path56.join(screenshotsDir, destName);
-      if (path56.resolve(finalScreenshotPath) !== shotSource) {
-        await copyFile(shotSource, finalScreenshotPath);
+      const destPath = path56.join(screenshotsDir, destName);
+      finalScreenshotPath = destPath;
+      if (path56.resolve(destPath) !== shotSource) {
+        if (input.moveShot) {
+          await rename(shotSource, destPath).catch(
+            () => copyFile(shotSource, destPath)
+          );
+        } else {
+          await copyFile(shotSource, destPath);
+        }
       }
-      screenshotRef = path56.join("screenshots", destName);
+      screenshotRef = path56.posix.join("screenshots", destName);
     }
     const parsedStep = runStepSchema.parse({
       step_number: stepNumber2,
@@ -31072,7 +31485,7 @@ async function stepCommand(runArg, opts) {
             {
               step_number: res.step.step_number,
               cancelled: true,
-              path: path56.relative(projectRoot, res.stepPath),
+              path: path56.relative(projectRoot, res.stepPath).split(path56.sep).join("/"),
               action: res.step.action,
               note: res.step.note,
               url: res.step.url,
@@ -31100,7 +31513,7 @@ async function stepCommand(runArg, opts) {
         JSON.stringify(
           {
             step_number: res.step.step_number,
-            path: path56.relative(projectRoot, res.stepPath),
+            path: path56.relative(projectRoot, res.stepPath).split(path56.sep).join("/"),
             action: res.step.action,
             note: res.step.note,
             url: res.step.url,
@@ -31174,8 +31587,10 @@ __export(browse_exports, {
   detectAntiBotChallenge: () => detectAntiBotChallenge,
   findChrome: () => findChrome,
   isHeadlessEnvironment: () => isHeadlessEnvironment,
+  parseActionCommand: () => parseActionCommand,
   parseViewport: () => parseViewport,
   readBrowseState: () => readBrowseState,
+  resilientAriaSnapshot: () => resilientAriaSnapshot,
   shouldDisableSandbox: () => shouldDisableSandbox,
   start: () => start,
   waitForVisualStability: () => waitForVisualStability,
@@ -31240,7 +31655,10 @@ function findChrome(env = process.env, platform2 = process.platform, exists = ex
   ] : platform2 === "win32" ? [
     `${env.PROGRAMFILES ?? "C:\\Program Files"}\\Google\\Chrome\\Application\\chrome.exe`,
     `${env["PROGRAMFILES(X86)"] ?? "C:\\Program Files (x86)"}\\Google\\Chrome\\Application\\chrome.exe`,
-    `${env.LOCALAPPDATA ?? ""}\\Google\\Chrome\\Application\\chrome.exe`
+    `${env.LOCALAPPDATA ?? ""}\\Google\\Chrome\\Application\\chrome.exe`,
+    `${env.PROGRAMFILES ?? "C:\\Program Files"}\\Microsoft\\Edge\\Application\\msedge.exe`,
+    `${env["PROGRAMFILES(X86)"] ?? "C:\\Program Files (x86)"}\\Microsoft\\Edge\\Application\\msedge.exe`,
+    `${env.LOCALAPPDATA ?? ""}\\Microsoft\\Edge\\Application\\msedge.exe`
   ] : [
     "/usr/bin/google-chrome",
     "/usr/bin/google-chrome-stable",
@@ -31429,7 +31847,7 @@ function checkAndRecordStagnation(projectRoot, runId, fingerprint, action) {
   }
   return { count };
 }
-async function waitForVisualStability(page, maxWaitMs = 300) {
+async function waitForVisualStability(page, maxWaitMs = 150) {
   let timer;
   try {
     const nodeTimeout = new Promise((resolve3) => {
@@ -31531,7 +31949,7 @@ async function detectAntiBotChallenge(page, allowEvaluate = true) {
   }
   return void 0;
 }
-async function withPage(opts, driver, fn, target) {
+async function withPage(opts, driver, fn, target, onPostShot) {
   const state = readBrowseState();
   if (!state) {
     fail(NO_BROWSER, opts);
@@ -31541,23 +31959,53 @@ async function withPage(opts, driver, fn, target) {
   try {
     attached = state.activeTabIndex !== void 0 ? await driver.attach(state.port, state.activeTabIndex) : await driver.attach(state.port);
   } catch {
-    fail(NO_BROWSER, opts);
-    return null;
+    const chrome = findChrome();
+    if (!chrome) {
+      fail(NO_BROWSER, opts);
+      return null;
+    }
+    try {
+      if (state.pid) {
+        await reapBrowser(state.pid, profileDir(), driver);
+      }
+      const headless = state.headless ?? isHeadlessEnvironment(opts);
+      const pid = driver.launch(chrome, chromeArgs(opts, state.port, headless));
+      let running = false;
+      for (let i = 0; i < 25; i++) {
+        if (await driver.isRunning(state.port)) {
+          running = true;
+          break;
+        }
+        await new Promise((r) => setTimeout(r, 200));
+      }
+      if (!running) {
+        fail(NO_BROWSER, opts);
+        return null;
+      }
+      writeState({ ...state, pid, headless });
+      attached = state.activeTabIndex !== void 0 ? await driver.attach(state.port, state.activeTabIndex) : await driver.attach(state.port);
+    } catch {
+      fail(NO_BROWSER, opts);
+      return null;
+    }
   }
   const { page } = attached;
   try {
     if (state.viewport) {
-      await page.setViewportSize(state.viewport);
-      if (state.viewport.width <= 500 && typeof page.context === "function") {
-        try {
-          const context = page.context();
-          if (context && typeof context.newCDPSession === "function") {
-            const cdp = await context.newCDPSession(page);
-            await cdp.send("Emulation.setTouchEmulationEnabled", {
-              enabled: true
-            });
+      const currentVp = typeof page.viewportSize === "function" ? page.viewportSize() : null;
+      if (!currentVp || currentVp.width !== state.viewport.width || currentVp.height !== state.viewport.height) {
+        await page.setViewportSize(state.viewport);
+        if (state.viewport.width <= 500 && typeof page.context === "function") {
+          try {
+            const context = page.context();
+            if (context && typeof context.newCDPSession === "function") {
+              const cdp = await context.newCDPSession(page);
+              await cdp.send("Emulation.setTouchEmulationEnabled", {
+                enabled: true
+              });
+            }
+          } catch {
           }
-        } catch {
         }
       }
     }
@@ -31582,9 +32030,12 @@ async function withPage(opts, driver, fn, target) {
         }).catch(() => void 0);
       }
     }
+    if (onPostShot) {
+      await onPostShot(page);
+    }
     const dialogs = attached.dialogs ?? [];
     const dialog = dialogs.length > 0 ? dialogs.join("; ") : void 0;
-    const challenge = await detectAntiBotChallenge(page, Boolean(opts.shot));
+    const challenge = opts.shot ? await detectAntiBotChallenge(page, true) : void 0;
     return {
       url: page.url(),
       title: await page.title(),
@@ -31624,70 +32075,89 @@ function reportPage(opts, result, extra = {}) {
     human
   );
 }
+async function resilientAriaSnapshot(page) {
+  try {
+    return await page.locator("body").ariaSnapshot({ timeout: 5e3 }) ?? "";
+  } catch (originalErr) {
+    try {
+      return await page.locator(":root").ariaSnapshot({ timeout: 3e3 }) ?? "";
+    } catch {
+      if (page.url() === "about:blank") {
+        return "";
+      }
+      throw originalErr;
+    }
+  }
+}
+function formatIndexedElementLine(el) {
+  return `  [#${el.index}] ${el.role}${el.name ? ` "${el.name}"` : ""}${el.checked ? " [checked]" : ""}${el.disabled ? " [disabled]" : ""}`;
+}
+async function captureSnapshotWithFrames(p, includeIndexed) {
+  let snapshot = await resilientAriaSnapshot(p);
+  if (typeof p.frames === "function") {
+    const childFrames = p.frames().filter((f) => {
+      try {
+        return f !== (typeof p.mainFrame === "function" ? p.mainFrame() : null);
+      } catch {
+        return false;
+      }
+    });
+    if (childFrames.length > 0) {
+      const frameSnapshots = [];
+      for (let i = 0; i < childFrames.length; i++) {
+        const f = childFrames[i];
+        const frameUrl = typeof f.url === "function" ? f.url() : "";
+        if (!frameUrl || frameUrl === "about:blank") continue;
+        const frameName = (typeof f.name === "function" ? f.name() : "") || `frame-${i + 1}`;
+        try {
+          const snap = await f.locator("body").ariaSnapshot({ timeout: 1500 });
+          if (snap && snap.trim()) {
+            frameSnapshots.push(
+              `[Iframe: ${frameName} (${frameUrl})]
+${snap.trim()}`
+            );
+          }
+        } catch {
+        }
+      }
+      if (frameSnapshots.length > 0) {
+        snapshot = `${snapshot}
+
+${frameSnapshots.join("\n\n")}`;
+      }
+    }
+  }
+  let elements = [];
+  if (includeIndexed) {
+    elements = await markAndQueryIndexedElements(p);
+  }
+  const formatted = includeIndexed ? [
+    "Interactive elements:",
+    ...elements.map(formatIndexedElementLine),
+    "",
+    "Accessibility snapshot:",
+    snapshot
+  ].join("\n") : snapshot;
+  return { snapshot, elements, formatted };
+}
 async function pageCommand(command, args2, opts, driver) {
   if (command === "snapshot") {
-    let snapshot = "";
-    let elements = [];
+    let captured;
     const result2 = await withPage(
       { ...opts, shot: void 0 },
       driver,
       async (p) => {
-        snapshot = await p.locator("body").ariaSnapshot();
-        if (typeof p.frames === "function") {
-          const childFrames = p.frames().filter((f) => {
-            try {
-              return f !== (typeof p.mainFrame === "function" ? p.mainFrame() : null);
-            } catch {
-              return false;
-            }
-          });
-          if (childFrames.length > 0) {
-            const frameSnapshots = [];
-            for (let i = 0; i < childFrames.length; i++) {
-              const f = childFrames[i];
-              const frameUrl = typeof f.url === "function" ? f.url() : "";
-              if (!frameUrl || frameUrl === "about:blank") continue;
-              const frameName = (typeof f.name === "function" ? f.name() : "") || `frame-${i + 1}`;
-              try {
-                const snap = await f.locator("body").ariaSnapshot({ timeout: 1500 });
-                if (snap && snap.trim()) {
-                  frameSnapshots.push(
-                    `[Iframe: ${frameName} (${frameUrl})]
-${snap.trim()}`
-                  );
-                }
-              } catch {
-              }
-            }
-            if (frameSnapshots.length > 0) {
-              snapshot = `${snapshot}
-
-${frameSnapshots.join("\n\n")}`;
-            }
-          }
-        }
-        if (opts.indexed) {
-          elements = await markAndQueryIndexedElements(p);
-        }
+        captured = await captureSnapshotWithFrames(p, Boolean(opts.indexed));
       }
     );
-    if (result2) {
+    if (result2 && captured) {
       if (opts.indexed) {
-        const lines = [
-          "Interactive elements:",
-          ...elements.map(
-            (el) => `  [#${el.index}] ${el.role}${el.name ? ` "${el.name}"` : ""}${el.disabled ? " [disabled]" : ""}`
-          ),
-          "",
-          "Accessibility snapshot:",
-          snapshot
-        ];
         reportPage(opts, result2, {
-          snapshot: lines.join("\n"),
-          interactive_elements: elements
+          snapshot: captured.formatted,
+          interactive_elements: captured.elements
         });
       } else {
-        reportPage(opts, result2, { snapshot });
+        reportPage(opts, result2, { snapshot: captured.snapshot });
       }
     }
     return;
@@ -31721,30 +32191,54 @@ ${frameSnapshots.join("\n\n")}`;
   if (args2.length < action.minArgs) {
     return fail(`Usage: iamu browse ${action.usage}`, opts);
   }
+  let gotoSnapshot;
   const result = await withPage(
     opts,
     driver,
     (p) => action.run(p, args2, opts),
-    action.target?.(args2)
+    action.target?.(args2),
+    command === "goto" && opts.snapshot !== false ? async (p) => {
+      if (typeof p.locator === "function") {
+        gotoSnapshot = await captureSnapshotWithFrames(p, true).catch(
+          () => void 0
+        );
+      }
+    } : void 0
   );
-  if (result) reportPage(opts, result);
+  if (result) {
+    const snap = gotoSnapshot;
+    const hasSnapshot = snap && (snap.snapshot.length > 0 || snap.elements.length > 0);
+    reportPage(
+      opts,
+      result,
+      hasSnapshot ? {
+        snapshot: snap.formatted,
+        interactive_elements: snap.elements
+      } : {}
+    );
+  }
 }
-function printStep(opts, record, projectRoot, stagnationWarning, challengeWarning) {
+function printStep(opts, record, projectRoot, stagnationWarning, challengeWarning, stepSnapshot) {
   const { step } = record;
   const warnings = [challengeWarning, stagnationWarning].filter(
     Boolean
   );
+  const hasSnapshot = stepSnapshot && (stepSnapshot.snapshot.length > 0 || stepSnapshot.elements.length > 0);
   if (opts.json) {
     const doc = {
       step_number: step.step_number,
-      path: path57.relative(projectRoot, record.stepPath),
+      path: path57.relative(projectRoot, record.stepPath).split(path57.sep).join("/"),
       action: step.action,
       note: step.note,
       url: step.url,
       screenshot: step.screenshot,
       surface: step.surface,
       ...warnings.length > 0 ? { warning: warnings.join(" | ") } : {},
-      ...record.cancelled ? { cancelled: true } : {}
+      ...record.cancelled ? { cancelled: true } : {},
+      ...hasSnapshot ? {
+        snapshot: stepSnapshot.formatted,
+        interactive_elements: stepSnapshot.elements
+      } : {}
     };
     console.log(JSON.stringify(doc, null, 2));
     return;
@@ -31778,6 +32272,9 @@ function printStep(opts, record, projectRoot, stagnationWarning, challengeWarnin
       console.log(`    ${symbols.warning}  ${chalk30.yellow(w)}`);
     }
   }
+  if (hasSnapshot) {
+    console.log(stepSnapshot.formatted);
+  }
 }
 async function clearOriginStorage(origin, driver = cdpDriver, returnTo) {
   const state = readBrowseState();
@@ -31868,6 +32365,45 @@ async function clearStorage(opts, driver) {
     `    opened ${returnTo}`
   ]);
 }
+function parseActionCommand(raw) {
+  const tokens = [];
+  let current = "";
+  let quote = null;
+  let hasToken = false;
+  for (let i = 0; i < raw.length; i++) {
+    const ch = raw[i];
+    if (ch === "\\" && i + 1 < raw.length && quote !== "'") {
+      current += raw[++i];
+      hasToken = true;
+      continue;
+    }
+    if (quote) {
+      if (ch === quote) {
+        quote = null;
+      } else {
+        current += ch;
+      }
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      quote = ch;
+      hasToken = true;
+      continue;
+    }
+    if (/\s/.test(ch)) {
+      if (hasToken) {
+        tokens.push(current);
+        current = "";
+        hasToken = false;
+      }
+      continue;
+    }
+    current += ch;
+    hasToken = true;
+  }
+  if (hasToken) tokens.push(current);
+  return tokens;
+}
 async function browseStep(args2, opts, driver) {
   if (opts.stepFile) {
     try {
@@ -31888,9 +32424,17 @@ async function browseStep(args2, opts, driver) {
         if (Array.isArray(data.cmd)) {
           args2 = data.cmd.map(String);
         } else if (typeof data.cmd === "string") {
-          args2 = data.cmd.trim().split(/\s+/);
+          args2 = parseActionCommand(data.cmd.trim());
         }
       }
+      if (Array.isArray(data.then)) {
+        const extra = data.then.map(
+          (item) => Array.isArray(item) ? item.map(
+            (tok) => /[\s"']/.test(String(tok)) ? JSON.stringify(String(tok)) : String(tok)
+          ).join(" ") : String(item)
+        );
+        opts.then = [...opts.then ?? [], ...extra];
+      }
     } catch (err) {
       return fail(
         `Failed to read step payload from ${opts.stepFile}: ${err.message}`,
@@ -31926,6 +32470,29 @@ async function browseStep(args2, opts, driver) {
       opts
     );
   }
+  const chainedActions = [];
+  if (opts.then && opts.then.length > 0) {
+    for (const rawCmd of opts.then) {
+      const tokens = parseActionCommand(rawCmd.trim());
+      if (tokens.length === 0) continue;
+      const subName = tokens[0];
+      const subArgs = tokens.slice(1);
+      const subAction = findPageAction(subName);
+      if (!subAction) {
+        return fail(
+          `Unknown chained browse action "${subName}" in --then. Supported: ${Object.keys(PAGE_ACTIONS).join(", ")}.`,
+          opts
+        );
+      }
+      if (subArgs.length < subAction.minArgs) {
+        return fail(
+          `Usage for chained --then action: ${subAction.usage}`,
+          opts
+        );
+      }
+      chainedActions.push({ action: subAction, args: subArgs });
+    }
+  }
   const runDirPath = resolveRunDir(ctx.projectRoot, opts.run);
   if (!runDirPath) return;
   const maxSteps = parseMaxSteps(opts.maxSteps);
@@ -31937,12 +32504,25 @@ async function browseStep(args2, opts, driver) {
     "screenshots",
     `.pending-${randomUUID11()}.png`
   );
+  let stepSnapshot;
   try {
     const page = await withPage(
       { ...opts, shot: pendingShot },
       driver,
-      (p) => action.run(p, actionArgs, opts),
-      action.target?.(actionArgs)
+      async (p) => {
+        await action.run(p, actionArgs, opts);
+        for (const sub of chainedActions) {
+          await sub.action.run(p, sub.args, opts);
+        }
+      },
+      action.target?.(actionArgs),
+      opts.snapshot !== false ? async (p) => {
+        if (typeof p.locator === "function") {
+          stepSnapshot = await captureSnapshotWithFrames(p, true).catch(
+            () => void 0
+          );
+        }
+      } : void 0
     );
     if (!page) return;
     let stagnationWarning;
@@ -31977,6 +32557,7 @@ async function browseStep(args2, opts, driver) {
       action: opts.action,
       note: effectiveNote,
       shot: page.screenshot,
+      moveShot: true,
       url: page.url,
       surface: opts.surface ?? page.title ?? null,
       maxSteps
@@ -31986,7 +32567,8 @@ async function browseStep(args2, opts, driver) {
       record,
       ctx.projectRoot,
       stagnationWarning,
-      challengeWarning
+      challengeWarning,
+      stepSnapshot
     );
     if (record.cancelled) {
       if (!opts.json) {
@@ -32791,6 +33373,14 @@ import { spawnSync } from "child_process";
 import { existsSync as existsSync18, promises as fs61 } from "fs";
 import path58 from "path";
 import chalk32 from "chalk";
+function detectPackageManager(targetDir) {
+  if (existsSync18(path58.join(targetDir, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync18(path58.join(targetDir, "yarn.lock"))) return "yarn";
+  if (existsSync18(path58.join(targetDir, "bun.lockb")) || existsSync18(path58.join(targetDir, "bun.lock"))) {
+    return "bun";
+  }
+  return "npm";
+}
 async function detectPreflightCommand(targetDir) {
   const pkgPath = path58.join(targetDir, "package.json");
   if (existsSync18(pkgPath)) {
@@ -32799,10 +33389,8 @@ async function detectPreflightCommand(targetDir) {
       const pkg = JSON.parse(raw);
       const scripts = pkg.scripts || {};
       if (scripts.typecheck) {
-        return { command: "npm", args: ["run", "typecheck"] };
-      }
-      if (scripts.check) {
-        return { command: "npm", args: ["run", "check"] };
+        const pm = detectPackageManager(targetDir);
+        return { command: pm, args: ["run", "typecheck"] };
       }
     } catch {
     }
@@ -32811,11 +33399,6 @@ async function detectPreflightCommand(targetDir) {
   if (existsSync18(tsconfigPath)) {
     return { command: "npx", args: ["--no-install", "tsc", "--noEmit"] };
   }
-  const biomePath = path58.join(targetDir, "biome.json");
-  const biomecPath = path58.join(targetDir, "biome.jsonc");
-  if (existsSync18(biomePath) || existsSync18(biomecPath)) {
-    return { command: "npx", args: ["--no-install", "biome", "check"] };
-  }
   return null;
 }
 async function runPreflightCheck(targetDir) {
@@ -32824,7 +33407,7 @@ async function runPreflightCheck(targetDir) {
     return {
       ok: true,
       skipped: true,
-      reason: "No typecheck or lint scripts detected in project"
+      reason: "No typecheck script or tsconfig.json detected in project"
     };
   }
   const cmdString = `${detected.command} ${detected.args.join(" ")}`;
@@ -32832,20 +33415,22 @@ async function runPreflightCheck(targetDir) {
     cwd: targetDir,
     encoding: "utf8",
     timeout: 3e4,
-    stdio: ["ignore", "pipe", "pipe"]
+    stdio: ["ignore", "pipe", "pipe"],
+    shell: process.platform === "win32"
   });
-  const output = (proc.stdout || "") + (proc.stderr || "");
-  if (proc.status === 0) {
+  const combined = ((proc.stdout || "") + (proc.stderr || "")).trim();
+  const output = combined || (proc.error ? proc.error.message : "") || `Process exited with code ${proc.status ?? 1}`;
+  if (proc.status === 0 && !proc.error) {
     return {
       ok: true,
       command: cmdString,
-      output: output.trim()
+      output: combined
     };
   }
   return {
     ok: false,
     command: cmdString,
-    output: output.trim() || `Process exited with code ${proc.status ?? 1}`
+    output
   };
 }
 async function preflight(opts = {}) {
@@ -32861,7 +33446,7 @@ async function preflight(opts = {}) {
             skipped: !!result.skipped,
             command: result.command ?? null,
             reason: result.reason ?? null,
-            message: result.skipped ? "No typecheck or lint script detected; preflight skipped" : "Preflight check passed with 0 errors"
+            message: result.skipped ? "No typecheck script detected; preflight skipped" : "Preflight check passed with 0 errors"
           },
           null,
           2
@@ -32871,7 +33456,7 @@ async function preflight(opts = {}) {
     }
     if (result.skipped) {
       console.log(
-        chalk32.dim("\u25C7 Preflight skipped: no typecheck or lint scripts detected")
+        chalk32.dim("\u25C7 Preflight skipped: no typecheck script detected")
       );
     } else {
       console.log(
@@ -32897,9 +33482,7 @@ ${result.output}`,
     console.error(chalk32.dim(result.output));
   }
   console.error(
-    chalk32.yellow(
-      "\nFix compilation/lint errors before starting a walkthrough."
-    )
+    chalk32.yellow("\nFix compilation errors before starting a walkthrough.")
   );
   process.exit(1);
 }
@@ -32911,7 +33494,7 @@ var init_preflight = __esm({
 });
 
 // src/worktree-state.ts
-import { execFileSync } from "child_process";
+import { execFileSync as execFileSync2 } from "child_process";
 import { createHash as createHash6 } from "crypto";
 import {
   closeSync as closeSync3,
@@ -32923,7 +33506,7 @@ import {
 } from "fs";
 import path59 from "path";
 function git(args2, cwd) {
-  return execFileSync("git", args2, {
+  return execFileSync2("git", args2, {
     cwd,
     stdio: ["ignore", "pipe", "ignore"],
     timeout: GIT_TIMEOUT_MS2,
@@ -33056,7 +33639,7 @@ var init_worktree_state = __esm({
 });
 
 // src/build-info.ts
-import { execFileSync as execFileSync2 } from "child_process";
+import { execFileSync as execFileSync3 } from "child_process";
 import { readFileSync as readFileSync8 } from "fs";
 function nonEmpty(value) {
   const v = value?.trim();
@@ -33155,7 +33738,7 @@ var init_build_info = __esm({
     SHA_RE = /^[0-9a-f]{7,64}$/i;
     runGit = (args2, cwd) => {
       try {
-        const out2 = execFileSync2("git", args2, {
+        const out2 = execFileSync3("git", args2, {
           cwd,
           encoding: "utf8",
           stdio: ["ignore", "pipe", "ignore"],
@@ -33458,6 +34041,13 @@ async function listSingleType(projectRoot, type2, capabilityFilter, diffFilter,
         {
           header: "outline",
           value: (e) => e.frontmatter.outline ?? ""
+        },
+        {
+          header: "entry",
+          value: (e) => {
+            const sfm = e.frontmatter;
+            return chalk33.dim(sfm.entry_path ?? "/");
+          }
         }
       ]);
       break;
@@ -34431,6 +35021,9 @@ function applyChanges(type2, fm, opts) {
         opts.untestableBoundaries ? splitList(opts.untestableBoundaries) : null
       );
     }
+    if ((opts.target || opts.authStrategy || opts.access) && fm.status !== "verified") {
+      fm.status = "verified";
+    }
   } else if (type2 === "context") {
     if (opts.domain !== void 0) put("domain", opts.domain || null);
     if (opts.industry !== void 0) put("industry", opts.industry || null);
@@ -34946,21 +35539,39 @@ async function editEntity(type2, slug, opts = {}) {
   const ctx = await resolveProject(opts);
   if (!ctx) return;
   const { projectRoot } = ctx;
-  if (!ENTITY_TYPES.includes(type2)) {
+  const isSpecial = type2 === "testability" || type2 === "context";
+  if (!isSpecial && !ENTITY_TYPES.includes(type2)) {
     commandError(
-      `Unknown entity type "${type2}". Supported: ${ENTITY_TYPES.join(", ")}.`,
+      `Unknown entity type "${type2}". Supported: ${EDITABLE_TYPES.join(", ")}.`,
       { ...opts, code: "unknown_entity_type", fix: "iamu list" }
     );
     return;
   }
-  const dir = ENTITY_DIRS[type2];
-  const filePath = path62.join(projectRoot, "iamu", dir, `${slug}.md`);
+  if (!isSpecial && !slug) {
+    commandError(`A slug is required when editing a ${type2}.`, {
+      ...opts,
+      code: "missing_slug",
+      fix: `iamu edit ${type2} <slug>`
+    });
+    return;
+  }
+  const effectiveSlug = isSpecial ? type2 : slug;
+  const filePath = type2 === "testability" ? testabilityPath(projectRoot) : type2 === "context" ? contextPath(projectRoot) : path62.join(
+    projectRoot,
+    "iamu",
+    ENTITY_DIRS[type2],
+    `${effectiveSlug}.md`
+  );
   try {
     await fs64.access(filePath);
   } catch {
     commandError(
-      `${type2} "${slug}" not found at ${path62.relative(projectRoot, filePath)}.`,
-      { ...opts, code: "entity_not_found", fix: `iamu list ${type2}s` }
+      `${type2}${isSpecial ? "" : ` "${effectiveSlug}"`} not found at ${path62.relative(projectRoot, filePath)}.`,
+      {
+        ...opts,
+        code: "entity_not_found",
+        fix: isSpecial ? "iamu init" : `iamu list ${type2}s`
+      }
     );
     return;
   }
@@ -34970,7 +35581,7 @@ async function editEntity(type2, slug, opts = {}) {
       {
         ...opts,
         code: "non_interactive_environment",
-        fix: `iamu set ${type2} ${slug}`
+        fix: isSpecial ? `iamu set ${type2}` : `iamu set ${type2} ${effectiveSlug}`
       }
     );
     return;
@@ -34983,7 +35594,8 @@ async function editEntity(type2, slug, opts = {}) {
   const editorArgs = parts.slice(1).map((a) => a.replace(/^["']|["']$/g, ""));
   await new Promise((resolve3) => {
     const child = spawn2(editorCmd, [...editorArgs, filePath], {
-      stdio: "inherit"
+      stdio: "inherit",
+      shell: process.platform === "win32"
     });
     child.on("exit", (code) => {
       if (code !== 0) {
@@ -35013,7 +35625,7 @@ async function editEntity(type2, slug, opts = {}) {
   try {
     const content = await fs64.readFile(filePath, "utf8");
     const { frontmatter } = parseFrontmatter(content);
-    const schema2 = schemaByType[type2];
+    const schema2 = type2 === "testability" ? testabilityFrontmatterSchema : type2 === "context" ? contextFrontmatterSchema : schemaByType[type2];
     const parsed = schema2.safeParse(frontmatter);
     if (!parsed.success) {
       if (opts.json) {
@@ -35021,7 +35633,7 @@ async function editEntity(type2, slug, opts = {}) {
           JSON.stringify({
             valid: false,
             type: type2,
-            slug,
+            slug: effectiveSlug,
             path: filePath,
             errors: parsed.error.issues.map((i) => ({
               field: i.path.join(".") || "root",
@@ -35032,7 +35644,7 @@ async function editEntity(type2, slug, opts = {}) {
       } else {
         console.log();
         console.log(
-          `  ${symbols.warning} ${chalk38.yellow(`Validation failed for ${type2} "${slug}":`)}`
+          `  ${symbols.warning} ${chalk38.yellow(`Validation failed for ${type2}${isSpecial ? "" : ` "${effectiveSlug}"`}:`)}`
         );
         for (const issue of parsed.error.issues) {
           const field2 = issue.path.join(".") || "root";
@@ -35050,15 +35662,24 @@ async function editEntity(type2, slug, opts = {}) {
       return;
     }
     if (opts.json) {
-      console.log(JSON.stringify({ valid: true, type: type2, slug, path: filePath }));
+      console.log(
+        JSON.stringify({
+          valid: true,
+          type: type2,
+          slug: effectiveSlug,
+          path: filePath
+        })
+      );
       return;
     }
     console.log();
-    console.log(`  ${symbols.success} Validated ${type2} ${chalk38.cyan(slug)}`);
+    console.log(
+      `  ${symbols.success} Validated ${type2}${isSpecial ? "" : ` ${chalk38.cyan(effectiveSlug)}`}`
+    );
     console.log();
   } catch (err) {
     commandError(
-      `Failed to validate ${type2} "${slug}" after edit: ${err instanceof Error ? err.message : String(err)}`,
+      `Failed to validate ${type2}${isSpecial ? "" : ` "${effectiveSlug}"`} after edit: ${err instanceof Error ? err.message : String(err)}`,
       {
         ...opts,
         code: "validation_error",
@@ -35067,6 +35688,7 @@ async function editEntity(type2, slug, opts = {}) {
     );
   }
 }
+var EDITABLE_TYPES;
 var init_edit_entity = __esm({
   "src/commands/edit-entity.ts"() {
     "use strict";
@@ -35075,6 +35697,7 @@ var init_edit_entity = __esm({
     init_symbols();
     init_context4();
     init_validate();
+    EDITABLE_TYPES = [...ENTITY_TYPES, "testability", "context"];
   }
 });
 
@@ -35125,7 +35748,7 @@ async function settle(page, settleMs) {
   });
   await page.waitForLoadState("networkidle", { timeout: settleMs }).catch(() => {
   });
-  const spaSettle = Math.min(Math.max(settleMs, 50), 200);
+  const spaSettle = Math.min(Math.max(settleMs, 25), 60);
   await page.waitForTimeout(spaSettle).catch(() => {
   });
 }
@@ -35193,7 +35816,7 @@ async function crawl(page, opts) {
 }
 async function crawlFrom(page, opts, origin, takeBlocked) {
   const deny = opts.deny ?? [];
-  const settleMs = opts.settleMs ?? 1500;
+  const settleMs = opts.settleMs ?? 400;
   const { budget } = opts;
   const stats = {
     surfaces: 0,
@@ -36354,12 +36977,13 @@ async function startRun(scenarioSlugArg, opts) {
     return;
   }
   const fallbackTarget = await testabilityTarget2(projectRoot);
+  const targetSource = opts.target ? "--target" : fm.target_url ? `scenario (${scenarioSlug})` : fallbackTarget ? "iamu/testability.md" : null;
   const start2 = resolveStartUrl(opts.target, fm, fallbackTarget);
   if ("error" in start2) {
     commandError(start2.error, {
       ...opts,
       code: "invalid_target_url",
-      fix: `iamu set scenario ${scenarioSlug} --target <url>`
+      fix: "iamu set testability --target <url>"
     });
     return;
   }
@@ -36370,12 +36994,13 @@ async function startRun(scenarioSlugArg, opts) {
     const probe = await checkTargetReachable(start2.url);
     targetReachable = probe.reachable;
     if (!probe.reachable) {
-      targetWarning = `Target URL "${start2.url}" is unreachable (${probe.error ?? "connection refused"}). Ensure your product/dev server is running before recording steps.`;
+      const fixCmd = fm.target_url ? `iamu set testability --target <url> && iamu set scenario ${scenarioSlug} --no-target` : "iamu set testability --target <url>";
+      targetWarning = `Target URL "${start2.url}" is unreachable (${probe.error ?? "connection refused"}). Ensure your dev server is running, or update the URL with: ${fixCmd}`;
       if (opts.check === true) {
         commandError(targetWarning, {
           ...opts,
           code: "target_unreachable",
-          fix: `curl -I ${start2.url}`
+          fix: fixCmd
         });
         return;
       }
@@ -36465,6 +37090,7 @@ async function startRun(scenarioSlugArg, opts) {
           path: path64.relative(projectRoot, run.absPath),
           scenario_slug: scenarioSlug,
           target_url: start2.url,
+          target_source: targetSource,
           target_reachable: targetReachable,
           ...targetWarning ? { target_warning: targetWarning } : {},
           ...liveRes?.viewerUrl ? { live_viewer_url: liveRes.viewerUrl } : {},
@@ -36493,7 +37119,9 @@ async function startRun(scenarioSlugArg, opts) {
   console.log(`  ${chalk40.dim("scenario:")} ${scenarioSlug}`);
   console.log(`  ${chalk40.dim("persona:")}  ${fm.persona}`);
   console.log(`  ${chalk40.dim("outline:")}  ${fm.outline}`);
-  console.log(`  ${chalk40.dim("target:")}   ${start2.url}`);
+  console.log(
+    `  ${chalk40.dim("target:")}   ${start2.url}${targetSource ? chalk40.dim(` (from ${targetSource})`) : ""}`
+  );
   console.log(
     `  ${chalk40.dim("models:")}   walker: ${chalk40.cyan(walker)} \xB7 judge: ${chalk40.cyan(judge)} \xB7 matcher: ${chalk40.cyan(matcher)}`
   );
@@ -36569,14 +37197,18 @@ __export(instructions_walk_exports, {
   extractUntestableBoundaries: () => extractUntestableBoundaries,
   instructionsWalk: () => instructionsWalk,
   revisitSection: () => revisitSection,
+  selfCommand: () => selfCommand,
   viewportLine: () => viewportLine
 });
 import { existsSync as existsSync20, readFileSync as readFileSync10, writeFileSync as writeFileSync3 } from "fs";
 import { join as join10 } from "path";
 import chalk41 from "chalk";
-function selfCommand() {
-  const q = (p) => /[\s"'$]/.test(p) ? JSON.stringify(p) : p;
-  return `${q(process.execPath)} ${q(process.argv[1] ?? "iamu")}`;
+function selfCommand(execPath = process.execPath, scriptPath = process.argv[1] ?? "iamu") {
+  const q = (p) => {
+    const norm = p.replace(/\\/g, "/");
+    return /[\s"'$]/.test(norm) ? JSON.stringify(norm) : norm;
+  };
+  return `${q(execPath)} ${q(scriptPath)}`;
 }
 function viewportLine(v) {
   return `The browser is sized as ${SCREEN[v.device]}, ${v.width}\xD7${v.height}.`;
@@ -36585,18 +37217,20 @@ function browseSurface(iamu, viewport) {
   return [
     "`iamu browse` \u2014 a visible Chrome the orchestrator has already started.",
     "",
-    "Drive and record each step atomically in one command:",
+    "Drive and record each step atomically in one command (automatically saves the screenshot AND prints the updated `[#N]` interactive elements + accessibility snapshot):",
     `    ${iamu} browse step --run <run-id> --action "<action>" --note "<monologue>" <command> [args...]`,
     "",
+    "Chain consecutive form fills or actions on the same screen into a single step with `--then` (repeatable):",
+    `    ${iamu} browse step --run <run-id> --action "<action>" --note "<monologue>" fill-index 21 "2026-11-09" --then 'fill-index 22 "2026-11-20"'`,
+    "",
     "Supported commands (run with step or standalone):",
-    `    ${iamu} browse goto <url>`,
-    `    ${iamu} browse snapshot                  # ARIA roles + accessible names = what you see`,
-    `    ${iamu} browse snapshot --indexed        # Numbered interactive elements [#1], [#2]`,
+    `    ${iamu} browse goto <url>                    # Opens URL and prints [#N] elements + snapshot`,
+    `    ${iamu} browse snapshot --indexed        # Re-inspect current page (not needed after goto or step)`,
+    `    ${iamu} browse click-index <number>      # Click element by [#N] index (preferred, fast)`,
+    `    ${iamu} browse fill-index <number> "<text>" [--submit]`,
     `    ${iamu} browse click <role> "<name>" [--nth N]`,
     `    ${iamu} browse click-text "<visible text>"`,
-    `    ${iamu} browse click-index <number>      # Click element by [#N] index`,
     `    ${iamu} browse fill <role> "<name>" "<text>" [--submit]`,
-    `    ${iamu} browse fill-index <number> "<text>" [--submit]`,
     `    ${iamu} browse select <role> "<name>" "<option>"`,
     `    ${iamu} browse upload <role> "<name>" "<file-path>"`,
     `    ${iamu} browse upload-index <number> "<file-path>"`,
@@ -36609,7 +37243,11 @@ function browseSurface(iamu, viewport) {
     `    ${iamu} browse shot <png> [--full]`,
     `    ${iamu} browse wait [ms]                 # Wait for page/animations to settle`,
     "",
-    "Look at screenshots with your file-reading tool. Do not run `browse start` or `browse stop`, and do not drive the product any other way. The browser gives you no sound: you may report that an audio control gave no visible confirmation, never what the audio said.",
+    "Fast-driving rules:",
+    "\u2022 `browse goto` and `browse step` automatically print the fresh `[#N]` interactive elements and accessibility snapshot. Do NOT run `browse snapshot` after `browse goto` or `browse step`.",
+    "\u2022 Prefer `click-index <N>` and `fill-index <N>` using the `[#N]` indices from the previous step's output.",
+    "\u2022 Do NOT read step screenshot PNG files with your file-reading tool after routine steps \u2014 the snapshot output already shows all text, roles, and states. Only read a screenshot file if you suspect a visual rendering issue that contradicts the snapshot.",
+    "\u2022 Do not run `browse start` or `browse stop`, and do not drive the product any other way. The browser gives you no sound: you may report that an audio control gave no visible confirmation, never what the audio said.",
     ...viewport ? [viewportLine(viewport)] : []
   ].join("\n");
 }
@@ -36746,14 +37384,14 @@ function composeWalkerPrompt(p) {
     "The CLI handles step numbering, timestamps, screenshot capture/linking, and telemetry automatically.",
     `Screenshots to: ${rd}/screenshots/step-N.png \u2014 absolute paths.`,
     `Record findings with: ${iamu} new-finding --scenario ${p.scenarioSlug} --run ${p.runId} --step <N> --title "..." --type <helps|hinders|missing|irrelevant|incorrect> --severity <critical|major|minor|nit> --ui-fact "..." --consequence "..." --task-impact <blocks|impairs|slows|neutral|accelerates|enables> --confidence <high|medium|low> --need "<what you needed, no solution>" --description "..." --json`,
-    "`--step <N>` is the step whose screenshot shows the finding (or strength): it is the evidence people see next to the finding, so record that step and its screenshot first, and pick the screenshot where the thing is actually visible.",
+    "`--step <N>` is the step whose screenshot shows the finding (or strength): it is the evidence people see next to the finding, so record that step and its screenshot first, and pick the screenshot where the thing is actually visible. When recording multiple findings at the end of a screen or walk, batch them in a single shell command chained with `&&` (and you may chain `iamu summary` after them) rather than running one finding per turn.",
     `Before you finish, record synthesis with: ${iamu} summary ${p.runId} --reached "..." | --stopped "..." --worked "..." --worked "..." --question "..." [--setup-note "..."]. --reached: you got to what you came to do (the last thing you did and what the product showed); --stopped: you ended before it, and why. One of the two, always. --worked: what worked for this persona, one point each. --question: decisions for the product team the walk raised. --setup-note: doubts about the test setup (missing data, accounts, dates), never the product.`,
     `If the walk cannot start as it was set up \u2014 you cannot become this persona (the switch or login fails, or you are someone else), the world the situation needs is not there and you cannot create it, or the starting page does not load \u2014 stop immediately and end the walk with: ${iamu} summary ${p.runId} --blocked "<what was missing, as you saw it>". Do NOT record preliminary findings if preconditions are not met. That is about the setup, not the product: when the product has no way to do what you need, that is a finding (--type missing), not a block. Do not record findings about the missing setup itself.`,
     "Execute everything via CLI commands in the shell. Never invoke host Edit or Write tools on files in the workspace.",
     "",
     "Do not read the product's source code, other iamu/ entity files, or earlier runs: you know only what the persona knows.",
     "",
-    "When done, return a summary of steps taken and findings recorded."
+    "When done, reply with a concise one-line status (`Walk complete: <N> steps, <M> findings`) \u2014 do not re-type the full findings or synthesis into chat, as the orchestrator reads them directly from disk."
   ].join("\n");
 }
 async function instructionsWalk(opts) {
@@ -39726,13 +40364,19 @@ function registerFindingsCommands(program) {
 
 // src/commands/register-project.ts
 function registerProjectCommands(program) {
-  program.command("init").helpGroup("Project:").description("Scaffold iamu/ + install skills").argument("[name]", "Project name (defaults to directory name)").option("-y, --yes", "Skip prompts and accept all detected defaults").option("--cloud", "Connect to Iamu Cloud directly during init").option("--no-cloud", "Skip Iamu Cloud connection (local-only)").option("--json", "Output initialization metadata as JSON").addHelpText(
+  program.command("init").helpGroup("Project:").description("Scaffold iamu/ + install skills").argument("[name]", "Project name (defaults to directory name)").option("-y, --yes", "Skip prompts and accept all detected defaults").option("--target <url>", "Target URL for local or staging walkthroughs").option("--cloud", "Connect to Iamu Cloud directly during init").option("--no-cloud", "Skip Iamu Cloud connection (local-only)").option("--json", "Output initialization metadata as JSON").addHelpText(
     "after",
-    "\nExamples:\n  $ iamu init\n  $ iamu init my-project -y\n  $ iamu init --cloud\n  $ iamu init --json"
+    "\nExamples:\n  $ iamu init\n  $ iamu init my-project -y\n  $ iamu init --target http://localhost:5173\n  $ iamu init --cloud\n  $ iamu init --json"
   ).action(
     async (name, opts) => {
       const { init: init2 } = await Promise.resolve().then(() => (init_init(), init_exports));
-      await init2({ name, yes: opts.yes, json: opts.json, cloud: opts.cloud });
+      await init2({
+        name,
+        yes: opts.yes,
+        json: opts.json,
+        cloud: opts.cloud,
+        target: opts.target
+      });
     }
   );
   program.command("status").helpGroup("Project:").description("Show project state: entities, runs, context, cloud link").option("--json", "Output as JSON").addHelpText(
@@ -39754,7 +40398,7 @@ function registerProjectCommands(program) {
     const { doctor: doctor2 } = await Promise.resolve().then(() => (init_doctor(), doctor_exports));
     await doctor2(opts);
   });
-  program.command("preflight").helpGroup("Project:").description("Run fast typecheck/lint preflight gate before walkthroughs").option("--cwd <path>", "Working directory of target project").option("--json", "Output diagnostics as JSON").addHelpText(
+  program.command("preflight").helpGroup("Project:").description("Run fast typecheck check before walkthroughs").option("--cwd <path>", "Working directory of target project").option("--json", "Output diagnostics as JSON").addHelpText(
     "after",
     "\nExamples:\n  $ iamu preflight\n  $ iamu preflight --json"
   ).action(async (opts) => {
@@ -39894,8 +40538,8 @@ function registerProjectCommands(program) {
       await setEntity2(type2, slug, opts);
     }
   );
-  program.command("edit <type> <slug>").helpGroup("Project:").description(
-    "Open an entity file in your editor ($VISUAL or $EDITOR) and validate on exit"
+  program.command("edit <type> [slug]").helpGroup("Project:").description(
+    "Open an entity or project file (testability, context) in your editor ($VISUAL or $EDITOR) and validate on exit"
   ).option("--json", "Output as JSON").action(
     async (type2, slug, opts = {}) => {
       const { editEntity: editEntity2 } = await Promise.resolve().then(() => (init_edit_entity(), edit_entity_exports));
@@ -40084,6 +40728,13 @@ function registerWalkthroughCommands(program) {
   ).option("--action <text>", "Action description (step only)").option("--note <text>", "Persona inner monologue / reasoning (step only)").option("--surface <name>", "Screen or surface name (step only)").option(
     "--step-file <path>",
     "Read step payload (action, note, cmd) from a JSON file or '-' for stdin (step only)"
+  ).option(
+    "--then <cmd>",
+    "Chain an additional browser action in the same step before taking the screenshot (repeatable, step only)",
+    (value, previous = []) => [...previous, value]
+  ).option(
+    "--no-snapshot",
+    "Omit the post-action accessibility snapshot from browse step / goto output"
   ).option("--width <px>", "Window width (start)").option("--height <px>", "Window height (start)").option("--headless", "Run without a window (start)").option(
     "--port <port>",
     "CDP port (start), default 9333",