vde-open 0.1.0 → 0.1.1

package/README.md

@@ -11,21 +11,27 @@ A local document viewer for agents and people who work from the same material. O
 
 ## Install
 
-Node.js 24 or later is required (this repository pins 24.21.0 in `mise.toml`).
+Node.js 24 or later is required.
 
 ```bash
-pnpm install --frozen-lockfile
-pnpm build
-pnpm test:pack                              # builds artifacts/vde-open-0.1.0.tgz and verifies an install in a separate directory
-bun add -g ./artifacts/vde-open-0.1.0.tgz   # recommended: user-level install into ~/.bun/bin
+bun add -g vde-open      # recommended: user-level install into ~/.bun/bin
+npm install -g vde-open  # also works
 ```
 
 - We recommend installing it once per user with Bun. `~/.bun/bin` does not depend on which Node.js version is active, so switching Node.js versions (with mise and similar tools) does not remove `vo`. Bun is only used to install; the commands run on Node.js (`#!/usr/bin/env node`), so Node.js 24 or later must be on your `PATH`. Running it on the Bun runtime (`bun --bun`) is not tested.
-- `npm install -g ./artifacts/vde-open-0.1.0.tgz` also works, but it installs into the prefix of the active Node.js version.
+- `npm install -g` installs into the prefix of the active Node.js version.
 - Installing it per project is not recommended. There is one daemon per user, so different versions in different projects would talk to the same daemon.
-- Always start the path with `./`. Without it, the path is treated as a GitHub repository name.
 
-Installing does not change shell files such as `.zshrc`, and runs no build or install scripts (the tarball bundles every dependency). The package is not published to npm.
+Installing does not change shell files such as `.zshrc`, and runs no build or install scripts (the package bundles every dependency). Releases are published from GitHub Actions with provenance (see "Releasing").
+
+To install from a clone of this repository (pins Node.js 24.21.0 in `mise.toml`):
+
+```bash
+pnpm install --frozen-lockfile
+pnpm build
+pnpm test:pack                              # builds artifacts/vde-open-<version>.tgz and verifies an install in a separate directory
+bun add -g ./artifacts/vde-open-0.1.1.tgz   # always start the path with ./ (otherwise it is read as a GitHub repository)
+```
 
 ## `vde-open` and `vo`
 
@@ -59,8 +65,11 @@ How agents should use it is described in [docs/agent-usage.md](docs/agent-usage.
 [`skills/vde-open/SKILL.md`](skills/vde-open/SKILL.md) is a skill that teaches an agent (Claude Code, Codex, and others that read `SKILL.md`) when and how to use `vo`. It is also included in the package. To use it, link or copy the directory into your agent's skill directory:
 
 ```bash
-ln -s "$PWD/skills/vde-open" ~/.claude/skills/vde-open   # Claude Code
-ln -s "$PWD/skills/vde-open" ~/.codex/skills/vde-open    # Codex
+# Installed with Bun: the skill is in the global package directory.
+ln -s ~/.bun/install/global/node_modules/vde-open/skills/vde-open ~/.claude/skills/vde-open   # Claude Code
+ln -s ~/.bun/install/global/node_modules/vde-open/skills/vde-open ~/.codex/skills/vde-open    # Codex
+# Installed with npm: use "$(npm root -g)/vde-open/skills/vde-open" instead.
+# From a clone of this repository: use "$PWD/skills/vde-open".
 ```
 
 ## Search scope

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { C as decodeStateFile, D as daemonEntryPath, E as resolveStateRoot, O as referencedBlobs, S as renameWithRetry, T as resolveRuntimeLocation, a as DAEMON_LOCK_NAME, b as proofMatches, c as readIpcKey, d as inspectOwner, f as readCurrentLock, g as encodeFrame, h as FrameDecoder, i as requirePrivateDirectoryIfExists, k as version, l as readPointer, m as systemProcessProbe, n as ensurePrivateDirectory, o as POINTER_FILE, p as releaseLock, r as inspectPrivateDirectory, s as START_LOCK_NAME, t as startDaemon, u as acquireLock, v as computeProof, w as currentPathEnvironment, x as removeWithRetry, y as createNonce } from "./main-lxBamyBU.js";
-import { A as successEnvelope, C as VdeError, D as ExitCode, E as isVdeError, O as envelopeSchema, T as isErrorCode, Y as LIMITS, k as errorEnvelope, w as exitCodeForError } from "./search-index-C0szMSlZ.js";
+import { C as decodeStateFile, D as daemonEntryPath, E as resolveStateRoot, O as referencedBlobs, S as renameWithRetry, T as resolveRuntimeLocation, a as DAEMON_LOCK_NAME, b as proofMatches, c as readIpcKey, d as inspectOwner, f as readCurrentLock, g as encodeFrame, h as FrameDecoder, i as requirePrivateDirectoryIfExists, k as version, l as readPointer, m as systemProcessProbe, n as ensurePrivateDirectory, o as POINTER_FILE, p as releaseLock, r as inspectPrivateDirectory, s as START_LOCK_NAME, t as startDaemon, u as acquireLock, v as computeProof, w as currentPathEnvironment, x as removeWithRetry, y as createNonce } from "./main-CLzVgxSL.js";
+import { A as successEnvelope, C as VdeError, D as ExitCode, E as isVdeError, O as envelopeSchema, T as isErrorCode, Y as LIMITS, k as errorEnvelope, w as exitCodeForError } from "./search-index-CNsfwB72.js";
 import fs, { fstatSync } from "node:fs";
 import { lstat, readFile, readdir, stat as stat$1, writeFile } from "node:fs/promises";
 import path, { join, resolve } from "node:path";

package/dist/daemon.js

@@ -1,5 +1,5 @@
-import { k as version, t as startDaemon, w as currentPathEnvironment } from "./main-lxBamyBU.js";
-import { E as isVdeError } from "./search-index-C0szMSlZ.js";
+import { k as version, t as startDaemon, w as currentPathEnvironment } from "./main-CLzVgxSL.js";
+import { E as isVdeError } from "./search-index-CNsfwB72.js";
 //#region src/daemon.ts
 function notifyParent(message) {
 	if (!process.send) return;

package/dist/{heap-Dev_gSQn.js → heap-C3qHm7SE.js}

@@ -1,12 +1,17 @@
 import { getHeapStatistics, setFlagsFromString } from "node:v8";
 import { runInNewContext } from "node:vm";
 //#region src/diagnostics/heap.ts
-function measureHeap(collectGarbage) {
-	if (collectGarbage) {
+let gc = null;
+function collectGarbage() {
+	if (gc === null) {
 		setFlagsFromString("--expose-gc");
-		runInNewContext("gc")();
+		gc = runInNewContext("gc");
 	}
+	gc();
+}
+function measureHeap(collect) {
+	if (collect) collectGarbage();
 	return getHeapStatistics().used_heap_size;
 }
 //#endregion
-export { measureHeap as t };
+export { measureHeap as n, collectGarbage as t };

package/dist/{main-lxBamyBU.js → main-CLzVgxSL.js}

@@ -1,7 +1,7 @@
 import { r as __toESM, t as __commonJSMin } from "./rolldown-runtime-DC62tzP2.js";
-import { $ as literal, A as successEnvelope, B as readParamsSchema, C as VdeError, D as ExitCode, E as isVdeError, F as htmlModeChangeParamsSchema, G as sha256Schema, H as reorderParamsSchema, I as htmlModeSchema, J as watchRuleSchema, K as sourceKindSchema, L as linkOpenParamsSchema, M as closeParamsSchema, N as documentFormatSchema, P as documentIdSchema, Q as boolean, R as listParamsSchema, S as validateAnswers, U as revisionSchema, V as renderGrantParamsSchema, W as searchParamsSchema, X as _enum, Y as LIMITS, Z as array, _ as feedbackWaitParamsSchema, a as uniqueTokens, at as canonicalJson, b as submissionSchema, c as feedbackAckParamsSchema, d as feedbackDraftParamsSchema, et as number, f as feedbackForgetParamsSchema, g as feedbackSubmitParamsSchema, h as feedbackStatusSchema, i as codePointLength, it as ZodError, j as assetRecordSchema, k as errorEnvelope, l as feedbackCancelParamsSchema, m as feedbackListParamsSchema, n as batchesOf, nt as strictObject, o as answersSchema, p as feedbackIdParamsSchema, q as sourceStateSchema, r as partsOf, rt as string, s as cancellationSchema, tt as record, u as feedbackCreateParamsSchema, v as questionnaireSchema, w as exitCodeForError, x as utf8Length, y as requestIdSchema, z as openParamsSchema } from "./search-index-C0szMSlZ.js";
+import { $ as literal, A as successEnvelope, B as readParamsSchema, C as VdeError, D as ExitCode, E as isVdeError, F as htmlModeChangeParamsSchema, G as sha256Schema, H as reorderParamsSchema, I as htmlModeSchema, J as watchRuleSchema, K as sourceKindSchema, L as linkOpenParamsSchema, M as closeParamsSchema, N as documentFormatSchema, P as documentIdSchema, Q as boolean, R as listParamsSchema, S as validateAnswers, U as revisionSchema, V as renderGrantParamsSchema, W as searchParamsSchema, X as _enum, Y as LIMITS, Z as array, _ as feedbackWaitParamsSchema, a as uniqueTokens, at as canonicalJson, b as submissionSchema, c as feedbackAckParamsSchema, d as feedbackDraftParamsSchema, et as number, f as feedbackForgetParamsSchema, g as feedbackSubmitParamsSchema, h as feedbackStatusSchema, i as codePointLength, it as ZodError, j as assetRecordSchema, k as errorEnvelope, l as feedbackCancelParamsSchema, m as feedbackListParamsSchema, n as batchesOf, nt as strictObject, o as answersSchema, p as feedbackIdParamsSchema, q as sourceStateSchema, r as partsOf, rt as string, s as cancellationSchema, tt as record, u as feedbackCreateParamsSchema, v as questionnaireSchema, w as exitCodeForError, x as utf8Length, y as requestIdSchema, z as openParamsSchema } from "./search-index-CNsfwB72.js";
 import { a as analyzeDocument, c as classifyReference, d as hasHiddenSegment, f as isValidLogicalPath, i as ParseLimitError, l as dirnameOfLogicalPath, n as scanReferences, o as assetTypeOf, p as roleAllowed, r as extractTitle, s as classifyLink, u as encodeLogicalPath } from "./render-yCayIbhf.js";
-import { t as measureHeap } from "./heap-Dev_gSQn.js";
+import { n as measureHeap, t as collectGarbage } from "./heap-C3qHm7SE.js";
 import { constants, existsSync, stat, unwatchFile, watch, watchFile } from "node:fs";
 import { appendFile, chmod, link, lstat, mkdir, open, readFile, readdir, realpath, rename, rm, rmdir, stat as stat$1, writeFile } from "node:fs/promises";
 import * as sp from "node:path";
@@ -17,6 +17,8 @@ import { fileURLToPath } from "url";
 import { createRequire } from "module";
 import { fileURLToPath as fileURLToPath$1 } from "node:url";
 import { Worker } from "node:worker_threads";
+import { performance } from "node:perf_hooks";
+import { getHeapStatistics } from "node:v8";
 import { STATUS_CODES, ServerResponse, createServer } from "node:http";
 import { Http2ServerRequest, constants as constants$1 } from "node:http2";
 import { Readable } from "node:stream";
@@ -152,7 +154,7 @@ function parseStrictJson(text) {
 }
 //#endregion
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.1";
 //#endregion
 //#region src/documents/cursor.ts
 function invalidCursor(reason) {
@@ -6063,6 +6065,108 @@ function createRenderService(options) {
 	};
 }
 //#endregion
+//#region src/diagnostics/idle-collect.ts
+const COLLECT_AFTER_IDLE_MS = 2e3;
+function createIdleTrigger(run, delayMs = COLLECT_AFTER_IDLE_MS) {
+	let timer = null;
+	const cancel = () => {
+		if (timer) clearTimeout(timer);
+		timer = null;
+	};
+	return {
+		touch() {
+			cancel();
+			timer = setTimeout(() => {
+				timer = null;
+				run();
+			}, delayMs);
+			timer.unref();
+		},
+		cancel
+	};
+}
+function createWorkerCollect(options) {
+	let collecting = null;
+	let closed = false;
+	const held = [];
+	const release = () => {
+		if (collecting) clearTimeout(collecting.timer);
+		collecting = null;
+		for (const request of held.splice(0)) request.send();
+	};
+	const idle = createIdleTrigger(() => {
+		const worker = options.worker();
+		if (closed || worker === null || collecting) return;
+		if (options.busy()) {
+			idle.touch();
+			return;
+		}
+		const id = options.nextId();
+		const timer = setTimeout(release, options.waitLimitMs ?? 1e4);
+		timer.unref();
+		collecting = {
+			id,
+			timer
+		};
+		worker.postMessage({
+			id,
+			op: "collect"
+		});
+	}, options.delayMs);
+	return {
+		dispatch(send, reject) {
+			if (collecting) held.push({
+				send,
+				reject
+			});
+			else send();
+		},
+		touch: () => idle.touch(),
+		settle(id) {
+			if (collecting?.id !== id) return false;
+			release();
+			return true;
+		},
+		reset: () => {
+			if (collecting) release();
+		},
+		close(error) {
+			closed = true;
+			idle.cancel();
+			if (collecting) clearTimeout(collecting.timer);
+			collecting = null;
+			for (const request of held.splice(0)) request.reject(error);
+		}
+	};
+}
+function utilizationSincePreviousCall() {
+	let previous = performance.eventLoopUtilization();
+	return () => {
+		const current = performance.eventLoopUtilization();
+		const { utilization } = performance.eventLoopUtilization(current, previous);
+		previous = current;
+		return utilization;
+	};
+}
+function startHeapWatch(options = {}) {
+	const growthBytes = options.growthBytes ?? 8388608;
+	const idleUtilization = options.idleUtilization ?? .05;
+	const heapUsed = options.heapUsed ?? (() => getHeapStatistics().used_heap_size);
+	const utilization = options.utilization ?? utilizationSincePreviousCall();
+	const collect = options.collect ?? collectGarbage;
+	let baseline = heapUsed();
+	const timer = setInterval(() => {
+		const busy = utilization() >= idleUtilization;
+		const used = heapUsed();
+		baseline = Math.min(baseline, used);
+		if (busy || used - baseline < growthBytes) return;
+		collect();
+		baseline = heapUsed();
+	}, options.intervalMs ?? 2e3);
+	timer.unref();
+	return { stop: () => clearInterval(timer) };
+}
+//#endregion
 //#region src/diagnostics/until-aborted.ts
 function untilAborted(promise, signal) {
 	if (!signal) return promise;
@@ -6148,6 +6252,15 @@ function createSearchService(options) {
 	let closed = false;
 	let indexedAt = now().toISOString();
 	let syncing = null;
+	const collector = createWorkerCollect({
+		worker: () => worker,
+		busy: () => pending.size > 0,
+		nextId: () => {
+			const id = nextId;
+			nextId += 1;
+			return id;
+		}
+	});
 	let syncRequested = false;
 	const failAll = (error) => {
 		for (const waiter of pending.values()) {
@@ -6168,6 +6281,7 @@ function createSearchService(options) {
 		const created = new Worker(workerPath);
 		created.unref();
 		created.on("message", (reply) => {
+			if (collector.settle(reply.id)) return;
 			const waiter = pending.get(reply.id);
 			if (!waiter) return;
 			pending.delete(reply.id);
@@ -6178,31 +6292,36 @@ function createSearchService(options) {
 		created.on("error", () => {
 			if (worker === created) discardWorker();
 			failAll(new VdeError("E_INDEX_NOT_READY", "The search index is not available."));
+			collector.reset();
 		});
 		worker = created;
 		return created;
 	};
 	const request = (work) => {
 		if (closed) return Promise.reject(new VdeError("E_DAEMON_STOPPING", "The daemon is stopping."));
-		return new Promise((resolve, reject) => {
-			const id = nextId;
-			nextId += 1;
-			const timer = setTimeout(() => {
-				pending.delete(id);
-				discardWorker();
-				failAll(new VdeError("E_INDEX_NOT_READY", "The search index is not available."));
-				reject(new VdeError("E_INDEX_NOT_READY", "The search index operation did not finish in time.", { reason: "timeout" }));
-			}, timeoutMs);
-			pending.set(id, {
-				resolve,
-				reject,
-				timer
-			});
-			ensureWorker().postMessage({
-				id,
-				...work
-			});
+		const result = new Promise((resolve, reject) => {
+			collector.dispatch(() => {
+				const id = nextId;
+				nextId += 1;
+				const timer = setTimeout(() => {
+					pending.delete(id);
+					discardWorker();
+					failAll(new VdeError("E_INDEX_NOT_READY", "The search index is not available."));
+					reject(new VdeError("E_INDEX_NOT_READY", "The search index operation did not finish in time.", { reason: "timeout" }));
+				}, timeoutMs);
+				pending.set(id, {
+					resolve,
+					reject,
+					timer
+				});
+				ensureWorker().postMessage({
+					id,
+					...work
+				});
+			}, reject);
 		});
+		if (work.op !== "diagnostics") result.then(collector.touch, collector.touch);
+		return result;
 	};
 	const analyzeOnce = async (format, text) => {
 		try {
@@ -6513,6 +6632,7 @@ function createSearchService(options) {
 		},
 		async close() {
 			closed = true;
+			collector.close(new VdeError("E_DAEMON_STOPPING", "The daemon is stopping."));
 			failAll(new VdeError("E_DAEMON_STOPPING", "The daemon is stopping."));
 			const current = worker;
 			worker = null;
@@ -12505,6 +12625,15 @@ function createParseService(options = {}) {
 	let nextId = 1;
 	let closed = false;
 	const pending = /* @__PURE__ */ new Map();
+	const collector = createWorkerCollect({
+		worker: () => worker,
+		busy: () => pending.size > 0,
+		nextId: () => {
+			const id = nextId;
+			nextId += 1;
+			return id;
+		}
+	});
 	const failAll = (error) => {
 		for (const waiter of pending.values()) {
 			clearTimeout(waiter.timer);
@@ -12522,6 +12651,7 @@ function createParseService(options = {}) {
 		const created = new Worker(workerPath);
 		created.unref();
 		created.on("message", (reply) => {
+			if (collector.settle(reply.id)) return;
 			const waiter = pending.get(reply.id);
 			if (!waiter) return;
 			pending.delete(reply.id);
@@ -12532,32 +12662,37 @@ function createParseService(options = {}) {
 		created.on("error", () => {
 			if (worker === created) worker = null;
 			failAll(new VdeError("E_PARSE_FAILED", "The document could not be parsed.", { reason: "worker" }));
+			collector.reset();
 		});
 		worker = created;
 		return created;
 	};
 	const request = (work) => {
 		if (closed) return Promise.reject(new VdeError("E_DAEMON_STOPPING", "The daemon is stopping."));
-		return new Promise((resolve, reject) => {
-			const id = nextId;
-			nextId += 1;
-			const timer = setTimeout(() => {
-				discardWorker();
-				failAll(new VdeError("E_PARSE_FAILED", "Parsing the document did not finish in time.", {
-					reason: "timeout",
-					timeoutMs
-				}));
-			}, timeoutMs);
-			pending.set(id, {
-				resolve,
-				reject,
-				timer
-			});
-			ensureWorker().postMessage({
-				id,
-				...work
-			});
+		const result = new Promise((resolve, reject) => {
+			collector.dispatch(() => {
+				const id = nextId;
+				nextId += 1;
+				const timer = setTimeout(() => {
+					discardWorker();
+					failAll(new VdeError("E_PARSE_FAILED", "Parsing the document did not finish in time.", {
+						reason: "timeout",
+						timeoutMs
+					}));
+				}, timeoutMs);
+				pending.set(id, {
+					resolve,
+					reject,
+					timer
+				});
+				ensureWorker().postMessage({
+					id,
+					...work
+				});
+			}, reject);
 		});
+		if (work.op !== "diagnostics") result.then(collector.touch, collector.touch);
+		return result;
 	};
 	return {
 		diagnostics: (collectGarbage, signal) => worker === null ? Promise.resolve(null) : untilAborted(request({
@@ -12580,6 +12715,7 @@ function createParseService(options = {}) {
 		}),
 		async close() {
 			closed = true;
+			collector.close(new VdeError("E_DAEMON_STOPPING", "The daemon is stopping."));
 			failAll(new VdeError("E_DAEMON_STOPPING", "The daemon is stopping."));
 			const current = worker;
 			worker = null;
@@ -12944,6 +13080,7 @@ async function startDaemon(options) {
 	let feedback = null;
 	let announceStopping = () => void 0;
 	let lockTimer = null;
+	let heapWatch = null;
 	let stopping = null;
 	const stopRequested = new AbortController();
 	const owned = {
@@ -12977,6 +13114,7 @@ async function startDaemon(options) {
 		};
 		stopRequested.abort();
 		if (lockTimer) clearInterval(lockTimer);
+		heapWatch?.stop();
 		await step("watcher", () => watcher?.close(), SHUTDOWN_CLOSE_TIMEOUT_MS);
 		await step("feedback", () => feedback?.close());
 		await step("drain", () => ipc?.drain());
@@ -13238,6 +13376,7 @@ async function startDaemon(options) {
 		};
 		lockTimer = setInterval(() => void checkLock(), LOCK_CHECK_INTERVAL_MS);
 		lockTimer.unref();
+		heapWatch = startHeapWatch();
 		logger.log("daemon.started", { openDocuments: openedStore.payload.openOrder.length });
 	} catch (error) {
 		logger.log("daemon.start-failed", { code: error instanceof VdeError ? error.code : "E_INTERNAL" });

package/dist/{search-index-C0szMSlZ.js → search-index-CNsfwB72.js}

@@ -8454,6 +8454,10 @@ function excerptOf(text, normalized, needles) {
 	return sliceCodePoints(text.slice(start, start + LIMITS.searchExcerptCodePoints * 2 + EXCERPT_LEAD), 0, LIMITS.searchExcerptCodePoints).replace(/\s+/g, " ").trim();
 }
 const sectionKeyOf = (entry) => `${entry.documentId}\n${String(entry.sectionIndex)}`;
+function matchedInBody(match) {
+	for (const term in match) if (match[term]?.includes("body") === true) return true;
+	return false;
+}
 function emptyMatch(stored, sectionIndex) {
 	return {
 		stored,
@@ -8658,11 +8662,24 @@ var SearchIndex = class {
 			}
 		};
 		if (input.mode === "text" && terms.length > 0) {
+			const restricted = input.documents !== null || this.#staging.size > 0;
 			const run = (kind, options) => {
+				const decided = /* @__PURE__ */ new Map();
+				for (const candidate of candidates.values()) {
+					const sections = decided.get(candidate.stored) ?? /* @__PURE__ */ new Set();
+					sections.add(candidate.entry.sectionIndex);
+					decided.set(candidate.stored, sections);
+				}
+				const boostDocument = restricted || decided.size > 0 ? (id) => {
+					const found = this.#entries.get(id);
+					if (!found || !usable(found.stored)) return 0;
+					return decided.get(found.stored)?.has(found.entry.sectionIndex) === true ? 0 : 1;
+				} : void 0;
 				let matched = null;
 				for (const term of terms) {
 					const results = this.#mini.search(term, {
 						boost: BOOST,
+						...boostDocument ? { boostDocument } : {},
 						prefix: options.prefix ? (candidate) => candidate.length >= PREFIX_MIN_LENGTH : false,
 						fuzzy: options.fuzzy ? (candidate) => allowsFuzzy(candidate) ? FUZZY_DISTANCE : false : false,
 						tokenize: (text) => [text],
@@ -8674,14 +8691,13 @@ var SearchIndex = class {
 						if (!found || !usable(found.stored)) continue;
 						const { stored, entry } = found;
 						const key = sectionKeyOf(entry);
-						const fields = new Set(Object.values(result.match).flat());
 						const current = satisfied.get(key) ?? emptyMatch(stored, entry.sectionIndex);
 						current.score = Math.max(current.score, result.score);
 						if (result.score > current.entryScore) {
 							current.entry = entry;
 							current.entryScore = result.score;
 						}
-						if (fields.has("body") && result.score > current.bodyScore) {
+						if (result.score > current.bodyScore && matchedInBody(result.match)) {
 							current.bodyEntry = entry;
 							current.bodyScore = result.score;
 						}
@@ -8723,7 +8739,7 @@ var SearchIndex = class {
 							value.bodyScore = found.bodyScore;
 						}
 					}
-					if (matched.size === 0) return;
+					if (matched.size === 0 && decided.size === 0) return;
 				}
 				for (const [key, value] of matched ?? []) {
 					if (candidates.has(key)) continue;
@@ -8775,7 +8791,16 @@ var SearchIndex = class {
 			const shape = stored.sections.get(entry.sectionIndex);
 			if (!shape) continue;
 			perDocument.set(meta.documentId, count + 1);
-			const body = entry.body !== "" ? entry.body : entry.heading || shape.title || meta.title;
+			let body = entry.body;
+			let normalized = entry.normalizedBody;
+			if (body === "") {
+				body = entry.heading;
+				normalized = entry.normalizedHeading;
+			}
+			if (body === "") {
+				body = shape.title || meta.title;
+				normalized = normalizeForSearch(body);
+			}
 			hits.push({
 				documentId: meta.documentId,
 				revision: meta.revision,
@@ -8783,7 +8808,7 @@ var SearchIndex = class {
 				displayPath: meta.displayPath,
 				sectionId: shape.sectionId,
 				headingPath: this.#headingPathOf(stored, entry.sectionIndex),
-				excerpt: excerptOf(body, normalizeForSearch(body), [query, ...terms]),
+				excerpt: excerptOf(body, normalized, [query, ...terms]),
 				matchKind: kind,
 				score: Math.round(score * 1e3) / 1e3,
 				sourceRange: null,

package/dist/workers/parse-worker.js

@@ -1,5 +1,5 @@
 import { a as analyzeDocument, i as ParseLimitError, n as scanReferences, t as renderDocument } from "../render-yCayIbhf.js";
-import { t as measureHeap } from "../heap-Dev_gSQn.js";
+import { n as measureHeap, t as collectGarbage } from "../heap-C3qHm7SE.js";
 import { parentPort } from "node:worker_threads";
 //#region src/workers/parse-worker.ts
 function run(request) {
@@ -7,6 +7,10 @@ function run(request) {
 		heapUsedBytes: measureHeap(request.collectGarbage),
 		retained: {}
 	};
+	if (request.op === "collect") {
+		collectGarbage();
+		return null;
+	}
 	if (request.op === "analyze") return analyzeDocument(request.text, request.format);
 	if (request.op === "scan") return scanReferences(request.kind, request.text);
 	return renderDocument(request.input);

package/dist/workers/search-worker.js

@@ -1,18 +1,21 @@
-import { t as SearchIndex } from "../search-index-C0szMSlZ.js";
-import { t as measureHeap } from "../heap-Dev_gSQn.js";
+import { t as SearchIndex } from "../search-index-CNsfwB72.js";
+import { n as measureHeap, t as collectGarbage } from "../heap-C3qHm7SE.js";
 import { parentPort } from "node:worker_threads";
 //#region src/workers/search-worker.ts
 const index = new SearchIndex();
-async function diagnostics(collectGarbage) {
-	const retained = await index.retainedCounts(collectGarbage);
+async function diagnostics(collect) {
+	const retained = await index.retainedCounts(collect);
 	return {
-		heapUsedBytes: measureHeap(collectGarbage),
+		heapUsedBytes: measureHeap(collect),
 		retained
 	};
 }
 function run(request) {
 	switch (request.op) {
 		case "diagnostics": return diagnostics(request.collectGarbage);
+		case "collect":
+			collectGarbage();
+			return null;
 		case "begin":
 			index.begin(request.meta);
 			return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vde-open",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A local document viewer shared by agents and people: open Markdown and HTML documents, search and read them from the CLI, and ask the person questions.",
   "keywords": [
     "agent",

package/skills/vde-open/SKILL.md

@@ -10,7 +10,7 @@ vde-open is a local document viewer shared by a person and agents. The person re
 ## Before you start
 
 - Check that the CLI exists: `command -v vo || command -v vde-open`. Both names are the same CLI; if `vo` belongs to another tool on this machine, use `vde-open`.
-- If neither exists, do not install it on your own. Tell the user it is not installed and point them to the install steps (Node.js 24 or later; from a clone of the repository: `pnpm install --frozen-lockfile && pnpm build && pnpm test:pack && bun add -g ./artifacts/vde-open-0.1.0.tgz`).
+- If neither exists, do not install it on your own. Tell the user it is not installed and point them to the install steps (Node.js 24 or later; `bun add -g vde-open` or `npm install -g vde-open`).
 - The daemon starts automatically on the first command. You do not need to start it.
 
 ## Rules