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

package/dist/bin.js

@@ -1433,7 +1433,11 @@ var init_walkthrough_canonical = __esm({
       slug: z22.string(),
       persona_slug: z22.string(),
       outline_slug: z22.string(),
-      brief: z22.string()
+      brief: z22.string(),
+      /** Display names, so reports never show slugs. Absent on older runs. */
+      persona_name: z22.string().optional(),
+      persona_role: z22.string().optional(),
+      outline_title: z22.string().optional()
     }).passthrough();
     canonicalTargetSchema = z22.object({
       url: z22.string(),
@@ -1467,6 +1471,10 @@ var init_walkthrough_canonical = __esm({
     }).passthrough();
     canonicalFindingSchema = z22.object({
       id: z22.string(),
+      /** The finding's short title. Absent on older runs. */
+      title: z22.string().nullable().optional(),
+      /** The page it was seen on (the finding's own, else its step's). */
+      page_url: z22.string().nullable().optional(),
       /** Stable across runs for pattern tracking — null until cross-run wiring lands. */
       canonical_id: z22.string().nullable(),
       type: findingTypeEnum,
@@ -1728,14 +1736,14 @@ Bad background: "Construction worker. Experienced in the field. Uses a smartphon
 - observation: An enhancement opportunity. Not friction, but a missed chance to help.
 
 Finding type pairing:
-- helps \u2192 always observation severity. Record sparingly \u2014 only when the product does something genuinely supportive that's worth preserving.
+- helps \u2192 always observation severity. Record each one you meet: something the product does that this person would miss if it were gone.
 - hinders \u2192 critical, major, or minor.
 - missing \u2192 critical, major, or minor.
 - incorrect \u2192 critical or major only.
 - irrelevant \u2192 minor or observation.
 
 Do NOT record findings that amount to "this screen is clear and easy to use." The absence of friction is not a finding. Record helps only when the product actively supports the persona in a way that would be missed if removed.`;
-    HELPS_CALIBRATION = `Helps calibration: A helps finding records something the product does that actively supports the persona in a way that would be missed if removed. "The button is easy to find" is not a helps finding \u2014 that's baseline. "The system auto-saves my draft so I don't lose work when interrupted" IS a helps finding \u2014 removing it would hurt this persona. Record 1-2 helps per walkthrough at most.`;
+    HELPS_CALIBRATION = `Helps calibration: A helps finding records something the product does that actively supports the persona in a way that would be missed if removed. "The button is easy to find" is not a helps finding \u2014 that's baseline. "The system auto-saves my draft so I don't lose work when interrupted" IS a helps finding \u2014 removing it would hurt this persona. Record every one you meet, with the same ui_fact and consequence as any finding; a full walk usually has several. They are what a later change must not break: whoever fixes the problems reads them to know what to protect.`;
     COGNITIVE_BOUNDING = `Cognitive bounding: Your reasoning ability exceeds this persona's. Their cognitive profile describes how they process information, what they're good at, and where they hit limits. Use it to generate authentic friction signals \u2014 not to lobotomize the walkthrough.
 
 The cognitive profile includes strengths AND limits. A construction worker who skims text may also have excellent spatial memory for page layouts. A teenager who's impatient may pattern-match UI conventions instantly. Apply both sides \u2014 strengths let the persona sail through some things; limits create friction at others.
@@ -1918,7 +1926,7 @@ var init_prompt_registry = __esm({
       },
       walkthrough: {
         id: "walkthroughPhilosophy",
-        version: "2.0.0",
+        version: "2.1.0",
         compose: (opts) => composeWalkthroughPhilosophy(opts)
       },
       scenarioCraft: {
@@ -6849,413 +6857,196 @@ var init_revisit = __esm({
   }
 });
 
-// ../../packages/local-store/dist/journey-diff.js
-function isProblemFinding(type2) {
-  return PROBLEM_TYPES2.has(type2.toLowerCase());
+// ../../packages/local-store/dist/directions.js
+import { randomUUID as randomUUID5 } from "crypto";
+import { promises as fs12 } from "fs";
+import path9 from "path";
+import { z as z25 } from "zod";
+function directionsDir(projectRoot) {
+  return path9.join(iamuDir(projectRoot), DIRECTIONS_DIR);
 }
-function levenshteinDistance(a, b) {
-  if (a === b)
-    return 0;
-  if (!a.length)
-    return b.length;
-  if (!b.length)
-    return a.length;
-  const row = Array.from({ length: b.length + 1 }, (_, i) => i);
-  for (let i = 1; i <= a.length; i++) {
-    let prev = i;
-    for (let j = 1; j <= b.length; j++) {
-      const val = a[i - 1] === b[j - 1] ? row[j - 1] : Math.min(row[j - 1], prev, row[j]) + 1;
-      row[j - 1] = prev;
-      prev = val;
-    }
-    row[b.length] = prev;
-  }
-  return row[b.length];
+function directionPath(projectRoot, slug) {
+  return path9.join(directionsDir(projectRoot), `${slug}.md`);
 }
-function normalizeAction(action) {
-  if (!action)
-    return "";
-  return action.toLowerCase().replace(/['"`]/g, "").replace(/[^\p{L}\p{N}\s/_-]+/gu, " ").replace(/\s+/g, " ").trim();
+function renderBody(texts) {
+  return [
+    "## Problem",
+    "",
+    texts.problem.trim(),
+    "",
+    "## Change",
+    "",
+    texts.change.trim(),
+    "",
+    "## Leading practice",
+    "",
+    texts.leading_practice.trim(),
+    ""
+  ].join("\n");
 }
-function actionTokens(action) {
-  const norm = normalizeAction(action);
-  if (!norm)
-    return /* @__PURE__ */ new Set();
-  return new Set(norm.split(/\s+/).filter(Boolean));
+function section(body, heading) {
+  const re = new RegExp(`^## ${heading}\\s*\\n([\\s\\S]*?)(?=^## |$(?![\\s\\S]))`, "m");
+  return re.exec(body)?.[1]?.trim() ?? "";
 }
-function actionSimilarity(a, b) {
-  const normA = normalizeAction(a);
-  const normB = normalizeAction(b);
-  if (!normA && !normB)
-    return 1;
-  if (!normA || !normB)
-    return 0;
-  if (normA === normB)
-    return 1;
-  const tokensA = actionTokens(normA);
-  const tokensB = actionTokens(normB);
-  let intersection = 0;
-  for (const t of tokensA) {
-    if (tokensB.has(t))
-      intersection++;
-  }
-  if (intersection === 0) {
-    if (tokensA.size <= 1 && tokensB.size <= 1) {
-      const maxLen = Math.max(normA.length, normB.length);
-      const levDist = levenshteinDistance(normA, normB);
-      return levDist <= 2 && maxLen > 0 ? 1 - levDist / maxLen : 0;
-    }
-    return 0;
-  }
-  const union2 = tokensA.size + tokensB.size - intersection;
-  const jaccard = union2 > 0 ? intersection / union2 : 0;
-  const minSize = Math.min(tokensA.size, tokensB.size);
-  const subsetRatio = minSize > 0 ? intersection / minSize : 0;
-  if (normA.includes(normB) || normB.includes(normA) || subsetRatio === 1) {
-    return Math.max(0.85, 0.7 + 0.3 * jaccard);
+function parseDirection(raw, file) {
+  const { frontmatter, body } = parseFrontmatter(raw);
+  return {
+    frontmatter: directionFrontmatterSchema.parse(frontmatter),
+    texts: {
+      problem: section(body, "Problem"),
+      change: section(body, "Change"),
+      leading_practice: section(body, "Leading practice")
+    },
+    path: file
+  };
+}
+async function readDirection(projectRoot, slug) {
+  const file = directionPath(projectRoot, slug);
+  let raw;
+  try {
+    raw = await fs12.readFile(file, "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT")
+      return null;
+    throw err;
   }
-  return 0.5 * jaccard + 0.5 * subsetRatio;
+  return parseDirection(raw, file);
 }
-function routeSimilarity(urlA, surfaceA, urlB, surfaceB) {
-  const normUrlA = normalizePlaceKey(urlA);
-  const normUrlB = normalizePlaceKey(urlB);
-  const hasUrlA = normUrlA !== null;
-  const hasUrlB = normUrlB !== null;
-  let urlScore = null;
-  if (hasUrlA && hasUrlB) {
-    if (normUrlA === normUrlB) {
-      urlScore = 1;
-    } else {
-      const pathA = normUrlA.split("?")[0];
-      const pathB = normUrlB.split("?")[0];
-      urlScore = pathA === pathB ? 0.8 : 0;
-    }
+async function listDirections(projectRoot) {
+  let names2;
+  try {
+    names2 = await fs12.readdir(directionsDir(projectRoot));
+  } catch (err) {
+    if (err.code === "ENOENT")
+      return [];
+    throw err;
   }
-  const sA = surfaceA?.trim();
-  const sB = surfaceB?.trim();
-  let surfaceScore = null;
-  if (sA && sB) {
-    if (surfaceKey(sA) === surfaceKey(sB)) {
-      surfaceScore = 1;
-    } else if (surfaceMatches(sA, sB) || surfaceMatches(sB, sA)) {
-      surfaceScore = 0.8;
-    } else {
-      surfaceScore = 0;
+  const out = [];
+  for (const name of names2.sort()) {
+    if (!name.endsWith(".md"))
+      continue;
+    const file = path9.join(directionsDir(projectRoot), name);
+    try {
+      out.push(parseDirection(await fs12.readFile(file, "utf8"), file));
+    } catch {
     }
   }
-  if (urlScore !== null && surfaceScore !== null) {
-    if (urlScore >= 0.8 && surfaceScore >= 0.8)
-      return 1;
-    if (urlScore >= 0.8)
-      return 0.85;
-    if (surfaceScore >= 0.8)
-      return 0.75;
-    return 0;
-  }
-  if (urlScore !== null)
-    return urlScore;
-  if (surfaceScore !== null)
-    return surfaceScore;
-  return 0.5;
+  return out.sort((a, b) => b.frontmatter.updated_at.localeCompare(a.frontmatter.updated_at));
 }
-function stepSimilarity(a, b) {
-  const rSim = routeSimilarity(a.url, a.surface, b.url, b.surface);
-  const aSim = actionSimilarity(a.action, b.action);
-  if (aSim < 0.25 && a.action && b.action) {
-    return Math.min(0.2, rSim * 0.2);
-  }
-  if (rSim === 0) {
-    return aSim >= 0.8 ? aSim * 0.4 : 0.1;
-  }
-  return 0.5 * rSim + 0.5 * aSim;
+async function writeDirection(projectRoot, fm, texts) {
+  const file = directionPath(projectRoot, fm.slug);
+  const validated = directionFrontmatterSchema.parse(fm);
+  await atomicWriteFile(file, serializeFrontmatter(validated, renderBody(texts)));
+  return file;
 }
-function findingMatchesStep(finding, stepNumber2) {
-  if (finding.linked_step_ids && finding.linked_step_ids.length > 0) {
-    return finding.linked_step_ids.some((id) => id === `step-${stepNumber2}` || id === String(stepNumber2));
-  }
-  if (finding.walkthrough_step_id) {
-    const raw = finding.walkthrough_step_id.trim();
-    if (raw === `step-${stepNumber2}` || raw === String(stepNumber2)) {
-      return true;
-    }
+async function upsertDirection(projectRoot, proposal, source, advisedBy, now = (/* @__PURE__ */ new Date()).toISOString()) {
+  const existing = await readDirection(projectRoot, proposal.slug);
+  const texts = {
+    problem: proposal.problem,
+    change: proposal.change,
+    leading_practice: proposal.leading_practice
+  };
+  if (existing?.frontmatter.status === "rejected") {
+    return { outcome: "previously_rejected" };
   }
-  return false;
+  const prev = existing?.frontmatter;
+  const fm = {
+    id: prev?.id ?? randomUUID5(),
+    slug: proposal.slug,
+    title: proposal.title,
+    status: prev?.status ?? "proposed",
+    size: proposal.size,
+    absorbs: union(prev?.absorbs ?? [], proposal.absorbs, (x) => x),
+    reach: union(prev?.reach ?? [], proposal.reach, (r) => `${r.scenario}:${r.effect}`),
+    verify: union(prev?.verify ?? [], proposal.verify, (x) => x),
+    builds_on: union(prev?.builds_on ?? [], proposal.builds_on, (r) => `${r.path}#${r.symbol}`),
+    seen_in_runs: union(prev?.seen_in_runs ?? [], [source], (x) => x),
+    advised_by: advisedBy,
+    created_at: prev?.created_at ?? now,
+    updated_at: now
+  };
+  const file = await writeDirection(projectRoot, fm, texts);
+  return {
+    outcome: existing ? "updated" : "created",
+    direction: { frontmatter: fm, texts, path: file }
+  };
 }
-function isStallNote(note) {
-  if (!note)
-    return false;
-  const lower = note.toLowerCase();
-  return STALL_KEYWORDS.some((kw) => lower.includes(kw));
+async function setDirectionStatus(projectRoot, slug, status2, now = (/* @__PURE__ */ new Date()).toISOString()) {
+  const existing = await readDirection(projectRoot, slug);
+  if (!existing)
+    return null;
+  const fm = { ...existing.frontmatter, status: status2, updated_at: now };
+  await writeDirection(projectRoot, fm, existing.texts);
+  return { ...existing, frontmatter: fm };
 }
-function alignJourneySteps(scenario, baselineRunId, currentRunId, baselineSteps, baselineFindings, currentSteps, currentFindings) {
-  const m = baselineSteps.length;
-  const n = currentSteps.length;
-  const GAP_PENALTY = -0.7;
-  const MATCH_THRESHOLD = 0.45;
-  const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
-  for (let i2 = 0; i2 <= m; i2++)
-    dp[i2][0] = i2 * GAP_PENALTY;
-  for (let j2 = 0; j2 <= n; j2++)
-    dp[0][j2] = j2 * GAP_PENALTY;
-  for (let i2 = 1; i2 <= m; i2++) {
-    for (let j2 = 1; j2 <= n; j2++) {
-      const sim = stepSimilarity(baselineSteps[i2 - 1], currentSteps[j2 - 1]);
-      const matchScore = sim >= MATCH_THRESHOLD ? sim * 2 - 0.2 : -1.5;
-      const match2 = dp[i2 - 1][j2 - 1] + matchScore;
-      const delP = dp[i2 - 1][j2] + GAP_PENALTY;
-      const insC = dp[i2][j2 - 1] + GAP_PENALTY;
-      dp[i2][j2] = Math.max(match2, delP, insC);
-    }
-  }
-  const alignedPairs = [];
-  let i = m;
-  let j = n;
-  while (i > 0 || j > 0) {
-    if (i > 0 && j > 0) {
-      const sim = stepSimilarity(baselineSteps[i - 1], currentSteps[j - 1]);
-      const matchScore = sim >= MATCH_THRESHOLD ? sim * 2 - 0.2 : -1.5;
-      const scoreFromMatch = dp[i - 1][j - 1] + matchScore;
-      if (Math.abs(dp[i][j] - scoreFromMatch) < 1e-6 && sim >= MATCH_THRESHOLD) {
-        alignedPairs.push({
-          baseline: baselineSteps[i - 1],
-          current: currentSteps[j - 1]
-        });
-        i--;
-        j--;
-        continue;
-      }
-    }
-    if (j > 0 && Math.abs(dp[i][j] - (dp[i][j - 1] + GAP_PENALTY)) < 1e-6) {
-      alignedPairs.push({
-        baseline: null,
-        current: currentSteps[j - 1]
-      });
-      j--;
-    } else if (i > 0 && Math.abs(dp[i][j] - (dp[i - 1][j] + GAP_PENALTY)) < 1e-6) {
-      alignedPairs.push({
-        baseline: baselineSteps[i - 1],
-        current: null
-      });
-      i--;
-    } else if (i > 0 && j > 0) {
-      alignedPairs.push({
-        baseline: baselineSteps[i - 1],
-        current: currentSteps[j - 1]
-      });
-      i--;
-      j--;
-    } else if (i > 0) {
-      alignedPairs.push({
-        baseline: baselineSteps[i - 1],
-        current: null
-      });
-      i--;
-    } else {
-      alignedPairs.push({
-        baseline: null,
-        current: currentSteps[j - 1]
-      });
-      j--;
-    }
-  }
-  alignedPairs.reverse();
-  const maxBaselineStepNum = baselineSteps.length > 0 ? Math.max(...baselineSteps.map((s) => s.step_number)) : -1;
-  const alignedSteps = [];
-  const stats = {
-    totalAlignedSteps: alignedPairs.length,
-    same: 0,
-    resolved: 0,
-    persists: 0,
-    regressions: 0,
-    stalledInBaseline: 0,
-    bypassed: 0,
-    newPath: 0
-  };
-  for (let idx = 0; idx < alignedPairs.length; idx++) {
-    const pair = alignedPairs[idx];
-    const bStep = pair.baseline;
-    const cStep = pair.current;
-    const bFindings = bStep ? baselineFindings.filter((f) => findingMatchesStep(f, bStep.step_number)) : [];
-    const cFindings = cStep ? currentFindings.filter((f) => findingMatchesStep(f, cStep.step_number)) : [];
-    const bProblems = bFindings.filter((f) => isProblemFinding(f.type));
-    const cProblems = cFindings.filter((f) => isProblemFinding(f.type));
-    let status2 = "same";
-    let summary = "Clean";
-    if (bStep && cStep) {
-      const wasStall = bStep.step_number === maxBaselineStepNum && (bProblems.length > 0 || isStallNote(bStep.note));
-      if (bProblems.length > 0 && cProblems.length === 0) {
-        status2 = "resolved";
-        stats.resolved++;
-        const probDesc = bProblems[0].ui_fact || bProblems[0].title || bProblems[0].id;
-        summary = wasStall ? `Previous stall resolved \u2014 journey unblocked (${probDesc})` : `Resolved previous issue: ${probDesc}`;
-      } else if (bProblems.length > 0 && cProblems.length > 0) {
-        status2 = "persists";
-        stats.persists++;
-        const probDesc = cProblems[0].ui_fact || cProblems[0].title || cProblems[0].id;
-        summary = `Problem persists: ${probDesc}`;
-      } else if (bProblems.length === 0 && cProblems.length > 0) {
-        status2 = "regression";
-        stats.regressions++;
-        const probDesc = cProblems[0].ui_fact || cProblems[0].title || cProblems[0].id;
-        summary = `New issue reported: ${probDesc}`;
-      } else {
-        status2 = "same";
-        stats.same++;
-        summary = "Clean";
-      }
-    } else if (bStep && !cStep) {
-      const wasStall = bStep.step_number === maxBaselineStepNum && (bProblems.length > 0 || isStallNote(bStep.note));
-      if (wasStall) {
-        status2 = "stalled";
-        stats.stalledInBaseline++;
-        const probDesc = bProblems[0]?.ui_fact || bProblems[0]?.title || "journey halted";
-        summary = `Stalled in baseline: ${probDesc}`;
-      } else {
-        status2 = "bypassed";
-        stats.bypassed++;
-        summary = "Bypassed in current run";
-      }
-    } else if (!bStep && cStep) {
-      if (cProblems.length > 0) {
-        status2 = "regression";
-        stats.regressions++;
-        const probDesc = cProblems[0].ui_fact || cProblems[0].title || cProblems[0].id;
-        summary = `New step with issue: ${probDesc}`;
-      } else {
-        status2 = "new_path";
-        stats.newPath++;
-        summary = "New path / unblocked progress";
-      }
-    }
-    alignedSteps.push({
-      index: idx + 1,
-      status: status2,
-      baselineStep: bStep,
-      currentStep: cStep,
-      baselineFindings: bFindings,
-      currentFindings: cFindings,
-      summary
-    });
-  }
-  return {
-    scenario,
-    baselineRunId,
-    currentRunId,
-    steps: alignedSteps,
-    stats
-  };
-}
-function toStepFindingInfo(f) {
-  return {
-    id: f.frontmatter.id,
-    title: f.frontmatter.title ?? f.slug,
-    type: f.frontmatter.type,
-    severity: f.frontmatter.severity,
-    ui_fact: f.frontmatter.ui_fact,
-    consequence: f.frontmatter.consequence,
-    canonical_id: f.frontmatter.canonical_id,
-    walkthrough_step_id: f.frontmatter.walkthrough_step_id
-  };
-}
-function toJourneyStepInfo(s) {
-  return {
-    step_number: s.step_number,
-    action: s.action,
-    url: s.url ?? void 0,
-    surface: s.surface ?? void 0,
-    note: s.note ?? void 0
-  };
-}
-function journeyStepRoute(step) {
-  return step.currentStep?.url && normalizePlaceKey(step.currentStep.url) || step.baselineStep?.url && normalizePlaceKey(step.baselineStep.url) || step.currentStep?.surface || step.baselineStep?.surface || "\u2014";
-}
-async function computeJourneyDiff(projectRoot, baselineRunId, currentRunId, scenarioSlug) {
-  const [bStepsRaw, bFindingsRaw, cStepsRaw, cFindingsRaw] = await Promise.all([
-    readStepsForRun(projectRoot, baselineRunId),
-    readFindingsForRun(projectRoot, baselineRunId),
-    readStepsForRun(projectRoot, currentRunId),
-    readFindingsForRun(projectRoot, currentRunId)
-  ]);
-  const baselineSteps = bStepsRaw.map(toJourneyStepInfo);
-  const baselineFindings = bFindingsRaw.map(toStepFindingInfo);
-  const currentSteps = cStepsRaw.map(toJourneyStepInfo);
-  const currentFindings = cFindingsRaw.map(toStepFindingInfo);
-  return alignJourneySteps(scenarioSlug ?? "", baselineRunId, currentRunId, baselineSteps, baselineFindings, currentSteps, currentFindings);
-}
-function renderJourneyDiffMarkdown(diff) {
-  const lines = [
-    "### Chronological journey diff",
-    "",
-    `Baseline: \`${diff.baselineRunId}\` vs Current: \`${diff.currentRunId}\``
-  ];
-  const parts = [];
-  if (diff.stats.same > 0)
-    parts.push(`${diff.stats.same} unchanged`);
-  if (diff.stats.resolved > 0)
-    parts.push(`${diff.stats.resolved} resolved`);
-  if (diff.stats.persists > 0)
-    parts.push(`${diff.stats.persists} persists`);
-  if (diff.stats.regressions > 0)
-    parts.push(`${diff.stats.regressions} new issues`);
-  if (diff.stats.stalledInBaseline > 0)
-    parts.push(`${diff.stats.stalledInBaseline} stalled in baseline`);
-  if (diff.stats.bypassed > 0)
-    parts.push(`${diff.stats.bypassed} bypassed`);
-  if (diff.stats.newPath > 0)
-    parts.push(`${diff.stats.newPath} new path steps`);
-  if (parts.length > 0) {
-    lines.push(`- **Summary**: ${parts.join(", ")}`);
-  }
-  lines.push("", "| # | Route | Baseline (Run N-1) | Current (Run N) | Status | Notes |", "|---|-------|--------------------|-----------------|--------|-------|");
-  for (const step of diff.steps) {
-    const route = journeyStepRoute(step);
-    const baseAction = step.baselineStep ? `Step ${step.baselineStep.step_number}: ${escapeMarkdownCell(step.baselineStep.action)}` : "\u2014";
-    const currAction = step.currentStep ? `Step ${step.currentStep.step_number}: ${escapeMarkdownCell(step.currentStep.action)}` : "\u2014";
-    const statusBadge = `\`${step.status}\``;
-    const notes = escapeMarkdownCell(step.summary);
-    lines.push(`| ${step.index} | \`${escapeMarkdownCell(route)}\` | ${baseAction} | ${currAction} | ${statusBadge} | ${notes} |`);
-  }
-  return lines.join("\n");
-}
-function escapeMarkdownCell(text) {
-  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
-}
-var PROBLEM_TYPES2, STALL_KEYWORDS;
-var init_journey_diff = __esm({
-  "../../packages/local-store/dist/journey-diff.js"() {
+var DIRECTIONS_DIR, DIRECTION_STATUSES, directionStatusSchema, directionSizeSchema, directionReachSchema, codeRefSchema, directionFrontmatterSchema, union;
+var init_directions = __esm({
+  "../../packages/local-store/dist/directions.js"() {
     "use strict";
-    init_revisit();
-    init_walkthrough_canonical2();
-    PROBLEM_TYPES2 = /* @__PURE__ */ new Set(["hinders", "missing", "incorrect"]);
-    STALL_KEYWORDS = [
-      "blocked",
-      "unable to proceed",
-      "stalled",
-      "halted",
-      "stuck",
-      "cannot proceed",
-      "could not proceed",
-      "failed to load",
-      "timed out"
+    init_atomic();
+    init_markdown();
+    init_paths();
+    DIRECTIONS_DIR = "directions";
+    DIRECTION_STATUSES = [
+      "proposed",
+      "accepted",
+      "done",
+      "rejected"
     ];
+    directionStatusSchema = z25.enum(DIRECTION_STATUSES);
+    directionSizeSchema = z25.enum(["small", "medium", "large"]);
+    directionReachSchema = z25.object({
+      scenario: z25.string().min(1),
+      effect: z25.enum(["helps", "risk"]),
+      reason: z25.string().min(1)
+    });
+    codeRefSchema = z25.object({
+      path: z25.string().min(1),
+      symbol: z25.string().min(1)
+    });
+    directionFrontmatterSchema = z25.object({
+      id: z25.string().uuid(),
+      slug: z25.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/),
+      title: z25.string().min(1),
+      status: directionStatusSchema.default("proposed"),
+      size: directionSizeSchema,
+      /** Finding ids this direction would resolve. */
+      absorbs: z25.array(z25.string().min(1)).default([]),
+      /** Predicted effect on other scenarios — never evidence. */
+      reach: z25.array(directionReachSchema).default([]),
+      /** Scenarios to re-run once the direction lands. */
+      verify: z25.array(z25.string().min(1)).default([]),
+      builds_on: z25.array(codeRefSchema).default([]),
+      /** Runs (or `project:<timestamp>`) whose analysis proposed it. */
+      seen_in_runs: z25.array(z25.string().min(1)).default([]),
+      advised_by: z25.string().regex(/^advisor@\S+$/),
+      created_at: z25.string(),
+      updated_at: z25.string()
+    });
+    union = (a, b, key) => {
+      const seen = /* @__PURE__ */ new Map();
+      for (const x of [...a, ...b])
+        seen.set(key(x), x);
+      return [...seen.values()];
+    };
   }
 });
 
 // ../../packages/local-store/dist/walkthrough-canonical.js
-import { createHash as createHash2, randomUUID as randomUUID5 } from "crypto";
-import { promises as fs12 } from "fs";
-import path9 from "path";
+import { createHash as createHash2, randomUUID as randomUUID6 } from "crypto";
+import { promises as fs13 } from "fs";
+import path10 from "path";
 async function readStepsForRun(projectRoot, runId) {
   const runDirPath = runDir(projectRoot, runId);
-  const stepsDir = path9.join(runDirPath, "steps");
+  const stepsDir = path10.join(runDirPath, "steps");
   try {
-    const names2 = await fs12.readdir(stepsDir);
+    const names2 = await fs13.readdir(stepsDir);
     const jsonFiles = names2.filter((n) => n.endsWith(".json")).sort();
     if (jsonFiles.length > 0) {
       const out2 = [];
       for (const name of jsonFiles) {
         try {
-          const raw2 = await fs12.readFile(path9.join(stepsDir, name), "utf8");
+          const raw2 = await fs13.readFile(path10.join(stepsDir, name), "utf8");
           const parsed = JSON.parse(raw2);
           if (parsed.step_number == null) {
             const numFromName = Number.parseInt(name.replace(/\.json$/, ""), 10);
@@ -7269,10 +7060,10 @@ async function readStepsForRun(projectRoot, runId) {
     }
   } catch {
   }
-  const stepsPath = path9.join(runDirPath, "steps.jsonl");
+  const stepsPath = path10.join(runDirPath, "steps.jsonl");
   let raw;
   try {
-    raw = await fs12.readFile(stepsPath, "utf8");
+    raw = await fs13.readFile(stepsPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT")
       return [];
@@ -7297,7 +7088,7 @@ async function readFindingsForRun(projectRoot, runId) {
   const findingsDir = entityDirPath(projectRoot, "finding");
   let names2;
   try {
-    names2 = await fs12.readdir(findingsDir);
+    names2 = await fs13.readdir(findingsDir);
   } catch (err) {
     if (err.code === "ENOENT")
       return [];
@@ -7307,8 +7098,8 @@ async function readFindingsForRun(projectRoot, runId) {
   for (const name of names2) {
     if (!name.endsWith(".md") || name.startsWith("."))
       continue;
-    const filePath = path9.join(findingsDir, name);
-    const raw = await fs12.readFile(filePath, "utf8");
+    const filePath = path10.join(findingsDir, name);
+    const raw = await fs13.readFile(filePath, "utf8");
     try {
       const { frontmatter, body } = parseFrontmatter(raw);
       const fm = frontmatter;
@@ -7339,7 +7130,7 @@ async function resolveCanonicalIds(projectRoot, scenarioSlug, currentRunId, curr
   const findingsDir = entityDirPath(projectRoot, "finding");
   let allNames;
   try {
-    allNames = await fs12.readdir(findingsDir);
+    allNames = await fs13.readdir(findingsDir);
   } catch {
     allNames = [];
   }
@@ -7347,7 +7138,7 @@ async function resolveCanonicalIds(projectRoot, scenarioSlug, currentRunId, curr
     if (!name.endsWith(".md") || name.startsWith("."))
       continue;
     try {
-      const raw = await fs12.readFile(path9.join(findingsDir, name), "utf8");
+      const raw = await fs13.readFile(path10.join(findingsDir, name), "utf8");
       const { frontmatter } = parseFrontmatter(raw);
       const fm = frontmatter;
       if (!fm.scenario || fm.scenario !== scenarioSlug)
@@ -7358,14 +7149,14 @@ async function resolveCanonicalIds(projectRoot, scenarioSlug, currentRunId, curr
       if (fm.canonical_id) {
         priorIndex.set(fp, fm.canonical_id);
       } else if (!priorIndex.has(fp)) {
-        priorIndex.set(fp, randomUUID5());
+        priorIndex.set(fp, randomUUID6());
       }
     } catch {
     }
   }
   for (const f of currentFindings) {
     const fp = findingFingerprint(f.frontmatter.scenario, f.frontmatter.type, f.frontmatter.ui_fact);
-    const canonicalId = f.frontmatter.canonical_id ?? priorIndex.get(fp) ?? randomUUID5();
+    const canonicalId = f.frontmatter.canonical_id ?? priorIndex.get(fp) ?? randomUUID6();
     result.set(f.frontmatter.id, canonicalId);
     if (!f.frontmatter.canonical_id) {
       try {
@@ -7373,9 +7164,9 @@ async function resolveCanonicalIds(projectRoot, scenarioSlug, currentRunId, curr
         for (const name of allNames) {
           if (!name.endsWith(".md") || name.startsWith("."))
             continue;
-          const candidatePath = path9.join(findingsDir, name);
+          const candidatePath = path10.join(findingsDir, name);
           try {
-            const candidateRaw = await fs12.readFile(candidatePath, "utf8");
+            const candidateRaw = await fs13.readFile(candidatePath, "utf8");
             const { frontmatter: cFm } = parseFrontmatter(candidateRaw);
             if (cFm.id === f.frontmatter.id) {
               targetPath = candidatePath;
@@ -7386,7 +7177,7 @@ async function resolveCanonicalIds(projectRoot, scenarioSlug, currentRunId, curr
         }
         if (targetPath) {
           await withFileLock(targetPath, async () => {
-            const raw = await fs12.readFile(targetPath, "utf8");
+            const raw = await fs13.readFile(targetPath, "utf8");
             const updated = raw.replace(/^(---\n[\s\S]*?)(---\n)/m, `$1canonical_id: ${canonicalId}
 $2`);
             if (updated !== raw) {
@@ -7411,7 +7202,7 @@ function extractRecommendationFromBody(body) {
 }
 async function readAnalysis(projectRoot, runId) {
   try {
-    const raw = JSON.parse(await fs12.readFile(path9.join(runDir(projectRoot, runId), "advice.json"), "utf8"));
+    const raw = JSON.parse(await fs13.readFile(path10.join(runDir(projectRoot, runId), "advice.json"), "utf8"));
     return {
       advisor: `advisor@${raw.advisor?.version ?? "unknown"}`,
       directions: (raw.directions ?? []).map((d) => ({
@@ -7441,9 +7232,13 @@ async function buildCanonical(projectRoot, manifest, completedAt, inputs) {
   } : null;
   const outlineEntity = scenario ? await readEntity(projectRoot, "outline", scenario.outline) : null;
   const outline = outlineEntity ? {
+    title: outlineEntity.frontmatter.title,
     human_tests: outlineEntity.frontmatter.human_tests ?? []
   } : null;
+  const personaEntity = scenario?.persona ? await readEntity(projectRoot, "persona", scenario.persona).catch(() => null) : null;
+  const personaName = personaEntity?.frontmatter.name ?? null;
   const steps = await readStepsForRun(projectRoot, manifest.run_id);
+  const history = await scenarioRunHistory(projectRoot, manifest.scenario_slug, manifest.run_id);
   const findings2 = await readFindingsForRun(projectRoot, manifest.run_id);
   const analysis = await readAnalysis(projectRoot, manifest.run_id);
   const canonicalSteps = steps.map((s, idx) => {
@@ -7455,7 +7250,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 ? path9.join("screenshots", path9.basename(s.screenshot)) : null,
+      screenshot_ref: s.screenshot ? path10.join("screenshots", path10.basename(s.screenshot)) : null,
       persona_reasoning: s.note,
       grounding: s.grounding ?? null,
       action: s.action,
@@ -7463,9 +7258,15 @@ async function buildCanonical(projectRoot, manifest, completedAt, inputs) {
       ...typeof s.surface === "string" && s.surface ? { surface: s.surface } : {}
     };
   });
+  const checks = await runChecks(projectRoot, manifest, canonicalSteps, history.previousStartedAt);
   const canonicalMap = await resolveCanonicalIds(projectRoot, manifest.scenario_slug, manifest.run_id, findings2);
+  const stepUrl2 = new Map(canonicalSteps.map((st) => [st.id, st.url ?? null]));
   const canonicalFindings = findings2.map((f) => ({
     id: f.frontmatter.id,
+    // Additive keys (D3): the short title and the page it was seen on,
+    // so reports never fall back to ids or bare step numbers.
+    title: f.frontmatter.title ?? null,
+    page_url: f.frontmatter.page_url ?? (f.frontmatter.walkthrough_step_id ? stepUrl2.get(f.frontmatter.walkthrough_step_id) : null) ?? null,
     canonical_id: canonicalMap.get(f.frontmatter.id) ?? null,
     type: f.frontmatter.type,
     severity: f.frontmatter.severity ?? null,
@@ -7497,7 +7298,10 @@ async function buildCanonical(projectRoot, manifest, completedAt, inputs) {
       slug: manifest.scenario_slug,
       persona_slug: scenario?.persona ?? "",
       outline_slug: scenario?.outline ?? "",
-      brief: scenario?.brief ?? ""
+      brief: scenario?.brief ?? "",
+      ...personaName ? { persona_name: personaName } : {},
+      ...personaEntity?.frontmatter.role ? { persona_role: personaEntity.frontmatter.role } : {},
+      ...outline?.title ? { outline_title: outline.title } : {}
     },
     target: {
       url: manifest.target_url,
@@ -7523,7 +7327,7 @@ async function buildCanonical(projectRoot, manifest, completedAt, inputs) {
     steps: canonicalSteps,
     human_tests: humanTests,
     human_test_overall: {
-      question: outline ? `Would ${scenario?.persona ?? "the persona"} come back and use this voluntarily?` : "Would the persona come back and use this voluntarily?",
+      question: outline ? `Would ${personaName ?? scenario?.persona ?? "the persona"} come back and use this voluntarily?` : "Would the persona come back and use this voluntarily?",
       answer: null,
       reasoning: null
     },
@@ -7534,21 +7338,65 @@ async function buildCanonical(projectRoot, manifest, completedAt, inputs) {
     // Consumers MUST preserve unknown keys (per design D3).
     ...inputs.what_worked && inputs.what_worked.length > 0 ? { what_worked: inputs.what_worked } : {},
     ...inputs.open_questions && inputs.open_questions.length > 0 ? { open_questions: inputs.open_questions } : {},
+    ...inputs.setup_notes && inputs.setup_notes.length > 0 ? { setup_notes: inputs.setup_notes } : {},
     ...manifest.blocked ? { blocked: manifest.blocked } : {},
-    ...analysis ? { analysis } : {}
+    ...analysis ? { analysis } : {},
+    run_number: history.runNumber,
+    ...checks ? { checks } : {}
   };
 }
-async function compareWithBaseline(projectRoot, scenarioSlug, currentRunId, currentFindings) {
-  const allRuns = await listRunsInternal(projectRoot);
-  let baselineRunId = null;
-  let baselineManifest = null;
-  for (let i = allRuns.length - 1; i >= 0; i--) {
-    const rid = allRuns[i];
-    if (rid === currentRunId)
+async function runChecks(projectRoot, manifest, steps, previousStartedAt) {
+  const places = manifest.revisit ?? [];
+  const fixes = [];
+  if (places.length > 0) {
+    const { entities } = await listEntities(projectRoot, "finding");
+    const byId = new Map(entities.map((e) => [e.frontmatter.id, e.frontmatter]));
+    for (const place of revisitCoverage(places, steps).places) {
+      for (const id of place.finding_ids) {
+        const f = byId.get(id);
+        if (!f || f.type === "helps")
+          continue;
+        fixes.push({
+          canonical_id: f.canonical_id ?? null,
+          title: f.title ?? f.slug,
+          fix: f.triage_note ?? null,
+          page: place.url,
+          reached: place.reached
+        });
+      }
+    }
+  }
+  const directions = previousStartedAt ? (await listDirections(projectRoot).catch(() => [])).filter((d) => d.frontmatter.status === "done" && d.frontmatter.verify.includes(manifest.scenario_slug) && d.frontmatter.updated_at > previousStartedAt).map((d) => d.frontmatter.title) : [];
+  return fixes.length > 0 || directions.length > 0 ? { fixes, directions } : null;
+}
+async function scenarioRunHistory(projectRoot, scenarioSlug, runId) {
+  let runNumber = 1;
+  let previousStartedAt = null;
+  for (const rid of await listRunsInternal(projectRoot)) {
+    if (rid >= runId)
+      continue;
+    try {
+      const m = JSON.parse(await fs13.readFile(path10.join(runDir(projectRoot, rid), "walkthrough.json"), "utf8"));
+      if (m.scenario_slug === scenarioSlug && m.status === "completed") {
+        runNumber++;
+        previousStartedAt = m.created_at;
+      }
+    } catch {
+    }
+  }
+  return { runNumber, previousStartedAt };
+}
+async function compareWithBaseline(projectRoot, scenarioSlug, currentRunId, currentFindings) {
+  const allRuns = await listRunsInternal(projectRoot);
+  let baselineRunId = null;
+  let baselineManifest = null;
+  for (let i = allRuns.length - 1; i >= 0; i--) {
+    const rid = allRuns[i];
+    if (rid === currentRunId)
       continue;
     try {
-      const mPath = path9.join(runDir(projectRoot, rid), "walkthrough.json");
-      const raw = await fs12.readFile(mPath, "utf8");
+      const mPath = path10.join(runDir(projectRoot, rid), "walkthrough.json");
+      const raw = await fs13.readFile(mPath, "utf8");
       const m = JSON.parse(raw);
       if (m.scenario_slug === scenarioSlug && m.status === "completed" && !m.blocked) {
         baselineRunId = rid;
@@ -7570,15 +7418,21 @@ async function compareWithBaseline(projectRoot, scenarioSlug, currentRunId, curr
   const uncertain = [];
   const matches = await readMatches(projectRoot, currentRunId);
   const recheckedFixed = new Set((matches?.rechecked_fixed ?? []).map((r) => r.canonical_id));
+  const recheckOf = new Map((matches?.rechecked_fixed ?? []).map((r) => [r.canonical_id, r]));
+  const matchNote = new Map((matches?.matches ?? []).filter((m) => m.canonical_id && m.reasoning).map((m) => [m.canonical_id, m.reasoning]));
+  const recurrence = new Map(currentFindings.filter((f) => f.canonical_id).map((f) => [f.canonical_id, f]));
   if (recheckedFixed.size > 0) {
     const prior = await priorCanonicals(projectRoot, scenarioSlug, currentRunId);
     for (const p of prior) {
       if (!recheckedFixed.has(p.canonical_id))
         continue;
+      const recheck = recheckOf.get(p.canonical_id);
       resolved.push({
         canonical_id: p.canonical_id,
         title: p.title,
-        type: p.type
+        type: p.type,
+        ...recheck?.reasoning ? { note: recheck.reasoning } : {},
+        ...recheck ? { step_ids: recheck.step_ids } : {}
       });
       await setCanonicalFixStatus(projectRoot, scenarioSlug, p.canonical_id, "verified_resolved");
     }
@@ -7595,11 +7449,20 @@ async function compareWithBaseline(projectRoot, scenarioSlug, currentRunId, curr
       });
       continue;
     }
+    const fixedBefore = bf.frontmatter.triage_status === "addressed";
     if (currentCanonicalIds.has(cid)) {
+      const note = matchNote.get(cid);
       persists.push({
         canonical_id: cid,
         title: bf.frontmatter.title ?? bf.frontmatter.slug,
-        type: bf.frontmatter.type
+        type: bf.frontmatter.type,
+        ...note ? { note } : {},
+        step_ids: recurrence.get(cid)?.linked_step_ids ?? [],
+        ...fixedBefore ? { fixed_before: true } : {},
+        ...bf.frontmatter.severity && recurrence.get(cid)?.severity ? {
+          severity_before: bf.frontmatter.severity,
+          severity_now: recurrence.get(cid)?.severity
+        } : {}
       });
       await updateFixStatus(projectRoot, bf.frontmatter.slug, "verified_persists");
     } else if (recheckedFixed.has(cid)) {
@@ -7607,7 +7470,8 @@ async function compareWithBaseline(projectRoot, scenarioSlug, currentRunId, curr
       notObserved.push({
         canonical_id: cid,
         title: bf.frontmatter.title ?? bf.frontmatter.slug,
-        type: bf.frontmatter.type
+        type: bf.frontmatter.type,
+        ...fixedBefore ? { fixed_before: true } : {}
       });
     }
   }
@@ -7629,9 +7493,9 @@ async function compareWithBaseline(projectRoot, scenarioSlug, currentRunId, curr
 async function updateFixStatus(projectRoot, slug, status2) {
   try {
     const findingsDir = entityDirPath(projectRoot, "finding");
-    const filePath = path9.join(findingsDir, `${slug}.md`);
+    const filePath = path10.join(findingsDir, `${slug}.md`);
     await withFileLock(filePath, async () => {
-      const raw = await fs12.readFile(filePath, "utf8");
+      const raw = await fs13.readFile(filePath, "utf8");
       const updated = raw.replace(/^(fix_status:\s*).*$/m, `$1${status2}`);
       if (updated !== raw) {
         await atomicWriteFile(filePath, updated);
@@ -7645,210 +7509,19 @@ fix_status: ${status2}`);
   }
 }
 async function listRunsInternal(projectRoot) {
-  const dir = path9.join(projectRoot, "iamu", ".runs");
+  const dir = path10.join(projectRoot, "iamu", ".runs");
   try {
-    const names2 = await fs12.readdir(dir);
+    const names2 = await fs13.readdir(dir);
     return names2.filter((n) => !n.startsWith(".")).sort();
   } catch {
     return [];
   }
 }
-function renderCanonicalMarkdown(canonical) {
-  const lines = [
-    "<!-- GENERATED: do not edit by hand. Regen via complete_walkthrough or local-store renderer. -->",
-    "",
-    `# Walkthrough report: ${canonical.scenario.slug}`,
-    "",
-    ...canonical.blocked ? [
-      "> **Blocked \u2014 the walk could not start as it was set up.**",
-      `> ${canonical.blocked.reason}`,
-      ">",
-      "> This run is not compared with earlier runs and proves nothing about earlier findings. Fix the setup (the scenario's starting state or the persona's access) and run it again.",
-      ""
-    ] : [],
-    `- Run ID: ${canonical.run_id}`,
-    `- Target URL: ${canonical.target.url}`
-  ];
-  if (canonical.environment) {
-    lines.push(`- Environment: ${canonical.environment}`);
-  }
-  if (canonical.build) {
-    const commit = canonical.build.git_sha?.slice(0, 7);
-    const buildDetails = [
-      canonical.build.label,
-      canonical.build.git_branch,
-      canonical.build.git_dirty && canonical.build.worktree_hash ? `${commit ?? "HEAD"} + uncommitted changes (${canonical.build.worktree_hash.slice(0, 6)}\u2026)` : commit,
-      canonical.build.ci?.provider
-    ].filter(Boolean).join(" \xB7 ");
-    if (buildDetails) {
-      lines.push(`- Build: ${buildDetails}`);
-    }
-  }
-  if (canonical.viewport) {
-    lines.push(`- Viewport: ${canonical.viewport.device} (${canonical.viewport.width}\xD7${canonical.viewport.height})`);
-  }
-  lines.push(`- Started: ${canonical.provenance.started_at}`, `- Completed: ${canonical.provenance.completed_at}`, `- Walker prompt: ${canonical.provenance.walker_prompt.id}@${canonical.provenance.walker_prompt.version}`, `- Findings: ${canonical.findings.length}`, `- Steps: ${canonical.steps.length}`);
-  const models = canonical.models;
-  if (models) {
-    const parts = [
-      models.walker ? `Walker: ${models.walker}${models.walker_reported ? ` (${models.walker_reported})` : ""}` : "",
-      models.judge ? `Judge: ${models.judge}${models.judge_reported ? ` (${models.judge_reported})` : ""}` : "",
-      models.matcher ? `Matcher: ${models.matcher}` : ""
-    ].filter(Boolean);
-    if (parts.length > 0) {
-      lines.push(`- Models: ${parts.join(" \xB7 ")}`);
-    }
-    if (typeof models.velocity_sec_per_step === "number") {
-      lines.push(`- Velocity: ~${models.velocity_sec_per_step}s/step (${models.total_duration_sec}s total)`);
-    }
-  }
-  const what = canonical.what_worked;
-  if (what && what.length > 0) {
-    lines.push("", "## What worked");
-    for (const w of what)
-      lines.push(`- ${w}`);
-  }
-  const open2 = canonical.open_questions;
-  if (open2 && open2.length > 0) {
-    lines.push("", "## Open questions");
-    for (const q of open2)
-      lines.push(`- ${q}`);
-  }
-  const verification = canonical.verification;
-  if (verification) {
-    lines.push("", "## Since this scenario's last run", "", `Baseline: ${verification.baseline_run_id}`);
-    const group = (label, items, note = "") => {
-      if (items.length === 0)
-        return;
-      lines.push("", `**${label}** (${items.length})${note}`);
-      for (const i of items)
-        lines.push(`- ${i.title}`);
-    };
-    group("Resolved", verification.resolved, " \u2014 re-checked in this run");
-    group("Persists", verification.persists);
-    group("New since that run", verification.new_findings);
-    group("Not seen this run", verification.not_observed, " \u2014 not evidence of a fix");
-    group("Uncertain", verification.uncertain);
-  }
-  const diff = canonical.journey_diff;
-  if (diff) {
-    lines.push("", renderJourneyDiffMarkdown(diff));
-  }
-  lines.push("", "## Findings");
-  if (canonical.findings.length === 0) {
-    lines.push("", "_No findings recorded._");
-  } else {
-    const severityRank = ["critical", "major", "minor", "observation"];
-    const rank = (value, order) => {
-      const i = order.indexOf(value ?? "");
-      return i === -1 ? order.length : i;
-    };
-    const typeRank = ["incorrect", "hinders", "missing", "irrelevant", "helps"];
-    const ordered = [...canonical.findings].sort((a, b) => rank(a.severity, severityRank) - rank(b.severity, severityRank) || rank(a.type, typeRank) - rank(b.type, typeRank));
-    for (const f of ordered) {
-      lines.push("", `### ${f.type} / ${f.severity ?? "unranked"} \u2014 ${f.id}`);
-      if (f.ui_fact === null || f.consequence === null) {
-        lines.push("", "> _Legacy finding: predates the UI-fact / consequence depth gate._");
-      }
-      if (f.ui_fact)
-        lines.push("", "**UI fact.** ", f.ui_fact);
-      if (f.consequence)
-        lines.push("", "**Consequence.** ", f.consequence);
-      if (f.recommendation)
-        lines.push("", "**Recommendation.** ", f.recommendation);
-      for (const stepId of f.linked_step_ids) {
-        const step = canonical.steps.find((st) => st.id === stepId);
-        const label = step ? `Step ${step.step_number}` : stepId;
-        lines.push("", step?.screenshot_ref ? `**Where.** ${label}
-
-![${label}](${step.screenshot_ref})` : `**Where.** ${label}`);
-      }
-      if (f.linked_human_test_id) {
-        lines.push("", `Human test: ${f.linked_human_test_id}`);
-      }
-    }
-  }
-  const analysis = canonical.analysis;
-  if (analysis && analysis.directions.length > 0) {
-    lines.push("", "## Directions", "", `_Structural changes proposed by ${analysis.advisor} after the walk. Reach is a prediction until the listed scenarios are re-run._`);
-    for (const d of analysis.directions) {
-      lines.push("", `### ${d.title} (${d.size})`, "", d.change);
-      lines.push("", `Absorbs ${d.absorbs.length} finding${d.absorbs.length === 1 ? "" : "s"}.`);
-      const helps = d.reach.filter((r) => r.effect === "helps");
-      const risks = d.reach.filter((r) => r.effect === "risk");
-      for (const r of helps)
-        lines.push(`- Likely helps ${r.scenario}: ${r.reason}`);
-      for (const r of risks)
-        lines.push(`- Could hurt ${r.scenario}: ${r.reason}`);
-      if (d.verify.length > 0)
-        lines.push("", `Re-run to verify: ${d.verify.join(", ")}`);
-    }
-  }
-  if (analysis && analysis.observations.length > 0) {
-    lines.push("", "## Also worth knowing", "");
-    for (const o of analysis.observations) {
-      const label = o.kind === "coverage_gap" ? "Not walked" : "Feature risk";
-      lines.push(`- **${label}: ${o.title}.** ${o.detail}`);
-      if (o.suggested_scenario) {
-        lines.push(`  Suggested scenario: ${o.suggested_scenario}`);
-      }
-    }
-  }
-  lines.push("", "## Human tests");
-  if (canonical.human_tests.length === 0) {
-    lines.push("", "_No human tests on the outline._");
-  } else {
-    for (const ht of canonical.human_tests) {
-      lines.push("", `- **${ht.question}**`);
-      if (ht.verdict === null) {
-        if (canonical.blocked) {
-          lines.push(`  - Verdict: _skipped (walk blocked)_`);
-        } else {
-          lines.push(`  - Verdict: _pending judge_ (walker does not self-grade)`);
-        }
-      } else {
-        lines.push(`  - Verdict: **${ht.verdict}**`);
-        if (ht.reasoning)
-          lines.push(`  - Reasoning: ${ht.reasoning}`);
-      }
-    }
-  }
-  lines.push("", "## Human test overall", "", `> ${canonical.human_test_overall.question}`);
-  if (canonical.human_test_overall.answer === null) {
-    if (canonical.blocked) {
-      lines.push("", "_Skipped (walk blocked)._");
-    } else {
-      lines.push("", "_Pending judge stage._");
-    }
-  } else {
-    lines.push("", canonical.human_test_overall.answer);
-    if (canonical.human_test_overall.reasoning)
-      lines.push("", canonical.human_test_overall.reasoning);
-  }
-  lines.push("", "## Steps");
-  if (canonical.steps.length === 0) {
-    lines.push("", "_No steps recorded._");
-  } else {
-    for (const s of canonical.steps) {
-      lines.push("", `### ${s.step_number}. ${s.screen_title ?? "(untitled)"} \u2014 ${s.id}`);
-      const where = [s.surface, s.url].filter(Boolean).join(" \u2014 ");
-      if (where)
-        lines.push("", `Page: ${where}`);
-      if (s.persona_reasoning)
-        lines.push("", `> ${s.persona_reasoning.replace(/\n/g, "\n> ")}`);
-      if (s.grounding)
-        lines.push("", `Grounding: ${s.grounding}`);
-      if (s.screenshot_ref)
-        lines.push("", `![Step ${s.step_number}](${s.screenshot_ref})`);
-    }
-  }
-  return `${lines.join("\n")}
-`;
-}
 var init_walkthrough_canonical2 = __esm({
   "../../packages/local-store/dist/walkthrough-canonical.js"() {
     "use strict";
-    init_journey_diff();
+    init_revisit();
+    init_directions();
     init_atomic();
     init_file_lock();
     init_dist();
@@ -7870,8 +7543,8 @@ __export(walkthrough_mirror_exports, {
   walkthroughBundleSchema: () => walkthroughBundleSchema
 });
 import { createHash as createHash3 } from "crypto";
-import { promises as fs13 } from "fs";
-import path10 from "path";
+import { promises as fs14 } from "fs";
+import path11 from "path";
 function toCloudRunUuid(runId) {
   if (UUID_RE.test(runId))
     return runId.toLowerCase();
@@ -7921,18 +7594,18 @@ function buildPushUrl(cloudApiUrl, cloudProjectId) {
   return `${base}/api/projects/${cloudProjectId}/walkthroughs/push`;
 }
 async function readLocalManifest(projectRoot, runId) {
-  const p = path10.join(runDir(projectRoot, runId), "walkthrough.json");
+  const p = path11.join(runDir(projectRoot, runId), "walkthrough.json");
   try {
-    const raw = await fs13.readFile(p, "utf8");
+    const raw = await fs14.readFile(p, "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
   }
 }
 async function readLocalReport(projectRoot, runId) {
-  const p = path10.join(runDir(projectRoot, runId), "report.md");
+  const p = path11.join(runDir(projectRoot, runId), "report.md");
   try {
-    return await fs13.readFile(p, "utf8");
+    return await fs14.readFile(p, "utf8");
   } catch (err) {
     if (err.code === "ENOENT")
       return "";
@@ -7940,10 +7613,10 @@ async function readLocalReport(projectRoot, runId) {
   }
 }
 async function readScreenshotBytes(projectRoot, runId) {
-  const dir = path10.join(runDir(projectRoot, runId), SCREENSHOTS_DIR);
+  const dir = path11.join(runDir(projectRoot, runId), SCREENSHOTS_DIR);
   let names2;
   try {
-    names2 = await fs13.readdir(dir);
+    names2 = await fs14.readdir(dir);
   } catch (err) {
     if (err.code === "ENOENT")
       return /* @__PURE__ */ new Map();
@@ -7959,15 +7632,15 @@ async function readScreenshotBytes(projectRoot, runId) {
     const contentType = EXT_TO_CONTENT_TYPE[ext === ".jpeg" ? ".jpeg" : ext];
     if (!contentType)
       continue;
-    const bytes = await fs13.readFile(path10.join(dir, name));
+    const bytes = await fs14.readFile(path11.join(dir, name));
     out.set(seq2, { bytes, filename: name, contentType });
   }
   return out;
 }
 async function readVerdictsJson(projectRoot, runId) {
-  const filePath = path10.join(runDir(projectRoot, runId), "verdicts.json");
+  const filePath = path11.join(runDir(projectRoot, runId), "verdicts.json");
   try {
-    const raw = await fs13.readFile(filePath, "utf-8");
+    const raw = await fs14.readFile(filePath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -7976,9 +7649,9 @@ async function readVerdictsJson(projectRoot, runId) {
 async function readProvenance(projectRoot, runId, verdicts) {
   if (verdicts?.provenance)
     return verdicts.provenance;
-  const filePath = path10.join(runDir(projectRoot, runId), "canonical.json");
+  const filePath = path11.join(runDir(projectRoot, runId), "canonical.json");
   try {
-    const raw = await fs13.readFile(filePath, "utf-8");
+    const raw = await fs14.readFile(filePath, "utf-8");
     const data = JSON.parse(raw);
     return data.provenance ?? null;
   } catch {
@@ -7987,7 +7660,7 @@ async function readProvenance(projectRoot, runId, verdicts) {
 }
 async function readCanonicalExtras(projectRoot, runId) {
   try {
-    const data = JSON.parse(await fs13.readFile(path10.join(runDir(projectRoot, runId), "canonical.json"), "utf-8"));
+    const data = JSON.parse(await fs14.readFile(path11.join(runDir(projectRoot, runId), "canonical.json"), "utf-8"));
     const strings = (v) => Array.isArray(v) && v.every((x) => typeof x === "string") ? v : void 0;
     const verification = bundleVerificationSchema.safeParse(data.verification);
     let blocked;
@@ -8736,7 +8409,7 @@ var init_refs = __esm({
 });
 
 // ../../packages/local-store/dist/sync/types.js
-import { z as z25 } from "zod";
+import { z as z26 } from "zod";
 function toRef(d) {
   return { type: d.type, id: d.id, label: d.label };
 }
@@ -8801,17 +8474,17 @@ var init_types = __esm({
     DEFAULT_TIMEOUT_MS4 = 3e4;
     MAX_BATCH_BYTES = 6 * 1024 * 1024;
     BASE_HASH_BYTES = 96;
-    importConflictSchema = z25.object({
-      type: z25.string(),
-      id: z25.string(),
-      base_hash: z25.string().nullish(),
-      cloud_hash: z25.string(),
-      cloud_updated_at: z25.string().nullish(),
-      cloud_changed_by: z25.string().nullish()
+    importConflictSchema = z26.object({
+      type: z26.string(),
+      id: z26.string(),
+      base_hash: z26.string().nullish(),
+      cloud_hash: z26.string(),
+      cloud_updated_at: z26.string().nullish(),
+      cloud_changed_by: z26.string().nullish()
     });
-    importResponseSchema = z25.object({
-      imported: z25.number().int().min(0),
-      conflicts: z25.array(importConflictSchema).optional()
+    importResponseSchema = z26.object({
+      imported: z26.number().int().min(0),
+      conflicts: z26.array(importConflictSchema).optional()
     });
   }
 });
@@ -9062,7 +8735,7 @@ var init_push = __esm({
 });
 
 // ../../packages/local-store/dist/sync/context.js
-import { promises as fs14 } from "fs";
+import { promises as fs15 } from "fs";
 async function syncContext(target) {
   const { projectRoot } = target;
   const summary = zeroContext();
@@ -9070,7 +8743,7 @@ async function syncContext(target) {
   const conflicts = [];
   let raw;
   try {
-    raw = await fs14.readFile(contextPath(projectRoot), "utf8");
+    raw = await fs15.readFile(contextPath(projectRoot), "utf8");
   } catch (err) {
     if (err.code === "ENOENT")
       return { summary, errors, conflicts };
@@ -9151,7 +8824,7 @@ var init_context3 = __esm({
 // ../../packages/local-store/dist/git-branches.js
 import { execFile } from "child_process";
 import { realpathSync } from "fs";
-import path11 from "path";
+import path12 from "path";
 function defaultGitExec(cwd, args, input) {
   return new Promise((resolve4) => {
     let settled = false;
@@ -9210,7 +8883,7 @@ async function otherBranchesWithFiles(cwd, absPaths, opts = {}) {
       return out;
     return null;
   }
-  const top = path11.resolve(topRes.stdout.trim());
+  const top = path12.resolve(topRes.stdout.trim());
   if (!top)
     return out;
   const refsRes = await git2(cwd, [
@@ -9248,8 +8921,8 @@ async function otherBranchesWithFiles(cwd, absPaths, opts = {}) {
   } catch {
   }
   const rel = absPaths.map((abs) => {
-    const fromCwd = path11.relative(cwd, abs);
-    return path11.relative(top, path11.resolve(base, fromCwd)).split(path11.sep).join("/");
+    const fromCwd = path12.relative(cwd, abs);
+    return path12.relative(top, path12.resolve(base, fromCwd)).split(path12.sep).join("/");
   });
   const queries = [];
   const lines = [];
@@ -9287,8 +8960,8 @@ var init_git_branches = __esm({
 });
 
 // ../../packages/local-store/dist/deletions.js
-import { promises as fs15 } from "fs";
-import path12 from "path";
+import { promises as fs16 } from "fs";
+import path13 from "path";
 function describeDeletionCount(type2, n) {
   const nouns = {
     persona: ["persona", "personas"],
@@ -9315,7 +8988,7 @@ function summarizeDeletions(items) {
 }
 async function readPushedEntities(projectRoot) {
   try {
-    const raw = await fs15.readFile(pushedEntitiesPath(projectRoot), "utf8");
+    const raw = await fs16.readFile(pushedEntitiesPath(projectRoot), "utf8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
       return {};
@@ -9354,11 +9027,11 @@ async function rememberPushedEntities(projectRoot, known) {
 }
 async function readLenient(projectRoot, relPath) {
   try {
-    const raw = await fs15.readFile(path12.join(projectRoot, relPath), "utf8");
+    const raw = await fs16.readFile(path13.join(projectRoot, relPath), "utf8");
     const fm = parseFrontmatter(raw).frontmatter;
     if (typeof fm.id !== "string" || fm.id.length === 0)
       return null;
-    const slug = typeof fm.slug === "string" ? fm.slug : path12.basename(relPath, ".md");
+    const slug = typeof fm.slug === "string" ? fm.slug : path13.basename(relPath, ".md");
     const run = typeof fm.run === "string" ? fm.run : void 0;
     return { id: fm.id, slug, run };
   } catch {
@@ -9780,7 +9453,7 @@ var init_deletions2 = __esm({
 });
 
 // ../../packages/local-store/dist/sync/scan.js
-import { promises as fs16 } from "fs";
+import { promises as fs17 } from "fs";
 function blockedRef(refs, blocked) {
   if (!refs)
     return null;
@@ -9876,7 +9549,7 @@ async function scanPending(projectRoot) {
         continue;
       let bytes;
       try {
-        bytes = await fs16.readFile(entity.absPath, "utf8");
+        bytes = await fs17.readFile(entity.absPath, "utf8");
       } catch {
         continue;
       }
@@ -9937,7 +9610,7 @@ var init_scan = __esm({
 });
 
 // ../../packages/local-store/dist/sync/walkthroughs.js
-import { promises as fs17 } from "fs";
+import { promises as fs18 } from "fs";
 import nodePath from "path";
 async function syncWalkthroughs(projectRoot, deps, unpushableScenarios = /* @__PURE__ */ new Set()) {
   const summary = zeroWalkthroughs();
@@ -9965,7 +9638,7 @@ async function syncWalkthroughs(projectRoot, deps, unpushableScenarios = /* @__P
     const manifestPath = nodePath.join(runDir(projectRoot, runId), "walkthrough.json");
     let manifestRaw;
     try {
-      manifestRaw = await fs17.readFile(manifestPath, "utf8");
+      manifestRaw = await fs18.readFile(manifestPath, "utf8");
     } catch {
       continue;
     }
@@ -10304,8 +9977,8 @@ var init_disconnect = __esm({
 });
 
 // ../../packages/local-store/dist/status.js
-import { promises as fs18 } from "fs";
-import path13 from "path";
+import { promises as fs19 } from "fs";
+import path14 from "path";
 async function countType(projectRoot, type2) {
   const result = await listEntities(projectRoot, type2);
   const contentHashes = /* @__PURE__ */ new Map();
@@ -10315,7 +9988,7 @@ async function countType(projectRoot, type2) {
     if (typeof id !== "string" || typeof slug !== "string")
       continue;
     try {
-      const raw = await fs18.readFile(entity.absPath, "utf8");
+      const raw = await fs19.readFile(entity.absPath, "utf8");
       contentHashes.set(id, hashNormalizedContent(raw));
     } catch {
     }
@@ -10409,7 +10082,7 @@ async function countContext(projectRoot, opts = {
     return base;
   let pending = true;
   try {
-    const bytes = await fs18.readFile(contextPath(projectRoot), "utf8");
+    const bytes = await fs19.readFile(contextPath(projectRoot), "utf8");
     const hash = hashNormalizedContent(bytes);
     pending = opts.lastPush["context:root"] !== hash;
   } catch {
@@ -10428,10 +10101,10 @@ async function countWalkthroughs(projectRoot, opts = { cloudLinked: false, lastP
   let pushed = 0;
   let pending = 0;
   for (const runId of valid) {
-    const manifestPath = path13.join(projectRoot, "iamu", ".runs", runId, "walkthrough.json");
+    const manifestPath = path14.join(projectRoot, "iamu", ".runs", runId, "walkthrough.json");
     let completed = false;
     try {
-      const raw = await fs18.readFile(manifestPath, "utf8");
+      const raw = await fs19.readFile(manifestPath, "utf8");
       const manifest = JSON.parse(raw);
       completed = manifest.status === "completed";
     } catch {
@@ -10451,7 +10124,7 @@ async function getProjectStatus(projectRoot, opts = {}) {
   const config = await readConfig(projectRoot);
   const iamuPath = iamuDir(projectRoot);
   try {
-    await fs18.access(iamuPath);
+    await fs19.access(iamuPath);
   } catch {
     throw new Error(`status: iamu/ directory missing at ${iamuPath}`);
   }
@@ -10633,22 +10306,22 @@ var init_status = __esm({
 });
 
 // ../../packages/local-store/dist/prune.js
-import { promises as fs19 } from "fs";
-import path14 from "path";
+import { promises as fs20 } from "fs";
+import path15 from "path";
 async function getDirectoryStats(dirPath) {
   let bytes = 0;
   let count = 0;
   try {
-    const entries = await fs19.readdir(dirPath, { withFileTypes: true });
+    const entries = await fs20.readdir(dirPath, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path14.join(dirPath, entry.name);
+      const fullPath = path15.join(dirPath, entry.name);
       if (entry.isDirectory()) {
         const sub = await getDirectoryStats(fullPath);
         bytes += sub.bytes;
         count += sub.count;
       } else if (entry.isFile()) {
         try {
-          const s = await fs19.stat(fullPath);
+          const s = await fs20.stat(fullPath);
           bytes += s.size;
           count += 1;
         } catch {
@@ -10664,12 +10337,12 @@ async function getScreenshotsStats(screenshotsDir) {
   let count = 0;
   const paths = [];
   try {
-    const entries = await fs19.readdir(screenshotsDir, { withFileTypes: true });
+    const entries = await fs20.readdir(screenshotsDir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isFile() && (entry.name.endsWith(".png") || entry.name.endsWith(".jpg") || entry.name.endsWith(".jpeg") || entry.name.endsWith(".webp"))) {
-        const fullPath = path14.join(screenshotsDir, entry.name);
+        const fullPath = path15.join(screenshotsDir, entry.name);
         try {
-          const s = await fs19.stat(fullPath);
+          const s = await fs20.stat(fullPath);
           bytes += s.size;
           count += 1;
           paths.push(fullPath);
@@ -10689,8 +10362,8 @@ async function pruneRuns(projectRoot, opts = {}) {
     let timestamp2 = null;
     let scenarioSlug;
     try {
-      const manifestPath = path14.join(dirPath, "walkthrough.json");
-      const raw = await fs19.readFile(manifestPath, "utf-8");
+      const manifestPath = path15.join(dirPath, "walkthrough.json");
+      const raw = await fs20.readFile(manifestPath, "utf-8");
       const parsed = JSON.parse(raw);
       if (parsed.scenario_slug)
         scenarioSlug = parsed.scenario_slug;
@@ -10702,7 +10375,7 @@ async function pruneRuns(projectRoot, opts = {}) {
     }
     if (!timestamp2 || Number.isNaN(timestamp2.getTime())) {
       try {
-        const st = await fs19.stat(dirPath);
+        const st = await fs20.stat(dirPath);
         timestamp2 = st.mtime;
       } catch {
         timestamp2 = /* @__PURE__ */ new Date();
@@ -10737,12 +10410,12 @@ async function pruneRuns(projectRoot, opts = {}) {
   let totalScreenshotsDeleted = 0;
   let totalBytesReclaimed = 0;
   for (const c of candidates) {
-    const screenshotsDir = path14.join(c.dirPath, "screenshots");
+    const screenshotsDir = path15.join(c.dirPath, "screenshots");
     const shotStats = await getScreenshotsStats(screenshotsDir);
     if (opts.screenshotsOnly) {
       if (!opts.dryRun) {
         for (const shotPath of shotStats.paths) {
-          await fs19.unlink(shotPath).catch(() => {
+          await fs20.unlink(shotPath).catch(() => {
           });
         }
       }
@@ -10759,7 +10432,7 @@ async function pruneRuns(projectRoot, opts = {}) {
     } else {
       const dirStats = await getDirectoryStats(c.dirPath);
       if (!opts.dryRun) {
-        await fs19.rm(c.dirPath, { recursive: true, force: true });
+        await fs20.rm(c.dirPath, { recursive: true, force: true });
       }
       prunedRuns.push({
         runId: c.runId,
@@ -10791,8 +10464,8 @@ var init_prune = __esm({
 
 // ../../packages/local-store/dist/explore-map.js
 import { randomBytes as randomBytes2 } from "crypto";
-import { promises as fs20 } from "fs";
-import path15 from "path";
+import { promises as fs21 } from "fs";
+import path16 from "path";
 function templateToken(token) {
   if (token === "")
     return token;
@@ -10871,7 +10544,7 @@ function fnv1a(s) {
   return h.toString(16).padStart(8, "0");
 }
 function exploreDir(projectRoot) {
-  return path15.join(cacheDir(projectRoot), "explore");
+  return path16.join(cacheDir(projectRoot), "explore");
 }
 function composeExploreId(now, randomHex) {
   const ts = now.toISOString().replace(/[:.]/g, "-").replace(/Z$/, "");
@@ -10883,17 +10556,17 @@ function isValidExploreId(id) {
 function mapPath(projectRoot, id) {
   if (!isValidExploreId(id))
     throw new Error(`Not an explore map id: ${id}`);
-  return path15.join(exploreDir(projectRoot), id, "map.json");
+  return path16.join(exploreDir(projectRoot), id, "map.json");
 }
 async function writeExploreMap(projectRoot, map2) {
   const file = mapPath(projectRoot, map2.id);
-  await fs20.mkdir(path15.dirname(file), { recursive: true });
+  await fs21.mkdir(path16.dirname(file), { recursive: true });
   await atomicWriteFile(file, `${JSON.stringify(map2, null, 2)}
 `);
   return file;
 }
 async function readExploreMap(projectRoot, id) {
-  const raw = await fs20.readFile(mapPath(projectRoot, id), "utf8");
+  const raw = await fs21.readFile(mapPath(projectRoot, id), "utf8");
   const map2 = JSON.parse(raw);
   if (map2?.schema !== EXPLORE_MAP_SCHEMA || !Array.isArray(map2.surfaces)) {
     throw new Error(`Unreadable explore map: ${id}`);
@@ -10902,7 +10575,7 @@ async function readExploreMap(projectRoot, id) {
 }
 async function listExploreMaps(projectRoot) {
   try {
-    const entries = await fs20.readdir(exploreDir(projectRoot), {
+    const entries = await fs21.readdir(exploreDir(projectRoot), {
       withFileTypes: true
     });
     return entries.filter((e) => e.isDirectory() && isValidExploreId(e.name)).map((e) => e.name).sort();
@@ -11003,10 +10676,10 @@ async function readAllRunSteps(projectRoot) {
 function matchSurfaceCapabilities(place, capabilities) {
   const normPlace = place.length > 1 ? place.replace(/\/+$/, "") : place;
   const matchedCaps = /* @__PURE__ */ new Map();
-  for (const cap of capabilities) {
-    if (!cap.paths || cap.paths.length === 0)
+  for (const cap2 of capabilities) {
+    if (!cap2.paths || cap2.paths.length === 0)
       continue;
-    for (const rawPath of cap.paths) {
+    for (const rawPath of cap2.paths) {
       if (!rawPath)
         continue;
       const cleanPath = rawPath.length > 1 ? rawPath.replace(/\/+$/, "") : rawPath;
@@ -11017,9 +10690,9 @@ function matchSurfaceCapabilities(place, capabilities) {
         isMatch = normPlace === cleanPath || normPlace.startsWith(`${cleanPath}/`) || normPlace.startsWith(`${cleanPath}?`) || normPlace.startsWith(`${cleanPath}#`);
       }
       if (isMatch) {
-        const prevLen = matchedCaps.get(cap.slug) ?? -1;
+        const prevLen = matchedCaps.get(cap2.slug) ?? -1;
         if (cleanPath.length > prevLen) {
-          matchedCaps.set(cap.slug, cleanPath.length);
+          matchedCaps.set(cap2.slug, cleanPath.length);
         }
       }
     }
@@ -11122,94 +10795,831 @@ function groupUnassignedByPrefix(surfaces) {
       g.examples.push(pathOnly);
     }
   }
-  return [...groups.values()].sort((a, b) => b.surfaces - a.surfaces || a.prefix.localeCompare(b.prefix));
+  return [...groups.values()].sort((a, b) => b.surfaces - a.surfaces || a.prefix.localeCompare(b.prefix));
+}
+async function readCapabilityCoverage(projectRoot, coverage) {
+  const [capsResult, outlinesResult] = await Promise.all([
+    listEntities(projectRoot, "capability"),
+    listEntities(projectRoot, "outline")
+  ]);
+  const caps = capsResult.entities.map((e) => ({
+    slug: e.frontmatter.slug,
+    title: e.frontmatter.title,
+    area: e.frontmatter.area ?? null,
+    paths: e.frontmatter.paths ?? []
+  }));
+  const outlines = outlinesResult.entities.map((e) => ({
+    primary_capability: e.frontmatter.primary_capability,
+    additional_capabilities: e.frontmatter.additional_capabilities ?? []
+  }));
+  return summarizeCapabilityCoverage(coverage.surfaces, caps, outlines);
+}
+function actionSignature(a) {
+  const where = a.outcome.kind === "surface" ? a.outcome.surface : a.outcome.kind === "skipped" ? `skipped:${a.outcome.reason}` : a.outcome.kind === "external" ? `external:${a.outcome.url}` : a.outcome.kind;
+  return `${a.role} "${a.name}" \u2192 ${where}`;
+}
+function diffExploreMaps(a, b) {
+  const aByKey = new Map(a.surfaces.map((s) => [s.key, s]));
+  const bByKey = new Map(b.surfaces.map((s) => [s.key, s]));
+  const ref = (s) => ({
+    key: s.key,
+    label: s.label
+  });
+  const onlyA = a.surfaces.filter((s) => !bByKey.has(s.key)).map(ref);
+  const onlyB = b.surfaces.filter((s) => !aByKey.has(s.key)).map(ref);
+  const changed = [];
+  let common2 = 0;
+  for (const sa of a.surfaces) {
+    const sb = bByKey.get(sa.key);
+    if (!sb)
+      continue;
+    common2++;
+    const setA = new Set(sa.actions.map(actionSignature));
+    const setB = new Set(sb.actions.map(actionSignature));
+    const inA = [...setA].filter((x) => !setB.has(x)).sort();
+    const inB = [...setB].filter((x) => !setA.has(x)).sort();
+    if (inA.length > 0 || inB.length > 0) {
+      changed.push({ ...ref(sa), only_a: inA, only_b: inB });
+    }
+  }
+  const union2 = common2 + onlyA.length + onlyB.length;
+  return {
+    a: a.id,
+    b: b.id,
+    common: common2,
+    only_a: onlyA,
+    only_b: onlyB,
+    surface_overlap: union2 === 0 ? 1 : common2 / union2,
+    changed_actions: changed
+  };
+}
+var EXPLORE_MAP_SCHEMA, UUID, DATE, MAP_ID;
+var init_explore_map = __esm({
+  "../../packages/local-store/dist/explore-map.js"() {
+    "use strict";
+    init_atomic();
+    init_entity();
+    init_paths();
+    init_revisit();
+    init_runs();
+    init_walkthrough_canonical2();
+    EXPLORE_MAP_SCHEMA = 1;
+    UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    DATE = /^\d{4}-\d{2}-\d{2}$/;
+    MAP_ID = /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}-[0-9a-f]{6}$/;
+  }
+});
+
+// ../../packages/local-store/dist/journey-diff.js
+function isProblemFinding(type2) {
+  return PROBLEM_TYPES2.has(type2.toLowerCase());
+}
+function levenshteinDistance(a, b) {
+  if (a === b)
+    return 0;
+  if (!a.length)
+    return b.length;
+  if (!b.length)
+    return a.length;
+  const row = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i++) {
+    let prev = i;
+    for (let j = 1; j <= b.length; j++) {
+      const val = a[i - 1] === b[j - 1] ? row[j - 1] : Math.min(row[j - 1], prev, row[j]) + 1;
+      row[j - 1] = prev;
+      prev = val;
+    }
+    row[b.length] = prev;
+  }
+  return row[b.length];
+}
+function normalizeAction(action) {
+  if (!action)
+    return "";
+  return action.toLowerCase().replace(/['"`]/g, "").replace(/[^\p{L}\p{N}\s/_-]+/gu, " ").replace(/\s+/g, " ").trim();
+}
+function actionTokens(action) {
+  const norm = normalizeAction(action);
+  if (!norm)
+    return /* @__PURE__ */ new Set();
+  return new Set(norm.split(/\s+/).filter(Boolean));
+}
+function actionSimilarity(a, b) {
+  const normA = normalizeAction(a);
+  const normB = normalizeAction(b);
+  if (!normA && !normB)
+    return 1;
+  if (!normA || !normB)
+    return 0;
+  if (normA === normB)
+    return 1;
+  const tokensA = actionTokens(normA);
+  const tokensB = actionTokens(normB);
+  let intersection = 0;
+  for (const t of tokensA) {
+    if (tokensB.has(t))
+      intersection++;
+  }
+  if (intersection === 0) {
+    if (tokensA.size <= 1 && tokensB.size <= 1) {
+      const maxLen = Math.max(normA.length, normB.length);
+      const levDist = levenshteinDistance(normA, normB);
+      return levDist <= 2 && maxLen > 0 ? 1 - levDist / maxLen : 0;
+    }
+    return 0;
+  }
+  const union2 = tokensA.size + tokensB.size - intersection;
+  const jaccard = union2 > 0 ? intersection / union2 : 0;
+  const minSize = Math.min(tokensA.size, tokensB.size);
+  const subsetRatio = minSize > 0 ? intersection / minSize : 0;
+  if (normA.includes(normB) || normB.includes(normA) || subsetRatio === 1) {
+    return Math.max(0.85, 0.7 + 0.3 * jaccard);
+  }
+  return 0.5 * jaccard + 0.5 * subsetRatio;
+}
+function routeSimilarity(urlA, surfaceA, urlB, surfaceB) {
+  const normUrlA = normalizePlaceKey(urlA);
+  const normUrlB = normalizePlaceKey(urlB);
+  const hasUrlA = normUrlA !== null;
+  const hasUrlB = normUrlB !== null;
+  let urlScore = null;
+  if (hasUrlA && hasUrlB) {
+    if (normUrlA === normUrlB) {
+      urlScore = 1;
+    } else {
+      const pathA = normUrlA.split("?")[0];
+      const pathB = normUrlB.split("?")[0];
+      urlScore = pathA === pathB ? 0.8 : 0;
+    }
+  }
+  const sA = surfaceA?.trim();
+  const sB = surfaceB?.trim();
+  let surfaceScore = null;
+  if (sA && sB) {
+    if (surfaceKey(sA) === surfaceKey(sB)) {
+      surfaceScore = 1;
+    } else if (surfaceMatches(sA, sB) || surfaceMatches(sB, sA)) {
+      surfaceScore = 0.8;
+    } else {
+      surfaceScore = 0;
+    }
+  }
+  if (urlScore !== null && surfaceScore !== null) {
+    if (urlScore >= 0.8 && surfaceScore >= 0.8)
+      return 1;
+    if (urlScore >= 0.8)
+      return 0.85;
+    if (surfaceScore >= 0.8)
+      return 0.75;
+    return 0;
+  }
+  if (urlScore !== null)
+    return urlScore;
+  if (surfaceScore !== null)
+    return surfaceScore;
+  return 0.5;
+}
+function stepSimilarity(a, b) {
+  const rSim = routeSimilarity(a.url, a.surface, b.url, b.surface);
+  const aSim = actionSimilarity(a.action, b.action);
+  if (aSim < 0.25 && a.action && b.action) {
+    return Math.min(0.2, rSim * 0.2);
+  }
+  if (rSim === 0) {
+    return aSim >= 0.8 ? aSim * 0.4 : 0.1;
+  }
+  return 0.5 * rSim + 0.5 * aSim;
+}
+function findingMatchesStep(finding, stepNumber2) {
+  if (finding.linked_step_ids && finding.linked_step_ids.length > 0) {
+    return finding.linked_step_ids.some((id) => id === `step-${stepNumber2}` || id === String(stepNumber2));
+  }
+  if (finding.walkthrough_step_id) {
+    const raw = finding.walkthrough_step_id.trim();
+    if (raw === `step-${stepNumber2}` || raw === String(stepNumber2)) {
+      return true;
+    }
+  }
+  return false;
+}
+function isStallNote(note) {
+  if (!note)
+    return false;
+  const lower = note.toLowerCase();
+  return STALL_KEYWORDS.some((kw) => lower.includes(kw));
+}
+function alignJourneySteps(scenario, baselineRunId, currentRunId, baselineSteps, baselineFindings, currentSteps, currentFindings) {
+  const m = baselineSteps.length;
+  const n = currentSteps.length;
+  const GAP_PENALTY = -0.7;
+  const MATCH_THRESHOLD = 0.45;
+  const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i2 = 0; i2 <= m; i2++)
+    dp[i2][0] = i2 * GAP_PENALTY;
+  for (let j2 = 0; j2 <= n; j2++)
+    dp[0][j2] = j2 * GAP_PENALTY;
+  for (let i2 = 1; i2 <= m; i2++) {
+    for (let j2 = 1; j2 <= n; j2++) {
+      const sim = stepSimilarity(baselineSteps[i2 - 1], currentSteps[j2 - 1]);
+      const matchScore = sim >= MATCH_THRESHOLD ? sim * 2 - 0.2 : -1.5;
+      const match2 = dp[i2 - 1][j2 - 1] + matchScore;
+      const delP = dp[i2 - 1][j2] + GAP_PENALTY;
+      const insC = dp[i2][j2 - 1] + GAP_PENALTY;
+      dp[i2][j2] = Math.max(match2, delP, insC);
+    }
+  }
+  const alignedPairs = [];
+  let i = m;
+  let j = n;
+  while (i > 0 || j > 0) {
+    if (i > 0 && j > 0) {
+      const sim = stepSimilarity(baselineSteps[i - 1], currentSteps[j - 1]);
+      const matchScore = sim >= MATCH_THRESHOLD ? sim * 2 - 0.2 : -1.5;
+      const scoreFromMatch = dp[i - 1][j - 1] + matchScore;
+      if (Math.abs(dp[i][j] - scoreFromMatch) < 1e-6 && sim >= MATCH_THRESHOLD) {
+        alignedPairs.push({
+          baseline: baselineSteps[i - 1],
+          current: currentSteps[j - 1]
+        });
+        i--;
+        j--;
+        continue;
+      }
+    }
+    if (j > 0 && Math.abs(dp[i][j] - (dp[i][j - 1] + GAP_PENALTY)) < 1e-6) {
+      alignedPairs.push({
+        baseline: null,
+        current: currentSteps[j - 1]
+      });
+      j--;
+    } else if (i > 0 && Math.abs(dp[i][j] - (dp[i - 1][j] + GAP_PENALTY)) < 1e-6) {
+      alignedPairs.push({
+        baseline: baselineSteps[i - 1],
+        current: null
+      });
+      i--;
+    } else if (i > 0 && j > 0) {
+      alignedPairs.push({
+        baseline: baselineSteps[i - 1],
+        current: currentSteps[j - 1]
+      });
+      i--;
+      j--;
+    } else if (i > 0) {
+      alignedPairs.push({
+        baseline: baselineSteps[i - 1],
+        current: null
+      });
+      i--;
+    } else {
+      alignedPairs.push({
+        baseline: null,
+        current: currentSteps[j - 1]
+      });
+      j--;
+    }
+  }
+  alignedPairs.reverse();
+  const maxBaselineStepNum = baselineSteps.length > 0 ? Math.max(...baselineSteps.map((s) => s.step_number)) : -1;
+  const alignedSteps = [];
+  const stats = {
+    totalAlignedSteps: alignedPairs.length,
+    same: 0,
+    resolved: 0,
+    persists: 0,
+    regressions: 0,
+    stalledInBaseline: 0,
+    bypassed: 0,
+    newPath: 0
+  };
+  for (let idx = 0; idx < alignedPairs.length; idx++) {
+    const pair = alignedPairs[idx];
+    const bStep = pair.baseline;
+    const cStep = pair.current;
+    const bFindings = bStep ? baselineFindings.filter((f) => findingMatchesStep(f, bStep.step_number)) : [];
+    const cFindings = cStep ? currentFindings.filter((f) => findingMatchesStep(f, cStep.step_number)) : [];
+    const bProblems = bFindings.filter((f) => isProblemFinding(f.type));
+    const cProblems = cFindings.filter((f) => isProblemFinding(f.type));
+    let status2 = "same";
+    let summary = "Clean";
+    if (bStep && cStep) {
+      const wasStall = bStep.step_number === maxBaselineStepNum && (bProblems.length > 0 || isStallNote(bStep.note));
+      if (bProblems.length > 0 && cProblems.length === 0) {
+        status2 = "resolved";
+        stats.resolved++;
+        const probDesc = bProblems[0].ui_fact || bProblems[0].title || bProblems[0].id;
+        summary = wasStall ? `Previous stall resolved \u2014 journey unblocked (${probDesc})` : `Resolved previous issue: ${probDesc}`;
+      } else if (bProblems.length > 0 && cProblems.length > 0) {
+        status2 = "persists";
+        stats.persists++;
+        const probDesc = cProblems[0].ui_fact || cProblems[0].title || cProblems[0].id;
+        summary = `Problem persists: ${probDesc}`;
+      } else if (bProblems.length === 0 && cProblems.length > 0) {
+        status2 = "regression";
+        stats.regressions++;
+        const probDesc = cProblems[0].ui_fact || cProblems[0].title || cProblems[0].id;
+        summary = `New issue reported: ${probDesc}`;
+      } else {
+        status2 = "same";
+        stats.same++;
+        summary = "Clean";
+      }
+    } else if (bStep && !cStep) {
+      const wasStall = bStep.step_number === maxBaselineStepNum && (bProblems.length > 0 || isStallNote(bStep.note));
+      if (wasStall) {
+        status2 = "stalled";
+        stats.stalledInBaseline++;
+        const probDesc = bProblems[0]?.ui_fact || bProblems[0]?.title || "journey halted";
+        summary = `Stalled in baseline: ${probDesc}`;
+      } else {
+        status2 = "bypassed";
+        stats.bypassed++;
+        summary = "Bypassed in current run";
+      }
+    } else if (!bStep && cStep) {
+      if (cProblems.length > 0) {
+        status2 = "regression";
+        stats.regressions++;
+        const probDesc = cProblems[0].ui_fact || cProblems[0].title || cProblems[0].id;
+        summary = `New step with issue: ${probDesc}`;
+      } else {
+        status2 = "new_path";
+        stats.newPath++;
+        summary = "New path / unblocked progress";
+      }
+    }
+    alignedSteps.push({
+      index: idx + 1,
+      status: status2,
+      baselineStep: bStep,
+      currentStep: cStep,
+      baselineFindings: bFindings,
+      currentFindings: cFindings,
+      summary
+    });
+  }
+  return {
+    scenario,
+    baselineRunId,
+    currentRunId,
+    steps: alignedSteps,
+    stats
+  };
+}
+function toStepFindingInfo(f) {
+  return {
+    id: f.frontmatter.id,
+    title: f.frontmatter.title ?? f.slug,
+    type: f.frontmatter.type,
+    severity: f.frontmatter.severity,
+    ui_fact: f.frontmatter.ui_fact,
+    consequence: f.frontmatter.consequence,
+    canonical_id: f.frontmatter.canonical_id,
+    walkthrough_step_id: f.frontmatter.walkthrough_step_id
+  };
+}
+function toJourneyStepInfo(s) {
+  return {
+    step_number: s.step_number,
+    action: s.action,
+    url: s.url ?? void 0,
+    surface: s.surface ?? void 0,
+    note: s.note ?? void 0
+  };
+}
+function journeyStepRoute(step) {
+  return step.currentStep?.url && normalizePlaceKey(step.currentStep.url) || step.baselineStep?.url && normalizePlaceKey(step.baselineStep.url) || step.currentStep?.surface || step.baselineStep?.surface || "\u2014";
+}
+async function computeJourneyDiff(projectRoot, baselineRunId, currentRunId, scenarioSlug) {
+  const [bStepsRaw, bFindingsRaw, cStepsRaw, cFindingsRaw] = await Promise.all([
+    readStepsForRun(projectRoot, baselineRunId),
+    readFindingsForRun(projectRoot, baselineRunId),
+    readStepsForRun(projectRoot, currentRunId),
+    readFindingsForRun(projectRoot, currentRunId)
+  ]);
+  const baselineSteps = bStepsRaw.map(toJourneyStepInfo);
+  const baselineFindings = bFindingsRaw.map(toStepFindingInfo);
+  const currentSteps = cStepsRaw.map(toJourneyStepInfo);
+  const currentFindings = cFindingsRaw.map(toStepFindingInfo);
+  return alignJourneySteps(scenarioSlug ?? "", baselineRunId, currentRunId, baselineSteps, baselineFindings, currentSteps, currentFindings);
+}
+function renderJourneyDiffMarkdown(diff) {
+  const lines = [
+    "### Chronological journey diff",
+    "",
+    `Baseline: \`${diff.baselineRunId}\` vs Current: \`${diff.currentRunId}\``
+  ];
+  const parts = [];
+  if (diff.stats.same > 0)
+    parts.push(`${diff.stats.same} unchanged`);
+  if (diff.stats.resolved > 0)
+    parts.push(`${diff.stats.resolved} resolved`);
+  if (diff.stats.persists > 0)
+    parts.push(`${diff.stats.persists} persists`);
+  if (diff.stats.regressions > 0)
+    parts.push(`${diff.stats.regressions} new issues`);
+  if (diff.stats.stalledInBaseline > 0)
+    parts.push(`${diff.stats.stalledInBaseline} stalled in baseline`);
+  if (diff.stats.bypassed > 0)
+    parts.push(`${diff.stats.bypassed} bypassed`);
+  if (diff.stats.newPath > 0)
+    parts.push(`${diff.stats.newPath} new path steps`);
+  if (parts.length > 0) {
+    lines.push(`- **Summary**: ${parts.join(", ")}`);
+  }
+  lines.push("", "| # | Route | Baseline (Run N-1) | Current (Run N) | Status | Notes |", "|---|-------|--------------------|-----------------|--------|-------|");
+  for (const step of diff.steps) {
+    const route = journeyStepRoute(step);
+    const baseAction = step.baselineStep ? `Step ${step.baselineStep.step_number}: ${escapeMarkdownCell(step.baselineStep.action)}` : "\u2014";
+    const currAction = step.currentStep ? `Step ${step.currentStep.step_number}: ${escapeMarkdownCell(step.currentStep.action)}` : "\u2014";
+    const statusBadge = `\`${step.status}\``;
+    const notes = escapeMarkdownCell(step.summary);
+    lines.push(`| ${step.index} | \`${escapeMarkdownCell(route)}\` | ${baseAction} | ${currAction} | ${statusBadge} | ${notes} |`);
+  }
+  return lines.join("\n");
+}
+function escapeMarkdownCell(text) {
+  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+var PROBLEM_TYPES2, STALL_KEYWORDS;
+var init_journey_diff = __esm({
+  "../../packages/local-store/dist/journey-diff.js"() {
+    "use strict";
+    init_revisit();
+    init_walkthrough_canonical2();
+    PROBLEM_TYPES2 = /* @__PURE__ */ new Set(["hinders", "missing", "incorrect"]);
+    STALL_KEYWORDS = [
+      "blocked",
+      "unable to proceed",
+      "stalled",
+      "halted",
+      "stuck",
+      "cannot proceed",
+      "could not proceed",
+      "failed to load",
+      "timed out"
+    ];
+  }
+});
+
+// ../../packages/local-store/dist/report-markdown.js
+function runVerdict(canonical) {
+  const judged = (canonical?.human_tests ?? []).map((t) => t.verdict).filter((v) => v === "yes" || v === "no" || v === "partial");
+  if (judged.length === 0)
+    return null;
+  if (judged.every((v) => v === "yes"))
+    return "yes";
+  if (judged.every((v) => v === "no"))
+    return "no";
+  return "partial";
+}
+function rank(value, order) {
+  const i = order.indexOf(value ?? "");
+  return i === -1 ? order.length : i;
+}
+function pagePath(url) {
+  if (!url)
+    return null;
+  try {
+    return new URL(url).pathname;
+  } catch {
+    return url;
+  }
+}
+function dayOf(value) {
+  const m = /^(\d{4}-\d{2}-\d{2})/.exec(value ?? "");
+  return m?.[1] ?? null;
+}
+function stepNumbers(ids) {
+  const nums = (ids ?? []).map((id) => /\d+/.exec(id)?.[0]).filter((n) => Boolean(n));
+  if (nums.length === 0)
+    return "";
+  return ` (step${nums.length === 1 ? "" : "s"} ${nums.join(", ")})`;
+}
+function titleOf(f) {
+  if (f.title)
+    return f.title;
+  const fact = f.ui_fact ?? f.id;
+  return /^(.+?[.!?])(\s|$)/.exec(fact)?.[1] ?? fact;
+}
+function renderHumanTest(c, lines) {
+  lines.push("", "## The human test");
+  const verdict = runVerdict(c);
+  const label = verdict ? `**${cap(verdict)}**` : c.blocked ? "_skipped (walk blocked)_" : "_pending judge_";
+  lines.push("", `**${c.human_test_overall.question}** ${label}`);
+  if (c.human_test_overall.answer) {
+    lines.push("", c.human_test_overall.answer);
+    if (c.human_test_overall.reasoning) {
+      lines.push("", c.human_test_overall.reasoning);
+    }
+  }
+  if (c.human_tests.length === 0) {
+    lines.push("", "_No human tests on the outline._");
+    return;
+  }
+  lines.push("");
+  for (const ht of c.human_tests) {
+    const v = ht.verdict ? `**${cap(ht.verdict.replace("_", " "))}.**` : "_Pending._";
+    lines.push(`- ${stripAnswerHint(ht.question)} ${v}${ht.reasoning ? ` ${ht.reasoning}` : ""}`);
+  }
+}
+function severityShift(before, now) {
+  if (!before || !now || before === now)
+    return "";
+  const b = rank(before, SEVERITY_ORDER);
+  const n = rank(now, SEVERITY_ORDER);
+  if (b === n)
+    return "";
+  return `${n > b ? "less severe" : "worse"}, ${before} \u2192 ${now}`;
+}
+function checkOutcomes(c) {
+  const checks = c.checks;
+  if (!checks)
+    return [];
+  const v = c.verification;
+  const fixed = new Set(v?.resolved.map((r) => r.canonical_id) ?? []);
+  const seen = new Set(c.findings.map((f) => f.canonical_id).filter(Boolean));
+  return checks.fixes.map((f) => ({
+    ...f,
+    outcome: f.canonical_id && fixed.has(f.canonical_id) ? "fixed" : f.canonical_id && seen.has(f.canonical_id) ? "came_back" : "unconfirmed"
+  }));
+}
+function renderChecks(c, checks, lines) {
+  lines.push("", "## What this run checks");
+  const fixes = checkOutcomes(c);
+  if (fixes.length > 0) {
+    const count = (o) => fixes.filter((f) => f.outcome === o).length;
+    lines.push("", `${fixes.length} fix${fixes.length === 1 ? " was" : "es were"} waiting for a re-check: ${count("fixed")} confirmed fixed, ${count("came_back")} came back, ${count("unconfirmed")} not confirmed either way.`, "");
+    const order = ["came_back", "fixed", "unconfirmed"];
+    const sorted = [...fixes].sort((a, b) => order.indexOf(a.outcome) - order.indexOf(b.outcome));
+    for (const f of sorted) {
+      const where = [
+        pagePath(f.page) ? `\`${pagePath(f.page)}\`` : "",
+        f.reached ? "" : "not reached"
+      ].filter(Boolean).join(", ");
+      lines.push(`- ${OUTCOME_TEXT[f.outcome]}: **${f.title}**${f.fix ? `. Fix: ${f.fix}` : ""}${where ? ` (${where})` : ""}`);
+    }
+  }
+  if (checks.directions.length > 0) {
+    lines.push("", `Directions completed since the last run: ${checks.directions.map((d) => `**${d}**`).join(", ")}.`);
+  }
+}
+function sinceRow(item, outcome) {
+  const qualifiers = [
+    outcome === "Persists" ? severityShift(item.severity_before, item.severity_now) : "",
+    outcome === "Persists" && item.fixed_before ? "the fix did not hold" : ""
+  ].filter(Boolean);
+  const now = outcome === "Resolved" || outcome === "Persists" ? `**${outcome}**${qualifiers.length > 0 ? ` (${qualifiers.join("; ")})` : ""}` : outcome;
+  const note = outcome === "Not seen" ? `The walk did not pass this way${item.fixed_before ? " (fixed, awaiting a re-check)" : ""}. Not evidence of a fix.` : `${item.note ?? ""}${stepNumbers(item.step_ids)}`.trim();
+  return `| ${cell(item.title)} | ${now} | ${cell(note) || "\u2014"} |`;
+}
+function renderSince(v, newProblems, newStrengths, lines) {
+  const day = dayOf(v.baseline_run_id);
+  lines.push("", "## Since the last run", "", `Compared with the run of ${day ?? v.baseline_run_id}.`);
+  const rows = [
+    ...v.resolved.map((i) => sinceRow(i, "Resolved")),
+    ...v.persists.map((i) => sinceRow(i, "Persists")),
+    ...v.not_observed.map((i) => sinceRow(i, "Not seen")),
+    ...v.uncertain.map((i) => sinceRow(i, "Unclear"))
+  ];
+  if (rows.length > 0) {
+    lines.push("", "| Earlier finding | Now | Notes |", "|---|---|---|", ...rows);
+  }
+  const added = [
+    newProblems > 0 ? `${newProblems} problem${newProblems === 1 ? "" : "s"}` : "",
+    newStrengths > 0 ? `${newStrengths} strength${newStrengths === 1 ? "" : "s"}` : ""
+  ].filter(Boolean);
+  lines.push("", added.length > 0 ? `New this run: ${added.join(" and ")}, marked _new_ below.` : "Nothing new this run.");
+}
+function renderFinding(c, f, n, since, lines) {
+  lines.push("", `### ${n}. ${titleOf(f)}`);
+  const steps = f.linked_step_ids.map((id) => c.steps.find((s) => s.id === id)).filter((s) => Boolean(s));
+  const page = pagePath(f.page_url ?? steps[0]?.url);
+  const where = [
+    page ? `\`${page}\`` : "",
+    steps.length > 0 ? `step ${steps.map((s) => s.step_number).join(", ")}` : ""
+  ].filter(Boolean).join(" ");
+  const meta = [
+    f.severity ? `**${cap(f.severity)}**` : "",
+    f.type,
+    f.task_impact ? TASK_IMPACT[f.task_impact] : "",
+    where,
+    since ? `_${since}_` : ""
+  ].filter(Boolean);
+  lines.push("", meta.join(" \xB7 "));
+  if (f.ui_fact === null || f.consequence === null) {
+    lines.push("", "> _Legacy finding: predates the UI-fact / consequence depth gate._");
+  }
+  if (f.ui_fact)
+    lines.push("", f.ui_fact);
+  if (f.consequence) {
+    const who = c.scenario.persona_name;
+    lines.push("", `> ${f.consequence}${who ? ` \u2014 ${who}` : ""}`);
+  }
+  if (f.recommendation)
+    lines.push("", `**Recommendation:** ${f.recommendation}`);
+  for (const s of steps) {
+    if (s.screenshot_ref) {
+      lines.push("", `![Step ${s.step_number}](${s.screenshot_ref})`);
+    }
+  }
+}
+function renderAnalysis(analysis, lines) {
+  if (analysis.directions.length > 0) {
+    lines.push("", "## Directions", "", `_Structural changes proposed by ${analysis.advisor} after the walk. Reach is a prediction until the listed scenarios are re-run._`);
+    for (const d of analysis.directions) {
+      lines.push("", `### ${d.title} (${d.size})`, "", d.change);
+      lines.push("", `Absorbs ${d.absorbs.length} finding${d.absorbs.length === 1 ? "" : "s"}.`);
+      for (const r of d.reach.filter((x) => x.effect === "helps"))
+        lines.push(`- Likely helps ${r.scenario}: ${r.reason}`);
+      for (const r of d.reach.filter((x) => x.effect === "risk"))
+        lines.push(`- Could hurt ${r.scenario}: ${r.reason}`);
+      if (d.verify.length > 0)
+        lines.push("", `Re-run to verify: ${d.verify.join(", ")}`);
+    }
+  }
+  if (analysis.observations.length > 0) {
+    lines.push("", "## Also worth knowing", "");
+    for (const o of analysis.observations) {
+      const label = o.kind === "coverage_gap" ? "Not walked" : "Feature risk";
+      lines.push(`- **${label}: ${o.title}.** ${o.detail}`);
+      if (o.suggested_scenario) {
+        lines.push(`  Suggested scenario: ${o.suggested_scenario}`);
+      }
+    }
+  }
 }
-async function readCapabilityCoverage(projectRoot, coverage) {
-  const [capsResult, outlinesResult] = await Promise.all([
-    listEntities(projectRoot, "capability"),
-    listEntities(projectRoot, "outline")
-  ]);
-  const caps = capsResult.entities.map((e) => ({
-    slug: e.frontmatter.slug,
-    title: e.frontmatter.title,
-    area: e.frontmatter.area ?? null,
-    paths: e.frontmatter.paths ?? []
-  }));
-  const outlines = outlinesResult.entities.map((e) => ({
-    primary_capability: e.frontmatter.primary_capability,
-    additional_capabilities: e.frontmatter.additional_capabilities ?? []
-  }));
-  return summarizeCapabilityCoverage(coverage.surfaces, caps, outlines);
+function renderRunDetails(c, lines) {
+  lines.push("", "## Run details", "", `- Run ID: ${c.run_id}`, `- Target URL: ${c.target.url}`);
+  if (c.environment)
+    lines.push(`- Environment: ${c.environment}`);
+  if (c.build) {
+    const commit = c.build.git_sha?.slice(0, 7);
+    const build = [
+      c.build.label,
+      c.build.git_branch,
+      c.build.git_dirty && c.build.worktree_hash ? `${commit ?? "HEAD"} + uncommitted changes (${c.build.worktree_hash.slice(0, 6)}\u2026)` : commit,
+      c.build.ci?.provider
+    ].filter(Boolean).join(" \xB7 ");
+    if (build)
+      lines.push(`- Build: ${build}`);
+  }
+  if (c.viewport) {
+    lines.push(`- Viewport: ${c.viewport.device} (${c.viewport.width}\xD7${c.viewport.height})`);
+  }
+  lines.push(`- Started: ${c.provenance.started_at}`, `- Completed: ${c.provenance.completed_at}`, `- Walker prompt: ${c.provenance.walker_prompt.id}@${c.provenance.walker_prompt.version}`);
+  const models = c.models;
+  if (models) {
+    const parts = [
+      models.walker ? `Walker: ${models.walker}${models.walker_reported ? ` (${models.walker_reported})` : ""}` : "",
+      models.judge ? `Judge: ${models.judge}${models.judge_reported ? ` (${models.judge_reported})` : ""}` : "",
+      models.matcher ? `Matcher: ${models.matcher}` : ""
+    ].filter(Boolean);
+    if (parts.length > 0)
+      lines.push(`- Models: ${parts.join(" \xB7 ")}`);
+    if (typeof models.velocity_sec_per_step === "number") {
+      lines.push(`- Velocity: ~${models.velocity_sec_per_step}s/step (${models.total_duration_sec}s total)`);
+    }
+  }
+  const diff = c.journey_diff;
+  if (diff)
+    lines.push("", renderJourneyDiffMarkdown(diff));
 }
-function actionSignature(a) {
-  const where = a.outcome.kind === "surface" ? a.outcome.surface : a.outcome.kind === "skipped" ? `skipped:${a.outcome.reason}` : a.outcome.kind === "external" ? `external:${a.outcome.url}` : a.outcome.kind;
-  return `${a.role} "${a.name}" \u2192 ${where}`;
+function renderSteps(c, lines) {
+  lines.push("", "## Steps");
+  if (c.steps.length === 0) {
+    lines.push("", "_No steps recorded._");
+    return;
+  }
+  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 ");
+    if (where)
+      lines.push("", `Page: ${where}`);
+    if (s.persona_reasoning)
+      lines.push("", `> ${s.persona_reasoning.replace(/\n/g, "\n> ")}`);
+    if (s.grounding)
+      lines.push("", `Grounding: ${s.grounding}`);
+    if (s.screenshot_ref)
+      lines.push("", `![Step ${s.step_number}](${s.screenshot_ref})`);
+  }
 }
-function diffExploreMaps(a, b) {
-  const aByKey = new Map(a.surfaces.map((s) => [s.key, s]));
-  const bByKey = new Map(b.surfaces.map((s) => [s.key, s]));
-  const ref = (s) => ({
-    key: s.key,
-    label: s.label
-  });
-  const onlyA = a.surfaces.filter((s) => !bByKey.has(s.key)).map(ref);
-  const onlyB = b.surfaces.filter((s) => !aByKey.has(s.key)).map(ref);
-  const changed = [];
-  let common2 = 0;
-  for (const sa of a.surfaces) {
-    const sb = bByKey.get(sa.key);
-    if (!sb)
-      continue;
-    common2++;
-    const setA = new Set(sa.actions.map(actionSignature));
-    const setB = new Set(sb.actions.map(actionSignature));
-    const inA = [...setA].filter((x) => !setB.has(x)).sort();
-    const inB = [...setB].filter((x) => !setA.has(x)).sort();
-    if (inA.length > 0 || inB.length > 0) {
-      changed.push({ ...ref(sa), only_a: inA, only_b: inB });
+function renderCanonicalMarkdown(canonical) {
+  const c = canonical;
+  const persona = c.scenario.persona_name ?? c.scenario.persona_slug;
+  const situation = c.scenario.outline_title ?? c.scenario.outline_slug;
+  const heading = persona && situation ? `${persona} \xB7 ${situation}` : c.scenario.slug;
+  const runNumber = c.run_number;
+  const subtitle = [
+    dayOf(c.provenance.completed_at),
+    runNumber ? `run ${runNumber} of this scenario` : "",
+    `${c.steps.length} step${c.steps.length === 1 ? "" : "s"}`,
+    c.target.url
+  ].filter(Boolean).join(" \xB7 ");
+  const lines = [
+    "<!-- GENERATED: do not edit by hand. Regen via complete_walkthrough or local-store renderer. -->",
+    "",
+    `# ${heading}`,
+    "",
+    subtitle
+  ];
+  if (c.scenario.persona_role) {
+    lines.push("", `${persona}, ${c.scenario.persona_role}.`);
+  }
+  if (c.blocked) {
+    lines.push("", "> **Blocked \u2014 the walk could not start as it was set up.**", `> ${c.blocked.reason}`, ">", "> This run is not compared with earlier runs and proves nothing about earlier findings. Fix the setup (the scenario's starting state or the persona's access) and run it again.");
+  }
+  const checks = c.checks;
+  if (checks)
+    renderChecks(c, checks, lines);
+  renderHumanTest(c, 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").sort((a, b) => rank(a.severity, SEVERITY_ORDER) - rank(b.severity, SEVERITY_ORDER) || rank(a.type, TYPE_ORDER) - rank(b.type, TYPE_ORDER));
+  const strengths = c.findings.filter((f) => f.type === "helps");
+  if (verification) {
+    renderSince(verification, problems.filter((f) => newIds.has(f.id)).length, strengths.filter((f) => newIds.has(f.id)).length, lines);
+  }
+  lines.push("", "## Findings");
+  if (problems.length === 0) {
+    lines.push("", "_No problems recorded._");
+  } else {
+    const bySeverity = SEVERITY_ORDER.map((s) => {
+      const n = problems.filter((f) => f.severity === s).length;
+      return n > 0 ? `${n} ${s}` : "";
+    }).filter(Boolean);
+    lines.push("", `${problems.length} problem${problems.length === 1 ? "" : "s"} (${bySeverity.join(", ")}), worst first.`);
+    const persisting = new Set(verification?.persists.map((p) => p.canonical_id) ?? []);
+    problems.forEach((f, i) => {
+      const since = newIds.has(f.id) ? "new" : f.canonical_id && persisting.has(f.canonical_id) ? "persists" : null;
+      renderFinding(c, f, i + 1, since, lines);
+    });
+  }
+  const analysis = c.analysis;
+  if (analysis)
+    renderAnalysis(analysis, lines);
+  const what = c.what_worked ?? [];
+  if (strengths.length > 0 || what.length > 0) {
+    lines.push("", "## What worked", "");
+    for (const f of strengths) {
+      lines.push(`- **${titleOf(f)}.** ${f.ui_fact ?? ""}`.trimEnd());
     }
+    for (const w of what)
+      lines.push(`- ${w}`);
   }
-  const union2 = common2 + onlyA.length + onlyB.length;
-  return {
-    a: a.id,
-    b: b.id,
-    common: common2,
-    only_a: onlyA,
-    only_b: onlyB,
-    surface_overlap: union2 === 0 ? 1 : common2 / union2,
-    changed_actions: changed
-  };
+  const open2 = c.open_questions ?? [];
+  if (open2.length > 0) {
+    lines.push("", "## Open questions", "");
+    for (const q of open2)
+      lines.push(`- ${q}`);
+  }
+  const setup = c.setup_notes ?? [];
+  if (setup.length > 0) {
+    lines.push("", "## Test setup notes", "", "_Doubts about the test, not the product: for whoever stages the scenario._", "");
+    for (const n of setup)
+      lines.push(`- ${n}`);
+  }
+  renderSteps(c, lines);
+  renderRunDetails(c, lines);
+  return `${lines.join("\n")}
+`;
 }
-var EXPLORE_MAP_SCHEMA, UUID, DATE, MAP_ID;
-var init_explore_map = __esm({
-  "../../packages/local-store/dist/explore-map.js"() {
+var SEVERITY_ORDER, TYPE_ORDER, TASK_IMPACT, cap, stripAnswerHint, cell, OUTCOME_TEXT;
+var init_report_markdown = __esm({
+  "../../packages/local-store/dist/report-markdown.js"() {
     "use strict";
-    init_atomic();
-    init_entity();
-    init_paths();
-    init_revisit();
-    init_runs();
-    init_walkthrough_canonical2();
-    EXPLORE_MAP_SCHEMA = 1;
-    UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-    DATE = /^\d{4}-\d{2}-\d{2}$/;
-    MAP_ID = /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}-[0-9a-f]{6}$/;
+    init_journey_diff();
+    SEVERITY_ORDER = ["critical", "major", "minor", "observation"];
+    TYPE_ORDER = ["incorrect", "hinders", "missing", "irrelevant", "helps"];
+    TASK_IMPACT = {
+      blocks: "blocks the task",
+      impairs: "impairs the task",
+      slows: "slows the task"
+    };
+    cap = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+    stripAnswerHint = (q) => q.replace(/\s*\((?:yes|no|partial)(?:\s*\/\s*(?:yes|no|partial))+\)\s*$/i, "");
+    cell = (s) => s.replace(/\|/g, "\\|").replace(/\n+/g, " ");
+    OUTCOME_TEXT = {
+      fixed: "**confirmed fixed**",
+      came_back: "**came back**",
+      unconfirmed: "not confirmed"
+    };
   }
 });
 
 // ../../packages/local-store/dist/human-test-link.js
-import { promises as fs21 } from "fs";
-import path16 from "path";
+import { promises as fs22 } from "fs";
+import path17 from "path";
 function humanTestLinks(verdicts) {
   const best = /* @__PURE__ */ new Map();
   for (const v of verdicts) {
-    const rank = VERDICT_RANK[v.verdict];
-    if (rank === void 0)
+    const rank2 = VERDICT_RANK[v.verdict];
+    if (rank2 === void 0)
       continue;
     for (const findingId of v.grounding_finding_ids) {
       const seen = best.get(findingId);
-      if (!seen || rank < seen.rank) {
-        best.set(findingId, { test: v.human_test_id, rank });
+      if (!seen || rank2 < seen.rank) {
+        best.set(findingId, { test: v.human_test_id, rank: rank2 });
       }
     }
   }
@@ -11222,7 +11632,7 @@ async function linkFindingsToHumanTests(projectRoot, runId, verdicts) {
   const dir = entityDirPath(projectRoot, "finding");
   let names2;
   try {
-    names2 = await fs21.readdir(dir);
+    names2 = await fs22.readdir(dir);
   } catch {
     return [];
   }
@@ -11230,11 +11640,11 @@ async function linkFindingsToHumanTests(projectRoot, runId, verdicts) {
   for (const name of names2) {
     if (!name.endsWith(".md") || name.startsWith("."))
       continue;
-    const file = path16.join(dir, name);
+    const file = path17.join(dir, name);
     let raw;
     let fm;
     try {
-      raw = await fs21.readFile(file, "utf8");
+      raw = await fs22.readFile(file, "utf8");
       fm = parseFrontmatter(raw).frontmatter;
     } catch {
       continue;
@@ -11465,14 +11875,14 @@ var init_cloud_client = __esm({
 });
 
 // ../../packages/local-store/dist/last-pull.js
-import { promises as fs22 } from "fs";
-import path17 from "path";
+import { promises as fs23 } from "fs";
+import path18 from "path";
 function lastPullPath(projectRoot) {
-  return path17.join(cacheDir(projectRoot), "last-pull.json");
+  return path18.join(cacheDir(projectRoot), "last-pull.json");
 }
 async function readLastPull(projectRoot) {
   try {
-    const raw = await fs22.readFile(lastPullPath(projectRoot), "utf8");
+    const raw = await fs23.readFile(lastPullPath(projectRoot), "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
       return parsed;
@@ -11578,7 +11988,7 @@ var init_types2 = __esm({
 });
 
 // ../../packages/local-store/dist/pull/frontmatter.js
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID7 } from "crypto";
 function resolveBody(row, fallback) {
   if (typeof row.bodyMarkdown === "string") {
     return { text: row.bodyMarkdown, fromCloud: true };
@@ -11620,7 +12030,7 @@ function buildOutlineFrontmatter(row, slug, capabilityIdToSlug) {
       missingCaps.push(capId);
   }
   const humanTests = (row.humanTests ?? []).map((h) => ({
-    id: h.id ?? randomUUID6().slice(0, 8),
+    id: h.id ?? randomUUID7().slice(0, 8),
     question: h.question
   }));
   const frontmatter = {
@@ -11787,7 +12197,7 @@ var init_frontmatter2 = __esm({
 });
 
 // ../../packages/local-store/dist/pull/write.js
-import { promises as fs23 } from "fs";
+import { promises as fs24 } from "fs";
 async function loadLocalIndex(projectRoot, type2) {
   const byId = /* @__PURE__ */ new Map();
   const bySlug = /* @__PURE__ */ new Map();
@@ -11818,7 +12228,7 @@ async function classifyExisting(projectRoot, type2, cloudId, localSlug, targetSl
   if (localSlug !== targetSlug)
     return "untracked";
   const lastSynced = localIndex.lastPushById[cloudId];
-  const bytes = await fs23.readFile(entityFilePath(projectRoot, type2, localSlug), "utf8");
+  const bytes = await fs24.readFile(entityFilePath(projectRoot, type2, localSlug), "utf8");
   return lastSynced && hashNormalizedContent(bytes) === lastSynced ? "fast_forward" : "diverged";
 }
 async function writeOrSkip(projectRoot, type2, cloudId, slug, frontmatter, body, localIndex, mode, cloudVersion) {
@@ -11879,13 +12289,13 @@ async function writeOrSkip(projectRoot, type2, cloudId, slug, frontmatter, body,
   }
   if (existingSlugForId && existingSlugForId !== slug) {
     try {
-      await fs23.unlink(entityFilePath(projectRoot, type2, existingSlugForId));
+      await fs24.unlink(entityFilePath(projectRoot, type2, existingSlugForId));
       localIndex.bySlug.delete(existingSlugForId);
     } catch {
     }
   }
   await writeEntity(projectRoot, type2, frontmatter, text);
-  const bytes = await fs23.readFile(entityFilePath(projectRoot, type2, slug), "utf8");
+  const bytes = await fs24.readFile(entityFilePath(projectRoot, type2, slug), "utf8");
   const hash = hashNormalizedContent(bytes);
   localIndex.byId.set(cloudId, slug);
   localIndex.bySlug.set(slug, cloudId);
@@ -11939,7 +12349,7 @@ var init_write = __esm({
 });
 
 // ../../packages/local-store/dist/pull/entities.js
-import { promises as fs24 } from "fs";
+import { promises as fs25 } from "fs";
 function buildContextFrontmatter(payload) {
   const cloudCtx = payload.context ?? {};
   const glossary = (payload.glossary ?? []).map((g) => ({
@@ -11994,7 +12404,7 @@ async function pullContext(projectRoot, cloud, projectId, mode, result) {
   const frontmatter = buildContextFrontmatter(payload);
   let hasLocal = false;
   try {
-    await fs24.access(contextPath(projectRoot));
+    await fs25.access(contextPath(projectRoot));
     hasLocal = true;
   } catch {
     hasLocal = false;
@@ -12024,7 +12434,7 @@ async function pullContext(projectRoot, cloud, projectId, mode, result) {
       frontmatter,
       notes_body: existingNotes
     });
-    const bytes = await fs24.readFile(contextPath(projectRoot), "utf8");
+    const bytes = await fs25.readFile(contextPath(projectRoot), "utf8");
     const hash = hashNormalizedContent(bytes);
     await recordLastPull(projectRoot, "context:root", hash);
     await recordLastPush(projectRoot, "context:root", hash);
@@ -12539,14 +12949,14 @@ var init_repair = __esm({
 });
 
 // ../../packages/local-store/dist/session-state.js
-import { randomUUID as randomUUID7 } from "crypto";
+import { randomUUID as randomUUID8 } from "crypto";
 import { closeSync as closeSync2, existsSync as existsSync2, fsyncSync as fsyncSync2, mkdirSync as mkdirSync2, openSync as openSync2, readFileSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
 import os2 from "os";
-import path18 from "path";
+import path19 from "path";
 function quarantineCorruptedSessionState(file, raw) {
   try {
-    const dir = path18.dirname(file);
-    const quarantine = path18.join(dir, `session-state.corrupted.${Date.now()}.json`);
+    const dir = path19.dirname(file);
+    const quarantine = path19.join(dir, `session-state.corrupted.${Date.now()}.json`);
     atomicWriteFileSync(quarantine, raw);
   } catch {
   }
@@ -12555,8 +12965,8 @@ function withSessionStateLock(filePath, fn) {
   const lockPath = `${filePath}.lock`;
   const deadline = Date.now() + 5e3;
   const staleMs = 15e3;
-  const token = randomUUID7();
-  mkdirSync2(path18.dirname(lockPath), { recursive: true });
+  const token = randomUUID8();
+  mkdirSync2(path19.dirname(lockPath), { recursive: true });
   const tryCreate = () => {
     try {
       const fd = openSync2(lockPath, "wx", 420);
@@ -12630,242 +13040,67 @@ function readSessionState(projectRoot) {
   const file = sessionStatePath(projectRoot);
   if (!existsSync2(file))
     return null;
-  try {
-    const raw = readFileSync(file, "utf-8");
-    if (!raw.trim())
-      return null;
-    const parsed = JSON.parse(raw);
-    if (parsed && typeof parsed === "object" && parsed.version === 1) {
-      return parsed;
-    }
-    quarantineCorruptedSessionState(file, raw);
-    return null;
-  } catch {
-    try {
-      const raw = readFileSync(file, "utf-8");
-      if (raw.trim()) {
-        quarantineCorruptedSessionState(file, raw);
-      }
-    } catch {
-    }
-    return null;
-  }
-}
-function updateSessionState(projectRoot, patch) {
-  const file = sessionStatePath(projectRoot);
-  const cacheDir2 = path18.dirname(file);
-  if (!existsSync2(cacheDir2)) {
-    mkdirSync2(cacheDir2, { recursive: true });
-  }
-  return withSessionStateLock(file, () => {
-    const existing = readSessionState(projectRoot);
-    const now = (/* @__PURE__ */ new Date()).toISOString();
-    const cleanRunPatch = patch.active_run ? Object.fromEntries(Object.entries(patch.active_run).filter(([_, v]) => v !== void 0)) : void 0;
-    const cleanFindingPatch = patch.active_finding ? Object.fromEntries(Object.entries(patch.active_finding).filter(([_, v]) => v !== void 0)) : void 0;
-    const next = {
-      version: 1,
-      updated_at: now,
-      active_scenario: patch.active_scenario ? { slug: patch.active_scenario.slug, updated_at: now } : existing?.active_scenario,
-      active_run: patch.active_run ? {
-        id: patch.active_run.id ?? existing?.active_run?.id ?? "",
-        scenario_slug: patch.active_run.scenario_slug ?? existing?.active_run?.scenario_slug ?? "",
-        status: patch.active_run.status ?? existing?.active_run?.status ?? "running",
-        ...existing?.active_run ?? {},
-        ...cleanRunPatch,
-        updated_at: now
-      } : existing?.active_run,
-      active_finding: patch.active_finding ? {
-        slug: patch.active_finding.slug,
-        ...existing?.active_finding ?? {},
-        ...cleanFindingPatch,
-        updated_at: now
-      } : existing?.active_finding,
-      active_persona: patch.active_persona ? { slug: patch.active_persona.slug, updated_at: now } : existing?.active_persona
-    };
-    atomicWriteFileSync(file, JSON.stringify(next, null, 2) + "\n");
-    return next;
-  });
-}
-var init_session_state = __esm({
-  "../../packages/local-store/dist/session-state.js"() {
-    "use strict";
-    init_atomic();
-    init_paths();
-  }
-});
-
-// ../../packages/local-store/dist/directions.js
-import { randomUUID as randomUUID8 } from "crypto";
-import { promises as fs25 } from "fs";
-import path19 from "path";
-import { z as z26 } from "zod";
-function directionsDir(projectRoot) {
-  return path19.join(iamuDir(projectRoot), DIRECTIONS_DIR);
-}
-function directionPath(projectRoot, slug) {
-  return path19.join(directionsDir(projectRoot), `${slug}.md`);
-}
-function renderBody(texts) {
-  return [
-    "## Problem",
-    "",
-    texts.problem.trim(),
-    "",
-    "## Change",
-    "",
-    texts.change.trim(),
-    "",
-    "## Leading practice",
-    "",
-    texts.leading_practice.trim(),
-    ""
-  ].join("\n");
-}
-function section(body, heading) {
-  const re = new RegExp(`^## ${heading}\\s*\\n([\\s\\S]*?)(?=^## |$(?![\\s\\S]))`, "m");
-  return re.exec(body)?.[1]?.trim() ?? "";
-}
-function parseDirection(raw, file) {
-  const { frontmatter, body } = parseFrontmatter(raw);
-  return {
-    frontmatter: directionFrontmatterSchema.parse(frontmatter),
-    texts: {
-      problem: section(body, "Problem"),
-      change: section(body, "Change"),
-      leading_practice: section(body, "Leading practice")
-    },
-    path: file
-  };
-}
-async function readDirection(projectRoot, slug) {
-  const file = directionPath(projectRoot, slug);
-  let raw;
-  try {
-    raw = await fs25.readFile(file, "utf8");
-  } catch (err) {
-    if (err.code === "ENOENT")
-      return null;
-    throw err;
-  }
-  return parseDirection(raw, file);
-}
-async function listDirections(projectRoot) {
-  let names2;
-  try {
-    names2 = await fs25.readdir(directionsDir(projectRoot));
-  } catch (err) {
-    if (err.code === "ENOENT")
-      return [];
-    throw err;
-  }
-  const out = [];
-  for (const name of names2.sort()) {
-    if (!name.endsWith(".md"))
-      continue;
-    const file = path19.join(directionsDir(projectRoot), name);
+  try {
+    const raw = readFileSync(file, "utf-8");
+    if (!raw.trim())
+      return null;
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && parsed.version === 1) {
+      return parsed;
+    }
+    quarantineCorruptedSessionState(file, raw);
+    return null;
+  } catch {
     try {
-      out.push(parseDirection(await fs25.readFile(file, "utf8"), file));
+      const raw = readFileSync(file, "utf-8");
+      if (raw.trim()) {
+        quarantineCorruptedSessionState(file, raw);
+      }
     } catch {
     }
+    return null;
   }
-  return out.sort((a, b) => b.frontmatter.updated_at.localeCompare(a.frontmatter.updated_at));
-}
-async function writeDirection(projectRoot, fm, texts) {
-  const file = directionPath(projectRoot, fm.slug);
-  const validated = directionFrontmatterSchema.parse(fm);
-  await atomicWriteFile(file, serializeFrontmatter(validated, renderBody(texts)));
-  return file;
 }
-async function upsertDirection(projectRoot, proposal, source, advisedBy, now = (/* @__PURE__ */ new Date()).toISOString()) {
-  const existing = await readDirection(projectRoot, proposal.slug);
-  const texts = {
-    problem: proposal.problem,
-    change: proposal.change,
-    leading_practice: proposal.leading_practice
-  };
-  if (existing?.frontmatter.status === "rejected") {
-    return { outcome: "previously_rejected" };
+function updateSessionState(projectRoot, patch) {
+  const file = sessionStatePath(projectRoot);
+  const cacheDir2 = path19.dirname(file);
+  if (!existsSync2(cacheDir2)) {
+    mkdirSync2(cacheDir2, { recursive: true });
   }
-  const prev = existing?.frontmatter;
-  const fm = {
-    id: prev?.id ?? randomUUID8(),
-    slug: proposal.slug,
-    title: proposal.title,
-    status: prev?.status ?? "proposed",
-    size: proposal.size,
-    absorbs: union(prev?.absorbs ?? [], proposal.absorbs, (x) => x),
-    reach: union(prev?.reach ?? [], proposal.reach, (r) => `${r.scenario}:${r.effect}`),
-    verify: union(prev?.verify ?? [], proposal.verify, (x) => x),
-    builds_on: union(prev?.builds_on ?? [], proposal.builds_on, (r) => `${r.path}#${r.symbol}`),
-    seen_in_runs: union(prev?.seen_in_runs ?? [], [source], (x) => x),
-    advised_by: advisedBy,
-    created_at: prev?.created_at ?? now,
-    updated_at: now
-  };
-  const file = await writeDirection(projectRoot, fm, texts);
-  return {
-    outcome: existing ? "updated" : "created",
-    direction: { frontmatter: fm, texts, path: file }
-  };
-}
-async function setDirectionStatus(projectRoot, slug, status2, now = (/* @__PURE__ */ new Date()).toISOString()) {
-  const existing = await readDirection(projectRoot, slug);
-  if (!existing)
-    return null;
-  const fm = { ...existing.frontmatter, status: status2, updated_at: now };
-  await writeDirection(projectRoot, fm, existing.texts);
-  return { ...existing, frontmatter: fm };
+  return withSessionStateLock(file, () => {
+    const existing = readSessionState(projectRoot);
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const cleanRunPatch = patch.active_run ? Object.fromEntries(Object.entries(patch.active_run).filter(([_, v]) => v !== void 0)) : void 0;
+    const cleanFindingPatch = patch.active_finding ? Object.fromEntries(Object.entries(patch.active_finding).filter(([_, v]) => v !== void 0)) : void 0;
+    const next = {
+      version: 1,
+      updated_at: now,
+      active_scenario: patch.active_scenario ? { slug: patch.active_scenario.slug, updated_at: now } : existing?.active_scenario,
+      active_run: patch.active_run ? {
+        id: patch.active_run.id ?? existing?.active_run?.id ?? "",
+        scenario_slug: patch.active_run.scenario_slug ?? existing?.active_run?.scenario_slug ?? "",
+        status: patch.active_run.status ?? existing?.active_run?.status ?? "running",
+        ...existing?.active_run ?? {},
+        ...cleanRunPatch,
+        updated_at: now
+      } : existing?.active_run,
+      active_finding: patch.active_finding ? {
+        slug: patch.active_finding.slug,
+        ...existing?.active_finding ?? {},
+        ...cleanFindingPatch,
+        updated_at: now
+      } : existing?.active_finding,
+      active_persona: patch.active_persona ? { slug: patch.active_persona.slug, updated_at: now } : existing?.active_persona
+    };
+    atomicWriteFileSync(file, JSON.stringify(next, null, 2) + "\n");
+    return next;
+  });
 }
-var DIRECTIONS_DIR, DIRECTION_STATUSES, directionStatusSchema, directionSizeSchema, directionReachSchema, codeRefSchema, directionFrontmatterSchema, union;
-var init_directions = __esm({
-  "../../packages/local-store/dist/directions.js"() {
+var init_session_state = __esm({
+  "../../packages/local-store/dist/session-state.js"() {
     "use strict";
     init_atomic();
-    init_markdown();
     init_paths();
-    DIRECTIONS_DIR = "directions";
-    DIRECTION_STATUSES = [
-      "proposed",
-      "accepted",
-      "done",
-      "rejected"
-    ];
-    directionStatusSchema = z26.enum(DIRECTION_STATUSES);
-    directionSizeSchema = z26.enum(["small", "medium", "large"]);
-    directionReachSchema = z26.object({
-      scenario: z26.string().min(1),
-      effect: z26.enum(["helps", "risk"]),
-      reason: z26.string().min(1)
-    });
-    codeRefSchema = z26.object({
-      path: z26.string().min(1),
-      symbol: z26.string().min(1)
-    });
-    directionFrontmatterSchema = z26.object({
-      id: z26.string().uuid(),
-      slug: z26.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/),
-      title: z26.string().min(1),
-      status: directionStatusSchema.default("proposed"),
-      size: directionSizeSchema,
-      /** Finding ids this direction would resolve. */
-      absorbs: z26.array(z26.string().min(1)).default([]),
-      /** Predicted effect on other scenarios — never evidence. */
-      reach: z26.array(directionReachSchema).default([]),
-      /** Scenarios to re-run once the direction lands. */
-      verify: z26.array(z26.string().min(1)).default([]),
-      builds_on: z26.array(codeRefSchema).default([]),
-      /** Runs (or `project:<timestamp>`) whose analysis proposed it. */
-      seen_in_runs: z26.array(z26.string().min(1)).default([]),
-      advised_by: z26.string().regex(/^advisor@\S+$/),
-      created_at: z26.string(),
-      updated_at: z26.string()
-    });
-    union = (a, b, key) => {
-      const seen = /* @__PURE__ */ new Map();
-      for (const x of [...a, ...b])
-        seen.set(key(x), x);
-      return [...seen.values()];
-    };
   }
 });
 
@@ -12994,7 +13229,7 @@ async function readContextSummary(projectRoot) {
     return null;
   }
 }
-function pagePath(url) {
+function pagePath2(url) {
   try {
     return new URL(url).pathname || "/";
   } catch {
@@ -13018,7 +13253,7 @@ async function walkedCoverage(projectRoot) {
     const entry = out.get(slug) ?? { paths: /* @__PURE__ */ new Set(), runs: 0 };
     entry.runs++;
     for (const step of await readStepsForRun(projectRoot, name)) {
-      const p = typeof step.url === "string" ? pagePath(step.url) : null;
+      const p = typeof step.url === "string" ? pagePath2(step.url) : null;
       if (p)
         entry.paths.add(p);
     }
@@ -13673,6 +13908,7 @@ var init_dist2 = __esm({
     init_revisit();
     init_explore_map();
     init_walkthrough_canonical2();
+    init_report_markdown();
     init_journey_diff();
     init_finding_match();
     init_guidance2();
@@ -13707,15 +13943,15 @@ function resolveApiUrl(configured) {
   assertSecureApiUrl(url, configured ? "API URL" : "IAMU_API_URL");
   return url;
 }
-function parseStore(raw, path43) {
+function parseStore(raw, path44) {
   let parsed;
   try {
     parsed = JSON.parse(raw);
   } catch (err) {
-    throw new CredentialsFileError(path43, "not valid JSON", err);
+    throw new CredentialsFileError(path44, "not valid JSON", err);
   }
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    throw new CredentialsFileError(path43, "expected a JSON object");
+    throw new CredentialsFileError(path44, "expected a JSON object");
   }
   return parsed;
 }
@@ -13723,26 +13959,26 @@ function isNotFound(err) {
   return typeof err === "object" && err !== null && err.code === "ENOENT";
 }
 async function readCredentialsStore() {
-  const path43 = getCredentialsPath();
+  const path44 = getCredentialsPath();
   let raw;
   try {
-    raw = await readFile(path43, "utf-8");
+    raw = await readFile(path44, "utf-8");
   } catch (err) {
     if (isNotFound(err)) return {};
     warnUnreadableStoreOnce(err);
     throw err;
   }
   try {
-    return parseStore(raw, path43);
+    return parseStore(raw, path44);
   } catch (err) {
     warnUnreadableStoreOnce(err);
     throw err;
   }
 }
 async function writeCredentialsStore(store) {
-  const path43 = getCredentialsPath();
-  await mkdir(dirname(path43), { recursive: true, mode: 448 });
-  await atomicWriteFile(path43, `${JSON.stringify(store, null, 2)}
+  const path44 = getCredentialsPath();
+  await mkdir(dirname(path44), { recursive: true, mode: 448 });
+  await atomicWriteFile(path44, `${JSON.stringify(store, null, 2)}
 `, {
     mode: 384
   });
@@ -13762,16 +13998,16 @@ function resolveApiKey(apiUrl) {
   } catch {
     return null;
   }
-  const path43 = getCredentialsPath();
+  const path44 = getCredentialsPath();
   let raw;
   try {
-    raw = readFileSync2(path43, "utf-8");
+    raw = readFileSync2(path44, "utf-8");
   } catch (err) {
     if (!isNotFound(err)) warnUnreadableStoreOnce(err);
     return null;
   }
   try {
-    const entry = parseStore(raw, path43)[url];
+    const entry = parseStore(raw, path44)[url];
     if (typeof entry !== "object" || entry === null) return null;
     const token = entry.token;
     return typeof token === "string" && token ? token : null;
@@ -13810,12 +14046,12 @@ var init_credentials = __esm({
        * @param reason - What is wrong with it.
        * @param cause - Underlying parse error, if any.
        */
-      constructor(path43, reason, cause) {
+      constructor(path44, reason, cause) {
         super(
-          `Credentials file ${path43} is corrupt (${reason}). Fix it by hand, or delete it and run \`iamu auth login\` again.`,
+          `Credentials file ${path44} is corrupt (${reason}). Fix it by hand, or delete it and run \`iamu auth login\` again.`,
           {
             cause,
-            suggestedAction: `Delete ${path43} and run \`iamu auth login\`, or set IAMU_TOKEN.`
+            suggestedAction: `Delete ${path44} and run \`iamu auth login\`, or set IAMU_TOKEN.`
           }
         );
       }
@@ -14701,8 +14937,8 @@ import { dirname as dirname3, join as join4, resolve as resolve2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import chalk6 from "chalk";
 function getVersion() {
-  if ("0.4.0-beta.0") {
-    return "0.4.0-beta.0";
+  if ("0.4.0-beta.1") {
+    return "0.4.0-beta.1";
   }
   try {
     const thisDir = dirname3(fileURLToPath2(import.meta.url));
@@ -14809,16 +15045,16 @@ async function needsWrite(filePath, content) {
     return true;
   }
 }
-function isCliWrittenSkill(path43) {
+function isCliWrittenSkill(path44) {
   try {
-    return /^generatedBy:/m.test(readFileSync4(path43, "utf-8"));
+    return /^generatedBy:/m.test(readFileSync4(path44, "utf-8"));
   } catch {
     return false;
   }
 }
-function isCliWrittenPrompt(path43) {
+function isCliWrittenPrompt(path44) {
   try {
-    const content = readFileSync4(path43, "utf-8");
+    const content = readFileSync4(path44, "utf-8");
     return content.includes("iamu") || /^generatedBy:/m.test(content);
   } catch {
     return false;
@@ -14830,8 +15066,8 @@ function planSkillFiles(hosts, projectRoot, version2) {
   for (const host of hosts) {
     if (pluginProvidesSkills(host, projectRoot)) {
       for (const name of skillTemplates.keys()) {
-        const path43 = join4(host.getSkillsDir(projectRoot), name, "SKILL.md");
-        if (isCliWrittenSkill(path43)) files.push({ host, path: path43, content: null });
+        const path44 = join4(host.getSkillsDir(projectRoot), name, "SKILL.md");
+        if (isCliWrittenSkill(path44)) files.push({ host, path: path44, content: null });
       }
     } else if (host.supportsSkills) {
       const skillsDir = host.getSkillsDir(projectRoot);
@@ -16388,8 +16624,17 @@ function lead(text) {
 }
 function severityCell(severity) {
   const s = (severity ?? "\u2014").toUpperCase();
-  const cell = padRight(s, 8);
-  return severity === "critical" ? chalk12.red(cell) : severity === "major" ? chalk12.yellow(cell) : chalk12.dim(cell);
+  const cell2 = padRight(s, 8);
+  return severity === "critical" ? chalk12.red(cell2) : severity === "major" ? chalk12.yellow(cell2) : chalk12.dim(cell2);
+}
+function severityMix(r) {
+  if (r.problems === 0) return chalk12.green("no problems");
+  const { critical, major, minor } = r.bySeverity;
+  return [
+    critical > 0 ? chalk12.red(`${critical} critical`) : "",
+    major > 0 ? chalk12.yellow(`${major} major`) : "",
+    minor > 0 ? chalk12.dim(`${minor} minor`) : ""
+  ].filter(Boolean).join(" ");
 }
 function deltaCell(r) {
   const parts = [
@@ -16407,6 +16652,13 @@ function renderRunView(v, width = 100) {
   );
   const meta = [shortDate(v.completedAt), `${v.steps} steps`, v.targetUrl].filter(Boolean).join(" \xB7 ");
   lines.push(`  ${chalk12.dim(meta)}`);
+  if (v.checks) {
+    const parts = [
+      v.checks.fixes > 0 ? `re-checked ${v.checks.fixes} fix${v.checks.fixes === 1 ? "" : "es"}: ${v.checks.fixed} confirmed, ${v.checks.cameBack} came back, ${v.checks.fixes - v.checks.fixed - v.checks.cameBack} not confirmed` : "",
+      v.checks.directions.length > 0 ? `after ${v.checks.directions.length} direction${v.checks.directions.length === 1 ? "" : "s"} landed` : ""
+    ].filter(Boolean);
+    lines.push(`  ${chalk12.dim(`This run ${parts.join(", ")}`)}`);
+  }
   lines.push("");
   const color = verdictColor(v.verdict.label);
   const question = v.verdict.question ?? "Would they come back?";
@@ -16434,12 +16686,21 @@ function renderRunView(v, width = 100) {
     );
     for (const item of s.items) {
       const mark = SINCE_MARKS[item.outcome];
-      lines.push(`    ${mark} ${truncate(item.title, w - 20)}`);
+      const qualifiers = [
+        item.outcome === "persists" ? item.shift : "",
+        item.outcome === "persists" && item.fixedBefore ? "fix did not hold" : ""
+      ].filter(Boolean);
+      const held = qualifiers.length > 0 ? (item.fixedBefore ? chalk12.red : chalk12.dim)(
+        ` (${qualifiers.join("; ")})`
+      ) : "";
+      lines.push(
+        `    ${mark} ${truncate(item.title, w - 18 - stripAnsi(held).length)}${held}`
+      );
     }
   }
   lines.push("");
   const problems = [...v.findings].sort(
-    (a, b) => SEVERITY_ORDER.indexOf(a.severity ?? "") - SEVERITY_ORDER.indexOf(b.severity ?? "") || TYPE_ORDER.indexOf(a.type) - TYPE_ORDER.indexOf(b.type)
+    (a, b) => SEVERITY_ORDER2.indexOf(a.severity ?? "") - SEVERITY_ORDER2.indexOf(b.severity ?? "") || TYPE_ORDER2.indexOf(a.type) - TYPE_ORDER2.indexOf(b.type)
   );
   const strengthNote = v.strengths.length > 0 ? `, ${v.strengths.length} strength${v.strengths.length === 1 ? "" : "s"}` : "";
   lines.push(
@@ -16450,15 +16711,23 @@ function renderRunView(v, width = 100) {
     24,
     Math.max(0, ...problems.map((f) => (f.where ?? "").length))
   );
-  const titleWidth = Math.max(24, w - 4 - 3 - 9 - 10 - whereWidth - 2 - 9);
+  const tagWidth = problems.some((f) => f.persists) ? 9 : 0;
+  const titleWidth = Math.max(
+    24,
+    w - 4 - 3 - 9 - 10 - whereWidth - 2 - tagWidth
+  );
   problems.forEach((f, i) => {
     const where = chalk12.dim(
       padRight(truncate(f.where ?? "", whereWidth), whereWidth)
     );
     const tag = f.persists ? chalk12.red(" persists") : "";
+    const titleLines = wrap(f.title, titleWidth, "");
     lines.push(
-      `    ${padRight(String(i + 1), 3)}${severityCell(f.severity)} ${padRight(chalk12.dim(f.type), 9)} ${padRight(truncate(f.title, titleWidth), titleWidth)}  ${where}${tag}`
+      `    ${padRight(String(i + 1), 3)}${severityCell(f.severity)} ${padRight(chalk12.dim(f.type), 9)} ${padRight(titleLines[0] ?? "", titleWidth)}  ${where}${tag}`
     );
+    for (const more of titleLines.slice(1)) {
+      lines.push(`${" ".repeat(26)}${more}`);
+    }
     if (f.recommendation && (f.severity === "critical" || f.severity === "major")) {
       const fix = wrap(`\u2192 ${lead(f.recommendation)}`, w - 30, " ".repeat(26));
       if (fix.length > 2) {
@@ -16484,8 +16753,13 @@ function renderRunView(v, width = 100) {
       );
     }
   }
-  if (v.observations.length > 0) {
+  if (v.observations.length > 0 || v.setupNotes.length > 0) {
     lines.push("", `  ${chalk12.bold("Also worth knowing")}`);
+    for (const n of v.setupNotes) {
+      lines.push(
+        `    ${chalk12.dim("\xB7")} ${chalk12.dim("Test setup:")} ${truncate(n, w - 22)}`
+      );
+    }
     for (const o of v.observations) {
       const label = o.kind === "coverage_gap" ? "Not walked" : "Feature risk";
       lines.push(
@@ -16520,7 +16794,7 @@ function renderOverview(v, width = 100) {
     }
     for (const r of shown) {
       lines.push(
-        `    ${padRight(chalk12.dim(shortDate(r.completedAt)), 13)} ${verdictColor(r.label)(padRight(r.label, 8))} ${padRight(chalk12.dim(`${r.problems} problem${r.problems === 1 ? "" : "s"}`), 11)} ${deltaCell(r)}`
+        `    ${padRight(chalk12.dim(shortDate(r.completedAt)), 13)} ${verdictColor(r.label)(padRight(r.label, 8))} ${padRight(severityMix(r), 24)} ${deltaCell(r)}`
       );
     }
     if (s.latestAnswer) {
@@ -16549,7 +16823,7 @@ function renderOverview(v, width = 100) {
   );
   return lines.map((l) => l.trimEnd());
 }
-var SINCE_MARKS, SEVERITY_ORDER, TYPE_ORDER;
+var SINCE_MARKS, SEVERITY_ORDER2, TYPE_ORDER2;
 var init_report_view = __esm({
   "src/ui/report-view.ts"() {
     "use strict";
@@ -16560,8 +16834,8 @@ var init_report_view = __esm({
       not_seen: chalk12.dim(padRight("\u25CB not seen", 12)),
       uncertain: chalk12.dim(padRight("? unclear", 12))
     };
-    SEVERITY_ORDER = ["critical", "major", "minor", "observation"];
-    TYPE_ORDER = ["incorrect", "hinders", "missing", "irrelevant"];
+    SEVERITY_ORDER2 = ["critical", "major", "minor", "observation"];
+    TYPE_ORDER2 = ["incorrect", "hinders", "missing", "irrelevant"];
   }
 });
 
@@ -16950,9 +17224,7 @@ ${formatIssues(fileResult.error)}`,
   console.log(
     `  ${chalk14.dim("verdicts:")} ${path23.relative(projectRoot, verdictsPath)}`
   );
-  console.log(
-    `  ${chalk14.dim("report:")}  ${path23.relative(projectRoot, reportPath)}`
-  );
+  console.log(`  ${chalk14.dim("report:")}  ${reportPath}`);
   printCloudRunInfo(cloudInfo);
   await promptViewResults(projectRoot, { ...opts, runId });
 }
@@ -17008,7 +17280,10 @@ function sinceItems(v) {
   return groups.flatMap(
     ([outcome, items]) => (items ?? []).map((i) => ({
       title: i.title ?? i.canonical_id ?? "untitled",
-      outcome
+      outcome,
+      note: i.note ?? null,
+      fixedBefore: Boolean(i.fixed_before),
+      shift: outcome === "persists" ? severityShift(i.severity_before, i.severity_now) : ""
     }))
   );
 }
@@ -17037,11 +17312,8 @@ async function readCompletedRuns(projectRoot, runIds, scenario) {
   return out;
 }
 function verdictLabel(c) {
-  const judged = (c?.human_tests ?? []).map((t) => t.verdict).filter((v) => v === "yes" || v === "no" || v === "partial");
-  if (judged.length === 0) return "PENDING";
-  if (judged.every((v) => v === "yes")) return "YES";
-  if (judged.every((v) => v === "no")) return "NO";
-  return "PARTIAL";
+  const v = runVerdict(c);
+  return v ? v.toUpperCase() : "PENDING";
 }
 function testLabel(verdict) {
   return verdict === "yes" ? "YES" : verdict === "no" ? "NO" : verdict === "partial" ? "PARTIAL" : "PENDING";
@@ -17095,6 +17367,17 @@ async function openDirections(projectRoot) {
     (d) => d.frontmatter.status === "proposed" || d.frontmatter.status === "accepted"
   );
 }
+function checksOf(c) {
+  const checks = c?.checks;
+  if (!c || !checks) return null;
+  const fixes = checkOutcomes(c);
+  return {
+    fixes: fixes.length,
+    fixed: fixes.filter((f) => f.outcome === "fixed").length,
+    cameBack: fixes.filter((f) => f.outcome === "came_back").length,
+    directions: checks.directions
+  };
+}
 async function buildRunView(projectRoot, run) {
   const c = run.canonical;
   const slugs = slugsOf(run);
@@ -17110,12 +17393,13 @@ async function buildRunView(projectRoot, run) {
   const v = verificationOf(c);
   const persisting = new Set(v?.persists.map((p) => p.canonical_id) ?? []);
   const added = new Set(v?.new_findings.map((n) => n.id) ?? []);
+  const stepUrl2 = new Map((c?.steps ?? []).map((st) => [st.id, st.url]));
   const findings2 = [];
   const strengths = [];
   for (const f of c?.findings ?? []) {
     const entity = byId.get(f.id);
     const fm = entity?.frontmatter;
-    const title = fm?.title ?? firstSentence(f.ui_fact ?? fm?.ui_fact ?? f.id);
+    const title = f.title ?? fm?.title ?? firstSentence(f.ui_fact ?? fm?.ui_fact ?? f.id);
     if (f.type === "helps") {
       strengths.push(title);
       continue;
@@ -17129,7 +17413,7 @@ async function buildRunView(projectRoot, run) {
       recommendation: f.recommendation || null,
       isNew: added.has(f.id),
       where: whereOf(
-        fm?.page_url,
+        f.page_url ?? fm?.page_url ?? stepUrl2.get(f.linked_step_ids?.[0] ?? ""),
         fm?.walkthrough_step_id ?? f.linked_step_ids?.[0]
       ),
       persists: Boolean(f.canonical_id && persisting.has(f.canonical_id))
@@ -17172,7 +17456,7 @@ async function buildRunView(projectRoot, run) {
       answer: overall?.answer ?? null
     },
     tests: tests.map((t) => ({
-      question: t.question,
+      question: stripAnswerHint(t.question),
       label: testLabel(t.verdict)
     })),
     since: v ? {
@@ -17191,9 +17475,17 @@ async function buildRunView(projectRoot, run) {
       absorbs: d.absorbs?.length ?? 0,
       verify: d.verify?.length ?? 0
     })),
-    observations: analysis?.observations ?? []
+    observations: analysis?.observations ?? [],
+    checks: checksOf(c),
+    setupNotes: c?.setup_notes ?? []
   };
 }
+function severityCounts(c) {
+  const problems = (c?.findings ?? []).filter(isProblem);
+  const critical = problems.filter((f) => f.severity === "critical").length;
+  const major = problems.filter((f) => f.severity === "major").length;
+  return { critical, major, minor: problems.length - critical - major };
+}
 async function buildOverview(projectRoot, runs) {
   const groups = /* @__PURE__ */ new Map();
   for (const r of runs) {
@@ -17220,6 +17512,7 @@ async function buildOverview(projectRoot, runs) {
           completedAt: r.manifest.completed_at ?? null,
           label: verdictLabel(r.canonical),
           problems: (r.canonical?.findings ?? []).filter(isProblem).length,
+          bySeverity: severityCounts(r.canonical),
           resolved: v?.resolved.length ?? 0,
           persists: v?.persists.length ?? 0,
           added: v?.new_findings.filter(isProblem).length ?? 0
@@ -17271,6 +17564,10 @@ __export(html_report_exports, {
 });
 import { promises as fs31 } from "fs";
 import path25 from "path";
+function firstSentenceOf(text) {
+  if (!text) return null;
+  return /^(.+?[.!?])(\s|$)/.exec(text.trim())?.[1] ?? text.trim();
+}
 function esc(str2) {
   if (!str2) return "";
   return str2.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
@@ -17377,6 +17674,70 @@ function renderStepScreenshotHtml(s) {
     </div>
   `;
 }
+function sortProblems(list2) {
+  const r = (v, order) => {
+    const i = order.indexOf(v ?? "");
+    return i === -1 ? order.length : i;
+  };
+  return [...list2].sort(
+    (a, b) => r(a.severity, SEVERITY_RANK) - r(b.severity, SEVERITY_RANK) || r(a.type, TYPE_RANK) - r(b.type, TYPE_RANK)
+  );
+}
+function inlineMarkdown(text) {
+  return esc(text).replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>").replace(/\n+/g, "<br>");
+}
+function persistsLabel(i) {
+  const qualifiers = [
+    severityShift(i.severity_before, i.severity_now),
+    i.fixed_before ? "fix did not hold" : ""
+  ].filter(Boolean);
+  return qualifiers.length > 0 ? `Persists (${qualifiers.join("; ")})` : "Persists";
+}
+function renderChecks2(fixes, directions) {
+  const items = fixes.map(
+    (f) => `<li style="margin-bottom:0.25rem"><strong>${CHECK_LABEL[f.outcome]}:</strong> ${esc(f.title)}${f.fix ? `. Fix: ${esc(f.fix)}` : ""}${f.reached ? "" : " <em>(not reached)</em>"}</li>`
+  ).join("");
+  const landed = directions.length > 0 ? `<p style="font-size:13px">Directions completed since the last run: ${directions.map((d) => `<strong>${esc(d)}</strong>`).join(", ")}.</p>` : "";
+  return `
+    <section>
+      <h2>What this run checks</h2>
+      <div class="card">
+        ${items ? `<p style="font-size:13px">${fixes.length} fix${fixes.length === 1 ? " was" : "es were"} waiting for a re-check.</p><ul style="padding-left:1.25rem;font-size:13px;line-height:1.6">${items}</ul>` : ""}
+        ${landed}
+      </div>
+    </section>`;
+}
+function renderSinceTable(v) {
+  const steps = (ids) => ids && ids.length > 0 ? ` (step${ids.length === 1 ? "" : "s"} ${ids.map((id) => /\d+/.exec(id)?.[0] ?? id).join(", ")})` : "";
+  const td = 'style="padding:6px 8px;border-top:1px solid #E5E7EB;vertical-align:top"';
+  const row = (i, now, note) => `<tr><td ${td}>${esc(i.title)}</td><td ${td}><strong>${esc(now)}</strong></td><td ${td}>${esc(note) || "\u2014"}</td></tr>`;
+  const rows = [
+    ...v.resolved.map(
+      (i) => row(i, "Resolved", `${i.note ?? ""}${steps(i.step_ids)}`)
+    ),
+    ...v.persists.map(
+      (i) => row(i, persistsLabel(i), `${i.note ?? ""}${steps(i.step_ids)}`)
+    ),
+    ...(v.notObserved ?? []).map(
+      (i) => row(
+        i,
+        "Not seen",
+        `The walk did not pass this way${i.fixed_before ? " (fixed, awaiting a re-check)" : ""}. Not evidence of a fix.`
+      )
+    )
+  ];
+  if (rows.length === 0) return "";
+  return `
+    <section>
+      <h2>Since the last run</h2>
+      <div class="card">
+        <table style="width:100%;border-collapse:collapse;font-size:13px;line-height:1.5">
+          <thead><tr><th style="text-align:left;padding:6px 8px">Earlier finding</th><th style="text-align:left;padding:6px 8px">Now</th><th style="text-align:left;padding:6px 8px">Notes</th></tr></thead>
+          <tbody>${rows.join("")}</tbody>
+        </table>
+      </div>
+    </section>`;
+}
 function generateHtmlReport(data) {
   const {
     scenarioName,
@@ -17385,6 +17746,7 @@ function generateHtmlReport(data) {
     steps,
     findings: findings2,
     verdicts,
+    overall,
     verification,
     whatWorked,
     openQuestions,
@@ -17395,16 +17757,17 @@ function generateHtmlReport(data) {
     runNumber
   } = data;
   const dateStr = formatDate(completedAt ?? startedAt);
-  const criticalCount = findings2.filter(
-    (f) => f.severity === "critical" || f.type === "incorrect"
+  const problems = sortProblems(findings2.filter((f) => f.type !== "helps"));
+  const strengths = findings2.filter((f) => f.type === "helps");
+  const criticalCount = problems.filter(
+    (f) => f.severity === "critical"
   ).length;
-  const majorCount = findings2.filter(
-    (f) => f.severity === "major" || f.severity === "important" || f.type === "hinders" || f.type === "missing"
+  const majorCount = problems.filter((f) => f.severity === "major").length;
+  const minorCount = problems.filter(
+    (f) => f.severity !== "critical" && f.severity !== "major"
   ).length;
-  const minorCount = findings2.filter(
-    (f) => f.severity === "minor" || f.type === "friction" || !f.severity && f.type !== "helps"
-  ).length;
-  const helpsCount = findings2.filter((f) => f.type === "helps").length;
+  const helpsCount = strengths.length;
+  const newProblems = verification ? verification.newFindings.filter((n) => n.type !== "helps").length : 0;
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -17879,16 +18242,27 @@ function generateHtmlReport(data) {
       <div class="verification-notice">
         Since last run: <strong>${verification.resolved.length} resolved</strong> \xB7 
         <strong>${verification.persists.length} persists</strong> \xB7 
-        <strong>${verification.newFindings.length} new</strong>
+        <strong>${newProblems} new</strong>
       </div>` : ""}
     </div>
 
-    <!-- The Human Test Scorecard -->
-    ${verdicts && verdicts.length > 0 ? `
+    ${data.checks ? renderChecks2(data.checks.fixes, data.checks.directions) : ""}
+
+    <!-- The Human Test: the run's outcome, first -->
+    ${overall || verdicts && verdicts.length > 0 ? `
     <section>
-      <h2>The Human Test Checkpoints</h2>
+      <h2>The Human Test</h2>
       <div class="card">
-        ${verdicts.map(
+        ${overall ? `
+          <div class="verdict-item">
+            <div class="verdict-header">
+              <span style="font-weight:600;font-size:15px">${esc(overall.question)}</span>
+              <span class="badge badge-${esc(overall.label)}">${esc(overall.label)}</span>
+            </div>
+            ${overall.answer ? `<div class="prose-voice" style="margin-top:0.35rem;font-weight:500">${esc(overall.answer)}</div>` : ""}
+            ${overall.reasoning ? `<div class="prose-voice" style="margin-top:0.35rem">${esc(overall.reasoning)}</div>` : ""}
+          </div>` : ""}
+        ${(verdicts ?? []).map(
     (v) => `
           <div class="verdict-item">
             <div class="verdict-header">
@@ -17903,14 +18277,46 @@ function generateHtmlReport(data) {
     </section>
     ` : ""}
 
+    ${verification ? renderSinceTable(verification) : ""}
+
+    <!-- Findings, worst first -->
+    ${problems.length > 0 ? `
+    <section>
+      <h2>Findings (${problems.length})</h2>
+      ${problems.map(
+    (f, i) => `
+        <div class="finding-item">
+          <div style="display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:0.35rem 0.75rem">
+            <span class="finding-title">${i + 1}. ${esc(f.title)}${f.isNew ? ' <span class="badge">new</span>' : f.persists ? ' <span class="badge">persists</span>' : ""}</span>
+            <span class="badge badge-${esc(f.severity ?? f.type)}">${esc(f.severity ?? f.type)}</span>
+          </div>
+          <div class="finding-meta">${esc([f.type, f.where].filter(Boolean).join(" \xB7 "))}</div>
+          ${f.uiFact ? `<div class="finding-meta">${esc(f.uiFact)}</div>` : ""}
+          ${f.consequence ? `<blockquote class="finding-meta prose-voice">${esc(f.consequence)}${persona?.name ? ` \u2014 ${esc(persona.name)}` : ""}</blockquote>` : ""}
+          ${f.recommendation ? `<div class="finding-meta finding-rec"><strong>Recommendation:</strong> ${inlineMarkdown(f.recommendation)}</div>` : ""}
+        </div>
+      `
+  ).join("")}
+    </section>
+    ` : ""}
+
     <!-- What Worked & Open Questions -->
-    ${whatWorked && whatWorked.length > 0 || openQuestions && openQuestions.length > 0 ? `
+    ${strengths.length > 0 || whatWorked && whatWorked.length > 0 || openQuestions && openQuestions.length > 0 || data.setupNotes && data.setupNotes.length > 0 ? `
     <section style="display:flex;gap:1.25rem;flex-wrap:wrap">
-      ${whatWorked && whatWorked.length > 0 ? `
+      ${strengths.length > 0 || whatWorked && whatWorked.length > 0 ? `
         <div class="card" style="flex:1;min-width:260px">
           <div class="card-label">What Worked</div>
           <ul style="padding-left:1.25rem;font-size:13px;line-height:1.6">
-            ${whatWorked.map((w) => `<li style="margin-bottom:0.25rem">${esc(w)}</li>`).join("")}
+            ${strengths.map((f) => `<li style="margin-bottom:0.25rem"><strong>${esc(f.title)}.</strong> ${esc(f.uiFact)}</li>`).join("")}
+            ${(whatWorked ?? []).map((w) => `<li style="margin-bottom:0.25rem">${esc(w)}</li>`).join("")}
+          </ul>
+        </div>
+      ` : ""}
+      ${data.setupNotes && data.setupNotes.length > 0 ? `
+        <div class="card" style="flex:1;min-width:260px">
+          <div class="card-label">Test Setup Notes</div>
+          <ul style="padding-left:1.25rem;font-size:13px;line-height:1.6">
+            ${data.setupNotes.map((n) => `<li style="margin-bottom:0.25rem">${esc(n)}</li>`).join("")}
           </ul>
         </div>
       ` : ""}
@@ -17925,26 +18331,6 @@ function generateHtmlReport(data) {
     </section>
     ` : ""}
 
-    <!-- Findings Overview -->
-    ${findings2.length > 0 ? `
-    <section>
-      <h2>Findings (${findings2.length})</h2>
-      ${findings2.map(
-    (f) => `
-        <div class="finding-item">
-          <div style="display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:0.35rem 0.75rem">
-            <span class="finding-title">${esc(f.title)}</span>
-            <span class="badge badge-${esc(f.severity ?? f.type)}">${esc(f.severity ?? f.type)}</span>
-          </div>
-          ${f.uiFact ? `<div class="finding-meta"><strong>Observed:</strong> ${esc(f.uiFact)}</div>` : ""}
-          ${f.consequence ? `<div class="finding-meta"><strong>Consequence:</strong> ${esc(f.consequence)}</div>` : ""}
-          ${f.recommendation ? `<div class="finding-meta finding-rec"><strong>Recommendation:</strong> ${esc(f.recommendation)}</div>` : ""}
-        </div>
-      `
-  ).join("")}
-    </section>
-    ` : ""}
-
     <!-- Step Timeline with Connected Gutter -->
     ${steps.length > 0 ? `
     <section>
@@ -18012,7 +18398,6 @@ async function buildReportDataFromRun(projectRoot, runId) {
         scenarioSlug
       );
       if (record) {
-        scenarioName = record.frontmatter.slug || scenarioSlug;
         scenarioNarrative = record.body?.trim() || null;
       }
     } catch {
@@ -18068,47 +18453,82 @@ async function buildReportDataFromRun(projectRoot, runId) {
       screenshotUrl
     });
   }
+  const names2 = canonical?.scenario;
+  if (names2?.outline_title) {
+    scenarioName = `${names2.persona_name ?? personaData?.name ?? names2.persona_slug} \xB7 ${names2.outline_title}`;
+  }
+  const verification = canonical?.verification;
+  const newIds = new Set((verification?.new_findings ?? []).map((n) => n.id));
+  const persistingIds = new Set(
+    (verification?.persists ?? []).map(
+      (p) => p.canonical_id
+    )
+  );
   const findings2 = (canonical?.findings ?? []).map((f) => {
-    const rawF = f;
-    const title = typeof rawF.title === "string" && rawF.title.trim().length > 0 ? rawF.title : f.ui_fact || f.id;
+    const step = rawSteps.find((st) => st.id === f.linked_step_ids[0]);
+    let page = null;
+    const url = f.page_url ?? step?.url;
+    if (url) {
+      try {
+        page = new URL(url).pathname;
+      } catch {
+        page = url;
+      }
+    }
     return {
       id: f.id,
-      title,
+      title: f.title?.trim() || firstSentenceOf(f.ui_fact) || f.id,
       type: f.type,
       severity: f.severity,
       uiFact: f.ui_fact,
       consequence: f.consequence,
-      recommendation: f.recommendation
+      recommendation: f.recommendation,
+      where: [page, step ? `step ${step.step_number}` : null].filter(Boolean).join(" \xB7 ") || null,
+      isNew: newIds.has(f.id),
+      persists: Boolean(f.canonical_id && persistingIds.has(f.canonical_id))
     };
   });
   const verdicts = (canonical?.human_tests ?? []).map(
     (ht) => ({
-      question: ht.question,
+      question: stripAnswerHint(ht.question),
       rating: ht.verdict || "pending",
       reasoning: typeof ht.reasoning === "string" ? ht.reasoning : void 0
     })
   );
-  const verification = canonical?.verification;
   const verificationData = verification ? {
     resolved: verification.resolved ?? [],
     persists: verification.persists ?? [],
+    notObserved: verification.not_observed ?? [],
     newFindings: verification.new_findings ?? []
   } : null;
+  const verdict = runVerdict(canonical);
+  const overall = canonical?.human_test_overall ? {
+    question: canonical.human_test_overall.question,
+    label: verdict ?? "pending",
+    answer: canonical.human_test_overall.answer,
+    reasoning: canonical.human_test_overall.reasoning
+  } : null;
   return {
     scenarioName,
     scenarioNarrative,
     persona: personaData,
     walkthroughId: runId,
-    runNumber: manifest.run_number ?? null,
+    runNumber: manifest.run_number ?? canonical?.run_number ?? null,
     startedAt: manifest.started_at ?? canonical?.provenance?.started_at ?? null,
     completedAt: manifest.completed_at ?? canonical?.provenance?.completed_at ?? null,
     targetUrl: manifest.target_url ?? canonical?.target?.url ?? null,
     steps,
     findings: findings2,
     verdicts,
+    overall,
     verification: verificationData,
     whatWorked: canonical?.what_worked,
-    openQuestions: canonical?.open_questions
+    openQuestions: canonical?.open_questions,
+    setupNotes: canonical?.setup_notes,
+    checks: (() => {
+      const raw = canonical?.checks;
+      return canonical && raw ? { fixes: checkOutcomes(canonical), directions: raw.directions } : null;
+    })()
   };
 }
 async function createLocalHtmlReport(projectRoot, runId, destination) {
@@ -18118,11 +18538,19 @@ async function createLocalHtmlReport(projectRoot, runId, destination) {
   await atomicWriteFile(targetPath, html);
   return { filePath: targetPath, html };
 }
+var SEVERITY_RANK, TYPE_RANK, CHECK_LABEL;
 var init_html_report = __esm({
   "src/ui/html-report.ts"() {
     "use strict";
     init_dist2();
     init_evaluate();
+    SEVERITY_RANK = ["critical", "major", "minor", "observation"];
+    TYPE_RANK = ["incorrect", "hinders", "missing", "irrelevant"];
+    CHECK_LABEL = {
+      fixed: "Confirmed fixed",
+      came_back: "Came back",
+      unconfirmed: "Not confirmed"
+    };
   }
 });
 
@@ -18131,6 +18559,7 @@ var report_exports = {};
 __export(report_exports, {
   report: () => report
 });
+import path26 from "path";
 import chalk15 from "chalk";
 async function report(scenario, opts) {
   const ctx = await resolveProject(opts);
@@ -18251,6 +18680,9 @@ function jsonRows(projectRoot, runs) {
         human_tests: r.canonical?.human_tests ?? [],
         human_test_overall: r.canonical?.human_test_overall,
         summary: await buildRunView(projectRoot, r),
+        // Absolute, so a terminal can open them (relative paths are not links).
+        run_dir: runDir(projectRoot, r.runId),
+        report_path: path26.join(runDir(projectRoot, r.runId), "report.md"),
         ...cloudUrl ? { cloud_url: cloudUrl } : {}
       };
     })
@@ -18275,7 +18707,7 @@ __export(open_exports, {
   openDashboard: () => openDashboard
 });
 import { existsSync as existsSync8, promises as fs32 } from "fs";
-import path26 from "path";
+import path27 from "path";
 import { isCancel as isCancel3, select as select3 } from "@clack/prompts";
 import chalk16 from "chalk";
 async function openDashboard(runId, opts) {
@@ -18371,7 +18803,7 @@ async function openLocalReport(projectRoot, runId, opts) {
     for (const rid of [...runs].reverse()) {
       try {
         const manifestRaw = await fs32.readFile(
-          path26.join(runDir(projectRoot, rid), "walkthrough.json"),
+          path27.join(runDir(projectRoot, rid), "walkthrough.json"),
           "utf8"
         );
         const manifest = JSON.parse(manifestRaw);
@@ -20146,7 +20578,7 @@ var init_status2 = __esm({
 
 // src/commands/browse-actions.ts
 import { existsSync as existsSync11 } from "fs";
-import path27 from "path";
+import path28 from "path";
 function byRole(page, role, name, opts) {
   const loc = page.getByRole(role, { name, exact: false });
   return opts.nth !== void 0 ? loc.nth(Number(opts.nth)) : loc.first();
@@ -20337,7 +20769,7 @@ async function fillIndexedElement(page, index, text, submit) {
   await fillOrSelect(loc.first(), text, submit);
 }
 async function setFilesOnElement(el, filePath) {
-  const resolved = path27.resolve(filePath);
+  const resolved = path28.resolve(filePath);
   if (!existsSync11(resolved)) {
     throw new Error(`Upload file does not exist: "${resolved}"`);
   }
@@ -20677,7 +21109,7 @@ var init_browse_driver = __esm({
 
 // src/commands/step-numbering.ts
 import { open, readdir as readdir2, unlink } from "fs/promises";
-import path28 from "path";
+import path29 from "path";
 function stepFileName(stepNumber2) {
   return `${String(stepNumber2).padStart(3, "0")}.json`;
 }
@@ -20699,7 +21131,7 @@ async function reserveStepFile(stepsDir, limit) {
     if (candidate > limit.maxSteps) {
       throw new Error(stepLimitMessage(limit.maxSteps, limit.runId));
     }
-    const stepPath = path28.join(stepsDir, stepFileName(candidate));
+    const stepPath = path29.join(stepsDir, stepFileName(candidate));
     try {
       const handle = await open(stepPath, "wx");
       await handle.close();
@@ -20731,7 +21163,7 @@ __export(step_exports, {
   stepCommand: () => stepCommand
 });
 import { copyFile, mkdir as mkdir5, stat as stat2 } from "fs/promises";
-import path29 from "path";
+import path30 from "path";
 import chalk22 from "chalk";
 function parseMaxSteps(val) {
   if (typeof val === "number" && Number.isFinite(val) && val > 0) return val;
@@ -20750,8 +21182,8 @@ async function recordStep(input) {
   if (!runDirPath) {
     throw new Error(`Run directory not found for run "${input.runId}"`);
   }
-  const stepsDir = path29.join(runDirPath, "steps");
-  const screenshotsDir = path29.join(runDirPath, "screenshots");
+  const stepsDir = path30.join(runDirPath, "steps");
+  const screenshotsDir = path30.join(runDirPath, "screenshots");
   await mkdir5(stepsDir, { recursive: true });
   await mkdir5(screenshotsDir, { recursive: true });
   const shotSource = input.shot ? await existingShot(input.shot) : null;
@@ -20765,11 +21197,11 @@ async function recordStep(input) {
     let finalScreenshotPath = null;
     if (shotSource) {
       const destName = `step-${stepNumber2}.png`;
-      finalScreenshotPath = path29.join(screenshotsDir, destName);
-      if (path29.resolve(finalScreenshotPath) !== shotSource) {
+      finalScreenshotPath = path30.join(screenshotsDir, destName);
+      if (path30.resolve(finalScreenshotPath) !== shotSource) {
         await copyFile(shotSource, finalScreenshotPath);
       }
-      screenshotRef = path29.join("screenshots", destName);
+      screenshotRef = path30.join("screenshots", destName);
     }
     const parsedStep = runStepSchema.parse({
       step_number: stepNumber2,
@@ -20808,7 +21240,7 @@ async function recordStep(input) {
   }
 }
 async function existingShot(shot) {
-  const resolved = path29.resolve(shot);
+  const resolved = path30.resolve(shot);
   const isFile = await stat2(resolved).then((s) => s.isFile()).catch(() => false);
   if (!isFile) {
     throw new Error(
@@ -20862,7 +21294,7 @@ async function stepCommand(runArg, opts) {
             {
               step_number: res.step.step_number,
               cancelled: true,
-              path: path29.relative(projectRoot, res.stepPath),
+              path: path30.relative(projectRoot, res.stepPath),
               action: res.step.action,
               note: res.step.note,
               url: res.step.url,
@@ -20890,7 +21322,7 @@ async function stepCommand(runArg, opts) {
         JSON.stringify(
           {
             step_number: res.step.step_number,
-            path: path29.relative(projectRoot, res.stepPath),
+            path: path30.relative(projectRoot, res.stepPath),
             action: res.step.action,
             note: res.step.note,
             url: res.step.url,
@@ -20919,7 +21351,7 @@ async function stepCommand(runArg, opts) {
         console.log(`  ${chalk22.dim("shot:")}       ${res.step.screenshot}`);
       }
       console.log(
-        `  ${chalk22.dim("file:")}       ${path29.relative(projectRoot, res.stepPath)}`
+        `  ${chalk22.dim("file:")}       ${path30.relative(projectRoot, res.stepPath)}`
       );
       console.log();
     } else {
@@ -20980,21 +21412,21 @@ import {
 } from "fs";
 import { rm as rm2 } from "fs/promises";
 import { homedir as homedir3 } from "os";
-import path30 from "path";
+import path31 from "path";
 import chalk23 from "chalk";
 function stateDir() {
-  return path30.join(
-    process.env.IAMU_HOME ?? path30.join(homedir3(), ".iamu"),
+  return path31.join(
+    process.env.IAMU_HOME ?? path31.join(homedir3(), ".iamu"),
     "browse"
   );
 }
 function profileDir() {
-  return path30.join(stateDir(), "profile");
+  return path31.join(stateDir(), "profile");
 }
 function readBrowseState() {
   try {
     return JSON.parse(
-      readFileSync6(path30.join(stateDir(), "state.json"), "utf8")
+      readFileSync6(path31.join(stateDir(), "state.json"), "utf8")
     );
   } catch {
     return null;
@@ -21002,7 +21434,7 @@ function readBrowseState() {
 }
 function writeState(state) {
   mkdirSync3(stateDir(), { recursive: true });
-  writeFileSync3(path30.join(stateDir(), "state.json"), JSON.stringify(state));
+  writeFileSync3(path31.join(stateDir(), "state.json"), JSON.stringify(state));
 }
 function fail(message, opts) {
   if (opts?.json) {
@@ -21066,7 +21498,7 @@ async function requestedViewport(opts) {
   let manifest;
   try {
     manifest = JSON.parse(
-      readFileSync6(path30.join(dir, "walkthrough.json"), "utf8")
+      readFileSync6(path31.join(dir, "walkthrough.json"), "utf8")
     );
   } catch {
     fail(
@@ -21172,7 +21604,7 @@ async function stop(opts, driver) {
   await driver.closeBrowser(state.port);
   if (state.pid) await reapBrowser(state.pid, profileDir(), driver);
   try {
-    unlinkSync3(path30.join(stateDir(), "state.json"));
+    unlinkSync3(path31.join(stateDir(), "state.json"));
   } catch {
   }
   report2(opts, { stopped: true }, [`  ${chalk23.green("\u2713")} Browser stopped`]);
@@ -21181,8 +21613,8 @@ function computePageFingerprint(url, bodySnippet) {
   return createHash4("sha256").update(`${url}|${bodySnippet.trim().replace(/\s+/g, " ")}`).digest("hex").slice(0, 16);
 }
 function checkAndRecordStagnation(projectRoot, runId, fingerprint, action) {
-  const cacheDir2 = path30.join(projectRoot, "iamu", ".cache");
-  const cacheFile = path30.join(cacheDir2, `stagnation-${runId}.json`);
+  const cacheDir2 = path31.join(projectRoot, "iamu", ".cache");
+  const cacheFile = path31.join(cacheDir2, `stagnation-${runId}.json`);
   let previous = null;
   try {
     if (existsSync12(cacheFile)) {
@@ -21352,8 +21784,8 @@ async function withPage(opts, driver, fn, target) {
     let contentSnippet;
     if (opts.shot) {
       await waitForVisualStability(page);
-      screenshot = path30.resolve(opts.shot);
-      mkdirSync3(path30.dirname(screenshot), { recursive: true });
+      screenshot = path31.resolve(opts.shot);
+      mkdirSync3(path31.dirname(screenshot), { recursive: true });
       await page.screenshot({ path: screenshot, fullPage: Boolean(opts.full) });
       if (typeof page.evaluate === "function") {
         contentSnippet = await page.evaluate(() => {
@@ -21518,7 +21950,7 @@ function printStep(opts, record, projectRoot, stagnationWarning, challengeWarnin
   if (opts.json) {
     const doc = {
       step_number: step.step_number,
-      path: path30.relative(projectRoot, record.stepPath),
+      path: path31.relative(projectRoot, record.stepPath),
       action: step.action,
       note: step.note,
       url: step.url,
@@ -21621,10 +22053,10 @@ async function browseStep(args, opts, driver) {
   const runDirPath = resolveRunDir(ctx.projectRoot, opts.run);
   if (!runDirPath) return;
   const maxSteps = parseMaxSteps(opts.maxSteps);
-  if (await peekNextStepNumber(path30.join(runDirPath, "steps")) > maxSteps) {
+  if (await peekNextStepNumber(path31.join(runDirPath, "steps")) > maxSteps) {
     return fail(stepLimitMessage(maxSteps, opts.run), opts);
   }
-  const pendingShot = path30.join(
+  const pendingShot = path31.join(
     runDirPath,
     "screenshots",
     `.pending-${randomUUID9()}.png`
@@ -22476,10 +22908,10 @@ __export(preflight_exports, {
 });
 import { spawnSync } from "child_process";
 import { existsSync as existsSync14, promises as fs34 } from "fs";
-import path31 from "path";
+import path32 from "path";
 import chalk25 from "chalk";
 async function detectPreflightCommand(targetDir) {
-  const pkgPath = path31.join(targetDir, "package.json");
+  const pkgPath = path32.join(targetDir, "package.json");
   if (existsSync14(pkgPath)) {
     try {
       const raw = await fs34.readFile(pkgPath, "utf8");
@@ -22494,12 +22926,12 @@ async function detectPreflightCommand(targetDir) {
     } catch {
     }
   }
-  const tsconfigPath = path31.join(targetDir, "tsconfig.json");
+  const tsconfigPath = path32.join(targetDir, "tsconfig.json");
   if (existsSync14(tsconfigPath)) {
     return { command: "npx", args: ["--no-install", "tsc", "--noEmit"] };
   }
-  const biomePath = path31.join(targetDir, "biome.json");
-  const biomecPath = path31.join(targetDir, "biome.jsonc");
+  const biomePath = path32.join(targetDir, "biome.json");
+  const biomecPath = path32.join(targetDir, "biome.jsonc");
   if (existsSync14(biomePath) || existsSync14(biomecPath)) {
     return { command: "npx", args: ["--no-install", "biome", "check"] };
   }
@@ -22536,7 +22968,7 @@ async function runPreflightCheck(targetDir) {
   };
 }
 async function preflight(opts = {}) {
-  const targetDir = opts.cwd ? path31.resolve(opts.cwd) : process.cwd();
+  const targetDir = opts.cwd ? path32.resolve(opts.cwd) : process.cwd();
   const result = await runPreflightCheck(targetDir);
   if (result.ok) {
     if (opts.json) {
@@ -22608,7 +23040,7 @@ import {
   readlinkSync,
   realpathSync as realpathSync2
 } from "fs";
-import path32 from "path";
+import path33 from "path";
 function git(args, cwd) {
   return execFileSync("git", args, {
     cwd,
@@ -22661,8 +23093,8 @@ function detectWorktreeState(projectRoot, iamuDirName = IAMU_DIR) {
     const top = git(["rev-parse", "--show-toplevel"], projectRoot).toString("utf8").trim();
     if (!top) return void 0;
     const realTop = realpathSync2(top);
-    const realIamu = path32.join(realpathSync2(projectRoot), iamuDirName);
-    const iamuRel = path32.relative(realTop, realIamu).split(path32.sep).join("/");
+    const realIamu = path33.join(realpathSync2(projectRoot), iamuDirName);
+    const iamuRel = path33.relative(realTop, realIamu).split(path33.sep).join("/");
     const pathspec = iamuRel.startsWith("..") ? [":(top)"] : [":(top)", `:(top,exclude,literal)${iamuRel}`];
     const status2 = git(
       [
@@ -22692,7 +23124,7 @@ function detectWorktreeState(projectRoot, iamuDirName = IAMU_DIR) {
     );
     for (const file of sorted.slice(0, MAX_UNTRACKED_HASHED)) {
       const rel = file.replace(/\/$/, "");
-      hash.update(`${file}\0${hashFile(path32.join(realTop, rel))}
+      hash.update(`${file}\0${hashFile(path33.join(realTop, rel))}
 `);
     }
     if (sorted.length > MAX_UNTRACKED_HASHED) {
@@ -23298,12 +23730,12 @@ __export(validate_exports, {
 });
 import { randomUUID as randomUUID10 } from "crypto";
 import { promises as fs35 } from "fs";
-import path33 from "path";
+import path34 from "path";
 import chalk27 from "chalk";
 function inferTypeFromPath(filePath, projectRoot) {
-  const rel = path33.relative(path33.join(projectRoot, "iamu"), filePath);
-  if (rel.startsWith("..") || path33.isAbsolute(rel)) return null;
-  const segments = rel.split(path33.sep);
+  const rel = path34.relative(path34.join(projectRoot, "iamu"), filePath);
+  if (rel.startsWith("..") || path34.isAbsolute(rel)) return null;
+  const segments = rel.split(path34.sep);
   if (segments.length < 2) return null;
   return TYPE_BY_ALIAS.get(segments[0]) ?? null;
 }
@@ -23333,7 +23765,7 @@ function validateFile(filePath, raw, projectRoot) {
     );
     return result;
   }
-  if (path33.basename(filePath) === "context.yml") {
+  if (path34.basename(filePath) === "context.yml") {
     applyZodValidation(contextFrontmatterSchema, frontmatter, result);
     const warnings = [];
     const hasNotes = Boolean(
@@ -23402,7 +23834,7 @@ async function buildRepairLookups(projectRoot) {
     }
   }
   const runScenario = /* @__PURE__ */ new Map();
-  const runsDir2 = path33.join(projectRoot, "iamu", ".runs");
+  const runsDir2 = path34.join(projectRoot, "iamu", ".runs");
   let runIds = [];
   try {
     runIds = await fs35.readdir(runsDir2);
@@ -23412,7 +23844,7 @@ async function buildRepairLookups(projectRoot) {
     try {
       const manifest = JSON.parse(
         await fs35.readFile(
-          path33.join(runsDir2, runId, "walkthrough.json"),
+          path34.join(runsDir2, runId, "walkthrough.json"),
           "utf8"
         )
       );
@@ -23443,7 +23875,7 @@ async function fixFindings(projectRoot, results, dryRun) {
       parsed.frontmatter,
       {
         ...lookups,
-        fileSlug: path33.basename(result.path, ".md"),
+        fileSlug: path34.basename(result.path, ".md"),
         newId: randomUUID10,
         body: parsed.body
       }
@@ -23482,7 +23914,7 @@ async function validate(filePath, opts) {
   if (process.exitCode === 1) return;
   const results = [];
   if (filePath) {
-    const abs = path33.isAbsolute(filePath) ? filePath : path33.resolve(process.cwd(), filePath);
+    const abs = path34.isAbsolute(filePath) ? filePath : path34.resolve(process.cwd(), filePath);
     try {
       const raw = await fs35.readFile(abs, "utf8");
       results.push(validateFile(abs, raw, projectRoot));
@@ -23498,7 +23930,7 @@ async function validate(filePath, opts) {
       return;
     }
   } else if (opts.run) {
-    const findingsDir = path33.join(projectRoot, "iamu", ENTITY_DIRS.finding);
+    const findingsDir = path34.join(projectRoot, "iamu", ENTITY_DIRS.finding);
     let names2 = [];
     try {
       names2 = await fs35.readdir(findingsDir);
@@ -23506,7 +23938,7 @@ async function validate(filePath, opts) {
     }
     for (const name of names2) {
       if (!name.endsWith(".md")) continue;
-      const abs = path33.join(findingsDir, name);
+      const abs = path34.join(findingsDir, name);
       try {
         const raw = await fs35.readFile(abs, "utf8");
         const { frontmatter } = parseFrontmatter(raw);
@@ -23515,7 +23947,7 @@ async function validate(filePath, opts) {
         }
       } catch {
         results.push({
-          path: path33.relative(projectRoot, abs),
+          path: path34.relative(projectRoot, abs),
           valid: false,
           errors: ["Cannot read file or parse frontmatter"]
         });
@@ -23548,7 +23980,7 @@ async function validate(filePath, opts) {
   } else {
     const typesToCheck = typeFilter ? ENTITY_TYPES.filter((t) => typeFilter.has(t)) : ENTITY_TYPES;
     for (const type2 of typesToCheck) {
-      const iamuTypeDir = path33.join(projectRoot, "iamu", ENTITY_DIRS[type2]);
+      const iamuTypeDir = path34.join(projectRoot, "iamu", ENTITY_DIRS[type2]);
       let names2;
       try {
         names2 = await fs35.readdir(iamuTypeDir);
@@ -23557,20 +23989,20 @@ async function validate(filePath, opts) {
       }
       for (const name of names2) {
         if (!name.endsWith(".md")) continue;
-        const abs = path33.join(iamuTypeDir, name);
+        const abs = path34.join(iamuTypeDir, name);
         try {
           const raw = await fs35.readFile(abs, "utf8");
           results.push(validateFile(abs, raw, projectRoot));
         } catch {
           results.push({
-            path: path33.relative(projectRoot, abs),
+            path: path34.relative(projectRoot, abs),
             valid: false,
             errors: ["Cannot read file"]
           });
         }
       }
     }
-    const ctxPath = path33.join(projectRoot, "iamu", "context.yml");
+    const ctxPath = path34.join(projectRoot, "iamu", "context.yml");
     try {
       const raw = await fs35.readFile(ctxPath, "utf8");
       results.push(validateFile(ctxPath, raw, projectRoot));
@@ -23595,19 +24027,19 @@ async function validate(filePath, opts) {
           valid,
           errors: results.filter((r) => !r.valid).flatMap(
             (r) => r.errors.map((e) => ({
-              path: path33.relative(projectRoot, r.path),
+              path: path34.relative(projectRoot, r.path),
               message: e
             }))
           ),
           warnings: results.filter((r) => r.warnings && r.warnings.length > 0).flatMap(
             (r) => (r.warnings ?? []).map((w) => ({
-              path: path33.relative(projectRoot, r.path),
+              path: path34.relative(projectRoot, r.path),
               message: w
             }))
           ),
           ...opts.fix ? {
             repaired: repaired.map((r) => ({
-              path: path33.relative(projectRoot, r.path),
+              path: path34.relative(projectRoot, r.path),
               changes: r.repairs,
               valid: r.valid
             }))
@@ -23629,7 +24061,7 @@ async function validate(filePath, opts) {
   }
   let hasErrors = false;
   for (const r of results) {
-    const relPath = path33.relative(projectRoot, r.path);
+    const relPath = path34.relative(projectRoot, r.path);
     if (r.valid) {
       if (r.warnings && r.warnings.length > 0) {
         console.log(`  ${symbols.warning} ` + chalk27.yellow(relPath));
@@ -24030,7 +24462,7 @@ __export(set_entity_exports, {
   setEntity: () => setEntity
 });
 import { promises as fs36 } from "fs";
-import path34 from "path";
+import path35 from "path";
 import chalk30 from "chalk";
 import { ZodError as ZodError2 } from "zod";
 function given(opts, key) {
@@ -24171,7 +24603,7 @@ async function setEntity(type2, slug, opts) {
         }
         raw = Buffer.concat(chunks).toString("utf8");
       } else {
-        raw = await fs36.readFile(path34.resolve(projectRoot, opts.file), "utf8");
+        raw = await fs36.readFile(path35.resolve(projectRoot, opts.file), "utf8");
       }
     } catch (err) {
       commandError(
@@ -24599,7 +25031,7 @@ __export(edit_entity_exports, {
 });
 import { spawn as spawn2 } from "child_process";
 import { promises as fs37 } from "fs";
-import path35 from "path";
+import path36 from "path";
 import chalk31 from "chalk";
 async function editEntity(type2, slug, opts = {}) {
   const ctx = await resolveProject(opts);
@@ -24613,19 +25045,19 @@ async function editEntity(type2, slug, opts = {}) {
     return;
   }
   const dir = ENTITY_DIRS[type2];
-  const filePath = path35.join(projectRoot, "iamu", dir, `${slug}.md`);
+  const filePath = path36.join(projectRoot, "iamu", dir, `${slug}.md`);
   try {
     await fs37.access(filePath);
   } catch {
     commandError(
-      `${type2} "${slug}" not found at ${path35.relative(projectRoot, filePath)}.`,
+      `${type2} "${slug}" not found at ${path36.relative(projectRoot, filePath)}.`,
       { ...opts, code: "entity_not_found", fix: `iamu list ${type2}s` }
     );
     return;
   }
   if (!process.stdin.isTTY || process.env.CI) {
     commandError(
-      `Cannot open editor in a non-interactive environment. Edit the file directly: ${path35.relative(projectRoot, filePath)}`,
+      `Cannot open editor in a non-interactive environment. Edit the file directly: ${path36.relative(projectRoot, filePath)}`,
       {
         ...opts,
         code: "non_interactive_environment",
@@ -24700,7 +25132,7 @@ async function editEntity(type2, slug, opts = {}) {
         console.log();
         console.log(
           chalk31.dim(
-            `  Fix the file and run: iamu validate ${path35.relative(projectRoot, filePath)}`
+            `  Fix the file and run: iamu validate ${path36.relative(projectRoot, filePath)}`
           )
         );
         console.log();
@@ -24721,7 +25153,7 @@ async function editEntity(type2, slug, opts = {}) {
       {
         ...opts,
         code: "validation_error",
-        fix: `iamu validate ${path35.relative(projectRoot, filePath)}`
+        fix: `iamu validate ${path36.relative(projectRoot, filePath)}`
       }
     );
   }
@@ -24858,7 +25290,7 @@ async function crawlFrom(page, opts, origin, takeBlocked) {
   const byKey = /* @__PURE__ */ new Map();
   const byPlaceView = /* @__PURE__ */ new Map();
   const signatureOf = (s) => exploreSignature(s.headings, s.title);
-  function addSurface(state, place, view, path43, depth) {
+  function addSurface(state, place, view, path44, depth) {
     const key = exploreSurfaceKey(place, view);
     const surface = {
       key,
@@ -24870,7 +25302,7 @@ async function crawlFrom(page, opts, origin, takeBlocked) {
       headings: state.headings,
       fields: state.fields,
       depth,
-      path: path43,
+      path: path44,
       actions: []
     };
     surfaces.push(surface);
@@ -24888,9 +25320,9 @@ ${surface.signature}`, key);
     });
     await settle(page, settleMs);
   }
-  async function replay(path43) {
-    if (!("goto" in (path43[0] ?? {}))) await goto(opts.startUrl);
-    for (const step of path43) {
+  async function replay(path44) {
+    if (!("goto" in (path44[0] ?? {}))) await goto(opts.startUrl);
+    for (const step of path44) {
       if ("goto" in step) {
         await goto(step.goto);
       } else {
@@ -25014,8 +25446,8 @@ ${sig}`, key);
               if (stats.surfaces >= budget.max_surfaces) {
                 stats.truncated = true;
               } else {
-                const path43 = !sameDoc && view === null ? [{ goto: after.url }] : [...surface.path, ...via, click];
-                addSurface(after, place, view, path43, surface.depth + 1);
+                const path44 = !sameDoc && view === null ? [{ goto: after.url }] : [...surface.path, ...via, click];
+                addSurface(after, place, view, path44, surface.depth + 1);
               }
             }
           }
@@ -25215,7 +25647,7 @@ __export(explore_exports, {
   exploreList: () => exploreList,
   exploreRun: () => exploreRun
 });
-import path36 from "path";
+import path37 from "path";
 import chalk32 from "chalk";
 function fail2(message, json2) {
   if (json2) console.error(JSON.stringify({ error: message }));
@@ -25349,7 +25781,7 @@ async function exploreRun(url, opts) {
     surfaces: result.surfaces
   };
   const file = await writeExploreMap(ctx.projectRoot, map2);
-  const rel = path36.relative(process.cwd(), file);
+  const rel = path37.relative(process.cwd(), file);
   if (opts.json) {
     console.log(JSON.stringify({ id: map2.id, path: rel, stats: map2.stats }));
     return;
@@ -25455,15 +25887,15 @@ async function exploreCoverageCommand(mapId, opts) {
         "  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
       )
     );
-    for (const cap of capReport.capabilities) {
-      const title = cap.slug.padEnd(24);
-      const surfaces = `${cap.reached_surfaces}/${cap.total_surfaces}`.padStart(
+    for (const cap2 of capReport.capabilities) {
+      const title = cap2.slug.padEnd(24);
+      const surfaces = `${cap2.reached_surfaces}/${cap2.total_surfaces}`.padStart(
         8
       );
-      const covStr = `${cap.coverage_pct}%`.padStart(8);
-      const scenarios = `${cap.primary_scenarios} / ${cap.secondary_scenarios}`;
-      const untestedFlag = cap.primary_scenarios === 0 && cap.unreached_surfaces > 0 ? chalk32.yellow("  (untested)") : "";
-      const covColored = cap.coverage_pct === 100 ? chalk32.green(covStr) : cap.coverage_pct === 0 ? chalk32.red(covStr) : chalk32.yellow(covStr);
+      const covStr = `${cap2.coverage_pct}%`.padStart(8);
+      const scenarios = `${cap2.primary_scenarios} / ${cap2.secondary_scenarios}`;
+      const untestedFlag = cap2.primary_scenarios === 0 && cap2.unreached_surfaces > 0 ? chalk32.yellow("  (untested)") : "";
+      const covColored = cap2.coverage_pct === 100 ? chalk32.green(covStr) : cap2.coverage_pct === 0 ? chalk32.red(covStr) : chalk32.yellow(covStr);
       console.log(
         `  ${title} ${surfaces}   ${covColored}   ${scenarios}${untestedFlag}`
       );
@@ -25501,10 +25933,10 @@ async function exploreCoverageCommand(mapId, opts) {
     const hasGaps = capReport.capabilities.some((c) => c.unreached_surfaces > 0) || capReport.unassigned_surfaces.some((s) => s.status !== "reached");
     if (hasGaps) {
       console.log(chalk32.red("\n  UNREACHED SURFACES (Gaps)"));
-      for (const cap of capReport.capabilities) {
-        const gaps = cap.surfaces.filter((s) => s.status !== "reached");
+      for (const cap2 of capReport.capabilities) {
+        const gaps = cap2.surfaces.filter((s) => s.status !== "reached");
         if (gaps.length === 0) continue;
-        console.log(`    ${chalk32.bold(cap.slug)}:`);
+        console.log(`    ${chalk32.bold(cap2.slug)}:`);
         for (const s of gaps) {
           console.log(
             `      ${chalk32.red("\u25CB")} ${s.key.padEnd(32)} ${s.label}${chalk32.dim(` (depth ${s.depth})`)}`
@@ -25525,10 +25957,10 @@ async function exploreCoverageCommand(mapId, opts) {
     }
     if (opts.all) {
       console.log(chalk32.green("\n  REACHED SURFACES"));
-      for (const cap of capReport.capabilities) {
-        const reached = cap.surfaces.filter((s) => s.status === "reached");
+      for (const cap2 of capReport.capabilities) {
+        const reached = cap2.surfaces.filter((s) => s.status === "reached");
         if (reached.length === 0) continue;
-        console.log(`    ${chalk32.bold(cap.slug)}:`);
+        console.log(`    ${chalk32.bold(cap2.slug)}:`);
         for (const s of reached) {
           console.log(
             `      ${chalk32.green("\u2713")} ${s.key.padEnd(32)} ${s.label}${chalk32.dim(` (depth ${s.depth})`)}`
@@ -25850,7 +26282,7 @@ __export(start_run_exports, {
   startRun: () => startRun,
   testabilityTarget: () => testabilityTarget2
 });
-import path37 from "path";
+import path38 from "path";
 import chalk33 from "chalk";
 async function testabilityTarget2(projectRoot) {
   try {
@@ -26094,7 +26526,7 @@ async function startRun(scenarioSlugArg, opts) {
     ...viewport ? { viewport } : {}
   };
   await atomicWriteFile(
-    path37.join(run.absPath, "walkthrough.json"),
+    path38.join(run.absPath, "walkthrough.json"),
     JSON.stringify(manifest, null, 2) + "\n"
   );
   const liveRes = await registerLiveRun({
@@ -26110,7 +26542,7 @@ async function startRun(scenarioSlugArg, opts) {
       JSON.stringify(
         {
           run_id: run.runId,
-          path: path37.relative(projectRoot, run.absPath),
+          path: path38.relative(projectRoot, run.absPath),
           scenario_slug: scenarioSlug,
           target_url: start2.url,
           target_reachable: targetReachable,
@@ -26164,7 +26596,7 @@ async function startRun(scenarioSlugArg, opts) {
     );
   }
   console.log(
-    `  ${chalk33.dim("path:")}     ${path37.relative(projectRoot, run.absPath)}`
+    `  ${chalk33.dim("path:")}     ${path38.relative(projectRoot, run.absPath)}`
   );
   console.log();
   console.log(`  ${chalk33.bold("Next steps for blind execution:")}`);
@@ -26394,7 +26826,7 @@ function composeWalkerPrompt(p) {
     `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|observation> --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 problem (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.",
-    `Before you finish, record synthesis with: ${iamu} summary ${p.runId} --worked "..." --worked "..." --question "..."`,
+    `Before you finish, record synthesis with: ${iamu} summary ${p.runId} --worked "..." --worked "..." --question "..." [--setup-note "..."]. --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.",
     "",
@@ -27044,7 +27476,7 @@ __export(new_finding_exports, {
 });
 import { randomUUID as randomUUID12 } from "crypto";
 import { access, readFile as readFile7 } from "fs/promises";
-import path38 from "path";
+import path39 from "path";
 import chalk36 from "chalk";
 async function newFinding(opts) {
   const ctx = await resolveProject(opts);
@@ -27121,7 +27553,7 @@ async function newFinding(opts) {
     }
     try {
       await access(
-        path38.join(runDirPath, "steps", `${String(n).padStart(3, "0")}.json`)
+        path39.join(runDirPath, "steps", `${String(n).padStart(3, "0")}.json`)
       );
     } catch {
       commandError(
@@ -27140,7 +27572,7 @@ async function newFinding(opts) {
   if (!scenarioSlug) {
     try {
       const manifestRaw = await readFile7(
-        path38.join(runDirPath, "walkthrough.json"),
+        path39.join(runDirPath, "walkthrough.json"),
         "utf8"
       );
       const manifest = JSON.parse(manifestRaw);
@@ -27287,7 +27719,7 @@ __export(summary_exports, {
   summaryCommand: () => summaryCommand
 });
 import { promises as fs38 } from "fs";
-import path39 from "path";
+import path40 from "path";
 import chalk37 from "chalk";
 function blockedFrom(value) {
   const reason = value && typeof value === "object" ? value.reason : value;
@@ -27310,12 +27742,18 @@ async function summaryCommand(runIdArg, opts) {
   if (!runDirPath) return;
   let whatWorked = [];
   let openQuestions = [];
+  let setupNotes = [];
   let model = opts.model?.trim() || void 0;
-  const summaryPath = path39.join(runDirPath, "summary.json");
+  const summaryPath = path40.join(runDirPath, "summary.json");
   let blocked;
   try {
     const prev = JSON.parse(await fs38.readFile(summaryPath, "utf8"));
     blocked = blockedFrom(prev.blocked);
+    if (Array.isArray(prev.setup_notes)) {
+      setupNotes = prev.setup_notes.filter(
+        (x) => typeof x === "string" && x.trim() !== ""
+      );
+    }
   } catch {
   }
   if (opts.file) {
@@ -27324,7 +27762,7 @@ async function summaryCommand(runIdArg, opts) {
       if (opts.file === "-") {
         raw = await readStdinText();
       } else {
-        raw = await fs38.readFile(path39.resolve(projectRoot, opts.file), "utf8");
+        raw = await fs38.readFile(path40.resolve(projectRoot, opts.file), "utf8");
       }
       const parsed = JSON.parse(raw);
       if (Array.isArray(parsed.what_worked)) {
@@ -27337,6 +27775,11 @@ async function summaryCommand(runIdArg, opts) {
           (x) => typeof x === "string" && x.trim() !== ""
         );
       }
+      if (Array.isArray(parsed.setup_notes)) {
+        setupNotes = parsed.setup_notes.filter(
+          (x) => typeof x === "string" && x.trim() !== ""
+        );
+      }
       if (typeof parsed.model === "string" && parsed.model.trim()) {
         model = parsed.model.trim();
       }
@@ -27362,6 +27805,7 @@ async function summaryCommand(runIdArg, opts) {
   if (cliQuestions.length > 0) {
     openQuestions = [...openQuestions, ...cliQuestions];
   }
+  setupNotes = [.../* @__PURE__ */ new Set([...setupNotes, ...toList(opts.setupNote)])];
   if (opts.blocked === false) {
     blocked = void 0;
   } else {
@@ -27370,6 +27814,7 @@ async function summaryCommand(runIdArg, opts) {
   const data = {
     what_worked: whatWorked,
     open_questions: openQuestions,
+    setup_notes: setupNotes,
     ...model ? { model } : {},
     ...blocked ? { blocked } : {}
   };
@@ -27380,7 +27825,7 @@ async function summaryCommand(runIdArg, opts) {
       JSON.stringify(
         {
           run_id: runId,
-          path: path39.relative(projectRoot, summaryPath),
+          path: path40.relative(projectRoot, summaryPath),
           summary: data
         },
         null,
@@ -27406,6 +27851,11 @@ async function summaryCommand(runIdArg, opts) {
       `    ${chalk37.dim("open questions:")} ${data.open_questions.length} item(s)`
     );
   }
+  if (data.setup_notes.length > 0) {
+    console.log(
+      `    ${chalk37.dim("setup notes:")}    ${data.setup_notes.length} item(s)`
+    );
+  }
   console.log();
 }
 var init_summary = __esm({
@@ -27440,7 +27890,7 @@ __export(complete_exports, {
   validateCanonicalWalkthrough: () => validateCanonicalWalkthrough
 });
 import { promises as fs39 } from "fs";
-import path40 from "path";
+import path41 from "path";
 import chalk38 from "chalk";
 async function complete(runIdArg, opts) {
   const ctx = await resolveProject(opts);
@@ -27477,7 +27927,7 @@ async function complete(runIdArg, opts) {
   let judgeReported;
   try {
     const verdictsRaw = await fs39.readFile(
-      path40.join(run.runDirPath, "verdicts.json"),
+      path41.join(run.runDirPath, "verdicts.json"),
       "utf8"
     );
     const parsed = JSON.parse(verdictsRaw);
@@ -27553,7 +28003,7 @@ async function loadRun(runId, opts) {
     });
     return null;
   }
-  const manifestPath = path40.join(runDirPath, "walkthrough.json");
+  const manifestPath = path41.join(runDirPath, "walkthrough.json");
   let manifest;
   try {
     manifest = JSON.parse(
@@ -27584,7 +28034,7 @@ async function reportAlreadyCompleted(run, opts) {
   if (opts?.json) {
     try {
       const raw = await fs39.readFile(
-        path40.join(run.runDirPath, "canonical.json"),
+        path41.join(run.runDirPath, "canonical.json"),
         "utf8"
       );
       console.log(raw.trim());
@@ -27720,15 +28170,11 @@ function printCompletionSummary(run, completedAt, assembled, extras, provenanceA
   }
   console.log();
   console.log(
-    `  ${chalk38.dim("canonical:")} ${chalk38.dim(path40.relative(projectRoot, assembled.canonicalPath))}`
-  );
-  console.log(
-    `  ${chalk38.dim("report:")}    ${chalk38.dim(path40.relative(projectRoot, assembled.reportPath))}`
+    `  ${chalk38.dim("canonical:")} ${chalk38.dim(path41.relative(projectRoot, assembled.canonicalPath))}`
   );
+  console.log(`  ${chalk38.dim("report:")}    ${assembled.reportPath}`);
   if (assembled.htmlReportPath) {
-    console.log(
-      `  ${chalk38.dim("html:")}      ${chalk38.dim(path40.relative(projectRoot, assembled.htmlReportPath))}`
-    );
+    console.log(`  ${chalk38.dim("html:")}      ${assembled.htmlReportPath}`);
   }
   if (extras.viewportWarning) {
     console.log();
@@ -27797,7 +28243,7 @@ function screenshotFitsViewport(width, expected) {
 }
 async function screenshotSizeWarning(runDirPath, viewport) {
   if (!viewport) return null;
-  const dir = path40.join(runDirPath, "screenshots");
+  const dir = path41.join(runDirPath, "screenshots");
   let first;
   try {
     first = (await fs39.readdir(dir)).filter((f) => f.toLowerCase().endsWith(".png")).sort((a, b) => a.localeCompare(b, void 0, { numeric: true }))[0];
@@ -27807,7 +28253,7 @@ async function screenshotSizeWarning(runDirPath, viewport) {
   if (!first) return null;
   let size = null;
   try {
-    const handle = await fs39.open(path40.join(dir, first), "r");
+    const handle = await fs39.open(path41.join(dir, first), "r");
     try {
       const head = Buffer.alloc(24);
       const { bytesRead } = await handle.read(head, 0, 24, 0);
@@ -27824,7 +28270,7 @@ async function screenshotSizeWarning(runDirPath, viewport) {
 async function readWalkerSummary(runDirPath) {
   try {
     const data = JSON.parse(
-      await fs39.readFile(path40.join(runDirPath, "summary.json"), "utf8")
+      await fs39.readFile(path41.join(runDirPath, "summary.json"), "utf8")
     );
     const strings = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "") : void 0;
     const model = typeof data.model === "string" && data.model.trim() !== "" ? data.model.trim() : void 0;
@@ -27832,6 +28278,7 @@ async function readWalkerSummary(runDirPath) {
     return {
       what_worked: strings(data.what_worked),
       open_questions: strings(data.open_questions),
+      setup_notes: strings(data.setup_notes),
       model,
       ...typeof reason === "string" && reason.trim() !== "" ? { blocked: { reason: reason.trim() } } : {}
     };
@@ -27933,7 +28380,7 @@ function validateCanonicalWalkthrough(canonical) {
   return canonicalWalkthroughSchema.parse(canonical);
 }
 async function persistCanonical(runDirPath, canonical) {
-  const canonicalPath = path40.join(runDirPath, "canonical.json");
+  const canonicalPath = path41.join(runDirPath, "canonical.json");
   await atomicWriteFile(
     canonicalPath,
     `${JSON.stringify(canonical, null, 2)}
@@ -27942,7 +28389,7 @@ async function persistCanonical(runDirPath, canonical) {
   return canonicalPath;
 }
 async function persistReport(runDirPath, canonical) {
-  const reportPath = path40.join(runDirPath, "report.md");
+  const reportPath = path41.join(runDirPath, "report.md");
   await atomicWriteFile(reportPath, renderCanonicalMarkdown(canonical));
   return reportPath;
 }
@@ -28121,13 +28568,13 @@ __export(match_exports, {
   matchRecord: () => matchRecord
 });
 import { promises as fs40 } from "fs";
-import path41 from "path";
+import path42 from "path";
 import chalk39 from "chalk";
 async function completedManifest2(runDirPath, runId, opts) {
   let manifest;
   try {
     manifest = JSON.parse(
-      await fs40.readFile(path41.join(runDirPath, "walkthrough.json"), "utf8")
+      await fs40.readFile(path42.join(runDirPath, "walkthrough.json"), "utf8")
     );
   } catch {
     commandError(`Run not found: ${runId}`, {
@@ -28164,7 +28611,7 @@ async function match(runId, opts) {
   );
   const needed = !manifest.blocked && input.current.length > 0 && (input.prior.length > 0 || (input.guidance ?? []).length > 0);
   const prompt = needed ? composeMatchPrompt(input) : null;
-  const promptFilePath = opts?.promptFile ?? path41.join(runDirPath, "match_prompt.md");
+  const promptFilePath = opts?.promptFile ?? path42.join(runDirPath, "match_prompt.md");
   if (prompt) {
     await fs40.writeFile(promptFilePath, prompt, "utf8");
   } else {
@@ -28180,8 +28627,8 @@ async function match(runId, opts) {
           ...input,
           needed,
           ...manifest.blocked ? { blocked: manifest.blocked } : {},
-          prompt_file: prompt ? path41.relative(ctx.projectRoot, promptFilePath) : null,
-          prompt_file_abs: prompt ? path41.resolve(promptFilePath) : null,
+          prompt_file: prompt ? path42.relative(ctx.projectRoot, promptFilePath) : null,
+          prompt_file_abs: prompt ? path42.resolve(promptFilePath) : null,
           match_prompt: prompt
         },
         null,
@@ -28209,7 +28656,7 @@ async function matchRecord(runId, opts) {
   const manifest = await completedManifest2(runDirPath, runId, opts);
   if (!manifest) return;
   const input = await readAnswerInput(opts, "matches", {
-    defaultPath: path41.join(runDirPath, "matches.json"),
+    defaultPath: path42.join(runDirPath, "matches.json"),
     code: "missing_matches_input",
     fix: `iamu match-record ${runId} --data '<json>'`
   });
@@ -28288,10 +28735,10 @@ __export(advise_exports, {
   readAdvisePrompt: () => readAdvisePrompt
 });
 import { existsSync as existsSync17, promises as fs41, readFileSync as readFileSync10 } from "fs";
-import path42 from "path";
+import path43 from "path";
 import chalk40 from "chalk";
 function readAdvisePrompt(projectRoot) {
-  const installed = path42.join(projectRoot, "iamu", ".prompts", "advise.md");
+  const installed = path43.join(projectRoot, "iamu", ".prompts", "advise.md");
   if (existsSync17(installed)) {
     try {
       return readFileSync10(installed, "utf8");
@@ -28336,7 +28783,7 @@ async function advise(runId, opts = {}) {
     findings2 = input.findings.length;
     needed = findings2 >= 2;
     if (!needed) reason = "fewer than two open findings in the project";
-    promptPath = opts.promptFile ?? path42.join(analysisDir(projectRoot), "advise_prompt.md");
+    promptPath = opts.promptFile ?? path43.join(analysisDir(projectRoot), "advise_prompt.md");
   } else {
     if (!requireRunId(runId, opts, "iamu advise <run-id>")) return;
     const runDirPath = resolveRunDir(projectRoot, runId, opts);
@@ -28346,21 +28793,21 @@ async function advise(runId, opts = {}) {
     input = await buildAdviseInput(projectRoot, runId, manifest.scenario_slug);
     refsDir = runDirPath;
     findings2 = input.findings.length;
-    const advised = existsSync17(path42.join(runDirPath, ADVICE_FILE));
+    const advised = existsSync17(path43.join(runDirPath, ADVICE_FILE));
     needed = !manifest.blocked && findings2 > 0 && !advised;
     if (manifest.blocked) reason = "the run was blocked";
     else if (advised) reason = "the run is already advised";
     else if (findings2 === 0) reason = "no open findings to advise";
-    promptPath = opts.promptFile ?? path42.join(runDirPath, "advise_prompt.md");
+    promptPath = opts.promptFile ?? path43.join(runDirPath, "advise_prompt.md");
   }
   const { bundle, refs } = promptBundle(input);
   const prompt = needed ? composePrompt(projectRoot, bundle) : null;
   if (prompt) {
-    await fs41.mkdir(path42.dirname(promptPath), { recursive: true });
+    await fs41.mkdir(path43.dirname(promptPath), { recursive: true });
     await fs41.writeFile(promptPath, prompt, "utf8");
     await fs41.mkdir(refsDir, { recursive: true });
     await fs41.writeFile(
-      path42.join(refsDir, ADVISE_REFS_FILE),
+      path43.join(refsDir, ADVISE_REFS_FILE),
       `${JSON.stringify(refs, null, 2)}
 `,
       "utf8"
@@ -28374,8 +28821,8 @@ async function advise(runId, opts = {}) {
           ...reason ? { reason } : {},
           mode: opts.project ? "project" : "run",
           findings: findings2,
-          prompt_file: prompt ? path42.relative(projectRoot, promptPath) : null,
-          prompt_file_abs: prompt ? path42.resolve(promptPath) : null,
+          prompt_file: prompt ? path43.relative(projectRoot, promptPath) : null,
+          prompt_file_abs: prompt ? path43.resolve(promptPath) : null,
           prompt_chars: prompt?.length ?? 0,
           advise_prompt: prompt
         },
@@ -28439,7 +28886,7 @@ async function adviseRecord(runId, opts) {
   const { projectRoot } = ctx;
   if (opts.project) {
     const input2 = await readAnswerInput(opts, "advice", {
-      defaultPath: path42.join(analysisDir(projectRoot), "answer.json"),
+      defaultPath: path43.join(analysisDir(projectRoot), "answer.json"),
       code: "missing_advice_input",
       fix: "iamu advise-record --project --data '<json>'"
     });
@@ -28469,7 +28916,7 @@ async function adviseRecord(runId, opts) {
   const manifest = await completedManifest2(runDirPath, runId, opts);
   if (!manifest) return;
   const input = await readAnswerInput(opts, "advice", {
-    defaultPath: path42.join(runDir(projectRoot, runId), "advise_answer.json"),
+    defaultPath: path43.join(runDir(projectRoot, runId), "advise_answer.json"),
     code: "missing_advice_input",
     fix: `iamu advise-record ${runId} --data '<json>'`
   });
@@ -28503,9 +28950,9 @@ async function directionsList(opts) {
   const ctx = await resolveProject(opts);
   if (!ctx) return;
   const all = await listDirections(ctx.projectRoot);
-  const rank = (s) => ["accepted", "proposed", "done", "rejected"].indexOf(s);
+  const rank2 = (s) => ["accepted", "proposed", "done", "rejected"].indexOf(s);
   const sorted = [...all].sort(
-    (a, b) => rank(a.frontmatter.status) - rank(b.frontmatter.status)
+    (a, b) => rank2(a.frontmatter.status) - rank2(b.frontmatter.status)
   );
   if (opts.json) {
     console.log(
@@ -28515,7 +28962,7 @@ async function directionsList(opts) {
           problem: d.texts.problem,
           change: d.texts.change,
           leading_practice: d.texts.leading_practice,
-          path: path42.relative(ctx.projectRoot, d.path)
+          path: path43.relative(ctx.projectRoot, d.path)
         })),
         null,
         2
@@ -28896,9 +29343,9 @@ function registerProjectCommands(program2) {
     "after",
     "\nExamples:\n  $ iamu validate --all\n  $ iamu validate --all --fix --dry-run\n  $ iamu validate iamu/personas/maria.md"
   ).action(
-    async (path43, opts) => {
+    async (path44, opts) => {
       const { validate: validate2 } = await Promise.resolve().then(() => (init_validate(), validate_exports));
-      await validate2(path43, opts);
+      await validate2(path44, opts);
     }
   );
   program2.command("update").helpGroup("Project:").description("Update and repair agent skills and prompts to latest version").option(
@@ -29272,13 +29719,16 @@ function registerWalkthroughCommands(program2) {
     }
   );
   program2.command("summary [run-id]").helpGroup("Walkthrough:").description(
-    "Record walker summary (what worked, open questions, or that the walk was blocked) atomically"
+    "Record walker summary (what worked, open questions, setup notes, or that the walk was blocked) atomically"
   ).option("--run <run-id>", "Run ID (or pass as positional argument)").option(
     "--worked <note...>",
     "Things that worked well (can be specified multiple times)"
   ).option(
     "--question <note...>",
-    "Open questions that arose (can be specified multiple times)"
+    "Questions for the product team the walk raised (can be specified multiple times)"
+  ).option(
+    "--setup-note <note...>",
+    "Doubts about the test setup, not the product: missing data, accounts, dates (can be specified multiple times)"
   ).option("--model <name>", "Model identifier (e.g. flash, haiku)").option(
     "--blocked <reason>",
     "The walk could not start as set up (persona unreachable, world missing): what was missing"