Skip to content

Conversation

@seyoung4503
Copy link
Contributor

#️⃣ Issue Number

  • TBD

📝 요약(Summary)

  • 0.3.0-dev로 버전 범프 후, define-by-run 철학을 위한 Core 기반(예외/훅/베이스/RunContext/SequentialFlow) 를 추가했습니다.
  • 실행 관측성을 위해 Hook(Event) 트레이싱을 도입하고, 계약 위반을 ContractError로 fail-fast 처리했습니다.
  • RunContext state carrier와 BaseFlow.run_query sugar API를 제공하고, 전반에 테스트/문서/타입 주석을 보강했습니다.

💬 To Reviewers (선택)

  • RunContext -> RunContext 계약(ContractError) 의 강제 수준이 적절한지 확인 부탁드립니다.
  • Hook(Event) 필드 구성(input_summary/output_summary/data)이 과하지 않은지, 추후 확장에 무리 없는지 의견 부탁드립니다.
  • BaseFlow.run_query를 Base 레벨에 둔 결정(모든 Flow에서 동일 UX 보장)이 적절한지 리뷰 부탁드립니다.

PR Checklist

  • Core 기능 추가에 대한 유닛 테스트 작성 (exceptions/hooks/base/runcontext/flows)
  • 기존 테스트 전체 통과 확인 (python -m pytest)
  • 문서 추가/갱신 (RunContext concept, core concept/implementation details)
  • (선택) Hook 이벤트 포맷/샘플링 전략에 대한 후속 문서 보강

- add inputs/artifacts/outputs storage with metadata
- provide alias properties (query, schema, sql, validation)
- add schema_* convenience accessors and metadata helpers
- cover query/schema/sql/validation aliases
- verify schema normalization behavior
- test metadata helpers (push_meta, get_meta_list)
- validate run_query() populates RunContext.query
- cover ctx-mutate vs functional step contracts
- ensure invalid return types raise TypeError
- verify step execution order and override behavior
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant