jira-ai 1.1.0 → 1.2.0

package/README.md

@@ -191,6 +191,43 @@ When `authType` is set to `service_account`, jira-ai automatically:
 
 Existing configurations using standard API tokens are unaffected.
 
+## Saved Queries
+
+Define reusable JQL queries in your `settings.yaml` under the `saved-queries` key to avoid repeating common searches.
+
+### Configuration
+
+Add a `saved-queries` map to your `settings.yaml` — each key is a query name (lowercase alphanumeric with hyphens) and each value is a JQL string:
+
+```yaml
+saved-queries:
+  my-open-bugs: "project = PROJ AND status = Open AND issuetype = Bug"
+  overdue-tasks: "project = PROJ AND duedate < now() AND status != Done"
+  my-assignee: "assignee = currentUser()"
+```
+
+### Usage
+
+Run a saved query by name:
+
+```bash
+jira-ai issue search --query my-open-bugs
+```
+
+List all configured saved queries:
+
+```bash
+jira-ai issue search --list-queries
+```
+
+Combine with result limits:
+
+```bash
+jira-ai issue search --query overdue-tasks --limit 10
+```
+
+Saved queries are mutually exclusive with raw JQL — you cannot provide both a positional JQL argument and `--query` at the same time.
+
 ## Configuration & Restrictions
 
 Tool allows you to have very complex configutations of what Projects/Jira commands/Issue types you would have acess to thought the tool.

package/dist/cli.js

@@ -131,14 +131,20 @@ issue
     .option('--custom-field <field=value>', 'Custom field in fieldId=value format (repeatable)', (val, prev) => [...(prev || []), val], [])
     .action(withPermission('issue.create', createTaskCommand, { schema: CreateTaskSchema }));
 issue
-    .command('search <jql-query>')
-    .description('Execute a JQL search query. Returns issues with key, summary, status, assignee, and priority.')
+    .command('search [jql-query]')
+    .description('Execute a JQL search query. Provide raw JQL or use --query to reference a saved query.')
     .option('-l, --limit <number>', 'Maximum number of results (default: 50)', '50')
+    .option('--query <name>', 'Use a saved query by name (mutually exclusive with positional JQL)')
+    .option('--list-queries', 'List all available saved queries')
     .action(withPermission('issue.search', runJqlCommand, {
     schema: RunJqlSchema,
     validateArgs: (args) => {
-        if (typeof args[0] !== 'string' || args[0].trim() === '') {
-            throw new CliError('JQL query cannot be empty');
+        const jqlQuery = args[0];
+        const opts = args[args.length - 2];
+        const hasQuery = opts && opts.query;
+        const hasListQueries = opts && opts.listQueries;
+        if (!hasQuery && !hasListQueries && (typeof jqlQuery !== 'string' || jqlQuery.trim() === '')) {
+            throw new CliError('JQL query cannot be empty. Provide a JQL query, use --query <name>, or use --list-queries.');
         }
     }
 }));

package/dist/commands/run-jql.js

@@ -1,11 +1,35 @@
 import { searchIssuesByJql } from '../lib/jira-client.js';
 import { outputResult } from '../lib/json-mode.js';
+import { getSavedQuery, listSavedQueries } from '../lib/settings.js';
+import { CliError } from '../types/errors.js';
 export async function runJqlCommand(jqlQuery, options) {
-    // Parse and validate limit parameter
+    // Handle --list-queries
+    if (options.listQueries) {
+        const queries = listSavedQueries();
+        outputResult({ queries });
+        return;
+    }
+    // Mutual exclusion: can't have both positional JQL and --query
+    if (jqlQuery && jqlQuery.trim() !== '' && options.query) {
+        throw new CliError('Cannot specify both JQL query and --query. Use one or the other.');
+    }
+    let resolvedJql;
+    if (options.query) {
+        const savedJql = getSavedQuery(options.query);
+        if (savedJql === undefined) {
+            const available = listSavedQueries().map((q) => q.name).join(', ');
+            const availableMsg = available ? available : '(none)';
+            throw new CliError(`Saved query '${options.query}' not found. Available: ${availableMsg}`);
+        }
+        resolvedJql = savedJql;
+    }
+    else {
+        resolvedJql = jqlQuery;
+    }
     let maxResults = options.limit || 50;
     if (maxResults > 1000) {
         maxResults = 1000;
     }
-    const issues = await searchIssuesByJql(jqlQuery, maxResults);
+    const issues = await searchIssuesByJql(resolvedJql, maxResults);
     outputResult(issues);
 }

package/dist/lib/settings.js

@@ -4,6 +4,16 @@ import os from 'os';
 import yaml from 'js-yaml';
 import { CliError } from '../types/errors.js';
 import { SettingsSchema } from './validation.js';
+export function getSavedQuery(name) {
+    const settings = loadSettings();
+    return settings.savedQueries?.[name];
+}
+export function listSavedQueries() {
+    const settings = loadSettings();
+    if (!settings.savedQueries)
+        return [];
+    return Object.entries(settings.savedQueries).map(([name, jql]) => ({ name, jql }));
+}
 // Mapping from old flat command names to new hierarchical paths
 export const LEGACY_COMMAND_MAP = {
     'me': 'user.me',

package/dist/lib/validation.js

@@ -113,6 +113,8 @@ export const UpdateDescriptionSchema = z.object({
 });
 export const RunJqlSchema = z.object({
     limit: NumericStringSchema.optional(),
+    query: z.string().optional(),
+    listQueries: z.boolean().optional(),
 });
 export const TimeframeSchema = z.string().regex(/^\d+d$/, 'Timeframe must be in format like "7d" or "30d"');
 export const GetPersonWorklogSchema = z.object({
@@ -157,10 +159,12 @@ export const OrganizationSettingsSchema = z.object({
     'allowed-commands': z.array(z.string()).nullish().transform(val => val || DEFAULT_ALLOWED_COMMANDS),
     'allowed-confluence-spaces': z.array(z.string()).nullish().transform(val => val || ['all']),
 });
+export const SavedQueryNameSchema = z.string().regex(/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/, 'Query name must be lowercase alphanumeric with hyphens (e.g., "my-query"), cannot start or end with a hyphen');
 export const SettingsSchema = z.object({
     defaults: OrganizationSettingsSchema.optional(),
     projects: z.array(ProjectSettingSchema).optional(),
     commands: z.array(z.string()).optional(),
+    savedQueries: z.record(SavedQueryNameSchema, z.string().min(1)).optional(),
 });
 // =============================================================================
 // EPIC VALIDATION SCHEMAS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jira-ai",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "AI friendly Jira CLI to save context",
   "type": "module",
   "main": "dist/cli.js",

package/settings.yaml

@@ -14,3 +14,12 @@ commands:
   - run-jql
   - list-issue-types
   - project-statuses
+
+# Saved Queries: Define reusable JQL queries by name.
+# Keys must be lowercase alphanumeric with optional hyphens (e.g., "my-query").
+# Values are JQL query strings. Saved queries are used with:
+#   jira-ai issue search --query <name>
+#   jira-ai issue search --list-queries
+# saved-queries:
+#   my-open-bugs: "project = PROJ AND status = Open AND issuetype = Bug"
+#   overdue-tasks: "project = PROJ AND duedate < now() AND status != Done"