wiki-viewer 1.13.2 → 1.14.1

package/.next/standalone/.pi/ownership.json

@@ -0,0 +1,3 @@
+{
+  "claims": []
+}

package/.next/standalone/TODO.md

@@ -2,3 +2,19 @@
 <!-- pi-todo-md:schema=1 -->
 
 ## Tasks
+
+## Agent Presence (Theme 2)
+- [ ] Live agent orb — drifting pastel orb in editor margin when agent holds Tier-2 write lock on current doc. Poll /api/agent/files/{path} collab-state or reuse presence heartbeat; render orb anchored to the active block position. Use gradient-orb pastel tokens (mint/peach/lavender). Hover = agent id + op type + elapsed time. <!-- pi-todo-md:id=1 -->
+  - note: Source of truth for "is agent active here": X-Collab-State header from /api/agent/files/{path} (active/tracked/untracked). Owner UI should poll this for currently-open file. No new backend needed, just a frontend polling hook + orb component. Wow ★★★★ / effort M.
+- [ ] Watch-mode — when another agent is editing the open doc, auto-poll the event-stream (SSE or poll /api/agent/activity?file=) and apply incoming proof-span diffs to the TipTap view in near-real-time. Toggle: <!-- pi-todo-md:id=2 -->
+  - note: Toggle button in editor toolbar: "Watch live" on/off. SSE from /api/agent/events or poll /api/agent/activity?file=&since=. Render incoming proof-spans as fading highlights before they settle. Prereq: verify event-log completeness (not GC'd mid-session). Wow ★★★★ / effort M.
+- [x] Activity newsfeed — replace the current raw activity panel with an editorial changelog. Each entry: agent avatar chip + human-readable summary ("Claude appended 3 blocks to notes.md · 2 pending your review") + relative timestamp. Group by file. Link to pending proof-spans. Data already exists in /api/agent/activity. Wow ★★★ / effort S. <!-- pi-todo-md:id=3 -->
+
+## Local Wiki Graph
+- [ ] Mini force-graph in backlinks panel — add a "Graph" tab alongside the existing backlinks list. Render a small D3/vis-network force graph: current doc = center node, backlinkers + outgoing [[links]] = surrounding nodes, edges = link direction. Click node = navigate. Backlinks panel + wikilink parser both already exist; missing piece = graph renderer + outgoing-links API endpoint. Wow ★★★★ / effort M. <!-- pi-todo-md:id=4 -->
+- [x] Outgoing links API — new /api/wiki/outlinks?path= endpoint: parse [[wikilinks]] from a file using remark-wikilinks, return list of {slug, resolved_path, exists} entries. Needed by the graph tab. remark-wikilinks.ts already parses them; need to expose via HTTP + resolve slugs against the file index. Effort S. <!-- pi-todo-md:id=5 -->
+
+## Comment on Share
+- [ ] Share comment DB schema — add share_comments table to shared.db: id, share_token, body (text), author_name (nullable, visitor-supplied), created_at, status (pending|approved|rejected). Owner-only read/approve/reject via /api/share/[token]/comments (auth-gated). Visitors POST via public /api/share/[token]/comment (rate-limited, no auth). Wow ★★★★ / effort M. <!-- pi-todo-md:id=6 -->
+- [ ] Share page comment UI — comment box at the bottom of the share viewer page. Name field (optional) + body textarea + submit. Pending state: 'Sent for review'. Rate-limit feedback. No JS framework gymnastics — simple form submit or fetch POST. <!-- pi-todo-md:id=7 -->
+- [ ] Owner comment inbox — notification badge on shared-links panel when there are pending comments. Inline approve/reject with the comment body shown. On approve: comment becomes visible on the share page to all future visitors. On reject: silently dropped. <!-- pi-todo-md:id=8 -->

package/.next/standalone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-viewer",
-  "version": "1.13.2",
+  "version": "1.14.1",
   "description": "Local file viewer and wiki — view markdown, HTML, PDFs, notebooks, office docs, and more from any directory",
   "license": "MIT",
   "type": "module",
@@ -19,6 +19,7 @@
     "wiki": "node bin/wiki-viewer.js",
     "postbuild": "node bin/postbuild.js",
     "prepublishOnly": "npm run build",
+    "prepack": "node -e \"require('fs').existsSync('.next/standalone/server.js')||(console.error('ERROR: .next/standalone/server.js missing, run pnpm build before publishing'),process.exit(1))\"",
     "test": "tsx --import ./src/tests/proof/preload.ts --test src/tests/proof/*.test.ts"
   },
   "engines": {

package/.next/standalone/src/app/api/wiki/outlinks/route.ts

@@ -0,0 +1,76 @@
+export const runtime = "nodejs";
+
+import { NextResponse } from "next/server";
+import { resolveWorkspaceForUser } from "@/lib/workspace-context";
+import { getSearchDb } from "@/lib/search/search-db";
+import { ensureIndexer } from "@/lib/search/indexer";
+
+// Matches [[slug]], [[slug|alias]], [[slug#anchor]] — slug is [a-z0-9-]+
+const WIKILINK_RE = /\[\[([a-z0-9-]+)(?:\|[^\]#|]+|#[a-z0-9-]+)?\]\]/gi;
+
+function slugFromPath(filePath: string): string {
+	const base = filePath.split("/").pop() ?? filePath;
+	return base.replace(/\.md$/i, "").toLowerCase();
+}
+
+export interface OutlinkEntry {
+	slug: string;
+	resolved_path: string | null;
+	exists: boolean;
+}
+
+export async function GET(request: Request) {
+	const ctx = await resolveWorkspaceForUser(request);
+	if (!ctx.ok) return NextResponse.json({ error: ctx.code }, { status: ctx.status });
+
+	const url = new URL(request.url);
+	const filePath = url.searchParams.get("path") ?? "";
+	if (!filePath) {
+		return NextResponse.json({ error: "path required" }, { status: 400 });
+	}
+
+	// Warm indexer in background (same pattern as backlinks route)
+	ensureIndexer(ctx.ws.id, ctx.rootDir).catch((e) =>
+		console.error("[outlinks] ensureIndexer failed", e),
+	);
+
+	const db = getSearchDb();
+
+	// Read body from search index (avoids a file-system read)
+	const row = db
+		.prepare(`SELECT body FROM docs WHERE ws = ? AND path = ?`)
+		.get(ctx.ws.id, filePath) as { body: string } | undefined;
+
+	if (!row) {
+		return NextResponse.json({ error: "file not indexed" }, { status: 404 });
+	}
+
+	// Extract unique slugs from [[wikilinks]]
+	const slugs = new Set<string>();
+	const re = new RegExp(WIKILINK_RE.source, "gi");
+	let match: RegExpExecArray | null;
+	while ((match = re.exec(row.body)) !== null) {
+		if (match[1]) slugs.add(match[1].toLowerCase());
+	}
+
+	if (slugs.size === 0) {
+		return NextResponse.json({ links: [] });
+	}
+
+	// Build slug → path map from indexed .md files (single DB pass)
+	const allMdPaths = db
+		.prepare(`SELECT path FROM docs WHERE ws = ? AND path LIKE '%.md'`)
+		.all(ctx.ws.id) as { path: string }[];
+
+	const pathBySlug = new Map<string, string>();
+	for (const { path } of allMdPaths) {
+		pathBySlug.set(slugFromPath(path), path);
+	}
+
+	const links: OutlinkEntry[] = Array.from(slugs).map((slug) => {
+		const resolved_path = pathBySlug.get(slug) ?? null;
+		return { slug, resolved_path, exists: resolved_path !== null };
+	});
+
+	return NextResponse.json({ links });
+}

package/.next/standalone/src/app/globals.css

@@ -743,12 +743,21 @@ nextjs-portal {
   background: color-mix(in srgb, var(--accent-foreground) 10%, transparent);
   border-bottom-style: solid;
 }
-.wiki-link[data-broken="true"] {
+.wiki-link[data-broken="true"],
+.wiki-link:has([data-broken="true"]) {
+  color: var(--destructive);
+  opacity: 0.6;
+  border-bottom: none;
+  text-decoration: line-through;
+}
+/* ProseMirror wraps text in a span — also target it directly */
+.wiki-link [data-broken="true"] {
+  text-decoration: line-through;
   color: var(--destructive);
-  border-bottom-color: var(--destructive);
-  border-bottom-style: dashed;
 }
-.wiki-link[data-broken="true"]:hover {
+.wiki-link[data-broken="true"]:hover,
+.wiki-link:has([data-broken="true"]):hover {
+  opacity: 1;
   background: color-mix(in srgb, var(--destructive) 10%, transparent);
 }
 
@@ -967,17 +976,6 @@ proof-span.proof-span:hover,
   margin: 1.4em 0 0.35rem;
 }
 
-/* Drop cap on first paragraph */
-[data-skin="editorial"] .tiptap > p:first-child::first-letter {
-  float: left;
-  font-family: var(--font-fraunces), Georgia, serif;
-  font-size: 3.4em;
-  line-height: 0.72;
-  padding: 0.05em 0.12em 0 0;
-  color: var(--primary);
-  font-weight: 600;
-}
-
 [data-skin="editorial"] .tiptap p {
   margin-bottom: 0.75rem;
 }

package/.next/standalone/src/components/ai-panel/activity-row.tsx

@@ -1,69 +1,284 @@
 "use client";
 
-import { memo } from "react";
+import { memo, useEffect, useMemo, useState, type CSSProperties } from "react";
+import { useEditorStore } from "@/stores/editor-store";
+import { wsFetch } from "@/lib/workspace-client";
 import type { ActivityEvent } from "@/lib/proof/activity-shared";
 
-function timeAgo(iso: string): string {
-	const diff = Math.max(0, Date.now() - new Date(iso).getTime());
-	const s = Math.floor(diff / 1000);
-	if (s < 60) return `${s}s ago`;
-	const m = Math.floor(s / 60);
-	if (m < 60) return `${m}m ago`;
-	const h = Math.floor(m / 60);
-	if (h < 24) return `${h}h ago`;
-	return `${Math.floor(h / 24)}d ago`;
+type ReviewCounts = Record<string, number>;
+
+type ActivityGroup = {
+	path: string;
+	filename: string;
+	latestAt: string;
+	events: ActivityEvent[];
+};
+
+function hashString(input: string): number {
+	let hash = 0;
+	for (let i = 0; i < input.length; i += 1) {
+		hash = (hash * 31 + input.charCodeAt(i)) | 0;
+	}
+	return Math.abs(hash);
+}
+
+function agentLabel(agentId: string): string {
+	const raw = agentId.split(/[:/]/).pop() ?? agentId;
+	const compact = raw.replace(/[^a-z0-9]/gi, "");
+	return (compact.slice(0, 2) || raw.slice(0, 2) || "??").toUpperCase();
+}
+
+function agentName(agentId: string): string {
+	const raw = agentId.split(/[:/]/).pop() ?? agentId;
+	return raw.replace(/[-_]+/g, " ").replace(/^./, (c) => c.toUpperCase());
 }
 
-function verbFor(type: string): string {
-	const map: Record<string, string> = {
-		"block.replace": "replaced",
-		"block.insertAfter": "inserted after",
-		"block.insertBefore": "inserted before",
-		"block.delete": "deleted",
-		"block.append": "appended",
-		"block.prepend": "prepended",
-		"comment.add": "commented on",
-		"comment.reply": "replied to comment",
-		"comment.resolve": "resolved comment",
-		"comment.reopen": "reopened comment",
-		"suggestion.add": "suggested",
-		"suggestion.accept": "accepted suggestion",
-		"suggestion.reject": "rejected suggestion",
+function agentChipStyle(agentId: string): CSSProperties {
+	const hue = hashString(agentId) % 360;
+	return {
+		backgroundColor: `hsl(${hue} 72% 42%)`,
+		color: "white",
 	};
-	return map[type] ?? type;
 }
 
-function ActivityRowImpl({ event }: { event: ActivityEvent }) {
-	const filename = event.path.split("/").pop() ?? event.path;
-	const ref = typeof event["ref"] === "string" ? (event["ref"] as string) : "";
+function timeAgo(iso: string): string {
+	const diffSeconds = Math.max(0, Math.round((Date.now() - new Date(iso).getTime()) / 1000));
+	if (diffSeconds < 45) return "just now";
+
+	const steps: Array<[number, Intl.RelativeTimeFormatUnit]> = [
+		[60, "second"],
+		[60, "minute"],
+		[24, "hour"],
+		[7, "day"],
+	];
+	let value = diffSeconds;
+	let unit: Intl.RelativeTimeFormatUnit = "second";
+	for (const [step, nextUnit] of steps) {
+		if (value < step) break;
+		value = Math.floor(value / step);
+		unit = nextUnit;
+	}
+
+	const rtf = new Intl.RelativeTimeFormat("en", { numeric: "always", style: "short" });
+	return rtf.format(-value, unit).replace(/\s+/g, " ").replace(/\./g, "");
+}
+
+function blockCount(event: ActivityEvent): number {
+	if (Array.isArray((event as { refs?: unknown }).refs)) {
+		return ((event as { refs?: unknown[] }).refs ?? []).length;
+	}
+	return typeof (event as { ref?: unknown }).ref === "string" ? 1 : 0;
+}
+
+function summaryFor(event: ActivityEvent): string {
+	const actor = agentName(event.by);
+	const kind = event.type;
+	const count = blockCount(event);
+
+	if (kind === "block.append" || (kind === "block.inserted" && (event as { position?: string }).position === "end")) {
+		return `${actor} appended ${count || 1} block${(count || 1) === 1 ? "" : "s"}`;
+	}
+	if (kind === "block.prepend" || (kind === "block.inserted" && (event as { position?: string }).position === "start")) {
+		return `${actor} prepended ${count || 1} block${(count || 1) === 1 ? "" : "s"}`;
+	}
+	if (kind === "block.inserted") {
+		return `${actor} inserted ${count || 1} block${(count || 1) === 1 ? "" : "s"}`;
+	}
+	if (kind === "block.replaced" || kind === "file.rawWritten") {
+		return `${actor} edited`;
+	}
+	if (kind === "block.deleted") {
+		return `${actor} deleted ${count || 1} block${(count || 1) === 1 ? "" : "s"}`;
+	}
+	if (kind === "suggestion.added") {
+		return `${actor} suggested a change`;
+	}
+	if (kind === "suggestion.accepted") {
+		return `${actor} accepted a suggestion`;
+	}
+	if (kind === "suggestion.rejected") {
+		return `${actor} rejected a suggestion`;
+	}
+	if (kind === "comment.added") {
+		return `${actor} commented`;
+	}
+	if (kind === "comment.replied") {
+		return `${actor} replied`;
+	}
+	if (kind === "comment.resolved") {
+		return `${actor} resolved a comment`;
+	}
+	if (kind === "comment.reopened") {
+		return `${actor} reopened a comment`;
+	}
+	if (kind === "file.externallyEdited") {
+		return `${actor} changed file externally`;
+	}
+	return `${actor} ${kind.replace(/^\w+\./, "").replace(/([a-z])([A-Z])/g, "$1 $2")}`;
+}
+
+function groupActivity(activity: ActivityEvent[]): ActivityGroup[] {
+	const groups = new Map<string, ActivityEvent[]>();
+	for (const event of activity) {
+		const list = groups.get(event.path) ?? [];
+		list.push(event);
+		groups.set(event.path, list);
+	}
+
+	return Array.from(groups.entries())
+		.map(([path, events]) => ({
+			path,
+			filename: path.split("/").pop() ?? path,
+			latestAt: events[0]?.at ?? "",
+			events,
+		}))
+		.sort((a, b) => (a.latestAt < b.latestAt ? 1 : -1));
+}
+
+function isMarkdownPath(path: string): boolean {
+	return /\.(md|markdown)$/i.test(path);
+}
+
+async function fetchReviewCount(path: string): Promise<number> {
+	if (!isMarkdownPath(path)) return 0;
+
+	const endpoints = [`/api/agent/sidecar/${path}`, `/api/agent/files/${path}/pending`, `/api/agent/files/${path}`];
+	for (const endpoint of endpoints) {
+		try {
+			const res = await wsFetch(endpoint);
+			if (!res.ok) continue;
+			const data = (await res.json()) as Record<string, unknown>;
 
+			if (Array.isArray(data.pending)) return data.pending.length;
+			if (Array.isArray(data.events) && endpoint.includes("/pending")) return data.events.length;
+			if (typeof data.pendingCount === "number") return data.pendingCount;
+			if (typeof data.count === "number") return data.count;
+			if (typeof data.total === "number") return data.total;
+			if (Array.isArray(data.suggestions) || Array.isArray(data.comments) || data.blockProvenance) {
+				const suggestions = Array.isArray(data.suggestions)
+					? data.suggestions.filter(
+						(item) => item && typeof item === "object" && (item as { status?: string }).status === "pending",
+					).length
+					: 0;
+				const comments = Array.isArray(data.comments)
+					? data.comments.filter(
+						(item) => item && typeof item === "object" && !(item as { resolved?: boolean }).resolved,
+					).length
+					: 0;
+				const proofSpans = data.blockProvenance && typeof data.blockProvenance === "object"
+					? Object.keys(data.blockProvenance as Record<string, unknown>).length
+					: 0;
+				return suggestions + comments + proofSpans;
+			}
+		} catch {
+			// Ignore fetch errors; review badge stays hidden.
+		}
+	}
+	return 0;
+}
+
+function ActivityItemImpl({ event }: { event: ActivityEvent }) {
 	return (
-		<div className="flex flex-col gap-0.5 py-1.5 border-b border-border/50 last:border-0">
-			<div className="flex items-baseline justify-between gap-2">
-				<span
-					className="text-xs font-mono text-foreground/80 truncate"
-					title={event.path}
-				>
-					{filename}
-				</span>
-				<span className="text-[10px] text-muted-foreground shrink-0">
-					{timeAgo(event.at)}
-				</span>
+		<div className="flex items-start gap-2.5 rounded-md px-2 py-2 hover:bg-background/50">
+			<div
+				className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full text-[10px] font-semibold shadow-sm ring-1 ring-black/5"
+				style={agentChipStyle(event.by)}
+				title={event.by}
+				aria-hidden
+			>
+				{agentLabel(event.by)}
+			</div>
+			<div className="min-w-0 flex-1">
+				<p className="truncate text-xs text-foreground/85">
+					{summaryFor(event)}
+				</p>
+				<p className="truncate text-[10px] text-muted-foreground">{timeAgo(event.at)}</p>
 			</div>
-			<p className="text-[11px] text-muted-foreground truncate">
-				<span className="text-foreground/60">{event.by}</span>{" "}
-				{verbFor(event.type)}
-				{ref && (
-					<>
-						{" "}
-						<span className="font-mono text-[10px] text-muted-foreground/60">{ref}</span>
-					</>
-				)}
-			</p>
 		</div>
 	);
 }
 
-// Memoised: the activity list re-renders on every 10s poll and on any AI-panel
-// state change. Rows only change when their event object changes.
-export const ActivityRow = memo(ActivityRowImpl);
+const ActivityItem = memo(ActivityItemImpl);
+
+function ActivityGroupView({ group, reviewCount }: { group: ActivityGroup; reviewCount: number }) {
+	const loadPage = useEditorStore((s) => s.loadPage);
+	const latest = group.events[0];
+
+	return (
+		<section className="space-y-1.5 rounded-md border border-border/70 bg-background/50 p-2">
+			<div className="flex items-start justify-between gap-2">
+				<button
+					type="button"
+					onClick={() => void loadPage(group.path)}
+					className="min-w-0 text-left"
+					title={group.path}
+				>
+					<p className="truncate text-xs font-medium text-foreground/90">{group.filename}</p>
+					<p className="truncate text-[10px] text-muted-foreground">{group.path}</p>
+				</button>
+				<div className="flex shrink-0 items-center gap-1.5">
+					{reviewCount > 0 && (
+						<button
+							type="button"
+							onClick={() => void loadPage(group.path)}
+							className="inline-flex items-center rounded-full border border-amber-500/40 bg-amber-500/10 px-2 py-0.5 text-[10px] font-medium text-amber-700 hover:bg-amber-500/15"
+							title="Open file for review"
+						>
+							review {reviewCount}
+						</button>
+					)}
+					<span className="text-[10px] text-muted-foreground">{timeAgo(latest.at)}</span>
+				</div>
+			</div>
+			<div className="space-y-0.5">
+				{group.events.map((event) => (
+					<ActivityItem key={`${event.path}-${event.id}`} event={event} />
+				))}
+			</div>
+		</section>
+	);
+}
+
+export function ActivityFeed({ activity }: { activity: ActivityEvent[] }) {
+	const groups = useMemo(() => groupActivity(activity), [activity]);
+	const [reviewCounts, setReviewCounts] = useState<ReviewCounts>({});
+
+	useEffect(() => {
+		let cancelled = false;
+		const paths = Array.from(new Set(groups.map((group) => group.path)));
+		if (paths.length === 0) {
+			setReviewCounts({});
+			return () => {
+				cancelled = true;
+			};
+		}
+
+		void (async () => {
+			const pairs = await Promise.all(
+				paths.map(async (path) => [path, await fetchReviewCount(path)] as const),
+			);
+			if (cancelled) return;
+			setReviewCounts(Object.fromEntries(pairs.filter(([, count]) => count > 0)));
+		})();
+
+		return () => {
+			cancelled = true;
+		};
+	}, [groups]);
+
+	if (groups.length === 0) {
+		return <p className="py-2 text-xs text-muted-foreground/60">No events recorded</p>;
+	}
+
+	return (
+		<div className="space-y-2">
+			{groups.map((group) => (
+				<ActivityGroupView
+					key={group.path}
+					group={group}
+					reviewCount={reviewCounts[group.path] ?? 0}
+				/>
+			))}
+		</div>
+	);
+}

package/.next/standalone/src/components/ai-panel/ai-panel.tsx

@@ -5,7 +5,7 @@ import { X, Copy, Check, Bot, Wifi, ExternalLink } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { useAIPanelStore } from "@/stores/ai-panel-store";
 import { TokenSection } from "./token-section";
-import { ActivityRow } from "./activity-row";
+import { ActivityFeed } from "./activity-row";
 const SKILL_CLI = "npx skills add anh-chu/wiki-viewer/agents/wiki-viewer-skill";
 
 function useCopyCurl(currentPath: string | null) {
@@ -288,14 +288,8 @@ export function AIPanel({ currentPath }: { currentPath?: string | null }) {
 						<h3 className="text-xs font-semibold uppercase tracking-widest text-muted-foreground">
 							Recent Activity
 						</h3>
-						<div className="rounded-md border border-border bg-muted/40 px-3 py-1 max-h-72 overflow-y-auto">
-							{activity.length === 0 ? (
-								<p className="text-xs text-muted-foreground/60 py-2">No events recorded</p>
-							) : (
-								activity.map((ev) => (
-									<ActivityRow key={`${ev.path}-${ev.id}`} event={ev} />
-								))
-							)}
+						<div className="rounded-md border border-border bg-muted/40 px-3 py-2 max-h-72 overflow-y-auto">
+							<ActivityFeed activity={activity} />
 						</div>
 					</section>
 

package/.next/standalone/src/components/editor/backlinks-panel.tsx

@@ -1,9 +1,10 @@
 "use client";
 
 import { useEffect, useState } from "react";
-import { ChevronDown, ChevronRight, Link2 } from "lucide-react";
+import { ChevronDown, ChevronRight, Link2, Unlink } from "lucide-react";
 import { wsFetch } from "@/lib/workspace-client";
 import { useEditorStore } from "@/stores/editor-store";
+import { useWikiSlugsStore } from "@/stores/wiki-slugs-store";
 
 interface BacklinkEntry {
 	path: string;
@@ -16,6 +17,12 @@ function displayPath(filePath: string): string {
 	return parts.length > 1 ? parts.slice(-2).join(" / ") : parts[0] ?? filePath;
 }
 
+/** Last segment sans .md — the wiki slug used for existence checks. */
+function slugFromPath(filePath: string): string {
+	const base = filePath.split("/").pop() ?? filePath;
+	return base.replace(/\.md$/i, "");
+}
+
 interface BacklinksPanelProps {
 	currentPath: string;
 }
@@ -24,6 +31,7 @@ export function BacklinksPanel({ currentPath }: BacklinksPanelProps) {
 	const [backlinks, setBacklinks] = useState<BacklinkEntry[]>([]);
 	const [loading, setLoading] = useState(false);
 	const [collapsed, setCollapsed] = useState(false);
+	const hasSlug = useWikiSlugsStore((s) => s.has);
 
 	useEffect(() => {
 		if (!currentPath) return;
@@ -85,22 +93,44 @@ export function BacklinksPanel({ currentPath }: BacklinksPanelProps) {
 
 				{!collapsed && backlinks.length > 0 && (
 					<ul className="flex flex-col gap-1.5">
-						{backlinks.map((bl) => (
-							<li key={bl.path} className="flex flex-col">
-								<button
-									onClick={() => useEditorStore.getState().loadPage(bl.path)}
-									className="text-left text-[12px] text-primary/70 hover:text-primary hover:underline underline-offset-2 truncate transition-colors"
-									title={bl.path}
-								>
-									{displayPath(bl.path)}
-								</button>
-								{bl.snippet && (
-									<p className="text-[10.5px] text-muted-foreground/50 line-clamp-1 mt-0.5">
-										{bl.snippet}
-									</p>
-								)}
-							</li>
-						))}
+						{backlinks.map((bl) => {
+							const exists = hasSlug(slugFromPath(bl.path));
+							return (
+								<li key={bl.path} className="flex flex-col">
+									<button
+										onClick={() =>
+											exists && useEditorStore.getState().loadPage(bl.path)
+										}
+										className={
+											exists
+												? "text-left text-[12px] text-primary/70 hover:text-primary hover:underline underline-offset-2 truncate transition-colors flex items-center gap-1"
+												: "text-left text-[12px] text-muted-foreground/40 truncate cursor-default flex items-center gap-1"
+										}
+										title={
+											exists
+												? bl.path
+												: `${bl.path} (file not found)`
+										}
+									>
+										{!exists && (
+											<Unlink className="h-2.5 w-2.5 shrink-0 text-muted-foreground/30" />
+										)}
+										{displayPath(bl.path)}
+									</button>
+									{bl.snippet && (
+										<p
+											className={
+												exists
+													? "text-[10.5px] text-muted-foreground/50 line-clamp-1 mt-0.5"
+													: "text-[10.5px] text-muted-foreground/25 line-clamp-1 mt-0.5"
+											}
+										>
+											{bl.snippet}
+										</p>
+									)}
+								</li>
+							);
+						})}
 					</ul>
 				)}
 			</div>

package/.next/standalone/src/components/editor/bubble-menu.tsx

@@ -28,6 +28,8 @@ interface Props {
 	onSuggestEdit?: () => void;
 	/** Open a comment thread on the current selection's block. */
 	onComment?: () => void;
+	/** Hide all formatting controls; show only comment button. */
+	readOnly?: boolean;
 }
 
 type OpenPopover =
@@ -40,7 +42,7 @@ type OpenPopover =
 			anchor: { top: number; left: number };
 	  };
 
-export function EditorBubbleMenu({ editor, onSuggestEdit, onComment }: Props) {
+export function EditorBubbleMenu({ editor, onSuggestEdit, onComment, readOnly }: Props) {
 	const [popover, setPopover] = useState<OpenPopover>(null);
 
 	useEffect(() => {
@@ -127,6 +129,8 @@ export function EditorBubbleMenu({ editor, onSuggestEdit, onComment }: Props) {
 				options={{ placement: "top", offset: 8 }}
 				className="flex items-center gap-0.5 px-1 py-1 bg-popover border border-border rounded-sm shadow-lg"
 			>
+				{!readOnly && (
+				<>
 				<button
 					type="button"
 					className={btn(editor.isActive("bold"))}
@@ -299,6 +303,23 @@ export function EditorBubbleMenu({ editor, onSuggestEdit, onComment }: Props) {
 						</div>
 					)}
 				</div>
+				</>
+				)}
+				{readOnly && onComment && (
+					<button
+						type="button"
+						className={btn(false)}
+						onMouseDown={(e) => e.preventDefault()}
+						onClick={(e) => {
+							e.preventDefault();
+							onComment();
+						}}
+						aria-label="Comment"
+						title="Add comment"
+					>
+						<MessageCircle className="w-3.5 h-3.5" />
+					</button>
+				)}
 			</BubbleMenu>
 
 			{popover?.type === "link" && (