@grackle-ai/knowledge 0.61.2 → 0.62.0

package/dist/index.d.ts

@@ -25,4 +25,6 @@ export type { CreateReferenceNodeInput, CreateNativeNodeInput, UpdateReferenceNo
 export { createEdge, removeEdge } from "./edge-store.js";
 export type { SearchOptions, SearchResult } from "./search.js";
 export { knowledgeSearch } from "./search.js";
+export { findReferenceNodeBySource, deleteReferenceNodeBySource, syncReferenceNode, deriveTaskText, deriveFindingText, } from "./reference-sync.js";
+export type { SyncReferenceNodeInput } from "./reference-sync.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -18,4 +18,5 @@ export { createTranscriptChunker } from "./transcript-chunker.js";
 export { createReferenceNode, createNativeNode, getNode, deleteNode, updateNode, recordToNode, } from "./node-store.js";
 export { createEdge, removeEdge } from "./edge-store.js";
 export { knowledgeSearch } from "./search.js";
+export { findReferenceNodeBySource, deleteReferenceNodeBySource, syncReferenceNode, deriveTaskText, deriveFindingText, } from "./reference-sync.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/reference-sync.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Reference node synchronization with Grackle entities.
+ *
+ * Provides lookup, upsert, and deletion of reference nodes keyed by
+ * `(sourceType, sourceId)`, plus pure text-derivation helpers for
+ * producing embeddable strings from entity data.
+ *
+ * The server-side event bus wiring that calls these functions is in #713.
+ *
+ * @module
+ */
+import { type ReferenceSource, type ReferenceNode } from "./types.js";
+import type { Embedder } from "./embedder.js";
+/** Input for syncing a reference node with a Grackle entity. */
+export interface SyncReferenceNodeInput {
+    /** Which entity type this refers to. */
+    sourceType: ReferenceSource;
+    /** The ID of the entity in Grackle's relational DB. */
+    sourceId: string;
+    /** Human-readable label derived from the source (e.g., task title). */
+    label: string;
+    /** Text content to derive the embedding from. */
+    text: string;
+    /** Workspace scope (empty string = global). */
+    workspaceId: string;
+}
+/**
+ * Find a reference node by its source identity.
+ *
+ * Uses the composite index on `(sourceType, sourceId)` for efficient lookup.
+ *
+ * @param sourceType - The entity type (task, finding, session, workspace).
+ * @param sourceId - The entity ID from Grackle's relational DB.
+ * @returns The reference node if found, or `undefined`.
+ */
+export declare function findReferenceNodeBySource(sourceType: ReferenceSource, sourceId: string): Promise<ReferenceNode | undefined>;
+/**
+ * Delete a reference node by its source identity.
+ *
+ * Removes the node and all its edges (`DETACH DELETE`). Used when the
+ * corresponding entity is deleted in Grackle's relational DB.
+ *
+ * @param sourceType - The entity type (task, finding, session, workspace).
+ * @param sourceId - The entity ID from Grackle's relational DB.
+ * @returns `true` if a node was deleted, `false` if no matching node existed.
+ */
+export declare function deleteReferenceNodeBySource(sourceType: ReferenceSource, sourceId: string): Promise<boolean>;
+/**
+ * Upsert a reference node for a Grackle entity.
+ *
+ * Derives an embedding from the provided text, then either creates a new
+ * reference node or updates the existing one (matched by sourceType + sourceId).
+ *
+ * @param embedder - The embedder to produce the embedding vector.
+ * @param input - The entity data to sync.
+ * @returns The node ID (either existing or newly created).
+ */
+export declare function syncReferenceNode(embedder: Embedder, input: SyncReferenceNodeInput): Promise<string>;
+/**
+ * Derive embeddable text from a task's title and description.
+ *
+ * @param title - The task title.
+ * @param description - The task description (may be empty).
+ * @returns A formatted text string suitable for embedding.
+ */
+export declare function deriveTaskText(title: string, description: string): string;
+/**
+ * Derive embeddable text from a finding's title, content, and tags.
+ *
+ * @param title - The finding title.
+ * @param content - The finding content.
+ * @param tags - Free-form tags for categorization.
+ * @returns A formatted text string suitable for embedding.
+ */
+export declare function deriveFindingText(title: string, content: string, tags: string[]): string;
+//# sourceMappingURL=reference-sync.d.ts.map

package/dist/reference-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-sync.d.ts","sourceRoot":"","sources":["../src/reference-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAO9C,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,UAAU,EAAE,eAAe,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAmBD;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,eAAe,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAoCpC;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,eAAe,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAMD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,GACb,MAAM,CASR"}

package/dist/reference-sync.js

@@ -0,0 +1,164 @@
+/**
+ * Reference node synchronization with Grackle entities.
+ *
+ * Provides lookup, upsert, and deletion of reference nodes keyed by
+ * `(sourceType, sourceId)`, plus pure text-derivation helpers for
+ * producing embeddable strings from entity data.
+ *
+ * The server-side event bus wiring that calls these functions is in #713.
+ *
+ * @module
+ */
+import { getSession } from "./client.js";
+import { logger } from "./logger.js";
+import { NODE_LABEL } from "./constants.js";
+import { isReferenceNode, } from "./types.js";
+import { createReferenceNode, updateNode, recordToNode } from "./node-store.js";
+// ---------------------------------------------------------------------------
+// Cypher queries
+// ---------------------------------------------------------------------------
+const FIND_BY_SOURCE_CYPHER = `
+  MATCH (n:${NODE_LABEL} {kind: 'reference', sourceType: $sourceType, sourceId: $sourceId})
+  RETURN n`;
+const DELETE_BY_SOURCE_CYPHER = `
+  MATCH (n:${NODE_LABEL} {kind: 'reference', sourceType: $sourceType, sourceId: $sourceId})
+  DETACH DELETE n
+  RETURN count(n) AS deleted`;
+// ---------------------------------------------------------------------------
+// Query functions
+// ---------------------------------------------------------------------------
+/**
+ * Find a reference node by its source identity.
+ *
+ * Uses the composite index on `(sourceType, sourceId)` for efficient lookup.
+ *
+ * @param sourceType - The entity type (task, finding, session, workspace).
+ * @param sourceId - The entity ID from Grackle's relational DB.
+ * @returns The reference node if found, or `undefined`.
+ */
+export async function findReferenceNodeBySource(sourceType, sourceId) {
+    const session = getSession();
+    try {
+        const result = await session.run(FIND_BY_SOURCE_CYPHER, {
+            sourceType,
+            sourceId,
+        });
+        if (result.records.length === 0) {
+            return undefined;
+        }
+        const neo4jNode = result.records[0].get("n");
+        const node = recordToNode(neo4jNode.properties);
+        if (!isReferenceNode(node)) {
+            logger.warn({ sourceType, sourceId, kind: node.kind }, "findReferenceNodeBySource matched a non-reference node");
+            return undefined;
+        }
+        return node;
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after findReferenceNodeBySource");
+        }
+    }
+}
+/**
+ * Delete a reference node by its source identity.
+ *
+ * Removes the node and all its edges (`DETACH DELETE`). Used when the
+ * corresponding entity is deleted in Grackle's relational DB.
+ *
+ * @param sourceType - The entity type (task, finding, session, workspace).
+ * @param sourceId - The entity ID from Grackle's relational DB.
+ * @returns `true` if a node was deleted, `false` if no matching node existed.
+ */
+export async function deleteReferenceNodeBySource(sourceType, sourceId) {
+    const session = getSession();
+    try {
+        const result = await session.run(DELETE_BY_SOURCE_CYPHER, {
+            sourceType,
+            sourceId,
+        });
+        const deleted = result.records[0]?.get("deleted");
+        if (deleted > 0) {
+            logger.debug({ sourceType, sourceId }, "Deleted reference node by source");
+        }
+        return deleted > 0;
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after deleteReferenceNodeBySource");
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Sync (upsert)
+// ---------------------------------------------------------------------------
+/**
+ * Upsert a reference node for a Grackle entity.
+ *
+ * Derives an embedding from the provided text, then either creates a new
+ * reference node or updates the existing one (matched by sourceType + sourceId).
+ *
+ * @param embedder - The embedder to produce the embedding vector.
+ * @param input - The entity data to sync.
+ * @returns The node ID (either existing or newly created).
+ */
+export async function syncReferenceNode(embedder, input) {
+    const { vector } = await embedder.embed(input.text);
+    const existing = await findReferenceNodeBySource(input.sourceType, input.sourceId);
+    if (existing) {
+        await updateNode(existing.id, { label: input.label, embedding: vector });
+        logger.debug({ nodeId: existing.id, sourceType: input.sourceType, sourceId: input.sourceId }, "Updated reference node");
+        return existing.id;
+    }
+    const newId = await createReferenceNode({
+        sourceType: input.sourceType,
+        sourceId: input.sourceId,
+        label: input.label,
+        embedding: vector,
+        workspaceId: input.workspaceId,
+    });
+    logger.debug({ nodeId: newId, sourceType: input.sourceType, sourceId: input.sourceId }, "Created reference node");
+    return newId;
+}
+// ---------------------------------------------------------------------------
+// Text derivation helpers (pure functions)
+// ---------------------------------------------------------------------------
+/**
+ * Derive embeddable text from a task's title and description.
+ *
+ * @param title - The task title.
+ * @param description - The task description (may be empty).
+ * @returns A formatted text string suitable for embedding.
+ */
+export function deriveTaskText(title, description) {
+    const parts = [`[Task] ${title}`];
+    if (description) {
+        parts.push(description);
+    }
+    return parts.join(" - ");
+}
+/**
+ * Derive embeddable text from a finding's title, content, and tags.
+ *
+ * @param title - The finding title.
+ * @param content - The finding content.
+ * @param tags - Free-form tags for categorization.
+ * @returns A formatted text string suitable for embedding.
+ */
+export function deriveFindingText(title, content, tags) {
+    const parts = [`[Finding] ${title}`];
+    if (content) {
+        parts.push(content);
+    }
+    if (tags.length > 0) {
+        parts.push(`tags:${tags.join(",")}`);
+    }
+    return parts.join(" - ");
+}
+//# sourceMappingURL=reference-sync.js.map

package/dist/reference-sync.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/knowledge",
-  "version": "0.61.2",
+  "version": "0.62.0",
   "description": "Knowledge graph subsystem for Grackle (Neo4j + vector search)",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "@huggingface/transformers": "^3.4.0",
     "neo4j-driver": "^6.0.1",
     "pino": "^10.3.1",
-    "@grackle-ai/common": "0.61.2"
+    "@grackle-ai/common": "0.62.0"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.4",