Skip to content

docs(changelog): correct the no-type agent behaviour - #765

Merged
lakhansamani merged 1 commit into
mainfrom
docs/changelog-not-enforced-denies
Aug 14, 2026
Merged

docs(changelog): correct the no-type agent behaviour#765
lakhansamani merged 1 commit into
mainfrom
docs/changelog-not-enforced-denies

Conversation

@lakhansamani

Copy link
Copy Markdown
Contributor

What

One sentence in the 2.4.0 changelog entry for agent-identity intersection.

Was: "Deployments without the type keep today's behaviour byte-for-byte and are counted as outcome="not_enforced""

Is: a model with no type agent now denies delegated checks. --fga-allow-unconstrained-agents restores the user-alone behaviour for migration. Both states meter as not_enforced and log at warn.

Why

e70c0b77 (fail closed on unevaluable agent constraint) changed the default from authorize-as-user-alone to deny, and added --fga-allow-unconstrained-agents. It updated the code, the tests and examples/with-agent-permissions, but not the changelog — the flag has no changelog entry anywhere.

That left the release notes asserting the opposite of what ships. Concretely: an operator who sees authorizer_fga_delegated_checks_total{outcome="not_enforced"} climbing reads the changelog, concludes their agents are silently over-privileged, and starts an exposure investigation — when the real situation is that their delegated calls are being denied and their integration is broken. Opposite diagnosis, opposite remedy.

Scope

Documentation only, no code. The same stale claim in the docs site is fixed in authorizerdev/docs#87.

Refs #764

The 2.4.0 entry still claimed a model without `type agent` keeps
pre-2.4.0 behaviour byte-for-byte. e70c0b7 changed that: the check now
denies, with --fga-allow-unconstrained-agents as the migration opt-out.
The flag shipped with no changelog entry at all.
Both states still meter as outcome="not_enforced", so a reader hitting
that metric was being told their agents run unconstrained when in fact
their delegated calls are being denied — opposite diagnosis, opposite
remedy.
Refs #764
@lakhansamani
lakhansamani merged commit 45f80ab into mainAug 14, 2026
3 checks passed
@lakhansamani
lakhansamani deleted the docs/changelog-not-enforced-denies branch August 14, 2026 04:55
Sign up for freeto 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.

1 participant

@lakhansamani