atlass 2.1.0 → 2.3.0

package/dist/{build-_4VuIcqF.mjs → build-6PhpYMjp.mjs}

@@ -1,6 +1,6 @@
 import { Command, Option } from "commander";
 import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
-import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
 import { Entry } from "@napi-rs/keyring";
 import { homedir } from "node:os";
 import { spawn } from "node:child_process";
@@ -29,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));
@@ -126,10 +126,11 @@ var AtlassianClient = class {
 			headers: { Accept: "application/json" }
 		});
 	}
-	async postMultipart(path, filename, bytes) {
+	async postMultipart(path, filename, bytes, extras = {}) {
 		const form = new FormData();
-		const blob = new Blob([bytes]);
+		const blob = new Blob([bytes], { type: extras.type });
 		form.append("file", blob, filename);
+		for (const [name, value] of Object.entries(extras.fields ?? {})) form.append(name, value);
 		return (await this.request(path, {
 			method: "POST",
 			headers: {
@@ -447,14 +448,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+/);
@@ -469,6 +514,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) {
@@ -522,6 +574,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) {
@@ -768,15 +833,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];
@@ -942,43 +999,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) {
@@ -1580,6 +1600,7 @@ function alignedRows(items, nowMs, cells) {
 		const cell = cells(item);
 		return {
 			...cell,
+			columns: cell.columns ?? [],
 			age: relativeTime(cell.timestamp, nowMs),
 			json: { ...item }
 		};
@@ -1587,11 +1608,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
 	}));
@@ -1894,29 +1921,44 @@ 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/confluence-create.ts
-async function findSpaceId(client, key) {
-	return (await client.getJson(`/wiki/api/v2/spaces?keys=${encodeURIComponent(key)}`)).results[0]?.id ?? null;
+//#region src/util/media-type.ts
+const BY_EXTENSION = {
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".svg": "image/svg+xml",
+	".pdf": "application/pdf",
+	".txt": "text/plain",
+	".log": "text/plain",
+	".md": "text/markdown",
+	".csv": "text/csv",
+	".html": "text/html",
+	".json": "application/json",
+	".xml": "application/xml",
+	".zip": "application/zip",
+	".mp4": "video/mp4",
+	".m4v": "video/mp4",
+	".mov": "video/quicktime",
+	".webm": "video/webm",
+	".ogv": "video/ogg",
+	".avi": "video/x-msvideo",
+	".mkv": "video/x-matroska",
+	".wmv": "video/x-ms-wmv",
+	".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+};
+function mediaType(filename) {
+	return BY_EXTENSION[extname(filename).toLowerCase()];
 }
-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 isVideo(href) {
+	return mediaType(href.split(/[?#]/)[0] ?? "")?.startsWith("video/") ?? false;
 }
 //#endregion
 //#region src/api/confluence-attachments.ts
@@ -1928,8 +1970,23 @@ async function listAttachments(client, id) {
 		size: typeof a.fileSize === "number" ? a.fileSize : UNKNOWN_SIZE
 	}));
 }
+function uploadPath(pageId) {
+	return `/wiki/rest/api/content/${encodeURIComponent(pageId)}/child/attachment`;
+}
 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);
+	return (await client.postMultipart(uploadPath(pageId), filename, bytes)).results?.[0]?.extensions?.fileId ?? await fileIdByListing(client, pageId, filename);
+}
+async function attachToPage(client, pageId, filename, bytes, comment) {
+	const first = (await client.postMultipart(uploadPath(pageId), filename, bytes, {
+		type: mediaType(filename),
+		fields: comment ? { comment } : void 0
+	})).results?.[0];
+	if (!first?.id) throw new Error(`Upload of "${filename}" returned no attachment.`);
+	return {
+		filename: first.title ?? filename,
+		id: first.id,
+		size: first.extensions?.fileSize ?? bytes.byteLength
+	};
 }
 async function fileIdByListing(client, pageId, filename) {
 	const match = (await listAttachments(client, pageId)).find((a) => a.filename === filename);
@@ -1951,154 +2008,465 @@ function withWikiContextPath(link) {
 	return `/wiki${link}`;
 }
 //#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 ?? "";
-	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
-	};
-}
-async function fetchPageState(client, id) {
-	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
-	return {
-		version: page.version?.number ?? 0,
-		title: page.title,
-		body: parseAdfJson(page.body?.atlas_doc_format?.value)
-	};
-}
-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 {
-		number: res.version?.number ?? params.nextVersion,
-		createdAt: res.version?.createdAt ?? ""
-	};
-}
-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)
+//#region src/commands/attach.ts
+async function readLocal(files, paths) {
+	const read = await Promise.all(paths.map(async (path) => ({
+		path,
+		bytes: await files.readBytes(path).catch(() => void 0)
 	})));
+	const unreadable = read.filter((r) => !r.bytes).map((r) => r.path);
+	if (unreadable.length > 0) throw new Error(`Cannot read ${unreadable.join(", ")}.`);
+	return read.map((r) => ({
+		filename: basename(r.path),
+		bytes: r.bytes
+	}));
 }
-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) {
+async function attachAll(term, target, local, options, upload) {
+	const attached = [];
+	for (const file of local) {
+		term.err(`Uploading ${file.filename} ...`);
 		try {
-			return (await this.client.getJson(`/wiki/rest/api/user?accountId=${encodeURIComponent(accountId)}`)).displayName || null;
-		} catch {
-			return null;
+			attached.push(await upload(file));
+		} catch (err) {
+			if (attached.length > 0) term.err(`Already attached to ${target}: ${names(attached)}.`);
+			throw err;
 		}
 	}
-};
-//#endregion
-//#region src/adf/html.ts
-const COMMENT = /<!--[\s\S]*?-->/g;
-function isOnlyComments(html) {
-	return html.replace(COMMENT, "").trim().length === 0;
+	if (options.json) term.json(attached);
+	else term.out(`Attached ${names(attached)} to ${target}.`);
 }
-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 names(attached) {
+	return attached.map((a) => a.filename).join(", ");
 }
-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++;
+//#endregion
+//#region src/commands/resolve-ref.ts
+async function resolveRef(ask, arg, kind) {
+	const raw = arg ?? await ask.text({
+		message: kind.message,
+		flag: kind.flag,
+		required: true
 	});
-	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"}`;
+	const ref = kind.parse(raw);
+	if (!ref) throw new Error(kind.notFound(raw));
+	return ref;
 }
-//#endregion
-//#region src/adf/from-markdown.ts
-function mediaNode(source, alt) {
-	const attrs = { ...source };
-	if (alt) attrs["alt"] = alt;
+function layoutOf(raw) {
 	return {
-		type: "mediaSingle",
-		attrs: { layout: "center" },
-		content: [{
-			type: "media",
-			attrs
-		}]
+		bom: raw.startsWith(""),
+		crlf: /\r?\n/.exec(raw)?.[0] === "\r\n"
 	};
 }
-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 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/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 LEGACY_SECTION_HEADING = /^## (Comments|Attachments)\s*$/;
+function render(doc) {
+	return `${[
+		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(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 end = bodyEnd(lines, start, ending);
+	const fallbackTitle = typeof fields["title"] === "string" ? fields["title"] : "";
+	return {
+		fields,
+		title: h1?.title ?? fallbackTitle,
+		body: lines.slice(start, end).join("\n").trim()
+	};
+}
+function parseIssueSource(text) {
+	const source = parse(text);
+	const key = scalarString(source.fields["key"]);
+	if (!key) throw new Error("Frontmatter is missing the issue `key`; re-copy the issue.");
+	return {
+		...source,
+		key,
+		updatedAtCopy: scalarString(source.fields["updated"])
+	};
+}
+function parsePageSource(text) {
+	const source = parse(text);
+	const id = scalarString(source.fields["id"]);
+	if (!id) throw new Error("Frontmatter is missing the page `id`; re-copy the page.");
+	const rawVersion = scalarString(source.fields["version"]);
+	const version = rawVersion === "" ? NaN : Number(rawVersion);
+	if (!Number.isFinite(version)) throw new Error("Frontmatter is missing a numeric `version`; re-copy the page.");
+	return {
+		...source,
+		id,
+		version
+	};
+}
+function scalarString(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return String(value);
+	return "";
+}
+function leadingH1(lines) {
+	for (const [index, line] of lines.entries()) {
+		if (line.startsWith("# ")) return {
+			index,
+			title: line.slice(2).trim()
+		};
+		if (line.trim().length > 0) return null;
+	}
+	return null;
+}
+function 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) => {
+		const heading = `### ${c.author || "Unknown"}${c.created ? ` - ${formatDateTime(c.created)}` : ""}`;
+		return c.body ? `${heading}\n\n${c.body}` : heading;
+	});
+	return [
+		COMMENTS_HEADING,
+		"",
+		blocks.join("\n\n")
+	].join("\n");
+}
+function attachmentsSection(attachments) {
+	if (attachments.length === 0) return "";
+	const items = attachments.map((a) => `- [${a.filename}](${a.relativePath})`);
+	return [
+		ATTACHMENTS_HEADING,
+		"",
+		...items
+	].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-attach.ts
+async function confluenceAttach({ session, term, files }, arg, paths, options) {
+	const id = await resolveRef(term.ask, arg, PAGE_REF);
+	const local = await readLocal(files, paths);
+	await refuseClashes(session, id, local);
+	await attachAll(term, `page ${id}`, local, options, (file) => attachToPage(session, id, file.filename, file.bytes, options.comment));
+}
+async function refuseClashes(client, id, local) {
+	const names = local.map((f) => f.filename);
+	const repeated = names.filter((name, i) => names.indexOf(name) !== i);
+	if (repeated.length > 0) throw new Error(`More than one file is named ${unique(repeated).join(", ")}.`);
+	const existing = new Set((await listAttachments(client, id)).map((a) => a.filename));
+	const clashes = names.filter((name) => existing.has(name));
+	if (clashes.length > 0) throw new Error(`${clashes.join(", ")} already attached to page ${id}.`);
+}
+function unique(names) {
+	return [...new Set(names)];
+}
+//#endregion
+//#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;
+}
+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
+	};
+}
+//#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 ?? "";
+	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
+	};
+}
+async function fetchPageState(client, id) {
+	const page = await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}?body-format=atlas_doc_format`);
+	return {
+		version: page.version?.number ?? 0,
+		title: page.title,
+		body: parseAdfJson(page.body?.atlas_doc_format?.value)
+	};
+}
+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 {
+		number: res.version?.number ?? params.nextVersion,
+		createdAt: res.version?.createdAt ?? ""
+	};
+}
+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
+const NATURAL_SIZE = { layout: "center" };
+const TEXT_WIDTH = {
+	layout: "center",
+	width: 100,
+	widthType: "percentage"
+};
+function mediaNode(source, alt, href) {
+	const attrs = { ...source };
+	if (alt) attrs["alt"] = alt;
+	return {
+		type: "mediaSingle",
+		attrs: isVideo(href) ? TEXT_WIDTH : NATURAL_SIZE,
+		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 };
@@ -2273,7 +2641,7 @@ function externalMedia(href, alt) {
 	return mediaNode({
 		type: "external",
 		url: href
-	}, alt);
+	}, alt, href);
 }
 function textToken(text) {
 	return {
@@ -2458,7 +2826,7 @@ function planPageBody(page, attachments, localImages) {
 				type: "file",
 				id: entry.kind === "reuse" ? entry.fileId : href,
 				collection
-			}, alt);
+			}, alt, href);
 		} }),
 		uploads: images.flatMap((e) => e.kind === "upload" || e.kind === "changed" ? [{
 			href: e.href,
@@ -2579,243 +2947,9 @@ function favouritePath(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) {
-	const raw = arg ?? await ask.text({
-		message: kind.message,
-		flag: kind.flag,
-		required: true
-	});
-	const ref = kind.parse(raw);
-	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/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 LEGACY_SECTION_HEADING = /^## (Comments|Attachments)\s*$/;
-function render(doc) {
-	return `${[
-		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(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 end = bodyEnd(lines, start, ending);
-	const fallbackTitle = typeof fields["title"] === "string" ? fields["title"] : "";
-	return {
-		fields,
-		title: h1?.title ?? fallbackTitle,
-		body: lines.slice(start, end).join("\n").trim()
-	};
-}
-function parseIssueSource(text) {
-	const source = parse(text);
-	const key = scalarString(source.fields["key"]);
-	if (!key) throw new Error("Frontmatter is missing the issue `key`; re-copy the issue.");
-	return {
-		...source,
-		key,
-		updatedAtCopy: scalarString(source.fields["updated"])
-	};
-}
-function parsePageSource(text) {
-	const source = parse(text);
-	const id = scalarString(source.fields["id"]);
-	if (!id) throw new Error("Frontmatter is missing the page `id`; re-copy the page.");
-	const rawVersion = scalarString(source.fields["version"]);
-	const version = rawVersion === "" ? NaN : Number(rawVersion);
-	if (!Number.isFinite(version)) throw new Error("Frontmatter is missing a numeric `version`; re-copy the page.");
-	return {
-		...source,
-		id,
-		version
-	};
-}
-function scalarString(value) {
-	if (typeof value === "string") return value;
-	if (typeof value === "number") return String(value);
-	return "";
-}
-function leadingH1(lines) {
-	for (const [index, line] of lines.entries()) {
-		if (line.startsWith("# ")) return {
-			index,
-			title: line.slice(2).trim()
-		};
-		if (line.trim().length > 0) return null;
-	}
-	return null;
-}
-function 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) => {
-		const heading = `### ${c.author || "Unknown"}${c.created ? ` - ${formatDateTime(c.created)}` : ""}`;
-		return c.body ? `${heading}\n\n${c.body}` : heading;
-	});
-	return [
-		COMMENTS_HEADING,
-		"",
-		blocks.join("\n\n")
-	].join("\n");
-}
-function attachmentsSection(attachments) {
-	if (attachments.length === 0) return "";
-	const items = attachments.map((a) => `- [${a.filename}](${a.relativePath})`);
-	return [
-		ATTACHMENTS_HEADING,
-		"",
-		...items
-	].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;
-}
+async function unstarPage(client, id) {
+	await client.deleteNoContent(favouritePath(id));
+}
 //#endregion
 //#region src/commands/confluence-star.ts
 async function confluenceStar(env, arg) {
@@ -3074,6 +3208,11 @@ function inClause(field, given) {
 function userClause(field, given) {
 	return renderClause(field, values(given).map((v) => v === "me" ? "currentUser()" : quote(v)));
 }
+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]}`;
@@ -3328,6 +3467,7 @@ function registerConfluence(confluence) {
 	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("attach <page> <files...>").description("Upload files as attachments to a Confluence page (id or URL)").option("--comment <text>", "attachment comment, applied to every file").option("--json", "print the uploaded attachments as JSON").action(jiraAction(confluenceAttach));
 	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));
@@ -3336,9 +3476,385 @@ function registerConfluence(confluence) {
 	return confluence;
 }
 //#endregion
-//#region src/api/jira-url.ts
-function browseUrl(site, key) {
-	return `${site}/browse/${key}`;
+//#region src/api/jira-attachments.ts
+async function attachToIssue(client, key, filename, bytes) {
+	const [first] = await client.postMultipart(`/rest/api/3/issue/${encodeURIComponent(key)}/attachments`, filename, bytes, { type: mediaType(filename) });
+	if (!first) throw new Error(`Upload of "${filename}" returned no attachment.`);
+	return {
+		filename: first.filename,
+		id: first.id,
+		size: first.size
+	};
+}
+//#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-issues.ts
+const FIELDS = [
+	"summary",
+	"description",
+	"issuetype",
+	"status",
+	"assignee",
+	"reporter",
+	"priority",
+	"labels",
+	"created",
+	"updated",
+	"attachment"
+].join(",");
+async function fetchIssue(client, site, key) {
+	const issue = await client.getJson(`/rest/api/3/issue/${encodeURIComponent(key)}?fields=${FIELDS}`);
+	const comments = await fetchComments(client, key);
+	const f = issue.fields;
+	return {
+		key: issue.key,
+		url: browseUrl(site, issue.key),
+		summary: f.summary ?? "",
+		type: f.issuetype?.name ?? "",
+		status: f.status?.name ?? "",
+		statusCategory: f.status?.statusCategory?.key ?? "",
+		assignee: f.assignee?.displayName ?? "Unassigned",
+		reporter: f.reporter?.displayName ?? "",
+		priority: f.priority?.name ?? "",
+		labels: f.labels ?? [],
+		created: f.created ?? "",
+		updated: f.updated ?? "",
+		description: f.description ?? null,
+		comments,
+		attachments: (f.attachment ?? []).map((a) => ({
+			mediaId: a.id,
+			filename: a.filename,
+			url: a.content
+		}))
+	};
+}
+async function updateIssue(client, key, update) {
+	const fields = { description: update.description };
+	if (update.summary !== void 0) fields["summary"] = update.summary;
+	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) => ({
+		author: c.author?.displayName ?? "",
+		created: c.created ?? "",
+		body: c.body ?? 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-projects.ts
+async function listProjects(client, site, query) {
+	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(50),
+		startAt: String(startAt)
+	});
+	if (query) params.set("query", query);
+	return params.toString();
+}
+//#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/commands/jira.ts
+async function jiraProjects({ session, term }, query, options) {
+	const projects = await listProjects(session, session.site, query);
+	if (options.json) term.json(projects);
+	else if (projects.length === 0) term.out("No matching projects.");
+	else term.out(formatProjectRows(projects));
+}
+function formatProjectRows(projects) {
+	const width = Math.max(...projects.map((p) => p.key.length));
+	return projects.map((p) => `${p.key.padEnd(width)}  ${p.name}`);
+}
+async function jiraStatuses({ session, term }, query, options) {
+	let statuses = await listStatuses(session, options.project);
+	if (query) {
+		const needle = query.toLowerCase();
+		statuses = statuses.filter((s) => s.name.toLowerCase().includes(needle));
+	}
+	if (options.json) term.json(statuses);
+	else if (statuses.length === 0) term.out("No matching statuses.");
+	else term.out(formatStatusRows(statuses));
+}
+function formatStatusRows(statuses) {
+	const width = Math.max(...statuses.map((s) => s.name.length));
+	return statuses.map((s) => `${s.name.padEnd(width)}  ${s.category}`);
+}
+async function jiraView({ session, term }, arg, options) {
+	const key = await resolveRef(term.ask, arg, ISSUE_REF);
+	const lines = formatIssueView(await fetchIssue(session, session.site, key), Date.now(), options.allComments ?? false);
+	await term.page(lines.join("\n"), { pager: options.pager });
+}
+const CATEGORY_COLORS = {
+	new: kleur.cyan,
+	indeterminate: kleur.yellow,
+	done: kleur.green
+};
+function colorForCategory(category) {
+	return CATEGORY_COLORS[category] ?? ((text) => text);
+}
+function formatIssueView(issue, nowMs, allComments) {
+	const colorStatus = colorForCategory(issue.statusCategory);
+	return [
+		`${kleur.bold(issue.key)}  ${issue.summary}`,
+		...fieldLines$1([
+			["Type", issue.type],
+			["Status", issue.status && colorStatus(issue.status)],
+			["Assignee", issue.assignee],
+			["Reporter", issue.reporter],
+			["Priority", issue.priority],
+			["Labels", issue.labels.join(", ")],
+			["Created", dateWithAge(issue.created, nowMs)],
+			["Updated", dateWithAge(issue.updated, nowMs)],
+			["URL", issue.url]
+		]),
+		...bodyLines(issue.description),
+		...commentSection(renderedComments(issue.comments), { allComments }),
+		...attachmentSection(issue.attachments)
+	];
+}
+async function jiraCopy(env, arg, options) {
+	await copyIssue(env, await resolveRef(env.term.ask, arg, ISSUE_REF), options.out);
+}
+async function jiraUpdate({ session, term, files }, arg, options) {
+	const file = arg ?? await term.ask.text({
+		message: "Path to the issue Markdown file:",
+		flag: "[file]",
+		required: true
+	});
+	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;
+		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) {
+	env.term.err(`Fetching ${key} ...`);
+	await runCopy(env, planIssueCopy(await fetchIssue(env.session, env.session.site, key), out));
+}
+const ISSUE_REF = {
+	message: "Jira issue key or URL:",
+	flag: "[issue]",
+	parse: parseIssueKey,
+	notFound: (raw) => `Could not find an issue key in "${raw}" (expected e.g. PROJ-123).`
+};
+//#endregion
+//#region src/commands/jira-attach.ts
+async function jiraAttach({ session, term, files }, arg, paths, options) {
+	const key = await resolveRef(term.ask, arg, ISSUE_REF);
+	await attachAll(term, key, await readLocal(files, paths), options, (file) => attachToIssue(session, key, file.filename, file.bytes));
+}
+//#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/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
@@ -3431,35 +3947,6 @@ 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;
-}
-function projectSearchQuery(query, startAt) {
-	const params = new URLSearchParams({
-		orderBy: "key",
-		maxResults: String(PROJECT_PAGE_SIZE),
-		startAt: String(startAt)
-	});
-	if (query) params.set("query", query);
-	return params.toString();
-}
-//#endregion
 //#region src/commands/jira-create-resolve.ts
 async function resolveProject(ask, client, site, arg, strict) {
 	if (arg) return arg.toUpperCase();
@@ -4098,17 +4585,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
@@ -4116,23 +4641,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 ?? "",
@@ -4140,6 +4665,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) {
@@ -4151,12 +4681,22 @@ function buildJql(params) {
 		userClause("assignee", params.assignee),
 		userClause("reporter", params.reporter),
 		inClause("labels", params.label),
+		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()",
@@ -4166,15 +4706,15 @@ function buildListJql(params) {
 }
 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
@@ -4198,6 +4738,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",
@@ -4205,7 +4793,8 @@ const FILTER_FLAGS = [
 	"reporter",
 	"status",
 	"type",
-	"label"
+	"label",
+	"sprint"
 ];
 const ISSUE_KEY = /^[A-Z][A-Z0-9]+-\d+$/i;
 function hasFilters(filters) {
@@ -4224,6 +4813,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
@@ -4252,209 +4842,25 @@ function searchHint(err, project) {
 	return command ? /* @__PURE__ */ new Error(`${err.message} Run \`${command}\` to see the options.`) : err;
 }
 //#endregion
-//#region src/api/jira-issues.ts
-const FIELDS = [
-	"summary",
-	"description",
-	"issuetype",
-	"status",
-	"assignee",
-	"reporter",
-	"priority",
-	"labels",
-	"created",
-	"updated",
-	"attachment"
-].join(",");
-async function fetchIssue(client, site, key) {
-	const issue = await client.getJson(`/rest/api/3/issue/${encodeURIComponent(key)}?fields=${FIELDS}`);
-	const comments = await fetchComments(client, key);
-	const f = issue.fields;
-	return {
-		key: issue.key,
-		url: browseUrl(site, issue.key),
-		summary: f.summary ?? "",
-		type: f.issuetype?.name ?? "",
-		status: f.status?.name ?? "",
-		statusCategory: f.status?.statusCategory?.key ?? "",
-		assignee: f.assignee?.displayName ?? "Unassigned",
-		reporter: f.reporter?.displayName ?? "",
-		priority: f.priority?.name ?? "",
-		labels: f.labels ?? [],
-		created: f.created ?? "",
-		updated: f.updated ?? "",
-		description: f.description ?? null,
-		comments,
-		attachments: (f.attachment ?? []).map((a) => ({
-			mediaId: a.id,
-			filename: a.filename,
-			url: a.content
-		}))
-	};
-}
-async function updateIssue(client, key, update) {
-	const fields = { description: update.description };
-	if (update.summary !== void 0) fields["summary"] = update.summary;
-	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) => ({
-		author: c.author?.displayName ?? "",
-		created: c.created ?? "",
-		body: c.body ?? null
-	}));
-}
-//#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);
-	if (options.json) term.json(projects);
-	else if (projects.length === 0) term.out("No matching projects.");
-	else term.out(formatProjectRows(projects));
-}
-function formatProjectRows(projects) {
-	const width = Math.max(...projects.map((p) => p.key.length));
-	return projects.map((p) => `${p.key.padEnd(width)}  ${p.name}`);
-}
-async function jiraStatuses({ session, term }, query, options) {
-	let statuses = await listStatuses(session, options.project);
-	if (query) {
-		const needle = query.toLowerCase();
-		statuses = statuses.filter((s) => s.name.toLowerCase().includes(needle));
-	}
-	if (options.json) term.json(statuses);
-	else if (statuses.length === 0) term.out("No matching statuses.");
-	else term.out(formatStatusRows(statuses));
-}
-function formatStatusRows(statuses) {
-	const width = Math.max(...statuses.map((s) => s.name.length));
-	return statuses.map((s) => `${s.name.padEnd(width)}  ${s.category}`);
-}
-async function jiraView({ session, term }, arg, options) {
-	const key = await resolveRef(term.ask, arg, ISSUE_REF);
-	const lines = formatIssueView(await fetchIssue(session, session.site, key), Date.now(), options.allComments ?? false);
-	await term.page(lines.join("\n"), { pager: options.pager });
-}
-const CATEGORY_COLORS = {
-	new: kleur.cyan,
-	indeterminate: kleur.yellow,
-	done: kleur.green
-};
-function colorForCategory(category) {
-	return CATEGORY_COLORS[category] ?? ((text) => text);
-}
-function formatIssueView(issue, nowMs, allComments) {
-	const colorStatus = colorForCategory(issue.statusCategory);
-	return [
-		`${kleur.bold(issue.key)}  ${issue.summary}`,
-		...fieldLines$1([
-			["Type", issue.type],
-			["Status", issue.status && colorStatus(issue.status)],
-			["Assignee", issue.assignee],
-			["Reporter", issue.reporter],
-			["Priority", issue.priority],
-			["Labels", issue.labels.join(", ")],
-			["Created", dateWithAge(issue.created, nowMs)],
-			["Updated", dateWithAge(issue.updated, nowMs)],
-			["URL", issue.url]
-		]),
-		...bodyLines(issue.description),
-		...commentSection(renderedComments(issue.comments), { allComments }),
-		...attachmentSection(issue.attachments)
-	];
-}
-async function jiraCopy(env, arg, options) {
-	await copyIssue(env, await resolveRef(env.term.ask, arg, ISSUE_REF), options.out);
-}
-async function jiraUpdate({ session, term, files }, arg, options) {
-	const file = arg ?? await term.ask.text({
-		message: "Path to the issue Markdown file:",
-		flag: "[file]",
-		required: true
-	});
-	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;
-		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) {
-	env.term.err(`Fetching ${key} ...`);
-	await runCopy(env, planIssueCopy(await fetchIssue(env.session, env.session.site, key), out));
-}
-const ISSUE_REF = {
-	message: "Jira issue key or URL:",
-	flag: "[issue]",
-	parse: parseIssueKey,
-	notFound: (raw) => `Could not find an issue key in "${raw}" (expected e.g. PROJ-123).`
-};
-//#endregion
 //#region src/commands/jira-search.ts
 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
@@ -4462,27 +4868,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 = {
@@ -4490,24 +4905,91 @@ 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));
+	jira.command("attach <issue> <files...>").description("Upload files as attachments to a Jira issue (key or URL)").option("--json", "print the uploaded attachments as JSON").action(jiraAction(jiraAttach));
+	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.1.0";
+var version = "2.3.0";
 //#endregion
 //#region src/cli/build.ts
 const PRODUCTS = {