@sendbird/cli 0.0.0-stage → 0.4.0

package/references/workflows.json

@@ -0,0 +1,1246 @@
+{
+  "workflows": [
+    {
+      "id": "recover-uncertain-change",
+      "title": "Inspect an uncertain change without repeating it",
+      "description": "Use the original error's recovery.target and recovery.reads. These are read-only examples, not a retry script or a proof of success.",
+      "requires": [
+        "The original environment, profile, app and actor; confirm the profile has not changed environment",
+        "Original request values retained privately for comparison; do not paste secrets into diagnostics"
+      ],
+      "steps": [
+        {
+          "id": "context",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "profile",
+            "list"
+          ],
+          "effect": "local-read",
+          "verify": "Compare the original recovery.target environment/profile with the current configuration before reading."
+        },
+        {
+          "id": "exact-resource",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "user",
+            "get",
+            "--id",
+            "USER_ID",
+            "--json"
+          ],
+          "effect": "read",
+          "verify": "Use the exact command from recovery.reads when supplied. Compare requested fields privately, including false/empty values. A current match does not establish causality."
+        },
+        {
+          "id": "message-without-id",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "list",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--as-user",
+            "USER_ID",
+            "--limit",
+            "100",
+            "--json"
+          ],
+          "effect": "sdk-read",
+          "verify": "Only for a lost send acknowledgement. Check sender/time/content and history cursors. Absence or identical content does not justify sending again."
+        },
+        {
+          "id": "calls-readback",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "calls",
+            "settings",
+            "general",
+            "get",
+            "--json"
+          ],
+          "effect": "read",
+          "verify": "Only for Calls General. Acknowledged writes with unavailable readback remain accepted; use readback.next rather than repeating the update."
+        }
+      ]
+    },
+    {
+      "id": "chat-plan-change",
+      "title": "Prepare a Chat plan change and verify Dashboard results",
+      "description": "CLI reads policy and prepares handoff; the person confirms the final price and effective date in Dashboard. No billing mutation is sent by the CLI.",
+      "requires": [
+        "The intended organization and organization.general.all for check/handoff",
+        "Explicit customer approval before any paid change in Dashboard"
+      ],
+      "steps": [
+        {
+          "id": "check",
+          "argv": [
+            "sendbird",
+            "--org-id",
+            "ORG_UID",
+            "billing",
+            "plan",
+            "check",
+            "--plan",
+            "PLAN_NAME"
+          ],
+          "effect": "read",
+          "verify": "Inspect current/scheduled plans and channel reasons. Candidate is not eligibility or a quote."
+        },
+        {
+          "id": "handoff",
+          "argv": [
+            "sendbird",
+            "--org-id",
+            "ORG_UID",
+            "billing",
+            "plan",
+            "change",
+            "--plan",
+            "PLAN_NAME",
+            "--confirm-org-name",
+            "EXACT_ORG_NAME",
+            "--yes"
+          ],
+          "effect": "read",
+          "verify": "No mutation is sent. The person opens the returned Dashboard URL, checks the organization, final price and effective date and confirms there."
+        },
+        {
+          "id": "verify",
+          "argv": [
+            "sendbird",
+            "--org-id",
+            "ORG_UID",
+            "billing",
+            "plan",
+            "verify",
+            "--plan",
+            "PLAN_NAME"
+          ],
+          "effect": "read",
+          "verify": "Current or scheduled is an observed server state; not_reflected means no matching subscription was found. Do not retry a payment without checking Dashboard."
+        }
+      ]
+    },
+    {
+      "id": "new-account-chat",
+      "title": "Create an account, organization and Chat application",
+      "description": "The CLI runs the entire setup. The person must accept Sendbird terms and obtain the emailed verification link.",
+      "requires": [
+        "A browser where the person can complete Dashboard signup and OAuth approval",
+        "Access to the account's verification email"
+      ],
+      "steps": [
+        {
+          "id": "signup",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "auth",
+            "signup"
+          ],
+          "effect": "remote-mutation",
+          "verify": "The person completes signup and consent in Dashboard. Gate redirects through OAuth to the local CLI callback. Confirm authenticated=true and the expected user; do not retry uncertain signup without checking the account."
+        },
+        {
+          "id": "email",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "auth",
+            "verify-email",
+            "--token-file",
+            "PRIVATE_EMAIL_LINK_FILE"
+          ],
+          "effect": "remote-mutation",
+          "verify": "After the user receives the email, store its link in a private file. Confirm email_verified=true without printing the token."
+        },
+        {
+          "id": "organization",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "org",
+            "create",
+            "--organization-name",
+            "ORG_NAME"
+          ],
+          "effect": "remote-mutation",
+          "verify": "Save result.organizations[0].uid; one account can create only one organization."
+        },
+        {
+          "id": "select-org",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "org",
+            "use",
+            "--id",
+            "ORG_UID"
+          ],
+          "effect": "remote-read",
+          "verify": "The selected organization ID matches the new organization."
+        },
+        {
+          "id": "regions",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "org",
+            "region",
+            "list"
+          ],
+          "effect": "remote-read",
+          "verify": "Choose a region with available=true; this selects location, not an entitlement change."
+        },
+        {
+          "id": "select-region",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "org",
+            "region",
+            "use",
+            "--id",
+            "REGION"
+          ],
+          "effect": "remote-read",
+          "verify": "Read back the selected Chat region before creating the app."
+        },
+        {
+          "id": "application",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "app",
+            "create",
+            "--app-name",
+            "APP_NAME"
+          ],
+          "effect": "remote-mutation",
+          "verify": "Save result.application.app_id and re-read app detail."
+        },
+        {
+          "id": "select-app",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "app",
+            "use",
+            "--id",
+            "APP_ID"
+          ],
+          "effect": "remote-read",
+          "verify": "Confirm the selected app belongs to the selected organization."
+        }
+      ]
+    },
+    {
+      "id": "staging-sdk",
+      "title": "Connect an existing Chat user in staging",
+      "description": "Connect with automatic standard/Delight region discovery without copying Dashboard credentials into the SDK.",
+      "requires": [
+        "A selected staging profile and app",
+        "A Chat user ID and CLI OAuth permission to manage users"
+      ],
+      "steps": [
+        {
+          "id": "profile",
+          "argv": [
+            "sendbird",
+            "profile",
+            "list"
+          ],
+          "effect": "local-read",
+          "verify": "Choose the intended profile; do not silently switch to production."
+        },
+        {
+          "id": "connect",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "status",
+            "--as-user",
+            "USER_ID"
+          ],
+          "effect": "sdk-connect",
+          "verify": "The CLI discovers the selected app's region route. Confirm connected=true and matching user.user_id; this does not prove channel access or delivery."
+        },
+        {
+          "id": "config",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "app",
+            "sdk-config",
+            "--raw"
+          ],
+          "effect": "remote-read",
+          "when": "Only if an explicit reusable endpoint file is wanted",
+          "save_stdout_to": "SDK_CONFIG_FILE",
+          "verify": "app_id and environment must match the target. Region family is derived from is_delight_region."
+        }
+      ]
+    },
+    {
+      "id": "first-message",
+      "title": "Send and verify a channel message",
+      "description": "Use an existing authorized channel. Watch readiness, acknowledgement and receipt are separate checkpoints.",
+      "requires": [
+        "Target profile/app/channel type/channel URL",
+        "Sender Chat user ID with an existing access token readable through CLI OAuth for the selected environment, or an explicit private token file",
+        "Receiver Chat user identity and SDK authentication only when verifying recipient delivery",
+        "CLI OAuth for automatic region discovery in the selected environment, or an explicit SDK endpoint override"
+      ],
+      "sdk_context": {
+        "when_profile_environment": "staging; production when using CLI OAuth",
+        "automatic": "Discover the selected app's SDK hosts on actual execution",
+        "optional_overrides": [
+          "--sdk-config-file SDK_CONFIG_FILE",
+          "--sdk-api-host HTTPS_ORIGIN --sdk-ws-host WSS_ORIGIN"
+        ],
+        "production": "CLI OAuth discovers app hosts automatically. Explicit token-file/guest keeps ordinary SDK routing unless an endpoint override is provided."
+      },
+      "steps": [
+        {
+          "id": "inspect",
+          "argv": [
+            "sendbird",
+            "describe",
+            "chat",
+            "message",
+            "send"
+          ],
+          "effect": "offline",
+          "verify": "Check required flags and channel-specific constraints."
+        },
+        {
+          "id": "watch",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "channel",
+            "watch",
+            "--type",
+            "CHANNEL_TYPE",
+            "--id",
+            "CHANNEL_URL",
+            "--as-user",
+            "RECEIVER_ID",
+            "--seconds",
+            "60"
+          ],
+          "effect": "sdk-connect/stream",
+          "when": "Only when recipient delivery is requested and receiver identity is provided",
+          "terminal": "B",
+          "verify": "Keep this process running; wait for event=ready before sending."
+        },
+        {
+          "id": "preview",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "send",
+            "--type",
+            "CHANNEL_TYPE",
+            "--id",
+            "CHANNEL_URL",
+            "--as-user",
+            "SENDER_ID",
+            "--message",
+            "MESSAGE",
+            "--dry-run"
+          ],
+          "effect": "offline",
+          "terminal": "A",
+          "verify": "Confirm the resolved channel/user/body is within the requested task."
+        },
+        {
+          "id": "send",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "send",
+            "--type",
+            "CHANNEL_TYPE",
+            "--id",
+            "CHANNEL_URL",
+            "--as-user",
+            "SENDER_ID",
+            "--message",
+            "MESSAGE"
+          ],
+          "effect": "mutation",
+          "terminal": "A",
+          "capture": {
+            "MESSAGE_ID": "result.message_id"
+          },
+          "verify": "Success callback means acknowledged. For delivery, match MESSAGE_ID with receiver message_received.data.message_id."
+        },
+        {
+          "id": "readback",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "get",
+            "--type",
+            "CHANNEL_TYPE",
+            "--id",
+            "CHANNEL_URL",
+            "--message-id",
+            "MESSAGE_ID",
+            "--as-user",
+            "SENDER_ID"
+          ],
+          "effect": "sdk-read",
+          "verify": "Compare ID and message text. Stop after an uncertain send; never resend blindly."
+        }
+      ]
+    },
+    {
+      "id": "prepare-chat",
+      "title": "Prepare Dashboard resources for a two-user chat",
+      "description": "Reuse existing resources when available; create only those the user requested.",
+      "requires": [
+        "Intended profile/environment",
+        "An authorized organization/app or permission to create them"
+      ],
+      "steps": [
+        {
+          "id": "profiles",
+          "argv": [
+            "sendbird",
+            "profile",
+            "list"
+          ],
+          "effect": "local-read",
+          "verify": "Select a profile rather than guessing the environment."
+        },
+        {
+          "id": "auth",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "auth",
+            "status",
+            "--summary"
+          ],
+          "effect": "remote-read",
+          "verify": "Verify the Dashboard account, organization and role. On E_AUTH, use auth login in a human terminal."
+        },
+        {
+          "id": "orgs",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "org",
+            "list"
+          ],
+          "effect": "remote-read",
+          "verify": "Resolve the intended organization; ask only if multiple targets remain plausible."
+        },
+        {
+          "id": "create-org",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "org",
+            "create",
+            "--organization-name",
+            "ORG_NAME"
+          ],
+          "effect": "mutation",
+          "when": "Only when no suitable organization exists and creation is requested",
+          "capture": {
+            "ORG_UID": "result.organizations[0].uid"
+          },
+          "verify": "Use the actual returned organization UID, not its display name."
+        },
+        {
+          "id": "apps",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "app",
+            "list",
+            "--limit",
+            "20"
+          ],
+          "effect": "remote-read",
+          "verify": "Choose the target app and retain its app_id; follow pagination if necessary."
+        },
+        {
+          "id": "create-app",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--org-id",
+            "ORG_UID",
+            "app",
+            "create",
+            "--app-name",
+            "APP_NAME",
+            "--region",
+            "REGION"
+          ],
+          "effect": "mutation",
+          "when": "Only when no suitable app exists and creation is requested; use a region available to that organization",
+          "capture": {
+            "APP_ID": "result.application.app_id"
+          },
+          "verify": "Retain the returned app ID for all later commands."
+        },
+        {
+          "id": "alice",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "user",
+            "create",
+            "--user-id",
+            "ALICE_ID",
+            "--nickname",
+            "Alice",
+            "--issue-access-token",
+            "true",
+            "--secret-output",
+            "ALICE_TOKEN_FILE"
+          ],
+          "effect": "mutation",
+          "when": "Only when this new test user is needed and authorized",
+          "verify": "New private token file outside Git or ignored and untracked; never read its contents into the conversation."
+        },
+        {
+          "id": "bob",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "user",
+            "create",
+            "--user-id",
+            "BOB_ID",
+            "--nickname",
+            "Bob",
+            "--issue-access-token",
+            "true",
+            "--secret-output",
+            "BOB_TOKEN_FILE"
+          ],
+          "effect": "mutation",
+          "when": "Only when this new test user is needed and authorized",
+          "verify": "User ID matches the second test user; token file is outside Git or ignored and untracked."
+        },
+        {
+          "id": "channel",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "PROFILE",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "channel",
+            "create",
+            "--type",
+            "group",
+            "--user-ids",
+            "[\"ALICE_ID\",\"BOB_ID\"]",
+            "--name",
+            "Demo",
+            "--is-distinct",
+            "true"
+          ],
+          "effect": "mutation",
+          "when": "Only when a new/reused distinct channel is requested",
+          "capture": {
+            "CHANNEL_URL": "result.channel_url"
+          },
+          "verify": "Use the actual returned URL. If a member is invited rather than joined, accept only that pending invitation."
+        }
+      ]
+    },
+    {
+      "id": "pro-chat",
+      "title": "Search, mention, translate and run a Poll in an existing Pro group",
+      "description": "Use authorized existing Chat users and a joined group. Read feature evidence, verify exact results, and keep app/device evidence separate.",
+      "requires": [
+        "An authenticated staging profile and a verified Pro-capable org/app; activation snapshots alone do not prove runtime support",
+        "Two authorized Chat users alice/bob who are already joined to GROUP_URL",
+        "Authorization for the specific test messages/Poll; no organization creation, billing, guest fallback or policy change"
+      ],
+      "steps": [
+        {
+          "id": "diagnose",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "doctor",
+            "--command",
+            "chat message search",
+            "--as-user",
+            "alice"
+          ],
+          "effect": "read",
+          "verify": "Read entitlement/activation/role evidence separately. Unknown is not denied or success."
+        },
+        {
+          "id": "mention",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "send",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "alice",
+            "--message",
+            "Bob, weekend plans?",
+            "--mention-type",
+            "users",
+            "--mentioned-user-ids",
+            "bob",
+            "--translation-target-languages",
+            "fr,en"
+          ],
+          "effect": "mutation",
+          "verify": "Read back this message ID and actual mentioned_user_ids; inspect translations without discarding the original.",
+          "when": "Only when this single test message is authorized",
+          "capture": {
+            "MESSAGE_ID": "result.message_id"
+          }
+        },
+        {
+          "id": "search",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "search",
+            "--as-user",
+            "alice",
+            "--channel-url",
+            "GROUP_URL",
+            "--keyword",
+            "weekend",
+            "--limit",
+            "20"
+          ],
+          "effect": "sdk-read",
+          "verify": "Match MESSAGE_ID. Index delay can omit it; follow bounded pages without sending another message."
+        },
+        {
+          "id": "prepare-poll",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "poll",
+            "create",
+            "--as-user",
+            "alice",
+            "--title",
+            "Weekend activity",
+            "--options",
+            "Hiking,Cinema",
+            "--allow-multiple-votes",
+            "false"
+          ],
+          "effect": "mutation",
+          "verify": "Retain the actual poll_id. message_id=0 means unattached; a lost response must not trigger another create.",
+          "when": "Only when one new test Poll is requested",
+          "capture": {
+            "POLL_ID": "result.poll_id"
+          }
+        },
+        {
+          "id": "attach-poll",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "send",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "alice",
+            "--message",
+            "Choose one activity",
+            "--poll-id",
+            "POLL_ID"
+          ],
+          "effect": "mutation",
+          "verify": "Compare the returned Poll/message association and retain the acknowledged message ID.",
+          "when": "Only for the Poll created in the previous step",
+          "capture": {
+            "POLL_MESSAGE_ID": "result.message_id"
+          }
+        },
+        {
+          "id": "read-poll",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "poll",
+            "get",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "bob",
+            "--poll-id",
+            "POLL_ID"
+          ],
+          "effect": "sdk-read",
+          "verify": "Verify poll_id, message_id and returned option IDs; never guess OPTION_ID.",
+          "capture": {
+            "OPTION_ID": "result.options.0.option_id"
+          }
+        },
+        {
+          "id": "vote",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "poll",
+            "vote",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "bob",
+            "--poll-id",
+            "POLL_ID",
+            "--option-ids",
+            "OPTION_ID"
+          ],
+          "effect": "mutation",
+          "verify": "Re-read the Poll as the same voter and inspect actual option/voter state.",
+          "when": "Only when this vote by bob is authorized"
+        },
+        {
+          "id": "read-vote",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "poll",
+            "get",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "bob",
+            "--poll-id",
+            "POLL_ID"
+          ],
+          "effect": "sdk-read",
+          "verify": "Compare voted_option_ids and counts. This is not a customer-app rendering or notification test."
+        },
+        {
+          "id": "close",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "poll",
+            "close",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "alice",
+            "--poll-id",
+            "POLL_ID",
+            "--yes"
+          ],
+          "effect": "mutation",
+          "verify": "Re-read status=closed; never repeat on timeout.",
+          "when": "Only when closure of this test Poll is requested"
+        },
+        {
+          "id": "clean-poll",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "poll",
+            "delete",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "alice",
+            "--poll-id",
+            "POLL_ID",
+            "--yes"
+          ],
+          "effect": "mutation",
+          "verify": "Clean only the captured Poll after UI verification and explicit cleanup authorization.",
+          "when": "Only for this created Poll when cleanup is authorized"
+        },
+        {
+          "id": "clean-message",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--org-id",
+            "ORG_UID",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "delete",
+            "--type",
+            "group",
+            "--id",
+            "GROUP_URL",
+            "--as-user",
+            "alice",
+            "--message-id",
+            "POLL_MESSAGE_ID",
+            "--yes"
+          ],
+          "effect": "mutation",
+          "verify": "Clean only the captured test message. Do not remove existing group/users or unrelated messages.",
+          "when": "Only for this created message when cleanup is authorized"
+        }
+      ]
+    },
+    {
+      "id": "temporary-mute-check",
+      "title": "Temporarily mute a member (or freeze a channel), confirm the restriction, restore, and confirm sending works again",
+      "description": "Six separate steps with readback after every change. A restored flag alone does not prove that sending works again; the final member send is part of the check. For a channel freeze use chat moderation channel freeze/unfreeze with the same sequence.",
+      "requires": [
+        "Authorized target channel, operator, ordinary member and a disposable probe message; agreed cleanup scope",
+        "Capture the original mute/freeze state first and never silently keep a restriction that already existed"
+      ],
+      "steps": [
+        {
+          "id": "baseline",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "moderation",
+            "channel",
+            "muted",
+            "get",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--user-id",
+            "MEMBER_ID",
+            "--json"
+          ],
+          "effect": "read",
+          "verify": "Record is_muted and remaining_duration before changing anything. Stop if the member is already muted and the task did not authorize touching that state."
+        },
+        {
+          "id": "restrict",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "moderation",
+            "channel",
+            "mute",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--user-id",
+            "MEMBER_ID",
+            "--seconds",
+            "600",
+            "--yes",
+            "--json"
+          ],
+          "effect": "mutation",
+          "verify": "Read back with chat moderation channel muted get: is_muted must be true. Keep the restriction short-lived."
+        },
+        {
+          "id": "blocked-send",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "send",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--as-user",
+            "MEMBER_ID",
+            "--message",
+            "mute probe",
+            "--json"
+          ],
+          "effect": "mutation",
+          "verify": "Expect a server rejection (E_PERMISSION or a moderation error) and distinguish it from a timeout. Confirm absence with chat message list as another member."
+        },
+        {
+          "id": "restore",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "moderation",
+            "channel",
+            "unmute",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--user-id",
+            "MEMBER_ID",
+            "--yes",
+            "--json"
+          ],
+          "effect": "mutation",
+          "verify": "Read back with chat moderation channel muted get: is_muted must match the captured baseline. Restore even if the probe failed."
+        },
+        {
+          "id": "recovery-send",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "send",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--as-user",
+            "MEMBER_ID",
+            "--message",
+            "mute recovery probe",
+            "--json"
+          ],
+          "effect": "mutation",
+          "verify": "A message_id must be returned and the message must appear in chat message list as another member. Without this step the restoration is unverified."
+        },
+        {
+          "id": "report",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "auth",
+            "status",
+            "--summary"
+          ],
+          "effect": "read",
+          "verify": "Report restriction enforcement, setting restoration, normal-send recovery and probe cleanup as four separate results."
+        }
+      ]
+    },
+    {
+      "id": "reply-and-verify-thread",
+      "title": "Post a reply as a user and confirm it belongs to the intended thread",
+      "description": "The request names the actor, the parent message and the reply text: create the reply now, then prove its parent. Do not search for an existing reply or ask for an ID the person already gave.",
+      "requires": [
+        "Target app, channel URL, parent message ID, acting user and the reply text"
+      ],
+      "steps": [
+        {
+          "id": "parent",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "get",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--message-id",
+            "PARENT_MESSAGE_ID",
+            "--as-user",
+            "USER_ID",
+            "--json"
+          ],
+          "effect": "sdk-read",
+          "verify": "The parent exists in this channel before replying."
+        },
+        {
+          "id": "reply",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "reply",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--message-id",
+            "PARENT_MESSAGE_ID",
+            "--as-user",
+            "USER_ID",
+            "--message",
+            "REPLY_TEXT",
+            "--json"
+          ],
+          "effect": "mutation",
+          "verify": "Record the returned message_id and parent_message_id; parent_message_id must equal PARENT_MESSAGE_ID."
+        },
+        {
+          "id": "thread",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "thread",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--message-id",
+            "PARENT_MESSAGE_ID",
+            "--as-user",
+            "USER_ID",
+            "--json"
+          ],
+          "effect": "sdk-read",
+          "verify": "The new reply is listed under the parent with the acting user as sender. Report the reply ID and its parent together."
+        }
+      ]
+    },
+    {
+      "id": "staging-client-hosts",
+      "title": "Wire a customer app to a staging app with the discovered SDK hosts and verify delivery from the server side",
+      "description": "Staging apps are not reachable through default SDK hosts. Read the app's api_host/ws_host, pass them to SendbirdChat.init as customApiHost/customWebSocketHost, then prove delivery with a CLI readback. A local sent state or a successful build is not delivery.",
+      "requires": [
+        "Selected staging app and an authorized test user; no management token in client code"
+      ],
+      "steps": [
+        {
+          "id": "hosts",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "app",
+            "sdk-config",
+            "--raw"
+          ],
+          "effect": "read",
+          "verify": "Use api_host and ws_host exactly as returned (customApiHost, customWebSocketHost) together with the same app_id in the client init."
+        },
+        {
+          "id": "route",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "sdk",
+            "status",
+            "--as-user",
+            "TEST_USER_ID",
+            "--json"
+          ],
+          "effect": "sdk-connect",
+          "verify": "The CLI connects through the same hosts; a failure here is an app, token or policy problem, not a client-code problem."
+        },
+        {
+          "id": "readback",
+          "argv": [
+            "sendbird",
+            "--profile",
+            "staging",
+            "--app-id",
+            "APP_ID",
+            "chat",
+            "message",
+            "list",
+            "--type",
+            "group",
+            "--id",
+            "CHANNEL_URL",
+            "--as-user",
+            "PEER_USER_ID",
+            "--limit",
+            "20",
+            "--json"
+          ],
+          "effect": "sdk-read",
+          "verify": "After sending from the customer UI, the message must appear here with a message_id. Report UI acknowledgement and server readback separately."
+        }
+      ]
+    }
+  ]
+}