cmsctl and docs

cmd/cmsctl/README.md

@@ -57,6 +57,23 @@ backoffice proxy. Finder administration always uses `<base-url>/catalog/admin`.
 The CLI intentionally has no separate finder-admin URL: the backoffice is the
 writeradmin boundary.
 
+## Todos and suggestions
+
+List, filter, and complete improvement notes filed via the Suggest button or
+API:
+
+```bash
+cmsctl todos list                              # all todos in triage sort (open first)
+cmsctl todos list --open                       # open / uncompleted only (--done=false)
+cmsctl todos list --done                       # completed only (--done=true)
+cmsctl todos list --prio high --q "checkout"   # filter by priority and search text
+cmsctl todos done NODE_ID                      # mark completed (sets data.done = true)
+cmsctl todos reopen NODE_ID                    # reopen (sets data.done = false)
+cmsctl todos get NODE_ID                       # get todo node
+cmsctl todos create --note "Fix cart layout" --prio high --location "Commerce · Cart"
+cmsctl todos delete NODE_ID --yes
+```
+
 ## CMS
 
 ```bash