@genex-ai/cli-demo 1.25.1-dev.618 → 1.26.0-dev.620

package/dist/{blender-mcp-PWOUSXK4.js → blender-mcp-TTLZ24PD.js}

@@ -7,7 +7,7 @@ import {
   isRenderMode,
   sceneSummary,
   sheetOf
-} from "./chunk-HEDRWUVP.js";
+} from "./chunk-57CT5CAN.js";
 import {
   getCliVersion
 } from "./chunk-HYCSNWYX.js";

package/dist/{chunk-HEDRWUVP.js → chunk-57CT5CAN.js}

@@ -903,7 +903,6 @@ export {
   apiFetch,
   fetchSignedInEmail,
   restrictFilePermissions,
-  getWorkspacePath,
   readWorkspace,
   writeWorkspace,
   writeUserToken,

package/dist/index.js

@@ -14,7 +14,6 @@ import {
   cloneSource,
   fetchCloneGrant,
   fetchSignedInEmail,
-  getWorkspacePath,
   inHostedSession,
   isRenderMode,
   isStale,
@@ -42,7 +41,7 @@ import {
   writeProject,
   writeUserToken,
   writeWorkspace
-} from "./chunk-HEDRWUVP.js";
+} from "./chunk-57CT5CAN.js";
 import {
   CLI_CHANNEL,
   DEFAULT_API_URL,
@@ -747,18 +746,28 @@ Important note: put soul into your creations, with many details and love. Aim to
 22. **What the player sees must read as the thing it is**, in this game's own style: a building as that building, a person as a person, a prop as that prop, a surface as its material \u2014 and a coloured box, a capsule, or a flat grey block standing in for one of them is never its finished version. Generation is the default route to that bar wherever code will not honestly reach it: the player's character, whatever the request names, whatever the player walks up to, enters, or interacts with, and the music and sound underneath \u2014 reach for the belt on your own judgment, without stopping to ask; a status line saying what you queued is enough, and \`--no-wait\` keeps you building while it lands. Procedural code is a first-class engine for what is structural, repeated, distant, or parametric \u2014 terrain, sky, fences, paving, modular kits, filler \u2014 and for anything else only when the result meets the same bar and you have looked at it in a capture before its row says \`landed\`. Decide per object, not per category, and write the route on each Assets row in \`DESIGN.md\` \u2014 the paid flow for generated pieces, the procedural flow with its local path for code-built ones. An Assets table with no generation in it is a decision, not a default: record it as \`Generation: none \u2014 <why code alone reaches the bar here>\` or generate.
 ${CONTRACT_END}
 `;
-var GENEX_TOOLS_CONTRACT_BLOCK = `${CONTRACT_BEGIN}
-# Genex Tools (always in effect in this folder)
+var TOOLS_CONTRACT_HEAD = `# Genex Tools (always in effect in this folder)
 
-This folder uses **Genex Tools**: AI asset generation for games, from your terminal. All via \`npx genex \u2026\` \u2014 \`model "<prompt>"\` (plus \`model --image <file>\` from a reference photo, \`model segment <id>\` into named parts, \`model rig <id>\` across 7 body plans, \`model animate <rig-id> --preset walk\`) \xB7 \`image\` (\`--transparent\` \xB7 \`--edit\` \xB7 \`--inpaint\` \xB7 \`--remove-bg\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 \`texture\` \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 rigged \`character\` / \`creature\` and \`character animate <id> "<verb>"\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`doctor\`. Full options with costs: \`npx genex --help\`. Each tool has a skill card (\`genex-tool-\u2026\`) \u2014 load the one for the lane you are using. The project and code are the user's own \u2014 Genex generates the assets, and can put the finished game live on the web when they want it.
-
-1. **NEVER delete, empty, move, rename, or overwrite anything you did not create yourself.** This is someone's real project: it holds their code, their reference images, their notes, an earlier attempt \u2014 files that may exist nowhere else and have no undo, no trash, no backup. A non-empty folder is NORMAL and is never something to clean up, and "start clean" is never a reason. That rules out \`rm\`/\`rm -rf\`, \`git clean\`, \`git checkout -- .\`, \`git reset --hard\` over their work, deleting to resolve a conflict or a stuck prompt, and every tool's offer to empty a directory (\`--force\`, \`--overwrite\`, "Remove existing files"). You may add files and edit the ones you wrote. If a step genuinely cannot continue without removing something of theirs, STOP and ask, naming the exact files, and wait for a yes \u2014 "it looks like junk" is never that yes.
+This folder uses **Genex Tools**: AI asset generation for games, from your terminal. All via \`npx genex \u2026\` \u2014 \`model "<prompt>"\` (plus \`model --image <file>\` from a reference photo, \`model segment <id>\` into named parts, \`model rig <id>\` across 7 body plans, \`model animate <rig-id> --preset walk\`) \xB7 \`image\` (\`--transparent\` \xB7 \`--edit\` \xB7 \`--inpaint\` \xB7 \`--remove-bg\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 \`texture\` \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 rigged \`character\` / \`creature\` and \`character animate <id> "<verb>"\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`doctor\`. Full options with costs: \`npx genex --help\`. Each tool has a skill card (\`genex-tool-\u2026\`) \u2014 load the one for the lane you are using. The project and code are the user's own \u2014 Genex generates the assets, and can put the finished game live on the web when they want it.`;
+var TOOLS_CONTRACT_LAWS_1_TO_4 = `1. **NEVER delete, empty, move, rename, or overwrite anything you did not create yourself.** This is someone's real project: it holds their code, their reference images, their notes, an earlier attempt \u2014 files that may exist nowhere else and have no undo, no trash, no backup. A non-empty folder is NORMAL and is never something to clean up, and "start clean" is never a reason. That rules out \`rm\`/\`rm -rf\`, \`git clean\`, \`git checkout -- .\`, \`git reset --hard\` over their work, deleting to resolve a conflict or a stuck prompt, and every tool's offer to empty a directory (\`--force\`, \`--overwrite\`, "Remove existing files"). You may add files and edit the ones you wrote. If a step genuinely cannot continue without removing something of theirs, STOP and ask, naming the exact files, and wait for a yes \u2014 "it looks like junk" is never that yes.
 2. **Generated assets are local files the user owns.** Every generation downloads into \`./assets/\` and the command prints the local path \u2014 wire THAT path into the code, exactly like an asset they drew themselves. The URL printed beside it is provenance, not hosting: never fetch it at runtime, never ship a build that depends on it. Assets are theirs to move, rename, commit, or process further.
 3. **Run \`npx genex doctor\` when a command fails, and before promising what you can generate.** It reports sign-in, credit balance, and which generation lanes are actually live on this account \u2014 the only live source for all three. Treat every genex warning line as work, not noise, and never re-run a generation command to "retry" one that is still running: that bills a second asset. Attach to the first with \`npx genex wait <id>\`.
-4. **Real assets beat placeholders.** When anything you build will be seen or heard by a player, reach for the belt first \u2014 a generated model instead of a colored box, a texture instead of a flat material, music and sound instead of silence, a rigged character instead of a capsule. Put soul into the details; never limit your imagination to what is easy to code. You know the tools and their costs (\`npx genex --help\`) \u2014 decide and generate on your own judgment, without stopping to ask permission; a status line saying what you queued is enough. Queue with \`--no-wait\` and keep building while generations run.
-5. **When the game is built and playable \u2014 never mid-build \u2014 offer once, in one line: "Want to make your game live on the web with its own URL?"** Offer only if the game runs in the browser and builds to static files; otherwise never bring it up. A no means drop it for good. On a yes, run \`npx genex init --convert\` and follow what it prints \u2014 it turns this folder into a hosted Genex game workspace: the code stays the user's own, the source goes to a private repo, and the game gets a draft page plus a public URL when they choose to publish.
+4. **Real assets beat placeholders.** When anything you build will be seen or heard by a player, reach for the belt first \u2014 a generated model instead of a colored box, a texture instead of a flat material, music and sound instead of silence, a rigged character instead of a capsule. Put soul into the details; never limit your imagination to what is easy to code. You know the tools and their costs (\`npx genex --help\`) \u2014 decide and generate on your own judgment, without stopping to ask permission; a status line saying what you queued is enough. Queue with \`--no-wait\` and keep building while generations run.`;
+var TOOLS_CONTRACT_OFFER = `5. **When the game is built and playable \u2014 never mid-build \u2014 offer once, in one line: "Want to make your game live on the web with its own URL?"** Offer only if the game runs in the browser and builds to static files; otherwise never bring it up. A no means drop it for good. On a yes, run \`npx genex init --convert\` and follow what it prints \u2014 it connects this folder to a hosted Genex game: the code and this toolkit stay exactly as they are, the source goes to a private repo, and the game gets a draft page plus a public URL when they choose to publish.`;
+var TOOLS_CONTRACT_HOSTED_LAWS = `5. **This game is hosted on Genex now, and publishing is glue \u2014 never a rebuild.** The game ships exactly as the user built it: \`initEmbed()\` first in the boot code (the \`genex-threejs-embed-auth\` card has the call; the renderer draws before any \`await waitForPlayer()\`), a static build into \`dist/\` with relative asset paths, then \`npx genex preview\`. Never restructure, reformat or "improve" the game to ship it, never scaffold a new app around it, and never start a design document or a build plan for it \u2014 the user's own process is theirs. Load the \`genex-tool-publish\` card before the first preview; it owns the vocabulary, the links and the limits.
+6. **Ship first, then report.** \`preview\` prints a preflight \u2014 phone memory, a missing volume slider, an asset nobody wired, a viewport line. It never blocks a deploy, so push the build as it is, hand over the link, THEN relay each preflight line to the user in one plain sentence with an offer to fix it, and fix one only on their yes. The preflight is a report for the user, not a to-do list for you.
+7. **The link is the game's page, and there are two versions.** After every preview give the user \`<dashboard>/draft/<slug>\` \u2014 \`dashboardOrigins[0]\` and \`slug\` from \`.genex/project.json\` \u2014 never localhost, a file path or the bare play origin. \`preview\` updates the draft and never touches what players are on; the first release is \`npx genex publish\` (it lists the game); after that "publish it", "update it" and "yes" all mean \`npx genex promote\` \u2014 the exact draft build, no rebuild. Ask once per round of work, in one line, and keep working while you wait.`;
+function toolsContractBlock(opts) {
+  return `${CONTRACT_BEGIN}
+${TOOLS_CONTRACT_HEAD}${opts.hosted ? " This game is also hosted on Genex: `preview` \xB7 `promote` \xB7 `publish` \xB7 `rollback` \xB7 `rename` work here (the `genex-tool-publish` card owns them)." : ""}
+
+${TOOLS_CONTRACT_LAWS_1_TO_4}
+${opts.hosted ? TOOLS_CONTRACT_HOSTED_LAWS : TOOLS_CONTRACT_OFFER}
 ${CONTRACT_END}
 `;
+}
+var GENEX_TOOLS_CONTRACT_BLOCK = toolsContractBlock({ hosted: false });
+var GENEX_TOOLS_HOSTED_CONTRACT_BLOCK = toolsContractBlock({ hosted: true });
 var CLAUDE_IMPORT_LINE = "@AGENTS.md";
 var CONTRACT_REGION = /<!-- genex:contract:begin[^\n]*-->[\s\S]*?<!-- genex:contract:end -->/;
 function mergeContractBlock(existing, contractBlock = GENEX_CONTRACT_BLOCK) {
@@ -814,8 +823,8 @@ ${CLAUDE_IMPORT_LINE}
   }
   return changed;
 }
-async function writeToolsContract(projectDir) {
-  return writeAgentsContract(projectDir, GENEX_TOOLS_CONTRACT_BLOCK);
+async function writeToolsContract(projectDir, opts = {}) {
+  return writeAgentsContract(projectDir, toolsContractBlock({ hosted: opts.hosted === true }));
 }
 async function healAncestorContracts(projectDir, stopDir = os3.homedir()) {
   const findings = [];
@@ -894,21 +903,23 @@ import path4 from "path";
 // src/lib/workspace.ts
 async function resolveWorkspace(cwd = process.cwd()) {
   const project = await readProject(cwd);
-  if (project) {
-    const slug = typeof project.slug === "string" && project.slug.trim() ? project.slug.trim() : null;
-    return { mode: "game", slug };
-  }
+  const slug = project && typeof project.slug === "string" && project.slug.trim() ? project.slug.trim() : null;
   const ws = await readWorkspace(cwd);
-  return { mode: ws?.mode === "tools" ? "tools" : null, slug: null };
+  if (ws?.mode === "tools") return { mode: "tools", slug, hosted: Boolean(project) };
+  if (project) return { mode: "game", slug, hosted: true };
+  return { mode: null, slug: null, hosted: false };
 }
 async function workspaceMode(cwd = process.cwd()) {
   return (await resolveWorkspace(cwd)).mode;
 }
 function workspaceHeaderLabel(ws) {
+  if (ws.hosted) return ws.slug ? { game: ws.slug } : ws.mode === "tools" ? "tools" : null;
   if (ws.mode === "tools") return "tools";
-  if (ws.mode === "game" && ws.slug) return { game: ws.slug };
   return null;
 }
+function platformRefusedIn(ws, command) {
+  return ws.mode === "tools" && !ws.hosted && refusedInTools(command);
+}
 var REFUSED_IN_TOOLS = /* @__PURE__ */ new Set([
   "link",
   "pull",
@@ -982,19 +993,12 @@ async function hasGenexSkills(skillsDir) {
   }
 }
 var TOOL_SKILL_PREFIX = "genex-tool-";
-var TOOL_SKILLS = [
-  "genex-tool-audio",
-  "genex-tool-character",
-  "genex-tool-image",
-  "genex-tool-model",
-  "genex-tool-texture",
-  "genex-tool-video",
-  "genex-tool-workflow"
-];
+var HOSTED_TOOL_SKILLS = ["genex-tool-publish", "genex-threejs-embed-auth"];
 function skillFamilyOf(name) {
   return name.startsWith(TOOL_SKILL_PREFIX) ? "tools" : "game";
 }
-function skillFamilyFilter(mode) {
+function skillFamilyFilter(mode, opts = {}) {
+  const hostedExtras = new Set(HOSTED_TOOL_SKILLS);
   return (rel) => {
     const segments = rel.split(/[\\/]/);
     const top = segments[0] ?? "";
@@ -1003,6 +1007,7 @@ function skillFamilyFilter(mode) {
     }
     const skill = segments[1];
     if (skill === void 0) return true;
+    if (mode === "tools" && hostedExtras.has(skill)) return opts.hosted === true;
     return skillFamilyOf(skill) === mode;
   };
 }
@@ -1057,38 +1062,13 @@ async function pruneRemovedSkills(skillsDir, log) {
   }
   return removed.length > 0;
 }
-async function pruneToolCards(log, overrides) {
-  let removedAny = false;
-  for (const target of resolveAgentTargets(overrides ?? {})) {
-    const skillsDir = path4.join(target.baseDir, "skills");
-    for (const name of TOOL_SKILLS) {
-      const dir = path4.join(skillsDir, name);
-      try {
-        await fs4.access(dir);
-      } catch {
-        continue;
-      }
-      try {
-        await fs4.rm(dir, { recursive: true });
-        removedAny = true;
-      } catch {
-      }
-    }
-  }
-  if (removedAny) {
-    log?.plain(
-      "\u{1F9F9} Removed the Genex Tools cards \u2014 this is a game workspace now, and the game skills cover every lane."
-    );
-  }
-  return removedAny;
-}
-async function syncSkillsForTarget(target, templatesDir = getTemplatesDir(), version = getCliVersion(), log, family = "game") {
+async function syncSkillsForTarget(target, templatesDir = getTemplatesDir(), version = getCliVersion(), log, family = "game", hosted = false) {
   const skillsDir = path4.join(target.baseDir, "skills");
   if (!await hasGenexSkills(skillsDir)) return false;
   if (await readSkillsMarker(skillsDir) === version) return false;
   const src = target.full ? templatesDir : path4.join(templatesDir, "skills");
   const dest = target.full ? target.baseDir : skillsDir;
-  const familyFilter = skillFamilyFilter(family);
+  const familyFilter = skillFamilyFilter(family, { hosted });
   const filter = target.full ? familyFilter : (rel) => familyFilter(`skills/${rel}`);
   await copyTemplates(src, dest, {
     exclude: ["controllers", "motion", "asset-viewer", "blender-service"],
@@ -1142,17 +1122,18 @@ async function cleanupLegacyGlobalSkills(log) {
     return false;
   }
 }
-async function syncSkills(log, mode) {
+async function syncSkills(log, workspace) {
   try {
     await cleanupLegacyGlobalSkills(log);
     const version = getCliVersion();
     const templatesDir = getTemplatesDir();
-    const resolved = mode !== void 0 ? mode : await workspaceMode();
+    const ws = workspace !== void 0 ? workspace : await resolveWorkspace();
+    const resolved = ws.mode;
     const family = resolved === "tools" ? "tools" : "game";
     let refreshed = false;
     for (const target of resolveAgentTargets()) {
       try {
-        refreshed = await syncSkillsForTarget(target, templatesDir, version, log, family) || refreshed;
+        refreshed = await syncSkillsForTarget(target, templatesDir, version, log, family, ws.hosted) || refreshed;
       } catch {
       }
     }
@@ -1163,7 +1144,7 @@ async function syncSkills(log, mode) {
           log.plain("\u{1F504} Genex build contract refreshed (AGENTS.md managed block)");
         }
       } else if (resolved === "tools") {
-        if (await writeToolsContract(process.cwd())) {
+        if (await writeToolsContract(process.cwd(), { hosted: ws.hosted })) {
           log.plain("\u{1F504} Genex Tools workspace rules refreshed (AGENTS.md managed block)");
         }
       } else {
@@ -1612,15 +1593,28 @@ function warnPreexisting(log, entries) {
 async function runInit(opts) {
   const log = createLogger({ quiet: opts.quiet });
   const ws = await readWorkspace();
+  const project = ws?.mode === "tools" ? await readProject() : null;
+  if (ws?.mode === "tools" && project) {
+    log.success(
+      `This folder is already connected to the Genex game ${c.cyan(project.slug)} \u2014 nothing to convert.`
+    );
+    log.plain(
+      [
+        `  ${c.cyan("\u2192")} ${c.cyan("npx genex preview")} builds the game and puts it on its draft page.`,
+        `  ${c.cyan("\u2192")} ${c.cyan("npx genex doctor")} checks sign-in, credits and the lanes.`
+      ].join("\n")
+    );
+    return;
+  }
   if (ws?.mode === "tools" && !opts.convert) {
     log.error(
-      "This folder is a Genex Tools workspace \u2014 turning it into a hosted Genex game is the user's call."
+      "This folder is a Genex Tools workspace \u2014 putting its game on Genex is the user's call."
     );
     log.plain(
       [
         "  Converting means: a Genex project is created for this folder, the source is pushed to a",
         "  private Genex-managed repo, and the game gets its own play URL and draft page. The code",
-        "  stays here and stays theirs; nothing is moved or rewritten.",
+        "  stays here and stays theirs, this toolkit stays as it is; nothing is moved or rewritten.",
         `  ${c.cyan("\u2192")} Ask the user first. If they say yes: ${c.cyan("npx genex init --convert")}`,
         `  ${c.cyan("\u2192")} Just want the tools working? ${c.cyan("npx genex doctor")} says what needs fixing.`
       ].join("\n")
@@ -1646,10 +1640,11 @@ async function runInit(opts) {
   for (const t of targets) {
     const src = t.full ? templatesDir : path7.join(templatesDir, "skills");
     const dest = t.full ? t.baseDir : path7.join(t.baseDir, "skills");
+    const family = converting ? skillFamilyFilter("tools", { hosted: true }) : skillFamilyFilter("game");
     const { copied, updated } = await copyTemplates(src, dest, {
       force: opts.force,
       exclude: ["controllers", "motion", "asset-viewer", "blender-service"],
-      filter: t.full ? skillFamilyFilter("game") : (rel) => skillFamilyFilter("game")(`skills/${rel}`)
+      filter: t.full ? family : (rel) => family(`skills/${rel}`)
     });
     await pruneRemovedSkills(path7.join(t.baseDir, "skills"), log);
     await writeSkillsMarker(path7.join(t.baseDir, "skills"));
@@ -1693,7 +1688,7 @@ async function runInit(opts) {
     savedToken = false;
   }
   await writeGitignore(process.cwd(), log);
-  if (await writeAgentsContract(process.cwd())) {
+  if (!converting && await writeAgentsContract(process.cwd())) {
     log.dim("  wrote the Genex build contract into AGENTS.md (managed block) + CLAUDE.md stub");
   }
   await healAncestorContractsAndReport(log, process.cwd());
@@ -1751,9 +1746,9 @@ async function runInit(opts) {
   log.dim(`  saved ${c.cyan(metaPath)}`);
   await writeGameConfigFiles(meta, log);
   if (converting) {
-    await fs7.rm(getWorkspacePath(process.cwd()), { force: true }).catch(() => {
-    });
-    await pruneToolCards(log, { dir: opts.dir, agents: opts.agents });
+    if (await writeToolsContract(process.cwd(), { hosted: true })) {
+      log.dim("  wrote the Genex Tools publishing rules into AGENTS.md (managed block)");
+    }
     await ensureEnvVar(path7.join(process.cwd(), ".env"), "VITE_GENEX_SLUG", meta.slug, log);
     await reportCliEvent(apiUrl, token, "tools_converted");
   }
@@ -1762,17 +1757,19 @@ async function runInit(opts) {
   log.success("All set. \u{1F680}");
   if (converting) {
     log.plain("");
-    log.plain(c.bold("Converted: this folder is now a hosted Genex game workspace."));
+    log.plain(c.bold("Connected: this game now has a home on Genex. Publish it as it is \u2014 nothing else changes."));
     log.plain(
       [
-        "  The Genex Tools cards were replaced by the full game skill set; the AGENTS.md rules",
-        "  changed with them.",
+        "  This is still a Genex Tools workspace (same cards, same rules, assets in ./assets); it gained",
+        `  the publishing commands, the ${c.cyan("genex-tool-publish")} card and three rules about shipping.`,
+        "  Do NOT start a design document, a build plan or a rework \u2014 the user asked for it online.",
         "  Next, to get the game on its draft page:",
         `  1. Make sure the game builds to static files with ${c.cyan("npm run build")} into ${c.cyan("dist/")} (or an`,
         `     index.html at the root) and asset paths are relative (Vite: ${c.cyan("base: './'")}).`,
-        `  2. Load the ${c.cyan("genex-threejs-embed-auth")} skill and add the one ${c.cyan("initEmbed()")} call at the`,
+        `  2. Load the ${c.cyan("genex-threejs-embed-auth")} card and add the one ${c.cyan("initEmbed()")} call at the`,
         "     top of the game's boot code.",
-        `  3. ${c.cyan("npx genex preview")} \u2014 then send the user their draft page link.`
+        `  3. ${c.cyan("npx genex preview")} \u2014 then send the user their draft page link. Its preflight lines`,
+        "     are a report to relay in one sentence each, not work to do before the link."
       ].join("\n")
     );
   }
@@ -4832,7 +4829,7 @@ async function deployGame(ctx, opts, log) {
   }
   printMobilePreflight(files, log);
   await printUiAuditPreflight(log);
-  await printPipelineStatePreflight(log);
+  if (await workspaceMode(cwd) !== "tools") await printPipelineStatePreflight(log);
   const commit = contentCommit(files);
   log.step("Requesting an upload token\u2026");
   const grant = await getUploadToken(ctx, commit, log);
@@ -8487,7 +8484,8 @@ async function runWaitAll(opts) {
     rows.push(await toRow(e, v, cwd));
   }
   const delivered = [];
-  if (!opts.noDownload && await workspaceMode(cwd) === "tools") {
+  const mode = await workspaceMode(cwd);
+  if (!opts.noDownload && mode === "tools") {
     for (const e of ledger) {
       const v = views.get(e.id);
       if (v?.status !== "completed" || !v.files?.length) continue;
@@ -8558,7 +8556,7 @@ async function runWaitAll(opts) {
   }
   log.plain("");
   log.dim(
-    "  \u{1F4DC} Resumed or compacted? Re-read AGENTS.md + DESIGN.md (continue from its Now: line) before building on."
+    mode === "tools" ? "  \u{1F4DC} Resumed or compacted? Re-read AGENTS.md before building on." : "  \u{1F4DC} Resumed or compacted? Re-read AGENTS.md + DESIGN.md (continue from its Now: line) before building on."
   );
 }
 async function toRow(e, v, cwd) {
@@ -18614,7 +18612,8 @@ async function runCharacterAdopt(opts) {
     fail2(opts, "Not authorized. Run `genex init` first to sign in.", "character");
     return;
   }
-  if (await workspaceMode() === "tools") {
+  const ws = await resolveWorkspace();
+  if (ws.mode === "tools" && !ws.hosted) {
     reportPlatformRefused(log, "character adopt");
     process.exitCode = 1;
     return;
@@ -21105,7 +21104,7 @@ async function runBlender(opts) {
     return serveLocalBlender({ port, log });
   }
   if (sub === "mcp") {
-    const { runBlenderMcp } = await import("./blender-mcp-PWOUSXK4.js");
+    const { runBlenderMcp } = await import("./blender-mcp-TTLZ24PD.js");
     return runBlenderMcp();
   }
   if (sub === "seat") {
@@ -22061,6 +22060,18 @@ async function latestPublished() {
 async function runTools(opts) {
   const log = createLogger({ quiet: opts.quiet });
   const project = await readProject();
+  if (project && (await readWorkspace())?.mode === "tools") {
+    log.success(
+      `This folder is already a Genex Tools workspace, connected to the game ${c.cyan(project.slug)}.`
+    );
+    log.plain(
+      [
+        "  The tool cards refresh on every command; nothing to set up.",
+        `  ${c.cyan("\u2192")} ${c.cyan("npx genex doctor")} checks sign-in, credits and the lanes.`
+      ].join("\n")
+    );
+    return;
+  }
   if (project) {
     log.error("This folder is already a Genex game project.");
     log.plain(
@@ -22473,9 +22484,10 @@ ${c.bold("Options for `init`")}
   --auth-url <url>     Override the auth site (default: ${DEFAULT_AUTH_URL}).
   --api-url <url>      Override the API base URL (default: ${DEFAULT_API_URL}).
   --no-auth            Only scaffold templates; skip authorization.
-  --convert            In a Genex Tools workspace: with the user's explicit yes, turn
-                       the folder into a hosted game workspace in place (init is
-                       otherwise refused there). Ask the user before passing this.
+  --convert            In a Genex Tools workspace: with the user's explicit yes, connect
+                       the folder to a hosted Genex game in place \u2014 the toolkit stays,
+                       the publishing commands open (init is otherwise refused there).
+                       Ask the user before passing this.
   --force              Overwrite existing files (default: never overwrite).
   --timeout <seconds>  How long to wait inline for sign-in approval before handing
                        off to 'genex auth' (default: 100). The code itself stays
@@ -23456,14 +23468,14 @@ async function main() {
   setWorkspaceHeader(workspaceHeaderLabel(workspace));
   if (parsed.help || parsed.command === void 0) {
     const perCommand = parsed.command === void 0 ? void 0 : COMMAND_HELP[parsed.command];
-    log.plain(perCommand ?? (mode === "tools" ? HELP_TOOLS : HELP));
+    log.plain(perCommand ?? (mode === "tools" && !workspace.hosted ? HELP_TOOLS : HELP));
     return;
   }
   const isBlenderMcp = parsed.command === "blender" && parsed.options.name === "mcp";
   const quietUpdates = Boolean(parsed.options.quiet || parsed.options.json || isBlenderMcp);
   const updateLog = createLogger({ quiet: quietUpdates });
   if (parsed.command !== "init" && parsed.command !== "tools") {
-    await syncSkills(updateLog, mode);
+    await syncSkills(updateLog, workspace);
   }
   const updateCheck = startUpdateCheck();
   Sentry2.setTag("command", parsed.command);
@@ -23478,7 +23490,7 @@ async function main() {
     ci: !!process.env.CI
   });
   try {
-    if (mode === "tools" && refusedInTools(parsed.command)) {
+    if (platformRefusedIn(workspace, parsed.command)) {
       reportPlatformRefused(log, parsed.command);
       process.exitCode = 1;
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.25.1-dev.618",
+  "version": "1.26.0-dev.620",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-tool-publish/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: genex-tool-publish
+description: Put the game in this folder on the web with Genex — the draft page, `npx genex preview`, then `promote` / `publish`; the link you hand the user, the size limits, and what to do with the preflight lines. Installed once the folder is connected to a hosted Genex game (`npx genex init --convert`). Load it before the first preview.
+---
+
+# Genex Tools · Publish
+
+The user built this game themselves and asked for it online. Your job is to
+put it there **as it is** — the code, the structure and the assets stay
+exactly what they are. Publishing adds glue and nothing else; it never starts
+a rework, a design document or a build plan.
+
+## The glue (all of it)
+
+1. **A static build.** The game must build to files with its own build
+   command — `npm run build` into `dist/`, or an `index.html` at the root
+   with no build step. Asset paths must work from the game's own hosted URL,
+   so prefer relative ones (Vite: `base: './'`). Files the game loads at
+   runtime — everything in `./assets` — must end up inside the build (Vite:
+   a `public/` folder, or copy `assets/` into `dist/` in the build).
+2. **Player identity.** Load `$genex-threejs-embed-auth` and add the one
+   `initEmbed(...)` call at the very top of the boot code. Create the
+   renderer and draw a frame BEFORE any `await waitForPlayer()` — on a hosted
+   page identity takes seconds, and a game that awaits it first ships black.
+3. **The CLI as a dev dependency** so plain `npx genex` keeps resolving here
+   (setup already did this; check `package.json` if in doubt).
+
+Commit the glue as its own small commit when the folder is a git repo, so the
+line between the user's game and what publishing added stays visible.
+
+## Preview
+
+```bash
+npx genex preview
+```
+
+Builds, uploads and puts the build on the game's **draft page** — unlisted,
+only the user can open it. When it reports live, open the hosted build once
+yourself and confirm it loads with no missing files (the dev server forgives
+paths the hosted build will not), then hand over the link.
+
+**The link is always the game's page on Genex, never the raw play address,
+never localhost, never a file path:**
+
+- draft: `<dashboard>/draft/<slug>`
+- public, once published: `<dashboard>/world/<slug>`
+
+`<dashboard>` is the first `dashboardOrigins` entry in `.genex/project.json`
+and `<slug>` is the `slug` there. `preview` prints the exact page link as
+"your game's page" — use that line verbatim.
+
+## The preflight is a report, not a to-do list
+
+`preview` prints warning lines before it uploads — an estimated phone GPU
+budget, a music track with no volume slider, a paid asset nobody wired, a
+viewport meta line. None of them blocks the deploy, and none of them was
+asked for. So: **ship first**, hand over the link, then relay each line to
+the user in one plain sentence with an offer ("phones will struggle with the
+textures — want me to shrink them?"). Fix one only on the user's yes. Never
+turn the report into a milestone before the link.
+
+## Draft and public version
+
+`preview` updates the **draft** and never touches what players are on. The
+first release lists the game:
+
+```bash
+npx genex publish --categories games
+```
+
+Pick 1–3 categories that fit (`games`, `assets`, `physics`, `terrain`,
+`lighting`, `vfx`); `games` when unsure. Ask before the first publish — "This
+is a private draft only you can open. Say the word and I'll publish it for
+anyone to play." — and celebrate the public page link when it lands.
+
+After that first release the game is two versions, and the user only ever
+hears these two words for them: the **draft** (updated by `preview`) and the
+**public version** (what everyone plays). "Publish it", "update it" and "yes"
+after the first release ALL mean:
+
+```bash
+npx genex promote      # the exact draft build goes public — no rebuild
+```
+
+Never run `publish` a second time (it would ship an untried rebuild). If
+anything changed since the last `preview`, preview again before promoting.
+Ask once per round of work, in one line, and keep working while you wait.
+
+## Limits and refusals
+
+- **Upload size**: ~95 MB per file, ~500 MB in total. Over that, tell the user
+  plainly which part is too large (usually a video, model or audio file) and by
+  roughly how much; ask before compressing or removing anything.
+- **Terms refusal**: the CLI prints a link, waits for the user's click and
+  re-sends by itself — hand the link over and let it finish.
+- **`preview` says the folder is behind another machine** (`stale_source`):
+  `npx genex pull` takes the newer draft, then redo the change — never
+  `--force` over somebody else's work.
+- **Out of credits or a lane down**: `npx genex doctor` says which; publishing
+  itself costs nothing.

package/templates/skills/genex-tool-workflow/SKILL.md

@@ -92,6 +92,7 @@ tiling floor and three paid assets nobody loaded.
 Hosting, publishing, multiplayer, remixing and custom domains are the Genex
 platform, not this toolkit — those commands are refused in this folder by
 design, and the refusal says where they live. This workspace generates assets
-for a game you build and ship yourself — and when the user wants that game
-live on Genex with its own URL, the workspace can convert to a hosted game
-(the AGENTS.md rules say how).
+for a game you build and ship yourself. When the user wants that game live on
+Genex with its own URL, the AGENTS.md rules say how to offer it; on a yes the
+folder is connected to a hosted game in place — same cards, same rules — and
+the `$genex-tool-publish` card arrives with the publishing commands.