컨테이너 안(docker exec)에서 실행하는 3-subcommand CLI:
list — awaiting_split 보류 큐 행(문서·tier·over%·토큰·초과 섹션·보류/재개 시각)
export — 문서 통계+hier 개요(overview.md)·자동 pack 유닛 제안(summarize_units
재사용)·초과 섹션 (start,end) 스팬+본문 덤프(섹션당 파일, 200K자 분할,
파일명에 절대 오프셋)·boundaries 템플릿 JSON(자동팩 채움+초과=todo 마커)
+README(유인 클로드 세션 작업 안내)
apply — 경계 검증(단조증가·비중첩·본문 범위·커버리지 90%+공백 경고·유닛 캡
초과 시 유닛 명시 거부·todo 잔존 거부·source_len 드리프트 거부) 통과 시
payload.presegment.units_override 기록 + awaiting_split=false +
deferred_until 제거(즉시 재개) + status pending·alerted_at/map_results
정리. --dry-run 지원.
stdout = 사람이 읽는 요약 + '{' 로 시작하는 기계 파싱용 JSON 라인.
DB 접속 = 기존 scripts/ 패턴(DATABASE_URL env, backfill_tier.py 동형).
마이그레이션 없음 — payload JSONB 만 사용.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
hyungi
9061f2e25c