cli-anything-mubu

O que cli-anything-mubu faz?

Ponto de entrada canônico empacotado para a ponte ao vivo do Mubu.

Instalação

Esta CLI é empacotada a partir da árvore fonte canônica agent-harness:

pip install -e .

Pré-requisitos:

• Python 3.10+
• Uma sessão ativa do Mubu desktop nesta máquina
• Dados de perfil local do Mubu disponíveis para a CLI
• Defina MUBU_DAILY_FOLDER se quiser ajudantes diários sem argumentos

Pontos de Entrada

cli-anything-mubu
python -m cli_anything.mubu

Quando invocada sem um subcomando, a CLI entra em uma sessão REPL interativa.

Grupos de Comandos

Descobrir

Comandos de descoberta para pastas, documentos, atualidade e resolução de documentos diários.

Comando	Descrição
docs	Lista os snapshots de documentos conhecidos mais recentes dos backups locais.
folders	Lista metadados de pastas do armazenamento local RxDB.
folder-docs	Lista metadados de documentos de uma pasta.
path-docs	Lista documentos de um caminho de pasta ou id de pasta.
recent	Lista documentos recentemente ativos usando backups, metadados e logs de sincronização.
daily	Encontra pastas do tipo Diário e lista os documentos dentro delas.
daily-current	Resolve o documento diário atual de uma pasta do tipo Diário.

Inspecionar

Comandos de inspeção para visualizações em árvore, pesquisa, links, eventos de sincronia e direcionamento de nós ao vivo.

Comando	Descrição
show	Mostra a árvore de backup mais recente de um documento.
search	Pesquisa nos backups mais recentes por texto de nó ou conteúdo de nota correspondente.
changes	Analisa eventos de alteração de sincronização do cliente recentes dos logs locais.
links	Extrai links de documentos Mubu de saída de um backup de documento.
open-path	Abre um documento por caminho completo, caminho de sufixo, título ou id do documento.
doc-nodes	Lista nós de documentos ao vivo com ids de nó e caminhos de destino de atualização.
daily-nodes	Lista nós ao vivo do documento diário atual em uma única etapa.

Mutar

Comandos de mutação para edições ao vivo atômicas com dry-run primeiro contra a API Mubu.

Comando	Descrição
create-child	Constrói ou executa uma criação de nó filho contra a API Mubu ao vivo.
delete-node	Constrói ou executa uma exclusão de nó contra a API Mubu ao vivo.
update-text	Constrói ou executa uma atualização de texto contra a API Mubu ao vivo.

Sessão

Comandos de sessão e estado para contexto atual de documento/nó e histórico de comandos locais.

Comando	Descrição
status	Mostra o estado atual da sessão.
state-path	Mostra o caminho do arquivo de estado da sessão.
use-doc	Persiste a referência do documento atual.
use-node	Persiste a referência do nó atual.
use-daily	Resolve e persiste a referência do documento diário atual.
clear-doc	Limpa a referência do documento atual.
clear-node	Limpa a referência do nó atual.
history	Mostra o histórico de comandos recentes armazenado no estado da sessão.

Fluxo de Trabalho Recomendado para Agentes

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

Regras de Segurança

1. Prefira comandos agrupados para uso por agentes; comandos legados planos permanecem para compatibilidade.
2. Use --json sempre que um agente for analisar a saída.
3. Prefira comandos discover ou inspect antes de qualquer comando mutate.
4. Mutações ao vivo são dry-run por padrão e só executam com --execute.
5. Prefira --node-id e --parent-node-id em vez de correspondência de texto.
6. delete-node remove toda a subárvore alvo.
7. Mesmo atualizações com o mesmo texto podem avançar o histórico de versões do documento.
8. Passe uma referência de pasta diária explicitamente ou defina MUBU_DAILY_FOLDER antes de usar ajudantes diários sem argumentos.

Exemplos

Sessão REPL Interativa

Inicie uma sessão interativa com contexto persistente de documento e nó.

cli-anything-mubu
# Digite comandos interativamente
# Use 'help' para ver comandos embutidos
# Use comandos de sessão para persistir current-doc/current-node

Descobrir Nota Diária Atual

Resolva a nota diária atual a partir de uma referência de pasta explícita.

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

Atualização Atômica em Dry-Run

Inspecione a carga útil de saída exata antes de uma mutação ao vivo.

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

Estado da Sessão

A CLI mantém estado leve da sessão em JSON:

• current_doc
• current_node
• histórico de comandos locais

Use o grupo de comandos session para inspecionar ou atualizar esse estado.

Para Agentes de IA

1. Comece com discover ou inspect, não mutate.
2. Use session status --json para recuperar contexto persistido.
3. Use comandos agrupados em prompts gerados e automação.
4. Verifique pós-condições após qualquer mutação ao vivo.
5. Leia o pacote TEST.md e README.md quando precisar de detalhes operacionais mais rigorosos.

Versão

0.1.1