@aicopycoders/exodus 2026.6.2900-beta.6 → 2026.6.2900-beta.8

package/assets/docs/CLAUDE.md

@@ -55,9 +55,9 @@ These are the **Exodus** pipelines — the automatic system that drives the Gene
 | **Write** | `exodus-write` | **Start here for copywriting.** Say what you want ("exodus, write me some ads"); it routes new-brand → foundation → brief → genesis → Doc and sequences the whole flow. |
 | **Genesis** | `exodus-genesis` | Brief → ad copy in two voices (Mario + Infeed). Default 1 pass = 2 variants; scale with `--passes` (pass 2 adds the Top-Ads-biased primer). Also writes from a pasted reel (`--reel`). |
 | **Idea** | `exodus-idea` | The Idea Bank — capture reels/brain-dumps/swipes into formed ideas, curate them, then write the keepers through Genesis. Use when collecting and curating ideas rather than writing one ad on the spot. |
-| **Image** | `exodus-image` | **Start here for static images.** Say what you want; it reads the request and routes to the right engine — `exodus-creative` (renders from copy) or `exodus-template` (33 ad-type formats). |
+| **Image** | `exodus-image` | **Start here for static images.** Say what you want; it reads the request and routes to the right engine — `exodus-creative` (renders from copy) or `exodus-template` (50 ad-type formats). |
 | **Creative** | `exodus-creative` | A specific creative-suite engine (native / copy-derived renders from copy, or ref-match to a reference image) when you've already picked one. Otherwise start at **Image**. |
-| **Template** | `exodus-template` | Finished ad copy → many static ads across 33 structured formats (testimonial, hero, UGC…). Otherwise start at **Image**. |
+| **Template** | `exodus-template` | Finished ad copy → many static ads across 50 structured formats (testimonial, hero, UGC…). Otherwise start at **Image**. |
 | **Meme** | `exodus-meme` | Meme ads — recommends formats for a brief, then one batched run renders AI-image and classic Imgflip-template memes server-side. |
 | **Browse** | `exodus-browse` | View history and retrieve past outputs |
 | **Drive** | `exodus-drive` | Read/write Google Docs, Sheets, and Drive files via `npx @aicopycoders/exodus drive` (uses the dashboard's Google OAuth — no local CLI) |

package/assets/docs/PIPELINES.md

@@ -12,7 +12,7 @@ In Claude Code you don't click buttons. You say **"exodus"** plus what you want
 | exodus-genesis | Brief → Ad Copy (two voices; 1 pass = 2 variants, scalable via --passes) |
 | exodus-image | The front door for static images — routes to exodus-creative or exodus-template. Start here for "make me images / statics". |
 | exodus-creative | Creative-Suite Engines (native / copy-derived / ref-match) — when you've already picked an engine |
-| exodus-template | Ad-Type Format Variations across 33 structured formats |
+| exodus-template | Ad-Type Format Variations across 50 structured formats |
 | exodus-meme | Meme Ad Generator — recommend formats, one batched server-side run |
 | exodus-browse | View History and Surface the Right Run |
 | exodus-drive | Google Drive, Docs, Sheets via the Dashboard's OAuth |
@@ -71,7 +71,7 @@ Examples:
 you want — "exodus, make me some statics from this ad", "exodus, render AD-001" —
 and Claude reads the request and runs the right engine: **exodus-creative**
 (renders straight from copy, or matches a reference image) or **exodus-template**
-(one piece of copy spread across 33 ad-type formats). You don't pick the engine;
+(one piece of copy spread across 50 ad-type formats). You don't pick the engine;
 the request decides it. Use the engines below directly only when you already know
 exactly which one you want.
 
@@ -113,13 +113,13 @@ Auth: Bearer (kickoff via Convex HTTP; status via dashboard route).
 
 ## exodus-template
 
-**What it does:** Turn finished ad copy into many static ad images spread across structured ad-type formats (testimonial, hero, UGC, logo, infographic, and 28 more). Runs Fernando's 5-stage Template pipeline — give it one brief or a numbered list of ads and it generates format variations, then renders them.
+**What it does:** Turn finished ad copy into many static ad images spread across structured ad-type formats (testimonial, hero, UGC, logo, infographic, and 45 more). Runs Fernando's 5-stage Template pipeline — give it one brief or a numbered list of ads and it generates format variations, then renders them.
 
 ```operator-guide
 Subcommands:
   exodus template run --input "<text>" [options]   Kick off a run
   exodus template resume --id <runId>              Finalize an orphaned run (#56)
-  exodus template ad-types                          Print the 33 AD_TYPES
+  exodus template ad-types                          Print all 50 AD_TYPES
   exodus template reptile-triggers                  Print the 13 reptile triggers
 
 run options:

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

@@ -1,13 +1,14 @@
 ---
 name: exodus-template
-description: Spread finished ad copy across structured ad-type formats — testimonial, hero, UGC, logo, infographic, and 28 more — via Fernando's 5-stage Exodus Template pipeline (one brief or a numbered list of ads → format variations → renders). Only invoke when the user has explicitly invoked Exodus AND the ask is specifically about FORMAT COVERAGE: they said "exodus" in the request ("exodus template ads", "exodus, spread this copy across the 33 ad types", "exodus, give me testimonial + hero + UGC versions"), named this skill or /exodus-template, ran an `npx @aicopycoders/exodus template` command, or the `exodus` hub skill routed here. Never claim generic format requests ("template ads", "spread this copy across formats") — in shared folders those may belong to the user's other tools; if the user did not say exodus, this skill is not for them. For an unsure "exodus, just make me images / statics" ask, start at the `exodus-image` front door — it reads the request and routes here. For native / copy-derived / reference-match renders use `exodus-creative`; for meme formats use `exodus-meme`.
+description: Spread finished ad copy across structured ad-type formats — testimonial, hero, UGC, logo, infographic, and 45 more — via Fernando's 5-stage Exodus Template pipeline (one brief or a numbered list of ads → format variations → renders). Only invoke when the user has explicitly invoked Exodus AND the ask is specifically about FORMAT COVERAGE: they said "exodus" in the request ("exodus template ads", "exodus, spread this copy across the 50 ad types", "exodus, give me testimonial + hero + UGC versions"), named this skill or /exodus-template, ran an `npx @aicopycoders/exodus template` command, or the `exodus` hub skill routed here. Never claim generic format requests ("template ads", "spread this copy across formats") — in shared folders those may belong to the user's other tools; if the user did not say exodus, this skill is not for them. For an unsure "exodus, just make me images / statics" ask, start at the `exodus-image` front door — it reads the request and routes here. For native / copy-derived / reference-match renders use `exodus-creative`; for meme formats use `exodus-meme`.
 ---
 
 ```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 the 33 AD_TYPES
+  exodus template ad-types                          Print all 50 AD_TYPES
   exodus template reptile-triggers                  Print the 13 reptile triggers
 
 run options:
@@ -27,13 +28,14 @@ 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)
 
-Reach for this when the user has **finished ad copy** and wants it turned into a spread of **static image ads across structured formats** — testimonial, hero, UGC, infographic, logo, and the rest of the 33 AD_TYPES. The pipeline reads the copy, decides (or is told) which formats to produce, writes a render prompt per format, and renders the images.
+Reach for this when the user has **finished ad copy** and wants it turned into a spread of **static image ads across structured formats** — testimonial, hero, UGC, infographic, logo, and the rest of the 50 AD_TYPES. The pipeline reads the copy, decides (or is told) which formats to produce, writes a render prompt per format, and renders the images.
 
 This is the **format-coverage** tool. It is not engine-based rendering (that's `exodus-creative`: native / copy-derived / ref-match).
 
@@ -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).
-- 33 AD_TYPES and 13 reptile triggers are inspectable via `exodus template ad-types` / `exodus template reptile-triggers`.
+- 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

@@ -2,10 +2,11 @@ import { apiGet, apiPost, apiPostDashboard, getDashboardUrl } from "../lib/clien
 import { formatError } from "../lib/format.js";
 import { AD_TYPES, AD_TYPE_NAMES, REPTILE_TRIGGERS, } from "../lib/template-constants.js";
 export const helpText = `
-exodus template — Fernando's Template pipeline (33 AD_TYPES, resume)
+exodus template — Fernando's Template pipeline (${AD_TYPES.length} AD_TYPES, resume)
 
 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/dist/lib/template-constants.d.ts

@@ -1,4 +1,4 @@
-export declare const AD_TYPES: readonly ["before-after", "native-news", "testimonial", "bold", "meme", "screenshot", "hero", "holding-sign", "handwritten", "comment", "breaking-news", "lofi", "comparison", "infographic", "headline", "collage", "product-breakdown", "scientific", "animation", "founder-note", "carousel", "statistics", "post-it-notes", "happy-avatar", "problem-solution", "writing-on-body", "multi-testimonial", "receipt", "step-by-step", "sale-promotional-offer", "cost-of-inaction", "ugc", "quiz-interactive"];
+export declare const AD_TYPES: readonly ["before-after", "native-news", "testimonial", "bold", "meme", "screenshot", "hero", "holding-sign", "handwritten", "comment", "breaking-news", "lofi", "comparison", "infographic", "headline", "collage", "product-breakdown", "scientific", "animation", "founder-note", "carousel", "statistics", "post-it-notes", "happy-avatar", "problem-solution", "writing-on-body", "multi-testimonial", "receipt", "step-by-step", "sale-promotional-offer", "cost-of-inaction", "ugc", "quiz-interactive", "action-figure", "at-home-routine", "billboard", "black-and-white", "blurred", "choose", "cutout", "drawing", "facetime", "marker", "notes", "photo", "quadrant", "search", "thumbnail", "xray", "zoom-bubble"];
 export type AdType = (typeof AD_TYPES)[number];
 export declare const AD_TYPE_NAMES: Record<AdType, string>;
 export declare const REPTILE_TRIGGERS: readonly ["ultra-real", "bizarre", "voyeur", "suffering", "gory", "sexual", "primal-fear", "odd-contrast", "inside-joke", "time-warp", "victory-lap", "selfie", "uncanny-objects"];

package/dist/lib/template-constants.js

@@ -32,6 +32,23 @@ export const AD_TYPES = [
     "cost-of-inaction",
     "ugc",
     "quiz-interactive",
+    "action-figure",
+    "at-home-routine",
+    "billboard",
+    "black-and-white",
+    "blurred",
+    "choose",
+    "cutout",
+    "drawing",
+    "facetime",
+    "marker",
+    "notes",
+    "photo",
+    "quadrant",
+    "search",
+    "thumbnail",
+    "xray",
+    "zoom-bubble",
 ];
 export const AD_TYPE_NAMES = {
     "before-after": "Before / After",
@@ -67,6 +84,23 @@ export const AD_TYPE_NAMES = {
     "cost-of-inaction": "Cost of Inaction",
     ugc: "UGC",
     "quiz-interactive": "Quiz / Interactive Self-Selection",
+    "action-figure": "Action Figure",
+    "at-home-routine": "At Home Routine",
+    billboard: "Billboard",
+    "black-and-white": "Black and White",
+    blurred: "Blurred",
+    choose: "Choose",
+    cutout: "Cutout",
+    drawing: "Drawing",
+    facetime: "FaceTime",
+    marker: "Marker",
+    notes: "Notes",
+    photo: "Photo",
+    quadrant: "Quadrant",
+    search: "Search",
+    thumbnail: "Thumbnail",
+    xray: "X-ray",
+    "zoom-bubble": "Zoom Bubble",
 };
 export const REPTILE_TRIGGERS = [
     "ultra-real",

package/package.json

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