devflow-cli 10.1.2__tar.gz → 10.2.0__tar.gz

devflow_cli-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/.gitignore

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

devflow_cli-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/activity-contract.json

@@ -0,0 +1,169 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-620:standard:review:v4",
+  "issueId": "KKS-620",
+  "profile": "standard",
+  "guardrails": false,
+  "activity": "review",
+  "objective": "Commande report (lecture agrégée télémétrie, feedback, décisions) et journal decisions.jsonl des terminaisons des commandes adaptatives ; aucun format existant ne change",
+  "featurePath": ".specify/specs/052-kks-620-telemetrie-report-decisions",
+  "inputs": [
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/need.md",
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/assessment.json",
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/workflow-state.json",
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/prepare-result.json",
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/implement-result.json",
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/evidence/targeted-tests.json",
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/evidence/regression-check.json",
+    ".specify/specs/052-kks-620-telemetrie-report-decisions/evidence/diff-inspection.json"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/052-kks-620-telemetrie-report-decisions/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.",
+    "Si des sous-agents sont utilises, les lancer au premier plan, jamais en arriere-plan, et attendre qu'ils soient tous termines avant la sortie structuree. La sortie structuree du contrat est le dernier message de l'agent : ne rien envoyer apres elle.",
+    "Ne modifier aucun fichier pendant la review.",
+    "Examiner le besoin, le resultat de preparation, 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."
+  ],
+  "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."
+  ],
+  "requiredEvidence": [
+    "implementation-review"
+  ],
+  "expectedOutput": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://devflow.dev/schemas/activity-result/v2",
+    "title": "Devflow Activity Result v2",
+    "type": "object",
+    "required": [
+      "schemaVersion",
+      "contractId",
+      "status",
+      "summary",
+      "changedFiles",
+      "checks",
+      "evidence",
+      "remainingRisks",
+      "blockers"
+    ],
+    "properties": {
+      "schemaVersion": {
+        "type": "integer",
+        "const": 2
+      },
+      "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-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "f197013c-4819-4554-aedb-49d31e4a3f47",
+  "agent": "claude",
+  "activity": "review",
+  "returnCode": 0,
+  "durationSeconds": 92.086,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 5664,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": false,
+  "worktreeChangedFileCount": 0
+}

devflow_cli-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/assessment.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 4,
+  "issueId": "KKS-620",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "medium",
+  "signals": {
+    "scope": "local",
+    "ambiguity": "medium",
+    "risk": "medium",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "guardrails": {
+    "active": false,
+    "reasons": []
+  },
+  "reasons": [
+    "certaines precisions peuvent etre necessaires",
+    "le risque d'impact est modere"
+  ],
+  "activities": [
+    "assess",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "review",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection",
+    "implementation-review"
+  ],
+  "assessedAt": "2026-10-30T15:28:02Z",
+  "summary": "Commande report (lecture agrégée télémétrie, feedback, décisions) et journal decisions.jsonl des terminaisons des commandes adaptatives ; aucun format existant ne change"
+}

devflow_cli-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/evidence/diff-inspection.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-10-30T16:05:31Z",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "README.md",
+    "docs/cli-reference.md",
+    "docs/releases/10.2.0.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/cli.py",
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/commands/report.py",
+    "src/devflow_cli/core/decisions.py",
+    "tests/conftest.py",
+    "tests/test_cli_surface.py",
+    "tests/test_cmd_adaptive.py",
+    "tests/test_cmd_report.py",
+    "tests/test_decisions.py",
+    "tests/test_telemetry_guard.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-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/evidence/regression-check.json

@@ -0,0 +1,129 @@
+{
+  "schemaVersion": 1,
+  "id": "regression-check",
+  "outcome": "passed",
+  "startedAt": "2026-10-30T15:58:11Z",
+  "completedAt": "2026-10-30T16:05:31Z",
+  "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_decisions.py",
+        "tests/test_cmd_report.py",
+        "tests/test_cmd_adaptive.py",
+        "tests/test_cli_surface.py",
+        "tests/test_cmd_feedback.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 15%]\n........................................................................ [ 31%]\n........................................................................ [ 47%]\n........................................................................ [ 62%]\n........................................................................ [ 78%]\n........................................................................ [ 94%]\n...........................                                              [100%]\n459 passed in 97.10s (0:01:37)\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-release-tests",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_release.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "................................                                         [100%]\n32 passed in 0.33s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-full-suite",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [  2%]\n........................................................................ [  5%]\n........................................................................ [  7%]\n........................................................................ [ 10%]\n........................................................................ [ 12%]\n........................................................................ [ 15%]\n........................................................................ [ 17%]\n........................................................................ [ 20%]\n........................................................................ [ 22%]\n........................................................................ [ 25%]\n........................................................................ [ 27%]\n........................................................................ [ 30%]\n........................................................................ [ 33%]\n........................................................................ [ 35%]\n........................................................................ [ 38%]\n........................................................................ [ 40%]\n........................................................................ [ 43%]\n........................................................................ [ 45%]\n........................................................................ [ 48%]\n........................................................................ [ 50%]\n........................................................................ [ 53%]\n........................................................................ [ 55%]\n........................................................................ [ 58%]\n........................................................................ [ 61%]\n........................................................................ [ 63%]\n........................................................................ [ 66%]\n........................................................................ [ 68%]\n........................................................................ [ 71%]\n........................................................................ [ 73%]\n........................................................................ [ 76%]\n........................................................................ [ 78%]\n........................................................................ [ 81%]\n........................................................................ [ 83%]\n........................................................................ [ 86%]\n........................................................................ [ 89%]\n........................................................................ [ 91%]\n........................................................................ [ 94%]\n........................................................................ [ 96%]\n........................................................................ [ 99%]\n.....................                                                    [100%]\n2829 passed in 229.65s (0:03:49)\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-run-tests-sh",
+      "command": [
+        "./tests/run-tests.sh"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "==============================\n Tests devflow\n==============================\n\n>>> Suite: test-template-variants\n=== Tests create-new-feature.sh --type ===\n-- test_type_brownfield_uses_variant_template\n  [OK]   type brownfield: pas d'avertissement de fallback\n  [OK]   type brownfield: spec.md creee\n  [OK]   type brownfield: contenu du template variant present\n-- test_type_nonexistent_falls_back_to_generic_with_warning\n  [OK]   type nonexistent: avertissement fallback sur stderr\n  [OK]   type nonexistent: spec.md creee malgre le fallback\n  [OK]   type nonexistent: contenu du template generique present\n-- test_without_type_uses_generic_template\n  [OK]   sans --type: pas d'avertissement de fallback\n  [OK]   sans --type: spec.md creee\n  [OK]   sans --type: contenu du template generique present\n-- test_consecutive_features_use_correct_templates (FR-009)\n  [OK]   FR-009: spec brownfield creee (009-*)\n  [OK]   FR-009: spec 009 contient le template brownfield\n  [OK]   FR-009: spec greenfield creee (010-*)\n  [OK]   FR-009: spec 010 contient le template greenfield\n  [OK]   FR-009: spec brownfield ne contient pas le marker greenfield\n\n--- Resultats ---\nTotal: 14 | Passes: 14 | Echoues: 0\nSUCCES\n\n==============================\n Resultats globaux\n==============================\nSuites executees: 1\nTotal tests: 14 | Passes: 14 | Echoues: 0\nSUCCES\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-diff-check",
+      "command": [
+        "git",
+        "diff",
+        "--check"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/evidence/targeted-tests.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-tests",
+  "outcome": "passed",
+  "startedAt": "2026-10-30T15:58:11Z",
+  "completedAt": "2026-10-30T16:05:31Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/conftest.py",
+        "tests/test_cli_surface.py",
+        "tests/test_cmd_adaptive.py",
+        "tests/test_cmd_report.py",
+        "tests/test_decisions.py",
+        "tests/test_telemetry_guard.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 19%]\n........................................................................ [ 39%]\n........................................................................ [ 59%]\n........................................................................ [ 78%]\n........................................................................ [ 98%]\n.....                                                                    [100%]\n365 passed in 105.26s (0:01:45)\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/implement-result.json

@@ -0,0 +1,90 @@
+{
+  "schemaVersion": 2,
+  "contractId": "KKS-620:standard:implement:v4",
+  "status": "completed",
+  "summary": "KKS-620 implémentée en 10.2.0. D2/D3 : nouveau src/devflow_cli/core/decisions.py. Il contient decisions_file() (à côté de telemetry.jsonl), build_decision et read_decisions, plus un gestionnaire de contexte unique decision(command, feature_dir, state, json_output). Ce gestionnaire intercepte typer.Exit et le retour normal, réutilise telemetry_enabled() et append_record() (O_APPEND, 0600) et se contente d'un warn en cas d'OSError, sans changer le code de sortie. Le code de raison est retenu par note_refusal() aux points où il existe déjà : outcome.reason de run, reconcile et verify, unsupported-activity, wrong-activity, agent-running, et tout _print_execution_json en échec, ce qui couvre un futur code JSON sans modification locale. Un refus sans code émis prend le nom de l'ExitCode en kebab-case (blocked, concurrent-change). runId n'est transmis que si un agent a été exécuté et vaut celui de la ligne de télémétrie. Dans adaptive.py, l'enveloppe s'arme après _feature() et les contrôles d'usage : complete, reopen et discard-attempt par `with decision(...), workflow_lock(...)` ; run et reconcile par extraction du corps dans _run_activity et _reconcile_activity, sans réindentation ; verify par un bloc. Les 29 points de refus, les messages et les codes de sortie sont inchangés. Erreurs d'usage, feature introuvable, état invalide ou antérieur : rien n'est écrit. --until écrit une ligne par activité (done via complete). D4 : telemetry.jsonl est inchangé. D1 : nouveau src/devflow_cli/commands/report.py, enregistré dans cli.py, avec --since, --project, --issue et --json. Les cinq sections (profiles, activities, retries, decisions, frictions) sont calculées avec statistics.median, deux décimales, make_table, et strip_controls+escape pour les textes. Le rapport ne lit que les trois journaux. Lancé sur les données réelles, il retrouve les chiffres de C2 : médianes quick 2,04, standard 4,67, deep 18,29, critical 16,33 ; refus implement 12,7 %, prepare 10,3 %, review 8,3 % ; 31 parcours rejoués. D5 : docs/cli-reference.md (commande report et decisions.jsonl), une phrase dans la section « Lire un refus » du README, docs/releases/10.2.0.md, CHANGELOG (Added), version 10.2.0 dans pyproject.toml, __init__.py et uv.lock. Tests : test_decisions.py, test_cmd_report.py, 24 tests ajoutés dans test_cmd_adaptive.py (six commandes en advanced et refused, runId lié à la télémétrie, refus de run avant agent, chaînage, agent-running, erreurs d'usage, interrupteur, échec d'écriture). Garde conftest étendue à core.decisions ; TOP_LEVEL gagne report.",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "README.md",
+    "docs/cli-reference.md",
+    "docs/releases/10.2.0.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "src/devflow_cli/cli.py",
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/commands/report.py",
+    "src/devflow_cli/core/decisions.py",
+    "tests/conftest.py",
+    "tests/test_cli_surface.py",
+    "tests/test_cmd_adaptive.py",
+    "tests/test_cmd_report.py",
+    "tests/test_decisions.py",
+    "tests/test_telemetry_guard.py",
+    "uv.lock"
+  ],
+  "checks": [
+    {
+      "id": "targeted-tests",
+      "command": "uv run pytest -q tests/test_decisions.py tests/test_cmd_report.py tests/test_cmd_adaptive.py tests/test_cli_surface.py tests/test_cmd_feedback.py tests/test_release.py tests/test_version.py tests/test_telemetry_guard.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "full-suite",
+      "command": "uv run pytest -q",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "full-suite-color",
+      "command": "FORCE_COLOR=1 COLUMNS=120 uv run pytest -q",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "run-tests-sh",
+      "command": "./tests/run-tests.sh",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "docs-sync",
+      "command": "uv run devflow docs-sync --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "diff-check",
+      "command": "git diff --check",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [
+    {
+      "id": "suite-results",
+      "outcome": "passed",
+      "report": "Tests ciblés : 515 passed. Suite complète : 2829 passed en 226 s (base prepare : 2780). Sous FORCE_COLOR=1 COLUMNS=120 : 2829 passed. run-tests.sh : 14/14. docs-sync --check OK. git diff --check propre ; les fichiers non suivis créés ont été contrôlés à part (pas d'espace en fin de ligne, un seul saut de ligne final)."
+    },
+    {
+      "id": "real-data-sanity",
+      "outcome": "passed",
+      "report": "devflow report --json, lu sur ~/.devflow en lecture seule, retrouve les valeurs de C2 : profils, taux de refus par activité, 31 parcours rejoués. La section decisions est vide sans erreur, car decisions.jsonl n'existe pas. Après la suite, ~/.devflow/decisions.jsonl est toujours absent : les tests n'ont pas écrit dans le journal réel."
+    }
+  ],
+  "remainingRisks": [
+    "Repli de reason non tranché par need.md : un refus sans code émis (complete, reopen, discard-attempt en échec de gate) est journalisé avec le nom de l'ExitCode en kebab-case (blocked, concurrent-change). Ce choix est documenté dans cli-reference et les notes de version ; il est à valider en review.",
+    "Avec run --until, l'activité done est terminée par complete() : sa ligne porte command='complete' et non 'run'. Ce choix est documenté.",
+    "Rattachement des frictions par le seul champ activity, sans règle « par le texte » (non spécifiée) ; les autres frictions vont dans « sans activité ».",
+    "Le refus de chaînage « non avancée » de _run_until (CONCURRENT_CHANGE, hors de toute commande unitaire) n'écrit pas de ligne propre.",
+    "La façade commands/devflow.md ne mentionne pas report : need.md ne l'exige pas.",
+    "Le JSON de report contient exactement les cinq clés de section, sans schemaVersion, selon la lettre de D1."
+  ],
+  "blockers": [],
+  "observation": {
+    "baseRecordedAt": "2026-10-30T15:38:33Z",
+    "baseHead": "6e3ab6ee4f31e9a0546a9d0c253b919759225996",
+    "observedAt": "2026-10-30T15:57:48Z",
+    "head": "6e3ab6ee4f31e9a0546a9d0c253b919759225996"
+  }
+}

devflow_cli-10.2.0/.specify/specs/052-kks-620-telemetrie-report-decisions/need.md

@@ -0,0 +1,113 @@
+# KKS-620 — Restitution de la télémétrie et journal des décisions de la CLI
+
+Source : issue Linear KKS-620, conception du 2026-10-30 avec Kelly. Questions retenues, dans cet
+ordre : (1) où un parcours coûte, en tokens et en temps agent, par profil et par activité ;
+(2) où la CLI refuse et ce que coûte chaque reprise, avec ou sans agent. Constitution, article IV :
+chaque addition répond à une friction ou à une mesure citée ci-dessous.
+
+## Constats
+
+| # | Constat | Où |
+|---|---|---|
+| C1 | La télémétrie (`~/.devflow/telemetry.jsonl`, 623 lignes, 109 parcours au 2026-10-30) n'est écrite que par `_record_telemetry` dans `adaptive run`, pour une tentative confiée à un agent. Les refus prononcés sans agent (`verify`, `reconcile`, `reopen`, `complete`, `discard-attempt`, et les refus de `run` avant lancement de l'agent) ne laissent aucune trace hors du dossier de feature, ignoré par git. | `src/devflow_cli/commands/adaptive.py` |
+| C2 | Aucune commande ne lit la télémétrie en agrégé. Lue à la main le 2026-10-30 : coût médian par parcours quick 2,0 $, standard 4,7 $, deep 18,3 $, critical 16,3 $ ; total 1 080 $ ; tentatives refusées 72 $ (7 %) ; taux de refus agent implement 13 %, prepare 10 %, review 8 % ; 31 parcours sur 109 ont rejoué au moins une activité. | `telemetry.jsonl` |
+| C3 | Les 7 frictions ouvertes (244c684b, 6c12982a, 0df6465d, 6bc2e985, 224785cf, 3432b3ad, 9b0ac80c) portent toutes sur le coût d'une reprise après un refus de la CLI, et 5 sur `verify` ou `review`. Aucune mesure ne permet aujourd'hui de les prioriser. | `devflow feedback list --status ouvert` |
+| C4 | Les refus sont émis en 29 points de `adaptive.py` (`fail` puis `typer.Exit`, ou `_print_execution_json` avec un code de raison) sans point commun qui les consigne. | `src/devflow_cli/commands/adaptive.py` |
+
+## Décisions (non rediscutables dans ce parcours)
+
+- **D1 — Commande `devflow report`.** Commande de lecture seule, enregistrée dans `cli.py` à côté de
+  `feedback`. Elle lit `telemetry.jsonl`, `feedback.jsonl` et `decisions.jsonl` (D2) via les lecteurs
+  existants (`read_records`, `read_feedback`) et un lecteur de même forme pour D2 ; elle ne lit pas
+  les dossiers de feature. Options : `--since AAAA-MM-JJ` (date UTC incluse, sur `recordedAt`),
+  `--project TEXTE` (sous-chaîne du chemin, comme `feedback list`), `--issue ISSUE_ID`, `--json`.
+  Sections, dans cet ordre, en tables Rich (`make_table`) ou en un objet JSON à une clé par section :
+  1. `profiles` : par profil, nombre de parcours (issues distinctes), coût médian et maximal
+     (`usage.costUsd`, somme par parcours), minutes agent médianes (`durationSeconds`, somme par
+     parcours) ;
+  2. `activities` : par activité, tentatives, refus (`advanced` faux), taux de refus, coût des
+     tentatives refusées ;
+  3. `retries` : parcours ayant au moins deux tentatives sur une même activité, avec le nombre de
+     tentatives supplémentaires et leur coût ;
+  4. `decisions` : par code de refus (`reason`), nombre de refus, part avec agent (ligne de
+     télémétrie liée par `runId`) et sans agent ; par parcours, nombre de décisions et de refus ;
+     délai médian en minutes entre deux décisions consécutives d'un même parcours (approximation
+     du temps de supervision ; la doc dit qu'il se lit en médiane, jamais en moyenne, et qu'une
+     interruption de nuit le gonfle). Section vide, sans erreur, tant que `decisions.jsonl` n'existe
+     pas ;
+  5. `frictions` : frictions ouvertes, groupées par activité quand `--issue` ou le texte permet de
+     la rattacher, sinon « sans activité » ; texte passé par `strip_controls` et `escape` comme
+     dans `feedback list`.
+  Les médianes se calculent avec `statistics.median` ; les montants s'affichent avec deux
+  décimales. Une ligne JSON illisible est ignorée, comme dans les lecteurs existants.
+- **D2 — Journal `~/.devflow/decisions.jsonl`.** Fichier append-only à côté de `telemetry.jsonl`
+  (même `DEVFLOW_HOME`, même interrupteur `DEVFLOW_TELEMETRY=0`, même `append_record` en
+  O_APPEND, mode 0600, même tolérance : une erreur d'écriture produit un `warn` et ne bloque
+  jamais la commande). Une ligne par terminaison des commandes `adaptive run`, `adaptive
+  reconcile`, `adaptive reopen`, `adaptive verify`, `adaptive complete` et `adaptive
+  discard-attempt`, qu'elle avance ou refuse. Champs, tous présents : `schemaVersion` (1),
+  `recordedAt` (UTC, format de la télémétrie), `cliVersion`, `project` (racine du dépôt),
+  `issueId`, `command` (l'un des six noms), `activity` (activité courante au moment de la
+  décision, ou `null`), `outcome` (`advanced` ou `refused`), `reason` (code de refus tel
+  qu'émis, par exemple `diff-inspection-failed`, `reconcile-refused`, `wrong-activity` ; `null`
+  quand `outcome` vaut `advanced`), `runId` (celui de la tentative agent de `adaptive run`, sinon
+  `null`). Aucun texte libre, aucun détail, aucun chemin de fichier autre que `project`. Les
+  erreurs d'usage (`--until` inconnu, `--reason` vide, feature introuvable, format de version
+  antérieur) ne sont pas des décisions et ne sont pas journalisées. Un chaînage `--until` qui
+  traverse plusieurs activités écrit une ligne par activité.
+- **D3 — Un seul point d'émission.** Une fonction unique (`core/decisions.py`) construit et écrit
+  la ligne ; chaque commande de D2 l'appelle à sa terminaison, par un chemin commun (gestionnaire
+  de contexte ou enveloppe de commande) qui intercepte le `typer.Exit` et le code de raison, pour
+  qu'un futur code de refus soit journalisé sans modification locale. Les 29 points de refus de
+  C4 ne sont pas réécrits un par un ; ils continuent d'afficher ce qu'ils affichent.
+- **D4 — Pas d'extension de la télémétrie.** `telemetry.jsonl` garde son schéma 1 et son sens
+  (« une tentative confiée à un agent »). Le lien entre les deux fichiers est `runId`.
+- **D5 — Doc.** `docs/cli-reference.md` : la commande `report` (options, sections, lecture du
+  délai médian) et, dans la section télémétrie, le fichier `decisions.jsonl` (déclencheur,
+  champs, interrupteur). `README.md` : une phrase dans « Lire un refus » ou « Développement »
+  indique que `devflow report` restitue coûts et refus, sans lien vers le dépôt. Note de version
+  `docs/releases/10.2.0.md` : les deux pièces, aucun format existant ne change, retour possible à
+  la 10.1.2 (le fichier `decisions.jsonl` est simplement ignoré).
+
+## Attendu et tests
+
+- `devflow report` sur un `DEVFLOW_HOME` de fixture contenant une télémétrie, un feedback et un
+  journal de décisions construits par le test (jamais les fichiers réels de `~/.devflow`) :
+  chaque section présente ; valeurs vérifiées sur un jeu à deux profils, deux activités, un
+  parcours à reprise, deux refus (un avec `runId`, un sans) ; `--json` renvoie les mêmes valeurs ;
+  `--since`, `--project` et `--issue` filtrent ; `DEVFLOW_HOME` vide donne des sections vides sans
+  erreur ; ligne illisible ignorée ; aucun secret ni contenu de fichier dans la sortie.
+- Journal : pour chacune des six commandes de D2, un test sur une feature de fixture vérifie une
+  ligne `advanced` et une ligne `refused` avec le `reason` attendu (au moins `wrong-activity` pour
+  `verify`, un refus de `reconcile`, un refus de `run` avant agent, un `advanced` de `run` avec
+  `runId` égal à celui de la ligne de télémétrie) ; `DEVFLOW_TELEMETRY=0` n'écrit rien ; une
+  erreur d'écriture (répertoire en lecture seule) produit un `warn` et ne change pas le code de
+  sortie ; les erreurs d'usage n'écrivent rien ; la ligne est valide pour le lecteur
+  (`schemaVersion`, champs tous présents).
+- Aucun test ni aucune activité ne lance un agent réel ni n'appelle Linear ; les tentatives agent
+  sont simulées par les doubles existants de la suite.
+- `tests/test_release.py` vert sur 10.2.0 ; `uv run devflow docs-sync --check` vert ;
+  `./tests/run-tests.sh` vert ; suite complète verte sous `FORCE_COLOR=1` et `COLUMNS=120`.
+- `git diff --check` propre ; chaque fichier se termine par un seul saut de ligne.
+
+## Livraison
+
+- Version **10.2.0** : deux ajouts (une commande, un fichier de journal), aucun format existant ne
+  change de version, aucune rupture. Le contrôle CI exige une version strictement supérieure à
+  celle de `main` (10.1.2). Concordance dans `pyproject.toml`, `src/devflow_cli/__init__.py`,
+  `uv.lock`, `CHANGELOG.md` (section `Added`). Notes dans `docs/releases/10.2.0.md`.
+
+## Hors périmètre
+
+- Friction consignée automatiquement par la CLI ; archivage du dossier de feature au `done`.
+- Question 3 (surdimensionnement des profils : lots deep que standard aurait couverts).
+- Tout changement de `telemetry.jsonl`, `feedback.jsonl`, des schémas de contrat, d'état, de
+  résultat ou du journal de réconciliation.
+- Toute modification des messages de refus existants ou des codes de sortie.
+- Résolution des 7 frictions ouvertes : le rapport sert à les prioriser, pas à les corriger.
+
+## Contraintes d'exécution
+
+- Le parcours est piloté par la CLI 10.1.2 installée.
+- Aucun commit, aucun `git stash`, aucun changement de branche pendant les activités.
+- La sortie structurée du contrat est le dernier message de l'agent.