Conception de la CLI — lexique et options

Objectif : un lexique qu’un nouvel utilisateur comprend sans glossaire, et des options qui corrigent ce qui manquait toujours aux utilisateurs de repo/west.

Lexique (canonique depuis la v0.1)

Les anciennes orthographes (brick, product, bricks, --product, --bricks) sont interprétées indéfiniment comme des alias ; la sérialisation et la documentation n’utilisent que les nouveaux termes.

Verbes (commandes)

Règle : un verbe devinable par action, proche de git, sans jargon. Les anciens noms sont conservés comme alias masqués pour que rien ne casse.

haw run prend la commande en argument positionnel (haw run 'git fetch') ; -c/--command fonctionne toujours via l’alias forall. Lancer haw sans sous-commande ouvre le tableau de bord (comme htop, k9s).

Gestion des revs (conviviale par défaut)

• Un seul champ : rev = "main" | "v6.1.2" | "<40-hex sha>". Pas de clé type = ; le type est détecté (refs/heads > tag pelé > tag > SHA complet).
• Affichage : les SHA sont affichés sur 8 caractères partout ; haw.lock stocke les 40 complets.
• Jamais détaché : les revs de branche sont extraites sur une branche du même nom, les tags/SHA sur haw/<rev>.

Groupes (implémentés)

• groups = ["firmware", "ci"] sur un dépôt.
• haw sync --group firmware, haw status --group ci, haw forall --group firmware -c ... (répétable ; filtre vide = tout ; un filtre exclut les dépôts sans groupe).
• Les groupes sont enregistrés dans haw.lock afin que le filtrage fonctionne hors ligne.

Grille des options

Raccourcis clavier de la TUI

style k9s/lazygit, priorité au clavier. Trois mécanismes portent tout :

• les chiffres 1–7 changent de vue (depuis n’importe quelle vue liste de premier niveau),
• a ouvre les actions contextuelles de la vue courante (un menu de style lazygit),
• : est la barre de commande pour le reste — ses verbes reflètent la CLI (apprenez-en un, connaissez les deux).

Les données se chargent sur un worker en arrière-plan — l’interface ne se bloque jamais. La grille de la flotte se rafraîchit automatiquement toutes les ~5 s au repos (jamais pendant que vous saisissez, dans un overlay, une confirmation, ou lorsqu’une tâche est en cours) ; F5 / ctrl-r rafraîchissent à la demande.

Global (figé — ces touches signifient la même chose dans chaque vue)

Sauts de vue (1–7) — depuis n’importe quelle vue liste

Les chiffres sont inertes dans les vues de défilement/détail (détail dépôt/PR/CI, fichiers, grep) — sautez depuis une liste. Le tri (</>/.) s’applique aux tables Fleet, PR/MR et CI.

Vue Fleet

Le changement de stack, le lock et le git-fetch sont passés dans la barre de commande : :stack (sélecteur) / :stack NAME, :lock, :fetch. L’épinglage du lockfile se fait avec p dans la vue Stacks (ou :pin).

Les marques persistent entre les vues Fleet et Changeset ; lorsque des marques sont posées, s (sync) et r/:run n’agissent que sur l’ensemble marqué.

Vue PR/MR de la flotte (3) et vue CI (4)

a (actions) et d sont également disponibles depuis le détail d’une PR/MR. Le rechargement se fait désormais simplement avec F5 / ctrl-r.

Vue Fichiers (f depuis un dépôt)

Un navigateur en lecture seule : visualisez ou sélectionnez un fichier à n’importe quelle ref, sur le disque local ou la forge (GitHub / GitLab / Bitbucket). Il n’indexe/ne committe jamais — il ne fait que lire. Deux modes partagent le même contexte dépôt / ref / portée et basculent avec T : une liste plate d’un seul répertoire (par défaut) et un arbre navigable et extensible.

Vue Arbre (T depuis Fichiers)

L’arbre récupère une fois tous les chemins de fichiers du dépôt à la ref active, puis se déplie/replie côté client. Les répertoires repliés affichent ▸, dépliés ▾ ; les fichiers sont indentés sous leurs parents.

Sélecteur de ref (r dans l’un ou l’autre mode)

r ouvre une fenêtre listant les branches puis les tags du dépôt (j/k + enter pour choisir), plus une ligne de saisie pour taper une ref arbitraire ou un SHA de commit. Sélectionner une ref recharge la vue courante À LA DATE de cette ref (la liste plate se réenracine à la racine du dépôt ; l’arbre récupère à nouveau ses chemins). Le titre du panneau affiche honnêtement la ref active : @ main, @ v1.0.0, @ a1b2c3d, ou @ HEAD (local) / @ default (distant) lorsqu’aucune n’est épinglée. Les refs locales proviennent de git for-each-ref / git ls-tree / git show <ref>:<path> ; les refs et arbres de la forge proviennent de l’API REST de chaque forge.

e suspend le cockpit, confie le TTY courant à $VISUAL/$EDITOR (avec repli sur nvim/vim/vi) sur le chemin absolu du fichier, puis reprend et recharge la liste. Il est refusé sur la vue forge (R) et sur les répertoires ; si le dépôt n’est pas sur le disque, il propose de synchroniser.

Vue Erreurs, vue Plugins, vue Gouvernance

Accédez-y depuis une vue liste (Erreurs via :errors/:err, Plugins via 7/:plugins, Gouvernance via 6/:governance). Dans Gouvernance, o ouvre l’artefact du plugin sous le curseur (SBOM / provenance / …). Le rechargement se fait avec F5 / ctrl-r ; b / esc reviennent en arrière.

Vue Changeset

Menu d’actions (a)

a ouvre une fenêtre actions encadrée listant les actions contextuelles de la vue courante, chacune avec sa sous-touche. Appuyer sur une sous-touche listée déclenche cette action — les actions d’écriture conservent leur barrière de confirmation y/n. esc (ou toute touche non listée) annule. Les vues sans action le signalent.

Barre de commande (:)

Les verbes reflètent la CLI, et la ligne d’état affiche la commande exacte que chacun exécute, de sorte que la TUI sert aussi à découvrir la CLI.

Thèmes / skins

Sept habillages intégrés : classic, catppuccin (par défaut), dracula, nord, gruvbox, solarized, monochrome. classic est un habillage neutre en ANSI 16 couleurs qui se lit aussi bien sur les terminaux clairs que sombres. :theme sans argument ouvre un sélecteur interactif (mettant en évidence l’habillage actif) ; appuyer sur enter applique l’habillage en direct et le persiste dans [ui].theme de la configuration. :theme <name> change (et persiste) toujours directement.

Configuration utilisateur — ~/.config/haw/config.toml

Optionnel. Un fichier absent, une table partielle ou une clé inconnue retombent tous sur des valeurs par défaut raisonnables (le cockpit n’échoue jamais en cas d’absence). HAW_CONFIG remplace le chemin.

[ui]
theme = "classic"        # startup theme (a built-in name)
editor = "nvim"          # editor for the `e` key
compact_header = false   # start with the header collapsed
refresh_secs = 5         # idle auto-refresh cadence (clamped 2–60)

[keys]                   # remap a SAFE subset of action keys (single chars)
sync = "s"               # remappable: sync, goto, run, shell, files, problems, watch
goto = "g"

Priorité :

• Thème : NO_COLOR (non vide) → monochrome ; sinon HAW_THEME (env) s’il nomme un thème intégré ; sinon [ui].theme ; sinon le catppuccin par défaut.
• Éditeur : $VISUAL → $EDITOR (l’env l’emporte toujours) → [ui].editor → le premier de nvim/vim/vi sur le PATH → vi.

Raccourcis personnalisés ([keys])

Chaque entrée associe un nom d’action à un unique caractère de touche. Seul un sous-ensemble sûr est remappable — sync, goto, run, shell, files, problems, watch. Les globales gelées (j, k, :, /, ?, q, b, space, g, w, et les sauts de vue par chiffres 1–7) ne peuvent jamais être la cible d’un remap ; un remap qui vise une globale, duplique un autre remap, entre en collision avec une touche d’action par défaut ou n’est pas un unique caractère est ignoré avec un avertissement au démarrage. Quand un remap est actif, les indices de l’en-tête montrent la touche active pour rester honnêtes. La touche par défaut d’origine continue de fonctionner aussi (un remap ajoute, ne retire jamais).

Livré depuis la rédaction de cette conception

• haw pin / haw unpin (alias freeze/unfreeze).
• --label <L> sur change start, transmis aux PR/MR lors de change request.
• clé forge = "github" | "gitlab" sur [remote.X] pour les hôtes que l’heuristique d’URL ne détecte pas.
• deps = [...] sur un dépôt — change land fusionne dans un ordre topologique stable.
• haw verify, haw sync --locked, --format json sur status/tree, code de sortie 3 en cas de dérive.
• haw build / haw test (commandes par dépôt dans le manifeste), hooks de cycle de vie dans .haw/hooks/, haw hooks install, haw evidence, plugins haw-<name>.
• Nuance de lexique : --slug sur repo add accepte --repo comme alias ; haw run prend la commande en argument positionnel (forall -c fonctionne toujours).
• Dans la TUI, g (goto) quitte et affiche le chemin du dépôt — cd "$(haw dash)" — au lieu de lancer un shell imbriqué.
• TUI : rafraîchissement automatique en direct au repos (~5 s), filtre flou / (nucleo), tri par colonne (</>/.), marques + s/r en lot, détails pour les dépôts/PR/exécutions CI, le menu d’actions a (fusionner / approuver / checkout dans PR/MR ; demander-PR / intégrer dans Changeset), la vue gouvernance à l’échelle de la flotte (6), le navigateur de fichiers (f) avec un arbre navigable (T), un sélecteur de ref (r) et l’édition locale (e), et sept thèmes dont classic (HAW_THEME, NO_COLOR, :theme en direct avec un sélecteur interactif).
• Fichier de configuration de la TUI ~/.config/haw/config.toml : [ui] thème de démarrage / éditeur / compact_header / refresh_secs, plus [keys] raccourcis personnalisés pour un sous-ensemble sûr de touches d’action. Les sélecteurs interactifs :theme / :editor persistent un choix ; :compact bascule l’en-tête replié.

Prévu (pas encore implémenté)

• Commodités liées aux tags : haw lock --as-of <tag> ; haw status indiquant le type de rev (branch/tag/sha).
• haw auth login — flux OAuth par appareil + trousseau du système d’exploitation (voir ARCHITECTURE DR-14).
• TUI : prise en charge de la souris.