@hraness/wordcell 0.23.0 → 0.24.1

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

@@ -2,12 +2,12 @@
 import {
   parseArguments as parseArguments2,
   parseUrlMetadataArguments
-} from "./index-vtwbapjr.js";
-import"./index-0eacgvpv.js";
+} from "./index-jqkkb4fr.js";
+import"./index-t0fh8a1q.js";
 import {
   parsePdfArguments
 } from "./index-qfqjfxaa.js";
-import"./index-r4qs6vq4.js";
+import"./index-hz2wyggk.js";
 import"./index-j4zgmzjr.js";
 import"./index-2fmnttca.js";
 import"./index-6jcz0m1c.js";
@@ -28,16 +28,16 @@ import"./index-mxxxytys.js";
 import"./index-23z4zxgg.js";
 import"./index-pj501bh1.js";
 import"./index-9rf81m0p.js";
-import"./index-mnq2wy34.js";
-import"./index-tvd2sqrx.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-t0fh8a1q.js";
 import {
   ARCHIVE_TODAY_HOSTS,
   ArchiveTodayFailure,
@@ -28,6 +28,7 @@ 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-p70t8j13.js";
+} from "../index-7drercgk.js";
 import"../index-h170byqw.js";
-import"../index-tvd2sqrx.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-p70t8j13.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-tvd2sqrx.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.23.0",
+  "version": "0.24.1",
   "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,7 @@
     "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/git.ts",
     "src/evaluation-analysis-v2.ts",
     "src/evaluation-builder.ts",
@@ -437,6 +438,7 @@
     "src/semantic.ts",
     "src/serve.ts",
     "src/sdk.ts",
+    "src/selected-passage.ts",
     "src/source-inbox.ts",
     "src/untrusted-content.ts",
     "src/vault.ts",
@@ -467,13 +469,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.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",
     "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",
@@ -484,11 +487,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.23.0/hraness-wordcell-0.23.0.tgz wordcell search --root kb --mode exact --rerank typesafe --rerank-limit 25",
-    "kb:search:local": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.23.0/hraness-wordcell-0.23.0.tgz wordcell search --root kb --mode exact",
+    "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",
     "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.23.0/hraness-wordcell-0.23.0.tgz
+  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.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/skills/wordcell/references/query.md

@@ -54,7 +54,7 @@ returned:
 ```sh
 wordcell context packages/parser/src/index.ts --root "$KB_ROOT" --repo "$KB_REPO"
 wordcell search "why parser retries stop" --root "$KB_ROOT" --mode exact \
-  --history --repo "$KB_REPO" --json
+  --selected-passage --history --repo "$KB_REPO" --json
 wordcell backlinks notes/parser-contract --root "$KB_ROOT" --json
 wordcell history notes/parser-contract --root "$KB_ROOT" \
   --repo "$KB_REPO" --json
@@ -80,7 +80,7 @@ read them with the commands under
   resolve note identities before returning authored relationships.
 - A whole-vault structural question or relationship audit: use `wordcell graph --json`,
   then inspect the smallest relevant portion of its canonical output.
-- A phrase, identity, or concept expressed with different vocabulary: use `wordcell search`, whose default hybrid result preserves exact and QMD evidence separately.
+- A phrase, identity, or concept expressed with different vocabulary: use `wordcell search`, whose default hybrid result preserves exact and QMD evidence separately. Add `--selected-passage` when you will read, quote, or act on results: each hit then carries the note's best-matching excerpt with its line range and section headings.
 - Direct provenance for one note or repository path: use `wordcell history` or
   `wordcell history search` without changing authored metadata or links.
 - Recent captures awaiting maintained disposition: use the advisory `wordcell inbox` view.
@@ -96,7 +96,7 @@ wordcell backlinks "Plan title or path" --root "$KB_ROOT" --json
 wordcell links "Plan title or path" --root "$KB_ROOT" --direction both --depth 1 --limit 25 --json
 wordcell relation list "Plan title or path" --root "$KB_ROOT" --json
 wordcell graph --root "$KB_ROOT" --json
-wordcell search "why browser capture uses the current tab" --root "$KB_ROOT" --json
+wordcell search "why browser capture uses the current tab" --root "$KB_ROOT" --selected-passage --json
 wordcell search "accepted ingestion plans" --root "$KB_ROOT" --where type=plan --where status=accepted --tag ingestion --json
 wordcell search "notes/write-path" --root "$KB_ROOT" --mode exact --no-history --json
 wordcell history "notes/write-path" --root "$KB_ROOT" --repo "$KB_REPO" --json
@@ -211,6 +211,20 @@ For a repository's ordinary KB searches, prefer its approved, pinned
 choice. Read returned notes before acting; model probabilities are ranking
 signals, not proof of truth. Explicit priority rules still run last.
 
+Add `--selected-passage` to attach one source excerpt to each returned note.
+Wordcell chooses it locally, without model calls: the paragraph, or window of
+at most 512 UTF-8 bytes, that contains the most distinct query words, outside
+frontmatter. The excerpt is unedited note text with its byte offsets, line
+range, the SHA-256 of the note text, and the enclosing Markdown headings as
+separate spans. Offsets count from the start of the note text, after any
+byte-order mark. Ranking, scores, the `snippet` field, and reranker input do not
+change. A note without matching body text reports `status: "none"`; a note
+past a size limit reports `status: "unavailable"` with a reason. Both keep
+their snippet. Terminal output shows CRLF as LF and tabs as four spaces, and
+reports `display-sanitized` instead of an excerpt that credential redaction
+would alter. An excerpt shows where query words appear; it is not a verified
+answer. SDK and MCP `search` callers pass `selectedPassage: true`.
+
 `wordcell history <note>` returns the bounded commit history already associated with
 one resolved note. `wordcell history search <query-or-path>` searches the bounded Git
 projection directly and retains hashes, subjects, matched paths, co-change

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-help.ts

@@ -114,6 +114,7 @@ export const commandHelp: readonly CommandHelp[] = [
       ["--min-score <score>", "Drop results scoring below this (0 to 1)"],
       ["--rerank <typesafe>", "Rerank results with the hosted TypeSafe service"],
       ["--rerank-limit <2..25>", "How many results the reranker sees"],
+      ["--selected-passage", "Add a local source excerpt to each result"],
       JSON_OPTION,
     ],
     examples: ['wordcell search "retries" --root kb --mode exact', 'wordcell search "retry policy" --root kb --limit 5'],

package/src/cli-program.ts

@@ -385,6 +385,7 @@ type ParsedCommand =
       readonly minScore?: number;
       readonly rerank?: "typesafe";
       readonly rerankLimit?: number;
+      readonly selectedPassage?: boolean;
       readonly query: string;
       readonly json: boolean;
     }
@@ -1274,6 +1275,7 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
   let minScore: number | undefined;
   let rerank: "typesafe" | undefined;
   let rerankLimit: number | undefined;
+  let selectedPassage = false;
   let graphDepth: number | undefined;
   let noGraph = false;
   let history = false;
@@ -1300,6 +1302,10 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
       noGraph = true;
       continue;
     }
+    if (argument === "--selected-passage" && command === "search") {
+      selectedPassage = true;
+      continue;
+    }
     if (argument === "--no-history" && command === "search") {
       noHistory = true;
       continue;
@@ -1535,6 +1541,7 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
       ...(minScore === undefined ? {} : { minScore }),
       ...(rerank === undefined ? {} : { rerank }),
       ...(rerankLimit === undefined ? {} : { rerankLimit }),
+      ...(selectedPassage ? { selectedPassage: true } : {}),
       query,
       json,
     },
@@ -2418,6 +2425,22 @@ function renderSemanticIndex(result: SemanticIndexResult): string {
   ].join("\n");
 }
 
+function searchForDisplay(result: KnowledgeBaseSearchResult): KnowledgeBaseSearchResult {
+  return {
+    ...result,
+    results: result.results.map((hit) => {
+      const passage = hit.selectedPassage;
+      if (passage?.status !== "selected") return hit;
+      const texts = [passage.text, ...passage.headings.map(({ text }) => text)];
+      // Terminal output always renders CRLF as LF and tabs as four spaces; only other changes lose content.
+      if (texts.every((text) => sanitizeTerminalText(redactSensitiveText(text))
+        === text.replaceAll("\r\n", "\n").replaceAll("\t", "    "))) return hit;
+      // Redacted display text cannot retain a claim of exact source bytes.
+      return { ...hit, selectedPassage: { status: "unavailable", reason: "display-sanitized" } as const };
+    }),
+  };
+}
+
 function renderKnowledgeBaseSearch(result: KnowledgeBaseSearchResult): string {
   const lines = [
     `${result.mode[0]?.toLocaleUpperCase("en-US") ?? ""}${result.mode.slice(1)} results for “${safe(result.query)}” (${result.results.length})${result.partial ? " [partial]" : ""}`,
@@ -2445,7 +2468,20 @@ function renderKnowledgeBaseSearch(result: KnowledgeBaseSearchResult): string {
       .map((item) => `${item.kind}#${searchEvidenceRank(item)}`)
       .join(", ");
     lines.push(`  ${hit.rank}. ${hit.score.toFixed(3)}  ${location} — ${safe(hit.title)} [${safe(evidence)}]`);
-    if (hit.snippet !== "") lines.push(`    ${safe(hit.snippet)}`);
+    const passage = hit.selectedPassage;
+    if (passage?.status === "selected") {
+      lines.push(`    Selected passage: ${safe(hit.path)}:${passage.startLine}-${passage.endLine}`
+        + (passage.clippedStart || passage.clippedEnd ? " (clipped excerpt)" : ""));
+      for (const heading of passage.headings) {
+        lines.push(`    Section: ${safe(heading.text)}${heading.truncated ? " (clipped)" : ""}`);
+      }
+      for (const line of passage.text.split(/\r?\n/u)) lines.push(`    ${safe(line)}`);
+    } else {
+      if (hit.snippet !== "") lines.push(`    ${safe(hit.snippet)}`);
+      if (passage !== undefined) {
+        lines.push(`    Selected passage: ${passage.status} (${safe(passage.reason)}); showing the search snippet.`);
+      }
+    }
   }
   if ((result.graph?.related.length ?? 0) > 0) {
     lines.push(`  Related graph context: ${result.graph?.related.length ?? 0}`);
@@ -2523,6 +2559,7 @@ async function runSemantic(
         ? {}
         : { candidateLimit: command.candidateLimit }),
       ...(command.minScore === undefined ? {} : { minScore: command.minScore }),
+      ...(command.selectedPassage === undefined ? {} : { selectedPassage: command.selectedPassage }),
       ...(command.rerank === undefined ? {} : {
         rerank: {
           engine: command.rerank,
@@ -2530,9 +2567,10 @@ async function runSemantic(
         },
       }),
     });
+    const display = searchForDisplay(result);
     output.stdout(command.json
-      ? terminalSafeJson(result)
-      : sanitizeTerminalText(renderKnowledgeBaseSearch(result)));
+      ? terminalSafeJson(display)
+      : sanitizeTerminalText(renderKnowledgeBaseSearch(display)));
     if (withoutIndex && person) {
       output.stderr("Searched without an index, so only exact words matched. "
         + `For meaning-based search, run wordcell index --root ${safe(shellWord(command.root))} `

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

@@ -897,9 +897,11 @@ dependencies = [
  "libc",
  "metadata-search-engine-rs",
  "reqwest",
+ "scraper",
  "serde",
  "serde_json",
  "tokio",
+ "url",
 ]
 
 [[package]]

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

@@ -8,6 +8,8 @@ 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"
+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;