@puzzmo/cli 1.0.38 → 1.0.40

package/lib/util/api.js

@@ -2,6 +2,15 @@ import fs from "node:fs";
 import path from "node:path";
 import { getAPIURL } from "./config.js";
 const BATCH_SIZE = 10;
+/** Thrown when /cliUpload init returns a 404 because the game slug isn't registered yet. */
+export class GameNotFoundError extends Error {
+    slug;
+    constructor(slug, message) {
+        super(message);
+        this.slug = slug;
+        this.name = "GameNotFoundError";
+    }
+}
 /** Wraps fetch to surface the underlying network cause (DNS, ECONNREFUSED, TLS, etc.) */
 const fetchWithContext = async (url, init, step, verbose) => {
     if (verbose)
@@ -66,8 +75,18 @@ const uploadFile = async (url, token, filePath, baseDir, verbose) => {
         },
         body: content,
     }, step, verbose);
+    if (res.status === 413)
+        throw new Error(`File ${relativePath} is too large to upload (${formatBytes(content.length)})`);
     return (await readResponse(res, fullURL, step, verbose));
 };
+/** Formats a byte count as a human-readable string (e.g. "1.6 MB") */
+const formatBytes = (bytes) => {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+};
 /** Multi-step upload: init -> batched file uploads -> complete */
 export const uploadFiles = async (token, gameSlug, sha, filePaths, baseDir, puzzmoFile, onProgress, options = {}) => {
     const { verbose = false, description, repoURL } = options;
@@ -75,7 +94,15 @@ export const uploadFiles = async (token, gameSlug, sha, filePaths, baseDir, puzz
     if (verbose)
         console.log(`  API URL: ${apiURL}`);
     // Step 1: Init session (includes puzzmo.json metadata)
-    const init = (await jsonPost(`${apiURL}/cliUpload`, token, { gameSlug, sha, puzzmoFile, description, repoURL }, "upload init", verbose));
+    let init;
+    try {
+        init = (await jsonPost(`${apiURL}/cliUpload`, token, { gameSlug, sha, puzzmoFile, description, repoURL }, "upload init", verbose));
+    }
+    catch (e) {
+        if (e instanceof Error && e.message.includes("Game not found:"))
+            throw new GameNotFoundError(gameSlug, e.message);
+        throw e;
+    }
     if (verbose)
         console.log(`  session: ${init.sessionID}`);
     // Step 2: Upload files in concurrent batches

package/lib/util/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/util/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/util/api.ts"],"names":[],"mappings":"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"}

package/lib/util/createGame.d.ts

@@ -0,0 +1,13 @@
+export type CreateUserGameOptions = {
+    /** A teamAccessToken (the same token saved by `puzzmo login`). The mutation uses it to identify the team. */
+    teamAccessToken: string;
+    displayName: string;
+};
+export type CreatedGame = {
+    id: string;
+    slug: string;
+    displayName: string;
+    newAccessToken: string | null;
+};
+/** Calls the createUserGame mutation using a teamAccessToken for auth. */
+export declare const createUserGame: (options: CreateUserGameOptions) => Promise<CreatedGame>;

package/lib/util/createGame.js

@@ -0,0 +1,36 @@
+import { getAPIURL } from "./config.js";
+const createUserGameMutation = `
+  mutation cliCreateUserGameMutation($teamAccessToken: String!, $input: CreateUserGameInput!) {
+    createUserGame(teamAccessToken: $teamAccessToken, input: $input) {
+      game { id slug displayName }
+      newAccessToken
+    }
+  }
+`;
+/** Calls the createUserGame mutation using a teamAccessToken for auth. */
+export const createUserGame = async (options) => {
+    const url = `${getAPIURL()}/graphql`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            query: createUserGameMutation,
+            variables: {
+                teamAccessToken: options.teamAccessToken,
+                input: { displayName: options.displayName },
+            },
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`createUserGame request failed: ${response.status} ${response.statusText}`);
+    const result = (await response.json());
+    if (result.errors?.length) {
+        const message = result.errors.map((e) => e.message).join("; ");
+        throw new Error(`createUserGame failed: ${message}`);
+    }
+    if (!result.data?.createUserGame)
+        throw new Error("createUserGame returned no data");
+    const { game, newAccessToken } = result.data.createUserGame;
+    return { id: game.id, slug: game.slug, displayName: game.displayName, newAccessToken };
+};
+//# sourceMappingURL=createGame.js.map

package/lib/util/createGame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGame.js","sourceRoot":"","sources":["../../src/util/createGame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,sBAAsB,GAAG;;;;;;;CAO9B,CAAA;AAsBD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAA8B,EAAwB,EAAE,CAAC;IAC5F,MAAM,GAAG,GAAG,GAAG,SAAS,EAAE,UAAU,CAAA;IAEpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,sBAAsB;YAC7B,SAAS,EAAE;gBACT,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;aAC5C;SACF,CAAC;KACH,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IAE7G,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAA;IAEhE,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9D,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAEpF,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAA;IAC3D,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,CAAA;AAAA,CACvF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puzzmo/cli",
-  "version": "1.0.38",
+  "version": "1.0.40",
   "type": "module",
   "bin": {
     "puzzmo": "./lib/index.js"

package/src/commands/game/create.ts

@@ -1,5 +1,6 @@
 import fs from "node:fs"
 import path from "node:path"
+import { fileURLToPath } from "node:url"
 import { createRequire } from "node:module"
 import * as p from "@clack/prompts"
 
@@ -7,17 +8,21 @@ import { agentNames } from "../../agents/index.js"
 import { detectAgent } from "../../wizard/agent-detect.js"
 import { downloadPage } from "../../download/page-downloader.js"
 import { runCommand, gitCommit } from "../../util/exec.js"
-import { runSkillsPipelineTUI } from "../../skills/runner.js"
+import { runSkillsPipelineTUI, runAgentWithBuildLoop } from "../../skills/runner.js"
 import { login } from "../login.js"
 import { getToken } from "../../util/config.js"
 import { detectRepoContext, type RepoType } from "./detectRepo.js"
 
+type Strategy = "import" | "blank" | "prompt"
+
 type CreateOptions = {
   name?: string
   url?: string
   agent?: string
   accessToken?: string
   pm?: string
+  strategy?: Strategy
+  prompt?: string
 }
 
 /** Parses CLI args into CreateOptions */
@@ -27,16 +32,15 @@ const parseArgs = (args: string[]): CreateOptions => {
 
   while (i < args.length) {
     const arg = args[i]
-    if (arg === "--name" && args[i + 1]) {
-      opts.name = args[++i]
-    } else if (arg === "--url" && args[i + 1]) {
-      opts.url = args[++i]
-    } else if (arg === "--agent" && args[i + 1]) {
-      opts.agent = args[++i]
-    } else if (arg === "--token" && args[i + 1]) {
-      opts.accessToken = args[++i]
-    } else if (arg === "--pm" && args[i + 1]) {
-      opts.pm = args[++i]
+    if (arg === "--name" && args[i + 1]) opts.name = args[++i]
+    else if (arg === "--url" && args[i + 1]) opts.url = args[++i]
+    else if (arg === "--agent" && args[i + 1]) opts.agent = args[++i]
+    else if (arg === "--token" && args[i + 1]) opts.accessToken = args[++i]
+    else if (arg === "--pm" && args[i + 1]) opts.pm = args[++i]
+    else if (arg === "--prompt" && args[i + 1]) opts.prompt = args[++i]
+    else if (arg === "--strategy" && args[i + 1]) {
+      const v = args[++i]
+      if (v === "import" || v === "blank" || v === "prompt") opts.strategy = v
     }
     i++
   }
@@ -49,7 +53,7 @@ const slugify = (text: string) =>
   text
     .toString()
     .normalize("NFD")
-    .replace(/[\u0300-\u036f]/g, "")
+    .replace(/[̀-ͯ]/g, "")
     .toLowerCase()
     .trim()
     .replace(/\s+/g, "-")
@@ -157,6 +161,71 @@ const convertToMultiGame = (repoRoot: string): string => {
   return existingName
 }
 
+/** Resolves the bundled template directory by name. Templates ship at packages/cli/templates/<name>/ */
+const resolveTemplateDir = (name: string): string => {
+  const here = fileURLToPath(import.meta.url)
+  // here = .../packages/cli/lib/commands/game/create.js → ../../../templates/<name>
+  return path.resolve(here, "..", "..", "..", "..", "templates", name)
+}
+
+/** File extensions where we apply template variable substitution */
+const textExtension = new Set([".md", ".json", ".html", ".css", ".ts", ".tsx", ".js", ".jsx", ".mjs"])
+
+/** Recursively copies a template directory, substituting placeholders in text files. */
+const copyTemplate = (sourceDir: string, targetDir: string, replacements: Record<string, string>) => {
+  fs.mkdirSync(targetDir, { recursive: true })
+  for (const entry of fs.readdirSync(sourceDir, { withFileTypes: true })) {
+    const src = path.join(sourceDir, entry.name)
+    const dst = path.join(targetDir, entry.name)
+    if (entry.isDirectory()) {
+      copyTemplate(src, dst, replacements)
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name)
+      if (textExtension.has(ext) || entry.name === ".gitignore") {
+        let content = fs.readFileSync(src, "utf-8")
+        for (const [key, value] of Object.entries(replacements)) content = content.replaceAll(key, value)
+        fs.writeFileSync(dst, content)
+      } else {
+        fs.copyFileSync(src, dst)
+      }
+    }
+  }
+}
+
+/** Picks an agent interactively, returning the agent id or "none" */
+const pickAgent = async (preselected?: string): Promise<string> => {
+  const supported = new Set(agentNames())
+  const agents = detectAgent().filter((a) => supported.has(a.id))
+  if (preselected) return preselected
+  if (agents.length === 0) {
+    p.log.info(`No supported LLM agents detected (checked: ${agentNames().join(", ")})`)
+    return "none"
+  }
+  const choices = [
+    ...agents.map((a) => ({ value: a.id, label: `${a.displayName} (${a.path})` })),
+    { value: "none", label: "None - I'll run the steps manually" },
+  ]
+  const result = (await p.select({ message: "Which LLM agent do you use?", options: choices })) as string
+  if (p.isCancel(result)) process.exit(0)
+  return result
+}
+
+/** Composes the prompt sent to the agent for the "from prompt" strategy */
+const buildPromptStrategyMessage = (userPrompt: string, displayName: string): string =>
+  [
+    `You are scaffolding a Puzzmo game called "${displayName}" in the current directory.`,
+    `The starter is a working Vite + Puzzmo SDK Minesweeper. Replace the gameplay with the game described below.`,
+    ``,
+    `Game description:`,
+    userPrompt,
+    ``,
+    `Constraints:`,
+    `- Keep puzzmo.json valid (do not remove the slug or displayName fields).`,
+    `- Use the Puzzmo SDK lifecycle: gameReady → gameLoaded → on("start"|"retry") → updateGameState → gameCompleted.`,
+    `- Replace fixtures in fixtures/puzzles/ with puzzles for the new game.`,
+    `- Keep the build green (\`npx vite build\` should succeed).`,
+  ].join("\n")
+
 /** Main game create wizard */
 export const gameCreate = async (args: string[]) => {
   const opts = parseArgs(args)
@@ -165,56 +234,105 @@ export const gameCreate = async (args: string[]) => {
   const { version } = require("../../../package.json")
   p.intro(`Puzzmo Game Creator v${version}`)
 
-  // Step 1: Detect repo context and choose mode
+  // Step 1: Pick strategy
+  let strategy: Strategy
+  if (opts.strategy) {
+    strategy = opts.strategy
+  } else {
+    const choice = await p.select({
+      message: "How would you like to create your game?",
+      options: [
+        { value: "blank" as const, label: "Blank game (Minesweeper template)" },
+        { value: "import" as const, label: "Import from an existing URL (uses an LLM to migrate)" },
+        { value: "prompt" as const, label: "From a prompt (Builds on template + LLM customizations)" },
+      ],
+    })
+    if (p.isCancel(choice)) process.exit(0)
+    strategy = choice as Strategy
+  }
+
+  // Step 2: Detect repo and pick placement
   const repo = detectRepoContext()
   const canAddToRepo = repo.repoType === "multi-game" || repo.repoType === "workspace-monorepo" || repo.repoType === "standalone"
 
-  const modeOptions = [
+  const placementOptions = [
     { value: "new-repo" as const, label: "Create game in a new repo" },
     ...(canAddToRepo ? [{ value: "add-to-repo" as const, label: "Add a game to this repo" }] : []),
   ]
-  if (canAddToRepo && repo.repoType !== "none") modeOptions.reverse()
+  if (canAddToRepo && repo.repoType !== "none") placementOptions.reverse()
 
-  const mode = await p.select({
-    message: "How would you like to create your game?",
-    options: modeOptions,
-  })
-
-  if (p.isCancel(mode)) process.exit(0)
-
-  // Step 2: Source URL
-  let url = opts.url
-  if (!url) {
-    url = (await p.text({ message: "Source URL to import", validate: (v) => (!v ? "URL is required" : undefined) })) as string
-    if (p.isCancel(url)) process.exit(0)
+  let mode: "new-repo" | "add-to-repo"
+  if (placementOptions.length === 1) {
+    mode = placementOptions[0].value
+  } else {
+    const selected = await p.select({ message: "Where should the game live?", options: placementOptions })
+    if (p.isCancel(selected)) process.exit(0)
+    mode = selected as "new-repo" | "add-to-repo"
   }
 
-  // Step 3: Download page to a temp dir, extract title
+  // Step 3: Acquire source content into tmpDir
   const tmpDir = path.resolve(".puzzmo-import-tmp")
   if (fs.existsSync(tmpDir)) fs.rmSync(tmpDir, { recursive: true })
-  const s = p.spinner()
-  s.start(`Downloading ${url}`)
-  const { title } = await downloadPage(url, tmpDir)
-  s.stop("Download complete.")
+
+  let importedTitle: string | undefined
+  let userPrompt: string | undefined
+
+  if (strategy === "import") {
+    let url = opts.url
+    if (!url) {
+      url = (await p.text({ message: "Source URL to import", validate: (v) => (!v ? "URL is required" : undefined) })) as string
+      if (p.isCancel(url)) process.exit(0)
+    }
+    const s = p.spinner()
+    s.start(`Downloading ${url}`)
+    const { title } = await downloadPage(url, tmpDir)
+    s.stop("Download complete.")
+    importedTitle = title
+  } else if (strategy === "prompt") {
+    userPrompt = opts.prompt
+    if (!userPrompt) {
+      userPrompt = (await p.text({
+        message: "Describe the game you want to build",
+        placeholder: "A word search where letters appear in waves...",
+        validate: (v) => (!v ? "Prompt is required" : undefined),
+      })) as string
+      if (p.isCancel(userPrompt)) process.exit(0)
+    }
+  }
 
   // Step 4: Game name
-  const defaultName = opts.name || title
-  const name = (await p.text({
-    message: "Game name",
-    initialValue: defaultName,
-    validate: (v) => (!v ? "Game name is required" : undefined),
-  })) as string
-  if (p.isCancel(name)) process.exit(0)
+  let name: string
+  if (opts.name) {
+    name = opts.name
+  } else {
+    const result = (await p.text({
+      message: "Game name",
+      initialValue: importedTitle || "My Game",
+      validate: (v) => (!v ? "Game name is required" : undefined),
+    })) as string
+    if (p.isCancel(result)) process.exit(0)
+    name = result
+  }
 
   const slug = slugify(name)
 
+  // Materialize template content for blank/prompt strategies (after we know the slug/name)
+  if (strategy !== "import") {
+    const templateDir = resolveTemplateDir("minesweeper")
+    if (!fs.existsSync(templateDir)) {
+      p.log.error(`Bundled template not found at ${templateDir}`)
+      process.exit(1)
+    }
+    copyTemplate(templateDir, tmpDir, { __SLUG__: slug, __DISPLAY_NAME__: name })
+  }
+
   // Step 5: Login if token provided
   if (opts.accessToken) {
     p.log.step("Logging in...")
     login(opts.accessToken)
   }
 
-  // Step 6: Diamond — set up repo or add to existing
+  // Step 6: Place files
   let gameDir: string
   let repoType: RepoType = repo.repoType
 
@@ -230,14 +348,12 @@ export const gameCreate = async (args: string[]) => {
       process.exit(1)
     }
 
-    // Standalone repo → convert to multi-game first
     if (repo.repoType === "standalone") {
       const existingGame = convertToMultiGame(repo.repoRoot)
       p.log.step(`Moved existing game to games/${existingGame}/`)
       repoType = "multi-game"
     }
 
-    // Determine which folder to place the game in
     let parentFolder: string
     if (repoType === "multi-game") {
       parentFolder = "games"
@@ -261,38 +377,34 @@ export const gameCreate = async (args: string[]) => {
     gameDir = setupRepoGame(tmpDir, slug, repo.repoRoot, parentFolder)
   }
 
-  // Step 7: Detect agent and run skills pipeline. Only offer CLIs we have an adapter for.
-  const supported = new Set(agentNames())
-  const agents = detectAgent().filter((a) => supported.has(a.id))
-  const agentChoices = [
-    ...agents.map((a) => ({ value: a.id, label: `${a.displayName} (${a.path})` })),
-    { value: "none", label: "None - I'll run the steps manually" },
-  ]
-
-  let selectedAgent: string
-  if (opts.agent) {
-    selectedAgent = opts.agent
-  } else if (agents.length > 0) {
-    selectedAgent = (await p.select({ message: "Which LLM agent do you use?", options: agentChoices })) as string
-    if (p.isCancel(selectedAgent)) process.exit(0)
-  } else {
-    p.log.info(`No supported LLM agents detected (checked: ${agentNames().join(", ")})`)
-    selectedAgent = "none"
-  }
-
-  if (selectedAgent !== "none") {
-    const repoContextLines = [
-      `Repo type: ${repoType}`,
-      `Package manager: ${repo.packageManager} (use this instead of npm/npx when running commands or adding dependencies)`,
-    ]
-    if (repoType === "multi-game")
-      repoContextLines.push(
-        "This is a multi-game repo with a shared root package.json. Do not create a per-game package.json or vite config.",
-      )
-    if (repoType === "workspace-monorepo") repoContextLines.push("This is a workspace monorepo. The game has its own package.json.")
-
-    p.log.step("Running Puzzmo migration pipeline...")
-    await runSkillsPipelineTUI(selectedAgent, gameDir, repoContextLines.join("\n"))
+  // Step 7: Strategy-specific agent work
+  if (strategy === "import") {
+    const selectedAgent = await pickAgent(opts.agent)
+    if (selectedAgent !== "none") {
+      const repoContextLines = [
+        `Repo type: ${repoType}`,
+        `Package manager: ${repo.packageManager} (use this instead of npm/npx when running commands or adding dependencies)`,
+      ]
+      if (repoType === "multi-game")
+        repoContextLines.push(
+          "This is a multi-game repo with a shared root package.json. Do not create a per-game package.json or vite config.",
+        )
+      if (repoType === "workspace-monorepo") repoContextLines.push("This is a workspace monorepo. The game has its own package.json.")
+
+      p.log.step("Running Puzzmo migration pipeline...")
+      await runSkillsPipelineTUI(selectedAgent, gameDir, repoContextLines.join("\n"))
+    }
+  } else if (strategy === "prompt") {
+    const selectedAgent = await pickAgent(opts.agent)
+    const message = buildPromptStrategyMessage(userPrompt!, name)
+    if (selectedAgent === "none") {
+      p.log.warn("No agent selected; skipping LLM customization.")
+      p.note(message, "Paste this prompt into your LLM agent:")
+    } else {
+      p.log.step("Running agent with your prompt...")
+      const ok = runAgentWithBuildLoop(selectedAgent, message, gameDir, "from-prompt")
+      if (!ok) p.log.warn("Agent step did not complete cleanly. The Minesweeper starter is still in place.")
+    }
   }
 
   // Done

package/src/commands/upload.ts

@@ -2,9 +2,11 @@ import { execSync } from "node:child_process"
 import crypto from "node:crypto"
 import fs from "node:fs"
 import path from "node:path"
+import * as p from "@clack/prompts"
 
-import { uploadFiles } from "../util/api.js"
+import { GameNotFoundError, uploadFiles } from "../util/api.js"
 import { getAPIURL, getToken } from "../util/config.js"
+import { createUserGame } from "../util/createGame.js"
 import { discoverGames, type DiscoveredGame } from "../util/discoverGames.js"
 
 type UploadOptions = {
@@ -81,7 +83,15 @@ export const upload = async (dir: string, options: UploadOptions = {}) => {
     const game = games[i]
     console.log(`\n[${i + 1}/${games.length}] Uploading ${game.puzzmoFile.game.slug}`)
     try {
-      const result = await uploadOneGame(game, { token, sha, description, repoURL, verbose, rootDir })
+      let result: GameSuccess
+      try {
+        result = await uploadOneGame(game, { token, sha, description, repoURL, verbose, rootDir })
+      } catch (e) {
+        if (!(e instanceof GameNotFoundError)) throw e
+        const created = await maybeCreateMissingGame(e, game, { teamAccessToken: token })
+        if (!created) throw e
+        result = await uploadOneGame(game, { token, sha, description, repoURL, verbose, rootDir })
+      }
       results.push(result)
     } catch (e) {
       const message = e instanceof Error ? e.message : String(e)
@@ -222,6 +232,46 @@ const hashGames = (games: DiscoveredGame[]): string => {
   return hash.digest("hex").slice(0, 12)
 }
 
+/**
+ * When a game can't be uploaded because it doesn't exist on the user's account,
+ * offer to create it interactively. Returns true if the game was created and the
+ * caller can retry the upload. Returns false otherwise (non-interactive shell or
+ * user declined).
+ */
+const maybeCreateMissingGame = async (
+  err: GameNotFoundError,
+  game: DiscoveredGame,
+  opts: { teamAccessToken: string },
+): Promise<boolean> => {
+  const slug = err.slug
+  const displayName = game.puzzmoFile.game.displayName
+
+  if (!process.stdin.isTTY) {
+    console.error(`  Game "${slug}" not found on your account. Re-run interactively to create it.`)
+    return false
+  }
+
+  const consent = await p.confirm({
+    message: `Game "${slug}" doesn't exist on your account. Create it now (displayName: "${displayName}")?`,
+    initialValue: true,
+  })
+  if (p.isCancel(consent) || !consent) return false
+
+  try {
+    const created = await createUserGame({ displayName, teamAccessToken: opts.teamAccessToken })
+    console.log(`  Created game ${created.slug} (${created.id})`)
+    if (created.slug !== slug) {
+      console.warn(`  Server picked slug "${created.slug}" but your puzzmo.json uses "${slug}". Update puzzmo.json before re-uploading.`)
+      return false
+    }
+    return true
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e)
+    console.error(`  Could not create game: ${message}`)
+    return false
+  }
+}
+
 /** Formats a byte count as a human-readable string */
 const formatBytes = (bytes: number): string => {
   if (bytes < 1024) return `${bytes} B`

package/src/index.ts

@@ -14,7 +14,7 @@ const printUsage = () => {
   puzzmo login <token>            Save a CLI auth token
   puzzmo game create [token]      Create a new Puzzmo game project
 
-  puzzmo upload [dir] [-v]        Discover puzzmo.json files in [dir] (default: .) and upload each game's build. -v/--verbose prints request URLs and full error bodies.
+  puzzmo upload [dir] [-v]        Discover puzzmo.json files in [dir] (default: .) and upload each game's build. -v/--verbose prints request URLs and full error bodies. If a game does not exist on your account and stdin is a TTY, you'll be asked whether to create it (using your saved CLI token).
   puzzmo validate [dir]           Discover and validate every puzzmo.json under [dir] (default: .)
   puzzmo migrate                  List and select migration skills from dev.puzzmo.com`)
 }
@@ -41,7 +41,9 @@ const run = async () => {
       if (subcommand === "create") {
         await gameCreate(subArgs)
       } else {
-        console.error("Usage: puzzmo game create [token] [--name <name>] [--url <url>] [--agent <agent>] [--pm <npm|yarn|pnpm>]")
+        console.error(
+          "Usage: puzzmo game create [--strategy <import|blank|prompt>] [--prompt <text>] [--name <name>] [--url <url>] [--agent <agent>] [--token <token>] [--pm <npm|yarn|pnpm>]",
+        )
         process.exit(1)
       }
       break

package/src/skills/runner.ts

@@ -82,3 +82,38 @@ export const runSkillsPipeline = async (agent: string, gameDir: string, repoCont
 export const runSkillsPipelineTUI = async (agent: string, gameDir: string, repoContext: string) => {
   await runPipelineTUI(agent, gameDir, repoContext)
 }
+
+/** Runs a single agent invocation, verifies the build, and commits. Used by one-shot prompt-driven flows. */
+export const runAgentWithBuildLoop = (agent: string, prompt: string, gameDir: string, label: string): boolean => {
+  console.log(`Running agent: ${label}`)
+  let result = invokeAgent(agent, prompt, gameDir)
+  if (!result.success) {
+    console.log(`  Agent failed, retrying...`)
+    result = invokeAgent(agent, prompt, gameDir)
+    if (!result.success) {
+      console.error(`  Agent failed after retry. Stopping.`)
+      return false
+    }
+  }
+
+  const buildResult = verifyBuild(gameDir)
+  if (!buildResult.success) {
+    console.log(`  Build failed, asking agent to fix...`)
+    const fixPrompt = `The vite build failed after the "${label}" step. Fix the build errors:\n\n${buildResult.error}`
+    invokeAgent(agent, fixPrompt, gameDir)
+    const retry = verifyBuild(gameDir)
+    if (!retry.success) {
+      console.error(`  Build still failing after fix attempt.`)
+      return false
+    }
+  }
+
+  try {
+    runCommand("git add -A", { cwd: gameDir })
+    gitCommit(`step: ${label}`, { cwd: gameDir })
+    console.log(`  Committed.`)
+  } catch {
+    console.log(`  No changes to commit.`)
+  }
+  return true
+}