adhd

This is a bug in selectFrames() in src/frames.ts when n === 1. It selects one random frame, appends the wildcard, then the final .slice(0, n) removes that wildcard unless the first frame was already wild-tagged.

**Immediate workaround:** use --frames 2 or higher. The wildcard guarantee works correctly for n >= 2:

adhd "your prompt" --frames 2

**Permanent fix:** reserve the wildcard before selecting the remaining frames so it can never be truncated:

const wildPick = wild[Math.floor(Math.random() * wild.length)];
const rest = shuffle(pool.filter((f) => f.id !== wildPick.id))
  .slice(0, Math.max(0, n - 1));

return n <= 1 ? [wildPick] : [...rest, wildPick].slice(0, n);

Add a unit test asserting that every result from selectFrames(1) contains exactly one frame with the wild tag.

Replace Promise.all with Promise.allSettled for both the divergence fan-out (frames.map(...)) and the deepen pass (toDeepen.map(...)). Then process fulfilled results separately and collect rejected branches instead of letting the first rejection abort the run.

Example pattern:

const settled = await Promise.allSettled(
  frames.map((frame) => divergeBranch(frame))
);

const branches: Branch[] = [];
const failedFrames: { frameId: string; error: string }[] = [];

settled.forEach((result, i) => {
  if (result.status === "fulfilled") {
    branches.push(result.value);
  } else {
    const frameId = frames[i].id;
    const error = String(result.reason);
    failedFrames.push({ frameId, error });
    emitter.emit("frame:failed", { frameId, error });
  }
});

Apply the same change to the deepen pass. Add failedFrames to RunResult in types.ts:

type RunResult = {
  // existing fields
  failedFrames: { frameId: string; error: string }[];
};

The CLI can then print partial failures such as ✗ <frame> failed: <reason>. The run should hard-fail only when every branch failed:

if (branches.length === 0) {
  throw new Error("All LLM branches failed");
}

This handles network/LLM-layer throws such as rate limits, timeouts, and unrecoverable malformed responses. JSON-parse failures inside divergeBranch, scoreIdeas, and clusterIdeas already fail open by returning empty results. For rerun support, an optional checkpoint keyed by (frame_id, input_hash) can skip completed branches and retry failed ones with backoff.