kebab/tasks/p9/p9-fb-33-streaming-ask.md

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 즉시 소비	completed	0.5.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)

✅ 구현 완료. 본 spec 은 구현 시점의 frozen 상태. post-merge deviation 은 HOTFIXES.md 참조 — live source of truth.

상세 설계: docs/superpowers/specs/2026-05-09-p9-fb-33-streaming-ask-design.md. 구현 계획: docs/superpowers/plans/2026-05-09-p9-fb-33-streaming-ask.md.

증상 / 동기

• 현재 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 통일 필요.