[V-GUARD] Add finalization_hasher.py for TOCTOU defense

Signed-off-by: vocoder-na <[email protected]>

Author: vocoder-na

tools/finalization_hasher.py

@@ -0,0 +1,48 @@
+import hashlib
+import os
+import sys
+
+# Алгоритм хешування
+HASH_ALGORITHM = "sha256"
+
+def calculate_simple_hash(file_content):
+    """
+    Обчислює простий хеш для забезпечення цілісності файлів.
+    """
+    return hashlib.new(HASH_ALGORITHM, file_content.encode('utf-8')).hexdigest()
+
+def main():
+    """
+    Обчислює єдиний Фіналізаційний Хеш для всіх файлів KERNEL.
+    Цей хеш використовується для перевірки, що код не змінювався 
+    між моментом перевірки V-Криптографом та моментом об'єднання.
+    """
+    all_hashes = []
+    
+    # Скануємо всі файли проекту
+    for root, _, files in os.walk("."):
+        # Ігноруємо .git та .github/workflows, оскільки вони керують процесом, 
+        # а не є продуктивним кодом, який треба захищати від TOCTOU
+        if '.git' in root or '.github/workflows' in root:
+            continue
+            
+        for file_name in files:
+            # Обробляємо лише файли Python та YML
+            if file_name.endswith((".py", ".yml", ".md")): 
+                file_path = os.path.join(root, file_name)
+                
+                with open(file_path, 'r', encoding='utf-8') as f:
+                    content = f.read()
+                
+                file_hash = calculate_simple_hash(content)
+                all_hashes.append(f"{file_path}:{file_hash}")
+
+    # Фінальний Merkle-хеш
+    final_data = "\n".join(sorted(all_hashes)).encode('utf-8')
+    final_hash = hashlib.new(HASH_ALGORITHM, final_data).hexdigest()
+
+    # Виводимо фінальний хеш для використання у GitHub Actions
+    print(final_hash)
+    
+if __name__ == "__main__":
+    main()