Simplify codebase per audit of 48e3457

api/openapi.yaml

@@ -148,7 +148,9 @@ paths:
   /api/me/lead/notes:
     get:
       operationId: listLeadNotes
-      description: What the calling user's lead agent has noted about how they work, oldest first. The lead keeps them with its remember and forget tools.
+      description: >
+        What the calling user's lead agent has noted about how they work, oldest first. The lead keeps them with its remember and forget tools.
+        lead.note_saved (payload: the LeadNote) and lead.note_deleted (payload: its id) events tell the user's clients of changes.
       responses:
         "200":
           description: The notes.
@@ -173,7 +175,7 @@ paths:
       operationId: listSavedCommands
       description: >
         The calling user's saved commands on this server, by name. Each starts a terminal in a task that runs it.
-        command.saved and command.deleted events tell the user's clients of changes.
+        command.saved (payload: the SavedCommand) and command.deleted (payload: its id) events tell the user's clients of changes.
       responses:
         "200":
           description: The saved commands.
@@ -1426,6 +1428,9 @@ paths:
   /api/workflows:
     get:
       operationId: listWorkflows
+      description: >
+        Every saved workflow. workflow.updated (payload: the WorkflowSummary) and workflow.deleted (payload: its name) events
+        tell clients of changes; a rename sends workflow.deleted for the old name, then workflow.updated for the new one.
       responses:
         "200":
           description: Every workflow's name and description, by name.