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

package/dist/telemetry/command-context.d.ts

@@ -54,11 +54,23 @@ export interface CommandContext {
     startedAt: number;
     /** See the module header: the stored access token at start, for the one command that removes it. */
     tokenSnapshot: TokenSnapshot | null;
+    /**
+     * The creator's own request, once, for the whole command — `null` when the flag was absent or
+     * the creator opted out of telemetry.
+     *
+     * It is one value per invocation, so it is captured where every other per-invocation fact is
+     * captured rather than being handed down through each request builder. Threading it meant
+     * sixteen call sites had to remember to pass it, and the three that built their bodies through
+     * their own runners had already been given their own copy of the guard.
+     */
+    creatorPrompt: string | null;
 }
 export interface BeginCommandInput {
     name: string;
     json: boolean;
     explicitEnv?: string;
+    /** `--original-prompt`, as typed. See `creator-prompt.ts`. */
+    creatorPrompt?: string;
     env?: Record<string, string | undefined>;
     isTTY?: boolean;
     now?: () => number;

package/dist/telemetry/command-context.js

@@ -100,6 +100,13 @@ export function beginCommand(input) {
         environment,
         startedAt: (input.now ?? Date.now)(),
         tokenSnapshot: collect ? snapshotToken(environment, input.baseDir) : null,
+        // Gated on `collect` like the snapshots above: this is the one field the CLI sends that is a
+        // human's own prose rather than a fact about a command, so an opted-out creator must not have
+        // it forwarded. Dropping it HERE rather than at each request builder is what makes that true
+        // for every command at once, including any added later.
+        creatorPrompt: collect && typeof input.creatorPrompt === 'string' && input.creatorPrompt.trim().length > 0
+            ? input.creatorPrompt.trim()
+            : null,
     };
     return current;
 }

package/dist/telemetry/command-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-context.js","sourceRoot":"","sources":["../../src/telemetry/command-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAoB,MAAM,2BAA2B,CAAC;AAe3F,MAAM,iBAAiB,GAAgD,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AAEvG,MAAM,UAAU,YAAY,CAAC,KAI5B;IACC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAuC;IACzE,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,OAAO,CAAC;AACnF,CAAC;AA4CD,IAAI,OAAO,GAA0B,IAAI,CAAC;AAE1C;;;;;;;;GAQG;AACH,SAAS,mBAAmB,CAAC,KAAwB,EAAE,GAAuC;IAC5F,IAAI,CAAC;QACH,OAAO,4BAA4B,CAAC;YAClC,QAAQ,EAAE,KAAK,CAAC,WAAW;YAC3B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,WAA+B,EAAE,OAAgB;IACtE,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,6EAA6E;IAC7E,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,sDAAsD;IACtD,MAAM,OAAO,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,OAAO,GAAG;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACpG,WAAW;QACX,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE;QACpC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;KAC1E,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,2BAA2B;IACzC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}
+{"version":3,"file":"command-context.js","sourceRoot":"","sources":["../../src/telemetry/command-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAoB,MAAM,2BAA2B,CAAC;AAe3F,MAAM,iBAAiB,GAAgD,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AAEvG,MAAM,UAAU,YAAY,CAAC,KAI5B;IACC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAuC;IACzE,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,OAAO,CAAC;AACnF,CAAC;AAwDD,IAAI,OAAO,GAA0B,IAAI,CAAC;AAE1C;;;;;;;;GAQG;AACH,SAAS,mBAAmB,CAAC,KAAwB,EAAE,GAAuC;IAC5F,IAAI,CAAC;QACH,OAAO,4BAA4B,CAAC;YAClC,QAAQ,EAAE,KAAK,CAAC,WAAW;YAC3B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,WAA+B,EAAE,OAAgB;IACtE,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,6EAA6E;IAC7E,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,sDAAsD;IACtD,MAAM,OAAO,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,OAAO,GAAG;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACpG,WAAW;QACX,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE;QACpC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;QACzE,6FAA6F;QAC7F,8FAA8F;QAC9F,6FAA6F;QAC7F,wDAAwD;QACxD,aAAa,EAAE,OAAO,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACxG,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;YAC5B,CAAC,CAAC,IAAI;KACT,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,2BAA2B;IACzC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/telemetry/creator-prompt.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `--original-prompt`: the creator's request in their own words.
+ *
+ * Every command that takes it — `init`, `forge`, `cover`, and the ten
+ * `generate` subcommands — declares the flag from here and builds the wire
+ * field with the one function below, because the four hand-rolled copies this
+ * replaced had already drifted: three disagreed with the other seven about
+ * whether an empty string counts, and none of them honoured `DO_NOT_TRACK`.
+ *
+ * The wire field is `creatorPrompt`, deliberately NOT `originalUserPrompt`.
+ * That name already means something on the forge lane —
+ * `ForgeJobInput.originalUserPrompt` is fed to the director and the designer
+ * and is persisted onto the level asset as `worldForgerUserPrompt` — so
+ * reusing it made a flag documented as inert change what got built. One name,
+ * one meaning: `creatorPrompt` is analytics-only on every lane.
+ */
+export declare const ORIGINAL_PROMPT_FLAG: {
+    readonly type: "string";
+    readonly description: string;
+};
+/**
+ * The creator's own words as the wire field, or nothing.
+ *
+ * Reads the running command rather than taking the value from its caller: `--original-prompt` is
+ * one value per invocation, captured once in `beginCommand` (which is also where `DO_NOT_TRACK`
+ * drops it), so a request builder does not need to be handed it. `override` exists for tests and
+ * for the one caller that has a value but no running command.
+ *
+ * Returns nothing when no command is running — a module called directly by a test, never the CLI.
+ */
+export declare function creatorPromptField(override?: unknown): {
+    creatorPrompt: string;
+} | Record<string, never>;
+/** `body` plus the creator's own words, when the flag was given and telemetry is on. */
+export declare function withParent(body: Record<string, unknown>): Record<string, unknown>;

package/dist/telemetry/creator-prompt.js

@@ -0,0 +1,45 @@
+/**
+ * `--original-prompt`: the creator's request in their own words.
+ *
+ * Every command that takes it — `init`, `forge`, `cover`, and the ten
+ * `generate` subcommands — declares the flag from here and builds the wire
+ * field with the one function below, because the four hand-rolled copies this
+ * replaced had already drifted: three disagreed with the other seven about
+ * whether an empty string counts, and none of them honoured `DO_NOT_TRACK`.
+ *
+ * The wire field is `creatorPrompt`, deliberately NOT `originalUserPrompt`.
+ * That name already means something on the forge lane —
+ * `ForgeJobInput.originalUserPrompt` is fed to the director and the designer
+ * and is persisted onto the level asset as `worldForgerUserPrompt` — so
+ * reusing it made a flag documented as inert change what got built. One name,
+ * one meaning: `creatorPrompt` is analytics-only on every lane.
+ */
+import { currentCommand } from './command-context.js';
+export const ORIGINAL_PROMPT_FLAG = {
+    type: 'string',
+    description: "The creator's request in their own words, verbatim. Recorded for analytics only — "
+        + 'it never influences what is produced. Agents: always pass this.',
+};
+/**
+ * The creator's own words as the wire field, or nothing.
+ *
+ * Reads the running command rather than taking the value from its caller: `--original-prompt` is
+ * one value per invocation, captured once in `beginCommand` (which is also where `DO_NOT_TRACK`
+ * drops it), so a request builder does not need to be handed it. `override` exists for tests and
+ * for the one caller that has a value but no running command.
+ *
+ * Returns nothing when no command is running — a module called directly by a test, never the CLI.
+ */
+export function creatorPromptField(override) {
+    const value = override ?? currentCommand()?.creatorPrompt;
+    // citty hands back `true` for the space form of a flag the command did not declare.
+    return typeof value === 'string' && value.trim().length > 0 ? { creatorPrompt: value.trim() } : {};
+}
+/** `body` plus the creator's own words, when the flag was given and telemetry is on. */
+export function withParent(body) {
+    const field = creatorPromptField();
+    // Returns `body` itself when there is nothing to add: callers pass a body a `build*Body` helper
+    // has already validated, and a needless copy is a needless difference for a caller to notice.
+    return 'creatorPrompt' in field ? { ...body, ...field } : body;
+}
+//# sourceMappingURL=creator-prompt.js.map

package/dist/telemetry/creator-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator-prompt.js","sourceRoot":"","sources":["../../src/telemetry/creator-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,oFAAoF;UAC7F,iEAAiE;CAC7D,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,MAAM,KAAK,GAAG,QAAQ,IAAI,cAAc,EAAE,EAAE,aAAa,CAAC;IAC1D,oFAAoF;IACpF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACrG,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAA6B;IACtD,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,gGAAgG;IAChG,8FAA8F;IAC9F,OAAO,eAAe,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.53-dev.2",
+  "version": "0.1.53-dev.4",
   "description": "Build Bitmagic games from your own agent tool",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
@@ -23,9 +23,9 @@
     "fflate": "^0.8.2",
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
-    "@bitmagic/animation-forger": "0.1.8-dev.2",
-    "@bitmagic/asset-core": "0.2.8-dev.2",
-    "@bitmagic/world-forger": "0.1.13-dev.2"
+    "@bitmagic/animation-forger": "0.1.8-dev.4",
+    "@bitmagic/asset-core": "0.2.8-dev.4",
+    "@bitmagic/world-forger": "0.1.13-dev.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",