Arthur Ria
660c62c32c
Cas reel du 25/08/2026 : une session Cowork cherchant des workflows CST_ sans
passer application="CustomApp" a conclu que l'AD n'en contenait aucun -- alors
que CustomApp en porte 153. Le parametre application existait bien (D26) et
etait documente ; ce qui manquait, c'est que RIEN dans la reponse ne disait
qu'on n'avait regarde qu'une application sur neuf. Un defaut silencieux se lit
comme une exhaustivite.
search_workflows et search_ad_elements rappellent desormais TOUJOURS
l'application effectivement interrogee (plus seulement quand le parametre a ete
passe), et ajoutent un hint quand la recherche revient vide.
Seuil a 0 resultat, pas "peu" : toute valeur non nulle produirait un hint
parasite sur une recherche legitimement etroite, et le mode d'echec observe est
bien le zero pris pour une absence.
Le hint nomme les autres applications depuis la liste allegee DEJA en cache ;
sans elle il reste generique et renvoie vers list_workflow_categories. Aucun
appel reseau n'est fait pour construire un hint -- ce serait exactement le
prechargement que D26 interdit.
Verifie en execution (protocole, LIMAGRAIN) :
search_workflows {"query":"CST_"} 404 chars
application: "EasyWMS", count: 0, hint nommant CustomApp et renvoyant
vers list_workflow_categories
search_workflows {"query":"CST_"} apres
list_workflow_categories 461 chars
meme hint, enrichi de la liste en cache : Common, Notifications, SmartUI,
WarehouseWebDesigner, GalileoFaults, CustomApp, User, AGV
search_workflows {"query":"CST_","application":"CustomApp"}
count: 44, application: "CustomApp" -- dont CST_SendRejectContainersToPK
search_workflows {"query":"stacker"} 14 192 -> 14 220 chars
count: 50 inchange, application: "EasyWMS" presente, aucun hint parasite
search_ad_elements Command "CST_" 457 chars
application: "EasyWMS", count: 0, meme hint
stderr : aucun fetch d'une application non demandee. Seules EasyWMS et
CustomApp sont chargees, chacune sur demande explicite.
Rebouclage complet apres modification des schemas : 23 outils, 6 resources,
les 23 noms de tools/list atteignent leur module (aucun "Unknown tool" ;
execute_command verifie statiquement, non appele car il ecrit dans le WMS),
D23 rejette toujours un parametre inconnu sur les quatre schemas modifies,
npm test 4/4 en code 0.
Lot 5 retire de la ROADMAP.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
123 lines
6.6 KiB
Markdown
123 lines
6.6 KiB
Markdown
# Roadmap
|
|
|
|
Travaux planifiés, par lot. Chaque lot est livrable indépendamment.
|
|
|
|
Constats issus de la session de diagnostic du **24/08/2026** (profil `LIMAGRAIN`,
|
|
host `10.255.255.2`, tenant `LIMAGRAI2512`), déclenchée par un rapport d'usage
|
|
d'une session Cowork. Toutes les anomalies ci-dessous ont été **reproduites**
|
|
contre le WMS réel — ce ne sont pas des hypothèses.
|
|
|
|
Les décisions actées vivent dans [DECISIONS.md](DECISIONS.md) ; ce fichier ne
|
|
contient que ce qui reste à faire.
|
|
|
|
---
|
|
|
|
## Lot 4 — Modèle de données et applications
|
|
|
|
Deux angles morts constatés le 24/08/2026, plus larges que les lots 2 et 3. Les
|
|
chiffres ci-dessous sont mesurés sur le tenant `LIMAGRAI2512`.
|
|
|
|
### L4.1 (reliquat) — Explorer le contexte Metrics
|
|
|
|
L'exposition de `query_type` est livrée (D25). Reste l'investigation : le
|
|
contexte `Metrics` (`QueryType: 3`, `ApplicationMetricDataContext`) mérite une
|
|
exploration à part — c'est probablement là que vivent les données agrégées
|
|
produites par les jobs `MetricGatherer`. Livrable : un rapport, pas du code
|
|
(même phase d'investigation que L4.4).
|
|
|
|
### L4.3 — Identifier le MCP dans les logs du WMS
|
|
|
|
Les requêtes du MCP apparaissent dans les logs du WMS sous
|
|
`Execute error. Client: GNA` — le client OAuth partagé — donc indistinguables de
|
|
celles du vrai client GNA.
|
|
|
|
**La piste `ClientModule` est invalidée** (mesuré le 24/08/2026, lot 1) : le
|
|
champ est bien accepté par `QueryExecute` (pas d'erreur), mais il est **sans
|
|
effet observable**. Une requête en échec envoyée avec
|
|
`ClientModule: "MCP-WMS"` est tracée `Execute error. Client: GNA`, et ni
|
|
`MCP-WMS` ni `ClientModule` n'apparaissent nulle part dans
|
|
`ApplicationService.log` ni `HttpResponseTime.log`. Le `Client:` des logs vient
|
|
du client OAuth, pas du payload — le champ n'a donc **pas** été renseigné.
|
|
|
|
Piste restante (non vérifiée) : un client OAuth dédié au MCP côté EasySTS
|
|
changerait le `Client:` des logs, mais suppose une configuration côté WMS.
|
|
|
|
### L4.4 — Historique d'exécution des workflows par API
|
|
|
|
`ApplicationService` expose une API `WorkflowLog` que le MCP n'utilise pas :
|
|
|
|
| Endpoint | Usage |
|
|
|---|---|
|
|
| `GET /WorkflowLog/GetInstances?processDefinitionId=&skip=&take=&startDateFrom=&startDateTo=` | instances d'un workflow sur une plage de dates, filtrables par attribut |
|
|
| `GET /WorkflowLog/GetInstance?processId=` | une instance |
|
|
| `GET /WorkflowLog/GetLogs?processId=&skip=&take=&logDateFrom=&logDateTo=` | journal d'exécution d'une instance |
|
|
| `GET /WorkflowLog/Validate?applicationName=&processDefinitionId=` | validation d'une définition |
|
|
|
|
Endpoints joignables et fonctionnels — `Validate` renvoie
|
|
`{"Success":true,"ErrorMessage":null,"Warnings":[]}`. `GetInstances` répond `[]`
|
|
sur le workflow testé : à confirmer sur un workflow ayant réellement tourné, la
|
|
journalisation n'étant pas forcément active partout.
|
|
|
|
**Peut remettre en cause D16** (historique des shipment templates jugé hors de
|
|
portée faute de logs fichier) : si l'historique d'exécution est disponible par
|
|
API, la conclusion change. À vérifier avant d'écrire quoi que ce soit.
|
|
|
|
### L4.5 — Champs de `QueryExecute` inexploités
|
|
|
|
La référence de l'API documente des champs que le MCP n'envoie jamais :
|
|
|
|
| Champ | Intérêt |
|
|
|---|---|
|
|
| `Parameters` | requêtes **paramétrées** (dictionnaire `nom -> {TypeName, Value}`) — supprimerait toute concaténation de chaîne dans les filtres, et pourrait débloquer D13 (`Select`) |
|
|
| `CommandTimeout` | timeout par requête, au lieu du timeout HTTP global de 30 s |
|
|
| `QueryId` + `POST /QueryCancel` | annulation d'une requête longue |
|
|
| `POST /QueryExecuteStream` | résultats en flux — piste long terme pour les sorties volumineuses, au-delà du bornage signalé de D24 |
|
|
|
|
Autres endpoints jamais utilisés, à évaluer : `QueryEvents`, `QueryCommands`,
|
|
`QueryCorrelationEvents`, `QuerySnapshots` (event sourcing — utile en debug),
|
|
`GET /Metadata/Commands|Events|Aggregates` et leurs variantes `…All`,
|
|
`GET /configuration/applications` (liste les applications **avec leur version**,
|
|
plus riche que `/AD/api/Application/GetAll`), `GET /healthcheck?tenantCode=` et
|
|
`GET /ready?tenantCode=` (sondes de disponibilité, répondent 200).
|
|
|
|
---
|
|
|
|
## Écarté
|
|
|
|
| Proposition | Raison |
|
|
|---|---|
|
|
| Uniformiser les noms de paramètres (`entity_type` / `query` partout) | Casse les usages existants ; les alias de transition doublent la surface à maintenir. La cause réelle est traitée par L2.2. |
|
|
| Exposer un `indexStatus` sur `generic_search` | `TotalDocuments: 0` est déjà le signal. Le MCP n'a aucun moyen d'interroger l'état de l'index de recherche. |
|
|
| Outil dédié `get_query_syntax_help` | L'information doit se trouver dans le message d'erreur, là où elle est lue (L2.1), pas dans un outil qu'il faut penser à appeler. |
|
|
|
|
---
|
|
|
|
## Points ouverts (hors lots)
|
|
|
|
- **Profil `AD` : tenant introuvable** (mesuré le 24/08/2026). `npm test -- --all`
|
|
échoue 0/4 sur ce profil ; le STS de `10.255.255.2` répond
|
|
`400 {"error":"invalid_request","error_description":"Tenant not found"}` pour
|
|
le tenant `AD`. L'hôte et le STS fonctionnent (LIMAGRAIN, même hôte, passe
|
|
4/4) : c'est la valeur `AD_TENANT` du `.env` qui ne correspond plus à un
|
|
tenant existant. Correction côté propriétaire du dépôt (mettre à jour ou
|
|
retirer le profil) — pas un bug du code. Depuis L3.2, le corps de la réponse
|
|
du STS (`Tenant not found`) remonte dans les erreurs d'outils et du smoke
|
|
test.
|
|
- **Bascule de profil concurrente aux appels en vol** (mesuré le 25/08/2026,
|
|
révision du lot 2). Le serveur traite les `tools/call` **en concurrence** :
|
|
en envoyant une rafale de requêtes dans une même session, les réponses
|
|
reviennent dans le désordre, et un `switch_wms_profile` émis pendant que des
|
|
requêtes sont en vol les fait partir sur le nouveau profil (observé : une
|
|
requête destinée à EUROTRAFIC exécutée sur l'hôte `10.255.255.2` après la
|
|
bascule suivante). Conséquence du singleton d'état global (D8). Sans gravité
|
|
pour un usage conversationnel séquentiel, mais Claude peut émettre des appels
|
|
d'outils **en parallèle** : à traiter si un cas réel de mélange de profils
|
|
est observé (piste : sérialiser les `tools/call` ou figer le profil résolu au
|
|
début de chaque appel).
|
|
- **`select_expression`** : les projections via le paramètre `Select` provoquent
|
|
des erreurs de compilation côté serveur (D13). Irritant principal restant.
|
|
- **Déploiement SSH sur la VM** : l'exécutable est validé, la configuration SSH
|
|
reste à faire.
|
|
- **Historique des shipment templates** : hors de portée, les logs concernés
|
|
n'existent pas sur l'hôte joignable (D16).
|