bjira 0.0.23 → 0.0.25

package/README.md

@@ -1,73 +1,17 @@
-# Jira cli
+# Jira CLI
 
-This is a simple Jira CLI tool. License: MIT
+A simple Jira CLI tool. License: MIT.
 
-## How to install it
+## Install
 
 ```
-$ npm install -g bjira
+npm install -g bjira
 ```
 
-## How to configure it
+## Documentation
 
-Run `bjira init` to set up the tool. You can optain the API token from your
-jira settings.
+Full documentation is available in the [docs](./docs/index.md) folder.
 
-```
-$ bjira init
-? Provide your jira host: your-domain.atlassian.net
-? Please provide your jira username: username
-? API token: [hidden]
-? Enable HTTPS Protocol? Yes
-Config file succesfully created in: /home/<username>/.bjira.json
-```
-
-## How to use it
-
-Run `bjira help` to see the main help menu. Each command is well documented.
-
-There are 2 main concepts to know:
-- presets
-- custom fields.
-
-### Presets
-
-Let's say you want to retrieve all the open issues assigned to you for project
-FOO.  The query is something like this:
-
-```
-bjira query 'project = "FOO" AND status != "Done" AND status != "Cancelled" AND assignee = currentUser()'
-```
-
-You can save this query as a preset:
-```
-bjira create mine 'project = "FOO" AND status != "Done" AND status != "Cancelled" AND assignee = currentUser()'
-```
-
-Then, you can run it using its query name:
-```
-bjira run mine
-```
-
-If you want to have parameters in your query, use `$$$` as placeholder. For instance:
-```
-bjira preset create search 'project = "FOO" AND text ~ "$$$" ORDER BY created DESC'
-bjira run search -q "hello world"
-```
-
-
-### Custom fields
-Jira is strongly configurable via custom fields. You can retrieve the list of custom fields using:
-
-```
-bjira field listall
-```
-
-If you want to see some of them in the issue report, add them for the project (FOO) and the issue type (Story):
-
-```
-bjira field add FOO Story "Story Points"
-```
+## License
 
-Any custom fields added to the list will be shown in the issue report (See `bjira show`).
-You can also set custom fields using `bira set custom `Story Points' ISSUE-ID`.
+MIT — see [LICENSE.md](./LICENSE.md).

package/docs/advanced.md

@@ -0,0 +1,53 @@
+## Advanced Examples
+
+### 1) Grouping results by parent (Epics/Subtasks)
+
+```
+# See epics with their child stories/tasks in a tree
+bjira query -g "project = \"FOO\" ORDER BY updated DESC"
+```
+
+### 2) Parameterized presets for quick search
+
+```
+bjira preset create text-search "project = \"FOO\" AND text ~ \"$$$\" ORDER BY created DESC"
+bjira run text-search -q "payment gateway timeout"
+```
+
+### 3) Managing custom fields
+
+```
+# Discover fields for a project and type
+bjira field listall
+
+# Track a field so it appears in show and is editable
+bjira field add FOO Story "Story Points"
+
+# Set it on an issue
+bjira set custom 'Story Points' FOO-123
+```
+
+### 4) Linking work to Epics during creation
+
+In `bjira create`, answer "yes" to set a parent epic, then pick an epic from the same project or search-as-you-type.
+
+### 5) Sprints overview for your issues
+
+```
+# Select board and active/future sprint, then see your issues by status
+bjira sprint show
+
+# Show all users
+bjira sprint show --all
+```
+
+### 6) Quick actions
+
+```
+# Assign to yourself
+bjira set assignee --me FOO-123
+
+# Open in browser
+bjira open FOO-123
+```
+

package/docs/commands/attachment.md

@@ -0,0 +1,19 @@
+## attachment
+
+Work with attachments.
+
+Subcommands:
+
+- `attachment get <ISSUE-ID> <ATTACHMENT-ID>`: download the attachment to stdout.
+
+Examples:
+
+```
+# List attachments via show, then download by id
+bjira show -a ISSUE-123 | less
+bjira attachment get ISSUE-123 10001 > file.bin
+```
+
+Notes:
+- Upload and delete are not implemented yet.
+

package/docs/commands/comment.md

@@ -0,0 +1,12 @@
+## comment
+
+Add a comment to an issue.
+
+Usage:
+
+```
+bjira comment <ISSUE-ID>
+```
+
+This opens your `$EDITOR`. Save and close to post the comment. Empty comments are ignored.
+

package/docs/commands/create.md

@@ -0,0 +1,22 @@
+## create
+
+Create a new issue via interactive prompts.
+
+Usage:
+
+```
+bjira create
+```
+
+Flow:
+- Pick a project.
+- Pick an issue type.
+- Enter summary and optionally description (opens `$EDITOR`).
+- Provide required custom fields (if any).
+- Optionally set parent Epic (search-as-you-type, defaults to epics in project).
+- After creation, optionally assign, set status, set configured custom fields, and add to a sprint.
+
+Notes:
+- Custom field prompts are limited to supported types (string, number, select/multiselect via `allowedValues`).
+- Use `field add` to make custom fields visible and manageable in `show`/`set`.
+

package/docs/commands/field.md

@@ -0,0 +1,14 @@
+## field
+
+Manage custom fields visibility and discovery.
+
+Subcommands:
+
+- `field listall`: show all projects, issue types, and available fields, marking supported ones.
+- `field add <PROJECT> <ISSUE-TYPE> <FIELD-NAME>`: track a field so it appears in `show` and can be set with `set custom`.
+- `field remove <PROJECT> <ISSUE-TYPE> <FIELD-NAME>`: stop tracking the field.
+- `field list`: list tracked fields from your config.
+
+Notes:
+- Supported field types: `string`, `number`, and select-like fields exposing `allowedValues`.
+

package/docs/commands/init.md

@@ -0,0 +1,14 @@
+## init
+
+Create the initial configuration file interactively.
+
+Usage:
+
+```
+bjira init
+```
+
+Prompts: Jira host, protocol (HTTPS recommended), username, and API token.
+
+The file is saved to the path specified by `-c, --config` (defaults to `~/.bjira.json`).
+

package/docs/commands/issue.md

@@ -0,0 +1,17 @@
+## issue (show)
+
+Display details for a single issue.
+
+Usage:
+
+```
+bjira show [options] <ISSUE-ID>
+```
+
+Options:
+- `-a, --attachments`: include attachments details.
+- `-C, --comments`: include comments.
+- `-s, --subissues`: list sub-issues; for Epics, also lists child issues.
+
+The output includes key metadata, custom fields you have added via `field add`, timestamps, and counts for attachments and comments.
+

package/docs/commands/label.md

@@ -0,0 +1,12 @@
+## label
+
+Add or remove labels on an issue.
+
+Subcommands:
+
+- `label add <ISSUE-ID>`: adds a label after interactive autocomplete. Prevents duplicates.
+- `label remove <ISSUE-ID>`: removes one of the existing labels.
+
+Notes:
+- If the issue type does not support labels, the command exits with a message.
+

package/docs/commands/open.md

@@ -0,0 +1,13 @@
+## open
+
+Open an issue in the default browser and print its URL.
+
+Usage:
+
+```
+bjira open <ISSUE-ID>
+```
+
+Notes:
+- Uses `open` (macOS), `xdg-open` (Linux), or `cmd /c start` (Windows). If automatic open fails, the URL is printed so you can copy/paste.
+

package/docs/commands/preset.md

@@ -0,0 +1,22 @@
+## preset
+
+Manage named JQL presets.
+
+Subcommands:
+
+- `preset create <NAME> <QUERY>`: create a new preset. Use `$$$` to mark positional parameters.
+- `preset remove <NAME>`: delete a preset.
+- `preset list`: list presets with their JQL.
+
+Examples:
+
+```
+# Save a reusable search for your work
+bjira preset create mine "project = \"FOO\" AND statusCategory != Done AND assignee = currentUser()"
+
+# Parameterized search (one placeholder)
+bjira preset create search "project = \"FOO\" AND text ~ \"$$$\" ORDER BY created DESC"
+```
+
+Run presets using the `run` command.
+

package/docs/commands/project.md

@@ -0,0 +1,10 @@
+## project
+
+Interact with projects.
+
+Subcommands:
+
+- `project list`: list available projects (key and name).
+
+Project selection prompts in other commands prioritize your latest used project.
+

package/docs/commands/query.md

@@ -0,0 +1,24 @@
+## query
+
+Run an ad-hoc JQL query.
+
+Usage:
+
+```
+bjira query [options] <JQL>
+```
+
+Options:
+- `-l, --limit <N>`: maximum number of issues to fetch (default 20; pagination continues until limit or last page).
+- `-g, --grouped`: group results by parent (Epic or Parent) and render a tree.
+
+Examples:
+
+```
+# My open issues in project FOO
+bjira query "project = \"FOO\" AND statusCategory != Done AND assignee = currentUser()"
+
+# Group by parent
+bjira query -g "project = \"FOO\" ORDER BY updated DESC"
+```
+

package/docs/commands/run.md

@@ -0,0 +1,22 @@
+## run
+
+Run a saved preset.
+
+Usage:
+
+```
+bjira run [options] <NAME>
+```
+
+Options:
+- `-q, --query <arg...>`: supply positional arguments for `$$$` placeholders in the preset JQL. Repeat for multiple placeholders in order.
+- `-l, --limit <N>`: maximum number of issues to fetch (default 20).
+- `-g, --grouped`: group by parent and render a tree.
+
+Examples:
+
+```
+bjira run mine
+bjira run search -q "login bug"
+```
+

package/docs/commands/set.md

@@ -0,0 +1,14 @@
+## set
+
+Update fields and transitions of issues.
+
+Subcommands:
+
+- `set assignee [--me] <ISSUE-ID>`: assign to a user. With `--me`, assign to the current user without a prompt.
+- `set unassign <ISSUE-ID>`: clear the assignee.
+- `set status <ISSUE-ID>`: change status via available transitions; required transition fields are prompted if supported.
+- `set custom <FIELD-NAME> <ISSUE-ID>`: set a tracked custom field (see `field add`).
+
+Notes:
+- Supported field types for `set custom`: string, number, select/multi-select fields exposing `allowedValues`.
+

package/docs/commands/sprint.md

@@ -0,0 +1,13 @@
+## sprint
+
+Work with Agile sprints (boards).
+
+Subcommands:
+
+- `sprint add <ISSUE-ID>`: add the issue to an active or future sprint (you pick board and sprint if multiple).
+- `sprint remove <ISSUE-ID>`: move the issue back to the backlog.
+- `sprint show [-a|--all]`: show sprint issues grouped by assignee and status columns. By default only your issues are shown; with `--all` show all users.
+
+Notes:
+- This uses Jira Agile (board/sprint) APIs; ensure your user has permissions.
+

package/docs/commands.md

@@ -0,0 +1,19 @@
+## Commands Overview
+
+Per-command guides:
+
+- [attachment](commands/attachment.md)
+- [comment](commands/comment.md)
+- [create](commands/create.md)
+- [field](commands/field.md)
+- [init](commands/init.md)
+- [issue (show)](commands/issue.md)
+- [label](commands/label.md)
+- [open](commands/open.md)
+- [preset](commands/preset.md)
+- [project](commands/project.md)
+- [query](commands/query.md)
+- [run](commands/run.md)
+- [set](commands/set.md)
+- [sprint](commands/sprint.md)
+

package/docs/concepts.md

@@ -0,0 +1,29 @@
+## Concepts
+
+### Presets
+
+Presets are named JQL queries saved in your config file and executed via `bjira run`.
+
+- Use `$$$` as a positional placeholder; supply values with `-q` in the same order.
+
+Examples:
+
+```
+bjira preset create mine "project = \"FOO\" AND statusCategory != Done AND assignee = currentUser()"
+bjira preset create search "project = \"FOO\" AND text ~ \"$$$\" ORDER BY created DESC"
+bjira run mine
+bjira run search -q "security vulnerability"
+```
+
+### Custom Fields
+
+Jira projects often define custom fields (e.g., Story Points). To surface and manage them in bjira:
+
+1. Discover supported fields using `bjira field listall`.
+2. Add fields to your config using `bjira field add <PROJECT> <ISSUE-TYPE> <FIELD-NAME>`.
+3. View these fields in `bjira show <ISSUE-ID>`.
+4. Update them using `bjira set custom '<FIELD-NAME>' <ISSUE-ID>`.
+
+Supported field types:
+- `string`, `number`, and select/multi-select fields exposing `allowedValues`.
+

package/docs/configuration.md

@@ -0,0 +1,38 @@
+## Configuration
+
+Run the interactive setup to create your config file:
+
+```
+bjira init
+```
+
+You will be prompted for Jira host, username, and API token. By default the configuration is stored in `~/.bjira.json`. You can change the location using the global `-c, --config <file>` option in any command.
+
+Example config file:
+
+```json
+{
+  "jira": {
+    "host": "your-domain.atlassian.net",
+    "protocol": "https",
+    "username": "you@example.com",
+    "password": "<api token>",
+    "apiVersion": 3,
+    "strictSSL": true
+  },
+  "presets": {
+    "mine": "project = \"FOO\" AND statusCategory != Done AND assignee = currentUser()",
+    "search": "project = \"FOO\" AND text ~ \"$$$\" ORDER BY created DESC"
+  },
+  "fields": [
+    { "projectName": "FOO", "issueTypeName": "Story", "fieldName": "Story Points" }
+  ],
+  "latestProject": "FOO"
+}
+```
+
+Notes:
+- `presets` hold reusable JQL, with `$$$` placeholders for positional parameters.
+- `fields` config controls which custom fields are shown in `show` output and usable via `set custom`.
+- `latestProject` is managed automatically to prioritize project picks.
+

package/docs/globals.md

@@ -0,0 +1,9 @@
+## Global Options
+
+- `-c, --config <file>`: path to the configuration file (defaults to `~/.bjira.json`).
+- `--version`: print version.
+- `help`: per-command help.
+
+Environment variables:
+- `EDITOR`: editor binary used to write descriptions and comments in interactive flows.
+

package/docs/index.md

@@ -0,0 +1,18 @@
+# bjira — Documentation
+
+This documentation covers installation, configuration, and usage of the `bjira` CLI to interact with Jira.
+
+- Quick start: see `installation.md` and `configuration.md`.
+- Concepts: `concepts.md` (presets and custom fields).
+- Global options: `globals.md`.
+- Commands: index in `commands.md` with links to per-command guides.
+- Advanced usage: `advanced.md`.
+
+Index:
+
+- [Installation](installation.md)
+- [Configuration](configuration.md)
+- [Global Options](globals.md)
+- [Concepts (Presets, Custom Fields)](concepts.md)
+- [Commands](commands.md)
+- [Advanced Examples](advanced.md)

package/docs/installation.md

@@ -0,0 +1,22 @@
+## Installation
+
+- Requirements: Node.js >= 13.2.0, Jira Cloud account with API token.
+- Install globally:
+
+```
+npm install -g bjira
+```
+
+- Verify:
+
+```
+bjira --version
+bjira help
+```
+
+If you use commands that open an editor (e.g., `comment`, description during `create`), set the `EDITOR` environment variable, for example:
+
+```
+export EDITOR=vim
+```
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bjira",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "A simple jira CLI tool",
   "main": "src/index.js",
   "author": {
@@ -24,6 +24,7 @@
   },
   "engineStrict": true,
   "dependencies": {
+    "chalk": "^5.3.0",
     "commander": "^8.2.0",
     "execa": "^5.1.1",
     "fuzzy": "^0.1.3",
@@ -32,6 +33,7 @@
     "inquirer-checkbox-plus-prompt": "^1.0.1",
     "jira-client": "^6.23.0",
     "ora": "^6.0.1",
+    "string-width": "^5.1.2",
     "temp": "^0.9.4"
   }
 }

package/src/comment.js

@@ -13,7 +13,7 @@ class Comment extends Command {
       .argument('<id>', 'The issue ID')
       .action(async id => {
         const comment = await Utils.writeInTempFile();
-        if (!comment === null) {
+        if (comment === null) {
           return;
         }
 

package/src/create.js

@@ -58,8 +58,7 @@ class Create extends Command {
           .issuetypes.find(i => i.name === issueType.name).fields;
         const requiredFields = Object.keys(issueFields).filter(
           key => issueFields[key].required &&
-          Field.isSupported(issueFields[key]) &&
-          !["issuetype", "summary", "description", "project"].includes(key)).map(key => issueFields[key]);
+          Field.isSupported(issueFields[key]) && ["issuetype", "summary", "description", "project"].includes(key) === false).map(key => issueFields[key]);
 
         for (const field of requiredFields) {
           const fieldData = await Field.askFieldIfSupported(field);
@@ -68,18 +67,49 @@ class Create extends Command {
 
         if (issueType.name !== 'Epic' &&
           await Ask.askBoolean('Do you want to set a parent epic?')) {
-          const result = await Query.runQuery(jira, `project = "${project.key}" and type = "epic"`, 999999);
-          if (!result.issues || result.issues.length === 0) {
-            console.log("No epics yet.");
-          } else {
-            const resultFields = await Field.listFields(jira);
-            result.issues.forEach(epic => Issue.replaceFields(epic, resultFields));
-
-            const parentKey = await Ask.askList('Choose the epic:',
-              result.issues.map(epic => ({
-                name: `${epic.key} - ${epic.fields['Summary']}`,
+          const parentKey = await Ask.askCallback('Choose the epic:', async (input) => {
+            // Default suggestions: epics in the same project, most recently updated, not done.
+            if (!input) {
+              const jql = `project = \"${project.key}\" AND issuetype = \"Epic\" AND statusCategory != Done ORDER BY updated DESC`;
+              const result = await jira.apiRequest('/search/jql', {
+                method: 'POST',
+                followAllRedirects: true,
+                body: {
+                  jql,
+                  fields: ['summary', 'key'],
+                  maxResults: 20
+                }
+              });
+
+              if (!result.issues) return [];
+              return result.issues.map(epic => ({
+                name: `${epic.key} - ${epic.fields.summary}`,
                 value: epic.key
-              })));
+              }));
+            }
+
+            // As-you-type search: allow partial matches via wildcard.
+            const inputWithWildcard = `${input}*`;
+            // Search epics by key or summary across projects, matching prefixes.
+            const jql = `issuetype = \"Epic\" AND (summary ~ \"${inputWithWildcard}\" OR key ~ \"${inputWithWildcard}\") ORDER BY updated DESC`;
+            const result = await jira.apiRequest('/search/jql', {
+              method: 'POST',
+              followAllRedirects: true,
+              body: {
+                jql,
+                fields: ['summary', 'key'],
+                maxResults: 20
+              }
+            });
+
+            if (!result.issues) return [];
+            return result.issues.map(epic => ({
+              name: `${epic.key} - ${epic.fields.summary}`,
+              value: epic.key
+            }));
+          });
+
+          if (parentKey) {
             newIssue.fields.parent = {
               key: parentKey
             };

package/src/errorhandler.js

@@ -5,7 +5,7 @@
 import Table from './table.js';
 
 class ErrorHandler {
-  static showError(jira, e) {
+  static showError(e) {
     const table = new Table({
       head: ['Errors']
     });
@@ -35,7 +35,7 @@ class ErrorHandler {
     console.log(table.toString());
   }
 
-  static showWarningMessages(jira, messages) {
+  static showWarningMessages(messages) {
     const table = new Table({
       head: ['Warnings']
     });

package/src/index.js

@@ -22,6 +22,7 @@ import Query from './query.js';
 import Run from './run.js';
 import Set from './set.js';
 import Sprint from './sprint.js';
+import Open from './open.js';
 
 const DEFAULT_CONFIG_FILE = path.join(os.homedir(), ".bjira.json")
 
@@ -39,6 +40,7 @@ const commands = [
   new Run(),
   new Set(),
   new Sprint(),
+  new Open(),
 ];
 
 const pjson = JSON.parse(fs.readFileSync(new URL("../package.json",

package/src/init.js

@@ -21,7 +21,7 @@ class Init extends Command {
             protocol: await Ask.askBoolean('Enable HTTPS Protocol?') ? 'https' : 'http',
             username: (await Ask.askString('Please provide your jira username:')).trim(),
             password: (await Ask.askPassword('API token:')).trim(),
-            apiVersion: '3',
+            apiVersion: 3,
             strictSSL: true,
           },
           presets: {},

package/src/issue.js

@@ -21,7 +21,7 @@ class Issue extends Command {
       .description('Show an issue')
       .option('-a, --attachments', 'Show the attachments too')
       .option('-C, --comments', 'Show the comments too')
-      .option('-s, --subissues', 'Show the comments too')
+      .option('-s, --subissues', 'Show the subissues too')
       .argument('<id>', 'The issue ID')
       .action(async id => {
         const jira = new Jira(program);
@@ -77,6 +77,12 @@ class Issue extends Command {
           [
             'Labels', issue.fields['Labels'].join(', ')
           ],
+          [
+            'Parent', {
+              color: "yellow",
+              text: issue.fields['Parent']?.key
+            }
+          ],
           [
             'Sprint', {
               color: "yellow",
@@ -182,7 +188,7 @@ class Issue extends Command {
                 'Updated on', comment['Updated']
               ],
               [
-                'Body', comment.body
+                'Body', Issue.showComment(comment.body)
               ],
             ]);
           });
@@ -192,13 +198,13 @@ class Issue extends Command {
 
         if (cmd.opts().subissues) {
           console.log("\nSub-issues:");
-          const children = await Query.runQuery(jira, `parent = "${id}"`, 999999);
-          await Query.showIssues(jira, children.issues, children.total, resultFields, false);
+          const children = await Query.runQuery(jira, `parent = "${id}"`);
+          await Query.showIssues(jira, children.issues, children.isLast, resultFields, false);
 
           if (issue.fields['Issue Type'].name === 'Epic') {
             console.log("\nEpic issues:");
             const children = await jira.spin('Fetching child issues...', jira.api.getIssuesForEpic(id));
-            await Query.showIssues(jira, children.issues, children.total, resultFields, false);
+            await Query.showIssues(jira, children.issues, children.isLast, resultFields, false);
           }
         }
 
@@ -208,7 +214,7 @@ class Issue extends Command {
   static replaceFields(obj, fields) {
     if (Array.isArray(obj)) {
       obj.forEach((o, pos) => {
-        obj[o] = Issue.replaceFields(o, fields);
+        obj[pos] = Issue.replaceFields(o, fields);
       });
     } else if (obj && typeof obj === "object") {
       Object.keys(obj).forEach(key => {
@@ -237,6 +243,37 @@ class Issue extends Command {
     return str;
   }
 
+  static showComment(obj) {
+    if (typeof obj === "string") return obj;
+
+    switch (obj.type) {
+      case 'doc':
+      case 'paragraph':
+        return obj.content.map(a => Issue.showComment(a)).join("");
+
+      case 'text':
+        return obj.text;
+
+      case 'inlineCard':
+        return obj.attrs.url;
+
+      case 'status':
+      case 'mention':
+      case 'emoji':
+        return obj.attrs.text;
+
+      case 'hardBreak':
+        return '\n';
+
+      case 'date':
+        const date = new Date(obj.attrs.timestamp * 1000);
+        return date.toLocaleString();
+
+      default:
+        return '';
+    }
+  }
+
   showEpicIssue(issue) {
     if (!issue) return "";
     return `${issue.key} (${issue.fields['Summary'].trim()})`;

package/src/jira.js

@@ -15,7 +15,7 @@ class Jira {
 
     if (!fs.existsSync(this.configFile)) {
       console.log(`Config file ${this.configFile} does not exist.`);
-      process.exit();
+      process.exit(1);
       return;
     }
 
@@ -100,7 +100,7 @@ class Jira {
       return result;
     } catch (e) {
       spinner.stop();
-      ErrorHandler.showError(this, e);
+      ErrorHandler.showError(e);
       process.exit(1);
     }
   }

package/src/open.js

@@ -0,0 +1,58 @@
+// SPDX-FileCopyrightText: 2021-2022 Andrea Marchesini <baku@bnode.dev>
+//
+// SPDX-License-Identifier: MIT
+
+import execa from 'execa';
+import color from 'chalk';
+
+import Command from './command.js';
+import Jira from './jira.js';
+import Issue from './issue.js';
+
+class Open extends Command {
+  addOptions(program) {
+    program.command('open')
+      .description('Open an issue in the default browser')
+      .argument('<id>', 'The issue ID')
+      .action(async id => {
+        const jira = new Jira(program);
+        const url = Issue.url(jira, id);
+
+        const {
+          cmd,
+          args
+        } = this._browserOpener(url);
+
+        try {
+          const subprocess = execa(cmd, args, {
+            detached: true,
+            stdio: 'ignore'
+          });
+          subprocess.unref?.();
+          console.log(color.blue(url));
+        } catch (e) {
+          console.log('Unable to open the browser automatically. Open this URL:');
+          console.log(color.blue(url));
+        }
+      });
+  }
+
+  _browserOpener(url) {
+    switch (process.platform) {
+      case 'darwin':
+        return {
+          cmd: 'open', args: [url]
+        };
+      case 'win32':
+        return {
+          cmd: 'cmd', args: ['/c', 'start', '', url]
+        };
+      default:
+        return {
+          cmd: 'xdg-open', args: [url]
+        };
+    }
+  }
+};
+
+export default Open;

package/src/query.js

@@ -29,12 +29,12 @@ class Query extends Command {
         const resultFields = await Field.listFields(jira);
         const result = await Query.runQuery(jira, query, opts.limit);
 
-        await Query.showIssues(jira, result.issues, result.total, resultFields, opts.grouped);
+        await Query.showIssues(jira, result.issues, result.isLast, resultFields, opts.grouped);
       });
   }
 
-  static async showIssues(jira, issues, total, fields, grouped) {
-    console.log(`Showing ${color.bold(issues.length)} issues of ${color.bold(total)}`);
+  static async showIssues(jira, issues, isLast, fields, grouped) {
+    console.log(`Showing ${color.bold(issues.length)} issues of ${isLast ? color.bold(issues.length) : "more"}`);
 
     issues = issues.map(issue => Issue.replaceFields(issue, fields)).map(issue => ({
       children: [],
@@ -150,6 +150,7 @@ class Query extends Command {
   static async runQuery(jira, query, expectedResult) {
     let issues = [];
     let nextPageToken = null;
+    let isLast = true;
     while (issues.length < (expectedResult === undefined ? issues.length + 1 : expectedResult)) {
       const result = await jira.spin('Running query...',
         jira.apiRequest('/search/jql', {
@@ -159,23 +160,27 @@ class Query extends Command {
             jql: query,
             nextPageToken,
             fields: ['*all'],
-            maxResults: Math.min(5000, expectedResult - issues.length)
+            maxResults: 20,
           }
         }));
 
       if (result.warningMessages) {
         ErrorHandler.showWarningMessages(result.warningMessages);
-        return;
+        return {
+          isLast: true,
+          issues: []
+        };
       }
 
       issues = issues.concat(result.issues);
       nextPageToken = result.nextPageToken;
+      isLast = result.isLast;
 
-      if (result.isLast) break;
+      if (isLast) break;
     }
 
     return {
-      total: issues.length,
+      isLast,
       issues
     };
   }

package/src/run.js

@@ -47,7 +47,7 @@ class Run extends Command {
         const resultFields = await Field.listFields(jira);
         const result = await Query.runQuery(jira, query, opts.limit);
 
-        await Query.showIssues(jira, result.issues, result.total, resultFields, opts.grouped);
+        await Query.showIssues(jira, result.issues, result.isLast, resultFields, opts.grouped);
       });
   }
 

package/src/set.js

@@ -13,12 +13,18 @@ class Set extends Command {
   addOptions(program) {
     const setCmd = program.command('set')
       .description('Update fields in an issue');
-    setCmd.command('assignee')
+    const assigneeCmd = setCmd.command('assignee')
       .description('Assign the issue to somebody')
+      .option('--me', 'Assign the issue to the current user')
       .argument('<ID>', 'The issue ID')
       .action(async id => {
         const jira = new Jira(program);
-        await Set.assignIssue(jira, id);
+        const opts = assigneeCmd.opts();
+        if (opts.me) {
+          await Set.assignToMe(jira, id);
+        } else {
+          await Set.assignIssue(jira, id);
+        }
       });
 
     setCmd.command('unassign')
@@ -90,6 +96,19 @@ class Set extends Command {
     await jira.spin(`Updating issue ${id}...`, jira.api.updateIssue(id, issue));
   }
 
+  static async assignToMe(jira, id) {
+    const me = await jira.spin('Retrieving current user...', jira.api.getCurrentUser());
+    const issue = {
+      fields: {
+        assignee: {
+          accountId: me.accountId
+        }
+      }
+    };
+
+    await jira.spin(`Updating issue ${id}...`, jira.api.updateIssue(id, issue));
+  }
+
   static async setCustomField(jira, customField, id, defaultValue = null) {
     const field = await Field.fetchAndAskFieldIfSupported(jira, customField, defaultValue);
     if (field === null) {

package/src/sprint.js

@@ -110,7 +110,7 @@ class Sprint extends Command {
         if (showCmd.opts().all) {
           filteredUsers = User.sortUsers(currentUser, users);
         } else {
-          filteredUsers = [users.find(user => user.accountId === currentUser.accountId)];
+          filteredUsers = users.filter(user => user.accountId === currentUser.accountId);
         }
 
         filteredUsers.forEach(user => {
@@ -131,7 +131,7 @@ class Sprint extends Command {
           for (let i = 0; i < maxIssues; ++i) {
             const line = statuses.map(status => {
               if (status.issues.length > i) {
-                return `${status.issues[i].key} ${status.issues[i].fields['Summary'].trim()}`
+                return `${color.yellow(status.issues[i].key)} ${status.issues[i].fields['Summary'].trim()}`
               }
               return ""
             });

package/src/table.js

@@ -3,6 +3,7 @@
 // SPDX-License-Identifier: MIT
 
 import color from 'chalk';
+import stringWidth from 'string-width';
 
 class Table {
   constructor(options) {
@@ -25,11 +26,15 @@ class Table {
       if (typeof field !== "object") field = {
         text: field
       };
-      field.text = ("" + field.text).split("\n");
+      field.text = ("" + (field.text === undefined ? "" : field.text)).split("\n");
       this._columns[pos].rows.push(field);
     });
 
-    for (let i = row.length; i < this._columns.length; ++i) this._columns[i].rows.push({});
+    for (let i = row.length; i < this._columns.length; ++i) {
+      this._columns[i].rows.push({
+        text: [""]
+      });
+    }
 
     ++this._rows;
   }
@@ -46,8 +51,9 @@ class Table {
     this._columns.forEach(column => this._computeColumnWidth(column));
 
     const totalWidth = this._columns.reduce((x, column) => x + column.width, this._columns.length - 1);
-    if (totalWidth > process.stdout.columns) {
-      this._resizeWidthOf(totalWidth - process.stdout.columns + (this._columns.length - 1));
+    const availableColumns = (process.stdout && process.stdout.columns) ? process.stdout.columns : 120;
+    if (totalWidth > availableColumns) {
+      this._resizeWidthOf(totalWidth - availableColumns + (this._columns.length - 1));
     }
 
     const lines = [];
@@ -77,10 +83,10 @@ class Table {
 
   _computeColumnWidth(column) {
     column.width = Math.max(...column.rows.map(row =>
-      Math.max(...row.text.map(line => line.length))
+      Math.max(...row.text.map(line => this._visibleLength(line)))
     ));
 
-    if (column.head) column.width = Math.max(column.width, column.head.length);
+    if (column.head) column.width = Math.max(column.width, this._visibleLength(column.head));
   }
 
   _computeRowHeight(column, row) {
@@ -90,13 +96,13 @@ class Table {
   _toWidth(str, width, spaces) {
     str = str || "";
 
-    let strLength = str.length;
+    let strLength = this._visibleLength(str);
     if (strLength > width) {
-      return this._truncate(str, width - 1) + "…";
+      return this._truncateVisible(str, width - 1) + "…";
     }
 
     if (spaces) {
-      for (let strLength = str.length; strLength < width; ++strLength) str += " ";
+      while (this._visibleLength(str) < width) str += " ";
     }
     return str;
   }
@@ -122,14 +128,14 @@ class Table {
   }
 
   _maybeSplitRow(row, width) {
-    if (row.length <= width) return [row];
+    if (this._visibleLength(row) <= width) return [row];
 
     const rows = [];
     let currentRow = "";
     for (let part of row.split(" ")) {
       if (currentRow.length === 0) {
         currentRow = part;
-      } else if ((currentRow.length + part.length + 1) < width) {
+      } else if ((this._visibleLength(currentRow) + this._visibleLength(part) + 1) < width) {
         currentRow += " " + part;
       } else {
         rows.push(currentRow);
@@ -146,9 +152,9 @@ class Table {
 
   _resizeWidthOfOne() {
     const max = Math.max(...this._columns.map(column => column.width));
-    for (let columnId in this._columns) {
-      const column = this._columns[columnId];
-      if (!this._unresizableColumns.includes(columnId) && column.width === max) {
+    for (let i = 0; i < this._columns.length; ++i) {
+      const column = this._columns[i];
+      if (!this._unresizableColumns.includes(i) && column.width === max) {
         --column.width;
         break;
       }
@@ -156,7 +162,7 @@ class Table {
   }
 
   _truncate(str, width) {
-    return str.slice(0, width);
+    return this._truncateVisible(str, width);
   }
 
   _stylize(row, text) {
@@ -174,6 +180,51 @@ class Table {
 
     return color[row.color].apply(null, [text]);
   }
+
+  // Returns the display width of a string (ANSI-aware, CJK/emoji aware).
+  _visibleLength(str) {
+    if (!str) return 0;
+    return stringWidth("" + str);
+  }
+
+  // Truncate a string to a target visible width, preserving ANSI codes and
+  // ensuring styles are reset if we cut before a reset sequence.
+  _truncateVisible(str, width) {
+    if (width <= 0) return "";
+    const input = "" + (str || "");
+    const ansi = this._ansiRegex();
+    let out = "";
+    let i = 0;
+    while (i < input.length) {
+      const ch = input[i];
+      if (ch === "\u001b") {
+        const match = input.slice(i).match(ansi);
+        if (match && match.index === 0) {
+          out += match[0];
+          i += match[0].length;
+          continue;
+        }
+        out += ch;
+        i++;
+        continue;
+      }
+      const candidate = out + ch;
+      if (stringWidth(candidate) > width) break;
+      out = candidate;
+      i++;
+    }
+
+    // If we truncated before natural end, ensure we reset styles.
+    if (i < input.length) {
+      out += "\u001b[0m";
+    }
+    return out;
+  }
+
+  _ansiRegex() {
+    // eslint-disable-next-line no-control-regex
+    return /\u001B\[[0-?]*[ -\/]*[@-~]/g;
+  }
 };
 
 export default Table;