@bussolabs/closeyourit-cli 0.13.0 → 0.15.0

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;

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base';
+export default class MatrixShow extends BaseCommand {
+    static args: {
+        product: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<unknown>;
+    /**
+     * The first column holds `Category/Feature` — the very reference `matrix cells set` and
+     * `matrix features` take, so a row can be acted on without a second lookup.
+     */
+    private renderMatrix;
+    /** `-` = not set (different from an explicit "not applicable" status, which has its own code). */
+    private renderCell;
+}

package/dist/commands/matrix/show.js

@@ -0,0 +1,63 @@
+"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 MatrixShow extends base_1.BaseCommand {
+    static args = {
+        product: core_1.Args.string({ description: 'Product id (UUID) or group name', required: true }),
+    };
+    static description = 'Show a product feature matrix: features in rows, platforms in columns';
+    static examples = [
+        '<%= config.bin %> matrix show CloseYourIt',
+        '<%= config.bin %> matrix show CloseYourIt --json',
+    ];
+    async run() {
+        const { args } = await this.parse(MatrixShow);
+        const productId = await this.resolveGroupId(args.product);
+        const res = await this.api.get(`/cli/v1/product/matrix/${encodeURIComponent(productId)}`);
+        if (!this.jsonEnabled())
+            this.renderMatrix(res.data ?? {});
+        return res;
+    }
+    /**
+     * The first column holds `Category/Feature` — the very reference `matrix cells set` and
+     * `matrix features` take, so a row can be acted on without a second lookup.
+     */
+    renderMatrix(matrix) {
+        const platforms = matrix.platforms ?? [];
+        if (platforms.length === 0) {
+            this.log('No platforms yet: declare them on the products projects, or write a cell to open a column.');
+        }
+        const byCell = new Map();
+        for (const cell of matrix.cells ?? [])
+            byCell.set(`${cell.feature_id}|${cell.platform_id}`, cell);
+        const rows = [];
+        for (const category of matrix.categories ?? []) {
+            for (const feature of category.features ?? []) {
+                rows.push([
+                    `${category.name ?? ''}/${feature.name ?? ''}`,
+                    ...platforms.map((platform) => this.renderCell(byCell.get(`${feature.id}|${platform.id}`))),
+                ]);
+            }
+        }
+        if (rows.length === 0) {
+            this.log('No features yet. Add one with: matrix features create <product> --category <name> --name <name>');
+            return;
+        }
+        this.log((0, output_1.renderTable)(['FEATURE', ...platforms.map((platform) => String(platform.code ?? '').toUpperCase())], rows));
+        const missing = Number(matrix.missing_release_count ?? 0);
+        if (missing > 0) {
+            this.log(`\n${missing} released cell(s) without a version (marked "?"). Set one with matrix cells set --release.`);
+        }
+    }
+    /** `-` = not set (different from an explicit "not applicable" status, which has its own code). */
+    renderCell(cell) {
+        if (!cell?.status?.code)
+            return '-';
+        if (cell.release?.version)
+            return `${cell.status.code} ${cell.release.version}`;
+        return cell.release_missing ? `${cell.status.code} ?` : String(cell.status.code);
+    }
+}
+exports.default = MatrixShow;

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

@@ -0,0 +1,6 @@
+import { BaseCommand } from '../../base';
+export default class MatrixStatuses extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<unknown>;
+}

package/dist/commands/matrix/statuses.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class MatrixStatuses extends base_1.BaseCommand {
+    static description = 'List the cell statuses of your organization (the codes accepted by matrix cells set)';
+    static examples = ['<%= config.bin %> matrix statuses', '<%= config.bin %> matrix statuses --json'];
+    async run() {
+        await this.parse(MatrixStatuses);
+        const res = await this.api.get('/cli/v1/types/feature_statuses');
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['CODE', 'LABEL', 'LIFECYCLE', 'ID'], (res.data ?? []).map((status) => [
+                String(status.code ?? ''),
+                String(status.label ?? ''),
+                String(status.category ?? ''),
+                String(status.id ?? ''),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = MatrixStatuses;

package/dist/lib/api.d.ts

@@ -25,6 +25,13 @@ export interface UploadFile {
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
 export declare class CliApi {
     private readonly config;
+    /**
+     * Meta of the most recent successful response envelope (`{page, per, total, total_pages}`, or
+     * undefined for non-paginated responses). `BaseCommand.finally` reads it to print the "there are
+     * more pages" footer once per command, instead of threading the envelope through all 30 list
+     * commands (CYCL-11). The instance is per-command, so this is that command's last response.
+     */
+    lastMeta?: Record<string, unknown>;
     constructor(config: CliConfig);
     request<T = unknown>(method: HttpMethod, path: string, opts?: RequestOptions): Promise<Envelope<T>>;
     /**

package/dist/lib/api.js

@@ -18,6 +18,13 @@ class ApiRequestError extends Error {
 exports.ApiRequestError = ApiRequestError;
 class CliApi {
     config;
+    /**
+     * Meta of the most recent successful response envelope (`{page, per, total, total_pages}`, or
+     * undefined for non-paginated responses). `BaseCommand.finally` reads it to print the "there are
+     * more pages" footer once per command, instead of threading the envelope through all 30 list
+     * commands (CYCL-11). The instance is per-command, so this is that command's last response.
+     */
+    lastMeta;
     constructor(config) {
         this.config = config;
     }
@@ -97,7 +104,9 @@ class CliApi {
             const error = envelope.error ?? {};
             throw new ApiRequestError(res.status, error.code ?? `C${res.status}-API-000`, error.message ?? res.statusText ?? `Request failed (${res.status})`, error.details);
         }
-        return (json ?? {});
+        const envelope = (json ?? {});
+        this.lastMeta = envelope.meta;
+        return envelope;
     }
     get(path, opts) {
         return this.request('GET', path, opts);
@@ -132,6 +141,10 @@ class CliApi {
             await this.handleResponse(res); // always throws: maps the JSON error envelope
             throw new ApiRequestError(res.status, `C${res.status}-API-000`, `Download failed (${res.status})`);
         }
+        // A binary payload is not a paginated collection; clear any meta a prior lookup (e.g.
+        // resolveProjectId) left behind so it cannot leak into the pagination footer (CYCL-11). The
+        // success path bypasses handleResponse, so this reset must be explicit.
+        this.lastMeta = undefined;
         const data = new Uint8Array(await res.arrayBuffer());
         const disposition = res.headers.get('content-disposition') ?? '';
         const match = /filename\*?=(?:UTF-8''|")?([^";]+)/i.exec(disposition);

package/dist/lib/output.d.ts

@@ -15,6 +15,14 @@ export declare function sanitizeMultiline(value: unknown): string;
 export declare function displayWidth(value: string): number;
 /** Minimal dependency-free table renderer for human output. */
 export declare function renderTable(headers: string[], rows: string[][]): string;
+/**
+ * Footer line telling the reader that the human table is only one backend page of a larger set:
+ * without it, page 1 reads as the whole collection and a 900-ticket project looks like 10 (CYCL-11).
+ * Returns undefined when nothing more follows — a single page, the last page, or a collection already
+ * aggregated by `fetchAllPages` (whose last saved meta has `page === total_pages`) — so complete
+ * output stays clean. Callers gate on `!jsonEnabled()`, so machine output never sees this.
+ */
+export declare function paginationFooter(meta: unknown): string | undefined;
 /**
  * Status dots make problems scannable at a glance. Four fixed-width circles (no variation
  * selectors, so table columns stay aligned): down=🔴, warn=🟡, ok=🟢, neutral=⚪.

package/dist/lib/output.js

@@ -4,6 +4,7 @@ exports.sanitize = sanitize;
 exports.sanitizeMultiline = sanitizeMultiline;
 exports.displayWidth = displayWidth;
 exports.renderTable = renderTable;
+exports.paginationFooter = paginationFooter;
 exports.statusDot = statusDot;
 exports.statusCell = statusCell;
 exports.section = section;
@@ -72,6 +73,25 @@ function renderTable(headers, rows) {
     const separator = widths.map((width) => '-'.repeat(width));
     return [line(safeHeaders), line(separator), ...safeRows.map(line)].join('\n');
 }
+/**
+ * Footer line telling the reader that the human table is only one backend page of a larger set:
+ * without it, page 1 reads as the whole collection and a 900-ticket project looks like 10 (CYCL-11).
+ * Returns undefined when nothing more follows — a single page, the last page, or a collection already
+ * aggregated by `fetchAllPages` (whose last saved meta has `page === total_pages`) — so complete
+ * output stays clean. Callers gate on `!jsonEnabled()`, so machine output never sees this.
+ */
+function paginationFooter(meta) {
+    if (!meta || typeof meta !== 'object')
+        return undefined;
+    const { page, total, total_pages: totalPages } = meta;
+    const current = Number(page);
+    const last = Number(totalPages);
+    if (!Number.isInteger(current) || !Number.isInteger(last) || current < 1 || current >= last)
+        return undefined;
+    const count = Number(total);
+    const totalPart = Number.isFinite(count) ? ` — ${count} items total` : '';
+    return `Showing page ${current} of ${last}${totalPart}. Use --page ${current + 1} to see more.`;
+}
 const TONE_DOT = {
     down: '🔴',
     neutral: '⚪',