@knolo/core 3.1.4 → 3.2.1

package/README.md

@@ -91,19 +91,30 @@ You can write it to disk or store it in object storage.
 
 ## 2️⃣ Mount a Pack
 
+### Node.js (local path convenience)
+
 ```ts
-import { mountPack } from "@knolo/core";
+import { mountPack } from "@knolo/core/node";
 
 const pack = await mountPack({
   src: "./dist/knowledge.knolo"
 });
 ```
 
+### React Native / Expo (URL or bytes)
+
+```ts
+import { mountPack } from "@knolo/core";
+
+const ab = await (await fetch(PACK_URL)).arrayBuffer();
+const pack = await mountPack({ src: new Uint8Array(ab) });
+```
+
 You can mount from:
 
-* File path
+* URL string (runtime-safe entry)
 * Buffer / Uint8Array
-* Remote fetch response
+* Local file path in Node via `@knolo/core/node`
 * Object storage download
 
 Mount-time validation ensures:
@@ -308,10 +319,73 @@ Properties:
 
 ---
 
-# 📄 License
+# 🕸 ClaimGraph API
 
-Apache-2.0
+`@knolo/core` includes a deterministic ClaimGraph subsystem.
+
+## Build-time config
+
+```ts
+type BuildPackOptions = {
+  graph?: {
+    enabled?: boolean; // default true
+    maxEdgesPerDoc?: number; // default 500
+  };
+};
+```
+
+## Query-time config
+
+```ts
+type QueryOptions = {
+  graph?: {
+    expand?: boolean; // default false
+    maxExtraTerms?: number; // default 12
+    predicates?: string[]; // default ['defined_as', 'is', 'mentions', 'ref']
+  };
+};
+```
+
+## Exports
+
+```ts
+import {
+  buildClaimGraph,
+  getClaimGraph,
+  applyClaimGraphLog,
+  mergeClaimGraphLogs,
+  expandQueryWithGraph,
+  createGraphLog,
+  appendOp,
+} from '@knolo/core';
+```
+
+Types:
 
+* `ClaimNode`
+* `ClaimEdge`
+* `ClaimGraph`
+* `ClaimOp`
+* `ClaimGraphLog`
 
+## Notes on determinism and bounds
 
+* Node IDs are hash-derived from normalized labels.
+* Edge IDs are hash-derived from `(from, predicate, to, evidence)`.
+* Node labels are normalized and deterministically truncated.
+* Evidence arrays are sorted + unique.
+* Node/edge arrays are sorted by ID in final graph.
+* Extraction is bounded with `maxEdgesPerDoc`.
+* Query expansion is bounded with `maxExtraTerms` and stable ordering.
+
+## Pack format note
+
+`.knolo` binary layout now supports an optional trailing ClaimGraph JSON section after existing sections.
+Runtimes that ignore unknown trailing bytes remain compatible.
+
+---
+
+# 📄 License
+
+Apache-2.0
 

package/dist/builder.d.ts

@@ -16,5 +16,9 @@ export type BuildPackOptions = {
             perVectorScale?: true;
         };
     };
+    graph?: {
+        enabled?: boolean;
+        maxEdgesPerDoc?: number;
+    };
 };
 export declare function buildPack(docs: BuildInputDoc[], opts?: BuildPackOptions): Promise<Uint8Array>;

package/dist/builder.js

@@ -9,6 +9,7 @@ import { tokenize } from './tokenize.js';
 import { getTextEncoder } from './utils/utf8.js';
 import { encodeScaleF16, quantizeEmbeddingInt8L2Norm } from './semantic.js';
 import { validateAgentRegistry } from './agent.js';
+import { buildClaimGraph } from './graph/build_claim_graph.js';
 export async function buildPack(docs, opts = {}) {
     const normalizedDocs = validateDocs(docs);
     // Prepare blocks (strip MD) and carry heading/docId for optional boosts.
@@ -23,6 +24,10 @@ export async function buildPack(docs, opts = {}) {
     const totalTokens = blockTokenLens.reduce((sum, len) => sum + len, 0);
     const avgBlockLen = blocks.length ? totalTokens / blocks.length : 1;
     const agents = normalizeAgents(opts.agents);
+    const graphEnabled = opts.graph?.enabled ?? true;
+    const claimGraph = graphEnabled
+        ? buildClaimGraph(normalizedDocs, { maxEdgesPerDoc: opts.graph?.maxEdgesPerDoc })
+        : null;
     const meta = {
         version: 3,
         stats: {
@@ -32,6 +37,15 @@ export async function buildPack(docs, opts = {}) {
             avgBlockLen,
         },
         ...(agents ? { agents } : {}),
+        ...(claimGraph
+            ? {
+                claimGraph: {
+                    version: 1,
+                    nodes: claimGraph.nodes.length,
+                    edges: claimGraph.edges.length,
+                },
+            }
+            : {}),
     };
     // Persist blocks as objects to optionally carry heading/docId/token length.
     const blocksPayload = blocks.map((b, i) => ({
@@ -54,6 +68,7 @@ export async function buildPack(docs, opts = {}) {
         ? enc.encode(JSON.stringify(semanticSection.semJson))
         : undefined;
     const semBlob = semanticSection?.semBlob;
+    const graphBytes = claimGraph ? enc.encode(JSON.stringify(claimGraph)) : undefined;
     const totalLength = 4 +
         metaBytes.length +
         4 +
@@ -64,7 +79,8 @@ export async function buildPack(docs, opts = {}) {
         blocksBytes.length +
         (semanticEnabled && semBytes && semBlob
             ? 4 + semBytes.length + 4 + semBlob.length
-            : 0);
+            : 0) +
+        (graphBytes ? 4 + graphBytes.length : 0);
     const out = new Uint8Array(totalLength);
     const dv = new DataView(out.buffer);
     let offset = 0;
@@ -98,6 +114,12 @@ export async function buildPack(docs, opts = {}) {
         dv.setUint32(offset, semBlob.length, true);
         offset += 4;
         out.set(semBlob, offset);
+        offset += semBlob.length;
+    }
+    if (graphBytes) {
+        dv.setUint32(offset, graphBytes.length, true);
+        offset += 4;
+        out.set(graphBytes, offset);
     }
     return out;
 }

package/dist/graph/build_claim_graph.d.ts

@@ -0,0 +1,5 @@
+import type { BuildInputDoc } from '../builder.js';
+import type { ClaimGraph } from './claim_graph.js';
+export declare function buildClaimGraph(docs: BuildInputDoc[], opts?: {
+    maxEdgesPerDoc?: number;
+}): ClaimGraph;

package/dist/graph/build_claim_graph.js

@@ -0,0 +1,88 @@
+import { canonicalEvidence, computeEdgeId, computeNodeId, finalizeGraph, normalizeClaimLabel, } from './claim_graph.js';
+const DEF_RE = /^([A-Za-z0-9 _-]{2,80})\s+(is|are)\s+(.{2,120})[.?!]/;
+const MD_LINK_RE = /\[([^\]]{1,200})\]\(([^)\s]{1,200})\)/g;
+const WIKI_RE = /\[\[([^\]]{1,200})\]\]/g;
+const HEADING_RE = /^(#{1,3})\s+(.+)$/gm;
+const STOPWORDS = new Set(['a', 'an', 'and', 'or', 'the', 'it', 'they', 'this', 'that', 'these', 'those']);
+export function buildClaimGraph(docs, opts = {}) {
+    const maxEdgesPerDoc = Math.max(1, opts.maxEdgesPerDoc ?? 500);
+    const nodeById = new Map();
+    const edgeById = new Map();
+    for (let i = 0; i < docs.length; i++) {
+        const doc = docs[i];
+        const docLabel = normalizeLabel(doc.id || doc.heading || `doc_${i}`);
+        const local = [];
+        for (const m of doc.text.matchAll(MD_LINK_RE)) {
+            addEdge(local, nodeById, normalizeLabel(m[1]), 'ref', normalizeLabel(m[2]), [i]);
+        }
+        for (const m of doc.text.matchAll(WIKI_RE)) {
+            addEdge(local, nodeById, docLabel, 'mentions', normalizeLabel(m[1]), [i]);
+        }
+        const headingMatches = Array.from(doc.text.matchAll(HEADING_RE));
+        for (const h of headingMatches) {
+            const headingLabel = normalizeLabel(h[2] || '');
+            const headingStart = h.index ?? 0;
+            const sentence = firstSentenceAfter(doc.text, headingStart + h[0].length);
+            if (sentence) {
+                addEdge(local, nodeById, headingLabel, 'defined_as', normalizeLabel(sentence), [i]);
+            }
+        }
+        for (const sentence of splitSentences(doc.text)) {
+            const m = sentence.match(DEF_RE);
+            if (!m)
+                continue;
+            const subject = normalizeLabel(m[1]);
+            if (!subject || isStopwordOnly(subject))
+                continue;
+            const objectSnippet = normalizeLabel(m[3]);
+            addEdge(local, nodeById, subject, 'is', objectSnippet, [i]);
+        }
+        local.sort((a, b) => a.id.localeCompare(b.id));
+        for (const edge of local.slice(0, maxEdgesPerDoc)) {
+            const existing = edgeById.get(edge.id);
+            if (existing) {
+                existing.evidence = canonicalEvidence([...(existing.evidence ?? []), ...(edge.evidence ?? [])]);
+            }
+            else {
+                edgeById.set(edge.id, edge);
+            }
+        }
+    }
+    return finalizeGraph({ version: 1, nodes: [...nodeById.values()], edges: [...edgeById.values()] });
+}
+function addEdge(local, nodeById, fromLabel, p, toLabel, evidence) {
+    if (!fromLabel || !toLabel)
+        return;
+    const fromId = ensureNode(nodeById, fromLabel);
+    const toId = ensureNode(nodeById, toLabel);
+    const edgeEvidence = canonicalEvidence(evidence);
+    const id = computeEdgeId(fromId, p, toId, edgeEvidence);
+    local.push({ id, from: fromId, p, to: toId, evidence: edgeEvidence });
+}
+function ensureNode(nodeById, label) {
+    const id = computeNodeId(label);
+    if (!nodeById.has(id))
+        nodeById.set(id, { id, label });
+    return id;
+}
+function normalizeLabel(input) {
+    return normalizeClaimLabel(input, 200);
+}
+function splitSentences(text) {
+    return text
+        .replace(/\r\n/g, '\n')
+        .split(/(?<=[.?!])\s+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function firstSentenceAfter(text, startIdx) {
+    const tail = text.slice(startIdx).replace(/^[^\n]*\n+/, '').trim();
+    if (!tail)
+        return '';
+    const first = splitSentences(tail)[0] ?? '';
+    return first.slice(0, 240);
+}
+function isStopwordOnly(subject) {
+    const words = subject.split(/\s+/).filter(Boolean);
+    return words.length > 0 && words.every((w) => STOPWORDS.has(w));
+}

package/dist/graph/claim_graph.d.ts

@@ -0,0 +1,34 @@
+import type { Pack } from '../pack.runtime.js';
+export type ClaimNode = {
+    id: string;
+    label: string;
+    props?: Record<string, string>;
+};
+export type ClaimEdge = {
+    id: string;
+    from: string;
+    p: string;
+    to: string;
+    evidence?: number[];
+    actor?: string;
+    ts?: number;
+};
+export type ClaimGraph = {
+    version: 1;
+    nodes: ClaimNode[];
+    edges: ClaimEdge[];
+    index?: {
+        labelToId?: Record<string, string>;
+        out?: Record<string, string[]>;
+        in?: Record<string, string[]>;
+    };
+};
+export declare function normalizeClaimLabel(label: string, maxLen?: number): string;
+export declare function computeNodeId(label: string): string;
+export declare function computeEdgeId(from: string, p: string, to: string, evidence?: number[]): string;
+export declare function canonicalEvidence(evidence?: number[]): number[];
+export declare function buildGraphIndex(graph: ClaimGraph): ClaimGraph['index'];
+export declare function finalizeGraph(graph: ClaimGraph): ClaimGraph;
+export declare function getClaimGraph(pack: Pack): ClaimGraph | null;
+export declare function validateClaimGraph(input: unknown): ClaimGraph | null;
+export declare function expandLabelToTerms(label: string): string[];

package/dist/graph/claim_graph.js

@@ -0,0 +1,65 @@
+import { normalize, tokenize } from '../tokenize.js';
+export function normalizeClaimLabel(label, maxLen = 200) {
+    const compact = normalize(label).replace(/\s+/g, ' ').trim();
+    return compact.slice(0, maxLen);
+}
+export function computeNodeId(label) {
+    return `n_${hash32Hex(normalizeClaimLabel(label))}`;
+}
+export function computeEdgeId(from, p, to, evidence) {
+    const evidenceCsv = canonicalEvidence(evidence).join(',');
+    return `e_${hash32Hex(`${from}\n${p}\n${to}\n${evidenceCsv}`)}`;
+}
+export function canonicalEvidence(evidence) {
+    if (!evidence?.length)
+        return [];
+    return Array.from(new Set(evidence.filter((n) => Number.isInteger(n) && n >= 0))).sort((a, b) => a - b);
+}
+export function buildGraphIndex(graph) {
+    const labelToId = {};
+    const out = {};
+    const inbound = {};
+    for (const node of graph.nodes) {
+        labelToId[normalizeClaimLabel(node.label)] = node.id;
+    }
+    for (const edge of graph.edges) {
+        (out[edge.from] ||= []).push(edge.id);
+        (inbound[edge.to] ||= []).push(edge.id);
+    }
+    for (const key of Object.keys(out))
+        out[key].sort();
+    for (const key of Object.keys(inbound))
+        inbound[key].sort();
+    return { labelToId, out, in: inbound };
+}
+export function finalizeGraph(graph) {
+    const nodes = [...graph.nodes].sort((a, b) => a.id.localeCompare(b.id));
+    const edges = [...graph.edges]
+        .map((e) => ({ ...e, evidence: canonicalEvidence(e.evidence) }))
+        .sort((a, b) => a.id.localeCompare(b.id));
+    const out = { version: 1, nodes, edges };
+    out.index = buildGraphIndex(out);
+    return out;
+}
+export function getClaimGraph(pack) {
+    return pack.claimGraph ?? null;
+}
+export function validateClaimGraph(input) {
+    if (!input || typeof input !== 'object')
+        return null;
+    const g = input;
+    if (g.version !== 1 || !Array.isArray(g.nodes) || !Array.isArray(g.edges))
+        return null;
+    return finalizeGraph({ version: 1, nodes: g.nodes, edges: g.edges });
+}
+export function expandLabelToTerms(label) {
+    return tokenize(normalizeClaimLabel(label)).map((t) => t.term);
+}
+function hash32Hex(input) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        h ^= input.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16).padStart(8, '0');
+}

package/dist/graph/log.d.ts

@@ -0,0 +1,33 @@
+import type { Pack } from '../pack.runtime.js';
+import type { ClaimGraph } from './claim_graph.js';
+export type ClaimOp = {
+    op: 'upsert_node';
+    id?: string;
+    label: string;
+    props?: Record<string, string>;
+    ts: number;
+    actor: string;
+} | {
+    op: 'add_edge';
+    from: string;
+    p: string;
+    to: string;
+    evidence?: number[];
+    ts: number;
+    actor: string;
+} | {
+    op: 'tombstone_edge';
+    edgeId: string;
+    ts: number;
+    actor: string;
+};
+export type ClaimGraphLog = {
+    version: 1;
+    ops: ClaimOp[];
+};
+export declare function createGraphLog(): ClaimGraphLog;
+export declare function appendOp(log: ClaimGraphLog, op: ClaimOp): ClaimGraphLog;
+export declare function mergeClaimGraphLogs(a: ClaimGraphLog, b: ClaimGraphLog): ClaimGraphLog;
+export declare function serializeClaimGraphLog(log: ClaimGraphLog): Uint8Array;
+export declare function deserializeClaimGraphLog(data: Uint8Array): ClaimGraphLog;
+export declare function applyClaimGraphLog(graphOrPack: ClaimGraph | Pack, log: ClaimGraphLog): ClaimGraph;

package/dist/graph/log.js

@@ -0,0 +1,106 @@
+import { canonicalEvidence, computeEdgeId, computeNodeId, finalizeGraph, normalizeClaimLabel, } from './claim_graph.js';
+export function createGraphLog() {
+    return { version: 1, ops: [] };
+}
+export function appendOp(log, op) {
+    return { version: 1, ops: [...log.ops, op] };
+}
+export function mergeClaimGraphLogs(a, b) {
+    return { version: 1, ops: [...a.ops, ...b.ops].sort(compareOps) };
+}
+export function serializeClaimGraphLog(log) {
+    return new TextEncoder().encode(JSON.stringify({ version: 1, ops: [...log.ops].sort(compareOps) }));
+}
+export function deserializeClaimGraphLog(data) {
+    const parsed = JSON.parse(new TextDecoder().decode(data));
+    if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.ops)) {
+        throw new Error('Invalid ClaimGraphLog payload');
+    }
+    return { version: 1, ops: parsed.ops.sort(compareOps) };
+}
+export function applyClaimGraphLog(graphOrPack, log) {
+    const baseGraph = isPack(graphOrPack)
+        ? graphOrPack.claimGraph ?? { version: 1, nodes: [], edges: [] }
+        : graphOrPack;
+    const nodeById = new Map(baseGraph.nodes.map((n) => [n.id, { ...n, props: n.props ? { ...n.props } : undefined }]));
+    const edgeById = new Map(baseGraph.edges.map((e) => [e.id, { ...e, evidence: canonicalEvidence(e.evidence) }]));
+    const nodeStamp = new Map();
+    const addStamp = new Map();
+    const tombstoneStamp = new Map();
+    for (const op of [...log.ops].sort(compareOps)) {
+        if (op.op === 'upsert_node') {
+            const label = normalizeClaimLabel(op.label);
+            const id = op.id || computeNodeId(label);
+            const prev = nodeStamp.get(id);
+            if (!prev || compareStamp([op.ts, op.actor], prev) >= 0) {
+                nodeStamp.set(id, [op.ts, op.actor]);
+                nodeById.set(id, { id, label, props: op.props ? { ...op.props } : undefined });
+            }
+            continue;
+        }
+        if (op.op === 'add_edge') {
+            const evidence = canonicalEvidence(op.evidence);
+            const edgeId = computeEdgeId(op.from, op.p, op.to, evidence);
+            const prevAdd = addStamp.get(edgeId);
+            if (!prevAdd || compareStamp([op.ts, op.actor], prevAdd) >= 0) {
+                addStamp.set(edgeId, [op.ts, op.actor]);
+            }
+            const existing = edgeById.get(edgeId);
+            const mergedEvidence = canonicalEvidence([...(existing?.evidence ?? []), ...evidence]);
+            edgeById.set(edgeId, {
+                id: edgeId,
+                from: op.from,
+                p: op.p,
+                to: op.to,
+                evidence: mergedEvidence,
+                actor: op.actor,
+                ts: op.ts,
+            });
+            continue;
+        }
+        const prev = tombstoneStamp.get(op.edgeId);
+        if (!prev || compareStamp([op.ts, op.actor], prev) >= 0) {
+            tombstoneStamp.set(op.edgeId, [op.ts, op.actor]);
+        }
+    }
+    for (const [edgeId, edge] of edgeById) {
+        const add = addStamp.get(edgeId) ?? [-Infinity, ''];
+        const tomb = tombstoneStamp.get(edgeId);
+        if (tomb && compareStamp(tomb, add) > 0) {
+            edgeById.delete(edgeId);
+            continue;
+        }
+        if (!nodeById.has(edge.from)) {
+            nodeById.set(edge.from, { id: edge.from, label: edge.from });
+        }
+        if (!nodeById.has(edge.to)) {
+            nodeById.set(edge.to, { id: edge.to, label: edge.to });
+        }
+    }
+    return finalizeGraph({ version: 1, nodes: [...nodeById.values()], edges: [...edgeById.values()] });
+}
+function compareOps(a, b) {
+    if (a.ts !== b.ts)
+        return a.ts - b.ts;
+    const actorCmp = a.actor.localeCompare(b.actor);
+    if (actorCmp !== 0)
+        return actorCmp;
+    return stableSerializeOp(a).localeCompare(stableSerializeOp(b));
+}
+function stableSerializeOp(op) {
+    if (op.op === 'upsert_node') {
+        return `upsert_node|${op.id || ''}|${normalizeClaimLabel(op.label)}|${JSON.stringify(op.props || {})}`;
+    }
+    if (op.op === 'add_edge') {
+        return `add_edge|${op.from}|${op.p}|${op.to}|${canonicalEvidence(op.evidence).join(',')}`;
+    }
+    return `tombstone_edge|${op.edgeId}`;
+}
+function compareStamp(a, b) {
+    if (a[0] !== b[0])
+        return a[0] - b[0];
+    return a[1].localeCompare(b[1]);
+}
+function isPack(input) {
+    return Boolean(input.meta && input.blocks);
+}

package/dist/graph/query_expand.d.ts

@@ -0,0 +1,6 @@
+import type { Pack } from '../pack.runtime.js';
+export type GraphQueryExpandOptions = {
+    maxExtraTerms?: number;
+    predicates?: string[];
+};
+export declare function expandQueryWithGraph(pack: Pack, queryString: string, opts?: GraphQueryExpandOptions): string;

package/dist/graph/query_expand.js

@@ -0,0 +1,57 @@
+import { normalize, tokenize } from '../tokenize.js';
+import { expandLabelToTerms } from './claim_graph.js';
+export function expandQueryWithGraph(pack, queryString, opts = {}) {
+    const graph = pack.claimGraph;
+    if (!graph || graph.nodes.length === 0 || graph.edges.length === 0)
+        return queryString;
+    const maxExtraTerms = Math.max(1, opts.maxExtraTerms ?? 12);
+    const predicates = new Set((opts.predicates ?? ['defined_as', 'is', 'mentions', 'ref']).map((p) => normalize(p)));
+    const qTokens = tokenize(queryString).map((t) => t.term);
+    if (qTokens.length === 0)
+        return queryString;
+    const qSet = new Set(qTokens);
+    const candidateNodeIds = new Set();
+    const labelEntries = Object.entries(graph.index?.labelToId ?? {}).sort((a, b) => a[0].localeCompare(b[0]));
+    for (const [labelNorm, nodeId] of labelEntries) {
+        if (qSet.has(labelNorm))
+            candidateNodeIds.add(nodeId);
+    }
+    for (const token of qTokens.sort()) {
+        for (const [labelNorm, nodeId] of labelEntries) {
+            if (labelNorm.startsWith(token))
+                candidateNodeIds.add(nodeId);
+            if (candidateNodeIds.size >= maxExtraTerms * 4)
+                break;
+        }
+        if (candidateNodeIds.size >= maxExtraTerms * 4)
+            break;
+    }
+    const edgeById = new Map(graph.edges.map((e) => [e.id, e]));
+    const outIdx = graph.index?.out ?? {};
+    const extraTerms = new Set();
+    const sortedNodeIds = [...candidateNodeIds].sort();
+    for (const nodeId of sortedNodeIds) {
+        const edgeIds = [...(outIdx[nodeId] ?? [])].sort();
+        for (const edgeId of edgeIds) {
+            const edge = edgeById.get(edgeId);
+            if (!edge || !predicates.has(normalize(edge.p)))
+                continue;
+            const target = graph.nodes.find((n) => n.id === edge.to);
+            if (!target)
+                continue;
+            for (const term of expandLabelToTerms(target.label)) {
+                if (!qSet.has(term))
+                    extraTerms.add(term);
+                if (extraTerms.size >= maxExtraTerms)
+                    break;
+            }
+            if (extraTerms.size >= maxExtraTerms)
+                break;
+        }
+        if (extraTerms.size >= maxExtraTerms)
+            break;
+    }
+    if (extraTerms.size === 0)
+        return queryString;
+    return `${queryString} ${[...extraTerms].sort().join(' ')}`.trim();
+}

package/dist/index.d.ts

@@ -1,14 +1,20 @@
-export { mountPack, hasSemantic } from './pack.js';
+export { mountPack, hasSemantic } from './pack.runtime.js';
 export { query, lexConfidence, validateQueryOptions, validateSemanticQueryOptions, } from './query.js';
 export { makeContextPatch } from './patch.js';
 export { buildPack } from './builder.js';
 export { quantizeEmbeddingInt8L2Norm, encodeScaleF16, decodeScaleF16, } from './semantic.js';
 export { listAgents, getAgent, resolveAgent, buildSystemPrompt, isToolAllowed, assertToolAllowed, validateAgentRegistry, validateAgentDefinition, } from './agent.js';
-export type { MountOptions, PackMeta, Pack } from './pack.js';
+export { getClaimGraph, validateClaimGraph, } from './graph/claim_graph.js';
+export { buildClaimGraph } from './graph/build_claim_graph.js';
+export { createGraphLog, appendOp, applyClaimGraphLog, mergeClaimGraphLogs, serializeClaimGraphLog, deserializeClaimGraphLog, } from './graph/log.js';
+export { expandQueryWithGraph } from './graph/query_expand.js';
+export type { MountOptions, PackMeta, Pack } from './pack.runtime.js';
 export type { QueryOptions, Hit } from './query.js';
 export type { ContextPatch } from './patch.js';
 export type { BuildInputDoc, BuildPackOptions } from './builder.js';
 export type { AgentPromptTemplate, AgentToolPolicy, AgentRetrievalDefaults, AgentDefinitionV1, AgentRegistry, ResolveAgentInput, ResolvedAgent, } from './agent.js';
+export type { ClaimGraph, ClaimNode, ClaimEdge } from './graph/claim_graph.js';
+export type { ClaimGraphLog, ClaimOp } from './graph/log.js';
 export { parseToolCallV1FromText } from './tool_parse.js';
 export { nowIso, createTrace } from './trace.js';
 export { assertToolCallAllowed } from './tool_gate.js';

package/dist/index.js

@@ -1,10 +1,14 @@
 // src/index.ts
-export { mountPack, hasSemantic } from './pack.js';
+export { mountPack, hasSemantic } from './pack.runtime.js';
 export { query, lexConfidence, validateQueryOptions, validateSemanticQueryOptions, } from './query.js';
 export { makeContextPatch } from './patch.js';
 export { buildPack } from './builder.js';
 export { quantizeEmbeddingInt8L2Norm, encodeScaleF16, decodeScaleF16, } from './semantic.js';
 export { listAgents, getAgent, resolveAgent, buildSystemPrompt, isToolAllowed, assertToolAllowed, validateAgentRegistry, validateAgentDefinition, } from './agent.js';
+export { getClaimGraph, validateClaimGraph, } from './graph/claim_graph.js';
+export { buildClaimGraph } from './graph/build_claim_graph.js';
+export { createGraphLog, appendOp, applyClaimGraphLog, mergeClaimGraphLogs, serializeClaimGraphLog, deserializeClaimGraphLog, } from './graph/log.js';
+export { expandQueryWithGraph } from './graph/query_expand.js';
 export { parseToolCallV1FromText } from './tool_parse.js';
 export { nowIso, createTrace } from './trace.js';
 export { assertToolCallAllowed } from './tool_gate.js';

package/dist/node.d.ts

@@ -0,0 +1,2 @@
+export { mountPack, hasSemantic } from './pack.node.js';
+export type { MountOptions, PackMeta, Pack } from './pack.node.js';

package/dist/node.js

@@ -0,0 +1 @@
+export { mountPack, hasSemantic } from './pack.node.js';

package/dist/pack.d.ts

@@ -1,35 +1,2 @@
-import type { AgentRegistry } from './agent.js';
-export type MountOptions = {
-    src: string | ArrayBufferLike | Uint8Array;
-};
-export type PackMeta = {
-    version: number;
-    stats: {
-        docs: number;
-        blocks: number;
-        terms: number;
-        avgBlockLen?: number;
-    };
-    agents?: AgentRegistry;
-};
-export type Pack = {
-    meta: PackMeta;
-    lexicon: Map<string, number>;
-    postings: Uint32Array;
-    blocks: string[];
-    headings?: (string | null)[];
-    docIds?: (string | null)[];
-    namespaces?: (string | null)[];
-    blockTokenLens?: number[];
-    semantic?: {
-        version: 1;
-        modelId: string;
-        dims: number;
-        encoding: 'int8_l2norm';
-        perVectorScale: boolean;
-        vecs: Int8Array;
-        scales?: Uint16Array;
-    };
-};
-export declare function hasSemantic(pack: Pack): boolean;
-export declare function mountPack(opts: MountOptions): Promise<Pack>;
+export { mountPack, hasSemantic } from './pack.runtime.js';
+export type { MountOptions, PackMeta, Pack } from './pack.runtime.js';

package/dist/pack.js

@@ -1,175 +1 @@
-/*
- * pack.ts
- *
- * Mount `.knolo` packs across Node, browsers, and RN/Expo. Tolerant of:
- *  - blocks as string[] (v1) or object[] with { text, heading?, docId?, namespace?, len? }
- *  - meta.stats.avgBlockLen (optional)
- * Includes RN/Expo-safe TextDecoder via ponyfill.
- */
-import { getTextDecoder } from './utils/utf8.js';
-import { validateAgentRegistry } from './agent.js';
-export function hasSemantic(pack) {
-    return Boolean(pack.semantic && pack.semantic.dims > 0 && pack.semantic.vecs.length > 0);
-}
-export async function mountPack(opts) {
-    const buf = await resolveToBuffer(opts.src);
-    const dv = new DataView(buf);
-    const dec = getTextDecoder();
-    let offset = 0;
-    // meta
-    const metaLen = dv.getUint32(offset, true);
-    offset += 4;
-    const metaJson = dec.decode(new Uint8Array(buf, offset, metaLen));
-    offset += metaLen;
-    const meta = JSON.parse(metaJson);
-    if (meta.agents) {
-        validateAgentRegistry(meta.agents);
-    }
-    // lexicon
-    const lexLen = dv.getUint32(offset, true);
-    offset += 4;
-    const lexJson = dec.decode(new Uint8Array(buf, offset, lexLen));
-    offset += lexLen;
-    const lexEntries = JSON.parse(lexJson);
-    const lexicon = new Map(lexEntries);
-    // postings
-    const postCount = dv.getUint32(offset, true);
-    offset += 4;
-    const postings = new Uint32Array(postCount);
-    for (let i = 0; i < postCount; i++) {
-        postings[i] = dv.getUint32(offset, true);
-        offset += 4;
-    }
-    // blocks (v1: string[]; v2/v3: {text, heading?, docId?, namespace?, len?}[])
-    const blocksLen = dv.getUint32(offset, true);
-    offset += 4;
-    const blocksJson = dec.decode(new Uint8Array(buf, offset, blocksLen));
-    offset += blocksLen;
-    const parsed = JSON.parse(blocksJson);
-    let blocks = [];
-    let headings;
-    let docIds;
-    let namespaces;
-    let blockTokenLens;
-    if (Array.isArray(parsed) && parsed.length && typeof parsed[0] === 'string') {
-        // v1
-        blocks = parsed;
-    }
-    else if (Array.isArray(parsed)) {
-        blocks = [];
-        headings = [];
-        docIds = [];
-        namespaces = [];
-        blockTokenLens = [];
-        for (const it of parsed) {
-            if (it && typeof it === 'object') {
-                blocks.push(String(it.text ?? ''));
-                headings.push(it.heading ?? null);
-                docIds.push(it.docId ?? null);
-                namespaces.push(it.namespace ?? null);
-                blockTokenLens.push(typeof it.len === 'number' ? it.len : 0);
-            }
-            else {
-                blocks.push(String(it ?? ''));
-                headings.push(null);
-                docIds.push(null);
-                namespaces.push(null);
-                blockTokenLens.push(0);
-            }
-        }
-    }
-    else {
-        blocks = [];
-    }
-    let semantic;
-    if (offset < buf.byteLength) {
-        const semLen = dv.getUint32(offset, true);
-        offset += 4;
-        const semJson = dec.decode(new Uint8Array(buf, offset, semLen));
-        offset += semLen;
-        const sem = JSON.parse(semJson);
-        const semBlobLen = dv.getUint32(offset, true);
-        offset += 4;
-        const semBlob = new Uint8Array(buf, offset, semBlobLen);
-        semantic = parseSemanticSection(sem, semBlob);
-    }
-    return {
-        meta,
-        lexicon,
-        postings,
-        blocks,
-        headings,
-        docIds,
-        namespaces,
-        blockTokenLens,
-        semantic,
-    };
-}
-function parseSemanticSection(sem, blob) {
-    const vectors = sem?.blocks?.vectors;
-    const scales = sem?.blocks?.scales;
-    const vecs = new Int8Array(blob.buffer, blob.byteOffset + Number(vectors?.byteOffset ?? 0), Number(vectors?.length ?? 0));
-    let scaleView;
-    if (scales) {
-        const scaleLen = Number(scales.length ?? 0);
-        const scaleOffset = Number(scales.byteOffset ?? 0);
-        const dv = new DataView(blob.buffer, blob.byteOffset + scaleOffset, scaleLen * 2);
-        scaleView = new Uint16Array(scaleLen);
-        for (let i = 0; i < scaleLen; i++) {
-            scaleView[i] = dv.getUint16(i * 2, true);
-        }
-    }
-    return {
-        version: 1,
-        modelId: String(sem?.modelId ?? ''),
-        dims: Number(sem?.dims ?? 0),
-        encoding: 'int8_l2norm',
-        perVectorScale: Boolean(sem?.perVectorScale),
-        vecs,
-        scales: scaleView,
-    };
-}
-async function resolveToBuffer(src) {
-    if (typeof src === 'string') {
-        if (isNodeRuntime() && isLikelyLocalPath(src)) {
-            return await readLocalFileAsBuffer(src);
-        }
-        const res = await fetch(src);
-        return await res.arrayBuffer();
-    }
-    if (src instanceof Uint8Array) {
-        if (src.byteOffset === 0 && src.byteLength === src.buffer.byteLength) {
-            return src.buffer;
-        }
-        const copy = src.slice();
-        return copy.buffer;
-    }
-    return src;
-}
-function isNodeRuntime() {
-    const p = globalThis
-        .process;
-    return !!p?.versions?.node;
-}
-function isLikelyLocalPath(value) {
-    if (value.startsWith('file://'))
-        return true;
-    if (value.startsWith('./') ||
-        value.startsWith('../') ||
-        value.startsWith('/') ||
-        value.startsWith('~'))
-        return true;
-    if (/^[A-Za-z]:[\\/]/.test(value))
-        return true; // Windows absolute path
-    if (/^[A-Za-z][A-Za-z\d+.-]*:/.test(value))
-        return false; // URL scheme
-    return true; // plain relative path like "knowledge.knolo"
-}
-async function readLocalFileAsBuffer(pathOrFileUrl) {
-    const { readFile } = await import('node:fs/promises');
-    const filePath = pathOrFileUrl.startsWith('file://')
-        ? decodeURIComponent(new URL(pathOrFileUrl).pathname)
-        : pathOrFileUrl;
-    const data = await readFile(filePath);
-    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
-}
+export { mountPack, hasSemantic } from './pack.runtime.js';

package/dist/pack.node.d.ts

@@ -0,0 +1,4 @@
+import type { MountOptions, Pack } from './pack.runtime.js';
+export { hasSemantic } from './pack.runtime.js';
+export type { MountOptions, PackMeta, Pack } from './pack.runtime.js';
+export declare function mountPack(opts: MountOptions): Promise<Pack>;

package/dist/pack.node.js

@@ -0,0 +1,35 @@
+import { mountPackFromBuffer, toArrayBuffer } from './pack.runtime.js';
+export { hasSemantic } from './pack.runtime.js';
+export async function mountPack(opts) {
+    const buf = await resolveToBuffer(opts.src);
+    return mountPackFromBuffer(buf);
+}
+async function resolveToBuffer(src) {
+    if (typeof src === 'string') {
+        if (isLikelyLocalPath(src)) {
+            const { readFile } = await import('node:fs/promises');
+            const filePath = src.startsWith('file://')
+                ? decodeURIComponent(new URL(src).pathname)
+                : src;
+            const data = await readFile(filePath);
+            return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+        }
+        const res = await fetch(src);
+        return await res.arrayBuffer();
+    }
+    return toArrayBuffer(src);
+}
+function isLikelyLocalPath(value) {
+    if (value.startsWith('file://'))
+        return true;
+    if (value.startsWith('./') ||
+        value.startsWith('../') ||
+        value.startsWith('/') ||
+        value.startsWith('~'))
+        return true;
+    if (/^[A-Za-z]:[\\/]/.test(value))
+        return true;
+    if (/^[A-Za-z][A-Za-z\d+.-]*:/.test(value))
+        return false;
+    return true;
+}

package/dist/pack.runtime.d.ts

@@ -0,0 +1,44 @@
+import type { AgentRegistry } from './agent.js';
+import type { ClaimGraph } from './graph/claim_graph.js';
+export type MountOptions = {
+    src: string | ArrayBufferLike | Uint8Array;
+};
+export type PackMeta = {
+    version: number;
+    stats: {
+        docs: number;
+        blocks: number;
+        terms: number;
+        avgBlockLen?: number;
+    };
+    agents?: AgentRegistry;
+    claimGraph?: {
+        version: 1;
+        nodes: number;
+        edges: number;
+    };
+};
+export type Pack = {
+    meta: PackMeta;
+    lexicon: Map<string, number>;
+    postings: Uint32Array;
+    blocks: string[];
+    headings?: (string | null)[];
+    docIds?: (string | null)[];
+    namespaces?: (string | null)[];
+    blockTokenLens?: number[];
+    semantic?: {
+        version: 1;
+        modelId: string;
+        dims: number;
+        encoding: 'int8_l2norm';
+        perVectorScale: boolean;
+        vecs: Int8Array;
+        scales?: Uint16Array;
+    };
+    claimGraph?: ClaimGraph;
+};
+export declare function hasSemantic(pack: Pack): boolean;
+export declare function mountPack(opts: MountOptions): Promise<Pack>;
+export declare function mountPackFromBuffer(buf: ArrayBuffer): Pack;
+export declare function toArrayBuffer(src: ArrayBufferLike | Uint8Array): ArrayBuffer;

package/dist/pack.runtime.js

@@ -0,0 +1,191 @@
+/*
+ * pack.runtime.ts
+ *
+ * Runtime-safe pack mounting for browser and React Native environments.
+ * No Node stdlib imports are allowed in this module.
+ */
+import { getTextDecoder } from './utils/utf8.js';
+import { validateAgentRegistry } from './agent.js';
+import { validateClaimGraph } from './graph/claim_graph.js';
+export function hasSemantic(pack) {
+    return Boolean(pack.semantic && pack.semantic.dims > 0 && pack.semantic.vecs.length > 0);
+}
+export async function mountPack(opts) {
+    const buf = await resolveToBuffer(opts.src);
+    return mountPackFromBuffer(buf);
+}
+export function mountPackFromBuffer(buf) {
+    const dv = new DataView(buf);
+    const dec = getTextDecoder();
+    let offset = 0;
+    const metaLen = dv.getUint32(offset, true);
+    offset += 4;
+    const metaJson = dec.decode(new Uint8Array(buf, offset, metaLen));
+    offset += metaLen;
+    const meta = JSON.parse(metaJson);
+    if (meta.agents) {
+        validateAgentRegistry(meta.agents);
+    }
+    const lexLen = dv.getUint32(offset, true);
+    offset += 4;
+    const lexJson = dec.decode(new Uint8Array(buf, offset, lexLen));
+    offset += lexLen;
+    const lexEntries = JSON.parse(lexJson);
+    const lexicon = new Map(lexEntries);
+    const postCount = dv.getUint32(offset, true);
+    offset += 4;
+    const postings = new Uint32Array(postCount);
+    for (let i = 0; i < postCount; i++) {
+        postings[i] = dv.getUint32(offset, true);
+        offset += 4;
+    }
+    const blocksLen = dv.getUint32(offset, true);
+    offset += 4;
+    const blocksJson = dec.decode(new Uint8Array(buf, offset, blocksLen));
+    offset += blocksLen;
+    const parsed = JSON.parse(blocksJson);
+    let blocks = [];
+    let headings;
+    let docIds;
+    let namespaces;
+    let blockTokenLens;
+    if (Array.isArray(parsed) && parsed.length && typeof parsed[0] === 'string') {
+        blocks = parsed;
+    }
+    else if (Array.isArray(parsed)) {
+        blocks = [];
+        headings = [];
+        docIds = [];
+        namespaces = [];
+        blockTokenLens = [];
+        for (const it of parsed) {
+            if (it && typeof it === 'object') {
+                blocks.push(String(it.text ?? ''));
+                headings.push(it.heading ?? null);
+                docIds.push(it.docId ?? null);
+                namespaces.push(it.namespace ?? null);
+                blockTokenLens.push(typeof it.len === 'number' ? it.len : 0);
+            }
+            else {
+                blocks.push(String(it ?? ''));
+                headings.push(null);
+                docIds.push(null);
+                namespaces.push(null);
+                blockTokenLens.push(0);
+            }
+        }
+    }
+    let semantic;
+    let claimGraph;
+    while (offset < buf.byteLength) {
+        const sectionStart = offset;
+        if (buf.byteLength - offset < 4)
+            break;
+        const jsonLen = dv.getUint32(offset, true);
+        offset += 4;
+        if (jsonLen < 0 || offset + jsonLen > buf.byteLength) {
+            offset = sectionStart;
+            break;
+        }
+        let parsed;
+        try {
+            const json = dec.decode(new Uint8Array(buf, offset, jsonLen));
+            parsed = JSON.parse(json);
+        }
+        catch {
+            offset = sectionStart;
+            break;
+        }
+        offset += jsonLen;
+        if (!semantic && looksLikeSemanticJson(parsed)) {
+            if (buf.byteLength - offset < 4) {
+                offset = sectionStart;
+                break;
+            }
+            const semBlobLen = dv.getUint32(offset, true);
+            offset += 4;
+            if (semBlobLen < 0 || offset + semBlobLen > buf.byteLength) {
+                offset = sectionStart;
+                break;
+            }
+            const semBlob = new Uint8Array(buf, offset, semBlobLen);
+            offset += semBlobLen;
+            semantic = parseSemanticSection(parsed, semBlob);
+            continue;
+        }
+        const graph = validateClaimGraph(parsed);
+        if (!claimGraph && graph) {
+            claimGraph = graph;
+            continue;
+        }
+        offset = sectionStart;
+        break;
+    }
+    return {
+        meta,
+        lexicon,
+        postings,
+        blocks,
+        headings,
+        docIds,
+        namespaces,
+        blockTokenLens,
+        semantic,
+        claimGraph,
+    };
+}
+function looksLikeSemanticJson(parsed) {
+    if (!parsed || typeof parsed !== 'object')
+        return false;
+    const sem = parsed;
+    return (sem.version === 1 &&
+        sem.encoding === 'int8_l2norm' &&
+        typeof sem.blocks?.vectors?.byteOffset === 'number' &&
+        typeof sem.blocks?.vectors?.length === 'number');
+}
+function parseSemanticSection(sem, blob) {
+    const vectors = sem?.blocks?.vectors;
+    const scales = sem?.blocks?.scales;
+    const vecs = new Int8Array(blob.buffer, blob.byteOffset + Number(vectors?.byteOffset ?? 0), Number(vectors?.length ?? 0));
+    let scaleView;
+    if (scales) {
+        const scaleLen = Number(scales.length ?? 0);
+        const scaleOffset = Number(scales.byteOffset ?? 0);
+        const dv = new DataView(blob.buffer, blob.byteOffset + scaleOffset, scaleLen * 2);
+        scaleView = new Uint16Array(scaleLen);
+        for (let i = 0; i < scaleLen; i++) {
+            scaleView[i] = dv.getUint16(i * 2, true);
+        }
+    }
+    return {
+        version: 1,
+        modelId: String(sem?.modelId ?? ''),
+        dims: Number(sem?.dims ?? 0),
+        encoding: 'int8_l2norm',
+        perVectorScale: Boolean(sem?.perVectorScale),
+        vecs,
+        scales: scaleView,
+    };
+}
+async function resolveToBuffer(src) {
+    if (typeof src === 'string') {
+        try {
+            const res = await fetch(src);
+            return await res.arrayBuffer();
+        }
+        catch {
+            throw new Error('mountPack({src: string}) expects a URL in React Native. For local files, load bytes in your app and pass Uint8Array/ArrayBuffer.');
+        }
+    }
+    return toArrayBuffer(src);
+}
+export function toArrayBuffer(src) {
+    if (src instanceof Uint8Array) {
+        if (src.byteOffset === 0 && src.byteLength === src.buffer.byteLength) {
+            return src.buffer;
+        }
+        const copy = src.slice();
+        return copy.buffer;
+    }
+    return src;
+}

package/dist/query.d.ts

@@ -12,6 +12,11 @@ export type QueryOptions = {
         weight?: number;
         minTermLength?: number;
     };
+    graph?: {
+        expand?: boolean;
+        maxExtraTerms?: number;
+        predicates?: string[];
+    };
     semantic?: {
         enabled?: boolean;
         mode?: "rerank";

package/dist/query.js

@@ -14,6 +14,7 @@ import { minCoverSpan, proximityMultiplier } from "./quality/proximity.js";
 import { diversifyAndDedupe } from "./quality/diversify.js";
 import { knsSignature, knsDistance } from "./quality/signature.js";
 import { decodeScaleF16, quantizeEmbeddingInt8L2Norm } from "./semantic.js";
+import { expandQueryWithGraph } from "./graph/query_expand.js";
 export function validateQueryOptions(opts) {
     if (!opts)
         return;
@@ -46,6 +47,17 @@ export function validateQueryOptions(opts) {
             throw new Error("query(...): queryExpansion.minTermLength must be a positive integer.");
         }
     }
+    if (opts.graph) {
+        if (opts.graph.expand !== undefined && typeof opts.graph.expand !== "boolean") {
+            throw new Error("query(...): graph.expand must be a boolean when provided.");
+        }
+        if (opts.graph.maxExtraTerms !== undefined && (!Number.isInteger(opts.graph.maxExtraTerms) || opts.graph.maxExtraTerms < 1)) {
+            throw new Error("query(...): graph.maxExtraTerms must be a positive integer.");
+        }
+        if (opts.graph.predicates !== undefined && (!Array.isArray(opts.graph.predicates) || opts.graph.predicates.some((p) => typeof p !== "string"))) {
+            throw new Error("query(...): graph.predicates must be an array of strings when provided.");
+        }
+    }
     validateSemanticQueryOptions(opts.semantic);
 }
 export function validateSemanticQueryOptions(options) {
@@ -105,8 +117,14 @@ export function query(pack, q, opts = {}) {
         queryEmbedding: opts.semantic?.queryEmbedding,
         force: opts.semantic?.force ?? false,
     };
+    const graphQuery = opts.graph?.expand === true
+        ? expandQueryWithGraph(pack, q, {
+            maxExtraTerms: opts.graph?.maxExtraTerms,
+            predicates: opts.graph?.predicates,
+        })
+        : q;
     // --- Query parsing
-    const normTokens = tokenize(q).map((t) => t.term);
+    const normTokens = tokenize(graphQuery).map((t) => t.term);
     // Normalize quoted phrases from q
     const quotedRaw = parsePhrases(q);
     const quoted = quotedRaw.map((seq) => seq.map((t) => normalize(t)).flatMap((s) => s.split(/\s+/)).filter(Boolean));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knolo/core",
-  "version": "3.1.4",
+  "version": "3.2.1",
   "type": "module",
   "description": "Local-first knowledge packs for small LLMs.",
   "keywords": [
@@ -19,8 +19,14 @@
   ],
   "exports": {
     ".": {
+      "react-native": "./dist/index.js",
+      "browser": "./dist/index.js",
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./node": {
+      "import": "./dist/node.js",
+      "types": "./dist/node.d.ts"
     }
   },
   "sideEffects": false,
@@ -28,9 +34,10 @@
     "build": "tsc -p tsconfig.json",
     "prepublishOnly": "npm run build",
     "smoke": "node scripts/smoke.mjs",
-    "test": "npm run build && node scripts/test.mjs",
-    "format": "prettier --write src/agent.ts src/pack.ts src/builder.ts src/index.ts scripts/test.mjs ../../README.md",
-    "format:check": "prettier --check src/agent.ts src/pack.ts src/builder.ts src/index.ts scripts/test.mjs ../../README.md"
+    "test": "npm run build && node scripts/check-runtime-no-node.mjs && node scripts/test.mjs",
+    "format": "prettier --write src/agent.ts src/pack.ts src/pack.runtime.ts src/pack.node.ts src/node.ts src/builder.ts src/index.ts scripts/test.mjs scripts/check-runtime-no-node.mjs ../../README.md README.md",
+    "format:check": "prettier --check src/agent.ts src/pack.ts src/pack.runtime.ts src/pack.node.ts src/node.ts src/builder.ts src/index.ts scripts/test.mjs scripts/check-runtime-no-node.mjs ../../README.md README.md",
+    "check:runtime-no-node": "node scripts/check-runtime-no-node.mjs"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",