> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# qxctl knowledge lifecycle: perfil, boot e apply

> Gerencie perfis de ciclo de vida protegidos, propriedade, observações, boots e transições compatíveis com apply por meio do qxctl, com salvaguardas rigorosas de compare-and-swap.

A gramática `qxctl knowledge lifecycle ...` administra perfis protegidos, propriedade, observações, journals de boot e transições compatíveis com apply. Toda mutação é um compare-and-swap e todo apply está vinculado a evidências exatas.

## Perfil

Defina o perfil de ciclo de vida protegido para um TOPS:

```bash Profile compare-and-swap theme={null}
qxctl knowledge lifecycle profile set \
  --tops-id UUID \
  --input FILE \
  --expected-profile-digest absent|DIGEST
```

Informe `absent` para um perfil criado pela primeira vez ou o digest exato relatado por uma leitura anterior.

## Propriedade

* `ownership status`: inspeciona uma raiz compartilhada configurada
* `ownership reconcile`: atualiza suas evidências
* `ownership adopt`: adota somente após revisar cada reivindicação legada conservadora
* `ownership release`: libera somente para um recibo legado exato tornado intencionalmente reivindicável

> [!WARNING]
>
> Nunca exclua nem reescreva manualmente o registro local da raiz ou a sua barreira de compatibilidade de layout de recibos `symphony-root-ownership/1`. Clientes de ciclo de vida mais antigos precisam encontrar essa barreira e parar no bloqueio de pacote desconhecido já existente.

## Observar, relatar, boot

* `observe`: emite evidências descartáveis de recibo com layout fixo
* `report`: produz um plano descartável novo
* `boot`: progressão durável somente de relatório, com um ID de operação estável e estado exato do journal
* `status`: inspeção v1
* `recover --discover`: recupera uma cadeia v1 única quando o status comum não consegue validar o estado local

## Perfis compatíveis com apply

Para um perfil `apply-compatible`, chame `apply` somente com o digest exato da origem do boot, o compare-and-swap do journal de apply, o compare-and-swap do estado aplicado, um ID de operação estável e raízes preparadas explícitas:

```bash Apply theme={null}
qxctl knowledge lifecycle apply \
  --tops-id UUID \
  --operation-id OPID \
  --boot-source-digest DIGEST \
  --expected-apply-journal-digest DIGEST \
  --expected-applied-state-digest DIGEST \
  --staged-root PATH
```

Use `apply-status` para observar tentativas ou o `apply-recover` delimitado para recuperação durável. Nunca escolha uma ação manualmente nem edite o estado protegido.

> [!NOTE]
>
> Uma atualização de observação que altere apenas o timestamp deve modificar as evidências do documento sem avançar as identidades semânticas estáveis.

## Superfícies relacionadas

> [card] [Coordenador de sessões](https://docs.quanux.org/symphony/pt-BR/engines/coordinator.md)
>
> A engine por trás da coordenação de planos e apply do ciclo de vida.

> [card] [qxctl engines](https://docs.quanux.org/symphony/pt-BR/qxctl/engines.md)
>
> Gerencie as vinculações de engines referenciadas pelos planos de ciclo de vida.


## Related topics

- [qxctl knowledge: administração do ciclo de vida entre vetores](https://docs.quanux.org/symphony/pt-BR/qxctl/knowledge.md)
- [qxctl: linha de comando administrativa agêntica do Symphony](https://docs.quanux.org/symphony/pt-BR/qxctl/overview.md)
- [qxctl knowledge engines: vincular, diagnosticar e migrar o registro](https://docs.quanux.org/symphony/pt-BR/qxctl/engines.md)
- [qxctl knowledge session: sessões autenticadas do Symphony](https://docs.quanux.org/symphony/pt-BR/qxctl/session.md)
- [SKVI: a engine Symphony Knowledge Vector Index](https://docs.quanux.org/symphony/pt-BR/skv/skvi.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.