@falldownthesystem/devtool 0.1.0 → 0.3.0

package/CLAUDE.md

@@ -0,0 +1,54 @@
+# 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)

package/README.md

@@ -5,7 +5,8 @@ A terminal-first CLI for working with Bitbucket PRs, Jira tickets, and Confluenc
 ## Install
 
 ```bash
-npm install -g @falldownthesystem/devtool
+npm install
+npm link
 ```
 
 This gives you the `dev` command globally. On first run, it'll walk you through connecting your Bitbucket, Jira, and Confluence accounts.
@@ -22,6 +23,7 @@ dev pr activity 42           # approvals, updates, comments
 dev jira view PROJ-123       # ticket details
 dev jira comments PROJ-123   # ticket comments
 dev jira search "sprint = 5" # JQL search
+dev jira children PROJ-123   # epic children or subtasks (auto-detect)
 dev jira mine                # your open tickets
 
 dev confluence spaces        # list spaces

package/package.json

@@ -1,34 +1,17 @@
 {
 	"name": "@falldownthesystem/devtool",
-	"version": "0.1.0",
-	"description": "CLI for Bitbucket PRs, Jira tickets, and Confluence pages",
+	"version": "0.3.0",
+	"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"
 	},
-	"keywords": [
-		"cli",
-		"bitbucket",
-		"jira",
-		"confluence",
-		"pull-request",
-		"devtools"
-	],
-	"author": "FallDownTheSystem",
+	"keywords": [],
+	"author": "",
 	"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/jira.js

@@ -59,3 +59,40 @@ export async function getMyIssues() {
 		: `assignee = currentUser() AND status != Done ORDER BY updated DESC`;
 	return searchIssues(jql);
 }
+
+export async function getIssueChildren(issueKey) {
+	const issue = await getIssue(issueKey);
+	const type = issue.fields.issuetype?.name;
+	const parent = { key: issue.key, type, summary: issue.fields.summary };
+
+	if (type === 'Epic') {
+		const response = await getClient().instance.get(
+			`/rest/agile/1.0/epic/${encodeURIComponent(issueKey)}/issue`,
+			{
+				params: {
+					fields: 'summary,status,assignee,priority,updated,issuetype',
+					maxResults: 100,
+				},
+			}
+		);
+		const data = response.data;
+		return {
+			issues: data.issues || [],
+			total: data.total ?? (data.issues || []).length,
+			startAt: data.startAt || 0,
+			maxResults: data.maxResults || 100,
+			parent,
+			source: 'epic',
+		};
+	}
+
+	const subtasks = issue.fields.subtasks || [];
+	return {
+		issues: subtasks,
+		total: subtasks.length,
+		startAt: 0,
+		maxResults: subtasks.length,
+		parent,
+		source: 'subtasks',
+	};
+}

package/src/clients/serviceDesk.js

@@ -0,0 +1,72 @@
+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);
+}

package/src/commands/jira.js

@@ -4,11 +4,13 @@ import {
 	getIssueComments,
 	searchIssues,
 	getMyIssues,
+	getIssueChildren,
 } from '../clients/jira.js';
 import {
 	formatIssueView, formatIssueComments, formatIssueSearch,
 	plainIssueView, plainIssueComments, plainIssueSearch,
 	curateIssueJson, curateCommentsJson, curateSearchJson,
+	formatIssueChildren, plainIssueChildren, curateChildrenJson,
 } from '../formatters/jira.js';
 import { spinner } from '../utils/output.js';
 import { handleError } from '../utils/errors.js';
@@ -74,6 +76,24 @@ jira.command('search <jql>')
 		}
 	});
 
+jira.command('children <key>')
+	.alias('subs')
+	.description('List epic children or issue subtasks')
+	.action(async function (key) {
+		const mode = getOutputMode(this);
+		const s = mode === 'rich' ? spinner(`Fetching children of ${key}...`).start() : null;
+		try {
+			const result = await getIssueChildren(key);
+			if (s) s.success({ text: `${result.total} ${result.source === 'epic' ? 'issue(s) in epic' : 'subtask(s)'}` });
+			if (mode === 'json') outputJson(curateChildrenJson(result));
+			else if (mode === 'plain') plainIssueChildren(result);
+			else formatIssueChildren(result);
+		} catch (err) {
+			if (s) s.error({ text: `Failed to fetch children of ${key}` });
+			handleError(err, `jira children ${key}`);
+		}
+	});
+
 jira.command('mine')
 	.alias('my')
 	.description('Show my open issues')

package/src/commands/sd.js

@@ -0,0 +1,95 @@
+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;

package/src/config/store.js

@@ -29,6 +29,15 @@ const schema = {
 			defaultSpace: { type: 'string' },
 		},
 	},
+	serviceDesk: {
+		type: 'object',
+		properties: {
+			baseUrl: { type: 'string' },
+			email: { type: 'string' },
+			token: { type: 'string' },
+			defaultProject: { type: 'string' },
+		},
+	},
 };
 
 const config = new Conf({
@@ -38,6 +47,7 @@ const config = new Conf({
 		bitbucket: { workspace: '', defaultRepo: '', email: '', token: '' },
 		jira: { baseUrl: '', token: '', defaultProject: '' },
 		confluence: { baseUrl: '', email: '', token: '', defaultSpace: '' },
+		serviceDesk: { baseUrl: '', email: '', token: '', defaultProject: '' },
 	},
 });
 
@@ -146,9 +156,52 @@ export async function runSetup() {
 		},
 	});
 
+	const reuseConfluenceCreds = confluence.email && confluence.token
+		? await p.confirm({
+			message: 'Reuse Confluence email/token for Jira Service Desk Cloud?',
+			initialValue: true,
+		})
+		: false;
+
+	if (p.isCancel(reuseConfluenceCreds)) {
+		p.cancel('Setup cancelled.');
+		process.exit(0);
+	}
+
+	const serviceDesk = await p.group({
+		baseUrl: () => p.text({
+			message: 'Jira Service Desk Cloud base URL (use canonical *.atlassian.net, not a vanity domain)',
+			placeholder: 'https://company.atlassian.net',
+			initialValue: config.get('serviceDesk.baseUrl') || '',
+		}),
+		email: () => reuseConfluenceCreds
+			? Promise.resolve(confluence.email)
+			: p.text({
+				message: 'Service Desk account email',
+				placeholder: 'you@company.com',
+				initialValue: config.get('serviceDesk.email') || '',
+			}),
+		token: () => reuseConfluenceCreds
+			? Promise.resolve(confluence.token)
+			: p.password({
+				message: 'Service Desk API token',
+			}),
+		defaultProject: () => p.text({
+			message: 'Service Desk default project key',
+			placeholder: 'TUKI',
+			initialValue: config.get('serviceDesk.defaultProject') || '',
+		}),
+	}, {
+		onCancel: () => {
+			p.cancel('Setup cancelled.');
+			process.exit(0);
+		},
+	});
+
 	config.set('bitbucket', bb);
 	config.set('jira', jira);
 	config.set('confluence', confluence);
+	config.set('serviceDesk', serviceDesk);
 
 	p.outro(pc.green('Configuration saved!'));
 }

package/src/formatters/jira.js

@@ -109,6 +109,23 @@ export function curateSearchJson(result) {
 	};
 }
 
+export function curateChildrenJson(result) {
+	return {
+		parent: result.parent,
+		source: result.source,
+		total: result.total,
+		issues: result.issues.map((issue) => ({
+			key: issue.key,
+			summary: issue.fields?.summary || null,
+			status: issue.fields?.status?.name || null,
+			type: issue.fields?.issuetype?.name || null,
+			assignee: issue.fields?.assignee?.displayName || null,
+			priority: issue.fields?.priority?.name || null,
+			updated: issue.fields?.updated || null,
+		})),
+	};
+}
+
 // --- Plain formatters ---
 
 export function plainIssueView(issue) {
@@ -149,6 +166,27 @@ export function plainIssueSearch(result) {
 	if (result.total > showing) console.log(`Showing ${result.startAt + 1}-${showing} of ${result.total}`);
 }
 
+export function plainIssueChildren(result) {
+	const label = result.source === 'epic' ? 'epic children' : 'subtasks';
+	console.log(`${result.parent.key} (${result.parent.type}) "${result.parent.summary}" - ${result.total} ${label}`);
+	if (result.issues.length === 0) { console.log('None.'); return; }
+	for (const issue of result.issues) {
+		const f = issue.fields || {};
+		const parts = [
+			`${issue.key}`,
+			f.status?.name ? `[${f.status.name}]` : null,
+			f.issuetype?.name ? `(${f.issuetype.name})` : null,
+			f.summary ? `"${f.summary}"` : null,
+		].filter(Boolean);
+		const meta = [
+			f.assignee?.displayName || null,
+			f.priority?.name || null,
+			f.updated ? relativeTime(f.updated) : null,
+		].filter(Boolean).join(', ');
+		console.log(`${parts.join(' ')}${meta ? ` - ${meta}` : ''}`);
+	}
+}
+
 // --- Rich formatters (original) ---
 
 export function formatIssueView(issue) {
@@ -234,3 +272,36 @@ export function formatIssueSearch(result) {
 	}
 	console.log('');
 }
+
+export function formatIssueChildren(result) {
+	const { issues, parent, source } = result;
+	const label = source === 'epic' ? 'children' : 'subtasks';
+
+	heading(`${parent.key} ${parent.summary}`);
+	console.log(pc.dim(`  ${parent.type} · ${result.total} ${label}`));
+	divider();
+
+	if (issues.length === 0) {
+		console.log(pc.dim('  None.'));
+		console.log('');
+		return;
+	}
+
+	const rows = issues.map((issue) => {
+		const f = issue.fields || {};
+		return [
+			pc.bold(issue.key),
+			(f.summary || '').length > 50
+				? f.summary.slice(0, 47) + '...'
+				: f.summary || '',
+			f.issuetype?.name || pc.dim('—'),
+			statusColor(f.status?.name),
+			f.assignee?.displayName || pc.dim('Unassigned'),
+			priorityColor(f.priority?.name),
+			f.updated ? relativeTime(f.updated) : pc.dim('—'),
+		];
+	});
+
+	console.log(table(['Key', 'Summary', 'Type', 'Status', 'Assignee', 'Priority', 'Updated'], rows));
+	console.log('');
+}

package/src/formatters/serviceDesk.js

@@ -0,0 +1,222 @@
+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('');
+}

package/src/index.js

@@ -6,13 +6,14 @@ import configCmd from './commands/config.js';
 import prCmd from './commands/pr.js';
 import jiraCmd from './commands/jira.js';
 import confluenceCmd from './commands/confluence.js';
+import sdCmd from './commands/sd.js';
 
 const program = new Command();
 
 program
 	.name('dev')
-	.description('CLI for Bitbucket PRs, Jira tickets, and Confluence pages')
-	.version('0.2.0')
+	.description('CLI for Bitbucket PRs, Jira tickets, Confluence pages, and Service Desk tickets')
+	.version('0.3.0')
 	.option('--json', 'Output raw JSON')
 	.option('--plain', 'Output compact plain text (no tables, no colors)');
 
@@ -20,6 +21,7 @@ program.addCommand(configCmd);
 program.addCommand(prCmd);
 program.addCommand(jiraCmd);
 program.addCommand(confluenceCmd);
+program.addCommand(sdCmd);
 
 program.hook('preAction', async (thisCommand, actionCommand) => {
 	const cmdChain = [];

package/LICENSE

@@ -1,15 +0,0 @@
-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.