@aicopycoders/exodus 2026.7.200-beta.5 → 2026.7.200-beta.7

package/dist/commands/doctor.js

@@ -7,6 +7,7 @@ import { findWorkspaceRoot } from "../lib/state.js";
 import { detectLayout, listBrandDirs, resolveActiveBrand, brandStateDir, } from "../lib/layout.js";
 import { auth401Hint, isPlaceholderApiUrl } from "../lib/backend-hint.js";
 import { compareVersions, readPackageVersion, } from "../lib/release.js";
+import { channelOf, pkgRef, stampChannel } from "../lib/channel.js";
 export const helpText = `
 exodus doctor — Preflight checks for your local Claude Code setup
 
@@ -58,7 +59,7 @@ export function checkEnvFile() {
         return {
             ok: false,
             label: ".env",
-            fix: "run `npx @aicopycoders/exodus init`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)",
+            fix: `run \`npx ${pkgRef()} init\`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)`,
         };
     }
     const content = fs.readFileSync(envPath, "utf8");
@@ -80,7 +81,7 @@ export function checkEnvFile() {
         ok: false,
         label: ".env",
         detail: "missing EXODUS_API_URL or EXODUS_API_KEY",
-        fix: "run `npx @aicopycoders/exodus init`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)",
+        fix: `run \`npx ${pkgRef()} init\`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)`,
     };
 }
 export async function checkWhoami() {
@@ -124,7 +125,7 @@ export async function checkWhoami() {
                 todo: true,
                 label: "Brand primer",
                 detail: `${d.workspaceSlug} has no primer yet — set one up to unlock the pipelines`,
-                fix: `say "exodus, set up my brand primer" (or run \`npx @aicopycoders/exodus foundation\` from a source doc, or paste it at /settings?tab=brands&brand=${d.workspaceSlug})`,
+                fix: `say "exodus, set up my brand primer" (or run \`npx ${pkgRef()} foundation\` from a source doc, or paste it at /settings?tab=brands&brand=${d.workspaceSlug})`,
             };
         }
         return {
@@ -182,7 +183,7 @@ export async function checkActiveBrandMatch() {
         ok: false,
         label: "Active brand",
         detail: `local active brand "${resolved.slug}" (${source}) is NOT in your accessible list — the server ignores it and every command silently targets the key's default brand. available: ${available}`,
-        fix: `run \`npx @aicopycoders/exodus brand use <slug>\` with one of your brands, or \`npx @aicopycoders/exodus brand clear\` to fall back to the key default`,
+        fix: `run \`npx ${pkgRef()} brand use <slug>\` with one of your brands, or \`npx ${pkgRef()} brand clear\` to fall back to the key default`,
     };
 }
 const FRESHNESS_SUBTREES = ["commands", "lib", "bin"];
@@ -251,7 +252,9 @@ export function checkExodusDistFreshness(pkgRootOverride) {
     }
     return { ok: true, label: "Exodus CLI build", detail: "dist up-to-date" };
 }
-const NPM_REGISTRY = "https://registry.npmjs.org/@aicopycoders/exodus/latest";
+function npmRegistryUrl(channel) {
+    return `https://registry.npmjs.org/@aicopycoders/exodus/${channel}`;
+}
 export async function checkVersionCurrency(pkgRootOverride, fetchImpl = fetch) {
     let pkgRoot;
     if (pkgRootOverride) {
@@ -265,28 +268,29 @@ export async function checkVersionCurrency(pkgRootOverride, fetchImpl = fetch) {
         }
     }
     const local = readPackageVersion(pkgRoot);
+    const channel = channelOf(local);
     try {
         const ctrl = new AbortController();
         const t = setTimeout(() => ctrl.abort(), 8_000);
         let res;
         try {
-            res = await fetchImpl(NPM_REGISTRY, { signal: ctrl.signal });
+            res = await fetchImpl(npmRegistryUrl(channel), { signal: ctrl.signal });
         }
         finally {
             clearTimeout(t);
         }
         if (!res.ok)
             throw new Error(`HTTP ${res.status}`);
-        const latest = (await res.json()).version;
-        if (compareVersions(local, latest) >= 0) {
+        const published = (await res.json()).version;
+        if (compareVersions(local, published) >= 0) {
             return { ok: true, label: "Exodus version", detail: `${local} — up to date` };
         }
         return {
             ok: true,
             warn: true,
             label: "Exodus version",
-            detail: `${local} installed, ${latest} available`,
-            fix: "run `npx @aicopycoders/exodus@latest init` to update (or `npm update -g @aicopycoders/exodus`)",
+            detail: `${local} installed, ${published} available`,
+            fix: `run \`npx ${pkgRef(channel)} init\` to update (or \`npm install -g ${pkgRef(channel)}\`)`,
         };
     }
     catch (err) {
@@ -326,7 +330,7 @@ export async function checkApiAndDrive() {
                 ok: false,
                 label: "Dashboard API key",
                 detail: `HTTP ${res.status}`,
-                fix: "regenerate at Settings → API Keys, then paste the new .env block (or re-run `npx @aicopycoders/exodus init`)",
+                fix: `regenerate at Settings → API Keys, then paste the new .env block (or re-run \`npx ${pkgRef()} init\`)`,
             },
             {
                 ok: false,
@@ -445,7 +449,9 @@ export async function checkDashboardAuth() {
             ok: false,
             label: "Dashboard auth (dashboard-routed pipelines)",
             detail: res.data?.error ?? "401 from /api/doctor/dashboard-ping",
-            fix: hint ?? "run `npx @aicopycoders/exodus@latest init` to update the CLI — older releases skipped the Bearer header on dashboard routes",
+            fix: hint
+                ? stampChannel(hint)
+                : `run \`npx ${pkgRef()} init\` to update the CLI — older releases skipped the Bearer header on dashboard routes`,
         };
     }
     return {
@@ -476,7 +482,7 @@ export function checkLayout() {
         return {
             ok: true,
             label: "Layout",
-            detail: "single-brand (legacy) — run `npx @aicopycoders/exodus migrate` to switch to the multi-brand layout",
+            detail: `single-brand (legacy) — run \`npx ${pkgRef()} migrate\` to switch to the multi-brand layout`,
         };
     }
     const brands = listBrandDirs(root);
@@ -490,7 +496,7 @@ export function checkLayout() {
             warn: true,
             label: "Layout",
             detail: `multi-brand — no brand folders yet; ${active}`,
-            fix: "run `npx @aicopycoders/exodus@latest init` (or `npx @aicopycoders/exodus brand use <slug>`) to create your brand folders",
+            fix: `run \`npx ${pkgRef()} init\` (or \`npx ${pkgRef()} brand use <slug>\`) to create your brand folders`,
         };
     }
     const missingProfiles = brands.filter((b) => !fs.existsSync(path.join(b.dir, "state", "brand-profile.md")));
@@ -500,7 +506,7 @@ export function checkLayout() {
             warn: true,
             label: "Layout",
             detail: `multi-brand, ${brands.length} brand folder(s); ${active}; missing brand profile in: ${missingProfiles.map((b) => b.slug).join(", ")}`,
-            fix: "run `npx @aicopycoders/exodus@latest init` to refresh every brand folder's profile",
+            fix: `run \`npx ${pkgRef()} init\` to refresh every brand folder's profile`,
         };
     }
     return {
@@ -518,7 +524,7 @@ export function checkBrandProfileGenesisDepth() {
             ok: false,
             label: "brand-profile",
             detail: `${rel} is missing`,
-            fix: "run `npx @aicopycoders/exodus brand use <slug>` to generate it",
+            fix: `run \`npx ${pkgRef()} brand use <slug>\` to generate it`,
         };
     }
     const contents = fs.readFileSync(filePath, "utf-8");

package/dist/commands/init.js

@@ -3,12 +3,13 @@ import path from "node:path";
 import { writeEnvScaffold, ensureGitignore, writeSkills, writeReferences, writeDocs, ensureBaseDirs, } from "../lib/scaffold.js";
 import { loadWorkspaceEnv } from "../lib/load-env.js";
 import { ensureBrandDir } from "../lib/layout.js";
+import { pkgRef } from "../lib/channel.js";
 export const helpText = `
 exodus init — Set up (or refresh) an Exodus workspace in the current folder
 
 Usage:
-  npx @aicopycoders/exodus init        Scaffold the workspace + install skills
-  npx @aicopycoders/exodus init --root <dir>   Target a specific folder
+  npx ${pkgRef()} init        Scaffold the workspace + install skills
+  npx ${pkgRef()} init --root <dir>   Target a specific folder
 
 Run this in a fresh, empty folder. It creates the workspace layout, writes the
 Exodus + Genesis skills into .claude/skills/, scaffolds a comment-only .env, and

package/dist/commands/meme.js

@@ -1,5 +1,6 @@
 import { apiPostDashboard, getDashboardUrl } from "../lib/client.js";
 import { formatError } from "../lib/format.js";
+import { pkgRef } from "../lib/channel.js";
 import { readFileSync } from "node:fs";
 export const helpText = `
 exodus meme — Meme generator: brief → recommended formats → one batched run
@@ -26,7 +27,7 @@ Flow:
 
 Keys (strict BYOK — checked server-side before anything starts):
   classic (layer 1) memes need your Imgflip login; AI (layer 2/3) memes need
-  your Kie.ai key; captions always need your LLM key. Run \`npx @aicopycoders/exodus doctor\`.
+  your Kie.ai key; captions always need your LLM key. Run \`npx ${pkgRef()} doctor\`.
 
 Examples:
   exodus meme recommend --brief "grounding sheets reduce inflammation"
@@ -114,7 +115,7 @@ async function runRecommend(flags) {
     if (!res.ok) {
         console.error(formatError(res));
         if (res.status === 400) {
-            console.error("Hint: run `npx @aicopycoders/exodus doctor` to check your keys.");
+            console.error(`Hint: run \`npx ${pkgRef()} doctor\` to check your keys.`);
         }
         process.exit(1);
         return;
@@ -171,7 +172,7 @@ async function runRun(flags) {
     if (!res.ok) {
         console.error(formatError(res));
         if (res.status === 400) {
-            console.error("Hint: run `npx @aicopycoders/exodus doctor` to check your keys.");
+            console.error(`Hint: run \`npx ${pkgRef()} doctor\` to check your keys.`);
         }
         process.exit(1);
         return;
@@ -233,7 +234,7 @@ async function runRegenerate(flags) {
     if (!res.ok) {
         console.error(formatError(res));
         if (res.status === 400) {
-            console.error("Hint: run `npx @aicopycoders/exodus doctor` to check your keys.");
+            console.error(`Hint: run \`npx ${pkgRef()} doctor\` to check your keys.`);
         }
         process.exit(1);
         return;

package/dist/commands/migrate.js

@@ -4,6 +4,7 @@ import { execSync } from "node:child_process";
 import { apiGet, apiGetDashboard } from "../lib/client.js";
 import { getActiveBrand, setLayoutVersion, findWorkspaceRoot } from "../lib/state.js";
 import { detectLayout, brandDirFor, ensureBrandDir, BRAND_MARKER_FILE, } from "../lib/layout.js";
+import { pkgRef } from "../lib/channel.js";
 export const helpText = `
 exodus migrate — convert a single-brand install to the multi-brand layout
 
@@ -15,7 +16,7 @@ What it does (one-time, opt-in — updates never force this):
      falling back to the key's bound brand).
   2. Creates a subfolder for it and MOVES your brand-specific files in:
      state/  and  output/  →  <brand>/state/  and  <brand>/output/
-  3. Marks the install as multi-brand. From then on, \`npx @aicopycoders/exodus@latest init\`
+  3. Marks the install as multi-brand. From then on, \`npx ${pkgRef()} init\`
      creates a subfolder for every brand you own, and running a command
      from inside a brand's folder targets that brand automatically.
 
@@ -94,7 +95,7 @@ async function resolveBrand() {
     }
     if (!slug) {
         fail("could not determine which brand this install belongs to.\n" +
-            "  Run `npx @aicopycoders/exodus brand use <slug>` first (or check your network/.env), then re-run `npx @aicopycoders/exodus migrate`.");
+            `  Run \`npx ${pkgRef()} brand use <slug>\` first (or check your network/.env), then re-run \`npx ${pkgRef()} migrate\`.`);
     }
     if (!name) {
         try {
@@ -115,7 +116,7 @@ export async function run(flags) {
     const root = findWorkspaceRoot();
     if (detectLayout(root) === "v2") {
         console.log("✓ Already on the multi-brand layout — nothing to migrate.");
-        console.log("  Run `npx @aicopycoders/exodus@latest init` to sync brand folders.");
+        console.log(`  Run \`npx ${pkgRef()} init\` to sync brand folders.`);
         return;
     }
     const brand = await resolveBrand();
@@ -128,7 +129,7 @@ export async function run(flags) {
     if (conflicts.length > 0) {
         fail(`"${brandDirRel}/" already contains different versions of:\n` +
             conflicts.map((f) => `    ${f}`).join("\n") +
-            "\n  Reconcile or remove them, then re-run `npx @aicopycoders/exodus migrate`. Nothing was changed.");
+            `\n  Reconcile or remove them, then re-run \`npx ${pkgRef()} migrate\`. Nothing was changed.`);
     }
     console.log(`Migrating this install to the multi-brand layout...`);
     console.log(`  brand: ${brand.slug} (${brand.name})`);
@@ -151,8 +152,8 @@ export async function run(flags) {
   Shared files (.env, exodus/, .claude/skills/, references/) did not move.
 
 Next steps:
-  • Run \`npx @aicopycoders/exodus@latest init\` to pull folders for your other brands.
+  • Run \`npx ${pkgRef()} init\` to pull folders for your other brands.
   • Run commands from inside ${brandDirRel}/ to target it automatically,
-    or keep using \`npx @aicopycoders/exodus brand use <slug>\` from anywhere.
+    or keep using \`npx ${pkgRef()} brand use <slug>\` from anywhere.
 `.trimEnd());
 }

package/dist/commands/winners.d.ts

@@ -0,0 +1,10 @@
+export declare const helpText: string;
+export interface LocalValidation {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+    winnerCount: number;
+}
+export declare function validatePackageLocally(pkg: unknown): LocalValidation;
+export declare function contentTypeFor(filePath: string): string;
+export declare function run(flags: Record<string, string | boolean>): Promise<void>;

package/dist/commands/winners.js

@@ -0,0 +1,401 @@
+import fs from "node:fs";
+import path from "node:path";
+import { apiGet, apiPost } from "../lib/client.js";
+import { formatError } from "../lib/format.js";
+import { pollUntilDone } from "../lib/poll.js";
+export const helpText = `
+exodus winners — Import your own brand's winning ads as generative fuel
+
+Your agent (holding the Meta Ads MCP) assembles a winner-package JSON of
+designated ad-account winners; this command pushes it into Exodus. Each
+winner lands as a swipe row under an auto-created own-brand entry, enriched
+server-side (Ad Library match → scrape, or your pushed media files), and
+surfaces in generation selection with its verdict.
+
+Usage:
+  exodus winners import <file.json | ->        Push a winner package (- reads stdin)
+  exodus winners status <importId>             Re-poll an import later
+  exodus winners list                          Winners Exodus already holds
+
+Import flags:
+  --dry-run      Local schema check + server dry-run: reports would-create vs
+                 would-update per winner. Zero writes, no media upload.
+  --no-wait      Return the importId immediately instead of polling
+  --json         Machine-readable JSON output
+
+Notes:
+  • Scopes to your active brand's workspace (exodus brand current).
+  • Requires your Scrape Creators API key (Settings → Keys) — the own-page
+    match scrape bills your account.
+  • Re-pushing the same file is safe: no duplicate rows, the verdict snapshot
+    is replaced wholesale, and previously gap-filled winners that now match
+    upgrade in place. Winners absent from a re-push are untouched.
+  • assets paths in the package resolve relative to the JSON file's folder.
+
+Examples:
+  exodus winners import winners.json
+  exodus winners import winners.json --dry-run
+  cat winners.json | exodus winners import -
+  exodus winners status k97abc...
+  exodus winners list
+`.trim();
+export function validatePackageLocally(pkg) {
+    const errors = [];
+    const warnings = [];
+    let winnerCount = 0;
+    if (pkg === null || typeof pkg !== "object") {
+        return { ok: false, errors: ["package is not a JSON object"], warnings, winnerCount };
+    }
+    const p = pkg;
+    if (p.version !== 1)
+        errors.push("version must be 1");
+    const source = (p.source ?? {});
+    if (typeof source.pageId !== "string" || !source.pageId.trim())
+        errors.push("source.pageId is required (the scrape target + own-brand key)");
+    if (typeof source.pageName !== "string" || !source.pageName.trim())
+        errors.push("source.pageName is required (names the own-brand entry)");
+    if (typeof source.adAccountId !== "string" || !source.adAccountId.trim())
+        errors.push("source.adAccountId is required");
+    if (!Array.isArray(p.winners) || p.winners.length === 0) {
+        errors.push("winners array is required and must be non-empty");
+        return { ok: errors.length === 0, errors, warnings, winnerCount };
+    }
+    winnerCount = p.winners.length;
+    const seen = new Set();
+    p.winners.forEach((raw, i) => {
+        const label = `winner #${i + 1}`;
+        if (raw === null || typeof raw !== "object") {
+            warnings.push(`${label}: not an object — the server will reject it`);
+            return;
+        }
+        const w = raw;
+        const id = typeof w.accountAdId === "string" ? w.accountAdId : undefined;
+        if (!id)
+            warnings.push(`${label}: missing accountAdId`);
+        else if (seen.has(id))
+            warnings.push(`${label} (${id}): duplicate accountAdId`);
+        else
+            seen.add(id);
+        if (w.format !== "video" && w.format !== "image")
+            warnings.push(`${label}${id ? ` (${id})` : ""}: format must be "video" or "image"`);
+        const verdict = (w.verdict ?? {});
+        if (typeof verdict.sentence !== "string" || !verdict.sentence.trim())
+            warnings.push(`${label}${id ? ` (${id})` : ""}: missing verdict.sentence`);
+        if ((typeof w.bodyText !== "string" || !w.bodyText.trim()) &&
+            (typeof w.headline !== "string" || !w.headline.trim()))
+            warnings.push(`${label}${id ? ` (${id})` : ""}: needs bodyText or headline`);
+    });
+    return { ok: errors.length === 0, errors, warnings, winnerCount };
+}
+export function contentTypeFor(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const map = {
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".png": "image/png",
+        ".webp": "image/webp",
+        ".gif": "image/gif",
+        ".mp4": "video/mp4",
+        ".m4v": "video/mp4",
+        ".mov": "video/quicktime",
+        ".webm": "video/webm",
+    };
+    return map[ext] ?? "application/octet-stream";
+}
+export async function run(flags) {
+    const positional = parsePositional();
+    const [sub, ...rest] = positional;
+    if (sub === "import")
+        return runImport(rest, flags);
+    if (sub === "status")
+        return runStatus(rest, flags);
+    if (sub === "list")
+        return runList(flags);
+    if (!sub) {
+        console.log(helpText);
+        return;
+    }
+    console.error(`Unknown subcommand: "${sub}"\n`);
+    console.log(helpText);
+    process.exit(1);
+}
+function parsePositional() {
+    return process.argv.slice(3).filter((a) => !a.startsWith("--"));
+}
+async function runImport(positional, flags) {
+    const json = !!flags["json"];
+    const dryRun = !!flags["dry-run"] || !!flags["dryRun"];
+    const noWait = flags["wait"] === false || flags["no-wait"] === true;
+    const fileArg = positional[0];
+    if (!fileArg) {
+        console.error("Error: a package file is required (or - for stdin)");
+        console.log("Usage: exodus winners import <file.json | ->");
+        process.exit(1);
+    }
+    let rawText;
+    let baseDir;
+    if (fileArg === "-") {
+        rawText = fs.readFileSync(0, "utf-8");
+        baseDir = process.cwd();
+    }
+    else {
+        if (!fs.existsSync(fileArg)) {
+            console.error(`Error: file not found: ${fileArg}`);
+            process.exit(1);
+        }
+        rawText = fs.readFileSync(fileArg, "utf-8");
+        baseDir = path.dirname(path.resolve(fileArg));
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(rawText);
+    }
+    catch (err) {
+        console.error(`Error: package is not valid JSON: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+    const validation = validatePackageLocally(pkg);
+    if (!validation.ok) {
+        if (json) {
+            console.log(JSON.stringify({ ok: false, errors: validation.errors }));
+        }
+        else {
+            console.error("Package failed local validation:");
+            for (const e of validation.errors)
+                console.error(`  • ${e}`);
+        }
+        process.exit(1);
+    }
+    if (!json) {
+        for (const w of validation.warnings)
+            console.error(`Warning: ${w}`);
+    }
+    const winners = (pkg.winners ?? []).filter((w) => w !== null && typeof w === "object");
+    const missingFiles = [];
+    for (const w of winners) {
+        const assets = (w.assets ?? {});
+        for (const key of ["imagePath", "videoPath", "posterPath"]) {
+            const p = assets[key];
+            if (typeof p === "string" && p.trim() && !fs.existsSync(path.resolve(baseDir, p))) {
+                missingFiles.push(p);
+            }
+        }
+    }
+    if (!dryRun && missingFiles.length > 0) {
+        console.error("Error: referenced asset file(s) not found:");
+        for (const f of missingFiles)
+            console.error(`  • ${f}`);
+        process.exit(1);
+    }
+    if (dryRun) {
+        const res = await apiPost("/api/v2/winners", {
+            ...pkg,
+            dryRun: true,
+        });
+        if (!res.ok) {
+            if (json)
+                console.log(JSON.stringify({ ok: false, status: res.status, data: res.data }));
+            else
+                console.log(formatError(res));
+            process.exit(1);
+        }
+        if (json) {
+            console.log(JSON.stringify({ ok: true, ...res.data, localWarnings: validation.warnings }));
+            return;
+        }
+        const per = res.data.perWinner ?? [];
+        const creates = per.filter((p) => p.action === "create").length;
+        const updates = per.filter((p) => p.action === "update").length;
+        console.log("Dry run — no writes, no Trigger fire, no media upload.");
+        console.log(res.data.wouldCreateBrand
+            ? "  own-brand entry: would be created"
+            : `  own-brand entry: exists (${res.data.brandName ?? "?"})`);
+        console.log(`  winners: ${creates} would-create, ${updates} would-update`);
+        for (const p of per)
+            console.log(`    ${p.accountAdId}  ${p.action}`);
+        for (const r of res.data.rejected ?? []) {
+            console.log(`    ${r.accountAdId}  would-reject (${r.reason})`);
+        }
+        if (res.data.scrapecreatorsKey === "missing") {
+            console.log("\nHeads up: no Scrape Creators key on your account — a real import will fail.");
+            console.log("Add it in Settings → Keys (get one at scrapecreators.com).");
+        }
+        return;
+    }
+    for (const w of winners) {
+        const assets = (w.assets ?? {});
+        const swapped = {};
+        const pairs = [
+            ["imagePath", "imageStorageId"],
+            ["videoPath", "videoStorageId"],
+            ["posterPath", "posterStorageId"],
+        ];
+        for (const [pathKey, idKey] of pairs) {
+            const rel = assets[pathKey];
+            if (typeof rel !== "string" || !rel.trim())
+                continue;
+            const abs = path.resolve(baseDir, rel);
+            const storageId = await uploadAsset(abs, json);
+            if (!storageId)
+                process.exit(1);
+            swapped[idKey] = storageId;
+        }
+        if (Object.keys(swapped).length > 0) {
+            w.assets = swapped;
+        }
+        else {
+            delete w.assets;
+        }
+    }
+    const res = await apiPost("/api/v2/winners", pkg);
+    if (!res.ok || !res.data.importId) {
+        if (json)
+            console.log(JSON.stringify({ ok: false, status: res.status, data: res.data }));
+        else
+            console.log(formatError(res));
+        process.exit(1);
+    }
+    const importId = res.data.importId;
+    if (noWait) {
+        if (json) {
+            console.log(JSON.stringify({ ok: true, importId, triggerRunId: res.data.triggerRunId, accepted: res.data.accepted, rejected: res.data.rejected }));
+            return;
+        }
+        console.log(`Import started: ${importId}`);
+        console.log(`  accepted: ${res.data.accepted ?? "?"} winner(s)`);
+        for (const r of res.data.rejected ?? []) {
+            console.log(`  rejected: ${r.accountAdId} (${r.reason})`);
+        }
+        console.log(`\nPoll: exodus winners status ${importId}`);
+        return;
+    }
+    if (!json) {
+        console.log(`Import started: ${importId} — waiting for outcomes…`);
+    }
+    let lastStatus = "";
+    const poll = await pollUntilDone({
+        path: `/api/v2/winners/imports/${importId}`,
+        terminalStatuses: ["done"],
+        onProgress: (data) => {
+            const status = typeof data.status === "string" ? data.status : "";
+            if (!json && status && status !== lastStatus) {
+                lastStatus = status;
+                console.log(`  status: ${status}`);
+            }
+        },
+    });
+    const outcome = poll.data;
+    if (json) {
+        console.log(JSON.stringify({ ok: poll.ok, timedOut: poll.timedOut, ...outcome }));
+        if (!poll.ok)
+            process.exit(1);
+        return;
+    }
+    if (poll.timedOut) {
+        console.log(`Timed out waiting. Re-poll: exodus winners status ${importId}`);
+        process.exit(1);
+    }
+    printOutcomeTable(outcome);
+    if (!poll.ok)
+        process.exit(1);
+}
+async function uploadAsset(absPath, json) {
+    const upRes = await apiPost("/api/v2/winners/upload-url", {});
+    if (!upRes.ok || !upRes.data.uploadUrl) {
+        if (json)
+            console.log(JSON.stringify({ ok: false, step: "upload-url", data: upRes.data }));
+        else
+            console.log(formatError(upRes));
+        return null;
+    }
+    const bytes = fs.readFileSync(absPath);
+    const put = await fetch(upRes.data.uploadUrl, {
+        method: "POST",
+        headers: { "Content-Type": contentTypeFor(absPath) },
+        body: new Blob([bytes]),
+    });
+    if (!put.ok) {
+        const text = await put.text().catch(() => "(unreadable)");
+        if (json)
+            console.log(JSON.stringify({ ok: false, step: "upload", status: put.status }));
+        else
+            console.error(`Error uploading ${path.basename(absPath)}: ${put.status} ${text.slice(0, 200)}`);
+        return null;
+    }
+    const { storageId } = (await put.json());
+    if (!storageId) {
+        console.error(`Error: no storageId returned for ${path.basename(absPath)}`);
+        return null;
+    }
+    if (!json)
+        console.log(`  uploaded ${path.basename(absPath)}`);
+    return storageId;
+}
+function printOutcomeTable(data) {
+    const winners = data.winners ?? [];
+    console.log(`\nImport ${data.importId ?? "?"}: ${data.status ?? "?"}`);
+    if (data.error)
+        console.log(`  error: ${data.error}`);
+    const created = winners.filter((w) => w.created === true).length;
+    const updated = winners.filter((w) => w.created === false).length;
+    console.log(`  ${winners.length} winner(s): ${created} created, ${updated} updated`);
+    for (const w of winners) {
+        let detail = "";
+        if (w.outcome === "partial" && w.missing?.length)
+            detail = ` (missing: ${w.missing.join(", ")})`;
+        if (w.outcome === "rejected" && w.reason)
+            detail = ` (${w.reason})`;
+        console.log(`    ${w.accountAdId}  ${w.outcome}${detail}`);
+    }
+}
+async function runStatus(positional, flags) {
+    const importId = positional[0];
+    if (!importId) {
+        console.error("Error: importId is required");
+        console.log("Usage: exodus winners status <importId>");
+        process.exit(1);
+    }
+    const json = !!flags["json"];
+    const res = await apiGet(`/api/v2/winners/imports/${encodeURIComponent(importId)}`);
+    if (!res.ok) {
+        if (json)
+            console.log(JSON.stringify({ ok: false, status: res.status, data: res.data }));
+        else
+            console.log(formatError(res));
+        process.exit(1);
+    }
+    if (json) {
+        console.log(JSON.stringify({ ok: true, ...res.data }));
+        return;
+    }
+    printOutcomeTable(res.data);
+}
+async function runList(flags) {
+    const json = !!flags["json"];
+    const res = await apiGet("/api/v2/winners");
+    if (!res.ok) {
+        if (json)
+            console.log(JSON.stringify({ ok: false, status: res.status, data: res.data }));
+        else
+            console.log(formatError(res));
+        process.exit(1);
+    }
+    const winners = res.data.winners ?? [];
+    if (json) {
+        console.log(JSON.stringify({ ok: true, winners }));
+        return;
+    }
+    if (winners.length === 0) {
+        console.log("No imported winners yet. Push some: exodus winners import <file.json>");
+        return;
+    }
+    console.log(`Winners (${winners.length}):`);
+    for (const w of winners) {
+        const status = w.enrichmentStatus === "partial"
+            ? `partial${w.enrichmentMissing?.length ? ` (missing: ${w.enrichmentMissing.join(", ")})` : ""}`
+            : (w.enrichmentStatus ?? "?");
+        const when = w.designatedAt ? new Date(w.designatedAt).toLocaleDateString() : "?";
+        console.log(`  ${w.sourceAdId ?? w.id}  [${w.format}]  ${status}  designated=${when}`);
+        console.log(`    ${w.verdictSentence}`);
+    }
+}