feat(ai): add reranker touchpoint to LiteLLM proxy recipe (takeover of #2455)

LiteLLM normalizes Cohere/Voyage/Jina rerank backends to the wire shape
gateway.rerank() already speaks, so a reranker touchpoint on the litellm
recipe makes any proxied rerank model reachable via
`search.reranker.model litellm:<model>` with no adapter.

Repairs from the original PR:
- path is the LEAF '/rerank' (not '/v1/rerank'): LiteLLM serves both
  /rerank and /v1/rerank, and the recipe's setup_hint allows
  LITELLM_BASE_URL with or without the /v1 suffix — pinning '/v1/rerank'
  doubled to /v1/v1/rerank (404) on /v1-suffixed bases.
- setup_hint appends the rerank guidance to master's current line instead
  of replacing it with a stale pre-/v1-suffix version.
- cost_per_1m_tokens_usd stays undefined (pricing-unknown), matching the
  recipe's embedding/chat touchpoints and budget-tracker's deliberate
  litellm exclusion from the free-provider sets (a proxy can front a paid
  provider; the touchpoint field isn't consumed by rerank pricing anyway).

Test drives gateway.rerank()'s real URL builder via the stubbed transport
for both base-URL forms; the /v1-suffixed case fails with the original
PR's path.

Co-authored-by: ozp <ozp@users.noreply.github.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

src/commands/extract.ts

@@ -433,10 +433,7 @@ export async function extractLinksFromFile(
       async resolve(name: string, dirHint?: string | string[]): Promise<string | null> {
         if (!name) return null;
         const trimmed = name.trim();
-        // Same broadened slug-shape as makeResolver step 1: accepts
-        // digit-leading folders (`90-people/nicolai`) and nested paths.
-        // Exact Set membership guards it — no false positives.
-        if (/\//.test(trimmed) && /^[a-z0-9][a-z0-9/_-]*$/.test(trimmed) && allSlugs.has(trimmed)) {
+        if (/^[a-z][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/.test(trimmed) && allSlugs.has(trimmed)) {
           return trimmed;
         }
         const hints = Array.isArray(dirHint) ? dirHint : (dirHint ? [dirHint] : []);
@@ -585,17 +582,6 @@ export interface ExtractOpts {
    * before (single-'default'-source brains unaffected).
    */
   sourceId?: string;
-  /**
-   * v0.42 — also extract frontmatter links on the incremental (slugs) path.
-   * `extractForSlugs` extracts BODY links only by default; set this true to also
-   * parse each changed page's frontmatter so `sources:`/`related:` edges stay fresh
-   * when YAML is edited externally and synced in. Applied PER changed page, so the
-   * incremental walk stays bounded (no switch to a full DB scan). Only honored on
-   * the incremental path (`slugs` defined); the full-walk path already covers
-   * frontmatter via its own dispatch. Gated upstream by the config key
-   * `autopilot.incremental_extract_include_frontmatter` (default off).
-   */
-  includeFrontmatter?: boolean;
 }
 
 /**
@@ -634,7 +620,7 @@ export async function runExtractCore(engine: BrainEngine, opts: ExtractOpts): Pr
       // Nothing changed — skip entirely.
       return result;
     }
-    const r = await extractForSlugs(engine, opts.dir, opts.slugs, opts.mode, dryRun, jsonMode, workers, opts.signal, opts.sourceId, opts.includeFrontmatter);
+    const r = await extractForSlugs(engine, opts.dir, opts.slugs, opts.mode, dryRun, jsonMode, workers, opts.signal, opts.sourceId);
     result.links_created = r.links_created;
     result.timeline_entries_created = r.timeline_created;
     result.pages_processed = r.pages;
@@ -1025,11 +1011,6 @@ async function extractForSlugs(
   signal?: AbortSignal,
   // #1747/#1503: stamp resolved brain source id on batch rows (see ExtractOpts.sourceId).
   sourceId?: string,
-  // v0.42: when true, also extract frontmatter links per changed page so
-  // externally-edited YAML (`sources:`/`related:`) stays fresh on the cycle.
-  // Default false preserves the body-only incremental behavior. Gated upstream
-  // by `autopilot.incremental_extract_include_frontmatter`.
-  includeFrontmatter: boolean = false,
 ): Promise<{ links_created: number; timeline_created: number; pages: number }> {
   // Build the full slug set for link resolution (fast: just readdir, no file reads)
   const allFiles = walkMarkdownFiles(brainDir);
@@ -1104,7 +1085,7 @@ async function extractForSlugs(
         const content = readFileSync(fullPath, 'utf-8');
 
         if (doLinks) {
-          const links = await extractLinksFromFile(content, relPath, allSlugs, { globalBasename, includeFrontmatter });
+          const links = await extractLinksFromFile(content, relPath, allSlugs, { globalBasename });
           for (const link of links) {
             if (dryRun) {
               if (!jsonMode) console.log(`  ${link.from_slug} → ${link.to_slug} (${link.link_type})`);

src/core/ai/recipes/litellm-proxy.ts

@@ -56,6 +56,36 @@ export const litellmProxy: Recipe = {
       cost_per_1m_output_usd: undefined,
       price_last_verified: '2026-06-14',
     },
+    // LiteLLM normalizes Cohere / Voyage / Jina / etc. rerank backends to the
+    // same wire shape gbrain's gateway.rerank() already speaks (the
+    // ZeroEntropy/llama.cpp contract):
+    //   { model, query, documents, top_n } → { results: [{ index, relevance_score }] }
+    // So any rerank model the user registers in their LiteLLM config is
+    // reachable via `gbrain config set search.reranker.model litellm:<model>`
+    // with no request/response adapter — same as embeddings ride the proxy.
+    reranker: {
+      models: [], // user-provided; whatever rerank models the proxy serves
+      // No canonical default — the proxy defines its own model ids. The user
+      // sets search.reranker.model explicitly (mirrors the embedding
+      // touchpoint's user_provided_models contract).
+      default_model: '',
+      // The proxied backend bills (Cohere/Voyage/…); pricing-unknown is the
+      // honest state — same stance as this recipe's embedding/chat
+      // touchpoints and budget-tracker's deliberate litellm exclusion from
+      // the free-provider sets.
+      cost_per_1m_tokens_usd: undefined,
+      price_last_verified: '2026-06-27',
+      max_payload_bytes: 5_000_000,
+      // LEAF path only (matches llama-server-reranker's convention). LiteLLM
+      // serves both `/rerank` and `/v1/rerank`, and LITELLM_BASE_URL may be
+      // set with or without the `/v1` suffix (the setup_hint allows both), so
+      // the leaf form yields a valid route either way:
+      //   http://localhost:4000    + /rerank → /rerank        ✓
+      //   http://localhost:4000/v1 + /rerank → /v1/rerank     ✓
+      // Pinning '/v1/rerank' here would double to /v1/v1/rerank → 404 on
+      // /v1-suffixed bases.
+      path: '/rerank',
+    },
   },
-  setup_hint: 'Run LiteLLM (https://docs.litellm.ai) in front of any provider; set LITELLM_BASE_URL (include the /v1 suffix if your proxy serves the OpenAI route there, e.g. http://localhost:4000/v1) + pass --embedding-model litellm:<model> and --embedding-dimensions <N>.',
+  setup_hint: 'Run LiteLLM (https://docs.litellm.ai) in front of any provider; set LITELLM_BASE_URL (include the /v1 suffix if your proxy serves the OpenAI route there, e.g. http://localhost:4000/v1) + pass --embedding-model litellm:<model> and --embedding-dimensions <N>. For rerank: register a rerank model in LiteLLM and set search.reranker.model litellm:<model-name>.',
 };

src/core/config.ts

@@ -121,18 +121,6 @@ export interface GBrainConfig {
       /** Daily spend cap (USD); bounds drains/day = floor(cap / ~$0.30). Default 2.0. */
       max_usd_per_day?: number;
     };
-    /**
-     * v0.42 — keep frontmatter links fresh on the incremental cycle. The cycle's
-     * extract phase re-extracts only the slugs a sync changed, but `extractForSlugs`
-     * extracts BODY links only — frontmatter (`sources:`/`related:` etc.) link edges
-     * silently drift stale when a page's YAML is edited externally and synced in.
-     * Set true to also extract frontmatter links per changed page each cycle, keeping
-     * externally-edited YAML edges fresh without a full rescan. Default false
-     * (preserves current behavior). Read via the file/env/DB plane in the cycle's
-     * extract dispatch. Disable/enable with
-     * `gbrain config set autopilot.incremental_extract_include_frontmatter <bool>`.
-     */
-    incremental_extract_include_frontmatter?: boolean;
   };
   eval?: {
     /** false disables capture entirely. Defaults to true. */

src/core/cycle.ts

@@ -996,21 +996,6 @@ async function runPhaseExtract(
 ): Promise<PhaseResult> {
   try {
     const { runExtractCore } = await import('../commands/extract.ts');
-    const { loadConfig } = await import('./config.ts');
-    // Default off: the incremental cycle extracts body links only unless the
-    // operator opts in to keeping externally-edited frontmatter links fresh too.
-    // Both planes, file wins (env > file > DB precedence, per loadConfigWithEngine):
-    // `gbrain config set autopilot.incremental_extract_include_frontmatter true`
-    // writes the DB plane (engine.setConfig), so a file-plane-only read here
-    // would make the documented enable command a silent no-op (#2120 class).
-    const fileVal = loadConfig()?.autopilot?.incremental_extract_include_frontmatter;
-    let includeFrontmatter = fileVal === true;
-    if (fileVal === undefined) {
-      try {
-        includeFrontmatter =
-          (await engine.getConfig('autopilot.incremental_extract_include_frontmatter')) === 'true';
-      } catch { /* config table unreadable → default off */ }
-    }
     // Extract is read-mostly against the filesystem + write to links table.
     // Honor dryRun by skipping with a 'skipped' entry: extract doesn't have
     // a clean dry-run mode today and runCycle should be honest about it.
@@ -1031,7 +1016,6 @@ async function runPhaseExtract(
       slugs: changedSlugs,  // undefined = full walk (first run / manual)
       signal,
       sourceId,
-      includeFrontmatter,  // honored on the incremental (slugs) path only
     });
     const linksCreated = result?.links_created ?? 0;
     const timelineCreated = result?.timeline_entries_created ?? 0;

src/core/link-extraction.ts

@@ -942,17 +942,8 @@ export function makeResolver(
 
       const hints = Array.isArray(dirHint) ? dirHint : (dirHint ? [dirHint] : []);
 
-      // Step 1: already a slug? Try an exact page lookup for any slug-shaped
-      // value (contains '/', slug charset). Broadened beyond the original
-      // single-segment lowercase-leading form (`^[a-z][a-z0-9-]*\/[a-z0-9]...`)
-      // to also accept digit-leading folders (`90-people/nicolai`,
-      // `01-trading/...`) and nested paths (`a/b/c`) — common in PARA-numbered
-      // vaults. This is an EXACT getPage match only — no fuzzy — so it never
-      // produces a false positive; a non-existent slug just falls through to
-      // the steps below. Fixes frontmatter `related: [[dir/slug]]` values
-      // (unwrapped by unwrapWikilink) that name a real page the strict regex
-      // could not reach and whose full-path fuzzy score is below threshold.
-      if (/\//.test(trimmed) && /^[a-z0-9][a-z0-9/_-]*$/.test(trimmed)) {
+      // Step 1: already a slug? (dir/name shape, lowercase, hyphenated)
+      if (/^[a-z][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/.test(trimmed)) {
         const page = await engine.getPage(trimmed);
         if (page) {
           cache.set(cacheKey, trimmed);
@@ -1012,25 +1003,6 @@ export function makeResolver(
 
 // ─── Frontmatter extractor ──────────────────────────────────────
 
-/**
- * Unwrap an Obsidian `[[wikilink]]` frontmatter value to its bare link
- * target so the resolver (which expects bare titles / dir slugs) can match
- * it. Mainstream Obsidian authors frontmatter links as `related: ["[[Page]]"]`;
- * without this, the resolver treats the brackets as part of the value and a
- * `[[90-people/nicolai]]` is normalized into `90peoplenicolai`, so it never
- * resolves. Strips a trailing `|alias`, `#heading`, or `^block` suffix — the
- * link target only. The regex is anchored to a wholly-wrapped value
- * (`^\s*\[\[…\]\]\s*$`), so bare titles and any value not fully wrapped pass
- * through unchanged and existing behavior is preserved exactly.
- */
-export function unwrapWikilink(value: string): string {
-  const match = /^\s*\[\[(.+?)\]\]\s*$/.exec(value);
-  if (!match) return value;
-  // Take the link target: drop |alias, then #heading / ^block suffixes.
-  const target = match[1].split('|')[0].split('#')[0].split('^')[0];
-  return target.trim();
-}
-
 export interface UnresolvedFrontmatterRef {
   /** The frontmatter field name. */
   field: string;
@@ -1088,12 +1060,7 @@ export async function extractFrontmatterLinks(
         }
         if (!name) continue;   // skip numbers, nulls, malformed objects
 
-        // Accept Obsidian `[[wikilink]]` values in frontmatter link fields by
-        // unwrapping to the bare target before resolution. Bare titles pass
-        // through unchanged; the original `name` is preserved for the
-        // unresolved report and edge context.
-        const linkTarget = unwrapWikilink(name);
-        const resolved = await resolver.resolve(linkTarget, mapping.dirHint);
+        const resolved = await resolver.resolve(name, mapping.dirHint);
         if (!resolved) {
           unresolved.push({ field, name });
           continue;

test/ai/recipe-litellm-reranker.test.ts

@@ -0,0 +1,88 @@
+/**
+ * litellm-proxy reranker touchpoint smoke.
+ *
+ * Sibling of recipe-llama-server-reranker.test.ts. Pins the reranker
+ * touchpoint on the LiteLLM proxy recipe so:
+ *  - the touchpoint exists with the LEAF '/rerank' path (LiteLLM serves both
+ *    /rerank and /v1/rerank, so the leaf form is valid whether or not the
+ *    user's LITELLM_BASE_URL carries the /v1 suffix the setup_hint allows)
+ *  - a /v1-suffixed base URL does NOT produce /v1/v1/rerank (the original
+ *    community PR pinned '/v1/rerank' which 404s on /v1-suffixed bases)
+ *  - models: [] (user-provided; proxy defines the model ids)
+ *  - pricing stays undefined (proxy can front a paid provider — same honest
+ *    pricing-unknown stance as the embedding/chat touchpoints)
+ *
+ * The gateway.rerank() URL tests drive the real URL builder via the stubbed
+ * transport (same seam as test/ai/rerank.test.ts).
+ */
+
+import { describe, expect, test, afterEach } from 'bun:test';
+import { getRecipe } from '../../src/core/ai/recipes/index.ts';
+import {
+  configureGateway,
+  resetGateway,
+  rerank,
+  __setRerankTransportForTests,
+} from '../../src/core/ai/gateway.ts';
+
+afterEach(() => {
+  __setRerankTransportForTests(null);
+  resetGateway();
+});
+
+describe('recipe: litellm reranker touchpoint', () => {
+  test('declares reranker touchpoint with leaf /rerank path', () => {
+    const r = getRecipe('litellm')!;
+    const tp = r.touchpoints.reranker;
+    expect(tp).toBeDefined();
+    expect(tp!.path).toBe('/rerank');
+    expect(tp!.max_payload_bytes).toBe(5_000_000);
+  });
+
+  test('reranker touchpoint uses empty models[] for user-provided model ids', () => {
+    const r = getRecipe('litellm')!;
+    expect(r.touchpoints.reranker!.models).toEqual([]);
+  });
+
+  test('pricing stays undefined — proxy can front a paid provider', () => {
+    const r = getRecipe('litellm')!;
+    expect(r.touchpoints.reranker!.cost_per_1m_tokens_usd).toBeUndefined();
+  });
+
+  test('setup_hint keeps the /v1-suffix guidance AND mentions rerank', () => {
+    const r = getRecipe('litellm')!;
+    expect(r.setup_hint).toMatch(/\/v1 suffix/);
+    expect(r.setup_hint).toMatch(/search\.reranker\.model litellm:/);
+  });
+});
+
+describe('gateway.rerank() URL via litellm recipe', () => {
+  async function capturedRerankUrl(baseUrl?: string): Promise<string> {
+    configureGateway({
+      reranker_model: 'litellm:my-reranker',
+      env: {},
+      ...(baseUrl ? { base_urls: { litellm: baseUrl } } : {}),
+    });
+    let capturedUrl = '';
+    __setRerankTransportForTests(async (url) => {
+      capturedUrl = url;
+      return new Response(
+        JSON.stringify({ results: [{ index: 0, relevance_score: 0.9 }] }),
+        { status: 200, headers: { 'content-type': 'application/json' } },
+      );
+    });
+    await rerank({ query: 'q', documents: ['d'] });
+    return capturedUrl;
+  }
+
+  test('default base (no /v1 suffix) → /rerank', async () => {
+    const url = await capturedRerankUrl();
+    expect(url).toBe('http://localhost:4000/rerank');
+  });
+
+  test('/v1-suffixed base → /v1/rerank, NOT /v1/v1/rerank', async () => {
+    const url = await capturedRerankUrl('http://localhost:4000/v1');
+    expect(url).toBe('http://localhost:4000/v1/rerank');
+    expect(url).not.toContain('/v1/v1/');
+  });
+});

test/extract-incremental.test.ts

@@ -191,37 +191,3 @@ describe('runExtractCore — incremental cycle path (#417)', () => {
     expect(result.links_created).toBeGreaterThan(0);
   });
 });
-describe('runExtractCore — incremental frontmatter gate (includeFrontmatter)', () => {
-  // alice has a `source:` frontmatter edge but NO body links. The incremental
-  // path extracts body links only by default, so the frontmatter edge is the
-  // sole signal that distinguishes the gate off vs on.
-  const aliceFm = '---\nsource: companies/acme-example\n---\n# alice';
-
-  test('9. default (flag omitted) does NOT extract frontmatter links on the incremental path', async () => {
-    await seedPage('companies/acme-example', '# acme');
-    await seedPage('people/alice-example', aliceFm);
-    const result = await runExtractCore(engine as unknown as BrainEngine, {
-      mode: 'all',
-      dir: tempDir,
-      slugs: ['people/alice-example'],
-    });
-    // alice's only potential edge is her frontmatter `source:`; with the gate off
-    // it must not be extracted (preserves the body-only incremental behavior).
-    expect(result.pages_processed).toBe(1);
-    expect(result.links_created).toBe(0);
-  });
-
-  test('10. includeFrontmatter: true extracts the frontmatter link on the incremental path', async () => {
-    await seedPage('companies/acme-example', '# acme');
-    await seedPage('people/alice-example', aliceFm);
-    const result = await runExtractCore(engine as unknown as BrainEngine, {
-      mode: 'all',
-      dir: tempDir,
-      slugs: ['people/alice-example'],
-      includeFrontmatter: true,
-    });
-    // Same page, gate on → the `source:` frontmatter edge is now extracted.
-    expect(result.pages_processed).toBe(1);
-    expect(result.links_created).toBeGreaterThan(0);
-  });
-});

test/extract.test.ts

@@ -76,18 +76,6 @@ describe('extractLinksFromFile', () => {
     }
   });
 
-  it('resolves wrapped [[wikilink]] digit-leading slug-path in frontmatter (fs resolver, broadened step 1)', async () => {
-    // Same bug class as makeResolver step 1 (#1983): the fs resolver's strict
-    // `^[a-z]…` slug regex rejected digit-leading / nested paths, so a PARA-vault
-    // `related: "[[90-people/nicolai]]"` never resolved even though the page exists.
-    const content = '---\nrelated: "[[90-people/nicolai]]"\ntype: concept\n---\nContent.';
-    const allSlugs = new Set(['wiki/note', '90-people/nicolai']);
-    const links = await extractLinksFromFile(content, 'wiki/note.md', allSlugs, { includeFrontmatter: true });
-    const related = links.filter(l => l.link_type === 'related_to');
-    expect(related).toHaveLength(1);
-    expect(related[0].to_slug).toBe('90-people/nicolai');
-  });
-
   it('frontmatter extraction is default OFF (back-compat)', async () => {
     // Without includeFrontmatter, fs-source no longer auto-extracts frontmatter.
     // Matches db-source behavior. User opts in with --include-frontmatter flag.

test/link-extraction.test.ts

@@ -9,7 +9,6 @@ import {
   parseTimelineEntries,
   isAutoLinkEnabled,
   FRONTMATTER_LINK_MAP,
-  unwrapWikilink,
   type SlugResolver,
 } from '../src/core/link-extraction.ts';
 import type { BrainEngine } from '../src/core/engine.ts';
@@ -1292,175 +1291,3 @@ describe('parseTimelineEntries — Format 3: inline [Source: ..., YYYY-MM-DD] ci
     expect(parseTimelineEntries('[Source: import batch, 2025-07-01]')).toHaveLength(0);
   });
 });
-// ─── Frontmatter [[wikilink]] + slug-path resolution ──────────────────────
-// Mainstream Obsidian authors frontmatter links as `related: ["[[Page]]"]`,
-// and PARA-numbered vaults use digit-leading / nested slug paths like
-// `[[90-people/nicolai]]`. Both were silently dropped: brackets were treated
-// as part of the value and the step-1 slug regex (`^[a-z]…`) rejected
-// digit-leading / nested paths, while full-path fuzzy scored below threshold.
-// Fix: unwrapWikilink() before resolution + an exact getPage() for any
-// slug-shaped value (exact-match only → no false positives).
-
-describe('unwrapWikilink', () => {
-  test('wrapped title → bare title', () => {
-    expect(unwrapWikilink('[[Monday Range]]')).toBe('Monday Range');
-  });
-  test('wrapped slug-path (digit-leading folder) → bare slug', () => {
-    expect(unwrapWikilink('[[90-people/nicolai]]')).toBe('90-people/nicolai');
-  });
-  test('wrapped nested slug-path → bare slug', () => {
-    expect(unwrapWikilink('[[01-trading/wiki/strategies/opening-range-breakout]]'))
-      .toBe('01-trading/wiki/strategies/opening-range-breakout');
-  });
-  test('strips |alias', () => {
-    expect(unwrapWikilink('[[90-people/nicolai|Nicolai]]')).toBe('90-people/nicolai');
-  });
-  test('strips #heading', () => {
-    expect(unwrapWikilink('[[Page#Section]]')).toBe('Page');
-  });
-  test('strips ^block', () => {
-    expect(unwrapWikilink('[[Page^abc123]]')).toBe('Page');
-  });
-  test('surrounding whitespace tolerated', () => {
-    expect(unwrapWikilink('  [[Page]]  ')).toBe('Page');
-  });
-  test('bare title passes through unchanged', () => {
-    expect(unwrapWikilink('Monday Range')).toBe('Monday Range');
-  });
-  test('bare slug passes through unchanged', () => {
-    expect(unwrapWikilink('90-people/nicolai')).toBe('90-people/nicolai');
-  });
-  test('partially-wrapped value is NOT unwrapped (anchored)', () => {
-    // Not a wholly-wrapped value → left intact so existing behavior is exact.
-    expect(unwrapWikilink('see [[Page]] for detail')).toBe('see [[Page]] for detail');
-  });
-});
-
-describe('makeResolver — slug-path exact getPage (step 1 broadened)', () => {
-  function fakeEngine(
-    slugs: string[],
-    fuzzyMap: Map<string, { slug: string; similarity: number }> = new Map(),
-  ): BrainEngine {
-    const lookup = new Set(slugs);
-    return {
-      async getPage(slug: string) { return lookup.has(slug) ? { slug } as any : null; },
-      async findByTitleFuzzy(name: string) { return fuzzyMap.get(name) ?? null; },
-      async searchKeyword() { return []; },
-    } as unknown as BrainEngine;
-  }
-
-  test('digit-leading folder slug resolves via exact getPage', async () => {
-    const r = makeResolver(fakeEngine(['90-people/nicolai']));
-    expect(await r.resolve('90-people/nicolai')).toBe('90-people/nicolai');
-  });
-
-  test('nested (>2 segment) slug resolves via exact getPage', async () => {
-    const r = makeResolver(fakeEngine(['01-trading/wiki/strategies/opening-range-breakout']));
-    expect(await r.resolve('01-trading/wiki/strategies/opening-range-breakout'))
-      .toBe('01-trading/wiki/strategies/opening-range-breakout');
-  });
-
-  test('regression: single-segment lowercase slug still resolves', async () => {
-    const r = makeResolver(fakeEngine(['people/pedro']));
-    expect(await r.resolve('people/pedro')).toBe('people/pedro');
-  });
-
-  test('exact-only: slug-shaped value with no matching page falls through (no false positive)', async () => {
-    // `90-people/ghost` is slug-shaped but absent → step-1 getPage misses,
-    // no fuzzy hit → null. Never invents an edge.
-    const r = makeResolver(fakeEngine(['90-people/nicolai']));
-    expect(await r.resolve('90-people/ghost')).toBeNull();
-  });
-
-  test('non-slug value still routes to fuzzy', async () => {
-    const r = makeResolver(fakeEngine(
-      ['01-trading/monday-range'],
-      new Map([['Monday Range', { slug: '01-trading/monday-range', similarity: 1 }]]),
-    ));
-    expect(await r.resolve('Monday Range')).toBe('01-trading/monday-range');
-  });
-});
-
-describe('extractFrontmatterLinks — [[wikilink]] related: values (end-to-end)', () => {
-  function fakeEngine(
-    slugs: string[],
-    fuzzyMap: Map<string, { slug: string; similarity: number }> = new Map(),
-  ): BrainEngine {
-    const lookup = new Set(slugs);
-    return {
-      async getPage(slug: string) { return lookup.has(slug) ? { slug } as any : null; },
-      async findByTitleFuzzy(name: string) { return fuzzyMap.get(name) ?? null; },
-      async searchKeyword() { return []; },
-    } as unknown as BrainEngine;
-  }
-
-  test('wrapped slug-path related: resolves (the core win)', async () => {
-    const resolver = makeResolver(fakeEngine(['90-people/nicolai']));
-    const { candidates, unresolved } = await extractFrontmatterLinks(
-      'wiki/originals/ideas/note', 'note' as never,
-      { related: '[[90-people/nicolai]]' }, resolver,
-    );
-    expect(unresolved).toHaveLength(0);
-    expect(candidates).toHaveLength(1);
-    expect(candidates[0]).toMatchObject({
-      fromSlug: 'wiki/originals/ideas/note',
-      targetSlug: '90-people/nicolai',
-      linkType: 'related_to',
-      linkSource: 'frontmatter',
-    });
-  });
-
-  test('wrapped nested slug-path related: resolves', async () => {
-    const resolver = makeResolver(fakeEngine(['01-trading/wiki/strategies/opening-range-breakout']));
-    const { candidates } = await extractFrontmatterLinks(
-      'wiki/note', 'note' as never,
-      { related: ['[[01-trading/wiki/strategies/opening-range-breakout]]'] }, resolver,
-    );
-    expect(candidates).toHaveLength(1);
-    expect(candidates[0].targetSlug).toBe('01-trading/wiki/strategies/opening-range-breakout');
-  });
-
-  test('wrapped value with |alias resolves to the target', async () => {
-    const resolver = makeResolver(fakeEngine(['90-people/nicolai']));
-    const { candidates } = await extractFrontmatterLinks(
-      'wiki/note', 'note' as never,
-      { related: '[[90-people/nicolai|Nicolai]]' }, resolver,
-    );
-    expect(candidates).toHaveLength(1);
-    expect(candidates[0].targetSlug).toBe('90-people/nicolai');
-  });
-
-  test('regression: bare slug related: still resolves', async () => {
-    const resolver = makeResolver(fakeEngine(['90-people/nicolai']));
-    const { candidates } = await extractFrontmatterLinks(
-      'wiki/note', 'note' as never,
-      { related: '90-people/nicolai' }, resolver,
-    );
-    expect(candidates).toHaveLength(1);
-    expect(candidates[0].targetSlug).toBe('90-people/nicolai');
-  });
-
-  test('regression: wrapped title resolves via fuzzy (brackets harmless)', async () => {
-    const resolver = makeResolver(fakeEngine(
-      ['01-trading/monday-range'],
-      new Map([['Monday Range', { slug: '01-trading/monday-range', similarity: 1 }]]),
-    ));
-    const { candidates } = await extractFrontmatterLinks(
-      'wiki/note', 'note' as never,
-      { related: '[[Monday Range]]' }, resolver,
-    );
-    expect(candidates).toHaveLength(1);
-    expect(candidates[0].targetSlug).toBe('01-trading/monday-range');
-  });
-
-  test('unknown wrapped slug → unresolved (no crash), original value preserved', async () => {
-    const resolver = makeResolver(fakeEngine(['90-people/nicolai']));
-    const { candidates, unresolved } = await extractFrontmatterLinks(
-      'wiki/note', 'note' as never,
-      { related: '[[99-archive/does-not-exist]]' }, resolver,
-    );
-    expect(candidates).toHaveLength(0);
-    expect(unresolved).toHaveLength(1);
-    expect(unresolved[0]).toEqual({ field: 'related', name: '[[99-archive/does-not-exist]]' });
-  });
-});