oh-my-second-brain 0.1.5

package/dist/cli/oms.js

@@ -0,0 +1,401 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { readFile, readdir, mkdir, copyFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline/promises";
+import { stringify as yamlStringify } from "yaml";
+import { loadOntology } from "../ontology/loader.js";
+import { resolveConcept } from "../ontology/resolver.js";
+import { parseNote } from "../conventions/frontmatter.js";
+import { validateFrontmatter } from "../conventions/validate.js";
+import { runMcpServer } from "../mcp/server.js";
+import { formatHostOperationResults, runHostOperation, } from "../install/hosts.js";
+const DEFAULT_RELEASE_PACKAGE_SPEC = "https://github.com/GoBeromsu/oms/releases/download/oms-v0.1.5/oms-0.1.5.tgz";
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the bundled `core/ontology` directory.
+ * Both the built path (`dist/cli/`) and the source path (`src/cli/`) are two
+ * levels beneath the repo root, so `../../core/ontology` works in both cases.
+ */
+function bundledOntologyDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    return path.resolve(__dirname, "../../core/ontology");
+}
+/**
+ * Resolve the bundled Claude Code adapter directory.
+ * Kept parallel to bundledOntologyDir so source and built paths both work.
+ */
+function bundledClaudeAdapterDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    return path.resolve(__dirname, "../../adapters/claude-code");
+}
+/**
+ * Resolve the bundled `adapters` root so host installers can copy the
+ * runtime-specific adapter assets from either source or dist execution.
+ */
+function bundledAdapterRoot() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    return path.resolve(__dirname, "../../adapters");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Humanize a folder name: "references" → "References". */
+function humanize(name) {
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+/** Quote a value for copy/pasteable POSIX shell commands. */
+function shellQuote(value) {
+    if (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(value)) {
+        return value;
+    }
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+export function buildClaudeInstallPlan(opts) {
+    const pluginPath = bundledClaudeAdapterDir();
+    return {
+        pluginPath,
+        pluginInstallCommand: `claude plugin install ${shellQuote(pluginPath)}`,
+        mcpRegistrationCommand: `claude mcp add oms -- npx -y ${shellQuote(DEFAULT_RELEASE_PACKAGE_SPEC)} mcp --vault ${shellQuote(opts.vault)}`,
+        mcpRuntimeStatus: "read-status-runtime",
+    };
+}
+function printClaudeInstallPlan(plan) {
+    console.log("Claude Code harness install plan (dry-run).");
+    console.log(`  Plugin path: ${plan.pluginPath}`);
+    console.log(`  Plugin command: ${plan.pluginInstallCommand}`);
+    console.log(`  MCP command: ${plan.mcpRegistrationCommand}`);
+    console.log("  MCP status: status/read/cache/retrieval plus safe capture; commit is gated by vault confinement and contract validation.");
+}
+/** Walk a directory recursively, yielding relative paths for all .md files. */
+async function* walkMarkdown(dir, base, skipDirs) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        if (skipDirs.has(entry.name))
+            continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            yield* walkMarkdown(full, base, skipDirs);
+        }
+        else if (entry.isFile() && entry.name.endsWith(".md")) {
+            yield path.relative(base, full).replace(/\\/g, "/");
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// runSetup
+// ---------------------------------------------------------------------------
+export async function runSetup(opts) {
+    const { vault, yes, installClaude = false } = opts;
+    const nonInteractive = yes || process.env["OMS_NON_INTERACTIVE"] === "1";
+    const ontologyDir = bundledOntologyDir();
+    // Load shipped concepts so we can offer meaningful defaults.
+    const ontology = await loadOntology(ontologyDir);
+    // Scan vault top-level directories (skip dotfiles).
+    const topEntries = await readdir(vault, { withFileTypes: true });
+    const folders = topEntries
+        .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+        .map((e) => e.name);
+    const folderBindings = {};
+    if (nonInteractive) {
+        // Non-interactive: use defaults without readline.
+        for (const folder of folders) {
+            // Find a shipped concept whose folder field matches.
+            let conceptName = null;
+            for (const [name, concept] of ontology.concepts) {
+                if (concept.folder === folder) {
+                    conceptName = name;
+                    break;
+                }
+            }
+            folderBindings[folder] = {
+                intent: humanize(folder),
+                concept: conceptName,
+            };
+        }
+    }
+    else {
+        // Interactive: ask intent and concept for each folder.
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        const conceptNames = Array.from(ontology.concepts.keys());
+        try {
+            console.log("\nOh My Second Brain Setup — adopting existing vault folders.\n");
+            console.log(`Available shipped concepts: ${conceptNames.join(", ") || "(none)"}\n`);
+            for (const folder of folders) {
+                const defaultIntent = humanize(folder);
+                const rawIntent = await rl.question(`Folder "${folder}" — intent [${defaultIntent}]: `);
+                const intent = rawIntent.trim() || defaultIntent;
+                // Find default concept
+                let defaultConcept = null;
+                for (const [name, concept] of ontology.concepts) {
+                    if (concept.folder === folder) {
+                        defaultConcept = name;
+                        break;
+                    }
+                }
+                const conceptPrompt = defaultConcept
+                    ? `  Bind concept [${defaultConcept}] (blank = ${defaultConcept}, "null" = none): `
+                    : `  Bind concept (${conceptNames.join("/") || "none"}, blank = none): `;
+                const rawConcept = await rl.question(conceptPrompt);
+                const trimmed = rawConcept.trim();
+                let conceptName;
+                if (trimmed === "null" || trimmed === "") {
+                    conceptName = trimmed === "null" ? null : (defaultConcept ?? null);
+                }
+                else if (ontology.concepts.has(trimmed)) {
+                    conceptName = trimmed;
+                }
+                else {
+                    console.warn(`  Unknown concept "${trimmed}"; binding as null.`);
+                    conceptName = null;
+                }
+                folderBindings[folder] = { intent, concept: conceptName };
+            }
+        }
+        finally {
+            rl.close();
+        }
+    }
+    const taxonomy = { version: 0, folders: folderBindings };
+    // Write the vault-local ontology. ``.oms/` IS the ontology directory:
+    // `.oms/taxonomy.yaml` + `.oms/concepts/*.yaml`, matching loadOntology's
+    // contract so `oms doctor` can load it directly.
+    const omsDir = path.join(vault, ".oms");
+    const conceptsOutDir = path.join(omsDir, "concepts");
+    await mkdir(conceptsOutDir, { recursive: true });
+    await import("node:fs/promises").then(({ writeFile }) => writeFile(path.join(omsDir, "taxonomy.yaml"), yamlStringify(taxonomy), "utf-8"));
+    // Copy shipped concept yaml files into vault/.oms/concepts/
+    const conceptsSourceDir = path.join(ontologyDir, "concepts");
+    let copiedFiles = [];
+    try {
+        const conceptFiles = await readdir(conceptsSourceDir);
+        for (const file of conceptFiles) {
+            if (file.endsWith(".yaml") || file.endsWith(".yml")) {
+                await copyFile(path.join(conceptsSourceDir, file), path.join(conceptsOutDir, file));
+                copiedFiles.push(file);
+            }
+        }
+    }
+    catch (err) {
+        console.warn("[oms] Could not copy concept files:", err);
+    }
+    // Summary
+    console.log(`\nOh My Second Brain setup complete.`);
+    console.log(`  Vault:    ${vault}`);
+    console.log(`  Written:  ${path.join(omsDir, "taxonomy.yaml")}`);
+    console.log(`  Concepts: ${copiedFiles.join(", ") || "(none)"}`);
+    console.log(`  Folders:  ${Object.keys(folderBindings).join(", ") || "(none)"}`);
+    console.log(`\nRun "npx -y https://github.com/GoBeromsu/oms/releases/download/oms-v0.1.5/oms-0.1.5.tgz doctor" to validate existing notes.\n`);
+    if (installClaude) {
+        printClaudeInstallPlan(buildClaudeInstallPlan({ vault }));
+        console.log("");
+    }
+}
+// ---------------------------------------------------------------------------
+// runDoctor
+// ---------------------------------------------------------------------------
+export async function runDoctor(opts) {
+    const { vault } = opts;
+    // Doctor is non-blocking (onViolation: warn). It must ALWAYS exit 0 in v0,
+    // even if the ontology is missing or unparseable — wrap the whole body so a
+    // failure surfaces as a warning, never a non-zero exit.
+    try {
+        // Load ontology: prefer the vault-local `.oms/` ontology, fall back to the
+        // bundled defaults. The vault-local layout is `.oms/taxonomy.yaml` +
+        // `.oms/concepts/`, so `.oms/` itself is the ontology dir.
+        const localOntologyDir = path.join(vault, ".oms");
+        let ontologyDir;
+        try {
+            await readdir(path.join(localOntologyDir, "concepts"));
+            ontologyDir = localOntologyDir;
+        }
+        catch {
+            ontologyDir = bundledOntologyDir();
+        }
+        const ontology = await loadOntology(ontologyDir);
+        const skipDirs = new Set(["node_modules"]);
+        let totalNotes = 0;
+        let totalViolations = 0;
+        let notesWithViolations = 0;
+        for await (const relPath of walkMarkdown(vault, vault, skipDirs)) {
+            const concept = resolveConcept(ontology, relPath);
+            if (!concept)
+                continue;
+            totalNotes++;
+            const fullPath = path.join(vault, relPath);
+            let raw;
+            try {
+                raw = await readFile(fullPath, "utf-8");
+            }
+            catch {
+                console.warn(`[oms] Could not read ${relPath}`);
+                continue;
+            }
+            const { frontmatter } = parseNote(raw);
+            const result = validateFrontmatter(frontmatter, concept);
+            if (result.violations.length > 0) {
+                notesWithViolations++;
+                totalViolations += result.violations.length;
+                console.log(`\n  ${relPath} [concept: ${concept.concept}]`);
+                for (const v of result.violations) {
+                    console.log(`    [${v.rule}] ${v.message}`);
+                }
+            }
+        }
+        console.log(`\nOh My Second Brain doctor: ${totalNotes} notes checked, ${notesWithViolations} with violations, ${totalViolations} total violations.`);
+        console.log("All violations are warnings (onViolation: warn). Exit 0.\n");
+    }
+    catch (err) {
+        console.warn("[oms] doctor could not complete:", err);
+    }
+    // Always exit 0 in v0 (non-blocking, onViolation: warn).
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// main
+// ---------------------------------------------------------------------------
+function printUsage() {
+    console.log(`
+oms — Oh My Second Brain convention layer for Obsidian vaults
+
+Usage:
+  oms setup [--vault <path>] [--yes] [--install-claude]
+  oms install [--vault <path>] [--runtime <auto|all|claude|codex|hermes>] [--dry-run] [--execute] [--yes]
+  oms uninstall [--runtime <all|claude|codex|hermes>] [--dry-run] [--execute] [--yes]
+  oms doctor [--vault <path>]
+  oms mcp [--vault <path>]
+
+Commands:
+  setup    Adopt an existing vault into the Oh My Second Brain convention.
+  install  Install Oh My Second Brain host adapters and MCP registration.
+  uninstall Remove Oh My Second Brain host adapters and MCP registration.
+  doctor   Validate vault notes against the active ontology.
+  mcp      Start the read/status MCP stdio server.
+
+Options:
+  --vault <path>   Path to the vault root (default: current directory).
+  --yes            Non-interactive: accept all defaults (setup only).
+  --install-claude Print Claude Code plugin install and MCP registration commands (dry-run).
+  --runtime <name> Select host runtime (default: auto for install, all for uninstall).
+  --dry-run        Preview host config changes without writing files.
+  --execute        Allow external host CLIs such as \`claude\` to run when available.
+`);
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const command = argv[0];
+    // Parse shared flags.
+    let vault = process.cwd();
+    let yes = false;
+    let installClaude = false;
+    let runtime;
+    let dryRun = false;
+    let executeExternal = false;
+    for (let i = 1; i < argv.length; i++) {
+        if (argv[i] === "--vault" && argv[i + 1]) {
+            vault = path.resolve(argv[i + 1]);
+            i++;
+        }
+        else if (argv[i] === "--yes") {
+            yes = true;
+        }
+        else if (argv[i] === "--install-claude") {
+            installClaude = true;
+        }
+        else if (argv[i] === "--runtime" && argv[i + 1]) {
+            const rawRuntime = argv[i + 1];
+            if (rawRuntime === "auto" ||
+                rawRuntime === "all" ||
+                rawRuntime === "claude" ||
+                rawRuntime === "codex" ||
+                rawRuntime === "hermes") {
+                runtime = rawRuntime;
+            }
+            else {
+                console.error(`[oms] Unsupported runtime: ${rawRuntime}`);
+                process.exitCode = 1;
+                return;
+            }
+            i++;
+        }
+        else if (argv[i] === "--dry-run") {
+            dryRun = true;
+        }
+        else if (argv[i] === "--execute") {
+            executeExternal = true;
+        }
+    }
+    if (command === "setup") {
+        await runSetup({ vault, yes, installClaude });
+    }
+    else if (command === "install" || command === "uninstall") {
+        const selectedRuntime = runtime ?? (command === "install" ? "auto" : "all");
+        if (command === "uninstall" && !yes && !dryRun && process.env["OMS_NON_INTERACTIVE"] !== "1") {
+            console.error("[oms] Refusing uninstall without --yes or --dry-run.");
+            process.exitCode = 1;
+            return;
+        }
+        const results = await runHostOperation({
+            action: command,
+            runtime: selectedRuntime,
+            vault,
+            dryRun,
+            executeExternal,
+            yes,
+            adapterRoot: bundledAdapterRoot(),
+        });
+        console.log(formatHostOperationResults(results, dryRun));
+    }
+    else if (command === "doctor") {
+        process.exitCode = await runDoctor({ vault });
+    }
+    else if (command === "mcp") {
+        await runMcpServer({ vault });
+    }
+    else {
+        printUsage();
+        process.exitCode = 0;
+    }
+}
+// Guard: only run main() when this file is the entry point.
+// Works for both source (`src/cli/oms.ts`) and built (`dist/cli/oms.js`) paths.
+const __filename = fileURLToPath(import.meta.url);
+function sameEntrypoint(left, right) {
+    const resolvedLeft = path.resolve(left);
+    const resolvedRight = path.resolve(right);
+    if (resolvedLeft === resolvedRight)
+        return true;
+    try {
+        return realpathSync(resolvedLeft) === realpathSync(resolvedRight);
+    }
+    catch {
+        return false;
+    }
+}
+const isMain = process.argv[1] !== undefined &&
+    (sameEntrypoint(process.argv[1], __filename) ||
+        sameEntrypoint(process.argv[1], __filename.replace(/\.ts$/, ".js")));
+if (isMain) {
+    main().catch((err) => {
+        console.error("[oms] Fatal error:", err);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=oms.js.map

package/dist/cli/oms.js.map

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

package/dist/conventions/frontmatter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Split a markdown document into its YAML frontmatter and body.
+ *
+ * Recognizes the standard Obsidian/Jekyll fence: a `---` line at the very start
+ * of the file, the YAML block, then a closing `---` line.
+ */
+export interface ParsedNote {
+    /** Parsed frontmatter as a plain object. Empty object when no frontmatter. */
+    frontmatter: Record<string, unknown>;
+    /** The markdown body after the closing fence (or the whole doc if no fence). */
+    body: string;
+    /** Whether a frontmatter block was present. */
+    hasFrontmatter: boolean;
+}
+export declare function parseNote(raw: string): ParsedNote;

package/dist/conventions/frontmatter.js

@@ -0,0 +1,23 @@
+import { parse as parseYaml } from "yaml";
+const FENCE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+export function parseNote(raw) {
+    // Only treat as frontmatter if the document opens with the fence.
+    if (!raw.startsWith("---")) {
+        return { frontmatter: {}, body: raw, hasFrontmatter: false };
+    }
+    const match = FENCE.exec(raw);
+    if (!match) {
+        return { frontmatter: {}, body: raw, hasFrontmatter: false };
+    }
+    const yamlText = match[1] ?? "";
+    const parsed = parseYaml(yamlText);
+    const frontmatter = parsed && typeof parsed === "object" && !Array.isArray(parsed)
+        ? parsed
+        : {};
+    return {
+        frontmatter,
+        body: raw.slice(match[0].length),
+        hasFrontmatter: true,
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/conventions/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/conventions/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAiB1C,MAAM,KAAK,GAAG,mCAAmC,CAAC;AAElD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,kEAAkE;IAClE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,WAAW,GACf,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5D,CAAC,CAAE,MAAkC;QACrC,CAAC,CAAC,EAAE,CAAC;IACT,OAAO;QACL,WAAW;QACX,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAChC,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC"}

package/dist/conventions/validate.d.ts

@@ -0,0 +1,24 @@
+import type { Concept } from "../ontology/types.js";
+export type ViolationRule = "required" | "type" | "immutable";
+export interface Violation {
+    field: string;
+    rule: ViolationRule;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    violations: Violation[];
+}
+/**
+ * Validate a note's frontmatter against a declared Concept.
+ *
+ * Rules:
+ * - required: field absent or empty → Violation{rule:"required"}
+ * - type: field present and non-empty, but wrong type → Violation{rule:"type"}
+ * - immutable: intentionally suppressed in v0 (no baseline exists; union member
+ *   kept for forward-compatibility with v1 delta-tracking).
+ * - Undeclared frontmatter keys → NO violation (additionalProperties: preserve).
+ *
+ * NEVER throws. valid = violations.length === 0.
+ */
+export declare function validateFrontmatter(frontmatter: Record<string, unknown>, concept: Concept): ValidationResult;

package/dist/conventions/validate.js

@@ -0,0 +1,88 @@
+/**
+ * Check whether a value is "empty" for the purposes of the `required` rule.
+ * A value is empty if it is undefined, null, an empty string, or an empty array.
+ */
+function isEmpty(value) {
+    if (value === undefined || value === null)
+        return true;
+    if (typeof value === "string" && value.trim() === "")
+        return true;
+    if (Array.isArray(value) && value.length === 0)
+        return true;
+    return false;
+}
+/**
+ * Check whether a value matches the declared FieldType.
+ */
+function matchesType(value, field) {
+    switch (field.type) {
+        case "string":
+            return typeof value === "string";
+        case "number":
+            return typeof value === "number";
+        case "boolean":
+            return typeof value === "boolean";
+        case "list":
+            return Array.isArray(value);
+        case "url": {
+            if (typeof value !== "string")
+                return false;
+            try {
+                new URL(value);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        case "date": {
+            if (value instanceof Date)
+                return !isNaN(value.getTime());
+            if (typeof value === "string") {
+                // Accept YYYY-MM-DD and anything Date() parses to a valid date.
+                if (!/\S/.test(value))
+                    return false;
+                const d = new Date(value);
+                return !isNaN(d.getTime());
+            }
+            return false;
+        }
+    }
+}
+/**
+ * Validate a note's frontmatter against a declared Concept.
+ *
+ * Rules:
+ * - required: field absent or empty → Violation{rule:"required"}
+ * - type: field present and non-empty, but wrong type → Violation{rule:"type"}
+ * - immutable: intentionally suppressed in v0 (no baseline exists; union member
+ *   kept for forward-compatibility with v1 delta-tracking).
+ * - Undeclared frontmatter keys → NO violation (additionalProperties: preserve).
+ *
+ * NEVER throws. valid = violations.length === 0.
+ */
+export function validateFrontmatter(frontmatter, concept) {
+    const violations = [];
+    for (const field of concept.fields) {
+        const value = frontmatter[field.name];
+        if (field.required && isEmpty(value)) {
+            violations.push({
+                field: field.name,
+                rule: "required",
+                message: `Required field "${field.name}" is absent or empty.`,
+            });
+            // Skip type check — nothing to check if the value is absent/empty.
+            continue;
+        }
+        // Type-check only if the value is present and non-empty.
+        if (!isEmpty(value) && !matchesType(value, field)) {
+            violations.push({
+                field: field.name,
+                rule: "type",
+                message: `Field "${field.name}" expected type "${field.type}" but received ${Array.isArray(value) ? "array" : typeof value}.`,
+            });
+        }
+    }
+    return { valid: violations.length === 0, violations };
+}
+//# sourceMappingURL=validate.js.map

package/dist/conventions/validate.js.map

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