Skip to content

[Plan / Interface] durable model-stream structural evidence (#1676) - #1679

Open
jhrozek wants to merge 3 commits into
mainfrom
plan/1676-structural-evidence
Open

jhrozek wants to merge 3 commits into
mainfrom
plan/1676-structural-evidence

Conversation

@jhrozek

@jhrozek jhrozek commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Plan / Interface

Relates to #1676.

This PR submits the human-reviewed acceptance plan and ADR for bounded, content-free structural evidence for successful and incomplete provider streams.

Contract

  • Adds the proposed docs/acceptance/model-stream-structural-evidence.md plan.
  • Adds ADR 0347 for the durable evidence boundary.
  • Reuses the existing network.attempt / EventLog / target-bound debugger path.
  • Defines the additive ProviderTerminalObserved and StreamOutcome contract.
  • Explicitly excludes raw provider traffic, response text, byte/framing capture, and public event exposure.
  • Updates the owning user documentation pages with the planned debugger/network behavior.

Verification

  • Acceptance-plan checker: passed.
  • task docs: passed.
  • Strict documentation/link checks: passed.

Implementation work is on the separate 1676-structural-evidence-implementation branch and is intentionally not part of this Plan / Interface PR.

jhrozek and others added 3 commits September 17, 2026 14:01
Co-Authored-By: OpenAI <noreply@openai.com>
… views

The network view previously described only failure/retry evidence.
Extend the two pages that document it to cover the new
provider_terminal_observed/stream_outcome structural summary this
branch adds, which also fires on successful and cancelled streams, not
just failures -- the piece that lets an operator distinguish "the
provider finished cleanly but produced unexpected output" from "the
stream was cut off or errored in transport."

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: OpenAI <noreply@openai.com>
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