evolved-monkey 0.1.0

package/README.md

@@ -0,0 +1,22 @@
+# Creator CLI (V0)
+
+TypeScript-based CLI for creator workflows.
+
+## Commands
+
+```bash
+em-challenge challenge init --slug <slug> --title <title> [--description <text>] [--constraints <text>] [--backend <url>] [--dir <path>]
+em-challenge challenge validate [--dir <path>]
+em-challenge challenge submit [--backend <url>] [--dir <path>]
+```
+
+## What Each Command Does
+- `challenge init`: creates challenge metadata in backend (`draft`) and scaffolds local creator workspace.
+- `challenge validate`: checks workspace against creator rules (metadata, required files, disallowed files, hidden test presence).
+- `challenge submit`: validates workspace, requests signed R2 upload URLs, packs starter/tests as `tar.gz`, and uploads both artifacts.
+
+## Test
+```bash
+npm run typecheck
+npm test
+```

package/dist/src/cli.d.ts

@@ -0,0 +1,15 @@
+import type { PackageDirectoryInput } from "./commands/challenge-submit.js";
+import type { BackendClientContract, Logger } from "./types.js";
+type CliContext = {
+    backendClient?: BackendClientContract;
+    cwd?: string;
+    log?: Logger;
+    packageDirectory?: (input: PackageDirectoryInput) => Promise<Buffer>;
+};
+export declare function runCli(rawArgv: string[], context?: CliContext): Promise<{
+    challengeId: string | null;
+    slug: string;
+    workspaceDir: string;
+} | import("./commands/challenge-validate.js").ChallengeValidateResult | import("./commands/challenge-submit.js").ChallengeSubmitResult>;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAY,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1E,KAAK,UAAU,GAAG;IAChB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE,CAAC;AAuBF,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe;;;;yIA+CvE"}

package/dist/src/cli.js

@@ -0,0 +1,63 @@
+import { DEFAULT_BACKEND_BASE_URL } from "./constants.js";
+import { runChallengeInit } from "./commands/challenge-init.js";
+import { runChallengeSubmit } from "./commands/challenge-submit.js";
+import { runChallengeValidate } from "./commands/challenge-validate.js";
+import { BackendClient } from "./lib/backend-client.js";
+import { parseArgs } from "./lib/args.js";
+import { CliError } from "./lib/cli-error.js";
+function resolveBackendBaseUrl(flags, command) {
+    if (flags.backend && flags.backend !== true) {
+        return String(flags.backend);
+    }
+    if (command === "challenge" && (flags.dir || flags.dir === "")) {
+        return process.env.BACKEND_BASE_URL ?? DEFAULT_BACKEND_BASE_URL;
+    }
+    return process.env.BACKEND_BASE_URL ?? DEFAULT_BACKEND_BASE_URL;
+}
+function usageText() {
+    return [
+        "Usage:",
+        "  em-challenge challenge init --slug <slug> --title <title> [--description <text>] [--constraints <text>] [--backend <url>] [--dir <path>]",
+        "  em-challenge challenge validate [--dir <path>]",
+        "  em-challenge challenge submit [--backend <url>] [--dir <path>]",
+    ].join("\n");
+}
+export async function runCli(rawArgv, context = {}) {
+    const argv = rawArgv.slice();
+    const { flags, positionals } = parseArgs(argv);
+    const log = context.log ?? console.log;
+    const cwd = context.cwd ?? process.cwd();
+    const [domain, command] = positionals;
+    if (!domain || !command) {
+        throw new CliError(usageText(), { code: "USAGE_ERROR" });
+    }
+    if (domain !== "challenge") {
+        throw new CliError(`Unsupported domain: ${domain}\n\n${usageText()}`, { code: "USAGE_ERROR" });
+    }
+    const backendBaseUrl = resolveBackendBaseUrl(flags, domain);
+    const backendClient = context.backendClient ?? new BackendClient(backendBaseUrl);
+    if (command === "init") {
+        return runChallengeInit({ backendClient, cwd, flags, log });
+    }
+    if (command === "validate") {
+        const result = await runChallengeValidate({ cwd, flags, log });
+        if (!result.ok) {
+            throw new CliError("Validation failed.", {
+                code: "VALIDATION_FAILED",
+                details: result.errors,
+            });
+        }
+        return result;
+    }
+    if (command === "submit") {
+        return runChallengeSubmit({
+            backendClient,
+            cwd,
+            flags,
+            log,
+            packageDirectory: context.packageDirectory,
+        });
+    }
+    throw new CliError(`Unsupported command: ${command}\n\n${usageText()}`, { code: "USAGE_ERROR" });
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/challenge-init.d.ts

@@ -0,0 +1,15 @@
+import type { BackendClientContract, CliFlags, Logger } from "../types.js";
+type ChallengeInitInput = {
+    backendClient: BackendClientContract;
+    cwd?: string;
+    flags: CliFlags;
+    log?: Logger;
+};
+type ChallengeInitResult = {
+    challengeId: string | null;
+    slug: string;
+    workspaceDir: string;
+};
+export declare function runChallengeInit({ backendClient, cwd, flags, log, }: ChallengeInitInput): Promise<ChallengeInitResult>;
+export {};
+//# sourceMappingURL=challenge-init.d.ts.map

package/dist/src/commands/challenge-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge-init.d.ts","sourceRoot":"","sources":["../../../src/commands/challenge-init.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,qBAAqB,EAErB,QAAQ,EACR,MAAM,EACP,MAAM,aAAa,CAAC;AAErB,KAAK,kBAAkB,GAAG;IACxB,aAAa,EAAE,qBAAqB,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAyDF,wBAAsB,gBAAgB,CAAC,EACrC,aAAa,EACb,GAAmB,EACnB,KAAK,EACL,GAAiB,GAClB,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqEnD"}

package/dist/src/commands/challenge-init.js

@@ -0,0 +1,98 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { CHALLENGE_CONFIG_FILE, CONSTRAINTS_PLACEHOLDER, DEFAULT_BACKEND_BASE_URL, DESCRIPTION_PLACEHOLDER, } from "../constants.js";
+import { CliError } from "../lib/cli-error.js";
+import { ensureDir, pathExists, writeJsonFile } from "../lib/fs-utils.js";
+import { ensureValidSlug } from "../lib/workspace.js";
+function resolveOption(flags, key, fallback) {
+    const value = flags[key];
+    if (value === undefined || value === true || value === "") {
+        return fallback;
+    }
+    return String(value);
+}
+async function createStarterTemplate(workspaceDir) {
+    const starterDir = path.join(workspaceDir, "starter");
+    await ensureDir(path.join(starterDir, "src"));
+    const starterPackage = {
+        name: "challenge-starter",
+        private: true,
+        scripts: {
+            start: "node src/index.js",
+            test: "node --test",
+        },
+        type: "module",
+        version: "1.0.0",
+    };
+    await writeJsonFile(path.join(starterDir, "package.json"), starterPackage);
+    await fs.writeFile(path.join(starterDir, "src", "index.js"), `export function createApp() {\n  return "replace-with-solution";\n}\n`, "utf8");
+    await fs.writeFile(path.join(starterDir, ".env.example"), "PORT=3000\n", "utf8");
+}
+async function createHiddenTestsTemplate(workspaceDir) {
+    const testsDir = path.join(workspaceDir, "tests");
+    await ensureDir(path.join(testsDir, "spec"));
+    const testsPackage = {
+        name: "challenge-hidden-tests",
+        private: true,
+        scripts: {
+            test: "node --test \"spec/**/*.test.js\"",
+        },
+        type: "module",
+        version: "1.0.0",
+    };
+    await writeJsonFile(path.join(testsDir, "package.json"), testsPackage);
+    await fs.writeFile(path.join(testsDir, "spec", "placeholder.test.js"), `import test from "node:test";\nimport assert from "node:assert/strict";\n\ntest("replace with real hidden tests", () => {\n  assert.equal(true, true);\n});\n`, "utf8");
+}
+export async function runChallengeInit({ backendClient, cwd = process.cwd(), flags, log = console.log, }) {
+    const slug = ensureValidSlug(flags.slug);
+    const title = resolveOption(flags, "title", "");
+    if (!title || title.length < 3) {
+        throw new CliError("`--title` is required and must be at least 3 characters.", {
+            code: "INVALID_TITLE",
+        });
+    }
+    const descriptionMd = resolveOption(flags, "description", DESCRIPTION_PLACEHOLDER);
+    const constraintsMd = resolveOption(flags, "constraints", CONSTRAINTS_PLACEHOLDER);
+    const backendBaseUrl = resolveOption(flags, "backend", process.env.BACKEND_BASE_URL ?? DEFAULT_BACKEND_BASE_URL);
+    const workspaceDir = path.resolve(cwd, resolveOption(flags, "dir", slug));
+    if (await pathExists(workspaceDir)) {
+        throw new CliError(`Target directory already exists: ${workspaceDir}`, {
+            code: "DIRECTORY_EXISTS",
+        });
+    }
+    const payload = {
+        constraintsMd,
+        descriptionMd,
+        slug,
+        title,
+        type: "EXPRESS_NODE",
+    };
+    const createdChallenge = await backendClient.createChallengeDraft(payload);
+    await ensureDir(workspaceDir);
+    await createStarterTemplate(workspaceDir);
+    await createHiddenTestsTemplate(workspaceDir);
+    const config = {
+        backendBaseUrl,
+        challengeId: createdChallenge?.id ?? null,
+        constraintsMd,
+        createdAt: new Date().toISOString(),
+        descriptionMd,
+        slug,
+        title,
+        type: "EXPRESS_NODE",
+        version: 1,
+    };
+    await writeJsonFile(path.join(workspaceDir, CHALLENGE_CONFIG_FILE), config);
+    await fs.writeFile(path.join(workspaceDir, "README.md"), `# ${title}\n\n## Description\n${descriptionMd}\n\n## Constraints\n${constraintsMd}\n`, "utf8");
+    log(`Challenge workspace created: ${workspaceDir}`);
+    log(`Next steps:`);
+    log(`1) cd ${workspaceDir}`);
+    log(`2) em-challenge challenge validate`);
+    log(`3) em-challenge challenge submit`);
+    return {
+        challengeId: createdChallenge?.id ?? null,
+        slug,
+        workspaceDir,
+    };
+}
+//# sourceMappingURL=challenge-init.js.map

package/dist/src/commands/challenge-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge-init.js","sourceRoot":"","sources":["../../../src/commands/challenge-init.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/challenge-submit.d.ts

@@ -0,0 +1,21 @@
+import type { BackendClientContract, CliFlags, Logger } from "../types.js";
+export type PackageDirectoryInput = {
+    archiveNamePrefix: string;
+    sourceDir: string;
+};
+type ChallengeSubmitInput = {
+    backendClient: BackendClientContract;
+    cwd?: string;
+    flags: CliFlags;
+    log?: Logger;
+    packageDirectory?: (input: PackageDirectoryInput) => Promise<Buffer>;
+};
+export type ChallengeSubmitResult = {
+    slug: string;
+    starterArtifactKey: string;
+    testsArtifactKey: string;
+};
+export declare function packageDirectoryToTarGz({ archiveNamePrefix, sourceDir, }: PackageDirectoryInput): Promise<Buffer>;
+export declare function runChallengeSubmit({ backendClient, cwd, flags, log, packageDirectory, }: ChallengeSubmitInput): Promise<ChallengeSubmitResult>;
+export {};
+//# sourceMappingURL=challenge-submit.d.ts.map

package/dist/src/commands/challenge-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge-submit.d.ts","sourceRoot":"","sources":["../../../src/commands/challenge-submit.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE3E,MAAM,MAAM,qBAAqB,GAAG;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE,qBAAqB,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,EAC5C,iBAAiB,EACjB,SAAS,GACV,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAezC;AAED,wBAAsB,kBAAkB,CAAC,EACvC,aAAa,EACb,GAAmB,EACnB,KAAK,EACL,GAAiB,EACjB,gBAA0C,GAC3C,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2CvD"}

package/dist/src/commands/challenge-submit.js

@@ -0,0 +1,52 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { CHALLENGE_CONFIG_FILE, EXCLUDED_ARTIFACT_PATTERNS } from "../constants.js";
+import { CliError } from "../lib/cli-error.js";
+import { readJsonFile } from "../lib/fs-utils.js";
+import { createTarGzFromDirectory } from "../lib/tarball.js";
+import { runChallengeValidate } from "./challenge-validate.js";
+export async function packageDirectoryToTarGz({ archiveNamePrefix, sourceDir, }) {
+    const archivePath = path.join(os.tmpdir(), `${archiveNamePrefix}-${Date.now()}-${Math.random().toString(36).slice(2)}.tar.gz`);
+    createTarGzFromDirectory({
+        excludePatterns: EXCLUDED_ARTIFACT_PATTERNS,
+        outputFile: archivePath,
+        sourceDir,
+    });
+    const fileBuffer = await fs.readFile(archivePath);
+    await fs.rm(archivePath, { force: true });
+    return fileBuffer;
+}
+export async function runChallengeSubmit({ backendClient, cwd = process.cwd(), flags, log = console.log, packageDirectory = packageDirectoryToTarGz, }) {
+    const validation = await runChallengeValidate({ cwd, flags, log: () => { } });
+    if (!validation.ok) {
+        throw new CliError(`Cannot submit challenge. Validation failed. Fix ${CHALLENGE_CONFIG_FILE} and workspace files first.`, {
+            code: "VALIDATION_FAILED",
+            details: validation.errors,
+        });
+    }
+    const workspaceDir = validation.workspaceDir;
+    const config = await readJsonFile(path.join(workspaceDir, CHALLENGE_CONFIG_FILE));
+    const slug = config.slug;
+    const starterUploadData = await backendClient.requestStarterUpload(slug);
+    const testsUploadData = await backendClient.requestTestsUpload(slug);
+    const starterBuffer = await packageDirectory({
+        archiveNamePrefix: `${slug}-starter`,
+        sourceDir: path.join(workspaceDir, "starter"),
+    });
+    const testsBuffer = await packageDirectory({
+        archiveNamePrefix: `${slug}-tests`,
+        sourceDir: path.join(workspaceDir, "tests"),
+    });
+    await backendClient.uploadArtifact(starterUploadData.upload, starterBuffer);
+    await backendClient.uploadArtifact(testsUploadData.upload, testsBuffer);
+    log(`Submitted challenge artifacts for ${slug}.`);
+    log(`Starter artifact key: ${starterUploadData.upload.key}`);
+    log(`Tests artifact key: ${testsUploadData.upload.key}`);
+    return {
+        slug,
+        starterArtifactKey: starterUploadData.upload.key,
+        testsArtifactKey: testsUploadData.upload.key,
+    };
+}
+//# sourceMappingURL=challenge-submit.js.map

package/dist/src/commands/challenge-submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge-submit.js","sourceRoot":"","sources":["../../../src/commands/challenge-submit.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/challenge-validate.d.ts

@@ -0,0 +1,13 @@
+import type { CliFlags, Logger } from "../types.js";
+import type { WorkspaceValidationResult } from "../lib/workspace.js";
+type ChallengeValidateInput = {
+    cwd?: string;
+    flags: CliFlags;
+    log?: Logger;
+};
+export type ChallengeValidateResult = WorkspaceValidationResult & {
+    workspaceDir: string;
+};
+export declare function runChallengeValidate({ cwd, flags, log, }: ChallengeValidateInput): Promise<ChallengeValidateResult>;
+export {};
+//# sourceMappingURL=challenge-validate.d.ts.map

package/dist/src/commands/challenge-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge-validate.d.ts","sourceRoot":"","sources":["../../../src/commands/challenge-validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,KAAK,sBAAsB,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,yBAAyB,GAAG;IAChE,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,GAAmB,EACnB,KAAK,EACL,GAAiB,GAClB,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA2B3D"}

package/dist/src/commands/challenge-validate.js

@@ -0,0 +1,28 @@
+import path from "node:path";
+import { validateWorkspace } from "../lib/workspace.js";
+export async function runChallengeValidate({ cwd = process.cwd(), flags, log = console.log, }) {
+    const workspaceDir = path.resolve(cwd, String(flags.dir || "."));
+    const result = await validateWorkspace(workspaceDir);
+    if (!result.ok) {
+        log(`Validation failed for workspace: ${workspaceDir}`);
+        for (const error of result.errors) {
+            log(`- ERROR: ${error}`);
+        }
+        for (const warning of result.warnings) {
+            log(`- WARNING: ${warning}`);
+        }
+        return {
+            ...result,
+            workspaceDir,
+        };
+    }
+    log(`Validation passed for workspace: ${workspaceDir}`);
+    for (const warning of result.warnings) {
+        log(`- WARNING: ${warning}`);
+    }
+    return {
+        ...result,
+        workspaceDir,
+    };
+}
+//# sourceMappingURL=challenge-validate.js.map

package/dist/src/commands/challenge-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge-validate.js","sourceRoot":"","sources":["../../../src/commands/challenge-validate.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAcxD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EACnB,KAAK,EACL,GAAG,GAAG,OAAO,CAAC,GAAG,GACM;IACvB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAErD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,GAAG,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO;YACL,GAAG,MAAM;YACT,YAAY;SACb,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAC;IACxD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/src/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_BACKEND_BASE_URL = "http://localhost:3001";
+export declare const CHALLENGE_CONFIG_FILE = "challenge.config.json";
+export declare const DESCRIPTION_PLACEHOLDER = "REPLACE_WITH_CHALLENGE_DESCRIPTION";
+export declare const CONSTRAINTS_PLACEHOLDER = "REPLACE_WITH_CHALLENGE_CONSTRAINTS";
+export declare const EXCLUDED_ARTIFACT_PATTERNS: readonly ["node_modules", ".git", ".DS_Store", "*.log", ".env"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAChE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,eAAO,MAAM,uBAAuB,uCAAuC,CAAC;AAC5E,eAAO,MAAM,uBAAuB,uCAAuC,CAAC;AAE5E,eAAO,MAAM,0BAA0B,iEAM7B,CAAC"}

package/dist/src/constants.js

@@ -0,0 +1,12 @@
+export const DEFAULT_BACKEND_BASE_URL = "http://localhost:3001";
+export const CHALLENGE_CONFIG_FILE = "challenge.config.json";
+export const DESCRIPTION_PLACEHOLDER = "REPLACE_WITH_CHALLENGE_DESCRIPTION";
+export const CONSTRAINTS_PLACEHOLDER = "REPLACE_WITH_CHALLENGE_CONSTRAINTS";
+export const EXCLUDED_ARTIFACT_PATTERNS = [
+    "node_modules",
+    ".git",
+    ".DS_Store",
+    "*.log",
+    ".env",
+];
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,oCAAoC,CAAC;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,oCAAoC,CAAC;AAE5E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,cAAc;IACd,MAAM;IACN,WAAW;IACX,OAAO;IACP,MAAM;CACE,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/src/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { CliError } from "./lib/cli-error.js";
+import { runCli } from "./cli.js";
+async function main() {
+    try {
+        await runCli(process.argv.slice(2));
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            console.error(error.message);
+            process.exit(error.exitCode);
+            return;
+        }
+        console.error("Unexpected CLI error.");
+        console.error(error);
+        process.exit(1);
+    }
+}
+void main();
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACvC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}

package/dist/src/lib/args.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArgs } from "../types.js";
+export declare function parseArgs(argv: string[]): ParsedArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/src/lib/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/lib/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4BpD"}

package/dist/src/lib/args.js

@@ -0,0 +1,24 @@
+export function parseArgs(argv) {
+    const positionals = [];
+    const flags = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (!token) {
+            continue;
+        }
+        if (!token.startsWith("--")) {
+            positionals.push(token);
+            continue;
+        }
+        const key = token.slice(2);
+        const next = argv[index + 1];
+        if (!next || next.startsWith("--")) {
+            flags[key] = true;
+            continue;
+        }
+        flags[key] = next;
+        index += 1;
+    }
+    return { flags, positionals };
+}
+//# sourceMappingURL=args.js.map

package/dist/src/lib/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/lib/args.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAE7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAClB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC"}

package/dist/src/lib/backend-client.d.ts

@@ -0,0 +1,10 @@
+import type { ArtifactUploadResponse, ArtifactUploadTarget, BackendClientContract, ChallengeDraftPayload, ChallengeDraftResponse } from "../types.js";
+export declare class BackendClient implements BackendClientContract {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    createChallengeDraft(input: ChallengeDraftPayload): Promise<ChallengeDraftResponse>;
+    requestStarterUpload(slug: string): Promise<ArtifactUploadResponse>;
+    requestTestsUpload(slug: string): Promise<ArtifactUploadResponse>;
+    uploadArtifact(upload: ArtifactUploadTarget, fileBuffer: Buffer): Promise<void>;
+}
+//# sourceMappingURL=backend-client.d.ts.map

package/dist/src/lib/backend-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-client.d.ts","sourceRoot":"","sources":["../../../src/lib/backend-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAyCrB,qBAAa,aAAc,YAAW,qBAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEd,OAAO,EAAE,MAAM;IAIrB,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoBnF,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiBnE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiBjE,cAAc,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB7F"}

package/dist/src/lib/backend-client.js

@@ -0,0 +1,86 @@
+import { CliError } from "./cli-error.js";
+async function parseJsonSafely(response) {
+    const text = await response.text();
+    if (!text) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+async function requestJson(url, options = {}) {
+    const response = await fetch(url, options);
+    const payload = await parseJsonSafely(response);
+    if (!response.ok) {
+        const apiMessage = payload?.error?.message;
+        throw new CliError(apiMessage ?? `Backend request failed (${response.status})`, {
+            code: payload?.error?.code ?? "BACKEND_REQUEST_FAILED",
+            details: payload,
+        });
+    }
+    return payload ?? {};
+}
+export class BackendClient {
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+    }
+    async createChallengeDraft(input) {
+        const payload = await requestJson(`${this.baseUrl}/v1/creator/challenges/init`, {
+            body: JSON.stringify(input),
+            headers: {
+                "content-type": "application/json",
+            },
+            method: "POST",
+        });
+        const challenge = payload?.data?.challenge;
+        if (!challenge) {
+            throw new CliError("Backend did not return created challenge data.", {
+                code: "INVALID_BACKEND_RESPONSE",
+            });
+        }
+        return challenge;
+    }
+    async requestStarterUpload(slug) {
+        const payload = await requestJson(`${this.baseUrl}/v1/creator/challenges/${encodeURIComponent(slug)}/artifacts/starter/upload-url`, {
+            method: "POST",
+        });
+        if (!payload.data || !("upload" in payload.data)) {
+            throw new CliError("Backend did not return starter upload target.", {
+                code: "INVALID_BACKEND_RESPONSE",
+            });
+        }
+        return payload.data;
+    }
+    async requestTestsUpload(slug) {
+        const payload = await requestJson(`${this.baseUrl}/v1/creator/challenges/${encodeURIComponent(slug)}/artifacts/tests/upload-url`, {
+            method: "POST",
+        });
+        if (!payload.data || !("upload" in payload.data)) {
+            throw new CliError("Backend did not return tests upload target.", {
+                code: "INVALID_BACKEND_RESPONSE",
+            });
+        }
+        return payload.data;
+    }
+    async uploadArtifact(upload, fileBuffer) {
+        const headers = new Headers(upload.headers ?? {});
+        if (!headers.has("content-type")) {
+            headers.set("content-type", "application/gzip");
+        }
+        const response = await fetch(upload.url, {
+            body: new Uint8Array(fileBuffer),
+            headers,
+            method: upload.method ?? "PUT",
+        });
+        if (!response.ok) {
+            throw new CliError(`Artifact upload failed (${response.status})`, {
+                code: "ARTIFACT_UPLOAD_FAILED",
+            });
+        }
+    }
+}
+//# sourceMappingURL=backend-client.js.map

package/dist/src/lib/backend-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-client.js","sourceRoot":"","sources":["../../../src/lib/backend-client.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/cli-error.d.ts

@@ -0,0 +1,12 @@
+export type CliErrorOptions = {
+    code?: string;
+    details?: unknown;
+    exitCode?: number;
+};
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    readonly exitCode: number;
+    constructor(message: string, options?: CliErrorOptions);
+}
+//# sourceMappingURL=cli-error.d.ts.map

package/dist/src/lib/cli-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error.d.ts","sourceRoot":"","sources":["../../../src/lib/cli-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;CAOlE"}

package/dist/src/lib/cli-error.js

@@ -0,0 +1,13 @@
+export class CliError extends Error {
+    code;
+    details;
+    exitCode;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = "CliError";
+        this.code = options.code ?? "CLI_ERROR";
+        this.details = options.details;
+        this.exitCode = options.exitCode ?? 1;
+    }
+}
+//# sourceMappingURL=cli-error.js.map

package/dist/src/lib/cli-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error.js","sourceRoot":"","sources":["../../../src/lib/cli-error.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,IAAI,CAAS;IACb,OAAO,CAAW;IAClB,QAAQ,CAAS;IAEjC,YAAmB,OAAe,EAAE,UAA2B,EAAE;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}