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

40 Releases 40 Tags

RSS Feed
  • v0.15.0 7a90df1485
    Compare

    v0.15.0 Stable

    altair823 released this 2026-05-21 12:28:05 +00:00 | 353 commits to main since this release

    p10-3: Tier 3 paragraph + line-window fallback

    New code-text-paragraph-v1 chunker — paragraph + line-window split for shell scripts and as a fallback for Tier 1/2 0-chunk / Err results.

    Surface changes (dogfood-visible)

    • 새 chunker code-text-paragraph-v1 — blank-line paragraph segmentation + 80-line / 20-overlap line-window split for paragraphs > 80 lines. symbol = None, lang preserved from input.
    • shell direct routing: .sh / .bash / .zsh 파일이 ingest_one_code_asset 의 새 "shell" arm 으로 Tier 3 chunker 에 직결.
    • Tier 1/2 → Tier 3 fallback wrapper: Tier 1/2 chunker 가 Ok(empty) (예: p10-2 의 비-k8s YAML / invalid YAML) 또는 Err 면 자동으로 Tier 3 retry. extract 가 Err (Tier 1 extractor 실패) 도 동일 fallback. retry 시 chunker_version → "code-text-paragraph-v1" + canonical.parser_version → "none-v1" swap 으로 downstream stamping 일관.
    • --code-lang shell filter 옵션 추가.
    • fallback path 의 try_skip_unchanged 정확성 (review fix): 동일 파일 re-ingest 시 Unchanged 정상 동작. 이전 fix 전에는 매 ingest 가 Updated 로 보고되어 embedder 가 매번 호출되는 잠재 비용 — 동일 PR fix 로 해결. tier3_yaml_fallback_reingest_is_unchanged regression test 가 invariant 보장.

    Wire schema

    Additive — Citation::Code.lang 의 "shell" 값 + Citation::Code.symbol = null 의 Tier 3 chunk 들이 새로 등장. chunker_version 의 "code-text-paragraph-v1" 값 등장. wire schema 본문 변경 0.

    Frozen design

    • 2026-04-27-kebab-final-form-design.md §10 활성화 로그에 p10-3 entry 추가.
    • code_lang_for_path (design §3.5) 의 shell 매핑은 1A-1 시점부터 이미 존재 — 변경 없음.

    DB / migration

    없음.

    Followups (non-blocking, code-reviewer flagged)

    • tier3_fallback_cv 매핑이 explicit list (lang 추가 시 list 갱신 필요) — 미래 Tier 1/2 lang 추가 시 maintenance footgun. parser_version match 가 unknown lang 을 bail!하므로 live bug 는 아님.
    • Tier 3 chunker 의 policy_hash 가 paragraph 마다 재계산 (Tier 2 의 hoisted-once 패턴과 다름). 성능 영향 미미하지만 일관성 위해 별 PR 검토.
    • text_doc test helper 의 ParserVersion("code-text-paragraph-v1") 는 cosmetic 부정확 — 실제로는 "none-v1". 별 PR.

    Branch / PR

    • PR: #155 — code-reviewer 가 critical issue 발견 → in-PR fix → APPROVE → 머지 (merge commit 7a90df1).
    • Spec: tasks/p10/p10-3-tier3-paragraph-fallback.md. Plan: docs/superpowers/plans/2026-05-21-p10-3-tier3-paragraph-fallback.md.

    Stats

    • 19 files (PR meta) — Tier 3 모듈 1개, helper 추가, ingest dispatch + fallback wrapper, 6 docs, frozen design, version bump.
    • cargo test --workspace --no-fail-fast -j 1 PASS, cargo clippy --workspace --all-targets -- -D warnings clean.
    • 신규 테스트: kebab-chunk 4 unit (paragraph split / line-window / empty / lang preservation) + kebab-app code_ingest_smoke 4 integration (shell + yaml fallback + 2 reingest-unchanged regression). 14 + 2 추가 = 16 total smoke tests.
    Downloads