package configuration import ( "io" "strconv" "strings" "go.maximumdirect.net/configkit" ) // Inspection is the read-only subset of the native ConfigKit view used by // the facade. It does not expose typed configuration or resource contexts. type Inspection interface { Metadata() configkit.Metadata Sources() []configkit.SourceInfo Diagnostics() []configkit.Diagnostic HistoricalPaths() []configkit.Path Explain(configkit.Path) (configkit.Explanation, bool) WriteEffective(io.Writer) error WriteExplanation(io.Writer, configkit.Path) error nativeView() configkit.Inspection } type inspectionResult struct { configkit.Inspection diagnostics []configkit.Diagnostic } func (inspection inspectionResult) nativeView() configkit.Inspection { return inspection.Inspection } func (inspection inspectionResult) Diagnostics() []configkit.Diagnostic { return ownDiagnostics(inspection.diagnostics) } // Inspection returns only the retained result's inspection operations. func (state *loaded) Inspection() Inspection { if state == nil { return nil } return inspectionResult{Inspection: state.view, diagnostics: state.diagnostics} } // Diff compares two captured ConfigKit results without reconstructing them. func Diff(left, right Inspection) ([]configkit.Difference, error) { return left.nativeView().Diff(right.nativeView()) } // Sensitive marks credential-shaped provider values beneath PromptKit settings. func Sensitive(path configkit.Path) bool { pointer := path.String() if pointer == "" { return false } parts := strings.Split(strings.TrimPrefix(pointer, "/"), "/") if len(parts) == 0 || parts[0] != "promptkit" { return false } parts = parts[1:] if !providerExtraParamsPath(parts) { return false } key := strings.ToLower(strings.ReplaceAll(strings.ReplaceAll(parts[len(parts)-1], "~1", "/"), "~0", "~")) switch key { case "api_key", "apikey", "authorization", "credential", "credentials", "password", "secret", "token", "access_token": return true default: return false } } func providerExtraParamsPath(parts []string) bool { if len(parts) >= 4 && sequenceIndex(parts[1]) && (parts[0] == "backends" || parts[0] == "profiles") && parts[2] == "extra_params" { return true } return len(parts) >= 6 && parts[0] == "collections" && parts[1] != "" && (parts[2] == "backends" || parts[2] == "profiles") && sequenceIndex(parts[3]) && parts[4] == "extra_params" } func sequenceIndex(segment string) bool { index, err := strconv.Atoi(segment) return err == nil && index >= 0 && strconv.Itoa(index) == segment }