À propos du projet
Orbi est un système automatisé qui transforme les Issues GitHub en versions taguées. Il revendique une Issue, la développe dans un worktree isolé, exécute une session de revue indépendante, fusionne uniquement la tête revue, et publie un tag via une Issue de version. Les Issues GitHub servent de seul stockage d'état—pas de base de données, file d'attente ou démon.
Fonctionnalités clés :
- **Pool de tâches via Issues GitHub** : L'étiquette `ai-ready` répartit le travail ; les enregistrements de livraison (commentaires, PR, CI) sont complets par défaut.
- **Entièrement automatisé** : Une minuterie planifiée utilisateur (systemd sous Linux, launchd sous macOS) déclenche un tick toutes les 5 minutes ; aucune commande de statut manuelle requise.
- **Revue indépendante + portes de fusion** : Après l'ouverture d'une PR, une session de revue indépendante corrige les constats ; seule la tête revue peut fusionner, et l'IA ne fusionne ni ne pousse jamais les branches protégées.
- **Échec rapide** : Les erreurs de commande échouent immédiatement, consignent des preuves, et marquent l'Issue `ai-blocked` pour décision humaine.
- **Observable de bout en bout** : Chaque journal et commentaire GitHub porte le même `run_id` pour une reconstruction complète de la chronologie.
Flux de travail : Issue GitHub (ai-ready) → Revendication (branche + worktree) → Développement Pi (planifier, implémenter, tester, vérifier) → Livraison de commit → Clôture du runner (synchroniser, pousser, créer PR) → Revue indépendante → Porte de fusion → Fusion.
Les commandes CLI incluent `orbi add` (répartir le travail), `status` (voir la file), `session` (suivre la session Pi), `install-units` (installer les unités planifiées), et `doctor` (diagnostics en lecture seule).
L'installation nécessite Python ≥ 3.14, `uv`, `pi` (avec un fournisseur), GitHub CLI ≥ 2.94, et une session utilisateur systemd Linux ou une session GUI launchd macOS. Démarrage rapide : cloner, installer avec `uv tool install --force --reinstall --editable --python python3 .`, copier la configuration d'exemple, exécuter `orbi setup`, puis `python3 -m orbi.runner` pour un tick manuel, et `orbi doctor` pour vérifier la santé.
La documentation couvre la prise en main, la configuration, le flux de travail, les opérations, les tests et la contribution. Le projet est sous licence fair-code (Sustainable Use License v1.0) : gratuit pour usage personnel et interne d'entreprise, partageable à des fins non commerciales, mais une autorisation commerciale est requise uniquement si vous vendez Orbi lui-même (par exemple, hébergement en tant que service).
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.