devflow-cli 10.0.1__tar.gz → 10.1.0__tar.gz

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/.gitignore

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

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/activity-contract.json

@@ -0,0 +1,163 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-556:quick:implement:v4",
+  "issueId": "KKS-556",
+  "profile": "quick",
+  "guardrails": false,
+  "activity": "implement",
+  "objective": "Niveau 2 du garde-fou de télémétrie des tests limité aux lignes ajoutées par la suite (projet en dossier temporaire). Aucun code CLI modifié. Décisions dans need.md.",
+  "featurePath": ".specify/specs/049-kks-556-telemetry-guard-scope",
+  "inputs": [
+    ".specify/specs/049-kks-556-telemetry-guard-scope/need.md",
+    ".specify/specs/049-kks-556-telemetry-guard-scope/assessment.json",
+    ".specify/specs/049-kks-556-telemetry-guard-scope/workflow-state.json",
+    ".specify/specs/049-kks-556-telemetry-guard-scope/preflight-evidence.md"
+  ],
+  "allowedActions": [
+    "read",
+    "write",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/049-kks-556-telemetry-guard-scope/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.",
+    "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.",
+    "Chaque fichier cree ou modifie se termine par un seul saut de ligne, sans espace en fin de ligne : git diff --check doit etre propre avant la sortie structuree.",
+    "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/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.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "c27afa4d-d0e7-4504-9aae-3b02c5630287",
+  "agent": "claude",
+  "activity": "implement",
+  "returnCode": 0,
+  "durationSeconds": 343.932,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 2711,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": true,
+  "worktreeChangedFileCount": 7
+}

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/assessment.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": 4,
+  "issueId": "KKS-556",
+  "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-10-19T17:54:04Z",
+  "summary": "Niveau 2 du garde-fou de télémétrie des tests limité aux lignes ajoutées par la suite (projet en dossier temporaire). Aucun code CLI modifié. Décisions dans need.md."
+}

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/evidence/diff-inspection.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-10-19T18:07:31Z",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "docs/releases/10.0.2.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "tests/conftest.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.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/evidence/targeted-check.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-check",
+  "outcome": "passed",
+  "startedAt": "2026-10-19T18:07:30Z",
+  "completedAt": "2026-10-19T18:07:31Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/conftest.py",
+        "tests/test_telemetry_guard.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": ".....................                                                    [100%]\n21 passed in 0.12s\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/implement-result.json

@@ -0,0 +1,63 @@
+{
+  "schemaVersion": 2,
+  "contractId": "KKS-556:quick:implement:v4",
+  "status": "completed",
+  "summary": "Le niveau 2 du garde-fou (tests/conftest.py) a été réécrit. pytest_sessionstart note la taille du fichier réel par un stat. pytest_sessionfinish appelle la fonction pure leaked_telemetry_projects(path, size_before), qui lit en lecture seule les octets ajoutés depuis cet offset et renvoie les `project` situés sous un dossier temporaire (pytest-of-, gettempdir() résolu, /tmp résolu). Le message d'échec nomme ces projets. Fichier absent, rétréci ou illisible, ainsi qu'une ligne illisible, non JSON ou sans project : aucun échec. Niveau 1 inchangé ; dans src/, seule la constante VERSION change. 16 tests du niveau 2 ont été ajoutés en tmp_path. Version 10.0.2 concordante dans pyproject.toml, __init__.py, uv.lock et CHANGELOG.md ; notes dans docs/releases/10.0.2.md. Simulation du fait 7 rejouée (scratchpad, HOME isolé) : projet réel ajouté → code 0 ; projet sous pytest-of- → code 1, message qui nomme le projet.",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "docs/releases/10.0.2.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "tests/conftest.py",
+    "tests/test_telemetry_guard.py",
+    "uv.lock"
+  ],
+  "checks": [
+    {
+      "id": "targeted-guard-tests",
+      "command": "uv run pytest -q tests/test_telemetry_guard.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "full-suite",
+      "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": "diff-check",
+      "command": "git diff --check",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "Limites acceptées par need.md : un vrai parcours lancé depuis un projet sous /tmp ou gettempdir() ferait échouer la suite à tort ; une fuite d'un sous-processus dont le project n'est pas sous un dossier temporaire ne serait plus détectée.",
+    "Une ligne en cours d'écriture concurrente au moment de la lecture finale serait illisible, donc ignorée.",
+    "Fichier absent au début puis créé pendant la suite : il est lu depuis l'offset 0 (choix d'implémentation, couvert par un test).",
+    "Le cas « fichier illisible » est testé avec un dossier à la place du fichier, pas avec des permissions retirées (évite les écarts entre CI et root).",
+    "Pendant la suite complète, aucun parcours réel concurrent n'a été observé : la non-régression sur ce cas repose sur les tests unitaires et la simulation du fait 7.",
+    "Résolution de la friction 010a3cd0 à faire après publication vérifiée (hors de cette activité)."
+  ],
+  "blockers": [],
+  "observation": {
+    "baseRecordedAt": "2026-10-19T18:01:23Z",
+    "baseHead": "6daa111a0d6a92f71137822300c88b39b38b6107",
+    "observedAt": "2026-10-19T18:07:08Z",
+    "head": "6daa111a0d6a92f71137822300c88b39b38b6107"
+  }
+}

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/need.md

@@ -0,0 +1,58 @@
+# KKS-556 — Garde-fou de télémétrie des tests : ne signaler que les écritures de la suite
+
+Source : issue Linear KKS-556, conception du 2026-10-19 avec Kelly (option A). Friction
+`010a3cd0` (KKS-554, 10.0.0).
+
+## Problème
+
+Le niveau 2 du garde-fou de télémétrie (`pytest_sessionstart` et `pytest_sessionfinish`,
+`tests/conftest.py`) compare la taille et la date de `~/.devflow/telemetry.jsonl` entre le début
+et la fin de la suite. Toute écriture pendant la suite le déclenche, y compris celle d'un vrai
+parcours Devflow lancé dans un autre dépôt : le 2026-10-19, KKS-552 (kreview) et KKS-481
+(kpanel) ont fait échouer la suite pendant `implement` de KKS-554.
+
+Le niveau 2 existe parce que le niveau 1 (interception de `telemetry_file` dans le processus et
+`DEVFLOW_HOME` temporaire par test) ne voit pas un sous-processus lancé avec un environnement
+explicite sans `DEVFLOW_HOME`. La fuite observée en 8.3.0 se reconnaît à sa ligne : projet sous
+un dossier temporaire de pytest (`…/pytest-of-<user>/pytest-257/test_show0`).
+
+## Décision (non rediscutable dans ce parcours)
+
+- En début de suite, le niveau 2 note la taille du fichier réel (sans le lire).
+- En fin de suite, il lit **en lecture seule** uniquement les octets ajoutés depuis cette taille,
+  ligne par ligne. Il échoue seulement si une ligne JSON lisible porte un champ `project` situé
+  sous un dossier temporaire : le dossier temporaire du système (`tempfile.gettempdir()`, chemin
+  résolu, y compris `/private/var/folders/…` sur macOS et `/tmp`) ou un chemin contenant
+  `pytest-of-`. Le message nomme le ou les projets en cause.
+- Une ligne illisible, non JSON ou sans `project` n'échoue pas la suite. Un fichier absent, qui
+  rétrécit (rotation ou suppression) ou illisible n'échoue pas non plus.
+- Les lignes des parcours réels (projets hors dossier temporaire) sont ignorées.
+- Jamais d'écriture dans `~/.devflow`.
+- Le niveau 1 ne change pas. Aucun code de `src/` ne change.
+
+## Attendu et tests
+
+- Tests du garde-fou dans `tmp_path` (le fichier « réel » simulé par un chemin temporaire passé
+  à la fonction de contrôle, jamais le vrai `~/.devflow`) :
+  - ligne ajoutée avec un projet réel hors dossier temporaire : pas d'échec ;
+  - ligne ajoutée avec un projet sous `pytest-of-…` ou sous le dossier temporaire du système :
+    échec, message qui nomme le projet ;
+  - ligne illisible, fichier absent, fichier rétréci : pas d'échec ;
+  - lignes présentes avant le début de la suite : jamais lues.
+- La logique de décision est une fonction testable séparément du hook pytest.
+- Suite complète verte, `./tests/run-tests.sh` vert, `uv run devflow docs-sync --check` vert.
+
+## Livraison
+
+- Version **10.0.2** : le contrôle CI exige une version strictement supérieure à celle de `main`
+  (10.0.1). Concordance dans `pyproject.toml`, `src/devflow_cli/__init__.py`, `uv.lock`,
+  `CHANGELOG.md` ; notes dans `docs/releases/10.0.2.md` (aucun changement pour l'utilisateur de
+  la CLI, retour à la 10.0.1).
+- Résolution de `010a3cd0` au journal après publication vérifiée.
+
+## Contraintes d'exécution
+
+- Le parcours est piloté par la CLI 10.0.1 installée.
+- Aucun test ni aucune activité ne lance un agent réel, ni n'appelle Linear.
+- 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.

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/preflight-evidence-result.json

@@ -0,0 +1,67 @@
+{
+  "schemaVersion": 2,
+  "contractId": "KKS-556:quick:preflight-evidence:v4",
+  "status": "completed",
+  "summary": "preflight-evidence.md rédigé. Le niveau 2 actuel compare seulement (taille, mtime) du fichier de télémétrie réel. Il échoue sur toute écriture, ce qui est reproduit de deux façons : simulation isolée avec un HOME jetable (code 1 sur une ligne de projet réel) et suite complète réelle (2735 passed, code 1, une ligne kpanel KKS-482 ajoutée pendant la suite). Le champ project (str(project_root)) et le chemin résolu de gettempdir (/private/var/folders/…) sont confirmés. Les 2 lignes de fuite 8.3.0 répondent aux deux critères. Aucun test ne couvre encore le niveau 2. Version 10.0.1 partout, cible 10.0.2.",
+  "changedFiles": [
+    ".specify/specs/049-kks-556-telemetry-guard-scope/preflight-evidence.md"
+  ],
+  "checks": [
+    {
+      "id": "telemetry-guard-tests",
+      "command": "uv run pytest -q tests/test_telemetry_guard.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "level2-false-positive-simulation",
+      "command": "HOME=<scratch>/home DEMO_TELEMETRY=<scratch>/home/.devflow/telemetry.jsonl PYTHONPATH=tests .venv/bin/python -m pytest -q -p conftest -p no:cacheprovider <scratch>/test_demo.py",
+      "exitCode": 1,
+      "status": "failed"
+    },
+    {
+      "id": "full-suite-baseline",
+      "command": "uv run pytest -q",
+      "exitCode": 1,
+      "status": "failed"
+    },
+    {
+      "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"
+    }
+  ],
+  "evidence": [
+    {
+      "id": "level2-false-positive",
+      "outcome": "passed",
+      "report": "Faux positif reproduit : la simulation isolée échoue (code 1, message GARDE-FOU TELEMETRIE) sur une ligne de projet hors dossier temporaire. En réel, la suite complète finit avec 2735 passed et code 1 parce qu'un parcours kpanel concurrent a ajouté une ligne. Le fichier réel n'a pas été modifié par l'activité."
+    },
+    {
+      "id": "telemetry-format",
+      "outcome": "passed",
+      "report": "Fichier réel lu en lecture seule : 414 lignes, 0 illisible, 0 sans project, 2 lignes de fuite 8.3.0 sous <gettempdir>/pytest-of-<user> (chemin en /private/var), 412 hors dossier temporaire. Une comparaison sur le chemin résolu est nécessaire."
+    }
+  ],
+  "remainingRisks": [
+    "La suite complète de référence n'est pas verte tant que le correctif n'est pas en place : un parcours réel concurrent la fait échouer. Ce faux positif est celui que KKS-556 corrige.",
+    "La sortie pytest du run complet n'a pas été conservée. L'attribution du code 1 au niveau 2 repose sur deux éléments : tous les tests passés et une ligne ajoutée pendant la fenêtre de la suite. La simulation déterministe en confirme le mécanisme.",
+    "Un parcours réel lancé depuis un projet sous /tmp ou gettempdir ferait échouer la suite à tort ; ce risque est accepté par need.md.",
+    "Une fuite dont le project n'est pas sous un dossier temporaire ne serait plus détectée.",
+    "Une ligne partiellement écrite au moment de la lecture finale serait ignorée."
+  ],
+  "blockers": [],
+  "observation": {
+    "baseRecordedAt": "2026-10-19T17:54:04Z",
+    "baseHead": "6daa111a0d6a92f71137822300c88b39b38b6107",
+    "observedAt": "2026-10-19T18:01:23Z",
+    "head": "6daa111a0d6a92f71137822300c88b39b38b6107"
+  }
+}

devflow_cli-10.1.0/.specify/specs/049-kks-556-telemetry-guard-scope/preflight-evidence.md

@@ -0,0 +1,157 @@
+# Preflight evidence — KKS-556
+
+Objectif (`need.md`, qui fait foi) : limiter le niveau 2 du garde-fou de télémétrie des tests
+(`tests/conftest.py`) aux octets ajoutés pendant la suite, et n'échouer que si une ligne JSON
+lisible porte un `project` situé sous un dossier temporaire (`tempfile.gettempdir()` résolu,
+`/tmp`, ou chemin contenant `pytest-of-`). Lecture seule, aucune écriture dans `~/.devflow`,
+niveau 1 inchangé, aucun code de `src/` modifié. Logique de décision testable hors du hook.
+Version cible 10.0.2. L'`objective` du contrat résume ce périmètre sans contradiction.
+
+Capture faite le 2026-10-19 (17:55 à 18:00 UTC) sur la branche
+`049-kks-556-telemetry-guard-scope`, HEAD `6daa111`, dépôt en 10.0.1 (`pyproject.toml`,
+`src/devflow_cli/__init__.py` `VERSION`, `uv.lock` : `10.0.1` ; `devflow --version` et
+`uv run --no-sync devflow --version` : `devflow CLI v10.0.1`), macOS (Darwin 27.0.0). Arbre de
+travail : aucun fichier suivi modifié ; seul le dossier de cette feature est non suivi. État du
+parcours (lu, non modifié) : profil `quick` sans garde-fous, activité courante
+`preflight-evidence`, preuves exigées par `verify` : `targeted-check` et `diff-inspection`.
+
+## Faits observés
+
+« Reproduit » : rejoué par exécution pendant cette activité ; « lu » : constaté par lecture du
+code ou des fichiers.
+
+### Niveau 2 actuel
+
+1. **Lu.** `tests/conftest.py:22` : `REAL_TELEMETRY = Path.home() / ".devflow" /
+   "telemetry.jsonl"`, calculé à l'import. `_telemetry_stamp` (`:101-107`) renvoie
+   `(st_size, st_mtime_ns)` par `stat` seul ; `pytest_sessionstart` (`:110-112`) le mémorise
+   dans `_telemetry_before` ; `pytest_sessionfinish` (`:115-133`) échoue la session
+   (`session.exitstatus = TESTS_FAILED`, message `GARDE-FOU TELEMETRIE`) dès que le couple
+   diffère, quelle que soit l'origine de l'écriture. Le message reconnaît déjà la limite (« une
+   écriture légitime de l'utilisateur pendant la suite … fait échouer la suite à tort »).
+2. **Lu.** Le niveau 1 (`guard_real_telemetry`, `:136-163`, et `isolated_devflow_home`,
+   `:92-98`) remplace `telemetry_file` dans `devflow_cli.core.telemetry`, `.feedback` et
+   `.result_template`, et pose un `DEVFLOW_HOME` temporaire par test. Il est hors périmètre.
+3. **Lu.** `tests/test_telemetry_guard.py` ne teste que le niveau 1 (5 tests) ; aucun test ne
+   couvre le niveau 2. `import conftest` y est déjà utilisé : une fonction de décision placée
+   dans `conftest.py` est importable par les tests.
+
+### Format des lignes
+
+4. **Lu.** `src/devflow_cli/commands/adaptive.py:1107-1113` : chaque tentative écrit
+   `"project": str(project_root)` avec `schemaVersion`, `cliVersion`, `issueId`, `activity`…
+   `append_record` (`src/devflow_cli/core/telemetry.py:45-55`) ajoute une ligne JSON terminée
+   par `\n` en une seule écriture `O_APPEND`. Le journal de retours (`feedback`) est un autre
+   fichier (`feedback.jsonl`, `src/devflow_cli/core/feedback.py:53`) : non concerné.
+5. **Reproduit.** Décompte du fichier réel, en lecture seule, sans afficher son contenu :
+   414 lignes au début de l'activité, 0 illisible, 0 sans `project`, 2 avec un `project` sous le
+   dossier temporaire, 412 hors dossier temporaire. Les 2 lignes temporaires sont la fuite
+   connue : `cliVersion` 8.3.0, projet `<gettempdir>/pytest-of-<user>/pytest-257/test_show0`
+   (chemin commençant par `/private/var/…`). Elles répondent aux deux critères (`pytest-of-` et
+   préfixe du dossier temporaire résolu). Lignes antérieures à toute suite : le nouveau niveau 2
+   ne doit jamais les lire.
+6. **Reproduit.** `tempfile.gettempdir()` vaut `/var/folders/…/T`, et son chemin résolu
+   `/private/var/folders/…/T` (sous `uv run` comme hors venv). Le chemin enregistré par la fuite
+   commence par `/private/var` : la comparaison doit se faire sur le chemin résolu, comme le
+   prévoit `need.md`. Les dossiers de pytest sont sous `<gettempdir>/pytest-of-<user>`.
+
+### Faux positif
+
+7. **Reproduit (simulation isolée).** Session pytest lancée avec `HOME` pointé vers un dossier
+   du scratchpad (le `REAL_TELEMETRY` simulé y est alors calculé), `-p conftest` et un test unique
+   qui ajoute directement une ligne `{"schemaVersion": 1, "project":
+   "/Users/someone/Code/other-repo"}` au fichier simulé : `1 passed`, puis message
+   `GARDE-FOU TELEMETRIE … a change pendant la suite`, code de sortie 1. Le fichier réel est resté
+   à 414 lignes. Le niveau 2 actuel échoue donc sur une ligne de projet réel.
+8. **Reproduit (en réel).** `uv run pytest -q` lancé pendant l'activité : `2735 passed in
+   282.21s`, code de sortie 1. Le fichier réel est passé de 414 à 415 lignes ; la ligne ajoutée
+   (`recordedAt` 2026-10-19T17:58:25Z, `cliVersion` 10.0.1, projet `kpanel`, `KKS-482`,
+   `preflight-evidence`) vient d'un parcours réel lancé dans un autre dépôt, hors dossier
+   temporaire, et date de l'intérieur de la fenêtre de la suite (fin à 18:00 UTC environ). Seul le
+   niveau 2 peut produire un code 1 avec tous les tests verts : c'est le même faux positif que la
+   friction `010a3cd0` (KKS-552 et KKS-481 pendant `implement` de KKS-554). Avec la règle de
+   `need.md`, cette ligne serait ignorée et la suite verte.
+9. **Reproduit.** `./tests/run-tests.sh` : code 0. `uv run devflow docs-sync --check` : code 0.
+   `uv run pytest -q tests/test_telemetry_guard.py` : `5 passed`, code 0.
+10. **Reproduit.** `devflow feedback list` affiche `010a3cd0 friction mineur ouvert 10.0.0` ;
+    à résoudre après publication vérifiée, pas pendant ce parcours.
+
+### Livraison
+
+11. **Lu.** Version 10.0.1 dans `pyproject.toml:7`, `src/devflow_cli/__init__.py:3`,
+    `uv.lock:150` ; dernière entrée de `CHANGELOG.md` : `[10.0.1] - 2026-10-19` ;
+    `docs/releases/10.0.1.md` existe, `10.0.2.md` n'existe pas. La cible 10.0.2 est
+    strictement supérieure à `main`.
+
+## Source
+
+- Code : `tests/conftest.py`, `tests/test_telemetry_guard.py`,
+  `src/devflow_cli/core/telemetry.py`, `src/devflow_cli/commands/adaptive.py`,
+  `src/devflow_cli/core/feedback.py`, à HEAD `6daa111`.
+- Fichiers de version : `pyproject.toml`, `src/devflow_cli/__init__.py`, `uv.lock`,
+  `CHANGELOG.md`, `docs/releases/`.
+- Télémétrie réelle `~/.devflow/telemetry.jsonl`, lue en lecture seule pour des décomptes et
+  la caractérisation des lignes temporaires et de la ligne ajoutée (champs non sensibles).
+- Journal de retours via `devflow feedback list` (friction `010a3cd0`).
+- Besoin : `need.md` de cette feature (décision du 2026-10-19 avec Kelly, option A).
+
+## Reproductibilité
+
+- Faits 1 à 4 et 11 : relire les fichiers cités à HEAD `6daa111`.
+- Fait 5 : script Python qui ouvre `~/.devflow/telemetry.jsonl` en lecture, parse chaque ligne
+  et classe le `project` (`"pytest-of-" in project` ou `os.path.realpath(project)` sous
+  `os.path.realpath(tempfile.gettempdir())`, ou préfixe `/tmp/`). Les nombres varient avec les
+  parcours réels ajoutés depuis (415 lignes après le fait 8).
+- Fait 6 : `uv run --no-sync python -c "import tempfile,os;p=tempfile.gettempdir();print(p,
+  os.path.realpath(p))"`.
+- Fait 7 : dans un dossier jetable `S`, créer `S/home/.devflow/telemetry.jsonl` (une ligne) et
+  un `S/test_demo.py` qui ajoute une ligne au chemin passé par `DEMO_TELEMETRY`, puis
+  `HOME=S/home DEMO_TELEMETRY=S/home/.devflow/telemetry.jsonl PYTHONPATH=tests
+  .venv/bin/python -m pytest -q -p conftest -p no:cacheprovider S/test_demo.py` ; attendu :
+  message `GARDE-FOU TELEMETRIE`, code 1. Après correctif, le même essai doit donner code 0, et
+  un `project` sous `pytest-of-…` doit donner code 1.
+- Fait 8 : non reproductible à la demande, car il dépend d'un parcours réel concurrent dans un
+  autre dépôt ; le fait 7 en reproduit le mécanisme de façon déterministe.
+- Faits 9 et 10 : relancer les commandes citées (la suite complète dure environ 5 minutes et
+  peut échouer de la même façon tant que le correctif n'est pas en place).
+
+## Périmètre
+
+- Dans le périmètre : niveau 2 de `tests/conftest.py` (nouvelle fonction de décision pure,
+  appelée par `pytest_sessionfinish`, avec la taille notée par `pytest_sessionstart`), tests du
+  niveau 2 dans `tests/test_telemetry_guard.py` (ou un fichier de test voisin) en `tmp_path`,
+  fichiers de version et notes `docs/releases/10.0.2.md`.
+- Hors périmètre : niveau 1 (`guard_real_telemetry`, `isolated_devflow_home`), tout fichier de
+  `src/`, le format de la télémétrie, le fichier `feedback.jsonl`, la résolution de `010a3cd0`
+  (après publication).
+- Cas à couvrir, d'après `need.md` : ligne ajoutée hors dossier temporaire (pas d'échec) ; sous
+  `pytest-of-…` ou sous le dossier temporaire résolu, y compris `/tmp` (échec nommant le
+  projet) ; ligne illisible, non JSON ou sans `project`, fichier absent, rétréci ou illisible
+  (pas d'échec) ; lignes antérieures jamais lues (lecture à partir de l'offset noté).
+
+## Confidentialité
+
+- Aucun contenu de la télémétrie n'est recopié hors des champs nécessaires et non sensibles
+  (`cliVersion`, `issueId`, `activity`, `recordedAt`, nom de dossier du projet). Les chemins
+  sont masqués (`<gettempdir>`, `<user>`) ; aucun identifiant de session, jeton, quota ni
+  contenu de prompt n'est cité.
+- La simulation (fait 7) a écrit uniquement dans le scratchpad de la session ; `~/.devflow`
+  n'a pas été modifié par cette activité (414 lignes avant et après la simulation ; la 415e
+  ligne vient du parcours kpanel concurrent).
+
+## Limites
+
+- La règle « sous le dossier temporaire » couvre aussi `/tmp` et donc `/private/tmp` : un vrai
+  parcours Devflow lancé depuis un projet sous `/tmp` ou sous `gettempdir()` ferait échouer la
+  suite à tort. Aucun cas de ce type dans les 415 lignes actuelles ; accepté par `need.md`.
+- Une fuite d'un sous-processus dont le `project` n'est pas sous un dossier temporaire ne serait
+  plus détectée ; tous les tests créent leurs projets dans `tmp_path`, mais ce n'est pas imposé
+  mécaniquement.
+- Une ligne en cours d'écriture au moment de la lecture finale (écriture concurrente partielle)
+  serait illisible et donc ignorée ; `append_record` écrit en une seule écriture `O_APPEND`, ce
+  qui rend le cas improbable sans l'exclure.
+- Le fait 8 n'a pas conservé la sortie de pytest : l'attribution du code 1 au niveau 2 repose sur
+  `2735 passed` avec code 1 et sur la ligne ajoutée pendant la fenêtre de la suite, mécanisme
+  confirmé de façon déterministe par le fait 7.
+- La suite complète de référence n'est pas verte en l'état (fait 8) ; elle ne pourra être prouvée
+  verte qu'avec le correctif, ou sans parcours réel concurrent.