@hraness/wordcell 0.24.0 → 0.25.0

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-f184qyh1.js → index-hz2wyggk.js}

@@ -5,7 +5,7 @@ import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase,
   validateKnowledgeBaseSearchHistory
-} from "./index-5d1rd5v9.js";
+} from "./index-mcpppwbq.js";
 import {
   expandSearchRequest,
   parseSearchRules

package/dist/{index-5d1rd5v9.js → index-mcpppwbq.js}

@@ -19,10 +19,10 @@ import {
 } from "./index-j70m75wd.js";
 import {
   percolateWithGraph
-} from "./index-tcaq1c7f.js";
+} from "./index-e26mdwxz.js";
 import {
   openGraphAuthority
-} from "./index-1er88ckw.js";
+} from "./index-3gc2yk4k.js";
 import {
   validateGraphPercolationOptions,
   validateGraphQueryRequest

package/dist/index-qkesh4c6.js

@@ -0,0 +1,7 @@
+// @bun
+// src/directory-sync.ts
+function syncsDirectories(platform = process.platform) {
+  return platform !== "win32";
+}
+
+export { syncsDirectories };

package/dist/{index-b0khj0h5.js → index-qt2zwza8.js}

@@ -2,6 +2,9 @@
 import {
   acquireNoteLock
 } from "./index-3rm7cz6h.js";
+import {
+  syncsDirectories
+} from "./index-qkesh4c6.js";
 import {
   isCanonicalNoteId,
   isCanonicalRelationPredicate,
@@ -844,7 +847,9 @@ async function cleanupTemporary(temporaryPath, identity) {
       throw error;
   }
 }
-async function fsyncDirectory(path, openDirectory = open) {
+async function fsyncDirectory(path, openDirectory = open, platform = process.platform) {
+  if (!syncsDirectories(platform))
+    return;
   const handle = await openDirectory(path, constants.O_RDONLY);
   try {
     await handle.sync();

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/index.js

@@ -37,7 +37,7 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-mvs6f7ne.js";
+} from "./index-59bcxqee.js";
 import {
   DEFAULT_SEARCH_RESULTS,
   MAX_SEARCH_CANDIDATES,
@@ -50,7 +50,7 @@ import {
   packUntrustedSearchContext,
   searchEvidenceRank,
   validateKnowledgeBaseSearchHistory
-} from "./index-5d1rd5v9.js";
+} from "./index-mcpppwbq.js";
 import"./index-adx6khj5.js";
 import {
   MAX_EMBEDDING_MODEL_BYTES,
@@ -94,7 +94,7 @@ import {
 } from "./index-b88v3vtm.js";
 import {
   percolateWithGraph
-} from "./index-tcaq1c7f.js";
+} from "./index-e26mdwxz.js";
 import {
   DEFAULT_PERCOLATION_LIMIT,
   DEFAULT_PERCOLATION_MIN_SUPPORT,
@@ -122,7 +122,7 @@ import {
   queryGraph,
   rebuildGraph,
   verifyGraph
-} from "./index-1er88ckw.js";
+} from "./index-3gc2yk4k.js";
 import {
   GRAPH_LIMITS,
   GraphAuthorityError,
@@ -297,8 +297,9 @@ import {
   noteRevision,
   removeNoteRelation,
   updateNoteBody
-} from "./index-b0khj0h5.js";
+} from "./index-qt2zwza8.js";
 import"./index-3rm7cz6h.js";
+import"./index-qkesh4c6.js";
 import {
   MAX_ANALYZED_NOTES,
   MAX_CONNECTION_OBSERVATIONS,

package/dist/portfolio.js

@@ -20,15 +20,15 @@ import {
   selectAuthorizedVaults,
   snapshotPortfolioRegistry,
   validateResolvedPortfolioVaults
-} from "./index-f184qyh1.js";
-import"./index-5d1rd5v9.js";
+} from "./index-hz2wyggk.js";
+import"./index-mcpppwbq.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
 import"./index-4j3tt0c3.js";
 import"./index-j70m75wd.js";
-import"./index-tcaq1c7f.js";
+import"./index-e26mdwxz.js";
 import"./index-bdwcjvr4.js";
-import"./index-1er88ckw.js";
+import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";
 import"./index-1gwbassd.js";
 import"./index-ahyhryb8.js";
@@ -40,6 +40,7 @@ import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
 import"./index-x3fthpsc.js";
 import"./index-3rm7cz6h.js";
+import"./index-qkesh4c6.js";
 import {
   MAX_DOCUMENT_ID_BYTES,
   MAX_PORTFOLIO_NAME_BYTES,

package/dist/sdk.js

@@ -11,14 +11,14 @@ import {
   packUntrustedSearchContext,
   searchEvidenceRank,
   validateKnowledgeBaseSearchHistory
-} from "./index-5d1rd5v9.js";
+} from "./index-mcpppwbq.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
 import"./index-4j3tt0c3.js";
 import"./index-j70m75wd.js";
-import"./index-tcaq1c7f.js";
+import"./index-e26mdwxz.js";
 import"./index-bdwcjvr4.js";
-import"./index-1er88ckw.js";
+import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";
 import"./index-1gwbassd.js";
 import"./index-ahyhryb8.js";
@@ -29,6 +29,7 @@ import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
 import"./index-3rm7cz6h.js";
+import"./index-qkesh4c6.js";
 import"./index-jvb7w0gg.js";
 import"./index-z1w83f81.js";
 export {

package/dist/{support-1yhv6vm6.js → support-adj7bbge.js}

@@ -2,15 +2,15 @@
 import {
   parseArguments as parseArguments2,
   parseUrlMetadataArguments
-} from "./index-44kw9tr8.js";
-import"./index-0eacgvpv.js";
+} from "./index-1wccy765.js";
+import"./index-47893rgw.js";
 import {
   parsePdfArguments
 } from "./index-qfqjfxaa.js";
-import"./index-f184qyh1.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";
@@ -28,16 +28,16 @@ import"./index-mxxxytys.js";
 import"./index-23z4zxgg.js";
 import"./index-pj501bh1.js";
 import"./index-9rf81m0p.js";
-import"./index-mvs6f7ne.js";
-import"./index-5d1rd5v9.js";
+import"./index-59bcxqee.js";
+import"./index-mcpppwbq.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
 import"./index-4j3tt0c3.js";
 import"./index-j70m75wd.js";
 import"./index-b88v3vtm.js";
-import"./index-tcaq1c7f.js";
+import"./index-e26mdwxz.js";
 import"./index-bdwcjvr4.js";
-import"./index-1er88ckw.js";
+import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";
 import"./index-1gwbassd.js";
 import"./index-ahyhryb8.js";
@@ -53,8 +53,9 @@ import"./index-23m6bbjt.js";
 import"./index-hya40gb2.js";
 import"./index-5vwpzb5a.js";
 import"./index-x3fthpsc.js";
-import"./index-b0khj0h5.js";
+import"./index-qt2zwza8.js";
 import"./index-3rm7cz6h.js";
+import"./index-qkesh4c6.js";
 import"./index-jvb7w0gg.js";
 import"./index-z1w83f81.js";
 

package/dist/url-intelligence.js

@@ -10,7 +10,7 @@ import {
   readUrlMetadataDocument,
   renderUrlMetadataDocument,
   writeUrlMetadataDocument
-} from "./index-0eacgvpv.js";
+} from "./index-47893rgw.js";
 import {
   ARCHIVE_TODAY_HOSTS,
   ArchiveTodayFailure,
@@ -23,11 +23,12 @@ import {
   parseMetadataSearchResponse,
   rankMetadataSearchResults,
   selectNewestArchiveTodayMemento
-} from "./index-6jcz0m1c.js";
+} from "./index-hxyjer3x.js";
 import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
 import"./index-mxxxytys.js";
 import"./index-1xxnjn0d.js";
+import"./index-qkesh4c6.js";
 import"./index-z1w83f81.js";
 
 // src/url-intelligence.ts

package/dist/workflows/decision-context.js

@@ -1,16 +1,16 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-1w0sp1q7.js";
+} from "../index-7drercgk.js";
 import"../index-h170byqw.js";
-import"../index-5d1rd5v9.js";
+import"../index-mcpppwbq.js";
 import"../index-adx6khj5.js";
 import"../index-fp732bgg.js";
 import"../index-4j3tt0c3.js";
 import"../index-j70m75wd.js";
-import"../index-tcaq1c7f.js";
+import"../index-e26mdwxz.js";
 import"../index-bdwcjvr4.js";
-import"../index-1er88ckw.js";
+import"../index-3gc2yk4k.js";
 import"../index-pgtm2nhf.js";
 import"../index-1gwbassd.js";
 import"../index-ahyhryb8.js";
@@ -21,6 +21,7 @@ import"../index-48pz4jpc.js";
 import"../index-06c9ctr6.js";
 import"../index-5vwpzb5a.js";
 import"../index-3rm7cz6h.js";
+import"../index-qkesh4c6.js";
 import"../index-jvb7w0gg.js";
 import"../index-z1w83f81.js";
 export {

package/dist/workflows/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-1w0sp1q7.js";
+} from "../index-7drercgk.js";
 import {
   explainChangeWorkflow
 } from "../index-e4fagfjz.js";
@@ -9,14 +9,14 @@ import {
   planRadarWorkflow
 } from "../index-rdd5f7jj.js";
 import"../index-h170byqw.js";
-import"../index-5d1rd5v9.js";
+import"../index-mcpppwbq.js";
 import"../index-adx6khj5.js";
 import"../index-fp732bgg.js";
 import"../index-4j3tt0c3.js";
 import"../index-j70m75wd.js";
-import"../index-tcaq1c7f.js";
+import"../index-e26mdwxz.js";
 import"../index-bdwcjvr4.js";
-import"../index-1er88ckw.js";
+import"../index-3gc2yk4k.js";
 import"../index-pgtm2nhf.js";
 import"../index-1gwbassd.js";
 import"../index-ahyhryb8.js";
@@ -27,6 +27,7 @@ import"../index-48pz4jpc.js";
 import"../index-06c9ctr6.js";
 import"../index-5vwpzb5a.js";
 import"../index-3rm7cz6h.js";
+import"../index-qkesh4c6.js";
 import"../index-jvb7w0gg.js";
 import"../index-z1w83f81.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/wordcell",
-  "version": "0.24.0",
+  "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",
@@ -368,6 +368,9 @@
     "src/clip/metadata-search-tool/Cargo.lock",
     "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",
@@ -468,13 +471,14 @@
     "src/oh/validation.ts",
     "assets/agent-skill.svg",
     "src/support.ts",
-    "src/support-profile.ts"
+    "src/support-profile.ts",
+    "src/directory-sync.ts"
   ],
   "scripts": {
-    "kb:refresh": "bunx --bun github:hraness/kb#v0.15.1 refresh --root kb",
-    "kb:check:lane": "bunx --bun github:hraness/kb#v0.15.1 check --root kb --no-catalog",
-    "kb:check": "bunx --bun github:hraness/kb#v0.15.1 check --root kb && bunx --bun github:hraness/kb#v0.15.1 agents check --root kb --repo .",
-    "kb:catalog": "bunx --bun github:hraness/kb#v0.15.1 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",
@@ -485,11 +489,12 @@
     "url-metadata:tool:build": "bun ./dist/cli.js url-metadata tool build",
     "url-metadata:tool:check": "bun ./dist/cli.js url-metadata tool check",
     "test:package": "bun run ./scripts/package-smoke.ts",
+    "check:fast": "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",
     "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.0/hraness-wordcell-0.24.0.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/skills/wordcell/references/publish.md

@@ -96,7 +96,8 @@ The full artifact contract and hosting options are in
 
 Agents on platforms without a filesystem or Bun runtime can publish the same
 `hraness.wordcell.site.v1` artifact through the hosted surface. It runs the
-identical projection server-side; published sites are public.
+identical projection server-side; published sites are public, and search
+engines may index them unless the publish request sets `"noindex": true`.
 
 ```sh
 # Self-serve capability token (IP-limited; shown once — store it).

package/src/authoring-platform.ts

@@ -1,4 +1,5 @@
 import { acquireNoteLock } from "./note-lock.js";
+import { syncsDirectories } from "./directory-sync.js";
 import { rename } from "node:fs/promises";
 import { randomUUID } from "node:crypto";
 import { constants } from "node:fs";
@@ -202,7 +203,9 @@ export async function cleanupTemporary(
 export async function fsyncDirectory(
   path: string,
   openDirectory: typeof open = open,
+  platform: NodeJS.Platform = process.platform,
 ): Promise<void> {
+  if (!syncsDirectories(platform)) return;
   const handle = await openDirectory(path, constants.O_RDONLY);
   try {
     await handle.sync();

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/jobs.ts

@@ -1,4 +1,5 @@
 import { Buffer } from "node:buffer";
+import { syncsDirectories } from "../directory-sync.js";
 import { randomUUID } from "node:crypto";
 import { constants } from "node:fs";
 import {
@@ -500,7 +501,7 @@ async function fsyncStore(store: CaptureJobStore): Promise<void> {
     if (!stat.isDirectory() || !sameIdentity(stat, expected)) {
       throw new CaptureJobSafetyError("Capture job store changed before synchronization.");
     }
-    await handle.sync();
+    if (syncsDirectories()) await handle.sync();
   } finally {
     await handle.close();
   }

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

@@ -896,10 +896,13 @@ version = "0.1.0"
 dependencies = [
  "libc",
  "metadata-search-engine-rs",
+ "quick-xml",
  "reqwest",
+ "scraper",
  "serde",
  "serde_json",
  "tokio",
+ "url",
 ]
 
 [[package]]
@@ -1309,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

@@ -8,6 +8,9 @@ publish = false
 metadata-search-engine-rs = { git = "https://github.com/MikeLuu99/searxng-rust", rev = "f40a00ea67a857ee996e1caba1ebab3ee7a14a47" }
 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"
 tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

package/src/clip/metadata-search-tool/runner.ts

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { syncsDirectories } from "../../directory-sync.js";
 import {
   closeSync,
   constants,
@@ -387,7 +388,9 @@ export function installMetadataSearchExecutable(input: {
   const stagingPath = join(toolDirectory, stagingName);
   const backupPath = join(toolDirectory, backupName);
   const syncDirectory = input.syncDirectory
-    ?? ((descriptor: number) => fsyncSync(descriptor));
+    ?? ((descriptor: number) => {
+      if (syncsDirectories()) fsyncSync(descriptor);
+    });
 
   const toolBinding = openBoundDirectory(toolDirectory, "metadata-search tool directory");
   let targetBinding: DirectoryBinding | null = null;