@bussolabs/closeyourit-cli 0.11.0 → 0.12.0

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base';
+export default class TicketsEligibility extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        allow: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        auto: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        block: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        reason: 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/eligibility.js

@@ -0,0 +1,46 @@
+"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 TicketsEligibility extends base_1.BaseCommand {
+    // Human override of the agent-eligibility gate (backend gates `tickets.edit`). A ticket reaches the
+    // autonomous agents only when it is `allowed`; the automatic verdict is produced by the backend.
+    // A human decision is sticky: re-evaluation never overwrites it, `--auto` is how you release it.
+    static description = 'Allow or block a ticket for autonomous agents (requires tickets.edit)';
+    static examples = [
+        '<%= config.bin %> tickets eligibility DRFL-3 --project acme-api --allow',
+        '<%= config.bin %> tickets eligibility DRFL-3 --project acme-api --block --reason "touches production data"',
+        '<%= config.bin %> tickets eligibility DRFL-3 --project acme-api --auto',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        allow: core_1.Flags.boolean({ description: 'Let autonomous agents work this ticket', exclusive: ['block', 'auto'] }),
+        auto: core_1.Flags.boolean({ description: 'Drop the human decision and re-evaluate automatically', exclusive: ['allow', 'block'] }),
+        block: core_1.Flags.boolean({ description: 'Keep this ticket for a human', exclusive: ['allow', 'auto'] }),
+        reason: core_1.Flags.string({ description: 'Why (shown next to the verdict; ignored with --auto)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsEligibility);
+        // One decision per call, and it must be explicit: defaulting would let a typo silently open the
+        // gate on a ticket someone meant to keep.
+        const decision = [
+            flags.allow ? 'allowed' : null,
+            flags.block ? 'blocked' : null,
+            flags.auto ? 'auto' : null,
+        ].find(Boolean);
+        if (!decision)
+            this.error('Pick one of --allow, --block or --auto.');
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/tickets/${args.id}/eligibility`, { eligibility: decision, ...(flags.reason ? { reason: flags.reason } : {}) });
+        if (!this.jsonEnabled()) {
+            this.log(`Ticket ${args.id} agent eligibility set to ${decision}:`);
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsEligibility;

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

@@ -3,6 +3,7 @@ export default class TicketsList extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        'agent-eligibility': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };

package/dist/commands/tickets/list.js

@@ -1,21 +1,44 @@
 "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");
+// Agent-eligibility gate: a ticket reaches the autonomous agents only when it is `allowed`.
+// Rendered short so the column stays scannable next to CODE.
+const AGENTS_MARK = {
+    allowed: 'yes',
+    blocked: 'no',
+    pending: '?',
+};
 class TicketsList extends base_1.BaseCommand {
     static description = 'List tickets for a project';
-    static examples = ['<%= config.bin %> tickets list --project acme-api', '<%= config.bin %> tickets list -p acme-api --json'];
-    static flags = { ...base_1.projectFlag, ...base_1.pageFlag };
+    static examples = [
+        '<%= config.bin %> tickets list --project acme-api',
+        '<%= config.bin %> tickets list -p acme-api --agent-eligibility pending',
+        '<%= config.bin %> tickets list -p acme-api --json',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        ...base_1.pageFlag,
+        'agent-eligibility': core_1.Flags.string({
+            description: 'Filter by agent eligibility',
+            options: ['pending', 'allowed', 'blocked'],
+        }),
+    };
     async run() {
         const { flags } = await this.parse(TicketsList);
         const projectId = await this.resolveProjectId(flags.project);
-        const res = await this.api.get(`/cli/v1/projects/${projectId}/tickets?page=${flags.page}`);
+        const query = new URLSearchParams({ page: String(flags.page) });
+        if (flags['agent-eligibility'])
+            query.set('agent_eligibility', flags['agent-eligibility']);
+        const res = await this.api.get(`/cli/v1/projects/${projectId}/tickets?${query.toString()}`);
         const tickets = res.data ?? [];
         if (!this.jsonEnabled()) {
-            this.log((0, output_1.renderTable)(['CODE', 'TITLE', 'STATUS'], tickets.map((ticket) => [
+            this.log((0, output_1.renderTable)(['CODE', 'TITLE', 'STATUS', 'AGENTS'], tickets.map((ticket) => [
                 String(ticket.code ?? ''),
                 String(ticket.title ?? ''),
                 (0, output_1.statusCell)(ticket.status, typeof ticket.status_color === 'string' ? ticket.status_color : undefined),
+                AGENTS_MARK[String(ticket.agent_eligibility ?? '')] ?? '',
             ])));
         }
         return res;

package/dist/commands/tickets/show.js

@@ -86,6 +86,11 @@ class TicketsShow extends base_1.BaseCommand {
             milestone: ticket.milestone,
             platforms: platforms || null,
             project_id: ticket.project_id,
+            // Agent-eligibility gate: whether the autonomous agents may work this ticket, and why.
+            // The reason is the part you act on — it is what tells you whether to override the verdict.
+            agent_eligibility: ticket.agent_eligibility,
+            agent_eligibility_source: ticket.agent_eligibility_source,
+            agent_eligibility_reason: ticket.agent_eligibility_reason,
             created_at: ticket.created_at,
             updated_at: ticket.updated_at,
         }));