> ## 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: profilo, boot e apply

> Gestisci tramite qxctl profili di ciclo di vita protetti, ownership, osservazioni, boot e transizioni compatibili con l'apply, con rigorose salvaguardie compare-and-swap.

La grammatica `qxctl knowledge lifecycle ...` amministra profili protetti, ownership, osservazioni, journal di boot e transizioni compatibili con l'apply. Ogni mutazione è un compare-and-swap e ogni apply è vincolato a evidenze esatte.

## Profilo

Imposta il profilo di ciclo di vita protetto per un TOPS:

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

Specifica `absent` per un profilo creato per la prima volta, oppure il digest esatto riportato da una lettura precedente.

## Ownership

* `ownership status`: ispeziona una radice condivisa configurata
* `ownership reconcile`: aggiorna le relative evidenze
* `ownership adopt`: adotta solo dopo aver esaminato ogni rivendicazione legacy conservativa
* `ownership release`: rilascia solo per una specifica ricevuta legacy resa intenzionalmente rivendicabile

> [!WARNING]
>
> Non eliminare né riscrivere mai a mano il registro locale della radice o la relativa barriera di compatibilità del layout delle ricevute `symphony-root-ownership/1`. I client di ciclo di vita meno recenti devono incontrare quella barriera e arrestarsi sul loro blocco esistente per pacchetto sconosciuto.

## Observe, report, boot

* `observe`: emette evidenze di ricevuta usa e getta a layout fisso
* `report`: produce un nuovo piano usa e getta
* `boot`: progressione durevole di sola segnalazione con un ID operazione stabile e uno stato del journal esatto
* `status`: ispezione v1
* `recover --discover`: recupera una catena v1 univoca quando lo status ordinario non riesce a validare lo stato locale

## Profili compatibili con l'apply

Per un profilo `apply-compatible`, chiama `apply` solo con il digest esatto della sorgente di boot, il compare-and-swap del journal di apply, il compare-and-swap dello stato applicato, un ID operazione stabile e radici di staging esplicite:

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

Usa `apply-status` per osservare i tentativi oppure `apply-recover`, con limiti definiti, per il recupero durevole. Non scegliere mai un'azione manualmente e non modificare lo stato protetto.

> [!NOTE]
>
> Un aggiornamento dell'osservazione che riguarda solo il timestamp deve modificare le evidenze del documento senza far avanzare le identità semantiche stabili.

## Superfici correlate

> [card] [Coordinatore di sessione](https://docs.quanux.org/symphony/it/engines/coordinator.md)
>
> L'engine alla base della coordinazione di piani e apply del ciclo di vita.

> [card] [qxctl engines](https://docs.quanux.org/symphony/it/qxctl/engines.md)
>
> Gestisci i binding degli engine a cui fanno riferimento i piani di ciclo di vita.


## Related topics

- [qxctl knowledge: amministrazione del ciclo di vita tra vettori](https://docs.quanux.org/symphony/it/qxctl/knowledge.md)
- [qxctl: la riga di comando amministrativa agentica di Symphony](https://docs.quanux.org/symphony/it/qxctl/overview.md)
- [SEV: Symphony Evolution Vector per le modifiche pianificate](https://docs.quanux.org/symphony/it/skv/sev.md)
- [qxctl knowledge engines: bind, doctor e migrazione del registro](https://docs.quanux.org/symphony/it/qxctl/engines.md)
- [qxctl knowledge session: sessioni Symphony autenticate](https://docs.quanux.org/symphony/it/qxctl/session.md)


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