atlass 2.0.0 → 2.2.0

package/dist/{build-DMLlCHdF.mjs → build-H7eTLrf3.mjs}

@@ -10,6 +10,7 @@ import kleur from "kleur";
 import { common, createLowlight } from "lowlight";
 import { marked } from "marked";
 import { randomUUID } from "node:crypto";
+import { structuredPatch } from "diff";
 //#region src/api/http-error.ts
 var HttpError = class extends Error {
 	status;
@@ -28,7 +29,7 @@ var HttpError = class extends Error {
 };
 function httpError(status, path, body, loginHint) {
 	if (status === 401 || status === 403) return new HttpError(status, `Authentication failed (401/403). Run \`${loginHint}\` to update your token.`, void 0, path);
-	if (status === 404) return new HttpError(status, `Not found (404): ${path}`);
+	if (status === 404) return new HttpError(status, `Not found (404): ${path}`, void 0, path);
 	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): ${extractErrorMessage(body) || path}`, jiraErrors(body));
@@ -119,6 +120,12 @@ var AtlassianClient = class {
 			body: JSON.stringify(body)
 		});
 	}
+	async deleteNoContent(path) {
+		await this.request(path, {
+			method: "DELETE",
+			headers: { Accept: "application/json" }
+		});
+	}
 	async postMultipart(path, filename, bytes) {
 		const form = new FormData();
 		const blob = new Blob([bytes]);
@@ -440,14 +447,58 @@ function guarded(fn) {
 	};
 }
 function fail(err) {
-	if (isPromptInterrupt(err)) process.exit(SIGINT_EXIT_CODE);
+	if (isPromptInterrupt(err)) {
+		process.exitCode = SIGINT_EXIT_CODE;
+		return;
+	}
 	ttyTerminal().err(`Error: ${err instanceof Error ? err.message : String(err)}`);
-	process.exit(1);
+	process.exitCode = 1;
 }
 function isPromptInterrupt(err) {
 	return err instanceof Error && err.name === "ExitPromptError";
 }
 //#endregion
+//#region src/util/format.ts
+function formatDuration(seconds) {
+	if (seconds == null) return "-";
+	if (seconds < 60) return `${seconds}s`;
+	const m = Math.floor(seconds / 60);
+	const s = seconds % 60;
+	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`;
+}
+const pad = (n) => String(n).padStart(2, "0");
+function formatDate$1(iso) {
+	const date = new Date(iso);
+	if (Number.isNaN(date.getTime())) return iso;
+	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+function formatDateTime(iso) {
+	const date = new Date(iso);
+	if (Number.isNaN(date.getTime())) return iso;
+	return `${formatDate$1(iso)} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+const MINUTE = 60;
+const HOUR = 3600;
+const DAY = 24 * HOUR;
+function relativeTime(iso, nowMs) {
+	if (!iso) return "-";
+	const then = Date.parse(iso);
+	if (Number.isNaN(then)) return "-";
+	const secs = Math.floor((nowMs - then) / 1e3);
+	if (secs < MINUTE) return "just now";
+	if (secs < HOUR) return `${Math.floor(secs / MINUTE)}m ago`;
+	if (secs < DAY) return `${Math.floor(secs / HOUR)}h ago`;
+	const days = Math.floor(secs / DAY);
+	if (days < 45) return `${days}d ago`;
+	if (days < 365) return `${Math.floor(days / 30)}mo ago`;
+	return `${Math.floor(days / 365)}y ago`;
+}
+function orList(items) {
+	if (items.length < 3) return items.join(" or ");
+	return `${items.slice(0, -1).join(", ")}, or ${items.at(-1)}`;
+}
+//#endregion
 //#region src/util/parse.ts
 function parseIssueKey(input) {
 	const match = input.toUpperCase().match(/[A-Z][A-Z0-9]+-\d+/);
@@ -462,6 +513,13 @@ function parsePageId(input) {
 	if (fromQuery) return fromQuery[1];
 	return null;
 }
+function parseBoardId(input) {
+	const trimmed = input.trim();
+	if (/^\d+$/.test(trimmed)) return Number(trimmed);
+	if (!/^https?:\/\//i.test(trimmed)) return null;
+	const match = trimmed.match(/\/boards\/(\d+)(?:[/?#]|$)/) ?? trimmed.match(/[?&]rapidView=(\d+)/);
+	return match ? Number(match[1]) : null;
+}
 const PULL_REQUEST_HOSTS = ["bitbucket.org", "www.bitbucket.org"];
 const PULL_REQUEST_PATH = /^\/([^/]+)\/([^/]+)\/pull-requests\/(\d+)(?:\/|$)/;
 function parsePullRequestRef(input) {
@@ -515,6 +573,19 @@ 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\`.`);
 }
+function parseChoices(values, choices, flag) {
+	const picked = /* @__PURE__ */ new Set();
+	const raw = (values ?? []).flatMap((v) => v.split(",")).map((v) => v.trim());
+	for (const value of raw.filter(Boolean)) {
+		const choice = choices.find((c) => c.toLowerCase() === value.toLowerCase());
+		if (!choice) {
+			const expected = orList(choices.map((c) => c.toLowerCase()));
+			throw new Error(`Invalid ${flag} "${value}". Expected ${expected}.`);
+		}
+		picked.add(choice);
+	}
+	return choices.filter((c) => picked.has(c));
+}
 const DEFAULT_LIMIT = 25;
 const MAX_LIMIT = 100;
 function parseLimit(value) {
@@ -761,15 +832,7 @@ const PULL_REQUEST_STATES = [
 	"SUPERSEDED"
 ];
 function parsePullRequestStates(values) {
-	const raw = (values ?? []).flatMap((value) => value.split(","));
-	const states = [];
-	for (const value of raw) {
-		const state = value.trim().toUpperCase();
-		if (!state) continue;
-		if (!PULL_REQUEST_STATES.includes(state)) throw new Error(`Invalid --state "${value.trim()}". Expected ${PULL_REQUEST_STATES.map((s) => s.toLowerCase()).join(", ").replace(/, (?=[^,]*$)/, ", or ")}.`);
-		if (!states.includes(state)) states.push(state);
-	}
-	return states;
+	return parseChoices(values, PULL_REQUEST_STATES, "--state");
 }
 function allPullRequestStates() {
 	return [...PULL_REQUEST_STATES];
@@ -935,43 +998,6 @@ async function listChangedFiles(client, ref, id) {
 	return collectCapped(client, `${pullRequestPath(ref, id, "diffstat")}?pagelen=${PAGELEN}`, 50, toChangedFile);
 }
 //#endregion
-//#region src/util/format.ts
-function formatDuration(seconds) {
-	if (seconds == null) return "-";
-	if (seconds < 60) return `${seconds}s`;
-	const m = Math.floor(seconds / 60);
-	const s = seconds % 60;
-	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`;
-}
-const pad = (n) => String(n).padStart(2, "0");
-function formatDate$1(iso) {
-	const date = new Date(iso);
-	if (Number.isNaN(date.getTime())) return iso;
-	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
-}
-function formatDateTime(iso) {
-	const date = new Date(iso);
-	if (Number.isNaN(date.getTime())) return iso;
-	return `${formatDate$1(iso)} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
-}
-const MINUTE = 60;
-const HOUR = 3600;
-const DAY = 24 * HOUR;
-function relativeTime(iso, nowMs) {
-	if (!iso) return "-";
-	const then = Date.parse(iso);
-	if (Number.isNaN(then)) return "-";
-	const secs = Math.floor((nowMs - then) / 1e3);
-	if (secs < MINUTE) return "just now";
-	if (secs < HOUR) return `${Math.floor(secs / MINUTE)}m ago`;
-	if (secs < DAY) return `${Math.floor(secs / HOUR)}h ago`;
-	const days = Math.floor(secs / DAY);
-	if (days < 45) return `${days}d ago`;
-	if (days < 365) return `${Math.floor(days / 30)}mo ago`;
-	return `${Math.floor(days / 365)}y ago`;
-}
-//#endregion
 //#region src/commands/bitbucket-comments.ts
 const MENTION = /@\{([^}]+)\}/g;
 function renderedPrComments(comments, participants) {
@@ -1369,7 +1395,7 @@ function link(text, url) {
 //#endregion
 //#region src/commands/view.ts
 const INDENT = "  ";
-function fieldLines(pairs) {
+function fieldLines$1(pairs) {
 	const kept = pairs.filter(([, value]) => value !== "");
 	const width = Math.max(...kept.map(([label]) => label.length)) + 1;
 	return kept.map(([label, value]) => `${kleur.dim(`${label}:`.padEnd(width))}  ${value}`);
@@ -1456,7 +1482,7 @@ function formatPullRequestView(detail, comments, files, nowMs, allComments = fal
 	const label = detail.draft ? "DRAFT" : detail.state || "-";
 	return [
 		kleur.bold(detail.title),
-		...fieldLines([
+		...fieldLines$1([
 			["State", colorForBitbucketState(label)(label)],
 			["Author", detail.author],
 			["Branch", branchLine(detail)],
@@ -1573,6 +1599,7 @@ function alignedRows(items, nowMs, cells) {
 		const cell = cells(item);
 		return {
 			...cell,
+			columns: cell.columns ?? [],
 			age: relativeTime(cell.timestamp, nowMs),
 			json: { ...item }
 		};
@@ -1580,11 +1607,17 @@ function alignedRows(items, nowMs, cells) {
 	const width = (pick) => Math.max(...rows.map((row) => pick(row).length));
 	const idWidth = width((row) => row.id);
 	const labelWidth = width((row) => row.label);
+	const columnWidths = (rows[0]?.columns ?? []).map((_, i) => width((row) => row.columns[i]));
 	const ageWidth = width((row) => row.age);
 	return rows.map((row) => ({
 		id: row.id,
 		url: row.url,
-		fixedColumns: `${row.id.padEnd(idWidth)}  ${row.color(row.label.padEnd(labelWidth))}  ${row.age.padEnd(ageWidth)}`,
+		fixedColumns: [
+			row.id.padEnd(idWidth),
+			row.color(row.label.padEnd(labelWidth)),
+			...row.columns.map((column, i) => column.padEnd(columnWidths[i])),
+			row.age.padEnd(ageWidth)
+		].join("  "),
 		freeText: row.text,
 		json: row.json
 	}));
@@ -1887,128 +1920,227 @@ function moved(flags, command) {
 		throw new Error(`${flag} is now its own command: \`atlass ${command} "<query>"\`.`);
 	});
 }
-function outputOptions(command) {
-	return command.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");
+function outputOptions(command, limitHelp = "max results (default 25, max 100)") {
+	return command.option("-l, --limit <n>", limitHelp).option("--json", "output results as JSON").option("-c, --copy", "pick results to copy to Markdown").option("-o, --out <dir>", "output directory for --copy");
 }
 //#endregion
-//#region src/api/query.ts
-function quote$1(value) {
-	return `"${value.replace(/(["\\])/g, "\\$1")}"`;
+//#region src/api/confluence-create.ts
+async function findSpaceId(client, key) {
+	return (await client.getJson(`/wiki/api/v2/spaces?keys=${encodeURIComponent(key)}`)).results[0]?.id ?? null;
 }
-function values(given) {
-	return (given ?? []).map((v) => v.trim()).filter((v) => v.length > 0);
+async function createPage(client, page) {
+	const res = await client.postJson("/wiki/api/v2/pages", {
+		spaceId: page.spaceId,
+		status: "current",
+		title: page.title,
+		...page.parentId ? { parentId: page.parentId } : {},
+		body: {
+			representation: "atlas_doc_format",
+			value: JSON.stringify(page.body)
+		}
+	});
+	return {
+		id: res.id,
+		version: res.version?.number ?? 1
+	};
 }
-function inClause(field, given) {
-	return renderClause(field, values(given).map(quote$1));
+//#endregion
+//#region src/api/confluence-attachments.ts
+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 userClause(field, given) {
-	return renderClause(field, values(given).map((v) => v === "me" ? "currentUser()" : quote$1(v)));
+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);
 }
-function renderClause(field, rendered) {
-	if (rendered.length === 0) return null;
-	if (rendered.length === 1) return `${field} = ${rendered[0]}`;
-	return `${field} in (${rendered.join(", ")})`;
+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 joinClauses(clauses, order) {
-	return `${clauses.filter((c) => c !== null).join(" AND ")} ORDER BY ${order}`;
+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 ?? "")
+	}));
 }
-//#endregion
-//#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;
-		}
-		return NAMED[body.toLowerCase()] ?? match;
-	});
+function mediaNodeId(a) {
+	return a.fileId ?? a.id;
 }
-function isCodePoint(code) {
-	return Number.isFinite(code) && code >= 0 && code <= MAX_CODE_POINT;
+function withWikiContextPath(link) {
+	if (link.startsWith("http") || link.startsWith("/wiki")) return link;
+	return `/wiki${link}`;
 }
 //#endregion
-//#region src/api/confluence-search.ts
-async function searchPages(client, site, params) {
-	return searchPagesByCql(client, site, buildCql(params), params.limit);
-}
-async function searchPagesByCql(client, site, cql, limit) {
-	const query = new URLSearchParams({
-		cql,
-		limit: String(limit),
-		expand: "content.space"
-	});
-	const results = (await client.getJson(`/wiki/rest/api/search?${query.toString()}`)).results ?? [];
-	const serverPageWasFull = results.length === limit;
+//#region src/api/confluence-pages.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 {
-		pages: results.filter((r) => r.content?.id).map((r) => ({
-			id: r.content?.id ?? "",
-			space: r.content?.space?.key ?? spaceKeyOf(r.resultGlobalContainer?.displayUrl),
-			title: decodeEntities(r.content?.title ?? r.title ?? ""),
-			updated: r.lastModified ?? "",
-			url: r.url ? `${site}/wiki${r.url}` : ""
-		})),
-		hasMore: serverPageWasFull
+		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
 	};
 }
-const SPACE_URL = /\/spaces\/([^/?#]+)/;
-function spaceKeyOf(displayUrl) {
-	return SPACE_URL.exec(displayUrl ?? "")?.[1] ?? "";
-}
-function buildCql(params) {
-	return joinClauses([
-		"type = page",
-		params.starred ? "favourite = currentUser()" : null,
-		inClause("space", params.space),
-		inClause("label", params.label),
-		params.updatedSince ? `lastmodified >= ${quote$1(params.updatedSince)}` : null,
-		params.text ? `text ~ ${quote$1(params.text)}` : null
-	], "lastmodified DESC");
-}
-//#endregion
-//#region src/adf/from-markdown.ts
-function mediaNode(source, alt) {
-	const attrs = { ...source };
-	if (alt) attrs["alt"] = alt;
+async function fetchPageState(client, id) {
+	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
 	return {
-		type: "mediaSingle",
-		attrs: { layout: "center" },
-		content: [{
-			type: "media",
-			attrs
-		}]
+		version: page.version?.number ?? 0,
+		title: page.title,
+		body: parseAdfJson(page.body?.atlas_doc_format?.value)
 	};
 }
-function imageHrefs(md) {
-	const hrefs = /* @__PURE__ */ new Set();
-	marked.walkTokens(marked.lexer(md), (token) => {
-		if (token.type === "image") hrefs.add(token.href);
+async function updatePage(client, id, params) {
+	const res = 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
+		}
 	});
-	return [...hrefs];
-}
-function markdownToAdf(md, options = {}) {
-	const ctx = { resolveImage: options.resolveImage ?? externalMedia };
 	return {
-		type: "doc",
-		version: 1,
-		content: blocks(marked.lexer(md), ctx)
+		number: res.version?.number ?? params.nextVersion,
+		createdAt: res.version?.createdAt ?? ""
 	};
 }
-function blocks(tokens, ctx) {
-	const out = [];
-	for (const token of tokens) out.push(...block(token, ctx));
-	return out;
-}
-function block(token, ctx) {
-	switch (token.type) {
+async function fetchSpaceKey(client, spaceId) {
+	if (!spaceId) return "";
+	try {
+		return (await client.getJson(`/wiki/api/v2/spaces/${encodeURIComponent(spaceId)}`)).key ?? "";
+	} catch {
+		return "";
+	}
+}
+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 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/adf/html.ts
+const COMMENT = /<!--[\s\S]*?-->/g;
+function isOnlyComments(html) {
+	return html.replace(COMMENT, "").trim().length === 0;
+}
+function withoutComments(md) {
+	const kept = [];
+	let skipSpace = false;
+	for (const token of marked.lexer(md)) {
+		if (skipSpace && token.type === "space") continue;
+		skipSpace = token.type === "html" && isOnlyComments(token.text);
+		if (skipSpace) continue;
+		kept.push(token.type === "code" ? token.raw : token.raw.replace(COMMENT, ""));
+	}
+	return kept.join("").trim();
+}
+function htmlWarnings(md) {
+	let blocks = 0;
+	let inline = 0;
+	marked.walkTokens(marked.lexer(md), (token) => {
+		if (token.type !== "html" || isOnlyComments(token.text)) return;
+		if (token.block) blocks++;
+		else inline++;
+	});
+	return [...blocks > 0 ? [`${counted(blocks, "HTML block")} will be dropped`] : [], ...inline > 0 ? [`${counted(inline, "inline HTML tag")} will be sent as text`] : []];
+}
+function counted(n, noun) {
+	return `${n} ${noun}${n === 1 ? "" : "s"}`;
+}
+//#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 ?? externalMedia };
+	return {
+		type: "doc",
+		version: 1,
+		content: blocks(marked.lexer(md), ctx)
+	};
+}
+function blocks(tokens, ctx) {
+	const out = [];
+	for (const token of tokens) out.push(...block(token, ctx));
+	return out;
+}
+function block(token, ctx) {
+	switch (token.type) {
 		case "space": return [];
 		case "heading": return [{
 			type: "heading",
@@ -2144,7 +2276,10 @@ function inlineNode(token, ctx, marks) {
 			}));
 		}
 		case "br": return [{ type: "hardBreak" }];
-		case "html": return textNode(token.text, marks);
+		case "html": {
+			const html = token.text;
+			return isOnlyComments(html) ? [] : textNode(html, marks);
+		}
 		default: return "text" in token && token.text ? textNode(token.text, marks) : [];
 	}
 }
@@ -2178,132 +2313,301 @@ function clampLevel(value) {
 	return Math.min(6, Math.max(1, Math.trunc(value) || 1));
 }
 //#endregion
-//#region src/api/confluence-attachments.ts
-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
-	}));
+//#region src/adf/lossy.ts
+const LOSSY_LABELS = {
+	panel: "panel",
+	expand: "expand",
+	nestedExpand: "expand",
+	decisionList: "decision list",
+	layoutSection: "layout",
+	extension: "macro",
+	bodiedExtension: "macro",
+	inlineExtension: "macro"
+};
+const JIRA_LOSSY_LABELS = {
+	...LOSSY_LABELS,
+	media: "image",
+	mediaInline: "image"
+};
+function findLossyNodes(node, lossyLabels = LOSSY_LABELS) {
+	const counts = /* @__PURE__ */ new Map();
+	const visit = (n) => {
+		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;
 }
-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);
+function formatLossy(counts) {
+	return [...counts.entries()].map(([label, n]) => `${n} ${label}${n === 1 ? "" : "s"}`).join(", ");
 }
-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.`);
+//#endregion
+//#region src/update/body-diff.ts
+const CONTEXT_LINES = 3;
+function unifiedDiff(before, after, labels) {
+	if (before === after) return [];
+	const [from, to] = labels;
+	const patch = structuredPatch(from, to, `${before}\n`, `${after}\n`, void 0, void 0, { context: CONTEXT_LINES });
+	return [
+		`--- ${from}`,
+		`+++ ${to}`,
+		...patch.hunks.flatMap((h) => [`@@ -${h.oldStart},${h.oldLines} +${h.newStart},${h.newLines} @@`, ...h.lines])
+	];
 }
-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 colorDiffLine(line) {
+	if (line.startsWith("+++") || line.startsWith("---")) return kleur.bold(line);
+	if (line.startsWith("@@")) return kleur.cyan(line);
+	if (line.startsWith("+")) return kleur.green(line);
+	if (line.startsWith("-")) return kleur.red(line);
+	return line;
+}
+//#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: externalImagesOnly });
+	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),
+		warnings: htmlWarnings(source.body),
+		diff: [],
+		images,
+		uploads: [],
+		body,
+		refusals
+	}, options.force ?? false);
 }
-function mediaNodeId(a) {
-	return a.fileId ?? a.id;
+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`));
+	for (const warning of plan.warnings) lines.push(row("warning", warning));
+	if (plan.revision.stale) lines.push(row("stale", `${revisionText(plan.revision)} (would refuse without --force)`));
+	lines.push(...plan.diff.map(colorDiffLine));
+	lines.push("  nothing was written (dry run)");
+	return lines;
 }
-function withWikiContextPath(link) {
-	if (link.startsWith("http") || link.startsWith("/wiki")) return link;
-	return `/wiki${link}`;
+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(", ");
 }
-//#endregion
-//#region src/api/confluence-pages.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 ?? "";
+function row(label, value) {
+	return `  ${`${label}:`.padEnd(9)}${value}`;
+}
+function headline(label, current, title, useTitle) {
 	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
+		label,
+		current,
+		next: useTitle && title ? title : current
 	};
 }
-async function fetchPageState(client, id) {
-	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
+function revision(local, server) {
 	return {
-		version: page.version?.number ?? 0,
-		title: page.title,
-		body: parseAdfJson(page.body?.atlas_doc_format?.value)
+		local: local || "unknown",
+		server: server || "unknown",
+		stale: local !== server
 	};
 }
-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 revisionText(revision) {
+	return `copied at ${revision.local}, server now ${revision.server}`;
 }
-async function fetchSpaceKey(client, spaceId) {
-	if (!spaceId) return "";
-	try {
-		return (await client.getJson(`/wiki/api/v2/spaces/${encodeURIComponent(spaceId)}`)).key ?? "";
-	} catch {
-		return "";
-	}
+function externalImagesOnly(href, alt) {
+	return isExternalHref(href) ? externalMedia(href, alt) : void 0;
 }
-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 missingImagesRefusal(missing) {
+	return missing.length > 0 ? [`Image file(s) not found: ${missing.join(", ")}`] : [];
 }
-function parseAdfJson(value) {
-	if (!value) return null;
+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/plan-page.ts
+function planPageBody(page, attachments, localImages) {
+	const collection = `contentId-${page.id}`;
+	const images = imageHrefs(page.body).map((href) => pageImage(href, localImages, attachments));
+	const byHref = new Map(images.map((e) => [e.href, e]));
+	return {
+		images,
+		body: markdownToAdf(page.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);
+		} }),
+		uploads: images.flatMap((e) => e.kind === "upload" || e.kind === "changed" ? [{
+			href: e.href,
+			path: e.path,
+			filename: e.filename
+		}] : [])
+	};
+}
+function planPageUpdate(source, state, attachments, localImages, options) {
+	const { images, body, uploads } = planPageBody(source, attachments, localImages);
+	const missing = images.filter((e) => e.kind === "missing").map((e) => e.href);
+	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),
+		warnings: htmlWarnings(source.body),
+		diff: unifiedDiff(serverMarkdown(state, attachments, images), withoutComments(source.body), [`server v${state.version}`, options.file]),
+		images: images.map(({ href, kind }) => ({
+			href,
+			kind
+		})),
+		uploads,
+		body,
+		refusals: [...missingImagesRefusal(missing), ...emptyBodyRefusal(body)]
+	}, options.force ?? false);
+}
+function serverMarkdown(state, attachments, images) {
+	const reused = new Map(images.flatMap((e) => e.kind === "reuse" ? [[e.fileId, e.href]] : []));
+	return adfToMarkdown(state.body, { resolveMedia: ({ id }) => reused.get(id ?? "") ?? attachments.find((a) => a.fileId === id)?.filename });
+}
+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 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/commands/confluence-push.ts
+async function pushPage({ session, term, files }, content, push) {
+	const ids = /* @__PURE__ */ new Map();
+	for (const upload of content.uploads) {
+		term.err(`Uploading ${upload.filename} ...`);
+		const bytes = await files.readBytes(upload.path);
+		ids.set(upload.href, await uploadAttachment(session, push.id, upload.filename, bytes));
+	}
+	return updatePage(session, push.id, {
+		title: content.title,
+		nextVersion: push.nextVersion,
+		body: withUploadedIds(content.body, ids),
+		message: push.message
+	});
+}
+async function statLocalImages(files, 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(files, path)
+		};
+	}));
+}
+async function fileSize(files, path) {
 	try {
-		return JSON.parse(value);
+		return { size: await files.size(path) };
 	} catch {
-		return null;
+		return {};
 	}
 }
-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/api/confluence-favourites.ts
+function favouritePath(id) {
+	return `/wiki/rest/api/relation/favourite/from/user/current/to/content/${encodeURIComponent(id)}`;
+}
+async function starPage(client, id) {
+	await client.putNoContent(favouritePath(id), void 0);
+}
+async function unstarPage(client, id) {
+	await client.deleteNoContent(favouritePath(id));
+}
 //#endregion
 //#region src/commands/resolve-ref.ts
 async function resolveRef(ask, arg, kind) {
@@ -2316,43 +2620,138 @@ async function resolveRef(ask, arg, kind) {
 	if (!ref) throw new Error(kind.notFound(raw));
 	return ref;
 }
+function layoutOf(raw) {
+	return {
+		bom: raw.startsWith(""),
+		crlf: /\r?\n/.exec(raw)?.[0] === "\r\n"
+	};
+}
+function normalized(raw) {
+	return (raw.startsWith("") ? raw.slice(1) : raw).replace(/\r\n/g, "\n");
+}
+function editKeepingLayout(raw, edit) {
+	return withLayout(edit(normalized(raw)), layoutOf(raw));
+}
+function withLayout(text, layout) {
+	const lines = layout.crlf ? text.replace(/\n/g, "\r\n") : text;
+	return layout.bom ? `${lines}` : lines;
+}
 //#endregion
-//#region src/api/attachments.ts
-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);
+//#region src/markdown/frontmatter.ts
+const BLOCK = /^---\n([\s\S]*?)\n---\n?/;
+const KEY = /^([A-Za-z0-9_]+):\s*(.*)$/;
+const LIST_ITEM = /^ {2}- (.*)$/;
+const BARE_NUMBER = /^-?\d+(\.\d+)?$/;
+function splitFrontmatter(text) {
+	const match = text.match(BLOCK);
+	if (!match) return null;
+	return {
+		fields: parseFields(match[1] ?? ""),
+		rest: text.slice(match[0].length)
 	};
 }
+function formatFrontmatter(fields) {
+	return [
+		"---",
+		...Object.entries(fields).flatMap(([key, value]) => fieldLines(key, value)),
+		"---"
+	].join("\n");
+}
+function rewriteFields(raw, fields) {
+	return editKeepingLayout(raw, (text) => withFields(text, fields));
+}
+function withFields(text, fields) {
+	const match = text.match(BLOCK);
+	if (!match) return `${formatFrontmatter(fields)}\n\n${text}`;
+	const lines = (match[1] ?? "").split("\n");
+	const pending = new Map(Object.entries(fields));
+	const kept = [];
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i] ?? "";
+		const key = line.match(KEY)?.[1];
+		const value = key === void 0 ? void 0 : pending.get(key);
+		if (key === void 0 || value === void 0) {
+			kept.push(line);
+			continue;
+		}
+		kept.push(...fieldLines(key, value));
+		pending.delete(key);
+		while (LIST_ITEM.test(lines[i + 1] ?? "")) i++;
+	}
+	for (const [key, value] of pending) kept.push(...fieldLines(key, value));
+	const closing = match[0].endsWith("\n") ? "\n" : "";
+	return `---\n${kept.join("\n")}\n---${closing}${text.slice(match[0].length)}`;
+}
+function fieldLines(key, value) {
+	if (Array.isArray(value)) return value.length === 0 ? [`${key}: []`] : [`${key}:`, ...value.map((v) => `  - ${quote$1(v)}`)];
+	return [`${key}: ${typeof value === "number" ? value : quote$1(value)}`];
+}
+function parseFields(block) {
+	const fields = {};
+	const lines = block.split("\n");
+	for (let i = 0; i < lines.length; i++) {
+		const m = lines[i]?.match(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(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$1(value) {
+	return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
+}
+function unquote(value) {
+	if (!value.startsWith("\"") || !value.endsWith("\"")) return value;
+	return value.slice(1, -1).replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
+}
 //#endregion
 //#region src/markdown/copied-document.ts
+const GENERATED_MARKER = "<!-- atlass:generated -->";
 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*$/;
+const LEGACY_SECTION_HEADING = /^## (Comments|Attachments)\s*$/;
 function render(doc) {
 	return `${[
-		frontmatter(doc.fields),
+		formatFrontmatter(doc.fields),
 		`# ${doc.title}`,
 		doc.body,
+		GENERATED_MARKER,
 		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");
+function parse(raw) {
+	const split = splitFrontmatter(normalized(raw));
+	if (!split) throw new Error("Not an atlass file: no YAML frontmatter found.");
+	return sourceOf(split, "marker-or-legacy-heading");
+}
+function parseDraft(raw) {
+	const text = normalized(raw);
+	return sourceOf(splitFrontmatter(text) ?? {
+		fields: {},
+		rest: text
+	}, "marker");
+}
+function withGeneratedMarker(text) {
+	if (text.split("\n").some(isMarker)) return text;
+	return `${text.trimEnd()}\n\n${GENERATED_MARKER}\n`;
+}
+function sourceOf({ fields, rest }, ending) {
+	const lines = rest.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 end = bodyEnd(lines, start, ending);
 	const fallbackTitle = typeof fields["title"] === "string" ? fields["title"] : "";
 	return {
 		fields,
@@ -2388,45 +2787,6 @@ function scalarString(value) {
 	if (typeof value === "number") return String(value);
 	return "";
 }
-function frontmatter(fields) {
-	const lines = ["---"];
-	for (const [key, value] of Object.entries(fields)) if (Array.isArray(value)) {
-		if (value.length === 0) lines.push(`${key}: []`);
-		else lines.push(`${key}:`, ...value.map((v) => `  - ${quote(v)}`));
-	} else if (typeof value === "number") lines.push(`${key}: ${value}`);
-	else lines.push(`${key}: ${quote(value)}`);
-	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 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 {
@@ -2437,6 +2797,16 @@ function leadingH1(lines) {
 	}
 	return null;
 }
+function bodyEnd(lines, start, ending) {
+	const after = (test) => lines.findIndex((line, i) => i >= start && test(line));
+	const marker = after(isMarker);
+	if (marker !== -1) return marker;
+	const legacy = ending === "marker" ? -1 : after((line) => LEGACY_SECTION_HEADING.test(line));
+	return legacy === -1 ? lines.length : legacy;
+}
+function isMarker(line) {
+	return line.trimEnd() === GENERATED_MARKER;
+}
 function commentsSection(comments) {
 	if (comments.length === 0) return "";
 	const blocks = comments.map((c) => {
@@ -2459,6 +2829,44 @@ function attachmentsSection(attachments) {
 	].join("\n");
 }
 //#endregion
+//#region src/commands/page-ref.ts
+const PAGE_REF = {
+	message: "Confluence page id or URL:",
+	flag: "[page]",
+	parse: parsePageId,
+	notFound: (raw) => `Could not find a page id in "${raw}".`
+};
+async function pageIdOrFile({ term, files }, arg) {
+	if (!arg?.endsWith(".md")) return resolveRef(term.ask, arg, PAGE_REF);
+	const id = scalarString(parse(await files.readText(arg)).fields["id"]);
+	if (!id) throw new Error(`${arg} has no page \`id\` in its frontmatter.`);
+	return id;
+}
+//#endregion
+//#region src/commands/confluence-star.ts
+async function confluenceStar(env, arg) {
+	await starById(env, await pageIdOrFile(env, arg));
+}
+async function starById({ session, term }, id) {
+	await starPage(session, id);
+	term.out(`Starred page ${id}.`);
+}
+async function confluenceUnstar(env, arg) {
+	const id = await pageIdOrFile(env, arg);
+	await unstarPage(env.session, id);
+	env.term.out(`Unstarred page ${id}.`);
+}
+//#endregion
+//#region src/api/attachments.ts
+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/copy/plan.ts
 function planIssueCopy(issue, out) {
 	return planCopy({
@@ -2481,19 +2889,22 @@ function planIssueCopy(issue, out) {
 		attachments: issue.attachments
 	}, out);
 }
+function pageFields(page) {
+	return {
+		title: page.title,
+		id: page.id,
+		space: page.spaceKey,
+		version: page.version,
+		author: page.author,
+		created: page.createdAt,
+		updated: page.updatedAt,
+		url: page.url
+	};
+}
 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
-		},
+		fields: pageFields(page),
 		title: page.title,
 		body: page.body,
 		comments: page.comments,
@@ -2564,246 +2975,240 @@ function numberedName(name, suffix) {
 	return `${dot > 0 ? name.slice(0, dot) : name}-${suffix}${dot > 0 ? name.slice(dot) : ""}`;
 }
 //#endregion
-//#region src/copy/run.ts
-async function runCopy(env, plan) {
-	const landed = await download(env, plan);
-	await env.files.writeText(plan.filePath, renderCopy(plan, landed));
-	env.term.out(wroteLine(plan.filePath, landed.length));
-}
-async function download({ term, files, session }, plan) {
-	const landed = [];
-	for (const { path, ...attachment } of plan.downloads) try {
-		await files.writeBytes(path, await session.getBinary(attachment.url));
-		landed.push(attachment);
-	} catch (err) {
-		term.err(`  ! could not download ${attachment.filename}: ${err.message}`);
-	}
-	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",
-	nestedExpand: "expand",
-	decisionList: "decision list",
-	layoutSection: "layout",
-	extension: "macro",
-	bodiedExtension: "macro",
-	inlineExtension: "macro"
-};
-const JIRA_LOSSY_LABELS = {
-	...LOSSY_LABELS,
-	media: "image",
-	mediaInline: "image"
-};
-function findLossyNodes(node, lossyLabels = LOSSY_LABELS) {
-	const counts = /* @__PURE__ */ new Map();
-	const visit = (n) => {
-		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;
-}
-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) => ({
+//#region src/create/page-plan.ts
+function planPageCreate(draft, target, localImages) {
+	const images = imageHrefs(draft.body).map((href) => ({
 		href,
-		kind: isExternalHref(href) ? "external" : "unsupported"
+		kind: imageKind(href, localImages)
 	}));
-	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),
+	const missing = images.filter((i) => i.kind === "missing").map((i) => i.href);
+	return {
+		...target,
+		title: draft.title,
 		images,
-		uploads: [],
-		body,
-		refusals
-	}, options.force ?? false);
+		body: markdownToAdf(draft.body, { resolveImage: externalImagesOnly }),
+		warnings: htmlWarnings(draft.body),
+		refusals: [
+			...draft.title ? [] : ["No title. Add an H1 or a `title` to the frontmatter."],
+			...spaceRefusal(target),
+			...missingImagesRefusal(missing)
+		]
+	};
 }
-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}"`));
+function formatCreatePlan(plan) {
+	const lines = [`Dry run for new page "${plan.title}"`];
+	if (plan.spaceId) lines.push(row("space", plan.space));
+	lines.push(row("parent", plan.parentId ?? "space homepage"));
 	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)`));
+	for (const warning of plan.warnings) lines.push(row("warning", warning));
 	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 imageKind(href, localImages) {
+	if (isExternalHref(href)) return "external";
+	return localImages.find((l) => l.href === href)?.size === void 0 ? "missing" : "upload";
 }
-function row(label, value) {
-	return `  ${`${label}:`.padEnd(9)}${value}`;
+function spaceRefusal({ space, spaceId }) {
+	if (!space) return ["No space. Pass --space or add `space` to the frontmatter."];
+	return spaceId ? [] : [`Space "${space}" not found.`];
 }
-function headline(label, current, title, useTitle) {
-	return {
-		label,
-		current,
-		next: useTitle && title ? title : current
+//#endregion
+//#region src/commands/confluence-create.ts
+async function confluenceCreate(env, arg, options) {
+	const { session, term, files } = env;
+	const file = arg ?? await term.ask.text({
+		message: "Path to the Markdown file:",
+		flag: "[file]",
+		required: true
+	});
+	const raw = await files.readText(file);
+	const draft = parseDraft(raw);
+	const existing = scalarString(draft.fields["id"]);
+	if (existing) throw new Error(`${file} already has page id ${existing}. Use \`atlass confluence update\` instead.`);
+	const parent = parentOf(options.parent);
+	const space = options.space ?? scalarString(draft.fields["space"]);
+	const spaceId = space ? await findSpaceId(session, space) : null;
+	const localImages = await statLocalImages(files, dirname(resolve(file)), draft.body);
+	const plan = planPageCreate(draft, {
+		space,
+		spaceId,
+		...parent
+	}, localImages);
+	if (options.dryRun) term.out(formatCreatePlan(plan));
+	if (plan.refusals.length > 0 || !plan.spaceId) throw new Error(plan.refusals.join("\n"));
+	if (options.dryRun) return;
+	for (const warning of plan.warnings) term.err(`warning: ${warning}`);
+	const created = await createPage(session, {
+		...plan,
+		spaceId: plan.spaceId
+	});
+	const createdFields = {
+		title: plan.title,
+		id: created.id,
+		space,
+		version: created.version
 	};
+	await files.writeText(file, editKeepingLayout(raw, (text) => withGeneratedMarker(withFields(text, createdFields))));
+	if (plan.images.some((i) => i.kind === "upload")) await addImages(env, draft, created, localImages);
+	const page = await fetchPage(session, session.site, created.id);
+	await files.writeText(file, rewriteFields(await files.readText(file), pageFields(page)));
+	term.out(`Created page ${page.id} in ${page.spaceKey}: ${page.url}`);
+	if (options.star) await starCreated(env, page.id, file);
+}
+function parentOf(parent) {
+	if (parent === void 0) return {};
+	const parentId = parsePageId(parent);
+	if (!parentId) throw new Error(`Could not find a page id in --parent "${parent}".`);
+	return { parentId };
+}
+async function addImages(env, draft, created, localImages) {
+	const { body, uploads } = planPageBody({
+		id: created.id,
+		body: draft.body
+	}, [], localImages);
+	await pushPage(env, {
+		title: draft.title,
+		body,
+		uploads
+	}, {
+		id: created.id,
+		nextVersion: created.version + 1,
+		message: "Added images via atlass"
+	});
 }
-function revision(local, server) {
-	return {
-		local: local || "unknown",
-		server: server || "unknown",
-		stale: local !== server
-	};
+async function starCreated(env, id, file) {
+	try {
+		await starById(env, id);
+	} catch (err) {
+		const reason = err instanceof Error ? err.message : String(err);
+		throw new Error(`Created page ${id} but could not star it: ${reason}. Run \`atlass confluence star ${file}\`.`);
+	}
 }
-function revisionText(revision) {
-	return `copied at ${revision.local}, server now ${revision.server}`;
+//#endregion
+//#region src/api/query.ts
+function quote(value) {
+	return `"${value.replace(/(["\\])/g, "\\$1")}"`;
 }
-function emptyBodyRefusal(body) {
-	if (body.content && body.content.length > 0) return [];
-	return ["Refusing to update: the converted body is empty."];
+function values(given) {
+	return (given ?? []).map((v) => v.trim()).filter((v) => v.length > 0);
 }
-function withVerdict(plan, force) {
-	return {
-		...plan,
-		verdict: verdict(plan, force)
-	};
+function inClause(field, given) {
+	return renderClause(field, values(given).map(quote));
 }
-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 userClause(field, given) {
+	return renderClause(field, values(given).map((v) => v === "me" ? "currentUser()" : quote(v)));
 }
-function capitalize(text) {
-	return text.charAt(0).toUpperCase() + text.slice(1);
+function anyOf(terms) {
+	if (terms.length === 0) return null;
+	if (terms.length === 1) return terms[0];
+	return `(${terms.join(" OR ")})`;
+}
+function renderClause(field, rendered) {
+	if (rendered.length === 0) return null;
+	if (rendered.length === 1) return `${field} = ${rendered[0]}`;
+	return `${field} in (${rendered.join(", ")})`;
+}
+function joinClauses(clauses, order) {
+	return `${clauses.filter((c) => c !== null).join(" AND ")} ORDER BY ${order}`;
 }
 //#endregion
-//#region src/update/plan-page.ts
-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);
+//#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;
+		}
+		return NAMED[body.toLowerCase()] ?? match;
+	});
 }
-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 isCodePoint(code) {
+	return Number.isFinite(code) && code >= 0 && code <= MAX_CODE_POINT;
 }
-function withUploadedIds(doc, ids) {
-	if (!doc.content) return doc;
-	return {
-		...doc,
-		content: doc.content.map((n) => withUploadedId(n, ids))
-	};
+//#endregion
+//#region src/api/confluence-search.ts
+async function searchPages(client, site, params) {
+	return searchPagesByCql(client, site, buildCql(params), params.limit);
 }
-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;
+async function searchPagesByCql(client, site, cql, limit) {
+	const query = new URLSearchParams({
+		cql,
+		limit: String(limit),
+		expand: "content.space"
+	});
+	const results = (await client.getJson(`/wiki/rest/api/search?${query.toString()}`)).results ?? [];
+	const serverPageWasFull = results.length === limit;
 	return {
-		...swapped,
-		content: swapped.content.map((n) => withUploadedId(n, ids))
+		pages: results.filter((r) => r.content?.id).map((r) => ({
+			id: r.content?.id ?? "",
+			space: r.content?.space?.key ?? spaceKeyOf(r.resultGlobalContainer?.displayUrl),
+			title: decodeEntities(r.content?.title ?? r.title ?? ""),
+			updated: r.lastModified ?? "",
+			url: r.url ? `${site}/wiki${r.url}` : ""
+		})),
+		hasMore: serverPageWasFull
 	};
 }
+const SPACE_URL = /\/spaces\/([^/?#]+)/;
+function spaceKeyOf(displayUrl) {
+	return SPACE_URL.exec(displayUrl ?? "")?.[1] ?? "";
+}
+function buildCql(params) {
+	return joinClauses([
+		"type = page",
+		params.starred ? "favourite = currentUser()" : null,
+		inClause("space", params.space),
+		inClause("label", params.label),
+		params.updatedSince ? `lastmodified >= ${quote(params.updatedSince)}` : null,
+		params.text ? `text ~ ${quote(params.text)}` : null
+	], "lastmodified DESC");
+}
+//#endregion
+//#region src/copy/run.ts
+async function runCopy(env, plan) {
+	const landed = await download(env, plan);
+	await env.files.writeText(plan.filePath, renderCopy(plan, landed));
+	env.term.out(wroteLine(plan.filePath, landed.length));
+}
+async function download({ term, files, session }, plan) {
+	const landed = [];
+	for (const { path, ...attachment } of plan.downloads) try {
+		await files.writeBytes(path, await session.getBinary(attachment.url));
+		landed.push(attachment);
+	} catch (err) {
+		term.err(`  ! could not download ${attachment.filename}: ${err.message}`);
+	}
+	return landed;
+}
+function wroteLine(filePath, attachmentCount) {
+	return `Wrote ${filePath}${attachmentCount > 0 ? ` (+${attachmentCount} attachment${attachmentCount === 1 ? "" : "s"})` : ""}`;
+}
 //#endregion
 //#region src/update/run.ts
 async function runPlan(term, plan, options, push) {
+	const verdict = plan.verdict;
 	if (options.dryRun) {
 		term.out(formatPlan(plan));
+		if (verdict.kind === "refuse") throw new Error(verdict.message);
+		if (verdict.kind === "confirm" && !term.interactive) throw new NotInteractiveError(forcePrompt(verdict.message));
 		return;
 	}
-	const verdict = plan.verdict;
+	for (const warning of plan.warnings) term.err(`warning: ${warning}`);
 	if (verdict.kind === "refuse") throw new Error(verdict.message);
 	if (verdict.kind === "confirm") {
 		if (!await term.ask.confirm({
-			message: verdict.message,
-			flag: "--force",
+			...forcePrompt(verdict.message),
 			default: false
 		})) {
 			term.out("Aborted.");
@@ -2812,6 +3217,12 @@ async function runPlan(term, plan, options, push) {
 	}
 	await push();
 }
+function forcePrompt(message) {
+	return {
+		message,
+		flag: "--force"
+	};
+}
 //#endregion
 //#region src/commands/confluence.ts
 async function confluenceView({ session, term }, arg, options) {
@@ -2822,7 +3233,7 @@ async function confluenceView({ session, term }, arg, options) {
 function formatPageView(page, nowMs, allComments) {
 	return [
 		kleur.bold(page.title),
-		...fieldLines([
+		...fieldLines$1([
 			["Space", page.spaceKey],
 			["ID", page.id],
 			["Version", page.version ? String(page.version) : ""],
@@ -2839,60 +3250,44 @@ function formatPageView(page, nowMs, allComments) {
 async function confluenceCopy(env, arg, options) {
 	await copyPage(env, await resolveRef(env.term.ask, arg, PAGE_REF), options.out);
 }
-async function confluenceUpdate({ session, term, files }, arg, options) {
+async function confluenceUpdate(env, arg, options) {
+	const { session, term, files } = env;
 	const file = arg ?? await term.ask.text({
 		message: "Path to the page Markdown file:",
 		flag: "[file]",
 		required: true
 	});
-	const src = parsePageSource(await files.readText(file));
+	const raw = await files.readText(file);
+	const src = parsePageSource(raw);
 	const state = await fetchPageState(session, src.id);
-	const plan = planPageUpdate(src, state, await listAttachments(session, src.id), await statLocalImages(files, dirname(resolve(file)), src.body), options);
+	const plan = planPageUpdate(src, state, await listAttachments(session, src.id), await statLocalImages(files, dirname(resolve(file)), src.body), {
+		...options,
+		file
+	});
 	await runPlan(term, plan, options, async () => {
-		const ids = /* @__PURE__ */ new Map();
-		for (const upload of plan.uploads) {
-			term.err(`Uploading ${upload.filename} ...`);
-			const bytes = await files.readBytes(upload.path);
-			ids.set(upload.href, await uploadAttachment(session, src.id, upload.filename, bytes));
-		}
-		const version = await updatePage(session, src.id, {
+		const version = await pushPage(env, {
 			title: plan.headline.next,
+			body: plan.body,
+			uploads: plan.uploads
+		}, {
+			id: src.id,
 			nextVersion: state.version + 1,
-			body: withUploadedIds(plan.body, ids),
 			message: options.message ?? "Updated via atlass"
 		});
-		term.out(`Updated page ${src.id} to version ${version}.`);
+		term.out(`Updated page ${src.id} to version ${version.number}.`);
+		await files.writeText(file, rewriteFields(raw, pushedFields(plan, version)));
 	});
 }
-async function statLocalImages(files, 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(files, path)
-		};
-	}));
-}
-async function fileSize(files, path) {
-	try {
-		return { size: await files.size(path) };
-	} catch {
-		return {};
-	}
+function pushedFields(plan, version) {
+	const fields = { version: version.number };
+	if (version.createdAt) fields["updated"] = version.createdAt;
+	if (plan.headline.next !== plan.headline.current) fields["title"] = plan.headline.next;
+	return fields;
 }
 async function copyPage(env, id, out) {
 	env.term.err(`Fetching page ${id} ...`);
 	await runCopy(env, planPageCopy(await fetchPage(env.session, env.session.site, id), out));
 }
-const PAGE_REF = {
-	message: "Confluence page id or URL:",
-	flag: "[page]",
-	parse: parsePageId,
-	notFound: (raw) => `Could not find a page id in "${raw}".`
-};
 //#endregion
 //#region src/commands/confluence-search.ts
 async function confluenceSearch(env, query, options) {
@@ -2963,16 +3358,212 @@ function registerConfluence(confluence) {
 	confluence.command("view [page]").description("Show a Confluence page (id or URL) in the terminal").option("--all-comments", "show all comments instead of the last 5").option("--no-pager", "print directly instead of paging long output").action(jiraAction(confluenceView));
 	confluence.command("copy [page]").description("Copy a Confluence page (id or URL) to a Markdown file").option("-o, --out <path>", "output file or directory").action(jiraAction(confluenceCopy));
 	confluence.command("update [file]").description("Update a Confluence page from an edited Markdown file").option("--title", "also push the H1 as the page title").option("-m, --message <text>", "version message (default 'Updated via atlass')").option("-f, --force", "skip the stale-version and data-loss checks").option("--dry-run", "show what would change without writing").action(jiraAction(confluenceUpdate));
+	confluence.command("create [file]").description("Create a Confluence page from a Markdown file").option("-s, --space <key>", "space to create it in (default: the frontmatter space)").option("--parent <page>", "parent page id or URL (default: the space homepage)").option("--star", "star the new page").option("--dry-run", "show what would be created without writing").action(jiraAction(confluenceCreate));
+	confluence.command("star [page]").description("Star a Confluence page (id, URL, or copied file)").action(jiraAction(confluenceStar));
+	confluence.command("unstar [page]").description("Unstar a Confluence page (id, URL, or copied file)").action(jiraAction(confluenceUnstar));
 	outputOptions(confluence.command("list").description("List pages you starred").option("-s, --space <key>", "limit to a space")).action(jiraAction(confluenceList));
 	outputOptions(confluence.command("search [query]").description("Search Confluence pages by text and filters").option("-s, --space <key>", "limit to a space (repeatable)", collect).option("--label <label>", "limit to a label (repeatable)", collect).option("--starred", "limit to pages you starred").option("-u, --updated <when>", "changed since 7d, 2w, 3m, or YYYY-MM-DD").addOption(moved("--cql <cql>", "confluence cql"))).action(jiraAction(confluenceSearch));
 	outputOptions(confluence.command("cql <query>").description("Search Confluence pages with a raw CQL query")).action(jiraAction(confluenceCql));
 	return confluence;
 }
 //#endregion
+//#region src/api/jira-statuses.ts
+async function listStatuses(client, project) {
+	return dedupeAndSortStatuses((project ? await fetchProjectStatuses(client, project) : await fetchAllStatuses(client)).map(toStatusSummary));
+}
+async function statusesById(client) {
+	const raw = await fetchAllStatuses(client);
+	return new Map(raw.map((s) => [s.id, toStatusSummary(s)]));
+}
+function fetchAllStatuses(client) {
+	return client.getJson("/rest/api/3/status");
+}
+async function fetchProjectStatuses(client, project) {
+	let groups;
+	try {
+		groups = await client.getJson(`/rest/api/3/project/${encodeURIComponent(project)}/statuses`);
+	} catch (err) {
+		if (err instanceof HttpError && err.status === 404) throw new Error(`No project found with key "${project}".`);
+		throw err;
+	}
+	return groups.flatMap((g) => g.statuses ?? []);
+}
+function toStatusSummary(s) {
+	return {
+		name: s.name,
+		id: s.id,
+		category: s.statusCategory?.name ?? "",
+		categoryKey: s.statusCategory?.key ?? ""
+	};
+}
+const CATEGORY_ORDER = {
+	new: 0,
+	indeterminate: 1,
+	done: 2
+};
+const UNKNOWN_CATEGORY_RANK = Object.keys(CATEGORY_ORDER).length;
+function dedupeAndSortStatuses(statuses) {
+	const byNameCategory = /* @__PURE__ */ new Map();
+	for (const s of statuses) {
+		const key = `${s.name}\0${s.categoryKey}`;
+		if (!byNameCategory.has(key)) byNameCategory.set(key, s);
+	}
+	return [...byNameCategory.values()].sort((a, b) => {
+		const rank = (s) => CATEGORY_ORDER[s.categoryKey] ?? UNKNOWN_CATEGORY_RANK;
+		return rank(a) - rank(b) || a.name.localeCompare(b.name);
+	});
+}
+//#endregion
 //#region src/api/jira-url.ts
 function browseUrl(site, key) {
 	return `${site}/browse/${key}`;
 }
+function boardUrl(site, id) {
+	return `${site}/secure/RapidBoard.jspa?rapidView=${id}`;
+}
+//#endregion
+//#region src/api/jira-board.ts
+async function fetchBoard(client, site, id) {
+	const [config, statuses] = await Promise.all([client.getJson(`/rest/agile/1.0/board/${id}/configuration`), statusesById(client)]);
+	const statusFor = (statusId) => statuses.get(statusId) ?? {
+		id: statusId,
+		name: statusId,
+		category: "",
+		categoryKey: ""
+	};
+	return {
+		id: config.id,
+		name: config.name,
+		type: config.type,
+		url: boardUrl(site, config.id),
+		estimation: estimationOf(config),
+		filter: {
+			id: config.filter.id,
+			jql: await visibleFilterJql(client, config.filter.id),
+			subQuery: config.subQuery?.query || null
+		},
+		columns: (config.columnConfig?.columns ?? []).map((c) => ({
+			name: c.name,
+			statuses: (c.statuses ?? []).map((s) => statusFor(s.id))
+		}))
+	};
+}
+async function visibleFilterJql(client, filterId) {
+	try {
+		return (await client.getJson(`/rest/api/3/filter/${filterId}`)).jql ?? null;
+	} catch (err) {
+		if (err instanceof HttpError && err.status === 404) return null;
+		throw err;
+	}
+}
+function estimationOf(config) {
+	const field = config.estimation?.type === "field" ? config.estimation.field : void 0;
+	return field ? {
+		fieldId: field.fieldId,
+		fieldName: field.displayName
+	} : null;
+}
+//#endregion
+//#region src/api/offset-pages.ts
+async function allOffsetPages(client, pathAt) {
+	const all = [];
+	for (let startAt = 0;;) {
+		const res = await client.getJson(pathAt(startAt));
+		const values = res.values ?? [];
+		all.push(...values);
+		if (res.isLast || values.length === 0) return all;
+		startAt += values.length;
+	}
+}
+//#endregion
+//#region src/api/jira-boards.ts
+async function listBoards(client, site) {
+	return (await allOffsetPages(client, (startAt) => `/rest/agile/1.0/board?startAt=${startAt}&maxResults=50`)).map((b) => ({
+		id: b.id,
+		name: b.name,
+		type: b.type,
+		project: b.location?.projectKey ?? null,
+		url: boardUrl(site, b.id)
+	}));
+}
+//#endregion
+//#region src/commands/board-ref.ts
+async function withBoard(session, ref, load) {
+	const id = await resolveBoardId(session, ref);
+	try {
+		return await load(id);
+	} catch (err) {
+		if (isMissingBoard(err, id)) throw unknownBoard(ref);
+		throw err;
+	}
+}
+async function resolveBoardId(session, ref) {
+	const id = parseBoardId(ref);
+	if (id !== null) return id;
+	const name = ref.trim().toLowerCase();
+	const matches = (await listBoards(session, session.site)).filter((b) => b.name.toLowerCase() === name);
+	const [only, ...others] = matches;
+	if (!only) throw unknownBoard(ref);
+	if (others.length === 0) return only.id;
+	const width = Math.max(...matches.map((b) => String(b.id).length));
+	throw new Error([`"${ref}" matches several boards. Use an id:`, ...matches.map((b) => `  ${String(b.id).padEnd(width)}  ${b.name}`)].join("\n"));
+}
+function isMissingBoard(err, id) {
+	return err instanceof HttpError && err.status === 404 && err.path.startsWith(`/rest/agile/1.0/board/${id}/`);
+}
+function unknownBoard(ref) {
+	return /* @__PURE__ */ new Error(`No board matches "${ref}". Run \`atlass jira boards\` to list boards.`);
+}
+//#endregion
+//#region src/commands/jira-board.ts
+async function jiraBoard({ session, term }, ref, options) {
+	const board = await withBoard(session, ref, (id) => fetchBoard(session, session.site, id));
+	if (options.json) term.json(board);
+	else term.out(formatBoard(board));
+}
+function formatBoard(board) {
+	return [
+		board.name,
+		...fieldLines$1([
+			["ID", String(board.id)],
+			["Type", board.type],
+			["Estimation", estimationLine(board)],
+			["Filter", board.filter.jql ?? `not visible to you (filter ${board.filter.id})`],
+			["Sub-filter", board.filter.subQuery ?? ""],
+			["URL", board.url]
+		]),
+		"",
+		...columnLines(board)
+	];
+}
+function estimationLine({ estimation }) {
+	return estimation ? `${estimation.fieldName} (${estimation.fieldId})` : "none, this board does not estimate with a field";
+}
+function columnLines({ columns }) {
+	const statuses = columns.flatMap((c) => c.statuses);
+	const width = Math.max(0, ...statuses.map((s) => s.name.length));
+	return columns.flatMap((c) => [c.name, ...c.statuses.map((s) => `  ${s.name.padEnd(width)}  ${s.category}`.trimEnd())]);
+}
+//#endregion
+//#region src/commands/jira-boards.ts
+async function jiraBoards({ session, term }, query, options) {
+	const boards = filterBoards(await listBoards(session, session.site), query, options.project);
+	if (options.json) term.json(boards);
+	else if (boards.length === 0) term.out("No matching boards.");
+	else term.out(formatBoardRows(boards));
+}
+function filterBoards(boards, query, project) {
+	const needle = query?.toLowerCase();
+	const key = project?.toUpperCase();
+	return boards.filter((b) => (!needle || b.name.toLowerCase().includes(needle)) && (!key || b.project?.toUpperCase() === key));
+}
+function formatBoardRows(boards) {
+	const width = (pick) => Math.max(...boards.map((b) => pick(b).length));
+	const idWidth = width((b) => String(b.id));
+	const typeWidth = width((b) => b.type);
+	const nameWidth = width((b) => b.name);
+	return boards.map((b) => `${String(b.id).padEnd(idWidth)}  ${b.type.padEnd(typeWidth)}  ${b.name.padEnd(nameWidth)}  ${b.project ?? ""}`.trimEnd());
+}
 //#endregion
 //#region src/api/jira-createmeta.ts
 const CREATEMETA_PAGE_SIZE = 200;
@@ -3065,28 +3656,19 @@ function toJiraUser(u) {
 }
 //#endregion
 //#region src/api/jira-projects.ts
-const PROJECT_PAGE_SIZE = 50;
 async function listProjects(client, site, query) {
-	const projects = [];
-	for (let startAt = 0;;) {
-		const res = await client.getJson(`/rest/api/3/project/search?${projectSearchQuery(query, startAt)}`);
-		const values = res.values ?? [];
-		for (const p of values) projects.push({
-			key: p.key,
-			name: p.name,
-			id: p.id,
-			type: p.projectTypeKey ?? "",
-			url: browseUrl(site, p.key)
-		});
-		if (res.isLast || values.length === 0) break;
-		startAt += values.length;
-	}
-	return projects;
+	return (await allOffsetPages(client, (startAt) => `/rest/api/3/project/search?${projectSearchQuery(query, startAt)}`)).map((p) => ({
+		key: p.key,
+		name: p.name,
+		id: p.id,
+		type: p.projectTypeKey ?? "",
+		url: browseUrl(site, p.key)
+	}));
 }
 function projectSearchQuery(query, startAt) {
 	const params = new URLSearchParams({
 		orderBy: "key",
-		maxResults: String(PROJECT_PAGE_SIZE),
+		maxResults: String(50),
 		startAt: String(startAt)
 	});
 	if (query) params.set("query", query);
@@ -3731,17 +4313,55 @@ function describeRejection(err, meta) {
 		...perField
 	].join("\n"));
 }
-async function jiraFields({ session, term }, projectArg, typeArg, options) {
+//#endregion
+//#region src/api/jira-fields.ts
+async function listSiteFields(client) {
+	return (await client.getJson("/rest/api/3/field")).map((f) => ({
+		id: f.id,
+		name: decodeEntities(f.name),
+		custom: f.custom ?? false,
+		schema: f.schema ?? null
+	}));
+}
+//#endregion
+//#region src/commands/jira-fields.ts
+async function jiraFields(env, projectArg, typeArg, options) {
+	if (!projectArg) return siteFields(env, options);
 	const project = projectArg.toUpperCase();
+	if (options.search !== void 0) throw new Error(`--search lists site fields and takes no project. Drop ${project}, or run \`atlass jira fields ${project}\` alone.`);
+	return createForm$1(env, project, typeArg, options);
+}
+async function siteFields({ session, term }, options) {
+	const fields = matchingFields(await listSiteFields(session), options.search).sort((a, b) => a.name.localeCompare(b.name, void 0, { sensitivity: "base" }));
+	if (options.json) term.json(fields);
+	else if (fields.length === 0) term.out("No matching fields.");
+	else term.out(formatSiteFieldRows(fields));
+}
+function matchingFields(fields, search) {
+	const needle = search?.toLowerCase();
+	return fields.filter((f) => !needle || f.name.toLowerCase().includes(needle) || f.id.toLowerCase().includes(needle));
+}
+function formatSiteFieldRows(fields) {
+	const width = (pick) => Math.max(...fields.map((f) => pick(f).length));
+	const idWidth = width((f) => f.id);
+	const nameWidth = width((f) => f.name);
+	return fields.map((f) => `${f.id.padEnd(idWidth)}  ${f.name.padEnd(nameWidth)}  ${shortFieldType(f)}`.trimEnd());
+}
+function shortFieldType(field) {
+	const plugin = field.schema?.custom;
+	if (plugin) return plugin.slice(plugin.lastIndexOf(":") + 1);
+	return field.schema?.type ?? "";
+}
+async function createForm$1({ session, term }, project, typeArg, { json }) {
 	const types = await fetchCreateIssueTypes(session, project);
 	if (!typeArg) {
-		if (options.json) term.json(types);
+		if (json) term.json(types);
 		else if (types.length === 0) term.out(`You cannot create issues in ${project}.`);
 		else term.out(formatIssueTypeRows(types));
 		return;
 	}
 	const fields = await fetchCreateFields(session, project, (await resolveType(term.ask, project, types, typeArg, true)).id);
-	if (options.json) term.json(fields);
+	if (json) term.json(fields);
 	else term.out(formatFieldRows(fields));
 }
 //#endregion
@@ -3749,23 +4369,23 @@ async function jiraFields({ session, term }, projectArg, typeArg, options) {
 const RECENT_ISSUES_CLAUSE = "updated >= -30d";
 const OPEN_CLAUSE = "statusCategory != Done";
 const SEARCH_FIELDS = "summary,status,updated";
-async function searchIssues(client, site, params) {
-	return searchIssuesByJql(client, site, buildJql(params), params.limit);
+async function searchIssues(client, site, params, fieldIds = []) {
+	return searchIssuesByJql(client, site, buildJql(params), params.limit, fieldIds);
 }
-async function searchIssuesByJql(client, site, jql, limit) {
-	return ((await fetchSearchPage(client, jql, limit)).issues ?? []).map((i) => toIssueSummary(site, i));
+async function searchIssuesByJql(client, site, jql, limit, fieldIds = []) {
+	return ((await fetchSearchPage(client, jql, limit, fieldIds)).issues ?? []).map((i) => toIssueSummary(site, i, fieldIds));
 }
-async function fetchSearchPage(client, jql, maxResults, nextPageToken) {
+async function fetchSearchPage(client, jql, maxResults, fieldIds, nextPageToken) {
 	const query = new URLSearchParams({
 		jql,
 		maxResults: String(maxResults),
-		fields: SEARCH_FIELDS
+		fields: [SEARCH_FIELDS, ...fieldIds].join(",")
 	});
 	if (nextPageToken) query.set("nextPageToken", nextPageToken);
 	return client.getJson(`/rest/api/3/search/jql?${query.toString()}`);
 }
-function toIssueSummary(site, i) {
-	return {
+function toIssueSummary(site, i, fieldIds) {
+	const summary = {
 		key: i.key,
 		status: i.fields?.status?.name ?? "",
 		statusCategory: i.fields?.status?.statusCategory?.key ?? "",
@@ -3773,6 +4393,11 @@ function toIssueSummary(site, i) {
 		updated: i.fields?.updated ?? "",
 		url: browseUrl(site, i.key)
 	};
+	if (fieldIds.length === 0) return summary;
+	return {
+		...summary,
+		fields: Object.fromEntries(fieldIds.map((id) => [id, i.fields?.[id] ?? null]))
+	};
 }
 const ISSUE_ORDER = "updated DESC";
 function buildJql(params) {
@@ -3784,30 +4409,40 @@ function buildJql(params) {
 		userClause("assignee", params.assignee),
 		userClause("reporter", params.reporter),
 		inClause("labels", params.label),
-		params.updatedSince ? `updated >= ${quote$1(params.updatedSince)}` : null,
-		params.text ? `text ~ ${quote$1(params.text)}` : null
+		anyOf(values(params.sprint).map(sprintTerm)),
+		params.updatedSince ? `updated >= ${quote(params.updatedSince)}` : null,
+		params.text ? `text ~ ${quote(params.text)}` : null
 	].filter((c) => c !== null);
 	if (clauses.length === 0) clauses.push(RECENT_ISSUES_CLAUSE);
 	return joinClauses(clauses, ISSUE_ORDER);
 }
+const SPRINT_FUNCTIONS = {
+	active: "openSprints()",
+	future: "futureSprints()"
+};
+function sprintTerm(sprint) {
+	const sprintFunction = SPRINT_FUNCTIONS[sprint];
+	if (sprintFunction) return `sprint in ${sprintFunction}`;
+	return `sprint = ${/^\d+$/.test(sprint) ? sprint : quote(sprint)}`;
+}
 function buildListJql(params) {
 	return joinClauses([
 		"assignee = currentUser()",
-		params.project ? `project = ${quote$1(params.project)}` : null,
+		params.project ? `project = ${quote(params.project)}` : null,
 		params.all ? `(${OPEN_CLAUSE} OR ${RECENT_ISSUES_CLAUSE})` : OPEN_CLAUSE
 	], ISSUE_ORDER);
 }
 const LIST_PAGE_SIZE = 100;
 const LIST_CAP = 500;
-async function listAssignedIssues(client, site, params) {
+async function listAssignedIssues(client, site, params, fieldIds = []) {
 	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 res = await fetchSearchPage(client, jql, Math.min(LIST_PAGE_SIZE, room), fieldIds, nextPageToken);
 		const page = res.issues ?? [];
-		issues.push(...page.map((i) => toIssueSummary(site, i)));
+		issues.push(...page.map((i) => toIssueSummary(site, i, fieldIds)));
 		if (res.isLast || !res.nextPageToken || page.length === 0) return {
 			issues,
 			truncated: false
@@ -3831,6 +4466,54 @@ function sortByCategoryThenUpdated(issues) {
 	return [...issues].sort((a, b) => rank(a) - rank(b) || updatedMs(b) - updatedMs(a));
 }
 //#endregion
+//#region src/commands/jira-field-columns.ts
+async function resolveFieldColumns(session, given) {
+	const names = values(given);
+	if (names.length === 0) return [];
+	const fields = await listSiteFields(session);
+	return names.map((name) => ({
+		name,
+		id: resolveFieldId(fields, name)
+	}));
+}
+function resolveFieldId(fields, name) {
+	const byId = fields.find((f) => f.id === name);
+	if (byId) return byId.id;
+	const lower = name.toLowerCase();
+	const matches = fields.filter((f) => f.name.toLowerCase() === lower);
+	const [only, ...others] = matches;
+	if (!only) throw new Error(`No field matches "${name}". Run \`atlass jira fields --search ${shellWord(name)}\` to find it.`);
+	if (others.length === 0) return only.id;
+	const width = Math.max(...matches.map((f) => f.id.length));
+	throw new Error([`"${name}" matches several fields. Use an id:`, ...matches.map((f) => `  ${f.id.padEnd(width)}  ${f.name}`)].join("\n"));
+}
+function shellWord(text) {
+	return /\s/.test(text) ? `"${text}"` : text;
+}
+function fieldIds(columns) {
+	return [...new Set(columns.map((c) => c.id))];
+}
+function withNamedFields(issues, columns) {
+	if (columns.length === 0) return issues;
+	return issues.map((issue) => ({
+		...issue,
+		fields: Object.fromEntries(columns.map((c) => [c.name, issue.fields?.[c.id] ?? null]))
+	}));
+}
+const EMPTY_CELL = "-";
+function fieldCell(value) {
+	const text = (Array.isArray(value) ? value.map(shownValue) : [shownValue(value)]).filter((p) => p !== "").join(", ");
+	return text === "" ? EMPTY_CELL : text;
+}
+function shownValue(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	const named = value;
+	const shown = named.value ?? named.displayName ?? named.name;
+	return shown === void 0 ? JSON.stringify(value) : shownValue(shown);
+}
+//#endregion
 //#region src/commands/jira-filters.ts
 const FILTER_FLAGS = [
 	"project",
@@ -3838,7 +4521,8 @@ const FILTER_FLAGS = [
 	"reporter",
 	"status",
 	"type",
-	"label"
+	"label",
+	"sprint"
 ];
 const ISSUE_KEY = /^[A-Z][A-Z0-9]+-\d+$/i;
 function hasFilters(filters) {
@@ -3857,6 +4541,7 @@ async function searchParams(client, query, filters, limit, nowMs) {
 		status: filters.status,
 		type: filters.type,
 		label: filters.label,
+		sprint: filters.sprint,
 		updatedSince: filters.updated ? parseSince(filters.updated, nowMs) : void 0,
 		open: filters.open,
 		limit
@@ -3928,7 +4613,9 @@ 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.putNoContent(`/rest/api/3/issue/${encodeURIComponent(key)}`, { fields });
+	const path = `/rest/api/3/issue/${encodeURIComponent(key)}`;
+	await client.putNoContent(path, { fields });
+	return (await client.getJson(`${path}?fields=updated`)).fields.updated ?? "";
 }
 async function fetchComments(client, key) {
 	return (await client.getJson(`/rest/api/3/issue/${encodeURIComponent(key)}/comment?maxResults=100&orderBy=created`)).comments.map((c) => ({
@@ -3938,46 +4625,6 @@ async function fetchComments(client, key) {
 	}));
 }
 //#endregion
-//#region src/api/jira-statuses.ts
-async function listStatuses(client, project) {
-	return dedupeAndSortStatuses((project ? await fetchProjectStatuses(client, project) : await client.getJson("/rest/api/3/status")).map(toStatusSummary));
-}
-async function fetchProjectStatuses(client, project) {
-	let groups;
-	try {
-		groups = await client.getJson(`/rest/api/3/project/${encodeURIComponent(project)}/statuses`);
-	} catch (err) {
-		if (err instanceof HttpError && err.status === 404) throw new Error(`No project found with key "${project}".`);
-		throw err;
-	}
-	return groups.flatMap((g) => g.statuses ?? []);
-}
-function toStatusSummary(s) {
-	return {
-		name: s.name,
-		id: s.id,
-		category: s.statusCategory?.name ?? "",
-		categoryKey: s.statusCategory?.key ?? ""
-	};
-}
-const CATEGORY_ORDER = {
-	new: 0,
-	indeterminate: 1,
-	done: 2
-};
-const UNKNOWN_CATEGORY_RANK = Object.keys(CATEGORY_ORDER).length;
-function dedupeAndSortStatuses(statuses) {
-	const byNameCategory = /* @__PURE__ */ new Map();
-	for (const s of statuses) {
-		const key = `${s.name}\0${s.categoryKey}`;
-		if (!byNameCategory.has(key)) byNameCategory.set(key, s);
-	}
-	return [...byNameCategory.values()].sort((a, b) => {
-		const rank = (s) => CATEGORY_ORDER[s.categoryKey] ?? UNKNOWN_CATEGORY_RANK;
-		return rank(a) - rank(b) || a.name.localeCompare(b.name);
-	});
-}
-//#endregion
 //#region src/commands/jira.ts
 async function jiraProjects({ session, term }, query, options) {
 	const projects = await listProjects(session, session.site, query);
@@ -4020,7 +4667,7 @@ function formatIssueView(issue, nowMs, allComments) {
 	const colorStatus = colorForCategory(issue.statusCategory);
 	return [
 		`${kleur.bold(issue.key)}  ${issue.summary}`,
-		...fieldLines([
+		...fieldLines$1([
 			["Type", issue.type],
 			["Status", issue.status && colorStatus(issue.status)],
 			["Assignee", issue.assignee],
@@ -4045,15 +4692,17 @@ async function jiraUpdate({ session, term, files }, arg, options) {
 		flag: "[file]",
 		required: true
 	});
-	const src = parseIssueSource(await files.readText(file));
+	const raw = await files.readText(file);
+	const src = parseIssueSource(raw);
 	const plan = planIssueUpdate(src, await fetchIssue(session, session.site, src.key), options);
 	await runPlan(term, plan, options, async () => {
 		const { current, next } = plan.headline;
-		await updateIssue(session, src.key, {
+		const updated = await updateIssue(session, src.key, {
 			description: plan.body,
 			summary: next !== current ? next : void 0
 		});
 		term.out(`Updated ${src.key}.`);
+		if (updated) await files.writeText(file, rewriteFields(raw, { updated }));
 	});
 }
 async function copyIssue(env, key, out) {
@@ -4072,18 +4721,20 @@ async function jiraSearch(env, query, options) {
 	const { session } = env;
 	checkQuery(query, options);
 	const limit = checkedLimit(options);
+	const columns = await resolveFieldColumns(session, options.field);
 	const params = await searchParams(session, query, options, limit, Date.now());
-	await showIssues(env, await searchIssues(session, session.site, params).catch((err) => {
+	await showIssues(env, withNamedFields(await searchIssues(session, session.site, params, fieldIds(columns)).catch((err) => {
 		throw searchHint(err, options.project);
-	}), limit, options);
+	}), columns), columns, limit, options);
 }
 async function jiraJql(env, query, options) {
 	const { session } = env;
 	const limit = checkedLimit(options);
-	await showIssues(env, await searchIssuesByJql(session, session.site, query, limit), limit, options);
+	const columns = await resolveFieldColumns(session, options.field);
+	await showIssues(env, withNamedFields(await searchIssuesByJql(session, session.site, query, limit, fieldIds(columns)), columns), columns, limit, options);
 }
-async function showIssues(env, issues, limit, options, empty = "No matching issues.") {
-	await showRows(env.term, formatIssueRows(issues, Date.now()), {
+async function showIssues(env, issues, columns, limit, options, empty = "No matching issues.") {
+	await showRows(env.term, formatIssueRows(issues, Date.now(), columns), {
 		empty,
 		hasMore: issues.length === limit,
 		limit
@@ -4091,27 +4742,36 @@ async function showIssues(env, issues, limit, options, empty = "No matching issu
 }
 async function jiraList(env, options) {
 	const { session, term } = env;
-	checkedLimit(options);
+	const limit = checkedLimit(options);
+	const columns = await resolveFieldColumns(session, options.field);
 	const { issues, truncated } = await listAssignedIssues(session, session.site, {
 		all: options.all,
 		project: options.project
-	});
-	await runSearch(term, formatIssueRows(sortByCategoryThenUpdated(issues), Date.now()), {
+	}, fieldIds(columns));
+	const sorted = sortByCategoryThenUpdated(withNamedFields(issues, columns));
+	const shown = options.limit === void 0 ? sorted : sorted.slice(0, limit);
+	await runSearch(term, formatIssueRows(shown, Date.now(), columns), {
 		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
+		footer: listFooter(shown.length, sorted.length, truncated, limit)
 	}, ISSUE_NOUN, (key) => copyIssue(env, key, options.out));
 }
-function formatIssueRows(issues, nowMs) {
+function listFooter(shown, fetched, truncated, limit) {
+	if (shown < fetched) return searchFooter(limit);
+	if (truncated) return `
+Showing the first ${shown}; narrow with --project.`;
+}
+function formatIssueRows(issues, nowMs, columns = []) {
 	return alignedRows(issues, nowMs, (i) => ({
 		id: i.key,
 		url: i.url,
 		label: i.status,
 		color: colorForCategory(i.statusCategory),
 		text: i.summary,
-		timestamp: i.updated
+		timestamp: i.updated,
+		columns: columns.map((c) => fieldCell(i.fields?.[c.name]))
 	}));
 }
 const ISSUE_NOUN = {
@@ -4119,24 +4779,90 @@ const ISSUE_NOUN = {
 	plural: "issues"
 };
 //#endregion
+//#region src/api/jira-types.ts
+const SPRINT_STATES = [
+	"active",
+	"future",
+	"closed"
+];
+//#endregion
+//#region src/api/jira-sprints.ts
+async function listSprints(client, boardId, states) {
+	const state = states.join(",");
+	return (await allOffsetPages(client, (startAt) => `/rest/agile/1.0/board/${boardId}/sprint?state=${state}&startAt=${startAt}&maxResults=50`)).toSorted(byRelevance).map((s) => ({
+		id: s.id,
+		state: s.state,
+		name: s.name,
+		start: s.startDate ?? null,
+		end: s.endDate ?? null,
+		boardId: s.originBoardId ?? boardId
+	}));
+}
+function byRelevance(a, b) {
+	const rank = SPRINT_STATES.indexOf(a.state) - SPRINT_STATES.indexOf(b.state);
+	if (rank !== 0 || a.state !== "closed") return rank;
+	return finishedAt(b) - finishedAt(a);
+}
+function finishedAt(sprint) {
+	return Date.parse(sprint.completeDate ?? sprint.endDate ?? "") || 0;
+}
+//#endregion
+//#region src/commands/jira-sprints.ts
+async function jiraSprints({ session, term }, ref, options) {
+	const chosen = parseChoices(options.state, SPRINT_STATES, "--state");
+	const states = chosen.length > 0 ? chosen : ["active"];
+	const limit = parseLimit(options.limit);
+	const sprints = await withBoard(session, ref, (id) => listSprints(session, id, states).catch((err) => {
+		throw withoutSprints(err, id);
+	}));
+	const shown = sprints.slice(0, limit);
+	if (options.json) term.json(shown);
+	else if (shown.length === 0) term.out(`No ${orList(states)} sprints.`);
+	else if (sprints.length > limit) term.out([...formatSprintRows(shown), searchFooter(limit)]);
+	else term.out(formatSprintRows(shown));
+}
+function withoutSprints(err, id) {
+	if (!(err instanceof HttpError) || err.status !== 400) return err;
+	return /* @__PURE__ */ new Error(`Board ${id} does not support sprints. Only scrum boards have them.`);
+}
+function formatSprintRows(sprints) {
+	const cells = sprints.map((s) => [
+		String(s.id),
+		s.state,
+		s.name,
+		s.start ? formatDate$1(s.start) : "-",
+		s.end ? formatDate$1(s.end) : "-"
+	]);
+	const widths = cells[0].map((_, i) => Math.max(...cells.map((row) => row[i].length)));
+	return cells.map((row) => row.map((cell, i) => cell.padEnd(widths[i])).join("  ").trimEnd());
+}
+//#endregion
 //#region src/cli/jira.ts
+const FIELD_OPTION = [
+	"-f, --field <name|id>",
+	"add a field's value to each issue (repeatable)",
+	collect
+];
 function registerJira(jira) {
 	jira.description("Jira commands");
 	jira.command("projects [query]").description("List projects (optionally filtered by key or name)").option("--json", "output results as JSON").action(jiraAction(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(jiraAction(jiraStatuses));
+	jira.command("boards [query]").description("List boards (optionally filtered by name, scoped with --project)").option("-p, --project <key>", "limit to boards located in a project").option("--json", "output results as JSON").action(jiraAction(jiraBoards));
+	jira.command("board <ref>").description("Show a board's estimation field, filter JQL and columns (id, URL or exact name)").option("--json", "output results as JSON").action(jiraAction(jiraBoard));
+	jira.command("sprints <ref>").description("List a board's sprints, active by default (id, URL or exact name)").option("-s, --state <state>", "active, future, or closed (repeatable)", collect).option("-l, --limit <n>", "max results (default 25, max 100)").option("--json", "output results as JSON").action(jiraAction(jiraSprints));
 	jira.command("create [project] [type]").description("Create a Jira issue, prompting for fields or taking them all as flags").option("-s, --summary <text>", "issue summary").option("-d, --description <markdown>", "description as Markdown").option("--description-file <path>", "read the description from a Markdown file").option("-a, --assignee <who>", "assignee: me, an account id, or a name to look up").option("--priority <name>", "priority name").option("-l, --label <label>", "label (repeatable)", collect).option("-c, --component <name>", "component (repeatable)", collect).option("--parent <key>", "parent issue key for subtasks").option("-f, --field <name=value>", "any other create-screen field (repeatable)", collect).option("--dry-run", "print the resolved payload instead of creating").option("--json", "print the created issue as JSON").action(jiraAction(jiraCreate));
-	jira.command("fields <project> [type]").description("Show the issue types you can create in a project, or the create form for one type").option("--json", "output results as JSON").action(jiraAction(jiraFields));
+	jira.command("fields [project] [type]").description("List site fields, or the issue types a project offers, or the create form for one type").option("--search <text>", "site fields only: filter by name or id").option("--json", "output results as JSON").action(jiraAction(jiraFields));
 	jira.command("view [issue]").description("Show a Jira issue (key or URL) in the terminal").option("--all-comments", "show all comments instead of the last 5").option("--no-pager", "print directly instead of paging long output").action(jiraAction(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(jiraAction(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(jiraAction(jiraUpdate));
-	outputOptions(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")).action(jiraAction(jiraList));
-	outputOptions(jira.command("search [query]").description("Search Jira issues by text and filters").option("-p, --project <key>", "limit to a project (repeatable)", collect).option("-a, --assignee <who>", "limit to an assignee: me, a name, or an account id", collect).option("--reporter <who>", "limit to a reporter: me, a name, or an account id", collect).option("-s, --status <status>", "limit to a status (repeatable)", collect).option("-t, --type <type>", "limit to an issue type (repeatable)", collect).option("--label <label>", "limit to a label (repeatable)", collect).option("-u, --updated <when>", "changed since 7d, 2w, 3m, or YYYY-MM-DD").option("--open", "exclude issues in the Done category").addOption(moved("--jql <jql>", "jira jql"))).action(jiraAction(jiraSearch));
-	outputOptions(jira.command("jql <query>").description("Search Jira issues with a raw JQL query")).action(jiraAction(jiraJql));
+	outputOptions(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(...FIELD_OPTION), "max results (default all, max 100)").action(jiraAction(jiraList));
+	outputOptions(jira.command("search [query]").description("Search Jira issues by text and filters").option("-p, --project <key>", "limit to a project (repeatable)", collect).option("-a, --assignee <who>", "limit to an assignee: me, a name, or an account id", collect).option("--reporter <who>", "limit to a reporter: me, a name, or an account id", collect).option("-s, --status <status>", "limit to a status (repeatable)", collect).option("-t, --type <type>", "limit to an issue type (repeatable)", collect).option("--label <label>", "limit to a label (repeatable)", collect).option("--sprint <sprint>", "limit to a sprint: active, future, an id, or a name (repeatable)", collect).option("-u, --updated <when>", "changed since 7d, 2w, 3m, or YYYY-MM-DD").option("--open", "exclude issues in the Done category").option(...FIELD_OPTION).addOption(moved("--jql <jql>", "jira jql"))).action(jiraAction(jiraSearch));
+	outputOptions(jira.command("jql <query>").description("Search Jira issues with a raw JQL query").option(...FIELD_OPTION)).action(jiraAction(jiraJql));
 	return jira;
 }
 //#endregion
 //#region package.json
-var version = "2.0.0";
+var version = "2.2.0";
 //#endregion
 //#region src/cli/build.ts
 const PRODUCTS = {