nomadcode/agent-ops/roadmap/milestones/workflow-core.md
toki e7ddbcdfed feat: add task metadata migration and update workflow service
- Add migration for task metadata column (00003)
- Update workflow model and service with metadata support
- Update database layer (models, queries) for metadata field
- Update storage store to handle metadata
- Update roadmap documents and milestones
2026-05-24 18:10:40 +09:00

2.2 KiB

Workflow Core

목표

Plane 통신 토대와 별도 pipeline 설계가 정리된 뒤 실제 상태 변화를 기준으로 task 상태 전이를 정리하고 enqueue / running / completed / failed 흐름을 안정화한다. retry, timeout, notification event의 기본 구조를 추가해 core workflow의 운영 기준을 만든다.

단계

Workflow Core

상태

계획

구현 잠금

  • 상태: 잠금
  • 결정 필요:
    • NomadCode workflow retry/timeout과 IOP 실행 정책의 책임 경계를 결정한다.
    • notification event의 소비자와 최소 발행 범위를 결정한다.

범위

  • task 상태 전이 정리
  • enqueue / running / completed / failed 흐름 안정화
  • retry / timeout 기본 구조 추가
  • notification event 구조 정리
  • Plane 통신 토대와 후속 pipeline 설계에서 확인된 상태 변화와 실패 케이스 반영

필수 기능

  • [lifecycle-model] task lifecycle 상태 모델 점검
  • [transition-ownership] scheduler와 workflow service의 상태 전이 책임 정리
  • [failure-policy] 실패 task 처리 기준
  • [retry-timeout] retry와 timeout의 최소 정책
  • [notification-model] notification event 모델과 발행 지점

완료 기준

  • task가 enqueue 이후 running, completed, failed 상태로 일관되게 전이된다.
  • 실패와 timeout이 관찰 가능한 상태로 남는다.
  • retry 정책의 최소 동작 방식이 구현되거나 명확히 문서화된다.
  • notification event가 workflow 상태 변화와 연결된다.

범위 제외

  • 실제 외부 협업 도구로 notification 발송
  • 복잡한 workflow DSL
  • 고급 권한 정책
  • multi-tenant 운영 정책

작업 컨텍스트

  • 이전 출처: services/core/README.md## 단계별 다음 작업
  • 주요 작업 영역: services/core/internal/workflow/, services/core/internal/scheduler/, services/core/internal/notification/
  • 선행 작업: Plane Communication Foundation, Work Item Provider Pipeline Design
  • 후속 작업: External Integration
  • 검증 기준: scheduler, persistence, adapter behavior를 크게 바꾸면 관련 테스트를 함께 갱신한다.
  • 확인 필요: 구현 잠금의 결정 필요 항목 참고.