@sprig-and-prose/sprig 0.1.0

package/src/root.ts

@@ -0,0 +1,29 @@
+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: string): string | null {
+  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;
+}
+

package/src/ui.ts

@@ -0,0 +1,336 @@
+import { createServer, type Server } 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 { discoverUniverseRoot } from "./root.js";
+import { loadProseFiles } from "./prose.js";
+import { compileUniverse } from "./compiler.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const mimeTypes: Record<string, string> = {
+  ".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(): string {
+  // 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<import("node:http").ServerResponse>();
+
+/**
+ * Broadcasts a manifest changed event to all connected clients
+ */
+function broadcastManifestChanged(): void {
+  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: string,
+  manifestPath: string,
+): (req: import("node:http").IncomingMessage, res: import("node:http").ServerResponse) => void {
+  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: string,
+  manifestPath: string,
+): Promise<boolean> {
+  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: string,
+  port: number = 6336,
+): Promise<void> {
+  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: NodeJS.ErrnoException) => {
+    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: NodeJS.Timeout | null = 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);
+}
+

package/tests/compile.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compile.test.d.ts.map

package/tests/compile.test.d.ts.map

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

package/tests/compile.test.js

@@ -0,0 +1,64 @@
+import { test } from "node:test";
+import { strict as assert } from "node:assert";
+import { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from "node:fs";
+import { join, tmpdir } from "node:path";
+import { compileUniverse } from "../src/compiler.js";
+test("compileUniverse writes .sprig/manifest.json", async () => {
+    const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+    // Create universe.prose marker
+    writeFileSync(join(testDir, "universe.prose"), `universe TestUniverse {
+  describe {
+    A test universe.
+  }
+}`);
+    // Create a simple prose file
+    const proseFile = join(testDir, "test.prose");
+    writeFileSync(proseFile, `series TestSeries {
+  describe {
+    A test series.
+  }
+}`);
+    try {
+        const result = await compileUniverse(testDir, [proseFile], true);
+        assert.strictEqual(result.success, true);
+        assert.ok(result.manifest);
+        // Check that manifest.json was written
+        const manifestPath = join(testDir, ".sprig", "manifest.json");
+        assert.ok(existsSync(manifestPath), "manifest.json should exist");
+        // Check manifest content
+        const manifestContent = JSON.parse(readFileSync(manifestPath, "utf-8"));
+        assert.strictEqual(manifestContent.universes?.TestUniverse?.name, "TestUniverse");
+        assert.ok(manifestContent.generatedAt);
+    }
+    finally {
+        rmSync(testDir, { recursive: true, force: true });
+    }
+});
+test("compileUniverse does not write manifest when writeManifest is false", async () => {
+    const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+    writeFileSync(join(testDir, "universe.prose"), `universe TestUniverse {
+  describe {
+    A test universe.
+  }
+}`);
+    const proseFile = join(testDir, "test.prose");
+    writeFileSync(proseFile, `series TestSeries {
+  describe {
+    A test series.
+  }
+}`);
+    try {
+        const result = await compileUniverse(testDir, [proseFile], false);
+        assert.strictEqual(result.success, true);
+        assert.ok(result.manifest);
+        // Check that manifest.json was NOT written
+        const manifestPath = join(testDir, ".sprig", "manifest.json");
+        assert.ok(!existsSync(manifestPath), "manifest.json should not exist when writeManifest is false");
+    }
+    finally {
+        rmSync(testDir, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=compile.test.js.map

package/tests/compile.test.js.map

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

package/tests/compile.test.ts

@@ -0,0 +1,87 @@
+import { test } from "node:test";
+import { strict as assert } from "node:assert";
+import { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from "node:fs";
+import { join, tmpdir } from "node:path";
+import { compileUniverse } from "../src/compiler.js";
+
+test("compileUniverse writes .sprig/manifest.json", async () => {
+  const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+  mkdirSync(testDir, { recursive: true });
+
+  // Create universe.prose marker
+  writeFileSync(
+    join(testDir, "universe.prose"),
+    `universe TestUniverse {
+  describe {
+    A test universe.
+  }
+}`,
+  );
+
+  // Create a simple prose file
+  const proseFile = join(testDir, "test.prose");
+  writeFileSync(
+    proseFile,
+    `series TestSeries {
+  describe {
+    A test series.
+  }
+}`,
+  );
+
+  try {
+    const result = await compileUniverse(testDir, [proseFile], true);
+
+    assert.strictEqual(result.success, true);
+    assert.ok(result.manifest);
+
+    // Check that manifest.json was written
+    const manifestPath = join(testDir, ".sprig", "manifest.json");
+    assert.ok(existsSync(manifestPath), "manifest.json should exist");
+
+    // Check manifest content
+    const manifestContent = JSON.parse(readFileSync(manifestPath, "utf-8"));
+    assert.strictEqual(manifestContent.universes?.TestUniverse?.name, "TestUniverse");
+    assert.ok(manifestContent.generatedAt);
+  } finally {
+    rmSync(testDir, { recursive: true, force: true });
+  }
+});
+
+test("compileUniverse does not write manifest when writeManifest is false", async () => {
+  const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+  mkdirSync(testDir, { recursive: true });
+
+  writeFileSync(
+    join(testDir, "universe.prose"),
+    `universe TestUniverse {
+  describe {
+    A test universe.
+  }
+}`,
+  );
+
+  const proseFile = join(testDir, "test.prose");
+  writeFileSync(
+    proseFile,
+    `series TestSeries {
+  describe {
+    A test series.
+  }
+}`,
+  );
+
+  try {
+    const result = await compileUniverse(testDir, [proseFile], false);
+
+    assert.strictEqual(result.success, true);
+    assert.ok(result.manifest);
+
+    // Check that manifest.json was NOT written
+    const manifestPath = join(testDir, ".sprig", "manifest.json");
+    assert.ok(!existsSync(manifestPath), "manifest.json should not exist when writeManifest is false");
+  } finally {
+    rmSync(testDir, { recursive: true, force: true });
+  }
+});
+

package/tests/root.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=root.test.d.ts.map

package/tests/root.test.d.ts.map

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

package/tests/root.test.js

@@ -0,0 +1,43 @@
+import { test } from "node:test";
+import { strict as assert } from "node:assert";
+import { mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { discoverUniverseRoot } from "../src/root.js";
+test("discoverUniverseRoot finds universe.prose in current directory", () => {
+    const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+    writeFileSync(join(testDir, "universe.prose"), "universe Test {}");
+    try {
+        const root = discoverUniverseRoot(testDir);
+        assert.strictEqual(root, testDir);
+    }
+    finally {
+        rmSync(testDir, { recursive: true, force: true });
+    }
+});
+test("discoverUniverseRoot finds universe.prose in parent directory", () => {
+    const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+    const subDir = join(testDir, "sub", "nested");
+    mkdirSync(subDir, { recursive: true });
+    writeFileSync(join(testDir, "universe.prose"), "universe Test {}");
+    try {
+        const root = discoverUniverseRoot(subDir);
+        assert.strictEqual(root, testDir);
+    }
+    finally {
+        rmSync(testDir, { recursive: true, force: true });
+    }
+});
+test("discoverUniverseRoot returns null when not found", () => {
+    const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+    try {
+        const root = discoverUniverseRoot(testDir);
+        assert.strictEqual(root, null);
+    }
+    finally {
+        rmSync(testDir, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=root.test.js.map

package/tests/root.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.test.js","sourceRoot":"","sources":["root.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAW,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3D,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAEnE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAEnE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3D,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC,CAAC"}

package/tests/root.test.ts

@@ -0,0 +1,46 @@
+import { test } from "node:test";
+import { strict as assert } from "node:assert";
+import { mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { discoverUniverseRoot } from "../src/root.js";
+
+test("discoverUniverseRoot finds universe.prose in current directory", () => {
+  const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+  mkdirSync(testDir, { recursive: true });
+  writeFileSync(join(testDir, "universe.prose"), "universe Test {}");
+
+  try {
+    const root = discoverUniverseRoot(testDir);
+    assert.strictEqual(root, testDir);
+  } finally {
+    rmSync(testDir, { recursive: true, force: true });
+  }
+});
+
+test("discoverUniverseRoot finds universe.prose in parent directory", () => {
+  const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+  const subDir = join(testDir, "sub", "nested");
+  mkdirSync(subDir, { recursive: true });
+  writeFileSync(join(testDir, "universe.prose"), "universe Test {}");
+
+  try {
+    const root = discoverUniverseRoot(subDir);
+    assert.strictEqual(root, testDir);
+  } finally {
+    rmSync(testDir, { recursive: true, force: true });
+  }
+});
+
+test("discoverUniverseRoot returns null when not found", () => {
+  const testDir = join(tmpdir(), `sprig-test-${Date.now()}`);
+  mkdirSync(testDir, { recursive: true });
+
+  try {
+    const root = discoverUniverseRoot(testDir);
+    assert.strictEqual(root, null);
+  } finally {
+    rmSync(testDir, { recursive: true, force: true });
+  }
+});
+

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}
+