oh-my-second-brain 0.2.0 → 0.6.1

package/dist/mcp/link-tools.d.ts

@@ -1,78 +1,31 @@
-/**
- * MCP wiring for the linkify core: vault I/O + candidate universe for the
- * `oms_link_suggest` / `oms_link_apply` tools.
- *
- * The linkify core (mask → suggest → apply) is pure and dependency-injected; it
- * knows nothing about vaults, ontologies, or the filesystem. This module owns
- * exactly that translation and nothing else, so server.ts stays a dispatcher.
- *
- * Candidate identity is DERIVED, never cached. A candidate id is its body span,
- * and apply re-runs the same deterministic suggest pass over the note as it
- * exists right now. Two consequences that matter: the server holds no
- * cross-call state (a restart changes nothing), and a note edited between
- * suggest and apply is caught by the base-hash check the kernel-facing
- * `applyLinks` performs before any write.
- */
-import type { WriteTargetSource } from "../conventions/write-protocol.js";
-import type { Ontology } from "../core/ontology/types.js";
-import { type ApplyResult } from "../engine/linkify/apply.js";
-import type { LinkCandidate, TermNote } from "../engine/linkify/types.js";
+import type { ApplyResult } from "../kernel/engine/linkify/apply.js";
+import type { LinkCandidate } from "../kernel/engine/linkify/types.js";
+import { type LinkScope, type LinkWorkflowTarget } from "../kernel/link/workflow.js";
 /** A candidate as the MCP surface reports it: the core shape plus a stable id. */
 export interface IdentifiedCandidate extends LinkCandidate {
-    /** Deterministic handle a client passes back to `oms_link_apply`. */
     readonly id: string;
 }
 /** Payload of a successful `oms_link_suggest` call. */
 export interface LinkSuggestion {
     readonly notePath: string;
-    /** sha256 of the body the candidates were computed against (apply's token). */
     readonly baseContentHash: string;
     readonly candidateNotes: number;
     readonly candidates: readonly IdentifiedCandidate[];
 }
-/** Everything both link tools need to address a vault note. */
-export interface LinkToolTarget {
-    readonly vault: string;
-    readonly source: WriteTargetSource;
-    readonly ontology: Ontology;
-    /** Vault-relative markdown path of the note being linkified. */
-    readonly notePath: string;
-}
+/** Everything the MCP link operations need to address a vault note. */
+export type LinkToolTarget = LinkWorkflowTarget;
 /** Restrict the candidate universe to one top-level vault folder. */
-export interface LinkScope {
-    readonly folder?: string | undefined;
-}
-/**
- * Every `term`-bound note in the vault, with its declared surface forms.
- *
- * Concept binding comes from the ontology's folder contract (the same resolver
- * the write kernel uses), NOT from a frontmatter field a note can claim for
- * itself — a note cannot opt into being a link target by asserting it is one.
- */
-export declare function collectTermNotes(vault: string, ontology: Ontology, scope?: LinkScope): Promise<TermNote[]>;
-/**
- * Propose `[[wikilink]]` insertions for one note against the vault's term notes.
- *
- * Read-only: nothing is written and no state is retained. The returned
- * `baseContentHash` is the caller's optimistic-concurrency token for apply.
- */
-export declare function suggestLinksForNote(target: LinkToolTarget, scope?: LinkScope): Promise<LinkSuggestion>;
+export type { LinkScope };
 /** Payload of an `oms_link_apply` call: the core result plus what was selected. */
 export interface LinkApplyOutcome {
     readonly notePath: string;
     readonly requestedIds: readonly string[];
-    /** Requested ids that still name a live span in the note's current body. */
     readonly resolvedIds: readonly string[];
     readonly result: ApplyResult;
 }
-/**
- * Apply the selected candidates to a note and persist through the write kernel.
- *
- * The candidates are recomputed from the note's CURRENT body: ids that no
- * longer name a span simply do not resolve, and a body that drifted since
- * suggest fails the `baseContentHash` check inside `applyLinks` before any
- * write is attempted.
- */
+/** Invoke the transport-neutral suggestion workflow and retain the MCP contract. */
+export declare function suggestLinksForNote(target: LinkToolTarget, scope?: LinkScope): Promise<LinkSuggestion>;
+/** Invoke the transport-neutral apply workflow and retain the MCP contract. */
 export declare function applyLinksForNote(target: LinkToolTarget, selection: {
     readonly baseContentHash: string;
     readonly candidateIds: readonly string[];

package/dist/mcp/link-tools.js

@@ -1,135 +1,11 @@
-/**
- * MCP wiring for the linkify core: vault I/O + candidate universe for the
- * `oms_link_suggest` / `oms_link_apply` tools.
- *
- * The linkify core (mask → suggest → apply) is pure and dependency-injected; it
- * knows nothing about vaults, ontologies, or the filesystem. This module owns
- * exactly that translation and nothing else, so server.ts stays a dispatcher.
- *
- * Candidate identity is DERIVED, never cached. A candidate id is its body span,
- * and apply re-runs the same deterministic suggest pass over the note as it
- * exists right now. Two consequences that matter: the server holds no
- * cross-call state (a restart changes nothing), and a note edited between
- * suggest and apply is caught by the base-hash check the kernel-facing
- * `applyLinks` performs before any write.
- */
-import { readdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { safeVaultNotePath, writeNote } from "../capture/safe.js";
-import { parseNote } from "../conventions/frontmatter.js";
-import { resolveConcept } from "../core/ontology/resolver.js";
-import { applyLinks, hashBody } from "../engine/linkify/apply.js";
-import { suggestLinks, TERM_CONCEPT, termBoundNotes } from "../engine/linkify/suggest.js";
-/** A candidate id is the body span it claims — stable across identical bodies. */
-function candidateId(candidate) {
-    return `${String(candidate.startOffset)}-${String(candidate.endOffset)}`;
-}
-function identify(candidate) {
-    return { ...candidate, id: candidateId(candidate) };
-}
-/** Walk vault markdown, skipping dotted, dependency, and internal directories. */
-async function* walkMarkdown(dir, base) {
-    const entries = await readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (entry.name.startsWith(".") || entry.name === "node_modules")
-            continue;
-        const full = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            yield* walkMarkdown(full, base);
-        }
-        else if (entry.isFile() && entry.name.endsWith(".md")) {
-            yield path.relative(base, full).replace(/\\/g, "/");
-        }
-    }
-}
-/** Flatten a frontmatter `aliases` value to trimmed non-empty strings. */
-function aliasStrings(value) {
-    if (Array.isArray(value))
-        return value.flatMap(aliasStrings);
-    if (typeof value !== "string")
-        return [];
-    const trimmed = value.trim();
-    return trimmed ? [trimmed] : [];
-}
-/**
- * Every `term`-bound note in the vault, with its declared surface forms.
- *
- * Concept binding comes from the ontology's folder contract (the same resolver
- * the write kernel uses), NOT from a frontmatter field a note can claim for
- * itself — a note cannot opt into being a link target by asserting it is one.
- */
-export async function collectTermNotes(vault, ontology, scope = {}) {
-    const root = scope.folder === undefined ? vault : path.join(vault, scope.folder);
-    const notes = [];
-    for await (const notePath of walkMarkdown(root, vault)) {
-        const concept = resolveConcept(ontology, notePath);
-        if (concept?.concept !== TERM_CONCEPT)
-            continue;
-        const raw = await readFile(path.join(vault, notePath), "utf-8");
-        notes.push({
-            path: notePath,
-            concept: concept.concept,
-            aliases: aliasStrings(parseNote(raw).frontmatter["aliases"]),
-        });
-    }
-    return termBoundNotes(notes);
-}
-/** Read one vault note's body, refusing unsafe paths and missing files loudly. */
-async function readNoteBody(vault, notePath) {
-    const fullPath = safeVaultNotePath(vault, notePath);
-    const raw = await readFile(fullPath, "utf-8");
-    return {
-        normalized: path.relative(vault, fullPath).replace(/\\/g, "/"),
-        body: parseNote(raw).body,
-    };
-}
-/**
- * Propose `[[wikilink]]` insertions for one note against the vault's term notes.
- *
- * Read-only: nothing is written and no state is retained. The returned
- * `baseContentHash` is the caller's optimistic-concurrency token for apply.
- */
+import { applyLinksForNote as applyWorkflowLinksForNote, suggestLinksForNote as suggestWorkflowLinksForNote, } from "../kernel/link/workflow.js";
+/** Invoke the transport-neutral suggestion workflow and retain the MCP contract. */
 export async function suggestLinksForNote(target, scope = {}) {
-    const { normalized, body } = await readNoteBody(target.vault, target.notePath);
-    const notes = await collectTermNotes(target.vault, target.ontology, scope);
-    const candidates = suggestLinks(body, notes, { notePath: normalized });
-    return {
-        notePath: normalized,
-        baseContentHash: hashBody(body),
-        candidateNotes: notes.length,
-        candidates: candidates.map(identify),
-    };
+    return suggestWorkflowLinksForNote(target, scope);
 }
-/**
- * Apply the selected candidates to a note and persist through the write kernel.
- *
- * The candidates are recomputed from the note's CURRENT body: ids that no
- * longer name a span simply do not resolve, and a body that drifted since
- * suggest fails the `baseContentHash` check inside `applyLinks` before any
- * write is attempted.
- */
+/** Invoke the transport-neutral apply workflow and retain the MCP contract. */
 export async function applyLinksForNote(target, selection, scope = {}) {
-    const { normalized, body } = await readNoteBody(target.vault, target.notePath);
-    const notes = await collectTermNotes(target.vault, target.ontology, scope);
-    const wanted = new Set(selection.candidateIds);
-    const accepted = suggestLinks(body, notes, { notePath: normalized }).filter((candidate) => wanted.has(candidateId(candidate)));
-    const result = await applyLinks({
-        body,
-        baseContentHash: selection.baseContentHash,
-        accepted,
-        writeNote,
-        target: {
-            target: { vault: target.vault, source: target.source },
-            ontology: target.ontology,
-            notePath: normalized,
-        },
-    });
-    return {
-        notePath: normalized,
-        requestedIds: selection.candidateIds,
-        resolvedIds: accepted.map(candidateId),
-        result,
-    };
+    return applyWorkflowLinksForNote(target, selection, scope);
 }
 /** The MCP-facing JSON shape of an apply outcome: applied body + receipt, or a typed refusal. */
 export function linkApplyPayload(outcome) {

package/dist/mcp/link-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"link-tools.js","sourceRoot":"","sources":["../../src/mcp/link-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"link-tools.js","sourceRoot":"","sources":["../../src/mcp/link-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,IAAI,yBAAyB,EAC9C,mBAAmB,IAAI,2BAA2B,GAGnD,MAAM,4BAA4B,CAAC;AA6BpC,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAsB,EAAE,QAAmB,EAAE;IACrF,OAAO,2BAA2B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAsB,EACtB,SAAyF,EACzF,QAAmB,EAAE;IAErB,OAAO,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,OAAO,MAAM,CAAC,OAAO;QACnB,CAAC,CAAC;YACE,GAAG,MAAM;YACT,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI;SACtC;QACH,CAAC,CAAC;YACE,GAAG,MAAM;YACT,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;SAC5B,CAAC;AACR,CAAC"}

package/dist/mcp/server.d.ts

@@ -1,10 +1,17 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { type Tool } from "@modelcontextprotocol/sdk/types.js";
-import type { WriteTargetSource } from "../conventions/write-protocol.js";
-export declare const BASE_SERVER_INSTRUCTIONS = "Oh My Second Brain exposes ontology/status/cache/retrieval tools and the write tool. write is gated by a verified vault target (a vault inferred from the current directory is refused), vault confinement, and contract validation.";
+import type { WriteTargetSource } from "../kernel/conventions/write-protocol.js";
+import type { Reranker } from "../kernel/engine/retrieval/reranker.js";
+export declare const BASE_SERVER_INSTRUCTIONS = "Oh My Second Brain exposes write, search, link, status, and doctor tools. oms_write and doctor repair operations are gated by a verified vault target (a vault inferred from the current directory is refused); oms_write also enforces vault confinement and contract validation.";
 export declare const omsMcpTools: Tool[];
 export interface OMSMcpServerOptions {
     vault: string;
+    /**
+     * Real cross-encoder used only for requests that explicitly set
+     * `rerank: true`. Without one, those requests fail rather than silently
+     * returning the unranked result.
+     */
+    reranker?: Reranker;
     /**
      * How the vault was resolved. The write surface trusts every source except
      * `cwd` (the server may have booted in an arbitrary directory - issue #58).