Clarify configuration handoff consistency guidance

This commit is contained in:
2026-11-21 17:51:36 +00:00
parent df8384426d
commit 1408001fce
3 changed files with 8 additions and 5 deletions

View File

@@ -129,8 +129,8 @@ nil result, or unavailable inspection view returns `ErrInvalidConfig`. It
does not load sources, rerun callbacks, or add a bundle. Select
`BundledOpenRouterUnderlay()` before the application load if desired;
`WithBundledOpenRouter` affects only `NewEngine`. `RuntimeConfig` supplies only
client timeout, HTTP client, and transient-retry settings. Do not mutate the
resolved settings before handoff; subsequent mutation does not change captured
client timeout, HTTP client, and transient-retry settings. Keep resolved settings
consistent with the load's frozen inspection evidence at handoff; subsequent mutation does not change captured
resources. Applications may register equivalent callbacks explicitly instead
of using `Configure`. Construction errors retain their underlying causes;
on the standalone path, a ConfigKit `LoadError` remains available through

View File

@@ -12,7 +12,10 @@ reviewed changes begin after `248d0db`.
### 1. Narrow The Pre-Handoff Mutation Wording To The Accepted Expectation
Status: open. Priority: P3. Implementation stage: 16.
Status: complete. Priority: P3. Implementation stage: 16.
Completion: narrowed constructor GoDoc and consumer guidance to the consistency
expectation; reviewed against the roadmap. No runtime behavior changed.
Locations: `engine.go:280` and `docs/consumers/pkg-promptkit.md:132`.