@zabaca/lattice 1.0.23 → 1.1.0

package/dist/main.js

@@ -406,95 +406,172 @@ function ensureLatticeHome() {
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = path.dirname(__filename2);
 var COMMANDS = ["research.md", "graph-sync.md", "entity-extract.md"];
+var SITE_TEMPLATE_FILES = [
+  "astro.config.ts",
+  "package.json",
+  "tsconfig.json",
+  "src/content.config.ts",
+  "src/collections/authors.ts",
+  "src/collections/documents.ts",
+  "src/collections/tags.ts"
+];
 
 class InitCommand extends CommandRunner2 {
   async run(_inputs, _options) {
     try {
       ensureLatticeHome();
+      const latticeHome = getLatticeHome();
       const envPath = getEnvPath();
       if (!existsSync3(envPath)) {
         writeFileSync(envPath, `# Lattice Configuration
 # Get your API key from: https://www.voyageai.com/
-
 VOYAGE_API_KEY=
+
+# Site Configuration (for lattice site command)
+SPACESHIP_AUTHOR="Lattice"
+SPACESHIP_BASE="/"
+SPACESHIP_SITE="https://example.com"
+SPACESHIP_TITLE="Lattice"
+SPACESHIP_DESCRIPTION="Research Knowledge Base"
+OBSIDIAN_VAULT_DIR=docs
+`);
+      } else {
+        const envContent = await fs.readFile(envPath, "utf-8");
+        if (!envContent.includes("SPACESHIP_")) {
+          await fs.appendFile(envPath, `
+# Site Configuration (for lattice site command)
+SPACESHIP_AUTHOR="Lattice"
+SPACESHIP_BASE="/"
+SPACESHIP_SITE="https://example.com"
+SPACESHIP_TITLE="Lattice"
+SPACESHIP_DESCRIPTION="Research Knowledge Base"
+OBSIDIAN_VAULT_DIR=docs
 `);
+          console.log("\u2705 Added site configuration to .env");
+        }
       }
-      console.log(`\u2705 Lattice home directory: ${getLatticeHome()}`);
+      console.log(`\u2705 Lattice home directory: ${latticeHome}`);
       console.log(`   Documents: ${getDocsPath()}`);
       console.log(`   Config:    ${envPath}`);
       console.log();
-      const targetDir = path.join(homedir2(), ".claude", "commands");
-      let commandsSourceDir = path.resolve(__dirname2, "..", "commands");
-      try {
-        await fs.access(commandsSourceDir);
-      } catch {
-        commandsSourceDir = path.resolve(__dirname2, "..", "..", "commands");
-      }
-      try {
-        await fs.access(commandsSourceDir);
-      } catch {
-        console.error("Error: Commands source directory not found at", commandsSourceDir);
-        console.error("This may indicate a corrupted installation. Try reinstalling @zabaca/lattice.");
-        process.exit(1);
-      }
-      await fs.mkdir(targetDir, { recursive: true });
-      let copied = 0;
-      let skipped = 0;
-      const installed = [];
-      for (const file of COMMANDS) {
-        const sourcePath = path.join(commandsSourceDir, file);
-        const targetPath = path.join(targetDir, file);
-        try {
-          await fs.access(sourcePath);
-          try {
-            await fs.access(targetPath);
-            const sourceContent = await fs.readFile(sourcePath, "utf-8");
-            const targetContent = await fs.readFile(targetPath, "utf-8");
-            if (sourceContent === targetContent) {
-              skipped++;
-              continue;
-            }
-          } catch {}
-          await fs.copyFile(sourcePath, targetPath);
-          installed.push(file);
-          copied++;
-        } catch (err) {
-          console.error(`Warning: Could not copy ${file}:`, err instanceof Error ? err.message : String(err));
-        }
-      }
-      console.log();
-      console.log(`\u2705 Lattice commands installed to ${targetDir}`);
+      await this.setupSiteTemplate(latticeHome);
+      await this.installClaudeCommands();
       console.log();
-      if (copied > 0) {
-        console.log(`Installed ${copied} command(s):`);
-        installed.forEach((f) => {
-          const name = f.replace(".md", "");
-          console.log(`  - /${name}`);
-        });
-      }
-      if (skipped > 0) {
-        console.log(`Skipped ${skipped} unchanged command(s)`);
-      }
+      console.log("Available commands:");
+      console.log("  lattice site         - Build and run the documentation site");
+      console.log("  lattice sync         - Sync documents to knowledge graph");
+      console.log("  lattice status       - Show documents needing sync");
+      console.log("  lattice search       - Semantic search across documents");
       console.log();
-      console.log("Available commands in Claude Code:");
+      console.log("Claude Code slash commands:");
       console.log("  /research <topic>    - AI-assisted research workflow");
       console.log("  /graph-sync          - Extract entities and sync to graph");
-      console.log("  /entity-extract      - Extract entities from a single document");
-      console.log();
-      console.log(`\u26A0\uFE0F  Add your Voyage API key to: ${getEnvPath()}`);
+      console.log("  /entity-extract      - Extract entities from a document");
       console.log();
+      if (!(await fs.readFile(envPath, "utf-8")).includes("pa-")) {
+        console.log(`\u26A0\uFE0F  Add your Voyage API key to: ${envPath}`);
+        console.log();
+      }
       process.exit(0);
     } catch (error) {
       console.error("Error:", error instanceof Error ? error.message : String(error));
       process.exit(1);
     }
   }
+  async setupSiteTemplate(latticeHome) {
+    let templateDir = path.resolve(__dirname2, "..", "site-template");
+    try {
+      await fs.access(templateDir);
+    } catch {
+      templateDir = path.resolve(__dirname2, "..", "..", "site-template");
+    }
+    try {
+      await fs.access(templateDir);
+    } catch {
+      console.log("\u26A0\uFE0F  Site template not found - skipping site setup");
+      return;
+    }
+    await fs.mkdir(path.join(latticeHome, "src", "collections"), {
+      recursive: true
+    });
+    let copied = 0;
+    let skipped = 0;
+    for (const file of SITE_TEMPLATE_FILES) {
+      const sourcePath = path.join(templateDir, file);
+      const targetPath = path.join(latticeHome, file);
+      try {
+        await fs.access(sourcePath);
+        try {
+          await fs.access(targetPath);
+          const sourceContent = await fs.readFile(sourcePath, "utf-8");
+          const targetContent = await fs.readFile(targetPath, "utf-8");
+          if (sourceContent === targetContent) {
+            skipped++;
+            continue;
+          }
+        } catch {}
+        await fs.mkdir(path.dirname(targetPath), { recursive: true });
+        await fs.copyFile(sourcePath, targetPath);
+        copied++;
+      } catch (err) {}
+    }
+    if (copied > 0) {
+      console.log(`\u2705 Site template: ${copied} file(s) installed`);
+    }
+    if (skipped > 0) {
+      console.log(`   Site template: ${skipped} file(s) unchanged`);
+    }
+  }
+  async installClaudeCommands() {
+    const targetDir = path.join(homedir2(), ".claude", "commands");
+    let commandsSourceDir = path.resolve(__dirname2, "..", "commands");
+    try {
+      await fs.access(commandsSourceDir);
+    } catch {
+      commandsSourceDir = path.resolve(__dirname2, "..", "..", "commands");
+    }
+    try {
+      await fs.access(commandsSourceDir);
+    } catch {
+      console.log("\u26A0\uFE0F  Claude commands not found - skipping");
+      return;
+    }
+    await fs.mkdir(targetDir, { recursive: true });
+    let copied = 0;
+    let skipped = 0;
+    const installed = [];
+    for (const file of COMMANDS) {
+      const sourcePath = path.join(commandsSourceDir, file);
+      const targetPath = path.join(targetDir, file);
+      try {
+        await fs.access(sourcePath);
+        try {
+          await fs.access(targetPath);
+          const sourceContent = await fs.readFile(sourcePath, "utf-8");
+          const targetContent = await fs.readFile(targetPath, "utf-8");
+          if (sourceContent === targetContent) {
+            skipped++;
+            continue;
+          }
+        } catch {}
+        await fs.copyFile(sourcePath, targetPath);
+        installed.push(file);
+        copied++;
+      } catch (err) {}
+    }
+    if (copied > 0) {
+      console.log(`\u2705 Claude commands: ${copied} installed to ${targetDir}`);
+    }
+    if (skipped > 0) {
+      console.log(`   Claude commands: ${skipped} unchanged`);
+    }
+  }
 }
 InitCommand = __legacyDecorateClassTS([
   Injectable3(),
   Command2({
     name: "init",
-    description: "Install Claude Code slash commands for Lattice"
+    description: "Initialize Lattice with Claude Code commands and site generator"
   })
 ], InitCommand);
 // src/commands/migrate.command.ts
@@ -3120,10 +3197,214 @@ SqlCommand = __legacyDecorateClassTS([
     typeof GraphService === "undefined" ? Object : GraphService
   ])
 ], SqlCommand);
-// src/commands/status.command.ts
+// src/commands/site.command.ts
+import { spawn } from "child_process";
+import { existsSync as existsSync6, readFileSync as readFileSync2, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
+import * as path2 from "path";
 import { Injectable as Injectable16 } from "@nestjs/common";
 import { Command as Command6, CommandRunner as CommandRunner6, Option as Option4 } from "nest-commander";
-class StatusCommand extends CommandRunner6 {
+class SiteCommand extends CommandRunner6 {
+  getPidFile() {
+    return path2.join(getLatticeHome(), "site.pid");
+  }
+  async run(_inputs, options) {
+    if (options.kill) {
+      this.killSiteProcess();
+      process.exit(0);
+    }
+    const latticeHome = getLatticeHome();
+    const packageJsonPath = path2.join(latticeHome, "package.json");
+    const nodeModulesPath = path2.join(latticeHome, "node_modules");
+    if (!existsSync6(packageJsonPath)) {
+      console.error("Error: Site not initialized. Run 'lattice init' first.");
+      process.exit(1);
+    }
+    if (this.isRunning()) {
+      console.error("Error: A Lattice site is already running.");
+      console.error("Use 'lattice site --kill' to stop it first.");
+      process.exit(1);
+    }
+    if (!existsSync6(nodeModulesPath)) {
+      console.log("\uD83D\uDCE6 Installing dependencies...");
+      await this.runCommand("bun", ["install"], latticeHome);
+      console.log();
+    }
+    if (options.build) {
+      console.log("\uD83D\uDD28 Building site...");
+      await this.runCommand("bun", ["run", "build"], latticeHome);
+      console.log(`
+\u2705 Build complete! Output in: ~/.lattice/dist/`);
+      process.exit(0);
+    }
+    if (options.dev) {
+      console.log("\uD83D\uDE80 Starting dev server...");
+      const port2 = options.port || "4321";
+      await this.runServerCommand("bun", ["run", "dev", "--", "--port", port2], latticeHome);
+      process.exit(0);
+    }
+    console.log("\uD83D\uDD28 Building site with search index...");
+    await this.runCommand("bun", ["run", "build"], latticeHome);
+    console.log(`
+\uD83D\uDE80 Starting preview server...`);
+    const port = options.port || "4321";
+    await this.runServerCommand("bun", ["run", "preview", "--", "--port", port], latticeHome);
+  }
+  runCommand(cmd, args, cwd) {
+    return new Promise((resolve4, reject) => {
+      const child = spawn(cmd, args, {
+        cwd,
+        stdio: "pipe",
+        env: { ...process.env, FORCE_COLOR: "1" }
+      });
+      child.stdout?.on("data", (data) => {
+        process.stdout.write(data);
+      });
+      child.stderr?.on("data", (data) => {
+        process.stderr.write(data);
+      });
+      child.on("close", (code) => {
+        if (code === 0) {
+          resolve4();
+        } else {
+          reject(new Error(`Command failed with code ${code}`));
+        }
+      });
+      child.on("error", (err) => {
+        reject(err);
+      });
+    });
+  }
+  runServerCommand(cmd, args, cwd) {
+    return new Promise((resolve4, reject) => {
+      const child = spawn(cmd, args, {
+        cwd,
+        stdio: "inherit",
+        env: { ...process.env, FORCE_COLOR: "1" }
+      });
+      if (child.pid) {
+        writeFileSync2(this.getPidFile(), String(child.pid));
+      }
+      const cleanup = () => {
+        try {
+          unlinkSync(this.getPidFile());
+        } catch {}
+      };
+      child.on("close", (code) => {
+        cleanup();
+        if (code === 0) {
+          resolve4();
+        } else {
+          reject(new Error(`Command failed with code ${code}`));
+        }
+      });
+      child.on("error", (err) => {
+        cleanup();
+        reject(err);
+      });
+      process.on("SIGINT", cleanup);
+      process.on("SIGTERM", cleanup);
+    });
+  }
+  isRunning() {
+    const pidFile = this.getPidFile();
+    if (!existsSync6(pidFile)) {
+      return false;
+    }
+    try {
+      const pid = parseInt(readFileSync2(pidFile, "utf-8").trim(), 10);
+      process.kill(pid, 0);
+      return true;
+    } catch {
+      try {
+        unlinkSync(pidFile);
+      } catch {}
+      return false;
+    }
+  }
+  killSiteProcess() {
+    const pidFile = this.getPidFile();
+    if (!existsSync6(pidFile)) {
+      console.log("No Lattice site process running");
+      return;
+    }
+    try {
+      const pid = parseInt(readFileSync2(pidFile, "utf-8").trim(), 10);
+      try {
+        process.kill(-pid, "SIGTERM");
+      } catch {
+        process.kill(pid, "SIGTERM");
+      }
+      unlinkSync(pidFile);
+      console.log(`\u2705 Killed Lattice site process (PID: ${pid})`);
+    } catch (err) {
+      try {
+        unlinkSync(pidFile);
+      } catch {}
+      console.log("No Lattice site process running");
+    }
+  }
+  parseBuild() {
+    return true;
+  }
+  parseDev() {
+    return true;
+  }
+  parsePort(val) {
+    return val;
+  }
+  parseKill() {
+    return true;
+  }
+}
+__legacyDecorateClassTS([
+  Option4({
+    flags: "-b, --build",
+    description: "Build the site without starting the server"
+  }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", []),
+  __legacyMetadataTS("design:returntype", Boolean)
+], SiteCommand.prototype, "parseBuild", null);
+__legacyDecorateClassTS([
+  Option4({
+    flags: "-d, --dev",
+    description: "Run in development mode (hot reload, no search)"
+  }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", []),
+  __legacyMetadataTS("design:returntype", Boolean)
+], SiteCommand.prototype, "parseDev", null);
+__legacyDecorateClassTS([
+  Option4({
+    flags: "-p, --port <port>",
+    description: "Port to run the server on (default: 4321)"
+  }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", [
+    String
+  ]),
+  __legacyMetadataTS("design:returntype", String)
+], SiteCommand.prototype, "parsePort", null);
+__legacyDecorateClassTS([
+  Option4({
+    flags: "-k, --kill",
+    description: "Kill the running Lattice site process"
+  }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", []),
+  __legacyMetadataTS("design:returntype", Boolean)
+], SiteCommand.prototype, "parseKill", null);
+SiteCommand = __legacyDecorateClassTS([
+  Injectable16(),
+  Command6({
+    name: "site",
+    description: "Build and run the Lattice documentation site"
+  })
+], SiteCommand);
+// src/commands/status.command.ts
+import { Injectable as Injectable17 } from "@nestjs/common";
+import { Command as Command7, CommandRunner as CommandRunner7, Option as Option5 } from "nest-commander";
+class StatusCommand extends CommandRunner7 {
   syncService;
   dbChangeDetector;
   constructor(syncService, dbChangeDetector) {
@@ -3189,7 +3470,7 @@ class StatusCommand extends CommandRunner6 {
   }
 }
 __legacyDecorateClassTS([
-  Option4({
+  Option5({
     flags: "-v, --verbose",
     description: "Show all documents including unchanged"
   }),
@@ -3198,8 +3479,8 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], StatusCommand.prototype, "parseVerbose", null);
 StatusCommand = __legacyDecorateClassTS([
-  Injectable16(),
-  Command6({
+  Injectable17(),
+  Command7({
     name: "status",
     description: "Show documents that need syncing (new or updated)"
   }),
@@ -3210,12 +3491,12 @@ StatusCommand = __legacyDecorateClassTS([
 ], StatusCommand);
 // src/commands/sync.command.ts
 import { watch } from "fs";
-import { join as join3 } from "path";
-import { Injectable as Injectable18 } from "@nestjs/common";
-import { Command as Command7, CommandRunner as CommandRunner7, Option as Option5 } from "nest-commander";
+import { join as join4 } from "path";
+import { Injectable as Injectable19 } from "@nestjs/common";
+import { Command as Command8, CommandRunner as CommandRunner8, Option as Option6 } from "nest-commander";
 
 // src/sync/graph-validator.service.ts
-import { Injectable as Injectable17, Logger as Logger9 } from "@nestjs/common";
+import { Injectable as Injectable18, Logger as Logger9 } from "@nestjs/common";
 class GraphValidatorService {
   graph;
   logger = new Logger9(GraphValidatorService.name);
@@ -3334,15 +3615,15 @@ class GraphValidatorService {
       });
     }
   }
-  async validateDocument(path2) {
+  async validateDocument(path3) {
     const issues = [];
     try {
-      const result = await this.graph.query(`SELECT label, name, properties FROM nodes WHERE label = 'Document' AND name = '${this.escape(path2)}'`);
+      const result = await this.graph.query(`SELECT label, name, properties FROM nodes WHERE label = 'Document' AND name = '${this.escape(path3)}'`);
       if (result.resultSet.length === 0) {
         issues.push({
           type: "error",
           nodeLabel: "Document",
-          nodeName: path2,
+          nodeName: path3,
           field: "node",
           message: "Document not found in graph",
           suggestion: "Run 'lattice sync' to add this document"
@@ -3352,9 +3633,9 @@ class GraphValidatorService {
       const row = result.resultSet[0];
       const propertiesJson = row[2];
       const properties = typeof propertiesJson === "string" ? JSON.parse(propertiesJson) : propertiesJson;
-      this.validateDocumentNode(path2, properties, issues);
+      this.validateDocumentNode(path3, properties, issues);
     } catch (error) {
-      this.logger.error(`Failed to validate document ${path2}: ${error instanceof Error ? error.message : String(error)}`);
+      this.logger.error(`Failed to validate document ${path3}: ${error instanceof Error ? error.message : String(error)}`);
       throw error;
     }
     return issues;
@@ -3364,14 +3645,14 @@ class GraphValidatorService {
   }
 }
 GraphValidatorService = __legacyDecorateClassTS([
-  Injectable17(),
+  Injectable18(),
   __legacyMetadataTS("design:paramtypes", [
     typeof GraphService === "undefined" ? Object : GraphService
   ])
 ], GraphValidatorService);
 
 // src/commands/sync.command.ts
-class SyncCommand extends CommandRunner7 {
+class SyncCommand extends CommandRunner8 {
   syncService;
   graphService;
   _graphValidator;
@@ -3514,7 +3795,7 @@ class SyncCommand extends CommandRunner7 {
 `);
     this.watcher = watch(docsPath, { recursive: true }, (event, filename) => {
       if (filename?.endsWith(".md")) {
-        const fullPath = join3(docsPath, filename);
+        const fullPath = join4(docsPath, filename);
         trackedFiles.add(fullPath);
         debouncedSync();
       }
@@ -3644,7 +3925,7 @@ class SyncCommand extends CommandRunner7 {
   }
 }
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "-f, --force",
     description: "Force re-sync specified documents (requires paths to be specified)"
   }),
@@ -3653,7 +3934,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseForce", null);
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "-d, --dry-run",
     description: "Show what would change without applying"
   }),
@@ -3662,7 +3943,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseDryRun", null);
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "-v, --verbose",
     description: "Show detailed output"
   }),
@@ -3671,7 +3952,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseVerbose", null);
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "-w, --watch",
     description: "Watch for file changes and sync automatically"
   }),
@@ -3680,7 +3961,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseWatch", null);
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "--diff",
     description: "Show only changed documents (alias for --dry-run)"
   }),
@@ -3689,7 +3970,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseDiff", null);
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "--skip-cascade",
     description: "Skip cascade analysis (faster for large repos)"
   }),
@@ -3698,7 +3979,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseSkipCascade", null);
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "--no-embeddings",
     description: "Disable embedding generation during sync"
   }),
@@ -3707,7 +3988,7 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseNoEmbeddings", null);
 __legacyDecorateClassTS([
-  Option5({
+  Option6({
     flags: "--skip-extraction",
     description: "Skip AI entity extraction (sync without re-extracting entities)"
   }),
@@ -3716,8 +3997,8 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", Boolean)
 ], SyncCommand.prototype, "parseSkipExtraction", null);
 SyncCommand = __legacyDecorateClassTS([
-  Injectable18(),
-  Command7({
+  Injectable19(),
+  Command8({
     name: "sync",
     arguments: "[paths...]",
     description: "Synchronize documents to the knowledge graph"
@@ -3756,7 +4037,7 @@ GraphModule = __legacyDecorateClassTS([
 import { Module as Module3 } from "@nestjs/common";
 
 // src/query/query.service.ts
-import { Injectable as Injectable19, Logger as Logger10 } from "@nestjs/common";
+import { Injectable as Injectable20, Logger as Logger10 } from "@nestjs/common";
 class QueryService {
   graphService;
   logger = new Logger10(QueryService.name);
@@ -3769,7 +4050,7 @@ class QueryService {
   }
 }
 QueryService = __legacyDecorateClassTS([
-  Injectable19(),
+  Injectable20(),
   __legacyMetadataTS("design:paramtypes", [
     typeof GraphService === "undefined" ? Object : GraphService
   ])
@@ -3842,7 +4123,8 @@ AppModule = __legacyDecorateClassTS([
       SqlCommand,
       OntologyCommand,
       InitCommand,
-      MigrateCommand
+      MigrateCommand,
+      SiteCommand
     ]
   })
 ], AppModule);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zabaca/lattice",
-	"version": "1.0.23",
+	"version": "1.1.0",
 	"description": "Human-initiated, AI-powered knowledge graph for markdown documentation",
 	"type": "module",
 	"bin": {
@@ -44,7 +44,7 @@
 	},
 	"dependencies": {
 		"@anthropic-ai/claude-agent-sdk": "^0.1.67",
-		"@duckdb/node-api": "1.4.3-r.1",
+		"@duckdb/node-api": "1.3.1-alpha.23",
 		"@nestjs/common": "^10.0.0",
 		"@nestjs/config": "^3.0.0",
 		"@nestjs/core": "^10.0.0",