Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

refactor(upgrade): full Effect-native rewrite of the upgrade train

Đang mở
  • Có gì không ổn?
#561 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
backend, devtools, testing

Hướng nghiên cứu

Start by locating upgradeTemplate and the syncTemplate release scoped path, then read the PlatformManifestService and ResolutionSessionService seams and the orchestrator's Effect.timeoutOrElse patterns. Run the targeted upgrade and CLI error suites plus pnpm run lint:effect; done means the paths use Effect with typed errors and service fakes, all checks pass, and the platform upgrade e2e confirms unchanged behavior.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Summary

Second half of the seam-pattern decision (the PlatformManifestService seam lands first): rewrite the upgrade train itself as Effect-native pipelines.

PR-level context: PlatformManifestService (the seam) wraps the platform-release-manifest cluster while the core stays plain async functions — the repo's "module is the implementation, the tag is the seam" shape (FastKVRegistryService, DeployTrainService precedents). This ticket rewrites the orchestration layer.

Scope

  • upgradeTemplate phases → Effect.gen pipelines: read-source / diff / preflight / package-apply / re-exec boundary / migration phases become effects with typed errors (a discriminated UpgradePhaseError replacing string-error UpgradeResult shapes where callers need them).
  • Typed error channel — PublishTrainError-style: handlers map failures to the wire shape mechanically instead of string matching.
  • Effect-lint parity — the cluster passes pnpm run lint:effect (floating effects, tag Self mismatches) under the type-aware oxlint preset.
  • Service-in-context throughout — upgradeTemplate consumes PlatformManifestService + ResolutionSessionService via yield* instead of direct plain-function imports.
  • Timeouts / interruption — the spawn-heavy phases (pnpm install, bos types gen, the re-exec boundary) get fiber-based timeouts instead of ad-hoc exit-code checks, matching the orchestrator's Effect.timeoutOrElse patterns.

Non-goals

  • No behavior change: the upgrade plot, pin semantics, drift alarms, and output shapes stay byte-identical (the platform-upgrade e2e is the guard).
  • Plain function exports stay as the pure core — a rewrite of the orchestration layer, not a deletion of the seams.

Acceptance

  • upgradeTemplate (and syncTemplate's release-scoped path) are Effect-native with typed errors.
  • Targeted suites (upgrade-migration, upgrade-template-sync-gating, upgrade-catalog-drift, cli-error-format) pass with service fakes, no vi.mock on the scaffold modules.
  • pnpm run lint:effect reports zero findings for the cluster.
Ngôn ngữ chính
TypeScript
Star
5
Fork
3
Merge trung bình
10 giờ 38 phút
Pull request đã merge (30 ngày)
119

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của NEARBuilders/everything-dev

Tất cả issue của NEARBuilders/everything-dev

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.