@bitmagic/cli 0.1.46-dev.2 → 0.1.46-dev.4

package/README.md

@@ -92,6 +92,7 @@ browser reloads itself on every change and the assets panel shows each generatio
 | `bitmagic usage [--days N]` | Where this account's sparks went, and what Pro allowance is left. |
 | `bitmagic allowance [--allow-sparks \| --block-sparks]` | The two Pro allowance windows, and whether your purchased sparks may fund work once they run out. `--allow-sparks` needs a real terminal — it authorises spending your money, so an agent cannot run it for you. |
 | `bitmagic logout [--env <env>]` | Remove stored credentials for an environment. |
+| `bitmagic reset-account [--env <env>] [--yes] [--keep-cli]` | **Deletes your account** on `dev` or `local` so the first-run experience can be tested again — games, sparks, profile, terms acceptance and Bitmagic Pro (cancelled in Stripe first). Then clears that environment's stored credentials **and uninstalls this CLI**, so the next run starts where a new creator starts: `npm install -g @bitmagic/cli`. `--keep-cli` skips that last step. Refuses `prod`, where the endpoint is not deployed at all. Asks you to type the environment name; `--yes` skips that and is required in a shell with no terminal. Your project directory is left alone — its `gameId` no longer exists, so start the fresh run in a new one. |
 | `bitmagic whoami [--env <env>]` | Show the identity the CLI is authenticated as, and which environment answered — including where that environment was chosen from. |
 | `bitmagic init [dir] [--template <id>] [--name <name>] [--idea "<pitch>"] [--env <env>] [--force]` | Scaffold a new project: mints a game, downloads the vendored engine, writes `AGENTS.md`, `GAME-DESIGN.md` and templates. Starts from `empty-3d` unless told otherwise. `--idea` seeds the design doc's pitch **and** picks the template whose camera and controls fit it — "a doom-like corridor shooter" scaffolds `first-person`, "jump between floating islands" scaffolds `sidescroller`. `--template` overrides both; a suggestion that fails for any reason falls back to `empty-3d` rather than failing the scaffold. |
 | `bitmagic check` | Typecheck (`tsc --noEmit`) against the vendored engine. Fast; does not prove the game runs. |
@@ -174,6 +175,14 @@ the release; `@bitmagic/cli@dev` is the prerelease line, developed against `dev`
 endpoints it depends on exist first. Running a dev build against an environment that has not caught
 up fails on endpoints that are not there yet — so pair `@dev` with `bitmagic login --env dev`.
 
+**Inside a project, the pin decides the line**, and nobody should be asked which one they want:
+`dev` and `local` projects take `@bitmagic/cli@dev`, `prod` projects take the plain
+`@bitmagic/cli`. Run a command in a project on the other line and the CLI opens with a notice
+naming the install to switch — and prints only that one, in place of the usual "a newer CLI is
+available" nudge, so there is never a choice of two install commands. The AGENTS.md the CLI
+scaffolds carries the same rule with the project's own command already filled in, which is what
+keeps an agent from putting the question to you.
+
 ## Project layout and artifacts
 
 ```
@@ -561,6 +570,43 @@ Three nudges, all advisory — nothing is ever blocked because something is out
   suggest `bitmagic upgrade`. Publishing is never refused for an old engine — the prompt belongs
   where rebuilding is cheap, not at the moment you ship.
 
+## Usage reporting
+
+While you are logged in, each command tells Bitmagic how it went when it ends. That is: the command
+name, whether it succeeded, its exit code and a failure *category* (`unreachable`, `pro_expired`,
+`insufficient_sparks`, …), how long it took, and the CLI, Node and OS versions. Commands that talk to
+Bitmagic anyway — `generate`, `forge`, `publish` — carry the same identification on the calls they
+already make, which is how a spark charge can be attributed to the command that caused it.
+
+**What is never sent:** your game's source, file names, paths, or command output. Failures are
+reported as categories, never as messages, because a message can quote a path.
+
+**What you type into a command is kept.** The text you pass to `bitmagic forge`, `bitmagic
+generate`, `bitmagic cover` and `bitmagic init --idea` — the descriptions of the world, the asset,
+the game you want — is stored against your account so we can see what creators are trying to make
+and where the generators fall short. It is the same thing the web editor already keeps for prompts
+typed there, and it goes to the same place. None of it reaches Google Analytics, which only ever
+receives counts, outcomes and timings.
+
+If your agent passes it, the wording *you* used when you asked it is kept alongside the command's
+own text. That is optional and most agents will not send it.
+
+This does not include what you type into Claude Code, Codex or any other agent. Bitmagic never sees
+that — the CLI only ever receives the arguments your agent chooses to pass it.
+
+Set `DO_NOT_TRACK=1` in your environment to switch the end-of-command report off. Nothing is
+collected for it in that case — not even the file reads it would have needed.
+
+It does **not** switch off the paragraph above. The text you pass to `forge`, `generate`, `cover`
+and `init --idea` is not telemetry: it is the request, and the server cannot generate anything
+without it. If you would rather it were not kept, the honest answer is that today there is no flag
+for that — tell us and we will add one.
+
+The report is deliberately unobtrusive but it is not free: it is capped at 1.5 seconds per request
+(two at worst, when your access token is due for a refresh first), it never prints, and it can never
+fail a command — but it does happen at exit, so a command can take that much longer to return on a
+network that is dropping packets. It is skipped entirely when you are logged out.
+
 ## Licensing
 
 `bitmagic init` vendors the engine into your project as readable source. It is Bitmagic's IP,

package/dist/auth/session.js

@@ -6,7 +6,7 @@ const EXPIRY_SKEW_MS = 60_000;
 export async function getAccessToken(environment, clientId, deps, baseDir = defaultBaseDir()) {
     const stored = readCredentials(environment.name, baseDir);
     if (!stored) {
-        throw new CliError(`You are not logged in to the "${environment.name}" environment. Run \`bitmagic login\`.`, 2);
+        throw new CliError(`You are not logged in to the "${environment.name}" environment. Run \`bitmagic login\`.`, 2, 'not_logged_in');
     }
     const now = deps.now ?? Date.now;
     if (stored.expiresAt - EXPIRY_SKEW_MS > now()) {

package/dist/auth/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/auth/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAE3E,oEAAoE;AACpE,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAwB,EACxB,QAAgB,EAChB,IAAoB,EACpB,UAAkB,cAAc,EAAE;IAElC,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAChB,iCAAiC,WAAW,CAAC,IAAI,wCAAwC,EACzF,CAAC,CACF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS,GAAG,cAAc,GAAG,GAAG,EAAE,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC7F,gBAAgB,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC,WAAW,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/auth/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAE3E,oEAAoE;AACpE,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAwB,EACxB,QAAgB,EAChB,IAAoB,EACpB,UAAkB,cAAc,EAAE;IAElC,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAChB,iCAAiC,WAAW,CAAC,IAAI,wCAAwC,EACzF,CAAC,EACD,eAAe,CAChB,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS,GAAG,cAAc,GAAG,GAAG,EAAE,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC7F,gBAAgB,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC,WAAW,CAAC;AAC/B,CAAC"}

package/dist/auth/subscribe-flow.d.ts

@@ -13,6 +13,15 @@ export interface WhoamiResponse {
     proUntil: string | null;
     /** Set when the subscription is live but will not renew. Optional: older api-servers omit it. */
     cancelAtPeriodEnd?: boolean;
+    /**
+     * The Bitmagic Pro storefront — where Pro is bought OR a Pro voucher redeemed.
+     *
+     * Optional for the same reason `cancelAtPeriodEnd` is: a CLI published today
+     * can be pointed at an api-server deployed before the storefront existed, and
+     * must still be able to sell a subscription. Absent means "fall back to
+     * minting Stripe Checkout myself".
+     */
+    subscribeUrl?: string;
 }
 /**
  * PURE. One line describing where the caller's subscription stands.
@@ -42,18 +51,33 @@ export interface SubscribeOptions {
     noWait?: boolean;
 }
 export interface SubscribeResult {
-    /** True when the subscription was confirmed active before we returned. */
+    /** True when Pro was confirmed active before we returned. */
     pro: boolean;
-    /** The checkout URL, when one was created (absent if already subscribed). */
-    checkoutUrl?: string;
+    /**
+     * Where the creator finishes subscribing: the storefront, or — against an
+     * api-server predating it — a Stripe Checkout URL. Always set: every exit from
+     * the flow has already opened or printed one.
+     */
+    subscribeUrl: string;
     /** Why we stopped waiting, when we did not confirm. */
     reason?: 'timeout' | 'not-waited';
 }
 /**
- * Explain that Pro is required, open checkout, and wait for it to land.
+ * PURE. The storefront URL to open for this caller.
+ *
+ * `cli=1` only changes the page's wording — it says "go back to your terminal"
+ * once Pro is active. `u` is the account this CLI is authenticated as, so the
+ * page can refuse to sell Pro to a DIFFERENT account that happens to be signed
+ * in to the browser. That mismatch was impossible while the CLI minted the
+ * Stripe session from its own token, and it is invisible from here: the creator
+ * would subscribe the wrong account and this poll would run to its timeout.
+ */
+export declare function storefrontUrlFor(subscribeUrl: string, userId: string): string;
+/**
+ * Explain that Pro is required, open the storefront, and wait for it to land.
  *
  * Returns rather than throwing when the creator does not finish: abandoning
- * checkout is a decision, not an error, and the credentials from a successful
+ * the flow is a decision, not an error, and the credentials from a successful
  * login are still worth keeping.
  */
-export declare function runSubscribeFlow(environment: Environment, token: string, output: Output, options?: SubscribeOptions, deps?: SubscribeDeps): Promise<SubscribeResult>;
+export declare function runSubscribeFlow(environment: Environment, token: string, me: WhoamiResponse, output: Output, options?: SubscribeOptions, deps?: SubscribeDeps): Promise<SubscribeResult>;

package/dist/auth/subscribe-flow.js

@@ -1,19 +1,33 @@
 /**
  * Getting a logged-in creator from "no subscription" to "ready to work".
  *
- * The Bitmagic CLI requires an active Bitmagic Pro subscription, so for a new
- * creator the very first command would otherwise be a 403. Rather than print an
- * error and a URL to retype, the CLI creates the Stripe Checkout session itself
- * and opens it: `bitmagic login` flows straight from the device-code approval
- * into paying, in the same browser, and then confirms.
+ * The Bitmagic CLI requires active Bitmagic Pro, so for a new creator the very
+ * first command would otherwise be a 403. Rather than print an error and a URL
+ * to retype, the CLI opens the Bitmagic Pro storefront: `bitmagic login` flows
+ * straight from the device-code approval into subscribing, in the same browser,
+ * and then confirms.
  *
- * Two api-server routes make this possible, and both live OUTSIDE the CLI's
- * entitlement gate for exactly this reason (see cli-onboarding-routes.ts):
- * `GET /whoami` answers whether the caller is entitled, and
- * `POST /pro/checkout` mints a checkout URL for the caller's own account.
+ * ── Why a storefront and not Stripe Checkout ─────────────────────────────────
  *
- * Shared by `login` and by `subscribe`, so a creator who abandoned checkout
- * gets an identical second run rather than a different-looking recovery path.
+ * This used to POST /pro/checkout and open the Stripe URL directly. That made a
+ * comped-Pro voucher unreachable from the CLI even though `pro_days` satisfies
+ * the entitlement gate exactly as a subscription does — someone holding a code
+ * was shown a card form and nothing else. The storefront offers both, and the
+ * poll below does not care which one the creator picked: `whoami` reports a
+ * grant and a subscription identically.
+ *
+ * The URL comes from `whoami` rather than from the CLI's own config, because
+ * PORTAL_URL is the api-server's to know. Deriving it from `apiUrl` would be
+ * wrong locally, where the api-server is on 3002 and the portal on 4000.
+ *
+ * Both routes live OUTSIDE the CLI's entitlement gate for the obvious reason
+ * (see cli-onboarding-routes.ts): `GET /whoami` answers whether the caller is
+ * entitled and where to fix it, and `POST /pro/checkout` — now called by the
+ * storefront, and by this file only against an api-server too old to have one —
+ * mints a checkout URL for the caller's own account.
+ *
+ * Shared by `login` and by `subscribe`, so a creator who abandoned the flow gets
+ * an identical second run rather than a different-looking recovery path.
  */
 import { apiGet, apiPost } from '../http/client.js';
 import { openInBrowser } from '../open-browser.js';
@@ -50,18 +64,34 @@ export function fetchWhoami(environment, token, deps) {
     return apiGet(environment, '/api/cli/v1/whoami', token, { fetch: deps.fetch });
 }
 /**
- * Explain that Pro is required, open checkout, and wait for it to land.
+ * PURE. The storefront URL to open for this caller.
+ *
+ * `cli=1` only changes the page's wording — it says "go back to your terminal"
+ * once Pro is active. `u` is the account this CLI is authenticated as, so the
+ * page can refuse to sell Pro to a DIFFERENT account that happens to be signed
+ * in to the browser. That mismatch was impossible while the CLI minted the
+ * Stripe session from its own token, and it is invisible from here: the creator
+ * would subscribe the wrong account and this poll would run to its timeout.
+ */
+export function storefrontUrlFor(subscribeUrl, userId) {
+    const separator = subscribeUrl.includes('?') ? '&' : '?';
+    return `${subscribeUrl}${separator}cli=1&u=${encodeURIComponent(userId)}`;
+}
+/**
+ * Explain that Pro is required, open the storefront, and wait for it to land.
  *
  * Returns rather than throwing when the creator does not finish: abandoning
- * checkout is a decision, not an error, and the credentials from a successful
+ * the flow is a decision, not an error, and the credentials from a successful
  * login are still worth keeping.
  */
-export async function runSubscribeFlow(environment, token, output, options = {}, deps = defaultSubscribeDeps) {
-    const checkout = await apiPost(environment, '/api/cli/v1/pro/checkout', token, {}, {
-        fetch: deps.fetch,
-    });
+export async function runSubscribeFlow(environment, token, me, output, options = {}, deps = defaultSubscribeDeps) {
+    // An api-server too old to serve a storefront still has to be able to sell a
+    // subscription, so fall back to minting Checkout the way this flow used to.
+    const url = me.subscribeUrl
+        ? storefrontUrlFor(me.subscribeUrl, me.userId)
+        : (await apiPost(environment, '/api/cli/v1/pro/checkout', token, {}, { fetch: deps.fetch })).url;
     output.info('');
-    output.info('The Bitmagic CLI needs a Bitmagic Pro subscription.');
+    output.info('The Bitmagic CLI needs Bitmagic Pro.');
     output.info('Pro gives you a weekly and a 5-hour spark allowance that refill on their own,');
     output.info('and pays for generating assets, cover art and worlds.');
     output.info('');
@@ -69,34 +99,39 @@ export async function runSubscribeFlow(environment, token, output, options = {},
     // no browser, in a container, and in a log an agent reads back later.
     const opened = options.noOpen === true
         ? false
-        : deps.openInBrowser(checkout.url, { log: (m) => output.info(m) });
-    output.info(opened ? `Opening checkout in your browser:\n  ${checkout.url}` : `Subscribe at:\n  ${checkout.url}`);
+        : deps.openInBrowser(url, { log: (m) => output.info(m) });
+    // Naming the voucher here and not only on the page matters: an agent driving
+    // the CLI reads this text, and the human it is working for may be holding a code.
+    output.info(opened
+        ? `Opening Bitmagic Pro in your browser — subscribe, or redeem a Pro voucher there:\n  ${url}`
+        : `Subscribe, or redeem a Pro voucher, at:\n  ${url}`);
     if (options.noWait === true) {
-        return { pro: false, checkoutUrl: checkout.url, reason: 'not-waited' };
+        return { pro: false, subscribeUrl: url, reason: 'not-waited' };
     }
     output.info('');
-    output.info('Waiting for your subscription… (Ctrl-C is safe — run `bitmagic subscribe` to resume)');
+    output.info('Waiting for Bitmagic Pro… (Ctrl-C is safe — run `bitmagic subscribe` to resume)');
     const deadline = deps.now() + SUBSCRIBE_POLL_TIMEOUT_MS;
     while (deps.now() < deadline) {
         await deps.sleep(SUBSCRIBE_POLL_INTERVAL_MS);
         // A transient failure mid-poll must not end the flow — the creator may
         // still be typing their card in. Only a definitive "yes" stops the loop.
-        let me = null;
+        // This answers for a redeemed voucher too: `pro` is entitlement, not billing.
+        let current = null;
         try {
-            me = await fetchWhoami(environment, token, deps);
+            current = await fetchWhoami(environment, token, deps);
         }
         catch {
             continue;
         }
-        if (me.pro) {
+        if (current.pro) {
             output.info('');
             output.info('Bitmagic Pro is active. You are ready — try `bitmagic init`.');
-            return { pro: true, checkoutUrl: checkout.url };
+            return { pro: true, subscribeUrl: url };
         }
     }
     output.info('');
-    output.info('Still waiting on Stripe. Run `bitmagic usage` once it completes, or');
-    output.info('`bitmagic subscribe` to start again.');
-    return { pro: false, checkoutUrl: checkout.url, reason: 'timeout' };
+    output.info('Still waiting. If you paid, run `bitmagic usage` once Stripe confirms; otherwise');
+    output.info('run `bitmagic subscribe` to start again.');
+    return { pro: false, subscribeUrl: url, reason: 'timeout' };
 }
 //# sourceMappingURL=subscribe-flow.js.map

package/dist/auth/subscribe-flow.js.map

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

package/dist/bin.js

@@ -2,7 +2,8 @@
 import { runMain } from 'citty';
 import { main } from './cli.js';
 import { CliError } from './errors.js';
-import { pendingUpdateNotice, refreshUpdateCacheInBackground } from './update/check.js';
+import { readPinnedEnvironment } from './config/environments.js';
+import { refreshUpdateCacheInBackground, startupNotice } from './update/check.js';
 import { currentCliVersion } from './update/cli-version.js';
 // The version is READ here, not at the import time of anything cli.ts pulls in — cli.test.ts
 // imports cli.ts for `subCommands`, and a version check triggered against the test runner is
@@ -13,7 +14,10 @@ import { currentCliVersion } from './update/cli-version.js';
 // costs no network and no measurable time here. A command that exits early (or via process.exit
 // on a CliError) has still shown it, which printing afterwards could not guarantee.
 const version = currentCliVersion();
-const notice = pendingUpdateNotice(version);
+// The pin is read from the committed bitmagic.json, so running in a project whose environment wants
+// the other npm line says so — and says only that, rather than also offering the newest build of the
+// line you should not be on. See startupNotice.
+const notice = startupNotice(version, readPinnedEnvironment());
 if (notice !== null)
     console.error(notice);
 // Deliberately NOT awaited: this is for the next invocation, not this one. Bounded by its own

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,6FAA6F;AAC7F,6FAA6F;AAC7F,+FAA+F;AAC/F,+BAA+B;AAC/B,EAAE;AACF,kGAAkG;AAClG,gGAAgG;AAChG,oFAAoF;AACpF,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;AACpC,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC5C,IAAI,MAAM,KAAK,IAAI;IAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAE3C,8FAA8F;AAC9F,iGAAiG;AACjG,2FAA2F;AAC3F,KAAK,8BAA8B,CAAC,OAAO,CAAC,CAAC;AAE7C,wFAAwF;AACxF,+FAA+F;AAC/F,8FAA8F;AAC9F,gGAAgG;AAChG,2FAA2F;AAC3F,kGAAkG;AAClG,mGAAmG;AACnG,gGAAgG;AAChG,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAI,IAAI,CAAC,IAAgC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC1G,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,6FAA6F;AAC7F,6FAA6F;AAC7F,+FAA+F;AAC/F,+BAA+B;AAC/B,EAAE;AACF,kGAAkG;AAClG,gGAAgG;AAChG,oFAAoF;AACpF,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;AACpC,oGAAoG;AACpG,qGAAqG;AACrG,gDAAgD;AAChD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;AAC/D,IAAI,MAAM,KAAK,IAAI;IAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAE3C,8FAA8F;AAC9F,iGAAiG;AACjG,2FAA2F;AAC3F,KAAK,8BAA8B,CAAC,OAAO,CAAC,CAAC;AAE7C,wFAAwF;AACxF,+FAA+F;AAC/F,8FAA8F;AAC9F,gGAAgG;AAChG,2FAA2F;AAC3F,kGAAkG;AAClG,mGAAmG;AACnG,gGAAgG;AAChG,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAI,IAAI,CAAC,IAAgC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC1G,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -1,5 +1,28 @@
 import type { ArgsDef, CommandDef } from 'citty';
-export declare function withCleanErrors<T extends ArgsDef>(command: CommandDef<T>): CommandDef<T>;
+import { type BeginCommandInput } from './telemetry/command-context.js';
+import { type CommandReport } from './telemetry/report.js';
+/**
+ * What the wrapper needs from the outside world to report a command's outcome. The real ones
+ * (below) mark the command as begun and send the beacon to api-server; tests pass stubs so a
+ * wrapped command under test never touches `~/.bitmagic` or the network.
+ */
+export interface CommandRunDeps {
+    begin: (input: BeginCommandInput) => void;
+    report: (report: CommandReport) => Promise<void>;
+    now: () => number;
+}
+/**
+ * Wraps a command's `run` so that (a) a CliError becomes a clean single-line message and exit
+ * code, and (b) EVERY run — success, refusal or crash — reports how it went to api-server, once,
+ * with the command's name and duration (see telemetry/report.ts). Doing both here, over the
+ * whole map, is what makes the reporting complete: there is no per-command call anyone can
+ * forget, and the offline commands (`dev`, `build`, `check`, ...) are covered exactly like the
+ * ones that talk to the server anyway.
+ *
+ * `name` is what the report calls the command — `publish`, `generate skybox` — as the creator
+ * typed it.
+ */
+export declare function withCleanErrors<T extends ArgsDef>(command: CommandDef<T>, name?: string, deps?: CommandRunDeps): CommandDef<T>;
 /**
  * Structural check for tests: has this command actually passed through `withCleanErrors`? A leaf
  * command (one with its own `run`) is wrapped when that `run` is in `wrappedRuns`. A grouping
@@ -28,6 +51,24 @@ declare const rawCommands: {
             readonly description: "Print the result as JSON on stdout; all progress goes to stderr.";
         };
     }>;
+    'reset-account': CommandDef<{
+        readonly env: {
+            readonly type: "string";
+            readonly description: "Environment to reset in (dev, local). Never prod.";
+        };
+        readonly yes: {
+            readonly type: "boolean";
+            readonly description: "Skip the confirmation. Required in a non-interactive shell.";
+        };
+        readonly 'keep-cli': {
+            readonly type: "boolean";
+            readonly description: string;
+        };
+        readonly json: {
+            readonly type: "boolean";
+            readonly description: "Print the result as JSON on stdout; all progress goes to stderr.";
+        };
+    }>;
     whoami: CommandDef<{
         readonly env: {
             readonly type: "string";
@@ -45,7 +86,7 @@ declare const rawCommands: {
         };
         readonly 'no-wait': {
             readonly type: "boolean";
-            readonly description: "Open checkout and exit instead of waiting for it to complete.";
+            readonly description: "Open the Bitmagic Pro page and exit instead of waiting for it to complete.";
         };
         readonly json: {
             readonly type: "boolean";

package/dist/cli.js

@@ -1,8 +1,11 @@
 import { defineCommand } from 'citty';
 import { CliError } from './errors.js';
 import { jsonErrorResult } from './output.js';
+import { beginCommand } from './telemetry/command-context.js';
+import { crashCategory, reportCommandEvent } from './telemetry/report.js';
 import { loginCommand } from './commands/login.js';
 import { logoutCommand } from './commands/logout.js';
+import { resetAccountCommand } from './commands/reset-account.js';
 import { whoamiCommand } from './commands/whoami.js';
 import { usageCommand } from './commands/usage.js';
 import { allowanceCommand } from './commands/allowance.js';
@@ -40,13 +43,77 @@ function subCommandsOf(command) {
         return undefined;
     return subs;
 }
-export function withCleanErrors(command) {
+const realRunDeps = {
+    begin: beginCommand,
+    report: reportCommandEvent,
+    now: Date.now,
+};
+/**
+ * The name the wrapper reports for `command`, when the caller did not give one: its own
+ * `meta.name`, or `unknown` for a command that has none. Every entry in `rawCommands` is named
+ * from the map key instead (and its subcommands as `parent sub`), so this only decides for a
+ * command wrapped on its own — which, in practice, means a test's.
+ */
+/**
+ * The `--env` this command will actually honour, or undefined.
+ *
+ * Gated on the command DECLARING an `env` argument, which only eight of the eighteen do — the
+ * rest resolve from the project (`resolveEnvironmentForCommand({ cwd })`) and ignore the flag
+ * entirely. citty still surfaces an undeclared flag in `args`: `--env=dev` arrives as the string
+ * `'dev'` (the space form `--env dev` arrives as `true`, which the type check below would have
+ * caught anyway). Reading it unconditionally therefore pointed the usage report at one
+ * environment while the command worked against another — `bitmagic publish --env=dev` inside a
+ * project pinned to `local` publishes to local and would have reported to dev.
+ */
+function declaredExplicitEnv(command, args) {
+    const declared = (command.args ?? {});
+    if (!Object.prototype.hasOwnProperty.call(declared, 'env'))
+        return undefined;
+    const value = args?.env;
+    return typeof value === 'string' ? value : undefined;
+}
+function commandNameOf(command) {
+    // citty's `meta` is a Resolvable (a value, a promise, or a function returning either); every
+    // meta in this CLI is a plain object, and a test double that is not simply reports `unknown`.
+    const meta = command.meta;
+    if (typeof meta !== 'object' || meta === null)
+        return 'unknown';
+    const name = meta.name;
+    return typeof name === 'string' ? name : 'unknown';
+}
+/**
+ * Wraps a command's `run` so that (a) a CliError becomes a clean single-line message and exit
+ * code, and (b) EVERY run — success, refusal or crash — reports how it went to api-server, once,
+ * with the command's name and duration (see telemetry/report.ts). Doing both here, over the
+ * whole map, is what makes the reporting complete: there is no per-command call anyone can
+ * forget, and the offline commands (`dev`, `build`, `check`, ...) are covered exactly like the
+ * ones that talk to the server anyway.
+ *
+ * `name` is what the report calls the command — `publish`, `generate skybox` — as the creator
+ * typed it.
+ */
+export function withCleanErrors(command, name = commandNameOf(command), deps = realRunDeps) {
     const originalRun = command.run;
     const wrapped = { ...command };
     if (originalRun) {
         wrapped.run = async (context) => {
+            const json = context.args?.json === true;
+            const explicitEnv = declaredExplicitEnv(command, context.args);
+            const startedAt = deps.now();
+            // Before the run, so every api-server call the command makes is stamped with its name.
+            deps.begin({ name, json, explicitEnv, now: deps.now });
+            // Awaited, not fired: it is bounded (report.ts), and on the failure path process.exit
+            // comes next — a fire-and-forget request would be cut off mid-flight.
+            //
+            // `Math.max(0, …)` because the clock is `Date.now()` and therefore not monotonic: an NTP
+            // step backwards mid-command would otherwise send a negative duration, which api-server
+            // rejects — discarding the outcome and the failure category along with it, rather than
+            // just the one bad field.
+            const finished = (outcome) => deps.report({ stage: 'finished', durationMs: Math.max(0, deps.now() - startedAt), ...outcome });
             try {
-                return await originalRun(context);
+                const result = await originalRun(context);
+                await finished({ ok: true });
+                return result;
             }
             catch (error) {
                 if (error instanceof CliError) {
@@ -55,13 +122,16 @@ export function withCleanErrors(command) {
                     // document, so an agent parses one stream for the outcome instead of branching between
                     // "parse stdout" on success and "read prose" on failure.
                     console.error(error.message);
-                    if (context.args?.json === true) {
+                    if (json) {
                         console.log(JSON.stringify(jsonErrorResult(error.message, error.exitCode)));
                     }
+                    await finished({ ok: false, exitCode: error.exitCode, failure: error.code ?? 'cli_error' });
                     process.exit(error.exitCode);
                 }
                 // Not one of ours: let citty's default handling show it, stack trace included — that's
-                // a genuine bug, not a user-facing condition we've designed a message for.
+                // a genuine bug, not a user-facing condition we've designed a message for. citty exits 1
+                // for it, which is what the report says.
+                await finished({ ok: false, exitCode: 1, failure: crashCategory(error) });
                 throw error;
             }
         };
@@ -72,10 +142,10 @@ export function withCleanErrors(command) {
     // unrecursed, a CliError thrown from one of those would clear this command's own (nonexistent)
     // run untouched and hit citty's default handling instead — a raw stack trace, the exact thing
     // this wrapper exists to prevent. Recurse so every depth gets the same clean single-line
-    // treatment.
+    // treatment — and the same report, named `generate skybox` rather than `skybox`.
     const subs = subCommandsOf(command);
     if (subs) {
-        wrapped.subCommands = Object.fromEntries(Object.entries(subs).map(([name, sub]) => [name, withCleanErrors(sub)]));
+        wrapped.subCommands = Object.fromEntries(Object.entries(subs).map(([subName, sub]) => [subName, withCleanErrors(sub, `${name} ${subName}`, deps)]));
     }
     return wrapped;
 }
@@ -101,6 +171,7 @@ export function isWrappedWithCleanErrors(command) {
 const rawCommands = {
     login: loginCommand,
     logout: logoutCommand,
+    'reset-account': resetAccountCommand,
     whoami: whoamiCommand,
     subscribe: subscribeCommand,
     usage: usageCommand,
@@ -117,7 +188,7 @@ const rawCommands = {
     forge: forgeCommand,
     publish: publishCommand,
 };
-export const subCommands = Object.fromEntries(Object.entries(rawCommands).map(([name, command]) => [name, withCleanErrors(command)]));
+export const subCommands = Object.fromEntries(Object.entries(rawCommands).map(([name, command]) => [name, withCleanErrors(command, name)]));
 // This module only builds `main` and exports it (along with `subCommands` and `withCleanErrors`)
 // for `bin.ts` to run and for cli.test.ts to import — it must not call `runMain` or otherwise
 // have a side effect when imported, e.g. by cli.test.ts, which needs `subCommands` and

package/dist/cli.js.map

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

package/dist/commands/dev.js

@@ -29,6 +29,8 @@ import { CORS_ALLOWED_PORT_MAX, CORS_ALLOWED_PORT_MIN, isPortFree, parseLocalPor
 import { openInBrowser, NO_OPEN_ENV } from '../open-browser.js';
 import { waitForServer } from '../verify/wait-for-server.js';
 import { engineUpdateNotice } from '../project/engine-update.js';
+import { reportCommandEvent } from '../telemetry/report.js';
+import { currentCommand } from '../telemetry/command-context.js';
 /**
  * Tell the creator, once, if a newer engine exists — the one place where acting on it is cheap.
  *
@@ -207,6 +209,13 @@ export const devCommand = defineCommand({
         // the tabs, kept addressable for a second window or a bookmark.
         void waitForServer(gamePort, 30_000)
             .then(() => {
+            // The one command that reports twice. Every command reports when it ENDS (cli.ts), but
+            // a dev server ends by the terminal closing at least as often as by Ctrl-C, and only the
+            // latter reaches the wrapper — so the session is counted here, the moment it is actually
+            // serving. The duration is the time to get here from the command start: build included,
+            // which is most of it. Fire-and-forget: a slow api-server must never delay the banner.
+            const commandStartedAt = currentCommand()?.startedAt ?? Date.now();
+            void reportCommandEvent({ stage: 'started', ok: true, durationMs: Date.now() - commandStartedAt });
             // Opened rather than merely printed, because this command is now started as a BACKGROUND
             // task by the agent that scaffolds the project — so this banner goes to a log the creator
             // never reads. See open-browser.ts for why `login` makes the opposite call.