@kyaukyuai/linear-cli 2.4.0 → 2.5.0

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 ## [Unreleased]
 
+## [2.5.0] - 2026-03-18
+
+### Added
+
+- documented Automation Contract v1 for the bot-facing `--json` surface, including stable command coverage, shared value rules, and compatibility guarantees
+
+### Changed
+
+- automation-tier `--json` commands now return a machine-readable JSON error envelope on failure, including parser and argument validation failures before command actions run
+
+### Improved
+
+- added contract-focused tests for JSON error mapping and automation-tier failure output to catch breaking changes earlier
+
+## [2.4.1] - 2026-03-17
+
+### Added
+
+- added JSON output for `issue relation add` and `issue relation delete` so bots and wrappers can create and remove dependencies without parsing terminal text
+
 ## [2.4.0] - 2026-03-17
 
 ### Added

package/README.md

@@ -100,6 +100,15 @@ compared to upstream, this fork adds and maintains several capabilities aimed at
 - workspace-aware auth management with keyring migration and default workspace support
 - generated AI-agent skill docs, Claude plugin metadata, npm publishing, and Homebrew tap release plumbing
 
+## automation contract v1
+
+for bot and org-wide automation use cases, `linear-cli` defines a stable JSON contract for a focused automation tier.
+
+- in scope: `issue list/view/create/update --json`, `issue relation add/delete/list --json`, `issue comment add --json`, `team members --json`, `issue parent/children/create-batch --json`
+- out of scope: non-JSON terminal output, `linear api`, and other `--json` commands that are not listed above
+
+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.
+
 ## differences from upstream
 
 this fork is intentionally diverging from upstream in a few ways:
@@ -179,6 +188,8 @@ linear issue comment list          # list comments on current issue
 linear issue comment add           # add a comment to current issue
 linear issue comment add -p <id>   # reply to a specific comment
 linear issue comment add ENG-123 --body "follow-up" --json  # emit created comment data
+linear issue relation add ENG-123 blocked-by ENG-100 --json  # emit machine-readable relation creation data
+linear issue relation delete ENG-123 blocked-by ENG-100 --json  # emit machine-readable relation deletion data
 linear issue relation list ENG-123 --json  # emit dependency graph for an issue
 linear issue comment update <id>   # update a comment
 linear issue commits               # show all commits for an issue (jj only)

package/npm-shrinkwrap.json

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

package/package.json

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