| name | oma-pipeline |
| description | Use when the user wants to run/continue the OMA SQL transform pipeline (Oracle→PostgreSQL/MySQL MyBatis mapper conversion), check its status, or handle a specific step: analyze, transform, review, validate, merge, test.
|
OMA Pipeline Orchestration
너(메인 세션)는 OMA 파이프라인의 오케스트레이터다. LLM 작업은 subagent에게,
결정적 작업은 oma CLI에 위임한다. 직접 SQL을 변환하지 마라.
불변 원칙
- 상태의 SSOT는 DB다. 진행 판단은 항상
oma status --json으로 시작한다.
- 체크포인트 승인형. 각 단계가 끝나면 결과를 요약하고 사용자에게
다음 행동을 묻는다. 사용자 승인 없이 다음 단계로 자동 진행하지 않는다.
- 병렬 dispatch는 최대 5개. 배치가 더 많으면 5개 단위로 나눠 순차 dispatch.
- subagent 응답은 파싱하지 않는다. dispatch 후 결과 집계는
oma status --json
재조회로 한다. subagent의 한 줄 응답은 참고용일 뿐이다.
- 모든 oma CLI 호출은
OMA_OUTPUT_DIR가 설정된 환경에서 실행한다. 세션 시작 시
사용자가 지정한 작업 디렉토리를 유지한다 (예: example/output).
단계별 절차
0. Setup
oma status 실행이 "DB not found"면: 사용자에게 소스 경로·타겟 DB를
물은 뒤 oma setup --non-interactive --source <path> --target-db <db>.
DB 접속 정보는 Test 단계 전까지 불필요하다고 안내.
1. Analyze
oma analyze --json
완료 후 요약 표시 (mapper 수, SQL 수, 메타데이터 상태) +
output/strategy/transform_strategy.md 초안 존재 안내.
체크포인트: [전체 변환 진행 / 샘플 N건만 / 전략 파일 검토·수정 / 중단]
2. Transform
oma db pending --step transform --json
batches 배열의 각 항목마다 oma-transformer를 dispatch (병렬, 최대 5):
dispatch prompt 템플릿:
"mapper_file: {mapper_file} (part {part}/{parts})
sql_ids: {sql_ids 쉼표 목록}
target DB: {TARGET_DBMS_TYPE 값}
OMA_OUTPUT_DIR={현재 작업 디렉토리}
위 SQL들을 변환하고 oma db save-transform으로 기록하라."
전체 완료 후 oma status --json으로 집계.
체크포인트: 성공/실패 요약 → [Review 진행 / 실패 건 재시도 / 중단]
실패 재시도: oma db pending --step transform --only "<실패 목록>"으로 배치 재생성.
3. Review (최대 3 라운드)
oma db pending --step review --json
각 배치를 oma-reviewer로 dispatch (transform과 동일 패턴).
라운드 종료 후 oma status --json의 review_failed 확인:
- review_failed == 0 → Validate로
- review_failed > 0 → 체크포인트: FAIL 목록 + 사유 요약 표시
[자동 재변환 / 해당 SQL 건너뛰기 / 수동 확인]
- 자동 재변환 선택 시:
a. 라운드 2 이상이면 먼저 oma-strategy-refiner를 dispatch (1개, 직렬)
b. FAIL 건의 피드백을 모아 oma-transformer dispatch
(dispatch prompt에 SQL별 피드백 포함 —
oma db feedback-patterns --json로 수집)
c. oma db reset --step review --only "<해당 건>" 후 재리뷰
- 3라운드 후에도 FAIL → 사용자에게 수동 처리 목록으로 보고
4. Validate
oma db pending --step validate --json
oma-validator dispatch (동일 패턴).
체크포인트: FAIL 건(validator가 수정 불가 판정) 목록 + 사유 →
건별 또는 일괄 [승인하고 진행 / 재변환 지시 / 중단]
5. Merge
oma merge --json
결정적 작업 — subagent 불필요. 완료 후 merged/skipped 요약.
체크포인트: [Test 진행 / 특정 mapper diff 확인 / 종료(Test 생략)]
diff 확인 요청 시: output/xmls/origin/과 output/xmls/merge/의 해당 파일을 Read해 비교 요약.
6. Test
oma test-exec --json
failures 배열이 비면 완료. 실패가 있으면 체크포인트:
[oma-test-fixer로 자동 수정 / SKIP 처리 / 수동]
- 자동 수정: mapper별로 failures를 묶어 oma-test-fixer dispatch
- SKIP:
oma db set-tested <m> <s> --result SKIP --notes "<사용자 사유>"
test-fixer는 수정 후 자체적으로 oma test-exec --only로 재검증하고 oma merge --mapper로 재병합한다.
7. 종료
oma report 실행 → 사용자에게 안내:
- 최종 mapper:
output/xmls/merge/
- HTML 리포트:
output/reports/oma_report.html
중단/재개
세션이 끊겨도 상태는 DB에 있다. 사용자가 돌아오면 oma status --json으로
현재 위치를 파악하고 해당 단계의 체크포인트부터 재개한다.
