Skip to content

chore(docs): update of OEL changelog#2517

Merged
deepakprabhakara merged 1 commit into
masterfrom
oel-changelog-update
Apr 22, 2026
Merged

chore(docs): update of OEL changelog#2517
deepakprabhakara merged 1 commit into
masterfrom
oel-changelog-update

Conversation

@ory-bot
Copy link
Copy Markdown
Collaborator

@ory-bot ory-bot commented Apr 21, 2026

Update OEL changelog

Summary by CodeRabbit

Release Notes – v26.2.5

  • Bug Fixes

    • Resolved error handling to prevent cross-request information contamination across all services.
  • New Features

    • Kratos: Enum identity traits now render as dropdown selectors; phone numbers normalize to E.164 with CLI migration tool; OIDC registration flows include recovery parameter.
    • Keto: Expand endpoint capped at 4,000 nodes by default (override available).

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 21, 2026

📝 Walkthrough

Walkthrough

Add v26.2.5 changelog entries across OEL projects documenting: fixes for shared mutable error state, Keto expand endpoint default node cap (4,000, configurable), Kratos OIDC registration return_to behavior, phone number E.164 normalization, and identity enum dropdown rendering.

Changes

Cohort / File(s) Summary
Keto Changelog
docs/self-hosted/oel/keto/changelog/v26.2.5.md
Documents expand endpoint default node limit (4,000) with limit.max_expand_size override and fix for shared mutable package-level error state by creating fresh error instances per call.
Kratos Changelog
docs/self-hosted/oel/kratos/changelog/v26.2.5.md
Documents shared mutable error state fix, OIDC native/API registration adding flow to return_to when traits are missing, phone number normalization to E.164 with kratos migrate normalize-phone-numbers, and enum traits rendered as dropdowns via options on InputAttributes.
Oathkeeper Changelog
docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md
Documents fix for package-level error mutation (e.g., herodot.ErrNotFound) by returning fresh error instances to prevent cross-request contamination and concurrency races.
OAuth2 Changelog
docs/self-hosted/oel/oauth2/changelog/v26.2.5.md
Documents fix for shared mutable error globals being mutated in place; now a fresh error instance is created per call, limiting observable impact to corrected error-response content.
Polis Changelog
docs/self-hosted/oel/polis/changelog/v26.2.5.md
Notes no changelog entries for polis/oel in v26.2.5.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description 'Update OEL changelog' is extremely minimal and lacks the required structure from the template, including context, related issues, breaking changes documentation, and checklist items. Expand the description to follow the template: add context about the changes, link related issues/design documents, document any breaking changes, and complete the checklist items.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title 'chore(docs): update of OEL changelog' is directly related to the changeset, which updates changelog files for v26.2.5 across multiple OEL products (keto, kratos, oathkeeper, oauth2, polis).
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch oel-changelog-update

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🧹 Nitpick comments (1)
docs/self-hosted/oel/keto/changelog/v26.2.5.md (1)

8-35: Consider reducing duplicated shared-error text across OEL changelogs

This section is repeated nearly verbatim across multiple product changelogs; consider a shared include/snippet to reduce drift in future edits.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosted/oel/keto/changelog/v26.2.5.md` around lines 8 - 35, The
repeated "Fix shared mutable state in error handling" section (describing issues
with package-level errors like herodot.ErrNotFound and how the new API creates
fresh error instances) should be extracted into a shared include/snippet and
referenced from each OEL changelog to avoid duplication; create a single
canonical snippet containing the explanatory text about shared mutable error
state, examples of impacted values (cookies, UUIDs, OAuth2 hints, OIDC URLs,
schema fetches, JWT claims), and the note about no persistent write, then
replace the repeated blocks in each changelog with a short pointer/include to
that snippet.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/self-hosted/oel/keto/changelog/v26.2.5.md`:
- Line 12: Update the sentence fragment "an error — reason text, details, etc,
modified the global" to use the standard abbreviation punctuation by changing
"etc" to "etc." so it reads "...details, etc., modified the global"; locate the
exact phrase in the changelog entry for v26.2.5 (the line containing "reason
text, details, etc") and add the missing period after "etc" to match American
English style.

In `@docs/self-hosted/oel/kratos/changelog/v26.2.5.md`:
- Line 7: Update the sentence fragment in the changelog that reads "etc" to
include a trailing period ("etc.") so that the phrase "an error — reason text,
details, etc" becomes "an error — reason text, details, etc."; locate the
occurrence of the word "etc" in the diff line shown and add the period to the
markdown content.

In `@docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md`:
- Line 7: In the sentence fragment "an error — reason text, details, etc,
modified the global." (the line containing "reason text, details, etc"), replace
the bare "etc" with "etc." so it reads "reason text, details, etc." and preserve
the surrounding punctuation/spacing exactly as before.

In `@docs/self-hosted/oel/oauth2/changelog/v26.2.5.md`:
- Line 7: The phrase "details, etc" in the changelog entry should end with a
period; locate the sentence containing "details, etc" (the line reading "an
error — reason text, details, etc, modified the global. The next request to
reach an error path using the same error inherited") and change "etc" to "etc."
so the sentence reads "details, etc." preserving the rest of the sentence
punctuation and spacing.

In `@docs/self-hosted/oel/polis/changelog/v26.2.5.md`:
- Line 1: Replace the plural word "versions" in the sentence "No changelog
entries found for polis/oel in versions v26.2.5" with the singular "version" so
it reads "No changelog entries found for polis/oel in version v26.2.5"; update
that string in the changelog file to fix the singular/plural mismatch.

---

Nitpick comments:
In `@docs/self-hosted/oel/keto/changelog/v26.2.5.md`:
- Around line 8-35: The repeated "Fix shared mutable state in error handling"
section (describing issues with package-level errors like herodot.ErrNotFound
and how the new API creates fresh error instances) should be extracted into a
shared include/snippet and referenced from each OEL changelog to avoid
duplication; create a single canonical snippet containing the explanatory text
about shared mutable error state, examples of impacted values (cookies, UUIDs,
OAuth2 hints, OIDC URLs, schema fetches, JWT claims), and the note about no
persistent write, then replace the repeated blocks in each changelog with a
short pointer/include to that snippet.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: f37d16e7-6fd7-47b2-97b8-a871f172d3b0

📥 Commits

Reviewing files that changed from the base of the PR and between e94f142 and ec037c1.

📒 Files selected for processing (5)
  • docs/self-hosted/oel/keto/changelog/v26.2.5.md
  • docs/self-hosted/oel/kratos/changelog/v26.2.5.md
  • docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md
  • docs/self-hosted/oel/oauth2/changelog/v26.2.5.md
  • docs/self-hosted/oel/polis/changelog/v26.2.5.md

Comment thread docs/self-hosted/oel/keto/changelog/v26.2.5.md
Comment thread docs/self-hosted/oel/kratos/changelog/v26.2.5.md
Comment thread docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md
Comment thread docs/self-hosted/oel/oauth2/changelog/v26.2.5.md
Comment thread docs/self-hosted/oel/polis/changelog/v26.2.5.md
@ory-bot ory-bot force-pushed the oel-changelog-update branch from ec037c1 to d81df55 Compare April 22, 2026 06:54
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (4)
docs/self-hosted/oel/oauth2/changelog/v26.2.5.md (1)

7-7: ⚠️ Potential issue | 🟡 Minor

Punctuation: use “etc.”

Line 7 should read ...details, etc., modified....

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosted/oel/oauth2/changelog/v26.2.5.md` at line 7, Fix the
punctuation in the sentence fragment "details, etc, modified" by changing "etc"
to the correct form "etc." and ensuring proper comma placement so the phrase
reads "...details, etc., modified..."; update the occurrence in the changelog
sentence (the fragment containing "reason text, details, etc, modified the
global") accordingly.
docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md (1)

7-7: ⚠️ Potential issue | 🟡 Minor

Punctuation: use “etc.”

Line 7 should use “etc.” (with period): ...details, etc., modified....

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md` at line 7, Replace the
missing period after "etc" on the phrase "details, etc, modified" so it reads
"details, etc., modified" — locate the sentence in the changelog entry
containing "an error — reason text, details, etc, modified the global" and add
the period after "etc" to correct punctuation.
docs/self-hosted/oel/keto/changelog/v26.2.5.md (1)

12-12: ⚠️ Potential issue | 🟡 Minor

Punctuation: use “etc.”

Line 12 should be ...details, etc., modified... for standard abbreviation punctuation.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosted/oel/keto/changelog/v26.2.5.md` at line 12, Change the
punctuation in the sentence fragment so the abbreviation “etc.” includes the
closing period before the following comma; replace the phrase fragment "details,
etc, modified" with "details, etc., modified" to conform to standard
abbreviation punctuation.
docs/self-hosted/oel/kratos/changelog/v26.2.5.md (1)

7-7: ⚠️ Potential issue | 🟡 Minor

Punctuation: use “etc.”

Line 7 should use etc. (i.e., ...details, etc., modified...).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosted/oel/kratos/changelog/v26.2.5.md` at line 7, Fix the
punctuation in the sentence fragment "an error — reason text, details, etc,
modified the global" by changing "etc" to "etc." so the phrase reads
"...details, etc., modified the global"; update the line in the changelog (the
sentence containing "reason text, details, etc, modified the global") to include
the period after "etc" and ensure spacing around the em dash remains unchanged.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@docs/self-hosted/oel/keto/changelog/v26.2.5.md`:
- Line 12: Change the punctuation in the sentence fragment so the abbreviation
“etc.” includes the closing period before the following comma; replace the
phrase fragment "details, etc, modified" with "details, etc., modified" to
conform to standard abbreviation punctuation.

In `@docs/self-hosted/oel/kratos/changelog/v26.2.5.md`:
- Line 7: Fix the punctuation in the sentence fragment "an error — reason text,
details, etc, modified the global" by changing "etc" to "etc." so the phrase
reads "...details, etc., modified the global"; update the line in the changelog
(the sentence containing "reason text, details, etc, modified the global") to
include the period after "etc" and ensure spacing around the em dash remains
unchanged.

In `@docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md`:
- Line 7: Replace the missing period after "etc" on the phrase "details, etc,
modified" so it reads "details, etc., modified" — locate the sentence in the
changelog entry containing "an error — reason text, details, etc, modified the
global" and add the period after "etc" to correct punctuation.

In `@docs/self-hosted/oel/oauth2/changelog/v26.2.5.md`:
- Line 7: Fix the punctuation in the sentence fragment "details, etc, modified"
by changing "etc" to the correct form "etc." and ensuring proper comma placement
so the phrase reads "...details, etc., modified..."; update the occurrence in
the changelog sentence (the fragment containing "reason text, details, etc,
modified the global") accordingly.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 9c4fc00a-a62c-4720-86dd-0ca28f6fc4a4

📥 Commits

Reviewing files that changed from the base of the PR and between ec037c1 and d81df55.

📒 Files selected for processing (5)
  • docs/self-hosted/oel/keto/changelog/v26.2.5.md
  • docs/self-hosted/oel/kratos/changelog/v26.2.5.md
  • docs/self-hosted/oel/oathkeeper/changelog/v26.2.5.md
  • docs/self-hosted/oel/oauth2/changelog/v26.2.5.md
  • docs/self-hosted/oel/polis/changelog/v26.2.5.md
✅ Files skipped from review due to trivial changes (1)
  • docs/self-hosted/oel/polis/changelog/v26.2.5.md

@deepakprabhakara deepakprabhakara merged commit af07ddb into master Apr 22, 2026
12 checks passed
@deepakprabhakara deepakprabhakara deleted the oel-changelog-update branch April 22, 2026 15:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants