From b2ea7b9cc3402c37c8a7f64e8bd60f4e3143a195 Mon Sep 17 00:00:00 2001 From: Dmytro Smirnov Date: Wed, 8 Jul 2026 20:42:40 +0300 Subject: [PATCH 1/7] Add worker deployment CLI deprecation notice --- CHANGELOG.md | 8 ++++++++ README.md | 8 ++++++++ docs/commands/worker-run.md | 5 +++++ docs/deprecation.md | 29 +++++++++++++++++++++++++++++ docs/index.md | 1 + 5 files changed, 51 insertions(+) create mode 100644 docs/deprecation.md diff --git a/CHANGELOG.md b/CHANGELOG.md index e0707b7..eb0daa1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,14 @@ All notable changes to this project will be documented in this file. +## Unreleased + +### Added + +- Added a repository notice that the `@udx/worker-deployment` CLI is entering + maintenance mode and new workflow work should prefer repo-owned Rabbit/worker + contracts and `dev.kit` guidance. + ## [3.0.2] - 2026-02-05 ### Removed diff --git a/README.md b/README.md index 0bc6a9d..ef692fa 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,13 @@ # Worker Deploy +[![Status: maintenance mode](https://img.shields.io/badge/status-maintenance%20mode-yellow)](docs/deprecation.md) + +> Deprecation notice: the `@udx/worker-deployment` CLI is entering +> maintenance mode. Existing automation can keep using it during the transition, +> but new UDX workflow work should prefer repo-owned Rabbit/worker contracts and +> `dev.kit` guidance instead of adopting this CLI directly. See +> [docs/deprecation.md](docs/deprecation.md). + Run any Docker container with automatic cloud authentication. Requires Node/npm and Docker. diff --git a/docs/commands/worker-run.md b/docs/commands/worker-run.md index c9bdeeb..5a00720 100644 --- a/docs/commands/worker-run.md +++ b/docs/commands/worker-run.md @@ -1,5 +1,10 @@ # worker-run +> Deprecation notice: direct CLI usage is in maintenance mode. Keep existing +> automation working during migration, but prefer repo-owned Rabbit/worker +> contracts and `dev.kit` guidance for new workflow work. See +> [../deprecation.md](../deprecation.md). + Runs a Docker container using `deploy.yml` and auto-detected credentials. ## Usage diff --git a/docs/deprecation.md b/docs/deprecation.md new file mode 100644 index 0000000..d5f579a --- /dev/null +++ b/docs/deprecation.md @@ -0,0 +1,29 @@ +# Worker Deployment CLI Deprecation Notice + +`@udx/worker-deployment` is entering maintenance mode. + +Existing repositories and automation can keep using the CLI while their workflow +contracts are migrated. New UDX workflow work should avoid adopting the CLI as a +fresh integration point. Prefer repo-owned Rabbit/worker contracts, checked-in +deployment manifests, and `dev.kit` guidance for discovery and execution. + +## What this means + +- Existing `worker run`, `worker config`, `worker gen`, and `worker images` + usage remains documented for transition support. +- Fixes needed to keep existing users unblocked may still be accepted. +- New feature work should happen in the owning workflow, worker, or repo + contract rather than expanding this CLI. +- No removal date is set yet. + +## Migration direction + +Move repository workflows toward checked-in, reviewable contracts: + +- workflow and deployment manifests owned by the repository +- Rabbit/worker execution contracts for repeatable automation +- `dev.kit` repo context for discovery, validation, and next-step guidance + +When updating a repository that still calls this CLI directly, keep the existing +command working first, then move the durable behavior into the repo-owned +contract that should replace it. diff --git a/docs/index.md b/docs/index.md index 146d37e..8c00bb9 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,6 +2,7 @@ Short, focused docs live here. +- docs/deprecation.md - docs/commands/worker-config.md - docs/commands/worker-run.md - docs/commands/worker-gen.md From 6ceaf7b800622010a8345f0a44e067c3ec8e7b86 Mon Sep 17 00:00:00 2001 From: Dmytro Smirnov Date: Wed, 8 Jul 2026 20:53:56 +0300 Subject: [PATCH 2/7] Disable npm releases for deprecated CLI --- .github/workflows/npm-release.yml | 18 ------------------ CHANGELOG.md | 5 +++++ README.md | 5 +++-- docs/deprecation.md | 10 ++++++---- 4 files changed, 14 insertions(+), 24 deletions(-) delete mode 100644 .github/workflows/npm-release.yml diff --git a/.github/workflows/npm-release.yml b/.github/workflows/npm-release.yml deleted file mode 100644 index a39826c..0000000 --- a/.github/workflows/npm-release.yml +++ /dev/null @@ -1,18 +0,0 @@ -name: NPM Release - -on: - push: - workflow_dispatch: - -permissions: - id-token: write - contents: write - -jobs: - release: - uses: udx/reusable-workflows/.github/workflows/npm-release-ops.yml@master - with: - release_branch: "latest" - dist_dir: "." - secrets: - slack_webhook_url: ${{ secrets.SLACK_WEBHOOK_URL }} diff --git a/CHANGELOG.md b/CHANGELOG.md index 287aaa6..a524cfc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,6 +10,11 @@ All notable changes to this project will be documented in this file. maintenance mode and new workflow work should prefer repo-owned Rabbit/worker contracts and `dev.kit` guidance. +### Removed + +- Removed the npm release workflow to prevent new package releases while the + currently published CLI remains available. + ## [3.0.4] - 2026-02-05 ### Fixed diff --git a/README.md b/README.md index ef692fa..17cded1 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,9 @@ > Deprecation notice: the `@udx/worker-deployment` CLI is entering > maintenance mode. Existing automation can keep using it during the transition, -> but new UDX workflow work should prefer repo-owned Rabbit/worker contracts and -> `dev.kit` guidance instead of adopting this CLI directly. See +> and the current npm package remains available, but no new package releases are +> planned. New UDX workflow work should prefer repo-owned Rabbit/worker +> contracts and `dev.kit` guidance instead of adopting this CLI directly. See > [docs/deprecation.md](docs/deprecation.md). Run any Docker container with automatic cloud authentication. diff --git a/docs/deprecation.md b/docs/deprecation.md index d5f579a..dc0065a 100644 --- a/docs/deprecation.md +++ b/docs/deprecation.md @@ -2,16 +2,18 @@ `@udx/worker-deployment` is entering maintenance mode. -Existing repositories and automation can keep using the CLI while their workflow -contracts are migrated. New UDX workflow work should avoid adopting the CLI as a -fresh integration point. Prefer repo-owned Rabbit/worker contracts, checked-in +Existing repositories and automation can keep using the currently published npm +CLI while their workflow contracts are migrated, but no new package releases are +planned. New UDX workflow work should avoid adopting the CLI as a fresh +integration point. Prefer repo-owned Rabbit/worker contracts, checked-in deployment manifests, and `dev.kit` guidance for discovery and execution. ## What this means - Existing `worker run`, `worker config`, `worker gen`, and `worker images` usage remains documented for transition support. -- Fixes needed to keep existing users unblocked may still be accepted. +- The current npm package remains available for existing users. +- The npm release workflow has been removed to prevent new package releases. - New feature work should happen in the owning workflow, worker, or repo contract rather than expanding this CLI. - No removal date is set yet. From 164e1487bd31d9e2a82fb7246bff33ea99490461 Mon Sep 17 00:00:00 2001 From: Dmytro Smirnov Date: Wed, 8 Jul 2026 20:55:29 +0300 Subject: [PATCH 3/7] Align unreleased changelog heading --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a524cfc..2ca6646 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,7 +2,7 @@ All notable changes to this project will be documented in this file. -## Unreleased +## [Unreleased] ### Added From 0196730a63a959013c8604d3d6dab3b7db345d8d Mon Sep 17 00:00:00 2001 From: Dmytro Smirnov Date: Wed, 8 Jul 2026 20:57:48 +0300 Subject: [PATCH 4/7] Keep npm release workflow disabled --- .github/workflows/npm-release.yml | 11 +++++++++++ CHANGELOG.md | 4 ++-- docs/deprecation.md | 2 +- 3 files changed, 14 insertions(+), 3 deletions(-) create mode 100644 .github/workflows/npm-release.yml diff --git a/.github/workflows/npm-release.yml b/.github/workflows/npm-release.yml new file mode 100644 index 0000000..8eba7b3 --- /dev/null +++ b/.github/workflows/npm-release.yml @@ -0,0 +1,11 @@ +name: NPM Release + +on: + workflow_dispatch: + +jobs: + release-disabled: + runs-on: ubuntu-latest + steps: + - name: Report release status + run: echo "NPM releases are disabled for this deprecated CLI." diff --git a/CHANGELOG.md b/CHANGELOG.md index 2ca6646..002577c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,9 +10,9 @@ All notable changes to this project will be documented in this file. maintenance mode and new workflow work should prefer repo-owned Rabbit/worker contracts and `dev.kit` guidance. -### Removed +### Changed -- Removed the npm release workflow to prevent new package releases while the +- Disabled the npm release workflow to prevent new package releases while the currently published CLI remains available. ## [3.0.4] - 2026-02-05 diff --git a/docs/deprecation.md b/docs/deprecation.md index dc0065a..491b212 100644 --- a/docs/deprecation.md +++ b/docs/deprecation.md @@ -13,7 +13,7 @@ deployment manifests, and `dev.kit` guidance for discovery and execution. - Existing `worker run`, `worker config`, `worker gen`, and `worker images` usage remains documented for transition support. - The current npm package remains available for existing users. -- The npm release workflow has been removed to prevent new package releases. +- The npm release workflow has been disabled to prevent new package releases. - New feature work should happen in the owning workflow, worker, or repo contract rather than expanding this CLI. - No removal date is set yet. From a9e693a054d6f3a192755cac5e7475106a1053d8 Mon Sep 17 00:00:00 2001 From: Dmytro Smirnov Date: Wed, 8 Jul 2026 20:58:56 +0300 Subject: [PATCH 5/7] Address Copilot deprecation link feedback --- CHANGELOG.md | 4 ++-- README.md | 4 ++-- docs/deprecation.md | 3 ++- 3 files changed, 6 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 002577c..e8f3554 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,8 +12,8 @@ All notable changes to this project will be documented in this file. ### Changed -- Disabled the npm release workflow to prevent new package releases while the - currently published CLI remains available. +- Disabled the automated npm release workflow to prevent repo-driven package + releases while the currently published CLI remains available. ## [3.0.4] - 2026-02-05 diff --git a/README.md b/README.md index 17cded1..d986335 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,13 @@ # Worker Deploy -[![Status: maintenance mode](https://img.shields.io/badge/status-maintenance%20mode-yellow)](docs/deprecation.md) +[![Status: maintenance mode](https://img.shields.io/badge/status-maintenance%20mode-yellow)](https://github.com/udx/worker-deployment/blob/latest/docs/deprecation.md) > Deprecation notice: the `@udx/worker-deployment` CLI is entering > maintenance mode. Existing automation can keep using it during the transition, > and the current npm package remains available, but no new package releases are > planned. New UDX workflow work should prefer repo-owned Rabbit/worker > contracts and `dev.kit` guidance instead of adopting this CLI directly. See -> [docs/deprecation.md](docs/deprecation.md). +> [docs/deprecation.md](https://github.com/udx/worker-deployment/blob/latest/docs/deprecation.md). Run any Docker container with automatic cloud authentication. Requires Node/npm and Docker. diff --git a/docs/deprecation.md b/docs/deprecation.md index 491b212..ebdb8f3 100644 --- a/docs/deprecation.md +++ b/docs/deprecation.md @@ -13,7 +13,8 @@ deployment manifests, and `dev.kit` guidance for discovery and execution. - Existing `worker run`, `worker config`, `worker gen`, and `worker images` usage remains documented for transition support. - The current npm package remains available for existing users. -- The npm release workflow has been disabled to prevent new package releases. +- The automated npm release workflow has been disabled to prevent repo-driven + package releases. - New feature work should happen in the owning workflow, worker, or repo contract rather than expanding this CLI. - No removal date is set yet. From c3a4ea81493f528ede1a7052fd58fd870e2c1b67 Mon Sep 17 00:00:00 2001 From: Dmytro Smirnov Date: Wed, 8 Jul 2026 21:01:28 +0300 Subject: [PATCH 6/7] Limit disabled release workflow permissions --- .github/workflows/npm-release.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/workflows/npm-release.yml b/.github/workflows/npm-release.yml index 8eba7b3..cb14e64 100644 --- a/.github/workflows/npm-release.yml +++ b/.github/workflows/npm-release.yml @@ -3,6 +3,8 @@ name: NPM Release on: workflow_dispatch: +permissions: {} + jobs: release-disabled: runs-on: ubuntu-latest From 8f186e92313473c7b6fe7b00bd5ffdcef496df0d Mon Sep 17 00:00:00 2001 From: Dmytro Smirnov Date: Wed, 8 Jul 2026 21:04:18 +0300 Subject: [PATCH 7/7] Clarify disabled npm release workflow --- .github/workflows/npm-release.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/npm-release.yml b/.github/workflows/npm-release.yml index cb14e64..3a523c8 100644 --- a/.github/workflows/npm-release.yml +++ b/.github/workflows/npm-release.yml @@ -1,4 +1,4 @@ -name: NPM Release +name: NPM Release Disabled on: workflow_dispatch: