Function formatSchemaFailureDetail

pkg/parser/schema_compiler.go:489–526

formatSchemaFailureDetail builds a single line of schema error detail for one JSONPathInfo. It is called once per failing schema constraint in validateWithSchemaAndLocation, which then joins them into a "Multiple schema validation failures:" message. Because CompilerError.Position only captures the

(pathInfo JSONPathInfo, schemaJSON, frontmatterContent string, frontmatterStart int)

// The old "at '/path' (line N, column M):" prefix is replaced with "'path' (line N, col M):"
// to remove the schema-jargon "at" keyword and the leading slash.
func formatSchemaFailureDetail(pathInfo JSONPathInfo, schemaJSON, frontmatterContent string, frontmatterStart int) string {
	path := pathInfo.Path
	if path == "" {
		path = "/"
	}

	location := LocateJSONPathForPathInfo(frontmatterContent, pathInfo)
	line := frontmatterStart
	column := 1
	if location.Found {
		line = location.Line + frontmatterStart - 1
		column = location.Column
	}

	message := rewriteAdditionalPropertiesError(cleanOneOfMessage(pathInfo.Message))
	// Strip any "at '/path': " prefix from the message to avoid duplication with the
	// "'path' (line N, col M):" prefix we prepend below.
	message = stripAtPathPrefix(message)
	// Translate schema constraint language (e.g. "minimum: got X, want Y") to plain English.
	message = translateSchemaConstraintMessage(message)
	// Append valid-values hint for well-known fields (e.g. permissions scopes).
	// hintAdded is true when appendKnownFieldValidValuesHint actually augmented the message
	// (i.e. the path is a known field and the error is an unknown-property error).
	// When a hint was added we skip generateSchemaBasedSuggestions to avoid repeating the
	// same valid-values or "Did you mean" content.
	message, hintAdded := appendKnownFieldValidValuesHint(message, pathInfo.Path)
	if !hintAdded {
		suggestions := generateSchemaBasedSuggestions(schemaJSON, pathInfo.Message, pathInfo.Path, frontmatterContent)
		if suggestions != "" {
			message = message + ". " + suggestions
		}
	}
	displayPath := strings.TrimPrefix(path, "/")
	if displayPath == "" {
		return message
	}
	return fmt.Sprintf("'%s' (line %d, col %d): %s", displayPath, line, column, message)
}