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

devflow_cli-8.4.1/.specify/specs/042-kks-531-amended-need-artifact-recovery/.gitignore

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

devflow_cli-8.4.1/.specify/specs/042-kks-531-amended-need-artifact-recovery/activity-contract.json

@@ -0,0 +1,169 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-531:standard:rollback-check:v4",
+  "issueId": "KKS-531",
+  "profile": "standard",
+  "guardrails": true,
+  "activity": "rollback-check",
+  "objective": "Un fichier d entrée du besoin (need.md, issue-*.md) amendé par le superviseur avant le lancement d une activité documentaire n est plus imputé à l agent ; avertissement qui nomme les activités déjà closes ; reprise dédiée du refus artifact-files-mismatch par cause observée ; test de bout en bout de l arbitrage après un blocage d implement. Décisions dans need.md.",
+  "featurePath": ".specify/specs/042-kks-531-amended-need-artifact-recovery",
+  "inputs": [
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/need.md",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/assessment.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/workflow-state.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/risk-assessment.md",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/prepare-result.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/implement-result.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/evidence/targeted-tests.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/evidence/regression-check.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/evidence/diff-inspection.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/evidence/security-or-data-check.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/review-result.json"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/042-kks-531-amended-need-artifact-recovery/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.",
+    "Si des sous-agents sont utilises, les lancer au premier plan, jamais en arriere-plan, et attendre qu'ils soient tous termines avant la sortie structuree. La sortie structuree du contrat est le dernier message de l'agent : ne rien envoyer apres elle.",
+    "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.4.1/.specify/specs/042-kks-531-amended-need-artifact-recovery/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "43b80b84-0d59-49f7-9e67-403ff25a3cd1",
+  "agent": "claude",
+  "activity": "rollback-check",
+  "returnCode": 0,
+  "durationSeconds": 102.413,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 9875,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": false,
+  "worktreeChangedFileCount": 0
+}

devflow_cli-8.4.1/.specify/specs/042-kks-531-amended-need-artifact-recovery/assessment.json

@@ -0,0 +1,45 @@
+{
+  "schemaVersion": 4,
+  "issueId": "KKS-531",
+  "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-11T21:09:26Z",
+  "summary": "Un fichier d entrée du besoin (need.md, issue-*.md) amendé par le superviseur avant le lancement d une activité documentaire n est plus imputé à l agent ; avertissement qui nomme les activités déjà closes ; reprise dédiée du refus artifact-files-mismatch par cause observée ; test de bout en bout de l arbitrage après un blocage d implement. Décisions dans need.md."
+}

devflow_cli-8.4.1/.specify/specs/042-kks-531-amended-need-artifact-recovery/attempts/reopen-001/activity-contract.json

@@ -0,0 +1,223 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-531:standard:prepare:v4",
+  "issueId": "KKS-531",
+  "profile": "standard",
+  "guardrails": true,
+  "activity": "prepare",
+  "objective": "Un fichier d entrée du besoin (need.md, issue-*.md) amendé par le superviseur avant le lancement d une activité documentaire n est plus imputé à l agent ; avertissement qui nomme les activités déjà closes ; reprise dédiée du refus artifact-files-mismatch par cause observée ; test de bout en bout de l arbitrage après un blocage d implement. Décisions dans need.md.",
+  "featurePath": ".specify/specs/042-kks-531-amended-need-artifact-recovery",
+  "inputs": [
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/need.md",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/assessment.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/workflow-state.json",
+    ".specify/specs/042-kks-531-amended-need-artifact-recovery/risk-assessment.md"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/042-kks-531-amended-need-artifact-recovery/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.",
+    "Si des sous-agents sont utilises, les lancer au premier plan, jamais en arriere-plan, et attendre qu'ils soient tous termines avant la sortie structuree. La sortie structuree du contrat est le dernier message de l'agent : ne rien envoyer apres elle.",
+    "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.4.1/.specify/specs/042-kks-531-amended-need-artifact-recovery/attempts/reopen-001/prepare-result.json

@@ -0,0 +1,189 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-531:standard:prepare:v4",
+  "status": "completed",
+  "summary": "Préparation faite en lecture seule sur le code 8.3.0 (HEAD 67ef709). Aucun format persistant ne doit changer : la livraison reste une 8.4.0. Trois points dépassent ce que need.md et risk-assessment.md décrivent et sont à valider par le superviseur avant implement (voir remainingRisks) : la règle R1, la tolérance de reconcile pour un fichier retiré, et l'absence de ./tests/run-tests.sh dans le plan.\n\nPÉRIMÈTRE — fichiers probablement concernés\n- src/devflow_cli/core/adaptive_runner.py : run_current_activity, reconcile_current_activity, _apply_activity_result, _record_failed_attempt ; _input_fingerprints reste la seule source de la liste des entrées.\n- src/devflow_cli/core/activity_base.py : recorded_observation (avertissement dans la clé warning existante).\n- src/devflow_cli/core/remediation.py : liste des activités rouvrables, aux conditions de reopen_activity (assess et done exclus).\n- src/devflow_cli/commands/adaptive.py : reprise dédiée dans run_adaptive, reconcile_adaptive et _print_run_recovery, sur le modèle de _stale_preflight_recovery.\n- Tests : tests/test_adaptive_runner.py et tests/test_cmd_adaptive.py, nouveaux tests préfixés test_kks531_ (le plan de validation les sélectionne par -k kks531).\n- Documentation et version : docs/cli-reference.md, docs/activity-contracts.md, docs/pipeline.md, README.md, CHANGELOG.md, docs/releases/8.4.0.md, pyproject.toml, src/devflow_cli/__init__.py, uv.lock.\n\nCONSTATS QUI CADRENT L'IMPLÉMENTATION\n- DOCUMENT_ARTIFACTS ne contient pas prepare : en standard, N1 ne concerne que risk-assessment et preflight-evidence ; prepare ne refuse que les fichiers modifiés pendant l'agent, donc un amendement avant prepare passe déjà.\n- OBSERVATION_SCHEMA lie warning et declaredChangedFiles (dependentRequired) : un warning seul est refusé à la relecture. L'avertissement N2 tient dans la clé warning si declaredChangedFiles est écrit avec lui. Aucune clé nouvelle.\n- La fiche de tentative suffit à N3 : observedFiles et executionFiles donnent les fichiers en trop et leur classement, pour run comme pour une tentative déjà enregistrée.\n- reconcile refuse aujourd'hui comme dérive (« fichiers modifiés depuis la tentative ») un fichier retiré après la tentative : la reprise N3 « le retirer, puis reconcile » ne fonctionne pas en 8.3.0.\n- Dans run_current_activity, le retour runtime-file-mutated précède le contrôle des entrées : un agent qui modifie à la fois un fichier d'exécution et need.md laisse une fiche sans changedInputs.\n- Deux tests existants (test_plan_input_mutation_is_not_recorded_as_a_plan_artifact_in_the_attempt, test_need_change_during_plan_is_reported_separately_and_requires_a_new_run) fixent déjà le scénario R1 : après inputs-changed-during-activity, la relance sans remise en état est refusée artifact-files-mismatch. Ils doivent rester verts.\n\nAPPROCHE\nOrdre : tests de présence de chaque défaut sur le code 8.3.0, puis N4, N1, N2, N3, documentation, version.\n- N1 : _apply_activity_result reçoit les fichiers modifiés pendant l'agent (execution.observedChangedFiles en run, executionFiles de la fiche en reconcile ; le during_execution actuel de reconcile ne change pas). Une entrée est exemptée si l'activité est dans DOCUMENT_ARTIFACTS, si son nom vient de _input_fingerprints et son chemin vaut featurePath/nom, si elle figure dans les fichiers depuis la base avec une empreinte de fichier ordinaire, si elle est absente des fichiers d'exécution et absente du changedInputs de la fiche de tentative déjà présente. Le contrôle d'artefact porte sur les fichiers restants, résultat blocked compris. changedFiles enregistré reste la liste observée.\n- Cas limites : issue-*.md créé avant le lancement, exempté ; lien symbolique ou entrée illisible, compté donc refusé ; issue-*.md supprimé, compté donc refusé avec la reprise N3 ; need.md supprimé, déjà refusé avant l'agent par validate_need_statement.\n- R1 : la fiche précédente est lue sous verrou avant l'agent ; changedInputs est reporté dans la fiche suivante tant que l'entrée diffère de la base, et consigné aussi pour une tentative refusée runtime-file-mutated. Sorties : remise à l'état de base, ou discard-attempt, décision auditée du superviseur qui supprime la fiche.\n- N2 : avertissement ajouté à AdaptiveRunOutcome.warnings (texte et --json) et à observation.warning (relu par worklog.md). Il nomme chaque entrée amendée, les activités closes rouvrables et la commande reopen. Sans activité rouvrable, pas de commande. L'écart de déclaration se calcule hors entrées exemptées, sinon un agent qui déclare seulement son artefact déclencherait un avertissement trompeur. La base de l'activité suivante étant posée après l'amendement, l'avertissement ne se répète pas.\n- N3 : reprise de kind artifact-files-mismatch avec summary, liste des fichiers classés et commands, ajoutée au champ recovery sans toucher aux champs existants. Fichier présent dans executionFiles : « modifié pendant l'agent », retirer puis reconcile. Sinon : « modifié avant son lancement », remettre en état ou reopen de l'activité précédente si elle est rouvrable. Aucun nom de fichier interpolé dans une commande ; identifiant passé par shlex.quote. Pour que « retirer puis reconcile » fonctionne, reconcile accepte, pour une activité documentaire, un fichier de la fiche revenu à son état de base.\n- N4 : test CLI de bout en bout du cas KKS-469, avec un écart de date de modification explicite entre need.md et preflight-evidence.md (la péremption compare des mtime). Correction seulement si le test révèle un trou.\n- R5 : lecteurs de changedFiles relevés — automatic_evidence ne lit que le résultat d'implement, worklog l'affiche, parse_recorded_result le valide comme liste de chemins. Aucun ne suppose « exactement l'artefact ».\n\nVALIDATIONS\nTests ciblés kks531, fichiers de tests touchés, suite complète, docs-sync, concordance de version, présence des notes 8.4.0 et de leur section de retour à la 8.3.0.",
+  "changedFiles": [],
+  "checks": [
+    {
+      "id": "baseline-targeted-tests",
+      "command": "PYTHONDONTWRITEBYTECODE=1 uv run --no-sync pytest -q -p no:cacheprovider tests/test_adaptive_runner.py tests/test_cmd_adaptive.py tests/test_activity_base.py tests/test_worklog.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "repo-version",
+      "command": "uv run --no-sync devflow --version",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "worktree-unchanged",
+      "command": "git diff --quiet",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "R1, à valider avant implement : need.md ne tranche pas le cas d'une entrée modifiée par un agent puis acceptée à la relance. Règle proposée : changedInputs de la fiche précédente bloque l'exemption et se reporte de fiche en fiche tant que l'entrée diffère de la base ; discard-attempt lève le blocage comme décision auditée. Le sens de changedInputs s'élargit (entrée imputée à un agent de cette activité, non remise en état) sans clé ni version nouvelle ; une 8.3.0 relit ces fiches sans erreur.",
+    "Écart hors de l'évaluation des risques : la reprise N3 « retirer puis reconcile » est refusée en 8.3.0 par le contrôle de dérive de reconcile. La correction proposée (fichier revenu à son état de base accepté, activités documentaires seulement) assouplit ce contrôle : à faire confirmer par un test de présence du défaut, puis à contrôler en independent-review.",
+    "Fuite R1 par runtime-file-mutated : la fiche de ce refus ne porte pas changedInputs aujourd'hui. Lue dans le code, non reproduite par un test pendant la préparation.",
+    "./tests/run-tests.sh n'est pas dans le plan de validation : exécutable hors liste, il exigerait une approbation du superviseur. Les tests shell ne sont donc pas rejoués par verify.",
+    "La suite complète n'a pas été lancée pendant la préparation ; seuls 466 tests de quatre fichiers l'ont été (tous passés, 149 s). Le délai de 1800 s de la suite complète est une estimation.",
+    "Le plan sélectionne les nouveaux tests par -k kks531 : si l'implémentation ne suit pas le préfixe test_kks531_, les deux validations protégées échouent (code 5, aucun test sélectionné).",
+    "N4 peut révéler un trou sur la base d'implement ou le travail partiel (R11) : la correction élargirait le lot ; si elle touche un format persistant ou la décision D1 de KKS-508, s'arrêter et le signaler.",
+    "L'avertissement N2 partage la clé warning avec l'écart de déclaration : les deux messages sont concaténés dans une seule chaîne, declaredChangedFiles étant écrit même sans écart de déclaration.",
+    "La CLI globale qui pilote ce parcours est en 8.2.0 et porte le défaut : ne pas amender need.md sans adaptive reopen avant la 8.4.0 (R12).",
+    "Non vérifiable ici : le comportement sur les projets réels d'origine (kreview KKS-529, kbudget KKS-247, kpanel KKS-469) ; confirmation au premier parcours réel en 8.4.0."
+  ],
+  "blockers": [],
+  "validationPlan": [
+    {
+      "id": "VAL-SECURITY-GATE-KKS531",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_adaptive_runner.py",
+        "-k",
+        "kks531"
+      ],
+      "purpose": "Securite de la gate documentaire : exemption N1 limitee aux entrees du besoin non modifiees pendant l'agent, regle R1 sur changedInputs, meme regle en reconcile, refus conserves pour tout autre fichier",
+      "blocking": true,
+      "timeoutSeconds": 900,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-CLI-RECOVERY-KKS531",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_cmd_adaptive.py",
+        "-k",
+        "kks531"
+      ],
+      "purpose": "Avertissement N2 et reprise N3 en texte et en --json, absence de relance a l'identique, cas KKS-469 de bout en bout (N4)",
+      "blocking": true,
+      "timeoutSeconds": 900,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-TARGETED-FILES",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_adaptive_runner.py",
+        "tests/test_cmd_adaptive.py",
+        "tests/test_activity_base.py",
+        "tests/test_worklog.py"
+      ],
+      "purpose": "Non-regression des refus fondes sur des faits de KKS-508 et des reprises de KKS-530 dans les fichiers de tests touches",
+      "blocking": true,
+      "timeoutSeconds": 1200,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-REGRESSION-FULL",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "purpose": "Suite complete, dont la concordance de version et les schemas de contrat",
+      "blocking": true,
+      "timeoutSeconds": 1800,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-DOCS-SYNC",
+      "command": [
+        "uv",
+        "run",
+        "devflow",
+        "docs-sync",
+        "--check"
+      ],
+      "purpose": "Documentation generee synchronisee avec le code",
+      "blocking": true,
+      "timeoutSeconds": 300,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-VERSION-PYPROJECT",
+      "command": [
+        "rg",
+        "-n",
+        "^version = \"8\\.4\\.0\"$",
+        "pyproject.toml"
+      ],
+      "purpose": "Version 8.4.0 dans pyproject.toml",
+      "blocking": true,
+      "timeoutSeconds": 60,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-VERSION-PACKAGE",
+      "command": [
+        "rg",
+        "-n",
+        "^VERSION = \"8\\.4\\.0\"$",
+        "src/devflow_cli/__init__.py"
+      ],
+      "purpose": "Version 8.4.0 dans le paquet",
+      "blocking": true,
+      "timeoutSeconds": 60,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-CHANGELOG",
+      "command": [
+        "rg",
+        "-n",
+        "^## \\[8\\.4\\.0\\]",
+        "CHANGELOG.md"
+      ],
+      "purpose": "Entree 8.4.0 datee dans CHANGELOG.md",
+      "blocking": true,
+      "timeoutSeconds": 60,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-ROLLBACK-NOTES",
+      "command": [
+        "rg",
+        "-n",
+        "devflow-cli==8\\.3\\.0",
+        "docs/releases/8.4.0.md"
+      ],
+      "purpose": "Rollback : les notes 8.4.0 existent et donnent la commande de retour a la 8.3.0",
+      "blocking": true,
+      "timeoutSeconds": 60,
+      "workingDirectory": "."
+    },
+    {
+      "id": "VAL-DIFF-CHECK",
+      "command": [
+        "git",
+        "diff",
+        "--check"
+      ],
+      "purpose": "Aucune erreur d'espacement ni marqueur de conflit dans le diff",
+      "blocking": false,
+      "timeoutSeconds": 60,
+      "workingDirectory": "."
+    }
+  ],
+  "observation": {
+    "baseRecordedAt": "2026-10-11T21:12:05Z",
+    "baseHead": "67ef7096f27d8f3dcb61e473425a9a98e535ec30",
+    "observedAt": "2026-10-11T21:18:10Z",
+    "head": "67ef7096f27d8f3dcb61e473425a9a98e535ec30"
+  }
+}