checkly 7.7.0-prerelease-a0c39b4 → 7.7.0

package/dist/ai-context/checkly.rules.md

@@ -115,6 +115,18 @@ Email (`EmailAlertChannel`), Phone (`PhoneCallAlertChannel`), and Slack (`SlackA
 ### `npx checkly skills configure supporting-constructs`
 Status pages (`StatusPage`), dashboards (`Dashboard`), maintenance windows (`MaintenanceWindow`), and private locations (`PrivateLocation`)
 
+## Check Locations and Plan Entitlements
+
+Not all features and locations are available on all plans. **Before configuring checks, run:**
+
+```bash
+npx checkly account plan --output json
+```
+
+This returns your exact entitlements and available locations. Use only locations where `available` is `true` in the `locations.all` array. If a feature is disabled, the response includes an `upgradeUrl` to share with the user.
+
+Run `npx checkly skills manage plan` for the full reference.
+
 ## Testing and Debugging
 
 - Test checks using the `npx checkly test` command. Pass environment variables with the `-e` flag, use `--record` to persist results, and use `--verbose` to see all errors.

package/dist/ai-context/context.d.ts

@@ -43,6 +43,10 @@ export declare const COMMUNICATE_REFERENCES: readonly [{
     readonly id: "communicate-incidents";
     readonly description: "Incident lifecycle (`incidents create`, `update`, `resolve`, `list`) and status pages";
 }];
+export declare const MANAGE_REFERENCES: readonly [{
+    readonly id: "manage-plan";
+    readonly description: "Check account plan, entitlements, feature limits, and available locations (`account plan`)";
+}];
 export declare const SKILL: {
     readonly name: "checkly";
     readonly description: "Get all the information and context to let your agent initialize, set up, create, test and manage your monitoring checks using the Checkly CLI.";
@@ -104,6 +108,13 @@ export declare const ACTIONS: readonly [{
         readonly id: "communicate-incidents";
         readonly description: "Incident lifecycle (`incidents create`, `update`, `resolve`, `list`) and status pages";
     }];
+}, {
+    readonly id: "manage";
+    readonly description: "Understand your account plan, entitlements, and feature limits.";
+    readonly references: readonly [{
+        readonly id: "manage-plan";
+        readonly description: "Check account plan, entitlements, feature limits, and available locations (`account plan`)";
+    }];
 }];
 interface ExampleConfig {
     templateString: string;

package/dist/ai-context/context.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EXAMPLE_CONFIGS = exports.ACTIONS = exports.SKILL = exports.COMMUNICATE_REFERENCES = exports.INVESTIGATE_REFERENCES = exports.REFERENCES = void 0;
+exports.EXAMPLE_CONFIGS = exports.ACTIONS = exports.SKILL = exports.MANAGE_REFERENCES = exports.COMMUNICATE_REFERENCES = exports.INVESTIGATE_REFERENCES = exports.REFERENCES = void 0;
 exports.REFERENCES = [
     {
         id: 'configure-api-checks',
@@ -63,6 +63,12 @@ exports.COMMUNICATE_REFERENCES = [
         description: 'Incident lifecycle (`incidents create`, `update`, `resolve`, `list`) and status pages',
     },
 ];
+exports.MANAGE_REFERENCES = [
+    {
+        id: 'manage-plan',
+        description: 'Check account plan, entitlements, feature limits, and available locations (`account plan`)',
+    },
+];
 exports.SKILL = {
     name: 'checkly',
     description: 'Get all the information and context to let your agent initialize, set up, create, test and manage your monitoring checks using the Checkly CLI.',
@@ -87,6 +93,11 @@ exports.ACTIONS = [
         description: 'Open incidents and lead customer communications via status pages.',
         references: exports.COMMUNICATE_REFERENCES,
     },
+    {
+        id: 'manage',
+        description: 'Understand your account plan, entitlements, and feature limits.',
+        references: exports.MANAGE_REFERENCES,
+    },
 ];
 exports.EXAMPLE_CONFIGS = {
     CHECKLY_CONFIG: {

package/dist/ai-context/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/ai-context/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/ai-context/context.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB;QACE,EAAE,EAAE,sBAAsB;QAC1B,WAAW,EAAE,gFAAgF;KAC9F;IACD;QACE,EAAE,EAAE,0BAA0B;QAC9B,WAAW,EAAE,qEAAqE;KACnF;IACD;QACE,EAAE,EAAE,6BAA6B;QACjC,WAAW,EAAE,oFAAoF;KAClG;IACD;QACE,EAAE,EAAE,4BAA4B;QAChC,WAAW,EAAE,qEAAqE;KACnF;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,WAAW,EAAE,sDAAsD;KACpE;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,WAAW,EAAE,sDAAsD;KACpE;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,WAAW,EAAE,sDAAsD;KACpE;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,WAAW,EAAE,gFAAgF;KAC9F;IACD;QACE,EAAE,EAAE,8BAA8B;QAClC,WAAW,EAAE,kDAAkD;KAChE;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,WAAW,EAAE,+DAA+D;KAC7E;IACD;QACE,EAAE,EAAE,0BAA0B;QAC9B,WAAW,EAAE,8GAA8G;KAC5H;IACD;QACE,EAAE,EAAE,iCAAiC;QACrC,WAAW,EAAE,6IAA6I;KAC3J;CACO,CAAA;AAEG,QAAA,sBAAsB,GAAG;IACpC;QACE,EAAE,EAAE,oBAAoB;QACxB,WAAW,EAAE,+EAA+E;KAC7F;CACO,CAAA;AAEG,QAAA,sBAAsB,GAAG;IACpC;QACE,EAAE,EAAE,uBAAuB;QAC3B,WAAW,EAAE,uFAAuF;KACrG;CACO,CAAA;AAEG,QAAA,iBAAiB,GAAG;IAC/B;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,4FAA4F;KAC1G;CACO,CAAA;AAEG,QAAA,KAAK,GAAG;IACnB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,iJAAiJ;CACtJ,CAAA;AAEG,QAAA,OAAO,GAAG;IACrB;QACE,EAAE,EAAE,YAAY;QAChB,WAAW,EAAE,4EAA4E;KAC1F;IACD;QACE,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,wFAAwF;QACrG,UAAU,EAAE,kBAAU;KACvB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE,8BAAsB;KACnC;IACD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,mEAAmE;QAChF,UAAU,EAAE,8BAAsB;KACnC;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,iEAAiE;QAC9E,UAAU,EAAE,yBAAiB;KAC9B;CACO,CAAA;AASG,QAAA,eAAe,GAAkC;IAC5D,cAAc,EAAE;QACd,cAAc,EAAE,kCAAkC;QAClD,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgClB;QACG,SAAS,EAAE,oDAAoD;KAChE;IACD,aAAa,EAAE;QACb,cAAc,EAAE,iCAAiC;QACjD,iBAAiB,EACf,+EAA+E;QACjF,SAAS,EAAE,0DAA0D;KACtE;IACD,gBAAgB,EAAE;QAChB,cAAc,EAAE,oCAAoC;QACpD,aAAa,EAAE;;;;;;;;;CASlB;QACG,SAAS,EAAE,6DAA6D;KACzE;IACD,SAAS,EAAE;QACT,cAAc,EAAE,6BAA6B;QAC7C,iBAAiB,EACf,mEAAmE;QACrE,SAAS,EAAE,sDAAsD;KAClE;IACD,eAAe,EAAE;QACf,cAAc,EAAE,mCAAmC;QACnD,iBAAiB,EACf,sFAAsF;QACxF,SAAS,EAAE,4DAA4D;KACxE;IACD,WAAW,EAAE;QACX,cAAc,EAAE,+BAA+B;QAC/C,iBAAiB,EAAE,qDAAqD;QACxE,SAAS,EAAE,wDAAwD;KACpE;IACD,iBAAiB,EAAE;QACjB,cAAc,EAAE,qCAAqC;QACrD,iBAAiB,EACf,iEAAiE;QACnE,SAAS,EAAE,8DAA8D;KAC1E;IACD,WAAW,EAAE;QACX,cAAc,EAAE,+BAA+B;QAC/C,iBAAiB,EAAE,qDAAqD;QACxE,SAAS,EAAE,wDAAwD;KACpE;IACD,WAAW,EAAE;QACX,cAAc,EAAE,+BAA+B;QAC/C,iBAAiB,EAAE,qDAAqD;QACxE,SAAS,EAAE,wDAAwD;KACpE;IACD,YAAY,EAAE;QACZ,cAAc,EAAE,gCAAgC;QAChD,iBAAiB,EAAE,uDAAuD;QAC1E,SAAS,EAAE,yDAAyD;KACrE;IACD,WAAW,EAAE;QACX,cAAc,EAAE,+BAA+B;QAC/C,iBAAiB,EACf,4DAA4D;QAC9D,SAAS,EAAE,wDAAwD;KACpE;IACD,WAAW,EAAE;QACX,cAAc,EAAE,+BAA+B;QAC/C,iBAAiB,EAAE,qDAAqD;QACxE,SAAS,EAAE,wDAAwD;KACpE;IACD,mBAAmB,EAAE;QACnB,cAAc,EAAE,uCAAuC;QACvD,iBAAiB,EACf,0DAA0D;QAC5D,SAAS,EAAE,gEAAgE;KAC5E;IACD,SAAS,EAAE;QACT,cAAc,EAAE,6BAA6B;QAC7C,iBAAiB,EACf,mEAAmE;QACrE,SAAS,EAAE,sDAAsD;KAClE;IACD,kBAAkB,EAAE;QAClB,cAAc,EAAE,sCAAsC;QACtD,iBAAiB,EACf,mEAAmE;QACrE,SAAS,EAAE,+DAA+D;KAC3E;IACD,gBAAgB,EAAE;QAChB,cAAc,EAAE,oCAAoC;QACpD,iBAAiB,EACf,+DAA+D;QACjE,SAAS,EAAE,6DAA6D;KACzE;IACD,mBAAmB,EAAE;QACnB,cAAc,EAAE,uCAAuC;QACvD,iBAAiB,EAAE,8CAA8C;QACjE,SAAS,EAAE,gEAAgE;KAC5E;IACD,wBAAwB,EAAE;QACxB,cAAc,EAAE,4CAA4C;QAC5D,iBAAiB,EAAE,wDAAwD;QAC3E,SAAS,EAAE,qEAAqE;KACjF;IACD,mBAAmB,EAAE;QACnB,cAAc,EAAE,uCAAuC;QACvD,iBAAiB,EAAE,iDAAiD;QACpE,SAAS,EAAE,gEAAgE;KAC5E;CACF,CAAA"}

package/dist/ai-context/public-skills/checkly/SKILL.md

@@ -24,6 +24,12 @@ The skill is structured for efficient context usage:
 
 Agents load what they need for each task.
 
+## Plan Awareness
+
+Before configuring checks, run `npx checkly account plan --output json` to see what features, locations, and limits are available on the current plan. Disabled features include an `upgradeUrl` pointing to the self-service checkout page or the enterprise contact sales page — share these with the user when they need a feature that's not on their plan.
+
+Run `npx checkly skills manage` for the full reference.
+
 ## Confirmation Protocol
 
 Write commands (e.g. `incidents create`, `deploy`, `destroy`) return exit code 2 with a `confirmation_required` JSON envelope instead of executing. **Always present the `changes` to the user and wait for approval before running the `confirmCommand`.** Never auto-append `--force`. This applies to every write command individually — updates and resolutions need confirmation too, not just the initial create.
@@ -83,3 +89,9 @@ Open incidents and lead customer communications via status pages.
 
 #### `npx checkly skills communicate incidents`
 Incident lifecycle (`incidents create`, `update`, `resolve`, `list`) and status pages
+
+### `npx checkly skills manage`
+Understand your account plan, entitlements, and feature limits.
+
+#### `npx checkly skills manage plan`
+Check account plan, entitlements, feature limits, and available locations (`account plan`)

package/dist/ai-context/skills-command/references/communicate-incidents.md

@@ -67,9 +67,13 @@ Flags:
 
 ## Status pages
 
-Use `npx checkly status-pages list` to find status page IDs and their services. Use `--output json` to get machine-readable service IDs for incident creation.
+Use `npx checkly status-pages list` to find status page IDs, and `npx checkly status-pages get` for full details including cards and services.
 
 ```bash
 npx checkly status-pages list
 npx checkly status-pages list --output json
+npx checkly status-pages get <status-page-id>
+npx checkly status-pages get <status-page-id> --output json
 ```
+
+Use `--output json` to get machine-readable service IDs for incident creation.

package/dist/ai-context/skills-command/references/configure.md

@@ -115,6 +115,18 @@ Email (`EmailAlertChannel`), Phone (`PhoneCallAlertChannel`), and Slack (`SlackA
 ### `npx checkly skills configure supporting-constructs`
 Status pages (`StatusPage`), dashboards (`Dashboard`), maintenance windows (`MaintenanceWindow`), and private locations (`PrivateLocation`)
 
+## Check Locations and Plan Entitlements
+
+Not all features and locations are available on all plans. **Before configuring checks, run:**
+
+```bash
+npx checkly account plan --output json
+```
+
+This returns your exact entitlements and available locations. Use only locations where `available` is `true` in the `locations.all` array. If a feature is disabled, the response includes an `upgradeUrl` to share with the user.
+
+Run `npx checkly skills manage plan` for the full reference.
+
 ## Testing and Debugging
 
 - Test checks using the `npx checkly test` command. Pass environment variables with the `-e` flag, use `--record` to persist results, and use `--verbose` to see all errors.

package/dist/ai-context/skills-command/references/initialize.md

@@ -70,7 +70,25 @@ Run `npx checkly skills configure alert-channels` to access up-to-date informati
    - **next to the resource** — place the `check.ts` files next to page routes, api endpoints etc.
 
 
-#### Step 3 — Create the config file
+#### Step 3 — Check your account plan
+
+Before writing checks, verify what your account can do:
+
+```bash
+npx checkly account plan --output json
+```
+
+This shows your entitlements, limits, and available locations. Use this data when creating the config:
+
+- **Only use locations** from `locations.all` where `available` is `true`. Using unavailable locations will cause deploy failures.
+- **Check feature availability** before configuring constructs like private locations, advanced alert channels, or higher-frequency schedules.
+- **Respect metered limits** — the `quantity` field shows maximums for each metered feature.
+
+If a feature the user wants is disabled, the response includes an `upgradeUrl` — share it so they can upgrade their plan.
+
+Run `npx checkly skills manage plan` for the full reference.
+
+#### Step 4 — Create the config file
 
 Run the following command to retrieve the configure skill reference:
 
@@ -80,13 +98,13 @@ npx checkly skills configure
 
 Use the output to create a `checkly.config.ts` (or `checkly.config.js` if the user chose JavaScript) in the project root.
 
-Adjust the `checkMatch` property according to previous selection.
+Adjust the `checkMatch` property according to previous selection. Use only locations verified as available in the previous step.
 
 Present the generated configuration to the user and ask if it looks correct. Allow the user to make changes.
 
 Congratulate the user on completing the config. Now it's time to test the configuration and turn everything into monitoring!
 
-#### Step 4: Log in to Checkly CLI
+#### Step 5: Log in to Checkly CLI
 
 To use the Checkly CLI the user needs to be logged in. Run the following command:
 
@@ -101,7 +119,7 @@ If the user is NOT logged in, present two options:
 - **Option A: Interactive login** — The user runs `npx checkly login` themselves. This command opens a browser for OAuth authentication and cannot be completed by an AI agent. Tell the user to run the command, complete the browser flow, and let you know when they're done so you can re-run `npx checkly whoami` to verify.
 - **Option B: Environment variables (recommended for agentic / CI use)** — The user sets `CHECKLY_API_KEY` and `CHECKLY_ACCOUNT_ID` as environment variables. They can create an API key in the Checkly dashboard under **User Settings > API Keys**. Once both variables are set, re-run `npx checkly whoami` to verify.
 
-#### Step 5: Summarize and test the new monitoring configuration
+#### Step 6: Summarize and test the new monitoring configuration
 
 Read the generated `checkly.config.ts` (or `checkly.config.js`) and summarize the configured checks, locations, and frequencies.
 

package/dist/ai-context/skills-command/references/investigate-checks.md

@@ -37,6 +37,28 @@ npx checkly checks get <check-id> --result <result-id>
 npx checkly checks get <check-id> --error-group <error-group-id>
 ```
 
+## Check analytics and stats
+
+```bash
+npx checkly checks stats
+npx checkly checks stats --range last7Days --tag production
+npx checkly checks stats <check-id-1> <check-id-2>
+npx checkly checks stats --output json
+```
+
+Shows availability, response times, error counts, and other metrics for your checks.
+
+Flags:
+- `-r, --range <range>` — time range: `last24Hours` (default), `last7Days`, `thisWeek`, `lastWeek`, `lastMonth`
+- `-t, --tag <tag>` — filter by tag (repeat for multiple)
+- `--type <type>` — filter by check type
+- `-s, --search <name>` — filter by name
+- `-l, --limit <n>` — max checks to return (1-100, default 25)
+- `-p, --page <n>` — page number
+- `-o, --output <format>` — `table` (default), `json`, or `md`
+
+Pass one or more check IDs as positional arguments to get stats for specific checks only.
+
 ## Trigger checks
 
 ```bash

package/dist/ai-context/skills-command/references/manage-plan.md

@@ -0,0 +1,49 @@
+# Account Plan and Entitlements
+
+Show your account plan, entitlements, feature limits, and available locations.
+
+## Usage
+
+```bash
+npx checkly account plan                          # Summary view (metered limits + flag count)
+npx checkly account plan --output json             # Full JSON (recommended for agents)
+npx checkly account plan --disabled                # Show only features not on your plan
+npx checkly account plan --disabled --type flag    # Disabled flags only
+npx checkly account plan --type metered            # Metered limits only
+npx checkly account plan --search "browser"        # Search by name or description
+npx checkly account plan BROWSER_CHECKS            # Detail view for one entitlement
+npx checkly account plan --help                    # Full flag reference
+```
+
+## JSON response shape (abbreviated)
+
+```json
+{
+  "plan": "hobby",
+  "planDisplayName": "Hobby",
+  "checkoutUrl": "https://app.checklyhq.com/accounts/.../billing/checkout",
+  "contactSalesUrl": "https://www.checklyhq.com/contact-sales/",
+  "locations": {
+    "all": [
+      { "id": "us-east-1", "name": "N. Virginia", "available": true },
+      { "id": "eu-west-1", "name": "Ireland", "available": false }
+    ],
+    "maxPerCheck": 3
+  },
+  "entitlements": [
+    { "key": "BROWSER_CHECKS", "type": "metered", "enabled": true, "quantity": 10 },
+    {
+      "key": "PRIVATE_LOCATIONS", "type": "metered", "enabled": false,
+      "requiredPlan": "TEAM", "requiredPlanDisplayName": "Team",
+      "upgradeUrl": "https://app.checklyhq.com/accounts/.../billing/checkout"
+    }
+  ]
+}
+```
+
+## How to use this data
+
+1. **Locations:** Filter `locations.all` to entries where `available === true`. Use only those IDs in `checkly.config.ts` and check constructs. Respect `maxPerCheck` as the upper bound per check.
+2. **Metered entitlements:** Check `quantity` for limits. `enabled: false` means the feature is not available.
+3. **Flag entitlements:** `enabled: true` means available, `false` means not on this plan.
+4. **Disabled features:** Each includes an `upgradeUrl`. Share this with the user — it points to the self-service checkout page or the enterprise contact sales page depending on the required plan.

package/dist/ai-context/skills-command/references/manage.md

@@ -0,0 +1,27 @@
+# Account Management
+
+Understand your account's plan, entitlements, and limits.
+
+## Plan-aware workflow
+
+Checkly accounts have different capabilities depending on the plan (Hobby, Starter, Team, Enterprise) and add-ons (Communicate, Resolve). Features like locations, retry strategies, frequencies, and alert channels vary by plan.
+
+**Before writing or modifying checks, run:**
+
+```bash
+npx checkly account plan --output json
+```
+
+This returns your entitlements (enabled/disabled with limits), available locations, and upgrade URLs. Use this to:
+
+- **Filter locations** to only those where `available` is `true` in `locations.all`
+- **Check feature flags** before using constructs (e.g. private locations, advanced alert channels)
+- **Respect metered limits** (e.g. max browser checks, max alert channels)
+- **Surface upgrade paths** when a feature is disabled — each disabled entitlement includes an `upgradeUrl` pointing to the self-service checkout or the contact sales page
+
+## Available Commands
+
+Parse and read further reference documentation for any of the following:
+
+### `npx checkly skills manage plan`
+Check account plan, entitlements, feature limits, and available locations (`account plan`)