Logging Events
Current log labels and what each event records.
Suggestions
| Label | Meaning |
|---|---|
SUGGESTION_FETCHED | A suggestion request is about to start. It does not mean the request succeeded. |
SUGGESTION_RECEIVED | A nonempty suggestions array was received and passed validation. |
SUGGESTION_CACHED | Previously fetched suggestions are being reused instead of requesting new ones. |
SUGGESTION_SHOWN | A suggestion was prepared for display. |
SUGGESTION_COMMIT | VS Code confirmed that a suggestion was committed. The label does not identify whether Tab or another control was used. |
SUGGESTION_LINE_REJECT | Clover's reject-suggestion command was invoked. Dismissal with Escape does not produce this event. |
Editing and mouse interaction
| Label | Meaning |
|---|---|
TYPED | A qualifying document edit was observed, such as a character insertion, deletion, auto-pair, or tab-like whitespace. It does not necessarily represent a physical key press. |
MOUSE_CLICKED | A mouse action changed the editor selection to an empty selection, placing the cursor. It does not cover clicks on every VS Code control. |
MOUSE_SELECTED | A mouse action selected text in the editor. |
Keyboard commands
These labels record command handling; they do not necessarily confirm that the requested action succeeded.
| Label | Meaning |
|---|---|
TAB | A tracked Tab command was invoked. For suggestion acceptance through Clover's Tab binding, this event precedes SUGGESTION_COMMIT. |
COPY_SHORTCUT | Copy was requested for the selected text. |
CUT_SHORTCUT | Cut was requested for the selected text. |
PASTE_SHORTCUT | The paste command attempted to insert clipboard text. |
UNDO_SHORTCUT | Undo was invoked and the resulting text difference was recorded. |
REDO_SHORTCUT | Redo was invoked and the resulting text difference was recorded. |
SAVE_SHORTCUT | Save was requested. |
FIND_SHORTCUT | Opening Find was requested. |
REPLACE_SHORTCUT | Opening Find/Replace was requested. |
SELECT_ALL_SHORTCUT | Select All was requested. |
COMMENT_SHORTCUT | Toggle Comment was invoked, either commenting or uncommenting code. |
NEW_FILE_SHORTCUT | Creating a new untitled file was requested. |
Execution
| Label | Meaning |
|---|---|
Terminal.Run | The process captured by Clover's monitored-run command closed. This does not imply successful execution. |
Authentication
| Label | Meaning |
|---|---|
SIGN_IN | Email sign-in completed successfully. |
SIGN_UP | Account creation and sign-in setup completed successfully. |
SIGN_IN_ANONYMOUSLY | Anonymous sign-in or anonymous account creation completed successfully. |
SIGN_IN_GITHUB | GitHub sign-in setup completed successfully. |
SIGN_OUT | Confirmed sign-out completed successfully. |
Diagnostic labels
Severity
| Label | Meaning |
|---|---|
WARNING | A validation issue, missing context, unexpected data, or cancellation was reported. |
ERROR | An operation failed. |
Category
| Label | Meaning |
|---|---|
SUGGESTION | A diagnostic related to suggestions or their interactions. |
AUTH | A diagnostic related to authentication. |
LOG | A diagnostic related to logging or retrieving logs. |
USER | A diagnostic related to user data, state, or progress. |
CLASS | A diagnostic related to class retrieval or selection. |
NETWORK | A diagnostic from HTTP-response or network-exception handling. |
Error code
| Label | Meaning |
|---|---|
SERVER_ERROR | An operation was classified as a server-side failure. |
CLIENT_ERROR | An operation was classified as a client-side failure, including local validation or command errors. |
NETWORK_EXCEPTION | An exception was classified as a network or request failure. |
MISSING_DATA | Required information was absent. |
INVALID_RESPONSE_DATA | Returned or expected data failed validation. |