@aicopycoders/exodus 2026.6.2400

package/dist/commands/status.js

@@ -0,0 +1,205 @@
+import { apiGet } from "../lib/client.js";
+import { formatGeneration, formatGenesisRun, formatError } from "../lib/format.js";
+import { hydrateScoutIdeasCount } from "../lib/scout-hydrate.js";
+import { formatIntelResult as formatIntelResultRich } from "../lib/intel-format.js";
+export const helpText = `
+exodus status — Check the status of a pipeline run
+
+Usage:
+  exodus status --id <runId> [--type <pipeline>]
+
+Required:
+  --id <runId>           The generation or run ID returned by a prior exodus command
+
+Options:
+  --type <pipeline>      Pipeline type: generation (default) | genesis | intel | pulse | scout
+                         | creative | template
+                         Spark, Viral, Mirror, Remix runs use --type generation (default).
+                         Intel, Pulse, Scout require --type intel|pulse|scout.
+                         Creative-suite (native/copy-derived/ref-match/meme)
+                         use --type creative; Template uses --type template.
+`.trim();
+async function fetchScoutIdeasCount(runId) {
+    const res = await apiGet(`/api/v2/scout/ideas?runId=${runId}&limit=1`);
+    if (res.ok && typeof res.data.count === "number")
+        return res.data.count;
+    return null;
+}
+export function formatIntelResult(data) {
+    return formatIntelResultRich(data).replace("## Intel Analysis Result", "## Intel Status");
+}
+export function formatPulseResult(data) {
+    const lines = [];
+    lines.push("## Pulse Status");
+    lines.push(`**Status:** ${data["status"] ?? "unknown"}`);
+    if (data["accountId"])
+        lines.push(`**Account ID:** ${data["accountId"]}`);
+    if (data["commentsAnalyzed"] !== undefined)
+        lines.push(`**Comments Analyzed:** ${data["commentsAnalyzed"]}`);
+    if (data["summary"])
+        lines.push(`**Summary:** ${data["summary"]}`);
+    if (data["phase1DocUrl"])
+        lines.push(`**Phase 1 Doc:** ${data["phase1DocUrl"]}`);
+    if (data["phase2DocUrl"])
+        lines.push(`**Phase 2 Doc:** ${data["phase2DocUrl"]}`);
+    if (data["reportUrl"])
+        lines.push(`**Report URL:** ${data["reportUrl"]}`);
+    if (data["error"])
+        lines.push(`**Error:** ${data["error"]}`);
+    const ideas = data["ideas"];
+    if (Array.isArray(ideas) && ideas.length > 0) {
+        lines.push(`\n**Ideas (${ideas.length}):**`);
+        for (const idea of ideas) {
+            if (typeof idea === "object" && idea !== null) {
+                const i = idea;
+                lines.push(`  ${i["id"] ?? "?"} — ${i["name"] ?? i["title"] ?? i["idea"] ?? "(untitled)"}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+export function formatScoutResult(data) {
+    const lines = [];
+    lines.push("## Scout Status");
+    lines.push(`**Status:** ${data["status"] ?? "unknown"}`);
+    const pipelineSlug = data["pipelineSlug"];
+    if (pipelineSlug)
+        lines.push(`**Pipeline:** ${pipelineSlug}`);
+    const mode = data["mode"];
+    if (mode)
+        lines.push(`**Mode:** ${mode}`);
+    const ideasGenerated = data["ideasGenerated"] ?? data["ideaCount"];
+    if (ideasGenerated !== undefined)
+        lines.push(`**Ideas Generated:** ${ideasGenerated}`);
+    const ideas = data["ideas"];
+    const ideasArr = Array.isArray(ideas)
+        ? ideas.filter((i) => typeof i === "object" && i !== null)
+        : [];
+    const docIdeas = ideasArr.filter((i) => typeof i["googleDocUrl"] === "string" && i["googleDocUrl"].length > 0);
+    if (docIdeas.length === 1) {
+        lines.push(`**Doc:** ${docIdeas[0]["googleDocUrl"]}`);
+    }
+    const sheetUrl = data["sheetUrl"];
+    if (sheetUrl)
+        lines.push(`**Sheet:** ${sheetUrl}`);
+    const sheetError = data["sheetError"];
+    if (!sheetUrl && sheetError)
+        lines.push(`**Sheet error:** ${sheetError}`);
+    if (ideasArr.length > 0) {
+        lines.push("");
+        lines.push(`**Ideas (${ideasArr.length}):**`);
+        for (const i of ideasArr) {
+            const status = String(i["status"] ?? "?");
+            const username = i["sourceUsername"] ?? "";
+            const hook = i["hook"] ?? "";
+            const docUrl = i["googleDocUrl"];
+            const pipelineError = i["pipelineError"];
+            const label = hook || username || i["sourceUrl"] || "(idea)";
+            const truncated = label.length > 80 ? `${label.slice(0, 80)}…` : label;
+            lines.push(`  • [${status}] ${truncated}`);
+            if (docUrl)
+                lines.push(`    ${docUrl}`);
+            else if (pipelineError)
+                lines.push(`    error: ${pipelineError}`);
+        }
+    }
+    const scanSteps = data["scanSteps"];
+    if (Array.isArray(scanSteps) && scanSteps.length > 0) {
+        lines.push("");
+        lines.push("Scan breakdown:");
+        for (const step of scanSteps) {
+            if (typeof step === "object" && step !== null) {
+                const s = step;
+                const label = String(s["label"] ?? s["key"] ?? "step");
+                const detail = s["detail"] ? ` — ${s["detail"]}` : "";
+                lines.push(`  ${label.padEnd(20)}${detail}`);
+            }
+        }
+    }
+    if (data["error"])
+        lines.push(`**Error:** ${data["error"]}`);
+    return lines.join("\n");
+}
+export function formatCreativeSuiteStatus(title, data) {
+    const lines = [];
+    lines.push(`## ${title}`);
+    lines.push(`**Status:** ${data["status"] ?? "unknown"}`);
+    const show = (label, key) => {
+        const v = data[key];
+        if (v !== undefined && v !== null && v !== "")
+            lines.push(`**${label}:** ${v}`);
+    };
+    show("Engine", "engine");
+    show("Mode", "mode");
+    show("Render mode", "renderMode");
+    show("Concepts", "totalConcepts");
+    show("Detected ads", "detectedAdCount");
+    if (data["totalImages"] !== undefined) {
+        lines.push(`**Images:** ${data["completedImages"] ?? 0}/${data["totalImages"]}`);
+    }
+    if (data["completedImageCount"] !== undefined) {
+        const failed = data["failedImageCount"] ? ` (${data["failedImageCount"]} failed)` : "";
+        lines.push(`**Images:** ${data["completedImageCount"]}${failed}`);
+    }
+    show("Final video", "finalVideoUrl");
+    show("Video", "videoUrl");
+    show("Cost (cents)", "totalCostCents");
+    if (data["errorMessage"])
+        lines.push(`**Error:** ${data["errorMessage"]}`);
+    else if (data["error"])
+        lines.push(`**Error:** ${data["error"]}`);
+    return lines.join("\n");
+}
+export async function run(flags) {
+    const id = flags["id"];
+    if (!id || typeof id !== "string") {
+        console.error("Error: --id <runId> is required");
+        process.exit(1);
+    }
+    const type = flags["type"] ?? "generation";
+    const pathMap = {
+        generation: `/api/v2/generations?id=${id}`,
+        genesis: `/api/v2/genesis?id=${id}`,
+        intel: `/api/v2/intel?id=${id}`,
+        pulse: `/api/v2/pulse?id=${id}`,
+        scout: `/api/v2/scout?runId=${id}`,
+        creative: `/api/v2/creative?runId=${id}`,
+        template: `/api/v2/template?runId=${id}`,
+    };
+    const path = pathMap[type];
+    if (!path) {
+        console.error(`Unknown type: "${type}". Valid types: generation, genesis, intel, pulse, scout, creative, template`);
+        process.exit(1);
+    }
+    const res = await apiGet(path);
+    if (!res.ok) {
+        console.log(formatError(res));
+        process.exit(1);
+    }
+    if (type === "scout") {
+        await hydrateScoutIdeasCount(id, res.data, fetchScoutIdeasCount);
+    }
+    switch (type) {
+        case "generation":
+            console.log(formatGeneration(res.data));
+            break;
+        case "genesis":
+            console.log(formatGenesisRun(res.data));
+            break;
+        case "intel":
+            console.log(formatIntelResult(res.data));
+            break;
+        case "pulse":
+            console.log(formatPulseResult(res.data));
+            break;
+        case "scout":
+            console.log(formatScoutResult(res.data));
+            break;
+        case "creative":
+            console.log(formatCreativeSuiteStatus("Creative Suite Status", res.data));
+            break;
+        case "template":
+            console.log(formatCreativeSuiteStatus("Template Status", res.data));
+            break;
+    }
+}

package/dist/commands/swipe.d.ts

@@ -0,0 +1,2 @@
+export declare const helpText: string;
+export declare function run(flags: Record<string, string | boolean>): Promise<void>;

package/dist/commands/swipe.js

@@ -0,0 +1,398 @@
+import fs from "node:fs";
+import { apiGet, apiPost } from "../lib/client.js";
+import { formatError } from "../lib/format.js";
+export const helpText = `
+exodus swipe — Swipe pipeline lifecycle + competitor watchlist
+
+The Swipe pipeline produces a weekly Google Doc per brand of Mirror-style
+creative inspired by your watchlist's top competitor ads.
+
+Usage:
+  exodus swipe run                                       Trigger a run for the active brand
+  exodus swipe mine [--batch N]                          Scrape watchlist competitors (default batch=50)
+  exodus swipe status <runId>                            Poll a run by id
+  exodus swipe latest                                    Show the latest run for the active brand
+  exodus swipe history [--limit N]                       Show recent runs (default 20, max 100)
+
+  exodus swipe brands list                               Show the watchlist
+  exodus swipe brands add "<Name>" [flags]               Add a competitor
+  exodus swipe brands remove <id>                        Remove a competitor (use 'list' to find id)
+  exodus swipe brands toggle <id>                        Pause / resume a competitor
+  exodus swipe brands bulk-import <csvFile>              Bulk add from CSV
+
+Lifecycle flags:
+  --json                                                 Machine-readable JSON output (lifecycle subcommands)
+  --batch <n>                                            Watchlist batch size for 'mine' (1-500, default 50)
+
+Brand-add flags:
+  --ig <handle>           Instagram handle (@ optional)
+  --fb <pageId>           Facebook page ID
+  --website <url>         Brand site (optional)
+  --cat <category>        Free-form category
+  --youtube <handle>      YouTube handle (@ optional)
+
+Notes:
+  • All operations scope to your active brand. Check with: exodus brand current
+  • 'swipe run' returns the runId immediately; the pipeline runs async.
+    Poll with 'swipe status <id>' or call 'swipe latest' once done.
+  • Brand watchlist drives selection. Pausing a brand stops new scrapes
+    without losing history. Removing deletes the entry — past ads remain.
+  • CSV format: name,igHandle,fbPageId,category[,website][,youtubeHandle]
+
+Examples:
+  exodus swipe run
+  exodus swipe status qn7eccmtrq3cn0khz6wpcaeyf186jn97
+  exodus swipe latest --json
+  exodus swipe brands list
+  exodus swipe brands add "AG1" --ig drinkag1 --fb 123456789 --cat supplements
+`.trim();
+export async function run(flags) {
+    const positional = parsePositional();
+    const [sub, ...rest] = positional;
+    if (sub === "run")
+        return runRunPipeline(flags);
+    if (sub === "mine")
+        return runMinePipeline(flags);
+    if (sub === "status")
+        return runStatus(rest, flags);
+    if (sub === "latest")
+        return runLatest(flags);
+    if (sub === "history")
+        return runHistory(flags);
+    if (sub === "brands") {
+        const [brandSub, ...brandRest] = rest;
+        if (!brandSub || brandSub === "list")
+            return runBrandsList();
+        if (brandSub === "add")
+            return runBrandsAdd(brandRest, flags);
+        if (brandSub === "remove")
+            return runBrandsRemove(brandRest);
+        if (brandSub === "toggle")
+            return runBrandsToggle(brandRest);
+        if (brandSub === "bulk-import")
+            return runBrandsBulkImport(brandRest);
+        console.error(`Unknown brands subcommand: "${brandSub}"\n`);
+        console.log(helpText);
+        process.exit(1);
+    }
+    if (!sub) {
+        console.log(helpText);
+        return;
+    }
+    console.error(`Unknown subcommand: "${sub}"\n`);
+    console.log(helpText);
+    process.exit(1);
+}
+function parsePositional() {
+    const args = process.argv.slice(3);
+    const out = [];
+    let i = 0;
+    while (i < args.length) {
+        const a = args[i];
+        if (a.startsWith("--")) {
+            const next = args[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                i += 2;
+            }
+            else {
+                i++;
+            }
+            continue;
+        }
+        out.push(a);
+        i++;
+    }
+    return out;
+}
+async function runRunPipeline(flags) {
+    const json = !!flags["json"];
+    const res = await apiPost("/api/v2/swipe/run", {});
+    if (!res.ok || !res.data.runId) {
+        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, runId: res.data.runId, triggerRunId: res.data.triggerRunId, status: res.data.status }));
+        return;
+    }
+    console.log(`Run started: ${res.data.runId}`);
+    console.log(`  status:        ${res.data.status ?? "selecting"}`);
+    if (res.data.triggerRunId)
+        console.log(`  triggerRunId:  ${res.data.triggerRunId}`);
+    console.log(`\nPoll:    exodus swipe status ${res.data.runId}`);
+    console.log(`Latest:  exodus swipe latest`);
+}
+async function runMinePipeline(flags) {
+    const json = !!flags["json"];
+    const batchRaw = flags["batch"];
+    const batchSize = typeof batchRaw === "string"
+        ? Math.max(1, Math.min(500, parseInt(batchRaw, 10) || 50))
+        : 50;
+    const res = await apiPost("/api/v2/swipe/mine", { batchSize });
+    if (!res.ok || !res.data.triggerRunId) {
+        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, triggerRunId: res.data.triggerRunId, batchSize: res.data.batchSize }));
+        return;
+    }
+    console.log(`Mine started: triggerRunId=${res.data.triggerRunId}`);
+    console.log(`  batchSize:  ${res.data.batchSize ?? batchSize}`);
+    console.log(`\nScrapes the active watchlist sequentially.`);
+    console.log(`Check progress:  exodus swipe brands list`);
+}
+async function runStatus(positional, flags) {
+    const runId = positional[0];
+    if (!runId) {
+        console.error("Error: runId is required");
+        console.log("Usage: exodus swipe status <runId>");
+        process.exit(1);
+    }
+    const json = !!flags["json"];
+    const res = await apiGet(`/api/v2/swipe/status/${encodeURIComponent(runId)}`);
+    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;
+    }
+    printRunStatus(res.data);
+}
+async function runLatest(flags) {
+    const json = !!flags["json"];
+    const res = await apiGet("/api/v2/swipe/latest");
+    if (!res.ok) {
+        if (res.status === 404) {
+            if (json)
+                console.log(JSON.stringify({ ok: false, status: 404, error: "no runs yet" }));
+            else
+                console.log("No swipe runs yet for the active brand. Trigger one: exodus swipe run");
+            process.exit(1);
+        }
+        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;
+    }
+    printRunStatus(res.data);
+    if (!res.data.docUrl && res.data.fallbackMarkdown) {
+        console.log("\nDoc creation failed; fallback markdown follows (first 500 chars):");
+        console.log(res.data.fallbackMarkdown.slice(0, 500));
+    }
+}
+async function runHistory(flags) {
+    const json = !!flags["json"];
+    const limitRaw = flags["limit"];
+    const limit = typeof limitRaw === "string" ? Math.max(1, Math.min(100, parseInt(limitRaw, 10) || 20)) : 20;
+    const res = await apiGet(`/api/v2/swipe/history?limit=${limit}`);
+    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 runs = res.data.runs ?? [];
+    if (json) {
+        console.log(JSON.stringify({ ok: true, runs }));
+        return;
+    }
+    if (runs.length === 0) {
+        console.log("No swipe runs yet. Trigger one: exodus swipe run");
+        return;
+    }
+    console.log(`Recent runs (${runs.length}):`);
+    for (const r of runs) {
+        const when = r.startedAt ? new Date(r.startedAt).toLocaleString() : "?";
+        const doc = r.docUrl ? `  doc=${r.docUrl}` : r.error ? `  error=${r.error}` : "";
+        console.log(`  ${r.runId}  ${r.status}  ads=${r.adsSelectedCount}  by=${r.triggeredBy}  ${when}${doc}`);
+    }
+}
+function printRunStatus(r) {
+    console.log(`Run ${r.runId ?? "?"}`);
+    console.log(`  brand:    ${r.targetBrandSlug ?? "?"}`);
+    console.log(`  status:   ${r.status ?? "?"}`);
+    console.log(`  by:       ${r.triggeredBy ?? "?"}`);
+    console.log(`  ads:      ${r.adsSelectedCount ?? 0}`);
+    if (r.startedAt)
+        console.log(`  started:  ${new Date(r.startedAt).toLocaleString()}`);
+    if (r.completedAt)
+        console.log(`  finished: ${new Date(r.completedAt).toLocaleString()}`);
+    if (r.docUrl)
+        console.log(`  doc:      ${r.docUrl}`);
+    if (r.error)
+        console.log(`  error:    ${r.error}`);
+    if (r.perAdSummary && r.perAdSummary.length > 0) {
+        const done = r.perAdSummary.filter((s) => s.status === "done").length;
+        const failed = r.perAdSummary.filter((s) => s.status === "failed").length;
+        console.log(`  perAd:    ${done} done, ${failed} failed, ${r.perAdSummary.length - done - failed} pending`);
+    }
+}
+async function runBrandsList() {
+    const res = await apiGet("/api/v2/brands");
+    if (!res.ok) {
+        console.log(formatError(res));
+        process.exit(1);
+    }
+    const brands = res.data.brands ?? [];
+    if (brands.length === 0) {
+        console.log("No brands on your watchlist yet.");
+        console.log("Add one:  exodus swipe brands add \"<Brand Name>\" --fb <pageId>");
+        return;
+    }
+    console.log(`Watchlist (${brands.length}):`);
+    for (const b of brands) {
+        const sources = [
+            b.igHandle ? `ig=@${b.igHandle}` : null,
+            b.fbPageId ? `fb=${b.fbPageId}` : null,
+            b.youtubeHandle ? `yt=${b.youtubeHandle}` : null,
+            b.website ? `web=${b.website.replace(/^https?:\/\//, "")}` : null,
+        ]
+            .filter(Boolean)
+            .join("  ");
+        const cat = b.category ? `[${b.category}]` : "";
+        const last = b.lastScrapedAt
+            ? `last=${new Date(b.lastScrapedAt).toLocaleDateString()}`
+            : "never-scraped";
+        console.log(`  ${b.id}  ${b.name} ${cat}`);
+        if (sources)
+            console.log(`    ${sources}`);
+        console.log(`    ${last}`);
+    }
+}
+async function runBrandsAdd(positional, flags) {
+    const name = positional[0];
+    if (!name) {
+        console.error("Error: brand name is required");
+        console.log("Usage: exodus swipe brands add \"<Brand Name>\" [--ig handle] [--fb pageId]");
+        process.exit(1);
+    }
+    const body = { name };
+    const ig = strFlag(flags, "ig");
+    const fb = strFlag(flags, "fb");
+    const website = strFlag(flags, "website");
+    const cat = strFlag(flags, "cat") ?? strFlag(flags, "category");
+    const yt = strFlag(flags, "youtube") ?? strFlag(flags, "yt");
+    if (ig)
+        body.igHandle = ig.replace(/^@/, "");
+    if (fb)
+        body.fbPageId = fb;
+    if (website)
+        body.website = website;
+    if (cat)
+        body.category = cat;
+    if (yt)
+        body.youtubeHandle = yt.replace(/^@/, "");
+    const res = await apiPost("/api/v2/brands", body);
+    if (!res.ok) {
+        console.log(formatError(res));
+        process.exit(1);
+    }
+    console.log(`Added "${name}".`);
+}
+async function runBrandsRemove(positional) {
+    const id = positional[0];
+    if (!id) {
+        console.error("Error: brand id is required (run 'exodus swipe brands list' to find it)");
+        process.exit(1);
+    }
+    const res = await apiPost("/api/v2/brands/remove", { id });
+    if (!res.ok) {
+        console.log(formatError(res));
+        process.exit(1);
+    }
+    console.log(`Removed brand ${id}.`);
+}
+async function runBrandsToggle(positional) {
+    const id = positional[0];
+    if (!id) {
+        console.error("Error: brand id is required (run 'exodus swipe brands list' to find it)");
+        process.exit(1);
+    }
+    const res = await apiPost("/api/v2/brands/toggle", { id });
+    if (!res.ok) {
+        console.log(formatError(res));
+        process.exit(1);
+    }
+    const status = res.data.isActive ? "active" : "paused";
+    console.log(`Brand ${id} now ${status}.`);
+}
+async function runBrandsBulkImport(positional) {
+    const csvPath = positional[0];
+    if (!csvPath) {
+        console.error("Error: csv file path is required");
+        console.log("Usage: exodus swipe brands bulk-import <path-to-csv>");
+        process.exit(1);
+    }
+    if (!fs.existsSync(csvPath)) {
+        console.error(`Error: file not found: ${csvPath}`);
+        process.exit(1);
+    }
+    const text = fs.readFileSync(csvPath, "utf-8");
+    const brands = parseCsv(text);
+    if (brands.length === 0) {
+        console.error("Error: no rows parsed. CSV must have at least one row with a 'name' column.");
+        process.exit(1);
+    }
+    const res = await apiPost("/api/v2/brands/bulk", { brands });
+    if (!res.ok) {
+        console.log(formatError(res));
+        process.exit(1);
+    }
+    console.log(`Imported ${res.data.added ?? 0} new brand(s). Skipped ${res.data.skipped ?? 0} duplicate(s).`);
+}
+function parseCsv(text) {
+    const lines = text
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0 && !l.startsWith("#"));
+    if (lines.length === 0)
+        return [];
+    const headerLine = lines[0];
+    const headers = headerLine.split(",").map((h) => h.trim());
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        const cells = lines[i].split(",").map((c) => c.trim());
+        if (cells.length === 0 || !cells[0])
+            continue;
+        const row = {};
+        for (let j = 0; j < headers.length; j++) {
+            const h = headers[j];
+            const v = cells[j] ?? "";
+            if (!h || !v)
+                continue;
+            if (h === "igHandle" || h === "youtubeHandle") {
+                row[h] = v.replace(/^@/, "");
+            }
+            else {
+                row[h] = v;
+            }
+        }
+        if (row.name)
+            rows.push(row);
+    }
+    return rows;
+}
+function strFlag(flags, key) {
+    const v = flags[key];
+    return typeof v === "string" ? v : undefined;
+}

package/dist/commands/template.d.ts

@@ -0,0 +1,2 @@
+export declare const helpText: string;
+export declare function run(flags: Record<string, string | boolean>): Promise<void>;