Q: 하나의 실패한 LLM 호출로 인해 전체 브랜치 fan-out이 취소되고 완료된 결과가 버려지는 것을 어떻게 막을 수 있나요?

divergence 팬아웃(`frames.map(...)`)과 deepen 패스(`toDeepen.map(...)`) 모두에서 `Promise.all`을 `Promise.allSettled`로 교체하세요. 그런 다음 첫 번째 rejection이 실행을 중단시키게 하지 말고, fulfilled 결과는 별도로 처리하고 rejected 분기는 수집하세요. 예시 패턴: ```ts 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 }); } }); ``` deepen 패스에도 동일한 변경을 적용하세요. `types.ts`의 `RunResult`에 `failedFrames`를 추가하세요: ```ts type RunResult = { // existing fields failedFrames: { frameId: string; error: string }[]; }; ``` 그러면 CLI가 `✗ failed: `과 같은 부분 실패를 출력할 수 있습니다. 실행은 모든 분기가 실패한 경우에만 하드 실패해야 합니다: ```ts if (branches.length === 0) { throw new Error("All LLM branches failed"); } ``` 이렇게 하면 레이트 리밋, 타임아웃, 복구 불가능한 malformed 응답과 같은 네트워크/LLM 계층의 throw를 처리할 수 있습니다. `divergeBranch`, `scoreIdeas`, `clusterIdeas` 내부의 JSON 파싱 실패는 이미 빈 결과를 반환하는 방식으로 fail open됩니다. 재실행 지원을 위해서는 `(frame_id, input_hash)`를 키로 하는 선택적 체크포인트를 사용해 완료된 분기는 건너뛰고 실패한 분기는 백오프를 적용해 재시도할 수 있습니다.

Question 1

`adhd --frames 1`을 실행할 때 와일드카드 프레임이 약 절반의 경우 누락되는 문제를 해결하는 방법은?

Accepted Answer

`n === 1`일 때 `src/frames.ts`의 `selectFrames()`에 버그가 있습니다. 랜덤한 프레임 하나를 선택하고 와일드카드를 추가하지만, 첫 번째 프레임이 이미 wild 태그가 붙어 있지 않는 한 마지막 `.slice(0, n)`이 그 와일드카드를 제거합니다.

**즉시 우회 방법:** `--frames 2` 이상을 사용하세요. 와일드카드 보장은 `n >= 2`에서 올바르게 작동합니다:

```bash
adhd "your prompt" --frames 2
```

**영구 수정:** 남은 프레임을 선택하기 전에 와일드카드를 먼저 확보하여 절대 잘려 나가지 않도록 합니다:

```ts
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);
```

`selectFrames(1)`의 모든 결과가 `wild` 태그가 붙은 프레임을 정확히 하나 포함하는지 검증하는 단위 테스트를 추가하세요.

Question 2

하나의 실패한 LLM 호출로 인해 전체 브랜치 fan-out이 취소되고 완료된 결과가 버려지는 것을 어떻게 막을 수 있나요?

Accepted Answer

divergence 팬아웃(`frames.map(...)`)과 deepen 패스(`toDeepen.map(...)`) 모두에서 `Promise.all`을 `Promise.allSettled`로 교체하세요. 그런 다음 첫 번째 rejection이 실행을 중단시키게 하지 말고, fulfilled 결과는 별도로 처리하고 rejected 분기는 수집하세요. 예시 패턴: ```ts 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 }); } }); ``` deepen 패스에도 동일한 변경을 적용하세요. `types.ts`의 `RunResult`에 `failedFrames`를 추가하세요: ```ts type RunResult = { // existing fields failedFrames: { frameId: string; error: string }[]; }; ``` 그러면 CLI가 `✗ failed: `과 같은 부분 실패를 출력할 수 있습니다. 실행은 모든 분기가 실패한 경우에만 하드 실패해야 합니다: ```ts if (branches.length === 0) { throw new Error("All LLM branches failed"); } ``` 이렇게 하면 레이트 리밋, 타임아웃, 복구 불가능한 malformed 응답과 같은 네트워크/LLM 계층의 throw를 처리할 수 있습니다. `divergeBranch`, `scoreIdeas`, `clusterIdeas` 내부의 JSON 파싱 실패는 이미 빈 결과를 반환하는 방식으로 fail open됩니다. 재실행 지원을 위해서는 `(frame_id, input_hash)`를 키로 하는 선택적 체크포인트를 사용해 완료된 분기는 건너뛰고 실패한 분기는 백오프를 적용해 재시도할 수 있습니다.

adhd

개요

README 미리보기

FAQ (2)

同类型项目

browser-use

puppeteer

manim

PaddleOCR