@genex-ai/cli-demo 1.5.2-dev.397 → 1.6.0-dev.399

package/dist/index.js

@@ -1238,7 +1238,7 @@ async function syncSkillsForTarget(target, templatesDir = getTemplatesDir(), ver
   if (await readSkillsMarker(skillsDir) === version) return false;
   const src = target.full ? templatesDir : path7.join(templatesDir, "skills");
   const dest = target.full ? target.baseDir : skillsDir;
-  await copyTemplates(src, dest, { exclude: ["controllers", "motion"] });
+  await copyTemplates(src, dest, { exclude: ["controllers", "motion", "asset-viewer"] });
   await pruneRemovedSkills(skillsDir, log);
   await writeSkillsMarker(skillsDir, version);
   return true;
@@ -1722,7 +1722,7 @@ async function runInit(opts) {
     const dest = t.full ? t.baseDir : path10.join(t.baseDir, "skills");
     const { copied, updated } = await copyTemplates(src, dest, {
       force: opts.force,
-      exclude: ["controllers", "motion"]
+      exclude: ["controllers", "motion", "asset-viewer"]
     });
     await pruneRemovedSkills(path10.join(t.baseDir, "skills"), log);
     await writeSkillsMarker(path10.join(t.baseDir, "skills"));
@@ -17564,22 +17564,22 @@ async function context2(opts) {
   const project = await readProject();
   return { token, apiUrl: getApiUrl(opts.apiUrl ?? project?.apiUrl) };
 }
-async function readVideo(path22, log) {
+async function readVideo(path23, log) {
   let bytes;
   try {
-    bytes = await readFile(path22);
+    bytes = await readFile(path23);
   } catch {
-    log.error(`Can't read ${path22}.`);
+    log.error(`Can't read ${path23}.`);
     return null;
   }
   if (bytes.byteLength > MAX_VIDEO_BYTES) {
-    log.error(`${basename(path22)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
+    log.error(`${basename(path23)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
     return null;
   }
   return bytes;
 }
-async function uploadVideo(apiUrl, token, characterId, path22, bytes, log) {
-  const contentType = /\.mov$/i.test(path22) ? "video/quicktime" : "video/mp4";
+async function uploadVideo(apiUrl, token, characterId, path23, bytes, log) {
+  const contentType = /\.mov$/i.test(path23) ? "video/quicktime" : "video/mp4";
   const minted = await apiFetch(
     `${apiUrl}/api/characters/${encodeURIComponent(characterId)}/motions/video-url`,
     {
@@ -17594,7 +17594,7 @@ async function uploadVideo(apiUrl, token, characterId, path22, bytes, log) {
     return null;
   }
   const { uploadUrl, videoUrl } = await minted.json();
-  log.dim(`  uploading ${basename(path22)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${basename(path23)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": contentType, "Content-Length": String(bytes.byteLength) },
@@ -19452,6 +19452,241 @@ async function runMotion(opts) {
   }
 }
 
+// src/commands/asset-new.ts
+import fs23 from "fs";
+import fsp from "fs/promises";
+import path22 from "path";
+import { pathToFileURL } from "url";
+var EXTRA_FILES = [
+  "genex-asset.example.json",
+  "public/fonts/Geist-variable.woff2",
+  "public/fonts/GeistMono-variable.woff2"
+];
+var HOLDER_PLACEHOLDER = "Your Name";
+function parseDims(input) {
+  const parts = String(input).toLowerCase().split("x").map((p) => Number(p.trim()));
+  if (parts.length !== 3 || parts.some((n) => !Number.isFinite(n) || n <= 0)) {
+    throw new Error(`--dims must look like 0.36x0.36x0.70 (width x depth x height), got: ${input}`);
+  }
+  const [width, depth, height] = parts;
+  return [width, height, depth];
+}
+function parseBand(input) {
+  const parts = String(input).split("-").map((p) => Number(p.replace(/[_,\s]/g, "")));
+  const [lo, hi] = parts;
+  if (parts.length !== 2 || lo === void 0 || hi === void 0 || !Number.isInteger(lo) || !Number.isInteger(hi) || lo <= 0 || lo >= hi) {
+    throw new Error(`--tri-band must look like 800-2000, got: ${input}`);
+  }
+  return [lo, hi];
+}
+function titleCase(slug) {
+  return slug.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+function seedAssetSource(placeholder, opts) {
+  const pascal = opts.pascalCase(opts.slug);
+  let out = placeholder.replaceAll("Placeholder", pascal);
+  const line = (pattern, replacement) => {
+    if (!pattern.test(out)) {
+      throw new Error(`the template's PLACEHOLDER.ts no longer carries the scaffold line ${pattern}`);
+    }
+    out = out.replace(pattern, replacement);
+  };
+  line(/^\/\/ .* - procedural Three\.js asset\.$/m, `// ${opts.name} - procedural Three.js asset.`);
+  line(
+    /^\/\/ MIT License - Copyright \(c\) \d+ .*$/m,
+    `// MIT License - Copyright (c) ${opts.year} ${opts.holder}. Free to use, modify and ship.`
+  );
+  line(/^const SLUG = .*$/m, `const SLUG = '${opts.slug}';`);
+  line(/^const NAME = .*$/m, `const NAME = '${opts.name.replaceAll("'", "\\'")}';`);
+  line(
+    /^const SIZE_METERS: \[number, number, number\] = .*$/m,
+    `const SIZE_METERS: [number, number, number] = [${opts.sizeMeters.join(", ")}];`
+  );
+  line(/^const TARGET_TRIANGLES = .*$/m, `const TARGET_TRIANGLES = ${opts.targetTriangles};`);
+  return out;
+}
+function fillTemplate(text, values) {
+  return text.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+    const value = values[key];
+    if (value === void 0) throw new Error(`unfilled placeholder: {{${key}}}`);
+    return value;
+  });
+}
+var GITIGNORE = ["node_modules/", "dist/", ".gates/", ".genex/", ".env", ".env.*", "!.env.example", ""].join("\n");
+function designDoc(opts) {
+  return `# ${opts.name}
+
+A free, MIT-licensed procedural Three.js asset for the Genex asset library.
+One file, one factory, no dependency but \`three\`.
+
+- **slug:** \`${opts.slug}\`
+- **size:** ${opts.sizeMeters.map((n) => n.toFixed(2)).join(" \xD7 ")} m (x \xD7 y \xD7 z, y = height)
+- **triangle band:** ${opts.triBand[0].toLocaleString("en-US")} - ${opts.triBand[1].toLocaleString("en-US")}
+- **origin:** base centre, y = 0. **Units:** metres. **Facing:** Y-up, +Z forward.
+- **licence:** MIT, copyright ${opts.holder}. Publishing this asset releases it MIT \u2014
+  the dashboard's Copy code button makes it copyable by anyone.
+
+## Boundary note
+
+This asset is **code**, not generated art: the lane is procedural geometry
+authored in TypeScript. No player character applies \u2014 the project is a viewer,
+not a game.
+
+## Build plan & status
+
+1. [ ] blockout - silhouette and real dimensions
+2. [ ] form-refinement - the details that make it read as manufactured
+3. [ ] material-pass - MeshStandardMaterial + DataTexture only
+4. [ ] interaction-pass - \`assetRuntime.nodes\`, \`dispose()\`, options
+
+**Now:** milestone 1.
+
+Every milestone ends with \`npm run verify\`, then \`npx genex preview --no-build\`.
+
+## Decisions
+`;
+}
+async function runAssetNew(options) {
+  const log = createLogger();
+  const cwd = options.dir ? path22.resolve(options.dir) : process.cwd();
+  const slug = options.assetSlug;
+  if (!slug) {
+    log.error('Usage: genex asset new <slug> [--title "<Name>"] [--dims WxDxH] [--tri-band LOW-HIGH] [--holder "<your name>"] [--out <dir>]');
+    return 1;
+  }
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug)) {
+    log.error(`The slug must be kebab-case (letters, digits, dashes), got: ${slug}`);
+    return 1;
+  }
+  const templateDir = path22.join(getTemplatesDir(), "asset-viewer");
+  if (!fs23.existsSync(templateDir)) {
+    log.error(`Vendored asset-viewer template not found at ${templateDir} \u2014 reinstall the CLI.`);
+    return 1;
+  }
+  const manifestTools = await import(pathToFileURL(path22.join(templateDir, "tools", "emit-manifest.mjs")).href);
+  const { SHARED_FILES, PARITY_FILENAME, hashSharedFiles, pascalCase } = manifestTools;
+  const lockPath = path22.join(templateDir, "shared-files.sha256.json");
+  const lock = JSON.parse(await fsp.readFile(lockPath, "utf8"));
+  const actual = hashSharedFiles(templateDir);
+  const drifted = SHARED_FILES.filter((rel) => lock.files[rel] !== actual[rel]);
+  if (drifted.length) {
+    log.error(`The bundled viewer template is damaged (${drifted.join(", ")}) \u2014 reinstall the CLI.`);
+    return 1;
+  }
+  const name = options.title ?? titleCase(slug);
+  const sizeMeters = parseDims(options.dims ?? "1x1x1");
+  const triBand = parseBand(options.triBand ?? "500-8000");
+  const holder = options.holder?.trim() || HOLDER_PLACEHOLDER;
+  const year = (/* @__PURE__ */ new Date()).getUTCFullYear();
+  const outDir = path22.resolve(cwd, options.out ?? slug);
+  if (fs23.existsSync(outDir) && fs23.readdirSync(outDir).length > 0 && !options.force) {
+    log.error(`${outDir} already holds files. Nothing was touched \u2014 pass --force to write into it anyway.`);
+    return 1;
+  }
+  const version = "1.0.0";
+  const targetTriangles = Math.round((triBand[0] + triBand[1]) / 2);
+  const config = {
+    slug,
+    name,
+    summary: options.summary ?? `${name} - a free procedural Three.js asset, ${sizeMeters.map((n) => n.toFixed(2)).join(" \xD7 ")} m.`,
+    tags: (options.tags ?? "prop").split(",").map((t) => t.trim()).filter(Boolean),
+    materialClass: "unclassified",
+    geometryClass: "unclassified",
+    difficulty: "easy",
+    version,
+    minThreeRevision: 160,
+    statedSizeMeters: sizeMeters,
+    triBand,
+    drawCallMax: 8,
+    materialMax: 4,
+    textureBytesMax: 4194304,
+    maxTextureDimension: 1024,
+    silhouetteCollapseRatio: 0.15,
+    license: { holder, year },
+    viewer: { cameraDistanceMul: 1 }
+  };
+  await fsp.mkdir(outDir, { recursive: true });
+  for (const rel of [...SHARED_FILES, ...EXTRA_FILES]) {
+    const to = path22.join(outDir, rel);
+    await fsp.mkdir(path22.dirname(to), { recursive: true });
+    await fsp.copyFile(path22.join(templateDir, rel), to);
+  }
+  const pkg = fillTemplate(await fsp.readFile(path22.join(templateDir, "package.json"), "utf8"), {
+    slug,
+    name,
+    version
+  });
+  await fsp.writeFile(path22.join(outDir, "package.json"), pkg, "utf8");
+  await fsp.writeFile(path22.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
+  await fsp.writeFile(path22.join(outDir, ".gitignore"), GITIGNORE, "utf8");
+  await fsp.writeFile(
+    path22.join(outDir, "DESIGN.md"),
+    designDoc({ name, slug, sizeMeters, triBand, holder }),
+    "utf8"
+  );
+  const placeholder = await fsp.readFile(path22.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
+  const seeded = seedAssetSource(placeholder, {
+    slug,
+    name,
+    sizeMeters,
+    targetTriangles,
+    holder,
+    year,
+    pascalCase
+  });
+  const assetFilename = `${slug.replace(/-([a-z0-9])/g, (_, ch) => ch.toUpperCase())}.ts`;
+  await fsp.mkdir(path22.join(outDir, "src", "asset"), { recursive: true });
+  await fsp.writeFile(path22.join(outDir, "src", "asset", assetFilename), seeded, "utf8");
+  const copied = hashSharedFiles(outDir);
+  const mismatched = SHARED_FILES.filter((rel) => copied[rel] !== lock.files[rel]);
+  if (mismatched.length) {
+    log.error(`Internal error: copy was not verbatim for ${mismatched.join(", ")}`);
+    return 1;
+  }
+  await fsp.writeFile(
+    path22.join(outDir, PARITY_FILENAME),
+    JSON.stringify(
+      {
+        note: "Recorded by `genex asset new`. Gate G13 recomputes these; do not hand-edit the viewer.",
+        templateVersion: lock.templateVersion,
+        scaffoldedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        files: copied
+      },
+      null,
+      2
+    ) + "\n",
+    "utf8"
+  );
+  const lines = [
+    "",
+    `  ${c.bold(name)}  \u2192  ${outDir}`,
+    `  ${sizeMeters.map((n) => n.toFixed(2)).join(" \xD7 ")} m \xB7 ${triBand[0].toLocaleString("en-US")} - ${triBand[1].toLocaleString("en-US")} tris \xB7 viewer ${lock.templateVersion}`,
+    ""
+  ];
+  if (holder === HOLDER_PLACEHOLDER) {
+    lines.push(
+      `  ${c.yellow("\u26A0")} No --holder given: the MIT copyright line says "${HOLDER_PLACEHOLDER}".`,
+      `    Set the real name in asset.config.json (license.holder) AND line 2 of src/asset/${assetFilename}`,
+      `    before publishing \u2014 published assets are copyable by anyone under that name.`,
+      ""
+    );
+  }
+  lines.push(
+    "  next:",
+    `    cd ${outDir}`,
+    "    npm install",
+    "    npx playwright-core install chromium   # once per machine",
+    `    # author src/asset/${assetFilename} \u2014 the genex-asset-author skill carries the contract`,
+    "    npm run verify                          # build + 17 gates + manifest stamp",
+    "    npx genex init                          # create the project (sign-in if needed)",
+    "    npx genex preview --no-build            # draft turntable to show the user",
+    "    npx genex publish --no-build --categories assets",
+    ""
+  );
+  log.plain(lines.join("\n"));
+  return 0;
+}
+
 // src/index.ts
 var GEN_KINDS = /* @__PURE__ */ new Set(["model", "skybox", "sfx", "music", "voice", "texture", "image", "video"]);
 var HELP = `${c.bold("genex")} \u2014 set up your project's agent workspace, authorize, and publish 3D games.
@@ -19564,6 +19799,13 @@ ${c.bold("Usage")}
                                      extract | masks | text-color | trim | audit.
                                      Pure local work (no API); the PNG tools read
                                      a file or URL, audit scans the project.
+  genex asset new <slug>             Scaffold ONE asset project for the free MIT
+                                     asset library (its own project \u2014 one asset,
+                                     one turntable page). Only when the user asks
+                                     to make or publish an asset \u2014 never offered
+                                     unprompted. Options: --title --dims WxDxH
+                                     --tri-band LOW-HIGH --holder "<your name>"
+                                     --summary --tags --out --force.
 
 ${c.bold("Options for the generators (`model` `sfx` `music` `voice` `texture` `image` `video`)")}
   --terrain            (texture) seamless tiling surface for terrain/ground.
@@ -19844,7 +20086,13 @@ function parseArgs(argv) {
     "--config",
     "--set",
     "--speed",
-    "--video"
+    "--video",
+    // `genex asset new` value flags.
+    "--dims",
+    "--tri-band",
+    "--holder",
+    "--summary",
+    "--tags"
   ]);
   let i = 0;
   while (i < argv.length) {
@@ -20013,6 +20261,13 @@ function parseArgs(argv) {
           }
         } else if (parsed.command === "animations") {
           parsed.options.query = parsed.options.query ? `${parsed.options.query} ${arg}` : arg;
+        } else if (parsed.command === "asset") {
+          if (parsed.options.name === "new" && parsed.options.assetSlug === void 0) {
+            parsed.options.assetSlug = arg;
+          } else {
+            parsed.error = `Unexpected argument: ${arg}`;
+            return parsed;
+          }
         } else {
           parsed.error = `Unexpected argument: ${arg}`;
           return parsed;
@@ -20149,6 +20404,21 @@ function applyValueFlag(options, flag, value) {
     case "--set":
       options.set = value;
       break;
+    case "--dims":
+      options.dims = value;
+      break;
+    case "--tri-band":
+      options.triBand = value;
+      break;
+    case "--holder":
+      options.holder = value;
+      break;
+    case "--summary":
+      options.summary = value;
+      break;
+    case "--tags":
+      options.tags = value;
+      break;
     case "--speed": {
       const n = Number(value);
       if (!Number.isFinite(n) || n <= 0) {
@@ -20435,6 +20705,14 @@ async function main() {
           await runAnimationsSearch(parsed.options);
         }
         break;
+      case "asset":
+        if (parsed.options.name !== "new") {
+          log.error("Unknown asset command. Use `genex asset new <slug>`.");
+          process.exitCode = 1;
+        } else {
+          process.exitCode = await runAssetNew(parsed.options);
+        }
+        break;
       case "preview":
         await runPreview(parsed.options);
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.5.2-dev.397",
+  "version": "1.6.0-dev.399",
   "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/asset-viewer/asset.config.json

@@ -0,0 +1,25 @@
+{
+  "slug": "placeholder",
+  "name": "Placeholder Asset",
+  "summary": "Scaffold stand-in: a revolved pedestal marker that already satisfies the asset contract.",
+  "tags": ["prop", "scaffold"],
+  "materialClass": "plastic",
+  "geometryClass": "revolved",
+  "difficulty": "easy",
+  "version": "1.0.0",
+  "minThreeRevision": 160,
+  "statedSizeMeters": [0.4, 0.6, 0.4],
+  "triBand": [200, 4000],
+  "drawCallMax": 8,
+  "materialMax": 4,
+  "textureBytesMax": 4194304,
+  "maxTextureDimension": 1024,
+  "silhouetteCollapseRatio": 0.15,
+  "license": {
+    "holder": "Genex",
+    "year": 2026
+  },
+  "viewer": {
+    "cameraDistanceMul": 1
+  }
+}