linear-cli-agents 0.2.1 → 0.4.1

package/dist/commands/issues/archive.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class IssuesArchive extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        unarchive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/issues/archive.js

@@ -0,0 +1,83 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { success, print, printItem } from '../../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+import { resolveIssueId } from '../../lib/issue-utils.js';
+export default class IssuesArchive extends Command {
+    static description = 'Archive an issue';
+    static examples = [
+        '<%= config.bin %> issues archive ENG-123',
+        '<%= config.bin %> issues archive ENG-123 --unarchive',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Issue ID or identifier (e.g., ENG-123)',
+            required: true,
+        }),
+    };
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+        unarchive: Flags.boolean({
+            char: 'u',
+            description: 'Unarchive instead of archive',
+            default: false,
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(IssuesArchive);
+            const format = flags.format;
+            const client = getClient();
+            const issueId = await resolveIssueId(client, args.id);
+            let payload;
+            if (flags.unarchive) {
+                payload = await client.unarchiveIssue(issueId);
+            }
+            else {
+                payload = await client.archiveIssue(issueId);
+            }
+            if (!payload.success) {
+                const action = flags.unarchive ? 'unarchive' : 'archive';
+                throw new CliError(ErrorCodes.API_ERROR, `Failed to ${action} issue`);
+            }
+            const issue = await payload.issue;
+            if (!issue) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Issue not found in response');
+            }
+            const action = flags.unarchive ? 'unarchived' : 'archived';
+            const data = {
+                id: issue.id,
+                identifier: issue.identifier,
+                title: issue.title,
+                action,
+                archivedAt: issue.archivedAt,
+                url: issue.url,
+            };
+            if (format === 'json') {
+                print(success(data));
+            }
+            else if (format === 'table') {
+                printItem({
+                    id: data.id,
+                    identifier: data.identifier,
+                    title: data.title,
+                    action: data.action,
+                    archivedAt: data.archivedAt ?? 'N/A',
+                    url: data.url,
+                }, format);
+            }
+            else {
+                console.log(data.identifier);
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/issues/remove-labels.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class IssuesRemoveLabels extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'label-ids': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/issues/remove-labels.js

@@ -0,0 +1,90 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { success, print, printItem } from '../../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+import { resolveIssueId } from '../../lib/issue-utils.js';
+export default class IssuesRemoveLabels extends Command {
+    static description = 'Remove labels from an issue';
+    static examples = ['<%= config.bin %> issues remove-labels ENG-123 --label-ids LABEL_ID1,LABEL_ID2'];
+    static args = {
+        id: Args.string({
+            description: 'Issue ID or identifier (e.g., ENG-123)',
+            required: true,
+        }),
+    };
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+        'label-ids': Flags.string({
+            description: 'Comma-separated label IDs to remove',
+            required: true,
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(IssuesRemoveLabels);
+            const format = flags.format;
+            const client = getClient();
+            const issueId = await resolveIssueId(client, args.id);
+            const issue = await client.issue(issueId);
+            if (!issue) {
+                throw new CliError(ErrorCodes.NOT_FOUND, `Issue ${args.id} not found`);
+            }
+            // Get existing labels
+            const existingLabels = await issue.labels();
+            const existingLabelIds = existingLabels.nodes.map((l) => l.id);
+            // Parse label IDs to remove
+            const labelIdsToRemove = flags['label-ids'].split(',').map((id) => id.trim());
+            // Filter out the labels to remove
+            const remainingLabelIds = existingLabelIds.filter((id) => !labelIdsToRemove.includes(id));
+            // Update the issue with remaining labels
+            const payload = await client.updateIssue(issueId, {
+                labelIds: remainingLabelIds,
+            });
+            if (!payload.success) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to remove labels from issue');
+            }
+            const updatedIssue = await payload.issue;
+            if (!updatedIssue) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Issue not found in response');
+            }
+            const labels = await updatedIssue.labels();
+            const data = {
+                id: updatedIssue.id,
+                identifier: updatedIssue.identifier,
+                title: updatedIssue.title,
+                labels: labels.nodes.map((l) => ({
+                    id: l.id,
+                    name: l.name,
+                    color: l.color,
+                })),
+                labelsRemoved: labelIdsToRemove.filter((id) => existingLabelIds.includes(id)),
+                url: updatedIssue.url,
+            };
+            if (format === 'json') {
+                print(success(data));
+            }
+            else if (format === 'table') {
+                printItem({
+                    id: data.id,
+                    identifier: data.identifier,
+                    title: data.title,
+                    labels: data.labels.map((l) => l.name).join(', ') || 'None',
+                    labelsRemoved: data.labelsRemoved.length,
+                    url: data.url,
+                }, format);
+            }
+            else {
+                console.log(data.identifier);
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class LabelsCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        color: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'team-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'parent-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/labels/create.js

@@ -0,0 +1,102 @@
+import { Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { success, print, printItem } from '../../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+export default class LabelsCreate extends Command {
+    static description = 'Create a label';
+    static examples = [
+        '<%= config.bin %> labels create --name "Bug" --color "#FF0000"',
+        '<%= config.bin %> labels create --name "Feature" --color "#00FF00" --description "New feature requests"',
+        '<%= config.bin %> labels create --name "Backend" --color "#0000FF" --team-id TEAM_ID',
+        '<%= config.bin %> labels create --name "API" --color "#FF00FF" --parent-id PARENT_LABEL_ID',
+    ];
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+        name: Flags.string({
+            char: 'n',
+            description: 'Label name',
+            required: true,
+        }),
+        color: Flags.string({
+            char: 'c',
+            description: 'Label color (hex, e.g., #FF0000)',
+            required: true,
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'Label description',
+        }),
+        'team-id': Flags.string({
+            description: 'Team ID (for team-specific labels)',
+        }),
+        'parent-id': Flags.string({
+            description: 'Parent label ID (for nested labels)',
+        }),
+    };
+    async run() {
+        try {
+            const { flags } = await this.parse(LabelsCreate);
+            const format = flags.format;
+            const client = getClient();
+            const payload = await client.createIssueLabel({
+                name: flags.name,
+                color: flags.color,
+                description: flags.description,
+                teamId: flags['team-id'],
+                parentId: flags['parent-id'],
+            });
+            if (!payload.success || !payload.issueLabel) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to create label');
+            }
+            const label = await payload.issueLabel;
+            const [team, parent] = await Promise.all([label.team, label.parent]);
+            const data = {
+                id: label.id,
+                name: label.name,
+                color: label.color,
+                description: label.description,
+                isGroup: label.isGroup,
+                team: team
+                    ? {
+                        id: team.id,
+                        key: team.key,
+                        name: team.name,
+                    }
+                    : null,
+                parent: parent
+                    ? {
+                        id: parent.id,
+                        name: parent.name,
+                    }
+                    : null,
+                createdAt: label.createdAt,
+            };
+            if (format === 'json') {
+                print(success(data));
+            }
+            else if (format === 'table') {
+                printItem({
+                    id: data.id,
+                    name: data.name,
+                    color: data.color,
+                    description: data.description ?? 'N/A',
+                    team: data.team?.key ?? 'Workspace',
+                    parent: data.parent?.name ?? 'N/A',
+                    createdAt: data.createdAt,
+                }, format);
+            }
+            else {
+                console.log(data.id);
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/labels/delete.d.ts

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

package/dist/commands/labels/delete.js

@@ -0,0 +1,50 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { success, print } from '../../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+export default class LabelsDelete extends Command {
+    static description = 'Delete a label';
+    static examples = ['<%= config.bin %> labels delete LABEL_ID'];
+    static args = {
+        id: Args.string({
+            description: 'Label ID',
+            required: true,
+        }),
+    };
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(LabelsDelete);
+            const format = flags.format;
+            const client = getClient();
+            const payload = await client.deleteIssueLabel(args.id);
+            if (!payload.success) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to delete label');
+            }
+            const data = {
+                id: args.id,
+                deleted: true,
+            };
+            if (format === 'json') {
+                print(success(data));
+            }
+            else if (format === 'table') {
+                console.log(`Label ${args.id} deleted successfully`);
+            }
+            else {
+                console.log(args.id);
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

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

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class LabelsList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        team: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        first: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        after: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/labels/list.js

@@ -0,0 +1,117 @@
+import { Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { successList, print, printList } from '../../lib/output.js';
+import { handleError } from '../../lib/errors.js';
+import { colors, truncate } from '../../lib/formatter.js';
+const COLUMNS = [
+    {
+        key: 'name',
+        header: 'NAME',
+        format: (value, row) => {
+            const name = String(value);
+            if (row.isGroup) {
+                return colors.bold(name) + colors.dim(' (group)');
+            }
+            return colors.bold(name);
+        },
+    },
+    {
+        key: 'color',
+        header: 'COLOR',
+        format: (value) => colors.dim(String(value)),
+    },
+    {
+        key: 'description',
+        header: 'DESCRIPTION',
+        format: (value) => truncate(String(value ?? ''), 40),
+    },
+];
+export default class LabelsList extends Command {
+    static description = 'List labels in the workspace';
+    static examples = [
+        '<%= config.bin %> labels list',
+        '<%= config.bin %> labels list --format table',
+        '<%= config.bin %> labels list --team ENG',
+    ];
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+        team: Flags.string({
+            char: 't',
+            description: 'Filter by team key (e.g., ENG)',
+        }),
+        first: Flags.integer({
+            description: 'Number of labels to fetch (default: 100)',
+            default: 100,
+        }),
+        after: Flags.string({
+            description: 'Cursor for pagination',
+        }),
+    };
+    async run() {
+        try {
+            const { flags } = await this.parse(LabelsList);
+            const format = flags.format;
+            const client = getClient();
+            let labels;
+            if (flags.team) {
+                // Fetch labels for a specific team
+                const teams = await client.teams({
+                    filter: { key: { eq: flags.team } },
+                });
+                const team = teams.nodes[0];
+                if (!team) {
+                    throw new Error(`Team ${flags.team} not found`);
+                }
+                labels = await team.labels({
+                    first: flags.first,
+                    after: flags.after,
+                });
+            }
+            else {
+                // Fetch all workspace labels (issueLabels returns workspace labels)
+                labels = await client.issueLabels({
+                    first: flags.first,
+                    after: flags.after,
+                });
+            }
+            const data = await Promise.all(labels.nodes.map(async (label) => {
+                const parent = await label.parent;
+                return {
+                    id: label.id,
+                    name: label.name,
+                    color: label.color,
+                    description: label.description ?? undefined,
+                    isGroup: label.isGroup,
+                    parentId: parent?.id,
+                    createdAt: label.createdAt,
+                };
+            }));
+            const pageInfo = {
+                hasNextPage: labels.pageInfo.hasNextPage,
+                hasPreviousPage: labels.pageInfo.hasPreviousPage,
+                startCursor: labels.pageInfo.startCursor,
+                endCursor: labels.pageInfo.endCursor,
+            };
+            if (format === 'json') {
+                print(successList(data, pageInfo));
+            }
+            else {
+                printList(data, format, {
+                    columns: COLUMNS,
+                    primaryKey: 'name',
+                    secondaryKey: 'description',
+                    pageInfo,
+                });
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

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

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class LabelsUpdate extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        color: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'parent-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/labels/update.js

@@ -0,0 +1,109 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getClient } from '../../lib/client.js';
+import { success, print, printItem } from '../../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../../lib/errors.js';
+export default class LabelsUpdate extends Command {
+    static description = 'Update a label';
+    static examples = [
+        '<%= config.bin %> labels update LABEL_ID --name "Updated Name"',
+        '<%= config.bin %> labels update LABEL_ID --color "#00FF00"',
+        '<%= config.bin %> labels update LABEL_ID --description "New description"',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Label ID',
+            required: true,
+        }),
+    };
+    static flags = {
+        format: Flags.string({
+            char: 'F',
+            description: 'Output format',
+            options: ['json', 'table', 'plain'],
+            default: 'json',
+        }),
+        name: Flags.string({
+            char: 'n',
+            description: 'Label name',
+        }),
+        color: Flags.string({
+            char: 'c',
+            description: 'Label color (hex, e.g., #FF0000)',
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'Label description',
+        }),
+        'parent-id': Flags.string({
+            description: 'Parent label ID',
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(LabelsUpdate);
+            const format = flags.format;
+            const client = getClient();
+            const input = {};
+            if (flags.name)
+                input.name = flags.name;
+            if (flags.color)
+                input.color = flags.color;
+            if (flags.description)
+                input.description = flags.description;
+            if (flags['parent-id'])
+                input.parentId = flags['parent-id'];
+            if (Object.keys(input).length === 0) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, 'At least one field to update is required');
+            }
+            const payload = await client.updateIssueLabel(args.id, input);
+            if (!payload.success || !payload.issueLabel) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to update label');
+            }
+            const label = await payload.issueLabel;
+            const [team, parent] = await Promise.all([label.team, label.parent]);
+            const data = {
+                id: label.id,
+                name: label.name,
+                color: label.color,
+                description: label.description,
+                isGroup: label.isGroup,
+                team: team
+                    ? {
+                        id: team.id,
+                        key: team.key,
+                        name: team.name,
+                    }
+                    : null,
+                parent: parent
+                    ? {
+                        id: parent.id,
+                        name: parent.name,
+                    }
+                    : null,
+                createdAt: label.createdAt,
+                updatedAt: label.updatedAt,
+            };
+            if (format === 'json') {
+                print(success(data));
+            }
+            else if (format === 'table') {
+                printItem({
+                    id: data.id,
+                    name: data.name,
+                    color: data.color,
+                    description: data.description ?? 'N/A',
+                    team: data.team?.key ?? 'Workspace',
+                    parent: data.parent?.name ?? 'N/A',
+                    updatedAt: data.updatedAt,
+                }, format);
+            }
+            else {
+                console.log(data.id);
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/me.js

@@ -5,11 +5,7 @@ import { handleError } from '../lib/errors.js';
 export default class Me extends Command {
     static description = 'Show current user information';
     static aliases = ['whoami'];
-    static examples = [
-        '<%= config.bin %> me',
-        '<%= config.bin %> me --format table',
-        '<%= config.bin %> whoami',
-    ];
+    static examples = ['<%= config.bin %> me', '<%= config.bin %> me --format table', '<%= config.bin %> whoami'];
     static flags = {
         format: Flags.string({
             char: 'F',

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

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class MilestonesCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        projectId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}