devflow-cli 8.1.0__tar.gz → 8.3.0__tar.gz

devflow_cli-8.3.0/.specify/specs/040-kks-429-delegation-structured-output/.gitignore

@@ -0,0 +1,2 @@
+# Traces brutes d'agent : elles peuvent contenir le contenu des fichiers lus.
+*.raw.txt

devflow_cli-8.3.0/.specify/specs/040-kks-429-delegation-structured-output/activity-contract.json

@@ -0,0 +1,168 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-429:standard:rollback-check:v4",
+  "issueId": "KKS-429",
+  "profile": "standard",
+  "guardrails": true,
+  "activity": "rollback-check",
+  "objective": "Consigne de délégation dans les contrats, reprise de session en lecture seule quand la sortie structurée manque, diagnostic dédié et réconciliation guidée",
+  "featurePath": ".specify/specs/040-kks-429-delegation-structured-output",
+  "inputs": [
+    ".specify/specs/040-kks-429-delegation-structured-output/need.md",
+    ".specify/specs/040-kks-429-delegation-structured-output/assessment.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/workflow-state.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/risk-assessment.md",
+    ".specify/specs/040-kks-429-delegation-structured-output/prepare-result.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/implement-result.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/evidence/targeted-tests.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/evidence/regression-check.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/evidence/diff-inspection.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/evidence/security-or-data-check.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/review-result.json"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/040-kks-429-delegation-structured-output/need.md ; en cas d'ecart avec objective, il fait foi.",
+    "Preserver les changements utilisateur sans rapport avec cette activite.",
+    "Ne pas modifier state.json, workflow-state.json ou assessment.json.",
+    "Ne pas creer de commit et ne pas changer de branche.",
+    "Signaler tout blocage au lieu de contourner une validation.",
+    "Dans checks, status vaut passed si et seulement si exitCode vaut 0. Une commande dont l'absence de resultat constitue le succes attendu doit etre declaree failed, ou remplacee par une commande qui renvoie 0 en cas de succes.",
+    "Donner un id stable a chaque objectif de check. Si un check echoue puis est corrige et relance pour le meme objectif, reutiliser cet id : seule la derniere tentative fait foi ; signaler dans remainingRisks toute instabilite encore pertinente.",
+    "Ne modifier aucun fichier pendant le controle de rollback.",
+    "Verifier une procedure de restauration actionnable, les donnees affectees, les validations post-rollback et les declencheurs.",
+    "Retourner blocked si un effet irreversible ou une inconnue critique empeche un retour arriere fiable.",
+    "Ne produire rollback-plan=passed que si le plan est applicable et verifiable."
+  ],
+  "completionCriteria": [
+    "Le plan de rollback precise les etapes, responsables, donnees et controles.",
+    "Les declencheurs et limites du rollback sont explicites.",
+    "La preuve rollback-plan contient un rapport exploitable."
+  ],
+  "requiredEvidence": [
+    "rollback-plan"
+  ],
+  "expectedOutput": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://devflow.dev/schemas/activity-result/v1",
+    "title": "Devflow Activity Result v1",
+    "type": "object",
+    "required": [
+      "schemaVersion",
+      "contractId",
+      "status",
+      "summary",
+      "changedFiles",
+      "checks",
+      "evidence",
+      "remainingRisks",
+      "blockers"
+    ],
+    "properties": {
+      "schemaVersion": {
+        "type": "integer",
+        "const": 1
+      },
+      "contractId": {
+        "type": "string",
+        "minLength": 1
+      },
+      "status": {
+        "type": "string",
+        "enum": [
+          "completed",
+          "blocked"
+        ]
+      },
+      "summary": {
+        "type": "string",
+        "minLength": 1
+      },
+      "changedFiles": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "checks": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "command",
+            "exitCode",
+            "status"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "command": {
+              "type": "string",
+              "minLength": 1
+            },
+            "exitCode": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "evidence": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "id",
+            "outcome",
+            "report"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "outcome": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            },
+            "report": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "remainingRisks": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "blockers": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "additionalProperties": false
+  }
+}

devflow_cli-8.3.0/.specify/specs/040-kks-429-delegation-structured-output/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "27be8804-4311-4159-b216-873002557228",
+  "agent": "claude",
+  "activity": "rollback-check",
+  "returnCode": 0,
+  "durationSeconds": 84.381,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 8747,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": false,
+  "worktreeChangedFileCount": 0
+}

devflow_cli-8.3.0/.specify/specs/040-kks-429-delegation-structured-output/assessment.json

@@ -0,0 +1,45 @@
+{
+  "schemaVersion": 4,
+  "issueId": "KKS-429",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "high",
+  "signals": {
+    "scope": "multiple",
+    "ambiguity": "low",
+    "risk": "medium",
+    "contractChange": false,
+    "dataOrSecurity": true
+  },
+  "guardrails": {
+    "active": true,
+    "reasons": [
+      "le changement touche aux donnees ou a la securite"
+    ]
+  },
+  "reasons": [
+    "plusieurs composants sont affectes",
+    "le risque d'impact est modere"
+  ],
+  "activities": [
+    "assess",
+    "risk-assessment",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "review",
+    "rollback-check",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection",
+    "security-or-data-check",
+    "independent-review",
+    "rollback-plan"
+  ],
+  "assessedAt": "2026-10-10T13:09:48Z",
+  "summary": "Consigne de délégation dans les contrats, reprise de session en lecture seule quand la sortie structurée manque, diagnostic dédié et réconciliation guidée"
+}

devflow_cli-8.3.0/.specify/specs/040-kks-429-delegation-structured-output/attempts/reopen-001/activity-contract.json

@@ -0,0 +1,222 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-429:standard:prepare:v4",
+  "issueId": "KKS-429",
+  "profile": "standard",
+  "guardrails": true,
+  "activity": "prepare",
+  "objective": "Consigne de délégation dans les contrats, reprise de session en lecture seule quand la sortie structurée manque, diagnostic dédié et réconciliation guidée",
+  "featurePath": ".specify/specs/040-kks-429-delegation-structured-output",
+  "inputs": [
+    ".specify/specs/040-kks-429-delegation-structured-output/need.md",
+    ".specify/specs/040-kks-429-delegation-structured-output/assessment.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/workflow-state.json",
+    ".specify/specs/040-kks-429-delegation-structured-output/risk-assessment.md"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/040-kks-429-delegation-structured-output/need.md ; en cas d'ecart avec objective, il fait foi.",
+    "Preserver les changements utilisateur sans rapport avec cette activite.",
+    "Ne pas modifier state.json, workflow-state.json ou assessment.json.",
+    "Ne pas creer de commit et ne pas changer de branche.",
+    "Signaler tout blocage au lieu de contourner une validation.",
+    "Dans checks, status vaut passed si et seulement si exitCode vaut 0. Une commande dont l'absence de resultat constitue le succes attendu doit etre declaree failed, ou remplacee par une commande qui renvoie 0 en cas de succes.",
+    "Donner un id stable a chaque objectif de check. Si un check echoue puis est corrige et relance pour le meme objectif, reutiliser cet id : seule la derniere tentative fait foi ; signaler dans remainingRisks toute instabilite encore pertinente.",
+    "Ne modifier aucun fichier du depot pendant la preparation.",
+    "Identifier les composants concernes et une strategie de validation.",
+    "Ne pas inventer de precision fonctionnelle manquante.",
+    "Dans validationPlan, workingDirectory est toujours relatif a la racine du depot : utiliser '.' pour la racine ou par exemple 'app', jamais un chemin absolu.",
+    "Les commandes de validation sont des listes d'arguments sans shell implicite : ne pas utiliser sh, bash, zsh, cmd ou powershell.",
+    "Pour npm, pnpm, yarn ou bun, utiliser uniquement test, un script dont le nom commence par test, check, lint, verify ou build, ou le controle non mutatif format:check; ne jamais lancer un script format qui ecrit les fichiers.",
+    "rg est autorise pour les inspections en lecture seule, sans option --pre.",
+    "Executables de validation autorises par defaut : bun, cargo, devflow, dotnet, eslint, git, go, gradle, gradlew, make, mvn, mvnw, mypy, nginx, nox, npm, pnpm, pyright, pytest, rg, ruff, tox, tsc, uv, yarn; python est limite a -m compileall, pytest ou unittest.",
+    "uv run accepte avant l'outil uniquement les options --all-extras, --all-groups, --extra, --frozen, --group, --isolated, --locked, --no-dev, --no-project, --no-sync, --offline, --python, --quiet, -p, -q, en forme separee (--python 3.12, pas --python=3.12); --python/-p exige un numero de version, jamais un chemin d'interpreteur; toute autre option de uv run est refusee.",
+    "Maven et Gradle acceptent uniquement les taches test, check, lint, verify ou build; mvn clean verify est refuse (clean est hors politique). Le fichier de projet Maven (-f/--file) et le repertoire de projet Gradle (-p/--project-dir) acceptent un chemin relatif au depot, sans '..', en forme separee (mvn -B -f api/pom.xml verify).",
+    "Aucun shell implicite ni operateur |, &&, ; ou redirection; aucune expression non resolue de type double accolade dans une commande.",
+    "Un executable hors liste, dont docker, requiert une approbation explicite pour la validation exacte avant son execution : renseigner approvalReason dans validationPlan, puis faire approuver son identifiant par le superviseur.",
+    "Pour un fichier cree par l'activite, ne pas utiliser git ls-files --error-unmatch : un fichier non indexe serait refuse a tort. Verifier sa presence dans le systeme de fichiers, par exemple avec rg --files -g CHEMIN, sans indexer ni committer les changements.",
+    "Les garde-fous sont actifs : inclure dans validationPlan au moins une validation bloquante explicitement consacree a la securite, aux donnees, a l'authentification, a une migration ou au rollback, dont id ou purpose contient l'un de ces termes."
+  ],
+  "completionCriteria": [
+    "Le perimetre et les fichiers probablement concernes sont identifies.",
+    "L'approche d'implementation et les validations sont resumees.",
+    "Les risques ou blocages restants sont explicites."
+  ],
+  "requiredEvidence": [],
+  "expectedOutput": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://devflow.dev/schemas/activity-result/v1",
+    "title": "Devflow Activity Result v1",
+    "type": "object",
+    "required": [
+      "schemaVersion",
+      "contractId",
+      "status",
+      "summary",
+      "changedFiles",
+      "checks",
+      "evidence",
+      "remainingRisks",
+      "blockers",
+      "validationPlan"
+    ],
+    "properties": {
+      "schemaVersion": {
+        "type": "integer",
+        "const": 1
+      },
+      "contractId": {
+        "type": "string",
+        "minLength": 1
+      },
+      "status": {
+        "type": "string",
+        "enum": [
+          "completed",
+          "blocked"
+        ]
+      },
+      "summary": {
+        "type": "string",
+        "minLength": 1
+      },
+      "changedFiles": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "checks": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "command",
+            "exitCode",
+            "status"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "command": {
+              "type": "string",
+              "minLength": 1
+            },
+            "exitCode": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "evidence": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "id",
+            "outcome",
+            "report"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "outcome": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            },
+            "report": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "remainingRisks": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "blockers": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "validationPlan": {
+        "type": "array",
+        "minItems": 1,
+        "maxItems": 10,
+        "items": {
+          "type": "object",
+          "required": [
+            "id",
+            "command",
+            "purpose",
+            "blocking",
+            "timeoutSeconds",
+            "workingDirectory"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "command": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "purpose": {
+              "type": "string",
+              "minLength": 1
+            },
+            "blocking": {
+              "type": "boolean"
+            },
+            "timeoutSeconds": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 3600
+            },
+            "workingDirectory": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Repertoire relatif a la racine du depot. Utiliser '.' pour la racine ou 'app'. Les chemins absolus et '..' sont interdits."
+            },
+            "approvalReason": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    "additionalProperties": false
+  }
+}

devflow_cli-8.3.0/.specify/specs/040-kks-429-delegation-structured-output/attempts/reopen-001/prepare-result.json

@@ -0,0 +1,175 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-429:standard:prepare:v4",
+  "status": "completed",
+  "summary": "Préparation KKS-429 (aucun fichier modifié, aucun sous-agent, aucun appel réel à un agent). Base de référence verte en 8.1.0 : 2091 tests, docs-sync, verrou uv.\n\nCONSTATS QUI CORRIGENT need.md\n- L'identifiant de session Claude n'est PAS lu aujourd'hui : `ClaudeCodeAdapter` hérite de `_session_id` (regex sur la sortie brute) qui ne reconnaît pas `\"session_id\":\"…\"` de l'enveloppe JSON. `agent-execution.json` du parcours courant porte `sessionId: null` ; dans la télémétrie, 260 enregistrements Claude sur 263 ont `sessionId` nul. La reprise exige donc de lire `envelope[\"session_id\"]`.\n- Traces conservées de KKS-403 et KKS-508 (lecture de la structure seule) : même forme dans les deux cas — `subtype: success`, `is_error: false`, `terminal_reason: completed`, `structured_output` absent, prose dans `result`, `subagent_stats.spawned: 2` et `started_in_background: 2`. KKS-508 a `requested.background: 2` : la délégation n'y était pas au premier plan, contrairement à ce qu'écrit need.md. Le cas KKS-403 (9 tours) est donc couvert par la même condition de reprise.\n- Aide de `claude` 2.1.284 : `--resume <session-id>`, `--permission-mode plan`, `--output-format json`, `--json-schema` existent et se combinent avec `--print` ; `--fork-session` existe et ne doit pas être utilisé (même session).\n\nPÉRIMÈTRE ET FICHIERS\n- `src/devflow_cli/core/activity_contracts.py` : consigne S1 ajoutée à `common_constraints` (portée par tous les contrats et les trois adaptateurs, le prompt étant commun via `render_contract_prompt`).\n- `src/devflow_cli/adapters/agents.py` : lecture de la session Claude, reprise unique, cumul de l'usage, diagnostics.\n- `src/devflow_cli/core/adaptive_runner.py` : motif de refus dédié, champs en mémoire sur `AgentActivityExecution`, ajout du motif à l'ensemble de `_recover_attempt_payload`.\n- `src/devflow_cli/core/operational.py` : motif ajouté à `AGENT_FAILURE_REASONS` (code de sortie inchangé).\n- `src/devflow_cli/commands/adaptive.py` : sonde de l'arbre passée à l'adaptateur, modèle prérempli, reprise guidée texte et `--json`, nettoyage du modèle.\n- Tests : `tests/test_activity_contracts.py`, `tests/test_agent_adapters.py`, `tests/test_adaptive_runner.py`, `tests/test_cmd_adaptive.py`.\n- Documentation et livraison : `docs/activity-contracts.md` (paragraphe « enveloppe Claude réussie », l.298), `docs/cli-reference.md` (section reconcile, l.36-76), `README.md` (l.60-72), `CHANGELOG.md`, `docs/releases/8.2.0.md`, `pyproject.toml`, `src/devflow_cli/__init__.py`, `uv.lock`.\n\nDÉCISIONS DE PRÉPARATION (points laissés par need.md et par l'évaluation des risques)\n1. Consigne S1 (texte sans accent, comme les autres) : « Si tu delegues a des sous-agents : les lancer au premier plan, attendre qu'ils soient tous termines, puis rendre la sortie structuree du contrat en tout dernier message, sans aucun texte apres. »\n2. Session : `ClaudeCodeAdapter.session_id` lit `envelope[\"session_id\"]` et ne l'accepte que s'il correspond à un UUID strict (`[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}`) ; sinon `None`, sans repli sur la regex de base (une prose pourrait la tromper). Effet de bord voulu : `sessionId` cesse d'être nul pour Claude (même champ, même type).\n3. Commande de reprise, liste d'arguments sans shell : `claude --print --resume SESSION --permission-mode plan --output-format json --json-schema SCHEMA TEXTE`, même schéma (`_claude_compatible_schema`), même répertoire, `stdin=DEVNULL`, `env=environment_without_linear_key()`. TEXTE est une constante, sans contenu issu de l'agent : « Ton dernier message n'etait pas la sortie structuree du contrat. Ne modifie aucun fichier et ne lance aucun sous-agent. Rends maintenant uniquement l'objet JSON conforme a expectedOutput decrivant le travail deja effectue. »\n4. Condition fermée, une seule fois : code de retour 0, enveloppe objet avec `subtype == \"success\"` et `is_error` différent de `true`, session valide, et échec d'extraction ou de schéma au premier appel. Jamais après code non nul, délai dépassé, exécutable introuvable, enveloppe non `success`.\n5. Délai de la reprise : `min(300, délai de l'activité − durée du premier appel)` ; reliquat inférieur à 1 s → pas de reprise. Un délai dépassé pendant la reprise rend le diagnostic dédié, pas un `timeout agent`.\n6. Lecture seule (R1, R2) : `execute_structured` reçoit un paramètre optionnel `worktree_probe` (fourni par l'exécuteur, fondé sur `snapshot_worktree(project_root, feature_dir)`), appelé juste avant et juste après la reprise dans l'adaptateur Claude. Toute différence rejette la reprise (diagnostic `resume-mutated-worktree`) ; l'écriture reste comptée dans l'image d'après et dans la fiche de tentative. `--permission-mode plan` est demandé mais ce contrôle fait foi. La reprise se déroule dans `execute_structured`, donc sous le marqueur `.agent-run.lock` et la copie `RuntimeBackup`.\n7. Trace brute (R6) : aucune seconde enveloppe sur disque. Reprise réussie → la trace est le résultat validé, comme aujourd'hui. Reprise en échec → la trace reste la première enveloppe, lisible par `recover_structured_payload` et cohérente avec `rawOutputSha256`. Aucun nouveau fichier d'exécution.\n8. Formats persistants (R7) : aucun champ ajouté. La reprise est tracée par de nouvelles valeurs du champ texte existant `finalOutputDiagnostic` (`agent-execution.json`, télémétrie, worklog) : `validated-after-resume`, `resume-session-missing`, `resume-timeout`, `resume-process-failed`, `resume-output-invalid`, `resume-mutated-worktree`. Coût, jetons et tours de la reprise additionnés dans `usage`, durée cumulée dans `durationSeconds`, `subagents` gardé du premier appel. Fiche de tentative inchangée (schéma 2, `reason` texte libre). Conséquence : livraison 8.2.0, mineure.\n9. Diagnostic dédié (S3) : nouveau motif de `adaptive run` `structured-output-missing`, rendu à la place de `agent-failed` / `agent-failed-after-mutation` quand le processus de l'agent a rendu 0 et que la sortie structurée manque ou est refusée par le schéma (Claude après reprise échouée ou impossible ; Codex et Cursor directement, leurs diagnostics d'adaptateur `final-output-*` restant inchangés). Message fixe sans prose de l'agent, avec « N sous-agent(s) » seulement si `subagent_stats.spawned` est un entier. Contrôlé après `runtime-file-mutated` et `inputs-changed-during-activity`, qui gardent la priorité.\n10. Modèle prérempli : `$DEVFLOW_HOME` ou `~/.devflow`, sous `reconcile-templates/ISSUE-ACTIVITE-result.json`, dossier `0700`, fichier `0600`, écrit par `commands/adaptive.py` quand le motif est `structured-output-missing` et l'activité dans `MANUAL_RECONCILIATION_ACTIVITIES`. Contenu : `schemaVersion: 1`, `contractId` courant, `status: \"completed\"`, `summary: \"\"`, `changedFiles` = fichiers observés depuis la base (`observedFiles` de la fiche de tentative), listes vides, `validationPlan: []` si le schéma du contrat l'exige. `summary` vide est refusé par le schéma (`minLength: 1`) : un modèle non complété ne passe pas. Écrasé à chaque nouvel échec, supprimé quand l'activité avance (`run` ou `reconcile`) et à `discard-attempt`. Pour les autres activités : pas de modèle, relance proposée.\n11. Reprise guidée : texte = cause, puis `devflow adaptive reconcile ID --result CHEMIN --reason MOTIF` avec le chemin passé par `shlex.quote`. `--json` = clé `recovery` (déjà optionnelle dans `_print_execution_json`, utilisée par `verify`) avec `kind`, `summary`, `subagents`, `resume`, `template`, `commands` ; champs existants inchangés.\n\nVALIDATION\nTests par enveloppes simulées (`patch(\"subprocess.run\")`, modèle existant de `tests/test_agent_adapters.py`), dépôts git temporaires hors dépôt, puis suite complète, docs-sync et concordance de version. Détail dans validationPlan.",
+  "changedFiles": [],
+  "checks": [
+    {
+      "id": "baseline-targeted-tests",
+      "command": "uv run --frozen pytest -q -p no:cacheprovider tests/test_agent_adapters.py tests/test_activity_contracts.py tests/test_adaptive_runner.py tests/test_cmd_adaptive.py tests/test_telemetry.py tests/test_worklog.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "baseline-full-suite",
+      "command": "uv run --frozen pytest -q -p no:cacheprovider",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "baseline-docs-sync",
+      "command": "uv run --frozen devflow docs-sync --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "baseline-uv-lock",
+      "command": "uv lock --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "baseline-version-tests",
+      "command": "uv run --locked pytest -q -p no:cacheprovider tests/test_version.py tests/test_release.py",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "Non vérifiable sans appel réel : le comportement de `claude --print --resume` avec `--permission-mode plan` et `--json-schema` sur une session terminée ayant délégué. La preuve repose sur des enveloppes simulées, puis sur le premier parcours en 8.2.0 où une sortie structurée manquera.",
+    "Le mode `plan` en `--print` injecte un déroulé de planification (fichier de plan, sortie par ExitPlanMode) qui peut détourner la session reprise de la seule sortie structurée ; constaté pendant cette activité `prepare`, lancée en `plan`. Si la reprise échoue pour cette raison, le second temps (S3) s'applique.",
+    "Le mode `plan` n'est pas tenu pour une garantie de lecture seule (règles d'autorisation de l'utilisateur, outils MCP, sous-agents relancés). Le contrôle qui fait foi est la sonde de l'arbre avant et après la reprise ; elle ne voit pas une écriture hors dépôt.",
+    "Décision 8 à confirmer en revue : tracer la reprise par de nouvelles valeurs de `finalOutputDiagnostic` plutôt que par un champ nouveau évite un changement de format (article III) et garde la 8.2.0 mineure. Si un champ dédié est exigé, la télémétrie et `agent-execution.json` changent de version, l'historique de télémétrie en schéma 1 n'est plus lu et la livraison devient majeure.",
+    "`sessionId` passe de nul à l'UUID de session pour Claude dans `agent-execution.json`, la télémétrie et le worklog : même champ et même type, mais valeur nouvelle pour les lecteurs.",
+    "Le motif `structured-output-missing` remplace `agent-failed` / `agent-failed-after-mutation` pour Codex et Cursor quand le processus rend 0 sans sortie conforme : c'est le diagnostic dédié de S3, mais un script qui filtre sur l'ancien motif doit être adapté. Code de sortie inchangé.",
+    "Cas non couvert : une enveloppe qui contiendrait un `structured_output` rendu trop tôt, suivi de travail, serait acceptée comme aujourd'hui sans reprise. Non observé dans les traces de KKS-403 et KKS-508 ; à documenter dans les notes de version.",
+    "La consigne S1 peut être ignorée par l'agent (précédent KKS-508) ; la reprise ajoute alors son coût à l'activité, plafonnée à 300 s.",
+    "Le modèle prérempli garantit seulement la conformité au schéma une fois `summary` renseigné ; les validateurs du parcours peuvent encore refuser le résultat complété (preuves requises, `validationPlan` de `prepare`).",
+    "Écart factuel avec need.md à porter à la connaissance du superviseur : la session Claude n'est pas lue aujourd'hui, et la trace de KKS-508 indique une délégation en arrière-plan."
+  ],
+  "blockers": [],
+  "validationPlan": [
+    {
+      "id": "PREP-contract-delegation",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_activity_contracts.py"
+      ],
+      "purpose": "Consigne S1 présente dans le contrat de chaque activité agent et de chaque profil",
+      "blocking": true,
+      "timeoutSeconds": 300,
+      "workingDirectory": "."
+    },
+    {
+      "id": "PREP-claude-resume-adapter",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_agent_adapters.py"
+      ],
+      "purpose": "Adaptateur Claude sur enveloppes simulées : sortie valide sans reprise, prose puis reprise unique, échecs de reprise, aucune reprise après code non nul ou délai dépassé, session absente ou invalide, commande de reprise, usage cumulé ; Codex et Cursor inchangés",
+      "blocking": true,
+      "timeoutSeconds": 300,
+      "workingDirectory": "."
+    },
+    {
+      "id": "PREP-security-resume-integrity",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_adaptive_runner.py",
+        "tests/test_cmd_adaptive.py"
+      ],
+      "purpose": "Sécurité et intégrité des données de la gate : reprise qui modifie un fichier refusée, résultat de reprise soumis aux validateurs avec source agent, motif structured-output-missing, modèle prérempli hors dépôt en 0600 et refusé tant qu'il n'est pas complété, reprise guidée texte et --json",
+      "blocking": true,
+      "timeoutSeconds": 900,
+      "workingDirectory": "."
+    },
+    {
+      "id": "PREP-regression-suite",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "purpose": "Non-régression de la suite complète",
+      "blocking": true,
+      "timeoutSeconds": 1200,
+      "workingDirectory": "."
+    },
+    {
+      "id": "PREP-docs-sync",
+      "command": [
+        "uv",
+        "run",
+        "devflow",
+        "docs-sync",
+        "--check"
+      ],
+      "purpose": "Documentation générée synchronisée avec le code",
+      "blocking": true,
+      "timeoutSeconds": 300,
+      "workingDirectory": "."
+    },
+    {
+      "id": "PREP-version-lock",
+      "command": [
+        "uv",
+        "run",
+        "--locked",
+        "pytest",
+        "-q",
+        "tests/test_version.py",
+        "tests/test_release.py"
+      ],
+      "purpose": "Concordance de la version 8.2.0 entre pyproject.toml, le paquet et uv.lock",
+      "blocking": true,
+      "timeoutSeconds": 300,
+      "workingDirectory": "."
+    },
+    {
+      "id": "PREP-release-notes",
+      "command": [
+        "rg",
+        "-n",
+        "8\\.2\\.0",
+        "CHANGELOG.md",
+        "docs/releases/8.2.0.md"
+      ],
+      "purpose": "Notes de version 8.2.0 présentes, avec la procédure de rollback vers la 8.1.0",
+      "blocking": true,
+      "timeoutSeconds": 60,
+      "workingDirectory": "."
+    },
+    {
+      "id": "PREP-docs-diagnostic",
+      "command": [
+        "rg",
+        "-n",
+        "structured-output-missing",
+        "docs/activity-contracts.md",
+        "docs/cli-reference.md"
+      ],
+      "purpose": "Diagnostic dédié et reprise décrits dans la documentation de référence",
+      "blocking": false,
+      "timeoutSeconds": 60,
+      "workingDirectory": "."
+    }
+  ],
+  "observation": {
+    "baseRecordedAt": "2026-10-10T13:12:15Z",
+    "baseHead": "39412b55f3800081585f3027317e2c125740a681",
+    "observedAt": "2026-10-10T13:21:28Z",
+    "head": "39412b55f3800081585f3027317e2c125740a681"
+  }
+}