evolutionary-arcade 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.0
+
+- Every publish ends with a **Share it** block: the game's link, a video-description line, an X post draft under 280 characters, an X intent link, and the GIF to attach. A fork or blend's draft credits each parent's creator, by X handle when their profile links one. The agent drafts; the creator posts. The CLI never posts anywhere.
+- New `arcade share <slug>` reprints the block. `--profile` shares your whole library, `--badge` prints the "Play on Evolutionary Arcade" badge as Markdown and HTML (light and dark), and `--json` gives agents the whole thing. `arcade publish --json` includes it as `share`.
+- The arcade serves the badge at `/badge/<slug>.svg` and `/badge/u/<handle>.svg` (`?theme=dark` for dark backgrounds), and each game has a `/g/<slug>/embed` page with the snippets.
+- The `arcade-onboarding` and `arcade-fork` skills end with a share step: show the drafts, offer to tailor them to the creator's channel voice, remind them to put their profile link in video descriptions, and never post for them.
+
 ## 0.2.1
 
 - New `arcade-fork` skill, read with `arcade guide fork`: makes a viewer's own version of a game (a fork, or a blend with a second game), in the same order as onboarding: what they want to make, then setup (CLI, skills, sign-in, tools), then the work, one dry run and one go, and the link to the new game with its credit to the original creator. The game page's Fork and Blend buttons hand out a prompt that starts it.

package/README.md

@@ -54,6 +54,7 @@ Everything you publish is public, including the source, and every game is open s
 | `arcade blend <slug> <slug> [...] [--into <dir>]` | Download 2 to 8 games to blend into one. |
 | `arcade regen <slug> [dir]` | Get a game's prompt, and no code, to build a fresh take. |
 | `arcade publish [dir] [--dry-run] [--yes]` | Check everything, list every file that goes public, and publish. |
+| `arcade share <slug> [--profile] [--badge] [--json]` | Reprint the Share block publish ends with: the link, a video-description line, an X post draft, and the GIF to attach. `--profile` shares your whole library; `--badge` prints the "Play on Evolutionary Arcade" badge as Markdown and HTML. You post them; the arcade never posts for you. |
 | `arcade media preview [dir]` | Make the 12-second hover preview from your demo (needs ffmpeg). |
 | `arcade main <slug> <generation>` | (Owner) Pick the main generation for a version. |
 | `arcade unpublish <slug>` / `arcade republish <slug>` | (Owner) Take your game down, or bring it back. |
@@ -61,7 +62,7 @@ Everything you publish is public, including the source, and every game is open s
 
 When `arcade.json` has no token counts, `arcade publish` fills them in from your local Claude Code session logs, uploading only the numbers (`--no-stats` skips it). Subagent token counts aren't recorded reliably, so only the orchestrator's tokens are filled in. Subagents are listed by model and count.
 
-`arcade --help` and `arcade <command> --help` have every option. `--json` works on `whoami`, `info`, `search`, `publish`, and `profile show`.
+`arcade --help` and `arcade <command> --help` have every option. `--json` works on `whoami`, `info`, `search`, `publish`, `share`, and `profile show`.
 
 ## Requirements
 

package/dist/cli.js

@@ -13,7 +13,7 @@ import { dirname, isAbsolute, join } from "path";
 // package.json
 var package_default = {
   name: "evolutionary-arcade",
-  version: "0.2.1",
+  version: "0.3.0",
   description: "The arcade CLI for Evolutionary Arcade. Publish, update, regen, fork, and blend AI-made browser games with your own coding agent.",
   type: "module",
   license: "MIT",
@@ -5693,7 +5693,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve5) {
+function isRecursive(inst, stack, resolve6) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -5703,7 +5703,7 @@ function isRecursive(inst, stack, resolve5) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve5);
+      const answer = isRecursive(child, stack, resolve6);
       if (answer > result)
         result = answer;
     }
@@ -5714,7 +5714,7 @@ function isRecursive(inst, stack, resolve5) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve5) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve6) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -5778,7 +5778,7 @@ function isRecursive(inst, stack, resolve5) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve5 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve6 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -21023,6 +21023,68 @@ function normalizeModel(raw) {
   return { name: raw.trim(), family, listed: false };
 }
 
+// ../format/src/shareText.ts
+var ARCADE_NAME = "Evolutionary Arcade";
+var gameUrl = (origin, slug) => `${origin}/g/${slug}`;
+var profileUrl = (origin, handle) => `${origin}/u/${handle}`;
+var creditName = (c) => c.x ? `@${c.x.replace(/^@/, "")}` : c.handle;
+var X_LIMIT = 280;
+var X_LINK = 23;
+function xLength(text) {
+  return [...text.replace(/https?:\/\/\S+/g, "x".repeat(X_LINK))].length;
+}
+var xIntentUrl = (text) => `https://x.com/intent/post?text=${encodeURIComponent(text)}`;
+var listOf = (items) => items.length <= 2 ? items.join(" and ") : `${items.slice(0, -1).join(", ")}, and ${items[items.length - 1]}`;
+function fit(build) {
+  for (let max = 80; max >= 8; max -= 4) {
+    const text = build((t) => t.length > max ? `${t.slice(0, max - 1).trimEnd()}\u2026` : t);
+    if (xLength(text) <= X_LIMIT) return text;
+  }
+  return build((t) => t.slice(0, 8));
+}
+function descriptionLine(game) {
+  return `Play ${game.title} in your browser (and remix it): ${gameUrl(game.origin, game.slug)}`;
+}
+function publishShare(game) {
+  const url2 = gameUrl(game.origin, game.slug);
+  if (game.version && game.version > 1)
+    return fit(
+      (cut) => `${cut(game.title)} v${game.version} is live on ${ARCADE_NAME}. Play it in your browser, then remix it: ${url2}`
+    );
+  return fit(
+    (cut) => `I made ${cut(game.title)}, a browser game you can play right now. It's open source, so you can remix it too: ${url2}`
+  );
+}
+function remixShare(game) {
+  const url2 = gameUrl(game.origin, game.slug);
+  const parents = game.parents ?? [];
+  if (!parents.length) return publishShare(game);
+  return fit((cut) => {
+    const credits = parents.map((p) => `${cut(p.title)} by ${creditName(p)}`);
+    return game.kind === "blend" ? `I blended ${listOf(credits)} into ${cut(game.title)}. Play it in your browser: ${url2}` : `I remixed ${credits[0]} into ${cut(game.title)}. Play it in your browser: ${url2}`;
+  });
+}
+function libraryShare(opts) {
+  const n = opts.games === 1 ? "a game" : `${opts.games} games`;
+  return `I put ${n} on ${ARCADE_NAME}. Play in your browser, no account needed, and remix anything: ${profileUrl(opts.origin, opts.handle)}`;
+}
+var libraryDescriptionLine = (origin, handle) => `Play my games (and remix them): ${profileUrl(origin, handle)}`;
+var shareDraft = (game) => game.kind === "fork" || game.kind === "blend" ? remixShare(game) : publishShare(game);
+function badgeUrls(t, theme = "light") {
+  const path = t.slug ? `/badge/${t.slug}.svg` : `/badge/u/${t.handle}.svg`;
+  const link = t.slug ? gameUrl(t.origin, t.slug) : profileUrl(t.origin, t.handle ?? "");
+  return { image: `${t.origin}${path}${theme === "dark" ? "?theme=dark" : ""}`, link };
+}
+var BADGE_ALT = `Play on ${ARCADE_NAME}`;
+function badgeMarkdown(t, theme = "light") {
+  const { image, link } = badgeUrls(t, theme);
+  return `[![${BADGE_ALT}](${image})](${link})`;
+}
+function badgeHtml(t, theme = "light") {
+  const { image, link } = badgeUrls(t, theme);
+  return `<a href="${link}"><img src="${image}" alt="${BADGE_ALT}" height="36"></a>`;
+}
+
 // src/commands/games.ts
 var STARTER_DESCRIPTION = "What a player reads on the card. One or two sentences.";
 var STARTER_CONTROLS = "WASD move, mouse aim, click to act";
@@ -21438,8 +21500,8 @@ function dev(dirArg, opts) {
 
 // src/commands/publish.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync7, statSync as statSync5, writeFileSync as writeFileSync3 } from "fs";
-import { isAbsolute as isAbsolute2, join as join5, relative as relative2, resolve as resolve3, sep as sep4 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync8, statSync as statSync5, writeFileSync as writeFileSync3 } from "fs";
+import { isAbsolute as isAbsolute2, join as join6, relative as relative2, resolve as resolve4, sep as sep4 } from "path";
 
 // src/files.ts
 import { createHash as createHash2 } from "crypto";
@@ -21731,10 +21793,203 @@ function missingSessions(named) {
   return named.filter((id) => !found.has(id));
 }
 
+// src/commands/share.ts
+import { existsSync as existsSync5, readFileSync as readFileSync7 } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join5, resolve as resolve3 } from "path";
+var X_HOSTS = /* @__PURE__ */ new Set([
+  "x.com",
+  "www.x.com",
+  "twitter.com",
+  "www.twitter.com",
+  "mobile.twitter.com"
+]);
+var X_RESERVED = /* @__PURE__ */ new Set([
+  "intent",
+  "home",
+  "i",
+  "share",
+  "search",
+  "explore",
+  "hashtag",
+  "settings"
+]);
+function xHandleFromLinks(links) {
+  for (const l of links) {
+    try {
+      const u = new URL(l.url);
+      const name = u.pathname.split("/").filter(Boolean)[0];
+      if (X_HOSTS.has(u.hostname) && name && !X_RESERVED.has(name.toLowerCase()) && /^[A-Za-z0-9_]{1,15}$/.test(name))
+        return name;
+    } catch {
+    }
+  }
+  return null;
+}
+async function xHandle(handle) {
+  try {
+    const p = await request(`/api/users/${encodeURIComponent(handle)}`, {
+      auth: false
+    });
+    return xHandleFromLinks(p.user.links ?? []);
+  } catch {
+    return null;
+  }
+}
+var badges = (t) => ({
+  markdown: badgeMarkdown(t),
+  html: badgeHtml(t),
+  markdownDark: badgeMarkdown(t, "dark"),
+  htmlDark: badgeHtml(t, "dark")
+});
+function findGif(slug, dir, hosted) {
+  const folders = [dir, process.cwd(), join5(homedir3(), "arcade-games", slug)].filter(
+    (d) => Boolean(d)
+  );
+  for (const folder of folders) {
+    try {
+      const raw = JSON.parse(readFileSync7(join5(folder, "arcade.json"), "utf8"));
+      if (raw.slug !== slug || typeof raw.preview_gif !== "string") continue;
+      const path = resolve3(folder, raw.preview_gif);
+      if (existsSync5(path)) return path;
+    } catch {
+    }
+  }
+  return hosted ? new URL(hosted, apiUrl()).href : null;
+}
+async function gameShare(slug, opts = {}) {
+  const d = await fetchGame(slug);
+  if (!d || d.removed || !d.game.title) throw noSuchGame(slug);
+  const origin = apiUrl();
+  const handles = [...new Set((d.parents ?? []).map((p) => p.owner))];
+  const xs = new Map(await Promise.all(handles.map(async (h) => [h, await xHandle(h)])));
+  const parents = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const p of d.parents ?? []) {
+    if (seen.has(p.slug)) continue;
+    seen.add(p.slug);
+    parents.push({ title: p.title, handle: p.owner, x: xs.get(p.owner) ?? null });
+  }
+  const kind = d.game.kind ?? (parents.length > 1 ? "blend" : parents.length ? "fork" : "original");
+  const game = {
+    origin,
+    slug: d.game.slug,
+    title: d.game.title,
+    kind,
+    parents,
+    version: opts.version ?? d.generation?.version
+  };
+  const post = shareDraft(game);
+  const hostedGif = d.game.gifUrl ?? null;
+  return {
+    kind: "game",
+    slug: d.game.slug,
+    title: d.game.title,
+    url: gameUrl(origin, d.game.slug),
+    description: descriptionLine(game),
+    post,
+    postLength: xLength(post),
+    xIntent: xIntentUrl(post),
+    gif: findGif(d.game.slug, opts.dir, hostedGif),
+    badge: badges({ origin, slug: d.game.slug })
+  };
+}
+async function signedInHandle() {
+  const me = await request("/api/me");
+  if (!me.user?.handle) throw new ExitError("You're not signed in. Run `arcade login`.");
+  return me.user.handle;
+}
+async function profileShare(handleArg) {
+  const handle = (handleArg ?? await signedInHandle()).replace(/^@/, "");
+  const origin = apiUrl();
+  let profile;
+  try {
+    profile = await request(`/api/users/${encodeURIComponent(handle)}`, {
+      auth: false
+    });
+  } catch (e) {
+    if (e instanceof ApiError && e.status === 404)
+      throw new ExitError(`No creator called @${handle} on the arcade.`);
+    throw e;
+  }
+  const list = await request(
+    `/api/games?owner=${encodeURIComponent(handle)}&sort=new&limit=60`,
+    { auth: false }
+  );
+  const post = libraryShare({ origin, handle, games: profile.stats.games });
+  return {
+    kind: "profile",
+    handle,
+    url: profileUrl(origin, handle),
+    description: libraryDescriptionLine(origin, handle),
+    post,
+    postLength: xLength(post),
+    xIntent: xIntentUrl(post),
+    games: list.games.map((g) => ({ slug: g.slug, title: g.title, url: gameUrl(origin, g.slug) })),
+    badge: badges({ origin, handle })
+  };
+}
+function printBadge(b) {
+  out(bold("Badge for a README, itch page, or website:"));
+  out(`  Markdown (light): ${b.markdown}`);
+  out(`  Markdown (dark):  ${b.markdownDark}`);
+  out(`  HTML (light):     ${b.html}`);
+  out(`  HTML (dark):      ${b.htmlDark}`);
+}
+function printShare(s, opts = {}) {
+  out("");
+  out(pink(bold("Share it")) + dim("  (drafts for you to post; the arcade never posts for you)"));
+  out(`  Link:              ${cyan(s.url)}`);
+  out(`  Video description: ${s.description}`);
+  out(`  X post (${s.postLength}/280):`);
+  out(`    ${s.post}`);
+  out(`  Post it on X:      ${s.xIntent}`);
+  if (s.kind === "game")
+    out(
+      `  Attach this GIF:   ${s.gif ?? "none yet (run arcade media preview in the game folder, then publish)"}`
+    );
+  else for (const g of s.games) out(`    ${g.title}  ${dim(g.url)}`);
+  if (opts.badge) {
+    out("");
+    printBadge(s.badge);
+  } else
+    out(
+      dim(
+        `  Badge for your README or itch page: arcade share ${s.kind === "game" ? s.slug : "--profile"} --badge`
+      )
+    );
+}
+async function share(slug, opts) {
+  if (!slug && !opts.profile)
+    throw new ExitError(
+      "Name a game (arcade share <slug>), or use --profile for your whole library.",
+      2
+    );
+  const s = opts.profile ? await profileShare(typeof opts.profile === "string" ? opts.profile : void 0) : await gameShare(slug);
+  if (opts.json) {
+    printJson(s);
+    return;
+  }
+  if (opts.badge && !opts.json) {
+    out(`${bold(s.kind === "game" ? s.title : `@${s.handle}`)} ${cyan(s.url)}`);
+    out("");
+    printBadge(s.badge);
+    return;
+  }
+  printShare(s);
+}
+async function shareAfterPublish(slug, dir, version2) {
+  try {
+    printShare(await gameShare(slug, { dir, version: version2 }));
+  } catch {
+    out(dim(`Share it later: arcade share ${slug}`));
+  }
+}
+
 // src/commands/publish.ts
 function readArcadeRaw(dir) {
-  const path = join5(dir, "arcade.json");
-  if (!existsSync5(path))
+  const path = join6(dir, "arcade.json");
+  if (!existsSync6(path))
     throw new ExitError(
       `No arcade.json in ${dir}. Write one at the top of the game folder with at least these fields (arcade guide publishing has a full example):`,
       2,
@@ -21742,7 +21997,7 @@ function readArcadeRaw(dir) {
       "Starting a brand-new game instead? arcade new <slug>"
     );
   try {
-    return JSON.parse(readFileSync7(path, "utf8"));
+    return JSON.parse(readFileSync8(path, "utf8"));
   } catch (e) {
     throw new ExitError(`arcade.json isn't valid JSON: ${e.message}`, 2);
   }
@@ -21770,7 +22025,7 @@ function makePreview(dir, demo, target = "media/preview.mp4") {
   runFfmpeg(
     [
       "-i",
-      join5(dir, demo),
+      join6(dir, demo),
       "-t",
       "12",
       "-an",
@@ -21786,7 +22041,7 @@ function makePreview(dir, demo, target = "media/preview.mp4") {
       "yuv420p",
       "-movflags",
       "+faststart",
-      join5(dir, target)
+      join6(dir, target)
     ],
     "preview"
   );
@@ -21803,7 +22058,7 @@ function makeGif(dir, demo, target = "media/preview.gif") {
     runFfmpeg(
       [
         "-i",
-        join5(dir, demo),
+        join6(dir, demo),
         "-t",
         String(t.seconds),
         "-an",
@@ -21811,11 +22066,11 @@ function makeGif(dir, demo, target = "media/preview.gif") {
         `fps=${t.fps},scale=${t.width}:-2:flags=lanczos,split[a][b];[a]palettegen=max_colors=128:stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=4`,
         "-loop",
         "0",
-        join5(dir, target)
+        join6(dir, target)
       ],
       "GIF"
     );
-    if (statSync5(join5(dir, target)).size <= MAX_GIF_BYTES) return target;
+    if (statSync5(join6(dir, target)).size <= MAX_GIF_BYTES) return target;
   }
   throw new ExitError(
     `The GIF came out over ${MAX_GIF_BYTES / 1024 / 1024} MB, even small. Re-cut the demo so its first 5 seconds are less busy (a later -ss), then run \`arcade media preview\` again.`
@@ -21828,7 +22083,7 @@ function demoFor(dir, raw, what) {
       `arcade.json has no demo_video to make ${what} from. Record 15-30 s of real play at 1280x720 into media/demo.mp4 and set "demo_video": "media/demo.mp4" (arcade guide publishing, "Capturing media").`,
       2
     );
-  if (!existsSync5(join5(dir, raw.demo_video)))
+  if (!existsSync6(join6(dir, raw.demo_video)))
     throw new ExitError(
       `${raw.demo_video} isn't in the folder yet. Record a demo first (see arcade-publishing).`,
       2
@@ -21836,7 +22091,7 @@ function demoFor(dir, raw, what) {
   return raw.demo_video;
 }
 async function mediaPreview(dirArg) {
-  const dir = resolve3(dirArg ?? ".");
+  const dir = resolve4(dirArg ?? ".");
   const raw = readArcadeRaw(dir);
   const demo = demoFor(dir, raw, "a preview");
   const made = makePreview(dir, demo);
@@ -21845,21 +22100,21 @@ async function mediaPreview(dirArg) {
   if (!gif) throw new ExitError(NO_FFMPEG);
   raw.preview_video = made;
   raw.preview_gif = gif;
-  writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+  writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
   out(
-    `Made ${made} and ${gif} (${mb(statSync5(join5(dir, gif)).size)}) and added them to arcade.json.`
+    `Made ${made} and ${gif} (${mb(statSync5(join6(dir, gif)).size)}) and added them to arcade.json.`
   );
 }
 async function mediaGif(dirArg) {
-  const dir = resolve3(dirArg ?? ".");
+  const dir = resolve4(dirArg ?? ".");
   const raw = readArcadeRaw(dir);
   const gif = makeGif(dir, demoFor(dir, raw, "a GIF"));
   if (!gif) throw new ExitError(NO_FFMPEG);
   raw.preview_gif = gif;
-  writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+  writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
-  out(`Made ${gif} (${mb(statSync5(join5(dir, gif)).size)}) and added it to arcade.json.`);
+  out(`Made ${gif} (${mb(statSync5(join6(dir, gif)).size)}) and added it to arcade.json.`);
 }
 function describeAction(p, parentNames) {
   switch (p.action) {
@@ -21992,7 +22247,7 @@ function headsUp(arcade, files, alreadyOnArcade, secretWarnings, dir) {
     );
   const age = (p2) => {
     try {
-      return p2 ? statSync5(join5(dir, p2)).mtimeMs : null;
+      return p2 ? statSync5(join6(dir, p2)).mtimeMs : null;
     } catch {
       return null;
     }
@@ -22028,9 +22283,9 @@ function headsUp(arcade, files, alreadyOnArcade, secretWarnings, dir) {
   return notes;
 }
 async function fillLicenseHolder(dir) {
-  const path = join5(dir, "LICENSE");
-  if (!existsSync5(path)) return;
-  const text = readFileSync7(path, "utf8");
+  const path = join6(dir, "LICENSE");
+  if (!existsSync6(path)) return;
+  const text = readFileSync8(path, "utf8");
   if (!text.includes(LICENSE_HOLDER_PLACEHOLDER)) return;
   const handle = savedLogin()?.handle ?? (await request("/api/me").catch(() => null))?.user?.handle;
   if (!handle) return;
@@ -22053,14 +22308,14 @@ async function publish(dirArg, opts) {
       );
     useStdoutForJson();
   }
-  const dir = resolve3(dirArg ?? ".");
+  const dir = resolve4(dirArg ?? ".");
   const raw = readArcadeRaw(dir);
-  if (typeof raw.demo_video === "string" && !raw.preview_video && existsSync5(join5(dir, raw.demo_video))) {
+  if (typeof raw.demo_video === "string" && !raw.preview_video && existsSync6(join6(dir, raw.demo_video))) {
     try {
       const made = makePreview(dir, raw.demo_video);
       if (made) {
         raw.preview_video = made;
-        writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+        writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
         out(dim(`Made a 12 s hover preview (${made}).`));
       } else {
@@ -22075,7 +22330,7 @@ async function publish(dirArg, opts) {
       out(yellow(`No hover preview: ${e.message} Cards will show the thumbnail.`));
     }
   }
-  if (typeof raw.demo_video === "string" && !raw.preview_gif && existsSync5(join5(dir, raw.demo_video))) {
+  if (typeof raw.demo_video === "string" && !raw.preview_gif && existsSync6(join6(dir, raw.demo_video))) {
     const made = makeGif(dir, raw.demo_video);
     if (!made)
       throw new ExitError(
@@ -22085,9 +22340,9 @@ async function publish(dirArg, opts) {
         "Then run `arcade media preview` (or publish again, which makes it for you)."
       );
     raw.preview_gif = made;
-    writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+    writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
-    out(dim(`Made a GIF from the demo (${made}, ${mb(statSync5(join5(dir, made)).size)}).`));
+    out(dim(`Made a GIF from the demo (${made}, ${mb(statSync5(join6(dir, made)).size)}).`));
   }
   const prov = raw.provenance ?? {};
   const orch = prov.orchestrator ?? null;
@@ -22151,7 +22406,7 @@ async function publish(dirArg, opts) {
       bad.map((f) => `${f.path}  (move it out of the folder, or delete it)`)
     );
   }
-  const notMit = files.filter((f) => isLicenseFile(f.path)).map((f) => licenseFileProblem(f.path, readFileSync7(f.abs, "utf8"))).filter((p) => p !== null);
+  const notMit = files.filter((f) => isLicenseFile(f.path)).map((f) => licenseFileProblem(f.path, readFileSync8(f.abs, "utf8"))).filter((p) => p !== null);
   if (notMit.length) throw new ExitError("The game's license needs fixing:", 2, notMit);
   const media = [
     arcade.thumbnail,
@@ -22185,7 +22440,7 @@ async function publish(dirArg, opts) {
       path: f.path,
       size: f.size,
       get bytes() {
-        return readFileSync7(f.abs);
+        return readFileSync8(f.abs);
       }
     })),
     arcade.play.root,
@@ -22323,7 +22578,7 @@ async function publish(dirArg, opts) {
     delete nextProv.build;
     nextProv.subagent_models = [];
     raw.provenance = nextProv;
-    writeFileSync3(join5(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
+    writeFileSync3(join6(dir, "arcade.json"), `${JSON.stringify(raw, null, 2)}
 `);
   }
   if (opts.json) {
@@ -22334,7 +22589,9 @@ async function publish(dirArg, opts) {
       version: result.version,
       generation: result.generation,
       main: result.main,
-      url: result.url
+      url: result.url,
+      // The drafts the agent shows the creator. Missing only if the arcade couldn't be read back.
+      share: await gameShare(result.slug, { dir, version: result.version }).catch(() => null)
     });
     return;
   }
@@ -22354,6 +22611,7 @@ async function publish(dirArg, opts) {
         `It's in the stack. The owner decides which generation is main (arcade main ${result.slug} ${result.generation}).`
       )
     );
+  await shareAfterPublish(result.slug, dir, result.version);
   if (becameUpdate)
     next(`keep building here. Publishing this folder again makes v${result.version + 1}.`);
   else next(`publishing this folder again adds another generation to v${result.version}'s stack.`);
@@ -22377,7 +22635,7 @@ async function uploadAll(files, missing) {
     for (; ; ) {
       const job = jobs.shift();
       if (!job) return;
-      const body = readFileSync7(job.f.abs);
+      const body = readFileSync8(job.f.abs);
       const ext2 = job.f.path.split(".").pop() ?? "";
       const path = job.kind === "blob" ? `/api/uploads/blob/${job.f.sha256}` : `/api/uploads/media/${job.f.sha256}?ext=${ext2}`;
       await request(path, {
@@ -22447,14 +22705,14 @@ async function setPublished(slug, published) {
 }
 
 // src/commands/skills.ts
-import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync3, readdirSync as readdirSync4, readFileSync as readFileSync8 } from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname as dirname3, join as join6, resolve as resolve4 } from "path";
+import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync3, readdirSync as readdirSync4, readFileSync as readFileSync9 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname3, join as join7, resolve as resolve5 } from "path";
 import { fileURLToPath } from "url";
 function skillsDir() {
   const here = dirname3(fileURLToPath(import.meta.url));
-  for (const candidate2 of [join6(here, "..", "skills"), join6(here, "..", "..", "skills")]) {
-    if (existsSync6(join6(candidate2, "arcade-getting-started", "SKILL.md"))) return candidate2;
+  for (const candidate2 of [join7(here, "..", "skills"), join7(here, "..", "..", "skills")]) {
+    if (existsSync7(join7(candidate2, "arcade-getting-started", "SKILL.md"))) return candidate2;
   }
   throw new ExitError(
     "The bundled skills are missing from this install. Reinstall evolutionary-arcade."
@@ -22479,7 +22737,7 @@ function guide(name, opts = {}) {
     return;
   }
   const skill = resolveSkill(name ?? "getting-started");
-  const text = readFileSync8(join6(skillsDir(), skill, "SKILL.md"), "utf8");
+  const text = readFileSync9(join7(skillsDir(), skill, "SKILL.md"), "utf8");
   if (opts.raw) {
     process.stdout.write(text);
     return;
@@ -22493,13 +22751,13 @@ function guide(name, opts = {}) {
   process.stdout.write(text.replace(/^---\n[\s\S]*?\n---\n+/, ""));
 }
 var TARGETS = {
-  claude: () => join6(homedir3(), ".claude", "skills"),
-  codex: () => join6(homedir3(), ".agents", "skills")
+  claude: () => join7(homedir4(), ".claude", "skills"),
+  codex: () => join7(homedir4(), ".agents", "skills")
 };
 function installSkills(opts) {
   const src = skillsDir();
   const names = skillNames();
-  const targets = opts.dir ? [resolve4(opts.dir)] : (opts.target === "all" || !opts.target ? Object.keys(TARGETS) : [opts.target]).map((t) => {
+  const targets = opts.dir ? [resolve5(opts.dir)] : (opts.target === "all" || !opts.target ? Object.keys(TARGETS) : [opts.target]).map((t) => {
     const f = TARGETS[t];
     if (!f) throw new ExitError(`Unknown --target ${t}. Use claude, codex, or all.`, 2);
     return f();
@@ -22507,7 +22765,7 @@ function installSkills(opts) {
   for (const target of targets) {
     mkdirSync3(target, { recursive: true });
     for (const name of names)
-      cpSync(join6(src, name), join6(target, name), { recursive: true, force: true });
+      cpSync(join7(src, name), join7(target, name), { recursive: true, force: true });
     out(`Installed ${names.length} skills into ${target}`);
   }
   out(dim(names.join(", ")));
@@ -22599,6 +22857,12 @@ function buildProgram() {
     "after",
     "\nExamples:\n  arcade publish --dry-run          check it and see the file list\n  arcade publish --yes              publish after you've read the dry run\n  arcade publish --yes --no-stats   when these tokens aren't from this build"
   );
+  program.command("share [slug]").description(
+    "print ready-to-post drafts for a game: link, video-description line, X post, GIF (you post them)"
+  ).option("--profile [handle]", "share your whole library (default: you)").option("--badge", 'print the "Play on Evolutionary Arcade" badge as Markdown and HTML').option("--json", "print JSON (for agents)").action(share).addHelpText(
+    "after",
+    "\nExamples:\n  arcade share night-shift            the Share block publish printed\n  arcade share --profile              your whole library, for video descriptions\n  arcade share night-shift --badge    badge for a README or itch page"
+  );
   const media = program.command("media").description("media helpers (they need ffmpeg)");
   media.command("preview [dir]").description(
     "remake media/preview.mp4 (12 s) and media/preview.gif (6 s) from your demo, after every new demo"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolutionary-arcade",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "The arcade CLI for Evolutionary Arcade. Publish, update, regen, fork, and blend AI-made browser games with your own coding agent.",
   "type": "module",
   "license": "MIT",

package/skills/arcade-fork/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: arcade-fork
-description: Use when someone wants to make their own version of a game on Evolutionary Arcade (evolutionaryarcade.com), usually right after they pasted the prompt from a game page's Fork or Blend button into their agent ("help me remix <game>", "help me blend <a> and <b>", `arcade guide fork`). Walks the session in Alex's order - vision (what they want to make from this game), pre-flight (CLI, skills, sign-in, tools, done while they're at the keyboard), then "let me cook": arcade fork or arcade blend, play the parent, make the changes, test, media, demo and GIF, one dry run and one go, then the link to their new game with its credit to the original creator.
+description: Use when someone wants to make their own version of a game on Evolutionary Arcade (evolutionaryarcade.com), usually right after they pasted the prompt from a game page's Fork or Blend button into their agent ("help me remix <game>", "help me blend <a> and <b>", `arcade guide fork`). Walks the session in Alex's order - vision (what they want to make from this game), pre-flight (CLI, skills, sign-in, tools, done while they're at the keyboard), then "let me cook": arcade fork or arcade blend, play the parent, make the changes, test, media, demo and GIF, one dry run and one go, then the link to their new game with its credit to the original creator, and share drafts they post themselves.
 ---
 
 # Forking or blending a game on Evolutionary Arcade
@@ -23,6 +23,7 @@ Every question that needs them happens at the start, while they're excited and a
 2. **Pre-flight** (step 2): CLI, skills, sign-in, tools. All the human-in-the-loop setup, done now.
 3. **Let me cook** (steps 3-6): say "I've got it from here. I'll come back with one thing to approve," then do the work.
 4. **One go, then the link** (steps 7-8): the only question while you cook is the publish go, because it makes their game public under their name.
+5. **Share drafts** (step 9): the posts are theirs to send. You never post.
 
 ## Ground rules for the whole session
 
@@ -122,9 +123,24 @@ Failures: a taken slug (pick another with them), a game over 50 MB (compress med
 
 1. Give them the game's link: `https://evolutionaryarcade.com/g/<slug>`. Open it if you can, and check the page says "Forked from <title> by @<creator>" (or "Blended from" with both).
 2. Tell them what happens next: anyone can play it without an account, it appears in the original's family tree, and the original creator can see it was forked. To change it later, edit `~/arcade-games/<slug>/` and publish again; that makes v2.
-3. Give them a ready line to share:
-   > `I remixed <original title> by @<creator>: https://evolutionaryarcade.com/g/<slug>`
+
+## Step 9. Share it (you draft, they post)
+
+`arcade publish` ended with a **Share it** block. Run `arcade share <slug> --json` for the same thing as data. Show them:
+
+- the link and the video-description line;
+- the X post draft, which credits the original's creator ("I remixed <title> by @<creator> into <their title>..."), and the X intent link that opens it ready to post;
+- the GIF to attach (`media/preview.gif`);
+- the badge for a README or itch page if they keep one (`arcade share <slug> --badge`).
+
+Then:
+
+- **You never post.** Not to X, YouTube, Discord, or anywhere else, even if they ask you to and even if you have a tool that could. You draft; they post.
+- Offer once to tailor the drafts to their channel's voice (their usual tone, emoji or none, how they credit people). If they say yes, rewrite the post in that voice, keep the link and every credit, and keep it under 280 characters (X counts a link as 23).
+- Remind them to put their profile link in their video descriptions: that is where viewers become players and remixers:
+
+  > `Play my games (and remix them): https://evolutionaryarcade.com/u/<handle>`
 
 ## Example
 
-A viewer pastes: "Help me remix "Last Signal" (evolutionaryarcade.com/g/last-signal) on Evolutionary Arcade..." You find Node but no CLI, so you install it and the skills, then `arcade info last-signal`. You ask the five vision questions. They want "the same thing but you're a stealth scout, no shooting", keep the radio station and dusk look, name it night-shift, touch yes, demo yes. Pre-flight: `arcade login` in the background, they sign in as @kai, Playwright is there, ffmpeg needs `brew install ffmpeg` and they say yes. "I've got it from here." You fork into `~/arcade-games/night-shift`, play it, replace the wave defense with a sneak-and-restore loop, add touch controls, test on desktop and phone sizes, capture media, record a demo and its GIF. The dry run says "a fork of Last Signal v1". You show one summary and ask one question. They say yes, you publish, and hand them `https://evolutionaryarcade.com/g/night-shift`, whose page reads "Forked from Last Signal by @alex".
+A viewer pastes: "Help me remix "Last Signal" (evolutionaryarcade.com/g/last-signal) on Evolutionary Arcade..." You find Node but no CLI, so you install it and the skills, then `arcade info last-signal`. You ask the five vision questions. They want "the same thing but you're a stealth scout, no shooting", keep the radio station and dusk look, name it night-shift, touch yes, demo yes. Pre-flight: `arcade login` in the background, they sign in as @kai, Playwright is there, ffmpeg needs `brew install ffmpeg` and they say yes. "I've got it from here." You fork into `~/arcade-games/night-shift`, play it, replace the wave defense with a sneak-and-restore loop, add touch controls, test on desktop and phone sizes, capture media, record a demo and its GIF. The dry run says "a fork of Last Signal v1". You show one summary and ask one question. They say yes, you publish, and hand them `https://evolutionaryarcade.com/g/night-shift`, whose page reads "Forked from Last Signal by @alex". You show the Share block (the X draft credits Last Signal's creator), offer to match the voice of their TikTok captions, and remind them to put `/u/kai` in their video descriptions. They post it themselves.

package/skills/arcade-onboarding/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: arcade-onboarding
-description: Use when a creator wants to put games they already made on Evolutionary Arcade (evolutionaryarcade.com), usually right after they pasted the arcade's prompt into their agent ("help me put my games on Evolutionary Arcade", `arcade guide onboarding`). Walks the first session in Alex's order - vision (what they want, asked all up front), pre-flight (sign-in, tools, the ownership and MIT check) while they're still at the keyboard, then "let me cook": find the games, a fit table with your own time estimates, as-is or optimize, demos and GIFs, one combined dry run and one go, then a ready line with their profile link. Also covers GitHub repos as a source, failures, and the 30-a-day cap.
+description: Use when a creator wants to put games they already made on Evolutionary Arcade (evolutionaryarcade.com), usually right after they pasted the arcade's prompt into their agent ("help me put my games on Evolutionary Arcade", `arcade guide onboarding`). Walks the first session in Alex's order - vision (what they want, asked all up front), pre-flight (sign-in, tools, the ownership and MIT check) while they're still at the keyboard, then "let me cook": find the games, a fit table with your own time estimates, as-is or optimize, demos and GIFs, one combined dry run and one go, then a ready line with their profile link and share drafts (link, description line, X post, GIF, badge) that they post themselves. Also covers GitHub repos as a source, failures, and the 30-a-day cap.
 ---
 
 # Onboarding a creator onto Evolutionary Arcade
@@ -23,6 +23,7 @@ Every question that needs the creator happens at the start, while they're intere
 2. **Pre-flight** (step 2): sign-in, the tools you'll need, and the ownership check. All the human-in-the-loop setup, done now.
 3. **Let me cook** (steps 3-6): say "I've got it from here. I'll come back with one summary to approve," then do the work.
 4. **One go, then the link** (steps 7-8): the only question while you cook is the publish go, because it makes their games public under their name.
+5. **Share drafts** (step 9): the posts are theirs to send. You never post.
 
 ## Ground rules for the whole session
 
@@ -145,13 +146,26 @@ Failures: a slug that's taken (pick another with them), a game over 50 MB (move
 
 ## Step 8. Hand back the link
 
-1. Ask for their channel URL and a one-line bio, then `arcade profile set --bio "<line>" --link "YouTube <url>"` (pass every link they want; it replaces the list).
+1. Ask for their channel URL and a one-line bio, then `arcade profile set --bio "<line>" --link "YouTube <url>"` (pass every link they want; it replaces the list). If they're on X, add their X profile too: share drafts for anyone who remixes their games will then credit them by their X handle.
 2. `arcade profile show` for the profile address.
-3. Give them a ready line for their video descriptions:
-   > `Play my games (and remix them): https://evolutionaryarcade.com/u/<handle>`
-   and each game's own link (`https://evolutionaryarcade.com/g/<slug>`).
+3. Give them their profile link and each game's own link (`https://evolutionaryarcade.com/g/<slug>`).
 4. Tell them what happens next: people can play without an account, fork and blend their games, and those remixes show up in each game's family tree. To update a game later, change it in its `~/arcade-games/<slug>/` folder and publish again; that makes the next version.
 
+## Step 9. Share it (you draft, they post)
+
+Each publish ended with a **Share it** block. Run `arcade share --profile --json` for the whole library and `arcade share <slug> --json` for any one game. Show them:
+
+- the description line for their videos, `Play my games (and remix them): https://evolutionaryarcade.com/u/<handle>`, and each game's own line;
+- the X post draft for the library (and for a game they want to lead with), with its X intent link;
+- each game's GIF to attach (`media/preview.gif`);
+- the badge for READMEs, itch pages, and their website (`arcade share <slug> --badge`, or `--profile --badge` for one badge that links to everything).
+
+Then:
+
+- **You never post.** Not to X, YouTube, Discord, or anywhere else, even if they ask you to and even if you have a tool that could. You draft; they post.
+- Offer once to tailor the drafts to their channel's voice (their usual tone, emoji or none, how they credit people). If they say yes, rewrite the post in that voice, keep the link and every credit, and keep it under 280 characters (X counts a link as 23).
+- Remind them to put their profile link in their video descriptions: that is where viewers become players and remixers.
+
 ## Example
 
-Creator: "help me put my games on Evolutionary Arcade." You install, then ask the four vision questions in one message. They want a showcase for their channel, the games are in `~/Desktop/jams`, as-is, and yes to demos. Pre-flight: you start `arcade login` in the background and they approve it in the browser, ffmpeg is already there, Playwright needs one install line and they say yes, and you give the ownership warning. They mention that one game used music from a paid pack. "I've got it from here." You find five games; one needs a websocket server. You copy the four fits, write arcade.json, LICENSE and controls, vendor one CDN import, drop the paid music, capture media, and record four demos (each with its GIF). You come back with one summary (the fit table, what you changed, the combined dry run) and one question: "Publish these 4 publicly under @handle, MIT?" They say yes, four publishes, and you hand them the description line with `/u/<handle>`.
+Creator: "help me put my games on Evolutionary Arcade." You install, then ask the four vision questions in one message. They want a showcase for their channel, the games are in `~/Desktop/jams`, as-is, and yes to demos. Pre-flight: you start `arcade login` in the background and they approve it in the browser, ffmpeg is already there, Playwright needs one install line and they say yes, and you give the ownership warning. They mention that one game used music from a paid pack. "I've got it from here." You find five games; one needs a websocket server. You copy the four fits, write arcade.json, LICENSE and controls, vendor one CDN import, drop the paid music, capture media, and record four demos (each with its GIF). You come back with one summary (the fit table, what you changed, the combined dry run) and one question: "Publish these 4 publicly under @handle, MIT?" They say yes, four publishes, and you hand them the description line with `/u/<handle>`, the library's X draft, and the badge for their itch page. You offer to match the voice of their video captions; they post it themselves.