@bussolabs/closeyourit-cli 0.19.0 → 0.21.0

package/dist/commands/seo-sites/delete.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class SeoSitesDelete extends base_1.BaseCommand {
+    static description = 'Stop watching a site and remove its pages and findings';
+    static examples = ['<%= config.bin %> seo-sites delete <site-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'Site id', required: true }),
+    };
+    async run() {
+        const { args } = await this.parse(SeoSitesDelete);
+        const res = await this.api.delete(`/cli/v1/seo_sites/${args.id}`);
+        if (!this.jsonEnabled()) {
+            // Pages and findings go with it: to keep the history, pause the site instead (`update --disable`).
+            this.log(`Site ${args.id} removed, with its pages and findings.`);
+        }
+        return res;
+    }
+}
+exports.default = SeoSitesDelete;

package/dist/commands/seo-sites/list.d.ts

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

package/dist/commands/seo-sites/list.js

@@ -0,0 +1,38 @@
+"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 SeoSitesList extends base_1.BaseCommand {
+    static description = 'List the sites under SEO check';
+    static examples = [
+        '<%= config.bin %> seo-sites list',
+        '<%= config.bin %> seo-sites list --project acme-site --json',
+    ];
+    static flags = {
+        project: core_1.Flags.string({ char: 'p', description: 'Filter by project id (UUID) or key' }),
+        ...base_1.pageFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(SeoSitesList);
+        const query = new URLSearchParams({ page: String(flags.page) });
+        if (flags.project)
+            query.set('project_id', await this.resolveProjectId(flags.project));
+        const res = await this.api.get(`/cli/v1/seo_sites?${query.toString()}`);
+        const sites = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['ID', 'PROJECT', 'ENV', 'SITE', 'EVERY', 'OPEN', 'LAST CHECK'], sites.map((site) => [
+                String(site.id ?? ''),
+                String(site.project?.key ?? ''),
+                String(site.environment?.code ?? ''),
+                String(site.base_url ?? ''),
+                String(site.frequency ?? ''),
+                String(site.open_issues_count ?? 0),
+                // A failed run must never look like a successful one: the reason wins over the date.
+                site.last_error ? (0, output_1.statusCell)(`failed: ${site.last_error}`) : String(site.last_audited_at ?? 'never'),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = SeoSitesList;

package/dist/commands/seo-sites/update.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../base';
+export default class SeoSitesUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        url: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        frequency: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-pages': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        sitemap: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo-sites/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 SeoSitesUpdate extends base_1.BaseCommand {
+    static description = 'Change how a site is checked (project and environment are its identity: they never change)';
+    static examples = [
+        '<%= config.bin %> seo-sites update <site-id> --frequency weekly',
+        '<%= config.bin %> seo-sites update <site-id> --max-pages 200 --disable',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Site id', required: true }),
+    };
+    static flags = {
+        url: core_1.Flags.string({ description: 'Public address the visit starts from' }),
+        frequency: core_1.Flags.string({ description: 'How often to check it: daily or weekly', options: ['daily', 'weekly'] }),
+        'max-pages': core_1.Flags.integer({ description: 'How many pages to visit at most each run' }),
+        sitemap: core_1.Flags.boolean({ description: 'Read the sitemap', allowNo: true }),
+        enable: core_1.Flags.boolean({ description: 'Resume the checks', exclusive: ['disable'] }),
+        disable: core_1.Flags.boolean({ description: 'Pause the checks (the site and its findings stay)', exclusive: ['enable'] }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(SeoSitesUpdate);
+        const body = {};
+        if (flags.url !== undefined)
+            body.base_url = flags.url;
+        if (flags.frequency !== undefined)
+            body.frequency = flags.frequency;
+        if (flags['max-pages'] !== undefined)
+            body.max_pages = flags['max-pages'];
+        if (flags.sitemap !== undefined)
+            body.follow_sitemap = flags.sitemap;
+        if (flags.enable)
+            body.enabled = true;
+        if (flags.disable)
+            body.enabled = false;
+        const res = await this.api.put(`/cli/v1/seo_sites/${args.id}`, body);
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = SeoSitesUpdate;

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

@@ -1,13 +1,24 @@
+import { type Interfaces } from '@oclif/core';
 import { BaseCommand } from '../../base';
 export default class TicketsComment extends BaseCommand {
     static args: {
-        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        id: Interfaces.Arg<string, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];
     static flags: {
-        body: 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>;
+        body: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
+        project: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
     };
+    /** Ticket e progetto come li ha scritti l'utente: il suggerimento su R422 li ripete tali e quali. */
+    private target?;
     run(): Promise<unknown>;
+    /**
+     * Il commento troppo lungo va scritto altrove, e il messaggio del server dice solo «use the work
+     * report»: prima di CYCL-31 quel campo dal terminale non esisteva e l'unica uscita era aprire il
+     * sito. Ora esiste, quindi al messaggio si accoda il comando pronto da eseguire, con il ticket e
+     * il progetto già dentro. Codice e testo del server restano intatti — anche in `--json`, dove il
+     * suggerimento viaggia in coda al `message` e il `code` resta `R422-COMMENT-002`.
+     */
+    protected catch(error: Interfaces.CommandError): Promise<unknown>;
 }

package/dist/commands/tickets/comment.js

@@ -2,7 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
+const api_1 = require("../../lib/api");
+const limits_1 = require("../../lib/limits");
 const output_1 = require("../../lib/output");
+// Rifiuto del server per un commento oltre il limite: il messaggio rimanda «al work report». Il
+// codice resta quello del backend, propagato tale e quale (vedi errors/error-codes.ts) — quello che
+// si aggiunge è il comando che quel campo lo scrive davvero (CYCL-31).
+const COMMENT_TOO_LONG = 'R422-COMMENT-002';
 class TicketsComment extends base_1.BaseCommand {
     static args = {
         id: core_1.Args.string({ description: 'Ticket id', required: true }),
@@ -13,10 +19,18 @@ class TicketsComment extends base_1.BaseCommand {
     ];
     static flags = {
         ...base_1.projectFlag,
-        body: core_1.Flags.string({ description: 'Comment body', required: true }),
+        // Il tetto è dichiarato qui e la misura resta al server: il suo rifiuto porta il comando pronto
+        // per scrivere altrove il testo che non ci sta (vedi `catch`), che un controllo locale toglierebbe.
+        body: core_1.Flags.string({
+            description: `Comment body (max ${limits_1.LENGTH_LIMITS.comment} characters — longer text goes in the work report)`,
+            required: true,
+        }),
     };
+    /** Ticket e progetto come li ha scritti l'utente: il suggerimento su R422 li ripete tali e quali. */
+    target;
     async run() {
         const { args, flags } = await this.parse(TicketsComment);
+        this.target = { id: args.id, project: flags.project };
         const projectId = await this.resolveProjectId(flags.project);
         const res = await this.api.post(`/cli/v1/projects/${projectId}/tickets/${args.id}/comments`, { body: flags.body });
         if (!this.jsonEnabled()) {
@@ -25,5 +39,19 @@ class TicketsComment extends base_1.BaseCommand {
         }
         return res;
     }
+    /**
+     * Il commento troppo lungo va scritto altrove, e il messaggio del server dice solo «use the work
+     * report»: prima di CYCL-31 quel campo dal terminale non esisteva e l'unica uscita era aprire il
+     * sito. Ora esiste, quindi al messaggio si accoda il comando pronto da eseguire, con il ticket e
+     * il progetto già dentro. Codice e testo del server restano intatti — anche in `--json`, dove il
+     * suggerimento viaggia in coda al `message` e il `code` resta `R422-COMMENT-002`.
+     */
+    async catch(error) {
+        if (error instanceof api_1.ApiRequestError && error.code === COMMENT_TOO_LONG && this.target) {
+            const hint = `Write it with: ${this.config.bin} tickets report ${this.target.id} --project ${this.target.project} --body-file <file>`;
+            return super.catch(new api_1.ApiRequestError(error.status, error.code, `${error.message} ${hint}`, error.details));
+        }
+        return super.catch(error);
+    }
 }
 exports.default = TicketsComment;

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

@@ -3,6 +3,12 @@ export default class TicketsCreate extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        priority: 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>;
         description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'technical-analysis': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         scenarios: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -13,12 +19,6 @@ export default class TicketsCreate extends BaseCommand {
         condition: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         weight: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'due-at': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'status-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        '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>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/tickets/create.js

@@ -2,26 +2,45 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
+const limits_1 = require("../../lib/limits");
 const output_1 = require("../../lib/output");
 const ticket_body_1 = require("../../lib/ticket-body");
+const ticket_lookup_1 = require("../../lib/ticket-lookup");
 class TicketsCreate extends base_1.BaseCommand {
-    static description = 'Create a ticket';
+    static description = 'Create a ticket (status defaults to open, priority to medium; both take a code or a label)';
     static examples = [
         '<%= config.bin %> tickets create --project acme-api --title "Checkout fails"',
         '<%= config.bin %> tickets create -p acme-api --title "Login bug" --kind bug --step-given "logged out" --step-when "I submit" --step-then "it 500s"',
         '<%= config.bin %> tickets create -p acme-api --title "Checkout" --scenarios \'[{"title":"Happy","step_given":"logged in","step_when":"I pay","step_then":"order created"}]\' --condition "confirmation email is sent"',
+        '<%= config.bin %> tickets create -p acme-api --title "Payment retry" --status in_progress --priority High',
     ];
     static flags = {
         ...base_1.projectFlag,
-        title: core_1.Flags.string({ description: 'Ticket title', required: true }),
+        title: core_1.Flags.string({ description: `Ticket title (max ${limits_1.LENGTH_LIMITS.title} characters)`, required: true }),
         kind: core_1.Flags.string({ description: 'Ticket kind (bug, story, task, epic)', default: 'bug', options: ['bug', 'story', 'task', 'epic'] }),
         ...ticket_body_1.ticketBodyFlags,
+        // Su un ticket che nasce, omettere stato e priorità non li lascia com'erano: applica i predefiniti.
+        ...ticket_lookup_1.newTicketLookupFlags,
     };
     async run() {
         const { flags } = await this.parse(TicketsCreate);
+        // Un ticket nuovo non ha niente da salvaguardare: il tetto vale pieno, e i campi troppo lunghi
+        // si leggono tutti in questo unico rifiuto invece che uno per tentativo (CYCL-32).
+        const tooLong = (0, limits_1.tooLongMessage)((0, ticket_body_1.ticketLengthChecks)(flags));
+        if (tooLong)
+            this.error(tooLong, { exit: 2 });
         const projectId = await this.resolveProjectId(flags.project);
         const body = { title: flags.title, kind: flags.kind };
         (0, ticket_body_1.applyTicketBody)(body, flags);
+        // Stato e priorità il server li pretende ("Status must exist and Priority must exist") mentre
+        // l'aiuto li dava per opzionali: chi non li indica prende i predefiniti, chi li indica li scrive
+        // come li legge (`open`, `In Progress`) invece di andare a cercarne l'UUID (CYCL-34).
+        const [statusId, priorityId] = await Promise.all([
+            this.resolveTicketLookupId(ticket_lookup_1.TICKET_STATUS, flags.status),
+            this.resolveTicketLookupId(ticket_lookup_1.TICKET_PRIORITY, flags.priority),
+        ]);
+        body.status_id = statusId;
+        body.priority_id = priorityId;
         const res = await this.api.post(`/cli/v1/projects/${projectId}/tickets`, body);
         if (!this.jsonEnabled()) {
             this.log('Ticket created:');

package/dist/commands/tickets/report-show.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base';
+/**
+ * Legge il resoconto di lavorazione (CYCL-31): senza `--version` la stesura corrente, con `--version N`
+ * quella versione della cronologia — il numero è unico per ticket, quindi non serve l'id.
+ *
+ * Un ticket senza resoconto risponde `R404-REPORT-001` e il comando esce non-zero: uno script che
+ * pretende un resoconto se ne accorge, invece di leggere un output vuoto come "c'è ed è vuoto".
+ */
+export default class TicketsReportShow extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        version: import("@oclif/core/lib/interfaces").OptionFlag<number | 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/tickets/report-show.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const ticket_report_1 = require("../../lib/ticket-report");
+/**
+ * Legge il resoconto di lavorazione (CYCL-31): senza `--version` la stesura corrente, con `--version N`
+ * quella versione della cronologia — il numero è unico per ticket, quindi non serve l'id.
+ *
+ * Un ticket senza resoconto risponde `R404-REPORT-001` e il comando esce non-zero: uno script che
+ * pretende un resoconto se ne accorge, invece di leggere un output vuoto come "c'è ed è vuoto".
+ */
+class TicketsReportShow extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
+    };
+    static description = 'Show the current work report of a ticket, or a past version with --version';
+    static examples = [
+        '<%= config.bin %> tickets report-show <ticket-id> --project acme-api',
+        '<%= config.bin %> tickets report-show DRFL-3 -p acme-api --version 2',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        version: core_1.Flags.integer({ description: 'Version number to read instead of the current one' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsReportShow);
+        const projectId = await this.resolveProjectId(flags.project);
+        const base = `/cli/v1/projects/${encodeURIComponent(projectId)}/tickets/${encodeURIComponent(args.id)}/report`;
+        const path = flags.version === undefined ? base : `${base}/versions/${encodeURIComponent(String(flags.version))}`;
+        const res = await this.api.get(path);
+        if (!this.jsonEnabled()) {
+            this.log((0, ticket_report_1.renderReport)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsReportShow;

package/dist/commands/tickets/report-versions.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base';
+/**
+ * Cronologia del resoconto di lavorazione (CYCL-31), dalla più recente alla più vecchia. La tabella
+ * porta i metadati e la LUNGHEZZA di ogni stesura, non il testo: i corpi sono lunghi migliaia di
+ * caratteri e incolonnarli renderebbe illeggibile la lista. Il testo di una versione si legge con
+ * `tickets report-show --version N`.
+ */
+export default class TicketsReportVersions extends BaseCommand {
+    static args: {
+        id: 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>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/report-versions.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 limits_1 = require("../../lib/limits");
+const output_1 = require("../../lib/output");
+/**
+ * Cronologia del resoconto di lavorazione (CYCL-31), dalla più recente alla più vecchia. La tabella
+ * porta i metadati e la LUNGHEZZA di ogni stesura, non il testo: i corpi sono lunghi migliaia di
+ * caratteri e incolonnarli renderebbe illeggibile la lista. Il testo di una versione si legge con
+ * `tickets report-show --version N`.
+ */
+class TicketsReportVersions extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
+    };
+    static description = 'List the versions of the work report of a ticket (newest first)';
+    static examples = [
+        '<%= config.bin %> tickets report-versions <ticket-id> --project acme-api',
+        '<%= config.bin %> tickets report-versions DRFL-3 -p acme-api --page 2 --json',
+    ];
+    static flags = { ...base_1.projectFlag, ...base_1.pageFlag };
+    async run() {
+        const { args, flags } = await this.parse(TicketsReportVersions);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.get(`/cli/v1/projects/${encodeURIComponent(projectId)}/tickets/${encodeURIComponent(args.id)}/report/versions?page=${flags.page}`);
+        const versions = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['VERSION', 'AUTHOR', 'SOURCE', 'CHARS', 'CREATED_AT'], versions.map((version) => [
+                String(version.version ?? ''),
+                String(version.author ?? '-'),
+                String(version.source ?? '-'),
+                String((0, limits_1.charCount)(version.body)),
+                String(version.created_at ?? ''),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = TicketsReportVersions;

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

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base';
+/**
+ * Resoconto di lavorazione di un ticket (CYCL-31). È il campo che il server indica quando rifiuta un
+ * commento troppo lungo, e fino a qui esisteva solo nel form web: chi chiudeva una lavorazione dal
+ * terminale doveva aprire il sito o rinunciare a scrivere il resoconto.
+ *
+ * Ogni scrittura AGGIUNGE una versione, non sovrascrive la precedente: correggere un resoconto
+ * significa scriverne uno nuovo, e la cronologia si legge con `tickets report-versions`. Ripassare
+ * lo stesso identico testo non crea una versione in più — è il server a riconoscerlo, quindi un
+ * comando ripetuto (un retry di uno script) non sporca la cronologia.
+ */
+export default class TicketsReport extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        body: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'body-file': 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/tickets/report.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = require("node:fs/promises");
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const limits_1 = require("../../lib/limits");
+const ticket_report_1 = require("../../lib/ticket-report");
+/**
+ * Resoconto di lavorazione di un ticket (CYCL-31). È il campo che il server indica quando rifiuta un
+ * commento troppo lungo, e fino a qui esisteva solo nel form web: chi chiudeva una lavorazione dal
+ * terminale doveva aprire il sito o rinunciare a scrivere il resoconto.
+ *
+ * Ogni scrittura AGGIUNGE una versione, non sovrascrive la precedente: correggere un resoconto
+ * significa scriverne uno nuovo, e la cronologia si legge con `tickets report-versions`. Ripassare
+ * lo stesso identico testo non crea una versione in più — è il server a riconoscerlo, quindi un
+ * comando ripetuto (un retry di uno script) non sporca la cronologia.
+ */
+class TicketsReport extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
+    };
+    static description = 'Write the work report of a ticket — the long text a comment cannot hold. Each write adds a version, it never overwrites the previous one';
+    static examples = [
+        '<%= config.bin %> tickets report <ticket-id> --project acme-api --body "Cosa ho fatto, come si verifica"',
+        '<%= config.bin %> tickets report DRFL-3 -p acme-api --body-file ./report.md',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        body: core_1.Flags.string({ description: `Report body (markdown, max ${limits_1.LENGTH_LIMITS.report} characters)` }),
+        'body-file': core_1.Flags.string({
+            description: `Read the report body (max ${limits_1.LENGTH_LIMITS.report} characters) from a local file`,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsReport);
+        // Una versione è immutabile: se i due valori divergono, sceglierne uno a caso lascia il
+        // resoconto sbagliato per sempre. Meglio fermarsi prima di scrivere.
+        if (flags.body !== undefined && flags['body-file'] !== undefined) {
+            this.error('Pass the report body with --body or --body-file, not both.', { exit: 2 });
+        }
+        let body = flags.body;
+        let bodyFlag = '--body';
+        if (body === undefined && flags['body-file'] !== undefined) {
+            bodyFlag = '--body-file';
+            try {
+                body = await (0, promises_1.readFile)(flags['body-file'], 'utf8');
+            }
+            catch {
+                this.error(`File not found or unreadable: ${flags['body-file']}`, { exit: 2 });
+            }
+        }
+        if (body === undefined) {
+            this.error('Provide the report body via --body or --body-file.', { exit: 2 });
+        }
+        // Ogni scrittura è una versione nuova, quindi il tetto vale sempre pieno: niente da salvaguardare
+        // e nessun motivo di spedire un testo che il server rifiuterebbe comunque (CYCL-32).
+        const tooLong = (0, limits_1.tooLongMessage)([{ flag: bodyFlag, value: body, max: limits_1.LENGTH_LIMITS.report, orthography: true }]);
+        if (tooLong)
+            this.error(tooLong, { exit: 2 });
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.post(`/cli/v1/projects/${encodeURIComponent(projectId)}/tickets/${encodeURIComponent(args.id)}/report`, { body });
+        if (!this.jsonEnabled()) {
+            this.log('Work report saved:');
+            this.log((0, ticket_report_1.renderReport)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsReport;

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

@@ -6,7 +6,7 @@ export default class TicketsStatus extends BaseCommand {
         id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        'status-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        status: 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>;
     };
     run(): Promise<unknown>;

package/dist/commands/tickets/status.js

@@ -3,20 +3,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
 const output_1 = require("../../lib/output");
+const ticket_lookup_1 = require("../../lib/ticket-lookup");
 class TicketsStatus extends base_1.BaseCommand {
-    static description = 'Change a ticket status';
-    static examples = ['<%= config.bin %> tickets status <ticket-id> --project acme-api --status-id <status-id>'];
+    static description = 'Change a ticket status (by code, label or id)';
+    static examples = [
+        '<%= config.bin %> tickets status <ticket-id> --project acme-api --status in_review',
+        '<%= config.bin %> tickets status <ticket-id> --project acme-api --status <status-id>',
+    ];
     static args = {
         id: core_1.Args.string({ description: 'Ticket id', required: true }),
     };
     static flags = {
         ...base_1.projectFlag,
-        'status-id': core_1.Flags.string({ description: 'Target status lookup id', required: true }),
+        // Lo stato si scrive come lo si legge: `--status-id` resta come alias per gli script (CYCL-34).
+        status: core_1.Flags.string({
+            aliases: ['status-id'],
+            description: 'Target status code, label or id (e.g. in_review, "In Review")',
+            required: true,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(TicketsStatus);
         const projectId = await this.resolveProjectId(flags.project);
-        const res = await this.api.put(`/cli/v1/projects/${projectId}/tickets/${args.id}/status`, { status_id: flags['status-id'] });
+        const statusId = await this.resolveTicketLookupId(ticket_lookup_1.TICKET_STATUS, flags.status);
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/tickets/${args.id}/status`, { status_id: statusId });
         if (!this.jsonEnabled()) {
             this.log(`Ticket ${args.id} status updated:`);
             this.log((0, output_1.renderRecord)(res.data ?? {}));

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

@@ -6,6 +6,14 @@ export default class TicketsUpdate extends BaseCommand {
         id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        replace: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        clear: 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>;
+        status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        priority: 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>;
         'technical-analysis': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         scenarios: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -16,15 +24,26 @@ export default class TicketsUpdate extends BaseCommand {
         condition: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         weight: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'due-at': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'status-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        '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>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<unknown>;
+    /**
+     * Lo stato attuale del ticket, nella forma che la PUT si aspetta, per i soli campi che chi ha
+     * scritto il comando non ha già deciso. I campi vuoti restano fuori dal corpo: ometterli o
+     * mandarli a null è la stessa cosa, e il corpo resta leggibile.
+     */
+    private currentState;
+    /** Rifiuta `--clear x` insieme a `--x`: impostare e svuotare lo stesso campo è una richiesta ambigua. */
+    private refuseClearConflicts;
+    /** Id della voce di lookup che corrisponde all'etichetta mostrata dalla GET del ticket. */
+    private lookupId;
+    /**
+     * Una lookup non trovata o ambigua ferma il comando: proseguire manderebbe una PUT senza quel
+     * campo, cioè lo cancellerebbe in silenzio — il difetto che questo comando esiste per evitare.
+     */
+    private matchId;
+    /** Ogni pagina di un endpoint di lookup: la voce cercata può stare oltre la prima. */
+    private lookupRows;
 }