@renseiai/plugin-linear 0.8.6

package/dist/src/tools/linear-plugin.js

@@ -0,0 +1,175 @@
+/**
+ * Linear Tool Plugin
+ *
+ * Exposes all Linear CLI commands as typed, in-process agent tools.
+ * Agents call these directly instead of shelling out to `pnpm af-linear`.
+ *
+ * Moved from packages/core/src/tools/plugins/linear.ts to keep
+ * Linear-specific tool code in the Linear package.
+ */
+import { z } from 'zod';
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { runLinear } from './linear-runner.js';
+function makeTools(apiKey, teamName) {
+    async function run(command, args = {}, positionalArgs = []) {
+        try {
+            const result = await runLinear({ command, args, positionalArgs, apiKey });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result.output, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    }
+    return [
+        tool('af_linear_get_issue', 'Get a Linear issue by ID or identifier', { issue_id: z.string().describe('Issue ID or identifier (e.g. SUP-123)') }, async (args) => run('get-issue', {}, [args.issue_id])),
+        tool('af_linear_create_issue', 'Create a new Linear issue', {
+            title: z.string().describe('Issue title'),
+            team: z.string().optional().describe('Team name (defaults to LINEAR_TEAM_NAME env var)'),
+            description: z.string().optional().describe('Issue description (markdown)'),
+            project: z.string().optional().describe('Project name'),
+            labels: z.array(z.string()).optional().describe('Label names'),
+            state: z.string().optional().describe('Initial state (e.g. "Backlog")'),
+            parent_id: z.string().optional().describe('Parent issue ID for sub-issues'),
+        }, async (args) => {
+            const cliArgs = {
+                title: args.title,
+            };
+            const team = args.team ?? teamName;
+            if (team)
+                cliArgs.team = team;
+            if (args.description)
+                cliArgs.description = args.description;
+            if (args.project)
+                cliArgs.project = args.project;
+            if (args.labels)
+                cliArgs.labels = args.labels;
+            if (args.state)
+                cliArgs.state = args.state;
+            if (args.parent_id)
+                cliArgs.parentId = args.parent_id;
+            return run('create-issue', cliArgs);
+        }),
+        tool('af_linear_update_issue', 'Update an existing Linear issue', {
+            issue_id: z.string().describe('Issue ID or identifier'),
+            title: z.string().optional().describe('New title'),
+            description: z.string().optional().describe('New description (markdown)'),
+            state: z.string().optional().describe('New state (e.g. "In Progress", "Done")'),
+            labels: z.array(z.string()).optional().describe('Label names to set'),
+        }, async (args) => {
+            const cliArgs = {};
+            if (args.title)
+                cliArgs.title = args.title;
+            if (args.description)
+                cliArgs.description = args.description;
+            if (args.state)
+                cliArgs.state = args.state;
+            if (args.labels)
+                cliArgs.labels = args.labels;
+            return run('update-issue', cliArgs, [args.issue_id]);
+        }),
+        tool('af_linear_list_comments', 'List comments on a Linear issue', { issue_id: z.string().describe('Issue ID or identifier') }, async (args) => run('list-comments', {}, [args.issue_id])),
+        tool('af_linear_create_comment', 'Add a comment to a Linear issue', {
+            issue_id: z.string().describe('Issue ID or identifier'),
+            body: z.string().describe('Comment text (markdown)'),
+        }, async (args) => run('create-comment', { body: args.body }, [args.issue_id])),
+        tool('af_linear_add_relation', 'Add a relation between two Linear issues', {
+            issue_id: z.string().describe('Source issue ID or identifier'),
+            related_issue_id: z.string().describe('Related issue ID or identifier'),
+            type: z.enum(['related', 'blocks', 'duplicate']).describe('Relation type'),
+        }, async (args) => run('add-relation', { type: args.type }, [args.issue_id, args.related_issue_id])),
+        tool('af_linear_list_relations', 'List relations for a Linear issue', { issue_id: z.string().describe('Issue ID or identifier') }, async (args) => run('list-relations', {}, [args.issue_id])),
+        tool('af_linear_remove_relation', 'Remove a relation between Linear issues', { relation_id: z.string().describe('Relation ID to remove') }, async (args) => run('remove-relation', {}, [args.relation_id])),
+        tool('af_linear_list_sub_issues', 'List sub-issues of a parent Linear issue with dependency graph', { issue_id: z.string().describe('Parent issue ID or identifier') }, async (args) => run('list-sub-issues', {}, [args.issue_id])),
+        tool('af_linear_list_sub_issue_statuses', 'List status of all sub-issues for a parent issue', { issue_id: z.string().describe('Parent issue ID or identifier') }, async (args) => run('list-sub-issue-statuses', {}, [args.issue_id])),
+        tool('af_linear_update_sub_issue', 'Update a sub-issue state and optionally add a comment', {
+            issue_id: z.string().describe('Sub-issue ID or identifier'),
+            state: z.string().optional().describe('New state (e.g. "Started", "Finished")'),
+            comment: z.string().optional().describe('Comment to add'),
+        }, async (args) => {
+            const cliArgs = {};
+            if (args.state)
+                cliArgs.state = args.state;
+            if (args.comment)
+                cliArgs.comment = args.comment;
+            return run('update-sub-issue', cliArgs, [args.issue_id]);
+        }),
+        tool('af_linear_check_blocked', 'Check if a Linear issue is blocked by other issues', { issue_id: z.string().describe('Issue ID or identifier') }, async (args) => run('check-blocked', {}, [args.issue_id])),
+        tool('af_linear_list_backlog_issues', 'List all backlog issues for a project', { project: z.string().describe('Project name') }, async (args) => run('list-backlog-issues', { project: args.project })),
+        tool('af_linear_list_unblocked_backlog', 'List unblocked backlog issues for a project (sorted by priority)', { project: z.string().describe('Project name') }, async (args) => run('list-unblocked-backlog', { project: args.project })),
+        tool('af_linear_check_deployment', 'Check deployment status of a pull request', {
+            pr_number: z.number().describe('Pull request number'),
+            format: z.enum(['json', 'markdown']).optional().describe('Output format (default: json)'),
+        }, async (args) => run('check-deployment', args.format ? { format: args.format } : {}, [String(args.pr_number)])),
+        tool('af_linear_list_issues', 'List Linear issues with filters (project, status, label, priority, assignee)', {
+            project: z.string().optional().describe('Filter by project name'),
+            status: z.string().optional().describe('Filter by status (Icebox, Backlog, Started, Finished, etc.)'),
+            label: z.string().optional().describe('Filter by label name'),
+            priority: z.number().optional().describe('Filter by priority (1=Urgent, 2=High, 3=Medium, 4=Low)'),
+            assignee: z.string().optional().describe('Filter by assignee (name, email, or "me")'),
+            team: z.string().optional().describe('Filter by team name'),
+            limit: z.number().optional().describe('Max results (default 50)'),
+            order_by: z.enum(['createdAt', 'updatedAt']).optional().describe('Sort order'),
+            query: z.string().optional().describe('Search title/description text'),
+        }, async (args) => {
+            const cliArgs = {};
+            if (args.project)
+                cliArgs.project = args.project;
+            if (args.status)
+                cliArgs.status = args.status;
+            if (args.label)
+                cliArgs.label = args.label;
+            if (args.priority != null)
+                cliArgs.priority = String(args.priority);
+            if (args.assignee)
+                cliArgs.assignee = args.assignee;
+            if (args.team)
+                cliArgs.team = args.team;
+            else if (teamName)
+                cliArgs.team = teamName;
+            if (args.limit != null)
+                cliArgs.limit = String(args.limit);
+            if (args.order_by)
+                cliArgs['order-by'] = args.order_by;
+            if (args.query)
+                cliArgs.query = args.query;
+            return run('list-issues', cliArgs);
+        }),
+        tool('af_linear_create_blocker', 'Create a human-needed blocker issue linked to a source issue', {
+            source_issue_id: z.string().describe('Source issue ID or identifier that is blocked'),
+            title: z.string().describe('What the human needs to do'),
+            description: z.string().optional().describe('Detailed steps for the human'),
+            team: z.string().optional().describe('Team name (defaults to source issue team)'),
+            project: z.string().optional().describe('Project name (defaults to source issue project)'),
+            assignee: z.string().optional().describe('Assignee name or email'),
+        }, async (args) => {
+            const cliArgs = {
+                title: args.title,
+            };
+            if (args.description)
+                cliArgs.description = args.description;
+            if (args.team)
+                cliArgs.team = args.team;
+            if (args.project)
+                cliArgs.project = args.project;
+            if (args.assignee)
+                cliArgs.assignee = args.assignee;
+            return run('create-blocker', cliArgs, [args.source_issue_id]);
+        }),
+    ];
+}
+export const linearPlugin = {
+    name: 'af-linear',
+    description: 'Linear project management operations',
+    createTools(context) {
+        const apiKey = context.env.LINEAR_API_KEY;
+        if (!apiKey) {
+            return [];
+        }
+        return makeTools(apiKey, context.env.LINEAR_TEAM_NAME);
+    },
+};

package/dist/src/tools/linear-runner.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Linear CLI Runner — process-agnostic Linear operations.
+ *
+ * All 16 command implementations. This module does NOT call process.exit,
+ * read process.argv, or load dotenv. Shared by both the CLI entry point
+ * and the in-process tool plugin.
+ *
+ * Moved from packages/core/src/tools/linear-runner.ts to keep Linear-specific
+ * code in the Linear package.
+ */
+export interface LinearRunnerConfig {
+    command: string;
+    args: Record<string, string | string[] | boolean>;
+    positionalArgs: string[];
+    apiKey?: string;
+}
+export interface LinearRunnerResult {
+    output: unknown;
+}
+/**
+ * Parse CLI arguments into a structured object.
+ *
+ * Supports:
+ * - `--key value` pairs
+ * - JSON array values: `--labels '["Bug", "Feature"]'`
+ * - Comma-separated values for array fields: `--labels "Bug,Feature"`
+ * - Boolean flags: `--dry-run` (value = "true")
+ *
+ * Returns the command (first non-flag arg), named args, and positional args.
+ */
+export declare function parseLinearArgs(argv: string[]): {
+    command: string | undefined;
+    args: Record<string, string | string[] | boolean>;
+    positionalArgs: string[];
+};
+export declare function runLinear(config: LinearRunnerConfig): Promise<LinearRunnerResult>;
+//# sourceMappingURL=linear-runner.d.ts.map

package/dist/src/tools/linear-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-runner.d.ts","sourceRoot":"","sources":["../../../src/tools/linear-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAA;IACjD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAA;CAChB;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAC/C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAA;IACjD,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CA2CA;AAgvBD,wBAAsB,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwOvF"}