oh-my-second-brain 0.1.5

package/dist/graph/cache.d.ts

@@ -0,0 +1,98 @@
+import type { Ontology } from "../ontology/types.js";
+export type GraphEdgeType = "folder-concept" | "property-axis" | "property-value" | "wikilink";
+export interface GraphEdge {
+    type: GraphEdgeType;
+    from: string;
+    to: string;
+    axis?: string;
+    value?: string;
+}
+export interface GraphNote {
+    path: string;
+    folder: string;
+    concept: string | null;
+    frontmatter: Record<string, unknown>;
+    axes: Record<string, string[]>;
+    wikilinks: string[];
+    bodyLoaded: false;
+    validation: {
+        valid: boolean;
+        violations: number;
+    };
+}
+export interface SearchDocument {
+    path: string;
+    terms: string[];
+    bodyPreview: string;
+}
+export interface NoteSignature {
+    mtimeMs: number;
+    size: number;
+    frontmatterHash: string;
+    wikilinkHash: string;
+    bodyTextHash: string;
+}
+export interface SourceSignatures {
+    taxonomyHash: string;
+    conceptHashes: Record<string, string>;
+    notes: Record<string, NoteSignature>;
+}
+export interface OMSGraphCache {
+    version: 1;
+    generatedAt: string;
+    sourceOfTruth: string[];
+    signatures: SourceSignatures;
+    notes: GraphNote[];
+    edges: GraphEdge[];
+    search: SearchDocument[];
+}
+export interface GraphStaleness {
+    schemaStale: boolean;
+    graphStale: boolean;
+    searchStale: boolean;
+    embeddingStale: "not-configured" | boolean;
+    validationStale: boolean;
+    reasons: string[];
+}
+export interface GraphCacheStatus {
+    cachePath: string;
+    exists: boolean;
+    generatedAt: string | null;
+    notes: number;
+    edges: number;
+    searchDocuments: number;
+    staleness: GraphStaleness;
+}
+export interface RetrieveByAxisOptions {
+    vault: string;
+    ontology: Ontology;
+    concept?: string;
+    folder?: string;
+    property?: string;
+    value?: string;
+    wikilink?: string;
+    query?: string;
+    limit?: number;
+}
+export interface RetrieveHit {
+    path: string;
+    concept: string | null;
+    folder: string;
+    axes: Record<string, string[]>;
+    wikilinks: string[];
+    score: number;
+    bodyPreview: string;
+}
+export declare function graphCachePath(vault: string): string;
+export declare function buildGraphCache(opts: {
+    vault: string;
+    ontology: Ontology;
+    write?: boolean;
+}): Promise<OMSGraphCache>;
+export declare function readGraphCache(vault: string): Promise<OMSGraphCache | null>;
+export declare function graphCacheStatus(vault: string, ontology: Ontology): Promise<GraphCacheStatus>;
+export declare function retrieveByAxis(opts: RetrieveByAxisOptions): Promise<RetrieveHit[]>;
+export declare function lazyLoadNoteBody(vault: string, notePath: string): Promise<{
+    path: string;
+    body: string;
+}>;

package/dist/graph/cache.js

@@ -0,0 +1,347 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parseNote } from "../conventions/frontmatter.js";
+import { validateFrontmatter } from "../conventions/validate.js";
+import { safeVaultNotePath } from "../capture/safe.js";
+import { resolveConcept } from "../ontology/resolver.js";
+const CACHE_VERSION = 1;
+export function graphCachePath(vault) {
+    return path.join(vault, ".oms", "cache", "graph.json");
+}
+function hash(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+async function* walkMarkdown(dir, base) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name === ".oms" || entry.name === "node_modules" || entry.name.startsWith(".")) {
+            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, "/");
+        }
+    }
+}
+function jsonStable(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(jsonStable).join(",")}]`;
+    }
+    if (value && typeof value === "object") {
+        const record = value;
+        return `{${Object.keys(record)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${jsonStable(record[key])}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function valueToStrings(value) {
+    if (Array.isArray(value)) {
+        return value.flatMap(valueToStrings).filter((item) => item.length > 0);
+    }
+    if (typeof value === "string") {
+        return value.trim() ? [value.trim()] : [];
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return [String(value)];
+    }
+    if (value instanceof Date) {
+        return [value.toISOString()];
+    }
+    return [];
+}
+function extractWikilinks(body) {
+    const links = new Set();
+    const pattern = /\[\[([^\]|#]+)(?:[#|][^\]]*)?\]\]/g;
+    let match;
+    while ((match = pattern.exec(body)) !== null) {
+        const target = match[1]?.trim();
+        if (target)
+            links.add(target);
+    }
+    return Array.from(links).sort();
+}
+function tokenize(text) {
+    const terms = text
+        .toLowerCase()
+        .match(/[\p{L}\p{N}][\p{L}\p{N}_-]{1,}/gu);
+    return Array.from(new Set(terms ?? [])).sort();
+}
+function firstFolder(notePath) {
+    return notePath.split("/")[0] ?? "";
+}
+function conceptSchemaHash(concept) {
+    return hash(jsonStable(concept));
+}
+function taxonomyHash(ontology) {
+    return hash(jsonStable(ontology.taxonomy));
+}
+async function buildSourceSignatures(vault, ontology) {
+    const notes = {};
+    for await (const notePath of walkMarkdown(vault, vault)) {
+        const fullPath = path.join(vault, notePath);
+        const [raw, fileStat] = await Promise.all([readFile(fullPath, "utf-8"), stat(fullPath)]);
+        const parsed = parseNote(raw);
+        const wikilinks = extractWikilinks(parsed.body);
+        notes[notePath] = {
+            mtimeMs: fileStat.mtimeMs,
+            size: fileStat.size,
+            frontmatterHash: hash(jsonStable(parsed.frontmatter)),
+            wikilinkHash: hash(jsonStable(wikilinks)),
+            bodyTextHash: hash(parsed.body),
+        };
+    }
+    return {
+        taxonomyHash: taxonomyHash(ontology),
+        conceptHashes: Object.fromEntries(Array.from(ontology.concepts.entries()).map(([name, concept]) => [
+            name,
+            conceptSchemaHash(concept),
+        ])),
+        notes,
+    };
+}
+function buildNoteGraph(notePath, raw, ontology) {
+    const parsed = parseNote(raw);
+    const folder = firstFolder(notePath);
+    const concept = resolveConcept(ontology, notePath);
+    const axes = {};
+    const edges = [];
+    if (concept) {
+        edges.push({
+            type: "folder-concept",
+            from: notePath,
+            to: `concept:${concept.concept}`,
+        });
+    }
+    for (const [key, rawValue] of Object.entries(parsed.frontmatter)) {
+        const values = valueToStrings(rawValue);
+        if (values.length === 0)
+            continue;
+        axes[key] = values;
+        edges.push({ type: "property-axis", from: notePath, to: `axis:${key}`, axis: key });
+        for (const value of values) {
+            edges.push({
+                type: "property-value",
+                from: notePath,
+                to: `axis:${key}:value:${value}`,
+                axis: key,
+                value,
+            });
+        }
+    }
+    const wikilinks = extractWikilinks(parsed.body);
+    for (const target of wikilinks) {
+        edges.push({ type: "wikilink", from: notePath, to: target });
+    }
+    const validation = concept
+        ? validateFrontmatter(parsed.frontmatter, concept)
+        : { valid: false, violations: [] };
+    const searchText = `${Object.values(parsed.frontmatter).flatMap(valueToStrings).join(" ")} ${parsed.body}`;
+    return {
+        note: {
+            path: notePath,
+            folder,
+            concept: concept?.concept ?? null,
+            frontmatter: parsed.frontmatter,
+            axes,
+            wikilinks,
+            bodyLoaded: false,
+            validation: {
+                valid: validation.valid,
+                violations: validation.violations.length,
+            },
+        },
+        edges,
+        search: {
+            path: notePath,
+            terms: tokenize(searchText),
+            bodyPreview: parsed.body.trim().slice(0, 240),
+        },
+    };
+}
+export async function buildGraphCache(opts) {
+    const vault = path.resolve(opts.vault);
+    const notes = [];
+    const edges = [];
+    const search = [];
+    for await (const notePath of walkMarkdown(vault, vault)) {
+        const raw = await readFile(path.join(vault, notePath), "utf-8");
+        const built = buildNoteGraph(notePath, raw, opts.ontology);
+        notes.push(built.note);
+        edges.push(...built.edges);
+        search.push(built.search);
+    }
+    const cache = {
+        version: CACHE_VERSION,
+        generatedAt: new Date().toISOString(),
+        sourceOfTruth: ["markdown notes", ".oms/taxonomy.yaml", ".oms/concepts/*.yaml"],
+        signatures: await buildSourceSignatures(vault, opts.ontology),
+        notes: notes.sort((a, b) => a.path.localeCompare(b.path)),
+        edges: edges.sort((a, b) => `${a.type}:${a.from}:${a.to}`.localeCompare(`${b.type}:${b.from}:${b.to}`)),
+        search: search.sort((a, b) => a.path.localeCompare(b.path)),
+    };
+    if (opts.write) {
+        const outPath = graphCachePath(vault);
+        await mkdir(path.dirname(outPath), { recursive: true });
+        await writeFile(outPath, `${JSON.stringify(cache, null, 2)}\n`, "utf-8");
+    }
+    return cache;
+}
+export async function readGraphCache(vault) {
+    try {
+        const raw = await readFile(graphCachePath(vault), "utf-8");
+        const parsed = JSON.parse(raw);
+        return parsed.version === CACHE_VERSION ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function compareSignatures(previous, current) {
+    const reasons = [];
+    let schemaStale = false;
+    let graphStale = false;
+    let searchStale = false;
+    let validationStale = false;
+    if (previous.taxonomyHash !== current.taxonomyHash) {
+        schemaStale = true;
+        graphStale = true;
+        validationStale = true;
+        reasons.push("taxonomy changed: folder-concept edges and validation plan are stale");
+    }
+    const conceptNames = new Set([...Object.keys(previous.conceptHashes), ...Object.keys(current.conceptHashes)]);
+    for (const name of conceptNames) {
+        if (previous.conceptHashes[name] !== current.conceptHashes[name]) {
+            schemaStale = true;
+            graphStale = true;
+            validationStale = true;
+            reasons.push(`concept schema changed: ${name}`);
+        }
+    }
+    const notePaths = new Set([...Object.keys(previous.notes), ...Object.keys(current.notes)]);
+    for (const notePath of notePaths) {
+        const before = previous.notes[notePath];
+        const after = current.notes[notePath];
+        if (!before || !after) {
+            graphStale = true;
+            searchStale = true;
+            validationStale = true;
+            reasons.push(`note added/deleted: ${notePath}`);
+            continue;
+        }
+        if (before.frontmatterHash !== after.frontmatterHash) {
+            graphStale = true;
+            searchStale = true;
+            validationStale = true;
+            reasons.push(`frontmatter/search axes changed: ${notePath}`);
+        }
+        if (before.wikilinkHash !== after.wikilinkHash) {
+            graphStale = true;
+            reasons.push(`wikilinks changed: ${notePath}`);
+        }
+        if (before.bodyTextHash !== after.bodyTextHash) {
+            searchStale = true;
+            reasons.push(`body/search text changed: ${notePath}`);
+        }
+    }
+    return {
+        schemaStale,
+        graphStale,
+        searchStale,
+        embeddingStale: "not-configured",
+        validationStale,
+        reasons,
+    };
+}
+export async function graphCacheStatus(vault, ontology) {
+    const cache = await readGraphCache(vault);
+    const cachePath = graphCachePath(vault);
+    if (!cache) {
+        return {
+            cachePath,
+            exists: false,
+            generatedAt: null,
+            notes: 0,
+            edges: 0,
+            searchDocuments: 0,
+            staleness: {
+                schemaStale: true,
+                graphStale: true,
+                searchStale: true,
+                embeddingStale: "not-configured",
+                validationStale: true,
+                reasons: ["graph cache has not been built"],
+            },
+        };
+    }
+    return {
+        cachePath,
+        exists: true,
+        generatedAt: cache.generatedAt,
+        notes: cache.notes.length,
+        edges: cache.edges.length,
+        searchDocuments: cache.search.length,
+        staleness: compareSignatures(cache.signatures, await buildSourceSignatures(vault, ontology)),
+    };
+}
+function matchesAxis(note, opts) {
+    if (opts.concept && note.concept !== opts.concept)
+        return false;
+    if (opts.folder && note.folder !== opts.folder)
+        return false;
+    if (opts.wikilink && !note.wikilinks.includes(opts.wikilink))
+        return false;
+    if (opts.property) {
+        const values = note.axes[opts.property] ?? [];
+        if (opts.value && !values.includes(opts.value))
+            return false;
+        if (!opts.value && values.length === 0)
+            return false;
+    }
+    return true;
+}
+function searchScore(search, query) {
+    if (!query || !search)
+        return 0;
+    const queryTerms = tokenize(query);
+    return queryTerms.filter((term) => search.terms.includes(term)).length;
+}
+export async function retrieveByAxis(opts) {
+    const cache = (await readGraphCache(opts.vault)) ?? (await buildGraphCache({ ...opts, write: false }));
+    const searchByPath = new Map(cache.search.map((item) => [item.path, item]));
+    const limit = Math.max(1, Math.min(opts.limit ?? 10, 50));
+    return cache.notes
+        .filter((note) => matchesAxis(note, opts))
+        .map((note) => {
+        const search = searchByPath.get(note.path);
+        return {
+            path: note.path,
+            concept: note.concept,
+            folder: note.folder,
+            axes: note.axes,
+            wikilinks: note.wikilinks,
+            score: searchScore(search, opts.query),
+            bodyPreview: search?.bodyPreview ?? "",
+        };
+    })
+        .sort((a, b) => b.score - a.score || a.path.localeCompare(b.path))
+        .slice(0, limit);
+}
+export async function lazyLoadNoteBody(vault, notePath) {
+    const resolved = safeVaultNotePath(vault, notePath);
+    const relative = path.relative(vault, resolved);
+    const raw = await readFile(resolved, "utf-8");
+    return { path: relative.replace(/\\/g, "/"), body: parseNote(raw).body };
+}
+//# sourceMappingURL=cache.js.map

package/dist/graph/cache.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./ontology/types.js";
+export * from "./ontology/loader.js";
+export * from "./ontology/resolver.js";
+export * from "./conventions/frontmatter.js";
+export * from "./conventions/validate.js";
+export * from "./adapt/HostAdapter.js";
+export * from "./mcp/server.js";

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./ontology/types.js";
+export * from "./ontology/loader.js";
+export * from "./ontology/resolver.js";
+export * from "./conventions/frontmatter.js";
+export * from "./conventions/validate.js";
+export * from "./adapt/HostAdapter.js";
+export * from "./mcp/server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC"}

package/dist/install/hosts.d.ts

@@ -0,0 +1,27 @@
+export type HostRuntime = "claude" | "codex" | "hermes";
+export type RuntimeSelection = HostRuntime | "auto" | "all";
+export type HostAction = "install" | "uninstall";
+export interface HostOperationOptions {
+    action: HostAction;
+    runtime: RuntimeSelection;
+    vault: string;
+    packageSpec?: string;
+    dryRun?: boolean;
+    executeExternal?: boolean;
+    yes?: boolean;
+    homeDir?: string;
+    adapterRoot: string;
+}
+export interface HostOperationResult {
+    runtime: HostRuntime;
+    action: HostAction;
+    changed: boolean;
+    skipped: boolean;
+    paths: string[];
+    commands: string[];
+    messages: string[];
+}
+export declare function detectAvailableHosts(): HostRuntime[];
+export declare function resolveRuntimeSelection(selection: RuntimeSelection): HostRuntime[];
+export declare function runHostOperation(options: HostOperationOptions): Promise<HostOperationResult[]>;
+export declare function formatHostOperationResults(results: HostOperationResult[], dryRun: boolean): string;