checkly 7.7.0 → 7.8.0-prerelease-9bdcdb2

package/oclif.manifest.json

@@ -75,7 +75,7 @@
         },
         "force": {
           "char": "f",
-          "description": "Force mode. Skips the confirmation dialog.",
+          "description": "Skip confirmation prompt.",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
@@ -139,7 +139,7 @@
       "flags": {
         "force": {
           "char": "f",
-          "description": "Force mode. Skips the confirmation dialog.",
+          "description": "Skip confirmation prompt.",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
@@ -198,6 +198,45 @@
         "help.js"
       ]
     },
+    "init": {
+      "aliases": [],
+      "args": {},
+      "description": "Initialize Checkly in your project",
+      "examples": [
+        "$ npx checkly init",
+        "$ npx checkly init --target claude",
+        "$ CI=true npx checkly init"
+      ],
+      "flags": {
+        "target": {
+          "char": "t",
+          "description": "Install the Checkly skill for a specific AI agent (amp, claude, cline, codex, continue, cursor, gemini-cli, github-copilot, goose, opencode, roo, windsurf).",
+          "name": "target",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "init",
+      "pluginAlias": "checkly",
+      "pluginName": "checkly",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "coreCommand": true,
+      "readOnly": false,
+      "destructive": false,
+      "idempotent": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "init.js"
+      ]
+    },
     "login": {
       "aliases": [],
       "args": {},
@@ -400,6 +439,12 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "refresh-cache": {
+          "description": "Force a fresh install of dependencies and update the cached version.",
+          "name": "refresh-cache",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -680,6 +725,12 @@
           "name": "verify-runtime-dependencies",
           "allowNo": true,
           "type": "boolean"
+        },
+        "refresh-cache": {
+          "description": "Force a fresh install of dependencies and update the cached version.",
+          "name": "refresh-cache",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -821,6 +872,12 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "refresh-cache": {
+          "description": "Force a fresh install of dependencies and update the cached version.",
+          "name": "refresh-cache",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1624,7 +1681,7 @@
       "flags": {
         "force": {
           "char": "f",
-          "description": "Force to skip the confirmation prompt.",
+          "description": "Skip confirmation prompt.",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
@@ -1706,6 +1763,198 @@
         "update.js"
       ]
     },
+    "import:apply": {
+      "aliases": [],
+      "args": {},
+      "description": "Attach imported resources into your project in a pending state.",
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "import:apply",
+      "pluginAlias": "checkly",
+      "pluginName": "checkly",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "coreCommand": false,
+      "readOnly": false,
+      "destructive": false,
+      "idempotent": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "import",
+        "apply.js"
+      ]
+    },
+    "import:cancel": {
+      "aliases": [],
+      "args": {},
+      "description": "Cancels an ongoing import plan that has not been committed yet.",
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "all": {
+          "description": "Cancel all plans.",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "import:cancel",
+      "pluginAlias": "checkly",
+      "pluginName": "checkly",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "coreCommand": false,
+      "readOnly": false,
+      "destructive": false,
+      "idempotent": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "import",
+        "cancel.js"
+      ]
+    },
+    "import:commit": {
+      "aliases": [],
+      "args": {},
+      "description": "Permanently commit imported resources into your project.",
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "import:commit",
+      "pluginAlias": "checkly",
+      "pluginName": "checkly",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "coreCommand": false,
+      "readOnly": false,
+      "destructive": false,
+      "idempotent": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "import",
+        "commit.js"
+      ]
+    },
+    "import:plan": {
+      "aliases": [],
+      "args": {
+        "resource": {
+          "description": "A specific resource to import.",
+          "name": "resource",
+          "required": false
+        }
+      },
+      "description": "Import existing resources from your Checkly account to your project.\n\nBy default, all resources that can be imported will be imported. However, you\nmay fine-tune the process by including or excluding any combination of\nresources.\n\nThe import process consists of three steps:\n\n1. Creating a plan, which generates the appropriate code for your resources\n2. Applying the plan, which links your resources to the generated code\n3. Committing the plan, which finalizes the import session\n\nCREATING A PLAN\n\nCreating a plan carries no risk as no concrete links to your Checkly resources\nare made at this point. However, if you accidentally deploy the generated code\nbefore applying the plan, you will end up with duplicate resources and will\nnot be able to complete the import session without first deleting the\nduplicates.\n\nFor the curious, you may also preview the generated code with the '--preview'\noption. No plan will be created, allowing you to leisurely inspect the\ngenerated code. However keep in mind that you will need to create a plan to\nactually import any resources, at which point the code will be generated\nagain.\n\nYou may cancel any plan you've created without affecting any of the\nunderlying resources.\n\nAPPLYING A PLAN\n\nApplying a plan links your existing resources to the generated code. You\nshould carefully review the generated code to make sure that it contains the\nresources you expect before applying a plan. After a plan has been applied,\nany deployments of those resources will irreversibly modify the underlying\nCheckly resources. However, as a fail safe against concurrent use, any\ndeployments not including the imported resources will not delete the\nunderlying resources (or the links to the resources). This means that there\nis no need to block deployments while working on an import session.\n\nEven after you've applied a plan, you may still cancel it, which will unlink\nthe underlying resources from your project once more. However, keep in mind\nthat any changes to the resources that you've already deployed cannot be\nundone.\n\nCOMMITTING A PLAN\n\nFinally, committing a plan removes all fail safes and permanently links the\nimported resources to your project. Any resources you remove from your code\nwill result in the underlying resources also getting irrevocably deleted on\nthe next deploy. You should only commit your plan once you are sure that all\nfuture deployments include the imported resources.",
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "root": {
+          "description": "The root folder in which to write generated code files.",
+          "name": "root",
+          "default": "__checks__",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "preview": {
+          "description": "Preview generated code without creating an actual import plan.",
+          "name": "preview",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "debug-import-plan": {
+          "description": "Output the import plan to a file.",
+          "hidden": true,
+          "name": "debug-import-plan",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "debug-import-plan-input-file": {
+          "description": "A file to load an import plan from.",
+          "hidden": true,
+          "name": "debug-import-plan-input-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug-import-plan-output-file": {
+          "description": "The file to output the import plan to.",
+          "hidden": true,
+          "name": "debug-import-plan-output-file",
+          "default": "./debug-import-plan.json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [
+        "import"
+      ],
+      "id": "import:plan",
+      "pluginAlias": "checkly",
+      "pluginName": "checkly",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "coreCommand": false,
+      "readOnly": true,
+      "destructive": false,
+      "idempotent": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "import",
+        "plan.js"
+      ]
+    },
     "incidents:create": {
       "aliases": [],
       "args": {},
@@ -2054,196 +2303,115 @@
         "update.js"
       ]
     },
-    "import:apply": {
+    "rca:get": {
       "aliases": [],
-      "args": {},
-      "description": "Attach imported resources into your project in a pending state.",
-      "flags": {
-        "config": {
-          "char": "c",
-          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
-          "name": "config",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+      "args": {
+        "id": {
+          "description": "The RCA ID to retrieve.",
+          "name": "id",
+          "required": true
         }
       },
-      "hasDynamicHelp": false,
-      "hidden": false,
-      "hiddenAliases": [],
-      "id": "import:apply",
-      "pluginAlias": "checkly",
-      "pluginName": "checkly",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "coreCommand": false,
-      "readOnly": false,
-      "destructive": false,
-      "idempotent": false,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "import",
-        "apply.js"
-      ]
-    },
-    "import:cancel": {
-      "aliases": [],
-      "args": {},
-      "description": "Cancels an ongoing import plan that has not been committed yet.",
+      "description": "Retrieve a root cause analysis by ID.",
       "flags": {
-        "config": {
-          "char": "c",
-          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
-          "name": "config",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "all": {
-          "description": "Cancel all plans.",
-          "name": "all",
+        "watch": {
+          "char": "w",
+          "description": "Wait for the analysis to complete if still generating.",
+          "name": "watch",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": false,
-      "hiddenAliases": [],
-      "id": "import:cancel",
-      "pluginAlias": "checkly",
-      "pluginName": "checkly",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "coreCommand": false,
-      "readOnly": false,
-      "destructive": false,
-      "idempotent": true,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "import",
-        "cancel.js"
-      ]
-    },
-    "import:commit": {
-      "aliases": [],
-      "args": {},
-      "description": "Permanently commit imported resources into your project.",
-      "flags": {
-        "config": {
-          "char": "c",
-          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
-          "name": "config",
+        },
+        "output": {
+          "char": "o",
+          "description": "Output format.",
+          "name": "output",
+          "default": "detail",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "detail",
+            "json",
+            "md"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hidden": false,
       "hiddenAliases": [],
-      "id": "import:commit",
+      "id": "rca:get",
       "pluginAlias": "checkly",
       "pluginName": "checkly",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
       "coreCommand": false,
-      "readOnly": false,
+      "readOnly": true,
       "destructive": false,
-      "idempotent": false,
+      "idempotent": true,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "import",
-        "commit.js"
+        "rca",
+        "get.js"
       ]
     },
-    "import:plan": {
+    "rca:run": {
       "aliases": [],
-      "args": {
-        "resource": {
-          "description": "A specific resource to import.",
-          "name": "resource",
-          "required": false
-        }
-      },
-      "description": "Import existing resources from your Checkly account to your project.\n\nBy default, all resources that can be imported will be imported. However, you\nmay fine-tune the process by including or excluding any combination of\nresources.\n\nThe import process consists of three steps:\n\n1. Creating a plan, which generates the appropriate code for your resources\n2. Applying the plan, which links your resources to the generated code\n3. Committing the plan, which finalizes the import session\n\nCREATING A PLAN\n\nCreating a plan carries no risk as no concrete links to your Checkly resources\nare made at this point. However, if you accidentally deploy the generated code\nbefore applying the plan, you will end up with duplicate resources and will\nnot be able to complete the import session without first deleting the\nduplicates.\n\nFor the curious, you may also preview the generated code with the '--preview'\noption. No plan will be created, allowing you to leisurely inspect the\ngenerated code. However keep in mind that you will need to create a plan to\nactually import any resources, at which point the code will be generated\nagain.\n\nYou may cancel any plan you've created without affecting any of the\nunderlying resources.\n\nAPPLYING A PLAN\n\nApplying a plan links your existing resources to the generated code. You\nshould carefully review the generated code to make sure that it contains the\nresources you expect before applying a plan. After a plan has been applied,\nany deployments of those resources will irreversibly modify the underlying\nCheckly resources. However, as a fail safe against concurrent use, any\ndeployments not including the imported resources will not delete the\nunderlying resources (or the links to the resources). This means that there\nis no need to block deployments while working on an import session.\n\nEven after you've applied a plan, you may still cancel it, which will unlink\nthe underlying resources from your project once more. However, keep in mind\nthat any changes to the resources that you've already deployed cannot be\nundone.\n\nCOMMITTING A PLAN\n\nFinally, committing a plan removes all fail safes and permanently links the\nimported resources to your project. Any resources you remove from your code\nwill result in the underlying resources also getting irrevocably deleted on\nthe next deploy. You should only commit your plan once you are sure that all\nfuture deployments include the imported resources.",
+      "args": {},
+      "description": "Trigger a root cause analysis for an error group.",
       "flags": {
-        "config": {
-          "char": "c",
-          "description": "The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.",
-          "name": "config",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "root": {
-          "description": "The root folder in which to write generated code files.",
-          "name": "root",
-          "default": "__checks__",
+        "error-group": {
+          "char": "e",
+          "description": "The error group ID to analyze.",
+          "name": "error-group",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "preview": {
-          "description": "Preview generated code without creating an actual import plan.",
-          "name": "preview",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "debug-import-plan": {
-          "description": "Output the import plan to a file.",
-          "hidden": true,
-          "name": "debug-import-plan",
+        "watch": {
+          "char": "w",
+          "description": "Wait for the analysis to complete and display the result.",
+          "name": "watch",
           "allowNo": false,
           "type": "boolean"
         },
-        "debug-import-plan-input-file": {
-          "description": "A file to load an import plan from.",
-          "hidden": true,
-          "name": "debug-import-plan-input-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "debug-import-plan-output-file": {
-          "description": "The file to output the import plan to.",
-          "hidden": true,
-          "name": "debug-import-plan-output-file",
-          "default": "./debug-import-plan.json",
+        "output": {
+          "char": "o",
+          "description": "Output format.",
+          "name": "output",
+          "default": "detail",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "detail",
+            "json",
+            "md"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hidden": false,
-      "hiddenAliases": [
-        "import"
-      ],
-      "id": "import:plan",
+      "hiddenAliases": [],
+      "id": "rca:run",
       "pluginAlias": "checkly",
       "pluginName": "checkly",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "coreCommand": false,
-      "readOnly": true,
+      "readOnly": false,
       "destructive": false,
-      "idempotent": true,
+      "idempotent": false,
       "isESM": false,
       "relativePath": [
         "dist",
         "commands",
-        "import",
-        "plan.js"
+        "rca",
+        "run.js"
       ]
     },
     "skills": {
@@ -2450,5 +2618,5 @@
       ]
     }
   },
-  "version": "7.7.0"
+  "version": "7.8.0-prerelease-9bdcdb2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "checkly",
-  "version": "7.7.0",
+  "version": "7.8.0-prerelease-9bdcdb2",
   "description": "Checkly CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -79,6 +79,9 @@
       "import": {
         "description": "Import existing resources from your Checkly account to your project."
       },
+      "rca": {
+        "description": "Trigger and retrieve root cause analyses."
+      },
       "status-pages": {
         "description": "List and manage status pages in your Checkly account."
       }