From 1710d9471449a66b0a560793c9006c5f8f620d2c Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Tue, 10 Nov 2026 20:14:45 +0000
Subject: [PATCH] chore(main): release 4.0.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 30 ++++++++++++++++++++++++++++++
 PROVENANCE.md                 |  2 +-
 package.json                  |  2 +-
 4 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index e07945e95..4d204362b 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-    ".": "3.16.0"
+    ".": "4.0.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0435d6275..59c45b1ce 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,35 @@
 # Changelog
 
+## [4.0.0](https://github.com/launchdarkly/ldcli/compare/v3.16.0...v4.0.0) (2026-11-10)
+
+
+### ⚠ BREAKING CHANGES
+
+* The production spec renames or removes some API tags. The ai-configs, views-beta, holdouts-beta, release-pipelines-beta, and releases-beta command groups are replaced by agent-control, views, holdouts, and release-pipelines-deprecated. The contexts command group no longer has the delete-instances, list-instances, and search-instances commands.
+
+### Features
+
+* add observability commands to query logs, traces, aggregations, and keys ([#986](https://github.com/launchdarkly/ldcli/issues/986)) ([a34441c](https://github.com/launchdarkly/ldcli/commit/a34441c5afaeb6e7f12797999d335b1e4bfc0fdd))
+* sync the OpenAPI spec with the production spec ([#963](https://github.com/launchdarkly/ldcli/issues/963)) ([43c3ede](https://github.com/launchdarkly/ldcli/commit/43c3ede6a2b95cd4c5e4d1628a4348a277ad2034))
+* **sync:** add projection and problem core ([#987](https://github.com/launchdarkly/ldcli/issues/987)) ([bcc8d30](https://github.com/launchdarkly/ldcli/commit/bcc8d3080a98ce8943196b77cce7e6dbaf557b5d))
+* **sync:** add source descriptor storage ([#993](https://github.com/launchdarkly/ldcli/issues/993)) ([73fb6bc](https://github.com/launchdarkly/ldcli/commit/73fb6bcca702a7112184f15a6fd3112df4d2bca8))
+* **sync:** add the adapter core and the Markdown adapter ([#988](https://github.com/launchdarkly/ldcli/issues/988)) ([3b2d454](https://github.com/launchdarkly/ldcli/commit/3b2d45408c5e64b701040c15301324a145d532d3))
+* **sync:** add the link commands ([#998](https://github.com/launchdarkly/ldcli/issues/998)) ([86172ef](https://github.com/launchdarkly/ldcli/commit/86172ef59054d381a25146cd53b4612fcb612e29))
+* **sync:** add the Python adapter ([#991](https://github.com/launchdarkly/ldcli/issues/991)) ([51fc687](https://github.com/launchdarkly/ldcli/commit/51fc6877fc834ea91a19840a6c2b079c19034d26))
+* **sync:** add the structured document adapters ([#989](https://github.com/launchdarkly/ldcli/issues/989)) ([9931fc1](https://github.com/launchdarkly/ldcli/commit/9931fc164be02f7f67407d3988af35a8e9028191))
+* **sync:** add the TypeScript and JavaScript adapters ([#992](https://github.com/launchdarkly/ldcli/issues/992)) ([9754d1e](https://github.com/launchdarkly/ldcli/commit/9754d1e581eb097f972054fb5d3ea9a31550ecde))
+* **sync:** compile and publish repository sources ([#994](https://github.com/launchdarkly/ldcli/issues/994)) ([6c2332b](https://github.com/launchdarkly/ldcli/commit/6c2332b74a94b751ddd986a02bd2ba819fd4044a))
+* **sync:** detach descriptor-backed sources ([#1003](https://github.com/launchdarkly/ldcli/issues/1003)) ([ecb3854](https://github.com/launchdarkly/ldcli/commit/ecb3854e6d9af306d6810052b964d23003dd47a8))
+* **sync:** integrate repository sources with planning and link ([#995](https://github.com/launchdarkly/ldcli/issues/995)) ([3cef726](https://github.com/launchdarkly/ldcli/commit/3cef7260a472a324658bddd5e98598579cedc2e1))
+* **sync:** prepare repository source links ([#997](https://github.com/launchdarkly/ldcli/issues/997)) ([c979aad](https://github.com/launchdarkly/ldcli/commit/c979aada4f8c273da8190d147c596581abbe9a29))
+
+
+### Bug Fixes
+
+* **sync:** accept an empty remote manifest without a format version ([#1025](https://github.com/launchdarkly/ldcli/issues/1025)) ([44c0b72](https://github.com/launchdarkly/ldcli/commit/44c0b72d2c672e976cba2b72f0203f3aed2f7b0c))
+* **sync:** drop formatVersion from the sync manifest API ([#1026](https://github.com/launchdarkly/ldcli/issues/1026)) ([f4dd373](https://github.com/launchdarkly/ldcli/commit/f4dd3730d9b0b7517081af4cf51b06e6979a06ee))
+* **sync:** keep descriptor metadata out of the remote manifest ([#1027](https://github.com/launchdarkly/ldcli/issues/1027)) ([8c5df53](https://github.com/launchdarkly/ldcli/commit/8c5df53d16f81fd23e4fa8ef825b99b551b0895f))
+
 ## [3.16.0](https://github.com/launchdarkly/ldcli/compare/v3.15.0...v3.16.0) (2026-11-02)
 
 
diff --git a/PROVENANCE.md b/PROVENANCE.md
index 2c901437d..014159e56 100644
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -9,7 +9,7 @@ To verify build provenance attestations, we recommend using the [GitHub CLI `att
 <!-- x-release-please-start-version -->
 ```
 # Set the version of the package to verify
-PACKAGE_VERSION=3.16.0
+PACKAGE_VERSION=4.0.0
 ```
 <!-- x-release-please-end -->
 
diff --git a/package.json b/package.json
index aae1699a1..3b12b068e 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@launchdarkly/ldcli",
   "description": "The official command line interface for managing LaunchDarkly feature flags.",
-  "version": "3.16.0",
+  "version": "4.0.0",
   "main": "index.js",
   "scripts": {
     "postinstall": "go-npm install",