atlass 1.6.0 → 1.8.0

package/dist/cli.mjs

@@ -7,10 +7,11 @@ import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { Entry } from "@napi-rs/keyring";
 import { marked } from "marked";
 import { randomUUID } from "node:crypto";
-//#region package.json
-var version = "1.6.0";
-//#endregion
+import { stripVTControlCharacters } from "node:util";
+import kleur from "kleur";
+import { common, createLowlight } from "lowlight";
 //#region src/api/client.ts
+const DISABLE_XSRF_CHECK = { "X-Atlassian-Token": "nocheck" };
 var AtlassianClient = class {
 	site;
 	authHeader;
@@ -47,7 +48,7 @@ var AtlassianClient = class {
 			body: JSON.stringify(body)
 		})).json();
 	}
-	async put(path, body) {
+	async putNoContent(path, body) {
 		await this.request(path, {
 			method: "PUT",
 			headers: {
@@ -65,17 +66,21 @@ var AtlassianClient = class {
 			method: "POST",
 			headers: {
 				Accept: "application/json",
-				"X-Atlassian-Token": "nocheck"
+				...DISABLE_XSRF_CHECK
 			},
 			body: form
 		})).json();
 	}
-	async getBinary(url) {
-		const path = url.startsWith("http") ? new URL(url).pathname + new URL(url).search : url;
+	async getBinary(urlOrPath) {
+		const path = urlOrPath.startsWith("http") ? pathAndQuery(urlOrPath) : urlOrPath;
 		const res = await this.request(path, { headers: { Accept: "*/*" } });
 		return new Uint8Array(await res.arrayBuffer());
 	}
 };
+function pathAndQuery(absoluteUrl) {
+	const u = new URL(absoluteUrl);
+	return u.pathname + u.search;
+}
 var HttpError = class extends Error {
 	status;
 	constructor(status, message) {
@@ -87,21 +92,26 @@ var HttpError = class extends Error {
 function httpError(status, path, body = "") {
 	if (status === 401 || status === 403) return new HttpError(status, "Authentication failed (401/403). Run `atlass auth login` to update your token.");
 	if (status === 404) return new HttpError(status, `Not found (404): ${path}`);
-	if (status === 409) return new HttpError(status, `Conflict (409): ${extractError(body) || "the page changed on the server"}`);
+	if (status === 409) return new HttpError(status, `Conflict (409): ${extractErrorMessage(body) || "the page changed on the server"}`);
 	if (status === 413) return new HttpError(status, "Payload too large (413): the page or an attachment exceeds the size limit.");
-	if (status === 400) return new HttpError(status, `Bad request (400): ${extractError(body) || path}`);
-	return new HttpError(status, `Request failed (${status}): ${extractError(body) || path}`);
+	if (status === 400) return new HttpError(status, `Bad request (400): ${extractErrorMessage(body) || path}`);
+	return new HttpError(status, `Request failed (${status}): ${extractErrorMessage(body) || path}`);
 }
-function extractError(body) {
+function extractErrorMessage(body) {
 	if (!body) return "";
-	try {
-		const json = JSON.parse(body);
-		if (json.errorMessages?.length) return json.errorMessages.join("; ");
-		if (json.message) return json.message;
-		if (json.error?.message) return json.error.message;
-	} catch {}
+	const json = tryParseJson(body);
+	if (json?.errorMessages?.length) return json.errorMessages.join("; ");
+	if (json?.message) return json.message;
+	if (json?.error?.message) return json.error.message;
 	return body.slice(0, 300);
 }
+function tryParseJson(text) {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return null;
+	}
+}
 //#endregion
 //#region src/config.ts
 function configDir() {
@@ -130,7 +140,7 @@ async function writeConfig(config) {
 async function clearConfig() {
 	await rm(configPath(), { force: true });
 }
-function normalizeSite(input) {
+function siteOrigin(input) {
 	let value = input.trim();
 	if (!/^https?:\/\//i.test(value)) value = `https://${value}`;
 	return new URL(value).origin;
@@ -142,6 +152,13 @@ const BITBUCKET_ORIGIN = "https://api.bitbucket.org";
 function entry(key) {
 	return new Entry(SERVICE, key);
 }
+function deleteEntryIfPresent(key) {
+	try {
+		entry(key).deleteCredential();
+	} catch {
+		return;
+	}
+}
 function saveToken(email, token) {
 	entry(email).setPassword(token);
 }
@@ -149,9 +166,7 @@ function readToken(email) {
 	return entry(email).getPassword();
 }
 function deleteToken(email) {
-	try {
-		entry(email).deleteCredential();
-	} catch {}
+	deleteEntryIfPresent(email);
 }
 function bitbucketKey(email) {
 	return `${email}:bitbucket`;
@@ -163,9 +178,7 @@ function readBitbucketToken(email) {
 	return entry(bitbucketKey(email)).getPassword();
 }
 function deleteBitbucketToken(email) {
-	try {
-		entry(bitbucketKey(email)).deleteCredential();
-	} catch {}
+	deleteEntryIfPresent(bitbucketKey(email));
 }
 async function requireAuth() {
 	const config = await readConfig();
@@ -194,7 +207,7 @@ async function requireBitbucketAuth() {
 //#endregion
 //#region src/commands/auth.ts
 async function login() {
-	const site = normalizeSite(await input({
+	const site = siteOrigin(await input({
 		message: "Atlassian site (e.g. acme.atlassian.net):",
 		required: true
 	}));
@@ -222,10 +235,11 @@ async function login() {
 async function logout() {
 	const config = await readConfig();
 	if (config?.email) deleteToken(config.email);
-	if (config?.bitbucket && config.email) await writeConfig({
+	const bitbucketLogin = config?.bitbucket && config.email ? {
 		email: config.email,
 		bitbucket: config.bitbucket
-	});
+	} : null;
+	if (bitbucketLogin) await writeConfig(bitbucketLogin);
 	else await clearConfig();
 	console.log("Logged out. Credentials removed.");
 }
@@ -242,6 +256,8 @@ async function status() {
 }
 //#endregion
 //#region src/api/bitbucket.ts
+const BITBUCKET_MAX_PAGELEN = 100;
+const BUILD_NUMBER_SCAN_LIMIT = 1e3;
 function pipelineStatus(state) {
 	if (!state) return "";
 	if (state.name === "COMPLETED") return state.result?.name ?? "COMPLETED";
@@ -250,88 +266,91 @@ function pipelineStatus(state) {
 function pipelinesQuery(limit) {
 	return new URLSearchParams({
 		sort: "-created_on",
-		pagelen: String(Math.min(Math.max(limit, 1), 100))
+		pagelen: String(Math.min(Math.max(limit, 1), BITBUCKET_MAX_PAGELEN))
 	}).toString();
 }
-function elapsedSeconds(startOn, endOn) {
+function wallClockSeconds(startOn, endOn) {
 	if (!startOn || !endOn) return null;
 	const start = Date.parse(startOn);
 	const end = Date.parse(endOn);
 	if (Number.isNaN(start) || Number.isNaN(end)) return null;
 	return Math.floor((end - start) / 1e3);
 }
-const MAX_SCAN = 1e3;
-function repoPath(ref) {
-	return `/2.0/repositories/${encodeURIComponent(ref.workspace)}/${encodeURIComponent(ref.repo)}/pipelines`;
-}
-function toPath(url) {
-	const u = new URL(url);
-	return u.pathname + u.search;
-}
-async function* paginate(client, firstPath) {
-	let path = firstPath;
-	while (path) {
-		const page = await client.getJson(path);
-		for (const value of page.values ?? []) yield value;
-		path = page.next ? toPath(page.next) : null;
-	}
+function shortHash(hash) {
+	return hash?.slice(0, 7) ?? "";
 }
-function mapPipeline(p) {
+function toPipelineSummary(p) {
 	return {
 		buildNumber: p.build_number,
 		status: pipelineStatus(p.state),
 		ref: p.target?.ref_name ?? "",
-		commit: p.target?.commit?.hash?.slice(0, 7) ?? "",
-		durationSeconds: elapsedSeconds(p.created_on, p.completed_on),
+		commit: shortHash(p.target?.commit?.hash),
+		durationSeconds: wallClockSeconds(p.created_on, p.completed_on),
 		createdOn: p.created_on ?? "",
 		creator: p.creator?.display_name ?? "",
 		uuid: p.uuid
 	};
 }
-function mapDetail(p) {
+function toPipelineDetail(p) {
 	return {
-		...mapPipeline(p),
+		...toPipelineSummary(p),
 		repo: p.repository?.full_name ?? "",
 		trigger: p.trigger?.name ?? ""
 	};
 }
+function toStepSummary(step) {
+	return {
+		name: step.name ?? "",
+		status: pipelineStatus(step.state),
+		durationSeconds: wallClockSeconds(step.started_on, step.completed_on)
+	};
+}
+function repoPath(ref) {
+	return `/2.0/repositories/${encodeURIComponent(ref.workspace)}/${encodeURIComponent(ref.repo)}/pipelines`;
+}
+async function* walkPages(client, firstPath) {
+	let path = firstPath;
+	while (path) {
+		const page = await client.getJson(path);
+		for (const value of page.values ?? []) yield value;
+		path = page.next ? pathAndQuery(page.next) : null;
+	}
+}
 async function listPipelines(client, ref, limit) {
 	const out = [];
 	const first = `${repoPath(ref)}?${pipelinesQuery(limit)}`;
-	for await (const value of paginate(client, first)) {
-		out.push(mapPipeline(value));
+	for await (const value of walkPages(client, first)) {
+		out.push(toPipelineSummary(value));
 		if (out.length >= limit) break;
 	}
 	return out;
 }
 async function getPipeline(client, ref, buildNumber) {
-	const base = repoPath(ref);
+	const found = await fetchByBuildNumber(client, ref, buildNumber) ?? await findInRecentRuns(client, ref, buildNumber);
+	if (!found) throw new Error(`Could not find pipeline #${buildNumber} in the ${BUILD_NUMBER_SCAN_LIMIT} most recent runs. It may be too old.`);
+	return toPipelineDetail(found);
+}
+async function fetchByBuildNumber(client, ref, buildNumber) {
 	try {
-		return mapDetail(await client.getJson(`${base}/${encodeURIComponent(String(buildNumber))}`));
+		return await client.getJson(`${repoPath(ref)}/${encodeURIComponent(String(buildNumber))}`);
 	} catch (err) {
-		if (!(err instanceof HttpError) || err.status !== 400 && err.status !== 404) throw err;
+		if (err instanceof HttpError && (err.status === 400 || err.status === 404)) return null;
+		throw err;
 	}
-	const found = await scanForBuild(client, ref, buildNumber);
-	if (!found) throw new Error(`Could not find pipeline #${buildNumber} in the ${MAX_SCAN} most recent runs. It may be too old.`);
-	return mapDetail(found);
 }
-async function scanForBuild(client, ref, buildNumber) {
-	const first = `${repoPath(ref)}?${pipelinesQuery(100)}`;
+async function findInRecentRuns(client, ref, buildNumber) {
+	const first = `${repoPath(ref)}?${pipelinesQuery(BITBUCKET_MAX_PAGELEN)}`;
 	let scanned = 0;
-	for await (const pipeline of paginate(client, first)) {
+	for await (const pipeline of walkPages(client, first)) {
 		if (pipeline.build_number === buildNumber) return pipeline;
-		if (++scanned >= MAX_SCAN) break;
+		if (++scanned >= BUILD_NUMBER_SCAN_LIMIT) break;
 	}
 	return null;
 }
 async function listSteps(client, ref, pipelineId) {
 	const out = [];
 	const first = `${repoPath(ref)}/${encodeURIComponent(pipelineId)}/steps`;
-	for await (const step of paginate(client, first)) out.push({
-		name: step.name ?? "",
-		status: pipelineStatus(step.state),
-		durationSeconds: elapsedSeconds(step.started_on, step.completed_on)
-	});
+	for await (const step of walkPages(client, first)) out.push(toStepSummary(step));
 	return out;
 }
 //#endregion
@@ -344,6 +363,11 @@ function formatDuration(seconds) {
 	if (m < 60) return `${m}m${String(s).padStart(2, "0")}s`;
 	return `${Math.floor(m / 60)}h${String(m % 60).padStart(2, "0")}m`;
 }
+function formatDateTime(iso) {
+	const date = new Date(iso);
+	if (Number.isNaN(date.getTime())) return iso;
+	return date.toISOString().replace("T", " ").slice(0, 16);
+}
 const MINUTE = 60;
 const HOUR = 60 * MINUTE;
 const DAY = 24 * HOUR;
@@ -375,6 +399,9 @@ function parsePageId(input) {
 	if (fromQuery) return fromQuery[1];
 	return null;
 }
+function isExternalHref(href) {
+	return /^[a-z][a-z0-9+.-]*:\/\//i.test(href);
+}
 function resolveRepo(flag, config) {
 	if (flag) {
 		if (flag.includes("/")) {
@@ -398,11 +425,13 @@ function resolveRepo(flag, config) {
 	};
 	throw new Error(`No repo given. Pass --repo workspace/slug (or a bare slug), or set a default repo at \`atlass bitbucket login\`.`);
 }
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 100;
 function parseLimit(value) {
-	if (!value) return 25;
+	if (!value) return DEFAULT_LIMIT;
 	const n = Number.parseInt(value, 10);
 	if (!Number.isFinite(n) || n < 1) throw new Error(`Invalid --limit "${value}".`);
-	return Math.min(n, 100);
+	return Math.min(n, MAX_LIMIT);
 }
 //#endregion
 //#region src/commands/bitbucket.ts
@@ -440,10 +469,11 @@ async function bitbucketLogin() {
 async function bitbucketLogout() {
 	const config = await readConfig();
 	if (config?.email) deleteBitbucketToken(config.email);
-	if (config?.site && config.email) await writeConfig({
+	const jiraLogin = config?.site && config.email ? {
 		site: config.site,
 		email: config.email
-	});
+	} : null;
+	if (jiraLogin) await writeConfig(jiraLogin);
 	else await clearConfig();
 	console.log("Logged out of Bitbucket. Credentials removed.");
 }
@@ -513,8 +543,7 @@ function formatStepRows(steps) {
 function printPipelineDetail(detail, steps, nowMs) {
 	console.log(`Pipeline #${detail.buildNumber}  ${detail.status || "-"}`);
 	if (detail.repo) console.log(`Repo:     ${detail.repo}`);
-	const refLine = detail.ref ? detail.commit ? `${detail.ref} (${detail.commit})` : detail.ref : detail.commit || "-";
-	console.log(`Ref:      ${refLine}`);
+	console.log(`Ref:      ${refWithCommit(detail)}`);
 	if (detail.trigger) console.log(`Trigger:  ${detail.trigger}`);
 	console.log(`Duration: ${formatDuration(detail.durationSeconds)}`);
 	const by = detail.creator ? ` by ${detail.creator}` : "";
@@ -525,6 +554,10 @@ function printPipelineDetail(detail, steps, nowMs) {
 		for (const line of formatStepRows(steps)) console.log(line);
 	}
 }
+function refWithCommit(detail) {
+	if (!detail.ref) return detail.commit || "-";
+	return detail.commit ? `${detail.ref} (${detail.commit})` : detail.ref;
+}
 async function verifyWorkspace(client, workspace) {
 	try {
 		return await client.getJson(`/2.0/workspaces/${encodeURIComponent(workspace)}`);
@@ -549,8 +582,27 @@ async function withScopeHint(fn) {
 }
 //#endregion
 //#region src/adf/from-markdown.ts
+function mediaNode(source, alt) {
+	const attrs = { ...source };
+	if (alt) attrs["alt"] = alt;
+	return {
+		type: "mediaSingle",
+		attrs: { layout: "center" },
+		content: [{
+			type: "media",
+			attrs
+		}]
+	};
+}
+function imageHrefs(md) {
+	const hrefs = /* @__PURE__ */ new Set();
+	marked.walkTokens(marked.lexer(md), (token) => {
+		if (token.type === "image") hrefs.add(token.href);
+	});
+	return [...hrefs];
+}
 function markdownToAdf(md, options = {}) {
-	const ctx = { resolveImage: options.resolveImage ?? defaultResolveImage };
+	const ctx = { resolveImage: options.resolveImage ?? externalMedia };
 	return {
 		type: "doc",
 		version: 1,
@@ -570,8 +622,8 @@ function block(token, ctx) {
 			attrs: { level: clampLevel$1(token.depth) },
 			content: inline(token.tokens ?? [], ctx)
 		}];
-		case "paragraph": return paragraph(token.tokens ?? [], ctx);
-		case "text": return paragraph(token.tokens ?? [textToken(token.text)], ctx);
+		case "paragraph": return paragraphsSplitAtImages(token.tokens ?? [], ctx);
+		case "text": return paragraphsSplitAtImages(token.tokens ?? [textToken(token.text)], ctx);
 		case "list": return [list(token, ctx)];
 		case "code": return [codeBlock(token)];
 		case "blockquote": return [{
@@ -580,11 +632,10 @@ function block(token, ctx) {
 		}];
 		case "table": return [table(token, ctx)];
 		case "hr": return [{ type: "rule" }];
-		case "html": return [];
 		default: return [];
 	}
 }
-function paragraph(tokens, ctx) {
+function paragraphsSplitAtImages(tokens, ctx) {
 	const out = [];
 	let buffer = [];
 	const flush = () => {
@@ -615,7 +666,7 @@ function list(token, ctx) {
 				localId: randomUUID(),
 				state: item.checked ? "DONE" : "TODO"
 			},
-			content: inline(itemInline(item), ctx)
+			content: inline(taskItemInline(item), ctx)
 		}))
 	};
 	const node = {
@@ -628,16 +679,18 @@ function list(token, ctx) {
 }
 function listItem(item, ctx) {
 	const children = blocks(item.tokens.filter((t) => t.type !== "checkbox"), ctx);
-	if (children.length === 0) children.push({
-		type: "paragraph",
-		content: []
-	});
 	return {
 		type: "listItem",
-		content: children
+		content: children.length > 0 ? children : [emptyParagraph()]
+	};
+}
+function emptyParagraph() {
+	return {
+		type: "paragraph",
+		content: []
 	};
 }
-function itemInline(item) {
+function taskItemInline(item) {
 	const first = item.tokens.find((t) => t.type === "text");
 	if (first && "tokens" in first && first.tokens) return first.tokens;
 	return [textToken(item.text)];
@@ -686,13 +739,13 @@ function inlineNode(token, ctx, marks) {
 			if ("tokens" in t && t.tokens?.length) return inline(t.tokens, ctx, marks);
 			return textNode(t.text, marks);
 		}
-		case "strong": return inline(token.tokens, ctx, withMark(marks, { type: "strong" }));
-		case "em": return inline(token.tokens, ctx, withMark(marks, { type: "em" }));
-		case "del": return inline(token.tokens, ctx, withMark(marks, { type: "strike" }));
-		case "codespan": return textNode(token.text, withMark(marks, { type: "code" }));
+		case "strong": return inline(token.tokens, ctx, withUniqueMark(marks, { type: "strong" }));
+		case "em": return inline(token.tokens, ctx, withUniqueMark(marks, { type: "em" }));
+		case "del": return inline(token.tokens, ctx, withUniqueMark(marks, { type: "strike" }));
+		case "codespan": return textNode(token.text, withUniqueMark(marks, { type: "code" }));
 		case "link": {
 			const link = token;
-			return inline(link.tokens, ctx, withMark(marks, {
+			return inline(link.tokens, ctx, withUniqueMark(marks, {
 				type: "link",
 				attrs: { href: link.href }
 			}));
@@ -711,25 +764,14 @@ function textNode(text, marks) {
 	if (marks.length > 0) node.marks = marks;
 	return [node];
 }
-function withMark(marks, mark) {
+function withUniqueMark(marks, mark) {
 	return [...marks.filter((m) => m.type !== mark.type), mark];
 }
-function defaultResolveImage(href, alt) {
-	return {
-		type: "mediaSingle",
-		attrs: { layout: "center" },
-		content: [{
-			type: "media",
-			attrs: alt ? {
-				type: "external",
-				url: href,
-				alt
-			} : {
-				type: "external",
-				url: href
-			}
-		}]
-	};
+function externalMedia(href, alt) {
+	return mediaNode({
+		type: "external",
+		url: href
+	}, alt);
 }
 function textToken(text) {
 	return {
@@ -743,108 +785,353 @@ function clampLevel$1(value) {
 	return Math.min(6, Math.max(1, Math.trunc(value) || 1));
 }
 //#endregion
-//#region src/adf/to-markdown.ts
-function adfToMarkdown(doc, options = {}) {
-	if (!doc) return "";
-	const ctx = { resolveMedia: options.resolveMedia };
-	return (doc.type === "doc" ? renderBlocks(doc.content ?? [], ctx, "") : renderBlock(doc, ctx, "")).trim();
-}
-function renderBlocks(nodes, ctx, indent) {
-	return nodes.map((n) => renderBlock(n, ctx, indent)).filter((s) => s.length > 0).join("\n\n");
-}
-function renderBlock(node, ctx, indent) {
-	switch (node.type) {
-		case "paragraph": return indent + renderInline(node.content ?? [], ctx);
-		case "heading": {
-			const level = clampLevel(node.attrs?.["level"]);
-			return `${"#".repeat(level)} ${renderInline(node.content ?? [], ctx)}`;
+//#region src/util/html.ts
+const MAX_CODE_POINT = 1114111;
+const NAMED = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'",
+	nbsp: " "
+};
+function decodeEntities(text) {
+	return text.replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (match, body) => {
+		if (body[0] === "#") {
+			const code = body[1] === "x" || body[1] === "X" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
+			return isCodePoint(code) ? String.fromCodePoint(code) : match;
 		}
-		case "bulletList": return renderList(node, ctx, indent, "bullet");
-		case "orderedList": return renderList(node, ctx, indent, "ordered");
-		case "taskList": return renderTaskList(node, ctx, indent);
-		case "decisionList": return renderDecisionList(node, ctx, indent);
-		case "codeBlock": return renderCodeBlock(node, indent);
-		case "blockquote": return prefixLines(renderBlocks(node.content ?? [], ctx, ""), `${indent}> `);
-		case "panel": return renderPanel(node, ctx, indent);
-		case "rule": return `${indent}---`;
-		case "table": return renderTable(node, ctx);
-		case "mediaSingle":
-		case "mediaGroup": return renderBlocks(node.content ?? [], ctx, indent);
-		case "media": return indent + renderMedia(node, ctx);
-		case "expand":
-		case "nestedExpand": return renderExpand(node, ctx, indent);
-		default:
-			if (node.content?.length) return renderBlocks(node.content, ctx, indent);
-			return node.text ? indent + node.text : "";
-	}
+		return NAMED[body.toLowerCase()] ?? match;
+	});
 }
-function renderList(node, ctx, indent, kind) {
-	const start = kind === "ordered" ? toNumber(node.attrs?.["order"]) ?? 1 : 0;
-	return (node.content ?? []).filter((n) => n.type === "listItem").map((item, i) => {
-		return renderListItem(item, ctx, indent, kind === "ordered" ? `${start + i}. ` : "- ");
-	}).join("\n");
+function isCodePoint(code) {
+	return Number.isFinite(code) && code >= 0 && code <= MAX_CODE_POINT;
 }
-function renderListItem(item, ctx, indent, marker) {
-	const childIndent = `${indent}${" ".repeat(marker.length)}`;
-	const rendered = (item.content ?? []).map((b, i) => renderBlock(b, ctx, i === 0 ? "" : childIndent));
-	const parts = [];
-	rendered.forEach((text, i) => {
-		if (i === 0) parts.push(`${indent}${marker}${text}`);
-		else parts.push(text);
-	});
-	return parts.join("\n");
+//#endregion
+//#region src/api/confluence.ts
+async function fetchPage(client, site, id) {
+	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
+	const names = new UserNames(client);
+	const [spaceKey, attachments, comments, author] = await Promise.all([
+		fetchSpaceKey(client, page.spaceId),
+		fetchAttachments(client, id),
+		fetchComments$1(client, id, names),
+		names.resolve(page.version?.authorId ?? page.authorId)
+	]);
+	const webui = page._links?.webui ?? "";
+	return {
+		id: page.id,
+		title: page.title,
+		spaceKey,
+		version: page.version?.number ?? 0,
+		author,
+		createdAt: page.createdAt ?? "",
+		updatedAt: page.version?.createdAt ?? "",
+		url: webui ? `${site}/wiki${webui}` : "",
+		body: parseAdfJson(page.body?.atlas_doc_format?.value),
+		attachments,
+		comments
+	};
 }
-function renderTaskList(node, ctx, indent) {
-	return (node.content ?? []).filter((n) => n.type === "taskItem").map((item) => {
-		return `${indent}- [${item.attrs?.["state"] === "DONE" ? "x" : " "}] ${renderInline(item.content ?? [], ctx)}`;
-	}).join("\n");
+async function fetchPageState(client, id) {
+	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
+	return {
+		version: page.version?.number ?? 0,
+		title: page.title,
+		body: parseAdfJson(page.body?.atlas_doc_format?.value)
+	};
 }
-function renderDecisionList(node, ctx, indent) {
-	return (node.content ?? []).filter((n) => n.type === "decisionItem").map((item) => `${indent}- (decision) ${renderInline(item.content ?? [], ctx)}`).join("\n");
+const UNKNOWN_SIZE = -1;
+async function listAttachments(client, id) {
+	return (await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/attachments?limit=250`)).results.map((a) => ({
+		filename: a.title ?? a.id,
+		fileId: mediaNodeId(a),
+		size: typeof a.fileSize === "number" ? a.fileSize : UNKNOWN_SIZE
+	}));
 }
-function renderCodeBlock(node, indent) {
-	const lang = typeof node.attrs?.["language"] === "string" ? node.attrs["language"] : "";
-	const code = (node.content ?? []).map((n) => n.text ?? "").join("");
-	const fence = "```";
-	return prefixLines(`${fence}${lang}\n${code}\n${fence}`, indent);
+async function uploadAttachment(client, pageId, filename, bytes) {
+	return (await client.postMultipart(`/wiki/rest/api/content/${encodeURIComponent(pageId)}/child/attachment`, filename, bytes)).results?.[0]?.extensions?.fileId ?? await fileIdByListing(client, pageId, filename);
 }
-const PANEL_LABELS = {
-	info: "Info",
-	note: "Note",
-	warning: "Warning",
-	success: "Success",
-	error: "Error"
-};
-function renderPanel(node, ctx, indent) {
-	return prefixLines(`**${PANEL_LABELS[typeof node.attrs?.["panelType"] === "string" ? node.attrs["panelType"] : "info"] ?? "Note"}**\n\n${renderBlocks(node.content ?? [], ctx, "")}`, `${indent}> `);
+async function fileIdByListing(client, pageId, filename) {
+	const match = (await listAttachments(client, pageId)).find((a) => a.filename === filename);
+	if (match) return match.fileId;
+	throw new Error(`Upload of "${filename}" did not return a fileId.`);
 }
-function renderExpand(node, ctx, indent) {
-	return `${indent}<details><summary>${typeof node.attrs?.["title"] === "string" ? node.attrs["title"] : "Details"}</summary>\n\n${renderBlocks(node.content ?? [], ctx, "")}\n\n${indent}</details>`;
+async function updatePage(client, id, params) {
+	return (await client.putJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}`, {
+		id,
+		status: "current",
+		title: params.title,
+		body: {
+			representation: "atlas_doc_format",
+			value: JSON.stringify(params.body)
+		},
+		version: {
+			number: params.nextVersion,
+			message: params.message
+		}
+	})).version?.number ?? params.nextVersion;
 }
-function renderTable(node, ctx) {
-	const rows = (node.content ?? []).filter((n) => n.type === "tableRow");
-	if (rows.length === 0) return "";
-	const grid = rows.map((row) => (row.content ?? []).map((cell) => renderCell(cell, ctx)));
-	const cols = Math.max(...grid.map((r) => r.length));
-	const pad = (r) => {
-		const copy = [...r];
-		while (copy.length < cols) copy.push("");
-		return copy;
+async function searchPages(client, site, params) {
+	const cql = buildCql(params);
+	const query = new URLSearchParams({
+		cql,
+		limit: String(params.limit),
+		expand: "space"
+	});
+	const results = (await client.getJson(`/wiki/rest/api/search?${query.toString()}`)).results ?? [];
+	const serverPageWasFull = results.length === params.limit;
+	return {
+		pages: results.filter((r) => r.content?.id).map((r) => ({
+			id: r.content?.id ?? "",
+			space: r.space?.key ?? r.resultGlobalContainer?.title ?? "",
+			title: decodeEntities(r.content?.title ?? r.title ?? ""),
+			url: r.url ? `${site}/wiki${r.url}` : ""
+		})),
+		hasMore: serverPageWasFull
 	};
-	const header = pad(grid[0] ?? []);
-	const lines = [`| ${header.join(" | ")} |`, `| ${header.map(() => "---").join(" | ")} |`];
-	for (const row of grid.slice(1)) lines.push(`| ${pad(row).join(" | ")} |`);
-	return lines.join("\n");
 }
-function renderCell(cell, ctx) {
-	return renderBlocks(cell.content ?? [], ctx, "").replace(/\n+/g, " ").replace(/\|/g, "\\|").trim();
+function buildCql(params) {
+	if (params.cql) return params.cql;
+	const clauses = ["type = page"];
+	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`;
 }
-function renderMedia(node, ctx) {
-	const attrs = node.attrs ?? {};
-	const alt = attrs.alt ?? "";
-	const resolved = ctx.resolveMedia?.(attrs);
-	if (resolved) return `![${alt}](${resolved})`;
-	return `[embedded media: ${alt || attrs.id || "media"}]`;
+function cqlStringLiteral(value) {
+	return `"${value.replace(/(["\\])/g, "\\$1")}"`;
+}
+async function fetchSpaceKey(client, spaceId) {
+	if (!spaceId) return "";
+	try {
+		return (await client.getJson(`/wiki/api/v2/spaces/${encodeURIComponent(spaceId)}`)).key ?? "";
+	} catch {
+		return "";
+	}
+}
+async function fetchAttachments(client, id) {
+	return (await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/attachments?limit=250`)).results.filter((a) => a.downloadLink).map((a) => ({
+		mediaId: mediaNodeId(a),
+		filename: a.title ?? a.id,
+		url: withWikiContextPath(a.downloadLink ?? "")
+	}));
+}
+function mediaNodeId(a) {
+	return a.fileId ?? a.id;
+}
+async function fetchComments$1(client, id, names) {
+	const res = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/footer-comments?body-format=atlas_doc_format&limit=250`);
+	return Promise.all(res.results.map(async (c) => ({
+		author: await names.resolve(c.version?.authorId),
+		created: c.version?.createdAt ?? "",
+		body: parseAdfJson(c.body?.atlas_doc_format?.value)
+	})));
+}
+function withWikiContextPath(link) {
+	if (link.startsWith("http") || link.startsWith("/wiki")) return link;
+	return `/wiki${link}`;
+}
+function parseAdfJson(value) {
+	if (!value) return null;
+	try {
+		return JSON.parse(value);
+	} catch {
+		return null;
+	}
+}
+var UserNames = class {
+	client;
+	cache = /* @__PURE__ */ new Map();
+	constructor(client) {
+		this.client = client;
+	}
+	async resolve(accountId) {
+		if (!accountId) return "";
+		const cached = this.cache.get(accountId);
+		if (cached !== void 0) return cached;
+		const name = await this.fetchDisplayName(accountId) ?? accountId;
+		this.cache.set(accountId, name);
+		return name;
+	}
+	async fetchDisplayName(accountId) {
+		try {
+			return (await this.client.getJson(`/wiki/rest/api/user?accountId=${encodeURIComponent(accountId)}`)).displayName || null;
+		} catch {
+			return null;
+		}
+	}
+};
+//#endregion
+//#region src/commands/resolve-ref.ts
+async function resolveRef(arg, kind) {
+	const raw = arg ?? await input({
+		message: kind.message,
+		required: true
+	});
+	const ref = kind.parse(raw);
+	if (!ref) throw new Error(kind.notFound(raw));
+	return ref;
+}
+//#endregion
+//#region src/commands/search-run.ts
+const COPY_CONCURRENCY = 5;
+async function runSearch(rows, options, noun, copyOne) {
+	if (options.json) {
+		console.log(JSON.stringify(rows.map((r) => r.json), null, 2));
+		return;
+	}
+	if (rows.length === 0) {
+		console.log(options.empty);
+		return;
+	}
+	if (options.copy) {
+		if (options.out?.endsWith(".md")) throw new Error("--out must be a directory when using --copy; a .md file path would overwrite each selection.");
+		await copySelected(rows, noun, copyOne);
+		return;
+	}
+	for (const row of rows) console.log(formatRow(row));
+	if (options.footer) console.log(options.footer);
+}
+function searchFooter(limit) {
+	return `
+Showing first ${limit}; refine with flags or raise --limit.`;
+}
+async function copySelected(rows, noun, copyOne) {
+	if (!process.stdin.isTTY) throw new Error("--copy requires an interactive terminal.");
+	const selected = await checkbox({
+		message: `Select ${noun.plural} to copy:`,
+		choices: rows.map((r) => ({
+			name: formatRow(r),
+			value: r.id
+		})),
+		pageSize: 20
+	});
+	if (selected.length === 0) {
+		console.log("Nothing selected.");
+		return;
+	}
+	let copied = 0;
+	const failures = [];
+	const queue = [...selected];
+	async function worker() {
+		for (let id = queue.shift(); id !== void 0; id = queue.shift()) try {
+			await copyOne(id);
+			copied++;
+		} catch (err) {
+			failures.push(`${id} (${err instanceof Error ? err.message : String(err)})`);
+		}
+	}
+	await Promise.all(Array.from({ length: Math.min(COPY_CONCURRENCY, selected.length) }, worker));
+	const summary = `Copied ${copied} ${copied === 1 ? noun.singular : noun.plural}`;
+	if (failures.length === 0) console.log(summary);
+	else console.log(`${summary}, failed ${failures.length}: ${failures.join(", ")}`);
+}
+function formatRow(row) {
+	const room = (process.stdout.columns ?? 80) - stripVTControlCharacters(row.fixedColumns).length - 2;
+	const text = room > 0 ? truncate(row.freeText, room) : "";
+	return text ? `${row.fixedColumns}  ${text}` : row.fixedColumns;
+}
+function truncate(text, max) {
+	const clean = text.replace(/\s+/g, " ").trim();
+	return clean.length <= max ? clean : `${clean.slice(0, Math.max(0, max - 3))}...`;
+}
+//#endregion
+//#region src/adf/to-markdown.ts
+function adfToMarkdown(doc, options = {}) {
+	if (!doc) return "";
+	const ctx = { resolveMedia: options.resolveMedia };
+	return (doc.type === "doc" ? renderBlocks(doc.content ?? [], ctx, "") : renderBlock(doc, ctx, "")).trim();
+}
+function renderBlocks(nodes, ctx, indent) {
+	return nodes.map((n) => renderBlock(n, ctx, indent)).filter((s) => s.length > 0).join("\n\n");
+}
+function renderBlock(node, ctx, indent) {
+	switch (node.type) {
+		case "paragraph": return indent + renderInline(node.content ?? [], ctx);
+		case "heading": {
+			const level = clampLevel(node.attrs?.["level"]);
+			return `${"#".repeat(level)} ${renderInline(node.content ?? [], ctx)}`;
+		}
+		case "bulletList": return renderList(node, ctx, indent, "bullet");
+		case "orderedList": return renderList(node, ctx, indent, "ordered");
+		case "taskList": return renderTaskList(node, ctx, indent);
+		case "decisionList": return renderDecisionList(node, ctx, indent);
+		case "codeBlock": return renderCodeBlock(node, indent);
+		case "blockquote": return prefixLines(renderBlocks(node.content ?? [], ctx, ""), `${indent}> `);
+		case "panel": return renderPanel(node, ctx, indent);
+		case "rule": return `${indent}---`;
+		case "table": return renderTable(node, ctx);
+		case "mediaSingle":
+		case "mediaGroup": return renderBlocks(node.content ?? [], ctx, indent);
+		case "media": return indent + renderMedia(node, ctx);
+		case "expand":
+		case "nestedExpand": return renderExpand(node, ctx, indent);
+		default:
+			if (node.content?.length) return renderBlocks(node.content, ctx, indent);
+			return node.text ? indent + node.text : "";
+	}
+}
+function renderList(node, ctx, indent, kind) {
+	const start = kind === "ordered" ? toNumber(node.attrs?.["order"]) ?? 1 : 0;
+	return (node.content ?? []).filter((n) => n.type === "listItem").map((item, i) => {
+		return renderListItem(item, ctx, indent, kind === "ordered" ? `${start + i}. ` : "- ");
+	}).join("\n");
+}
+function renderListItem(item, ctx, indent, marker) {
+	const continuationIndent = `${indent}${" ".repeat(marker.length)}`;
+	return (item.content ?? []).map((block, i) => i === 0 ? `${indent}${marker}${renderBlock(block, ctx, "")}` : renderBlock(block, ctx, continuationIndent)).join("\n");
+}
+function renderTaskList(node, ctx, indent) {
+	return (node.content ?? []).filter((n) => n.type === "taskItem").map((item) => {
+		return `${indent}- [${item.attrs?.["state"] === "DONE" ? "x" : " "}] ${renderInline(item.content ?? [], ctx)}`;
+	}).join("\n");
+}
+function renderDecisionList(node, ctx, indent) {
+	return (node.content ?? []).filter((n) => n.type === "decisionItem").map((item) => `${indent}- (decision) ${renderInline(item.content ?? [], ctx)}`).join("\n");
+}
+function renderCodeBlock(node, indent) {
+	const lang = typeof node.attrs?.["language"] === "string" ? node.attrs["language"] : "";
+	const code = (node.content ?? []).map((n) => n.text ?? "").join("");
+	const fence = "```";
+	return prefixLines(`${fence}${lang}\n${code}\n${fence}`, indent);
+}
+const PANEL_LABELS = {
+	info: "Info",
+	note: "Note",
+	warning: "Warning",
+	success: "Success",
+	error: "Error"
+};
+function renderPanel(node, ctx, indent) {
+	return prefixLines(`**${PANEL_LABELS[typeof node.attrs?.["panelType"] === "string" ? node.attrs["panelType"] : "info"] ?? "Note"}**\n\n${renderBlocks(node.content ?? [], ctx, "")}`, `${indent}> `);
+}
+function renderExpand(node, ctx, indent) {
+	return `${indent}<details><summary>${typeof node.attrs?.["title"] === "string" ? node.attrs["title"] : "Details"}</summary>\n\n${renderBlocks(node.content ?? [], ctx, "")}\n\n${indent}</details>`;
+}
+function renderTable(node, ctx) {
+	const rows = (node.content ?? []).filter((n) => n.type === "tableRow");
+	if (rows.length === 0) return "";
+	const grid = rows.map((row) => (row.content ?? []).map((cell) => renderCellOnOneLine(cell, ctx)));
+	const cols = Math.max(...grid.map((r) => r.length));
+	const pad = (r) => {
+		const copy = [...r];
+		while (copy.length < cols) copy.push("");
+		return copy;
+	};
+	const header = pad(grid[0] ?? []);
+	const lines = [`| ${header.join(" | ")} |`, `| ${header.map(() => "---").join(" | ")} |`];
+	for (const row of grid.slice(1)) lines.push(`| ${pad(row).join(" | ")} |`);
+	return lines.join("\n");
+}
+function renderCellOnOneLine(cell, ctx) {
+	return renderBlocks(cell.content ?? [], ctx, "").replace(/\n+/g, " ").replace(/\|/g, "\\|").trim();
+}
+function renderMedia(node, ctx) {
+	const attrs = node.attrs ?? {};
+	const alt = attrs.alt ?? "";
+	const resolved = ctx.resolveMedia?.(attrs);
+	if (resolved) return `![${alt}](${resolved})`;
+	return `[embedded media: ${alt || attrs.id || "media"}]`;
 }
 function renderInline(nodes, ctx) {
 	return nodes.map((n) => renderInlineNode(n, ctx)).join("");
@@ -860,7 +1147,7 @@ function renderInlineNode(node, ctx) {
 			const short = node.attrs?.["shortName"];
 			return typeof short === "string" ? short : "";
 		}
-		case "date": return formatDate$1(node.attrs?.["timestamp"]);
+		case "date": return formatDate(node.attrs?.["timestamp"]);
 		case "status": return `\`[${typeof node.attrs?.["text"] === "string" ? node.attrs["text"] : ""}]\``;
 		case "inlineCard": {
 			const url = node.attrs?.["url"];
@@ -908,226 +1195,82 @@ function clampLevel(value) {
 function toNumber(value) {
 	return typeof value === "number" ? value : void 0;
 }
-function formatDate$1(timestamp) {
+function formatDate(timestamp) {
 	const ms = typeof timestamp === "string" ? Number(timestamp) : typeof timestamp === "number" ? timestamp : NaN;
 	if (Number.isNaN(ms)) return "";
 	return new Date(ms).toISOString().slice(0, 10);
 }
 //#endregion
 //#region src/api/attachments.ts
-async function downloadAttachments(client, attachments, assetsDir, assetsDirName) {
-	if (attachments.length === 0) return [];
-	await mkdir(assetsDir, { recursive: true });
-	const used = /* @__PURE__ */ new Set();
-	const results = [];
-	for (const att of attachments) {
-		const savedAs = uniqueName(safeName(att.filename), used);
-		try {
-			const bytes = await client.getBinary(att.url);
-			await writeFile(join(assetsDir, savedAs), bytes);
-			results.push({
-				...att,
-				relativePath: `${assetsDirName}/${savedAs}`
-			});
-		} catch (err) {
-			console.warn(`  ! could not download ${att.filename}: ${err.message}`);
-		}
-	}
-	return results;
-}
-function safeName(name) {
-	return basename(name).replace(/[/\\]/g, "_") || "attachment";
-}
-function uniqueName(name, used) {
-	if (!used.has(name)) {
-		used.add(name);
-		return name;
-	}
-	const dot = name.lastIndexOf(".");
-	const stem = dot > 0 ? name.slice(0, dot) : name;
-	const ext = dot > 0 ? name.slice(dot) : "";
-	let i = 1;
-	let candidate = `${stem}-${i}${ext}`;
-	while (used.has(candidate)) {
-		i += 1;
-		candidate = `${stem}-${i}${ext}`;
-	}
-	used.add(candidate);
-	return candidate;
-}
-//#endregion
-//#region src/util/html.ts
-const NAMED = {
-	amp: "&",
-	lt: "<",
-	gt: ">",
-	quot: "\"",
-	apos: "'",
-	nbsp: " "
-};
-function decodeEntities(text) {
-	return text.replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (match, body) => {
-		if (body[0] === "#") {
-			const code = body[1] === "x" || body[1] === "X" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
-			return Number.isFinite(code) && code >= 0 && code <= 1114111 ? String.fromCodePoint(code) : match;
-		}
-		return NAMED[body.toLowerCase()] ?? match;
-	});
+function mediaResolver(downloaded) {
+	const byMediaId = new Map(downloaded.map((d) => [d.mediaId, d.relativePath]));
+	const byFilename = new Map(downloaded.map((d) => [d.filename, d.relativePath]));
+	return (media) => {
+		if (media.id && byMediaId.has(media.id)) return byMediaId.get(media.id);
+		if (media.alt && byFilename.has(media.alt)) return byFilename.get(media.alt);
+	};
 }
 //#endregion
-//#region src/api/confluence.ts
-async function fetchPage(client, site, id) {
-	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
-	const names = new UserNames(client);
-	const [spaceKey, attachments, comments, author] = await Promise.all([
-		fetchSpaceKey(client, page.spaceId),
-		fetchAttachments(client, id),
-		fetchComments$1(client, id, names),
-		names.resolve(page.version?.authorId ?? page.authorId)
-	]);
-	const webui = page._links?.webui ?? "";
+//#region src/markdown/copied-document.ts
+const COMMENTS_HEADING = "## Comments";
+const ATTACHMENTS_HEADING = "## Attachments";
+const FRONTMATTER_BLOCK = /^---\n([\s\S]*?)\n---\n?/;
+const FRONTMATTER_KEY = /^([A-Za-z0-9_]+):\s*(.*)$/;
+const FRONTMATTER_LIST_ITEM = /^ {2}- (.*)$/;
+const BARE_NUMBER = /^-?\d+(\.\d+)?$/;
+const TRAILING_SECTION_HEADING = /^## (Comments|Attachments)\s*$/;
+function render(doc) {
+	return `${[
+		frontmatter(doc.fields),
+		`# ${doc.title}`,
+		doc.body,
+		commentsSection(doc.comments),
+		attachmentsSection(doc.attachments)
+	].filter((s) => s.trim().length > 0).join("\n\n")}\n`;
+}
+function parse(text) {
+	const match = text.match(FRONTMATTER_BLOCK);
+	if (!match) throw new Error("Not an atlass file: no YAML frontmatter found.");
+	const fields = parseFrontmatter(match[1] ?? "");
+	const lines = text.slice(match[0].length).split("\n");
+	const h1 = leadingH1(lines);
+	const start = h1 ? h1.index + 1 : 0;
+	const trailing = lines.findIndex((line, i) => i >= start && TRAILING_SECTION_HEADING.test(line));
+	const end = trailing === -1 ? lines.length : trailing;
+	const fallbackTitle = typeof fields["title"] === "string" ? fields["title"] : "";
 	return {
-		id: page.id,
-		title: page.title,
-		spaceKey,
-		version: page.version?.number ?? 0,
-		author,
-		createdAt: page.createdAt ?? "",
-		updatedAt: page.version?.createdAt ?? "",
-		url: webui ? `${site}/wiki${webui}` : "",
-		body: parseAdf(page.body?.atlas_doc_format?.value),
-		attachments,
-		comments
+		fields,
+		title: h1?.title ?? fallbackTitle,
+		body: lines.slice(start, end).join("\n").trim()
 	};
 }
-async function fetchPageState(client, id) {
-	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
+function parseIssueSource(text) {
+	const source = parse(text);
+	const key = scalarString(source.fields["key"]);
+	if (!key) throw new Error("Frontmatter is missing the issue `key`; re-copy the issue.");
 	return {
-		version: page.version?.number ?? 0,
-		title: page.title,
-		body: parseAdf(page.body?.atlas_doc_format?.value)
+		...source,
+		key,
+		updatedAtCopy: scalarString(source.fields["updated"])
 	};
 }
-async function listAttachments(client, id) {
-	return (await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/attachments?limit=250`)).results.map((a) => ({
-		filename: a.title ?? a.id,
-		fileId: a.fileId ?? a.id,
-		size: typeof a.fileSize === "number" ? a.fileSize : -1
-	}));
-}
-async function uploadAttachment(client, pageId, filename, bytes) {
-	const fileId = (await client.postMultipart(`/wiki/rest/api/content/${encodeURIComponent(pageId)}/child/attachment`, filename, bytes)).results?.[0]?.extensions?.fileId;
-	if (fileId) return fileId;
-	const match = (await listAttachments(client, pageId)).find((a) => a.filename === filename);
-	if (match) return match.fileId;
-	throw new Error(`Upload of "${filename}" did not return a fileId.`);
-}
-async function updatePage(client, id, params) {
-	return (await client.putJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}`, {
-		id,
-		status: "current",
-		title: params.title,
-		body: {
-			representation: "atlas_doc_format",
-			value: JSON.stringify(params.body)
-		},
-		version: {
-			number: params.version,
-			message: params.message
-		}
-	})).version?.number ?? params.version;
-}
-async function searchPages(client, site, params) {
-	const cql = buildCql(params);
-	const query = new URLSearchParams({
-		cql,
-		limit: String(params.limit),
-		expand: "space"
-	});
-	const results = (await client.getJson(`/wiki/rest/api/search?${query.toString()}`)).results ?? [];
+function parsePageSource(text) {
+	const source = parse(text);
+	const id = scalarString(source.fields["id"]);
+	if (!id) throw new Error("Frontmatter is missing the page `id`; re-copy the page.");
+	const rawVersion = scalarString(source.fields["version"]);
+	const version = rawVersion === "" ? NaN : Number(rawVersion);
+	if (!Number.isFinite(version)) throw new Error("Frontmatter is missing a numeric `version`; re-copy the page.");
 	return {
-		pages: results.filter((r) => r.content?.id).map((r) => ({
-			id: r.content?.id ?? "",
-			space: r.space?.key ?? r.resultGlobalContainer?.title ?? "",
-			title: decodeEntities(r.content?.title ?? r.title ?? ""),
-			url: r.url ? `${site}/wiki${r.url}` : ""
-		})),
-		hasMore: results.length === params.limit
+		...source,
+		id,
+		version
 	};
 }
-function buildCql(params) {
-	if (params.cql) return params.cql;
-	const clauses = ["type = page"];
-	if (params.space) clauses.push(`space = ${cqlValue(params.space)}`);
-	if (params.text) clauses.push(`text ~ ${cqlValue(params.text)}`);
-	return `${clauses.join(" AND ")} ORDER BY lastmodified DESC`;
-}
-function cqlValue(value) {
-	return `"${value.replace(/(["\\])/g, "\\$1")}"`;
-}
-async function fetchSpaceKey(client, spaceId) {
-	if (!spaceId) return "";
-	try {
-		return (await client.getJson(`/wiki/api/v2/spaces/${encodeURIComponent(spaceId)}`)).key ?? "";
-	} catch {
-		return "";
-	}
-}
-async function fetchAttachments(client, id) {
-	return (await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/attachments?limit=250`)).results.filter((a) => a.downloadLink).map((a) => ({
-		id: a.fileId ?? a.id,
-		filename: a.title ?? a.id,
-		url: normalizeDownloadLink(a.downloadLink ?? "")
-	}));
-}
-async function fetchComments$1(client, id, names) {
-	const res = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/footer-comments?body-format=atlas_doc_format&limit=250`);
-	return Promise.all(res.results.map(async (c) => ({
-		author: await names.resolve(c.version?.authorId),
-		created: c.version?.createdAt ?? "",
-		body: parseAdf(c.body?.atlas_doc_format?.value)
-	})));
-}
-function normalizeDownloadLink(link) {
-	if (link.startsWith("http") || link.startsWith("/wiki")) return link;
-	return `/wiki${link}`;
-}
-function parseAdf(value) {
-	if (!value) return null;
-	try {
-		return JSON.parse(value);
-	} catch {
-		return null;
-	}
-}
-var UserNames = class {
-	client;
-	cache = /* @__PURE__ */ new Map();
-	constructor(client) {
-		this.client = client;
-	}
-	async resolve(accountId) {
-		if (!accountId) return "";
-		const cached = this.cache.get(accountId);
-		if (cached !== void 0) return cached;
-		let name = accountId;
-		try {
-			const user = await this.client.getJson(`/wiki/rest/api/user?accountId=${encodeURIComponent(accountId)}`);
-			if (user.displayName) name = user.displayName;
-		} catch {}
-		this.cache.set(accountId, name);
-		return name;
-	}
-};
-//#endregion
-//#region src/markdown/document.ts
-function mediaResolver(downloaded) {
-	const byId = new Map(downloaded.map((d) => [d.id, d.relativePath]));
-	const byName = new Map(downloaded.map((d) => [d.filename, d.relativePath]));
-	return (media) => {
-		if (media.id && byId.has(media.id)) return byId.get(media.id);
-		if (media.alt && byName.has(media.alt)) return byName.get(media.alt);
-	};
+function scalarString(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return String(value);
+	return "";
 }
 function frontmatter(fields) {
 	const lines = ["---"];
@@ -1138,111 +1281,195 @@ function frontmatter(fields) {
 	lines.push("---");
 	return lines.join("\n");
 }
+function parseFrontmatter(block) {
+	const fields = {};
+	const lines = block.split("\n");
+	for (let i = 0; i < lines.length; i++) {
+		const m = lines[i]?.match(FRONTMATTER_KEY);
+		if (!m) continue;
+		const key = m[1] ?? "";
+		const raw = (m[2] ?? "").trim();
+		if (raw === "[]") fields[key] = [];
+		else if (raw === "") {
+			const items = [];
+			for (let item; item = lines[i + 1]?.match(FRONTMATTER_LIST_ITEM); i++) items.push(unquote((item[1] ?? "").trim()));
+			fields[key] = items;
+		} else fields[key] = scalar(raw);
+	}
+	return fields;
+}
+function scalar(raw) {
+	if (raw.startsWith("\"")) return unquote(raw);
+	if (BARE_NUMBER.test(raw)) return Number(raw);
+	return raw;
+}
 function quote(value) {
 	return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
 }
-function attachmentsSection(downloaded) {
-	if (downloaded.length === 0) return "";
-	return [
-		"## Attachments",
-		"",
-		...downloaded.map((d) => `- [${d.filename}](${d.relativePath})`)
-	].join("\n");
+function unquote(value) {
+	if (!value.startsWith("\"") || !value.endsWith("\"")) return value;
+	return value.slice(1, -1).replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
+}
+function leadingH1(lines) {
+	for (const [index, line] of lines.entries()) {
+		if (line.startsWith("# ")) return {
+			index,
+			title: line.slice(2).trim()
+		};
+		if (line.trim().length > 0) return null;
+	}
+	return null;
 }
-function commentsSection(comments, resolveMedia) {
+function commentsSection(comments) {
 	if (comments.length === 0) return "";
 	return [
-		"## Comments",
+		COMMENTS_HEADING,
 		"",
 		comments.map((c) => {
-			const heading = `### ${c.author || "Unknown"}${c.created ? ` - ${formatDate(c.created)}` : ""}`;
-			const body = adfToMarkdown(c.body, { resolveMedia });
-			return body ? `${heading}\n\n${body}` : heading;
+			const heading = `### ${c.author || "Unknown"}${c.created ? ` - ${formatDateTime(c.created)}` : ""}`;
+			return c.body ? `${heading}\n\n${c.body}` : heading;
 		}).join("\n\n")
 	].join("\n");
 }
-function formatDate(iso) {
-	const date = new Date(iso);
-	if (Number.isNaN(date.getTime())) return iso;
-	return date.toISOString().replace("T", " ").slice(0, 16);
-}
-function joinSections(sections) {
-	return `${sections.filter((s) => s.trim().length > 0).join("\n\n")}\n`;
+function attachmentsSection(attachments) {
+	if (attachments.length === 0) return "";
+	return [
+		ATTACHMENTS_HEADING,
+		"",
+		...attachments.map((a) => `- [${a.filename}](${a.relativePath})`)
+	].join("\n");
 }
 //#endregion
-//#region src/markdown/update-source.ts
-function parseUpdateSource(content) {
-	const { fields, bodyTitle, body } = splitFile(content);
-	const id = fields["id"];
-	if (!id) throw new Error("Frontmatter is missing the page `id`; re-copy the page.");
-	const version = Number(fields["version"]);
-	if (!Number.isFinite(version)) throw new Error("Frontmatter is missing a numeric `version`; re-copy the page.");
-	return {
-		id,
-		version,
-		frontTitle: fields["title"] ?? "",
-		bodyTitle,
-		body
-	};
+//#region src/copy/plan.ts
+function planIssueCopy(issue, out) {
+	return planCopy({
+		baseName: issue.key,
+		fields: {
+			key: issue.key,
+			type: issue.type,
+			status: issue.status,
+			assignee: issue.assignee,
+			reporter: issue.reporter,
+			priority: issue.priority,
+			labels: issue.labels,
+			created: issue.created,
+			updated: issue.updated,
+			url: issue.url
+		},
+		title: issue.summary,
+		body: issue.description,
+		comments: issue.comments,
+		attachments: issue.attachments
+	}, out);
+}
+function planPageCopy(page, out) {
+	return planCopy({
+		baseName: `${page.id}-${slugify(page.title)}`,
+		fields: {
+			title: page.title,
+			id: page.id,
+			space: page.spaceKey,
+			version: page.version,
+			author: page.author,
+			created: page.createdAt,
+			updated: page.updatedAt,
+			url: page.url
+		},
+		title: page.title,
+		body: page.body,
+		comments: page.comments,
+		attachments: page.attachments
+	}, out);
+}
+function renderCopy(plan, landed) {
+	const resolveMedia = mediaResolver(landed);
+	return render({
+		fields: plan.fields,
+		title: plan.title,
+		body: adfToMarkdown(plan.body, { resolveMedia }),
+		comments: plan.comments.map((c) => ({
+			author: c.author,
+			created: c.created,
+			body: adfToMarkdown(c.body, { resolveMedia })
+		})),
+		attachments: landed
+	});
 }
-function parseJiraUpdateSource(content) {
-	const { fields, bodyTitle, body } = splitFile(content);
-	const key = fields["key"];
-	if (!key) throw new Error("Frontmatter is missing the issue `key`; re-copy the issue.");
+function planCopy(source, out) {
+	const { baseName, attachments, ...content } = source;
+	const target = outputTarget(baseName, out);
 	return {
-		key,
-		updated: fields["updated"] ?? "",
-		bodyTitle,
-		body
+		...content,
+		filePath: target.filePath,
+		assetsDir: target.assetsDir,
+		downloads: planDownloads(attachments, target)
 	};
 }
-function splitFile(content) {
-	const match = content.match(/^---\n([\s\S]*?)\n---\n?/);
-	if (!match) throw new Error("Not an atlass file: no YAML frontmatter found.");
-	const fields = parseFrontmatter(match[1] ?? "");
-	const { bodyTitle, body } = splitBody(content.slice(match[0].length), fields["title"] ?? "");
+function outputTarget(base, out) {
+	let filePath;
+	if (!out) filePath = resolve(`${base}.md`);
+	else if (out.endsWith(".md")) filePath = isAbsolute(out) ? out : resolve(out);
+	else filePath = resolve(out, `${base}.md`);
+	const dir = dirname(filePath);
+	const assetsDirName = `${filePath.slice(dir.length + 1).replace(/\.md$/, "")}.assets`;
 	return {
-		fields,
-		bodyTitle,
-		body
+		filePath,
+		assetsDir: join(dir, assetsDirName),
+		assetsDirName
 	};
 }
-function parseFrontmatter(block) {
-	const out = {};
-	for (const line of block.split("\n")) {
-		const m = line.match(/^([A-Za-z0-9_]+):\s*(.*)$/);
-		if (!m) continue;
-		const key = m[1] ?? "";
-		let value = (m[2] ?? "").trim();
-		if (value.startsWith("\"") && value.endsWith("\"")) value = value.slice(1, -1).replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
-		out[key] = value;
-	}
-	return out;
+function slugify(title) {
+	return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60).replace(/-+$/g, "") || "page";
 }
-function splitBody(rest, fallbackTitle) {
-	const lines = rest.split("\n");
-	let bodyTitle = fallbackTitle;
-	let start = 0;
-	for (let i = 0; i < lines.length; i++) {
-		const line = lines[i] ?? "";
-		if (line.startsWith("# ")) {
-			bodyTitle = line.slice(2).trim();
-			start = i + 1;
-			break;
-		}
-		if (line.trim().length > 0) break;
-	}
-	let end = lines.length;
-	for (let i = start; i < lines.length; i++) if (/^## (Comments|Attachments)\s*$/.test(lines[i] ?? "")) {
-		end = i;
-		break;
+function planDownloads(attachments, target) {
+	const used = /* @__PURE__ */ new Set();
+	return attachments.map((att) => {
+		const savedAs = uniqueName(bareFilename(att.filename), used);
+		return {
+			...att,
+			relativePath: `${target.assetsDirName}/${savedAs}`,
+			path: join(target.assetsDir, savedAs)
+		};
+	});
+}
+function bareFilename(name) {
+	return basename(name).replace(/[/\\]/g, "_") || "attachment";
+}
+function uniqueName(name, used) {
+	let candidate = name;
+	for (let suffix = 1; used.has(candidate); suffix++) candidate = numberedName(name, suffix);
+	used.add(candidate);
+	return candidate;
+}
+function numberedName(name, suffix) {
+	const dot = name.lastIndexOf(".");
+	return `${dot > 0 ? name.slice(0, dot) : name}-${suffix}${dot > 0 ? name.slice(dot) : ""}`;
+}
+//#endregion
+//#region src/copy/run.ts
+async function runCopy(plan, fetchBytes) {
+	const landed = await download(plan, fetchBytes);
+	await mkdir(dirname(plan.filePath), { recursive: true });
+	await writeFile(plan.filePath, renderCopy(plan, landed), "utf8");
+	console.log(wroteLine(plan.filePath, landed.length));
+}
+async function download(plan, fetchBytes) {
+	if (plan.downloads.length === 0) return [];
+	await mkdir(plan.assetsDir, { recursive: true });
+	const landed = [];
+	for (const { path, ...attachment } of plan.downloads) try {
+		await writeFile(path, await fetchBytes(attachment.url));
+		landed.push(attachment);
+	} catch (err) {
+		console.warn(`  ! could not download ${attachment.filename}: ${err.message}`);
 	}
-	const body = lines.slice(start, end).join("\n").trim();
-	return {
-		bodyTitle,
-		body
-	};
+	return landed;
 }
+function wroteLine(filePath, attachmentCount) {
+	return `Wrote ${filePath}${attachmentCount > 0 ? ` (+${attachmentCount} attachment${attachmentCount === 1 ? "" : "s"})` : ""}`;
+}
+//#endregion
+//#region src/adf/lossy.ts
 const LOSSY_LABELS = {
 	panel: "panel",
 	expand: "expand",
@@ -1258,101 +1485,220 @@ const JIRA_LOSSY_LABELS = {
 	media: "image",
 	mediaInline: "image"
 };
-function findLossyNodes(node, labels = LOSSY_LABELS) {
+function findLossyNodes(node, lossyLabels = LOSSY_LABELS) {
 	const counts = /* @__PURE__ */ new Map();
 	const visit = (n) => {
-		const label = labels[n.type];
+		const label = lossyLabels[n.type];
 		if (label) counts.set(label, (counts.get(label) ?? 0) + 1);
 		for (const child of n.content ?? []) visit(child);
 	};
-	if (node) visit(node);
-	return counts;
+	if (node) visit(node);
+	return counts;
+}
+function formatLossy(counts) {
+	return [...counts.entries()].map(([label, n]) => `${n} ${label}${n === 1 ? "" : "s"}`).join(", ");
+}
+//#endregion
+//#region src/update/plan.ts
+function planIssueUpdate(source, issue, options) {
+	const images = imageHrefs(source.body).map((href) => ({
+		href,
+		kind: isExternalHref(href) ? "external" : "unsupported"
+	}));
+	const unsupported = images.filter((i) => i.kind === "unsupported").map((i) => i.href);
+	const body = markdownToAdf(source.body, { resolveImage: (href, alt) => isExternalHref(href) ? externalMedia(href, alt) : void 0 });
+	const refusals = [...unsupported.length > 0 ? [`jira update does not support image changes yet. Remove local image reference(s) or edit text only: ${unsupported.join(", ")}`] : [], ...emptyBodyRefusal(body)];
+	return withVerdict({
+		noun: "issue",
+		id: source.key,
+		headline: headline("summary", issue.summary, source.title, options.summary),
+		revision: revision(source.updatedAtCopy, issue.updated),
+		lossy: findLossyNodes(issue.description, JIRA_LOSSY_LABELS),
+		images,
+		uploads: [],
+		body,
+		refusals
+	}, options.force ?? false);
+}
+function planPageUpdate(source, state, attachments, localImages, options) {
+	const collection = `contentId-${source.id}`;
+	const entries = imageHrefs(source.body).map((href) => pageImage(href, localImages, attachments));
+	const byHref = new Map(entries.map((e) => [e.href, e]));
+	const body = markdownToAdf(source.body, { resolveImage: (href, alt) => {
+		const entry = byHref.get(href);
+		if (!entry || entry.kind === "missing") return void 0;
+		if (entry.kind === "external") return externalMedia(href, alt);
+		return mediaNode({
+			type: "file",
+			id: entry.kind === "reuse" ? entry.fileId : href,
+			collection
+		}, alt);
+	} });
+	const missing = entries.filter((e) => e.kind === "missing").map((e) => e.href);
+	const refusals = [...missing.length > 0 ? [`Image file(s) not found: ${missing.join(", ")}`] : [], ...emptyBodyRefusal(body)];
+	return withVerdict({
+		noun: "page",
+		id: source.id,
+		headline: headline("title", state.title, source.title, options.title),
+		revision: revision(`v${source.version}`, `v${state.version}`),
+		lossy: findLossyNodes(state.body),
+		images: entries.map(({ href, kind }) => ({
+			href,
+			kind
+		})),
+		uploads: entries.flatMap((e) => e.kind === "upload" || e.kind === "changed" ? [{
+			href: e.href,
+			path: e.path,
+			filename: e.filename
+		}] : []),
+		body,
+		refusals
+	}, options.force ?? false);
+}
+function pageImage(href, localImages, attachments) {
+	if (isExternalHref(href)) return {
+		href,
+		kind: "external"
+	};
+	const local = localImages.find((l) => l.href === href);
+	if (!local || local.size === void 0) return {
+		href,
+		kind: "missing"
+	};
+	const existing = attachments.find((a) => a.filename === local.filename);
+	if (existing && existing.size === local.size) return {
+		href,
+		kind: "reuse",
+		fileId: existing.fileId
+	};
+	return {
+		href,
+		kind: existing ? "changed" : "upload",
+		path: local.path,
+		filename: local.filename
+	};
+}
+function withUploadedIds(doc, ids) {
+	if (!doc.content) return doc;
+	return {
+		...doc,
+		content: doc.content.map((n) => withUploadedId(n, ids))
+	};
 }
-function formatLossy(counts) {
-	return [...counts.entries()].map(([label, n]) => `${n} ${label}${n === 1 ? "" : "s"}`).join(", ");
+function withUploadedId(node, ids) {
+	const id = node.type === "media" ? node.attrs?.["id"] : void 0;
+	const swapped = typeof id === "string" && ids.has(id) ? {
+		...node,
+		attrs: {
+			...node.attrs,
+			id: ids.get(id)
+		}
+	} : node;
+	if (!swapped.content) return swapped;
+	return {
+		...swapped,
+		content: swapped.content.map((n) => withUploadedId(n, ids))
+	};
 }
-//#endregion
-//#region src/util/output-path.ts
-function resolveOutput(defaultBase, out) {
-	let filePath;
-	if (!out) filePath = resolve(`${defaultBase}.md`);
-	else if (out.endsWith(".md")) filePath = isAbsolute(out) ? out : resolve(out);
-	else filePath = resolve(out, `${defaultBase}.md`);
-	const dir = dirname(filePath);
-	const assetsDirName = `${filePath.slice(dir.length + 1).replace(/\.md$/, "")}.assets`;
+function formatPlan(plan) {
+	const lines = [`Dry run for ${plan.noun} ${plan.id} "${plan.headline.current}"`];
+	if (plan.headline.next !== plan.headline.current) lines.push(row(plan.headline.label, `"${plan.headline.current}" -> "${plan.headline.next}"`));
+	const counts = imageCounts(plan.images);
+	if (counts) lines.push(row("images", counts));
+	for (const refusal of plan.refusals) lines.push(row("blocked", refusal));
+	if (plan.lossy.size > 0) lines.push(row("warning", `${formatLossy(plan.lossy)} will be removed`));
+	if (plan.revision.stale) lines.push(row("stale", `${revisionText(plan.revision)} (would refuse without --force)`));
+	lines.push("  nothing was written (dry run)");
+	return lines;
+}
+const IMAGE_COUNT_LABELS = [
+	["upload", "new"],
+	["changed", "changed"],
+	["reuse", "reused"],
+	["external", "external"],
+	["unsupported", "unsupported"],
+	["missing", "missing"]
+];
+function imageCounts(images) {
+	return IMAGE_COUNT_LABELS.map(([kind, label]) => ({
+		n: images.filter((i) => i.kind === kind).length,
+		label
+	})).filter(({ n }) => n > 0).map(({ n, label }) => `${n} ${label}`).join(", ");
+}
+function row(label, value) {
+	return `  ${`${label}:`.padEnd(9)}${value}`;
+}
+function headline(label, current, title, useTitle) {
 	return {
-		filePath,
-		assetsDir: join(dir, assetsDirName),
-		assetsDirName
+		label,
+		current,
+		next: useTitle && title ? title : current
 	};
 }
-function slugify(title) {
-	return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60).replace(/-+$/g, "") || "page";
+function revision(local, server) {
+	return {
+		local: local || "unknown",
+		server: server || "unknown",
+		stale: local !== server
+	};
 }
-//#endregion
-//#region src/commands/search-run.ts
-const COPY_CONCURRENCY = 5;
-async function runSearch(rows, options, noun, copyOne) {
-	if (options.json) {
-		console.log(JSON.stringify(rows.map((r) => r.json), null, 2));
-		return;
-	}
-	if (rows.length === 0) {
-		console.log(`No matching ${noun.plural}.`);
-		return;
-	}
-	if (options.copy) {
-		if (options.out?.endsWith(".md")) throw new Error("--out must be a directory when using --copy; a .md file path would overwrite each selection.");
-		await copySelected(rows, noun, copyOne);
-		return;
-	}
-	for (const row of rows) console.log(formatRow(row));
-	if (options.hasMore) console.log(`\nShowing first ${options.limit}; refine with flags or raise --limit.`);
+function revisionText(revision) {
+	return `copied at ${revision.local}, server now ${revision.server}`;
 }
-async function copySelected(rows, noun, copyOne) {
-	if (!process.stdin.isTTY) throw new Error("--copy requires an interactive terminal.");
-	const selected = await checkbox({
-		message: `Select ${noun.plural} to copy:`,
-		choices: rows.map((r) => ({
-			name: formatRow(r),
-			value: r.id
-		})),
-		pageSize: 20
-	});
-	if (selected.length === 0) {
-		console.log("Nothing selected.");
+function emptyBodyRefusal(body) {
+	if (body.content && body.content.length > 0) return [];
+	return ["Refusing to update: the converted body is empty."];
+}
+function withVerdict(plan, force) {
+	return {
+		...plan,
+		verdict: verdict(plan, force)
+	};
+}
+function verdict(plan, force) {
+	if (plan.refusals.length > 0) return {
+		kind: "refuse",
+		message: plan.refusals.join("\n")
+	};
+	const noun = plan.noun;
+	if (plan.revision.stale && !force) return {
+		kind: "refuse",
+		message: `${capitalize(noun)} changed on the server since you copied it (${revisionText(plan.revision)}). Re-copy the ${noun} or pass --force.`
+	};
+	if (plan.lossy.size > 0 && !force) return {
+		kind: "confirm",
+		message: `This ${noun} contains ${formatLossy(plan.lossy)} that Markdown cannot represent and will be removed. Continue?`
+	};
+	return { kind: "proceed" };
+}
+function capitalize(text) {
+	return text.charAt(0).toUpperCase() + text.slice(1);
+}
+//#endregion
+//#region src/update/run.ts
+async function runPlan(plan, options, push) {
+	if (options.dryRun) {
+		for (const line of formatPlan(plan)) console.log(line);
 		return;
 	}
-	let copied = 0;
-	const failures = [];
-	const queue = [...selected];
-	async function worker() {
-		for (let id = queue.shift(); id !== void 0; id = queue.shift()) try {
-			await copyOne(id);
-			copied++;
-		} catch (err) {
-			failures.push(`${id} (${err instanceof Error ? err.message : String(err)})`);
+	const verdict = plan.verdict;
+	if (verdict.kind === "refuse") throw new Error(verdict.message);
+	if (verdict.kind === "confirm") {
+		if (!await confirm({
+			message: verdict.message,
+			default: false
+		})) {
+			console.log("Aborted.");
+			return;
 		}
 	}
-	await Promise.all(Array.from({ length: Math.min(COPY_CONCURRENCY, selected.length) }, worker));
-	const summary = `Copied ${copied} ${copied === 1 ? noun.singular : noun.plural}`;
-	if (failures.length === 0) console.log(summary);
-	else console.log(`${summary}, failed ${failures.length}: ${failures.join(", ")}`);
-}
-function formatRow(row) {
-	const room = (process.stdout.columns ?? 80) - row.prefix.length - 2;
-	const text = room > 0 ? truncate(row.text, room) : "";
-	return text ? `${row.prefix}  ${text}` : row.prefix;
-}
-function truncate(text, max) {
-	const clean = text.replace(/\s+/g, " ").trim();
-	return clean.length <= max ? clean : `${clean.slice(0, Math.max(0, max - 3))}...`;
+	await push();
 }
 //#endregion
 //#region src/commands/confluence.ts
 async function confluenceCopy(arg, options) {
 	const auth = await requireAuth();
-	const id = await resolveId(arg);
+	const id = await resolveRef(arg, PAGE_REF);
 	await copyPage(new AtlassianClient(auth), auth.site, id, options.out);
 }
 async function confluenceUpdate(arg, options) {
@@ -1360,50 +1706,44 @@ async function confluenceUpdate(arg, options) {
 		message: "Path to the page Markdown file:",
 		required: true
 	});
-	const src = parseUpdateSource(await readFile(file, "utf8"));
+	const src = parsePageSource(await readFile(file, "utf8"));
 	const client = new AtlassianClient(await requireAuth());
 	const state = await fetchPageState(client, src.id);
-	if (state.version !== src.version && !options.force) throw new Error(`Page changed on the server since you copied it (local v${src.version}, server v${state.version}). Re-copy the page or pass --force.`);
-	const dir = dirname(resolve(file));
-	const attachments = await listAttachments(client, src.id);
-	const plan = await planImages(dir, collectImageHrefs(src.body), attachments);
-	const lossy = findLossyNodes(state.body);
-	const nextVersion = state.version + 1;
-	const newTitle = options.title && src.bodyTitle ? src.bodyTitle : state.title;
-	if (options.dryRun) {
-		printDryRun$1(src.id, state.title, newTitle, state.version, nextVersion, lossy, plan);
-		return;
-	}
-	if (lossy.size > 0 && !options.force) {
-		if (!await confirm({
-			message: `This page contains ${formatLossy(lossy)} that Markdown cannot represent and will be removed. Continue?`,
-			default: false
-		})) {
-			console.log("Aborted.");
-			return;
+	const plan = planPageUpdate(src, state, await listAttachments(client, src.id), await statLocalImages(dirname(resolve(file)), src.body), options);
+	await runPlan(plan, options, async () => {
+		const ids = /* @__PURE__ */ new Map();
+		for (const upload of plan.uploads) {
+			console.log(`Uploading ${upload.filename} ...`);
+			const bytes = await readFile(upload.path);
+			ids.set(upload.href, await uploadAttachment(client, src.id, upload.filename, bytes));
 		}
-	}
-	const collection = `contentId-${src.id}`;
-	const fileIds = /* @__PURE__ */ new Map();
-	for (const [href, entry] of plan) if (entry.kind === "upload") {
-		console.log(`Uploading ${entry.filename} ...`);
-		fileIds.set(href, await uploadAttachment(client, src.id, entry.filename, await readFile(entry.path)));
-	} else if (entry.kind === "reuse") fileIds.set(href, entry.fileId);
-	const body = markdownToAdf(src.body, { resolveImage: (href, alt) => {
-		const entry = plan.get(href);
-		if (!entry) return void 0;
-		if (entry.kind === "external") return externalMedia(href, alt);
-		const fileId = fileIds.get(href);
-		return fileId ? fileMedia(fileId, collection, alt) : void 0;
-	} });
-	if (!body.content || body.content.length === 0) throw new Error("Refusing to update: the converted body is empty.");
-	const version = await updatePage(client, src.id, {
-		title: newTitle,
-		version: nextVersion,
-		body,
-		message: options.message ?? "Updated via atlass"
+		const version = await updatePage(client, src.id, {
+			title: plan.headline.next,
+			nextVersion: state.version + 1,
+			body: withUploadedIds(plan.body, ids),
+			message: options.message ?? "Updated via atlass"
+		});
+		console.log(`Updated page ${src.id} to version ${version}.`);
 	});
-	console.log(`Updated page ${src.id} to version ${version}.`);
+}
+async function statLocalImages(dir, md) {
+	const hrefs = imageHrefs(md).filter((href) => !isExternalHref(href));
+	return Promise.all(hrefs.map(async (href) => {
+		const path = isAbsolute(href) ? href : resolve(dir, href);
+		return {
+			href,
+			path,
+			filename: basename(path),
+			...await fileSize(path)
+		};
+	}));
+}
+async function fileSize(path) {
+	try {
+		return { size: (await stat(path)).size };
+	} catch {
+		return {};
+	}
 }
 async function confluenceSearch(query, options) {
 	if (options.cql && (query || options.space)) throw new Error("--cql cannot be combined with a text query or --space.");
@@ -1419,8 +1759,8 @@ async function confluenceSearch(query, options) {
 	});
 	await runSearch(pages.map((p) => ({
 		id: p.id,
-		prefix: `${p.id}  ${p.space}`,
-		text: p.title,
+		fixedColumns: `${p.id}  ${p.space}`,
+		freeText: p.title,
 		json: {
 			id: p.id,
 			space: p.space,
@@ -1430,9 +1770,9 @@ async function confluenceSearch(query, options) {
 	})), {
 		json: options.json,
 		copy: options.copy,
-		limit,
-		hasMore,
-		out: options.out
+		out: options.out,
+		empty: "No matching pages.",
+		footer: hasMore ? searchFooter(limit) : void 0
 	}, {
 		singular: "page",
 		plural: "pages"
@@ -1440,127 +1780,13 @@ async function confluenceSearch(query, options) {
 }
 async function copyPage(client, site, id, out) {
 	console.log(`Fetching page ${id} ...`);
-	const page = await fetchPage(client, site, id);
-	const target = resolveOutput(`${page.id}-${slugify(page.title)}`, out);
-	const downloaded = await downloadAttachments(client, page.attachments, target.assetsDir, target.assetsDirName);
-	const resolveMedia = mediaResolver(downloaded);
-	const document = joinSections([
-		frontmatter({
-			title: page.title,
-			id: page.id,
-			space: page.spaceKey,
-			version: page.version,
-			author: page.author,
-			created: page.createdAt,
-			updated: page.updatedAt,
-			url: page.url
-		}),
-		`# ${page.title}`,
-		adfToMarkdown(page.body, { resolveMedia }),
-		commentsSection(page.comments, resolveMedia),
-		attachmentsSection(downloaded)
-	]);
-	await writeFile(target.filePath, document, "utf8");
-	const suffix = downloaded.length > 0 ? ` (+${downloaded.length} attachment${downloaded.length === 1 ? "" : "s"})` : "";
-	console.log(`Wrote ${target.filePath}${suffix}`);
-}
-async function resolveId(arg) {
-	const raw = arg ?? await input({
-		message: "Confluence page id or URL:",
-		required: true
-	});
-	const id = parsePageId(raw);
-	if (!id) throw new Error(`Could not find a page id in "${raw}".`);
-	return id;
-}
-function collectImageHrefs(md) {
-	const hrefs = /* @__PURE__ */ new Set();
-	marked.walkTokens(marked.lexer(md), (token) => {
-		if (token.type === "image") hrefs.add(token.href);
-	});
-	return [...hrefs];
-}
-async function planImages(dir, hrefs, attachments) {
-	const byName = new Map(attachments.map((a) => [a.filename, a]));
-	const plan = /* @__PURE__ */ new Map();
-	const missing = [];
-	for (const href of hrefs) {
-		if (isExternal(href)) {
-			plan.set(href, { kind: "external" });
-			continue;
-		}
-		const path = isAbsolute(href) ? href : resolve(dir, href);
-		let size;
-		try {
-			size = (await stat(path)).size;
-		} catch {
-			missing.push(href);
-			continue;
-		}
-		const filename = basename(path);
-		const existing = byName.get(filename);
-		if (existing && existing.size === size) plan.set(href, {
-			kind: "reuse",
-			fileId: existing.fileId,
-			filename
-		});
-		else plan.set(href, {
-			kind: "upload",
-			path,
-			filename,
-			existed: existing !== void 0
-		});
-	}
-	if (missing.length > 0) throw new Error(`Image file(s) not found: ${missing.join(", ")}`);
-	return plan;
-}
-function isExternal(href) {
-	return /^[a-z][a-z0-9+.-]*:\/\//i.test(href);
-}
-function externalMedia(href, alt) {
-	const attrs = {
-		type: "external",
-		url: href
-	};
-	if (alt) attrs["alt"] = alt;
-	return {
-		type: "mediaSingle",
-		attrs: { layout: "center" },
-		content: [{
-			type: "media",
-			attrs
-		}]
-	};
-}
-function fileMedia(fileId, collection, alt) {
-	const attrs = {
-		type: "file",
-		id: fileId,
-		collection
-	};
-	if (alt) attrs["alt"] = alt;
-	return {
-		type: "mediaSingle",
-		attrs: { layout: "center" },
-		content: [{
-			type: "media",
-			attrs
-		}]
-	};
-}
-function printDryRun$1(id, currentTitle, newTitle, currentVersion, nextVersion, lossy, plan) {
-	const entries = [...plan.values()];
-	const added = entries.filter((e) => e.kind === "upload" && !e.existed).length;
-	const changed = entries.filter((e) => e.kind === "upload" && e.existed).length;
-	const reused = entries.filter((e) => e.kind === "reuse").length;
-	const external = entries.filter((e) => e.kind === "external").length;
-	console.log(`Dry run for page ${id} "${currentTitle}"`);
-	console.log(`  version: ${currentVersion} -> ${nextVersion}`);
-	if (newTitle !== currentTitle) console.log(`  title:   "${currentTitle}" -> "${newTitle}"`);
-	console.log(`  images:  ${added} new, ${changed} changed, ${reused} reused, ${external} external`);
-	if (lossy.size > 0) console.log(`  warning: ${formatLossy(lossy)} will be removed`);
-	console.log("  nothing was written (dry run)");
+	await runCopy(planPageCopy(await fetchPage(client, site, id), out), (url) => client.getBinary(url));
 }
+const PAGE_REF = {
+	message: "Confluence page id or URL:",
+	parse: parsePageId,
+	notFound: (raw) => `Could not find a page id in "${raw}".`
+};
 //#endregion
 //#region src/api/jira.ts
 const FIELDS = [
@@ -1576,6 +1802,7 @@ const FIELDS = [
 	"updated",
 	"attachment"
 ].join(",");
+const RECENT_ISSUES_CLAUSE = "updated >= -30d";
 function browseUrl(site, key) {
 	return `${site}/browse/${key}`;
 }
@@ -1589,6 +1816,7 @@ async function fetchIssue(client, site, key) {
 		summary: f.summary ?? "",
 		type: f.issuetype?.name ?? "",
 		status: f.status?.name ?? "",
+		statusCategory: f.status?.statusCategory?.key ?? "",
 		assignee: f.assignee?.displayName ?? "Unassigned",
 		reporter: f.reporter?.displayName ?? "",
 		priority: f.priority?.name ?? "",
@@ -1598,7 +1826,7 @@ async function fetchIssue(client, site, key) {
 		description: f.description ?? null,
 		comments,
 		attachments: (f.attachment ?? []).map((a) => ({
-			id: a.id,
+			mediaId: a.id,
 			filename: a.filename,
 			url: a.content
 		}))
@@ -1607,32 +1835,81 @@ async function fetchIssue(client, site, key) {
 async function updateIssue(client, key, update) {
 	const fields = { description: update.description };
 	if (update.summary !== void 0) fields["summary"] = update.summary;
-	await client.put(`/rest/api/3/issue/${encodeURIComponent(key)}`, { fields });
+	await client.putNoContent(`/rest/api/3/issue/${encodeURIComponent(key)}`, { fields });
 }
+const SEARCH_FIELDS = "summary,status,updated";
 async function searchIssues(client, site, params) {
-	const jql = buildJql(params);
+	return ((await fetchSearchPage(client, buildJql(params), params.limit)).issues ?? []).map((i) => toIssueSummary(site, i));
+}
+async function fetchSearchPage(client, jql, maxResults, nextPageToken) {
 	const query = new URLSearchParams({
 		jql,
-		maxResults: String(params.limit),
-		fields: "summary,status"
+		maxResults: String(maxResults),
+		fields: SEARCH_FIELDS
 	});
-	return ((await client.getJson(`/rest/api/3/search/jql?${query.toString()}`)).issues ?? []).map((i) => ({
+	if (nextPageToken) query.set("nextPageToken", nextPageToken);
+	return client.getJson(`/rest/api/3/search/jql?${query.toString()}`);
+}
+function toIssueSummary(site, i) {
+	return {
 		key: i.key,
 		status: i.fields?.status?.name ?? "",
+		statusCategory: i.fields?.status?.statusCategory?.key ?? "",
 		summary: decodeEntities(i.fields?.summary ?? ""),
+		updated: i.fields?.updated ?? "",
 		url: browseUrl(site, i.key)
-	}));
+	};
 }
 function buildJql(params) {
 	if (params.jql) return params.jql;
 	const clauses = [];
-	if (params.project) clauses.push(`project = ${jqlValue(params.project)}`);
-	if (params.assignee) clauses.push(params.assignee === "me" ? "assignee = currentUser()" : `assignee = ${jqlValue(params.assignee)}`);
-	if (params.status) clauses.push(`status = ${jqlValue(params.status)}`);
-	if (params.text) clauses.push(`text ~ ${jqlValue(params.text)}`);
-	if (clauses.length === 0) clauses.push("updated >= -30d");
+	if (params.project) clauses.push(`project = ${jqlStringLiteral(params.project)}`);
+	if (params.assignee) clauses.push(params.assignee === "me" ? "assignee = currentUser()" : `assignee = ${jqlStringLiteral(params.assignee)}`);
+	if (params.status) clauses.push(`status = ${jqlStringLiteral(params.status)}`);
+	if (params.text) clauses.push(`text ~ ${jqlStringLiteral(params.text)}`);
+	if (clauses.length === 0) clauses.push(RECENT_ISSUES_CLAUSE);
+	return `${clauses.join(" AND ")} ORDER BY updated DESC`;
+}
+const OPEN_CLAUSE = "statusCategory != Done";
+function buildListJql(params) {
+	const clauses = ["assignee = currentUser()"];
+	if (params.project) clauses.push(`project = ${jqlStringLiteral(params.project)}`);
+	clauses.push(params.all ? `(${OPEN_CLAUSE} OR ${RECENT_ISSUES_CLAUSE})` : OPEN_CLAUSE);
 	return `${clauses.join(" AND ")} ORDER BY updated DESC`;
 }
+const LIST_PAGE_SIZE = 100;
+const LIST_CAP = 500;
+async function listAssignedIssues(client, site, params) {
+	const jql = buildListJql(params);
+	const issues = [];
+	let nextPageToken;
+	for (;;) {
+		const room = LIST_CAP - issues.length;
+		const res = await fetchSearchPage(client, jql, Math.min(LIST_PAGE_SIZE, room), nextPageToken);
+		const page = res.issues ?? [];
+		issues.push(...page.map((i) => toIssueSummary(site, i)));
+		if (res.isLast || !res.nextPageToken || page.length === 0) return {
+			issues,
+			truncated: false
+		};
+		if (issues.length >= LIST_CAP) return {
+			issues,
+			truncated: true
+		};
+		nextPageToken = res.nextPageToken;
+	}
+}
+const LIST_CATEGORY_ORDER = {
+	indeterminate: 0,
+	new: 1,
+	done: 2
+};
+const LIST_UNKNOWN_CATEGORY_RANK = Object.keys(LIST_CATEGORY_ORDER).length;
+function sortByCategoryThenUpdated(issues) {
+	const rank = (i) => LIST_CATEGORY_ORDER[i.statusCategory] ?? LIST_UNKNOWN_CATEGORY_RANK;
+	const updatedMs = (i) => Date.parse(i.updated) || 0;
+	return [...issues].sort((a, b) => rank(a) - rank(b) || updatedMs(b) - updatedMs(a));
+}
 const PROJECT_PAGE_SIZE = 50;
 async function listProjects(client, site, query) {
 	const projects = [];
@@ -1686,7 +1963,7 @@ const CATEGORY_ORDER = {
 	indeterminate: 1,
 	done: 2
 };
-const CATEGORY_LAST = Object.keys(CATEGORY_ORDER).length;
+const UNKNOWN_CATEGORY_RANK = Object.keys(CATEGORY_ORDER).length;
 function dedupeAndSortStatuses(statuses) {
 	const byNameCategory = /* @__PURE__ */ new Map();
 	for (const s of statuses) {
@@ -1694,11 +1971,11 @@ function dedupeAndSortStatuses(statuses) {
 		if (!byNameCategory.has(key)) byNameCategory.set(key, s);
 	}
 	return [...byNameCategory.values()].sort((a, b) => {
-		const rank = (s) => CATEGORY_ORDER[s.categoryKey] ?? CATEGORY_LAST;
+		const rank = (s) => CATEGORY_ORDER[s.categoryKey] ?? UNKNOWN_CATEGORY_RANK;
 		return rank(a) - rank(b) || a.name.localeCompare(b.name);
 	});
 }
-function jqlValue(value) {
+function jqlStringLiteral(value) {
 	return `"${value.replace(/(["\\])/g, "\\$1")}"`;
 }
 async function fetchComments(client, key) {
@@ -1709,6 +1986,148 @@ 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();
@@ -1747,45 +2166,95 @@ function formatStatusRows(statuses) {
 	const width = Math.max(...statuses.map((s) => s.name.length));
 	return statuses.map((s) => `${s.name.padEnd(width)}  ${s.category}`);
 }
+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);
+}
+const CATEGORY_COLORS = {
+	new: kleur.cyan,
+	indeterminate: kleur.yellow,
+	done: kleur.green
+};
+function colorForCategory(category) {
+	return CATEGORY_COLORS[category] ?? ((text) => text);
+}
+function formatIssueView(issue, nowMs, allComments) {
+	return [
+		`${kleur.bold(issue.key)}  ${issue.summary}`,
+		...fieldLines(issue, nowMs),
+		...bodyLines(adfToMarkdown(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 resolveKey(arg);
+	const key = await resolveRef(arg, ISSUE_REF);
 	await copyIssue(new AtlassianClient(auth), auth.site, key, options.out);
 }
 async function jiraUpdate(arg, options) {
-	const src = parseJiraUpdateSource(await readFile(arg ?? await input({
+	const src = parseIssueSource(await readFile(arg ?? await input({
 		message: "Path to the issue Markdown file:",
 		required: true
 	}), "utf8"));
 	const auth = await requireAuth();
 	const client = new AtlassianClient(auth);
-	const issue = await fetchIssue(client, auth.site, src.key);
-	const stale = issue.updated !== src.updated;
-	const { local, external } = classifyImages(src.body);
-	const lossy = findLossyNodes(issue.description, JIRA_LOSSY_LABELS);
-	const newSummary = options.summary && src.bodyTitle ? src.bodyTitle : issue.summary;
-	if (options.dryRun) {
-		printDryRun(src.key, issue.summary, newSummary, stale, external.length, local, lossy);
-		return;
-	}
-	if (local.length > 0) throw new Error(`jira update does not support image changes yet. Remove local image reference(s) or edit text only: ${local.join(", ")}`);
-	if (stale && !options.force) throw new Error(`Issue changed on the server since you copied it (local ${src.updated || "unknown"}, server ${issue.updated}). Re-copy the issue or pass --force.`);
-	if (lossy.size > 0 && !options.force) {
-		if (!await confirm({
-			message: `This issue's description contains ${formatLossy(lossy)} that Markdown cannot represent and will be removed. Continue?`,
-			default: false
-		})) {
-			console.log("Aborted.");
-			return;
-		}
-	}
-	const description = markdownToAdf(src.body);
-	if (!description.content || description.content.length === 0) throw new Error("Refusing to update: the converted description is empty.");
-	await updateIssue(client, src.key, {
-		description,
-		summary: options.summary && newSummary !== issue.summary ? newSummary : void 0
+	const plan = planIssueUpdate(src, await fetchIssue(client, auth.site, src.key), options);
+	await runPlan(plan, options, async () => {
+		const { current, next } = plan.headline;
+		await updateIssue(client, src.key, {
+			description: plan.body,
+			summary: next !== current ? next : void 0
+		});
+		console.log(`Updated ${src.key}.`);
 	});
-	console.log(`Updated ${src.key}.`);
 }
 async function jiraSearch(query, options) {
 	if (options.jql && (query || options.project || options.assignee || options.status)) throw new Error("--jql cannot be combined with a text query or other filters.");
@@ -1803,8 +2272,8 @@ async function jiraSearch(query, options) {
 	});
 	await runSearch(issues.map((i) => ({
 		id: i.key,
-		prefix: `${i.key}  ${i.status}`,
-		text: i.summary,
+		fixedColumns: `${i.key}  ${i.status}`,
+		freeText: i.summary,
 		json: {
 			key: i.key,
 			status: i.status,
@@ -1814,80 +2283,59 @@ async function jiraSearch(query, options) {
 	})), {
 		json: options.json,
 		copy: options.copy,
-		limit,
-		hasMore: issues.length === limit,
-		out: options.out
-	}, {
-		singular: "issue",
-		plural: "issues"
-	}, (key) => copyIssue(client, auth.site, key, options.out));
-}
-async function copyIssue(client, site, key, out) {
-	console.log(`Fetching ${key} ...`);
-	const issue = await fetchIssue(client, site, key);
-	const target = resolveOutput(issue.key, out);
-	const downloaded = await downloadAttachments(client, issue.attachments, target.assetsDir, target.assetsDirName);
-	const resolveMedia = mediaResolver(downloaded);
-	const document = joinSections([
-		frontmatter({
-			key: issue.key,
-			type: issue.type,
-			status: issue.status,
-			assignee: issue.assignee,
-			reporter: issue.reporter,
-			priority: issue.priority,
-			labels: issue.labels,
-			created: issue.created,
-			updated: issue.updated,
-			url: issue.url
-		}),
-		`# ${issue.summary}`,
-		adfToMarkdown(issue.description, { resolveMedia }),
-		commentsSection(issue.comments, resolveMedia),
-		attachmentsSection(downloaded)
-	]);
-	await writeFile(target.filePath, document, "utf8");
-	report(target.filePath, downloaded.length);
+		out: options.out,
+		empty: "No matching issues.",
+		footer: issues.length === limit ? searchFooter(limit) : void 0
+	}, ISSUE_NOUN, (key) => copyIssue(client, auth.site, key, options.out));
 }
-async function resolveKey(arg) {
-	const raw = arg ?? await input({
-		message: "Jira issue key or URL:",
-		required: true
+async function jiraList(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 { issues, truncated } = await listAssignedIssues(client, auth.site, {
+		all: options.all,
+		project: options.project
 	});
-	const key = parseIssueKey(raw);
-	if (!key) throw new Error(`Could not find an issue key in "${raw}" (expected e.g. PROJ-123).`);
-	return key;
-}
-function report(filePath, assetCount) {
-	const suffix = assetCount > 0 ? ` (+${assetCount} attachment${assetCount === 1 ? "" : "s"})` : "";
-	console.log(`Wrote ${filePath}${suffix}`);
-}
-function classifyImages(md) {
-	const local = [];
-	const external = [];
-	const seen = /* @__PURE__ */ new Set();
-	marked.walkTokens(marked.lexer(md), (token) => {
-		if (token.type !== "image") return;
-		const href = token.href;
-		if (seen.has(href)) return;
-		seen.add(href);
-		if (/^[a-z][a-z0-9+.-]*:\/\//i.test(href)) external.push(href);
-		else local.push(href);
+	await runSearch(formatListRows(sortByCategoryThenUpdated(issues), Date.now()), {
+		json: options.json,
+		copy: options.copy,
+		out: options.out,
+		empty: options.all ? "No issues assigned to you." : "No open issues assigned to you.",
+		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 }
+		};
 	});
-	return {
-		local,
-		external
-	};
 }
-function printDryRun(key, currentSummary, newSummary, stale, externalImages, localImages, lossy) {
-	console.log(`Dry run for ${key} "${currentSummary}"`);
-	if (newSummary !== currentSummary) console.log(`  summary: "${currentSummary}" -> "${newSummary}"`);
-	if (externalImages > 0) console.log(`  images:  ${externalImages} external`);
-	if (localImages.length > 0) console.log(`  blocked: ${localImages.length} local image(s) not supported (edit text only)`);
-	if (lossy.size > 0) console.log(`  warning: ${formatLossy(lossy)} will be removed`);
-	if (stale) console.log(`  stale:   server changed since copy (would refuse without --force)`);
-	console.log("  nothing was written (dry run)");
+const ISSUE_NOUN = {
+	singular: "issue",
+	plural: "issues"
+};
+async function copyIssue(client, site, key, out) {
+	console.log(`Fetching ${key} ...`);
+	await runCopy(planIssueCopy(await fetchIssue(client, site, key), out), (url) => client.getBinary(url));
 }
+const ISSUE_REF = {
+	message: "Jira issue key or URL:",
+	parse: parseIssueKey,
+	notFound: (raw) => `Could not find an issue key in "${raw}" (expected e.g. PROJ-123).`
+};
+//#endregion
+//#region package.json
+var version = "1.8.0";
 //#endregion
 //#region src/cli.ts
 const program = new Command();
@@ -1899,8 +2347,10 @@ auth.command("status").description("Show the current login").action(run(status))
 const jira = program.command("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("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));
 jira.command("search [query]").description("Search Jira issues (text query, filters, or --jql)").option("-p, --project <key>", "limit to a project").option("-a, --assignee <who>", "limit to an assignee (or 'me')").option("-s, --status <status>", "limit to a status").option("--jql <jql>", "raw JQL 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(jiraSearch));
 const confluence = program.command("confluence").description("Confluence commands");
 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));
@@ -1912,6 +2362,7 @@ bitbucket.command("logout").description("Remove stored Bitbucket credentials").a
 bitbucket.command("status").description("Show the current Bitbucket login").action(run(bitbucketStatus));
 bitbucket.command("pipelines").description("List recent pipeline runs for a repo").option("-r, --repo <repo>", "workspace/slug, or a bare slug (defaults to config)").option("-l, --limit <n>", "max results (default 25, max 100)").option("--json", "output results as JSON").action(run(bitbucketPipelines));
 bitbucket.command("pipeline <number>").description("Show one pipeline run and its steps").option("-r, --repo <repo>", "workspace/slug, or a bare slug (defaults to config)").action(run(bitbucketPipeline));
+const SIGINT_EXIT_CODE = 130;
 program.parseAsync().catch(fail);
 function run(fn) {
 	return async (...args) => {
@@ -1923,9 +2374,12 @@ function run(fn) {
 	};
 }
 function fail(err) {
-	if (err instanceof Error && err.name === "ExitPromptError") process.exit(130);
+	if (isPromptInterrupt(err)) process.exit(SIGINT_EXIT_CODE);
 	console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
 	process.exit(1);
 }
+function isPromptInterrupt(err) {
+	return err instanceof Error && err.name === "ExitPromptError";
+}
 //#endregion
 export {};