Skip to content

docs: one-pager tying the session designs together - #4230

Open
sea-snake wants to merge 1 commit into
docs/session-and-account-metricsfrom
docs/shared-revocable-sessions
Open

docs: one-pager tying the session designs together#4230
sea-snake wants to merge 1 commit into
docs/session-and-account-metricsfrom
docs/shared-revocable-sessions

Conversation

@sea-snake

@sea-snake sea-snake commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Documentation only.

Three stacked design docs is a lot to hand someone who just wants to know what is changing and why. Adds docs/ongoing/shared-revocable-sessions.md: the glanceable version, with diagrams for today and after, sibling-subdomain sharing, and a table of which methods are public, internal and untouched, linking into the detail.

The two properties it exists to make obvious: a stolen delegation is worth at most 5 minutes instead of up to 30 days, and a session cannot renew or clone itself, because creating one needs an access method a session does not have.

@sea-snake
sea-snake requested a review from a team as a code owner August 18, 2026 15:03
@zeropath-ai

zeropath-ai Bot commented Aug 18, 2026

Copy link
Copy Markdown

No security or compliance issues detected. Reviewed everything up to 583279c.

Security Overview
Detected Code Changes
Change Type Relevant files
Other relevant changes ► docs/ongoing/shared-revocable-sessions.md
    Add new documentation page for Shared revocable sessions

@sea-snake
sea-snake requested a lite review from Copilot August 18, 2026 15:03

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch from e0fc56d to 2e94eab Compare August 19, 2026 10:21
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch 2 times, most recently from a2185eb to 1805bd6 Compare August 20, 2026 11:05
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch from a7beca9 to 5ed9877 Compare August 20, 2026 14:48
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch from f8a3b51 to 18405e5 Compare August 21, 2026 11:50
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch 2 times, most recently from e1d7211 to e75dcb0 Compare August 21, 2026 11:53
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch from e75dcb0 to 0cd850e Compare August 21, 2026 15:00
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch from 0cd850e to 0bd5266 Compare August 21, 2026 16:40
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch 2 times, most recently from 6db95a2 to 5226f2a Compare August 22, 2026 17:24
@sea-snake sea-snake added feature:tracked-default-accounts Design: tracked default accounts, application removal, principal lookup feature:revocable-app-sessions Design: revocable app sessions feature:silent-reauth-redirect Design: silent re-auth over the redirect transport labels Aug 22, 2026
@sea-snake
sea-snake force-pushed the docs/shared-revocable-sessions branch from 5226f2a to a379a1f Compare August 22, 2026 20:08
Read further lists every design and spec plus the two documents that are
neither: the scenarios that must hold once the features are built, and the
metrics review of the dashboard that watches them. Every relative link in
that table resolves to a file on this branch.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature:revocable-app-sessions Design: revocable app sessions feature:silent-reauth-redirect Design: silent re-auth over the redirect transport feature:tracked-default-accounts Design: tracked default accounts, application removal, principal lookup

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants