レビューとノート CLI コマンド

レビュー

プロジェクトがエージェント変更のレビューを必要とするか、セッションにProposeアクセスがある場合、プレイリストとスクリーンの変更は適用されず人の承認を待ちます。コマンドは成功します：ok: true、終了0、サーバーの応答data、および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" }]
}

プレイリストの作成と更新（playlist import と playlist replace-release --apply を含む）、screen publish、screen assign、screen schedule set、clear、restore、および screen takeover と takeover clear はレビュー待ちで、1台のスクリーンまたはフリート用です。フリートの変更は1つのレビューです：タグは承認者が承認すると解決され、reviews show は各スクリーンの結果を報告します。大規模フリートはバックグラウンドで適用を完了し、screen_change.result.applying はすべてのスクリーンが結果を得るまで true です。以下のメディア変更を除き、他のすべての変更は Propose セッションの 403 insufficient_access に応答します。これらのコマンドでの --note TEXT は、ダッシュボードでレビュアーが読む最大280文字のプレーンテキストのメモを送信します。

人物はダッシュボードのレビュー画面で承認、変更要求、拒否を行います。エージェントはプレイリストやスクリーンの変更を承認できません。承認された変更はその時点で適用され、イベントは承認者と提案したエージェントを記録します。レビュー待ちの間はポーリングやスリープ、書き込みの繰り返しを行わず、後で reviews show で確認するか、review.approved、review.rejected、review.changes_requested と events follow --type review. を参照してください。

メディアの変更もProposeセッションの待機中です。タグ、フォルダー、allセレクターは、人が承認するまで新しいアップロードをスキップし、承認済みメディアがセッションで再タグ付けまたは移動されると、変更が承認されるまで承認済みのタグとフォルダーで再生を続けます。再タグ付けはokに0で応答し、警告media_review_pendingを表示し、アイテムのレビューは数秒以内にreviews listに表示されます。ポーリング、スリープ、再試行は不要です。各アイテムは1つのレビューを持ち、種類playlist_change、操作selector_refresh、件名mediaを持ちます。media_changeはタグとフォルダーbefore、after（新規アップロードはbeforeがnull）を表示し、media_playlistsは変更が追加または削除するすべての承認済みおよび提案中のプレイリストをスクリーン付きでリストします（media_added、media_removed）。承認はすべてに適用し、拒否、変更要求、撤回は再タグ付けまたは移動されたアイテムを承認済みに戻し、新規アップロードは再生されません。承認済みプレイリストや提案に影響しない変更は自動適用され、IDでアイテムを指定するプレイリストは独自のレビューを持ちます。プレイリストが決定前に進むと、レビューはstaleになり、数秒で新しいレビューに置き換わります。

Proposeセッションからのメディアの置き換えや復元も待機します。操作がmedia_replaceで対象がmediaのplaylist_changeレビューとなり、reviews showには現在使用中のファイルと、承認で使用されるファイルが示されます。人が承認するまで、メディアは現在のファイルを再生し続けます。

保護されたフォルダーがあるプロジェクトでは、そのスクリーンに及ぶすべての変更が、Manage を含むどのアクセスレベルでも、2人目の承認者に送られます。割り当て、プレイリストのスケジュール、テイクオーバーはprotected: trueの付いたscreen_changeレビューです。キャンペーンの作成・変更・一時停止・再開・削除、スクリーンフォルダーの作成・変更・削除・保護の解除、スクリーンの移動はprotected_changeレビューで、reviews list --kind protected_changeで一覧表示できます。決定するのは、あなたとも、あなたが仕えている人とも別の人です（別の人が試みるとsecond_approver_required、終了コード3）。review_stale（終了コード5）は、提案後にキャンペーンまたはフォルダーが変更されたことを意味します。読み直して、もう一度提案してください。レビューの形がない変更はprotected_target（終了コード5）で拒否されます。スクリーンフォルダーに限定された呼び出し元は、影響範囲全体がスコープ内にあるレビューだけを読み取り、取り下げられます。

レビュー状態：

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

コメント

コメントはスクリーン、プレイリスト、またはプレイリストページに添付されたエージェント自身の JSON オブジェクトです。そのオブジェクトのコンパクトな UTF-8 は最大1KiBで、ネストは最大32階層まで、値はオブジェクトでなければなりません。screenRIG はこれを読み取らず、プレーヤーに送信せず、認可として扱いません。ランタイムマニフェストに現れずリビジョンも上げないため、これらのコマンドは --expect-rev を取りません：最後の書き込みが勝ちます。

コメントの読み取りには読み取り専用アクセス、書き込みにはProposeまたはManageが必要です。

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

プロジェクトノート

プロジェクトノートは、エージェントが後のセッションや他のエージェントのためにプロジェクトに残す短いプレーンテキストのメモです。プロジェクト内のすべてのエージェントがすべてのノートを読み、ノートを書くにはProposeまたはManageのアクセス権が必要です。ノートはエージェントによる文脈の記述であり、指示や承認ではありません。セッション開始時にノートを読み、変更前に確認してください。

TTLなしのメモは、追加または最後に確認されてから90日後にレビュー対象になります。notes list の最初のページは、review に最大5件の期限切れメモを返し、notes_due_for_review の警告を表示します：まだ有効なものを確認し、残りは解決してください。誰も確認しない期限切れメモは、Propose または Manage アクセス権を持つエージェントに最初に返されてから30日後に自動解決されます。--ttl のあるメモは期限切れで自動解決され、メモ対象のスクリーンまたはプレイリストを削除するとメモも解決されます。解決済みメモは30日間閲覧可能で、その後削除されます。組織は、すべてのプロジェクトを合わせて最大200件の未解決メモを保持します。

agent status と login は、メモが新規またはレビュー対象の場合に警告 notes_waiting を追加します。screen show と playlist show は、そのスクリーンまたはプレイリストに関する未解決メモがある場合に notes_about_resource を追加します。メモを追加するとイベントログに note.added が記録され、解決すると note.resolved が記録されます。どちらもメモ本文は含みません。メモの閲覧ではメーターは減りません。

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