[landing] 읽기 커맨드 보강: docs ls(배치/메타 필터), descriptors --summary/--export, jobs --failed

[younjihoon]

목표

올린 뒤 "무엇이 들어갔고 무엇이 아직 안 파생됐나"를 CLI 에서 볼 수 있게.

동작

cloudbtl docs ls [--batch <id>] [--source onedrive] [--meta division=LM] [--since 7d] [--json]
cloudbtl descriptors <id> --summary          # (kind, producer, version, count)
cloudbtl descriptors <id> --export out.jsonl # payload 전체를 JSON-lines 로
cloudbtl jobs <id> --failed
cloudbtl jobs --batch <id> --status failed   # 배치 전체의 실패 목록

• 서버 의존: 스코프 안 문서를 ingestBatch/source/metadata/기간으로 필터하는 list API 와, 배치 단위 jobs 조회가 아직 없음(cloudbtl-site 백로그 — 스펙 §11 알려진 한계 5). 그 전까지 docs ls 는 GET /api/me/proposals 를 클라이언트에서 필터.
• --export 는 인덱스 적재기(웨어하우스)가 쓰는 원본 형태 유지.

완료 기준

• docs ls --batch X --json | jq length 가 그 배치의 랜딩 수와 같다.
• descriptors --summary 가 서버 /descriptors/summary 와 같은 내용을 표로 보인다.

[younjihoon]

Server side landed (cloudbtl-site 860dfcc, api rev 00057, spec 1.1.0 §5.8): GET /api/documents (filters q source batch lineage type kind missingKind producer missingProducer baseline limit cursor), GET /api/documents/stats, POST /api/documents/exists {hashes}. docs ls / docs stat can map 1:1; missingProducer=<me> is the pending list for #4 watch. Also: baseline 1.1.0 now extracts pptx/docx/xlsx text server-side, so #1's Office part is only needed for the free/pro local path.