Function validateWithSchema

pkg/parser/schema_compiler.go:281–331

(frontmatter map[string]any, schemaJSON, context string)

}

func validateWithSchema(frontmatter map[string]any, schemaJSON, context string) error {
	schemaCompilerLog.Printf("Validating frontmatter against schema for context: %s (%d fields)", context, len(frontmatter))

	// Determine which cached schema to use based on the schemaJSON
	var schema *jsonschema.Schema
	var err error

	switch schemaJSON {
	case mainWorkflowSchema:
		schemaCompilerLog.Print("Using cached main workflow schema")
		schema, err = getCompiledMainWorkflowSchema()
	case mcpConfigSchema:
		schemaCompilerLog.Print("Using cached MCP config schema")
		schema, err = getCompiledMcpConfigSchema()
	case RepoConfigSchema:
		schemaCompilerLog.Print("Using cached repo config schema")
		schema, err = GetCompiledRepoConfigSchema()
	case awManifestSchema:
		schemaCompilerLog.Print("Using cached aw manifest schema")
		schema, err = getCompiledAwManifestSchema()
	default:
		// Fallback for unknown schemas (shouldn't happen in normal operation)
		// Compile the schema on-the-fly
		schemaCompilerLog.Print("Compiling unknown schema on-the-fly")
		schema, err = compileSchema(schemaJSON, "http://contoso.com/schema.json")
	}

	if err != nil {
		return fmt.Errorf("schema validation error for %s: %w", context, err)
	}

	// Normalize YAML-native Go types to JSON-compatible types for schema validation.
	// goccy/go-yaml produces uint64/int64 for integers, but JSON schema validators
	// expect float64 for all numbers (matching encoding/json's behavior).
	// This avoids the overhead of a json.Marshal/Unmarshal roundtrip.
	var normalized any
	if frontmatter == nil {
		normalized = make(map[string]any)
	} else {
		normalized = normalizeForJSONSchema(frontmatter)
	}

	// Validate the normalized frontmatter
	if err := schema.Validate(normalized); err != nil {
		schemaCompilerLog.Printf("Schema validation failed for %s: %v", context, err)
		return err
	}

	schemaCompilerLog.Printf("Schema validation passed for context: %s", context)
	return nil
}

// pathPositionPrefixPattern matches the "'path' (line N, col M): " prefix that
// formatSchemaFailureDetail prepends to each detail line for multi-failure output.