@hraness/wordcell 0.24.1 → 0.25.0

package/README.md

@@ -54,14 +54,14 @@ Wordcell keeps the record in Markdown files you own, rebuilds every index from t
 The CLI and TypeScript SDK run with Bun. Install the versioned GitHub archive:
 
 ```sh
-bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz
+bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.25.0/hraness-wordcell-0.25.0.tgz
 wordcell --help
 ```
 
 Prefer npm? The same release is [mirrored there](https://www.npmjs.com/package/@hraness/wordcell):
 
 ```sh
-npm install --global --ignore-scripts @hraness/wordcell@0.24.1
+npm install --global --ignore-scripts @hraness/wordcell@0.25.0
 wordcell --help
 ```
 
@@ -103,7 +103,7 @@ After trying the CLI, install the public Agent Skill into a compatible agent,
 such as Claude Code, Codex, Cursor, or GitHub Copilot:
 
 ```sh
-bunx skills add hraness/wordcell#v0.24.1 --skill wordcell
+bunx skills add hraness/wordcell#v0.25.0 --skill wordcell
 ```
 
 Then ask:
@@ -334,7 +334,7 @@ exist. [Graph queries and proof limits](https://github.com/hraness/wordcell/blob
 Add the same immutable release to a Bun project:
 
 ```sh
-bun add --exact --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz
+bun add --exact --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.25.0/hraness-wordcell-0.25.0.tgz
 ```
 
 The SDK provides read-only vault sessions, metadata queries, search, graph

package/dist/capture.js

@@ -5,8 +5,8 @@ import {
   captureSummary,
   main,
   runCapture
-} from "./index-2fmnttca.js";
-import"./index-6jcz0m1c.js";
+} from "./index-t3abkwk4.js";
+import"./index-hxyjer3x.js";
 import"./index-k86wepd8.js";
 import {
   adapterCapabilities,

package/dist/cli.js

@@ -6,13 +6,13 @@ import {
   parseArguments,
   runExecutable,
   usage
-} from "./index-jqkkb4fr.js";
-import"./index-t0fh8a1q.js";
+} from "./index-1wccy765.js";
+import"./index-47893rgw.js";
 import"./index-qfqjfxaa.js";
 import"./index-hz2wyggk.js";
 import"./index-j4zgmzjr.js";
-import"./index-2fmnttca.js";
-import"./index-6jcz0m1c.js";
+import"./index-t3abkwk4.js";
+import"./index-hxyjer3x.js";
 import"./index-k86wepd8.js";
 import"./index-nwrehke7.js";
 import"./index-5n05se68.js";
@@ -63,7 +63,7 @@ import {
 
 // src/cli.ts
 if (import.meta.main) {
-  const { standaloneSupportEnvironment, isUsefulSupportResult, runProductSupportCommand, showProductSupportInvitation } = await import("./support-07jpt1z4.js");
+  const { standaloneSupportEnvironment, isUsefulSupportResult, runProductSupportCommand, showProductSupportInvitation } = await import("./support-adj7bbge.js");
   const env = standaloneSupportEnvironment();
   const args = process.argv.slice(2);
   if (args[0] === "support") {

package/dist/clip/cli.js

@@ -5,8 +5,8 @@ import {
   captureSucceeded,
   captureSummary,
   main
-} from "../index-2fmnttca.js";
-import"../index-6jcz0m1c.js";
+} from "../index-t3abkwk4.js";
+import"../index-hxyjer3x.js";
 import"../index-k86wepd8.js";
 import"../index-nwrehke7.js";
 import"../index-5n05se68.js";

package/dist/clip/defuddle-worker.js

@@ -1,6 +1,90 @@
 // @bun
+import"../index-z1w83f81.js";
+
 // src/clip/defuddle-worker.ts
 import { Defuddle } from "defuddle/node";
+
+// src/clip/embedded-article.ts
+var EMBEDDED_ARTICLE_LIMITS = Object.freeze({ htmlBytes: 8 * 1024 * 1024, scripts: 64, jsonBytes: 256 * 1024, bodyBytes: 192 * 1024, depth: 8 });
+function shallowJson(value) {
+  let depth = 0, quoted = false, escaped = false;
+  for (const char of value) {
+    if (quoted) {
+      if (escaped)
+        escaped = false;
+      else if (char === "\\")
+        escaped = true;
+      else if (char === '"')
+        quoted = false;
+    } else if (char === '"')
+      quoted = true;
+    else if (char === "{" || char === "[") {
+      if (++depth > EMBEDDED_ARTICLE_LIMITS.depth)
+        return false;
+    } else if (char === "}" || char === "]")
+      depth--;
+  }
+  return !quoted && depth === 0;
+}
+var escapeText = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+async function embeddedArticleHtml(html, sourceUrl) {
+  if (Buffer.byteLength(html) > EMBEDDED_ARTICLE_LIMITS.htmlBytes)
+    return null;
+  let source;
+  try {
+    source = new URL(sourceUrl);
+  } catch {
+    return null;
+  }
+  if (!/^https?:$/.test(source.protocol) || source.username || source.password)
+    return null;
+  source.hash = "";
+  let scripts = 0, candidates = 0, active = false, invalid = false, payload = "";
+  const rewriter = new HTMLRewriter().on("script", {
+    element(element) {
+      if (++scripts > EMBEDDED_ARTICLE_LIMITS.scripts)
+        invalid = true;
+      active = element.getAttribute("id") === "jsonArticle";
+      if (!active)
+        return;
+      candidates++;
+      if (element.getAttribute("type")?.toLowerCase() !== "application/json" || element.hasAttribute("src"))
+        invalid = true;
+    },
+    text(chunk) {
+      if (!active || invalid)
+        return;
+      payload += chunk.text;
+      if (Buffer.byteLength(payload) > EMBEDDED_ARTICLE_LIMITS.jsonBytes)
+        invalid = true;
+    }
+  });
+  await rewriter.transform(new Response(html)).text();
+  if (invalid || candidates !== 1 || !shallowJson(payload))
+    return null;
+  let value;
+  try {
+    value = JSON.parse(payload);
+  } catch {
+    return null;
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return null;
+  const row = value;
+  if (Object.keys(row).length > 128 || row.dataType !== "Article" || !Number.isSafeInteger(row.dataId) || row.dataId <= 0 || typeof row.urlArticle !== "string" || row.urlArticle.length > 8192 || typeof row.title !== "string" || !row.title.trim() || Buffer.byteLength(row.title) > 4096 || typeof row.body !== "string" || !row.body.trim() || Buffer.byteLength(row.body) > EMBEDDED_ARTICLE_LIMITS.bodyBytes)
+    return null;
+  let article;
+  try {
+    article = new URL(row.urlArticle, source);
+  } catch {
+    return null;
+  }
+  if (article.username || article.password || article.hash || article.href !== source.href || article.pathname.split("/").filter(Boolean).at(-1) !== String(row.dataId))
+    return null;
+  return `<!doctype html><html><head><title>${escapeText(row.title)}</title></head><body><article><h1>${escapeText(row.title)}</h1>${row.body}</article></body></html>`;
+}
+
+// src/clip/defuddle-worker.ts
 var workerGlobal = globalThis;
 function asciiCaseEqualAt(value, offset, expected, end = value.length) {
   if (offset < 0 || offset + expected.length > end)
@@ -68,8 +152,9 @@ workerGlobal.onmessage = async (event) => {
     return;
   }
   try {
-    const videoPosters = collectVideoPosters(request.html);
-    const value = await Defuddle(request.html, request.url, {
+    const extractionHtml = request.includeReplies === false ? await embeddedArticleHtml(request.html, request.url) ?? request.html : request.html;
+    const videoPosters = collectVideoPosters(extractionHtml);
+    const value = await Defuddle(extractionHtml, request.url, {
       markdown: false,
       separateMarkdown: true,
       includeReplies: request.includeReplies,

package/dist/{index-jqkkb4fr.js → index-1wccy765.js}

@@ -3,7 +3,7 @@ import {
   backfillSavedUrlMetadata,
   createRustMetadataSearchProvider,
   savedSourceProblem
-} from "./index-t0fh8a1q.js";
+} from "./index-47893rgw.js";
 import {
   main as main2
 } from "./index-qfqjfxaa.js";
@@ -19,7 +19,7 @@ import {
 } from "./index-j4zgmzjr.js";
 import {
   main
-} from "./index-2fmnttca.js";
+} from "./index-t3abkwk4.js";
 import {
   detectAudience,
   renderFailure,
@@ -7879,7 +7879,7 @@ async function main4(rawArguments = process.argv.slice(2), output = defaultOutpu
   }
   try {
     if (command.kind === "clip") {
-      return await (dependencies.runClipCommand ?? main)(command.arguments, process.env, output);
+      return await (dependencies.runClipCommand ?? main)(command.arguments, terminal.env, output);
     }
     if (command.kind === "capture-bundle")
       return await runCaptureBundle(command, output, dependencies);
@@ -7890,10 +7890,10 @@ async function main4(rawArguments = process.argv.slice(2), output = defaultOutpu
     if (command.kind === "portfolio-audit")
       return await runPortfolioAudit(command, output, dependencies);
     if (command.kind === "url-metadata") {
-      return await (dependencies.runUrlMetadataCommand ?? main3)(command.arguments, process.env, output);
+      return await (dependencies.runUrlMetadataCommand ?? main3)(command.arguments, terminal.env, output);
     }
     if (command.kind === "pdf") {
-      return await (dependencies.runPdfCommand ?? main2)(command.arguments, process.env, output);
+      return await (dependencies.runPdfCommand ?? main2)(command.arguments, terminal.env, output);
     }
     if (command.kind === "init") {
       return await runInit(command, output, dependencies.initVault ?? initVault, dependencies.terminal ?? processTerminal());

package/dist/{index-t0fh8a1q.js → index-47893rgw.js}

@@ -5,7 +5,7 @@ import {
   parseArchiveTodayMementoUrl,
   parseMetadataSearchResponse,
   rankMetadataSearchResults
-} from "./index-6jcz0m1c.js";
+} from "./index-hxyjer3x.js";
 import {
   assertSafeNetworkUrl,
   isPrivateHostname,
@@ -314,11 +314,12 @@ function deterministicResponse(response, maximumResults) {
     results: Object.freeze(results),
     enginesQueried,
     enginesFailed: Object.freeze([...response.enginesFailed].sort()),
-    engineStatus: response.engineStatus
+    engineStatus: response.engineStatus,
+    ...response.engineFailures === undefined ? {} : { engineFailures: Object.freeze([...response.engineFailures].sort((a, b) => compareText(a.engine, b.engine))) }
   });
 }
-async function resolveEngineHosts(resolver, timeoutMs) {
-  const resolved = await Promise.all(METADATA_SEARCH_ENGINE_HOSTS.map(async (hostname) => {
+async function resolveEngineHosts(resolver, timeoutMs, enableBingRss, enableOpenAlexDiscovery) {
+  const resolved = await Promise.all([...METADATA_SEARCH_ENGINE_HOSTS, ...enableBingRss ? ["www.bing.com"] : [], ...enableOpenAlexDiscovery ? ["api.openalex.org"] : []].map(async (hostname) => {
     const addresses = await resolver(new URL(`https://${hostname}/`), {
       allowPrivateNetwork: false,
       timeoutMs
@@ -364,6 +365,12 @@ function createExactUrlSearchQuery(value) {
   return `"${exactUrl}"`;
 }
 function createRustMetadataSearchProvider(options) {
+  if (options.enableBingRss !== undefined && typeof options.enableBingRss !== "boolean")
+    throw new TypeError("enableBingRss must be boolean.");
+  const enableBingRss = options.enableBingRss === true;
+  if (options.enableOpenAlexDiscovery !== undefined && typeof options.enableOpenAlexDiscovery !== "boolean")
+    throw new TypeError("enableOpenAlexDiscovery must be boolean.");
+  const enableOpenAlexDiscovery = options.enableOpenAlexDiscovery === true;
   if (!isAbsolute(options.binaryPath)) {
     throw new TypeError("The metadata search binary path must be absolute.");
   }
@@ -389,7 +396,7 @@ function createRustMetadataSearchProvider(options) {
       return failure("aborted", "Metadata search was aborted.");
     let engineHosts;
     try {
-      engineHosts = await resolveEngineHosts(resolveNetworkTarget, validated.timeoutMs);
+      engineHosts = await resolveEngineHosts(resolveNetworkTarget, validated.timeoutMs, enableBingRss, enableOpenAlexDiscovery);
     } catch {
       return failure("unavailable", "Metadata search network targets are unavailable.");
     }
@@ -413,6 +420,9 @@ function createRustMetadataSearchProvider(options) {
     try {
       const input = JSON.stringify({
         schema_version: REQUEST_SCHEMA_VERSION,
+        diagnostics: true,
+        ...enableBingRss ? { bing_rss: true } : {},
+        ...enableOpenAlexDiscovery ? { openalex_discovery: true } : {},
         query: validated.query,
         max_results: validated.maxResults,
         timeout_ms: validated.timeoutMs,

package/dist/{index-6jcz0m1c.js → index-hxyjer3x.js}

@@ -30,6 +30,25 @@ var ARCHIVE_TODAY_HOSTS = Object.freeze([
   "archive.md",
   "archive.vn"
 ]);
+var METADATA_SEARCH_FAILURE_CODES = [
+  "timeout",
+  "http",
+  "http-body",
+  "http-status",
+  "http-forbidden",
+  "http-rate-limited",
+  "http-redirect",
+  "parse",
+  "unverified-empty",
+  "challenge",
+  "content-type",
+  "content-encoding",
+  "body-limit",
+  "body-encoding",
+  "result-limit",
+  "unrecognized-html",
+  "query-mismatch"
+];
 var archiveTodayHosts = new Set(ARCHIVE_TODAY_HOSTS);
 var tokenCharacter = /^[!#$%&'*+.^_`|~0-9A-Za-z-]$/u;
 var engineName = /^[a-z0-9][a-z0-9._-]{0,127}$/u;
@@ -140,7 +159,7 @@ function parseMetadataResult(value, index, queried, failed, budget) {
 }
 function parseMetadataSearchResponse(value) {
   const input = record(value, "Metadata search response");
-  strictKeys(input, ["query", "results", "engines_queried", "engines_failed"], "Metadata search response");
+  strictKeys(input, ["query", "results", "engines_queried", "engines_failed", "engine_failures", "engine_usage"], "Metadata search response");
   const budget = { bytes: 0 };
   const query = boundedString(input.query, "Metadata search response.query", MAX_METADATA_SEARCH_QUERY_UTF8_BYTES, budget);
   if (query === "" || query !== query.trim() || hasUnsafeControls(query)) {
@@ -157,12 +176,44 @@ function parseMetadataSearchResponse(value) {
     fail("Metadata search response.results", `must be an array with at most ${MAX_METADATA_SEARCH_RESULTS} entries.`);
   }
   const failed = new Set(enginesFailed);
+  let engineFailures;
+  if (Object.hasOwn(input, "engine_failures")) {
+    if (!Array.isArray(input.engine_failures) || input.engine_failures.length !== enginesFailed.length) {
+      fail("Metadata search response.engine_failures", "must cover every failed engine exactly once.");
+    }
+    const seen = new Set;
+    engineFailures = Object.freeze(input.engine_failures.map((value2, index) => {
+      const label = `Metadata search response.engine_failures[${index}]`;
+      const entry = record(value2, label);
+      strictKeys(entry, ["engine", "code"], label);
+      if (typeof entry.engine !== "string" || !failed.has(entry.engine) || seen.has(entry.engine)) {
+        fail(label, "must name a unique failed, queried engine.");
+      }
+      if (typeof entry.code !== "string" || !METADATA_SEARCH_FAILURE_CODES.some((code) => code === entry.code)) {
+        fail(label, "must contain a known categorical failure code.");
+      }
+      seen.add(entry.engine);
+      return Object.freeze({ engine: entry.engine, code: entry.code });
+    }));
+  }
   const results = Object.freeze(input.results.map((result, index) => parseMetadataResult(result, index, queried, failed, budget)));
+  let engineUsage;
+  if (Object.hasOwn(input, "engine_usage")) {
+    if (!Array.isArray(input.engine_usage) || input.engine_usage.length !== 1)
+      fail("Metadata search response.engine_usage", "must contain one bounded OpenAlex usage record.");
+    const entry = record(input.engine_usage[0], "engine usage");
+    strictKeys(entry, ["engine", "reported_cost_usd", "billing_status"], "engine usage");
+    if (entry.engine !== "openalex" || !enginesQueried.includes("openalex") || failed.has("openalex") || typeof entry.reported_cost_usd !== "number" || !Number.isFinite(entry.reported_cost_usd) || entry.reported_cost_usd < 0 || entry.reported_cost_usd > 1e6 || entry.billing_status !== "not-established")
+      fail("engine usage", "must preserve bounded provider-reported usage without asserting billing.");
+    engineUsage = Object.freeze([Object.freeze({ engine: "openalex", reportedCostUsd: entry.reported_cost_usd, billingStatus: "not-established" })]);
+  }
   return Object.freeze({
     query,
     results,
     enginesQueried,
     enginesFailed,
+    ...engineFailures === undefined ? {} : { engineFailures },
+    ...engineUsage === undefined ? {} : { engineUsage },
     engineStatus: enginesFailed.length === 0 ? "complete" : enginesFailed.length === enginesQueried.length ? "unavailable" : "partial"
   });
 }

package/dist/{index-2fmnttca.js → index-t3abkwk4.js}

@@ -2,7 +2,7 @@
 import {
   acquireArchiveTodaySnapshot,
   discoverArchiveTodaySnapshot
-} from "./index-6jcz0m1c.js";
+} from "./index-hxyjer3x.js";
 import {
   canonicalizeUrl,
   chooseBestExtraction,

package/dist/{support-07jpt1z4.js → support-adj7bbge.js}

@@ -2,15 +2,15 @@
 import {
   parseArguments as parseArguments2,
   parseUrlMetadataArguments
-} from "./index-jqkkb4fr.js";
-import"./index-t0fh8a1q.js";
+} from "./index-1wccy765.js";
+import"./index-47893rgw.js";
 import {
   parsePdfArguments
 } from "./index-qfqjfxaa.js";
 import"./index-hz2wyggk.js";
 import"./index-j4zgmzjr.js";
-import"./index-2fmnttca.js";
-import"./index-6jcz0m1c.js";
+import"./index-t3abkwk4.js";
+import"./index-hxyjer3x.js";
 import"./index-k86wepd8.js";
 import"./index-nwrehke7.js";
 import"./index-5n05se68.js";

package/dist/url-intelligence.js

@@ -10,7 +10,7 @@ import {
   readUrlMetadataDocument,
   renderUrlMetadataDocument,
   writeUrlMetadataDocument
-} from "./index-t0fh8a1q.js";
+} from "./index-47893rgw.js";
 import {
   ARCHIVE_TODAY_HOSTS,
   ArchiveTodayFailure,
@@ -23,7 +23,7 @@ import {
   parseMetadataSearchResponse,
   rankMetadataSearchResults,
   selectNewestArchiveTodayMemento
-} from "./index-6jcz0m1c.js";
+} from "./index-hxyjer3x.js";
 import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
 import"./index-mxxxytys.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/wordcell",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "description": "Wordcell keeps decisions, plans, and sources as Markdown beside your code, so coding agents can find them from the file they are about to change.",
   "license": "MIT",
   "type": "module",
@@ -369,6 +369,8 @@
     "src/clip/metadata-search-tool/runner.ts",
     "src/clip/metadata-search-tool/src/main.rs",
     "src/clip/metadata-search-tool/src/duckduckgo.rs",
+    "src/clip/metadata-search-tool/src/bing.rs",
+    "src/clip/metadata-search-tool/src/openalex.rs",
     "src/git.ts",
     "src/evaluation-analysis-v2.ts",
     "src/evaluation-builder.ts",
@@ -473,10 +475,10 @@
     "src/directory-sync.ts"
   ],
   "scripts": {
-    "kb:refresh": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell refresh --root kb",
-    "kb:check:lane": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell check --root kb --no-catalog",
-    "kb:check": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell check --root kb && bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell agents check --root kb --repo .",
-    "kb:catalog": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell catalog --root kb",
+    "kb:refresh": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell refresh --root kb",
+    "kb:check:lane": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell check --root kb --no-catalog",
+    "kb:check": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell check --root kb && bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell agents check --root kb --repo .",
+    "kb:catalog": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell catalog --root kb",
     "build": "bun -e 'await (await import(\"node:fs/promises\")).rm(\"./dist\", { recursive: true, force: true })' && bun build ./src/index.ts ./src/publish.ts ./src/publish-model.ts ./src/publish-search.ts ./src/agent-context.ts ./src/agent-guide-audit.ts ./src/attachments.ts ./src/authoring.ts ./src/benchmark.ts ./src/clip/browser-profiles.ts ./src/capture.ts ./src/cli.ts ./src/clip/acquire.ts ./src/clip/args.ts ./src/clip/bounded-byte-buffer.ts ./src/clip/bundle-reader.ts ./src/clip/cli.ts ./src/clip/cookies.ts ./src/clip/doctor.ts ./src/clip/jobs.ts ./src/clip/network.ts ./src/clip/network-proxy.ts ./src/clip/persist.ts ./src/clip/refresh.ts ./src/clip/terminal.ts ./src/evaluation.ts ./src/evaluation-builder.ts ./src/evaluation-kb.ts ./src/git.ts ./src/graph.ts ./src/graph-percolation.ts ./src/graph-authority.ts ./src/navigation.ts ./src/pdf.ts ./src/percolate.ts ./src/portfolio.ts ./src/query.ts ./src/rerank.ts ./src/rerank-typesafe.ts ./src/repository-memory.ts ./src/sdk.ts ./src/search.ts ./src/search-rules.ts ./src/semantic.ts ./src/source-inbox.ts ./src/untrusted-content.ts ./src/url-intelligence.ts ./src/workflow.ts ./src/workflows/index.ts ./src/workflows/decision-context.ts ./src/workflows/explain-change.ts ./src/workflows/plan-radar.ts ./src/clip/defuddle-worker.ts --outdir ./dist --root ./src --target bun --format esm --splitting --packages external && bun build ./src/publish-reader/reader.ts --outfile ./dist/publish-reader/reader.js --target browser --format esm && bun build ./src/publish-reader/theme.ts --outfile ./dist/publish-reader/theme.js --target browser --format iife && cp ./src/publish-reader/reader.css ./dist/publish-reader/reader.css",
     "check:workflows": "bun ./scripts/check-workflow-yaml.ts",
     "check:installed-command-docs": "bun ./scripts/check-installed-command-docs.ts",
@@ -491,8 +493,8 @@
     "check": "bun run check:worker && bun run check:effect && bun run check:workflows && bun run check:portfolio-inventory && bun run check:installed-command-docs && bun run typecheck && bun run build && bun run test:package && bun run test && bun run url-metadata:tool:check",
     "prepack": "bun run check",
     "check:effect": "bun run scripts/check-effect-policy.ts",
-    "kb:search": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell search --root kb --mode exact --selected-passage --rerank typesafe --rerank-limit 25",
-    "kb:search:local": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.0/hraness-wordcell-0.24.0.tgz wordcell search --root kb --mode exact --selected-passage",
+    "kb:search": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell search --root kb --mode exact --selected-passage --rerank typesafe --rerank-limit 25",
+    "kb:search:local": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell search --root kb --mode exact --selected-passage",
     "check:worker": "tsc -p worker/tsconfig.json --noEmit"
   },
   "dependencies": {

package/skills/wordcell/SKILL.md

@@ -58,7 +58,7 @@ missing:
 ```sh
 command -v wordcell >/dev/null 2>&1 || {
   command -v bun >/dev/null 2>&1 || exit 1
-  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz
+  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.25.0/hraness-wordcell-0.25.0.tgz
 }
 wordcell --help
 ```

package/src/cli-program.ts

@@ -4500,17 +4500,17 @@ export async function main(
   }
   try {
     if (command.kind === "clip") {
-      return await (dependencies.runClipCommand ?? runClipCommand)(command.arguments, process.env, output);
+      return await (dependencies.runClipCommand ?? runClipCommand)(command.arguments, terminal.env, output);
     }
     if (command.kind === "capture-bundle") return await runCaptureBundle(command, output, dependencies);
     if (command.kind === "capture-diff") return await runCaptureDiff(command, output, dependencies);
     if (command.kind === "portfolio-search") return await runPortfolioSearch(command, output, dependencies);
     if (command.kind === "portfolio-audit") return await runPortfolioAudit(command, output, dependencies);
     if (command.kind === "url-metadata") {
-      return await (dependencies.runUrlMetadataCommand ?? runUrlMetadataCommand)(command.arguments, process.env, output);
+      return await (dependencies.runUrlMetadataCommand ?? runUrlMetadataCommand)(command.arguments, terminal.env, output);
     }
     if (command.kind === "pdf") {
-      return await (dependencies.runPdfCommand ?? runPdfCommand)(command.arguments, process.env, output);
+      return await (dependencies.runPdfCommand ?? runPdfCommand)(command.arguments, terminal.env, output);
     }
     if (command.kind === "init") {
       return await runInit(command, output, dependencies.initVault ?? initVault, dependencies.terminal ?? processTerminal());

package/src/clip/metadata-search-tool/Cargo.lock

@@ -896,6 +896,7 @@ version = "0.1.0"
 dependencies = [
  "libc",
  "metadata-search-engine-rs",
+ "quick-xml",
  "reqwest",
  "scraper",
  "serde",
@@ -1311,6 +1312,15 @@ dependencies = [
  "psl-types",
 ]
 
+[[package]]
+name = "quick-xml"
+version = "0.42.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41b1177fdf999d2321d3fb46ff47159d9c1fb9ad66a4879f8c50a0b504615e9b"
+dependencies = [
+ "memchr",
+]
+
 [[package]]
 name = "quote"
 version = "1.0.47"

package/src/clip/metadata-search-tool/Cargo.toml

@@ -9,6 +9,7 @@ metadata-search-engine-rs = { git = "https://github.com/MikeLuu99/searxng-rust",
 libc = "=0.2.189"
 reqwest = { version = "=0.12.28", features = ["brotli", "cookies", "gzip"] }
 scraper = "=0.20.0"
+quick-xml = "=0.42.0"
 url = "=2.5.8"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"