devflow-cli 6.1.0__tar.gz → 6.1.1__tar.gz

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/.gitignore

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

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/activity-contract.json

@@ -0,0 +1,161 @@
+{
+  "schemaVersion": 3,
+  "contractId": "KKS-411:standard:implement:v3",
+  "issueId": "KKS-411",
+  "profile": "standard",
+  "activity": "implement",
+  "objective": "Observer le dossier de feature meme quand git l'ignore (retour B1)",
+  "featurePath": ".specify/specs/028-kks-411-feature-dir-ignored",
+  "inputs": [
+    ".specify/specs/028-kks-411-feature-dir-ignored/need.md",
+    ".specify/specs/028-kks-411-feature-dir-ignored/assessment.json",
+    ".specify/specs/028-kks-411-feature-dir-ignored/workflow-state.json",
+    ".specify/specs/028-kks-411-feature-dir-ignored/preflight-evidence.md",
+    ".specify/specs/028-kks-411-feature-dir-ignored/prepare-result.json"
+  ],
+  "allowedActions": [
+    "read",
+    "write",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/028-kks-411-feature-dir-ignored/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-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "dc12e7fd-4e0f-464d-a8bd-c114801034c3",
+  "agent": "claude",
+  "activity": "implement",
+  "returnCode": 0,
+  "durationSeconds": 189.276,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 3228,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": true,
+  "worktreeChangedFileCount": 6
+}

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/assessment.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 3,
+  "issueId": "KKS-411",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "medium",
+  "signals": {
+    "scope": "multiple",
+    "ambiguity": "low",
+    "risk": "medium",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "reasons": [
+    "plusieurs composants sont affectes",
+    "le risque d'impact est modere"
+  ],
+  "activities": [
+    "assess",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection"
+  ],
+  "assessedAt": "2026-09-28T18:11:52Z",
+  "summary": "Observer le dossier de feature meme quand git l'ignore (retour B1)"
+}

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/evidence/diff-inspection.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-09-28T18:48:40Z",
+  "changedFiles": [
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/core/adaptive_runner.py",
+    "src/devflow_cli/core/remediation.py",
+    "src/devflow_cli/core/worktree_snapshot.py",
+    "tests/test_cmd_adaptive.py",
+    "tests/test_worktree_snapshot.py"
+  ],
+  "findings": [],
+  "gitDiffCheck": {
+    "id": "AUTO-DIFF",
+    "command": [
+      "git",
+      "diff",
+      "--check"
+    ],
+    "blocking": true,
+    "returncode": 0,
+    "succeeded": true,
+    "timedOut": false,
+    "workingDirectory": ".",
+    "stdout": "",
+    "stderr": ""
+  }
+}

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/evidence/regression-check.json

@@ -0,0 +1,97 @@
+{
+  "schemaVersion": 1,
+  "id": "regression-check",
+  "outcome": "passed",
+  "startedAt": "2026-09-28T18:47:16Z",
+  "completedAt": "2026-09-28T18:48:39Z",
+  "commands": [
+    {
+      "id": "AUTO-REGRESSION-PYTHON",
+      "command": [
+        "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_worktree_snapshot.py",
+        "tests/test_adaptive_runner.py",
+        "tests/test_cmd_adaptive.py",
+        "tests/test_remediation.py",
+        "tests/test_automatic_evidence.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 36%]\n........................................................................ [ 73%]\n...................................................                      [100%]\n195 passed in 28.30s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-regression-check",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 10%]\n........................................................................ [ 21%]\n........................................................................ [ 31%]\n........................................................................ [ 42%]\n........................................................................ [ 52%]\n........................................................................ [ 63%]\n........................................................................ [ 73%]\n........................................................................ [ 84%]\n........................................................................ [ 94%]\n.....................................                                    [100%]\n685 passed in 41.67s\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-diff-inspection",
+      "command": [
+        "git",
+        "diff",
+        "--stat"
+      ],
+      "blocking": false,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": " src/devflow_cli/commands/adaptive.py      |  4 +-\n src/devflow_cli/core/adaptive_runner.py   |  4 +-\n src/devflow_cli/core/remediation.py       |  4 +-\n src/devflow_cli/core/worktree_snapshot.py | 34 ++++++++++++++--\n tests/test_cmd_adaptive.py                | 22 +++++++++++\n tests/test_worktree_snapshot.py           | 65 +++++++++++++++++++++++++++++++\n 6 files changed, 124 insertions(+), 9 deletions(-)\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/evidence/targeted-tests.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-tests",
+  "outcome": "passed",
+  "startedAt": "2026-09-28T18:47:16Z",
+  "completedAt": "2026-09-28T18:48:39Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_cmd_adaptive.py",
+        "tests/test_worktree_snapshot.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 84%]\n.............                                                            [100%]\n85 passed in 10.75s\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/implement-result.json

@@ -0,0 +1,42 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-411:standard:implement:v3",
+  "status": "completed",
+  "summary": "snapshot_worktree() accepte désormais un paramètre optionnel feature_dir (None par défaut, comportement strictement identique). Quand il est fourni, la fonction lance aussi `git ls-files --others --ignored --exclude-standard -z -- <sous-arbre de la feature>` et fusionne ces chemins, sauf les traces *.raw.txt. Elle ne fait rien de plus si le dossier est hors de la racine du projet. Le paramètre est passé seulement aux appels qui décident de l'observation d'une activité : commands/adaptive.py (captures avant et après l'agent), adaptive_runner.py (dérive et fiche de tentative) et remediation.py (reprise et _still_modified). automatic_evidence.py n'a pas changé. Six tests unitaires ont été ajoutés dans test_worktree_snapshot.py : dossier ignoré observé, invisible sans paramètre, fichiers ignorés hors feature (y compris une autre feature) toujours invisibles, *.raw.txt écarté, dossier non ignoré inchangé, dossier hors racine sans effet. Un test de bout en bout a été ajouté dans test_cmd_adaptive.py : en profil standard, dans un dépôt qui ignore /.specify/*, prepare puis preflight-evidence passent. Sans le correctif, ce test échoue bien avec artifact-files-mismatch (vérifié en retirant temporairement le changement dans adaptive.py, puis en le restaurant).",
+  "changedFiles": [
+    "src/devflow_cli/core/worktree_snapshot.py",
+    "src/devflow_cli/commands/adaptive.py",
+    "src/devflow_cli/core/adaptive_runner.py",
+    "src/devflow_cli/core/remediation.py",
+    "tests/test_worktree_snapshot.py",
+    "tests/test_cmd_adaptive.py"
+  ],
+  "checks": [
+    {
+      "id": "targeted-tests",
+      "command": "uv run pytest -q tests/test_worktree_snapshot.py tests/test_adaptive_runner.py tests/test_cmd_adaptive.py tests/test_remediation.py tests/test_automatic_evidence.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "regression-check",
+      "command": "uv run pytest -q",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "docs-sync",
+      "command": "uv run devflow docs-sync --check",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [],
+  "remainingRisks": [
+    "Le filtrage des traces repose sur une constante locale, TRACE_SUFFIX = \".raw.txt\", dans worktree_snapshot.py. Elle double la convention de TRACE_IGNORE_RULE (commands/feature.py:41). Elle n'est pas importée pour éviter une dépendance de core vers commands. Si la convention change, les deux doivent évoluer ensemble.",
+    "Dans un dossier de feature ignoré, tout autre fichier ignoré que Devflow écrirait pendant la fenêtre de l'agent (hors *.raw.txt) entrerait dans observed. Le test de bout en bout standard (prepare puis preflight-evidence) n'en montre aucun. Les profils deep et critical (spec, plan, tasks…) n'ont pas été rejoués de bout en bout sur un dossier ignoré.",
+    "Les fiches de tentative enregistrées avant le correctif contiennent des empreintes sans les fichiers ignorés. Leur reprise sur un dépôt qui ignore .specify n'a pas été testée.",
+    "La régression complète (685 tests) a été lancée sous la forme `uv run pytest -q | tail`. Le code de sortie relevé est donc celui du pipe, mais la sortie indique 685 passed et aucun échec."
+  ],
+  "blockers": []
+}

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/need.md

@@ -0,0 +1,38 @@
+# KKS-411 — Observer le dossier de feature même quand git l'ignore
+
+Source : retour B1 de `FEEDBACK.md` (commit `0581823`).
+
+## Problème
+
+`snapshot_worktree()` (`src/devflow_cli/core/worktree_snapshot.py:31`) liste les fichiers non
+suivis avec `git ls-files --others --exclude-standard`, qui écarte les fichiers ignorés. Quand un
+projet ignore `.specify/*` (cas de k-budget, dépôt public), le dossier de la feature est
+invisible : `observed` reste vide et le contrôle de `adaptive_runner.py:490`
+(`declared == [expected] and observed_with_carried == [expected]`) échoue toujours avec
+`artifact-files-mismatch … observes=[]`.
+
+Activités touchées : toutes celles de `DOCUMENT_ARTIFACTS` (risk-assessment, spec, research,
+contracts, plan, tasks, preflight-evidence). Aucun contournement pour les six premières
+(`complete` les refuse, `reconcile` repart d'une empreinte vide). Les profils `deep` et
+`critical` sont bloqués ; `quick` et `standard` ne passent que par un `complete` manuel de
+`preflight-evidence`.
+
+Reproduit : dépôt ignorant `/.specify/*`, écriture de `.specify/specs/KKS-1/spec.md` et `src.py`
+→ `changed_paths()` rend `['src.py']`.
+
+## Attendu
+
+- Les artefacts documentaires écrits dans un dossier de feature ignoré par git sont observés, et
+  l'activité passe.
+- L'ajout est limité au dossier de la feature : `snapshot_worktree()` sert aussi
+  `automatic_evidence.py`, `remediation.py` et `commands/adaptive.py`, dont le comportement ne
+  doit pas changer pour le reste du dépôt.
+- Les fichiers que Devflow écrit lui-même dans ce dossier (`*-result.json`, `*-result.raw.txt`,
+  `worklog.md`…) n'entrent pas dans `observed` au point de casser l'égalité stricte avec
+  `[expected]`. Point d'attention : le `.gitignore` du dossier de feature ignore déjà `*.raw.txt`.
+
+## Tests attendus
+
+- Dossier de feature ignoré : activité documentaire acceptée.
+- Dossier de feature non ignoré : comportement inchangé.
+- Fichiers ignorés hors du dossier de la feature : toujours invisibles.

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/preflight-evidence-result.json

@@ -0,0 +1,53 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-411:standard:preflight-evidence:v3",
+  "status": "completed",
+  "summary": "J'ai rédigé preflight-evidence.md. J'ai reproduit le défaut dans un dépôt jetable qui ignore /.specify/* : changed_paths rend ['src.py'] et l'artefact spec.md n'est pas vu. J'ai aussi validé l'approche : git ls-files --others --ignored --exclude-standard -- <sous-arbre> ne voit que le dossier de la feature, sans les fichiers ignorés ailleurs. Il remonte en revanche *.raw.txt et le .gitignore du dossier, qu'il faudra écarter. J'ai recensé les appelants de snapshot_worktree() et vérifié l'état de référence : tests/test_worktree_snapshot.py passe (8 tests).",
+  "changedFiles": [
+    ".specify/specs/028-kks-411-feature-dir-ignored/preflight-evidence.md"
+  ],
+  "checks": [
+    {
+      "id": "repro-snapshot-ignored-feature",
+      "command": "uv run python scratchpad/repro.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "approach-ls-files-ignored-subtree",
+      "command": "git ls-files --others --ignored --exclude-standard -- .specify/specs/KKS-1",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "baseline-worktree-snapshot",
+      "command": "uv run pytest -q tests/test_worktree_snapshot.py",
+      "exitCode": 0,
+      "status": "passed"
+    }
+  ],
+  "evidence": [
+    {
+      "id": "defect-reproduced",
+      "outcome": "passed",
+      "report": "Dépôt temporaire qui ignore /.specify/*. On écrit .specify/specs/KKS-1/spec.md et src.py. changed_paths(before, after) rend ['src.py'] : le défaut B1 est confirmé."
+    },
+    {
+      "id": "approach-feasible",
+      "outcome": "passed",
+      "report": "ls-files --ignored limité au sous-arbre de la feature liste .gitignore, a.raw.txt et spec.md. build/out, ignoré hors du sous-arbre, n'apparaît pas."
+    },
+    {
+      "id": "baseline",
+      "outcome": "passed",
+      "report": "tests/test_worktree_snapshot.py : 8 tests passent."
+    }
+  ],
+  "remainingRisks": [
+    "Le rejet artifact-files-mismatch de bout en bout n'a pas été rejoué. Il est déduit du code.",
+    "--ignored fait aussi remonter le .gitignore du dossier de feature et les *.raw.txt. Il faut filtrer les traces, et le test de bout en bout doit confirmer que le .gitignore ne compte pas parmi les fichiers modifiés.",
+    "Les fiches de tentative enregistrées avant le correctif ont des empreintes sans les fichiers ignorés. Leur reprise n'a pas été testée.",
+    "La suite complète n'a pas été relancée ici. La référence de 678 tests vient de l'activité prepare."
+  ],
+  "blockers": []
+}

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/preflight-evidence.md

@@ -0,0 +1,100 @@
+# Preflight evidence — KKS-411
+
+Objectif : observer le dossier de feature même quand git l'ignore (retour B1).
+Capture faite le 2026-09-28 sur la branche `028-kks-411-feature-dir-ignored`, HEAD `0581823`, git 2.50.1.
+
+## Faits observés
+
+1. **Défaut reproduit.** Dans un dépôt jetable qui ignore `/.specify/*`, on écrit
+   `.specify/specs/KKS-1/spec.md` et `src.py` entre deux appels à `snapshot_worktree()`.
+   Résultat : `changed_paths` = `['src.py']` et les fichiers de la capture finale = `['src.py']`.
+   L'artefact de feature est invisible. C'est ce qui vide `observed` et déclenche
+   `artifact-files-mismatch` dans le contrôle strict de `adaptive_runner.py` (l. 480-488 :
+   `declared == [expected] and observed_with_carried == [expected]`).
+2. **Cause localisée.** `src/devflow_cli/core/worktree_snapshot.py:31` liste les fichiers non suivis
+   avec `git ls-files --others --exclude-standard -z`, ce qui écarte les fichiers ignorés. Aucun
+   autre appel à `ls-files` n'alimente l'observation.
+3. **Approche validée.** Dans le même type de dépôt jetable, `git ls-files --others --ignored
+   --exclude-standard -- .specify/specs/KKS-1` renvoie les fichiers du sous-arbre de la feature :
+   `.gitignore`, `a.raw.txt`, `spec.md`. Un fichier ignoré hors de ce sous-arbre (`build/out`)
+   n'apparaît pas. La commande standard, elle, n'en liste aucun.
+4. **Traces à filtrer.** L'option `--ignored` fait aussi remonter `*.raw.txt`, que le `.gitignore`
+   du dossier de feature ignore (règle `TRACE_IGNORE_RULE = "*.raw.txt"`,
+   `src/devflow_cli/commands/feature.py:41`). Il faut donc écarter explicitement ces traces.
+5. **Appelants de `snapshot_worktree()`.**
+   - `commands/adaptive.py:380` et `:406`, avant et après l'agent.
+   - `adaptive_runner.py:299` et `:787`.
+   - `remediation.py:211` et `:246`.
+   - `automatic_evidence.py:292`, `:352`, `:559`, `:598` et `:855`.
+
+   Le helper `_feature_subtree()` existe déjà (`automatic_evidence.py:394`).
+6. **État de référence sain.** `tests/test_worktree_snapshot.py` : 8 tests passent. Selon
+   `prepare-result.json`, la suite complète passait aussi (678 tests).
+7. **Dépôt Devflow non concerné.** Ici, `git check-ignore -v` sur le dossier de la feature
+   renvoie 1 (non ignoré). L'activité en cours n'est donc pas bloquée par le défaut.
+
+## Source
+
+- `need.md` et `prepare-result.json` de la feature (cause et plan d'approche).
+- Code lu : `worktree_snapshot.py`, `adaptive_runner.py` (l. 470-495) et
+  `activity_contracts.py` (contraintes de preflight). Les numéros de ligne des appelants viennent
+  de `grep -rn "snapshot_worktree(" src/devflow_cli`.
+- Exécutions locales décrites ci-dessous, faites pendant cette activité.
+
+## Reproductibilité
+
+- Reproduction du défaut : script Python lancé par `uv run python <script>`.
+  1. Il crée un dépôt temporaire avec `.gitignore` = `/.specify/*` et un commit initial.
+  2. Il appelle `snapshot_worktree()`.
+  3. Il écrit `.specify/specs/KKS-1/spec.md` et `src.py`.
+  4. Il rappelle `snapshot_worktree()` puis `changed_paths()`.
+
+  Sortie attendue : `['src.py']`. Code retour 0.
+- Validation de l'approche : dans un dépôt temporaire qui ignore `/.specify/*` et `build/`, lancer
+  `git ls-files --others --ignored --exclude-standard -- .specify/specs/KKS-1`. Sortie attendue :
+  les fichiers du sous-arbre uniquement. Code retour 0.
+- Référence : `uv run pytest -q tests/test_worktree_snapshot.py` (8 passed, code retour 0).
+- Les dépôts temporaires ont été supprimés après usage. Les scripts utilisent une identité git
+  fictive (`t@example.invalid`).
+
+## Périmètre
+
+- À modifier : `snapshot_worktree()`. Ajouter un paramètre optionnel pour le sous-arbre de la
+  feature, `None` par défaut, qui laisse le comportement strictement identique.
+- Ce paramètre sera passé seulement aux appels qui décident de l'observation d'une activité :
+  `commands/adaptive.py`, `adaptive_runner.py` et `remediation.py`. `automatic_evidence.py` garde
+  son comportement, conformément à `need.md`.
+- Hors périmètre :
+  - les fichiers ignorés en dehors du dossier de la feature ;
+  - `worktree_fingerprint()`, qui exclut déjà le dossier de la feature ;
+  - la politique de `.gitignore` des projets cibles.
+- Tests attendus :
+  - dossier de feature ignoré : activité documentaire acceptée ;
+  - dossier non ignoré : comportement inchangé ;
+  - fichiers ignorés hors feature : toujours invisibles ;
+  - `*.raw.txt` écarté.
+
+## Confidentialité
+
+- Aucun secret, jeton ni donnée utilisateur n'a été lu ou recopié.
+- Les preuves portent sur des fichiers fictifs (`spec.md`, `src.py`, `build/out`) dans des dépôts
+  temporaires supprimés.
+- Le filtrage des `*.raw.txt` compte aussi pour la confidentialité : ces traces peuvent contenir
+  le contenu des fichiers lus par l'agent. Elles ne doivent jamais entrer dans `observed` ni
+  dans les empreintes publiées.
+
+## Limites
+
+- La reproduction s'arrête à `snapshot_worktree()` et `changed_paths()`. Le rejet complet
+  `artifact-files-mismatch` d'une activité sur un dépôt comme k-budget n'a pas été rejoué
+  de bout en bout. Il est déduit du code (point 1).
+- Avec `--ignored`, le `.gitignore` propre au dossier de feature apparaît aussi. Il est créé à
+  l'initialisation de la feature, avant la fenêtre d'exécution de l'agent, donc il ne devrait pas
+  compter parmi les fichiers modifiés. Le test de bout en bout devra le confirmer.
+- D'autres fichiers ignorés que Devflow écrirait pendant la fenêtre de l'agent dans le dossier de
+  feature (en dehors de `*.raw.txt`) entreraient dans `observed`. Le code lu n'en montre aucun :
+  point à confirmer par le test de bout en bout.
+- Les fiches de tentative enregistrées avant le correctif ont des empreintes sans les fichiers
+  ignorés. Leur reprise n'a pas été testée.
+- La suite complète n'a pas été relancée pendant cette activité (seul
+  `tests/test_worktree_snapshot.py` l'a été). La référence de 678 tests vient de l'activité prepare.

devflow_cli-6.1.1/.specify/specs/028-kks-411-feature-dir-ignored/prepare-attempt.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "contractId": "KKS-411:standard:prepare:v3",
+  "activity": "prepare",
+  "agent": "claude",
+  "reason": "agent-failed",
+  "recordedAt": "2026-09-28T18:12:01Z",
+  "head": "0581823aaacd30b62072a84a9fc4c1d3501a820f",
+  "branch": "028-kks-411-feature-dir-ignored",
+  "observedFiles": {},
+  "carriedChangedFiles": [],
+  "rawOutputSha256": "b5fc1eca1ca5a26492f05e2b5162d9f0538bbe1df61665ecfc7ebfa78285ccc9"
+}