@sprig-and-prose/sprig 0.1.0

package/dist/ui.js

@@ -0,0 +1,293 @@
+import { createServer } from "node:http";
+import { readFileSync, existsSync, statSync } from "node:fs";
+import { join, extname, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import chokidar from "chokidar";
+import { loadProseFiles } from "./prose.js";
+import { compileUniverse } from "./compiler.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const mimeTypes = {
+    ".html": "text/html",
+    ".js": "application/javascript",
+    ".json": "application/json",
+    ".css": "text/css",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".eot": "application/vnd.ms-fontobject",
+};
+/**
+ * Resolves the dist directory path for sprig-ui-csr
+ */
+function resolveUIDist() {
+    // Try to resolve from node_modules
+    try {
+        // First, try to import the package and check for an export
+        // If that doesn't work, resolve from node_modules
+        const packagePath = resolve(__dirname, "../node_modules/@sprig-and-prose/sprig-ui-csr");
+        const distPath = join(packagePath, "dist");
+        if (existsSync(distPath)) {
+            return distPath;
+        }
+    }
+    catch {
+        // Fall through to error
+    }
+    // Fallback: try relative to current package
+    const fallbackPath = resolve(__dirname, "../../sprig-ui-csr/dist");
+    if (existsSync(fallbackPath)) {
+        return fallbackPath;
+    }
+    throw new Error("Could not locate sprig-ui-csr dist directory");
+}
+let revisionCounter = 0;
+const sseClients = new Set();
+/**
+ * Broadcasts a manifest changed event to all connected clients
+ */
+function broadcastManifestChanged() {
+    revisionCounter += 1;
+    const message = `id: ${revisionCounter}\nevent: manifest\ndata: ${JSON.stringify({ revision: revisionCounter })}\n\n`;
+    console.log(`Broadcasting manifest change (revision ${revisionCounter}) to ${sseClients.size} client(s)`);
+    for (const res of sseClients) {
+        try {
+            res.write(message);
+        }
+        catch (error) {
+            // Client disconnected, remove it
+            console.log(`Client disconnected, removing from set`);
+            sseClients.delete(res);
+        }
+    }
+}
+/**
+ * Creates the HTTP server
+ */
+function createServerHandler(uiDistDir, manifestPath) {
+    return (req, res) => {
+        const url = new URL(req.url || "/", `http://${req.headers.host}`);
+        const pathname = url.pathname;
+        // Handle /_ui/* routes - serve static files from dist/
+        if (pathname.startsWith("/_ui/")) {
+            const filePath = pathname.slice(5); // Remove '/_ui/'
+            const fullPath = join(uiDistDir, filePath);
+            // Security: ensure file is within dist directory
+            const resolvedPath = resolve(fullPath);
+            if (!resolvedPath.startsWith(resolve(uiDistDir))) {
+                res.writeHead(403, { "Content-Type": "text/plain" });
+                res.end("Forbidden");
+                return;
+            }
+            if (!existsSync(resolvedPath) || !statSync(resolvedPath).isFile()) {
+                res.writeHead(404, { "Content-Type": "text/plain" });
+                res.end("Not Found");
+                return;
+            }
+            try {
+                const content = readFileSync(resolvedPath);
+                const ext = extname(resolvedPath);
+                const contentType = mimeTypes[ext] || "application/octet-stream";
+                res.writeHead(200, { "Content-Type": contentType });
+                res.end(content);
+            }
+            catch {
+                res.writeHead(500, { "Content-Type": "text/plain" });
+                res.end("Internal Server Error");
+            }
+            return;
+        }
+        // Handle /api/manifest route
+        if (pathname === "/api/manifest") {
+            if (!existsSync(manifestPath) || !statSync(manifestPath).isFile()) {
+                res.writeHead(404, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Manifest not found" }));
+                return;
+            }
+            try {
+                const content = readFileSync(manifestPath, "utf-8");
+                const headers = {
+                    "Content-Type": "application/json",
+                };
+                res.writeHead(200, headers);
+                res.end(content);
+            }
+            catch {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Error reading manifest" }));
+            }
+            return;
+        }
+        // Handle /api/events route - Server-Sent Events
+        if (pathname === "/api/events") {
+            res.writeHead(200, {
+                "Content-Type": "text/event-stream",
+                "Cache-Control": "no-cache",
+                Connection: "keep-alive",
+                "X-Accel-Buffering": "no",
+            });
+            // Send initial connection comment
+            res.write(": connected\n\n");
+            sseClients.add(res);
+            console.log(`SSE client connected (total: ${sseClients.size})`);
+            // Handle client disconnect
+            const cleanup = () => {
+                sseClients.delete(res);
+                console.log(`SSE client disconnected (remaining: ${sseClients.size})`);
+            };
+            req.on("close", cleanup);
+            res.on("close", cleanup);
+            return;
+        }
+        // All other routes - serve index.html for client-side routing
+        const indexPath = join(uiDistDir, "index.html");
+        if (!existsSync(indexPath)) {
+            res.writeHead(404, { "Content-Type": "text/plain" });
+            res.end("Not Found - dist/index.html does not exist.");
+            return;
+        }
+        try {
+            const content = readFileSync(indexPath, "utf-8");
+            res.writeHead(200, { "Content-Type": "text/html" });
+            res.end(content);
+        }
+        catch {
+            res.writeHead(500, { "Content-Type": "text/plain" });
+            res.end("Internal Server Error");
+        }
+    };
+}
+/**
+ * Rebuilds the manifest and broadcasts SSE event
+ * Only broadcasts after successful compile and atomic manifest write
+ */
+async function rebuildManifest(universeRoot, manifestPath) {
+    try {
+        const files = await loadProseFiles(universeRoot);
+        const result = await compileUniverse(universeRoot, files, true);
+        // Only broadcast if compilation succeeded (manifest was atomically written)
+        if (result.success) {
+            broadcastManifestChanged();
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Starts the UI server with watch mode
+ */
+export async function startUIServer(universeRoot, port = 6336) {
+    const uiDistDir = resolveUIDist();
+    const manifestPath = join(universeRoot, ".sprig", "manifest.json");
+    // Compile once on startup
+    console.log("Compiling universe...");
+    const files = await loadProseFiles(universeRoot);
+    const result = await compileUniverse(universeRoot, files, true);
+    if (!result.success) {
+        const errors = result.diagnostics.filter((d) => d.severity === "error");
+        if (errors.length > 0) {
+            for (const error of errors) {
+                console.error(`Error: ${error.message}`);
+            }
+        }
+        process.exit(1);
+    }
+    console.log("✓ Universe compiled");
+    // Create HTTP server
+    const server = createServer(createServerHandler(uiDistDir, manifestPath));
+    server.on("error", (error) => {
+        if (error.code === "EADDRINUSE") {
+            console.error("");
+            console.error("Couldn't start the UI server.");
+            console.error("");
+            console.error(`Port ${port} is already in use.`);
+            process.exit(1);
+        }
+        else {
+            throw error;
+        }
+    });
+    server.listen(port, () => {
+        console.log(`Server running at http://localhost:${port}`);
+    });
+    // Set up heartbeat for SSE connections (every 25 seconds)
+    const heartbeatInterval = setInterval(() => {
+        for (const res of sseClients) {
+            try {
+                res.write(": ping\n\n");
+            }
+            catch {
+                // Client disconnected, remove it
+                sseClients.delete(res);
+            }
+        }
+    }, 25000);
+    // Set up file watching with debounce
+    let rebuildTimeout = null;
+    const DEBOUNCE_MS = 200;
+    const watcher = chokidar.watch(join(universeRoot, "**/*.prose"), {
+        ignored: [
+            join(universeRoot, ".sprig/**"),
+            join(universeRoot, "dist/**"),
+            join(universeRoot, "node_modules/**"),
+            join(universeRoot, ".git/**"),
+        ],
+        persistent: true,
+    });
+    watcher.on("change", () => {
+        if (rebuildTimeout) {
+            clearTimeout(rebuildTimeout);
+        }
+        rebuildTimeout = setTimeout(async () => {
+            const success = await rebuildManifest(universeRoot, manifestPath);
+            if (success) {
+                // One-line status per rebuild (calm output)
+                process.stdout.write("\r✓ Rebuilt\n");
+            }
+            else {
+                process.stdout.write("\r✗ Rebuild failed\n");
+            }
+        }, DEBOUNCE_MS);
+    });
+    // Handle graceful shutdown
+    function shutdown() {
+        // Clear heartbeat interval
+        clearInterval(heartbeatInterval);
+        // Clear any pending rebuild timeout
+        if (rebuildTimeout) {
+            clearTimeout(rebuildTimeout);
+        }
+        // Close all SSE connections
+        for (const res of sseClients) {
+            try {
+                res.end();
+            }
+            catch {
+                // Ignore errors on already closed connections
+            }
+        }
+        sseClients.clear();
+        // Close file watcher
+        watcher.close();
+        // Close server
+        server.close(() => {
+            process.exit(0);
+        });
+        // Force exit after 2 seconds if server doesn't close cleanly
+        setTimeout(() => {
+            console.error("Forcing exit...");
+            process.exit(1);
+        }, 2000);
+    }
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@sprig-and-prose/sprig",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Sprig CLI tool for compiling and serving universes",
+  "main": "dist/cli.js",
+  "bin": {
+    "sprig": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "node --test",
+    "format": "biome format . --write",
+    "lint": "biome lint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@sprig-and-prose/sprig-universe": "^0.1.1",
+    "@sprig-and-prose/sprig-ui-csr": "^0.1.1",
+    "chokidar": "^3.6.0",
+    "fast-glob": "^3.3.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.2"
+  }
+}
+

package/src/cli.ts

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+
+import { resolve } from "node:path";
+import { discoverUniverseRoot } from "./root.js";
+import { loadProseFiles } from "./prose.js";
+import { compileUniverse } from "./compiler.js";
+import { startUIServer } from "./ui.js";
+
+const commands = ["compile", "validate", "ui"] as const;
+type Command = (typeof commands)[number];
+
+function printHelp() {
+  console.log("Usage: sprig <command> [path?] [options]");
+  console.log("");
+  console.log("Commands:");
+  console.log("  compile    Compile universe files to manifest");
+  console.log("  validate   Validate universe files (no output)");
+  console.log("  ui         Start UI server with watch mode");
+  console.log("");
+  console.log("Options (for ui command):");
+  console.log("  -p, --port <number>  Port to listen on (default: 6336)");
+  console.log("");
+  console.log("Root discovery:");
+  console.log("  - Walks upward from provided path (or current directory)");
+  console.log("  - Finds directory containing universe.prose");
+}
+
+function parseArgs(): {
+  command: Command | null;
+  path: string;
+  port?: number;
+} {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+    return { command: null, path: process.cwd() };
+  }
+
+  const command = args[0] as Command;
+  if (!commands.includes(command)) {
+    console.error(`Error: Unknown command "${command}"`);
+    console.error("Run 'sprig --help' for usage information");
+    process.exit(1);
+  }
+
+  // Parse path and options
+  let path = process.cwd();
+  let port: number | undefined;
+
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--port" || arg === "-p") {
+      const portValue = args[i + 1];
+      if (!portValue) {
+        console.error("Error: --port requires a value");
+        process.exit(1);
+      }
+      const parsedPort = parseInt(portValue, 10);
+      if (isNaN(parsedPort) || parsedPort < 1 || parsedPort > 65535) {
+        console.error("Error: --port must be a number between 1 and 65535");
+        process.exit(1);
+      }
+      port = parsedPort;
+      i++; // Skip the port value
+    } else if (!arg.startsWith("-")) {
+      // First non-option argument is the path
+      path = resolve(arg);
+    } else {
+      console.error(`Error: Unknown option "${arg}"`);
+      console.error("Run 'sprig --help' for usage information");
+      process.exit(1);
+    }
+  }
+
+  return { command, path, port };
+}
+
+async function handleCompile(path: string): Promise<void> {
+  const root = discoverUniverseRoot(path);
+  if (!root) {
+    console.error("Couldn't find universe.prose");
+    console.error("");
+    console.error("Make sure you're inside a universe repository.");
+    process.exit(1);
+  }
+
+  const files = await loadProseFiles(root);
+  const result = await compileUniverse(root, files, true);
+
+  if (!result.success) {
+    const errors = result.diagnostics.filter((d) => d.severity === "error");
+    if (errors.length > 0) {
+      for (const error of errors) {
+        console.error(`Error: ${error.message}`);
+      }
+    }
+    process.exit(1);
+  }
+
+  const warnings = result.diagnostics.filter((d) => d.severity === "warning");
+  if (warnings.length > 0) {
+    for (const warning of warnings) {
+      const source = warning.source
+        ? // @ts-expect-error - source structure may vary
+          `${warning.source.file}:${warning.source.start?.line}:${warning.source.start?.col}`
+        : "unknown location";
+      console.warn(`Warning: ${source}: ${warning.message}`);
+    }
+  }
+}
+
+async function handleValidate(path: string): Promise<void> {
+  const root = discoverUniverseRoot(path);
+  if (!root) {
+    console.error("Couldn't find universe.prose");
+    console.error("");
+    console.error("Make sure you're inside a universe repository.");
+    process.exit(1);
+  }
+
+  const files = await loadProseFiles(root);
+  const result = await compileUniverse(root, files, false);
+
+  if (!result.success) {
+    const errors = result.diagnostics.filter((d) => d.severity === "error");
+    if (errors.length > 0) {
+      for (const error of errors) {
+        console.error(`Error: ${error.message}`);
+      }
+    }
+    process.exit(1);
+  }
+
+  const warnings = result.diagnostics.filter((d) => d.severity === "warning");
+  if (warnings.length > 0) {
+    for (const warning of warnings) {
+      const source = warning.source
+        ? // @ts-expect-error - source structure may vary
+          `${warning.source.file}:${warning.source.start?.line}:${warning.source.start?.col}`
+        : "unknown location";
+      console.warn(`Warning: ${source}: ${warning.message}`);
+    }
+  }
+}
+
+async function handleUI(path: string, port?: number): Promise<void> {
+  const root = discoverUniverseRoot(path);
+  if (!root) {
+    console.error("Couldn't find universe.prose");
+    console.error("");
+    console.error("Make sure you're inside a universe repository.");
+    process.exit(1);
+  }
+
+  await startUIServer(root, port);
+}
+
+async function main() {
+  const { command, path, port } = parseArgs();
+
+  if (!command) {
+    printHelp();
+    process.exit(0);
+  }
+
+  try {
+    switch (command) {
+      case "compile":
+        await handleCompile(path);
+        break;
+      case "validate":
+        await handleValidate(path);
+        break;
+      case "ui":
+        await handleUI(path, port);
+        break;
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${message}`);
+    process.exit(1);
+  }
+}
+
+main();
+

package/src/compiler.ts

@@ -0,0 +1,142 @@
+import { readFileSync, writeFileSync, mkdirSync, renameSync } from "node:fs";
+import { join, dirname } from "node:path";
+// @ts-expect-error - sprig-universe doesn't have TypeScript types
+import { parseFiles } from "@sprig-and-prose/sprig-universe";
+
+export interface CompileResult {
+  success: boolean;
+  manifest?: Record<string, unknown> & { repositories?: Record<string, unknown>; generatedAt: string };
+  diagnostics: Array<{ severity: string; message: string; source?: unknown }>;
+}
+
+/**
+ * Validates that exactly one universe declaration exists in the parsed graph
+ */
+function validateUniverseCount(graph: Record<string, unknown>): {
+  valid: boolean;
+  universeName?: string;
+  error?: string;
+} {
+  const universes = graph.universes as Record<string, unknown> | undefined;
+  const universeNames = Object.keys(universes || {});
+
+  if (universeNames.length === 0) {
+    return {
+      valid: false,
+      error: "No universe declaration found. At least one universe declaration is required.",
+    };
+  }
+
+  if (universeNames.length > 1) {
+    const nodes = graph.nodes as Record<string, { source?: { file?: string } }> | undefined;
+    const fileList = Array.from(universeNames)
+      .map((name) => {
+        const universe = universes?.[name] as { root?: string } | undefined;
+        const rootNode = universe?.root && nodes ? nodes[universe.root] : null;
+        return rootNode?.source?.file || "unknown";
+      })
+      .filter((file, index, arr) => arr.indexOf(file) === index) // unique files
+      .sort()
+      .join(", ");
+    return {
+      valid: false,
+      error: `Multiple distinct universes found: ${universeNames.join(", ")}. Files: ${fileList}. Exactly one universe declaration is required.`,
+    };
+  }
+
+  return {
+    valid: true,
+    universeName: universeNames[0],
+  };
+}
+
+/**
+ * Compiles prose files into a manifest
+ * @param universeRoot - Universe root directory
+ * @param files - Array of prose file paths
+ * @param writeManifest - If true, write manifest to disk
+ * @returns Compile result with success status, manifest, and diagnostics
+ */
+export async function compileUniverse(
+  universeRoot: string,
+  files: string[],
+  writeManifest = true,
+): Promise<CompileResult> {
+  const manifestPath = join(universeRoot, ".sprig", "manifest.json");
+
+  // Read and parse files
+  const fileContents = files.map((file) => ({
+    file,
+    text: readFileSync(file, "utf-8"),
+  }));
+
+  try {
+    const graph = parseFiles(fileContents);
+
+    // Validate exactly one universe
+    const validation = validateUniverseCount(graph);
+    if (!validation.valid) {
+      return {
+        success: false,
+        diagnostics: [
+          {
+            severity: "error",
+            message: validation.error || "Unknown validation error",
+          },
+        ],
+      };
+    }
+
+    // Add repositories and metadata to manifest
+    const manifest = {
+      ...graph,
+      repositories: graph.repositories || {},
+      generatedAt: new Date().toISOString(),
+    };
+
+    // Check for parsing errors
+    const hasErrors = graph.diagnostics.some((d: { severity: string }) => d.severity === "error");
+    if (hasErrors) {
+      return {
+        success: false,
+        manifest,
+        diagnostics: graph.diagnostics,
+      };
+    }
+
+    // Write manifest if requested
+    if (writeManifest) {
+      // Ensure output directory exists
+      const manifestDir = dirname(manifestPath);
+      try {
+        mkdirSync(manifestDir, { recursive: true });
+      } catch (error) {
+        // Directory might already exist, ignore
+      }
+
+      // Write atomically (temp file + rename)
+      const tempPath = `${manifestPath}.tmp`;
+      const json = JSON.stringify(manifest, null, 2);
+      writeFileSync(tempPath, json, "utf-8");
+      renameSync(tempPath, manifestPath);
+    }
+
+    return {
+      success: true,
+      manifest,
+      diagnostics: graph.diagnostics,
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      success: false,
+      diagnostics: [
+        {
+          severity: "error",
+          message: `Compilation error: ${message}`,
+        },
+      ],
+    };
+  }
+}
+

package/src/prose.ts

@@ -0,0 +1,21 @@
+import { join } from "node:path";
+import fastGlob from "fast-glob";
+
+const DEFAULT_EXCLUDES = [".sprig/**", "dist/**", "node_modules/**", ".git/**"];
+
+/**
+ * Loads all .prose files under root with default excludes
+ * @param root - Universe root directory
+ * @returns Array of prose file paths, sorted deterministically
+ */
+export async function loadProseFiles(root: string): Promise<string[]> {
+  const pattern = join(root, "**/*.prose");
+  const allFiles = await fastGlob(pattern, {
+    absolute: true,
+    ignore: DEFAULT_EXCLUDES.map((exclude) => join(root, exclude)),
+  });
+
+  // Sort for deterministic ordering
+  return allFiles.sort();
+}
+