@bussolabs/closeyourit-cli 0.18.0 → 0.20.0

package/opencli.json

@@ -3,7 +3,7 @@
   "opencli": "0.1",
   "info": {
     "title": "closeyourit",
-    "version": "0.18.0",
+    "version": "0.20.0",
     "description": "CLI for CloseYourIt — manage org, errors, tokens and tickets with your user token",
     "license": {
       "name": "MIT",
@@ -264,7 +264,36 @@
                       "server_disk",
                       "server_temp",
                       "server_service_failed",
-                      "server_smart_failing"
+                      "server_smart_failing",
+                      "error_spike",
+                      "log_alert",
+                      "server_db_down",
+                      "server_db_connections",
+                      "server_replication_lag",
+                      "agents_stalled",
+                      "server_container_down",
+                      "agents_host_failing",
+                      "uptime_slow",
+                      "analytics_traffic_drop",
+                      "analytics_traffic_spike",
+                      "idea_created",
+                      "idea_commented",
+                      "workload_due_soon",
+                      "dataset_training_completed",
+                      "dataset_training_failed",
+                      "agents_host_stale",
+                      "vulnerability_new",
+                      "runtime_eol",
+                      "embedding_down",
+                      "server_container_up",
+                      "server_db_connection_usage",
+                      "server_data_volume_disk",
+                      "server_inode",
+                      "server_replication_down",
+                      "server_replication_up",
+                      "server_container_restart_loop",
+                      "server_container_stable",
+                      "seo_issue_new"
                     ]
                   }
                 ]
@@ -606,7 +635,36 @@
                       "server_disk",
                       "server_temp",
                       "server_service_failed",
-                      "server_smart_failing"
+                      "server_smart_failing",
+                      "error_spike",
+                      "log_alert",
+                      "server_db_down",
+                      "server_db_connections",
+                      "server_replication_lag",
+                      "agents_stalled",
+                      "server_container_down",
+                      "agents_host_failing",
+                      "uptime_slow",
+                      "analytics_traffic_drop",
+                      "analytics_traffic_spike",
+                      "idea_created",
+                      "idea_commented",
+                      "workload_due_soon",
+                      "dataset_training_completed",
+                      "dataset_training_failed",
+                      "agents_host_stale",
+                      "vulnerability_new",
+                      "runtime_eol",
+                      "embedding_down",
+                      "server_container_up",
+                      "server_db_connection_usage",
+                      "server_data_volume_disk",
+                      "server_inode",
+                      "server_replication_down",
+                      "server_replication_up",
+                      "server_container_restart_loop",
+                      "server_container_stable",
+                      "seo_issue_new"
                     ]
                   }
                 ]
@@ -1890,7 +1948,7 @@
               },
               {
                 "name": "--title",
-                "description": "Ticket title (skips AI when set together with --description)",
+                "description": "Ticket title (skips AI when set together with --description, max 255 characters)",
                 "arguments": [
                   {
                     "name": "TITLE",
@@ -1900,7 +1958,7 @@
               },
               {
                 "name": "--description",
-                "description": "Ticket description (skips AI when set together with --title)",
+                "description": "Ticket description (skips AI when set together with --title, max 4000 characters)",
                 "arguments": [
                   {
                     "name": "DESCRIPTION",
@@ -1925,21 +1983,21 @@
                 ]
               },
               {
-                "name": "--status-id",
-                "description": "Status lookup id (default: open)",
+                "name": "--status",
+                "description": "Status code, label or id (e.g. open, \"In Progress\") — default: open",
                 "arguments": [
                   {
-                    "name": "STATUS-ID",
+                    "name": "STATUS",
                     "required": true
                   }
                 ]
               },
               {
-                "name": "--priority-id",
-                "description": "Priority lookup id (default: medium)",
+                "name": "--priority",
+                "description": "Priority code, label or id (e.g. medium, High) — default: medium",
                 "arguments": [
                   {
-                    "name": "PRIORITY-ID",
+                    "name": "PRIORITY",
                     "required": true
                   }
                 ]
@@ -2453,7 +2511,7 @@
               },
               {
                 "name": "--title",
-                "description": "Page title",
+                "description": "Page title (max 255 characters)",
                 "required": true,
                 "arguments": [
                   {
@@ -2474,7 +2532,7 @@
               },
               {
                 "name": "--body",
-                "description": "Page body (markdown)",
+                "description": "Page body (markdown, max 4000 characters)",
                 "arguments": [
                   {
                     "name": "BODY",
@@ -2484,7 +2542,7 @@
               },
               {
                 "name": "--body-file",
-                "description": "Read the body (markdown) from a local file",
+                "description": "Read the body (markdown, max 4000 characters) from a local file",
                 "arguments": [
                   {
                     "name": "BODY-FILE",
@@ -2494,7 +2552,7 @@
               },
               {
                 "name": "--tech-spec",
-                "description": "Technical section, kept separate from the simple body",
+                "description": "Technical section, kept separate from the simple body (max 1500 characters)",
                 "arguments": [
                   {
                     "name": "TECH-SPEC",
@@ -2504,7 +2562,7 @@
               },
               {
                 "name": "--tech-spec-file",
-                "description": "Read the technical section from a local file",
+                "description": "Read the technical section (max 1500 characters) from a local file",
                 "arguments": [
                   {
                     "name": "TECH-SPEC-FILE",
@@ -2518,7 +2576,7 @@
               },
               {
                 "name": "--review-note",
-                "description": "One line explaining why the page is worth keeping (review queue)",
+                "description": "One line explaining why the page is worth keeping (review queue, max 240 characters)",
                 "arguments": [
                   {
                     "name": "REVIEW-NOTE",
@@ -2765,7 +2823,7 @@
             "options": [
               {
                 "name": "--title",
-                "description": "New title",
+                "description": "New title (max 255 characters)",
                 "arguments": [
                   {
                     "name": "TITLE",
@@ -2785,7 +2843,7 @@
               },
               {
                 "name": "--body",
-                "description": "New body (markdown)",
+                "description": "New body (markdown, max 4000 characters)",
                 "arguments": [
                   {
                     "name": "BODY",
@@ -2795,7 +2853,7 @@
               },
               {
                 "name": "--body-file",
-                "description": "Read the new body (markdown) from a local file",
+                "description": "Read the new body (markdown, max 4000 characters) from a local file",
                 "arguments": [
                   {
                     "name": "BODY-FILE",
@@ -2805,7 +2863,7 @@
               },
               {
                 "name": "--tech-spec",
-                "description": "New technical section, kept separate from the simple body",
+                "description": "New technical section, kept separate from the simple body (max 1500 characters)",
                 "arguments": [
                   {
                     "name": "TECH-SPEC",
@@ -2815,7 +2873,7 @@
               },
               {
                 "name": "--tech-spec-file",
-                "description": "Read the new technical section from a local file",
+                "description": "Read the new technical section (max 1500 characters) from a local file",
                 "arguments": [
                   {
                     "name": "TECH-SPEC-FILE",
@@ -5082,7 +5140,7 @@
             "examples": [
               "closeyourit personal import --from-file .env",
               "closeyourit personal import --format json --from-file secrets.json",
-              "doppler secrets download --no-file --format json | closeyourit personal import --format json"
+              "printf '{\"API_KEY\":\"value\"}' | closeyourit personal import --format json"
             ]
           },
           {
@@ -5095,7 +5153,7 @@
           },
           {
             "name": "run",
-            "description": "Run a command with your personal secrets injected as env vars (like `doppler run`). Secrets never touch disk.",
+            "description": "Run a command with your personal secrets injected as env vars. Secrets never touch disk.",
             "examples": [
               "closeyourit personal run -- bundle exec rails server",
               "closeyourit personal run -- printenv OPENAI_API_KEY"
@@ -6192,7 +6250,7 @@
       },
       {
         "name": "run",
-        "description": "Run a command with the project/environment secrets injected as env vars (like `doppler run`). Secrets never touch disk.",
+        "description": "Run a command with project/environment secrets injected as env vars. Secrets never touch disk.",
         "options": [
           {
             "name": "--project",
@@ -6820,7 +6878,7 @@
             "examples": [
               "closeyourit secrets import -p acme-api -e production --from-file .env",
               "closeyourit secrets import -p acme-api -e production --format json --from-file secrets.json",
-              "doppler secrets download --config production --no-file --format json | closeyourit secrets import -p acme-api -e production --format json"
+              "printf '{\"API_KEY\":\"value\"}' | closeyourit secrets import -p acme-api -e development --format json"
             ]
           },
           {
@@ -6958,6 +7016,398 @@
           }
         ]
       },
+      {
+        "name": "seo",
+        "commands": [
+          {
+            "name": "ignore",
+            "description": "Ignore an SEO finding: you accept living with it",
+            "options": [
+              {
+                "name": "--note",
+                "description": "Why you are keeping it (shown alongside the ignored row)",
+                "arguments": [
+                  {
+                    "name": "NOTE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "SEO finding id"
+              }
+            ],
+            "examples": [
+              "closeyourit seo ignore <issue-id>",
+              "closeyourit seo ignore <issue-id> --note \"Service page, not meant to be found.\""
+            ]
+          },
+          {
+            "name": "list",
+            "description": "List the SEO findings of your sites (cross-project)",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Filter by project id (UUID) or key",
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--severity",
+                "description": "Filter by severity (critical, high, medium, low)",
+                "arguments": [
+                  {
+                    "name": "SEVERITY",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--status",
+                "description": "Filter by status (open, resolved, ignored)",
+                "arguments": [
+                  {
+                    "name": "STATUS",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--area",
+                "description": "Filter by area (indexability, structure, content, i18n, performance)",
+                "arguments": [
+                  {
+                    "name": "AREA",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--page",
+                "description": "Page number",
+                "arguments": [
+                  {
+                    "name": "PAGE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "examples": [
+              "closeyourit seo list",
+              "closeyourit seo list --severity critical",
+              "closeyourit seo list --project acme-site --status open",
+              "closeyourit seo list --area indexability --json"
+            ]
+          },
+          {
+            "name": "pages",
+            "description": "List the pages the SEO check has visited, with their state",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Filter by project id (UUID) or key",
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--url",
+                "description": "Filter by URL (partial match)",
+                "arguments": [
+                  {
+                    "name": "URL",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--page",
+                "description": "Page number",
+                "arguments": [
+                  {
+                    "name": "PAGE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "examples": [
+              "closeyourit seo pages",
+              "closeyourit seo pages --project acme-site",
+              "closeyourit seo pages --url /prezzi --json"
+            ]
+          },
+          {
+            "name": "promote",
+            "description": "Open a ticket from an SEO finding, evidence included",
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "SEO finding id"
+              }
+            ],
+            "examples": [
+              "closeyourit seo promote <issue-id>"
+            ]
+          },
+          {
+            "name": "reopen",
+            "description": "Reopen an ignored SEO finding: you changed your mind",
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "SEO finding id"
+              }
+            ],
+            "examples": [
+              "closeyourit seo reopen <issue-id>"
+            ]
+          },
+          {
+            "name": "rescan",
+            "description": "Check a site now, without waiting for the next scheduled run",
+            "options": [
+              {
+                "name": "--site",
+                "description": "Site id (from `seo-sites list`)",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "SITE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "examples": [
+              "closeyourit seo rescan --site <site-id>"
+            ]
+          },
+          {
+            "name": "show",
+            "description": "Show a single SEO finding, with the evidence behind it",
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "SEO finding id"
+              }
+            ],
+            "examples": [
+              "closeyourit seo show <issue-id>"
+            ]
+          }
+        ]
+      },
+      {
+        "name": "seo-sites",
+        "commands": [
+          {
+            "name": "create",
+            "description": "Declare a site to keep an eye on (one per project and environment)",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Project id (UUID) or key",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--url",
+                "description": "Public address the visit starts from",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "URL",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--environment",
+                "description": "Environment id (must be declared by the project)",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "ENVIRONMENT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--frequency",
+                "description": "How often to check it: daily (default) or weekly",
+                "arguments": [
+                  {
+                    "name": "FREQUENCY",
+                    "required": true,
+                    "acceptedValues": [
+                      "daily",
+                      "weekly"
+                    ]
+                  }
+                ]
+              },
+              {
+                "name": "--max-pages",
+                "description": "How many pages to visit at most each run",
+                "arguments": [
+                  {
+                    "name": "MAX-PAGES",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--no-sitemap",
+                "description": "Don't read the sitemap: start from the home page and follow links only"
+              }
+            ],
+            "examples": [
+              "closeyourit seo-sites create --project acme-site --url https://www.acme.example --environment <env-id>",
+              "closeyourit seo-sites create -p acme-site --url https://www.acme.example --environment <env-id> --frequency weekly --max-pages 50"
+            ]
+          },
+          {
+            "name": "delete",
+            "description": "Stop watching a site and remove its pages and findings",
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "Site id"
+              }
+            ],
+            "examples": [
+              "closeyourit seo-sites delete <site-id>"
+            ]
+          },
+          {
+            "name": "list",
+            "description": "List the sites under SEO check",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Filter by project id (UUID) or key",
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--page",
+                "description": "Page number",
+                "arguments": [
+                  {
+                    "name": "PAGE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "examples": [
+              "closeyourit seo-sites list",
+              "closeyourit seo-sites list --project acme-site --json"
+            ]
+          },
+          {
+            "name": "update",
+            "description": "Change how a site is checked (project and environment are its identity: they never change)",
+            "options": [
+              {
+                "name": "--url",
+                "description": "Public address the visit starts from",
+                "arguments": [
+                  {
+                    "name": "URL",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--frequency",
+                "description": "How often to check it: daily or weekly",
+                "arguments": [
+                  {
+                    "name": "FREQUENCY",
+                    "required": true,
+                    "acceptedValues": [
+                      "daily",
+                      "weekly"
+                    ]
+                  }
+                ]
+              },
+              {
+                "name": "--max-pages",
+                "description": "How many pages to visit at most each run",
+                "arguments": [
+                  {
+                    "name": "MAX-PAGES",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--sitemap",
+                "description": "Read the sitemap"
+              },
+              {
+                "name": "--enable",
+                "description": "Resume the checks"
+              },
+              {
+                "name": "--disable",
+                "description": "Pause the checks (the site and its findings stay)"
+              }
+            ],
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "Site id"
+              }
+            ],
+            "examples": [
+              "closeyourit seo-sites update <site-id> --frequency weekly",
+              "closeyourit seo-sites update <site-id> --max-pages 200 --disable"
+            ]
+          }
+        ]
+      },
       {
         "name": "servers",
         "description": "Server monitoring fleet (agents, enrollment tokens)",
@@ -6982,6 +7432,38 @@
               "closeyourit servers delete <server-id> --confirm"
             ]
           },
+          {
+            "name": "ignored-containers",
+            "description": "Read or set the container names this server does not treat as services",
+            "options": [
+              {
+                "name": "--clear",
+                "description": "Remove every ignored container name"
+              },
+              {
+                "name": "--set",
+                "description": "Comma-separated names to ignore (replaces the list)",
+                "arguments": [
+                  {
+                    "name": "SET",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "Server id"
+              }
+            ],
+            "examples": [
+              "closeyourit servers ignored-containers <server-id>",
+              "closeyourit servers ignored-containers <server-id> --set buildkit,runner",
+              "closeyourit servers ignored-containers <server-id> --clear"
+            ]
+          },
           {
             "name": "list",
             "description": "List the monitored servers in your organization (fleet snapshot)",
@@ -7843,7 +8325,7 @@
               },
               {
                 "name": "--body",
-                "description": "Comment body",
+                "description": "Comment body (max 240 characters — longer text goes in the work report)",
                 "required": true,
                 "arguments": [
                   {
@@ -7942,7 +8424,7 @@
           },
           {
             "name": "create",
-            "description": "Create a ticket",
+            "description": "Create a ticket (status defaults to open, priority to medium; both take a code or a label)",
             "options": [
               {
                 "name": "--project",
@@ -7960,7 +8442,7 @@
               },
               {
                 "name": "--title",
-                "description": "Ticket title",
+                "description": "Ticket title (max 255 characters)",
                 "required": true,
                 "arguments": [
                   {
@@ -7987,7 +8469,7 @@
               },
               {
                 "name": "--description",
-                "description": "Free-form description (human-simple summary)",
+                "description": "Free-form description (human-simple summary, max 4000 characters)",
                 "arguments": [
                   {
                     "name": "DESCRIPTION",
@@ -7997,7 +8479,7 @@
               },
               {
                 "name": "--technical-analysis",
-                "description": "Technical analysis (stack, cause) — kept out of the human-simple body",
+                "description": "Technical analysis (stack, cause) — kept out of the human-simple body (max 1500 characters)",
                 "arguments": [
                   {
                     "name": "TECHNICAL-ANALYSIS",
@@ -8086,21 +8568,21 @@
                 ]
               },
               {
-                "name": "--status-id",
-                "description": "Status lookup id",
+                "name": "--status",
+                "description": "Status code, label or id (e.g. open, \"In Progress\") — default: open",
                 "arguments": [
                   {
-                    "name": "STATUS-ID",
+                    "name": "STATUS",
                     "required": true
                   }
                 ]
               },
               {
-                "name": "--priority-id",
-                "description": "Priority lookup id",
+                "name": "--priority",
+                "description": "Priority code, label or id (e.g. medium, High) — default: medium",
                 "arguments": [
                   {
-                    "name": "PRIORITY-ID",
+                    "name": "PRIORITY",
                     "required": true
                   }
                 ]
@@ -8149,7 +8631,8 @@
             "examples": [
               "closeyourit tickets create --project acme-api --title \"Checkout fails\"",
               "closeyourit tickets create -p acme-api --title \"Login bug\" --kind bug --step-given \"logged out\" --step-when \"I submit\" --step-then \"it 500s\"",
-              "closeyourit tickets create -p acme-api --title \"Checkout\" --scenarios '[{\"title\":\"Happy\",\"step_given\":\"logged in\",\"step_when\":\"I pay\",\"step_then\":\"order created\"}]' --condition \"confirmation email is sent\""
+              "closeyourit tickets create -p acme-api --title \"Checkout\" --scenarios '[{\"title\":\"Happy\",\"step_given\":\"logged in\",\"step_when\":\"I pay\",\"step_then\":\"order created\"}]' --condition \"confirmation email is sent\"",
+              "closeyourit tickets create -p acme-api --title \"Payment retry\" --status in_progress --priority High"
             ]
           },
           {
@@ -8639,6 +9122,139 @@
               "closeyourit tickets reject <ticket-id> --project acme-api --reason \"Edge case not covered\""
             ]
           },
+          {
+            "name": "report",
+            "description": "Write the work report of a ticket — the long text a comment cannot hold. Each write adds a version, it never overwrites the previous one",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Project id (UUID) or key",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--body",
+                "description": "Report body (markdown, max 20000 characters)",
+                "arguments": [
+                  {
+                    "name": "BODY",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--body-file",
+                "description": "Read the report body (max 20000 characters) from a local file",
+                "arguments": [
+                  {
+                    "name": "BODY-FILE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "Ticket id or code (e.g. DRFL-3)"
+              }
+            ],
+            "examples": [
+              "closeyourit tickets report <ticket-id> --project acme-api --body \"Cosa ho fatto, come si verifica\"",
+              "closeyourit tickets report DRFL-3 -p acme-api --body-file ./report.md"
+            ]
+          },
+          {
+            "name": "report-show",
+            "description": "Show the current work report of a ticket, or a past version with --version",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Project id (UUID) or key",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--version",
+                "description": "Version number to read instead of the current one",
+                "arguments": [
+                  {
+                    "name": "VERSION",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "Ticket id or code (e.g. DRFL-3)"
+              }
+            ],
+            "examples": [
+              "closeyourit tickets report-show <ticket-id> --project acme-api",
+              "closeyourit tickets report-show DRFL-3 -p acme-api --version 2"
+            ]
+          },
+          {
+            "name": "report-versions",
+            "description": "List the versions of the work report of a ticket (newest first)",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Project id (UUID) or key",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--page",
+                "description": "Page number",
+                "arguments": [
+                  {
+                    "name": "PAGE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "arguments": [
+              {
+                "name": "ID",
+                "required": true,
+                "description": "Ticket id or code (e.g. DRFL-3)"
+              }
+            ],
+            "examples": [
+              "closeyourit tickets report-versions <ticket-id> --project acme-api",
+              "closeyourit tickets report-versions DRFL-3 -p acme-api --page 2 --json"
+            ]
+          },
           {
             "name": "reviewer",
             "description": "Set the reviewer of a ticket (requires tickets.assign)",
@@ -8714,7 +9330,7 @@
           },
           {
             "name": "status",
-            "description": "Change a ticket status",
+            "description": "Change a ticket status (by code, label or id)",
             "options": [
               {
                 "name": "--project",
@@ -8731,12 +9347,12 @@
                 ]
               },
               {
-                "name": "--status-id",
-                "description": "Target status lookup id",
+                "name": "--status",
+                "description": "Target status code, label or id (e.g. in_review, \"In Review\")",
                 "required": true,
                 "arguments": [
                   {
-                    "name": "STATUS-ID",
+                    "name": "STATUS",
                     "required": true
                   }
                 ]
@@ -8750,7 +9366,8 @@
               }
             ],
             "examples": [
-              "closeyourit tickets status <ticket-id> --project acme-api --status-id <status-id>"
+              "closeyourit tickets status <ticket-id> --project acme-api --status in_review",
+              "closeyourit tickets status <ticket-id> --project acme-api --status <status-id>"
             ]
           },
           {
@@ -8892,7 +9509,7 @@
           },
           {
             "name": "update",
-            "description": "Update a ticket (full replace — fields you omit are cleared server-side)",
+            "description": "Update a ticket, changing only the fields you pass (the others keep their current value; use --clear to empty one, --replace for the raw full replace)",
             "options": [
               {
                 "name": "--project",
@@ -8910,7 +9527,7 @@
               },
               {
                 "name": "--title",
-                "description": "Ticket title",
+                "description": "Ticket title (max 255 characters)",
                 "arguments": [
                   {
                     "name": "TITLE",
@@ -8936,7 +9553,7 @@
               },
               {
                 "name": "--description",
-                "description": "Free-form description (human-simple summary)",
+                "description": "Free-form description (human-simple summary, max 4000 characters)",
                 "arguments": [
                   {
                     "name": "DESCRIPTION",
@@ -8946,7 +9563,7 @@
               },
               {
                 "name": "--technical-analysis",
-                "description": "Technical analysis (stack, cause) — kept out of the human-simple body",
+                "description": "Technical analysis (stack, cause) — kept out of the human-simple body (max 1500 characters)",
                 "arguments": [
                   {
                     "name": "TECHNICAL-ANALYSIS",
@@ -9035,21 +9652,21 @@
                 ]
               },
               {
-                "name": "--status-id",
-                "description": "Status lookup id",
+                "name": "--status",
+                "description": "Status code, label or id (e.g. open, \"In Progress\") — unchanged when omitted",
                 "arguments": [
                   {
-                    "name": "STATUS-ID",
+                    "name": "STATUS",
                     "required": true
                   }
                 ]
               },
               {
-                "name": "--priority-id",
-                "description": "Priority lookup id",
+                "name": "--priority",
+                "description": "Priority code, label or id (e.g. medium, High) — unchanged when omitted",
                 "arguments": [
                   {
-                    "name": "PRIORITY-ID",
+                    "name": "PRIORITY",
                     "required": true
                   }
                 ]
@@ -9093,6 +9710,30 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "name": "--clear",
+                "description": "Empty a field on purpose (repeatable): description, technical-analysis, weight, due-at, assignee, milestone, parent, platforms",
+                "arguments": [
+                  {
+                    "name": "CLEAR",
+                    "required": true,
+                    "acceptedValues": [
+                      "description",
+                      "technical-analysis",
+                      "weight",
+                      "due-at",
+                      "assignee",
+                      "milestone",
+                      "parent",
+                      "platforms"
+                    ]
+                  }
+                ]
+              },
+              {
+                "name": "--replace",
+                "description": "Send only the flags you passed (full replace — every field you omit is cleared server-side)"
               }
             ],
             "arguments": [
@@ -9104,7 +9745,10 @@
             ],
             "examples": [
               "closeyourit tickets update <ticket-id> --project acme-api --title \"New title\"",
-              "closeyourit tickets update <ticket-id> -p acme-api --title \"Login bug\" --scenarios '[{\"step_given\":\"logged out\",\"step_when\":\"I submit\",\"step_then\":\"it 500s\",\"step_expected\":\"dashboard loads\"}]' --condition \"login works\""
+              "closeyourit tickets update <ticket-id> -p acme-api --clear assignee --clear due-at",
+              "closeyourit tickets update <ticket-id> -p acme-api --title \"Login bug\" --scenarios '[{\"step_given\":\"logged out\",\"step_when\":\"I submit\",\"step_then\":\"it 500s\",\"step_expected\":\"dashboard loads\"}]' --condition \"login works\"",
+              "closeyourit tickets update <ticket-id> -p acme-api --status in_review --priority High",
+              "closeyourit tickets update <ticket-id> -p acme-api --replace --title \"Only this\" --status open --priority medium"
             ]
           },
           {