Update documentation for simplified responsibilities

This commit is contained in:
2026-11-05 20:15:51 +00:00
parent b3b5ec3820
commit 96c619f7d4
4 changed files with 26 additions and 12 deletions

View File

@@ -426,6 +426,9 @@ references or explicit schema IDs rather than relying on that filename.
`WithSchemaFile` exposes one schema under its base name. An unreadable, `WithSchemaFile` exposes one schema under its base name. An unreadable,
invalid, or unresolvable schema causes an operational validation error. invalid, or unresolvable schema causes an operational validation error.
Valid JSON that fails the schema instead yields a failed validation result. Valid JSON that fails the schema instead yields a failed validation result.
Schema documents are detached without applying the provider extra-parameter
copy limits; this does not change the schema decoder, compiler, or
self-contained-resource rules.
## Credentials ## Credentials

View File

@@ -223,7 +223,9 @@ schema locations, and retains the compiled root validator. External resources
are rejected without file or network loading; in-document references remain are rejected without file or network loading; in-document references remain
supported. Root resources use canonical escaped file or private-scheme URLs. The supported. Root resources use canonical escaped file or private-scheme URLs. The
provider-facing structured-output metadata uses the root document captured by provider-facing structured-output metadata uses the root document captured by
the same plan. the same plan. Its detached schema document is not revalidated against the
runtime provider-value copier's traversal limits. Smoke inference uses a
separate JSON-only prepared plan before checking the prepared schema plan.
Schema preparation and execution remain synchronous. Promptkit checks Schema preparation and execution remain synchronous. Promptkit checks
cancellation before and after source resolution, JSON decoding, compilation, cancellation before and after source resolution, JSON decoding, compilation,

View File

@@ -6,7 +6,7 @@ Implement [responsibility-simplification.md](responsibility-simplification.md)
from baseline `c69703b`, using the accepted decisions and evidence in from baseline `c69703b`, using the accepted decisions and evidence in
[A1-responsibility.md](audit/A1-responsibility.md). Production code is unchanged [A1-responsibility.md](audit/A1-responsibility.md). Production code is unchanged
from the audit baseline `1ff6d77`. Findings 1–7 require changes; finding 8 requires from the audit baseline `1ff6d77`. Findings 1–7 require changes; finding 8 requires
preserving current runtime behavior. All stages below are initially pending. preserving current runtime behavior. Completion markers below record delivery.
This replaces the completed 33-stage audit-remediation plan. Historical links This replaces the completed 33-stage audit-remediation plan. Historical links
from the older audit/remediation documents refer to that earlier plan, available from the older audit/remediation documents refer to that earlier plan, available
@@ -443,6 +443,11 @@ allocation threshold is needed.
## Stage 16: Reconcile Canonical Documentation And Retire Obsolete Descriptions ## Stage 16: Reconcile Canonical Documentation And Retire Obsolete Descriptions
**Completed:** Canonical model-client, runner, source/validation, component,
and schema-format guidance now describes the delivered paths. The feature
roadmap records delivery with combined final checks pending; historical audit
evidence remains identified as baseline evidence.
**Findings:** 1–8. **Scope:** GoDoc, `docs/internal/{overview,llm,runner,sources}.md`, **Findings:** 1–8. **Scope:** GoDoc, `docs/internal/{overview,llm,runner,sources}.md`,
relevant consumer/format guidance, feature roadmap completion status. relevant consumer/format guidance, feature roadmap completion status.

View File

@@ -9,13 +9,14 @@ library's substantive feature set and selected ownership boundaries.
This roadmap captures the target state and work arising from the accepted This roadmap captures the target state and work arising from the accepted
[responsibility audit](audit/A1-responsibility.md). Findings 1–7 are selected [responsibility audit](audit/A1-responsibility.md). Findings 1–7 are selected
for remediation; finding 8 selects preservation of runtime input behavior. for remediation; finding 8 selects preservation of runtime input behavior.
All significant decisions are settled. Implementation is pending. The selected implementation is delivered; final combined validation and
repository hygiene checks remain pending.
The current baseline is `f660b6e`. The production code remains at the audited The work began from the `f660b6e` decision baseline and production audit
`1ff6d77` baseline; subsequent commits record the audit and accepted decisions. baseline `1ff6d77`. The audit owns historical evidence and decision rationale;
The audit owns evidence and decision rationale; this document owns the selected this document owns the selected target and delivery scope. The
target and delivery scope. The [implementation plan](implementation.md) owns the [implementation plan](implementation.md) records implementation and validation.
ordered stages and validation for this work. The older The older
[audit remediation](audit-remediation.md) describes an earlier completed sprint; [audit remediation](audit-remediation.md) describes an earlier completed sprint;
its previous plan is retained in Git history, not the current implementation plan. its previous plan is retained in Git history, not the current implementation plan.
@@ -46,14 +47,17 @@ throughput, complexity, or numerical-precision guarantees.
## Selected Work ## Selected Work
The following sections record the accepted work and its rationale. The target
above is implemented; final combined checks are tracked in the implementation
plan rather than inferred from the audit's baseline tests.
### Resolved Targets And Direct Wire Construction ### Resolved Targets And Direct Wire Construction
**Audit findings:** 1–2. **Audit findings:** 1–2.
The [LLM adapter](../../internal/llm/openai_compatible_client.go) currently stores At the audit baseline, the [LLM adapter](../../internal/llm/openai_compatible_client.go)
constructor-level endpoint/model defaults that engine assembly never supplies. stored constructor-level endpoint/model defaults that engine assembly never
It also creates a root wire struct solely to project it into the map actually supplied, and built an intermediate root wire struct before encoding.
encoded for transport.
Retire those constructor settings, stored fallback state, and fallback branches. Retire those constructor settings, stored fallback state, and fallback branches.
Backend/profile/request resolution remains the owner of target selection. Keep Backend/profile/request resolution remains the owner of target selection. Keep