unoverse 0.1.148 → 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

@@ -145,7 +145,50 @@ switch (cmd) {
 
   case "studio": {
     // Studio is its own npm app; this is a launcher, not a wrapper.
-    const r = spawnSync("npx", ["-y", "@unoverse-platform/studio@latest", ...args], {
+    //
+    // Launched by EXACT version, resolved fresh, never `@latest`: npx keys its cache
+    // by the spec, and a cached `@latest` entry updates the top package IN PLACE while
+    // reusing whatever dependencies already satisfy their ranges — observed live as
+    // studio 0.1.43 running against a base two releases stale, which is how a
+    // developer gets last week's lint under this week's screens. An exact spec is a
+    // 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";
+    const r = spawnSync("npx", ["-y", spec, ...args], {
       stdio: "inherit",
     });
     process.exit(r.status ?? 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.148",
+  "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",