@softspark/jira-mcp 1.16.0 → 1.16.1

package/CHANGELOG.md

@@ -7,6 +7,48 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v1.16.1 -- Bad arguments stop answering UNKNOWN_ERROR (2026-09-18)
+
+Both packages change in this release.
+
+### Fixed
+
+- **Argument checks answer `INVALID_INPUT`.** Every input check in both servers
+  raised a bare `Error`, and a tool response takes its `code` only from the
+  typed hierarchy, so "you passed both `content` and `storage`" came back as
+  `UNKNOWN_ERROR`. That code reads as "something broke", and an agent that sees
+  it stops or looks for a way around the server instead of fixing its call. 31
+  sites now raise `InvalidInputError`: a missing required argument, two
+  arguments that exclude each other, an update that names nothing to change, a
+  malformed time (`2d`) or Tempo date, an unknown `group_by`, category or
+  `position` value, a file over the upload limit, an unknown tool name. Nothing
+  reaches Atlassian when it is raised, and the messages are unchanged.
+- **`TEMPLATE_MISSING_VAR` is real now.** `create_task`,
+  `add_templated_comment` and `create_page` answer it when a template is
+  rendered without a required variable. The class and its row in the API
+  reference had existed since templates shipped, but nothing raised it.
+- **`add_page_inline_comment` answers `ANCHOR_NOT_FOUND`** when
+  `text_selection` is not in the page body, instead of `UNKNOWN_ERROR`. Found
+  in the 1.16.0 post-release run.
+- A raw NUL byte in a string literal in `tempo-operations.ts` made git and grep
+  treat the file as binary: its diffs showed as `Bin` and searches skipped it
+  without saying so. It is now the escape `'\u0000'` behind a named constant.
+  Behaviour is identical.
+- The README test count had been stale since 1.16.0.
+
+### Added
+
+- `packages/core/tests/typed-errors.test.ts` fails the build on a bare
+  `new Error(` anywhere a tool call can reach (`src/cli/` is exempt, a CLI error
+  goes to a terminal) and on a raw control byte in a source file. It found six
+  of the 31 sites on its first run, in the file grep could not read.
+
+### Upgrade note
+
+A client that matched on `UNKNOWN_ERROR` to detect a rejected call now sees
+`INVALID_INPUT`, `TEMPLATE_MISSING_VAR` or `ANCHOR_NOT_FOUND` there.
+`UNKNOWN_ERROR` is left for failures nobody anticipated.
+
 ## v1.16.0 -- Creator and reporter on every task read (2026-09-18)
 
 `@softspark/confluence-mcp` has no behaviour change in this release; it is bumped

package/README.md

@@ -4,14 +4,17 @@
 
 [![CI](https://github.com/softspark/jira-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/softspark/jira-mcp/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@softspark/jira-mcp)](https://www.npmjs.com/package/@softspark/jira-mcp)
-[![version](https://img.shields.io/badge/version-1.16.0-blue)](CHANGELOG.md)
+[![version](https://img.shields.io/badge/version-1.16.1-blue)](CHANGELOG.md)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
 
 ---
 
-## What's New in v1.16.0
+## What's New in v1.16.1
 
-- **`creator` and `reporter` on every task read.** `search_tasks`, `get_task_details`, `sync_tasks` and `read_cached_tasks` now say who filed an issue and who it is reported by. Before, neither field reached a response, so "who raised this bug" had no answer.
+- **A rejected call says so.** Every argument check used to answer `UNKNOWN_ERROR`, which reads as "something broke". They now answer `INVALID_INPUT`: a missing argument, `template_id` together with `markdown`, an update with nothing to change, a time like `2d`, a malformed Tempo date or `group_by`. Nothing reaches Jira, and the message names what to pass.
+- A template rendered without a required variable answers `TEMPLATE_MISSING_VAR`, as the API reference always said it did.
+- If a client matched on `UNKNOWN_ERROR` to detect a bad call, match on the new codes instead. `UNKNOWN_ERROR` is left for failures nobody anticipated.
+- **From 1.16.0: `creator` and `reporter` on every task read.** `search_tasks`, `get_task_details`, `sync_tasks` and `read_cached_tasks` now say who filed an issue and who it is reported by. Before, neither field reached a response, so "who raised this bug" had no answer.
 - Both hold the email, or the display name when Atlassian privacy settings hide the email, and `null` when Jira returns none. To filter by them, use JQL: `creator = "pm@example.com"` or `reporter = currentUser()`.
 - An existing task cache keeps loading. Rows cached before the upgrade read `null` for both fields until the next `sync_tasks`.
 - Released together with `@softspark/confluence-mcp` under one version. See the [changelog](CHANGELOG.md).
@@ -288,9 +291,9 @@ src/
 
 **Supply chain protection** -- `ignore-scripts=true`, no axios, no dynamic requires. Self-contained 561KB library bundle, 1 runtime dep (commander).
 
-**Typed error hierarchy** -- 30 error classes with machine-readable codes. Every tool returns structured `{ success, error, code }` responses. No stack traces leak to MCP clients.
+**Typed error hierarchy** -- 32 error classes with machine-readable codes. Every tool returns structured `{ success, error, code }` responses. No stack traces leak to MCP clients.
 
-**Strict TypeScript** -- `strict: true`, no `any`, `readonly` interfaces, Zod validation at all boundaries, 1093 tests across 85 test files.
+**Strict TypeScript** -- `strict: true`, no `any`, `readonly` interfaces, Zod validation at all boundaries, 1109 tests across 86 test files.
 
 ## Documentation