Skip to content

docs(providers): define shared provider identity contract - #111

Merged
galligan merged 2 commits into
mainfrom
dis-78-record-the-shared-stationprovider-contract-and-migration
Sep 13, 2026
Merged

galligan merged 2 commits into
mainfrom
dis-78-record-the-shared-stationprovider-contract-and-migration

Conversation

@galligan

@galligan galligan commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Context

Dispatch needs one durable vocabulary for provider identity, routing, delivery evidence, and future Hermes work. This slice records the shared contract that lets those surfaces evolve without conflating provider bindings, native session identity, or receipt state.

What changed

  • Defines stable provider and binding identity, preserved Codex IDs and refs, layered receipt evidence, and capability gates.
  • Reconciles the provider, Claude, and network design documents through ADR-0028 and the tracked execution plan.
  • Establishes the migration order: shared foundations first, authenticated synthetic reads as the first cloud proof, and the June 30 gateway exploration as non-normative history.
  • Records explicit Hermes pickup gates and the boundary between documented contracts and implemented runtime behavior.

Verification

  • just check passed Ruff, formatting, strict mypy, 1,345 tests with 17 live tests deselected, wheel and sdist builds, and package-content validation at the current stack tip.
  • Structural checks passed for 68 local links and fenced blocks across 11 documents; git diff --check passed.
  • Targeted documentation review scored 5/5 with zero P0–P2 findings.
  • Final exact-head composed-stack review at 7e5d6ba is clean at 5/5 with zero P0–P3 findings; adversarial supervisor coverage exercised all 27 immediate and 12 delayed recovery/closure outcome combinations.
  • Hosted current-head check and Bootstrap smoke (macOS) are successful.

Risks and boundaries

This is documentation and contract work. It does not implement provider migration, Hermes runtime support, gateway execution, release, or installed-runtime changes. The stack remains ready for review and unmerged.

Closes: DIS-78

@linear-code

linear-code Bot commented Sep 11, 2026

Copy link
Copy Markdown

DIS-78

@galligan
galligan force-pushed the dis-78-record-the-shared-stationprovider-contract-and-migration branch from 8726aeb to 3a15b2f Compare September 13, 2026 18:20
@galligan galligan changed the title docs(providers): define shared station and provider foundation docs(providers): define shared provider identity contract Sep 13, 2026
@galligan
galligan marked this pull request as ready for review September 13, 2026 19:27
@cursor

cursor Bot commented Sep 13, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Documentation and ADR/plan updates only; no executable code, migrations, or auth paths change in this diff.

Overview
Records the shared foundation for Hermes, Claude, and network work before any provider migration or gateway code lands.

ADR-0028 introduces stations as runtime boundaries with binding-scoped identity, a single local reservation path, layered gateway/station/provider receipts, and explicit Codex ref/selector compatibility rules. A new stations-providers execution packet (goal, plan, refs, retro) sequences DIS-70 through DIS-93, Hermes pickup gates, and verification expectations.

Mesh and gateway docs are reconciled with that contract: ADR-0013/0014 shift from machine/Codex federation and SSH/ad-hoc modes toward station targets, Tailscale direct plus authenticated cloud MCP, and immutable operation envelopes. cloud-gateway.md now states the admission/receipt model and marks the June 30 exploration as non-normative history.

Claude plan stops proposing its own lane-identity migration—DIS-79–82 and DIS-70 own shared schema, routing, reservations, and evidence; DIS-50 consumes them. design.md notes ADR-0028 as the proposed next evolution while the one-Codex-connection baseline stays in force until gated slices merge.

No runtime or registry behavior changes in this PR.

Reviewed by Cursor Bugbot for commit 322d893. Configure here.

@cursor

cursor Bot commented Sep 13, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_5cb3b35b-332a-4538-8890-3ac46cc37142)

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 13, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-13T20:53:35.981438Z c3aa0af Manual request
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@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: 3a15b2f6c0

ℹ️ 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 docs/adrs/0028-stations-own-provider-bindings-and-durable-execution.md Outdated
@cursor

cursor Bot commented Sep 13, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_065297a2-94eb-4918-8500-cdea334759e4)

@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: 322d893659

ℹ️ 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".

@galligan
galligan force-pushed the dis-78-record-the-shared-stationprovider-contract-and-migration branch from 322d893 to c3aa0af Compare September 13, 2026 20:48
@galligan

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Hooray!

Reviewed commit: c3aa0af276

ℹ️ 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".

galligan commented Sep 13, 2026

Copy link
Copy Markdown
Contributor Author

Merge activity

  • Sep 13, 11:23 PM UTC: A user started a stack merge that includes this pull request via Graphite.
  • Sep 13, 11:23 PM UTC: @galligan merged this pull request with Graphite.

@galligan
galligan merged commit edcd1a8 into main Sep 13, 2026
10 checks passed
galligan added a commit that referenced this pull request Sep 14, 2026
## Context

`main` at e734dac carries the full stations/providers stack (#111#122) on top of 0.12.0 with no published release. Releases are cut by CI only when `pyproject.toml` carries an untagged version, so this PR is the bump.

## What changed

- `pyproject.toml`: 0.12.0 → 0.13.0
- `uv.lock`: project version line only

No code changes. When this merges, main CI tags `v0.13.0`, creates the GitHub Release, and dispatches the PyPI publish workflow.

## Since v0.12.0

Provider-binding identity (schema v24), guarded binding-qualified routing, frozen provider requests (v25), correlated receipt observations (v26), independent provider startup/recovery, the Hermes local adapter with `lane_launches` (v27) and generation quarantine, operator diagnostics, packaged skills/docs, and the installed-wheel smoke. Registry schema moves 23 → 29; the release notes carry the migrate-before-start upgrade step.

## Verification

- `just check` on this branch: ruff, format, `mypy --strict`, 1,367 tests (17 live tests deselected), wheel/sdist build reporting 0.13.0, package-content check.
- `just release-status` reports `create GitHub Release v0.13.0`.

Refs: DIS-96
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