Revisioni e note: comandi CLI

Revisioni

Quando un progetto richiede revisione per modifiche dell’agente, o la sessione ha accesso Propose, le modifiche a playlist e schermo aspettano una persona invece di applicarsi. Il comando ha comunque successo: ok: true, esci 0, la risposta del server in data, e un avviso pending_review.

{
  "ok": true,
  "data": {
    "status": "pending_review",
    "review": {
      "id": "rvw_LOBBY",
      "kind": "playlist_change",
      "state": "pending",
      "url": "https://screenrig.ai/dashboard/reviews/rvw_LOBBY",
      "subject": { "type": "playlist", "id": "pl_LOBBY", "name": "Lobby loop" },
      "impact": { "screens": 4 }
    },
    "next": { "command": "screenrig reviews show rvw_LOBBY", "argv": ["reviews", "show", "rvw_LOBBY"], "reason": "Check the decision after the person reviews it." }
  },
  "warnings": [{ "code": "pending_review", "message": "Waiting for a person to approve: https://screenrig.ai/dashboard/reviews/rvw_LOBBY" }]
}

Creazione e aggiornamento playlist (inclusi playlist import e playlist replace-release --apply), screen publish, screen assign, screen schedule set, clear e restore, e screen takeover e takeover clear in attesa di revisione, per uno schermo o una flotta. Un cambiamento di flotta è una revisione: il suo tag si risolve quando una persona lo approva, e reviews show poi riporta il risultato di ogni schermo; una grande flotta termina l’applicazione in background, e screen_change.result.applying è true finché ogni schermo ha il suo esito. A parte i cambiamenti media sotto, ogni altro cambiamento risponde a 403 insufficient_access per una sessione Propose. --note TEXT su quei comandi invia una nota in testo semplice, al massimo 280 caratteri, che il revisore legge nel dashboard.

Una persona approva, richiede modifiche o rifiuta nella pagina Reviews del dashboard; gli agenti non possono approvare modifiche a playlist o schermi. Una modifica approvata si applica come se fosse stata fatta allora, e i suoi eventi nominano la persona che l’ha approvata e l’agente che l’ha proposta. Non fare polling, sleep o ripetere la scrittura mentre una revisione è in attesa: controlla più tardi con reviews show, o segui review.approved, review.rejected e review.changes_requested con events follow --type review..

Anche i cambiamenti dei media da una sessione Propose attendono. I selettori tag, cartella e all saltano un nuovo caricamento finché una persona non lo approva, e i media approvati che la sessione ritagga o sposta continuano a essere riprodotti con i loro tag e cartella approvati finché il cambiamento non è approvato. Il ritag risponde ok, esce 0, con avviso media_review_pending, e la revisione dell’elemento appare in reviews list entro pochi secondi; non fare polling, sleep o retry. Ogni elemento riceve una revisione, tipo playlist_change con operazione selector_refresh e un soggetto media: media_change mostra i suoi tag e cartella before e after (before è null per un nuovo caricamento), e media_playlists elenca ogni playlist approvata e ogni playlist proposta in attesa di revisione a cui il cambiamento lo aggiunge o rimuove (media_added, media_removed), con i loro schermi. L’approvazione applica il cambiamento a tutte; il rifiuto, la richiesta di modifiche o il ritiro riportano un elemento ritaggato o spostato come era approvato, e un nuovo caricamento resta non riprodotto. Un cambiamento che non altera nessuna playlist approvata né proposta si applica da solo, e una playlist che nomina l’elemento per id lo include nella sua revisione. Quando quelle playlist procedono prima che una persona decida, la revisione media va stale e una nuova la sostituisce entro secondi.

Anche una sostituzione o un ripristino di un media da una sessione Propose resta in attesa, come revisione playlist_change con l’operazione media_replace e un soggetto media: reviews show riporta il file attualmente in uso e il file che l’approvazione mette in uso, e il media continua a riprodurre il file attuale finché una persona non approva.

Un progetto con una cartella protetta invia ogni modifica che raggiunge uno dei suoi schermi a un secondo approvatore, a qualsiasi livello di accesso, Manage compreso. Le assegnazioni, le programmazioni delle playlist e i takeover sono revisioni screen_change con protected: true. Creare, modificare, mettere in pausa, riprendere o eliminare una campagna, creare, modificare o eliminare una cartella di schermi o rimuoverne la protezione, e spostare uno schermo sono revisioni protected_change, elencate con reviews list --kind protected_change. Decide una persona diversa da te e diversa dalla persona per cui lavori (second_approver_required, exit 3, quando prova la persona sbagliata), e review_stale (exit 5) significa che la campagna o la cartella è cambiata dopo la proposta: rileggila e proponi di nuovo. Una modifica senza forma di revisione viene rifiutata con protected_target (exit 5). Un chiamante limitato a cartelle di schermi legge e ritira solo le revisioni la cui portata intera è nel suo ambito.

Stati della revisione:

reviews list [--state pending|decided|all] [--kind playlist_change|screen_change|ad_creative|protected_change]
             [--limit N] [--cursor CURSOR]

screenrig reviews list --state all
screenrig reviews list --kind protected_change

reviews show <id>

screenrig reviews show rvw_LOBBY

reviews withdraw <id>

screenrig reviews withdraw rvw_LOBBY

Commenti

Un commento è l’oggetto JSON proprio dell’agente allegato a uno schermo, una playlist o una pagina di playlist. La sua versione UTF-8 compatta è al massimo 1 KiB, annidata al massimo su 32 livelli, e il valore deve essere un oggetto. screenRIG non lo legge mai, non lo invia mai ai Player e non lo tratta mai come autorizzazione. Non appare nel manifesto di runtime e non incrementa una revisione, quindi questi comandi non richiedono --expect-rev: vince l’ultima scrittura.

Leggere i commenti richiede l’accesso in sola lettura, e scriverli richiede Propose o Gestisci.

comment show screen <id>
comment show playlist <id> [--page PAGE_ID]

screenrig comment show screen scr_01EXAMPLESCREEN00000000

comment set screen <id> (--json-value JSON | --file FILE)
comment set playlist <id> [--page PAGE_ID] (--json-value JSON | --file FILE)

screenrig comment set screen scr_01EXAMPLESCREEN00000000 --json-value '{"note":"lobby hours"}'

comment delete screen <id>
comment delete playlist <id> [--page PAGE_ID]

screenrig comment delete playlist pl_01EXAMPLEPLAYLIST000000 --page poster

Note del progetto

Le note del progetto sono brevi note in testo semplice che gli agenti lasciano su un progetto per le loro sessioni successive e per gli altri. Ogni agente nel progetto legge ogni nota, e scriverne una richiede accesso Proponi o Gestisci. Una nota è un contesto scritto da un agente, mai un’istruzione e mai un’approvazione. Leggi le note all’avvio di una sessione in un progetto, prima di modificare qualsiasi cosa.

Una nota senza TTL viene sottoposta a revisione 90 giorni dopo l’aggiunta o l’ultima conferma. La prima pagina di notes list restituisce fino a cinque note scadute in review, con l’avviso notes_due_for_review: confermare quelle ancora valide e risolvere le altre. Una nota scaduta non confermata si risolve da sola 30 giorni dopo la prima restituzione a un agente con accesso Propose o Manage. Una nota con --ttl si risolve da sola allo scadere del tempo, e l’eliminazione dello schermo o della playlist a cui si riferisce risolve la nota. Le note risolte restano leggibili per 30 giorni, poi vengono eliminate. Un’organizzazione contiene al massimo 200 note aperte in tutti i suoi progetti.

agent status e login aggiungono l’avviso notes_waiting quando le note sono nuove o da revisionare. screen show e playlist show aggiungono notes_about_resource quando ci sono note aperte su quello schermo o playlist. Aggiungere una nota aggiunge note.added al registro eventi e risolverne una aggiunge note.resolved; nessuno riporta il testo della nota. Leggere le note non consuma credito.

notes list [--all | --resolved] [--about ID] [--author AGENT_ID] [--limit N] [--after CURSOR]

screenrig notes

notes show <id>

screenrig notes show nte_01EXAMPLENOTE000000000

notes add <text> [--about ID] [--ttl DURATION] [--replaces ID]
notes add --file FILE [--about ID] [--ttl DURATION] [--replaces ID]

screenrig notes add "The lobby screen is mounted in portrait: design for 1080x1920." --about screen:scr_01EXAMPLESCREEN00000000

notes confirm <id>

screenrig notes confirm nte_01EXAMPLENOTE000000000

notes resolve <id> <reason>

screenrig notes resolve nte_01EXAMPLENOTE000000000 "The lobby screen was remounted in landscape."