# gate-lists.txt: extra words for gate.sh, the check that runs before every action.
#
# gate.sh judges a connector or Composio action by the first action word in its name
# (names are split on _ and on capital letters, so GMAIL_FETCH_EMAILS and searchThreads
# both work). A read word first passes, unless a risk word is anywhere in the name.
#
# The built-in lists live in gate.sh and always apply. This file can only ADD words:
#   - under "read:", a word that only ever reads (a built-in risk word is ignored here)
#   - under "risk:", a word that must always stop for a yes, wherever it appears
# One word per line. A line starting with # is a note and is skipped.
#
# Built-in read words: GET LIST SEARCH FETCH READ FIND QUERY COUNT INFO VIEW LOOKUP
#   DESCRIBE CHECK DRAFT RESOLVE RETRIEVE DOWNLOAD SUGGEST EXPORT PREVIEW AUTHENTICATE PARSE
# Built-in risk words, anywhere in a name: SEND DELETE REMOVE REPLACE PAY REFUND TRANSFER
#   CANCEL CAPTURE COMPLETE SUBMIT PUBLISH MARK APPROVE MERGE DROP TRUNCATE PURGE BOOK
#   DISPATCH NOTIFY COMPOSE EXECUTE RUN WRITE UPLOAD MOVE TRASH
# Built-in risk words as the first action word: the above plus REPLY FORWARD POST ARCHIVE
#   CREATE UPDATE EDIT INVITE SHARE CHARGE SCHEDULE ADD UNSUBSCRIBE SUBSCRIBE ENROLL ASSIGN
#   TAG UNTAG CONVERT DUPLICATE IMPORT PROCESS
# Fine print the built-ins already know:
#   - a name with no action word, made only of plural nouns (EVENTS_INSTANCES) or report
#     nouns (PROFIT LOSS BALANCE SHEET REPORT SUMMARY STATEMENT ACCOUNT...), reads
#   - after a read word, SEND_AS is a noun (GMAIL_LIST_SEND_AS reads)
#   - a GraphQL mutation, or SQL writing after a comment or on any line, asks
#   - after a read word, CREATE UPDATE ADD SET INSERT UPSERT EDIT MODIFY ASSIGN CLOSE OPEN
#     anywhere later still asks (FIND_OR_CREATE, SEARCH_AND_UPDATE)
#   - after a read word, REFUND PAY TRANSFER CHARGE PAYMENT are things read (RETRIEVE_REFUND)
#   - CHECK_IN, CHECK_OUT and RESOLVE of a TICKET, CONVERSATION, ISSUE, THREAD or CASE ask
#   - RUN or EXECUTE of a REPORT, QUERY, SOQL, SQL or SEARCH reads, unless the query writes
#   - CREATE or UPDATE of a DRAFT passes only for a message draft (EMAIL, MAIL, MESSAGE,
#     REPLY, POST) or when DRAFT is the last word; SEND_MESSAGE_DRAFT is a draft, SEND_DRAFT sends
#   - a REQUEST, API, PROXY, FETCH or HTTP tool asks when its payload's method is POST, PUT,
#     PATCH or DELETE, and no allow: rule lifts that

read:

risk:
