linear-cli-agents 0.6.0 → 0.7.0

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

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export default class InitiativesUpdate extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: 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>;
+        status: 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>;
+        'owner-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        icon: 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>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/initiatives/update.js

@@ -0,0 +1,90 @@
+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';
+import { LinearDocument } from '@linear/sdk';
+const InitiativeStatus = LinearDocument.InitiativeStatus;
+export default class InitiativesUpdate extends Command {
+    static description = 'Update an initiative';
+    static examples = [
+        '<%= config.bin %> initiatives update INITIATIVE_ID --name "New Name"',
+        '<%= config.bin %> initiatives update INITIATIVE_ID --status Completed',
+        '<%= config.bin %> initiatives update INITIATIVE_ID --target-date 2024-12-31',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Initiative ID',
+            required: true,
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            char: 'n',
+            description: 'New initiative name',
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'New description',
+        }),
+        status: Flags.string({
+            char: 's',
+            description: 'New status',
+            options: ['Planned', 'Active', 'Completed'],
+        }),
+        'target-date': Flags.string({
+            description: 'New target completion date (YYYY-MM-DD)',
+        }),
+        'owner-id': Flags.string({
+            description: 'New owner user ID',
+        }),
+        icon: Flags.string({
+            description: 'New initiative icon (emoji)',
+        }),
+        color: Flags.string({
+            description: 'New initiative color (hex)',
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(InitiativesUpdate);
+            const client = getClient();
+            const input = {};
+            if (flags.name)
+                input.name = flags.name;
+            if (flags.description)
+                input.description = flags.description;
+            if (flags.status) {
+                input.status = InitiativeStatus[flags.status];
+            }
+            if (flags['target-date'])
+                input.targetDate = flags['target-date'];
+            if (flags['owner-id'])
+                input.ownerId = flags['owner-id'];
+            if (flags.icon)
+                input.icon = flags.icon;
+            if (flags.color)
+                input.color = flags.color;
+            if (Object.keys(input).length === 0) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, 'No update fields provided');
+            }
+            const payload = await client.updateInitiative(args.id, input);
+            if (!payload.success) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to update initiative');
+            }
+            const initiative = await payload.initiative;
+            if (!initiative) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Initiative not returned');
+            }
+            print(success({
+                id: initiative.id,
+                name: initiative.name,
+                status: initiative.status,
+                updatedAt: initiative.updatedAt,
+            }));
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/issues/bulk-update.d.ts

@@ -10,6 +10,8 @@ export default class IssuesBulkUpdate extends Command {
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         estimate: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'label-ids': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'due-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'cycle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/issues/bulk-update.js

@@ -35,6 +35,12 @@ export default class IssuesBulkUpdate extends Command {
         'label-ids': Flags.string({
             description: 'Comma-separated label IDs (replaces existing labels)',
         }),
+        'due-date': Flags.string({
+            description: 'Due date (YYYY-MM-DD)',
+        }),
+        'cycle-id': Flags.string({
+            description: 'Cycle (sprint) ID',
+        }),
     };
     async run() {
         try {
@@ -55,6 +61,10 @@ export default class IssuesBulkUpdate extends Command {
                 input.estimate = flags.estimate;
             if (flags['label-ids'])
                 input.labelIds = flags['label-ids'].split(',').map((id) => id.trim());
+            if (flags['due-date'])
+                input.dueDate = flags['due-date'];
+            if (flags['cycle-id'])
+                input.cycleId = flags['cycle-id'];
             if (Object.keys(input).length === 0) {
                 throw new CliError(ErrorCodes.INVALID_INPUT, 'No update fields provided. Use at least one of: --state-id, --priority, --assignee-id, --project-id, --estimate, --label-ids');
             }

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

@@ -13,6 +13,8 @@ export default class IssuesCreate extends Command {
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         estimate: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'label-ids': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'due-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'cycle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/issues/create.js

@@ -46,6 +46,12 @@ export default class IssuesCreate extends Command {
         'label-ids': Flags.string({
             description: 'Comma-separated label IDs',
         }),
+        'due-date': Flags.string({
+            description: 'Due date (YYYY-MM-DD)',
+        }),
+        'cycle-id': Flags.string({
+            description: 'Cycle (sprint) ID',
+        }),
     };
     async run() {
         try {
@@ -89,6 +95,10 @@ export default class IssuesCreate extends Command {
                     input.estimate = flags.estimate;
                 if (flags['label-ids'])
                     input.labelIds = flags['label-ids'].split(',');
+                if (flags['due-date'])
+                    input.dueDate = flags['due-date'];
+                if (flags['cycle-id'])
+                    input.cycleId = flags['cycle-id'];
             }
             // Create the issue
             const payload = await client.createIssue(input);

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

@@ -7,6 +7,7 @@ export default class IssuesGet extends Command {
     };
     static flags: {
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'with-attachments': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/issues/get.js

@@ -8,6 +8,7 @@ export default class IssuesGet extends Command {
     static examples = [
         '<%= config.bin %> issues get ENG-123',
         '<%= config.bin %> issues get ENG-123 --format table',
+        '<%= config.bin %> issues get ENG-123 --with-attachments',
         '<%= config.bin %> issues get abc123',
     ];
     static args = {
@@ -23,6 +24,10 @@ export default class IssuesGet extends Command {
             options: ['json', 'table', 'plain'],
             default: 'json',
         }),
+        'with-attachments': Flags.boolean({
+            description: 'Include attachments (linked PRs, commits, etc.)',
+            default: false,
+        }),
     };
     async run() {
         try {
@@ -35,12 +40,13 @@ export default class IssuesGet extends Command {
                 throw new CliError(ErrorCodes.NOT_FOUND, `Issue ${args.id} not found`);
             }
             // Fetch related data
-            const [state, assignee, team, labels, comments] = await Promise.all([
+            const [state, assignee, team, labels, comments, attachments] = await Promise.all([
                 issue.state,
                 issue.assignee,
                 issue.team,
                 issue.labels(),
                 issue.comments(),
+                flags['with-attachments'] ? issue.attachments() : Promise.resolve(null),
             ]);
             const data = {
                 id: issue.id,
@@ -81,6 +87,17 @@ export default class IssuesGet extends Command {
                     color: label.color,
                 })),
                 commentsCount: comments.nodes.length,
+                ...(attachments && {
+                    attachments: attachments.nodes.map((attachment) => ({
+                        id: attachment.id,
+                        title: attachment.title,
+                        subtitle: attachment.subtitle ?? null,
+                        url: attachment.url,
+                        sourceType: attachment.sourceType ?? null,
+                        metadata: attachment.metadata,
+                        createdAt: attachment.createdAt,
+                    })),
+                }),
             };
             if (format === 'json') {
                 print(success(data));
@@ -96,6 +113,7 @@ export default class IssuesGet extends Command {
                     labels: data.labels.map((l) => l.name).join(', ') || 'None',
                     estimate: data.estimate ?? 'None',
                     comments: data.commentsCount,
+                    ...('attachments' in data && { attachments: data.attachments?.length ?? 0 }),
                     url: data.url,
                     createdAt: data.createdAt,
                     updatedAt: data.updatedAt,

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

@@ -15,6 +15,8 @@ export default class IssuesUpdate extends Command {
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         estimate: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'label-ids': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'due-date': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'cycle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/issues/update.js

@@ -48,6 +48,12 @@ export default class IssuesUpdate extends Command {
         'label-ids': Flags.string({
             description: 'Comma-separated label IDs (replaces existing labels)',
         }),
+        'due-date': Flags.string({
+            description: 'Due date (YYYY-MM-DD, use empty string to clear)',
+        }),
+        'cycle-id': Flags.string({
+            description: 'Cycle (sprint) ID (use empty string to remove from cycle)',
+        }),
     };
     async run() {
         try {
@@ -84,6 +90,12 @@ export default class IssuesUpdate extends Command {
                     input.estimate = flags.estimate;
                 if (flags['label-ids'])
                     input.labelIds = flags['label-ids'].split(',');
+                if (flags['due-date'] !== undefined) {
+                    input.dueDate = flags['due-date'] || null;
+                }
+                if (flags['cycle-id'] !== undefined) {
+                    input.cycleId = flags['cycle-id'] || null;
+                }
                 if (Object.keys(input).length === 0) {
                     throw new CliError(ErrorCodes.INVALID_INPUT, 'No update fields provided. Use --input or individual flags.');
                 }

package/dist/commands/upload.d.ts

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

package/dist/commands/upload.js

@@ -0,0 +1,117 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readFileSync, statSync, existsSync } from 'node:fs';
+import { basename, extname } from 'node:path';
+import { getClient } from '../lib/client.js';
+import { success, print } from '../lib/output.js';
+import { handleError, CliError, ErrorCodes } from '../lib/errors.js';
+const MIME_TYPES = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.pdf': 'application/pdf',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    '.txt': 'text/plain',
+    '.md': 'text/markdown',
+    '.json': 'application/json',
+    '.csv': 'text/csv',
+    '.zip': 'application/zip',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+};
+function getMimeType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return MIME_TYPES[ext] ?? 'application/octet-stream';
+}
+export default class Upload extends Command {
+    static description = 'Upload a file to Linear and get the asset URL';
+    static examples = [
+        '<%= config.bin %> upload ./screenshot.png',
+        '<%= config.bin %> upload ./document.pdf --content-type application/pdf',
+        '<%= config.bin %> upload ./image.png --markdown',
+    ];
+    static args = {
+        file: Args.string({
+            description: 'Path to the file to upload',
+            required: true,
+        }),
+    };
+    static flags = {
+        'content-type': Flags.string({
+            description: 'Override the content type (MIME type)',
+        }),
+        markdown: Flags.boolean({
+            char: 'm',
+            description: 'Output as markdown link/image',
+            default: false,
+        }),
+    };
+    async run() {
+        try {
+            const { args, flags } = await this.parse(Upload);
+            const client = getClient();
+            const filePath = args.file;
+            if (!existsSync(filePath)) {
+                throw new CliError(ErrorCodes.NOT_FOUND, `File not found: ${filePath}`);
+            }
+            const stats = statSync(filePath);
+            if (!stats.isFile()) {
+                throw new CliError(ErrorCodes.INVALID_INPUT, `Not a file: ${filePath}`);
+            }
+            const fileName = basename(filePath);
+            const contentType = flags['content-type'] ?? getMimeType(filePath);
+            const fileSize = stats.size;
+            const uploadPayload = await client.fileUpload(contentType, fileName, fileSize);
+            if (!uploadPayload.success || !uploadPayload.uploadFile) {
+                throw new CliError(ErrorCodes.API_ERROR, 'Failed to request upload URL');
+            }
+            const { uploadUrl, assetUrl } = uploadPayload.uploadFile;
+            const uploadHeaders = uploadPayload.uploadFile.headers;
+            const fileContent = readFileSync(filePath);
+            const headers = {
+                'Content-Type': contentType,
+                'Cache-Control': 'public, max-age=31536000',
+            };
+            for (const { key, value } of uploadHeaders) {
+                headers[key] = value;
+            }
+            const response = await fetch(uploadUrl, {
+                method: 'PUT',
+                headers,
+                body: fileContent,
+            });
+            if (!response.ok) {
+                throw new CliError(ErrorCodes.API_ERROR, `Upload failed: ${response.status} ${response.statusText}`);
+            }
+            if (flags.markdown) {
+                const isImage = contentType.startsWith('image/');
+                const markdown = isImage ? `![${fileName}](${assetUrl})` : `[${fileName}](${assetUrl})`;
+                print(success({
+                    assetUrl,
+                    markdown,
+                }));
+            }
+            else {
+                print(success({
+                    fileName,
+                    contentType,
+                    size: fileSize,
+                    assetUrl,
+                }));
+            }
+        }
+        catch (err) {
+            handleError(err);
+            this.exit(1);
+        }
+    }
+}