devflow-cli 2.0.0__py3-none-any.whl → 2.3.0__py3-none-any.whl

devflow_cli/__init__.py

@@ -1,6 +1,6 @@
 """devflow CLI — Spec-Driven Development workflow."""
 
-VERSION = "1.0.0"
+VERSION = "2.3.0"
 
 STEPS = [
     "constitution",  # Pré-requis projet (1/projet). Auto-complétée si .specify/memory/constitution.md existe.
@@ -20,6 +20,8 @@ STEPS = [
 
 OPTIONAL_STEPS = {"clarify", "research", "contracts", "docs"}
 
+REVIEW_GATES = {"review-spec", "review-tasks", "review-impl"}
+
 STEP_ARTIFACTS = {
     "spec": "spec.md",
     "clarify": "clarify-log.md",
@@ -51,6 +53,17 @@ STEP_LINEAR_MAPPING = {
 
 SUPPORTED_AGENTS = ["claude-code", "cursor"]
 
+# Mapping speckit → devflow pour la migration
+SPECKIT_STEP_MAP = {
+    "specify": "spec",
+    "clarify": "clarify",
+    "plan": "plan",
+    "tasks": "tasks",
+    "implement": "implement",
+}
+
+SPECKIT_IGNORED_STEPS = {"checklist", "analyze"}
+
 ARTIFACTS = [
     "spec.md",
     "clarify-log.md",
@@ -65,3 +78,11 @@ ARTIFACTS = [
     "analysis.md",
     "checklist.md",
 ]
+
+# --- Pipeline constants coherence checks ---
+_steps_set = set(STEPS)
+assert OPTIONAL_STEPS <= _steps_set, f"OPTIONAL_STEPS not subset of STEPS: {OPTIONAL_STEPS - _steps_set}"
+assert REVIEW_GATES <= _steps_set, f"REVIEW_GATES not subset of STEPS: {REVIEW_GATES - _steps_set}"
+assert set(STEP_ARTIFACTS.keys()) <= _steps_set, f"STEP_ARTIFACTS has unknown keys: {set(STEP_ARTIFACTS.keys()) - _steps_set}"
+assert set(STEP_LINEAR_MAPPING.keys()) <= _steps_set, f"STEP_LINEAR_MAPPING has unknown keys: {set(STEP_LINEAR_MAPPING.keys()) - _steps_set}"
+assert set(SPECKIT_STEP_MAP.values()) <= _steps_set, f"SPECKIT_STEP_MAP maps to unknown steps: {set(SPECKIT_STEP_MAP.values()) - _steps_set}"

devflow_cli/cli.py

@@ -5,16 +5,18 @@ from __future__ import annotations
 import typer
 
 from devflow_cli import VERSION
+from devflow_cli.utils.logging import setup_logging
 from devflow_cli.commands.init_cmd import init
 from devflow_cli.commands.check import check
 from devflow_cli.commands.status import status
 from devflow_cli.commands.feature import feature
 from devflow_cli.commands.context import context
 from devflow_cli.commands.export_cmd import export
-from devflow_cli.commands.regen import regen
+from devflow_cli.commands.stale import stale
 from devflow_cli.commands.migrate_cmd import migrate
 from devflow_cli.commands.upgrade_cmd import upgrade
 from devflow_cli.commands.rollback import rollback
+from devflow_cli.commands.migrate_speckit import migrate_speckit
 from devflow_cli.commands import extension
 
 app = typer.Typer(
@@ -33,8 +35,10 @@ def version_callback(value: bool) -> None:
 @app.callback()
 def main(
     version: bool = typer.Option(False, "--version", callback=version_callback, is_eager=True, help="Affiche la version"),
+    verbose: bool = typer.Option(False, "--verbose", "-v", help="Active les logs dans stderr"),
 ) -> None:
     """devflow — Spec-Driven Development workflow CLI."""
+    setup_logging(verbose=verbose)
 
 
 app.command()(init)
@@ -43,10 +47,11 @@ app.command()(status)
 app.command()(feature)
 app.command()(context)
 app.command(name="export")(export)
-app.command()(regen)
+app.command()(stale)
 app.command()(migrate)
 app.command()(upgrade)
 app.command()(rollback)
+app.command(name="migrate-speckit")(migrate_speckit)
 app.add_typer(extension.app, name="extension")
 
 

devflow_cli/commands/check.py

@@ -8,6 +8,9 @@ from pathlib import Path
 
 import typer
 from devflow_cli.utils.console import console, ok, warn, fail
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
 from devflow_cli.utils.paths import get_claude_dir
 
 
@@ -133,7 +136,7 @@ def check() -> None:
                     linear_configured = True
                     break
             except OSError:
-                pass
+                logger.warning("Failed to read config %s", cfg_file, exc_info=True)
     if linear_configured:
         ok("Linear MCP -- configure")
         ok_count += 1

devflow_cli/commands/feature.py

@@ -9,6 +9,9 @@ from typing import Optional
 import typer
 
 from devflow_cli.core.git import branch_exists, create_branch, checkout_branch, GitNotFoundError
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
 from devflow_cli.core.state import create_state
 from devflow_cli.utils.console import console, ok, info
 from devflow_cli.utils.paths import get_specs_root, next_feature_number
@@ -28,6 +31,7 @@ def _ensure_git() -> None:
         from devflow_cli.core.git import ensure_git_available
         ensure_git_available()
     except GitNotFoundError as e:
+        logger.error("Git not found: %s", e, exc_info=True)
         console.print(f"[red]Erreur : {e}[/red]")
         raise typer.Exit(1)
 

devflow_cli/commands/init_cmd.py

@@ -8,6 +8,10 @@ from typing import Literal, Optional
 
 import typer
 
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
+
 from devflow_cli import SUPPORTED_AGENTS
 from devflow_cli.core.installer import install_devflow
 from devflow_cli.core.git import is_git_repo
@@ -110,6 +114,7 @@ def init(
         save_manifest(get_claude_dir(), manifest_data)
         ok("Manifeste d'installation cree")
     except Exception:
+        logger.error("Failed to create manifest", exc_info=True)
         warn("Impossible de creer le manifeste d'installation")
 
     console.print()

devflow_cli/commands/migrate_cmd.py

@@ -8,6 +8,9 @@ from pathlib import Path
 import typer
 
 from devflow_cli.core.state import read_state
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
 from devflow_cli.utils.console import console, ok, info, warn, fail, header
 from devflow_cli.utils.paths import get_specs_root, next_feature_number
 from devflow_cli.utils.strings import clean_short_name
@@ -68,6 +71,7 @@ def migrate(
                 default=default_name,
             )
         except (KeyboardInterrupt, typer.Abort):
+            logger.warning("Migration interrupted for %s", issue_id)
             console.print(f"    [yellow]Ignore (annule)[/yellow]")
             skipped += 1
             continue

devflow_cli/commands/migrate_speckit.py

@@ -0,0 +1,227 @@
+"""devflow migrate-speckit — Migration des projets speckit vers devflow."""
+
+from __future__ import annotations
+
+import json
+import shutil
+from pathlib import Path
+
+import typer
+
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
+
+from devflow_cli.core.state import (
+    is_speckit_state, convert_speckit_state, write_state,
+)
+from devflow_cli.core.manifest import compute_file_hash
+from devflow_cli.utils.console import console, ok, info, warn, header
+from devflow_cli.utils.paths import get_devflow_root, get_claude_dir, get_specs_root
+
+
+def migrate_speckit(
+    dry_run: bool = typer.Option(False, "--dry-run", help="Affiche le plan de migration sans modifier de fichiers"),
+    clean_speckit: bool = typer.Option(False, "--clean-speckit", help="Supprime les commandes speckit et templates non personnalises"),
+) -> None:
+    """Migration des projets speckit vers le workflow devflow."""
+    specs_root = get_specs_root()
+
+    if not specs_root.is_dir():
+        info("Rien a migrer : .specify/specs/ n'existe pas.")
+        return
+
+    # Scanner les features
+    features = sorted(
+        d for d in specs_root.iterdir()
+        if d.is_dir() and (d / "state.json").is_file()
+    )
+
+    if not features:
+        info("Aucune feature speckit detectee.")
+        if clean_speckit:
+            _clean_speckit(dry_run)
+        else:
+            _suggest_clean_speckit()
+        return
+
+    # Filtrer : seulement les speckit states
+    speckit_features = []
+    devflow_features = []
+    error_features = []
+
+    for feat_dir in features:
+        state_file = feat_dir / "state.json"
+        if is_speckit_state(state_file):
+            speckit_features.append(feat_dir)
+        else:
+            # Verifier si c'est un devflow valide ou corrompu
+            try:
+                data = json.loads(state_file.read_text(encoding="utf-8"))
+                if "reviewIterations" in data:
+                    devflow_features.append(feat_dir)
+                else:
+                    error_features.append((feat_dir, "Format non reconnu"))
+            except (json.JSONDecodeError, OSError) as e:
+                logger.warning("Failed to read state %s", state_file, exc_info=True)
+                error_features.append((feat_dir, str(e)))
+
+    if not speckit_features and not error_features:
+        info("Aucune feature speckit detectee.")
+        if devflow_features:
+            info(f"  {len(devflow_features)} feature(s) deja au format devflow.")
+        if clean_speckit:
+            _clean_speckit(dry_run)
+        else:
+            _suggest_clean_speckit()
+        return
+
+    header(f"devflow migrate-speckit — {len(speckit_features)} feature(s) speckit")
+    console.print()
+
+    if dry_run:
+        console.print("[dim]Mode dry-run : aucun fichier ne sera modifie.[/dim]")
+        console.print()
+
+    migrated = 0
+
+    for feat_dir in speckit_features:
+        state_file = feat_dir / "state.json"
+        try:
+            raw_data = json.loads(state_file.read_text(encoding="utf-8"))
+        except (json.JSONDecodeError, OSError) as e:
+            logger.warning("Failed to read speckit state %s", state_file, exc_info=True)
+            warn(f"  {feat_dir.name} : erreur lecture — {e}")
+            error_features.append((feat_dir, str(e)))
+            continue
+
+        issue_id = raw_data.get("issueId", feat_dir.name)
+        from_step = raw_data.get("currentStep", "?")
+        converted = convert_speckit_state(raw_data)
+        to_step = converted.currentStep
+
+        if dry_run:
+            console.print(f"  [bold]{feat_dir.name}[/bold] ({issue_id})")
+            console.print(f"    Etape : {from_step} → {to_step}")
+            console.print(f"    Champs ajoutes : reviewIterations, mode, skippedSteps")
+        else:
+            # Backup
+            shutil.copy2(state_file, state_file.with_suffix(".json.bak"))
+            # Ecrire le state converti
+            write_state(state_file, converted)
+            ok(f"  {feat_dir.name} ({issue_id}) : {from_step} → {to_step}")
+
+        migrated += 1
+
+    # Constitution
+    if not dry_run:
+        _ensure_constitution()
+
+    # Rapport
+    console.print()
+    console.rule("Recapitulatif")
+    console.print(f"  Migrees   : {migrated}")
+    if devflow_features:
+        console.print(f"  Ignorees  : {len(devflow_features)} (deja devflow)")
+    if error_features:
+        console.print(f"  Erreurs   : {len(error_features)}")
+        for feat_dir, msg in error_features:
+            warn(f"    {feat_dir.name} : {msg}")
+
+    if dry_run:
+        console.print()
+        console.print("[dim]Mode dry-run : aucun fichier modifie.[/dim]")
+
+    # Nettoyage speckit
+    if clean_speckit:
+        _clean_speckit(dry_run)
+    elif not dry_run:
+        _suggest_clean_speckit()
+
+
+def _ensure_constitution() -> None:
+    """Cree une constitution starter si absente."""
+    const_dest = Path.cwd() / ".specify" / "memory" / "constitution.md"
+    if const_dest.is_file():
+        return
+
+    try:
+        const_src = get_devflow_root() / "templates" / "constitution-template.md"
+        if const_src.is_file():
+            const_dest.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(const_src, const_dest)
+            ok("Constitution starter creee dans .specify/memory/constitution.md")
+            info("  Pensez a la personnaliser pour votre projet.")
+        else:
+            warn("Template constitution non trouve — creation ignoree.")
+    except Exception:
+        logger.error("Failed to create constitution starter", exc_info=True)
+        warn("Impossible de creer la constitution starter.")
+
+
+def _clean_speckit(dry_run: bool) -> None:
+    """Supprime les commandes speckit et templates non personnalises."""
+    console.print()
+    header("Nettoyage speckit")
+    console.print()
+
+    # 1. Commandes speckit dans ~/.claude/commands/
+    claude_dir = get_claude_dir()
+    cmd_dir = claude_dir / "commands"
+    removed_cmds = 0
+    if cmd_dir.is_dir():
+        for f in sorted(cmd_dir.glob("speckit.*.md")):
+            if dry_run:
+                console.print(f"  [dim](dry-run) Supprimerait {f.name}[/dim]")
+            else:
+                f.unlink()
+                console.print(f"  Supprime : {f.name}")
+            removed_cmds += 1
+
+    # 2. Templates dans .specify/templates/
+    tpl_dir = Path.cwd() / ".specify" / "templates"
+    removed_tpls = 0
+    preserved_tpls = 0
+    if tpl_dir.is_dir():
+        try:
+            devflow_tpl_dir = get_devflow_root() / "templates"
+        except Exception:
+            logger.error("Failed to resolve devflow template dir", exc_info=True)
+            devflow_tpl_dir = None
+
+        for f in sorted(tpl_dir.glob("*")):
+            if not f.is_file():
+                continue
+            # Comparer avec le template devflow source
+            if devflow_tpl_dir and (devflow_tpl_dir / f.name).is_file():
+                src_hash = compute_file_hash(devflow_tpl_dir / f.name)
+                installed_hash = compute_file_hash(f)
+                if src_hash == installed_hash:
+                    if dry_run:
+                        console.print(f"  [dim](dry-run) Supprimerait {f.name}[/dim]")
+                    else:
+                        f.unlink()
+                        console.print(f"  Supprime : {f.name}")
+                    removed_tpls += 1
+                else:
+                    warn(f"  Conserve (personnalise) : {f.name}")
+                    preserved_tpls += 1
+            else:
+                # Pas de reference → conserver par securite
+                warn(f"  Conserve (pas de reference) : {f.name}")
+                preserved_tpls += 1
+
+    console.print()
+    console.print(f"  Commandes supprimees : {removed_cmds}")
+    console.print(f"  Templates supprimes  : {removed_tpls}")
+    if preserved_tpls:
+        console.print(f"  Templates conserves  : {preserved_tpls}")
+
+
+def _suggest_clean_speckit() -> None:
+    """Suggere --clean-speckit si des commandes speckit sont detectees."""
+    claude_dir = get_claude_dir()
+    cmd_dir = claude_dir / "commands"
+    if cmd_dir.is_dir() and list(cmd_dir.glob("speckit.*.md")):
+        info("Des commandes speckit sont encore presentes dans ~/.claude/commands/.")
+        info("Utilisez --clean-speckit pour les supprimer.")

devflow_cli/commands/{regen.py → stale.py}

@@ -1,4 +1,4 @@
-"""devflow regen — Detection et regeneration en cascade des artefacts desuets."""
+"""devflow stale — Detection des artefacts desuets."""
 
 from __future__ import annotations
 
@@ -14,11 +14,11 @@ from devflow_cli.utils.console import console, ok, info, header
 from devflow_cli.utils.paths import resolve_feature_dir
 
 
-def regen(
-    only: Optional[str] = typer.Option(None, "--only", help="Regenerer uniquement cet artefact (plan, tasks)"),
+def stale(
+    only: Optional[str] = typer.Option(None, "--only", help="Filtrer uniquement cet artefact (plan, tasks)"),
     json_output: bool = typer.Option(False, "--json", help="Sortie JSON pour integration Claude Code"),
 ) -> None:
-    """Detecte et propose la regeneration des artefacts desuets."""
+    """Detecte les artefacts desuets et affiche les commandes de regeneration."""
     branch = current_branch()
     feature_dir = resolve_feature_dir(branch) if branch else None
     if feature_dir is None:
@@ -62,7 +62,7 @@ def regen(
         print(json.dumps(output, indent=2))
         return
 
-    header(f"devflow regen — {feature_dir.name}")
+    header(f"devflow stale — {feature_dir.name}")
     console.print()
 
     if not stale_list:
@@ -80,7 +80,7 @@ def regen(
         console.print(f"  {i}. {cmd}")
 
     console.print()
-    if typer.confirm("Regenerer ?", default=False):
+    if typer.confirm("Voir les commandes de regeneration ?", default=False):
         console.print()
         info("Lancez les commandes suivantes dans l'ordre :")
         for s in stale_list:

devflow_cli/core/catalog.py

@@ -6,8 +6,11 @@ import json
 from dataclasses import dataclass
 from pathlib import Path
 
+from devflow_cli.utils.logging import get_logger
 from devflow_cli.utils.paths import get_devflow_root, get_claude_dir
 
+logger = get_logger(__name__)
+
 
 @dataclass
 class ExtensionInclude:
@@ -40,6 +43,7 @@ def load_catalog(path: Path, source: str = "principal") -> Catalog | None:
     try:
         data = json.loads(path.read_text(encoding="utf-8"))
     except (json.JSONDecodeError, OSError) as e:
+        logger.warning("Failed to load catalog %s", path, exc_info=True)
         from devflow_cli.utils.console import warn
         warn(f"Catalogue corrompu ou illisible : {path} ({type(e).__name__}: {e})")
         return None

devflow_cli/core/git.py

@@ -5,6 +5,10 @@ from __future__ import annotations
 import subprocess
 from pathlib import Path
 
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
+
 
 class GitNotFoundError(Exception):
     """Levee quand git n'est pas installe ou pas dans le PATH."""
@@ -30,6 +34,7 @@ def ensure_git_available() -> None:
         )
         _git_checked = True
     except FileNotFoundError:
+        logger.error("git not found in PATH", exc_info=True)
         raise GitNotFoundError() from None
 
 
@@ -43,6 +48,7 @@ def _run(args: list[str], cwd: Path | None = None) -> subprocess.CompletedProces
             args, capture_output=True, text=True, cwd=cwd, timeout=_GIT_TIMEOUT,
         )
     except subprocess.TimeoutExpired:
+        logger.warning("git command timed out: %s", args, exc_info=True)
         return subprocess.CompletedProcess(
             args, returncode=1, stdout="", stderr="git command timed out",
         )

devflow_cli/core/hooks.py

@@ -7,6 +7,10 @@ from pathlib import Path
 
 import yaml
 
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
+
 
 VALID_HOOK_POINTS = {"after_tasks", "before_implement", "after_implement"}
 VALID_HOOK_TYPES = {"shell", "claude", "agent"}
@@ -34,6 +38,7 @@ def validate_hooks_file(hooks_file: Path) -> ValidationResult:
     try:
         data = yaml.safe_load(hooks_file.read_text(encoding="utf-8"))
     except yaml.YAMLError as e:
+        logger.warning("Failed to parse hooks YAML %s", hooks_file, exc_info=True)
         result.errors.append(f"Erreur de syntaxe YAML : {e}")
         return result
 

devflow_cli/core/manifest.py

@@ -9,6 +9,9 @@ from datetime import datetime, timezone
 from pathlib import Path
 
 from devflow_cli import VERSION
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
 
 
 @dataclass
@@ -82,6 +85,7 @@ def load_manifest(claude_dir: Path) -> dict | None:
     try:
         return json.loads(manifest_file.read_text(encoding="utf-8"))
     except (json.JSONDecodeError, OSError) as e:
+        logger.warning("Failed to read manifest %s", manifest_file, exc_info=True)
         from devflow_cli.utils.console import warn
         warn(f"Manifeste corrompu ou illisible : {manifest_file} ({type(e).__name__}: {e})")
         return None

devflow_cli/core/state.py

@@ -7,7 +7,10 @@ from dataclasses import dataclass, field, asdict
 from datetime import datetime, timezone
 from pathlib import Path
 
-from devflow_cli import STEPS, OPTIONAL_STEPS, STEP_ARTIFACTS
+from devflow_cli import STEPS, OPTIONAL_STEPS, STEP_ARTIFACTS, SPECKIT_STEP_MAP, SPECKIT_IGNORED_STEPS, REVIEW_GATES
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
 
 
 @dataclass
@@ -82,7 +85,8 @@ def read_state(state_file: Path) -> FeatureState | None:
             if k in FeatureState.__dataclass_fields__
         })
         return _validate_state(state)
-    except (json.JSONDecodeError, TypeError, KeyError, OSError):
+    except (json.JSONDecodeError, TypeError, KeyError, OSError, UnicodeDecodeError):
+        logger.warning("Failed to read state %s", state_file, exc_info=True)
         return None
 
 
@@ -205,6 +209,10 @@ def advance_step(
     else:
         state.stepTimestamps[completed_step]["completedAt"] = now
 
+    # Incrementer reviewIterations pour les gates de review
+    if completed_step in REVIEW_GATES:
+        state.reviewIterations[completed_step] = state.reviewIterations.get(completed_step, 0) + 1
+
     # Trouver la prochaine etape non-skippee
     next_idx = idx + 1
     while next_idx < len(STEPS) and STEPS[next_idx] in state.skippedSteps:
@@ -262,6 +270,75 @@ def rollback_step(state: FeatureState) -> FeatureState | None:
     return state
 
 
+def is_speckit_state(state_file: Path) -> bool:
+    """Detecte si un state.json est au format speckit (pas devflow).
+
+    Lit le JSON brut et verifie l'absence du champ 'reviewIterations'.
+    """
+    try:
+        data = json.loads(state_file.read_text(encoding="utf-8"))
+        return isinstance(data, dict) and "reviewIterations" not in data
+    except (json.JSONDecodeError, OSError):
+        logger.warning("Failed to detect speckit state %s", state_file, exc_info=True)
+        return False
+
+
+def convert_speckit_state(raw_data: dict) -> FeatureState:
+    """Convertit un state.json speckit brut en FeatureState devflow.
+
+    - Mappe les etapes via SPECKIT_STEP_MAP (specify→spec, etc.)
+    - Filtre les etapes ignorees (checklist, analyze)
+    - Injecte les etapes devflow intermediaires comme auto-validees
+      si l'utilisateur les a deja depassees
+    """
+    issue_id = raw_data.get("issueId", "")
+
+    # Mapper currentStep
+    raw_current = raw_data.get("currentStep", "spec")
+    current_step = SPECKIT_STEP_MAP.get(raw_current, raw_current)
+
+    # Mapper completedSteps : convertir et filtrer
+    raw_completed = raw_data.get("completedSteps", [])
+    mapped_completed: list[str] = []
+    for step in raw_completed:
+        if step in SPECKIT_IGNORED_STEPS:
+            continue
+        mapped = SPECKIT_STEP_MAP.get(step, step)
+        if mapped in STEPS and mapped not in mapped_completed:
+            mapped_completed.append(mapped)
+
+    # Injecter les etapes devflow intermediaires auto-validees
+    # Pour chaque etape devflow, si elle precede une etape deja completee
+    # et n'est pas encore dans completed, l'injecter
+    review_iterations: dict[str, int] = {}
+    if current_step in STEPS:
+        current_idx = STEPS.index(current_step)
+        final_completed: list[str] = []
+        for i, step in enumerate(STEPS):
+            if step == current_step:
+                break
+            if step in mapped_completed:
+                final_completed.append(step)
+            elif i < current_idx:
+                # Etape intermediaire manquante → auto-valider
+                final_completed.append(step)
+                if step in ("review-spec", "review-tasks", "review-impl"):
+                    review_iterations[step] = 0
+        mapped_completed = final_completed
+
+    return FeatureState(
+        issueId=issue_id,
+        currentStep=current_step,
+        completedSteps=mapped_completed,
+        stepTimestamps={},
+        reviewIterations=review_iterations,
+        mode="full",
+        skippedSteps=[],
+        createdAt=raw_data.get("createdAt", ""),
+        updatedAt=raw_data.get("updatedAt", ""),
+    )
+
+
 def validate_and_advance(
     state: FeatureState,
     completed_step: str,

devflow_cli/core/validators.py

@@ -6,6 +6,10 @@ import re
 from dataclasses import dataclass, field
 from pathlib import Path
 
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
+
 
 @dataclass
 class ValidationIssue:
@@ -85,6 +89,7 @@ def validate_artifact(step: str, artifact_path: Path) -> ValidationResult:
     try:
         content = artifact_path.read_text(encoding="utf-8")
     except (UnicodeDecodeError, OSError) as exc:
+        logger.warning("Failed to read artifact %s", artifact_path, exc_info=True)
         issues.append(ValidationIssue(
             type="encoding_error",
             message=f"Impossible de lire {artifact_path.name}: {exc}",
@@ -159,6 +164,7 @@ def _validate_contracts(
         try:
             content = artifact_path.read_text(encoding="utf-8")
         except (UnicodeDecodeError, OSError) as exc:
+            logger.warning("Failed to read artifact %s", artifact_path, exc_info=True)
             issues.append(ValidationIssue(
                 type="encoding_error",
                 message=f"Impossible de lire {artifact_path.name}: {exc}",

devflow_cli/utils/logging.py

@@ -0,0 +1,62 @@
+"""Configuration du logging pour la CLI devflow."""
+
+from __future__ import annotations
+
+import logging
+import sys
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+
+_LOG_DIR = ".devflow"
+_LOG_FILE = "devflow.log"
+_MAX_BYTES = 1_048_576  # 1 Mo
+_BACKUP_COUNT = 1
+_FORMAT = "%(asctime)s [%(levelname)s] %(name)s: %(message)s"
+
+_configured = False
+
+
+def setup_logging(verbose: bool = False) -> None:
+    """Configure le logging une seule fois.
+
+    - Fichier : .devflow/devflow.log (RotatingFileHandler, 1 Mo, 1 backup)
+    - Console : stderr uniquement si verbose=True
+    - Fallback : NullHandler si le fichier ne peut pas etre cree
+    """
+    global _configured
+    if _configured:
+        return
+    _configured = True
+
+    root = logging.getLogger("devflow_cli")
+    root.setLevel(logging.DEBUG)
+
+    formatter = logging.Formatter(_FORMAT)
+
+    # File handler avec rotation
+    try:
+        log_dir = Path(_LOG_DIR)
+        log_dir.mkdir(parents=True, exist_ok=True)
+        file_handler = RotatingFileHandler(
+            log_dir / _LOG_FILE,
+            maxBytes=_MAX_BYTES,
+            backupCount=_BACKUP_COUNT,
+            encoding="utf-8",
+        )
+        file_handler.setLevel(logging.DEBUG)
+        file_handler.setFormatter(formatter)
+        root.addHandler(file_handler)
+    except OSError:
+        root.addHandler(logging.NullHandler())
+
+    # Console handler (stderr) si verbose
+    if verbose:
+        console_handler = logging.StreamHandler(sys.stderr)
+        console_handler.setLevel(logging.DEBUG)
+        console_handler.setFormatter(formatter)
+        root.addHandler(console_handler)
+
+
+def get_logger(name: str) -> logging.Logger:
+    """Retourne un logger enfant de devflow_cli."""
+    return logging.getLogger(name)

devflow_cli/utils/paths.py

@@ -7,6 +7,10 @@ import re
 import subprocess
 from pathlib import Path
 
+from devflow_cli.utils.logging import get_logger
+
+logger = get_logger(__name__)
+
 
 def get_devflow_root() -> Path:
     """Racine du projet devflow (templates, commands, agents, extensions)."""
@@ -116,7 +120,7 @@ def next_feature_number(project_dir: Path | None = None) -> int:
                         if num > highest:
                             highest = num
         except (subprocess.TimeoutExpired, FileNotFoundError):
-            pass
+            logger.warning("Failed to scan git branches for feature numbers", exc_info=True)
 
         return highest + 1
 
@@ -132,5 +136,5 @@ def next_feature_number(project_dir: Path | None = None) -> int:
             fcntl.flock(f, fcntl.LOCK_EX)
             return _scan()
     except ImportError:
-        # Windows : pas de fcntl, on execute sans lock
+        logger.warning("fcntl not available (Windows) — running without file lock")
         return _scan()

{devflow_cli-2.0.0.dist-info → devflow_cli-2.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devflow-cli
-Version: 2.0.0
+Version: 2.3.0
 Summary: Spec-Driven Development workflow CLI
 Project-URL: Homepage, https://github.com/sopequenoteck/devflow
 Project-URL: Repository, https://github.com/sopequenoteck/devflow
@@ -117,7 +117,7 @@ devflow status
 Consultez la [documentation complète](docs/index.md) pour :
 
 - [Pipeline détaillé](docs/pipeline.md) — les 13 étapes expliquées
-- [Commandes CLI](docs/cli-reference.md) — référence des 11 commandes terminal
+- [Commandes CLI](docs/cli-reference.md) — référence des 12 commandes terminal
 - [Commandes slash](docs/commands-reference.md) — référence des 23 commandes Claude Code
 - [Guides par type de projet](docs/index.md#guides-par-type-de-projet) — brownfield, greenfield, microservices
 

devflow_cli-2.3.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+devflow_cli/__init__.py,sha256=mraf4w1I_7HJ4qRRyQ62xTVfVDHUSCTqmxuYeP4Px4M,2394
+devflow_cli/cli.py,sha256=4FdmMntfA7Uxpm45XUjx5LjOS6l_BpaukwLTHGGRRps,1759
+devflow_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devflow_cli/commands/check.py,sha256=84eXY1Oc2OXk-oNvDKS-FVXN954ykDJ6hnSHb30C3j0,4313
+devflow_cli/commands/context.py,sha256=hwTitOHxIpJMx1X8R1jHHy9CpE4HVZpJKkyeOujxAio,6246
+devflow_cli/commands/export_cmd.py,sha256=Mdvoh8oyainm0ulaaLd3pcx9m2s-Go--fFBeLS6i9Ts,4871
+devflow_cli/commands/extension.py,sha256=gL33YS8EuBTADmqKGDqw_0gJXFwccwg1uJmCNtvexhE,4373
+devflow_cli/commands/feature.py,sha256=GP_tZ7B3jMKb-cxXY3RC6yiv8mj5ZLyhHsXfIS1Ffhg,4238
+devflow_cli/commands/init_cmd.py,sha256=5hKBYKFCklTvVVQxF5Qx4gjqIlUQqxePY4nWct3HYJc,4659
+devflow_cli/commands/migrate_cmd.py,sha256=Kxz_Ml78UvDzjL1-4Gp3SJG_DrVDWGn9Ie2oc0in1N4,3423
+devflow_cli/commands/migrate_speckit.py,sha256=zs-6aCeLLePRj9mSxfr_VrMYs84JrEHUYIgheIERHVk,8284
+devflow_cli/commands/rollback.py,sha256=B-Qnmem_sAwmSwyFdzpzglbeX4uLd0t4ohsLYyHngl4,1789
+devflow_cli/commands/stale.py,sha256=xInmH5QywgxHCeAbpumwvUKqnk-XnY8FcURkXXPGic0,3208
+devflow_cli/commands/status.py,sha256=nPuudZPqCFWE2JqiCFOMKlN_CM_uDwD-gq9MbHBhg20,4775
+devflow_cli/commands/upgrade_cmd.py,sha256=xLOoaLXpyyJO4UuWLHjkXSGSX2IcL65-PQnoZAmwW9M,5029
+devflow_cli/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devflow_cli/core/catalog.py,sha256=nLPc78JkbISaSxJnHlWiMi_lvepaumbfwcjgLuVy7Zc,3102
+devflow_cli/core/git.py,sha256=o7Vk_n8b3-cAQa3CR1FblTZUvMDez7Ik4D9lrYI0njY,2561
+devflow_cli/core/hooks.py,sha256=KhG6BECui7IeoAERJAI6EWnRThqmSdeJCOxuk_xowe8,3189
+devflow_cli/core/installer.py,sha256=XGuugkWAV7McTnpdNZ2JX4NtEAE8CI73mfrYnKlb-JQ,4329
+devflow_cli/core/manifest.py,sha256=J7g2SzhXy-Vi4w9-rEPmARSZXo8KTOxfd2pEc9jNUME,5933
+devflow_cli/core/scanner.py,sha256=bcoC91Nc0Hw2P7aHpL-9ITxynLZhLTEKpOXo553a-18,4395
+devflow_cli/core/staleness.py,sha256=ASe-rlYN17AtpI_S4QlidaHwbtv7E7L4fhRGYtyTlPE,5586
+devflow_cli/core/state.py,sha256=tkMScnTSMp8nQm_AElDJPqV_RtcXWpq29CJYfdNpBXI,12515
+devflow_cli/core/validators.py,sha256=rW8JCveYjf8KtOR2Q7v2mdvhYfB0qQnC3FBuWYLmytE,6445
+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=C_0Jmiz4LRoelyFYWA42ehGTg6R2UnBxllBo5_LZ1HI,4400
+devflow_cli/utils/strings.py,sha256=bfFXCwBDnFxshgZOYfy6mtysnjiaWO1wFnqBf7HLg4o,351
+devflow_cli-2.3.0.dist-info/METADATA,sha256=1GDvGXx3RXvmsxOq-Ldc-9vgwS13lAHrxQaBU1x7jt4,4896
+devflow_cli-2.3.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+devflow_cli-2.3.0.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
+devflow_cli-2.3.0.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
+devflow_cli-2.3.0.dist-info/RECORD,,

devflow_cli-2.0.0.dist-info/RECORD

@@ -1,33 +0,0 @@
-devflow_cli/__init__.py,sha256=4C2mALrQiTmJMZx99CT2fViXvKO5_IFzMStcTLumeeg,1400
-devflow_cli/cli.py,sha256=UxuYGV0TgsnoVV_-vp2Ce1sUTkc61Viyr13X_2HEP-o,1458
-devflow_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-devflow_cli/commands/check.py,sha256=sb5zkSXXwl91o8yn1-TRL5wH89MWX-kY2CAHYYjMxq4,4170
-devflow_cli/commands/context.py,sha256=hwTitOHxIpJMx1X8R1jHHy9CpE4HVZpJKkyeOujxAio,6246
-devflow_cli/commands/export_cmd.py,sha256=Mdvoh8oyainm0ulaaLd3pcx9m2s-Go--fFBeLS6i9Ts,4871
-devflow_cli/commands/extension.py,sha256=gL33YS8EuBTADmqKGDqw_0gJXFwccwg1uJmCNtvexhE,4373
-devflow_cli/commands/feature.py,sha256=EceMCxYEif4P6Ir-1XZml4txLH9iqm3jEAeS6dJ8LpA,4098
-devflow_cli/commands/init_cmd.py,sha256=LLUJx_Kdl-YCEuy1corvaYe65pZ6R5-VnVBal6wZSa4,4513
-devflow_cli/commands/migrate_cmd.py,sha256=y2_yWyBabMgDZ0e2CsX2nYtb33yQRyr4zcrj858Ieoo,3274
-devflow_cli/commands/regen.py,sha256=UyB7_0oBxDs_CqaAQ6yE2Yoz4IcpUr2bqkIEmm0e1iM,3198
-devflow_cli/commands/rollback.py,sha256=B-Qnmem_sAwmSwyFdzpzglbeX4uLd0t4ohsLYyHngl4,1789
-devflow_cli/commands/status.py,sha256=nPuudZPqCFWE2JqiCFOMKlN_CM_uDwD-gq9MbHBhg20,4775
-devflow_cli/commands/upgrade_cmd.py,sha256=xLOoaLXpyyJO4UuWLHjkXSGSX2IcL65-PQnoZAmwW9M,5029
-devflow_cli/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-devflow_cli/core/catalog.py,sha256=oMBZRigOtpAQceu3slV8UpuKSZpkxQcr4xtjZXyFHYY,2949
-devflow_cli/core/git.py,sha256=WL8tU3f5KcNyF5aL669Gzy73OIvuC_CCGZdt8TzWvXc,2346
-devflow_cli/core/hooks.py,sha256=EHIlpwmDYHshaDijiLCEoPDbnV9T7jDttOCnpRRx0HU,3025
-devflow_cli/core/installer.py,sha256=XGuugkWAV7McTnpdNZ2JX4NtEAE8CI73mfrYnKlb-JQ,4329
-devflow_cli/core/manifest.py,sha256=5hu2w6PPGo4raGbgKzx6qpAtt653SrzpRkbWngHM9qw,5770
-devflow_cli/core/scanner.py,sha256=bcoC91Nc0Hw2P7aHpL-9ITxynLZhLTEKpOXo553a-18,4395
-devflow_cli/core/staleness.py,sha256=ASe-rlYN17AtpI_S4QlidaHwbtv7E7L4fhRGYtyTlPE,5586
-devflow_cli/core/state.py,sha256=M7pldLzXekgQWwPXFYg62CQ-q_4C9Es1lza74qAmCGM,9433
-devflow_cli/core/validators.py,sha256=3PtqC-R2kqNbh4HK_l_Yl8RylQsFdtCXhopt0yT065k,6194
-devflow_cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-devflow_cli/utils/console.py,sha256=t7cpyeEluWj4v_O_KFSI59iqXK4GiSXPuxlsr8q5zoQ,771
-devflow_cli/utils/paths.py,sha256=9J2Qhq2Ot6p7HQwRAfdK3V5bc5sme6FnnnAg9dhXcP4,4212
-devflow_cli/utils/strings.py,sha256=bfFXCwBDnFxshgZOYfy6mtysnjiaWO1wFnqBf7HLg4o,351
-devflow_cli-2.0.0.dist-info/METADATA,sha256=1nrITovXCXduwSNOfg0dRgHecrAbZoCO6fiWoe8tyeA,4896
-devflow_cli-2.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-devflow_cli-2.0.0.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
-devflow_cli-2.0.0.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
-devflow_cli-2.0.0.dist-info/RECORD,,