@aicopycoders/exodus 2026.7.200-beta.1 → 2026.7.200-beta.10

package/dist/commands/brand.js

@@ -1,9 +1,11 @@
 import fs from "node:fs";
 import path from "node:path";
 import { apiGetDashboard, apiPostDashboard } from "../lib/client.js";
+import { sniffImageType, BRAND_IMAGE_MAX_BYTES } from "../lib/image-sniff.js";
 import { getActiveBrand, setActiveBrand, clearActiveBrand, findWorkspaceRoot, } from "../lib/state.js";
 import { detectLayout, ensureBrandDir, resolveActiveBrand, brandStateDir, brandDirFor, } from "../lib/layout.js";
 import { promptYesNo } from "../lib/prompts.js";
+import { pkgRef } from "../lib/channel.js";
 const AUTO_END_MARKER = "<!-- exodus:auto-section-end — manual brand notes below survive `brand use` refreshes -->";
 export const helpText = `
 exodus brand — list, switch, and inspect brands available to your CLI
@@ -15,6 +17,9 @@ Subcommands:
   exodus brand current          Print the active brand
   exodus brand clear            Stop overriding the brand (use the key's default)
   exodus brand delete <slug>    Delete a brand you own (asks before removing the local folder)
+  exodus brand images add <files...> --kind founder|product|reference
+                                Upload brand-identity images (png/jpg/webp, max 15MB each)
+  exodus brand images list      Show the active brand's uploaded identity images
 
 Any user can create and own unlimited brands (\`brand create\`) — you do NOT
 need to be an admin, and brands are scoped to you (two users can have the
@@ -176,7 +181,7 @@ async function runCreate(name) {
         console.log(`✓ Wrote ${refresh.pathRel}.`);
     }
     console.log(`\nNext: set up the brand's primer to unlock the pipelines —\n` +
-        `  say "exodus, set up my brand primer" (or run \`npx @aicopycoders/exodus primer\`).`);
+        `  say "exodus, set up my brand primer" (or run \`npx ${pkgRef()} primer\`).`);
 }
 async function runDelete(slug, flags) {
     if (!slug)
@@ -260,11 +265,166 @@ function runClear() {
         console.log("from here still target it (the folder wins over the pointer).");
     }
 }
+const BRAND_IMAGE_KINDS = ["founder", "product", "reference"];
+async function runImagesAdd(files, flags) {
+    const kind = typeof flags["kind"] === "string" ? flags["kind"] : "";
+    if (!BRAND_IMAGE_KINDS.includes(kind)) {
+        console.error(`Error: brand images add requires --kind ${BRAND_IMAGE_KINDS.join("|")}. ` +
+            `(Logo stays a dashboard upload — it replaces rather than appends.)`);
+        process.exit(1);
+        return;
+    }
+    if (files.length === 0) {
+        console.error("Error: brand images add requires at least one file.");
+        process.exit(1);
+        return;
+    }
+    const valid = [];
+    const skipped = [];
+    for (const file of files) {
+        let buf;
+        try {
+            buf = fs.readFileSync(file);
+        }
+        catch {
+            skipped.push({ file, reason: "unreadable (does the path exist?)" });
+            continue;
+        }
+        if (buf.length > BRAND_IMAGE_MAX_BYTES) {
+            skipped.push({
+                file,
+                reason: `too large (${(buf.length / 1024 / 1024).toFixed(1)}MB > 15MB)`,
+            });
+            continue;
+        }
+        const sniffed = sniffImageType(buf);
+        if (!sniffed) {
+            skipped.push({ file, reason: "not a png/jpg/webp (content check failed)" });
+            continue;
+        }
+        valid.push({ file, buf, mime: sniffed.mime });
+    }
+    for (const s of skipped) {
+        console.error(`  skipped ${path.basename(s.file)}: ${s.reason}`);
+    }
+    if (valid.length === 0) {
+        console.error("Error: no valid image files to upload.");
+        process.exit(1);
+        return;
+    }
+    const mint = await apiPostDashboard("/api/brands/images/upload-url", { count: valid.length });
+    if (!mint.ok || !Array.isArray(mint.data.urls)) {
+        console.error(`Error: ${mint.data.error ?? `HTTP ${mint.status} minting upload URLs`}`);
+        process.exit(1);
+        return;
+    }
+    const storageIds = [];
+    const uploadedFiles = [];
+    for (let i = 0; i < valid.length; i++) {
+        const { file, buf, mime } = valid[i];
+        try {
+            const res = await fetch(mint.data.urls[i], {
+                method: "POST",
+                headers: { "Content-Type": mime },
+                body: new Uint8Array(buf),
+            });
+            const body = JSON.parse(await res.text());
+            if (!res.ok || !body.storageId)
+                throw new Error(`HTTP ${res.status}`);
+            storageIds.push(body.storageId);
+            uploadedFiles.push(file);
+        }
+        catch (err) {
+            console.error(`  skipped ${path.basename(file)}: storage upload failed (${err instanceof Error ? err.message : String(err)})`);
+        }
+    }
+    if (storageIds.length === 0) {
+        console.error("Error: every storage upload failed.");
+        process.exit(1);
+        return;
+    }
+    const attach = await apiPostDashboard("/api/brands/images", {
+        kind,
+        storageIds,
+    });
+    if (!attach.ok) {
+        console.error(`Error: ${attach.data.error ?? `HTTP ${attach.status} attaching images`}`);
+        process.exit(1);
+        return;
+    }
+    for (const s of attach.data.skipped ?? []) {
+        console.error(`  server skipped ${s.storageId}: ${s.reason}`);
+    }
+    for (const f of uploadedFiles)
+        console.log(`  uploaded ${path.basename(f)}`);
+    console.log(`✓ ${kind}: ${attach.data.added} added (brand now has ${attach.data.total} ${kind} image${attach.data.total === 1 ? "" : "s"})`);
+}
+async function runImagesList() {
+    const res = await apiGetDashboard("/api/brands/images");
+    if (!res.ok) {
+        console.error(`Error: ${res.data.error ?? `HTTP ${res.status}`}`);
+        process.exit(1);
+        return;
+    }
+    console.log(`brand: ${res.data.brand}`);
+    for (const kind of BRAND_IMAGE_KINDS) {
+        const entries = res.data[kind] ?? [];
+        console.log(`${kind}: ${entries.length}`);
+        for (const e of entries) {
+            console.log(`  ${e.url ?? e.storageId}`);
+        }
+    }
+}
+function imagesPositionals() {
+    const rest = process.argv.slice(3);
+    const out = [];
+    let i = 0;
+    while (i < rest.length) {
+        const arg = rest[i];
+        if (arg === "--help" || arg === "-h") {
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = rest[i + 1];
+            if (key.startsWith("no-")) {
+                i++;
+            }
+            else if (next !== undefined && !next.startsWith("--")) {
+                i += 2;
+            }
+            else {
+                i++;
+            }
+            continue;
+        }
+        out.push(arg);
+        i++;
+    }
+    return out;
+}
+async function runImages(args, flags) {
+    const sub = args[0];
+    if (sub === "add") {
+        await runImagesAdd(args.slice(1), flags);
+        return;
+    }
+    if (sub === "list" || sub === undefined) {
+        await runImagesList();
+        return;
+    }
+    console.error(`exodus brand images: unknown subcommand "${sub}" (use add | list)`);
+    process.exit(1);
+}
 export async function run(flags) {
     const positionals = process.argv.slice(3).filter((a) => !a.startsWith("--"));
     const sub = positionals[0];
     const arg = positionals[1];
     switch (sub) {
+        case "images":
+            await runImages(imagesPositionals().slice(1), flags);
+            return;
         case "list":
         case undefined:
             await runList();

package/dist/commands/creative.js

@@ -1,4 +1,4 @@
-import { apiGet, apiPost, getDashboardUrl } from "../lib/client.js";
+import { apiGet, apiGetDashboard, apiPost, getDashboardUrl, } from "../lib/client.js";
 import { formatError } from "../lib/format.js";
 export const helpText = `
 exodus creative — Creative-suite engines (native, copy-derived, ref-match)
@@ -152,31 +152,14 @@ async function runStatus(flags) {
         process.exit(1);
         return;
     }
-    const dashUrl = `${getDashboardUrl()}/api/creative-suite/runs/${encodeURIComponent(runId)}`;
-    const apiKey = process.env["EXODUS_API_KEY"] ??
-        process.env["VAD_API_KEY"] ??
-        "";
-    const headers = { "Content-Type": "application/json" };
-    if (apiKey)
-        headers["Authorization"] = `Bearer ${apiKey}`;
-    const fetchRes = await fetch(dashUrl, { method: "GET", headers });
-    const text = await fetchRes.text();
-    let data;
-    try {
-        data = JSON.parse(text);
-    }
-    catch {
-        console.error(`Non-JSON ${fetchRes.status} from /api/creative-suite/runs/${runId}: ${text.slice(0, 300)}`);
-        process.exit(1);
-        return;
-    }
-    if (!fetchRes.ok) {
-        const errMsg = data.error ?? `HTTP ${fetchRes.status}`;
+    const res = await apiGetDashboard(`/api/creative-suite/runs/${encodeURIComponent(runId)}`);
+    if (!res.ok) {
+        const errMsg = res.data.error ?? `HTTP ${res.status}`;
         console.error(`Error: ${errMsg}`);
         process.exit(1);
         return;
     }
-    const d = data;
+    const d = res.data;
     console.log(`runId:        ${d._id}`);
     if (d.name)
         console.log(`name:         ${d.name}`);

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/genesis.js

@@ -22,7 +22,7 @@ Options:
   --seeds <file|"text">       Per-run creative seeds. File: one per line OR a
                               JSON array. Inline: a single seed.
   --steering "<text>"         With regenerate: re-roll guidance for the hook pool.
-  --awareness <level>         unaware | problem-aware (default) | solution-aware | product-aware
+  --awareness <level>         unaware | problem-aware (default) | solution-aware | product-aware | most-aware
   --passes <n>                Writing passes per bot — Mario + Infeed (1-5, default 1 = 2 variants)
   --variants <n>              Advanced: raw total variant count (1-10); overrides --passes
   --ad-account <id>           Meta ad account ID for the top-ads-biased track

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/keys.js

@@ -25,6 +25,7 @@ const PROVIDER_LABEL = {
     elevenlabs: "ElevenLabs",
     kie: "Kie.ai",
     imgflip: "Imgflip",
+    scrapecreators: "ScrapeCreators",
 };
 async function status() {
     let remote;

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/primer.js

@@ -36,8 +36,8 @@ Genesis writer for that primer honors it on every run.
 
   <lane> is one of: bodyUnaware | bodyAware | hooks | headlines
   (aliases: body-unaware/unaware/problem-aware, body-aware/solution-aware/
-   product-aware, hook, headline). Setting just one of --always / --never
-   leaves the other field as-is.
+   product-aware/most-aware, hook, headline). Setting just one of --always /
+   --never leaves the other field as-is.
 
 Interactive build flags:
   --file <path>   Read the submission (winning ads + product info) from a file
@@ -397,6 +397,8 @@ const LANE_ALIASES = {
     solutionaware: "bodyAware",
     "product-aware": "bodyAware",
     productaware: "bodyAware",
+    "most-aware": "bodyAware",
+    mostaware: "bodyAware",
     hooks: "hooks",
     hook: "hooks",
     headlines: "headlines",

package/dist/commands/segment.d.ts

@@ -0,0 +1,57 @@
+export declare const helpText: string;
+interface NValue {
+    slug: string;
+    name: string;
+}
+interface MapOutcome {
+    slug: string;
+    name: string;
+    lens?: "Type" | "Location" | "Function" | "Moment" | "Severity";
+    subs: NValue[];
+}
+interface MapGroup {
+    name: string;
+    values: NValue[];
+}
+export interface SegmentMap {
+    productWord: string;
+    brandLabel: string;
+    outcomes: MapOutcome[];
+    demoGroups: MapGroup[];
+    facetFamilies: MapGroup[];
+}
+export interface ImportSummary {
+    added: string[];
+    keptRenamed: string[];
+    deleted: string[];
+    subsDeleted: string[];
+    demoValuesDeleted: string[];
+    facetValuesDeleted: string[];
+    personasArchived: string[];
+    personasDeleted: string[];
+}
+export declare function asSummary(data: unknown): ImportSummary;
+export declare function isDestructive(summary: ImportSummary): boolean;
+export declare function formatImportSummary(summary: ImportSummary): string;
+export declare function formatMapSummary(map: SegmentMap): string;
+export interface ImportDeps {
+    post: (path: string, body: unknown) => Promise<{
+        ok: boolean;
+        status: number;
+        data: unknown;
+    }>;
+    readFile: (path: string) => string;
+}
+export interface ImportFlowResult {
+    code: number;
+    lines: string[];
+    calls: Array<{
+        dryRun: boolean;
+    }>;
+}
+export declare function importFlow(file: string, opts: {
+    yes: boolean;
+    json: boolean;
+}, deps: ImportDeps): Promise<ImportFlowResult>;
+export declare function run(flags: Record<string, string | boolean>): Promise<void>;
+export {};