Function FormatYAMLError

pkg/parser/yaml_error.go:139–155

FormatYAMLError formats a YAML error with source code context using yaml.FormatError() frontmatterLineOffset is the line number where the frontmatter content begins in the document (1-based) Returns the formatted error string with line numbers adjusted for frontmatter position

(err error, frontmatterLineOffset int, sourceYAML string)

// frontmatterLineOffset is the line number where the frontmatter content begins in the document (1-based)
// Returns the formatted error string with line numbers adjusted for frontmatter position
func FormatYAMLError(err error, frontmatterLineOffset int, sourceYAML string) string {
	yamlErrorLog.Printf("Formatting YAML error with yaml.FormatError(): offset=%d", frontmatterLineOffset)

	// Use goccy/go-yaml's native FormatError for consistent formatting with source context
	// colored=false to avoid ANSI escape codes, inclSource=true to include source lines
	formatted := yaml.FormatError(err, false, true)

	// Translate cryptic parser messages to user-friendly descriptions (header line only)
	formatted = translateYAMLError(formatted)

	// Adjust line numbers in the formatted output to account for frontmatter position
	if frontmatterLineOffset > 1 {
		formatted = adjustLineNumbersInFormattedError(formatted, frontmatterLineOffset-1)
	}

	return formatted
}

// adjustLineNumbersInFormattedError adjusts line numbers in yaml.FormatError() output
// by adding the specified offset to all line numbers