Files
kebab/tasks/p9/p9-fb-35-verbatim-fetch.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.0 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-35 Verbatim fetch (`kebab fetch <chunk_id|doc_id>`) — citation deep-link open 0.4.0
../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md
§4 search
§5 storage
§10 UX
사용자 도그푸딩 2026-05-06 — agent 가 search hit / citation 보고 더 깊이 파볼 때 raw chunk text + 주변 context 필요.

p9-fb-35 — Verbatim fetch

백로그 only — 미구현. 본 spec 은 도그푸딩 피드백 skeleton. 구현 착수 전 superpowers:brainstorming 으로 설계 단계 선행 필요. fetch unit (chunk vs doc vs span) / 주변 context (앞뒤 chunk N 개) / 옵션 정책 brainstorm 후 확정.

증상 / 동기

  • search 결과의 snippet 은 highlight 중심 — agent 가 "이 chunk 의 전체 raw text" 또는 "이 chunk 앞뒤 context" 원함.
  • 현재 inspect 는 TUI 전용 — CLI / --json 으로 chunk 가져오는 명시 surface 없음.
  • citation 의 doc_id 만 받고 doc 전체 다시 ingest / read 하는 비효율.

Goal (skeleton)

  • kebab fetch chunk <chunk_id> [--context N] — chunk verbatim + 앞뒤 N 개 chunk.
  • kebab fetch doc <doc_id> — doc 전체 raw text.
  • kebab fetch span <doc_id> <line_start> <line_end> — 특정 라인 범위.
  • response wire schema fetch_result.v1 추가.

후속 작업 — brainstorm 필요 항목

  • chunk_id / doc_id 노출 — 현재 search_hit.v1 에 있는지 확인 + 안정성.
  • context window — N 개 chunk vs N tokens.
  • doc 전체 fetch 의 size 제한 (fb-34 budget 과 통합).
  • pdf / image 의 fetch — 텍스트 추출본 vs 원본 path.

Risks / notes

  • wire schema 신규 — fetch_result.v1 JSON Schema 추가.
  • 큰 doc fetch 시 budget control 필수 — fb-34 와 통합.
  • chunk_id 안정성 — re-ingest 후 chunk_id 변경되면 agent 의 citation stale.