@unoverse-platform/studio 0.1.54 → 0.1.55

package/bin/studio.mjs

@@ -162,6 +162,13 @@ await scaffoldIfEmpty();
  */
 const projectRoot = findProjectRootFromCwd();
 process.env.UNOVERSE_HOME = projectRoot;
+// Samples this workspace has never seen arrive on launch (new ones ship with Studio
+// releases); anything it ever had — edited or deleted — is never touched. scaffold.mjs
+// topUpSamples explains the record that makes that distinction safe.
+{
+  const { topUpSamples } = await import("../local/scaffold.mjs");
+  try { topUpSamples(projectRoot); } catch { /* a read-only folder must not block launch */ }
+}
 console.log(`\n  Studio reading: ${designHome(projectRoot)}\n`);
 
 /**

package/local/scaffold.mjs

@@ -13,7 +13,7 @@
  *
  * See docs/architecture/LOCAL_STUDIO.md.
  */
-import { existsSync, mkdirSync, writeFileSync, cpSync, readdirSync } from "node:fs";
+import { existsSync, mkdirSync, writeFileSync, cpSync, readdirSync, readFileSync } from "node:fs";
 import { designHome } from "./design-home.mjs";
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -84,6 +84,60 @@ export function createProject(home, name) {
   return root;
 }
 
+/**
+ * The worked example content (sample nodes, a sample agent skill, a sample prompt
+ * block), keyed by the workspace path each lands at. `dir` is relative to this file.
+ *
+ * A NEW ENTRY HERE REACHES EXISTING WORKSPACES on their next Studio launch, because
+ * topUpSamples runs at every launch, not only at scaffold. The record below is what
+ * makes that safe.
+ */
+const SAMPLES = [
+  { id: "nodes/samples", dir: "sample-nodes/samples", to: "nodes/samples" },
+  { id: "prompts/skills/sample-complaint-handling", dir: "sample-prompts/skills/sample-complaint-handling", to: "prompts/skills/sample-complaint-handling" },
+  { id: "prompts/blocks/sample-concise-answers", dir: "sample-prompts/blocks/formatting/sample-concise-answers.md", to: "prompts/blocks/formatting/sample-concise-answers.md" },
+];
+
+/**
+ * Install every sample this workspace has NEVER SEEN, and only those.
+ *
+ * "Absent from disk" is ambiguous — it means either "deleted on purpose" or "shipped
+ * after this workspace was made" — so presence is not the test. The test is the
+ * RECORD (.unoverse/samples.json): a sample id listed there was installed here once,
+ * and whatever the developer did to it since (edit, rename, delete) is theirs and
+ * permanent. A sample id NOT listed is genuinely new to this workspace and arrives.
+ * That is what lets `unoverse studio` top up new samples on every launch without ever
+ * resurrecting deleted work or overwriting changed files.
+ */
+export function topUpSamples(home) {
+  const record = join(home, ".unoverse", "samples.json");
+  let seen = [];
+  try {
+    seen = JSON.parse(readFileSync(record, "utf8")).installed ?? [];
+  } catch {
+    // No record: a workspace from before records existed. Treat every sample already
+    // on disk as seen (it was installed by an old scaffold), so nothing is re-copied.
+    seen = SAMPLES.filter((s) => existsSync(join(home, s.to))).map((s) => s.id);
+  }
+  const here = dirname(fileURLToPath(import.meta.url));
+  let changed = false;
+  for (const s of SAMPLES) {
+    if (seen.includes(s.id)) continue;
+    const src = join(here, s.dir);
+    if (!existsSync(src)) continue;
+    if (!existsSync(join(home, s.to))) {
+      mkdirSync(dirname(join(home, s.to)), { recursive: true });
+      cpSync(src, join(home, s.to), { recursive: true });
+    }
+    seen.push(s.id);
+    changed = true;
+  }
+  if (changed || !existsSync(record)) {
+    mkdirSync(dirname(record), { recursive: true });
+    writeFileSync(record, JSON.stringify({ installed: seen }, null, 2) + "\n");
+  }
+}
+
 /**
  * The FIRST project, plus the folders that live beside the design tree rather than inside it.
  *
@@ -94,47 +148,20 @@ export function createFirstProject(home, name) {
   const root = createProject(home, name);
   for (const d of ["prompts/skills", "prompts/blocks", "nodes"]) mkdirSync(join(home, d), { recursive: true });
 
-  // Two worked example nodes (sample-nodes/samples: a PromiseNode and a CallbackNode,
-  // heavily commented, linking docs.unoverse.ai/nodes), so `nodes/` is never an empty
-  // folder with no hint of what goes in it. Copied only when absent: these are the
-  // developer's files to edit or delete, and a later scaffold run must never put back
-  // what they threw away or overwrite what they changed.
-  const samples = join(dirname(fileURLToPath(import.meta.url)), "sample-nodes/samples");
-  if (existsSync(samples) && !existsSync(join(home, "nodes/samples"))) {
-    cpSync(samples, join(home, "nodes/samples"), { recursive: true });
-  }
-
-  // A worked example agent skill and prompt block, same reason and same rule as the
-  // sample nodes: prompts/ must never be two empty folders, and the samples are the
-  // developer's to edit or delete — copied only when absent, never restored.
-  const samplePrompts = join(dirname(fileURLToPath(import.meta.url)), "sample-prompts");
-  if (existsSync(join(samplePrompts, "skills")) && !existsSync(join(home, "prompts/skills/sample-complaint-handling"))) {
-    cpSync(join(samplePrompts, "skills"), join(home, "prompts/skills"), { recursive: true });
-  }
-  if (existsSync(join(samplePrompts, "blocks")) && !existsSync(join(home, "prompts/blocks/formatting/sample-concise-answers.md"))) {
-    cpSync(join(samplePrompts, "blocks"), join(home, "prompts/blocks"), { recursive: true });
-  }
+  topUpSamples(home);
 
-  // The Claude Code authoring skills, so "open the folder and describe what you want"
-  // works in every Studio project from its first minute. Vendored into the published
-  // app (vendor/skills, written by prepack from the monorepo's .claude/skills, the one
-  // authoring home, mirrored publicly to github.com/unoverse-platform/skills); read
-  // from that home when running as source. `unoverse update` refreshes installed
-  // copies from the public mirror.
+  // SCAFFOLD WRITES NO `.claude/skills` (2026-08-21). It used to copy the Claude Code
+  // authoring skills out of `vendor/skills` and into `<home>/.claude/skills`, which meant
+  // every remote developer who launched Studio got the platform repo's own `.claude`
+  // folder reproduced on their disk, pinned to whatever Studio version they happened to
+  // install and sitting in a workspace they might commit.
   //
-  // ALL of them. One Studio project is where a person designs a brand AND writes the node
-  // behind it, so they need the whole set: naming one skill here shipped the authoring
-  // playbooks and silently withheld the rest.
-  const app = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-  const skillsDir = [join(app, "vendor/skills"), resolve(app, "../../.claude/skills")].find((d) => existsSync(d));
-  if (skillsDir) {
-    const names = readdirSync(skillsDir, { withFileTypes: true })
-      .filter((e) => e.isDirectory() && existsSync(join(skillsDir, e.name, "SKILL.md")))
-      .map((e) => e.name);
-    if (names.length) mkdirSync(join(home, ".claude/skills"), { recursive: true });
-    for (const name of names) {
-      cpSync(join(skillsDir, name), join(home, ".claude/skills", name), { recursive: true });
-    }
-  }
+  // The skills are PER DEVELOPER, not per project (the same reason prompts/ and nodes/ are
+  // made once here and never by `createProject`). They now install to `~/.claude/skills`
+  // from the public mirror, on `unoverse update` — see packages/cli/lib/skills.mjs.
+  //
+  // `vendor/skills` STAYS, and is not a distribution channel: it is what Studio's builder
+  // MCP reads to teach a connected agent the authoring rules (local/mcp.ts SKILL_DIRS).
+  // Nothing about that copy reaches the developer's filesystem.
   return root;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unoverse-platform/studio",
-  "version": "0.1.54",
+  "version": "0.1.55",
   "type": "module",
   "description": "Unoverse Studio: the local authoring app. Reads your own rx/ folder, no backend.",
   "scripts": {