@sprig-and-prose/sprig 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# sprig-cli
+
+Sprig CLI tool for compiling and serving universes.
+
+## Installation
+
+```bash
+npm install -g @sprig-and-prose/sprig-cli
+```
+
+## Usage
+
+### Commands
+
+- `sprig compile [path?]` - Compile universe files to manifest
+- `sprig validate [path?]` - Validate universe files (no output)
+- `sprig ui [path?]` - Start UI server with watch mode
+
+### Root Discovery
+
+The CLI walks upward from the provided path (or current directory) until it finds a directory containing `universe.prose`. That directory is the universe root.
+
+### Compile
+
+Compiles all `.prose` files under the universe root (excluding `.sprig/**`, `dist/**`, `node_modules/**`, `.git/**`) and writes `.sprig/manifest.json`.
+
+### Validate
+
+Validates the universe without writing output. Exits with a nonzero code if errors are found.
+
+### UI
+
+Starts a local HTTP server (default port 5173) that:
+- Serves the UI from `@sprig-and-prose/sprig-ui-csr`
+- Provides `/api/manifest` endpoint for the compiled manifest
+- Provides `/api/events` endpoint for Server-Sent Events (SSE) updates
+- Watches `.prose` files and automatically rebuilds on changes
+- Broadcasts SSE events after each successful rebuild
+
+The `.sprig/` directory is a cache and should not be committed.
+

package/biome.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "ignore": []
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2
+  },
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double"
+    }
+  }
+}
+

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,161 @@
+#!/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"];
+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() {
+    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];
+    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;
+    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) {
+    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) {
+    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, port) {
+    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();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compiler.d.ts

@@ -0,0 +1,21 @@
+export interface CompileResult {
+    success: boolean;
+    manifest?: Record<string, unknown> & {
+        repositories?: Record<string, unknown>;
+        generatedAt: string;
+    };
+    diagnostics: Array<{
+        severity: string;
+        message: string;
+        source?: unknown;
+    }>;
+}
+/**
+ * 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 declare function compileUniverse(universeRoot: string, files: string[], writeManifest?: boolean): Promise<CompileResult>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACrG,WAAW,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC7E;AA2CD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EAAE,EACf,aAAa,UAAO,GACnB,OAAO,CAAC,aAAa,CAAC,CA6ExB"}

package/dist/compiler.js

@@ -0,0 +1,117 @@
+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";
+/**
+ * Validates that exactly one universe declaration exists in the parsed graph
+ */
+function validateUniverseCount(graph) {
+    const universes = graph.universes;
+    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;
+        const fileList = Array.from(universeNames)
+            .map((name) => {
+            const universe = universes?.[name];
+            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, files, writeManifest = true) {
+    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) => 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}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

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

package/dist/prose.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Loads all .prose files under root with default excludes
+ * @param root - Universe root directory
+ * @returns Array of prose file paths, sorted deterministically
+ */
+export declare function loadProseFiles(root: string): Promise<string[]>;
+//# sourceMappingURL=prose.d.ts.map

package/dist/prose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.d.ts","sourceRoot":"","sources":["../src/prose.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpE"}

package/dist/prose.js

@@ -0,0 +1,18 @@
+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) {
+    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();
+}
+//# sourceMappingURL=prose.js.map

package/dist/prose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.js","sourceRoot":"","sources":["../src/prose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE;QACvC,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;KAC/D,CAAC,CAAC;IAEH,kCAAkC;IAClC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/root.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Walks upward from startPath to find universe.prose marker
+ * @param startPath - Starting directory path
+ * @returns Path to directory containing universe.prose, or null if not found
+ */
+export declare function discoverUniverseRoot(startPath: string): string | null;
+//# sourceMappingURL=root.d.ts.map

package/dist/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBrE"}

package/dist/root.js

@@ -0,0 +1,25 @@
+import { existsSync, statSync } from "node:fs";
+import { resolve, dirname, join } from "node:path";
+/**
+ * Walks upward from startPath to find universe.prose marker
+ * @param startPath - Starting directory path
+ * @returns Path to directory containing universe.prose, or null if not found
+ */
+export function discoverUniverseRoot(startPath) {
+    let current = resolve(startPath);
+    const root = resolve("/");
+    while (current !== root) {
+        const markerPath = join(current, "universe.prose");
+        if (existsSync(markerPath) && statSync(markerPath).isFile()) {
+            return current;
+        }
+        current = dirname(current);
+    }
+    // Check root directory as well
+    const rootMarkerPath = join(root, "universe.prose");
+    if (existsSync(rootMarkerPath) && statSync(rootMarkerPath).isFile()) {
+        return root;
+    }
+    return null;
+}
+//# sourceMappingURL=root.js.map

package/dist/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../src/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,IAAI,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACnD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5D,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,+BAA+B;IAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Starts the UI server with watch mode
+ */
+export declare function startUIServer(universeRoot: string, port?: number): Promise<void>;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAiNA;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,MAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAuHf"}