Files
kebab/tasks/p9/p9-fb-27-introspection-and-error-wire.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.2 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-27 Introspection (`kebab schema`) + structured error wire open 0.3.0
p9-fb-30
../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md
§10 UX
wire-schema 전반
사용자 도그푸딩 2026-05-06 — agent 가 kebab 인스턴스의 wire 버전 / 기능 / 모델 / 인덱스 통계 알아야 통합 안전. error 도 stderr text 가 아닌 structured JSON 필요.

p9-fb-27 — Introspection + structured error wire

백로그 only — 미구현. 본 spec 은 도그푸딩 피드백 skeleton. 구현 착수 전 superpowers:brainstorming 으로 설계 단계 선행 필요. capability matrix 정의 / error code enumerate / exit code 매핑 brainstorm 후 확정.

증상 / 동기

  • agent 가 kebab 의 wire schema 버전 / 기능 플래그 / 모델 정보 / 인덱스 통계 introspect 못 함.
  • error 는 stderr text — agent parse 어려움. timeout vs no-results vs config-missing vs not-indexed 구분 불가.

Goal (skeleton)

  • kebab schema --json — wire schema 버전 list, capability flags (mcp / daemon / streaming / 등), model versions (parser / chunker / embedding / prompt_template / index), index stats (doc count, chunk count, last ingest).
  • kebab stats --json 으로 분리 가능 — schema 는 정적, stats 는 동적. brainstorm 단계 결정.
  • 모든 명령의 error 출력을 structured JSON (stderr ndjson 또는 stdout 의 error.v1 wire).
  • exit code: 0 = OK, 1 = generic, 2 = config, 3 = not-indexed, 4 = timeout, 5 = no-results, …

후속 작업 — brainstorm 필요 항목

  • error.v1 wire schema — fields (code, message, details, hint).
  • 기존 명령의 error path 전수 변환 — anyhow chain → error.v1.
  • schema vs stats 분리 여부.
  • fb-30 MCP initialize response 와 capability matrix 공유.

Risks / notes

  • error wire 변경 = breaking — 기존 stderr text 출력은 유지 (둘 다 출력 또는 --json 일 때만 wire).
  • exit code 안정성 — README 에 표 명시.
  • fb-30 / 29 의 prerequisite — agent 가 server 능력 먼저 introspect.