elastic / elastic/integrations

[breaking-change] Undocumented breaking changes detected (2026-05-15)

Open
#19,035 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Handlebars
Stars
333
Forks
647
Avg merge
2d 18h
Merged PRs (30d)
182

Description

Recent commits introduced breaking changes that appear undocumented.

## Breaking Changes

### 1. CyberArk EPM raised the minimum supported Kibana version without a migration note
**Commit(s):** [`60b034eb`](https://github.com/elastic/integrations/commit/60b034ebced3830f730501b47690fcac7ffd0dc7)
**PR:** https://github.com/elastic/integrations/pull/18980
**What broke:** Upgrading to `cyberark_epm` `1.4.0` now requires Kibana `^8.19.2 || ^9.0.5` (previously `^8.16.0 || ^9.0.0`), so users pinned to 8.16–8.19.1 / 9.0.0–9.0.4 cannot upgrade to the latest package.
**Evidence:**
- `packages/cyberark_epm/manifest.yml` changed `conditions.kibana.version` from `^8.16.0 || ^9.0.0` to `^8.19.2 || ^9.0.5` in `60b034eb`.
- Current file shows the new constraint at `packages/cyberark_epm/manifest.yml:11`.
**Why undocumented:**
- PR title/body describe agentless enablement only and do not call out the version-floor break or migration path.
- Changelog entry is `type: enhancement` with description `Enable Agentless deployment.` (`packages/cyberark_epm/changelog.yml:2-6`) and no compatibility warning.

### 2. Darktrace raised the minimum supported Kibana version without a migration note
**Commit(s):** [`4bac55e4`](https://github.com/elastic/integrations/commit/4bac55e48a8366ddc793e15c0f1f6c84e9538c87)
**PR:** https://github.com/elastic/integrations/pull/18991
**What broke:** Upgrading to `darktrace` `2.1.0` now requires Kibana `^8.19.2 || ^9.0.5` (previously `^8.13.0 || ^9.0.0`), so users on older but previously supported stack versions cannot upgrade to the latest package.
**Evidence:**
- `packages/darktrace/manifest.yml` changed `conditions.kibana.version` from `^8.13.0 || ^9.0.0` to `^8.19.2 || ^9.0.5` in `4bac55e4`.
- Current file shows the new constraint at `packages/darktrace/manifest.yml:12`.
**Why undocumented:**
- PR title/body describe agentless enablement only and do not call out the compatibility break.
- Changelog entry is `type: enhancement` with description `Enable Agentless deployment.` (`packages/darktrace/changelog.yml:2-6`) and no migration guidance.

## Suggested Actions
- [ ] Document these compatibility breaks explicitly in changelog/release notes (mark as breaking change)
- [ ] Add migration guidance for users on unsupported Kibana versions (e.g., pin previous package versions or required stack upgrade path)

> [!NOTE]
>
> 🔒 Integrity filter blocked 28 items
>
> The following items were blocked because they don't meet the GitHub integrity level.
>
> - [#18880](https://github.com/elastic/integrations/pull/18880) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19027](https://github.com/elastic/integrations/pull/19027) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18890](https://github.com/elastic/integrations/pull/18890) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18237](https://github.com/elastic/integrations/pull/18237) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18219](https://github.com/elastic/integrations/pull/18219) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18980](https://github.com/elastic/integrations/pull/18980) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19005](https://github.com/elastic/integrations/pull/19005) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18991](https://github.com/elastic/integrations/pull/18991) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18969](https://github.com/elastic/integrations/pull/18969) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18951](https://github.com/elastic/integrations/pull/18951) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#10867](https://github.com/elastic/integrations/issues/10867) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#15075](https://github.com/elastic/integrations/issues/15075) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#14928](https://github.com/elastic/integrations/issues/14928) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18338](https://github.com/elastic/integrations/issues/18338) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18208](https://github.com/elastic/integrations/issues/18208) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18978](https://github.com/elastic/integrations/issues/18978) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - ... and 12 more items
>
> To allow these resources, lower `min-integrity` in your GitHub frontmatter:
>
> ```yaml
> tools:
> github:
> min-integrity: approved # merged | approved | unapproved | none
> ```
>
>

---
[What is this?](https://ela.st/github-ai-tools) | [From workflow: Breaking Change Detector](https://github.com/elastic/integrations/actions/runs/25920725286)

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.
> - [x] expires on May 22, 2026, 1:44 PM UTC

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.