@appsoftwareltd/etherpk-mcp 0.4.1 → 0.4.3

package/dist/main.js

@@ -25,7 +25,7 @@ import { parse, stringify } from "yaml";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 var package_default = {
 	name: "@appsoftwareltd/etherpk-mcp",
-	version: "0.4.1",
+	version: "0.4.3",
 	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",
@@ -3445,13 +3445,16 @@ async function loadLocalCache(dir, graphId) {
 		return 0;
 	}
 }
+/** A `.tmp` younger than this may be a snapshot another process is still writing. */
+var ABANDONED_TMP_AFTER_MS = 10 * 6e4;
 /**
 * Remove what an older build or a killed write left in a graph's directory: index and vectors
 * files stamped with another version (a bump renames them, so they are never opened again and
 * were 52 MB of litter per graph), and `.tmp` files from an atomic write that never reached its
-* rename. The files this build reads are left alone.
+* rename - only once they are old enough that no live `serve` can be writing them. The files
+* this build reads are left alone.
 */
-async function removeStaleFiles(dir) {
+async function removeStaleFiles(dir, now = Date.now()) {
 	const keep = new Set([
 		cacheFile(dir),
 		indexFile(dir),
@@ -3460,8 +3463,11 @@ async function removeStaleFiles(dir) {
 	const removed = [];
 	for (const name of await readdir(dir).catch(() => [])) {
 		const stale = /^(index|vectors)\.v\d+\.sqlite$/.test(name) && !keep.has(name);
-		const abandoned = /\.\d+\.tmp$/.test(name);
-		if (!stale && !abandoned) continue;
+		const temp = /\.\d+\.tmp$/.test(name);
+		if (!stale && !temp) continue;
+		if (temp) {
+			if (now - ((await stat(join(dir, name)).catch(() => null))?.mtimeMs ?? now) < ABANDONED_TMP_AFTER_MS) continue;
+		}
 		await rm(join(dir, name), { force: true });
 		removed.push(name);
 	}
@@ -3469,7 +3475,8 @@ async function removeStaleFiles(dir) {
 }
 /** Hosts opened in this process, so each gets its own paths in sqlite-wasm's filesystem. */
 var hostSerial = 0;
-function nodeIndexHost(dir) {
+function nodeIndexHost(dir, options = {}) {
+	const tidy = options.tidy ?? true;
 	let sqlite3;
 	let live;
 	const path = indexFile(dir);
@@ -3502,7 +3509,7 @@ function nodeIndexHost(dir) {
 			}
 		} catch (error) {
 			console.error(`etherpk-mcp: ignoring an unreadable vectors file ${vectorsPath}: ${error instanceof Error ? error.message : String(error)}`);
-			await rm(vectorsPath, { force: true });
+			if (tidy) await rm(vectorsPath, { force: true });
 			s.capi.sqlite3_js_posix_create_file(vectorsVfsName, new Uint8Array(0));
 		}
 	}
@@ -3529,7 +3536,7 @@ function nodeIndexHost(dir) {
 			const db = wrapOo1Db(oo1);
 			if (!isUsableIndex(db)) {
 				db.close();
-				await rm(path, { force: true });
+				if (tidy) await rm(path, { force: true });
 				return null;
 			}
 			attachVectors(db);
@@ -3539,14 +3546,14 @@ function nodeIndexHost(dir) {
 			};
 		} catch (error) {
 			console.error(`etherpk-mcp: ignoring an unreadable index file ${path}: ${error instanceof Error ? error.message : String(error)}`);
-			await rm(path, { force: true });
+			if (tidy) await rm(path, { force: true });
 			return null;
 		}
 	}
 	return {
 		async open() {
 			const s = await init();
-			await removeStaleFiles(dir);
+			if (tidy) await removeStaleFiles(dir);
 			await importVectors(s);
 			live = await openSaved(s) ?? openFresh(s);
 			return {
@@ -3593,7 +3600,7 @@ async function listGraphStores(env, model) {
 		for (const graphId of await readdir(hostDir).catch(() => [])) {
 			const dir = join(hostDir, graphId);
 			if (!await exists$1(indexFile(dir))) continue;
-			const opened = await nodeIndexHost(dir).open(graphId);
+			const opened = await nodeIndexHost(dir, { tidy: false }).open(graphId);
 			try {
 				prepareEmbeddingStore(opened.db);
 				const status = semanticStatus(opened.db, model);
@@ -3612,6 +3619,22 @@ async function listGraphStores(env, model) {
 	}
 	return stores;
 }
+/**
+* A store's state as one line a person can act on: a word first, then the counts, then how
+* fresh they are. A building `serve` refreshes the snapshot every 30 seconds, so a snapshot
+* under a minute and a half old means "building now" and an older one means nothing is - the
+* distinction the raw count and timestamp left the reader to infer (2026-09-17).
+*/
+function describeGraphStore(store, now = Date.now()) {
+	const { embedded, total } = store.status;
+	const ageMs = Math.max(0, now - store.updatedAt.getTime());
+	const age = ageMs < 9e4 ? `${Math.round(ageMs / 1e3)} s ago` : ageMs < 36e5 ? `${Math.round(ageMs / 6e4)} min ago` : `${Math.round(ageMs / 36e5)} h ago`;
+	const count = `${embedded.toLocaleString("en-GB")} of ${total.toLocaleString("en-GB")} passages`;
+	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`;
+}
 /** Remove every persisted graph under the cache root (logout of the last server). */
 async function removeCacheRoot(env) {
 	await rm(cacheRoot(env), {
@@ -5617,6 +5640,10 @@ function createGraphSync(deps) {
 				for (const waiter of connectionWaiters) waiter.resolve();
 				connectionWaiters.clear();
 				subscribeRetained();
+				if (deps.subscribeAll) sendNow({
+					type: "subscribe",
+					all: true
+				});
 				for (const data of outboundSnapshots.splice(0)) s.send(data);
 				for (const docId of retained.keys()) {
 					if (docId === deps.rootDocId) continue;
@@ -8996,6 +9023,7 @@ async function openHeadlessGraph(deps) {
 		token: deps.token,
 		cache,
 		connect: deps.connect ?? nodeTransport,
+		subscribeAll: true,
 		collectRowWhen: (doc) => documentProtection(doc.getText("content").toString()).kind === "document",
 		presence: {
 			name: deps.presenceName,
@@ -9841,11 +9869,8 @@ async function semanticCommand(what) {
 			const stores = await listGraphStores(process.env, MODEL.id);
 			if (stores.length === 0) return;
 			console.log("");
-			console.log("Cached graphs, as of the last snapshot each serve wrote (a running build refreshes it every 30 seconds):");
-			for (const store of stores) {
-				const done = store.status.embedded >= store.status.total;
-				console.log(`  ${store.host}  ${store.graphId}  ${store.status.embedded} of ${store.status.total} passages embedded${done ? " - up to date" : ""}  (${store.updatedAt.toISOString()})`);
-			}
+			console.log("Cached graphs:");
+			for (const store of stores) console.log(`  ${store.host}  ${store.graphId}\n    ${describeGraphStore(store)}`);
 			return;
 		}
 		case "remove":