fn_registry/functions/infra/vault_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
vault_diff	function	go	infra	1.0.0	pure	func VaultDiff(prev, curr []VaultFile) VaultDiffReport	Computes the diff between two vault snapshots (slices of VaultFile). Returns Added, Removed, Changed and Unchanged counts. Pure and deterministic — no I/O.	vault diff comparison pure		vault_file_go_infra		false		sort	true	TestVaultDiff_NoChanges TestVaultDiff_AllAdded TestVaultDiff_AllRemoved TestVaultDiff_ContentChanged TestVaultDiff_Mixed	functions/infra/vault_diff_test.go	functions/infra/vault_diff.go	name desc prev Snapshot anterior — slice de VaultFile del estado previo del vault (puede ser nil para diff desde cero). name desc curr Snapshot actual — slice de VaultFile del estado corriente del vault (puede ser nil para diff de borrado total).	VaultDiffReport con Added (nuevos), Removed (eliminados), Changed (mismo rel_path, sha256 distinto) y Unchanged (identicos). Todos los slices ordenados por RelPath ASC.

Ejemplo

prev, _ := infra.VaultInventoryScan(oldPath, "my_vault_proj", "my_vault")
curr, _ := infra.VaultInventoryScan(newPath, "my_vault_proj", "my_vault")
report := infra.VaultDiff(prev, curr)
fmt.Printf("Added: %d, Removed: %d, Changed: %d, Unchanged: %d\n",
    len(report.Added), len(report.Removed), len(report.Changed), report.Unchanged)

Notas

• Usa RelPath como clave de identidad de archivo (no nombre, no sha256).
• Dos archivos con mismo RelPath pero diferente Sha256 se consideran Changed.
• Los slices del report se ordenan por RelPath ASC para salida deterministica.
• Función pura: no toca disco ni BD.