atlass 2.2.0 → 2.3.0

package/README.md

@@ -103,10 +103,26 @@ line, or the first `## Comments` or `## Attachments` in older copies.
   overwriting.
 - Confluence uploads local images referenced in the body as attachments. Jira
   update does not support image changes yet.
+- Embedded videos are set to the full width of the text column. Images keep
+  their natural size.
 - After an update, the new `updated` (and for Confluence, `version`, and `title`
   with `--title`) is written back to the frontmatter, so the file can be pushed
   again without a fresh copy.
 
+## Attach
+
+```bash
+atlass jira attach PROJ-123 screenshot.png logs.zip
+atlass confluence attach 123456 diagram.png --comment "v2 layout"
+```
+
+Uploads files as new attachments, one request per file. Every file is read
+before anything uploads, and the first failed upload stops the run. `--json`
+prints the filename, id, and size of each attachment.
+
+Jira keeps duplicate filenames side by side. Confluence refuses a filename the
+page already has, checked before any upload. `--comment` is Confluence only.
+
 ## Create
 
 ```bash

package/dist/bitbucket.mjs

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

package/dist/{build-H7eTLrf3.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";
@@ -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: {
@@ -1924,6 +1925,373 @@ 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/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()];
+}
+function isVideo(href) {
+	return mediaType(href.split(/[?#]/)[0] ?? "")?.startsWith("video/") ?? false;
+}
+//#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 uploadPath(pageId) {
+	return `/wiki/rest/api/content/${encodeURIComponent(pageId)}/child/attachment`;
+}
+async function uploadAttachment(client, pageId, filename, bytes) {
+	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);
+	if (match) return match.fileId;
+	throw new Error(`Upload of "${filename}" did not return a fileId.`);
+}
+async function fetchAttachments(client, id) {
+	return (await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/attachments?limit=250`)).results.filter((a) => a.downloadLink).map((a) => ({
+		mediaId: mediaNodeId(a),
+		filename: a.title ?? a.id,
+		url: withWikiContextPath(a.downloadLink ?? "")
+	}));
+}
+function mediaNodeId(a) {
+	return a.fileId ?? a.id;
+}
+function withWikiContextPath(link) {
+	if (link.startsWith("http") || link.startsWith("/wiki")) return link;
+	return `/wiki${link}`;
+}
+//#endregion
+//#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
+	}));
+}
+async function attachAll(term, target, local, options, upload) {
+	const attached = [];
+	for (const file of local) {
+		term.err(`Uploading ${file.filename} ...`);
+		try {
+			attached.push(await upload(file));
+		} catch (err) {
+			if (attached.length > 0) term.err(`Already attached to ${target}: ${names(attached)}.`);
+			throw err;
+		}
+	}
+	if (options.json) term.json(attached);
+	else term.out(`Attached ${names(attached)} to ${target}.`);
+}
+function names(attached) {
+	return attached.map((a) => a.filename).join(", ");
+}
+//#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;
+}
+//#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;
@@ -1945,38 +2313,6 @@ async function createPage(client, page) {
 	};
 }
 //#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
-	}));
-}
-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);
-}
-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.`);
-}
-async function fetchAttachments(client, id) {
-	return (await client.getJson(`/wiki/api/v2/pages/${encodeURIComponent(id)}/attachments?limit=250`)).results.filter((a) => a.downloadLink).map((a) => ({
-		mediaId: mediaNodeId(a),
-		filename: a.title ?? a.id,
-		url: withWikiContextPath(a.downloadLink ?? "")
-	}));
-}
-function mediaNodeId(a) {
-	return a.fileId ?? a.id;
-}
-function withWikiContextPath(link) {
-	if (link.startsWith("http") || link.startsWith("/wiki")) return 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`);
@@ -2107,12 +2443,18 @@ function counted(n, noun) {
 }
 //#endregion
 //#region src/adf/from-markdown.ts
-function mediaNode(source, alt) {
+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: { layout: "center" },
+		attrs: isVideo(href) ? TEXT_WIDTH : NATURAL_SIZE,
 		content: [{
 			type: "media",
 			attrs
@@ -2299,7 +2641,7 @@ function externalMedia(href, alt) {
 	return mediaNode({
 		type: "external",
 		url: href
-	}, alt);
+	}, alt, href);
 }
 function textToken(text) {
 	return {
@@ -2484,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,
@@ -2573,274 +2915,40 @@ async function pushPage({ session, term, files }, content, push) {
 	}
 	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 { size: await files.size(path) };
-	} catch {
-		return {};
-	}
-}
-//#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) {
-	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;
+		nextVersion: push.nextVersion,
+		body: withUploadedIds(content.body, ids),
+		message: push.message
+	});
 }
-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;
+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)
+		};
+	}));
 }
-function isMarker(line) {
-	return line.trimEnd() === GENERATED_MARKER;
+async function fileSize(files, path) {
+	try {
+		return { size: await files.size(path) };
+	} catch {
+		return {};
+	}
 }
-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");
+//#endregion
+//#region src/api/confluence-favourites.ts
+function favouritePath(id) {
+	return `/wiki/rest/api/relation/favourite/from/user/current/to/content/${encodeURIComponent(id)}`;
 }
-function attachmentsSection(attachments) {
-	if (attachments.length === 0) return "";
-	const items = attachments.map((a) => `- [${a.filename}](${a.relativePath})`);
-	return [
-		ATTACHMENTS_HEADING,
-		"",
-		...items
-	].join("\n");
+async function starPage(client, id) {
+	await client.putNoContent(favouritePath(id), void 0);
 }
-//#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
@@ -3359,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));
@@ -3367,6 +3476,112 @@ function registerConfluence(confluence) {
 	return confluence;
 }
 //#endregion
+//#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));
@@ -3375,51 +3590,140 @@ 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");
+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 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 ?? []);
+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 }));
+	});
 }
-function toStatusSummary(s) {
-	return {
-		name: s.name,
-		id: s.id,
-		category: s.statusCategory?.name ?? "",
-		categoryKey: s.statusCategory?.key ?? ""
-	};
+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 CATEGORY_ORDER = {
-	new: 0,
-	indeterminate: 1,
-	done: 2
+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).`
 };
-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}`;
+//#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
@@ -3464,18 +3768,6 @@ function estimationOf(config) {
 	} : 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) => ({
@@ -3655,26 +3947,6 @@ function toJiraUser(u) {
 	};
 }
 //#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/commands/jira-create-resolve.ts
 async function resolveProject(ask, client, site, arg, strict) {
 	if (arg) return arg.toUpperCase();
@@ -4570,152 +4842,6 @@ 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/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;
@@ -4855,6 +4981,7 @@ function registerJira(jira) {
 	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));
+	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));
@@ -4862,7 +4989,7 @@ function registerJira(jira) {
 }
 //#endregion
 //#region package.json
-var version = "2.2.0";
+var version = "2.3.0";
 //#endregion
 //#region src/cli/build.ts
 const PRODUCTS = {

package/dist/cli.mjs

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

package/dist/confluence.mjs

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

package/dist/jira.mjs

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

package/package.json

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