@appsoftwareltd/etherpk-mcp 0.8.2 → 0.8.4

package/dist/main.js

@@ -20,7 +20,7 @@ import * as Y from "yjs";
 import { z } from "zod";
 import { Awareness, applyAwarenessUpdate, encodeAwarenessUpdate, removeAwarenessStates } from "y-protocols/awareness";
 import * as encoding from "lib0/encoding";
-import { parse, stringify } from "yaml";
+import { Document, Scalar, YAMLMap, isMap, isScalar, isSeq, parse, parseDocument, visit } from "yaml";
 import "fake-indexeddb/auto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { classHighlighter, highlightTree } from "@lezer/highlight";
@@ -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.2",
+	version: "0.8.4",
 	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";
@@ -2511,6 +2512,119 @@ function snippetSegments(snippet) {
 	}
 	return segments.filter((s) => s.text !== "");
 }
+/** Letters, digits, `_`, `.` and `-`: a key a person can type, dot paths included. */
+var PROPERTY_KEY_PATTERN = /^[\p{L}\p{N}_][\p{L}\p{N}_.-]*$/u;
+/**
+* Whitespace-separated tokens. A quote opens a run that spaces do not end, whether it starts the
+* token (`"a phrase"`) or follows a key (`status:"in progress"`); an unclosed one runs to the end.
+*/
+function searchTokens(input) {
+	const out = [];
+	let index = 0;
+	while (index < input.length) {
+		if (/\s/.test(input[index])) {
+			index++;
+			continue;
+		}
+		const from = index;
+		while (index < input.length && !/\s/.test(input[index])) {
+			if (input[index] === "\"") {
+				const close = input.indexOf("\"", index + 1);
+				index = close === -1 ? input.length : close + 1;
+				continue;
+			}
+			index++;
+		}
+		out.push({
+			text: input.slice(from, index),
+			from,
+			to: index
+		});
+	}
+	return out;
+}
+/**
+* The filters in `input`, and the words left for name and text matching.
+*
+* A term is a filter only when its key is one at least one searchable document carries
+* (`knownKeys`, lower-cased): anything else shaped like `x:y` stays words, which keeps a URL, a
+* time or `note:` in prose as text. A fully quoted term is always words. A known key with no
+* value yet (`status:` mid-typing) is dropped from both, so the key is never searched as a word
+* a moment before the value arrives.
+*/
+function parseSearchQuery(input, knownKeys) {
+	const filters = [];
+	const terms = [];
+	const cut = [];
+	if (knownKeys.size > 0) for (const token of searchTokens(input)) {
+		if (token.text.startsWith("\"")) continue;
+		const colon = token.text.indexOf(":");
+		if (colon <= 0) continue;
+		const negated = token.text.startsWith("-");
+		const key = token.text.slice(negated ? 1 : 0, colon);
+		if (!PROPERTY_KEY_PATTERN.test(key) || !knownKeys.has(key.toLowerCase())) continue;
+		const filter = filterValue(key, token.text.slice(colon + 1), negated);
+		cut.push({
+			from: token.from,
+			to: token.to
+		});
+		if (filter === null) continue;
+		filters.push(filter);
+		terms.push({
+			filter,
+			from: token.from,
+			to: token.to
+		});
+	}
+	return {
+		words: withoutRanges(input, cut),
+		filters,
+		terms
+	};
+}
+/** The filter for a value as typed, or null when there is no value yet. */
+function filterValue(key, raw, negated) {
+	if (raw === "*") return {
+		key,
+		value: null,
+		prefix: false,
+		negated
+	};
+	if (raw.startsWith("\"")) {
+		const close = raw.indexOf("\"", 1);
+		const value = (close === -1 ? raw.slice(1) : raw.slice(1, close)).trim();
+		return value === "" ? null : {
+			key,
+			value,
+			prefix: false,
+			negated
+		};
+	}
+	if (raw.length > 1 && raw.endsWith("*")) return {
+		key,
+		value: raw.slice(0, -1),
+		prefix: true,
+		negated
+	};
+	return raw === "" ? null : {
+		key,
+		value: raw,
+		prefix: false,
+		negated
+	};
+}
+/** `input` with the ranges removed and the gaps they leave closed to single spaces. */
+function withoutRanges(input, ranges) {
+	if (ranges.length === 0) return input;
+	const parts = [];
+	let at = 0;
+	for (const range of ranges) {
+		parts.push(input.slice(at, range.from));
+		at = range.to;
+	}
+	parts.push(input.slice(at));
+	return parts.map((part) => part.trim()).filter((part) => part !== "").join(" ");
+}
 //#endregion
 //#region ../client/src/lib/document/index-db.ts
 /**
@@ -2572,6 +2686,15 @@ CREATE TABLE IF NOT EXISTS passages (
   page_id INTEGER NOT NULL, ord INTEGER NOT NULL, start_line INTEGER NOT NULL,
   end_line INTEGER NOT NULL, first_block_local_id INTEGER NOT NULL,
   content_hash TEXT NOT NULL, text TEXT NOT NULL);
+-- [[Property]] rows for [[Property Filter]]s (ADR 0107): one per value, keys as dot paths. key and
+-- value keep their spelling for display; key_lc and value_lc are lower-cased in JS, because
+-- SQLite's lower() folds ASCII only and a filter matches ignoring case in any script. value is
+-- NULL on a mapping's presence row. title and aliases rows come from the graph's names. A
+-- protected document has none.
+CREATE TABLE IF NOT EXISTS properties (
+  page_id INTEGER NOT NULL, key TEXT NOT NULL, key_lc TEXT NOT NULL,
+  value TEXT, value_lc TEXT);
+CREATE INDEX IF NOT EXISTS properties_key ON properties(key_lc, value_lc);
 CREATE INDEX IF NOT EXISTS passages_hash ON passages(content_hash);
 CREATE INDEX IF NOT EXISTS links_concept_key ON links(concept_key);
 CREATE INDEX IF NOT EXISTS blocks_page ON blocks(page_id);
@@ -2620,7 +2743,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 = 13`);
+	db.exec(`PRAGMA user_version = 14`);
 }
 function activeIndexGeneration(db) {
 	return db.all("SELECT value FROM index_metadata WHERE key = 'active_generation'")[0]?.value ?? 1;
@@ -2641,7 +2764,7 @@ function advanceIndexRevision(db) {
 */
 function isUsableIndex(db) {
 	try {
-		return db.all("PRAGMA user_version")[0]?.user_version === 13;
+		return db.all("PRAGMA user_version")[0]?.user_version === 14;
 	} catch {
 		return false;
 	}
@@ -2661,8 +2784,11 @@ function documentHash(db, key) {
 */
 function indexDocHash(doc) {
 	const includes = doc.includes ?? [];
-	if (includes.length === 0) return hashText(doc.text);
-	return hashText(`${doc.text}\u0000${includes.map((i) => `${i.publication}\u0001${i.slot}\u0001${i.concept}`).join("\0")}`);
+	const properties = doc.properties ?? [];
+	if (includes.length === 0 && properties.length === 0) return hashText(doc.text);
+	const includeText = includes.map((i) => `${i.publication}\u0001${i.slot}\u0001${i.concept}`).join("\0");
+	const propertyText = properties.map((p) => `${p.key}\u0001${p.value ?? ""}`).join("\0");
+	return hashText(`${doc.text}\u0000${includeText}\u0003${propertyText}`);
 }
 function hashText(text) {
 	let h1 = 3735928559;
@@ -2703,6 +2829,7 @@ function insertDerived(db, pageId, doc) {
 		conceptKey$1(alias),
 		alias
 	]);
+	insertProperties(db, pageId, doc);
 	for (const include of doc.includes ?? []) db.run("INSERT INTO publication_includes (page_id, publication_id, slot, concept_key, concept) VALUES (?,?,?,?,?)", [
 		pageId,
 		include.publication,
@@ -2779,12 +2906,40 @@ function insertDerived(db, pageId, doc) {
 	return searchable;
 }
 /**
+* Write one document's [[Property]] rows (ADR 0107): its name as `title`, each alias as
+* `aliases`, then what its Frontmatter carries. A [[Protected Document]] writes none. Its
+* Frontmatter is stored in plaintext, but no kind of matching in Search reaches protected
+* content, and a document with no rows cannot match a filter, not even a negated one, because
+* every filtered query also requires `protected = 0`.
+*/
+function insertProperties(db, pageId, doc) {
+	if (protectedFlag(doc) === 1) return;
+	const rows = [
+		{
+			key: "title",
+			value: doc.concept
+		},
+		...doc.aliases.map((alias) => ({
+			key: "aliases",
+			value: alias
+		})),
+		...doc.properties ?? []
+	];
+	for (const row of rows) db.run("INSERT INTO properties (page_id, key, key_lc, value, value_lc) VALUES (?,?,?,?,?)", [
+		pageId,
+		row.key,
+		row.key.toLowerCase(),
+		row.value,
+		row.value === null ? null : row.value.toLowerCase()
+	]);
+}
+/**
 * Write one document's [[Task Concept]] rows (ADR 0051).
 *
 * Derivation supplies the wikilinked half; the document's own concept is added HERE, as the
 * virtual root of every task's ancestry chain, because derivation reads text and never learns
 * the document's identity. Without that row, filtering to a project page returns nothing for
-* the tasks written directly on it — the case the "Use <active tab>" shortcut exists 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
@@ -2879,7 +3034,8 @@ function deleteGeneration(db, generation) {
 		"links",
 		"tasks",
 		"task_concepts",
-		"passages"
+		"passages",
+		"properties"
 	]) db.run(`DELETE FROM ${table} WHERE page_id IN (SELECT id FROM pages WHERE generation = ?)`, [generation]);
 	db.run("DELETE FROM pages WHERE generation = ?", [generation]);
 }
@@ -2954,6 +3110,7 @@ function ingestOne(db, doc) {
 			db.run("DELETE FROM tasks WHERE page_id = ?", [pageId]);
 			db.run("DELETE FROM task_concepts WHERE page_id = ?", [pageId]);
 			db.run("DELETE FROM passages WHERE page_id = ?", [pageId]);
+			db.run("DELETE FROM properties WHERE page_id = ?", [pageId]);
 			db.run("UPDATE pages SET concept = ?, kind = ?, text_hash = ?, protected = ? WHERE id = ?", [
 				doc.concept,
 				doc.kind,
@@ -3366,25 +3523,27 @@ var SNIPPET_TOKENS = 24;
 * scores merely reintroduces the long-document bias bm25 exists to remove. Counting is cruder,
 * robust, and explainable in one sentence - and it orders by a number the row displays.
 */
-function searchText$1(db, query, offset, limit) {
+function searchText$1(db, query, offset, limit, filters = []) {
 	const match = buildFtsMatch(query);
 	if (match === null) return {
 		groups: [],
 		hasMore: false
 	};
 	const generation = activeIndexGeneration(db);
+	const narrow = propertyFilterSql(filters);
 	const ranked = db.all(`WITH hits AS MATERIALIZED (
            SELECT rowid / ${BLOCK_FTS_STRIDE} AS page_id, bm25(block_fts) AS score
            FROM block_fts WHERE block_fts MATCH ?
          )
          SELECT h.page_id AS page_id, COUNT(*) AS matches, MIN(h.score) AS best
          FROM hits h
-         JOIN pages p ON p.id = h.page_id AND p.generation = ?
+         JOIN pages p ON p.id = h.page_id AND p.generation = ?${narrow.sql}
          GROUP BY h.page_id
          ORDER BY matches DESC, best ASC, h.page_id ASC
          LIMIT ? OFFSET ?`, [
 		match,
 		generation,
+		...narrow.params,
 		limit + 1,
 		offset
 	]);
@@ -3462,21 +3621,23 @@ function searchBreadcrumb(blocks, localId) {
 * Capped rather than exact because a prefix query - which is every query, mid-typing - can
 * match most of the graph, and this runs beside the rows it must never delay.
 */
-function searchTextCount(db, query) {
+function searchTextCount(db, query, filters = []) {
 	const match = buildFtsMatch(query);
 	if (match === null) return {
 		total: 0,
 		capped: false
 	};
+	const narrow = propertyFilterSql(filters);
 	const n = db.all(`SELECT COUNT(*) AS n FROM (
            SELECT m.page_id FROM (
              SELECT DISTINCT rowid / 1048576 AS page_id FROM block_fts
              WHERE block_fts MATCH ?
            ) m
-           JOIN pages p ON p.id = m.page_id AND p.generation = ?
+           JOIN pages p ON p.id = m.page_id AND p.generation = ?${narrow.sql}
            LIMIT ?)`, [
 		match,
 		activeIndexGeneration(db),
+		...narrow.params,
 		1001
 	])[0]?.n ?? 0;
 	return n > 1e3 ? {
@@ -3487,6 +3648,106 @@ function searchTextCount(db, query) {
 		capped: false
 	};
 }
+/** Documents a filtered name listing returns at most: well past any graph Search serves. */
+var PROPERTY_MATCH_CAP = 5e3;
+/**
+* The SQL that narrows a query over `pages AS p` to the documents passing every filter, as an
+* `AND …` suffix, with its parameters in order. Empty when there are no filters. A filtered
+* query never returns a [[Protected Document]], which has no property rows; the explicit
+* `protected = 0` is what keeps a NEGATED filter from matching one.
+*/
+function propertyFilterSql(filters) {
+	if (filters.length === 0) return {
+		sql: "",
+		params: []
+	};
+	const clauses = ["p.protected = 0"];
+	const params = [];
+	for (const filter of filters) {
+		let test = "x.key_lc = ?";
+		params.push(filter.key.toLowerCase());
+		if (filter.value !== null) {
+			const value = filter.value.toLowerCase();
+			if (filter.prefix) {
+				test += " AND substr(x.value_lc, 1, ?) = ?";
+				params.push(Array.from(value).length, value);
+			} else {
+				test += " AND x.value_lc = ?";
+				params.push(value);
+			}
+		}
+		clauses.push(`${filter.negated ? "NOT " : ""}EXISTS (SELECT 1 FROM properties x WHERE x.page_id = p.id AND ${test})`);
+	}
+	return {
+		sql: ` AND ${clauses.join(" AND ")}`,
+		params
+	};
+}
+/**
+* Every key a searchable document carries, once per spelling, most used first: what decides
+* whether a typed `x:y` is a filter, and what the key suggestions offer.
+*/
+function propertyKeys(db) {
+	return db.all(`SELECT pr.key AS key, COUNT(DISTINCT pr.page_id) AS documents
+         FROM properties pr JOIN pages p ON p.id = pr.page_id
+         WHERE p.generation = ?
+         GROUP BY pr.key
+         ORDER BY documents DESC, pr.key_lc, pr.key`, [activeIndexGeneration(db)]);
+}
+/** The values `key` has across the graph, grouped ignoring case, most used first. */
+function propertyValues(db, key, limit = 50) {
+	return db.all(`SELECT MIN(pr.value) AS value, COUNT(DISTINCT pr.page_id) AS documents
+         FROM properties pr JOIN pages p ON p.id = pr.page_id
+         WHERE p.generation = ? AND pr.key_lc = ? AND pr.value IS NOT NULL
+         GROUP BY pr.value_lc
+         ORDER BY documents DESC, pr.value_lc
+         LIMIT ?`, [
+		activeIndexGeneration(db),
+		key.toLowerCase(),
+		limit
+	]);
+}
+/**
+* Every document that passes all `filters`, in name order, with the values of the keys the
+* positive filters name (not `title`, which the row already shows). Empty without a filter:
+* listing the whole graph is [[All Documents]]' job.
+*/
+function documentsMatchingProperties(db, filters, limit = PROPERTY_MATCH_CAP) {
+	if (filters.length === 0) return [];
+	const narrow = propertyFilterSql(filters);
+	const pages = db.all(`SELECT p.id AS id, p.concept AS concept, p.kind AS kind FROM pages p
+         WHERE p.generation = ?${narrow.sql}
+         ORDER BY p.concept_key
+         LIMIT ?`, [
+		activeIndexGeneration(db),
+		...narrow.params,
+		limit
+	]);
+	if (pages.length === 0) return [];
+	const shown = [...new Set(filters.filter((f) => !f.negated).map((f) => f.key.toLowerCase()))].filter((key) => key !== "title");
+	const values = /* @__PURE__ */ new Map();
+	if (shown.length > 0) {
+		const rows = db.all(`SELECT page_id, key, value FROM properties
+             WHERE page_id IN (SELECT value FROM json_each(?))
+               AND key_lc IN (SELECT value FROM json_each(?))
+               AND value IS NOT NULL
+             ORDER BY rowid`, [JSON.stringify(pages.map((page) => page.id)), JSON.stringify(shown)]);
+		for (const row of rows) {
+			const list = values.get(row.page_id);
+			const entry = {
+				key: row.key,
+				value: row.value
+			};
+			if (list) list.push(entry);
+			else values.set(row.page_id, [entry]);
+		}
+	}
+	return pages.map((page) => ({
+		concept: page.concept,
+		kind: page.kind,
+		properties: values.get(page.id) ?? []
+	}));
+}
 /** Escape a literal for a LIKE pattern, so an asset name can never behave as a wildcard. */
 function likeLiteral(needle) {
 	return needle.replace(/[\\%_]/g, (c) => `\\${c}`);
@@ -4010,7 +4271,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.v13.sqlite`;
+var INDEX_FILE_NAME = `index.v14.sqlite`;
 var VECTORS_FILE_NAME = `vectors.v1.sqlite`;
 function cacheFile(dir) {
 	return join(dir, CACHE_FILE_NAME);
@@ -4039,7 +4300,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;
 }
@@ -4327,7 +4588,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) {
@@ -4524,7 +4785,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
@@ -4597,7 +4858,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);
 }
@@ -4619,7 +4880,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));
@@ -4640,7 +4901,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);
@@ -6396,6 +6657,172 @@ function parseFrontmatter(text) {
 	}
 }
 //#endregion
+//#region ../client/src/lib/document/frontmatter/frontmatter-yaml.ts
+/**
+* Reading, editing and writing a [[Frontmatter]] block's YAML in the one style EtherPK writes
+* (ADR 0108).
+*
+* Every writer goes through here: the identity write-back, publishing, the arbitrary-key patch,
+* the importers, Add frontmatter and the editor's tidy when an editing episode ends. Edits go
+* through the `yaml` library's document model rather than a plain object, so a comment, and any
+* key the edit does not touch, survives. The block is then written in the EtherPK style:
+*
+* - two-space indentation, a list under its key as `  - item`, one item per line;
+* - an inline list (`[a, b]`) written as a block list; an empty `[]` written bare on a key EtherPK
+*   reads (`publications:`), where empty means not set, and kept on any other key;
+* - quotes only where a value needs them (`"true"` stays quoted, `"hello"` does not);
+* - no line wrapping, no blank lines, key order as found, comments kept;
+* - an empty value written bare (`slug:`), which reads as "fill this in".
+*
+* Restyling never changes what the block says: the value is compared before and after, and a
+* rewrite that would change it is dropped. A block that does not parse is never rewritten.
+*
+* Pure: no store, no editor. What counts as a block comes from `frontmatter-span.ts`.
+*/
+/** The `yaml` serialiser options that make up the EtherPK style. */
+var STYLE = {
+	indent: 2,
+	indentSeq: true,
+	lineWidth: 0,
+	minContentWidth: 0,
+	nullStr: ""
+};
+/**
+* The block's YAML parsed as a document, or null when it does not parse or is not a mapping.
+* An empty block (or one holding only comments) is an empty mapping.
+*/
+function parseBlock(body) {
+	const doc = parseDocument(body);
+	if (doc.errors.length > 0) return null;
+	if (doc.contents === null) {
+		doc.contents = new YAMLMap();
+		return doc;
+	}
+	return isMap(doc.contents) ? doc : null;
+}
+/** The block's YAML as a plain object, or null when it does not parse to a mapping. */
+function frontmatterData(body) {
+	const doc = parseBlock(body);
+	return doc === null ? null : doc.toJS();
+}
+/**
+* The keys EtherPK reads, on which an empty value means the key is not set (ADR 0108, point 5).
+* On these an empty `[]` and a bare key say the same thing, so the style writes it bare. Another
+* key's `[]` is kept: to a tool that reads it, an empty list and no value may differ.
+*/
+var NOT_SET_WHEN_EMPTY = new Set([
+	"title",
+	"aliases",
+	"public",
+	"publications",
+	"slug",
+	"date",
+	"publication"
+]);
+/** Apply the EtherPK style to a document in place. */
+function applyStyle(doc) {
+	visit(doc, {
+		Pair(_, pair, path) {
+			if (path.length !== 2) return;
+			const key = isScalar(pair.key) ? pair.key.value : pair.key;
+			if (typeof key === "string" && NOT_SET_WHEN_EMPTY.has(key) && isSeq(pair.value) && pair.value.items.length === 0) pair.value = new Scalar(null);
+		},
+		Scalar(_, node) {
+			node.spaceBefore = false;
+			if (typeof node.value === "string" && !node.value.includes("\n") && (node.type === "QUOTE_DOUBLE" || node.type === "QUOTE_SINGLE")) node.type = "PLAIN";
+		},
+		Map(_, node) {
+			node.spaceBefore = false;
+			if (node.items.length > 0) node.flow = false;
+		},
+		Seq(_, node) {
+			node.spaceBefore = false;
+			if (node.items.length > 0) node.flow = false;
+		}
+	});
+}
+/** The styled YAML of a document, ending in a newline, or '' when it has no keys and no comment. */
+function styledYaml(doc) {
+	applyStyle(doc);
+	const map = doc.contents;
+	if (isMap(map) && map.items.length === 0) return doc.commentBefore ? `${doc.commentBefore.replace(/^/gm, "#")}\n` : "";
+	return doc.toString(STYLE);
+}
+/** Deep equality over the plain values a block parses to. */
+function sameValue(a, b) {
+	return JSON.stringify(a) === JSON.stringify(b);
+}
+/**
+* A new block holding `data`, in the EtherPK style: `---\n…---\n`, or '' when `data` has no keys.
+* For a document that has no block yet; to change a block that exists use {@link editFrontmatter},
+* which keeps what the block already says.
+*/
+function renderFrontmatter(data) {
+	if (Object.keys(data).length === 0) return "";
+	return `---\n${styledYaml(new Document(data))}---\n`;
+}
+/** The line terminator a block uses, so a rewrite does not mix endings in a CRLF file. */
+function eolOf(text, end) {
+	return text.slice(0, end).includes("\r\n") ? "\r\n" : "\n";
+}
+function withEol(yaml, eol) {
+	return eol === "\n" ? yaml : yaml.replace(/\n/g, eol);
+}
+function editorFor(doc) {
+	const map = doc.contents;
+	const keyOf = (item) => String(isScalar(item.key) ? item.key.value : item.key);
+	return {
+		has: (key) => map.has(key),
+		get: (key) => map.has(key) ? doc.toJS()[key] : void 0,
+		set(key, value, where = "last") {
+			if (map.has(key)) {
+				const current = doc.toJS()[key];
+				if (sameValue(current, value)) return;
+				map.set(key, doc.createNode(value));
+				return;
+			}
+			const pair = doc.createPair(key, value);
+			if (where === "first") map.items.unshift(pair);
+			else map.items.push(pair);
+		},
+		delete: (key) => {
+			map.delete(key);
+		},
+		keys: () => map.items.map(keyOf)
+	};
+}
+/**
+* The text with its block changed by `edit`, then written in the EtherPK style. The same string
+* comes back when the edit changes nothing the block says, so a writer that runs on every save
+* never restyles a block it agrees with. A block whose YAML does not parse is left alone: rewriting
+* it would destroy whatever the person was typing. A block the edit empties of every key is
+* removed.
+*/
+function editFrontmatter(text, edit, options = {}) {
+	const span = frontmatterSpan(text);
+	if (!span && !options.addBlock) return text;
+	const doc = span ? parseBlock(span.body) : parseBlock("");
+	if (doc === null) return text;
+	const before = doc.toJS();
+	edit(editorFor(doc));
+	if (sameValue(doc.toJS(), before)) return text;
+	const body = span ? text.slice(span.end) : text;
+	if (doc.contents.items.length === 0) return body;
+	const eol = span ? eolOf(text, span.end) : "\n";
+	return `---${eol}${withEol(styledYaml(doc), eol)}---${eol}${body}`;
+}
+/**
+* Whether a value counts as not set (ADR 0108): nothing, a blank string, an empty list, or a
+* mapping whose every value is itself empty. `false` and `0` are values.
+*/
+function isEmptyValue(value) {
+	if (value === null || value === void 0) return true;
+	if (typeof value === "string") return value.trim() === "";
+	if (Array.isArray(value)) return value.length === 0;
+	if (typeof value === "object" && !(value instanceof Date)) return Object.values(value).every(isEmptyValue);
+	return false;
+}
+//#endregion
 //#region ../client/src/lib/document/publish/publication.ts
 /** A publication id: kebab-case, what `publications:` entries and `theme:` graph ids look like. */
 var PUBLICATION_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
@@ -6411,13 +6838,19 @@ function readMembership(text, concept) {
 	const { data } = parseFrontmatter(text);
 	const issues = [];
 	const isPublic = data.public === true;
+	if (!isEmptyValue(data.public) && typeof data.public !== "boolean") issues.push({
+		level: "warning",
+		code: "public-not-a-boolean",
+		message: `\`public\` is the text "${String(data.public)}", not \`true\` or \`false\`, so the document is not public. Write \`public: true\` without quotes to publish it.`,
+		concept
+	});
 	const publications = [];
-	const raw = data.publications;
-	const entries = raw === void 0 ? [] : Array.isArray(raw) ? raw : typeof raw === "string" ? [raw] : null;
+	const raw = isEmptyValue(data.publications) ? void 0 : data.publications;
+	const entries = raw === void 0 ? [] : Array.isArray(raw) ? raw : null;
 	if (entries === null) issues.push({
 		level: "warning",
 		code: "publications-not-a-list",
-		message: "`publications` must be a list of publication ids, like `publications: [docs, blog]`.",
+		message: "`publications` must be a list of publication ids, each on its own line under the key as `- docs`, even when there is one.",
 		concept
 	});
 	else for (const entry of entries) if (isPublicationId(entry)) {
@@ -6434,13 +6867,33 @@ function readMembership(text, concept) {
 		issues
 	};
 }
+var DATE = /^\d{4}-\d{2}-\d{2}$/;
+/**
+* The day a page is dated on a blog, from its `date:` key, and a warning when the key holds
+* something that is not a calendar day. A journal entry is dated by its name, never by this key.
+*/
+function readPageDate(doc) {
+	const date = parseFrontmatter(doc.text).data.date;
+	if (isEmptyValue(date)) return { issues: [] };
+	const text = date instanceof Date ? date.toISOString().slice(0, 10) : String(date);
+	if (DATE.test(text)) return {
+		date: text,
+		issues: []
+	};
+	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.`,
+		concept: doc.concept
+	}] };
+}
 var KINDS$1 = ["docs", "blog"];
 var SELECTIONS = ["named", "all-public"];
 /** The publication a page defines through its `publication:` mapping, validated. */
 function readPublicationDefinition(doc) {
 	const { data, body } = parseFrontmatter(doc.text);
 	const raw = data.publication;
-	if (raw === void 0) return {
+	if (isEmptyValue(raw)) return {
 		publication: null,
 		issues: []
 	};
@@ -6459,13 +6912,13 @@ 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
 		};
 	}
-	const def = raw;
+	const def = Object.fromEntries(Object.entries(raw).filter(([, value]) => !isEmptyValue(value)));
 	const id = def.id;
 	if (id === void 0 || id === null || id === "") issue("publication-missing-id", "`publication` needs an `id`: lower-case letters, digits and hyphens, like `docs`.");
 	else if (!isPublicationId(id)) issue("publication-invalid-id", `"${String(id)}" is not a publication id: use lower-case letters, digits and hyphens, like \`docs\`.`);
@@ -6486,13 +6939,16 @@ function readPublicationDefinition(doc) {
 	if (def.recent !== void 0) if (typeof def.recent === "number" && Number.isInteger(def.recent) && def.recent > 0) recent = def.recent;
 	else issue("publication-invalid-recent", "`recent` must be a whole number above zero: how many posts the front page lists (10 unless set).");
 	const includes = {};
-	if (def.includes !== void 0) if (typeof def.includes === "object" && def.includes !== null && !Array.isArray(def.includes)) for (const [slot, value] of Object.entries(def.includes)) if (typeof value === "string" && value.trim() !== "") includes[slot] = value.trim();
-	else issues.push({
-		level: "warning",
-		code: "publication-invalid-include",
-		message: `Include \`${slot}\` must name the page that fills it; it is ignored.`,
-		concept: doc.concept
-	});
+	if (def.includes !== void 0) if (typeof def.includes === "object" && def.includes !== null && !Array.isArray(def.includes)) for (const [slot, value] of Object.entries(def.includes)) {
+		if (isEmptyValue(value)) continue;
+		if (typeof value === "string" && value.trim() !== "") includes[slot] = value.trim();
+		else issues.push({
+			level: "warning",
+			code: "publication-invalid-include",
+			message: `Include \`${slot}\` must name the page that fills it - it is ignored.`,
+			concept: doc.concept
+		});
+	}
 	else issue("publication-invalid-includes", "`includes` must be a mapping of include slot to the page that fills it.");
 	if (issues.some((i) => i.level === "error")) return {
 		publication: null,
@@ -6551,7 +7007,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
 		});
 	}
@@ -6588,7 +7044,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);
@@ -8557,7 +9013,7 @@ function createIndexCore(host) {
 				}];
 			}
 			case "search-text": {
-				const page = db ? searchText$1(db, request.query, request.offset, request.limit) : {
+				const page = db ? searchText$1(db, request.query, request.offset, request.limit, request.filters ?? []) : {
 					groups: [],
 					hasMore: false
 				};
@@ -8569,7 +9025,7 @@ function createIndexCore(host) {
 				}];
 			}
 			case "search-count": {
-				const count = db ? searchTextCount(db, request.query) : {
+				const count = db ? searchTextCount(db, request.query, request.filters ?? []) : {
 					total: 0,
 					capped: false
 				};
@@ -8580,6 +9036,21 @@ function createIndexCore(host) {
 					capped: count.capped
 				}];
 			}
+			case "property-keys": return [{
+				type: "property-keys",
+				id: request.id,
+				keys: db ? propertyKeys(db) : []
+			}];
+			case "property-values": return [{
+				type: "property-values",
+				id: request.id,
+				values: db ? propertyValues(db, request.key) : []
+			}];
+			case "property-match": return [{
+				type: "property-match",
+				id: request.id,
+				documents: db ? documentsMatchingProperties(db, request.filters) : []
+			}];
 			case "tasks": {
 				const page = db ? tasksMatching(db, request.query, request.offset, request.limit) : {
 					hits: [],
@@ -9297,30 +9768,52 @@ function createRemoteGraphIndex(source, transport, options) {
 				needles: [...needles]
 			}))).usage;
 		},
-		async searchText(query, offset, limit) {
+		async searchText(query, offset, limit, filters) {
 			const response = await request((id) => ({
 				type: "search-text",
 				id,
 				query,
 				offset,
-				limit
+				limit,
+				...filters?.length ? { filters: [...filters] } : {}
 			}));
 			return {
 				groups: response.groups,
 				hasMore: response.hasMore
 			};
 		},
-		async searchTextCount(query) {
+		async searchTextCount(query, filters) {
 			const response = await request((id) => ({
 				type: "search-count",
 				id,
-				query
+				query,
+				...filters?.length ? { filters: [...filters] } : {}
 			}));
 			return {
 				total: response.total,
 				capped: response.capped
 			};
 		},
+		async propertyKeys() {
+			return (await request((id) => ({
+				type: "property-keys",
+				id
+			}))).keys;
+		},
+		async propertyValues(key) {
+			return (await request((id) => ({
+				type: "property-values",
+				id,
+				key
+			}))).values;
+		},
+		async propertyMatch(filters) {
+			return (await request((id) => ({
+				type: "property-match",
+				id,
+				filters: [...filters]
+			}))).documents;
+		},
 		async tasks(query, offset, limit) {
 			const response = await request((id) => ({
 				type: "tasks",
@@ -10067,7 +10560,7 @@ async function deleteGraphTheme(adapter, id) {
 /** What the block claims. An unterminated block is not a block, as everywhere else. */
 function frontmatterIdentity(text) {
 	const span = frontmatterSpan(text);
-	const data = span ? parseBlock$2(span.body) : {};
+	const data = span ? frontmatterData(span.body) : {};
 	if (data === null) return {
 		title: null,
 		aliases: [],
@@ -10119,37 +10612,19 @@ function sameAliases(a, b) {
 */
 function withFrontmatterIdentity(text, patch, options = {}) {
 	const span = frontmatterSpan(text);
-	if (!span) {
-		if (!options.addBlock) return text;
-		const data = {};
-		if (typeof patch.title === "string" && patch.title.trim() !== "") data.title = patch.title;
-		const aliases = patch.aliases ? [...patch.aliases] : [];
-		if (aliases.length > 0) data.aliases = aliases;
-		if (Object.keys(data).length === 0) return text;
-		return `---\n${stringify(data)}---\n${text}`;
-	}
-	const data = parseBlock$2(span.body);
-	if (data === null) return text;
-	const currentTitle = titleOf(data);
-	const currentAliases = aliasesOf({ data });
-	const wantTitle = patch.title === void 0 ? currentTitle : patch.title;
-	const wantAliases = patch.aliases === void 0 ? currentAliases : [...patch.aliases];
-	if (wantTitle === currentTitle && sameAliases(wantAliases, currentAliases)) return text;
-	const next = {};
-	if (wantTitle !== null && !("title" in data)) next.title = wantTitle;
-	for (const [key, value] of Object.entries(data)) {
-		if (key === "title") {
-			if (wantTitle !== null) next.title = wantTitle;
-			continue;
-		}
-		if (key === "aliases") {
-			if (wantAliases.length > 0) next.aliases = wantAliases;
-			continue;
-		}
-		next[key] = value;
+	if (span) {
+		const data = frontmatterData(span.body);
+		if (data === null) return text;
+		const wantTitle = patch.title === void 0 ? titleOf(data) : patch.title;
+		const wantAliases = patch.aliases === void 0 ? aliasesOf({ data }) : patch.aliases;
+		if (wantTitle === titleOf(data) && sameAliases(wantAliases, aliasesOf({ data }))) return text;
 	}
-	if (wantAliases.length > 0 && !("aliases" in data)) next.aliases = wantAliases;
-	return `---\n${serialise(next)}---\n${text.slice(span.end)}`;
+	return editFrontmatter(text, (block) => {
+		if (patch.title !== void 0) if (patch.title === null || patch.title.trim() === "") block.delete("title");
+		else block.set("title", patch.title, "first");
+		if (patch.aliases !== void 0) if (patch.aliases.length > 0) block.set("aliases", [...patch.aliases]);
+		else block.delete("aliases");
+	}, options);
 }
 /**
 * `after` - a writer's rewrite of `before` - with the document's aliases carried into the block
@@ -10164,19 +10639,83 @@ function withAliasesInAddedBlock(before, after, aliases) {
 	if (aliases.length === 0 || frontmatterSpan(before) !== null || frontmatterSpan(after) === null) return after;
 	return withFrontmatterIdentity(after, { aliases });
 }
-/** The block's YAML as a plain object, or null when it is malformed or not an object. */
-function parseBlock$2(yaml) {
-	try {
-		const parsed = parse(yaml);
-		if (parsed === null || parsed === void 0) return {};
-		if (typeof parsed !== "object" || Array.isArray(parsed)) return null;
-		return parsed;
-	} catch {
-		return null;
+//#endregion
+//#region ../client/src/lib/document/properties.ts
+/**
+* Keys a Property Filter answers from the graph's names rather than the block: the registry on
+* a Server Backend holds them, and a page created in the app there has no block to read.
+*/
+var NAME_PROPERTY_KEYS = new Set(["title", "aliases"]);
+/** Rows per document at most. Frontmatter is metadata; a block past this is not a label set. */
+var MAX_ROWS = 256;
+/** Characters of one value kept. Longer text is prose, which Search's text group covers. */
+var MAX_VALUE_LENGTH = 1e3;
+/**
+* Whether a value counts as not set (ADR 0108): null, blank text, a list with no set item, or a
+* mapping with no set value. `false` and `0` are values.
+*/
+function isEmptyPropertyValue(value) {
+	if (value === null || value === void 0) return true;
+	if (typeof value === "string") return value.trim() === "";
+	if (Array.isArray(value)) return value.every(isEmptyPropertyValue);
+	if (isMapping(value)) return Object.values(value).every(isEmptyPropertyValue);
+	return false;
+}
+/**
+* The rows for one document's parsed Frontmatter, in the block's order. Empty values are left
+* out, and so are `title` and `aliases` in any spelling: those filters read the graph's names.
+*/
+function propertiesOf(data) {
+	const out = [];
+	for (const [key, value] of Object.entries(data)) {
+		if (NAME_PROPERTY_KEYS.has(key.toLowerCase())) continue;
+		collect(key, value, out);
+		if (out.length >= MAX_ROWS) break;
+	}
+	return out.slice(0, MAX_ROWS);
+}
+/** Append the rows for `value` under `path`; a mapping adds its presence row before its values. */
+function collect(path, value, out) {
+	if (isEmptyPropertyValue(value)) return;
+	if (Array.isArray(value)) {
+		let presence = false;
+		for (const item of value) if (isMapping(item)) {
+			if (!presence && !isEmptyPropertyValue(item)) {
+				out.push({
+					key: path,
+					value: null
+				});
+				presence = true;
+			}
+			for (const [key, child] of Object.entries(item)) collect(`${path}.${key}`, child, out);
+		} else collect(path, item, out);
+		return;
+	}
+	if (isMapping(value)) {
+		out.push({
+			key: path,
+			value: null
+		});
+		for (const [key, child] of Object.entries(value)) collect(`${path}.${key}`, child, out);
+		return;
 	}
+	out.push({
+		key: path,
+		value: textOf(value).slice(0, MAX_VALUE_LENGTH)
+	});
 }
-function serialise(data) {
-	return Object.keys(data).length === 0 ? "" : stringify(data);
+function isMapping(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
+}
+/** A scalar as the text a person would type to find it. */
+function textOf(value) {
+	if (value instanceof Date) {
+		const iso = value.toISOString();
+		return iso.endsWith("T00:00:00.000Z") ? iso.slice(0, 10) : iso;
+	}
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return String(value);
+	return JSON.stringify(value) ?? "";
 }
 //#endregion
 //#region ../client/src/lib/document/calendar/month-grid-core.ts
@@ -10507,7 +11046,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;
 	}
 };
@@ -10757,23 +11296,6 @@ async function scanGraph(adapter, options = {}) {
 //#endregion
 //#region ../client/src/lib/storage/fs/filesystem-store.ts
 /**
-* A {@link DocumentStore} over a real directory (via a {@link DirectoryAdapter}):
-* the Filesystem Backend. The files *are* the state — this holds only a live
-* buffer per open document plus a derived registry, and reconciles external
-* changes (git checkout, Syncthing) the way DESIGN.md → The git workflow requires.
-*
-* Assembled entirely from the pure pieces (scan, identity, reconcileDecision,
-* debounce) so it is exercised in Node over createMemoryDirectoryAdapter before
-* any browser code exists.
-*
-* Async-seam note: the seam's
-* `getText()` is synchronous but disk reads are async, so `open()` returns a
-* handle whose buffer is empty on first open and is hydrated by an internal
-* awaited read that then notifies subscribers the *external* way — which is safe
-* because DocumentView registers its `subscribe` listener in the same synchronous
-* onMount tick as its `getText()` seed, before the read resolves.
-*/
-/**
 * The snapshot for one document's full text: identity from the registry, aliases and include
 * facts from the frontmatter, the body for the index. Both backends build theirs this way, so
 * the index sees one shape whatever holds the document.
@@ -10786,12 +11308,14 @@ function indexSnapshotOf(identity, text) {
 		text,
 		aliases: []
 	}) : [];
+	const properties = propertiesOf(fm.data);
 	return {
 		concept: identity.concept,
 		kind: identity.kind,
 		aliases: aliasesOf(fm),
 		text: fm.body,
-		...includes.length > 0 ? { includes } : {}
+		...includes.length > 0 ? { includes } : {},
+		...properties.length > 0 ? { properties } : {}
 	};
 }
 function applyTextChange(text, change) {
@@ -10964,7 +11488,7 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 		const fm = parseFrontmatter(text);
 		let aliases = aliasesOf(fm);
 		let body = fm.body;
-		let data = { ...fm.data };
+		let blockSource = text;
 		if (strategy === "alias") {
 			if (!aliases.some((a) => conceptKey(a) === conceptKey(step.from))) aliases = [...aliases, step.from];
 		}
@@ -10983,15 +11507,17 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 			});
 			body = merged.body;
 			aliases = merged.aliases;
-			data = { ...existingFm.data };
+			blockSource = existing.text;
 		}
 		aliases = normaliseAliases(aliases, step.into);
-		data.title = step.into;
-		if (aliases.length > 0) data.aliases = aliases;
-		else delete data.aliases;
+		const blockSpan = frontmatterSpan(blockSource);
+		const content = withFrontmatterIdentity((blockSpan ? blockSource.slice(0, blockSpan.end) : "") + body, {
+			title: step.into,
+			aliases
+		}, { addBlock: true });
 		const subdir = survivor?.subdir ?? entry.subdir;
 		const fileName = survivor?.fileName ?? await allocateFileName(subdir, step.into, entry);
-		const written = await adapter.write(subdir, fileName, `---\n${stringify(data)}---\n${body}`);
+		const written = await adapter.write(subdir, fileName, content);
 		if (!(subdir === entry.subdir && fileName === entry.fileName)) await adapter.remove(entry.subdir, entry.fileName);
 		registry.delete(entry.key);
 		if (survivor) registry.delete(survivor.key);
@@ -11354,7 +11880,7 @@ function createFilesystemDocumentStore(adapter, options = {}) {
 			if (registry.get(key)) throw new Error(`A document for "${concept}" already exists.`);
 			await adapter.ensureSkeleton();
 			const fileName = await allocateFileName("pages", concept);
-			const content = `---\n${stringify({ title: concept })}---\n${body}`;
+			const content = renderFrontmatter({ title: concept }) + body;
 			await adapter.write("pages", fileName, content);
 			await refreshRegistry();
 			return concept;
@@ -11847,12 +12373,14 @@ function createServerDocumentStore(graph, options) {
 			text,
 			aliases: []
 		}) : [];
+		const properties = propertiesOf(parseFrontmatter(text).data);
 		return {
 			concept,
 			kind: entry.kind,
 			aliases: entry.aliases ?? [],
 			text: bodyForIndex(text),
-			...includes.length > 0 ? { includes } : {}
+			...includes.length > 0 ? { includes } : {},
+			...properties.length > 0 ? { properties } : {}
 		};
 	}
 	/**
@@ -13005,8 +13533,9 @@ function assembleHeadlessGraph(parts) {
 }
 /** Open a synced graph, scan its registry and build the index; resolves once tools can answer. */
 async function openHeadlessGraph(deps) {
-	const cache = await openGraphCache(deps.graphId);
-	if (deps.persistDir) await loadLocalCache(deps.persistDir, deps.graphId);
+	const cacheName = deps.localCacheName ?? deps.graphId;
+	const cache = await openGraphCache(cacheName);
+	if (deps.persistDir) await loadLocalCache(deps.persistDir, cacheName);
 	const indexHost = deps.persistDir ? nodeIndexHost(deps.persistDir) : void 0;
 	const sync = createGraphSync({
 		graphId: deps.graphId,
@@ -13135,7 +13664,7 @@ async function openHeadlessGraph(deps) {
 			embeddingModel: deps.embeddingModel,
 			onSemanticProgress: deps.onSemanticProgress,
 			onError: deps.onError,
-			persistBackend: deps.persistDir ? () => persistLocalCache(deps.persistDir, deps.graphId) : void 0,
+			persistBackend: deps.persistDir ? () => persistLocalCache(deps.persistDir, cacheName) : void 0,
 			onChange: (schedule) => sync.onDocUpdate(schedule),
 			async settle(schedulePersist) {
 				await sync.flushAll();
@@ -13262,7 +13791,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;
@@ -13441,7 +13970,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";
 	}
 };
@@ -13457,7 +13986,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;
 	}
 }
@@ -13586,7 +14115,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("");
@@ -13809,7 +14338,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": "",
@@ -13830,7 +14359,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": "",
@@ -13858,7 +14387,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",
@@ -13873,7 +14402,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": "",
@@ -13897,7 +14426,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": "",
@@ -13915,12 +14444,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": "",
@@ -13989,134 +14518,43 @@ function bundledThemeList() {
 //#region ../client/src/lib/document/frontmatter/patch.ts
 /**
 * Rewriting arbitrary keys of a document's [[Frontmatter]] block, the way `withFrontmatterIdentity`
-* rewrites identity: other keys keep their values and order, the same string comes back when
-* nothing would change, and a block whose YAML does not parse is left alone rather than
+* rewrites identity: other keys keep their values, order and comments, the same string comes back
+* when nothing would change, and a block whose YAML does not parse is left alone rather than
 * destroyed. `null` removes a key. A block emptied of every key is removed with it. Identity keys
 * are not this function's business: pass them through `withFrontmatterIdentity` so the registry
 * rules (ADR 0061) apply.
 */
-function parseBlock$1(yaml) {
-	try {
-		const parsed = parse(yaml);
-		if (parsed === null || parsed === void 0) return {};
-		if (typeof parsed !== "object" || Array.isArray(parsed)) return null;
-		return parsed;
-	} catch {
-		return null;
-	}
-}
-function same(a, b) {
-	return JSON.stringify(a) === JSON.stringify(b);
-}
 function withFrontmatterPatch(text, patch, options = {}) {
-	const span = frontmatterSpan(text);
-	if (!span) {
-		if (!options.addBlock) return text;
-		const data = {};
-		for (const [key, value] of Object.entries(patch)) if (value !== null && value !== void 0) data[key] = value;
-		if (Object.keys(data).length === 0) return text;
-		return `---\n${stringify(data)}---\n${text}`;
-	}
-	const data = parseBlock$1(span.body);
-	if (data === null) return text;
-	const next = {};
-	let changed = false;
-	for (const [key, value] of Object.entries(data)) {
-		if (key in patch) {
-			const wanted = patch[key];
-			if (wanted === null || wanted === void 0) {
-				changed = true;
-				continue;
-			}
-			next[key] = wanted;
-			if (!same(wanted, value)) changed = true;
-			continue;
-		}
-		next[key] = value;
-	}
-	for (const [key, value] of Object.entries(patch)) {
-		if (key in data || value === null || value === void 0) continue;
-		next[key] = value;
-		changed = true;
-	}
-	if (!changed) return text;
-	if (Object.keys(next).length === 0) return text.slice(span.end);
-	return `---\n${stringify(next)}---\n${text.slice(span.end)}`;
+	return editFrontmatter(text, (block) => {
+		for (const [key, value] of Object.entries(patch)) if (value === null || value === void 0) block.delete(key);
+		else block.set(key, value);
+	}, options);
 }
 //#endregion
 //#region ../client/src/lib/document/frontmatter/publishing.ts
 /**
 * The publishing keys of a document's [[Frontmatter]] (ADR 0082): `public: true` is the consent
-* switch, `publications: [docs, blog]` routes. A public document with an empty list keeps the
-* key as `publications: []`: public with nowhere to go is a state worth a prompt, and the empty
-* key is that prompt to whoever edits the file by hand. Not public, the empty key is removed. Rewritten the way `withFrontmatterIdentity`
-* rewrites identity: other keys keep their values and order, the same string comes back when
-* nothing would change, and a block whose YAML does not parse is left alone rather than
-* destroyed. Read through `readMembership` in `publish/publication.ts`; this file only writes.
-*/
-function parseBlock(yaml) {
-	try {
-		const parsed = parse(yaml);
-		if (parsed === null || parsed === void 0) return {};
-		if (typeof parsed !== "object" || Array.isArray(parsed)) return null;
-		return parsed;
-	} catch {
-		return null;
-	}
-}
-function sameList(a, b) {
-	return Array.isArray(a) && a.length === b.length && a.every((v, i) => v === b[i]);
-}
+* switch, and `publications`, a list of publication ids, routes. A public document with no
+* publication keeps the key, written bare (`publications:`): public with nowhere to go is a state
+* worth a prompt, and the empty key is that prompt to whoever edits the file by hand. Bare rather
+* than `[]` because that is how the EtherPK style writes every empty value (ADR 0108), and because
+* Enter after a bare key opens the next line one level in, ready for the first `- id`. Not public, the empty key is
+* removed. Rewritten the way `withFrontmatterIdentity` rewrites identity: other keys keep their
+* values and order, the same string comes back when nothing would change, and a block whose YAML
+* does not parse is left alone rather than destroyed. Read through `readMembership` in
+* `publish/publication.ts`, which reads a bare key and `[]` alike; this file only writes.
+*/
 /** The text with its publishing keys rewritten. `addBlock` adds a block to a document without one. */
 function withPublishing(text, patch, options = {}) {
 	const publications = patch.publications === void 0 || patch.publications === null ? patch.publications : [...new Set(patch.publications.filter(isPublicationId))];
-	const span = frontmatterSpan(text);
-	if (!span) {
-		if (!options.addBlock) return text;
-		const data = {};
-		if (patch.public === true || patch.public === false) data.public = patch.public;
-		if (publications && (publications.length > 0 || patch.public === true)) data.publications = publications;
-		if (Object.keys(data).length === 0) return text;
-		return `---\n${stringify(data)}---\n${text}`;
-	}
-	const data = parseBlock(span.body);
-	if (data === null) return text;
-	const next = {};
-	let changed = false;
-	const wantPublic = patch.public === void 0 ? data.public : patch.public;
-	const keepEmpty = wantPublic === true;
-	const wantPublications = publications === void 0 ? data.publications : publications && (publications.length > 0 || keepEmpty) ? publications : null;
-	for (const [key, value] of Object.entries(data)) {
-		if (key === "public") {
-			if (wantPublic === null || wantPublic === void 0) changed = true;
-			else {
-				next.public = wantPublic;
-				if (wantPublic !== value) changed = true;
-			}
-			continue;
-		}
-		if (key === "publications") {
-			if (wantPublications === null || wantPublications === void 0) changed = true;
-			else {
-				next.publications = wantPublications;
-				if (!sameList(value, wantPublications)) changed = true;
-			}
-			continue;
-		}
-		next[key] = value;
-	}
-	if (!("public" in data) && (wantPublic === true || wantPublic === false)) {
-		next.public = wantPublic;
-		changed = true;
-	}
-	if (!("publications" in data) && Array.isArray(wantPublications) && (wantPublications.length > 0 || keepEmpty)) {
-		next.publications = wantPublications;
-		changed = true;
-	}
-	if (!changed) return text;
-	const yaml = Object.keys(next).length === 0 ? "" : stringify(next);
-	if (yaml === "") return text.slice(span.end);
-	return `---\n${yaml}---\n${text.slice(span.end)}`;
+	return editFrontmatter(text, (block) => {
+		if (patch.public === null) block.delete("public");
+		else if (patch.public !== void 0) block.set("public", patch.public);
+		if (publications === void 0) return;
+		const keepEmpty = (patch.public === void 0 ? block.get("public") : patch.public) === true;
+		if (publications === null || publications.length === 0 && !keepEmpty) block.delete("publications");
+		else block.set("publications", publications.length === 0 ? null : publications);
+	}, options);
 }
 //#endregion
 //#region ../client/src/lib/document/publish/seeded.ts
@@ -14130,7 +14568,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:
@@ -14161,7 +14599,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",
@@ -14179,9 +14617,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
@@ -14189,7 +14627,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
@@ -14213,15 +14651,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.
@@ -15107,7 +15545,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;
 					}
@@ -15128,7 +15566,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,
@@ -15211,7 +15649,7 @@ function allocate(documents) {
 	const derived = [];
 	for (const doc of documents) {
 		const value = parseFrontmatter(doc.text).data.slug;
-		if (value === void 0) {
+		if (isEmptyValue(value)) {
 			derived.push(doc);
 			continue;
 		}
@@ -15298,7 +15736,6 @@ function createThemeRenderer(theme, includes) {
 * a pre-render pass for the asynchronous bits (diagrams, code); then rendering, includes, the
 * theme, the derived files. Everything derived is computed from the included documents alone.
 */
-var DATE = /^\d{4}-\d{2}-\d{2}$/;
 function assetHrefOf(name) {
 	return `assets/${encodeURIComponent(name)}`;
 }
@@ -15366,7 +15803,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);
@@ -15375,13 +15812,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) {
@@ -15389,7 +15826,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
 		});
 	}
@@ -15439,12 +15876,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)) {
@@ -15454,7 +15891,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;
 		}
@@ -15469,7 +15906,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;
 		}
@@ -15542,17 +15979,9 @@ async function publishPublication(source, publication, env, options = {}) {
 		};
 		if (doc.kind === "journal") page.date = doc.concept;
 		else {
-			const date = parseFrontmatter(doc.text).data.date;
-			if (date !== void 0) {
-				const text = date instanceof Date ? date.toISOString().slice(0, 10) : String(date);
-				if (DATE.test(text)) page.date = text;
-				else warnings.push({
-					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.`,
-					concept: doc.concept
-				});
-			}
+			const dated = readPageDate(doc);
+			if (dated.date !== void 0) page.date = dated.date;
+			take(dated.issues);
 		}
 		for (const link of linksOf(bodyOf(doc), resolver, doc)) report.missingLinks.push(link);
 		pages.push(page);
@@ -15591,7 +16020,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;
 		}
@@ -15602,7 +16031,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;
 			}
@@ -15778,7 +16207,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;
@@ -15794,7 +16223,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) => ({
@@ -15828,7 +16257,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();
@@ -15839,7 +16268,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;
@@ -15932,7 +16361,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) {
@@ -16028,7 +16457,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
@@ -16182,7 +16611,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,
@@ -16208,7 +16637,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;
 }
@@ -16765,7 +17194,7 @@ function agentFrontmatter(rawText) {
 /**
 * The block after a patch. `public` and `publications` go through the publishing writer, so its
 * rules hold whoever writes them: an id is lower-case letters, digits and hyphens, and a public
-* document with an empty list keeps `publications: []` as the prompt it is. Everything else is a
+* document with an empty list keeps the key, written bare, as the prompt it is. Everything else is a
 * plain key. An invalid publication id is refused rather than dropped, which is what the
 * writer would do: an agent that misspells an id must hear about it.
 */
@@ -16839,7 +17268,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 {
@@ -16948,7 +17377,24 @@ function round(similarity) {
 	return Math.round(similarity * 1e3) / 1e3;
 }
 async function searchText(graph, query, offset, limit) {
-	const [result, count] = await Promise.all([graph.index.searchText(query, offset, limit), graph.index.searchTextCount(query)]);
+	const keys = await graph.index.propertyKeys();
+	const { words, filters } = parseSearchQuery(query, new Set(keys.map((info) => info.key.toLowerCase())));
+	if (filters.length > 0 && words.trim() === "") {
+		const documents = await graph.index.propertyMatch(filters);
+		return {
+			results: documents.slice(offset, offset + limit).map((doc) => ({
+				concept: doc.concept,
+				kind: doc.kind,
+				matches: 0,
+				hits: [],
+				properties: doc.properties
+			})),
+			total: documents.length,
+			totalCapped: false,
+			hasMore: offset + limit < documents.length
+		};
+	}
+	const [result, count] = await Promise.all([graph.index.searchText(words, offset, limit, filters), graph.index.searchTextCount(words, filters)]);
 	return {
 		results: result.groups.map((group) => ({
 			concept: group.concept,
@@ -17025,7 +17471,7 @@ 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);
 	graph.store.open(identity.concept).applyChange({
@@ -17072,7 +17518,7 @@ 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 ?? ""));
@@ -17402,7 +17848,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 = [];
@@ -17470,9 +17916,9 @@ async function setTask(graph, args) {
 	const lines = text.split("\n");
 	const current = lines[args.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 ${args.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.`);
+	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) {
@@ -17549,7 +17995,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 }
 	};
@@ -17665,7 +18111,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, {
@@ -17918,8 +18364,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",
@@ -18142,7 +18588,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,
@@ -18178,7 +18624,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(/^\.?\//, "");
@@ -18278,7 +18724,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),
@@ -18300,7 +18746,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 {
@@ -18325,7 +18771,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;
@@ -18369,7 +18815,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 {
@@ -18483,25 +18929,25 @@ 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.",
+		"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()
 		}
@@ -18518,7 +18964,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. 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([
@@ -18565,7 +19011,7 @@ function createMcpServer(graph, info) {
 	}, async (args) => run(() => tasks(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 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.",
 		inputSchema: {
 			concept,
 			line: z.number().int().nonnegative(),
@@ -18591,7 +19037,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."),
@@ -18625,7 +19071,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),
@@ -18638,7 +19084,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", {
@@ -18646,23 +19092,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", {
@@ -18676,25 +19122,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({
@@ -18703,27 +19149,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", {
@@ -18736,19 +19182,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)));
@@ -18763,7 +19209,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)
@@ -18771,7 +19217,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)
@@ -18779,12 +19225,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(),
@@ -19020,20 +19466,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).
@@ -19043,20 +19489,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
 `;
@@ -19069,7 +19515,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,
@@ -19108,7 +19554,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. */
@@ -19149,7 +19595,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,
@@ -19205,7 +19651,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();
 }
 /**
@@ -19274,7 +19720,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("");
@@ -19333,7 +19779,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;
@@ -19406,7 +19852,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
 	};
@@ -19478,7 +19924,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);
@@ -19488,17 +19934,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();
 		});
 	}