altair823-org/kebab
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 45 Wiki Activity

docs: frozen spec 을 현행 코드(v0.32.0) 기준으로 재조정 #226

Merged
altair823 merged 2 commits from docs/reconcile-frozen-spec into main 2026-06-28 02:51:37 +00:00
Conversation 0 Commits 2 Files Changed 4 +127 -83
altair823 commented 2026-06-27 23:05:49 +00:00
Owner
Copy Link

frozen 설계 계약을 v0.32.0 코드와 1:1 대조 후 dated 주석으로 재조정 (제거 14 / 갱신 40 / 모순수정 6, +120/-76). 상세는 spec 상단 재조정 배너 + commit 메시지 참조. 원 동결본은 git history 보존. 후속: CLAUDE.md/DOCS.md 의 frozen 편집금지 문구 정합 필요.

🤖 Generated with Claude Code
https://claude.ai/code/session_01C5r6DDehC3ECcC2BxLsPHu

frozen 설계 계약을 v0.32.0 코드와 1:1 대조 후 dated 주석으로 재조정 (제거 14 / 갱신 40 / 모순수정 6, +120/-76). 상세는 spec 상단 재조정 배너 + commit 메시지 참조. 원 동결본은 git history 보존. 후속: CLAUDE.md/DOCS.md 의 frozen 편집금지 문구 정합 필요. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01C5r6DDehC3ECcC2BxLsPHu
altair823 added 1 commit 2026-06-27 23:05:50 +00:00
docs: frozen spec 을 현행 코드(v0.32.0) 기준으로 재조정 6105ae1073 
frozen 설계 계약(2026-04-27)이 "추가"만 흡수하고 "삭제"는 반영하지 않아,
동결 후 추가됐다가 삭제된 기능을 설명하는 죽은 텍스트가 누적됨. 13개 섹션을
현재 코드와 1:1 대조(file:line 검증) 후 dated 주석으로 재조정.

- ✂ 제거됨 14: 멀티턴/세션(conversation_id·turn_index·Turn·ask_with_history·
  chat_sessions, V015 drop), rag-v1/v2 템플릿, kebab-tui, cargo-deny 강제,
  LRU search cache, explain_default, workspace.include.
- ⟳ 갱신 40: Answer.hops/verification + refusal 4→8, CanonicalDocument/Chunk/
  Metadata/SearchFilters(11)/SearchHit(19) 필드, SQLite kv/derivation_cache/
  pdf_ocr_events/source_id/status, config(gemma4:e4b·rag-v4·KEBAB_·provider
  3-way), FinishReason::Cancelled, §8 embed-ollama/nli/mcp, MCP 8 tools, doctor
  3 checks, git_commit 40-hex, Inline struct variant 등.
- ⚠ 모순 수정 6: Citation 5↔6, Chunk 필드 §3.5↔§4.2/§5.5, §3.7b 의존 그래프
  방향, §8 eval 방향, e5-small↔e5-large.

원 동결본은 이 commit 이전 git history 에 보존. 독립 리뷰 GO(코드펜스 50쌍 균형,
§0–§12 순서 유지, 45 정정 전부 코드 재대조 통과, 새 모순 0).

CLAUDE.md/DOCS.md 의 "frozen 편집 금지" 문구는 본 재조정과 정합되도록 후속 갱신 필요.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C5r6DDehC3ECcC2BxLsPHu
altair823 added 1 commit 2026-06-27 23:09:33 +00:00
docs: 재조정 후속 — 정책 문구 정합 + 코드 코멘트 lag 수정 93e69c9bec 
spec 재조정(이전 commit)으로 생긴 정책↔실제 모순 + 검증이 발견한 코드 lag 정리.

- CLAUDE.md / DOCS.md: "frozen 편집 금지" → "reconciled baseline" 으로 정합.
  원칙 동결이되, 누적 drift/삭제로 문서가 현실과 모순되면 주기적 dated 재조정
  (✂/⟳/⚠)을 허용·기대. HOTFIXES 는 재조정 사이 fine-grained live deviation log.
- kebab-rag/src/pipeline.rs:580: doc-comment rag-multi-hop-v1 → v2
  (실제 const PROMPT_TEMPLATE_VERSION_MULTI_HOP 와 일치 — 검증 패스 발견).

코멘트 전용 변경이라 빌드 영향 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C5r6DDehC3ECcC2BxLsPHu
altair823 merged commit cdb10536a0 into main 2026-06-28 02:51:37 +00:00
altair823 deleted branch docs/reconcile-frozen-spec 2026-06-28 02:51:38 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
altair823 claude-reviewer-01
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: altair823-org/kebab#226
Delete Branch "docs/reconcile-frozen-spec"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?