Add delegate support for agent users on issues

docs/usage.md

@@ -129,6 +129,9 @@ linear issue create --title "Fix bug" --description "Description here"
 # Create and assign to yourself
 linear issue create --assignee self
 
+# Create and delegate to an agent user
+linear issue create --delegate rowan
+
 # Create with priority (1-4, where 1 is highest)
 linear issue create --priority 1
 
@@ -157,6 +160,9 @@ update a specific issue:
 
 ```bash
 linear issue update TEAM-123
+
+# Delegate an existing issue to an agent user
+linear issue update TEAM-123 --delegate rowan
 ```
 
 #### other issue commands

src/commands/issue/issue-create.ts

@@ -20,6 +20,7 @@ import {
   getTeamKey,
   getWorkflowStateByNameOrType,
   getWorkflowStates,
+  lookupUser,
   lookupUserId,
   searchTeamsByKeySubstring,
   selectOption,
@@ -455,6 +456,10 @@ export const createCommand = new Command()
     "-a, --assignee <assignee:string>",
     "Assign the issue to 'self' or someone (by username or name)",
   )
+  .option(
+    "--delegate <delegate:string>",
+    "Delegate the issue to an agent user (by username or name)",
+  )
   .option(
     "--due-date <dueDate:string>",
     "Due date of the issue",
@@ -515,6 +520,7 @@ export const createCommand = new Command()
       {
         start,
         assignee,
+        delegate,
         dueDate,
         useDefaultTemplate,
         parent: parentIdentifier,
@@ -559,7 +565,7 @@ export const createCommand = new Command()
       }
 
       // If no flags are provided (or only parent is provided), use interactive mode
-      const noFlagsProvided = !title && !assignee && !dueDate &&
+      const noFlagsProvided = !title && !assignee && !delegate && !dueDate &&
         priority === undefined && estimate === undefined && !finalDescription &&
         (!labels || labels.length === 0) &&
         !team && !project && !state && !milestone && !cycle && !start
@@ -710,10 +716,38 @@ export const createCommand = new Command()
         let assigneeId = undefined
 
         if (assignee) {
-          assigneeId = await lookupUserId(assignee)
-          if (assigneeId == null) {
+          const resolvedAssignee = await lookupUser(assignee)
+          if (resolvedAssignee == null) {
             throw new NotFoundError("User", assignee)
           }
+          if (resolvedAssignee.app) {
+            throw new ValidationError(
+              `Cannot use --assignee with app user '${assignee}'`,
+              {
+                suggestion:
+                  `Use --delegate ${assignee} to delegate the issue to an agent user.`,
+              },
+            )
+          }
+          assigneeId = resolvedAssignee.id
+        }
+
+        let delegateId: string | undefined
+        if (delegate) {
+          const resolvedDelegate = await lookupUser(delegate)
+          if (resolvedDelegate == null) {
+            throw new NotFoundError("User", delegate)
+          }
+          if (!resolvedDelegate.app) {
+            throw new ValidationError(
+              `Cannot use --delegate with human user '${delegate}'`,
+              {
+                suggestion:
+                  `Use --assignee ${delegate} to assign the issue to a human user.`,
+              },
+            )
+          }
+          delegateId = resolvedDelegate.id
         }
 
         const labelIds = []
@@ -802,6 +836,7 @@ export const createCommand = new Command()
         const input = {
           title,
           assigneeId,
+          delegateId,
           dueDate,
           parentId,
           priority,

src/commands/issue/issue-update.ts

@@ -11,7 +11,7 @@ import {
   getProjectIdByName,
   getTeamIdByKey,
   getWorkflowStateByNameOrType,
-  lookupUserId,
+  lookupUser,
 } from "../../utils/linear.ts"
 import {
   CliError,
@@ -28,6 +28,10 @@ export const updateCommand = new Command()
     "-a, --assignee <assignee:string>",
     "Assign the issue to 'self' or someone (by username or name)",
   )
+  .option(
+    "--delegate <delegate:string>",
+    "Delegate the issue to an agent user (by username or name)",
+  )
   .option(
     "--due-date <dueDate:string>",
     "Due date of the issue",
@@ -82,6 +86,7 @@ export const updateCommand = new Command()
     async (
       {
         assignee,
+        delegate,
         dueDate,
         parent,
         priority,
@@ -175,10 +180,38 @@ export const updateCommand = new Command()
 
         let assigneeId: string | undefined
         if (assignee !== undefined) {
-          assigneeId = await lookupUserId(assignee)
-          if (!assigneeId) {
+          const resolvedAssignee = await lookupUser(assignee)
+          if (!resolvedAssignee) {
             throw new NotFoundError("User", assignee)
           }
+          if (resolvedAssignee.app) {
+            throw new ValidationError(
+              `Cannot use --assignee with app user '${assignee}'`,
+              {
+                suggestion:
+                  `Use --delegate ${assignee} to delegate the issue to an agent user.`,
+              },
+            )
+          }
+          assigneeId = resolvedAssignee.id
+        }
+
+        let delegateId: string | undefined
+        if (delegate !== undefined) {
+          const resolvedDelegate = await lookupUser(delegate)
+          if (!resolvedDelegate) {
+            throw new NotFoundError("User", delegate)
+          }
+          if (!resolvedDelegate.app) {
+            throw new ValidationError(
+              `Cannot use --delegate with human user '${delegate}'`,
+              {
+                suggestion:
+                  `Use --assignee ${delegate} to assign the issue to a human user.`,
+              },
+            )
+          }
+          delegateId = resolvedDelegate.id
         }
 
         const labelIds = []
@@ -229,6 +262,7 @@ export const updateCommand = new Command()
 
         if (title !== undefined) input.title = title
         if (assigneeId !== undefined) input.assigneeId = assigneeId
+        if (delegateId !== undefined) input.delegateId = delegateId
         if (dueDate !== undefined) input.dueDate = dueDate
         if (parent !== undefined) {
           const parentIdentifier = await getIssueIdentifier(parent)

src/utils/linear.ts

@@ -691,23 +691,36 @@ export async function searchTeamsByKeySubstring(
   )
 }
 
-export async function lookupUserId(
+export async function lookupUser(
   /**
    * email, username, display name, 'self', or '@me' for viewer
    */
   input: "self" | "@me" | string,
-): Promise<string | undefined> {
+): Promise<
+  | {
+    id: string
+    email?: string | null
+    displayName?: string | null
+    name: string
+    app: boolean
+  }
+  | undefined
+> {
   if (input === "@me" || input === "self") {
     const client = getGraphQLClient()
     const query = gql(/* GraphQL */ `
       query GetViewerId {
         viewer {
           id
+          email
+          displayName
+          name
+          app
         }
       }
     `)
     const data = await client.request(query, {})
-    return data.viewer.id
+    return data.viewer
   } else {
     const client = getGraphQLClient()
     const query = gql(/* GraphQL */ `
@@ -726,6 +739,7 @@ export async function lookupUserId(
             email
             displayName
             name
+            app
           }
         }
       }
@@ -738,20 +752,30 @@ export async function lookupUserId(
 
     for (const user of data.users.nodes) {
       if (user.email?.toLowerCase() === input.toLowerCase()) {
-        return user.id
+        return user
       }
     }
 
     for (const user of data.users.nodes) {
       if (user.displayName?.toLowerCase() === input.toLowerCase()) {
-        return user.id
+        return user
       }
     }
 
-    return data.users.nodes[0]?.id
+    return data.users.nodes[0]
   }
 }
 
+export async function lookupUserId(
+  /**
+   * email, username, display name, 'self', or '@me' for viewer
+   */
+  input: "self" | "@me" | string,
+): Promise<string | undefined> {
+  const user = await lookupUser(input)
+  return user?.id
+}
+
 export async function getIssueLabelIdByNameForTeam(
   name: string,
   teamKey: string,

test/commands/issue/__snapshots__/issue-create.test.ts.snap

@@ -14,6 +14,7 @@ Options:
   -h, --help                                - Show this help.                                                
   --start                                   - Start the issue after creation                                 
   -a, --assignee             <assignee>     - Assign the issue to 'self' or someone (by username or name)    
+  --delegate                 <delegate>     - Delegate the issue to an agent user (by username or name)      
   --due-date                 <dueDate>      - Due date of the issue                                          
   --parent                   <parent>       - Parent issue (if any) as a team_number code                    
   -p, --priority             <priority>     - Priority of the issue (1-4, descending priority)               
@@ -45,6 +46,25 @@ stderr:
 ""
 `;
 
+snapshot[`Issue Create Command - Delegate Happy Path 1`] = `
+stdout:
+"Creating issue in ENG
+
+https://linear.app/test-team/issue/ENG-124/delegate-agent-work
+"
+stderr:
+""
+`;
+
+snapshot[`Issue Create Command - Assignee Rejects App User 1`] = `
+stdout:
+""
+stderr:
+"✗ Failed to create issue: Cannot use --assignee with app user 'rowan'
+  Use --delegate rowan to delegate the issue to an agent user.
+"
+`;
+
 snapshot[`Issue Create Command - With Milestone 1`] = `
 stdout:
 "Creating issue in ENG

test/commands/issue/__snapshots__/issue-update.test.ts.snap

@@ -13,6 +13,7 @@ Options:
 
   -h, --help                         - Show this help.                                                
   -a, --assignee      <assignee>     - Assign the issue to 'self' or someone (by username or name)    
+  --delegate          <delegate>     - Delegate the issue to an agent user (by username or name)      
   --due-date          <dueDate>      - Due date of the issue                                          
   --parent            <parent>       - Parent issue (if any) as a team_number code                    
   -p, --priority      <priority>     - Priority of the issue (1-4, descending priority)               
@@ -43,6 +44,26 @@ stderr:
 ""
 `;
 
+snapshot[`Issue Update Command - Delegate Happy Path 1`] = `
+stdout:
+"Updating issue ENG-123
+
+✓ Updated issue ENG-123: Test Issue
+https://linear.app/test-team/issue/ENG-123/test-issue
+"
+stderr:
+""
+`;
+
+snapshot[`Issue Update Command - Assignee Rejects App User 1`] = `
+stdout:
+""
+stderr:
+"✗ Failed to update issue: Cannot use --assignee with app user 'rowan'
+  Use --delegate rowan to delegate the issue to an agent user.
+"
+`;
+
 snapshot[`Issue Update Command - With Milestone 1`] = `
 stdout:
 "Updating issue ENG-123