oh-my-second-brain 0.2.0 → 0.6.1

package/dist/kernel/conventions/write-contract.js.map

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

package/dist/kernel/conventions/write-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-protocol.js","sourceRoot":"","sources":["../../../src/kernel/conventions/write-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsCH;;;GAGG;AACH,MAAM,mBAAmB,GAAwC;IAC/D,mBAAmB,EAAE,IAAI;IACzB,oBAAoB,EAAE,IAAI;IAC1B,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,KAAK;IACxB,gBAAgB,EAAE,KAAK;IACvB,sBAAsB,EAAE,KAAK;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,KAAiB,EACjB,IAAwB,EACxB,OAAe,EACf,WAAmB;IAEnB,OAAO;QACL,KAAK;QACL,IAAI;QACJ,OAAO;QACP,WAAW;QACX,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/kernel/doctor/service.d.ts

@@ -0,0 +1,71 @@
+import type { WriteTargetSource } from "../conventions/write-protocol.js";
+import type { McpEngineAdapter } from "../engine/mcp/facade.js";
+export type DoctorRepairOperation = "build-graph" | "semantic-cleanup" | "sync-embeddings";
+type SemanticIndexPostcondition = {
+    readonly kind: "semantic-index";
+    readonly databasePath: string;
+    readonly documentPaths: readonly string[];
+    readonly chunks: number;
+    readonly orphanDocumentPaths: readonly string[];
+};
+export type DoctorRepairReceipt = {
+    readonly operation: "build-graph";
+    readonly resolvedVault: string;
+    readonly resolutionSource: WriteTargetSource;
+    readonly written: {
+        readonly paths: readonly string[];
+        readonly summary: {
+            readonly notes: number;
+            readonly edges: number;
+            readonly searchDocuments: number;
+        };
+    };
+    readonly postcondition: {
+        readonly kind: "graph-cache";
+        readonly cachePath: string;
+        readonly generatedAt: string;
+        readonly notes: number;
+        readonly edges: number;
+        readonly searchDocuments: number;
+    };
+} | {
+    readonly operation: "semantic-cleanup" | "sync-embeddings";
+    readonly resolvedVault: string;
+    readonly resolutionSource: WriteTargetSource;
+    readonly written: {
+        readonly paths: readonly string[];
+        readonly summary: Record<string, unknown>;
+    };
+    readonly postcondition: SemanticIndexPostcondition;
+};
+export type DoctorRepairResult = {
+    readonly kind: "rejected";
+    readonly value: {
+        readonly status: "rejected";
+        readonly rejection: unknown;
+        readonly resolvedVault: string;
+        readonly resolutionSource: WriteTargetSource;
+    };
+} | {
+    readonly kind: "error";
+    readonly message: string;
+} | {
+    readonly kind: "completed";
+    readonly value: Record<string, unknown>;
+};
+export declare function repairDoctor({ operation, vault, source, args, resolveAdapter }: {
+    readonly operation: DoctorRepairOperation;
+    readonly vault: string;
+    readonly source: WriteTargetSource;
+    readonly args: Record<string, unknown> | undefined;
+    /**
+     * Deferred on purpose. Constructing a semantic adapter opens - and
+     * therefore creates - `<vault>/.oms/engine-store.sqlite`, so accepting an
+     * already-built adapter would let that mutation happen in the caller's
+     * argument list, before this function ever runs admission. Taking a factory
+     * keeps admission the first effectful step even though the caller decides
+     * WHICH adapter is appropriate.
+     */
+    readonly resolveAdapter?: () => McpEngineAdapter;
+}): Promise<DoctorRepairResult>;
+export {};

package/dist/kernel/doctor/service.js

@@ -0,0 +1,70 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import Database from "better-sqlite3";
+import { admitWriteTarget } from "../capture/safe.js";
+import { walkMarkdown } from "../engine/embed/sync.js";
+import { buildGraphCache, graphCachePath } from "../graph/cache.js";
+import { resolveActiveOntology } from "../ontology/active.js";
+import { handleSemanticTool } from "../semantic/semantic-retrieve.js";
+async function semanticIndexPostcondition(vault) {
+    const databasePath = path.join(vault, ".oms", "engine-store.sqlite");
+    await stat(databasePath);
+    const database = new Database(databasePath, { readonly: true });
+    try {
+        const documentPaths = database.prepare("SELECT DISTINCT doc_path FROM engine_chunk_meta ORDER BY doc_path").all().map((row) => row.doc_path);
+        const chunks = database.prepare("SELECT COUNT(*) AS count FROM engine_chunk_meta").get().count;
+        const livePaths = new Set();
+        for await (const notePath of walkMarkdown(vault, vault))
+            livePaths.add(notePath);
+        return { kind: "semantic-index", databasePath, documentPaths, chunks, orphanDocumentPaths: documentPaths.filter((notePath) => !livePaths.has(notePath)) };
+    }
+    finally {
+        database.close();
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export async function repairDoctor({ operation, vault, source, args, resolveAdapter }) {
+    const rejection = await admitWriteTarget({ vault, source });
+    if (rejection)
+        return { kind: "rejected", value: { status: "rejected", rejection, resolvedVault: vault, resolutionSource: source } };
+    if (operation === "build-graph") {
+        const { ontology, source: ontologySource } = await resolveActiveOntology(vault);
+        const cache = await buildGraphCache({ vault, ontology, write: true });
+        const cachePath = graphCachePath(vault);
+        const persistedCache = JSON.parse(await readFile(cachePath, "utf-8"));
+        if (!isRecord(persistedCache) || persistedCache["generatedAt"] !== cache.generatedAt || !Array.isArray(persistedCache["notes"]) || !Array.isArray(persistedCache["edges"]) || !Array.isArray(persistedCache["search"])) {
+            throw new Error("Graph cache postcondition failed: persisted cache does not match the completed build.");
+        }
+        const receipt = {
+            operation, resolvedVault: vault, resolutionSource: source,
+            written: { paths: [cachePath], summary: { notes: persistedCache["notes"].length, edges: persistedCache["edges"].length, searchDocuments: persistedCache["search"].length } },
+            postcondition: { kind: "graph-cache", cachePath, generatedAt: persistedCache["generatedAt"], notes: persistedCache["notes"].length, edges: persistedCache["edges"].length, searchDocuments: persistedCache["search"].length },
+        };
+        return { kind: "completed", value: { vault, ontologySource, cachePath, generatedAt: cache.generatedAt, notes: cache.notes.length, edges: cache.edges.length, searchDocuments: cache.search.length, sourceOfTruth: cache.sourceOfTruth, resolvedVault: vault, resolutionSource: source, receipt } };
+    }
+    if (!resolveAdapter)
+        throw new Error(`Doctor repair "${operation}" requires a semantic adapter.`);
+    // Admission has passed; only now is it safe to let adapter construction touch
+    // the vault.
+    const adapter = resolveAdapter();
+    const name = operation === "semantic-cleanup" ? "oms_semantic_cleanup" : "oms_sync_embeddings";
+    const semanticResult = await handleSemanticTool(name, args, vault, adapter);
+    if (!semanticResult)
+        throw new Error(`Doctor repair "${operation}" was not handled.`);
+    if (!semanticResult.ok)
+        return { kind: "error", message: semanticResult.message };
+    if (!isRecord(semanticResult.value) || semanticResult.value["available"] !== true)
+        return { kind: "completed", value: semanticResult.value };
+    const postcondition = await semanticIndexPostcondition(vault);
+    if (postcondition.orphanDocumentPaths.length > 0)
+        throw new Error("Semantic index postcondition failed: stored documents include paths outside the live vault.");
+    const receipt = {
+        operation, resolvedVault: vault, resolutionSource: source,
+        written: { paths: [postcondition.databasePath], summary: semanticResult.value },
+        postcondition,
+    };
+    return { kind: "completed", value: { ...semanticResult.value, resolvedVault: vault, resolutionSource: source, receipt } };
+}
+//# sourceMappingURL=service.js.map

package/dist/kernel/doctor/service.js.map

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

package/dist/{engine → kernel/engine}/assemble.d.ts

@@ -9,10 +9,12 @@
  * - Explicit embedding configuration: OMS_EMBEDDING_PROVIDER + OMS_EMBEDDING_MODEL.
  * - Lex-only semantic queries must remain usable without embedding configuration.
  */
+import type { EmbeddingModelDescriptor } from "./embed/model.js";
 import { McpEngineAdapter } from "./mcp/facade.js";
-import type { DispatcherDeps } from "./retrieval/dispatcher.js";
+import type { DispatcherDeps, DispatcherPolicy } from "./retrieval/dispatcher.js";
 import type { EngineStore } from "./embed/store.js";
 import type { EmbeddingProvider } from "./types.js";
+import type { Reranker } from "./retrieval/reranker.js";
 /** Configuration for assembleEngine() / assembleCoreSemanticEngine(). */
 export interface AssembleConfig {
     /** Absolute path to the vault root. */
@@ -21,18 +23,44 @@ export interface AssembleConfig {
     embeddingProvider?: string;
     /** Optional explicit embedding model/id/path (OMS_EMBEDDING_MODEL). */
     embeddingModel?: string;
+    /**
+     * Optional canonical descriptor supplied by setup. When omitted, assembly
+     * discovers the setup-written installed default. `null` explicitly waives
+     * default discovery.
+     */
+    embeddingDescriptor?: EmbeddingModelDescriptor | null;
+    /** Test/setup override for the user-level model cache root. */
+    embeddingCacheDir?: string;
+    /** Explicit descriptor-shape overrides for callers without a descriptor. */
+    embeddingDimensions?: number;
+    embeddingContext?: number;
+    embeddingContextLength?: number;
+    embeddingContextTokens?: number;
+    embeddingMrlDim?: number;
+    embeddingNormalization?: string;
+    embeddingPrefixScheme?: string;
     /** Absolute path to the SQLite engine store database file. Default: <vault>/.oms/engine-store.sqlite */
     dbPath?: string;
     /** RRF smoothing constant passed to DispatcherDeps (default 60). */
     rrfK?: number;
+    /** Explicit retrieval policy used by the production dispatcher. */
+    policy?: DispatcherPolicy;
     /** Default BFS hop depth for graph sub-queries (default 2). */
     graphDepth?: number;
+    /**
+     * Optional real cross-encoder reranker. Reranking is disabled unless a
+     * request explicitly sets `rerank: true`; such a request fails loudly when
+     * this is absent.
+     */
+    reranker?: Reranker;
 }
 export interface AssembledEngine {
     adapter: McpEngineAdapter;
     deps: DispatcherDeps;
     store: EngineStore;
     provider: EmbeddingProvider;
+    /** Whether lex-only queries refresh this engine's selected lexical store. */
+    implicitLexicalSync: boolean;
     syncVault(opts?: SyncVaultOptions): Promise<SyncVaultResult>;
     dispose(): Promise<void>;
 }
@@ -50,6 +78,8 @@ export interface SyncVaultResult {
     skipped: number;
     available: boolean;
     reason?: string;
+    /** True when this sync replaced the active on-disk generation. */
+    generationSwapped?: boolean;
 }
 /**
  * Assemble a semantic-capable engine with a REAL embedding provider.
@@ -66,6 +96,21 @@ export declare function assembleEngine(config: AssembleConfig): AssembledEngine;
  * vec/HyDE operations will fail (embed() throws; vecAvailable is false).
  */
 export declare function assembleCoreSemanticEngine(config: AssembleConfig): AssembledEngine;
+/**
+ * Assemble a core-only semantic engine whose lexical index is process-local.
+ * Lex-only queries populate this store on demand without touching the vault.
+ */
+export declare function assembleEphemeralCoreSemanticEngine(config: AssembleConfig): AssembledEngine;
+/**
+ * Assemble an existing CORE-ONLY semantic engine without creating a store.
+ * Returns null when the semantic index is absent or cannot be read safely.
+ */
+export declare function assembleCoreSemanticEngineReadOnly(config: AssembleConfig): AssembledEngine | null;
+/**
+ * Assemble an existing vector-capable semantic engine without creating a store.
+ * Returns null when the semantic index is absent or cannot be read safely.
+ */
+export declare function assembleEngineReadOnly(config: AssembleConfig): AssembledEngine | null;
 /**
  * Assemble a GRAPH-ONLY engine: graph ops run model-free; semantic store/embed
  * are throw-on-use guards.