@falldownthesystem/devtool 0.3.0 → 0.4.1

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025 FallDownTheSystem
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -5,8 +5,7 @@ A terminal-first CLI for working with Bitbucket PRs, Jira tickets, and Confluenc
 ## Install
 
 ```bash
-npm install
-npm link
+npm install -g @falldownthesystem/devtool
 ```
 
 This gives you the `dev` command globally. On first run, it'll walk you through connecting your Bitbucket, Jira, and Confluence accounts.

package/package.json

@@ -1,17 +1,35 @@
 {
 	"name": "@falldownthesystem/devtool",
-	"version": "0.3.0",
+	"version": "0.4.1",
 	"description": "CLI for Bitbucket PRs, Jira tickets, Confluence pages, and Service Desk tickets",
 	"type": "module",
 	"bin": {
 		"dev": "src/index.js"
 	},
+	"files": [
+		"src/"
+	],
 	"scripts": {
-		"start": "node src/index.js"
+		"start": "node src/index.js",
+		"test": "node --test test/config.test.js test/confluence.test.js test/service-desk.test.js"
 	},
-	"keywords": [],
-	"author": "",
+	"keywords": [
+		"cli",
+		"bitbucket",
+		"jira",
+		"confluence",
+		"pull-request",
+		"devtools"
+	],
+	"author": "FallDownTheSystem",
 	"license": "ISC",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/FallDownTheSystem/devtool.git"
+	},
+	"engines": {
+		"node": ">=18"
+	},
 	"dependencies": {
 		"@clack/prompts": "^1.0.0",
 		"cli-table3": "^0.6.5",

package/src/clients/confluence.js

@@ -1,7 +1,7 @@
 import { get } from '../config/store.js';
 
-function baseUrl() {
-	return `${get('confluence.baseUrl')}/wiki`;
+function apiUrl(path) {
+	return new URL(`/wiki${path}`, get('confluence.baseUrl'));
 }
 
 function authHeader() {
@@ -10,8 +10,10 @@ function authHeader() {
 	return 'Basic ' + Buffer.from(`${email}:${token}`).toString('base64');
 }
 
-async function request(path, params = {}) {
-	const url = new URL(path.startsWith('http') ? path : `${baseUrl()}${path}`);
+async function request(url, params = {}) {
+	if (url.origin !== new URL(get('confluence.baseUrl')).origin) {
+		throw new Error('Confluence pagination points to a different site. Check confluence.baseUrl.');
+	}
 	for (const [k, v] of Object.entries(params)) {
 		if (v !== undefined && v !== null) url.searchParams.set(k, v);
 	}
@@ -35,11 +37,13 @@ async function request(path, params = {}) {
 
 async function paginateV2(path, params = {}) {
 	const results = [];
-	let data = await request(path, params);
+	let url = apiUrl(path);
+	let data = await request(url, params);
 	results.push(...(data.results || []));
 
 	while (data._links?.next) {
-		data = await request(data._links.next);
+		url = new URL(data._links.next, url);
+		data = await request(url);
 		results.push(...(data.results || []));
 	}
 
@@ -51,7 +55,7 @@ export async function listSpaces() {
 }
 
 export async function getPage(id) {
-	return request(`/api/v2/pages/${id}`, { 'body-format': 'storage' });
+	return request(apiUrl(`/api/v2/pages/${id}`), { 'body-format': 'storage' });
 }
 
 export async function listSpacePages(spaceId) {
@@ -59,5 +63,5 @@ export async function listSpacePages(spaceId) {
 }
 
 export async function searchPages(cql) {
-	return request('/rest/api/search', { cql });
+	return request(apiUrl('/rest/api/search'), { cql });
 }

package/src/clients/serviceDesk.js

@@ -1,72 +1,181 @@
-import { get } from '../config/store.js';
-
-function baseUrl() {
-	return get('serviceDesk.baseUrl');
-}
-
-function authHeader() {
-	const email = get('serviceDesk.email');
-	const token = get('serviceDesk.token');
-	return 'Basic ' + Buffer.from(`${email}:${token}`).toString('base64');
-}
-
-async function request(path, params = {}) {
-	const url = new URL(path.startsWith('http') ? path : `${baseUrl()}${path}`);
-	for (const [k, v] of Object.entries(params)) {
-		if (v !== undefined && v !== null && v !== '') url.searchParams.set(k, v);
-	}
-
-	const res = await fetch(url, {
-		headers: {
-			'Authorization': authHeader(),
-			'Accept': 'application/json',
-		},
-	});
-
-	if (!res.ok) {
-		const err = new Error(`Service Desk API error: ${res.status} ${res.statusText}`);
-		err.status = res.status;
-		err.url = url.toString();
-		throw err;
-	}
-
-	return res.json();
-}
-
-export async function getIssue(issueKey) {
-	return request(`/rest/api/3/issue/${encodeURIComponent(issueKey)}`, {
-		expand: 'renderedFields',
-	});
-}
-
-export async function getIssueComments(issueKey) {
-	const data = await request(`/rest/api/3/issue/${encodeURIComponent(issueKey)}/comment`, {
-		orderBy: 'created',
-		maxResults: 100,
-	});
-	return data.comments || [];
-}
-
-export async function searchIssues(jql, maxResults = 50, nextPageToken = '') {
-	const fields = 'summary,status,assignee,priority,updated,issuetype,reporter,customfield_10010';
-	const data = await request('/rest/api/3/search/jql', {
-		jql,
-		fields,
-		maxResults,
-		nextPageToken,
-	});
-	return {
-		issues: data.issues || [],
-		nextPageToken: data.nextPageToken || null,
-		isLast: data.isLast !== false,
-		maxResults,
-	};
-}
-
-export async function getMyIssues() {
-	const project = get('serviceDesk.defaultProject');
-	const jql = project
-		? `project = ${project} AND assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC`
-		: `assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC`;
-	return searchIssues(jql);
-}
+import { get } from '../config/store.js';
+
+function configurationError(reason) {
+	return new Error(`Service Desk configuration error: ${reason}. Check serviceDesk.baseUrl; use the canonical https://<site>.atlassian.net URL.`);
+}
+
+function baseUrl() {
+	let url;
+	try {
+		url = new URL(get('serviceDesk.baseUrl'));
+	} catch {
+		throw configurationError('invalid base URL');
+	}
+	if (url.protocol !== 'https:' || url.username || url.password || url.search || url.hash || /[^/]/.test(url.pathname)) {
+		throw configurationError('the base URL must be an HTTPS site URL without a path, query, or credentials');
+	}
+	return new URL(url.origin);
+}
+
+function authHeader() {
+	const email = get('serviceDesk.email');
+	const token = get('serviceDesk.token');
+	return 'Basic ' + Buffer.from(`${email}:${token}`).toString('base64');
+}
+
+async function fetchJson(url, headers = {}) {
+	const res = await fetch(url, {
+		redirect: 'manual',
+		headers: { 'Accept': 'application/json', ...headers },
+	});
+
+	if (res.redirected || (res.status >= 300 && res.status < 400)) {
+		throw configurationError('the API returned a redirect; authentication may not reach the intended site');
+	}
+	if (res.url && new URL(res.url).origin !== url.origin) {
+		throw configurationError('the API response came from an unexpected host');
+	}
+	if (!res.ok) {
+		const err = new Error(`Service Desk API error: ${res.status} ${res.statusText}`);
+		err.status = res.status;
+		err.url = url.toString();
+		throw err;
+	}
+
+	const contentType = res.headers.get('content-type')?.split(';')[0].trim().toLowerCase();
+	if (!/^application\/(?:[\w.+-]+\+)?json$/.test(contentType || '')) {
+		throw configurationError('expected a JSON API response, but received a different content type');
+	}
+	let data;
+	try {
+		data = await res.json();
+	} catch {
+		throw configurationError('the API response contains invalid JSON');
+	}
+	if (!data || typeof data !== 'object' || Array.isArray(data)) {
+		throw configurationError('unexpected API response structure');
+	}
+	return data;
+}
+
+async function request(path, params = {}, { extraHeaders = {}, validate = () => true } = {}) {
+	const site = baseUrl();
+	if (!site.hostname.endsWith('.atlassian.net')) {
+		const info = await fetchJson(new URL('/rest/api/2/serverInfo', site));
+		let canonical;
+		try {
+			canonical = new URL(info.baseUrl);
+		} catch {
+			throw configurationError('serverInfo did not return a valid canonical base URL');
+		}
+		if (canonical.origin !== site.origin || canonical.pathname.replace(/\/+$/, '') !== '') {
+			throw configurationError(`serverInfo identifies a different canonical base URL: ${canonical.origin}${canonical.pathname.replace(/\/+$/, '')}`);
+		}
+	}
+
+	const url = new URL(path, site);
+	for (const [k, v] of Object.entries(params)) {
+		if (v !== undefined && v !== null && v !== '') url.searchParams.set(k, v);
+	}
+	const data = await fetchJson(url, { 'Authorization': authHeader(), ...extraHeaders });
+	if (!validate(data)) throw configurationError('unexpected API response structure');
+	return data;
+}
+
+export async function getIssue(issueKey) {
+	return request(`/rest/api/3/issue/${encodeURIComponent(issueKey)}`, {
+		expand: 'renderedFields',
+	}, {
+		validate: (data) => typeof data.key === 'string' && data.fields && typeof data.fields === 'object' && !Array.isArray(data.fields),
+	});
+}
+
+export async function getIssueComments(issueKey) {
+	const data = await request(`/rest/api/3/issue/${encodeURIComponent(issueKey)}/comment`, {
+		orderBy: 'created',
+		maxResults: 100,
+	}, {
+		validate: (data) => Array.isArray(data.comments),
+	});
+	return data.comments;
+}
+
+export async function searchIssues(jql, maxResults = 50, nextPageToken = '') {
+	const fields = 'summary,status,assignee,priority,updated,issuetype,reporter,customfield_10010';
+	const data = await request('/rest/api/3/search/jql', {
+		jql,
+		fields,
+		maxResults,
+		nextPageToken,
+	}, {
+		validate: (data) => Array.isArray(data.issues)
+			&& (data.isLast === undefined || typeof data.isLast === 'boolean')
+			&& (data.nextPageToken == null || typeof data.nextPageToken === 'string'),
+	});
+	return {
+		issues: data.issues,
+		nextPageToken: data.nextPageToken || null,
+		isLast: data.isLast !== false,
+		maxResults,
+	};
+}
+
+export async function getMyIssues() {
+	const project = get('serviceDesk.defaultProject');
+	const jql = project
+		? `project = ${project} AND assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC`
+		: `assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC`;
+	return searchIssues(jql);
+}
+
+let _serviceDeskIdCache = null;
+
+async function getServiceDeskId(projectKey) {
+	if (_serviceDeskIdCache && _serviceDeskIdCache.projectKey === projectKey) {
+		return _serviceDeskIdCache.id;
+	}
+	const data = await request('/rest/servicedeskapi/servicedesk', { start: 0, limit: 100 }, {
+		extraHeaders: { 'X-ExperimentalApi': 'opt-in' },
+		validate: (data) => Array.isArray(data.values),
+	});
+	const match = data.values.find((sd) => sd.projectKey === projectKey);
+	if (!match) {
+		throw new Error(`No Service Desk found for project ${projectKey}`);
+	}
+	_serviceDeskIdCache = { projectKey, id: match.id };
+	return match.id;
+}
+
+export async function listQueues() {
+	const projectKey = get('serviceDesk.defaultProject');
+	if (!projectKey) throw new Error('serviceDesk.defaultProject is not configured');
+	const sdId = await getServiceDeskId(projectKey);
+	const data = await request(`/rest/servicedeskapi/servicedesk/${sdId}/queue`, { start: 0, limit: 100 }, {
+		extraHeaders: { 'X-ExperimentalApi': 'opt-in' },
+		validate: (data) => Array.isArray(data.values),
+	});
+	return data.values.map((q) => ({ id: q.id, name: q.name, jql: q.jql }));
+}
+
+export async function findQueue(nameOrId) {
+	const queues = await listQueues();
+	const idMatch = queues.find((q) => String(q.id) === String(nameOrId));
+	if (idMatch) return idMatch;
+	const lower = nameOrId.toLowerCase();
+	const exact = queues.find((q) => q.name.toLowerCase() === lower);
+	if (exact) return exact;
+	const partial = queues.filter((q) => q.name.toLowerCase().includes(lower));
+	if (partial.length === 1) return partial[0];
+	if (partial.length > 1) {
+		const err = new Error(`Ambiguous queue "${nameOrId}" — matches: ${partial.map((q) => q.name).join(', ')}`);
+		err.candidates = partial;
+		throw err;
+	}
+	throw new Error(`No queue found matching "${nameOrId}"`);
+}
+
+export async function searchByQueue(nameOrId, maxResults = 50, nextPageToken = '') {
+	const queue = await findQueue(nameOrId);
+	const result = await searchIssues(queue.jql, maxResults, nextPageToken);
+	return { ...result, queue };
+}

package/src/commands/config.js

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { getAll, set, runSetup, configPath, isConfigured } from '../config/store.js';
+import { getAll, set, runSetup, configPath, schema } from '../config/store.js';
 import { heading, field, mask, success, error, divider } from '../utils/output.js';
 
 const config = new Command('config')
@@ -17,29 +17,15 @@ config
 	.alias('get')
 	.description('Show current configuration')
 	.action(() => {
-		if (!isConfigured()) {
-			error('Not configured yet. Run: dev config setup');
-			return;
-		}
-
 		const all = getAll();
 
-		heading('Bitbucket');
-		field('Workspace', all.bitbucket.workspace);
-		field('Default repo', all.bitbucket.defaultRepo);
-		field('Email', all.bitbucket.email);
-		field('Token', mask(all.bitbucket.token));
-
-		heading('Jira');
-		field('Base URL', all.jira.baseUrl);
-		field('Token', mask(all.jira.token));
-		field('Default project', all.jira.defaultProject);
-
-		heading('Confluence');
-		field('Base URL', all.confluence.baseUrl);
-		field('Email', all.confluence.email);
-		field('Token', mask(all.confluence.token));
-		field('Default space', all.confluence.defaultSpace);
+		for (const [section, definition] of Object.entries(schema)) {
+			heading(definition.title);
+			for (const [key, property] of Object.entries(definition.properties)) {
+				const value = all[section]?.[key] ?? '';
+				field(property.title, property.writeOnly ? mask(value) : value);
+			}
+		}
 
 		console.log('');
 		divider();
@@ -51,11 +37,8 @@ config
 	.command('set <key> <value>')
 	.description('Set a config value (e.g. bitbucket.workspace my-ws)')
 	.action((key, value) => {
-		const validKeys = [
-			'bitbucket.workspace', 'bitbucket.defaultRepo', 'bitbucket.email', 'bitbucket.token',
-			'jira.baseUrl', 'jira.token', 'jira.defaultProject',
-			'confluence.baseUrl', 'confluence.email', 'confluence.token', 'confluence.defaultSpace',
-		];
+		const validKeys = Object.entries(schema).flatMap(([section, definition]) =>
+			Object.keys(definition.properties).map((key) => `${section}.${key}`));
 		if (!validKeys.includes(key)) {
 			error(`Invalid key: ${key}`);
 			console.log(`Valid keys: ${validKeys.join(', ')}`);

package/src/commands/sd.js

@@ -1,95 +1,135 @@
-import { Command } from 'commander';
-import {
-	getIssue,
-	getIssueComments,
-	searchIssues,
-	getMyIssues,
-} from '../clients/serviceDesk.js';
-import {
-	formatIssueView, formatIssueComments, formatIssueSearch,
-	plainIssueView, plainIssueComments, plainIssueSearch,
-	curateIssueJson, curateCommentsJson, curateSearchJson,
-} from '../formatters/serviceDesk.js';
-import { spinner } from '../utils/output.js';
-import { handleError } from '../utils/errors.js';
-import { getOutputMode, outputJson } from '../utils/mode.js';
-
-const sd = new Command('sd')
-	.alias('servicedesk')
-	.description('Jira Service Desk Cloud tickets');
-
-sd.command('view <key>')
-	.alias('read')
-	.description('View ticket details')
-	.action(async function (key) {
-		const mode = getOutputMode(this);
-		const s = mode === 'rich' ? spinner(`Fetching ${key}...`).start() : null;
-		try {
-			const issue = await getIssue(key);
-			if (s) s.success({ text: key });
-			if (mode === 'json') outputJson(curateIssueJson(issue));
-			else if (mode === 'plain') plainIssueView(issue);
-			else formatIssueView(issue);
-		} catch (err) {
-			if (s) s.error({ text: `Failed to fetch ${key}` });
-			handleError(err, `sd view ${key}`);
-		}
-	});
-
-sd.command('comments <key>')
-	.description('List ticket comments')
-	.action(async function (key) {
-		const mode = getOutputMode(this);
-		const s = mode === 'rich' ? spinner(`Fetching comments for ${key}...`).start() : null;
-		try {
-			const comments = await getIssueComments(key);
-			if (s) s.success({ text: `${comments.length} comment(s)` });
-			if (mode === 'json') outputJson(curateCommentsJson(comments));
-			else if (mode === 'plain') plainIssueComments(comments);
-			else formatIssueComments(comments);
-		} catch (err) {
-			if (s) s.error({ text: `Failed to fetch comments for ${key}` });
-			handleError(err, `sd comments ${key}`);
-		}
-	});
-
-sd.command('search <jql>')
-	.alias('find')
-	.description('Search Service Desk tickets with JQL')
-	.option('-n, --per-page <number>', 'Results per page', '20')
-	.option('--next <token>', 'Continuation token from a previous page')
-	.action(async function (jql, opts) {
-		const mode = getOutputMode(this);
-		const perPage = parseInt(opts.perPage, 10);
-		const s = mode === 'rich' ? spinner('Searching...').start() : null;
-		try {
-			const result = await searchIssues(jql, perPage, opts.next || '');
-			if (s) s.success({ text: `${result.issues.length} issue(s) returned` });
-			if (mode === 'json') outputJson(curateSearchJson(result));
-			else if (mode === 'plain') plainIssueSearch(result);
-			else formatIssueSearch(result);
-		} catch (err) {
-			if (s) s.error({ text: 'Search failed' });
-			handleError(err, `sd search "${jql}"`);
-		}
-	});
-
-sd.command('mine')
-	.alias('my')
-	.description('Show my open Service Desk tickets')
-	.action(async function () {
-		const mode = getOutputMode(this);
-		const s = mode === 'rich' ? spinner('Fetching my tickets...').start() : null;
-		try {
-			const result = await getMyIssues();
-			if (s) s.success({ text: `${result.issues.length} ticket(s)` });
-			if (mode === 'json') outputJson(curateSearchJson(result));
-			else if (mode === 'plain') plainIssueSearch(result);
-			else formatIssueSearch(result);
-		} catch (err) {
-			if (s) s.error({ text: 'Failed to fetch tickets' });
-			handleError(err, 'sd my tickets');
-		}
-	});
-
-export default sd;
+import { Command } from 'commander';
+import {
+	getIssue,
+	getIssueComments,
+	searchIssues,
+	getMyIssues,
+	listQueues,
+	searchByQueue,
+} from '../clients/serviceDesk.js';
+import {
+	formatIssueView, formatIssueComments, formatIssueSearch,
+	plainIssueView, plainIssueComments, plainIssueSearch,
+	curateIssueJson, curateCommentsJson, curateSearchJson,
+	formatQueueList, plainQueueList, curateQueuesJson,
+} from '../formatters/serviceDesk.js';
+import { spinner } from '../utils/output.js';
+import { handleError } from '../utils/errors.js';
+import { getOutputMode, outputJson } from '../utils/mode.js';
+
+const sd = new Command('sd')
+	.alias('servicedesk')
+	.description('Jira Service Desk Cloud tickets');
+
+sd.command('view <key>')
+	.alias('read')
+	.description('View ticket details')
+	.action(async function (key) {
+		const mode = getOutputMode(this);
+		const s = mode === 'rich' ? spinner(`Fetching ${key}...`).start() : null;
+		try {
+			const issue = await getIssue(key);
+			if (s) s.success({ text: key });
+			if (mode === 'json') outputJson(curateIssueJson(issue));
+			else if (mode === 'plain') plainIssueView(issue);
+			else formatIssueView(issue);
+		} catch (err) {
+			if (s) s.error({ text: `Failed to fetch ${key}` });
+			handleError(err, `sd view ${key}`);
+		}
+	});
+
+sd.command('comments <key>')
+	.description('List ticket comments')
+	.action(async function (key) {
+		const mode = getOutputMode(this);
+		const s = mode === 'rich' ? spinner(`Fetching comments for ${key}...`).start() : null;
+		try {
+			const comments = await getIssueComments(key);
+			if (s) s.success({ text: `${comments.length} comment(s)` });
+			if (mode === 'json') outputJson(curateCommentsJson(comments));
+			else if (mode === 'plain') plainIssueComments(comments);
+			else formatIssueComments(comments);
+		} catch (err) {
+			if (s) s.error({ text: `Failed to fetch comments for ${key}` });
+			handleError(err, `sd comments ${key}`);
+		}
+	});
+
+sd.command('search <jql>')
+	.alias('find')
+	.description('Search Service Desk tickets with JQL')
+	.option('-n, --per-page <number>', 'Results per page', '20')
+	.option('--next <token>', 'Continuation token from a previous page')
+	.action(async function (jql, opts) {
+		const mode = getOutputMode(this);
+		const perPage = parseInt(opts.perPage, 10);
+		const s = mode === 'rich' ? spinner('Searching...').start() : null;
+		try {
+			const result = await searchIssues(jql, perPage, opts.next || '');
+			if (s) s.success({ text: `${result.issues.length} issue(s) returned` });
+			if (mode === 'json') outputJson(curateSearchJson(result));
+			else if (mode === 'plain') plainIssueSearch(result);
+			else formatIssueSearch(result);
+		} catch (err) {
+			if (s) s.error({ text: 'Search failed' });
+			handleError(err, `sd search "${jql}"`);
+		}
+	});
+
+sd.command('queues')
+	.description('List Service Desk queues for the default project')
+	.action(async function () {
+		const mode = getOutputMode(this);
+		const s = mode === 'rich' ? spinner('Fetching queues...').start() : null;
+		try {
+			const queues = await listQueues();
+			if (s) s.success({ text: `${queues.length} queue(s)` });
+			if (mode === 'json') outputJson(curateQueuesJson(queues));
+			else if (mode === 'plain') plainQueueList(queues);
+			else formatQueueList(queues);
+		} catch (err) {
+			if (s) s.error({ text: 'Failed to fetch queues' });
+			handleError(err, 'sd queues');
+		}
+	});
+
+sd.command('queue <nameOrId>')
+	.description('Show issues in a Service Desk queue (by name or id)')
+	.option('-n, --per-page <number>', 'Results per page', '20')
+	.option('--next <token>', 'Continuation token from a previous page')
+	.action(async function (nameOrId, opts) {
+		const mode = getOutputMode(this);
+		const perPage = parseInt(opts.perPage, 10);
+		const s = mode === 'rich' ? spinner(`Fetching queue "${nameOrId}"...`).start() : null;
+		try {
+			const result = await searchByQueue(nameOrId, perPage, opts.next || '');
+			if (s) s.success({ text: `${result.issues.length} issue(s) in "${result.queue.name}"` });
+			if (mode === 'json') outputJson(curateSearchJson(result));
+			else if (mode === 'plain') plainIssueSearch(result);
+			else formatIssueSearch(result);
+		} catch (err) {
+			if (s) s.error({ text: `Failed to fetch queue "${nameOrId}"` });
+			handleError(err, `sd queue ${nameOrId}`);
+		}
+	});
+
+sd.command('mine')
+	.alias('my')
+	.description('Show my open Service Desk tickets')
+	.action(async function () {
+		const mode = getOutputMode(this);
+		const s = mode === 'rich' ? spinner('Fetching my tickets...').start() : null;
+		try {
+			const result = await getMyIssues();
+			if (s) s.success({ text: `${result.issues.length} ticket(s)` });
+			if (mode === 'json') outputJson(curateSearchJson(result));
+			else if (mode === 'plain') plainIssueSearch(result);
+			else formatIssueSearch(result);
+		} catch (err) {
+			if (s) s.error({ text: 'Failed to fetch tickets' });
+			handleError(err, 'sd my tickets');
+		}
+	});
+
+export default sd;

package/src/config/store.js

@@ -2,40 +2,44 @@ import Conf from 'conf';
 import * as p from '@clack/prompts';
 import pc from 'picocolors';
 
-const schema = {
+export const schema = {
 	bitbucket: {
 		type: 'object',
+		title: 'Bitbucket',
 		properties: {
-			workspace: { type: 'string' },
-			defaultRepo: { type: 'string' },
-			email: { type: 'string' },
-			token: { type: 'string' },
+			workspace: { type: 'string', title: 'Workspace' },
+			defaultRepo: { type: 'string', title: 'Default repo' },
+			email: { type: 'string', title: 'Email' },
+			token: { type: 'string', title: 'Token', writeOnly: true },
 		},
 	},
 	jira: {
 		type: 'object',
+		title: 'Jira',
 		properties: {
-			baseUrl: { type: 'string' },
-			token: { type: 'string' },
-			defaultProject: { type: 'string' },
+			baseUrl: { type: 'string', title: 'Base URL' },
+			token: { type: 'string', title: 'Token', writeOnly: true },
+			defaultProject: { type: 'string', title: 'Default project' },
 		},
 	},
 	confluence: {
 		type: 'object',
+		title: 'Confluence',
 		properties: {
-			baseUrl: { type: 'string' },
-			email: { type: 'string' },
-			token: { type: 'string' },
-			defaultSpace: { type: 'string' },
+			baseUrl: { type: 'string', title: 'Base URL' },
+			email: { type: 'string', title: 'Email' },
+			token: { type: 'string', title: 'Token', writeOnly: true },
+			defaultSpace: { type: 'string', title: 'Default space' },
 		},
 	},
 	serviceDesk: {
 		type: 'object',
+		title: 'Service Desk',
 		properties: {
-			baseUrl: { type: 'string' },
-			email: { type: 'string' },
-			token: { type: 'string' },
-			defaultProject: { type: 'string' },
+			baseUrl: { type: 'string', title: 'Base URL' },
+			email: { type: 'string', title: 'Email' },
+			token: { type: 'string', title: 'Token', writeOnly: true },
+			defaultProject: { type: 'string', title: 'Default project' },
 		},
 	},
 };

package/src/formatters/serviceDesk.js

@@ -1,222 +1,267 @@
-import { table, heading, field, divider, pc } from '../utils/output.js';
-
-function statusColor(name) {
-	if (!name) return pc.dim('Unknown');
-	const lower = name.toLowerCase();
-	if (lower === 'done' || lower === 'closed' || lower === 'resolved') return pc.green(name);
-	if (lower === 'in progress' || lower === 'in review' || lower === 'waiting for support') return pc.blue(name);
-	if (lower === 'to do' || lower === 'open' || lower === 'backlog' || lower === 'waiting for customer') return pc.yellow(name);
-	return name;
-}
-
-function priorityColor(name) {
-	if (!name) return pc.dim('None');
-	const lower = name.toLowerCase();
-	if (lower === 'highest' || lower === 'blocker') return pc.red(pc.bold(name));
-	if (lower === 'high' || lower === 'critical') return pc.red(name);
-	if (lower === 'low' || lower === 'minor' || lower === 'lowest' || lower === 'trivial') return pc.dim(name);
-	return name;
-}
-
-function relativeTime(dateStr) {
-	if (!dateStr) return '';
-	const diff = Date.now() - new Date(dateStr).getTime();
-	const mins = Math.floor(diff / 60000);
-	if (mins < 60) return `${mins}m ago`;
-	const hours = Math.floor(mins / 60);
-	if (hours < 24) return `${hours}h ago`;
-	const days = Math.floor(hours / 24);
-	if (days < 30) return `${days}d ago`;
-	return new Date(dateStr).toLocaleDateString();
-}
-
-function adfToText(node) {
-	if (!node) return '';
-	if (typeof node === 'string') return node;
-	if (Array.isArray(node)) return node.map(adfToText).join('');
-	if (node.type === 'text') return node.text || '';
-	if (node.type === 'hardBreak') return '\n';
-	const inner = adfToText(node.content);
-	const blockTypes = new Set(['paragraph', 'heading', 'bulletList', 'orderedList', 'listItem', 'codeBlock', 'blockquote']);
-	if (blockTypes.has(node.type)) return inner + '\n';
-	return inner;
-}
-
-function descriptionText(field) {
-	if (!field) return '';
-	if (typeof field === 'string') return field;
-	return adfToText(field).trim();
-}
-
-function requestType(fields) {
-	for (const key of Object.keys(fields)) {
-		if (!key.startsWith('customfield_')) continue;
-		const val = fields[key];
-		if (val && typeof val === 'object' && val.requestType?.name) {
-			return val.requestType.name;
-		}
-	}
-	return null;
-}
-
-// --- JSON curators ---
-
-export function curateIssueJson(issue) {
-	const f = issue.fields;
-	return {
-		key: issue.key,
-		summary: f.summary,
-		status: f.status?.name || null,
-		priority: f.priority?.name || null,
-		type: f.issuetype?.name || null,
-		requestType: requestType(f),
-		assignee: f.assignee?.displayName || null,
-		reporter: f.reporter?.displayName || null,
-		labels: f.labels || [],
-		components: (f.components || []).map((c) => c.name),
-		created: f.created,
-		updated: f.updated,
-		description: descriptionText(f.description),
-	};
-}
-
-export function curateCommentsJson(comments) {
-	return comments.map((c) => ({
-		author: c.author?.displayName || null,
-		date: c.created,
-		body: descriptionText(c.body),
-	}));
-}
-
-export function curateSearchJson(result) {
-	return {
-		nextPageToken: result.nextPageToken,
-		isLast: result.isLast,
-		issues: result.issues.map((issue) => ({
-			key: issue.key,
-			summary: issue.fields.summary,
-			status: issue.fields.status?.name || null,
-			assignee: issue.fields.assignee?.displayName || null,
-			priority: issue.fields.priority?.name || null,
-			updated: issue.fields.updated,
-		})),
-	};
-}
-
-// --- Plain formatters ---
-
-export function plainIssueView(issue) {
-	const f = issue.fields;
-	console.log(`${issue.key} ${f.summary}`);
-	console.log(`Status: ${f.status?.name || 'Unknown'}`);
-	console.log(`Priority: ${f.priority?.name || 'None'}`);
-	console.log(`Type: ${f.issuetype?.name || 'Unknown'}`);
-	const rt = requestType(f);
-	if (rt) console.log(`Request Type: ${rt}`);
-	console.log(`Assignee: ${f.assignee?.displayName || 'Unassigned'}`);
-	console.log(`Reporter: ${f.reporter?.displayName || 'Unknown'}`);
-	if (f.labels?.length > 0) console.log(`Labels: ${f.labels.join(', ')}`);
-	if (f.components?.length > 0) console.log(`Components: ${f.components.map((c) => c.name).join(', ')}`);
-	console.log(`Created: ${f.created}`);
-	console.log(`Updated: ${f.updated}`);
-	const desc = descriptionText(f.description);
-	if (desc) console.log(`Description:\n${desc}`);
-}
-
-export function plainIssueComments(comments) {
-	if (comments.length === 0) { console.log('No comments.'); return; }
-	for (const c of comments) {
-		console.log(`${c.author?.displayName || 'Unknown'} (${relativeTime(c.created)}): ${descriptionText(c.body)}`);
-	}
-}
-
-export function plainIssueSearch(result) {
-	if (result.issues.length === 0) { console.log('No issues found.'); return; }
-	for (const issue of result.issues) {
-		const f = issue.fields;
-		console.log(`${issue.key} [${f.status?.name}] "${f.summary}" - ${f.assignee?.displayName || 'Unassigned'} (${f.priority?.name}, ${relativeTime(f.updated)})`);
-	}
-	if (!result.isLast && result.nextPageToken) {
-		console.log(`More results available (nextPageToken: ${result.nextPageToken})`);
-	}
-}
-
-// --- Rich formatters ---
-
-export function formatIssueView(issue) {
-	const f = issue.fields;
-
-	heading(`${issue.key} ${f.summary}`);
-	divider();
-	field('Status', statusColor(f.status?.name));
-	field('Priority', priorityColor(f.priority?.name));
-	field('Type', f.issuetype?.name);
-	const rt = requestType(f);
-	if (rt) field('Request Type', rt);
-	field('Assignee', f.assignee?.displayName || pc.dim('Unassigned'));
-	field('Reporter', f.reporter?.displayName);
-	field('Labels', f.labels?.length > 0 ? f.labels.join(', ') : null);
-	field('Components', f.components?.map((c) => c.name).join(', ') || null);
-	field('Created', new Date(f.created).toLocaleString());
-	field('Updated', new Date(f.updated).toLocaleString());
-
-	const desc = descriptionText(f.description);
-	if (desc) {
-		heading('Description');
-		const lines = desc.split('\n');
-		const truncated = lines.slice(0, 30);
-		for (const line of truncated) {
-			console.log(`  ${line}`);
-		}
-		if (lines.length > 30) {
-			console.log(pc.dim(`  ... (${lines.length - 30} more lines)`));
-		}
-	}
-
-	console.log('');
-}
-
-export function formatIssueComments(comments) {
-	if (comments.length === 0) {
-		console.log(pc.dim('  No comments.'));
-		return;
-	}
-
-	for (const c of comments) {
-		console.log(`\n  ${pc.bold(c.author?.displayName || 'Unknown')} ${pc.dim(relativeTime(c.created))}`);
-		const body = descriptionText(c.body);
-		if (body) {
-			for (const line of body.split('\n')) {
-				console.log(`  ${line}`);
-			}
-		}
-	}
-	console.log('');
-}
-
-export function formatIssueSearch(result) {
-	const { issues } = result;
-
-	if (issues.length === 0) {
-		console.log(pc.dim('  No issues found.'));
-		return;
-	}
-
-	const rows = issues.map((issue) => [
-		pc.bold(issue.key),
-		(issue.fields.summary || '').length > 55
-			? issue.fields.summary.slice(0, 52) + '...'
-			: issue.fields.summary || '',
-		statusColor(issue.fields.status?.name),
-		issue.fields.assignee?.displayName || pc.dim('Unassigned'),
-		priorityColor(issue.fields.priority?.name),
-		relativeTime(issue.fields.updated),
-	]);
-
-	console.log(table(['Key', 'Summary', 'Status', 'Assignee', 'Priority', 'Updated'], rows));
-
-	if (!result.isLast && result.nextPageToken) {
-		console.log(pc.dim(`  More results available — pass --next ${result.nextPageToken} to continue`));
-	}
-	console.log('');
-}
+import { table, heading, field, divider, pc } from '../utils/output.js';
+
+function statusColor(name) {
+	if (!name) return pc.dim('Unknown');
+	const lower = name.toLowerCase();
+	if (lower === 'done' || lower === 'closed' || lower === 'resolved') return pc.green(name);
+	if (lower === 'in progress' || lower === 'in review' || lower === 'waiting for support') return pc.blue(name);
+	if (lower === 'to do' || lower === 'open' || lower === 'backlog' || lower === 'waiting for customer') return pc.yellow(name);
+	return name;
+}
+
+function priorityColor(name) {
+	if (!name) return pc.dim('None');
+	const lower = name.toLowerCase();
+	if (lower === 'highest' || lower === 'blocker') return pc.red(pc.bold(name));
+	if (lower === 'high' || lower === 'critical') return pc.red(name);
+	if (lower === 'low' || lower === 'minor' || lower === 'lowest' || lower === 'trivial') return pc.dim(name);
+	return name;
+}
+
+function relativeTime(dateStr) {
+	if (!dateStr) return '';
+	const diff = Date.now() - new Date(dateStr).getTime();
+	const mins = Math.floor(diff / 60000);
+	if (mins < 60) return `${mins}m ago`;
+	const hours = Math.floor(mins / 60);
+	if (hours < 24) return `${hours}h ago`;
+	const days = Math.floor(hours / 24);
+	if (days < 30) return `${days}d ago`;
+	return new Date(dateStr).toLocaleDateString();
+}
+
+function adfToText(node) {
+	if (!node) return '';
+	if (typeof node === 'string') return node;
+	if (Array.isArray(node)) return node.map(adfToText).join('');
+	if (node.type === 'text') return node.text || '';
+	if (node.type === 'hardBreak') return '\n';
+	const inner = adfToText(node.content);
+	const blockTypes = new Set(['paragraph', 'heading', 'bulletList', 'orderedList', 'listItem', 'codeBlock', 'blockquote']);
+	if (blockTypes.has(node.type)) return inner + '\n';
+	return inner;
+}
+
+function descriptionText(field) {
+	if (!field) return '';
+	if (typeof field === 'string') return field;
+	return adfToText(field).trim();
+}
+
+function requestType(fields) {
+	for (const key of Object.keys(fields)) {
+		if (!key.startsWith('customfield_')) continue;
+		const val = fields[key];
+		if (val && typeof val === 'object' && val.requestType?.name) {
+			return val.requestType.name;
+		}
+	}
+	return null;
+}
+
+function migrationServerKey(fields) {
+	return fields.customfield_10165 || null;
+}
+
+// --- JSON curators ---
+
+export function curateIssueJson(issue) {
+	const f = issue.fields;
+	return {
+		key: issue.key,
+		summary: f.summary,
+		status: f.status?.name || null,
+		priority: f.priority?.name || null,
+		type: f.issuetype?.name || null,
+		requestType: requestType(f),
+		migrationServerKey: migrationServerKey(f),
+		assignee: f.assignee?.displayName || null,
+		reporter: f.reporter?.displayName || null,
+		labels: f.labels || [],
+		components: (f.components || []).map((c) => c.name),
+		created: f.created,
+		updated: f.updated,
+		description: descriptionText(f.description),
+	};
+}
+
+export function curateCommentsJson(comments) {
+	return comments.map((c) => ({
+		author: c.author?.displayName || null,
+		date: c.created,
+		body: descriptionText(c.body),
+	}));
+}
+
+export function curateSearchJson(result) {
+	return {
+		nextPageToken: result.nextPageToken,
+		isLast: result.isLast,
+		queue: result.queue ? { id: result.queue.id, name: result.queue.name, jql: result.queue.jql } : undefined,
+		issues: result.issues.map((issue) => ({
+			key: issue.key,
+			summary: issue.fields.summary,
+			status: issue.fields.status?.name || null,
+			assignee: issue.fields.assignee?.displayName || null,
+			priority: issue.fields.priority?.name || null,
+			updated: issue.fields.updated,
+		})),
+	};
+}
+
+export function curateQueuesJson(queues) {
+	return queues.map((q) => ({ id: q.id, name: q.name, jql: q.jql }));
+}
+
+export function plainQueueList(queues) {
+	if (queues.length === 0) { console.log('No queues.'); return; }
+	for (const q of queues) {
+		console.log(`${q.id}\t${q.name}\t${q.jql}`);
+	}
+}
+
+export function formatQueueList(queues) {
+	if (queues.length === 0) {
+		console.log(pc.dim('  No queues.'));
+		return;
+	}
+	const rows = queues.map((q) => [
+		pc.dim(String(q.id)),
+		pc.bold(q.name),
+		(q.jql || '').length > 80 ? q.jql.slice(0, 77) + '...' : q.jql || '',
+	]);
+	console.log(table(['ID', 'Name', 'JQL'], rows));
+	console.log('');
+}
+
+// --- Plain formatters ---
+
+export function plainIssueView(issue) {
+	const f = issue.fields;
+	console.log(`${issue.key} ${f.summary}`);
+	console.log(`Status: ${f.status?.name || 'Unknown'}`);
+	console.log(`Priority: ${f.priority?.name || 'None'}`);
+	console.log(`Type: ${f.issuetype?.name || 'Unknown'}`);
+	const rt = requestType(f);
+	if (rt) console.log(`Request Type: ${rt}`);
+	const mk = migrationServerKey(f);
+	if (mk) console.log(`Migration Server Key: ${mk}`);
+	console.log(`Assignee: ${f.assignee?.displayName || 'Unassigned'}`);
+	console.log(`Reporter: ${f.reporter?.displayName || 'Unknown'}`);
+	if (f.labels?.length > 0) console.log(`Labels: ${f.labels.join(', ')}`);
+	if (f.components?.length > 0) console.log(`Components: ${f.components.map((c) => c.name).join(', ')}`);
+	console.log(`Created: ${f.created}`);
+	console.log(`Updated: ${f.updated}`);
+	const desc = descriptionText(f.description);
+	if (desc) console.log(`Description:\n${desc}`);
+}
+
+export function plainIssueComments(comments) {
+	if (comments.length === 0) { console.log('No comments.'); return; }
+	for (const c of comments) {
+		console.log(`${c.author?.displayName || 'Unknown'} (${relativeTime(c.created)}): ${descriptionText(c.body)}`);
+	}
+}
+
+export function plainIssueSearch(result) {
+	if (result.queue) {
+		console.log(`Queue: ${result.queue.name} (${result.queue.id})`);
+		console.log(`JQL: ${result.queue.jql}`);
+	}
+	if (result.issues.length === 0) { console.log('No issues found.'); return; }
+	for (const issue of result.issues) {
+		const f = issue.fields;
+		console.log(`${issue.key} [${f.status?.name}] "${f.summary}" - ${f.assignee?.displayName || 'Unassigned'} (${f.priority?.name}, ${relativeTime(f.updated)})`);
+	}
+	if (!result.isLast && result.nextPageToken) {
+		console.log(`More results available (nextPageToken: ${result.nextPageToken})`);
+	}
+}
+
+// --- Rich formatters ---
+
+export function formatIssueView(issue) {
+	const f = issue.fields;
+
+	heading(`${issue.key} ${f.summary}`);
+	divider();
+	field('Status', statusColor(f.status?.name));
+	field('Priority', priorityColor(f.priority?.name));
+	field('Type', f.issuetype?.name);
+	const rt = requestType(f);
+	if (rt) field('Request Type', rt);
+	const mk = migrationServerKey(f);
+	if (mk) field('Migration Server Key', mk);
+	field('Assignee', f.assignee?.displayName || pc.dim('Unassigned'));
+	field('Reporter', f.reporter?.displayName);
+	field('Labels', f.labels?.length > 0 ? f.labels.join(', ') : null);
+	field('Components', f.components?.map((c) => c.name).join(', ') || null);
+	field('Created', new Date(f.created).toLocaleString());
+	field('Updated', new Date(f.updated).toLocaleString());
+
+	const desc = descriptionText(f.description);
+	if (desc) {
+		heading('Description');
+		const lines = desc.split('\n');
+		const truncated = lines.slice(0, 30);
+		for (const line of truncated) {
+			console.log(`  ${line}`);
+		}
+		if (lines.length > 30) {
+			console.log(pc.dim(`  ... (${lines.length - 30} more lines)`));
+		}
+	}
+
+	console.log('');
+}
+
+export function formatIssueComments(comments) {
+	if (comments.length === 0) {
+		console.log(pc.dim('  No comments.'));
+		return;
+	}
+
+	for (const c of comments) {
+		console.log(`\n  ${pc.bold(c.author?.displayName || 'Unknown')} ${pc.dim(relativeTime(c.created))}`);
+		const body = descriptionText(c.body);
+		if (body) {
+			for (const line of body.split('\n')) {
+				console.log(`  ${line}`);
+			}
+		}
+	}
+	console.log('');
+}
+
+export function formatIssueSearch(result) {
+	const { issues } = result;
+
+	if (result.queue) {
+		heading(`Queue: ${result.queue.name}`);
+		console.log(pc.dim(`  ${result.queue.jql}`));
+		divider();
+	}
+
+	if (issues.length === 0) {
+		console.log(pc.dim('  No issues found.'));
+		return;
+	}
+
+	const rows = issues.map((issue) => [
+		pc.bold(issue.key),
+		(issue.fields.summary || '').length > 55
+			? issue.fields.summary.slice(0, 52) + '...'
+			: issue.fields.summary || '',
+		statusColor(issue.fields.status?.name),
+		issue.fields.assignee?.displayName || pc.dim('Unassigned'),
+		priorityColor(issue.fields.priority?.name),
+		relativeTime(issue.fields.updated),
+	]);
+
+	console.log(table(['Key', 'Summary', 'Status', 'Assignee', 'Priority', 'Updated'], rows));
+
+	if (!result.isLast && result.nextPageToken) {
+		console.log(pc.dim(`  More results available — pass --next ${result.nextPageToken} to continue`));
+	}
+	console.log('');
+}

package/src/index.js

@@ -13,7 +13,7 @@ const program = new Command();
 program
 	.name('dev')
 	.description('CLI for Bitbucket PRs, Jira tickets, Confluence pages, and Service Desk tickets')
-	.version('0.3.0')
+	.version('0.4.1')
 	.option('--json', 'Output raw JSON')
 	.option('--plain', 'Output compact plain text (no tables, no colors)');
 

package/CLAUDE.md

@@ -1,54 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-`devtool` — a Node.js CLI (`dev`) for interacting with Bitbucket pull requests and Jira tickets from the terminal. Uses ES modules, commander for CLI parsing, and the `conf` package for persistent config storage.
-
-## Commands
-
-```bash
-# Run the CLI
-node src/index.js <command>
-
-# Install globally for `dev` command
-npm link
-```
-
-No build step, no tests, no linter configured yet.
-
-## Architecture
-
-```
-src/
-  index.js          # Entry point — commander program, registers subcommands, auto-setup hook
-  config/store.js   # Conf-based config (persisted to OS config dir via `conf` package)
-  clients/          # API clients (bitbucket.js uses fetch + Basic auth, jira.js uses jira.js SDK + Bearer token)
-  commands/         # Commander subcommands (config, pr, jira)
-  formatters/       # Output formatting — each has three variants: rich (colored tables), plain (compact text), JSON (curated objects)
-  utils/
-    output.js       # Shared UI primitives: spinner, table (cli-table3), heading, field, divider, mask
-    errors.js       # handleError — maps HTTP status codes and connection errors to user-friendly messages
-    mode.js         # getOutputMode — reads --json/--plain global flags, returns 'json'|'plain'|'rich'
-```
-
-### Output Mode Pattern
-
-Every command supports three output modes via global flags `--json` and `--plain`:
-- **rich** (default): colored output with tables (cli-table3) and spinners
-- **plain**: no colors, no tables, compact text — suitable for piping
-- **json**: curated JSON (not raw API responses) via `curate*Json` functions in formatters
-
-Commands follow this pattern: check mode → conditionally show spinner → fetch data → format via mode-specific function. The `withMode` helper in `commands/pr.js` abstracts this for simple cases.
-
-### Config
-
-Stored via `conf` package (projectName: `devtool`). Interactive setup runs automatically on first use (preAction hook in index.js). Config keys:
-- `bitbucket.{workspace, defaultRepo, email, token}`
-- `jira.{baseUrl, token, defaultProject}`
-
-### API Clients
-
-- **Bitbucket** (`clients/bitbucket.js`): Raw fetch against `api.bitbucket.org/2.0`, Basic auth, manual pagination via `next` links
-- **Jira** (`clients/jira.js`): Uses `jira.js` SDK (Version2Client) with Bearer token auth (overrides SDK's built-in Basic auth via request interceptor)