sdd-reverse-analyze

/sdd-reverse-analyze {U-N} [--json]

Rôle

Lancer la Phase 3a (premier barreau de l'escalier reverse) : transformer une unité fonctionnelle (Phase 1) en analyse technique legacy — photo fidèle du code, sans interprétation métier. Une seule unité par invocation.

code source --[3a /sdd-reverse-analyze]--> plans/{n}-{FeatName}.analysis.md
            --[3b /sdd-reverse-stories]--> us/{n}-{m}-{Name}.md
            --[3c /sdd-reverse-feat]------> feats/{n}-{FeatName}.md

En mode pré-alloué (L5, preallocate_feats exécuté), plusieurs invocations peuvent tourner en parallèle borné (§8.2 rules/reverse-engineering.md) ; sans pré-allocation, séquentiel strict (ADV-2 §8.1). 3a possède l'allocation (n, FeatName) que 3b/3c réutilisent.

Args

Arg	Type	Description
{U-N}	string requis	Identifiant U-N stable (ex. U-3) — résolu via inventory.json.units[]
--json	flag	Émet le rapport d'analyse en JSON

Pré-conditions

1. workspace/old/{P}/.sys/inventory.json existe ET passe gate ADV-23 (schemaVersion == 1, _allocatedNames + _featAllocations présents). Sinon → ERROR [REVERSE_INVENTORY_SCHEMA_STALE] + suggérer /sdd-reverse-inventory --refresh.
2. units[id="{U-N}"] existe. Sinon → ERROR [REVERSE_UNIT_NOT_FOUND].
3. .sdd/python/sdd_reverse/analysis.reverse.template.md présent (ADV-9). Sinon → ERROR [REVERSE_TEMPLATE_MISSING].
4. (Mode legacy uniquement) Lock workspace/feats/.alloc.lock libre OU stale > 30 min (TTL 1800s). Sinon → ERROR [REVERSE_LOCK_HELD]. En mode pré-alloué, aucun lock (C5).

Actions

1. Résoudre le projet legacy : lire workspace/old/*/.sys/inventory.json pour trouver lequel contient units[id={U-N}]. Plusieurs matchs → ERROR ambiguïté, demander --project {P}. Le nom retenu est {P} — toutes les étapes suivantes l'utilisent, jamais un re-glob.
2. Routage de tier (déterministe, ADR governance-reverse-complexity-ladder) — sur le projet {P} résolu en 1 :

   python .sdd/python/sdd_reverse/code_unit_complexity.py \
       --project workspace/old/{P} --unit {U-N} --rung 3a
   

   → imprime balanced si l'unité est simple, deep si complex (rubrique docs/rubrics/reverse-complexity-routing.md). Fail-safe câblé : toute erreur (inventory absent/illisible, {U-N} inconnu) imprime deep sur stdout ET la raison sur stderr, exit 0 — le doute coûte une passe deep, jamais un traceback ni une sous-analyse.
3. Spawn unique Agent(reverse-tech-analyst) avec args = {U-N} ET model_tier = le tier routé en 2 (override au spawn, borné par tier_floor/tier_ceiling de l'agent — l'agent est inchangé, seul son tier d'exécution varie ; no-spawn préservé).
4. L'agent suit STEP 0 à 7 de .sdd/agents/reverse-tech-analyst.md.
5. Émission ligne chat finale [REVERSE] {U-N} → analyse 3a {n}-{FeatName} ({modèle}, ...). (PROGRESS%).