> ## 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, arranque e aplicação

> Gira perfis de ciclo de vida protegidos, propriedade, observações, arranques e transições compatíveis com aplicação através do qxctl, com salvaguardas rigorosas de compare-and-swap.

A gramática `qxctl knowledge lifecycle ...` administra perfis protegidos, propriedade, observações, diários de arranque e transições compatíveis com aplicação. Cada mutação é compare-and-swap e cada aplicação está vinculada a evidência exata.

## 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
```

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

## Propriedade

* `ownership status`: inspeciona uma raiz partilhada configurada
* `ownership reconcile`: atualiza a respetiva evidência
* `ownership adopt`: adota apenas depois de rever cada reivindicação legada conservadora
* `ownership release`: liberta apenas para um recibo legado exato tornado intencionalmente recuperável

> [!WARNING]
>
> Nunca elimine nem reescreva manualmente o registo local da raiz ou a sua barreira de compatibilidade de layout de recibos `symphony-root-ownership/1`. Os clientes de ciclo de vida mais antigos têm de encontrar essa barreira e parar no seu bloqueio existente de pacote desconhecido.

## Observar, reportar, arrancar

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

## Perfis compatíveis com aplicação

Para um perfil `apply-compatible`, chame `apply` apenas com o digest exato da origem de arranque, o compare-and-swap do diário de aplicação, 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
```

Utilize `apply-status` para observar tentativas ou `apply-recover`, de forma limitada, para recuperação durável. Nunca escolha uma ação manualmente nem edite estado protegido.

> [!NOTE]
>
> Uma atualização de observação que altere apenas o carimbo temporal tem de alterar a evidência do documento sem fazer avançar as identidades semânticas estáveis.

## Superfícies relacionadas

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

> [card] [qxctl engines](https://docs.quanux.org/symphony/pt/qxctl/engines.md)
>
> Gira as associaçõ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/qxctl/knowledge.md)
- [qxctl: linha de comandos administrativa agêntica do Symphony](https://docs.quanux.org/symphony/pt/qxctl/overview.md)
- [SEV: Symphony Evolution Vector para alterações planeadas](https://docs.quanux.org/symphony/pt/skv/sev.md)
- [qxctl knowledge engines: associar, diagnosticar e migrar o registo](https://docs.quanux.org/symphony/pt/qxctl/engines.md)
- [qxctl knowledge session: sessões autenticadas do Symphony](https://docs.quanux.org/symphony/pt/qxctl/session.md)


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