@aicopycoders/exodus 2026.6.2400 → 2026.6.2700-beta.2

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

@@ -92,6 +92,9 @@ Save to `/tmp/genesis-seeds.txt` (one per line, `#` comments allowed), or pass `
 **Pass count is the user's knob** — if they didn't specify, surface a quick menu (1 pass / 2 variants recommended · 2 passes / 4 variants · more) rather than assuming. Always `run_in_background: true` — these runs are past the 10-min foreground cap.
 
 ```bash
+# Resolve hook mode FIRST (see "Hook selection mode" below) — these commands
+# assume a saved default exists, else add --stop-at-hooks or --auto-hooks or they error.
+
 # Default — 1 pass per bot = 2 variants (1 Mario × Brand + 1 Infeed × Brand):
 npx @aicopycoders/exodus genesis run --brief "<brief>" --awareness <level>
 
@@ -110,12 +113,17 @@ npx @aicopycoders/exodus genesis run --brief "<brief>" --awareness <level> --aut
 
 `--brief` accepts inline text or a file path. `--passes <n>` (1–5) is the friendly knob; `--variants <n>` (1–10) is an advanced raw-total override that wins if both are given.
 
-**Hook Selection Mode:**
-The pipeline can pause after Genesis generates hooks, allowing the user to pick which hooks to keep before writing body copy. This is controlled by a persisted per-user preference (manual or auto-select).
+**Hook selection mode — REQUIRED gate before EVERY run (do not skip):**
+The pipeline can pause after hook generation so the user picks which hooks become body copy — the human quality gate. You MUST resolve the mode **before** firing a run. A `genesis run` with **no** `--stop-at-hooks`/`--auto-hooks` **and** no saved preference now **hard-errors** (`Hook-selection preference not set`) **by design** — so the gate can't be silently skipped. If you see that error, you skipped this step; do it now.
+
+Resolve it in this order, every time, BEFORE you run:
+1. **Check the saved default:** run `npx @aicopycoders/exodus genesis hook-pref` (no argument). It prints `manual`, `auto`, or `unset` on the first line.
+2. **If it prints `manual` or `auto`:** just fire the run — the saved default applies, no flag needed.
+3. **If it prints `unset`:** STOP and ask the user once, plainly — *"Want to choose the hooks yourself before I write the copy, or have me auto-pick and write straight through?"* Then fire the run with the matching flag (`--stop-at-hooks` = they choose, `--auto-hooks` = auto), and after it starts, offer to save it as their default so you never ask again: `npx @aicopycoders/exodus genesis hook-pref <manual|auto>`. **Do NOT fire the run before they answer.**
 
-- **`--stop-at-hooks`** — pause after hook generation. The run lands in `awaiting_hook_selection` status and the CLI prints a dashboard URL. The user reviews and picks hooks on the run-detail page; the pipeline then continues automatically to body-copy generation.
-- **`--auto-hooks`** — force auto-select for this run (overrides a saved "manual" default). The pipeline auto-computes the strongest hooks and runs straight through without pausing.
-- **Saved preference** — the first time a user runs Genesis (or when no preference is saved), you should ask once: *"Want to choose the hooks yourself, or have me auto-pick and write straight through?"* Then run with `--stop-at-hooks` (manual mode) or `--auto-hooks` (auto mode), and after reporting the result, offer to save the choice with `npx @aicopycoders/exodus genesis hook-pref <manual|auto>` so you don't ask again. If the user has already set a preference via `hook-pref`, skip the question and just run with the saved default.
+Flags:
+- **`--stop-at-hooks`** — pause after hook generation. The run lands in `awaiting_hook_selection` and the CLI prints a dashboard URL; the user picks hooks on the run-detail page and the pipeline continues automatically to body copy.
+- **`--auto-hooks`** — auto-pick the strongest hooks and write straight through (also overrides a saved "manual" default for this one run).
 
 > "Genesis run started at problem-aware — 1 pass per bot (2 variants: Mario × Brand + Infeed × Brand). I'll surface the Doc when it lands."
 

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

@@ -122,6 +122,8 @@ Skip the menu only if the user already said how many ("just give me two", "run a
 
 Hand off to the `exodus-genesis` skill — it owns the run (double-pass hooks, the built-in 15-point QA, the editing menu). Always background it; even the default run is ~12–15 min, past the 10-min foreground cap.
 
+**Before firing, resolve the hook-selection gate** (the `exodus-genesis` skill's "Hook selection mode" step): run `npx @aicopycoders/exodus genesis hook-pref` — if it prints `unset`, ask the user *"choose the hooks yourself, or auto-pick and write straight through?"* and pass `--stop-at-hooks` or `--auto-hooks` accordingly (offer to save the choice). A run with no flag and no saved default hard-errors by design — don't skip this.
+
 ```bash
 # Default — 1 pass per bot = 2 variants:
 npx @aicopycoders/exodus genesis run --brief "<brief>" --awareness <level>

package/dist/commands/genesis.js

@@ -446,8 +446,24 @@ async function waitForGenesisRun(runId) {
 async function runHookPref() {
     const positionals = parsePositional();
     const pref = positionals[1];
+    if (pref === undefined) {
+        const res = await apiGet("/api/v2/genesis/hook-pref");
+        if (!res.ok) {
+            console.log(`Error: ${res.data.error ?? "Unknown error"}`);
+            process.exit(1);
+        }
+        const cur = res.data.preference ?? null;
+        if (cur === null) {
+            console.log("unset");
+            console.log("No saved hook preference. Runs require --stop-at-hooks or --auto-hooks until one is set.");
+        }
+        else {
+            console.log(cur);
+        }
+        return;
+    }
     if (pref !== "manual" && pref !== "auto") {
-        console.error('Usage: exodus genesis hook-pref <manual|auto>');
+        console.error('Usage: exodus genesis hook-pref [manual|auto]   (no arg prints the current value)');
         console.error('  manual  Pause each run at hook selection so you choose hooks.');
         console.error('  auto    Skip hook selection and let the pipeline pick automatically.');
         process.exit(1);

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "@aicopycoders/exodus",
-  "version": "2026.6.2400",
+  "version": "2026.6.2700-beta.2",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aicopycoders/exodus.git"
+  },
+  "homepage": "https://github.com/aicopycoders/exodus#readme",
   "type": "module",
   "bin": {
-    "exodus": "./dist/bin/exodus.js"
+    "exodus": "dist/bin/exodus.js"
   },
-  "files": ["dist", "assets"],
+  "files": [
+    "dist",
+    "assets"
+  ],
   "engines": {
     "node": ">=20"
   },

package/assets/skills/genesis-bots/.env.example

@@ -1,12 +0,0 @@
-# Genesis Bots credentials. Keep this file private — never commit or share it.
-# Easiest: replace this ENTIRE file with what the portal's "Copy .env" button
-# gives you (https://genesis.copycoders.ai/portal), then add your provider key.
-
-GENESIS_BASE_URL=https://gas.copycoders.ai/api/v1
-GENESIS_API_KEY=gen_your_key_here
-
-# Your provider key (you pay usage). Use ONE of these — match the name to your key:
-#   Anthropic  → ANTHROPIC_API_KEY=sk-ant-...
-#   OpenRouter → OPENROUTER_API_KEY=sk-or-...
-# (`npx @aicopycoders/exodus keys pull` writes these names for you from the dashboard.)
-ANTHROPIC_API_KEY=sk-ant-your_provider_key_here

package/dist/commands/__tests__/genesis.hookgate.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/commands/__tests__/genesis.hookgate.test.js

@@ -1,12 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { buildBriefBody } from "../genesis.js";
-describe("buildBriefBody stopAtHooks", () => {
-    it("omits stopAtHooks when unset", () => {
-        const b = buildBriefBody("brief text", { awarenessLevel: "problem-aware" });
-        expect("stopAtHooks" in b).toBe(false);
-    });
-    it("includes stopAtHooks:true when set", () => {
-        const b = buildBriefBody("brief text", { awarenessLevel: "problem-aware", stopAtHooks: true });
-        expect(b.stopAtHooks).toBe(true);
-    });
-});