@kradle/cli 0.2.4 → 0.2.6

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": {
@@ -357,6 +405,75 @@
         "list.js"
       ]
     },
+    "challenge:pull": {
+      "aliases": [],
+      "args": {
+        "challengeSlug": {
+          "description": "Challenge slug to pull (interactive selection if omitted)",
+          "name": "challengeSlug",
+          "required": false
+        }
+      },
+      "description": "Pull a challenge from the cloud and extract source files locally",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> my-challenge",
+        "<%= config.bin %> <%= command.id %> username:my-challenge",
+        "<%= config.bin %> <%= command.id %> my-challenge --yes"
+      ],
+      "flags": {
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "api-key": {
+          "description": "Kradle API key",
+          "env": "KRADLE_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-url": {
+          "description": "Kradle Web API URL",
+          "env": "KRADLE_API_URL",
+          "name": "api-url",
+          "required": true,
+          "default": "https://api.kradle.ai/v0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "challenges-path": {
+          "description": "Absolute path to the challenges directory",
+          "env": "KRADLE_CHALLENGES_PATH",
+          "name": "challenges-path",
+          "default": "~/Documents/kradle-studio/challenges",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "challenge:pull",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "challenge",
+        "pull.js"
+      ]
+    },
     "challenge:run": {
       "aliases": [],
       "args": {
@@ -518,54 +635,6 @@
         "watch.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"
-      ]
-    },
     "experiment:create": {
       "aliases": [],
       "args": {
@@ -798,7 +867,277 @@
         "experiment",
         "run.js"
       ]
+    },
+    "world:delete": {
+      "aliases": [],
+      "args": {
+        "worldSlug": {
+          "description": "World slug to delete",
+          "name": "worldSlug",
+          "required": true
+        }
+      },
+      "description": "Delete a world locally, from the cloud, or both",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my-world",
+        "<%= config.bin %> <%= command.id %> my-world --yes"
+      ],
+      "flags": {
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "api-key": {
+          "description": "Kradle API key",
+          "env": "KRADLE_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-url": {
+          "description": "Kradle Web API URL",
+          "env": "KRADLE_API_URL",
+          "name": "api-url",
+          "required": true,
+          "default": "https://api.kradle.ai/v0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "world:delete",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "world",
+        "delete.js"
+      ]
+    },
+    "world:import": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to the Minecraft world folder",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Import a Minecraft world folder and package it as a tarball",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> ~/minecraft/saves/MyWorld",
+        "<%= config.bin %> <%= command.id %> ~/minecraft/saves/MyWorld --as my-world"
+      ],
+      "flags": {
+        "as": {
+          "description": "Slug for the world (defaults to folder name converted to slug)",
+          "name": "as",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "Kradle API key",
+          "env": "KRADLE_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-url": {
+          "description": "Kradle Web API URL",
+          "env": "KRADLE_API_URL",
+          "name": "api-url",
+          "required": true,
+          "default": "https://api.kradle.ai/v0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "world:import",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "world",
+        "import.js"
+      ]
+    },
+    "world:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all worlds (local and cloud)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "Kradle API key",
+          "env": "KRADLE_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-url": {
+          "description": "Kradle Web API URL",
+          "env": "KRADLE_API_URL",
+          "name": "api-url",
+          "required": true,
+          "default": "https://api.kradle.ai/v0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "world:list",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "world",
+        "list.js"
+      ]
+    },
+    "world:pull": {
+      "aliases": [],
+      "args": {
+        "worldSlug": {
+          "description": "World slug to pull (interactive selection if omitted)",
+          "name": "worldSlug",
+          "required": false
+        }
+      },
+      "description": "Download a world from the cloud",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> my-world",
+        "<%= config.bin %> <%= command.id %> username:my-world",
+        "<%= config.bin %> <%= command.id %> my-world --yes"
+      ],
+      "flags": {
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "api-key": {
+          "description": "Kradle API key",
+          "env": "KRADLE_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-url": {
+          "description": "Kradle Web API URL",
+          "env": "KRADLE_API_URL",
+          "name": "api-url",
+          "required": true,
+          "default": "https://api.kradle.ai/v0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "world:pull",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "world",
+        "pull.js"
+      ]
+    },
+    "world:push": {
+      "aliases": [],
+      "args": {
+        "worldSlug": {
+          "description": "World slug to push",
+          "name": "worldSlug",
+          "required": true
+        }
+      },
+      "description": "Upload a world (config + tarball) to the cloud",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my-world"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "Kradle API key",
+          "env": "KRADLE_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-url": {
+          "description": "Kradle Web API URL",
+          "env": "KRADLE_API_URL",
+          "name": "api-url",
+          "required": true,
+          "default": "https://api.kradle.ai/v0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "world:push",
+      "pluginAlias": "@kradle/cli",
+      "pluginName": "@kradle/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "world",
+        "push.js"
+      ]
     }
   },
-  "version": "0.2.4"
+  "version": "0.2.6"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kradle/cli",
-	"version": "0.2.4",
+	"version": "0.2.6",
 	"description": "Kradle's CLI. Manage challenges, experiments, agents and more!",
 	"keywords": [
 		"cli"
@@ -84,6 +84,9 @@
 			},
 			"ai-docs": {
 				"description": "Output LLM reference documentation"
+			},
+			"world": {
+				"description": "Manage worlds"
 			}
 		}
 	}

package/static/ai_docs/LLM_CLI_REFERENCE.md

@@ -223,6 +223,61 @@ kradle challenge list
 
 ---
 
+### `kradle challenge pull [name]`
+
+Downloads a challenge from the cloud and extracts source files locally.
+
+**Usage:**
+```bash
+kradle challenge pull
+kradle challenge pull <challenge-name>
+kradle challenge pull <team-name>:<challenge-name>
+kradle challenge pull <challenge-name> --yes
+```
+
+**Arguments:**
+| Argument | Description | Required |
+|----------|-------------|----------|
+| `challenge-name` | Challenge slug to pull. Can be a short slug (e.g., `my-challenge`) or include a team/user namespace (e.g., `team-name:my-challenge`). If omitted, shows interactive selection. | No |
+
+**Flags:**
+| Flag | Short | Description | Default |
+|------|-------|-------------|---------|
+| `--yes` | `-y` | Skip confirmation prompts when overwriting local files | false |
+
+**What it does:**
+1. Downloads the challenge tarball from cloud storage
+2. Extracts `challenge.ts` and `config.ts` from the `.src` folder in the tarball
+3. Places files in `challenges/<short-slug>/` directory
+4. Builds the datapack locally
+
+**Interactive mode (no slug argument):**
+- Shows list of all cloud challenges (your own + team-kradle)
+- Marks challenges that exist locally with "(local)" indicator
+- Select a challenge to pull
+
+**Confirmation prompt:**
+When pulling over existing local files (without `--yes`), shows:
+- Which files will be overwritten
+- Asks for confirmation before proceeding
+
+**Examples:**
+```bash
+# Interactive selection from all cloud challenges
+kradle challenge pull
+
+# Pull your own challenge
+kradle challenge pull my-challenge
+
+# Pull a public challenge from another team
+kradle challenge pull team-kradle:example-challenge
+
+# Pull without confirmation prompt
+kradle challenge pull my-challenge --yes
+```
+
+---
+
 ### `kradle challenge watch <name>`
 
 Watches a challenge for file changes and automatically rebuilds/uploads.
@@ -663,6 +718,7 @@ kradle challenge build --all --visibility public
 | `kradle challenge build --all` | Build all challenges |
 | `kradle challenge delete <name>` | Delete challenge |
 | `kradle challenge list` | List all challenges |
+| `kradle challenge pull [name]` | Pull challenge from cloud |
 | `kradle challenge watch <name>` | Watch and auto-rebuild |
 | `kradle challenge run <name>` | Run challenge |
 | `kradle experiment create <name>` | Create new experiment |