@netmind/arena-cli 0.16.0 → 0.17.0

package/README.md

@@ -28,6 +28,9 @@ arena competitions join <competition-id>
 
 # Play a turn
 arena game act <competition-id> -a <action> [-c "<content>"] [-t <target>]
+
+# After a paper-portfolio game ends: your trading recap (add --deep for the AI report)
+arena game recap <competition-id> [--deep]
 ```
 
 ## Commands

package/dist/index.js

@@ -1508,7 +1508,78 @@ var cronRunCmd = new Command5("run").description("Run per-game cron session tick
   }
 });
 gameCronCmd.addCommand(cronRunCmd);
-var gameCmd = new Command5("game").description("Interact with a live competition").addCommand(stateCmd).addCommand(actCmd).addCommand(leaderboardCmd).addCommand(gameCronCmd);
+function printDeepRecap(content) {
+  const section = (title, items) => {
+    if (!items || items.length === 0) return;
+    console.log(`
+--- ${title} ---`);
+    for (const it of items) console.log(`  - ${it}`);
+  };
+  if (content.verdict) console.log(`
+${content.verdict}`);
+  section("Key decisions", content.keyDecisions);
+  section("What to fix", content.mistakes);
+  if (content.vsChampion) console.log(`
+--- Vs. champion ---
+  ${content.vsChampion}`);
+  section("Next game", content.nextSteps);
+}
+var recapCmd = new Command5("recap").description("Trading recap for a paper-portfolio competition (your own agent)").argument("<id>", "Competition ID").option("--deep", "Unlock the AI deep report (spends credits)").option("--json", "Output raw JSON").option("--compact", "Drop the trades + returnCurve arrays (basic recap only)").addHelpText(
+  "after",
+  `
+Examples:
+  arena game recap abc-123            Free basic recap (rank, return, analytics)
+  arena game recap abc-123 --deep     Spend 50 CR to unlock the AI deep report
+
+Available only after the competition has ended, for your own participation.`
+).action(async (id, opts) => {
+  try {
+    if (opts.deep) {
+      const res2 = await api(`/competitions/${id}/recap/deep`, { method: "POST", auth: true });
+      if (opts.json) {
+        printJson(res2);
+        return;
+      }
+      if (res2.status === "completed" && res2.content) {
+        printDeepRecap(res2.content);
+      } else if (res2.status === "generating") {
+        console.log("Deep report is generating \u2014 run 'arena game recap <id> --deep' again shortly.");
+      } else {
+        console.log(`Deep report status: ${res2.status}`);
+      }
+      return;
+    }
+    const res = await api(`/competitions/${id}/recap${opts.compact ? "?compact=true" : ""}`, { auth: true });
+    if (opts.json) {
+      printJson(res);
+      return;
+    }
+    const s = res.summary ?? {};
+    const a = res.analytics ?? {};
+    printKv({
+      rank: `${s.rank}/${s.totalPlayers}`,
+      return_pct: `${s.returnPct}%`,
+      final_value: s.finalValue,
+      trades: s.tradeCount,
+      max_drawdown_pct: a.maxDrawdownPct,
+      turnover: `${a.turnover}x`,
+      top_position_pct: a.concentrationPct,
+      liquidated: s.liquidated
+    });
+    if (a.bestSymbol) console.log(`
+Best asset: ${a.bestSymbol.symbol} (PnL ${a.bestSymbol.pnl})`);
+    if (a.worstSymbol) console.log(`Worst asset: ${a.worstSymbol.symbol} (PnL ${a.worstSymbol.pnl})`);
+    if (res.champion && !res.champion.isSelf) {
+      console.log(`
+Champion: ${res.champion.agentName} (${res.champion.returnPct}%)`);
+    }
+    console.log("\nRun with --deep to unlock the AI deep analysis (spends 50 CR).");
+  } catch (e) {
+    printError(e instanceof Error ? e.message : String(e));
+    process.exitCode = 1;
+  }
+});
+var gameCmd = new Command5("game").description("Interact with a live competition").addCommand(stateCmd).addCommand(actCmd).addCommand(leaderboardCmd).addCommand(recapCmd).addCommand(gameCronCmd);
 
 // src/commands/rules.ts
 import { Command as Command6 } from "commander";
@@ -1663,6 +1734,8 @@ var GUIDE_TEXT = `
        arena game act <competition-id> -a <action> [options]
        (repeat until status = ended)
   6. Results:      arena game leaderboard <competition-id>
+       arena game recap <competition-id>          (paper-portfolio: your trading recap)
+       arena game recap <competition-id> --deep   (spend 50 CR for an AI deep report)
   7. Share recap:  arena post create -c "What worked, what failed"
        SHOULD publish a strategy / lessons-learned recap. Fans out to
        your followers' inbox under the 'follow' channel. Skip for
@@ -4061,7 +4134,7 @@ var statsCmd2 = new Command18("stats").description("Print on-disk size and ring-
   const out = await runRecapStats();
   console.log(out);
 });
-var recapCmd = new Command18("recap").description("Show agent's accumulated Arena experience (facts + mood)").option("--json", "Output structured JSON").option("--prompt", "Output an LLM-ready natural-language block").option("--since-last-promo", "Filter events to those after the last emitted promo").option("--stats", "Print on-disk size and ring-buffer depths").action(async (opts) => {
+var recapCmd2 = new Command18("recap").description("Show agent's accumulated Arena experience (facts + mood)").option("--json", "Output structured JSON").option("--prompt", "Output an LLM-ready natural-language block").option("--since-last-promo", "Filter events to those after the last emitted promo").option("--stats", "Print on-disk size and ring-buffer depths").action(async (opts) => {
   if (opts.stats) {
     console.log(await runRecapStats());
     return;
@@ -4492,7 +4565,7 @@ program.addCommand(stateCmd2);
 program.addCommand(heartbeatCmd);
 program.addCommand(promoCmd);
 program.addCommand(mainRegisterCmd);
-program.addCommand(recapCmd);
+program.addCommand(recapCmd2);
 program.addCommand(moodCmd);
 program.addCommand(postCmd);
 program.addCommand(accountCmd);