oh-my-second-brain 0.1.8 → 0.2.0

package/dist/cli/setup-documents.js

@@ -0,0 +1,149 @@
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as yamlParse, stringify as yamlStringify } from "yaml";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseConceptRef(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === "string")
+        return value;
+    if (Array.isArray(value) && value.every((item) => typeof item === "string"))
+        return value;
+    return null;
+}
+function parseFolderBinding(value) {
+    if (!isRecord(value))
+        return null;
+    const rawIntent = value["intent"];
+    return {
+        intent: typeof rawIntent === "string" && rawIntent.trim() ? rawIntent : "",
+        concept: parseConceptRef(value["concept"]),
+    };
+}
+function parseConceptDocument(filePath, parsed) {
+    const concept = {
+        concept: typeof parsed["concept"] === "string" ? parsed["concept"] : path.basename(filePath, path.extname(filePath)),
+        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"] : [],
+    };
+    return { filePath, raw: parsed, concept };
+}
+export async function readConceptDocuments(omsDir) {
+    const documents = new Map();
+    const conceptsDir = path.join(omsDir, "concepts");
+    let entries;
+    try {
+        entries = await readdir(conceptsDir);
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return documents;
+        throw error;
+    }
+    for (const file of entries) {
+        if (!file.endsWith(".yaml") && !file.endsWith(".yml"))
+            continue;
+        const filePath = path.join(conceptsDir, file);
+        const parsed = yamlParse(await readFile(filePath, "utf-8"));
+        if (!isRecord(parsed))
+            continue;
+        const document = parseConceptDocument(filePath, parsed);
+        documents.set(document.concept.concept, document);
+    }
+    return documents;
+}
+export function buildPromptConcepts(shippedConcepts, localDocuments) {
+    const concepts = new Map(shippedConcepts);
+    for (const [name, document] of localDocuments) {
+        concepts.set(name, document.concept);
+    }
+    return concepts;
+}
+export function defaultConceptForFolder(concepts, folder) {
+    for (const [name, concept] of concepts) {
+        if (concept.folder === folder)
+            return name;
+    }
+    return null;
+}
+export function conceptRefToPromptDefault(concept) {
+    if (Array.isArray(concept))
+        return concept[0] ?? null;
+    return concept;
+}
+export function isFieldType(value) {
+    switch (value) {
+        case "string":
+        case "url":
+        case "date":
+        case "list":
+        case "number":
+        case "boolean":
+            return true;
+        default:
+            return false;
+    }
+}
+export async function readExistingTaxonomy(omsDir) {
+    try {
+        const raw = await readFile(path.join(omsDir, "taxonomy.yaml"), "utf-8");
+        const parsed = yamlParse(raw);
+        if (!isRecord(parsed))
+            return null;
+        const rawFolders = parsed["folders"];
+        const folders = {};
+        if (isRecord(rawFolders)) {
+            for (const [folder, binding] of Object.entries(rawFolders)) {
+                const parsedBinding = parseFolderBinding(binding);
+                if (parsedBinding !== null) {
+                    folders[folder] = parsedBinding;
+                }
+            }
+        }
+        return {
+            version: typeof parsed["version"] === "number" ? parsed["version"] : 0,
+            folders,
+        };
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return null;
+        throw error;
+    }
+}
+export function mergeAdditionalFields(concept, fields) {
+    const existing = new Set(concept.fields.map((field) => field.name));
+    const additions = fields.filter((field) => !existing.has(field.name));
+    return {
+        ...concept,
+        fields: [...concept.fields, ...additions],
+        lenses: concept.lenses ?? [],
+    };
+}
+export function mergeAdditionalLenses(concept, lenses) {
+    const existing = new Set((concept.lenses ?? []).map((lens) => lens.name));
+    const additions = lenses.filter((lens) => !existing.has(lens.name));
+    return {
+        ...concept,
+        fields: concept.fields,
+        lenses: [...(concept.lenses ?? []), ...additions],
+    };
+}
+export async function writeConcept(omsDir, concept, existingDocument) {
+    const conceptsOutDir = path.join(omsDir, "concepts");
+    await mkdir(conceptsOutDir, { recursive: true });
+    const document = {
+        ...(existingDocument?.raw ?? {}),
+        concept: concept.concept,
+        intent: concept.intent,
+        folder: concept.folder,
+        fields: concept.fields,
+        lenses: concept.lenses ?? [],
+    };
+    await writeFile(existingDocument?.filePath ?? path.join(conceptsOutDir, `${concept.concept}.yaml`), yamlStringify(document), "utf-8");
+}
+//# sourceMappingURL=setup-documents.js.map

package/dist/cli/setup-documents.js.map

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

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

@@ -0,0 +1,10 @@
+import { type UpdateRunner } from "../update/update.js";
+export declare function readCurrentPackageVersion(): Promise<string | null>;
+export declare function maybePrintUpdateNotice(options?: {
+    readonly currentVersion?: string | null;
+    readonly latestVersion?: string;
+    readonly timeoutMs?: number;
+    readonly runner?: UpdateRunner;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly write?: (message: string) => void;
+}): Promise<void>;

package/dist/cli/update-notice.js

@@ -0,0 +1,42 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveBundledAssetPaths } from "../core/runtime/assets.js";
+import { checkUpdateNotice, formatUpdateNotice, } from "../update/update.js";
+const bundledAssets = resolveBundledAssetPaths();
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export async function readCurrentPackageVersion() {
+    const packageJson = JSON.parse(await readFile(path.join(bundledAssets.packageRoot, "package.json"), "utf-8"));
+    return isRecord(packageJson) && typeof packageJson["version"] === "string"
+        ? packageJson["version"]
+        : null;
+}
+function updateNoticeDisabled(env) {
+    return env["OMS_UPDATE_NOTICE"] === "0" || env["OMS_NO_UPDATE_NOTICE"] === "1";
+}
+function parseUpdateNoticeTimeout(env) {
+    const raw = env["OMS_UPDATE_NOTICE_TIMEOUT_MS"];
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+export async function maybePrintUpdateNotice(options = {}) {
+    const env = options.env ?? process.env;
+    if (updateNoticeDisabled(env))
+        return;
+    const currentVersion = options.currentVersion ?? await readCurrentPackageVersion();
+    const notice = await checkUpdateNotice({
+        currentVersion,
+        latestVersion: options.latestVersion ?? env["OMS_UPDATE_LATEST_VERSION"],
+        timeoutMs: options.timeoutMs ?? parseUpdateNoticeTimeout(env),
+        runner: options.runner,
+    });
+    const formatted = formatUpdateNotice(notice);
+    if (formatted.length === 0)
+        return;
+    const write = options.write ?? ((message) => console.error(message));
+    write(`\n${formatted}`);
+}
+//# sourceMappingURL=update-notice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-notice.js","sourceRoot":"","sources":["../../src/cli/update-notice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,aAAa,GAAG,wBAAwB,EAAE,CAAC;AAEjD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,WAAW,GAAY,IAAI,CAAC,KAAK,CACrC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAC9E,CAAC;IACF,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,WAAW,CAAC,SAAS,CAAC,KAAK,QAAQ;QACxE,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC;QACxB,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAiD;IAC7E,OAAO,GAAG,CAAC,mBAAmB,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,sBAAsB,CAAC,KAAK,GAAG,CAAC;AACjF,CAAC;AAED,SAAS,wBAAwB,CAC/B,GAAiD;IAEjD,MAAM,GAAG,GAAG,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAChD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAOzC,EAAE;IACJ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,IAAI,oBAAoB,CAAC,GAAG,CAAC;QAAE,OAAO;IAEtC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,yBAAyB,EAAE,CAAC;IACnF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,cAAc;QACd,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC,2BAA2B,CAAC;QACxE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,wBAAwB,CAAC,GAAG,CAAC;QAC7D,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC;AAC1B,CAAC"}

package/dist/cli/usage.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessSurfaceRegistry } from "../harness/surface-registry.js";
+export declare function mainUsageCommandNames(registry?: HarnessSurfaceRegistry): readonly string[];
+export declare function cliUsageText(registry?: HarnessSurfaceRegistry): string;
+export declare function printUsage(): void;

package/dist/cli/usage.js

@@ -0,0 +1,102 @@
+import { harnessSurfaceRegistry } from "../harness/surface-registry.js";
+const MAIN_USAGE_COMMANDS = [
+    { name: "setup", line: "  setup    Adopt an existing vault into the Oh My Second Brain convention." },
+    { name: "install", line: "  install  Install Oh My Second Brain host adapters and MCP registration." },
+    { name: "uninstall", line: "  uninstall Remove Oh My Second Brain host adapters and MCP registration." },
+    { name: "update", line: "  update   Check for or apply an explicit package update, then refresh host adapters." },
+    { name: "doctor", line: "  doctor   Validate vault frontmatter against the active ontology, aggregated by field and concept." },
+    {
+        name: "audit",
+        line: "  audit    CI-usable ontology lint: doctor checks with non-zero exit on violations.",
+        detailLines: [
+            "             --folder <name>   Restrict the scan to one top-level vault folder.",
+            "             --json             Emit structured JSON instead of console text.",
+            "             --suggest-fields   Report undeclared observed fields and enum-value drift.",
+        ],
+    },
+    { name: "lint", line: "  lint     Check vault link health: broken [[wikilinks]] and orphan notes." },
+    { name: "link", line: "  link     Bridge an external repo to scoped vault folders via gitignored symlinks." },
+    {
+        name: "linkify",
+        line: "  linkify  Propose [[wikilinks]] to term notes across existing notes; report-only by default.",
+        detailLines: [
+            "             --folder <name>   Restrict the scan and writes to one top-level vault folder.",
+            "             --apply --yes     Rewrite notes in place; --apply alone refuses and writes nothing.",
+        ],
+    },
+    { name: "semantic", line: "  semantic Native markdown semantic index/search/get commands." },
+    { name: "mcp", line: "  mcp      Start the read/status MCP stdio server." },
+    {
+        name: "hook",
+        line: "  hook     Vault guard hooks for Claude Code PreToolUse / PostToolUse events.",
+        detailLines: [
+            "             pre-tool-use  Read PreToolUse JSON from stdin; block unregistered folder creation.",
+            "             post-tool-use Read PostToolUse JSON from stdin; audit frontmatter + trigger graph build.",
+        ],
+    },
+];
+export function mainUsageCommandNames(registry = harnessSurfaceRegistry) {
+    const registered = new Set(registry.cliCommands.map((command) => command.name));
+    return MAIN_USAGE_COMMANDS.filter((command) => registered.has(command.name)).map((command) => command.name);
+}
+function commandLines(registry) {
+    const registered = new Set(registry.cliCommands.map((command) => command.name));
+    const lines = [];
+    for (const command of MAIN_USAGE_COMMANDS) {
+        if (!registered.has(command.name))
+            continue;
+        lines.push(command.line);
+        if (command.detailLines !== undefined)
+            lines.push(...command.detailLines);
+    }
+    return lines.join("\n");
+}
+function runtimeChoices(registry) {
+    return ["auto", "all", ...registry.hosts.map((host) => host.runtime)].join("|");
+}
+export function cliUsageText(registry = harnessSurfaceRegistry) {
+    const runtime = runtimeChoices(registry);
+    return `
+oh-my-second-brain — Oh My Second Brain convention layer for Obsidian vaults
+
+Usage:
+  oh-my-second-brain setup [--vault <path>] [--yes] [--suggest-fields] [--install-claude]
+  oh-my-second-brain install [--vault <path>] [--runtime <${runtime}>] [--dry-run] [--execute] [--yes] [--json]
+  oh-my-second-brain uninstall [--runtime <all|${registry.hosts.map((host) => host.runtime).join("|")}>] [--dry-run] [--execute] [--yes] [--json]
+  oh-my-second-brain update [--check] [--dry-run] [--yes] [--runtime <${runtime}>] [--vault <path>]
+  oh-my-second-brain doctor [--vault <path>] [--verbose] [--json] [--max <n>]
+  oh-my-second-brain audit [--vault <path>] [--folder <name>] [--json] [--suggest-fields]
+  oh-my-second-brain lint [--vault <path>] [--verbose] [--json]
+  oh-my-second-brain link --vault <path> --folder <name> [--folder <name> ...] [--no-convention-note]
+  oh-my-second-brain linkify [--vault <path>] [--folder <name>] [--apply --yes]
+  oh-my-second-brain semantic <status|sync|query|search|vsearch|get|multi-get|collection> [options]
+  oh-my-second-brain mcp [--vault <path>]
+  oh-my-second-brain hook pre-tool-use [--vault <path>]
+  oh-my-second-brain hook post-tool-use [--vault <path>]
+
+Compatibility alias: oms <command>
+
+Commands:
+${commandLines(registry)}
+
+Options:
+  --vault <path>   Path to the vault root (default: current directory).
+  --yes            Non-interactive setup, uninstall confirmation, or update execution.
+  --suggest-fields During setup --yes, add conservative observed frontmatter fields to concepts.
+  --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.
+  --verbose        doctor/lint: list every affected note instead of a summary.
+  --json           doctor/lint/audit: emit machine-readable output as JSON.
+  --max <n>        doctor --verbose: max notes listed per concept (default 50).
+  --folder <name>  audit/linkify: restrict scan; link: vault folder/subpath to expose (repeatable for link).
+  --apply          linkify: rewrite notes in place; must be combined with --yes.
+  --no-convention-note
+                  link: skip writing the managed OMS usage block to AGENTS.md.
+`;
+}
+export function printUsage() {
+    console.log(cliUsageText());
+}
+//# sourceMappingURL=usage.js.map

package/dist/cli/usage.js.map

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

package/dist/conventions/lint.js

@@ -1,31 +1,7 @@
-import { readFile, readdir } from "node:fs/promises";
+import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { parseNote } from "./frontmatter.js";
-// Folders skipped during vault walks (same set as graph/cache.ts).
-const SKIP_DIRS = new Set([
-    ".oms", ".obsidian", ".trash", ".git", ".claude",
-    "_archive", "node_modules",
-]);
-async function* walkMarkdown(dir, base) {
-    let entries;
-    try {
-        entries = await readdir(dir, { withFileTypes: true });
-    }
-    catch {
-        return;
-    }
-    for (const entry of entries) {
-        if (entry.name.startsWith(".") || SKIP_DIRS.has(entry.name))
-            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, "/");
-        }
-    }
-}
+import { walkVaultMarkdown, mapWithConcurrency } from "./vault-walk.js";
 const WIKILINK_RE = /\[\[([^\]|#\n]+?)(?:[#|][^\]]*?)?\]\]/g;
 export function extractWikilinks(body) {
     const links = new Set();
@@ -61,22 +37,25 @@ function buildNoteIndex(notePaths) {
  */
 export async function detectLinkIssues(vault) {
     const allPaths = [];
-    for await (const p of walkMarkdown(vault, vault)) {
+    for await (const p of walkVaultMarkdown(vault)) {
         allPaths.push(p);
     }
     const noteIndex = buildNoteIndex(allPaths);
     const brokenLinks = [];
     const incomingCount = new Map(allPaths.map((p) => [p, 0]));
-    for (const notePath of allPaths) {
-        let raw;
+    // Read + extract links in parallel (I/O-bound), then resolve sequentially in
+    // path order so brokenLinks ordering stays deterministic.
+    const perNote = await mapWithConcurrency(allPaths, 64, async (notePath) => {
         try {
-            raw = await readFile(path.join(vault, notePath), "utf-8");
+            const raw = await readFile(path.join(vault, notePath), "utf-8");
+            return { notePath, targets: extractWikilinks(parseNote(raw).body) };
         }
         catch {
-            continue;
+            return { notePath, targets: [] };
         }
-        const { body } = parseNote(raw);
-        for (const target of extractWikilinks(body)) {
+    });
+    for (const { notePath, targets } of perNote) {
+        for (const target of targets) {
             const resolved = noteIndex.get(target.toLowerCase());
             if (resolved === undefined) {
                 brokenLinks.push({ notePath, target });

package/dist/conventions/lint.js.map

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

package/dist/conventions/report.d.ts

@@ -0,0 +1,62 @@
+import type { Violation } from "./validate.js";
+import type { VaultLintResult } from "./lint.js";
+/** One scanned note and the violations found in its frontmatter (empty = clean). */
+export interface NoteReport {
+    notePath: string;
+    concept: string;
+    violations: readonly Violation[];
+}
+/** Aggregated counts for a single (field, rule) pair. */
+export interface FieldRuleAgg {
+    field: string;
+    rule: string;
+    /** Distinct notes that hit this field+rule at least once. */
+    notes: number;
+    /** Total occurrences of this field+rule across all notes. */
+    violations: number;
+}
+export interface ConceptAgg {
+    concept: string;
+    notes: number;
+    notesWithViolations: number;
+    violations: number;
+    /** Per (field, rule) breakdown, sorted by impact descending. */
+    fields: FieldRuleAgg[];
+}
+export interface DoctorAggregate {
+    totalNotes: number;
+    notesWithViolations: number;
+    totalViolations: number;
+    /** Per-concept breakdown, sorted by violation count descending. */
+    concepts: ConceptAgg[];
+    /** Flat per-frontmatter-field rollup across all concepts, most-violated first. */
+    fields: Array<FieldRuleAgg & {
+        concept: string;
+    }>;
+}
+/**
+ * Roll up per-note frontmatter violations into concept- and field-level
+ * aggregates. Every scanned note (clean or not) should be passed so that
+ * per-concept totals reflect coverage, not just failures.
+ */
+export declare function aggregateDoctor(notes: readonly NoteReport[]): DoctorAggregate;
+export interface DoctorFormatOptions {
+    vault: string;
+    /** Append a per-note listing of every violation. */
+    verbose?: boolean;
+    /** Cap on notes listed per concept in verbose mode (default 50). */
+    maxPerConcept?: number;
+    /** Scanned notes — required for the verbose listing. */
+    notes?: readonly NoteReport[];
+}
+export declare function formatDoctorReport(agg: DoctorAggregate, opts: DoctorFormatOptions): string;
+export interface LintFormatOptions {
+    vault: string;
+    /** List every broken link and orphan instead of a capped summary. */
+    verbose?: boolean;
+    /** Max offending notes listed for broken links (default 20). */
+    maxBroken?: number;
+    /** Max orphan notes listed (default 20). */
+    maxOrphans?: number;
+}
+export declare function formatLintReport(result: VaultLintResult, opts: LintFormatOptions): string;