devflow-cli 10.0.2__py3-none-any.whl → 10.1.1__py3-none-any.whl

devflow_cli/__init__.py

@@ -1,6 +1,6 @@
 """devflow CLI — workflow de développement adaptatif."""
 
-VERSION = "10.0.2"
+VERSION = "10.1.1"
 
 ACTIVITY_LINEAR_MAPPING = {
     "assess": "Backlog",

devflow_cli/commands/adaptive.py

@@ -367,7 +367,7 @@ def run_adaptive(
                         output_file,
                         permission_mode,
                         "workspace-write"
-                        if "write" in activity_contract.allowedActions
+                        if "execute" in activity_contract.allowedActions
                         else "read-only",
                     )
                 attempt["execution"] = execution
@@ -540,7 +540,10 @@ def reconcile_adaptive(
     reason: Optional[str] = typer.Option(
         None,
         "--reason",
-        help="Motif obligatoire avec --result",
+        help=(
+            "Motif obligatoire avec --result ; seul, il consigne l'artefact corrige "
+            "d'une tentative refusee invalid-artifact"
+        ),
     ),
 ) -> None:
     """Valide sans relancer l'agent le travail d'une tentative agent echouee."""
@@ -561,8 +564,8 @@ def reconcile_adaptive(
         except (OSError, UnicodeDecodeError, json.JSONDecodeError, ValueError) as exc:
             fail(f"Resultat corrige invalide : {exc}")
             raise typer.Exit(int(ExitCode.USAGE)) from exc
-    elif reason is not None:
-        fail("--reason ne peut etre utilise qu'avec --result")
+    elif reason is not None and not reason.strip():
+        fail("--reason ne peut pas etre vide")
         raise typer.Exit(int(ExitCode.USAGE))
 
     missing_output: dict[str, str] = {}
@@ -1577,6 +1580,15 @@ def _print_run_recovery(
             f"    devflow adaptive reconcile {issue_id} --result FICHIER.json --reason MOTIF"
             "  # corriger la reponse refusee sans relancer l'agent"
         )
+    if reason == "invalid-artifact" and activity in DOCUMENT_ARTIFACTS:
+        console.print(
+            "    Corriger l'artefact refuse (aucun autre fichier), puis :"
+        )
+        console.print(
+            f"    devflow adaptive reconcile {issue_id} --reason MOTIF"
+            "  # consigner la correction sans relancer l'agent",
+            markup=False, soft_wrap=True,
+        )
     if reason == "agent-failed":
         console.print(f"    devflow adaptive reconcile {issue_id}  # si la trace contient une reponse finale")
         _print_check_command("  # verifier l'agent")

devflow_cli/core/adaptive_runner.py

@@ -64,7 +64,10 @@ from devflow_cli.core.adaptive_workflow import (
 )
 from devflow_cli.adapters.agents import SUPPORTED_AGENT_NAMES
 from devflow_cli.core.assessment import read_assessment
-from devflow_cli.core.contract_schemas import ATTEMPT_SCHEMA_VERSION
+from devflow_cli.core.contract_schemas import (
+    ATTEMPT_SCHEMA_VERSION,
+    validate_contract_payload,
+)
 from devflow_cli.core.worklog import safe_refresh_worklog
 from devflow_cli.core.traceability import analyze_traceability
 from devflow_cli.core.validators import validate_artifact
@@ -407,6 +410,12 @@ def reconcile_current_activity(
                     f"adaptive run {shlex.quote(state.issueId)}"
                 )
             attempt_reason = attempt["reason"]
+            if (
+                corrected_payload is None
+                and correction_reason.strip()
+                and (attempt_reason != "invalid-artifact" or activity not in DOCUMENT_ARTIFACTS)
+            ):
+                raise ValueError(REASON_WITHOUT_RESULT_MESSAGE)
             observed_files = attempt["observedFiles"]
             execution_files = attempt["executionFiles"]
             imputed = imputed_inputs(
@@ -446,21 +455,47 @@ def reconcile_current_activity(
                 raise ValueError("HEAD ou la branche a change depuis la tentative")
             # N6 : pour une activite documentaire, un fichier de la fiche autre que
             # l'artefact peut etre revenu a son etat de base (fichier en trop retire).
-            artifact = (
-                f"{feature_path}/{DOCUMENT_ARTIFACTS[activity]}"
+            artifact_name = (
+                document_artifact_name(activity, reopened=contract_is_reopened_plan(contract))
                 if activity in DOCUMENT_ARTIFACTS
                 else None
             )
+            artifact = f"{feature_path}/{artifact_name}" if artifact_name else None
             drifted = sorted(
                 path
                 for path in set(observed_files) | set(since_base)
                 if observed_files.get(path) != since_base.get(path)
                 and (artifact is None or path == artifact or path in since_base)
             )
-            if drifted:
+            # D2 : l'artefact refuse (invalid-artifact) puis corrige a la main est la
+            # seule derive acceptee, sous --reason et si le validateur de run l'accepte.
+            artifact_correction = (
+                corrected_payload is None
+                and artifact is not None
+                and attempt_reason == "invalid-artifact"
+                and drifted == [artifact]
+                and since_base.get(artifact) is not None
+                and (feature_dir / artifact_name).is_file()
+            )
+            if artifact_correction:
+                if not correction_reason.strip():
+                    raise ValueError(
+                        "artefact corrige depuis la tentative : --reason est obligatoire "
+                        "pour consigner la correction"
+                    )
+                artifact_error = _artifact_validation_error(
+                    feature_dir, activity, artifact_name
+                )
+                if artifact_error is not None:
+                    return AdaptiveRunOutcome(
+                        "invalid-artifact", activity, activity, artifact_error
+                    )
+            elif drifted:
                 raise ValueError(
                     "fichiers modifies depuis la tentative : " + ", ".join(drifted)
                 )
+            elif corrected_payload is None and correction_reason.strip():
+                raise ValueError(REASON_WITHOUT_RESULT_MESSAGE)
             raw_output = activity_raw_file(feature_dir, activity).read_text(encoding="utf-8")
             if _sha256(raw_output) != attempt["rawOutputSha256"]:
                 raise ValueError("trace brute modifiee depuis la tentative")
@@ -477,6 +512,28 @@ def reconcile_current_activity(
                 state,
                 during_execution=[*observed_files, *execution_files],
             )
+            if artifact_correction:
+                if recovery_error:
+                    return AdaptiveRunOutcome(
+                        "invalid-result", activity, activity, recovery_error
+                    )
+                result_error = _validation_error(
+                    feature_dir, contract, recovered, sorted(observation.sinceBase)
+                )
+                if result_error is not None:
+                    return AdaptiveRunOutcome(
+                        "invalid-result", activity, activity, result_error
+                    )
+                _record_artifact_correction(
+                    feature_dir,
+                    state.issueId,
+                    contract,
+                    artifact,
+                    observed_files.get(artifact),
+                    since_base[artifact],
+                    correction_reason,
+                    correction_author,
+                )
             if corrected_payload is not None:
                 observed = sorted(observation.sinceBase)
                 agent_payload = (
@@ -665,21 +722,11 @@ def _apply_activity_result(
         artifact_name = document_artifact_name(
             contract.activity, reopened=contract_is_reopened_plan(contract)
         )
-        if artifact_name == "preflight-evidence.md":
-            try:
-                validate_preflight_evidence(feature_dir / artifact_name)
-            except ValueError as exc:
-                return refuse("invalid-artifact", str(exc))
-            validation = None
-        else:
-            validation = validate_artifact(
-                contract.activity, feature_dir / artifact_name
-            )
-        if validation is not None and not validation.valid:
-            return refuse(
-                "invalid-artifact",
-                "; ".join(issue.message for issue in validation.issues),
-            )
+        artifact_error = _artifact_validation_error(
+            feature_dir, contract.activity, artifact_name
+        )
+        if artifact_error is not None:
+            return refuse("invalid-artifact", artifact_error)
         if contract.activity == "tasks":
             try:
                 traceability = analyze_traceability(
@@ -846,6 +893,22 @@ def _validated_result(
     return result
 
 
+def _artifact_validation_error(
+    feature_dir: Path, activity: str, artifact_name: str
+) -> str | None:
+    """Motif de refus d'un artefact documentaire, le meme pour run et reconcile."""
+    if artifact_name == "preflight-evidence.md":
+        try:
+            validate_preflight_evidence(feature_dir / artifact_name)
+        except ValueError as exc:
+            return str(exc)
+        return None
+    validation = validate_artifact(activity, feature_dir / artifact_name)
+    if validation.valid:
+        return None
+    return "; ".join(issue.message for issue in validation.issues)
+
+
 def _validation_error(
     feature_dir: Path,
     contract: ActivityContract,
@@ -1045,14 +1108,68 @@ def _sha256(content: str) -> str:
     return hashlib.sha256(content.encode("utf-8")).hexdigest()
 
 
-# Schema 2 : entrees avec source, agentPayloadSha256 et changedFields (KKS-509).
-RECONCILE_LOG_SCHEMA_VERSION = 2
+# Schema 3 : chaque entree porte kind ("result" ou "artifact", D3 de KKS-560).
+RECONCILE_LOG_SCHEMA_VERSION = 3
 RECONCILE_LOG_LEGACY_MESSAGE = (
     "reconcile-log.json est au schema 1 (devflow 8.0.0 ou anterieure) et n'est pas "
     "lu par cette version : terminer ce parcours avec devflow 8.0.0 "
     "(uv tool install devflow-cli==8.0.0), ou deplacer ce fichier dans attempts/ "
     "pour conserver son historique et commencer un nouveau journal"
 )
+RECONCILE_LOG_SCHEMA_2_MESSAGE = (
+    "reconcile-log.json est au schema 2 (devflow 10.0.2 ou anterieure) et n'est pas "
+    "lu par cette version : terminer ce parcours avec devflow 10.0.2 "
+    "(uv tool install devflow-cli==10.0.2), ou deplacer ce fichier dans attempts/ "
+    "pour conserver son historique et commencer un nouveau journal"
+)
+REASON_WITHOUT_RESULT_MESSAGE = (
+    "--reason ne peut etre utilise qu'avec --result, ou sans --result pour consigner "
+    "l'artefact corrige d'une tentative refusee invalid-artifact"
+)
+
+
+def _load_reconcile_log(feature_dir: Path, issue_id: str) -> tuple[Path, dict]:
+    """Charge le journal ou en cree un vide ; nomme l'invariant viole, sans ecrire."""
+    path = feature_dir / "reconcile-log.json"
+    if not path.is_file():
+        return path, {
+            "schemaVersion": RECONCILE_LOG_SCHEMA_VERSION,
+            "issueId": issue_id,
+            "entries": [],
+        }
+    log = json.loads(path.read_text(encoding="utf-8"))
+    if isinstance(log, dict) and log.get("schemaVersion") == 1:
+        raise ValueError(RECONCILE_LOG_LEGACY_MESSAGE)
+    if isinstance(log, dict) and log.get("schemaVersion") == 2:
+        raise ValueError(RECONCILE_LOG_SCHEMA_2_MESSAGE)
+    if (
+        not isinstance(log, dict)
+        or log.get("schemaVersion") != RECONCILE_LOG_SCHEMA_VERSION
+        or log.get("issueId") != issue_id
+        or not isinstance(log.get("entries"), list)
+        or not all(isinstance(entry, dict) for entry in log["entries"])
+    ):
+        raise ValueError("reconcile-log.json invalide")
+    return path, log
+
+
+def _append_reconcile_entry(path: Path, log: dict, entry: dict) -> None:
+    """Valide le journal complet contre son schema avant toute ecriture."""
+    log["entries"].append(entry)
+    validate_contract_payload("reconcile-log", log)
+    _write_json_atomic(path, log)
+
+
+def _entry_header(log: dict, contract: ActivityContract, kind: str, reason: str, author: str) -> dict:
+    return {
+        "sequence": len(log["entries"]) + 1,
+        "kind": kind,
+        "contractId": contract.contractId,
+        "activity": contract.activity,
+        "recordedAt": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        "author": author.strip() or os.environ.get("USER", "unknown"),
+        "reason": reason.strip(),
+    }
 
 
 def _record_manual_correction(
@@ -1070,33 +1187,10 @@ def _record_manual_correction(
     ``agentPayloadSha256`` et ``changedFields`` ne figurent que si la trace contenait
     une reponse de l'agent pour ce contrat (refusee par les validateurs, B1).
     """
-    path = feature_dir / "reconcile-log.json"
-    if path.is_file():
-        log = json.loads(path.read_text(encoding="utf-8"))
-        if isinstance(log, dict) and log.get("schemaVersion") == 1:
-            raise ValueError(RECONCILE_LOG_LEGACY_MESSAGE)
-        if (
-            not isinstance(log, dict)
-            or log.get("schemaVersion") != RECONCILE_LOG_SCHEMA_VERSION
-            or log.get("issueId") != issue_id
-            or not isinstance(log.get("entries"), list)
-            or not all(isinstance(entry, dict) for entry in log["entries"])
-        ):
-            raise ValueError("reconcile-log.json invalide")
-    else:
-        log = {
-            "schemaVersion": RECONCILE_LOG_SCHEMA_VERSION,
-            "issueId": issue_id,
-            "entries": [],
-        }
+    path, log = _load_reconcile_log(feature_dir, issue_id)
     canonical = json.dumps(payload, sort_keys=True, ensure_ascii=False)
     entry = {
-        "sequence": len(log["entries"]) + 1,
-        "contractId": contract.contractId,
-        "activity": contract.activity,
-        "recordedAt": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
-        "author": author.strip() or os.environ.get("USER", "unknown"),
-        "reason": reason.strip(),
+        **_entry_header(log, contract, "result", reason, author),
         "payloadSha256": _sha256(canonical),
         "payload": payload,
         "source": "manual-correction",
@@ -1110,8 +1204,33 @@ def _record_manual_correction(
             for key in set(agent_payload) | set(payload)
             if agent_payload.get(key, _MISSING) != payload.get(key, _MISSING)
         )
-    log["entries"].append(entry)
-    _write_json_atomic(path, log)
+    _append_reconcile_entry(path, log, entry)
+
+
+def _record_artifact_correction(
+    feature_dir: Path,
+    issue_id: str,
+    contract: ActivityContract,
+    artifact: str,
+    attempt_fingerprint: str | None,
+    corrected_fingerprint: str,
+    reason: str,
+    author: str,
+) -> None:
+    """Consigne l'artefact corrige a la main apres un refus invalid-artifact (D2).
+
+    ``attemptFingerprint`` est l'empreinte de la fiche de tentative (None si l'artefact n'y
+    figure pas), ``correctedFingerprint`` celle de l'artefact au moment de la reprise.
+    """
+    path, log = _load_reconcile_log(feature_dir, issue_id)
+    entry = {
+        **_entry_header(log, contract, "artifact", reason, author),
+        "path": artifact,
+        "attemptFingerprint": attempt_fingerprint,
+        "correctedFingerprint": corrected_fingerprint,
+        "source": "manual-correction",
+    }
+    _append_reconcile_entry(path, log, entry)
 
 
 _MISSING = object()

devflow_cli/core/contract_schemas.py

@@ -18,6 +18,7 @@ PUBLIC_CONTRACT_SCHEMAS = {
     "workflow-state": "workflow-state-v6.schema.json",
     "activity-contract": "activity-contract-v4.schema.json",
     "activity-result": "activity-result-v2.schema.json",
+    "reconcile-log": "reconcile-log-v3.schema.json",
 }
 # Fiche de tentative (<activite>-attempt.json) : seule definition (CT-04).
 ATTEMPT_SCHEMA_VERSION = 3

devflow_cli/core/validators.py

@@ -71,7 +71,6 @@ ARTIFACT_RULES: dict[str, dict] = {
 _PLACEHOLDER_BRACKET = re.compile(
     r"\[(?:TBD|TODO|XXX|[A-Z][A-Z\s]{3,})\](?!\()"
 )
-_PLACEHOLDER_MUSTACHE = re.compile(r"(?<!\$)\{\{[^}]+\}\}")
 _FENCE = re.compile(r"^ {0,3}(?P<marker>`{3,}|~{3,})")
 _INLINE_CODE = re.compile(r"(?P<ticks>`+)[^\r\n]*?(?P=ticks)")
 
@@ -169,14 +168,6 @@ def validate_artifact(step: str, artifact_path: Path) -> ValidationResult:
                 f"{match.group()}"
             ),
         ))
-    for match in _PLACEHOLDER_MUSTACHE.finditer(prose):
-        issues.append(ValidationIssue(
-            type="placeholder",
-            message=(
-                f"Placeholder non-remplace ligne {_line_number(prose, match.start())}: "
-                f"{match.group()}"
-            ),
-        ))
 
     return ValidationResult(valid=len(issues) == 0, issues=issues)
 

devflow_cli/resources/commands/devflow.md

@@ -9,6 +9,9 @@ allowed-tools: Bash(devflow:*)
 Utiliser exclusivement la machine adaptative de la CLI. Ne jamais créer ni
 interpréter de `state.json`.
 
+Avant toute chose, exécuter `devflow check`. En échec, ne pas utiliser
+Devflow : le dire, avec la cause, et traiter la demande hors Devflow.
+
 1. Lire `$ARGUMENTS` et extraire l'identifiant de feature et la cible `--until`
    (`done` par défaut).
 2. Exécuter `devflow status ISSUE_ID`.
@@ -17,7 +20,13 @@ interpréter de `state.json`.
    l'issue) et annoncer la branche et le dossier créés.
 4. Si la feature n'est pas encore évaluée et que `need.md` n'existe pas dans
    son dossier, le rédiger à partir de l'issue et de la demande. En cas de
-   doute sur le besoin, poser la question avant de l'écrire.
+   doute sur le besoin, poser la question avant de l'écrire. Le besoin dit :
+   1. les constats observés, avec leur origine ;
+   2. les décisions prises, non rediscutables pendant le parcours ;
+   3. l'attendu et les tests ;
+   4. la livraison (version, fichiers de version) ;
+   5. le hors périmètre ;
+   6. les contraintes d'exécution.
 5. Si elle n'est pas évaluée, demander les signaux nécessaires puis lancer
    `devflow assess ISSUE_ID` avec des options explicites.
 6. Si elle est évaluée mais non démarrée, lancer
@@ -59,3 +68,6 @@ devflow feedback add --type bilan --issue <ISSUE> --what "…" \
 
 Le contrat produit par Devflow est la seule autorité sur les actions,
 artefacts, validations et preuves de l'activité.
+
+Si le projet a une constitution (`.specify/memory/constitution.md`), la lire
+avant d'implémenter : elle prime sur spec, plan et tâches.

devflow_cli/schemas/reconcile-log-v3.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://devflow.dev/schemas/reconcile-log/v3",
+  "title": "Devflow Reconcile Log v3",
+  "type": "object",
+  "required": ["schemaVersion", "issueId", "entries"],
+  "properties": {
+    "schemaVersion": {"type": "integer", "const": 3},
+    "issueId": {"type": "string", "minLength": 1},
+    "entries": {
+      "type": "array",
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "required": [
+              "sequence",
+              "kind",
+              "contractId",
+              "activity",
+              "recordedAt",
+              "author",
+              "reason",
+              "payloadSha256",
+              "payload",
+              "source"
+            ],
+            "properties": {
+              "sequence": {"type": "integer", "minimum": 1},
+              "kind": {"type": "string", "const": "result"},
+              "contractId": {"type": "string", "minLength": 1},
+              "activity": {"type": "string", "minLength": 1},
+              "recordedAt": {"type": "string", "minLength": 1},
+              "author": {"type": "string"},
+              "reason": {"type": "string", "minLength": 1},
+              "payloadSha256": {"type": "string", "pattern": "^[0-9a-f]{64}$"},
+              "payload": {"type": "object"},
+              "source": {"type": "string", "const": "manual-correction"},
+              "agentPayloadSha256": {"type": "string", "pattern": "^[0-9a-f]{64}$"},
+              "changedFields": {
+                "type": "array",
+                "items": {"type": "string"}
+              }
+            },
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "required": [
+              "sequence",
+              "kind",
+              "contractId",
+              "activity",
+              "recordedAt",
+              "author",
+              "reason",
+              "path",
+              "attemptFingerprint",
+              "correctedFingerprint",
+              "source"
+            ],
+            "properties": {
+              "sequence": {"type": "integer", "minimum": 1},
+              "kind": {"type": "string", "const": "artifact"},
+              "contractId": {"type": "string", "minLength": 1},
+              "activity": {"type": "string", "minLength": 1},
+              "recordedAt": {"type": "string", "minLength": 1},
+              "author": {"type": "string"},
+              "reason": {"type": "string", "minLength": 1},
+              "path": {"type": "string", "minLength": 1},
+              "attemptFingerprint": {"type": ["string", "null"]},
+              "correctedFingerprint": {"type": "string", "minLength": 1},
+              "source": {"type": "string", "const": "manual-correction"}
+            },
+            "additionalProperties": false
+          }
+        ]
+      }
+    }
+  },
+  "additionalProperties": false
+}

devflow_cli-10.1.1.dist-info/METADATA

@@ -0,0 +1,167 @@
+Metadata-Version: 2.5
+Name: devflow-cli
+Version: 10.1.1
+Summary: Workflow adaptatif pour Claude Code : profils, preuves et contrats d'activité
+Project-URL: Homepage, https://github.com/sopequenoteck/devflow
+Project-URL: Repository, https://github.com/sopequenoteck/devflow
+Author-email: sopequenoteck <sopequeno.tech@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: adaptive,claude-code,cli,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: jsonschema>=4.23
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: hatchling>=1.27; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# devflow
+
+Devflow est un workflow adaptatif pour Claude Code. Il s'adresse au développeur
+qui fait travailler Claude Code sur ses projets et veut une rigueur
+proportionnée au risque : la CLI choisit un profil à partir de signaux
+explicites, confie chaque activité à un agent sous un contrat écrit et ne
+franchit une étape que sur des preuves qu'elle produit elle-même.
+
+Un parcours produit une branche Git et un dossier de feature, un besoin écrit
+(`need.md`), les résultats de chaque activité, des preuves exécutées
+localement (tests, inspection du diff, revue) et un journal des retours
+d'usage (frictions et bilan).
+
+## Installer
+
+Prérequis : Python 3.11+, Git et la CLI `claude` (Claude Code).
+
+```bash
+uv tool install --refresh devflow-cli==X.Y.Z   # version publiée sur PyPI
+devflow init
+devflow check
+```
+
+`devflow init` installe les commandes `/devflow` et `/devflow.status` dans
+`~/.claude` ; `devflow check` vérifie les prérequis. Installer toujours depuis
+PyPI, à une version précise.
+
+Après chaque mise à jour de la CLI, lancer `devflow upgrade` : il met à jour
+les commandes `/devflow` installées dans `~/.claude`, que l'installation de la
+CLI ne touche pas. Tant qu'elles diffèrent de la CLI, `devflow status` affiche
+un avertissement avec cette commande ; rien n'est modifié sans vous.
+`--refresh` évite qu'`uv` ignore une version tout juste publiée. Juste après
+une publication, l'installation peut échouer pendant une à quatre minutes, le
+temps que l'index se propage : réessayer.
+
+`devflow init` et `devflow upgrade` déplacent les anciennes commandes Claude
+connues vers `~/.claude/.devflow-legacy-backup/` sans toucher aux commandes
+personnalisées.
+
+Une version majeure refuse, sans migration, les parcours démarrés avec une
+version majeure antérieure : terminez-les avant la mise à jour, voir les notes
+de version du dépôt.
+
+## Premier parcours
+
+Une feature avec un identifiant d'issue passe par Devflow ; un correctif
+ponctuel ou une tâche hors feature, non.
+
+Avec Claude Code :
+
+```text
+/devflow KS-123
+```
+
+La commande crée la feature, rédige `need.md`, demande les signaux de
+l'évaluation puis enchaîne les activités jusqu'à `done`.
+
+À la main :
+
+```bash
+devflow feature KS-123 --short-name user-auth
+# Décrire le besoin dans need.md, dans le dossier de la feature créé
+devflow assess KS-123 --scope multiple --ambiguity medium --risk medium
+devflow adaptive start KS-123
+devflow adaptive run KS-123
+devflow adaptive status KS-123
+```
+
+Chaque invocation de `adaptive run` traite une activité. `adaptive status`
+affiche la progression, les preuves et la prochaine commande ; `--json` en
+donne une forme exploitable par la CI.
+
+## Décrire le besoin
+
+`need.md` est l'entrée de tout parcours et fait foi pour chaque activité. Le
+besoin dit :
+
+1. les constats observés, avec leur origine ;
+2. les décisions prises, non rediscutables pendant le parcours ;
+3. l'attendu et les tests ;
+4. la livraison (version, fichiers de version) ;
+5. le hors périmètre ;
+6. les contraintes d'exécution.
+
+## Lire un refus
+
+Chaque refus affiche son motif et la commande de reprise recommandée.
+
+- Refus justifié (le travail de l'agent ne satisfait pas l'étape) : corriger
+  le travail, puis reprendre par la commande proposée.
+- Échec de Devflow (refus à tort, message trompeur, reprise inadaptée,
+  prérequis non documenté) : le consigner aussitôt avec
+  `devflow feedback add --type friction`.
+- En fin de parcours, terminé ou abandonné : un bilan avec
+  `devflow feedback add --type bilan`.
+
+## Profils et garde-fous
+
+Le profil fixe la route documentaire :
+
+- `quick` : changement local, clair et peu risqué, sans revue.
+- `standard` : plusieurs composants ou risque modéré ; préparation puis revue
+  systématique.
+- `deep` : changement transversal, ambigu ou contractuel ; `spec`, `plan`,
+  `tasks`, plus `contracts` quand `--contract-change` est déclaré.
+
+Un bloc de garde-fous s'y ajoute quand `--data-security` est déclaré ou que
+`--risk high` : évaluation du risque, contrôle bloquant de sécurité ou de
+données à `verify`, revue indépendante, puis vérification du retour arrière
+avant `done`. Un bloc actif impose au minimum le profil `standard`, ne se
+désactive par aucune option et interdit les dérogations.
+
+La référence complète (routes, preuves, commandes, contrats d'activité) est
+livrée dans le dépôt, sous `docs/`.
+
+## Synchronisation Linear
+
+Si `LINEAR_API_KEY` contient une clé d'API personnelle Linear, la CLI met à jour
+le statut de l'issue du parcours au démarrage de chaque activité (`adaptive
+run`, y compris avec `--until`, et clôture `done`). L'équipe Linear doit avoir
+les statuts `Backlog`, `Design`, `In Progress`, `Review` et `Done`. Un statut
+n'est jamais ramené en arrière ; un statut hors de cette liste (`Canceled`,
+`Duplicate`) n'est jamais modifié.
+
+Sans clé, ou si Linear échoue (issue inconnue, statut absent, erreur réseau ou
+délai de 5 s dépassé), la CLI affiche un avertissement et le parcours continue
+à l'identique. La clé est retirée de l'environnement de tout processus lancé
+par Devflow (agents, commandes de validation, commandes git) ; elle reste
+lisible par un agent si elle est définie dans un fichier que son shell charge
+(`~/.zshrc`).
+
+## Développement
+
+```bash
+uv sync --extra dev
+uv run pytest -q
+./tests/run-tests.sh
+uv run devflow docs-sync --check
+```

{devflow_cli-10.0.2.dist-info → devflow_cli-10.1.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
-devflow_cli/__init__.py,sha256=b-svwN73BhNyuTfH9bGnIbORfC_qUL1jirIw8xLEdK8,871
+devflow_cli/__init__.py,sha256=NAGGk9OBe8YXw8PKPqglUP-Ky2xGiIPf0Ine3TMUXl0,871
 devflow_cli/cli.py,sha256=DVLx3wr1Hulke2qxhgHsEvvprRuO7SVETui_VGPNQv4,1983
 devflow_cli/adapters/__init__.py,sha256=z1J7_YJHcgak2a6dTZpOUKKwf-K7UwRqGzS8XY9duC0,299
 devflow_cli/adapters/agents.py,sha256=-9zmNlFmQfP2pOGxA3_SSKij8ScR76J4-sgv4GMBWEI,18530
 devflow_cli/adapters/linear.py,sha256=xHKjMuL3fFJEDBF65pPJ-yWHpXom999UAU2A0C7_QeI,8362
 devflow_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-devflow_cli/commands/adaptive.py,sha256=sHRLFTOtRsMEQscm1InalbIBOBk9MSJYEwwo32wZsU4,62775
+devflow_cli/commands/adaptive.py,sha256=jogZ_NE0EnuGOzU-w42HM7IxUiF2AYARZWS40HKMkLU,63295
 devflow_cli/commands/assess.py,sha256=V-E3ft41ljCrqp2WLjR1Dqw-JtswcqsK2nD1-euNbNE,5655
 devflow_cli/commands/check.py,sha256=nJOHVFvgT3Nq70g-4QGrSDZVwCSetu6g7snZcfLFf9I,4421
 devflow_cli/commands/docs_sync.py,sha256=Xc0mulpNTjDyeUDumKL7VNG0eumAf3016wEM_dqXpSU,1021
@@ -16,13 +16,13 @@ devflow_cli/commands/upgrade_cmd.py,sha256=7GYe1T7SWzkDSYW9x1G-Dznw9qwKT2uI1gJUc
 devflow_cli/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 devflow_cli/core/activity_base.py,sha256=eEC_YIr5O7WhCglA7xAEPypVzhcdC6f2h9d-SDDecVA,20475
 devflow_cli/core/activity_contracts.py,sha256=Sxu7b6lBQNNrtid0D3b9az8zPI8W4UHVgTQsNc0Y2uI,40328
-devflow_cli/core/adaptive_runner.py,sha256=Znc53MmtFC2iWLR-6IjwVFtViKyY7J6oWJn_HRp2Xk0,44686
+devflow_cli/core/adaptive_runner.py,sha256=AkXtcE-lOjxDnabKdxvv5knx9giZXvvhzuv9LKLS7Mc,49727
 devflow_cli/core/adaptive_workflow.py,sha256=DU8iciNOeEDco5uwQUeX9E9Kc2WwaVPoRfWxdpRJyJ4,14416
 devflow_cli/core/agent_failure.py,sha256=iX4q249lAHeVdD_ZF1aObmU-FX6sjfYP9dfLSnWGAD0,3771
 devflow_cli/core/agent_run_marker.py,sha256=QW3ScA2ZpqfQdUo5ANTbenDVyY2iHpB_wTaN6VUKlzc,3451
 devflow_cli/core/assessment.py,sha256=ACtJbXq1qZjVfeERjy8Qg6-ioLfSMUBVQm2l-mtGwgI,11522
 devflow_cli/core/automatic_evidence.py,sha256=pqSnNXe6RHthII6fgoHlCNkGiFTKQ4yyRtErGUwbvas,42559
-devflow_cli/core/contract_schemas.py,sha256=JXI8PVgjdagTlFxnyuIkNRRrVi319Mv8GwuMxopJ_GI,8424
+devflow_cli/core/contract_schemas.py,sha256=M0Twbt_SVVfuPa7udC-EJuR3pTl9pWrxQUCohIsg1h0,8477
 devflow_cli/core/docgen.py,sha256=47JoVDWetkcctgHwJZC67AVebOKgl10VB9hZ3Xr63mo,3908
 devflow_cli/core/feedback.py,sha256=07asmhX1cG4SXkoLlnSjA_UXgYnkFYoxl4u3JmOhpm0,13382
 devflow_cli/core/git.py,sha256=SsHL0OeJ8Bzc5cJC0moeBuyuwnvrJjtwnaI58TnzUSU,2536
@@ -38,7 +38,7 @@ devflow_cli/core/staleness.py,sha256=0JH_i1b8dYJmjDmQZuVToPnLOoNCN8ZZFgiSNrrBWOY
 devflow_cli/core/telemetry.py,sha256=FVR4iU9ywXIPo_5wrqWufpsp3GmHVLYiWaReaZ_DebM,2760
 devflow_cli/core/traceability.py,sha256=jfNE9MZzGkmaPer9Wa6Y18yA9Y3sqdeR-nzH9h_TB-8,2968
 devflow_cli/core/validation_approvals.py,sha256=3AHOpnW3BtY3BQrRZr38K7VNYRvbxGNhmQRYAufyhSA,9279
-devflow_cli/core/validators.py,sha256=fREjEx2fBW36q3vB6WJNqoGUM9ejYlQUXie5A9lNuPs,7440
+devflow_cli/core/validators.py,sha256=HKGG1-td5T8cFx3rbE0iWPtddolk73qsqYreVWVT07g,7081
 devflow_cli/core/verification.py,sha256=3_iGhsXNFCs5cpBUyBCRTsmRsfuBAVa38lRgy-LXXww,20349
 devflow_cli/core/waivers.py,sha256=0w38Osjr69mDT6Lsn0ljkaq6bbggVejuhqiOnYHabs4,5586
 devflow_cli/core/worklog.py,sha256=NedQaNrydudJ_uN3bCyo7n3plAcU1-4bYcK3WbLnu9E,15834
@@ -46,17 +46,18 @@ devflow_cli/core/worktree_snapshot.py,sha256=Q2_KTkhJTGvdM6Ay4RK9OHkyPEMrHQRTb-f
 devflow_cli/schemas/activity-contract-v4.schema.json,sha256=IeduWDiJ5IV6EL7FDZWnHBjzyUt1uwig2rB-SMbcpOU,2006
 devflow_cli/schemas/activity-result-v2.schema.json,sha256=2yDf6S--mlNWMxE8h8ruwTsM3Tnaa96SJDjluc4ePbI,2772
 devflow_cli/schemas/assessment-v4.schema.json,sha256=byFBaoG_Vu-qS7vERREKThtpQa3dzNtPiFCMyEpWFVQ,2254
+devflow_cli/schemas/reconcile-log-v3.schema.json,sha256=TNxw6xnv3dcwdUDqi0-SAlQnYg3_zDnCxkU6jwTfZRA,2926
 devflow_cli/schemas/workflow-state-v6.schema.json,sha256=fYyJS-6Aq-Ea7y2bVqJYSmKzdF2DvL3Nb6IdDNgFGfY,3239
 devflow_cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 devflow_cli/utils/console.py,sha256=t7cpyeEluWj4v_O_KFSI59iqXK4GiSXPuxlsr8q5zoQ,771
 devflow_cli/utils/logging.py,sha256=I7U9_IVvYAFnUAWi7xs5F_WGR0uSz6DmRvZ_B3xLFbs,1769
 devflow_cli/utils/paths.py,sha256=CH81dZZTI2vjgl8mck6QcAChxoBpujmKZ0vVKhKmXEY,8176
 devflow_cli/utils/strings.py,sha256=bfFXCwBDnFxshgZOYfy6mtysnjiaWO1wFnqBf7HLg4o,351
-devflow_cli/resources/commands/devflow.md,sha256=R_8oExTiK2oE5-7YycePFbUeu3tpkyMpsvXVZHAegYM,2899
+devflow_cli/resources/commands/devflow.md,sha256=5MjahTVYXAT_zrjEQmM25KH9s6DbRmyI1TdJCxYlrKk,3464
 devflow_cli/resources/commands/devflow.status.md,sha256=tqjQ1IboU99ztG6C4nunBHGJCvMn3qDqx3AoF4SPjCk,338
 devflow_cli/resources/templates/constitution-template.md,sha256=uSzNuwF-xIRx8cHt9gloynRjNgDGmnN5z2Xck6fCOsI,2102
-devflow_cli-10.0.2.dist-info/METADATA,sha256=hYN3yu8SeHp-cF9TA4LHf0ZNVPLjIYBsfOF1IzJCidI,10116
-devflow_cli-10.0.2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-devflow_cli-10.0.2.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
-devflow_cli-10.0.2.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
-devflow_cli-10.0.2.dist-info/RECORD,,
+devflow_cli-10.1.1.dist-info/METADATA,sha256=2J_RNk3Db7cbmZbRZxe_NfLeXFOnXtLde9bIRsOec4I,6501
+devflow_cli-10.1.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+devflow_cli-10.1.1.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
+devflow_cli-10.1.1.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
+devflow_cli-10.1.1.dist-info/RECORD,,

devflow_cli-10.0.2.dist-info/METADATA

@@ -1,212 +0,0 @@
-Metadata-Version: 2.5
-Name: devflow-cli
-Version: 10.0.2
-Summary: Spec-Driven Development workflow CLI
-Project-URL: Homepage, https://github.com/sopequenoteck/devflow
-Project-URL: Repository, https://github.com/sopequenoteck/devflow
-Author-email: sopequenoteck <sopequeno.tech@gmail.com>
-License: MIT
-License-File: LICENSE
-Keywords: claude-code,cli,development,spec-driven,workflow
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Quality Assurance
-Requires-Python: >=3.11
-Requires-Dist: jsonschema>=4.23
-Requires-Dist: pyyaml>=6
-Requires-Dist: rich>=13
-Requires-Dist: typer>=0.12
-Provides-Extra: dev
-Requires-Dist: hatchling>=1.27; extra == 'dev'
-Requires-Dist: pytest-cov>=5; extra == 'dev'
-Requires-Dist: pytest>=8; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# devflow
-
-Devflow est un moteur de développement adaptatif pour Claude Code. Il choisit un niveau de rigueur à partir de signaux explicites, produit
-des contrats d’activité portables et bloque les transitions tant que les
-preuves attendues ne sont pas présentes.
-
-## Profils
-
-Le profil fixe la route documentaire :
-
-- `quick` : changement local, clair et peu risqué, sans revue.
-- `standard` : plusieurs composants ou risque modéré ; préparation puis revue
-  systématique (`implementation-review`).
-- `deep` : changement transversal, ambigu ou contractuel ; `spec`, `plan`,
-  `tasks`, plus `contracts` quand `--contract-change` est déclaré.
-
-Un bloc de garde-fous s'y ajoute quand `--data-security` est déclaré ou que
-`--risk high` : `risk-assessment` après l'évaluation, validation bloquante de
-sécurité ou de données dans le plan de validation (une validation protégée non
-bloquante est refusée dès `prepare` ou `plan`), preuve
-`security-or-data-check` produite par `verify`, revue `independent-review`,
-puis `rollback-check` avec `rollback-plan`. Un bloc actif impose au minimum le
-profil `standard`, ne se désactive par aucune option et interdit les
-dérogations.
-
-Les routes exactes et leurs preuves sont générées dans
-[docs/pipeline-reference.generated.md](docs/pipeline-reference.generated.md).
-
-## Installation
-
-```bash
-uv tool install --refresh devflow-cli==X.Y.Z   # version publiée, voir CHANGELOG.md
-devflow init
-```
-
-Après chaque mise à jour de la CLI, lancer `devflow upgrade` : il met à jour
-les commandes `/devflow` installées dans `~/.claude`, que l'installation de la
-CLI ne touche pas. `--refresh` évite qu'`uv` ignore une version tout juste
-publiée. Juste après une publication, l'installation peut échouer pendant une
-à quatre minutes, le temps que l'index se propage : réessayer. Tant que les commandes installées diffèrent de la CLI,
-`devflow status` affiche un avertissement avec cette commande ; rien n'est
-modifié sans vous.
-
-Installer toujours depuis PyPI, à une version précise, jamais depuis le
-dossier du dépôt. Les versions publiées sont listées dans
-[CHANGELOG.md](CHANGELOG.md).
-
-Python 3.11+ et Git sont requis.
-
-## Parcours quotidien
-
-```bash
-devflow feature KS-123 --short-name user-auth
-# Décrire le besoin dans need.md, dans le dossier de la feature créé
-devflow assess KS-123 --scope multiple --ambiguity medium --risk medium
-devflow adaptive start KS-123
-devflow adaptive run KS-123
-devflow adaptive status KS-123
-```
-
-`adaptive status --json` fournit un état exploitable par la CI. Les échecs
-distinguent explicitement blocage métier, contrat invalide, panne agent,
-validation échouée et conflit concurrent ; chaque refus affiche la commande de
-reprise recommandée. Après un refus de `verify`, cette reprise dépend du motif :
-approbations à donner, environnement à corriger, ou trois voies après un
-contrôle échoué (rouvrir `implement` si le code est en cause, rouvrir `prepare`
-ou `plan` si la validation l'est, relancer `verify` après un échec passager).
-En `quick`, un lot purement documentaire (`README.md`, Markdown sous `docs/`)
-sans contrôle détecté franchit `verify` sur l'inspection du diff.
-
-Un plan de `prepare` ou de `plan` refusé par les validateurs se corrige sans
-relancer l'agent : `devflow adaptive reconcile KS-123 --result FICHIER.json
---reason MOTIF` rejoue les mêmes validateurs et trace la correction. Les
-validations qui attendent une approbation (`devflow adaptive approve-command`)
-sont listées en une fois à la fin du plan et au début de `verify`. Pendant
-qu'un agent travaille, les commandes humaines qui modifieraient l'état sont
-refusées sans effet, et un fichier d'exécution modifié par l'agent est remis
-dans son état d'avant l'agent.
-
-L'agent Claude d'une activité est lancé avec
-`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1` : il peut déléguer à des sous-agents,
-mais au premier plan seulement. Effet de bord : il ne peut plus lancer de
-commande shell en arrière-plan (serveur de test, par exemple). Tous les contrats
-demandent en plus que la sortie structurée soit le dernier message de l'agent.
-Si un agent termine sans erreur mais sans sortie structurée, `adaptive run`
-nomme la cause (`structured-output-missing`) et propose
-`devflow adaptive reconcile KS-123 --result MODELE --reason MOTIF` avec un
-modèle de résultat prérempli, écrit dans `~/.devflow/reconcile/` et à compléter.
-
-`need.md` peut être amendé en cours de parcours. Avant une activité
-documentaire, l'amendement est accepté avec un avertissement qui nomme les
-activités déjà closes, à rouvrir si leur résultat en dépend ; avant `prepare`,
-il est accepté sans cet avertissement ; pendant l'exécution d'un agent, il est refusé ;
-avant `implement`, il périme la preuve de pré-vol ; après `implement`, il
-périme une revue déjà faite. Pour arbitrer après un blocage d'`implement` :
-amender `need.md`, puis `devflow adaptive reopen KS-123 preflight-evidence
---reason MOTIF`, refaire le pré-vol et relancer `implement`. Un refus
-d'artefact (`artifact-files-mismatch`) nomme chaque fichier en trop et sa
-cause : retirer ou remettre en état le fichier, puis
-`devflow adaptive reconcile KS-123` ; la relance à l'identique n'est plus
-proposée. Pour une entrée du besoin modifiée par un agent, la relance est
-refusée avant le lancement de l'agent : remettre l'entrée en état, ou
-`devflow adaptive discard-attempt KS-123 --reason MOTIF`, puis
-`devflow adaptive run KS-123`.
-
-Chaque invocation de `adaptive run` traite une activité. La politique est dans
-`assessment.json`; la progression et les preuves sont dans
-`workflow-state.json`. Les résultats agent sont validés par schéma et les
-preuves d’exécution sensibles sont produites localement par Devflow.
-
-Chaque profil exécute `preflight-evidence` avant `implement`. Cette
-activité archive des faits externes reproductibles dans
-`preflight-evidence.md`, sans secret ni donnée utilisateur.
-
-`adaptive run` lance toujours Claude Code, sans option d'agent.
-
-## Features créées avant devflow 9
-
-Devflow 9 refuse, sans migration, un dossier de feature dont la racine contient
-un `*-result.json` de `schemaVersion` 1 ou un `*-attempt.json` de schéma 2 ou
-moins (parcours démarré avec devflow 8.x). Terminez les parcours en cours avec
-devflow 8.5.1, ou gardez la CLI épinglée :
-`uv tool install devflow-cli==8.5.1`. Voir les
-[notes de version 9.0.0](docs/releases/9.0.0.md).
-
-## Features créées avant devflow 8
-
-Devflow 8 refuse, sans migration, un `workflow-state.json` (schéma 5) produit
-par devflow 7.x. Terminez les parcours en cours avec devflow 7.x, ou gardez la
-CLI épinglée : `uv tool install 'devflow-cli<8'`. Voir les
-[notes de version 8.0.0](docs/releases/8.0.0.md).
-
-## Features créées avant devflow 7
-
-Devflow 7 refuse, sans migration, un `assessment.json` (schéma 3) ou un
-`workflow-state.json` (schéma 4) produit par devflow 6.x, avec un message qui
-nomme le fichier. Avant la mise à jour, terminez les parcours en cours avec
-devflow 6.x, ou gardez la CLI épinglée :
-`uv tool install 'devflow-cli<7'`. Voir
-[ADR-0003](docs/adr/0003-v7-guardrails-rupture.md) et les
-[notes de version 7.0.0](docs/releases/7.0.0.md).
-
-## Features créées avant devflow 5
-
-Devflow 5 ne lit que ses propres schémas et ne fournit aucune migration : un
-`assessment.json`, un `workflow-state.json` ou un `state.json` créé par une
-version antérieure est refusé. Terminez ces features avec devflow 4.x avant la
-mise à jour. Voir [ADR-0002](docs/adr/0002-v5-rupture-and-provenance.md).
-
-`devflow init` et `devflow upgrade` déplacent également les anciennes commandes
-Claude connues vers `~/.claude/.devflow-legacy-backup/` sans toucher aux
-commandes personnalisées.
-
-## Synchronisation Linear
-
-Si `LINEAR_API_KEY` contient une clé d'API personnelle Linear, la CLI met à jour
-le statut de l'issue du parcours au démarrage de chaque activité (`adaptive
-run`, y compris avec `--until`, et clôture `done`). L'équipe Linear doit avoir
-les statuts `Backlog`, `Design`, `In Progress`, `Review` et `Done`. Un statut
-n'est jamais ramené en arrière ; un statut hors de cette liste (`Canceled`,
-`Duplicate`) n'est jamais modifié.
-
-Sans clé, ou si Linear échoue (issue inconnue, statut absent, erreur réseau ou
-délai de 5 s dépassé), la CLI affiche un avertissement et le parcours continue
-à l'identique. La clé est retirée de l'environnement de tout processus lancé
-par Devflow (agents, commandes de validation, commandes git) ; elle reste
-lisible par un agent si elle est définie dans un fichier que son shell charge (`~/.zshrc`). Détails :
-[Référence CLI](docs/cli-reference.md#synchronisation-linear).
-
-## Documentation
-
-- [Workflow adaptatif](docs/pipeline.md)
-- [Référence CLI](docs/cli-reference.md)
-- [Contrats d’activité](docs/activity-contracts.md)
-- [Façade Claude Code](docs/commands-reference.md)
-
-## Développement
-
-```bash
-uv sync --extra dev
-uv run pytest -q
-./tests/run-tests.sh
-uv run devflow docs-sync --check
-```