@kyaukyuai/linear-cli 2.8.0 → 2.8.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## [Unreleased]
 
+## [2.8.2] - 2026-03-24
+
+### Added
+
+- added rate-limit retry guidance and `error.details.rateLimit` metadata for automation consumers when issue creation hits API throttling
+
+### Changed
+
+- distinguished plan-limit failures from generic automation errors with exit code `5` and clearer upgrade/archive guidance
+
+## [2.8.1] - 2026-03-24
+
+### Added
+
+- added `--dry-run` support to `issue start` so agents and scripts can preview branch naming and target state transitions before mutating Linear or local VCS state
+
 ## [2.8.0] - 2026-03-24
 
 ### Added

package/README.md

@@ -110,6 +110,8 @@ for bot and org-wide automation use cases, `linear-cli` defines a stable JSON co
 
 the contract fixes top-level success payload shapes and requires machine-readable failure payloads for the automation tier. see [docs/json-contracts.md](docs/json-contracts.md) for the full contract, compatibility rules, and example payloads. that guarantee also covers parser and argument validation failures when `--json` is present.
 
+for automation consumers, auth and authorization failures now use exit code `4`, while free-plan or workspace-plan limit failures use exit code `5`. other contract failures remain non-zero and currently use `1`. rate-limited responses remain on exit code `1`, but now include retry guidance and, when available, `error.details.rateLimit` metadata.
+
 the same document also defines the shared preview contract for future `--dry-run` write commands. those commands are not all implemented yet, but the contract now fixes the expected `stdout`, `exit code`, and `--json --dry-run` envelope shape ahead of rollout.
 
 ## differences from upstream
@@ -179,6 +181,7 @@ linear issue list --parent ENG-100 --json  # filter sub-issues of a parent issue
 linear issue list -w   # open issue list in web browser
 linear issue list -a   # open issue list in Linear.app
 linear issue start     # create/switch to issue branch and mark as started
+linear issue start ENG-123 --dry-run  # preview the branch and target state
 linear issue create    # create a new issue (interactive prompts)
 linear issue create -t "title" -d "description"  # create with flags
 linear issue create -t "title" --team ENG --json  # emit machine-readable created issue data

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "@kyaukyuai/linear-cli",
-      "version": "2.8.0"
+      "version": "2.8.2"
     },
     "node_modules/@isaacs/cliui": {
       "engines": {
@@ -542,5 +542,5 @@
     }
   },
   "requires": true,
-  "version": "2.8.0"
+  "version": "2.8.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "artifactDownloadUrls": [
-    "https://github.com/kyaukyuai/linear-cli/releases/download/v2.8.0"
+    "https://github.com/kyaukyuai/linear-cli/releases/download/v2.8.2"
   ],
   "bin": {
     "linear": "run-linear.js"
@@ -85,7 +85,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "2.8.0",
+  "version": "2.8.2",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"