Revisiones y notas: comandos CLI

Revisiones

Cuando un proyecto requiere revisión para cambios de agente, o la sesión tiene acceso Proponer, los cambios en listas de reproducción y pantallas esperan a una persona en lugar de aplicarse. El comando aún tiene éxito: ok: true, salir 0, la respuesta del servidor en data, y una advertencia 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" }]
}

Crear y actualizar lista de reproducción (incluyendo playlist import y playlist replace-release --apply), screen publish, screen assign, screen schedule set, clear y restore, y screen takeover y takeover clear esperan revisión, para una pantalla o una flota. Un cambio de flota es una revisión: su etiqueta se resuelve cuando una persona la aprueba, y reviews show luego informa el resultado de cada pantalla; una flota grande termina de aplicarse en segundo plano, y screen_change.result.applying es true hasta que cada pantalla tiene su resultado. Aparte de los cambios de contenido multimedia abajo, cada otro cambio responde 403 insufficient_access para una sesión Propose. --note TEXT en esos comandos envía una nota en texto plano, máximo 280 caracteres, que el revisor lee en el panel.

Una persona aprueba, solicita cambios o rechaza en la página Revisiones del panel; los agentes no pueden aprobar cambios en listas de reproducción o pantallas. Un cambio aprobado se aplica como si se hubiera hecho entonces, y sus eventos nombran a la persona que lo aprobó y al agente que lo propuso. No realice sondeos, pausas ni repita la escritura mientras una revisión espera: verifique más tarde con reviews show, o siga review.approved, review.rejected y review.changes_requested con events follow --type review..

Los cambios en multimedia también esperan una sesión Propose. Los selectores de etiqueta, carpeta y all omiten una nueva carga hasta que una persona la apruebe, y los medios aprobados que la sesión vuelve a etiquetar o mueve siguen reproduciéndose con sus etiquetas y carpeta aprobadas hasta que se apruebe el cambio. La reetiquetación responde ok, salida 0, con advertencia media_review_pending, y la revisión del elemento aparece en reviews list en segundos; no hacer sondeo, dormir ni reintentar. Cada elemento recibe una revisión, tipo playlist_change con operación selector_refresh y un asunto media: media_change muestra sus etiquetas y carpeta before y after (before es null para una nueva carga), y media_playlists lista todas las listas de reproducción aprobadas y todas las propuestas en revisión a las que el cambio lo añade o elimina (media_added, media_removed), con sus pantallas. Aprobar aplica el cambio a todas; rechazar, solicitar cambios o retirar devuelve un elemento reetiquetado o movido a su estado aprobado, y una nueva carga queda sin reproducir. Un cambio que no altera ninguna lista aprobada ni propuesta se aplica solo, y una lista que nombra el elemento por id lo lleva en su propia revisión. Cuando esas listas avanzan antes de que una persona decida, la revisión multimedia pasa a stale y una nueva la reemplaza en segundos.

Un reemplazo o una restauración de medios desde una sesión Propose también espera, como una revisión playlist_change con la operación media_replace y un sujeto media: reviews show informa el archivo actualmente en servicio y el archivo que la aprobación pone en servicio, y el medio sigue reproduciendo su archivo actual hasta que una persona apruebe.

Un proyecto con una carpeta protegida envía cada cambio que alcanza una de sus pantallas a un segundo aprobador, en cualquier nivel de acceso, incluido Manage. Las asignaciones, las programaciones de listas de reproducción y las tomas de control son revisiones screen_change con protected: true. Crear, cambiar, pausar, reanudar o eliminar una campaña, crear, cambiar o eliminar una carpeta de pantallas o quitar su protección, y mover una pantalla son revisiones protected_change, listadas con reviews list --kind protected_change. Decide una persona distinta de usted y distinta de la persona para la que trabaja (second_approver_required, salida 3, cuando lo intenta la persona equivocada), y review_stale (salida 5) significa que la campaña o la carpeta cambió después de la propuesta: léala de nuevo y vuelva a proponerla. Un cambio sin forma de revisión se rechaza con protected_target (salida 5). Un solicitante limitado a carpetas de pantallas solo lee y retira las revisiones cuya extensión completa está dentro de su alcance.

Estados de revisión:

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

Comentarios

Un comentario es el propio objeto JSON del agente adjunto a una pantalla, una lista de reproducción o una página de lista. El UTF-8 compacto de ese objeto es como máximo 1 KiB, tiene como máximo 32 niveles de anidamiento, y el valor debe ser un objeto. screenRIG nunca lo lee, nunca lo envía a los Players, y nunca lo trata como autorización. No aparece en el manifiesto en tiempo de ejecución ni incrementa una revisión, por lo que estos comandos no toman --expect-rev: gana la última escritura.

Leer comentarios requiere acceso de solo lectura, y escribirlos requiere acceso Proponer o de administración.

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 del proyecto

Las notas del proyecto son notas breves de texto plano que los agentes dejan en un proyecto para sus sesiones posteriores y para los demás. Cada agente en el proyecto lee cada nota, y escribir una requiere acceso Proponer o Gestionar. Una nota es contexto escrito por un agente, nunca una instrucción ni una aprobación. Lea las notas cuando inicie una sesión en un proyecto, antes de cambiar algo.

Una nota sin TTL aparece para revisión 90 días después de haber sido añadida o confirmada por última vez. La primera página de notes list devuelve hasta cinco notas pendientes en review, con la advertencia notes_due_for_review: confirme las que aún sean válidas y resuelva el resto. Una nota pendiente que nadie confirma se resuelve sola 30 días después de haber sido devuelta por primera vez a un agente con acceso Propose o Manage. Una nota con --ttl se resuelve cuando su tiempo expira, y eliminar la pantalla o lista de reproducción a la que pertenece la nota resuelve la nota. Las notas resueltas permanecen legibles por 30 días, luego se eliminan. Una organización mantiene como máximo 200 notas abiertas en todos sus proyectos.

agent status y login añaden la advertencia notes_waiting cuando las notas son nuevas o están pendientes de revisión. screen show y playlist show añaden notes_about_resource cuando hay notas abiertas sobre esa pantalla o lista de reproducción. Añadir una nota añade note.added al registro de eventos y resolver una añade note.resolved; ninguna incluye el texto de la nota. Leer notas no descuenta del 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."