Releases: hookdeck/hookdeck-cli
v2.0.2
Summary
Patch since v2.0.1: bumps the MCP Go SDK to address GHSA-q382-vc8q-7jhj, and adds in-repo agent skills for maintainers (Cursor / Claude Code).
Security
- GHSA-q382-vc8q-7jhj — Improper handling of null Unicode character when parsing JSON in
github.com/modelcontextprotocol/go-sdk(affected ≤ v1.4.0). This release bumpsgithub.com/modelcontextprotocol/go-sdkto v1.4.1 (#268), which pulls in the fixedgithub.com/segmentio/encodingv0.5.4 per upstream guidance.
Internal / repository
- Agent skills for CLI releases:
skills/hookdeck-cli-release/, symlinks under.cursor/skillsand.claude/skills,CLAUDE.md, and relatedAGENTS.md/ README pointers (#272). No change to shipped CLI behavior for end users beyond the dependency update above.
Full Changelog: v2.0.1...v2.0.2
v2.0.1
Summary
Patch release since v2.0.0: telemetry invocation ID is consistent for a single CLI run, CI adjustments for acceptance tests, refreshed connection command examples in help and REFERENCE.md, and a dependency update.
Breaking changes
None.
Fixes
- Telemetry: Use one invocation ID per CLI run so API calls in the same process share the same ID (fixes multiple IDs when gateway
PreRunand connectionPreRunboth initialized telemetry). (#271)
Improvements
- Docs: Connection command examples in Cobra help now use
hookdeck gateway connection; REFERENCE.md regenerated. (#271)
Internal / CI
- Disable telemetry for acceptance tests in GitHub Actions where appropriate. (#270)
- Bump
golang.org/x/termfrom 0.40.0 to 0.41.0. (#269)
Full Changelog: v2.0.0...v2.0.1
v2.0.0
Summary
This PR delivers the bulk of the Hookdeck CLI v2.0.0 release on top of the last GA tag (v1.9.1). Main user-facing additions: an MCP server for the Event Gateway, first-class Issues CLI commands, consolidated Metrics queries, and new telemetry instrumentation with a supported opt-out.
Breaking Changes / Migration
-
Global
--configflag renamed to--hookdeck-config- Reason: avoids conflicts with source/destination commands that accept JSON objects via flags also named
--config. - Update scripts: replace
hookdeck --config /pathwithhookdeck --hookdeck-config /path.
- Reason: avoids conflicts with source/destination commands that accept JSON objects via flags also named
-
New
--localflag forloginandcihookdeck login --localandhookdeck ci --localsave credentials/config to the current directory under.hookdeck/config.toml.--localcannot be used together with--hookdeck-config.
New Features
Hookdeck Event Gateway MCP Server (beta): hookdeck gateway mcp
- Starts a stdio JSON-RPC MCP server exposing Event Gateway capabilities as tools for LLM clients.
- Tooling focuses on investigation workflows (inspect/query most resources; no broad write access beyond what is intentionally scoped).
- Auth behavior:
- If already authenticated: resource tools are available immediately.
- If unauthenticated: a
hookdeck_logintool is registered to perform browser-based device auth inside the MCP flow.
- Tools exposed (high level):
hookdeck_help,hookdeck_sources,hookdeck_destinations,hookdeck_connections,hookdeck_requests,hookdeck_events,hookdeck_attempts,hookdeck_transformations,hookdeck_issues,hookdeck_metrics,hookdeck_projects,hookdeck_login.
Issues Command (Event Gateway)
New hookdeck gateway issue command group (alias: hookdeck gateway issues) with:
list(filters:--type,--status,--issue-trigger-id, sorting, pagination)get <issue-id>count(filters via type/status)update <issue-id> --status <OPENED|IGNORED|ACKNOWLEDGED|RESOLVED>dismiss <issue-id> [--force](confirmation prompt unless--force)
Metrics Consolidation
- Consolidated metrics queries into resource-aligned subcommands:
hookdeck gateway metrics eventshookdeck gateway metrics requestshookdeck gateway metrics attemptshookdeck gateway metrics transformations
- Common behavior:
--startand--endare required (ISO 8601 date-time)- Supports
--measuresand--dimensionsto choose/shape the returned metrics. - Per-issue metrics require
--issue-idwhen routing needs an explicit issue dimension.
CLI Telemetry Instrumentation + Opt-out
- Telemetry is automatically initialized before command execution and sent with identifying context (CLI source, environment, command context, and invocation correlation).
- Manage opt-out via:
- Command:
hookdeck telemetry enabled|disabled - Config/env:
HOOKDECK_CLI_TELEMETRY_DISABLED(and corresponding config setting)
- Command:
Improvements / Behavior Changes
-
Project types + gateway gating
hookdeck project useand related commands now account for project types (Gateway/Outpost/Console) and ensure gateway-only commands run against a Gateway project.- Outbound project mode is treated as Gateway for gating purposes.
-
Connection rules CLI fixes
- Improved handling/parsing for certain rule flag inputs, including JSON parsing behavior for
--rule-filter-headers.
- Improved handling/parsing for certain rule flag inputs, including JSON parsing behavior for
-
Login/CI UX updates
- Added
--localoption for bothhookdeck loginandhookdeck cito pin credentials/config under the current directory.
- Added
Internal / Reliability / Infrastructure
- Deprecated Hookdeck Go SDK removed and replaced with a direct HTTP API client (new API version), aligning CLI runtime behavior with the current backend.
- MCP and CLI test coverage was expanded significantly (including MCP server unit/integration tests).
- Acceptance test infrastructure was improved for parallel execution.
v2.0.0-beta.3
Beta: v2.0.0-beta.3
v2.0.0-beta.2
Beta: project type (Gateway/Outpost/Console), gateway gating, whoami …
v2.0.0-beta.1
Beta: v2.0.0 (breaking change)
v1.10.0-beta.4
fix(mcp): make hookdeck_login non-blocking so browser URL is shown im…
v1.10.0-beta.3
Merge branch 'claude/hookdeck-gateway-mcp-Xe6WQ' of https://github.co…
v1.10.0-beta.2
Beta: Gateway MCP (destination types, docs)
v1.10.0-beta.1
Beta: Gateway MCP support