devflow-cli 2.0.0__py3-none-any.whl → 2.2.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.2.0"
 
 STEPS = [
     "constitution",  # Pré-requis projet (1/projet). Auto-complétée si .specify/memory/constitution.md existe.
@@ -51,6 +51,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",

devflow_cli/cli.py

@@ -15,6 +15,7 @@ from devflow_cli.commands.regen import regen
 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(
@@ -47,6 +48,7 @@ app.command()(regen)
 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/migrate_speckit.py

@@ -0,0 +1,219 @@
+"""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.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:
+                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:
+            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:
+        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:
+            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/core/state.py

@@ -7,7 +7,7 @@ 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
 
 
 @dataclass
@@ -262,6 +262,74 @@ 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):
+        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-2.0.0.dist-info → devflow_cli-2.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devflow-cli
-Version: 2.0.0
+Version: 2.2.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.0.0.dist-info → devflow_cli-2.2.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-devflow_cli/__init__.py,sha256=4C2mALrQiTmJMZx99CT2fViXvKO5_IFzMStcTLumeeg,1400
-devflow_cli/cli.py,sha256=UxuYGV0TgsnoVV_-vp2Ce1sUTkc61Viyr13X_2HEP-o,1458
+devflow_cli/__init__.py,sha256=VCGzz5uVlYBpsURHQZexi_70jMAIuYAHQWhxTfVjDjs,1643
+devflow_cli/cli.py,sha256=HxxFDISXAYvv5dMvI_xNx1mhUdhQSsa_fqvFtzsN_bM,1576
 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
@@ -8,6 +8,7 @@ devflow_cli/commands/extension.py,sha256=gL33YS8EuBTADmqKGDqw_0gJXFwccwg1uJmCNtv
 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/migrate_speckit.py,sha256=NbHgTbrWi9vtvD1OQz0VLSSY5hv68KlU_Fsh-ovlHx8,7870
 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
@@ -20,14 +21,14 @@ devflow_cli/core/installer.py,sha256=XGuugkWAV7McTnpdNZ2JX4NtEAE8CI73mfrYnKlb-JQ
 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/state.py,sha256=EvfX-s3mBLIaOI6OzpRkeQQfdb2mB7S8UZ2EGJ0ZSYk,12038
 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,,
+devflow_cli-2.2.0.dist-info/METADATA,sha256=I2tCqZ3vTDs_DjcIcOwGbgG3LHlze_x1BtxmIm8uoQg,4896
+devflow_cli-2.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+devflow_cli-2.2.0.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
+devflow_cli-2.2.0.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
+devflow_cli-2.2.0.dist-info/RECORD,,