3.8 KiB
3.8 KiB
Milestone: 수정 정책과 승인·검증 흐름
위치
- Roadmap: ROADMAP.md
- Phase: PHASE.md
목표
분석 결과를 프로젝트의 두 처리 방식에 따라 보고 또는 수정 단계로 연결한다. 수정 전 보고 방식은 정확한 수정안 해시에 대한 사용자 승인 뒤에만 변경하고, 자동 수정 후 보고 방식은 수정 가능한 경우에만 격리된 작업 가지에서 변경·검증한 뒤 결과를 보고한다.
상태
[계획]
승격 조건
- 없음
구현 잠금
- 상태: 해제
- SDD: 필요
- SDD 문서: SDD.md
- SDD 사유: 사용자 승인 gate, 수정 작업 상태 머신, 정책 분기, 격리된 쓰기와 검증 실패 처리를 다룬다.
- 잠금 해제 조건:
- SDD 잠금이 해제되어 있다.
- SDD 사용자 리뷰가 없거나 해결되어 있다.
- Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
- Evidence Map이 완료 시 검증 가능한 근거와 연결되어 있다.
- 결정 필요: 없음
범위
- 수정 전 보고와 자동 수정 후 보고 정책 분기
- 수정 가능 분석 결과의 수정안 해시 고정
- 수정안 해시 기반 승인·거부 불변 이력
- 격리된 작업 가지에서 IOP 수정 실행
- 프로젝트 검증 명령 실행과 결과 보존
- 수정 불가, 거부, 검증 실패와 취소 종료 처리
기능
Epic: [policy] 처리 방식과 승인
분석 결과를 프로젝트 정책에 맞는 다음 상태로 전이한다.
- [route-mode] 수정 불가 결과는 보고로 종료하고 수정 가능 결과는 프로젝트 처리 방식에 따라 승인 대기 또는 자동 수정으로 전이한다.
- [proposal-approval] 수정 전 보고 방식에서 사용자 승인·거부를 불변 이력으로 저장하고 현재 수정안 해시와 일치하는 승인만 실행에 사용한다.
- [audit-transition] 정책 분기, 승인, 거부, 취소와 자동 수정 결정을 상관관계 ID가 있는 감사 기록으로 남긴다.
Epic: [change] 격리 수정과 검증
허용된 수정안만 격리된 저장소 작업 공간에서 실행한다.
- [isolated-change] 승인 또는 자동 수정 정책이 허용한 수정안 해시로 격리된 작업 가지의 IOP 수정 실행을 시작한다.
- [validate-change] 프로젝트 검증 정책을 실행하고 결과 및 산출물 참조를 실행 이력에 저장한다.
- [safe-failure] 변경 없음, 수정 실패 또는 검증 실패 시 병합 요청 대상으로 표시하지 않고 분석 보고와 표준 실패를 보존한다.
- [workflow-tests] 두 처리 방식, 오래된 승인 해시, 중복 승인, 실패와 취소의 모든 상태 전이를 검증한다. 검증: 상태 머신·경쟁 조건·IOP 연동 검사가 통과한다.
완료 리뷰
- 상태: 없음
- 요청일: 없음
- 완료 근거: 없음
- 검토 항목: 승인 해시 결속, 상태 전이와 검증 실패 시 변경 비전달
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트: 없음
범위 제외
- 운영 환경 수정
- IOP의 직접 병합
- 저장소 제공자 병합 요청 생성
작업 컨텍스트
- 관련 경로:
internal/domain/remediation/,internal/integration/iop/,internal/platform/database/ - 표준선: 수정 전 보고는 승인된 해시만 실행하고 자동 수정은 수정 가능 결과만 실행하며 최종 병합은 사용자에게 남긴다.
- 선행 작업: IOP 분석 실행 연동
- 후속 작업: 오류와 수정 작업 운영 화면, 병합 요청 전달
- 확인 필요: 없음