@grackle-ai/knowledge 0.69.1 → 0.70.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -0
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# @grackle-ai/knowledge
|
|
2
|
+
|
|
3
|
+
Knowledge graph subsystem for [Grackle](https://github.com/nick-pape/grackle) — keeps AI agent context (tasks, findings, sessions, workspaces) synchronized into a Neo4j knowledge graph with vector embeddings for semantic search.
|
|
4
|
+
|
|
5
|
+
This package is the Grackle-specific integration layer on top of [`@grackle-ai/knowledge-core`](https://www.npmjs.com/package/@grackle-ai/knowledge-core). It re-exports the full core SDK (connection management, node/edge CRUD, ingestion pipeline, semantic search, graph traversal) and adds reference node synchronization — the glue that keeps the knowledge graph in sync with Grackle's relational database as entities are created, updated, and deleted.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @grackle-ai/knowledge
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Requires **Node.js >= 22** and a running [Neo4j](https://neo4j.com/) 5.x instance with vector index support. See the [`@grackle-ai/knowledge-core` README](https://www.npmjs.com/package/@grackle-ai/knowledge-core) for Neo4j setup instructions.
|
|
14
|
+
|
|
15
|
+
## How It Works
|
|
16
|
+
|
|
17
|
+
Grackle entities (tasks, findings, sessions, workspaces) live in SQLite. To make them semantically searchable and graph-connected, this package provides **reference node sync**: when an entity changes, a corresponding reference node in Neo4j is created or updated with a fresh embedding vector. This lets agents query the knowledge graph with natural language and discover related context across entity types.
|
|
18
|
+
|
|
19
|
+
The package also includes pure text-derivation helpers that produce consistent, embeddable text representations from entity data — ensuring that the same task or finding always generates the same embedding input format.
|
|
20
|
+
|
|
21
|
+
## Relationship to `@grackle-ai/knowledge-core`
|
|
22
|
+
|
|
23
|
+
| Package | Role |
|
|
24
|
+
|---------|------|
|
|
25
|
+
| `@grackle-ai/knowledge-core` | Domain-agnostic graph SDK — Neo4j client, embedders, chunkers, search, traversal. Standalone, no Grackle dependency. |
|
|
26
|
+
| `@grackle-ai/knowledge` | Grackle integration layer — re-exports the core SDK and adds entity-aware sync, lookup, and text derivation. |
|
|
27
|
+
|
|
28
|
+
If you are building on Grackle, use `@grackle-ai/knowledge` — it gives you the full core API plus Grackle-specific helpers in a single import. If you want a standalone knowledge graph library with no Grackle coupling, use `@grackle-ai/knowledge-core` directly.
|
|
29
|
+
|
|
30
|
+
## License
|
|
31
|
+
|
|
32
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@grackle-ai/knowledge",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.70.1",
|
|
4
4
|
"description": "Knowledge graph subsystem for Grackle (Neo4j + vector search)",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"dist/"
|
|
25
25
|
],
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"@grackle-ai/knowledge-core": "0.
|
|
27
|
+
"@grackle-ai/knowledge-core": "0.70.1"
|
|
28
28
|
},
|
|
29
29
|
"devDependencies": {
|
|
30
30
|
"@rushstack/heft": "1.2.7",
|