rara/agent-roadmap/phase/rag-serving/milestones/index-publication-and-release.md

Milestone: Index 게시와 Release 수명주기

위치

• Roadmap: ROADMAP.md
• Phase: PHASE.md

목표

retrieval dataset version을 backend별 후보 index로 게시하고, 평가 가능한 불변 release로 묶는다. production alias 전환과 rollback은 원자적·명시적으로 수행하며 온라인 요청이 부분 게시 상태를 보지 않게 한다.

상태

[계획]

구현 잠금

• 상태: 해제
• SDD: 필요
• SDD 문서: SDD.md
• SDD 사유: index publish, release 상태 머신, alias promotion·rollback과 backend identity 계약을 정의한다.
• 잠금 해제 조건:
  • SDD 잠금이 해제되어 있다.
  • SDD 사용자 리뷰가 없거나 승인/해결되었다.
  • Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
  • Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
• 결정 필요: 없음

범위

• retrieval policy와 embedding·backend capability 사전 검증
• candidate index build·publish와 external backend identity
• dataset, index artifact, policy snapshot을 묶는 immutable release
• candidate, active, retired, failed 상태와 alias version
• transaction 기반 explicit promotion과 rollback
• orphan index 정리와 backend reconciliation

기능

Epic: [index] Candidate Index 게시

완료되지 않은 index가 온라인 alias에 노출되지 않게 게시 단계를 분리한다.

• [preflight] dataset schema, embedding dimension, backend capability와 retrieval policy 호환성을 build 전에 검증한다.
• [candidate-build] content-addressed dataset과 policy로 candidate index를 만들고 external identity와 manifest를 기록한다.
• [publish-reconcile] backend publish 결과를 멱등하게 반영하고 timeout·부분 실패 뒤 상태를 reconciliation한다.

Epic: [release] 명시적 Release 전환

온라인 소비자가 항상 하나의 완전한 release identity를 보게 한다.

• [release-snapshot] dataset version, index identity와 retrieval·generation policy를 immutable release content로 묶는다.
• [alias-promotion] release와 evaluation evidence를 연결한 명시적 promotion decision을 받아 candidate를 active alias로 원자적으로 승격한다.
• [rollback-retire] 이전 release로 alias를 롤백하고 더 이상 참조되지 않는 index를 안전하게 retire한다. 검증: promotion 경쟁, rollback과 backend failure 통합 테스트가 통과한다.

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 모든 기능 Task와 검증 충족 및 구현 잠금 해제 여부를 완료 시 기록한다.
• 검토 항목: partial publish, concurrent promotion, rollback과 backend reconciliation
• agent-ui 상태 반영: 해당 없음
• 리뷰 코멘트: 없음

범위 제외

• 평가 결과만으로 production 자동 승격
• retrieval backend 내부 index 포맷 통일
• mutable production index의 in-place update

작업 컨텍스트

• 관련 경로: packages/go/controlplane/, packages/go/integration/, db/
• 표준선(선택): candidate-before-active, immutable release, explicit alias transaction
• 선행 작업: 수집과 Dataset 수명주기, 내구성 있는 Workflow Runtime
• 후속 작업: Retrieve와 Answer Pipeline, 평가와 승격 Gate
• 확인 필요: 없음