Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions docs/reference/_archive-convention.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
Un dossier `_archive/` sans convention devient un **puits de code mort** : on y dépose des scripts superseded, mais sans en-tête de disposition, personne ne sait s'ils sont **encore vivants mal étiquettés** ou **réellement abandonnés**. Le bilan mesuré sur le dépôt en 2026-08 :

- 11 emplacements `_archive/` dispersés (125 fichiers au total au 2026-08), conventions hétérogènes.
- `scripts/genai-stack/_archive/` (constat empirique au 2026-08, **hors scope PR actuelle**) : 28 fichiers (37 % du répertoire) — code mort, certains cassés auto-admis. **Cible de la tranche 3** (cf table lignes 73-85).
- `scripts/genai-stack/_archive/` (constat empirique au 2026-08) : le plus gros stock du dépôt — code mort, certains cassés auto-admis. **Tranche 3 livrée le 2026-10-04** (cf table ci-dessous).
- `scripts/_archive/one_shot_fixes/` + `one_shots_post_463/` + `recycle_csp/` (constat empirique au 2026-08) : ~30 fichiers dont les README de disposition n'appliquaient pas encore tous le standard. **Cible de la tranche 2** (cf table lignes 73-85).

Le coût d'un `_archive/` non standardisé = **découverte impossible** : aucun successeur nommé, aucun verdict enregistré, aucun moyen de savoir si le script peut être ressuscité ou doit être supprimé.
Expand Down Expand Up @@ -68,7 +68,7 @@ Exception : si un dossier `_archive/` ne contient que des **données** (pas de s

## Application — les emplacements recensés

État au **2026-09-25**. Ce qui a changé depuis le recensement de 2026-08 :
État au **2026-10-04**. Ce qui a changé depuis le recensement de 2026-08 :
`GenAI/Audio`, `docker-configurations` et `notebook_tools` n'y figuraient pas.
La table ci-dessous est l'inventaire courant — chaque tranche de l'umbrella en
déplace une ligne, elle ne réécrit pas un total :
Expand All @@ -84,17 +84,18 @@ déplace une ligne, elle ne réécrit pas un total :
| `MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning/_archive/` | ✅ | ✅ (registre de disposition au niveau `_archive/` ajouté le 2026-09-25 — tranche #13749 ; il pointe le README du lot daté `2026-07-04-Neurosymbolic-EML-precurseur-SL12/`, qui porte l'analyse) |
| `MyIA.AI.Notebooks/SymbolicAI/Tweety/scripts/_archive/` | ✅ | ✅ (tranche #13749 du 2026-09-25 : registre + en-tête de disposition ajouté à `reorganize_tweety.py`) |
| `scripts/_archive/` | ✅ | ✅ (registre parent ajouté le 2026-09-25 — tranche #13749 ; il indexe `c8257-lean18-enrichment/`, `one_shot_fixes/`, `one_shots_post_463/` et `recycle_csp/`. La ligne précédente marquait `✅` sur les seules sous-archives de #9535 et ne citait pas `c8257-lean18-enrichment/`, archivée plus tard par #14251) |
| `scripts/genai-stack/_archive/` | ❌ | tranche 3 — le plus gros stock constaté (2026-08), peut nécessiter un split ; **à la lane `myia-po-2027:CoursIA-2`** (claim scoped `{core,utils}`) |
| `scripts/genai-stack/_archive/` | ✅ | ✅ (tranche #13749 du 2026-10-04 — lane `myia-po-2027:CoursIA-2` : registre 4 colonnes dans `ARCHIVE_README.md`, nom historique **préservé** car les en-têtes per-fichier et le README parent pointent dessus ; en-têtes de disposition standard ajoutés aux `.ps1` ; les `.py` gardent leurs en-têtes hérités format court, qui nomment successeur + registre) |
| `scripts/notebook_tools/_archive/` | ✅ | partiel (registre sans en-tête de disposition pour le script) |
| `scripts/sudoku/_archive/` | ✅ | ✅ (tranche #13749 du 2026-09-25 : registre 4 colonnes ; les en-têtes per-fichier existaient déjà) |
| `scripts/tests/_archive/` | ✅ | ✅ (tranche #13749 du 2026-10-04 : registre ajouté ; l'en-tête standard existait déjà sur `test_convert_print_to_deploy.py`, palier 1 #18153) |
| `slides/S4-trading-algorithmique/_archive/` | ✅ | ✅ (registre — une ligne par fichier archivé) |
| `docker-configurations/_archive-20251125/` | ✅ | non audité |

**Plan d'application** : tranches ciblées successives (cf umbrella #13749), une PR par tranche, dans les seuils d'anti-composite de la [§A du review](../../.claude/rules/pr-review-discipline.md) (cf G.4).

## Cas particuliers

- **`_archive/utils/reconstruct_env.py`** (genai-stack, récent) : vérifier si le sujet est couvert par la feature CLI avant d'archiver — peut être du vivant mal étiquetté. Tranche 3 fait l'audit.
- **`_archive/utils/reconstruct_env.py`** (genai-stack) : audit fait le 2026-10-04 (tranche #13749) — le sujet **est couvert** par le CLI (`genai.py auth reconstruct-env`, câblé `commands/auth.py` → `core/auth_manager.py::reconstruct_env_file`) : du mort correctement étiqueté, pas du vivant mal étiqueté.
- **`DSA AgenticDataScience/` + `PythonAgentsForDataScience/`** : dossiers ne contenant QUE des `*_output.ipynb` (sources migrées Track1/Track2) → supprimer après vérif `execution_count`/consommateurs (fantômes). Tranche séparée, hors #13749.
- **Scripts archive sans successeur** : la ligne de travail doit être **explicitement fermée** dans le PR d'archivage (raison + lien vers la discussion de clôture). Sans cette fermeture, le script n'est pas archivable — il est juste mort.

Expand Down
117 changes: 64 additions & 53 deletions scripts/genai-stack/_archive/ARCHIVE_README.md
Original file line number Diff line number Diff line change
@@ -1,56 +1,67 @@
# Archive - Scripts Legacy GenAI Stack

Ce repertoire contient les fichiers archives lors de la consolidation de fevrier 2026.
Ces fichiers sont conserves pour reference mais ne sont plus utilises activement.

## Pourquoi ces fichiers sont archives

La consolidation a remplace ~35 scripts eparpilles par un CLI unifie `genai.py` avec 6 modules
(`commands/docker.py`, `commands/validate.py`, `commands/notebooks.py`, `commands/models.py`,
`commands/gpu.py`, `commands/auth.py`) et une configuration partagee (`config.py`).

## Fichiers depuis core/

| Fichier | Raison | Remplace par |
|---------|--------|-------------|
| `validate_mission_documentation.py` | Valide des docs de mission nov 2025 inexistantes | - |
| `test_correction_setup_complete.py` | Importe `setup_complete_qwen` inexistant (CASSE) | - |
| `diagnose_comfyui_auth.py` | Importe `docker_qwen_manager` inexistant (CASSE) | `genai.py auth audit` |
| `deploy_comfyui_auth.py` | Deploiement one-shot | `genai.py docker start` |
| `cleanup_comfyui_auth.py` | Nettoyage one-shot | `genai.py auth` |
| `validate_genai_ecosystem.py` | 873 lignes, chevauche validate.py | `genai.py validate --full` |

## Fichiers depuis utils/ (tout le repertoire)

| Fichier | Raison | Remplace par |
|---------|--------|-------------|
| `comfyui_client_helper.py` | 1418 lignes, remplace par core/comfyui_client.py (269 lignes) | `core/comfyui_client.py` |
| `validate_genai_stack.py` | Remplace par validate_stack.py puis commands/validate.py | `genai.py validate` |
| `validate_mission_documentation.py` | DOUBLON EXACT de core/ | - |
| `token_manager.py` | Remplace par core/auth_manager.py | `genai.py auth` |
| `token_synchronizer.py` | Remplace par core/auth_manager.py sync | `genai.py auth sync` |
| `validate_tokens_simple.py` | Remplace par core/auth_manager.py audit | `genai.py auth audit` |
| `reconstruct_env.py` | Remplace par core/auth_manager.py reconstruct-env | `genai.py auth reconstruct-env` |
| `consolidated_tests.py` | Importe token_manager + comfyui_client_helper (legacy) | `genai.py validate` |
| `diagnostic_utils.py` | Jamais appele depuis aucun script actif | - |
| `diagnostic_model_paths.py` | Script one-shot Phase 29, probleme resolu | - |
| `validate_all_models.py` | Remplace par validate_stack.py --full | `genai.py validate --full` |
| `benchmark.py` | Hardcode login/password, auth par cookie obsolete | - |
| `workflow_utils.py` | Remplace par core/comfyui_client.py WorkflowManager | `core/comfyui_client.py` |
| `validate_gpu_cuda.py` | Absorbe dans commands/gpu.py | `genai.py gpu --detailed` |
| `test_forge_connectivity.py` | Absorbe dans commands/validate.py | `genai.py validate --check-forge` |
| `test_forge_notebook.py` | 3 lignes papermill | `genai.py notebooks` |
| `debug_proxy.py` | Proxy debug ponctuel | - |
| `docker-setup.ps1` | Remplace par docker_manager.py/genai.py docker | `genai.py docker start` |
| `docker-start.ps1` | Remplace par docker_manager.py/genai.py docker | `genai.py docker start` |
| `docker-stop.ps1` | Remplace par docker_manager.py/genai.py docker | `genai.py docker stop` |

## Fichier depuis racine

| Fichier | Raison | Remplace par |
|---------|--------|-------------|
| `manage-genai-stack.ps1` | PowerShell remplace par Python multi-plateforme | `genai.py docker` |
# Registre d'archive — Scripts legacy GenAI Stack

Registre de disposition au standard de la [convention `_archive/`](../../../docs/reference/_archive-convention.md)
(colonnes : Script | Verdict | Superseded by | Verdict recorded in).

Ce répertoire contient les fichiers archivés lors de la **consolidation de février 2026**, qui a
remplacé les scripts éparpillés du stack par le CLI unifié `genai.py` (`scripts/genai-stack/genai.py`,
modules `commands/{docker,validate,notebooks,models,gpu,auth}.py` + `config.py`). Tous les verdicts
ci-dessous sont **datés de cette consolidation**, sauf mention contraire.

**Nom de fichier historique préservé.** Le registre s'appelle `ARCHIVE_README.md` (et non
`README.md`) parce que les en-têtes per-fichier `# ARCHIVED: ...` de chaque script archivé, ainsi
que la ligne du README parent (`scripts/genai-stack/README.md`), pointent sur ce nom — le renommer
casserait ces références sans gain de substance.

**Colonne « Verdict recorded in ».** La consolidation de février 2026 **précède l'entrée du répertoire
dans git** : l'intégralité de `scripts/genai-stack/` n'est trackée que depuis #18838 (2026-10-02),
qui a committé ces fichiers déjà archivés, avec leurs en-têtes. Le verdict durable vit donc dans ce
registre ; #18838 en est la preuve d'entrée en git.

## Fichiers depuis `core/`

| Script | Verdict | Superseded by | Verdict recorded in |
|--------|---------|---------------|---------------------|
| `cleanup_comfyui_auth.py` | OBSOLETE — nettoyage one-shot | `genai.py auth` | ce registre ; #18838 |
| `deploy_comfyui_auth.py` | OBSOLETE — déploiement one-shot | `genai.py docker start` | ce registre ; #18838 |
| `diagnose_comfyui_auth.py` | BROKEN — import `docker_qwen_manager` inexistant | `genai.py auth audit` | ce registre ; #18838 |
| `test_correction_setup_complete.py` | BROKEN — import `setup_complete_qwen` inexistant | none — closed dead-end | ce registre ; #18838 |
| `validate_genai_ecosystem.py` | OBSOLETE — volumineux, chevauche `validate.py` | `genai.py validate --full` | ce registre ; #18838 |
| `validate_mission_documentation.py` | OBSOLETE — valide des docs de mission nov 2025 inexistantes | none — closed dead-end | ce registre ; #18838 |

## Fichiers depuis `utils/` (tout le répertoire)

| Script | Verdict | Superseded by | Verdict recorded in |
|--------|---------|---------------|---------------------|
| `benchmark.py` | OBSOLETE — hardcode login/password, auth par cookie obsolète | none — closed dead-end (ne pas ressusciter : identifiants en dur) | ce registre ; #18838 |
| `comfyui_client_helper.py` | OBSOLETE — remplacé par un client plus compact | `core/comfyui_client.py` | ce registre ; #18838 |
| `consolidated_tests.py` | BROKEN — importe `token_manager` + `comfyui_client_helper` (legacy) | `genai.py validate` | ce registre ; #18838 |
| `debug_proxy.py` | OBSOLETE — proxy debug ponctuel | none — closed dead-end | ce registre ; #18838 |
| `diagnostic_model_paths.py` | OBSOLETE — one-shot Phase 29, problème résolu | none — closed dead-end | ce registre ; #18838 |
| `diagnostic_utils.py` | OBSOLETE — jamais appelé depuis aucun script actif | none — closed dead-end | ce registre ; #18838 |
| `docker-setup.ps1` | OBSOLETE — remplacé par `docker_manager.py` / `genai.py docker` | `genai.py docker start` | ce registre ; #18838 |
| `docker-start.ps1` | OBSOLETE — remplacé par `docker_manager.py` / `genai.py docker` | `genai.py docker start` | ce registre ; #18838 |
| `docker-stop.ps1` | OBSOLETE — remplacé par `docker_manager.py` / `genai.py docker` | `genai.py docker stop` | ce registre ; #18838 |
| `reconstruct_env.py` | OBSOLETE — remplacé par `core/auth_manager.py` | `genai.py auth reconstruct-env` (successeur vérifié le 2026-10-04 : action câblée dans `commands/auth.py` → `core/auth_manager.py::reconstruct_env_file`) | ce registre ; #18838 |
| `test_forge_connectivity.py` | OBSOLETE — absorbé dans `commands/validate.py` | `genai.py validate --check-forge` | ce registre ; #18838 |
| `test_forge_notebook.py` | OBSOLETE — simple appel papermill | `genai.py notebooks` | ce registre ; #18838 |
| `token_manager.py` | OBSOLETE — remplacé par `core/auth_manager.py` | `genai.py auth` | ce registre ; #18838 |
| `token_synchronizer.py` | OBSOLETE — remplacé par `core/auth_manager.py` sync | `genai.py auth sync` | ce registre ; #18838 |
| `validate_all_models.py` | OBSOLETE — remplacé par `validate_stack.py --full` | `genai.py validate --full` | ce registre ; #18838 |
| `validate_genai_stack.py` | OBSOLETE — remplacé par `validate_stack.py` puis `commands/validate.py` | `genai.py validate` | ce registre ; #18838 |
| `validate_gpu_cuda.py` | OBSOLETE — absorbé dans `commands/gpu.py` | `genai.py gpu --detailed` | ce registre ; #18838 |
| `validate_mission_documentation.py` | DOUBLON EXACT de `core/validate_mission_documentation.py` | none — doublon | ce registre ; #18838 |
| `validate_tokens_simple.py` | OBSOLETE — remplacé par `core/auth_manager.py` audit | `genai.py auth audit` | ce registre ; #18838 |
| `workflow_utils.py` | OBSOLETE — remplacé par `core/comfyui_client.py` WorkflowManager | `core/comfyui_client.py` | ce registre ; #18838 |

## Fichier depuis la racine

| Script | Verdict | Superseded by | Verdict recorded in |
|--------|---------|---------------|---------------------|
| `manage-genai-stack.ps1` | OBSOLETE — PowerShell remplacé par du Python multi-plateforme | `genai.py docker` | ce registre ; #18838 |

## Date d'archivage

Fevrier 2026 - Consolidation genai-stack
Février 2026 — consolidation genai-stack. Registre reconstruit au standard 4 colonnes le
2026-10-04 (tranche #13749), en préservant l'intégralité des raisons et successeurs du registre
initial.
7 changes: 5 additions & 2 deletions scripts/genai-stack/_archive/manage-genai-stack.ps1
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# ARCHIVED: 2026-02 (consolidation genai-stack) -- see scripts/genai-stack/_archive/ARCHIVE_README.md
# DISPOSITION: superseded | Successor: genai.py docker | Reason: PowerShell remplace par Python multi-plateforme
# Archive header (standard _archive convention, 2026-08, docs/reference/_archive-convention.md)
# - Date archived : 2026-02 (consolidation genai-stack)
# - Superseded by : genai.py docker (scripts/genai-stack/genai.py)
# - Verdict recorded in : _archive/ARCHIVE_README.md (registre 4 colonnes) ; #18838
# - Reason : PowerShell remplace par Python multi-plateforme
#
# ==============================================================================
# GESTIONNAIRE UNIFIÉ DE LA STACK GENAI (PHASE 43)
Expand Down
4 changes: 4 additions & 0 deletions scripts/genai-stack/_archive/utils/docker-setup.ps1
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
#Requires -Version 7.0
# Archive header (standard _archive convention, 2026-08, docs/reference/_archive-convention.md)
# - Date archived : 2026-02 (consolidation genai-stack)
# - Superseded by : genai.py docker start (scripts/genai-stack/genai.py)
# - Verdict recorded in : _archive/ARCHIVE_README.md (registre 4 colonnes) ; #18838
<#
.SYNOPSIS
Configuration et initialisation de l'environnement Docker GenAI
Expand Down
4 changes: 4 additions & 0 deletions scripts/genai-stack/_archive/utils/docker-start.ps1
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
#Requires -Version 7.0
# Archive header (standard _archive convention, 2026-08, docs/reference/_archive-convention.md)
# - Date archived : 2026-02 (consolidation genai-stack)
# - Superseded by : genai.py docker start (scripts/genai-stack/genai.py)
# - Verdict recorded in : _archive/ARCHIVE_README.md (registre 4 colonnes) ; #18838
<#
.SYNOPSIS
Démarrage des services Docker GenAI
Expand Down
4 changes: 4 additions & 0 deletions scripts/genai-stack/_archive/utils/docker-stop.ps1
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
#Requires -Version 7.0
# Archive header (standard _archive convention, 2026-08, docs/reference/_archive-convention.md)
# - Date archived : 2026-02 (consolidation genai-stack)
# - Superseded by : genai.py docker stop (scripts/genai-stack/genai.py)
# - Verdict recorded in : _archive/ARCHIVE_README.md (registre 4 colonnes) ; #18838
<#
.SYNOPSIS
Arrêt des services Docker GenAI
Expand Down
10 changes: 10 additions & 0 deletions scripts/tests/_archive/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Registre d'archive — Tests legacy `scripts/tests/`

Registre de disposition au standard de la [convention `_archive/`](../../../docs/reference/_archive-convention.md)
(colonnes : Script | Verdict | Superseded by | Verdict recorded in).

| Script | Verdict | Superseded by | Verdict recorded in |
|--------|---------|---------------|---------------------|
| `test_convert_print_to_deploy.py` | CLOSED DEAD-END — test orphelin : l'implémentation testée (`scripts/smartcontracts/convert_print_to_deploy.py`, one-shot de migration) a été archivée avec lui ; les fonctions testées ne sont plus chargées par aucun autre code | none (closed dead-end) | #18153 palier 1 (axe D #16473) ; en-tête per-fichier standard déjà posé |

Registre ajouté le 2026-10-04 (tranche #13749) — l'en-tête standard existait déjà sur le fichier.
Loading