@appsoftwareltd/etherpk-mcp 0.8.3 → 0.8.5

package/dist/main.js

@@ -34,7 +34,7 @@ import { request } from "node:https";
 import { BlockList, isIP } from "node:net";
 var package_default = {
 	name: "@appsoftwareltd/etherpk-mcp",
-	version: "0.8.3",
+	version: "0.8.5",
 	license: "Elastic-2.0",
 	description: "EtherPK Headless Client: an MCP server over a synced knowledge graph, run beside the agent on the user's own machine.",
 	type: "module",
@@ -613,11 +613,12 @@ function createGraphNamePublisher(deps) {
 //#endregion
 //#region ../client/src/lib/sync/sync-api.ts
 var SyncApiError = class extends Error {
-	constructor(message, status, code, retryable = false) {
+	constructor(message, status, code, retryable = false, connectionKind) {
 		super(message);
 		this.status = status;
 		this.code = code;
 		this.retryable = retryable;
+		this.connectionKind = connectionKind;
 	}
 };
 function createSyncApi(deps) {
@@ -637,7 +638,7 @@ function createSyncApi(deps) {
 			const body = await res.json().catch(() => null);
 			const nested = typeof body?.error === "object" && body.error !== null ? body.error : null;
 			const code = nested?.code ?? body?.code;
-			throw new SyncApiError(nested?.message ?? body?.code ?? `HTTP ${res.status}`, res.status, code, body?.retryable === true);
+			throw new SyncApiError(nested?.message ?? body?.code ?? `HTTP ${res.status}`, res.status, code, body?.retryable === true, deps.kind);
 		}
 		return await res.json();
 	}
@@ -720,7 +721,7 @@ function createSyncApi(deps) {
 	};
 }
 //#endregion
-//#region ../client/src/lib/sync/sync-config.ts
+//#region ../client/src/lib/sync/sync-connections.ts
 /** Derive the `ws(s)://…/sync` relay URL from the server base URL. */
 function relayUrlFrom(serverBaseUrl) {
 	return serverBaseUrl.replace(/\/$/, "").replace(/^http/, "ws") + "/sync";
@@ -2148,19 +2149,31 @@ function flatten(roots) {
 	roots.forEach((root, i) => walk(root, null, i));
 	return rows;
 }
-/** Derive the index rows for a single document's text. Pure. */
-function deriveDoc(text) {
+/**
+* A document's blocks and links, each link tagged with the block holding it, and which block
+* each source line belongs to (the deepest whose own range covers it). The one reading of a
+* document's outline that the index rows and {@link blockConceptChain} share.
+*/
+function blocksAndLinks(text) {
 	const blocks = flatten(parseBlocks(text));
 	const lineToBlock = /* @__PURE__ */ new Map();
 	for (const b of blocks) for (let line = b.startLine; line <= b.endLine; line++) lineToBlock.set(line, b.localId);
-	const links = wikilinkOccurrencesInSource(text).map((occ) => ({
-		concept: occ.concept,
-		line: occ.line,
-		lineText: occ.lineText,
-		matchStart: occ.matchStart,
-		matchEnd: occ.matchEnd,
-		blockLocalId: lineToBlock.get(occ.line) ?? null
-	}));
+	return {
+		blocks,
+		links: wikilinkOccurrencesInSource(text).map((occ) => ({
+			concept: occ.concept,
+			line: occ.line,
+			lineText: occ.lineText,
+			matchStart: occ.matchStart,
+			matchEnd: occ.matchEnd,
+			blockLocalId: lineToBlock.get(occ.line) ?? null
+		})),
+		lineToBlock
+	};
+}
+/** Derive the index rows for a single document's text. Pure. */
+function deriveDoc(text) {
+	const { blocks, links } = blocksAndLinks(text);
 	const candidateTasks = blocks.filter((b) => b.kind === "task");
 	const fenced = candidateTasks.length === 0 ? () => false : fencedLines(text);
 	const taskBlocks = candidateTasks.filter((b) => !fenced(b.startLine));
@@ -2197,6 +2210,17 @@ function deriveDoc(text) {
 */
 function deriveTaskConcepts(blocks, links, taskBlocks) {
 	if (taskBlocks.length === 0) return [];
+	const byBlock = linksByBlock(links);
+	if (byBlock.size === 0) return [];
+	const rows = [];
+	for (const task of taskBlocks) for (const { concept } of conceptChain(blocks, byBlock, task.localId)) rows.push({
+		blockLocalId: task.localId,
+		concept
+	});
+	return rows;
+}
+/** The concepts linked on each block, in the order they are written, by block. */
+function linksByBlock(links) {
 	const byBlock = /* @__PURE__ */ new Map();
 	for (const link of links) {
 		if (link.blockLocalId === null) continue;
@@ -2204,21 +2228,26 @@ function deriveTaskConcepts(blocks, links, taskBlocks) {
 		if (existing) existing.push(link.concept);
 		else byBlock.set(link.blockLocalId, [link.concept]);
 	}
-	if (byBlock.size === 0) return [];
-	const rows = [];
-	for (const task of taskBlocks) {
-		const seen = /* @__PURE__ */ new Set();
-		for (let id = task.localId; id !== null; id = blocks[id]?.parentId ?? null) for (const concept of byBlock.get(id) ?? []) {
-			const key = conceptKey$1(concept);
-			if (seen.has(key)) continue;
-			seen.add(key);
-			rows.push({
-				blockLocalId: task.localId,
-				concept
-			});
-		}
+	return byBlock;
+}
+/**
+* The walk under a [[Task Concept]] (ADR 0051): the concepts linked on block `from`, then on each
+* ancestor up to the root, each named once where it is nearest, whatever its case.
+*/
+function conceptChain(blocks, byBlock, from) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	let depth = 0;
+	for (let id = from; id !== null; id = blocks[id]?.parentId ?? null, depth++) for (const concept of byBlock.get(id) ?? []) {
+		const key = conceptKey$1(concept);
+		if (seen.has(key)) continue;
+		seen.add(key);
+		out.push({
+			concept,
+			depth
+		});
 	}
-	return rows;
+	return out;
 }
 /**
 * The references a document makes BY ITS NAME: every wikilink nested in the concept string, at
@@ -2243,6 +2272,14 @@ function deriveTitleLinks(concept) {
 		matchEnd: occ.matchEnd
 	}));
 }
+/**
+* The [[Task Concept]]s every task in a document has, whatever its outline (ADR 0051): the
+* document's own concept, then the [[Scope]]s in its name, outermost first. The index writes these
+* for every task, and `/kanban` offers them after the block's own (ADR 0113).
+*/
+function documentTaskConcepts(concept) {
+	return [concept, ...deriveTitleLinks(concept).map((link) => link.concept)];
+}
 /** The ancestor labels of a block, root-first (the outline-chain breadcrumb). */
 function ancestorChain(blocks, localId) {
 	const chain = [];
@@ -2742,7 +2779,7 @@ function createSchema(db) {
 	db.exec(SCHEMA$1);
 	db.run("INSERT OR IGNORE INTO index_metadata (key, value) VALUES ('active_generation', 1)");
 	db.run("INSERT OR IGNORE INTO index_metadata (key, value) VALUES ('revision', 0)");
-	db.exec(`PRAGMA user_version = 14`);
+	db.exec(`PRAGMA user_version = 15`);
 }
 function activeIndexGeneration(db) {
 	return db.all("SELECT value FROM index_metadata WHERE key = 'active_generation'")[0]?.value ?? 1;
@@ -2763,7 +2800,7 @@ function advanceIndexRevision(db) {
 */
 function isUsableIndex(db) {
 	try {
-		return db.all("PRAGMA user_version")[0]?.user_version === 14;
+		return db.all("PRAGMA user_version")[0]?.user_version === 15;
 	} catch {
 		return false;
 	}
@@ -2940,13 +2977,17 @@ function insertProperties(db, pageId, doc) {
 * the document's identity. Without that row, filtering to a project page returns nothing for
 * the tasks written directly on it — the case the "Filter to <active tab>" shortcut exists for.
 *
-* Only the document's own concept goes in, never its aliases: the query resolves a filtered
-* name to its page and matches on every name that page answers to, so an alias row here would
-* be redundant now and stale after a rename.
+* The [[Scope]]s in the document's name sit on that root too (ADR 0051, amended 2026-09-29), so
+* the tasks on `[[Acme]] Website` answer to Acme. They come from the same scan that makes such a
+* page a Backlink of its scope (ADR 0083), so a page gives its tasks to exactly the concepts it
+* is a title reference of.
+*
+* Only the names the document is written with go in, never an alias of them: the query resolves
+* a filtered name to its page and matches on every name that page answers to, so an alias row
+* here would be redundant now and stale after a rename.
 */
 function insertTaskConcepts(db, pageId, doc, tasks, taskConcepts) {
 	if (tasks.length === 0) return;
-	const ownKey = conceptKey$1(doc.concept);
 	const written = /* @__PURE__ */ new Set();
 	const write = (blockLocalId, key) => {
 		const seen = `${blockLocalId} ${key}`;
@@ -2958,7 +2999,8 @@ function insertTaskConcepts(db, pageId, doc, tasks, taskConcepts) {
 			key
 		]);
 	};
-	for (const t of tasks) write(t.blockLocalId, ownKey);
+	const rootKeys = documentTaskConcepts(doc.concept).map(conceptKey$1);
+	for (const t of tasks) for (const key of rootKeys) write(t.blockLocalId, key);
 	for (const tc of taskConcepts) write(tc.blockLocalId, conceptKey$1(tc.concept));
 }
 /**
@@ -3843,6 +3885,15 @@ var ORDER_SQL = {
 	due: `(t.due IS NULL), t.due ASC, (t.priority IS NULL), t.priority ASC`
 };
 /**
+* What decides a tie the grouping leaves: the document's name, then the task's line, which a
+* person can see and which survive a rebuild. A folder graph re-derives the whole graph with
+* fresh page ids on any file change, so ordering by page id let equal tasks swap places in the
+* [[Tasks View]] and on a [[Kanban Board]] (ADR 0113) between one refresh and the next.
+* `page_id, block_local_id` come last only to keep the order total, so paging cannot repeat or
+* skip.
+*/
+var TIE_BREAK_SQL = "p.concept_key ASC, t.line ASC, t.page_id ASC, t.block_local_id ASC";
+/**
 * The WHERE clause and parameters shared by {@link tasksMatching} and its count, so the two
 * can never drift into answering different questions about the same filter.
 *
@@ -3911,7 +3962,7 @@ function tasksMatching(db, query, offset, limit) {
                 t.priority, t.waiting, t.doing, t.cancelled, t.due, t.completion, t.scheduled
          FROM tasks t JOIN pages p ON p.id = t.page_id
          WHERE ${predicate.where}
-         ORDER BY ${ORDER_SQL[query.groupBy]}, t.page_id ASC, t.block_local_id ASC
+         ORDER BY ${ORDER_SQL[query.groupBy]}, ${TIE_BREAK_SQL}
          LIMIT ? OFFSET ?`, [
 		...predicate.params,
 		limit + 1,
@@ -3923,30 +3974,35 @@ function tasksMatching(db, query, offset, limit) {
 		hits: [],
 		hasMore: false
 	};
-	const breadcrumbs = breadcrumbsFor(db, page);
+	const ancestry = ancestryFor(db, page);
 	return {
-		hits: page.map((row) => ({
-			...toHit(row),
-			breadcrumb: breadcrumbs.get(row.page_id)?.get(row.block_local_id) ?? []
-		})),
+		hits: page.map((row) => {
+			const found = ancestry.get(row.page_id)?.get(row.block_local_id);
+			return {
+				...toHit(row),
+				breadcrumb: found?.breadcrumb ?? [],
+				parentTask: found?.parentTask ?? null
+			};
+		}),
 		hasMore
 	};
 }
 /**
-* Ancestor labels for a whole page of tasks: one read for every document involved, then the
-* chains walked in JS. The same shape searchText uses, and for the same reason - a recursive
-* SQL walk per row would be one query per task.
+* Ancestor labels for a whole page of tasks, and each task's nearest task ancestor: one read for
+* every document involved, then the chains walked in JS. The same shape searchText uses, and for
+* the same reason - a recursive SQL walk per row would be one query per task.
 */
-function breadcrumbsFor(db, rows) {
+function ancestryFor(db, rows) {
 	const ids = [...new Set(rows.map((row) => row.page_id))];
 	const placeholders = ids.map(() => "?").join(",");
-	const blocks = db.all(`SELECT page_id, local_id, parent_local_id, label FROM blocks WHERE page_id IN (${placeholders})`, ids);
+	const blocks = db.all(`SELECT page_id, local_id, parent_local_id, kind, label FROM blocks WHERE page_id IN (${placeholders})`, ids);
 	const byPage = /* @__PURE__ */ new Map();
 	for (const block of blocks) {
 		let page = byPage.get(block.page_id);
 		if (!page) byPage.set(block.page_id, page = /* @__PURE__ */ new Map());
 		page.set(block.local_id, {
 			parent_local_id: block.parent_local_id,
+			kind: block.kind,
 			label: block.label
 		});
 	}
@@ -3956,10 +4012,24 @@ function breadcrumbsFor(db, rows) {
 		if (!page) continue;
 		let chains = out.get(row.page_id);
 		if (!chains) out.set(row.page_id, chains = /* @__PURE__ */ new Map());
-		chains.set(row.block_local_id, searchBreadcrumb(page, row.block_local_id));
+		chains.set(row.block_local_id, {
+			breadcrumb: searchBreadcrumb(page, row.block_local_id),
+			parentTask: nearestTask(page, row.block_local_id)
+		});
 	}
 	return out;
 }
+/** The label of the nearest ancestor of `localId` that is a task, or null. */
+function nearestTask(blocks, localId) {
+	let parent = blocks.get(localId)?.parent_local_id ?? null;
+	for (let guard = 0; parent !== null && guard <= blocks.size; guard++) {
+		const block = blocks.get(parent);
+		if (!block) break;
+		if (block.kind === "task") return block.label;
+		parent = block.parent_local_id;
+	}
+	return null;
+}
 /** How many tasks match. Uncapped: this counts an indexed join, not a text index. */
 function tasksMatchingCount(db, query) {
 	const predicate = taskPredicate(db, query);
@@ -4270,7 +4340,7 @@ function cacheRoot(env) {
 * recovered from a joined path (see there).
 */
 var CACHE_FILE_NAME = `local-cache.v${CACHE_DB_VERSION}.bin`;
-var INDEX_FILE_NAME = `index.v14.sqlite`;
+var INDEX_FILE_NAME = `index.v15.sqlite`;
 var VECTORS_FILE_NAME = `vectors.v1.sqlite`;
 function cacheFile(dir) {
 	return join(dir, CACHE_FILE_NAME);
@@ -4299,7 +4369,7 @@ async function openCacheDb() {
 	const db = await request$1(indexedDB.open(CACHE_DB, CACHE_DB_VERSION));
 	for (const store of CACHE_STORES) if (!db.objectStoreNames.contains(store)) {
 		db.close();
-		throw new Error(`Local Cache database has no "${store}" store; open the graph cache before restoring it.`);
+		throw new Error(`Local Cache database has no "${store}" store - open the graph cache before restoring it.`);
 	}
 	return db;
 }
@@ -4587,7 +4657,7 @@ function describeGraphStore(store, now = Date.now()) {
 	if (total === 0) return `empty - no passages indexed here yet (snapshot ${age})`;
 	if (embedded >= total) return `up to date - ${count} embedded (snapshot ${age})`;
 	const percent = Math.floor(embedded / total * 100);
-	return ageMs < 9e4 ? `building - ${count} (${percent}%) embedded, snapshot ${age}, refreshed every 30 s while it builds` : `paused - ${count} (${percent}%) embedded, last snapshot ${age}; nothing is building it now, it continues when serve next runs`;
+	return ageMs < 9e4 ? `building - ${count} (${percent}%) embedded, snapshot ${age}, refreshed every 30 s while it builds` : `paused - ${count} (${percent}%) embedded, last snapshot ${age}. Nothing is building it now, it continues when serve next runs`;
 }
 /** Remove every persisted graph under the cache root (logout of the last server). */
 async function removeCacheRoot(env) {
@@ -4784,7 +4854,7 @@ async function setupSemantic(io) {
 	const files = io.files ?? MODEL.files;
 	const status = await semanticSetupStatus(io.env, files);
 	if (!status.runtime) {
-		io.say(`Installing ${RUNTIME.name} ${RUNTIME.version} into ${status.runtimeDir} (about 300 MB; native, so it is not part of the etherpk-mcp package)…`);
+		io.say(`Installing ${RUNTIME.name} ${RUNTIME.version} into ${status.runtimeDir} (about 300 MB - native, so it is not part of the etherpk-mcp package)…`);
 		await mkdir(status.runtimeDir, {
 			recursive: true,
 			mode: 448
@@ -4857,7 +4927,7 @@ async function download(fetchFn, file, path) {
 	const digest = hash.digest("hex");
 	if (digest !== file.sha256) {
 		await rm(temp, { force: true });
-		throw new Error(`${file.name} downloaded with sha256 ${digest}, expected ${file.sha256}; not kept.`);
+		throw new Error(`${file.name} downloaded with sha256 ${digest}, expected ${file.sha256} - not kept.`);
 	}
 	await rename(temp, path);
 }
@@ -4879,7 +4949,7 @@ var SemanticUnavailable = class extends Error {
 		this.name = "SemanticUnavailable";
 	}
 };
-var SETUP_HINT = "run `npx @appsoftwareltd/etherpk-mcp semantic setup` on this computer once (it installs a ~300 MB runtime and a 23 MB model into the cache directory); the next semantic search will use it, no restart needed.";
+var SETUP_HINT = "run `npx @appsoftwareltd/etherpk-mcp semantic setup` on this computer once (it installs a ~300 MB runtime and a 23 MB model into the cache directory) - the next semantic search will use it, no restart needed.";
 /** The thread count `serve` uses: the option, else the environment, else the conservative default. */
 function semanticThreads(env, requested) {
 	if (requested !== void 0) return Math.max(1, Math.floor(requested));
@@ -4900,7 +4970,7 @@ async function loadEmbeddingModel(env, options = {}) {
 		const loaded = await import(pathToFileURL(require.resolve(RUNTIME.name)).href);
 		ort = loaded.default?.InferenceSession ? loaded.default : loaded;
 	} catch (error) {
-		throw new SemanticUnavailable(`The embedding runtime in ${status.runtimeDir} failed to load (${error instanceof Error ? error.message : String(error)}); ${SETUP_HINT}`);
+		throw new SemanticUnavailable(`The embedding runtime in ${status.runtimeDir} failed to load (${error instanceof Error ? error.message : String(error)}): ${SETUP_HINT}`);
 	}
 	const tokenizer = new Tokenizer(JSON.parse(await readFile(join(status.modelDir, "tokenizer.json"), "utf8")), JSON.parse(await readFile(join(status.modelDir, "tokenizer_config.json"), "utf8")));
 	const threads = semanticThreads(env, options.threads);
@@ -6882,7 +6952,7 @@ function readPageDate(doc) {
 	return { issues: [{
 		level: "warning",
 		code: "invalid-date",
-		message: `"${doc.concept}" has \`date: ${String(date)}\`, which is not a calendar day (YYYY-MM-DD); the document is undated.`,
+		message: `"${doc.concept}" has \`date: ${String(date)}\`, which is not a calendar day (YYYY-MM-DD) - the document is undated.`,
 		concept: doc.concept
 	}] };
 }
@@ -6911,7 +6981,7 @@ function readPublicationDefinition(doc) {
 		};
 	}
 	if (doc.kind === "journal") {
-		issue("publication-on-journal", "A journal entry cannot define a publication; use a page.");
+		issue("publication-on-journal", "A journal entry cannot define a publication - use a page.");
 		return {
 			publication: null,
 			issues
@@ -6944,7 +7014,7 @@ function readPublicationDefinition(doc) {
 		else issues.push({
 			level: "warning",
 			code: "publication-invalid-include",
-			message: `Include \`${slot}\` must name the page that fills it; it is ignored.`,
+			message: `Include \`${slot}\` must name the page that fills it - it is ignored.`,
 			concept: doc.concept
 		});
 	}
@@ -7006,7 +7076,7 @@ function discoverPublications(documents) {
 		for (const publication of list) issues.push({
 			level: "error",
 			code: "publication-duplicate-id",
-			message: `Two pages define the publication "${id}" (${list.map((p) => `"${p.concept}"`).join(" and ")}); neither is published until one is changed.`,
+			message: `Two pages define the publication "${id}" (${list.map((p) => `"${p.concept}"`).join(" and ")}) - neither is published until one is changed.`,
 			concept: publication.concept
 		});
 	}
@@ -7043,7 +7113,7 @@ function validateThemeManifest(raw) {
 	const version = typeof data.version === "string" && data.version.trim() !== "" ? data.version.trim() : "0.0.0";
 	const contract = typeof data.contract === "number" && Number.isInteger(data.contract) ? data.contract : null;
 	if (contract === null) errors.push("theme.json needs an integer `contract`, the view version the theme was written for.");
-	else if (contract > 1) errors.push(`The theme was written for view contract ${contract}; this EtherPK writes contract 1. Update EtherPK, or use an older theme.`);
+	else if (contract > 1) errors.push(`The theme was written for view contract ${contract} - this EtherPK writes contract 1. Update EtherPK, or use an older theme.`);
 	const kinds = [];
 	if (Array.isArray(data.kinds)) {
 		for (const k of data.kinds) if (KINDS.has(k)) kinds.push(k);
@@ -10778,6 +10848,27 @@ function dayIsNotAPageName(day) {
 	return `“${day.trim()}” is a date, and a date is the name of that day's journal entry, so a page cannot be called that. Choose a different name.`;
 }
 //#endregion
+//#region ../client/src/lib/document/line-endings.ts
+/** `text` with every `\r\n` and every lone `\r` written as `\n`; `text` itself when it holds no `\r`. */
+function lineFeedsOnly(text) {
+	return text.includes("\r") ? text.replace(/\r\n?/g, "\n") : text;
+}
+/**
+* The changes that turn `text` into {@link lineFeedsOnly}`(text)`, in document order and each
+* against `text` as it is: one per `\r`, deleting it before a `\n` and replacing it with `\n`
+* anywhere else. For a writer that must change a shared text in place rather than replace it,
+* applying them from the last to the first.
+*/
+function lineFeedChanges(text) {
+	const changes = [];
+	for (let at = text.indexOf("\r"); at !== -1; at = text.indexOf("\r", at + 1)) changes.push({
+		from: at,
+		to: at + 1,
+		insert: text[at + 1] === "\n" ? "" : "\n"
+	});
+	return changes;
+}
+//#endregion
 //#region ../client/src/lib/document/wikilink/rename.ts
 /**
 * Rewriting [[Wikilink]] targets across a document's source, for the rewrite arm of a page
@@ -11045,7 +11136,7 @@ var RenameUnconfirmedError = class extends Error {
 	name = "RenameUnconfirmedError";
 	constructor(concepts) {
 		const list = concepts.slice(0, 5).join(", ") + (concepts.length > 5 ? "…" : "");
-		super(`${concepts.length === 1 ? "A document" : `${concepts.length} documents`} the rename would change ${concepts.length === 1 ? "has" : "have"} not finished syncing to this device: ${list}. Nothing was renamed; try again once sync has caught up.`);
+		super(`${concepts.length === 1 ? "A document" : `${concepts.length} documents`} the rename would change ${concepts.length === 1 ? "has" : "have"} not finished syncing to this device: ${list}. Nothing was renamed - try again once sync has caught up.`);
 		this.concepts = concepts;
 	}
 };
@@ -11420,8 +11511,9 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 		}
 		return entries;
 	}
-	function notify(doc, text) {
-		for (const listener of doc.listeners) listener(text);
+	/** Tell an open document's subscribers its text, all but `except` (the editor that made the edit). */
+	function notify(doc, text, except) {
+		for (const listener of doc.listeners) if (listener !== except) listener(text);
 	}
 	/** The frontmatter block of `text`, given its parsed body (`''` when there is none). */
 	function headOf(text, body) {
@@ -11659,7 +11751,7 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 				return doc.target;
 			},
 			getText: () => doc.buffer,
-			applyChange(change, origin = "editor") {
+			applyChange(change, origin = "editor", editor) {
 				doc.buffer = applyTextChange(doc.buffer, change);
 				doc.dirty = true;
 				if (doc.removed) {
@@ -11668,6 +11760,7 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 				}
 				doc.save.call();
 				if (origin === "external") notify(doc, doc.buffer);
+				else if (editor) notify(doc, doc.buffer, editor);
 			},
 			subscribe(listener) {
 				doc.listeners.add(listener);
@@ -11675,12 +11768,12 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 			}
 		};
 		doc.ready = adapter.read(doc.subdir, doc.fileName).then((content) => {
-			doc.buffer = content.text;
+			doc.buffer = lineFeedsOnly(content.text);
 			doc.baseText = content.text;
 			doc.lastModified = content.lastModified;
 			doc.size = content.size;
 			doc.loaded = true;
-			notify(doc, content.text);
+			notify(doc, doc.buffer);
 		}).catch(async (error) => {
 			if (await adapter.exists(doc.subdir, doc.fileName).catch(() => true)) doc.loadError = error;
 			else doc.loaded = true;
@@ -11698,7 +11791,14 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 			return;
 		}
 		if (doc.loaded && entry.lastModified === doc.lastModified && entry.size === doc.size) return;
-		const { text: diskText, lastModified, size } = await adapter.read(doc.subdir, doc.fileName);
+		followDisk(doc, await adapter.read(doc.subdir, doc.fileName));
+	}
+	/**
+	* Bring an open document in line with its file as just read (`reconcileDecision`): nothing
+	* but the stamps when the file is what the buffer last synced with, a reload of a clean buffer,
+	* a conflict over a dirty one.
+	*/
+	function followDisk(doc, { text: diskText, lastModified, size }) {
 		const decision = reconcileDecision({
 			dirty: doc.dirty,
 			baseText: doc.baseText,
@@ -11712,14 +11812,14 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 			return;
 		}
 		if (decision === "reload") {
-			doc.buffer = diskText;
+			doc.buffer = lineFeedsOnly(diskText);
 			doc.baseText = diskText;
 			doc.lastModified = lastModified;
 			doc.size = size;
 			doc.loaded = true;
 			doc.loadError = null;
 			doc.dirty = false;
-			notify(doc, diskText);
+			notify(doc, doc.buffer);
 			emitChange({ concept: conceptOf(doc) });
 			return;
 		}
@@ -11731,6 +11831,53 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 		doc.save.cancel();
 		onConflict?.(doc.conflict);
 	}
+	/** A file's content, or null when it does not exist; any other failure rejects. */
+	async function readIfPresent(subdir, fileName) {
+		try {
+			return await adapter.read(subdir, fileName);
+		} catch (error) {
+			if (await adapter.exists(subdir, fileName).catch(() => true)) throw error;
+			return null;
+		}
+	}
+	/**
+	* A Formatting Scan's fix to an open document (ADR 0109): through the buffer, so the editor
+	* showing it is told, then saved now. The file is read first: an edit made outside the app
+	* since the buffer last synced is followed, a reload or a conflict over unsaved typing, and
+	* the fix is refused rather than saved over it.
+	*/
+	async function spliceOpenDocument(doc, expected, splices) {
+		await doc.ready;
+		await settled(doc);
+		if (doc.removed) return "gone";
+		if (doc.conflict) return "changed";
+		const disk = await readIfPresent(doc.subdir, doc.fileName);
+		if (disk === null || doc.removed) return "gone";
+		if (doc.saving || doc.conflict) return "changed";
+		followDisk(doc, disk);
+		if (doc.conflict || !doc.loaded) return "changed";
+		if (containsCipherFence(doc.buffer)) return "protected";
+		if (doc.buffer !== expected) return "changed";
+		for (let i = splices.length - 1; i >= 0; i--) doc.handle.applyChange(splices[i], "external");
+		await saveNow(doc);
+		return "written";
+	}
+	/** A Formatting Scan's fix to a document nobody has open: read, compare, write (ADR 0109). */
+	async function spliceClosedDocument(entry, expected, splices) {
+		const read = await readIfPresent(entry.subdir, entry.fileName);
+		if (read === null) return "gone";
+		const opened = open.get(entry.key);
+		if (opened) return spliceOpenDocument(opened, expected, splices);
+		if (containsCipherFence(read.text)) return "protected";
+		if (read.text !== expected) return "changed";
+		let text = read.text;
+		for (let i = splices.length - 1; i >= 0; i--) text = applyTextChange(text, splices[i]);
+		const written = await adapter.write(entry.subdir, entry.fileName, text);
+		entry.lastModified = written.lastModified;
+		entry.size = written.size;
+		emitChange({ concept: entry.concept });
+		return "written";
+	}
 	return {
 		open(target) {
 			return openDocNamed(target).handle;
@@ -11785,6 +11932,22 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 				emitRegistryOnly();
 			}
 		},
+		async documentText(target) {
+			const entry = registry.get(conceptKey(target));
+			if (!entry) return null;
+			const doc = open.get(entry.key);
+			if (doc) {
+				await doc.ready;
+				if (doc.loaded) return doc.buffer;
+			}
+			return (await readIfPresent(entry.subdir, entry.fileName))?.text ?? null;
+		},
+		async spliceIfUnchanged(target, expected, splices) {
+			const entry = registry.get(conceptKey(target));
+			if (!entry) return "gone";
+			const doc = open.get(entry.key);
+			return doc ? spliceOpenDocument(doc, expected, splices) : spliceClosedDocument(entry, expected, splices);
+		},
 		onChange(listener) {
 			changed.add(listener);
 			return () => changed.delete(listener);
@@ -11840,13 +12003,13 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 			doc.loadError = null;
 			if (choice === "take-disk") {
 				const { text, lastModified, size } = await adapter.read(doc.subdir, doc.fileName);
-				doc.buffer = text;
+				doc.buffer = lineFeedsOnly(text);
 				doc.baseText = text;
 				doc.lastModified = lastModified;
 				doc.size = size;
 				doc.dirty = false;
 				doc.conflict = null;
-				notify(doc, text);
+				notify(doc, doc.buffer);
 			} else {
 				const res = await adapter.write(doc.subdir, doc.fileName, doc.buffer);
 				doc.baseText = doc.buffer;
@@ -12478,7 +12641,17 @@ function createServerDocumentStore(graph, options) {
 		},
 		getYText(target) {
 			const docId = docIdFor(target);
-			return docId ? graph.docSync(docId).doc.getText("content") : void 0;
+			if (!docId) return void 0;
+			const ytext = graph.docSync(docId).doc.getText("content");
+			const changes = lineFeedChanges(ytext.toString());
+			if (changes.length > 0) ytext.doc.transact(() => {
+				for (let i = changes.length - 1; i >= 0; i--) {
+					const change = changes[i];
+					ytext.delete(change.from, change.to - change.from);
+					if (change.insert) ytext.insert(change.from, change.insert);
+				}
+			}, STORE);
+			return ytext;
 		},
 		async whenReady(target) {
 			const docId = docIdFor(target);
@@ -12780,6 +12953,28 @@ function createServerDocumentStore(graph, options) {
 			registry.set(docId, updated);
 			writeBackIdentity(docId);
 		},
+		async spliceIfUnchanged(docId, expected, splices, spliceOptions) {
+			if (!registry.has(docId)) return "gone";
+			const materialised = await materialise([docId], spliceOptions?.timeoutMs ?? COLD_CONTENT_TIMEOUT_MS);
+			try {
+				if (!registry.has(docId)) return "gone";
+				if (materialised.unconfirmed.length > 0) return "unconfirmed";
+				const ytext = graph.docSync(docId).doc.getText("content");
+				const text = ytext.toString();
+				if (containsCipherFence(text)) return "protected";
+				if (text !== expected) return "changed";
+				ytext.doc.transact(() => {
+					for (let i = splices.length - 1; i >= 0; i--) {
+						const splice = splices[i];
+						if (splice.to > splice.from) ytext.delete(splice.from, splice.to - splice.from);
+						if (splice.insert) ytext.insert(splice.from, splice.insert);
+					}
+				}, STORE);
+				return "written";
+			} finally {
+				materialised.release();
+			}
+		},
 		async reconcile() {},
 		async resolveConflict() {},
 		async createJournal(date, body = "") {
@@ -13506,6 +13701,7 @@ function assembleHeadlessGraph(parts) {
 	};
 	return {
 		graphId: parts.graphId,
+		clientUrl: parts.clientUrl ?? null,
 		name: parts.name,
 		store: parts.store,
 		index,
@@ -13633,6 +13829,7 @@ async function openHeadlessGraph(deps) {
 		}
 		return assembleHeadlessGraph({
 			graphId: deps.graphId,
+			clientUrl: deps.clientUrl ?? null,
 			name: sync.getMeta().name ?? deps.graphId,
 			accessLoss: () => sync.accessLoss(),
 			store: documents,
@@ -13790,7 +13987,7 @@ async function openHeadlessFolder(deps) {
 				for (const conflict of raised) {
 					await store.resolveConflict(conflict.target, "take-disk");
 					saveErrors.delete(conceptKey(conflict.target));
-					warn(`"${conflict.target}" changed on disk while an edit to it could not be written; took the file on disk and discarded the edit.`);
+					warn(`"${conflict.target}" changed on disk while an edit to it could not be written - took the file on disk and discarded the edit.`);
 				}
 			})();
 			const pass = reconciling;
@@ -13969,7 +14166,7 @@ async function openHeadlessFolder(deps) {
 /** The account has no vault yet, so there is nothing for a Recovery Code to open. */
 var NoVaultError = class extends Error {
 	constructor() {
-		super("This account has no encryption keys yet; there is nothing for a Recovery Code to open.");
+		super("This account has no encryption keys yet - there is nothing for a Recovery Code to open.");
 		this.name = "NoVaultError";
 	}
 };
@@ -13985,7 +14182,7 @@ async function openVaultWithRecoveryCode(api, code) {
 	try {
 		return (await openVault(fromBase64Url(stored.vault), wrapKey)).vaultKey;
 	} catch (error) {
-		if (error instanceof EnvelopeError) throw new RecoveryCodeError("That Recovery Code does not open this account’s keys. Check it character by character; only the most recently issued code works.");
+		if (error instanceof EnvelopeError) throw new RecoveryCodeError("That Recovery Code does not open this account’s keys. Check it character by character - only the most recently issued code works.");
 		throw error;
 	}
 }
@@ -14114,7 +14311,7 @@ async function unlockByDeviceApproval(api, io) {
 	const where = io.clientUrl ? `open EtherPK at ${io.clientUrl}` : "open EtherPK in a browser";
 	io.say("");
 	io.say(`To approve this device, ${where} (any page - it need not be a note), connected to this account`);
-	io.say("with its keys unlocked. A prompt will show a code; confirm it matches this one:");
+	io.say("with its keys unlocked. A prompt will show a code - confirm it matches this one:");
 	io.say("");
 	io.say(`    ${request.sas}`);
 	io.say("");
@@ -14337,7 +14534,7 @@ var files = /* @__PURE__ */ Object.assign({
 	"../etherpk-al-folio/assets/theme.js": "/*\n * The light / dark toggle: a `.theme-toggle` button flips the page between the two and the\n * choice is remembered in this browser; with no choice made the page follows the system. The\n * stylesheet keys on `data-theme` on <html>, and shell-top applies the remembered choice before\n * the first paint so a dark reader never sees a light flash.\n */\n(function () {\n    'use strict';\n    var KEY = 'etherpk-theme';\n    var root = document.documentElement;\n    function isDark() {\n        var chosen = root.getAttribute('data-theme');\n        if (chosen === 'dark' || chosen === 'light') return chosen === 'dark';\n        return window.matchMedia('(prefers-color-scheme: dark)').matches;\n    }\n    function apply(theme) {\n        if (theme === 'dark' || theme === 'light') root.setAttribute('data-theme', theme);\n        else root.removeAttribute('data-theme');\n        var buttons = document.querySelectorAll('.theme-toggle');\n        for (var i = 0; i < buttons.length; i++) buttons[i].setAttribute('aria-pressed', isDark() ? 'true' : 'false');\n    }\n    try { apply(localStorage.getItem(KEY)); } catch (_e) { apply(null); }\n    var toggles = document.querySelectorAll('.theme-toggle');\n    for (var i = 0; i < toggles.length; i++) {\n        toggles[i].addEventListener('click', function () {\n            var next = isDark() ? 'light' : 'dark';\n            apply(next);\n            try { localStorage.setItem(KEY, next); } catch (_e) { /* private mode: the choice lasts the page */ }\n        });\n    }\n})();\n",
 	"../etherpk-al-folio/layouts/404.html": "{{> shell-top}}\n        <div class=\"post\">\n            <header class=\"post-header\"><h1 class=\"post-title\">Page not found</h1></header>\n            <div class=\"post-content\">\n                <p>The page you followed a link to is not part of this site. <a href=\"index.html\">Back to {{site.title}}</a>.</p>\n            </div>\n        </div>\n{{> shell-bottom}}\n",
 	"../etherpk-al-folio/layouts/archive.html": "{{> shell-top}}\n        <div class=\"post\">\n            <header class=\"post-header\"><h1 class=\"post-title\">{{#page.isPostsArchive}}posts{{/page.isPostsArchive}}{{#page.isJournalArchive}}journal{{/page.isJournalArchive}}</h1></header>\n            {{#page.isPostsArchive}}\n            {{#site.postsByYear}}\n            <h2 class=\"archive-year\" id=\"y{{year}}\">{{year}}</h2>\n            <ul class=\"post-list archive-list\">\n                {{#posts}}<li><time datetime=\"{{date}}\">{{date}}</time> <a href=\"{{url}}\">{{title}}</a></li>{{/posts}}\n            </ul>\n            {{/site.postsByYear}}\n            {{/page.isPostsArchive}}\n            {{#page.isJournalArchive}}\n            <ul class=\"post-list\">\n                {{#site.journals}}\n                <li>\n                    <h3><a href=\"{{url}}\">{{title}}</a></h3>\n                    {{#excerpt}}<p>{{excerpt}}</p>{{/excerpt}}\n                    <p class=\"post-meta\"><time datetime=\"{{date}}\">{{date}}</time></p>\n                </li>\n                {{/site.journals}}\n            </ul>\n            {{/page.isJournalArchive}}\n        </div>\n{{> shell-bottom}}\n",
-	"../etherpk-al-folio/layouts/home.html": "{{> shell-top}}\n        <article class=\"post about\">\n            <header class=\"post-header\">\n                <h1 class=\"post-title\">{{^page.isGeneratedIndex}}{{{page.titleHtml}}}{{/page.isGeneratedIndex}}{{#page.isGeneratedIndex}}{{site.title}}{{/page.isGeneratedIndex}}</h1>\n            </header>\n            {{^page.isGeneratedIndex}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            {{/page.isGeneratedIndex}}\n            {{#page.isGeneratedIndex}}{{^site.isBlog}}\n            <div class=\"post-content page-contents\">\n{{{page.content}}}\n            </div>\n            {{/site.isBlog}}{{/page.isGeneratedIndex}}\n            {{#site.hasJournals}}\n            <section class=\"news\">\n                <h2><a href=\"journal.html\">news</a></h2>\n                <table class=\"news-table\">\n                    {{#site.journals}}\n                    <tr>\n                        <th scope=\"row\"><time datetime=\"{{date}}\">{{date}}</time></th>\n                        <td><a href=\"{{url}}\">{{title}}</a>{{#excerpt}} <span class=\"news-excerpt\">{{excerpt}}</span>{{/excerpt}}</td>\n                    </tr>\n                    {{/site.journals}}\n                </table>\n            </section>\n            {{/site.hasJournals}}\n            {{#site.isBlog}}\n            <section class=\"posts\">\n                <h2>posts</h2>\n                {{#site.hasPosts}}\n                <ul class=\"post-list\">\n                    {{#site.recentPosts}}\n                    <li>\n                        <h3><a href=\"{{url}}\">{{title}}</a></h3>\n                        {{#excerpt}}<p>{{excerpt}}</p>{{/excerpt}}\n                        <p class=\"post-meta\"><time datetime=\"{{date}}\">{{date}}</time></p>\n                    </li>\n                    {{/site.recentPosts}}\n                </ul>\n                <p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">all {{site.postCount}} posts →</a></p>\n                {{/site.hasPosts}}\n                {{^site.hasPosts}}<p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day; a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}\n            </section>\n            {{/site.isBlog}}\n        </article>\n{{> shell-bottom}}\n",
+	"../etherpk-al-folio/layouts/home.html": "{{> shell-top}}\n        <article class=\"post about\">\n            <header class=\"post-header\">\n                <h1 class=\"post-title\">{{^page.isGeneratedIndex}}{{{page.titleHtml}}}{{/page.isGeneratedIndex}}{{#page.isGeneratedIndex}}{{site.title}}{{/page.isGeneratedIndex}}</h1>\n            </header>\n            {{^page.isGeneratedIndex}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            {{/page.isGeneratedIndex}}\n            {{#page.isGeneratedIndex}}{{^site.isBlog}}\n            <div class=\"post-content page-contents\">\n{{{page.content}}}\n            </div>\n            {{/site.isBlog}}{{/page.isGeneratedIndex}}\n            {{#site.hasJournals}}\n            <section class=\"news\">\n                <h2><a href=\"journal.html\">news</a></h2>\n                <table class=\"news-table\">\n                    {{#site.journals}}\n                    <tr>\n                        <th scope=\"row\"><time datetime=\"{{date}}\">{{date}}</time></th>\n                        <td><a href=\"{{url}}\">{{title}}</a>{{#excerpt}} <span class=\"news-excerpt\">{{excerpt}}</span>{{/excerpt}}</td>\n                    </tr>\n                    {{/site.journals}}\n                </table>\n            </section>\n            {{/site.hasJournals}}\n            {{#site.isBlog}}\n            <section class=\"posts\">\n                <h2>posts</h2>\n                {{#site.hasPosts}}\n                <ul class=\"post-list\">\n                    {{#site.recentPosts}}\n                    <li>\n                        <h3><a href=\"{{url}}\">{{title}}</a></h3>\n                        {{#excerpt}}<p>{{excerpt}}</p>{{/excerpt}}\n                        <p class=\"post-meta\"><time datetime=\"{{date}}\">{{date}}</time></p>\n                    </li>\n                    {{/site.recentPosts}}\n                </ul>\n                <p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">all {{site.postCount}} posts →</a></p>\n                {{/site.hasPosts}}\n                {{^site.hasPosts}}<p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day, a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}\n            </section>\n            {{/site.isBlog}}\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-al-folio/layouts/journal.html": "{{> shell-top}}\n        <article class=\"post\">\n            <header class=\"post-header\">\n                <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n                <p class=\"post-meta\">{{#page.hasDate}}<time datetime=\"{{page.date}}\">{{page.date}}</time> · {{/page.hasDate}}{{page.readingMinutes}} min read</p>\n            </header>\n{{> toc}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            <nav class=\"post-nav\" aria-label=\"Neighbouring posts\">\n                {{#page.older}}<a class=\"older\" href=\"{{url}}\">← {{title}}</a>{{/page.older}}\n                {{#page.newer}}<a class=\"newer\" href=\"{{url}}\">{{title}} →</a>{{/page.newer}}\n            </nav>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-al-folio/layouts/page.html": "{{> shell-top}}\n        <article class=\"post\">\n            <header class=\"post-header\">\n                <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n                <p class=\"post-meta\">{{#page.hasDate}}<time datetime=\"{{page.date}}\">{{page.date}}</time> · {{/page.hasDate}}{{page.readingMinutes}} min read</p>\n            </header>\n{{> toc}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            <nav class=\"post-nav\" aria-label=\"Neighbouring posts\">\n                {{#page.older}}<a class=\"older\" href=\"{{url}}\">← {{title}}</a>{{/page.older}}\n                {{#page.newer}}<a class=\"newer\" href=\"{{url}}\">{{title}} →</a>{{/page.newer}}\n            </nav>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-al-folio/partials/after-content.html": "",
@@ -14358,7 +14555,7 @@ var files = /* @__PURE__ */ Object.assign({
 	"../etherpk-blog/assets/theme.css": "/* EtherPK blog theme. Tokens follow the app's own (agent blue, the gk surface scale); the font\n   is the system stack so the site loads nothing from anywhere. Dark mode follows the reader's\n   preference. Classes the publisher emits and this file styles: .wikilink, .wikilink-missing,\n   .task, .task-tag, .toc, .backlinks, .site-nav-list, .diagram, .math, .tok-* (code). */\n\n:root {\n    --font-sans: \"Inter\", system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif;\n    --font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n    --agent-500: #007acc;\n    --agent-600: #005f9e;\n    --agent-100: #c2e3ff;\n    --surface-0: #ffffff;\n    --surface-1: #f9fafb;\n    --surface-2: #e5e7eb;\n    --text-strong: #030712;\n    --text-default: #374151;\n    --text-muted: #6b7280;\n    --border-soft: rgba(3, 7, 18, 0.08);\n    --border-strong: rgba(3, 7, 18, 0.16);\n    --mark: #fff3a3;\n    --missing: #b45309;\n    --nav-width: 17rem;\n}\n\n@media (prefers-color-scheme: dark) {\n    :root {\n        --agent-500: #5ab3ff;\n        --agent-600: #94ccff;\n        --agent-100: #002e4f;\n        --surface-0: #18181b;\n        --surface-1: #1c1c20;\n        --surface-2: #2a2a30;\n        --text-strong: #fafafa;\n        --text-default: #d4d4d8;\n        --text-muted: #a1a1aa;\n        --border-soft: rgba(255, 255, 255, 0.08);\n        --border-strong: rgba(255, 255, 255, 0.16);\n        --mark: #6b5a00;\n        --missing: #f59e0b;\n    }\n}\n\n*, *::before, *::after { box-sizing: border-box; }\nhtml { font-family: var(--font-sans); -webkit-font-smoothing: antialiased; }\nbody {\n    margin: 0;\n    color: var(--text-default);\n    background: var(--surface-0);\n    line-height: 1.6;\n    font-size: 16px;\n}\na { color: var(--agent-500); }\na:hover { color: var(--agent-600); }\n.visually-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }\n.skip-link { position: absolute; left: -999px; top: 0; background: var(--surface-1); padding: 0.5rem 1rem; z-index: 100; }\n.skip-link:focus { left: 1rem; top: 1rem; }\n\n/* -- Header ----------------------------------------------------------------------------- */\n.site-header {\n    display: flex;\n    align-items: center;\n    gap: 1rem;\n    padding: 0.75rem 1.5rem;\n    border-bottom: 1px solid var(--border-soft);\n    background: var(--surface-1);\n    position: sticky;\n    top: 0;\n    z-index: 20;\n}\n.site-title { display: inline-flex; align-items: center; gap: 0.5rem; min-width: 0; font-weight: 600; color: var(--text-strong); text-decoration: none; font-size: 1.05rem; }\n.site-title:hover { color: var(--agent-500); }\n.site-logo { flex-shrink: 0; }\n.site-title-text { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.site-search { position: relative; margin-left: auto; flex: 0 1 22rem; }\n.site-search input {\n    width: 100%;\n    padding: 0.45rem 0.75rem;\n    border: 1px solid var(--border-strong);\n    border-radius: 0.5rem;\n    background: var(--surface-0);\n    color: var(--text-default);\n    font: inherit;\n}\n.site-search input:focus { outline: 2px solid var(--agent-500); outline-offset: 1px; }\n.site-search-results {\n    position: absolute;\n    top: calc(100% + 0.35rem);\n    left: 0;\n    right: 0;\n    max-height: 24rem;\n    overflow: auto;\n    background: var(--surface-0);\n    border: 1px solid var(--border-strong);\n    border-radius: 0.5rem;\n    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.12);\n    z-index: 30;\n}\n.site-search-hit { display: block; padding: 0.55rem 0.75rem; text-decoration: none; color: var(--text-default); border-bottom: 1px solid var(--border-soft); }\n.site-search-hit:hover, .site-search-hit:focus { background: var(--surface-1); }\n.site-search-title { display: block; font-weight: 600; color: var(--text-strong); }\n.site-search-snippet { display: block; font-size: 0.9rem; color: var(--text-muted); }\n.site-search-empty { margin: 0; padding: 0.6rem 0.75rem; color: var(--text-muted); }\n\n/* -- Shell: top navigation, centred column --------------------------------------------- */\n.site-header { display: block; padding: 1rem 1.5rem 0; position: static; }\n.site-header-row { display: flex; align-items: center; gap: 1rem; max-width: 46rem; margin: 0 auto; }\n.site-title { font-size: 1.35rem; }\n.site-nav { max-width: 46rem; margin: 0.75rem auto 0; }\n.site-nav-list { list-style: none; margin: 0; padding: 0; display: flex; flex-wrap: wrap; gap: 0.25rem 1rem; }\n.site-nav-list .site-nav-list { display: block; padding-left: 0.75rem; }\n.site-nav a, .site-nav .nav-group-label { color: var(--text-default); text-decoration: none; font-size: 0.95rem; }\n.site-nav a:hover { color: var(--text-strong); }\n.site-nav .nav-current > a { color: var(--agent-500); font-weight: 600; }\n.site-nav .nav-group-label { font-weight: 600; color: var(--text-strong); }\n.site-nav a .wikilink { color: inherit; text-decoration: none; }\n.nav-toggle, .nav-backdrop { display: none; }\n\n.content { padding: 2rem 1.5rem 4rem; max-width: 46rem; margin: 0 auto; }\n.post-header h1 { font-size: 2rem; line-height: 1.2; margin: 0 0 0.5rem; color: var(--text-strong); }\n.post-header h1 .wikilink { color: inherit; text-decoration: none; }\n.post-header h1 .wikilink:hover { text-decoration: underline; }\n.post-date { color: var(--text-muted); font-size: 0.95rem; }\n.post-body h2 { margin-top: 2rem; font-size: 1.4rem; color: var(--text-strong); }\n.post-body h3 { margin-top: 1.5rem; font-size: 1.15rem; color: var(--text-strong); }\n.post-body ul { padding-left: 1.4rem; }\n.post-body li { margin: 0.2rem 0; }\n.post-body img { max-width: 100%; height: auto; border-radius: 0.35rem; }\n.post-body table { border-collapse: collapse; margin: 1rem 0; width: 100%; }\n.post-body th, .post-body td { border: 1px solid var(--border-strong); padding: 0.4rem 0.6rem; text-align: left; }\n.post-body th { background: var(--surface-1); }\n.post-body blockquote { border-left: 3px solid var(--border-strong); margin: 1rem 0; padding: 0.25rem 1rem; color: var(--text-muted); }\n.post-body code { font-family: var(--font-mono); font-size: 0.9em; background: var(--surface-1); padding: 0.1em 0.35em; border-radius: 0.25rem; }\n.post-body pre { background: var(--surface-1); border: 1px solid var(--border-soft); border-radius: 0.5rem; padding: 0.9rem 1rem; overflow-x: auto; }\n.post-body pre code { background: none; padding: 0; font-size: 0.88rem; }\nmark { background: var(--mark); color: inherit; padding: 0 0.15em; border-radius: 0.2em; }\n\n/* Wikilinks, as the editor colours them. A missing target is visibly missing. */\na.wikilink { text-decoration: none; border-bottom: 1px solid var(--agent-100); }\na.wikilink:hover { border-bottom-color: var(--agent-500); }\na.wikilink-missing { color: var(--missing); text-decoration: none; border-bottom: 1px dashed var(--missing); }\n\n/* Tasks and their badges. */\nli.task { list-style: none; margin-left: -1.4rem; padding-left: 0; }\nli.task input[type=\"checkbox\"] { margin-right: 0.35rem; vertical-align: -0.1em; }\nli.task.done { color: var(--text-muted); }\n.task-tag { display: inline-block; font-size: 0.8rem; font-weight: 600; padding: 0.05em 0.5em; border-radius: 999px; background: var(--surface-2); color: var(--text-strong); margin-right: 0.25rem; vertical-align: 0.1em; }\n.task-tag.priority-1 { background: #fee2e2; color: #991b1b; }\n.task-tag.priority-2 { background: #ffedd5; color: #9a3412; }\n.task-tag.priority-3 { background: #fef9c3; color: #854d0e; }\n.task-tag.waiting, .task-tag.doing { background: var(--agent-100); color: var(--agent-600); }\n.task-tag.cancelled { text-decoration: line-through; }\n\n/* Table of contents, diagrams, maths. */\n.toc { margin: 0 0 1.5rem; font-size: 0.95rem; }\n.toc summary { cursor: pointer; font-weight: 600; color: var(--text-strong); }\n.toc ul { list-style: none; padding-left: 0; margin: 0.4rem 0 0; }\n.toc li.toc-level-3 { padding-left: 1rem; }\n.toc li.toc-level-4 { padding-left: 2rem; }\n.diagram { margin: 1rem 0; text-align: center; }\n.diagram svg { max-width: 100%; height: auto; }\n.math-block { overflow-x: auto; margin: 1rem 0; }\n\n/* Linked references, beneath the content. */\n.backlinks { margin-top: 3rem; padding-top: 1.5rem; border-top: 1px solid var(--border-soft); }\n.backlinks h2 { font-size: 1.1rem; color: var(--text-strong); margin: 0 0 0.75rem; }\n.backlink-list { list-style: none; padding: 0; margin: 0; }\n.backlink-source { margin: 0 0 0.9rem; }\n.backlink-source > a { font-weight: 600; }\n.backlink-source ul { list-style: none; padding-left: 1rem; margin: 0.25rem 0 0; border-left: 2px solid var(--border-soft); }\n.backlink-context { color: var(--text-muted); font-size: 0.95rem; margin: 0.15rem 0; }\n\n/* Archive and index lists. */\n.journal-archive, .page-index-list { list-style: none; padding: 0; }\n.journal-archive li { margin: 0 0 1rem; }\n.journal-archive time { color: var(--text-muted); margin-right: 0.5rem; font-variant-numeric: tabular-nums; }\n.archive-excerpt { margin: 0.2rem 0 0; color: var(--text-muted); }\n.archive-year { margin: 1.5rem 0 0.5rem; font-size: 1.1rem; }\n.all-posts { margin: 1.5rem 0 0; }\n\n.site-footer { border-top: 1px solid var(--border-soft); padding: 1rem 1.5rem; color: var(--text-muted); font-size: 0.9rem; text-align: center; }\n\n/* Code tokens (lezer classHighlighter names). */\n.tok-keyword { color: #0a7; }\n.tok-string, .tok-string2 { color: #690; }\n.tok-comment, .tok-lineComment, .tok-blockComment { color: #999; font-style: italic; }\n.tok-number, .tok-bool, .tok-null, .tok-atom { color: #905; }\n.tok-function, .tok-definition.tok-variableName { color: #c60; }\n.tok-typeName, .tok-className, .tok-namespace { color: #b58900; }\n.tok-operator, .tok-punctuation { color: #555; }\n.tok-propertyName, .tok-attributeName { color: #268bd2; }\n.tok-tagName { color: #22863a; }\n.tok-invalid { color: #d00; }\n@media (prefers-color-scheme: dark) {\n    .tok-keyword { color: #4ec9b0; }\n    .tok-string, .tok-string2 { color: #b5cea8; }\n    .tok-comment, .tok-lineComment, .tok-blockComment { color: #7f848e; }\n    .tok-number, .tok-bool, .tok-null, .tok-atom { color: #d19a66; }\n    .tok-function, .tok-definition.tok-variableName { color: #dcdcaa; }\n    .tok-typeName, .tok-className, .tok-namespace { color: #e5c07b; }\n    .tok-operator, .tok-punctuation { color: #abb2bf; }\n    .tok-propertyName, .tok-attributeName { color: #61afef; }\n    .tok-tagName { color: #98c379; }\n}\n\n/* -- Posts ------------------------------------------------------------------------------ */\n.post-summary { margin: 0 0 2rem; }\n.post-summary h2 { margin: 0 0 0.2rem; font-size: 1.35rem; }\n.post-summary h2 a { color: var(--text-strong); text-decoration: none; }\n.post-summary h2 a:hover { color: var(--agent-500); }\n.post-summary time { color: var(--text-muted); font-size: 0.9rem; font-variant-numeric: tabular-nums; }\n.post-summary p { margin: 0.4rem 0 0; color: var(--text-default); }\n.home-intro { margin-bottom: 2rem; padding-bottom: 1.5rem; border-bottom: 1px solid var(--border-soft); }\n.post-list-empty { color: var(--text-muted); }\n@media (max-width: 40rem) {\n    .site-header-row { flex-wrap: wrap; }\n    .site-search { flex-basis: 100%; margin-left: 0; }\n    .content { padding: 1.25rem 1rem 3rem; }\n}\n",
 	"../etherpk-blog/layouts/404.html": "{{> shell-top}}\n        <article class=\"post not-published\">\n            <header class=\"post-header\">\n                <h1>Not published</h1>\n            </header>\n            <div class=\"post-body\">\n                <p>The page you followed a link to is not part of this site.</p>\n                <p><a href=\"index.html\">Back to {{site.title}}</a></p>\n            </div>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-blog/layouts/archive.html": "{{> shell-top}}\n        <article class=\"post archive\">\n            <header class=\"post-header\">\n                <h1>{{#page.isPostsArchive}}Posts{{/page.isPostsArchive}}{{#page.isJournalArchive}}Journal{{/page.isJournalArchive}}</h1>\n            </header>\n            {{#page.isPostsArchive}}\n            {{#site.postsByYear}}\n            <h2 class=\"archive-year\" id=\"y{{year}}\">{{year}}</h2>\n            <ul class=\"journal-archive\">\n                {{#posts}}\n                <li>\n                    <time datetime=\"{{date}}\">{{date}}</time>\n                    <a href=\"{{url}}\">{{title}}</a>\n                </li>\n                {{/posts}}\n            </ul>\n            {{/site.postsByYear}}\n            {{/page.isPostsArchive}}\n            {{#page.isJournalArchive}}\n            <ul class=\"journal-archive\">\n                {{#site.journals}}\n                <li>\n                    <time datetime=\"{{date}}\">{{date}}</time>\n                    <a href=\"{{url}}\">{{title}}</a>\n                    {{#excerpt}}<p class=\"archive-excerpt\">{{excerpt}}</p>{{/excerpt}}\n                </li>\n                {{/site.journals}}\n            </ul>\n            {{/page.isJournalArchive}}\n        </article>\n{{> shell-bottom}}\n",
-	"../etherpk-blog/layouts/home.html": "{{> shell-top}}\n        {{^page.isGeneratedIndex}}\n        <section class=\"home-intro\">\n            <div class=\"post-body\">\n{{{page.content}}}\n            </div>\n        </section>\n        {{/page.isGeneratedIndex}}\n        <section class=\"post-list\" aria-label=\"Posts\">\n            {{#site.hasPosts}}\n            {{#site.recentPosts}}\n            <article class=\"post-summary\">\n                <h2><a href=\"{{url}}\">{{title}}</a></h2>\n                <time datetime=\"{{date}}\">{{date}}</time>\n                {{#excerpt}}<p>{{excerpt}}</p>{{/excerpt}}\n            </article>\n            {{/site.recentPosts}}\n            <p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">All {{site.postCount}} posts →</a></p>\n            {{/site.hasPosts}}\n            {{^site.hasPosts}}\n            <p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day; a page by a <code>date:</code> line in its frontmatter.</p>\n            {{/site.hasPosts}}\n        </section>\n{{> shell-bottom}}\n",
+	"../etherpk-blog/layouts/home.html": "{{> shell-top}}\n        {{^page.isGeneratedIndex}}\n        <section class=\"home-intro\">\n            <div class=\"post-body\">\n{{{page.content}}}\n            </div>\n        </section>\n        {{/page.isGeneratedIndex}}\n        <section class=\"post-list\" aria-label=\"Posts\">\n            {{#site.hasPosts}}\n            {{#site.recentPosts}}\n            <article class=\"post-summary\">\n                <h2><a href=\"{{url}}\">{{title}}</a></h2>\n                <time datetime=\"{{date}}\">{{date}}</time>\n                {{#excerpt}}<p>{{excerpt}}</p>{{/excerpt}}\n            </article>\n            {{/site.recentPosts}}\n            <p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">All {{site.postCount}} posts →</a></p>\n            {{/site.hasPosts}}\n            {{^site.hasPosts}}\n            <p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day, a page by a <code>date:</code> line in its frontmatter.</p>\n            {{/site.hasPosts}}\n        </section>\n{{> shell-bottom}}\n",
 	"../etherpk-blog/layouts/journal.html": "{{> shell-top}}\n        <article class=\"post\">\n            <header class=\"post-header\">\n                <h1>{{{page.titleHtml}}}</h1>\n                {{#page.hasDate}}<time class=\"post-date\" datetime=\"{{page.date}}\">{{page.date}}</time>{{/page.hasDate}}\n            </header>\n            <div class=\"post-body\">\n{{{page.content}}}\n            </div>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-blog/layouts/page.html": "{{> shell-top}}\n        <article class=\"post\">\n            <header class=\"post-header\">\n                <h1>{{{page.titleHtml}}}</h1>\n                {{#page.hasDate}}<time class=\"post-date\" datetime=\"{{page.date}}\">{{page.date}}</time>{{/page.hasDate}}\n            </header>\n            <div class=\"post-body\">\n{{{page.content}}}\n            </div>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-blog/partials/after-content.html": "",
@@ -14386,7 +14583,7 @@ var files = /* @__PURE__ */ Object.assign({
 	"../etherpk-docs/partials/before-content.html": "",
 	"../etherpk-docs/partials/footer.html": "    <footer class=\"site-footer\">\n        <p>{{site.title}} · published with <a href=\"https://etherpk.com\" rel=\"noopener\">EtherPK</a></p>\n    </footer>\n",
 	"../etherpk-docs/partials/head.html": "",
-	"../etherpk-docs/partials/header.html": "    <header class=\"site-header\">\n        <a class=\"site-title\" href=\"index.html\">{{> logo}}<span class=\"site-title-text\">{{site.title}}</span></a>\n        <form class=\"site-search\" role=\"search\" data-search-index=\"{{site.search.url}}\" data-search-script=\"{{site.search.scriptUrl}}\">\n            <label class=\"visually-hidden\" for=\"site-search-input\">Search</label>\n            <input id=\"site-search-input\" type=\"search\" name=\"q\" placeholder=\"Search\" autocomplete=\"off\" aria-describedby=\"site-search-hint\">\n            <span id=\"site-search-hint\" class=\"visually-hidden\">Type to search the published pages; results appear below the box.</span>\n            <div class=\"site-search-results\" role=\"listbox\" hidden></div>\n        </form>\n    </header>\n",
+	"../etherpk-docs/partials/header.html": "    <header class=\"site-header\">\n        <a class=\"site-title\" href=\"index.html\">{{> logo}}<span class=\"site-title-text\">{{site.title}}</span></a>\n        <form class=\"site-search\" role=\"search\" data-search-index=\"{{site.search.url}}\" data-search-script=\"{{site.search.scriptUrl}}\">\n            <label class=\"visually-hidden\" for=\"site-search-input\">Search</label>\n            <input id=\"site-search-input\" type=\"search\" name=\"q\" placeholder=\"Search\" autocomplete=\"off\" aria-describedby=\"site-search-hint\">\n            <span id=\"site-search-hint\" class=\"visually-hidden\">Type to search the published pages - results appear below the box.</span>\n            <div class=\"site-search-results\" role=\"listbox\" hidden></div>\n        </form>\n    </header>\n",
 	"../etherpk-docs/partials/logo.html": "<!-- The EtherPK icon (resources/brand/etherpk-icon-*.svg), inline so the page fetches nothing and it takes the text colour; aria-hidden because the title beside it is the name. Fill the \"logo\" include, or edit this partial, for your own. -->\n<svg class=\"site-logo\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 191.82 166.13\" width=\"24\" height=\"21\" aria-hidden=\"true\" focusable=\"false\"><path fill=\"currentColor\" fill-rule=\"evenodd\" d=\"M67.09,132.92,47.93,166.13H9.59L0,149.52,86.33,0H105.5L19.17,149.52H38.34l19.17-33.2h76.8l9.59,16.6Zm48-83.12,9.65,16.71H143.9L115.08,16.6q-24,41.57-48,83.12H143.9q14.37,24.9,28.76,49.8h-96l-9.59,16.61H182.24l9.58-16.61-38.34-66.4H96C95.85,82.9,113.39,52.73,115.08,49.8Z\"/></svg>\n",
 	"../etherpk-docs/partials/nav-item.html": "                <li class=\"{{#current}}nav-current {{/current}}{{#open}}nav-open {{/open}}{{^href}}nav-group{{/href}}\">\n                    {{#href}}<a href=\"{{href}}\"{{#current}} aria-current=\"page\"{{/current}}{{#external}} rel=\"noopener\"{{/external}}>{{label}}</a>{{/href}}\n                    {{^href}}<span class=\"nav-group-label\">{{{labelHtml}}}</span>{{/href}}\n                    {{#hasChildren}}<ul class=\"site-nav-list\">{{#children}}{{> nav-item}}{{/children}}</ul>{{/hasChildren}}\n                </li>\n",
 	"../etherpk-docs/partials/nav.html": "        <nav id=\"site-nav\" class=\"site-nav\" aria-label=\"Site\">\n            <ul class=\"site-nav-list\">\n{{#nav}}{{> nav-item}}{{/nav}}\n            </ul>\n        </nav>\n",
@@ -14401,7 +14598,7 @@ var files = /* @__PURE__ */ Object.assign({
 	"../etherpk-papermod/assets/theme.js": "/*\n * The light / dark toggle: a `.theme-toggle` button flips the page between the two and the\n * choice is remembered in this browser; with no choice made the page follows the system. The\n * stylesheet keys on `data-theme` on <html>, and shell-top applies the remembered choice before\n * the first paint so a dark reader never sees a light flash.\n */\n(function () {\n    'use strict';\n    var KEY = 'etherpk-theme';\n    var root = document.documentElement;\n    function isDark() {\n        var chosen = root.getAttribute('data-theme');\n        if (chosen === 'dark' || chosen === 'light') return chosen === 'dark';\n        return window.matchMedia('(prefers-color-scheme: dark)').matches;\n    }\n    function apply(theme) {\n        if (theme === 'dark' || theme === 'light') root.setAttribute('data-theme', theme);\n        else root.removeAttribute('data-theme');\n        var buttons = document.querySelectorAll('.theme-toggle');\n        for (var i = 0; i < buttons.length; i++) buttons[i].setAttribute('aria-pressed', isDark() ? 'true' : 'false');\n    }\n    try { apply(localStorage.getItem(KEY)); } catch (_e) { apply(null); }\n    var toggles = document.querySelectorAll('.theme-toggle');\n    for (var i = 0; i < toggles.length; i++) {\n        toggles[i].addEventListener('click', function () {\n            var next = isDark() ? 'light' : 'dark';\n            apply(next);\n            try { localStorage.setItem(KEY, next); } catch (_e) { /* private mode: the choice lasts the page */ }\n        });\n    }\n})();\n",
 	"../etherpk-papermod/layouts/404.html": "{{> shell-top}}\n        <div class=\"not-found\">\n            <h1>404</h1>\n            <p>This page is not published. <a href=\"index.html\">Back to {{site.title}}</a>.</p>\n        </div>\n{{> shell-bottom}}\n",
 	"../etherpk-papermod/layouts/archive.html": "{{> shell-top}}\n        <header class=\"page-header\"><h1>{{#page.isPostsArchive}}Posts{{/page.isPostsArchive}}{{#page.isJournalArchive}}Journal{{/page.isJournalArchive}}</h1></header>\n        <div class=\"archive-posts\">\n            {{#page.isPostsArchive}}\n            {{#site.postsByYear}}\n            <div class=\"archive-year\">\n                <h2 class=\"archive-year-header\" id=\"y{{year}}\">{{year}}</h2>\n                {{#posts}}\n                <div class=\"archive-entry\">\n                    <h3 class=\"archive-entry-title\"><a href=\"{{url}}\">{{title}}</a></h3>\n                    {{#excerpt}}<div class=\"archive-entry-content\">{{excerpt}}</div>{{/excerpt}}\n                    <footer class=\"entry-footer\"><time datetime=\"{{date}}\">{{date}}</time></footer>\n                </div>\n                {{/posts}}\n            </div>\n            {{/site.postsByYear}}\n            {{/page.isPostsArchive}}\n            {{#page.isJournalArchive}}\n            {{#site.journals}}\n            <div class=\"archive-entry\">\n                <h3 class=\"archive-entry-title\"><a href=\"{{url}}\">{{title}}</a></h3>\n                {{#excerpt}}<div class=\"archive-entry-content\">{{excerpt}}</div>{{/excerpt}}\n                <footer class=\"entry-footer\"><time datetime=\"{{date}}\">{{date}}</time></footer>\n            </div>\n            {{/site.journals}}\n            {{/page.isJournalArchive}}\n        </div>\n{{> shell-bottom}}\n",
-	"../etherpk-papermod/layouts/home.html": "{{> shell-top}}\n        {{^page.isGeneratedIndex}}\n        <article class=\"post-single home-info\">\n            <header class=\"post-header\"><h1 class=\"post-title\">{{{page.titleHtml}}}</h1></header>\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n        </article>\n        {{/page.isGeneratedIndex}}\n        {{#page.isGeneratedIndex}}\n        <header class=\"page-header\"><h1>{{site.title}}</h1></header>\n        {{/page.isGeneratedIndex}}\n        <section class=\"post-list\" aria-label=\"{{#site.isBlog}}Posts{{/site.isBlog}}{{^site.isBlog}}Pages{{/site.isBlog}}\">\n            {{#site.isBlog}}{{#site.recentPosts}}{{> post-entry}}{{/site.recentPosts}}{{#site.hasPosts}}<p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">All {{site.postCount}} posts →</a></p>{{/site.hasPosts}}{{^site.hasPosts}}<p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day; a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}{{/site.isBlog}}\n            {{^site.isBlog}}{{#page.isGeneratedIndex}}<div class=\"post-content page-contents\">{{{page.content}}}</div>{{/page.isGeneratedIndex}}{{/site.isBlog}}\n        </section>\n{{> shell-bottom}}\n",
+	"../etherpk-papermod/layouts/home.html": "{{> shell-top}}\n        {{^page.isGeneratedIndex}}\n        <article class=\"post-single home-info\">\n            <header class=\"post-header\"><h1 class=\"post-title\">{{{page.titleHtml}}}</h1></header>\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n        </article>\n        {{/page.isGeneratedIndex}}\n        {{#page.isGeneratedIndex}}\n        <header class=\"page-header\"><h1>{{site.title}}</h1></header>\n        {{/page.isGeneratedIndex}}\n        <section class=\"post-list\" aria-label=\"{{#site.isBlog}}Posts{{/site.isBlog}}{{^site.isBlog}}Pages{{/site.isBlog}}\">\n            {{#site.isBlog}}{{#site.recentPosts}}{{> post-entry}}{{/site.recentPosts}}{{#site.hasPosts}}<p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">All {{site.postCount}} posts →</a></p>{{/site.hasPosts}}{{^site.hasPosts}}<p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day, a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}{{/site.isBlog}}\n            {{^site.isBlog}}{{#page.isGeneratedIndex}}<div class=\"post-content page-contents\">{{{page.content}}}</div>{{/page.isGeneratedIndex}}{{/site.isBlog}}\n        </section>\n{{> shell-bottom}}\n",
 	"../etherpk-papermod/layouts/journal.html": "{{> shell-top}}\n        <article class=\"post-single\">\n            <header class=\"post-header\">\n                <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n{{> post-meta}}\n            </header>\n{{> toc}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            <footer class=\"post-footer\">\n                <nav class=\"paginav\" aria-label=\"Neighbouring posts\">\n                    {{#page.older}}<a class=\"prev\" href=\"{{url}}\"><span class=\"title\">« Prev</span><br><span>{{title}}</span></a>{{/page.older}}\n                    {{#page.newer}}<a class=\"next\" href=\"{{url}}\"><span class=\"title\">Next »</span><br><span>{{title}}</span></a>{{/page.newer}}\n                </nav>\n            </footer>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-papermod/layouts/page.html": "{{> shell-top}}\n        <article class=\"post-single\">\n            <header class=\"post-header\">\n                <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n{{> post-meta}}\n            </header>\n{{> toc}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            <footer class=\"post-footer\">\n                <nav class=\"paginav\" aria-label=\"Neighbouring posts\">\n                    {{#page.older}}<a class=\"prev\" href=\"{{url}}\"><span class=\"title\">« Prev</span><br><span>{{title}}</span></a>{{/page.older}}\n                    {{#page.newer}}<a class=\"next\" href=\"{{url}}\"><span class=\"title\">Next »</span><br><span>{{title}}</span></a>{{/page.newer}}\n                </nav>\n            </footer>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-papermod/partials/after-content.html": "",
@@ -14425,7 +14622,7 @@ var files = /* @__PURE__ */ Object.assign({
 	"../etherpk-stack/assets/theme.js": "/*\n * The light / dark toggle: a `.theme-toggle` button flips the page between the two and the\n * choice is remembered in this browser; with no choice made the page follows the system. The\n * stylesheet keys on `data-theme` on <html>, and shell-top applies the remembered choice before\n * the first paint so a dark reader never sees a light flash.\n */\n(function () {\n    'use strict';\n    var KEY = 'etherpk-theme';\n    var root = document.documentElement;\n    function isDark() {\n        var chosen = root.getAttribute('data-theme');\n        if (chosen === 'dark' || chosen === 'light') return chosen === 'dark';\n        return window.matchMedia('(prefers-color-scheme: dark)').matches;\n    }\n    function apply(theme) {\n        if (theme === 'dark' || theme === 'light') root.setAttribute('data-theme', theme);\n        else root.removeAttribute('data-theme');\n        var buttons = document.querySelectorAll('.theme-toggle');\n        for (var i = 0; i < buttons.length; i++) buttons[i].setAttribute('aria-pressed', isDark() ? 'true' : 'false');\n    }\n    try { apply(localStorage.getItem(KEY)); } catch (_e) { apply(null); }\n    var toggles = document.querySelectorAll('.theme-toggle');\n    for (var i = 0; i < toggles.length; i++) {\n        toggles[i].addEventListener('click', function () {\n            var next = isDark() ? 'light' : 'dark';\n            apply(next);\n            try { localStorage.setItem(KEY, next); } catch (_e) { /* private mode: the choice lasts the page */ }\n        });\n    }\n})();\n",
 	"../etherpk-stack/layouts/404.html": "{{> shell-top}}\n            <article class=\"article-page not-found\">\n                <header class=\"article-header\"><h1 class=\"article-title\">Not published</h1></header>\n                <div class=\"article-content\">\n                    <p>The page you followed a link to is not part of this site.</p>\n                    <p><a href=\"index.html\">Back to {{site.title}}</a></p>\n                </div>\n            </article>\n{{> shell-bottom}}\n",
 	"../etherpk-stack/layouts/archive.html": "{{> shell-top}}\n            <header class=\"section-header\"><h1>{{#page.isPostsArchive}}Posts{{/page.isPostsArchive}}{{#page.isJournalArchive}}Journal{{/page.isJournalArchive}}</h1></header>\n            {{#page.isPostsArchive}}\n            {{#site.postsByYear}}\n            <section class=\"archive-year\" aria-label=\"{{year}}\">\n                <h2 class=\"archive-year-title\" id=\"y{{year}}\">{{year}}</h2>\n                <ul class=\"archive-list\">\n                    {{#posts}}<li><time datetime=\"{{date}}\">{{date}}</time> <a href=\"{{url}}\">{{title}}</a></li>{{/posts}}\n                </ul>\n            </section>\n            {{/site.postsByYear}}\n            {{/page.isPostsArchive}}\n            {{#page.isJournalArchive}}\n            <section class=\"article-list\" aria-label=\"Journal\">\n                {{#site.journals}}{{> article-card}}{{/site.journals}}\n            </section>\n            {{/page.isJournalArchive}}\n{{> shell-bottom}}\n",
-	"../etherpk-stack/layouts/home.html": "{{> shell-top}}\n            {{^page.isGeneratedIndex}}\n            <article class=\"article-page home-intro\">\n                <header class=\"article-header\"><h1 class=\"article-title\">{{{page.titleHtml}}}</h1></header>\n                <div class=\"article-content\">\n{{{page.content}}}\n                </div>\n            </article>\n            {{/page.isGeneratedIndex}}\n            <section class=\"article-list\" aria-label=\"{{#site.isBlog}}Posts{{/site.isBlog}}{{^site.isBlog}}Pages{{/site.isBlog}}\">\n                {{#site.isBlog}}{{#site.recentPosts}}{{> article-card}}{{/site.recentPosts}}{{#site.hasPosts}}<p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">All {{site.postCount}} posts →</a></p>{{/site.hasPosts}}{{^site.hasPosts}}<p class=\"article-list-empty\">No dated documents are published yet. A journal entry is dated by its day; a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}{{/site.isBlog}}\n                {{^site.isBlog}}{{#page.isGeneratedIndex}}<article class=\"article-page page-contents\"><header class=\"article-header\"><h1 class=\"article-title\">{{site.title}}</h1></header><div class=\"article-content\">{{{page.content}}}</div></article>{{/page.isGeneratedIndex}}{{/site.isBlog}}\n            </section>\n{{> shell-bottom}}\n",
+	"../etherpk-stack/layouts/home.html": "{{> shell-top}}\n            {{^page.isGeneratedIndex}}\n            <article class=\"article-page home-intro\">\n                <header class=\"article-header\"><h1 class=\"article-title\">{{{page.titleHtml}}}</h1></header>\n                <div class=\"article-content\">\n{{{page.content}}}\n                </div>\n            </article>\n            {{/page.isGeneratedIndex}}\n            <section class=\"article-list\" aria-label=\"{{#site.isBlog}}Posts{{/site.isBlog}}{{^site.isBlog}}Pages{{/site.isBlog}}\">\n                {{#site.isBlog}}{{#site.recentPosts}}{{> article-card}}{{/site.recentPosts}}{{#site.hasPosts}}<p class=\"all-posts\"><a href=\"{{site.postsUrl}}\">All {{site.postCount}} posts →</a></p>{{/site.hasPosts}}{{^site.hasPosts}}<p class=\"article-list-empty\">No dated documents are published yet. A journal entry is dated by its day, a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}{{/site.isBlog}}\n                {{^site.isBlog}}{{#page.isGeneratedIndex}}<article class=\"article-page page-contents\"><header class=\"article-header\"><h1 class=\"article-title\">{{site.title}}</h1></header><div class=\"article-content\">{{{page.content}}}</div></article>{{/page.isGeneratedIndex}}{{/site.isBlog}}\n            </section>\n{{> shell-bottom}}\n",
 	"../etherpk-stack/layouts/journal.html": "{{> shell-top}}\n            <article class=\"article-page\">\n                <header class=\"article-header\">\n                    <span class=\"article-category\">{{page.kind}}</span>\n                    <h1 class=\"article-title\">{{{page.titleHtml}}}</h1>\n                    <div class=\"article-details\">{{#page.hasDate}}<time datetime=\"{{page.date}}\">{{page.date}}</time> · {{/page.hasDate}}<span>{{page.readingMinutes}} minute read</span></div>\n                </header>\n                <div class=\"article-content\">\n{{{page.content}}}\n                </div>\n                <footer class=\"article-footer\">\n                    <nav class=\"article-pagination\" aria-label=\"Neighbouring posts\">\n                        {{#page.older}}<a class=\"article-card pagination-card\" href=\"{{url}}\"><span class=\"pagination-label\">Previous</span><span class=\"pagination-title\">{{title}}</span></a>{{/page.older}}\n                        {{#page.newer}}<a class=\"article-card pagination-card next\" href=\"{{url}}\"><span class=\"pagination-label\">Next</span><span class=\"pagination-title\">{{title}}</span></a>{{/page.newer}}\n                    </nav>\n                </footer>\n            </article>\n{{> shell-bottom}}\n",
 	"../etherpk-stack/layouts/page.html": "{{> shell-top}}\n            <article class=\"article-page\">\n                <header class=\"article-header\">\n                    <span class=\"article-category\">{{page.kind}}</span>\n                    <h1 class=\"article-title\">{{{page.titleHtml}}}</h1>\n                    <div class=\"article-details\">{{#page.hasDate}}<time datetime=\"{{page.date}}\">{{page.date}}</time> · {{/page.hasDate}}<span>{{page.readingMinutes}} minute read</span></div>\n                </header>\n                <div class=\"article-content\">\n{{{page.content}}}\n                </div>\n                <footer class=\"article-footer\">\n                    <nav class=\"article-pagination\" aria-label=\"Neighbouring posts\">\n                        {{#page.older}}<a class=\"article-card pagination-card\" href=\"{{url}}\"><span class=\"pagination-label\">Previous</span><span class=\"pagination-title\">{{title}}</span></a>{{/page.older}}\n                        {{#page.newer}}<a class=\"article-card pagination-card next\" href=\"{{url}}\"><span class=\"pagination-label\">Next</span><span class=\"pagination-title\">{{title}}</span></a>{{/page.newer}}\n                    </nav>\n                </footer>\n            </article>\n{{> shell-bottom}}\n",
 	"../etherpk-stack/partials/after-content.html": "",
@@ -14443,12 +14640,12 @@ var files = /* @__PURE__ */ Object.assign({
 	"../etherpk-stack/partials/theme-scripts.html": "    <script src=\"theme/search.js\" defer><\/script>\n    <script src=\"theme/theme.js\" defer><\/script>\n",
 	"../etherpk-stack/partials/toc.html": "                <nav class=\"toc\" aria-label=\"Table of contents\">\n                    <ul>\n                        {{#page.toc}}<li class=\"toc-level-{{level}}\"><a href=\"#{{id}}\">{{text}}</a></li>{{/page.toc}}\n                    </ul>\n                </nav>\n",
 	"../etherpk-stack/partials/widgets.html": "            <section class=\"widget search-widget\" aria-label=\"Search\">\n                <form class=\"site-search\" role=\"search\" data-search-index=\"{{site.search.url}}\" data-search-script=\"{{site.search.scriptUrl}}\">\n                    <label class=\"visually-hidden\" for=\"site-search-input\">Search</label>\n                    <input id=\"site-search-input\" type=\"search\" name=\"q\" placeholder=\"Search\" autocomplete=\"off\">\n                    <div class=\"site-search-results\" role=\"listbox\" hidden></div>\n                </form>\n            </section>\n            {{#page.hasToc}}\n            <section class=\"widget toc-widget\">\n                <h2 class=\"widget-title\">Table of contents</h2>\n{{> toc}}\n            </section>\n            {{/page.hasToc}}\n            {{#site.hasPostsArchive}}\n            <!-- Years with counts, as Stack's archives widget does: a list of every post would grow\n                 with the blog; the archive page carries them. -->\n            <section class=\"widget archives\">\n                <h2 class=\"widget-title\">Archives</h2>\n                <ul class=\"widget-list\">\n                    {{#site.postsByYear}}<li><a href=\"{{site.postsUrl}}#y{{year}}\"><span>{{year}}</span><span class=\"widget-count\">{{count}}</span></a></li>{{/site.postsByYear}}\n                </ul>\n                <p class=\"widget-more\"><a href=\"{{site.postsUrl}}\">All posts</a></p>\n            </section>\n            {{/site.hasPostsArchive}}\n            {{#site.hasJournals}}\n            <section class=\"widget journal\">\n                <h2 class=\"widget-title\">Journal</h2>\n                <p class=\"widget-more\"><a href=\"journal.html\">Every entry, by day</a></p>\n            </section>\n            {{/site.hasJournals}}\n            <!-- A blog's posts are in the archive above; only its other pages belong here. -->\n            {{#site.isBlog}}{{#site.hasUndatedPages}}\n            <section class=\"widget pages\">\n                <h2 class=\"widget-title\">Pages</h2>\n                <ul class=\"widget-list\">\n                    {{#site.undatedPages}}<li><a href=\"{{url}}\"><span>{{title}}</span></a></li>{{/site.undatedPages}}\n                </ul>\n            </section>\n            {{/site.hasUndatedPages}}{{/site.isBlog}}\n            {{^site.isBlog}}\n            <section class=\"widget pages\">\n                <h2 class=\"widget-title\">Pages</h2>\n                <ul class=\"widget-list\">\n                    {{#site.pages}}<li><a href=\"{{url}}\"><span>{{title}}</span></a></li>{{/site.pages}}\n                </ul>\n            </section>\n            {{/site.isBlog}}\n",
-	"../etherpk-stack/theme.json": "{\n    \"name\": \"etherpk-stack\",\n    \"title\": \"EtherPK Stack\",\n    \"version\": \"1.0.0\",\n    \"contract\": 1,\n    \"description\": \"In the mould of Hugo's Stack: a card-based blog with a left sidebar of site identity and menu, article cards in the middle, and widgets (search, contents, archive, pages) on the right.\",\n    \"kinds\": [\"blog\", \"docs\"],\n    \"includes\": [\n        { \"name\": \"head\", \"description\": \"Extra markup inside <head>: analytics, fonts, meta tags. Raw HTML in the page body.\" },\n        { \"name\": \"logo\", \"description\": \"The avatar above the site title in the sidebar: an image or inline SVG. Replaces the EtherPK icon.\" },\n        { \"name\": \"header\", \"description\": \"The left sidebar's identity block (avatar, title, description). Replaces the theme's; the menu stays.\" },\n        { \"name\": \"before-content\", \"description\": \"Rendered above every page's content: a banner, a notice.\" },\n        { \"name\": \"after-content\", \"description\": \"Rendered below every page's content, above the linked references: an author bio, a comments widget.\" },\n        { \"name\": \"footer\", \"description\": \"The footer under the article column.\" },\n        { \"name\": \"scripts\", \"description\": \"Scripts before </body>, added after the theme's own (search, the theme toggle): analytics, a widget. Raw HTML in the page body.\" },\n        { \"name\": \"styles\", \"description\": \"CSS appended after the theme's stylesheet: the page's first css fence.\", \"kind\": \"css\" }\n    ],\n    \"files\": [\n        \"layouts/page.html\", \"layouts/home.html\", \"layouts/journal.html\", \"layouts/archive.html\", \"layouts/404.html\",\n        \"partials/shell-top.html\", \"partials/shell-bottom.html\", \"partials/head.html\", \"partials/logo.html\", \"partials/header.html\",\n        \"partials/nav-item.html\", \"partials/toc.html\", \"partials/backlinks.html\", \"partials/article-card.html\", \"partials/widgets.html\",\n        \"partials/before-content.html\", \"partials/after-content.html\", \"partials/footer.html\", \"partials/theme-scripts.html\", \"partials/scripts.html\",\n        \"assets/theme.css\", \"assets/search.js\", \"assets/theme.js\"\n    ]\n}\n",
+	"../etherpk-stack/theme.json": "{\n    \"name\": \"etherpk-stack\",\n    \"title\": \"EtherPK Stack\",\n    \"version\": \"1.0.0\",\n    \"contract\": 1,\n    \"description\": \"In the mould of Hugo's Stack: a card-based blog with a left sidebar of site identity and menu, article cards in the middle, and widgets (search, contents, archive, pages) on the right.\",\n    \"kinds\": [\"blog\", \"docs\"],\n    \"includes\": [\n        { \"name\": \"head\", \"description\": \"Extra markup inside <head>: analytics, fonts, meta tags. Raw HTML in the page body.\" },\n        { \"name\": \"logo\", \"description\": \"The avatar above the site title in the sidebar: an image or inline SVG. Replaces the EtherPK icon.\" },\n        { \"name\": \"header\", \"description\": \"The left sidebar's identity block (avatar, title, description). Replaces the theme's - the menu stays.\" },\n        { \"name\": \"before-content\", \"description\": \"Rendered above every page's content: a banner, a notice.\" },\n        { \"name\": \"after-content\", \"description\": \"Rendered below every page's content, above the linked references: an author bio, a comments widget.\" },\n        { \"name\": \"footer\", \"description\": \"The footer under the article column.\" },\n        { \"name\": \"scripts\", \"description\": \"Scripts before </body>, added after the theme's own (search, the theme toggle): analytics, a widget. Raw HTML in the page body.\" },\n        { \"name\": \"styles\", \"description\": \"CSS appended after the theme's stylesheet: the page's first css fence.\", \"kind\": \"css\" }\n    ],\n    \"files\": [\n        \"layouts/page.html\", \"layouts/home.html\", \"layouts/journal.html\", \"layouts/archive.html\", \"layouts/404.html\",\n        \"partials/shell-top.html\", \"partials/shell-bottom.html\", \"partials/head.html\", \"partials/logo.html\", \"partials/header.html\",\n        \"partials/nav-item.html\", \"partials/toc.html\", \"partials/backlinks.html\", \"partials/article-card.html\", \"partials/widgets.html\",\n        \"partials/before-content.html\", \"partials/after-content.html\", \"partials/footer.html\", \"partials/theme-scripts.html\", \"partials/scripts.html\",\n        \"assets/theme.css\", \"assets/search.js\", \"assets/theme.js\"\n    ]\n}\n",
 	"../etherpk-terminal/assets/search.js": "/*\n * Search for a Published Site: reads search.json (built over the publication's own documents\n * and nothing else) and scores documents by title and text matches. No dependencies, no\n * network beyond the one index file, and nothing runs until the search box is used. The same\n * script runs the sidebar toggle on small screens, so a page carries one script.\n */\n(function () {\n    'use strict';\n\n    // -- Navigation toggle (small screens) -------------------------------------------------\n    var toggle = document.querySelector('.nav-toggle');\n    var backdrop = document.querySelector('.nav-backdrop');\n    var nav = document.getElementById('site-nav');\n    function setNavOpen(open) {\n        var was = document.body.classList.contains('nav-open');\n        document.body.classList.toggle('nav-open', open);\n        if (toggle) toggle.setAttribute('aria-expanded', open ? 'true' : 'false');\n        if (backdrop) backdrop.hidden = !open;\n        // Focus follows the drawer: into its first link on open, back to the button on close,\n        // so a keyboard or screen-reader user is never left on something now hidden.\n        if (open && !was) {\n            var first = nav.querySelector('a');\n            if (first) first.focus();\n        } else if (!open && was && toggle) {\n            toggle.focus();\n        }\n    }\n    if (toggle && nav) {\n        toggle.addEventListener('click', function () { setNavOpen(!document.body.classList.contains('nav-open')); });\n        if (backdrop) backdrop.addEventListener('click', function () { setNavOpen(false); });\n        document.addEventListener('keydown', function (e) {\n            if (e.key === 'Escape' && document.body.classList.contains('nav-open')) setNavOpen(false);\n        });\n    }\n\n    // -- Search --------------------------------------------------------------------------\n    var form = document.querySelector('.site-search');\n    if (!form) return;\n    var input = form.querySelector('input[type=\"search\"]');\n    var results = form.querySelector('.site-search-results');\n    var indexUrl = form.getAttribute('data-search-index') || 'search.json';\n    var scriptUrl = form.getAttribute('data-search-script') || 'search-index.js';\n    var index = null;\n    var loading = null;\n    /* True once neither route produced the index: the results then say so rather than \"nothing matches\". */\n    var unavailable = false;\n\n    /* The index as a script assigning window.etherpkSearchIndex: what a site opened from disk can\n       load, since file:// refuses fetch but allows <script src>. */\n    function loadScript() {\n        return new Promise(function (resolve, reject) {\n            if (window.etherpkSearchIndex) { resolve(window.etherpkSearchIndex); return; }\n            var s = document.createElement('script');\n            s.src = scriptUrl;\n            s.onload = function () {\n                if (window.etherpkSearchIndex) resolve(window.etherpkSearchIndex);\n                else reject(new Error('no index'));\n            };\n            s.onerror = function () { reject(new Error('no script')); };\n            document.head.appendChild(s);\n        });\n    }\n\n    function load() {\n        if (index) return Promise.resolve(index);\n        if (!loading) {\n            loading = fetch(indexUrl).then(function (r) {\n                if (!r.ok) throw new Error(String(r.status));\n                return r.json();\n            }).catch(loadScript).then(function (data) {\n                index = (data && data.documents) || [];\n                return index;\n            }).catch(function () { unavailable = true; index = []; return index; });\n        }\n        return loading;\n    }\n\n    function tokens(q) {\n        return q.toLowerCase().split(/\\s+/).filter(function (t) { return t.length > 0; });\n    }\n\n    function score(doc, terms) {\n        var title = (doc.title || '').toLowerCase();\n        var text = (doc.text || '').toLowerCase();\n        var s = 0;\n        for (var i = 0; i < terms.length; i++) {\n            var t = terms[i];\n            if (title === t) s += 20;\n            else if (title.indexOf(t) === 0) s += 10;\n            else if (title.indexOf(t) !== -1) s += 6;\n            var at = text.indexOf(t);\n            if (at !== -1) s += 2;\n            else if (title.indexOf(t) === -1) return 0; // every term must match somewhere\n        }\n        return s;\n    }\n\n    function snippet(doc, terms) {\n        var text = doc.text || '';\n        var lower = text.toLowerCase();\n        var at = -1;\n        for (var i = 0; i < terms.length && at === -1; i++) at = lower.indexOf(terms[i]);\n        if (at === -1) return doc.excerpt || '';\n        var start = Math.max(0, at - 60);\n        var end = Math.min(text.length, at + 100);\n        return (start > 0 ? '…' : '') + text.slice(start, end).replace(/\\s+/g, ' ') + (end < text.length ? '…' : '');\n    }\n\n    function escapeHtml(s) {\n        return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;');\n    }\n\n    function render(list, q) {\n        if (!q) { results.hidden = true; results.innerHTML = ''; return; }\n        if (unavailable) {\n            results.innerHTML = '<p class=\"site-search-empty\">The search index could not be loaded.</p>';\n            results.hidden = false;\n            return;\n        }\n        if (list.length === 0) {\n            results.innerHTML = '<p class=\"site-search-empty\">Nothing matches \"' + escapeHtml(q) + '\".</p>';\n            results.hidden = false;\n            return;\n        }\n        results.innerHTML = list.map(function (hit) {\n            return '<a class=\"site-search-hit\" role=\"option\" href=\"' + escapeHtml(hit.doc.url) + '\">' +\n                '<span class=\"site-search-title\">' + escapeHtml(hit.doc.title) + '</span>' +\n                '<span class=\"site-search-snippet\">' + escapeHtml(hit.snippet) + '</span></a>';\n        }).join('');\n        results.hidden = false;\n    }\n\n    var timer = null;\n    function run() {\n        var q = input.value.trim();\n        var terms = tokens(q);\n        if (terms.length === 0) { render([], ''); return; }\n        load().then(function (docs) {\n            var hits = [];\n            for (var i = 0; i < docs.length; i++) {\n                var s = score(docs[i], terms);\n                if (s > 0) hits.push({ doc: docs[i], score: s, snippet: snippet(docs[i], terms) });\n            }\n            hits.sort(function (a, b) { return b.score - a.score || a.doc.title.localeCompare(b.doc.title); });\n            render(hits.slice(0, 12), q);\n        });\n    }\n\n    input.addEventListener('input', function () {\n        clearTimeout(timer);\n        timer = setTimeout(run, 120);\n    });\n    input.addEventListener('focus', function () { load(); });\n    form.addEventListener('submit', function (e) {\n        e.preventDefault();\n        var first = results.querySelector('a');\n        if (first) window.location.href = first.getAttribute('href');\n    });\n    document.addEventListener('keydown', function (e) {\n        if (e.key === '/' && document.activeElement !== input && !/input|textarea/i.test(document.activeElement.tagName)) {\n            e.preventDefault();\n            input.focus();\n        }\n        if (e.key === 'Escape' && !results.hidden) { render([], ''); }\n    });\n    document.addEventListener('click', function (e) {\n        if (!form.contains(e.target)) render([], '');\n    });\n})();\n",
 	"../etherpk-terminal/assets/theme.css": "/* EtherPK's Terminal: after Hugo's Terminal (panr, MIT), written afresh for EtherPK's view - one\n   monospace face, a dark ground, no colour at all - the accent is a brighter shade of the text,\n   so everything is drawn in tones of one ink - the block logo with its blinking cursor,\n   underlined titles, framed boxes and bordered buttons. Uses Fira Code\n   or the system monospace, so the site loads nothing from anywhere. Classes the publisher emits\n   and this file styles: .wikilink, .wikilink-missing, .task, .task-tag, .toc, .backlinks,\n   .site-nav-list, .diagram, .math, .tok-* (code). */\n\n:root {\n    --accent: #f2f2f2;\n    --background: #1d1e28;\n    --color: #cfcfd6;\n    --color-muted: #8f8f9a;\n    --border-color: rgba(255, 255, 255, 0.1);\n    --code-bg: rgba(255, 255, 255, 0.06);\n    --font: \"Fira Code\", ui-monospace, Monaco, Consolas, \"Ubuntu Mono\", monospace;\n    --container-width: 1080px;\n    --mark: rgba(255, 255, 255, 0.22);\n    --missing: var(--color-muted);\n}\n/* Terminal is dark by nature; a light system preference is respected, the ink inverted. */\n@media (prefers-color-scheme: light) {\n    :root:not([data-theme=\"dark\"]) {\n        --accent: #111111;\n        --background: #f7f4ef;\n        --color: #2b2b2b;\n        --color-muted: #6a6a6a;\n        --mark: rgba(0, 0, 0, 0.14);\n        --border-color: rgba(0, 0, 0, 0.12);\n        --code-bg: rgba(0, 0, 0, 0.05);\n    }\n}\n\n*, *::before, *::after { box-sizing: border-box; }\nhtml { color-scheme: dark light; }\nbody {\n    margin: 0;\n    font-family: var(--font);\n    font-size: 0.9375rem;\n    line-height: 1.6;\n    background: var(--background);\n    color: var(--color);\n    text-rendering: optimizeLegibility;\n    -webkit-font-smoothing: antialiased;\n    font-feature-settings: \"liga\", \"tnum\", \"zero\", \"ss01\", \"locl\";\n}\na { color: var(--accent); }\na:hover { text-decoration: none; }\nimg { max-width: 100%; height: auto; display: block; }\n.visually-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }\n.skip-link { position: absolute; left: -999px; top: 0; background: var(--accent); color: var(--background); padding: 8px 16px; z-index: 100; }\n.skip-link:focus { left: 16px; top: 16px; }\n\n.container { max-width: var(--container-width); margin: 0 auto; padding: 40px; }\n\n/* -- Header: the prompt-style logo ------------------------------------------------------ */\n.header { margin-bottom: 40px; }\n.header__inner { display: flex; align-items: center; justify-content: space-between; gap: 20px; }\n/* The block logo: the mark, the title and a blinking cursor on one line, the mark's box sized\n   to the text's cap height so the two read as one glyph run. */\n.logo {\n    display: inline-flex;\n    align-items: center;\n    gap: 12px;\n    padding: 8px 16px;\n    background: var(--accent);\n    color: var(--background);\n    font-size: 1.375rem;\n    line-height: 1;\n    font-weight: bold;\n    text-decoration: none;\n}\n.logo:hover { text-decoration: none; }\n.logo__mark { display: inline-flex; align-items: center; line-height: 0; }\n.logo__mark .site-logo { display: block; width: 1.3em; height: 1.125em; }\n.logo__cursor {\n    display: inline-block;\n    width: 0.5em;\n    height: 1em;\n    background: var(--background);\n    animation: cursor 1s infinite;\n}\n@keyframes cursor { 0% { opacity: 0; } 50% { opacity: 1; } 100% { opacity: 0; } }\n@media (prefers-reduced-motion: reduce) { .logo__cursor { animation: none; } }\n.menu { margin-top: 20px; display: flex; flex-wrap: wrap; align-items: center; gap: 12px 30px; }\n.menu__inner { list-style: none; margin: 0; padding: 0; display: flex; flex-wrap: wrap; gap: 6px 30px; }\n.menu__inner li a, .menu__inner .nav-group-label { color: var(--color); text-decoration: none; }\n.menu__inner li a:hover { color: var(--accent); }\n.menu__inner .nav-current > a { color: var(--accent); }\n.menu__inner .nav-current > a::after { content: \" *\"; }\n.menu__inner .nav-group-label { color: var(--color-muted); }\n.menu__inner .nav-group-label::after { content: \":\"; }\n/* A nested outline level follows its parent on the same line, the way a path reads. */\n.menu__inner li { display: flex; flex-wrap: wrap; align-items: baseline; gap: 0 12px; }\n.menu__inner .site-nav-list { list-style: none; margin: 0; padding: 0; display: flex; flex-wrap: wrap; gap: 0 12px; }\n.menu__inner .site-nav-list li::before { content: \"/\"; color: var(--color-muted); margin-right: 12px; }\n.nav-toggle { display: none; }\n.nav-backdrop { display: none; }\n.site-search { position: relative; margin-left: auto; flex: 0 1 16rem; }\n.site-search input {\n    width: 100%;\n    padding: 5px 10px;\n    border: 1px solid var(--accent);\n    background: transparent;\n    color: var(--color);\n    font: inherit;\n}\n.site-search input:focus { outline: 2px solid var(--accent); outline-offset: 1px; }\n.site-search input::placeholder { color: var(--color-muted); }\n.site-search-results {\n    position: absolute;\n    right: 0;\n    top: calc(100% + 6px);\n    width: min(26rem, 90vw);\n    max-height: 24rem;\n    overflow: auto;\n    background: var(--background);\n    border: 1px solid var(--accent);\n    z-index: 30;\n}\n.site-search-hit { display: block; padding: 8px 12px; color: var(--color); text-decoration: none; border-bottom: 1px solid var(--border-color); }\n.site-search-hit:hover, .site-search-hit:focus { background: var(--code-bg); }\n.site-search-title { display: block; color: var(--accent); }\n.site-search-snippet { display: block; color: var(--color-muted); font-size: 0.9rem; }\n.site-search-empty { margin: 0; padding: 8px 12px; color: var(--color-muted); }\n\n/* -- Posts ------------------------------------------------------------------------------ */\n.posts { width: 100%; }\n.post { width: 100%; }\n.post.on-list { margin-bottom: 40px; padding-bottom: 40px; border-bottom: 1px dotted var(--accent); }\n.post.on-list:last-child { border-bottom: 0; }\n.post-title {\n    position: relative;\n    margin: 0 0 15px;\n    font-size: 1.6rem;\n    line-height: 1.3;\n    color: var(--accent);\n    text-decoration: underline;\n    text-decoration-color: var(--accent);\n    text-decoration-thickness: 2px;\n    text-underline-offset: 6px;\n}\n.post-title a { color: inherit; text-decoration: none; }\n.post-title .wikilink { color: inherit; text-decoration: none; }\n.index-title { text-decoration: none; }\n.index-title::before { content: \"# \"; }\n.post-meta { margin: 0 0 20px; font-size: 0.9rem; color: var(--color-muted); }\n.post-content { margin-top: 20px; }\n.post-content h1, .post-content h2, .post-content h3, .post-content h4 { font-weight: bold; line-height: 1.3; margin: 40px 0 20px; }\n.post-content h2 { font-size: 1.3rem; }\n.post-content h3 { font-size: 1.2rem; }\n.post-content h2::before { content: \"## \"; color: var(--accent); }\n.post-content h3::before { content: \"### \"; color: var(--accent); }\n.post-content p { margin: 0 0 20px; }\n.post-content ul, .post-content ol { margin: 0 0 20px; padding-left: 24px; }\n.post-content li { margin: 4px 0; }\n.post-content ul li::marker { color: var(--accent); }\n.post-content img { margin: 20px 0; border: 1px solid var(--border-color); }\n.post-content .diagram { margin: 20px 0; text-align: center; }\n.post-content .diagram svg { max-width: 100%; height: auto; }\n.post-content blockquote {\n    position: relative;\n    margin: 40px 0;\n    padding: 25px;\n    border-top: 1px solid var(--accent);\n    border-bottom: 1px solid var(--accent);\n    font-style: italic;\n}\n.post-content blockquote::before { content: \"”\"; position: absolute; top: -40px; left: 10px; font-size: 3.875rem; font-style: normal; color: var(--accent); }\n.post-content blockquote p:last-child { margin-bottom: 0; }\n.post-content hr { border: 0; border-top: 1px dashed var(--accent); margin: 40px 0; }\n.post-content table { width: 100%; border-collapse: collapse; margin: 20px 0; }\n.post-content th, .post-content td { padding: 8px 12px; border: 1px dashed var(--accent); text-align: left; }\n.post-content th { color: var(--accent); }\n.post-content code { padding: 1px 6px; background: var(--code-bg); font-family: inherit; font-size: 0.95em; }\n.post-content pre {\n    margin: 20px 0;\n    padding: 20px;\n    background: var(--code-bg);\n    border-left: 3px solid var(--accent);\n    overflow-x: auto;\n    font-family: inherit;\n    font-size: 0.95rem;\n    line-height: 1.5;\n}\n.post-content pre code { padding: 0; background: none; font-size: inherit; }\n.math-block { overflow-x: auto; margin: 20px 0; }\nmark { background: var(--mark); color: inherit; padding: 0 0.15em; }\n\n/* Wikilinks and tasks. */\na.wikilink { color: var(--accent); }\na.wikilink-missing { color: var(--missing); text-decoration-style: dotted; }\nli.task { list-style: none; margin-left: -24px; }\nli.task input[type=\"checkbox\"] { accent-color: var(--accent); margin-right: 6px; vertical-align: -0.1em; }\nli.task.done { color: var(--color-muted); text-decoration: line-through; }\n.task-tag { display: inline-block; padding: 0 6px; margin-right: 4px; border: 1px solid var(--accent); color: var(--accent); font-size: 0.8rem; }\n.task-tag.cancelled { text-decoration: line-through; }\n\n/* Buttons, frames, the table of contents and pagination. */\n.button {\n    display: inline-flex;\n    align-items: center;\n    gap: 10px;\n    padding: 8px 18px;\n    border: 1px solid var(--accent);\n    color: var(--accent);\n    font: inherit;\n    text-decoration: none;\n    background: transparent;\n    cursor: pointer;\n}\n.button:hover { background: var(--accent); color: var(--background); }\n.button.inline { display: inline-flex; }\n.read-more { margin-top: 10px; }\n.all-posts { margin: 30px 0 0; }\n/* The contents page of a docs site: the outline as a tree, then any page it leaves out. */\n.page-index-list { list-style: none; margin: 0; padding: 0; }\n.page-index-list .page-index-list { padding-left: 24px; }\n.page-index-list li { margin: 6px 0; }\n.page-index-list li::before { content: \"- \"; color: var(--accent); }\n.page-index-list a { color: var(--color); }\n.page-index-list a:hover { color: var(--accent); }\n.page-index-group-label { color: var(--color-muted); }\n.page-index-group-label::after { content: \":\"; }\n.page-index-other { margin: 30px 0 10px; font-size: 1.1rem; }\n.page-index-other::before { content: \"## \"; color: var(--accent); }\n/* The archives: a year as a prompt-style heading, then one line per post. */\n.archive-year { margin: 30px 0 10px; font-size: 1.1rem; }\n.archive-year::before { content: \"## \"; color: var(--accent); }\n.archive-list { list-style: none; margin: 0; padding: 0; }\n.archive-list li { margin: 6px 0; }\n.archive-list time { color: var(--color-muted); margin-right: 12px; font-variant-numeric: tabular-nums; }\n.archive-list a { color: var(--color); }\n.archive-list a:hover { color: var(--accent); }\n.archive-excerpt { color: var(--color-muted); }\n.framed { border: 1px solid var(--accent); padding: 20px; }\n.toc { margin: 20px 0 40px; }\n.toc__title { margin: 0 0 10px; color: var(--accent); }\n.toc ul { list-style: none; margin: 0; padding: 0; }\n.toc li { margin: 4px 0; }\n.toc li::before { content: \"- \"; color: var(--accent); }\n.toc li.toc-level-3 { padding-left: 1.5rem; }\n.toc li.toc-level-4 { padding-left: 3rem; }\n.toc a { color: var(--color); text-decoration: none; }\n.toc a:hover { color: var(--accent); }\n.pagination { display: flex; flex-wrap: wrap; justify-content: space-between; gap: 10px; margin-top: 50px; }\n.pagination__next { margin-left: auto; }\n.button__text { max-width: 20rem; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n\n/* Linked references, framed like everything else worth a box. */\n.backlinks { margin-top: 40px; border: 1px solid var(--accent); padding: 20px; }\n.backlinks h2 { margin: 0 0 12px; font-size: 1rem; color: var(--accent); }\n.backlinks h2::before { content: \":: \"; }\n.backlink-list { list-style: none; margin: 0; padding: 0; }\n.backlink-source { margin: 0 0 12px; }\n.backlink-source > a { color: var(--color); }\n.backlink-source ul { list-style: none; margin: 4px 0 0; padding: 0 0 0 16px; border-left: 1px dashed var(--accent); }\n.backlink-context { color: var(--color-muted); font-size: 0.9rem; margin: 2px 0; }\n\n/* -- Footer ----------------------------------------------------------------------------- */\n.footer { margin-top: 60px; padding-top: 20px; border-top: 1px dotted var(--accent); font-size: 0.9rem; color: var(--color-muted); }\n.footer__inner { display: flex; flex-wrap: wrap; gap: 10px; }\n.copyright { display: flex; flex-wrap: wrap; gap: 0 8px; }\n.footer__separator { color: var(--accent); }\n\n/* Code tokens (lezer classHighlighter names). */\n/* Code tokens (lezer classHighlighter names), in tones of the one ink: weight and italics carry\n   the distinction the usual colours would. */\n.tok-keyword { color: var(--accent); font-weight: bold; }\n.tok-string, .tok-string2 { color: var(--color); font-style: italic; }\n.tok-comment, .tok-lineComment, .tok-blockComment { color: var(--color-muted); font-style: italic; }\n.tok-number, .tok-bool, .tok-null, .tok-atom { color: var(--accent); }\n.tok-function, .tok-definition.tok-variableName { color: var(--accent); }\n.tok-typeName, .tok-className, .tok-namespace { color: var(--accent); font-weight: bold; }\n.tok-operator, .tok-punctuation { color: var(--color-muted); }\n.tok-propertyName, .tok-attributeName { color: var(--color); }\n.tok-tagName { color: var(--accent); }\n.tok-invalid { color: var(--missing); text-decoration: underline wavy; }\n\n/* -- Small screens: the menu behind a Terminal-style button ----------------------------- */\n@media (max-width: 684px) {\n    .container { padding: 20px; }\n    .nav-toggle {\n        display: inline-block;\n        padding: 5px 10px;\n        border: 1px solid var(--accent);\n        background: transparent;\n        color: var(--accent);\n        font: inherit;\n        cursor: pointer;\n    }\n    .nav-toggle::before { content: \"$ \"; }\n    .menu { display: none; flex-direction: column; align-items: stretch; gap: 12px; margin-top: 20px; padding: 20px; border: 1px solid var(--accent); }\n    body.nav-open .menu { display: flex; }\n    .menu__inner { flex-direction: column; gap: 8px; }\n    .menu__inner li { flex-direction: column; align-items: flex-start; }\n    .menu__inner .site-nav-list { flex-direction: column; padding-left: 12px; }\n    .menu__inner .site-nav-list li::before { margin-right: 6px; }\n    .site-search { margin-left: 0; flex-basis: auto; }\n    .post-title { font-size: 1.3rem; }\n    .pagination__prev, .pagination__next { flex-basis: 100%; }\n    .pagination__next { justify-content: flex-end; }\n}\n",
 	"../etherpk-terminal/layouts/404.html": "{{> shell-top}}\n        <article class=\"post\">\n            <h1 class=\"post-title\">404 :: not published</h1>\n            <div class=\"post-content\">\n                <p>$ the page you followed a link to is not part of this site.</p>\n                <p><a class=\"button inline\" href=\"index.html\">← {{site.title}}</a></p>\n            </div>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-terminal/layouts/archive.html": "{{> shell-top}}\n        <article class=\"post archive\">\n            <h1 class=\"post-title index-title\">{{#page.isPostsArchive}}posts{{/page.isPostsArchive}}{{#page.isJournalArchive}}journal{{/page.isJournalArchive}}</h1>\n            {{#page.isPostsArchive}}\n            {{#site.postsByYear}}\n            <h2 class=\"archive-year\" id=\"y{{year}}\">{{year}}</h2>\n            <ul class=\"archive-list\">\n                {{#posts}}<li><time datetime=\"{{date}}\">{{date}}</time> <a href=\"{{url}}\">{{title}}</a></li>{{/posts}}\n            </ul>\n            {{/site.postsByYear}}\n            {{/page.isPostsArchive}}\n            {{#page.isJournalArchive}}\n            <ul class=\"archive-list\">\n                {{#site.journals}}<li><time datetime=\"{{date}}\">{{date}}</time> <a href=\"{{url}}\">{{title}}</a>{{#excerpt}} <span class=\"archive-excerpt\">{{excerpt}}</span>{{/excerpt}}</li>{{/site.journals}}\n            </ul>\n            {{/page.isJournalArchive}}\n        </article>\n{{> shell-bottom}}\n",
-	"../etherpk-terminal/layouts/home.html": "{{> shell-top}}\n        {{^page.isGeneratedIndex}}\n        <article class=\"post home-info\">\n            <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n        </article>\n        {{/page.isGeneratedIndex}}\n        {{#page.isGeneratedIndex}}\n        <h1 class=\"post-title index-title\">{{site.title}}</h1>\n        {{/page.isGeneratedIndex}}\n        <div class=\"posts\">\n            {{#site.isBlog}}{{#site.recentPosts}}{{> post-entry}}{{/site.recentPosts}}{{^site.hasPosts}}<p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day; a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}{{/site.isBlog}}\n            {{^site.isBlog}}{{#page.isGeneratedIndex}}<div class=\"post-content\">{{{page.content}}}</div>{{/page.isGeneratedIndex}}{{/site.isBlog}}\n        </div>\n        {{#site.isBlog}}{{#site.hasPosts}}\n        <p class=\"all-posts\"><a class=\"button inline\" href=\"{{site.postsUrl}}\">$ ls all {{site.postCount}} posts →</a></p>\n        {{/site.hasPosts}}{{/site.isBlog}}\n{{> shell-bottom}}\n",
+	"../etherpk-terminal/layouts/home.html": "{{> shell-top}}\n        {{^page.isGeneratedIndex}}\n        <article class=\"post home-info\">\n            <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n        </article>\n        {{/page.isGeneratedIndex}}\n        {{#page.isGeneratedIndex}}\n        <h1 class=\"post-title index-title\">{{site.title}}</h1>\n        {{/page.isGeneratedIndex}}\n        <div class=\"posts\">\n            {{#site.isBlog}}{{#site.recentPosts}}{{> post-entry}}{{/site.recentPosts}}{{^site.hasPosts}}<p class=\"post-list-empty\">No dated documents are published yet. A journal entry is dated by its day, a page by a <code>date:</code> line in its frontmatter.</p>{{/site.hasPosts}}{{/site.isBlog}}\n            {{^site.isBlog}}{{#page.isGeneratedIndex}}<div class=\"post-content\">{{{page.content}}}</div>{{/page.isGeneratedIndex}}{{/site.isBlog}}\n        </div>\n        {{#site.isBlog}}{{#site.hasPosts}}\n        <p class=\"all-posts\"><a class=\"button inline\" href=\"{{site.postsUrl}}\">$ ls all {{site.postCount}} posts →</a></p>\n        {{/site.hasPosts}}{{/site.isBlog}}\n{{> shell-bottom}}\n",
 	"../etherpk-terminal/layouts/journal.html": "{{> shell-top}}\n        <article class=\"post\">\n            <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n{{> post-meta}}\n{{> toc}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            <nav class=\"pagination\" aria-label=\"Neighbouring posts\">\n                {{#page.older}}<a class=\"button pagination__prev\" href=\"{{url}}\"><span class=\"button__icon\">←</span><span class=\"button__text\">{{title}}</span></a>{{/page.older}}\n                {{#page.newer}}<a class=\"button pagination__next\" href=\"{{url}}\"><span class=\"button__text\">{{title}}</span><span class=\"button__icon\">→</span></a>{{/page.newer}}\n            </nav>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-terminal/layouts/page.html": "{{> shell-top}}\n        <article class=\"post\">\n            <h1 class=\"post-title\">{{{page.titleHtml}}}</h1>\n{{> post-meta}}\n{{> toc}}\n            <div class=\"post-content\">\n{{{page.content}}}\n            </div>\n            <nav class=\"pagination\" aria-label=\"Neighbouring posts\">\n                {{#page.older}}<a class=\"button pagination__prev\" href=\"{{url}}\"><span class=\"button__icon\">←</span><span class=\"button__text\">{{title}}</span></a>{{/page.older}}\n                {{#page.newer}}<a class=\"button pagination__next\" href=\"{{url}}\"><span class=\"button__text\">{{title}}</span><span class=\"button__icon\">→</span></a>{{/page.newer}}\n            </nav>\n        </article>\n{{> shell-bottom}}\n",
 	"../etherpk-terminal/partials/after-content.html": "",
@@ -14567,7 +14764,7 @@ function seededFiles(publication) {
 	return new Map([
 		[PAGES_WORKFLOW_PATH, `# Publishes this folder to GitHub Pages as it is: the site is already built by EtherPK,
 # so there is no build step. In the repository's Settings → Pages, set the source to
-# "GitHub Actions" once; every push to main then deploys.
+# "GitHub Actions" once - every push to main then deploys.
 name: Deploy to GitHub Pages
 on:
   push:
@@ -14598,7 +14795,7 @@ jobs:
 		[WRANGLER_PATH, `// Cloudflare Workers with static assets (Cloudflare's successor to Pages for new sites).
 // Deploy with \`npx wrangler deploy\`, or connect the repository in the dashboard under
 // Workers → Create → Import a repository and leave the build command empty. The Worker is
-// named after the publication; Cloudflare warns when this name and the Worker's differ.
+// named after the publication - Cloudflare warns when this name and the Worker's differ.
 {
     "name": "${publication.id}",
     "compatibility_date": "2026-01-01",
@@ -14616,9 +14813,9 @@ This folder is a website published by [EtherPK](https://etherpk.com) from the pu
 publish, so edit the notes, the publication page, its include pages and its theme in EtherPK,
 not here.
 
-- Preview: open \`index.html\` in a browser; search works from disk too.
+- Preview: open \`index.html\` in a browser - search works from disk too.
 - GitHub Pages: push this folder to a repository and set Settings → Pages → Source to
-  "GitHub Actions"; \`.github/workflows/pages.yaml\` deploys every push to \`main\`.
+  "GitHub Actions" - \`.github/workflows/pages.yaml\` deploys every push to \`main\`.
 - Cloudflare: \`npx wrangler deploy\` uses \`wrangler.jsonc\`, or connect the repository in the
   Workers dashboard with no build command.
 - Netlify, GitLab Pages, Vercel, S3 or your own server: the folder is plain files, so any of
@@ -14626,7 +14823,7 @@ not here.
 `],
 		[GITIGNORE_PATH, `.DS_Store\nThumbs.db\n`],
 		[ASSETS_IGNORE_PATH, `# Files in this folder that are not part of the website, kept out of the Worker's assets.
-# Written once by EtherPK; yours to edit.
+# Written once by EtherPK - yours to edit.
 .git
 .github
 .gitignore
@@ -14650,15 +14847,15 @@ This folder is a website generated by [EtherPK](https://etherpk.com) from the pu
 \`robots.txt\` and the text outside this section of \`AGENTS.md\` is rewritten on each publish
 and files that are no longer produced are deleted.
 
-- Do not edit the HTML, the assets or \`theme/\` here; the change is lost on the next publish.
+- Do not edit the HTML, the assets or \`theme/\` here - the change is lost on the next publish.
 - Content changes are made to the documents in EtherPK. A document is published when its
   frontmatter says \`public: true\` and names this publication in \`publications: [${publication.id}]\`
   (unless the publication takes every public document).
-- The navigation is the outline of the publication page in EtherPK; the theme and the include
+- The navigation is the outline of the publication page in EtherPK - the theme and the include
   slots (head, logo, header, footer, before-content, after-content, scripts, styles) are chosen
   and edited there too, in the Publish settings and the Theme editor.
 - \`index.html\` opens from disk for a preview. \`.github/workflows/pages.yaml\` deploys the folder
-  to GitHub Pages; \`wrangler.jsonc\` deploys it to Cloudflare Workers; any static host serves it
+  to GitHub Pages, \`wrangler.jsonc\` deploys it to Cloudflare Workers, and any static host serves it
   as it is (https://docs.etherpk.com/hosting-a-published-site).
 
 This section is rewritten by EtherPK on every publish. Put your own notes above or below it.
@@ -15544,7 +15741,7 @@ function buildNav(outline, resolver) {
 						issues.push({
 							level: "warning",
 							code: "nav-entry-not-published",
-							message: `The navigation names "${whole.concept}", which is not in this publication; the entry is left out.`
+							message: `The navigation names "${whole.concept}", which is not in this publication - the entry is left out.`
 						});
 						continue;
 					}
@@ -15565,7 +15762,7 @@ function buildNav(outline, resolver) {
 						issues.push({
 							level: "warning",
 							code: "nav-link-unsafe",
-							message: `The navigation links "${label}" to a target a published page does not carry (only http, https, mailto and site paths); the entry is shown without its link.`
+							message: `The navigation links "${label}" to a target a published page does not carry (only http, https, mailto and site paths) - the entry is shown without its link.`
 						});
 						out.push({
 							label,
@@ -15802,7 +15999,7 @@ async function publishPublication(source, publication, env, options = {}) {
 	if (homeKey !== null && !homeDoc) warnings.push({
 		level: "warning",
 		code: "home-not-published",
-		message: `The home page "${publication.home}" is not in this publication; the front page lists the published pages instead.`
+		message: `The home page "${publication.home}" is not in this publication - the front page lists the published pages instead.`
 	});
 	const allocation = allocateSlugs.withReport(included.filter((d) => d !== homeDoc));
 	const slugs = new Map(allocation.slugs);
@@ -15811,13 +16008,13 @@ async function publishPublication(source, publication, env, options = {}) {
 	for (const c of allocation.collisions) if (c.explicit) warnings.push({
 		level: "warning",
 		code: "slug-taken",
-		message: `"${c.concept}" asks for the address ${c.wanted}.html in its frontmatter, but another document has it; it is at ${c.slug}.html.`,
+		message: `"${c.concept}" asks for the address ${c.wanted}.html in its frontmatter, but another document has it - it is at ${c.slug}.html.`,
 		concept: c.concept
 	});
 	else info.push({
 		level: "info",
 		code: "slug-collision",
-		message: `"${c.concept}" wanted the address ${c.wanted}.html, which another document has; it is at ${c.slug}.html.`,
+		message: `"${c.concept}" wanted the address ${c.wanted}.html, which another document has - it is at ${c.slug}.html.`,
 		concept: c.concept
 	});
 	for (const ignoredSlug of allocation.ignored) {
@@ -15825,7 +16022,7 @@ async function publishPublication(source, publication, env, options = {}) {
 		warnings.push({
 			level: "warning",
 			code: "slug-ignored",
-			message: `"${ignoredSlug.concept}" has \`slug: ${ignoredSlug.value}\`, which ${why}; its address is derived from its name instead.`,
+			message: `"${ignoredSlug.concept}" has \`slug: ${ignoredSlug.value}\`, which ${why} - its address is derived from its name instead.`,
 			concept: ignoredSlug.concept
 		});
 	}
@@ -15875,12 +16072,12 @@ async function publishPublication(source, publication, env, options = {}) {
 	if (theme.manifest.contract < 1) warnings.push({
 		level: "warning",
 		code: "theme-older-contract",
-		message: `The theme "${theme.manifest.name}" was written for view contract ${theme.manifest.contract}; this EtherPK writes contract 1. It is rendered as is; newer view fields are simply absent to it.`
+		message: `The theme "${theme.manifest.name}" was written for view contract ${theme.manifest.contract} - this EtherPK writes contract 1. It is rendered as is - newer view fields are simply absent to it.`
 	});
 	if (!theme.manifest.kinds.includes(publication.kind)) warnings.push({
 		level: "warning",
 		code: "theme-kind-mismatch",
-		message: `The theme "${theme.manifest.name}" is made for ${theme.manifest.kinds.join(" and ")} publications; this one is ${publication.kind}.`
+		message: `The theme "${theme.manifest.name}" is made for ${theme.manifest.kinds.join(" and ")} publications - this one is ${publication.kind}.`
 	});
 	const includeDocs = /* @__PURE__ */ new Map();
 	for (const [slot, concept] of Object.entries(publication.includes)) {
@@ -15890,7 +16087,7 @@ async function publishPublication(source, publication, env, options = {}) {
 			warnings.push({
 				level: "warning",
 				code: "include-page-missing",
-				message: `The include "${slot}" names "${concept}", which is not a document in this graph; the theme's own ${slot} is used.`
+				message: `The include "${slot}" names "${concept}", which is not a document in this graph - the theme's own ${slot} is used.`
 			});
 			continue;
 		}
@@ -15905,7 +16102,7 @@ async function publishPublication(source, publication, env, options = {}) {
 			warnings.push({
 				level: "warning",
 				code: `include-page-${status}`,
-				message: `The include "${slot}" names "${concept}", which ${why}; the theme's own ${slot} is used.`
+				message: `The include "${slot}" names "${concept}", which ${why} - the theme's own ${slot} is used.`
 			});
 			continue;
 		}
@@ -16019,7 +16216,7 @@ async function publishPublication(source, publication, env, options = {}) {
 			warnings.push({
 				level: "warning",
 				code: "include-unknown-slot",
-				message: `The theme "${theme.manifest.name}" has no include slot "${slot}"; the page "${doc.concept}" is not used.`
+				message: `The theme "${theme.manifest.name}" has no include slot "${slot}" - the page "${doc.concept}" is not used.`
 			});
 			continue;
 		}
@@ -16030,7 +16227,7 @@ async function publishPublication(source, publication, env, options = {}) {
 				warnings.push({
 					level: "warning",
 					code: "include-no-css",
-					message: `The include "${slot}" names "${doc.concept}", which has no \`css\` fence; nothing is appended to the stylesheet.`
+					message: `The include "${slot}" names "${doc.concept}", which has no \`css\` fence - nothing is appended to the stylesheet.`
 				});
 				continue;
 			}
@@ -16206,7 +16403,7 @@ async function publishPublication(source, publication, env, options = {}) {
 			warnings.push({
 				level: "warning",
 				code: "asset-missing",
-				message: `"${from}" references ${name}, which the graph does not hold; the link is left as it is.`,
+				message: `"${from}" references ${name}, which the graph does not hold - the link is left as it is.`,
 				concept: from
 			});
 			continue;
@@ -16222,7 +16419,7 @@ async function publishPublication(source, publication, env, options = {}) {
 		else warnings.push({
 			level: "warning",
 			code: "katex-assets-unavailable",
-			message: "The publication has maths but this host has no KaTeX stylesheet to copy in; formulas will render unstyled."
+			message: "The publication has maths but this host has no KaTeX stylesheet to copy in - formulas will render unstyled."
 		});
 	}
 	const search = pages.map((p) => ({
@@ -16256,7 +16453,7 @@ async function publishPublication(source, publication, env, options = {}) {
 	} else info.push({
 		level: "info",
 		code: "no-site-url",
-		message: "The publication has no `url`, so no sitemap or feed is written; add one to the publication page to get both."
+		message: "The publication has no `url`, so no sitemap or feed is written - add one to the publication page to get both."
 	});
 	bundle.set(".nojekyll", "");
 	const external = /* @__PURE__ */ new Set();
@@ -16267,7 +16464,7 @@ async function publishPublication(source, publication, env, options = {}) {
 	if (pages.some((p) => p.rendered.mermaidFallback)) warnings.push({
 		level: "warning",
 		code: "mermaid-not-prerendered",
-		message: "A diagram was not pre-rendered on this host and is left as its source; publish from the browser, or run `etherpk-mcp publish setup`, to get inline SVG."
+		message: "A diagram was not pre-rendered on this host and is left as its source - publish from the browser, or run `etherpk-mcp diagrams setup`, to get inline SVG."
 	});
 	progress("writing", pages.length + 3, pages.length + 3);
 	report.ok = errors.length === 0;
@@ -16360,7 +16557,7 @@ async function fetchTheme(url, fetchText) {
 	const { manifest, errors } = parseThemeManifest(json);
 	if (!manifest) throw new Error(`The theme at ${url} cannot be used: ${errors.join(" ")}`);
 	if (manifest.files.length === 0) throw new Error(`The theme at ${url} lists no files in its manifest, so nothing can be fetched.`);
-	if (manifest.files.length > MAX_URL_THEME_FILES) throw new Error(`The theme at ${url} lists ${manifest.files.length} files; a theme may list at most ${MAX_URL_THEME_FILES}.`);
+	if (manifest.files.length > MAX_URL_THEME_FILES) throw new Error(`The theme at ${url} lists ${manifest.files.length} files - a theme may list at most ${MAX_URL_THEME_FILES}.`);
 	const base = new URL(url);
 	const files = /* @__PURE__ */ new Map();
 	for (const path of manifest.files) {
@@ -16456,7 +16653,7 @@ function publicationMapping(input) {
 * page whose purpose was anyone's guess (2026-09-19).
 */
 function publicationPageIntro(name) {
-	return `This page defines the publication "${name}". Its settings are the frontmatter above; edit them in Settings → Publish rather than here. The outline below is the site's navigation: one bullet per menu entry, written as a wikilink to the page; nested bullets are sub-entries; a plain bullet with children is a group; a markdown link is an outside link. A page that is public and in this publication but not listed here is still on the site, reachable by search and links, just not in the menu.`;
+	return `This page defines the publication "${name}". Its settings are the frontmatter above - edit them in Settings → Publish rather than here. The outline below is the site's navigation: one bullet per menu entry, written as a wikilink to the page. Nested bullets are sub-entries, a plain bullet with children is a group, and a markdown link is an outside link. A page that is public and in this publication but not listed here is still on the site, reachable by search and links, just not in the menu.`;
 }
 /**
 * Create a publication page: a page whose frontmatter defines the publication and whose body
@@ -16610,7 +16807,7 @@ async function setupDiagrams(env, say) {
 	}
 	const cli = require$1.resolve("playwright-core/cli.js");
 	const dir = env.PLAYWRIGHT_BROWSERS_PATH?.trim() || browsersDir(env);
-	say(`Installing Chromium into ${dir} (about 170 MB, once per computer; a diagram is rendered by a browser, and this is the one etherpk-mcp drives)…`);
+	say(`Installing Chromium into ${dir} (about 170 MB, once per computer - a diagram is rendered by a browser, and this is the one etherpk-mcp drives)…`);
 	await new Promise((resolve, reject) => {
 		const child = spawn(process.execPath, [
 			cli,
@@ -16636,7 +16833,7 @@ async function setupDiagrams(env, say) {
 		child.on("close", (code) => code === 0 ? resolve() : reject(/* @__PURE__ */ new Error(`Playwright's installer exited with code ${code}.`)));
 	});
 	const after = await chromiumStatus(env);
-	if (!after.executable) throw new Error("The installer finished but no Chromium executable was found; set ETHERPK_CHROMIUM to a browser on this machine instead.");
+	if (!after.executable) throw new Error("The installer finished but no Chromium executable was found - set ETHERPK_CHROMIUM to a browser on this machine instead.");
 	say(`Chromium is set up: ${after.executable}`);
 	return after;
 }
@@ -17166,6 +17363,243 @@ async function writeDownload(directory, name, bytes) {
 	}
 	throw new Error(`${directory} already holds a thousand files named like ${safe}.`);
 }
+//#endregion
+//#region ../client/src/lib/navigation/document-url.ts
+/** Encode a concept for the `[...concept]` rest param: per-segment, `/` kept. */
+function encodeConceptPath(concept) {
+	return concept.split("/").map(encodeURIComponent).join("/");
+}
+/** The Document URL for a concept within a graph. */
+function documentUrl(graphId, concept) {
+	return `${graphUrl(graphId)}/d/${encodeConceptPath(concept)}`;
+}
+/** The bare workspace URL for a graph. */
+function graphUrl(graphId) {
+	return `/g/${encodeURIComponent(graphId)}`;
+}
+/**
+* The words that identify a task while its tags change: the text after the checkbox and the tag
+* run, whitespace collapsed and Unicode NFC applied. A task written as tags alone is its tags.
+*/
+function taskWords(label) {
+	return (parseTaskTags(label).text || label).normalize("NFC").replace(/\s+/g, " ").trim();
+}
+/** The fingerprint of a task's words, from its label (tag run included or not). */
+async function taskFingerprint(label) {
+	const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(taskWords(label)));
+	return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("").slice(0, 12);
+}
+/** The reference's address: the Document URL with the task in its fragment, which a browser never sends. */
+function taskReferenceUrl(reference, origin = "") {
+	return `${origin}${documentUrl(reference.graphId, reference.document)}#task=${reference.line}-${reference.fingerprint}`;
+}
+var REFERENCE = /\/g\/([^/?#\s]+)\/d\/([^?#\s]+?)(?:\?[^#\s]*)?#task=(\d+)-([0-9a-f]{12})(?![0-9a-f])/;
+/**
+* The reference in `input`: the two lines as copied, the address alone, with any origin or none,
+* or null when `input` holds none.
+*/
+function parseTaskReference(input) {
+	const match = REFERENCE.exec(input);
+	if (!match) return null;
+	const [, graph, path, line, fingerprint] = match;
+	try {
+		return {
+			graphId: decodeURIComponent(graph),
+			document: path.split("/").map(decodeURIComponent).join("/"),
+			line: Number(line),
+			fingerprint
+		};
+	} catch {
+		return null;
+	}
+}
+/**
+* Find the task a reference names. First the named document's line, when the words there match;
+* then the one task in that document with those words; then the one task in the graph. None is
+* `task_not_found`, more than one `task_ambiguous`, since acting on a guess could change the
+* wrong task. A document that no longer answers to its name goes straight to the graph.
+*/
+async function resolveTaskReference(reference, sources) {
+	if (sources.graphId !== null && sources.graphId !== reference.graphId) return {
+		ok: false,
+		code: "other_graph",
+		servedGraphId: sources.graphId
+	};
+	const named = sources.resolveDocument(reference.document);
+	if (named !== null) {
+		const body = await sources.readBody(named);
+		if (body !== null) {
+			const matches = await taskLinesWith(body.split("\n"), reference.fingerprint);
+			if (matches.includes(reference.line)) return {
+				ok: true,
+				document: named,
+				line: reference.line,
+				body,
+				foundBy: "at_line"
+			};
+			if (matches.length === 1) return {
+				ok: true,
+				document: named,
+				line: matches[0],
+				body,
+				foundBy: "moved"
+			};
+			if (matches.length > 1) return {
+				ok: false,
+				code: "task_ambiguous",
+				candidates: matches.map((line) => ({
+					document: named,
+					line
+				}))
+			};
+		}
+	}
+	const found = [];
+	const looked = new Set(named === null ? [] : [named.toLowerCase()]);
+	for (const task of await sources.allTasks()) {
+		if (looked.has(task.document.toLowerCase())) continue;
+		if (await taskFingerprint(task.label) !== reference.fingerprint) continue;
+		looked.add(task.document.toLowerCase());
+		const body = await sources.readBody(task.document);
+		if (body === null) continue;
+		for (const line of await taskLinesWith(body.split("\n"), reference.fingerprint)) found.push({
+			document: task.document,
+			line,
+			body
+		});
+	}
+	if (found.length === 1) return {
+		ok: true,
+		...found[0],
+		foundBy: "other_document"
+	};
+	if (found.length > 1) return {
+		ok: false,
+		code: "task_ambiguous",
+		candidates: found.map(({ document, line }) => ({
+			document,
+			line
+		}))
+	};
+	return {
+		ok: false,
+		code: "task_not_found"
+	};
+}
+/** How many tasks `everyIndexedTask` asks the index for at a time. */
+var INDEX_PAGE = 500;
+/** Every task the index knows, in pages, as {@link TaskReferenceSources.allTasks} wants them. */
+async function everyIndexedTask(index, today) {
+	const query = {
+		concept: null,
+		statuses: TASK_STATUSES,
+		priorities: TASK_PRIORITY_FILTERS,
+		due: "any",
+		groupBy: "document",
+		today
+	};
+	const out = [];
+	for (let offset = 0;; offset += INDEX_PAGE) {
+		const page = await index.tasks(query, offset, INDEX_PAGE);
+		for (const hit of page.hits) out.push({
+			document: hit.concept,
+			line: hit.line,
+			label: hit.text
+		});
+		if (!page.hasMore) return out;
+	}
+}
+/** The lines of `lines` that hold a task with this fingerprint, never one inside a code fence. */
+async function taskLinesWith(lines, fingerprint) {
+	const inFence = /* @__PURE__ */ new Set();
+	for (const block of fencedBlocks(lines)) for (let i = block.start; i <= block.end; i++) inFence.add(i);
+	const out = [];
+	for (let i = 0; i < lines.length; i++) {
+		if (inFence.has(i) || parseTaskLine(lines[i]) === null) continue;
+		if (await taskFingerprint(bulletLabel(lines[i])) === fingerprint) out.push(i);
+	}
+	return out;
+}
+//#endregion
+//#region ../client/src/lib/document/view/minimal-replacement.ts
+/**
+* The smallest single replacement turning `text` into `next`: the shared prefix and suffix
+* trimmed away. Null when the two are equal.
+*
+* Used wherever a whole new text arrives for a document that is being edited - a heal, an
+* external write reaching an open editor - so that the change is the change and nothing more
+* (ADR 0066): on a synced graph a whole-document replace is one enormous CRDT operation that
+* clobbers everyone else's concurrent edits, and in any editor it throws the caret to the end.
+*/
+function minimalReplacement(text, next) {
+	if (next === text) return null;
+	let prefix = 0;
+	while (prefix < text.length && prefix < next.length && text[prefix] === next[prefix]) prefix++;
+	let suffix = 0;
+	while (suffix < text.length - prefix && suffix < next.length - prefix && text[text.length - 1 - suffix] === next[next.length - 1 - suffix]) suffix++;
+	return {
+		from: prefix,
+		to: text.length - suffix,
+		insert: next.slice(prefix, next.length - suffix)
+	};
+}
+//#endregion
+//#region ../client/src/lib/document/task-write.ts
+var MARKER = /^(\s*-\s+\[)[ xX](\])\s?/;
+/**
+* `line` with `changes` made, or null when `line` is not a task.
+*
+* A changed tag run is written in the fixed order the `#` helper writes (`serialiseTags`), for
+* the reason `applyTaskTag` gives: the run is a set, and a predictable order is worth more than
+* one that carries no meaning. A task already as asked comes back untouched, so a move that
+* changes nothing reorders nothing either.
+*/
+function taskLineWith(line, changes) {
+	const parsed = parseTaskLine(line);
+	const marker = MARKER.exec(line);
+	if (!parsed || !marker) return null;
+	const { done: wasDone, ...current } = parsed;
+	const tags = { ...current };
+	let done = wasDone;
+	switch (changes.status) {
+		case "open":
+			done = false;
+			tags.waiting = tags.doing = tags.cancelled = false;
+			break;
+		case "doing":
+			done = false;
+			tags.doing = true;
+			tags.waiting = tags.cancelled = false;
+			break;
+		case "waiting":
+			done = false;
+			tags.waiting = true;
+			tags.doing = tags.cancelled = false;
+			break;
+		case "done":
+			done = true;
+			tags.waiting = tags.doing = tags.cancelled = false;
+			break;
+		case "cancelled":
+			done = true;
+			tags.cancelled = true;
+			tags.waiting = tags.doing = false;
+			break;
+		case void 0: break;
+	}
+	if (changes.priority !== void 0) tags.priority = changes.priority;
+	if (changes.due !== void 0) tags.due = changes.due;
+	if (changes.scheduled !== void 0) tags.scheduled = changes.scheduled;
+	if (done === wasDone && sameTags(tags, current)) return line;
+	return [
+		`${marker[1]}${done ? "x" : " "}${marker[2]}`,
+		...serialiseTags(tags),
+		tags.text
+	].filter((part) => part !== "").join(" ");
+}
+function sameTags(a, b) {
+	return a.priority === b.priority && a.waiting === b.waiting && a.doing === b.doing && a.cancelled === b.cancelled && a.due === b.due && a.scheduled === b.scheduled && a.completion === b.completion;
+}
 /** UTF-16 units of document text returned before `truncated` is set. */
 var READ_TEXT_CAP = 2e5;
 /** A refusal the agent can act on: a stable code first, a sentence second. */
@@ -17267,7 +17701,7 @@ async function liveText(graph, identity) {
 	return graph.store.open(identity.concept).getText();
 }
 function refuseIfProtected(concept, text) {
-	if (documentProtection(text).kind === "document") throw new ToolError("protected_document", `"${concept}" is a protected document. Its content is encrypted under a key this client never holds, so it cannot be read or changed here; the user can unlock it in EtherPK.`);
+	if (documentProtection(text).kind === "document") throw new ToolError("protected_document", `"${concept}" is a protected document. Its content is encrypted under a key this client never holds, so it cannot be read or changed here - the user can unlock it in EtherPK.`);
 }
 function page$1(items, offset, limit) {
 	return {
@@ -17444,7 +17878,7 @@ async function tasks(graph, args = {}) {
 		today: todayISO()
 	}, offset, limit);
 	return {
-		tasks: result.hits.map((hit) => ({
+		tasks: await Promise.all(result.hits.map(async (hit) => ({
 			concept: hit.concept,
 			kind: hit.kind,
 			line: hit.line,
@@ -17457,12 +17891,20 @@ async function tasks(graph, args = {}) {
 			due: hit.due,
 			scheduled: hit.scheduled,
 			completion: hit.completion,
-			breadcrumb: hit.breadcrumb
-		})),
+			breadcrumb: hit.breadcrumb,
+			reference: await referenceFor(graph, hit.concept, hit.line, hit.text)
+		}))),
 		total: result.total,
 		hasMore: result.hasMore
 	};
 }
+/**
+* Text an agent sent, in the form EtherPK writes: line feeds only (ADR 0112), then the
+* two-space Indent Unit (ADR 0067). Line endings go first so the normaliser reads whole lines.
+*/
+function asWritten(text) {
+	return normaliseIndentUnit(lineFeedsOnly(text));
+}
 async function editDocument(graph, args) {
 	if (args.old === "") throw new ToolError("invalid_argument", "old must not be empty.");
 	await graph.store.refresh();
@@ -17470,9 +17912,9 @@ async function editDocument(graph, args) {
 	const text = await liveText(graph, identity);
 	refuseIfProtected(identity.concept, text);
 	const first = text.indexOf(args.old);
-	if (first === -1) throw new ToolError("no_match", `"${identity.concept}" does not contain the text to replace. Read the document again; it may have changed.`);
+	if (first === -1) throw new ToolError("no_match", `"${identity.concept}" does not contain the text to replace. Read the document again - it may have changed.`);
 	if (text.indexOf(args.old, first + 1) !== -1) throw new ToolError("ambiguous_match", `The text to replace occurs more than once in "${identity.concept}". Include more surrounding text so it matches exactly once.`);
-	const insert = normaliseIndentUnit(args.new);
+	const insert = asWritten(args.new);
 	graph.store.open(identity.concept).applyChange({
 		from: first,
 		to: first + args.old.length,
@@ -17486,7 +17928,7 @@ async function editDocument(graph, args) {
 	};
 }
 async function appendDocument(graph, args) {
-	const text = normaliseIndentUnit(args.text);
+	const text = asWritten(args.text);
 	if (text.trim() === "") throw new ToolError("invalid_argument", "text must not be empty.");
 	const target = args.concept.trim() === "today" ? todayISO() : args.concept.trim();
 	await graph.store.refresh();
@@ -17517,10 +17959,10 @@ async function appendDocument(graph, args) {
 async function createPage(graph, args) {
 	const title = args.title.trim();
 	if (title === "") throw new ToolError("invalid_argument", "title must not be empty.");
-	if (isJournalConcept(title)) throw new ToolError("invalid_argument", `"${title}" is a calendar day, so it names a journal entry; use append_document to write to it.`);
+	if (isJournalConcept(title)) throw new ToolError("invalid_argument", `"${title}" is a calendar day, so it names a journal entry - use append_document to write to it.`);
 	await graph.store.refresh();
 	if (resolveIdentity(graph, title)) throw new ToolError("already_exists", `A document already answers to "${title}". Use edit_document or append_document instead.`);
-	await graph.store.createPage(title, normaliseIndentUnit(args.text ?? ""));
+	await graph.store.createPage(title, asWritten(args.text ?? ""));
 	if (args.frontmatter && Object.keys(args.frontmatter).length > 0) {
 		await graph.store.whenReady(title);
 		const raw = graph.store.openRaw(title).getText();
@@ -17847,7 +18289,7 @@ async function listAssets(graph, args = {}) {
 */
 async function readDocuments(graph, args) {
 	if (!Array.isArray(args.concepts) || args.concepts.length === 0) throw new ToolError("invalid_argument", "concepts must be a non-empty list of names.");
-	if (args.concepts.length > 20) throw new ToolError("too_many", `At most 20 documents per call; ask again for the rest.`);
+	if (args.concepts.length > 20) throw new ToolError("too_many", `At most 20 documents per call - ask again for the rest.`);
 	await graph.store.refresh();
 	let budget = READ_MANY_TEXT_CAP;
 	const documents = [];
@@ -17884,22 +18326,25 @@ async function readDocuments(graph, args) {
 	}
 	return { documents };
 }
-/** The task line rebuilt with these tags and checkbox: indent and marker kept, the tag run in the fixed order. */
-function taskLineWith(line, done, tags) {
-	const marker = /^(\s*-\s+\[)[ xX](\])\s?/.exec(line);
-	if (!marker) throw new Error("not a task line");
-	const run = serialiseTags(tags);
-	return `${marker[1]}${done ? "x" : " "}${marker[2]} ${[...run, tags.text].join(" ")}`.replace(/\s+$/, "");
-}
 /**
 * Change one task's status, priority or dates, by document and line (ADR 0032's grammar).
-* Status is exclusive and means what the index's own derivation means: `waiting` and `doing`
-* are unchecked states, `done` and `cancelled` checked ones, `open` none of them. The Client's
-* checkbox writes no completion date, so neither does this. `expect` is the stale-line guard:
-* the same one the Tasks View applies, made explicit for a caller working from a list.
+* The line is rewritten by the writer a Kanban Board move uses (`task-write.ts`), so a status
+* here means exactly what a lane means: exclusive, `waiting` and `doing` unchecked states, `done`
+* and `cancelled` checked ones, `open` none of them, and no completion date written. `expect` is
+* the stale-line guard, made explicit for a caller working from a list.
 */
 async function setTask(graph, args) {
-	if (!Number.isInteger(args.line) || args.line < 0) throw new ToolError("invalid_argument", "line must be a non-negative integer.");
+	if (args.reference !== void 0) {
+		const found = await requireReferencedTask(graph, args.reference);
+		return setTask(graph, {
+			concept: found.document,
+			line: found.line,
+			changes: args.changes
+		});
+	}
+	if (args.concept === void 0) throw new ToolError("invalid_argument", "Name the task by reference, or by concept and line.");
+	if (args.line === void 0 || !Number.isInteger(args.line) || args.line < 0) throw new ToolError("invalid_argument", "line must be a non-negative integer.");
+	const line = args.line;
 	const changes = args.changes ?? {};
 	if (changes.status !== void 0 && !TASK_STATUSES.includes(changes.status)) throw new ToolError("invalid_argument", `Unknown task status "${String(changes.status)}".`);
 	if (changes.priority !== void 0 && changes.priority !== null && ![
@@ -17913,49 +18358,19 @@ async function setTask(graph, args) {
 	const text = await liveText(graph, identity);
 	refuseIfProtected(identity.concept, text);
 	const lines = text.split("\n");
-	const current = lines[args.line];
+	const current = lines[line];
 	const parsed = current === void 0 ? null : parseTaskLine(current);
-	if (!parsed) throw new ToolError("task_moved", `Line ${args.line} of "${identity.concept}" is not a task now; read the document or list tasks again.`);
+	if (!parsed) throw new ToolError("task_moved", `Line ${line} of "${identity.concept}" is not a task now - read the document or list tasks again.`);
 	const afterCheckbox = current.replace(/^\s*-\s+\[[ xX]\]\s?/, "").trim();
-	if (args.expect !== void 0 && args.expect.trim() !== afterCheckbox && args.expect.trim() !== parsed.text.trim()) throw new ToolError("task_moved", `Line ${args.line} of "${identity.concept}" now reads "${parsed.text}", not "${args.expect}"; list tasks again before changing it.`);
-	const tags = { ...parsed };
-	let done = parsed.done;
-	switch (changes.status) {
-		case "open":
-			done = false;
-			tags.waiting = tags.doing = tags.cancelled = false;
-			break;
-		case "doing":
-			done = false;
-			tags.doing = true;
-			tags.waiting = tags.cancelled = false;
-			break;
-		case "waiting":
-			done = false;
-			tags.waiting = true;
-			tags.doing = tags.cancelled = false;
-			break;
-		case "done":
-			done = true;
-			tags.waiting = tags.doing = tags.cancelled = false;
-			break;
-		case "cancelled":
-			done = true;
-			tags.cancelled = true;
-			tags.waiting = tags.doing = false;
-			break;
-		case void 0: break;
-	}
-	if (changes.priority !== void 0) tags.priority = changes.priority;
-	if (changes.due !== void 0) tags.due = changes.due;
-	if (changes.scheduled !== void 0) tags.scheduled = changes.scheduled;
-	const next = taskLineWith(current, done, tags);
-	if (next !== current) {
-		const from = lines.slice(0, args.line).reduce((n, l) => n + l.length + 1, 0);
+	if (args.expect !== void 0 && args.expect.trim() !== afterCheckbox && args.expect.trim() !== parsed.text.trim()) throw new ToolError("task_moved", `Line ${line} of "${identity.concept}" now reads "${parsed.text}", not "${args.expect}" - list tasks again before changing it.`);
+	const next = taskLineWith(current, changes) ?? current;
+	const edit = minimalReplacement(current, next);
+	if (edit) {
+		const from = lines.slice(0, line).reduce((n, l) => n + l.length + 1, 0);
 		graph.store.open(identity.concept).applyChange({
-			from,
-			to: from + current.length,
-			insert: next
+			from: from + edit.from,
+			to: from + edit.to,
+			insert: edit.insert
 		}, "external");
 		await settle$2(graph);
 	}
@@ -17963,13 +18378,124 @@ async function setTask(graph, args) {
 	const status = after.done ? after.cancelled ? "cancelled" : "done" : after.waiting ? "waiting" : after.doing ? "doing" : "open";
 	return {
 		concept: identity.concept,
-		line: args.line,
+		line,
 		text: after.text,
 		status,
 		priority: after.priority,
 		due: after.due,
 		scheduled: after.scheduled,
-		changed: next !== current
+		changed: next !== current,
+		reference: await referenceFor(graph, identity.concept, line, bulletLabel(next))
+	};
+}
+/** A task's status from its parsed line, as the index derives it (`STATUS_SQL`). */
+function statusOf(task) {
+	return task.done ? task.cancelled ? "cancelled" : "done" : task.waiting ? "waiting" : task.doing ? "doing" : "open";
+}
+/** Where a Task Reference is resolved in this graph: its documents, read live, and its index. */
+function referenceSources(graph) {
+	return {
+		graphId: graph.backend.kind === "synced" ? graph.graphId : null,
+		resolveDocument: (name) => resolveIdentity(graph, name)?.concept ?? null,
+		async readBody(document) {
+			const identity = resolveIdentity(graph, document);
+			if (!identity) return null;
+			const text = await liveText(graph, identity);
+			return documentProtection(text).kind === "document" ? null : text;
+		},
+		allTasks: () => everyIndexedTask(graph.index, todayISO())
+	};
+}
+/** The Task Reference to the task at `line` of `concept`, whose label is `label`. */
+async function referenceFor(graph, concept, line, label) {
+	const fingerprint = await taskFingerprint(label);
+	return taskReferenceUrl({
+		graphId: graph.graphId,
+		document: concept,
+		line,
+		fingerprint
+	}, graph.clientUrl ?? "");
+}
+/** The task a Task Reference names in this graph, or the error that says why there is none. */
+async function requireReferencedTask(graph, reference) {
+	const parsed = parseTaskReference(reference);
+	if (!parsed) throw new ToolError("invalid_argument", "That is not a task reference: one ends in #task=<line>-<fingerprint>, as Copy task reference in EtherPK writes it.");
+	await graph.store.refresh();
+	const found = await resolveTaskReference(parsed, referenceSources(graph));
+	if (found.ok) return found;
+	if (found.code === "other_graph") throw new ToolError("other_graph", `That task reference is for another graph. This server serves "${graph.name}" (${found.servedGraphId}); ask the user to connect the graph the reference is from.`);
+	if (found.code === "task_ambiguous") throw new ToolError("task_ambiguous", `More than one task has those words (${found.candidates.map((candidate) => `"${candidate.document}" line ${candidate.line}`).join(", ")}), so none was chosen. Ask the user which one, or name it by concept and line.`);
+	throw new ToolError("task_not_found", "No task in the graph has those words now: it was edited or deleted. Ask the user for a fresh reference.");
+}
+/**
+* The block's own lines and everything nested under it: in the index's rows, which run in
+* document order, the rows after it until one that is not its descendant.
+*/
+function subtreeEnd(blocks, localId) {
+	let end = blocks[localId].endLine;
+	const inside = new Set([localId]);
+	for (let i = localId + 1; i < blocks.length; i++) {
+		const parent = blocks[i].parentId;
+		if (parent === null || !inside.has(parent)) break;
+		inside.add(i);
+		end = Math.max(end, blocks[i].endLine);
+	}
+	return end;
+}
+/**
+* The task a Task Reference names: its words and tags, where it is now, what is above it (the
+* headings and bullets its breadcrumb names) and its detail (its continuation lines and
+* everything nested under it), and how it was found. For the text around it, read the document.
+*/
+async function readTask(graph, args) {
+	const found = await requireReferencedTask(graph, args.reference);
+	const lines = found.body.split("\n");
+	const line = lines[found.line];
+	const task = parseTaskLine(line);
+	const { blocks } = deriveDoc(found.body);
+	const block = blocks.find((candidate) => candidate.startLine === found.line);
+	const end = block ? subtreeEnd(blocks, block.localId) : found.line;
+	return {
+		concept: found.document,
+		line: found.line,
+		text: task.text,
+		status: statusOf(task),
+		priority: task.priority,
+		due: task.due,
+		scheduled: task.scheduled,
+		breadcrumb: block ? ancestorChain(blocks, block.parentId) : [],
+		detail: lines.slice(found.line + 1, end + 1).join("\n"),
+		foundBy: found.foundBy,
+		reference: await referenceFor(graph, found.document, found.line, bulletLabel(line))
+	};
+}
+/**
+* Add a note under the task a Task Reference names: the text as a bullet one level under the
+* task, after its existing detail, so a Kanban Board's Task Detail shows it with the task. Text
+* that is already bullets is nested as it is.
+*/
+async function addTaskNote(graph, args) {
+	if (typeof args.text !== "string" || args.text.trim() === "") throw new ToolError("invalid_argument", "text must not be empty.");
+	const found = await requireReferencedTask(graph, args.reference);
+	const lines = found.body.split("\n");
+	const { blocks } = deriveDoc(found.body);
+	const block = blocks.find((candidate) => candidate.startLine === found.line);
+	const end = block ? subtreeEnd(blocks, block.localId) : found.line;
+	const childIndent = `${/^\s*/.exec(lines[found.line])[0]}  `;
+	const written = asWritten(args.text.trim());
+	const insert = (written.startsWith("- ") ? written : `- ${written.replace(/\n/g, "\n  ")}`).split("\n").map((noteLine) => noteLine === "" ? noteLine : childIndent + noteLine).join("\n");
+	const at = lines.slice(0, end + 1).reduce((n, l) => n + l.length + 1, 0) - 1;
+	graph.store.open(found.document).applyChange({
+		from: at,
+		to: at,
+		insert: `\n${insert}`
+	}, "external");
+	await settle$2(graph);
+	return {
+		concept: found.document,
+		line: found.line,
+		noteLine: end + 1,
+		reference: await referenceFor(graph, found.document, found.line, bulletLabel(lines[found.line]))
 	};
 }
 /** What an agent should know before it starts: where it is, what is here, what is set up. */
@@ -17994,7 +18520,7 @@ async function graphInfo(graph) {
 			complete: status.embedded >= status.total
 		} : {
 			state: "not-opened",
-			note: "The first search with mode \"semantic\" loads the model; if it is not set up on this computer, that search says so and names the command."
+			note: "The first search with mode \"semantic\" loads the model - if it is not set up on this computer, that search says so and names the command."
 		},
 		assets: { available: graph.assets !== void 0 }
 	};
@@ -18110,7 +18636,7 @@ async function createPublication(graph, args, host) {
 	await graph.store.refresh();
 	const before = summarisePublishing((await graph.publishing.readSource()).source);
 	if (before.publications.some((p) => p.id === id)) throw new ToolError("already_exists", `A publication with the id "${id}" already exists (page "${before.publications.find((p) => p.id === id).concept}").`);
-	if (graph.store.listDocuments().some((d) => d.key === title.toLowerCase() || d.aliases.some((a) => a.toLowerCase() === title.toLowerCase()))) throw new ToolError("already_exists", `A document already answers to "${title}"; choose another title for the publication page.`);
+	if (graph.store.listDocuments().some((d) => d.key === title.toLowerCase() || d.aliases.some((a) => a.toLowerCase() === title.toLowerCase()))) throw new ToolError("already_exists", `A document already answers to "${title}" - choose another title for the publication page.`);
 	if (args.theme) await requireTheme(graph, args.theme);
 	const store = frontmatterStore(graph);
 	const concept = await createPublicationPage(store, {
@@ -18363,8 +18889,8 @@ var SAMPLE_SOURCE = {
 			""
 		].join("\n")),
 		page("[[Getting Started]] Installing", "---\npublic: true\n---\n- A scoped concept: its heading links to its scope. Back to [[Getting Started]].\n"),
-		page("Wikilinks", "---\npublic: true\naliases: [Links]\n---\n- `[[Concept]]` links to a page; an alias like [[Links]] resolves to this one.\n", ["Links"]),
-		page("Private Notes", "- Not public, so never on the site; links to it are styled as missing.\n"),
+		page("Wikilinks", "---\npublic: true\naliases: [Links]\n---\n- `[[Concept]]` links to a page - an alias like [[Links]] resolves to this one.\n", ["Links"]),
+		page("Private Notes", "- Not public, so never on the site - links to it are styled as missing.\n"),
 		{
 			concept: "2026-06-02",
 			kind: "journal",
@@ -18587,7 +19113,7 @@ async function customisePublicationTheme(graph, args) {
 	await graph.store.refresh();
 	const { source } = await graph.publishing.readSource();
 	const publication = summarisePublishing(source).publications.find((p) => p.id === args.publication.trim());
-	if (!publication) throw new ToolError("publication_not_found", `No publication has the id "${args.publication}"; list_publications shows them.`);
+	if (!publication) throw new ToolError("publication_not_found", `No publication has the id "${args.publication}" - list_publications shows them.`);
 	const current = await graph.themes.get(publication.theme);
 	if (current) return {
 		created: false,
@@ -18623,7 +19149,7 @@ async function requireEditable(graph, id) {
 	const own = await graph.themes.get(id);
 	if (own) return own;
 	if (bundledTheme(id)) throw new ToolError("theme_not_editable", `"${id}" is a bundled theme and cannot be edited in place. create_theme (or customise_publication_theme for the publication that uses it) makes a copy in the graph that can be.`);
-	throw new ToolError("theme_not_found", `No theme in this graph is called "${id}"; list_themes shows them.`);
+	throw new ToolError("theme_not_found", `No theme in this graph is called "${id}" - list_themes shows them.`);
 }
 function requireThemePath(path) {
 	const clean = path.trim().replace(/^\.?\//, "");
@@ -18723,7 +19249,7 @@ async function importThemeFolder(graph, args) {
 	} catch (error) {
 		throw new ToolError("invalid_argument", `Cannot read "${args.dir}": ${error instanceof Error ? error.message : String(error)}`);
 	}
-	if (!files.has("theme.json")) throw new ToolError("invalid_argument", `"${args.dir}" has no theme.json; a theme folder has one at its top.`);
+	if (!files.has("theme.json")) throw new ToolError("invalid_argument", `"${args.dir}" has no theme.json - a theme folder has one at its top.`);
 	const next = {
 		...theme,
 		files: Object.fromEntries(files),
@@ -18745,7 +19271,7 @@ async function deleteTheme(graph, args) {
 	await graph.store.refresh();
 	const theme = await requireEditable(graph, args.id.trim());
 	const users = await publicationsUsing(graph, theme.id);
-	if (users.length > 0) throw new ToolError("theme_in_use", `"${theme.id}" is the theme of ${users.map((p) => `"${p.name}"`).join(", ")}; point ${users.length === 1 ? "that publication" : "those publications"} at another theme (update_publication) first.`);
+	if (users.length > 0) throw new ToolError("theme_in_use", `"${theme.id}" is the theme of ${users.map((p) => `"${p.name}"`).join(", ")} - point ${users.length === 1 ? "that publication" : "those publications"} at another theme (update_publication) first.`);
 	await graph.themes.remove(theme.id);
 	await settle(graph);
 	return {
@@ -18770,7 +19296,7 @@ async function previewTheme(graph, args, host) {
 	if (args.publication?.trim()) {
 		const read = await graph.publishing.readSource();
 		const found = summarisePublishing(read.source).publications.find((p) => p.id === args.publication.trim());
-		if (!found) throw new ToolError("publication_not_found", `No publication has the id "${args.publication}"; list_publications shows them.`);
+		if (!found) throw new ToolError("publication_not_found", `No publication has the id "${args.publication}" - list_publications shows them.`);
 		publication = found;
 		source = read.source;
 		unsettled = read.unsettled;
@@ -18814,7 +19340,7 @@ async function previewTheme(graph, args, host) {
 			...screenshots ? { screenshots } : {},
 			...chromium ? {
 				screenshots: null,
-				note: `No browser to photograph with; run ${chromium.setupCommand} or set ETHERPK_CHROMIUM.`
+				note: `No browser to photograph with - run ${chromium.setupCommand} or set ETHERPK_CHROMIUM.`
 			} : {}
 		};
 	} finally {
@@ -18928,25 +19454,26 @@ function createMcpServer(graph, info) {
 		version: info.version
 	}, { instructions: [
 		`You are connected to the EtherPK knowledge graph "${info.graphName}": daily journal entries and titled pages in plain markdown, linked with [[wikilinks]].`,
-		"Concept names are case-insensitive. A protected document is listed with protected: true and cannot be read or written here; tell the user to unlock it in EtherPK if a task needs it.",
-		"Bullets are \"- \" with two-space nesting; tasks are \"- [ ]\" / \"- [x]\" with task tags (#P1 #P2 #P3, #W #D #C, #D-YYYY-MM-DD due, #S-YYYY-MM-DD scheduled) right after the checkbox.",
-		"read_document returns a document's body as text and its frontmatter block as data (the \"frontmatter\" object); the block is never in the text, so line numbers from search, backlinks and tasks match the text. Set frontmatter keys with set_frontmatter (public, publications, date, author, description and any other key); a document's title and aliases and a publication page's definition are not frontmatter here and have tools of their own.",
-		"Edit with edit_document (an exact, unique old→new replacement) or append_document; read first, then edit, and never paste a whole page back.",
-		"To rename a page or concept use plan_rename then rename, never a frontmatter edit: rename carries scoped concepts (\"[[Old]] Notes\") along and by default rewrites every [[Old]] link in the graph to the new name (strategy \"rewrite\"); strategy \"alias\" keeps the old name resolving instead. A rename onto a name that is taken merges two documents and needs confirm_merge: true. References inside protected documents cannot be seen or rewritten.",
-		"search has two kinds of matching: mode \"text\" (default) matches words and quoted phrases; mode \"semantic\" finds passages about what a question or description means even when no words match. Use semantic for questions and descriptions, text for names, identifiers and exact phrases; \"hybrid\" returns both groups. When you answer from a search result, cite the document and where in it (its breadcrumb or lines). Semantic mode needs a one-time \"semantic setup\" on this computer; if it is not set up, search says so and names the command.",
-		"Start with graph_info to see what you are connected to. read_documents reads several documents in one call; tasks lists tasks and set_task changes one (status, priority, due and scheduled dates) by document and line.",
-		"Publishing: list_publications shows the publications this graph defines (a publication is a page whose frontmatter defines it; its outline is the site navigation) and the public documents none takes; a document is on a site when its frontmatter has public: true and names the publication in publications. create_publication and update_publication change the settings; publish writes the site into the publish folder the user set for it on this machine with the etherpk-mcp publish command (the tool cannot choose a folder) and returns the report. Diagrams need a browser the user installs once with \"diagrams setup\".",
-		"Themes: a publication's look is a theme - Mustache templates, a stylesheet, a script and a manifest. list_themes shows the bundled ones (read-only) and the graph's own; read_theme writes a theme's files to a folder on this machine to read and edit; customise_publication_theme copies a publication's bundled theme into the graph and points the publication at the copy (create_theme copies any theme); write_theme_file, delete_theme_file and import_theme_folder change a graph theme; preview_theme renders a theme to a folder (with screenshots when a browser is set up) to check before publish. For a snippet such as an analytics script, an include slot (update_publication includes, e.g. head) filled by a page may be lighter than a theme copy.",
-		"Images and files are assets: upload_asset adds a file from this machine and returns the markdown to paste into a document; read_asset writes an asset to a local file you can open; list_assets shows the assets documents reference. An asset is available only where a document you can read references it (or you uploaded it this session). read_asset, read_theme and preview_theme write under the graph's downloads directory and return the path; name a folder relative to it, never elsewhere.",
+		"Concept names are case-insensitive. A protected document is listed with protected: true and cannot be read or written here - tell the user to unlock it in EtherPK if a task needs it.",
+		"Bullets are \"- \" with two-space nesting. Tasks are \"- [ ]\" / \"- [x]\" with task tags (#P1 #P2 #P3, #W #D #C, #D-YYYY-MM-DD due, #S-YYYY-MM-DD scheduled) right after the checkbox.",
+		"read_document returns a document's body as text and its frontmatter block as data (the \"frontmatter\" object) - the block is never in the text, so line numbers from search, backlinks and tasks match the text. Set frontmatter keys with set_frontmatter (public, publications, date, author, description and any other key) - a document's title and aliases and a publication page's definition are not frontmatter here and have tools of their own.",
+		"Edit with edit_document (an exact, unique old→new replacement) or append_document - read first, then edit, and never paste a whole page back.",
+		"To rename a page or concept use plan_rename then rename, never a frontmatter edit: rename carries scoped concepts (\"[[Old]] Notes\") along and by default rewrites every [[Old]] link in the graph to the new name (strategy \"rewrite\") - strategy \"alias\" keeps the old name resolving instead. A rename onto a name that is taken merges two documents and needs confirm_merge: true. References inside protected documents cannot be seen or rewritten.",
+		"search has two kinds of matching: mode \"text\" (default) matches words and quoted phrases, and mode \"semantic\" finds passages about what a question or description means even when no words match. Use semantic for questions and descriptions, text for names, identifiers and exact phrases. \"hybrid\" returns both groups. When you answer from a search result, cite the document and where in it (its breadcrumb or lines). Semantic mode needs a one-time \"semantic setup\" on this computer - if it is not set up, search says so and names the command.",
+		"Start with graph_info to see what you are connected to. read_documents reads several documents in one call. tasks lists tasks and set_task changes one (status, priority, due and scheduled dates) by document and line.",
+		"A task reference is how a person hands you one task: its words, then an EtherPK address ending in #task=<line>-<fingerprint>. Pass the whole reference, or the address, to read_task for the task and its detail, to set_task (as reference) to change it, and to add_task_note to write what you did under it. It finds the task after lines are added above it or its tags change; if its words were edited it answers task_not_found, and you should ask the user for a fresh one.",
+		"Publishing: list_publications shows the publications this graph defines (a publication is a page whose frontmatter defines it - its outline is the site navigation) and the public documents none takes. A document is on a site when its frontmatter has public: true and names the publication in publications. create_publication and update_publication change the settings, and publish writes the site into the publish folder the user set for it on this machine with the etherpk-mcp publish command (the tool cannot choose a folder) and returns the report. Diagrams need a browser the user installs once with \"diagrams setup\".",
+		"Themes: a publication's look is a theme - Mustache templates, a stylesheet, a script and a manifest. list_themes shows the bundled ones (read-only) and the graph's own. read_theme writes a theme's files to a folder on this machine to read and edit. customise_publication_theme copies a publication's bundled theme into the graph and points the publication at the copy (create_theme copies any theme). write_theme_file, delete_theme_file and import_theme_folder change a graph theme. preview_theme renders a theme to a folder (with screenshots when a browser is set up) to check before publish. For a snippet such as an analytics script, an include slot (update_publication includes, e.g. head) filled by a page may be lighter than a theme copy.",
+		"Images and files are assets: upload_asset adds a file from this machine and returns the markdown to paste into a document. read_asset writes an asset to a local file you can open, and list_assets shows the assets documents reference. An asset is available only where a document you can read references it (or you uploaded it this session). read_asset, read_theme and preview_theme write under the graph's downloads directory and return the path - name a folder relative to it, never elsewhere.",
 		"The user documentation is at https://docs.etherpk.com."
 	].join("\n") });
 	server.registerTool("list_documents", {
 		title: "List documents",
-		description: `Every page and journal entry in the graph with its aliases; protected documents carry protected: true and have no readable body. from / to narrow to the journal entries of a range of days. Paged, at most 200 per call.`,
+		description: `Every page and journal entry in the graph with its aliases - protected documents carry protected: true and have no readable body. from / to narrow to the journal entries of a range of days. Paged, at most 200 per call.`,
 		inputSchema: {
 			kind: z.enum(["page", "journal"]).optional().describe("Only pages, or only journal entries."),
-			from: z.string().optional().describe("Journal entries on or after this day (YYYY-MM-DD); implies kind journal."),
-			to: z.string().optional().describe("Journal entries on or before this day (YYYY-MM-DD); implies kind journal."),
+			from: z.string().optional().describe("Journal entries on or after this day (YYYY-MM-DD) - implies kind journal."),
+			to: z.string().optional().describe("Journal entries on or before this day (YYYY-MM-DD) - implies kind journal."),
 			offset,
 			limit: z.number().int().positive().max(200).optional()
 		}
@@ -18963,7 +19490,7 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => readDocuments(graph, args)));
 	server.registerTool("search", {
 		title: "Search",
-		description: `Search every unprotected document. mode "text" (default): words match by prefix, "quoted phrases" match exactly; documents come most-matches-first with the matching lines. In text mode a term key:value is a property filter on the documents' frontmatter when some document has that key (keys and values ignore case; key:"two words", -key:value excludes, key:* means the key is set, key:va* matches the start of a value, publication.id:docs reaches a nested key, title: and aliases: match the document's names); filters alone list every matching document with the values they matched and no hits. mode "semantic": the passages closest in MEANING to the query, best first, each with its text, a similarity 0..1 and where it is (concept, breadcrumb of headings and parent bullets, start and end line) - finds a note that says "self-assessment is due 31 January" for "tax deadline". Line numbers are 0-based in every mode. Passage text is the note's own words with bullet markers and [[ ]] stripped: quote and cite it, but anchor edit_document on text from read_document. Use semantic for questions and descriptions, text for names, identifiers and exact phrases; mode "hybrid" returns both as separate groups. Semantic results carry complete: false while this computer is still embedding the graph (rerun later for more). If semantic mode answers error semantic_unavailable, it is not set up on this computer: tell the user the command in the message. At most 50 documents per call.`,
+		description: `Search every unprotected document. mode "text" (default): words match by prefix, "quoted phrases" match exactly. Documents come most-matches-first with the matching lines. In text mode a term key:value is a property filter on the documents' frontmatter when some document has that key, and keys and values ignore case (key:"two words", -key:value excludes, key:* means the key is set, key:va* matches the start of a value, publication.id:docs reaches a nested key, title: and aliases: match the document's names). Filters alone list every matching document with the values they matched and no hits. mode "semantic": the passages closest in MEANING to the query, best first, each with its text, a similarity 0..1 and where it is (concept, breadcrumb of headings and parent bullets, start and end line) - finds a note that says "self-assessment is due 31 January" for "tax deadline". Line numbers are 0-based in every mode. Passage text is the note's own words with bullet markers and [[ ]] stripped: quote and cite it, but anchor edit_document on text from read_document. Use semantic for questions and descriptions, text for names, identifiers and exact phrases. mode "hybrid" returns both as separate groups. Semantic results carry complete: false while this computer is still embedding the graph (rerun later for more). If semantic mode answers error semantic_unavailable, it is not set up on this computer: tell the user the command in the message. At most 50 documents per call.`,
 		inputSchema: {
 			query: z.string().min(1),
 			mode: z.enum([
@@ -18982,7 +19509,7 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => backlinks(graph, args.concept)));
 	server.registerTool("tasks", {
 		title: "Tasks",
-		description: `Tasks ("- [ ]" bullets) across the graph with their tags. Defaults to every unfinished task. A concept filter matches tasks written on that page, linking it, or nested under a block or heading that links it. At most 200 per call.`,
+		description: `Tasks ("- [ ]" bullets) across the graph with their tags. Defaults to every unfinished task. A concept filter matches tasks written on that page or on a page named for it ("[[Concept]] Notes"), linking it, or nested under a block or heading that links it. At most 200 per call.`,
 		inputSchema: {
 			concept: concept.optional(),
 			statuses: z.array(z.enum([
@@ -19008,12 +19535,26 @@ function createMcpServer(graph, info) {
 			limit: z.number().int().positive().max(200).optional()
 		}
 	}, async (args) => run(() => tasks(graph, args)));
+	server.registerTool("read_task", {
+		title: "Read a task",
+		description: "The task a task reference names: its text, status, priority, due and scheduled days, its document and current 0-based line, its breadcrumb (the headings and bullets above it), its detail (its continuation lines and everything nested under it), foundBy (at_line, moved or other_document) and its current reference. Errors: task_not_found (its words were edited or it was deleted), task_ambiguous (two tasks have its words; the message names them), other_graph (the reference is from another graph).",
+		inputSchema: { reference: z.string().min(1).describe("The task reference as the user gave it: the two lines, or the address alone.") }
+	}, async (args) => run(() => readTask(graph, args)));
+	server.registerTool("add_task_note", {
+		title: "Add a note under a task",
+		description: "Add text under the task a task reference names, one level in, after what is already nested there: a line of text becomes a bullet, and bullets are nested as written. Use it to record what you did about the task. Refuses as read_task does when the reference finds no single task.",
+		inputSchema: {
+			reference: z.string().min(1).describe("The task reference as the user gave it."),
+			text: z.string().min(1).describe("Markdown: a line, or \"- \" bullets.")
+		}
+	}, async (args) => run(() => addTaskNote(graph, args)));
 	server.registerTool("set_task", {
 		title: "Set a task",
-		description: "Change one task by document and 0-based line (as tasks and read_document count lines): its status (open, doing, waiting, done, cancelled - exclusive), priority (1, 2, 3 or null), due and scheduled days (YYYY-MM-DD or null). Pass expect with the task's text from tasks; if the line no longer holds that task the change is refused with error \"task_moved\" and nothing is edited.",
+		description: "Change one task, named by a task reference or by document and 0-based line (as tasks and read_document count lines): its status (open, doing, waiting, done, cancelled - exclusive), priority (1, 2, 3 or null), due and scheduled days (YYYY-MM-DD or null). By line, pass expect with the task's text from tasks - if the line no longer holds that task the change is refused with error \"task_moved\" and nothing is edited. A reference finds the task wherever it is now.",
 		inputSchema: {
-			concept,
-			line: z.number().int().nonnegative(),
+			reference: z.string().min(1).optional().describe("A task reference, in place of concept, line and expect."),
+			concept: concept.optional(),
+			line: z.number().int().nonnegative().optional(),
 			changes: z.object({
 				status: z.enum([
 					"open",
@@ -19036,7 +19577,7 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => setTask(graph, args)));
 	server.registerTool("edit_document", {
 		title: "Edit a document",
-		description: "Replace one exact occurrence of \"old\" with \"new\" in a document. \"old\" must appear exactly once (include surrounding lines to disambiguate); the change is applied as one edit, so on a synced graph it merges with anyone typing elsewhere in the page, and on a folder it is in the file when this returns. Refused on a protected document.",
+		description: "Replace one exact occurrence of \"old\" with \"new\" in a document. \"old\" must appear exactly once (include surrounding lines to disambiguate). The change is applied as one edit, so on a synced graph it merges with anyone typing elsewhere in the page, and on a folder it is in the file when this returns. Refused on a protected document.",
 		inputSchema: {
 			concept,
 			old: z.string().min(1).describe("The exact text to replace, as read_document returned it."),
@@ -19070,7 +19611,7 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => planRename(graph, args)));
 	server.registerTool("rename", {
 		title: "Rename",
-		description: "Rename a page or concept. Its page (if any) and every scoped concept beneath it (\"[[Old]] Notes\" becomes \"[[New]] Notes\") move with it. strategy \"rewrite\" (default) rewrites every [[Old]] link in the graph to the new name; \"alias\" keeps the old name as an alias so existing links keep resolving. If the new name is already taken the two documents would merge, which is irreversible: refused with error \"merge_requires_confirmation\" unless confirm_merge is true. Refused with \"unconfirmed_documents\" if a document it must read has not finished syncing to this device (nothing changes; try again). Call plan_rename first to see what will happen.",
+		description: "Rename a page or concept. Its page (if any) and every scoped concept beneath it (\"[[Old]] Notes\" becomes \"[[New]] Notes\") move with it. strategy \"rewrite\" (default) rewrites every [[Old]] link in the graph to the new name. \"alias\" keeps the old name as an alias so existing links keep resolving. If the new name is already taken the two documents would merge, which is irreversible: refused with error \"merge_requires_confirmation\" unless confirm_merge is true. Refused with \"unconfirmed_documents\" if a document it must read has not finished syncing to this device (nothing changes - try again). Call plan_rename first to see what will happen.",
 		inputSchema: {
 			from: z.string().min(1),
 			to: z.string().min(1),
@@ -19083,7 +19624,7 @@ function createMcpServer(graph, info) {
 		description: "Replace a document's aliases: other names it answers to in [[wikilinks]], Quick Find and on a published site. The list you pass is the complete list. A name that is already another document's title or alias is refused with error \"name_taken\".",
 		inputSchema: {
 			concept,
-			aliases: z.array(z.string()).describe("Every alias the document should have; an empty list removes them all.")
+			aliases: z.array(z.string()).describe("Every alias the document should have - an empty list removes them all.")
 		}
 	}, async (args) => run(() => setAliases(graph, args)));
 	server.registerTool("set_frontmatter", {
@@ -19091,23 +19632,23 @@ function createMcpServer(graph, info) {
 		description: "Set keys of a document's frontmatter block, adding the block if there is none. A merge patch: the keys you name are set, null removes a key, every other key keeps its value. \"public\" (true/false) and \"publications\" (a list of publication ids: lower-case letters, digits and hyphens) decide what is published, and are validated. Refuses \"title\", \"aliases\" and \"publication\" with error \"identity_key\" (use rename, set_aliases and the publication tools), and a protected document. Returns the resulting frontmatter.",
 		inputSchema: {
 			concept,
-			patch: z.record(z.string(), frontmatterValue).describe("Keys to set; null removes a key. Example: {\"public\": true, \"publications\": [\"blog\"], \"date\": \"2026-01-31\", \"draft\": null}.")
+			patch: z.record(z.string(), frontmatterValue).describe("Keys to set - null removes a key. Example: {\"public\": true, \"publications\": [\"blog\"], \"date\": \"2026-01-31\", \"draft\": null}.")
 		}
 	}, async (args) => run(() => setFrontmatter(graph, args)));
 	server.registerTool("upload_asset", {
 		title: "Upload an asset",
-		description: "Add a file on this machine (an image, a PDF, any file) to the graph as an asset. Returns the reference and the markdown to paste into a document (an image tag for an image, a link otherwise). Bytes the graph already holds are not stored twice: the result then says reused: true and points at the existing asset. The file is stored as it is, without image optimisation. Refused with error \"invalid_argument\" for a folder, a file over 100 MiB, a hidden file or one in a hidden folder (.ssh, .env), and the Headless Client's own config and cache; with error \"asset_refused\" when the server declines it on a quota.",
+		description: "Add a file on this machine (an image, a PDF, any file) to the graph as an asset. Returns the reference and the markdown to paste into a document (an image tag for an image, a link otherwise). Bytes the graph already holds are not stored twice: the result then says reused: true and points at the existing asset. The file is stored as it is, without image optimisation. Refused with error \"invalid_argument\" for a folder, a file over 100 MiB, a hidden file or one in a hidden folder (.ssh, .env), and the Headless Client's own config and cache. Refused with error \"asset_refused\" when the server declines it on a quota.",
 		inputSchema: {
 			path: z.string().min(1).describe("Absolute path of an ordinary file on this machine."),
-			name: z.string().min(1).optional().describe("The name to store it under; the file's own name by default.")
+			name: z.string().min(1).optional().describe("The name to store it under - the file's own name by default.")
 		}
 	}, async (args) => run(() => uploadAsset(graph, args)));
 	server.registerTool("read_asset", {
 		title: "Read an asset",
-		description: "Write an asset's bytes to a file on this machine and return the path, so you can open or view it. Pass the reference as a document shows it (\"../assets/<name>\") or the name alone. Available only where a document you can read references the asset (or you uploaded it this session); otherwise error \"asset_not_found\". The file is written under the graph's downloads directory, named after the asset, and never over an existing file.",
+		description: "Write an asset's bytes to a file on this machine and return the path, so you can open or view it. Pass the reference as a document shows it (\"../assets/<name>\") or the name alone. Available only where a document you can read references the asset (or you uploaded it this session) - otherwise error \"asset_not_found\". The file is written under the graph's downloads directory, named after the asset, and never over an existing file.",
 		inputSchema: {
 			ref: z.string().min(1),
-			out_dir: z.string().min(1).optional().describe("A folder under the graph's downloads directory, relative to it; the downloads directory itself by default. A folder outside it is refused.")
+			out_dir: z.string().min(1).optional().describe("A folder under the graph's downloads directory, relative to it - the downloads directory itself by default. A folder outside it is refused.")
 		}
 	}, async (args) => run(() => readAsset(graph, args)));
 	server.registerTool("list_assets", {
@@ -19121,25 +19662,25 @@ function createMcpServer(graph, info) {
 	};
 	server.registerTool("list_publications", {
 		title: "List publications",
-		description: "The publications this graph defines - id, name, the page that defines each, kind (docs or blog), selection (named: documents that list it in publications; all-public: every public document), home, url, theme, include slots, and the publish folder set for it on this machine (null when none) - with any issues in their pages and the public documents no publication takes.",
+		description: "The publications this graph defines - id, name, the page that defines each, kind (docs or blog), selection (named: documents that list it in publications, all-public: every public document), home, url, theme, include slots, and the publish folder set for it on this machine (null when none) - with any issues in their pages and the public documents no publication takes.",
 		inputSchema: {}
 	}, async () => run(() => listPublications(graph, host)));
 	server.registerTool("create_publication", {
 		title: "Create a publication",
-		description: "Create a publication: a page titled with its name whose frontmatter defines it and whose outline (bullets of [[wikilinks]]) is the site navigation. id defaults to a slug of the title; kind is docs (default) or blog; selection is named (default: a document joins by listing the id in its publications) or all-public. theme is a bundled theme name (etherpk-docs, etherpk-blog), a theme in the graph, or a url.",
+		description: "Create a publication: a page titled with its name whose frontmatter defines it and whose outline (bullets of [[wikilinks]]) is the site navigation. id defaults to a slug of the title. kind is docs (default) or blog. selection is named (default: a document joins by listing the id in its publications) or all-public. theme is a bundled theme name (etherpk-docs, etherpk-blog), a theme in the graph, or a url.",
 		inputSchema: {
 			title: z.string().min(1),
 			id: z.string().min(1).optional(),
 			kind: z.enum(["docs", "blog"]).optional(),
 			selection: z.enum(["named", "all-public"]).optional(),
-			home: z.string().min(1).optional().describe("The page whose content is the front page; absent, an index is generated."),
+			home: z.string().min(1).optional().describe("The page whose content is the front page - absent, an index is generated."),
 			url: z.string().min(1).optional().describe("Where the site will be deployed, for its feed and sitemap."),
 			theme: z.string().min(1).optional()
 		}
 	}, async (args) => run(() => createPublication(graph, args, host)));
 	server.registerTool("update_publication", {
 		title: "Update a publication",
-		description: "Change a publication's settings on its page. Each change is optional; null removes a field (back to its default) or clears an include slot. includes maps a theme's slot name (head, logo, header, footer, before, after, scripts, styles, or one the theme adds) to the page that fills it; that page must be public and in the publication.",
+		description: "Change a publication's settings on its page. Each change is optional - null removes a field (back to its default) or clears an include slot. includes maps a theme's slot name (head, logo, header, footer, before, after, scripts, styles, or one the theme adds) to the page that fills it - that page must be public and in the publication.",
 		inputSchema: {
 			id: z.string().min(1),
 			changes: z.object({
@@ -19148,27 +19689,27 @@ function createMcpServer(graph, info) {
 				home: z.string().nullable().optional(),
 				url: z.string().nullable().optional(),
 				theme: z.string().nullable().optional(),
-				recent: z.number().int().nonnegative().nullable().optional().describe("Posts on a blog's front page; null for the default (10)."),
+				recent: z.number().int().nonnegative().nullable().optional().describe("Posts on a blog's front page - null for the default (10)."),
 				includes: z.record(z.string(), z.string().nullable()).optional()
 			})
 		}
 	}, async (args) => run(() => updatePublication(graph, args, host)));
 	server.registerTool("publish", {
 		title: "Publish",
-		description: "Render a publication to its publish folder on this machine and return the report: what was included and why documents were left out, missing links, assets, warnings. The folder is the one the user set with \"etherpk-mcp publish --publication <id> --out <dir>\" (error \"no_publish_folder\" until then; the tool never chooses a folder). Pages with Mermaid diagrams need the browser from \"diagrams setup\" (error \"chromium_unavailable\"). The report is this result, trimmed to counts and first entries; nothing of it is written into the folder, so the site never names the documents it leaves out. Publishing writes files; it does not deploy them.",
+		description: "Render a publication to its publish folder on this machine and return the report: what was included and why documents were left out, missing links, assets, warnings. The folder is the one the user set with \"etherpk-mcp publish --publication <id> --out <dir>\" (error \"no_publish_folder\" until then - the tool never chooses a folder). Pages with Mermaid diagrams need the browser from \"diagrams setup\" (error \"chromium_unavailable\"). The report is this result, trimmed to counts and first entries - nothing of it is written into the folder, so the site never names the documents it leaves out. Publishing writes files - it does not deploy them.",
 		inputSchema: { id: z.string().min(1) }
 	}, async (args) => run(() => publish(graph, args, host)));
 	server.registerTool("list_themes", {
 		title: "List themes",
-		description: "Every theme a publication here can use: the bundled ones (etherpk-docs, etherpk-blog; read-only, with their files and manifest) and the graph's own (editable; id, name, origin, files, manifest, validation errors, and which publications use each).",
+		description: "Every theme a publication here can use: the bundled ones (etherpk-docs and etherpk-blog, read-only, with their files and manifest) and the graph's own (editable, with id, name, origin, files, manifest, validation errors, and which publications use each).",
 		inputSchema: {}
 	}, async () => run(() => listThemes(graph)));
 	server.registerTool("read_theme", {
 		title: "Read a theme",
-		description: "Write a theme's files (theme.json, layouts/, partials/, assets/) to a folder on this machine and return the path and file list, so you can read and edit them with your own tools. ref is a graph theme id, a bundled theme name or a url. Editing the folder changes nothing until write_theme_file or import_theme_folder brings it back; a bundled or url theme cannot be edited in place at all (create_theme copies it).",
+		description: "Write a theme's files (theme.json, layouts/, partials/, assets/) to a folder on this machine and return the path and file list, so you can read and edit them with your own tools. ref is a graph theme id, a bundled theme name or a url. Editing the folder changes nothing until write_theme_file or import_theme_folder brings it back. A bundled or url theme cannot be edited in place at all (create_theme copies it).",
 		inputSchema: {
 			ref: z.string().min(1),
-			out_dir: z.string().min(1).optional().describe("A folder under the graph's downloads directory, relative to it; themes/<ref> there by default. A folder outside it is refused.")
+			out_dir: z.string().min(1).optional().describe("A folder under the graph's downloads directory, relative to it - themes/<ref> there by default. A folder outside it is refused.")
 		}
 	}, async (args) => run(() => readTheme(graph, args)));
 	server.registerTool("read_theme_file", {
@@ -19181,19 +19722,19 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => readThemeFile(graph, args)));
 	server.registerTool("create_theme", {
 		title: "Create a theme",
-		description: "Copy a theme into the graph as one of its own, ready to edit: from a bundled theme name, a url, or another theme in the graph. Returns the new theme; point a publication at it with update_publication (theme: <id>).",
+		description: "Copy a theme into the graph as one of its own, ready to edit: from a bundled theme name, a url, or another theme in the graph. Returns the new theme - point a publication at it with update_publication (theme: <id>).",
 		inputSchema: {
 			from: z.string().min(1),
-			id: z.string().min(1).optional().describe("Lower-case letters, digits and hyphens; from the source by default."),
+			id: z.string().min(1).optional().describe("Lower-case letters, digits and hyphens - from the source by default."),
 			name: z.string().min(1).optional()
 		}
 	}, async (args) => run(() => createTheme(graph, args)));
 	server.registerTool("customise_publication_theme", {
 		title: "Customise a publication's theme",
-		description: "Make a publication's theme editable: if it uses a bundled or url theme, copy that theme into the graph and point the publication at the copy; if it already uses a graph theme, return it. The step before editing the look of a published site.",
+		description: "Make a publication's theme editable: if it uses a bundled or url theme, copy that theme into the graph and point the publication at the copy. If it already uses a graph theme, return it. The step before editing the look of a published site.",
 		inputSchema: {
 			publication: z.string().min(1).describe("The publication id."),
-			id: z.string().min(1).optional().describe("The id for the copy; <publication>-theme by default."),
+			id: z.string().min(1).optional().describe("The id for the copy - <publication>-theme by default."),
 			name: z.string().min(1).optional()
 		}
 	}, async (args) => run(() => customisePublicationTheme(graph, args)));
@@ -19208,7 +19749,7 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => writeThemeFile(graph, args)));
 	server.registerTool("delete_theme_file", {
 		title: "Delete a theme file",
-		description: "Remove one file from a graph theme; the theme is validated afterwards and problems returned as errors.",
+		description: "Remove one file from a graph theme - the theme is validated afterwards and problems returned as errors.",
 		inputSchema: {
 			id: z.string().min(1),
 			path: z.string().min(1)
@@ -19216,7 +19757,7 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => deleteThemeFile(graph, args)));
 	server.registerTool("import_theme_folder", {
 		title: "Import a theme folder",
-		description: "Replace a graph theme's files with a folder's contents - the way back after editing what read_theme wrote. Files the folder no longer has are removed from the theme; the folder needs a theme.json at its top. dir is the folder read_theme returned, or another under the graph's downloads directory; a folder outside it is refused, and symbolic links in it are skipped. Validated afterwards.",
+		description: "Replace a graph theme's files with a folder's contents - the way back after editing what read_theme wrote. Files the folder no longer has are removed from the theme - the folder needs a theme.json at its top. dir is the folder read_theme returned, or another under the graph's downloads directory - a folder outside it is refused, and symbolic links in it are skipped. Validated afterwards.",
 		inputSchema: {
 			id: z.string().min(1),
 			dir: z.string().min(1)
@@ -19224,12 +19765,12 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => importThemeFolder(graph, args)));
 	server.registerTool("delete_theme", {
 		title: "Delete a theme",
-		description: "Remove a graph theme. Refused with error \"theme_in_use\" while a publication's saved settings name it; point the publication at another theme first.",
+		description: "Remove a graph theme. Refused with error \"theme_in_use\" while a publication's saved settings name it - point the publication at another theme first.",
 		inputSchema: { id: z.string().min(1) }
 	}, async (args) => run(() => deleteTheme(graph, args)));
 	server.registerTool("preview_theme", {
 		title: "Preview a theme",
-		description: "Render a theme to a folder on this machine and return where: a publication's real pages when a publication is given (with its own theme, or the theme named), or a sample site covering every construct when only a theme is given. Open the HTML to check markup and styles. With screenshots: true and a browser set up (diagrams setup or ETHERPK_CHROMIUM), the front page and one content page are photographed at desktop and phone widths as PNGs you can view. A preview is scratch, not the publish folder. The page loads nothing from the network while it is photographed. out_dir is a folder under the graph's downloads directory (previews/<name> there by default); a folder outside it is refused.",
+		description: "Render a theme to a folder on this machine and return where: a publication's real pages when a publication is given (with its own theme, or the theme named), or a sample site covering every construct when only a theme is given. Open the HTML to check markup and styles. With screenshots: true and a browser set up (diagrams setup or ETHERPK_CHROMIUM), the front page and one content page are photographed at desktop and phone widths as PNGs you can view. A preview is scratch, not the publish folder. The page loads nothing from the network while it is photographed. out_dir is a folder under the graph's downloads directory (previews/<name> there by default) - a folder outside it is refused.",
 		inputSchema: {
 			theme: z.string().min(1).optional(),
 			publication: z.string().min(1).optional(),
@@ -19465,20 +20006,20 @@ var USAGE = `etherpk-mcp - EtherPK Headless Client (an MCP server over one synce
       Serve one synced graph to an agent over stdio. For Claude Code:
         claude mcp add etherpk -- npx @appsoftwareltd/etherpk-mcp serve --sync-server <url> --graph <id>
       Once "semantic setup" has run on this computer, serve also keeps a search-by-meaning
-      store of the graph current (the agent's search tool gains mode: semantic); pass
+      store of the graph current (the agent's search tool gains mode: semantic) - pass
       --no-semantic to leave it off for this registration.
   ${CMD} serve --folder <path> [--no-semantic]
       Serve a local graph folder the same way: no sign-in, no server. The agent gets search,
       backlinks, tasks and format-safe edits over the folder's markdown, alongside the files
       themselves. Edits made in an editor or by the agent directly are picked up as they land.
-      The folder must already be a graph (open it in EtherPK once); its index is kept under
+      The folder must already be a graph (open it in EtherPK once) - its index is kept under
       the cache directory, never in the folder.
   ${CMD} logout [--sync-server <url> | --all]
       Forget that server's token, keys and cached graphs on this machine.
   ${CMD} semantic setup
       Let the agent search by meaning. Installs a ~300 MB native runtime (onnxruntime-node,
       with your npm) and downloads a 23 MB embedding model into the cache directory, once
-      per computer. Nothing leaves this computer when the model runs; notes are never sent
+      per computer. Nothing leaves this computer when the model runs - notes are never sent
       to a service to be embedded.
   ${CMD} semantic status | remove
       Whether it is set up here, or delete it (logout --all deletes it too).
@@ -19488,20 +20029,20 @@ var USAGE = `etherpk-mcp - EtherPK Headless Client (an MCP server over one synce
       then on this command without --out, and the agent's publish tool, write to the same
       folder (the agent cannot choose one). The folder's owned files (.html at the top,
       assets/, theme/, the search, feed and report files) are rewritten and their strays
-      removed; everything else in it is left alone. Publishing writes files; deploying them
+      removed - everything else in it is left alone. Publishing writes files - deploying them
       (a git push, say) is yours. Run it from cron for a site that republishes itself.
   ${CMD} diagrams setup
       Let a publish draw Mermaid diagrams. Downloads a Chromium (about 170 MB) into the cache
-      directory with Playwright's installer, once per computer; a publish whose pages hold
+      directory with Playwright's installer, once per computer - a publish whose pages hold
       diagrams refuses until this has run. Set ETHERPK_CHROMIUM=<path> to use a browser
       already on this machine instead (NixOS needs this).
   ${CMD} diagrams status
       Which browser a publish would use, if any.
 
-This machine can hold logins for several Sync Servers at once; --sync-server says which one
-a command means, and can be left out while there is only one. The config file is
+This machine can hold logins for several Sync Servers at once. The --sync-server flag says
+which one a command means, and can be left out while there is only one. The config file is
 ${defaultConfigPath()} (override with
-ETHERPK_MCP_CONFIG); cached graphs live under ~/.cache/etherpk/mcp (override with
+ETHERPK_MCP_CONFIG) - cached graphs live under ~/.cache/etherpk/mcp (override with
 ETHERPK_MCP_CACHE_DIR).
 Docs: https://docs.etherpk.com/using-ai-agents-with-your-notes
 `;
@@ -19514,7 +20055,7 @@ function fail(message) {
 * an agent starting the process), since each question has its own option or variable.
 */
 async function ask(question, { secret = false, hint }) {
-	if (!process.stdin.isTTY) fail(`${question.replace(/:\s*$/, "")}: no terminal to ask on; ${hint}.`);
+	if (!process.stdin.isTTY) fail(`${question.replace(/:\s*$/, "")}: no terminal to ask on - ${hint}.`);
 	if (!secret) {
 		const rl = createInterface({
 			input: process.stdin,
@@ -19553,7 +20094,7 @@ async function ask(question, { secret = false, hint }) {
 }
 async function loadConfig(path) {
 	const config = await readConfig(path);
-	if (!config) fail(`${path} is not a config file this version understands. Run: ${CMD} login --sync-server <url> (it will be rewritten; nothing else is affected).`);
+	if (!config) fail(`${path} is not a config file this version understands. Run: ${CMD} login --sync-server <url> (it will be rewritten - nothing else is affected).`);
 	return config;
 }
 /** The login a command means, or the reason there is none - in words the user can act on. */
@@ -19594,7 +20135,7 @@ async function login(args) {
 	await writeConfig(path, config);
 	console.log(`Keys unlocked and cached in ${path} (owner-only). Anyone who can read your files on this machine can read this account, as with a signed-in browser.`);
 	const others = Object.keys(config.servers).filter((server) => server !== syncServer);
-	if (others.length > 0) console.log(`Also logged in to ${others.join(", ")}; commands now need --sync-server <url> to say which.`);
+	if (others.length > 0) console.log(`Also logged in to ${others.join(", ")} - commands now need --sync-server <url> to say which.`);
 	await listGraphs({
 		syncServer,
 		pat,
@@ -19650,7 +20191,7 @@ async function approveOrFallBack(account, byRecoveryCode) {
 		process.exit(controls.exitCode);
 	}
 	if (!abandoned) throw new Error("unreachable");
-	console.log("Approval cancelled; unlocking with your Recovery Code instead.");
+	console.log("Approval cancelled - unlocking with your Recovery Code instead.");
 	return byRecoveryCode();
 }
 /**
@@ -19719,7 +20260,7 @@ async function semanticCommand(what) {
 			const status = await semanticSetupStatus(process.env);
 			console.log(`Runtime: ${status.runtime ? "installed" : "missing"} (${status.runtimeDir})`);
 			console.log(`Model:   ${status.model ? "present" : "missing"} (${status.modelDir})`);
-			console.log(status.runtime && status.model ? "Semantic search is set up; serve uses it unless started with --no-semantic." : `Not set up. Run: ${CMD} semantic setup`);
+			console.log(status.runtime && status.model ? "Semantic search is set up - serve uses it unless started with --no-semantic." : `Not set up. Run: ${CMD} semantic setup`);
 			const stores = await listGraphStores(process.env, MODEL.id);
 			if (stores.length === 0) return;
 			console.log("");
@@ -19778,7 +20319,7 @@ async function publishCommand(args) {
 			const out = resolve(args.out.trim());
 			await writePublishFolders(configPath, withPublishFolder(await readPublishFolders(configPath), key, publication, out));
 			console.error(`etherpk-mcp: publish folder for "${publication}" of "${graphName}" set to ${out} (remembered in ${configPath}).`);
-		} else if (!publishFolderOf(await readPublishFolders(configPath), key, publication)) fail(`No publish folder is set for "${publication}" of "${graphName}" on this machine. Pass --out <dir> once; it is remembered.`);
+		} else if (!publishFolderOf(await readPublishFolders(configPath), key, publication)) fail(`No publish folder is set for "${publication}" of "${graphName}" on this machine. Pass --out <dir> once - it is remembered.`);
 		const result = await publish(graph, { id: publication }, host);
 		console.log(JSON.stringify(cliPublishOutput(result), null, 2));
 		if (!result.ok) process.exitCode = 1;
@@ -19851,7 +20392,7 @@ async function openFolderForServe(folder, args) {
 			onSemanticProgress: reportSemanticProgress,
 			onError: (error) => console.error(`etherpk-mcp: ${error.message}`),
 			onWarning: (line) => console.error(`etherpk-mcp: ${line}`),
-			watch: watchFolder(path, (error) => console.error(`etherpk-mcp: not watching the folder for changes (${error.message}); edits made outside are still picked up before each tool call.`))
+			watch: watchFolder(path, (error) => console.error(`etherpk-mcp: not watching the folder for changes (${error.message}) - edits made outside are still picked up before each tool call.`))
 		}),
 		graphName: name
 	};
@@ -19887,6 +20428,7 @@ async function openSyncedForServe(wanted, args) {
 		keyring,
 		relayUrl: account.relayUrl,
 		token: account.tokenFor(graphId),
+		clientUrl: account.clientUrl,
 		presenceName: `Agent on ${hostname()}`,
 		readyTimeoutMs: 2e4,
 		persistDir,
@@ -19923,7 +20465,7 @@ async function serveGraph(graph, graphName, args) {
 			transport.onclose = listener;
 		},
 		async shutdown(end) {
-			console.error(`etherpk-mcp: ${end}; flushing and exiting.`);
+			console.error(`etherpk-mcp: ${end} - flushing and exiting.`);
 			await graph.settle().catch(() => {});
 			await graph.dispose().catch(() => {});
 			process.exit(0);
@@ -19933,17 +20475,17 @@ async function serveGraph(graph, graphName, args) {
 	console.error(`etherpk-mcp: serving "${graphName}" over stdio as "Agent on ${hostname()}".`);
 	chromiumStatus(process.env, CMD).then((chromium) => {
 		if (chromium.executable) return;
-		console.error(`etherpk-mcp: no browser for diagrams (run: ${chromium.setupCommand}, or set ETHERPK_CHROMIUM); a publish or theme preview with Mermaid diagrams refuses until then.`);
+		console.error(`etherpk-mcp: no browser for diagrams (run: ${chromium.setupCommand}, or set ETHERPK_CHROMIUM) - a publish or theme preview with Mermaid diagrams refuses until then.`);
 	});
 	const startSemantic = () => graph.semantic().then(async (semantic) => {
 		const status = await semantic.status();
-		console.error(`etherpk-mcp: semantic search on (${semantic.model.id}); ${status.embedded} of ${status.total} passages embedded, building the rest in the background.`);
+		console.error(`etherpk-mcp: semantic search on (${semantic.model.id}) - ${status.embedded} of ${status.total} passages embedded, building the rest in the background.`);
 	}).catch((error) => console.error(`etherpk-mcp: semantic search unavailable: ${error instanceof Error ? error.message : String(error)}`));
 	if (semanticOn) startSemantic();
 	else if (!args["no-semantic"]) {
-		console.error(`etherpk-mcp: semantic search is not set up on this computer (run: ${CMD} semantic setup; this process will notice within half a minute, no restart needed); search answers by text only until then.`);
+		console.error(`etherpk-mcp: semantic search is not set up on this computer (run: ${CMD} semantic setup - this process will notice within half a minute, no restart needed). Search answers by text only until then.`);
 		whenSemanticSetUp(process.env, () => {
-			console.error("etherpk-mcp: semantic setup found; loading the model and building the store.");
+			console.error("etherpk-mcp: semantic setup found - loading the model and building the store.");
 			startSemantic();
 		});
 	}