@hraness/wordcell 0.26.2 → 0.27.0

package/dist/rerank-clef.js

@@ -0,0 +1,16 @@
+// @bun
+import {
+  CLEF_MODELS,
+  DEFAULT_CLEF_MODEL,
+  clefEndpoint,
+  createClefReranker
+} from "./index-pn14a2m5.js";
+import"./index-pbz3qw1s.js";
+import"./index-j70m75wd.js";
+import"./index-z1w83f81.js";
+export {
+  createClefReranker,
+  clefEndpoint,
+  DEFAULT_CLEF_MODEL,
+  CLEF_MODELS
+};

package/dist/rerank-typesafe.js

@@ -2,12 +2,14 @@
 import {
   DEFAULT_SYSTEMONE_ENDPOINT,
   DEFAULT_SYSTEMONE_MODEL,
+  createHostedReranker,
   createTypeSafeReranker
-} from "./index-9rf81m0p.js";
+} from "./index-pbz3qw1s.js";
 import"./index-j70m75wd.js";
 import"./index-z1w83f81.js";
 export {
   createTypeSafeReranker,
+  createHostedReranker,
   DEFAULT_SYSTEMONE_MODEL,
   DEFAULT_SYSTEMONE_ENDPOINT
 };

package/dist/sdk.js

@@ -11,10 +11,10 @@ import {
   packUntrustedSearchContext,
   searchEvidenceRank,
   validateKnowledgeBaseSearchHistory
-} from "./index-9zkba8hr.js";
+} from "./index-7bqwzjba.js";
+import"./index-4j3tt0c3.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
-import"./index-4j3tt0c3.js";
 import"./index-wqx1x32f.js";
 import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";

package/dist/{support-9qdr4hb8.js → support-s059eytv.js}

@@ -2,24 +2,25 @@
 import {
   parseArguments as parseArguments2,
   parseUrlMetadataArguments
-} from "./index-mp5y3ty3.js";
-import"./index-5h5awwh4.js";
+} from "./index-30v9w4cy.js";
+import"./index-b40e2dkx.js";
 import {
   parsePdfArguments
-} from "./index-m9p2a4mj.js";
-import"./index-9paxge84.js";
-import"./index-j4zgmzjr.js";
-import"./index-npg9z1a4.js";
-import"./index-h9vyd03z.js";
-import"./index-hacpnaew.js";
-import"./index-k86wepd8.js";
-import"./index-nd8v7r0z.js";
+} from "./index-my50xsa3.js";
+import"./index-3hts6yy9.js";
+import"./index-8djdwjjd.js";
+import"./index-xn5q4kne.js";
+import"./index-58azscg5.js";
+import"./index-fd8j527z.js";
+import"./index-h2w7syy2.js";
+import"./index-sp43012q.js";
 import"./index-hnvx7m1j.js";
-import"./index-8pabwzqg.js";
-import"./index-ncwzmsge.js";
-import"./index-cd75vky9.js";
+import"./index-t4hjm1kk.js";
+import"./index-nwdzhj1h.js";
+import"./index-jbtyp6q5.js";
 import"./index-2gv8y733.js";
-import"./index-mxxxytys.js";
+import"./index-g63d3937.js";
+import"./index-e2wstc7t.js";
 import"./index-w2zc0vwa.js";
 import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
@@ -27,13 +28,14 @@ import {
   parseArguments
 } from "./index-byz4kzww.js";
 import"./index-23z4zxgg.js";
-import"./index-9rf81m0p.js";
+import"./index-pn14a2m5.js";
+import"./index-pbz3qw1s.js";
 import"./index-pj501bh1.js";
-import"./index-j2jt49gr.js";
-import"./index-9zkba8hr.js";
+import"./index-yatn62qq.js";
+import"./index-7bqwzjba.js";
+import"./index-4j3tt0c3.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
-import"./index-4j3tt0c3.js";
 import"./index-wqx1x32f.js";
 import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";

package/dist/url-intelligence.js

@@ -10,7 +10,7 @@ import {
   readUrlMetadataDocument,
   renderUrlMetadataDocument,
   writeUrlMetadataDocument
-} from "./index-5h5awwh4.js";
+} from "./index-b40e2dkx.js";
 import {
   ARCHIVE_TODAY_HOSTS,
   ArchiveTodayFailure,
@@ -23,8 +23,9 @@ import {
   parseMetadataSearchResponse,
   rankMetadataSearchResults,
   selectNewestArchiveTodayMemento
-} from "./index-hacpnaew.js";
-import"./index-mxxxytys.js";
+} from "./index-fd8j527z.js";
+import"./index-g63d3937.js";
+import"./index-e2wstc7t.js";
 import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
 import"./index-1xxnjn0d.js";

package/dist/workflows/decision-context.js

@@ -1,12 +1,12 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-9fywek7g.js";
+} from "../index-ht14xne3.js";
 import"../index-h170byqw.js";
-import"../index-9zkba8hr.js";
+import"../index-7bqwzjba.js";
+import"../index-4j3tt0c3.js";
 import"../index-adx6khj5.js";
 import"../index-fp732bgg.js";
-import"../index-4j3tt0c3.js";
 import"../index-wqx1x32f.js";
 import"../index-3gc2yk4k.js";
 import"../index-pgtm2nhf.js";

package/dist/workflows/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-9fywek7g.js";
+} from "../index-ht14xne3.js";
 import {
   explainChangeWorkflow
 } from "../index-e4fagfjz.js";
@@ -9,10 +9,10 @@ import {
   planRadarWorkflow
 } from "../index-rdd5f7jj.js";
 import"../index-h170byqw.js";
-import"../index-9zkba8hr.js";
+import"../index-7bqwzjba.js";
+import"../index-4j3tt0c3.js";
 import"../index-adx6khj5.js";
 import"../index-fp732bgg.js";
-import"../index-4j3tt0c3.js";
 import"../index-wqx1x32f.js";
 import"../index-3gc2yk4k.js";
 import"../index-pgtm2nhf.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/wordcell",
-  "version": "0.26.2",
+  "version": "0.27.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",
@@ -55,6 +55,7 @@
     "./src/query.ts",
     "./src/rerank.ts",
     "./src/rerank-typesafe.ts",
+    "./src/rerank-clef.ts",
     "./src/repository-memory.ts",
     "./src/sdk.ts",
     "./src/search.ts",
@@ -249,6 +250,10 @@
       "types": "./src/rerank-typesafe.ts",
       "import": "./dist/rerank-typesafe.js"
     },
+    "./rerank-clef": {
+      "types": "./src/rerank-clef.ts",
+      "import": "./dist/rerank-clef.js"
+    },
     "./repository-memory": {
       "types": "./src/repository-memory.ts",
       "import": "./dist/repository-memory.js"
@@ -432,6 +437,7 @@
     "src/query.ts",
     "src/rerank.ts",
     "src/rerank-typesafe.ts",
+    "src/rerank-clef.ts",
     "src/rerank-credentials.ts",
     "src/repository-memory.ts",
     "src/search.ts",
@@ -478,14 +484,17 @@
     "src/cli-update.ts",
     "src/cli-release.ts",
     "src/evaluation-builder-bin.ts",
-    "src/evaluation-builder-cli-args.ts"
+    "src/evaluation-builder-cli-args.ts",
+    "src/clip/metadata.ts",
+    "src/pdf/bundle-reader.ts",
+    "src/pdf/errors.ts"
   ],
   "scripts": {
     "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/cli-bin.ts ./src/evaluation-builder-bin.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",
+    "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/cli-bin.ts ./src/evaluation-builder-bin.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/rerank-clef.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",
     "check:portfolio-inventory": "bun ./scripts/check-portfolio-inventory.ts",
@@ -499,21 +508,23 @@
     "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.1/hraness-wordcell-0.24.1.tgz wordcell search --root kb --mode exact --selected-passage --rerank typesafe --rerank-limit 25",
+    "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",
+    "kb:search:clef": "bun ./dist/cli.js search --root kb --mode exact --selected-passage --rerank clef --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": {
+    "@hraness/cli-update": "https://github.com/hraness/cli-update/releases/download/v0.1.0/hraness-cli-update-0.1.0.tgz",
     "@hraness/oh": "https://github.com/hraness/oh/releases/download/v0.12.0/hraness-oh-0.12.0.tgz",
+    "@hraness/support-foundation": "git+https://github.com/hraness/support-foundation.git#b32c1c81bb2444f50509ed54388758ecfab1f1c0",
     "@steipete/sweet-cookie": "0.4.3",
-    "@tobilu/qmd": "git+https://github.com/hraness/qmd.git#aa993dceb3ef8cfb71d470554ca437570f5a2b3c",
+    "@tobilu/qmd": "https://github.com/hraness/qmd/releases/download/v2.8.3-hraness.1/hraness-qmd-2.8.3-hraness.1.tgz",
     "agent-browser": "0.32.3",
     "defuddle": "0.19.1",
-    "yaml": "^2.9.0",
-    "zod": "^4.4.3",
     "effect": "3.22.1",
-    "@hraness/support-foundation": "git+https://github.com/hraness/support-foundation.git#b32c1c81bb2444f50509ed54388758ecfab1f1c0",
-    "@hraness/cli-update": "https://github.com/hraness/cli-update/releases/download/v0.1.0/hraness-cli-update-0.1.0.tgz"
+    "entities": "7.0.1",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@hraness/build-governance": "github:hraness/build-governance#v0.1.0",
@@ -524,5 +535,8 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
+  },
+  "overrides": {
+    "simple-git": "^4.0.2"
   }
 }

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.26.2/hraness-wordcell-0.26.2.tgz
+  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.27.0/hraness-wordcell-0.27.0.tgz
 }
 wordcell --help
 ```

package/skills/wordcell/references/query.md

@@ -189,17 +189,22 @@ form. Graph neighbors and Git history remain separate from primary
 text rank. They explain and expand candidates without becoming authored facts,
 links, or recency boosts.
 
-Reranking is opt-in through `--rerank typesafe`. It uses `jev-1.13.0` and sends
-the query plus each candidate's identifier, title, vault-relative path, and at
-most 512 UTF-8 bytes of snippet text to TypeSafe. Enable it only for vaults
+Clef support is in the current source tree. The skill's pinned release does not
+include it; do not pass Clef flags to that installed CLI. In an explicitly
+selected source checkout, use `bun ./src/cli.ts` instead of `wordcell` for Clef
+commands. Source selection does not authorize hosted processing.
+
+Reranking is opt-in through `--rerank clef`. It uses Cloudflare's `clef` model
+(or `--rerank-model clef-flash`) and sends the query plus each candidate's
+identifier, title, vault-relative path, and at most 512 UTF-8 bytes of snippet
+text to Cloudflare. Enable it only for vaults
 approved for external processing and provider input-token charges. Use
 `--rerank-limit 25` to bound the window (2–25 candidates); four requests run
 concurrently under one eight-second deadline with no retries. Exact identities
 remain first. Results retain their original scores and retrieval evidence.
 
-The CLI reads `TYPESAFE_API_KEY`, an explicit `TYPESAFE_API_KEY_FILE`, or the
-owner-only file `~/.config/wordcell/typesafe-api-key` (honoring
-`XDG_CONFIG_HOME`). Keep credentials outside the repository. A missing key or
+The CLI requires `CLOUDFLARE_ACCOUNT_ID` and reads `CLOUDFLARE_API_TOKEN`
+(`CLOUDFLARE_AUTH_TOKEN` is an alias) from the environment only. Keep credentials outside the repository. A missing token or
 provider failure retains baseline ordering and marks the rerank lane
 unavailable or degraded. Inspect its structured `rerank` receipt for attempted
 requests, known usage, elapsed time, and whether usage is complete; an unknown

package/src/capture.ts

@@ -66,3 +66,8 @@ export type {
   MediaMode,
   ParseArgumentsResult,
 };
+
+import { extractArticleMetadata as extractArticleMetadataImplementation, parseArticleMetadata as parseArticleMetadataImplementation } from "./clip/metadata.js";
+export const extractArticleMetadata: typeof extractArticleMetadataImplementation = (...arguments_) => extractArticleMetadataImplementation(...arguments_);
+export const parseArticleMetadata: typeof parseArticleMetadataImplementation = (...arguments_) => parseArticleMetadataImplementation(...arguments_);
+export type { ArticleMetadata, ArticleMetadataClaim, MetadataSource, MetadataValue } from "./clip/metadata.js";

package/src/cli-help.ts

@@ -112,7 +112,8 @@ export const commandHelp: readonly CommandHelp[] = [
       PRIORITY,
       ["--candidate-limit <count>", "How many candidates to rank before trimming"],
       ["--min-score <score>", "Drop results scoring below this (0 to 1)"],
-      ["--rerank <typesafe>", "Rerank results with the hosted TypeSafe service"],
+      ["--rerank <clef|typesafe>", "Send query and snippets to Clef (typesafe is deprecated)"],
+      ["--rerank-model <clef|clef-flash>", "Clef model to use (default: clef)"],
       ["--rerank-limit <2..25>", "How many results the reranker sees"],
       ["--selected-passage", "Add a local source excerpt to each result"],
       JSON_OPTION,

package/src/cli-program.ts

@@ -176,7 +176,8 @@ import {
   type KnowledgeBaseSearchResult,
 } from "./sdk.js";
 import { MAX_RERANK_CANDIDATES, type SearchReranker } from "./rerank.js";
-import { createCliTypeSafeReranker } from "./rerank-credentials.js";
+import { createCliClefReranker, createCliTypeSafeReranker } from "./rerank-credentials.js";
+import type { ClefModel } from "./rerank-clef.js";
 import {
   refreshVault,
   refreshVaultComplete,
@@ -382,7 +383,8 @@ type ParsedCommand =
       readonly limit?: number;
       readonly candidateLimit?: number;
       readonly minScore?: number;
-      readonly rerank?: "typesafe";
+      readonly rerank?: "clef" | "typesafe";
+      readonly rerankModel?: ClefModel;
       readonly rerankLimit?: number;
       readonly selectedPassage?: boolean;
       readonly query: string;
@@ -1272,7 +1274,8 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
   let limit: number | undefined;
   let candidateLimit: number | undefined;
   let minScore: number | undefined;
-  let rerank: "typesafe" | undefined;
+  let rerank: "clef" | "typesafe" | undefined;
+  let rerankModel: ClefModel | undefined;
   let rerankLimit: number | undefined;
   let selectedPassage = false;
   let graphDepth: number | undefined;
@@ -1341,6 +1344,7 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
       || argument === "--candidate-limit"
       || argument === "--min-score"
       || argument === "--rerank"
+      || argument === "--rerank-model"
       || argument === "--rerank-limit"
       || argument === "--where"
       || argument === "--has"
@@ -1358,10 +1362,15 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
         }
         mode = value;
       } else if (argument === "--rerank") {
-        if (value !== "typesafe") {
-          return { ok: false, message: "--rerank must be typesafe" };
+        if (value !== "clef" && value !== "typesafe") {
+          return { ok: false, message: "--rerank must be clef or legacy typesafe" };
         }
         rerank = value;
+      } else if (argument === "--rerank-model") {
+        if (value !== "clef" && value !== "clef-flash") {
+          return { ok: false, message: "--rerank-model must be clef or clef-flash" };
+        }
+        rerankModel = value;
       } else if (argument === "--rerank-limit") {
         const parsed = Number(value);
         if (!Number.isSafeInteger(parsed) || parsed < 2 || parsed > MAX_RERANK_CANDIDATES) {
@@ -1498,7 +1507,10 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
     };
   }
   if (rerankLimit !== undefined && rerank === undefined) {
-    return { ok: false, message: "--rerank-limit requires --rerank typesafe" };
+    return { ok: false, message: "--rerank-limit requires --rerank clef or legacy typesafe" };
+  }
+  if (rerankModel !== undefined && rerank !== "clef") {
+    return { ok: false, message: "--rerank-model requires --rerank clef" };
   }
   if (priority && rulesPath === undefined) {
     return { ok: false, message: "--priority requires --rules" };
@@ -1539,6 +1551,7 @@ function parseSemanticCommand(command: "index" | "search", arguments_: readonly
       ...(candidateLimit === undefined ? {} : { candidateLimit }),
       ...(minScore === undefined ? {} : { minScore }),
       ...(rerank === undefined ? {} : { rerank }),
+      ...(rerankModel === undefined ? {} : { rerankModel }),
       ...(rerankLimit === undefined ? {} : { rerankLimit }),
       ...(selectedPassage ? { selectedPassage: true } : {}),
       query,
@@ -2394,7 +2407,7 @@ function renderKnowledgeBaseSearch(result: KnowledgeBaseSearchResult): string {
   const rerankLane = result.diagnostics.lanes.find(({ lane }) => lane === "rerank");
   if (rerankLane !== undefined) {
     lines.push(
-      `  Rerank: typesafe over ${rerankLane.results} candidates (${rerankLane.status})`
+      `  Rerank: ${safe(rerankLane.engine ?? "hosted")} over ${rerankLane.results} candidates (${rerankLane.status})`
         + (rerankLane.message === undefined ? "" : ` — ${safe(rerankLane.message)}`),
     );
     const receipt = rerankLane.rerank;
@@ -2488,7 +2501,9 @@ async function runSemantic(
     },
     ...(command.rerank === undefined
       ? []
-      : [{ rerankers: dependencies.rerankers ?? [await createCliTypeSafeReranker()] }]),
+      : [{ rerankers: dependencies.rerankers ?? [command.rerank === "clef"
+          ? await createCliClefReranker(process.env, undefined, command.rerankModel)
+          : await createCliTypeSafeReranker()] }]),
   );
   try {
     const result = await kb.search({

package/src/clip/browser-profiles.ts

@@ -257,7 +257,7 @@ socket.setTimeout(500, () => { socket.destroy(); process.exit(1); });
 socket.once("connect", () => { socket.destroy(); process.exit(1); });
 socket.once("error", error => process.exit(error.code === "ENOENT" || error.code === "ECONNREFUSED" ? 0 : 1));`;
   const result = spawnSync(process.execPath, ["--no-env-file", "--no-install", "--no-macros", "--no-addons", "--eval", script], {
-    input: path, cwd: tmpdir(), env: {}, timeout: 2000, maxBuffer: 1024, stdio: ["pipe", "pipe", "pipe"],
+    input: path, cwd: tmpdir(), env: {} as NodeJS.ProcessEnv, timeout: 2000, maxBuffer: 1024, stdio: ["pipe", "pipe", "pipe"],
   });
   if (result.error || result.status !== 0) throw new BrowserProfileSnapshotError(activeProfileMessage);
 }

package/src/clip/bundle-reader.ts

@@ -1,3 +1,4 @@
+import { parseArticleMetadata, type ArticleMetadata } from "./metadata.js";
 import { createHash } from "node:crypto";
 import { constants as fsConstants, type BigIntStats } from "node:fs";
 import { lstat, open, opendir, realpath, type FileHandle } from "node:fs/promises";
@@ -27,6 +28,7 @@ const SHA256_PATTERN = /^[0-9a-f]{64}$/u;
 export type CaptureBundleIntegrity = "mismatch" | "unavailable" | "verified";
 
 export type CaptureBundleInspection = {
+  readonly metadata?: ArticleMetadata;
   readonly root: string;
   readonly schemaVersion: 1 | 2 | 3 | 4;
   readonly sourceUrl: string;
@@ -556,6 +558,7 @@ export async function readCaptureBundle(
 
     await assertBundleRoot(root);
     return Object.freeze({
+      ...(manifest.metadata === undefined ? {} : { metadata: parseArticleMetadata(manifest.metadata) }),
       root: root.path,
       schemaVersion,
       sourceUrl: manifest.sourceUrl,

package/src/clip/capture.ts

@@ -965,6 +965,7 @@ export async function runCapture(
       const finalWarnings = finalizedWarnings(combinedWarnings, redactedMarkdown.count);
       const includeSource = options.evidence === "source" || options.evidence === "all";
       const manifestInput: CaptureManifestInput = {
+        ...(article.metadata === undefined ? {} : { metadata: article.metadata }),
         sourceUrl,
         canonicalUrl: best.canonicalUrl.href,
         capturedAt,

package/src/clip/extract.ts

@@ -1,3 +1,4 @@
+import { parseArticleMetadata } from "./metadata.js";
 import type { CaptureScope } from "./args.js";
 import type { AcquiredPage } from "./acquire.js";
 import {
@@ -719,6 +720,7 @@ export async function extractPage(
           content: retainDefuddleMedia(restoredContent, response, acquisition.finalUrl),
           title: boundedMetadata(response.title, articleMetadataLimits.title)
             ?? boundedMetadata(acquisition.browserTitle, articleMetadataLimits.title),
+          ...(response.metadata === undefined ? {} : { metadata: parseArticleMetadata(response.metadata) }),
           author: boundedMetadata(response.author, articleMetadataLimits.author),
           published: boundedMetadata(response.published, articleMetadataLimits.published),
           description,

package/src/clip/lib.ts

@@ -1,7 +1,9 @@
+import { parseArticleMetadata, type ArticleMetadata } from "./metadata.js";
 import { sanitizeTerminalText } from "./terminal.js";
 
 /** Defuddle fields consumed after narrowing its JSON output. */
 export type Article = {
+  metadata?: ArticleMetadata;
   content: string;
   title: string | null;
   author: string | null;
@@ -46,6 +48,7 @@ export function parseArticle(parsed: unknown): Article | null {
   if (content === null) return null;
   return {
     content,
+    ...(parsed.metadata === undefined ? {} : { metadata: parseArticleMetadata(parsed.metadata) }),
     title: nonEmptyString(parsed.title, articleMetadataLimits.title),
     author: nonEmptyString(parsed.author, articleMetadataLimits.author),
     published: nonEmptyString(parsed.published, articleMetadataLimits.published),

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

@@ -594,9 +594,9 @@ dependencies = [
 
 [[package]]
 name = "h2"
-version = "0.4.15"
+version = "0.4.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6cb093c84e8bd9b188d4c4a8cb6579fc016968d14c99882163cd3ff402a4f155"
+checksum = "a9f37a958b41b3b19ee2707c06439c0e9e547e847223eb791ecb0cb821c65e27"
 dependencies = [
  "atomic-waker",
  "bytes",
@@ -1469,9 +1469,9 @@ dependencies = [
 
 [[package]]
 name = "rustls"
-version = "0.23.43"
+version = "0.23.45"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0283386ce02abc0151e1761d08802dfe86c173b0b494af5cbc086574e453da06"
+checksum = "0d41d731c7d2f962d1ccc364cec258de3c0e93b38c2fb3ba97ac74513048d634"
 dependencies = [
  "once_cell",
  "rustls-pki-types",
@@ -1491,9 +1491,9 @@ dependencies = [
 
 [[package]]
 name = "rustls-webpki"
-version = "0.103.13"
+version = "0.103.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "61c429a8649f110dddef65e2a5ad240f747e85f7758a6bccc7e5777bd33f756e"
+checksum = "f3c3cf1d8b1e7d4927e2d154c3fcb02979afb9939629c62cd9048d4f07b60ac2"
 dependencies = [
  "ring",
  "rustls-pki-types",

package/src/clip/metadata-search.ts

@@ -417,7 +417,7 @@ async function runProcess(options: {
   try {
     child = spawn(options.binaryPath, [], {
       cwd: options.cwd,
-      env: options.environment,
+      env: options.environment as NodeJS.ProcessEnv,
       shell: false,
       stdio: ["pipe", "pipe", "pipe"],
       windowsHide: true,