[donghyuck]

Why

파일 상세 metadata 조회 지연을 줄이고, 기존 문서의 요약 누락 또는 enrichment 실패를 복구해야 합니다. 원문 요약은 canonical metadata로 보존하면서 한국어 표시를 제공하고, 파일마다 동일한 추천 질문을 반복 생성하지 않도록 현재 revision 신호 기반 결과를 재사용합니다.

What

• bounded metadata summary 조회와 현재 revision 요약 재추출 API를 추가했습니다.
• provider 오류를 502/503 계열의 안정적인 오류 계약으로 분류하고 JSON schema 기반 추출을 적용했습니다.
• 원문 summary와 keywords를 변경하지 않는 한국어 번역 artifact 및 revision/source hash 기반 재사용 정책을 추가했습니다.
• 문서 품질, 색인 상태, 검색 가능성을 구분하는 사용 가능성 API와 자동 retrieval 평가 투영을 추가했습니다.
• 현재 revision metadata와 vector 신호로 최대 3개의 결정적 추천 질문을 생성하고 fingerprint가 같으면 재사용합니다.
• RAG capabilities에 추천 질문 지원 여부를 additive 필드로 노출했습니다.

Related Issues

• 별도 Issue 없음 — 사용자 요청으로 직접 진행한 예외입니다.

Validation

• Command: ./gradlew :studio-platform-document-metadata:test :studio-platform-markdown:test :starter:studio-platform-starter-ai:test :starter:studio-platform-starter-markdown:test --no-daemon
• Result: BUILD SUCCESSFUL
• Command: ./gradlew :studio-platform-ai:test :starter:studio-platform-starter-ai-web:test :starter:studio-platform-starter-markdown:test --no-daemon
• Result: BUILD SUCCESSFUL
• Command: git diff --cached --check
• Result: 통과

Risk / Rollback

• Risk: metadata 재추출은 provider 상태와 현재 revision 일치 여부에 영향을 받으며, 번역과 추천 질문 cache는 source hash 및 policy fingerprint 계약에 의존합니다.
• Rollback: 두 기능 커밋을 역순으로 revert하면 기존 metadata 조회 및 RAG 계약으로 복원할 수 있습니다.

AI / Subagent Usage

• AI-assisted: Yes
• Subagent used: No
• Delegated scope: 없음
• Main author validation: 독립 clean worktree에서 대상 모듈 테스트와 diff 검사를 수행했습니다.

Checklist

• commit message follows policy
• issue template used or exception recorded
• AI-Assisted value is correct
• validation recorded
• subagent usage recorded when used
• CI / repository verification passed
• human review completed before merge
• no unrelated changes included