Skip to content

docs: verify Claude session control - #92

Merged
galligan merged 9 commits into
mainfrom
docs/claude-control-plane-research
Aug 5, 2026
Merged

docs: verify Claude session control#92
galligan merged 9 commits into
mainfrom
docs/claude-control-plane-research

Conversation

@galligan

@galligan galligan commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Context

Dispatch needs an evidence-backed Claude execution-provider plan before any adapter, provider flags, migrations, gateway, or release work begins. Claude Code 2.1.210 exposes durable UUID resume, structured streams, hooks, Agent View, and interrupt primitives, but their semantics differ from Codex and individual hook callbacks are not trustworthy receipts.

What changed

  • documents the official surfaces and disposable-session experiments for identity, cross-process send, attention, interrupt/resume, duplicate/concurrent sends, hook failure, repeated Stop cycles, Agent View, Remote Control, and zmx 0.6.0
  • adds proposed ADR-0026 and reconciles the existing daemon, event-ingress, and provider-event ADR boundaries
  • defines the implementation-ready fixed provider boundary, additive lane identity migration, aggregate receipt state machine, process supervision, restart/cleanup, security/privacy, CLI/MCP/config, fixtures, rollout, and operator recovery contract
  • adds sanitized executable research fixtures and negative assertions under spikes/claude/
  • records the complete capability matrix, cleanup ledger, tracker reconciliation, and 5/5 transport/security/full-stack reviews in the goal RETRO

No production Claude adapter, provider flag, migration, queue behavior, mesh/gateway, release, or publish implementation is included.

Key decisions

  • one serialized fresh --session-id / --resume --print process per message
  • processing requires terminal non-blocking prompt-hook settlement plus owned-stream activity
  • completion requires the final non-continuing Stop hook set, terminal success result, and clean process exit
  • no automatic retry after any possible stdin write
  • transport interruption and provider completion remain separate facts
  • human Agent View attach is separate from Dispatch-owned resume-for-send; unmanaged ordinary-session attach is unsupported in v1
  • same-UID hooks are advisory, not spoof-proof; no raw transcript or durable prompt digest is retained
  • zmx 0.6.0 is excluded because raw send is unacknowledged and raw PTY input is logged

Tracker

  • closes the research scope in DIS-9 when this PR is ready
  • first implementation slice: DIS-50
  • ordered follow-ups: DIS-51, DIS-52, DIS-53, then DIS-49 shorthands

Validation

  • transport review: 5/5, zero P0-P2
  • security/product review: 5/5, zero P0-P2
  • full-stack review: 5/5, zero P0-P2
  • goal packet doctor: passed with three clean current reports
  • just check: Ruff, format, strict mypy, 692 tests passed (17 deselected), wheel/sdist build, package-content validation
  • executable spike checks: shell syntax, Ruff/format/mypy, settings modes and permissions, JSONL fixtures, sanitizer privacy/block decisions, replay/negative receipt assertions, POSIX process-group cleanup

Risks and rollout

This PR changes research and architecture guidance only. The principal implementation risks—wrong-provider routing, false receipts, duplicate sends, stale hooks, raw-content retention, and signalling the wrong process—are converted into explicit DIS-50 acceptance criteria and disabled-by-default rollout gates.

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@galligan galligan changed the title docs(goal): add Claude control-plane research loop docs: verify Claude session control Jul 15, 2026
@galligan
galligan marked this pull request as ready for review July 15, 2026 20:05
@galligan

Copy link
Copy Markdown
Contributor Author

@cursor review

Comment thread spikes/claude/assert_probe.py

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 39c4c10c20

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread spikes/claude/sanitize_stream.jq Outdated
@galligan

Copy link
Copy Markdown
Contributor Author

@cursor review

Comment thread spikes/claude/assert_probe.py

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 14c383b. Configure here.

@galligan

Copy link
Copy Markdown
Contributor Author

@cursor review

@galligan

Copy link
Copy Markdown
Contributor Author

@codex review

@galligan

Copy link
Copy Markdown
Contributor Author

@cursor review

@galligan

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e66358d468

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread tests/fixtures/test_claude_research.py

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit ea126d8. Configure here.

@galligan

Copy link
Copy Markdown
Contributor Author

@cursor review

@galligan

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b1cfea81ea

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread tests/fixtures/test_claude_research.py

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit b1cfea8. Configure here.

@galligan

Copy link
Copy Markdown
Contributor Author

@cursor review

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 830b105. Configure here.

@galligan

Copy link
Copy Markdown
Contributor Author

@cursor review

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit a42b544. Configure here.

@galligan
galligan merged commit 276413e into main Aug 5, 2026
5 checks passed
@linear-code

linear-code Bot commented Aug 5, 2026

Copy link
Copy Markdown

DIS-53

DIS-54

DIS-57

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.

1 participant