Files
kebab/tasks/p9/p9-fb-17-chat-session-storage.md
altair823 5428412688 docs(p9): decompose dogfooding feedback into 20 task specs + reset plan
P9-1~P9-4 머지 후 사용자가 직접 도그푸딩 하며 수집한 16 항목 UX
피드백을 20 개 single-PR 사이즈 task spec 으로 분해. 각 spec 은
frontmatter (depends_on / unblocks / source_feedback), Goal,
Allowed deps, Public surface, Behavior contract, Test plan, DoD,
Out of scope 절 포함.

추가:
- p9-fb-01 ~ 20-*.md: 분해된 task spec 20 개
- p9-dogfooding-feedback.md: master index + 우선순위 + 권장 실행 순서
  + spec PR vs impl PR 절
- INDEX.md: p9-fb-01 ~ 20 link 추가
- docs/superpowers/plans/2026-05-02-p9-fb-06-reset-command.md:
  첫 후속 작업 (kebab reset 명령) 의 6-task 구현 plan
- .gitignore: .worktrees/ 추가 (superpowers worktree skill 용)

피드백 항목 → task spec 매핑은 p9-dogfooding-feedback.md 의 표 참조.
실행 시작 task: p9-fb-06 (reset 명령) — 도그푸딩 막힘 강도 1위.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 17:54:15 +00:00

2.5 KiB

phase, component, task_id, title, status, depends_on, unblocks, contract_source, contract_sections, source_feedback
phase component task_id title status depends_on unblocks contract_source contract_sections source_feedback
P9 kebab-store-sqlite p9-fb-17 SQLite V004 — chat_sessions / chat_turns planned
p9-fb-15
p9-fb-18
../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md
§5 storage
p9-dogfooding-feedback.md item 13, 14

p9-fb-17 — Chat session storage

Goal

multi-turn 대화 영속화. session 단위로 turn 저장 / 조회. TUI 의 "이전 대화 이어가기", CLI --session <id> (p9-fb-18) 의 backing store.

Allowed dependencies

  • kebab-store-sqlite 기존 deps (rusqlite, refinery).

Public surface

마이그레이션 migrations/V004__chat_sessions.sql:

CREATE TABLE chat_sessions (
    session_id   TEXT PRIMARY KEY,           -- 사용자 지정 또는 blake3 해시
    created_at   INTEGER NOT NULL,
    updated_at   INTEGER NOT NULL,
    title        TEXT,                        -- 첫 question 의 첫 N 자
    config_snapshot_json TEXT NOT NULL        -- prompt_template_version, llm model 등
);

CREATE TABLE chat_turns (
    turn_id      TEXT PRIMARY KEY,           -- blake3(session_id || index)
    session_id   TEXT NOT NULL REFERENCES chat_sessions(session_id) ON DELETE CASCADE,
    turn_index   INTEGER NOT NULL,
    question     TEXT NOT NULL,
    answer       TEXT NOT NULL,
    citations_json TEXT NOT NULL,             -- Vec<Citation> 직렬화
    created_at   INTEGER NOT NULL,
    UNIQUE(session_id, turn_index)
);
CREATE INDEX idx_chat_turns_session ON chat_turns(session_id, turn_index);

kebab_core::ChatSessionRepo trait + SqliteStore impl.

Behavior contract

  • session_id 사용자 명시 (kebab ask --session foo) 또는 자동 생성 (blake3 of first_question + ts).
  • turn_index monotonic per session.
  • ON DELETE CASCADEkebab reset --data-only (p9-fb-06) 가 wipe.
  • config_snapshot_json 는 prompt_template_version + llm.model + max_context_tokens 등 — 후일 retrospective 분석 가능.

Test plan

kind description
unit session 생성, 3 turn append, list_turns sequence
unit session delete → CASCADE turns
migration V004 apply 후 schema_version table 갱신

DoD

  • cargo test -p kebab-store-sqlite 통과
  • migrations/V004__chat_sessions.sql 추가
  • kebab_core::ChatSessionRepo trait 정의
  • frozen design §5 storage 절에 chat_sessions / chat_turns 추가

Out of scope

  • session 검색 / 필터 UI (P+)
  • 다른 store backend (postgres 등)