Saphan StudioDocs
Reference/Commands

saphan say

Composes one validated statement for the owner — an alert, an open item, or an explicit 'nothing to report' — in the owner-block format that a run's status channel carries; nothing is recorded in the

Composes one validated statement for the owner — an alert, an open item, or an explicit "nothing to report" — in the owner-block format that a run's status channel carries; nothing is recorded in the store. Without --channel the block is printed; with it, the block is appended to an existing channel file and checked again after writing, and the append is undone if the file no longer reads back as exactly one more statement. Every field is plain text; a field that would break the block's structure is refused as owner-block-say-field-opens-envelope. saphan grammar owner-block prints the full vocabulary.

saphan say <stream>
flagtypedefaultwhat it does
--abstractstringThe summary that is always shown, at most five lines.
--afterstringWhat happens next after this statement.
--bodystringA reference to longer context; never paste secret content here.
--channelstringAppend the block to this existing file instead of printing it; the path is not checked to be the stream's channel, and nothing is left written if the block is refused.
--idstringAn optional stable identifier for the statement.
--kindstringWhat the statement is: alert, open or none.

Global options apply to every command — see Every command.