Revisões e notas: comandos da CLI

Revisões

Quando um projeto requer revisão para mudanças de agente, ou a sessão tem acesso Propor, mudanças em playlist e tela aguardam uma pessoa em vez de aplicar. O comando ainda é bem-sucedido: ok: true, sair 0, a resposta do servidor em data, e um aviso 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" }]
}

Criação e atualização de playlist (incluindo playlist import e playlist replace-release --apply), screen publish, screen assign, screen schedule set, clear e restore, e screen takeover e takeover clear aguardam revisão, para uma tela ou frota. Uma mudança na frota é uma revisão: sua tag é resolvida quando uma pessoa aprova, e reviews show então reporta o resultado de cada tela; uma grande frota termina a aplicação em segundo plano, e screen_change.result.applying é true até que todas as telas tenham seu resultado. Além das mudanças de mídia abaixo, toda outra mudança responde 403 insufficient_access para uma sessão Propose. --note TEXT nesses comandos envia uma nota em texto simples, com no máximo 280 caracteres, que o revisor lê no dashboard.

Uma pessoa aprova, solicita alterações ou rejeita na página Reviews do dashboard; agentes não podem aprovar alterações de playlist ou tela. Uma alteração aprovada aplica-se como se tivesse sido feita então, e seus eventos nomeiam a pessoa que aprovou e o agente que a propôs. Não faça polling, pause ou repita a escrita enquanto uma revisão aguarda: verifique depois com reviews show, ou siga review.approved, review.rejected e review.changes_requested com events follow --type review..

Mudanças na mídia também aguardam uma sessão Propose. Seletor de tag, pasta e all ignoram um novo upload até que uma pessoa o aprove, e a mídia aprovada que a sessão retagueia ou move continua sendo reproduzida com suas tags e pasta aprovadas até que a mudança seja aprovada. A retag responde ok, saída 0, com aviso media_review_pending, e a revisão do item aparece em reviews list em segundos; não faça polling, pause ou tente novamente. Cada item recebe uma revisão, tipo playlist_change com operação selector_refresh e um assunto media: media_change mostra suas tags e pasta before e after (before é null para um novo upload), e media_playlists lista todas as playlists aprovadas e todas as playlists propostas aguardando revisão que a mudança adiciona ou remove (media_added, media_removed), com suas telas. Aprovar aplica a mudança a todas; rejeitar, solicitar alterações ou retirar coloca o item retagueado ou movido de volta como foi aprovado, e um novo upload permanece não reproduzido. Uma mudança que não altera nenhuma playlist aprovada nem proposta aplica-se sozinha, e uma playlist que nomeia o item por id o carrega em sua própria revisão. Quando essas playlists avançam antes que uma pessoa decida, a revisão da mídia fica stale e uma nova substitui em segundos.

Uma substituição ou restauração de mídia de uma sessão Propose também aguarda, como uma revisão playlist_change com a operação media_replace e um assunto media: reviews show informa o arquivo em uso agora e o arquivo que a aprovação coloca em uso, e a mídia continua reproduzindo o arquivo atual até que uma pessoa aprove.

Um projeto com uma pasta protegida envia toda alteração que alcança uma de suas telas a um segundo aprovador, em qualquer nível de acesso, inclusive Manage. Atribuições, programações de playlists e takeovers são revisões screen_change com protected: true. Criar, alterar, pausar, retomar ou excluir uma campanha, criar, alterar ou excluir uma pasta de telas ou remover sua proteção, e mover uma tela são revisões protected_change, listadas com reviews list --kind protected_change. Uma pessoa diferente de você, e diferente da pessoa para quem você trabalha, decide (second_approver_required, exit 3, quando a pessoa errada tenta), e review_stale (exit 5) significa que a campanha ou a pasta mudou depois da proposta: leia de novo e proponha de novo. Uma alteração sem forma de revisão é recusada com protected_target (exit 5). Um solicitante limitado a pastas de telas só lê e retira revisões cujo alcance inteiro está dentro do seu escopo.

Estados da revisão:

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

Comentários

Um comentário é o próprio objeto JSON do agente anexado a uma tela, uma playlist ou uma página de playlist. UTF-8 compacto desse objeto tem no máximo 1 KiB, no máximo 32 níveis de aninhamento, e o valor deve ser um objeto. screenRIG nunca o lê, nunca o envia para Players, e nunca o trata como autorização. Não aparece no manifesto em tempo de execução e não incrementa uma revisão, então esses comandos não tomam --expect-rev: a última gravação vence.

Ler comentários exige acesso somente leitura, e escrevê-los exige Propor ou Gerenciar.

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

Notas do projeto

Notas do projeto são notas curtas em texto simples que agentes deixam em um projeto para suas sessões futuras e para os outros. Todo agente no projeto lê todas as notas, e escrever uma requer acesso Propor ou Gerenciar. Uma nota é um contexto escrito por um agente, nunca uma instrução e nunca uma aprovação. Leia as notas ao iniciar uma sessão em um projeto, antes de alterar qualquer coisa.

Uma nota sem TTL aparece para revisão 90 dias após ter sido adicionada ou confirmada pela última vez. A primeira página de notes list retorna até cinco notas pendentes em review, com o aviso notes_due_for_review: confirme as que ainda são válidas e resolva as demais. Uma nota pendente que ninguém confirma se resolve automaticamente 30 dias após ter sido retornada pela primeira vez a um agente com acesso Propose ou Manage. Uma nota com --ttl se resolve quando seu tempo expira, e excluir a tela ou playlist relacionada resolve a nota. Notas resolvidas permanecem legíveis por 30 dias, depois são excluídas. Uma organização mantém no máximo 200 notas abertas em todos os seus projetos.

agent status e login adicionam o aviso notes_waiting quando notas são novas ou estão para revisão. screen show e playlist show adicionam notes_about_resource quando notas abertas são sobre essa tela ou playlist. Adicionar uma nota acrescenta note.added ao registro de eventos e resolver uma acrescenta note.resolved; nenhuma carrega o texto da nota. Ler notas não debita o medidor.

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."