@remnic/core 9.45.2 → 9.45.4

package/dist/external-wiki-collection.js

@@ -0,0 +1,387 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/external-wiki-collection.ts
+import { createHash } from "crypto";
+import { createReadStream } from "fs";
+import { readdir, realpath } from "fs/promises";
+import path from "path";
+var COLLECTION_PREFIX = "external-wiki-";
+function externalWikiCollectionName(wikiId) {
+  const slug = wikiId.normalize("NFKD").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  if (!slug) {
+    throw new Error("External wiki id must contain usable characters for a collection name");
+  }
+  return `${COLLECTION_PREFIX}${slug}`;
+}
+function supportsExternalWikiCollections(backend) {
+  return backend.supportsAdditionalCollections?.() === true && typeof backend.excludeCollectionFromGlobalSearch === "function" && typeof backend.deleteCollection === "function" && typeof backend.collectionRoot === "function";
+}
+var ExternalWikiCollectionManager = class {
+  constructor(backend, defaultCollection, now = () => /* @__PURE__ */ new Date()) {
+    this.backend = backend;
+    this.defaultCollection = defaultCollection;
+    this.now = now;
+  }
+  backend;
+  defaultCollection;
+  now;
+  managedByWikiId = /* @__PURE__ */ new Map();
+  operationTail = Promise.resolve();
+  statuses() {
+    return [...this.managedByWikiId.values()].map(({ status }) => ({ ...status }));
+  }
+  refresh(roots, execution) {
+    const snapshot = roots.map((root) => ({ ...root }));
+    return this.enqueueOperation(() => this.refreshSerial(snapshot, execution));
+  }
+  async refreshSerial(roots, execution) {
+    const configuredWikiIds = new Set(roots.map((root) => root.id));
+    for (const [wikiId, managed] of this.managedByWikiId) {
+      if (!configuredWikiIds.has(wikiId)) {
+        if (!managed.managed) {
+          this.managedByWikiId.delete(wikiId);
+          continue;
+        }
+        try {
+          await this.removeManagedCollection(wikiId, managed, execution);
+          this.managedByWikiId.delete(wikiId);
+        } catch (error) {
+          this.rememberError(
+            wikiId,
+            managed.status.collection,
+            safeBackendError("External wiki collection removal failed", error)
+          );
+        }
+      }
+    }
+    const collectionOwnerByName = /* @__PURE__ */ new Map();
+    const collidingWikiIds = /* @__PURE__ */ new Set();
+    for (const root of roots) {
+      if (root.enabled === false || root.indexInQmd !== true) continue;
+      try {
+        const collection = externalWikiCollectionName(root.id);
+        const owner = collectionOwnerByName.get(collection);
+        if (owner) {
+          collidingWikiIds.add(owner);
+          collidingWikiIds.add(root.id);
+        } else {
+          collectionOwnerByName.set(collection, root.id);
+        }
+      } catch {
+        continue;
+      }
+    }
+    const statuses = [];
+    for (const root of roots) {
+      if (collidingWikiIds.has(root.id)) {
+        statuses.push(
+          this.rememberError(
+            root.id,
+            externalWikiCollectionName(root.id),
+            "External wiki ids must not resolve to the same dedicated collection"
+          )
+        );
+        continue;
+      }
+      statuses.push(await this.refreshRoot(root, execution));
+    }
+    return statuses;
+  }
+  async search(wikiId, query, limit, execution) {
+    const managed = this.managedByWikiId.get(wikiId);
+    if (!managed || managed.status.state !== "healthy" || !managed.pagesDir) return null;
+    let degradationCode = null;
+    try {
+      const results = await this.backend.hybridSearch(query, managed.status.collection, limit, {
+        ...execution,
+        onDegradation: (detail) => {
+          degradationCode = detail.code;
+          execution?.onDegradation?.(detail);
+        }
+      });
+      if (degradationCode) {
+        managed.status = {
+          ...managed.status,
+          state: "error",
+          lastError: `External wiki collection search degraded (${degradationCode})`
+        };
+        return null;
+      }
+      return results.filter((result) => isPageResult(result.path, managed.pagesDir, managed.status.collection));
+    } catch (error) {
+      managed.status = {
+        ...managed.status,
+        state: "error",
+        lastError: safeBackendError("External wiki collection search failed", error)
+      };
+      return null;
+    }
+  }
+  purge(wikiId, execution) {
+    return this.enqueueOperation(async () => {
+      const collection = externalWikiCollectionName(wikiId);
+      this.assertDedicatedCollection(collection);
+      if (!this.backend.deleteCollection) return false;
+      const removed = await this.backend.deleteCollection(collection, execution);
+      this.managedByWikiId.delete(wikiId);
+      return removed;
+    });
+  }
+  enqueueOperation(operation) {
+    const running = this.operationTail.then(operation);
+    this.operationTail = running.then(
+      () => void 0,
+      () => void 0
+    );
+    return running;
+  }
+  async refreshRoot(root, execution) {
+    let collection;
+    try {
+      collection = externalWikiCollectionName(root.id);
+      this.assertDedicatedCollection(collection);
+    } catch (error) {
+      return this.rememberError(root.id, `${COLLECTION_PREFIX}invalid`, configError(error));
+    }
+    const prior = this.managedByWikiId.get(root.id);
+    if (root.enabled === false || root.indexInQmd !== true) {
+      if (prior?.managed) {
+        try {
+          await this.removeManagedCollection(root.id, prior, execution);
+        } catch (error) {
+          return this.rememberError(
+            root.id,
+            collection,
+            safeBackendError("External wiki collection removal failed", error)
+          );
+        }
+      }
+      return this.rememberDisabled(root.id, collection);
+    }
+    const dedicatedBackend = supportsExternalWikiCollections(this.backend) ? this.backend : null;
+    if (!dedicatedBackend) {
+      return this.rememberError(
+        root.id,
+        collection,
+        "Active search backend does not support dedicated external wiki collections"
+      );
+    }
+    let pagesDir;
+    let pages;
+    try {
+      pagesDir = await resolvePagesDir(root);
+      pages = await fingerprintMarkdownPages(pagesDir);
+    } catch (error) {
+      return this.rememberError(root.id, collection, configError(error));
+    }
+    if (prior?.managed && prior.status.state === "healthy" && prior.pagesDir === pagesDir && prior.fingerprint === pages.fingerprint) {
+      return { ...prior.status };
+    }
+    let rollbackCollection = false;
+    let managedAfterFailure = prior?.managed ?? false;
+    try {
+      let collectionState = await dedicatedBackend.ensureCollection(pagesDir, collection, execution);
+      if (collectionState !== "present") {
+        throw new Error(`Dedicated collection could not be prepared (${collectionState})`);
+      }
+      rollbackCollection = true;
+      managedAfterFailure = true;
+      let boundRoot = await dedicatedBackend.collectionRoot(collection, execution);
+      if (!boundRoot) {
+        throw new Error("Dedicated collection source root could not be verified");
+      }
+      if (await realpath(boundRoot) !== pagesDir) {
+        await dedicatedBackend.deleteCollection(collection, execution);
+        rollbackCollection = false;
+        managedAfterFailure = false;
+        collectionState = await dedicatedBackend.ensureCollection(pagesDir, collection, execution);
+        if (collectionState !== "present") {
+          throw new Error(`Dedicated collection could not be rebound (${collectionState})`);
+        }
+        rollbackCollection = true;
+        managedAfterFailure = true;
+        boundRoot = await dedicatedBackend.collectionRoot(collection, execution);
+        if (!boundRoot || await realpath(boundRoot) !== pagesDir) {
+          throw new Error("Dedicated collection source root did not match the configured pagesDir");
+        }
+      }
+      await dedicatedBackend.excludeCollectionFromGlobalSearch(collection, execution);
+      if (dedicatedBackend.updateCollectionFromDir) {
+        await dedicatedBackend.updateCollectionFromDir(collection, pagesDir, execution);
+      } else if (dedicatedBackend.updateCollectionStrict) {
+        await dedicatedBackend.updateCollectionStrict(collection, execution);
+      } else {
+        throw new Error("Active search backend cannot refresh a dedicated collection");
+      }
+      if (dedicatedBackend.embedCollectionStrict) {
+        await dedicatedBackend.embedCollectionStrict(collection);
+      } else {
+        await dedicatedBackend.embedCollection(collection);
+      }
+      const backendStatus = await dedicatedBackend.collectionStatus?.(collection);
+      const status = {
+        wikiId: root.id,
+        collection,
+        state: "healthy",
+        documentCount: backendStatus?.totalFiles ?? pages.documentCount,
+        lastIndexedAt: this.now().toISOString(),
+        lastError: null
+      };
+      this.managedByWikiId.set(root.id, {
+        status,
+        pagesDir,
+        fingerprint: pages.fingerprint,
+        managed: true
+      });
+      return { ...status };
+    } catch (error) {
+      let cleanupError;
+      if (rollbackCollection) {
+        try {
+          await dedicatedBackend.deleteCollection(collection, execution);
+          managedAfterFailure = false;
+        } catch (rollbackError) {
+          cleanupError = rollbackError;
+          managedAfterFailure = true;
+        }
+      }
+      const refreshError = safeBackendError("External wiki collection refresh failed", error);
+      const lastError = cleanupError ? `${refreshError}; ${safeBackendError("collection rollback failed", cleanupError)}` : refreshError;
+      const status = this.rememberError(root.id, collection, lastError);
+      const failed = this.managedByWikiId.get(root.id);
+      if (failed) {
+        this.managedByWikiId.set(root.id, {
+          ...failed,
+          pagesDir: managedAfterFailure ? prior?.pagesDir ?? pagesDir : null,
+          fingerprint: managedAfterFailure ? prior?.fingerprint ?? null : null,
+          managed: managedAfterFailure
+        });
+      }
+      return status;
+    }
+  }
+  assertDedicatedCollection(collection) {
+    if (collection === this.defaultCollection || !collection.startsWith(COLLECTION_PREFIX)) {
+      throw new Error("External wiki collection must not target the default memory collection");
+    }
+  }
+  rememberDisabled(wikiId, collection) {
+    const status = {
+      wikiId,
+      collection,
+      state: "disabled",
+      documentCount: null,
+      lastIndexedAt: null,
+      lastError: null
+    };
+    this.managedByWikiId.set(wikiId, { status, pagesDir: null, fingerprint: null, managed: false });
+    return { ...status };
+  }
+  rememberError(wikiId, collection, lastError) {
+    const prior = this.managedByWikiId.get(wikiId);
+    const status = {
+      wikiId,
+      collection,
+      state: "error",
+      documentCount: prior?.status.documentCount ?? null,
+      lastIndexedAt: prior?.status.lastIndexedAt ?? null,
+      lastError
+    };
+    this.managedByWikiId.set(wikiId, {
+      status,
+      pagesDir: prior?.pagesDir ?? null,
+      fingerprint: prior?.fingerprint ?? null,
+      managed: prior?.managed ?? false
+    });
+    return { ...status };
+  }
+  async removeManagedCollection(wikiId, managed, execution) {
+    if (!this.backend.deleteCollection) {
+      throw new Error("Active search backend cannot delete a dedicated collection; use a backend purge command");
+    }
+    await this.backend.deleteCollection(managed.status.collection, execution);
+    this.managedByWikiId.set(wikiId, {
+      status: managed.status,
+      pagesDir: null,
+      fingerprint: null,
+      managed: false
+    });
+  }
+};
+async function resolvePagesDir(root) {
+  const lexicalRootDir = path.resolve(root.rootDir);
+  const lexicalPagesDir = path.resolve(lexicalRootDir, root.pagesDir ?? "wiki");
+  const lexicalRelative = path.relative(lexicalRootDir, lexicalPagesDir);
+  if (!lexicalRelative || lexicalRelative.startsWith("..") || path.isAbsolute(lexicalRelative)) {
+    throw new Error("External wiki pagesDir must stay inside the configured rootDir");
+  }
+  const [rootDir, pagesDir] = await Promise.all([realpath(lexicalRootDir), realpath(lexicalPagesDir)]);
+  const canonicalRelative = path.relative(rootDir, pagesDir);
+  if (!canonicalRelative || canonicalRelative.startsWith("..") || path.isAbsolute(canonicalRelative)) {
+    throw new Error("External wiki pagesDir must stay inside the configured rootDir");
+  }
+  return pagesDir;
+}
+async function fingerprintMarkdownPages(pagesDir) {
+  const markdownPaths = [];
+  const pending = [pagesDir];
+  while (pending.length > 0) {
+    const directory = pending.pop();
+    const entries = await readdir(directory, { withFileTypes: true });
+    for (const entry of entries) {
+      const entryPath = path.join(directory, entry.name);
+      if (entry.isDirectory()) {
+        pending.push(entryPath);
+      } else if (entry.isSymbolicLink()) {
+        throw new Error("External wiki pagesDir must not contain symbolic links");
+      } else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+        markdownPaths.push(entryPath);
+      }
+    }
+  }
+  markdownPaths.sort();
+  const fingerprint = createHash("sha256");
+  for (const markdownPath of markdownPaths) {
+    fingerprint.update(path.relative(pagesDir, markdownPath));
+    fingerprint.update("\0");
+    for await (const chunk of createReadStream(markdownPath)) {
+      fingerprint.update(chunk);
+    }
+    fingerprint.update("\0");
+  }
+  return {
+    fingerprint: fingerprint.digest("hex"),
+    documentCount: markdownPaths.length
+  };
+}
+function isPageResult(resultPath, pagesDir, collection) {
+  let candidate = resultPath;
+  const qmdPrefix = `qmd://${collection}/`;
+  if (candidate.startsWith(qmdPrefix)) candidate = candidate.slice(qmdPrefix.length);
+  const resolved = path.isAbsolute(candidate) ? path.resolve(candidate) : path.resolve(pagesDir, candidate);
+  const relative = path.relative(pagesDir, resolved);
+  return Boolean(relative) && !relative.startsWith("..") && !path.isAbsolute(relative) && resolved.toLowerCase().endsWith(".md");
+}
+function configError(error) {
+  if (error instanceof Error && error.message.startsWith("External wiki")) {
+    return error.message;
+  }
+  const code = typeof error === "object" && error !== null && "code" in error ? String(error.code) : null;
+  return code ? `External wiki pages directory could not be scanned (${code})` : "Invalid external wiki collection configuration";
+}
+function safeBackendError(prefix, error) {
+  if (error instanceof Error && error.message.startsWith("Dedicated collection")) {
+    return error.message;
+  }
+  if (error instanceof Error && error.message.startsWith("Active search backend")) {
+    return error.message;
+  }
+  const name = error instanceof Error && error.name ? error.name : "Error";
+  return `${prefix} (${name})`;
+}
+export {
+  ExternalWikiCollectionManager,
+  externalWikiCollectionName,
+  supportsExternalWikiCollections
+};
+//# sourceMappingURL=external-wiki-collection.js.map

package/dist/external-wiki-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/external-wiki-collection.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { createReadStream } from \"node:fs\";\nimport { readdir, realpath } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { SearchBackend, SearchExecutionOptions, SearchResult } from \"./search/port.js\";\n\nconst COLLECTION_PREFIX = \"external-wiki-\";\n\nexport interface ExternalWikiCollectionRoot {\n  id: string;\n  rootDir: string;\n  enabled?: boolean;\n  pagesDir?: string;\n  indexInQmd?: boolean;\n}\n\nexport type ExternalWikiCollectionBackend = Pick<\n  SearchBackend,\n  | \"updateCollectionStrict\"\n  | \"updateCollectionFromDir\"\n  | \"embedCollection\"\n  | \"embedCollectionStrict\"\n  | \"hybridSearch\"\n  | \"collectionStatus\"\n> & {\n  ensureCollection(\n    rootDir: string,\n    collection: string,\n    execution?: SearchExecutionOptions\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n} & Required<\n  Pick<\n    SearchBackend,\n    | \"supportsAdditionalCollections\"\n    | \"excludeCollectionFromGlobalSearch\"\n    | \"deleteCollection\"\n    | \"collectionRoot\"\n  >\n>;\n\nexport type ExternalWikiCollectionState = \"disabled\" | \"healthy\" | \"error\";\n\nexport interface ExternalWikiCollectionStatus {\n  wikiId: string;\n  collection: string;\n  state: ExternalWikiCollectionState;\n  documentCount: number | null;\n  lastIndexedAt: string | null;\n  lastError: string | null;\n}\n\ninterface ManagedWikiCollection {\n  status: ExternalWikiCollectionStatus;\n  pagesDir: string | null;\n  fingerprint: string | null;\n  managed: boolean;\n}\n\ninterface PagesFingerprint {\n  fingerprint: string;\n  documentCount: number;\n}\n\nexport function externalWikiCollectionName(wikiId: string): string {\n  const slug = wikiId\n    .normalize(\"NFKD\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  if (!slug) {\n    throw new Error(\"External wiki id must contain usable characters for a collection name\");\n  }\n  return `${COLLECTION_PREFIX}${slug}`;\n}\n\nexport function supportsExternalWikiCollections(\n  backend: SearchBackend | ExternalWikiCollectionBackend\n): backend is ExternalWikiCollectionBackend {\n  return (\n    backend.supportsAdditionalCollections?.() === true &&\n    typeof backend.excludeCollectionFromGlobalSearch === \"function\" &&\n    typeof backend.deleteCollection === \"function\" &&\n    typeof backend.collectionRoot === \"function\"\n  );\n}\n\nexport class ExternalWikiCollectionManager {\n  private readonly managedByWikiId = new Map<string, ManagedWikiCollection>();\n  private operationTail: Promise<void> = Promise.resolve();\n\n  constructor(\n    private readonly backend: SearchBackend | ExternalWikiCollectionBackend,\n    private readonly defaultCollection: string,\n    private readonly now: () => Date = () => new Date()\n  ) {}\n\n  statuses(): ExternalWikiCollectionStatus[] {\n    return [...this.managedByWikiId.values()].map(({ status }) => ({ ...status }));\n  }\n\n  refresh(\n    roots: readonly ExternalWikiCollectionRoot[],\n    execution?: SearchExecutionOptions\n  ): Promise<ExternalWikiCollectionStatus[]> {\n    const snapshot = roots.map((root) => ({ ...root }));\n    return this.enqueueOperation(() => this.refreshSerial(snapshot, execution));\n  }\n\n  private async refreshSerial(\n    roots: readonly ExternalWikiCollectionRoot[],\n    execution?: SearchExecutionOptions\n  ): Promise<ExternalWikiCollectionStatus[]> {\n    const configuredWikiIds = new Set(roots.map((root) => root.id));\n    for (const [wikiId, managed] of this.managedByWikiId) {\n      if (!configuredWikiIds.has(wikiId)) {\n        if (!managed.managed) {\n          this.managedByWikiId.delete(wikiId);\n          continue;\n        }\n        try {\n          await this.removeManagedCollection(wikiId, managed, execution);\n          this.managedByWikiId.delete(wikiId);\n        } catch (error) {\n          this.rememberError(\n            wikiId,\n            managed.status.collection,\n            safeBackendError(\"External wiki collection removal failed\", error)\n          );\n        }\n      }\n    }\n\n    const collectionOwnerByName = new Map<string, string>();\n    const collidingWikiIds = new Set<string>();\n    for (const root of roots) {\n      if (root.enabled === false || root.indexInQmd !== true) continue;\n      try {\n        const collection = externalWikiCollectionName(root.id);\n        const owner = collectionOwnerByName.get(collection);\n        if (owner) {\n          collidingWikiIds.add(owner);\n          collidingWikiIds.add(root.id);\n        } else {\n          collectionOwnerByName.set(collection, root.id);\n        }\n      } catch {\n        continue;\n      }\n    }\n\n    const statuses: ExternalWikiCollectionStatus[] = [];\n    for (const root of roots) {\n      if (collidingWikiIds.has(root.id)) {\n        statuses.push(\n          this.rememberError(\n            root.id,\n            externalWikiCollectionName(root.id),\n            \"External wiki ids must not resolve to the same dedicated collection\"\n          )\n        );\n        continue;\n      }\n      statuses.push(await this.refreshRoot(root, execution));\n    }\n    return statuses;\n  }\n\n  async search(\n    wikiId: string,\n    query: string,\n    limit: number,\n    execution?: SearchExecutionOptions\n  ): Promise<SearchResult[] | null> {\n    const managed = this.managedByWikiId.get(wikiId);\n    if (!managed || managed.status.state !== \"healthy\" || !managed.pagesDir) return null;\n\n    let degradationCode: string | null = null;\n    try {\n      const results = await this.backend.hybridSearch(query, managed.status.collection, limit, {\n        ...execution,\n        onDegradation: (detail) => {\n          degradationCode = detail.code;\n          execution?.onDegradation?.(detail);\n        },\n      });\n      if (degradationCode) {\n        managed.status = {\n          ...managed.status,\n          state: \"error\",\n          lastError: `External wiki collection search degraded (${degradationCode})`,\n        };\n        return null;\n      }\n      return results.filter((result) => isPageResult(result.path, managed.pagesDir!, managed.status.collection));\n    } catch (error) {\n      managed.status = {\n        ...managed.status,\n        state: \"error\",\n        lastError: safeBackendError(\"External wiki collection search failed\", error),\n      };\n      return null;\n    }\n  }\n\n  purge(wikiId: string, execution?: SearchExecutionOptions): Promise<boolean> {\n    return this.enqueueOperation(async () => {\n      const collection = externalWikiCollectionName(wikiId);\n      this.assertDedicatedCollection(collection);\n      if (!this.backend.deleteCollection) return false;\n      const removed = await this.backend.deleteCollection(collection, execution);\n      this.managedByWikiId.delete(wikiId);\n      return removed;\n    });\n  }\n\n  private enqueueOperation<T>(operation: () => Promise<T>): Promise<T> {\n    const running = this.operationTail.then(operation);\n    this.operationTail = running.then(\n      () => undefined,\n      () => undefined\n    );\n    return running;\n  }\n\n  private async refreshRoot(\n    root: ExternalWikiCollectionRoot,\n    execution?: SearchExecutionOptions\n  ): Promise<ExternalWikiCollectionStatus> {\n    let collection: string;\n    try {\n      collection = externalWikiCollectionName(root.id);\n      this.assertDedicatedCollection(collection);\n    } catch (error) {\n      return this.rememberError(root.id, `${COLLECTION_PREFIX}invalid`, configError(error));\n    }\n\n    const prior = this.managedByWikiId.get(root.id);\n    if (root.enabled === false || root.indexInQmd !== true) {\n      if (prior?.managed) {\n        try {\n          await this.removeManagedCollection(root.id, prior, execution);\n        } catch (error) {\n          return this.rememberError(\n            root.id,\n            collection,\n            safeBackendError(\"External wiki collection removal failed\", error)\n          );\n        }\n      }\n      return this.rememberDisabled(root.id, collection);\n    }\n\n    const dedicatedBackend = supportsExternalWikiCollections(this.backend) ? this.backend : null;\n    if (!dedicatedBackend) {\n      return this.rememberError(\n        root.id,\n        collection,\n        \"Active search backend does not support dedicated external wiki collections\"\n      );\n    }\n\n    let pagesDir: string;\n    let pages: PagesFingerprint;\n    try {\n      pagesDir = await resolvePagesDir(root);\n      pages = await fingerprintMarkdownPages(pagesDir);\n    } catch (error) {\n      return this.rememberError(root.id, collection, configError(error));\n    }\n\n    if (\n      prior?.managed &&\n      prior.status.state === \"healthy\" &&\n      prior.pagesDir === pagesDir &&\n      prior.fingerprint === pages.fingerprint\n    ) {\n      return { ...prior.status };\n    }\n\n    let rollbackCollection = false;\n    let managedAfterFailure = prior?.managed ?? false;\n    try {\n      let collectionState = await dedicatedBackend.ensureCollection(pagesDir, collection, execution);\n      if (collectionState !== \"present\") {\n        throw new Error(`Dedicated collection could not be prepared (${collectionState})`);\n      }\n      rollbackCollection = true;\n      managedAfterFailure = true;\n      let boundRoot = await dedicatedBackend.collectionRoot(collection, execution);\n      if (!boundRoot) {\n        throw new Error(\"Dedicated collection source root could not be verified\");\n      }\n      if ((await realpath(boundRoot)) !== pagesDir) {\n        await dedicatedBackend.deleteCollection(collection, execution);\n        rollbackCollection = false;\n        managedAfterFailure = false;\n        collectionState = await dedicatedBackend.ensureCollection(pagesDir, collection, execution);\n        if (collectionState !== \"present\") {\n          throw new Error(`Dedicated collection could not be rebound (${collectionState})`);\n        }\n        rollbackCollection = true;\n        managedAfterFailure = true;\n        boundRoot = await dedicatedBackend.collectionRoot(collection, execution);\n        if (!boundRoot || (await realpath(boundRoot)) !== pagesDir) {\n          throw new Error(\"Dedicated collection source root did not match the configured pagesDir\");\n        }\n      }\n      await dedicatedBackend.excludeCollectionFromGlobalSearch(collection, execution);\n      if (dedicatedBackend.updateCollectionFromDir) {\n        await dedicatedBackend.updateCollectionFromDir(collection, pagesDir, execution);\n      } else if (dedicatedBackend.updateCollectionStrict) {\n        await dedicatedBackend.updateCollectionStrict(collection, execution);\n      } else {\n        throw new Error(\"Active search backend cannot refresh a dedicated collection\");\n      }\n      if (dedicatedBackend.embedCollectionStrict) {\n        await dedicatedBackend.embedCollectionStrict(collection);\n      } else {\n        await dedicatedBackend.embedCollection(collection);\n      }\n      const backendStatus = await dedicatedBackend.collectionStatus?.(collection);\n      const status: ExternalWikiCollectionStatus = {\n        wikiId: root.id,\n        collection,\n        state: \"healthy\",\n        documentCount: backendStatus?.totalFiles ?? pages.documentCount,\n        lastIndexedAt: this.now().toISOString(),\n        lastError: null,\n      };\n      this.managedByWikiId.set(root.id, {\n        status,\n        pagesDir,\n        fingerprint: pages.fingerprint,\n        managed: true,\n      });\n      return { ...status };\n    } catch (error) {\n      let cleanupError: unknown;\n      if (rollbackCollection) {\n        try {\n          await dedicatedBackend.deleteCollection(collection, execution);\n          managedAfterFailure = false;\n        } catch (rollbackError) {\n          cleanupError = rollbackError;\n          managedAfterFailure = true;\n        }\n      }\n      const refreshError = safeBackendError(\"External wiki collection refresh failed\", error);\n      const lastError = cleanupError\n        ? `${refreshError}; ${safeBackendError(\"collection rollback failed\", cleanupError)}`\n        : refreshError;\n      const status = this.rememberError(root.id, collection, lastError);\n      const failed = this.managedByWikiId.get(root.id);\n      if (failed) {\n        this.managedByWikiId.set(root.id, {\n          ...failed,\n          pagesDir: managedAfterFailure ? (prior?.pagesDir ?? pagesDir) : null,\n          fingerprint: managedAfterFailure ? prior?.fingerprint ?? null : null,\n          managed: managedAfterFailure,\n        });\n      }\n      return status;\n    }\n  }\n\n  private assertDedicatedCollection(collection: string): void {\n    if (collection === this.defaultCollection || !collection.startsWith(COLLECTION_PREFIX)) {\n      throw new Error(\"External wiki collection must not target the default memory collection\");\n    }\n  }\n\n  private rememberDisabled(wikiId: string, collection: string): ExternalWikiCollectionStatus {\n    const status: ExternalWikiCollectionStatus = {\n      wikiId,\n      collection,\n      state: \"disabled\",\n      documentCount: null,\n      lastIndexedAt: null,\n      lastError: null,\n    };\n    this.managedByWikiId.set(wikiId, { status, pagesDir: null, fingerprint: null, managed: false });\n    return { ...status };\n  }\n\n  private rememberError(wikiId: string, collection: string, lastError: string): ExternalWikiCollectionStatus {\n    const prior = this.managedByWikiId.get(wikiId);\n    const status: ExternalWikiCollectionStatus = {\n      wikiId,\n      collection,\n      state: \"error\",\n      documentCount: prior?.status.documentCount ?? null,\n      lastIndexedAt: prior?.status.lastIndexedAt ?? null,\n      lastError,\n    };\n    this.managedByWikiId.set(wikiId, {\n      status,\n      pagesDir: prior?.pagesDir ?? null,\n      fingerprint: prior?.fingerprint ?? null,\n      managed: prior?.managed ?? false,\n    });\n    return { ...status };\n  }\n\n  private async removeManagedCollection(\n    wikiId: string,\n    managed: ManagedWikiCollection,\n    execution?: SearchExecutionOptions\n  ): Promise<void> {\n    if (!this.backend.deleteCollection) {\n      throw new Error(\"Active search backend cannot delete a dedicated collection; use a backend purge command\");\n    }\n    await this.backend.deleteCollection(managed.status.collection, execution);\n    this.managedByWikiId.set(wikiId, {\n      status: managed.status,\n      pagesDir: null,\n      fingerprint: null,\n      managed: false,\n    });\n  }\n}\n\nasync function resolvePagesDir(root: ExternalWikiCollectionRoot): Promise<string> {\n  const lexicalRootDir = path.resolve(root.rootDir);\n  const lexicalPagesDir = path.resolve(lexicalRootDir, root.pagesDir ?? \"wiki\");\n  const lexicalRelative = path.relative(lexicalRootDir, lexicalPagesDir);\n  if (!lexicalRelative || lexicalRelative.startsWith(\"..\") || path.isAbsolute(lexicalRelative)) {\n    throw new Error(\"External wiki pagesDir must stay inside the configured rootDir\");\n  }\n  const [rootDir, pagesDir] = await Promise.all([realpath(lexicalRootDir), realpath(lexicalPagesDir)]);\n  const canonicalRelative = path.relative(rootDir, pagesDir);\n  if (!canonicalRelative || canonicalRelative.startsWith(\"..\") || path.isAbsolute(canonicalRelative)) {\n    throw new Error(\"External wiki pagesDir must stay inside the configured rootDir\");\n  }\n  return pagesDir;\n}\n\nasync function fingerprintMarkdownPages(pagesDir: string): Promise<PagesFingerprint> {\n  const markdownPaths: string[] = [];\n  const pending = [pagesDir];\n  while (pending.length > 0) {\n    const directory = pending.pop()!;\n    const entries = await readdir(directory, { withFileTypes: true });\n    for (const entry of entries) {\n      const entryPath = path.join(directory, entry.name);\n      if (entry.isDirectory()) {\n        pending.push(entryPath);\n      } else if (entry.isSymbolicLink()) {\n        throw new Error(\"External wiki pagesDir must not contain symbolic links\");\n      } else if (entry.isFile() && entry.name.toLowerCase().endsWith(\".md\")) {\n        markdownPaths.push(entryPath);\n      }\n    }\n  }\n  markdownPaths.sort();\n  const fingerprint = createHash(\"sha256\");\n  for (const markdownPath of markdownPaths) {\n    fingerprint.update(path.relative(pagesDir, markdownPath));\n    fingerprint.update(\"\\0\");\n    for await (const chunk of createReadStream(markdownPath)) {\n      fingerprint.update(chunk);\n    }\n    fingerprint.update(\"\\0\");\n  }\n  return {\n    fingerprint: fingerprint.digest(\"hex\"),\n    documentCount: markdownPaths.length,\n  };\n}\n\nfunction isPageResult(resultPath: string, pagesDir: string, collection: string): boolean {\n  let candidate = resultPath;\n  const qmdPrefix = `qmd://${collection}/`;\n  if (candidate.startsWith(qmdPrefix)) candidate = candidate.slice(qmdPrefix.length);\n  const resolved = path.isAbsolute(candidate) ? path.resolve(candidate) : path.resolve(pagesDir, candidate);\n  const relative = path.relative(pagesDir, resolved);\n  return (\n    Boolean(relative) &&\n    !relative.startsWith(\"..\") &&\n    !path.isAbsolute(relative) &&\n    resolved.toLowerCase().endsWith(\".md\")\n  );\n}\n\nfunction configError(error: unknown): string {\n  if (error instanceof Error && error.message.startsWith(\"External wiki\")) {\n    return error.message;\n  }\n  const code = typeof error === \"object\" && error !== null && \"code\" in error ? String(error.code) : null;\n  return code\n    ? `External wiki pages directory could not be scanned (${code})`\n    : \"Invalid external wiki collection configuration\";\n}\n\nfunction safeBackendError(prefix: string, error: unknown): string {\n  if (error instanceof Error && error.message.startsWith(\"Dedicated collection\")) {\n    return error.message;\n  }\n  if (error instanceof Error && error.message.startsWith(\"Active search backend\")) {\n    return error.message;\n  }\n  const name = error instanceof Error && error.name ? error.name : \"Error\";\n  return `${prefix} (${name})`;\n}\n"],"mappings":"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","names":[]}

package/dist/external-wiki-config.d.ts

@@ -0,0 +1,13 @@
+interface ExternalWikiRoot {
+    id: string;
+    rootDir: string;
+    enabled: boolean;
+    label?: string;
+    pagesDir: string;
+    indexFile: string;
+    indexInQmd: boolean;
+    includeInDefaultRecall: false;
+}
+declare function parseExternalWikiRoots(value: unknown, memoryDir?: string): ExternalWikiRoot[];
+
+export { type ExternalWikiRoot, parseExternalWikiRoots };

package/dist/external-wiki-config.js

@@ -0,0 +1,13 @@
+import {
+  parseExternalWikiRoots
+} from "./chunk-NLDVVWCL.js";
+import "./chunk-JV3C2MNQ.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  parseExternalWikiRoots
+};
+//# sourceMappingURL=external-wiki-config.js.map

package/dist/external-wiki-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/external-wiki-guard.d.ts

@@ -0,0 +1,11 @@
+declare const EXTERNAL_WIKI_COLLECTION_PREFIX = "external-wiki-";
+declare function isExternalWikiCollectionName(collection: string): boolean;
+declare function parseExternalWikiRecallGuard(config: Record<string, unknown>): {
+    wikiMergeIntoRecall: false;
+    qmdCollection: string;
+    qmdColdCollection: string;
+};
+declare function assertExternalWikiRootOutsideMemoryDir(memoryDir: string, rootDir: string): void;
+declare function assertExternalWikiRootOutsideMemoryDirCanonical(memoryDir: string, rootDir: string): Promise<void>;
+
+export { EXTERNAL_WIKI_COLLECTION_PREFIX, assertExternalWikiRootOutsideMemoryDir, assertExternalWikiRootOutsideMemoryDirCanonical, isExternalWikiCollectionName, parseExternalWikiRecallGuard };

package/dist/external-wiki-guard.js

@@ -0,0 +1,18 @@
+import {
+  EXTERNAL_WIKI_COLLECTION_PREFIX,
+  assertExternalWikiRootOutsideMemoryDir,
+  assertExternalWikiRootOutsideMemoryDirCanonical,
+  isExternalWikiCollectionName,
+  parseExternalWikiRecallGuard
+} from "./chunk-JV3C2MNQ.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  EXTERNAL_WIKI_COLLECTION_PREFIX,
+  assertExternalWikiRootOutsideMemoryDir,
+  assertExternalWikiRootOutsideMemoryDirCanonical,
+  isExternalWikiCollectionName,
+  parseExternalWikiRecallGuard
+};
+//# sourceMappingURL=external-wiki-guard.js.map

package/dist/external-wiki-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/external-wiki-mcp-tools.d.ts

@@ -0,0 +1,123 @@
+import { McpTool } from './access-mcp.js';
+import 'node:stream';
+import './access-service-CsU-ljFD.js';
+import './catalog-bctMURhN.js';
+import './types-yX_FwERf.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './types-continuity.js';
+import './access-namespace-preflight-CWUDwB4M.js';
+import './access-token-capabilities.js';
+import 'node:async_hooks';
+import './scope-profiles-BJzp2F5A.js';
+import './storage-DfjxusTE.js';
+import './entity-id-normalization.js';
+import './page-versioning.js';
+import './consolidation-operator.js';
+import './utils/serialize-mutations.js';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
+import './runtime/better-sqlite.js';
+import 'better-sqlite3';
+import './write-envelope.js';
+import './structured-attributes.js';
+import './types-B1VHaf2w.js';
+import './recall-explain-renderer.js';
+import './recall-state.js';
+import './search/port.js';
+import './recall-xray.js';
+import './memory-provenance.js';
+import './user-model.js';
+import './access-citation.js';
+import './resolve-auth-token.js';
+import './access-health-types.js';
+import './corpus-watermark.js';
+import './replica-divergence.js';
+import './recall-audit-anomaly.js';
+import './recall-audit.js';
+import './orchestrator-DJYlwiUv.js';
+import './briefing.js';
+import './buffer.js';
+import './extraction-faithfulness.js';
+import './local-llm.js';
+import './model-registry.js';
+import './fallback-llm.js';
+import './resolve-provider-secret.js';
+import './transcript.js';
+import './session-integrity.js';
+import './summarizer.js';
+import './maintenance-D2mveyCd.js';
+import './namespaces/search.js';
+import './compounding/engine.js';
+import './shared-context/manager.js';
+import 'zod';
+import './capabilities.js';
+import './utility-runtime.js';
+import './tier-routing.js';
+import './lifecycle.js';
+import './orchestration/compression-guideline-coordinator.js';
+import './semantic-consolidation-D4KAZO2G.js';
+import './connectors/codex-materialize.js';
+import './logger.js';
+import './embedding-fallback.js';
+import './extraction.js';
+import './schemas.js';
+import './profiling.js';
+import './extraction-error-classification.js';
+import './objective-state.js';
+import './causal-trajectory.js';
+import './trust-zones.js';
+import './harmonic-retrieval.js';
+import './abstraction-nodes.js';
+import './cue-anchors.js';
+import './verified-recall.js';
+import './boxes.js';
+import './semantic-rule-verifier.js';
+import './work-product-ledger.js';
+import './trust-score-stage.js';
+import './trust-score.js';
+import './conversation-index/chunker.js';
+import './conversation-index/backend.js';
+import './faiss-adapter-BHecI1fF.js';
+import './runtime/child-process.js';
+import './namespaces/storage.js';
+import './threading.js';
+import './graph.js';
+import './recall-context-composition.js';
+import './live-connectors-runner.js';
+import './framework-CNDn2164.js';
+import './relevance.js';
+import './negative.js';
+import './session-observer-state.js';
+import './semantic-TddhF0y7.js';
+import './replay/types.js';
+import './service-BeDxSqE-.js';
+import './extraction-judge.js';
+import './lcm/engine.js';
+import './lcm/archive.js';
+import './lcm/summarizer.js';
+import './lcm/dag.js';
+import './lcm/recall.js';
+import './lcm/queue.js';
+import './policy-runtime.js';
+import './explicit-capture.js';
+import './cross-namespace-budget.js';
+import './access-wearables-meetings-surface.js';
+import './graph-snapshot.js';
+import './memory-worth-outcomes.js';
+import './transfer/capsule-import.js';
+import './transfer/types.js';
+import './transfer/capsule-export.js';
+import './capsule-cli.js';
+import './offline-sync.js';
+import './access-offline-manifest.js';
+import './reconcile/manifest.js';
+import './reconcile/plan.js';
+import './action-confidence.js';
+import './access-errors.js';
+
+declare const EXTERNAL_WIKI_MCP_TOOLS: McpTool[];
+
+export { EXTERNAL_WIKI_MCP_TOOLS };

package/dist/external-wiki-mcp-tools.js

@@ -0,0 +1,8 @@
+import {
+  EXTERNAL_WIKI_MCP_TOOLS
+} from "./chunk-A5KNZSNA.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  EXTERNAL_WIKI_MCP_TOOLS
+};
+//# sourceMappingURL=external-wiki-mcp-tools.js.map

package/dist/external-wiki-mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}