@shivaedev/work-board 0.15.0 → 0.17.0

package/dist/server/workspace.d.ts

@@ -0,0 +1,222 @@
+import { Context, Effect, FileSystem, Path, type PlatformError } from "effect";
+import type { Changes } from "#server/files/changes.ts";
+import type { Snapshot } from "#server/search/snapshot.ts";
+export interface WorkspaceOptions {
+    readonly changes: Changes;
+    readonly home?: string | undefined;
+    readonly index: Effect.Effect<Snapshot, PlatformError.PlatformError>;
+    readonly root: string;
+    readonly writable: boolean;
+}
+export interface WorkspaceSettings extends Omit<WorkspaceOptions, "index"> {
+    readonly realRoot: string;
+}
+declare const WorkspaceConfig_base: Context.ServiceClass<WorkspaceConfig, "WorkBoard/WorkspaceConfig", WorkspaceOptions>;
+export declare class WorkspaceConfig extends WorkspaceConfig_base {
+}
+export declare const Workspace: Context.Service<"WorkBoard/Workspace", Readonly<{
+    readonly document: (url: string) => Effect.Effect<{
+        readonly diagnostics: readonly {
+            readonly field?: string | undefined;
+            readonly line: number;
+            readonly message: string;
+        }[];
+        readonly file: string;
+        readonly identity?: string | undefined;
+        readonly links: {
+            readonly [x: string]: string;
+        };
+        readonly metadata: {
+            readonly areas?: readonly string[] | undefined;
+            readonly attention?: readonly {
+                readonly id: string;
+                readonly kind: "blocker" | "decision" | "review";
+                readonly managed?: boolean | undefined;
+                readonly reason: string;
+                readonly responseFrom: readonly string[];
+                readonly state: "closed" | "open";
+                readonly unblocks: readonly string[];
+            }[] | undefined;
+            readonly criteria?: readonly {
+                readonly id: string;
+                readonly text: string;
+            }[] | undefined;
+            readonly evidence?: readonly {
+                readonly checkedRevision?: string | undefined;
+                readonly criterion?: string | undefined;
+                readonly method?: string | undefined;
+                readonly observedAt?: string | undefined;
+                readonly outcome?: string | undefined;
+                readonly source: string;
+            }[] | undefined;
+            readonly handoff?: {
+                readonly by?: string | undefined;
+                readonly constraints: string;
+                readonly goal: string;
+                readonly item: string;
+                readonly nextAction: string;
+                readonly note?: string | undefined;
+                readonly preparedAt: number;
+                readonly recipient: string;
+                readonly reviewedRevision: string;
+                readonly source: string;
+                readonly state: "acknowledged" | "rejected" | "requested" | "unavailable";
+            } | undefined;
+            readonly id?: string | undefined;
+            readonly items?: readonly string[] | undefined;
+            readonly kind?: "board" | "decision" | "goal" | "handoff" | "investigation" | "project" | "question" | "report" | "response" | "result" | "task" | undefined;
+            readonly nextAction?: string | undefined;
+            readonly options?: readonly {
+                readonly description: string;
+                readonly label: string;
+            }[] | undefined;
+            readonly owner?: string | undefined;
+            readonly question?: {
+                readonly deadline: number;
+                readonly item: string;
+                readonly reason: string;
+                readonly registeredAt: number;
+                readonly request: string;
+                readonly reviewedRevision: string;
+                readonly source: string;
+            } | undefined;
+            readonly recommended?: string | undefined;
+            readonly relationships?: readonly {
+                readonly kind: "depends_on" | "implements" | "informs" | "relates_to";
+                readonly target: string;
+            }[] | undefined;
+            readonly requestReceipt?: {
+                readonly disposition: "applied" | "superseded";
+                readonly question: string;
+                readonly recordedAt: number;
+                readonly response?: string | undefined;
+                readonly reviewedRevision: string;
+            } | undefined;
+            readonly response?: {
+                readonly answers?: readonly {
+                    readonly prompt: string;
+                    readonly selected: readonly string[];
+                    readonly text: string;
+                }[] | undefined;
+                readonly author: string;
+                readonly question: string;
+                readonly recordedAt: number;
+                readonly reviewedRevision: string;
+                readonly supersedes?: string | undefined;
+                readonly type: "answer" | "clarify" | "not_now";
+            } | undefined;
+            readonly status?: string | undefined;
+        };
+        readonly modified: number;
+        readonly questionActions: {
+            readonly [x: string]: string;
+        };
+        readonly reading?: {
+            readonly backlinks: readonly {
+                readonly href: string;
+                readonly kind: string;
+                readonly label: string;
+                readonly status?: string | undefined;
+                readonly title?: string | undefined;
+            }[];
+            readonly board: boolean;
+            readonly claims: {
+                readonly [x: string]: readonly {
+                    readonly href?: string | undefined;
+                    readonly label: string;
+                }[];
+            };
+            readonly evidenceSources: readonly {
+                readonly href?: string | undefined;
+                readonly problem: string;
+            }[];
+            readonly lines: {
+                readonly [x: string]: number;
+            };
+            readonly proseLine: number;
+            readonly raw?: string | undefined;
+            readonly receipts: {
+                readonly [x: string]: {
+                    readonly disposition: "applied" | "superseded";
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly response?: string | undefined;
+                    readonly reviewedRevision: string;
+                };
+            };
+        } | undefined;
+        readonly referenceDetails?: {
+            readonly [x: string]: {
+                readonly status?: string | undefined;
+                readonly title: string;
+            };
+        } | undefined;
+        readonly references: {
+            readonly [x: string]: string;
+        };
+        readonly requests: readonly {
+            readonly id: string;
+            readonly open: boolean;
+            readonly options?: readonly {
+                readonly description: string;
+                readonly label: string;
+            }[] | undefined;
+            readonly preview?: {
+                readonly context: string;
+                readonly id: string;
+                readonly item: string;
+                readonly reason: string;
+                readonly request: string;
+                readonly reviewedRevision: string;
+                readonly source: string;
+            } | undefined;
+            readonly prompts?: readonly {
+                readonly id: string;
+                readonly mode: "many" | "one" | "text";
+                readonly options: readonly {
+                    readonly id: string;
+                    readonly source: string;
+                }[];
+                readonly source: string;
+            }[] | undefined;
+            readonly promptUnavailable?: string | undefined;
+            readonly recommended?: string | undefined;
+            readonly responses?: readonly {
+                readonly body: string;
+                readonly id: string;
+                readonly response: {
+                    readonly answers?: readonly {
+                        readonly prompt: string;
+                        readonly selected: readonly string[];
+                        readonly text: string;
+                    }[] | undefined;
+                    readonly author: string;
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly reviewedRevision: string;
+                    readonly supersedes?: string | undefined;
+                    readonly type: "answer" | "clarify" | "not_now";
+                };
+            }[] | undefined;
+            readonly sourceOpen?: boolean | undefined;
+            readonly title?: string | undefined;
+            readonly unavailable?: string | undefined;
+        }[];
+        readonly source: string;
+        readonly unavailable: readonly string[];
+        readonly writable: boolean;
+    }, import("@shivaedev/platform/errors/taxonomy.ts").Conflict | import("@shivaedev/platform/errors/taxonomy.ts").NotFound | PlatformError.PlatformError | import("@shivaedev/platform/errors/taxonomy.ts").ServiceUnavailable, never>;
+    readonly index: () => Effect.Effect<Snapshot, PlatformError.PlatformError, never>;
+    readonly settings: () => Effect.Effect<{
+        changes: Changes;
+        home?: string | undefined;
+        root: string;
+        writable: boolean;
+        realRoot: string;
+    }, never, never>;
+}>> & {
+    readonly layer: import("effect/Layer").Layer<"WorkBoard/Workspace", never, FileSystem.FileSystem | Path.Path | WorkspaceConfig>;
+};
+export type Workspace = typeof Workspace.Identifier;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

package/dist/server/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/server/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAI/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;;AAED,qBAAa,eAAgB,SAAQ,oBAAiF;CAAG;AAEzH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAbH,OAAO;eACT,MAAM,GAAG,SAAS;cAEnB,MAAM;kBACF,OAAO;;;;;CA2BzB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,UAAU,CAAC"}

package/dist/server/workspace.js

@@ -0,0 +1,25 @@
+import { Context, Effect, FileSystem, Path } from "effect";
+import { defineService } from "@shivaedev/effect-service/define-service.ts";
+import { readDocument } from "#server/document/read.ts";
+export class WorkspaceConfig extends Context.Service()("WorkBoard/WorkspaceConfig") {
+}
+export const Workspace = defineService({
+    id: "WorkBoard/Workspace",
+    initialize: Effect.gen(function* () {
+        return yield* WorkspaceConfig;
+    }),
+    methods: ({ index, ...options }) => {
+        const settings = { ...options, realRoot: options.changes.realRoot };
+        const read = readDocument(settings);
+        function document(url) {
+            return Effect.flatMap(index, (snapshot) => read(url, snapshot));
+        }
+        return {
+            document,
+            index: () => index,
+            settings: () => Effect.succeed(settings),
+        };
+    },
+    requires: [WorkspaceConfig, FileSystem.FileSystem, Path.Path],
+});
+//# sourceMappingURL=workspace.js.map

package/dist/server/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/server/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAsB,MAAM,QAAQ,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAE5E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAgBxD,MAAM,OAAO,eAAgB,SAAQ,OAAO,CAAC,OAAO,EAAqC,CAAC,2BAA2B,CAAC;CAAG;AAEzH,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC;IACtC,EAAE,EAAE,qBAAqB;IACzB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,eAAe,CAAC;IAC/B,CAAC,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,SAAS,QAAQ,CAAC,GAAW;YAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,OAAO;YACN,QAAQ;YACR,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;YAClB,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;SACxC,CAAC;IACH,CAAC;IACD,QAAQ,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC;CAC7D,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/work-board",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Serve a folder of markdown files as a live local page that updates in place when a file changes",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/work-board#readme",
   "bugs": {
@@ -77,13 +77,7 @@
       "default": "./dist/integration/metadata.js"
     },
     "./package.json": "./package.json",
-    "./browser/react/*": null,
     "./browser/views/now.ts": null,
-    "./browser/entry.ts": null,
-    "./browser/fieldFeedback.ts": null,
-    "./browser/reconcile/*": null,
-    "./browser/legacyRuntime.ts": null,
-    "./browser/session.ts": null,
     "./browser/handoffs/*": null,
     "./browser/responses/*": null,
     "./browser/handoffs/schema.ts": {
@@ -378,9 +372,7 @@
       "import": "./dist/client/document/*.js",
       "default": "./dist/client/document/*.js"
     },
-    "./rpc/server.ts": null,
     "./rpc/HandlerOptions.ts": null,
-    "./rpc/PageUrl.ts": null,
     "./http/boardRoutes.ts": null,
     "./http/rpcPolicy.ts": null,
     "./page/escape.ts": {
@@ -389,9 +381,6 @@
       "import": "./dist/browser/escapeHtml.js",
       "default": "./dist/browser/escapeHtml.js"
     },
-    "./page/boardHtml.ts": null,
-    "./page/documentHtml.ts": null,
-    "./rpc/transport.ts": null,
     "./browser/document/layout.ts": null,
     "./browser/document/Details.ts": null,
     "./browser/document/ReadingContext.ts": {
@@ -400,28 +389,8 @@
       "import": "./dist/browser/document/ReadingContext.js",
       "default": "./dist/browser/document/ReadingContext.js"
     },
-    "./diagnostics/script.ts": null,
-    "./history/script.ts": null,
-    "./page/sidebarScript.ts": null,
-    "./page/searchResultsScript.ts": null,
-    "./page/swap.ts": null,
-    "./page/visualViewport.ts": null,
-    "./page/stateScript.ts": null,
-    "./page/searchScript.ts": null,
-    "./page/visualScript.ts": null,
-    "./page/itemContextScript.ts": null,
-    "./page/libraryScript.ts": null,
-    "./page/ageScript.ts": null,
-    "./page/navigationScript.ts": null,
-    "./page/readingStateScript.ts": null,
-    "./page/formReadingScript.ts": null,
-    "./page/diagrams.ts": null,
-    "./page/client.ts": null,
-    "./views/savedScript.ts": null,
     "./document/answerBody.ts": null,
-    "./document/answerCardsHtml.ts": null,
-    "./document/requestTitle.ts": null,
-    "./browser/document/sourceGroups.ts": null
+    "./document/requestTitle.ts": null
   },
   "bin": {
     "work-board": "./dist/server/cli.js"
@@ -442,7 +411,7 @@
   "dependencies": {
     "@shivaedev/effect-contract": "0.5.1",
     "@shivaedev/effect-service": "0.3.0",
-    "@shivaedev/platform": "0.14.2",
+    "@shivaedev/platform": "0.14.4",
     "mdast-util-directive": "3.1.1",
     "mermaid": "12.1.0",
     "react": "19.3.0",
@@ -465,9 +434,9 @@
     "@shivaedev/effect-react": "0.4.1",
     "@shivaedev/effect-test": "0.5.0",
     "@shivaedev/quality": "0.23.0",
-    "@shivaedev/test-story": "0.5.0",
+    "@shivaedev/test-story": "0.6.0",
     "@tailwindcss/vite": "4.3.3",
-    "@tanstack/react-router": "1.170.41",
+    "@tanstack/react-router": "1.170.42",
     "@types/hast": "3.0.5",
     "@types/mdast": "4.0.4",
     "@types/node": "24.19.2",
@@ -501,7 +470,7 @@
   },
   "scripts": {
     "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc --project tsconfig.build.json && pnpm build:browser",
-    "build:browser": "esbuild src/client/entry.ts --bundle --platform=browser --format=esm --conditions=source --minify --banner:js='/* @shivaedev/work-board native browser bundle */' --outfile=assets/native.js && esbuild src/server/responses/agent-cli.ts --bundle --platform=node --format=esm --conditions=source --minify --outfile=assets/agent.js && vite build",
+    "build:browser": "esbuild src/server/responses/agent-cli.ts --bundle --platform=node --format=esm --conditions=source --minify --outfile=assets/agent.js && vite build",
     "ready": "pnpm typecheck && pnpm test && pnpm build",
     "test": "pnpm test:prepare && vitest run",
     "test:prepare": "pnpm build:browser",

package/src/browser/views/remaining.ts

@@ -1,5 +1,4 @@
 import { Schema } from "effect";
-import { Document, DocumentRequest } from "#browser/document/schema.ts";
 import { HandoffPreview, HandoffReading } from "#browser/handoffs/schema.ts";
 import { DiagnosticsSnapshot } from "#diagnostics/daemonContract.ts";
 
@@ -11,8 +10,6 @@ export const StartProjection = Schema.Struct({
 	templates: Schema.Array(Schema.Struct({ file: Schema.String, label: Schema.String, source: Schema.String })),
 });
 export type StartProjection = typeof StartProjection.Type;
-export const RespondProjection = Schema.Struct({ document: Document, request: DocumentRequest });
-export type RespondProjection = typeof RespondProjection.Type;
 export const HandoffProjection = Schema.Struct({
 	background: Schema.String,
 	goal: Schema.String,

package/src/client/document/Mermaid.ts

@@ -1,4 +1,5 @@
-import { createElement, useCallback, useEffect, useId, useRef, useState } from "react";
+import { createElement, useCallback, useContext, useEffect, useId, useRef, useState } from "react";
+import { ThemeContext } from "#client/react/ThemeContext.ts";
 import { mermaidColor } from "./mermaidColor.ts";
 
 const drawings = new Map<string, { readonly source: string; readonly svg: string }>();
@@ -8,17 +9,10 @@ const MAX_DRAWINGS = 30;
 type Drawing = { readonly source: string; readonly svg: string } | { readonly source: string; readonly error: string };
 
 export function Mermaid({ source }: { readonly source: string }) {
+	const theme = useContext(ThemeContext);
 	const id = useId().replace(/[^a-z\d_-]/giu, "");
-	const [drawing, setDrawing] = useState<Drawing | undefined>(() => drawings.get(`${document.documentElement.dataset.scheme ?? "light"}:${source}`));
+	const [drawing, setDrawing] = useState<Drawing | undefined>(() => drawings.get(`${theme}:${source}`));
 	const previousSourceRef = useRef(source);
-	const [theme, setTheme] = useState(() => document.documentElement.dataset.scheme ?? "light");
-	useEffect(() => {
-		function sync() {
-			setTheme(document.documentElement.dataset.scheme ?? "light");
-		}
-		document.addEventListener("board-theme", sync);
-		return () => document.removeEventListener("board-theme", sync);
-	}, []);
 	useEffect(() => {
 		if (previousSourceRef.current !== source) {
 			for (const [key, value] of drawings) {

package/src/client/document/View.ts

@@ -7,7 +7,7 @@ import { Age } from "#client/react/Age";
 import { documentHeadings } from "#render/documentHeadings.ts";
 import { documentLinks } from "#render/documentLinks.ts";
 import { documentPlugins } from "#render/documentPlugins.ts";
-import { footnoteIds } from "#render/footnotes.ts";
+import { footnoteIds } from "#render/footnoteIds.ts";
 import { boardLayout } from "./boardLayout.ts";
 import { DetailStatesContext, DocumentDetails } from "./Details.ts";
 import { highlightDocument } from "./highlight.ts";

package/src/client/react/BoardShell.tsx

@@ -1,7 +1,7 @@
 import { useRouterState } from "@tanstack/react-router";
 import { Option } from "effect";
 import type * as AtomRegistry from "effect/reactivity/AtomRegistry";
-import { useEffect, useState } from "react";
+import { useCallback, useContext, useEffect, useState } from "react";
 import { useQuery } from "@shivaedev/effect-react/result-state.ts";
 import type { BrowserClient } from "#client/client.ts";
 import { navigationQuery } from "#client/page/routeQuery.ts";
@@ -14,10 +14,13 @@ import { MainLocationContext, useMainLocation } from "./MainLocationContext.ts";
 import { emptyMainLocation, type MainLocation } from "./mainLocation.ts";
 import { PhoneNavigation } from "./PhoneNavigation.tsx";
 import { ReadingLibrary } from "./ReadingLibrary.tsx";
+import { ReadingReadyContext, readingReady } from "./ReadingReadyContext.ts";
 import { SearchDialog } from "./SearchDialog.tsx";
+import { SessionContext } from "./SessionContext.ts";
 import type { ShellApi } from "./ShellApi.ts";
 import { Sidebar } from "./Sidebar.tsx";
 import { shellIds } from "./shellIds.ts";
+import { ThemeContext } from "./ThemeContext.ts";
 import { UpdatesToggle } from "./UpdatesToggle.tsx";
 import { useAppearance } from "./useAppearance.ts";
 import { useBoardNavigation } from "./useBoardNavigation.ts";
@@ -33,42 +36,52 @@ export interface ShellOptions {
 }
 export function BoardShell(options: ShellOptions) {
 	const [main, onPage] = useState(emptyMainLocation);
+	const appearance = useAppearance();
+	const [element, setElement] = useState<HTMLElement | null>(null);
+	const report = useCallback((next: HTMLElement, ready: boolean) => {
+		setElement((current) => {
+			if (ready) {
+				return next;
+			}
+			return current === next ? null : current;
+		});
+	}, []);
 	return (
 		<MainLocationContext.Provider value={main}>
-			<BoardWorkspace {...options} onPage={onPage} />
+			<ReadingReadyContext.Provider value={{ element, report }}>
+				<SessionContext.Provider value={options.client}>
+					<ThemeContext.Provider value={appearance.scheme}>
+						<BoardWorkspace {...options} appearance={appearance} onPage={onPage} />
+					</ThemeContext.Provider>
+				</SessionContext.Provider>
+			</ReadingReadyContext.Provider>
 		</MainLocationContext.Provider>
 	);
 }
-function BoardWorkspace(options: ShellOptions & { readonly onPage: (location: MainLocation) => void }) {
-	const { api, ready, client, onPage } = options;
+function BoardWorkspace(
+	options: ShellOptions & { readonly appearance: ReturnType<typeof useAppearance>; readonly onPage: (location: MainLocation) => void },
+) {
+	const { api, ready, client, onPage, appearance } = options;
 	const main = useMainLocation();
-	const appearance = useAppearance();
 	const sidebar = useSidebar(appearance);
-	const status = useBoardNavigation(options);
+	const [phoneOpen, setPhoneOpen] = useState(false);
+	const closeCurrentDestination = useCallback(() => {
+		sidebar.close();
+		setPhoneOpen(false);
+	}, [sidebar.close]);
+	const status = useBoardNavigation(options, closeCurrentDestination);
 	const search = useSearchDialog();
 	const [libraryOpen, setLibraryOpen] = useState(false);
 	const location = useRouterState({ select: (state) => state.location });
 	const query = useQuery(navigationQuery(api), { keepPreviousData: true });
 	const data = Option.getOrUndefined(query.data);
+	const { element } = useContext(ReadingReadyContext);
 	useEffect(() => {
-		function start() {
-			const doc = document.getElementById("doc");
-			const context = doc?.querySelector<HTMLElement>(".item-context");
-			if (data && main.route && (!context || context.dataset.readingReady === "true")) {
-				ready?.();
-			}
-		}
-		start();
-		document.addEventListener("board-reading-ready", start);
-		return () => {
-			document.removeEventListener("board-reading-ready", start);
-		};
-	}, [ready, data, main]);
-	useEffect(() => {
-		if (data) {
-			document.dispatchEvent(new Event("board-index-change"));
+		const doc = document.getElementById("doc");
+		if (data && main.route && doc && readingReady(doc, element)) {
+			ready?.();
 		}
-	}, [data]);
+	}, [ready, data, main, element]);
 	const live = client ? (
 		<LiveControls client={client} navigationFailed={Option.isSome(query.cause)} navigationPending={query.pending} />
 	) : (
@@ -109,7 +122,7 @@ function BoardWorkspace(options: ShellOptions & { readonly onPage: (location: Ma
 							updates={client ? <UpdatesToggle client={client} /> : null}
 						/>
 						<FleetMain api={api} home={data?.home} onPage={onPage} url={location.pathname + location.searchStr} />
-						<PhoneNavigation main={main} openSearch={search.show} />
+						<PhoneNavigation main={main} more={phoneOpen} onMoreChange={setPhoneOpen} openSearch={search.show} />
 					</div>
 				</div>
 				{Option.isSome(query.cause) && <p role="status">Navigation refresh failed. Your displayed files are retained.</p>}

package/src/client/react/DocumentAttention.tsx

@@ -1,5 +1,6 @@
 import type { Document } from "#browser/document/schema.ts";
 import { fileUrl } from "#files/url.ts";
+import { responseUrl } from "#responses/url.ts";
 import { keyed } from "./keyed.ts";
 import { Reference } from "./Reference.tsx";
 export function DocumentAttention({ document }: { readonly document: Document }) {
@@ -28,9 +29,7 @@ function Request({ document, index }: { readonly document: Document; readonly in
 		document.metadata.attention?.filter((entry) => entry.id === request.id).length === 1
 			? `attention-request-${request.id}`
 			: `attention-record-${index}`;
-	const respond = document.requests.some((entry) => entry.id === request.id && entry.open)
-		? `#answer-card-${request.id}`
-		: `/_board/respond?item=${encodeURIComponent(document.metadata.id ?? "")}&request=${encodeURIComponent(request.id)}`;
+	const respond = responseUrl(document.metadata.id ?? "", request.id);
 	const targets = request.unblocks.map((target, targetIndex) => (
 		<span key={target}>
 			{targetIndex > 0 && ", "}

package/src/client/react/DocumentContext.tsx

@@ -1,13 +1,15 @@
-import { useEffect, useLayoutEffect, useRef, useState } from "react";
+import { useContext, useEffect, useLayoutEffect, useRef, useState } from "react";
 import type { Document } from "#browser/document/schema.ts";
 import { Tabs } from "#client/react/components/ui/Tabs.tsx";
 import { Age } from "./Age.tsx";
 import { DocumentMetadata } from "./DocumentMetadata.tsx";
 import { DocumentSource } from "./DocumentSource.tsx";
 import { useMainLocation } from "./MainLocationContext.ts";
+import { ReadingReadyContext } from "./ReadingReadyContext.ts";
 
 export function DocumentContext({ document: data }: { readonly document: Document }) {
 	const page = useMainLocation();
+	const { report } = useContext(ReadingReadyContext);
 	const [headings, setHeadings] = useState<readonly { readonly id: string; readonly title: string; readonly depth: number }[]>([]);
 	const contextRef = useRef<HTMLElement>(null);
 	const [tab, setTab] = useState("details");
@@ -42,9 +44,9 @@ export function DocumentContext({ document: data }: { readonly document: Documen
 		if (count !== headings.length) {
 			return;
 		}
-		context.dataset.readingReady = "true";
-		document.dispatchEvent(new Event("board-reading-ready"));
-	}, [headings]);
+		report(context, true);
+		return () => report(context, false);
+	}, [headings, report]);
 	const tabs = [
 		{ content: <Outline headings={headings} />, label: "Details", value: "details" },
 		{ content: <SourcePanel document={data} />, label: "Source", value: "source" },

package/src/client/react/LiveControls.tsx

@@ -1,7 +1,7 @@
 import { useAtomValue } from "@effect/atom-react";
 import { Option } from "effect";
 import * as Atom from "effect/reactivity/Atom";
-import { useEffect, useMemo } from "react";
+import { useMemo } from "react";
 import { useQuery } from "@shivaedev/effect-react/result-state.ts";
 import type { BrowserClient } from "#client/client.ts";
 import { activeRead } from "./activeRead.ts";
@@ -35,19 +35,6 @@ export function LiveControls({
 		waiting: navigationPending || reading.pending,
 		watching,
 	});
-	useEffect(
-		() =>
-			client.registry.subscribe(
-				client.updates.paused,
-				(value) => {
-					if (!value) {
-						document.dispatchEvent(new Event("board-updates-resumed"));
-					}
-				},
-				{ immediate: true },
-			),
-		[client],
-	);
 	return (
 		<span
 			className="font-mono text-muted-foreground text-xs data-[state=down]:text-destructive data-[state=stale]:text-destructive"