divalto-ia-devkit

Trouve un EnrNo libre dans le fichier menu `g3f.dhfi` d'un domaine ERP, selon la plage demandee (`standard` < 100000 reserve ERP, `custom` >= 100000 recommande pour creations utilisateur). Scan des enregistrements M2 (Ce=2) avec filtre obligatoire (piege multi-structure M0/M2, cf RETEX R-006), puis calcul max+1 dans la plage. Previent les collisions d'EnrNo lors de l'ecriture d'un nouveau choix de menu. A utiliser avant d'ecrire un enreg M2 dans `g3f.dhfi` (ou un enreg M1 de visibilite F7 dans `a5f.dhfi`) pour une entite metier custom.

Trouve un numero de zoom libre en cross-checkant les sources enregistrees (`a5tczoom.dhsp` constantes standard, `a5f.dhfi` zooms standard, **`a5fu.dhfi` zooms specifiques/surcharge**, `a5f.dhfi` versionx9 optionnel), puis verifie le candidat par une recherche large dans les sources specifiques uniquement (occurrences remontees et etiquetees pour jugement, jamais de decision auto). Convention : un nouveau zoom specifique partenaire demarre a 90000. Previent les collisions entre zooms declares, enregistres et reellement appeles dans le code. A utiliser avant d'allouer un nouveau numero de zoom (creation d'entite ou de zoom).

Orchestre l'analyse pre-action d'une demande DIVA (user story + criteres d'acceptation, ou ticket myService d'anomalie) en mode collaboratif. Produit un rapport de preparation pour le developpeur : exemples de code similaires dans l'ERP X.13, fonctions du langage DIVA reutilisables, etude d'impact, points d'action concrets (fichiers/fonctions a toucher), pistes complementaires et points d'attention. Strategie hybride : interroge en priorite le graphe Neo4j `diva-mcp` (snapshot X.12 advisory) puis verifie systematiquement dans le code X.13 standard. 5 checkpoints de validation humaine -- Claude s'arrete apres chaque etape significative pour expliquer et attendre le feu vert. A utiliser quand un developpeur colle une user story ou un ticket dans la conversation et demande par ou commencer.

Ajoute un binding "FK par zoom standard" a une entite metier DIVA existante (post-creation). Pour chaque FK declaree, enrichit le Module Check (.dhsp) avec `Module "Gttmchk<cible>.dhop"` + procedures `Check_<SRC>_Field_<CHAMP>(+_Lib)`, puis enrichit le masque (.dhsf) avec `f8=<zoom>`, `table_associee`, `diva_apres`, bouton zoom + procedure callback dans `[diva]`. A utiliser pour reproduire le workflow RETEX R-003 (ajout post-hoc de binding zoom pays/devise/... sur une entite deja creee). Pattern documente dans reference/fk-pattern.md.

Assemble un rapport d'analyse pre-action a partir des 3 JSON intermediaires (request, candidates_x12, evidence_x13). Modele catalogue-driven : evalue 9 types de contenus par pertinence (via `content_types.py`), amorce deterministement la matiere de chaque type retenu (propositions, grep commands, table Ce4, ...), assemble les fragments Jinja correspondants. Produit un markdown et un JSON de metriques avec tracabilite `types_included`. Applique les regles de marquage X.12/X.13 systematique et les criteres de qualite pre-action. A utiliser quand les 3 JSON (request, candidates, evidence) sont disponibles et qu'il faut produire le rapport markdown final destine au developpeur.

Reference des patterns avances du langage DIVA : HTTP/REST, JSON/XML, integration .NET, surcharge (OverWrite), module table (mtab), RecordSql avance (Reader, Collate, Paging), tunnels inter-modules (Ping/Pong), evenements Harmony. A consulter pour generer du code DIVA utilisant des fonctionnalites au-dela de la syntaxe de base.

Compile un projet Divalto avec xwin7.exe (buildall ou build incremental), parse le rapport de compilation, et presente les erreurs avec leur contexte (fichier source, ligne). A utiliser apres avoir cree ou modifie des fichiers source DIVA pour verifier la compilation.

Configure les credentials du serveur MCP diva-mcp pour le partenaire integrateur. Le plugin marketplace livre un `.mcp.json` template (URL declaree, pas de headers d'authentification). Ce skill demande interactivement les 3 elements de la cle API (site, env, ApiKey) au partenaire, construit le header `X-Api-Key` au format `<site>-<env>@<apikey>`, et patche le `.mcp.json` du plugin pour persister la config pour toutes les sessions Claude Code futures. A invoquer la premiere fois apres l'installation du plugin, ou en cas de cle expiree / 401 sur les outils `mcp__diva-mcp__*`, ou apres une mise a jour du plugin qui aurait restaure le template d'origine (perte des credentials). Triggers : "configure diva-mcp", "ma cle API diva", "diva-mcp 401 / unauthorized", "diva-mcp ne marche pas", "premier demarrage diva-mcp", "renouveler ma cle diva-mcp".

Convertit en masse les anciennes fonctions de lecture DIVA (seek_xxx, Lectab) vers la nouvelle API objet metier (Give_xxx, Find_T041, Load_gtfdos) lors d'une migration Divalto. Pour chaque appel seek/Lectab, verifie dans l'objet metier *tmchk<entite>.dhsp du PACK STD DE DESTINATION que la fonction cible existe avant de convertir ; sinon laisse le code intact avec un TODO. A utiliser quand un integrateur Divalto demande de "migrer/convertir les fonctions de lecture", "passer les seek_xxx en Give_xxx", "convertir les Lectab", ou "automatiser la migration des acces fichiers" sur un dossier de sources. Traite les .dhsp ET les masques de surcharge .dhsf/.dhsi -- pour ces masques, ne transforme que le bloc [diva] (jamais [diva_base], copie figee du standard). Pour chaque seek_<entite>, decide s'il faut le GARDER (wrapper survivant dans la cible) ou le convertir, d'apres l'arbre des Objets compiles (.dhop) de la version cible. Autonome (ni AutoConvertSrc.exe, ni diva-MCP).

Orchestre la creation de bout en bout d'une entite metier DIVA en mode collaboratif. A partir des parametres utilisateur (domaine, entite, table, champ cle, description), enchaine : calcul des noms, generation RecordSql, Module Check, Zoom SQL, bloc d'alias, validation croisee inter-fichiers, dictionnaire, compilation, ISAM et menu. Orchestration LLM avec 11 checkpoints de validation humaine — Claude s'arrete apres chaque etape significative pour expliquer et attendre le feu vert.

Point d'entree du devkit DIVA. Aide le collaborateur a decouvrir les skills disponibles et leur portee : vue panoramique par workflow (analyse / creation / modification / fichiers / ISAM / validation / test-doc / reference), detail d'un skill precis, recherche par mot-cle, filtrage par workflow ou verbe. A utiliser quand le collaborateur demande "que peux-tu faire ?", "liste des skills", "explique-moi <X>", "quel skill pour faire Y ?". Porte aussi la **discipline d'invocation** du devkit DIVA : (1) la documentation des skills (`reference/*.md`) est la source autoritaire pour toute question de convention/regle/nommage/structure -- le filesystem n'est jamais source primaire ; (2) les skills DIVA sont prioritaires sur toute commande improvisee -- si un skill couvre l'operation, l'invoquer plutot que reproduire son resultat via `find` / `grep` / `cat` ; (3) invoquer un skill charge ses instructions a EXECUTER -- Claude lance ensuite les scripts, il ne s'arrete pas a afficher le README.

Genere un fichier Module Check (.dhsp) complet pour une entite metier DIVA, a partir d'un template Jinja2 et des tokens de nommage. Contient l'en-tete, les includes/modules, Init_Module, les ~52 fonctions du pattern standard (proprietes, champs, recherche, controle, init, pre/post, autorisations, reservation). Ecrit le fichier en ISO-8859-1+CRLF. A utiliser pour creer la couche objet metier d'une entite (deuxieme fichier du pattern 3 fichiers).

Genere un fichier source RecordSql (.dhsq) complet et valide pour une entite metier DIVA, a partir d'un template Jinja2 et des tokens de nommage. Inclut le filtre multi-dossier obligatoire (Dos = MZ.Dos), les cases WHERE/ORDERBY standard, et la declaration OverWrittenBy. Ecrit le fichier en ISO-8859-1+CRLF. A utiliser pour creer la couche d'acces SQL declarative d'une entite.

Genere un fichier Zoom SQL (.dhsp) complet avec les 27 procedures obligatoires du cycle de vie ecran CRUD (creation, modification, suppression, consultation). Inclut les appels framework (Select, PreInsert, PostInsert, etc.), la construction de conditions de selection, la gestion des reservations, et les hooks de personnalisation. Ecrit en ISO-8859-1+CRLF. A utiliser pour creer l'interface utilisateur d'une entite metier (troisieme fichier du pattern 3 fichiers).

Analyse les fichiers source DIVA (.dhsp, .dhsq, .dhsd, .dhsf, .dhsi, .dhse, .dhpt, .dhps, .sql) et produit un rapport d'erreurs classees par severite, en verifiant la conformite aux ~100 anti-patterns connus (dont regles dictionnaire D04/D10/D11, masque E12-E19 incluant normes graphiques), aux regles de syntaxe DIVA, et aux 11 controles qualite CI (shift-left des moulinettes nightly). A utiliser pour controler la qualite du code avant compilation ou apres generation.

Ajoute une table complete dans un dictionnaire Divalto (.dhsd) en generant les 5 zones obligatoires : [CHAMP] (declaration des champs), [TABLE] (structure avec positions calculees), [BASE] (fichier physique), [INDEX] (index avec positions cumulees), et [INDEXL] (mapping). Inclut le socle audit canonique (Ce1, Dos, UserCr, UserMo, UserCrDh, UserMoDh, Filler, U-field), le calcul automatique des positions sans trou, la taxonomie de suffixes typés (Dt->D8, Dh->DH, Fl->1,0...) via suggest_nature.py, et la validation de coherence D01-D14. Preserve l'encodage ISO-8859-1+CRLF. A utiliser pour declarer une nouvelle table metier dans le dictionnaire avant de generer le code, ou pour modifier la Nature d'un champ existant avec recalcul automatique des positions (tables + index) lors d'un alignement de version / migration (modify_field_nature.py).

A utiliser pour lire, comparer ou gerer les messages d'erreur applicatifs DIVA (fichiers XXferr : gtferr/ccferr... standard, ou <prefixe>ferr specifique partenaire), ou quand un controle GererErreurCheck(NNN) necessite un message dedie | Lit codes et libelles via reading-isam-files (ISAM, pas de regex sur octets bruts) ; compare deux fichiers pour detecter codes ajoutes/retires/custom (arbitrage downgrade) ; documente la gestion sure (ajout via la mecanique standard IHM, jamais d'ecriture binaire ; verification --check). Norme : un XXferr standard ne se modifie jamais (lecture seule) ; le specifique partenaire est modifiable. Emplacement localise via understanding-integrator-workspace.

Parse, genere, modifie et surcharge les masques ecran Divalto (.dhsf). Parse un .dhsf en arbre structurel JSON, genere un .dhsf depuis un template (zoom SQL, ecran CRUD, simple), effectue des modifications incrementales (ajout champ, colonne, page) et scaffolde des surcharges masque (xxx_sqlu.dhsf). A utiliser quand il faut creer, modifier ou surcharger un masque ecran DIVA (zoom SQL, ecran de saisie, affichage d'une entite).

A utiliser lors de la migration du specifique d'un client d'une version ERP Divalto a une autre (rebase sur un nouveau Service Pack / version X.N), ou pour arbitrer ce qu'un downgrade conserve, rebase ou abandonne | Guide la migration de pack : ordre de compilation (bases standard d'abord, surcharges overWrite ensuite -- recompiler un standard apres sa surcharge efface les procedures fusionnees), contournement deux passes quand des dependances inter-projets ne sont pas declarees dans les .dhps, arbitrage des sources downgrade (un SP ne livre qu'un sous-ensemble des sources : croiser diff textuel, existence de l'objet compile et couplage au dictionnaire downgrade -- jamais 'supprimable' sur la seule absence de source standard), verification post-migration de l'integrite des surcharges. Complete les references downgrade de managing-diva-dictionaries et la compilation de managing-diva-projects / compiling-diva-projects.

A partir du triplet (domaine, entite, table SQL), calcule l'ensemble complet des noms de fichiers, instances, variables, constantes et tokens de substitution necessaires a la generation d'une entite metier DIVA. Verifie la coherence (non-collision RecordSql/Record, prefixe domaine correct). A utiliser avant toute generation de code pour obtenir le jeu de tokens.

Structure une demande DIVA en texte libre (user story + criteres d'acceptation, ou ticket myService d'anomalie) en JSON canonique : type de demande, titre, resume, acteurs, donnees manipulees, domaine ERP pressenti, keywords techniques et metier, CA detectes, message d'erreur. Le parseur est deterministe (regex + heuristiques), le LLM raffine la sortie au checkpoint CP1 de l'orchestrateur. A utiliser quand une demande est livree en texte libre et qu'il faut produire un JSON structure exploitable par les phases suivantes d'analyse.

Pousse automatiquement les entrees R-NNN d'un fichier RETEX-skills.md vers un depot GitHub sous forme d'issues. Parse les entrees, deduit les labels (categorie + severite), formate le corps de l'issue, et utilise `gh issue create` (GitHub CLI). Idempotent via un cache local de tracking (.retex-pushed.json) : ne recree pas une issue deja poussee, commente l'issue existante si le contenu de l'entree a change. Mode degrade si `gh` n'est pas installe ou non authentifie : log sans bloquer. A utiliser pour synchroniser son journal RETEX local avec un canal centralise (ex : repo divalto/divalto-ia-devkit). Le skill est invoque (a) automatiquement par le hook `push_retex_to_github.py` apres chaque edition de RETEX-skills.md, ou (b) manuellement pour pousser explicitement / re-synchroniser / faire un backfill.

Interroge le graphe Neo4j diva-mcp (snapshot X.12 advisory) pour explorer le standard ERP Divalto. Produit une liste priorisee de candidats (programs, fonctions, tables, entites, relations) a partir d'un request.json issu du parser de demande. Toutes les sorties portent le disclaimer "snapshot X.12" et sont destinees a etre verifiees dans les sources X.13 par le skill searching-erp-sources. A utiliser a partir d'un `request.json` pour obtenir une liste priorisee de candidats avant verification dans les sources. Gere la degradation gracieuse si diva-mcp est indisponible (rapport avec candidates vides et `neo4j_status: unavailable`).

Lit des enregistrements dans les fichiers binaires ISAM Divalto (.dhfi) via DhxIsam64.dll (ctypes). Supporte la lecture par cle, le parcours sequentiel, les filtres et la projection de champs. A utiliser pour consulter le contenu des fichiers indexes proprietaires Divalto.

Lit les dictionnaires de multichoix Divalto (fichiers `XXfdmc.dhfi` d'un module ERP : `gtfdmc`, `ccfdmc`, ...). Liste les multichoix disponibles, detaille les entrees d'un multichoix donne, et (a venir) resout les lookups Type=3 en lisant la table cible. Gere les 3 Types rencontres (1 liste fixe, 3 lookup dynamique, 4 identifiant externe). A utiliser pour consulter la definition d'une liste de choix avant de binder un champ de dictionnaire metier via `Choix=<XXfdmc>.dhfi` + `NomChoix=<NC>`. Rappelle aussi la norme (ne jamais modifier un `XXfdmc` standard ; gerer son propre `XXfdmc`) et comment localiser/comparer un `XXfdmc`.

Relit la documentation technique produite par documenting-erp et la challenge contre les sources X.13 et le referentiel DIVA. Detecte 4 categories d'erreurs d'interpretation LLM -- E1 (affirmation narrative non sourcee), E2 (desalignement entre narratif et source citee), E3 (omission structurelle champ/index/FK), E4 (contradiction avec le referentiel DIVA). Produit un rapport classe par severite (erreur/warning/info) en lecture seule stricte sur le livrable et sur le referentiel. Seconde voix independante du producteur. A utiliser apres une execution de documenting-erp pour challenger le livrable avant publication.

Verifie l'existence des candidats Neo4j (candidates_x12.json) dans le code source X.13 standard ({CHEMIN_ERP_STANDARD}) et extrait le contexte precis (fichier:ligne, procedure englobante, snippet 10-30 lignes). Source de verite : promouvoit les candidats [X.12] en [CONFIRME X.13], [DISPARU X.13] ou ajoute des decouvertes [NOUVEAU X.13]. Applique des bornes strictes (--max-matches, --max-files, --timeout) pour gerer la volumetrie ERP (~7000 fichiers). A utiliser apres querying-diva-graph (mode hybride) ou en mode direct si diva-mcp indispo.

Synchronise la base SQL Server a partir des dictionnaires compiles via xwin7 synchroauto. Parse le rapport de synchronisation et presente les erreurs. A utiliser apres une compilation buildall reussie (0 erreur) pour mettre a jour la base SQL.

Interagit avec l'ERP Divalto via navigateur (Playwright MCP) pour verifier le resultat de modifications : connexion, navigation dans le menu, ouverture de zoom, consultation du zoom des zooms, verification post-compilation. A utiliser apres une compilation/synchro SQL pour tester le resultat dans l'ERP, ou de maniere autonome pour naviguer et consulter l'ERP.

Quand utiliser : en debut de toute session sur un workspace integrateur Divalto (typiquement sous l'alias harmony /specifs/<workspace>/), avant toute lecture, copie ou generation de fichier. Particulierement critique sur un poste d'integrateur ou cohabitent systematiquement plusieurs versions de l'ERP, plusieurs bases de donnees clients et plusieurs projets d'integration -- ce sont precisement les contextes ou une copie ou lecture aveugle commence sur de mauvaises bases. Quoi faire : identifier le fichier implicite du workspace (search path declaratif), resoudre les chemins harmony (/specifs/, /sources/, /objets/, /fichiers/, /divalto/, ...) via divaltopath.cfg et fconfig, lire les profils typed du .dhpt, retrouver la connexion SQL (porte Harmony ODBC + porte ADO.NET), classifier les chemins standard / specifique avec validation utilisateur obligatoire. Evite les erreurs de version, les copies aveugles de fichiers compagnons et les generations contre une base mal identifiee. Discipline registre Windows : les

Ecrit et modifie les fichiers texte Divalto (.dhsp, .dhsq, .dhsd, .dhsf, .dhpt, .dhps) en garantissant l'encodage ISO-8859-1 et les fins de ligne CRLF. Detecte et corrige les fichiers corrompus (UTF-8, LF). A utiliser des qu'un fichier Divalto doit etre cree ou modifie.

Ecrit, modifie et supprime des enregistrements dans les fichiers binaires ISAM Divalto (.dhfi) via DhxIsam64.dll (ctypes). Supporte insert (unitaire + batch), update (trewritelong) et delete (tdeletelong). A utiliser pour toute ecriture dans les fichiers indexes proprietaires Divalto.

Cree et modifie les fichiers projet Divalto : .dhpt (projet principal) et .dhps (sous-projet). Genere un .dhps avec toutes les sections obligatoires ([general], [communs], [fichiers], [includes], [autres]), l'ajoute dans [sousprojets] du .dhpt parent, et valide la structure complete contre les regles P01-P16. A utiliser pour declarer un nouveau sous-projet (nouvelle entite a compiler) ou modifier les fichiers/includes d'un .dhps existant.

Assiste un collaborateur qui pose une question fonctionnelle conversationnelle sur le standard ERP Divalto (formulations du type "ne comprends pas pourquoi X ne marche pas", "il manque une info pour que Y fonctionne", "quand l'option Z est activee, W n'apparait plus"). Produit une reponse **chat-ready** courte (< 40 lignes) identifiant 3 a 5 causes probables classees par probabilite, chacune avec une reference fichier:ligne dans X.13 et une action de verification concrete. Cycle court (< 5 min). Ne genere aucun fichier disque. A utiliser quand un collegue colle un message de chat, une capture d'ecran Teams/Slack, ou reformule a l'oral une question sur un parametrage ou un comportement du standard -- pas quand le collaborateur s'apprete a coder (UC-100).

Genere la documentation technique d'un module ou d'une entite de l'ERP Divalto sous forme de contenu structure YAML, independant de la forme du livrable final. Orchestre un pipeline `sources -> extraction -> assemblage -> rendu` : extrait depuis dictionnaires .dhsd, schema SQL et code X.13, enrichit avec un narratif metier, assemble selon un modele a 3 couches de lecture (metier / schema / technique) et rend via les renderers du skill -- Markdown et PDF aujourd'hui, autres formats (Confluence, MkDocs, pandoc, site statique...) via renderers additionnels ajoutes au skill (jamais via scripts ad-hoc externes). A utiliser quand un developpeur doit rediger ou actualiser la documentation technique d'un module ERP (DAV, COMPTA, GS...), produire la matiere avant un livrable Confluence/PDF, ou re-generer la doc pour detecter les derives entre une version ERP anterieure et l'actuelle.

Analyse les fichiers source DIVA (.dhsp, .dhsq, .dhsd, .dhsf, .dhpt, .dhps) et produit un rapport d'erreurs classees par severite, en verifiant la conformite aux ~80 anti-patterns connus et aux regles de syntaxe DIVA. A utiliser pour controler la qualite du code avant compilation ou apres generation.

Modifie une entite metier DIVA existante : ajout de champ(s), modification de Nature/type, suppression de champ. Met a jour le dictionnaire (.dhsd) avec recalcul automatique des positions, le masque ecran (.dhsf), recompile et synchronise SQL. Orchestration LLM avec 4 checkpoints de validation humaine. A utiliser quand le developpeur veut faire evoluer une table existante (ajouter, modifier ou supprimer un champ) avec propagation dictionnaire -> masque -> SQL.

Lit les feuilles de style ISAM Divalto (`fstyle.dhfi` et 3 variantes WPF / impression / web dans `C:\divalto\sys\`). Liste les styles disponibles, detaille un style, resout les references i18n des libelles `tbl*` (ex: TBLART -> `#tblart`). Gere les 7 Types semantiques : 1 police, 2 couleur RGB, 3 reference i18n, 5 style global STD, 6 cadre, 7 style compose, 9 contexte. A utiliser pour consulter la definition graphique d'un style nomme consomme par les multichoix Type=4 (`LstStyleWpf` / `LstStyleImp` / `LstPolice` de gtfdmc.dhfi), pour identifier un cadre/police, ou pour resoudre un libelle `tbl*` decouvert dans les multichoix.

Rend le livrable final d'une analyse pre-action UC-100 a partir d'un facts.json. Produit un markdown unique structure en 3 couches de lecture : strategique (2 min, chef projet), tactique (15 min, dev implementeur), technique (30 min, auditeur). Autonomie documentaire stricte : aucun path absolu, aucune balise [X.12] ou [CONFIRME X.13], aucun chemin C:/ dans le livrable. Les references vivent exclusivement dans le facts.json. Un renderer deterministe (Jinja2) transforme chaque claim en fragment markdown selon sa couche et son kind. Le validator refuse tout rendu contenant un stub, une balise HTML non supportee en Mermaid, un pronom relatif apres un label, ou une ref visible. A utiliser apres build_facts.py pour produire le livrable destine au developpeur.