cli-anything-mubu

Que fait cli-anything-mubu ?

Point d'entrée packagé canonique pour le pont en direct Mubu.

Installation

Cette CLI est packagée à partir de l'arborescence source canonique agent-harness :

pip install -e .

Prérequis :

• Python 3.10+
• Une session de bureau Mubu active sur cette machine
• Données de profil Mubu locales accessibles à la CLI
• Définir MUBU_DAILY_FOLDER si vous souhaitez utiliser les aides quotidiennes sans argument

Points d'entrée

cli-anything-mubu
python -m cli_anything.mubu

Lorsqu'elle est invoquée sans sous-commande, la CLI entre dans une session REPL interactive.

Groupes de commandes

Découvrir

Commandes de découverte pour les dossiers, documents, récence et résolution de documents quotidiens.

Commande	Description
docs	Lister les instantanés de documents les plus récents à partir des sauvegardes locales.
folders	Lister les métadonnées des dossiers à partir du stockage RxDB local.
folder-docs	Lister les métadonnées des documents pour un dossier.
path-docs	Lister les documents pour un chemin de dossier ou un identifiant de dossier.
recent	Lister les documents récemment actifs à l'aide des sauvegardes, métadonnées et journaux de synchronisation.
daily	Trouver les dossiers de type Quotidien et lister les documents qu'ils contiennent.
daily-current	Résoudre le document quotidien actuel à partir d'un dossier de type Quotidien.

Inspecter

Commandes d'inspection pour les vues arborescentes, la recherche, les liens, les événements de synchronisation et le ciblage de nœuds en direct.

Commande	Description
show	Afficher la dernière sauvegarde arborescente d'un document.
search	Rechercher dans les dernières sauvegardes du texte de nœud ou du contenu de note correspondant.
changes	Analyser les événements de changement de synchronisation récents du client à partir des journaux locaux.
links	Extraire les liens de document Mubu sortants d'une sauvegarde de document.
open-path	Ouvrir un document par chemin complet, chemin suffixe, titre ou identifiant de document.
doc-nodes	Lister les nœuds de document en direct avec leurs identifiants et chemins de cible de mise à jour.
daily-nodes	Lister les nœuds en direct du document quotidien actuel en une seule étape.

Modifier

Commandes de mutation pour des modifications atomiques en direct en mode dry-run d'abord contre l'API Mubu.

Commande	Description
create-child	Construire ou exécuter une création de nœud enfant contre l'API Mubu en direct.
delete-node	Construire ou exécuter une suppression de nœud contre l'API Mubu en direct.
update-text	Construire ou exécuter une mise à jour de texte contre l'API Mubu en direct.

Session

Commandes de session et d'état pour le contexte de document/nœud courant et l'historique des commandes locales.

Commande	Description
status	Afficher l'état de session actuel.
state-path	Afficher le chemin du fichier d'état de session.
use-doc	Persister la référence du document courant.
use-node	Persister la référence du nœud courant.
use-daily	Résoudre et persister la référence du document quotidien actuel.
clear-doc	Effacer la référence du document courant.
clear-node	Effacer la référence du nœud courant.
history	Afficher l'historique récent des commandes stocké dans l'état de session.

Workflow recommandé pour les agents

discover daily-current '<daily-folder-ref>' --json
        ->
inspect daily-nodes '<daily-folder-ref>' --query '<anchor>' --json
        ->
session use-doc '<doc_path>'
        ->
mutate update-text / create-child / delete-node --json
        ->
--execute only after payload inspection

Règles de sécurité

1. Privilégier les commandes groupées pour les agents ; les commandes héritées plates restent pour la compatibilité.
2. Utiliser --json dès qu'un agent analysera la sortie.
3. Privilégier les commandes discover ou inspect avant toute commande mutate.
4. Les mutations en direct sont en dry-run par défaut et s'exécutent uniquement avec --execute.
5. Privilégier --node-id et --parent-node-id plutôt que la correspondance textuelle.
6. delete-node supprime toute la sous-arborescence ciblée.
7. Même les mises à jour de texte identique peuvent toujours faire avancer l'historique des versions du document.
8. Passer explicitement une référence de dossier quotidien ou définir MUBU_DAILY_FOLDER avant d'utiliser les aides quotidiennes sans argument.

Exemples

Session REPL interactive

Démarrer une session interactive avec un contexte de document et de nœud persistant.

cli-anything-mubu
# Saisir les commandes de manière interactive
# Utiliser 'help' pour voir les commandes intégrées
# Utiliser les commandes de session pour persister doc-courant/nœud-courant

Découvrir la note quotidienne actuelle

Résoudre la note quotidienne actuelle à partir d'une référence de dossier explicite.

cli-anything-mubu --json discover daily-current '<daily-folder-ref>'

Mise à jour atomique en dry-run

Inspecter la charge utile sortante exacte avant une mutation en direct.

cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'nouveau texte' --json

État de session

La CLI maintient un état de session léger en JSON :

• current_doc
• current_node
• historique des commandes locales

Utiliser le groupe de commandes session pour inspecter ou mettre à jour cet état.

Pour les agents IA

1. Commencer par discover ou inspect, pas mutate.
2. Utiliser session status --json pour récupérer le contexte persistant.
3. Utiliser les commandes groupées dans les invites générées et l'automatisation.
4. Vérifier les postconditions après toute mutation en direct.
5. Lire les fichiers TEST.md et README.md du paquet lorsque des détails opérationnels plus stricts sont nécessaires.

Version

0.1.1