Skip to content

Commit c75e28a

Browse files
committed
Document production error-only toasts
1 parent d2b266a commit c75e28a

2 files changed

Lines changed: 28 additions & 24 deletions

File tree

‎plugins/screenrig/skills/screenrig/SKILL.md‎

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -627,11 +627,11 @@ The default path is `./<id>.webp`. `--timeout` defaults to 35000 ms and
627627
`--poll-ms` defaults to 500 ms. There is no `--no-wait`. Do not print
628628
pixels.
629629

630-
`screen toast` is the agent mark on a live wall. Use `--level info`. Info
631-
stream toasts are admitted in production. Omitted `--level` defaults to
632-
`info`. `error` and `alert` remain accepted. Do not toast player HTTP errors
633-
or other player-local faults through this command. Player-local faults are a
634-
different path: error always; alert and info only off production.
630+
`screen toast` is the agent mark on a live wall. `--level` is `info`,
631+
`alert`, or `error`. Omitted `--level` defaults to `info`. The CLI accepts
632+
all three. Production glass shows error toasts only; alert and info only off
633+
production. Status chips show in every environment. Do not toast player HTTP
634+
errors or other player-local faults through this command.
635635

636636
`compose catalog` and `compose render` run locally. They do not enroll and
637637
they do not debit. See "Local compose" below.
@@ -1373,8 +1373,10 @@ resolved the release. It does not prove the app rendered.
13731373
release appends `application.published`. An app that calls
13741374
`screenrig.emit(code)` appends its own event, which is the most direct
13751375
evidence that the app ran on a screen.
1376-
- `screen toast <id> --level info --text "..."` is the agent mark on a live
1377-
wall. Use `--level info`. Info stream toasts are admitted in production.
1376+
- `screen toast <id> --level info --text "..."` posts an agent mark. The CLI
1377+
accepts `--level info|alert|error`. Production glass shows error toasts
1378+
only; alert and info only off production. Status chips show in every
1379+
environment.
13781380
- Looking at the screen stays the only proof of layout and rendering. Ask the
13791381
user to confirm what they see.
13801382

@@ -1398,11 +1400,11 @@ resolved the release. It does not prove the app rendered.
13981400
stage-chrome message to a named screen. It is not a placement: it occupies no
13991401
canvas slot, has no layer, and is not part of readiness or crossfade.
14001402

1401-
Use `--level info`. Info stream toasts are admitted in production. Omitted
1402-
`--level` defaults to `info`. `error` and `alert` remain accepted. Do not
1403-
toast player HTTP errors or other player-local faults through this command.
1404-
Player-local faults are a different path: error always; alert and info only
1405-
off production.
1403+
`--level` is `info`, `alert`, or `error`. Omitted `--level` defaults to
1404+
`info`. The CLI accepts all three. Production glass shows error toasts only;
1405+
alert and info only off production. Status chips show in every environment.
1406+
Do not toast player HTTP errors or other player-local faults through this
1407+
command.
14061408

14071409
`--text` is 1 to 120 characters, line feed only, and at most three lines.
14081410
`--duration-ms` is optional and must be between 2000 and 60000 when supplied;

‎skills/screenrig/SKILL.md‎

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -633,11 +633,11 @@ The default path is `./<id>.webp`. `--timeout` defaults to 35000 ms and
633633
`--poll-ms` defaults to 500 ms. There is no `--no-wait`. Do not print
634634
pixels.
635635

636-
`screen toast` is the agent mark on a live wall. Use `--level info`. Info
637-
stream toasts are admitted in production. Omitted `--level` defaults to
638-
`info`. `error` and `alert` remain accepted. Do not toast player HTTP errors
639-
or other player-local faults through this command. Player-local faults are a
640-
different path: error always; alert and info only off production.
636+
`screen toast` is the agent mark on a live wall. `--level` is `info`,
637+
`alert`, or `error`. Omitted `--level` defaults to `info`. The CLI accepts
638+
all three. Production glass shows error toasts only; alert and info only off
639+
production. Status chips show in every environment. Do not toast player HTTP
640+
errors or other player-local faults through this command.
641641

642642
`compose catalog` and `compose render` run locally. They do not enroll and
643643
they do not debit. See "Local compose" below.
@@ -1379,8 +1379,10 @@ resolved the release. It does not prove the app rendered.
13791379
release appends `application.published`. An app that calls
13801380
`screenrig.emit(code)` appends its own event, which is the most direct
13811381
evidence that the app ran on a screen.
1382-
- `screen toast <id> --level info --text "..."` is the agent mark on a live
1383-
wall. Use `--level info`. Info stream toasts are admitted in production.
1382+
- `screen toast <id> --level info --text "..."` posts an agent mark. The CLI
1383+
accepts `--level info|alert|error`. Production glass shows error toasts
1384+
only; alert and info only off production. Status chips show in every
1385+
environment.
13841386
- Looking at the screen stays the only proof of layout and rendering. Ask the
13851387
user to confirm what they see.
13861388

@@ -1404,11 +1406,11 @@ resolved the release. It does not prove the app rendered.
14041406
stage-chrome message to a named screen. It is not a placement: it occupies no
14051407
canvas slot, has no layer, and is not part of readiness or crossfade.
14061408

1407-
Use `--level info`. Info stream toasts are admitted in production. Omitted
1408-
`--level` defaults to `info`. `error` and `alert` remain accepted. Do not
1409-
toast player HTTP errors or other player-local faults through this command.
1410-
Player-local faults are a different path: error always; alert and info only
1411-
off production.
1409+
`--level` is `info`, `alert`, or `error`. Omitted `--level` defaults to
1410+
`info`. The CLI accepts all three. Production glass shows error toasts only;
1411+
alert and info only off production. Status chips show in every environment.
1412+
Do not toast player HTTP errors or other player-local faults through this
1413+
command.
14121414

14131415
`--text` is 1 to 120 characters, line feed only, and at most three lines.
14141416
`--duration-ms` is optional and must be between 2000 and 60000 when supplied;

0 commit comments

Comments
 (0)