@zabaca/lattice 1.0.19 → 1.0.20

package/README.md

@@ -173,15 +173,6 @@ Show relationships for a node.
 lattice rels "TypeScript"       # Show all relationships for an entity
 ```
 
-### `lattice validate`
-
-Validate entity references and relationships.
-
-```bash
-lattice validate                # Check for broken references
-lattice validate --fix          # Attempt to fix validation issues
-```
-
 ### `lattice ontology`
 
 Display the derived ontology from your documents.
@@ -218,23 +209,12 @@ You can back up, copy, or version control this file like any other.
 
 ### Entity Extraction
 
-When you run `/graph-sync`, Claude Code extracts entities from your documents and writes them to YAML frontmatter. The Lattice CLI then syncs this to DuckDB.
-
-```yaml
----
-entities:
-  - name: React
-    type: technology
-    description: JavaScript library for building user interfaces
-
-relationships:
-  - source: React
-    target: Component Architecture
-    relation: REFERENCES
----
-```
+When you run `/graph-sync`, Claude Code extracts entities from your documents and writes them directly to the DuckDB database. No frontmatter required — your markdown files stay clean.
 
-You don't need to write this manually — Claude Code handles it automatically.
+The extraction identifies:
+- **Entities**: People, technologies, concepts, tools, etc.
+- **Relationships**: How entities connect to each other
+- **Document metadata**: Title, summary, topic classification
 
 ### Database Schema
 

package/dist/main.js

@@ -989,6 +989,29 @@ class GraphService {
       return [];
     }
   }
+  async findNodesWithMissingEmbeddings(labels) {
+    try {
+      const conn = await this.ensureConnected();
+      const labelFilter = labels.map((l) => `'${this.escape(l)}'`).join(", ");
+      const reader = await conn.runAndReadAll(`
+				SELECT label, name, properties->>'description' as description
+				FROM nodes
+				WHERE label IN (${labelFilter})
+				  AND embedding IS NULL
+			`);
+      return reader.getRows().map((row) => {
+        const [label, name, description] = row;
+        return {
+          label,
+          name,
+          description: description || undefined
+        };
+      });
+    } catch (error) {
+      this.logger.error(`Failed to find nodes with missing embeddings: ${error instanceof Error ? error.message : String(error)}`);
+      return [];
+    }
+  }
 }
 GraphService = __legacyDecorateClassTS([
   Injectable4(),
@@ -2305,6 +2328,10 @@ class SyncService {
       }
       if (!options.dryRun) {
         result.entityEmbeddingsGenerated = await this.syncEntities(uniqueEntities, options);
+        if (options.embeddings && !options.skipEmbeddings && this.embeddingService) {
+          const repairedCount = await this.repairMissingEntityEmbeddings(options);
+          result.entityEmbeddingsGenerated += repairedCount;
+        }
         await this.graph.checkpoint();
         if (options.verbose) {
           this.logger.log(`Synced ${uniqueEntities.size} entities, generated ${result.entityEmbeddingsGenerated} embeddings`);
@@ -2613,6 +2640,43 @@ class SyncService {
       }
     }
   }
+  async repairMissingEntityEmbeddings(options) {
+    if (!this.embeddingService) {
+      return 0;
+    }
+    const labelsToCheck = [...ENTITY_TYPES, "Document"];
+    const nodesWithMissingEmbeddings = await this.graph.findNodesWithMissingEmbeddings(labelsToCheck);
+    if (nodesWithMissingEmbeddings.length === 0) {
+      return 0;
+    }
+    if (options.verbose) {
+      this.logger.log(`Found ${nodesWithMissingEmbeddings.length} nodes with missing embeddings, repairing...`);
+    }
+    let repairedCount = 0;
+    for (const node of nodesWithMissingEmbeddings) {
+      try {
+        const text = node.label === "Document" ? node.name : composeEntityEmbeddingText({
+          type: node.label,
+          name: node.name,
+          description: node.description,
+          documentPaths: []
+        });
+        if (text.trim()) {
+          const embedding = await this.embeddingService.generateEmbedding(text);
+          await this.graph.updateNodeEmbedding(node.label, node.name, embedding);
+          repairedCount++;
+          this.logger.debug(`Repaired embedding for ${node.label}:${node.name}`);
+        }
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.logger.warn(`Failed to repair embedding for ${node.label}:${node.name}: ${errorMessage}`);
+      }
+    }
+    if (options.verbose && repairedCount > 0) {
+      this.logger.log(`Repaired ${repairedCount} missing embeddings`);
+    }
+    return repairedCount;
+  }
 }
 SyncService = __legacyDecorateClassTS([
   Injectable11(),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zabaca/lattice",
-	"version": "1.0.19",
+	"version": "1.0.20",
 	"description": "Human-initiated, AI-powered knowledge graph for markdown documentation",
 	"type": "module",
 	"bin": {