@genex-ai/cli-demo 0.1.0 → 0.1.1

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Set up your ~/.claude workspace, authorize, create a game project, and publish (genex CLI).",
   "type": "module",
   "bin": {
-    "genex": "./src/index.ts"
+    "genex": "./dist/index.js"
   },
   "files": [
-    "src",
+    "dist",
     "templates",
     "README.md",
     "LICENSE"
   ],
   "engines": {
-    "node": ">=24"
+    "node": ">=20"
   },
   "keywords": [
     "cli",
@@ -27,6 +27,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "devDependencies": {
+    "tsup": "^8.0.0"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/me-ai-org/genex-demo.git",
@@ -37,6 +40,7 @@
   },
   "homepage": "https://github.com/me-ai-org/genex-demo/tree/main/apps/cli#readme",
   "scripts": {
+    "build": "tsup",
     "start": "node src/index.ts",
     "dev": "node --watch src/index.ts",
     "typecheck": "tsc --noEmit",

package/src/commands/init.ts

@@ -1,131 +0,0 @@
-import path from "node:path";
-import {
-  ENV_TOKEN_KEY,
-  getApiUrl,
-  getAuthUrl,
-  getClaudeDir,
-  getColyseusUrl,
-  getTemplatesDir,
-} from "../config.ts";
-import { copyTemplates } from "../lib/copy-templates.ts";
-import { authorize } from "../lib/auth.ts";
-import { createDraftProject } from "../lib/project.ts";
-import { generateSshKeypair, writeGitignore } from "../lib/ssh.ts";
-import { writeProject, writeUserToken } from "../lib/store.ts";
-import { createLogger } from "../utils/logger.ts";
-import { c } from "../utils/colors.ts";
-
-export interface InitOptions {
-  /** Destination workspace. Defaults to `~/.claude`. */
-  dir?: string;
-  /** Override the auth site (web) URL. */
-  authUrl?: string;
-  /** Override the API base URL (where the project is created). */
-  apiUrl?: string;
-  /** Override the Colyseus relay URL (stored in project metadata). */
-  colyseusUrl?: string;
-  /** Project name. Defaults to the current directory's name. */
-  name?: string;
-  /** Path to the token env file. Defaults to `~/.genex/env`. */
-  envPath?: string;
-  /** Skip the authorization step; only scaffold templates. */
-  noAuth?: boolean;
-  /** Overwrite existing files in the destination (off by default). */
-  force?: boolean;
-  /** Auth redirect wait timeout, in seconds. */
-  timeoutSec?: number;
-  quiet?: boolean;
-}
-
-export async function runInit(opts: InitOptions): Promise<void> {
-  const log = createLogger({ quiet: opts.quiet });
-
-  log.plain(c.bold("genex init"));
-  log.plain("");
-
-  // 1. Scaffold the ~/.claude workspace from bundled templates.
-  const templatesDir = getTemplatesDir();
-  const claudeDir = getClaudeDir(opts.dir);
-
-  log.step(`Setting up your workspace at ${c.cyan(claudeDir)}`);
-  const { copied, skipped } = await copyTemplates(templatesDir, claudeDir, {
-    force: opts.force,
-  });
-
-  if (copied.length > 0) {
-    log.success(`Added ${copied.length} file${copied.length === 1 ? "" : "s"}.`);
-    for (const f of copied) log.dim(`  + ${f}`);
-  }
-  if (skipped.length > 0) {
-    log.info(
-      `Left ${skipped.length} existing file${skipped.length === 1 ? "" : "s"} untouched.`,
-    );
-    for (const f of skipped) log.dim(`  = ${f}`);
-  }
-  if (copied.length === 0 && skipped.length === 0) {
-    log.info("No template files to install.");
-  }
-  log.plain("");
-
-  // 2. Authorize (unless skipped).
-  if (opts.noAuth) {
-    log.info("Skipping authorization (--no-auth).");
-    log.success("Done.");
-    return;
-  }
-
-  const authBaseUrl = getAuthUrl(opts.authUrl);
-  let token: string;
-  try {
-    token = await authorize(authBaseUrl, {
-      log,
-      timeoutMs: opts.timeoutSec ? opts.timeoutSec * 1000 : undefined,
-    });
-  } catch (err) {
-    log.error(err instanceof Error ? err.message : String(err));
-    log.dim("Your workspace files were installed. Re-run `genex init` to finish authorizing.");
-    throw err;
-  }
-
-  log.success("Authorized.");
-
-  // 3. Persist the token to ~/.genex/env (per-user; reused across projects).
-  const { path: tokenPath } = await writeUserToken(token, opts.envPath);
-  log.success(`Saved your token to ${c.cyan(tokenPath)} (${ENV_TOKEN_KEY}).`);
-  log.plain("");
-
-  // 4. Generate a per-project deploy key, then create the draft project so it
-  //    shows up in the dashboard's "My games" immediately. The private key stays
-  //    local (gitignored); only its public half is registered with the repo.
-  const key = await generateSshKeypair(process.cwd(), log);
-  await writeGitignore(process.cwd(), log);
-  if (!key) {
-    log.warn(
-      "Skipping project creation — no deploy key. Install ssh-keygen (OpenSSH) and re-run `genex init`.",
-    );
-    log.plain("");
-    log.success("Workspace ready (no project created yet).");
-    return;
-  }
-
-  const apiUrl = getApiUrl(opts.apiUrl);
-  const colyseusUrl = getColyseusUrl(opts.colyseusUrl);
-  const projectName = opts.name?.trim() || path.basename(process.cwd());
-
-  const meta = await createDraftProject({
-    apiUrl,
-    token,
-    name: projectName,
-    deployKey: key.publicKey,
-    colyseusUrl,
-    dashboardUrl: authBaseUrl,
-    log,
-  });
-  if (meta) {
-    const { path: metaPath } = await writeProject(meta);
-    log.dim(`  saved ${c.cyan(metaPath)}`);
-  }
-
-  log.plain("");
-  log.success("All set. 🚀");
-}

package/src/commands/publish.ts

@@ -1,151 +0,0 @@
-import { spawn } from "node:child_process";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { getApiUrl } from "../config.ts";
-import { readProject, readUserToken } from "../lib/store.ts";
-import { KEY_NAME } from "../lib/ssh.ts";
-import { createLogger, type Logger } from "../utils/logger.ts";
-import { c } from "../utils/colors.ts";
-
-export interface PublishOptions {
-  /** Override the API base URL (defaults to the project's stored apiUrl). */
-  apiUrl?: string;
-  /** Override the bearer token (defaults to ~/.genex/env). */
-  token?: string;
-  /** Path to the token env file (defaults to ~/.genex/env). */
-  envPath?: string;
-  /** Skip the git push; only flip the gallery flag. */
-  noPush?: boolean;
-  /** Optional gallery metadata. */
-  title?: string;
-  description?: string;
-  quiet?: boolean;
-}
-
-interface RunResult {
-  code: number;
-  out: string;
-  err: string;
-}
-
-/** Run a command, capturing output. Resolves with the exit code (never throws). */
-function run(cmd: string, args: string[], env?: NodeJS.ProcessEnv): Promise<RunResult> {
-  return new Promise((resolve) => {
-    let child;
-    try {
-      child = spawn(cmd, args, { env: env ? { ...process.env, ...env } : process.env });
-    } catch {
-      resolve({ code: -1, out: "", err: `${cmd} not found` });
-      return;
-    }
-    let out = "";
-    let err = "";
-    child.stdout?.on("data", (d) => (out += String(d)));
-    child.stderr?.on("data", (d) => (err += String(d)));
-    child.on("error", () => resolve({ code: -1, out, err: `${cmd} not found` }));
-    child.on("close", (code) => resolve({ code: code ?? -1, out, err }));
-  });
-}
-
-/**
- * `genex publish` — push the built game to GitHub over the project's deploy key
- * (best-effort), then flip the project from draft to published in the gallery.
- *
- * push (updates the live Pages site) and publish (the gallery flag) are
- * independent per CLI_INTEGRATION.md, so a failed/absent push (e.g. locally with
- * the mock provider — no real repo) never blocks the gallery flip.
- */
-export async function runPublish(opts: PublishOptions): Promise<void> {
-  const log = createLogger({ quiet: opts.quiet });
-  log.plain(c.bold("genex publish"));
-  log.plain("");
-
-  const token = opts.token ?? (await readUserToken(opts.envPath));
-  if (!token) {
-    log.error("Not authorized. Run `genex init` first to sign in.");
-    process.exitCode = 1;
-    return;
-  }
-
-  const meta = await readProject();
-  if (!meta) {
-    log.error("No genex project here. Run `genex init` in this directory first.");
-    process.exitCode = 1;
-    return;
-  }
-
-  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
-
-  // 1. Push the built game (best-effort).
-  if (opts.noPush) {
-    log.info("Skipping git push (--no-push).");
-  } else {
-    await pushGame(meta.sshUrl, log);
-  }
-
-  // 2. Flip the gallery flag (authoritative).
-  log.step("Publishing to the gallery…");
-  let res: Response;
-  try {
-    const body: Record<string, string> = {};
-    if (opts.title) body.title = opts.title;
-    if (opts.description) body.description = opts.description;
-    res = await fetch(`${apiUrl}/api/projects/${meta.id}/publish`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
-      body: JSON.stringify(body),
-    });
-  } catch (err) {
-    log.error(`Couldn't reach the API at ${apiUrl}: ${String(err)}`);
-    process.exitCode = 1;
-    return;
-  }
-  if (!res.ok) {
-    log.error(`Publish failed (HTTP ${res.status}).`);
-    process.exitCode = 1;
-    return;
-  }
-
-  log.plain("");
-  log.success("Published. 🎉");
-  if (meta.playUrl) {
-    log.dim(`  play: ${meta.playUrl}`);
-    log.dim("  (GitHub Pages rebuilds ~30–90s after a push.)");
-  }
-}
-
-async function pushGame(sshUrl: string, log: Logger): Promise<void> {
-  // GitHub Pages serves the repo root — the game's entry must be index.html there.
-  try {
-    await fs.access(path.join(process.cwd(), "index.html"));
-  } catch {
-    log.warn("No index.html at the project root — GitHub Pages needs one to serve the game.");
-  }
-
-  const isRepo = (await run("git", ["rev-parse", "--git-dir"])).code === 0;
-  if (!isRepo) {
-    log.step("Initializing git…");
-    if ((await run("git", ["init"])).code !== 0) {
-      log.warn("git init failed — skipping push (use `genex publish --no-push` to silence).");
-      return;
-    }
-  }
-
-  await run("git", ["add", "-A"]);
-  const commit = await run("git", ["commit", "-m", "build"]);
-  if (commit.code !== 0 && !/nothing to commit/i.test(commit.out + commit.err)) {
-    log.dim("  (no new commit to push)");
-  }
-
-  log.step("Pushing your game over SSH…");
-  const push = await run("git", ["push", sshUrl, "HEAD:main"], {
-    GIT_SSH_COMMAND: `ssh -i ./${KEY_NAME} -o IdentitiesOnly=yes -o StrictHostKeyChecking=accept-new`,
-  });
-  if (push.code === 0) {
-    log.success("Pushed to main.");
-  } else {
-    log.warn("git push didn't succeed (expected locally — the mock provider has no real repo).");
-    const tail = push.err.trim().split("\n").slice(-1)[0];
-    if (tail) log.dim(`  ${tail}`);
-  }
-}

package/src/config.ts

@@ -1,102 +0,0 @@
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-/**
- * The Genex authorization SITE — the web app that renders `/cli/auth` + `/login`
- * (NOT the API). The CLI opens `<authUrl>/cli/auth` in the browser. Override with
- * `GENEX_AUTH_URL` or `--auth-url` (locally: http://localhost:5173).
- */
-export const DEFAULT_AUTH_URL = "https://demo-web.glotech.world";
-
-/**
- * The Genex API base URL (where projects are created + published). Distinct from
- * the auth site. Override with `GENEX_API_URL` or `--api-url` (locally:
- * http://localhost:3000).
- */
-export const DEFAULT_API_URL = "https://demo-api.glotech.world";
-
-/**
- * The Colyseus multiplayer relay URL. Stored in the project metadata + printed so
- * the agent's game can `connect({ url, room: slug })`. Override with
- * `GENEX_COLYSEUS_URL` or `--colyseus-url` (locally: ws://localhost:2567).
- */
-export const DEFAULT_COLYSEUS_URL = "wss://demo-colyseus.glotech.world";
-
-/** Environment variable name written to `~/.genex/env` after authorizing. */
-export const ENV_TOKEN_KEY = "GENEX_TOKEN";
-
-/** Environment variable that overrides {@link DEFAULT_AUTH_URL}. */
-export const AUTH_URL_ENV = "GENEX_AUTH_URL";
-
-/** Environment variable that overrides {@link DEFAULT_API_URL}. */
-export const API_URL_ENV = "GENEX_API_URL";
-
-/** Environment variable that overrides {@link DEFAULT_COLYSEUS_URL}. */
-export const COLYSEUS_URL_ENV = "GENEX_COLYSEUS_URL";
-
-/**
- * Resolve the auth site URL, honoring (in order): an explicit override
- * (the `--auth-url` flag), the `GENEX_AUTH_URL` env var, then the default.
- * Any trailing slashes are trimmed so we can safely append paths.
- */
-export function getAuthUrl(override?: string): string {
-  const raw = override || process.env[AUTH_URL_ENV] || DEFAULT_AUTH_URL;
-  return raw.replace(/\/+$/, "");
-}
-
-/**
- * Resolve the API base URL, honoring (in order): an explicit override (the
- * `--api-url` flag), the `GENEX_API_URL` env var, then the default. Trailing
- * slashes are trimmed so we can safely append paths.
- */
-export function getApiUrl(override?: string): string {
-  const raw = override || process.env[API_URL_ENV] || DEFAULT_API_URL;
-  return raw.replace(/\/+$/, "");
-}
-
-/**
- * Resolve the Colyseus relay URL, honoring (in order): an explicit override (the
- * `--colyseus-url` flag), the `GENEX_COLYSEUS_URL` env var, then the default.
- */
-export function getColyseusUrl(override?: string): string {
-  const raw = override || process.env[COLYSEUS_URL_ENV] || DEFAULT_COLYSEUS_URL;
-  return raw.replace(/\/+$/, "");
-}
-
-/** The per-user Genex config dir (`~/.genex`) holding the auth token. */
-export function getGenexDir(): string {
-  return path.join(os.homedir(), ".genex");
-}
-
-/**
- * Default location of the per-user env file the token is written to
- * (`~/.genex/env`), or an explicit path when `--env` is supplied.
- */
-export function getGenexEnvPath(override?: string): string {
-  if (override) return path.resolve(override);
-  return path.join(getGenexDir(), "env");
-}
-
-/** Absolute path to the bundled `templates/` directory shipped with the package. */
-export function getTemplatesDir(): string {
-  // After bundling, this module lives at `dist/index.js`; templates sit at the
-  // package root, one level up.
-  const here = path.dirname(fileURLToPath(import.meta.url));
-  return path.resolve(here, "..", "templates");
-}
-
-/**
- * The destination workspace — the user's global `~/.claude` directory by
- * default, or an explicit path when `--dir` is supplied.
- */
-export function getClaudeDir(override?: string): string {
-  if (override) return path.resolve(override);
-  return path.join(os.homedir(), ".claude");
-}
-
-/** Default location of the `.env` file we write the token into. */
-export function getEnvPath(override?: string): string {
-  if (override) return path.resolve(override);
-  return path.join(process.cwd(), ".env");
-}

package/src/index.ts

@@ -1,238 +0,0 @@
-#!/usr/bin/env node
-import { readFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { runInit, type InitOptions } from "./commands/init.ts";
-import { runPublish, type PublishOptions } from "./commands/publish.ts";
-import { DEFAULT_API_URL, DEFAULT_AUTH_URL } from "./config.ts";
-import { createLogger } from "./utils/logger.ts";
-import { c } from "./utils/colors.ts";
-
-type CliOptions = InitOptions & PublishOptions;
-
-function getVersion(): string {
-  try {
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const pkg = JSON.parse(
-      readFileSync(path.resolve(here, "..", "package.json"), "utf8"),
-    ) as { version?: string };
-    return pkg.version ?? "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-
-const HELP = `${c.bold("genex")} — set up your ~/.claude workspace, authorize, and publish 3D games.
-
-${c.bold("Usage")}
-  genex init [<name>] [options]      Scaffold + authorize + create the draft project.
-  genex publish [options]            Push the built game and list it in the gallery.
-
-${c.bold("Options for `init`")}
-  <name>               Project name (positional; default: current directory name).
-  --name <name>        Same as the positional name.
-  --dir <path>         Destination workspace (default: ~/.claude).
-  --env <path>         Token env file (default: ~/.genex/env).
-  --auth-url <url>     Override the auth site (default: ${DEFAULT_AUTH_URL}).
-  --api-url <url>      Override the API base URL (default: ${DEFAULT_API_URL}).
-  --colyseus-url <url> Override the multiplayer URL (stored in project metadata).
-  --no-auth            Only scaffold templates; skip authorization.
-  --force              Overwrite existing files (default: never overwrite).
-  --timeout <seconds>  How long to wait for the auth redirect (default: 300).
-
-${c.bold("Options for `publish`")}
-  --no-push            Skip the git push; only flip the gallery flag.
-  --title <title>      Gallery title.
-  --description <text> Gallery description.
-  --api-url <url>      Override the API base URL.
-  --env <path>         Token env file (default: ~/.genex/env).
-
-${c.bold("Global")}
-  --quiet              Reduce output.
-  -h, --help           Show this help.
-  -v, --version        Show the version.
-
-${c.bold("Environment")}
-  GENEX_AUTH_URL       Overrides the default auth site URL.
-  GENEX_API_URL        Overrides the default API base URL.
-  GENEX_COLYSEUS_URL   Overrides the default multiplayer URL.
-  GENEX_BROWSER        Command used to open the browser (falls back to BROWSER).
-
-${c.bold("Examples")}
-  genex init my-game
-  genex init my-game --api-url http://localhost:3000 --auth-url http://localhost:5173
-  genex publish
-  genex publish --no-push --title "My Game"
-`;
-
-interface ParsedArgs {
-  command: string | undefined;
-  options: CliOptions;
-  help: boolean;
-  version: boolean;
-  error?: string;
-}
-
-function parseArgs(argv: string[]): ParsedArgs {
-  const parsed: ParsedArgs = {
-    command: undefined,
-    options: {},
-    help: false,
-    version: false,
-  };
-
-  // The value-taking flags and where they land on the options object.
-  const needsValue = new Set([
-    "--dir",
-    "--env",
-    "--auth-url",
-    "--api-url",
-    "--colyseus-url",
-    "--name",
-    "--title",
-    "--description",
-    "--timeout",
-  ]);
-
-  let i = 0;
-  while (i < argv.length) {
-    const arg = argv[i++];
-    if (arg === undefined) break;
-
-    switch (arg) {
-      case "-h":
-      case "--help":
-        parsed.help = true;
-        break;
-      case "-v":
-      case "--version":
-        parsed.version = true;
-        break;
-      case "--no-auth":
-        parsed.options.noAuth = true;
-        break;
-      case "--no-push":
-        parsed.options.noPush = true;
-        break;
-      case "--force":
-        parsed.options.force = true;
-        break;
-      case "--quiet":
-        parsed.options.quiet = true;
-        break;
-      default: {
-        if (needsValue.has(arg)) {
-          const value = argv[i++];
-          if (value === undefined) {
-            parsed.error = `Missing value for ${arg}`;
-            return parsed;
-          }
-          applyValueFlag(parsed.options, arg, value);
-        } else if (arg.startsWith("-")) {
-          parsed.error = `Unknown option: ${arg}`;
-          return parsed;
-        } else if (parsed.command === undefined) {
-          parsed.command = arg;
-        } else if (parsed.options.name === undefined) {
-          // Second positional → project name (e.g. `genex init my-game`).
-          parsed.options.name = arg;
-        } else {
-          parsed.error = `Unexpected argument: ${arg}`;
-          return parsed;
-        }
-        break;
-      }
-    }
-  }
-
-  return parsed;
-}
-
-function applyValueFlag(
-  options: CliOptions,
-  flag: string,
-  value: string,
-): void {
-  switch (flag) {
-    case "--dir":
-      options.dir = value;
-      break;
-    case "--env":
-      options.envPath = value;
-      break;
-    case "--auth-url":
-      options.authUrl = value;
-      break;
-    case "--api-url":
-      options.apiUrl = value;
-      break;
-    case "--colyseus-url":
-      options.colyseusUrl = value;
-      break;
-    case "--name":
-      options.name = value;
-      break;
-    case "--title":
-      options.title = value;
-      break;
-    case "--description":
-      options.description = value;
-      break;
-    case "--timeout": {
-      const n = Number(value);
-      if (!Number.isFinite(n) || n <= 0) {
-        throw new Error(`Invalid --timeout value: ${value}`);
-      }
-      options.timeoutSec = n;
-      break;
-    }
-  }
-}
-
-async function main(): Promise<void> {
-  const log = createLogger();
-  let parsed: ParsedArgs;
-  try {
-    parsed = parseArgs(process.argv.slice(2));
-  } catch (err) {
-    log.error(err instanceof Error ? err.message : String(err));
-    process.exitCode = 1;
-    return;
-  }
-
-  if (parsed.error) {
-    log.error(parsed.error);
-    log.plain(`Run ${c.cyan("genex --help")} for usage.`);
-    process.exitCode = 1;
-    return;
-  }
-
-  if (parsed.version) {
-    log.plain(getVersion());
-    return;
-  }
-
-  if (parsed.help || parsed.command === undefined) {
-    log.plain(HELP);
-    return;
-  }
-
-  switch (parsed.command) {
-    case "init":
-      await runInit(parsed.options);
-      break;
-    case "publish":
-      await runPublish(parsed.options);
-      break;
-    default:
-      log.error(`Unknown command: ${parsed.command}`);
-      log.plain(`Run ${c.cyan("genex --help")} for usage.`);
-      process.exitCode = 1;
-  }
-}
-
-main().catch((err: unknown) => {
-  const log = createLogger();
-  log.error(err instanceof Error ? err.message : String(err));
-  process.exitCode = 1;
-});