@zabaca/lattice 1.0.5 → 1.0.7

package/dist/main.js

@@ -210,7 +210,7 @@ var RelationTypeSchema = z.enum(["REFERENCES"]);
 var EntitySchema = z.object({
   name: z.string().min(1),
   type: EntityTypeSchema,
-  description: z.string().optional()
+  description: z.string().min(1)
 });
 var RelationshipSchema = z.object({
   source: z.string().min(1),
@@ -375,7 +375,11 @@ class DocumentParserService {
         validEntities.push(result.data);
       } else {
         const entityPreview = typeof e === "string" ? `"${e}"` : JSON.stringify(e);
-        errors.push(`Entity[${i}]: ${entityPreview} - Expected object with {name, type}, got ${typeof e}`);
+        const zodErrors = result.error.issues.map((issue) => {
+          const path2 = issue.path.length > 0 ? issue.path.join(".") : "root";
+          return `${path2}: ${issue.message}`;
+        }).join("; ");
+        errors.push(`Entity[${i}]: ${entityPreview} - ${zodErrors}`);
       }
     }
     if (errors.length > 0) {
@@ -1586,6 +1590,38 @@ function collectUniqueEntities(docs) {
 // src/pure/validation.ts
 function validateDocuments(docs) {
   const errors = [];
+  for (const doc of docs) {
+    if (!doc.title || doc.title.trim() === "") {
+      errors.push({
+        path: doc.path,
+        error: "Missing required field: title"
+      });
+    }
+    if (!doc.summary || doc.summary.trim() === "") {
+      errors.push({
+        path: doc.path,
+        error: "Missing required field: summary"
+      });
+    }
+    if (!doc.created) {
+      errors.push({
+        path: doc.path,
+        error: "Missing required field: created"
+      });
+    }
+    if (!doc.updated) {
+      errors.push({
+        path: doc.path,
+        error: "Missing required field: updated"
+      });
+    }
+    if (!doc.status) {
+      errors.push({
+        path: doc.path,
+        error: "Missing required field: status"
+      });
+    }
+  }
   const entityIndex = new Map;
   for (const doc of docs) {
     for (const entity of doc.entities) {
@@ -2501,15 +2537,175 @@ StatusCommand = __legacyDecorateClassTS([
 // src/commands/sync.command.ts
 import { watch } from "fs";
 import { join as join3 } from "path";
-import { Injectable as Injectable13 } from "@nestjs/common";
+import { Injectable as Injectable14 } from "@nestjs/common";
 import { Command as Command5, CommandRunner as CommandRunner5, Option as Option4 } from "nest-commander";
+
+// src/sync/graph-validator.service.ts
+import { Injectable as Injectable13, Logger as Logger6 } from "@nestjs/common";
+class GraphValidatorService {
+  graph;
+  logger = new Logger6(GraphValidatorService.name);
+  constructor(graph) {
+    this.graph = graph;
+  }
+  async validateGraph() {
+    const issues = [];
+    let totalNodes = 0;
+    let documentsChecked = 0;
+    let entitiesChecked = 0;
+    try {
+      const result = await this.graph.query("SELECT label, name, properties FROM nodes");
+      totalNodes = result.resultSet.length;
+      for (const row of result.resultSet) {
+        const label = row[0];
+        const name = row[1];
+        const propertiesJson = row[2];
+        let properties;
+        try {
+          properties = typeof propertiesJson === "string" ? JSON.parse(propertiesJson) : propertiesJson;
+        } catch (_error) {
+          issues.push({
+            type: "error",
+            nodeLabel: label,
+            nodeName: name,
+            field: "properties",
+            message: "Invalid JSON in properties field",
+            suggestion: "Re-sync this document to fix corrupted data"
+          });
+          continue;
+        }
+        if (label === "Document") {
+          documentsChecked++;
+          this.validateDocumentNode(name, properties, issues);
+        } else {
+          entitiesChecked++;
+          this.validateEntityNode(label, name, properties, issues);
+        }
+      }
+    } catch (error) {
+      this.logger.error(`Graph validation failed: ${error instanceof Error ? error.message : String(error)}`);
+      throw error;
+    }
+    const errorsFound = issues.filter((i) => i.type === "error").length;
+    const warningsFound = issues.filter((i) => i.type === "warning").length;
+    return {
+      valid: errorsFound === 0,
+      issues,
+      stats: {
+        totalNodes,
+        documentsChecked,
+        entitiesChecked,
+        errorsFound,
+        warningsFound
+      }
+    };
+  }
+  validateDocumentNode(name, properties, issues) {
+    if ("name" in properties) {
+      issues.push({
+        type: "warning",
+        nodeLabel: "Document",
+        nodeName: name,
+        field: "name",
+        message: "Duplicate 'name' field in properties (already in column)",
+        suggestion: "Re-sync to remove duplicate"
+      });
+    }
+    const requiredFields = ["title", "contentHash"];
+    for (const field of requiredFields) {
+      if (!(field in properties)) {
+        issues.push({
+          type: "error",
+          nodeLabel: "Document",
+          nodeName: name,
+          field,
+          message: `Missing required field: ${field}`,
+          suggestion: "Re-sync this document to populate required fields"
+        });
+      }
+    }
+    const recommendedFields = ["summary", "created", "updated", "status"];
+    for (const field of recommendedFields) {
+      if (!(field in properties)) {
+        issues.push({
+          type: "warning",
+          nodeLabel: "Document",
+          nodeName: name,
+          field,
+          message: `Missing recommended field: ${field}`,
+          suggestion: `Add '${field}' to document frontmatter`
+        });
+      }
+    }
+  }
+  validateEntityNode(label, name, properties, issues) {
+    if ("name" in properties) {
+      issues.push({
+        type: "warning",
+        nodeLabel: label,
+        nodeName: name,
+        field: "name",
+        message: "Duplicate 'name' field in properties (already in column)",
+        suggestion: "Re-sync to remove duplicate"
+      });
+    }
+    if (!("description" in properties) || !properties.description) {
+      issues.push({
+        type: "error",
+        nodeLabel: label,
+        nodeName: name,
+        field: "description",
+        message: "Missing required field: description",
+        suggestion: `Add description to ${label} entity in frontmatter`
+      });
+    }
+  }
+  async validateDocument(path2) {
+    const issues = [];
+    try {
+      const result = await this.graph.query(`SELECT label, name, properties FROM nodes WHERE label = 'Document' AND name = '${this.escape(path2)}'`);
+      if (result.resultSet.length === 0) {
+        issues.push({
+          type: "error",
+          nodeLabel: "Document",
+          nodeName: path2,
+          field: "node",
+          message: "Document not found in graph",
+          suggestion: "Run 'lattice sync' to add this document"
+        });
+        return issues;
+      }
+      const row = result.resultSet[0];
+      const propertiesJson = row[2];
+      const properties = typeof propertiesJson === "string" ? JSON.parse(propertiesJson) : propertiesJson;
+      this.validateDocumentNode(path2, properties, issues);
+    } catch (error) {
+      this.logger.error(`Failed to validate document ${path2}: ${error instanceof Error ? error.message : String(error)}`);
+      throw error;
+    }
+    return issues;
+  }
+  escape(value) {
+    return value.replace(/'/g, "''");
+  }
+}
+GraphValidatorService = __legacyDecorateClassTS([
+  Injectable13(),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof GraphService === "undefined" ? Object : GraphService
+  ])
+], GraphValidatorService);
+
+// src/commands/sync.command.ts
 class SyncCommand extends CommandRunner5 {
   syncService;
+  _graphValidator;
   watcher = null;
   isShuttingDown = false;
-  constructor(syncService) {
+  constructor(syncService, _graphValidator) {
     super();
     this.syncService = syncService;
+    this._graphValidator = _graphValidator;
   }
   async run(paths, options) {
     if (options.watch && options.dryRun) {
@@ -2667,22 +2863,25 @@ class SyncCommand extends CommandRunner5 {
       });
     }
     if (result.changes && result.changes.length > 0) {
-      console.log(`
+      const actualChanges = result.changes.filter((c) => c.changeType !== "unchanged");
+      if (actualChanges.length > 0) {
+        console.log(`
 \uD83D\uDCDD Changes:
 `);
-      const icons = {
-        new: "\u2795",
-        updated: "\uD83D\uDD04",
-        deleted: "\uD83D\uDDD1\uFE0F",
-        unchanged: "\u23ED\uFE0F"
-      };
-      result.changes.forEach((c) => {
-        const icon = icons[c.changeType];
-        console.log(`  ${icon} ${c.changeType}: ${c.path}`);
-        if (c.reason) {
-          console.log(`     ${c.reason}`);
-        }
-      });
+        const icons = {
+          new: "\u2795",
+          updated: "\uD83D\uDD04",
+          deleted: "\uD83D\uDDD1\uFE0F",
+          unchanged: "\u23ED\uFE0F"
+        };
+        actualChanges.forEach((c) => {
+          const icon = icons[c.changeType];
+          console.log(`  ${icon} ${c.changeType}: ${c.path}`);
+          if (c.reason) {
+            console.log(`     ${c.reason}`);
+          }
+        });
+      }
     }
     if (result.cascadeWarnings && result.cascadeWarnings.length > 0) {
       console.log(`
@@ -2811,28 +3010,31 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseNoEmbeddings", null);
 SyncCommand = __legacyDecorateClassTS([
-  Injectable13(),
+  Injectable14(),
   Command5({
     name: "sync",
     arguments: "[paths...]",
     description: "Synchronize documents to the knowledge graph"
   }),
   __legacyMetadataTS("design:paramtypes", [
-    typeof SyncService === "undefined" ? Object : SyncService
+    typeof SyncService === "undefined" ? Object : SyncService,
+    typeof GraphValidatorService === "undefined" ? Object : GraphValidatorService
   ])
 ], SyncCommand);
 // src/commands/validate.command.ts
-import { Injectable as Injectable14 } from "@nestjs/common";
+import { Injectable as Injectable15 } from "@nestjs/common";
 import { Command as Command6, CommandRunner as CommandRunner6, Option as Option5 } from "nest-commander";
 class ValidateCommand extends CommandRunner6 {
   parserService;
-  constructor(parserService) {
+  _graphValidator;
+  constructor(parserService, _graphValidator) {
     super();
     this.parserService = parserService;
+    this._graphValidator = _graphValidator;
   }
   async run(_inputs, options) {
     try {
-      console.log(`Validating entities and relationships...
+      console.log(`=== Document Validation ===
 `);
       const { docs, errors: schemaErrors } = await this.parserService.parseAllDocumentsWithErrors();
       const issues = [];
@@ -2867,7 +3069,7 @@ class ValidateCommand extends CommandRunner6 {
       console.log(`Found ${entityIndex.size} unique entities
 `);
       if (issues.length > 0) {
-        console.log(`Errors (${issues.length}):
+        console.log(`Document Errors (${issues.length}):
 `);
         issues.forEach((i) => {
           console.log(`  ${i.path}`);
@@ -2877,11 +3079,32 @@ class ValidateCommand extends CommandRunner6 {
           }
           console.log("");
         });
+      } else {
+        console.log(`\u2713 Markdown files valid (schema + relationships)
+`);
       }
-      if (issues.length === 0) {
-        console.log("All validations passed!");
-      }
-      process.exit(issues.length > 0 ? 1 : 0);
+      const graphResult = {
+        valid: true,
+        issues: [],
+        stats: {
+          totalNodes: 0,
+          documentsChecked: 0,
+          entitiesChecked: 0,
+          errorsFound: 0,
+          warningsFound: 0
+        }
+      };
+      const totalErrors = issues.length + graphResult.stats.errorsFound;
+      const totalWarnings = graphResult.stats.warningsFound;
+      console.log(`
+=== Validation Summary ===`);
+      console.log(`Markdown files: ${issues.length === 0 ? "\u2713 PASSED" : `\u2717 ${issues.length} errors`}`);
+      console.log(`Graph database: ${graphResult.stats.errorsFound === 0 ? "\u2713 PASSED" : `\u2717 ${graphResult.stats.errorsFound} errors`}`);
+      console.log(`Warnings: ${totalWarnings}`);
+      console.log(`
+Overall: ${totalErrors === 0 ? "\u2713 PASSED" : "\u2717 FAILED"}${totalWarnings > 0 ? ` (${totalWarnings} warnings)` : ""}
+`);
+      process.exit(totalErrors > 0 ? 1 : 0);
     } catch (error) {
       console.error("Validation failed:", error instanceof Error ? error.message : String(error));
       process.exit(1);
@@ -2901,13 +3124,14 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], ValidateCommand.prototype, "parseFix", null);
 ValidateCommand = __legacyDecorateClassTS([
-  Injectable14(),
+  Injectable15(),
   Command6({
     name: "validate",
     description: "Validate entity references and relationships across documents"
   }),
   __legacyMetadataTS("design:paramtypes", [
-    typeof DocumentParserService === "undefined" ? Object : DocumentParserService
+    typeof DocumentParserService === "undefined" ? Object : DocumentParserService,
+    typeof GraphValidatorService === "undefined" ? Object : GraphValidatorService
   ])
 ], ValidateCommand);
 // src/embedding/embedding.module.ts
@@ -2938,10 +3162,10 @@ GraphModule = __legacyDecorateClassTS([
 import { Module as Module3 } from "@nestjs/common";
 
 // src/query/query.service.ts
-import { Injectable as Injectable15, Logger as Logger6 } from "@nestjs/common";
+import { Injectable as Injectable16, Logger as Logger7 } from "@nestjs/common";
 class QueryService {
   graphService;
-  logger = new Logger6(QueryService.name);
+  logger = new Logger7(QueryService.name);
   constructor(graphService) {
     this.graphService = graphService;
   }
@@ -2951,7 +3175,7 @@ class QueryService {
   }
 }
 QueryService = __legacyDecorateClassTS([
-  Injectable15(),
+  Injectable16(),
   __legacyMetadataTS("design:paramtypes", [
     typeof GraphService === "undefined" ? Object : GraphService
   ])
@@ -2981,7 +3205,8 @@ SyncModule = __legacyDecorateClassTS([
       DocumentParserService,
       OntologyService,
       CascadeService,
-      PathResolverService
+      PathResolverService,
+      GraphValidatorService
     ],
     exports: [
       SyncService,
@@ -2989,7 +3214,8 @@ SyncModule = __legacyDecorateClassTS([
       DocumentParserService,
       OntologyService,
       CascadeService,
-      PathResolverService
+      PathResolverService,
+      GraphValidatorService
     ]
   })
 ], SyncModule);

package/package.json

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