Validando alterações

buildprint check valida as alterações do BubbleScript e mostra o que elas alterarão no Bubble antes que qualquer coisa seja aplicada.

Quando a validação é executada

Um agente executa a validação depois de editar o BubbleScript e antes de executar buildprint apply.

Edit BubbleScript
      ↓
Run a check
      ↓
Review diagnostics and planned changes
      ↓
Fix any errors and check again
      ↓
Apply the change

A verificação apenas lê o workspace local. Ela não altera o app do Bubble.

Executar uma verificação direcionada

Uma verificação direcionada fornece feedback rápido enquanto o agente trabalha em um arquivo ou pasta.

buildprint check pages/Dashboard/page.ts
buildprint check data-types/Task.ts
buildprint check pages/Dashboard/workflows

A verificação inclui o código-fonte selecionado e todos os arquivos relacionados necessários para validá-lo.

Uma verificação direcionada não pode deixar o workspace pronto para aplicação. Depois que ela for aprovada, o agente deverá executar uma verificação completa.

Executar uma verificação completa

Uma verificação completa valida todo o BubbleScript alterado e produz a lista final de alterações planejadas.

buildprint check

Se for aprovada, a linha final confirma que as alterações do BubbleScript estão prontas para aplicação.

Ler um diagnóstico

Cada diagnóstico explica onde está o problema, qual é a gravidade e o que o agente deve fazer em seguida.

pages/Dashboard/page.ts:42:18 error BSP1204
Unknown element "Button save".

  Action: Use an element name from the current page.
  Accepted: Button save task, Button cancel

data-types/Enquiry Message.ts:16:18 error BSP8020 This privacy rule cannot grant search access because its condition uses This Thing's X's Y. (expression site: privacyRule ["dataType",null,"enquiry_message"].privacyRules.participants_can_view_messages_)
  Action: Set search_for to false or use no more than one field lookup from thisItem()

data-types/Listing.ts:31:18 error BSP8020 This privacy rule cannot grant search access because its condition uses This Thing's X's Y. (expression site: privacyRule ["dataType",null,"listing"].privacyRules.shop_owner_can_view_listing_)
  Action: Set search_for to false or use no more than one field lookup from thisItem()

Um diagnóstico pode conter:

• Arquivo, linha e coluna — o local no código-fonte que requer atenção.

• Gravidade — error, warning ou info.

• Código — um identificador estável para o tipo de diagnóstico.

• Mensagem — o que é inválido ou precisa ser revisado.

• Ação — uma correção sugerida.

• Aceito — nomes ou valores válidos quando o Buildprint puder fornecê-los.

Os erros bloqueiam a aplicação. Avisos e informações podem destacar comportamentos que o agente deve revisar mesmo quando o código-fonte é válido.

Revisar as alterações planejadas

Uma verificação bem-sucedida descreve as alterações no Bubble produzidas pelo código-fonte editado.

Buildprint checked 2 BubbleScript files.
Apply includes 2 files.
  Change: Add field "Status" in "Task"
  Change: Rename element "Button save" to "Button save task"
Full check passed. The BubbleScript changes are ready to apply.

A lista de alterações pode incluir:

• novos nós;

• renomeações;

• alterações de tipo;

• alterações de layout, aparência ou outra apresentação;

• alterações nas regras de privacidade;

• alterações e reordenação de valores de opções;

• exclusão lógica e restauração; e

• exclusão permanente quando esse nó do Bubble for compatível com ela.

O agente deve comparar esta lista com a tarefa solicitada antes de aplicar as alterações. Alterações inesperadas geralmente significam que a edição do código-fonte foi ampla demais ou que uma identidade existente não foi preservada.

Corrigir problemas seguros no código-fonte

--fix aplica correções automáticas compatíveis ao código-fonte do BubbleScript e verifica-o novamente.

buildprint check --fix

A saída lista todos os arquivos alterados pelo Buildprint. O agente deve revisar essas edições antes de aplicar as alterações.

O Buildprint só corrige problemas para os quais existe uma alteração segura definida no código-fonte. Os demais diagnósticos ainda exigem uma edição manual.

Filtrar a saída

O agente pode reduzir a saída quando precisar se concentrar em uma determinada gravidade.

buildprint check --level warning
buildprint check --level error

warning inclui avisos e erros. error mostra apenas erros bloqueadores.

Para ferramentas que precisam de resultados estruturados, use a saída JSON:

buildprint check --json

Executar uma verificação profunda

--deep realiza uma validação mais lenta do app inteiro quando a alteração exige confiança adicional. Na maior parte do tempo, isso não deve ser feito, pois é mais lento, e os workspaces do BubbleScript são estruturados para que as alterações sejam locais e apenas as alterações precisem ser validadas.

buildprint check --deep

Use-a depois de uma refatoração ampla, antes de uma versão importante ou quando uma alteração afetar muitas partes relacionadas do app. Edições normais geralmente precisam apenas de verificações direcionadas durante o trabalho e de uma verificação completa antes da aplicação.

Entender os resultados da validação

Toda verificação termina com uma próxima ação clara.

• A aplicação está bloqueada — corrija cada erro informado e execute a verificação novamente.

• A verificação direcionada foi aprovada — execute uma verificação completa com buildprint check.

• A verificação completa foi aprovada — as alterações atuais do BubbleScript estão prontas para aplicação.

Quando a validação fica desatualizada

Uma verificação completa anterior deixa de ser válida depois que o código-fonte do BubbleScript ou a ramificação correspondente no Bubble é alterado.

O agente deve verificar novamente depois de:

• editar qualquer BubbleScript afetado;

• executar buildprint sync;

• resolver um conflito; ou

• outra alteração chegar à mesma ramificação do Bubble.

Se o código-fonte verificado e o estado atual não corresponderem mais, buildprint apply será interrompido em vez de aplicar o resultado antigo.