devflow-cli 7.0.0__tar.gz → 7.1.0__tar.gz

devflow_cli-7.1.0/.specify/memory/constitution.md

@@ -0,0 +1,144 @@
+# Constitution — Devflow
+
+**Version** : 2.0.0
+**Date de ratification** : 2026-03-15
+**Dernière modification** : 2026-09-30
+
+---
+
+## Préambule
+
+Devflow est un outil personnel qui pilote des agents de code avec un niveau de rigueur
+proportionné à ce qui est touché. Il produit lui-même les preuves qui font avancer un parcours.
+
+Cette constitution porte des principes, pas des mécanismes. Elle ne décrit ni route, ni fichier
+d'état, ni commande : ces éléments vivent dans le code et dans les documents de décision
+versionnés (`docs/*-decisions.md`, `docs/adr/`).
+
+## Principes fondamentaux
+
+### Article I — Une gate s'ouvre sur un fait, jamais sur une déclaration
+
+Ce qui fait avancer un parcours est enregistré par la CLI, avec sa source.
+
+**Rationale** : un agent qui déclare ses propres preuves se contrôle lui-même. Un travail valide
+produit hors de l'agent devait être maquillé pour passer, et un résultat sans provenance pouvait
+être consommé par la mauvaise activité.
+
+**Règles** :
+- MUST : les preuves d'exécution sont produites localement par la CLI, qui lance elle-même les
+  commandes.
+- MUST : tout résultat et toute preuve portent leur source.
+- MUST : ce qui ne vient pas de l'agent entre par une commande qui rejoue les mêmes validateurs
+  et laisse une trace.
+- MUST NOT : faire avancer un parcours en éditant un fichier d'état ou un résultat.
+- MUST NOT : accepter une preuve déclarée à la place d'une preuve exécutée.
+
+### Article II — La rigueur suit le risque, pas la taille
+
+Ce qu'il faut écrire avant de coder et ce qu'il faut contrôler sont deux questions distinctes.
+
+**Rationale** : un correctif de trente lignes sur une liste de commandes autorisées a payé toute
+la chaîne documentaire parce que contrôle et documentation étaient liés. À l'inverse, un gabarit
+partagé par quatre écrans est passé sans revue parce que le lot était petit.
+
+**Règles** :
+- MUST : la profondeur documentaire dépend de l'ampleur et de l'incertitude du changement.
+- MUST : les contrôles dépendent de la sensibilité de ce qui est touché, quelle que soit
+  l'ampleur.
+- MUST : le niveau de rigueur se déduit de signaux explicites, enregistrés et relisibles.
+- MUST NOT : réduire un niveau de rigueur recommandé sans trace, ni retirer un contrôle de
+  sensibilité par une option.
+- MUST NOT : déclarer un signal faux pour obtenir un parcours plus court.
+
+### Article III — Rupture assumée, jamais silencieuse
+
+Devflow préfère refuser un ancien format plutôt que faire cohabiter deux politiques.
+
+**Rationale** : maintenir plusieurs générations de formats a coûté trois lecteurs et deux
+commandes de migration. Un outil personnel gagne plus à rester petit qu'à rester compatible.
+
+**Règles** :
+- MUST : tout changement de format persistant augmente sa version.
+- MUST : un fichier d'une version antérieure est refusé par un message qui dit quoi faire.
+- MUST : toute rupture est consignée dans une décision versionnée, avec la marche à suivre avant
+  mise à jour.
+- MUST NOT : lire partiellement un ancien format, ou le convertir en silence.
+
+### Article IV — Un besoin observé, ou rien
+
+Devflow n'ajoute que ce qu'un usage réel a demandé, et retire ce qui ne sert plus.
+
+**Rationale** : chaque commande, option ou activité ajoutée est lue par l'agent à chaque parcours
+et maintenue à chaque version.
+
+**Règles** :
+- MUST : toute addition est justifiée par une friction consignée ou par une mesure, citée dans
+  sa décision.
+- MUST : ce qui n'a plus d'usage est supprimé, pas conservé par précaution.
+- MUST NOT : ajouter une capacité pour un utilisateur ou un agent hypothétique.
+- MUST NOT : garder une couche de compatibilité pour adoucir une suppression.
+
+### Article V — Chaque friction laisse une trace, chaque trace se referme
+
+Devflow s'améliore à partir de ce qui est observé pendant son usage réel.
+
+**Rationale** : un retour noté à la main s'est perdu, et le même défaut a bloqué deux parcours de
+plus. Les versions majeures sont nées de retours consignés, aucune d'une intuition.
+
+**Règles** :
+- MUST : une friction est consignée au moment où elle se produit, avec la version observée.
+- MUST : chaque parcours, terminé ou abandonné, se clôt par un bilan.
+- MUST : une friction traitée est marquée comme telle, avec la référence de ce qui la traite.
+- MUST NOT : consigner comme friction un refus justifié du travail de l'agent.
+
+## Gates obligatoires
+
+Les gates sont vérifiées avant l'implémentation. Une violation non justifiée est bloquante.
+
+### Gate 1 — Simplicité
+
+| Critère | Règle |
+|---------|-------|
+| Dépendances | Aucune nouvelle sans justification écrite |
+| Abstractions | Le minimum nécessaire : trois lignes similaires valent mieux qu'une abstraction |
+| Compatibilité | Aucune couche de compatibilité, aucun drapeau de fonctionnalité |
+
+### Gate 2 — Patterns existants
+
+| Critère | Règle |
+|---------|-------|
+| Formats persistants | Versionnés et validés à la lecture |
+| Refus | Toujours un message qui dit quoi faire, jamais une trace brute |
+| Nouveaux patterns | Aucun sans justification écrite |
+
+### Gate 3 — Tests
+
+| Critère | Règle |
+|---------|-------|
+| Couverture | Tout comportement de la CLI a un test |
+| Politique | Avant de modifier une règle de décision, figer son comportement actuel dans un test |
+| Isolation | Aucun test n'écrit dans les dossiers personnels du poste ni ne réinstalle l'outil |
+
+## Gouvernance
+
+- **Autorité** : cette constitution prime sur le besoin, la spec, le plan et les tâches. Un écart
+  se déclare dans la table des dérogations, avec sa justification et sa contrepartie.
+- **Versionnement** : MAJOR (principe supprimé ou redéfini) / MINOR (principe ajouté) / PATCH
+  (clarification).
+- **Amendement** : toute modification est justifiée et versionnée.
+- **Règle d'écriture** : un article qui cite une route, un fichier d'état ou une commande est à
+  réécrire.
+
+## Journal des amendements
+
+- **2.0.0** (2026-09-30) : réécriture complète. Les sept principes de la version 1.x décrivaient
+  un moteur disparu. Le principe de rétrocompatibilité est remplacé par l'article III.
+  L'intégration Linear sort des principes.
+
+## Suivi des dérogations
+
+| Date | Article | Dérogation | Justification | Échéance |
+|------|---------|------------|---------------|----------|
+| 2026-09-30 | Article IV | Les adaptateurs Codex et Cursor sont conservés sans usage mesuré | Leur sort se décide après observation | Fin de la période d'observation de dix parcours |
+| 2026-09-30 | Article V | La version observée d'une friction ne peut pas encore être indiquée | L'outil ne le permet pas | Livraison de KKS-430 |

devflow_cli-7.1.0/.specify/specs/035-kks-428-constitution-v2/.gitignore

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

devflow_cli-7.1.0/.specify/specs/035-kks-428-constitution-v2/activity-contract.json

@@ -0,0 +1,161 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-428:quick:implement:v4",
+  "issueId": "KKS-428",
+  "profile": "quick",
+  "guardrails": false,
+  "activity": "implement",
+  "objective": "Remplacer la constitution de Devflow par le texte valide le 2026-09-30 : cinq articles, trois gates, deux derogations ; lot documentaire, version 7.0.1",
+  "featurePath": ".specify/specs/035-kks-428-constitution-v2",
+  "inputs": [
+    ".specify/specs/035-kks-428-constitution-v2/need.md",
+    ".specify/specs/035-kks-428-constitution-v2/assessment.json",
+    ".specify/specs/035-kks-428-constitution-v2/workflow-state.json",
+    ".specify/specs/035-kks-428-constitution-v2/preflight-evidence.md"
+  ],
+  "allowedActions": [
+    "read",
+    "write",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/035-kks-428-constitution-v2/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-7.1.0/.specify/specs/035-kks-428-constitution-v2/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "9548715a-54ba-4fd9-b395-ed5a28c8e18a",
+  "agent": "claude",
+  "activity": "implement",
+  "returnCode": 0,
+  "durationSeconds": 116.985,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 2281,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": true,
+  "worktreeChangedFileCount": 6
+}

devflow_cli-7.1.0/.specify/specs/035-kks-428-constitution-v2/assessment.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": 4,
+  "issueId": "KKS-428",
+  "recommendedProfile": "quick",
+  "selectedProfile": "quick",
+  "confidence": "high",
+  "signals": {
+    "scope": "local",
+    "ambiguity": "low",
+    "risk": "low",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "guardrails": {
+    "active": false,
+    "reasons": []
+  },
+  "reasons": [
+    "le changement est local, clair, peu risque et ne modifie aucun contrat"
+  ],
+  "activities": [
+    "assess",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-check",
+    "diff-inspection"
+  ],
+  "assessedAt": "2026-09-30T17:17:06Z",
+  "summary": "Remplacer la constitution de Devflow par le texte valide le 2026-09-30 : cinq articles, trois gates, deux derogations ; lot documentaire, version 7.0.1"
+}

devflow_cli-7.1.0/.specify/specs/035-kks-428-constitution-v2/evidence/diff-inspection.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-09-30T17:22:52Z",
+  "changedFiles": [
+    ".specify/memory/constitution.md",
+    "CHANGELOG.md",
+    "docs/releases/7.0.1.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.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-7.1.0/.specify/specs/035-kks-428-constitution-v2/evidence/targeted-check.json

@@ -0,0 +1,27 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-check",
+  "outcome": "passed",
+  "startedAt": "2026-09-30T17:21:51Z",
+  "completedAt": "2026-09-30T17:22:52Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [  4%]\n........................................................................ [  8%]\n........................................................................ [ 13%]\n........................................................................ [ 17%]\n........................................................................ [ 21%]\n........................................................................ [ 26%]\n........................................................................ [ 30%]\n........................................................................ [ 34%]\n........................................................................ [ 39%]\n........................................................................ [ 43%]\n........................................................................ [ 48%]\n........................................................................ [ 52%]\n........................................................................ [ 56%]\n........................................................................ [ 61%]\n........................................................................ [ 65%]\n........................................................................ [ 69%]\n........................................................................ [ 74%]\n........................................................................ [ 78%]\n........................................................................ [ 83%]\n........................................................................ [ 87%]\n........................................................................ [ 91%]\n........................................................................ [ 96%]\n................................................................         [100%]\n1648 passed in 59.99s\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-7.1.0/.specify/specs/035-kks-428-constitution-v2/implement-result.json

@@ -0,0 +1,70 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-428:quick:implement:v4",
+  "status": "completed",
+  "summary": "Constitution remplacée intégralement par le bloc validé de need.md (version 2.0.0 : cinq articles, trois gates, gouvernance, journal des amendements, deux dérogations ; en-tête Sync Impact Report supprimé, texte identique octet pour octet au bloc de need.md). Version passée à 7.0.1 dans pyproject.toml, src/devflow_cli/__init__.py, uv.lock (uv lock) et CHANGELOG.md ; notes de version créées dans docs/releases/7.0.1.md. Aucun autre code de src/ touché, gabarits inchangés.",
+  "changedFiles": [
+    ".specify/memory/constitution.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "uv.lock",
+    "CHANGELOG.md",
+    "docs/releases/7.0.1.md"
+  ],
+  "checks": [
+    {
+      "id": "forbidden-terms",
+      "command": "! grep -nE 'state\\.json|review-spec|clarify|migrate|STEP_LINEAR_MAPPING' .specify/memory/constitution.md",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "constitution-matches-need",
+      "command": "diff <(awk '/^````markdown$/{f=1;next} /^````$/{f=0} f' .specify/specs/035-kks-428-constitution-v2/need.md) .specify/memory/constitution.md",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "pytest",
+      "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": "check-release",
+      "command": "uv run python scripts/check_release.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "check-release-vs-main",
+      "command": "git show origin/main:pyproject.toml > <scratchpad>/main-pyproject.toml && uv run python scripts/check_release.py --main-pyproject <scratchpad>/main-pyproject.toml",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "templates-unchanged",
+      "command": "git diff --quiet templates/constitution-template.md .specify/templates",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "La CLI globale installée reste en 7.0.0 jusqu'à publication de 7.0.1 au merge ; sans effet fonctionnel (lot documentaire).",
+    "Le texte des notes docs/releases/7.0.1.md et de l'entrée CHANGELOG est rédigé par l'agent (non fourni par need.md) : à relire en verify/review."
+  ],
+  "blockers": []
+}