@happy-nut/monacori 0.1.2 → 0.1.5

package/README.md

@@ -1,30 +1,10 @@
 # monacori
 
-Validation control plane for AI-generated code changes.
-
-`monacori` is not an agent orchestrator. It does not manage panes, sessions, worktrees, or model adapters. Its job is narrower: after an AI edits a repository, produce verification evidence that a human can trust.
-
-It gives you:
-
-- detected verification commands in `.monacori/config.json`
-- repeatable verification logs under `.monacori/logs/`
-- a local desktop review app for live diff inspection
-- diff2html review pages under `.monacori/diffs/`
-- searchable source previews, including unchanged indexed files
-- compact validation reports under `.monacori/reports/`
+**A local desktop diff-review app for AI-generated code changes.** After an AI edits your repo, run `mo` to open a side-by-side diff — read it, comment on it, and send your comments straight to an AI CLI running in the built-in terminal.
 
 ## Why
 
-AI coding output is hard to trust when review depends on chat memory or vague "done" claims. `monacori` keeps the review artifacts in the repository so the state can be inspected, rerun, and discussed.
-
-The intended loop is simple:
-
-```text
-AI edits code.
-monacori runs verification.
-monacori creates a reviewable diff artifact.
-You inspect evidence before accepting the change.
-```
+A chat log or a "done" claim is a poor way to review what an AI changed. monacori puts the change in front of you as a real diff you can read and annotate — then turns your comments into a prompt you hand right back to `claude` or `codex`, without leaving the app or copy-pasting between windows.
 
 ## Install
 
@@ -32,146 +12,44 @@ You inspect evidence before accepting the change.
 npm install -g @happy-nut/monacori
 ```
 
-After installation, the short command is:
-
-```bash
-mo
-```
-
-Homebrew tap distribution is prepared through `Formula/monacori.rb`. Once the scoped npm package is published and the formula is copied to the `happy-nut/homebrew-monacori` tap, the intended install path is:
-
-```bash
-brew install happy-nut/monacori/monacori
-```
-
-For local development:
-
-```bash
-git clone https://github.com/happy-nut/monacori.git
-cd monacori
-npm install
-npm run build
-npm link
-```
-
-## Quick Start
+After install, the short command is `mo`. A Homebrew tap (`happy-nut/monacori/monacori`) is also available.
 
-Inside the repository you want to validate:
+## What you get
 
-```bash
-mo
-monacori check --include-untracked
-```
+- **Desktop diff review** — side-by-side diff with changed-line highlighting and an IntelliJ-style sidebar that colors files by git status. Reads the repo directly, refreshes on change, no HTTP server.
+- **Integrated terminal** — run AI CLIs like `claude` or `codex` right inside the app, split into panes.
+- **Comments → session** — annotate any line, then send your comments (bundled with their code context) into a terminal pane as one merged prompt: pick the target pane visually and press Enter.
 
-`mo` opens the local desktop review app for the current directory. On first run it creates `.monacori/`, updates Git ignore rules for `.monacori/`, and includes untracked files so new AI-created files show up immediately.
+## Quick start
 
-`check` runs configured verification commands, writes a log, creates a browser diff review, and records a compact report.
-
-For a one-off command:
-
-```bash
-monacori check -- npm test
-```
-
-For live diff review while an AI is still editing:
+Inside the repository you want to review:
 
 ```bash
 mo
 ```
 
-## Diff Review
-
-The desktop review app is powered by Electron and diff2html. It reads Git diff and source files directly from the local repository, writes a local `.monacori/app-review.html` file, and refreshes when the working tree changes. It does not start an HTTP server.
-
-- `F7`: show the next changed hunk, starting from the current source file when possible
-- `Shift+F7`: previous changed hunk
-- `]` / `[`: fallback keys if the browser captures function keys
-- `Shift Shift`: search indexed files, including unchanged files
-- `Cmd/Ctrl+E`: open recent files
-- `Cmd/Ctrl+Down`: jump from the source cursor to a declaration-like match for the symbol under it
-
-The app opens as a read-only source viewer by default. The `Files` tab opens indexed files even when they are unchanged, and `F7` switches into the diff view when you want to inspect changes. Drag-copying source text adds `path:line-range` plus a fenced code block to the clipboard so the snippet can be pasted into an AI prompt with context. Viewed marks are stored with file signatures, so a file becomes unviewed again when it changes.
-
-The browser artifact path is still available through `monacori diff`. Add `--watch` there only when you specifically want a browser-served live review.
+On first run, `mo` creates `.monacori/`, adds it to `.gitignore`, and includes untracked files so new AI-created files show up immediately.
 
 ## Commands
 
-```bash
-monacori open [--base HEAD] [--staged] [--tracked-only] [--context 12] [--no-watch]
-```
-
-Opens the local desktop review app for the current directory. `mo` and bare `monacori` are aliases for this default flow. It auto-initializes local state when needed and includes untracked files by default; pass `--tracked-only` to inspect tracked changes only.
+| Command | What it does |
+| --- | --- |
+| `mo` | Open the desktop diff-review app (alias for `monacori open`). |
+| `monacori app` | Launch the desktop review app (same as `mo`). |
+| `monacori init` | Initialize `.monacori/` in the current directory. |
+| `monacori install` | Initialize and write agent instruction snippets. `--apply-agent-docs` patches `AGENTS.md` / `CLAUDE.md`. |
 
-```bash
-monacori check [--include-untracked] [--staged] [--base HEAD] [--context 12] [--open] [--no-verify] [--no-diff] [-- <command>]
-```
-
-Runs verification and creates a validation report. By default it uses commands from `.monacori/config.json`; pass `-- <command>` to override for one run.
-
-```bash
-monacori init [--force]
-```
-
-Creates `.monacori/` with config, state, decisions, reports, logs, and diff directories. Because these are local validation artifacts, monacori also adds `.monacori/` to `.gitignore` inside Git worktrees.
-
-```bash
-monacori install [--force] [--apply-agent-docs]
-```
-
-Writes `.monacori/agent-snippet.md`, a short instruction block telling AI agents to run validation before claiming completion. With `--apply-agent-docs`, it updates `AGENTS.md` and `CLAUDE.md` marker blocks where available.
-
-```bash
-monacori verify [-- <command>]
-```
-
-Runs configured verification commands and stores the log in `.monacori/logs/`. Exits non-zero on failure.
-
-```bash
-monacori app [--base HEAD] [--staged] [--include-untracked] [--context 12] [--no-watch]
-```
-
-Launches the local desktop review app. `mo`, `monacori open`, and `monacori review` are aliases. Prefer `mo` for normal use.
-
-```bash
-monacori diff [--base HEAD] [--staged] [--include-untracked] [--context 12] [--output review.html] [--open] [--watch] [--port 0]
-```
-
-Generates a browser-based side-by-side diff review. Add `--watch` to serve a live review that reloads when the working tree changes.
-
-```bash
-monacori status
-```
+## Repository state
 
-Prints current branch, git status, diff stat, configured verification commands, recent reports, and recent logs.
-
-```bash
-monacori report [--label manual] [--file report.md]
-```
-
-Stores a manual report under `.monacori/reports/` and appends a compact summary to `.monacori/state.md`.
-
-## Repository State
-
-`monacori init` creates:
-
-```text
-.monacori/
-  config.json       verification commands and diff defaults
-  state.md          compact validation history
-  decisions.md      durable validation decisions
-  diffs/            generated browser diff reviews
-  reports/          validation reports
-  logs/             verification logs
-```
+`monacori init` (run automatically by `mo`) creates a git-ignored `.monacori/` directory holding generated diff reviews and local config. Keep it ignored unless your team explicitly wants to commit review state.
 
-`monacori install` also writes `.monacori/agent-snippet.md` for projects that want to paste or apply agent-facing validation instructions.
+## Design principles
 
-Keep `.monacori/` ignored unless your team explicitly wants to commit validation state.
+- A real diff beats a chat log or a "done" claim.
+- Review, comment, and hand-off live in one window — no copy-paste loop.
+- Generated artifacts are plain static HTML and JSON.
+- No required AI agent, terminal multiplexer, editor, or worktree strategy.
 
-## Design Principles
+## License
 
-- Verification evidence beats chat memory.
-- Generated artifacts should be plain Markdown, JSON, logs, or static HTML.
-- The tool should not require a specific AI agent, terminal multiplexer, editor, or worktree strategy.
-- The default command should be useful after any AI-generated edit.
-- A change is not accepted until verification evidence is clear or the gap is explicitly documented.
+MIT

package/dist/app-main.js

@@ -1,11 +1,23 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { app, BrowserWindow, ipcMain, Menu, nativeImage } from "electron";
 import { buildDiffReview, performHttpRequest } from "./cli.js";
+import { spawn as spawnPty } from "node-pty";
 const FLOW_DIR = ".monacori";
 const REVIEW_FILE = "app-review.html";
 const WATCH_INTERVAL_MS = 1000;
+// Painted immediately while the first review build + HTML render run, so startup shows a spinner instead
+// of a blank window. Inlined as a data: URL so it needs no file on disk and appears before any review work.
+const LOADING_HTML = `<!doctype html><html><head><meta charset="utf-8"><style>
+  html,body{margin:0;height:100vh;background:#2b2b2b;color:#9aa4af;display:flex;flex-direction:column;
+    align-items:center;justify-content:center;gap:18px;
+    font:13px -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}
+  .s{width:34px;height:34px;border:3px solid #3a3a3a;border-top-color:#4a9eff;border-radius:50%;
+    animation:spin .8s linear infinite}
+  @keyframes spin{to{transform:rotate(360deg)}}
+</style></head><body><div class="s"></div><div>monacori</div></body></html>`;
 app.setName("monacori");
 ipcMain.handle("monacori:http-send", (_event, request) => performHttpRequest(request));
 // Phase 2 lazy-LOAD: serve a single file's diff body to the renderer on demand. Retained from the
@@ -18,6 +30,129 @@ ipcMain.handle("monacori:get-file", (_event, request) => {
 });
 // Phase 2b lazy-LOAD: serve the full source files JSON (with content) on demand.
 ipcMain.handle("monacori:get-source-data", () => currentSourceData);
+// Self-update: install the latest published package globally, then relaunch so the updated code loads.
+// Runs in the main process because the sandboxed renderer can't spawn npm. Returns {ok:true} (and
+// relaunches shortly after) or {ok:false,error} so the renderer can fall back to the manual command.
+ipcMain.handle("monacori:self-update", () => {
+    const result = spawnSync("npm", ["install", "-g", "@happy-nut/monacori@latest"], {
+        encoding: "utf8",
+        shell: true,
+        env: process.env,
+        timeout: 5 * 60 * 1000,
+    });
+    if ((result.status ?? 1) === 0) {
+        // Let the renderer paint "Restarting…" before we relaunch with the new code.
+        setTimeout(() => { app.relaunch(); app.exit(0); }, 500);
+        return { ok: true };
+    }
+    const detail = (result.stderr || result.stdout || (result.error && result.error.message) || "npm install failed").trim();
+    return { ok: false, error: detail.slice(-600) };
+});
+// Integrated terminal: own node-pty sessions in the main process (the sandboxed renderer can't spawn
+// them) and relay bytes to the renderer's xterm panes. Each split pane gets its own pty, keyed by id, so
+// the renderer can route data/resize/kill per pane.
+const terms = new Map();
+let nextPtyId = 0;
+ipcMain.handle("monacori:pty-spawn", (_event, size) => {
+    const id = ++nextPtyId;
+    const shell = process.env.SHELL || (process.platform === "win32" ? "powershell.exe" : "/bin/zsh");
+    const t = spawnPty(shell, [], {
+        name: "xterm-color",
+        cols: size?.cols ?? 80,
+        rows: size?.rows ?? 24,
+        cwd: options.root,
+        env: process.env,
+    });
+    terms.set(id, t);
+    // mainWindow?. only guards null, NOT a *destroyed* window — sending to a closed window's webContents
+    // throws "Object has been destroyed". The pty can outlive the window (close races pty teardown), so
+    // guard every relay with isDestroyed().
+    const deliver = (channel, payload) => {
+        if (mainWindow && !mainWindow.isDestroyed())
+            mainWindow.webContents.send(channel, payload);
+    };
+    // pty output can arrive as many tiny chunks (thousands/sec under fast output). One IPC per chunk floods
+    // the renderer, so coalesce: buffer chunks and flush on a short timer, or immediately once the buffer is
+    // large — bounding both IPC traffic and added latency.
+    let outBuf = "";
+    let flushTimer;
+    const flushOut = () => {
+        flushTimer = undefined;
+        if (!outBuf)
+            return;
+        const data = outBuf;
+        outBuf = "";
+        deliver("monacori:pty-data", { id, data });
+    };
+    t.onData((data) => {
+        outBuf += data;
+        if (outBuf.length >= 64 * 1024) {
+            if (flushTimer)
+                clearTimeout(flushTimer);
+            flushOut();
+        }
+        else if (!flushTimer) {
+            flushTimer = setTimeout(flushOut, 12);
+        }
+    });
+    t.onExit(() => {
+        if (flushTimer)
+            clearTimeout(flushTimer);
+        flushOut(); // deliver any buffered tail before signaling exit
+        terms.delete(id);
+        deliver("monacori:pty-exit", { id });
+    });
+    return { ok: true, id };
+});
+ipcMain.on("monacori:pty-write", (_event, msg) => { terms.get(msg?.id)?.write(msg.data); });
+ipcMain.on("monacori:pty-resize", (_event, msg) => {
+    try {
+        terms.get(msg?.id)?.resize(msg.cols, msg.rows);
+    }
+    catch { /* resize can race the pty teardown — ignore */ }
+});
+ipcMain.on("monacori:pty-kill", (_event, msg) => {
+    const t = terms.get(msg?.id);
+    if (t) {
+        try {
+            t.kill();
+        }
+        catch { /* already exited */ }
+        terms.delete(msg.id);
+    }
+});
+// Persisted global settings (locale, …) live in a JSON file under userData and reach the renderer
+// via preload + the two handlers below. The renderer's file:// localStorage is NOT reliably persisted
+// across app restarts, so settings that must survive a reopen round-trip through the main process.
+function settingsFile() {
+    return join(app.getPath("userData"), "monacori-settings.json");
+}
+function readSettings() {
+    try {
+        return JSON.parse(readFileSync(settingsFile(), "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeSettings(settings) {
+    try {
+        writeFileSync(settingsFile(), JSON.stringify(settings, null, 2));
+    }
+    catch {
+        /* best-effort: a failed write just means the setting isn't persisted */
+    }
+}
+ipcMain.on("monacori:get-settings", (event) => {
+    event.returnValue = readSettings();
+});
+ipcMain.on("monacori:set-setting", (_event, msg) => {
+    if (!msg || typeof msg.key !== "string")
+        return;
+    const settings = readSettings();
+    settings[msg.key] = msg.value;
+    writeSettings(settings);
+});
 const iconPath = join(dirname(fileURLToPath(import.meta.url)), "..", "assets", "icon.png");
 const preloadPath = join(dirname(fileURLToPath(import.meta.url)), "preload.cjs");
 const options = parseArgs(process.argv.slice(2));
@@ -38,13 +173,15 @@ app.whenReady().then(async () => {
     if (process.platform === "darwin")
         menuTemplate.push({ role: "appMenu" });
     menuTemplate.push({ role: "editMenu" });
-    // Claim Cmd/Ctrl+Shift+/ ("?") and Cmd/Ctrl+Shift+. (">") as menu accelerators so macOS does not
-    // swallow Cmd+? for its Help search; clicking routes to the renderer's merged comment views.
+    // Ctrl+Cmd+Shift+/ ("?") and Ctrl+Cmd+Shift+. (">") open the merged question / change-request views.
+    // ? and > are Shift+/ and Shift+. so Shift is part of the combo; Ctrl+Cmd avoids macOS's Cmd+? Help grab.
     menuTemplate.push({
         label: "Review",
         submenu: [
-            { label: "All questions", accelerator: "CommandOrControl+Shift+/", click: () => sendMerged("q") },
-            { label: "All change requests", accelerator: "CommandOrControl+Shift+.", click: () => sendMerged("c") },
+            { label: "All questions", accelerator: "Control+Command+Shift+/", click: () => sendMerged("q") },
+            { label: "All change requests", accelerator: "Control+Command+Shift+.", click: () => sendMerged("c") },
+            // Cmd/Ctrl+Shift+N opens (and toggles) the single freeform prompt memo — a Markdown scratchpad.
+            { label: "Prompt memo", accelerator: "CommandOrControl+Shift+N", click: () => mainWindow?.webContents.send("monacori:open-memo") },
             { type: "separator" },
             // Whitespace-ignore re-runs git diff with --ignore-all-space and reloads (main-process action,
             // so a menu checkbox is simpler than a renderer IPC round-trip).
@@ -61,14 +198,37 @@ app.whenReady().then(async () => {
             },
         ],
     });
-    menuTemplate.push({ role: "windowMenu" });
+    // Cmd/Ctrl+W closes the active Files-mode tab (routed to the renderer) instead of the window, matching
+    // editor/browser tab behavior. Closing the window stays available via the menu item and Cmd/Ctrl+Q.
+    menuTemplate.push({
+        label: "Window",
+        submenu: [
+            { role: "minimize" },
+            { role: "zoom" },
+            { type: "separator" },
+            { label: "Close Tab", accelerator: "CommandOrControl+W", click: () => mainWindow?.webContents.send("monacori:close-tab") },
+            { label: "Close Window", click: () => mainWindow?.close() },
+        ],
+    });
+    // Terminal toggle/split as menu accelerators: Chromium swallows Cmd+D before it reaches the renderer
+    // (Cmd+A and friends arrive fine), so route the split — and the toggles — through the menu instead.
+    menuTemplate.push({
+        label: "Terminal",
+        submenu: [
+            { label: "Toggle Terminal", accelerator: "Control+`", click: () => mainWindow?.webContents.send("monacori:terminal-toggle") },
+            { label: "Toggle Terminal (F12)", accelerator: "Alt+F12", click: () => mainWindow?.webContents.send("monacori:terminal-toggle") },
+            { label: "Split Terminal", accelerator: "CommandOrControl+D", click: () => mainWindow?.webContents.send("monacori:terminal-split") },
+            { type: "separator" },
+            { label: "Focus Previous Pane", accelerator: "CommandOrControl+Alt+[", click: () => mainWindow?.webContents.send("monacori:terminal-pane-focus", -1) },
+            { label: "Focus Next Pane", accelerator: "CommandOrControl+Alt+]", click: () => mainWindow?.webContents.send("monacori:terminal-pane-focus", 1) },
+            { label: "Rename Pane", accelerator: "CommandOrControl+Alt+R", click: () => mainWindow?.webContents.send("monacori:terminal-pane-rename") },
+        ],
+    });
     Menu.setApplicationMenu(Menu.buildFromTemplate(menuTemplate));
     const appIcon = nativeImage.createFromPath(iconPath);
     if (process.platform === "darwin" && app.dock && !appIcon.isEmpty()) {
         app.dock.setIcon(appIcon);
     }
-    const firstBuild = writeReviewFile(options);
-    currentSignature = firstBuild.signature;
     mainWindow = new BrowserWindow({
         width: 1440,
         height: 960,
@@ -89,10 +249,27 @@ app.whenReady().then(async () => {
     });
     mainWindow.webContents.setWindowOpenHandler(() => ({ action: "deny" }));
     mainWindow.once("ready-to-show", () => mainWindow?.show());
-    await mainWindow.loadFile(reviewPath());
-    if (options.watch) {
-        refreshTimer = setInterval(refreshIfChanged, WATCH_INTERVAL_MS);
-    }
+    // Paint the window with a spinner immediately, then build the (potentially heavy) review off the first
+    // paint and swap it in. The first build used to run synchronously *before* the window existed, so the
+    // screen stayed blank for the first few seconds of startup; now the user sees a loading screen instead.
+    await mainWindow.loadURL("data:text/html;charset=utf-8," + encodeURIComponent(LOADING_HTML));
+    // Give the loading spinner a few frames to actually paint before the (synchronous) first build blocks
+    // the main process — otherwise the spinner looks frozen until the build finishes. The boot overlay in
+    // the review HTML then takes over, so there's no blank gap when loadFile swaps the page in.
+    setTimeout(() => {
+        try {
+            const firstBuild = writeReviewFile(options);
+            currentSignature = firstBuild.signature;
+            if (mainWindow && !mainWindow.isDestroyed())
+                void mainWindow.loadFile(reviewPath());
+            if (options.watch)
+                refreshTimer = setInterval(refreshIfChanged, WATCH_INTERVAL_MS);
+        }
+        catch (error) {
+            console.error(error instanceof Error ? error.message : String(error));
+            app.quit();
+        }
+    }, 60);
 }).catch((error) => {
     console.error(error instanceof Error ? error.message : String(error));
     app.quit();
@@ -100,6 +277,13 @@ app.whenReady().then(async () => {
 app.on("window-all-closed", () => {
     if (refreshTimer)
         clearInterval(refreshTimer);
+    for (const t of terms.values()) {
+        try {
+            t.kill();
+        }
+        catch { /* already exited */ }
+    }
+    terms.clear();
     app.quit();
 });
 async function refreshIfChanged() {
@@ -110,7 +294,13 @@ async function refreshIfChanged() {
         const next = writeReviewFile(options);
         if (next.signature !== currentSignature) {
             currentSignature = next.signature;
-            mainWindow.webContents.reloadIgnoringCache();
+            // Refresh the diff in place instead of reloading the window. A full reload re-runs the renderer,
+            // whose beforeunload kills every pty — so an integrated terminal running claude/codex would die on
+            // each working-tree change. We send only the compact update payload (diff/trees/status/data — no
+            // xterm blob), and the renderer transplants it + re-fetches per-file bodies/source over the existing
+            // IPC (currentBodies/currentSourceData were just refreshed by writeReviewFile above).
+            if (next.update)
+                mainWindow.webContents.send("monacori:diff-update", next.update);
         }
     }
     catch (error) {
@@ -129,11 +319,12 @@ function writeReviewFile(input) {
         title: "monacori",
         ignoreWhitespace: input.ignoreWhitespace,
         lazyLoad: true, // Electron streams per-file bodies/source over IPC (monacori:get-file / get-source)
+        app: true, // gate the integrated terminal (xterm) into the HTML — Electron only
     });
     writeFileSync(reviewPath(), build.html);
     currentBodies = build.lazyBodies ?? [];
     currentSourceData = build.lazySourceData ?? "[]";
-    return { signature: build.signature };
+    return { signature: build.signature, html: build.html, update: build.update };
 }
 function reviewPath() {
     return join(options.root, FLOW_DIR, REVIEW_FILE);

package/dist/assets.d.ts

@@ -2,3 +2,5 @@ export declare function readViewerAsset(name: string): string;
 export declare function diff2HtmlCss(): string;
 export declare function diffCss(): string;
 export declare function diffScript(): string;
+export declare function xtermCss(): string;
+export declare function xtermScript(): string;

package/dist/assets.js

@@ -28,3 +28,24 @@ export function diffCss() {
 export function diffScript() {
     return readViewerAsset("viewer.client.js");
 }
+// xterm.js (terminal renderer) for the integrated terminal panel. UMD bundles that expose
+// window.Terminal + window.FitAddon when inlined. Resolved from node_modules like diff2HtmlCss();
+// pure JS, no native binding — the pty itself lives in the main process via node-pty.
+export function xtermCss() {
+    try {
+        return readFileSync(nodeRequire.resolve("@xterm/xterm/css/xterm.css"), "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+export function xtermScript() {
+    try {
+        const core = readFileSync(nodeRequire.resolve("@xterm/xterm/lib/xterm.js"), "utf8");
+        const fit = readFileSync(nodeRequire.resolve("@xterm/addon-fit/lib/addon-fit.js"), "utf8");
+        return core + "\n" + fit;
+    }
+    catch {
+        return "";
+    }
+}

package/dist/build.d.ts

@@ -9,4 +9,5 @@ export declare function buildDiffReview(input: {
     ignoreWhitespace?: boolean;
     lazy?: boolean;
     lazyLoad?: boolean;
+    app?: boolean;
 }): DiffReviewBuild;

package/dist/build.js

@@ -3,7 +3,7 @@ import { basename } from "node:path";
 import { isGitRepository } from "./git.js";
 import { collectHttpEnvironments, collectReviewFileStates, collectSourceFiles, parseUnifiedDiff, readUnifiedDiff } from "./diff.js";
 import { renderDiff2Html } from "./highlight.js";
-import { diffSubtitle, renderDiffHtml, renderNotGitRepoHtml, shouldLazyRender, splitDiffForLazy } from "./render.js";
+import { diffSubtitle, renderDiffHtml, renderDiffTree, renderNotGitRepoHtml, renderReviewStatus, renderSourceTree, shouldLazyRender, splitDiffForLazy } from "./render.js";
 export function buildDiffReview(input) {
     if (!isGitRepository(process.cwd())) {
         return {
@@ -30,11 +30,13 @@ export function buildDiffReview(input) {
     const diffHtml = renderDiff2Html(diffText);
     const totalLines = files.reduce((sum, file) => sum + file.hunks.reduce((t, h) => t + h.lines.length, 0), 0);
     // lazy-LOAD (Phase 2) serves each file body + source on demand instead of embedding them; it implies
-    // lazy (shells). Gated by size: only big reviews lazy-LOAD — small ones embed (no IPC round-trips, no
-    // "Loading source…" flash). The transport opts in (serve/Electron pass lazyLoad:true); standalone has
-    // no server. A big standalone review still lazy-materializes from embedded islands (Phase 1).
+    // lazy (shells). The transport opts in (serve/Electron pass lazyLoad:true) and we honor it regardless
+    // of size: it used to be gated by `&& big`, but a mid-size repo (dozens of files, just under the
+    // threshold) then embedded a 600KB+ source blob + every diff body inline, forcing the renderer to
+    // parse + lay out a huge document before the first click — the startup "freeze". Standalone (no
+    // transport) has no server, so it auto-decides by size and lazy-materializes from embedded islands.
     const big = shouldLazyRender(files.length, totalLines);
-    const lazyLoad = (input.lazyLoad ?? false) && big;
+    const lazyLoad = input.lazyLoad ?? false;
     const lazy = lazyLoad || (input.lazy ?? big);
     const diffSplit = lazy ? splitDiffForLazy(diffHtml, files) : { container: diffHtml, islands: "", bodies: [] };
     const signature = createHash("sha1")
@@ -59,9 +61,31 @@ export function buildDiffReview(input) {
         projectPath: process.cwd(),
         watch: Boolean(input.watch),
         ignoreWhitespace: Boolean(input.ignoreWhitespace),
+        app: Boolean(input.app),
         signature,
         generatedAt,
     });
+    // Compact payload for in-place refresh: just the regions the renderer swaps on a watch change. Reuses
+    // the same fragment renderers as the full page, minus the heavy bits (xterm blob, embedded source).
+    const update = {
+        signature,
+        generatedAt,
+        diffContainer: diffSplit.container || '<div class="empty" data-i18n="diff.noDiff">No diff to review.</div>',
+        changesPanel: renderDiffTree(files),
+        filesTree: renderSourceTree(sourceFiles),
+        reviewStatus: renderReviewStatus({
+            files: files.length,
+            hunks,
+            embeddedFiles: sourceFiles.filter((file) => file.embedded).length,
+            sourceFileCount: sourceFiles.length,
+            ignoreWhitespace: input.ignoreWhitespace,
+            watch: input.watch,
+            generatedAt,
+        }),
+        fileStates,
+        sourceFilesMeta: lazyLoad ? sourceFiles.map((file) => ({ ...file, content: "", image: "" })) : sourceFiles,
+        httpEnvironments,
+    };
     return {
         html,
         files: files.length,
@@ -70,5 +94,6 @@ export function buildDiffReview(input) {
         generatedAt,
         lazyBodies: diffSplit.bodies,
         lazySourceData: lazyLoad ? JSON.stringify(sourceFiles) : undefined,
+        update,
     };
 }