Files
kebab/tasks/p9/p9-fb-33-streaming-ask.md
altair823 16b4f9fb9f 📝 docs(HANDOFF): 도그푸딩 피드백에 따른 백로그 항목 추가
- P9 dogfooding 백로그 항목 fb-26 ~ fb-42 추가
- 각 항목의 목표, 증상, 후속 작업 및 위험 요소 명시
- release 계획에 따른 0.3.0 ~ 0.6.0 분할

📝 docs(INDEX): 백로그 항목에 대한 세부 정보 추가

- fb-26 ~ fb-42 항목의 세부 정보 및 상태 추가
- 각 항목의 목표와 후속 작업 명시
- 도그푸딩 피드백에 따른 개선 사항 반영

🔧 chore(tasks): 새로운 백로그 항목 파일 생성

- p9-fb-26 ~ p9-fb-42 각 항목에 대한 개별 파일 생성
- 각 파일에 목표, 증상, 후속 작업 및 위험 요소 포함
- doogfooding 피드백을 기반으로 한 개선 사항 문서화
2026-05-06 13:26:36 +00:00

2.1 KiB

phase, component, task_id, title, status, target_version, depends_on, unblocks, contract_source, contract_sections, source_feedback
phase component task_id title status target_version depends_on unblocks contract_source contract_sections source_feedback
P9 kebab-cli + kebab-app + wire-schema p9-fb-33 Streaming ask (ndjson delta) — agent token 즉시 소비 open 0.4.0
../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md
§7 RAG
§10 UX
wire-schema answer.v1
사용자 도그푸딩 2026-05-06 — agent 가 token 도착 즉시 다음 행동 결정 가능해야 — final-only JSON 은 latency 손해.

p9-fb-33 — Streaming ask (ndjson delta)

백로그 only — 미구현. 본 spec 은 도그푸딩 피드백 skeleton. 구현 착수 전 superpowers:brainstorming 으로 설계 단계 선행 필요. delta event 형식 / final-only fallback / TUI vs CLI 차이 brainstorm 후 확정.

증상 / 동기

  • 현재 kebab ask --json 추정 — final answer 한 번에 출력. agent 는 LLM token 도착마다 progressive UI / 조기 종료 / 후속 tool 호출 결정 가능해야 빠름.
  • TUI 는 이미 streaming 표시 — CLI / agent 가 동일 surface 못 받음.

Goal (skeleton)

  • kebab ask --json --stream — ndjson delta event.
  • event shape (제안):
    • {"kind":"retrieval_done","hits":[...]}
    • {"kind":"token","delta":"...", "turn_index":0}
    • {"kind":"citation","ref":"[1]","chunk_id":"..."}
    • {"kind":"final","answer":"...","citations":[...]}
  • --stream 미지정이면 현재 동작 유지 (final-only).
  • wire schema answer_event.v1 추가.

후속 작업 — brainstorm 필요 항목

  • event 종류 / 순서 invariant.
  • token delta 의 partial markdown — fb-40 fact-grounded / fb-11 markdown render 와 정합성.
  • 중간 cancel — agent 가 SIGINT / connection close 하면 LLM 호출 중단.
  • daemon (fb-29) HTTP SSE 와 동일 event shape — 이중 구현 방지.

Risks / notes

  • wire schema additive minor — 기존 final-only path 보존.
  • TUI 의 streaming 코드 재사용 가능 — kebab-rag 의 generate stream API 가 이미 있을 것.
  • fb-30 MCP / fb-29 daemon 과 stream surface 통일 필요.