unoverse 0.1.149 → 0.1.151

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`)
-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.
-
-Documentation: https://github.com/unoverse-platform/docs
+Creating a universe registers the `canvas` MCP (`.mcp.json`): open the folder in
+Claude Code and describe the workflow you want, built live on your Canvas. The
+authoring skills for components, templates, themes, and custom nodes come with Studio
+projects (`unoverse studio`). `unoverse update` keeps the CLI, a universe's images,
+and any installed skills current; to add the skills to your own agent by hand:
+`npx skills add unoverse-platform/skills`.
+
+Documentation: https://docs.unoverse.ai

package/bin/unoverse.mjs

@@ -125,13 +125,16 @@ switch (cmd) {
   }
 
   case "_postupdate": {
-    // Runs AS the new version, in the developer's cwd. Outside a universe there is
-    // nothing to refresh, and silence is the right answer.
+    // Runs AS the new version, in the developer's cwd. A universe refreshes its
+    // platform images; ANY folder that has authoring skills installed (a Studio
+    // project) gets them refreshed from the public mirror, so `unoverse update` is
+    // the one command that brings everything current. A folder with neither is
+    // left alone, and silence is the right answer.
     if (UNIVERSE) {
-      // The authoring skill is Studio's, not the universe's; update touches only what
-      // a universe actually has: this CLI and the platform images.
       operator(UNIVERSE, ["refresh-images"]);
     }
+    const { refreshSkills } = await import("../lib/skills.mjs");
+    refreshSkills(process.cwd());
     process.exit(0);
   }
 
@@ -154,6 +157,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/lib/skills.mjs

@@ -0,0 +1,41 @@
+// Refresh the Claude Code authoring skills installed in a folder.
+//
+// The public mirror github.com/unoverse-platform/skills is the one place installed
+// skills come from (publish syncs it from the platform repo's .claude/skills). This
+// runs on `unoverse update` (_postupdate) in the developer's cwd: a folder that HAS
+// .claude/skills gets every skill the mirror carries, replaced whole; a folder that
+// never had them is left alone — installing skills is Studio's job at project
+// creation, not update's.
+import { mkdtempSync, existsSync, readdirSync, rmSync, cpSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { spawnSync } from "node:child_process";
+
+const TARBALL = "https://codeload.github.com/unoverse-platform/skills/tar.gz/refs/heads/main";
+
+export function refreshSkills(dir) {
+  const target = join(dir, ".claude", "skills");
+  if (!existsSync(target)) return;
+  const tmp = mkdtempSync(join(tmpdir(), "unoverse-skills-"));
+  try {
+    const dl = spawnSync("bash", ["-c", `curl -fsSL "${TARBALL}" | tar -xz -C "${tmp}" --strip-components=1`], {
+      stdio: "pipe",
+    });
+    if (dl.status !== 0) {
+      console.log("  Skills refresh skipped (github.com unreachable). They refresh on the next update.");
+      return;
+    }
+    // Same filter as Studio's scaffold: a skill is a directory holding a SKILL.md.
+    // The mirror's README and dotfiles never install.
+    const names = readdirSync(tmp, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && existsSync(join(tmp, e.name, "SKILL.md")))
+      .map((e) => e.name);
+    for (const name of names) {
+      rmSync(join(target, name), { recursive: true, force: true });
+      cpSync(join(tmp, name), join(target, name), { recursive: true });
+    }
+    if (names.length) console.log(`  ✓ authoring skills refreshed (${names.join(", ")})`);
+  } finally {
+    rmSync(tmp, { recursive: true, force: true });
+  }
+}

package/operator/ansible/playbooks/deploy-images.yml

@@ -6,7 +6,7 @@
 #   - marketplace nodes CONVERGE at boot (keep-latest: the shared installed_plugins
 #     row is "the newest version anyone chose"; boot reinstalls anything missing
 #     or older — see runtime/plugins/startup.ts)
-#   - component nodes synthesize from rx/ definitions at boot (no build, ever)
+#   - component nodes synthesize from design/ definitions at boot (no build, ever)
 #
 # The CLI's `unoverse deploy` runs this first, then deploy-packages.yml (the
 # local-source half). Use directly only when images alone changed.
@@ -122,5 +122,5 @@
           {{ status_result.stdout }}
           Marketplace nodes converge to the recorded
           versions at boot; component nodes synthesize
-          from rx/ definitions.
+          from design/ definitions.
           ============================================

package/operator/docker-compose.yml

@@ -8,7 +8,7 @@
 #
 # LAYER 2: PLATFORM-DEV MOUNTS (monorepo only — sync-starter strips them)
 #   - apps/unoverse/nodes    — node manifests
-#   - apps/unoverse/rx       — design (components, templates, styles)
+#   - apps/unoverse/design    — design (components, templates, styles)
 #   - apps/unoverse/prompts  — behavior (skills + blocks)
 #   In a STARTER/customer universe these folders do not exist: authoring is
 #   Studio's (publish over the API) and content is DB-driven (marketplace).
@@ -255,7 +255,8 @@ services:
       - unoverse_plugins:/app/plugins
       # ── Platform-dev mounts (monorepo only; sync-starter strips these three
       # lines from the starter's copy — a customer universe serves what the DB
-      # says). Local edits are picked up on restart; rx/prompts are data, no build.
+      # says). Local edits are picked up on restart; design/prompts are data, no build.
+      - ./apps/unoverse/design:/app/apps/unoverse/design # design (components, templates, styles)
       - ./node_modules:/app/host_node_modules # Hoisted deps for locally-built nodes
     healthcheck:
       # Ready = internal runtime port up (nodes are loaded into memory BEFORE it binds).

package/operator/lib/db-verify.sh

@@ -35,7 +35,8 @@ cmd_db_verify() {
       workflows: [
         "id", "name", "description", "nodes", "edges", "active",
         "execution_mode", "test_inputs", "umap_settings", "viewport",
-        "mcp_schema", "memory_config", "content_taxonomy", "created_at", "updated_at"
+        "mcp_schema", "memory_config", "content_taxonomy", "created_at", "updated_at",
+        "workflow_document", "layout_document"
       ],
       workflow_executions: [
         "execution_id", "workflow_id", "status", "start_time", "end_time",

package/operator/lib/publish-assets.mjs

@@ -14,6 +14,7 @@
  *   publish-assets.mjs <project> --to <universe> --token <jwt>   [--dry-run] [--yes]
  */
 import { resolve, dirname, join } from "node:path";
+import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { createInterface } from "node:readline/promises";
 
@@ -31,7 +32,7 @@ const flag = (name) => process.argv.includes(`--${name}`);
 const project = process.argv[2] && !process.argv[2].startsWith("--") ? process.argv[2] : undefined;
 const universe = arg("to");
 const token = arg("token") ?? process.env.UNOVERSE_TOKEN;
-const rxHome = resolve(arg("rx") ?? "apps/unoverse/rx");
+const designRoot = resolve(arg("design") ?? "apps/unoverse/design");
 
 const c = { dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", yellow: "\x1b[33m", bold: "\x1b[1m", off: "\x1b[0m" };
 const die = (msg) => {
@@ -40,7 +41,7 @@ const die = (msg) => {
 };
 
 if (!project) {
-  const projects = listProjects(rxHome);
+  const projects = listProjects(designRoot);
   die(`which project?\n\n    unoverse publish <project> --to <universe>\n\n  Found: ${projects.join(", ") || "none"}`);
 }
 if (!universe) die("no universe. Pass --to https://your-universe.com");
@@ -49,7 +50,7 @@ if (!token) die("no credential. Pass --token, or set UNOVERSE_TOKEN");
 // ── 1. lint. Nothing is sent if this fails ────────────────────────────────────
 console.log(`\n  ${c.bold}publish ${project}${c.off} ${c.dim}→ ${universe}${c.off}\n`);
 process.stdout.write(`  ${c.dim}checking…${c.off}`);
-const { problems, errors } = await lintForPublish(rxHome, project);
+const { problems, errors } = await lintForPublish(designRoot, project);
 process.stdout.write("\r                    \r");
 
 if (errors.length) {
@@ -63,7 +64,7 @@ const warnings = problems.filter((p) => p.level === "warn").length;
 console.log(`  ${c.green}✓${c.off} checks passed${warnings ? ` ${c.dim}(${warnings} warning(s))${c.off}` : ""}`);
 
 // ── 2. compare against what the universe already holds ────────────────────────
-const items = collectProject(rxHome, project);
+const items = collectProject(designRoot, project);
 if (!items.length) die(`nothing to publish in ${project}`);
 
 let plan;

package/operator/lib/start.sh

@@ -202,7 +202,7 @@ cmd_start() {
     echo ""
     echo -e "  ${GREEN}${BOLD}All $running services running${NC} ${DIM}($(timer_elapsed))${NC}"
     echo ""
-    # Auto-compile component (design) nodes from rx/ — same step prod's deploy runs.
+    # Auto-compile component (design) nodes from the design tree — same step prod's deploy runs.
     # Generates + tsc-builds nodes/components, then reloads unoverse so they load.
     # Non-fatal: build_component_nodes returns (doesn't exit) if it can't run, so start still finishes.
     build_component_nodes
@@ -274,7 +274,7 @@ cmd_build() {
 # Internal helper (called by start/dev — not a user-facing command): builds the
 # universal component-node package LOCALLY (never in the container — deploys and
 # dev alike ship/serve locally built dists) and restarts unoverse. Design
-# DEFINITION changes never need this — they synthesize from rx/ at boot; a plain
+# DEFINITION changes never need this — they synthesize from design/ at boot; a plain
 # restart suffices. This exists for the PACKAGE-source case.
 build_component_nodes() {
   # MONOREPO ONLY. packages/marketplace exists in the platform checkout and nowhere else, so
@@ -298,7 +298,7 @@ build_component_nodes() {
     return
   fi
 
-  echo "  Restarting unoverse (definitions re-synthesize from rx/components)..."
+  echo "  Restarting unoverse (definitions re-synthesize from design/components)..."
   docker compose -f "$ROOT/docker-compose.yml" restart unoverse 2>/dev/null || true
   ok "Restarted. Component changes are live"
   echo ""

package/operator/operator.sh

@@ -194,7 +194,7 @@ case "${1:-}" in
       shift; cmd_publish "$@"
     elif _in_platform_monorepo; then
       # THE INSTALLED CLI CANNOT RELEASE THE PLATFORM, and inside this repo the fallthrough
-      # below is never what anyone meant: it would start publishing rx assets to a universe
+      # below is never what anyone meant: it would start publishing design assets to a universe
       # while the operator believes they are shipping the platform. It used to do exactly
       # that, silently, which is the whole reason this branch exists. Refuse and say where
       # to go. A starter kit never reaches here (no `unoverse-platform` package above it),

package/package.json

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