oh-my-second-brain 0.1.8 → 0.2.0

package/dist/mcp/update-notice.d.ts

@@ -0,0 +1,51 @@
+import { type UpdateRunner } from "../update/update.js";
+/**
+ * Boot-time update nudge for the MCP server.
+ *
+ * The hot path (`cachedUpdateNotice`) only reads a small JSON cache; it never
+ * touches the network and never throws. The registry query lives in
+ * `refreshUpdateNoticeCache`, scheduled detached from the serve path so a slow
+ * or offline registry cannot delay or fail server startup. Nothing here writes
+ * stdout: stdout is the JSON-RPC transport.
+ */
+export type UpdateChannel = "stable" | "prerelease";
+export interface CachedUpdateNoticeOptions {
+    readonly installedVersion: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly now?: number;
+}
+export interface RefreshUpdateNoticeCacheOptions extends CachedUpdateNoticeOptions {
+    readonly runner?: UpdateRunner;
+    readonly timeoutMs?: number;
+}
+export declare function updateNoticeCachePath(env?: Readonly<Record<string, string | undefined>>): string;
+export declare function updateChannelOf(installedVersion: string): UpdateChannel;
+/**
+ * Reads the cached latest version for the installed channel and renders a
+ * one-line nudge when that version is newer and the stamp is within the 24h
+ * TTL. Freshness is per channel, so a stable refresh never makes an older
+ * prerelease stamp look current. Returns null on every failure or suppression.
+ */
+export declare function cachedUpdateNotice(options: CachedUpdateNoticeOptions): string | null;
+/**
+ * Performs ONE bounded registry query and stores the result under the
+ * installed channel's stamp, preserving the other channel's stamp. Awaitable
+ * for tests; production calls it detached via `scheduleUpdateNoticeRefresh`.
+ * Fails open: any error leaves the cache untouched and resolves normally.
+ */
+export declare function refreshUpdateNoticeCache(options: RefreshUpdateNoticeCacheOptions): Promise<void>;
+/**
+ * Serve-path entrypoint: starts at most one detached refresh per process. Never
+ * awaited by the caller, so startup latency is unaffected.
+ *
+ * Skips the registry entirely while the installed channel's stamp is still
+ * within the TTL: a fresh cache already answers the boot-time question, so
+ * every serve boot inside that window costs zero subprocesses. Returns the
+ * detached promise when a refresh was started and null when none was needed,
+ * so tests can await the background work without a timer.
+ */
+export declare function scheduleUpdateNoticeRefresh(options: RefreshUpdateNoticeCacheOptions): Promise<void> | null;
+/** Clears the per-process refresh lock. Test-only seam. */
+export declare function __resetUpdateNoticeRefreshLockForTests(): void;
+/** Appends the nudge to the server's base instructions as a single extra line. */
+export declare function buildServerInstructions(baseInstructions: string, nudge: string | null): string;

package/dist/mcp/update-notice.js

@@ -0,0 +1,196 @@
+import { closeSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { compareVersions, resolveLatestVersion } from "../update/update.js";
+const CACHE_FILE_NAME = "update-notice-cache.json";
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const REFRESH_TIMEOUT_MS = 4_000;
+const PACKAGE_NAME = "oh-my-second-brain";
+let refreshStarted = false;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function noticeSuppressed(env) {
+    return env["OMS_UPDATE_NOTICE"] === "0" || env["OMS_NO_UPDATE_NOTICE"] === "1";
+}
+export function updateNoticeCachePath(env = process.env) {
+    const stateDir = env["OMS_AUTO_UPDATE_STATE_DIR"];
+    const dir = stateDir !== undefined && stateDir.length > 0 ? stateDir : path.join(os.homedir(), ".oms");
+    return path.join(dir, CACHE_FILE_NAME);
+}
+export function updateChannelOf(installedVersion) {
+    return installedVersion.includes("-") ? "prerelease" : "stable";
+}
+function parseStamp(value) {
+    if (!isRecord(value))
+        return null;
+    const latestVersion = value["latestVersion"];
+    const checkedAt = value["checkedAt"];
+    if (typeof latestVersion !== "string" || latestVersion.length === 0)
+        return null;
+    if (typeof checkedAt !== "number" || !Number.isFinite(checkedAt))
+        return null;
+    return { latestVersion, checkedAt };
+}
+function readCache(cachePath) {
+    let raw;
+    try {
+        raw = readFileSync(cachePath, "utf-8");
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return null;
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return null;
+        throw error;
+    }
+    if (!isRecord(parsed) || parsed["version"] !== 1 || !isRecord(parsed["channels"]))
+        return null;
+    const channels = {};
+    for (const channel of ["stable", "prerelease"]) {
+        const stamp = parseStamp(parsed["channels"][channel]);
+        if (stamp !== null)
+            channels[channel] = stamp;
+    }
+    return { version: 1, channels };
+}
+/** True when the channel's stamp exists and is within the 24h TTL. */
+function stampIsFresh(stamp, now) {
+    if (stamp === undefined)
+        return false;
+    const age = now - stamp.checkedAt;
+    return age >= 0 && age <= CACHE_TTL_MS;
+}
+/**
+ * Reads the cached latest version for the installed channel and renders a
+ * one-line nudge when that version is newer and the stamp is within the 24h
+ * TTL. Freshness is per channel, so a stable refresh never makes an older
+ * prerelease stamp look current. Returns null on every failure or suppression.
+ */
+export function cachedUpdateNotice(options) {
+    const env = options.env ?? process.env;
+    if (noticeSuppressed(env))
+        return null;
+    const cache = readCache(updateNoticeCachePath(env));
+    if (cache === null)
+        return null;
+    const stamp = cache.channels[updateChannelOf(options.installedVersion)];
+    if (stamp === undefined)
+        return null;
+    if (!stampIsFresh(stamp, options.now ?? Date.now()))
+        return null;
+    if (compareVersions(options.installedVersion, stamp.latestVersion) >= 0)
+        return null;
+    return `Update available for Oh My Second Brain: ${options.installedVersion} -> ${stamp.latestVersion}. Run \`oms update --yes\` to update and refresh host adapters.`;
+}
+function reclaimStaleLock(lockPath) {
+    let lockedAt;
+    try {
+        lockedAt = statSync(lockPath).mtimeMs;
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return;
+        throw error;
+    }
+    if (Date.now() - lockedAt > CACHE_TTL_MS)
+        rmSync(lockPath, { force: true });
+}
+function writeCacheAtomically(cachePath, cache) {
+    const dir = path.dirname(cachePath);
+    mkdirSync(dir, { recursive: true });
+    // Cross-process serialization: whoever creates the lock wins this round; a
+    // loser simply skips the write, because a missed refresh is harmless. A lock
+    // left behind by a killed process is reclaimed once it is older than the TTL,
+    // so a crash cannot silence update checks forever.
+    const lockPath = `${cachePath}.lock`;
+    reclaimStaleLock(lockPath);
+    const lockFd = openSync(lockPath, "wx");
+    const tempPath = `${cachePath}.${process.pid}.tmp`;
+    try {
+        writeFileSync(tempPath, `${JSON.stringify(cache)}\n`, "utf-8");
+        renameSync(tempPath, cachePath);
+    }
+    finally {
+        rmSync(tempPath, { force: true });
+        closeSync(lockFd);
+        unlinkSync(lockPath);
+    }
+}
+/**
+ * Performs ONE bounded registry query and stores the result under the
+ * installed channel's stamp, preserving the other channel's stamp. Awaitable
+ * for tests; production calls it detached via `scheduleUpdateNoticeRefresh`.
+ * Fails open: any error leaves the cache untouched and resolves normally.
+ */
+export async function refreshUpdateNoticeCache(options) {
+    const env = options.env ?? process.env;
+    if (noticeSuppressed(env))
+        return;
+    const cachePath = updateNoticeCachePath(env);
+    try {
+        const latest = await resolveLatestVersion({
+            packageName: PACKAGE_NAME,
+            timeoutMs: options.timeoutMs ?? REFRESH_TIMEOUT_MS,
+            runner: options.runner,
+            latestVersion: env["OMS_UPDATE_LATEST_VERSION"],
+        });
+        if (!latest.ok)
+            return;
+        const existing = readCache(cachePath);
+        writeCacheAtomically(cachePath, {
+            version: 1,
+            channels: {
+                ...existing?.channels,
+                [updateChannelOf(options.installedVersion)]: {
+                    latestVersion: latest.version,
+                    checkedAt: options.now ?? Date.now(),
+                },
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return;
+        throw error;
+    }
+}
+/**
+ * Serve-path entrypoint: starts at most one detached refresh per process. Never
+ * awaited by the caller, so startup latency is unaffected.
+ *
+ * Skips the registry entirely while the installed channel's stamp is still
+ * within the TTL: a fresh cache already answers the boot-time question, so
+ * every serve boot inside that window costs zero subprocesses. Returns the
+ * detached promise when a refresh was started and null when none was needed,
+ * so tests can await the background work without a timer.
+ */
+export function scheduleUpdateNoticeRefresh(options) {
+    if (refreshStarted)
+        return null;
+    const env = options.env ?? process.env;
+    if (noticeSuppressed(env))
+        return null;
+    const cache = readCache(updateNoticeCachePath(env));
+    const stamp = cache?.channels[updateChannelOf(options.installedVersion)];
+    if (stampIsFresh(stamp, options.now ?? Date.now()))
+        return null;
+    refreshStarted = true;
+    return refreshUpdateNoticeCache(options);
+}
+/** Clears the per-process refresh lock. Test-only seam. */
+export function __resetUpdateNoticeRefreshLockForTests() {
+    refreshStarted = false;
+}
+/** Appends the nudge to the server's base instructions as a single extra line. */
+export function buildServerInstructions(baseInstructions, nudge) {
+    return nudge === null ? baseInstructions : `${baseInstructions}\n${nudge}`;
+}
+//# sourceMappingURL=update-notice.js.map

package/dist/mcp/update-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-notice.js","sourceRoot":"","sources":["../../src/mcp/update-notice.ts"],"names":[],"mappings":"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"}

package/dist/ontology/active.d.ts

@@ -0,0 +1,7 @@
+import type { Ontology } from "../core/ontology/types.js";
+export type ActiveOntologySource = "vault" | "bundled";
+export interface ActiveOntology {
+    readonly ontology: Ontology;
+    readonly source: ActiveOntologySource;
+}
+export declare function resolveActiveOntology(vault: string): Promise<ActiveOntology>;

package/dist/ontology/active.js

@@ -0,0 +1,41 @@
+import { stat } from "node:fs/promises";
+import path from "node:path";
+import { resolveBundledAssetPaths } from "../core/runtime/assets.js";
+import { loadOntology } from "../core/ontology/loader.js";
+const bundledAssets = resolveBundledAssetPaths();
+async function pathKind(target) {
+    try {
+        const info = await stat(target);
+        if (info.isFile())
+            return "file";
+        if (info.isDirectory())
+            return "directory";
+        return "other";
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return "missing";
+        }
+        throw error;
+    }
+}
+export async function resolveActiveOntology(vault) {
+    const localOntologyDir = path.join(vault, ".oms");
+    const omsKind = await pathKind(localOntologyDir);
+    if (omsKind === "missing") {
+        return { ontology: await loadOntology(bundledAssets.ontologyDir), source: "bundled" };
+    }
+    if (omsKind !== "directory") {
+        throw new Error("Local .oms exists but is not a directory.");
+    }
+    const taxonomyKind = await pathKind(path.join(localOntologyDir, "taxonomy.yaml"));
+    const conceptsKind = await pathKind(path.join(localOntologyDir, "concepts"));
+    if (taxonomyKind === "missing" && conceptsKind === "missing") {
+        return { ontology: await loadOntology(bundledAssets.ontologyDir), source: "bundled" };
+    }
+    if (taxonomyKind !== "file" || conceptsKind !== "directory") {
+        throw new Error("Local .oms ontology is incomplete; expected .oms/taxonomy.yaml and .oms/concepts/.");
+    }
+    return { ontology: await loadOntology(localOntologyDir), source: "vault" };
+}
+//# sourceMappingURL=active.js.map

package/dist/ontology/active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active.js","sourceRoot":"","sources":["../../src/ontology/active.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAU1D,MAAM,aAAa,GAAG,wBAAwB,EAAE,CAAC;AAEjD,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO,MAAM,CAAC;QACjC,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,WAAW,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAa;IACvD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;IAE7E,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,YAAY,KAAK,MAAM,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;IACxG,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7E,CAAC"}

package/dist/retrieve/morning.d.ts

@@ -1,5 +1,5 @@
 import { type GraphExploreNode, type GraphExploreOptions, type GraphExploreResult } from "../graph/explore.js";
-import { type SemanticDocument, type SemanticDocumentResult, type SemanticEmbeddingSyncResult, type SemanticGetOptions, type SemanticHitEvidence, type SemanticMultiGetOptions, type SemanticProviderStatus, type SemanticQueryOptions, type SemanticQueryResult, type SemanticSearchHit, type SemanticStatusOptions } from "../search/semantic.js";
+import type { SemanticDocument, SemanticDocumentResult, SemanticEmbeddingSyncResult, SemanticGetOptions, SemanticHitEvidence, SemanticMultiGetOptions, SemanticProviderStatus, SemanticQueryOptions, SemanticQueryResult, SemanticSearchHit, SemanticStatusOptions } from "./semantic-contract.js";
 export type MorningHitSource = "oms-seed" | "oms-neighbor" | "oms-semantic";
 export type SemanticFusionScope = "global" | "graph";
 export type SemanticHydrateMode = "none" | "top" | "all" | "targets";
@@ -22,8 +22,6 @@ export interface MorningRetrieveOptions extends GraphExploreOptions {
         readonly lineNumbers?: boolean;
         readonly fullPath?: boolean;
         readonly index?: string;
-        readonly storage?: SemanticQueryOptions["storage"];
-        readonly modelPath?: string;
         readonly chunkStrategy?: string;
         readonly candidateLimit?: number;
         readonly noRerank?: boolean;
@@ -41,8 +39,6 @@ export interface MorningRetrieveOptions extends GraphExploreOptions {
         readonly syncPull?: boolean;
         readonly syncMaxDocsPerBatch?: number;
         readonly syncMaxBatchMb?: number;
-        readonly syncStorage?: SemanticQueryOptions["storage"];
-        readonly syncModelPath?: string;
     };
 }
 export interface MorningRetrieveHit {
@@ -77,15 +73,17 @@ export interface MorningRetrieveResult {
  * Pluggable semantic backend for the morning retrieval flow.
  *
  * Abstracts the five semantic leaf operations so the caller chooses the
- * implementation without morning.ts knowing which one it is:
- *   - {@link defaultMorningSemanticBackend} → the model-free src/search layer.
- *   - makeEngineMorningBackend(...) (src/mcp/engine-morning-backend.ts) → the
- *     native EmbeddingGemma engine, injected by the MCP server once a real
- *     model is configured.
+ * implementation without morning.ts knowing which one it is. After the
+ * src/search teardown there is a single implementation —
+ * makeEngineMorningBackend(...) (src/mcp/engine-morning-backend.ts), which wraps
+ * the native engine adapter (vec-capable when a model is configured, lex +
+ * file-based document reads otherwise). The backend is injected by the caller so
+ * morning.ts stays free of any engine-assembly policy and has no module cycle
+ * back into src/mcp.
  *
  * query + getDocument + multiGet MUST come from the SAME backend: the engine
  * emits real-path docids that only its own file-based hydration resolves, so a
- * split backend (engine query + src/search hydration) would strand every hit.
+ * split backend would strand every hit.
  */
 export interface MorningSemanticBackend {
     readonly sync: (opts: MorningRetrieveOptions) => Promise<SemanticEmbeddingSyncResult | undefined>;
@@ -94,10 +92,4 @@ export interface MorningSemanticBackend {
     readonly getDocument: (opts: SemanticGetOptions) => Promise<SemanticDocumentResult>;
     readonly multiGet: (opts: SemanticMultiGetOptions) => Promise<SemanticDocumentResult>;
 }
-/**
- * Default semantic backend: the mature, model-free src/search layer (SHA-1
- * hash embeddings + JSON/SQLite store). Used by the CLI and by any caller that
- * does not inject an engine-backed backend, so non-MCP paths are unchanged.
- */
-export declare const defaultMorningSemanticBackend: MorningSemanticBackend;
-export declare function retrieveMorningContext(opts: MorningRetrieveOptions, backend?: MorningSemanticBackend): Promise<MorningRetrieveResult>;
+export declare function retrieveMorningContext(opts: MorningRetrieveOptions, backend: MorningSemanticBackend): Promise<MorningRetrieveResult>;

package/dist/retrieve/morning.js

@@ -1,18 +1,4 @@
 import { exploreLocalGraph, } from "../graph/explore.js";
-import { getSemanticDocument, multiGetSemanticDocuments, querySemanticStore, readSemanticStatus, } from "../search/semantic.js";
-import { syncRetrieveEmbeddings } from "./embedding-sync.js";
-/**
- * Default semantic backend: the mature, model-free src/search layer (SHA-1
- * hash embeddings + JSON/SQLite store). Used by the CLI and by any caller that
- * does not inject an engine-backed backend, so non-MCP paths are unchanged.
- */
-export const defaultMorningSemanticBackend = {
-    sync: (opts) => syncRetrieveEmbeddings(opts),
-    status: (opts) => readSemanticStatus(opts),
-    query: (opts) => querySemanticStore(opts),
-    getDocument: (opts) => getSemanticDocument(opts),
-    multiGet: (opts) => multiGetSemanticDocuments(opts),
-};
 function graphHit(source, node) {
     return {
         source,
@@ -67,8 +53,6 @@ function semanticQueryOptions(opts) {
         lineNumbers: opts.semantic?.lineNumbers,
         fullPath: opts.semantic?.fullPath,
         index: opts.semantic?.index,
-        storage: opts.semantic?.storage,
-        modelPath: opts.semantic?.modelPath,
         chunkStrategy: opts.semantic?.chunkStrategy,
         candidateLimit: opts.semantic?.candidateLimit,
         noRerank: opts.semantic?.noRerank,
@@ -97,22 +81,16 @@ async function hydrateSemanticHits(opts, hits, backend) {
             lineCount: opts.semantic.hydrateLineCount,
             lineNumbers: opts.semantic.lineNumbers,
             fullPath: opts.semantic.fullPath,
-            index: opts.semantic.index,
-            storage: opts.semantic.storage,
-            modelPath: opts.semantic.modelPath,
         });
         return result.available ? result.documents : [];
     }
     const result = await backend.multiGet({
         vault: opts.vault,
-        targets,
+        targets: [...targets],
         lineLimit: opts.semantic?.hydrateLineLimit,
         maxBytes: opts.semantic?.hydrateMaxBytes,
         lineNumbers: opts.semantic?.lineNumbers,
         fullPath: opts.semantic?.fullPath,
-        index: opts.semantic?.index,
-        storage: opts.semantic?.storage,
-        modelPath: opts.semantic?.modelPath,
     });
     return result.available ? result.documents : [];
 }
@@ -131,8 +109,6 @@ async function loadSemantic(opts, backend) {
     const status = await backend.status({
         vault: opts.vault,
         index: opts.semantic?.index,
-        storage: opts.semantic?.storage,
-        modelPath: opts.semantic?.modelPath,
     });
     if (!status.available) {
         return { status, sync, hits: [] };
@@ -143,7 +119,7 @@ async function loadSemantic(opts, backend) {
     }
     return { status, sync, hits: queryResult.hits };
 }
-export async function retrieveMorningContext(opts, backend = defaultMorningSemanticBackend) {
+export async function retrieveMorningContext(opts, backend) {
     const graph = await exploreLocalGraph(opts);
     const semantic = await loadSemantic(opts, backend);
     const semanticHits = filteredSemanticHits(opts, graph, semantic.hits);

package/dist/retrieve/morning.js.map

@@ -1 +1 @@
-{"version":3,"file":"morning.js","sourceRoot":"","sources":["../../src/retrieve/morning.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"morning.js","sourceRoot":"","sources":["../../src/retrieve/morning.ts"],"names":[],"mappings":"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"}

package/dist/retrieve/semantic-contract.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Semantic surface contract.
+ *
+ * After the src/search teardown (follow-up to #34) the engine MCP adapter layer
+ * is the single source of truth for the OMS semantic surface. These domain-named
+ * aliases re-export the canonical engine contract types so the morning retrieval
+ * layer and the CLI/MCP option builders stay decoupled from the engine's
+ * `Mcp`-prefixed names without re-declaring a parallel type set.
+ */
+export type { McpSemanticSearchMode as SemanticSearchMode, McpSemanticSearchFormat as SemanticSearchFormat, McpSemanticTypedSearchType as SemanticTypedSearchType, McpSemanticTypedSearch as SemanticTypedSearch, McpStatusOptions as SemanticStatusOptions, McpSemanticQueryOptions as SemanticQueryOptions, McpSemanticHitEvidence as SemanticHitEvidence, McpSemanticSearchHit as SemanticSearchHit, McpSemanticQueryResult as SemanticQueryResult, McpSemanticEmbeddingSyncOptions as SemanticEmbeddingSyncOptions, McpSemanticEmbeddingSyncResult as SemanticEmbeddingSyncResult, McpSemanticProviderStatus as SemanticProviderStatus, McpSemanticDocument as SemanticDocument, McpSemanticDocumentResult as SemanticDocumentResult, McpSemanticGetOptions as SemanticGetOptions, McpSemanticMultiGetOptions as SemanticMultiGetOptions, } from "../engine/mcp/types.js";

package/dist/retrieve/semantic-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=semantic-contract.js.map

package/dist/retrieve/semantic-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-contract.js","sourceRoot":"","sources":["../../src/retrieve/semantic-contract.ts"],"names":[],"mappings":""}

package/dist/setup/axis.d.ts

@@ -1,4 +1,4 @@
-import type { Concept, FieldType, OntologyLens } from "../ontology/types.js";
+import type { Concept, FieldType, Ontology, OntologyLens } from "../core/ontology/types.js";
 export interface ObservedField {
     readonly name: string;
     readonly type: FieldType;
@@ -9,9 +9,28 @@ export interface ObservedFolderSummary {
     readonly fields: readonly ObservedField[];
     readonly warnings: readonly string[];
 }
-export declare function collectObservedFields(opts: {
+interface ObservedScanOptions {
     readonly vault: string;
+    readonly ontology?: Ontology;
+    readonly folder?: string;
+    readonly excludeGlobs?: readonly string[];
     readonly maxFilesPerFolder?: number;
-}): Promise<readonly ObservedFolderSummary[]>;
+}
+export declare function collectObservedFields(opts: ObservedScanOptions): Promise<readonly ObservedFolderSummary[]>;
+/** One frontmatter value observed outside a field's declared `enum`. */
+export interface ObservedFieldValueDrift {
+    readonly folder: string;
+    readonly field: string;
+    readonly value: string;
+    readonly count: number;
+}
+/**
+ * Scan the vault for string values that violate declared enum constraints,
+ * grouped by folder/field/value with a frequency count.
+ */
+export declare function collectObservedFieldValues(opts: ObservedScanOptions & {
+    readonly ontology: Ontology;
+}): Promise<readonly ObservedFieldValueDrift[]>;
 export declare function mergeObservedFieldsIntoConcept(concept: Concept, observedFields: readonly ObservedField[]): Concept;
 export declare function parseLensDefinitions(input: string, knownFields: ReadonlySet<string>): readonly OntologyLens[];
+export {};