kebab

altair823-org/kebab

Fork 0

Commit Graph

Author	SHA1	Message	Date
altair823	ecb85651ea	spec(p9-fb-15): RAG multi-turn 정책 + answer.v1 conversation_id/turn_index 도그푸딩 후 추가된 ask multi-turn (꼬리 물기) surface 를 frozen design + wire schema 에 명시. p9-fb-15 (RAG core) + p9-fb-16 (TUI UI) + p9-fb-17 (V004 chat sessions) + p9-fb-18 (CLI session/repl) 의 spec PR — impl PR 들이 이어진다. 변경: - §2.3 Answer wire schema: conversation_id (String?) + turn_index (u32?) 두 optional 필드. 기존 single-shot 소비자 (외부 wrapper) 영향 없음 — 두 필드 모두 optional. - §3.8 RAG types: - Answer struct 에 conversation_id / turn_index field 추가. - Turn struct 신설 (history 가 prompt 에 들어갈 때 한 turn). - §3.8 \"Multi-turn behaviour\" 신설 절: - kebab-rag::ask vs ask_with_history 두 entry. - prompt 빌드 priority: system+question (필수) → retrieved chunks (k 줄여 fit) → history (newest 우선, oldest drop). - retrieval query expansion (직전 answer 첫 200자 concat). - Aborted vs Completed semantics — ask 는 single-shot 이라 cancel 시 partial token + grounded=false + LlmStreamAborted refusal (variant 추가는 p9-fb-15 impl 가 함께). - docs/wire-schema/v1/answer.schema.json: 두 필드 추가 + created_at 에 format: date-time (sibling ingest_progress.v1 와 일관). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-02 22:09:34 +00:00
altair823	a166b7051c	p0-1: wire-schema stubs, doc/spec stubs, V001 migration, fixtures - docs/wire-schema/v1/ ships 7 schema stubs (citation, search_hit, answer, ingest_report, doc_summary, chunk_inspection, doctor) that pin schema_version + required fields per design §2. Full property validation lands in later phases. - docs/spec/ ships 7 markdown stubs each linking to the canonical frozen design (domain-model, ids, canonical-document, chunk-policy, citation-policy, module-boundaries, ai-generation-guidelines). - migrations/V001__init.sql contains only schema_meta + migrations tables per design §5.1; data tables ship in P1-6/P2-1/P3-3. - fixtures/ has the 11 subdirectories every downstream task references (markdown, source-fs, search/{lexical,hybrid}, embed, vector, rag, eval, image, pdf, audio). Empty subdirs use .gitkeep so they track. fixtures/markdown/ ships the 3 phase-0 fixtures: simple-note.md, nested-headings.md, code-and-table.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-30 05:17:32 +00:00

Author

SHA1

Message

Date

altair823

ecb85651ea

spec(p9-fb-15): RAG multi-turn 정책 + answer.v1 conversation_id/turn_index

도그푸딩 후 추가된 ask multi-turn (꼬리 물기) surface 를 frozen design
+ wire schema 에 명시. p9-fb-15 (RAG core) + p9-fb-16 (TUI UI) +
p9-fb-17 (V004 chat sessions) + p9-fb-18 (CLI session/repl) 의 spec
PR — impl PR 들이 이어진다.

변경:
- §2.3 Answer wire schema: conversation_id (String?) + turn_index
  (u32?) 두 optional 필드. 기존 single-shot 소비자 (외부 wrapper)
  영향 없음 — 두 필드 모두 optional.
- §3.8 RAG types:
  - Answer struct 에 conversation_id / turn_index field 추가.
  - Turn struct 신설 (history 가 prompt 에 들어갈 때 한 turn).
- §3.8 \"Multi-turn behaviour\" 신설 절:
  - kebab-rag::ask vs ask_with_history 두 entry.
  - prompt 빌드 priority: system+question (필수) → retrieved chunks
    (k 줄여 fit) → history (newest 우선, oldest drop).
  - retrieval query expansion (직전 answer 첫 200자 concat).
  - Aborted vs Completed semantics — ask 는 single-shot 이라 cancel
    시 partial token + grounded=false + LlmStreamAborted refusal
    (variant 추가는 p9-fb-15 impl 가 함께).
- docs/wire-schema/v1/answer.schema.json: 두 필드 추가 +
  created_at 에 format: date-time (sibling ingest_progress.v1 와
  일관).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-02 22:09:34 +00:00

altair823

a166b7051c

p0-1: wire-schema stubs, doc/spec stubs, V001 migration, fixtures

- docs/wire-schema/v1/ ships 7 schema stubs (citation, search_hit,
  answer, ingest_report, doc_summary, chunk_inspection, doctor) that
  pin schema_version + required fields per design §2. Full property
  validation lands in later phases.
- docs/spec/ ships 7 markdown stubs each linking to the canonical
  frozen design (domain-model, ids, canonical-document, chunk-policy,
  citation-policy, module-boundaries, ai-generation-guidelines).
- migrations/V001__init.sql contains only schema_meta + migrations
  tables per design §5.1; data tables ship in P1-6/P2-1/P3-3.
- fixtures/ has the 11 subdirectories every downstream task references
  (markdown, source-fs, search/{lexical,hybrid}, embed, vector, rag,
  eval, image, pdf, audio). Empty subdirs use .gitkeep so they track.
  fixtures/markdown/ ships the 3 phase-0 fixtures: simple-note.md,
  nested-headings.md, code-and-table.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-30 05:17:32 +00:00

2 Commits