fn_registry/functions/core/golden_diff.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, tested, tests, test_file_path, file_path, params, output

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	tested	tests	test_file_path	file_path	params	output
golden_diff	function	go	core	1.0.0	pure	func GoldenDiff(actual, golden []byte, threshold float64) (matched bool, similarity float64)	Compara dos buffers byte-a-byte y retorna una puntuacion de similitud en [0,1]. similarity = matchedBytes / max(len(actual), len(golden)). matched = similarity >= (1.0 - threshold). threshold=0.0 exige match exacto; threshold=0.05 tolera hasta 5% de divergencia.	diff golden testing similarity bytes comparison				false			true	identicos retorna similarity 1 y matched true totalmente distintos retorna similarity 0 y matched false 1 byte distinto threshold 0 falla pero threshold 0.5 pasa longitudes distintas usa max como denominador	functions/core/golden_diff_test.go	functions/core/golden_diff.go	name desc actual Buffer de bytes producido por el sistema bajo prueba. name desc golden Buffer de bytes de referencia (golden file o snapshot esperado). name desc threshold Fraccion de divergencia tolerable en [0,1]. 0.0 = match exacto, 0.05 = hasta 5% diferente.	matched indica si la similitud supera el umbral. similarity es la fraccion de bytes que coinciden respecto al mayor de los dos buffers.

Ejemplo

actual := []byte("hello world")
golden := []byte("hello world")
matched, sim := GoldenDiff(actual, golden, 0.0)
// matched=true, sim=1.0

actual2 := []byte("hello wrold")  // typo
matched2, sim2 := GoldenDiff(actual2, golden, 0.05)
// sim2 = 9/11 ≈ 0.818, matched2=true (dentro del 5% de tolerancia)

Notas

Funcion pura, sin I/O. Usa comparacion posicional byte-a-byte: dos buffers del mismo contenido pero con bytes insertados/eliminados en el centro daran una similitud baja aunque el contenido sea logicamente similar. Para comparaciones de texto estructurado (JSON, YAML) considerar normalizar antes de llamar a GoldenDiff.

El denominador es max(len(actual), len(golden)), lo que penaliza diferencias de longitud ademas de diferencias de contenido.