@aicopycoders/exodus 2026.7.200-beta.5 → 2026.7.200-beta.6

package/dist/commands/brand.js

@@ -5,6 +5,7 @@ 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
@@ -180,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)

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/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/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/lib/channel.d.ts

@@ -0,0 +1,5 @@
+export type Channel = "beta" | "latest";
+export declare function channelOf(version: string): Channel;
+export declare function getChannel(): Channel;
+export declare function pkgRef(channel?: Channel): string;
+export declare function stampChannel(content: string, channel?: Channel): string;

package/dist/lib/channel.js

@@ -0,0 +1,15 @@
+import { getVersion } from "./version.js";
+export function channelOf(version) {
+    return version.includes("-beta") ? "beta" : "latest";
+}
+export function getChannel() {
+    return channelOf(getVersion());
+}
+export function pkgRef(channel = getChannel()) {
+    return `@aicopycoders/exodus@${channel}`;
+}
+export function stampChannel(content, channel = getChannel()) {
+    if (channel !== "beta")
+        return content;
+    return content.replace(/npx @aicopycoders\/exodus(@[A-Za-z0-9.-]+)?/g, `npx ${pkgRef(channel)}`);
+}

package/dist/lib/scaffold.d.ts

@@ -1,9 +1,10 @@
+import { type Channel } from "./channel.js";
 export declare const ENV_SCAFFOLD = "# Exodus config \u2014 paste your dashboard .env block below this line.\n# Get it from your Exodus dashboard -> Settings -> Claude Code -> \"Copy .env block\".\n# ONE key covers every brand you own; switch brands with brand subfolders or\n# `npx @aicopycoders/exodus brand use <slug>`, never by editing this file.\n";
-export declare function writeEnvScaffold(root: string): {
+export declare function writeEnvScaffold(root: string, channel?: Channel): {
     created: boolean;
 };
 export declare function ensureGitignore(root: string): void;
-export declare function writeSkills(root: string, srcOverride?: string): string[];
-export declare function writeReferences(root: string, srcOverride?: string): void;
-export declare function writeDocs(root: string, srcOverride?: string): string[];
+export declare function writeSkills(root: string, srcOverride?: string, channel?: Channel): string[];
+export declare function writeReferences(root: string, srcOverride?: string, channel?: Channel): void;
+export declare function writeDocs(root: string, srcOverride?: string, channel?: Channel): string[];
 export declare function ensureBaseDirs(root: string): void;

package/dist/lib/scaffold.js

@@ -1,18 +1,36 @@
 import fs from "node:fs";
 import path from "node:path";
 import { skillsDir, referencesDir, docsDir } from "./assets.js";
+import { getChannel, stampChannel } from "./channel.js";
 export const ENV_SCAFFOLD = `# Exodus config — paste your dashboard .env block below this line.
 # Get it from your Exodus dashboard -> Settings -> Claude Code -> "Copy .env block".
 # ONE key covers every brand you own; switch brands with brand subfolders or
 # \`npx @aicopycoders/exodus brand use <slug>\`, never by editing this file.
 `;
-export function writeEnvScaffold(root) {
+export function writeEnvScaffold(root, channel = getChannel()) {
     const envPath = path.join(root, ".env");
     if (fs.existsSync(envPath))
         return { created: false };
-    fs.writeFileSync(envPath, ENV_SCAFFOLD);
+    fs.writeFileSync(envPath, stampChannel(ENV_SCAFFOLD, channel));
     return { created: true };
 }
+function stampTree(dir, channel) {
+    if (channel !== "beta")
+        return;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const p = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            stampTree(p, channel);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const raw = fs.readFileSync(p, "utf8");
+        const stamped = stampChannel(raw, channel);
+        if (stamped !== raw)
+            fs.writeFileSync(p, stamped);
+    }
+}
 export function ensureGitignore(root) {
     const giPath = path.join(root, ".gitignore");
     const lines = fs.existsSync(giPath)
@@ -22,7 +40,7 @@ export function ensureGitignore(root) {
         lines.push(".env");
     fs.writeFileSync(giPath, lines.join("\n").replace(/\n+$/, "") + "\n");
 }
-export function writeSkills(root, srcOverride) {
+export function writeSkills(root, srcOverride, channel = getChannel()) {
     const src = skillsDir(srcOverride);
     const dest = path.join(root, ".claude", "skills");
     fs.mkdirSync(dest, { recursive: true });
@@ -33,11 +51,12 @@ export function writeSkills(root, srcOverride) {
         const target = path.join(dest, entry.name);
         fs.rmSync(target, { recursive: true, force: true });
         fs.cpSync(path.join(src, entry.name), target, { recursive: true });
+        stampTree(target, channel);
         names.push(entry.name);
     }
     return names;
 }
-export function writeReferences(root, srcOverride) {
+export function writeReferences(root, srcOverride, channel = getChannel()) {
     let src;
     try {
         src = referencesDir(srcOverride);
@@ -50,8 +69,9 @@ export function writeReferences(root, srcOverride) {
     const dest = path.join(root, "references");
     fs.rmSync(dest, { recursive: true, force: true });
     fs.cpSync(src, dest, { recursive: true });
+    stampTree(dest, channel);
 }
-export function writeDocs(root, srcOverride) {
+export function writeDocs(root, srcOverride, channel = getChannel()) {
     let src;
     try {
         src = docsDir(srcOverride);
@@ -65,7 +85,8 @@ export function writeDocs(root, srcOverride) {
     for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
         if (!entry.isFile() || !entry.name.endsWith(".md"))
             continue;
-        fs.copyFileSync(path.join(src, entry.name), path.join(root, entry.name));
+        const content = fs.readFileSync(path.join(src, entry.name), "utf8");
+        fs.writeFileSync(path.join(root, entry.name), stampChannel(content, channel));
         names.push(entry.name);
     }
     return names.sort();

package/package.json

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