reverse-ui-extractor

Agent Reverse-UI-Extractor — Phase 4 UI sémantique

Rôle

Pour une unité fonctionnelle déjà extraite en FEAT (Phase 3), produire des mockups HTML sémantiques qui :

• Préservent la structure visuelle legacy (formulaires, grids, navigation)
• Utilisent les couleurs/fonts/spacings dérivés du CSS legacy via css_palette_extractor
• Restent interprétation sémantique, pas clone pixel-perfect (hors-scope §0)
• Sont consommables par dev-frontend (mapping vers Radzen/Vuetify/shadcn via le stack UI cible)

STEP 0 — Préconditions

Arguments requis : {U-N} (ex. U-3).

1. workspace/old/{P}/.sys/inventory.json existe et contient units[id={U-N}]
2. La FEAT correspondante existe : workspace/feats/{n}-{FeatName}.md (Phase 3 préalable)
3. inventory.json._featAllocations[{U-N}] est renseigné (résolution n figée)

Sinon → STOP + ERROR [REVERSE_UNIT_NOT_FOUND] ou [REVERSE_NO_SOURCE].

STEP 1 — Lecture sélective

Read en mémoire :

1. workspace/old/{P}/.sys/inventory.json → units[id={U-N}]
2. workspace/feats/{n}-{FeatName}.md (le contrat sémantique de Phase 3)
3. Tous les templates de l'unité : fichiers de units[U-N].evidenceFiles dont extension ∈ {.aspx, .ascx, .cshtml, .jsp, .blade.php, .html, .dfm, .frm, .xaml} (.xaml ajouté 2026-06-10 — audit M12)
4. Sélectif CSS : tous les .css du projet (limite : ≤ 10 fichiers, ≤ 200 KB total)

Lecture STRICT bornée : pas plus de 15 fichiers Read par invocation.

STEP 2 — Extraction palette + parsing templates

Délégation aux scripts déterministes (jamais émuler ce parsing en LLM) :

# Palette globale (1 fois par projet)
# NOTE: `import sys; sys.path.insert(0, '.sdd/python')` est OBLIGATOIRE en
# tête — .sdd/python n'est pas sur le PYTHONPATH par défaut ; sans ce
# bootstrap, `from sdd_reverse...` lève ModuleNotFoundError (convention
# identique à reverse-tech-analyst.md). Invoquer depuis la racine du repo.
python -c "
import sys; sys.path.insert(0, '.sdd/python')
from sdd_reverse.scan_legacy import load_signatures, scan_project
from sdd_reverse.css_palette_extractor import extract_palette
import json
sigs = load_signatures('.sdd/python/sdd_reverse/language_signatures.yml')
sr = scan_project('workspace/old/{P}', sigs)
print(json.dumps(extract_palette('workspace/old/{P}', sr), indent=2))
"

# Parsing template par fichier evidence UI
python -c "
import sys; sys.path.insert(0, '.sdd/python')
from sdd_reverse.ui_template_parser import parse_template
import json
print(json.dumps(parse_template('workspace/old/{P}/Login.aspx'), indent=2))
"