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

chore(release): bump version 0.17.2 → 0.18.0 + cut fb-41 multi-hop #182

Merged
altair823 merged 1 commits from chore/v0-18-0-cut into main 2026-05-26 05:36:07 +00:00
Conversation 1 Commits 1 Files Changed 9 +86 -32
altair823 commented 2026-05-26 05:18:41 +00:00
Owner
Copy Link

요약

v0.18.0 cut PR — fb-41 multi-hop RAG + NLI verification (PR #176-180) + cleanup/refactor (PR #181) 의 사용자 가시 surface cascade. workspace version bump + 9 docs file 정합. wire / behavior 영향 0 (documentation cascade only).

설계: docs/superpowers/specs/2026-05-25-p9-fb-41-finalize-spec.md (status: completed)
계획: docs/superpowers/plans/2026-05-25-p9-fb-41-finalize-plan.md (status: completed)

변경 사항

Version cascade

  • workspace Cargo.toml: 0.17.2 → 0.18.0. Cargo.lock 자동 24 kebab-* crate cascade.

Frozen design contract (docs/superpowers/specs/2026-04-27-kebab-final-form-design.md)

  • §3.8 Answer / RAG types — RefusalReason 에 NliVerificationFailed + NliModelUnavailable + MultiHopDecomposeFailed 추가. "Multi-hop RAG + NLI verification" sub-section 신규 — ask_multi_hop facade의 decompose → decide → synthesize loop + step 8.5 NLI hook + HopRecord / VerificationSummary 의 wire / config integration 명시.
  • §9 Versioning rules 표 — nli_model_version row 신규 (선택, v0.19+ second adapter wire surface candidate).

Status transitions

  • spec: approved-by-team → completed.
  • plan: approved-by-team → completed (spec_status 도).

User-facing docs

  • README.md — 명령 표의 kebab ask row 에 --multi-hop flag + NLI 옵션 안내 한 단락 (mDeBERTa-v3 XNLI 280 MB 자동 다운로드 / RAM peak ~7-8 GB / threshold tuning 0.5 prod / 0.0 disable / 우회 path).
  • docs/SMOKE.md — [rag] nli_threshold = 0.0 config 예시 + 활성화 절차 + first-run download + RAM 권장 inline 안내.

Handoff + dashboard

  • HANDOFF.md — 한 줄 요약 의 현재 version 0.17.2 → 0.18.0. v0.18.0 cut entry 신규 (fb-41 multi-hop + NLI + cleanup ship). Component 카운트 단락에 fb-41 PR-9 의 kebab-nli + ask_multi_hop 추가 명시. 머지 후 결정 절 맨 위에 v0.18.0 fb-41 entry — S7 hallucination root cause + dogfood retest 측정값 + 5 sub-PR + cleanup 시퀀스 요약.
  • tasks/INDEX.md — p9-fb-41 ⏳ 미구현, brainstorm 필요 → ✅ 머지 (v0.18.0). v0.17.x 옆에 v0.18.0 subsection 신규 — PR #176-181 6 sub-PR + cleanup 각 한 줄 요약.

검증

  • cargo check --workspace -j 1 통과 (모든 24 crate v0.18.0 확인).
  • Cargo.lock 의 모든 kebab-* crate version field = "0.18.0" (autoupgrade by cargo).
  • frozen design 의 RefusalReason enum 확장이 kebab-core 의 production code 와 정합 (PR-9c-1 / PR #178 시점부터 동일 variants 있음 — 본 PR 은 documentation lag closure).
  • 본 PR 은 documentation-only cascade — wire schema / production code 변경 없음.

비범위

  • 추가 fb-41 hotfix (S3 nli_model_unavailable consistent fail — v0.18.1 follow-up, HOTFIXES 의 PR-9 closure entry 의 S3 follow-up subsection 참조).
  • HOTFIXES.md anchor 추가 (이미 PR #180 (PR-9d closure) 에서 fb-41 PR-9 entry 작성 완료).
  • SKILL.md release notes link (이미 PR-9c-2 에서 v0.18+ NLI 안내 inline 추가 완료).

시험 항목 (Test Plan)

  • cargo check --workspace -j 1 통과 — 모든 24 crate v0.18.0.
  • Cargo.lock 의 kebab-* version 자동 cascade.
  • 9 files (Cargo.toml + Cargo.lock + 7 docs) 변경 — all additive doc cascade, behavior / wire 변경 0.
  • frozen design §3.8 + §9 정합 (PR-9c-1 의 wire schema 변경과 production code match).
  • spec/plan status → completed.

머지 후 별 단계: gitea-release v0.18.0 --auto-notes 또는 --notes-file release-notes-v0.18.0.md (spec §5 release notes draft 사용).

Assisted-by: Claude Code

## 요약 v0.18.0 cut PR — fb-41 multi-hop RAG + NLI verification (PR #176-180) + cleanup/refactor (PR #181) 의 *사용자 가시 surface cascade*. workspace version bump + 9 docs file 정합. wire / behavior 영향 0 (documentation cascade only). 설계: docs/superpowers/specs/2026-05-25-p9-fb-41-finalize-spec.md (status: completed) 계획: docs/superpowers/plans/2026-05-25-p9-fb-41-finalize-plan.md (status: completed) ## 변경 사항 ### Version cascade - workspace `Cargo.toml`: 0.17.2 → 0.18.0. Cargo.lock 자동 24 kebab-* crate cascade. ### Frozen design contract (`docs/superpowers/specs/2026-04-27-kebab-final-form-design.md`) - **§3.8** Answer / RAG types — RefusalReason 에 `NliVerificationFailed` + `NliModelUnavailable` + `MultiHopDecomposeFailed` 추가. "Multi-hop RAG + NLI verification" sub-section 신규 — `ask_multi_hop` facade의 decompose → decide → synthesize loop + step 8.5 NLI hook + HopRecord / VerificationSummary 의 wire / config integration 명시. - **§9** Versioning rules 표 — `nli_model_version` row 신규 (선택, v0.19+ second adapter wire surface candidate). ### Status transitions - spec: `approved-by-team` → `completed`. - plan: `approved-by-team` → `completed` (spec_status 도). ### User-facing docs - **README.md** — 명령 표의 `kebab ask` row 에 `--multi-hop` flag + NLI 옵션 안내 한 단락 (mDeBERTa-v3 XNLI 280 MB 자동 다운로드 / RAM peak ~7-8 GB / threshold tuning 0.5 prod / 0.0 disable / 우회 path). - **docs/SMOKE.md** — `[rag] nli_threshold = 0.0` config 예시 + 활성화 절차 + first-run download + RAM 권장 inline 안내. ### Handoff + dashboard - **HANDOFF.md** — 한 줄 요약 의 현재 version 0.17.2 → 0.18.0. v0.18.0 cut entry 신규 (fb-41 multi-hop + NLI + cleanup ship). Component 카운트 단락에 fb-41 PR-9 의 kebab-nli + ask_multi_hop 추가 명시. 머지 후 결정 절 맨 위에 v0.18.0 fb-41 entry — S7 hallucination root cause + dogfood retest 측정값 + 5 sub-PR + cleanup 시퀀스 요약. - **tasks/INDEX.md** — p9-fb-41 `⏳ 미구현, brainstorm 필요` → `✅ 머지 (v0.18.0)`. v0.17.x 옆에 v0.18.0 subsection 신규 — PR #176-181 6 sub-PR + cleanup 각 한 줄 요약. ## 검증 - `cargo check --workspace -j 1` 통과 (모든 24 crate v0.18.0 확인). - Cargo.lock 의 모든 kebab-* crate version field = "0.18.0" (autoupgrade by cargo). - frozen design 의 RefusalReason enum 확장이 kebab-core 의 production code 와 정합 (PR-9c-1 / PR #178 시점부터 동일 variants 있음 — 본 PR 은 *documentation lag* closure). - 본 PR 은 documentation-only cascade — wire schema / production code 변경 없음. ## 비범위 - 추가 fb-41 hotfix (S3 `nli_model_unavailable` consistent fail — v0.18.1 follow-up, HOTFIXES 의 PR-9 closure entry 의 S3 follow-up subsection 참조). - HOTFIXES.md anchor 추가 (이미 PR #180 (PR-9d closure) 에서 fb-41 PR-9 entry 작성 완료). - SKILL.md release notes link (이미 PR-9c-2 에서 v0.18+ NLI 안내 inline 추가 완료). ## 시험 항목 (Test Plan) - [x] cargo check --workspace -j 1 통과 — 모든 24 crate v0.18.0. - [x] Cargo.lock 의 kebab-* version 자동 cascade. - [x] 9 files (Cargo.toml + Cargo.lock + 7 docs) 변경 — all additive doc cascade, behavior / wire 변경 0. - [x] frozen design §3.8 + §9 정합 (PR-9c-1 의 wire schema 변경과 production code match). - [x] spec/plan status → completed. 머지 후 별 단계: `gitea-release v0.18.0 --auto-notes` 또는 `--notes-file release-notes-v0.18.0.md` (spec §5 release notes draft 사용). Assisted-by: Claude Code
altair823 added 1 commit 2026-05-26 05:18:42 +00:00
chore(release): bump version 0.17.2 → 0.18.0 + cut fb-41 multi-hop 98cf4e8a04 
v0.18.0 cut PR. fb-41 multi-hop RAG + NLI verification 의 user-visible surface (PR #176-180) + post-PR9 cleanup/refactor (PR #181) ship 마무리.

## 변경 사항

### Version
- workspace `Cargo.toml`: 0.17.2 → 0.18.0. Cargo.lock 자동 cascade (24 kebab-* crate 모두 0.18.0).

### Frozen design contract
- `docs/superpowers/specs/2026-04-27-kebab-final-form-design.md`:
  - §3.8 RAG types — RefusalReason 에 NliVerificationFailed + NliModelUnavailable + MultiHopDecomposeFailed 추가 + Multi-hop RAG + NLI verification 의 ask_multi_hop facade + step 8.5 NLI hook + HopRecord / VerificationSummary 명시.
  - §9 versioning rules 표 — nli_model_version row 신규 (선택 — v0.19+ second adapter 시 wire surface candidate).

### Status transitions
- `docs/superpowers/specs/2026-05-25-p9-fb-41-finalize-spec.md`: status approved-by-team → completed.
- `docs/superpowers/plans/2026-05-25-p9-fb-41-finalize-plan.md`: status approved-by-team → completed (spec_status 도).

### User-facing docs
- `README.md`: 명령 표의 `kebab ask` row 에 `--multi-hop` flag + NLI 옵션 안내 한 단락 (mDeBERTa-v3 XNLI 280 MB 자동 다운로드 / RAM peak ~7-8 GB / threshold tuning 0.5 prod / 0.0 disable).
- `docs/SMOKE.md`: `[rag] nli_threshold = 0.0` config 예시 + 활성화 절차 + first-run download + RAM 권장 inline 안내.

### Handoff + dashboard
- `HANDOFF.md`: 한 줄 요약 의 현재 version 0.17.2 → 0.18.0. v0.18.0 cut entry 추가 (fb-41 multi-hop + NLI + cleanup ship). Component 카운트 단락에 fb-41 PR-9 의 kebab-nli + ask_multi_hop 추가 명시. 머지 후 결정 절 맨 위에 v0.18.0 fb-41 entry 신규.
- `tasks/INDEX.md`: p9-fb-41 ⏳ → ✅ 머지 (v0.18.0). v0.18.0 subsection 신규 — PR #176-181 의 6 sub-PR + cleanup 각 한 줄 요약.

## 비범위 / 별 작업
- HOTFIXES.md 의 fb-41 entry 는 이미 PR #180 (PR-9d closure) 에서 작성 완료 — 본 cut PR 에서 추가 anchor 불필요.
- SKILL.md 의 v0.18+ NLI 안내는 이미 PR-9c-2 에서 inline 추가 완료.

## 검증
- `cargo check --workspace -j 1` 통과 (모든 24 crate v0.18.0 확인).
- frozen design 의 RefusalReason enum 확장이 kebab-core 의 production code 와 정합 (PR-9c-1 시점부터 동일 variants 있음).

Wire 영향: 없음 (additive minor 는 PR-9c-1 에서 이미 ship, 본 commit 은 documentation cascade only).
Behavior 영향: 없음.

머지 후 `gitea-release v0.18.0` 으로 tag + release notes 작성.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
claude-reviewer-01 approved these changes 2026-05-26 05:19:19 +00:00
claude-reviewer-01 left a comment
Member
Copy Link

회차 1 — v0.18.0 cut PR 검토.

칭찬 (산문, inline 안 함):

  1. frozen design §3.8 의 multi-hop sub-section + RefusalReason 확장 — PR-9c-1 의 wire 변경 (NliVerificationFailed + NliModelUnavailable + MultiHopDecomposeFailed) 이 contract 자체 에 영구 명시. 미래 작업자가 docs/superpowers/specs/2026-04-27-kebab-final-form-design.md 만 읽어도 v0.18 RAG 의 full surface 가시. ask_multi_hop facade + step 8.5 NLI hook + HopRecord + VerificationSummary 의 wire / config integration 모두 한 곳에서 추적.

  2. §9 versioning cascade 의 nli_model_version row — wire 미surface 명시 + v0.19+ second adapter 도입 시 wire surface candidate 명확. 현 시점 zero-cost documentation (HF repo id 가 sanitized cache_dir path 인 implementation detail 이 design 에 명시).

  3. status transition 의 audit accuracy — spec + plan 모두 approved-by-team → completed. spec_review_round=5 / plan_review_round=3 의 audit trail 보존 — 미래 작업자가 어떤 round 의 결정인지 추적 가능.

  4. HANDOFF + INDEX 의 patternconsistency — v0.17.0/v0.17.1/v0.17.2 의 기존 cut entry 패턴 그대로 v0.18.0 entry. 후속 cut PR 도 동일 패턴 으로 자연 확장.

  5. README + SMOKE 의 user-facing surface — --multi-hop + NLI 옵션 + threshold tuning + 우회 path 모두 한 단락 안에 명시. 사용자가 README 만 보고 NLI 활성 방법 + 실패 시 우회 즉시 알 수 있음.

  6. documentation cascade only — wire schema / production code 변경 0. cut PR 의 scope discipline 명확.

추가 actionable 없음. v0.18.0 cut 의 production excellence baseline 도달.

머지 OK. 머지 후 gitea-release v0.18.0 으로 tag + release notes (spec §5 draft) 작성. 추가 후속 작업:

  • v0.18.1 candidate: S3 nli_model_unavailable consistent fail root cause 진단 (HOTFIXES 의 fb-41 PR-9 closure entry 의 S3 follow-up subsection 참조).
  • v0.18.1+ defer: system-architect 가 식별한 architectural items (kebab-normalize 흡수 / Extractor dispatch unification / kebab-source-fs dep lightening).
회차 1 — v0.18.0 cut PR 검토. 칭찬 (산문, inline 안 함): 1. **frozen design §3.8 의 multi-hop sub-section + RefusalReason 확장** — PR-9c-1 의 wire 변경 (NliVerificationFailed + NliModelUnavailable + MultiHopDecomposeFailed) 이 *contract 자체* 에 영구 명시. 미래 작업자가 `docs/superpowers/specs/2026-04-27-kebab-final-form-design.md` 만 읽어도 *v0.18 RAG 의 full surface* 가시. ask_multi_hop facade + step 8.5 NLI hook + HopRecord + VerificationSummary 의 wire / config integration 모두 한 곳에서 추적. 2. **§9 versioning cascade 의 nli_model_version row** — wire 미surface 명시 + v0.19+ second adapter 도입 시 wire surface candidate 명확. 현 시점 *zero-cost* documentation (HF repo id 가 sanitized cache_dir path 인 implementation detail 이 design 에 명시). 3. **status transition 의 audit accuracy** — spec + plan 모두 `approved-by-team` → `completed`. spec_review_round=5 / plan_review_round=3 의 audit trail 보존 — 미래 작업자가 *어떤 round 의 결정인지* 추적 가능. 4. **HANDOFF + INDEX 의 patternconsistency** — v0.17.0/v0.17.1/v0.17.2 의 기존 cut entry 패턴 그대로 v0.18.0 entry. 후속 cut PR 도 *동일 패턴* 으로 자연 확장. 5. **README + SMOKE 의 user-facing surface** — `--multi-hop` + NLI 옵션 + threshold tuning + 우회 path 모두 *한 단락* 안에 명시. 사용자가 README 만 보고 NLI 활성 방법 + 실패 시 우회 즉시 알 수 있음. 6. **documentation cascade only** — wire schema / production code 변경 0. cut PR 의 *scope discipline* 명확. 추가 actionable 없음. v0.18.0 cut 의 *production excellence baseline* 도달. 머지 OK. 머지 후 `gitea-release v0.18.0` 으로 tag + release notes (spec §5 draft) 작성. 추가 후속 작업: - v0.18.1 candidate: S3 `nli_model_unavailable` consistent fail root cause 진단 (HOTFIXES 의 fb-41 PR-9 closure entry 의 S3 follow-up subsection 참조). - v0.18.1+ defer: system-architect 가 식별한 architectural items (kebab-normalize 흡수 / Extractor dispatch unification / kebab-source-fs dep lightening).
altair823 merged commit 08495eb425 into main 2026-05-26 05:36:07 +00:00
altair823 deleted branch chore/v0-18-0-cut 2026-05-26 05:36:08 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
claude-reviewer-01
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
altair823 claude-reviewer-01
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: altair823-org/kebab#182
Delete Branch "chore/v0-18-0-cut"

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?