revyse 0.2.0 → 0.2.1

package/dist/{chunk-FYWZYXR4.js → chunk-FVZWKW32.js}

@@ -6,8 +6,8 @@ var __export = (target, all) => {
 };
 
 // src/agent/local-agent.ts
-import { existsSync as existsSync8, readFileSync as readFileSync12, watch } from "fs";
-import path20 from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync12, watch } from "fs";
+import path21 from "path";
 import { fileURLToPath } from "url";
 
 // ../agent-core/src/path-policy.ts
@@ -925,10 +925,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path21) {
-  if (!path21)
+function getElementAtPath(obj, path22) {
+  if (!path22)
     return obj;
-  return path21.reduce((acc, key) => acc?.[key], obj);
+  return path22.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -1268,11 +1268,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path21, issues) {
+function prefixIssues(path22, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path21);
+    iss.path.unshift(path22);
     return iss;
   });
 }
@@ -1734,16 +1734,16 @@ function flattenError(error62, mapper = (issue2) => issue2.message) {
 }
 function formatError(error62, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error63, path21 = []) => {
+  const processError = (error63, path22 = []) => {
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path21, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path22, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path21, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path22, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path21, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path22, ...issue2.path]);
       } else {
-        const fullpath = [...path21, ...issue2.path];
+        const fullpath = [...path22, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -1782,17 +1782,17 @@ function formatError(error62, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error62, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error63, path21 = []) => {
+  const processError = (error63, path22 = []) => {
     var _a3;
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path21, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path22, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path21, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path22, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path21, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path22, ...issue2.path]);
       } else {
-        const fullpath = [...path21, ...issue2.path];
+        const fullpath = [...path22, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -1831,8 +1831,8 @@ function treeifyError(error62, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path21 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path21) {
+  const path22 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path22) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -18970,13 +18970,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path21 = ref.slice(1).split("/").filter(Boolean);
-  if (path21.length === 0) {
+  const path22 = ref.slice(1).split("/").filter(Boolean);
+  if (path22.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path21[0] === defsKey) {
-    const key = path21[1] === void 0 ? void 0 : decodeJSONPointerSegment(path21[1]);
+  if (path22[0] === defsKey) {
+    const key = path22[1] === void 0 ? void 0 : decodeJSONPointerSegment(path22[1]);
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -20280,6 +20280,14 @@ var agentEventSchema = external_exports.object({
   event: external_exports.string(),
   data: external_exports.unknown().optional()
 });
+var changedFileSchema = external_exports.object({
+  path: external_exports.string(),
+  additions: external_exports.number().int(),
+  deletions: external_exports.number().int(),
+  explanation: external_exports.string().optional(),
+  /** Agent engine: whether the file was created, modified or deleted. */
+  kind: external_exports.enum(["create", "modify", "delete"]).optional()
+});
 var agentChangeEventSchema = external_exports.discriminatedUnion("type", [
   external_exports.object({ type: external_exports.literal("planning"), changeId: external_exports.uuid() }),
   external_exports.object({
@@ -20287,6 +20295,8 @@ var agentChangeEventSchema = external_exports.discriminatedUnion("type", [
     changeId: external_exports.uuid(),
     plan: changePlanSchema,
     model: external_exports.string(),
+    /** Models tried first that couldn't run (A7, A11): the plan says it ran on another. */
+    fellBackFrom: external_exports.array(external_exports.string()).optional(),
     /** Credits the change has cost so far (B1). */
     cost: external_exports.number().nonnegative().optional()
   }),
@@ -20306,22 +20316,23 @@ var agentChangeEventSchema = external_exports.discriminatedUnion("type", [
   external_exports.object({
     type: external_exports.literal("checking"),
     changeId: external_exports.uuid(),
-    checks: external_exports.array(external_exports.object({ kind: checkKindSchema, status: checkStatusSchema }))
+    checks: external_exports.array(
+      external_exports.object({
+        kind: checkKindSchema,
+        status: checkStatusSchema,
+        /** How long a finished check took (L16). */
+        durationMs: external_exports.number().int().nonnegative().optional()
+      })
+    ),
+    /** The change as written, shown while its checks run (L17, ADR 0042). */
+    files: external_exports.array(changedFileSchema).optional(),
+    diff: external_exports.string().optional()
   }),
   external_exports.object({
     type: external_exports.literal("result"),
     changeId: external_exports.uuid(),
     state: changeStateSchema,
-    files: external_exports.array(
-      external_exports.object({
-        path: external_exports.string(),
-        additions: external_exports.number().int(),
-        deletions: external_exports.number().int(),
-        explanation: external_exports.string().optional(),
-        /** Agent engine: whether the file was created, modified or deleted. */
-        kind: external_exports.enum(["create", "modify", "delete"]).optional()
-      })
-    ),
+    files: external_exports.array(changedFileSchema),
     diff: external_exports.string(),
     checks: external_exports.array(checkResultSchema),
     /** Credits the change has cost so far (B1). */
@@ -21778,6 +21789,71 @@ ${summary}` : summary
 // ../agent-core/src/checks/browser.ts
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
 import path11 from "path";
+var LOC_ATTRIBUTE = "data-revyse-loc";
+var FRAME_PADDING = 24;
+var FRAME_MIN_WIDTH = 480;
+var FRAME_MAX_RATIO = 2;
+function frameAround(box, viewport) {
+  const width = Math.min(Math.max(box.width + 2 * FRAME_PADDING, FRAME_MIN_WIDTH), viewport.width);
+  const height = Math.min(
+    Math.max(box.height + 2 * FRAME_PADDING, width / FRAME_MAX_RATIO),
+    viewport.height
+  );
+  const place = (start, size, frame, limit) => Math.round(Math.min(Math.max(start + size / 2 - frame / 2, 0), limit - frame));
+  return {
+    x: place(box.x, box.width, width, viewport.width),
+    y: place(box.y, box.height, height, viewport.height),
+    width: Math.round(width),
+    height: Math.round(height)
+  };
+}
+function nearestLoc(locs, source) {
+  const distance = (loc) => {
+    const [line, column] = loc.split(":").slice(-2).map(Number);
+    if (!Number.isFinite(line) || source.line === void 0) return Infinity;
+    return Math.abs(line - source.line) * 1e4 + Math.abs((column ?? 0) - (source.column ?? 0));
+  };
+  let best = 0;
+  for (let i = 1; i < locs.length; i++) if (distance(locs[i]) < distance(locs[best])) best = i;
+  return best;
+}
+async function findSelected(page, selector, source) {
+  const bySelector = page.locator(selector).first();
+  const selectorFound = await page.locator(selector).count().catch(() => 0) > 0;
+  if (source?.line) {
+    const exact = source.column === void 0 ? `${source.file}:${source.line}:` : `${source.file}:${source.line}:${source.column}`;
+    const isExact = (loc) => source.column === void 0 ? !!loc?.startsWith(exact) : loc === exact;
+    if (selectorFound) {
+      const loc = await bySelector.evaluate((el, attr) => el.closest(`[${attr}]`)?.getAttribute(attr) ?? null, LOC_ATTRIBUTE).catch(() => null);
+      if (isExact(loc)) return bySelector;
+    }
+    const op = source.column === void 0 ? "^=" : "=";
+    const byLoc = page.locator(`[${LOC_ATTRIBUTE}${op}${JSON.stringify(exact)}]`);
+    if (await byLoc.count().catch(() => 0) > 0) return byLoc.first();
+  }
+  if (selectorFound) return bySelector;
+  if (!source) return null;
+  const fromFile = page.locator(`[${LOC_ATTRIBUTE}^=${JSON.stringify(`${source.file}:`)}]`);
+  const locs = await fromFile.evaluateAll((els, attr) => els.map((el) => el.getAttribute(attr) ?? ""), LOC_ATTRIBUTE).catch(() => []);
+  return locs.length > 0 ? fromFile.nth(nearestLoc(locs, source)) : null;
+}
+async function frameSelected(page, target) {
+  await target.scrollIntoViewIfNeeded({ timeout: 2e3 }).catch(() => {
+  });
+  await page.evaluate(
+    () => Promise.race([
+      Promise.all(
+        Array.from(document.images).filter((img) => !img.complete).map((img) => new Promise((done) => img.addEventListener("loadend", done)))
+      ),
+      new Promise((done) => setTimeout(done, 2e3))
+    ])
+  ).catch(() => {
+  });
+  const box = await target.boundingBox().catch(() => null);
+  const viewport = page.viewportSize();
+  if (!box || !viewport || box.width <= 0 || box.height <= 0) return null;
+  return frameAround(box, viewport);
+}
 var BrowserUnavailableError = class extends Error {
 };
 var MAX_ERRORS = 10;
@@ -21805,7 +21881,7 @@ async function createPlaywrightDriver(env = process.env) {
   if (!browser) throw new BrowserUnavailableError(`No Chromium could be started. ${NOT_RUN_HINT}`);
   const b = browser;
   return {
-    async capture({ url: url2, selector, sourceFile, timeoutMs }) {
+    async capture({ url: url2, selector, source, timeoutMs }) {
       const context = await b.newContext({ viewport: { width: 1280, height: 800 } });
       const page = await context.newPage();
       const errors = [];
@@ -21825,9 +21901,15 @@ async function createPlaywrightDriver(env = process.env) {
         let found = null;
         if (await page.locator(selector).count().catch(() => 0) > 0)
           found = "selector";
-        else if (sourceFile && await page.locator(`[data-revyse-loc^="${sourceFile}:"]`).count() > 0)
+        else if (source && await page.locator(`[${LOC_ATTRIBUTE}^=${JSON.stringify(`${source.file}:`)}]`).count() > 0)
           found = "source";
-        const screenshot = await page.screenshot({ type: "png" });
+        const target = await findSelected(page, selector, source);
+        const clip = target ? await frameSelected(page, target) : null;
+        const screenshot = await page.screenshot({
+          type: "png",
+          animations: "disabled",
+          ...clip ? { clip } : {}
+        });
         return { status: res?.status() ?? null, found, screenshot, errors };
       } finally {
         await context.close();
@@ -21942,7 +22024,7 @@ function createAgentApi(opts) {
   const f = opts.fetch ?? fetch;
   const base = opts.apiUrl.replace(/\/+$/, "");
   const auth = { authorization: `Bearer ${opts.token}` };
-  const call = (path21, body, signal) => f(`${base}${path21}`, {
+  const call = (path22, body, signal) => f(`${base}${path22}`, {
     method: "POST",
     headers: { "content-type": "application/json", ...auth },
     body: JSON.stringify(body),
@@ -21958,18 +22040,18 @@ function createAgentApi(opts) {
   }
   return {
     baseUrl: base,
-    async get(path21) {
-      const res = await f(`${base}${path21}`, { headers: auth });
+    async get(path22) {
+      const res = await f(`${base}${path22}`, { headers: auth });
       if (!res.ok) throw await failure2(res);
       return await res.json();
     },
-    async post(path21, body) {
-      const res = await call(path21, body);
+    async post(path22, body) {
+      const res = await call(path22, body);
       if (!res.ok) throw await failure2(res);
       return await res.json();
     },
-    async *stream(path21, body, signal) {
-      const res = await call(path21, body, signal);
+    async *stream(path22, body, signal) {
+      const res = await call(path22, body, signal);
       if (!res.ok) throw await failure2(res);
       if (!res.body) return;
       const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
@@ -22002,11 +22084,51 @@ function parseBlock(block) {
 
 // ../agent-core/src/change/runner.ts
 import { readFileSync as readFileSync6, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "fs";
-import path14 from "path";
+import path15 from "path";
+
+// ../agent-core/src/patch/originals.ts
+import { existsSync as existsSync4 } from "fs";
+import path12 from "path";
+async function withOriginals(opts) {
+  const io = opts.io ?? nodeIO;
+  const dir = changeDir(opts.projectRoot, opts.changeId);
+  const manifest = JSON.parse(io.readFile(path12.join(dir, "manifest.json")));
+  const files = manifest.files.map((f) => ({
+    ...f,
+    real: resolveProjectPath(opts.projectRoot, f.path),
+    pre: f.preHash === null ? null : io.readFile(path12.join(dir, "pre", f.path)),
+    post: f.postHash === null ? null : io.readFile(path12.join(dir, "post", f.path))
+  }));
+  const hashOf = (real) => existsSync4(real) ? hashContent(io.readFile(real)) : null;
+  const put = (real, content) => {
+    if (content === null) io.unlink(real);
+    else {
+      io.mkdir(path12.dirname(real));
+      io.writeFile(real, content);
+    }
+  };
+  const changed = files.filter((f) => hashOf(f.real) !== f.postHash).map((f) => f.path);
+  if (changed.length > 0) return { status: "changed", paths: changed };
+  for (const f of files) put(f.real, f.pre);
+  const putBack = () => {
+    const kept2 = files.filter((f) => hashOf(f.real) !== f.preHash).map((f) => f.path);
+    for (const f of files) if (!kept2.includes(f.path)) put(f.real, f.post);
+    return kept2;
+  };
+  let value;
+  try {
+    value = await opts.work();
+  } catch (err) {
+    putBack();
+    throw err;
+  }
+  const kept = putBack();
+  return kept.length > 0 ? { status: "kept-edit", value, paths: kept } : { status: "done", value };
+}
 
 // ../agent-core/src/tools/file-host.ts
 import { readdirSync as readdirSync3, readFileSync as readFileSync5, statSync as statSync4 } from "fs";
-import path12 from "path";
+import path13 from "path";
 var SKIPPED_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -22022,7 +22144,7 @@ var SKIPPED_DIRS = /* @__PURE__ */ new Set([
 ]);
 var MAX_HOST_FILE_BYTES = 1e6;
 var MAX_LISTED = 2e4;
-var toPosix2 = (p) => p.split(path12.sep).join("/");
+var toPosix2 = (p) => p.split(path13.sep).join("/");
 function localFileHost(projectRoot) {
   return {
     async read(relativePath) {
@@ -22050,12 +22172,12 @@ function localFileHost(projectRoot) {
         if (out.length >= MAX_LISTED) return;
         let entries;
         try {
-          entries = readdirSync3(path12.join(projectRoot, dir), { withFileTypes: true });
+          entries = readdirSync3(path13.join(projectRoot, dir), { withFileTypes: true });
         } catch {
           return;
         }
         for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-          const rel = toPosix2(path12.join(dir, e.name));
+          const rel = toPosix2(path13.join(dir, e.name));
           if (e.isDirectory()) {
             if (!SKIPPED_DIRS.has(e.name) && !isSensitivePath(rel)) walk(rel);
           } else if (e.isFile() && !isSensitivePath(rel)) {
@@ -22071,7 +22193,7 @@ function localFileHost(projectRoot) {
 }
 
 // ../agent-core/src/tools/integrations.ts
-import path13 from "path";
+import path14 from "path";
 var CODE = /\.(tsx?|jsx?|mjs|cjs)$/;
 var ENV_TEMPLATE = /^\.env\.(example|sample|template)$/;
 var ENV_IN_CODE = /process\.env\.([A-Z][A-Z0-9_]*)|process\.env\[\s*["']([A-Z][A-Z0-9_]*)["']\s*\]|import\.meta\.env\.([A-Z][A-Z0-9_]*)/g;
@@ -22094,7 +22216,7 @@ async function projectSignals(read, paths) {
     for (const m of text.matchAll(ENV_IN_CODE)) env.add(m[1] ?? m[2] ?? m[3]);
     for (const m of text.matchAll(IMPORT)) imports.add(packageOf(m[1] ?? m[2]));
   }
-  for (const p of paths.filter((p2) => ENV_TEMPLATE.test(path13.posix.basename(p2)))) {
+  for (const p of paths.filter((p2) => ENV_TEMPLATE.test(path14.posix.basename(p2)))) {
     for (const line of (await read(p) ?? "").split("\n")) {
       const name = line.match(/^\s*(?:export\s+)?([A-Z][A-Z0-9_]*)\s*=/)?.[1];
       if (name) env.add(name);
@@ -22154,27 +22276,27 @@ var StagedFiles = class {
   /** Paths written by the package manager (I7), not by the model: the write rules don't apply. */
   fromPackageManager = /* @__PURE__ */ new Set();
   /** Current content as the agent sees it: staged if written, else the project's. */
-  async read(path21) {
-    const s = this.staged.get(path21);
+  async read(path22) {
+    const s = this.staged.get(path22);
     if (s) return s.content;
-    const content = await this.host.read(path21);
-    if (!this.seen.has(path21)) this.seen.set(path21, content === null ? null : hashContent(content));
+    const content = await this.host.read(path22);
+    if (!this.seen.has(path22)) this.seen.set(path22, content === null ? null : hashContent(content));
     return content;
   }
   /** Like `read`, without recording a snapshot: for searching, which only looks. */
-  async peek(path21) {
-    const s = this.staged.get(path21);
-    return s ? s.content : this.host.read(path21);
+  async peek(path22) {
+    const s = this.staged.get(path22);
+    return s ? s.content : this.host.read(path22);
   }
   /** Writes `content` (or deletes, with null) in the staging layer. */
-  async write(path21, content) {
-    const existing = this.staged.get(path21);
+  async write(path22, content) {
+    const existing = this.staged.get(path22);
     if (existing) {
       existing.content = content;
       return;
     }
-    const before = await this.read(path21);
-    this.staged.set(path21, {
+    const before = await this.read(path22);
+    this.staged.set(path22, {
       content,
       existed: before !== null,
       baseHash: before === null ? null : hashContent(before)
@@ -22185,9 +22307,9 @@ var StagedFiles = class {
    * a supported SDK). The patch engine applies it with the rest, so it lands, is checked and is
    * reverted together; the write rules that keep the model out of these files don't apply.
    */
-  async writeFromPackageManager(path21, content) {
-    await this.write(path21, content);
-    this.fromPackageManager.add(path21);
+  async writeFromPackageManager(path22, content) {
+    await this.write(path22, content);
+    this.fromPackageManager.add(path22);
   }
   /** The paths the package manager wrote. */
   packageManagerPaths() {
@@ -22205,18 +22327,18 @@ var StagedFiles = class {
   /** What the apply phase changed, net: a file created then deleted is no change at all. */
   changes() {
     const out = [];
-    for (const [path21, s] of [...this.staged].sort(([a], [b]) => a.localeCompare(b))) {
+    for (const [path22, s] of [...this.staged].sort(([a], [b]) => a.localeCompare(b))) {
       if (!s.existed && s.content === null) continue;
-      if (!s.existed) out.push({ path: path21, kind: "create", content: s.content });
-      else if (s.content === null) out.push({ path: path21, kind: "delete", baseHash: s.baseHash });
+      if (!s.existed) out.push({ path: path22, kind: "create", content: s.content });
+      else if (s.content === null) out.push({ path: path22, kind: "delete", baseHash: s.baseHash });
       else if (hashContent(s.content) !== s.baseHash)
-        out.push({ path: path21, kind: "modify", content: s.content, baseHash: s.baseHash });
+        out.push({ path: path22, kind: "modify", content: s.content, baseHash: s.baseHash });
     }
     return out;
   }
   /** Every file the agent read or wrote, with its hash when first seen (null: didn't exist). */
   snapshots() {
-    return [...this.seen].map(([path21, hash2]) => ({ path: path21, hash: hash2 })).sort((a, b) => a.path.localeCompare(b.path));
+    return [...this.seen].map(([path22, hash2]) => ({ path: path22, hash: hash2 })).sort((a, b) => a.path.localeCompare(b.path));
   }
 };
 
@@ -22253,7 +22375,7 @@ var ok = (callId, output2) => ({
   output: output2,
   isError: false
 });
-var secretFile = (path21) => `Can't change ${path21}: it looks like it contains a secret. Leave it, and name it in notDone so the developer moves the secret to an environment variable.`;
+var secretFile = (path22) => `Can't change ${path22}: it looks like it contains a secret. Leave it, and name it in notDone so the developer moves the secret to an environment variable.`;
 var fail = (callId, output2) => ({
   callId,
   output: output2,
@@ -22296,12 +22418,12 @@ function createToolRuntime(opts) {
       const found = [];
       let withheld = 0;
       let stopped = false;
-      for (const path21 of await visible(input2.path, input2.glob)) {
+      for (const path22 of await visible(input2.path, input2.glob)) {
         if (found.length >= max || Date.now() - started > budget) {
           stopped = true;
           break;
         }
-        const content = await staging.peek(path21);
+        const content = await staging.peek(path22);
         if (content === null) continue;
         if (containsSecret(content)) {
           withheld++;
@@ -22313,7 +22435,7 @@ function createToolRuntime(opts) {
           if (line.length > MAX_SEARCH_LINE || !matches(line)) continue;
           const text = line.trim();
           found.push(
-            `${path21}:${i + 1}: ${text.length > MAX_LINE ? `${text.slice(0, MAX_LINE)}\u2026` : text}`
+            `${path22}:${i + 1}: ${text.length > MAX_LINE ? `${text.slice(0, MAX_LINE)}\u2026` : text}`
           );
         }
       }
@@ -22521,11 +22643,13 @@ function createChangeRunner(opts) {
   function run(session, work) {
     if (session.busy) throw new Busy("Revyse is still working on this change");
     session.busy = true;
-    session.abort = new AbortController();
-    const signal = session.abort.signal;
+    const controller = new AbortController();
+    session.abort = controller;
+    const signal = controller.signal;
     void work(signal).catch((err) => {
       if (!signal.aborted) report(session.id, err);
     }).finally(() => {
+      if (session.abort !== controller) return;
       session.busy = false;
       session.abort = void 0;
     });
@@ -22553,9 +22677,9 @@ function createChangeRunner(opts) {
     const stored = [];
     for (const key of localKeys) {
       try {
-        const bytes2 = readFileSync6(path14.join(opts.projectRoot, key));
+        const bytes2 = readFileSync6(path15.join(opts.projectRoot, key));
         const { artifact, upload } = await opts.api.post(`/api/changes/${changeId}/artifacts`, {
-          name: path14.basename(key),
+          name: path15.basename(key),
           contentType: "image/png",
           size: bytes2.length
         });
@@ -22600,7 +22724,7 @@ function createChangeRunner(opts) {
     const before = await driver.capture({
       url: url2,
       selector: session.element.selector,
-      sourceFile: session.element.source?.file,
+      source: session.element.source,
       timeoutMs: 3e4
     }).catch((err) => {
       log(`browser check: before-capture failed: ${err.message}`);
@@ -22633,7 +22757,7 @@ function createChangeRunner(opts) {
       `/api/changes/${session.id}/plan`,
       {
         element: session.element,
-        files: gathered.files.map(({ path: path21, content, hash: hash2 }) => ({ path: path21, content, hash: hash2 })),
+        files: gathered.files.map(({ path: path22, content, hash: hash2 }) => ({ path: path22, content, hash: hash2 })),
         modelTier: session.tier,
         model: session.model,
         ...extra
@@ -22645,16 +22769,24 @@ function createChangeRunner(opts) {
       const {
         plan: result,
         model,
-        cost
+        cost,
+        fellBackFrom
       } = ev.data;
-      onPlan(session, result, model, cost);
+      onPlan(session, result, model, cost, void 0, fellBackFrom);
     }
   }
-  function onPlan(session, result, model, cost, connectPath) {
+  function onPlan(session, result, model, cost, connectPath, fellBackFrom) {
     session.plan = result;
     if (cost !== void 0) session.cost = cost;
     if (result.decision === "proceed")
-      opts.emit({ type: "plan", changeId: session.id, plan: result, model, cost: session.cost });
+      opts.emit({
+        type: "plan",
+        changeId: session.id,
+        plan: result,
+        model,
+        ...fellBackFrom?.length ? { fellBackFrom } : {},
+        cost: session.cost
+      });
     else if (result.decision === "clarify")
       opts.emit({
         type: "clarification",
@@ -22684,19 +22816,23 @@ function createChangeRunner(opts) {
   }
   async function apply(session, signal) {
     const browser = prepareBrowser(session);
-    const baseline = hasLocalChecks() ? runChecks(session.contextPaths).catch((err) => {
-      log(`baseline checks failed to run: ${err.message}`);
-      return [];
-    }) : Promise.resolve([]);
     try {
-      await applyWithBrowser(session, signal, browser, baseline);
+      await applyWithBrowser(session, signal, browser);
     } finally {
       void browser.then((b) => b.driver?.close()).catch(() => {
       });
     }
   }
-  const hasLocalChecks = () => ["typecheck", "lint", "test"].some((k) => opts.config.scripts[k]);
-  async function applyWithBrowser(session, signal, browserPrep, baselinePrep) {
+  async function beforePage(prep) {
+    const late = /* @__PURE__ */ Symbol("late");
+    const ready = await Promise.race([
+      prep,
+      new Promise((r) => setTimeout(() => r(late), opts.beforeWaitMs ?? 3e3))
+    ]);
+    if (ready !== late) return ready;
+    return { before: null, reason: "The page took too long to load before the change." };
+  }
+  async function applyWithBrowser(session, signal, browserPrep) {
     const { files, missing } = readFiles(session.contextPaths);
     const stale = [
       ...missing,
@@ -22713,10 +22849,16 @@ function createChangeRunner(opts) {
       return conflict(session.id, "changed_since_plan", stale);
     }
     session.stage = "patching";
+    const planned = new Set(session.plan?.steps.flatMap((s) => s.files) ?? []);
+    const toPatch = planned.size > 0 ? files.filter((f) => planned.has(f.path)) : files;
     let patch;
-    for await (const ev of opts.api.stream(`/api/changes/${session.id}/patch`, { files }, signal)) {
+    for await (const ev of opts.api.stream(
+      `/api/changes/${session.id}/patch`,
+      { files: toPatch },
+      signal
+    )) {
       if (ev.event === "progress" && ev.data.stage === "patching")
-        opts.emit({ type: "applying", changeId: session.id, files: files.length });
+        opts.emit({ type: "applying", changeId: session.id, files: toPatch.length });
       if (ev.event === "error") return emitStreamError(session, ev.data);
       if (ev.event === "result") {
         const data = ev.data;
@@ -22725,13 +22867,13 @@ function createChangeRunner(opts) {
       }
     }
     if (!patch) return;
-    const [browser, baseline] = await Promise.all([browserPrep, baselinePrep]);
+    const browser = await beforePage(browserPrep);
     session.stage = "applying";
-    const snapshots = files.map(({ path: path21, hash: hash2 }) => ({ path: path21, hash: hash2 }));
+    const snapshots = files.map(({ path: path22, hash: hash2 }) => ({ path: path22, hash: hash2 }));
     const applied = applyPatch({
       projectRoot: opts.projectRoot,
       changeId: session.id,
-      patch: { files: patch.files.map(({ path: path21, edits }) => ({ path: path21, edits })) },
+      patch: { files: patch.files.map(({ path: path22, edits }) => ({ path: path22, edits })) },
       snapshots
     });
     if (applied.status === "conflict") {
@@ -22754,23 +22896,56 @@ function createChangeRunner(opts) {
     }
     session.applied = true;
     const explanations = new Map(patch.files.map((f) => [f.path, f.explanation]));
-    await checkAndReport(session, applied, browser, baseline, { explanations });
+    await checkAndReport(session, applied, browser, signal, { explanations });
   }
-  async function checkAndReport(session, applied, browser, baseline, extras = {}) {
+  async function checkAndReport(session, applied, browser, signal, extras = {}) {
     session.stage = "checking";
-    const configured = [
-      ...["typecheck", "lint", "test", "build"].filter((k) => opts.config.scripts[k]),
-      ...browser.driver ? ["browser"] : []
-    ];
-    opts.emit({
-      type: "checking",
-      changeId: session.id,
-      checks: configured.map((kind) => ({ kind, status: "running" }))
-    });
+    const ALL = ["typecheck", "lint", "test", "build"];
+    const kinds = ALL.filter((k) => opts.config.scripts[k]);
+    const files = applied.files.map((f) => ({
+      path: f.path,
+      additions: f.additions,
+      deletions: f.deletions,
+      explanation: extras.explanations?.get(f.path),
+      ...f.kind ? { kind: f.kind } : {}
+    }));
+    const progress = new Map([
+      ...kinds.map((k) => [k, { status: "running" }]),
+      ...browser.driver ? [["browser", { status: "running" }]] : []
+    ]);
+    const report2 = () => {
+      if (signal.aborted) return;
+      opts.emit({
+        type: "checking",
+        changeId: session.id,
+        checks: [...progress].map(([kind, p]) => ({
+          kind,
+          status: p.status,
+          ...p.ms !== void 0 ? { durationMs: p.ms } : {}
+        })),
+        files,
+        diff: applied.diff
+      });
+    };
+    const finished = (c) => {
+      progress.set(c.kind, { status: c.status, ms: c.durationMs });
+      report2();
+      return c;
+    };
+    report2();
     const changed = applied.files.filter((f) => f.kind !== "delete").map((f) => f.path);
     const startedBrowser = performance.now();
     const [local, browserRaw] = await Promise.all([
-      runChecks(changed),
+      Promise.all(
+        ALL.map(async (kind) => {
+          const [r] = await runChecks(changed, [kind]);
+          if (!r) {
+            if (progress.delete(kind)) report2();
+            return null;
+          }
+          return progress.has(kind) ? finished(r) : r;
+        })
+      ).then((results) => results.filter((r) => r !== null)),
       browser.driver && browser.url ? runBrowserCheck({
         projectRoot: opts.projectRoot,
         changeId: session.id,
@@ -22782,26 +22957,45 @@ function createChangeRunner(opts) {
           return browser.driver.capture({
             url: browser.url,
             selector: session.element.selector,
-            sourceFile: session.element.source?.file,
+            source: session.element.source,
             timeoutMs: 6e4
           });
         },
         durationMs: () => performance.now() - startedBrowser
-      }) : Promise.resolve(browserNotRun(browser.reason ?? "The browser check didn't run."))
+      }).then((r) => finished(redactCheck(r))) : Promise.resolve(browserNotRun(browser.reason ?? "The browser check didn't run."))
     ]);
-    const browserResult = redactCheck(browserRaw);
+    if (signal.aborted) return;
+    const browserResult = browserRaw;
     const localKeys = browserResult.evidence?.artifactKeys ?? [];
     if (localKeys.length > 0) {
       const stored = await uploadArtifacts(session.id, localKeys);
       browserResult.evidence.artifactKeys = [...localKeys, ...stored];
     }
-    const checks = [
-      ...compareWithBaseline(
-        local.filter((c) => c.kind !== "browser"),
-        baseline
-      ),
-      browserResult
-    ];
+    const failed = local.filter((c) => c.status === "failed").map((c) => c.kind);
+    let baseline = [];
+    if (failed.length > 0) {
+      const before = await withOriginals({
+        projectRoot: opts.projectRoot,
+        changeId: session.id,
+        work: () => runChecks(changed, failed)
+      }).catch((err) => {
+        log(`couldn't re-run the failed checks on the original files: ${err.message}`);
+        return null;
+      });
+      if (signal.aborted) return;
+      if (before?.status === "kept-edit") {
+        await transition(
+          session.id,
+          "failed",
+          `Files changed while Revyse was checking: ${before.paths.join(", ")}`,
+          "conflict"
+        ).catch(() => {
+        });
+        return conflict(session.id, "changed_while_applying", before.paths);
+      }
+      if (before?.status === "done") baseline = before.value;
+    }
+    const checks = [...compareWithBaseline(local, baseline), browserResult];
     session.stage = "reporting";
     const { change } = await opts.api.post(
       `/api/changes/${session.id}/result`,
@@ -22823,13 +23017,7 @@ function createChangeRunner(opts) {
       type: "result",
       changeId: session.id,
       state: change.state,
-      files: applied.files.map((f) => ({
-        path: f.path,
-        additions: f.additions,
-        deletions: f.deletions,
-        explanation: extras.explanations?.get(f.path),
-        ...f.kind ? { kind: f.kind } : {}
-      })),
+      files,
       diff: applied.diff,
       checks,
       cost: session.cost,
@@ -22955,21 +23143,19 @@ function createChangeRunner(opts) {
     const planned = new Set(session.plan?.steps.flatMap((s) => s.files) ?? []);
     opts.emit({ type: "applying", changeId: session.id, files: planned.size });
     const browserPrep = prepareBrowser(session);
-    const baselinePrep = hasLocalChecks() ? runChecks([]).catch((err) => {
-      log(`baseline checks failed to run: ${err.message}`);
-      return [];
-    }) : Promise.resolve([]);
     try {
-      await agentApplyWith(session, signal, browserPrep, baselinePrep);
+      await agentApplyWith(session, signal, browserPrep);
     } finally {
       void browserPrep.then((b) => b.driver?.close()).catch(() => {
       });
     }
   }
-  async function agentApplyWith(session, signal, browserPrep, baselinePrep) {
+  async function agentApplyWith(session, signal, browserPrep) {
+    let ready;
+    const browserReady = () => ready ??= beforePage(browserPrep);
     const stop = {};
     const flush = async () => {
-      await Promise.all([browserPrep, baselinePrep]);
+      await browserReady();
       if (session.applied) {
         const undone = revertChange({ projectRoot: opts.projectRoot, changeId: session.id });
         if (undone.status === "conflict")
@@ -23033,21 +23219,20 @@ ${detail}` : "."}`,
       });
     }
     if (final.status !== "applied") return landingFailed(session, final);
-    const [browser, baseline] = await Promise.all([browserPrep, baselinePrep]);
-    await checkAndReport(session, final, browser, baseline, { summary: done.summary });
+    await checkAndReport(session, final, await browserReady(), signal, { summary: done.summary });
   }
   async function addDependency(rt, pkg, version2) {
     const pm = opts.config.packageManager;
     const files = ["package.json", LOCKFILE[pm]];
     const disk = (rel) => {
       try {
-        return readFileSync6(path14.join(opts.projectRoot, rel), "utf8");
+        return readFileSync6(path15.join(opts.projectRoot, rel), "utf8");
       } catch {
         return null;
       }
     };
     const put = (rel, content) => {
-      const file2 = path14.join(opts.projectRoot, rel);
+      const file2 = path15.join(opts.projectRoot, rel);
       if (content === null) rmSync2(file2, { force: true });
       else writeFileSync3(file2, content);
     };
@@ -23259,6 +23444,11 @@ ${r.output.slice(-3e3)}`,
     },
     revert(changeId) {
       const s = sessionOf(changeId);
+      if (s.busy && s.stage === "checking") {
+        s.abort?.abort();
+        s.abort = void 0;
+        s.busy = false;
+      }
       run(s, async () => {
         s.stage = "reverting";
         const files = restore(s);
@@ -23310,32 +23500,32 @@ ${r.output.slice(-3e3)}`,
 }
 
 // src/credentials.ts
-import { chmodSync, existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "fs";
+import { chmodSync, existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "fs";
 import { homedir } from "os";
-import path15 from "path";
+import path16 from "path";
 function credentialsPath(env = process.env) {
-  const base = env.XDG_CONFIG_HOME || path15.join(homedir(), ".config");
-  return path15.join(base, "revyse", "credentials.json");
+  const base = env.XDG_CONFIG_HOME || path16.join(homedir(), ".config");
+  return path16.join(base, "revyse", "credentials.json");
 }
 function readAll(file2) {
-  if (!existsSync4(file2)) return {};
+  if (!existsSync5(file2)) return {};
   return JSON.parse(readFileSync7(file2, "utf8"));
 }
 function writeAll(file2, data) {
-  mkdirSync3(path15.dirname(file2), { recursive: true, mode: 448 });
+  mkdirSync3(path16.dirname(file2), { recursive: true, mode: 448 });
   writeFileSync4(file2, `${JSON.stringify(data, null, 2)}
 `, { mode: 384 });
   chmodSync(file2, 384);
 }
 function loadCredential(projectRoot, file2 = credentialsPath()) {
-  return readAll(file2)[path15.resolve(projectRoot)] ?? null;
+  return readAll(file2)[path16.resolve(projectRoot)] ?? null;
 }
 function saveCredential(projectRoot, cred, file2 = credentialsPath()) {
-  writeAll(file2, { ...readAll(file2), [path15.resolve(projectRoot)]: cred });
+  writeAll(file2, { ...readAll(file2), [path16.resolve(projectRoot)]: cred });
 }
 function deleteCredential(projectRoot, file2 = credentialsPath()) {
   const all = readAll(file2);
-  delete all[path15.resolve(projectRoot)];
+  delete all[path16.resolve(projectRoot)];
   writeAll(file2, all);
 }
 
@@ -23374,13 +23564,13 @@ Full policy: ${DATA_HANDLING_URL}
 `;
 
 // src/init-flow.ts
-import { existsSync as existsSync7, readFileSync as readFileSync10, writeFileSync as writeFileSync5 } from "fs";
-import path18 from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync10, writeFileSync as writeFileSync5 } from "fs";
+import path19 from "path";
 import { createTwoFilesPatch as createTwoFilesPatch4 } from "diff";
 
 // src/detect.ts
-import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
-import path16 from "path";
+import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
+import path17 from "path";
 var LOCKFILES2 = [
   ["pnpm-lock.yaml", "pnpm"],
   ["yarn.lock", "yarn"],
@@ -23390,8 +23580,8 @@ var LOCKFILES2 = [
 ];
 var SOURCE_DIR_CANDIDATES = ["src", "app", "pages", "components", "lib"];
 function detectProject(root) {
-  const pkgPath = path16.join(root, "package.json");
-  if (!existsSync5(pkgPath)) {
+  const pkgPath = path17.join(root, "package.json");
+  if (!existsSync6(pkgPath)) {
     throw new Error(`No package.json found in ${root}. Run revyse init from your project root.`);
   }
   const pkg = JSON.parse(readFileSync8(pkgPath, "utf8"));
@@ -23403,13 +23593,13 @@ function detectProject(root) {
   } else if (framework !== "nextjs") {
     warnings.push(`${framework} support is experimental; Next.js is the supported target.`);
   }
-  const managers = LOCKFILES2.filter(([file2]) => existsSync5(path16.join(root, file2)));
+  const managers = LOCKFILES2.filter(([file2]) => existsSync6(path17.join(root, file2)));
   const packageManager = managers[0]?.[1] ?? "npm";
   if (managers.length === 0) warnings.push("No lockfile found; defaulting to npm.");
   if (new Set(managers.map(([, m]) => m)).size > 1) {
     warnings.push(`Multiple lockfiles found; using ${packageManager}.`);
   }
-  const sourceDirs = SOURCE_DIR_CANDIDATES.filter((d) => existsSync5(path16.join(root, d)));
+  const sourceDirs = SOURCE_DIR_CANDIDATES.filter((d) => existsSync6(path17.join(root, d)));
   for (const d of aliasedDirs(root)) if (!sourceDirs.includes(d)) sourceDirs.push(d);
   if (sourceDirs.length === 0) {
     warnings.push("No source directories found; edit sourceDirs in revyse.config.json.");
@@ -23427,14 +23617,16 @@ function detectProject(root) {
         dev: pick2("dev"),
         typecheck: pick2("typecheck", "type-check", "tsc"),
         lint: pick2("lint"),
-        test: pick2("test"),
+        // Tests are opt-in (L19, ADR 0042): a suite can take minutes, and a local change should
+        // take seconds. The build stays: it only ever runs in cloud workspaces.
         build: pick2("build")
       },
       exclude: [],
       agentPort: 4545,
       appOrigins: devOrigins(scripts.dev)
     },
-    warnings
+    warnings,
+    optional: { test: pick2("test") }
   };
 }
 function detectFramework(deps) {
@@ -23482,13 +23674,13 @@ function hasSource(dir, depth = 3) {
   for (const entry of readdirSync4(dir, { withFileTypes: true })) {
     if (entry.isFile() && SOURCE_FILE.test(entry.name)) return true;
     if (entry.isDirectory() && depth > 1 && !NOT_SOURCE.has(entry.name)) {
-      if (hasSource(path16.join(dir, entry.name), depth - 1)) return true;
+      if (hasSource(path17.join(dir, entry.name), depth - 1)) return true;
     }
   }
   return false;
 }
 function aliasedDirs(root) {
-  const file2 = ["tsconfig.json", "jsconfig.json"].map((f) => path16.join(root, f)).find((f) => existsSync5(f));
+  const file2 = ["tsconfig.json", "jsconfig.json"].map((f) => path17.join(root, f)).find((f) => existsSync6(f));
   if (!file2) return [];
   let compilerOptions;
   try {
@@ -23500,15 +23692,15 @@ function aliasedDirs(root) {
   const baseUrl = compilerOptions?.baseUrl ?? ".";
   const dirs = /* @__PURE__ */ new Set();
   for (const target of Object.values(paths).flat()) {
-    const rel = path16.relative(root, path16.join(root, baseUrl, target)).split(path16.sep).join("/");
+    const rel = path17.relative(root, path17.join(root, baseUrl, target)).split(path17.sep).join("/");
     const top = rel.split("/")[0];
     if (rel.startsWith("..") || NOT_SOURCE.has(top)) continue;
     if (top === "*" || top === "") {
       for (const entry of readdirSync4(root, { withFileTypes: true }))
         if (entry.isDirectory() && !NOT_SOURCE.has(entry.name) && !entry.name.startsWith(".")) {
-          if (hasSource(path16.join(root, entry.name))) dirs.add(entry.name);
+          if (hasSource(path17.join(root, entry.name))) dirs.add(entry.name);
         }
-    } else if (existsSync5(path16.join(root, top)) && statSync5(path16.join(root, top)).isDirectory()) {
+    } else if (existsSync6(path17.join(root, top)) && statSync5(path17.join(root, top)).isDirectory()) {
       dirs.add(top);
     }
   }
@@ -23516,8 +23708,8 @@ function aliasedDirs(root) {
 }
 
 // src/next-config.ts
-import { existsSync as existsSync6, readFileSync as readFileSync9 } from "fs";
-import path17 from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync9 } from "fs";
+import path18 from "path";
 import { parse as parse3 } from "@babel/parser";
 import MagicString from "magic-string";
 var NEXT_CONFIG_FILES = [
@@ -23528,7 +23720,7 @@ var NEXT_CONFIG_FILES = [
 ];
 function findNextConfig(root) {
   for (const name of NEXT_CONFIG_FILES) {
-    if (existsSync6(path17.join(root, name))) return name;
+    if (existsSync7(path18.join(root, name))) return name;
   }
   return null;
 }
@@ -23583,7 +23775,7 @@ ${importLine}`);
   return { status: "unsupported", reason: "it has no `export default` or `module.exports`" };
 }
 function readNextConfig(root, file2) {
-  return readFileSync9(path17.join(root, file2), "utf8");
+  return readFileSync9(path18.join(root, file2), "utf8");
 }
 
 // src/version.ts
@@ -23610,9 +23802,9 @@ async function runInit(opts, io) {
   const ask = (q) => opts.yes ? Promise.resolve(true) : io.confirm(q);
   let configured;
   let status;
-  if (existsSync7(path18.join(root, CONFIG_FILE)) && !opts.force) {
+  if (existsSync8(path19.join(root, CONFIG_FILE)) && !opts.force) {
     const config3 = projectConfigSchema.parse(
-      JSON.parse(readFileSync10(path18.join(root, CONFIG_FILE), "utf8"))
+      JSON.parse(readFileSync10(path19.join(root, CONFIG_FILE), "utf8"))
     );
     io.log(`${CONFIG_FILE} is already here; checking the rest of the setup.`);
     if (!config3.dataDisclosure || config3.dataDisclosure.version < DISCLOSURE_VERSION)
@@ -23649,7 +23841,7 @@ Next: ${steps.join(", then ")}. Then start your app as usual.`
 async function configure(opts, io, ask) {
   const { root } = opts;
   const now = opts.now ?? (() => /* @__PURE__ */ new Date());
-  const { config: config2, warnings } = detectProject(root);
+  const { config: config2, warnings, optional: optional2 } = detectProject(root);
   io.log(`Detected ${config2.framework} (${config2.packageManager})`);
   io.log(`Source directories: ${config2.sourceDirs.join(", ")}`);
   for (const w of warnings) io.warn(`warning: ${w}`);
@@ -23693,27 +23885,68 @@ Revyse needs this change to ${file2} (it only has an effect in \`next dev\`):
       }
     }
   }
-  writeFileSync5(path18.join(root, CONFIG_FILE), `${JSON.stringify(accepted, null, 2)}
+  writeFileSync5(path19.join(root, CONFIG_FILE), `${JSON.stringify(accepted, null, 2)}
 `);
-  if (nextConfigEdit) writeFileSync5(path18.join(root, nextConfigEdit.file), nextConfigEdit.code);
+  if (nextConfigEdit) writeFileSync5(path19.join(root, nextConfigEdit.file), nextConfigEdit.code);
   if (ensureGitignored(root))
     io.log(`Added ${GITIGNORE_ENTRY} to .gitignore (local change history).`);
   io.log(`
 Wrote ${CONFIG_FILE}.`);
+  const checks = [
+    ...config2.scripts.typecheck ? ["typecheck"] : [],
+    ...config2.scripts.lint ? ["lint"] : [],
+    ...config2.framework === "nextjs" ? ["the page in a browser"] : []
+  ];
+  if (checks.length > 0)
+    io.log(
+      `After each change, Revyse checks ${checks.join(", ").replace(/, ([^,]*)$/, " and $1")}.`
+    );
+  if (optional2.test)
+    io.log(
+      `Your tests (\`${optional2.test}\`) don't run on each change, so changes stay fast. To run them too, add "test": "${optional2.test}" to scripts in ${CONFIG_FILE}.`
+    );
   return { config: accepted, nextConfigEdited: Boolean(nextConfigEdit) };
 }
+function olderThan(a, b) {
+  const parse4 = (v) => /^(\d+)\.(\d+)\.(\d+)/.exec(v)?.slice(1).map(Number);
+  const [x, y] = [parse4(a), parse4(b)];
+  if (!x || !y) return false;
+  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i];
+  return false;
+}
+function installedVersion(root, name) {
+  try {
+    const pkg = JSON.parse(
+      readFileSync10(path19.join(root, "node_modules", name, "package.json"), "utf8")
+    );
+    return pkg.version ?? null;
+  } catch {
+    return null;
+  }
+}
 async function installPackages(root, config2, setup, io, ask) {
-  const missing = PACKAGES.filter((name) => !devDependencies(root)[name]);
-  if (missing.length === 0) return true;
-  const specs = missing.map((name) => `${name}@${VERSION}`);
+  const listed2 = devDependencies(root);
+  const todo = PACKAGES.flatMap((name) => {
+    const installed = installedVersion(root, name);
+    if (!listed2[name] || !installed) return [{ name, from: null }];
+    return olderThan(installed, VERSION) ? [{ name, from: installed }] : [];
+  });
+  if (todo.length === 0) return true;
+  const specs = todo.map(({ name }) => `${name}@${VERSION}`);
   const command = installCommand(config2.packageManager, specs).join(" ");
-  if (!await ask(`Install ${missing.join(" and ")} as dev dependencies (${command})?`)) {
-    io.log(`Skipped. Install them yourself: ${command}`);
+  const installs = todo.filter((t) => !t.from).map((t) => t.name);
+  const updates = todo.filter((t) => t.from).map((t) => `${t.name} from ${t.from} to ${VERSION}`);
+  const what = [
+    ...installs.length ? [`install ${installs.join(" and ")} as dev dependencies`] : [],
+    ...updates.length ? [`update ${updates.join(" and ")}`] : []
+  ].join(", and ");
+  if (!await ask(`${what[0].toUpperCase()}${what.slice(1)} (${command})?`)) {
+    io.log(`Skipped. Run it yourself: ${command}`);
     return false;
   }
   try {
     await setup.install(root, config2.packageManager, specs);
-    io.log(`Installed ${missing.join(" and ")}.`);
+    io.log(`Revyse's packages are at ${VERSION}.`);
     return true;
   } catch (err) {
     io.warn(`Couldn't install them (${err.message}). Run: ${command}`);
@@ -23745,11 +23978,11 @@ async function connectProject(root, config2, setup, io, ask) {
 }
 function projectName(root) {
   const name = readPackageJson(root)?.name?.replace(/^@[^/]+\//, "").trim();
-  return (name || path18.basename(root)).slice(0, 100);
+  return (name || path19.basename(root)).slice(0, 100);
 }
 function ensureGitignored(root) {
-  const file2 = path18.join(root, ".gitignore");
-  const current = existsSync7(file2) ? readFileSync10(file2, "utf8") : "";
+  const file2 = path19.join(root, ".gitignore");
+  const current = existsSync8(file2) ? readFileSync10(file2, "utf8") : "";
   const lines = current.split(/\r?\n/).map((l) => l.trim());
   if (lines.includes(GITIGNORE_ENTRY) || lines.includes(".revyse")) return false;
   const separator = current === "" ? "" : current.endsWith("\n") ? "\n" : "\n\n";
@@ -23760,7 +23993,7 @@ ${GITIGNORE_ENTRY}
 }
 function readPackageJson(root) {
   try {
-    return JSON.parse(readFileSync10(path18.join(root, "package.json"), "utf8"));
+    return JSON.parse(readFileSync10(path19.join(root, "package.json"), "utf8"));
   } catch {
     return null;
   }
@@ -23805,7 +24038,7 @@ function createRequestHandler(currentRunner) {
 import { randomBytes, timingSafeEqual } from "crypto";
 import { readFileSync as readFileSync11 } from "fs";
 import { createServer } from "http";
-import path19 from "path";
+import path20 from "path";
 import { WebSocketServer } from "ws";
 var ARTIFACT_PATH = /^\/artifacts\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\/(before|after)\.png$/;
 var safeEqual = (a, b) => {
@@ -23857,7 +24090,7 @@ ${opts.overlayBundle()}`
         res.writeHead(403).end();
         return;
       }
-      const file2 = path19.join(
+      const file2 = path20.join(
         opts.project.root,
         ".revyse",
         "changes",
@@ -23984,7 +24217,7 @@ ${opts.overlayBundle()}`
 
 // src/agent/local-agent.ts
 function loadConfig(file2) {
-  if (!existsSync8(file2)) throw new Error(`No ${CONFIG_FILE} found. Run \`revyse init\` first.`);
+  if (!existsSync9(file2)) throw new Error(`No ${CONFIG_FILE} found. Run \`revyse init\` first.`);
   const config2 = projectConfigSchema.parse(JSON.parse(readFileSync12(file2, "utf8")));
   if (!config2.dataDisclosure || config2.dataDisclosure.version < DISCLOSURE_VERSION) {
     throw new Error("Review and accept the data disclosure first: run `revyse init --force`.");
@@ -23992,7 +24225,7 @@ function loadConfig(file2) {
   return config2;
 }
 function readOverlayBundle() {
-  const file2 = path20.join(path20.dirname(fileURLToPath(import.meta.url)), "overlay.js");
+  const file2 = path21.join(path21.dirname(fileURLToPath(import.meta.url)), "overlay.js");
   return readFileSync12(file2, "utf8");
 }
 async function identifyAgent(port) {
@@ -24009,7 +24242,7 @@ async function identifyAgent(port) {
 }
 async function startLocalAgent(opts) {
   const { root, log } = opts;
-  const configFile = path20.join(root, CONFIG_FILE);
+  const configFile = path21.join(root, CONFIG_FILE);
   let config2 = loadConfig(configFile);
   const port = opts.port ?? config2.agentPort;
   const sink = {};