@hraness/wordcell 0.21.3 → 0.22.1

package/dist/clip/doctor.js

@@ -9,16 +9,17 @@ import {
   renderAdapterCapabilities,
   renderDoctorReport,
   runDiagnosticCommand
-} from "../index-van48n3g.js";
-import"../index-jzcws0zn.js";
+} from "../index-fc4dr114.js";
+import"../index-g5vsqmdy.js";
 import"../index-hgve9rh2.js";
+import"../index-2gv8y733.js";
 import"../index-w2zc0vwa.js";
 import"../index-e5fbsywq.js";
 import"../index-dfag79p7.js";
 import"../index-gh719d91.js";
 import"../index-mxxxytys.js";
-import"../index-2gv8y733.js";
 import"../index-1xxnjn0d.js";
+import"../index-4knsp9qj.js";
 import"../index-z1w83f81.js";
 export {
   runDiagnosticCommand,

package/dist/clip/jobs.js

@@ -1,7 +1,4 @@
 // @bun
-import {
-  acquireFileLease
-} from "../index-3rm7cz6h.js";
 import {
   redactSensitiveText
 } from "../index-mxxxytys.js";
@@ -9,6 +6,9 @@ import {
   sanitizeTerminalLine,
   sanitizeTerminalText
 } from "../index-1xxnjn0d.js";
+import {
+  acquireFileLease
+} from "../index-3rm7cz6h.js";
 import"../index-z1w83f81.js";
 
 // src/clip/jobs.ts

package/dist/clip/refresh.js

@@ -3,8 +3,8 @@ import {
   diffCaptureBundle
 } from "../index-j4zgmzjr.js";
 import"../index-npg9z1a4.js";
-import"../index-1gwbassd.js";
 import"../index-mxxxytys.js";
+import"../index-1gwbassd.js";
 import"../index-1xxnjn0d.js";
 import"../index-z1w83f81.js";
 export {

package/dist/evaluation-builder.js

@@ -4,38 +4,39 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-pbr6rv47.js";
-import"./index-vdw5yjfa.js";
-import"./index-4j3tt0c3.js";
+} from "./index-1k595z6v.js";
+import"./index-q7tbg07z.js";
 import"./index-adx6khj5.js";
 import {
   indexSemanticVault,
   recommendedEmbeddingModel,
   recommendedEmbeddingModelSha256
-} from "./index-115b07ap.js";
-import"./index-bgfzwt4h.js";
-import"./index-bcfn9xah.js";
-import"./index-11621h23.js";
-import {
-  scanVault
-} from "./index-0k2x4nn9.js";
-import"./index-nd6nynv2.js";
-import {
-  runGitCommand
-} from "./index-1gwbassd.js";
+} from "./index-rr9kzq4n.js";
+import"./index-4j3tt0c3.js";
+import"./index-j70m75wd.js";
 import {
   MAX_EVALUATION_DIAGNOSTICS,
   MAX_EVALUATION_EVIDENCE_BYTES,
   MAX_EVALUATION_RESULTS_PER_QUERY
 } from "./index-b88v3vtm.js";
-import"./index-3rm7cz6h.js";
-import"./index-why54q5p.js";
+import"./index-djrcc1yf.js";
+import"./index-jk1sgx36.js";
+import"./index-xv80vzfp.js";
+import"./index-tf4wzjew.js";
+import {
+  runGitCommand
+} from "./index-1gwbassd.js";
+import"./index-vnybgywh.js";
+import"./index-1xxnjn0d.js";
+import {
+  scanVault
+} from "./index-233z9wmn.js";
+import"./index-d13v9ckt.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
-import"./index-d13v9ckt.js";
 import"./index-5vwpzb5a.js";
-import"./index-ekpwvbra.js";
-import"./index-1xxnjn0d.js";
+import"./index-3rm7cz6h.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 
 // src/evaluation-builder.ts

package/dist/evaluation-kb.js

@@ -4,26 +4,27 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-pbr6rv47.js";
-import"./index-vdw5yjfa.js";
-import"./index-4j3tt0c3.js";
+} from "./index-1k595z6v.js";
+import"./index-q7tbg07z.js";
 import"./index-adx6khj5.js";
-import"./index-115b07ap.js";
-import"./index-bgfzwt4h.js";
-import"./index-bcfn9xah.js";
-import"./index-11621h23.js";
-import"./index-0k2x4nn9.js";
-import"./index-nd6nynv2.js";
-import"./index-1gwbassd.js";
+import"./index-rr9kzq4n.js";
+import"./index-4j3tt0c3.js";
+import"./index-j70m75wd.js";
 import"./index-b88v3vtm.js";
-import"./index-3rm7cz6h.js";
-import"./index-why54q5p.js";
+import"./index-djrcc1yf.js";
+import"./index-jk1sgx36.js";
+import"./index-xv80vzfp.js";
+import"./index-tf4wzjew.js";
+import"./index-1gwbassd.js";
+import"./index-vnybgywh.js";
+import"./index-1xxnjn0d.js";
+import"./index-233z9wmn.js";
+import"./index-d13v9ckt.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
-import"./index-d13v9ckt.js";
 import"./index-5vwpzb5a.js";
-import"./index-ekpwvbra.js";
-import"./index-1xxnjn0d.js";
+import"./index-3rm7cz6h.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   verifyFrozenEvaluationSnapshot,

package/dist/graph-authority.js

@@ -5,17 +5,17 @@ import {
   queryGraph,
   rebuildGraph,
   verifyGraph
-} from "./index-bcfn9xah.js";
+} from "./index-xv80vzfp.js";
 import {
   GRAPH_LIMITS,
   GraphAuthorityError,
   validateGraphQueryRequest
-} from "./index-11621h23.js";
-import"./index-0k2x4nn9.js";
-import"./index-3rm7cz6h.js";
+} from "./index-tf4wzjew.js";
+import"./index-233z9wmn.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
-import"./index-ekpwvbra.js";
+import"./index-3rm7cz6h.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   verifyGraph,

package/dist/graph-percolation.js

@@ -1,15 +1,15 @@
 // @bun
 import {
   percolateWithGraph
-} from "./index-bgfzwt4h.js";
-import"./index-bcfn9xah.js";
-import"./index-11621h23.js";
-import"./index-0k2x4nn9.js";
-import"./index-nd6nynv2.js";
-import"./index-3rm7cz6h.js";
+} from "./index-djrcc1yf.js";
+import"./index-jk1sgx36.js";
+import"./index-xv80vzfp.js";
+import"./index-tf4wzjew.js";
+import"./index-233z9wmn.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
-import"./index-ekpwvbra.js";
+import"./index-3rm7cz6h.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   percolateWithGraph

package/dist/graph.js

@@ -18,7 +18,7 @@ import {
   replaceCatalog,
   searchableMarkdown,
   wikiLinks
-} from "./index-ekpwvbra.js";
+} from "./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   wikiLinks,

package/dist/{index-pbr6rv47.js → index-1k595z6v.js}

@@ -2,17 +2,17 @@
 import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase
-} from "./index-vdw5yjfa.js";
+} from "./index-q7tbg07z.js";
 import {
-  scanVault
-} from "./index-0k2x4nn9.js";
+  MAX_EVALUATION_EVIDENCE_BYTES,
+  redactEvaluationMachinePaths
+} from "./index-b88v3vtm.js";
 import {
   runGitCommand
 } from "./index-1gwbassd.js";
 import {
-  MAX_EVALUATION_EVIDENCE_BYTES,
-  redactEvaluationMachinePaths
-} from "./index-b88v3vtm.js";
+  scanVault
+} from "./index-233z9wmn.js";
 import {
   MAX_REPOSITORY_MEMORY_DETAIL_LIMIT,
   MAX_REPOSITORY_MEMORY_GROUP_LIMIT,

package/dist/{index-0k2x4nn9.js → index-233z9wmn.js}

@@ -8,7 +8,7 @@ import {
   parseNote,
   renderCatalog,
   replaceCatalog
-} from "./index-ekpwvbra.js";
+} from "./index-qbssx940.js";
 
 // src/vault.ts
 import { randomUUID } from "crypto";
@@ -334,12 +334,24 @@ async function snapshot(rootInput, options, writeIndex) {
     ...options.maxNoteBytes === undefined ? {} : { maxNoteBytes: options.maxNoteBytes },
     ...options.maxTotalBytes === undefined ? {} : { maxTotalBytes: options.maxTotalBytes }
   });
-  const indexRevision = await readIndexRevision(root, indexPath, options.maxNoteBytes ?? MAX_NOTE_UTF8_BYTES);
-  const currentIndex = indexRevision.content;
-  const indexNote = parseNote(vaultIndexPath, currentIndex);
-  const catalogMode = parsedCatalogMode(options.catalogMode, "ScanVaultOptions.catalogMode") ?? declaredCatalogMode(indexNote) ?? "managed";
+  const configuredCatalogMode = parsedCatalogMode(options.catalogMode, "ScanVaultOptions.catalogMode");
+  let indexRevision;
+  try {
+    indexRevision = await readIndexRevision(root, indexPath, options.maxNoteBytes ?? MAX_NOTE_UTF8_BYTES);
+  } catch (error) {
+    const absent = error instanceof Error && "code" in error && error.code === "ENOENT";
+    if (!absent || options.index !== undefined || configuredCatalogMode === "managed" || notes.some((note) => note.path === vaultIndexPath))
+      throw error;
+    if (writeIndex) {
+      throw new Error("Refresh requires an index.md front door. Add one with kb_catalog: authored to preserve its contents, or catalog markers for a managed catalog. Search and graph commands can read this folder without one.", { cause: error });
+    }
+  }
+  const currentIndex = indexRevision?.content ?? "";
+  const catalogMode = configuredCatalogMode ?? (indexRevision === undefined ? "authored" : declaredCatalogMode(parseNote(vaultIndexPath, currentIndex)) ?? "managed");
   let index = "authored";
   if (catalogMode === "managed") {
+    if (indexRevision === undefined)
+      throw new Error("A managed catalog requires an existing index file.");
     const expectedIndex = replaceCatalog(currentIndex, renderCatalog(notes, catalogNoteId));
     const stale = currentIndex !== expectedIndex;
     index = stale ? "stale" : "current";

package/dist/index-3agn8scn.js

@@ -0,0 +1,306 @@
+// @bun
+// src/publish-search.ts
+var PUBLISH_FIELD_TITLE = 1;
+var PUBLISH_FIELD_ALIAS = 2;
+var PUBLISH_FIELD_PATH = 4;
+var PUBLISH_FIELD_TAG = 8;
+var PUBLISH_FIELD_METADATA = 16;
+var PUBLISH_FIELD_CONTENT = 32;
+var PUBLISH_SEARCH_WEIGHTS_V1 = Object.freeze({
+  identity: Object.freeze({ title: 1000, alias: 950, path: 900 }),
+  phrase: Object.freeze({
+    title: 400,
+    alias: 350,
+    path: 300,
+    tag: 250,
+    content: 150,
+    metadata: 100
+  }),
+  term: Object.freeze({
+    title: 40,
+    alias: 35,
+    path: 30,
+    tag: 30,
+    metadata: 10,
+    content: 5
+  }),
+  coverage: 100
+});
+var MAX_PUBLISH_QUERY_BYTES = 16 * 1024;
+var MAX_PUBLISH_QUERY_TERMS = 64;
+var MAX_PUBLISH_PREFIX_EXPANSIONS = 32;
+var TERM_PATTERN = /[\p{L}\p{N}][\p{L}\p{N}._/-]*/gu;
+var textEncoder = new TextEncoder;
+function publishUtf8Bytes(value) {
+  return textEncoder.encode(value).byteLength;
+}
+function publishNormalize(value) {
+  return value.normalize("NFC").toLocaleLowerCase("en-US");
+}
+var MAX_PUBLISH_QUERY_FILTERS = 8;
+var FILTER_PATTERN = /^(tag|type|path):(\S+)$/u;
+function trimSlashes(value) {
+  let start = 0;
+  let end = value.length;
+  while (start < end && value.charCodeAt(start) === 47)
+    start += 1;
+  while (end > start && value.charCodeAt(end - 1) === 47)
+    end -= 1;
+  return value.slice(start, end);
+}
+function publishQueryParts(raw) {
+  const tags = [];
+  const types = [];
+  const paths = [];
+  const rest = [];
+  for (const token of raw.split(/\s+/u)) {
+    if (token === "")
+      continue;
+    const match = FILTER_PATTERN.exec(token);
+    const value = match === null ? "" : publishNormalize(trimSlashes(match[2] ?? ""));
+    if (match === null || value === "") {
+      rest.push(token);
+      continue;
+    }
+    const bucket = match[1] === "tag" ? tags : match[1] === "type" ? types : paths;
+    if (bucket.length < MAX_PUBLISH_QUERY_FILTERS)
+      bucket.push(value);
+    else
+      rest.push(token);
+  }
+  return { filters: { tags, types, paths }, text: rest.join(" ") };
+}
+function publishDocMatchesFilters(doc, filters, type) {
+  if (filters.tags.length > 0) {
+    const tags = doc.f.g === "" ? [] : doc.f.g.split(`
+`);
+    for (const tag of filters.tags) {
+      if (!tags.includes(publishNormalize(tag)))
+        return false;
+    }
+  }
+  if (filters.types.length > 0) {
+    const docType = publishNormalize(type === undefined || type === "" ? "note" : type);
+    for (const wanted of filters.types) {
+      if (docType !== publishNormalize(wanted))
+        return false;
+    }
+  }
+  if (filters.paths.length > 0) {
+    const slug = publishNormalize(doc.s);
+    const fields = doc.f.p === "" ? [] : doc.f.p.split(`
+`);
+    for (const value of filters.paths) {
+      const prefix = publishNormalize(trimSlashes(value));
+      const boundary = `${prefix}/`;
+      const inSlug = slug === prefix || slug.startsWith(boundary);
+      const inFields = fields.some((line) => line === prefix || line.startsWith(boundary));
+      if (!inSlug && !inFields)
+        return false;
+    }
+  }
+  return true;
+}
+var MAX_PUBLISH_MARK_RANGES = 32;
+function publishMarkRanges(text, terms, maximum = MAX_PUBLISH_MARK_RANGES) {
+  const display = text.normalize("NFC");
+  let normalized = "";
+  const map = [];
+  for (let offset = 0;offset < display.length; ) {
+    const point = display.codePointAt(offset) ?? 0;
+    const character = String.fromCodePoint(point);
+    const lowered = character.toLocaleLowerCase("en-US");
+    for (let index = 0;index < lowered.length; index += 1)
+      map.push(offset);
+    normalized += lowered;
+    offset += character.length;
+  }
+  const ranges = [];
+  for (const term of terms) {
+    const needle = publishNormalize(term);
+    if (needle === "")
+      continue;
+    let from = 0;
+    while (ranges.length < maximum) {
+      const hit = normalized.indexOf(needle, from);
+      if (hit === -1)
+        break;
+      const start = map[hit] ?? 0;
+      const tail = hit + needle.length;
+      const end = tail >= map.length ? display.length : map[tail] ?? display.length;
+      if (end > start)
+        ranges.push({ start, end });
+      from = tail === 0 ? 1 : tail;
+    }
+    if (ranges.length >= maximum)
+      break;
+  }
+  ranges.sort((left, right) => left.start - right.start || left.end - right.end);
+  const merged = [];
+  for (const range of ranges) {
+    const last = merged[merged.length - 1];
+    if (last !== undefined && range.start <= last.end) {
+      merged[merged.length - 1] = { start: last.start, end: Math.max(last.end, range.end) };
+    } else {
+      merged.push(range);
+    }
+  }
+  return merged;
+}
+function publishQuery(value) {
+  if (typeof value !== "string") {
+    throw new TypeError("Search query must be a string.");
+  }
+  if (publishUtf8Bytes(value) > MAX_PUBLISH_QUERY_BYTES) {
+    throw new RangeError(`Search query exceeds the ${MAX_PUBLISH_QUERY_BYTES}-byte limit.`);
+  }
+  const raw = value.trim();
+  const normalized = publishNormalize(raw);
+  const terms = [];
+  const seen = new Set;
+  for (const match of normalized.matchAll(TERM_PATTERN)) {
+    if (seen.has(match[0]))
+      continue;
+    seen.add(match[0]);
+    terms.push(match[0]);
+    if (terms.length > MAX_PUBLISH_QUERY_TERMS) {
+      throw new RangeError(`Search query may contain at most ${MAX_PUBLISH_QUERY_TERMS} unique normalized terms.`);
+    }
+  }
+  return { raw, normalized, terms };
+}
+function publishShardName(term) {
+  let hash = 2166136261;
+  for (let index = 0;index < term.length; index += 1) {
+    hash ^= term.charCodeAt(index);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return (hash >>> 24).toString(16).padStart(2, "0");
+}
+function publishPrefixTerms(dictionary, prefix, maximum = MAX_PUBLISH_PREFIX_EXPANSIONS) {
+  if (prefix === "")
+    return [];
+  let low = 0;
+  let high = dictionary.length;
+  while (low < high) {
+    const middle = low + high >> 1;
+    if ((dictionary[middle] ?? "") < prefix)
+      low = middle + 1;
+    else
+      high = middle;
+  }
+  const found = [];
+  for (let index = low;index < dictionary.length && found.length < maximum; index += 1) {
+    const term = dictionary[index] ?? "";
+    if (!term.startsWith(prefix))
+      break;
+    found.push(term);
+  }
+  return found;
+}
+function fieldMasks(term, fields) {
+  let mask = 0;
+  if (fields.t.includes(term))
+    mask |= PUBLISH_FIELD_TITLE;
+  if (fields.a.includes(term))
+    mask |= PUBLISH_FIELD_ALIAS;
+  if (fields.p.includes(term))
+    mask |= PUBLISH_FIELD_PATH;
+  if (fields.g.includes(term))
+    mask |= PUBLISH_FIELD_TAG;
+  if (fields.m.includes(term))
+    mask |= PUBLISH_FIELD_METADATA;
+  return mask;
+}
+function scorePublishDocument(input, query) {
+  const fields = input.doc.f;
+  const phrase = query.normalized;
+  const weights = PUBLISH_SEARCH_WEIGHTS_V1;
+  let score = 0;
+  let identity = false;
+  let phraseMatched = false;
+  if (phrase !== "") {
+    if (fields.t === phrase) {
+      identity = true;
+      score += weights.identity.title;
+    }
+    if (fields.a.split(`
+`).includes(phrase)) {
+      identity = true;
+      score += weights.identity.alias;
+    }
+    if (fields.p.split(`
+`).includes(phrase)) {
+      identity = true;
+      score += weights.identity.path;
+    }
+    const phraseFields = [
+      [PUBLISH_FIELD_TITLE, fields.t, weights.phrase.title],
+      [PUBLISH_FIELD_ALIAS, fields.a, weights.phrase.alias],
+      [PUBLISH_FIELD_PATH, fields.p, weights.phrase.path],
+      [PUBLISH_FIELD_TAG, fields.g, weights.phrase.tag],
+      [PUBLISH_FIELD_METADATA, fields.m, weights.phrase.metadata]
+    ];
+    for (const [, value, weight] of phraseFields) {
+      if (value.includes(phrase)) {
+        phraseMatched = true;
+        score += weight;
+      }
+    }
+    if (input.contentText !== undefined && input.contentText.includes(phrase)) {
+      phraseMatched = true;
+      score += weights.phrase.content;
+    }
+  }
+  let matchedTerms = 0;
+  for (const term of query.terms) {
+    const mask = fieldMasks(term, fields) | (input.contentTerms.has(term) ? PUBLISH_FIELD_CONTENT : 0);
+    if (mask === 0)
+      continue;
+    matchedTerms += 1;
+    if (mask & PUBLISH_FIELD_TITLE)
+      score += weights.term.title;
+    if (mask & PUBLISH_FIELD_ALIAS)
+      score += weights.term.alias;
+    if (mask & PUBLISH_FIELD_PATH)
+      score += weights.term.path;
+    if (mask & PUBLISH_FIELD_TAG)
+      score += weights.term.tag;
+    if (mask & PUBLISH_FIELD_METADATA)
+      score += weights.term.metadata;
+    if (mask & PUBLISH_FIELD_CONTENT)
+      score += weights.term.content;
+  }
+  const requiredTerms = query.terms.length <= 1 ? query.terms.length : Math.min(3, Math.ceil(query.terms.length / 2));
+  if (!identity && !phraseMatched && matchedTerms < requiredTerms)
+    return null;
+  if (query.terms.length > 0) {
+    score += Math.round(matchedTerms / query.terms.length * weights.coverage);
+  }
+  if (score === 0)
+    return null;
+  return { score, identity, phraseMatched, matchedTerms };
+}
+function comparePublishScores(left, right) {
+  return Number(right.identity) - Number(left.identity) || right.score - left.score || left.i - right.i;
+}
+function publishSnippet(text, query, fallback, windowBytes = 160) {
+  const normalized = publishNormalize(text);
+  let offset = query.normalized === "" ? -1 : normalized.indexOf(query.normalized);
+  if (offset < 0) {
+    for (const term of query.terms) {
+      offset = normalized.indexOf(term);
+      if (offset >= 0)
+        break;
+    }
+  }
+  if (offset < 0)
+    return fallback;
+  const half = Math.floor(windowBytes / 2);
+  const start = Math.max(0, offset - half);
+  const end = Math.min(text.length, offset + half);
+  const snippet = text.slice(start, end).replace(/\s+/gu, " ").trim();
+  return `${start > 0 ? "\u2026" : ""}${snippet}${end < text.length ? "\u2026" : ""}`;
+}
+
+export { PUBLISH_FIELD_TITLE, PUBLISH_FIELD_ALIAS, PUBLISH_FIELD_PATH, PUBLISH_FIELD_TAG, PUBLISH_FIELD_METADATA, PUBLISH_FIELD_CONTENT, PUBLISH_SEARCH_WEIGHTS_V1, MAX_PUBLISH_QUERY_BYTES, MAX_PUBLISH_QUERY_TERMS, MAX_PUBLISH_PREFIX_EXPANSIONS, publishUtf8Bytes, publishNormalize, MAX_PUBLISH_QUERY_FILTERS, publishQueryParts, publishDocMatchesFilters, MAX_PUBLISH_MARK_RANGES, publishMarkRanges, publishQuery, publishShardName, publishPrefixTerms, scorePublishDocument, comparePublishScores, publishSnippet };

package/dist/index-4knsp9qj.js

@@ -0,0 +1,34 @@
+// @bun
+// src/clip/package-root.ts
+import { existsSync, readFileSync } from "fs";
+import { createRequire } from "module";
+import { dirname, join, resolve } from "path";
+function isPackageManifest(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function findKbPackageRoot(startDirectory = import.meta.dir, dependencies = {}) {
+  const exists = dependencies.exists ?? existsSync;
+  const readText = dependencies.readText ?? ((path) => readFileSync(path, "utf8"));
+  let directory = resolve(startDirectory);
+  for (let depth = 0;depth < 8; depth += 1) {
+    const manifestPath = join(directory, "package.json");
+    if (exists(manifestPath)) {
+      try {
+        const parsed = JSON.parse(readText(manifestPath));
+        if (isPackageManifest(parsed) && typeof parsed.name === "string" && parsed.name === "@hraness/wordcell" && typeof parsed.version === "string")
+          return directory;
+      } catch {}
+    }
+    const parent = dirname(directory);
+    if (parent === directory)
+      break;
+    directory = parent;
+  }
+  throw new Error("Could not locate the wordcell package root.");
+}
+function resolvePackageDirectory(packageName, parentUrl = import.meta.url) {
+  const manifest = createRequire(parentUrl).resolve(`${packageName}/package.json`);
+  return dirname(manifest);
+}
+
+export { findKbPackageRoot, resolvePackageDirectory };