refactor(parse-md): absorb kebab-normalize + kebab-parse-types — 24 → 22 crates + §3.7b 재작성

design §3.7b 의 thin layer (ParsedBlock 류) 가 4 parser 중 1개 (markdown) 만 lift 를
경유하는 현실 — fan-in/fan-out 모두 1 → layer 의미 잃음. kebab-normalize (1097 LOC)
+ kebab-parse-types (98 LOC) 둘을 kebab-parse-md 로 흡수.

설계: docs/superpowers/specs/2026-05-26-normalize-absorption-spec.md
플랜: docs/superpowers/plans/2026-05-26-normalize-absorption-plan.md
HOTFIXES: tasks/HOTFIXES.md 의 2026-05-26 entry (design deviation)

- 5 사용 type + 3 forward-declared struct → kebab-parse-md::types module 의 pub explicit re-export.
- build_canonical_document + derive_title + warning_agent → kebab-parse-md::normalize module.
- 4 hard-coded agent literal (lib.rs:122/128/134/153) + warning_agent body return + tracing target literal 모두 보존 — stage label 일관성.
- kebab-app callsite (lib.rs:51 use + :1119 context string) + Cargo.toml 의 2 dep (regular + dead) 제거.
- kebab-chunk + kebab-store-sqlite 의 [dev-dependencies] kebab-normalize → 제거 (kebab-parse-md 로 갈음). 통합 test source 의 use shift.
- test file 이동 (kebab-normalize/tests/normalize_snapshot.rs → kebab-parse-md/tests/).
- workspace Cargo.toml: Hunk (a) members 2 entry 삭제 + Hunk (b) version 0.18.0 → 0.19.0 (frozen contract 변경).
- design §3.7b 4-단락 재작성 (원래 intent 보존 + 현재 상태 + 보존된 surface + future re-extraction trigger).
- design §8 graph 갱신 (3 edge 제거 + 2 forbidden bullet 의미 갱신 + commentary).
- ARCHITECTURE.md crate graph + directory tree mechanical 갱신.
- tasks/INDEX.md L169 closure mention + "Future work / deferred" 섹션 신설 (image/pdf normalize integration entry).
- tasks/HOTFIXES.md 신규 entry (4-block — design deviation Symptom).
- HANDOFF.md cross-link 한 줄.
- 3 dead struct (ParsedImageRegion / ParsedPdfPage / ParsedAudioSegment) 는 보존 — v0.20+ image/pdf normalize integration 의 future surface (spec §11).

Wire / surface impact: 0건. CLI / TUI / MCP / --json 출력 / config / XDG path /
parser_version 모두 unchanged. wire-invisible provenance.events[].agent + tracing target
literal "kb-normalize" 도 보존 — old DB row 와 new DB row 의 audit log 일관성.

Verification: cargo test --workspace --no-fail-fast -j 1 → 1313 passed / 0 failed (172 result blocks).
cargo clippy --workspace --all-targets -j 1 -- -D warnings → 0 warning (5m 46s).
cargo metadata --no-deps --format-version 1 | jq '.workspace_members | length' = 22.
cargo tree -p kebab-app --depth 2 | grep -E "kebab_(parse_types|normalize)" = 0 줄.
This commit is contained in:
2026-05-26 15:00:59 +00:00
parent d4395a306b
commit 710945c4b0
26 changed files with 2136 additions and 195 deletions

73
Cargo.lock generated
View File

@@ -4127,7 +4127,7 @@ dependencies = [
[[package]]
name = "kebab-app"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"base64 0.22.1",
@@ -4143,12 +4143,10 @@ dependencies = [
"kebab-llm",
"kebab-llm-local",
"kebab-nli",
"kebab-normalize",
"kebab-parse-code",
"kebab-parse-image",
"kebab-parse-md",
"kebab-parse-pdf",
"kebab-parse-types",
"kebab-rag",
"kebab-search",
"kebab-source-fs",
@@ -4173,12 +4171,11 @@ dependencies = [
[[package]]
name = "kebab-chunk"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"blake3",
"kebab-core",
"kebab-normalize",
"kebab-parse-code",
"kebab-parse-md",
"serde_json",
@@ -4190,7 +4187,7 @@ dependencies = [
[[package]]
name = "kebab-cli"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"clap",
@@ -4211,7 +4208,7 @@ dependencies = [
[[package]]
name = "kebab-config"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"dirs 5.0.1",
@@ -4226,7 +4223,7 @@ dependencies = [
[[package]]
name = "kebab-core"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"blake3",
@@ -4240,7 +4237,7 @@ dependencies = [
[[package]]
name = "kebab-embed"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"blake3",
@@ -4254,7 +4251,7 @@ dependencies = [
[[package]]
name = "kebab-embed-local"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"fastembed",
@@ -4267,7 +4264,7 @@ dependencies = [
[[package]]
name = "kebab-eval"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"kebab-app",
@@ -4286,7 +4283,7 @@ dependencies = [
[[package]]
name = "kebab-llm"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"kebab-core",
@@ -4295,7 +4292,7 @@ dependencies = [
[[package]]
name = "kebab-llm-local"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"kebab-config",
@@ -4312,7 +4309,7 @@ dependencies = [
[[package]]
name = "kebab-mcp"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"kebab-app",
@@ -4330,7 +4327,7 @@ dependencies = [
[[package]]
name = "kebab-nli"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"hf-hub",
@@ -4343,24 +4340,9 @@ dependencies = [
"tracing",
]
[[package]]
name = "kebab-normalize"
version = "0.18.0"
dependencies = [
"anyhow",
"kebab-core",
"kebab-parse-md",
"kebab-parse-types",
"serde",
"serde_json",
"time",
"tracing",
"unicode-normalization",
]
[[package]]
name = "kebab-parse-code"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"gix",
@@ -4383,7 +4365,7 @@ dependencies = [
[[package]]
name = "kebab-parse-image"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"ab_glyph",
"anyhow",
@@ -4407,11 +4389,10 @@ dependencies = [
[[package]]
name = "kebab-parse-md"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"kebab-core",
"kebab-parse-types",
"lingua",
"pulldown-cmark",
"serde",
@@ -4420,11 +4401,12 @@ dependencies = [
"time",
"toml",
"tracing",
"unicode-normalization",
]
[[package]]
name = "kebab-parse-pdf"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"blake3",
@@ -4435,17 +4417,9 @@ dependencies = [
"tracing",
]
[[package]]
name = "kebab-parse-types"
version = "0.18.0"
dependencies = [
"kebab-core",
"serde",
]
[[package]]
name = "kebab-rag"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"blake3",
@@ -4467,7 +4441,7 @@ dependencies = [
[[package]]
name = "kebab-search"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"globset",
@@ -4486,7 +4460,7 @@ dependencies = [
[[package]]
name = "kebab-source-fs"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"blake3",
@@ -4504,7 +4478,7 @@ dependencies = [
[[package]]
name = "kebab-store-sqlite"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"blake3",
@@ -4512,7 +4486,6 @@ dependencies = [
"kebab-chunk",
"kebab-config",
"kebab-core",
"kebab-normalize",
"kebab-parse-md",
"refinery",
"rusqlite",
@@ -4525,7 +4498,7 @@ dependencies = [
[[package]]
name = "kebab-store-vector"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"arrow",
@@ -4549,7 +4522,7 @@ dependencies = [
[[package]]
name = "kebab-tui"
version = "0.18.0"
version = "0.19.0"
dependencies = [
"anyhow",
"crossterm",