chore: release main

.github/.release-please-manifest.json

@@ -1,10 +1,10 @@
 {
-  ".": "0.3.0",
-  "packages/deepctl-core": "0.2.16",
+  ".": "0.3.1",
+  "packages/deepctl-core": "0.2.17",
   "packages/deepctl-shared-utils": "0.1.12",
   "packages/deepctl-telemetry": "0.0.6",
   "packages/deepctl-cmd-api": "0.0.2",
-  "packages/deepctl-cmd-login": "0.1.17",
+  "packages/deepctl-cmd-login": "0.1.18",
   "packages/deepctl-cmd-projects": "0.2.0",
   "packages/deepctl-cmd-transcribe": "0.1.12",
   "packages/deepctl-cmd-usage": "0.2.0",
@@ -16,11 +16,11 @@
   "packages/deepctl-cmd-debug-toolkit": "0.1.0",
   "packages/deepctl-cmd-ffprobe": "0.0.2",
   "packages/deepctl-cmd-mcp": "0.1.15",
-  "packages/deepctl-cmd-update": "0.2.6",
-  "packages/deepctl-cmd-plugin": "0.1.12",
-  "packages/deepctl-cmd-skills": "0.0.7",
+  "packages/deepctl-cmd-update": "0.2.7",
+  "packages/deepctl-cmd-plugin": "0.1.13",
+  "packages/deepctl-cmd-skills": "0.0.8",
   "packages/deepctl-cmd-init": "0.0.4",
-  "packages/deepctl-cmd-models": "0.1.0",
+  "packages/deepctl-cmd-models": "0.1.1",
   "packages/deepctl-cmd-speak": "0.0.4",
   "packages/deepctl-cmd-keys": "0.1.0",
   "packages/deepctl-cmd-read": "0.1.0",

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.3.1](https://github.com/deepgram/cli/compare/v0.3.0...v0.3.1) (2026-09-23)
+
+
+### Bug Fixes
+
+* **ci:** catch missing root dependencies and invalid dependency-floor updates before release ([33d3b69](https://github.com/deepgram/cli/commit/33d3b6920efd754f140d70827610b59fe7d0501f))
+* **ci:** correctly validate prerelease, bounded, and extras dependency specifiers ([95704fe](https://github.com/deepgram/cli/commit/95704fe381e382f2191cf21d917d60aef6e9cdaa))
+* **ci:** make dependency-floor validation reliable on Windows by reading project files as UTF-8 ([7ab748f](https://github.com/deepgram/cli/commit/7ab748fc91d319e608819e192322aa6a6f925d00))
+* **cli:** allow `--output`, `--quiet`, and `--verbose` after a subcommand, and explain how to place other global options ([632531d](https://github.com/deepgram/cli/commit/632531dc4b81da15f175fac35a4c58bc2c959462))
+* **cli:** reject output flags on command groups that cannot apply them ([c0eb380](https://github.com/deepgram/cli/commit/c0eb380b98ea630cacb4d76b2ae3d22acd1c2f3e))
+* **cli:** allow output options on command groups when their subcommands support them ([42b17d7](https://github.com/deepgram/cli/commit/42b17d7608e4eab222496dd9c799c83532fe909d))
+* **core:** send plugin-loading diagnostics to stderr so they do not corrupt structured output ([9658943](https://github.com/deepgram/cli/commit/9658943f210fb7081068fa4a4235a5b5299bb7ad))
+* **deps:** ensure `pip install --upgrade deepctl` receives every updated workspace package ([5126599](https://github.com/deepgram/cli/commit/5126599b9f3701b724c543679174630ce110a5ae))
+* fix model catalog data, global output-option placement, and `whoami` credential-source and JSON output ([#108](https://github.com/deepgram/cli/issues/108)) ([62c2e47](https://github.com/deepgram/cli/commit/62c2e47aa0634deae84a420ea350f866b3bd57f1))
+* **models:** show canonical model IDs and languages, flag legacy conversational AI models, and warn when a catalog category is empty ([ff05174](https://github.com/deepgram/cli/commit/ff05174a16f9262d8045c81b65859ef5e24bdfdc))
+* **models:** show model architecture and clarify output-format options ([0db9172](https://github.com/deepgram/cli/commit/0db91723b99d1f9e55061dcccd19070f8f4a0231))
+* **plugin:** return exit code 2, rather than success, when plugin removal is cancelled ([0dcfd2c](https://github.com/deepgram/cli/commit/0dcfd2c0d68a6095f4f6651e51ba6995f2b430d3))
+* **update,skills:** return exit code 1 when an update or skills command fails so automation can detect the error ([1799c21](https://github.com/deepgram/cli/commit/1799c213911f2fbc1d0c2430bb3ce7d4389c7afc))
+* **update,skills:** return exit code 2 when an update or skills install is cancelled ([0497ac1](https://github.com/deepgram/cli/commit/0497ac1892333c09d2a482f0b10ccd59d1f1dba2))
+* **whoami:** correctly identify environment-sourced API keys and keep JSON output parseable ([60e8cf9](https://github.com/deepgram/cli/commit/60e8cf99d4f86a76ca43616f571845754976a15f))
+
+
+### Documentation
+
+* **contributing:** document the release runbook, package delivery manifest, and release-publication checks ([0bc15bb](https://github.com/deepgram/cli/commit/0bc15bb5cd61b2b1a683417bf9084f904e95e6eb))
+* **readme:** document the CLI exit-code contract for scripts and CI ([563d162](https://github.com/deepgram/cli/commit/563d162587b5aaea977eb24c17af63f0fbbf1e86))
+* **readme:** remove a premature stdout/stderr guarantee until [#107](https://github.com/deepgram/cli/issues/107) delivers it ([fe94ced](https://github.com/deepgram/cli/commit/fe94ced895687966d66b4f34bbcbe0acb2813072))
+* **readme:** clarify exit-code behavior, including the intentional use of exit code 2 for cancellation ([2e1c6c5](https://github.com/deepgram/cli/commit/2e1c6c51248baeab9e0c5f207f4eccbd20fbe0b3))
+* limit Homebrew source trust to the `deepgram` tap ([0d4df0c](https://github.com/deepgram/cli/commit/0d4df0c0bb2d66e7b2b9bca8e9a8b10f84d8f291))
+* update Homebrew installation instructions for Homebrew 5 ([036b05c](https://github.com/deepgram/cli/commit/036b05c2c0a8f496cebe3d841b99b8f9c87e1e34))
+
 ## [0.3.0](https://github.com/deepgram/cli/compare/v0.2.27...v0.3.0) (2026-08-19)
 
 

packages/deepctl-cmd-login/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.18](https://github.com/deepgram/cli/compare/deepctl-cmd-login-v0.1.17...deepctl-cmd-login-v0.1.18) (2026-09-23)
+
+
+### Bug Fixes
+
+* keep `whoami` JSON output parseable and correctly identify environment-sourced API keys ([#108](https://github.com/deepgram/cli/issues/108)) ([62c2e47](https://github.com/deepgram/cli/commit/62c2e47aa0634deae84a420ea350f866b3bd57f1))
+* **whoami:** correctly identify environment-sourced API keys and keep JSON output parseable ([60e8cf9](https://github.com/deepgram/cli/commit/60e8cf99d4f86a76ca43616f571845754976a15f))
+
 ## [0.1.17](https://github.com/deepgram/cli/compare/deepctl-cmd-login-v0.1.16...deepctl-cmd-login-v0.1.17) (2026-08-17)
 
 

packages/deepctl-cmd-login/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-login"
-version = "0.1.17" # x-release-please-version
+version = "0.1.18" # x-release-please-version
 description = "Login command for deepctl"
 readme = "README.md"
 license = "MIT"

packages/deepctl-cmd-models/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.1](https://github.com/deepgram/cli/compare/deepctl-cmd-models-v0.1.0...deepctl-cmd-models-v0.1.1) (2026-09-23)
+
+
+### Bug Fixes
+
+* show complete model catalog data and flag legacy conversational AI models ([#108](https://github.com/deepgram/cli/issues/108)) ([62c2e47](https://github.com/deepgram/cli/commit/62c2e47aa0634deae84a420ea350f866b3bd57f1))
+* **models:** show canonical model IDs and languages, flag legacy conversational AI models, and warn when a catalog category is empty ([ff05174](https://github.com/deepgram/cli/commit/ff05174a16f9262d8045c81b65859ef5e24bdfdc))
+* **models:** show model architecture and clarify output-format options ([0db9172](https://github.com/deepgram/cli/commit/0db91723b99d1f9e55061dcccd19070f8f4a0231))
+
 ## [0.1.0](https://github.com/deepgram/cli/compare/deepctl-cmd-models-v0.0.2...deepctl-cmd-models-v0.1.0) (2026-08-19)
 
 

packages/deepctl-cmd-models/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-models"
-version = "0.1.0" # x-release-please-version
+version = "0.1.1" # x-release-please-version
 description = "Models command for deepctl"
 readme = "README.md"
 license = "MIT"

packages/deepctl-cmd-plugin/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.13](https://github.com/deepgram/cli/compare/deepctl-cmd-plugin-v0.1.12...deepctl-cmd-plugin-v0.1.13) (2026-09-23)
+
+
+### Bug Fixes
+
+* **plugin:** return exit code 2, rather than success, when plugin removal is cancelled ([0dcfd2c](https://github.com/deepgram/cli/commit/0dcfd2c0d68a6095f4f6651e51ba6995f2b430d3))
+* **plugin:** write the plugin-removal confirmation prompt to stderr so JSON output stays parseable ([0497ac1](https://github.com/deepgram/cli/commit/0497ac1892333c09d2a482f0b10ccd59d1f1dba2))
+
 ## [0.1.12](https://github.com/deepgram/cli/compare/deepctl-cmd-plugin-v0.1.11...deepctl-cmd-plugin-v0.1.12) (2026-05-09)
 
 

packages/deepctl-cmd-plugin/pyproject.toml

@@ -2,7 +2,7 @@
 name = "deepctl-cmd-plugin"
 description = "Plugin management command for deepctl"
 readme = "README.md"
-version = "0.1.12" # x-release-please-version
+version = "0.1.13" # x-release-please-version
 requires-python = ">=3.10"
 authors = [{ name = "Deepgram DevRel", email = "devrel@deepgram.com" }]
 dependencies = [

packages/deepctl-cmd-skills/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.0.8](https://github.com/deepgram/cli/compare/deepctl-cmd-skills-v0.0.7...deepctl-cmd-skills-v0.0.8) (2026-09-23)
+
+
+### Bug Fixes
+
+* **skills:** return exit code 1 when a skills command fails so automation can detect the error ([1799c21](https://github.com/deepgram/cli/commit/1799c213911f2fbc1d0c2430bb3ce7d4389c7afc))
+* **skills:** return exit code 2 when a skills install is cancelled ([0497ac1](https://github.com/deepgram/cli/commit/0497ac1892333c09d2a482f0b10ccd59d1f1dba2))
+
 ## [0.0.7](https://github.com/deepgram/cli/compare/deepctl-cmd-skills-v0.0.6...deepctl-cmd-skills-v0.0.7) (2026-08-17)
 
 

packages/deepctl-cmd-skills/pyproject.toml

@@ -2,7 +2,7 @@
 name = "deepctl-cmd-skills"
 description = "AI coding assistant skill management for deepctl"
 readme = "README.md"
-version = "0.0.7" # x-release-please-version
+version = "0.0.8" # x-release-please-version
 requires-python = ">=3.10"
 authors = [{ name = "Deepgram DevRel", email = "devrel@deepgram.com" }]
 dependencies = [

packages/deepctl-cmd-update/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.2.7](https://github.com/deepgram/cli/compare/deepctl-cmd-update-v0.2.6...deepctl-cmd-update-v0.2.7) (2026-09-23)
+
+
+### Bug Fixes
+
+* **update:** return exit code 1 when an update fails so automation can detect the error ([1799c21](https://github.com/deepgram/cli/commit/1799c213911f2fbc1d0c2430bb3ce7d4389c7afc))
+* **update:** return exit code 2 when an update is cancelled ([0497ac1](https://github.com/deepgram/cli/commit/0497ac1892333c09d2a482f0b10ccd59d1f1dba2))
+
 ## [0.2.6](https://github.com/deepgram/cli/compare/deepctl-cmd-update-v0.2.5...deepctl-cmd-update-v0.2.6) (2026-08-17)
 
 

packages/deepctl-cmd-update/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-update"
-version = "0.2.6" # x-release-please-version
+version = "0.2.7" # x-release-please-version
 description = "Update command for deepctl"
 readme = "README.md"
 license = "MIT"

packages/deepctl-core/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.2.17](https://github.com/deepgram/cli/compare/deepctl-core-v0.2.16...deepctl-core-v0.2.17) (2026-09-23)
+
+
+### Bug Fixes
+
+* **cli:** allow `--output`, `--quiet`, and `--verbose` after a subcommand, and explain how to place other global options ([632531d](https://github.com/deepgram/cli/commit/632531dc4b81da15f175fac35a4c58bc2c959462))
+* **cli:** reject output flags on command groups that cannot apply them ([c0eb380](https://github.com/deepgram/cli/commit/c0eb380b98ea630cacb4d76b2ae3d22acd1c2f3e))
+* **cli:** allow output options on command groups when their subcommands support them ([42b17d7](https://github.com/deepgram/cli/commit/42b17d7608e4eab222496dd9c799c83532fe909d))
+* **core:** send plugin-loading diagnostics to stderr so they do not corrupt structured output ([9658943](https://github.com/deepgram/cli/commit/9658943f210fb7081068fa4a4235a5b5299bb7ad))
+* apply global output options consistently after subcommands while preserving command-specific option meanings ([#108](https://github.com/deepgram/cli/issues/108)) ([62c2e47](https://github.com/deepgram/cli/commit/62c2e47aa0634deae84a420ea350f866b3bd57f1))
+
 ## [0.2.16](https://github.com/deepgram/cli/compare/deepctl-core-v0.2.15...deepctl-core-v0.2.16) (2026-08-19)
 
 

packages/deepctl-core/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-core"
-version = "0.2.16" # x-release-please-version
+version = "0.2.17" # x-release-please-version
 description = "Core components for deepctl"
 readme = "README.md"
 license = "MIT"

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl"
-version = "0.3.0" # x-release-please-version
+version = "0.3.1" # x-release-please-version
 description = "Official Deepgram CLI for speech recognition and audio intelligence"
 readme = "README.md"
 license = "MIT"
@@ -35,8 +35,8 @@ requires-python = ">=3.10"
 dependencies = [
     "click>=8.0.0",
     "deepgram-sdk>=7.7.0,<8",
-    "deepctl-core>=0.2.16",
-    "deepctl-cmd-login>=0.1.17",
+    "deepctl-core>=0.2.17",
+    "deepctl-cmd-login>=0.1.18",
     "deepctl-cmd-projects>=0.2.0",
     "deepctl-cmd-transcribe>=0.1.12",
     "deepctl-cmd-usage>=0.2.0",
@@ -49,11 +49,11 @@ dependencies = [
     "deepctl-cmd-debug-probe>=0.0.2",
     "deepctl-cmd-debug-toolkit>=0.1.0",
     "deepctl-cmd-ffprobe>=0.0.2",
-    "deepctl-cmd-update>=0.2.6",
-    "deepctl-cmd-plugin>=0.1.12",
-    "deepctl-cmd-skills>=0.0.7",
+    "deepctl-cmd-update>=0.2.7",
+    "deepctl-cmd-plugin>=0.1.13",
+    "deepctl-cmd-skills>=0.0.8",
     "deepctl-cmd-init>=0.0.4",
-    "deepctl-cmd-models>=0.1.0",
+    "deepctl-cmd-models>=0.1.1",
     "deepctl-cmd-speak>=0.0.4",
     "deepctl-cmd-keys>=0.1.0",
     "deepctl-cmd-read>=0.1.0",

src/deepctl/__init__.py

@@ -1,7 +1,7 @@
 """deepctl - Official command-line interface for Deepgram's speech
 recognition API."""
 
-__version__ = "0.3.0"  # x-release-please-version
+__version__ = "0.3.1"  # x-release-please-version
 __author__ = "Deepgram"
 __email__ = "devrel@deepgram.com"
 __license__ = "MIT"