cli-anything-mubu

¿Qué hace cli-anything-mubu?

Punto de entrada empaquetado canónico para el puente en vivo de Mubu.

Instalación

Esta CLI se empaqueta desde el árbol fuente canónico agent-harness:

pip install -e .

Requisitos previos:

• Python 3.10+
• Una sesión de escritorio activa de Mubu en esta máquina
• Datos de perfil local de Mubu disponibles para la CLI
• Configurar MUBU_DAILY_FOLDER si se desean los ayudantes diarios sin argumentos

Puntos de entrada

cli-anything-mubu
python -m cli_anything.mubu

Cuando se invoca sin un subcomando, la CLI inicia una sesión REPL interactiva.

Grupos de comandos

Descubrimiento

Comandos de descubrimiento para carpetas, documentos, actualidad y resolución de documentos diarios.

Comando	Descripción
docs	Lista las últimas instantáneas de documentos conocidas desde copias de seguridad locales.
folders	Lista los metadatos de carpetas desde el almacenamiento RxDB local.
folder-docs	Lista los metadatos de documentos de una carpeta.
path-docs	Lista documentos de una ruta de carpeta o ID de carpeta.
recent	Lista documentos recientemente activos usando copias de seguridad, metadatos y registros de sincronización.
daily	Busca carpetas de estilo Diario y lista los documentos dentro de ellas.
daily-current	Resuelve el documento diario actual de una carpeta de estilo Diario.

Inspección

Comandos de inspección para vistas de árbol, búsqueda, enlaces, eventos de sincronización y direccionamiento de nodos en vivo.

Comando	Descripción
show	Muestra el último árbol de copia de seguridad de un documento.
search	Busca en las últimas copias de seguridad texto de nodo o contenido de notas coincidentes.
changes	Analiza eventos de cambio de sincronización recientes del cliente desde registros locales.
links	Extrae enlaces salientes de documentos Mubu de una copia de seguridad de documento.
open-path	Abre un documento por ruta completa, ruta de sufijo, título o ID de documento.
doc-nodes	Lista los nodos de documentos en vivo con IDs de nodo y rutas de destino de actualización.
daily-nodes	Lista los nodos en vivo del documento diario actual en un solo paso.

Mutación

Comandos de mutación para ediciones atómicas en vivo con ejecución en seco primero contra la API de Mubu.

Comando	Descripción
create-child	Construye o ejecuta una creación de nodo hijo contra la API de Mubu en vivo.
delete-node	Construye o ejecuta una eliminación de nodo contra la API de Mubu en vivo.
update-text	Construye o ejecuta una actualización de texto contra la API de Mubu en vivo.

Sesión

Comandos de sesión y estado para el contexto actual de documento/nodo y el historial de comandos local.

Comando	Descripción
status	Muestra el estado actual de la sesión.
state-path	Muestra la ruta del archivo de estado de la sesión.
use-doc	Persiste la referencia del documento actual.
use-node	Persiste la referencia del nodo actual.
use-daily	Resuelve y persiste la referencia del documento diario actual.
clear-doc	Limpia la referencia del documento actual.
clear-node	Limpia la referencia del nodo actual.
history	Muestra el historial de comandos reciente almacenado en el estado de la sesión.

Flujo de trabajo recomendado para el agente

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

Reglas de seguridad

1. Prefiere comandos agrupados para uso del agente; los comandos planos heredados permanecen para compatibilidad.
2. Usa --json siempre que un agente vaya a analizar la salida.
3. Prefiere comandos discover o inspect antes de cualquier comando mutate.
4. Las mutaciones en vivo se ejecutan en seco por defecto y solo se ejecutan con --execute.
5. Prefiere --node-id y --parent-node-id sobre la coincidencia de texto.
6. delete-node elimina todo el subárbol objetivo.
7. Incluso las actualizaciones de texto idéntico pueden avanzar el historial de versiones del documento.
8. Pasa una referencia de carpeta diaria explícitamente o configura MUBU_DAILY_FOLDER antes de usar los ayudantes diarios sin argumentos.

Ejemplos

Sesión REPL interactiva

Inicia una sesión interactiva con contexto persistente de documento y nodo.

cli-anything-mubu
# Ingresa comandos interactivamente
# Usa 'help' para ver los comandos integrados
# Usa comandos de sesión para persistir documento-actual/nodo-actual

Descubrir la nota diaria actual

Resuelve la nota diaria actual desde una referencia de carpeta explícita.

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

Actualización atómica en seco

Inspecciona la carga útil saliente exacta antes de una mutación en vivo.

cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'nuevo texto' --json

Estado de la sesión

La CLI mantiene un estado de sesión ligero en JSON:

• current_doc
• current_node
• historial de comandos local

Usa el grupo de comandos session para inspeccionar o actualizar este estado.

Para agentes de IA

1. Comienza con discover o inspect, no con mutate.
2. Usa session status --json para recuperar el contexto persistido.
3. Usa comandos agrupados en indicaciones generadas y automatización.
4. Verifica las condiciones posteriores después de cualquier mutación en vivo.
5. Lee el archivo TEST.md y README.md del paquete cuando se necesiten detalles operativos más estrictos.

Versión

0.1.1