gamealgo-cli 0.4.3 → 0.4.4

package/README.md

@@ -18,10 +18,13 @@ Run login from the game repository that should own the credentials:
 ```bash
 gamealgo login --host <admin-url> --admin-key <ga_admin_key>
 gamealgo whoami
+gamealgo quota --json
 ```
 
 The login is stored in the current project's `.gamealgo/cli.json`, which is automatically ignored by Git. Authenticated commands require this project-scoped login and verify its `gameId` against the Server before continuing, preventing credentials from another game from being reused accidentally.
 
+`gamealgo quota --json` returns the current effective plan, the per-user daily ordinary-event limit, UTC reset time, detail-query and retention windows, exempt revenue events, and today's actual quota-filtered count. Check it before adding or increasing telemetry.
+
 ## Current help and documentation
 
 ```bash

package/dist/client.js

@@ -201,6 +201,9 @@ export class GameAlgoAdminClient {
     async countEvents(body, options = {}) {
         return await this.post(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/events/count`, body, options);
     }
+    async getGameQuota() {
+        return await this.get(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/quota`);
+    }
     async listEventCatalog(days = 30, diagnostics = true) {
         const params = new URLSearchParams({ days: String(days), diagnostics: diagnostics ? "1" : "0" });
         return await this.get(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/events/catalog?${params.toString()}`);

package/dist/commands/dynamic-config.js

@@ -49,6 +49,12 @@ export async function handleDynamicConfig(client, args, global) {
         const key = optionalString(definition.key);
         if (!key)
             throw new Error("dynamic config definition.key is required");
+        if (definition.reportPack !== undefined) {
+            throw new Error("dynamic config definition.reportPack is no longer supported; inputs must reference the current Report Pack v2");
+        }
+        if (!Array.isArray(definition.inputs) || definition.inputs.length === 0) {
+            throw new Error("dynamic config definition.inputs must be a non-empty array");
+        }
         const body = { ...definition };
         delete body.key;
         const scriptPath = optionalString(flags.script);

package/dist/commands/quota.js

@@ -0,0 +1,16 @@
+import { parseFlags } from "../args.js";
+import { printResult } from "../output.js";
+import { writeTextFile } from "../resources.js";
+export async function handleQuota(client, args, global) {
+    const flags = parseFlags(args);
+    if (args.length)
+        throw new Error("usage: gamealgo quota [--out quota.json]");
+    const value = await client.getGameQuota();
+    if (flags.out) {
+        const filePath = String(flags.out);
+        await writeTextFile(filePath, JSON.stringify(value, null, 2) + "\n");
+        await printResult({ ok: true, out: filePath }, global);
+        return;
+    }
+    await printResult(value, global);
+}

package/dist/main.js

@@ -7,6 +7,7 @@ import { handleIntegration } from "./commands/integration.js";
 import { handleGameKey } from "./commands/keys.js";
 import { handleMarketing } from "./commands/marketing.js";
 import { handleOptimize } from "./commands/optimize.js";
+import { handleQuota } from "./commands/quota.js";
 import { handleReport } from "./commands/report.js";
 import { handleFileResource } from "./commands/resources.js";
 import { handleSkill } from "./commands/skill.js";
@@ -95,6 +96,10 @@ export async function main() {
             await handleEvents(client, args, global);
             return;
         }
+        if (command === "quota") {
+            await handleQuota(client, args, global);
+            return;
+        }
         if (command === "integration") {
             await handleIntegration(client, args, global);
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gamealgo-cli",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "GameAlgo command-line client for AI agents and game developers",
   "repository": {
     "type": "git",

package/skills/gamealgo/SKILL.md

@@ -114,11 +114,16 @@ After approval, update the actual emission call sites and their normal-flow test
 
 ## Bound Custom Event Volume
 
-Before adding or changing a custom event, prefer a protocol-standard event or an existing custom event with the same meaning. Keep the event type stable and put variable values in payload fields; never generate event types from item IDs, levels, timestamps, user input, or other runtime values.
+Before adding or changing any event, run `gamealgo quota --json` and `gamealgo events list --days 30 --json`. Treat the returned effective plan and `ordinaryEvents.dailyLimitPerUser` as a hard per-game, per-user, per-UTC-day budget shared by standard and custom ordinary events. Estimate the user's total ordinary event volume across all existing and proposed call sites, leave headroom for normal retries and future events, and reduce or aggregate high-frequency telemetry before implementation when the bound can reach the current limit.
+
+Prefer a protocol-standard event or an existing custom event with the same meaning. Keep the event type stable and put variable values in payload fields; never generate event types from item IDs, levels, timestamps, user input, or other runtime values.
 
 Inspect every call site for render/update loops, timers, polling, transport retries, duplicate lifecycle callbacks, and re-entrant listeners. State the trigger boundary and estimate the maximum calls per user, session, context, and active user-day. Use the game's active-user estimate to describe the expected daily volume when it is available.
 
 - Standard SDK semantic events are governed by their protocol semantics. Do not disguise custom telemetry as a standard event to bypass safeguards.
+- `purchase` and `ad_view` are exempt only when they represent their real protocol semantics and pass their strict validation. Every other accepted event consumes the ordinary daily budget, including standard events and repeated `eventId` submissions.
+- `quota.today.filteredEvents` is the number of ordinary events actually rejected by quota enforcement today; `shadowWouldRejectEvents` is observation-only and must not be reported as data loss. If actual filtering is nonzero, identify and fix the highest-frequency emission paths before proposing more events.
+- The quota resets at UTC midnight, not the player's local midnight. If quota information is unavailable, do not assume Free, Enterprise, or unlimited capacity; report the missing prerequisite and avoid publishing a higher-volume telemetry design.
 - The SDK limits custom events to 1,000 occurrences per `context × eventType`, 5,000 total occurrences per context, and 100 distinct custom event types per context.
 - A custom event with an unbounded trigger or an expected rate above 1,000 calls per context requires explicit developer review before implementation. Explain the expected volume, storage and processing impact, and the guard that makes the trigger bounded.
 - Never add client-side retries around `track`, rename an event after rejection, remove its custom-event prefix, declare it standard, raise a safety limit, or call a lower-level transport to bypass a quota.
@@ -128,14 +133,15 @@ Before delivery, report the estimated bound, normal-flow tests, the limiting loo
 
 ## Treat Dynamic Config As A Production Publisher
 
-A dynamic config pipeline is Server-side automation that turns aggregated Report Pack inputs into a live config file. It does not authorize SDK changes, detailed production-data downloads, or live publication by itself.
+A dynamic config pipeline is Server-side automation that turns current Report Pack v2 ordinary Dataset snapshots into a live config file. It does not authorize SDK changes, detailed production-data downloads, or live publication by itself.
 
 - Define bounded aggregate inputs with Report Pack syntax. Keep filters, joins, aggregation, and data reduction in the managed query rather than passing event detail to JavaScript.
 - Keep transforms synchronous and deterministic. They may use only the supplied datasets, previous output, and scheduled metadata; never depend on network, filesystem, environment variables, wall-clock APIs, randomness, async functions, or Promise output.
 - The output file name and content type belong to the reviewed pipeline definition. The script may return only file content and JSON diagnostics.
 - Before publishing or materially updating an active pipeline, show the target game, input reports and windows, complete script diff, output file and content type, schedule, expected behavior, failure behavior, and user-facing or operational risks. Obtain explicit approval for that exact publication unless the user already gave it after seeing those details.
 - Prefer a disabled pipeline or a local script test while details are still under discussion. After an authorized publish, trigger one run, inspect the persisted run result and generated file version, and confirm that an unchanged second run is hash-deduplicated before treating the automation as verified.
-- Do not raise the 1 MiB script/input/output caps, the 5,000-row per-dataset cap, the 5-second execution cap, or the minimum 60-minute schedule to bypass a failing design. Reduce data in the Report Pack or simplify the transform.
+- Do not embed a Report Pack, use Advanced Query/raw SQL, or trigger warehouse queries from Dynamic Config. Inputs reuse v2 View aggregation over already-materialized ordinary Datasets and pin the Dataset fingerprint at publish time.
+- Do not raise the 1 MiB script/input/output caps, the 100-row per-input cap, the 500-row total cap, the 5-second execution cap, or the minimum daily schedule to bypass a failing design. Reduce the ordinary Dataset/View result or simplify the transform.
 
 Use `gamealgo dynamic-config list|get|publish|run|runs` for lifecycle operations. Dynamic config output continues through the ordinary SDK config-file delivery mechanism, so do not change client SDK code merely to consume a generated file that already uses the existing config API.