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

devflow_cli-6.3.0/.specify/specs/031-kks-414/.gitignore

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

devflow_cli-6.3.0/.specify/specs/031-kks-414/activity-contract.json

@@ -0,0 +1,170 @@
+{
+  "schemaVersion": 3,
+  "contractId": "KKS-414:critical:rollback-check:v3",
+  "issueId": "KKS-414",
+  "profile": "critical",
+  "activity": "rollback-check",
+  "objective": "Consigner et exploiter les retours d'usage avec devflow feedback, version CLI dans la télémétrie",
+  "featurePath": ".specify/specs/031-kks-414",
+  "inputs": [
+    ".specify/specs/031-kks-414/need.md",
+    ".specify/specs/031-kks-414/assessment.json",
+    ".specify/specs/031-kks-414/workflow-state.json",
+    ".specify/specs/031-kks-414/risk-assessment.md",
+    ".specify/specs/031-kks-414/spec.md",
+    ".specify/specs/031-kks-414/contracts.md",
+    ".specify/specs/031-kks-414/plan.md",
+    ".specify/specs/031-kks-414/tasks.md",
+    ".specify/specs/031-kks-414/implement-result.json",
+    ".specify/specs/031-kks-414/evidence/requirements-coverage.json",
+    ".specify/specs/031-kks-414/evidence/test-suite.json",
+    ".specify/specs/031-kks-414/evidence/security-or-data-check.json",
+    ".specify/specs/031-kks-414/review-result.json",
+    ".specify/specs/031-kks-414/omission-log.json"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/031-kks-414/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.",
+    "Ne modifier aucun fichier pendant le controle de rollback.",
+    "Verifier une procedure de restauration actionnable, les donnees affectees, les validations post-rollback et les declencheurs.",
+    "Retourner blocked si un effet irreversible ou une inconnue critique empeche un retour arriere fiable.",
+    "Ne produire rollback-plan=passed que si le plan est applicable et verifiable."
+  ],
+  "completionCriteria": [
+    "Le plan de rollback precise les etapes, responsables, donnees et controles.",
+    "Les declencheurs et limites du rollback sont explicites.",
+    "La preuve rollback-plan contient un rapport exploitable."
+  ],
+  "requiredEvidence": [
+    "rollback-plan"
+  ],
+  "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.3.0/.specify/specs/031-kks-414/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "42f85453-a91e-40e4-9d86-114fbf1d044b",
+  "agent": "claude",
+  "activity": "rollback-check",
+  "returnCode": 0,
+  "durationSeconds": 194.845,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 8777,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": false,
+  "worktreeChangedFileCount": 0
+}

devflow_cli-6.3.0/.specify/specs/031-kks-414/assessment.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": 3,
+  "issueId": "KKS-414",
+  "recommendedProfile": "critical",
+  "selectedProfile": "critical",
+  "confidence": "high",
+  "signals": {
+    "scope": "multiple",
+    "ambiguity": "low",
+    "risk": "medium",
+    "contractChange": true,
+    "dataOrSecurity": true
+  },
+  "reasons": [
+    "le changement touche aux donnees ou a la securite"
+  ],
+  "activities": [
+    "assess",
+    "risk-assessment",
+    "spec",
+    "research",
+    "contracts",
+    "plan",
+    "tasks",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "review",
+    "rollback-check",
+    "done"
+  ],
+  "requiredEvidence": [
+    "requirements-coverage",
+    "test-suite",
+    "security-or-data-check",
+    "rollback-plan",
+    "independent-review"
+  ],
+  "assessedAt": "2026-09-29T07:04:10Z",
+  "summary": "Consigner et exploiter les retours d'usage avec devflow feedback, version CLI dans la télémétrie"
+}

devflow_cli-6.3.0/.specify/specs/031-kks-414/attempts/reopen-001/activity-contract.json

@@ -0,0 +1,185 @@
+{
+  "schemaVersion": 3,
+  "contractId": "KKS-414:critical:review:v3",
+  "issueId": "KKS-414",
+  "profile": "critical",
+  "activity": "review",
+  "objective": "Consigner et exploiter les retours d'usage avec devflow feedback, version CLI dans la télémétrie",
+  "featurePath": ".specify/specs/031-kks-414",
+  "inputs": [
+    ".specify/specs/031-kks-414/need.md",
+    ".specify/specs/031-kks-414/assessment.json",
+    ".specify/specs/031-kks-414/workflow-state.json",
+    ".specify/specs/031-kks-414/risk-assessment.md",
+    ".specify/specs/031-kks-414/spec.md",
+    ".specify/specs/031-kks-414/contracts.md",
+    ".specify/specs/031-kks-414/plan.md",
+    ".specify/specs/031-kks-414/tasks.md",
+    ".specify/specs/031-kks-414/implement-result.json",
+    ".specify/specs/031-kks-414/evidence/requirements-coverage.json",
+    ".specify/specs/031-kks-414/evidence/test-suite.json",
+    ".specify/specs/031-kks-414/evidence/security-or-data-check.json",
+    ".specify/specs/031-kks-414/omission-log.json"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/031-kks-414/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.",
+    "Ne modifier aucun fichier pendant la review.",
+    "Examiner les exigences, le plan, les taches, 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.",
+    "Examiner explicitement chaque omission, sa recommandation de risque et son motif audite ; renseigner reviewedOmissions avec toutes les activites examinees avant de conclure passed."
+  ],
+  "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.",
+    "Chaque omission est revue explicitement, sans attenuer les preuves de securite."
+  ],
+  "requiredEvidence": [
+    "independent-review"
+  ],
+  "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",
+      "reviewedOmissions"
+    ],
+    "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"
+        }
+      },
+      "reviewedOmissions": {
+        "type": "array",
+        "uniqueItems": true,
+        "items": {
+          "type": "string",
+          "enum": [
+            "research"
+          ]
+        }
+      }
+    },
+    "additionalProperties": false
+  }
+}

devflow_cli-6.3.0/.specify/specs/031-kks-414/attempts/reopen-001/contracts-result.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-414:critical:contracts:v3",
+  "status": "completed",
+  "summary": "contracts.md fige la surface CLI `devflow feedback`. C1 à C3 couvrent les options des quatre sous-commandes (add, list, resolve, export) et les codes de sortie 0, 1 et 2. C4 et C5 définissent le schéma JSONL de `feedback.jsonl` en schemaVersion 1 : entrée avec projet, runId, frictionIds et coût du bilan, plus un événement `resolution` append-only. C6 liste les fonctions de `core/feedback.py`, dont `sanitize_text`, la lecture tolérante, `normalize_paths` et `neutralize_markdown`. C7 et C8 fixent les filtres et la sortie `--json` de `list` ainsi que le gabarit Markdown de l'export. C9 ajoute le champ `cliVersion` à la télémétrie sans changer TELEMETRY_SCHEMA_VERSION. C10 couvre la consigne `/devflow` et C11 la livraison 6.3.0. Le document contient aussi une table de traçabilité vers FR-001 à FR-018, dix invariants de sécurité avec leur test (I1 à I10), une table de compatibilité et de migration testable, et les écarts assumés par rapport à la spec : filtre `--cli-version`, nom du dossier projet dans le Contexte, suppression des caractères de contrôle avant `redact_text()`. La structure est validée par `validate_artifact('critical-contracts')`.",
+  "changedFiles": [
+    ".specify/specs/031-kks-414/contracts.md"
+  ],
+  "checks": [
+    {
+      "id": "contracts-structure",
+      "command": "uv run python -c \"from pathlib import Path; from devflow_cli.core.validators import validate_artifact; r=validate_artifact('critical-contracts', Path('.specify/specs/031-kks-414/contracts.md')); import sys; sys.exit(0 if r.valid else 1)\"",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [
+    {
+      "id": "contracts-structure",
+      "outcome": "passed",
+      "report": "validate_artifact('critical-contracts') renvoie valid=True sans aucun problème : les sections Contrats, Invariants de sécurité et Compatibilité et migration sont présentes, il n'y a pas de placeholder et la taille minimale est respectée."
+    }
+  ],
+  "remainingRisks": [
+    "Écart assumé avec la spec : le filtre de version s'appelle `--cli-version` et non `--version` (indicatif en D12/US4.2), pour ne pas se confondre avec l'option globale `--version`. Cet écart est à confirmer en plan/review.",
+    "Écart assumé avec la spec : C6.1 supprime les caractères de contrôle avant `redact_text()`, alors que D7 fait l'inverse. Le résultat est identique sans caractère de contrôle et plus sûr sinon.",
+    "Précision de D14 : le Contexte de l'export affiche le nom du dossier projet plutôt que `<projet>`.",
+    "R1 résiduel : les secrets non libellés ne sont pas masqués. Seuls l'aide de `add`, la consigne `/devflow` et la relecture humaine de l'export les couvrent.",
+    "R8 : `runId`, `frictionIds` et le coût reposent sur l'égalité exacte des chemins de projet avec la télémétrie.",
+    "Le préfixe d'identifiant à 8 caractères affiché peut devenir ambigu ; `resolve` le refuse alors avec le code 2."
+  ],
+  "blockers": []
+}

devflow_cli-6.3.0/.specify/specs/031-kks-414/attempts/reopen-001/evidence/diff-inspection.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-09-29T07:31:35Z",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "commands/devflow.md",
+    "docs/cli-reference.md",
+    "docs/releases/6.3.0.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/cli.py",
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/commands/feedback.py",
+    "src/devflow_cli/core/feedback.py",
+    "tests/test_cmd_adaptive.py",
+    "tests/test_cmd_feedback.py",
+    "tests/test_feedback.py",
+    "tests/test_telemetry.py",
+    "uv.lock"
+  ],
+  "findings": [],
+  "gitDiffCheck": {
+    "id": "AUTO-DIFF",
+    "command": [
+      "git",
+      "diff",
+      "--check"
+    ],
+    "blocking": true,
+    "returncode": 0,
+    "succeeded": true,
+    "timedOut": false,
+    "workingDirectory": ".",
+    "stdout": "",
+    "stderr": ""
+  }
+}