oh-my-second-brain 0.1.5

package/dist/mcp/server.js

@@ -0,0 +1,461 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { parseNote } from "../conventions/frontmatter.js";
+import { validateFrontmatter } from "../conventions/validate.js";
+import { commitCapture, prepareCapture, safeVaultNotePath, } from "../capture/safe.js";
+import { buildGraphCache, graphCachePath, graphCacheStatus, lazyLoadNoteBody, retrieveByAxis, } from "../graph/cache.js";
+import { loadOntology } from "../ontology/loader.js";
+import { resolveConcept } from "../ontology/resolver.js";
+const SERVER_VERSION = "0.0.0";
+function bundledOntologyDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    return path.resolve(__dirname, "../../core/ontology");
+}
+async function activeOntology(vault) {
+    const localOntologyDir = path.join(vault, ".oms");
+    const omsKind = await pathKind(localOntologyDir);
+    if (omsKind === "missing") {
+        return { ontology: await loadOntology(bundledOntologyDir()), 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(bundledOntologyDir()), 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" };
+}
+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;
+    }
+}
+function jsonText(value) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+function errorText(message) {
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: message,
+            },
+        ],
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringArg(args, key) {
+    const value = args?.[key];
+    return typeof value === "string" ? value : undefined;
+}
+function conceptSummary(concept) {
+    return {
+        concept: concept.concept,
+        intent: concept.intent,
+        folder: concept.folder,
+        fields: concept.fields.map((field) => ({
+            name: field.name,
+            type: field.type,
+            required: field.required,
+            intent: field.intent,
+        })),
+        retrievalViews: (concept.lenses ?? []).map((lens) => ({
+            name: lens.name,
+            intent: lens.intent,
+            fields: lens.fields,
+        })),
+    };
+}
+export const omsMcpTools = [
+    {
+        name: "oms_graph_status",
+        title: "Oh My Second Brain graph/status",
+        description: "Read-only status for the active Oh My Second Brain ontology, graph/search cache phase, and gated write-tool posture.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "oms_graph_build",
+        title: "Oh My Second Brain graph build",
+        description: "Build the derived graph/search cache from markdown, frontmatter, folders, and wikilinks.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "oms_list_concepts",
+        title: "Oh My Second Brain list concepts",
+        description: "Read the active ontology concepts, frontmatter axes, folder bindings, and retrieval views.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "oms_retrieve_by_axis",
+        title: "Oh My Second Brain retrieve by axis",
+        description: "Axis-first retrieval over the derived cache; optional lexical query only ranks inside the narrowed candidate set.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                concept: { type: "string" },
+                folder: { type: "string" },
+                property: { type: "string" },
+                value: { type: "string" },
+                wikilink: { type: "string" },
+                query: { type: "string" },
+                limit: { type: "number" },
+            },
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "oms_lazy_load_note",
+        title: "Oh My Second Brain lazy-load note body",
+        description: "Load a selected note body only after axis/search narrowing has selected the note.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                notePath: {
+                    type: "string",
+                    description: "Vault-relative markdown note path.",
+                },
+            },
+            required: ["notePath"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "oms_validate_contract",
+        title: "Oh My Second Brain validate contract",
+        description: "Read one vault note and validate its frontmatter against the active folder/concept contract.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                notePath: {
+                    type: "string",
+                    description: "Vault-relative markdown note path, for example references/book.md.",
+                },
+            },
+            required: ["notePath"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "oms_capture_prepare",
+        title: "Oh My Second Brain capture prepare",
+        description: "Plan a safe capture: choose folder/concept, surface missing fields, or route ambiguous input to inbox without writing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                concept: { type: "string" },
+                folder: { type: "string" },
+                filename: { type: "string" },
+                frontmatter: { type: "object" },
+            },
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "oms_capture_commit",
+        title: "Oh My Second Brain capture commit",
+        description: "Write or append a note only after vault path confinement and contract validation pass.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                notePath: { type: "string" },
+                frontmatter: { type: "object" },
+                body: { type: "string" },
+                mode: { type: "string", enum: ["create", "append"] },
+            },
+            required: ["notePath", "frontmatter", "body", "mode"],
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    },
+];
+export function createOMSMcpServer(opts) {
+    const vault = path.resolve(opts.vault);
+    const server = new Server({ name: "oms", version: SERVER_VERSION }, {
+        capabilities: { tools: {} },
+        instructions: "Oh My Second Brain exposes ontology/status/cache/retrieval tools and safe capture tools. Capture commit is gated by vault confinement and contract validation.",
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: omsMcpTools,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const args = isRecord(request.params.arguments) ? request.params.arguments : undefined;
+        if (request.params.name === "oms_graph_status") {
+            try {
+                const { ontology, source } = await activeOntology(vault);
+                const cacheStatus = await graphCacheStatus(vault, ontology);
+                return jsonText({
+                    vault,
+                    ontologySource: source,
+                    sourceOfTruth: ["markdown notes", ".oms/taxonomy.yaml", ".oms/concepts/*.yaml"],
+                    counts: {
+                        concepts: ontology.concepts.size,
+                        folders: Object.keys(ontology.taxonomy.folders).length,
+                    },
+                    derivedState: cacheStatus,
+                    writeTools: "capture-commit-gated-by-vault-confinement-and-contract-validation",
+                    readTools: omsMcpTools.map((tool) => tool.name),
+                });
+            }
+            catch (error) {
+                return jsonText({
+                    vault,
+                    ontologySource: "vault-invalid",
+                    sourceOfTruth: ["markdown notes", ".oms/taxonomy.yaml", ".oms/concepts/*.yaml"],
+                    error: error instanceof Error ? error.message : String(error),
+                    counts: null,
+                    derivedState: {
+                        exists: false,
+                        staleness: {
+                            schemaStale: true,
+                            graphStale: true,
+                            searchStale: true,
+                            embeddingStale: "not-configured",
+                            validationStale: true,
+                            reasons: ["local .oms exists but could not be loaded"],
+                        },
+                    },
+                    writeTools: "disabled-invalid-ontology",
+                    readTools: ["oms_graph_status"],
+                });
+            }
+        }
+        try {
+            if (request.params.name === "oms_graph_build") {
+                const { ontology, source } = await activeOntology(vault);
+                const cache = await buildGraphCache({ vault, ontology, write: true });
+                return jsonText({
+                    vault,
+                    ontologySource: source,
+                    cachePath: graphCachePath(vault),
+                    generatedAt: cache.generatedAt,
+                    notes: cache.notes.length,
+                    edges: cache.edges.length,
+                    searchDocuments: cache.search.length,
+                    sourceOfTruth: cache.sourceOfTruth,
+                });
+            }
+            if (request.params.name === "oms_list_concepts") {
+                const { ontology, source } = await activeOntology(vault);
+                return jsonText({
+                    vault,
+                    ontologySource: source,
+                    folders: ontology.taxonomy.folders,
+                    concepts: Array.from(ontology.concepts.values()).map(conceptSummary),
+                });
+            }
+            if (request.params.name === "oms_retrieve_by_axis") {
+                const { ontology, source } = await activeOntology(vault);
+                const limitValue = args?.["limit"];
+                const hits = await retrieveByAxis({
+                    vault,
+                    ontology,
+                    concept: stringArg(args, "concept"),
+                    folder: stringArg(args, "folder"),
+                    property: stringArg(args, "property"),
+                    value: stringArg(args, "value"),
+                    wikilink: stringArg(args, "wikilink"),
+                    query: stringArg(args, "query"),
+                    limit: typeof limitValue === "number" ? limitValue : undefined,
+                });
+                return jsonText({
+                    vault,
+                    ontologySource: source,
+                    mode: "axis-first-search-second",
+                    bodyPolicy: "lazy-load",
+                    hits,
+                });
+            }
+            if (request.params.name === "oms_lazy_load_note") {
+                const notePath = stringArg(args, "notePath");
+                if (!notePath) {
+                    return errorText('Missing required string argument "notePath".');
+                }
+                return jsonText(await lazyLoadNoteBody(vault, notePath));
+            }
+            if (request.params.name === "oms_validate_contract") {
+                const notePath = stringArg(args, "notePath");
+                if (!notePath) {
+                    return errorText('Missing required string argument "notePath".');
+                }
+                let fullPath;
+                try {
+                    fullPath = safeVaultNotePath(vault, notePath);
+                }
+                catch (error) {
+                    return errorText(error instanceof Error ? error.message : String(error));
+                }
+                const { ontology, source } = await activeOntology(vault);
+                const normalizedNotePath = path.relative(vault, fullPath).replace(/\\/g, "/");
+                const concept = resolveConcept(ontology, normalizedNotePath);
+                if (!concept) {
+                    return jsonText({
+                        vault,
+                        ontologySource: source,
+                        notePath: normalizedNotePath,
+                        concept: null,
+                        valid: false,
+                        violations: [
+                            {
+                                field: "path",
+                                rule: "folder-binding",
+                                message: "No concept binding resolves for this note path.",
+                            },
+                        ],
+                    });
+                }
+                const raw = await readFile(fullPath, "utf-8");
+                const { frontmatter, hasFrontmatter } = parseNote(raw);
+                const result = validateFrontmatter(frontmatter, concept);
+                return jsonText({
+                    vault,
+                    ontologySource: source,
+                    notePath: normalizedNotePath,
+                    concept: concept.concept,
+                    hasFrontmatter,
+                    valid: result.valid,
+                    violations: result.violations,
+                });
+            }
+            if (request.params.name === "oms_capture_prepare") {
+                const { ontology, source } = await activeOntology(vault);
+                const frontmatterArg = args?.["frontmatter"];
+                const frontmatter = isRecord(frontmatterArg) ? frontmatterArg : {};
+                return jsonText({
+                    vault,
+                    ontologySource: source,
+                    plan: prepareCapture({
+                        vault,
+                        ontology,
+                        concept: stringArg(args, "concept"),
+                        folder: stringArg(args, "folder"),
+                        filename: stringArg(args, "filename"),
+                        frontmatter,
+                    }),
+                });
+            }
+            if (request.params.name === "oms_capture_commit") {
+                const { ontology, source } = await activeOntology(vault);
+                const notePath = stringArg(args, "notePath");
+                const body = stringArg(args, "body");
+                const mode = stringArg(args, "mode");
+                const frontmatterArg = args?.["frontmatter"];
+                if (!notePath || !body || !isCaptureMode(mode) || !isRecord(frontmatterArg)) {
+                    return errorText('Missing required arguments: notePath:string, frontmatter:object, body:string, mode:"create"|"append".');
+                }
+                try {
+                    return jsonText({
+                        vault,
+                        ontologySource: source,
+                        result: await commitCapture({
+                            vault,
+                            ontology,
+                            notePath,
+                            frontmatter: frontmatterArg,
+                            body,
+                            mode,
+                        }),
+                    });
+                }
+                catch (error) {
+                    return errorText(error instanceof Error ? error.message : String(error));
+                }
+            }
+            return errorText(`Unknown Oh My Second Brain tool: ${request.params.name}`);
+        }
+        catch (error) {
+            return errorText(`Oh My Second Brain MCP error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    });
+    return server;
+}
+export async function runMcpServer(opts) {
+    const server = createOMSMcpServer(opts);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function isCaptureMode(value) {
+    return value === "create" || value === "append";
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/ontology/loader.d.ts

@@ -0,0 +1,13 @@
+import type { Ontology } from "./types.js";
+/**
+ * Load an Oh My Second Brain ontology from a directory that contains:
+ *   <ontologyDir>/taxonomy.yaml
+ *   <ontologyDir>/concepts/*.yaml
+ *
+ * Lenient:
+ * - Missing `taxonomy.version` defaults to 0.
+ * - A taxonomy folder that references an unknown concept name is warned and skipped.
+ * - Missing optional concept keys default sensibly.
+ * - Never throws (barring genuine I/O errors).
+ */
+export declare function loadOntology(ontologyDir: string): Promise<Ontology>;

package/dist/ontology/loader.js

@@ -0,0 +1,63 @@
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * Load an Oh My Second Brain ontology from a directory that contains:
+ *   <ontologyDir>/taxonomy.yaml
+ *   <ontologyDir>/concepts/*.yaml
+ *
+ * Lenient:
+ * - Missing `taxonomy.version` defaults to 0.
+ * - A taxonomy folder that references an unknown concept name is warned and skipped.
+ * - Missing optional concept keys default sensibly.
+ * - Never throws (barring genuine I/O errors).
+ */
+export async function loadOntology(ontologyDir) {
+    // ── taxonomy ──────────────────────────────────────────────────────────────
+    const taxonomyPath = path.join(ontologyDir, "taxonomy.yaml");
+    const taxonomyRaw = await readFile(taxonomyPath, "utf-8");
+    const taxonomyParsed = parseYaml(taxonomyRaw);
+    const taxonomy = {
+        version: typeof taxonomyParsed["version"] === "number"
+            ? taxonomyParsed["version"]
+            : 0,
+        folders: taxonomyParsed["folders"] != null &&
+            typeof taxonomyParsed["folders"] === "object" &&
+            !Array.isArray(taxonomyParsed["folders"])
+            ? taxonomyParsed["folders"]
+            : {},
+    };
+    // ── concepts ──────────────────────────────────────────────────────────────
+    const conceptsDir = path.join(ontologyDir, "concepts");
+    const entries = await readdir(conceptsDir);
+    const yamlFiles = entries.filter((e) => e.endsWith(".yaml") || e.endsWith(".yml"));
+    const concepts = new Map();
+    for (const file of yamlFiles) {
+        const filePath = path.join(conceptsDir, file);
+        const raw = await readFile(filePath, "utf-8");
+        const parsed = parseYaml(raw);
+        const concept = {
+            concept: typeof parsed["concept"] === "string" ? parsed["concept"] : path.basename(file, path.extname(file)),
+            intent: typeof parsed["intent"] === "string" ? parsed["intent"] : "",
+            folder: typeof parsed["folder"] === "string" ? parsed["folder"] : "",
+            fields: Array.isArray(parsed["fields"]) ? parsed["fields"] : [],
+            lenses: Array.isArray(parsed["lenses"]) ? parsed["lenses"] : [],
+        };
+        concepts.set(concept.concept, concept);
+    }
+    // Warn if a taxonomy folder references a concept name not in the map.
+    for (const [folder, binding] of Object.entries(taxonomy.folders)) {
+        const names = binding.concept == null
+            ? []
+            : Array.isArray(binding.concept)
+                ? binding.concept
+                : [binding.concept];
+        for (const name of names) {
+            if (!concepts.has(name)) {
+                console.warn(`[oms] taxonomy folder "${folder}" references unknown concept "${name}" — skipping.`);
+            }
+        }
+    }
+    return { taxonomy, concepts };
+}
+//# sourceMappingURL=loader.js.map

package/dist/ontology/loader.js.map

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

package/dist/ontology/resolver.d.ts

@@ -0,0 +1,13 @@
+import type { Concept, Ontology } from "./types.js";
+/**
+ * Resolve the Concept for a note given its path relative to the vault root.
+ *
+ * Pure function. Takes the FIRST path segment as the folder key, looks it up
+ * in the taxonomy, then resolves the concept by name from the ontology map.
+ *
+ * Returns `undefined` when:
+ * - the folder is not declared in the taxonomy, or
+ * - the binding's concept is null, or
+ * - no matching concept exists in the ontology.
+ */
+export declare function resolveConcept(ontology: Ontology, notePath: string): Concept | undefined;

package/dist/ontology/resolver.js

@@ -0,0 +1,37 @@
+/**
+ * Resolve the Concept for a note given its path relative to the vault root.
+ *
+ * Pure function. Takes the FIRST path segment as the folder key, looks it up
+ * in the taxonomy, then resolves the concept by name from the ontology map.
+ *
+ * Returns `undefined` when:
+ * - the folder is not declared in the taxonomy, or
+ * - the binding's concept is null, or
+ * - no matching concept exists in the ontology.
+ */
+export function resolveConcept(ontology, notePath) {
+    // Normalize backslashes to forward slashes.
+    const normalized = notePath.replace(/\\/g, "/");
+    // Take the first path segment as the folder name.
+    const slash = normalized.indexOf("/");
+    const folder = slash === -1 ? normalized : normalized.slice(0, slash);
+    if (!folder)
+        return undefined;
+    const binding = ontology.taxonomy.folders[folder];
+    if (!binding)
+        return undefined;
+    const conceptRef = binding.concept;
+    if (conceptRef === null || conceptRef === undefined)
+        return undefined;
+    if (Array.isArray(conceptRef)) {
+        // Return the first resolvable concept name.
+        for (const name of conceptRef) {
+            const concept = ontology.concepts.get(name);
+            if (concept)
+                return concept;
+        }
+        return undefined;
+    }
+    return ontology.concepts.get(conceptRef);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/ontology/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/ontology/resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAkB,EAClB,QAAgB;IAEhB,4CAA4C;IAC5C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhD,kDAAkD;IAClD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEtE,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IACnC,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEtE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,4CAA4C;QAC5C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC"}