Rename telemetry command arguments and environment variable (#235)

* chore: bump version to 2.0.0-beta.0 and add comprehensive PR description

Update package.json version from 1.10.0-beta.4 to 2.0.0-beta.0 to reflect
the breaking changes in this release branch.

Add PR_DESCRIPTION.md capturing the full scope of changes for the v2.0.0
release, including:
- MCP server with 11 LLM-callable tools
- Issues CLI (list, get, count, update, dismiss)
- Telemetry instrumentation with opt-out support
- Metrics consolidation (7 subcommands → 4)
- Deprecated Hookdeck Go SDK removal (API 2024-03-01 → 2025-07-01)
- Breaking change: --config flag renamed to --hookdeck-config

https://claude.ai/code/session_012a587AhAbbWdqYx76cexPG

* feat(mcp): add beta wrapping to MCP command and remove PR_DESCRIPTION.md

Add ShortBeta/LongBeta wrapping to the MCP command for consistency
with all other gateway subcommands. Remove PR_DESCRIPTION.md as it
doesn't belong in the codebase.

https://claude.ai/code/session_012a587AhAbbWdqYx76cexPG

* refactor(telemetry): rename env var to HOOKDECK_CLI_TELEMETRY_DISABLED and use enabled/disabled args

- Rename HOOKDECK_CLI_TELEMETRY_OPTOUT to HOOKDECK_CLI_TELEMETRY_DISABLED
  to match Next.js convention and align with the config key name
- Change `hookdeck telemetry enable|disable` to `hookdeck telemetry enabled|disabled`
- Update all tests and README accordingly

https://claude.ai/code/session_012a587AhAbbWdqYx76cexPG

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: leggetter

README.md

@@ -1101,13 +1101,13 @@ The Hookdeck CLI collects anonymous telemetry to help improve the tool. You can
 
 ```sh
 # Disable telemetry
-hookdeck telemetry disable
+hookdeck telemetry disabled
 
 # Re-enable telemetry
-hookdeck telemetry enable
+hookdeck telemetry enabled
 ```
 
-You can also disable telemetry by setting the `HOOKDECK_CLI_TELEMETRY_OPTOUT` environment variable to `1` or `true`.
+You can also disable telemetry by setting the `HOOKDECK_CLI_TELEMETRY_DISABLED` environment variable to `1` or `true`.
 
 ## Configuration files
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hookdeck-cli",
-  "version": "1.10.0-beta.4",
+  "version": "2.0.0-beta.0",
   "description": "Hookdeck CLI",
   "repository": {
     "type": "git",

pkg/cmd/mcp.go

@@ -17,16 +17,16 @@ func newMCPCmd() *mcpCmd {
 	mc.cmd = &cobra.Command{
 		Use:   "mcp",
 		Args:  validators.NoArgs,
-		Short: "Start an MCP server for AI agent access to Hookdeck",
-		Long: `Starts a Model Context Protocol (MCP) server over stdio.
+		Short: ShortBeta("Start an MCP server for AI agent access to Hookdeck"),
+		Long: LongBeta(`Starts a Model Context Protocol (MCP) server over stdio.
 
 The server exposes Hookdeck Event Gateway resources — connections, sources,
 destinations, events, requests, and more — as MCP tools that AI agents and
 LLM-based clients can invoke.
 
 If the CLI is already authenticated, all tools are available immediately.
 If not, a hookdeck_login tool is provided that initiates browser-based
-authentication so the user can log in without leaving the MCP session.`,
+authentication so the user can log in without leaving the MCP session.`),
 		Example: `  # Start the MCP server (stdio transport)
   hookdeck gateway mcp
 

pkg/cmd/telemetry.go

@@ -14,13 +14,13 @@ func newTelemetryCmd() *telemetryCmd {
 	tc := &telemetryCmd{}
 
 	tc.cmd = &cobra.Command{
-		Use:   "telemetry [enable|disable]",
+		Use:   "telemetry [enabled|disabled]",
 		Short: "Manage anonymous telemetry settings",
-		Long:  "Enable or disable anonymous telemetry that helps improve the Hookdeck CLI. Telemetry is enabled by default. You can also set the HOOKDECK_CLI_TELEMETRY_OPTOUT environment variable to 1 or true.",
-		Example: `  $ hookdeck telemetry disable
-  $ hookdeck telemetry enable`,
+		Long:  "Enable or disable anonymous telemetry that helps improve the Hookdeck CLI. Telemetry is enabled by default. You can also set the HOOKDECK_CLI_TELEMETRY_DISABLED environment variable to 1 or true.",
+		Example: `  $ hookdeck telemetry disabled
+  $ hookdeck telemetry enabled`,
 		Args: cobra.ExactArgs(1),
-		ValidArgs: []string{"enable", "disable"},
+		ValidArgs: []string{"enabled", "disabled"},
 		RunE: tc.runTelemetryCmd,
 	}
 
@@ -29,18 +29,18 @@ func newTelemetryCmd() *telemetryCmd {
 
 func (tc *telemetryCmd) runTelemetryCmd(cmd *cobra.Command, args []string) error {
 	switch args[0] {
-	case "disable":
+	case "disabled":
 		if err := Config.SetTelemetryDisabled(true); err != nil {
 			return fmt.Errorf("failed to disable telemetry: %w", err)
 		}
 		fmt.Println("Telemetry has been disabled.")
-	case "enable":
+	case "enabled":
 		if err := Config.SetTelemetryDisabled(false); err != nil {
 			return fmt.Errorf("failed to enable telemetry: %w", err)
 		}
 		fmt.Println("Telemetry has been enabled.")
 	default:
-		return fmt.Errorf("invalid argument %q: must be \"enable\" or \"disable\"", args[0])
+		return fmt.Errorf("invalid argument %q: must be \"enabled\" or \"disabled\"", args[0])
 	}
 	return nil
 }

pkg/gateway/mcp/telemetry_test.go

@@ -183,7 +183,7 @@ func parseTelemetryHeader(t *testing.T, raw string) hookdeck.CLITelemetry {
 
 func TestMCPToolCall_TelemetryHeaderSentToAPI(t *testing.T) {
 	// Ensure env-var opt-out is disabled so telemetry flows.
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	capture := &headerCapture{}
 
@@ -213,7 +213,7 @@ func TestMCPToolCall_TelemetryHeaderSentToAPI(t *testing.T) {
 }
 
 func TestMCPToolCall_EachCallGetsUniqueInvocationID(t *testing.T) {
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	capture := &headerCapture{}
 
@@ -243,7 +243,7 @@ func TestMCPToolCall_EachCallGetsUniqueInvocationID(t *testing.T) {
 }
 
 func TestMCPToolCall_TelemetryHeaderReflectsAction(t *testing.T) {
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	capture := &headerCapture{}
 
@@ -274,7 +274,7 @@ func TestMCPToolCall_TelemetryHeaderReflectsAction(t *testing.T) {
 }
 
 func TestMCPToolCall_TelemetryDisabledByConfig(t *testing.T) {
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	capture := &headerCapture{}
 
@@ -298,7 +298,7 @@ func TestMCPToolCall_TelemetryDisabledByConfig(t *testing.T) {
 }
 
 func TestMCPToolCall_TelemetryDisabledByEnvVar(t *testing.T) {
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "true")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "true")
 
 	capture := &headerCapture{}
 
@@ -320,7 +320,7 @@ func TestMCPToolCall_TelemetryDisabledByEnvVar(t *testing.T) {
 func TestMCPToolCall_MultipleAPICallsSameInvocation(t *testing.T) {
 	// The "projects use" action makes 2 API calls (list projects, then update).
 	// Both should carry the same invocation ID.
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	capture := &headerCapture{}
 

pkg/hookdeck/client.go

@@ -129,7 +129,7 @@ func (c *Client) PerformRequest(ctx context.Context, req *http.Request) (*http.R
 	}
 
 	singletonDisabled := GetTelemetryInstance().Disabled
-	if !telemetryOptedOut(os.Getenv("HOOKDECK_CLI_TELEMETRY_OPTOUT"), c.TelemetryDisabled || singletonDisabled) {
+	if !telemetryOptedOut(os.Getenv("HOOKDECK_CLI_TELEMETRY_DISABLED"), c.TelemetryDisabled || singletonDisabled) {
 		var telemetryHdr string
 		var telErr error
 		if c.Telemetry != nil {

pkg/hookdeck/client_telemetry_test.go

@@ -76,7 +76,7 @@ func TestPerformRequestUsesTelemetryOverride(t *testing.T) {
 	require.NoError(t, err)
 
 	// Clear opt-out env var
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	_, err = client.PerformRequest(context.Background(), req)
 	require.NoError(t, err)
@@ -107,7 +107,7 @@ func TestPerformRequestTelemetryDisabledByConfig(t *testing.T) {
 		TelemetryDisabled: true,
 	}
 
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	req, err := http.NewRequest(http.MethodGet, server.URL+"/test", nil)
 	require.NoError(t, err)
@@ -132,7 +132,7 @@ func TestPerformRequestTelemetryDisabledByEnvVar(t *testing.T) {
 		APIKey:  "test",
 	}
 
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "true")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "true")
 
 	req, err := http.NewRequest(http.MethodGet, server.URL+"/test", nil)
 	require.NoError(t, err)
@@ -166,7 +166,7 @@ func TestPerformRequestFallsBackToSingleton(t *testing.T) {
 	tel.SetDeviceName("test-host")
 	tel.SetInvocationID("inv_singleton_test")
 
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	req, err := http.NewRequest(http.MethodGet, server.URL+"/test", nil)
 	require.NoError(t, err)
@@ -205,7 +205,7 @@ func TestPerformRequestTelemetryDisabledBySingleton(t *testing.T) {
 	tel := GetTelemetryInstance()
 	tel.SetDisabled(true)
 
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	req, err := http.NewRequest(http.MethodGet, server.URL+"/test", nil)
 	require.NoError(t, err)

pkg/hookdeck/telemetry_test.go

@@ -176,7 +176,7 @@ func TestResetTelemetrySingletonThenRequest(t *testing.T) {
 	}))
 	defer server.Close()
 
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	// Reset the singleton from any prior test state
 	ResetTelemetryInstanceForTesting()
@@ -217,7 +217,7 @@ func TestResetTelemetrySingletonThenRequest(t *testing.T) {
 func TestResetTelemetrySingletonIsolation(t *testing.T) {
 	// Simulates two sequential CLI command invocations.
 	// Each should have its own telemetry context.
-	t.Setenv("HOOKDECK_CLI_TELEMETRY_OPTOUT", "")
+	t.Setenv("HOOKDECK_CLI_TELEMETRY_DISABLED", "")
 
 	headers := make([]string, 2)