critique 0.1.119 → 0.1.121

package/dist/agentation-widget.js

@@ -13,6 +13,13 @@
 //   containing many spans). We inject content-visibility: auto on .line elements
 //   so the browser only renders visible lines, skipping layout/paint for the
 //   ~6,400 off-screen lines. This brings page load from ~16s to <2s on large diffs.
+//
+// iOS Safari pinch-zoom fix:
+//   position:fixed is relative to the layout viewport, not the visual viewport.
+//   When users pinch-to-zoom on iOS Safari, the widget drifts with the zoomed
+//   content and can end up mispositioned after zooming out. We use the
+//   visualViewport API to apply a counter-transform that keeps the widget
+//   anchored to the bottom-right of what the user actually sees.
 function injectContentVisibility() {
     if (document.getElementById("critique-cv-styles"))
         return;
@@ -37,6 +44,9 @@ async function init() {
         const isLight = window.matchMedia("(prefers-color-scheme: light)").matches;
         localStorage.setItem("feedback-toolbar-theme", isLight ? "light" : "dark");
     }
+    // Always reset the widget to the default bottom-right position on page load.
+    // If a user accidentally drags it, it snaps back on refresh.
+    localStorage.removeItem("feedback-toolbar-position");
     if (document.getElementById("critique-agentation"))
         return;
     const config = window.__CRITIQUE_CONFIG__;
@@ -47,6 +57,11 @@ async function init() {
     const container = document.createElement("div");
     container.id = "critique-agentation";
     document.body.appendChild(container);
+    // Fix position:fixed drift during pinch-to-zoom on iOS Safari.
+    // The visualViewport API tells us how the visible area has shifted
+    // relative to the layout viewport. We apply a counter-transform so
+    // the widget stays anchored to the visual viewport's bottom-right.
+    setupVisualViewportFix(container);
     // Use preact's render() directly since the build aliases react → preact/compat.
     // preact/compat does not export createRoot from react-dom/client.
     const [{ Agentation }, { render, h }] = await Promise.all([
@@ -59,6 +74,30 @@ async function init() {
         showFreezeButton: config.showFreezeButton,
     }), container);
 }
+function setupVisualViewportFix(container) {
+    const vv = window.visualViewport;
+    if (!vv)
+        return;
+    function update() {
+        if (!vv)
+            return;
+        if (vv.scale <= 1.01) {
+            // No zoom — clear any transform so default fixed positioning works
+            container.style.transform = "";
+            return;
+        }
+        // Translate the container so it follows the visual viewport's position,
+        // then scale it back to its original size (counter the zoom).
+        container.style.transform = [
+            `translate(${vv.offsetLeft}px, ${vv.offsetTop}px)`,
+            `scale(${1 / vv.scale})`,
+        ].join(" ");
+        // Set transform-origin to top-left so the translate values are intuitive
+        container.style.transformOrigin = "top left";
+    }
+    vv.addEventListener("resize", update);
+    vv.addEventListener("scroll", update);
+}
 if (document.readyState === "loading") {
     document.addEventListener("DOMContentLoaded", init);
 }

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":";AAOA,OAAO,gCAAgC,CAAC;AAYxC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAwB/B,OAAO,EAgBL,KAAK,UAAU,EAEhB,MAAM,iBAAiB,CAAC;AAi4CzB,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,wBAAgB,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAkVjE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":";AAOA,OAAO,gCAAgC,CAAC;AAYxC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAwB/B,OAAO,EAgBL,KAAK,UAAU,EAEhB,MAAM,iBAAiB,CAAC;AA45CzB,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,wBAAgB,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAkVjE"}

package/dist/cli.js

@@ -886,7 +886,7 @@ async function runResumeMode(options) {
             , isGenerating: false, initialReviewData: review.reviewYaml }) }));
 }
 async function runWebMode(diffContent, options) {
-    const { captureResponsiveHtml, uploadHtml, openInBrowser, } = await import("./web-utils.js");
+    const { captureResponsiveHtml, uploadHtml, uploadOgImage, openInBrowser, } = await import("./web-utils.js");
     // Use stderr for progress when --json is set, stdout otherwise
     const log = options.json ? console.error.bind(console) : console.log.bind(console);
     const desktopCols = options.cols || 230;
@@ -904,9 +904,12 @@ async function runWebMode(diffContent, options) {
     }, 100); // base padding
     log("Converting to HTML...");
     try {
-        const { htmlDesktop, htmlMobile, ogImage } = await captureResponsiveHtml(diffContent, { desktopCols, mobileCols, baseRows, themeName, title: options.title });
+        // Render desktop + mobile HTML and OG image in parallel.
+        // Skip OG from initial upload — we'll PATCH it in the background
+        // after the URL is printed, so the user sees the URL faster.
+        const { htmlDesktop, htmlMobile, ogImage } = await captureResponsiveHtml(diffContent, { desktopCols, mobileCols, baseRows, themeName, title: options.title, skipOgImage: true });
         log("Uploading...");
-        const result = await uploadHtml(htmlDesktop, htmlMobile, ogImage);
+        const result = await uploadHtml(htmlDesktop, htmlMobile);
         log(`\nPreview URL: ${result.url}`);
         log(formatPreviewExpiry(result.expiresInDays));
         if (typeof result.expiresInDays === "number") {
@@ -926,6 +929,29 @@ async function runWebMode(diffContent, options) {
         if (options.open) {
             await openInBrowser(result.url);
         }
+        // Generate and upload OG image in the background after URL is printed.
+        // The URL is already available — this just adds social media previews.
+        // Hard cap at 8s to prevent the process hanging after URL output.
+        const ogUpload = (async () => {
+            try {
+                const { renderDiffToOgImage } = await import("./image.js");
+                const ogImg = await renderDiffToOgImage(diffContent, {
+                    themeName: "github-light",
+                    stabilizeMs: 100,
+                });
+                if (ogImg) {
+                    await uploadOgImage(result.id, ogImg);
+                }
+            }
+            catch {
+                // OG image generation failed — not critical, skip silently
+            }
+        })();
+        // Wait for OG upload with a hard timeout so the process always exits
+        await Promise.race([
+            ogUpload,
+            new Promise(resolve => setTimeout(resolve, 8000)),
+        ]);
         process.exit(0);
     }
     catch (error) {

package/dist/diff-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff-utils.d.ts","sourceRoot":"","sources":["../src/diff-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diff-utils.d.ts","sourceRoot":"","sources":["../src/diff-utils.ts"],"names":[],"mappings":"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"}

package/dist/diff-utils.js

@@ -236,6 +236,13 @@ export function buildGitCommand(options) {
     const filterArg = filters.length > 0
         ? `-- ${filters.map((f) => `'${f}'`).join(" ")}`
         : "";
+    // If --commit contains range syntax (A..B or A...B), treat it as a base ref
+    // instead. git show with ranges outputs commit metadata interleaved with diffs
+    // that parsePatch cannot parse. Redirecting to base reuses the existing range
+    // handling below (two-dot and three-dot parsing).
+    if (options.commit?.includes("..")) {
+        options = { ...options, base: options.commit, commit: undefined };
+    }
     if (options.staged) {
         return `git diff --cached --no-prefix ${renameArg} ${submoduleArg} ${contextArg} ${filterArg}`.trim();
     }
@@ -436,9 +443,15 @@ export function detectFiletype(filePath) {
         case "cts":
             return "typescript";
         case "json":
+        case "jsonc":
+        case "json5":
             return "json";
         case "md":
         case "mdx":
+        case "mkd":
+        case "mkdn":
+        case "mdown":
+        case "markdown":
             return "markdown";
         case "zig":
             return "zig";
@@ -456,6 +469,10 @@ export function detectFiletype(filePath) {
         case "cxx":
         case "hpp":
         case "hxx":
+        case "hh":
+        case "tpp":
+        case "ipp":
+        case "inl":
         case "h":
             return "cpp";
         case "cs":
@@ -463,6 +480,7 @@ export function detectFiletype(filePath) {
         case "sh":
         case "bash":
         case "zsh":
+        case "ksh":
             return "bash";
         case "c":
             return "c";
@@ -479,6 +497,9 @@ export function detectFiletype(filePath) {
             return "scala";
         case "html":
         case "htm":
+        case "xhtml":
+        case "xml":
+        case "svg":
             return "html";
         case "yaml":
         case "yml":
@@ -487,6 +508,8 @@ export function detectFiletype(filePath) {
         case "lhs":
             return "haskell";
         case "css":
+        case "scss":
+        case "less":
             return "css";
         case "jl":
             return "julia";

package/dist/diff-utils.test.js

@@ -459,6 +459,41 @@ describe("getOldFileName", () => {
     });
 });
 // ============================================================================
+// --commit with range syntax (HEAD~2..HEAD)
+// ============================================================================
+describe("--commit with range syntax", () => {
+    it("should use git diff instead of git show for two-dot range", () => {
+        // --commit with range redirects to base, which uses the two-dot path
+        const cmd = buildGitCommand({ commit: "HEAD~2..HEAD" });
+        expect(cmd).toStartWith("git diff HEAD~2..HEAD");
+        expect(cmd).not.toContain("git show");
+    });
+    it("should use git diff instead of git show for three-dot range", () => {
+        // --commit with range redirects to base, which uses the three-dot path
+        const cmd = buildGitCommand({ commit: "main...feature" });
+        expect(cmd).toStartWith("git diff main...feature");
+        expect(cmd).not.toContain("git show");
+    });
+    it("should use git diff for named ref range", () => {
+        const cmd = buildGitCommand({ commit: "origin/main..HEAD" });
+        expect(cmd).toStartWith("git diff origin/main..HEAD");
+        expect(cmd).not.toContain("git show");
+    });
+    it("should produce same command whether range comes via --commit or positional base", () => {
+        const viaCommit = buildGitCommand({ commit: "HEAD~2..HEAD" });
+        const viaBase = buildGitCommand({ base: "HEAD~2..HEAD" });
+        expect(viaCommit).toBe(viaBase);
+    });
+    it("should still use git show for a single commit ref", () => {
+        const cmd = buildGitCommand({ commit: "HEAD" });
+        expect(cmd).toStartWith("git show HEAD");
+    });
+    it("should still use git show for a single hash", () => {
+        const cmd = buildGitCommand({ commit: "abc123" });
+        expect(cmd).toStartWith("git show abc123");
+    });
+});
+// ============================================================================
 // buildGitCommand includes rename detection
 // ============================================================================
 describe("buildGitCommand with rename detection", () => {

package/dist/hooks/use-copy-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-copy-selection.d.ts","sourceRoot":"","sources":["../../src/hooks/use-copy-selection.ts"],"names":[],"mappings":"AAkFA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAqBxD"}
+{"version":3,"file":"use-copy-selection.d.ts","sourceRoot":"","sources":["../../src/hooks/use-copy-selection.ts"],"names":[],"mappings":"AAiFA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAsBxD"}

package/dist/hooks/use-copy-selection.js

@@ -2,12 +2,12 @@
 // Automatically copies selected text to clipboard when user releases mouse button.
 // Uses native clipboard commands (pbcopy, xclip, etc.) with OSC52 fallback.
 import { useRenderer } from "@opentuah/react";
-import { spawn } from "child_process";
+import childProcess from "child_process";
 /**
  * Copy text to system clipboard using native commands.
  * Falls back to OSC52 escape sequence for terminal clipboard (works over SSH).
  */
-async function copyToClipboard(text) {
+async function copyToClipboard(text, copyOsc52) {
     const platform = process.platform;
     // Try native clipboard commands
     try {
@@ -52,16 +52,15 @@ async function copyToClipboard(text) {
     catch {
         // Native clipboard failed, fall through to OSC52
     }
-    // Fallback: OSC52 escape sequence (works in many terminals, including over SSH)
-    const encoded = Buffer.from(text).toString("base64");
-    process.stdout.write(`\x1b]52;c;${encoded}\x07`);
+    // Fallback: renderer OSC52 utility (works in many terminals, including over SSH)
+    copyOsc52(text);
 }
 /**
  * Spawn a clipboard command and pipe text to it
  */
 function spawnClipboard(cmd, args, text) {
     return new Promise((resolve, reject) => {
-        const proc = spawn(cmd, args, { stdio: ["pipe", "ignore", "ignore"] });
+        const proc = childProcess.spawn(cmd, args, { stdio: ["pipe", "ignore", "ignore"] });
         proc.on("error", reject);
         proc.on("close", (code) => {
             if (code === 0)
@@ -99,11 +98,13 @@ export function useCopySelection() {
         const selection = renderer.getSelection();
         if (!selection)
             return;
+        if (selection.isDragging)
+            return;
         const text = selection.getSelectedText();
         if (!text || text.length === 0)
             return;
         try {
-            await copyToClipboard(text);
+            await copyToClipboard(text, (value) => renderer.copyToClipboardOSC52(value));
         }
         catch {
             // Silent fail - user can manually copy if needed

package/dist/image.d.ts

@@ -129,5 +129,6 @@ export declare function renderFrameToOgImage(frame: CapturedFrame, options?: OgI
  */
 export declare function renderDiffToOgImage(diffContent: string, options?: OgImageOptions & {
     cols?: number;
+    stabilizeMs?: number;
 }): Promise<Buffer>;
 //# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"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"}

package/dist/image.js

@@ -177,6 +177,7 @@ export async function renderDiffToOgImage(diffContent, options = {}) {
         cols,
         maxRows: 200,
         themeName,
+        stabilizeMs: options.stabilizeMs,
     });
     // Convert frame to OG image
     return renderFrameToOgImage(frame, {

package/dist/routes/annotations-context.d.ts

@@ -1,4 +1,3 @@
-/** @jsxImportSource hono/jsx */
 import { Hono } from "hono";
 import type { KVNamespace } from "@cloudflare/workers-types";
 type Bindings = {

package/dist/routes/annotations-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotations-context.d.ts","sourceRoot":"","sources":["../../src/routes/annotations-context.tsx"],"names":[],"mappings":"AAAA,gCAAgC;AAKhC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,KAAK,QAAQ,GAAG;IACd,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,EAAE;QACX,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,CAAA;QAChD,GAAG,CAAC,EAAE,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,GAAG;YAC/B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;SAC3C,CAAA;KACF,CAAA;CACF,CAAA;AAED,QAAA,MAAM,KAAK;cAAwB,QAAQ;yCAAK,CAAA;AA0IhD,OAAO,EAAE,KAAK,IAAI,uBAAuB,EAAE,CAAA"}
+{"version":3,"file":"annotations-context.d.ts","sourceRoot":"","sources":["../../src/routes/annotations-context.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,KAAK,QAAQ,GAAG;IACd,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,EAAE;QACX,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,CAAA;QAChD,GAAG,CAAC,EAAE,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,GAAG;YAC/B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;SAC3C,CAAA;KACF,CAAA;CACF,CAAA;AAgED,QAAA,MAAM,KAAK;cAAwB,QAAQ;yCAAK,CAAA;AA2BhD,OAAO,EAAE,KAAK,IAAI,uBAAuB,EAAE,CAAA"}

package/dist/routes/annotations-context.js

@@ -1,9 +1,46 @@
-import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
-/** @jsxImportSource hono/jsx */
 // Route: GET /v/:id/annotations
-// Returns all annotations for a diff with surrounding context.
-// Supports ?format=json for machine-readable output, otherwise renders HTML.
+// Returns all annotations as markdown, matching agentation's generateOutput format.
+// This is the format agents and LLMs consume best.
 import { Hono } from "hono";
+function generateMarkdown(annotations, diffUrl) {
+    if (annotations.length === 0)
+        return "No annotations yet.\n";
+    let output = `## Page Feedback: ${diffUrl}\n\n`;
+    for (let i = 0; i < annotations.length; i++) {
+        const a = annotations[i];
+        output += `### ${i + 1}. ${a.element || a.elementPath}\n`;
+        if (a.elementPath) {
+            output += `**Location:** ${a.elementPath}\n`;
+        }
+        if (a.anchor) {
+            output += `**Anchor:** ${a.anchor}\n`;
+        }
+        if (a.selectedText) {
+            output += `**Selected text:** "${a.selectedText}"\n`;
+        }
+        if (a.nearbyText && !a.selectedText) {
+            output += `**Context:** ${a.nearbyText.slice(0, 100)}\n`;
+        }
+        if (a.status && a.status !== "pending") {
+            output += `**Status:** ${a.status}\n`;
+        }
+        if (a.severity) {
+            output += `**Severity:** ${a.severity}\n`;
+        }
+        if (a.intent) {
+            output += `**Intent:** ${a.intent}\n`;
+        }
+        output += `**Feedback:** ${a.comment}\n`;
+        if (a.thread && a.thread.length > 0) {
+            output += "\n";
+            for (const msg of a.thread) {
+                output += `> **${msg.role}:** ${msg.content}\n`;
+            }
+        }
+        output += "\n";
+    }
+    return output.trim() + "\n";
+}
 const route = new Hono();
 route.get("/v/:id/annotations", async (c) => {
     const id = c.req.param("id");
@@ -18,43 +55,11 @@ route.get("/v/:id/annotations", async (c) => {
     req.headers.set("x-partykit-room", id);
     const resp = await stub.fetch(req);
     const annotations = (await resp.json());
-    const format = c.req.query("format");
-    // JSON format for agents/bots
-    if (format === "json") {
-        return c.json({
-            diffId: id,
-            diffUrl: `${new URL(c.req.url).origin}/v/${id}`,
-            count: annotations.length,
-            annotations,
-        });
-    }
-    // HTML format for humans
     const origin = new URL(c.req.url).origin;
-    return c.html(_jsxs("html", { children: [_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsxs("title", { children: ["Annotations \u2014 ", id.slice(0, 8)] }), _jsx("style", { children: `
-          body { font-family: ui-sans-serif, system-ui, -apple-system, sans-serif; background: #0f1419; color: #e6edf3; margin: 0; padding: 24px; }
-          .header { max-width: 720px; margin: 0 auto 24px; }
-          .header h1 { font-size: 20px; margin: 0 0 8px; }
-          .header a { color: #58a6ff; text-decoration: none; font-size: 14px; }
-          .header a:hover { text-decoration: underline; }
-          .count { color: #8b949e; font-size: 14px; margin-bottom: 24px; }
-          .annotation { max-width: 720px; margin: 0 auto 20px; background: #151b23; border: 1px solid #2d3440; border-radius: 10px; padding: 16px; }
-          .meta { display: flex; gap: 12px; align-items: center; margin-bottom: 8px; font-size: 13px; color: #8b949e; }
-          .badge { padding: 2px 8px; border-radius: 4px; font-size: 11px; font-weight: 600; text-transform: uppercase; }
-          .badge-pending { background: #1f3044; color: #58a6ff; }
-          .badge-resolved { background: #1a3520; color: #3fb950; }
-          .badge-dismissed { background: #3d1f20; color: #f85149; }
-          .badge-acknowledged { background: #3b2e1a; color: #d29922; }
-          .badge-blocking { background: #3d1f20; color: #f85149; }
-          .badge-important { background: #3b2e1a; color: #d29922; }
-          .badge-suggestion { background: #1f3044; color: #58a6ff; }
-          .comment { font-size: 15px; line-height: 1.6; margin: 8px 0; }
-          .context { font-size: 13px; color: #8b949e; margin-top: 8px; }
-          .context code { background: #1c2128; padding: 2px 6px; border-radius: 4px; font-family: ui-monospace, monospace; }
-          .thread { margin-top: 12px; border-top: 1px solid #2d3440; padding-top: 12px; }
-          .thread-msg { margin-bottom: 8px; font-size: 13px; }
-          .thread-role { font-weight: 600; color: #58a6ff; }
-          .thread-role.agent { color: #d29922; }
-          .empty { max-width: 720px; margin: 40px auto; text-align: center; color: #8b949e; }
-        ` })] }), _jsxs("body", { children: [_jsxs("div", { class: "header", children: [_jsx("h1", { children: "Annotations" }), _jsx("a", { href: `${origin}/v/${id}`, children: "Back to diff" }), _jsxs("div", { class: "count", children: [annotations.length, " annotation", annotations.length !== 1 ? "s" : ""] })] }), annotations.length === 0 ? (_jsx("div", { class: "empty", children: "No annotations yet" })) : (annotations.map((ann) => (_jsxs("div", { class: "annotation", children: [_jsxs("div", { class: "meta", children: [ann.userName && _jsx("span", { children: ann.userName }), ann.status && (_jsx("span", { class: `badge badge-${ann.status}`, children: ann.status })), ann.severity && (_jsx("span", { class: `badge badge-${ann.severity}`, children: ann.severity })), ann.intent && _jsx("span", { children: ann.intent }), ann.createdAt && (_jsx("span", { children: new Date(ann.createdAt).toLocaleString() }))] }), _jsx("div", { class: "comment", children: ann.comment }), (ann.elementPath || ann.anchor || ann.nearbyText || ann.selectedText) && (_jsxs("div", { class: "context", children: [ann.anchor && (_jsxs("div", { children: ["Anchor: ", _jsx("code", { children: ann.anchor })] })), ann.elementPath && (_jsxs("div", { children: ["Element: ", _jsx("code", { children: ann.elementPath })] })), ann.selectedText && (_jsxs("div", { children: ["Selected: \"", ann.selectedText, "\""] })), ann.nearbyText && (_jsxs("div", { children: ["Nearby: \"", ann.nearbyText, "\""] }))] })), ann.thread && ann.thread.length > 0 && (_jsx("div", { class: "thread", children: ann.thread.map((msg, i) => (_jsxs("div", { class: "thread-msg", children: [_jsxs("span", { class: `thread-role ${msg.role}`, children: [msg.role, ":"] }), " ", msg.content] }, i))) }))] }, ann.id))))] })] }));
+    const diffUrl = `${origin}/v/${id}`;
+    const markdown = generateMarkdown(annotations, diffUrl);
+    return c.text(markdown, 200, {
+        "Content-Type": "text/markdown; charset=utf-8",
+    });
 });
 export { route as annotationsContextRoute };

package/dist/web-utils.d.ts

@@ -1,4 +1,4 @@
-import type { CapturedFrame } from "@opentuah/core";
+import type { CapturedFrame, CapturedLine } from "@opentuah/core";
 import type { IndexedHunk, ReviewYaml } from "./review/types.js";
 export declare const WORKER_URL: string;
 export interface CaptureOptions {
@@ -12,6 +12,9 @@ export interface CaptureOptions {
     viewMode?: "split" | "unified";
     /** Show privacy/expiry notice block at top (default: false, enabled for web uploads) */
     showNotice?: boolean;
+    /** How long to wait for async rendering (tree-sitter) to stabilize.
+     *  Default: 500ms for interactive TUI, use 100ms for batch/web mode. */
+    stabilizeMs?: number;
 }
 export interface UploadResult {
     url: string;
@@ -25,6 +28,17 @@ export declare function renderDiffToFrame(diffContent: string, options: CaptureO
  * e.g. "src/components/foo-bar.tsx" → "src-components-foo-bar-tsx"
  */
 export declare function slugifyFileName(name: string): string;
+/**
+ * Extract line numbers from a captured diff line's spans.
+ * In split view each row has two line number columns (old + new):
+ *   " " "29" " - " ...content... " " "29" " + " ...content...
+ * In unified view there's only one.
+ *
+ * Returns the new-file (right) line number when available,
+ * falling back to the old-file (left) number for deleted-only rows.
+ * Returns null for non-diff lines (headers, hunk markers, etc.).
+ */
+export declare function extractLineNumber(line: CapturedLine): string | null;
 /**
  * Build line-indexed anchors from file section layout positions.
  * This avoids regex detection on rendered text, which can produce
@@ -50,6 +64,10 @@ export declare function captureResponsiveHtml(diffContent: string, options: {
     baseRows: number;
     themeName: string;
     title?: string;
+    /** Stabilization timeout for tree-sitter highlighting (default: 100ms for web) */
+    stabilizeMs?: number;
+    /** Skip OG image generation for faster URL delivery */
+    skipOgImage?: boolean;
 }): Promise<{
     htmlDesktop: string;
     htmlMobile: string;
@@ -80,6 +98,10 @@ export declare function captureReviewResponsiveHtml(options: {
     baseRows: number;
     themeName: string;
     title?: string;
+    /** Stabilization timeout for tree-sitter highlighting (default: 100ms for web) */
+    stabilizeMs?: number;
+    /** Skip OG image generation for faster URL delivery */
+    skipOgImage?: boolean;
 }): Promise<{
     htmlDesktop: string;
     htmlMobile: string;
@@ -89,6 +111,12 @@ export declare function captureReviewResponsiveHtml(options: {
  * Upload HTML to the critique.work worker
  */
 export declare function uploadHtml(htmlDesktop: string, htmlMobile: string, ogImage?: Buffer | null): Promise<UploadResult>;
+/**
+ * Upload OG image to an existing diff via PATCH.
+ * Called in the background after the initial upload returns the URL.
+ * Uses a 5s timeout to prevent hanging the process after URL is printed.
+ */
+export declare function uploadOgImage(id: string, ogImage: Buffer): Promise<void>;
 /**
  * Open a URL in the default browser
  */

package/dist/web-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-utils.d.ts","sourceRoot":"","sources":["../src/web-utils.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"web-utils.d.ts","sourceRoot":"","sources":["../src/web-utils.tsx"],"names":[],"mappings":"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"}