Référence › Commandes › Store

Référence › Commandes

Store

Les commandes qui cherchent, ajoutent et publient les paquets de l’Arche Store.

Commandes : archec store · archec add · archec audit · archec publish · archec search · archec shelf

L’Arche Store : des architectures, des drivers, des spécifications et des cartes que les gens partagent, sous forme de paquets signés. Le store utilisé est celui de --store <where> (un dossier, une URL git ou l’URL https d’un store hébergé), sinon ARCHE_STORE, sinon celui que fixe archec store use. Voir l’Arche Store.

Commande Ce qu’elle fait
archec add <main.arche> <owner/name[@range]> [--dry-run] Récupère un paquet et ce qu’il utilise : la version la plus récente de l’intervalle que cet archec sait lire (ou celle que nomme arche.lock). Elle est vérifiée par rapport au store (hash de l’archive, signature de l’éditeur, empreinte des fichiers) et au trust du projet, puis décompressée dans .arche/store/<name>@<version>/. La commande écrit uses <name> "^x.y", met à jour arche.lock et liste le code apporté. Rien n’est écrit si une vérification échoue. Un store sur une autre machine n’est joint que s’il est autorisé : archec config allow store https://store.arche-lang.xyz (ai-engineering.md).
archec audit <main.arche> [--json] Tout le code que contient le projet (fichiers de code et blocs de code), groupé par origine : le projet, une bibliothèque à lui, ou un paquet du store avec sa version, son empreinte et son niveau de confiance. --authors : plutôt qui l’a écrit (voir provenance).
archec publish <folder> Identique à archec store publish.
archec search <words> Identique à archec store search.
archec shelf [<shelf> [<piece>]] [--json] Les six rayons de pièces toutes prêtes du store : types, unités, cartes, pilotes, capteurs (et actionneurs), algorithmes. Avec un rayon, ses pièces, une ligne chacune, groupées. Avec une pièce (archec shelf units mAh, archec shelf types ImuSample), sa fiche : les mêmes sept lignes pour chaque pièce — Does, Gives, Plugs into, Add it, Runs on, Tested, From. --json pour chacun. Voir les rayons.
archec shelf add <main.arche> <piece> [--shelf <shelf>] [--dry-run] Ajoute une pièce : le uses et l’include de sa bibliothèque, écrits seulement si le projet se construit encore ; une carte ou un périphérique comme le font archec board add et archec device add. Une unité est intégrée : rien à ajouter.
archec store fetch <main.arche> Les paquets du store nommés dans arche.lock qui ne sont pas dans .arche/store (après un nouveau checkout), dans la version verrouillée, vérifiés par rapport à l’empreinte du lock.
archec store outdated <main.arche> [--json] Chaque paquet installé confronté à son store : une version plus récente que cet archec sait lire, ou un retrait (yank) enregistré, pour qu’archec check avertisse à son sujet. Code de sortie 1 en cas de retrait.
archec store search <words> [--kind <kind>] [--json] / archec store info <owner/name> Cherche des paquets par nom, mots-clés et description. Pour un paquet : ses versions, sa licence, sa classification à l’export, ses badges et sa famille.
archec store diff <owner/name> <version> <version> [--json] Ce que le modèle a gagné, perdu ou changé entre deux versions : systèmes, composants, leurs parts, ports et liens, interfaces, messages et exigences, comparés en tant que déclarations, et non en tant que texte.
archec store check <folder> Ce que la publication refuserait (pas de propriétaire, de licence ou d’export-control ; un script, un binaire, un fichier exécutable ; une erreur de syntaxe), ce qui donnerait un avertissement, ou ce qui serait retenu pour relecture (des mots qui évoquent une technologie de défense).
archec store card <folder> [-o card.html] La page du paquet telle que le store la montre : son README et ce qu’archec lit dans le modèle (systèmes, composants, cartes, interfaces, exigences, code apporté).
archec store pack <folder> [-o <dir>] Le fichier .archepkg : un même dossier donne toujours les mêmes octets.
archec store publish <folder> [--dry-run] [--private] Vérifié, empaqueté, signé avec la clé du propriétaire (créée la première fois, dans ~/.arche/keys) et écrit dans le store : un dossier ou un clone git (il reste à commiter et à ouvrir une pull request), ou envoyé à un store hébergé. Une version publiée ne change jamais. --private : seule l’organisation du propriétaire la voit (store hébergé).
archec store package <dir> --from capella <model.capella|.aird|folder|.zip> / --from polarion <polarion.yaml|workitems.json> --owner <o> --license <SPDX> --export-control <none|…> [--name n] [--version 0.1.0] [--kind k] [--label "…"] [--description "…"] [--keywords a,b] Un import transformé en paquet, en une étape : l’importeur écrit le modèle dans <dir> (archec capella ; les work items de Polarion dans requirements.arche), puis library.arche et un README, et le paquet est vérifié comme le fait publish --dry-run. Refusé sans propriétaire, sans licence ou sans classification d’export. Rien n’est publié. Voir l’Arche Store.
archec store yank <owner/name@version> --reason "…" La version n’est plus récupérée, sauf par un lock qui la nomme. Les projets qui l’ont en sont informés par archec store outdated.
archec store init <folder> [--name "…"] Un nouvel index, organisé en dépôt git avec son workflow GitHub (il vérifie les pull requests, écrit les badges et publie les pages).
archec store seed <index> [--license <SPDX>] Les paquets fournis avec archec : le store de cartes et chaque carte, la bibliothèque standard, et les exemples comme architectures, publiés par arche (vérifié).
archec store verify-index <index> [owner/name…] Vérifie que chaque archive est bien celle que nomme son entrée, avec l’empreinte et la signature qu’elle enregistre.
archec store test <index> [owner/name…] [--all] [--write] [--breaks] Chaque paquet (sa version la plus récente, ou toutes avec --all) est construit avec cet archec, comme le ferait un projet qui l’utilise, puis passé à cppcheck et à une analyse Python de son code. --write enregistre les badges. --breaks n’échoue que sur un paquet qui passait avec un archec plus ancien : lancez-le avant une version.
archec store deps [<index>] [--json] La version la plus récente de chaque paquet : chaque bibliothèque qu’il utilise doit être un paquet du store, avec une version dans la plage qui n’est pas retirée. La commande liste celles qui ne sont pas dans le store, n’ont aucune version dans la plage, ou seulement des versions retirées ; elle échoue s’il y en a une.
archec store site <index> -o <dir> Les pages du store : une liste avec recherche, une page par paquet (fiche, versions, badges, arbre de famille), les éditeurs, les collections, les demandes. Ce sont des pages statiques, que GitHub Pages peut servir.
archec store serve <index> [--port 8080] [--host 127.0.0.1] Le store hébergé : les pages et une API (recherche, paquets, archives, publication, retrait, relecture, étoiles, discussions, demandes, téléchargements). Les comptes sont des jetons. Avec GITHUB_CLIENT_ID/GITHUB_CLIENT_SECRET, /auth/github connecte les gens avec GitHub.
archec store token <index> <user> [--org a,b] [--reviewer] [--admin] Le jeton d’un compte (affiché une seule fois ; seul son hash est gardé dans <index>/.tokens.json).
archec store login <url> --token <token> / archec store use <where> Se connecter à un store hébergé ; choisir le store utilisé par défaut.
archec store review <owner/name@version> [--refuse --reason "…"] Libère un paquet retenu pour relecture (avec un compte de relecteur sur un store hébergé), ou le refuse.
archec store verify-publisher <index> <owner> [--name "…"] Marque un éditeur comme vérifié (un fabricant de cartes, un projet connu) : ses paquets sont verified, les seuls qu’accepte trust verified.
archec store collection <index> <id> "Title" <owner/name>… Une liste de paquets choisis à la main, affichée sur la page Collections.
archec store request "…" [--kind board] / archec store star / archec store discuss Demander une carte ou un driver qui manque ; donner une étoile à un paquet ; écrire sur sa page (étoiles et discussions : store hébergé).
archec store import-zephyr <zephyr>/boards -o <folder> Une collection de cartes tirée des fichiers de cartes de Zephyr : le processeur de chaque carte (hal/chip pour STM32, nRF, RP2040, ESP32), sa RAM, et ses ports UART, CAN, SPI et I2C avec leurs broches, tels que les fixe le DTS.