@bussolabs/closeyourit-cli 0.14.0 → 0.16.0

package/README.md

@@ -105,6 +105,9 @@ CLOSEYOURIT_TOKEN=cyi_u_… CLOSEYOURIT_API_URL=https://www.closeyour.it \
 | `tickets watch\|unwatch <id> --project <id\|key>` | Watch / stop watching a ticket (its notifications). |
 | `tickets branch <id\|code> --project <id\|key>` | Create a GitHub branch from a ticket (name prefixed with the ticket code). |
 | `tickets pr <id\|code> --project <id\|key>` | Open a GitHub pull request from a ticket (head = the ticket branch). |
+| `tickets lease claim <id\|code> --project <id\|key> [--ttl <seconds>] [--run-id <id>]` | Claim the working lease on a ticket (server default TTL: 8h). Exits non-zero on a 409, naming the current holder and its expiry. |
+| `tickets lease renew <id\|code> --project <id\|key> [--ttl <seconds>] [--run-id <id>]` | Extend your own lease before it expires. |
+| `tickets lease release <id\|code> --project <id\|key> [--run-id <id>]` | Release your own lease so someone else can claim the ticket. |
 | `ideas delete <id> --project <id\|key> --confirm` | Delete an idea (author always allowed; others need ideas.delete). |
 | `ideas archive\|unarchive <id> --project <id\|key>` | Archive an idea (open → archived) / reopen it. |
 | `ideas case-update <idea-id> <case-id> --project <id\|key> [--title] [--description]` | Update a case (example) of an idea. |
@@ -167,6 +170,20 @@ CLOSEYOURIT_TOKEN=cyi_u_… CLOSEYOURIT_API_URL=https://www.closeyour.it \
 | `analytics goals create --project <id\|key> --kind pageview_path\|custom_event --display-name <name> [--event-name] [--path-pattern]` | Create a conversion goal. |
 | `analytics goals delete <id> --project <id\|key> --confirm` | Delete a conversion goal. |
 | `releases list --project <id\|key> [--page]` | List a project's releases (tracked from CI). |
+| `matrix list [--page]` | List the products whose feature × platform matrix you can see. |
+| `matrix show <product>` | Show the matrix: features in rows, platforms in columns, `status version` per cell (`-` = not set, `?` = released without a version). |
+| `matrix statuses` | List the cell statuses of your org (the codes `matrix cells set` accepts). |
+| `matrix categories list <product> [--page]` | List the feature groups of a product. |
+| `matrix categories create <product> --name <name> [--position]` | Create a feature group. |
+| `matrix categories update <product> <id\|name> [--name] [--position]` | Update a feature group (unpassed fields keep their value). |
+| `matrix categories delete <product> <id\|name> --confirm` | Delete a feature group (only when empty). |
+| `matrix features list <product> [--category] [--page]` | List the features; the REFERENCE column is the `Category/Name` form the other commands take. |
+| `matrix features show <product> <id\|"Category/Name">` | Show one feature and the cells written for it. |
+| `matrix features create <product> --category <id\|name> --name <name> [--description] [--position] [--knowledge-page]` | Create a feature (a row of the matrix). |
+| `matrix features update <product> <id\|"Category/Name"> [--name] [--description] [--position] [--category] [--knowledge-page]` | Update a feature, or move it to another category of the same product. |
+| `matrix features delete <product> <id\|"Category/Name"> --confirm` | Delete a feature and every cell written for it. |
+| `matrix cells set <product> <feature> <platform> --status <code> [--release <version>]` | Write a cell: how far along a feature is on a platform, and since which version. |
+| `matrix cells clear <product> <feature> <platform> --confirm` | Clear a cell: the crossing goes back to "not set". |
 | `alerts channels list` | List the external alert channels (webhook / Telegram). |
 | `alerts channels create <name> --kind telegram\|webhook …` | Create a channel (`--bot-token`/`--chat-id` or `--url`/`--secret`). |
 | `alerts channels delete <id> --confirm` | Delete a channel. |

package/dist/commands/matrix/categories/create.d.ts

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

package/dist/commands/matrix/categories/create.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 MatrixCategoriesCreate extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+    };
+    static description = 'Create a feature group (category) in a product matrix';
+    static examples = [
+        '<%= config.bin %> matrix categories create CloseYourIt --name Auth',
+        '<%= config.bin %> matrix categories create CloseYourIt --name Notifications --position 2',
+    ];
+    static flags = {
+        name: core_1.Flags.string({ description: 'Category name (unique within the product)', required: true }),
+        position: core_1.Flags.integer({ description: 'Sort position' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixCategoriesCreate);
+        const productId = await this.resolveGroupId(args.product);
+        const body = { name: flags.name };
+        if (flags.position !== undefined)
+            body.position = flags.position;
+        const res = await this.api.post(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/categories`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Category created:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = MatrixCategoriesCreate;

package/dist/commands/matrix/categories/delete.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base';
+export default class MatrixCategoriesDelete extends BaseCommand {
+    static args: {
+        product: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        category: 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/matrix/categories/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 MatrixCategoriesDelete extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+        category: core_1.Args.string({ description: 'Category id (UUID) or name', required: true }),
+    };
+    static description = 'Delete a feature group (only when empty: move or delete its features first)';
+    static examples = ['<%= config.bin %> matrix categories delete CloseYourIt Auth --confirm'];
+    static flags = {
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixCategoriesDelete);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm.', { exit: 2 });
+        }
+        const productId = await this.resolveGroupId(args.product);
+        await this.api.delete(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/categories/${encodeURIComponent(args.category)}`);
+        if (!this.jsonEnabled())
+            this.log(`Deleted category ${args.category}`);
+        return { deleted: args.category };
+    }
+}
+exports.default = MatrixCategoriesDelete;

package/dist/commands/matrix/categories/list.d.ts

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

package/dist/commands/matrix/categories/list.js

@@ -0,0 +1,27 @@
+"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 MatrixCategoriesList extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+    };
+    static description = 'List the feature groups (categories) of a product matrix';
+    static examples = ['<%= config.bin %> matrix categories list CloseYourIt'];
+    static flags = { ...base_1.pageFlag };
+    async run() {
+        const { args, flags } = await this.parse(MatrixCategoriesList);
+        const productId = await this.resolveGroupId(args.product);
+        const res = await this.api.get(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/categories?page=${flags.page}`);
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['NAME', 'POSITION', 'ID'], (res.data ?? []).map((category) => [
+                String(category.name ?? ''),
+                String(category.position ?? ''),
+                String(category.id ?? ''),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = MatrixCategoriesList;

package/dist/commands/matrix/categories/update.d.ts

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

package/dist/commands/matrix/categories/update.js

@@ -0,0 +1,37 @@
+"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 MatrixCategoriesUpdate extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+        category: core_1.Args.string({ description: 'Category id (UUID) or name', required: true }),
+    };
+    static description = 'Update a feature group (rename or reorder); unpassed fields keep their value';
+    static examples = [
+        '<%= config.bin %> matrix categories update CloseYourIt Auth --name "Access"',
+        '<%= config.bin %> matrix categories update CloseYourIt Auth --position 1',
+    ];
+    static flags = {
+        name: core_1.Flags.string({ description: 'New name' }),
+        position: core_1.Flags.integer({ description: 'Sort position' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixCategoriesUpdate);
+        const productId = await this.resolveGroupId(args.product);
+        const body = {};
+        if (flags.name !== undefined)
+            body.name = flags.name;
+        if (flags.position !== undefined)
+            body.position = flags.position;
+        // The backend resolves the category by id-or-name within the product, so pass it through.
+        const res = await this.api.put(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/categories/${encodeURIComponent(args.category)}`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Category updated:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = MatrixCategoriesUpdate;

package/dist/commands/matrix/cells/clear.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../../base';
+export default class MatrixCellsClear extends BaseCommand {
+    static args: {
+        product: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        feature: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        platform: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    /**
+     * "Not set" is not the same as "not applicable": the latter is an explicit status you write with
+     * `matrix cells set`. Clearing throws away the status and the version, hence --confirm.
+     */
+    static description: string;
+    static examples: string[];
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/matrix/cells/clear.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+class MatrixCellsClear extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+        feature: core_1.Args.string({ description: 'Feature id (UUID) or "Category/Name"', required: true }),
+        platform: core_1.Args.string({ description: 'Platform id (UUID) or code (e.g. web, ios)', required: true }),
+    };
+    /**
+     * "Not set" is not the same as "not applicable": the latter is an explicit status you write with
+     * `matrix cells set`. Clearing throws away the status and the version, hence --confirm.
+     */
+    static description = 'Clear a matrix cell: the crossing goes back to "not set"';
+    static examples = ['<%= config.bin %> matrix cells clear CloseYourIt "Auth/2FA" web --confirm'];
+    static flags = {
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm clearing the cell' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixCellsClear);
+        if (!flags.confirm) {
+            this.error('Refusing to clear without --confirm.', { exit: 2 });
+        }
+        const productId = await this.resolveGroupId(args.product);
+        const path = `/cli/v1/product/matrix/${encodeURIComponent(productId)}` +
+            `/features/${encodeURIComponent(args.feature)}/cells/${encodeURIComponent(args.platform)}`;
+        await this.api.delete(path);
+        if (!this.jsonEnabled())
+            this.log(`Cleared ${args.feature} on ${args.platform}`);
+        return { cleared: { feature: args.feature, platform: args.platform } };
+    }
+}
+exports.default = MatrixCellsClear;

package/dist/commands/matrix/cells/set.d.ts

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

package/dist/commands/matrix/cells/set.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+class MatrixCellsSet extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+        feature: core_1.Args.string({ description: 'Feature id (UUID) or "Category/Name"', required: true }),
+        platform: core_1.Args.string({ description: 'Platform id (UUID) or code (e.g. web, ios)', required: true }),
+    };
+    static description = 'Write a matrix cell: how far along a feature is on a platform, and since which version';
+    static examples = [
+        '<%= config.bin %> matrix cells set CloseYourIt "Auth/2FA" web --status available --release 2.1.0',
+        '<%= config.bin %> matrix cells set CloseYourIt "Auth/2FA" ios --status planned',
+    ];
+    static flags = {
+        status: core_1.Flags.string({ description: 'Status code (see: matrix statuses) or id', required: true }),
+        release: core_1.Flags.string({
+            description: 'Version the feature became available in (a registered release of the product on that platform)',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixCellsSet);
+        const productId = await this.resolveGroupId(args.product);
+        const body = { status: flags.status };
+        if (flags.release !== undefined)
+            body.release = flags.release;
+        const path = `/cli/v1/product/matrix/${encodeURIComponent(productId)}` +
+            `/features/${encodeURIComponent(args.feature)}/cells/${encodeURIComponent(args.platform)}`;
+        const res = await this.api.put(path, body);
+        if (!this.jsonEnabled()) {
+            // What was saved, in the words the command took: status and release are nested objects, so a
+            // flat record dump would drop exactly the two values the user just set.
+            const cell = res.data ?? {};
+            const where = cell.platform_code ?? args.platform;
+            const version = cell.release?.version ?? (cell.release_missing ? 'no version set' : 'no version');
+            this.log(`Saved: ${args.feature} on ${where} → ${cell.status?.code ?? flags.status} (${version})`);
+        }
+        return res;
+    }
+}
+exports.default = MatrixCellsSet;

package/dist/commands/matrix/features/create.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../base';
+export default class MatrixFeaturesCreate extends BaseCommand {
+    static args: {
+        product: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        position: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'knowledge-page': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/matrix/features/create.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 MatrixFeaturesCreate extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+    };
+    static description = 'Create a feature (a row of the matrix) inside a category';
+    static examples = [
+        '<%= config.bin %> matrix features create CloseYourIt --category Auth --name "2FA"',
+        '<%= config.bin %> matrix features create CloseYourIt --category Auth --name "Apple login" --knowledge-page <page-id>',
+    ];
+    static flags = {
+        category: core_1.Flags.string({ description: 'Category id (UUID) or name', required: true }),
+        name: core_1.Flags.string({ description: 'Feature name (unique within the category)', required: true }),
+        description: core_1.Flags.string({ description: 'What the feature does' }),
+        position: core_1.Flags.integer({ description: 'Sort position' }),
+        'knowledge-page': core_1.Flags.string({ description: 'Knowledge page id explaining the feature' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixFeaturesCreate);
+        const productId = await this.resolveGroupId(args.product);
+        const body = { category: flags.category, name: flags.name };
+        if (flags.description !== undefined)
+            body.description = flags.description;
+        if (flags.position !== undefined)
+            body.position = flags.position;
+        if (flags['knowledge-page'] !== undefined)
+            body.knowledge_page_id = flags['knowledge-page'];
+        const res = await this.api.post(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/features`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Feature created:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = MatrixFeaturesCreate;

package/dist/commands/matrix/features/delete.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base';
+export default class MatrixFeaturesDelete extends BaseCommand {
+    static args: {
+        product: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        feature: 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/matrix/features/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 MatrixFeaturesDelete extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+        feature: core_1.Args.string({ description: 'Feature id (UUID) or "Category/Name"', required: true }),
+    };
+    static description = 'Delete a feature and every cell written for it (irreversible)';
+    static examples = ['<%= config.bin %> matrix features delete CloseYourIt "Auth/2FA" --confirm'];
+    static flags = {
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixFeaturesDelete);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm.', { exit: 2 });
+        }
+        const productId = await this.resolveGroupId(args.product);
+        await this.api.delete(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/features/${encodeURIComponent(args.feature)}`);
+        if (!this.jsonEnabled())
+            this.log(`Deleted feature ${args.feature}`);
+        return { deleted: args.feature };
+    }
+}
+exports.default = MatrixFeaturesDelete;

package/dist/commands/matrix/features/list.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base';
+export default class MatrixFeaturesList extends BaseCommand {
+    static args: {
+        product: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/matrix/features/list.js

@@ -0,0 +1,35 @@
+"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 MatrixFeaturesList extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+    };
+    static description = 'List the features of a product matrix';
+    static examples = [
+        '<%= config.bin %> matrix features list CloseYourIt',
+        '<%= config.bin %> matrix features list CloseYourIt --category Auth',
+    ];
+    static flags = {
+        ...base_1.pageFlag,
+        category: core_1.Flags.string({ description: 'Only the features of this category (id or name)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixFeaturesList);
+        const productId = await this.resolveGroupId(args.product);
+        const query = flags.category ? `&category=${encodeURIComponent(flags.category)}` : '';
+        const res = await this.api.get(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/features?page=${flags.page}${query}`);
+        if (!this.jsonEnabled()) {
+            // REFERENCE is the `Category/Name` form every other matrix command accepts.
+            this.log((0, output_1.renderTable)(['REFERENCE', 'DESCRIPTION', 'ID'], (res.data ?? []).map((feature) => [
+                `${String(feature.category_name ?? '')}/${String(feature.name ?? '')}`,
+                String(feature.description ?? ''),
+                String(feature.id ?? ''),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = MatrixFeaturesList;

package/dist/commands/matrix/features/show.d.ts

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

package/dist/commands/matrix/features/show.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 MatrixFeaturesShow extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+        feature: core_1.Args.string({ description: 'Feature id (UUID) or "Category/Name"', required: true }),
+    };
+    static description = 'Show one feature and the cells written for it';
+    static examples = ['<%= config.bin %> matrix features show CloseYourIt "Auth/2FA"'];
+    async run() {
+        const { args } = await this.parse(MatrixFeaturesShow);
+        const productId = await this.resolveGroupId(args.product);
+        const res = await this.api.get(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/features/${encodeURIComponent(args.feature)}`);
+        if (!this.jsonEnabled()) {
+            const { cells, ...feature } = res.data ?? {};
+            this.log((0, output_1.renderRecord)(feature));
+            const rows = cells ?? [];
+            if (rows.length > 0) {
+                this.log('');
+                this.log((0, output_1.renderTable)(['PLATFORM', 'STATUS', 'VERSION'], rows.map((cell) => [
+                    String(cell.platform_code ?? cell.platform_id ?? ''),
+                    String(cell.status?.code ?? ''),
+                    cell.release?.version ? String(cell.release.version) : cell.release_missing ? '?' : '-',
+                ])));
+            }
+        }
+        return res;
+    }
+}
+exports.default = MatrixFeaturesShow;

package/dist/commands/matrix/features/update.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../../base';
+export default class MatrixFeaturesUpdate extends BaseCommand {
+    static args: {
+        product: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        feature: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: 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>;
+        position: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'knowledge-page': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/matrix/features/update.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 MatrixFeaturesUpdate extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+        feature: core_1.Args.string({ description: 'Feature id (UUID) or "Category/Name"', required: true }),
+    };
+    static description = 'Update a feature (rename, move to another category, …); unpassed fields keep their value';
+    static examples = [
+        '<%= config.bin %> matrix features update CloseYourIt "Auth/2FA" --name "Two-factor"',
+        '<%= config.bin %> matrix features update CloseYourIt "Auth/2FA" --category Notifications',
+    ];
+    static flags = {
+        name: core_1.Flags.string({ description: 'New name' }),
+        description: core_1.Flags.string({ description: 'What the feature does' }),
+        position: core_1.Flags.integer({ description: 'Sort position' }),
+        category: core_1.Flags.string({ description: 'Move it to this category (id or name, same product)' }),
+        'knowledge-page': core_1.Flags.string({ description: 'Knowledge page id explaining the feature' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MatrixFeaturesUpdate);
+        const productId = await this.resolveGroupId(args.product);
+        const body = {};
+        if (flags.name !== undefined)
+            body.name = flags.name;
+        if (flags.description !== undefined)
+            body.description = flags.description;
+        if (flags.position !== undefined)
+            body.position = flags.position;
+        if (flags.category !== undefined)
+            body.category = flags.category;
+        if (flags['knowledge-page'] !== undefined)
+            body.knowledge_page_id = flags['knowledge-page'];
+        const res = await this.api.put(`/cli/v1/product/matrix/${encodeURIComponent(productId)}/features/${encodeURIComponent(args.feature)}`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Feature updated:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = MatrixFeaturesUpdate;

package/dist/commands/matrix/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class MatrixList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/matrix/list.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class MatrixList extends base_1.BaseCommand {
+    static description = 'List the products (groups) whose feature matrix you can see';
+    static examples = ['<%= config.bin %> matrix list', '<%= config.bin %> matrix list --page 2 --json'];
+    static flags = { ...base_1.pageFlag };
+    async run() {
+        const { flags } = await this.parse(MatrixList);
+        const res = await this.api.get(`/cli/v1/product/matrix?page=${flags.page}`);
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['NAME', 'ID'], (res.data ?? []).map((product) => [String(product.name ?? ''), String(product.id ?? '')])));
+        }
+        return res;
+    }
+}
+exports.default = MatrixList;