@kradle/cli 0.2.0 → 0.2.2

package/README.md

@@ -1,3 +1,5 @@
+<!-- This file is for human consumption. If you are an LLM or any AI Agent, make sure to read static/ai_docs/LLM_CLI_REFERENCE.md for an exhaustive explanation of this package. -->
+
 # Kradle CLI
 
 Kradle's CLI for managing Minecraft challenges, experiments, agents, and more!
@@ -8,6 +10,7 @@ Kradle's CLI for managing Minecraft challenges, experiments, agents, and more!
 * [Challenge](#challenge-commands)
 * [Experiments](#experiment-commands)
 * [Agents](#agent-commands)
+* [AI Docs](#ai-docs-commands)
 * [Publishing a New Version](#publishing-a-new-version)
 * [Development](#development)
 * [Architecture](#architecture)
@@ -127,16 +130,6 @@ kradle challenge run <challenge-name>
 kradle challenge run <challenge-name> --studio  # Run in local studio environment
 ```
 
-### Multi-Upload
-
-Interactively select and upload multiple challenges:
-
-```bash
-kradle challenge multi-upload
-```
-
-Provides an interactive UI to select multiple challenges and uploads them in parallel.
-
 ## Experiment Commands
 
 Experiments allow you to run batches of challenge runs with different agents and configurations, then analyze the results. This is useful for benchmarking agents, testing challenge difficulty, or gathering statistics across many runs.
@@ -172,9 +165,10 @@ This creates `experiments/<name>/config.ts` with a template that you can customi
 Execute or resume an experiment:
 
 ```bash
-kradle experiment run <name>                  # Resume current version or create first one
-kradle experiment run <name> --new-version            # Start a new version
-kradle experiment run <name> --max-concurrent 10  # Control parallelism (default: 5)
+kradle experiment run <name>                       # Resume current version or create first one
+kradle experiment run <name> --new-version         # Start a new version
+kradle experiment run <name> --max-concurrent 10   # Control parallelism (default: 5)
+kradle experiment run <name> --download-recordings # Auto-download recordings as runs complete
 ```
 
 The run command:
@@ -184,6 +178,20 @@ The run command:
 4. Saves progress periodically (allows resuming if interrupted)
 5. Opens Metabase dashboard with results when complete
 
+### Download Recordings
+
+Download gameplay recordings from completed experiment runs:
+
+```bash
+kradle experiment recordings <name>                  # Interactive selection of run and participant
+kradle experiment recordings <name> <run-id>         # Download specific run
+kradle experiment recordings <name> --all            # Download all runs and participants
+kradle experiment recordings <name> --version 2      # Download from specific version
+kradle experiment recordings <name> <run-id> --all   # Download all participants for a run
+```
+
+Recordings are saved to `experiments/<name>/versions/<version>/recordings/<run-id>/`.
+
 ### List Experiments
 
 List all local experiments:
@@ -202,6 +210,26 @@ List all agents registered in the system:
 kradle agent list
 ```
 
+## AI Docs Commands
+
+Output LLM-focused documentation to stdout. These commands are designed to provide AI agents with comprehensive reference material about the Kradle CLI and API.
+
+### CLI Reference
+
+Output the CLI reference documentation:
+
+```bash
+kradle ai-docs cli
+```
+
+### API Reference
+
+Output the API reference documentation for the `@kradle/challenges` package:
+
+```bash
+kradle ai-docs api
+```
+
 ## Publishing a New Version
 
 The CLI uses GitHub Actions for automated releases. To publish a new version:
@@ -303,6 +331,7 @@ kradle-cli/
 ├── src/
 │   ├── commands/             # CLI commands
 │   │   ├── agent/            # Agent commands
+│   │   ├── ai-docs/          # AI documentation commands
 │   │   ├── challenge/        # Challenge management commands
 │   │   └── experiment/       # Experiment commands
 │   └── lib/                  # Core libraries

package/dist/commands/ai-docs/api.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "@oclif/core";
+export default class Api extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/ai-docs/api.js

@@ -0,0 +1,13 @@
+import fs from "node:fs/promises";
+import { Command } from "@oclif/core";
+import { getStaticResourcePath } from "../../lib/utils.js";
+export default class Api extends Command {
+    static description = "Output the Kradle API reference documentation for LLMs";
+    static examples = ["<%= config.bin %> <%= command.id %>"];
+    async run() {
+        await this.parse(Api);
+        const docPath = getStaticResourcePath("ai_docs/LLM_API_REFERENCE.md");
+        const content = await fs.readFile(docPath, "utf-8");
+        this.log(content);
+    }
+}

package/dist/commands/ai-docs/cli.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "@oclif/core";
+export default class Cli extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/ai-docs/cli.js

@@ -0,0 +1,13 @@
+import fs from "node:fs/promises";
+import { Command } from "@oclif/core";
+import { getStaticResourcePath } from "../../lib/utils.js";
+export default class Cli extends Command {
+    static description = "Output the Kradle CLI reference documentation for LLMs";
+    static examples = ["<%= config.bin %> <%= command.id %>"];
+    async run() {
+        await this.parse(Cli);
+        const docPath = getStaticResourcePath("ai_docs/LLM_CLI_REFERENCE.md");
+        const content = await fs.readFile(docPath, "utf-8");
+        this.log(content);
+    }
+}

package/dist/commands/init.js

@@ -104,13 +104,15 @@ export default class Init extends Command {
                         const templateDir = getStaticResourcePath("project_template");
                         const templateFiles = await readDirSorted(templateDir);
                         for (const file of templateFiles) {
-                            if (file.name.endsWith(".env")) {
-                                // We ignore .env as it will be created later
+                            // We ignore .env as it will be created later
+                            if (file.name.endsWith(".env") || file.isDirectory()) {
                                 continue;
                             }
                             const srcPath = path.join(file.parentPath, file.name);
                             const srcRelativePath = path.relative(templateDir, srcPath);
                             const destPath = path.join(targetDir, srcRelativePath);
+                            // Ensure the destination directory exists before copying the file
+                            await fs.mkdir(path.dirname(destPath), { recursive: true });
                             await fs.copyFile(srcPath, destPath);
                         }
                         // Create .env file based on the environment

package/dist/lib/experiment/runner.js

@@ -44,6 +44,7 @@ export class Runner {
                 const state = this.states[entry.index];
                 state.status = entry.status;
                 state.runId = entry.runId;
+                state.participantIds = entry.participantIds;
                 state.startTime = entry.startTime;
                 if (entry.status === "completed" || entry.status === "finished" || entry.status === "game_over") {
                     this.completedRuns.add(entry.index);

package/oclif.manifest.json

@@ -86,6 +86,54 @@
         "list.js"
       ]
     },
+    "ai-docs:api": {
+      "aliases": [],
+      "args": {},
+      "description": "Output the Kradle API reference documentation for LLMs",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai-docs:api",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai-docs",
+        "api.js"
+      ]
+    },
+    "ai-docs:cli": {
+      "aliases": [],
+      "args": {},
+      "description": "Output the Kradle CLI reference documentation for LLMs",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai-docs:cli",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai-docs",
+        "cli.js"
+      ]
+    },
     "challenge:build": {
       "aliases": [],
       "args": {
@@ -760,5 +808,5 @@
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.2.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kradle/cli",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"description": "Kradle's CLI. Manage challenges, experiments, agents and more!",
 	"keywords": [
 		"cli"
@@ -81,6 +81,9 @@
 			},
 			"experiment": {
 				"description": "Manage and run experiments"
+			},
+			"ai-docs": {
+				"description": "Output LLM reference documentation"
 			}
 		}
 	}