@kradle/cli 0.2.2 → 0.2.3

package/README.md

@@ -128,6 +128,7 @@ Run a challenge in production or studio environment:
 ```bash
 kradle challenge run <challenge-name>
 kradle challenge run <challenge-name> --studio  # Run in local studio environment
+kradle challenge run <team-name>:<challenge-name>  # Run a public challenge from another team
 ```
 
 ## Experiment Commands

package/dist/commands/challenge/run.d.ts

@@ -11,7 +11,6 @@ export default class Run extends Command {
         "web-url": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         "studio-api-url": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         "studio-url": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        "challenges-path": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         studio: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

package/dist/commands/challenge/run.js

@@ -2,7 +2,6 @@ import { Command, Flags } from "@oclif/core";
 import pc from "picocolors";
 import { ApiClient } from "../../lib/api-client.js";
 import { getChallengeSlugArgument } from "../../lib/arguments.js";
-import { Challenge } from "../../lib/challenge.js";
 import { getConfigFlags } from "../../lib/flags.js";
 import { loadTemplateRun, openInBrowser } from "../../lib/utils.js";
 export default class Run extends Command {
@@ -10,27 +9,31 @@ export default class Run extends Command {
     static examples = [
         "<%= config.bin %> <%= command.id %> my-challenge",
         "<%= config.bin %> <%= command.id %> my-challenge --studio",
+        "<%= config.bin %> <%= command.id %> team-name:my-challenge",
     ];
     static args = {
-        challengeSlug: getChallengeSlugArgument({ description: "Challenge slug to run" }),
+        challengeSlug: getChallengeSlugArgument({
+            description: "Challenge slug to run (e.g., 'my-challenge' or 'team-name:my-challenge')",
+            allowTeam: true,
+        }),
     };
     static flags = {
         studio: Flags.boolean({ char: "s", description: "Run in studio environment", default: false }),
         open: Flags.boolean({ char: "o", description: "Open the run URL in the browser", default: false }),
-        ...getConfigFlags("api-key", "api-url", "challenges-path", "web-url", "studio-url", "studio-api-url"),
+        ...getConfigFlags("api-key", "api-url", "web-url", "studio-url", "studio-api-url"),
     };
     async run() {
         const { args, flags } = await this.parse(Run);
         const apiUrl = flags.studio ? flags["studio-api-url"] : flags["api-url"];
         const studioApi = new ApiClient(apiUrl, flags["api-key"], flags.studio);
-        const challenge = new Challenge(args.challengeSlug, flags["challenges-path"]);
+        const challengeSlug = args.challengeSlug;
         try {
             const { participants } = (await loadTemplateRun());
             const template = {
-                challenge: challenge.shortSlug,
+                challenge: challengeSlug,
                 participants,
             };
-            this.log(pc.blue(`>> Running challenge: ${challenge.shortSlug}${flags.studio ? " (studio)" : ""}...`));
+            this.log(pc.blue(`>> Running challenge: ${challengeSlug}${flags.studio ? " (studio)" : ""}...`));
             const response = await studioApi.runChallenge(template);
             if (response.runIds && response.runIds.length > 0) {
                 const baseUrl = flags.studio ? flags["studio-url"] : flags["web-url"];

package/dist/lib/arguments.d.ts

@@ -1,8 +1,12 @@
 import type { Arg } from "@oclif/core/interfaces";
 /**
- * Returns a "challenge slug" argument, and validates it to be a valid challenge slug.
+ * Returns a "challenge slug" argument, validating it to be a valid challenge slug.
+ * @param description - Description for the argument
+ * @param required - Whether the argument is required (default: true)
+ * @param allowTeam - Whether to allow namespaced slugs like "team-name:my-challenge" (default: false)
  */
-export declare function getChallengeSlugArgument<R extends boolean = true>({ description, required, }: {
+export declare function getChallengeSlugArgument<R extends boolean = true>({ description, required, allowTeam, }: {
     description: string;
     required?: R;
+    allowTeam?: boolean;
 }): Arg<R extends true ? string : string | undefined>;

package/dist/lib/arguments.js

@@ -1,15 +1,27 @@
 import { Args } from "@oclif/core";
-const CHALLENGE_SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+// Base pattern for a slug segment (lowercase alphanumeric with hyphens, no leading/trailing hyphens)
+const SLUG_SEGMENT = "[a-z0-9]+(?:-[a-z0-9]+)*";
+// Local challenge slug pattern: just the challenge name (no namespace)
+const LOCAL_SLUG_REGEX = new RegExp(`^${SLUG_SEGMENT}$`);
+// Full challenge slug pattern: optional namespace prefix (e.g., "team-name:") followed by the challenge slug
+const NAMESPACED_SLUG_REGEX = new RegExp(`^(?:${SLUG_SEGMENT}:)?${SLUG_SEGMENT}$`);
 /**
- * Returns a "challenge slug" argument, and validates it to be a valid challenge slug.
+ * Returns a "challenge slug" argument, validating it to be a valid challenge slug.
+ * @param description - Description for the argument
+ * @param required - Whether the argument is required (default: true)
+ * @param allowTeam - Whether to allow namespaced slugs like "team-name:my-challenge" (default: false)
  */
-export function getChallengeSlugArgument({ description, required, }) {
+export function getChallengeSlugArgument({ description, required, allowTeam = false, }) {
+    const regex = allowTeam ? NAMESPACED_SLUG_REGEX : LOCAL_SLUG_REGEX;
+    const errorMessage = allowTeam
+        ? "Challenge slugs must be lowercase alphanumeric characters and hyphens, and must not start or end with a hyphen. Optionally, a team prefix can be provided (e.g., 'team-name:my-challenge')."
+        : "Challenge slugs must be lowercase alphanumeric characters and hyphens, and must not start or end with a hyphen.";
     const arg = Args.string({
         description,
         required: required ?? true,
         parse: async (input) => {
-            if (!CHALLENGE_SLUG_REGEX.test(input)) {
-                throw new Error(`Invalid challenge slug: ${input}. Challenge slugs must be lowercase alphanumeric characters and hyphens, and must not start or end with a hyphen.`);
+            if (!regex.test(input)) {
+                throw new Error(`Invalid challenge slug: ${input}. ${errorMessage}`);
             }
             return input;
         },

package/oclif.manifest.json

@@ -86,54 +86,6 @@
         "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": {
@@ -409,7 +361,7 @@
       "aliases": [],
       "args": {
         "challengeSlug": {
-          "description": "Challenge slug to run",
+          "description": "Challenge slug to run (e.g., 'my-challenge' or 'team-name:my-challenge')",
           "name": "challengeSlug",
           "required": true
         }
@@ -417,7 +369,8 @@
       "description": "Run a challenge",
       "examples": [
         "<%= config.bin %> <%= command.id %> my-challenge",
-        "<%= config.bin %> <%= command.id %> my-challenge --studio"
+        "<%= config.bin %> <%= command.id %> my-challenge --studio",
+        "<%= config.bin %> <%= command.id %> team-name:my-challenge"
       ],
       "flags": {
         "studio": {
@@ -453,15 +406,6 @@
           "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"
-        },
         "web-url": {
           "description": "Kradle Web URL, used to display the run URL",
           "env": "KRADLE_WEB_URL",
@@ -574,6 +518,54 @@
         "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": {
@@ -808,5 +800,5 @@
       ]
     }
   },
-  "version": "0.2.2"
+  "version": "0.2.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kradle/cli",
-	"version": "0.2.2",
+	"version": "0.2.3",
 	"description": "Kradle's CLI. Manage challenges, experiments, agents and more!",
 	"keywords": [
 		"cli"

package/static/ai_docs/LLM_CLI_REFERENCE.md

@@ -260,17 +260,19 @@ Runs a challenge with configured participants.
 ```bash
 kradle challenge run <challenge-name>
 kradle challenge run <challenge-name> --studio
+kradle challenge run <team-name>:<challenge-name>
 ```
 
 **Arguments:**
 | Argument | Description | Required |
 |----------|-------------|----------|
-| `challenge-name` | Challenge to run | Yes |
+| `challenge-name` | Challenge to run. Can be a short slug (e.g., `my-challenge`) or include a team/user namespace (e.g., `team-name:my-challenge`). The namespace is useful for running public challenges owned by other teams. If no namespace is provided, it defaults to the user's own namespace. | Yes |
 
 **Flags:**
 | Flag | Description | Default |
 |------|-------------|---------|
 | `--studio` | Run in local studio environment instead of production | false |
+| `--open` | Open the run URL in the browser | false |
 
 **Prerequisites:**
 - `template-run.json` must exist in project root with participant configuration
@@ -294,9 +296,12 @@ kradle challenge run <challenge-name> --studio
 
 **Examples:**
 ```bash
-# Run in production
+# Run your own challenge in production
 kradle challenge run my-challenge
 
+# Run a public challenge from another team
+kradle challenge run team-kradle:battle-royale
+
 # Run in local studio
 kradle challenge run my-challenge --studio
 ```