@hraness/wordcell 0.26.2 → 0.27.0

package/README.md

@@ -1,6 +1,14 @@
 <!-- hraness:wordcell-landing:start -->
 # Wordcell
 
+> 🧠 Wordcell hands the next agent session what this one learned. Decisions,
+> plans, and sources live as Markdown files beside your code. Tie a note to the
+> paths it explains, and an agent about to change that code gets the note
+> first. Search matches exact words or meaning, with an optional local model,
+> and every index rebuilds from files you can read in any editor.
+>
+> Ask your agent to set it up: https://wordcell.io
+
 [![Agent Skill](https://raw.githubusercontent.com/hraness/wordcell/main/assets/agent-skill.svg)](https://github.com/hraness/wordcell/tree/main/skills/wordcell)
 
 Wordcell is a Markdown knowledge base and local MCP memory server for coding
@@ -66,14 +74,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.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
 ```
 
 Prefer npm? The same release is [mirrored there](https://www.npmjs.com/package/@hraness/wordcell):
 
 ```sh
-npm install --global --ignore-scripts @hraness/wordcell@0.26.2
+npm install --global --ignore-scripts @hraness/wordcell@0.27.0
 wordcell --help
 ```
 
@@ -137,7 +145,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.26.2 --skill wordcell
+bunx skills add hraness/wordcell#v0.27.0 --skill wordcell
 ```
 
 Then ask:
@@ -194,15 +202,20 @@ Open the returned Markdown and guides before acting on them.
 
 ## Rerank a search window
 
+Cloudflare Clef support is in the current source tree. The versioned release
+listed above does not include it. From a source checkout, run:
+
 ```sh
-wordcell search "why releases use immutable archives" --root kb --mode exact \
-  --rerank typesafe --rerank-limit 25 --limit 5 --json
+bun ./src/cli.ts search "why releases use immutable archives" --root kb --mode exact \
+  --rerank clef --rerank-limit 25 --limit 5 --json
 ```
 
-This optional hosted lane uses TypeSafe's pinned `jev-1.13.0` model. It sends
-bounded query and note snippets to the provider, needs a private local
-credential, and incurs provider charges. Exact identities remain first; a
-provider failure retains the baseline order with a diagnostic. See the
+This optional hosted reranker uses Cloudflare Clef (`clef` by default, or
+`--rerank-model clef-flash`). It sends the query and candidate note identifiers,
+titles, paths, and snippets to Cloudflare, needs `CLOUDFLARE_ACCOUNT_ID` and
+`CLOUDFLARE_API_TOKEN`, and incurs provider charges. Enable it only for vaults you
+approve for external processing; credentials alone never enable it. Exact
+identities remain first; a provider failure retains the baseline order with a diagnostic. See the
 [setup, SDK examples, measured results, and limits](https://github.com/hraness/wordcell/blob/main/docs/reranking.md).
 
 ## What you can do
@@ -266,7 +279,7 @@ redaction. [Selection recipes and hosting guide](https://github.com/hraness/word
 Code, Claude Desktop, Cursor, or Codex, over standard input and output. The
 client can search, list, and read notes, follow links, create notes, update a
 note body at a known revision, and add typed relations. `--read-only` removes
-the write tools. [Connect a client](https://github.com/hraness/wordcell/blob/main/docs/reference.md#connect-a-client)
+the write tools. [Connect Wordcell to your coding agent](https://github.com/hraness/wordcell/blob/main/docs/agent-handoffs.md)
 shows the setup for each host.
 
 With the Agent Skill, ask your agent to save the session. It writes a dated
@@ -283,10 +296,10 @@ keeps one vault current on several machines.
 
 ## Evidence and comparisons
 
-On the public SciFact dataset of scientific abstracts, optional hosted Jev
+In the September 19, 2026 SciFact study of scientific abstracts, hosted Jev
 reranking placed a relevant result first for **161 of 300 queries**, versus
-**101** with Wordcell exact search alone. Hosted reranking is optional and uses
-a paid provider. [Results and method](https://github.com/hraness/wordcell/blob/main/docs/reranking.md#evidence-and-limits).
+**101** with Wordcell exact search alone. These historical measurements do not
+evaluate Cloudflare Clef or Clef Flash. [Results and method](https://github.com/hraness/wordcell/blob/main/docs/reranking.md#evidence-and-limits).
 
 [The comparison guide](https://wordcell.io/docs/comparisons)
 covers Markdown alone, QMD, Basic Memory, Obsidian, static publishing tools,
@@ -335,7 +348,7 @@ Backlinks and typed relationships come from authored links. Percolation
 suggests connections for review and does not add inferred edges to notes.
 
 Wordcell search combines its own exact matching with optional QMD local search
-and optional hosted Jev reranking. Oh also offers memory retrieval for applications;
+and optional hosted Cloudflare Clef reranking. Oh also offers memory retrieval for applications;
 its conversation-memory benchmark scores measure that separate path. They do not
 establish Wordcell's retrieval or answer quality. [How the integration works](https://github.com/hraness/wordcell/blob/main/docs/graph-authority.md#how-wordcell-and-oh-fit-together).
 
@@ -348,7 +361,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.26.2/hraness-wordcell-0.26.2.tgz
+bun add --exact --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.27.0/hraness-wordcell-0.27.0.tgz
 ```
 
 The SDK provides read-only vault sessions, metadata queries, search, graph
@@ -359,8 +372,8 @@ show the public imports and lifecycle.
 ## Privacy and boundaries
 
 - Structural queries and exact search read local files. Optional semantic
-  search downloads its model on first use and runs locally. Optional Jev
-  reranking sends the query and bounded candidate context to a remote provider;
+  search downloads its model on first use and runs locally. Optional Cloudflare
+  Clef reranking sends the query and candidate context to Cloudflare;
   it is off by default.
 - URL capture contacts the requested source. Signed-in capture uses only
   explicitly selected browser state. Review the [security policy](https://github.com/hraness/wordcell/blob/main/SECURITY.md)
@@ -372,15 +385,17 @@ show the public imports and lifecycle.
 
 ## Documentation
 
-The documentation follows the Diataxis split: a tutorial to learn the loop,
-how-to guides for tasks, reference for exact interfaces, and explanation for
-the design. Browse it on the [documentation index](https://wordcell.io/docs).
+Start with the task you want to complete. Browse all guides on the
+[documentation index](https://wordcell.io/docs).
 
 | Read next | Purpose |
 | --- | --- |
 | [Get started](https://github.com/hraness/wordcell/blob/main/docs/getting-started.md) | Learn the full loop on a first vault: save, find, connect, and publish one note. |
 | [Agent workflow](https://github.com/hraness/wordcell/blob/main/docs/agent-workflow.md) | Set up, query, maintain, and revise repository memory. |
-| [Local MCP server](https://github.com/hraness/wordcell/blob/main/docs/reference.md#local-mcp-server) | Connect Claude Code, Claude Desktop, Cursor, or Codex to a vault and review the write tools. |
+| [Search an existing Obsidian or Markdown vault](https://github.com/hraness/wordcell/blob/main/docs/getting-started.md#search-an-existing-markdown-or-obsidian-vault) | Find a saved note without initialization or a model download. |
+| [Use an existing Obsidian vault](https://github.com/hraness/wordcell/blob/main/docs/obsidian.md) | See which Obsidian links, tags, and attachments Wordcell reads, and serve the vault to an agent read-only. |
+| [Connect a coding agent over MCP](https://github.com/hraness/wordcell/blob/main/docs/agent-handoffs.md) | Configure Claude Code, Codex, Cursor, or Claude Desktop, then verify a note read. |
+| [Troubleshoot MCP](https://github.com/hraness/wordcell/blob/main/docs/agent-handoffs.md#troubleshoot-the-connection) | Diagnose executable paths, partial search results, missing tools, and oversized responses. |
 | [Installation and command reference](https://github.com/hraness/wordcell/blob/main/docs/reference.md) | Exact interfaces, SDK imports, optional adapters, and troubleshooting prerequisites. |
 | [Web capture](https://github.com/hraness/wordcell/blob/main/docs/capture.md) and [PDF capture](https://github.com/hraness/wordcell/blob/main/docs/pdf.md) | Save sources with provenance, assets, and explicit completeness limits. |
 | [Publish selected notes](https://github.com/hraness/wordcell/blob/main/docs/publish.md) | Preview a slice, build a static site, and choose how to host it. |

package/dist/capture.js

@@ -5,19 +5,23 @@ import {
   captureSummary,
   main,
   runCapture
-} from "./index-h9vyd03z.js";
-import"./index-hacpnaew.js";
-import"./index-k86wepd8.js";
+} from "./index-58azscg5.js";
+import"./index-fd8j527z.js";
+import"./index-h2w7syy2.js";
 import {
   adapterCapabilities,
   inspectClipEnvironment,
   renderDoctorReport
-} from "./index-nd8v7r0z.js";
+} from "./index-sp43012q.js";
 import"./index-hnvx7m1j.js";
-import"./index-ncwzmsge.js";
-import"./index-cd75vky9.js";
+import"./index-nwdzhj1h.js";
+import"./index-jbtyp6q5.js";
 import"./index-2gv8y733.js";
-import"./index-mxxxytys.js";
+import"./index-g63d3937.js";
+import {
+  extractArticleMetadata,
+  parseArticleMetadata
+} from "./index-e2wstc7t.js";
 import"./index-w2zc0vwa.js";
 import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
@@ -38,11 +42,15 @@ var inspectClipEnvironment2 = (...arguments_) => inspectClipEnvironment(...argum
 var parseCaptureArguments = (...arguments_) => parseArguments(...arguments_);
 var renderDoctorReport2 = (...arguments_) => renderDoctorReport(...arguments_);
 var runCapture2 = (...arguments_) => runCapture(...arguments_);
+var extractArticleMetadata2 = (...arguments_) => extractArticleMetadata(...arguments_);
+var parseArticleMetadata2 = (...arguments_) => parseArticleMetadata(...arguments_);
 export {
   runCapture2 as runCapture,
   renderDoctorReport2 as renderDoctorReport,
   parseCaptureArguments,
+  parseArticleMetadata2 as parseArticleMetadata,
   inspectClipEnvironment2 as inspectClipEnvironment,
+  extractArticleMetadata2 as extractArticleMetadata,
   clipMain,
   captureSummary2 as captureSummary,
   captureSucceeded2 as captureSucceeded,

package/dist/cli-bin.js

@@ -2,9 +2,9 @@
 // @bun
 import {
   runWordcellBin
-} from "./index-82r6g4py.js";
+} from "./index-k9yzc4vn.js";
 import"./index-3t0v457d.js";
-import"./index-8pabwzqg.js";
+import"./index-t4hjm1kk.js";
 import"./index-4knsp9qj.js";
 import"./index-z1w83f81.js";
 

package/dist/cli.js

@@ -6,34 +6,36 @@ import {
   parseArguments,
   runExecutable,
   usage
-} from "./index-mp5y3ty3.js";
-import"./index-5h5awwh4.js";
-import"./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-30v9w4cy.js";
+import"./index-b40e2dkx.js";
+import"./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";
 import"./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";
@@ -64,7 +66,7 @@ import {
 
 // src/cli.ts
 async function runStandaloneCli(args = process.argv.slice(2)) {
-  const { standaloneSupportEnvironment, isUsefulSupportResult, runProductSupportCommand, showProductSupportInvitation } = await import("./support-9qdr4hb8.js");
+  const { standaloneSupportEnvironment, isUsefulSupportResult, runProductSupportCommand, showProductSupportInvitation } = await import("./support-s059eytv.js");
   const env = standaloneSupportEnvironment();
   if (args[0] === "support") {
     return await runProductSupportCommand(args.slice(1), { env });

package/dist/clip/acquire.js

@@ -22,10 +22,11 @@ import {
   mergeRenderedTextSnapshots,
   readBrowserExpansionTelemetry,
   seedOwnedBrowserCookies
-} from "../index-ncwzmsge.js";
-import"../index-cd75vky9.js";
+} from "../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";

package/dist/clip/bundle-reader.js

@@ -2,8 +2,9 @@
 import {
   readCaptureBundle,
   verifyCaptureBundle
-} from "../index-npg9z1a4.js";
-import"../index-mxxxytys.js";
+} from "../index-xn5q4kne.js";
+import"../index-g63d3937.js";
+import"../index-e2wstc7t.js";
 import"../index-1xxnjn0d.js";
 import"../index-z1w83f81.js";
 export {

package/dist/clip/cli.js

@@ -5,15 +5,16 @@ import {
   captureSucceeded,
   captureSummary,
   main
-} from "../index-h9vyd03z.js";
-import"../index-hacpnaew.js";
-import"../index-k86wepd8.js";
-import"../index-nd8v7r0z.js";
+} from "../index-58azscg5.js";
+import"../index-fd8j527z.js";
+import"../index-h2w7syy2.js";
+import"../index-sp43012q.js";
 import"../index-hnvx7m1j.js";
-import"../index-ncwzmsge.js";
-import"../index-cd75vky9.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";

package/dist/clip/defuddle-worker.js

@@ -1,4 +1,7 @@
 // @bun
+import {
+  extractArticleMetadata
+} from "../index-e2wstc7t.js";
 import"../index-z1w83f81.js";
 
 // src/clip/defuddle-worker.ts
@@ -161,7 +164,7 @@ workerGlobal.onmessage = async (event) => {
       useAsync: false,
       removeImages: false
     });
-    const enriched = typeof value === "object" && value !== null && !Array.isArray(value) ? { ...value, captureVideoPosters: videoPosters } : value;
+    const enriched = typeof value === "object" && value !== null && !Array.isArray(value) ? { ...value, captureVideoPosters: videoPosters, metadata: await extractArticleMetadata(request.html, request.url, value) } : value;
     workerGlobal.postMessage({ ok: true, value: enriched });
   } catch {
     workerGlobal.postMessage({ ok: false, message: "Defuddle could not parse this acquisition." });

package/dist/clip/doctor.js

@@ -9,11 +9,12 @@ import {
   renderAdapterCapabilities,
   renderDoctorReport,
   runDiagnosticCommand
-} from "../index-nd8v7r0z.js";
-import"../index-ncwzmsge.js";
-import"../index-cd75vky9.js";
+} from "../index-sp43012q.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";

package/dist/clip/jobs.js

@@ -1,7 +1,8 @@
 // @bun
 import {
   redactSensitiveText
-} from "../index-mxxxytys.js";
+} from "../index-g63d3937.js";
+import"../index-e2wstc7t.js";
 import {
   sanitizeTerminalLine,
   sanitizeTerminalText

package/dist/clip/persist.js

@@ -12,7 +12,8 @@ import {
   sanitizeArtifactUrl,
   sanitizeSourceHtml,
   writeCaptureBundle
-} from "../index-mxxxytys.js";
+} from "../index-g63d3937.js";
+import"../index-e2wstc7t.js";
 import"../index-1xxnjn0d.js";
 import"../index-z1w83f81.js";
 export {

package/dist/clip/refresh.js

@@ -1,9 +1,10 @@
 // @bun
 import {
   diffCaptureBundle
-} from "../index-j4zgmzjr.js";
-import"../index-npg9z1a4.js";
-import"../index-mxxxytys.js";
+} from "../index-8djdwjjd.js";
+import"../index-xn5q4kne.js";
+import"../index-g63d3937.js";
+import"../index-e2wstc7t.js";
 import"../index-1gwbassd.js";
 import"../index-1xxnjn0d.js";
 import"../index-z1w83f81.js";

package/dist/evaluation-builder-bin.js

@@ -2,9 +2,9 @@
 // @bun
 import {
   runWordcellBin
-} from "./index-82r6g4py.js";
+} from "./index-k9yzc4vn.js";
 import"./index-3t0v457d.js";
-import"./index-8pabwzqg.js";
+import"./index-t4hjm1kk.js";
 import"./index-4knsp9qj.js";
 import"./index-z1w83f81.js";
 

package/dist/evaluation-builder.js

@@ -9,15 +9,15 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-j2jt49gr.js";
-import"./index-9zkba8hr.js";
+} from "./index-yatn62qq.js";
+import"./index-7bqwzjba.js";
+import"./index-4j3tt0c3.js";
 import"./index-adx6khj5.js";
 import {
   indexSemanticVault,
   recommendedEmbeddingModel,
   recommendedEmbeddingModelSha256
 } from "./index-fp732bgg.js";
-import"./index-4j3tt0c3.js";
 import"./index-wqx1x32f.js";
 import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";

package/dist/evaluation-kb.js

@@ -4,11 +4,11 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-j2jt49gr.js";
-import"./index-9zkba8hr.js";
+} from "./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/{index-mp5y3ty3.js → index-30v9w4cy.js}

@@ -3,26 +3,26 @@ import {
   backfillSavedUrlMetadata,
   createRustMetadataSearchProvider,
   savedSourceProblem
-} from "./index-5h5awwh4.js";
+} from "./index-b40e2dkx.js";
 import {
   main as main2
-} from "./index-m9p2a4mj.js";
+} from "./index-my50xsa3.js";
 import {
   MAX_AUTHORIZED_VAULTS,
   auditKnowledgePortfolio,
   loadPortfolioRegistry,
   openKnowledgePortfolio,
   snapshotPortfolioRegistry
-} from "./index-9paxge84.js";
+} from "./index-3hts6yy9.js";
 import {
   diffCaptureBundle
-} from "./index-j4zgmzjr.js";
+} from "./index-8djdwjjd.js";
 import {
   verifyCaptureBundle
-} from "./index-npg9z1a4.js";
+} from "./index-xn5q4kne.js";
 import {
   main
-} from "./index-h9vyd03z.js";
+} from "./index-58azscg5.js";
 import {
   advancedHelp,
   closestMatch,
@@ -33,7 +33,7 @@ import {
   resolveCommandId,
   rootHelp,
   startHelp
-} from "./index-8pabwzqg.js";
+} from "./index-t4hjm1kk.js";
 import {
   detectAudience,
   renderFailure,
@@ -43,17 +43,20 @@ import {
   symbol,
   terminalOutput,
   terminalStyle
-} from "./index-cd75vky9.js";
+} from "./index-jbtyp6q5.js";
 import {
   redactSensitiveText,
   sanitizeArtifactUrl
-} from "./index-mxxxytys.js";
+} from "./index-g63d3937.js";
 import {
   initVault
 } from "./index-23z4zxgg.js";
+import {
+  createClefReranker
+} from "./index-pn14a2m5.js";
 import {
   createTypeSafeReranker
-} from "./index-9rf81m0p.js";
+} from "./index-pbz3qw1s.js";
 import {
   MAX_SOURCE_INBOX_PREFIXES,
   MAX_SOURCE_INBOX_RESULTS,
@@ -62,7 +65,7 @@ import {
 import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation
-} from "./index-j2jt49gr.js";
+} from "./index-yatn62qq.js";
 import {
   DEFAULT_SEARCH_RESULTS,
   MAX_SEARCH_CANDIDATES,
@@ -71,7 +74,7 @@ import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase,
   searchEvidenceRank
-} from "./index-9zkba8hr.js";
+} from "./index-7bqwzjba.js";
 import {
   MAX_SEARCH_RULE_CONFIG_BYTES,
   parseSearchRules
@@ -3548,8 +3551,8 @@ import { constants as constants2 } from "fs";
 import { open as open2 } from "fs/promises";
 import { homedir } from "os";
 import { isAbsolute as isAbsolute2, join as join4 } from "path";
-function unavailable(message) {
-  return { id: "typesafe", rerank: async () => ({ status: "unavailable", message }) };
+function unavailable(message, id = "typesafe") {
+  return { id, rerank: async () => ({ status: "unavailable", message }) };
 }
 async function createCliTypeSafeReranker(environment = process.env, homeDirectory = homedir()) {
   if (Object.hasOwn(environment, "TYPESAFE_API_KEY")) {
@@ -3582,6 +3585,9 @@ async function createCliTypeSafeReranker(environment = process.env, homeDirector
     await handle?.close();
   }
 }
+async function createCliClefReranker(environment = process.env, _homeDirectory = homedir(), model = "clef") {
+  return createClefReranker({ environment, model });
+}
 
 // src/cli-program.ts
 var defaultOutput2 = terminalOutput({
@@ -4360,6 +4366,7 @@ function parseSemanticCommand(command, arguments_) {
   let candidateLimit;
   let minScore;
   let rerank;
+  let rerankModel;
   let rerankLimit;
   let selectedPassage = false;
   let graphDepth;
@@ -4423,7 +4430,7 @@ function parseSemanticCommand(command, arguments_) {
       cursor += 1;
       continue;
     }
-    if (command === "search" && (argument === "--mode" || argument === "--limit" || argument === "--candidate-limit" || argument === "--min-score" || argument === "--rerank" || argument === "--rerank-limit" || argument === "--where" || argument === "--has" || argument === "--tag" || argument === "--scope" || argument === "--repository-scope" || argument === "--related" || argument === "--graph-depth")) {
+    if (command === "search" && (argument === "--mode" || argument === "--limit" || argument === "--candidate-limit" || argument === "--min-score" || argument === "--rerank" || argument === "--rerank-model" || argument === "--rerank-limit" || argument === "--where" || argument === "--has" || argument === "--tag" || argument === "--scope" || argument === "--repository-scope" || argument === "--related" || argument === "--graph-depth")) {
       const value = readValue(arguments_, cursor);
       if (value === null)
         return { ok: false, message: `${argument} requires a value` };
@@ -4433,10 +4440,15 @@ function parseSemanticCommand(command, arguments_) {
         }
         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) {
@@ -4576,7 +4588,10 @@ function parseSemanticCommand(command, arguments_) {
     };
   }
   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" };
@@ -4616,6 +4631,7 @@ function parseSemanticCommand(command, arguments_) {
       ...candidateLimit === undefined ? {} : { candidateLimit },
       ...minScore === undefined ? {} : { minScore },
       ...rerank === undefined ? {} : { rerank },
+      ...rerankModel === undefined ? {} : { rerankModel },
       ...rerankLimit === undefined ? {} : { rerankLimit },
       ...selectedPassage ? { selectedPassage: true } : {},
       query,
@@ -5477,7 +5493,7 @@ function renderKnowledgeBaseSearch(result) {
   ];
   const rerankLane = result.diagnostics.lanes.find(({ lane }) => lane === "rerank");
   if (rerankLane !== undefined) {
-    lines.push(`  Rerank: typesafe over ${rerankLane.results} candidates (${rerankLane.status})` + (rerankLane.message === undefined ? "" : ` \u2014 ${safe(rerankLane.message)}`));
+    lines.push(`  Rerank: ${safe(rerankLane.engine ?? "hosted")} over ${rerankLane.results} candidates (${rerankLane.status})` + (rerankLane.message === undefined ? "" : ` \u2014 ${safe(rerankLane.message)}`));
     const receipt = rerankLane.rerank;
     if (receipt?.accounting !== undefined) {
       const { attempted, candidates, completed, elapsedMs, usageComplete } = receipt.accounting;
@@ -5546,7 +5562,7 @@ async function runSemantic(command, output, dependencies) {
     repository: command.repository,
     ...command.database === undefined ? {} : { database: command.database },
     ...searchRules === undefined ? {} : { searchRules }
-  }, ...command.rerank === undefined ? [] : [{ rerankers: dependencies.rerankers ?? [await createCliTypeSafeReranker()] }]);
+  }, ...command.rerank === undefined ? [] : [{ rerankers: dependencies.rerankers ?? [command.rerank === "clef" ? await createCliClefReranker(process.env, undefined, command.rerankModel) : await createCliTypeSafeReranker()] }]);
   try {
     const result = await kb.search({
       query: command.query,

package/dist/{index-9paxge84.js → index-3hts6yy9.js}

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