Files

altair823 2fd13db209 docs(p9-fb-23): README + HANDOFF + HOTFIXES + INDEX + per-task spec

Also fixes snapshot drift in code-and-table.canonical.snapshot.json
introduced by task 2 (CanonicalDocument gains last_chunker_version +
last_embedding_version fields).

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

2026-05-04 18:27:05 +00:00

1.8 KiB

Raw Blame History

phase, component, task_id, title, status, depends_on, unblocks, contract_source, contract_sections, source_feedback

phase

component

task_id

title

status

depends_on

unblocks

contract_source

contract_sections

source_feedback

kebab-app

p9-fb-23

Incremental ingest — skip unchanged docs (post-merge dogfooding)

completed

p9-fb-03

p9-fb-07

../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md

§9 Versioning cascade

§2.4a IngestEvent

§3.x IngestReport

사용자 도그푸딩 2026-05-04 — 변하지 않은 문서 재처리 회피 요청.

p9-fb-23 — Incremental ingest

상세 설계: docs/superpowers/specs/2026-05-04-p9-fb-23-incremental-ingest-design.md. 구현 계획: docs/superpowers/plans/2026-05-04-p9-fb-23-incremental-ingest.md.

Goal

kebab ingest 가 변경/신규 doc 만 처리. 변하지 않은 doc 은 parse/chunk/embed/vector upsert 모두 회피.

Behavior contract

Skip 조건 4 모두 만족:

신규 blake3 == assets.checksum.
documents.parser_version == 현 active.
documents.last_chunker_version == 현 active.
documents.last_embedding_version == 현 active (None == None 도 match).

위 중 하나라도 mismatch → 정상 path. parse/chunk/embed/vector upsert 모두.

IngestOpts.force_reingest=true → skip 무시 강제 재처리.

Tests

통합: 두 번째 ingest 가 unchanged 1 / new 0 / updated 0.
통합: --force-reingest 가 skip 우회.
단위: V006 migration, SQLite put/get_document roundtrip 신규 컬럼, get_asset_by_workspace_path roundtrip.
통합: 첫 ingest 가 chunker/embedding version stamp.

Risks / notes

mtime pre-hash skip 미구현 (YAGNI, 후속 가능).
외부 embedder model swap 후 config 갱신 안 하면 silently skip — doctor 명령이 mismatch 감지하는 후속 task 가능.

Live deviations 반영 위치: tasks/HOTFIXES.md 2026-05-04 — p9-fb-23 항목.

1.8 KiB Raw Blame History