@fink-andreas/pi-linear-tools 0.5.1 → 0.7.0

package/src/cli.js

@@ -18,6 +18,8 @@ import {
 import {
   executeIssueList,
   executeIssueView,
+  executeIssueImages,
+  executeIssueDownload,
   executeIssueActivity,
   executeIssueCreate,
   executeIssueUpdate,
@@ -164,6 +166,8 @@ Other commands:
   config                        Show current configuration
   config --api-key <key>        Set Linear API key (legacy)
   config --default-team <key>   Set default team
+  config --allow-overwrite-files true|false
+                                Allow issue download overwrites when requested
 
 Auth Actions:
   login    Authenticate with Linear via OAuth 2.0
@@ -173,9 +177,12 @@ Auth Actions:
 Issue Actions:
   list [--project X] [--states X,Y] [--assignee me|all] [--team X] [--limit N]
   view <issue> [--no-comments]
+  images <issue> [--no-comments] [--limit N] [--max-bytes N]
+  download <issue> --directory DIR [--attachment-id ID|--attachment-title TITLE|--attachment-url URL|--attachment-index N]
+         [--filename NAME] [--overwrite true|false] [--max-bytes N]
   activity <issue> [--limit N] [--include-archived true|false]
-  create --title X [--team X] [--project X] [--description X] [--priority 0-4] [--assignee me|ID]
-  update <issue> [--title X] [--description X] [--state X] [--priority 0-4]
+  create --title X [--team X] [--project X] [--description X] [--priority 0-4|name] [--assignee me|ID]
+  update <issue> [--title X] [--description X] [--state X] [--priority 0-4|name]
          [--assignee me|ID] [--milestone X] [--sub-issue-of X]
   comment <issue> --body X
   start <issue> [--from-ref X] [--on-branch-exists switch|suffix]
@@ -242,7 +249,7 @@ Common Flags:
   --project     Project name or ID
   --team        Team key (e.g., ENG)
   --assignee    "me" or assignee ID
-  --priority    Priority 0-4 (0=None, 1=Urgent, 2=High, 3=Medium, 4=Low)
+  --priority    Issue priority: 0=None, 1=Urgent, 2=High, 3=Medium, 4=Low; or none, urgent, high, medium, low
   --state       State name or ID
   --limit       Max results (default: 50)
 
@@ -286,11 +293,14 @@ Guidance:
   Use "update" to change the issue itself: title, description, state, assignee, milestone, or parent.
   Use "comment" to add a discussion entry.
   Use "activity" to read the Activity timeline shown in Linear.
+  Use "images" to fetch image attachments embedded in issue markdown/comments.
 
 Actions:
   list      List issues in a project
   view      View issue details
+  images    Fetch image attachments embedded in issue markdown/comments
   activity  View issue activity/history
+  download  Download a Linear issue attachment
   create    Create a new issue
   update    Update an existing issue
   comment   Add a comment to an issue
@@ -308,6 +318,23 @@ View Options:
   <issue>          Issue key (e.g., ENG-123), ID, or issue URL
   --no-comments    Exclude comments from output
 
+Images Options:
+  <issue>          Issue key (e.g., ENG-123), ID, or issue URL
+  --no-comments    Exclude images from comments
+  --limit N        Max images to fetch (default: 10)
+  --max-bytes N    Max bytes per image (default/max: 10485760)
+
+Download Options:
+  <issue>              Issue key, ID, or issue URL
+  --directory DIR      Relative destination directory (required)
+  --attachment-id ID   Attachment ID selector
+  --attachment-title X Attachment title selector (must be unique)
+  --attachment-url URL Attachment URL selector
+  --attachment-index N 1-based attachment index selector
+  --filename NAME      Optional output filename
+  --overwrite X        true or false (default: false; requires config guard)
+  --max-bytes N        Max download bytes (default/max: 52428800)
+
 Activity Options:
   <issue>          Issue key, ID, or issue URL
   --limit N        Max activity entries to fetch (default: 20)
@@ -318,7 +345,7 @@ Create Options:
   --team X         Team key, e.g., ENG (required if no default team)
   --project X      Project name or ID
   --description X  Issue description (markdown)
-  --priority N     Priority 0-4
+  --priority N     Issue priority: 0=None, 1=Urgent, 2=High, 3=Medium, 4=Low; or none, urgent, high, medium, low
   --assignee X     "me" or assignee ID
   --parent-id X    Parent issue ID for sub-issues
 
@@ -327,7 +354,7 @@ Update Options:
   --title X        New title
   --description X  New description
   --state X        New state name or ID
-  --priority N     New priority 0-4
+  --priority N     New issue priority: 0=None, 1=Urgent, 2=High, 3=Medium, 4=Low; or none, urgent, high, medium, low
   --assignee X     "me" or assignee ID
   --milestone X    Milestone name/ID, or "none" to clear
   --sub-issue-of X Parent issue key/ID, or "none" to clear
@@ -351,6 +378,7 @@ Examples:
   pi-linear-tools issue comment ENG-123 --body "Ready for review"
   pi-linear-tools issue activity ENG-123 --limit 20
   pi-linear-tools issue activity https://linear.app/workspace/issue/ENG-123/example --limit 20
+  pi-linear-tools issue download ENG-123 --attachment-index 1 --directory downloads
 `);
 }
 
@@ -729,6 +757,7 @@ async function handleConfig(args) {
   const defaultTeam = readFlag(args, '--default-team');
   const projectTeam = readFlag(args, '--team');
   const projectName = readFlag(args, '--project');
+  const allowOverwriteFiles = readFlag(args, '--allow-overwrite-files');
 
   if (apiKey) {
     const settings = await loadSettings();
@@ -748,6 +777,19 @@ async function handleConfig(args) {
     return;
   }
 
+  if (allowOverwriteFiles !== undefined) {
+    const enabled = parseBoolean(allowOverwriteFiles);
+    if (enabled === undefined) {
+      throw new Error('Invalid value for --allow-overwrite-files. Use true or false.');
+    }
+
+    const settings = await loadSettings();
+    settings.allow_overwrite_files = enabled;
+    await saveSettings(settings);
+    console.log(`File overwrite guard ${enabled ? 'allows overwrites' : 'blocks overwrites'}`);
+    return;
+  }
+
   if (projectTeam) {
     if (!projectName) {
       throw new Error('Missing required flag: --project when using --team');
@@ -777,12 +819,14 @@ async function handleConfig(args) {
   console.log(`Configuration:
   LINEAR_API_KEY: ${hasKey ? 'configured' : 'not set'} (source: ${keySource})
   Default team: ${settings.defaultTeam || 'not set'}
+  Allow overwrite files: ${settings.allow_overwrite_files ? 'enabled' : 'disabled'}
   Project team mappings: ${Object.keys(settings.projects || {}).length}
 
 Commands:
   pi-linear-tools config --api-key lin_xxx
   pi-linear-tools config --default-team ENG
-  pi-linear-tools config --team ENG --project MyProject`);
+  pi-linear-tools config --team ENG --project MyProject
+  pi-linear-tools config --allow-overwrite-files true|false`);
 }
 
 // ===== ISSUE HANDLERS =====
@@ -819,6 +863,25 @@ async function handleIssueView(args) {
   console.log(result.content[0].text);
 }
 
+async function handleIssueImages(args) {
+  const client = await createAuthenticatedClient();
+
+  const positional = args.filter((a) => !a.startsWith('-'));
+  if (positional.length === 0) {
+    throw new Error('Missing required argument: issue key or ID');
+  }
+
+  const params = {
+    issue: positional[0],
+    includeComments: !hasFlag(args, '--no-comments'),
+    limit: parseNumber(readFlag(args, '--limit')),
+    maxBytes: parseNumber(readFlag(args, '--max-bytes')),
+  };
+
+  const result = await executeIssueImages(client, params);
+  console.log(result.content[0].text);
+}
+
 async function handleIssueActivity(args) {
   const client = await createAuthenticatedClient();
 
@@ -837,6 +900,32 @@ async function handleIssueActivity(args) {
   console.log(result.content[0].text);
 }
 
+async function handleIssueDownload(args) {
+  const client = await createAuthenticatedClient();
+  const settings = await loadSettings();
+
+  const positional = args.filter((a) => !a.startsWith('-'));
+  if (positional.length === 0) {
+    throw new Error('Missing required argument: issue key or ID');
+  }
+
+  const overwrite = parseBoolean(readFlag(args, '--overwrite'));
+  const params = {
+    issue: positional[0],
+    attachmentId: readFlag(args, '--attachment-id'),
+    attachmentTitle: readFlag(args, '--attachment-title'),
+    attachmentUrl: readFlag(args, '--attachment-url'),
+    attachmentIndex: parseNumber(readFlag(args, '--attachment-index')),
+    directory: readFlag(args, '--directory'),
+    filename: readFlag(args, '--filename'),
+    overwrite: overwrite === undefined ? undefined : overwrite,
+    maxBytes: parseNumber(readFlag(args, '--max-bytes')),
+  };
+
+  const result = await executeIssueDownload(client, params, { settings });
+  console.log(result.content[0].text);
+}
+
 async function handleIssueCreate(args) {
   const client = await createAuthenticatedClient();
 
@@ -845,7 +934,7 @@ async function handleIssueCreate(args) {
     team: readFlag(args, '--team'),
     project: readFlag(args, '--project'),
     description: readFlag(args, '--description'),
-    priority: parseNumber(readFlag(args, '--priority')),
+    priority: readFlag(args, '--priority'),
     assignee: readFlag(args, '--assignee'),
     parentId: readFlag(args, '--parent-id'),
     state: readFlag(args, '--state'),
@@ -872,7 +961,7 @@ async function handleIssueUpdate(args) {
     title: readFlag(args, '--title'),
     description: readFlag(args, '--description'),
     state: readFlag(args, '--state'),
-    priority: parseNumber(readFlag(args, '--priority')),
+    priority: readFlag(args, '--priority'),
     assignee: readFlag(args, '--assignee'),
     milestone: readFlag(args, '--milestone'),
     subIssueOf: readFlag(args, '--sub-issue-of'),
@@ -950,6 +1039,10 @@ async function handleIssue(args) {
       return handleIssueList(rest);
     case 'view':
       return handleIssueView(rest);
+    case 'images':
+      return handleIssueImages(rest);
+    case 'download':
+      return handleIssueDownload(rest);
     case 'activity':
       return handleIssueActivity(rest);
     case 'create':