@bussolabs/closeyourit-cli 0.0.16 → 0.0.18

package/dist/commands/ideas/case-delete.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class IdeasCaseDelete extends base_1.BaseCommand {
+    static args = {
+        idea: core_1.Args.string({ description: 'Idea id', required: true }),
+        case: core_1.Args.string({ description: 'Case id', required: true }),
+    };
+    static description = 'Delete a case from an open idea (author always allowed, others need ideas.edit)';
+    static examples = [
+        '<%= config.bin %> ideas case-delete <idea-id> <case-id> --project acme-api --confirm',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the irreversible deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(IdeasCaseDelete);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm (the action is irreversible).', { exit: 2 });
+        }
+        const projectId = await this.resolveProjectId(flags.project);
+        await this.api.delete(`/cli/v1/projects/${projectId}/ideas/${args.idea}/cases/${args.case}`);
+        if (!this.jsonEnabled())
+            this.log(`Deleted case ${args.case}`);
+        return { deleted: args.case };
+    }
+}
+exports.default = IdeasCaseDelete;

package/dist/commands/ideas/case-update.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base';
+export default class IdeasCaseUpdate extends BaseCommand {
+    static args: {
+        idea: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        case: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/ideas/case-update.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class IdeasCaseUpdate extends base_1.BaseCommand {
+    // PATCH /cli/v1/projects/:p/ideas/:idea_id/cases/:id maps to Ideas::UpdateCase (only open ideas;
+    // same gate as editing the idea — author, otherwise `ideas.edit`). The CLI transport speaks PUT,
+    // which the Rails `resources :cases` update action accepts just like PATCH; only the passed fields
+    // are sent so the backend rewrites nothing you did not touch.
+    static args = {
+        idea: core_1.Args.string({ description: 'Idea id', required: true }),
+        case: core_1.Args.string({ description: 'Case id', required: true }),
+    };
+    static description = 'Update a case (example/scenario) of an idea (title and/or description)';
+    static examples = [
+        '<%= config.bin %> ideas case-update <idea-id> <case-id> --project acme-api --title "QR check-in"',
+        '<%= config.bin %> ideas case-update <idea-id> <case-id> -p acme-api --description "Staff scans the QR at the door"',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        title: core_1.Flags.string({ description: 'New case title' }),
+        description: core_1.Flags.string({ description: 'New case description' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(IdeasCaseUpdate);
+        const projectId = await this.resolveProjectId(flags.project);
+        const body = {};
+        if (flags.title !== undefined)
+            body.title = flags.title;
+        if (flags.description !== undefined)
+            body.description = flags.description;
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/ideas/${args.idea}/cases/${args.case}`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Case updated:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = IdeasCaseUpdate;

package/dist/commands/ideas/delete.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base';
+export default class IdeasDelete extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/ideas/delete.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class IdeasDelete extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Idea id', required: true }),
+    };
+    static description = 'Delete an idea (author always allowed; others need ideas.delete)';
+    static examples = ['<%= config.bin %> ideas delete <idea-id> --project acme-api --confirm'];
+    static flags = {
+        ...base_1.projectFlag,
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the irreversible deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(IdeasDelete);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm (the action is irreversible).', { exit: 2 });
+        }
+        const projectId = await this.resolveProjectId(flags.project);
+        await this.api.delete(`/cli/v1/projects/${projectId}/ideas/${args.id}`);
+        if (!this.jsonEnabled())
+            this.log(`Deleted idea ${args.id}`);
+        return { deleted: args.id };
+    }
+}
+exports.default = IdeasDelete;

package/dist/commands/ideas/unarchive.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class IdeasUnarchive extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/ideas/unarchive.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class IdeasUnarchive extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Idea id', required: true }),
+    };
+    static description = 'Reopen an archived idea (archived → open; author always allowed, others need ideas.edit)';
+    static examples = ['<%= config.bin %> ideas unarchive <idea-id> --project acme-api'];
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(IdeasUnarchive);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.delete(`/cli/v1/projects/${projectId}/ideas/${args.id}/archive`);
+        if (!this.jsonEnabled()) {
+            this.log(`Reopened idea ${args.id}:`);
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = IdeasUnarchive;

package/dist/commands/logs/link.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class LogsLink extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        to: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/logs/link.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class LogsLink extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Log entry id', required: true }),
+    };
+    static description = 'Manually link a log entry to an error group or a ticket';
+    static examples = [
+        '<%= config.bin %> logs link <log-entry-id> --to "Errors::Group:<uuid>"',
+        '<%= config.bin %> logs link <log-entry-id> --to "Ticketing::Ticket:<uuid>"',
+    ];
+    static flags = {
+        to: core_1.Flags.string({
+            description: 'Target to link: "Errors::Group:<uuid>" or "Ticketing::Ticket:<uuid>"',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(LogsLink);
+        const res = await this.api.post(`/cli/v1/log_entries/${args.id}/links`, {
+            linkable: flags.to,
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`Linked log ${args.id} to ${flags.to}:`);
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = LogsLink;

package/dist/commands/logs/show.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class LogsShow extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<unknown>;
+}

package/dist/commands/logs/show.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class LogsShow extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Log entry id', required: true }),
+    };
+    static description = 'Show a single log entry (attributes, trace id, correlation)';
+    static examples = ['<%= config.bin %> logs show <log-entry-id>'];
+    async run() {
+        const { args } = await this.parse(LogsShow);
+        const res = await this.api.get(`/cli/v1/log_entries/${args.id}`);
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = LogsShow;

package/dist/commands/logs/unlink.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base';
+export default class LogsUnlink extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        link: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/logs/unlink.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class LogsUnlink extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Log entry id', required: true }),
+        link: core_1.Args.string({ description: 'Link id to remove', required: true }),
+    };
+    static description = 'Remove a manual log↔target link (irreversible)';
+    static examples = ['<%= config.bin %> logs unlink <log-entry-id> <link-id> --confirm'];
+    static flags = {
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the irreversible deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(LogsUnlink);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm (the action is irreversible).', { exit: 2 });
+        }
+        await this.api.delete(`/cli/v1/log_entries/${args.id}/links/${args.link}`);
+        if (!this.jsonEnabled())
+            this.log(`Removed link ${args.link} from log ${args.id}`);
+        return { deleted: args.link };
+    }
+}
+exports.default = LogsUnlink;

package/dist/commands/members/remove.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class MembersRemove extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/members/remove.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class MembersRemove extends base_1.BaseCommand {
+    // Remove the membership from the organization (the account survives, it just loses access to this org).
+    // The backend gates `members.manage`. Irreversible → requires --confirm. The arg is the MEMBERSHIP id.
+    static description = 'Remove a member from your organization (irreversible; requires members.manage)';
+    static examples = ['<%= config.bin %> members remove <membership-id> --confirm'];
+    static args = {
+        id: core_1.Args.string({ description: 'Membership id', required: true }),
+    };
+    static flags = {
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the irreversible removal' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MembersRemove);
+        if (!flags.confirm) {
+            this.error('Refusing to remove without --confirm (the action is irreversible).', { exit: 2 });
+        }
+        await this.api.delete(`/cli/v1/members/${encodeURIComponent(args.id)}`);
+        if (!this.jsonEnabled())
+            this.log(`Removed member ${args.id}`);
+        return { removed: args.id };
+    }
+}
+exports.default = MembersRemove;

package/dist/commands/members/set-access.d.ts

@@ -8,6 +8,10 @@ export default class MembersSetAccess extends BaseCommand {
     static flags: {
         group: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
+        'role-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        override: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<unknown>;
+    /** Parse repeated `key=allow|deny|inherit` entries into a `{key: value}` map; usage error on a bad entry. */
+    private parseOverrides;
 }

package/dist/commands/members/set-access.js

@@ -4,12 +4,16 @@ const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
 const output_1 = require("../../lib/output");
 class MembersSetAccess extends base_1.BaseCommand {
-    // Full replace: the groups/projects you pass become the member's complete access set.
-    // Omit --group / --project to clear that dimension (an empty array is sent).
-    static description = "Set a member's group and project access (replaces the current set; omit a flag to clear it)";
+    // Scope (groups/projects): FULL REPLACE — the ids you pass become the member's complete access set;
+    // omit --group / --project to clear that dimension (an empty array is always sent).
+    // Roles/overrides: applied ONLY when their flag is passed (a client sending just --group/--project
+    // never clears roles or overrides). --role-id is a full-replace of the direct roles; --override is a
+    // full-replace of the personal allow/deny overrides ("inherit" removes the override for that key).
+    static description = "Set a member's access: group/project scope, direct roles, and permission overrides";
     static examples = [
         '<%= config.bin %> members set-access <membership-id> --project acme-api --project acme-web',
-        '<%= config.bin %> members set-access <membership-id> --group DriverOne',
+        '<%= config.bin %> members set-access <membership-id> --group DriverOne --role-id Maintainer',
+        '<%= config.bin %> members set-access <membership-id> --override tickets.edit=allow --override errors.triage=deny',
         '<%= config.bin %> members set-access <membership-id>',
     ];
     static args = {
@@ -26,13 +30,29 @@ class MembersSetAccess extends base_1.BaseCommand {
             multiple: true,
             default: [],
         }),
+        'role-id': core_1.Flags.string({
+            description: 'Direct role id or name (repeatable; when passed, replaces the direct roles set)',
+            multiple: true,
+        }),
+        override: core_1.Flags.string({
+            description: 'Permission override "permission.key=allow|deny|inherit" (repeatable; when passed, replaces the overrides)',
+            multiple: true,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(MembersSetAccess);
+        // Scope is always sent (full-replace / clear). Roles & overrides only when their flag is present,
+        // so this mirrors the backend `params.key?`-gated apply and never clears what the caller omitted.
         const body = {
             group_ids: await this.resolveAll(flags.group, (v) => this.resolveGroupId(v)),
             project_ids: await this.resolveAll(flags.project, (v) => this.resolveProjectId(v)),
         };
+        if (flags['role-id'] !== undefined) {
+            body.role_ids = await this.resolveAll(flags['role-id'], (v) => this.resolveRoleId(v));
+        }
+        if (flags.override !== undefined) {
+            body.overrides = this.parseOverrides(flags.override);
+        }
         const res = await this.api.put(`/cli/v1/members/${encodeURIComponent(args.id)}/access`, body);
         if (!this.jsonEnabled()) {
             this.log('Member access updated:');
@@ -40,5 +60,19 @@ class MembersSetAccess extends base_1.BaseCommand {
         }
         return res;
     }
+    /** Parse repeated `key=allow|deny|inherit` entries into a `{key: value}` map; usage error on a bad entry. */
+    parseOverrides(entries) {
+        const out = {};
+        for (const entry of entries) {
+            const eq = entry.indexOf('=');
+            const key = eq === -1 ? '' : entry.slice(0, eq).trim();
+            const value = eq === -1 ? '' : entry.slice(eq + 1).trim();
+            if (!key || !['allow', 'deny', 'inherit'].includes(value)) {
+                this.error(`Invalid --override "${entry}". Use "permission.key=allow|deny|inherit".`, { exit: 2 });
+            }
+            out[key] = value;
+        }
+        return out;
+    }
 }
 exports.default = MembersSetAccess;

package/dist/commands/members/update.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base';
+export default class MembersUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        email: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        handle: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/members/update.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class MembersUpdate extends base_1.BaseCommand {
+    // Update the member's account profile (name/email/handle). email/handle are GLOBAL credentials.
+    // Only the flags you pass are sent. The backend gates `members.edit` and protects privileged targets
+    // (owner/god) from non-privileged actors. The arg is the MEMBERSHIP id (like set-role/set-access).
+    static description = "Update a member's profile: name, email, handle (requires members.edit)";
+    static examples = [
+        '<%= config.bin %> members update <membership-id> --name "Ada Lovelace"',
+        '<%= config.bin %> members update <membership-id> --email ada@acme.test --handle ada',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Membership id', required: true }),
+    };
+    static flags = {
+        name: core_1.Flags.string({ description: 'New display name' }),
+        email: core_1.Flags.string({ description: 'New email (global credential)' }),
+        handle: core_1.Flags.string({ description: 'New handle (global; a-z, 0-9, underscore)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MembersUpdate);
+        const body = {};
+        if (flags.name !== undefined)
+            body.name = flags.name;
+        if (flags.email !== undefined)
+            body.email = flags.email;
+        if (flags.handle !== undefined)
+            body.handle = flags.handle;
+        const res = await this.api.put(`/cli/v1/members/${encodeURIComponent(args.id)}`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Member updated:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = MembersUpdate;

package/dist/commands/monitors/announcements/clear.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base';
+export default class MonitorsAnnouncementsClear extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        monitor: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/monitors/announcements/clear.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+class MonitorsAnnouncementsClear extends base_1.BaseCommand {
+    static description = 'Remove the status page announcement banner for a monitor';
+    static examples = ['<%= config.bin %> monitors announcements clear <monitor-id> --project acme-api --confirm'];
+    static args = {
+        monitor: core_1.Args.string({ description: 'Monitor id', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the removal' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MonitorsAnnouncementsClear);
+        if (!flags.confirm) {
+            this.error('Refusing to clear the announcement without --confirm.', { exit: 2 });
+        }
+        const projectId = await this.resolveProjectId(flags.project);
+        await this.api.delete(`/cli/v1/projects/${encodeURIComponent(projectId)}/monitors/${encodeURIComponent(args.monitor)}/announcement`);
+        if (!this.jsonEnabled())
+            this.log(`Cleared announcement for monitor ${args.monitor}`);
+        return { cleared: args.monitor };
+    }
+}
+exports.default = MonitorsAnnouncementsClear;

package/dist/commands/monitors/announcements/set.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../../base';
+export default class MonitorsAnnouncementsSet extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        monitor: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        level: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        message: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'starts-at': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'ends-at': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        active: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/monitors/announcements/set.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+const output_1 = require("../../../lib/output");
+class MonitorsAnnouncementsSet extends base_1.BaseCommand {
+    static description = 'Upsert the status page announcement banner for a monitor';
+    static examples = [
+        '<%= config.bin %> monitors announcements set <monitor-id> --project acme-api --level maintenance --message "Scheduled DB upgrade"',
+        '<%= config.bin %> 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',
+    ];
+    static args = {
+        monitor: core_1.Args.string({ description: 'Monitor id', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        level: core_1.Flags.string({ description: 'Banner level', options: ['info', 'maintenance', 'warning'] }),
+        message: core_1.Flags.string({ description: 'Banner message' }),
+        'starts-at': core_1.Flags.string({ description: 'Start time (ISO 8601)' }),
+        'ends-at': core_1.Flags.string({ description: 'End time (ISO 8601)' }),
+        active: core_1.Flags.boolean({ allowNo: true, description: 'Whether the banner is active' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MonitorsAnnouncementsSet);
+        const projectId = await this.resolveProjectId(flags.project);
+        const body = {};
+        if (flags.level !== undefined)
+            body.level = flags.level;
+        if (flags.message !== undefined)
+            body.message = flags.message;
+        if (flags['starts-at'] !== undefined)
+            body.starts_at = flags['starts-at'];
+        if (flags['ends-at'] !== undefined)
+            body.ends_at = flags['ends-at'];
+        if (flags.active !== undefined)
+            body.active = flags.active;
+        const res = await this.api.put(`/cli/v1/projects/${encodeURIComponent(projectId)}/monitors/${encodeURIComponent(args.monitor)}/announcement`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Announcement saved:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = MonitorsAnnouncementsSet;

package/dist/commands/monitors/announcements/show.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../../base';
+export default class MonitorsAnnouncementsShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        monitor: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/monitors/announcements/show.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+const output_1 = require("../../../lib/output");
+class MonitorsAnnouncementsShow extends base_1.BaseCommand {
+    static description = 'Show the status page announcement banner for a monitor (null if none)';
+    static examples = ['<%= config.bin %> monitors announcements show <monitor-id> --project acme-api'];
+    static args = {
+        monitor: core_1.Args.string({ description: 'Monitor id', required: true }),
+    };
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(MonitorsAnnouncementsShow);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.get(`/cli/v1/projects/${encodeURIComponent(projectId)}/monitors/${encodeURIComponent(args.monitor)}/announcement`);
+        if (!this.jsonEnabled()) {
+            const announcement = res.data;
+            this.log(announcement ? (0, output_1.renderRecord)(announcement) : 'No announcement set.');
+        }
+        return res;
+    }
+}
+exports.default = MonitorsAnnouncementsShow;

package/dist/commands/monitors/create.d.ts

@@ -11,6 +11,7 @@ export default class MonitorsCreate extends BaseCommand {
         'timeout-seconds': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'expected-body-keyword': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'ssl-expiry-warn-days': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'group-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<unknown>;