@bussolabs/closeyourit-cli 0.12.0 → 0.14.0

package/README.md

@@ -44,19 +44,19 @@ CLOSEYOURIT_TOKEN=cyi_u_… CLOSEYOURIT_API_URL=https://www.closeyour.it \
 | `whoami` | Show account, organization, token prefix and permissions. |
 | `projects list [--page]` | List visible projects. |
 | `projects show <id\|key>` | Show one project, plus its declared environments and per-environment capabilities. |
-| `projects create <name> --key <key> [--group <id\|name>] [--color] [--description] [--roadmap-enabled] [--quick-bug-report-enabled]` | Create a project (optionally inside a group). |
-| `projects update --project <id\|key> [--name] [--key] [--color] [--description] [--group] [--roadmap-enabled] [--quick-bug-report-enabled]` | Update a project (only the passed fields change). |
+| `projects create <name> --key <key> [--group <id\|name>] [--color] [--description] [--quick-bug-report-enabled]` | Create a project (optionally inside a group). |
+| `projects update --project <id\|key> [--name] [--key] [--color] [--description] [--group] [--quick-bug-report-enabled]` | Update a project (only the passed fields change). |
 | `projects link-server --project <id\|key> --host-id <id> --environment-id <id>` | Link a server host to a declared project environment (uptime). |
 | `projects unlink-server <link-id> --project <id\|key> --confirm` | Unlink a server host from the project. |
 | `projects settings show --project <id\|key>` | Show a project's settings (log/analytics retention + feature flags). |
-| `projects settings update --project <id\|key> [--logs-retention-days] [--analytics-retention-days] [--roadmap-enabled] [--quick-bug-report-enabled] [--analytics-enabled]` | Update a project's settings (only the passed fields change). |
+| `projects settings update --project <id\|key> [--logs-retention-days] [--analytics-retention-days] [--quick-bug-report-enabled] [--analytics-enabled]` | Update a project's settings (only the passed fields change). |
 | `projects github --project <id\|key>` | Show a project's GitHub integration (repo link + secrets-sync state + tag→release binding rules). |
 | `projects github-connect --project <id\|key> --repository <owner/name>` | Connect a project to a repository visible to the organization's GitHub App. |
 | `projects github-map [--connected-only]` | List every visible CloseYourIt project and its connected GitHub repository; automatically fetches all pages. |
 | `projects github-update --project <id\|key> [--default-branch] [--production-environment-id] [--staging-environment-id] [--sync-enabled] [--sync-secrets] [--tag-binding-enabled] [--autoclose-on-merge]` | Update a project's GitHub binding rules (only the passed fields change; `--sync-secrets`/`--no-sync-secrets` toggles pushing vault secrets to GitHub). |
 | `groups list [--page]` | List groups (macro-projects) in your org. |
-| `groups create <name> [--color] [--roadmap-enabled]` | Create a group (container of related projects, e.g. "DriverOne"). |
-| `groups update <id\|name> [--name] [--color] [--roadmap-enabled]` | Update a group (rename, recolor, toggle roadmap). |
+| `groups create <name> [--color]` | Create a group (container of related projects, e.g. "DriverOne"). |
+| `groups update <id\|name> [--name] [--color]` | Update a group (rename, recolor). |
 | `roles list\|show <id\|name>` | List roles / show a role with its permission keys. |
 | `roles create <name> [--permission <key>…] [--color]` | Create an RBAC role (bundle of permission keys). |
 | `roles update <id\|name> [--name] [--permission <key>…] [--color]` | Update a role (permissions REPLACE the set). |
@@ -93,7 +93,7 @@ CLOSEYOURIT_TOKEN=cyi_u_… CLOSEYOURIT_API_URL=https://www.closeyour.it \
 | `secrets assets shared-list\|shared-upload\|delegate\|undelegate …` | Manage one organization-level ciphertext and delegate it to authorized projects. |
 | `tickets list --project <id\|key> [--page]` | List tickets. |
 | `tickets show <id> --project <id\|key>` | Show one ticket. |
-| `tickets create --project <id\|key> --title <t> [--kind] [--step-*] [--description] [--status-id] [--priority-id]` | Create a ticket. |
+| `tickets create --project <id\|key> --title <t> [--kind bug\|story\|task\|epic] [--parent-id] [--step-*] [--description] [--status-id] [--priority-id]` | Create a ticket. |
 | `tickets statuses` | List the org ticket statuses (id, code, label) — the id feeds `create --status-id`. |
 | `tickets priorities` | List the org ticket priorities (id, code, label) — the id feeds `create --priority-id`. |
 | `tickets reject <id> --project <id\|key> --reason <text>` | Reject the review: back to work, the reason becomes a comment. |

package/dist/base.d.ts

@@ -43,4 +43,15 @@ export declare abstract class BaseCommand extends Command {
      * swallowed (empty stdout, exit looks like a silent success) for machine consumers (CYCL-1).
      */
     protected catch(error: Interfaces.CommandError): Promise<unknown>;
+    /**
+     * After a successful human-mode command, print the pagination footer once. Every list command
+     * renders a single backend page; reading `this.api.lastMeta` (saved by CliApi on the last response)
+     * here keeps the "there are more pages" hint in one place instead of in all 30 of them (CYCL-11).
+     *
+     * Gated on the command actually exposing `--page`: on a download, a lookup, or a `statuses`/`tokens`
+     * list without that flag, `lastMeta` may be stale (e.g. left by `resolveProjectId`) or from a
+     * collection the reader cannot page, and "Use --page N" would point at a flag that does not exist.
+     * Also suppressed on error and in `--json` mode, so machine output stays exact.
+     */
+    protected finally(err: Error | undefined): Promise<unknown>;
 }

package/dist/base.js

@@ -4,6 +4,7 @@ exports.BaseCommand = exports.pageFlag = exports.environmentFlag = exports.proje
 const core_1 = require("@oclif/core");
 const config_1 = require("./lib/config");
 const api_1 = require("./lib/api");
+const output_1 = require("./lib/output");
 const error_codes_1 = require("./errors/error-codes");
 exports.UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 /** Shared `--project <id|key>` flag (required). */
@@ -110,5 +111,23 @@ class BaseCommand extends core_1.Command {
         }
         return super.catch(error);
     }
+    /**
+     * After a successful human-mode command, print the pagination footer once. Every list command
+     * renders a single backend page; reading `this.api.lastMeta` (saved by CliApi on the last response)
+     * here keeps the "there are more pages" hint in one place instead of in all 30 of them (CYCL-11).
+     *
+     * Gated on the command actually exposing `--page`: on a download, a lookup, or a `statuses`/`tokens`
+     * list without that flag, `lastMeta` may be stale (e.g. left by `resolveProjectId`) or from a
+     * collection the reader cannot page, and "Use --page N" would point at a flag that does not exist.
+     * Also suppressed on error and in `--json` mode, so machine output stays exact.
+     */
+    async finally(err) {
+        if (!err && !this.jsonEnabled() && 'page' in (this.ctor.flags ?? {})) {
+            const footer = (0, output_1.paginationFooter)(this.api?.lastMeta);
+            if (footer)
+                this.log(footer);
+        }
+        return super.finally(err);
+    }
 }
 exports.BaseCommand = BaseCommand;

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

@@ -7,7 +7,6 @@ export default class GroupsCreate extends BaseCommand {
     static examples: string[];
     static flags: {
         color: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'roadmap-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<unknown>;
 }

package/dist/commands/groups/create.js

@@ -11,22 +11,15 @@ class GroupsCreate extends base_1.BaseCommand {
     static examples = [
         '<%= config.bin %> groups create DriverOne',
         '<%= config.bin %> groups create DriverOne --color indigo',
-        '<%= config.bin %> groups create DriverOne --roadmap-enabled',
     ];
     static flags = {
         color: core_1.Flags.string({ description: 'Color label' }),
-        'roadmap-enabled': core_1.Flags.boolean({
-            allowNo: true,
-            description: 'Enable the roadmap and cascade it to the projects in this group',
-        }),
     };
     async run() {
         const { args, flags } = await this.parse(GroupsCreate);
         const body = { name: args.name };
         if (flags.color !== undefined)
             body.color = flags.color;
-        if (flags['roadmap-enabled'] !== undefined)
-            body.roadmap_enabled = flags['roadmap-enabled'];
         const res = await this.api.post('/cli/v1/groups', body);
         if (!this.jsonEnabled()) {
             this.log('Group created:');

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

@@ -8,7 +8,6 @@ export default class GroupsUpdate extends BaseCommand {
     static flags: {
         name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         color: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'roadmap-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<unknown>;
 }

package/dist/commands/groups/update.js

@@ -7,19 +7,14 @@ class GroupsUpdate extends base_1.BaseCommand {
     static args = {
         group: core_1.Args.string({ description: 'Group id (UUID) or name', required: true }),
     };
-    static description = 'Update a group (rename, recolor, toggle roadmap)';
+    static description = 'Update a group (rename, recolor)';
     static examples = [
         '<%= config.bin %> groups update Backend --name "Backend services"',
         '<%= config.bin %> groups update Backend --color indigo',
-        '<%= config.bin %> groups update Backend --roadmap-enabled',
     ];
     static flags = {
         name: core_1.Flags.string({ description: 'New name' }),
         color: core_1.Flags.string({ description: 'Color label' }),
-        'roadmap-enabled': core_1.Flags.boolean({
-            allowNo: true,
-            description: 'Enable/disable the roadmap and cascade it to the projects in this group',
-        }),
     };
     async run() {
         const { args, flags } = await this.parse(GroupsUpdate);
@@ -29,8 +24,6 @@ class GroupsUpdate extends base_1.BaseCommand {
             body.name = flags.name;
         if (flags.color !== undefined)
             body.color = flags.color;
-        if (flags['roadmap-enabled'] !== undefined)
-            body.roadmap_enabled = flags['roadmap-enabled'];
         const res = await this.api.put(`/cli/v1/groups/${id}`, body);
         if (!this.jsonEnabled()) {
             this.log('Group updated:');

package/dist/commands/ideas/convert.js

@@ -16,7 +16,7 @@ class IdeasConvert extends base_1.BaseCommand {
         ...base_1.projectFlag,
         title: core_1.Flags.string({ description: 'Ticket title (skips AI when set together with --description)' }),
         description: core_1.Flags.string({ description: 'Ticket description (skips AI when set together with --title)' }),
-        kind: core_1.Flags.string({ description: 'Ticket kind (default: feature if the project has a roadmap, else bug)' }),
+        kind: core_1.Flags.string({ description: 'Ticket kind (default: story)', options: ['bug', 'story', 'task', 'epic'] }),
         'status-id': core_1.Flags.string({ description: 'Status lookup id (default: open)' }),
         'priority-id': core_1.Flags.string({ description: 'Priority lookup id (default: medium)' }),
     };

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

@@ -10,7 +10,6 @@ export default class ProjectsCreate extends BaseCommand {
         description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         group: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         key: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'roadmap-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'quick-bug-report-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<unknown>;

package/dist/commands/projects/create.js

@@ -12,7 +12,7 @@ class ProjectsCreate extends base_1.BaseCommand {
         '<%= config.bin %> projects create driverone-rails --key DRRA',
         '<%= config.bin %> projects create driverone-rails --group DriverOne --key DRRA',
         '<%= config.bin %> projects create driverone-flutter -g <group-uuid> -k DRFL',
-        '<%= config.bin %> projects create acme-api -k ACME --roadmap-enabled --quick-bug-report-enabled',
+        '<%= config.bin %> projects create acme-api -k ACME --quick-bug-report-enabled',
     ];
     static flags = {
         color: core_1.Flags.string({ description: 'Color label' }),
@@ -23,10 +23,6 @@ class ProjectsCreate extends base_1.BaseCommand {
             required: true,
             description: 'Project key (uppercase A-Z0-9, max 4 chars, unique per org)',
         }),
-        'roadmap-enabled': core_1.Flags.boolean({
-            allowNo: true,
-            description: 'Enable the roadmap (feature/improvement tickets + milestones) for this project',
-        }),
         'quick-bug-report-enabled': core_1.Flags.boolean({
             allowNo: true,
             description: 'Enable the AI-assisted quick bug report on this project',
@@ -46,8 +42,6 @@ class ProjectsCreate extends base_1.BaseCommand {
             else
                 body.group_name = flags.group;
         }
-        if (flags['roadmap-enabled'] !== undefined)
-            body.roadmap_enabled = flags['roadmap-enabled'];
         if (flags['quick-bug-report-enabled'] !== undefined)
             body.quick_bug_report_enabled = flags['quick-bug-report-enabled'];
         const res = await this.api.post('/cli/v1/projects', body);

package/dist/commands/projects/settings/update.d.ts

@@ -5,7 +5,6 @@ export default class ProjectsSettingsUpdate extends BaseCommand {
     static flags: {
         'logs-retention-days': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'analytics-retention-days': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'roadmap-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'quick-bug-report-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'analytics-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/projects/settings/update.js

@@ -8,7 +8,7 @@ class ProjectsSettingsUpdate extends base_1.BaseCommand {
     static examples = [
         '<%= config.bin %> projects settings update --project LBRA --logs-retention-days 30',
         '<%= config.bin %> projects settings update -p LBRA --analytics-retention-days 365 --analytics-enabled',
-        '<%= config.bin %> projects settings update -p LBRA --roadmap-enabled --no-quick-bug-report-enabled',
+        '<%= config.bin %> projects settings update -p LBRA --no-quick-bug-report-enabled',
     ];
     static flags = {
         ...base_1.projectFlag,
@@ -16,7 +16,6 @@ class ProjectsSettingsUpdate extends base_1.BaseCommand {
         'analytics-retention-days': core_1.Flags.integer({
             description: 'Analytics retention in days (blank inherits the org/global default)',
         }),
-        'roadmap-enabled': core_1.Flags.boolean({ allowNo: true, description: 'Enable/disable the project roadmap' }),
         'quick-bug-report-enabled': core_1.Flags.boolean({
             allowNo: true,
             description: 'Enable/disable the AI-assisted quick bug report',
@@ -31,8 +30,6 @@ class ProjectsSettingsUpdate extends base_1.BaseCommand {
             body.logs_retention_days = flags['logs-retention-days'];
         if (flags['analytics-retention-days'] !== undefined)
             body.analytics_retention_days = flags['analytics-retention-days'];
-        if (flags['roadmap-enabled'] !== undefined)
-            body.roadmap_enabled = flags['roadmap-enabled'];
         if (flags['quick-bug-report-enabled'] !== undefined)
             body.quick_bug_report_enabled = flags['quick-bug-report-enabled'];
         if (flags['analytics-enabled'] !== undefined)

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

@@ -8,7 +8,6 @@ export default class ProjectsUpdate extends BaseCommand {
         color: 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>;
         group: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'roadmap-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'quick-bug-report-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };

package/dist/commands/projects/update.js

@@ -7,7 +7,7 @@ class ProjectsUpdate extends base_1.BaseCommand {
     static examples = [
         '<%= config.bin %> projects update --project LBRA --name "New name"',
         '<%= config.bin %> projects update -p LBRA --group Backend',
-        '<%= config.bin %> projects update -p LBRA --roadmap-enabled --no-quick-bug-report-enabled',
+        '<%= config.bin %> projects update -p LBRA --no-quick-bug-report-enabled',
     ];
     static flags = {
         ...base_1.projectFlag,
@@ -16,10 +16,6 @@ class ProjectsUpdate extends base_1.BaseCommand {
         color: core_1.Flags.string({ description: 'Color label' }),
         description: core_1.Flags.string({ description: 'Free-form description' }),
         group: core_1.Flags.string({ description: 'Group id (UUID) or name to move the project into' }),
-        'roadmap-enabled': core_1.Flags.boolean({
-            allowNo: true,
-            description: 'Enable/disable the roadmap (feature/improvement tickets + milestones) for this project',
-        }),
         'quick-bug-report-enabled': core_1.Flags.boolean({
             allowNo: true,
             description: 'Enable/disable the AI-assisted quick bug report on this project',
@@ -35,8 +31,6 @@ class ProjectsUpdate extends base_1.BaseCommand {
         }
         if (flags.group !== undefined)
             body.group_id = await this.resolveGroupId(flags.group);
-        if (flags['roadmap-enabled'] !== undefined)
-            body.roadmap_enabled = flags['roadmap-enabled'];
         if (flags['quick-bug-report-enabled'] !== undefined)
             body.quick_bug_report_enabled = flags['quick-bug-report-enabled'];
         const res = await this.api.put(`/cli/v1/projects/${projectId}`, body);

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

@@ -17,6 +17,7 @@ export default class TicketsCreate extends BaseCommand {
         'priority-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'assignee-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'milestone-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'parent-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'platform-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         title: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         kind: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/tickets/create.js

@@ -14,7 +14,7 @@ class TicketsCreate extends base_1.BaseCommand {
     static flags = {
         ...base_1.projectFlag,
         title: core_1.Flags.string({ description: 'Ticket title', required: true }),
-        kind: core_1.Flags.string({ description: 'Ticket kind (bug, feature, improvement)', default: 'bug' }),
+        kind: core_1.Flags.string({ description: 'Ticket kind (bug, story, task, epic)', default: 'bug', options: ['bug', 'story', 'task', 'epic'] }),
         ...ticket_body_1.ticketBodyFlags,
     };
     async run() {

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

@@ -20,6 +20,7 @@ export default class TicketsUpdate extends BaseCommand {
         'priority-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'assignee-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'milestone-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'parent-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'platform-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         kind: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/tickets/update.js

@@ -18,7 +18,7 @@ class TicketsUpdate extends base_1.BaseCommand {
     static flags = {
         ...base_1.projectFlag,
         title: core_1.Flags.string({ description: 'Ticket title' }),
-        kind: core_1.Flags.string({ description: 'Ticket kind (bug, feature, improvement)' }),
+        kind: core_1.Flags.string({ description: 'Ticket kind (bug, story, task, epic)', options: ['bug', 'story', 'task', 'epic'] }),
         ...ticket_body_1.ticketBodyFlags,
     };
     async run() {

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: '⚪',

package/dist/lib/ticket-body.d.ts

@@ -13,6 +13,7 @@ export declare const ticketBodyFlags: {
     'priority-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     'assignee-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     'milestone-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'parent-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     'platform-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
 };
 type BodyFlags = Record<string, unknown>;

package/dist/lib/ticket-body.js

@@ -26,6 +26,7 @@ exports.ticketBodyFlags = {
     'priority-id': core_1.Flags.string({ description: 'Priority lookup id' }),
     'assignee-id': core_1.Flags.string({ description: 'Assignee account id' }),
     'milestone-id': core_1.Flags.string({ description: 'Milestone id (of this project)' }),
+    'parent-id': core_1.Flags.string({ description: 'Parent epic id (of this project) — pass an empty string to detach' }),
     'platform-id': core_1.Flags.string({ description: 'Affected platform id (repeatable)', multiple: true }),
 };
 const STEP_KEYS = [
@@ -80,6 +81,8 @@ function applyTicketBody(body, flags) {
         body.assignee_id = flags['assignee-id'];
     if (flags['milestone-id'] !== undefined)
         body.milestone_id = flags['milestone-id'];
+    if (flags['parent-id'] !== undefined)
+        body.parent_id = flags['parent-id'];
     if (flags['platform-id'] !== undefined)
         body.platform_ids = flags['platform-id'];
     const scenarios = scenariosFromFlags(flags);