devflow-cli 10.0.2__tar.gz → 10.1.0__tar.gz

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/.gitignore

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

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/activity-contract.json

@@ -0,0 +1,169 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-560:standard:review:v4",
+  "issueId": "KKS-560",
+  "profile": "standard",
+  "guardrails": false,
+  "activity": "review",
+  "objective": "Traiter la feature KKS-560",
+  "featurePath": ".specify/specs/050-kks-560-kpanel-frictions",
+  "inputs": [
+    ".specify/specs/050-kks-560-kpanel-frictions/need.md",
+    ".specify/specs/050-kks-560-kpanel-frictions/assessment.json",
+    ".specify/specs/050-kks-560-kpanel-frictions/workflow-state.json",
+    ".specify/specs/050-kks-560-kpanel-frictions/prepare-result.json",
+    ".specify/specs/050-kks-560-kpanel-frictions/implement-result.json",
+    ".specify/specs/050-kks-560-kpanel-frictions/evidence/targeted-tests.json",
+    ".specify/specs/050-kks-560-kpanel-frictions/evidence/regression-check.json",
+    ".specify/specs/050-kks-560-kpanel-frictions/evidence/diff-inspection.json"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/050-kks-560-kpanel-frictions/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 la review.",
+    "Examiner le besoin, le resultat de preparation, le diff et les preuves reelles.",
+    "Traiter les preuves source=devflow deja validees par verify comme les resultats d'execution de reference; controler leur contenu, leur actualite et leur adequation sans les ignorer.",
+    "Ne pas relancer une commande qui ecrit des artefacts de build dans ce sandbox en lecture seule. Une impossibilite de reecrire target, build ou dist n'est pas un blocker si la preuve Devflow correspondante est actuelle et passed.",
+    "Limiter les checks propres a la review aux inspections effectivement compatibles avec la lecture seule.",
+    "Retourner blocked avec des blockers explicites si un defaut significatif subsiste.",
+    "Ne produire la preuve de review attendue en passed que si le changement est coherent et suffisamment verifie."
+  ],
+  "completionCriteria": [
+    "La conformite de l'implementation aux exigences est examinee.",
+    "Les preuves et risques restants sont pris en compte.",
+    "La preuve de review contient un rapport exploitable."
+  ],
+  "requiredEvidence": [
+    "implementation-review"
+  ],
+  "expectedOutput": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://devflow.dev/schemas/activity-result/v2",
+    "title": "Devflow Activity Result v2",
+    "type": "object",
+    "required": [
+      "schemaVersion",
+      "contractId",
+      "status",
+      "summary",
+      "changedFiles",
+      "checks",
+      "evidence",
+      "remainingRisks",
+      "blockers"
+    ],
+    "properties": {
+      "schemaVersion": {
+        "type": "integer",
+        "const": 2
+      },
+      "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-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "740d5860-6f7f-4691-9834-7b6a2a126b49",
+  "agent": "claude",
+  "activity": "review",
+  "returnCode": 0,
+  "durationSeconds": 62.206,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 5290,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": false,
+  "worktreeChangedFileCount": 0
+}

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/assessment.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 4,
+  "issueId": "KKS-560",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "medium",
+  "signals": {
+    "scope": "local",
+    "ambiguity": "medium",
+    "risk": "medium",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "guardrails": {
+    "active": false,
+    "reasons": []
+  },
+  "reasons": [
+    "certaines precisions peuvent etre necessaires",
+    "le risque d'impact est modere"
+  ],
+  "activities": [
+    "assess",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "review",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection",
+    "implementation-review"
+  ],
+  "assessedAt": "2026-10-20T13:15:44Z",
+  "summary": ""
+}

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/evidence/diff-inspection.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-10-20T14:22:43Z",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "docs/activity-contracts.md",
+    "docs/cli-reference.md",
+    "docs/releases/10.1.0.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/core/adaptive_runner.py",
+    "src/devflow_cli/core/contract_schemas.py",
+    "src/devflow_cli/core/validators.py",
+    "src/devflow_cli/schemas/reconcile-log-v3.schema.json",
+    "tests/test_adaptive_runner.py",
+    "tests/test_cmd_adaptive.py",
+    "tests/test_contract_schemas.py",
+    "tests/test_validators.py",
+    "tests/test_wheel_install.py",
+    "uv.lock"
+  ],
+  "findings": [],
+  "gitDiffCheck": {
+    "id": "AUTO-DIFF",
+    "command": [
+      "git",
+      "diff",
+      "--check"
+    ],
+    "blocking": true,
+    "returncode": 0,
+    "succeeded": true,
+    "timedOut": false,
+    "workingDirectory": ".",
+    "stdout": "",
+    "stderr": ""
+  }
+}

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/evidence/regression-check.json

@@ -0,0 +1,112 @@
+{
+  "schemaVersion": 1,
+  "id": "regression-check",
+  "outcome": "passed",
+  "startedAt": "2026-10-20T14:08:43Z",
+  "completedAt": "2026-10-20T14:22:43Z",
+  "commands": [
+    {
+      "id": "AUTO-REGRESSION-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "python",
+        "-m",
+        "compileall",
+        "-q",
+        "src"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-targeted-tests",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_validators.py",
+        "tests/test_adaptive_runner.py",
+        "tests/test_cmd_adaptive.py",
+        "tests/test_agent_adapters.py",
+        "tests/test_contract_schemas.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 10%]\n........................................................................ [ 21%]\n........................................................................ [ 32%]\n........................................................................ [ 43%]\n........................................................................ [ 54%]\n........................................................................ [ 65%]\n........................................................................ [ 76%]\n........................................................................ [ 87%]\n........................................................................ [ 98%]\n...........                                                              [100%]\n659 passed in 259.28s (0:04:19)\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-regression-check",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [  2%]\n........................................................................ [  5%]\n........................................................................ [  7%]\n........................................................................ [ 10%]\n........................................................................ [ 12%]\n........................................................................ [ 15%]\n........................................................................ [ 18%]\n........................................................................ [ 20%]\n........................................................................ [ 23%]\n........................................................................ [ 25%]\n........................................................................ [ 28%]\n........................................................................ [ 31%]\n........................................................................ [ 33%]\n........................................................................ [ 36%]\n........................................................................ [ 38%]\n........................................................................ [ 41%]\n........................................................................ [ 44%]\n........................................................................ [ 46%]\n........................................................................ [ 49%]\n........................................................................ [ 51%]\n........................................................................ [ 54%]\n........................................................................ [ 57%]\n........................................................................ [ 59%]\n........................................................................ [ 62%]\n........................................................................ [ 64%]\n........................................................................ [ 67%]\n........................................................................ [ 70%]\n........................................................................ [ 72%]\n........................................................................ [ 75%]\n........................................................................ [ 77%]\n........................................................................ [ 80%]\n........................................................................ [ 82%]\n........................................................................ [ 85%]\n........................................................................ [ 88%]\n........................................................................ [ 90%]\n........................................................................ [ 93%]\n........................................................................ [ 95%]\n........................................................................ [ 98%]\n.........................................                                [100%]\n2777 passed in 336.46s (0:05:36)\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-shell-tests",
+      "command": [
+        "./tests/run-tests.sh"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "==============================\n Tests devflow\n==============================\n\n>>> Suite: test-template-variants\n=== Tests create-new-feature.sh --type ===\n-- test_type_brownfield_uses_variant_template\n  [OK]   type brownfield: pas d'avertissement de fallback\n  [OK]   type brownfield: spec.md creee\n  [OK]   type brownfield: contenu du template variant present\n-- test_type_nonexistent_falls_back_to_generic_with_warning\n  [OK]   type nonexistent: avertissement fallback sur stderr\n  [OK]   type nonexistent: spec.md creee malgre le fallback\n  [OK]   type nonexistent: contenu du template generique present\n-- test_without_type_uses_generic_template\n  [OK]   sans --type: pas d'avertissement de fallback\n  [OK]   sans --type: spec.md creee\n  [OK]   sans --type: contenu du template generique present\n-- test_consecutive_features_use_correct_templates (FR-009)\n  [OK]   FR-009: spec brownfield creee (009-*)\n  [OK]   FR-009: spec 009 contient le template brownfield\n  [OK]   FR-009: spec greenfield creee (010-*)\n  [OK]   FR-009: spec 010 contient le template greenfield\n  [OK]   FR-009: spec brownfield ne contient pas le marker greenfield\n\n--- Resultats ---\nTotal: 14 | Passes: 14 | Echoues: 0\nSUCCES\n\n==============================\n Resultats globaux\n==============================\nSuites executees: 1\nTotal tests: 14 | Passes: 14 | Echoues: 0\nSUCCES\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-docs-sync",
+      "command": [
+        "uv",
+        "run",
+        "devflow",
+        "docs-sync",
+        "--check"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "[OK]   Documentation déjà synchronisée.\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-diff-inspection",
+      "command": [
+        "git",
+        "diff",
+        "--stat"
+      ],
+      "blocking": false,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": " CHANGELOG.md                             |  19 ++\n docs/activity-contracts.md               |  51 ++++-\n docs/cli-reference.md                    |  11 ++\n pyproject.toml                           |   2 +-\n src/devflow_cli/__init__.py              |   2 +-\n src/devflow_cli/commands/adaptive.py     |  20 +-\n src/devflow_cli/core/adaptive_runner.py  | 215 ++++++++++++++++-----\n src/devflow_cli/core/contract_schemas.py |   1 +\n src/devflow_cli/core/validators.py       |   9 -\n tests/test_adaptive_runner.py            | 318 ++++++++++++++++++++++++++++++-\n tests/test_cmd_adaptive.py               |  86 ++++++++-\n tests/test_contract_schemas.py           |  53 +++++-\n tests/test_validators.py                 |  41 +++-\n tests/test_wheel_install.py              |   1 +\n uv.lock                                  |   2 +-\n 15 files changed, 743 insertions(+), 88 deletions(-)\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/evidence/targeted-tests.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-tests",
+  "outcome": "passed",
+  "startedAt": "2026-10-20T14:08:43Z",
+  "completedAt": "2026-10-20T14:22:43Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_adaptive_runner.py",
+        "tests/test_cmd_adaptive.py",
+        "tests/test_contract_schemas.py",
+        "tests/test_validators.py",
+        "tests/test_wheel_install.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 11%]\n........................................................................ [ 22%]\n........................................................................ [ 34%]\n........................................................................ [ 45%]\n........................................................................ [ 57%]\n........................................................................ [ 68%]\n........................................................................ [ 80%]\n........................................................................ [ 91%]\n...................................................                      [100%]\n627 passed in 232.10s (0:03:52)\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/implement-attempt.json

@@ -0,0 +1,50 @@
+{
+  "schemaVersion": 3,
+  "contractId": "KKS-560:standard:implement:v4",
+  "activity": "implement",
+  "agent": "claude",
+  "reason": "agent-failed-after-mutation",
+  "recordedAt": "2026-10-20T13:54:39Z",
+  "head": "fea229dbbe9a3a3ae302de9fed26e2b7119c3212",
+  "branch": "050-kks-560-kpanel-frictions",
+  "rawOutputSha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "observedFiles": {
+    "CHANGELOG.md": "file:100644:d823c34204c3b1acdda561144956e7dc9b3a87341b605fba409d40fbc296526c",
+    "docs/activity-contracts.md": "file:100644:3d61d1441f5dd75f7d56aa4416a62bdefb91833c2f2516b6105a56327002e1ba",
+    "docs/cli-reference.md": "file:100644:9ce4bda3cc50ba3db4c20616a92583435e95de2d56568bbbe9a06a6e947346e0",
+    "docs/releases/10.1.0.md": "file:100644:5ed733a01df725b63245bcd00229e826d22ce2f9171f81397a3c0fb1a0ab1168",
+    "pyproject.toml": "file:100644:3c4095b734a047d97e0c4a925f5497938a6ffbffcf7aa34a78da231b6da3b666",
+    "src/devflow_cli/__init__.py": "file:100644:959b0828234677beea069ecb945b5398d82a0799620f962ed5cbea6b53717d88",
+    "src/devflow_cli/commands/adaptive.py": "file:100644:8e8819fcd134127b863b353ec38d8733b2315221760180116564b8d0728c90b5",
+    "src/devflow_cli/core/adaptive_runner.py": "file:100644:0245ed704fa53a3c439da6ca771befe649f1f608995efbe1ceebfd2ca2d2ecc7",
+    "src/devflow_cli/core/contract_schemas.py": "file:100644:3344f06edfd25557ee3daeee742f8426e477a5397da56af14140a8848b20d61d",
+    "src/devflow_cli/core/validators.py": "file:100644:1ca186d7eb5de53f1c171deb6c4d2258fb5d768964ef7aaca98ade556553d3b8",
+    "src/devflow_cli/schemas/reconcile-log-v3.schema.json": "file:100644:4cdc70eb19efddd7307540ea8b4f92025427620dffcc39c2c6453a8f04df6510",
+    "tests/test_adaptive_runner.py": "file:100644:0bb36ae75bf3d44a5abb135ff502ec3d644d106e606b646ccc7025e1de81d95c",
+    "tests/test_cmd_adaptive.py": "file:100644:2e7aa8223aa5575ac4c424941c028d4e6061e5c17f58a2b7a5c8248bb93670b1",
+    "tests/test_contract_schemas.py": "file:100644:8630780512d18bcc78d7ed9b17ef0bc07a2d2625f22ce972e5c706ef1c52ae43",
+    "tests/test_validators.py": "file:100644:05e76a2aca187bd4d3796944bd1f4d94019dc7bb518b596926396d48248eed47",
+    "tests/test_wheel_install.py": "file:100644:de2f1c6038f38942293d6cd3764067119140bdf4556e8baed7605abcd30544b4",
+    "uv.lock": "file:100644:f32a31c1b651113b28412b4eff926bb88cf04e2c941a5b86cc4ca16803b87717"
+  },
+  "executionFiles": [
+    "CHANGELOG.md",
+    "docs/activity-contracts.md",
+    "docs/cli-reference.md",
+    "docs/releases/10.1.0.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/core/adaptive_runner.py",
+    "src/devflow_cli/core/contract_schemas.py",
+    "src/devflow_cli/core/validators.py",
+    "src/devflow_cli/schemas/reconcile-log-v3.schema.json",
+    "tests/test_adaptive_runner.py",
+    "tests/test_cmd_adaptive.py",
+    "tests/test_contract_schemas.py",
+    "tests/test_validators.py",
+    "tests/test_wheel_install.py",
+    "uv.lock"
+  ],
+  "changedInputs": []
+}

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/implement-result.json

@@ -0,0 +1,70 @@
+{
+  "schemaVersion": 2,
+  "contractId": "KKS-560:standard:implement:v4",
+  "status": "completed",
+  "summary": "Travail de l'agent implement, arrêté par le délai de 1800 s après avoir tout écrit (trace vide, 17 fichiers observés) ; résultat rédigé par le superviseur après relecture des diffs et exécution des contrôles. D1 : _PLACEHOLDER_MUSTACHE et sa boucle retirés de validators.py, test retourné ({{ n }}, {{TITLE}}, ${{ github.sha }} valides en prose ; crochets toujours refusés). D2 : reconcile sans --result accepte l'artefact corrigé d'une fiche invalid-artifact si le validateur de run (_artifact_validation_error, commun à run et reconcile, preflight-evidence inclus) l'accepte, que seul l'artefact a changé et que --reason est fourni ; entrée kind artifact (path, attemptFingerprint, correctedFingerprint) dans reconcile-log.json ; guidage de run affiché après invalid-artifact ; --reason seul refusé hors ce cas (REASON_WITHOUT_RESULT_MESSAGE). D3 : reconcile-log schéma 3 (kind result|artifact), schéma public reconcile-log-v3.schema.json validé avant chaque écriture, schémas 1 et 2 refusés avec marche à suivre. D4 : bac à sable workspace-write dès que execute figure dans allowedActions, read-only sinon. Version 10.1.0 concordante (pyproject.toml, __init__.py, uv.lock, CHANGELOG.md), notes docs/releases/10.1.0.md, docs alignées.",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "docs/activity-contracts.md",
+    "docs/cli-reference.md",
+    "docs/releases/10.1.0.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/core/adaptive_runner.py",
+    "src/devflow_cli/core/contract_schemas.py",
+    "src/devflow_cli/core/validators.py",
+    "src/devflow_cli/schemas/reconcile-log-v3.schema.json",
+    "tests/test_adaptive_runner.py",
+    "tests/test_cmd_adaptive.py",
+    "tests/test_contract_schemas.py",
+    "tests/test_validators.py",
+    "tests/test_wheel_install.py",
+    "uv.lock"
+  ],
+  "checks": [
+    {
+      "id": "targeted-tests",
+      "command": "uv run pytest -q tests/test_validators.py tests/test_adaptive_runner.py tests/test_cmd_adaptive.py tests/test_agent_adapters.py tests/test_contract_schemas.py tests/test_wheel_install.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "full-suite",
+      "command": "uv run pytest -q",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "run-tests",
+      "command": "./tests/run-tests.sh",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "docs-sync",
+      "command": "uv run devflow docs-sync --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "diff-check",
+      "command": "git diff --check",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "D4 : la non-écriture de prepare, review et rollback-check n'est plus empêchée par le mode plan, seulement constatée après coup par les gates ; non prouvée sur un agent réel dans ce parcours.",
+    "D2 pour preflight-evidence : le contrôle de fraîcheur de preflight-evidence.md après une correction manuelle n'a pas été exercé en réel.",
+    "Les trois frictions kpanel ne sont pas rejouées avec un agent réel ; leur résolution attend la publication et un prochain parcours deep."
+  ],
+  "blockers": [],
+  "observation": {
+    "baseRecordedAt": "2026-10-20T13:24:38Z",
+    "baseHead": "fea229dbbe9a3a3ae302de9fed26e2b7119c3212",
+    "observedAt": "2026-10-20T14:08:31Z",
+    "head": "fea229dbbe9a3a3ae302de9fed26e2b7119c3212"
+  }
+}

devflow_cli-10.1.0/.specify/specs/050-kks-560-kpanel-frictions/need.md

@@ -0,0 +1,107 @@
+# KKS-560 — Frictions kpanel KKS-480 : placeholders moustache, correction d'artefact auditée, mode d'exécution de rollback-check
+
+Source : issue Linear KKS-560, conception du 2026-10-19 avec Kelly (Q1 C, Q2 A, Q3 A, Q4 B).
+Trois frictions observées en réel sur kpanel KKS-480 en 9.0.1, toutes vérifiées encore présentes
+dans la 10.0.2. Constitution, article IV : chaque décision répond à un constat observé.
+
+## Constats
+
+| # | Constat observé | Où |
+|---|---|---|
+| C1 | Friction `8736a526` (mineur) : `plan` refusé `invalid-artifact : Placeholder non-remplace ligne 190: {{ n }}`. Le texte est une interpolation Angular citée dans la prose du plan, pas un placeholder Devflow. La détection moustache date de la 2.0.0 ; aucun gabarit d'artefact Devflow n'utilise de moustaches (seul `templates/constitution-template.md`, jamais passé par `validate_artifact`, en a). En huit versions majeures elle n'a produit que ce faux positif. | `_PLACEHOLDER_MUSTACHE` et sa boucle dans `validate_artifact` (`src/devflow_cli/core/validators.py`) |
+| C2 | Friction `e4a13a88` (majeur) : après ce refus à tort, aucune reprise ne garde le plan corrigé. `reconcile` (avec ou sans `--result`) refuse « fichiers modifies depuis la tentative » dès que l'artefact refusé est corrigé ; `complete` exige un résultat valide ; seul `discard-attempt` puis une régénération complète restent possibles. La correction manuelle auditée (`reconcile-log.json`) n'existe que pour le résultat JSON. | calcul de `drifted` dans `run_adaptive_reconcile` (`src/devflow_cli/core/adaptive_runner.py`) ; `_record_manual_correction` |
+| C3 | Friction `22a2785e` (majeur) : `rollback-check` (deep) bloqué, l'agent se déclarant « mode plan actif, lecture seule » alors que le contrat exige une preuve exécutable (démarrer l'ancienne version sur une base migrée). Le bac à sable est `read-only` dès que `write` manque dans `allowedActions` ; `ClaudeCodeAdapter` traduit `read-only` en `--permission-mode plan`. Or `rollback-check` déclare `["read", "execute"]`. | `_run_until` (`src/devflow_cli/commands/adaptive.py`, choix du `sandbox_mode`) ; `ClaudeCodeAdapter.build_structured_command` (`src/devflow_cli/adapters/agents.py`) |
+
+## Décisions (non rediscutables dans ce parcours)
+
+- **D1 — Placeholders.** La détection des placeholders moustache `{{…}}` est supprimée
+  (`_PLACEHOLDER_MUSTACHE` et sa boucle). La détection des crochets (`[FEATURE NAME]`, `[TBD]`,
+  `[TODO]`, `[XXX]`), seule forme utilisée par les gabarits d'artefacts, reste inchangée, ainsi
+  que le masquage des blocs et spans de code. Le test qui attend un refus sur `{{TITLE}}` est
+  retourné : un artefact dont la prose contient `{{ n }}`, `{{TITLE}}` ou `${{ github.sha }}`
+  est valide.
+- **D2 — Correction d'artefact auditée.** `adaptive reconcile ISSUE_ID --reason TEXTE` (sans
+  `--result`) accepte, pour une activité documentaire, que l'artefact de l'activité ait changé
+  depuis la tentative si, et seulement si :
+  1. la fiche de tentative porte le motif `invalid-artifact` ;
+  2. l'artefact corrigé passe maintenant `validate_artifact` ;
+  3. aucun autre fichier n'a changé depuis la tentative (règle actuelle conservée pour tout
+     chemin autre que l'artefact) ;
+  4. `--reason` est fourni (obligatoire dans ce cas ; sans lui, refus qui dit de le fournir).
+  Toute autre tentative (motif différent, artefact encore invalide, autre fichier modifié) est
+  refusée comme aujourd'hui ; en particulier `--reason` sans `--result` reste refusé par le
+  message actuel dès que la fiche ne porte pas `invalid-artifact`. Le validateur appliqué à
+  l'artefact corrigé est celui que `adaptive run` applique à cette activité (`validate_artifact`
+  pour les artefacts documentaires, `validate_preflight_evidence` pour `preflight-evidence`) ;
+  le chemin comparé et validé est celui de `document_artifact_name(activity, reopened=…)`, le
+  même pour un plan rouvert. Le guidage affiché après un refus `invalid-artifact` d'une
+  activité documentaire mentionne cette voie : corriger l'artefact puis
+  `adaptive reconcile ISSUE_ID --reason TEXTE`. L'artefact corrigé est consigné dans `reconcile-log.json` avant
+  la transition : `kind: "artifact"`, chemin de l'artefact, empreinte à la tentative (celle de
+  `observedFiles` de la fiche), empreinte corrigée, auteur, motif, `source: "manual-correction"`.
+  La réponse de l'agent (résultat JSON) est reprise de la trace comme pour un `reconcile`
+  ordinaire ; `--result` reste gouverné par la règle B1 et n'est pas combiné à cette voie dans
+  ce lot. `verify`, `review` et `rollback-check` ne sont pas concernés (aucun artefact
+  documentaire).
+- **D3 — `reconcile-log.json` en schéma 3.** Chaque entrée porte `kind` : `result` pour la
+  correction du résultat (entrée actuelle, champs inchangés), `artifact` pour D2. Un journal de
+  schéma 1 ou 2 est refusé avant toute écriture par un message qui dit quoi faire, sur le modèle
+  de `RECONCILE_LOG_LEGACY_MESSAGE` (terminer avec la version antérieure, ou déplacer le fichier
+  dans `attempts/` et commencer un nouveau journal). Schéma JSON `reconcile-log` versionné
+  comme les autres formats du dépôt, documenté dans `docs/activity-contracts.md`.
+- **D4 — Bac à sable selon `allowedActions`.** L'agent est lancé en `read-only` seulement si
+  `execute` est absent de `allowedActions` ; avec `execute` sans `write` (`prepare`, `review`,
+  `rollback-check`), il reçoit le mode de permission de la commande (`auto` par défaut) et le
+  bac à sable `workspace-write`. L'interdiction d'écrire reste garantie après coup par les gates
+  existantes (`prepare`, `review` et `rollback-check` « ne peut pas modifier de fichiers »,
+  sur les fichiers observés). Aucune activité ne déclare aujourd'hui `read` seul ; le cas est
+  conservé pour la règle. Les contrats, les gates et les motifs de refus ne changent pas.
+
+## Attendu et tests
+
+- Aucun agent réel ; aucun appel à Linear.
+- D1 : `{{ n }}`, `{{TITLE}}` et `${{ github.sha }}` en prose ne produisent aucune issue ;
+  `[FEATURE NAME]` et `[TBD]` en prose en produisent toujours ; dans un bloc ou span de code,
+  rien ne change.
+- D2 : tests sur `run_adaptive_reconcile` avec une fiche `invalid-artifact` : artefact corrigé
+  valide + `--reason` → accepté, entrée `kind: "artifact"` avec les deux empreintes ; artefact
+  corrigé encore invalide → `invalid-artifact` sans trace ; artefact corrigé sans `--reason` →
+  refus ; autre fichier modifié en plus → refus « fichiers modifies depuis la tentative » ;
+  fiche d'un autre motif avec artefact modifié → refus actuel. Un `reconcile` ordinaire sans
+  artefact modifié reste accepté sans entrée `artifact`.
+- D3 : un journal de schéma 2 (et de schéma 1) est refusé avant toute écriture, avec le message ;
+  un journal de schéma 3 reçoit les deux sortes d'entrées ; une entrée `result` conserve ses
+  champs actuels (`payload`, `payloadSha256`, `agentPayloadSha256`, `changedFields`).
+- D4 : `build_structured_command` reçoit `workspace-write` pour un contrat `["read", "execute"]`
+  et `read-only` pour `["read"]` seul ; le test de `test_cmd_adaptive.py` qui attend
+  `["read-only", "workspace-write", "workspace-write"]` pour `prepare → preflight → implement`
+  est mis à jour ; `ClaudeCodeAdapter` traduit toujours `read-only` en `plan`.
+- Documentation alignée : `docs/activity-contracts.md` (placeholders, `reconcile-log` schéma 3,
+  correction d'artefact, bac à sable), `docs/cli-reference.md` (`reconcile`).
+- Suite complète verte, `./tests/run-tests.sh` vert, `uv run devflow docs-sync --check` vert.
+
+## Livraison
+
+- Version **10.1.0** : nouvelle voie de reprise (D2), rupture d'un format interne (D3, en version
+  mineure comme le passage 1 → 2 en 8.1.0), deux changements de comportement (D1, D4) ; aucune
+  rupture de la CLI. Le contrôle CI exige une version strictement supérieure à celle de `main`
+  (10.0.2). Concordance dans `pyproject.toml`, `src/devflow_cli/__init__.py`, `uv.lock`,
+  `CHANGELOG.md`. Notes dans `docs/releases/10.1.0.md`, avec la marche à suivre pour un
+  `reconcile-log.json` de schéma 2 et le retour à la 10.0.2.
+- Résolution de `8736a526`, `e4a13a88` et `22a2785e` au journal après publication vérifiée,
+  pas pendant le parcours.
+
+## Hors périmètre
+
+- Combiner `--result` et la correction d'artefact dans un même `reconcile`.
+- Toute reprise qui fournit à l'agent l'artefact existant pour qu'il le corrige (option B de Q2,
+  écartée).
+- Désactiver les outils d'édition de l'agent par option de ligne de commande (option C de Q3,
+  écartée).
+
+## Contraintes d'exécution
+
+- Le parcours est piloté par la CLI 10.0.2 installée.
+- Aucun test ni aucune activité ne lance un agent réel, ni n'appelle Linear.
+- Aucun commit, aucun `git stash`, aucun changement de branche pendant les activités.
+- La sortie structurée du contrat est le dernier message de l'agent.