oh-my-second-brain 0.3.0 → 0.6.2

package/dist/kernel/contracts/index.js

@@ -0,0 +1,401 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+const AXIS_KINDS = ["folder", "field", "link"];
+const VALUE_TYPES = [
+    "text",
+    "string",
+    "select",
+    "number",
+    "boolean",
+    "checkbox",
+    "date",
+    "datetime",
+    "list",
+    "multitext",
+    "multi",
+    "tags",
+    "aliases",
+    "file",
+];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function fail(message) {
+    throw new Error(`Invalid frontmatter contract: ${message}`);
+}
+function asAxisKind(value, where) {
+    if (typeof value === "string" && AXIS_KINDS.includes(value)) {
+        return value;
+    }
+    fail(`${where}.kind must be one of folder, field, or link.`);
+}
+function asValueType(value, where) {
+    if (isRecord(value) && value["type"] !== undefined)
+        return asValueType(value["type"], `${where}.type`);
+    if (typeof value === "string" && VALUE_TYPES.includes(value)) {
+        return value;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        const aliases = {
+            text: "text",
+            input: "text",
+            string: "string",
+            select: "select",
+            number: "number",
+            boolean: "boolean",
+            checkbox: "checkbox",
+            date: "date",
+            datetime: "datetime",
+            list: "list",
+            multi: "multi",
+            multitext: "multitext",
+            tags: "tags",
+            aliases: "aliases",
+            file: "file",
+        };
+        const alias = aliases[normalized];
+        if (alias !== undefined)
+            return alias;
+    }
+    fail(`${where}.type must be a supported Obsidian property type.`);
+}
+function asString(value, where) {
+    if (typeof value !== "string" || value.trim().length === 0)
+        fail(`${where} must be a non-empty string.`);
+    return value.trim();
+}
+function asAllowedValues(value, where) {
+    if (!Array.isArray(value))
+        fail(`${where} must be an array.`);
+    return value.map((item, index) => {
+        if (typeof item === "string")
+            return asString(item, `${where}[${index}]`);
+        if (!isRecord(item))
+            fail(`${where}[${index}] must be a string or object.`);
+        const extras = Object.fromEntries(Object.entries(item).filter(([key]) => key !== "value" && key !== "intent"));
+        const intent = item["intent"] === undefined ? undefined : asString(item["intent"], `${where}[${index}].intent`);
+        const allowed = {
+            ...extras,
+            value: asString(item["value"], `${where}[${index}].value`),
+            ...(intent === undefined ? {} : { intent }),
+        };
+        return allowed;
+    });
+}
+function parseAxis(value, where, impliedKind, impliedKey) {
+    if (!isRecord(value))
+        fail(`${where} must be an object.`);
+    const kind = asAxisKind(value["kind"] ?? impliedKind, where);
+    const key = asString(value["key"] ?? impliedKey, `${where}.key`);
+    const type = asValueType(value["type"], where);
+    const intent = value["intent"] === undefined ? undefined : asString(value["intent"], `${where}.intent`);
+    const required = value["required"] === undefined ? undefined : value["required"];
+    if (required !== undefined && typeof required !== "boolean")
+        fail(`${where}.required must be boolean.`);
+    const normalize = value["normalize"];
+    if (normalize !== undefined && normalize !== "lower" && normalize !== "trim" && normalize !== "kebab") {
+        fail(`${where}.normalize must be lower, trim, or kebab.`);
+    }
+    const allowedValues = value["allowedValues"] === undefined
+        ? undefined
+        : asAllowedValues(value["allowedValues"], `${where}.allowedValues`);
+    const extras = Object.fromEntries(Object.entries(value).filter(([key]) => !["kind", "key", "type", "intent", "required", "normalize", "allowedValues"].includes(key)));
+    return {
+        ...extras,
+        kind,
+        key,
+        type,
+        ...(intent === undefined ? {} : { intent }),
+        ...(required === undefined ? {} : { required }),
+        ...(normalize === undefined ? {} : { normalize }),
+        ...(allowedValues === undefined ? {} : { allowedValues }),
+    };
+}
+/**
+ * Parse the two contract shapes emitted by setup: the canonical axis array and
+ * the convenient `{ folder: {...}, field: {...} }` grouping form. Both become
+ * one deterministic in-memory representation.
+ */
+function parseAxes(value) {
+    if (Array.isArray(value))
+        return value.map((axis, index) => parseAxis(axis, `axes[${index}]`));
+    if (!isRecord(value))
+        fail("axes must be an array or object.");
+    const axes = [];
+    for (const [kindKey, group] of Object.entries(value)) {
+        if (!AXIS_KINDS.includes(kindKey))
+            fail(`axes.${kindKey} is not a supported axis kind.`);
+        const kind = kindKey;
+        if (Array.isArray(group)) {
+            group.forEach((axis, index) => axes.push(parseAxis(axis, `axes.${kind}[${index}]`, kind)));
+            continue;
+        }
+        if (!isRecord(group))
+            fail(`axes.${kind} must be an object or array.`);
+        if (group["type"] !== undefined || group["key"] !== undefined || group["kind"] !== undefined) {
+            axes.push(parseAxis(group, `axes.${kind}`, kind));
+            continue;
+        }
+        for (const [key, descriptor] of Object.entries(group)) {
+            axes.push(parseAxis(descriptor, `axes.${kind}.${key}`, kind, key));
+        }
+    }
+    return axes;
+}
+function parseTypeMap(value, where) {
+    if (!isRecord(value))
+        fail(`${where} must be an object.`);
+    const types = {};
+    for (const [key, type] of Object.entries(value)) {
+        types[asString(key, `${where} key`)] = asValueType(type, `${where}.${key}`);
+    }
+    return types;
+}
+function parseAllowedValues(value) {
+    if (!isRecord(value))
+        fail("allowedValues must be an object.");
+    const allowedValues = {};
+    for (const [key, values] of Object.entries(value)) {
+        allowedValues[asString(key, "allowedValues key")] = asAllowedValues(values, `allowedValues.${key}`);
+    }
+    return allowedValues;
+}
+function validateUniqueAxes(axes) {
+    const seen = new Set();
+    for (const axis of axes) {
+        const identity = `${axis.kind}:${axis.key.toLowerCase()}`;
+        if (seen.has(identity))
+            fail(`duplicate axis ${axis.kind}:${axis.key}.`);
+        seen.add(identity);
+    }
+}
+/** Parse and validate a JSON contract. Malformed contracts always throw. */
+export function parseContract(input) {
+    let value;
+    if (typeof input === "string") {
+        try {
+            value = JSON.parse(input);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "invalid JSON";
+            fail(`JSON parse failed (${message}).`);
+        }
+    }
+    else {
+        value = input;
+    }
+    if (!isRecord(value))
+        fail("root must be an object.");
+    const version = value["version"];
+    if (typeof version !== "number" || !Number.isInteger(version) || version < 1) {
+        fail("version must be a positive integer.");
+    }
+    const intent = value["intent"] === undefined ? undefined : asString(value["intent"], "intent");
+    const axes = parseAxes(value["axes"]);
+    const types = parseTypeMap(value["types"], "types");
+    const allowedValues = parseAllowedValues(value["allowedValues"]);
+    validateUniqueAxes(axes);
+    // Axis-local declarations are copied into the top-level indexes so callers
+    // have one lookup path. Conflicting declarations are contract errors.
+    for (const axis of axes) {
+        const priorType = types[axis.key];
+        if (priorType !== undefined && priorType !== axis.type)
+            fail(`types.${axis.key} conflicts with axis type.`);
+        if (axis.allowedValues !== undefined) {
+            const priorValues = allowedValues[axis.key];
+            if (priorValues !== undefined && JSON.stringify(priorValues) !== JSON.stringify(axis.allowedValues)) {
+                fail(`allowedValues.${axis.key} conflicts with axis declaration.`);
+            }
+            if (priorValues === undefined)
+                allowedValues[axis.key] = [...axis.allowedValues];
+        }
+        if (priorType === undefined)
+            types[axis.key] = axis.type;
+    }
+    const extras = Object.fromEntries(Object.entries(value).filter(([key]) => !["version", "intent", "axes", "types", "allowedValues"].includes(key)));
+    return {
+        ...extras,
+        version,
+        ...(intent === undefined ? {} : { intent }),
+        axes,
+        types,
+        allowedValues,
+    };
+}
+/** Canonical stable JSON representation (two-space indent, trailing newline). */
+export function serializeContract(contract) {
+    const parsed = parseContract(contract);
+    const axes = [...parsed.axes]
+        .sort((left, right) => left.kind.localeCompare(right.kind) || left.key.localeCompare(right.key))
+        .map((axis) => {
+        const extras = Object.fromEntries(Object.entries(axis)
+            .filter(([key]) => !["kind", "key", "type", "required", "normalize", "allowedValues", "intent"].includes(key))
+            .sort(([left], [right]) => left.localeCompare(right)));
+        return {
+            kind: axis.kind,
+            key: axis.key,
+            type: axis.type,
+            ...(axis.required === undefined ? {} : { required: axis.required }),
+            ...(axis.normalize === undefined ? {} : { normalize: axis.normalize }),
+            ...(axis.allowedValues === undefined ? {} : { allowedValues: [...axis.allowedValues] }),
+            ...(axis.intent === undefined ? {} : { intent: axis.intent }),
+            ...extras,
+        };
+    });
+    const types = Object.fromEntries(Object.entries(parsed.types).sort(([left], [right]) => left.localeCompare(right)));
+    const allowedValues = Object.fromEntries(Object.entries(parsed.allowedValues)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, values]) => [key, [...values]]));
+    const extras = Object.fromEntries(Object.entries(parsed)
+        .filter(([key]) => !["version", "intent", "axes", "types", "allowedValues"].includes(key))
+        .sort(([left], [right]) => left.localeCompare(right)));
+    return `${JSON.stringify({
+        version: parsed.version,
+        ...(parsed.intent === undefined ? {} : { intent: parsed.intent }),
+        axes,
+        types,
+        allowedValues,
+        ...extras,
+    }, null, 2)}\n`;
+}
+export const CONTRACT_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    type: "object",
+    additionalProperties: true,
+    required: ["version", "axes", "types", "allowedValues"],
+    properties: {
+        version: { type: "integer", minimum: 1 },
+        intent: { type: "string", minLength: 1 },
+        axes: {
+            type: "array",
+            items: {
+                type: "object",
+                additionalProperties: true,
+                required: ["kind", "key", "type"],
+                properties: {
+                    kind: { enum: ["folder", "field", "link"] },
+                    key: { type: "string", minLength: 1 },
+                    type: { enum: VALUE_TYPES },
+                    intent: { type: "string", minLength: 1 },
+                    required: { type: "boolean" },
+                    normalize: { enum: ["lower", "trim", "kebab"] },
+                    allowedValues: {
+                        type: "array",
+                        items: {
+                            oneOf: [
+                                { type: "string" },
+                                {
+                                    type: "object",
+                                    additionalProperties: true,
+                                    required: ["value"],
+                                    properties: { value: { type: "string", minLength: 1 }, intent: { type: "string", minLength: 1 } },
+                                },
+                            ],
+                        },
+                    },
+                },
+            },
+        },
+        types: { type: "object", additionalProperties: { enum: VALUE_TYPES } },
+        allowedValues: {
+            type: "object",
+            additionalProperties: {
+                type: "array",
+                items: {
+                    oneOf: [
+                        { type: "string" },
+                        {
+                            type: "object",
+                            additionalProperties: true,
+                            required: ["value"],
+                            properties: { value: { type: "string", minLength: 1 }, intent: { type: "string", minLength: 1 } },
+                        },
+                    ],
+                },
+            },
+        },
+    },
+};
+function omsTypesPath(input) {
+    if (path.basename(input) === "types.json")
+        return input;
+    if (path.basename(input) === ".oms")
+        return path.join(input, "types.json");
+    return path.join(input, ".oms", "types.json");
+}
+function obsidianTypesPath(input) {
+    if (path.basename(input) === "types.json" && path.basename(path.dirname(input)) === ".obsidian")
+        return input;
+    if (path.basename(input) === "types.json" && path.basename(path.dirname(input)) === ".oms") {
+        return path.join(path.dirname(path.dirname(input)), ".obsidian", "types.json");
+    }
+    if (path.basename(input) === ".obsidian")
+        return path.join(input, "types.json");
+    return path.join(input, ".obsidian", "types.json");
+}
+/** Read the tracked JSON contract. Legacy YAML files are deliberately ignored. */
+export async function loadContract(input, options = {}) {
+    let raw;
+    try {
+        raw = await readFile(omsTypesPath(input), "utf-8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+    const contract = parseContract(raw);
+    if (options.obsidianTypes === false)
+        return contract;
+    const authority = await loadObsidianTypes(input);
+    if (authority === null)
+        return contract;
+    const types = { ...contract.types, ...authority.types };
+    const axes = contract.axes.map((axis) => ({ ...axis, type: types[axis.key] ?? axis.type }));
+    return { ...contract, axes, types };
+}
+/** Read `.obsidian/types.json` through one adapter; this function never writes. */
+export async function loadObsidianTypes(input) {
+    let raw;
+    const source = obsidianTypesPath(input);
+    try {
+        raw = await readFile(source, "utf-8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "invalid JSON";
+        throw new Error(`Invalid Obsidian types authority: JSON parse failed (${message}).`);
+    }
+    if (!isRecord(parsed))
+        throw new Error("Invalid Obsidian types authority: root must be an object.");
+    const candidate = parsed["types"] ?? parsed;
+    const types = {};
+    if (Array.isArray(candidate)) {
+        candidate.forEach((entry, index) => {
+            if (!isRecord(entry))
+                throw new Error(`Invalid Obsidian types authority: types[${index}] must be an object.`);
+            const name = asString(entry["name"] ?? entry["key"], `types[${index}].name`);
+            types[name] = asValueType(entry["type"], `types[${index}]`);
+        });
+    }
+    else {
+        Object.assign(types, parseTypeMap(candidate, "types"));
+    }
+    return { types, source };
+}
+/** Persist a validated contract to `.oms/types.json`; no YAML is migrated. */
+export async function writeContract(input, contract) {
+    const target = omsTypesPath(input);
+    await mkdir(path.dirname(target), { recursive: true });
+    await writeFile(target, serializeContract(contract), "utf-8");
+}
+//# sourceMappingURL=index.js.map

package/dist/kernel/contracts/index.js.map

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

package/dist/kernel/conventions/note-exclude.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Default audit exemptions - build artifacts, self-documenting templates, and
+ * skill files that intentionally carry no frontmatter. This is the single
+ * declaration; ../engine/conventions/vault-lint.ts re-exports it so its
+ * existing importers are unaffected.
+ */
+export declare const DEFAULT_EXCLUDE_GLOBS: readonly string[];
+/** True when `notePath` matches at least one of `globs`. */
+export declare function matchesAnyGlob(notePath: string, globs: readonly string[]): boolean;
+/**
+ * Predicate over vault-relative, forward-slashed note paths.
+ * Resolved once per vault root and reused by every walker level.
+ */
+export declare function excludedNoteMatcher(vaultRoot: string): Promise<(notePath: string) => boolean>;

package/dist/kernel/conventions/note-exclude.js

@@ -0,0 +1,95 @@
+/**
+ * Vault-declared note exclusions for the scanning walkers.
+ *
+ * `taxonomy.yaml: exclude` names markdown files that are not notes - template
+ * sources whose pre-substitution frontmatter is intentionally not valid YAML
+ * (Templater tags, agent {{var}} placeholders), build staging, skill files.
+ * The vault-lint lane already honours it via `resolveExcludeGlobs` in
+ * ../engine/conventions/vault-lint.ts, but the walkers that feed retrieval
+ * (the engine graph builder, the EAV axis scan, the graph cache) never saw
+ * it and threw on the first excluded note, aborting the whole vault scan.
+ *
+ * This module gives those walkers the same exclusion policy without
+ * requiring a full Ontology load (two of the three call sites intentionally
+ * do not load one): it reads <vaultRoot>/.oms/taxonomy.yaml directly and
+ * degrades to the built-in defaults when the file is missing or malformed.
+ */
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * Default audit exemptions - build artifacts, self-documenting templates, and
+ * skill files that intentionally carry no frontmatter. This is the single
+ * declaration; ../engine/conventions/vault-lint.ts re-exports it so its
+ * existing importers are unaffected.
+ */
+export const DEFAULT_EXCLUDE_GLOBS = [
+    "25. Digital Garden/.deploy-staging/**",
+    "**/*.template.md",
+    "**/SKILL.md",
+    ".obsidian/**",
+    ".trash/**",
+    ".oms/**",
+    "_attachments/**",
+];
+/**
+ * Convert a `*`/`**` glob into an anchored RegExp. `**` matches across `/`,
+ * `*` does not.
+ *
+ * GLOBSTAR must be a placeholder character that (a) cannot appear in a glob
+ * and (b) survives the escaping step below untouched. The NUL character
+ * (written here as the escape sequence "\u0000") satisfies both. A printable
+ * stand-in typed as the literal four-character escape sequence would not
+ * survive: the escaping regex would itself escape its backslash, and the
+ * later split on the placeholder would never match again - silently
+ * disabling all "**" handling.
+ */
+function globToRegExp(glob) {
+    const GLOBSTAR = "\u0000";
+    const withPlaceholder = glob.replace(/\*\*/g, GLOBSTAR);
+    const escaped = withPlaceholder.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    const withStar = escaped.replace(/\*/g, "[^/]*");
+    const pattern = withStar.split(GLOBSTAR).join(".*");
+    return new RegExp(`^${pattern}$`);
+}
+/** True when `notePath` matches at least one of `globs`. */
+export function matchesAnyGlob(notePath, globs) {
+    return globs.some((glob) => globToRegExp(glob).test(notePath));
+}
+/** One resolve per vault root per process; every walker level shares it. */
+const matcherCache = new Map();
+async function loadExcludeMatchers(vaultRoot) {
+    const key = path.resolve(vaultRoot);
+    let pending = matcherCache.get(key);
+    if (pending === undefined) {
+        pending = (async () => {
+            let declared = [];
+            try {
+                const raw = await readFile(path.join(key, ".oms", "taxonomy.yaml"), "utf-8");
+                const parsed = parseYaml(raw);
+                const rawExclude = parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+                    ? parsed["exclude"]
+                    : undefined;
+                if (Array.isArray(rawExclude) && rawExclude.every((item) => typeof item === "string")) {
+                    declared = rawExclude;
+                }
+            }
+            catch {
+                // A vault with no (or an unparsable) taxonomy.yaml still gets the
+                // built-in defaults - a missing exclude declaration is not fatal.
+            }
+            return [...DEFAULT_EXCLUDE_GLOBS, ...declared].map(globToRegExp);
+        })();
+        matcherCache.set(key, pending);
+    }
+    return pending;
+}
+/**
+ * Predicate over vault-relative, forward-slashed note paths.
+ * Resolved once per vault root and reused by every walker level.
+ */
+export async function excludedNoteMatcher(vaultRoot) {
+    const matchers = await loadExcludeMatchers(vaultRoot);
+    return (notePath) => matchers.some((pattern) => pattern.test(notePath));
+}
+//# sourceMappingURL=note-exclude.js.map

package/dist/kernel/conventions/note-exclude.js.map

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

package/dist/kernel/engine/assemble.d.ts

@@ -9,8 +9,9 @@
  * - 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";
@@ -22,10 +23,28 @@ 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;
     /**
@@ -59,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.