@aicopycoders/exodus 2026.8.1200 → 2026.8.1400

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

@@ -8,7 +8,7 @@ Core — discover & run:
   exodus workflow list [--json]                              List the brand's saved workflows
   exodus workflow describe <workflowId|name> [--json]        Inputs, prerequisites, outputs
   exodus workflow bots [--category <cat>] [--slug <slug>] [--json]   Bot catalog / one bot's spec
-  exodus workflow run <workflowId|name> [--input key=value ...] [--fill <name>] [--terminal <nodeId> ...] [--auto-approve] [--wait] [--out <dir>] [--json]   Run it
+  exodus workflow run <workflowId|name> [--input key=value ...] [--fill <name>] [--auto-approve] [--wait] [--out <dir>] [--json]   Run it
   exodus workflow status [--id <runId>] [--out <dir>] [--json]   Poll a run / read its outputs
   exodus workflow export <workflowId|name> [--version <n>] [--out <file>] [--json]   Dump the contract (YAML)
 
@@ -50,8 +50,6 @@ Flag notes that add agent-level guidance (everything else is in --help):
                        earlier upload is relayed as-is. Accepted: image PNG/JPEG/
                        WebP/GIF ≤15MB, video MP4/MOV/WebM ≤200MB, audio MP3/M4A/
                        WAV/OGG ≤50MB, document PDF/TXT/MD/DOC/DOCX ≤25MB.
-  --terminal <nodeId>  (run) Repeatable. Scope the run to the upstream closure of
-                       these end node(s); omit to run the whole graph.
   --auto-approve       (run) Send this ONE run off unattended: every Checkpoint it
                        reaches is approved for you, exactly as it stands, and the
                        run records that nobody looked. Without it a Checkpoint
@@ -133,7 +131,7 @@ npx @aicopycoders/exodus workflow run "Product Shots" --input hero=./photos/hero
 
 A bare path is the argument (a leading `@` is accepted and ignored — a file field never text-expands). Accepted files: **image** PNG/JPEG/WebP/GIF ≤15MB · **video** MP4/MOV/WebM ≤200MB · **audio** MP3/M4A/WAV/OGG ≤50MB · **document** PDF/TXT/MD/DOC/DOCX ≤25MB. **Every file you passed is checked first — all of them — before a single byte moves**, so one bad path can't leave the others half-uploaded; you get every problem in one message and fix them in one edit. If an upload itself dies partway, the message names the asset ids that DID land so you can pass those instead of re-uploading them.
 
-There is no file picker and no prompt: a required file input with no `--input` fails immediately, naming the flag to pass — **unless you scoped the run with `--terminal`**, since the file's node may not even be in that slice; there the server decides. If you already uploaded the file on an earlier run, pass the asset id instead of the path and it's relayed as-is.
+There is no file picker and no prompt: a required file input with no `--input` fails immediately, naming the flag to pass. If you already uploaded the file on an earlier run, pass the asset id instead of the path and it's relayed as-is.
 
 One edge case worth knowing: the CLI reads the workflow's input list before it uploads anything. If that read fails (the server is down or flaking) and any value you passed looks like a file path, the run stops right there rather than sending your path as literal text. Retry, or pass an already-uploaded asset id.
 
@@ -149,7 +147,7 @@ npx @aicopycoders/exodus workflow run "Launch Flow" --input brief="new cortisol
 npx @aicopycoders/exodus workflow status --id <runId>
 ```
 
-To run only part of a graph, scope it with `--terminal <nodeId>` (repeatable): only nodes feeding the picked end node(s) execute; the rest are recorded out-of-scope.
+There is no way to run only part of a graph: a run executes the whole workflow or it doesn't start.
 
 **Read the `Deliveries:` block first.** Each Output node on the canvas is a named, typed promise — "Final ad copy · text", "Hero image · asset" — and a finished run answers every one of them: `delivered` with the artifacts underneath, or `unfulfilled` with the reason the upstream node gave. That block is the honest scorecard; the `Outputs:` block below it is the same artifacts as one flat pile, kept for chaining. If a run says `completed` but a slot says `unfulfilled`, the workflow did NOT deliver what it promised — say so.
 

package/dist/commands/workflow.d.ts

@@ -1,6 +1,7 @@
 import { type ApiResponse } from "../lib/client.js";
 import { type PollOptions, type PollResult } from "../lib/poll.js";
 import { LEGACY_WORKFLOW_RUN_STATUS_VALUES, type RunStatus } from "../lib/runStatus.js";
+import { type RunDeliverySummary } from "../lib/runVerdict.js";
 import { type Channel } from "../lib/channel.js";
 export declare const helpText: string;
 export type WorkflowNodeKind = "brief" | "brief-form" | "asset" | "bot" | "primer" | "image" | "image-rig" | "rig" | "storyboard" | "reference" | "scene-frames" | "video" | "voiceover" | "output" | "call" | "show-set" | "show-cast" | "show-voices" | "product-truth" | "transform" | "formatter" | "splitter" | "collector" | "checkpoint" | "prompt";
@@ -140,6 +141,7 @@ export interface WorkflowCatalog {
         nodeKinds: string[];
         briefSources: string[];
         primerKinds: string[];
+        primerAwarenessLanes: string[];
         imageModels: string[];
         aspectRatios: string[];
         imageQuantityModes: string[];
@@ -358,6 +360,7 @@ export interface WorkflowRun {
     nodes: WorkflowRunNode[];
     outputs?: WorkflowRunOutput[];
     deliveries?: WorkflowRunDelivery[];
+    deliverySummary?: RunDeliverySummary;
     sessions?: WorkflowRunSession[];
     pauseReason?: WorkflowPauseReason;
     pausedNodeId?: string;
@@ -400,7 +403,6 @@ export interface FlowResult {
 }
 interface RunFlowOptions {
     inputs: Record<string, string>;
-    terminalNodeIds?: string[];
     fill?: string;
     autoApprove?: boolean;
     imageRigOverrides?: Record<string, unknown>;
@@ -421,7 +423,7 @@ export declare const ASSET_UPLOAD_POLICY: Record<WorkflowMediaType, {
 export declare const NO_DELIVERIES_WARNING: string;
 export declare function noDeliveriesWarning(described: unknown): string | undefined;
 export declare function serverWarningsToPrint(serverWarnings: unknown, alreadyPrinted: string[]): string[];
-export declare function parseTerminalFlags(args: string[]): string[];
+export declare function rejectTerminalFlag(args: string[]): void;
 export declare function parseAutoApproveFlag(args: string[]): boolean;
 export declare function parseRigOverridesFlag(args: string[], readFile?: (path: string) => string): Record<string, unknown> | undefined;
 export declare function parseFillFlag(args: string[]): string | undefined;

package/dist/commands/workflow.js

@@ -4,7 +4,8 @@ import nodePath from "node:path";
 import { apiGet, apiGetText, apiPost, apiPostDashboard, getDashboardUrl, } from "../lib/client.js";
 import { formatApiError } from "../lib/format.js";
 import { pollUntilDone } from "../lib/poll.js";
-import { normalizeRunStatus, runStatusLabel, storedWorkflowStatusForms, workflowRunPresentation, RUN_STATUS_LABELS, TERMINAL_RUN_STATUSES, } from "../lib/runStatus.js";
+import { normalizeRunStatus, storedWorkflowStatusForms, TERMINAL_RUN_STATUSES, } from "../lib/runStatus.js";
+import { runVerdict } from "../lib/runVerdict.js";
 import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
 import { missingRouteLine } from "../lib/route-support.js";
 import { getChannel } from "../lib/channel.js";
@@ -18,7 +19,7 @@ Usage:
   exodus workflow templates [list] [--json]
   exodus workflow templates export <key> [--out <file>] [--json]
   exodus workflow schema [--kind <kind>] [--face <face>] [--json]
-  exodus workflow run <workflowId|name> [--fill <name>] [--input key=value ...] [--input <fileField>=<path> ...] [--terminal <nodeId> ...] [--rig-overrides <json|@file>] [--auto-approve] [--wait] [--out <dir>] [--json]
+  exodus workflow run <workflowId|name> [--fill <name>] [--input key=value ...] [--input <fileField>=<path> ...] [--rig-overrides <json|@file>] [--auto-approve] [--wait] [--out <dir>] [--json]
   exodus workflow status [--id <runId>] [--out <dir>] [--json]
   exodus workflow versions <workflowId|name> [--json]
   exodus workflow export <workflowId|name> [--version <n>] [--out <file>] [--json]
@@ -66,10 +67,6 @@ Flags:
                          lock. Names are exact (case-sensitive); an unknown one
                          is rejected before the run starts. Fills are created and
                          named in the dashboard's run dialog.
-  --terminal <nodeId>    (run) Repeatable. Scope the run to the upstream closure
-                         of these end node(s) — only nodes feeding a picked
-                         terminal execute; the rest are recorded out-of-scope.
-                         Omit to run the whole graph.
   --rig-overrides <json> (run, triggers fire) Change what an Image Rig box fires
                          for THIS ONE run, without editing the saved workflow —
                          a different number of images, a different meme format,
@@ -159,7 +156,6 @@ Examples:
   exodus workflow run "Product Shots" --input hero=https://example.com/hero.png
   exodus workflow run "Launch Flow" --fill "Weekly promo" --wait
   exodus workflow run "Launch Flow" --fill "Weekly promo" --input brief="new offer"
-  exodus workflow run "Launch Flow" --terminal bot-3 --terminal image-2
   exodus workflow run "Launch Flow" --auto-approve --wait
   exodus workflow run "Product Shots" --rig-overrides '{"rig_1":{"lines":{"line_1":{"count":3}}}}'
   exodus workflow run "Product Shots" --rig-overrides @rig.json --wait
@@ -429,17 +425,6 @@ function gateParkedNodeId(status, pauseReason, pausedNodeId) {
     }
     return undefined;
 }
-function runVerdict(run) {
-    const presented = workflowRunPresentation(run.status, run.pauseReason);
-    if ((presented.status === "succeeded" || presented.status === "succeeded-with-warnings") &&
-        (run.counts?.failed ?? 0) > 0 &&
-        run.deliveries !== undefined &&
-        run.deliveries.length > 0 &&
-        !run.deliveries.some((d) => d.status === "delivered")) {
-        return `${RUN_STATUS_LABELS.failed} — nothing delivered`;
-    }
-    return presented.detail ? `${presented.label} — ${presented.detail}` : presented.label;
-}
 const RETIRED_GATE_VERB_POINTER = "The Gate node retired in 2.0 — runs now pause at a Checkpoint box on the canvas. " +
     "Use: exodus workflow checkpoint <runId> [approve|edit|retry|cancel]";
 export function formatPauseNotice(pauseReason, runId, dashboardUrl) {
@@ -732,7 +717,7 @@ export function serverWarningsToPrint(serverWarnings, alreadyPrinted) {
     }
     return out;
 }
-async function prepareRunInputs(workflowId, raw, deps, note, scoped) {
+async function prepareRunInputs(workflowId, raw, deps, note) {
     const described = await deps.get(`${DESCRIBE_PATH}?id=${encodeURIComponent(workflowId)}`);
     if (!described.ok) {
         const fileish = Object.keys(raw).filter((key) => looksLikeFileArgument(raw[key], deps));
@@ -761,16 +746,14 @@ async function prepareRunInputs(workflowId, raw, deps, note, scoped) {
         if (descriptor?.type === "multi-select")
             multiFields.add(descriptor.fieldName);
     }
-    if (!scoped) {
-        const missing = [...assetFields.values()].filter((d) => d.required && (raw[d.fieldName] ?? "").trim() === "");
-        if (missing.length > 0) {
-            const names = missing.map((d) => d.fieldName).join(", ");
-            const first = missing[0];
-            throw new Error(`Missing required file input(s): ${names}. Pass each one as a local file ` +
-                `or a URL — e.g. --input ${first.fieldName}=./path/to/file or ` +
-                `--input ${first.fieldName}=https://…` +
-                (first.assetType ? ` (${acceptedLabel(first.assetType)})` : ""));
-        }
+    const missing = [...assetFields.values()].filter((d) => d.required && (raw[d.fieldName] ?? "").trim() === "");
+    if (missing.length > 0) {
+        const names = missing.map((d) => d.fieldName).join(", ");
+        const first = missing[0];
+        throw new Error(`Missing required file input(s): ${names}. Pass each one as a local file ` +
+            `or a URL — e.g. --input ${first.fieldName}=./path/to/file or ` +
+            `--input ${first.fieldName}=https://…` +
+            (first.assetType ? ` (${acceptedLabel(first.assetType)})` : ""));
     }
     const prepared = {};
     const planned = [];
@@ -829,29 +812,13 @@ async function prepareRunInputs(workflowId, raw, deps, note, scoped) {
     }
     return { inputs: prepared, warnings };
 }
-export function parseTerminalFlags(args) {
-    const ids = [];
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        let raw;
-        if (arg === "--terminal") {
-            raw = args[i + 1];
-            i++;
-        }
-        else if (arg.startsWith("--terminal=")) {
-            raw = arg.slice("--terminal=".length);
-        }
-        else {
-            continue;
+export function rejectTerminalFlag(args) {
+    for (const arg of args) {
+        if (arg === "--terminal" || arg.startsWith("--terminal=")) {
+            throw new Error("--terminal is no longer supported: a run now executes the whole " +
+                "workflow or it doesn't start. Re-run without --terminal.");
         }
-        if (raw === undefined)
-            throw new Error("--terminal requires a node id");
-        const id = raw.trim();
-        if (!id)
-            throw new Error("--terminal requires a node id");
-        ids.push(id);
     }
-    return ids;
 }
 export function parseAutoApproveFlag(args) {
     for (const arg of args) {
@@ -1362,6 +1329,9 @@ function formatBotVocabulary(catalog) {
     lines.push(`  node kinds:    ${v.nodeKinds.join(", ")}`);
     lines.push(`  brief sources: ${v.briefSources.join(", ")}`);
     lines.push(`  primer kinds:  ${v.primerKinds.join(", ")}`);
+    if (v.primerAwarenessLanes?.length) {
+        lines.push(`  body primer awareness lanes (config.primerAwareness, body kind only): ${v.primerAwarenessLanes.join(", ")}`);
+    }
     lines.push(`  image models:  ${v.imageModels.join(", ")}`);
     lines.push(`  aspect ratios: ${v.aspectRatios.join(", ")}`);
     lines.push(`  custom bot:    set a bot node's slug to "${catalog.customBot.slug}" and ` +
@@ -1717,7 +1687,6 @@ export async function runFlow(workflowRef, opts, deps) {
         return resolveIdErrorResult(e, opts.json ?? false);
     }
     const preface = [];
-    const scoped = (opts.terminalNodeIds?.length ?? 0) > 0;
     let prepared;
     try {
         prepared = await prepareRunInputs(workflowId, opts.inputs, deps, (line) => {
@@ -1727,7 +1696,7 @@ export async function runFlow(workflowRef, opts, deps) {
                 opts.onProgressLine(line);
             else
                 preface.push(line);
-        }, scoped);
+        });
     }
     catch (e) {
         const message = e instanceof Error ? e.message : String(e);
@@ -1749,9 +1718,6 @@ export async function runFlow(workflowRef, opts, deps) {
         workflowId,
         ...(Object.keys(inputs).length > 0 ? { inputs } : {}),
         ...(opts.fill && opts.fill.trim() !== "" ? { fill: opts.fill.trim() } : {}),
-        ...(opts.terminalNodeIds && opts.terminalNodeIds.length > 0
-            ? { terminalNodeIds: opts.terminalNodeIds }
-            : {}),
         ...(opts.autoApprove === true ? { autoApprove: true } : {}),
         ...(opts.imageRigOverrides ? { imageRigOverrides: opts.imageRigOverrides } : {}),
         launchedVia: "cli",
@@ -2138,7 +2104,15 @@ export async function triggersSetEnabledFlow(workflowRef, n, enabled, opts, deps
         return triggerErrorResult(res, verb, opts.json);
     if (opts.json)
         return { code: 0, lines: [JSON.stringify(res.data)] };
-    return { code: 0, lines: [`Trigger ${n} ${enabled ? "enabled" : "disabled"}.`] };
+    const lines = [`Trigger ${n} ${enabled ? "enabled" : "disabled"}.`];
+    const warnings = res.data?.warnings;
+    if (Array.isArray(warnings)) {
+        for (const w of warnings) {
+            if (typeof w === "string")
+                lines.push(`  ⚠ ${w}`);
+        }
+    }
+    return { code: 0, lines };
 }
 export async function triggersFireFlow(workflowRef, opts, deps) {
     const verb = "workflow triggers fire";
@@ -2378,7 +2352,7 @@ function asWorkflowRun(data) {
 }
 function describePark(run) {
     if (normalizeRunStatus(run.status) !== "awaiting-approval") {
-        return `status: ${runStatusLabel(run.status)}`;
+        return `status: ${runVerdict(run)}`;
     }
     switch (run.pauseReason) {
         case "taste":
@@ -2872,13 +2846,12 @@ export async function run(flags) {
             process.exit(1);
         }
         let inputs;
-        let terminalNodeIds;
         let fill;
         let autoApprove;
         let imageRigOverrides;
         try {
             inputs = parseRawInputFlags(process.argv.slice(3));
-            terminalNodeIds = parseTerminalFlags(process.argv.slice(3));
+            rejectTerminalFlag(process.argv.slice(3));
             fill = parseFillFlag(process.argv.slice(3));
             autoApprove = parseAutoApproveFlag(process.argv.slice(3));
             imageRigOverrides = parseRigOverridesFlag(process.argv.slice(3), defaultDeps.readFile);
@@ -2889,7 +2862,6 @@ export async function run(flags) {
         }
         return printResult(await runFlow(workflowRef, {
             inputs,
-            terminalNodeIds,
             fill,
             autoApprove,
             imageRigOverrides,

package/dist/lib/runVerdict.d.ts

@@ -0,0 +1,22 @@
+export interface RunDeliverySummary {
+    total: number;
+    delivered: number;
+}
+export interface RunVerdictDelivery {
+    status: string;
+}
+export interface RunVerdictInput {
+    status?: string | null;
+    pauseReason?: string | null;
+    counts?: {
+        done?: number;
+        failed?: number;
+        skipped?: number;
+        total?: number;
+        outOfScope?: number;
+    } | null;
+    deliveries?: readonly RunVerdictDelivery[];
+    deliverySummary?: RunDeliverySummary | null;
+}
+export declare function summarizeDeliveries(deliveries?: readonly RunVerdictDelivery[] | null): RunDeliverySummary | undefined;
+export declare function runVerdict(run: RunVerdictInput): string;

package/dist/lib/runVerdict.js

@@ -0,0 +1,21 @@
+import { RUN_STATUS_LABELS, workflowRunPresentation } from "./runStatus.js";
+export function summarizeDeliveries(deliveries) {
+    if (deliveries === undefined || deliveries === null)
+        return undefined;
+    return {
+        total: deliveries.length,
+        delivered: deliveries.filter((d) => d.status === "delivered").length,
+    };
+}
+export function runVerdict(run) {
+    const presented = workflowRunPresentation(run.status, run.pauseReason);
+    const delivery = summarizeDeliveries(run.deliveries) ?? run.deliverySummary ?? undefined;
+    if ((presented.status === "succeeded" || presented.status === "succeeded-with-warnings") &&
+        (run.counts?.failed ?? 0) > 0 &&
+        delivery !== undefined &&
+        delivery.total > 0 &&
+        delivery.delivered === 0) {
+        return `${RUN_STATUS_LABELS.failed} — nothing delivered`;
+    }
+    return presented.detail ? `${presented.label} — ${presented.detail}` : presented.label;
+}

package/package.json

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