oh-my-second-brain 0.3.0 → 0.6.2

package/dist/kernel/engine/graph/node.d.ts

@@ -22,7 +22,12 @@ export interface EngineGraphNode {
     concept: string | null;
     /** First path segment (folder group) — mirrors builder.ts noteType(). */
     folder: string;
-    /** Every frontmatter field coerced to a flat string array. */
+    /** Every frontmatter field coerced to a flat, typed scalar array. */
+    /**
+     * Typed scalar arrays at runtime. The declared string-array shape is retained
+     * for graph renderers; query code reads the values through `fieldValues` so
+     * number/boolean values are not coerced or discarded.
+     */
     axes: Record<string, string[]>;
     /** Resolved vault-relative docPaths this note links out to via [[…]]. */
     wikilinks: string[];
@@ -54,6 +59,49 @@ export interface NodeAxisFilters {
     value?: string;
     wikilink?: string;
 }
+/** Scalar value accepted by a public folder/field/link axis predicate. */
+export type AxisScalar = string | number | boolean;
+/** Flatten frontmatter values without erasing number/boolean semantics. */
+export declare function toAxisScalars(value: unknown): AxisScalar[];
+/** Optional typed field predicates used by date-range and multi-value tests. */
+export interface AxisFieldPredicate {
+    readonly contains?: AxisScalar | readonly AxisScalar[];
+    readonly containsAll?: readonly AxisScalar[];
+    readonly in?: readonly AxisScalar[];
+    readonly between?: readonly [AxisScalar, AxisScalar];
+    readonly gte?: AxisScalar;
+    readonly gt?: AxisScalar;
+    readonly lte?: AxisScalar;
+    readonly lt?: AxisScalar;
+    readonly from?: AxisScalar;
+    readonly to?: AxisScalar;
+}
+/**
+ * Public query axes. Values in one axis are OR'ed; distinct field keys and
+ * the folder/field/link axes are AND'ed. `field` is a map so a caller can
+ * express e.g. `{ status: ["open", "blocked"], team: "platform" }`.
+ */
+export interface QueryAxes {
+    folder?: AxisScalar | readonly AxisScalar[];
+    field?: Readonly<Record<string, AxisScalar | readonly AxisScalar[] | AxisFieldPredicate>>;
+    link?: AxisScalar | readonly AxisScalar[];
+}
+/**
+ * Validate and apply the public axis predicate algebra.
+ *
+ * This is intentionally separate from `filterNodesByAxis`: the latter is the
+ * legacy graph operation and still accepts its old singular property shape.
+ * Unknown public axes fail loudly instead of silently broadening a query.
+ */
+export declare function filterNodesByQueryAxes(nodes: readonly EngineGraphNode[], axes: QueryAxes): EngineGraphNode[];
+export interface QueryFacet {
+    readonly axis: "folder" | "field" | "link";
+    readonly value: string;
+    readonly count: number;
+    readonly key?: string;
+}
+/** Count axis values over the already-filtered candidate set. */
+export declare function queryFacets(nodes: readonly EngineGraphNode[]): QueryFacet[];
 /**
  * Return the nodes that satisfy every supplied axis filter (AND-intersection).
  *

package/dist/kernel/engine/graph/node.js

@@ -48,6 +48,211 @@ export function wikilinkStemMatch(link, target) {
     };
     return stem(link) === stem(target);
 }
+/** Flatten frontmatter values without erasing number/boolean semantics. */
+export function toAxisScalars(value) {
+    if (Array.isArray(value))
+        return value.flatMap(toAxisScalars);
+    if (typeof value === "string")
+        return value.trim().length > 0 ? [value.trim()] : [];
+    if (typeof value === "number")
+        return Number.isFinite(value) ? [value] : [];
+    if (typeof value === "boolean")
+        return [value];
+    // YAML timestamp values can be Date instances. ISO strings retain date
+    // ordering for the typed range comparator while keeping the node cache JSON
+    // serialisable.
+    if (value instanceof Date && !Number.isNaN(value.getTime()))
+        return [value.toISOString()];
+    return [];
+}
+const PUBLIC_AXIS_NAMES = new Set(["folder", "field", "link"]);
+function axisValues(value, axis) {
+    const values = value === undefined ? [] : Array.isArray(value) ? [...value] : [value];
+    if (!values.every((item) => typeof item === "string"
+        || typeof item === "boolean"
+        || (typeof item === "number" && Number.isFinite(item)))) {
+        throw new Error(`Axis "${axis}" values must be finite numbers, strings, or booleans.`);
+    }
+    return values
+        .map((item) => typeof item === "string" ? item.trim() : item)
+        .filter((item) => typeof item !== "string" || item.length > 0);
+}
+function fieldPredicate(value, key) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { equals: axisValues(value, `field.${key}`), contains: [], containsAll: [], range: {} };
+    }
+    const known = new Set(["contains", "containsAll", "in", "between", "gte", "gt", "lte", "lt", "from", "to"]);
+    for (const operator of Object.keys(value)) {
+        if (!known.has(operator))
+            throw new Error(`Unknown field predicate "${operator}" for "${key}".`);
+    }
+    const predicate = value;
+    return {
+        equals: axisValues(predicate.in, `field.${key}.in`),
+        contains: axisValues(predicate.contains, `field.${key}.contains`),
+        containsAll: axisValues(predicate.containsAll, `field.${key}.containsAll`),
+        range: predicate,
+    };
+}
+function fieldValues(node, key) {
+    const values = node.axes[key]
+        ?? Object.entries(node.axes).find(([candidate]) => candidate.toLowerCase() === key.toLowerCase())?.[1]
+        ?? [];
+    return values;
+}
+function comparable(value) {
+    if (typeof value === "number")
+        return { kind: "number", value };
+    if (typeof value === "boolean")
+        return { kind: "boolean", value };
+    const text = value.trim().toLocaleLowerCase();
+    // YAML dates are represented as strings by the node snapshot. Keep their
+    // date semantics for range predicates without coercing ordinary strings.
+    if (/^\d{4}-\d{2}-\d{2}(?:t.*)?$/u.test(text)) {
+        const timestamp = Date.parse(text);
+        if (!Number.isNaN(timestamp))
+            return { kind: "date", value: timestamp };
+    }
+    return { kind: "string", value: text };
+}
+function equalValue(left, right) {
+    const a = comparable(left);
+    const b = comparable(right);
+    return a.kind === b.kind && Object.is(a.value, b.value);
+}
+function compareValue(left, right) {
+    const a = comparable(left);
+    const b = comparable(right);
+    if (a.kind !== b.kind)
+        throw new Error("Typed axis comparison requires values of the same type.");
+    if (typeof a.value === "number" && typeof b.value === "number")
+        return a.value - b.value;
+    if (typeof a.value === "string" && typeof b.value === "string")
+        return a.value.localeCompare(b.value);
+    return a.value === b.value ? 0 : a.value ? 1 : -1;
+}
+function valueMatches(values, expected) {
+    return expected.some((item) => values.some((value) => equalValue(value, item)));
+}
+/**
+ * Validate and apply the public axis predicate algebra.
+ *
+ * This is intentionally separate from `filterNodesByAxis`: the latter is the
+ * legacy graph operation and still accepts its old singular property shape.
+ * Unknown public axes fail loudly instead of silently broadening a query.
+ */
+export function filterNodesByQueryAxes(nodes, axes) {
+    if (axes === null || typeof axes !== "object" || Array.isArray(axes)) {
+        throw new Error("Query axes must be an object.");
+    }
+    for (const key of Object.keys(axes)) {
+        if (!PUBLIC_AXIS_NAMES.has(key))
+            throw new Error(`Unknown query axis "${key}". Expected folder, field, or link.`);
+    }
+    const folder = axisValues(axes.folder, "folder");
+    const link = axisValues(axes.link, "link");
+    if (axes.field !== undefined && (axes.field === null || typeof axes.field !== "object" || Array.isArray(axes.field))) {
+        throw new Error('Field axis must be an object mapping field names to values.');
+    }
+    const fields = Object.entries(axes.field ?? {}).map(([key, value]) => {
+        if (!key.trim())
+            throw new Error("Axis field names must not be empty.");
+        if (key.trim().toLocaleLowerCase() === "concept") {
+            throw new Error('Unknown query field axis "concept".');
+        }
+        return [key, fieldPredicate(value, key)];
+    });
+    return nodes.filter((node) => {
+        // Values in one axis are OR'ed.
+        if (folder.length > 0 && !valueMatches([node.folder], folder))
+            return false;
+        if (link.length > 0) {
+            const links = node.wikilinks.flatMap((target) => {
+                const stem = target.toLocaleLowerCase().replace(/\.md$/u, "");
+                const slash = stem.lastIndexOf("/");
+                return [slash >= 0 ? stem.slice(slash + 1) : stem];
+            });
+            if (!link.some((target) => {
+                if (typeof target !== "string")
+                    return false;
+                const stem = target.toLocaleLowerCase().replace(/\.md$/u, "");
+                const slash = stem.lastIndexOf("/");
+                return links.includes(slash >= 0 ? stem.slice(slash + 1) : stem);
+            }))
+                return false;
+        }
+        // Different field keys are AND'ed; values for one key are OR'ed.
+        for (const [key, predicate] of fields) {
+            const values = fieldValues(node, key);
+            if (predicate.equals.length > 0 && !valueMatches(values, predicate.equals))
+                return false;
+            if (predicate.contains.length > 0 && !valueMatches(values, predicate.contains))
+                return false;
+            if (predicate.containsAll.length > 0 && !predicate.containsAll.every((item) => values.some((value) => equalValue(value, item))))
+                return false;
+            const range = predicate.range;
+            const lower = range.gte ?? range.gt ?? range.from;
+            const upper = range.lte ?? range.lt ?? range.to;
+            const between = range.between;
+            if (between !== undefined && (!Array.isArray(between) || between.length !== 2)) {
+                throw new Error(`Field predicate "between" for "${key}" requires two values.`);
+            }
+            if (lower !== undefined || upper !== undefined) {
+                const matchesRange = values.some((actual) => ((lower === undefined || (range.gt !== undefined ? compareValue(actual, lower) > 0 : compareValue(actual, lower) >= 0))
+                    && (upper === undefined || (range.lt !== undefined ? compareValue(actual, upper) < 0 : compareValue(actual, upper) <= 0))));
+                if (!matchesRange)
+                    return false;
+            }
+            if (between !== undefined) {
+                if (!values.some((actual) => compareValue(actual, between[0]) >= 0 && compareValue(actual, between[1]) <= 0))
+                    return false;
+            }
+            if (predicate.equals.length === 0
+                && predicate.contains.length === 0
+                && predicate.containsAll.length === 0
+                && lower === undefined
+                && upper === undefined
+                && between === undefined) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+/** Count axis values over the already-filtered candidate set. */
+export function queryFacets(nodes) {
+    const counts = new Map();
+    const add = (axis, value, key) => {
+        const normalized = value.trim();
+        if (!normalized)
+            return;
+        const identity = `${axis}\u0000${key?.toLocaleLowerCase() ?? ""}\u0000${normalized.toLocaleLowerCase()}`;
+        const existing = counts.get(identity);
+        if (existing) {
+            existing.count++;
+        }
+        else {
+            counts.set(identity, { axis, value: normalized, ...(key !== undefined ? { key } : {}), count: 1 });
+        }
+    };
+    for (const node of nodes) {
+        add("folder", node.folder);
+        for (const [key, values] of Object.entries(node.axes)) {
+            // Concept remains an internal graph binding, not a public query axis.
+            if (key === "concept")
+                continue;
+            for (const value of new Set(values))
+                add("field", String(value), key);
+        }
+        for (const target of new Set(node.wikilinks))
+            add("link", target);
+    }
+    return [...counts.values()]
+        .sort((left, right) => left.axis.localeCompare(right.axis)
+        || (left.key ?? "").localeCompare(right.key ?? "")
+        || left.value.localeCompare(right.value))
+        .map((facet) => facet);
+}
 /**
  * Return the nodes that satisfy every supplied axis filter (AND-intersection).
  *

package/dist/kernel/engine/graph/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../src/kernel/engine/graph/node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../src/kernel/engine/graph/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6BH,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,EAAE,GAAG,kCAAkC,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAc;IAC5D,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE;QACjC,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACrD,CAAC,CAAC;IACF,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAkBD,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/C,uEAAuE;IACvE,4EAA4E;IAC5E,gBAAgB;IAChB,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1F,OAAO,EAAE,CAAC;AACZ,CAAC;AA6BD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/D,SAAS,UAAU,CAAC,KAAqD,EAAE,IAAY;IACrF,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,OAAO,IAAI,KAAK,QAAQ;WACrB,OAAO,IAAI,KAAK,SAAS;WACzB,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,wDAAwD,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC5D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,KAA8D,EAAE,GAAW;IAMjG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjG,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5G,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,UAAU,GAAG,IAAI,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,SAAS,GAAG,KAA2B,CAAC;IAC9C,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,KAAK,CAAC;QACnD,QAAQ,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,GAAG,WAAW,CAAC;QACjE,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,GAAG,cAAc,CAAC;QAC1E,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAqB,EAAE,GAAW;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAwC;WAC/D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;WACnG,EAAE,CAAC;IACR,OAAO,MAAsB,CAAC;AAChC,CAAC;AAID,SAAS,UAAU,CAAC,KAAiB;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAClE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAC9C,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,UAAU,CAAC,IAAgB,EAAE,KAAiB;IACrD,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,IAAgB,EAAE,KAAiB;IACvD,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAClG,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACzF,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtG,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,MAA6B,EAAE,QAA+B;IAClF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAiC,EACjC,IAAe;IAEf,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,qCAAqC,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACrH,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACnE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACxE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,iBAAiB,EAAE,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAU,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,gCAAgC;QAChC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5E,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACpC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBACxB,IAAI,OAAO,MAAM,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACpC,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnE,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QACnB,CAAC;QACD,iEAAiE;QACjE,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACtC,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACzF,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC7F,IAAI,SAAS,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC9I,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC;YAClD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC/E,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,wBAAwB,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC3C,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;uBACnH,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1H,CAAC,CAAC;gBACH,IAAI,CAAC,YAAY;oBAAE,OAAO,KAAK,CAAC;YAClC,CAAC;YACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAC;YAC/H,CAAC;YACD,IACE,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;mBAC1B,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;mBAC/B,SAAS,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;mBAClC,KAAK,KAAK,SAAS;mBACnB,KAAK,KAAK,SAAS;mBACnB,OAAO,KAAK,SAAS,EACxB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AASD,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,KAAiC;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoF,CAAC;IAC3G,MAAM,GAAG,GAAG,CAAC,IAAwB,EAAE,KAAa,EAAE,GAAY,EAAQ,EAAE;QAC1E,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU;YAAE,OAAO;QACxB,MAAM,QAAQ,GAAG,GAAG,IAAI,SAAS,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,UAAU,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzG,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,sEAAsE;YACtE,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS;YAChC,KAAK,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC;gBAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;SACxB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;WAChC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;WAC/C,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CACzC;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAmB,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiC,EACjC,OAAwB;IAExB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACnE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;gBACpE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;YAC5E,CAAC;iBAAM,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB,EAAE,KAAa;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/kernel/engine/mcp/facade.d.ts

@@ -21,6 +21,8 @@
  */
 import type { DispatcherDeps } from "../retrieval/dispatcher.js";
 import type { Reranker } from "../retrieval/reranker.js";
+import type { EngineStore } from "../embed/store.js";
+import type { EmbeddingModelDescriptor } from "../embed/model.js";
 import type { McpSemanticQueryOptions, McpSemanticQueryResult, McpSemanticEmbeddingSyncOptions, McpSemanticEmbeddingSyncResult, McpStatusOptions, McpSemanticProviderStatus, McpSemanticCollectionResult, McpSemanticContextResult, McpSemanticCleanupResult, McpGraphBuildOptions, McpGraphBuildResult, McpGraphStatusResult, McpAxisFilters, McpSemanticGetOptions, McpSemanticMultiGetOptions, McpSemanticDocumentResult } from "./types.js";
 /**
  * Engine-side adapter for the 10 MCP ops.
@@ -35,6 +37,7 @@ export declare class McpEngineAdapter {
     private readonly reranker?;
     /** Explicit assembly policy; read-only engines suppress this refresh. */
     private readonly implicitLexicalSync;
+    private readonly persistLexicalSync;
     /**
      * @param deps      - Injected backend dependencies (store + embed required).
      * @param vaultPath - Absolute vault root, used by graph / sync / cleanup /
@@ -47,13 +50,30 @@ export declare class McpEngineAdapter {
     constructor(deps: DispatcherDeps, vaultPath: string, config?: {
         readonly embeddingProvider?: string;
         readonly embeddingModel?: string;
+        readonly embeddingDescriptor?: EmbeddingModelDescriptor;
+        readonly embeddingDimensions?: number;
+        readonly embeddingContext?: number;
+        readonly embeddingContextLength?: number;
+        readonly embeddingContextTokens?: number;
+        readonly embeddingMrlDim?: number;
+        readonly embeddingNormalization?: string;
+        readonly embeddingPrefixScheme?: string;
+        readonly dbPath?: string;
+        readonly onStoreRebind?: (store: EngineStore) => void;
     } | undefined, reranker?: Reranker | undefined, 
     /** Explicit assembly policy; read-only engines suppress this refresh. */
-    implicitLexicalSync?: boolean);
+    implicitLexicalSync?: boolean, persistLexicalSync?: boolean);
     private graphCachePath;
     private nodeCachePath;
     /** Load the node index from cache, building it live on a cache miss. */
     private loadOrBuildNodes;
+    /**
+     * Evaluate an overview/axis query directly from the read-only node index.
+     * This path is intentionally model-free and does not open the embedding
+     * store, so a query issued outside a vault or against an empty vault cannot
+     * create `.oms/` state as a side effect.
+     */
+    private queryNodeAxes;
     /**
      * Execute a semantic query and return MCP-shaped results.
      * Maps opts → TypedSubQuery[] → dispatch() → McpSemanticQueryResult.