Sync docs with current compatibility status

[midagedev]

Summary

• Update README positioning and compatibility snapshot for the current 144/587 OpenAPI inventory baseline.
• Sync gate, release readiness, tracking, and 90% target docs with the latest scorecard/inventory evidence.
• Document the invoice preview SDK schema update in validation and API contract docs.
• Refresh quickstart/runbook install and scenario command snippets.

Verification

• git diff --check
• Public keyword scan: rg -n -i "dentbird|imagoworks|\bds1\b|\bds4\b" . --glob '!.git/' --glob '!node_modules/' --glob '!dist/**' --glob '!package-lock.json'
• go run ./cmd/billtap compatibility scorecard --output-dir /tmp/billtap-scorecard-doc-sync
• go run ./cmd/billtap compatibility inventory --openapi /tmp/stripe-openapi-spec3.json --output-dir /tmp/billtap-inventory-doc-sync --source stripe-openapi-local

[claude]

APPROVE

Summary

이 PR은 PR #50 이후의 현재 호환성 상태를 반영하도록 문서를 동기화하는 문서 전용 변경입니다. 코드 변경은 없습니다.

변경 사항

1. 호환성 베이스라인 업데이트: 110 / 587 (18.7%) → 144 / 587 (24.5%)

   • README.md에 Stripe API inventory 행 추가
   • COMPATIBILITY_TRACKING.md, STRIPE_COMPATIBILITY_90_TARGET.md, STRIPE_API_COMPATIBILITY_ROADMAP.md 업데이트
   • GATE_STATUS.md의 G14 베이스라인 업데이트

2. 인보이스 프리뷰 SDK 스키마 문서화

   • docs/API_VALIDATION_AND_ERROR_SIMULATION.md: 인보이스 프리뷰 응답에 SDK 모델에 필요한 Stripe Invoice 기본 필드가 포함됨을 명시
   • specs/000-product/contracts/api.md: 프리뷰 응답에 포함된 필드 목록 구체화

3. 퀵스타트/런북 스니펫 개선

   • docs/runbooks/local-dev.md: npm install → npm ci
   • specs/000-product/quickstart.md: npm install → npm ci, STRIPE_API_BASE → STRIPE_API_BASE_URL, 시나리오 명령어 경로 수정

4. 상태 날짜 업데이트: 2026-05-11 → 2026-05-12

검증

• git diff --check: 통과 (공백 문제 없음)
• 공개 키워드 스캔: 민감한 데이터 없음
• 변경사항은 일관되며 PR #50의 베이스라인 변경과 일치합니다

결론

블로킹 이슈 없음. 문서 동기화가 올바르게 수행되었습니다.

_{Reviewed by Z.ai GLM via Claude Code Action}