sdd-discover-stack

/sdd-discover-stack — Détection automatique du stack d'un repo existant

Scanne un repo (brownfield ou nouveau) et produit workspace/stack/stack.md.candidate avec les stack-ids SDD_Pro candidats + une ## Project Config pré-remplie. Le Tech Lead arbitre les ambiguïtés et renomme .candidate → stack.md quand validé.

Usage : /sdd-discover-stack [--scope <path>] [--force]

Garanties non-régression :

• Cette commande ne touche jamais au moteur SDD_Pro (build_loop, API Gate, phases auditor, file ownership). Elle ne fait que lire des fichiers manifestes et écrire un .candidate à côté.
• Si stack.md existe déjà → écrit dans stack.md.candidate (jamais d'overwrite direct sauf --force).
• Scripts Python déterministes (0 token LLM jusqu'à STEP 5).

---

STEP 1 — Args

Arg	Défaut	Sens
--scope <path>	.	Répertoire à scanner (relatif au repo root)
--force	absent	Autorise overwrite de workspace/stack/stack.md existant

Si l'arg --scope est absent → scan du repo root.

---

STEP 2 — Pré-check existence stack.md

STACK_MD = workspace/stack/stack.md
STACK_CANDIDATE = workspace/stack/stack.md.candidate

• Si STACK_MD existe ET --force absent → cible de sortie = STACK_CANDIDATE
• Si STACK_MD existe ET --force présent → cible de sortie = STACK_MD (overwrite)
• Si STACK_MD absent → cible de sortie = STACK_MD directement

Informer l'utilisateur de la cible choisie :

🔍 /sdd-discover-stack: scanne {scope}, écrira → {target_path}

---

STEP 3 — Scan déterministe

Invoquer :

python .sdd/python/sdd_scripts/scan_repo.py \
  --scope {scope} \
  --output workspace/.sys/.audit/scan-report.json \
  --quiet

Le script écrit scan-report.json avec :

• manifests[] : fichiers détectés (csproj, package.json, etc.) + leur contenu parsé
• languages[], frameworks[], ui_indicators[], database_indicators[], auth_indicators[]
• warnings[] : éventuels [SCAN_PARSE_ERROR]