verify_path

Overview

L’outil verify_path recalcule l’empreinte SHA-512 d’un fichier ou d’un chemin et la compare avec ce qui est stocké dans le ledger. Il permet de détecter une modification non autorisée ou une corruption.

La recherche se fait en deux passes :

Par sealed_path (chemin exact tel qu’il a été scellé)
Par empreinte (utile si le fichier a été déplacé)

Paramètres

path string requis

Chemin absolu vers le fichier à vérifier.

project string

Identifiant du projet (optionnel — accélère la recherche si précisé).

Exemple — Vérification réussie

Vérifie que le fichier /Users/julien/rapport.pdf n'a pas été modifié depuis son scellement

{
  "verified": true,
  "path": "/Users/julien/rapport.pdf",
  "fingerprint": "e3b0c44298fc1c149afbf4c8996fb924...",
  "ledger_id": 87,
  "project": "mon-projet",
  "category": "file",
  "sealed_at": "2026-04-10T09:15:33Z",
  "match": "by_path"
}

Exemple — Modification détectée

{
  "verified": false,
  "path": "/Users/julien/rapport.pdf",
  "computed_fingerprint": "a1b2c3d4e5f6...",
  "stored_fingerprint": "e3b0c44298fc...",
  "ledger_id": 87,
  "sealed_at": "2026-04-10T09:15:33Z",
  "reason": "fingerprint_mismatch"
}

Cas d’usage

Avant de soumettre un bundle légal, vérifier que les fichiers source n’ont pas changé
Audit de conformité : s’assurer qu’un livrable est identique à ce qui a été scellé
Diagnostiquer les entrées signalées invalid par seshat doctor