devflow-cli 10.1.0__py3-none-any.whl → 10.1.1__py3-none-any.whl

devflow_cli/__init__.py

@@ -1,6 +1,6 @@
 """devflow CLI — workflow de développement adaptatif."""
 
-VERSION = "10.1.0"
+VERSION = "10.1.1"
 
 ACTIVITY_LINEAR_MAPPING = {
     "assess": "Backlog",

devflow_cli/resources/commands/devflow.md

@@ -9,6 +9,9 @@ allowed-tools: Bash(devflow:*)
 Utiliser exclusivement la machine adaptative de la CLI. Ne jamais créer ni
 interpréter de `state.json`.
 
+Avant toute chose, exécuter `devflow check`. En échec, ne pas utiliser
+Devflow : le dire, avec la cause, et traiter la demande hors Devflow.
+
 1. Lire `$ARGUMENTS` et extraire l'identifiant de feature et la cible `--until`
    (`done` par défaut).
 2. Exécuter `devflow status ISSUE_ID`.
@@ -17,7 +20,13 @@ interpréter de `state.json`.
    l'issue) et annoncer la branche et le dossier créés.
 4. Si la feature n'est pas encore évaluée et que `need.md` n'existe pas dans
    son dossier, le rédiger à partir de l'issue et de la demande. En cas de
-   doute sur le besoin, poser la question avant de l'écrire.
+   doute sur le besoin, poser la question avant de l'écrire. Le besoin dit :
+   1. les constats observés, avec leur origine ;
+   2. les décisions prises, non rediscutables pendant le parcours ;
+   3. l'attendu et les tests ;
+   4. la livraison (version, fichiers de version) ;
+   5. le hors périmètre ;
+   6. les contraintes d'exécution.
 5. Si elle n'est pas évaluée, demander les signaux nécessaires puis lancer
    `devflow assess ISSUE_ID` avec des options explicites.
 6. Si elle est évaluée mais non démarrée, lancer
@@ -59,3 +68,6 @@ devflow feedback add --type bilan --issue <ISSUE> --what "…" \
 
 Le contrat produit par Devflow est la seule autorité sur les actions,
 artefacts, validations et preuves de l'activité.
+
+Si le projet a une constitution (`.specify/memory/constitution.md`), la lire
+avant d'implémenter : elle prime sur spec, plan et tâches.

devflow_cli-10.1.1.dist-info/METADATA

@@ -0,0 +1,167 @@
+Metadata-Version: 2.5
+Name: devflow-cli
+Version: 10.1.1
+Summary: Workflow adaptatif pour Claude Code : profils, preuves et contrats d'activité
+Project-URL: Homepage, https://github.com/sopequenoteck/devflow
+Project-URL: Repository, https://github.com/sopequenoteck/devflow
+Author-email: sopequenoteck <sopequeno.tech@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: adaptive,claude-code,cli,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: jsonschema>=4.23
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: hatchling>=1.27; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# devflow
+
+Devflow est un workflow adaptatif pour Claude Code. Il s'adresse au développeur
+qui fait travailler Claude Code sur ses projets et veut une rigueur
+proportionnée au risque : la CLI choisit un profil à partir de signaux
+explicites, confie chaque activité à un agent sous un contrat écrit et ne
+franchit une étape que sur des preuves qu'elle produit elle-même.
+
+Un parcours produit une branche Git et un dossier de feature, un besoin écrit
+(`need.md`), les résultats de chaque activité, des preuves exécutées
+localement (tests, inspection du diff, revue) et un journal des retours
+d'usage (frictions et bilan).
+
+## Installer
+
+Prérequis : Python 3.11+, Git et la CLI `claude` (Claude Code).
+
+```bash
+uv tool install --refresh devflow-cli==X.Y.Z   # version publiée sur PyPI
+devflow init
+devflow check
+```
+
+`devflow init` installe les commandes `/devflow` et `/devflow.status` dans
+`~/.claude` ; `devflow check` vérifie les prérequis. Installer toujours depuis
+PyPI, à une version précise.
+
+Après chaque mise à jour de la CLI, lancer `devflow upgrade` : il met à jour
+les commandes `/devflow` installées dans `~/.claude`, que l'installation de la
+CLI ne touche pas. Tant qu'elles diffèrent de la CLI, `devflow status` affiche
+un avertissement avec cette commande ; rien n'est modifié sans vous.
+`--refresh` évite qu'`uv` ignore une version tout juste publiée. Juste après
+une publication, l'installation peut échouer pendant une à quatre minutes, le
+temps que l'index se propage : réessayer.
+
+`devflow init` et `devflow upgrade` déplacent les anciennes commandes Claude
+connues vers `~/.claude/.devflow-legacy-backup/` sans toucher aux commandes
+personnalisées.
+
+Une version majeure refuse, sans migration, les parcours démarrés avec une
+version majeure antérieure : terminez-les avant la mise à jour, voir les notes
+de version du dépôt.
+
+## Premier parcours
+
+Une feature avec un identifiant d'issue passe par Devflow ; un correctif
+ponctuel ou une tâche hors feature, non.
+
+Avec Claude Code :
+
+```text
+/devflow KS-123
+```
+
+La commande crée la feature, rédige `need.md`, demande les signaux de
+l'évaluation puis enchaîne les activités jusqu'à `done`.
+
+À la main :
+
+```bash
+devflow feature KS-123 --short-name user-auth
+# Décrire le besoin dans need.md, dans le dossier de la feature créé
+devflow assess KS-123 --scope multiple --ambiguity medium --risk medium
+devflow adaptive start KS-123
+devflow adaptive run KS-123
+devflow adaptive status KS-123
+```
+
+Chaque invocation de `adaptive run` traite une activité. `adaptive status`
+affiche la progression, les preuves et la prochaine commande ; `--json` en
+donne une forme exploitable par la CI.
+
+## Décrire le besoin
+
+`need.md` est l'entrée de tout parcours et fait foi pour chaque activité. Le
+besoin dit :
+
+1. les constats observés, avec leur origine ;
+2. les décisions prises, non rediscutables pendant le parcours ;
+3. l'attendu et les tests ;
+4. la livraison (version, fichiers de version) ;
+5. le hors périmètre ;
+6. les contraintes d'exécution.
+
+## Lire un refus
+
+Chaque refus affiche son motif et la commande de reprise recommandée.
+
+- Refus justifié (le travail de l'agent ne satisfait pas l'étape) : corriger
+  le travail, puis reprendre par la commande proposée.
+- Échec de Devflow (refus à tort, message trompeur, reprise inadaptée,
+  prérequis non documenté) : le consigner aussitôt avec
+  `devflow feedback add --type friction`.
+- En fin de parcours, terminé ou abandonné : un bilan avec
+  `devflow feedback add --type bilan`.
+
+## Profils et garde-fous
+
+Le profil fixe la route documentaire :
+
+- `quick` : changement local, clair et peu risqué, sans revue.
+- `standard` : plusieurs composants ou risque modéré ; préparation puis revue
+  systématique.
+- `deep` : changement transversal, ambigu ou contractuel ; `spec`, `plan`,
+  `tasks`, plus `contracts` quand `--contract-change` est déclaré.
+
+Un bloc de garde-fous s'y ajoute quand `--data-security` est déclaré ou que
+`--risk high` : évaluation du risque, contrôle bloquant de sécurité ou de
+données à `verify`, revue indépendante, puis vérification du retour arrière
+avant `done`. Un bloc actif impose au minimum le profil `standard`, ne se
+désactive par aucune option et interdit les dérogations.
+
+La référence complète (routes, preuves, commandes, contrats d'activité) est
+livrée dans le dépôt, sous `docs/`.
+
+## Synchronisation Linear
+
+Si `LINEAR_API_KEY` contient une clé d'API personnelle Linear, la CLI met à jour
+le statut de l'issue du parcours au démarrage de chaque activité (`adaptive
+run`, y compris avec `--until`, et clôture `done`). L'équipe Linear doit avoir
+les statuts `Backlog`, `Design`, `In Progress`, `Review` et `Done`. Un statut
+n'est jamais ramené en arrière ; un statut hors de cette liste (`Canceled`,
+`Duplicate`) n'est jamais modifié.
+
+Sans clé, ou si Linear échoue (issue inconnue, statut absent, erreur réseau ou
+délai de 5 s dépassé), la CLI affiche un avertissement et le parcours continue
+à l'identique. La clé est retirée de l'environnement de tout processus lancé
+par Devflow (agents, commandes de validation, commandes git) ; elle reste
+lisible par un agent si elle est définie dans un fichier que son shell charge
+(`~/.zshrc`).
+
+## Développement
+
+```bash
+uv sync --extra dev
+uv run pytest -q
+./tests/run-tests.sh
+uv run devflow docs-sync --check
+```

{devflow_cli-10.1.0.dist-info → devflow_cli-10.1.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-devflow_cli/__init__.py,sha256=lZsIKCNGd77qBp7LlFtTmNgqB5liD5Yu1cvqa1NxfYg,871
+devflow_cli/__init__.py,sha256=NAGGk9OBe8YXw8PKPqglUP-Ky2xGiIPf0Ine3TMUXl0,871
 devflow_cli/cli.py,sha256=DVLx3wr1Hulke2qxhgHsEvvprRuO7SVETui_VGPNQv4,1983
 devflow_cli/adapters/__init__.py,sha256=z1J7_YJHcgak2a6dTZpOUKKwf-K7UwRqGzS8XY9duC0,299
 devflow_cli/adapters/agents.py,sha256=-9zmNlFmQfP2pOGxA3_SSKij8ScR76J4-sgv4GMBWEI,18530
@@ -53,11 +53,11 @@ devflow_cli/utils/console.py,sha256=t7cpyeEluWj4v_O_KFSI59iqXK4GiSXPuxlsr8q5zoQ,
 devflow_cli/utils/logging.py,sha256=I7U9_IVvYAFnUAWi7xs5F_WGR0uSz6DmRvZ_B3xLFbs,1769
 devflow_cli/utils/paths.py,sha256=CH81dZZTI2vjgl8mck6QcAChxoBpujmKZ0vVKhKmXEY,8176
 devflow_cli/utils/strings.py,sha256=bfFXCwBDnFxshgZOYfy6mtysnjiaWO1wFnqBf7HLg4o,351
-devflow_cli/resources/commands/devflow.md,sha256=R_8oExTiK2oE5-7YycePFbUeu3tpkyMpsvXVZHAegYM,2899
+devflow_cli/resources/commands/devflow.md,sha256=5MjahTVYXAT_zrjEQmM25KH9s6DbRmyI1TdJCxYlrKk,3464
 devflow_cli/resources/commands/devflow.status.md,sha256=tqjQ1IboU99ztG6C4nunBHGJCvMn3qDqx3AoF4SPjCk,338
 devflow_cli/resources/templates/constitution-template.md,sha256=uSzNuwF-xIRx8cHt9gloynRjNgDGmnN5z2Xck6fCOsI,2102
-devflow_cli-10.1.0.dist-info/METADATA,sha256=Jy6CrWnMaCHJZ_EcSIc42wP0VHJzcUBazJQCwhHx83k,10116
-devflow_cli-10.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-devflow_cli-10.1.0.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
-devflow_cli-10.1.0.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
-devflow_cli-10.1.0.dist-info/RECORD,,
+devflow_cli-10.1.1.dist-info/METADATA,sha256=2J_RNk3Db7cbmZbRZxe_NfLeXFOnXtLde9bIRsOec4I,6501
+devflow_cli-10.1.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+devflow_cli-10.1.1.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
+devflow_cli-10.1.1.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
+devflow_cli-10.1.1.dist-info/RECORD,,

devflow_cli-10.1.0.dist-info/METADATA

@@ -1,212 +0,0 @@
-Metadata-Version: 2.5
-Name: devflow-cli
-Version: 10.1.0
-Summary: Spec-Driven Development workflow CLI
-Project-URL: Homepage, https://github.com/sopequenoteck/devflow
-Project-URL: Repository, https://github.com/sopequenoteck/devflow
-Author-email: sopequenoteck <sopequeno.tech@gmail.com>
-License: MIT
-License-File: LICENSE
-Keywords: claude-code,cli,development,spec-driven,workflow
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Quality Assurance
-Requires-Python: >=3.11
-Requires-Dist: jsonschema>=4.23
-Requires-Dist: pyyaml>=6
-Requires-Dist: rich>=13
-Requires-Dist: typer>=0.12
-Provides-Extra: dev
-Requires-Dist: hatchling>=1.27; extra == 'dev'
-Requires-Dist: pytest-cov>=5; extra == 'dev'
-Requires-Dist: pytest>=8; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# devflow
-
-Devflow est un moteur de développement adaptatif pour Claude Code. Il choisit un niveau de rigueur à partir de signaux explicites, produit
-des contrats d’activité portables et bloque les transitions tant que les
-preuves attendues ne sont pas présentes.
-
-## Profils
-
-Le profil fixe la route documentaire :
-
-- `quick` : changement local, clair et peu risqué, sans revue.
-- `standard` : plusieurs composants ou risque modéré ; préparation puis revue
-  systématique (`implementation-review`).
-- `deep` : changement transversal, ambigu ou contractuel ; `spec`, `plan`,
-  `tasks`, plus `contracts` quand `--contract-change` est déclaré.
-
-Un bloc de garde-fous s'y ajoute quand `--data-security` est déclaré ou que
-`--risk high` : `risk-assessment` après l'évaluation, validation bloquante de
-sécurité ou de données dans le plan de validation (une validation protégée non
-bloquante est refusée dès `prepare` ou `plan`), preuve
-`security-or-data-check` produite par `verify`, revue `independent-review`,
-puis `rollback-check` avec `rollback-plan`. Un bloc actif impose au minimum le
-profil `standard`, ne se désactive par aucune option et interdit les
-dérogations.
-
-Les routes exactes et leurs preuves sont générées dans
-[docs/pipeline-reference.generated.md](docs/pipeline-reference.generated.md).
-
-## Installation
-
-```bash
-uv tool install --refresh devflow-cli==X.Y.Z   # version publiée, voir CHANGELOG.md
-devflow init
-```
-
-Après chaque mise à jour de la CLI, lancer `devflow upgrade` : il met à jour
-les commandes `/devflow` installées dans `~/.claude`, que l'installation de la
-CLI ne touche pas. `--refresh` évite qu'`uv` ignore une version tout juste
-publiée. Juste après une publication, l'installation peut échouer pendant une
-à quatre minutes, le temps que l'index se propage : réessayer. Tant que les commandes installées diffèrent de la CLI,
-`devflow status` affiche un avertissement avec cette commande ; rien n'est
-modifié sans vous.
-
-Installer toujours depuis PyPI, à une version précise, jamais depuis le
-dossier du dépôt. Les versions publiées sont listées dans
-[CHANGELOG.md](CHANGELOG.md).
-
-Python 3.11+ et Git sont requis.
-
-## Parcours quotidien
-
-```bash
-devflow feature KS-123 --short-name user-auth
-# Décrire le besoin dans need.md, dans le dossier de la feature créé
-devflow assess KS-123 --scope multiple --ambiguity medium --risk medium
-devflow adaptive start KS-123
-devflow adaptive run KS-123
-devflow adaptive status KS-123
-```
-
-`adaptive status --json` fournit un état exploitable par la CI. Les échecs
-distinguent explicitement blocage métier, contrat invalide, panne agent,
-validation échouée et conflit concurrent ; chaque refus affiche la commande de
-reprise recommandée. Après un refus de `verify`, cette reprise dépend du motif :
-approbations à donner, environnement à corriger, ou trois voies après un
-contrôle échoué (rouvrir `implement` si le code est en cause, rouvrir `prepare`
-ou `plan` si la validation l'est, relancer `verify` après un échec passager).
-En `quick`, un lot purement documentaire (`README.md`, Markdown sous `docs/`)
-sans contrôle détecté franchit `verify` sur l'inspection du diff.
-
-Un plan de `prepare` ou de `plan` refusé par les validateurs se corrige sans
-relancer l'agent : `devflow adaptive reconcile KS-123 --result FICHIER.json
---reason MOTIF` rejoue les mêmes validateurs et trace la correction. Les
-validations qui attendent une approbation (`devflow adaptive approve-command`)
-sont listées en une fois à la fin du plan et au début de `verify`. Pendant
-qu'un agent travaille, les commandes humaines qui modifieraient l'état sont
-refusées sans effet, et un fichier d'exécution modifié par l'agent est remis
-dans son état d'avant l'agent.
-
-L'agent Claude d'une activité est lancé avec
-`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1` : il peut déléguer à des sous-agents,
-mais au premier plan seulement. Effet de bord : il ne peut plus lancer de
-commande shell en arrière-plan (serveur de test, par exemple). Tous les contrats
-demandent en plus que la sortie structurée soit le dernier message de l'agent.
-Si un agent termine sans erreur mais sans sortie structurée, `adaptive run`
-nomme la cause (`structured-output-missing`) et propose
-`devflow adaptive reconcile KS-123 --result MODELE --reason MOTIF` avec un
-modèle de résultat prérempli, écrit dans `~/.devflow/reconcile/` et à compléter.
-
-`need.md` peut être amendé en cours de parcours. Avant une activité
-documentaire, l'amendement est accepté avec un avertissement qui nomme les
-activités déjà closes, à rouvrir si leur résultat en dépend ; avant `prepare`,
-il est accepté sans cet avertissement ; pendant l'exécution d'un agent, il est refusé ;
-avant `implement`, il périme la preuve de pré-vol ; après `implement`, il
-périme une revue déjà faite. Pour arbitrer après un blocage d'`implement` :
-amender `need.md`, puis `devflow adaptive reopen KS-123 preflight-evidence
---reason MOTIF`, refaire le pré-vol et relancer `implement`. Un refus
-d'artefact (`artifact-files-mismatch`) nomme chaque fichier en trop et sa
-cause : retirer ou remettre en état le fichier, puis
-`devflow adaptive reconcile KS-123` ; la relance à l'identique n'est plus
-proposée. Pour une entrée du besoin modifiée par un agent, la relance est
-refusée avant le lancement de l'agent : remettre l'entrée en état, ou
-`devflow adaptive discard-attempt KS-123 --reason MOTIF`, puis
-`devflow adaptive run KS-123`.
-
-Chaque invocation de `adaptive run` traite une activité. La politique est dans
-`assessment.json`; la progression et les preuves sont dans
-`workflow-state.json`. Les résultats agent sont validés par schéma et les
-preuves d’exécution sensibles sont produites localement par Devflow.
-
-Chaque profil exécute `preflight-evidence` avant `implement`. Cette
-activité archive des faits externes reproductibles dans
-`preflight-evidence.md`, sans secret ni donnée utilisateur.
-
-`adaptive run` lance toujours Claude Code, sans option d'agent.
-
-## Features créées avant devflow 9
-
-Devflow 9 refuse, sans migration, un dossier de feature dont la racine contient
-un `*-result.json` de `schemaVersion` 1 ou un `*-attempt.json` de schéma 2 ou
-moins (parcours démarré avec devflow 8.x). Terminez les parcours en cours avec
-devflow 8.5.1, ou gardez la CLI épinglée :
-`uv tool install devflow-cli==8.5.1`. Voir les
-[notes de version 9.0.0](docs/releases/9.0.0.md).
-
-## Features créées avant devflow 8
-
-Devflow 8 refuse, sans migration, un `workflow-state.json` (schéma 5) produit
-par devflow 7.x. Terminez les parcours en cours avec devflow 7.x, ou gardez la
-CLI épinglée : `uv tool install 'devflow-cli<8'`. Voir les
-[notes de version 8.0.0](docs/releases/8.0.0.md).
-
-## Features créées avant devflow 7
-
-Devflow 7 refuse, sans migration, un `assessment.json` (schéma 3) ou un
-`workflow-state.json` (schéma 4) produit par devflow 6.x, avec un message qui
-nomme le fichier. Avant la mise à jour, terminez les parcours en cours avec
-devflow 6.x, ou gardez la CLI épinglée :
-`uv tool install 'devflow-cli<7'`. Voir
-[ADR-0003](docs/adr/0003-v7-guardrails-rupture.md) et les
-[notes de version 7.0.0](docs/releases/7.0.0.md).
-
-## Features créées avant devflow 5
-
-Devflow 5 ne lit que ses propres schémas et ne fournit aucune migration : un
-`assessment.json`, un `workflow-state.json` ou un `state.json` créé par une
-version antérieure est refusé. Terminez ces features avec devflow 4.x avant la
-mise à jour. Voir [ADR-0002](docs/adr/0002-v5-rupture-and-provenance.md).
-
-`devflow init` et `devflow upgrade` déplacent également les anciennes commandes
-Claude connues vers `~/.claude/.devflow-legacy-backup/` sans toucher aux
-commandes personnalisées.
-
-## Synchronisation Linear
-
-Si `LINEAR_API_KEY` contient une clé d'API personnelle Linear, la CLI met à jour
-le statut de l'issue du parcours au démarrage de chaque activité (`adaptive
-run`, y compris avec `--until`, et clôture `done`). L'équipe Linear doit avoir
-les statuts `Backlog`, `Design`, `In Progress`, `Review` et `Done`. Un statut
-n'est jamais ramené en arrière ; un statut hors de cette liste (`Canceled`,
-`Duplicate`) n'est jamais modifié.
-
-Sans clé, ou si Linear échoue (issue inconnue, statut absent, erreur réseau ou
-délai de 5 s dépassé), la CLI affiche un avertissement et le parcours continue
-à l'identique. La clé est retirée de l'environnement de tout processus lancé
-par Devflow (agents, commandes de validation, commandes git) ; elle reste
-lisible par un agent si elle est définie dans un fichier que son shell charge (`~/.zshrc`). Détails :
-[Référence CLI](docs/cli-reference.md#synchronisation-linear).
-
-## Documentation
-
-- [Workflow adaptatif](docs/pipeline.md)
-- [Référence CLI](docs/cli-reference.md)
-- [Contrats d’activité](docs/activity-contracts.md)
-- [Façade Claude Code](docs/commands-reference.md)
-
-## Développement
-
-```bash
-uv sync --extra dev
-uv run pytest -q
-./tests/run-tests.sh
-uv run devflow docs-sync --check
-```