unoverse 0.1.149 → 0.1.150

package/README.md

@@ -27,9 +27,11 @@ unoverse stop
 
 ## Build with Claude
 
-Creating a universe also installs a Claude Code skill (`.claude/skills/unoverse-create`)
+Creating a universe also installs the Claude Code authoring skills (`.claude/skills/`)
 and registers the `canvas` MCP (`.mcp.json`). Open the folder in Claude Code and ask for
 what you want: components, templates, custom nodes, agent skills, or whole workflows
-built live on your Canvas. `unoverse update` keeps the CLI and the skill current.
+built live on your Canvas. `unoverse update` keeps the CLI and the skills current, and
+any agent can install the same skills straight from the docs site:
+`npx skills add docs.unoverse.ai`.
 
-Documentation: https://github.com/unoverse-platform/docs
+Documentation: https://docs.unoverse.ai

package/bin/unoverse.mjs

@@ -154,6 +154,37 @@ switch (cmd) {
     // new cache key, so every studio release installs clean and fully resolved, and
     // relaunching the same version stays instant from cache. Offline (npm view
     // fails), fall back to the cached latest — stale beats broken with no network.
+    // RECLAIM THE PORT FROM A STALE STUDIO. A studio left over from an earlier session
+    // keeps :4108, so the new launch either fails to bind or — worse — the browser
+    // quietly keeps talking to last week's build. If the listener IS a studio, it is
+    // ours to replace: kill it and wait for the port. Anything else on the port is
+    // NOT ours: name it and stop, never kill a stranger's process.
+    const STUDIO_PORT = 4108;
+    const lsof = spawnSync("lsof", ["-nP", `-iTCP:${STUDIO_PORT}`, "-sTCP:LISTEN", "-Fpc"], { encoding: "utf8" });
+    const holder = lsof.status === 0 ? (lsof.stdout.match(/^p(\d+)$/m) || [])[1] : undefined;
+    if (holder) {
+      const cmd = spawnSync("ps", ["-p", holder, "-o", "command="], { encoding: "utf8" }).stdout?.trim() ?? "";
+      if (/unoverse-studio|@unoverse-platform\/studio/.test(cmd)) {
+        try {
+          process.kill(Number(holder));
+        } catch {
+          /* already gone */
+        }
+        // Wait (up to ~5s) for the socket to actually free — kill returns before close.
+        for (let i = 0; i < 25; i++) {
+          const still = spawnSync("lsof", ["-nP", `-iTCP:${STUDIO_PORT}`, "-sTCP:LISTEN"], { encoding: "utf8" });
+          if (!still.stdout?.trim()) break;
+          spawnSync("sleep", ["0.2"]);
+        }
+        console.log(`  Reclaimed :${STUDIO_PORT} from a previous studio (pid ${holder})`);
+      } else {
+        console.error(
+          `  :${STUDIO_PORT} is held by something that is not a studio (pid ${holder}: ${cmd || "unknown"}).\n` +
+            `  Stop that process first — unoverse won't kill what it didn't start.`,
+        );
+        process.exit(1);
+      }
+    }
     const view = spawnSync("npm", ["view", "@unoverse-platform/studio", "version"], { encoding: "utf8" });
     const exact = view.status === 0 ? view.stdout.trim() : "";
     const spec = exact ? `@unoverse-platform/studio@${exact}` : "@unoverse-platform/studio@latest";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.149",
+  "version": "0.1.150",
   "description": "The Unoverse front door — create a Studio project, a universe, or a client app, and launch Studio.",
   "license": "SEE LICENSE IN README.md",
   "type": "module",