@aicopycoders/exodus 2026.6.2900-beta.7 → 2026.6.2900

package/assets/skills/exodus-template/SKILL.md

@@ -6,6 +6,7 @@ description: Spread finished ad copy across structured ad-type formats — testi
 ```operator-guide
 Subcommands:
   exodus template run --input "<text>" [options]   Kick off a run
+  exodus template status --id <runId>              Status + rendered image URLs
   exodus template resume --id <runId>              Finalize an orphaned run (#56)
   exodus template ad-types                          Print all 50 AD_TYPES
   exodus template reptile-triggers                  Print the 13 reptile triggers
@@ -27,8 +28,9 @@ run options:
                         (use `--quantities`).
 
 Returns:
-  runId + dashboard URL. POST-only — there is NO CLI status endpoint yet.
-  Live progress renders in the dashboard at /creative-suite/template/sessions/<runId>.
+  runId + dashboard URL. Kickoff is fire-and-forget; poll with
+  `exodus template status --id <runId>` for status + the rendered image URLs.
+  Live progress also renders in the dashboard at /creative-suite/template/sessions/<runId>.
 ```
 
 # Template — Ad-Type Format Variations (Fernando's pipeline)
@@ -76,11 +78,11 @@ With controls:
 
 **Cheap smoke test:** use `--render-mode prompts` to validate the format selection + prompts without burning render compute, then re-run with `--render-mode images` once the mix looks right.
 
-The command returns a `runId` + dashboard URL and exits — there is **no CLI status polling** for template (the kickoff route is POST-only). Renders land in the dashboard.
+The command returns a `runId` + dashboard URL and exits — kickoff is fire-and-forget. Poll with `exodus template status --id <runId>` to read the status and pull the rendered image URLs once they complete.
 
 ### 3. Report
 
-Per the **Default Post-Run Reporting** rule in `exodus-strategist`: surface the dashboard URL + a 2-line take, then stop. Don't claim the images are done — the CLI only confirms the run *started*; the renders complete asynchronously in the dashboard. Tell the user where to watch: `/creative-suite/template/sessions/<runId>`.
+Per the **Default Post-Run Reporting** rule in `exodus-strategist`: surface the dashboard URL + a 2-line take, then stop. Don't claim the images are done off the kickoff — that only confirms the run *started*; the renders complete asynchronously. Use `exodus template status --id <runId>` to confirm completion and retrieve the render URLs, or point the user to `/creative-suite/template/sessions/<runId>`.
 
 ### 4. Recover an orphaned run
 
@@ -95,12 +97,13 @@ If a previous run's renders stalled or were left incomplete, finalize it:
 - **`--mode manual` without `--quantities`** (or `hybrid` without `--pairings`) errors immediately — supply the required flag.
 - **Unknown ad-type slug** in `--quantities`/`--pairings` errors with the bad slug named. Run `exodus template ad-types` and use the exact slug.
 - **whoami failure** ("Check EXODUS_API_KEY…") means auth/base-URL isn't resolving — run `npx @aicopycoders/exodus doctor`.
-- **No CLI status** — if the user asks "is it done?", point them to the dashboard sessions URL; there is no `exodus status` for template yet. Don't fabricate a status.
+- **Checking status** — if the user asks "is it done?", run `exodus template status --id <runId>`: it returns the run status and the rendered image URLs. Don't fabricate a status; read it.
 - **`--ref-image` is NOT supported in V1** — the Bearer kickoff route doesn't accept reference image ids. If the user wants reference matching, route to the `exodus-creative` skill's ref-match instead.
 
 ## Admin
 
 - Backend: Convex HTTP `POST /api/creative-suite-template/run` (Bearer-auth); Trigger.dev task `creative-suite-template` (Fernando's 5-stage pipeline).
 - 50 AD_TYPES and 13 reptile triggers are inspectable via `exodus template ad-types` / `exodus template reptile-triggers`.
+- Status hits `GET /api/v2/template?runId=<id>` (status + rendered image URLs).
 - Resume hits `POST /api/creative-suite-template/runs/<id>/resume`.
 - Don't echo render prompts or bot system prompts in your reply — that's IP.

package/dist/commands/creative.d.ts

@@ -1,2 +1,11 @@
 export declare const helpText: string;
+interface CreativeImage {
+    url: string;
+    source?: string;
+    cNumber?: string;
+    title?: string;
+    model?: string;
+}
+export declare function formatImageLines(images: CreativeImage[] | undefined): string[];
 export declare function run(flags: Record<string, string | boolean>): Promise<void>;
+export {};

package/dist/commands/creative.js

@@ -186,13 +186,28 @@ async function runStatus(flags) {
     if (d.completedImages !== undefined || d.totalImages !== undefined) {
         console.log(`progress:     ${d.completedImages ?? 0} / ${d.totalImages ?? "?"} completed${d.failedImages ? `, ${d.failedImages} failed` : ""}`);
     }
-    else if (d.imageCount !== undefined) {
+    else if (d.imageCount !== undefined && (!d.images || d.images.length === 0)) {
         console.log(`images:       ${d.imageCount}`);
     }
     if (d.errorMessage)
         console.log(`error:        ${d.errorMessage}`);
+    printImageUrls(d.images);
     console.log(`dashboard:    ${getDashboardUrl()}/creative-suite/runs/${runId}`);
 }
+export function formatImageLines(images) {
+    if (!images || images.length === 0)
+        return [];
+    const lines = [`images:       ${images.length} (URLs below)`];
+    images.forEach((im, i) => {
+        const label = [im.cNumber, im.source].filter(Boolean).join(" · ");
+        lines.push(`  ${String(i + 1).padStart(2)}. ${im.url}${label ? `   (${label})` : ""}`);
+    });
+    return lines;
+}
+function printImageUrls(images) {
+    for (const line of formatImageLines(images))
+        console.log(line);
+}
 export async function run(flags) {
     const sub = process.argv[3] ?? "";
     if (sub === "native") {

package/dist/commands/template.d.ts

@@ -1,2 +1,10 @@
 export declare const helpText: string;
+interface TemplateRender {
+    url: string;
+    adType?: string;
+    status?: string;
+    model?: string;
+}
+export declare function formatRenderLines(renders: TemplateRender[] | undefined): string[];
 export declare function run(flags: Record<string, string | boolean>): Promise<void>;
+export {};

package/dist/commands/template.js

@@ -6,6 +6,7 @@ exodus template — Fernando's Template pipeline (${AD_TYPES.length} AD_TYPES, r
 
 Usage:
   exodus template run --input "<ad brief or numbered ads>" [options]
+  exodus template status --id <runId>
   exodus template resume --id <runId>
   exodus template ad-types
   exodus template reptile-triggers
@@ -20,19 +21,24 @@ Run options:
   --realism off|realistic         Realism enforcement (default: off)
   --quantities <slug:N,slug:N>    Manual-mode per-type counts (e.g. "testimonial:3,hero:2")
   --requested-count N             Auto-mode total render target (optional)
-  --no-wait                       (default — no CLI-side polling endpoint yet)
+  --no-wait                       (default — kickoff is fire-and-forget; poll with status)
+
+Status options:
+  --id <runId>                    Template run to read back (status + render URLs)
 
 Resume options:
   --id <runId>                    Template run id to resume (#56 orphan finalization)
 
-Status polling:
-  The Convex HTTP route is POST-only. View live progress at the dashboard URL
-  printed at kickoff (or the dashboard's /creative-suite/template/sessions list).
+Status:
+  exodus template status --id <runId> prints the run status and the rendered
+  image URLs (GET /api/v2/template). Live progress is also on the dashboard URL
+  printed at kickoff.
 
 Examples:
   exodus template run --input "silver-threaded grounding sheets for inflammation"
   exodus template run --input "..." --aspect 9:16 --model nano-banana-pro --realism realistic
   exodus template run --input "..." --mode manual --quantities "testimonial:3,hero:2,ugc:4"
+  exodus template status --id <runId>
   exodus template resume --id <runId>
   exodus template ad-types
 `.trim();
@@ -167,7 +173,7 @@ async function runTemplate(flags) {
         console.log(`  triggerRunId: ${triggerRunId}`);
     console.log(`  dashboard:    ${dashboardUrlForRun(runId)}`);
     console.log("");
-    console.log("Status updates render live in the dashboard (no CLI status endpoint yet).");
+    console.log(`Poll status + pull render URLs:  exodus template status --id ${runId}`);
 }
 async function runResume(flags) {
     const runId = typeof flags["id"] === "string" ? flags["id"] : undefined;
@@ -193,6 +199,42 @@ async function runResume(flags) {
         console.log(`  triggerRunId:         ${triggerRunId}`);
     console.log(`  dashboard:            ${dashboardUrlForRun(runId)}`);
 }
+export function formatRenderLines(renders) {
+    if (!renders || renders.length === 0)
+        return [];
+    const lines = [`renders:      ${renders.length} (URLs below)`];
+    renders.forEach((r, i) => {
+        lines.push(`  ${String(i + 1).padStart(2)}. ${r.url}${r.adType ? `   (${r.adType})` : ""}`);
+    });
+    return lines;
+}
+async function runStatus(flags) {
+    const runId = typeof flags["id"] === "string" ? flags["id"] : undefined;
+    if (!runId) {
+        console.error("Error: template status requires --id <runId>.");
+        process.exit(1);
+        return;
+    }
+    const res = await apiGet(`/api/v2/template?runId=${encodeURIComponent(runId)}`);
+    if (!res.ok) {
+        console.error(formatError(res));
+        process.exit(1);
+        return;
+    }
+    const d = res.data;
+    console.log(`runId:        ${d._id ?? runId}`);
+    if (d.name)
+        console.log(`name:         ${d.name}`);
+    console.log(`status:       ${d.status ?? "—"}`);
+    if (d.completedImageCount !== undefined || d.requestedImageCount !== undefined) {
+        console.log(`progress:     ${d.completedImageCount ?? 0} / ${d.requestedImageCount ?? "?"} completed${d.failedImageCount ? `, ${d.failedImageCount} failed` : ""}`);
+    }
+    if (d.errorMessage)
+        console.log(`error:        ${d.errorMessage}`);
+    for (const line of formatRenderLines(d.renders))
+        console.log(line);
+    console.log(`dashboard:    ${dashboardUrlForRun(runId)}`);
+}
 export async function run(flags) {
     const sub = process.argv[3] ?? "";
     if (sub === "ad-types") {
@@ -207,12 +249,16 @@ export async function run(flags) {
         await runResume(flags);
         return;
     }
+    if (sub === "status") {
+        await runStatus(flags);
+        return;
+    }
     if (sub === "run") {
         await runTemplate(flags);
         return;
     }
     if (!sub || sub.startsWith("--")) {
-        console.error("Error: template requires a subcommand (run | resume | ad-types | reptile-triggers).");
+        console.error("Error: template requires a subcommand (run | resume | status | ad-types | reptile-triggers).");
         console.error("");
         console.error(helpText);
         process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicopycoders/exodus",
-  "version": "2026.6.2900-beta.7",
+  "version": "2026.6.2900",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",