Repository navigation
The design record states the sealed contract, what it buys, and what it costs - #869
Merged
David-Noble-at-work merged 2 commits intoSep 8, 2026
Merged
Conversation
added 2 commits
September 8, 2026 12:38
A draft for review before any edits: six per-provider documents still name a resource as a pointer-to-struct and none says it is an interface; the resource-management summary describes the pre-seal shape; the accepted cost is recorded in one document only. One sentence per provider, the model's paragraph and a resolved decision for what the seal buys and what it costs, status files after. Documentation only, no code. Refs #647. Claude-Session: https://claude.ai/code/session_01SqQVFZz7AdiLZkGoAcUqRW
…it costs Eight provider documents name their resource as a sealed interface over an unexported struct and point at the registration contract; the pointer prose is gone. The resource-management summary states the two-level seal, and a new resolved decision records that the model's guarantees now hold by construction rather than by convention, with the accepted cost that reflection prints the implementation while identity names the interface. Status files follow, and the sealed-resources feature's phase 10 reads complete. Found on the way: the pkg provider has no design document at all, filed as #868. Refs #647. Claude-Session: https://claude.ai/code/session_01SqQVFZz7AdiLZkGoAcUqRW
David-Noble-at-work
deleted the
doc/647-sealed-contract-design-record
branch
September 8, 2026 21:50
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documentation only; no code changes. Closure of the sealed-provider-resources feature (#625 phase 10).
op.Resource, sealed by a method it declares itself, over an unexported struct, with the registration document as the contract. The file provider's document already said it. The pointer prose is gone from prose (*json.Resourceand its siblings); Go signatures keep their pointers, since that is what those functions receive.4-resource-management.md§2 states the two-level seal, and a new resolved decision (item 19) records that the guarantees — claims true when made, identity as the catalog key, a string as a key and never a constructor, complete intent in the graph — now hold by construction rather than by convention, because nothing outside a provider can build its resource and the announcement refuses any other shape.Found on the way: the pkg provider has no design document at all, the only provider without one, filed as #868 under the pkg feature rather than written inside a closure pass.
Plan:
docs/plans/doc/647-sealed-contract-design-record.md(complete).Acceptance — #647
3.5.xper-provider design docs drop any language describing the resource as a struct; each records the sealed shape — eight documents;pkghas no document, filed as The pkg provider has no design document: 3.5.x has an entry for every provider but this one #8684-resource-management.mdrecords what the seal buys — §2's paragraph and §9 item 19, tied to items 9, 15 and 18%Tprints*service.resourcewhile the URI saysservice.Resource— §9 item 19's second paragraphVerification
Closes #647.
https://claude.ai/code/session_01SqQVFZz7AdiLZkGoAcUqRW
Time
Computed by the algorithm of noblefactor-ops#188 at merge.