@bitmagic/cli 0.1.37 → 0.1.39

package/dist/commands/usage.d.ts

@@ -0,0 +1,76 @@
+/**
+ * `bitmagic usage` — where this account's sparks went.
+ *
+ * The server does the aggregating (GET /api/cli/v1/sparks/usage), and the plan
+ * page on the web renders the SAME payload, so the two surfaces cannot disagree
+ * about what a category means or which window is which.
+ *
+ * Rendering is a pure function over the response, following the bake-progress
+ * convention: formatting is testable without a network, and printing is one
+ * call. Plain aligned text and no colour — an agent tool is usually what reads
+ * this, and render/inline-image.ts is documented as the only place in the
+ * package that writes escape sequences.
+ */
+interface UsageWindow {
+    limit: number;
+    used: number;
+    remaining: number;
+    /** Epoch ms, or null when the window is closed and reopens on next use. */
+    resetsAt: number | null;
+}
+interface UsageAllowance {
+    total: number;
+    long: UsageWindow;
+    short: UsageWindow;
+}
+export interface UsageResponse {
+    success: boolean;
+    userId: string;
+    period: {
+        days: number;
+        fromMs: number;
+        toMs: number;
+    };
+    totalSparks: number;
+    fromAllowance: number;
+    fromPurchased: number;
+    byCategory: Array<{
+        category: string;
+        label: string;
+        sparks: number;
+    }>;
+    byDay: Array<{
+        day: string;
+        sparks: number;
+    }>;
+    allowance: UsageAllowance | null;
+}
+/** "2h 10m" / "40m" / "4d" — coarse on purpose; this is a report, not a countdown. */
+export declare function formatResetIn(resetsAt: number | null, now: number): string;
+/**
+ * PURE. The whole report as text.
+ *
+ * `now` is a parameter rather than a `Date.now()` call so reset times are
+ * testable, and so every line of one report agrees on a single instant.
+ */
+export declare function formatUsageReport(report: UsageResponse, now?: number): string;
+export interface UsageOptions {
+    days?: number;
+    env?: string;
+}
+export declare function runUsage(options?: UsageOptions): Promise<UsageResponse>;
+export declare const usageCommand: import("citty").CommandDef<{
+    readonly days: {
+        readonly type: "string";
+        readonly description: "How many days to report on (default 30, max 90).";
+    };
+    readonly env: {
+        readonly type: "string";
+        readonly description: "Environment to query (dev, prod, local).";
+    };
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Print the result as JSON on stdout; all progress goes to stderr.";
+    };
+}>;
+export {};

package/dist/commands/usage.js

@@ -0,0 +1,117 @@
+import { defineCommand } from 'citty';
+import { resolveEnvironment, resolveAuth0ClientId } from '../config/environments.js';
+import { readDefaultEnvironment } from '../config/credentials.js';
+import { getAccessToken } from '../auth/session.js';
+import { apiGet } from '../http/client.js';
+import { createOutput } from '../output.js';
+const BAR_WIDTH = 18;
+function bar(value, max) {
+    if (max <= 0 || value <= 0)
+        return '';
+    // At least one block for any non-zero value, so a small category is visible
+    // rather than reading as nothing at all.
+    return '▇'.repeat(Math.max(1, Math.round((value / max) * BAR_WIDTH)));
+}
+function sparks(n) {
+    return n.toLocaleString('en-US');
+}
+/** "2h 10m" / "40m" / "4d" — coarse on purpose; this is a report, not a countdown. */
+export function formatResetIn(resetsAt, now) {
+    if (resetsAt === null)
+        return 'resets when you next use it';
+    const minutes = Math.max(0, Math.ceil((resetsAt - now) / 60_000));
+    if (minutes < 60)
+        return `resets in ${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48) {
+        const rest = minutes % 60;
+        return rest === 0 ? `resets in ${hours}h` : `resets in ${hours}h ${rest}m`;
+    }
+    return `resets in ${Math.floor(hours / 24)}d`;
+}
+/** '2026-08-13' -> 'Aug 13'. */
+function shortDay(day) {
+    const d = new Date(`${day}T00:00:00Z`);
+    if (Number.isNaN(d.getTime()))
+        return day;
+    return `${d.toLocaleString('en-US', { month: 'short', timeZone: 'UTC' })} ${d.getUTCDate()}`;
+}
+/**
+ * PURE. The whole report as text.
+ *
+ * `now` is a parameter rather than a `Date.now()` call so reset times are
+ * testable, and so every line of one report agrees on a single instant.
+ */
+export function formatUsageReport(report, now = Date.now()) {
+    const lines = [];
+    lines.push(`Bitmagic usage — last ${report.period.days} days`);
+    lines.push('');
+    if (report.allowance) {
+        const windows = [
+            ['This 5-hour window', report.allowance.short],
+            ['This week', report.allowance.long],
+        ];
+        const labelWidth = Math.max(...windows.map(([label]) => label.length));
+        for (const [label, w] of windows) {
+            const amount = `${sparks(w.used)} / ${sparks(w.limit)}`;
+            lines.push(`  ${label.padEnd(labelWidth)}  ${amount.padStart(13)}   ${formatResetIn(w.resetsAt, now)}`);
+        }
+        lines.push('');
+    }
+    if (report.totalSparks === 0) {
+        lines.push('  No sparks spent in this period.');
+        return lines.join('\n');
+    }
+    const labelWidth = Math.max(...report.byCategory.map((c) => c.label.length), 'Total'.length);
+    const topCategory = report.byCategory[0]?.sparks ?? 0;
+    for (const c of report.byCategory) {
+        lines.push(`  ${c.label.padEnd(labelWidth)}  ${sparks(c.sparks).padStart(8)}  ${bar(c.sparks, topCategory)}`);
+    }
+    const split = report.allowance || report.fromAllowance > 0
+        ? `   (${sparks(report.fromAllowance)} from your Pro allowance, ${sparks(report.fromPurchased)} from your balance)`
+        : '';
+    lines.push(`  ${'Total'.padEnd(labelWidth)}  ${sparks(report.totalSparks).padStart(8)}${split}`);
+    // Only the tail of the series, and only once something was actually spent —
+    // 30 mostly-empty rows is noise, not a trend.
+    const recent = report.byDay.slice(-14);
+    const busiest = Math.max(...recent.map((d) => d.sparks), 0);
+    if (busiest > 0) {
+        lines.push('');
+        for (const d of recent) {
+            lines.push(`  ${shortDay(d.day).padEnd(7)} ${bar(d.sparks, busiest).padEnd(BAR_WIDTH)}  ${sparks(d.sparks).padStart(7)}`);
+        }
+    }
+    return lines.join('\n');
+}
+const deviceFlowDeps = { fetch: globalThis.fetch, sleep: (ms) => new Promise((r) => setTimeout(r, ms)) };
+export async function runUsage(options = {}) {
+    const environment = resolveEnvironment({
+        explicit: options.env,
+        storedDefault: readDefaultEnvironment(),
+    });
+    const clientId = resolveAuth0ClientId(environment);
+    const token = await getAccessToken(environment, clientId, deviceFlowDeps);
+    const query = options.days === undefined ? '' : `?days=${encodeURIComponent(String(options.days))}`;
+    return apiGet(environment, `/api/cli/v1/sparks/usage${query}`, token, {
+        fetch: globalThis.fetch,
+    });
+}
+export const usageCommand = defineCommand({
+    meta: { name: 'usage', description: 'Show where this account\'s sparks went, and what Pro allowance is left.' },
+    args: {
+        days: { type: 'string', description: 'How many days to report on (default 30, max 90).' },
+        env: { type: 'string', description: 'Environment to query (dev, prod, local).' },
+        json: {
+            type: 'boolean',
+            description: 'Print the result as JSON on stdout; all progress goes to stderr.',
+        },
+    },
+    async run({ args }) {
+        const output = createOutput(args.json === true);
+        const days = args.days === undefined ? undefined : Number(args.days);
+        const report = await runUsage({ days, env: args.env });
+        output.info(formatUsageReport(report));
+        output.result({ ok: true, ...report });
+    },
+});
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

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

package/dist/commands/verify.d.ts

@@ -1,7 +1,19 @@
 export declare const verifyCommand: import("citty").CommandDef<{
     readonly timeout: {
         readonly type: "string";
-        readonly description: "Settle time in ms (default 15000).";
+        readonly description: string;
+    };
+    readonly renderer: {
+        readonly type: "string";
+        readonly description: "Renderer to boot the game with: webgpu (default, what players run) or webgl.";
+    };
+    readonly fast: {
+        readonly type: "boolean";
+        readonly description: string;
+    };
+    readonly watch: {
+        readonly type: "boolean";
+        readonly description: string;
     };
     readonly json: {
         readonly type: "boolean";

package/dist/commands/verify.js

@@ -5,11 +5,13 @@ import { spawn, spawnSync } from 'child_process';
 import { CliError } from '../errors.js';
 import { loadProjectContext, projectBin } from '../project/context.js';
 import { reserveCorsAllowedPort, CORS_ALLOWED_PORT_MIN, CORS_ALLOWED_PORT_MAX } from '../local-port.js';
+import { browserRendererArgs, shouldRetrySoftwareGl } from '../browser-gl.js';
 import { runHeadlessCheck, DEFAULT_START_INTERACTION } from '../verify/browser.js';
 import { classifyVerifyRun } from '../verify/classify.js';
 import { waitForServer } from '../verify/wait-for-server.js';
 import { computeFingerprint } from '../publish/fingerprint.js';
 import { writeVerifyRecord, decideVerifyOutcome, recordAndGateVerify } from '../verify/result.js';
+import { runVerifyWatch } from '../verify/iterate.js';
 import { createOutput } from '../output.js';
 const DEFAULT_SETTLE_MS = 15_000;
 /**
@@ -51,6 +53,19 @@ function watchForEarlyExit(child, getStderr) {
         });
     });
 }
+/**
+ * `--renderer` picks the pipeline the game boots with (`?renderer=` — the engine honours it over
+ * every other preference source). The default is webgpu because that is what players get
+ * (`DEFAULT_RENDERER_TYPE`), so verify exercises the shipped path; `webgl` is the deliberate
+ * escape hatch for environments whose headless WebGPU cannot come up.
+ */
+function parseRendererArg(raw) {
+    if (raw === undefined)
+        return 'webgpu';
+    if (raw === 'webgpu' || raw === 'webgl')
+        return raw;
+    throw new CliError(`--renderer must be "webgpu" or "webgl", got ${JSON.stringify(raw)}.`);
+}
 /** `--timeout` is settle time in ms and must be a usable duration, not just "parses as a number":
  *  NaN (e.g. `30s`) would settle for ~0ms and fail a healthy game; 0 or negative are meaningless. */
 function parseTimeoutArg(raw) {
@@ -62,10 +77,56 @@ function parseTimeoutArg(raw) {
     }
     return value;
 }
+/**
+ * The one-line live-state summary, e.g.
+ * `Settled in 5.2s · 58 fps · playing · player at (12, 3, -8) · 41 bodies`.
+ * Only observed parts appear — an older engine yields just the settle duration.
+ */
+function describeRunState(observations) {
+    const parts = [];
+    if (observations.settle) {
+        const seconds = (observations.settle.durationMs / 1000).toFixed(1);
+        parts.push(observations.settle.reason === 'stable'
+            ? `Settled in ${seconds}s`
+            : `Settle hit the ${seconds}s cap`);
+    }
+    const snapshot = observations.snapshot;
+    if (snapshot) {
+        if (snapshot.fps !== null)
+            parts.push(`${snapshot.fps} fps`);
+        if (snapshot.gameState !== null)
+            parts.push(snapshot.gameState);
+        if (snapshot.player !== null) {
+            const { x, y, z } = snapshot.player;
+            parts.push(`player at (${Math.round(x)}, ${Math.round(y)}, ${Math.round(z)})`);
+        }
+        if (snapshot.physics !== null)
+            parts.push(`${snapshot.physics.rigidBodyCount} bodies`);
+    }
+    return parts.length === 0 ? 'Run state: unobserved' : parts.join(' · ');
+}
 export const verifyCommand = defineCommand({
     meta: { name: 'verify', description: 'Boot the game in a real browser and report what broke.' },
     args: {
-        timeout: { type: 'string', description: `Settle time in ms (default ${DEFAULT_SETTLE_MS}).` },
+        timeout: {
+            type: 'string',
+            description: `Max settle time in ms (default ${DEFAULT_SETTLE_MS}); the run ends sooner `
+                + 'when the game provably reaches stable gameplay.',
+        },
+        renderer: {
+            type: 'string',
+            description: 'Renderer to boot the game with: webgpu (default, what players run) or webgl.',
+        },
+        fast: {
+            type: 'boolean',
+            description: 'Skip the screenshot pipeline for a faster verdict (default in --watch; '
+                + 'publish then has no thumbnail candidate from this run).',
+        },
+        watch: {
+            type: 'boolean',
+            description: 'Keep everything warm and re-verify on file change — incremental tsc, one '
+                + 'vite, one browser. Runs until Ctrl-C.',
+        },
         json: {
             type: 'boolean',
             description: 'Print the result as JSON on stdout; all progress goes to stderr.',
@@ -73,23 +134,35 @@ export const verifyCommand = defineCommand({
     },
     async run({ args }) {
         const settleMs = parseTimeoutArg(args.timeout);
+        const renderer = parseRendererArg(args.renderer);
+        const watch = args.watch === true;
+        // Watch mode defaults to fast: its iterations are for the agent's inner loop, where the
+        // screenshot is dead weight; `--no-fast` (or a final one-shot run) restores it.
+        const fast = watch ? args.fast !== false : args.fast === true;
         const context = loadProjectContext();
         const tsc = projectBin(context.root, 'tsc');
         const vite = projectBin(context.root, 'vite');
         const output = createOutput(args.json === true);
-        output.info('Building…');
-        const build = spawnSync(tsc, [], { cwd: context.root, stdio: 'inherit' });
-        if (build.error) {
-            throw new CliError(`Could not run the TypeScript compiler: ${build.error.message}`);
-        }
-        if (build.status !== 0) {
-            // Nothing to verify: the emitted output the browser would load does not exist.
-            throw new CliError('Build failed, so there is nothing to verify.', build.status ?? 1);
+        if (!watch) {
+            output.info('Building…');
+            const build = spawnSync(tsc, [], { cwd: context.root, stdio: 'inherit' });
+            if (build.error) {
+                throw new CliError(`Could not run the TypeScript compiler: ${build.error.message}`);
+            }
+            if (build.status !== 0) {
+                // Nothing to verify: the emitted output the browser would load does not exist.
+                throw new CliError('Build failed, so there is nothing to verify.', build.status ?? 1);
+            }
         }
         const artifactDir = path.join(context.root, '.bitmagic', 'verify');
         fs.mkdirSync(artifactDir, { recursive: true });
         const screenshotPath = path.join(artifactDir, 'screenshot.png');
         const consolePath = path.join(artifactDir, 'console.log');
+        if (fast) {
+            // A fast run captures no screenshot; a stale one lying next to a fresh result.json would
+            // be worse than none — publish would ship an image of some earlier state of the game.
+            fs.rmSync(screenshotPath, { force: true });
+        }
         const port = await freePort();
         let server;
         try {
@@ -105,19 +178,66 @@ export const verifyCommand = defineCommand({
                 waitForServer(port, 30_000),
                 watchForEarlyExit(server, () => viteStderr),
             ]);
+            if (watch) {
+                await runVerifyWatch({
+                    root: context.root,
+                    tsc,
+                    artifactDir,
+                    consolePath,
+                    screenshotPath,
+                    port,
+                    renderer,
+                    settleMs,
+                    fast,
+                    output,
+                    describeRunState,
+                });
+                return;
+            }
             // No ?autostart=1: verify clicks the engine Play button like a real player would
             // (startInteraction), which both proves the menu came up AND that gameplay starts from it.
             // Autostart bypassed the menu — a game whose Play flow was broken could still pass.
-            const observations = await runHeadlessCheck({
-                url: `http://localhost:${port}/`,
+            // ?renderer= pins the pipeline so the verdict does not depend on a stale localStorage
+            // preference left by whoever opened this game in a browser last.
+            const checkOptions = {
+                url: `http://localhost:${port}/?renderer=${renderer}`,
                 screenshotPath,
                 consolePath,
                 settleMs,
                 startInteraction: DEFAULT_START_INTERACTION,
+                requestedRenderer: renderer,
+                captureScreenshot: !fast,
+            };
+            let observations = await runHeadlessCheck({
+                ...checkOptions,
+                browserArgs: browserRendererArgs(process.env, renderer),
             });
-            const result = classifyVerifyRun(observations);
-            const outcome = decideVerifyOutcome(result, computeFingerprint(context.root), new Date().toISOString());
-            recordAndGateVerify(artifactDir, outcome, { consolePath, screenshotPath }, {
+            let result = classifyVerifyRun(observations);
+            let retriedWithSoftwareGl = false;
+            if (!result.ok && shouldRetrySoftwareGl(observations, process.env)) {
+                // A lost context is a machine/driver problem, not a game problem (browser-gl.ts) — one
+                // automatic software-GL re-run answers "is the game broken or is this GPU stack broken"
+                // without the creator having to know the env var exists. The retry's console goes to its
+                // own file so the first run's evidence survives.
+                output.info('The WebGL context was lost — retrying once with software rendering…');
+                observations = await runHeadlessCheck({
+                    ...checkOptions,
+                    consolePath: path.join(artifactDir, 'console.retry.log'),
+                    browserArgs: browserRendererArgs({ ...process.env, BITMAGIC_BROWSER_SOFTWARE_GL: 'true' }, renderer),
+                });
+                result = classifyVerifyRun(observations);
+                retriedWithSoftwareGl = true;
+            }
+            const observedBackend = observations.renderer?.backend ?? 'unobserved';
+            output.info(`Renderer: ${renderer} requested → ${observedBackend} backend`);
+            output.info(describeRunState(observations));
+            const outcome = decideVerifyOutcome(result, computeFingerprint(context.root), new Date().toISOString(), {
+                renderer: observations.renderer,
+                settle: observations.settle,
+                snapshot: observations.snapshot,
+                ...(retriedWithSoftwareGl ? { retriedWithSoftwareGl } : {}),
+            });
+            recordAndGateVerify(artifactDir, outcome, { consolePath, ...(fast ? {} : { screenshotPath }) }, {
                 write: writeVerifyRecord,
                 // Under --json both streams are prose and belong on stderr; the result document below
                 // is the only thing stdout carries.
@@ -131,9 +251,13 @@ export const verifyCommand = defineCommand({
                 failures: outcome.record.failures,
                 warnings: outcome.record.warnings,
                 fingerprint: outcome.record.fingerprint,
+                renderer: outcome.record.renderer,
+                retriedWithSoftwareGl: outcome.record.retriedWithSoftwareGl,
+                settle: outcome.record.settle,
+                snapshot: outcome.record.snapshot,
                 artifactDir,
                 consolePath,
-                screenshotPath,
+                screenshotPath: fast ? undefined : screenshotPath,
             });
         }
         finally {

package/dist/commands/verify.js.map

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

package/dist/commands/whoami.d.ts

@@ -1,7 +1,13 @@
-export interface WhoamiResponse {
-    userId: string;
-    roles: string[];
-}
+import { type WhoamiResponse } from '../auth/subscribe-flow.js';
+export type { WhoamiResponse };
+/**
+ * `bitmagic whoami` — who the CLI is authenticated as, and whether that account
+ * may use it.
+ *
+ * The endpoint behind this sits outside the CLI's entitlement gate, so it
+ * answers for an unsubscribed creator too — that is the whole point: "why is
+ * this refusing me" needs an answer that is not itself refused.
+ */
 export declare function runWhoami(explicitEnv?: string): Promise<WhoamiResponse>;
 export declare const whoamiCommand: import("citty").CommandDef<{
     readonly env: {

package/dist/commands/whoami.js

@@ -2,19 +2,24 @@ import { defineCommand } from 'citty';
 import { resolveEnvironment, resolveAuth0ClientId } from '../config/environments.js';
 import { readDefaultEnvironment } from '../config/credentials.js';
 import { getAccessToken } from '../auth/session.js';
-import { apiGet } from '../http/client.js';
+import { fetchWhoami, defaultSubscribeDeps, describeProStatus } from '../auth/subscribe-flow.js';
 import { createOutput } from '../output.js';
-const deviceFlowDeps = { fetch: globalThis.fetch, sleep: (ms) => new Promise((r) => setTimeout(r, ms)) };
+/**
+ * `bitmagic whoami` — who the CLI is authenticated as, and whether that account
+ * may use it.
+ *
+ * The endpoint behind this sits outside the CLI's entitlement gate, so it
+ * answers for an unsubscribed creator too — that is the whole point: "why is
+ * this refusing me" needs an answer that is not itself refused.
+ */
 export async function runWhoami(explicitEnv) {
     const environment = resolveEnvironment({
         explicit: explicitEnv,
         storedDefault: readDefaultEnvironment(),
     });
     const clientId = resolveAuth0ClientId(environment);
-    const token = await getAccessToken(environment, clientId, deviceFlowDeps);
-    return apiGet(environment, '/api/cli/v1/whoami', token, {
-        fetch: globalThis.fetch,
-    });
+    const token = await getAccessToken(environment, clientId, defaultSubscribeDeps);
+    return fetchWhoami(environment, token, defaultSubscribeDeps);
 }
 export const whoamiCommand = defineCommand({
     meta: { name: 'whoami', description: 'Show the identity the CLI is authenticated as.' },
@@ -30,7 +35,17 @@ export const whoamiCommand = defineCommand({
         const me = await runWhoami(args.env);
         output.info(`user:  ${me.userId}`);
         output.info(`roles: ${me.roles.length > 0 ? me.roles.join(', ') : '(none)'}`);
-        output.result({ ok: true, userId: me.userId, roles: me.roles });
+        output.info(`pro:   ${describeProStatus(me)}`);
+        if (!me.pro)
+            output.info('       Run `bitmagic subscribe` to use the CLI.');
+        output.result({
+            ok: true,
+            userId: me.userId,
+            roles: me.roles,
+            pro: me.pro,
+            proUntil: me.proUntil,
+            cancelAtPeriodEnd: me.cancelAtPeriodEnd ?? false,
+        });
     },
 });
 //# sourceMappingURL=whoami.js.map

package/dist/commands/whoami.js.map

@@ -1 +1 @@
-{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,cAAc,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;AAEvH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAoB;IAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC;QACrC,QAAQ,EAAE,WAAW;QACrB,aAAa,EAAE,sBAAsB,EAAE;KACxC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAiB,WAAW,EAAE,oBAAoB,EAAE,KAAK,EAAE;QACtE,KAAK,EAAE,UAAU,CAAC,KAAK;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACvF,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;QAChF,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,kEAAkE;SAChF;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,iBAAiB,EAAuB,MAAM,2BAA2B,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAoB;IAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC;QACrC,QAAQ,EAAE,WAAW;QACrB,aAAa,EAAE,sBAAsB,EAAE;KACxC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAChF,OAAO,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACvF,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;QAChF,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,kEAAkE;SAChF;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE9E,MAAM,CAAC,IAAI,CAAC,UAAU,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,CAAC,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAE5E,MAAM,CAAC,MAAM,CAAC;YACZ,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,GAAG,EAAE,EAAE,CAAC,GAAG;YACX,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACrB,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,IAAI,KAAK;SACjD,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/forge/upload-proxy.js

@@ -10,7 +10,7 @@
  *
  * Neither half of that reaches api-server. The path it calls is game-play-agent's
  * (`mastra/routes.ts`); api-server serves `POST /api/cli/v1/uploads/signed-url`. And every route
- * under `/api/cli/v1/*` is Auth0 + Admin gated, while a browser page has no token — so pointing
+ * under `/api/cli/v1/*` is Auth0 + entitlement gated, while a browser page has no token — so pointing
  * `agentUrl` straight at api-server answers 401 to every upload, which is exactly what the first
  * end-to-end forge did: 14 archetypes dropped and the level bake failed after voxelizing all 392
  * chunks.

package/dist/http/client.d.ts

@@ -2,5 +2,15 @@ import type { Environment } from '../config/environments.js';
 export interface ApiDeps {
     fetch: typeof globalThis.fetch;
 }
+type FetchResponse = Awaited<ReturnType<typeof globalThis.fetch>>;
+/**
+ * PURE-ish: turn a 403 into the sentence that actually helps.
+ *
+ * Falls back to the generic wording whenever the body is missing, unparseable
+ * or from an older api-server — a CLI that throws while explaining a refusal
+ * would be worse than one that explains it vaguely.
+ */
+export declare function proRefusalMessage(response: FetchResponse): Promise<string>;
 export declare function apiGet<T>(environment: Environment, path: string, accessToken: string, deps: ApiDeps): Promise<T>;
 export declare function apiPost<T>(environment: Environment, path: string, accessToken: string, body: unknown, deps: ApiDeps): Promise<T>;
+export {};

package/dist/http/client.js

@@ -1,4 +1,33 @@
 import { CliError } from '../errors.js';
+/** '2026-08-03T00:00:00.000Z' -> '2026-08-03'; anything unparseable is dropped. */
+function refusalDate(iso) {
+    if (typeof iso !== 'string' || iso.length < 10)
+        return null;
+    return Number.isNaN(new Date(iso).getTime()) ? null : iso.slice(0, 10);
+}
+/**
+ * PURE-ish: turn a 403 into the sentence that actually helps.
+ *
+ * Falls back to the generic wording whenever the body is missing, unparseable
+ * or from an older api-server — a CLI that throws while explaining a refusal
+ * would be worse than one that explains it vaguely.
+ */
+export async function proRefusalMessage(response) {
+    let body = {};
+    try {
+        body = (await response.json());
+    }
+    catch {
+        // Keep the generic message.
+    }
+    if (body.code === 'pro_expired') {
+        const ended = refusalDate(body.proUntil);
+        return (`Your Bitmagic Pro subscription ${ended ? `ended on ${ended}` : 'has ended'}. ` +
+            'Run `bitmagic subscribe` to start it again — your games and projects are untouched.');
+    }
+    return ('The Bitmagic CLI requires an active Bitmagic Pro subscription. ' +
+        'Run `bitmagic subscribe` to start one.');
+}
 /**
  * Shared status handling for every api-server call: the transport-failure/error-status split,
  * and the 401/403/503/other mapping. `apiGet` and `apiPost` differ only in the fetch `init` they
@@ -21,8 +50,15 @@ async function request(environment, path, accessToken, deps, init) {
         throw new CliError('Your session has expired. Run `bitmagic login`.');
     }
     if (response.status === 403) {
-        throw new CliError('Your account is authenticated but does not have the Admin role, which the ' +
-            'Bitmagic CLI requires. Ask a Bitmagic admin to grant it.');
+        // The gate is Bitmagic Pro and nothing else, and `subscribe` is a command
+        // that finishes the job — so name it rather than describing a web page the
+        // creator would have to go find.
+        //
+        // Read the body: api-server distinguishes a lapsed subscription from one
+        // that never existed, and telling a returning customer to "start one"
+        // reads as though their year of paying never happened — it sends them
+        // hunting for a problem with their account instead of renewing.
+        throw new CliError(await proRefusalMessage(response));
     }
     if (response.status === 503) {
         throw new CliError(`api-server reported this feature is unavailable in the "${environment.name}" environment.`);