@gavin-hu/my-pi-agent 0.17.0 → 0.19.0

package/extensions/file-browse/view/diff-html.ts

@@ -0,0 +1,94 @@
+/**
+ * The browse pages' unified-diff body: one line per row, with the gutter, the
+ * sign, and the hunk sections.
+ *
+ * Split from `html.ts` when that module reached its named ceiling: the diff body
+ * is the one part of the page renderers with its own rule — old and new sides are
+ * highlighted as two documents per hunk, so the tokenizer carries state within a
+ * hunk and never across the unchanged lines a hunk does not show.
+ */
+
+import { escapeHtml } from "../../../lib/escape.ts";
+import { highlightLines, type HighlightLanguage } from "../../../lib/highlight.ts";
+import type { DiffLine } from "../text/diff.ts";
+
+/**
+ * The inner HTML per diff line. Hunk bodies are highlighted by rebuilding the
+ * old side (context + deleted) and the new side (context + added), so the
+ * tokenizer carries state within a hunk; meta, hunk, and note lines stay plain.
+ * State does not cross hunks, since the unchanged lines between them are absent.
+ */
+function highlightDiffText(lines: DiffLine[], language?: HighlightLanguage): string[] {
+	if (!language) return lines.map((line) => escapeHtml(line.text));
+	const out: string[] = new Array(lines.length);
+	let index = 0;
+	while (index < lines.length) {
+		const kind = lines[index].kind;
+		if (kind !== "ctx" && kind !== "add" && kind !== "del") {
+			out[index] = escapeHtml(lines[index].text);
+			index++;
+			continue;
+		}
+		const start = index;
+		const oldDoc: string[] = [];
+		const newDoc: string[] = [];
+		while (index < lines.length) {
+			const body = lines[index].kind;
+			if (body !== "ctx" && body !== "add" && body !== "del") break;
+			if (body === "ctx") {
+				oldDoc.push(lines[index].text);
+				newDoc.push(lines[index].text);
+			} else if (body === "add") {
+				newDoc.push(lines[index].text);
+			} else {
+				oldDoc.push(lines[index].text);
+			}
+			index++;
+		}
+		const oldHtml = highlightLines(oldDoc, language);
+		const newHtml = highlightLines(newDoc, language);
+		let oldIndex = 0;
+		let newIndex = 0;
+		for (let cursor = start; cursor < index; cursor++) {
+			const body = lines[cursor].kind;
+			if (body === "ctx") {
+				out[cursor] = newHtml[newIndex];
+				newIndex++;
+				oldIndex++;
+			} else if (body === "add") {
+				out[cursor] = newHtml[newIndex];
+				newIndex++;
+			} else {
+				out[cursor] = oldHtml[oldIndex];
+				oldIndex++;
+			}
+		}
+	}
+	return out;
+}
+
+/** Render unified-diff lines with a two-column gutter and per-kind styling. */
+export function renderDiffLines(lines: DiffLine[], language?: HighlightLanguage): string {
+	const html = highlightDiffText(lines, language);
+	// Every hunk is a section so its sticky header is bounded by its own body;
+	// the section also gives the keyboard a stable, non-sticky scroll target.
+	const out: string[] = [];
+	let hunks = 0;
+	let open = false;
+	lines.forEach((line, index) => {
+		if (line.kind === "hunk") {
+			if (open) out.push("</span>");
+			hunks += 1;
+			out.push(`<span class="bf-diff-hunk" id="hunk-${hunks}" data-hunk="${hunks}">`);
+			open = true;
+		}
+		const sign = line.kind === "add" ? "+" : line.kind === "del" ? "-" : line.kind === "ctx" ? " " : "";
+		const gutter = `<span class="browse-diff-no" aria-hidden="true">${line.oldNo ?? ""}</span><span class="browse-diff-no" aria-hidden="true">${line.newNo ?? ""}</span>`;
+		const marker = `<span class="browse-diff-sign" aria-hidden="true">${sign}</span>`;
+		out.push(
+			`<span class="bf-code__line bf-diff-line bf-diff-line--${line.kind}">${gutter}${marker}${html[index]}</span>`,
+		);
+	});
+	if (open) out.push("</span>");
+	return out.join("");
+}

package/extensions/file-browse/{html.ts → view/html.ts}

@@ -8,17 +8,19 @@
  * the page-only `browse-*` rules from `styles.ts`.
  */
 
-import { GLYPHS } from "../../lib/tui/glyphs.ts";
-import { brandLockup, docHead, type KeyHint, keysSheet, themeToggle } from "../../lib/web/index.ts";
-import { escapeHtml } from "../../lib/escape.ts";
-import { formatSize, type DirEntry, type FileView, type Listing, type TreeNode } from "./files.ts";
-import { DIFF_MODES, statusLetter, type ChangedFile, type DiffLine, type DiffMode } from "./diff.ts";
-import type { DiffFileView, GitStatus } from "./git.ts";
-import type { ChangeIndex } from "./live.ts";
-import { detectLanguage, highlightLines, type HighlightLanguage } from "../../lib/highlight.ts";
+import { brandLockup, docHead, type KeyHint, keysSheet, themeToggle } from "../../../lib/web/index.ts";
+import { escapeHtml } from "../../../lib/escape.ts";
+import { renderChanges, renderGit, renderLiveChrome, renderLiveStatus, type LivePage } from "./chrome.ts";
+import { type DirEntry, type FileView, type Listing, type TreeNode } from "../files/files.ts";
+import { formatSize } from "../../../lib/format.ts";
+import { DIFF_MODES, statusLetter, type ChangedFile, type DiffMode } from "../text/diff.ts";
+import { renderDiffLines } from "./diff-html.ts";
+import type { DiffFileView, GitStatus } from "../git/git.ts";
+import type { ChangeIndex } from "../live/live.ts";
+import { detectLanguage, highlightLines, type HighlightLanguage } from "../../../lib/highlight.ts";
 import { FOLDER_ICON, iconHref, languageOf, SPRITE, type IconSpec } from "./icons.ts";
 import { renderMarkdown } from "./markdown.ts";
-import { encodePath } from "./paths.ts";
+import { encodePath } from "../files/paths.ts";
 import { BROWSE_CSS } from "./styles.ts";
 
 const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
@@ -36,16 +38,6 @@ function iconMarkup(spec: IconSpec, hidden = false): string {
 	return `<svg class="browse-cat ${spec.colorClass}"${hidden ? " hidden" : ""} aria-hidden="true" title="${escapeHtml(spec.label)}"><use href="${iconHref(spec.icon)}"/></svg>`;
 }
 
-/** The header's git chip: the branch, or the detached head; changes are the changes chip's job. */
-function renderGit(git: GitStatus | undefined): string {
-	if (!git) return "";
-	const name = git.branch ?? git.head;
-	if (!name) return "";
-	const glyph = git.branch ? GLYPHS.branch : GLYPHS.detached;
-	const aria = git.branch ? `git branch ${git.branch}` : `git detached at ${git.head ?? ""}`;
-	return `<span class="bf-chip browse-git" title="${escapeHtml(aria)}" aria-label="${escapeHtml(aria)}"><span class="browse-git__glyph" aria-hidden="true">${escapeHtml(glyph)}</span><span class="browse-git__name">${escapeHtml(name)}</span></span>`;
-}
-
 /**
  * The changed-path index for markers, plus the totals shown in the chip. It is
  * the same index the live status feed sends, so the page and its updates agree
@@ -66,55 +58,6 @@ function changeMark(summary: ChangeSummary | undefined, rel: string, isDir: bool
 		: "";
 }
 
-/** The live chrome a page renders: how often its stream is sent a frame. */
-export interface LivePage {
-	intervalMs: number;
-}
-
-/**
- * The header's connection chip. It starts hidden and says "connecting": the
- * client reveals and paints it from the event stream, so a page with JS off — or
- * with live status disabled — never shows a state it cannot keep true.
- *
- * It is deliberately not a `role="status"` region: the header is where a reader
- * looks for the page's state, not a place to announce every change to it.
- */
-function renderLiveChip(live: LivePage | undefined): string {
-	if (!live) return "";
-	return `<span class="bf-chip bf-chip--accent browse-live" id="live-state" title="Live status from the browse server" data-interval="${live.intervalMs}" hidden><span class="browse-live__glyph" aria-hidden="true">${escapeHtml(GLYPHS.browse)}</span><span class="browse-live__text">connecting</span></span>`;
-}
-
-/**
- * The footer's live line, hidden until the first frame: uptime and requests are
- * server facts the rendered page does not know at build time.
- */
-function renderLiveStatus(): string {
-	return `<span class="browse-live-line" id="live-status" hidden></span>`;
-}
-
-/**
- * The header's changes chip, linking to the diff overview. With live status on,
- * a hidden shell is always rendered so the chip can appear and disappear as the
- * working tree changes, without the client inserting elements into the header.
- */
-function renderChanges(summary: ChangeSummary | undefined, live: LivePage | undefined): string {
-	const count = summary?.count ?? 0;
-	if (count <= 0) {
-		return live
-			? `<a class="bf-chip browse-diff" id="browse-changes" href="/diff" title="View uncommitted changes" hidden></a>`
-			: "";
-	}
-	const label = `${count} change${count === 1 ? "" : "s"}`;
-	const insertions = summary?.insertions ?? 0;
-	const deletions = summary?.deletions ?? 0;
-	const totals =
-		insertions + deletions > 0
-			? ` <span class="browse-diff-totals"><span class="browse-diff-add">+${insertions}</span> <span class="browse-diff-del">−${deletions}</span></span>`
-			: "";
-	const aria = `${label} against HEAD${insertions + deletions > 0 ? `, ${insertions} insertions and ${deletions} deletions` : ""}`;
-	return `<a class="bf-chip browse-diff" id="browse-changes" href="/diff" title="View uncommitted changes" aria-label="${escapeHtml(aria)}"><span class="browse-diff__dot" aria-hidden="true">●</span>${escapeHtml(label)}${totals}</a>`;
-}
-
 function hrefFor(entry: { rel: string; isDir: boolean }): string {
 	return entry.isDir ? `/browse/${encodePath(entry.rel)}` : `/view/${encodePath(entry.rel)}`;
 }
@@ -157,7 +100,7 @@ ${SPRITE}
   ${renderGit(layout.git)}
   ${renderChanges(layout.summary, layout.live)}
   <span class="bf-chip bf-chip--accent">read-only</span>
-  ${renderLiveChip(layout.live)}
+  ${renderLiveChrome(layout.live)}
   <button type="button" class="bf-btn bf-btn--icon browse-keys-btn" id="keys-open" aria-label="Keyboard shortcuts" title="Keyboard shortcuts">?</button>
   ${themeToggle()}
 </div><div class="browse-progress" aria-hidden="true"><span class="browse-progress__fill" id="progress-fill"></span></div></header>
@@ -339,8 +282,14 @@ function pageKeys(...extra: KeyHint[]): KeyHint[] {
 	];
 }
 
-/** The card-head controls: Markdown mode, line wrapping, and copy actions. */
-function renderFileActions(page: FilePage): string {
+/** Whether the page renders lines with a number beside them: plain text, or raw Markdown. */
+function numberedLines(page: FilePage): boolean {
+	return page.file.kind === "text" || (page.file.kind === "markdown" && page.markdownRaw === true);
+}
+
+/** The card-head controls: Markdown mode, line wrapping, and the copy actions,
+ * plus the download the diff head keeps in the same group. */
+function renderFileActions(page: FilePage, download: string): string {
 	const isMarkdown = page.file.kind === "markdown";
 	const rawHref = `/raw/${encodePath(page.rel)}`;
 	const viewHref = `/view/${encodePath(page.rel)}`;
@@ -359,7 +308,7 @@ function renderFileActions(page: FilePage): string {
 			: `<a class="bf-segmented__item" href="${viewHref}?raw=1">raw</a>`;
 		groups.push(`<span class="bf-segmented" role="group" aria-label="Markdown view">${rendered}${raw}</span>`);
 	}
-	if (page.file.kind === "text" || (isMarkdown && page.markdownRaw)) {
+	if (numberedLines(page)) {
 		groups.push(
 			`<button type="button" class="bf-btn" id="wrap-toggle" aria-pressed="false" title="Toggle line wrapping">wrap</button>`,
 		);
@@ -372,7 +321,12 @@ function renderFileActions(page: FilePage): string {
 	groups.push(
 		`<button type="button" class="bf-btn" data-copy="path" data-value="${escapeHtml(page.rel)}" title="Copy the root-relative path">copy path</button>`,
 	);
-	return `<span class="bf-card__actions">${groups.join("")}</span>`;
+	if (numberedLines(page)) {
+		groups.push(
+			`<button type="button" class="bf-btn" id="copy-reference" disabled title="Select lines in the file first">copy reference</button>`,
+		);
+	}
+	return `<span class="bf-card__actions">${groups.join("")}${download}</span>`;
 }
 
 /** Render a file page (text, Markdown, image, binary, or over-size). */
@@ -384,14 +338,15 @@ export function renderFilePage(page: FilePage): string {
 	// about the file; the language label, size, and date are the useful metadata.
 	const meta = `${spec.label} · ${formatSize(page.file.size)} · ${formatDate(page.file.mtimeMs)}`;
 	const download = `<a class="bf-btn" href="/raw/${encodePath(page.rel)}" download>download</a>`;
-	const head = `<div class="bf-card__head">${iconMarkup(spec)}<h1 class="bf-card__title">${escapeHtml(name)}</h1><span class="bf-card__meta">${escapeHtml(meta)}</span><span class="bf-spacer"></span>${renderFileActions(page)}${download}</div>`;
+	const head = `<div class="bf-card__head">${iconMarkup(spec)}<h1 class="bf-card__title">${escapeHtml(name)}</h1><span class="bf-card__meta">${escapeHtml(meta)}</span><span class="bf-spacer"></span>${renderFileActions(page, download)}</div>`;
 
 	const isMarkdown = page.file.kind === "markdown";
 	const rendered = isMarkdown && !page.markdownRaw;
-	const wrappable = page.file.kind === "text" || (isMarkdown && page.markdownRaw);
+	const numbered = numberedLines(page);
 	const keys = pageKeys(
 		...(isMarkdown ? [{ keys: "r", label: "Toggle rendered and raw" }] : []),
-		...(wrappable ? [{ keys: "u", label: "Toggle line wrapping" }] : []),
+		...(numbered ? [{ keys: "u", label: "Toggle line wrapping" }] : []),
+		...(numbered ? [{ keys: "y", label: "Copy a reference to the selected lines" }] : []),
 	);
 
 	let content: string;
@@ -403,7 +358,7 @@ export function renderFilePage(page: FilePage): string {
 			});
 			content = `<article class="bf-md">${html}</article>`;
 		} else {
-			content = `<pre class="bf-code bf-code--numbered"><code>${renderCodeLines(page.file.lines, language)}</code></pre>`;
+			content = `<pre class="bf-code bf-code--numbered" data-path="${escapeHtml(page.rel)}"><code>${renderCodeLines(page.file.lines, language)}</code></pre>`;
 		}
 		if (page.file.truncated)
 			note = `<p class="bf-note">Showing the first ${page.file.lines.length} of ${page.file.totalLines} lines.</p>`;
@@ -447,87 +402,6 @@ function statusWord(letter: string): string {
 	return STATUS_LABEL[letter] ?? "changed";
 }
 
-/**
- * The inner HTML per diff line. Hunk bodies are highlighted by rebuilding the
- * old side (context + deleted) and the new side (context + added), so the
- * tokenizer carries state within a hunk; meta, hunk, and note lines stay plain.
- * State does not cross hunks, since the unchanged lines between them are absent.
- */
-function highlightDiffText(lines: DiffLine[], language?: HighlightLanguage): string[] {
-	if (!language) return lines.map((line) => escapeHtml(line.text));
-	const out: string[] = new Array(lines.length);
-	let index = 0;
-	while (index < lines.length) {
-		const kind = lines[index].kind;
-		if (kind !== "ctx" && kind !== "add" && kind !== "del") {
-			out[index] = escapeHtml(lines[index].text);
-			index++;
-			continue;
-		}
-		const start = index;
-		const oldDoc: string[] = [];
-		const newDoc: string[] = [];
-		while (index < lines.length) {
-			const body = lines[index].kind;
-			if (body !== "ctx" && body !== "add" && body !== "del") break;
-			if (body === "ctx") {
-				oldDoc.push(lines[index].text);
-				newDoc.push(lines[index].text);
-			} else if (body === "add") {
-				newDoc.push(lines[index].text);
-			} else {
-				oldDoc.push(lines[index].text);
-			}
-			index++;
-		}
-		const oldHtml = highlightLines(oldDoc, language);
-		const newHtml = highlightLines(newDoc, language);
-		let oldIndex = 0;
-		let newIndex = 0;
-		for (let cursor = start; cursor < index; cursor++) {
-			const body = lines[cursor].kind;
-			if (body === "ctx") {
-				out[cursor] = newHtml[newIndex];
-				newIndex++;
-				oldIndex++;
-			} else if (body === "add") {
-				out[cursor] = newHtml[newIndex];
-				newIndex++;
-			} else {
-				out[cursor] = oldHtml[oldIndex];
-				oldIndex++;
-			}
-		}
-	}
-	return out;
-}
-
-/** Render unified-diff lines with a two-column gutter and per-kind styling. */
-export function renderDiffLines(lines: DiffLine[], language?: HighlightLanguage): string {
-	const html = highlightDiffText(lines, language);
-	// Every hunk is a section so its sticky header is bounded by its own body;
-	// the section also gives the keyboard a stable, non-sticky scroll target.
-	const out: string[] = [];
-	let hunks = 0;
-	let open = false;
-	lines.forEach((line, index) => {
-		if (line.kind === "hunk") {
-			if (open) out.push("</span>");
-			hunks += 1;
-			out.push(`<span class="bf-diff-hunk" id="hunk-${hunks}" data-hunk="${hunks}">`);
-			open = true;
-		}
-		const sign = line.kind === "add" ? "+" : line.kind === "del" ? "-" : line.kind === "ctx" ? " " : "";
-		const gutter = `<span class="browse-diff-no" aria-hidden="true">${line.oldNo ?? ""}</span><span class="browse-diff-no" aria-hidden="true">${line.newNo ?? ""}</span>`;
-		const marker = `<span class="browse-diff-sign" aria-hidden="true">${sign}</span>`;
-		out.push(
-			`<span class="bf-code__line bf-diff-line bf-diff-line--${line.kind}">${gutter}${marker}${html[index]}</span>`,
-		);
-	});
-	if (open) out.push("</span>");
-	return out.join("");
-}
-
 /** The scope label for a mode. */
 function modeScope(mode: DiffMode): string {
 	if (mode === "staged") return "staged vs HEAD";

package/extensions/file-browse/{icons.ts → view/icons.ts}

@@ -5,7 +5,7 @@
  */
 
 import { extname } from "node:path";
-import { IMAGE_EXTENSIONS } from "./files.ts";
+import { IMAGE_EXTENSIONS } from "../files/files.ts";
 
 export type IconName = "folder" | "file-code" | "file-text" | "file-image" | "file-json" | "file-archive" | "file";
 

package/extensions/file-browse/{live-client.ts → view/live-client.ts}

@@ -9,6 +9,12 @@
  *
  * It does nothing at all unless the server rendered the connection chip, which
  * is what makes `live: false` and JS-off leave the page exactly as it was.
+ *
+ * The folder check is the other half: the stream is shared by every open page, so
+ * it cannot say what *this* page's rows show. A page that lists a folder carries
+ * the revision of what it drew, and asks the server for the folder's current one
+ * once per interval; a difference reveals a reload control instead of touching
+ * the document, because a reload is the only honest way to add a row.
  */
 
 export const LIVE_CLIENT_JS = `	// Live status: one event stream feeds the header chips, the tree and listing
@@ -19,9 +25,14 @@ export const LIVE_CLIENT_JS = `	// Live status: one event stream feeds the heade
 		var liveLine = document.getElementById("live-status");
 		var liveGit = document.querySelector(".browse-git");
 		var liveChanges = document.getElementById("browse-changes");
-		var liveInterval = Number(liveChip.getAttribute("data-interval")) || 3000;
+		var liveInterval = Number(liveChip.getAttribute("data-interval")) || 5000;
 		var liveStale = 0;
 		var liveTone = "";
+		var liveRev = "";
+		var liveDir = liveChip.getAttribute("data-dir");
+		var liveDirRev = liveChip.getAttribute("data-rev");
+		var liveReload = document.getElementById("reload-hint");
+		var liveDirTimer = 0;
 
 		function formatSpan(ms) {
 			var seconds = Math.max(0, Math.round(ms / 1000));
@@ -88,7 +99,12 @@ export const LIVE_CLIENT_JS = `	// Live status: one event stream feeds the heade
 			});
 		}
 
+		// One revision covers the chip and the markers: a frame that did not move the
+		// change set is not painted at all, so a tick on an idle tree costs no DOM
+		// work however many rows the page drew.
 		function paintLiveChanges(changes) {
+			if (changes && changes.rev === liveRev) return;
+			liveRev = changes && changes.rev ? changes.rev : "";
 			var count = changes ? changes.count : 0;
 			if (liveChanges) {
 				liveChanges.hidden = count <= 0;
@@ -136,6 +152,32 @@ export const LIVE_CLIENT_JS = `	// Live status: one event stream feeds the heade
 			paintLiveChanges(snapshot.changes);
 		}
 
+		// The folder the page drew, checked against the disk on the frame cadence. It
+		// waits for the first frame, never runs in a hidden tab, and stops as soon as
+		// it has something to say: the control is the fix, and a reload ends the
+		// question.
+		function showLiveReload() {
+			window.clearInterval(liveDirTimer);
+			liveDirTimer = 0;
+			if (!liveReload || !liveReload.hidden) return;
+			liveReload.hidden = false;
+			liveReload.addEventListener("click", function () { window.location.reload(); });
+		}
+
+		function checkLiveDir() {
+			if (document.hidden || liveTone !== "success") return;
+			fetch("/api/dir-rev?path=" + encodeURIComponent(liveDir))
+				.then(function (response) {
+					if (!response.ok) throw new Error("check failed");
+					return response.json();
+				})
+				.then(function (answer) {
+					var rev = answer.rev;
+					if (typeof rev === "string" && rev !== liveDirRev) showLiveReload();
+				})
+				.catch(function () { /* the stream already reports a dead server */ });
+		}
+
 		if (window.EventSource) {
 			var liveStream = new EventSource("/events");
 			liveStream.addEventListener("open", function () {
@@ -152,7 +194,11 @@ export const LIVE_CLIENT_JS = `	// Live status: one event stream feeds the heade
 			window.addEventListener("pagehide", function () {
 				liveStream.close();
 				window.clearTimeout(liveStale);
+				window.clearInterval(liveDirTimer);
 			});
+			if (liveDir !== null && liveDirRev && liveReload) {
+				liveDirTimer = window.setInterval(checkLiveDir, liveInterval);
+			}
 		}
 	}
 `;

package/extensions/file-browse/{markdown.ts → view/markdown.ts}

@@ -25,8 +25,8 @@
  * policy and raw HTML do not.
  */
 
-import { decodeCodePoint, escapeHtml } from "../../lib/escape.ts";
-import { fenceLanguage, highlightLines } from "../../lib/highlight.ts";
+import { decodeCodePoint, escapeHtml } from "../../../lib/escape.ts";
+import { fenceLanguage, highlightLines } from "../../../lib/highlight.ts";
 import {
 	closesSuppressed,
 	closeHtmlSink,
@@ -126,8 +126,8 @@ function createContext(baseDir: string, defs: Map<string, LinkDefinition>, html:
 	};
 }
 
-/** Fold a reference label the way CommonMark does: trim, collapse, case-fold. */
-function normalizeLabel(label: string): string {
+/** Fold a reference label the way CommonMark does: trim, collapse, case-fold. Not `lib/session-label.ts`, which names a session. */
+function referenceLabel(label: string): string {
 	return label.trim().replace(/\s+/g, " ").toLowerCase();
 }
 
@@ -180,7 +180,7 @@ function collectDefinitions(lines: string[], html: boolean): { defs: Map<string,
 			body.push(line);
 			continue;
 		}
-		const key = normalizeLabel(match[1]);
+		const key = referenceLabel(match[1]);
 		if (!defs.has(key)) {
 			const dest = match[2].startsWith("<") && match[2].endsWith(">") ? match[2].slice(1, -1) : match[2];
 			defs.set(key, { dest, title: match[3] });
@@ -630,11 +630,11 @@ function parseReferenceLink(text: string, start: number, ctx: Context): ParsedLi
 		const end = matchBracket(text, close + 1);
 		if (end !== -1) {
 			const raw = text.slice(close + 2, end);
-			const def = ctx.defs.get(normalizeLabel(raw === "" ? label : raw));
+			const def = ctx.defs.get(referenceLabel(raw === "" ? label : raw));
 			if (def) return { label, dest: def.dest, title: def.title, end: end + 1 };
 		}
 	}
-	const def = ctx.defs.get(normalizeLabel(label));
+	const def = ctx.defs.get(referenceLabel(label));
 	if (def) return { label, dest: def.dest, title: def.title, end: close + 1 };
 	return undefined;
 }

package/extensions/file-browse/{raw-html.ts → view/raw-html.ts}

@@ -25,7 +25,7 @@
  * how `<details>` wraps Markdown.
  */
 
-import { decodeCodePoint, escapeHtml } from "../../lib/escape.ts";
+import { decodeCodePoint, escapeHtml } from "../../../lib/escape.ts";
 import { resolveImage, resolveLink } from "./urls.ts";
 
 /** Elements re-emitted with sanitized attributes. */

package/extensions/file-browse/{styles.ts → view/styles.ts}

@@ -12,7 +12,7 @@ import {
 	WEB_COMPONENTS_CSS,
 	WEB_LAYOUT_CSS,
 	WEB_THEME_CSS,
-} from "../../lib/web/index.ts";
+} from "../../../lib/web/index.ts";
 
 /** The shared shell, components, and the page-only `browse-*` rules. */
 export const BROWSE_CSS = `${WEB_BASE_CSS}
@@ -37,7 +37,6 @@ ${WEB_COMPONENTS_CSS}
 .browse-dotfile .bf-table__name a{opacity:.72}
 .browse-broken{color:var(--muted);text-decoration:line-through}
 .browse-link-mark{color:var(--muted);font-size:var(--fs-xs)}
-.browse-when{display:none}
 body.palette-open{overflow:hidden}
 .browse-diff{font-family:var(--font-mono);gap:5px}
 .browse-diff:hover{color:var(--accent);text-decoration:none}
@@ -47,6 +46,8 @@ body.palette-open{overflow:hidden}
    swap only changes the colour, and the footer line reads as one muted clause. */
 .browse-live{font-family:var(--font-mono);border:1px solid currentColor;border-radius:var(--radius-pill);padding:2px 10px}
 .browse-live__glyph{font-size:9px;line-height:1}
+.browse-reload{border:1px solid currentColor;border-radius:var(--radius-pill);padding:2px 10px;cursor:pointer;font-family:var(--font-mono)}
+.browse-reload:hover{text-decoration:underline}
 .browse-live-line{color:var(--muted);font-variant-numeric:tabular-nums}
 .browse-live-line::after{content:" · "}
 .browse-diff-totals{font-family:var(--font-mono)}
@@ -91,8 +92,24 @@ body.palette-open{overflow:hidden}
 .browse-measure .bf-md>*{max-width:var(--browse-measure);margin-inline:auto}
 /* Tables start at the prose column and take only the gutter to its right, so a
    wide window widens them without a dead band on their left. Code stays inside
-   the measure with the rest of the prose. */
-.browse-measure .bf-md>.md-table-frame{max-width:none;padding-left:var(--browse-gutter)}
+   the measure with the rest of the prose. The frame is also the container a
+   squeezed table asks about: it is the pane, not the window, that narrows one. */
+.browse-measure .bf-md>.md-table-frame{max-width:none;padding-left:var(--browse-gutter);container-type:inline-size}
+/* A table spans the reading column rather than stopping at its own content: a
+   shrink-wrapped table leaves a ragged band beside itself — 254px on a 2560px
+   screen, and 300px beside the three-column tables at 1440 — which the reader
+   cannot tell from a column that failed to draw. The card is wider than the text
+   it holds, so the measure is the ceiling: a table ends where the prose does, and
+   below the floor's threshold the minimum still wins and the wrapper scrolls. */
+.browse-measure .bf-md .md-table-frame table{width:100%;max-width:var(--browse-measure)}
+/* In a pane this narrow, auto layout gives the prose cell whatever an unbreakable
+   code span leaves — one word per line, and a four-column table read as a
+   300px-tall row. A floor on the cells makes the table wider than the pane
+   instead, so every column keeps a readable width and the wrapper scrolls them;
+   a table that still fits is left as it was. */
+@container (max-width:600px){
+.browse-measure .bf-md .md-table-frame td{min-width:14em}
+}
 /* A table wider than the pane scrolls, but an overlay scrollbar is invisible
    until it moves; a gradient on the frame marks the columns still out of view.
    It has to be the frame: the scroller clips its own content, so a pseudo-element
@@ -114,10 +131,19 @@ body.palette-open{overflow:hidden}
 .browse-side .bf-tree{flex:1 1 auto;min-height:0;overflow:auto}
 }
 @media (max-width:820px){
-.browse-root{order:9;flex:1 1 100%;direction:ltr;text-align:left}
+.browse-root{order:9;flex:1 1 100%}
 }
 @media (max-width:520px){
 .bf-toolbar .bf-theme-toggle{margin-left:auto}
+/* A phone has no room for four button rows above the file: the actions keep one
+   line and scroll instead, so the document starts where it should. A control
+   keeps its own width — shrunk, a label wraps and a segmented control clips. */
+.bf-card__actions{max-width:100%;flex-wrap:nowrap;overflow-x:auto}
+.bf-card__actions>*{flex:0 0 auto}
+/* A trailing date or one-word change state costs the column a reader is choosing
+   between: at 390px the listing gave the name 106px and every entry truncated,
+   and the diff gave a path 140px while "modified" held 130. */
+.browse-listing .bf-table__when,.browse-diff .browse-diff-word{display:none}
 }
 /* A printed page scrolls nothing: the card and its body open up, the pinned hunk
    header stops pinning, and the progress hairline belongs to the screen. */

package/extensions/file-browse/{tree.ts → view/tree.ts}

@@ -8,7 +8,7 @@
  * intent, and the one row the keyboard is on.
  */
 
-import { SIDEBAR_COLLAPSE_MAX } from "../../lib/web/index.ts";
+import { SIDEBAR_COLLAPSE_MAX } from "../../../lib/web/index.ts";
 
 export const TREE_CLIENT_JS = `	var tree = document.querySelector("nav.bf-tree");
 	var filter = document.getElementById("filter");

package/extensions/file-browse/{urls.ts → view/urls.ts}

@@ -14,7 +14,7 @@
  */
 
 import { posix } from "node:path";
-import { encodePath } from "./paths.ts";
+import { encodePath } from "../files/paths.ts";
 
 const HAS_SCHEME = /^[a-zA-Z][a-zA-Z0-9+.-]*:/;
 const SAFE_LINK_SCHEME = /^(?:https?|mailto):/i;

package/extensions/file-read/schema.ts

@@ -3,10 +3,11 @@
  */
 
 import { Type, type Static } from "typebox";
+import { READ_DOC_TOOL } from "../../lib/tool-names.ts";
 import type { FormatId } from "./formats.ts";
 
 /** The tool's registered name, shared by the definition and its renderer. */
-export const TOOL_NAME = "read_doc";
+export const TOOL_NAME = READ_DOC_TOOL;
 
 export const MIN_CHARS = 200;
 export const MAX_CHARS = 100_000;

package/extensions/goal/plan-route.ts

@@ -19,7 +19,8 @@
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { isPursuedGoal } from "../../lib/goal-state.ts";
-import { PLAN_CONSENT, requestPlanMode } from "../../lib/plan-entry.ts";
+import { isRemoteTurn, remoteLanguage } from "../../lib/interaction.ts";
+import { PLAN_CONSENT, PLAN_CONSENT_SHORT, PLAN_CONSENT_SHORT_ZH, requestPlanMode } from "../../lib/plan-entry.ts";
 import { isPlanModeEnabled } from "../../lib/plan-state.ts";
 import { PLAN_ENTER_TOOL } from "../../lib/tool-names.ts";
 import type { Goal, GoalStatus } from "./types.ts";
@@ -45,7 +46,12 @@ export async function goalPhase(
 	if (!options.ask || !ctx.hasUI) return "active";
 	// Do not ask about a phase this session cannot enter.
 	if (!pi.getAllTools().some((tool) => tool.name === PLAN_ENTER_TOOL)) return "active";
-	const approved = await ctx.ui.confirm(PLAN_ASK, PLAN_CONSENT);
+	const consent = isRemoteTurn(ctx)
+		? remoteLanguage(ctx) === "zh"
+			? PLAN_CONSENT_SHORT_ZH
+			: PLAN_CONSENT_SHORT
+		: PLAN_CONSENT;
+	const approved = await ctx.ui.confirm(PLAN_ASK, consent);
 	if (!approved) return "active";
 	return (await requestPlanMode(pi, ctx)) ? "planning" : "active";
 }