@zabaca/lattice 1.0.19 → 1.0.21

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

@@ -2036,6 +2036,11 @@ class DatabaseChangeDetectorService {
     this.hashCache.clear();
     this.loaded = false;
   }
+  clearEntries(paths) {
+    for (const path2 of paths) {
+      this.hashCache.delete(path2);
+    }
+  }
   getContentHash(content) {
     return createHash3("sha256").update(content).digest("hex");
   }
@@ -2213,30 +2218,30 @@ class SyncService {
       embeddingsGenerated: 0,
       entityEmbeddingsGenerated: 0
     };
-    const useDbDetection = options.legacy ? false : options.useDbChangeDetection ?? true;
-    const useAiExtraction = options.legacy ? false : options.aiExtraction ?? true;
+    const useAiExtraction = options.aiExtraction ?? true;
     try {
       await this.manifest.load();
-      if (useDbDetection) {
-        await this.dbChangeDetector.loadHashes();
-        if (options.verbose) {
-          this.logger.log(`v2 mode: Loaded ${this.dbChangeDetector.getCacheSize()} document hashes from database`);
-        }
+      await this.dbChangeDetector.loadHashes();
+      if (options.verbose) {
+        this.logger.log(`Loaded ${this.dbChangeDetector.getCacheSize()} document hashes from database`);
       }
       if (options.force) {
         if (options.paths && options.paths.length > 0) {
+          const normalizedPaths = this.pathResolver.resolveDocPaths(options.paths, { requireExists: true, requireInDocs: true });
           if (options.verbose) {
-            this.logger.log(`Force mode: marking ${options.paths.length} document(s) for re-sync`);
+            this.logger.log(`Force mode: marking ${normalizedPaths.length} document(s) for re-sync`);
           }
           await this.clearManifestEntries(options.paths);
+          this.dbChangeDetector.clearEntries(normalizedPaths);
         } else {
           if (options.verbose) {
-            this.logger.log("Force mode: clearing manifest to force full re-sync");
+            this.logger.log("Force mode: clearing tracking data to force full re-sync");
           }
           await this.clearManifest();
+          this.dbChangeDetector.reset();
         }
       }
-      const changes = await this.detectChanges(options.paths, useDbDetection);
+      const changes = await this.detectChanges(options.paths);
       result.changes = changes;
       const docsToSync = [];
       const docsByPath = new Map;
@@ -2352,7 +2357,7 @@ class SyncService {
     result.duration = Date.now() - startTime;
     return result;
   }
-  async detectChanges(paths, useDbDetection = false) {
+  async detectChanges(paths) {
     const changes = [];
     let allDocPaths = await this.parser.discoverDocuments();
     if (paths && paths.length > 0) {
@@ -2363,11 +2368,11 @@ class SyncService {
       const pathSet = new Set(normalizedPaths);
       allDocPaths = allDocPaths.filter((p) => pathSet.has(p));
     }
-    const trackedPaths = new Set(useDbDetection ? this.dbChangeDetector.getTrackedPaths() : this.manifest.getTrackedPaths());
+    const trackedPaths = new Set(this.dbChangeDetector.getTrackedPaths());
     for (const docPath of allDocPaths) {
       try {
         const doc = await this.parser.parseDocument(docPath);
-        const changeType = useDbDetection ? this.dbChangeDetector.detectChange(docPath, doc.contentHash) : this.manifest.detectChange(docPath, doc.contentHash, doc.frontmatterHash);
+        const changeType = this.dbChangeDetector.detectChange(docPath, doc.contentHash);
         changes.push({
           path: docPath,
           changeType,
@@ -2524,11 +2529,8 @@ class SyncService {
         change.embeddingGenerated = embeddingGenerated;
         const currentDoc = await this.parser.parseDocument(change.path);
         this.manifest.updateEntry(currentDoc.path, currentDoc.contentHash, currentDoc.frontmatterHash, currentDoc.entities.length, currentDoc.relationships.length);
-        const shouldUpdateDbHashes = options.legacy ? false : options.useDbChangeDetection ?? true;
-        if (shouldUpdateDbHashes) {
-          const embeddingSourceHash = embeddingGenerated ? currentDoc.contentHash : undefined;
-          await this.graph.updateDocumentHashes(currentDoc.path, currentDoc.contentHash, embeddingSourceHash);
-        }
+        const embeddingSourceHash = embeddingGenerated ? currentDoc.contentHash : undefined;
+        await this.graph.updateDocumentHashes(currentDoc.path, currentDoc.contentHash, embeddingSourceHash);
         break;
       }
       case "deleted": {
@@ -2679,7 +2681,6 @@ class MigrateCommand extends CommandRunner3 {
         if (!options.dryRun) {
           const result = await this.syncService.sync({
             force: false,
-            useDbChangeDetection: true,
             aiExtraction: true,
             verbose: options.verbose,
             embeddings: true
@@ -3118,23 +3119,16 @@ import { Injectable as Injectable16 } from "@nestjs/common";
 import { Command as Command6, CommandRunner as CommandRunner6, Option as Option4 } from "nest-commander";
 class StatusCommand extends CommandRunner6 {
   syncService;
-  manifestService;
   dbChangeDetector;
-  constructor(syncService, manifestService, dbChangeDetector) {
+  constructor(syncService, dbChangeDetector) {
     super();
     this.syncService = syncService;
-    this.manifestService = manifestService;
     this.dbChangeDetector = dbChangeDetector;
   }
   async run(_inputs, options) {
     try {
-      const useDbDetection = !options.legacy;
-      if (useDbDetection) {
-        await this.dbChangeDetector.loadHashes();
-      } else {
-        await this.manifestService.load();
-      }
-      const changes = await this.syncService.detectChanges(undefined, useDbDetection);
+      await this.dbChangeDetector.loadHashes();
+      const changes = await this.syncService.detectChanges();
       const newDocs = changes.filter((c) => c.changeType === "new");
       const updatedDocs = changes.filter((c) => c.changeType === "updated");
       const deletedDocs = changes.filter((c) => c.changeType === "deleted");
@@ -3187,9 +3181,6 @@ class StatusCommand extends CommandRunner6 {
   parseVerbose() {
     return true;
   }
-  parseLegacy() {
-    return true;
-  }
 }
 __legacyDecorateClassTS([
   Option4({
@@ -3200,15 +3191,6 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:paramtypes", []),
   __legacyMetadataTS("design:returntype", Boolean)
 ], StatusCommand.prototype, "parseVerbose", null);
-__legacyDecorateClassTS([
-  Option4({
-    flags: "--legacy",
-    description: "Use legacy v1 mode: manifest-based change detection"
-  }),
-  __legacyMetadataTS("design:type", Function),
-  __legacyMetadataTS("design:paramtypes", []),
-  __legacyMetadataTS("design:returntype", Boolean)
-], StatusCommand.prototype, "parseLegacy", null);
 StatusCommand = __legacyDecorateClassTS([
   Injectable16(),
   Command6({
@@ -3217,7 +3199,6 @@ StatusCommand = __legacyDecorateClassTS([
   }),
   __legacyMetadataTS("design:paramtypes", [
     typeof SyncService === "undefined" ? Object : SyncService,
-    typeof ManifestService === "undefined" ? Object : ManifestService,
     typeof DatabaseChangeDetectorService === "undefined" ? Object : DatabaseChangeDetectorService
   ])
 ], StatusCommand);
@@ -3422,7 +3403,6 @@ class SyncCommand extends CommandRunner7 {
       paths: paths.length > 0 ? paths : undefined,
       skipCascade: options.skipCascade,
       embeddings: options.embeddings !== false,
-      legacy: options.legacy,
       aiExtraction: !options.skipExtraction
     };
     console.log(`
@@ -3444,14 +3424,9 @@ class SyncCommand extends CommandRunner7 {
       console.log(`\uD83D\uDEAB Embedding generation disabled
 `);
     }
-    if (syncOptions.legacy) {
-      console.log(`\uD83D\uDCDC Legacy mode: Using manifest-based change detection
+    if (!syncOptions.aiExtraction) {
+      console.log(`\u23ED\uFE0F  AI entity extraction skipped (--skip-extraction)
 `);
-    } else {
-      if (!syncOptions.aiExtraction) {
-        console.log(`\u23ED\uFE0F  AI entity extraction skipped (--skip-extraction)
-`);
-      }
     }
     if (syncOptions.paths) {
       console.log(`\uD83D\uDCC1 Syncing specific paths: ${syncOptions.paths.join(", ")}
@@ -3649,9 +3624,6 @@ class SyncCommand extends CommandRunner7 {
   parseSkipExtraction() {
     return true;
   }
-  parseLegacy() {
-    return true;
-  }
 }
 __legacyDecorateClassTS([
   Option5({
@@ -3725,15 +3697,6 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:paramtypes", []),
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseSkipExtraction", null);
-__legacyDecorateClassTS([
-  Option5({
-    flags: "--legacy",
-    description: "Use legacy v1 mode: manifest-based change detection, no AI extraction"
-  }),
-  __legacyMetadataTS("design:type", Function),
-  __legacyMetadataTS("design:paramtypes", []),
-  __legacyMetadataTS("design:returntype", Boolean)
-], SyncCommand.prototype, "parseLegacy", null);
 SyncCommand = __legacyDecorateClassTS([
   Injectable18(),
   Command7({

package/package.json

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