@zabaca/lattice 1.3.4 → 1.3.6

package/dist/main.js

@@ -20,7 +20,7 @@ import"reflect-metadata";
 import { CommandFactory } from "nest-commander";
 
 // src/app.module.ts
-import { Module as Module5 } from "@nestjs/common";
+import { Module as Module6 } from "@nestjs/common";
 import { ConfigModule as ConfigModule2 } from "@nestjs/config";
 
 // src/commands/extract.command.ts
@@ -3595,13 +3595,210 @@ ShareCommand = __legacyDecorateClassTS([
 ], ShareCommand);
 // src/commands/site.command.ts
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync8, readFileSync as readFileSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
-import * as path3 from "path";
-import { Injectable as Injectable18 } from "@nestjs/common";
+import { existsSync as existsSync8, readFileSync as readFileSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
+import * as path4 from "path";
+import { Injectable as Injectable19 } from "@nestjs/common";
 import { Command as Command8, CommandRunner as CommandRunner8, Option as Option5 } from "nest-commander";
+
+// src/site/site.module.ts
+import { Module as Module2 } from "@nestjs/common";
+
+// src/graph/graph.module.ts
+import { Module } from "@nestjs/common";
+class GraphModule {
+}
+GraphModule = __legacyDecorateClassTS([
+  Module({
+    providers: [GraphService],
+    exports: [GraphService]
+  })
+], GraphModule);
+
+// src/site/welcome-generator.service.ts
+import { writeFileSync as writeFileSync2 } from "fs";
+import * as path3 from "path";
+import { Injectable as Injectable18, Logger as Logger8 } from "@nestjs/common";
+class WelcomeGeneratorService {
+  graphService;
+  logger = new Logger8(WelcomeGeneratorService.name);
+  acronyms = new Set([
+    "ai",
+    "ml",
+    "api",
+    "llm",
+    "gpu",
+    "ui",
+    "ux",
+    "ci",
+    "cd",
+    "aws",
+    "gcp",
+    "seo",
+    "css",
+    "html",
+    "sql",
+    "cli",
+    "sdk",
+    "mcp"
+  ]);
+  constructor(graphService) {
+    this.graphService = graphService;
+  }
+  async generate() {
+    const topics = await this.fetchTopics();
+    const grouped = this.groupByDomain(topics);
+    const markdown = this.generateMarkdown(grouped, topics.length);
+    const docsPath = getDocsPath();
+    const welcomePath = path3.join(docsPath, "welcome.md");
+    writeFileSync2(welcomePath, markdown, "utf-8");
+    this.logger.log(`Generated welcome.md with ${topics.length} topics`);
+    return welcomePath;
+  }
+  async fetchTopics() {
+    const sql = `
+			SELECT
+				name,
+				properties->>'title' as title,
+				properties->>'summary' as summary,
+				properties->>'domain' as domain
+			FROM nodes
+			WHERE label = 'Document' AND name LIKE '%/README.md'
+			ORDER BY name
+		`;
+    const result = await this.graphService.query(sql);
+    const topics = [];
+    for (const row of result.resultSet) {
+      const [filePath, title, summary, domain] = row;
+      const slug = this.extractSlug(filePath);
+      if (!slug) {
+        this.logger.warn(`Could not extract slug from ${filePath}`);
+        continue;
+      }
+      topics.push({
+        slug,
+        title: title || this.formatSlugAsTitle(slug),
+        summary: summary || "",
+        domain: domain || "uncategorized"
+      });
+    }
+    return topics.sort((a, b) => a.slug.localeCompare(b.slug));
+  }
+  extractSlug(filePath) {
+    const match = filePath.match(/\/docs\/([^/]+)\/README\.md$/i);
+    return match ? match[1] : null;
+  }
+  formatSlugAsTitle(slug) {
+    return slug.split("-").map((word) => {
+      const lower = word.toLowerCase();
+      if (this.acronyms.has(lower)) {
+        return word.toUpperCase();
+      }
+      return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    }).join(" ");
+  }
+  groupByDomain(topics) {
+    const grouped = new Map;
+    for (const topic of topics) {
+      const domain = topic.domain;
+      if (!grouped.has(domain)) {
+        grouped.set(domain, []);
+      }
+      grouped.get(domain)?.push(topic);
+    }
+    return grouped;
+  }
+  formatDomain(domain) {
+    if (domain === "uncategorized") {
+      return "Uncategorized";
+    }
+    return domain.split("-").map((word) => {
+      const lower = word.toLowerCase();
+      if (this.acronyms.has(lower)) {
+        return word.toUpperCase();
+      }
+      return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    }).join(" ");
+  }
+  generateMarkdown(grouped, totalTopics) {
+    const currentDate = new Date().toISOString().split("T")[0];
+    const lines = [
+      "---",
+      `created: ${currentDate}`,
+      `updated: ${currentDate}`,
+      "status: ongoing",
+      "topic: welcome",
+      'summary: "Auto-generated index of all research topics organized by domain."',
+      "---",
+      "",
+      "# Research Directory",
+      "",
+      `Organized collection of ${totalTopics} research topics. This page is auto-generated from the knowledge graph.`,
+      ""
+    ];
+    const sortedDomains = Array.from(grouped.keys()).sort((a, b) => {
+      if (a === "uncategorized")
+        return 1;
+      if (b === "uncategorized")
+        return -1;
+      return this.formatDomain(a).localeCompare(this.formatDomain(b));
+    });
+    for (const domain of sortedDomains) {
+      const topics = grouped.get(domain);
+      if (!topics)
+        continue;
+      const displayDomain = this.formatDomain(domain);
+      lines.push(`## ${displayDomain}`);
+      lines.push("");
+      lines.push("| Topic | Description |");
+      lines.push("|-------|-------------|");
+      for (const topic of topics) {
+        const link = `./${topic.slug}/readme`;
+        const summary = this.truncateSummary(topic.summary, 100);
+        const escapedSummary = summary.replace(/\|/g, "\\|");
+        lines.push(`| [${topic.slug}](${link}) | ${escapedSummary} |`);
+      }
+      lines.push("");
+    }
+    lines.push("---");
+    lines.push(`*Auto-generated: ${currentDate}*`);
+    lines.push("");
+    return lines.join(`
+`);
+  }
+  truncateSummary(summary, maxLength) {
+    const cleaned = summary.replace(/\s+/g, " ").trim();
+    if (cleaned.length <= maxLength) {
+      return cleaned;
+    }
+    return `${cleaned.slice(0, maxLength - 3)}...`;
+  }
+}
+WelcomeGeneratorService = __legacyDecorateClassTS([
+  Injectable18(),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof GraphService === "undefined" ? Object : GraphService
+  ])
+], WelcomeGeneratorService);
+
+// src/site/site.module.ts
+class SiteModule {
+}
+SiteModule = __legacyDecorateClassTS([
+  Module2({
+    imports: [GraphModule],
+    providers: [WelcomeGeneratorService],
+    exports: [WelcomeGeneratorService]
+  })
+], SiteModule);
+// src/commands/site.command.ts
 class SiteCommand extends CommandRunner8 {
+  welcomeGenerator;
+  constructor(welcomeGenerator) {
+    super();
+    this.welcomeGenerator = welcomeGenerator;
+  }
   getPidFile() {
-    return path3.join(getLatticeHome(), "site.pid");
+    return path4.join(getLatticeHome(), "site.pid");
   }
   async run(_inputs, options) {
     if (options.kill) {
@@ -3609,8 +3806,8 @@ class SiteCommand extends CommandRunner8 {
       process.exit(0);
     }
     const latticeHome = getLatticeHome();
-    const packageJsonPath = path3.join(latticeHome, "package.json");
-    const nodeModulesPath = path3.join(latticeHome, "node_modules");
+    const packageJsonPath = path4.join(latticeHome, "package.json");
+    const nodeModulesPath = path4.join(latticeHome, "node_modules");
     if (!existsSync8(packageJsonPath)) {
       console.error("Error: Site not initialized. Run 'lattice init' first.");
       process.exit(1);
@@ -3625,6 +3822,14 @@ class SiteCommand extends CommandRunner8 {
       await this.runCommand("bun", ["install"], latticeHome);
       console.log();
     }
+    if (!options.noWelcome) {
+      console.log("\uD83D\uDCDD Generating welcome.md...");
+      try {
+        await this.welcomeGenerator.generate();
+      } catch (error) {
+        console.warn(`\u26A0\uFE0F  Warning: Failed to generate welcome.md: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
     if (options.build) {
       console.log("\uD83D\uDD28 Building site...");
       await this.runCommand("bun", ["run", "build"], latticeHome);
@@ -3678,7 +3883,7 @@ class SiteCommand extends CommandRunner8 {
         env: { ...process.env, FORCE_COLOR: "1" }
       });
       if (child.pid) {
-        writeFileSync2(this.getPidFile(), String(child.pid));
+        writeFileSync3(this.getPidFile(), String(child.pid));
       }
       const cleanup = () => {
         try {
@@ -3751,6 +3956,9 @@ class SiteCommand extends CommandRunner8 {
   parseKill() {
     return true;
   }
+  parseNoWelcome() {
+    return true;
+  }
 }
 __legacyDecorateClassTS([
   Option5({
@@ -3790,15 +3998,27 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:paramtypes", []),
   __legacyMetadataTS("design:returntype", Boolean)
 ], SiteCommand.prototype, "parseKill", null);
+__legacyDecorateClassTS([
+  Option5({
+    flags: "--no-welcome",
+    description: "Skip welcome.md generation"
+  }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", []),
+  __legacyMetadataTS("design:returntype", Boolean)
+], SiteCommand.prototype, "parseNoWelcome", null);
 SiteCommand = __legacyDecorateClassTS([
-  Injectable18(),
+  Injectable19(),
   Command8({
     name: "site",
     description: "Build and run the Lattice documentation site"
-  })
+  }),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof WelcomeGeneratorService === "undefined" ? Object : WelcomeGeneratorService
+  ])
 ], SiteCommand);
 // src/commands/status.command.ts
-import { Injectable as Injectable19 } from "@nestjs/common";
+import { Injectable as Injectable20 } from "@nestjs/common";
 import { Command as Command9, CommandRunner as CommandRunner9, Option as Option6 } from "nest-commander";
 class StatusCommand extends CommandRunner9 {
   syncService;
@@ -3875,7 +4095,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], StatusCommand.prototype, "parseVerbose", null);
 StatusCommand = __legacyDecorateClassTS([
-  Injectable19(),
+  Injectable20(),
   Command9({
     name: "status",
     description: "Show documents that need syncing (new or updated)"
@@ -3887,15 +4107,15 @@ StatusCommand = __legacyDecorateClassTS([
 ], StatusCommand);
 // src/commands/sync.command.ts
 import { watch } from "fs";
-import { join as join6 } from "path";
-import { Injectable as Injectable21 } from "@nestjs/common";
+import { join as join7 } from "path";
+import { Injectable as Injectable22 } from "@nestjs/common";
 import { Command as Command10, CommandRunner as CommandRunner10, Option as Option7 } from "nest-commander";
 
 // src/sync/graph-validator.service.ts
-import { Injectable as Injectable20, Logger as Logger8 } from "@nestjs/common";
+import { Injectable as Injectable21, Logger as Logger9 } from "@nestjs/common";
 class GraphValidatorService {
   graph;
-  logger = new Logger8(GraphValidatorService.name);
+  logger = new Logger9(GraphValidatorService.name);
   constructor(graph) {
     this.graph = graph;
   }
@@ -4011,15 +4231,15 @@ class GraphValidatorService {
       });
     }
   }
-  async validateDocument(path4) {
+  async validateDocument(path5) {
     const issues = [];
     try {
-      const result = await this.graph.query(`SELECT label, name, properties FROM nodes WHERE label = 'Document' AND name = '${this.escape(path4)}'`);
+      const result = await this.graph.query(`SELECT label, name, properties FROM nodes WHERE label = 'Document' AND name = '${this.escape(path5)}'`);
       if (result.resultSet.length === 0) {
         issues.push({
           type: "error",
           nodeLabel: "Document",
-          nodeName: path4,
+          nodeName: path5,
           field: "node",
           message: "Document not found in graph",
           suggestion: "Run 'lattice sync' to add this document"
@@ -4029,9 +4249,9 @@ class GraphValidatorService {
       const row = result.resultSet[0];
       const propertiesJson = row[2];
       const properties = typeof propertiesJson === "string" ? JSON.parse(propertiesJson) : propertiesJson;
-      this.validateDocumentNode(path4, properties, issues);
+      this.validateDocumentNode(path5, properties, issues);
     } catch (error) {
-      this.logger.error(`Failed to validate document ${path4}: ${error instanceof Error ? error.message : String(error)}`);
+      this.logger.error(`Failed to validate document ${path5}: ${error instanceof Error ? error.message : String(error)}`);
       throw error;
     }
     return issues;
@@ -4041,7 +4261,7 @@ class GraphValidatorService {
   }
 }
 GraphValidatorService = __legacyDecorateClassTS([
-  Injectable20(),
+  Injectable21(),
   __legacyMetadataTS("design:paramtypes", [
     typeof GraphService === "undefined" ? Object : GraphService
   ])
@@ -4191,7 +4411,7 @@ class SyncCommand extends CommandRunner10 {
 `);
     this.watcher = watch(docsPath, { recursive: true }, (event, filename) => {
       if (filename?.endsWith(".md")) {
-        const fullPath = join6(docsPath, filename);
+        const fullPath = join7(docsPath, filename);
         trackedFiles.add(fullPath);
         debouncedSync();
       }
@@ -4393,7 +4613,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseSkipExtraction", null);
 SyncCommand = __legacyDecorateClassTS([
-  Injectable21(),
+  Injectable22(),
   Command10({
     name: "sync",
     arguments: "[paths...]",
@@ -4406,37 +4626,26 @@ SyncCommand = __legacyDecorateClassTS([
   ])
 ], SyncCommand);
 // src/embedding/embedding.module.ts
-import { Module } from "@nestjs/common";
+import { Module as Module3 } from "@nestjs/common";
 import { ConfigModule } from "@nestjs/config";
 class EmbeddingModule {
 }
 EmbeddingModule = __legacyDecorateClassTS([
-  Module({
+  Module3({
     imports: [ConfigModule],
     providers: [EmbeddingService],
     exports: [EmbeddingService]
   })
 ], EmbeddingModule);
 
-// src/graph/graph.module.ts
-import { Module as Module2 } from "@nestjs/common";
-class GraphModule {
-}
-GraphModule = __legacyDecorateClassTS([
-  Module2({
-    providers: [GraphService],
-    exports: [GraphService]
-  })
-], GraphModule);
-
 // src/query/query.module.ts
-import { Module as Module3 } from "@nestjs/common";
+import { Module as Module4 } from "@nestjs/common";
 
 // src/query/query.service.ts
-import { Injectable as Injectable22, Logger as Logger9 } from "@nestjs/common";
+import { Injectable as Injectable23, Logger as Logger10 } from "@nestjs/common";
 class QueryService {
   graphService;
-  logger = new Logger9(QueryService.name);
+  logger = new Logger10(QueryService.name);
   constructor(graphService) {
     this.graphService = graphService;
   }
@@ -4446,7 +4655,7 @@ class QueryService {
   }
 }
 QueryService = __legacyDecorateClassTS([
-  Injectable22(),
+  Injectable23(),
   __legacyMetadataTS("design:paramtypes", [
     typeof GraphService === "undefined" ? Object : GraphService
   ])
@@ -4456,7 +4665,7 @@ QueryService = __legacyDecorateClassTS([
 class QueryModule {
 }
 QueryModule = __legacyDecorateClassTS([
-  Module3({
+  Module4({
     imports: [GraphModule, EmbeddingModule],
     providers: [QueryService, GraphService],
     exports: [QueryService, GraphService]
@@ -4464,11 +4673,11 @@ QueryModule = __legacyDecorateClassTS([
 ], QueryModule);
 
 // src/sync/sync.module.ts
-import { Module as Module4 } from "@nestjs/common";
+import { Module as Module5 } from "@nestjs/common";
 class SyncModule {
 }
 SyncModule = __legacyDecorateClassTS([
-  Module4({
+  Module5({
     imports: [GraphModule, EmbeddingModule],
     providers: [
       SyncService,
@@ -4499,7 +4708,7 @@ SyncModule = __legacyDecorateClassTS([
 class AppModule {
 }
 AppModule = __legacyDecorateClassTS([
-  Module5({
+  Module6({
     imports: [
       ConfigModule2.forRoot({
         isGlobal: true,
@@ -4508,7 +4717,8 @@ AppModule = __legacyDecorateClassTS([
       GraphModule,
       SyncModule,
       EmbeddingModule,
-      QueryModule
+      QueryModule,
+      SiteModule
     ],
     providers: [
       ExtractCommand,

package/package.json

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

package/site-template/public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Allow: /