@bussolabs/closeyourit-cli 0.0.15 → 0.0.17

package/opencli.json

@@ -3,7 +3,7 @@
   "opencli": "0.1",
   "info": {
     "title": "closeyourit",
-    "version": "0.0.13",
+    "version": "0.0.17",
     "summary": "CLI for CloseYourIt",
     "description": "Manage organization, projects, error monitoring, ingest tokens, tickets and performance metrics with your CloseYourIt user token.",
     "license": {
@@ -122,6 +122,319 @@
           "examples": [
             "closeyourit projects show acme-api"
           ]
+        },
+        {
+          "name": "create",
+          "description": "Create a project (optionally inside a group).",
+          "arguments": [
+            {
+              "name": "NAME",
+              "required": true,
+              "description": "Project name."
+            }
+          ],
+          "options": [
+            {
+              "name": "--key",
+              "aliases": [
+                "-k"
+              ],
+              "required": true,
+              "description": "Project key (uppercase A-Z0-9, max 4 chars, unique per org).",
+              "arguments": [
+                {
+                  "name": "KEY",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--group",
+              "aliases": [
+                "-g"
+              ],
+              "description": "Group id (UUID) or name to place the project in.",
+              "arguments": [
+                {
+                  "name": "GROUP"
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--description",
+              "description": "Free-form description.",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            },
+            {
+              "name": "--roadmap-enabled",
+              "description": "Enable the roadmap (feature/improvement tickets + milestones) for this project."
+            },
+            {
+              "name": "--quick-bug-report-enabled",
+              "description": "Enable the AI-assisted quick bug report on this project."
+            }
+          ],
+          "examples": [
+            "closeyourit projects create driverone-rails --key DRRA",
+            "closeyourit projects create driverone-rails --group DriverOne --key DRRA",
+            "closeyourit projects create driverone-flutter -g <group-uuid> -k DRFL",
+            "closeyourit projects create acme-api -k ACME --roadmap-enabled --quick-bug-report-enabled"
+          ]
+        },
+        {
+          "name": "update",
+          "description": "Update a project (name, key, color, description, group, feature flags).",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--name",
+              "description": "New project name.",
+              "arguments": [
+                {
+                  "name": "NAME"
+                }
+              ]
+            },
+            {
+              "name": "--key",
+              "description": "New project key (uppercase A-Z0-9).",
+              "arguments": [
+                {
+                  "name": "KEY"
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--description",
+              "description": "Free-form description.",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            },
+            {
+              "name": "--group",
+              "description": "Group id (UUID) or name to move the project into.",
+              "arguments": [
+                {
+                  "name": "GROUP"
+                }
+              ]
+            },
+            {
+              "name": "--roadmap-enabled",
+              "description": "Enable/disable the roadmap (feature/improvement tickets + milestones) for this project."
+            },
+            {
+              "name": "--quick-bug-report-enabled",
+              "description": "Enable/disable the AI-assisted quick bug report on this project."
+            }
+          ],
+          "examples": [
+            "closeyourit projects update --project LBRA --name \"New name\"",
+            "closeyourit projects update -p LBRA --group Backend",
+            "closeyourit projects update -p LBRA --roadmap-enabled --no-quick-bug-report-enabled"
+          ]
+        },
+        {
+          "name": "link-server",
+          "description": "Link a server host to one of the project declared environments (uptime monitoring).",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--host-id",
+              "required": true,
+              "description": "Server host id (UUID, org-scoped and active).",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--environment-id",
+              "required": true,
+              "description": "Environment id (UUID) among those declared by the project.",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit projects link-server --project LBRA --host-id <host-uuid> --environment-id <env-uuid>"
+          ]
+        },
+        {
+          "name": "unlink-server",
+          "description": "Unlink a server host from the project (removes the host-environment link).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Server link id (from projects link-server / project servers list)."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible unlink."
+            }
+          ],
+          "examples": [
+            "closeyourit projects unlink-server <link-id> --project LBRA --confirm"
+          ]
+        },
+        {
+          "name": "settings",
+          "description": "Project settings (log/analytics retention + feature flags).",
+          "commands": [
+            {
+              "name": "show",
+              "description": "Show a project settings (log/analytics retention + feature flags).",
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit projects settings show --project legalbloom-rails",
+                "closeyourit projects settings show -p LBRA"
+              ]
+            },
+            {
+              "name": "update",
+              "description": "Update a project settings (log/analytics retention + feature flags); only the passed fields change.",
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--logs-retention-days",
+                  "description": "Log retention in days (blank inherits the org/global default).",
+                  "arguments": [
+                    {
+                      "name": "N"
+                    }
+                  ]
+                },
+                {
+                  "name": "--analytics-retention-days",
+                  "description": "Analytics retention in days (blank inherits the org/global default).",
+                  "arguments": [
+                    {
+                      "name": "N"
+                    }
+                  ]
+                },
+                {
+                  "name": "--roadmap-enabled",
+                  "description": "Enable/disable the project roadmap."
+                },
+                {
+                  "name": "--quick-bug-report-enabled",
+                  "description": "Enable/disable the AI-assisted quick bug report."
+                },
+                {
+                  "name": "--analytics-enabled",
+                  "description": "Enable/disable web analytics ingestion."
+                }
+              ],
+              "examples": [
+                "closeyourit projects settings update --project LBRA --logs-retention-days 30",
+                "closeyourit projects settings update -p LBRA --analytics-retention-days 365 --analytics-enabled",
+                "closeyourit projects settings update -p LBRA --roadmap-enabled --no-quick-bug-report-enabled"
+              ]
+            }
+          ]
         }
       ]
     },
@@ -746,16 +1059,17 @@
               ]
             }
           ]
-        }
-      ]
-    },
-    {
-      "name": "ideas",
-      "description": "Project ideas: propose, vote, comment, convert to ticket (AI-synthesized draft).",
-      "commands": [
+        },
         {
-          "name": "list",
-          "description": "List ideas for a project (sorted by votes).",
+          "name": "links",
+          "description": "List the ticket-to-ticket links involving a ticket (duplicate/related).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Ticket id or code (e.g. DRFL-3)."
+            }
+          ],
           "options": [
             {
               "name": "--project",
@@ -770,43 +1084,26 @@
                   "required": true
                 }
               ]
-            },
-            {
-              "name": "--page",
-              "description": "Page number.",
-              "arguments": [
-                {
-                  "name": "N"
-                }
-              ]
-            },
-            {
-              "name": "--status",
-              "description": "Filter by status (open|converted|archived).",
-              "arguments": [
-                {
-                  "name": "STATUS"
-                }
-              ]
-            },
-            {
-              "name": "--sort",
-              "description": "Sort order (votes|recent).",
-              "arguments": [
-                {
-                  "name": "SORT"
-                }
-              ]
             }
+          ],
+          "examples": [
+            "closeyourit tickets links <ticket-id> --project acme-api",
+            "closeyourit tickets links <ticket-id> -p acme-api --json"
           ]
         },
         {
-          "name": "show",
-          "description": "Show an idea (fields + full proposal body).",
+          "name": "unlink",
+          "description": "Remove a ticket-to-ticket link (irreversible; requires tickets.edit).",
           "arguments": [
             {
-              "name": "IDEA_ID",
-              "required": true
+              "name": "ID",
+              "required": true,
+              "description": "Ticket id or code (e.g. DRFL-3)."
+            },
+            {
+              "name": "LINK_ID",
+              "required": true,
+              "description": "Link id to remove."
             }
           ],
           "options": [
@@ -823,12 +1120,26 @@
                   "required": true
                 }
               ]
+            },
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible removal."
             }
+          ],
+          "examples": [
+            "closeyourit tickets unlink <ticket-id> <link-id> --project acme-api --confirm"
           ]
         },
         {
-          "name": "create",
-          "description": "Propose an idea for a project.",
+          "name": "reviewer",
+          "description": "Set the reviewer of a ticket (requires tickets.assign).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Ticket id or code (e.g. DRFL-3)."
+            }
+          ],
           "options": [
             {
               "name": "--project",
@@ -845,36 +1156,59 @@
               ]
             },
             {
-              "name": "--title",
+              "name": "--reviewer-id",
               "required": true,
-              "description": "Idea title.",
+              "description": "Account id to set as reviewer.",
               "arguments": [
                 {
-                  "name": "TITLE",
+                  "name": "ID",
                   "required": true
                 }
               ]
-            },
+            }
+          ],
+          "examples": [
+            "closeyourit tickets reviewer <ticket-id> --project acme-api --reviewer-id <account-id>"
+          ]
+        },
+        {
+          "name": "unreviewer",
+          "description": "Remove the reviewer of a ticket (requires tickets.assign).",
+          "arguments": [
             {
-              "name": "--body",
+              "name": "ID",
+              "required": true,
+              "description": "Ticket id or code (e.g. DRFL-3)."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
               "required": true,
-              "description": "Idea proposal body.",
+              "description": "Project id (UUID) or key.",
               "arguments": [
                 {
-                  "name": "TEXT",
+                  "name": "PROJECT",
                   "required": true
                 }
               ]
             }
+          ],
+          "examples": [
+            "closeyourit tickets unreviewer <ticket-id> --project acme-api"
           ]
         },
         {
-          "name": "vote",
-          "description": "Upvote an idea (idempotent).",
+          "name": "watch",
+          "description": "Watch a ticket to receive its notifications (idempotent).",
           "arguments": [
             {
-              "name": "IDEA_ID",
-              "required": true
+              "name": "ID",
+              "required": true,
+              "description": "Ticket id or code (e.g. DRFL-3)."
             }
           ],
           "options": [
@@ -892,15 +1226,19 @@
                 }
               ]
             }
+          ],
+          "examples": [
+            "closeyourit tickets watch <ticket-id> --project acme-api"
           ]
         },
         {
-          "name": "unvote",
-          "description": "Remove your upvote (idempotent).",
+          "name": "unwatch",
+          "description": "Stop watching a ticket (idempotent).",
           "arguments": [
             {
-              "name": "IDEA_ID",
-              "required": true
+              "name": "ID",
+              "required": true,
+              "description": "Ticket id or code (e.g. DRFL-3)."
             }
           ],
           "options": [
@@ -918,17 +1256,20 @@
                 }
               ]
             }
+          ],
+          "examples": [
+            "closeyourit tickets unwatch <ticket-id> --project acme-api"
           ]
-        },
+        }
+      ]
+    },
+    {
+      "name": "ideas",
+      "description": "Project ideas: propose, vote, comment, convert to ticket (AI-synthesized draft).",
+      "commands": [
         {
-          "name": "comment",
-          "description": "Add a comment to an open idea.",
-          "arguments": [
-            {
-              "name": "IDEA_ID",
-              "required": true
-            }
-          ],
+          "name": "list",
+          "description": "List ideas for a project (sorted by votes).",
           "options": [
             {
               "name": "--project",
@@ -945,21 +1286,37 @@
               ]
             },
             {
-              "name": "--body",
-              "required": true,
-              "description": "Comment body.",
+              "name": "--page",
+              "description": "Page number.",
               "arguments": [
                 {
-                  "name": "TEXT",
-                  "required": true
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--status",
+              "description": "Filter by status (open|converted|archived).",
+              "arguments": [
+                {
+                  "name": "STATUS"
+                }
+              ]
+            },
+            {
+              "name": "--sort",
+              "description": "Sort order (votes|recent).",
+              "arguments": [
+                {
+                  "name": "SORT"
                 }
               ]
             }
           ]
         },
         {
-          "name": "comments",
-          "description": "List all comments of an idea (oldest first).",
+          "name": "show",
+          "description": "Show an idea (fields + full proposal body).",
           "arguments": [
             {
               "name": "IDEA_ID",
@@ -984,14 +1341,8 @@
           ]
         },
         {
-          "name": "comment-delete",
-          "description": "Delete a comment from an open idea (author, or ideas.comment.delete_any).",
-          "arguments": [
-            {
-              "name": "IDEA_ID",
-              "required": true
-            }
-          ],
+          "name": "create",
+          "description": "Propose an idea for a project.",
           "options": [
             {
               "name": "--project",
@@ -1008,25 +1359,50 @@
               ]
             },
             {
-              "name": "--comment-id",
+              "name": "--title",
               "required": true,
-              "description": "Comment id to delete.",
+              "description": "Idea title.",
               "arguments": [
                 {
-                  "name": "ID",
+                  "name": "TITLE",
                   "required": true
                 }
               ]
             },
             {
-              "name": "--confirm",
-              "description": "Required: confirm the irreversible deletion."
+              "name": "--problem",
+              "required": true,
+              "description": "Problem or need the idea solves.",
+              "arguments": [
+                {
+                  "name": "TEXT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--solution",
+              "description": "Proposed solution (optional).",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            },
+            {
+              "name": "--stakeholders",
+              "description": "Who it helps — repeatable (optional).",
+              "arguments": [
+                {
+                  "name": "LABEL"
+                }
+              ]
             }
           ]
         },
         {
-          "name": "convert",
-          "description": "Convert an idea into a ticket. Without --title/--description the server AI synthesizes the draft from idea + comments (~30s). Author always allowed; others need ideas.convert.",
+          "name": "update",
+          "description": "Update an idea (full replace of title/problem/solution — omitted fields are cleared).",
           "arguments": [
             {
               "name": "IDEA_ID",
@@ -1050,7 +1426,7 @@
             },
             {
               "name": "--title",
-              "description": "Ticket title (with --description skips AI).",
+              "description": "Idea title.",
               "arguments": [
                 {
                   "name": "TITLE"
@@ -1058,8 +1434,8 @@
               ]
             },
             {
-              "name": "--description",
-              "description": "Ticket description (with --title skips AI).",
+              "name": "--problem",
+              "description": "Problem or need the idea solves.",
               "arguments": [
                 {
                   "name": "TEXT"
@@ -1067,43 +1443,60 @@
               ]
             },
             {
-              "name": "--kind",
-              "description": "Ticket kind (default: feature if roadmap, else bug).",
+              "name": "--solution",
+              "description": "Proposed solution (cleared if omitted).",
               "arguments": [
                 {
-                  "name": "KIND"
+                  "name": "TEXT"
                 }
               ]
             },
             {
-              "name": "--status-id",
-              "description": "Status lookup id (default: open).",
+              "name": "--stakeholders",
+              "description": "Who it helps — repeatable (replaced only when provided).",
               "arguments": [
                 {
-                  "name": "ID"
+                  "name": "LABEL"
                 }
               ]
-            },
+            }
+          ]
+        },
+        {
+          "name": "vote",
+          "description": "Upvote an idea (idempotent).",
+          "arguments": [
             {
-              "name": "--priority-id",
-              "description": "Priority lookup id (default: medium).",
+              "name": "IDEA_ID",
+              "required": true
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
               "arguments": [
                 {
-                  "name": "ID"
+                  "name": "PROJECT",
+                  "required": true
                 }
               ]
             }
           ]
-        }
-      ]
-    },
-    {
-      "name": "metrics",
-      "description": "Performance metrics (slow queries/methods).",
-      "commands": [
+        },
         {
-          "name": "list",
-          "description": "List performance metric groups for a project.",
+          "name": "unvote",
+          "description": "Remove your upvote (idempotent).",
+          "arguments": [
+            {
+              "name": "IDEA_ID",
+              "required": true
+            }
+          ],
           "options": [
             {
               "name": "--project",
@@ -1118,34 +1511,52 @@
                   "required": true
                 }
               ]
-            },
+            }
+          ]
+        },
+        {
+          "name": "comment",
+          "description": "Add a comment to an open idea.",
+          "arguments": [
             {
-              "name": "--kind",
-              "description": "Filter by metric kind (e.g. sql, method).",
+              "name": "IDEA_ID",
+              "required": true
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
               "arguments": [
                 {
-                  "name": "KIND"
+                  "name": "PROJECT",
+                  "required": true
                 }
               ]
             },
             {
-              "name": "--page",
-              "description": "Page number.",
+              "name": "--body",
+              "required": true,
+              "description": "Comment body.",
               "arguments": [
                 {
-                  "name": "N"
+                  "name": "TEXT",
+                  "required": true
                 }
               ]
             }
           ]
         },
         {
-          "name": "show",
-          "description": "Show a single metric group.",
+          "name": "case",
+          "description": "Add a case (example/scenario) to an open idea.",
           "arguments": [
             {
-              "name": "ID",
-              "description": "Metric group id.",
+              "name": "IDEA_ID",
               "required": true
             }
           ],
@@ -1163,55 +1574,49 @@
                   "required": true
                 }
               ]
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "name": "servers",
-      "description": "Server monitoring fleet: list/show hosts, rename, pause/resume, revoke, delete; manage enrollment tokens.",
-      "commands": [
-        {
-          "name": "list",
-          "description": "List the monitored servers (fleet snapshot).",
-          "options": [
-            {
-              "name": "--page",
-              "description": "Page number."
             },
             {
-              "name": "--status",
-              "description": "Filter by status (repeatable: pending|up|down|paused)."
-            }
-          ]
-        },
-        {
-          "name": "show",
-          "description": "Show a monitored server (latest snapshot).",
-          "arguments": [
+              "name": "--title",
+              "required": true,
+              "description": "Case title.",
+              "arguments": [
+                {
+                  "name": "TITLE",
+                  "required": true
+                }
+              ]
+            },
             {
-              "name": "ID",
-              "required": true
+              "name": "--description",
+              "description": "Case description (optional).",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
             }
           ]
         },
         {
-          "name": "rename",
-          "description": "Rename a server (display name).",
+          "name": "comments",
+          "description": "List all comments of an idea (oldest first).",
           "arguments": [
             {
-              "name": "ID",
+              "name": "IDEA_ID",
               "required": true
             }
           ],
           "options": [
             {
-              "name": "--name",
-              "description": "New display name.",
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
               "arguments": [
                 {
-                  "name": "NAME",
+                  "name": "PROJECT",
                   "required": true
                 }
               ]
@@ -1219,101 +1624,2742 @@
           ]
         },
         {
-          "name": "pause",
-          "description": "Pause a server (no staleness/alerts).",
+          "name": "comment-delete",
+          "description": "Delete a comment from an open idea (author, or ideas.comment.delete_any).",
           "arguments": [
             {
-              "name": "ID",
+              "name": "IDEA_ID",
               "required": true
             }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--comment-id",
+              "required": true,
+              "description": "Comment id to delete.",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible deletion."
+            }
           ]
         },
         {
-          "name": "resume",
-          "description": "Resume a paused server.",
+          "name": "convert",
+          "description": "Convert an idea into a ticket. Without --title/--description the server AI synthesizes the draft from idea + comments (~30s). Author always allowed; others need ideas.convert.",
           "arguments": [
             {
-              "name": "ID",
+              "name": "IDEA_ID",
               "required": true
             }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--title",
+              "description": "Ticket title (with --description skips AI).",
+              "arguments": [
+                {
+                  "name": "TITLE"
+                }
+              ]
+            },
+            {
+              "name": "--description",
+              "description": "Ticket description (with --title skips AI).",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            },
+            {
+              "name": "--kind",
+              "description": "Ticket kind (default: feature if roadmap, else bug).",
+              "arguments": [
+                {
+                  "name": "KIND"
+                }
+              ]
+            },
+            {
+              "name": "--status-id",
+              "description": "Status lookup id (default: open).",
+              "arguments": [
+                {
+                  "name": "ID"
+                }
+              ]
+            },
+            {
+              "name": "--priority-id",
+              "description": "Priority lookup id (default: medium).",
+              "arguments": [
+                {
+                  "name": "ID"
+                }
+              ]
+            }
           ]
         },
         {
-          "name": "revoke",
-          "description": "Revoke a server: its agent gets 403 and stops.",
+          "name": "delete",
+          "description": "Delete an idea (author always allowed; others need ideas.delete).",
           "arguments": [
             {
               "name": "ID",
-              "required": true
+              "required": true,
+              "description": "Idea id."
             }
           ],
           "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
             {
               "name": "--confirm",
-              "description": "Required confirmation."
+              "description": "Required: confirm the irreversible deletion."
             }
+          ],
+          "examples": [
+            "closeyourit ideas delete <idea-id> --project acme-api --confirm"
           ]
         },
         {
-          "name": "unrevoke",
-          "description": "Restore a revoked server.",
+          "name": "archive",
+          "description": "Archive an idea (open to archived; author always allowed, others need ideas.edit).",
           "arguments": [
             {
               "name": "ID",
-              "required": true
+              "required": true,
+              "description": "Idea id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
             }
+          ],
+          "examples": [
+            "closeyourit ideas archive <idea-id> --project acme-api"
           ]
         },
         {
-          "name": "delete",
-          "description": "Delete a server and all its metrics.",
+          "name": "unarchive",
+          "description": "Reopen an archived idea (archived to open; author always allowed, others need ideas.edit).",
           "arguments": [
             {
               "name": "ID",
-              "required": true
+              "required": true,
+              "description": "Idea id."
             }
           ],
           "options": [
             {
-              "name": "--confirm",
-              "description": "Required confirmation."
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
             }
+          ],
+          "examples": [
+            "closeyourit ideas unarchive <idea-id> --project acme-api"
           ]
         },
         {
-          "name": "tokens",
-          "description": "Fleet enrollment tokens.",
-          "commands": [
+          "name": "case-update",
+          "description": "Update a case (example/scenario) of an idea (title and/or description).",
+          "arguments": [
             {
-              "name": "list",
-              "description": "List enrollment tokens."
+              "name": "IDEA",
+              "required": true,
+              "description": "Idea id."
             },
             {
-              "name": "create",
-              "description": "Create a token (secret shown once).",
+              "name": "CASE",
+              "required": true,
+              "description": "Case id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
               "arguments": [
                 {
-                  "name": "NAME",
+                  "name": "PROJECT",
                   "required": true
                 }
               ]
             },
             {
-              "name": "revoke",
-              "description": "Revoke an enrollment token.",
+              "name": "--title",
+              "description": "New case title.",
               "arguments": [
                 {
-                  "name": "ID",
-                  "required": true
+                  "name": "TITLE"
                 }
-              ],
-              "options": [
+              ]
+            },
+            {
+              "name": "--description",
+              "description": "New case description.",
+              "arguments": [
                 {
-                  "name": "--confirm",
-                  "description": "Required confirmation."
+                  "name": "TEXT"
                 }
               ]
             }
+          ],
+          "examples": [
+            "closeyourit ideas case-update <idea-id> <case-id> --project acme-api --title \"QR check-in\"",
+            "closeyourit ideas case-update <idea-id> <case-id> -p acme-api --description \"Staff scans the QR at the door\""
+          ]
+        },
+        {
+          "name": "case-delete",
+          "description": "Delete a case from an open idea (author always allowed, others need ideas.edit).",
+          "arguments": [
+            {
+              "name": "IDEA",
+              "required": true,
+              "description": "Idea id."
+            },
+            {
+              "name": "CASE",
+              "required": true,
+              "description": "Case id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible deletion."
+            }
+          ],
+          "examples": [
+            "closeyourit ideas case-delete <idea-id> <case-id> --project acme-api --confirm"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "metrics",
+      "description": "Performance metrics (slow queries/methods).",
+      "commands": [
+        {
+          "name": "list",
+          "description": "List performance metric groups for a project.",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--kind",
+              "description": "Filter by metric kind (e.g. sql, method).",
+              "arguments": [
+                {
+                  "name": "KIND"
+                }
+              ]
+            },
+            {
+              "name": "--page",
+              "description": "Page number.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "show",
+          "description": "Show a single metric group.",
+          "arguments": [
+            {
+              "name": "ID",
+              "description": "Metric group id.",
+              "required": true
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "servers",
+      "description": "Server monitoring fleet: list/show hosts, rename, pause/resume, revoke, delete; manage enrollment tokens.",
+      "commands": [
+        {
+          "name": "list",
+          "description": "List the monitored servers (fleet snapshot).",
+          "options": [
+            {
+              "name": "--page",
+              "description": "Page number."
+            },
+            {
+              "name": "--status",
+              "description": "Filter by status (repeatable: pending|up|down|paused)."
+            }
+          ]
+        },
+        {
+          "name": "show",
+          "description": "Show a monitored server (latest snapshot).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true
+            }
+          ]
+        },
+        {
+          "name": "rename",
+          "description": "Rename a server (display name).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true
+            }
+          ],
+          "options": [
+            {
+              "name": "--name",
+              "description": "New display name.",
+              "arguments": [
+                {
+                  "name": "NAME",
+                  "required": true
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "pause",
+          "description": "Pause a server (no staleness/alerts).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true
+            }
+          ]
+        },
+        {
+          "name": "resume",
+          "description": "Resume a paused server.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true
+            }
+          ]
+        },
+        {
+          "name": "revoke",
+          "description": "Revoke a server: its agent gets 403 and stops.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true
+            }
+          ],
+          "options": [
+            {
+              "name": "--confirm",
+              "description": "Required confirmation."
+            }
+          ]
+        },
+        {
+          "name": "unrevoke",
+          "description": "Restore a revoked server.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true
+            }
+          ]
+        },
+        {
+          "name": "delete",
+          "description": "Delete a server and all its metrics.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true
+            }
+          ],
+          "options": [
+            {
+              "name": "--confirm",
+              "description": "Required confirmation."
+            }
+          ]
+        },
+        {
+          "name": "tokens",
+          "description": "Fleet enrollment tokens.",
+          "commands": [
+            {
+              "name": "list",
+              "description": "List enrollment tokens."
+            },
+            {
+              "name": "create",
+              "description": "Create a token (secret shown once).",
+              "arguments": [
+                {
+                  "name": "NAME",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "revoke",
+              "description": "Revoke an enrollment token.",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true
+                }
+              ],
+              "options": [
+                {
+                  "name": "--confirm",
+                  "description": "Required confirmation."
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "analytics",
+      "description": "Web analytics: snapshot, public share link, conversion goals.",
+      "commands": [
+        {
+          "name": "show",
+          "description": "Show the web analytics snapshot for a project (traffic, top pages, goals).",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--range",
+              "description": "Time range.",
+              "arguments": [
+                {
+                  "name": "RANGE"
+                }
+              ]
+            },
+            {
+              "name": "--environment",
+              "description": "Filter by environment code.",
+              "arguments": [
+                {
+                  "name": "CODE"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit analytics show --project acme-web",
+            "closeyourit analytics show -p acme-web --range 30d --environment production --json"
+          ]
+        },
+        {
+          "name": "share",
+          "description": "Publish a public shareable link to the analytics dashboard (optional password).",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--password",
+              "description": "Optional password to protect the shared link.",
+              "arguments": [
+                {
+                  "name": "PASSWORD"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit analytics share --project acme-web",
+            "closeyourit analytics share -p acme-web --password s3cret"
+          ]
+        },
+        {
+          "name": "unshare",
+          "description": "Revoke the public analytics dashboard link.",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--confirm",
+              "description": "Required: confirm revoking the public link."
+            }
+          ],
+          "examples": [
+            "closeyourit analytics unshare --project acme-web --confirm"
+          ]
+        },
+        {
+          "name": "goals",
+          "description": "Conversion goals.",
+          "commands": [
+            {
+              "name": "list",
+              "description": "List the conversion goals of a project.",
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit analytics goals list --project acme-web"
+              ]
+            },
+            {
+              "name": "create",
+              "description": "Create a conversion goal on a project.",
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--kind",
+                  "required": true,
+                  "description": "Goal kind.",
+                  "arguments": [
+                    {
+                      "name": "KIND",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--display-name",
+                  "required": true,
+                  "description": "Human-readable goal name.",
+                  "arguments": [
+                    {
+                      "name": "NAME",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--event-name",
+                  "description": "Custom event name (required for custom_event goals).",
+                  "arguments": [
+                    {
+                      "name": "NAME"
+                    }
+                  ]
+                },
+                {
+                  "name": "--path-pattern",
+                  "description": "Path pattern, \"*\" suffix = prefix match (required for pageview_path goals).",
+                  "arguments": [
+                    {
+                      "name": "PATTERN"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit analytics goals create -p acme-web --kind custom_event --display-name Signup --event-name signup",
+                "closeyourit analytics goals create -p acme-web --kind pageview_path --display-name Pricing --path-pattern \"/pricing\""
+              ]
+            },
+            {
+              "name": "delete",
+              "description": "Delete a conversion goal (irreversible).",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true,
+                  "description": "Goal id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--confirm",
+                  "description": "Required: confirm the irreversible deletion."
+                }
+              ],
+              "examples": [
+                "closeyourit analytics goals delete <goal-id> --project acme-web --confirm"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "uptime-groups",
+      "description": "Uptime monitor groups (org-level) + public status pages.",
+      "commands": [
+        {
+          "name": "list",
+          "description": "List the uptime monitor groups in your organization.",
+          "options": [
+            {
+              "name": "--page",
+              "description": "Page number.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit uptime-groups list",
+            "closeyourit uptime-groups list --page 2 --json"
+          ]
+        },
+        {
+          "name": "show",
+          "description": "Show an uptime monitor group.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Uptime group id."
+            }
+          ],
+          "examples": [
+            "closeyourit uptime-groups show <group-id>"
+          ]
+        },
+        {
+          "name": "create",
+          "description": "Create an uptime monitor group (org-level container).",
+          "options": [
+            {
+              "name": "--name",
+              "required": true,
+              "description": "Group name.",
+              "arguments": [
+                {
+                  "name": "NAME",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Accent color (Tailwind palette name).",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--icon",
+              "description": "Icon name.",
+              "arguments": [
+                {
+                  "name": "ICON"
+                }
+              ]
+            },
+            {
+              "name": "--description",
+              "description": "Group description.",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit uptime-groups create --name \"Core services\"",
+            "closeyourit uptime-groups create --name API --color sky --icon server --description \"Public API\""
+          ]
+        },
+        {
+          "name": "update",
+          "description": "Update an uptime monitor group (only the provided fields).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Uptime group id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--name",
+              "description": "Group name.",
+              "arguments": [
+                {
+                  "name": "NAME"
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Accent color (Tailwind palette name).",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--icon",
+              "description": "Icon name.",
+              "arguments": [
+                {
+                  "name": "ICON"
+                }
+              ]
+            },
+            {
+              "name": "--description",
+              "description": "Group description.",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit uptime-groups update <group-id> --name \"New name\" --color emerald"
+          ]
+        },
+        {
+          "name": "delete",
+          "description": "Delete an uptime monitor group (irreversible).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Uptime group id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible deletion."
+            }
+          ],
+          "examples": [
+            "closeyourit uptime-groups delete <group-id> --confirm"
+          ]
+        },
+        {
+          "name": "publish",
+          "description": "Publish the public status page for an uptime group.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Uptime group id."
+            }
+          ],
+          "examples": [
+            "closeyourit uptime-groups publish <group-id>"
+          ]
+        },
+        {
+          "name": "unpublish",
+          "description": "Unpublish (retract) the public status page for an uptime group.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Uptime group id."
+            }
+          ],
+          "examples": [
+            "closeyourit uptime-groups unpublish <group-id>"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "releases",
+      "description": "Project releases (tracked from CI).",
+      "commands": [
+        {
+          "name": "list",
+          "description": "List the releases of a project (tracked from CI).",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--page",
+              "description": "Page number.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit releases list --project acme-api",
+            "closeyourit releases list -p acme-api --page 2 --json"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "cron-monitors",
+      "description": "Cron / heartbeat monitors.",
+      "commands": [
+        {
+          "name": "list",
+          "description": "List cron / heartbeat monitors across your visible projects.",
+          "options": [
+            {
+              "name": "--page",
+              "description": "Page number.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "description": "Filter by project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT"
+                }
+              ]
+            },
+            {
+              "name": "--status",
+              "description": "Filter by status.",
+              "arguments": [
+                {
+                  "name": "STATUS"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit cron-monitors list",
+            "closeyourit cron-monitors list --status missed --project acme-api --json"
+          ]
+        },
+        {
+          "name": "show",
+          "description": "Show a cron / heartbeat monitor.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Cron monitor id."
+            }
+          ],
+          "examples": [
+            "closeyourit cron-monitors show <monitor-id>"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "todos",
+      "description": "Personal todo lists (per organization).",
+      "commands": [
+        {
+          "name": "list",
+          "description": "List your own todo lists.",
+          "options": [
+            {
+              "name": "--page",
+              "description": "Page number.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit todos list",
+            "closeyourit todos list --page 2 --json"
+          ]
+        },
+        {
+          "name": "show",
+          "description": "Show one of your todo lists.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Todo list id."
+            }
+          ],
+          "examples": [
+            "closeyourit todos show <list-id>"
+          ]
+        },
+        {
+          "name": "create",
+          "description": "Create a todo list.",
+          "options": [
+            {
+              "name": "--name",
+              "required": true,
+              "description": "List name.",
+              "arguments": [
+                {
+                  "name": "NAME",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit todos create --name \"Sprint prep\"",
+            "closeyourit todos create --name \"Sprint prep\" --color indigo"
+          ]
+        },
+        {
+          "name": "update",
+          "description": "Update a todo list (rename or recolor).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Todo list id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--name",
+              "description": "New name.",
+              "arguments": [
+                {
+                  "name": "NAME"
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit todos update <list-id> --name \"Sprint prep\"",
+            "closeyourit todos update <list-id> --color rose"
+          ]
+        },
+        {
+          "name": "delete",
+          "description": "Delete a todo list (irreversible).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Todo list id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible deletion."
+            }
+          ],
+          "examples": [
+            "closeyourit todos delete <list-id> --confirm"
+          ]
+        },
+        {
+          "name": "reorder",
+          "description": "Reorder your todo lists (pass --list once per id, in the desired order).",
+          "options": [
+            {
+              "name": "--list",
+              "required": true,
+              "description": "List id, in order (repeatable).",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit todos reorder --list <id-a> --list <id-b> --list <id-c>"
+          ]
+        },
+        {
+          "name": "shares",
+          "description": "List the members a todo list is shared with (read-only).",
+          "arguments": [
+            {
+              "name": "LIST_ID",
+              "required": true,
+              "description": "Todo list id."
+            }
+          ],
+          "examples": [
+            "closeyourit todos shares <list-id>"
+          ]
+        },
+        {
+          "name": "share",
+          "description": "Set who a todo list is shared with (replaces the set; omit --account to unshare all).",
+          "arguments": [
+            {
+              "name": "LIST_ID",
+              "required": true,
+              "description": "Todo list id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--account",
+              "description": "Recipient account id (repeatable).",
+              "arguments": [
+                {
+                  "name": "ID"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit todos share <list-id> --account <account-id> --account <account-id>",
+            "closeyourit todos share <list-id>"
+          ]
+        },
+        {
+          "name": "complete",
+          "description": "Mark a todo item as done.",
+          "arguments": [
+            {
+              "name": "LIST_ID",
+              "required": true,
+              "description": "Todo list id."
+            },
+            {
+              "name": "ITEM_ID",
+              "required": true,
+              "description": "Todo item id."
+            }
+          ],
+          "examples": [
+            "closeyourit todos complete <list-id> <item-id>"
+          ]
+        },
+        {
+          "name": "uncomplete",
+          "description": "Reopen a todo item (mark it not done).",
+          "arguments": [
+            {
+              "name": "LIST_ID",
+              "required": true,
+              "description": "Todo list id."
+            },
+            {
+              "name": "ITEM_ID",
+              "required": true,
+              "description": "Todo item id."
+            }
+          ],
+          "examples": [
+            "closeyourit todos uncomplete <list-id> <item-id>"
+          ]
+        },
+        {
+          "name": "shared",
+          "description": "List todo lists shared with you (read-only).",
+          "options": [
+            {
+              "name": "--page",
+              "description": "Page number.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit todos shared",
+            "closeyourit todos shared --page 2 --json"
+          ]
+        },
+        {
+          "name": "shared-show",
+          "description": "Show a todo list shared with you (read-only).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Shared todo list id."
+            }
+          ],
+          "examples": [
+            "closeyourit todos shared-show <list-id>"
+          ]
+        },
+        {
+          "name": "items",
+          "description": "Todo list items.",
+          "commands": [
+            {
+              "name": "list",
+              "description": "List the items of one of your todo lists.",
+              "arguments": [
+                {
+                  "name": "LIST_ID",
+                  "required": true,
+                  "description": "Todo list id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--page",
+                  "description": "Page number.",
+                  "arguments": [
+                    {
+                      "name": "N"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit todos items list <list-id>"
+              ]
+            },
+            {
+              "name": "add",
+              "description": "Add an item to a todo list.",
+              "arguments": [
+                {
+                  "name": "LIST_ID",
+                  "required": true,
+                  "description": "Todo list id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--title",
+                  "required": true,
+                  "description": "Item title.",
+                  "arguments": [
+                    {
+                      "name": "TITLE",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--ticket",
+                  "description": "Link the item to a ticket id.",
+                  "arguments": [
+                    {
+                      "name": "ID"
+                    }
+                  ]
+                },
+                {
+                  "name": "--position",
+                  "description": "Position in the list.",
+                  "arguments": [
+                    {
+                      "name": "N"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit todos items add <list-id> --title \"Write the changelog\"",
+                "closeyourit todos items add <list-id> --title \"Fix login\" --ticket <ticket-id>"
+              ]
+            },
+            {
+              "name": "update",
+              "description": "Update a todo item (retitle, relink a ticket, or reposition).",
+              "arguments": [
+                {
+                  "name": "LIST_ID",
+                  "required": true,
+                  "description": "Todo list id."
+                },
+                {
+                  "name": "ITEM_ID",
+                  "required": true,
+                  "description": "Todo item id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--title",
+                  "description": "New title.",
+                  "arguments": [
+                    {
+                      "name": "TITLE"
+                    }
+                  ]
+                },
+                {
+                  "name": "--ticket",
+                  "description": "Link the item to a ticket id.",
+                  "arguments": [
+                    {
+                      "name": "ID"
+                    }
+                  ]
+                },
+                {
+                  "name": "--position",
+                  "description": "Position in the list.",
+                  "arguments": [
+                    {
+                      "name": "N"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit todos items update <list-id> <item-id> --title \"New title\"",
+                "closeyourit todos items update <list-id> <item-id> --ticket <ticket-id>"
+              ]
+            },
+            {
+              "name": "delete",
+              "description": "Delete a todo item (irreversible).",
+              "arguments": [
+                {
+                  "name": "LIST_ID",
+                  "required": true,
+                  "description": "Todo list id."
+                },
+                {
+                  "name": "ITEM_ID",
+                  "required": true,
+                  "description": "Todo item id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--confirm",
+                  "description": "Required: confirm the irreversible deletion."
+                }
+              ],
+              "examples": [
+                "closeyourit todos items delete <list-id> <item-id> --confirm"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "monitors",
+      "description": "Uptime monitors: create, publish, announcements, incidents.",
+      "commands": [
+        {
+          "name": "create",
+          "description": "Create an uptime monitor for a project (one per environment).",
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--url",
+              "required": true,
+              "description": "URL to probe.",
+              "arguments": [
+                {
+                  "name": "URL",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--environment",
+              "description": "Environment id (must be declared by the project).",
+              "arguments": [
+                {
+                  "name": "ID"
+                }
+              ]
+            },
+            {
+              "name": "--http-method",
+              "description": "HTTP method (default GET).",
+              "arguments": [
+                {
+                  "name": "METHOD"
+                }
+              ]
+            },
+            {
+              "name": "--interval-seconds",
+              "description": "Seconds between checks.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--expected-status",
+              "description": "Expected HTTP status code.",
+              "arguments": [
+                {
+                  "name": "CODE"
+                }
+              ]
+            },
+            {
+              "name": "--timeout-seconds",
+              "description": "Request timeout in seconds.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--expected-body-keyword",
+              "description": "Keyword expected in the response body (check fails without it; not with HEAD).",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            },
+            {
+              "name": "--ssl-expiry-warn-days",
+              "description": "Alert when the TLS certificate has at most N days left (empty = off).",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--group-id",
+              "description": "Uptime group id to attach the monitor to (org-level).",
+              "arguments": [
+                {
+                  "name": "ID"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit monitors create --project acme-api --url https://acme.example.com/up",
+            "closeyourit monitors create -p acme-api --url https://acme.example.com/up --environment <env-id> --interval-seconds 60 --expected-status 200"
+          ]
+        },
+        {
+          "name": "update",
+          "description": "Update an uptime monitor (URL, method, interval, expected status, timeout).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Monitor id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--url",
+              "description": "URL to probe.",
+              "arguments": [
+                {
+                  "name": "URL"
+                }
+              ]
+            },
+            {
+              "name": "--http-method",
+              "description": "HTTP method.",
+              "arguments": [
+                {
+                  "name": "METHOD"
+                }
+              ]
+            },
+            {
+              "name": "--interval-seconds",
+              "description": "Seconds between checks.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--expected-status",
+              "description": "Expected HTTP status code.",
+              "arguments": [
+                {
+                  "name": "CODE"
+                }
+              ]
+            },
+            {
+              "name": "--timeout-seconds",
+              "description": "Request timeout in seconds.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--expected-body-keyword",
+              "description": "Keyword expected in the response body (check fails without it; not with HEAD).",
+              "arguments": [
+                {
+                  "name": "TEXT"
+                }
+              ]
+            },
+            {
+              "name": "--ssl-expiry-warn-days",
+              "description": "Alert when the TLS certificate has at most N days left (empty = off).",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--group-id",
+              "description": "Uptime group id to attach the monitor to (org-level).",
+              "arguments": [
+                {
+                  "name": "ID"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit monitors update <monitor-id> --project acme-api --interval-seconds 120",
+            "closeyourit monitors update <monitor-id> -p acme-api --url https://acme.example.com/health --expected-status 204"
+          ]
+        },
+        {
+          "name": "publish",
+          "description": "Publish the public status page for a monitor (opt-in).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Monitor id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit monitors publish <monitor-id> --project acme-api"
+          ]
+        },
+        {
+          "name": "unpublish",
+          "description": "Unpublish the public status page for a monitor.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Monitor id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--project",
+              "aliases": [
+                "-p"
+              ],
+              "required": true,
+              "description": "Project id (UUID) or key.",
+              "arguments": [
+                {
+                  "name": "PROJECT",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit monitors unpublish <monitor-id> --project acme-api"
+          ]
+        },
+        {
+          "name": "announcements",
+          "description": "Status-page announcement banner.",
+          "commands": [
+            {
+              "name": "show",
+              "description": "Show the status page announcement banner for a monitor (null if none).",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit monitors announcements show <monitor-id> --project acme-api"
+              ]
+            },
+            {
+              "name": "set",
+              "description": "Upsert the status page announcement banner for a monitor.",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--level",
+                  "description": "Banner level.",
+                  "arguments": [
+                    {
+                      "name": "LEVEL"
+                    }
+                  ]
+                },
+                {
+                  "name": "--message",
+                  "description": "Banner message.",
+                  "arguments": [
+                    {
+                      "name": "TEXT"
+                    }
+                  ]
+                },
+                {
+                  "name": "--starts-at",
+                  "description": "Start time (ISO 8601).",
+                  "arguments": [
+                    {
+                      "name": "ISO8601"
+                    }
+                  ]
+                },
+                {
+                  "name": "--ends-at",
+                  "description": "End time (ISO 8601).",
+                  "arguments": [
+                    {
+                      "name": "ISO8601"
+                    }
+                  ]
+                },
+                {
+                  "name": "--active",
+                  "description": "Whether the banner is active."
+                }
+              ],
+              "examples": [
+                "closeyourit monitors announcements set <monitor-id> --project acme-api --level maintenance --message \"Scheduled DB upgrade\"",
+                "closeyourit monitors announcements set <monitor-id> -p acme-api --level warning --message \"Degraded\" --starts-at 2026-07-10T09:00:00Z --ends-at 2026-07-10T11:00:00Z --active"
+              ]
+            },
+            {
+              "name": "clear",
+              "description": "Remove the status page announcement banner for a monitor.",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--confirm",
+                  "description": "Required: confirm the removal."
+                }
+              ],
+              "examples": [
+                "closeyourit monitors announcements clear <monitor-id> --project acme-api --confirm"
+              ]
+            }
+          ]
+        },
+        {
+          "name": "incidents",
+          "description": "Uptime incidents.",
+          "commands": [
+            {
+              "name": "delete",
+              "description": "Delete an uptime incident (and its grouped windows; irreversible).",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                },
+                {
+                  "name": "INCIDENT",
+                  "required": true,
+                  "description": "Incident id (primary)."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--confirm",
+                  "description": "Required: confirm the deletion."
+                }
+              ],
+              "examples": [
+                "closeyourit monitors incidents delete <monitor-id> <incident-id> --project acme-api --confirm"
+              ]
+            },
+            {
+              "name": "group",
+              "description": "Unify incidents of a monitor and post the first narration step.",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--incident",
+                  "required": true,
+                  "description": "Incident id to unify (repeatable).",
+                  "arguments": [
+                    {
+                      "name": "ID",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--phase",
+                  "required": true,
+                  "description": "Timeline phase of the first step.",
+                  "arguments": [
+                    {
+                      "name": "PHASE",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--body",
+                  "description": "Text of the first narration step.",
+                  "arguments": [
+                    {
+                      "name": "TEXT"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit monitors incidents group <monitor-id> --project acme-api --incident <id-a> --incident <id-b> --phase investigating --body \"Looking into it\""
+              ]
+            },
+            {
+              "name": "ungroup",
+              "description": "Dissolve an incident grouping (grouped windows become separate again).",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                },
+                {
+                  "name": "INCIDENT",
+                  "required": true,
+                  "description": "Incident id (primary)."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--keep",
+                  "description": "Id of the window that keeps the narration status.",
+                  "arguments": [
+                    {
+                      "name": "ID"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit monitors incidents ungroup <monitor-id> <incident-id> --project acme-api",
+                "closeyourit monitors incidents ungroup <monitor-id> <incident-id> -p acme-api --keep <window-id>"
+              ]
+            },
+            {
+              "name": "update-add",
+              "description": "Add a timeline step to a narrated incident.",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                },
+                {
+                  "name": "INCIDENT",
+                  "required": true,
+                  "description": "Incident id (primary)."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--phase",
+                  "required": true,
+                  "description": "Timeline phase of the step.",
+                  "arguments": [
+                    {
+                      "name": "PHASE",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--body",
+                  "description": "Text of the step.",
+                  "arguments": [
+                    {
+                      "name": "TEXT"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit monitors incidents update-add <monitor-id> <incident-id> --project acme-api --phase monitoring --body \"Recovering\""
+              ]
+            },
+            {
+              "name": "update-delete",
+              "description": "Delete a timeline step from a narrated incident (irreversible).",
+              "arguments": [
+                {
+                  "name": "MONITOR",
+                  "required": true,
+                  "description": "Monitor id."
+                },
+                {
+                  "name": "INCIDENT",
+                  "required": true,
+                  "description": "Incident id (primary)."
+                },
+                {
+                  "name": "UPDATE_ID",
+                  "required": true,
+                  "description": "Timeline step id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--project",
+                  "aliases": [
+                    "-p"
+                  ],
+                  "required": true,
+                  "description": "Project id (UUID) or key.",
+                  "arguments": [
+                    {
+                      "name": "PROJECT",
+                      "required": true
+                    }
+                  ]
+                },
+                {
+                  "name": "--confirm",
+                  "description": "Required: confirm the deletion."
+                }
+              ],
+              "examples": [
+                "closeyourit monitors incidents update-delete <monitor-id> <incident-id> <update-id> --project acme-api --confirm"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "members",
+      "description": "Organization members: access, profile, removal.",
+      "commands": [
+        {
+          "name": "set-access",
+          "description": "Set a member's access: group/project scope, direct roles, and permission overrides.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Membership id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--group",
+              "description": "Group id or name to grant access to (repeatable; omit to clear group access).",
+              "arguments": [
+                {
+                  "name": "REF"
+                }
+              ]
+            },
+            {
+              "name": "--project",
+              "description": "Project id or key to grant access to (repeatable; omit to clear project access).",
+              "arguments": [
+                {
+                  "name": "REF"
+                }
+              ]
+            },
+            {
+              "name": "--role-id",
+              "description": "Direct role id or name (repeatable; when passed, replaces the direct roles set).",
+              "arguments": [
+                {
+                  "name": "REF"
+                }
+              ]
+            },
+            {
+              "name": "--override",
+              "description": "Permission override \"permission.key=allow|deny|inherit\" (repeatable; when passed, replaces the overrides).",
+              "arguments": [
+                {
+                  "name": "ENTRY"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit members set-access <membership-id> --project acme-api --project acme-web",
+            "closeyourit members set-access <membership-id> --group DriverOne --role-id Maintainer",
+            "closeyourit members set-access <membership-id> --override tickets.edit=allow --override errors.triage=deny",
+            "closeyourit members set-access <membership-id>"
+          ]
+        },
+        {
+          "name": "update",
+          "description": "Update a member's profile: name, email, handle (requires members.edit).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Membership id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--name",
+              "description": "New display name.",
+              "arguments": [
+                {
+                  "name": "NAME"
+                }
+              ]
+            },
+            {
+              "name": "--email",
+              "description": "New email (global credential).",
+              "arguments": [
+                {
+                  "name": "EMAIL"
+                }
+              ]
+            },
+            {
+              "name": "--handle",
+              "description": "New handle (global; a-z, 0-9, underscore).",
+              "arguments": [
+                {
+                  "name": "HANDLE"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit members update <membership-id> --name \"Ada Lovelace\"",
+            "closeyourit members update <membership-id> --email ada@acme.test --handle ada"
+          ]
+        },
+        {
+          "name": "remove",
+          "description": "Remove a member from your organization (irreversible; requires members.manage).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Membership id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible removal."
+            }
+          ],
+          "examples": [
+            "closeyourit members remove <membership-id> --confirm"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "logs",
+      "description": "Structured log entries: show, link, unlink.",
+      "commands": [
+        {
+          "name": "show",
+          "description": "Show a single log entry (attributes, trace id, correlation).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Log entry id."
+            }
+          ],
+          "examples": [
+            "closeyourit logs show <log-entry-id>"
+          ]
+        },
+        {
+          "name": "link",
+          "description": "Manually link a log entry to an error group or a ticket.",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Log entry id."
+            }
+          ],
+          "options": [
+            {
+              "name": "--to",
+              "required": true,
+              "description": "Target to link: \"Errors::Group:<uuid>\" or \"Ticketing::Ticket:<uuid>\".",
+              "arguments": [
+                {
+                  "name": "TARGET",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit logs link <log-entry-id> --to \"Errors::Group:<uuid>\"",
+            "closeyourit logs link <log-entry-id> --to \"Ticketing::Ticket:<uuid>\""
+          ]
+        },
+        {
+          "name": "unlink",
+          "description": "Remove a manual log-to-target link (irreversible).",
+          "arguments": [
+            {
+              "name": "ID",
+              "required": true,
+              "description": "Log entry id."
+            },
+            {
+              "name": "LINK_ID",
+              "required": true,
+              "description": "Link id to remove."
+            }
+          ],
+          "options": [
+            {
+              "name": "--confirm",
+              "description": "Required: confirm the irreversible deletion."
+            }
+          ],
+          "examples": [
+            "closeyourit logs unlink <log-entry-id> <link-id> --confirm"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "alerts",
+      "description": "Alert notifications and personal preferences.",
+      "commands": [
+        {
+          "name": "notifications",
+          "description": "Your in-app alert inbox.",
+          "commands": [
+            {
+              "name": "list",
+              "description": "List your in-app alert notifications (your own inbox).",
+              "options": [
+                {
+                  "name": "--page",
+                  "description": "Page number.",
+                  "arguments": [
+                    {
+                      "name": "N"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit alerts notifications list",
+                "closeyourit alerts notifications list --page 2 --json"
+              ]
+            },
+            {
+              "name": "read",
+              "description": "Mark a single notification as read (idempotent).",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true,
+                  "description": "Notification id."
+                }
+              ],
+              "examples": [
+                "closeyourit alerts notifications read <notification-id>"
+              ]
+            },
+            {
+              "name": "read-all",
+              "description": "Mark all your unread notifications as read.",
+              "examples": [
+                "closeyourit alerts notifications read-all"
+              ]
+            },
+            {
+              "name": "delete",
+              "description": "Delete one of your notifications (irreversible).",
+              "arguments": [
+                {
+                  "name": "ID",
+                  "required": true,
+                  "description": "Notification id."
+                }
+              ],
+              "options": [
+                {
+                  "name": "--confirm",
+                  "description": "Required: confirm the irreversible deletion."
+                }
+              ],
+              "examples": [
+                "closeyourit alerts notifications delete <notification-id> --confirm"
+              ]
+            }
+          ]
+        },
+        {
+          "name": "preferences",
+          "description": "Your personal alert preferences.",
+          "commands": [
+            {
+              "name": "show",
+              "description": "Show your personal alert preferences (per organization).",
+              "examples": [
+                "closeyourit alerts preferences show"
+              ]
+            },
+            {
+              "name": "update",
+              "description": "Update your personal alert preferences (send only the fields you want to change).",
+              "options": [
+                {
+                  "name": "--in-app-enabled",
+                  "description": "Deliver notifications in-app."
+                },
+                {
+                  "name": "--email-enabled",
+                  "description": "Deliver notifications by email."
+                },
+                {
+                  "name": "--errors-enabled",
+                  "description": "Receive error alerts."
+                },
+                {
+                  "name": "--uptime-enabled",
+                  "description": "Receive uptime alerts."
+                },
+                {
+                  "name": "--tickets-enabled",
+                  "description": "Receive ticket notifications."
+                },
+                {
+                  "name": "--chat-enabled",
+                  "description": "Receive chat notifications."
+                },
+                {
+                  "name": "--servers-enabled",
+                  "description": "Receive server alerts."
+                },
+                {
+                  "name": "--min-level",
+                  "description": "Minimum error level that notifies you.",
+                  "arguments": [
+                    {
+                      "name": "LEVEL"
+                    }
+                  ]
+                },
+                {
+                  "name": "--quiet-hours-enabled",
+                  "description": "Enable the quiet-hours window."
+                },
+                {
+                  "name": "--quiet-hours-start",
+                  "description": "Quiet-hours start (HH:MM).",
+                  "arguments": [
+                    {
+                      "name": "HH:MM"
+                    }
+                  ]
+                },
+                {
+                  "name": "--quiet-hours-end",
+                  "description": "Quiet-hours end (HH:MM).",
+                  "arguments": [
+                    {
+                      "name": "HH:MM"
+                    }
+                  ]
+                },
+                {
+                  "name": "--quiet-hours-tz",
+                  "description": "Quiet-hours timezone (IANA, e.g. Europe/Rome).",
+                  "arguments": [
+                    {
+                      "name": "TZ"
+                    }
+                  ]
+                }
+              ],
+              "examples": [
+                "closeyourit alerts preferences update --no-email-enabled --min-level error",
+                "closeyourit alerts preferences update --quiet-hours-enabled --quiet-hours-start 22:00 --quiet-hours-end 07:00 --quiet-hours-tz Europe/Rome"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "groups",
+      "description": "Project groups (macro-projects).",
+      "commands": [
+        {
+          "name": "create",
+          "description": "Create a group (a container of related projects, e.g. \"DriverOne\").",
+          "arguments": [
+            {
+              "name": "NAME",
+              "required": true,
+              "description": "Group name."
+            }
+          ],
+          "options": [
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--roadmap-enabled",
+              "description": "Enable the roadmap and cascade it to the projects in this group."
+            }
+          ],
+          "examples": [
+            "closeyourit groups create DriverOne",
+            "closeyourit groups create DriverOne --color indigo",
+            "closeyourit groups create DriverOne --roadmap-enabled"
+          ]
+        },
+        {
+          "name": "update",
+          "description": "Update a group (rename, recolor, toggle roadmap).",
+          "arguments": [
+            {
+              "name": "GROUP",
+              "required": true,
+              "description": "Group id (UUID) or name."
+            }
+          ],
+          "options": [
+            {
+              "name": "--name",
+              "description": "New name.",
+              "arguments": [
+                {
+                  "name": "NAME"
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--roadmap-enabled",
+              "description": "Enable/disable the roadmap and cascade it to the projects in this group."
+            }
+          ],
+          "examples": [
+            "closeyourit groups update Backend --name \"Backend services\"",
+            "closeyourit groups update Backend --color indigo",
+            "closeyourit groups update Backend --roadmap-enabled"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "org",
+      "description": "Organization settings.",
+      "commands": [
+        {
+          "name": "update",
+          "description": "Update your organization settings (requires organization.manage).",
+          "options": [
+            {
+              "name": "--name",
+              "description": "New organization name.",
+              "arguments": [
+                {
+                  "name": "NAME"
+                }
+              ]
+            },
+            {
+              "name": "--slug",
+              "description": "New organization slug (lowercase, a-z 0-9 and hyphens).",
+              "arguments": [
+                {
+                  "name": "SLUG"
+                }
+              ]
+            },
+            {
+              "name": "--projects-view",
+              "description": "Default projects list view.",
+              "arguments": [
+                {
+                  "name": "VIEW"
+                }
+              ]
+            },
+            {
+              "name": "--logs-retention-days",
+              "description": "Org-level log retention in days (blank inherits the god default).",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--analytics-retention-days",
+              "description": "Org-level analytics retention in days (blank inherits the god default).",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            }
+          ],
+          "examples": [
+            "closeyourit org update --name \"Acme Inc\"",
+            "closeyourit org update --slug acme-inc",
+            "closeyourit org update --projects-view table",
+            "closeyourit org update --logs-retention-days 30 --analytics-retention-days 365"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "platforms",
+      "description": "Platforms (devices/systems your projects run on).",
+      "commands": [
+        {
+          "name": "create",
+          "description": "Create a platform (a device/system your projects run on).",
+          "arguments": [
+            {
+              "name": "CODE",
+              "required": true,
+              "description": "Platform code (e.g. \"ios\", \"android\", \"web\")."
+            }
+          ],
+          "options": [
+            {
+              "name": "--label",
+              "required": true,
+              "description": "Human-readable label.",
+              "arguments": [
+                {
+                  "name": "LABEL",
+                  "required": true
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--position",
+              "description": "Sort position.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--active",
+              "description": "Whether the platform is active."
+            },
+            {
+              "name": "--supports-uptime",
+              "description": "Whether projects declaring this platform can enable uptime monitoring."
+            }
+          ],
+          "examples": [
+            "closeyourit platforms create ios --label iOS",
+            "closeyourit platforms create android --label Android --color emerald --position 2",
+            "closeyourit platforms create web --label Web --supports-uptime"
+          ]
+        },
+        {
+          "name": "update",
+          "description": "Update a platform (relabel, recolor, reorder, activate/deactivate, toggle uptime support).",
+          "arguments": [
+            {
+              "name": "PLATFORM",
+              "required": true,
+              "description": "Platform id (UUID) or code."
+            }
+          ],
+          "options": [
+            {
+              "name": "--code",
+              "description": "New code.",
+              "arguments": [
+                {
+                  "name": "CODE"
+                }
+              ]
+            },
+            {
+              "name": "--label",
+              "description": "New label.",
+              "arguments": [
+                {
+                  "name": "LABEL"
+                }
+              ]
+            },
+            {
+              "name": "--color",
+              "description": "Color label.",
+              "arguments": [
+                {
+                  "name": "COLOR"
+                }
+              ]
+            },
+            {
+              "name": "--position",
+              "description": "Sort position.",
+              "arguments": [
+                {
+                  "name": "N"
+                }
+              ]
+            },
+            {
+              "name": "--active",
+              "description": "Whether the platform is active."
+            },
+            {
+              "name": "--supports-uptime",
+              "description": "Whether projects declaring this platform can enable uptime monitoring."
+            }
+          ],
+          "examples": [
+            "closeyourit platforms update ios --label \"iOS / iPadOS\"",
+            "closeyourit platforms update web --color indigo --position 1",
+            "closeyourit platforms update legacy --no-active",
+            "closeyourit platforms update web --supports-uptime"
           ]
         }
       ]