v0.3.9-alpha - Execution Reliability, Error Safety, Runtime Stability | 실행 신뢰성, 에러 안정성, 런타임 안정화

🦴 Spine v0.3.5 ~ v0.3.9

Execution Reliability, Error Safety, Runtime Stability | 실행 신뢰성, 에러 안정성, 런타임 안정화

Spine v0.3.5부터 v0.3.9까지는 v0.3.4-alpha에서 정리한 명시적 실행 모델을 실제 운영 관점에서 더 단단하게 만든 구간입니다.
에러 응답 일관성, 바이너리 응답 지원, 404 처리 정확성, Recover 제어, Response 커밋 상태 추적까지 포함해 실행 안정성이 크게 강화되었습니다.

From v0.3.5 to v0.3.9, Spine hardens the explicit execution model introduced in v0.3.4-alpha.
This range focuses on production reliability: consistent error responses, binary serving, proper 404 behavior, configurable recovery, and response commit-state awareness.

---

✨ 주요 변경 사항 | Highlights

• Pipeline 내부 httperr 처리 시 사용자 응답 보장
• httpx.Binary 도입으로 바이너리 응답 공식 지원
• 미등록 핸들러 요청에 대해 정확한 404 반환
• Recover 동작을 옵션(DisableRecover)으로 명시 제어
• ResponseWriter.IsCommitted() 도입으로 중복/충돌 응답 방지
• 이벤트 컨슈머 시작/종료 상태 및 오류 채널 처리 개선
• Ensured user-facing responses for internal pipeline httperr errors
• Added official binary response support via httpx.Binary
• Returns proper 404 for missing handlers
• Made recover behavior explicitly configurable (DisableRecover)
• Added ResponseWriter.IsCommitted() to prevent duplicate/conflicting writes
• Improved event consumer lifecycle/error-channel handling

---

🚀 버전별 업데이트 | Version-by-Version

v0.3.5 (2026-02-03)

• Pipeline 내부 컴포넌트에서 httperr 기반 error 반환 시에도 response_writer로 응답 전송
• 내부 에러가 누락되지 않고 HTTP 응답으로 일관되게 표면화됨
• Pipeline-internal httperr errors are now consistently written to clients via response_writer
• Prevents silent/internal-only failures in HTTP flows

v0.3.6, v0.3.7 (2026-02-12)

• httpx.Binary 타입 추가
• 바이너리 콘텐츠(파일/바이트 스트림 등) 서빙 가능
• Introduced httpx.Binary
• Enables serving binary payloads from controllers

v0.3.8 (2026-02-16)

• 없는 핸들러 요청 시 404 HTTP 코드 반환
• 라우팅 실패 케이스의 HTTP 의미론 정확성 개선
• Returns 404 for unmatched handlers
• Improves correctness of routing-failure semantics

v0.3.9 (2026-02-17)

• ResponseWriter에 IsCommitted() 추가 및 Echo 구현 반영
• HTTP 메서드 대문자 정규화로 라우팅 대소문자 불일치 방지
• 이벤트 버스 인터페이스 도입, 소비자 오류 채널 처리 개선
• 파이프라인 에러 처리 보강 + JSON/String 핸들러 nil 체크 추가
• 컨슈머 시작 상태 추적 및 HTTP 비활성 모드 종료 신호 대기 보완
• panic 처리 경량화 (middleware.Recover() -> simpleRecover())
• HTTPOptions.DisableRecover 추가 (NewServer recover 제어 가능)
• Route Interceptor 로깅/중복 타입 처리 개선
• Added IsCommitted() to ResponseWriter with Echo implementation
• Normalized HTTP methods to uppercase for routing stability
• Added event-bus interface and improved consumer error-channel flow
• Strengthened pipeline error path + nil guards in JSON/String handlers
• Improved consumer lifecycle tracking and shutdown waiting without HTTP runtime
• Simplified panic recovery path (simpleRecover)
• Added HTTPOptions.DisableRecover for explicit recover control
• Improved route interceptor logging and duplicate-type handling

---

🧩 호환성/마이그레이션 메모 | Compatibility Notes

• v0.3.7은 실질 코드 변경이 없으므로 v0.3.6 대비 마이그레이션 포인트 없음
• Recover 정책을 커스터마이즈하는 경우 HTTPOptions.DisableRecover 설정 검토 필요
• IsCommitted()는 프레임워크 내부 응답 커밋 상태 제어를 위한 변경이며, 일반 사용자 커스터마이징 포인트는 아님
• v0.3.7 introduces no additional migration changes over v0.3.6
• If you customize panic recovery, review HTTPOptions.DisableRecover
• IsCommitted() is primarily an internal framework mechanism for response commit-state control, not a general user customization point

⚠️ Alpha 안내 | Alpha Notice

Spine v0.3.9-alpha는 알파 버전입니다.

• API 및 내부 구조는 변경될 수 있습니다.
• 문서 및 예제는 지속적으로 보완될 예정입니다.
• 피드백과 이슈 제보를 적극 환영합니다.

Spine v0.3.4-alpha is an alpha release.

• APIs and internal structures may change.
• Documentation and examples will continue to evolve.
• Feedback and issue reports are highly welcome.