diffwiki-core 0.14.0 → 0.15.0-rc.202608040926.6b3b436

package/dist/bm25.cjs

@@ -76,6 +76,12 @@ function rankDocs(term, docs) {
     if (total > 0) scored.push({ ...d, score: total });
   }
   scored.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+  const max = scored[0]?.score ?? 0;
+  if (max > 0) {
+    for (const d of scored) {
+      if (typeof d.score === "number") d.score = Number((d.score / max).toFixed(4));
+    }
+  }
   return scored;
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/bm25.js

@@ -1,7 +1,7 @@
 import {
   rankDocs,
   tokenize
-} from "./chunk-FTUF6IXS.js";
+} from "./chunk-TK2373AM.js";
 export {
   rankDocs,
   tokenize

package/dist/chunk-6MW6KSS4.js

@@ -0,0 +1,278 @@
+// src/frontmatter.ts
+import matter from "gray-matter";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+var YAML_ENGINE = {
+  parse: (input) => {
+    const data = parseYaml(input);
+    return data && typeof data === "object" ? data : {};
+  },
+  stringify: (data) => stringifyYaml(data)
+};
+var MATTER_OPTS = { engines: { yaml: YAML_ENGINE } };
+function coerceAudience(value) {
+  return value === "private" || value === "system" ? value : "public";
+}
+function coerceStatus(value) {
+  return value === "draft" || value === "deprecated" ? value : "published";
+}
+function parseFallback(raw) {
+  const fenceRe = /^---[ \t]*\n([\s\S]*?)\n---[ \t]*\n/;
+  const fenceMatch = fenceRe.exec(raw);
+  let title = "";
+  let audience = "public";
+  let status = "published";
+  let body;
+  const clean = (s) => s.trim().replace(/^["']|["']$/g, "");
+  if (fenceMatch) {
+    const inner = fenceMatch[1];
+    const titleMatch = /^title:\s*(.+)$/m.exec(inner);
+    if (titleMatch) {
+      title = clean(titleMatch[1]);
+    }
+    const audienceMatch = /^audience:\s*(.+)$/m.exec(inner);
+    if (audienceMatch) {
+      audience = coerceAudience(clean(audienceMatch[1]));
+    }
+    const statusMatch = /^status:\s*(.+)$/m.exec(inner);
+    if (statusMatch) {
+      status = coerceStatus(clean(statusMatch[1]));
+    }
+    body = raw.slice(fenceMatch[0].length);
+  } else {
+    body = raw;
+  }
+  return { title, tags: [], audience, status, body: body.replace(/^\n+/, "") };
+}
+var FRONTMATTER_BLOCK_RE = /^\uFEFF?[ \t]*---\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/;
+function stripFrontmatter(raw) {
+  return raw.replace(FRONTMATTER_BLOCK_RE, "");
+}
+function parseFrontmatter(raw) {
+  try {
+    const { data, content } = matter(raw, MATTER_OPTS);
+    return { data: data ?? {}, body: content };
+  } catch {
+    return { data: {}, body: raw };
+  }
+}
+function parseArticle(raw) {
+  try {
+    const { data, content } = matter(raw, MATTER_OPTS);
+    const title = typeof data.title === "string" ? data.title : "";
+    const tags = Array.isArray(data.tags) ? data.tags.map((t) => String(t)) : [];
+    const created = typeof data.created === "string" ? data.created : void 0;
+    const audience = coerceAudience(data.audience);
+    const status = coerceStatus(data.status);
+    return { title, tags, created, audience, status, body: content.replace(/^\n+/, "") };
+  } catch {
+    return parseFallback(raw);
+  }
+}
+function serializeArticle(article) {
+  const front = { title: article.title, tags: article.tags };
+  if (article.audience === "private" || article.audience === "system") front.audience = article.audience;
+  if (article.status === "draft" || article.status === "deprecated") front.status = article.status;
+  return matter.stringify(article.body, front, MATTER_OPTS);
+}
+
+// src/plugins/sdk.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { existsSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var execFileAsync = promisify(execFile);
+async function runProcess(file, args, opts) {
+  const { stdout, stderr } = await execFileAsync(file, args, {
+    env: opts?.env,
+    timeout: opts?.timeout,
+    // Large: qmd emits multi-MB JSON search payloads that overflow the default 1 MB.
+    maxBuffer: 50 * 1024 * 1024
+  });
+  return { stdout, stderr };
+}
+async function runProcessJson(file, args, opts) {
+  const { stdout } = await runProcess(file, args, opts);
+  try {
+    return JSON.parse(stdout);
+  } catch {
+    throw new Error(`${file} ${args.join(" ")} did not return valid JSON: ${stdout.slice(0, 200)}`);
+  }
+}
+async function commandExists(name) {
+  try {
+    await execFileAsync(name, ["--version"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function resolveNpmBin(pkg, command, fromUrl) {
+  try {
+    let dir = dirname(fileURLToPath(fromUrl));
+    for (; ; ) {
+      const pkgJson = join(dir, "node_modules", pkg, "package.json");
+      if (existsSync(pkgJson)) {
+        const raw = JSON.parse(readFileSync(pkgJson, "utf8"));
+        const rel = typeof raw.bin === "string" ? raw.bin : raw.bin?.[command];
+        if (!rel) return null;
+        const binPath = join(dirname(pkgJson), rel);
+        return existsSync(binPath) ? binPath : null;
+      }
+      const parent = dirname(dir);
+      if (parent === dir) return null;
+      dir = parent;
+    }
+  } catch {
+    return null;
+  }
+}
+async function resolveDependency(dep, fromUrl) {
+  if (dep.npm) {
+    const local = resolveNpmBin(dep.npm, dep.command, fromUrl);
+    if (local) return { dependency: dep, command: [local], source: "npm" };
+  }
+  if (await commandExists(dep.command)) {
+    return { dependency: dep, command: [dep.command], source: "path" };
+  }
+  return { dependency: dep, command: null, source: "missing" };
+}
+async function ensureTool(spec, opts) {
+  const exists = opts?.exists ?? commandExists;
+  const run = opts?.run ?? ((file, args) => runProcess(file, args));
+  const log = opts?.log;
+  if (await exists(spec.command)) {
+    return { command: spec.command, present: true, installed: false, message: `${spec.command} present` };
+  }
+  if (!opts?.install) {
+    return {
+      command: spec.command,
+      present: false,
+      installed: false,
+      message: `${spec.command} not found \u2014 ${spec.manual}`
+    };
+  }
+  const attempts = [];
+  if (spec.mise && await exists("mise"))
+    attempts.push({ method: "mise", bin: "mise", args: ["use", "-g", spec.mise] });
+  if (spec.brew && await exists("brew")) attempts.push({ method: "brew", bin: "brew", args: ["install", spec.brew] });
+  for (const a of attempts) {
+    try {
+      log?.("info", `installing ${spec.command} via ${a.method}\u2026`);
+      await run(a.bin, a.args);
+      if (await exists(spec.command)) {
+        return {
+          command: spec.command,
+          present: true,
+          installed: true,
+          method: a.method,
+          message: `installed ${spec.command} via ${a.method}`
+        };
+      }
+      return {
+        command: spec.command,
+        present: false,
+        installed: true,
+        method: a.method,
+        message: `installed ${spec.command} via ${a.method}, but it isn't on PATH yet \u2014 restart your shell (or activate ${a.method}) and retry`
+      };
+    } catch (err) {
+      log?.("warn", `${a.method} could not install ${spec.command}: ${err.message}`);
+    }
+  }
+  const aptHint = spec.apt ? ` (Debian/Ubuntu: sudo apt-get install -y ${spec.apt})` : "";
+  return {
+    command: spec.command,
+    present: false,
+    installed: false,
+    message: `could not auto-install ${spec.command} \u2014 ${spec.manual}${aptHint}`
+  };
+}
+function definePlugin(def) {
+  const { name, kind, version, capabilities, dependencies, handlers } = def;
+  const describeResult = {
+    name,
+    kind,
+    version,
+    capabilities: {
+      searchTypes: capabilities.searchTypes,
+      collectionFilter: capabilities.collectionFilter,
+      events: capabilities.events
+    },
+    dependencies: (dependencies ?? []).map((d) => ({ command: d.command, npm: d.npm, hint: d.hint }))
+  };
+  async function dispatch(op, params, log) {
+    switch (op) {
+      case "describe":
+        return describeResult;
+      case "search":
+        return handlers.search(params, log);
+      case "index":
+        if (handlers.index) return handlers.index(params, log);
+        return { indexed: 0 };
+      case "setup":
+        if (handlers.setup) return handlers.setup(params, log);
+        return { ready: true };
+      case "event":
+        if (handlers.onEvent) return handlers.onEvent(params, log);
+        return { accepted: true };
+      case "health":
+        if (handlers.health) return handlers.health(params, log);
+        return { ready: true, diagnostics: [] };
+      default:
+        throw new Error(`unknown op: ${op}`);
+    }
+  }
+  function run() {
+    const log = (level, message) => {
+      process.stderr.write(JSON.stringify({ log: { level, message } }) + "\n");
+    };
+    let buffer = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      buffer += chunk;
+    });
+    process.stdin.on("end", () => {
+      const line = buffer.trim();
+      if (!line) {
+        process.stderr.write(`${name}: no input received on stdin
+`);
+        process.exit(1);
+        return;
+      }
+      let req;
+      try {
+        req = JSON.parse(line);
+      } catch {
+        process.stderr.write(`${name}: malformed JSON on stdin: ${line.slice(0, 200)}
+`);
+        process.exit(1);
+        return;
+      }
+      dispatch(req.op, req.params ?? {}, log).then((result) => {
+        const response = { ok: true, result };
+        process.stdout.write(JSON.stringify(response) + "\n");
+        process.exit(0);
+      }).catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        const response = { ok: false, error: { message } };
+        process.stdout.write(JSON.stringify(response) + "\n");
+        process.exit(1);
+      });
+    });
+  }
+  return { definition: def, run };
+}
+
+export {
+  stripFrontmatter,
+  parseFrontmatter,
+  parseArticle,
+  serializeArticle,
+  runProcess,
+  runProcessJson,
+  commandExists,
+  resolveDependency,
+  ensureTool,
+  definePlugin
+};

package/dist/{chunk-FTUF6IXS.js → chunk-TK2373AM.js}

@@ -51,6 +51,12 @@ function rankDocs(term, docs) {
     if (total > 0) scored.push({ ...d, score: total });
   }
   scored.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+  const max = scored[0]?.score ?? 0;
+  if (max > 0) {
+    for (const d of scored) {
+      if (typeof d.score === "number") d.score = Number((d.score / max).toFixed(4));
+    }
+  }
   return scored;
 }
 

package/dist/{chunk-7V2DIQNL.js → chunk-TXM4OGBA.js}

@@ -17,6 +17,9 @@ function configPath() {
 function collectionsDir() {
   return path.join(resolveHome(), "collections");
 }
+function templatesDir() {
+  return path.join(resolveHome(), "templates");
+}
 function collectionDir(name) {
   return path.join(collectionsDir(), name);
 }
@@ -116,7 +119,7 @@ ${problems.map((p) => `  - ${p}`).join("\n")}`);
 // src/collections.ts
 async function fireHook(event, collection) {
   try {
-    const { emitPluginEvent: emitPluginEvent2 } = await import("./events-AVD3G5AX.js");
+    const { emitPluginEvent: emitPluginEvent2 } = await import("./events-K3MKWACA.js");
     await emitPluginEvent2(event, collection);
   } catch {
   }
@@ -351,7 +354,11 @@ function mapHits(result, collections) {
       tags: Array.isArray(h.tags) ? h.tags.filter((t) => typeof t === "string") : [],
       snippet: typeof h.snippet === "string" ? h.snippet : void 0,
       score: typeof h.score === "number" ? h.score : void 0,
-      docid: typeof h.docid === "string" ? h.docid : void 0
+      docid: typeof h.docid === "string" ? h.docid : void 0,
+      rawChunk: typeof h.rawChunk === "string" ? h.rawChunk : void 0,
+      cleanedChunk: typeof h.cleanedChunk === "string" ? h.cleanedChunk : void 0,
+      line: typeof h.line === "number" ? h.line : void 0,
+      snippetFromBody: h.snippetFromBody === true ? true : void 0
     });
   }
   return out;
@@ -381,7 +388,8 @@ async function loadSearchProvider(name) {
           collections: toWireCollections(collections),
           collection: opts?.collection,
           type: opts?.type,
-          limit: opts?.limit
+          limit: opts?.limit,
+          expansions: opts?.expansions
         },
         { timeoutMs: SEARCH_TIMEOUT_MS, name: record.name }
       );
@@ -479,6 +487,7 @@ export {
   registryPath,
   configPath,
   collectionsDir,
+  templatesDir,
   collectionDir,
   pluginsDir,
   pluginsRegistryPath,

package/dist/{events-AVD3G5AX.js → events-K3MKWACA.js}

@@ -1,6 +1,6 @@
 import {
   emitPluginEvent
-} from "./chunk-7V2DIQNL.js";
+} from "./chunk-TXM4OGBA.js";
 export {
   emitPluginEvent
 };