atlass 1.9.0 → 1.10.0

package/README.md

@@ -44,12 +44,19 @@ atlass bitbucket logout
 ```bash
 atlass jira view PROJ-123
 atlass jira view https://acme.atlassian.net/browse/PROJ-123
+atlass confluence view 123456
+atlass confluence view https://acme.atlassian.net/wiki/spaces/DEV/pages/123456/Title
 ```
 
-Prints the issue to the terminal: fields, description, the last five comments
-(`--all-comments` for all of them), and attachment names. The status is colored
-by category and the Markdown is syntax highlighted, code blocks included; color
-turns off automatically when piping, or with `NO_COLOR`, leaving plain Markdown.
+Prints the issue or page to the terminal: fields, the body, the last five
+comments (`--all-comments` for all of them), and attachment names. The Jira
+status is colored by category and the Markdown is syntax highlighted, code
+blocks included; color turns off automatically when piping, or with `NO_COLOR`,
+leaving plain Markdown.
+
+Output taller than the terminal goes through a pager, `$PAGER` or `less`, with
+`LESS=FRX` unless you have set `LESS` yourself. Pass `--no-pager` to print
+directly. Piped output is never paged.
 
 ## Copy
 
@@ -96,12 +103,18 @@ body sent is everything between the H1 and `## Comments`.
 atlass jira list
 atlass jira list --project PROJ
 atlass jira list --all
+atlass confluence list
+atlass confluence list --space DOCS
 ```
 
-Lists issues assigned to you as `KEY  Status  Age  Summary`, with In Progress
-first, then To Do, and the most recently updated at the top of each group. Done
-issues are left out; `--all` adds those updated in the last 30 days. `--json`
-and `--copy` work as for search.
+`jira list` shows issues assigned to you as `KEY  Status  Age  Summary`, with
+In Progress first, then To Do, and the most recently updated at the top of each
+group. Done issues are left out; `--all` adds those updated in the last 30 days.
+
+`confluence list` shows the pages you starred as `ID  SPACE  Age  Title`, most
+recently updated first. `--limit` works as for search.
+
+For both, `--json` and `--copy` work as for search.
 
 ## Search
 
@@ -113,10 +126,11 @@ atlass confluence search "onboarding" --space DOCS
 atlass confluence search --cql "label = runbook ORDER BY created DESC"
 ```
 
-Filters combine with AND and sort by most recently updated. `--jql` and `--cql`
-replace the friendly filters. `--limit` defaults to 25, max 100. `--json` prints
-machine output. Add `--copy` to pick results interactively and copy each one,
-with `--out` as the target directory.
+Filters combine with AND and sort by most recently updated. Rows use the same
+columns as `jira list` and `confluence list`. `--jql` and `--cql` replace the
+friendly filters. `--limit` defaults to 25, max 100. `--json` prints machine
+output. Add `--copy` to pick results interactively and copy each one, with
+`--out` as the target directory.
 
 Discovery aids for the filters:
 

package/dist/bitbucket.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as buildStandalone, r as fail } from "./build-DhED0Zw_.mjs";
+import { n as buildStandalone, r as fail } from "./build-Colq1d4N.mjs";
 //#region src/bitbucket.ts
 buildStandalone("bitbucket").parseAsync().catch(fail);
 //#endregion

package/dist/{build-DhED0Zw_.mjs → build-Colq1d4N.mjs}

@@ -4,11 +4,12 @@ import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { Entry } from "@napi-rs/keyring";
+import kleur from "kleur";
 import { marked } from "marked";
 import { randomUUID } from "node:crypto";
 import { stripVTControlCharacters } from "node:util";
-import kleur from "kleur";
 import { common, createLowlight } from "lowlight";
+import { spawn } from "node:child_process";
 //#region src/cli/run.ts
 const SIGINT_EXIT_CODE = 130;
 function run(fn) {
@@ -925,6 +926,7 @@ async function searchPages(client, site, params) {
 			id: r.content?.id ?? "",
 			space: r.space?.key ?? r.resultGlobalContainer?.title ?? "",
 			title: decodeEntities(r.content?.title ?? r.title ?? ""),
+			updated: r.lastModified ?? "",
 			url: r.url ? `${site}/wiki${r.url}` : ""
 		})),
 		hasMore: serverPageWasFull
@@ -933,6 +935,7 @@ async function searchPages(client, site, params) {
 function buildCql(params) {
 	if (params.cql) return params.cql;
 	const clauses = ["type = page"];
+	if (params.starred) clauses.push("favourite = currentUser()");
 	if (params.space) clauses.push(`space = ${cqlStringLiteral(params.space)}`);
 	if (params.text) clauses.push(`text ~ ${cqlStringLiteral(params.text)}`);
 	return `${clauses.join(" AND ")} ORDER BY lastmodified DESC`;
@@ -1013,6 +1016,23 @@ async function resolveRef(arg, kind) {
 }
 //#endregion
 //#region src/commands/search-run.ts
+function alignedRows(items, nowMs, cells) {
+	const rows = items.map((item) => ({
+		...cells(item),
+		age: relativeTime(item.updated, nowMs),
+		json: { ...item }
+	}));
+	const width = (pick) => Math.max(...rows.map((row) => pick(row).length));
+	const idWidth = width((row) => row.id);
+	const labelWidth = width((row) => row.label);
+	const ageWidth = width((row) => row.age);
+	return rows.map((row) => ({
+		id: row.id,
+		fixedColumns: `${row.id.padEnd(idWidth)}  ${row.color(row.label.padEnd(labelWidth))}  ${row.age.padEnd(ageWidth)}`,
+		freeText: row.text,
+		json: row.json
+	}));
+}
 const COPY_CONCURRENCY = 5;
 async function runSearch(rows, options, noun, copyOne) {
 	if (options.json) {
@@ -1240,6 +1260,185 @@ function formatDate(timestamp) {
 	return new Date(ms).toISOString().slice(0, 10);
 }
 //#endregion
+//#region src/markdown/highlight.ts
+const HEADING = /^#{1,6} /;
+const QUOTE = /^(\s*)>( |$)/;
+const LIST = /^(\s*)(-|\d+\.) (\[[ x]\] )?/;
+const RULE = /^\s*---$/;
+const TABLE_ROW = /^\|.*\|$/;
+const TABLE_SEPARATOR = /^\|( --- \|)+$/;
+const CELL_DIVIDER = /(?<!\\)\|/;
+const DETAILS_OPEN = /^(\s*)<details><summary>(.*)<\/summary>$/;
+const DETAILS_CLOSE = /^\s*<\/details>$/;
+const FENCE_OPEN = /^((?:\s|> |- |\d+\. )*)```(\S*)$/;
+const FENCE = "```";
+const INLINE = /(`[^`]+`)|\[([^\]]+)\]\(((?:[^()]|\([^()]*\))+)\)|\*\*\*(.+?)\*\*\*|\*\*(.+?)\*\*|\*(?!\*)(.+?)(?<!\*)\*(?!\*)|~~(.+?)~~/g;
+const TOKEN_STYLES = {
+	keyword: kleur.magenta,
+	built_in: kleur.magenta,
+	literal: kleur.magenta,
+	string: kleur.green,
+	regexp: kleur.green,
+	addition: kleur.green,
+	number: kleur.yellow,
+	symbol: kleur.yellow,
+	meta: kleur.yellow,
+	attr: kleur.yellow,
+	comment: kleur.dim,
+	quote: kleur.dim,
+	deletion: kleur.dim,
+	title: kleur.cyan,
+	type: kleur.cyan,
+	section: kleur.cyan
+};
+const lowlight = createLowlight(common);
+function highlightMarkdown(md) {
+	const lines = md.split("\n");
+	const out = [];
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i] ?? "";
+		const fence = line.match(FENCE_OPEN);
+		if (!fence) {
+			out.push(highlightLine(line, lines[i + 1]));
+			continue;
+		}
+		const [, prefix = "", lang = ""] = fence;
+		const styledPrefix = prefix.replace(/\S+/g, (marker) => kleur.dim(marker));
+		out.push(`${styledPrefix}${kleur.dim(`${FENCE}${lang}`)}`);
+		const code = [];
+		const prefixed = [];
+		let j = i + 1;
+		for (; j < lines.length; j++) {
+			const raw = lines[j] ?? "";
+			const hasPrefix = raw.startsWith(prefix) || raw === prefix.trimEnd();
+			const body = raw.startsWith(prefix) ? raw.slice(prefix.length) : hasPrefix ? "" : raw;
+			if (body === FENCE) break;
+			code.push(body);
+			prefixed.push(hasPrefix);
+		}
+		if (code.length > 0) highlightCode(code.join("\n"), lang).split("\n").forEach((codeLine, k) => {
+			const lead = prefixed[k] ? styledPrefix : "";
+			out.push(codeLine ? `${lead}${codeLine}` : lead.trimEnd());
+		});
+		if (j < lines.length) {
+			const lead = (lines[j] ?? "").startsWith(prefix) ? styledPrefix : "";
+			out.push(`${lead}${kleur.dim(FENCE)}`);
+		}
+		i = j;
+	}
+	return out.join("\n");
+}
+function highlightCode(code, lang) {
+	if (!lang || !lowlight.registered(lang)) return styleEachLine(code, kleur.yellow);
+	return renderTree(lowlight.highlight(lang, code), (text) => text);
+}
+function renderTree(node, style) {
+	if (node.type === "text") return styleEachLine(node.value, style);
+	if (node.type !== "root" && node.type !== "element") return "";
+	const own = node.type === "element" ? tokenStyle(node.properties["className"]) : void 0;
+	const next = own ? (text) => style(own(text)) : style;
+	return node.children.map((child) => renderTree(child, next)).join("");
+}
+function tokenStyle(className) {
+	if (!Array.isArray(className)) return void 0;
+	for (const name of className) {
+		if (typeof name !== "string" || !name.startsWith("hljs-")) continue;
+		const style = TOKEN_STYLES[name.slice(5)];
+		if (style) return style;
+	}
+}
+function styleEachLine(text, style) {
+	return text.split("\n").map((line) => line ? style(line) : line).join("\n");
+}
+function highlightLine(line, nextLine) {
+	const quote = line.match(QUOTE);
+	if (quote) {
+		const [whole, indent = ""] = quote;
+		const rest = line.slice(whole.length);
+		const gap = whole.endsWith(" ") ? " " : "";
+		return `${indent}${kleur.dim(">")}${gap}${highlightLine(rest, stripPrefix(nextLine, whole))}`;
+	}
+	const list = line.match(LIST);
+	if (list) {
+		const [whole, indent = "", marker = "", checkbox] = list;
+		const rest = line.slice(whole.length);
+		const box = checkbox ? `${kleur.bold(checkbox.trim())} ` : "";
+		return `${indent}${kleur.dim(marker)} ${box}${highlightLine(rest, void 0)}`;
+	}
+	if (HEADING.test(line)) return kleur.bold().cyan(line);
+	if (RULE.test(line)) return kleur.dim(line);
+	if (TABLE_SEPARATOR.test(line)) return kleur.dim(line);
+	if (TABLE_ROW.test(line)) return tableRow(line, nextLine !== void 0 && TABLE_SEPARATOR.test(nextLine));
+	const details = line.match(DETAILS_OPEN);
+	if (details) {
+		const [, indent = "", title = ""] = details;
+		return `${indent}${kleur.dim("<details><summary>")}${highlightInline(title)}${kleur.dim("</summary>")}`;
+	}
+	if (DETAILS_CLOSE.test(line)) return kleur.dim(line);
+	return highlightInline(line);
+}
+function stripPrefix(line, prefix) {
+	return line?.startsWith(prefix) ? line.slice(prefix.length) : void 0;
+}
+function tableRow(line, header) {
+	const styled = line.split(CELL_DIVIDER).slice(1, -1).map((cell) => header ? kleur.bold(highlightInline(cell)) : highlightInline(cell));
+	const pipe = kleur.dim("|");
+	return `${pipe}${styled.join(pipe)}${pipe}`;
+}
+function highlightInline(text) {
+	return text.replace(INLINE, (match, code, linkText, url, boldItalic, bold, italic, strike) => {
+		if (code !== void 0) return kleur.yellow(code);
+		if (linkText !== void 0 && url !== void 0) return link(linkText, url);
+		if (boldItalic !== void 0) return kleur.bold().italic(match);
+		if (bold !== void 0) return kleur.bold(`**${highlightInline(bold)}**`);
+		if (italic !== void 0) return kleur.italic(`*${highlightInline(italic)}*`);
+		if (strike !== void 0) return kleur.strikethrough(`~~${highlightInline(strike)}~~`);
+		return match;
+	});
+}
+function link(text, url) {
+	const open = kleur.dim("[");
+	const middle = kleur.dim("](");
+	return `${open}${highlightInline(text)}${middle}${kleur.dim().underline(url)}${kleur.dim(")")}`;
+}
+//#endregion
+//#region src/commands/view.ts
+function fieldLines(pairs) {
+	const kept = pairs.filter(([, value]) => value !== "");
+	const width = Math.max(...kept.map(([label]) => label.length)) + 1;
+	return kept.map(([label, value]) => `${kleur.dim(`${label}:`.padEnd(width))}  ${value}`);
+}
+function dateWithAge(iso, nowMs) {
+	if (!iso) return "";
+	return `${formatDateTime(iso).slice(0, 10)} (${relativeTime(iso, nowMs)})`;
+}
+function bodyLines(body) {
+	const md = adfToMarkdown(body);
+	return md ? ["", highlightMarkdown(md)] : [];
+}
+function commentSection(comments, allComments) {
+	if (comments.length === 0) return [];
+	const visible = allComments ? comments : comments.slice(-5);
+	const heading = comments.length - visible.length > 0 ? `Comments (${comments.length}, showing last ${visible.length} — --all-comments for all)` : `Comments (${comments.length})`;
+	const lines = ["", kleur.bold(heading)];
+	for (const comment of visible) {
+		const body = adfToMarkdown(comment.body);
+		lines.push("", commentHeader(comment), ...body ? [highlightMarkdown(body)] : []);
+	}
+	return lines;
+}
+function commentHeader(comment) {
+	return `─ ${kleur.bold(comment.author || "Unknown")}${comment.created ? ` · ${kleur.dim(formatDateTime(comment.created))}` : ""}`;
+}
+function attachmentSection(attachments) {
+	if (attachments.length === 0) return [];
+	return [
+		"",
+		kleur.bold("Attachments"),
+		...attachments.map((a) => `- ${a.filename}`)
+	];
+}
+//#endregion
 //#region src/api/attachments.ts
 function mediaResolver(downloaded) {
 	const byMediaId = new Map(downloaded.map((d) => [d.mediaId, d.relativePath]));
@@ -1734,7 +1933,79 @@ async function runPlan(plan, options, push) {
 	await push();
 }
 //#endregion
+//#region src/util/pager.ts
+const DEFAULT_ROWS = 24;
+const DEFAULT_COLUMNS = 80;
+const DEFAULT_PAGER = "less";
+const DEFAULT_LESS = "FRX";
+function renderedHeight(text, columns) {
+	const width = Math.max(1, columns);
+	return text.split("\n").map((line) => Math.max(1, Math.ceil(stripVTControlCharacters(line).length / width))).reduce((sum, rows) => sum + rows, 0);
+}
+function shouldPage(text, term) {
+	if (!term.isTTY) return false;
+	const rows = term.rows ?? DEFAULT_ROWS;
+	return renderedHeight(text, term.columns ?? DEFAULT_COLUMNS) > rows;
+}
+function pagerCommand(env) {
+	const [command = DEFAULT_PAGER, ...args] = (env["PAGER"] ?? "").trim().split(/\s+/).filter(Boolean);
+	return {
+		command,
+		args,
+		env: {
+			...env,
+			LESS: env["LESS"] ?? DEFAULT_LESS
+		}
+	};
+}
+async function printPaged(text, options = {}) {
+	const term = options.term ?? process.stdout;
+	if (options.pager === false || !shouldPage(text, term)) {
+		console.log(text);
+		return;
+	}
+	if (!await pipeToPager(text, pagerCommand(options.env ?? process.env))) console.log(text);
+}
+function pipeToPager(text, pager) {
+	return new Promise((resolve) => {
+		const child = spawn(pager.command, pager.args, {
+			stdio: [
+				"pipe",
+				"inherit",
+				"inherit"
+			],
+			env: pager.env
+		});
+		child.once("error", () => resolve(false));
+		child.once("close", () => resolve(true));
+		child.stdin.once("error", () => {});
+		child.stdin.end(`${text}\n`);
+	});
+}
+//#endregion
 //#region src/commands/confluence.ts
+async function confluenceView(arg, options) {
+	const auth = await requireAuth();
+	const id = await resolveRef(arg, PAGE_REF);
+	await printPaged(formatPageView(await fetchPage(new AtlassianClient(auth), auth.site, id), Date.now(), options.allComments ?? false).join("\n"), { pager: options.pager });
+}
+function formatPageView(page, nowMs, allComments) {
+	return [
+		kleur.bold(page.title),
+		...fieldLines([
+			["Space", page.spaceKey],
+			["ID", page.id],
+			["Version", page.version ? String(page.version) : ""],
+			["Author", page.author],
+			["Created", dateWithAge(page.createdAt, nowMs)],
+			["Updated", dateWithAge(page.updatedAt, nowMs)],
+			["URL", page.url]
+		]),
+		...bodyLines(page.body),
+		...commentSection(page.comments, allComments),
+		...attachmentSection(page.attachments)
+	];
+}
 async function confluenceCopy(arg, options) {
 	const auth = await requireAuth();
 	const id = await resolveRef(arg, PAGE_REF);
@@ -1786,37 +2057,59 @@ async function fileSize(path) {
 }
 async function confluenceSearch(query, options) {
 	if (options.cql && (query || options.space)) throw new Error("--cql cannot be combined with a text query or --space.");
+	await listPages({
+		text: query,
+		space: options.space,
+		cql: options.cql
+	}, "No matching pages.", options);
+}
+async function confluenceList(options) {
+	await listPages({
+		starred: true,
+		space: options.space
+	}, options.space ? `No starred pages in ${options.space}.` : "No starred pages.", options);
+}
+async function listPages(filter, empty, options) {
 	if (options.json && options.copy) throw new Error("--json and --copy cannot be used together.");
 	const auth = await requireAuth();
 	const client = new AtlassianClient(auth);
 	const limit = parseLimit(options.limit);
 	const { pages, hasMore } = await searchPages(client, auth.site, {
-		text: query,
-		space: options.space,
-		cql: options.cql,
+		...filter,
 		limit
 	});
-	await runSearch(pages.map((p) => ({
-		id: p.id,
-		fixedColumns: `${p.id}  ${p.space}`,
-		freeText: p.title,
-		json: {
-			id: p.id,
-			space: p.space,
-			title: p.title,
-			url: p.url
-		}
-	})), {
+	await runSearch(formatPageRows(pages, Date.now()), {
 		json: options.json,
 		copy: options.copy,
 		out: options.out,
-		empty: "No matching pages.",
+		empty,
 		footer: hasMore ? searchFooter(limit) : void 0
-	}, {
-		singular: "page",
-		plural: "pages"
-	}, (id) => copyPage(client, auth.site, id, options.out));
+	}, PAGE_NOUN, (id) => copyPage(client, auth.site, id, options.out));
+}
+function formatPageRows(pages, nowMs) {
+	return alignedRows(pages, nowMs, (p) => ({
+		id: p.id,
+		label: p.space,
+		color: colorForSpace(p.space),
+		text: p.title
+	}));
 }
+const SPACE_COLORS = [
+	kleur.cyan,
+	kleur.yellow,
+	kleur.green,
+	kleur.magenta,
+	kleur.blue
+];
+function colorForSpace(space) {
+	let hash = 0;
+	for (const char of space) hash = hash * 31 + (char.codePointAt(0) ?? 0) >>> 0;
+	return SPACE_COLORS[hash % SPACE_COLORS.length] ?? kleur.cyan;
+}
+const PAGE_NOUN = {
+	singular: "page",
+	plural: "pages"
+};
 async function copyPage(client, site, id, out) {
 	console.log(`Fetching page ${id} ...`);
 	await runCopy(planPageCopy(await fetchPage(client, site, id), out), (url) => client.getBinary(url));
@@ -1830,8 +2123,10 @@ const PAGE_REF = {
 //#region src/cli/confluence.ts
 function registerConfluence(confluence) {
 	confluence.description("Confluence commands");
+	confluence.command("view [page]").description("Show a Confluence page (id or URL) in the terminal").option("--all-comments", "show all comments instead of the last 5").option("--no-pager", "print directly instead of paging long output").action(run(confluenceView));
 	confluence.command("copy [page]").description("Copy a Confluence page (id or URL) to a Markdown file").option("-o, --out <path>", "output file or directory").action(run(confluenceCopy));
 	confluence.command("update [file]").description("Update a Confluence page from an edited Markdown file").option("--title", "also push the H1 as the page title").option("-m, --message <text>", "version message (default 'Updated via atlass')").option("-f, --force", "skip the stale-version and data-loss checks").option("--dry-run", "show what would change without writing").action(run(confluenceUpdate));
+	confluence.command("list").description("List pages you starred").option("-s, --space <key>", "limit to a space").option("-l, --limit <n>", "max results (default 25, max 100)").option("--json", "output results as JSON").option("-c, --copy", "pick results to copy to Markdown").option("-o, --out <dir>", "output directory for --copy").action(run(confluenceList));
 	confluence.command("search [query]").description("Search Confluence pages (text query, --space, or --cql)").option("-s, --space <key>", "limit to a space").option("--cql <cql>", "raw CQL query (ignores other filters)").option("-l, --limit <n>", "max results (default 25, max 100)").option("--json", "output results as JSON").option("-c, --copy", "pick results to copy to Markdown").option("-o, --out <dir>", "output directory for --copy").action(run(confluenceSearch));
 	return confluence;
 }
@@ -2034,148 +2329,6 @@ async function fetchComments(client, key) {
 	}));
 }
 //#endregion
-//#region src/markdown/highlight.ts
-const HEADING = /^#{1,6} /;
-const QUOTE = /^(\s*)>( |$)/;
-const LIST = /^(\s*)(-|\d+\.) (\[[ x]\] )?/;
-const RULE = /^\s*---$/;
-const TABLE_ROW = /^\|.*\|$/;
-const TABLE_SEPARATOR = /^\|( --- \|)+$/;
-const CELL_DIVIDER = /(?<!\\)\|/;
-const DETAILS_OPEN = /^(\s*)<details><summary>(.*)<\/summary>$/;
-const DETAILS_CLOSE = /^\s*<\/details>$/;
-const FENCE_OPEN = /^((?:\s|> |- |\d+\. )*)```(\S*)$/;
-const FENCE = "```";
-const INLINE = /(`[^`]+`)|\[([^\]]+)\]\(((?:[^()]|\([^()]*\))+)\)|\*\*\*(.+?)\*\*\*|\*\*(.+?)\*\*|\*(?!\*)(.+?)(?<!\*)\*(?!\*)|~~(.+?)~~/g;
-const TOKEN_STYLES = {
-	keyword: kleur.magenta,
-	built_in: kleur.magenta,
-	literal: kleur.magenta,
-	string: kleur.green,
-	regexp: kleur.green,
-	addition: kleur.green,
-	number: kleur.yellow,
-	symbol: kleur.yellow,
-	meta: kleur.yellow,
-	attr: kleur.yellow,
-	comment: kleur.dim,
-	quote: kleur.dim,
-	deletion: kleur.dim,
-	title: kleur.cyan,
-	type: kleur.cyan,
-	section: kleur.cyan
-};
-const lowlight = createLowlight(common);
-function highlightMarkdown(md) {
-	const lines = md.split("\n");
-	const out = [];
-	for (let i = 0; i < lines.length; i++) {
-		const line = lines[i] ?? "";
-		const fence = line.match(FENCE_OPEN);
-		if (!fence) {
-			out.push(highlightLine(line, lines[i + 1]));
-			continue;
-		}
-		const [, prefix = "", lang = ""] = fence;
-		const styledPrefix = prefix.replace(/\S+/g, (marker) => kleur.dim(marker));
-		out.push(`${styledPrefix}${kleur.dim(`${FENCE}${lang}`)}`);
-		const code = [];
-		const prefixed = [];
-		let j = i + 1;
-		for (; j < lines.length; j++) {
-			const raw = lines[j] ?? "";
-			const hasPrefix = raw.startsWith(prefix) || raw === prefix.trimEnd();
-			const body = raw.startsWith(prefix) ? raw.slice(prefix.length) : hasPrefix ? "" : raw;
-			if (body === FENCE) break;
-			code.push(body);
-			prefixed.push(hasPrefix);
-		}
-		if (code.length > 0) highlightCode(code.join("\n"), lang).split("\n").forEach((codeLine, k) => {
-			const lead = prefixed[k] ? styledPrefix : "";
-			out.push(codeLine ? `${lead}${codeLine}` : lead.trimEnd());
-		});
-		if (j < lines.length) {
-			const lead = (lines[j] ?? "").startsWith(prefix) ? styledPrefix : "";
-			out.push(`${lead}${kleur.dim(FENCE)}`);
-		}
-		i = j;
-	}
-	return out.join("\n");
-}
-function highlightCode(code, lang) {
-	if (!lang || !lowlight.registered(lang)) return styleEachLine(code, kleur.yellow);
-	return renderTree(lowlight.highlight(lang, code), (text) => text);
-}
-function renderTree(node, style) {
-	if (node.type === "text") return styleEachLine(node.value, style);
-	if (node.type !== "root" && node.type !== "element") return "";
-	const own = node.type === "element" ? tokenStyle(node.properties["className"]) : void 0;
-	const next = own ? (text) => style(own(text)) : style;
-	return node.children.map((child) => renderTree(child, next)).join("");
-}
-function tokenStyle(className) {
-	if (!Array.isArray(className)) return void 0;
-	for (const name of className) {
-		if (typeof name !== "string" || !name.startsWith("hljs-")) continue;
-		const style = TOKEN_STYLES[name.slice(5)];
-		if (style) return style;
-	}
-}
-function styleEachLine(text, style) {
-	return text.split("\n").map((line) => line ? style(line) : line).join("\n");
-}
-function highlightLine(line, nextLine) {
-	const quote = line.match(QUOTE);
-	if (quote) {
-		const [whole, indent = ""] = quote;
-		const rest = line.slice(whole.length);
-		const gap = whole.endsWith(" ") ? " " : "";
-		return `${indent}${kleur.dim(">")}${gap}${highlightLine(rest, stripPrefix(nextLine, whole))}`;
-	}
-	const list = line.match(LIST);
-	if (list) {
-		const [whole, indent = "", marker = "", checkbox] = list;
-		const rest = line.slice(whole.length);
-		const box = checkbox ? `${kleur.bold(checkbox.trim())} ` : "";
-		return `${indent}${kleur.dim(marker)} ${box}${highlightLine(rest, void 0)}`;
-	}
-	if (HEADING.test(line)) return kleur.bold().cyan(line);
-	if (RULE.test(line)) return kleur.dim(line);
-	if (TABLE_SEPARATOR.test(line)) return kleur.dim(line);
-	if (TABLE_ROW.test(line)) return tableRow(line, nextLine !== void 0 && TABLE_SEPARATOR.test(nextLine));
-	const details = line.match(DETAILS_OPEN);
-	if (details) {
-		const [, indent = "", title = ""] = details;
-		return `${indent}${kleur.dim("<details><summary>")}${highlightInline(title)}${kleur.dim("</summary>")}`;
-	}
-	if (DETAILS_CLOSE.test(line)) return kleur.dim(line);
-	return highlightInline(line);
-}
-function stripPrefix(line, prefix) {
-	return line?.startsWith(prefix) ? line.slice(prefix.length) : void 0;
-}
-function tableRow(line, header) {
-	const styled = line.split(CELL_DIVIDER).slice(1, -1).map((cell) => header ? kleur.bold(highlightInline(cell)) : highlightInline(cell));
-	const pipe = kleur.dim("|");
-	return `${pipe}${styled.join(pipe)}${pipe}`;
-}
-function highlightInline(text) {
-	return text.replace(INLINE, (match, code, linkText, url, boldItalic, bold, italic, strike) => {
-		if (code !== void 0) return kleur.yellow(code);
-		if (linkText !== void 0 && url !== void 0) return link(linkText, url);
-		if (boldItalic !== void 0) return kleur.bold().italic(match);
-		if (bold !== void 0) return kleur.bold(`**${highlightInline(bold)}**`);
-		if (italic !== void 0) return kleur.italic(`*${highlightInline(italic)}*`);
-		if (strike !== void 0) return kleur.strikethrough(`~~${highlightInline(strike)}~~`);
-		return match;
-	});
-}
-function link(text, url) {
-	const open = kleur.dim("[");
-	const middle = kleur.dim("](");
-	return `${open}${highlightInline(text)}${middle}${kleur.dim().underline(url)}${kleur.dim(")")}`;
-}
-//#endregion
 //#region src/commands/jira.ts
 async function jiraProjects(query, options) {
 	const auth = await requireAuth();
@@ -2217,8 +2370,7 @@ function formatStatusRows(statuses) {
 async function jiraView(arg, options) {
 	const auth = await requireAuth();
 	const key = await resolveRef(arg, ISSUE_REF);
-	const issue = await fetchIssue(new AtlassianClient(auth), auth.site, key);
-	for (const line of formatIssueView(issue, Date.now(), options.allComments ?? false)) console.log(line);
+	await printPaged(formatIssueView(await fetchIssue(new AtlassianClient(auth), auth.site, key), Date.now(), options.allComments ?? false).join("\n"), { pager: options.pager });
 }
 const CATEGORY_COLORS = {
 	new: kleur.cyan,
@@ -2229,59 +2381,25 @@ function colorForCategory(category) {
 	return CATEGORY_COLORS[category] ?? ((text) => text);
 }
 function formatIssueView(issue, nowMs, allComments) {
+	const colorStatus = colorForCategory(issue.statusCategory);
 	return [
 		`${kleur.bold(issue.key)}  ${issue.summary}`,
-		...fieldLines(issue, nowMs),
-		...bodyLines(adfToMarkdown(issue.description)),
+		...fieldLines([
+			["Type", issue.type],
+			["Status", issue.status && colorStatus(issue.status)],
+			["Assignee", issue.assignee],
+			["Reporter", issue.reporter],
+			["Priority", issue.priority],
+			["Labels", issue.labels.join(", ")],
+			["Created", dateWithAge(issue.created, nowMs)],
+			["Updated", dateWithAge(issue.updated, nowMs)],
+			["URL", issue.url]
+		]),
+		...bodyLines(issue.description),
 		...commentSection(issue.comments, allComments),
 		...attachmentSection(issue.attachments)
 	];
 }
-function fieldLines(issue, nowMs) {
-	const colorStatus = colorForCategory(issue.statusCategory);
-	const kept = [
-		["Type", issue.type],
-		["Status", issue.status && colorStatus(issue.status)],
-		["Assignee", issue.assignee],
-		["Reporter", issue.reporter],
-		["Priority", issue.priority],
-		["Labels", issue.labels.join(", ")],
-		["Created", dateWithAge(issue.created, nowMs)],
-		["Updated", dateWithAge(issue.updated, nowMs)],
-		["URL", issue.url]
-	].filter(([, value]) => value !== "");
-	const width = Math.max(...kept.map(([label]) => label.length)) + 1;
-	return kept.map(([label, value]) => `${kleur.dim(`${label}:`.padEnd(width))}  ${value}`);
-}
-function dateWithAge(iso, nowMs) {
-	if (!iso) return "";
-	return `${formatDateTime(iso).slice(0, 10)} (${relativeTime(iso, nowMs)})`;
-}
-function bodyLines(body) {
-	return body ? ["", highlightMarkdown(body)] : [];
-}
-function commentSection(comments, allComments) {
-	if (comments.length === 0) return [];
-	const visible = allComments ? comments : comments.slice(-5);
-	const heading = comments.length - visible.length > 0 ? `Comments (${comments.length}, showing last ${visible.length} — --all-comments for all)` : `Comments (${comments.length})`;
-	const lines = ["", kleur.bold(heading)];
-	for (const comment of visible) {
-		const body = adfToMarkdown(comment.body);
-		lines.push("", commentHeader(comment), ...body ? [highlightMarkdown(body)] : []);
-	}
-	return lines;
-}
-function commentHeader(comment) {
-	return `─ ${kleur.bold(comment.author || "Unknown")}${comment.created ? ` · ${kleur.dim(formatDateTime(comment.created))}` : ""}`;
-}
-function attachmentSection(attachments) {
-	if (attachments.length === 0) return [];
-	return [
-		"",
-		kleur.bold("Attachments"),
-		...attachments.map((a) => `- ${a.filename}`)
-	];
-}
 async function jiraCopy(arg, options) {
 	const auth = await requireAuth();
 	const key = await resolveRef(arg, ISSUE_REF);
@@ -2318,17 +2436,7 @@ async function jiraSearch(query, options) {
 		jql: options.jql,
 		limit
 	});
-	await runSearch(issues.map((i) => ({
-		id: i.key,
-		fixedColumns: `${i.key}  ${i.status}`,
-		freeText: i.summary,
-		json: {
-			key: i.key,
-			status: i.status,
-			summary: i.summary,
-			url: i.url
-		}
-	})), {
+	await runSearch(formatIssueRows(issues, Date.now()), {
 		json: options.json,
 		copy: options.copy,
 		out: options.out,
@@ -2344,7 +2452,7 @@ async function jiraList(options) {
 		all: options.all,
 		project: options.project
 	});
-	await runSearch(formatListRows(sortByCategoryThenUpdated(issues), Date.now()), {
+	await runSearch(formatIssueRows(sortByCategoryThenUpdated(issues), Date.now()), {
 		json: options.json,
 		copy: options.copy,
 		out: options.out,
@@ -2352,21 +2460,13 @@ async function jiraList(options) {
 		footer: truncated ? `\nShowing the first ${issues.length}; narrow with --project.` : void 0
 	}, ISSUE_NOUN, (key) => copyIssue(client, auth.site, key, options.out));
 }
-function formatListRows(issues, nowMs) {
-	const ages = issues.map((i) => relativeTime(i.updated, nowMs));
-	const width = (values) => Math.max(...values.map((v) => v.length));
-	const keyWidth = width(issues.map((i) => i.key));
-	const statusWidth = width(issues.map((i) => i.status));
-	const ageWidth = width(ages);
-	return issues.map((i, n) => {
-		const status = colorForCategory(i.statusCategory)(i.status.padEnd(statusWidth));
-		return {
-			id: i.key,
-			fixedColumns: `${i.key.padEnd(keyWidth)}  ${status}  ${(ages[n] ?? "").padEnd(ageWidth)}`,
-			freeText: i.summary,
-			json: { ...i }
-		};
-	});
+function formatIssueRows(issues, nowMs) {
+	return alignedRows(issues, nowMs, (i) => ({
+		id: i.key,
+		label: i.status,
+		color: colorForCategory(i.statusCategory),
+		text: i.summary
+	}));
 }
 const ISSUE_NOUN = {
 	singular: "issue",
@@ -2387,7 +2487,7 @@ function registerJira(jira) {
 	jira.description("Jira commands");
 	jira.command("projects [query]").description("List projects (optionally filtered by key or name)").option("--json", "output results as JSON").action(run(jiraProjects));
 	jira.command("statuses [query]").description("List statuses (optionally filtered by name, scoped with --project)").option("-p, --project <key>", "limit to statuses used by a project").option("--json", "output results as JSON").action(run(jiraStatuses));
-	jira.command("view [issue]").description("Show a Jira issue (key or URL) in the terminal").option("--all-comments", "show all comments instead of the last 5").action(run(jiraView));
+	jira.command("view [issue]").description("Show a Jira issue (key or URL) in the terminal").option("--all-comments", "show all comments instead of the last 5").option("--no-pager", "print directly instead of paging long output").action(run(jiraView));
 	jira.command("copy [issue]").description("Copy a Jira issue (key or URL) to a Markdown file").option("-o, --out <path>", "output file or directory").action(run(jiraCopy));
 	jira.command("update [file]").description("Update a Jira issue description from an edited Markdown file").option("--summary", "also push the H1 as the issue summary").option("-f, --force", "skip the stale-issue and data-loss checks").option("--dry-run", "show what would change without writing").action(run(jiraUpdate));
 	jira.command("list").description("List open issues assigned to you").option("-p, --project <key>", "limit to a project").option("-a, --all", "include Done issues updated in the last 30 days").option("--json", "output results as JSON").option("-c, --copy", "pick results to copy to Markdown").option("-o, --out <dir>", "output directory for --copy").action(run(jiraList));
@@ -2396,7 +2496,7 @@ function registerJira(jira) {
 }
 //#endregion
 //#region package.json
-var version = "1.9.0";
+var version = "1.10.0";
 //#endregion
 //#region src/cli/build.ts
 const PRODUCTS = {

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as fail, t as buildAtlass } from "./build-DhED0Zw_.mjs";
+import { r as fail, t as buildAtlass } from "./build-Colq1d4N.mjs";
 //#region src/cli.ts
 buildAtlass().parseAsync().catch(fail);
 //#endregion

package/dist/confluence.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as buildStandalone, r as fail } from "./build-DhED0Zw_.mjs";
+import { n as buildStandalone, r as fail } from "./build-Colq1d4N.mjs";
 //#region src/confluence.ts
 buildStandalone("confluence").parseAsync().catch(fail);
 //#endregion

package/dist/jira.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as buildStandalone, r as fail } from "./build-DhED0Zw_.mjs";
+import { n as buildStandalone, r as fail } from "./build-Colq1d4N.mjs";
 //#region src/jira.ts
 buildStandalone("jira").parseAsync().catch(fail);
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "atlass",
-	"version": "1.9.0",
+	"version": "1.10.0",
 	"description": "CLI to copy Jira issues and Confluence pages to Markdown, and update Confluence pages.",
 	"license": "MIT",
 	"repository": {