@falldownthesystem/devtool 0.4.0 → 0.5.0

package/src/formatters/serviceDesk.js

@@ -1,267 +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;
-}
-
-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('');
-}
+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.4.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)