@bussolabs/closeyourit-cli 0.0.18 → 0.0.20

package/README.md

@@ -39,6 +39,8 @@ organization are stored locally.
 | `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 github --project <id\|key>` | Show a project's GitHub integration (repo link + tag→release binding rules). |
+| `projects github-update --project <id\|key> [--default-branch] [--production-environment-id] [--staging-environment-id] [--sync-enabled] [--tag-binding-enabled] [--autoclose-on-merge]` | Update a project's GitHub binding rules (only the passed fields change). |
 | `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). |
@@ -78,6 +80,8 @@ organization are stored locally.
 | `tickets reviewer <id> --project <id\|key> --reviewer-id <account-id>` | Set the reviewer of a ticket (requires tickets.assign). |
 | `tickets unreviewer <id> --project <id\|key>` | Remove the reviewer of a ticket. |
 | `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). |
 | `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. |

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

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base';
+export default class ProjectsGithubUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'default-branch': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'production-environment-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'staging-environment-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'sync-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'tag-binding-enabled': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'autoclose-on-merge': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/projects/github-update.js

@@ -0,0 +1,55 @@
+"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 ProjectsGithubUpdate extends base_1.BaseCommand {
+    static description = 'Update a project GitHub binding rules (environment mapping + sync/binding/autoclose flags); only the passed fields change';
+    static examples = [
+        '<%= config.bin %> projects github-update -p LBRA --production-environment-id <env-uuid>',
+        '<%= config.bin %> projects github-update -p LBRA --no-tag-binding-enabled',
+        '<%= config.bin %> projects github-update -p LBRA --default-branch main --autoclose-on-merge',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        'default-branch': core_1.Flags.string({ description: 'Default base branch used to create branches/PRs' }),
+        'production-environment-id': core_1.Flags.string({
+            description: 'Environment id mapped to STABLE tags (production target)',
+        }),
+        'staging-environment-id': core_1.Flags.string({
+            description: 'Environment id mapped to PRE-RELEASE tags (staging target)',
+        }),
+        'sync-enabled': core_1.Flags.boolean({ allowNo: true, description: 'Enable/disable processing of webhook events' }),
+        'tag-binding-enabled': core_1.Flags.boolean({ allowNo: true, description: 'Enable/disable tag→release live binding' }),
+        'autoclose-on-merge': core_1.Flags.boolean({
+            allowNo: true,
+            description: 'Enable/disable moving the ticket to done on PR merge',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProjectsGithubUpdate);
+        const projectId = await this.resolveProjectId(flags.project);
+        const body = {};
+        if (flags['default-branch'] !== undefined)
+            body.default_branch = flags['default-branch'];
+        if (flags['production-environment-id'] !== undefined)
+            body.production_environment_id = flags['production-environment-id'];
+        if (flags['staging-environment-id'] !== undefined)
+            body.staging_environment_id = flags['staging-environment-id'];
+        if (flags['sync-enabled'] !== undefined)
+            body.sync_enabled = flags['sync-enabled'];
+        if (flags['tag-binding-enabled'] !== undefined)
+            body.tag_binding_enabled = flags['tag-binding-enabled'];
+        if (flags['autoclose-on-merge'] !== undefined)
+            body.autoclose_on_merge = flags['autoclose-on-merge'];
+        // The GitHub action responds to both PATCH and PUT (Rails singleton `resource` update); the CLI
+        // transport speaks PUT — the backend applies only the keys present in the body either way.
+        const res = await this.api.put(`/cli/v1/projects/${encodeURIComponent(projectId)}/github`, body);
+        if (!this.jsonEnabled()) {
+            this.log('GitHub integration updated:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = ProjectsGithubUpdate;

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

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

package/dist/commands/projects/github.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class ProjectsGithub extends base_1.BaseCommand {
+    static description = 'Show a project GitHub integration (repo link + tag→release binding rules)';
+    static examples = [
+        '<%= config.bin %> projects github --project legalbloom-rails',
+        '<%= config.bin %> projects github -p LBRA',
+        '<%= config.bin %> projects github -p LBRA --json',
+    ];
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { flags } = await this.parse(ProjectsGithub);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.get(`/cli/v1/projects/${encodeURIComponent(projectId)}/github`);
+        if (!this.jsonEnabled()) {
+            const data = res.data ?? {};
+            // Flatten the repository block into a single record: unset fields render as `-` when not connected.
+            const repo = (data.repository ?? {});
+            this.log('GitHub integration:');
+            this.log((0, output_1.renderRecord)({
+                project_id: data.project_id,
+                installed: data.installed,
+                connected: data.connected,
+                full_name: repo.full_name,
+                default_branch: repo.default_branch,
+                sync_enabled: repo.sync_enabled,
+                tag_binding_enabled: repo.tag_binding_enabled,
+                autoclose_on_merge: repo.autoclose_on_merge,
+                production_environment_id: repo.production_environment_id,
+                staging_environment_id: repo.staging_environment_id,
+            }));
+        }
+        return res;
+    }
+}
+exports.default = ProjectsGithub;

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

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

package/dist/commands/tickets/branch.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 TicketsBranch extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
+    };
+    static description = 'Create a GitHub branch from a ticket (name prefixed with the ticket code)';
+    static examples = [
+        '<%= config.bin %> tickets branch DRFL-3 --project driverone-flutter',
+        '<%= config.bin %> tickets branch DRFL-3 -p driverone-flutter --json',
+    ];
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(TicketsBranch);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.post(`/cli/v1/projects/${encodeURIComponent(projectId)}/tickets/${encodeURIComponent(args.id)}/github/branch`);
+        if (!this.jsonEnabled()) {
+            this.log('Branch created:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsBranch;

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

@@ -3,15 +3,23 @@ export default class TicketsCreate extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        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>;
         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>;
         'step-given': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'step-when': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'step-then': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'step-expected': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        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>;
+        '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>;
     };
     run(): Promise<unknown>;

package/dist/commands/tickets/create.js

@@ -3,47 +3,29 @@ 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_body_1 = require("../../lib/ticket-body");
 class TicketsCreate extends base_1.BaseCommand {
     static description = 'Create a ticket';
     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"',
     ];
     static flags = {
         ...base_1.projectFlag,
         title: core_1.Flags.string({ description: 'Ticket title', required: true }),
-        kind: core_1.Flags.string({ description: 'Ticket kind', default: 'bug' }),
-        description: core_1.Flags.string({ description: 'Free-form description' }),
-        'step-given': core_1.Flags.string({ description: 'Given (precondition)' }),
-        'step-when': core_1.Flags.string({ description: 'When (action)' }),
-        'step-then': core_1.Flags.string({ description: 'Then (outcome)' }),
-        'step-expected': core_1.Flags.string({ description: 'Expected result' }),
-        'status-id': core_1.Flags.string({ description: 'Status lookup id' }),
-        'priority-id': core_1.Flags.string({ description: 'Priority lookup id' }),
+        kind: core_1.Flags.string({ description: 'Ticket kind (bug, feature, improvement)', default: 'bug' }),
+        ...ticket_body_1.ticketBodyFlags,
     };
     async run() {
         const { flags } = await this.parse(TicketsCreate);
         const projectId = await this.resolveProjectId(flags.project);
         const body = { title: flags.title, kind: flags.kind };
-        if (flags.description !== undefined)
-            body.description = flags.description;
-        if (flags['step-given'] !== undefined)
-            body.step_given = flags['step-given'];
-        if (flags['step-when'] !== undefined)
-            body.step_when = flags['step-when'];
-        if (flags['step-then'] !== undefined)
-            body.step_then = flags['step-then'];
-        if (flags['step-expected'] !== undefined)
-            body.step_expected = flags['step-expected'];
-        if (flags['status-id'] !== undefined)
-            body.status_id = flags['status-id'];
-        if (flags['priority-id'] !== undefined)
-            body.priority_id = flags['priority-id'];
+        (0, ticket_body_1.applyTicketBody)(body, flags);
         const res = await this.api.post(`/cli/v1/projects/${projectId}/tickets`, body);
         if (!this.jsonEnabled()) {
-            const ticket = res.data ?? {};
             this.log('Ticket created:');
-            this.log((0, output_1.renderRecord)(ticket));
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
         }
         return res;
     }

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

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

package/dist/commands/tickets/pr.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 TicketsPr extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
+    };
+    static description = 'Open a GitHub pull request from a ticket (head = the ticket branch, title prefixed with the code)';
+    static examples = [
+        '<%= config.bin %> tickets pr DRFL-3 --project driverone-flutter',
+        '<%= config.bin %> tickets pr DRFL-3 -p driverone-flutter --json',
+    ];
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(TicketsPr);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.post(`/cli/v1/projects/${encodeURIComponent(projectId)}/tickets/${encodeURIComponent(args.id)}/github/pull_request`);
+        if (!this.jsonEnabled()) {
+            this.log('Pull request opened:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsPr;

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

@@ -14,4 +14,6 @@ export default class TicketsShow extends BaseCommand {
     private renderAttachments;
     private renderComments;
     private renderTicket;
+    private renderScenarios;
+    private renderConditions;
 }

package/dist/commands/tickets/show.js

@@ -88,20 +88,46 @@ class TicketsShow extends base_1.BaseCommand {
             created_at: ticket.created_at,
             updated_at: ticket.updated_at,
         }));
-        // Multi-line body blocks: description first, then the 4 BDD clauses (only those present).
-        const blocks = [
+        // Body: description + technical analysis (only if present).
+        const scalarBlocks = [
             ['Description', ticket.description],
-            ['Given', ticket.step_given],
-            ['When', ticket.step_when],
-            ['Then', ticket.step_then],
-            ['Expected', ticket.step_expected],
+            ['Technical analysis', ticket.technical_analysis],
         ];
-        for (const [label, value] of blocks) {
+        for (const [label, value] of scalarBlocks) {
             if (value === null || value === undefined || String(value).trim() === '')
                 continue;
             this.log(`\n${label}\n${'-'.repeat(label.length)}`);
             this.log((0, output_1.sanitizeMultiline)(value));
         }
+        this.renderScenarios(Array.isArray(ticket.scenarios) ? ticket.scenarios : []);
+        this.renderConditions(Array.isArray(ticket.conditions) ? ticket.conditions : []);
+    }
+    // BDD scenarios: one block per scenario, only the steps present.
+    renderScenarios(scenarios) {
+        const steps = [
+            ['Given', 'step_given'],
+            ['When', 'step_when'],
+            ['Then', 'step_then'],
+            ['Expected', 'step_expected'],
+        ];
+        scenarios.forEach((scenario, index) => {
+            const title = scenario.title ? `Scenario ${index + 1}: ${(0, output_1.sanitize)(scenario.title)}` : `Scenario ${index + 1}`;
+            this.log(`\n${title}\n${'-'.repeat(title.length)}`);
+            for (const [label, key] of steps) {
+                const value = scenario[key];
+                if (value === null || value === undefined || String(value).trim() === '')
+                    continue;
+                this.log(`${label}: ${(0, output_1.sanitizeMultiline)(value)}`);
+            }
+        });
+    }
+    // Definition of Done: one bullet per condition.
+    renderConditions(conditions) {
+        if (conditions.length === 0)
+            return;
+        this.log('\nDefinition of Done\n------------------');
+        for (const condition of conditions)
+            this.log(`- ${(0, output_1.sanitizeMultiline)(condition.text ?? '')}`);
     }
 }
 exports.default = TicketsShow;

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

@@ -6,19 +6,23 @@ export default class TicketsUpdate extends BaseCommand {
         id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        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>;
         description: 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>;
+        '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>;
         'step-given': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'step-when': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'step-then': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'step-expected': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        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>;
         '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>;

package/dist/commands/tickets/update.js

@@ -3,13 +3,14 @@ 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_body_1 = require("../../lib/ticket-body");
 class TicketsUpdate extends base_1.BaseCommand {
     // PUT /cli/v1/projects/:p/tickets/:id maps to Ticketing::UpdateTicket, a full replace:
     // fields you omit are cleared server-side. Pass the complete desired state, not a partial patch.
     static description = 'Update a ticket (full replace — fields you omit are cleared server-side)';
     static examples = [
         '<%= config.bin %> tickets update <ticket-id> --project acme-api --title "New title"',
-        '<%= config.bin %> tickets update <ticket-id> -p acme-api --title "Login bug" --kind bug --step-given "logged out" --step-when "I submit" --step-then "it 500s" --step-expected "dashboard loads"',
+        '<%= config.bin %> tickets update <ticket-id> -p acme-api --title "Login bug" --scenarios \'[{"step_given":"logged out","step_when":"I submit","step_then":"it 500s","step_expected":"dashboard loads"}]\' --condition "login works"',
     ];
     static args = {
         id: core_1.Args.string({ description: 'Ticket id', required: true }),
@@ -18,17 +19,7 @@ class TicketsUpdate extends base_1.BaseCommand {
         ...base_1.projectFlag,
         title: core_1.Flags.string({ description: 'Ticket title' }),
         kind: core_1.Flags.string({ description: 'Ticket kind (bug, feature, improvement)' }),
-        description: core_1.Flags.string({ description: 'Free-form description' }),
-        weight: core_1.Flags.string({ description: 'Story points (positive integer)' }),
-        'step-given': core_1.Flags.string({ description: 'Given (precondition)' }),
-        'step-when': core_1.Flags.string({ description: 'When (action)' }),
-        'step-then': core_1.Flags.string({ description: 'Then (outcome)' }),
-        'step-expected': core_1.Flags.string({ description: 'Expected result' }),
-        'status-id': core_1.Flags.string({ description: 'Status lookup id' }),
-        '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)' }),
-        'platform-id': core_1.Flags.string({ description: 'Affected platform id (repeatable)', multiple: true }),
+        ...ticket_body_1.ticketBodyFlags,
     };
     async run() {
         const { args, flags } = await this.parse(TicketsUpdate);
@@ -38,28 +29,7 @@ class TicketsUpdate extends base_1.BaseCommand {
             body.title = flags.title;
         if (flags.kind !== undefined)
             body.kind = flags.kind;
-        if (flags.description !== undefined)
-            body.description = flags.description;
-        if (flags.weight !== undefined)
-            body.weight = flags.weight;
-        if (flags['step-given'] !== undefined)
-            body.step_given = flags['step-given'];
-        if (flags['step-when'] !== undefined)
-            body.step_when = flags['step-when'];
-        if (flags['step-then'] !== undefined)
-            body.step_then = flags['step-then'];
-        if (flags['step-expected'] !== undefined)
-            body.step_expected = flags['step-expected'];
-        if (flags['status-id'] !== undefined)
-            body.status_id = flags['status-id'];
-        if (flags['priority-id'] !== undefined)
-            body.priority_id = flags['priority-id'];
-        if (flags['assignee-id'] !== undefined)
-            body.assignee_id = flags['assignee-id'];
-        if (flags['milestone-id'] !== undefined)
-            body.milestone_id = flags['milestone-id'];
-        if (flags['platform-id'] !== undefined)
-            body.platform_ids = flags['platform-id'];
+        (0, ticket_body_1.applyTicketBody)(body, flags);
         const res = await this.api.put(`/cli/v1/projects/${projectId}/tickets/${args.id}`, body);
         if (!this.jsonEnabled()) {
             this.log('Ticket updated:');

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

@@ -0,0 +1,24 @@
+export declare const ticketBodyFlags: {
+    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>;
+    'step-given': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'step-when': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'step-then': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'step-expected': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    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>;
+    'platform-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+};
+type BodyFlags = Record<string, unknown>;
+export declare function scenariosFromFlags(flags: BodyFlags): Array<Record<string, unknown>> | undefined;
+export declare function conditionsFromFlags(flags: BodyFlags): Array<{
+    text: string;
+}> | undefined;
+export declare function applyTicketBody(body: BodyFlags, flags: BodyFlags): void;
+export {};

package/dist/lib/ticket-body.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ticketBodyFlags = void 0;
+exports.scenariosFromFlags = scenariosFromFlags;
+exports.conditionsFromFlags = conditionsFromFlags;
+exports.applyTicketBody = applyTicketBody;
+const core_1 = require("@oclif/core");
+// Flag del corpo ticket condivisi da `tickets create` e `tickets update`: descrizione (sommario
+// human-simple) + N scenari BDD + N condizioni DoD + analisi tecnica (registro tecnico separato) +
+// metadati. Gli scenari si passano come JSON (--scenarios) oppure, per un SINGOLO scenario, con le
+// scorciatoie --step-*. Le condizioni DoD sono --condition (ripetibile). Parità piena col form web.
+exports.ticketBodyFlags = {
+    description: core_1.Flags.string({ description: 'Free-form description (human-simple summary)' }),
+    'technical-analysis': core_1.Flags.string({ description: 'Technical analysis (stack, cause) — kept out of the human-simple body' }),
+    scenarios: core_1.Flags.string({
+        description: 'BDD scenarios as a JSON array: [{"title","step_given","step_when","step_then","step_expected"}]',
+    }),
+    'step-given': core_1.Flags.string({ description: 'Shorthand for a single scenario: Given (precondition)' }),
+    'step-when': core_1.Flags.string({ description: 'Shorthand for a single scenario: When (action)' }),
+    'step-then': core_1.Flags.string({ description: 'Shorthand for a single scenario: Then (outcome)' }),
+    'step-expected': core_1.Flags.string({ description: 'Shorthand for a single scenario: Expected result' }),
+    condition: core_1.Flags.string({ description: 'Definition-of-Done line (repeatable)', multiple: true }),
+    weight: core_1.Flags.string({ description: 'Story points (positive integer)' }),
+    'due-at': core_1.Flags.string({ description: 'Due date (ISO 8601)' }),
+    'status-id': core_1.Flags.string({ description: 'Status lookup id' }),
+    '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)' }),
+    'platform-id': core_1.Flags.string({ description: 'Affected platform id (repeatable)', multiple: true }),
+};
+const STEP_KEYS = [
+    ['step-given', 'step_given'],
+    ['step-when', 'step_when'],
+    ['step-then', 'step_then'],
+    ['step-expected', 'step_expected'],
+];
+// Scenari da --scenarios (JSON) OPPURE dalle scorciatoie --step-* (un solo scenario). undefined se assenti.
+function scenariosFromFlags(flags) {
+    if (flags.scenarios !== undefined) {
+        let parsed;
+        try {
+            parsed = JSON.parse(flags.scenarios);
+        }
+        catch {
+            throw new Error('--scenarios must be a valid JSON array');
+        }
+        if (!Array.isArray(parsed))
+            throw new Error('--scenarios must be a JSON array');
+        return parsed;
+    }
+    const scenario = {};
+    for (const [flagKey, bodyKey] of STEP_KEYS) {
+        if (flags[flagKey] !== undefined)
+            scenario[bodyKey] = flags[flagKey];
+    }
+    return Object.keys(scenario).length > 0 ? [scenario] : undefined;
+}
+// Condizioni DoD da --condition (ripetibile). undefined se assenti.
+function conditionsFromFlags(flags) {
+    const conditions = flags.condition;
+    if (conditions === undefined)
+        return undefined;
+    return conditions.map((text) => ({ text }));
+}
+// Popola `body` coi campi del corpo presenti nei flag (chiavi snake_case attese dall'API CLI).
+function applyTicketBody(body, flags) {
+    if (flags.description !== undefined)
+        body.description = flags.description;
+    if (flags['technical-analysis'] !== undefined)
+        body.technical_analysis = flags['technical-analysis'];
+    if (flags.weight !== undefined)
+        body.weight = flags.weight;
+    if (flags['due-at'] !== undefined)
+        body.due_at = flags['due-at'];
+    if (flags['status-id'] !== undefined)
+        body.status_id = flags['status-id'];
+    if (flags['priority-id'] !== undefined)
+        body.priority_id = flags['priority-id'];
+    if (flags['assignee-id'] !== undefined)
+        body.assignee_id = flags['assignee-id'];
+    if (flags['milestone-id'] !== undefined)
+        body.milestone_id = flags['milestone-id'];
+    if (flags['platform-id'] !== undefined)
+        body.platform_ids = flags['platform-id'];
+    const scenarios = scenariosFromFlags(flags);
+    if (scenarios !== undefined)
+        body.scenarios_attributes = scenarios;
+    const conditions = conditionsFromFlags(flags);
+    if (conditions !== undefined)
+        body.conditions_attributes = conditions;
+}