@remnic/core 9.45.2 → 9.45.4

package/dist/chunk-7CITSYSH.js

@@ -0,0 +1,242 @@
+import {
+  loadExternalWikiCatalog,
+  readExternalWikiPage
+} from "./chunk-ZMAYKGPN.js";
+
+// src/external-wiki-search.ts
+import path from "path";
+var DEFAULT_LIMIT = 6;
+var MAX_LIMIT = 20;
+var DEFAULT_MAX_CHARS_PER_HIT = 1e3;
+var MAX_CHARS_PER_HIT = 8e3;
+var DEFAULT_MAX_CANDIDATE_FILES = 100;
+var MAX_CANDIDATE_FILES = 100;
+var ExternalWikiSearchError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ExternalWikiSearchError";
+  }
+};
+async function searchExternalWikis(roots, input, options = {}) {
+  const query = requireQuery(input.query);
+  const limit = boundedInteger(input.limit, DEFAULT_LIMIT, 1, MAX_LIMIT, "limit");
+  const maxCharsPerHit = boundedInteger(
+    input.maxCharsPerHit,
+    DEFAULT_MAX_CHARS_PER_HIT,
+    1,
+    MAX_CHARS_PER_HIT,
+    "maxCharsPerHit"
+  );
+  const maxCandidateFiles = boundedInteger(
+    options.maxCandidateFiles,
+    DEFAULT_MAX_CANDIDATE_FILES,
+    1,
+    MAX_CANDIDATE_FILES,
+    "maxCandidateFiles"
+  );
+  const selectedRoots = selectRoots(roots, input.wikiId);
+  const queryTokens = tokenize(query);
+  const degradedWikiIds = /* @__PURE__ */ new Set();
+  const perRootHits = await Promise.all(
+    selectedRoots.map(async (root) => {
+      try {
+        const catalog = await loadExternalWikiCatalog(root, { maxEntries: maxCandidateFiles });
+        if (!catalog.indexPresent) degradedWikiIds.add(root.id);
+        const candidates = await rankCandidates(
+          root,
+          catalog.entries,
+          query,
+          queryTokens,
+          maxCandidateFiles,
+          options.candidateProvider
+        );
+        return await readCandidateHits(root, candidates, query, queryTokens, maxCharsPerHit);
+      } catch {
+        degradedWikiIds.add(root.id);
+        return [];
+      }
+    })
+  );
+  const hits = perRootHits.flat().sort(compareHits).slice(0, limit).map((hit, index) => ({ ...hit, rank: index + 1 }));
+  return {
+    query,
+    hits,
+    count: hits.length,
+    degradedWikiIds: [...degradedWikiIds].sort()
+  };
+}
+function requireQuery(value) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new ExternalWikiSearchError("external wiki search query is required");
+  }
+  return value.trim();
+}
+function boundedInteger(value, fallback, minimum, maximum, field) {
+  const resolved = value ?? fallback;
+  if (!Number.isInteger(resolved) || resolved < minimum || resolved > maximum) {
+    throw new ExternalWikiSearchError(`${field} must be an integer from ${minimum} to ${maximum}`);
+  }
+  return resolved;
+}
+function selectRoots(roots, wikiId) {
+  const enabled = roots.filter((root) => root.enabled);
+  if (enabled.length === 0) {
+    throw new ExternalWikiSearchError("no enabled external wiki roots are configured");
+  }
+  if (wikiId === void 0) return enabled;
+  const normalizedWikiId = wikiId.trim();
+  const selected = enabled.find((root) => root.id === normalizedWikiId);
+  if (!selected) {
+    throw new ExternalWikiSearchError(`unknown external wiki: ${normalizedWikiId || "(empty)"}`);
+  }
+  return [selected];
+}
+async function rankCandidates(root, entries, query, queryTokens, maxCandidateFiles, provider) {
+  let provided = [];
+  if (provider) {
+    try {
+      provided = await provider.search(root, query, maxCandidateFiles);
+    } catch {
+      provided = [];
+    }
+  }
+  const providerByPath = /* @__PURE__ */ new Map();
+  for (const [index, candidate] of provided.slice(0, maxCandidateFiles).entries()) {
+    if (!providerByPath.has(candidate.path)) {
+      providerByPath.set(candidate.path, { score: finiteScore(candidate.score), rank: index });
+    }
+  }
+  return entries.map((entry) => {
+    const providerCandidate = providerByPath.get(entry.path);
+    return {
+      entry,
+      catalogScore: scoreCatalogEntry(entry, query, queryTokens),
+      providerScore: providerCandidate?.score ?? 0,
+      ...providerCandidate ? { providerRank: providerCandidate.rank } : {}
+    };
+  }).sort((left, right) => {
+    const leftProvided = left.providerRank !== void 0;
+    const rightProvided = right.providerRank !== void 0;
+    if (leftProvided !== rightProvided) return leftProvided ? -1 : 1;
+    if (left.providerRank !== right.providerRank) {
+      return (left.providerRank ?? Number.MAX_SAFE_INTEGER) - (right.providerRank ?? Number.MAX_SAFE_INTEGER);
+    }
+    if (right.catalogScore !== left.catalogScore) return right.catalogScore - left.catalogScore;
+    return left.entry.path.localeCompare(right.entry.path);
+  }).slice(0, maxCandidateFiles);
+}
+async function readCandidateHits(root, candidates, query, queryTokens, maxCharsPerHit) {
+  const results = await Promise.all(
+    candidates.map(async (candidate) => {
+      try {
+        const page = await readExternalWikiPage(root, candidate.entry.path);
+        const pageScore = scorePage(page.title, page.content, query, queryTokens);
+        const score = candidate.catalogScore + candidate.providerScore + pageScore;
+        if (score <= 0) return void 0;
+        const snippet = extractSnippet(page.content, queryTokens, maxCharsPerHit);
+        const rootRelativePath = path.posix.join(root.pagesDir.replaceAll("\\", "/"), page.path);
+        const citation = {
+          path: rootRelativePath,
+          lineStart: snippet.lineStart,
+          lineEnd: snippet.lineEnd,
+          note: page.title
+        };
+        return {
+          wikiId: root.id,
+          title: page.title,
+          path: rootRelativePath,
+          snippet: snippet.text,
+          score: roundScore(score),
+          citations: [citation],
+          ...candidate.entry.indexBlurb === void 0 ? {} : { indexBlurb: candidate.entry.indexBlurb }
+        };
+      } catch {
+        return void 0;
+      }
+    })
+  );
+  return results.filter((result) => result !== void 0);
+}
+function scoreCatalogEntry(entry, query, queryTokens) {
+  return scoreText(entry.title, query, queryTokens, 16, 20) + scoreText(entry.path, query, queryTokens, 8, 8) + scoreText(entry.indexBlurb ?? "", query, queryTokens, 4, 6);
+}
+function scorePage(title, content, query, queryTokens) {
+  const titleScore = scoreText(title, query, queryTokens, 12, 16);
+  const lines = content.split(/\r?\n/u);
+  let bestLineScore = 0;
+  const matchedTokens = /* @__PURE__ */ new Set();
+  for (const line of lines) {
+    const normalizedLine = line.toLocaleLowerCase();
+    let lineScore = 0;
+    for (const token of queryTokens) {
+      if (!normalizedLine.includes(token)) continue;
+      matchedTokens.add(token);
+      lineScore += line.startsWith("#") ? 6 : 3;
+    }
+    if (normalizedLine.includes(query.toLocaleLowerCase())) lineScore += 10;
+    bestLineScore = Math.max(bestLineScore, lineScore);
+  }
+  return titleScore + bestLineScore + matchedTokens.size * 2;
+}
+function scoreText(value, query, queryTokens, tokenWeight, phraseWeight) {
+  const normalized = value.toLocaleLowerCase();
+  let score = normalized.includes(query.toLocaleLowerCase()) ? phraseWeight : 0;
+  for (const token of queryTokens) {
+    if (normalized.includes(token)) score += tokenWeight;
+  }
+  return score;
+}
+function tokenize(value) {
+  const tokens = value.toLocaleLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
+  return [...new Set(tokens)];
+}
+function extractSnippet(content, queryTokens, maxChars) {
+  const lines = content.split(/\r?\n/u);
+  if (lines.length === 0) return { text: "", lineStart: 1, lineEnd: 1 };
+  let bestIndex = 0;
+  let bestScore = -1;
+  for (const [index, line] of lines.entries()) {
+    const normalized = line.toLocaleLowerCase();
+    const matchCount = queryTokens.reduce((sum, token) => sum + (normalized.includes(token) ? 1 : 0), 0);
+    const score = matchCount * 2 + (matchCount > 0 && !/^#{1,6}\s/u.test(line) ? 1 : 0);
+    if (score > bestScore) {
+      bestScore = score;
+      bestIndex = index;
+    }
+  }
+  let headingIndex = bestIndex;
+  while (headingIndex > 0 && !/^#{1,6}\s/u.test(lines[headingIndex] ?? "")) headingIndex -= 1;
+  const bodyStart = Math.max(0, bestIndex - 1);
+  const endExclusive = Math.min(lines.length, bestIndex + 3);
+  const start = headingIndex < bodyStart ? headingIndex : bodyStart;
+  const selected = headingIndex < bodyStart ? [lines[headingIndex] ?? "", ...lines.slice(bodyStart, endExclusive)] : lines.slice(start, endExclusive);
+  const snippet = selected.join("\n").trim();
+  if (snippet.length <= maxChars) {
+    return { text: snippet, lineStart: start + 1, lineEnd: endExclusive };
+  }
+  const normalizedSnippet = snippet.toLocaleLowerCase();
+  const firstMatch = queryTokens.map((token) => normalizedSnippet.indexOf(token)).filter((index) => index >= 0).sort((left, right) => left - right)[0] ?? 0;
+  const windowStart = Math.max(0, Math.min(firstMatch - Math.floor(maxChars / 3), snippet.length - maxChars));
+  return {
+    text: snippet.slice(windowStart, windowStart + maxChars).trim(),
+    lineStart: start + 1,
+    lineEnd: endExclusive
+  };
+}
+function finiteScore(score) {
+  return typeof score === "number" && Number.isFinite(score) ? Math.max(0, score) : 0;
+}
+function roundScore(score) {
+  return Math.round(score * 1e3) / 1e3;
+}
+function compareHits(left, right) {
+  if (right.score !== left.score) return right.score - left.score;
+  const wikiComparison = left.wikiId.localeCompare(right.wikiId);
+  return wikiComparison !== 0 ? wikiComparison : left.path.localeCompare(right.path);
+}
+
+export {
+  ExternalWikiSearchError,
+  searchExternalWikis
+};
+//# sourceMappingURL=chunk-7CITSYSH.js.map

package/dist/chunk-7CITSYSH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/external-wiki-search.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { CitationEntry } from \"./citations.js\";\nimport {\n  type ExternalWikiCatalogEntry,\n  type ExternalWikiRoot,\n  loadExternalWikiCatalog,\n  readExternalWikiPage,\n} from \"./external-wiki.js\";\n\nexport type { ExternalWikiRoot } from \"./external-wiki.js\";\n\nconst DEFAULT_LIMIT = 6;\nconst MAX_LIMIT = 20;\nconst DEFAULT_MAX_CHARS_PER_HIT = 1_000;\nconst MAX_CHARS_PER_HIT = 8_000;\nconst DEFAULT_MAX_CANDIDATE_FILES = 100;\nconst MAX_CANDIDATE_FILES = 100;\n\nexport interface ExternalWikiSearchInput {\n  readonly query: string;\n  readonly limit?: number;\n  readonly wikiId?: string;\n  readonly maxCharsPerHit?: number;\n}\n\ninterface ExternalWikiSnippet {\n  readonly text: string;\n  readonly lineStart: number;\n  readonly lineEnd: number;\n}\n\nexport interface ExternalWikiSearchHit {\n  readonly wikiId: string;\n  readonly title: string;\n  readonly path: string;\n  readonly snippet: string;\n  readonly score: number;\n  readonly rank: number;\n  readonly citations: readonly CitationEntry[];\n  readonly indexBlurb?: string;\n}\n\nexport interface ExternalWikiSearchResult {\n  readonly query: string;\n  readonly hits: readonly ExternalWikiSearchHit[];\n  readonly count: number;\n  readonly degradedWikiIds: readonly string[];\n}\n\nexport interface ExternalWikiCandidate {\n  readonly path: string;\n  readonly score?: number;\n}\n\nexport interface ExternalWikiCandidateProvider {\n  search(root: ExternalWikiRoot, query: string, limit: number): Promise<readonly ExternalWikiCandidate[]>;\n}\n\nexport interface ExternalWikiSearchOptions {\n  readonly candidateProvider?: ExternalWikiCandidateProvider;\n  readonly maxCandidateFiles?: number;\n}\n\nexport class ExternalWikiSearchError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ExternalWikiSearchError\";\n  }\n}\n\ninterface RankedCatalogEntry {\n  readonly entry: ExternalWikiCatalogEntry;\n  readonly catalogScore: number;\n  readonly providerScore: number;\n  readonly providerRank?: number;\n}\n\ninterface UnrankedHit extends Omit<ExternalWikiSearchHit, \"rank\"> {}\n\nexport async function searchExternalWikis(\n  roots: readonly ExternalWikiRoot[],\n  input: ExternalWikiSearchInput,\n  options: ExternalWikiSearchOptions = {}\n): Promise<ExternalWikiSearchResult> {\n  const query = requireQuery(input.query);\n  const limit = boundedInteger(input.limit, DEFAULT_LIMIT, 1, MAX_LIMIT, \"limit\");\n  const maxCharsPerHit = boundedInteger(\n    input.maxCharsPerHit,\n    DEFAULT_MAX_CHARS_PER_HIT,\n    1,\n    MAX_CHARS_PER_HIT,\n    \"maxCharsPerHit\"\n  );\n  const maxCandidateFiles = boundedInteger(\n    options.maxCandidateFiles,\n    DEFAULT_MAX_CANDIDATE_FILES,\n    1,\n    MAX_CANDIDATE_FILES,\n    \"maxCandidateFiles\"\n  );\n  const selectedRoots = selectRoots(roots, input.wikiId);\n  const queryTokens = tokenize(query);\n  const degradedWikiIds = new Set<string>();\n  const perRootHits = await Promise.all(\n    selectedRoots.map(async (root) => {\n      try {\n        const catalog = await loadExternalWikiCatalog(root, { maxEntries: maxCandidateFiles });\n        if (!catalog.indexPresent) degradedWikiIds.add(root.id);\n        const candidates = await rankCandidates(\n          root,\n          catalog.entries,\n          query,\n          queryTokens,\n          maxCandidateFiles,\n          options.candidateProvider\n        );\n        return await readCandidateHits(root, candidates, query, queryTokens, maxCharsPerHit);\n      } catch {\n        degradedWikiIds.add(root.id);\n        return [];\n      }\n    })\n  );\n\n  const hits = perRootHits\n    .flat()\n    .sort(compareHits)\n    .slice(0, limit)\n    .map((hit, index): ExternalWikiSearchHit => ({ ...hit, rank: index + 1 }));\n\n  return {\n    query,\n    hits,\n    count: hits.length,\n    degradedWikiIds: [...degradedWikiIds].sort(),\n  };\n}\n\nfunction requireQuery(value: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new ExternalWikiSearchError(\"external wiki search query is required\");\n  }\n  return value.trim();\n}\n\nfunction boundedInteger(\n  value: number | undefined,\n  fallback: number,\n  minimum: number,\n  maximum: number,\n  field: string\n): number {\n  const resolved = value ?? fallback;\n  if (!Number.isInteger(resolved) || resolved < minimum || resolved > maximum) {\n    throw new ExternalWikiSearchError(`${field} must be an integer from ${minimum} to ${maximum}`);\n  }\n  return resolved;\n}\n\nfunction selectRoots(roots: readonly ExternalWikiRoot[], wikiId: string | undefined): ExternalWikiRoot[] {\n  const enabled = roots.filter((root) => root.enabled);\n  if (enabled.length === 0) {\n    throw new ExternalWikiSearchError(\"no enabled external wiki roots are configured\");\n  }\n  if (wikiId === undefined) return enabled;\n  const normalizedWikiId = wikiId.trim();\n  const selected = enabled.find((root) => root.id === normalizedWikiId);\n  if (!selected) {\n    throw new ExternalWikiSearchError(`unknown external wiki: ${normalizedWikiId || \"(empty)\"}`);\n  }\n  return [selected];\n}\n\nasync function rankCandidates(\n  root: ExternalWikiRoot,\n  entries: readonly ExternalWikiCatalogEntry[],\n  query: string,\n  queryTokens: readonly string[],\n  maxCandidateFiles: number,\n  provider: ExternalWikiCandidateProvider | undefined\n): Promise<RankedCatalogEntry[]> {\n  let provided: readonly ExternalWikiCandidate[] = [];\n  if (provider) {\n    try {\n      provided = await provider.search(root, query, maxCandidateFiles);\n    } catch {\n      provided = [];\n    }\n  }\n\n  const providerByPath = new Map<string, { score: number; rank: number }>();\n  for (const [index, candidate] of provided.slice(0, maxCandidateFiles).entries()) {\n    if (!providerByPath.has(candidate.path)) {\n      providerByPath.set(candidate.path, { score: finiteScore(candidate.score), rank: index });\n    }\n  }\n\n  return entries\n    .map((entry): RankedCatalogEntry => {\n      const providerCandidate = providerByPath.get(entry.path);\n      return {\n        entry,\n        catalogScore: scoreCatalogEntry(entry, query, queryTokens),\n        providerScore: providerCandidate?.score ?? 0,\n        ...(providerCandidate ? { providerRank: providerCandidate.rank } : {}),\n      };\n    })\n    .sort((left, right) => {\n      const leftProvided = left.providerRank !== undefined;\n      const rightProvided = right.providerRank !== undefined;\n      if (leftProvided !== rightProvided) return leftProvided ? -1 : 1;\n      if (left.providerRank !== right.providerRank) {\n        return (left.providerRank ?? Number.MAX_SAFE_INTEGER) - (right.providerRank ?? Number.MAX_SAFE_INTEGER);\n      }\n      if (right.catalogScore !== left.catalogScore) return right.catalogScore - left.catalogScore;\n      return left.entry.path.localeCompare(right.entry.path);\n    })\n    .slice(0, maxCandidateFiles);\n}\n\nasync function readCandidateHits(\n  root: ExternalWikiRoot,\n  candidates: readonly RankedCatalogEntry[],\n  query: string,\n  queryTokens: readonly string[],\n  maxCharsPerHit: number\n): Promise<UnrankedHit[]> {\n  const results = await Promise.all(\n    candidates.map(async (candidate): Promise<UnrankedHit | undefined> => {\n      try {\n        const page = await readExternalWikiPage(root, candidate.entry.path);\n        const pageScore = scorePage(page.title, page.content, query, queryTokens);\n        const score = candidate.catalogScore + candidate.providerScore + pageScore;\n        if (score <= 0) return undefined;\n        const snippet = extractSnippet(page.content, queryTokens, maxCharsPerHit);\n        const rootRelativePath = path.posix.join(root.pagesDir.replaceAll(\"\\\\\", \"/\"), page.path);\n        const citation: CitationEntry = {\n          path: rootRelativePath,\n          lineStart: snippet.lineStart,\n          lineEnd: snippet.lineEnd,\n          note: page.title,\n        };\n        return {\n          wikiId: root.id,\n          title: page.title,\n          path: rootRelativePath,\n          snippet: snippet.text,\n          score: roundScore(score),\n          citations: [citation],\n          ...(candidate.entry.indexBlurb === undefined ? {} : { indexBlurb: candidate.entry.indexBlurb }),\n        };\n      } catch {\n        return undefined;\n      }\n    })\n  );\n  return results.filter((result): result is UnrankedHit => result !== undefined);\n}\n\nfunction scoreCatalogEntry(entry: ExternalWikiCatalogEntry, query: string, queryTokens: readonly string[]): number {\n  return (\n    scoreText(entry.title, query, queryTokens, 16, 20) +\n    scoreText(entry.path, query, queryTokens, 8, 8) +\n    scoreText(entry.indexBlurb ?? \"\", query, queryTokens, 4, 6)\n  );\n}\n\nfunction scorePage(title: string, content: string, query: string, queryTokens: readonly string[]): number {\n  const titleScore = scoreText(title, query, queryTokens, 12, 16);\n  const lines = content.split(/\\r?\\n/u);\n  let bestLineScore = 0;\n  const matchedTokens = new Set<string>();\n  for (const line of lines) {\n    const normalizedLine = line.toLocaleLowerCase();\n    let lineScore = 0;\n    for (const token of queryTokens) {\n      if (!normalizedLine.includes(token)) continue;\n      matchedTokens.add(token);\n      lineScore += line.startsWith(\"#\") ? 6 : 3;\n    }\n    if (normalizedLine.includes(query.toLocaleLowerCase())) lineScore += 10;\n    bestLineScore = Math.max(bestLineScore, lineScore);\n  }\n  return titleScore + bestLineScore + matchedTokens.size * 2;\n}\n\nfunction scoreText(\n  value: string,\n  query: string,\n  queryTokens: readonly string[],\n  tokenWeight: number,\n  phraseWeight: number\n): number {\n  const normalized = value.toLocaleLowerCase();\n  let score = normalized.includes(query.toLocaleLowerCase()) ? phraseWeight : 0;\n  for (const token of queryTokens) {\n    if (normalized.includes(token)) score += tokenWeight;\n  }\n  return score;\n}\n\nfunction tokenize(value: string): string[] {\n  const tokens = value.toLocaleLowerCase().match(/[\\p{L}\\p{N}]+/gu) ?? [];\n  return [...new Set(tokens)];\n}\n\nfunction extractSnippet(content: string, queryTokens: readonly string[], maxChars: number): ExternalWikiSnippet {\n  const lines = content.split(/\\r?\\n/u);\n  if (lines.length === 0) return { text: \"\", lineStart: 1, lineEnd: 1 };\n  let bestIndex = 0;\n  let bestScore = -1;\n  for (const [index, line] of lines.entries()) {\n    const normalized = line.toLocaleLowerCase();\n    const matchCount = queryTokens.reduce((sum, token) => sum + (normalized.includes(token) ? 1 : 0), 0);\n    const score = matchCount * 2 + (matchCount > 0 && !/^#{1,6}\\s/u.test(line) ? 1 : 0);\n    if (score > bestScore) {\n      bestScore = score;\n      bestIndex = index;\n    }\n  }\n\n  let headingIndex = bestIndex;\n  while (headingIndex > 0 && !/^#{1,6}\\s/u.test(lines[headingIndex] ?? \"\")) headingIndex -= 1;\n  const bodyStart = Math.max(0, bestIndex - 1);\n  const endExclusive = Math.min(lines.length, bestIndex + 3);\n  const start = headingIndex < bodyStart ? headingIndex : bodyStart;\n  const selected =\n    headingIndex < bodyStart\n      ? [lines[headingIndex] ?? \"\", ...lines.slice(bodyStart, endExclusive)]\n      : lines.slice(start, endExclusive);\n  const snippet = selected.join(\"\\n\").trim();\n  if (snippet.length <= maxChars) {\n    return { text: snippet, lineStart: start + 1, lineEnd: endExclusive };\n  }\n\n  const normalizedSnippet = snippet.toLocaleLowerCase();\n  const firstMatch =\n    queryTokens\n      .map((token) => normalizedSnippet.indexOf(token))\n      .filter((index) => index >= 0)\n      .sort((left, right) => left - right)[0] ?? 0;\n  const windowStart = Math.max(0, Math.min(firstMatch - Math.floor(maxChars / 3), snippet.length - maxChars));\n  return {\n    text: snippet.slice(windowStart, windowStart + maxChars).trim(),\n    lineStart: start + 1,\n    lineEnd: endExclusive,\n  };\n}\n\nfunction finiteScore(score: number | undefined): number {\n  return typeof score === \"number\" && Number.isFinite(score) ? Math.max(0, score) : 0;\n}\n\nfunction roundScore(score: number): number {\n  return Math.round(score * 1_000) / 1_000;\n}\n\nfunction compareHits(left: UnrankedHit, right: UnrankedHit): number {\n  if (right.score !== left.score) return right.score - left.score;\n  const wikiComparison = left.wikiId.localeCompare(right.wikiId);\n  return wikiComparison !== 0 ? wikiComparison : left.path.localeCompare(right.path);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-227UFSEQ.js → chunk-7RZJWZ46.js}

@@ -1,3 +1,7 @@
+import {
+  searchConversationIndex,
+  searchConversationIndexFaissFailOpen
+} from "./chunk-A7Q43EUZ.js";
 import {
   failOpenFaissHealth
 } from "./chunk-ET356KSB.js";
@@ -5,10 +9,6 @@ import {
   rebuildConversationChunksFailOpen,
   upsertConversationChunksFailOpen
 } from "./chunk-72A4L5JJ.js";
-import {
-  searchConversationIndex,
-  searchConversationIndexFaissFailOpen
-} from "./chunk-A7Q43EUZ.js";
 
 // src/conversation-index/backend.ts
 function createConversationIndexBackend(options) {
@@ -235,4 +235,4 @@ function createFaissBackend(getFaiss) {
 export {
   createConversationIndexBackend
 };
-//# sourceMappingURL=chunk-227UFSEQ.js.map
+//# sourceMappingURL=chunk-7RZJWZ46.js.map

package/dist/{chunk-E5UK4VPE.js → chunk-7SHJHPTY.js}

@@ -1,10 +1,10 @@
-import {
-  getConfiguredNamespaces
-} from "./chunk-ULARSG5Z.js";
 import {
   resolveDefaultNamespaceRoot,
   resolveNamespaceStorageRoot
-} from "./chunk-LZ4LDKHZ.js";
+} from "./chunk-CLB32OHM.js";
+import {
+  getConfiguredNamespaces
+} from "./chunk-YN6ASZUG.js";
 import {
   namespaceIdentityFromToken,
   namespaceIdentityToken,
@@ -2204,4 +2204,4 @@ export {
   runNamespaceMaintenancePlan,
   runNamespaceMaintenanceBatchPlan
 };
-//# sourceMappingURL=chunk-E5UK4VPE.js.map
+//# sourceMappingURL=chunk-7SHJHPTY.js.map

package/dist/{chunk-UVIKWC7M.js → chunk-7YERSTN7.js}

@@ -3,7 +3,7 @@ import {
   readNamespaceMaintenanceLastRanStatuses,
   readNamespaceMaintenanceStatuses,
   runNamespaceMaintenancePlan
-} from "./chunk-E5UK4VPE.js";
+} from "./chunk-7SHJHPTY.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -14,7 +14,7 @@ import {
 } from "./chunk-CMTINOFS.js";
 import {
   summarizeCorpusAndReplica
-} from "./chunk-VUPTKTDV.js";
+} from "./chunk-2MRHJNWL.js";
 import {
   readJudgeVerdictStats
 } from "./chunk-OZKOPQCM.js";
@@ -25,49 +25,45 @@ import {
   runEvalBenchmarkCiGate,
   validateEvalBenchmarkPack
 } from "./chunk-3PY7VHV7.js";
+import {
+  runConsolidationProvenanceCheck
+} from "./chunk-HAYSYUAB.js";
 import {
   resolveCuratedIncludeFilesStatePath,
   resolveNativeKnowledgeStatePath,
   resolveOpenClawWorkspaceStatePath
 } from "./chunk-2DQ2XREU.js";
-import {
-  runConsolidationProvenanceCheck
-} from "./chunk-TSH56VPU.js";
 import {
   reportBufferSurpriseDistribution
 } from "./chunk-YBPYIAA5.js";
 import {
   parseConfig
-} from "./chunk-CUM2BBPN.js";
+} from "./chunk-AUMWZSE7.js";
 import {
   readAggregateExtractionWatermark
-} from "./chunk-D3J5SLQK.js";
+} from "./chunk-EJHEWCGQ.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-PDLBLTOK.js";
+} from "./chunk-EITZHSX6.js";
 import {
   listNamespaces
-} from "./chunk-E53DSZEN.js";
+} from "./chunk-C26TE27X.js";
 import {
   analyzeGraphHealth
 } from "./chunk-L2DPF4DF.js";
 import {
   StorageManager
-} from "./chunk-E6PNLPGJ.js";
+} from "./chunk-FZP32336.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
-import {
-  probeProjectionHealth
-} from "./chunk-3CSX3ETE.js";
 import {
   summarizeExtractionLiveness
 } from "./chunk-3SG4FGDV.js";
 import {
-  readEnvVar,
-  resolveHomeDir
-} from "./chunk-JUC24CTX.js";
+  probeProjectionHealth
+} from "./chunk-3CSX3ETE.js";
 import {
   resolveAccessSetupCapabilities,
   resolveCapabilities,
@@ -79,6 +75,10 @@ import {
   resolvePresentationCapabilities,
   resolveQmdCapabilities
 } from "./chunk-2XRE6FLM.js";
+import {
+  readEnvVar,
+  resolveHomeDir
+} from "./chunk-JUC24CTX.js";
 
 // src/operator-toolkit.ts
 import path from "path";
@@ -1683,4 +1683,4 @@ export {
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-UVIKWC7M.js.map
+//# sourceMappingURL=chunk-7YERSTN7.js.map

package/dist/{chunk-DLVPUX7U.js → chunk-7YKVM5H3.js}

@@ -3,8 +3,9 @@ import {
 } from "./chunk-IJ7HK452.js";
 import {
   pathMayCarryEntityRefs,
-  requestEntityCanonicalIdReconcile
-} from "./chunk-4J7G5SY4.js";
+  requestEntityCanonicalIdReconcile,
+  withRawEntityPageMutation
+} from "./chunk-NZBZ7IS2.js";
 import {
   ALL_CATEGORY_DIRS,
   RECALL_FALLBACK_DIRS
@@ -170,10 +171,11 @@ async function revertToVersion(pagePath, versionId, config, log = NOOP_LOGGER, m
     `reverted to version ${versionId}`,
     resolvedMemoryDir
   );
-  await writeFile(pagePath, targetContent, "utf-8");
+  await withRawEntityPageMutation(resolvedMemoryDir, pagePath, async () => {
+    await writeFile(pagePath, targetContent, "utf-8");
+  });
   const revertedTop = relPath(pagePath, resolvedMemoryDir).split(path.sep)[0];
-  const inRecallTier = RECALL_FALLBACK_DIRS.includes(revertedTop);
-  if (inRecallTier) {
+  if (RECALL_FALLBACK_DIRS.includes(revertedTop)) {
     bumpMemoryCorpusVersionForDir(resolvedMemoryDir);
   }
   if (pathMayCarryEntityRefs(resolvedMemoryDir, pagePath)) {
@@ -279,4 +281,4 @@ export {
   revertToVersion,
   diffVersions
 };
-//# sourceMappingURL=chunk-DLVPUX7U.js.map
+//# sourceMappingURL=chunk-7YKVM5H3.js.map

package/dist/chunk-7YKVM5H3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/page-versioning.ts"],"sourcesContent":["/**\n * Page-level versioning with history and revert (issue #371).\n *\n * Provides snapshot-based versioning for memory files using a sidecar\n * directory layout.  Each memory page gets a `.versions/<pageName>/`\n * subdirectory containing numbered snapshots and a `manifest.json` that\n * records the version history.\n *\n * Storage layout:\n *   memoryDir/\n *     facts/preferences.md              <- current file\n *     .versions/\n *       facts__preferences/\n *         manifest.json                  <- VersionHistory\n *         1.md                           <- version 1 snapshot\n *         2.md                           <- version 2 snapshot\n */\n\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport {\n  access,\n  mkdir,\n  readFile,\n  writeFile,\n  unlink,\n} from \"node:fs/promises\";\nimport { ALL_CATEGORY_DIRS, RECALL_FALLBACK_DIRS } from \"./utils/category-dir.js\";\nimport { bumpMemoryCorpusVersionForDir } from \"./memory-corpus-version.js\";\nimport {\n  pathMayCarryEntityRefs,\n  requestEntityCanonicalIdReconcile,\n} from \"./storage/entity-canonical-id-references.js\";\nimport { withRawEntityPageMutation } from \"./storage/entity-canonical-id-lock.js\";\n\n// ---------------------------------------------------------------------------\n// Public interfaces\n// ---------------------------------------------------------------------------\n\nexport interface PageVersion {\n  versionId: string;\n  timestamp: string;\n  contentHash: string;\n  sizeBytes: number;\n  trigger: VersionTrigger;\n  note?: string;\n}\n\nexport type VersionTrigger = \"write\" | \"consolidation\" | \"revert\" | \"manual\";\n\nexport interface VersionHistory {\n  pagePath: string;\n  versions: PageVersion[];\n  currentVersion: string;\n}\n\nexport interface VersioningConfig {\n  enabled: boolean;\n  maxVersionsPerPage: number;\n  sidecarDir: string;\n}\n\n// ---------------------------------------------------------------------------\n// Logger interface (minimal, avoids coupling to the host logger)\n// ---------------------------------------------------------------------------\n\nexport interface VersioningLogger {\n  debug(msg: string): void;\n  warn(msg: string): void;\n}\n\nconst NOOP_LOGGER: VersioningLogger = {\n  debug: () => {},\n  warn: () => {},\n};\n\n// ---------------------------------------------------------------------------\n// Per-page write lock (promise-chain pattern, see gotcha #40)\n// ---------------------------------------------------------------------------\n\nconst writeLocks = new Map<string, Promise<void>>();\n\nfunction withPageLock<T>(pageKey: string, fn: () => Promise<T>): Promise<T> {\n  const prev = writeLocks.get(pageKey) ?? Promise.resolve();\n  const next = prev.then(fn, fn); // run fn after previous completes, even if previous failed\n  writeLocks.set(pageKey, next.then(() => {}, () => {})); // recover chain per gotcha #40\n  return next;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nfunction contentHash(content: string): string {\n  return createHash(\"sha256\").update(content, \"utf-8\").digest(\"hex\");\n}\n\n/**\n * Derive a filesystem-safe sidecar key from a page path relative to memoryDir.\n *\n * `facts/2026-01-15/pref-001.md` -> `facts__2026-01-15__pref-001`\n *\n * Exported so the `remnic doctor` consolidation-provenance check (issue\n * #561 PR 4) resolves snapshot locations using the canonical algorithm\n * without re-implementing it — preventing silent drift if the key\n * format ever changes.\n */\nexport function sidecarKey(pagePath: string): string {\n  const withoutExt = pagePath.replace(/\\.md$/i, \"\");\n  return withoutExt.replace(/[\\\\/]/g, \"__\");\n}\n\nfunction sidecarDir(memoryDir: string, sidecar: string, pagePath: string): string {\n  return path.join(memoryDir, sidecar, sidecarKey(pagePath));\n}\n\nfunction manifestPath(memoryDir: string, sidecar: string, pagePath: string): string {\n  return path.join(sidecarDir(memoryDir, sidecar, pagePath), \"manifest.json\");\n}\n\nasync function fileExists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function readManifest(\n  memoryDir: string,\n  sidecar: string,\n  pagePath: string,\n): Promise<VersionHistory> {\n  const mp = manifestPath(memoryDir, sidecar, pagePath);\n  if (!(await fileExists(mp))) {\n    return { pagePath, versions: [], currentVersion: \"0\" };\n  }\n  try {\n    const raw = await readFile(mp, \"utf-8\");\n    const parsed: unknown = JSON.parse(raw);\n    if (typeof parsed !== \"object\" || parsed === null) {\n      throw new Error(\"manifest root must be an object\");\n    }\n    const obj = parsed as Record<string, unknown>;\n    if (!Array.isArray(obj.versions)) {\n      throw new Error(\"manifest versions must be an array\");\n    }\n    const versions = obj.versions.map((entry, index) => {\n      if (!entry || typeof entry !== \"object\" || Array.isArray(entry)) {\n        throw new Error(`manifest version ${index} must be an object`);\n      }\n      const version = entry as Record<string, unknown>;\n      if (\n        typeof version.versionId !== \"string\" ||\n        !/^\\d+$/.test(version.versionId) ||\n        typeof version.timestamp !== \"string\" ||\n        typeof version.contentHash !== \"string\" ||\n        typeof version.sizeBytes !== \"number\" ||\n        !Number.isFinite(version.sizeBytes) ||\n        ![\"write\", \"consolidation\", \"revert\", \"manual\"].includes(String(version.trigger))\n      ) {\n        throw new Error(`manifest version ${index} has invalid shape`);\n      }\n      return version as unknown as PageVersion;\n    });\n    if (typeof obj.currentVersion !== \"string\" || !/^\\d+$/.test(obj.currentVersion)) {\n      throw new Error(\"manifest currentVersion must be a numeric string\");\n    }\n    const currentVersion = obj.currentVersion;\n    return { pagePath: typeof obj.pagePath === \"string\" ? obj.pagePath : pagePath, versions, currentVersion };\n  } catch (error) {\n    throw new Error(`page-versioning: invalid manifest ${mp}: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\nasync function writeManifest(\n  memoryDir: string,\n  sidecar: string,\n  pagePath: string,\n  history: VersionHistory,\n): Promise<void> {\n  const dir = sidecarDir(memoryDir, sidecar, pagePath);\n  await mkdir(dir, { recursive: true });\n  const mp = manifestPath(memoryDir, sidecar, pagePath);\n  await writeFile(mp, JSON.stringify(history, null, 2) + \"\\n\", \"utf-8\");\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create a new version snapshot for a page.\n *\n * Call this BEFORE overwriting the current file so the previous content is\n * preserved. If the file does not exist yet (first write), the provided\n * `content` is snapshotted as version 1.\n *\n * Pruning: when the number of versions exceeds `config.maxVersionsPerPage`,\n * the oldest snapshots (and their files) are removed.\n */\nexport async function createVersion(\n  pagePath: string,\n  content: string,\n  trigger: VersionTrigger,\n  config: VersioningConfig,\n  log: VersioningLogger = NOOP_LOGGER,\n  note?: string,\n  memoryDir?: string,\n): Promise<PageVersion> {\n  const { sidecarDir: sidecar, maxVersionsPerPage } = config;\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const mPath = manifestPath(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir));\n\n  return withPageLock(mPath, async () => {\n    const history = await readManifest(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir));\n    const nextId = String(history.versions.length > 0\n      ? Math.max(...history.versions.map((v) => Number(v.versionId))) + 1\n      : 1);\n\n    const hash = contentHash(content);\n    const version: PageVersion = {\n      versionId: nextId,\n      timestamp: new Date().toISOString(),\n      contentHash: hash,\n      sizeBytes: Buffer.byteLength(content, \"utf-8\"),\n      trigger,\n      ...(note !== undefined ? { note } : {}),\n    };\n\n    // Write snapshot file\n    const dir = sidecarDir(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir));\n    await mkdir(dir, { recursive: true });\n    const ext = path.extname(pagePath) || \".md\";\n    const snapshotPath = path.join(dir, `${nextId}${ext}`);\n    await writeFile(snapshotPath, content, \"utf-8\");\n\n    history.versions.push(version);\n    history.currentVersion = nextId;\n\n    // Prune old versions if exceeding max\n    if (maxVersionsPerPage > 0 && history.versions.length > maxVersionsPerPage) {\n      const toRemove = history.versions.splice(0, history.versions.length - maxVersionsPerPage);\n      for (const old of toRemove) {\n        const oldPath = path.join(dir, `${old.versionId}${ext}`);\n        try {\n          await unlink(oldPath);\n        } catch {\n          log.debug(`page-versioning: could not remove old snapshot ${oldPath}`);\n        }\n      }\n    }\n\n    await writeManifest(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir), history);\n    log.debug(`page-versioning: created version ${nextId} for ${pagePath} (trigger=${trigger})`);\n\n    return version;\n  });\n}\n\n/**\n * List all versions for a page.\n */\nexport async function listVersions(\n  pagePath: string,\n  config: VersioningConfig,\n  memoryDir?: string,\n): Promise<VersionHistory> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const rel = relPath(pagePath, resolvedMemoryDir);\n  const history = await readManifest(resolvedMemoryDir, config.sidecarDir, rel);\n  // Sort ascending by versionId (numeric)\n  history.versions.sort((a, b) => Number(a.versionId) - Number(b.versionId));\n  return history;\n}\n\n/**\n * Read the content of a specific version.\n */\nexport async function getVersion(\n  pagePath: string,\n  versionId: string,\n  config: VersioningConfig,\n  memoryDir?: string,\n): Promise<string> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const rel = relPath(pagePath, resolvedMemoryDir);\n  const ext = path.extname(pagePath) || \".md\";\n  const dir = sidecarDir(resolvedMemoryDir, config.sidecarDir, rel);\n  const snapshotPath = path.join(dir, `${versionId}${ext}`);\n\n  if (!(await fileExists(snapshotPath))) {\n    throw new Error(`Version ${versionId} not found for ${pagePath}`);\n  }\n\n  return readFile(snapshotPath, \"utf-8\");\n}\n\n/**\n * Revert a page to a previous version.\n *\n * 1. Reads the target version's content.\n * 2. Snapshots the CURRENT content as a new version (trigger: \"revert\").\n * 3. Writes the reverted content to the page file.\n *\n * Returns the newly created version entry for the revert snapshot.\n */\nexport async function revertToVersion(\n  pagePath: string,\n  versionId: string,\n  config: VersioningConfig,\n  log: VersioningLogger = NOOP_LOGGER,\n  memoryDir?: string,\n): Promise<PageVersion> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n\n  // Read target version content\n  const targetContent = await getVersion(pagePath, versionId, config, resolvedMemoryDir);\n\n  // Snapshot current content before overwriting\n  let currentContent = \"\";\n  try {\n    currentContent = await readFile(pagePath, \"utf-8\");\n  } catch {\n    // File may not exist; that's okay\n  }\n\n  const version = await createVersion(\n    pagePath,\n    currentContent,\n    \"revert\",\n    config,\n    log,\n    `reverted to version ${versionId}`,\n    resolvedMemoryDir,\n  );\n\n  await withRawEntityPageMutation(resolvedMemoryDir, pagePath, async () => {\n    await writeFile(pagePath, targetContent, \"utf-8\");\n  });\n  const revertedTop = relPath(pagePath, resolvedMemoryDir).split(path.sep)[0];\n  if ((RECALL_FALLBACK_DIRS as readonly string[]).includes(revertedTop)) {\n    bumpMemoryCorpusVersionForDir(resolvedMemoryDir);\n  }\n  if (pathMayCarryEntityRefs(resolvedMemoryDir, pagePath)) {\n    await requestEntityCanonicalIdReconcile(path.join(resolvedMemoryDir, \"state\"));\n  }\n  log.debug(`page-versioning: reverted ${pagePath} to version ${versionId}`);\n\n  return version;\n}\n\n/**\n * Simple line-based diff between two versions.\n *\n * Returns a unified-style diff string showing added (+) and removed (-) lines.\n */\nexport async function diffVersions(\n  pagePath: string,\n  v1: string,\n  v2: string,\n  config: VersioningConfig,\n  memoryDir?: string,\n): Promise<string> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const content1 = await getVersion(pagePath, v1, config, resolvedMemoryDir);\n  const content2 = await getVersion(pagePath, v2, config, resolvedMemoryDir);\n\n  const lines1 = content1.split(\"\\n\");\n  const lines2 = content2.split(\"\\n\");\n\n  const result: string[] = [];\n  result.push(`--- version ${v1}`);\n  result.push(`+++ version ${v2}`);\n\n  // Simple LCS-based diff\n  const lcs = computeLCS(lines1, lines2);\n  let i = 0;\n  let j = 0;\n  let k = 0;\n\n  while (k < lcs.length) {\n    // Emit removed lines before the next common line\n    while (i < lines1.length && lines1[i] !== lcs[k]) {\n      result.push(`-${lines1[i]}`);\n      i++;\n    }\n    // Emit added lines before the next common line\n    while (j < lines2.length && lines2[j] !== lcs[k]) {\n      result.push(`+${lines2[j]}`);\n      j++;\n    }\n    // Common line\n    result.push(` ${lcs[k]}`);\n    i++;\n    j++;\n    k++;\n  }\n  // Remaining removed lines\n  while (i < lines1.length) {\n    result.push(`-${lines1[i]}`);\n    i++;\n  }\n  // Remaining added lines\n  while (j < lines2.length) {\n    result.push(`+${lines2[j]}`);\n    j++;\n  }\n\n  return result.join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// LCS helper for diffVersions\n// ---------------------------------------------------------------------------\n\nfunction computeLCS(a: string[], b: string[]): string[] {\n  const m = a.length;\n  const n = b.length;\n  // Build DP table\n  const dp: number[][] = Array.from({ length: m + 1 }, () => new Array<number>(n + 1).fill(0));\n  for (let i = 1; i <= m; i++) {\n    for (let j = 1; j <= n; j++) {\n      if (a[i - 1] === b[j - 1]) {\n        dp[i][j] = dp[i - 1][j - 1] + 1;\n      } else {\n        dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);\n      }\n    }\n  }\n  // Backtrack to build LCS\n  const result: string[] = [];\n  let i = m;\n  let j = n;\n  while (i > 0 && j > 0) {\n    if (a[i - 1] === b[j - 1]) {\n      result.unshift(a[i - 1]);\n      i--;\n      j--;\n    } else if (dp[i - 1][j] > dp[i][j - 1]) {\n      i--;\n    } else {\n      j--;\n    }\n  }\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Legacy fallback: given an absolute page path, heuristically resolve the\n * memory directory by walking up past known subdirectory names.\n *\n * Callers should always pass an explicit `memoryDir` instead of relying on\n * this heuristic.  It is retained only for backward compatibility when the\n * optional `memoryDir` parameter is omitted.\n */\nfunction resolveMemoryDir(pagePath: string): string {\n  // Derive the recall category dirs from ALL_CATEGORY_DIRS (single source of\n  // truth) so newly-routed categories (decisions/, preferences/, ...) are\n  // recognized when walking up to the memory root (#1546); the non-category\n  // subdirs are listed explicitly.\n  const knownSubdirs = new Set<string>([\n    ...ALL_CATEGORY_DIRS,\n    \"entities\",\n    \"state\",\n    \"artifacts\",\n    \"profiles\",\n  ]);\n\n  let dir = path.dirname(pagePath);\n  // Walk up past date directories (YYYY-MM-DD) and known subdirs\n  for (let depth = 0; depth < 5; depth++) {\n    const base = path.basename(dir);\n    if (knownSubdirs.has(base) || /^\\d{4}-\\d{2}-\\d{2}$/.test(base)) {\n      dir = path.dirname(dir);\n    } else {\n      break;\n    }\n  }\n  return dir;\n}\n\n/**\n * Compute relative path of a page within its memory directory.\n */\nfunction relPath(pagePath: string, memoryDir: string): string {\n  return path.relative(memoryDir, pagePath);\n}\n"],"mappings":"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","names":["i","j"]}