# pipeline

## 목적 / 책임

YAML에서 파싱된 `DataCommand` 리스트를 순차 실행하고, 조건 분기·반복·대기 등 파이프라인 흐름 제어를 담당한다.
외부 시스템 작업은 실행하지 않고, command ID를 찾아 커맨드 도메인으로 위임한다.

## 포함 경로

- `lib/oto/pipeline/` — 파이프라인 실행 엔진 전체

## 제외 경로

- `lib/oto/commands/` — 실제 커맨드 구현체 (pipeline은 dispatch만 한다)
- `lib/oto/core/` — 태그 치환·데이터 합성 (pipeline 이전 단계)

## 주요 구성 요소

- `Pipeline` — 커맨드 디스패치 루프
- `PipelineValidateResult` — workflow 초기화/검증 결과와 실행 컨텍스트 보관
- `PipelineExecutor` — 모든 pipeline 노드의 공통 베이스
- `PipelineExe` — 단일 커맨드 실행 핸들
- `PipelineAsync` — 단일 커맨드 비동기 실행 핸들
- `PipelineExeHandle` — 실행 결과 처리
- `PipelineCondition` — 조건 평가
- `PipelineIf` / `PipelineSwitch` — 분기 흐름
- `PipelineForeach` / `PipelineWhile` — 반복 흐름
- `PipelineContain` — 중첩 파이프라인
- `PipelineWaitUntil` / `PipelineWaitUntilSeconds` — 조건 기반 또는 초 단위 대기 흐름

## 유지할 패턴

- 파이프라인 노드는 단일 책임: 흐름 제어만 한다, I/O는 커맨드에 위임
- 새 흐름 제어 유형은 `Pipeline*` 네이밍으로 추가
- 새 흐름 제어 유형은 `Pipeline.exeMap`에 등록하고, 필요한 데이터 모델은 `lib/oto/data/pipeline_data.dart`에 둔다
- 파이프라인 validate 단계에서 workflow task key, command ID 존재 여부, 하위 task 구조를 가능한 한 먼저 확인한다
- 조건식은 `PipelineCondition`의 type caster와 `Command.replaceTagValue()` 흐름을 유지한다
- pipeline 변경 후 `dart analyze`를 실행하고, if/foreach/while/switch/wait-until 중 영향을 받는 샘플 YAML 파싱 또는 실행 테스트를 확인한다

## 다른 도메인과의 경계

- **command**: `Pipeline`이 `Command.byType()`을 호출하는 시점이 경계. 커맨드 내부 로직은 pipeline이 모른다
- **core**: `DataComposer`가 YAML → `DataCommand` 변환을 마친 후 pipeline이 실행 시작
- **sample**: workflow 문법 변경 시 `assets/yaml/sample/02_*`~`05_*`와 README 흐름 제어 예시를 함께 점검

## 금지 사항

- pipeline 코드에서 외부 시스템(Git, Jenkins 등)을 직접 호출하지 않는다
- 커맨드별 비즈니스 로직을 pipeline에 넣지 않는다
- pipeline에서 파일 시스템, 네트워크, shell 실행을 직접 수행하지 않는다
- command param의 세부 필드를 pipeline에서 해석하지 않는다
