# Dossiers de preuves

> Téléchargez un enregistrement signé de la façon dont un changement a été réalisé (tâche, modèles, approbations, constats, tests, livraison) et vérifiez-le dans le navigateur ou hors ligne.

Source: https://aicodeops.dev/fr/docs/evidence-packs

Un dossier de preuves est un enregistrement signé de la façon dont un changement a été réalisé dans AI CodeOps. Il est destiné aux auditeurs, aux revues de conformité et aux clients qui doivent montrer comment du code écrit par l'IA a atteint la production.

## Ce que contient un dossier

Pour un changement (**Develop → Changes**, puis un changement) :

- **La tâche :** le prompt donné à l'IA, le modèle, le fournisseur et le niveau, ainsi que les fichiers de contexte.
- **Les exécutions :** la session et chaque exécution de suivi, avec le statut, les durées, les tokens et le coût, ainsi que le fournisseur et le modèle de chaque étape d'agent.
- **Le résultat :** le résumé, les fichiers modifiés et une empreinte SHA-256 du diff. Le code lui-même n'est pas inclus ; l'empreinte vous permet de le rapprocher de la pull request.
- **Approbations :** chaque demande d'approbation, qui l'a demandée (pour l'approbation propre à une session, le membre qui a lancé la session), qui pouvait approuver (`eligibleApprovers` : les approbateurs qu'elle désignait et les rôles autorisés à décider), qui a effectivement approuvé ou rejeté (`approvedBy` et `rejectedBy`), et chaque vote (`votes`).
- **Chaque vote :** `votes` comporte une entrée par vote, dans l'ordre où ils ont été exprimés : le compte du votant (`accountID`), son rôle dans l'espace de travail (`role`), le vote (`approve` ou `reject`), l'heure (`decidedAt`) et la note. `roleAsOf` indique de quelle date provient le rôle : `vote` est le rôle enregistré au moment où le vote a été exprimé ; `export` est le rôle détenu au moment où le dossier a été produit, utilisé pour les votes exprimés avant que les rôles soient enregistrés, et `null` si le votant a depuis quitté l'espace de travail. `selfApproval` vaut true lorsque le votant a approuvé un changement qu'il avait lui-même lancé, et `selfApprovalAllowedBy` indique pourquoi cela était autorisé. `gateOverride` porte le motif donné par le votant, et ce que disait la vérification de livraison, lorsqu'il a approuvé un changement dont la vérification de livraison échouait. La liste brute `decisions` est toujours là, inchangée. Les deux ne contiennent que le tour en cours : lorsqu'une approbation est rouverte, par exemple après la modification d'un changement approuvé, ils sont vidés, et les votes précédents restent dans la section `audit` du dossier sous forme d'entrées `approval.decided`.
- **Décisions de politique :** chaque allow, deny ou ask que les politiques de l'espace de travail ont rendu pendant le changement.
- **Constats et tests :** les constats de la revue avec leur tri, et les résultats des tests (réussis, échoués, ignorés, couverture).
- **Livraison :** la pull request, le déploiement et tout incident lié au changement.
- **La piste d'audit :** les entrées du journal d'audit concernant tout ce qui précède.
- **Personnes :** l'adresse e-mail associée à chaque identifiant de compte du dossier.

## Télécharger un dossier

Ouvrez **Changes**, choisissez un changement et sélectionnez **Download evidence pack**. Il vous faut l'accès à l'audit dans l'espace de travail : les rôles Owner, Admin et Security Admin l'ont. Chaque téléchargement est enregistré dans le journal d'audit de l'espace de travail.

## Vérifier un dossier dans le navigateur

Ouvrez [/evidence/verify](https://aicodeops.dev/evidence/verify) et choisissez le fichier. Aucun compte n'est nécessaire. La page vous indique si la signature correspond et quelle clé l'a signé.

## Vérifier un dossier hors ligne

Vous n'êtes pas obligé de faire confiance à notre vérificateur. La `signature` du dossier est une signature Ed25519 du JSON canonique de son `payload` : clés d'objet triées à chaque niveau, sans espaces. Les clés publiques de la plateforme se trouvent à `/api/evidence?action=keys`. Avec Node.js 20 ou une version ultérieure :

```js
// verify-evidence.mjs <pack.json> <keys.json>
import { readFileSync } from "node:fs"
import { createPublicKey, verify } from "node:crypto"

const canonical = (v) =>
  v === null || typeof v !== "object"
    ? JSON.stringify(v)
    : Array.isArray(v)
      ? `[${v.map(canonical).join(",")}]`
      : `{${Object.keys(v)
          .sort()
          .map((k) => `${JSON.stringify(k)}:${canonical(v[k])}`)
          .join(",")}}`

const pack = JSON.parse(readFileSync(process.argv[2], "utf8"))
const { keys } = JSON.parse(readFileSync(process.argv[3], "utf8"))
const key = keys.find((k) => k.kid === pack.signature.kid)
if (!key) throw new Error(`unknown key ${pack.signature.kid}`)
const ok = verify(
  null,
  Buffer.from(canonical(pack.payload)),
  createPublicKey(key.publicKey),
  Buffer.from(pack.signature.value, "base64url"),
)
console.log(ok ? "VERIFIED" : "NOT VERIFIED: the pack was altered")
```

Enregistrez les clés une fois, puis exécutez le script :

```bash
curl -o keys.json "https://console.aicodeops.dev/api/evidence?action=keys"
node verify-evidence.mjs evidence-chg_....json keys.json
```

## Clés et rotation

Les clés ne sont jamais supprimées. Lorsqu'une clé est retirée, elle cesse de signer de nouveaux dossiers, et les dossiers qu'elle a signés restent vérifiables. Conservez une copie de `keys.json` avec vos archives d'audit si vous voulez une vérification qui ne dépende pas de l'accès à la plateforme.

## Étapes suivantes

- [Approbations et politiques](https://aicodeops.dev/fr/docs/approvals-and-policies)
- [Barrières qualité](https://aicodeops.dev/fr/docs/quality-gates)
- [API](https://aicodeops.dev/fr/docs/api)

## Questions fréquentes

### Le dossier contient-il notre code source ?

Non. Il liste les fichiers modifiés et une empreinte SHA-256 du diff, ce qui vous permet de le rapprocher de la pull request sans que le code quitte votre dépôt.

### Les anciens dossiers sont-ils encore vérifiables après le retrait d'une clé ?

Oui. Les clés ne sont jamais supprimées. Une clé retirée cesse de signer de nouveaux dossiers, et les dossiers qu'elle a signés restent vérifiables.
