Livraison

Planifier et exécuter une livraison, par module ou pour le projet entier ; canaux interne et public.

deliveries

effortless_deliveries — Stabilité : beta · projet

Journal des livraisons, la plus récente d'abord : date, canal, module, tag, version, dépôt, issue ; et les canaux de chaque cible. Lecture seule.

💬 Vous demandez à l’agent

« Montre-moi le journal des livraisons : quelles versions sont parties, sur quel canal ? »

→ L’agent appelleeffortless_deliveries

Aucun paramètre.

release_apply

effortless_release_apply — Stabilité : beta · projet

Exécute RÉELLEMENT les étapes de release sélectionnées (steps, bump) : bump des versions (project.version + settings.release.version_files, vérifiés avant écriture), commit et push (fusion en avance rapide seulement), tag et release GitHub (gh), build et envoi des artefacts. stack cible un seul module (sa version, son dépôt, son tag, sa livraison) ; absent = le projet entier. La première étape en échec arrête la chaîne ; une étape impossible faute d'outil rend un relais nommé. Actions sortantes : à n'appeler qu'après consentement explicite. Gaté (semi-auto).

💬 Vous demandez à l’agent

« Vas-y, livre le module site en patch : bump de version, commit, tag, release GitHub et artefacts. »

→ L’agent appelleeffortless_release_apply

• steps = bump_version,git_flow,tag_release,delivery
• bump = patch
• stack = site

Nom	Type	Requis	Description
steps	string	oui	Étapes à jouer, en liste CSV ou tableau JSON d'ids parmi bump_version, git_flow, tag_release, update_docs et delivery ; les ids inconnus sont ignorés et une sélection vide ne joue rien. Obligatoire.
bump	string	non	Niveau de bump : patch (défaut), minor ou major ; toute autre valeur vaut patch.
stack	string	non	Id de la stack (module) à livrer : sa version, son dépôt, son tag (vX.Y.Z dans son propre dépôt, <stack>-vX.Y.Z dans celui du projet) et sa livraison ; absent = le projet entier.

release_channels_set

effortless_release_channels_set — Stabilité : beta · projet

Règle les dépôts de release interne (vide = origine) et public (vide = aucun) d'une stack ; default = le projet entier.

💬 Vous demandez à l’agent

« Pour le module site, règle le dépôt interne sur ArboRithm/site-interne et le public sur ArboRithm/site. »

→ L’agent appelleeffortless_release_channels_set

• stack = site
• internal = ArboRithm/site-interne
• public = ArboRithm/site

Nom	Type	Requis	Description
stack	string	oui	Id de la stack (module) ; default = le projet entier. Obligatoire.
internal	string	non	Dépôt de release interne (owner/nom) ; vide = le dépôt d'origine ; absent = inchangé.
public	string	non	Dépôt de release public (owner/nom) ; vide = canal retiré ; absent = inchangé.

release_config_set

effortless_release_config_set — Stabilité : beta · projet

Configure les champs de release (git_flow, tag, update_docs) dans effortless.json.

💬 Vous demandez à l’agent

« Configure la release : active le flux git, le tag de version et la mise à jour des docs. »

→ L’agent appelleeffortless_release_config_set

• git_flow = true
• tag = true
• update_docs = true

Nom	Type	Requis	Description
git_flow	boolean	non	Si true, le plan de release inclut l'étape de flux Git (branche de release) ; au moins un de git_flow, tag, update_docs est requis.
tag	boolean	non	Si true, le plan de release inclut la création du tag de version.
update_docs	boolean	non	Si true, le plan de release inclut l'étape de mise à jour de la documentation.

release_config_show

effortless_release_config_show — Stabilité : beta · projet

Configuration de release effective du projet. Lecture seule.

💬 Vous demandez à l’agent

« Quelle est la configuration de release du projet ? »

→ L’agent appelleeffortless_release_config_show

Aucun paramètre.

release_delivery_set

effortless_release_delivery_set — Stabilité : beta · projet

Configure la livraison de release (stack, commande de build, artefacts) dans effortless.json.

💬 Vous demandez à l’agent

« Pour le module app, configure la livraison : build par `pnpm build`, artefacts dans dist/*.dmg. »

→ L’agent appelleeffortless_release_delivery_set

• stack = app
• build_command = pnpm build
• artifacts = dist/*.dmg

Nom	Type	Requis	Description
stack	string	oui	Id de la stack ciblée (ou default) ; une stack non déclarée est refusée. Obligatoire.
build_command	string	oui	Commande de build qui produit les artefacts de livraison. Obligatoire.
artifacts	string	non	Globs ou chemins des artefacts produits, en liste séparée par des virgules ou tableau JSON ; absent, conserve ceux déjà enregistrés pour cette stack.

release_plan

effortless_release_plan — Stabilité : beta · projet

Plan de release (bump de version + livrables) du projet entier, ou d'une stack (stack) : sa version, son dépôt, son tag. Lecture seule.

💬 Vous demandez à l’agent

« Prépare le plan de release d'un bump mineur pour le module site : version, dépôt et tag. »

→ L’agent appelleeffortless_release_plan

• bump = minor
• stack = site

Nom	Type	Requis	Description
bump	string	non	Niveau de bump : patch (défaut), minor ou major ; toute autre valeur vaut patch.
stack	string	non	Id de la stack (module) à planifier : sa version, son dépôt et son tag ; absent = le projet entier.

release_promote

effortless_release_promote — Stabilité : beta · projet

Publie sur le dépôt public une version déjà livrée en interne, telle quelle (même tag, mêmes artefacts). Refusé sans dépôt public, sans release interne, si déjà publique, en semi-auto, ou si confirm ne redonne pas le tag. Sortant et irréversible : après accord explicite de l'utilisateur.

💬 Vous demandez à l’agent

« Vas-y, publie sur le dépôt public le module site en v1.4.1, déjà livré en interne ; je confirme le tag v1.4.1. »

→ L’agent appelleeffortless_release_promote

• stack = site
• tag = v1.4.1
• confirm = v1.4.1

Nom	Type	Requis	Description
stack	string	non	Id de la stack (module) dont la version est publiée ; absent = le projet entier.
tag	string	oui	Tag déjà livré en interne à publier (par exemple v1.4.1, site-v1.4.1). Obligatoire.
confirm	string	oui	Confirmation : le MÊME tag, redonné après l'accord explicite de l'utilisateur. Obligatoire.