# Milestone: 지속 갱신 Orchestration

## 위치

- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
- Phase: [PHASE.md](../PHASE.md)

## 목표

source 변화와 정기 schedule을 기준으로 수집·정제·인덱싱·평가를 반복하고 candidate release까지 만드는 표준 갱신 workflow를 제공한다. 초기 운영에서 production 승격은 자동화하지 않고 명시적 gate 뒤에 둔다.

## 상태

[스케치]

## 승격 조건

- [ ] schedule, source event와 수동 실행의 trigger 중복 제거 규칙을 확정한다.
- [ ] knowledge base별 refresh policy와 동시 실행 제한을 정의한다.
- [ ] 실패 지점부터 재개할 artifact·revision 기준을 정의한다.
- [ ] [평가와 승격 Gate](../../quality-governance/milestones/evaluation-and-promotion-gates.md)의 candidate handoff 계약을 연결한다.
- [x] lifecycle·schedule·candidate handoff를 다루는 SDD 필요성을 확정하고 SDD를 작성했다.

## 구현 잠금

- 상태: 잠금
- SDD: 필요
- SDD 문서: [SDD.md](../../../sdd/workflow-automation/continuous-refresh-orchestration/SDD.md)
- SDD 사유: trigger deduplication, 동시 실행, checkpoint·resume과 candidate handoff 상태 계약을 정의한다.
- 잠금 해제 조건:
  - [x] SDD 잠금이 해제되어 있다.
  - [x] SDD 사용자 리뷰가 없거나 승인/해결되었다.
  - [x] Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
  - [x] Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
  - [ ] 모든 승격 조건이 해소되고 Milestone 상태가 `[계획]`이다.
- 결정 필요: 없음

## 범위

- schedule, source event와 수동 trigger의 표준 입력
- source revision 기반 deduplication과 concurrent run 제한
- 수집부터 candidate evaluation까지의 reference workflow
- 단계별 artifact checkpoint와 실패 재개
- refresh history, 비용·duration·freshness 지표

## 기능

### Epic: [refresh] 반복 갱신 루프

프로젝트마다 재구현하지 않아도 되는 기본 RAG 최신화 workflow를 정의한다.

- [ ] [trigger-policy] schedule·event·manual trigger를 정규화하고 같은 source revision의 중복 run을 막는다.
- [ ] [reference-flow] ingest, normalize, dataset, index, evaluate 단계를 versioned reference workflow로 제공한다.
- [ ] [checkpoint-resume] 완료 artifact와 revision을 재사용해 실패 단계부터 안전하게 재개한다.
- [ ] [candidate-handoff] 통과·실패한 평가 결과와 candidate release를 승격 gate에 전달한다.
- [ ] [refresh-observability] freshness lag, 처리량, 비용, 실패 단계와 다음 예정 실행을 노출한다.

## 완료 리뷰

- 상태: 없음
- 요청일: 없음
- 완료 근거: 스케치 단계이며 `[계획]` 승격 뒤 기록한다.
- 검토 항목: 승격 조건과 후속 SDD gate
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트: 없음

## 범위 제외

- evaluation 통과만으로 production release 자동 승격
- 외부 범용 workflow 제품의 모든 기능 재구현
- 무제한 병렬 refresh

## 작업 컨텍스트

- 관련 경로: `packages/go/workflow/`, `packages/go/controlplane/`, `db/`
- 표준선(선택): candidate build와 explicit promotion 분리, revision 기반 idempotency
- 선행 작업: [내구성 있는 Workflow Runtime](durable-workflow-runtime.md), [평가와 승격 Gate](../../quality-governance/milestones/evaluation-and-promotion-gates.md)
- 후속 작업: [Drift와 선별 Feedback](../../quality-governance/milestones/drift-and-selective-feedback.md)
- 확인 필요: 없음