Skip to content

docs(dispatcher): remove stale legacy Identity absence note - #16380

Merged
agentydragon merged 1 commit into
agentydragon:develfrom
agentydragon-agent:agentplane-dispatcher-doc-comments
Nov 14, 2026
Merged

agentydragon merged 1 commit into
agentydragon:develfrom
agentydragon-agent:agentplane-dispatcher-doc-comments

Conversation

@agentydragon-agent

@agentydragon-agent agentydragon-agent commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Remove the stale legacy-absence claim from Session.identity field 16. The protobuf field number and Identity fencing are unchanged.

Per-line audit

  • dispatcher/README.md (around line 99): kept. Migration 18 does not delete a Session only because its ServiceAccount owner columns are NULL; it deletes rows without execution_identity_name or without caller attribution. The current Identity-run Session path can retain an exact execution Identity and attribution without a managed ServiceAccount. A same-named ServiceAccount does not inherit access to that Session.
  • dispatcher/SPEC.md (around line 133): kept for the same live shape. Current Session creation records a complete execution Identity, while the ServiceAccount owner columns can remain NULL. Migration 18 retains rows with execution Identity and attribution even when those columns are NULL.
  • session_dispatcher.proto field 16: rewritten. Migration 18 deletes rows with a missing execution Identity. Current CreateSession requires a complete Identity, Store creation rejects an incomplete Identity, and scanSession rejects missing or incomplete stored Identity before the response projection. No current response can omit field 16 because of a pre-cutover row. The new comment makes no Sandbox, Sandbox UID, or single-environment requirement.

I checked agentplane/plans/session_environment_model.md and the REFACTOR_COHERENCE_AUDIT entry in agentplane/plans/task_dag.md. The selected central Session design allows zero or multiple environment attachments, and this change does not make an environment mandatory.

Deliberate exclusions

The README and SPEC owner-column lines stay because that nullable ServiceAccount-owner shape is still possible for Identity-run Sessions. Notification Service owner_namespace/owner_name columns are unrelated and untouched.

Tests

No system test specifically covers these comments. Existing Dispatcher integration tests cover Identity-run Sessions and the Identity response projection. This is a comment-only change; no tests were run. pre-commit run --files agentplane/runner_gateway/dispatcher/api/session/session_dispatcher.proto passed.

Questions for Claude

GitHub reports auto-merge enabled on #16380 by the repository account. I tried to disable it with the authorized agentydragon-agent token, but GitHub returned FORBIDDEN for disablePullRequestAutoMerge. Please disable auto-merge manually so this PR remains for hand review and merge.

@agentydragon-agent
agentydragon-agent force-pushed the agentplane-dispatcher-doc-comments branch from 79a4419 to 8493764 Compare November 14, 2026 08:13
@agentydragon
agentydragon enabled auto-merge (squash) November 14, 2026 08:16
@agentydragon
agentydragon merged commit 6e591f3 into agentydragon:devel Nov 14, 2026
10 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

Visual review for 8493764b

Request a manual rerun from the CI run page.

Warning

12 targets used the latest devel baseline (bb7c716f) because the PR base published none. Diffs there may include devel drift, not just this PR's changes.

No visual changes among the 12 affected Bazel test targets. Open visual review.

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.

2 participants