From 265f50226184dc9eb2ed0d1dc36fbb2240a30c5c Mon Sep 17 00:00:00 2001 From: Facundo Farias Date: Fri, 20 Mar 2026 11:07:22 +0100 Subject: [PATCH 1/3] docs: Add deprecation notice pointing to network-agent Co-Authored-By: Claude Sonnet 4.6 --- CLAUDE.md | 2 ++ README.md | 2 ++ deploy-agent.gemspec | 2 +- 3 files changed, 5 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 9729bd9..7959070 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,6 +4,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## Project Overview +> **Notice:** This repository is being archived in favour of [network-agent](https://github.com/deployhq/network-agent), which has fewer dependencies and is easier to install. Both are functional during the transition period. + Deploy Agent is a Ruby gem that creates a secure proxy allowing DeployHQ to forward connections to protected servers. It establishes a TLS connection to DeployHQ's servers and proxies connections to allowed destinations based on an IP/network allowlist. ## Development Commands diff --git a/README.md b/README.md index 177aacd..d6ed956 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # Deploy Agent +> **Notice:** This repository is being archived. Please use [network-agent](https://github.com/deployhq/network-agent) instead — it has fewer dependencies and is easier to install. + A secure proxy that allows [DeployHQ](https://www.deployhq.com/) to forward connections to servers behind firewalls. The agent establishes an outbound TLS connection to DeployHQ's servers and proxies deployment traffic to allowed destinations based on an IP/network allowlist. ## How It Works diff --git a/deploy-agent.gemspec b/deploy-agent.gemspec index d6f80bd..cf8b37b 100644 --- a/deploy-agent.gemspec +++ b/deploy-agent.gemspec @@ -7,7 +7,7 @@ Gem::Specification.new do |s| s.version = DeployAgent::VERSION s.required_ruby_version = '>= 2.7' s.summary = 'The DeployHQ Agent' - s.description = 'This gem allows you to configure a secure proxy through which DeployHQ can forward connections' + s.description = 'Deprecated: use https://github.com/deployhq/network-agent instead. This gem allows you to configure a secure proxy through which DeployHQ can forward connections' s.authors = ['Charlie Smurthwaite'] s.email = ['support@deployhq.com'] s.files = Dir.glob('{lib,bin}/**/*') From 7e9c7b4e55ad255f624dbe7a713ba907895e7873 Mon Sep 17 00:00:00 2001 From: Facundo Farias Date: Fri, 20 Mar 2026 11:10:04 +0100 Subject: [PATCH 2/3] fix: Fix line length offense in gemspec Co-Authored-By: Claude Sonnet 4.6 --- deploy-agent.gemspec | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/deploy-agent.gemspec b/deploy-agent.gemspec index cf8b37b..69bee90 100644 --- a/deploy-agent.gemspec +++ b/deploy-agent.gemspec @@ -7,7 +7,8 @@ Gem::Specification.new do |s| s.version = DeployAgent::VERSION s.required_ruby_version = '>= 2.7' s.summary = 'The DeployHQ Agent' - s.description = 'Deprecated: use https://github.com/deployhq/network-agent instead. This gem allows you to configure a secure proxy through which DeployHQ can forward connections' + s.description = 'Deprecated: use https://github.com/deployhq/network-agent instead. ' \ + 'This gem allows you to configure a secure proxy through which DeployHQ can forward connections' s.authors = ['Charlie Smurthwaite'] s.email = ['support@deployhq.com'] s.files = Dir.glob('{lib,bin}/**/*') From 6757da919a30ac06cf25b20877e35cd42a995851 Mon Sep 17 00:00:00 2001 From: Facundo Farias Date: Tue, 28 Apr 2026 07:39:24 +0200 Subject: [PATCH 3/3] chore: Deprecate gem with post-install and runtime warnings Adds two deprecation touchpoints alongside the existing README/CLAUDE.md notice so users discover the migration path without re-reading docs: - gemspec post_install_message: shown once on `gem install deploy-agent` - CLI dispatch warn: stderr banner on every `deploy-agent` invocation, catching existing installs that never re-install README notice expanded to match the deploy-lib deprecation tone. Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 6 +++++- deploy-agent.gemspec | 5 +++++ lib/deploy_agent/cli.rb | 13 +++++++++++++ 3 files changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d6ed956..9a343dd 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,10 @@ # Deploy Agent -> **Notice:** This repository is being archived. Please use [network-agent](https://github.com/deployhq/network-agent) instead — it has fewer dependencies and is easier to install. +> **DEPRECATED:** This gem is deprecated and will not receive further updates. +> Please migrate to the new [network-agent](https://github.com/deployhq/network-agent) instead, +> which has fewer dependencies and is easier to install. +> +> Both agents remain functional during the transition period. A secure proxy that allows [DeployHQ](https://www.deployhq.com/) to forward connections to servers behind firewalls. The agent establishes an outbound TLS connection to DeployHQ's servers and proxies deployment traffic to allowed destinations based on an IP/network allowlist. diff --git a/deploy-agent.gemspec b/deploy-agent.gemspec index 69bee90..e87e452 100644 --- a/deploy-agent.gemspec +++ b/deploy-agent.gemspec @@ -21,4 +21,9 @@ Gem::Specification.new do |s| s.add_dependency 'nio4r', '~> 2.7' s.add_dependency 'rb-readline', '~> 0.5' s.add_dependency 'timers', '~> 4.3' + + s.post_install_message = <<~MSG + WARNING: deploy-agent is deprecated and will not receive further updates. + Please migrate to the new agent: https://github.com/deployhq/network-agent + MSG end diff --git a/lib/deploy_agent/cli.rb b/lib/deploy_agent/cli.rb index 23f7eaf..36e7f92 100644 --- a/lib/deploy_agent/cli.rb +++ b/lib/deploy_agent/cli.rb @@ -4,7 +4,20 @@ module DeployAgent class CLI + DEPRECATION_NOTICE = <<~MSG + \e[33m╔══════════════════════════════════════════════════════════════════╗ + ║ DEPRECATED: deploy-agent will not receive further updates. ║ + ║ Please migrate to the new agent: ║ + ║ ║ + ║ https://github.com/deployhq/network-agent ║ + ║ ║ + ║ Fewer dependencies, easier to install. ║ + ╚══════════════════════════════════════════════════════════════════╝\e[0m + MSG + def dispatch(arguments) + warn DEPRECATION_NOTICE + methods = self.public_methods(false).delete_if { |n| n == :dispatch }.sort @options = {}