toki
8620512d32
Ornith provider pool의 현재 구성과 동시성 검증 근거를 일치시키고, stream gate 운영 모드와 관련 작업 규칙을 함께 추적하기 위해 반영한다.
3.6 KiB
3.6 KiB
Milestone: [gate-01] StreamGate 경량 통과 모드
위치
- Roadmap: ROADMAP.md
- Phase: PHASE.md
목표
전역 StreamGate의 응답 수명주기는 유지하면서 의미 필터, 응답 보류와 자동 복구 없이 최소 확인과 동기 추적만 수행하는 경량 통과 모드를 추가한다. 기존 필터 동작은 그대로 유지하고 설정으로 두 동작을 명확히 구분한다.
상태
[스케치]
승격 조건
- 경량 통과 모드의 최소 확인 범위와 관측 항목을 확정한다.
- 기존 필터 동작과 경량 통과 모드를 구분하는 설정 형태와 기본값을 확정한다.
- 설정 변경이 포함되므로
[계획]승격 시 SDD 필요 여부를 다시 판정한다.
구현 잠금
- 상태: 잠금
- SDD: 불필요
- SDD 문서: 없음
- SDD 사유: 현재는 모드 의미와 경계를 정하는 스케치이며, 설정·상태 전이 구현 범위가 확정되지 않았다.
[계획]승격 시 SDD 필요 여부를 다시 판정한다. - 잠금 해제 조건: 승격 조건 충족
- 결정 필요: 아래 목록
- 경량 통과에서 남길 최소 동기 관측 항목
- 설정 이름과 기본값
범위
- 전역 StreamGate의 경량 통과 설정
- 최소 확인과 동기 추적
- 의미 필터, provider filter capability 승인, 응답 보류와 자동 복구 없이 기존 release 경로로 전달하는 동작
- 기존 필터 동작과 경량 통과 동작의 기본 회귀 검증
기능
Epic: [light-pass] 경량 통과 모드
기존 공통 StreamGate 수명주기를 유지하면서 요청을 지연시키는 필터 동작만 제외한다.
- [mode-config] 기존 필터 동작과 경량 통과 동작을 구분하는 설정을 추가하고 요청 시작 시 선택된 값을 고정한다.
- [pass-through] 경량 통과에서는 최소 확인과 동기 추적만 수행하고 의미 필터, filter capability 승인, 응답 보류, 자동 복구와 provider 전환을 실행하지 않는다.
- [regression] 도구 호출 전후의 후속 요청에서 event 순서, terminal, usage와 cancel이 보존되고 필터 대기나 자동 복구가 발생하지 않는지 검증한다.
완료 리뷰
- 상태: 없음
- 요청일: 없음
- 완료 근거: 없음
- 검토 항목: 없음
- 리뷰 코멘트: 없음
범위 제외
- 개별 output filter의 탐지 규칙과 품질 개선
- StreamGate 후속 요청 후보 거부 문제의 원인을 이 Milestone에서 미리 확정하거나 특정 수정안으로 고정하는 일
- 공통 StreamGate runtime 밖에 별도의 endpoint별 응답 파이프라인을 추가하는 일
- caller 또는 agent 제품별로 모드를 자동 변경하는 정책
- 완전 비활성 모드와 추가 감시 단계
- 장시간 원문 감시와 비동기 분석
작업 컨텍스트
- 관련 경로:
packages/go/streamgate,packages/go/config,apps/edge/internal/openai,apps/edge/internal/service,configs - 표준선: 경량 통과는 공통 StreamGate 수명주기를 유지하고 최소한의 동기 추적 외에는 응답을 보류하거나 자동 복구하지 않는다.
- 실행 순서와 차단 관계: 전역 마일스톤 실행 순서
- 관련 Milestone: OpenAI-compatible 출력 검증 필터, Inference API Surface와 실행 Lifecycle 책임 경계 리팩터링
- 확인 필요: 승격 조건과
구현 잠금 > 결정 필요항목