Adopt multi-module layout for independent versioning (start by breaking the taskflow ↔ artifactadapter cycle)
Maintainer thường phản hồi trong vòng 1 ngày
@mushrafmim đang làm issue này rồi.
Từ ngày 29/6/2026.
Đánh giá
Issue này chưa được đánh giá.
Mô tả
Current Limitation
The entire repo is a single Go module (module github.com/OpenNSW/core, one root go.mod). Since a Go module is the unit of versioning, every package shares one version tag. As a result:
- Consuming repos are forced to upgrade everything together — they can't take a fix in one package (e.g.
storage) without also pulling unrelated changes in others (e.g.taskflow) under the same version bump. - A breaking change anywhere forces a major bump that nominally affects all consumers, even those who don't import the changed package.
- There's no way to express per-package semver or changelogs.
Compounding this, the internal dependency graph contains a module-level cycle that blocks any split: artifactadapter/{tasktemplate,subtasktemplate} → taskflow/types, while taskflow/orchestrator → artifactadapter. At the package level this is a clean DAG, but any module boundary drawn around taskflow/* vs artifactadapter/* creates a cycle, which Go modules do not allow.
Suggested Improvement
Move toward a multi-module monorepo: independently-consumed subtrees get their own go.mod, versioned independently via subdirectory-prefixed tags (e.g. storage/v0.3.1, taskflow/v1.4.0). Consumers then pin each module separately, so a storage fix never moves taskflow's version.
Phased:
- Phase 1 (prerequisite, valuable on its own): Break the cycle by moving the template types (
TaskTemplate,SubTaskTemplate,ExtensionConfig,ExecutionPhase, currently intaskflow/types) intoartifactadapter. Rationale:artifactadapteris the producer of these types (subtasktemplate.Load/tasktemplate.Loadreturn them);taskflow/orchestratoronly consumes them and already depends onartifactadapter. The current placement is itself a layering inversion. Result: a one-directionaltaskflow → artifactadaptergraph. (No lowertaskflowpackage —store,plugins— imports these types today, so the move is safe.) - Phase 2: Introduce per-module
go.modat consumer-facing seams (not every leaf package). Usego.workfor local multi-module dev; run CI withGOWORK=offto validate real version resolution. Adopt subdirectory tag-prefix releases plus a cascade-release script for dependent modules.
Granularity guidance: group by release cadence / consumer boundary — e.g. workflow+temporal, taskflow(+artifactadapter), and split out storage/authn/authz/notification/payment only where consumed independently. Note internal/* is import-restricted and cannot be consumed externally under that path.
Version
main @ 9c090fd
Additional Context
Industry precedent for monorepo-with-independent-modules: aws-sdk-go-v2 (each service/* is its own module — visible in our own require block), k8s.io/*, google.golang.org/genproto. Two caveats to call out: (1) the module graph must stay acyclic, and (2) the cascade-release tax (a breaking change in a low-level module forces bump+release of every dependent) is the main operational cost and is commonly underestimated.
- Ngôn ngữ chính
- Go
- Star
- 6
- Fork
- 8
- Merge trung bình
- 21 giờ 36 phút
- Pull request đã merge (30 ngày)
- 42
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của OpenNSW/core
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
Maintainer thường phản hồi trong vòng 1 ngày
-
payment: test fixtures hardcode real gateway names (govpay/lankapay) instead of generic placeholdersĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày
-
nsw-sl cleanup Type/Improvement
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 48/100
Maintainer thường phản hồi trong vòng 1 ngày
-
remote: let the host inject a logger, and log with one consistent policyCó thể đã có người làm @mushrafmim đã nhận 5 ngày trước. Đang mởType/Improvement
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 22/100
Maintainer thường phản hồi trong vòng 1 ngày
Issue tương tự
-
agent-research-finding chore
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
jordansmall/spindrift#7370 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
☢️ Bug v3
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
The repo's gates check is clean and runs need no swapsCó thể đã có người làm @turbot-agent-fleet đã nhận hôm nay. Đang mởagent:ready
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 64/100
turbot/tailpipe#677 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
needs-kind needs-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 2 ngày
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
crossplane-contrib/provider-keycloak#806 ·
Maintainer thường phản hồi trong vòng 1 ngày