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

devflow_cli-6.4.0/.specify/specs/033-kks-420-stale-commands-warning/.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/033-kks-420-stale-commands-warning/activity-contract.json

@@ -0,0 +1,161 @@
+{
+  "schemaVersion": 3,
+  "contractId": "KKS-420:standard:implement:v3",
+  "issueId": "KKS-420",
+  "profile": "standard",
+  "activity": "implement",
+  "objective": "Avertir quand les commandes /devflow installees ne correspondent pas a la version de la CLI et documenter la procedure d'installation",
+  "featurePath": ".specify/specs/033-kks-420-stale-commands-warning",
+  "inputs": [
+    ".specify/specs/033-kks-420-stale-commands-warning/need.md",
+    ".specify/specs/033-kks-420-stale-commands-warning/assessment.json",
+    ".specify/specs/033-kks-420-stale-commands-warning/workflow-state.json",
+    ".specify/specs/033-kks-420-stale-commands-warning/preflight-evidence.md",
+    ".specify/specs/033-kks-420-stale-commands-warning/prepare-result.json"
+  ],
+  "allowedActions": [
+    "read",
+    "write",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/033-kks-420-stale-commands-warning/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/033-kks-420-stale-commands-warning/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "2cf49498-fbc0-4efa-bde4-940435ee4e55",
+  "agent": "claude",
+  "activity": "implement",
+  "returnCode": 0,
+  "durationSeconds": 208.35,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 3659,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": true,
+  "worktreeChangedFileCount": 11
+}

devflow_cli-6.4.0/.specify/specs/033-kks-420-stale-commands-warning/assessment.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 3,
+  "issueId": "KKS-420",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "medium",
+  "signals": {
+    "scope": "multiple",
+    "ambiguity": "medium",
+    "risk": "low",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "reasons": [
+    "plusieurs composants sont affectes",
+    "certaines precisions peuvent etre necessaires"
+  ],
+  "activities": [
+    "assess",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection"
+  ],
+  "assessedAt": "2026-09-29T19:58:32Z",
+  "summary": "Avertir quand les commandes /devflow installees ne correspondent pas a la version de la CLI et documenter la procedure d'installation"
+}

devflow_cli-6.4.0/.specify/specs/033-kks-420-stale-commands-warning/evidence/diff-inspection.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-09-29T20:05:51Z",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "README.md",
+    "docs/releases/6.4.0.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/commands/status.py",
+    "src/devflow_cli/core/manifest.py",
+    "tests/test_cmd_status.py",
+    "tests/test_manifest.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/033-kks-420-stale-commands-warning/evidence/regression-check.json

@@ -0,0 +1,132 @@
+{
+  "schemaVersion": 1,
+  "id": "regression-check",
+  "outcome": "passed",
+  "startedAt": "2026-09-29T20:05:07Z",
+  "completedAt": "2026-09-29T20:05:51Z",
+  "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_cmd_status.py",
+        "tests/test_manifest.py",
+        "tests/test_cmd_upgrade.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "............................................                             [100%]\n44 passed in 0.17s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-regression-check",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [  7%]\n........................................................................ [ 14%]\n........................................................................ [ 21%]\n........................................................................ [ 28%]\n........................................................................ [ 35%]\n........................................................................ [ 42%]\n........................................................................ [ 49%]\n........................................................................ [ 56%]\n........................................................................ [ 64%]\n........................................................................ [ 71%]\n........................................................................ [ 78%]\n........................................................................ [ 85%]\n........................................................................ [ 92%]\n........................................................................ [ 99%]\n...                                                                      [100%]\n1011 passed in 41.98s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-release-consistency",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_release.py",
+        "tests/test_version.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "...............................                                          [100%]\n31 passed in 0.22s\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-doc-install-procedure",
+      "command": [
+        "rg",
+        "-n",
+        "uv tool install --refresh devflow-cli==X.Y.Z",
+        "README.md",
+        "CONTRIBUTING.md"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "README.md:21:uv tool install --refresh devflow-cli==X.Y.Z   # version publiée, voir CHANGELOG.md\nCONTRIBUTING.md:130:(`uv tool install --refresh devflow-cli==X.Y.Z`), puis `devflow upgrade` pour\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-diff-inspection",
+      "command": [
+        "git",
+        "diff",
+        "--stat"
+      ],
+      "blocking": false,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": " CHANGELOG.md                       |  12 ++++\n CONTRIBUTING.md                    |   5 +-\n README.md                          |   9 ++-\n pyproject.toml                     |   2 +-\n src/devflow_cli/__init__.py        |   2 +-\n src/devflow_cli/commands/status.py |  21 +++++-\n src/devflow_cli/core/manifest.py   |  18 +++++\n tests/test_cmd_status.py           |  65 ++++++++++++++++++\n tests/test_manifest.py             | 136 +++++++++++++++++++++++++++++++++++++\n uv.lock                            |   2 +-\n 10 files changed, 266 insertions(+), 6 deletions(-)\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-6.4.0/.specify/specs/033-kks-420-stale-commands-warning/evidence/targeted-tests.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-tests",
+  "outcome": "passed",
+  "startedAt": "2026-09-29T20:05:07Z",
+  "completedAt": "2026-09-29T20:05:51Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_cmd_status.py",
+        "tests/test_manifest.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "...................................                                      [100%]\n35 passed in 0.16s\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-6.4.0/.specify/specs/033-kks-420-stale-commands-warning/implement-result.json

@@ -0,0 +1,73 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-420:standard:implement:v3",
+  "status": "completed",
+  "summary": "Ajout de `stale_commands(devflow_root, claude_dir)` dans `core/manifest.py`. Cette fonction en lecture seule réutilise `compute_source_manifest`, `load_manifest` et `compare_manifests`, limités aux entrées `commands/devflow*.md`. Elle renvoie une liste vide quand aucune commande devflow n'est installée ou que `~/.claude` est absent. Sinon, elle renvoie toutes les commandes qui ne sont pas `current` : outdated, modified, unknown, et `new` quand d'autres commandes sont installées. Ce dernier cas lève le risque ouvert par le pré-vol. `devflow status`, avec ou sans ISSUE_ID, appelle `_warn_stale_commands()` avant toute sortie anticipée. L'avertissement liste les commandes concernées et donne « Lancer : devflow upgrade ». Le code de sortie ne change pas et rien n'est écrit dans `~/.claude`. Un manifeste corrompu est signalé sans plantage. La procédure `uv tool install --refresh devflow-cli==X.Y.Z` puis `devflow upgrade` est documentée dans `README.md` (Installation) et `CONTRIBUTING.md`. La version passe de 6.3.1 à 6.4.0 : pyproject, `__init__`, `uv.lock`, CHANGELOG et `docs/releases/6.4.0.md`. Tests ajoutés : 11 dans `test_manifest.py` et 4 dans `test_cmd_status.py`, plus une fixture autouse qui isole les tests de status du `~/.claude` réel.",
+  "changedFiles": [
+    "src/devflow_cli/core/manifest.py",
+    "src/devflow_cli/commands/status.py",
+    "tests/test_manifest.py",
+    "tests/test_cmd_status.py",
+    "README.md",
+    "CONTRIBUTING.md",
+    "CHANGELOG.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "uv.lock",
+    "docs/releases/6.4.0.md"
+  ],
+  "checks": [
+    {
+      "id": "targeted-tests",
+      "command": "uv run pytest -q tests/test_cmd_status.py tests/test_manifest.py tests/test_cmd_upgrade.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "regression-check",
+      "command": "uv run pytest -q",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "release-consistency",
+      "command": "uv run pytest -q tests/test_release.py tests/test_version.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "docs-sync",
+      "command": "uv run devflow docs-sync --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "doc-install-procedure",
+      "command": "rg -n \"uv tool install --refresh devflow-cli==X.Y.Z\" README.md CONTRIBUTING.md",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "bash-tests",
+      "command": "./tests/run-tests.sh",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "check-release",
+      "command": "uv run python scripts/check_release.py --main-pyproject $TMPDIR/main-pyproject.toml",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "L'avertissement n'apparaît que dans `devflow status`, comme décidé en préparation. Un appel direct à `adaptive run` ou à `check` ne l'affiche pas.",
+    "Les commandes `new` sont signalées quand au moins une commande devflow est déjà installée. C'est un élargissement assumé du filtre prévu en préparation (outdated, modified, unknown), pour couvrir le risque relevé au pré-vol.",
+    "Pour `modified` et `unknown`, `devflow upgrade` sans `--force` demande une confirmation avant d'écraser les fichiers (avec sauvegarde .bak). Le message indique seulement `devflow upgrade`.",
+    "Chaque `devflow status` hache toutes les ressources sources avant de filtrer sur `commands/`. Le coût est faible mais n'a pas été mesuré.",
+    "Le cas où la CLI est plus ancienne que les commandes installées n'est pas distingué : il est signalé comme une divergence ordinaire.",
+    "`devflow status KKS-420` lancé sur le poste n'affiche aucun avertissement. Le `~/.claude` réel n'a pas été inspecté pour savoir pourquoi."
+  ],
+  "blockers": []
+}

devflow_cli-6.4.0/.specify/specs/033-kks-420-stale-commands-warning/need.md

@@ -0,0 +1,38 @@
+# KKS-420 — Signaler les commandes /devflow obsolètes après une mise à jour de la CLI
+
+Source : retour `devflow feedback` `fc12f118` (majeur), relevé à l'installation de la 6.3.0.
+Issue Linear : KKS-420. Liée à KKS-414 et KKS-413.
+
+## Problème
+
+`uv tool install devflow-cli==X.Y.Z` met à jour la CLI, mais les commandes
+`~/.claude/commands/devflow*.md` restent celles de la version précédente. En 6.3.0, la consigne
+« Retours d'usage » de `/devflow` n'est devenue active qu'après `devflow upgrade --force`.
+`devflow upgrade --dry-run` détectait bien `commands/devflow.md` comme obsolète, mais rien ne le
+signale pendant l'usage. `README.md` et `CONTRIBUTING.md` ne mentionnent pas cette étape.
+
+## Attendu
+
+- Procédure d'installation documentée (`README.md`, `CONTRIBUTING.md`) :
+  `uv tool install --refresh devflow-cli==X.Y.Z`, puis `devflow upgrade`.
+- Avertissement visible dans le parcours `/devflow` quand les commandes installées ne
+  correspondent pas à la version de la CLI : il indique la commande à lancer. L'emplacement
+  (`devflow status`, `adaptive run`, `check`) est à trancher pendant la préparation. Réutiliser la
+  comparaison de manifestes de `devflow upgrade`.
+- Aucune mise à jour silencieuse de `~/.claude` : l'utilisateur garde la main.
+
+## Tests attendus
+
+- Commandes à jour : aucun avertissement.
+- Commande modifiée ou d'une version antérieure : avertissement avec la commande de correction.
+- Pas de manifeste d'installation (installation ancienne) : comportement défini pendant la
+  préparation, sans plantage.
+
+## Inclus
+
+Friction `4c0cbd8b` (mineur) : juste après une publication, `uv tool install` ne trouve pas la
+version tant que l'index n'est pas rafraîchi. Le `--refresh` documenté ci-dessus la couvre.
+
+## Livraison
+
+La PR augmente la version. Le merge publie automatiquement.

devflow_cli-6.4.0/.specify/specs/033-kks-420-stale-commands-warning/preflight-evidence-result.json

@@ -0,0 +1,55 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-420:standard:preflight-evidence:v3",
+  "status": "completed",
+  "summary": "preflight-evidence.md rédigé. Constats : compare_manifests (lecture seule) renvoie current / outdated / modified / unknown selon les scénarios attendus pour les 6 commandes devflow*.md, et renvoie new pour toutes les commandes quand aucune n'est installée. Un manifeste corrompu ne provoque pas de plantage. `devflow status` ne signale rien aujourd'hui. README.md:21 et CONTRIBUTING.md:130 ne mentionnent ni `--refresh` ni `devflow upgrade`. La version de départ 6.3.1 est concordante. Les 29 tests de référence passent.",
+  "changedFiles": [
+    ".specify/specs/033-kks-420-stale-commands-warning/preflight-evidence.md"
+  ],
+  "checks": [
+    {
+      "id": "baseline-targeted-tests",
+      "command": "uv run pytest -q tests/test_cmd_status.py tests/test_cmd_upgrade.py tests/test_manifest.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "manifest-scenarios-probe",
+      "command": "uv run python <scratchpad>/probe.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "status-current-output",
+      "command": "uv run devflow status KKS-420",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [
+    {
+      "id": "manifest-statuses",
+      "outcome": "passed",
+      "report": "Simulation dans un CLAUDE_DIR temporaire : à jour → current ; version antérieure → outdated ; modification locale → modified ; sans manifeste identique → current ; sans manifeste différent → unknown ; aucune commande → new ; manifeste corrompu → warn, sans plantage. Aucune écriture dans CLAUDE_DIR."
+    },
+    {
+      "id": "no-current-warning",
+      "outcome": "passed",
+      "report": "`devflow status KKS-420` sort en code 0 et sa sortie ne contient pas `upgrade` : aucun signal n'existe aujourd'hui."
+    },
+    {
+      "id": "doc-gap",
+      "outcome": "passed",
+      "report": "README.md:21 et CONTRIBUTING.md:130 indiquent `uv tool install devflow-cli==X.Y.Z`, sans --refresh ni devflow upgrade."
+    }
+  ],
+  "remainingRisks": [
+    "Une commande ajoutée dans une nouvelle version (statut new alors que d'autres commandes devflow sont installées) n'est pas signalée par le filtre outdated/modified/unknown ; need.md ne tranche pas ce cas.",
+    "L'avertissement est limité à `devflow status` : un appel direct à `adaptive run` ne le montre pas.",
+    "_show_feature a plusieurs sorties anticipées : l'avertissement doit être placé avant elles.",
+    "Sans manifeste, unknown ne distingue pas une modification locale d'une version antérieure : le message doit rester neutre.",
+    "Le ~/.claude réel n'a pas été comparé : l'état du poste n'est pas constaté.",
+    "La suite complète, docs-sync et check_release n'ont pas été lancés ; ils relèvent de verify."
+  ],
+  "blockers": []
+}