devflow-cli 6.3.0__tar.gz → 6.4.0__tar.gz

devflow_cli-6.4.0/.specify/specs/032-kks-419/.gitignore

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

devflow_cli-6.4.0/.specify/specs/032-kks-419/activity-contract.json

@@ -0,0 +1,161 @@
+{
+  "schemaVersion": 3,
+  "contractId": "KKS-419:standard:implement:v3",
+  "issueId": "KKS-419",
+  "profile": "standard",
+  "activity": "implement",
+  "objective": "Choisir l'interpréteur de AUTO-REGRESSION-PYTHON sans supposer python dans le PATH",
+  "featurePath": ".specify/specs/032-kks-419",
+  "inputs": [
+    ".specify/specs/032-kks-419/need.md",
+    ".specify/specs/032-kks-419/assessment.json",
+    ".specify/specs/032-kks-419/workflow-state.json",
+    ".specify/specs/032-kks-419/preflight-evidence.md",
+    ".specify/specs/032-kks-419/prepare-result.json"
+  ],
+  "allowedActions": [
+    "read",
+    "write",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/032-kks-419/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.",
+    "Limiter les modifications source au changement demande.",
+    "Suivre les conventions et les tests existants du depot.",
+    "Les preuves de gate sont produites par l'activite locale verify, pas par implement.",
+    "Ne pas retourner blocked uniquement parce qu'une validation d'integration exige un service externe inaccessible depuis le sandbox de l'agent (Docker, base de donnees ou reseau) : executer les autres controles, declarer le check echoue et le risque restant, puis retourner completed si le code est coherent et verifiable par verify.",
+    "Prendre en compte la preuve de pre-vol archivee et ne pas la presenter comme absente."
+  ],
+  "completionCriteria": [
+    "Le changement demande est implemente dans le depot.",
+    "Les fichiers modifies sont listes dans le resultat.",
+    "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"
+    ],
+    "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-6.4.0/.specify/specs/032-kks-419/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "adf62a71-4780-43bb-a733-e3f20bbafd0b",
+  "agent": "claude",
+  "activity": "implement",
+  "returnCode": 0,
+  "durationSeconds": 179.822,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 3339,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": true,
+  "worktreeChangedFileCount": 7
+}

devflow_cli-6.4.0/.specify/specs/032-kks-419/assessment.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": 3,
+  "issueId": "KKS-419",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "medium",
+  "signals": {
+    "scope": "local",
+    "ambiguity": "low",
+    "risk": "medium",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "reasons": [
+    "le risque d'impact est modere"
+  ],
+  "activities": [
+    "assess",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection"
+  ],
+  "assessedAt": "2026-09-29T16:45:08Z",
+  "summary": "Choisir l'interpréteur de AUTO-REGRESSION-PYTHON sans supposer python dans le PATH"
+}

devflow_cli-6.4.0/.specify/specs/032-kks-419/evidence/diff-inspection.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-09-29T16:53:56Z",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "docs/releases/6.3.1.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/core/automatic_evidence.py",
+    "tests/test_automatic_evidence.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-6.4.0/.specify/specs/032-kks-419/evidence/regression-check.json

@@ -0,0 +1,112 @@
+{
+  "schemaVersion": 1,
+  "id": "regression-check",
+  "outcome": "passed",
+  "startedAt": "2026-09-29T16:52:17Z",
+  "completedAt": "2026-09-29T16:53:56Z",
+  "commands": [
+    {
+      "id": "AUTO-REGRESSION-PYTHON",
+      "command": [
+        "python",
+        "-m",
+        "compileall",
+        "-q",
+        "src"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-targeted-automatic-evidence",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_automatic_evidence.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "...................................................                      [100%]\n51 passed in 10.07s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-verification-policy",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_verification.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 57%]\n.....................................................                    [100%]\n125 passed in 0.19s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-release-consistency",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_release.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": ".............................                                            [100%]\n29 passed in 0.23s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-full-suite",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [  7%]\n........................................................................ [ 14%]\n........................................................................ [ 21%]\n........................................................................ [ 28%]\n........................................................................ [ 36%]\n........................................................................ [ 43%]\n........................................................................ [ 50%]\n........................................................................ [ 57%]\n........................................................................ [ 65%]\n........................................................................ [ 72%]\n........................................................................ [ 79%]\n........................................................................ [ 86%]\n........................................................................ [ 93%]\n............................................................             [100%]\n996 passed in 73.86s (0:01:13)\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": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-6.4.0/.specify/specs/032-kks-419/evidence/targeted-tests.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-tests",
+  "outcome": "passed",
+  "startedAt": "2026-09-29T16:52:17Z",
+  "completedAt": "2026-09-29T16:53:56Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_automatic_evidence.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "...................................................                      [100%]\n51 passed in 8.49s\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-6.4.0/.specify/specs/032-kks-419/implement-result.json

@@ -0,0 +1,56 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-419:standard:implement:v3",
+  "status": "completed",
+  "summary": "La commande AUTO-REGRESSION-PYTHON ne suppose plus que `python` est dans le PATH. Le changement est dans la branche Python de `select_regression_commands` (src/devflow_cli/core/automatic_evidence.py). Si `uv.lock` existe, la commande est `uv run python -m compileall -q src`, sans option. Sinon, l'interpréteur est choisi par shutil.which dans l'ordre python3 puis python, et la commande porte toujours son nom nu, jamais un chemin, que la politique refuserait (vérifié sur `/usr/bin/python3`). Sans aucun interpréteur, la fonction lève la nouvelle exception `RegressionInterpreterUnavailable`. `run_automatic_verification` l'intercepte et renvoie avant toute exécution la raison `regression-interpreter-unavailable`, distincte de `regression-check-failed` et de `no-safe-regression`. Les branches Node, Maven et Rust ne changent pas, pas plus que la sélection ciblée AUTO-PYTHON ni la politique de validation. Tests ajoutés dans tests/test_automatic_evidence.py, avec shutil.which simulé par monkeypatch : forme `uv run` avec `uv.lock` ; préférence pour python3 ; python3 utilisé quand python est absent ; repli sur python ; exception quand aucun interpréteur n'est trouvé ; chaque forme produite acceptée par `validate_command_policy` ; projets Rust ou sans marqueur inchangés, sans recherche d'interpréteur ; en profil standard sans interpréteur, échec d'environnement sans aucune exécution, l'activité restant sur verify. Livraison en version 6.3.1, concordante dans pyproject.toml, VERSION, uv.lock (bloc devflow-cli) et CHANGELOG.md, avec les notes docs/releases/6.3.1.md.",
+  "changedFiles": [
+    "src/devflow_cli/core/automatic_evidence.py",
+    "tests/test_automatic_evidence.py",
+    "src/devflow_cli/__init__.py",
+    "pyproject.toml",
+    "uv.lock",
+    "CHANGELOG.md",
+    "docs/releases/6.3.1.md"
+  ],
+  "checks": [
+    {
+      "id": "targeted-automatic-evidence",
+      "command": "uv run pytest -q tests/test_automatic_evidence.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "targeted-policy-release",
+      "command": "uv run pytest -q tests/test_automatic_evidence.py tests/test_verification.py tests/test_release.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "release-consistency",
+      "command": "uv run python scripts/check_release.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "docs-sync",
+      "command": "uv run devflow docs-sync --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "full-suite",
+      "command": "uv run pytest -q",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "Si uv.lock existe mais que uv est absent du PATH, l'échec reste un code 127 rapporté comme regression-check-failed : need.md ne tranche pas ce cas, qui n'a pas été traité.",
+    "L'interpréteur est choisi au moment de verify, selon le PATH du processus devflow : la commande enregistrée dans les preuves peut donc différer d'une machine à l'autre (python3 ou python).",
+    "Après regression-interpreter-unavailable, la reprise guidée propose toujours reopen … implement (friction 6079cb7c, hors périmètre).",
+    "./tests/run-tests.sh n'a pas été lancé pendant implement ; il relève de verify.",
+    "Aucune documentation CLI ne décrit la régression Python : seuls le CHANGELOG et les notes de version décrivent le changement."
+  ],
+  "blockers": []
+}

devflow_cli-6.4.0/.specify/specs/032-kks-419/need.md

@@ -0,0 +1,51 @@
+# KKS-419 — Lancer la régression Python automatique sans supposer « python » dans le PATH
+
+Source : retour `devflow feedback` `3a165157` (majeur), déjà consigné comme m5 dans `FEEDBACK.md`
+pendant KKS-411, puis rencontré sur KKS-416 et KKS-414.
+
+## Problème
+
+`select_regression_commands` (`src/devflow_cli/core/automatic_evidence.py`) construit
+`AUTO-REGRESSION-PYTHON` avec `["python", "-m", "compileall", "-q", "src"]`. Sur macOS sans
+environnement virtuel actif, seul `python3` existe : la commande échoue en code 127 (« No such
+file or directory: 'python' ») et `verify` est refusé comme un échec de tests, alors que le code
+est correct.
+
+Contournement actuel : lancer `verify` avec `.venv/bin` en tête du `PATH`.
+
+La sélection ciblée du même fichier suit déjà un autre patron : `uv run pytest` si `uv.lock`
+existe, sinon `pytest`.
+
+## Attendu
+
+- L'interpréteur de `AUTO-REGRESSION-PYTHON` ne dépend plus d'un `python` dans le `PATH`. Ordre
+  suggéré, à trancher en spec : `uv run python -m compileall -q src` si `uv.lock` existe, sinon
+  `python3`, sinon `python`.
+- La commande produite respecte la politique de validation (`src/devflow_cli/core/verification.py`) :
+  `uv run` sans option, et `python -m compileall`, module autorisé.
+- Aucun interpréteur disponible : échec explicite, identifiable comme un problème d'environnement
+  (et non comme un échec de tests du code).
+- Aucun changement pour les autres régressions automatiques (Node, Maven, Rust) ni pour la
+  sélection ciblée.
+
+## Tests attendus
+
+- Projet Python avec `uv.lock` : la forme `uv run` est produite.
+- Projet Python sans `uv.lock`, `python` absent et `python3` présent : `python3` est utilisé.
+- Aucun interpréteur disponible : échec explicite, identifiable comme un problème
+  d'environnement.
+- La commande produite passe la politique de validation.
+- Projet non Python : inchangé.
+
+## Livraison
+
+- Nouvelle version strictement supérieure à 6.3.0, concordante dans `pyproject.toml`, `VERSION`
+  (`src/devflow_cli/__init__.py`), `uv.lock` et `CHANGELOG.md` (cf. `scripts/check_release.py` et
+  `CONTRIBUTING.md`). Notes dans `docs/releases/`.
+- Documentation CLI à jour si elle décrit la régression Python (`uv run devflow docs-sync --check`).
+
+## Hors périmètre
+
+- Friction `6079cb7c` (mineur) : après un échec d'environnement, la reprise guidée propose
+  `reopen … implement` au lieu de `devflow adaptive verify`.
+- La sélection ciblée `pytest` sans `uv.lock`.

devflow_cli-6.4.0/.specify/specs/032-kks-419/preflight-evidence-result.json

@@ -0,0 +1,50 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-419:standard:preflight-evidence:v3",
+  "status": "completed",
+  "summary": "preflight-evidence.md est rédigé. L'échec est reproduit : avec PATH=/usr/bin:/bin, la forme actuelle `python -m compileall -q src` sort en code 127 (FileNotFoundError intercepté), alors que `python3 -m compileall -q src` sort en code 0. La forme `uv run python -m compileall -q src` sort aussi en code 0. La politique de validation accepte `uv run`, `python3` et `python` sous leur nom nu, mais refuse le chemin absolu : la commande doit donc porter le nom nu, jamais la sortie brute de shutil.which. Elle accepte aussi `uv run --no-sync` : la forme sans option doit être garantie par l'implémentation. Autre constat : les commandes PREP du validationPlan sont fusionnées aux régressions. Une simple liste vide ne déclencherait donc pas no-safe-regression, et le cas « aucun interpréteur » exige un signal distinct. Base saine : 166 tests passent. Version de départ concordante : 6.3.0.",
+  "changedFiles": [
+    ".specify/specs/032-kks-419/preflight-evidence.md"
+  ],
+  "checks": [
+    {
+      "id": "probe-script",
+      "command": "uv run python <scratchpad>/probe.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "baseline-automatic-evidence-verification",
+      "command": "uv run pytest -q tests/test_automatic_evidence.py tests/test_verification.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "repro-python-absent",
+      "command": "env PATH=/usr/bin:/bin python -m compileall -q src",
+      "exitCode": 127,
+      "status": "failed"
+    },
+    {
+      "id": "repro-python3-present",
+      "command": "env PATH=/usr/bin:/bin python3 -m compileall -q src",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [
+    {
+      "id": "preflight-evidence",
+      "outcome": "passed",
+      "report": ".specify/specs/032-kks-419/preflight-evidence.md : 11 faits observés, avec les sections Source, Reproductibilité, Périmètre, Confidentialité et Limites. Le check repro-python-absent échoue volontairement : il prouve le défaut actuel, un code 127 sans python dans le PATH."
+    }
+  ],
+  "remainingRisks": [
+    "Le cas « uv.lock présent mais uv absent du PATH » donnerait encore un code 127, rapporté comme regression-check-failed. need.md ne le tranche pas.",
+    "Le nom de la raison d'environnement et la forme du signal renvoyé par select_regression_commands restent à fixer à l'implémentation, sans modifier la reprise guidée (6079cb7c est hors périmètre).",
+    "La politique accepte les options de uv run : rien n'empêche mécaniquement une forme avec option. La forme sans option doit être testée explicitement.",
+    "La résolution par shutil.which rend la commande dépendante du poste. Les tests doivent simuler shutil.which par monkeypatch, car le venv local expose python.",
+    "Ni la suite complète, ni docs-sync --check, ni run-tests.sh, ni check_release.py n'ont été lancés : ils relèvent de verify."
+  ],
+  "blockers": []
+}