ariadne/agent-roadmap/phase/error-intelligence/milestones/analysis-target-selection.md
2026-07-24 05:45:04 +09:00

3.4 KiB

Milestone: 분석 대상 결정과 실행 스냅샷

위치

목표

오류 입력 출처와 source 필드를 등록된 우선순위 규칙에 대조해 분석할 저장소와 읽기 전용 운영 환경을 결정한다. 선택 결과와 기준 리비전을 수정 작업에 복사해 이후 설정 변경이 진행 중 실행의 의미를 바꾸지 않게 한다.

상태

[계획]

승격 조건

  • 없음

구현 잠금

  • 상태: 해제
  • SDD: 필요
  • SDD 문서: SDD.md
  • SDD 사유: 결정적 규칙 평가, revision 보존, 실패 처리와 수정 작업 DB lifecycle을 다룬다.
  • 잠금 해제 조건:
    • SDD 잠금이 해제되어 있다.
    • SDD 사용자 리뷰가 없거나 해결되어 있다.
    • Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
    • Evidence Map이 완료 시 검증 가능한 근거와 연결되어 있다.
  • 결정 필요: 없음

범위

  • 입력 출처와 source 필드의 정확 일치 및 빈 조건의 포괄 일치
  • 낮은 숫자 우선순위부터 첫 일치 규칙 선택
  • 대상 없음 또는 비활성 연결의 표준 실패 기록
  • 저장소 기준 리비전 확인
  • 저장소, 기준 리비전과 운영 환경 목록의 수정 작업 스냅샷

기능

Epic: [selection] 결정적 대상 선택

같은 설정과 오류에 항상 같은 선택 결과를 낸다.

  • [match-rule] 입력 출처와 source 필드를 활성 규칙에 대조하고 가장 낮은 우선순위의 첫 일치 규칙을 선택한다.
  • [validate-target] 선택된 저장소와 운영 환경이 같은 조직·프로젝트에 속하고 활성 상태인지 확인한다.
  • [no-target-failure] 일치 규칙이나 유효한 대상이 없으면 target_selection 단계의 표준 실패를 기록하고 분석을 시작하지 않는다.

Epic: [snapshot] 실행 입력 고정

진행 중 설정 변경으로부터 수정 작업을 격리한다.

  • [resolve-revision] 저장소 제공자 경계에서 기준 가지의 불변 리비전을 확인한다.
  • [create-run] 선택된 저장소, 기준 리비전, 운영 환경 목록과 처리 방식을 수정 작업 및 하위 대상 이력에 원자적으로 저장한다.
  • [selection-tests] 우선순위, 포괄 조건, 설정 변경 후 스냅샷 불변성과 교차 조직 참조 차단을 검증한다. 검증: 규칙 단위 검사와 PostgreSQL 통합 검사가 통과한다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 없음
  • 검토 항목: 결정성, 리비전 보존과 표준 실패 근거
  • agent-ui 상태 반영: 해당 없음
  • 리뷰 코멘트: 없음

범위 제외

  • LLM을 사용한 추론 기반 대상 선택
  • 여러 저장소를 동시에 수정하는 작업
  • 운영 환경 쓰기

작업 컨텍스트

  • 관련 경로: internal/platform/database/migrations/, internal/domain/remediation/, internal/integration/
  • 표준선: 규칙은 정확 일치와 명시 우선순위만 사용하고 선택 결과를 실행 이력에 복사한다.
  • 선행 작업: 오류 수집과 중복 통합
  • 후속 작업: IOP 분석 실행 연동
  • 확인 필요: 없음