Kill_LIFE/docs/plans/21_plan_refonte_globale_yiacad.md

Plan 21 - refonte globale YiACAD (2026-03-20)

Intention

Construire la couche de pilotage globale qui assemble audit, IA, docs, plans, TODOs, TUI et lot suivant autour de YiACAD.

Lanes et responsables

Lane	Owner	Sous-agent / role	Competences	Write-set principal
Audit-Core	Architect / Doc	Audit-Core	analyse repo, synthese, cartes	docs/YIACAD_GLOBAL_*, specs/yiacad_global_refonte_spec.md
AI-Integration	Architect / CAD	AI-Integration	MCP, CAD IA-native, orchestration	docs/YIACAD_GLOBAL_AI_*, docs/YIACAD_GLOBAL_OSS_*
DesignOps-UI	CAD / DesignOps	UI-Orchestrator	palette, inspector, review center	forks CAD + docs/plans/20_*
CAD-Native	CAD	KiCad-Native, FreeCAD-Native	shells natifs, backend path, context propagation	.runtime-home/cad-ai-native-forks/*, tools/cad/*
Ops-TUI	PM / Doc	TUI-Operator	bash TUI, logs, purge, status	tools/cockpit/yiacad_refonte_tui.sh, artifacts/yiacad_refonte_tui/*
Docs-Continuity	Doc	Docs-Continuity	README, runbook, index, coherence	README.md, docs/index.md, docs/RUNBOOK.md

Sequence recommandee

1. Audit global et recherche OSS
2. Spec et feature map globales
3. Plan / TODO / owners / write-sets
4. TUI globale et logs
5. Passage vers T-UX-004

Risques a contenir

• dispersion documentaire
• coexistence de plusieurs TUI proches
• backend YiACAD encore trop leger
• confusion entre lane UI/UX et refonte globale

Critere de sortie

• tout nouvel arrivant sait ou lire l'audit, la spec, le plan, le TODO, la recherche et la commande TUI d'entree
• le prochain lot est formule explicitement et sans ambiguite

Etat canonique 2026-03-20

• bundle global publie: audit, IA, cartes, OSS, spec, plan, TODO, TUI
• lot suivant produit: T-UX-004
• lot suivant architecture: T-ARCH-101C
• lot ops ferme: T-OPS-118
• palier architecture livre:
  • backend local yiacad_backend.py
  • context broker schema + example
  • uiux_output.json et context.json prepares pour les surfaces produit
• objectif de ce plan:
  • eviter les deltas contradictoires
  • garder une entree lisible entre refonte globale et refonte UI/UX

Delta 2026-03-21 - T-OPS-118 operator index

• T-OPS-118 pose une entree operateur stable: tools/cockpit/yiacad_operator_index.sh.
• Cette surface ne remplace pas les TUI existantes; elle route explicitement vers yiacad_uiux_tui.sh et yiacad_refonte_tui.sh.
• La commande d’entree et la doc associee deviennent auditables via docs/YIACAD_OPERATOR_INDEX_2026-03-21.md.

Delta 2026-03-21 - T-ARCH-101 closure

• T-ARCH-101 est ferme au niveau parent.
• La couche locale YiACAD est maintenant formalisee autour de:
  • tools/cad/yiacad_backend.py
  • tools/cad/yiacad_native_ops.py
  • tools/cad/yiacad_backend_service.py
• Le front architecture encore actif devient T-ARCH-101C: reroutage progressif des shells natifs vers la facade backend locale.

Delta 2026-03-21 - operator entrypoint

• l'entree operateur stable est maintenant tools/cockpit/yiacad_operator_index.sh.
• ce point d'entree route explicitement vers la lane UI/UX (20) et la lane globale (21).

Delta 2026-03-21 - T-UX-005

• le lot produit suivant execute apres T-UX-004A est maintenant livre: review center enrichi sur KiCad et FreeCAD.
• l'enchainement naturel devient T-UX-006 puis T-ARCH-101C.

Delta 2026-03-21 - T-ARCH-101C tranche KiCad

• premiere tranche de reroutage shell executee sans ouvrir de hotspot compile:
  • le plugin KiCad YiACAD passe maintenant par la facade locale tools/cad/yiacad_backend_service.py
  • le fallback direct yiacad_native_ops.py reste en place si la facade n'est pas presente
• cette tranche ferme le plus petit write-set utile cote KiCad:
  • .runtime-home/cad-ai-native-forks/kicad-ki/scripting/plugins/yiacad_kicad_plugin/_native_common.py
• la convergence FreeCAD vers la meme facade reste ouverte dans T-ARCH-101C.

Delta 2026-03-21 - T-ARCH-101C tranche FreeCAD

• deuxieme tranche de reroutage shell executee sur le plus petit helper Python utile:
  • yiacad_freecad_gui.py privilegie maintenant tools/cad/yiacad_backend_service.py
  • les call sites UI FreeCAD restent inchanges; seul le transport vers le backend a ete reroute
• le fallback direct yiacad_native_ops.py reste disponible si la facade locale est absente.

Delta 2026-03-21 - T-ARCH-101C preuve operateur unifiee

• un runbook canonique de preuve operateur est maintenant publie:
  • tools/cockpit/yiacad_backend_proof.sh
  • docs/YIACAD_BACKEND_OPERATOR_PROOF_2026-03-21.md
• cette preuve verifie:
  • statut de la facade locale,
  • transport shell KiCad vers la facade,
  • transport workbench FreeCAD vers la facade,
  • presence du contrat uiux_output sur les actions de preuve.
• yiacad_uiux_tui.sh --action status passe maintenant lui aussi par le client service-first.
• T-ARCH-101C est ferme pour les surfaces actives; les suites de travail sont reparties entre T-UX-003, T-UX-004 et T-RE-209.

Delta 2026-03-21 - T-UX-006

• la persistance de session de base est maintenant en place sur les deux surfaces deja YiACAD.
• l'enchainement naturel devient T-ARCH-101C, puis une session de revue plus riche cote produit.

Delta 2026-03-21 - backend service

• T-ARCH-101C est maintenant livre sur les surfaces actives Python via un backend local et un client service-first.
• une surface operatoire dediee existe maintenant: tools/cockpit/yiacad_backend_service_tui.sh.

Delta 2026-03-21 - T-UX-006D raccord global

• la couche produit YiACAD ajoute maintenant une vue de contexte de revue consolidée au-dessus de la session persistée et de l’historique.
• ce palier ferme un besoin opératoire utile sans ouvrir les surfaces compilées plus risquées.

2026-03-21 - Lot update

• T-ARCH-101C est maintenant ferme: les surfaces actives KiCad / FreeCAD et la TUI UI/UX passent en service-first via tools/cad/yiacad_backend_client.py, avec auto-start du service local et fallback direct vers tools/cad/yiacad_native_ops.py.
• T-OPS-119 consolide: tools/cockpit/yiacad_operator_index.sh devient l'entree operateur stable avec status, uiux, global, backend, proofs et des alias de compatibilite conserves.
• Validation executee: bash tools/cockpit/yiacad_backend_proof.sh --action run --json retourne status=done.
• Risque residuel: l'extension aux call sites compiles restants et la persistance produit restent traitees par T-UX-003, T-UX-004 et T-RE-209.

2026-03-21 - Proofs lane

• Nouveau point d'entree: bash tools/cockpit/yiacad_proofs_tui.sh --action status.
• Objectif: centraliser backend, review-session, review-history, review-taxonomy et l'hygiene des logs dans une surface canonique sans casser les alias historiques.
• Documentation: docs/YIACAD_PROOFS_TUI_2026-03-21.md.