@withpica/mcp-server 2.82.0 → 2.83.1

package/CHANGELOG.md

@@ -11,6 +11,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.83.1] - 2026-06-26
+
+### Changed
+
+- **`pica_documents_read`** — description now tells the agent to STOP retrying
+  when `parsing_status` is `failed` and read the new `parse_error` field for the
+  reason (e.g. a legacy `.xls` that must be re-saved as `.xlsx`), instead of
+  polling a permanently-failing parse. Pairs with the server-side fix that makes
+  the read return an honest `failed` + `parse_error` rather than looping in
+  `processing` forever (ops_issue 8e197fe5). No tool/schema/SDK change.
+
+## [2.83.0] - 2026-06-25
+
+### Added
+
+- **`pica_resolve_release`** — release-grain Spotify resolver (scope
+  `write:catalog`). Gap-fills `upc`, `release_date`, `artwork_url`, `title`,
+  and `parent_label` from Spotify when `spotify_album_id` is set; routes every
+  write through the authority gate so human / higher-authority / unprovenanced
+  values are never overwritten. Idempotent (second call → `applied=[]`).
+  Spotify failure lands in `errors[]`, never throws. No `spotify_album_id` →
+  no-op + `recovery_hints`. v1 Spotify-only; additional sources in future ADRs.
+  New: route `POST /api/admin/releases/[id]/resolve`, SDK `resolveRelease`.
+- **`pica_catalog_health`** — agent-first no-arg whole-catalog **completeness +
+  cleanliness** verdict (score + ranked punch-list across works / recordings /
+  releases / people). Honest-zero: a check that throws is reported
+  `notAssessed`, never a silent pass. Org-scoped, bounded sample ids. (ADR-272)
+- **`pica_catalog_health_plan`** — derives an actionable fix-plan from the
+  health verdict: concrete fix-actions tagged safe/needs-scope plus a residual
+  list of what can't be auto-fixed, returned with a `planToken`. (ADR-273)
+- **`pica_catalog_health_fix`** — applies accepted plan actions (a list of
+  `actionIds`, or `all_safe_auto`) against a `planToken`; reports honest
+  `applied` / `skipped` and never reports a partial apply as success. (ADR-273)
+- **`pica_documents_list`** — lists uploaded catalog documents for the org
+  (parsed status + lean projection). ADR-274 document bridge.
+- **`pica_documents_read`** — scope-gated bounded read of a parsed document's
+  extracted content (`offset` / `max_chars`). ADR-274 document bridge.
+- **`pica_documents_link`** — stamps a parsed document's provenance link to a
+  `work` / `person` / `recording`. ADR-274 document bridge.
+
+### Changed
+
+- **`pica_recordings_update`** now accepts a free-text `notes` field (master-grain
+  annotation, parity with `works.notes`).
+
 ## [2.82.0] - 2026-06-22
 
 ### Added