gamealgo-cli 0.1.5 → 0.1.7

package/README.md

@@ -23,11 +23,14 @@ gamealgo docs agent-onboarding --host <admin-host>
 
 ```bash
 gamealgo login --host <admin-host> --admin-key <ga_admin_xxx>
+gamealgo integration get-plan --environment <domestic|overseas> --platform <ios|android|maker|rest> --out gamealgo-integration-plan.json
 gamealgo key list --json
 gamealgo key create --name <runtime-name> --json
 gamealgo key reveal --name <runtime-name> --json
 ```
 
+AI Agent 必须先执行 `integration get-plan`，并按返回的完整清单完成接入和人工验收。不要依赖只读某一份 README 后自行推断其他平台规则。
+
 凭据保存在当前游戏项目的 `.gamealgo/cli.json`，不同游戏互不覆盖。需要其他主题时使用：
 
 ```bash

package/cli/README.md

@@ -71,6 +71,21 @@ GAMEALGO_GAME_ADMIN_KEY=ga_admin_xxx
 gamealgo whoami
 ```
 
+## 接入计划
+
+登录后先让 CLI 根据开发者明确指定的环境和平台生成完整接入计划。CLI 不自动猜测环境或平台：
+
+```bash
+gamealgo integration get-plan \
+  --environment domestic \
+  --platform maker \
+  --out gamealgo-integration-plan.json
+```
+
+支持的环境是 `domestic`、`overseas`；支持的平台是 `ios`、`android`、`maker`、`rest`。计划包含正确地址、强制初始化规则、核心事件、广告/归因/实验条件项、验收标准和按需参考文档。
+
+计划同时包含接入完成后必须逐项执行的人工验收清单。不能只根据命令执行成功或生产报表有数据来判断接入已经完成。
+
 ## 最新文档
 
 AI Agent 可以通过 CLI 从 Admin Host 获取最新文档，不需要拉取本仓库：
@@ -161,15 +176,17 @@ gamealgo experiment strategy publish strategy.yaml --yes
 
 版本升级判断、Strategy 最低版本和托管实验覆盖率门槛的完整说明可通过 `gamealgo docs experiment-integration-versions` 获取。
 
-创建手动实验 Run：
+默认创建托管实验 Run。除非开发者具备专业的实验设计和统计判断能力，并且会持续人工管理实验，否则不要使用手动实验：
 
 ```yaml
 # run.yaml
-displayName: 广告频率第一轮
-type: manual
+displayName: 广告频率托管实验
 platform: ios
 objectiveTemplate: ltv_proxy@1
 baselineVariantId: control
+minWindowDays: 7
+maxWindowDays: 14
+maxVariantsPerRound: 2
 variants:
   - variantId: control
     weight: 1
@@ -191,10 +208,14 @@ variants:
 gamealgo experiment run create ad_frequency run.yaml --yes
 ```
 
+CLI 在未声明 `type` 时默认提交 `managed`。托管实验由平台管理轮次、在参考周期后判断是否需要延长，并在证据明确时完成后续轮次和推全；缺少 `minWindowDays` 或 `maxWindowDays` 会直接拒绝创建，不会静默套用周期。
+
 Run 不会继承 Strategy 的脚本。每个需要执行脚本的 variant 都必须显式配置 `script.versionId`；省略 `script` 明确表示该组是 config-only。即使多个 variant 使用同一份脚本，也要在每个 variant 上重复填写同一个不可变 `versionId`。
 
 如果要把当前默认参数也放进实验，需要显式配置 `variantId: default`。`default` 会快照 Strategy 当前默认参数，因此不能写 `config`；如果默认组需要执行脚本，也必须在 `default` 上显式写 `script.versionId`。否则默认参数不参与流量。所有有流量的实验组数量必须至少为 2。
 
+Run 创建后，用户不能修改 variant、权重或启停状态，否则同一用户可能换组，前后数据也无法按同一实验口径比较。托管实验只允许平台在轮次结束后按既定流程切换下一轮候选，用户不能干预流量。需要改变候选或分流时，先取消当前 Run，再创建新 Run。
+
 查看、评估和完成实验闭环：
 
 ```bash
@@ -207,7 +228,7 @@ gamealgo experiment run report xrun_xxxxxxxxxxxxxxxx
 gamealgo experiment run promote xrun_xxxxxxxxxxxxxxxx --variant slower_ads --message "采用低频广告组" --yes
 ```
 
-`baselineVariantId` 是本次评估的对照组，必须指向一个有流量的实验组。平台按小时更新“当前评估”；`report` 返回已生成的正式报告。`promote` 会把指定 variant 写回 Strategy 默认参数，并结束当前 Run。取消实验用：
+`baselineVariantId` 是本次评估的对照组，必须指向一个有流量的实验组。平台按小时更新“当前评估”；`report` 返回已生成的正式报告。`promote` 可在手动或托管 Run 仍处于运行中时提前人工推全，不要求平台已经给出正式 winner。它会立即结束 Run，把指定 variant 的 `config` / `script` 写回 Strategy 默认参数，并淘汰其他实验组；必须通过 `--message` 记录人工推全原因。取消实验用：
 
 `objectiveTemplate` 必须显式选择：
 
@@ -229,6 +250,22 @@ gamealgo experiment run objective xrun_xxxxxxxxxxxxxxxx \
 gamealgo experiment run cancel xrun_xxxxxxxxxxxxxxxx --message "实验停止" --yes
 ```
 
+### 高级用法：手动实验
+
+手动实验不会自动延长、形成最终结论或推全。只有开发者能够自行决定采集周期、判断统计证据并负责完成实验闭环时才使用。必须通过以下任一方式显式开启：
+
+```bash
+gamealgo experiment run create ad_frequency manual-run.yaml --manual --yes
+```
+
+或者在 Run 文件中明确填写：
+
+```yaml
+type: manual
+```
+
+手动 Run 不配置 `minWindowDays`、`maxWindowDays` 和 `startCondition`。其分流同样在整个 Run 内固定；需要调整分流时，取消当前 Run 后重新创建。
+
 回滚默认参数会创建一个新的参数版本，不会改写历史版本：
 
 ```bash
@@ -243,31 +280,13 @@ gamealgo experiment override list xrun_xxxxxxxxxxxxxxxx
 gamealgo experiment override delete xrun_xxxxxxxxxxxxxxxx --user user-1 --yes
 ```
 
-托管实验也是创建 `type: managed` 的 Run，平台会按轮次自动调整流量并最终推全胜出组：
+托管实验可以使用 `startCondition` 等待接入版本覆盖率和用户数达到门槛：
 
 ```yaml
-displayName: 广告频率托管实验
-type: managed
-platform: ios
-objectiveTemplate: ltv_proxy@1
-baselineVariantId: alpha
-minWindowDays: 7
-maxWindowDays: 14
-maxVariantsPerRound: 3
 # 可选：仅托管实验支持。最近 24 小时同时满足两个门槛后才开始首轮。
 startCondition:
   minCoverage: 0.8
   minUsers: 100
-variants:
-  - variantId: alpha
-    config: { firstAdLevel: 4, interval: 30 }
-    script: { versionId: sv_xxxxxxxxxxxxxxxx }
-  - variantId: bravo
-    config: { firstAdLevel: 5, interval: 30 }
-    script: { versionId: sv_xxxxxxxxxxxxxxxx }
-  - variantId: charlie
-    config: { firstAdLevel: 4, interval: 45 }
-    script: { versionId: sv_xxxxxxxxxxxxxxxx }
 ```
 
 `minCoverage` 表示指定平台最近 24 小时内，实验接入版本达到 Strategy `requiredIntegrationVersion` 的去重用户占比；`minUsers` 表示同一窗口内的非 Debug 去重用户数。两项可单独配置，同时配置时必须同时满足。等待期间 Strategy 继续下发默认参数，满足门槛后平台才生成首轮时间窗并开始分流。手动实验不支持 `startCondition`，托管实验不配置时仍会立即启动。`experiment run show` 返回 `startConditionSnapshot`，可查看当前用户数、覆盖率和最近检查时间。
@@ -307,6 +326,8 @@ gamealgo config publish configs/gameplay.json
 ## Report Pack
 
 ```bash
+gamealgo events list --days 30 --json
+gamealgo events apply gamealgo-events.yaml --json
 gamealgo report pull --out gamealgo-report-pack.json
 gamealgo report validate gamealgo-report-pack.json
 gamealgo report publish gamealgo-report-pack.json
@@ -314,7 +335,7 @@ gamealgo report publish gamealgo-report-pack.json
 
 每个游戏只有一个当前 Report Pack。`publish` 会整体覆盖上一次提交的配置，不需要传版本号；配置历史由游戏项目自己的 Git 管理。
 
-`report validate` 和 Admin 控制台保存时使用同一套服务端校验逻辑。
+`report validate` 和 `report publish` 使用同一套服务端元数据校验逻辑，只检查配置结构、事件词典与生成 SQL，不查询线上数据。凡是 Report Pack 顶层 `events` 引用的标准事件或自定义事件，其字段都必须已经登记、未废弃且字段类型一致；只引用标准看板和纯 marketing dataset 时，不需要重复登记平台内部字段。
 
 ## Adjust 投放花费
 
@@ -406,6 +427,59 @@ gamealgo report preview \
 
 ## 事件上报调试
 
+### 先查看并维护事件词典
+
+开始新增埋点或设计报表前，Agent 必须先查看当前游戏已经登记和实际上报的埋点：
+
+```bash
+gamealgo events list --days 30
+```
+
+列表会展示埋点描述、生效版本、创建时间、状态和字段定义，并根据近 30 天非调试数据给出事件级诊断：
+
+- 线上出现但词典未登记；
+- 词典已登记但近期未观测；
+- 埋点已废弃但线上仍在上报。
+
+诊断只检查埋点是否存在，不根据线上 payload 自动推断字段或字段类型。字段必须由开发 Agent 显式登记后再用于 Report Pack。标准事件同样可以维护词典并追加游戏业务字段，例如在 `level_end.payload` 中增加关卡、章节或玩法信息。
+
+Report Pack 的 `events.<eventType>.fields` 字段 ID 必须与词典字段名一致，`path` 只描述 payload 中的实际 JSON 路径。例如词典登记 `ad_type` 后，Report Pack 可以用 `"path": "$.adType"` 读取驼峰字段，但字段类型必须与词典一致。
+
+用 YAML 或 JSON 增量登记埋点：
+
+```yaml
+events:
+  level_end:
+    desc: 玩家结束关卡
+    effectiveVersion: 1.2.0
+    category: progression
+    source: standard
+    fields:
+      level_id:
+        type: string
+        required: true
+        desc: 关卡 ID
+        effectiveVersion: 1.2.0
+      chapter_id:
+        type: string
+        required: false
+        desc: 游戏追加的章节 ID
+```
+
+```bash
+gamealgo events apply gamealgo-events.yaml
+gamealgo events get level_end
+```
+
+规则：
+
+- 埋点必须填写 `desc`，`effectiveVersion` 可省略；创建时间由平台首次登记时生成。
+- 字段必须填写 `type` 和 `desc`，`effectiveVersion` 可省略；字段创建时间由平台生成。
+- 标准事件使用 `source: standard`，自定义事件使用 `source: custom`；两者都可以登记游戏追加的 payload 字段。
+- `apply` 只新增或更新文件中出现的埋点和字段，不会删除其他已有定义。
+- 不再使用的埋点需要显式废弃：`gamealgo events deprecate old_event --yes`。
+- 再次 `apply` 已废弃埋点会将其恢复为启用状态。
+
 接入 SDK 后，Agent 可以用 `events count` 检查某天事件是否已经进入原始事件表：
 
 ```bash

package/dist/gamealgo.js

@@ -74,6 +74,10 @@ async function main() {
             await handleEvents(client, args, global);
             return;
         }
+        if (command === "integration") {
+            await handleIntegration(client, args, global);
+            return;
+        }
         if (command === "marketing") {
             await handleMarketing(client, args, global);
             return;
@@ -387,7 +391,7 @@ async function handleExperimentRun(client, args, global) {
         const strategyKey = optionalString(flags.strategy || flags.key) || optionalString(args.shift());
         const filePath = optionalString(flags.file || flags.input) || optionalString(args.shift());
         if (!strategyKey || !filePath)
-            throw new Error("usage: gamealgo experiment run create <strategyKey> <run.yaml> --yes");
+            throw new Error("usage: gamealgo experiment run create <strategyKey> <run.yaml> [--manual] --yes");
         await requireYes(flags, global, "experiment run create");
         const body = await readObjectFile(filePath, "experiment run");
         if (!optionalString(body.displayName))
@@ -400,7 +404,24 @@ async function handleExperimentRun(client, args, global) {
             throw new Error("experiment run requires explicit baselineVariantId");
         }
         validateExperimentRunVariantScripts(body.variants);
-        const runType = optionalString(body.type) || "manual";
+        const fileRunType = optionalString(body.type);
+        const flagRunType = optionalString(flags.type);
+        const manualFlag = flags.manual === true;
+        if (fileRunType && fileRunType !== "managed" && fileRunType !== "manual") {
+            throw new Error("experiment run type must be managed or manual");
+        }
+        if (flagRunType && flagRunType !== "managed" && flagRunType !== "manual") {
+            throw new Error("--type must be managed or manual");
+        }
+        if (manualFlag && flagRunType && flagRunType !== "manual") {
+            throw new Error("--manual conflicts with --type managed");
+        }
+        const requestedRunType = manualFlag ? "manual" : flagRunType;
+        if (requestedRunType && fileRunType && requestedRunType !== fileRunType) {
+            throw new Error(`experiment run type conflict: file uses ${fileRunType}, CLI requests ${requestedRunType}`);
+        }
+        const runType = requestedRunType || fileRunType || "managed";
+        body.type = runType;
         if (runType !== "managed" && body.startCondition !== undefined) {
             throw new Error("experiment run startCondition is supported only when type is managed");
         }
@@ -414,6 +435,9 @@ async function handleExperimentRun(client, args, global) {
                 throw new Error("managed experiment run requires maxWindowDays between minWindowDays and 60");
             }
         }
+        else {
+            process.stderr.write("Warning: creating a manual experiment. The platform will not automatically extend, conclude, or promote it; use manual mode only when the developer will manage the experiment decision.\n");
+        }
         const result = await client.createExperimentV2Run(strategyKey, body);
         await printResult(result, global);
         if (!global.json)
@@ -540,23 +564,7 @@ async function handleExperimentRun(client, args, global) {
         await printResult(await client.cancelExperimentV2Run(runId, message), global);
         return;
     }
-    if (sub === "traffic") {
-        const flags = parseFlags(args);
-        const runId = optionalString(flags.run || flags["run-id"] || flags.id) || optionalString(args.shift());
-        const variantId = optionalString(flags.variant || flags["variant-id"]) || optionalString(args.shift());
-        if (!runId || !variantId)
-            throw new Error("usage: gamealgo experiment run traffic <runId> <variantId> [--weight n] [--status running|paused] --message <reason> --yes");
-        const message = requiredMessage(flags, "experiment run traffic");
-        await requireYes(flags, global, "experiment run traffic");
-        const body = { message };
-        if (flags.weight !== undefined)
-            body.weight = optionalNonNegativeInteger(flags.weight, "weight");
-        if (flags.status !== undefined)
-            body.status = optionalString(flags.status);
-        await printResult(await client.updateExperimentV2VariantTraffic(runId, variantId, body), global);
-        return;
-    }
-    throw new Error("usage: gamealgo experiment run <create|show|status|evaluate|report|objective|promote|cancel|traffic>");
+    throw new Error("usage: gamealgo experiment run <create|show|status|evaluate|report|objective|promote|cancel>");
 }
 function requiredMessage(flags, action) {
     const message = optionalString(flags.message);
@@ -828,9 +836,42 @@ async function handleReport(client, args, global) {
 }
 async function handleEvents(client, args, global) {
     const sub = args.shift();
-    if (sub !== "count")
-        throw new Error("usage: gamealgo events count [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--event-type level_end]");
     const flags = parseFlags(args);
+    if (sub === "list") {
+        if (args.length)
+            throw new Error("usage: gamealgo events list [--days 30] [--no-diagnostics]");
+        const days = Number(flags.days || 30);
+        if (!Number.isInteger(days) || days < 1 || days > 90)
+            throw new Error("--days must be an integer between 1 and 90");
+        await writeEventCatalogOutput(await client.listEventCatalog(days, flags["no-diagnostics"] !== true), flags, global);
+        return;
+    }
+    if (sub === "get") {
+        const eventType = args.shift();
+        if (!eventType || args.length)
+            throw new Error("usage: gamealgo events get <eventType>");
+        await writeEventCatalogOutput(await client.getEventCatalog(eventType), flags, global);
+        return;
+    }
+    if (sub === "apply") {
+        const filePath = args.shift();
+        if (!filePath || args.length)
+            throw new Error("usage: gamealgo events apply <events.yaml>");
+        const content = await readObjectFile(filePath, "event catalog");
+        await writeEventCatalogOutput(await client.applyEventCatalog(content), flags, global);
+        return;
+    }
+    if (sub === "deprecate") {
+        const eventType = args.shift();
+        if (!eventType || args.length)
+            throw new Error("usage: gamealgo events deprecate <eventType> [--yes]");
+        if (!flags.yes && !(await confirm(`Deprecate event ${eventType}?`)))
+            throw new Error("Cancelled");
+        await writeEventCatalogOutput(await client.deprecateEventCatalog(eventType), flags, global);
+        return;
+    }
+    if (sub !== "count")
+        throw new Error("usage: gamealgo events <list|get|apply|deprecate|count>");
     const timeoutMs = reportTimeoutMs(flags);
     const startedAt = Date.now();
     const stopProgress = startProgress("Querying event counts", timeoutMs);
@@ -855,6 +896,40 @@ async function handleEvents(client, args, global) {
     }
     await printResult(outputValue, global);
 }
+async function writeEventCatalogOutput(value, flags, global) {
+    if (flags.out) {
+        const filePath = String(flags.out);
+        const content = filePath.endsWith(".json") ? JSON.stringify(value, null, 2) + "\n" : YAML.stringify(value);
+        await writeTextFile(filePath, content);
+        await printResult({ ok: true, out: filePath }, global);
+        return;
+    }
+    await printResult(value, global);
+}
+async function handleIntegration(client, args, global) {
+    const sub = args.shift();
+    const flags = parseFlags(args);
+    if (args.length)
+        throw new Error("unexpected positional arguments for integration command");
+    const environment = integrationEnvironment(flags.environment);
+    const platform = integrationPlatform(flags.platform);
+    if (sub === "get-plan" || sub === "plan") {
+        const response = await client.getIntegrationPlan(environment, platform);
+        await writeIntegrationOutput(response, flags, global);
+        return;
+    }
+    throw new Error("usage: gamealgo integration get-plan --environment <domestic|overseas> --platform <ios|android|maker|rest>");
+}
+async function writeIntegrationOutput(value, flags, global) {
+    if (flags.out) {
+        if (typeof flags.out !== "string")
+            throw new Error("--out requires a file path");
+        await writeTextFile(flags.out, JSON.stringify(value, null, 2) + "\n");
+        await printResult({ ok: true, out: flags.out }, global);
+        return;
+    }
+    await printResult(value, global);
+}
 async function handleMarketing(client, args, global) {
     const provider = args.shift();
     if (provider !== "adjust")
@@ -1117,9 +1192,6 @@ class GameAlgoAdminClient {
     async deleteExperimentV2Override(runId, userId) {
         return await this.post(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/experiment-runs-v2/${encodeURIComponent(runId)}/overrides/delete`, { userId });
     }
-    async updateExperimentV2VariantTraffic(runId, variantId, body) {
-        return await this.patch(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/experiment-runs-v2/${encodeURIComponent(runId)}/variants/${encodeURIComponent(variantId)}/traffic`, body);
-    }
     async listConfigFiles() {
         return await this.get(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/config-files`);
     }
@@ -1167,6 +1239,23 @@ class GameAlgoAdminClient {
     async countEvents(body, options = {}) {
         return await this.post(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/events/count`, body, options);
     }
+    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()}`);
+    }
+    async getEventCatalog(eventType) {
+        return await this.get(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/events/catalog/${encodeURIComponent(eventType)}`);
+    }
+    async applyEventCatalog(content) {
+        return await this.put(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/events/catalog`, content);
+    }
+    async deprecateEventCatalog(eventType) {
+        return await this.post(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/events/catalog/${encodeURIComponent(eventType)}/deprecate`, {});
+    }
+    async getIntegrationPlan(environment, platform) {
+        const params = new URLSearchParams({ environment, platform });
+        return await this.get(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/integration/plan?${params.toString()}`);
+    }
     async getAdjustMarketing() {
         return await this.get(`/admin/v1/games/${encodeURIComponent(await this.gameId())}/marketing/adjust`);
     }
@@ -1679,6 +1768,18 @@ async function confirm(question) {
 function normalizeHost(value) {
     return value.trim().replace(/\/+$/, "");
 }
+function integrationEnvironment(value) {
+    const environment = optionalString(value);
+    if (environment === "domestic" || environment === "overseas")
+        return environment;
+    throw new Error("--environment must be domestic or overseas");
+}
+function integrationPlatform(value) {
+    const platform = optionalString(value);
+    if (platform === "ios" || platform === "android" || platform === "maker" || platform === "rest")
+        return platform;
+    throw new Error("--platform must be ios, android, maker, or rest");
+}
 function optionalString(value) {
     return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
@@ -1718,6 +1819,8 @@ Usage:
   gamealgo docs experiment-integration-versions --open
   gamealgo docs --host <admin-url>
 
+  gamealgo integration get-plan --environment domestic --platform maker --out gamealgo-integration-plan.json
+
   gamealgo experiment strategies
   gamealgo experiment strategies --include-archived
   gamealgo experiment integration-version latest
@@ -1730,7 +1833,7 @@ Usage:
   gamealgo experiment strategy default ad_frequency strategy.yaml --yes
   gamealgo experiment strategy archive ad_frequency --yes
   gamealgo experiment strategy rollback ad_frequency --version-id xv_xxxxxxxxxxxxxxxx --message "回滚参数" --yes
-  gamealgo experiment run create ad_frequency run.yaml --yes
+  gamealgo experiment run create ad_frequency run.yaml [--manual] --yes
   gamealgo experiment run show xrun_xxxxxxxxxxxxxxxx
   gamealgo experiment run status xrun_xxxxxxxxxxxxxxxx
   gamealgo experiment run evaluate xrun_xxxxxxxxxxxxxxxx --from 2026-07-01 --to 2026-07-07 --yes
@@ -1738,7 +1841,6 @@ Usage:
   gamealgo experiment run objective xrun_xxxxxxxxxxxxxxxx --objective active_days@1 --message "改为关注活跃天数" --yes
   gamealgo experiment run promote xrun_xxxxxxxxxxxxxxxx --variant bravo --message "采用胜出组" --yes
   gamealgo experiment run cancel xrun_xxxxxxxxxxxxxxxx --message "停止实验" --yes
-  gamealgo experiment run traffic xrun_xxxxxxxxxxxxxxxx bravo --weight 0 --status paused --message "暂停异常组" --yes
   gamealgo experiment override set xrun_xxxxxxxxxxxxxxxx --user user-1 --variant bravo --yes
   gamealgo experiment override list xrun_xxxxxxxxxxxxxxxx
 
@@ -1767,6 +1869,10 @@ Usage:
 
   gamealgo events count --from 2026-06-23 --to 2026-06-23
   gamealgo events count --from 2026-06-23 --to 2026-06-23 --event-type level_end
+  gamealgo events list --days 30
+  gamealgo events get level_start
+  gamealgo events apply gamealgo-events.yaml
+  gamealgo events deprecate old_event --yes
 
   gamealgo marketing adjust get
   gamealgo marketing adjust configure --api-token <token> --app-token <app-token> --platform ios --currency USD

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gamealgo-cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "GameAlgo command-line client for AI agents and game developers",
   "type": "module",
   "bin": {