atlass 2.1.0 → 2.2.0

package/README.md

@@ -157,6 +157,7 @@ atlass confluence list --space DOCS
 `jira list` shows issues assigned to you as `KEY  Status  Age  Summary`, with
 In Progress first, then To Do, and the most recently updated at the top of each
 group. Done issues are left out; `--all` adds those updated in the last 30 days.
+`--limit` keeps the first rows of that order; without it, all are shown.
 
 `confluence list` shows the pages you starred as `ID  SPACE  Age  Title`, most
 recently updated first. `--limit` works as for search. Star or unstar a page
@@ -175,10 +176,12 @@ atlass confluence search "onboarding" --space DOCS --label runbook
 ```
 
 Jira filters on `--project`, `--assignee`, `--reporter`, `--status`, `--type`,
-`--label`, `--updated` and `--open`; Confluence on `--space`, `--label`,
-`--updated` and `--starred`. Repeating a flag matches any of its values;
-different flags must all match. `--assignee` and `--reporter` take `me`, an
-account id, or a name to look up. `--updated` takes `7d`, `2w`, `3m` or
+`--label`, `--sprint`, `--updated` and `--open`; Confluence on `--space`,
+`--label`, `--updated` and `--starred`. Repeating a flag matches any of its
+values; different flags must all match. `--assignee` and `--reporter` take `me`,
+an account id, or a name to look up. `--sprint` takes `active`, `future`, a
+sprint id, or a sprint name; names can repeat across boards, an id cannot.
+`--updated` takes `7d`, `2w`, `3m` or
 `YYYY-MM-DD`. Results sort by most recently updated and use the same columns
 as `jira list` and `confluence list`.
 
@@ -193,6 +196,19 @@ atlass confluence cql "label = runbook AND creator = currentUser()"
 to pick results interactively and copy each one, with `--out` as the target
 directory. All four work on both search commands.
 
+`--field` adds a field's value to each issue on `jira search`, `jira jql` and
+`jira list`:
+
+```bash
+atlass jira search --assignee me --status Closed --field "Story Points" --json
+```
+
+It takes a field id or a name, ignoring case, and repeats for more fields. A
+name several fields share fails and lists their ids; `atlass jira fields
+--search` finds the one you want. Each field becomes a column after the status.
+With `--json`, each issue gains a `fields` object of raw values keyed by the
+name you passed.
+
 Discovery aids for the filters:
 
 ```bash
@@ -200,6 +216,42 @@ atlass jira projects [query]
 atlass jira statuses [query] [--project PROJ]
 ```
 
+## Boards
+
+```bash
+atlass jira boards [query] [--project PROJ]
+atlass jira board <id|url|name> [--json]
+```
+
+`boards` lists every board as `ID  Type  Name  Project`, filtered by name and
+project key. Boards that span projects leave the project cell empty.
+
+`board` shows one board: the field it estimates with, its filter JQL, and each
+column's statuses with their categories. A name must match exactly, ignoring
+case; if several boards share it, use the id.
+
+## Sprints
+
+```bash
+atlass jira sprints <id|url|name> [--state active|future|closed ...] [--limit N] [--json]
+```
+
+Lists a board's sprints as `ID  State  Name  Start  End`, active only unless
+`--state` says otherwise. Active sprints come first, then future, then closed
+newest first. The board takes the same forms as `board`.
+
+## Fields
+
+```bash
+atlass jira fields [--search TEXT] [--json]
+```
+
+With no project, `fields` lists every field on the site as `ID  Name  Type`,
+sorted by name. `--search` filters by name or id, ignoring case. The type is the
+custom field's plugin type, such as `float` or `gh-sprint`, or the schema type
+for system fields. `--json` carries the full schema, plugin key included. With a
+project, `fields` shows the create form instead (see Create).
+
 ## Bitbucket
 
 `--repo` takes `workspace/slug` or a bare slug under the configured workspace,

package/dist/bitbucket.mjs

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

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

@@ -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));
@@ -447,14 +447,58 @@ function guarded(fn) {
 	};
 }
 function fail(err) {
-	if (isPromptInterrupt(err)) process.exit(SIGINT_EXIT_CODE);
+	if (isPromptInterrupt(err)) {
+		process.exitCode = SIGINT_EXIT_CODE;
+		return;
+	}
 	ttyTerminal().err(`Error: ${err instanceof Error ? err.message : String(err)}`);
-	process.exit(1);
+	process.exitCode = 1;
 }
 function isPromptInterrupt(err) {
 	return err instanceof Error && err.name === "ExitPromptError";
 }
 //#endregion
+//#region src/util/format.ts
+function formatDuration(seconds) {
+	if (seconds == null) return "-";
+	if (seconds < 60) return `${seconds}s`;
+	const m = Math.floor(seconds / 60);
+	const s = seconds % 60;
+	if (m < 60) return `${m}m${String(s).padStart(2, "0")}s`;
+	return `${Math.floor(m / 60)}h${String(m % 60).padStart(2, "0")}m`;
+}
+const pad = (n) => String(n).padStart(2, "0");
+function formatDate$1(iso) {
+	const date = new Date(iso);
+	if (Number.isNaN(date.getTime())) return iso;
+	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+function formatDateTime(iso) {
+	const date = new Date(iso);
+	if (Number.isNaN(date.getTime())) return iso;
+	return `${formatDate$1(iso)} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+const MINUTE = 60;
+const HOUR = 3600;
+const DAY = 24 * HOUR;
+function relativeTime(iso, nowMs) {
+	if (!iso) return "-";
+	const then = Date.parse(iso);
+	if (Number.isNaN(then)) return "-";
+	const secs = Math.floor((nowMs - then) / 1e3);
+	if (secs < MINUTE) return "just now";
+	if (secs < HOUR) return `${Math.floor(secs / MINUTE)}m ago`;
+	if (secs < DAY) return `${Math.floor(secs / HOUR)}h ago`;
+	const days = Math.floor(secs / DAY);
+	if (days < 45) return `${days}d ago`;
+	if (days < 365) return `${Math.floor(days / 30)}mo ago`;
+	return `${Math.floor(days / 365)}y ago`;
+}
+function orList(items) {
+	if (items.length < 3) return items.join(" or ");
+	return `${items.slice(0, -1).join(", ")}, or ${items.at(-1)}`;
+}
+//#endregion
 //#region src/util/parse.ts
 function parseIssueKey(input) {
 	const match = input.toUpperCase().match(/[A-Z][A-Z0-9]+-\d+/);
@@ -469,6 +513,13 @@ function parsePageId(input) {
 	if (fromQuery) return fromQuery[1];
 	return null;
 }
+function parseBoardId(input) {
+	const trimmed = input.trim();
+	if (/^\d+$/.test(trimmed)) return Number(trimmed);
+	if (!/^https?:\/\//i.test(trimmed)) return null;
+	const match = trimmed.match(/\/boards\/(\d+)(?:[/?#]|$)/) ?? trimmed.match(/[?&]rapidView=(\d+)/);
+	return match ? Number(match[1]) : null;
+}
 const PULL_REQUEST_HOSTS = ["bitbucket.org", "www.bitbucket.org"];
 const PULL_REQUEST_PATH = /^\/([^/]+)\/([^/]+)\/pull-requests\/(\d+)(?:\/|$)/;
 function parsePullRequestRef(input) {
@@ -522,6 +573,19 @@ function resolveRepo(flag, config) {
 	};
 	throw new Error(`No repo given. Pass --repo workspace/slug (or a bare slug), or set a default repo at \`atlass bitbucket login\`.`);
 }
+function parseChoices(values, choices, flag) {
+	const picked = /* @__PURE__ */ new Set();
+	const raw = (values ?? []).flatMap((v) => v.split(",")).map((v) => v.trim());
+	for (const value of raw.filter(Boolean)) {
+		const choice = choices.find((c) => c.toLowerCase() === value.toLowerCase());
+		if (!choice) {
+			const expected = orList(choices.map((c) => c.toLowerCase()));
+			throw new Error(`Invalid ${flag} "${value}". Expected ${expected}.`);
+		}
+		picked.add(choice);
+	}
+	return choices.filter((c) => picked.has(c));
+}
 const DEFAULT_LIMIT = 25;
 const MAX_LIMIT = 100;
 function parseLimit(value) {
@@ -768,15 +832,7 @@ const PULL_REQUEST_STATES = [
 	"SUPERSEDED"
 ];
 function parsePullRequestStates(values) {
-	const raw = (values ?? []).flatMap((value) => value.split(","));
-	const states = [];
-	for (const value of raw) {
-		const state = value.trim().toUpperCase();
-		if (!state) continue;
-		if (!PULL_REQUEST_STATES.includes(state)) throw new Error(`Invalid --state "${value.trim()}". Expected ${PULL_REQUEST_STATES.map((s) => s.toLowerCase()).join(", ").replace(/, (?=[^,]*$)/, ", or ")}.`);
-		if (!states.includes(state)) states.push(state);
-	}
-	return states;
+	return parseChoices(values, PULL_REQUEST_STATES, "--state");
 }
 function allPullRequestStates() {
 	return [...PULL_REQUEST_STATES];
@@ -942,43 +998,6 @@ async function listChangedFiles(client, ref, id) {
 	return collectCapped(client, `${pullRequestPath(ref, id, "diffstat")}?pagelen=${PAGELEN}`, 50, toChangedFile);
 }
 //#endregion
-//#region src/util/format.ts
-function formatDuration(seconds) {
-	if (seconds == null) return "-";
-	if (seconds < 60) return `${seconds}s`;
-	const m = Math.floor(seconds / 60);
-	const s = seconds % 60;
-	if (m < 60) return `${m}m${String(s).padStart(2, "0")}s`;
-	return `${Math.floor(m / 60)}h${String(m % 60).padStart(2, "0")}m`;
-}
-const pad = (n) => String(n).padStart(2, "0");
-function formatDate$1(iso) {
-	const date = new Date(iso);
-	if (Number.isNaN(date.getTime())) return iso;
-	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
-}
-function formatDateTime(iso) {
-	const date = new Date(iso);
-	if (Number.isNaN(date.getTime())) return iso;
-	return `${formatDate$1(iso)} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
-}
-const MINUTE = 60;
-const HOUR = 3600;
-const DAY = 24 * HOUR;
-function relativeTime(iso, nowMs) {
-	if (!iso) return "-";
-	const then = Date.parse(iso);
-	if (Number.isNaN(then)) return "-";
-	const secs = Math.floor((nowMs - then) / 1e3);
-	if (secs < MINUTE) return "just now";
-	if (secs < HOUR) return `${Math.floor(secs / MINUTE)}m ago`;
-	if (secs < DAY) return `${Math.floor(secs / HOUR)}h ago`;
-	const days = Math.floor(secs / DAY);
-	if (days < 45) return `${days}d ago`;
-	if (days < 365) return `${Math.floor(days / 30)}mo ago`;
-	return `${Math.floor(days / 365)}y ago`;
-}
-//#endregion
 //#region src/commands/bitbucket-comments.ts
 const MENTION = /@\{([^}]+)\}/g;
 function renderedPrComments(comments, participants) {
@@ -1580,6 +1599,7 @@ function alignedRows(items, nowMs, cells) {
 		const cell = cells(item);
 		return {
 			...cell,
+			columns: cell.columns ?? [],
 			age: relativeTime(cell.timestamp, nowMs),
 			json: { ...item }
 		};
@@ -1587,11 +1607,17 @@ function alignedRows(items, nowMs, cells) {
 	const width = (pick) => Math.max(...rows.map((row) => pick(row).length));
 	const idWidth = width((row) => row.id);
 	const labelWidth = width((row) => row.label);
+	const columnWidths = (rows[0]?.columns ?? []).map((_, i) => width((row) => row.columns[i]));
 	const ageWidth = width((row) => row.age);
 	return rows.map((row) => ({
 		id: row.id,
 		url: row.url,
-		fixedColumns: `${row.id.padEnd(idWidth)}  ${row.color(row.label.padEnd(labelWidth))}  ${row.age.padEnd(ageWidth)}`,
+		fixedColumns: [
+			row.id.padEnd(idWidth),
+			row.color(row.label.padEnd(labelWidth)),
+			...row.columns.map((column, i) => column.padEnd(columnWidths[i])),
+			row.age.padEnd(ageWidth)
+		].join("  "),
 		freeText: row.text,
 		json: row.json
 	}));
@@ -1894,8 +1920,8 @@ 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
@@ -3074,6 +3100,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]}`;
@@ -3336,10 +3367,203 @@ function registerConfluence(confluence) {
 	return confluence;
 }
 //#endregion
+//#region src/api/jira-statuses.ts
+async function listStatuses(client, project) {
+	return dedupeAndSortStatuses((project ? await fetchProjectStatuses(client, project) : await fetchAllStatuses(client)).map(toStatusSummary));
+}
+async function statusesById(client) {
+	const raw = await fetchAllStatuses(client);
+	return new Map(raw.map((s) => [s.id, toStatusSummary(s)]));
+}
+function fetchAllStatuses(client) {
+	return client.getJson("/rest/api/3/status");
+}
+async function fetchProjectStatuses(client, project) {
+	let groups;
+	try {
+		groups = await client.getJson(`/rest/api/3/project/${encodeURIComponent(project)}/statuses`);
+	} catch (err) {
+		if (err instanceof HttpError && err.status === 404) throw new Error(`No project found with key "${project}".`);
+		throw err;
+	}
+	return groups.flatMap((g) => g.statuses ?? []);
+}
+function toStatusSummary(s) {
+	return {
+		name: s.name,
+		id: s.id,
+		category: s.statusCategory?.name ?? "",
+		categoryKey: s.statusCategory?.key ?? ""
+	};
+}
+const CATEGORY_ORDER = {
+	new: 0,
+	indeterminate: 1,
+	done: 2
+};
+const UNKNOWN_CATEGORY_RANK = Object.keys(CATEGORY_ORDER).length;
+function dedupeAndSortStatuses(statuses) {
+	const byNameCategory = /* @__PURE__ */ new Map();
+	for (const s of statuses) {
+		const key = `${s.name}\0${s.categoryKey}`;
+		if (!byNameCategory.has(key)) byNameCategory.set(key, s);
+	}
+	return [...byNameCategory.values()].sort((a, b) => {
+		const rank = (s) => CATEGORY_ORDER[s.categoryKey] ?? UNKNOWN_CATEGORY_RANK;
+		return rank(a) - rank(b) || a.name.localeCompare(b.name);
+	});
+}
+//#endregion
 //#region src/api/jira-url.ts
 function browseUrl(site, key) {
 	return `${site}/browse/${key}`;
 }
+function boardUrl(site, id) {
+	return `${site}/secure/RapidBoard.jspa?rapidView=${id}`;
+}
+//#endregion
+//#region src/api/jira-board.ts
+async function fetchBoard(client, site, id) {
+	const [config, statuses] = await Promise.all([client.getJson(`/rest/agile/1.0/board/${id}/configuration`), statusesById(client)]);
+	const statusFor = (statusId) => statuses.get(statusId) ?? {
+		id: statusId,
+		name: statusId,
+		category: "",
+		categoryKey: ""
+	};
+	return {
+		id: config.id,
+		name: config.name,
+		type: config.type,
+		url: boardUrl(site, config.id),
+		estimation: estimationOf(config),
+		filter: {
+			id: config.filter.id,
+			jql: await visibleFilterJql(client, config.filter.id),
+			subQuery: config.subQuery?.query || null
+		},
+		columns: (config.columnConfig?.columns ?? []).map((c) => ({
+			name: c.name,
+			statuses: (c.statuses ?? []).map((s) => statusFor(s.id))
+		}))
+	};
+}
+async function visibleFilterJql(client, filterId) {
+	try {
+		return (await client.getJson(`/rest/api/3/filter/${filterId}`)).jql ?? null;
+	} catch (err) {
+		if (err instanceof HttpError && err.status === 404) return null;
+		throw err;
+	}
+}
+function estimationOf(config) {
+	const field = config.estimation?.type === "field" ? config.estimation.field : void 0;
+	return field ? {
+		fieldId: field.fieldId,
+		fieldName: field.displayName
+	} : null;
+}
+//#endregion
+//#region src/api/offset-pages.ts
+async function allOffsetPages(client, pathAt) {
+	const all = [];
+	for (let startAt = 0;;) {
+		const res = await client.getJson(pathAt(startAt));
+		const values = res.values ?? [];
+		all.push(...values);
+		if (res.isLast || values.length === 0) return all;
+		startAt += values.length;
+	}
+}
+//#endregion
+//#region src/api/jira-boards.ts
+async function listBoards(client, site) {
+	return (await allOffsetPages(client, (startAt) => `/rest/agile/1.0/board?startAt=${startAt}&maxResults=50`)).map((b) => ({
+		id: b.id,
+		name: b.name,
+		type: b.type,
+		project: b.location?.projectKey ?? null,
+		url: boardUrl(site, b.id)
+	}));
+}
+//#endregion
+//#region src/commands/board-ref.ts
+async function withBoard(session, ref, load) {
+	const id = await resolveBoardId(session, ref);
+	try {
+		return await load(id);
+	} catch (err) {
+		if (isMissingBoard(err, id)) throw unknownBoard(ref);
+		throw err;
+	}
+}
+async function resolveBoardId(session, ref) {
+	const id = parseBoardId(ref);
+	if (id !== null) return id;
+	const name = ref.trim().toLowerCase();
+	const matches = (await listBoards(session, session.site)).filter((b) => b.name.toLowerCase() === name);
+	const [only, ...others] = matches;
+	if (!only) throw unknownBoard(ref);
+	if (others.length === 0) return only.id;
+	const width = Math.max(...matches.map((b) => String(b.id).length));
+	throw new Error([`"${ref}" matches several boards. Use an id:`, ...matches.map((b) => `  ${String(b.id).padEnd(width)}  ${b.name}`)].join("\n"));
+}
+function isMissingBoard(err, id) {
+	return err instanceof HttpError && err.status === 404 && err.path.startsWith(`/rest/agile/1.0/board/${id}/`);
+}
+function unknownBoard(ref) {
+	return /* @__PURE__ */ new Error(`No board matches "${ref}". Run \`atlass jira boards\` to list boards.`);
+}
+//#endregion
+//#region src/commands/jira-board.ts
+async function jiraBoard({ session, term }, ref, options) {
+	const board = await withBoard(session, ref, (id) => fetchBoard(session, session.site, id));
+	if (options.json) term.json(board);
+	else term.out(formatBoard(board));
+}
+function formatBoard(board) {
+	return [
+		board.name,
+		...fieldLines$1([
+			["ID", String(board.id)],
+			["Type", board.type],
+			["Estimation", estimationLine(board)],
+			["Filter", board.filter.jql ?? `not visible to you (filter ${board.filter.id})`],
+			["Sub-filter", board.filter.subQuery ?? ""],
+			["URL", board.url]
+		]),
+		"",
+		...columnLines(board)
+	];
+}
+function estimationLine({ estimation }) {
+	return estimation ? `${estimation.fieldName} (${estimation.fieldId})` : "none, this board does not estimate with a field";
+}
+function columnLines({ columns }) {
+	const statuses = columns.flatMap((c) => c.statuses);
+	const width = Math.max(0, ...statuses.map((s) => s.name.length));
+	return columns.flatMap((c) => [c.name, ...c.statuses.map((s) => `  ${s.name.padEnd(width)}  ${s.category}`.trimEnd())]);
+}
+//#endregion
+//#region src/commands/jira-boards.ts
+async function jiraBoards({ session, term }, query, options) {
+	const boards = filterBoards(await listBoards(session, session.site), query, options.project);
+	if (options.json) term.json(boards);
+	else if (boards.length === 0) term.out("No matching boards.");
+	else term.out(formatBoardRows(boards));
+}
+function filterBoards(boards, query, project) {
+	const needle = query?.toLowerCase();
+	const key = project?.toUpperCase();
+	return boards.filter((b) => (!needle || b.name.toLowerCase().includes(needle)) && (!key || b.project?.toUpperCase() === key));
+}
+function formatBoardRows(boards) {
+	const width = (pick) => Math.max(...boards.map((b) => pick(b).length));
+	const idWidth = width((b) => String(b.id));
+	const typeWidth = width((b) => b.type);
+	const nameWidth = width((b) => b.name);
+	return boards.map((b) => `${String(b.id).padEnd(idWidth)}  ${b.type.padEnd(typeWidth)}  ${b.name.padEnd(nameWidth)}  ${b.project ?? ""}`.trimEnd());
+}
 //#endregion
 //#region src/api/jira-createmeta.ts
 const CREATEMETA_PAGE_SIZE = 200;
@@ -3432,28 +3656,19 @@ function toJiraUser(u) {
 }
 //#endregion
 //#region src/api/jira-projects.ts
-const PROJECT_PAGE_SIZE = 50;
 async function listProjects(client, site, query) {
-	const projects = [];
-	for (let startAt = 0;;) {
-		const res = await client.getJson(`/rest/api/3/project/search?${projectSearchQuery(query, startAt)}`);
-		const values = res.values ?? [];
-		for (const p of values) projects.push({
-			key: p.key,
-			name: p.name,
-			id: p.id,
-			type: p.projectTypeKey ?? "",
-			url: browseUrl(site, p.key)
-		});
-		if (res.isLast || values.length === 0) break;
-		startAt += values.length;
-	}
-	return projects;
+	return (await allOffsetPages(client, (startAt) => `/rest/api/3/project/search?${projectSearchQuery(query, startAt)}`)).map((p) => ({
+		key: p.key,
+		name: p.name,
+		id: p.id,
+		type: p.projectTypeKey ?? "",
+		url: browseUrl(site, p.key)
+	}));
 }
 function projectSearchQuery(query, startAt) {
 	const params = new URLSearchParams({
 		orderBy: "key",
-		maxResults: String(PROJECT_PAGE_SIZE),
+		maxResults: String(50),
 		startAt: String(startAt)
 	});
 	if (query) params.set("query", query);
@@ -4098,17 +4313,55 @@ function describeRejection(err, meta) {
 		...perField
 	].join("\n"));
 }
-async function jiraFields({ session, term }, projectArg, typeArg, options) {
+//#endregion
+//#region src/api/jira-fields.ts
+async function listSiteFields(client) {
+	return (await client.getJson("/rest/api/3/field")).map((f) => ({
+		id: f.id,
+		name: decodeEntities(f.name),
+		custom: f.custom ?? false,
+		schema: f.schema ?? null
+	}));
+}
+//#endregion
+//#region src/commands/jira-fields.ts
+async function jiraFields(env, projectArg, typeArg, options) {
+	if (!projectArg) return siteFields(env, options);
 	const project = projectArg.toUpperCase();
+	if (options.search !== void 0) throw new Error(`--search lists site fields and takes no project. Drop ${project}, or run \`atlass jira fields ${project}\` alone.`);
+	return createForm$1(env, project, typeArg, options);
+}
+async function siteFields({ session, term }, options) {
+	const fields = matchingFields(await listSiteFields(session), options.search).sort((a, b) => a.name.localeCompare(b.name, void 0, { sensitivity: "base" }));
+	if (options.json) term.json(fields);
+	else if (fields.length === 0) term.out("No matching fields.");
+	else term.out(formatSiteFieldRows(fields));
+}
+function matchingFields(fields, search) {
+	const needle = search?.toLowerCase();
+	return fields.filter((f) => !needle || f.name.toLowerCase().includes(needle) || f.id.toLowerCase().includes(needle));
+}
+function formatSiteFieldRows(fields) {
+	const width = (pick) => Math.max(...fields.map((f) => pick(f).length));
+	const idWidth = width((f) => f.id);
+	const nameWidth = width((f) => f.name);
+	return fields.map((f) => `${f.id.padEnd(idWidth)}  ${f.name.padEnd(nameWidth)}  ${shortFieldType(f)}`.trimEnd());
+}
+function shortFieldType(field) {
+	const plugin = field.schema?.custom;
+	if (plugin) return plugin.slice(plugin.lastIndexOf(":") + 1);
+	return field.schema?.type ?? "";
+}
+async function createForm$1({ session, term }, project, typeArg, { json }) {
 	const types = await fetchCreateIssueTypes(session, project);
 	if (!typeArg) {
-		if (options.json) term.json(types);
+		if (json) term.json(types);
 		else if (types.length === 0) term.out(`You cannot create issues in ${project}.`);
 		else term.out(formatIssueTypeRows(types));
 		return;
 	}
 	const fields = await fetchCreateFields(session, project, (await resolveType(term.ask, project, types, typeArg, true)).id);
-	if (options.json) term.json(fields);
+	if (json) term.json(fields);
 	else term.out(formatFieldRows(fields));
 }
 //#endregion
@@ -4116,23 +4369,23 @@ async function jiraFields({ session, term }, projectArg, typeArg, options) {
 const RECENT_ISSUES_CLAUSE = "updated >= -30d";
 const OPEN_CLAUSE = "statusCategory != Done";
 const SEARCH_FIELDS = "summary,status,updated";
-async function searchIssues(client, site, params) {
-	return searchIssuesByJql(client, site, buildJql(params), params.limit);
+async function searchIssues(client, site, params, fieldIds = []) {
+	return searchIssuesByJql(client, site, buildJql(params), params.limit, fieldIds);
 }
-async function searchIssuesByJql(client, site, jql, limit) {
-	return ((await fetchSearchPage(client, jql, limit)).issues ?? []).map((i) => toIssueSummary(site, i));
+async function searchIssuesByJql(client, site, jql, limit, fieldIds = []) {
+	return ((await fetchSearchPage(client, jql, limit, fieldIds)).issues ?? []).map((i) => toIssueSummary(site, i, fieldIds));
 }
-async function fetchSearchPage(client, jql, maxResults, nextPageToken) {
+async function fetchSearchPage(client, jql, maxResults, fieldIds, nextPageToken) {
 	const query = new URLSearchParams({
 		jql,
 		maxResults: String(maxResults),
-		fields: SEARCH_FIELDS
+		fields: [SEARCH_FIELDS, ...fieldIds].join(",")
 	});
 	if (nextPageToken) query.set("nextPageToken", nextPageToken);
 	return client.getJson(`/rest/api/3/search/jql?${query.toString()}`);
 }
-function toIssueSummary(site, i) {
-	return {
+function toIssueSummary(site, i, fieldIds) {
+	const summary = {
 		key: i.key,
 		status: i.fields?.status?.name ?? "",
 		statusCategory: i.fields?.status?.statusCategory?.key ?? "",
@@ -4140,6 +4393,11 @@ function toIssueSummary(site, i) {
 		updated: i.fields?.updated ?? "",
 		url: browseUrl(site, i.key)
 	};
+	if (fieldIds.length === 0) return summary;
+	return {
+		...summary,
+		fields: Object.fromEntries(fieldIds.map((id) => [id, i.fields?.[id] ?? null]))
+	};
 }
 const ISSUE_ORDER = "updated DESC";
 function buildJql(params) {
@@ -4151,12 +4409,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 +4434,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 +4466,54 @@ function sortByCategoryThenUpdated(issues) {
 	return [...issues].sort((a, b) => rank(a) - rank(b) || updatedMs(b) - updatedMs(a));
 }
 //#endregion
+//#region src/commands/jira-field-columns.ts
+async function resolveFieldColumns(session, given) {
+	const names = values(given);
+	if (names.length === 0) return [];
+	const fields = await listSiteFields(session);
+	return names.map((name) => ({
+		name,
+		id: resolveFieldId(fields, name)
+	}));
+}
+function resolveFieldId(fields, name) {
+	const byId = fields.find((f) => f.id === name);
+	if (byId) return byId.id;
+	const lower = name.toLowerCase();
+	const matches = fields.filter((f) => f.name.toLowerCase() === lower);
+	const [only, ...others] = matches;
+	if (!only) throw new Error(`No field matches "${name}". Run \`atlass jira fields --search ${shellWord(name)}\` to find it.`);
+	if (others.length === 0) return only.id;
+	const width = Math.max(...matches.map((f) => f.id.length));
+	throw new Error([`"${name}" matches several fields. Use an id:`, ...matches.map((f) => `  ${f.id.padEnd(width)}  ${f.name}`)].join("\n"));
+}
+function shellWord(text) {
+	return /\s/.test(text) ? `"${text}"` : text;
+}
+function fieldIds(columns) {
+	return [...new Set(columns.map((c) => c.id))];
+}
+function withNamedFields(issues, columns) {
+	if (columns.length === 0) return issues;
+	return issues.map((issue) => ({
+		...issue,
+		fields: Object.fromEntries(columns.map((c) => [c.name, issue.fields?.[c.id] ?? null]))
+	}));
+}
+const EMPTY_CELL = "-";
+function fieldCell(value) {
+	const text = (Array.isArray(value) ? value.map(shownValue) : [shownValue(value)]).filter((p) => p !== "").join(", ");
+	return text === "" ? EMPTY_CELL : text;
+}
+function shownValue(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	const named = value;
+	const shown = named.value ?? named.displayName ?? named.name;
+	return shown === void 0 ? JSON.stringify(value) : shownValue(shown);
+}
+//#endregion
 //#region src/commands/jira-filters.ts
 const FILTER_FLAGS = [
 	"project",
@@ -4205,7 +4521,8 @@ const FILTER_FLAGS = [
 	"reporter",
 	"status",
 	"type",
-	"label"
+	"label",
+	"sprint"
 ];
 const ISSUE_KEY = /^[A-Z][A-Z0-9]+-\d+$/i;
 function hasFilters(filters) {
@@ -4224,6 +4541,7 @@ async function searchParams(client, query, filters, limit, nowMs) {
 		status: filters.status,
 		type: filters.type,
 		label: filters.label,
+		sprint: filters.sprint,
 		updatedSince: filters.updated ? parseSince(filters.updated, nowMs) : void 0,
 		open: filters.open,
 		limit
@@ -4307,46 +4625,6 @@ async function fetchComments(client, key) {
 	}));
 }
 //#endregion
-//#region src/api/jira-statuses.ts
-async function listStatuses(client, project) {
-	return dedupeAndSortStatuses((project ? await fetchProjectStatuses(client, project) : await client.getJson("/rest/api/3/status")).map(toStatusSummary));
-}
-async function fetchProjectStatuses(client, project) {
-	let groups;
-	try {
-		groups = await client.getJson(`/rest/api/3/project/${encodeURIComponent(project)}/statuses`);
-	} catch (err) {
-		if (err instanceof HttpError && err.status === 404) throw new Error(`No project found with key "${project}".`);
-		throw err;
-	}
-	return groups.flatMap((g) => g.statuses ?? []);
-}
-function toStatusSummary(s) {
-	return {
-		name: s.name,
-		id: s.id,
-		category: s.statusCategory?.name ?? "",
-		categoryKey: s.statusCategory?.key ?? ""
-	};
-}
-const CATEGORY_ORDER = {
-	new: 0,
-	indeterminate: 1,
-	done: 2
-};
-const UNKNOWN_CATEGORY_RANK = Object.keys(CATEGORY_ORDER).length;
-function dedupeAndSortStatuses(statuses) {
-	const byNameCategory = /* @__PURE__ */ new Map();
-	for (const s of statuses) {
-		const key = `${s.name}\0${s.categoryKey}`;
-		if (!byNameCategory.has(key)) byNameCategory.set(key, s);
-	}
-	return [...byNameCategory.values()].sort((a, b) => {
-		const rank = (s) => CATEGORY_ORDER[s.categoryKey] ?? UNKNOWN_CATEGORY_RANK;
-		return rank(a) - rank(b) || a.name.localeCompare(b.name);
-	});
-}
-//#endregion
 //#region src/commands/jira.ts
 async function jiraProjects({ session, term }, query, options) {
 	const projects = await listProjects(session, session.site, query);
@@ -4443,18 +4721,20 @@ async function jiraSearch(env, query, options) {
 	const { session } = env;
 	checkQuery(query, options);
 	const limit = checkedLimit(options);
+	const columns = await resolveFieldColumns(session, options.field);
 	const params = await searchParams(session, query, options, limit, Date.now());
-	await showIssues(env, await searchIssues(session, session.site, params).catch((err) => {
+	await showIssues(env, withNamedFields(await searchIssues(session, session.site, params, fieldIds(columns)).catch((err) => {
 		throw searchHint(err, options.project);
-	}), limit, options);
+	}), columns), columns, limit, options);
 }
 async function jiraJql(env, query, options) {
 	const { session } = env;
 	const limit = checkedLimit(options);
-	await showIssues(env, await searchIssuesByJql(session, session.site, query, limit), limit, options);
+	const columns = await resolveFieldColumns(session, options.field);
+	await showIssues(env, withNamedFields(await searchIssuesByJql(session, session.site, query, limit, fieldIds(columns)), columns), columns, limit, options);
 }
-async function showIssues(env, issues, limit, options, empty = "No matching issues.") {
-	await showRows(env.term, formatIssueRows(issues, Date.now()), {
+async function showIssues(env, issues, columns, limit, options, empty = "No matching issues.") {
+	await showRows(env.term, formatIssueRows(issues, Date.now(), columns), {
 		empty,
 		hasMore: issues.length === limit,
 		limit
@@ -4462,27 +4742,36 @@ async function showIssues(env, issues, limit, options, empty = "No matching issu
 }
 async function jiraList(env, options) {
 	const { session, term } = env;
-	checkedLimit(options);
+	const limit = checkedLimit(options);
+	const columns = await resolveFieldColumns(session, options.field);
 	const { issues, truncated } = await listAssignedIssues(session, session.site, {
 		all: options.all,
 		project: options.project
-	});
-	await runSearch(term, formatIssueRows(sortByCategoryThenUpdated(issues), Date.now()), {
+	}, fieldIds(columns));
+	const sorted = sortByCategoryThenUpdated(withNamedFields(issues, columns));
+	const shown = options.limit === void 0 ? sorted : sorted.slice(0, limit);
+	await runSearch(term, formatIssueRows(shown, Date.now(), columns), {
 		json: options.json,
 		copy: options.copy,
 		out: options.out,
 		empty: options.all ? "No issues assigned to you." : "No open issues assigned to you.",
-		footer: truncated ? `\nShowing the first ${issues.length}; narrow with --project.` : void 0
+		footer: listFooter(shown.length, sorted.length, truncated, limit)
 	}, ISSUE_NOUN, (key) => copyIssue(env, key, options.out));
 }
-function formatIssueRows(issues, nowMs) {
+function listFooter(shown, fetched, truncated, limit) {
+	if (shown < fetched) return searchFooter(limit);
+	if (truncated) return `
+Showing the first ${shown}; narrow with --project.`;
+}
+function formatIssueRows(issues, nowMs, columns = []) {
 	return alignedRows(issues, nowMs, (i) => ({
 		id: i.key,
 		url: i.url,
 		label: i.status,
 		color: colorForCategory(i.statusCategory),
 		text: i.summary,
-		timestamp: i.updated
+		timestamp: i.updated,
+		columns: columns.map((c) => fieldCell(i.fields?.[c.name]))
 	}));
 }
 const ISSUE_NOUN = {
@@ -4490,24 +4779,90 @@ const ISSUE_NOUN = {
 	plural: "issues"
 };
 //#endregion
+//#region src/api/jira-types.ts
+const SPRINT_STATES = [
+	"active",
+	"future",
+	"closed"
+];
+//#endregion
+//#region src/api/jira-sprints.ts
+async function listSprints(client, boardId, states) {
+	const state = states.join(",");
+	return (await allOffsetPages(client, (startAt) => `/rest/agile/1.0/board/${boardId}/sprint?state=${state}&startAt=${startAt}&maxResults=50`)).toSorted(byRelevance).map((s) => ({
+		id: s.id,
+		state: s.state,
+		name: s.name,
+		start: s.startDate ?? null,
+		end: s.endDate ?? null,
+		boardId: s.originBoardId ?? boardId
+	}));
+}
+function byRelevance(a, b) {
+	const rank = SPRINT_STATES.indexOf(a.state) - SPRINT_STATES.indexOf(b.state);
+	if (rank !== 0 || a.state !== "closed") return rank;
+	return finishedAt(b) - finishedAt(a);
+}
+function finishedAt(sprint) {
+	return Date.parse(sprint.completeDate ?? sprint.endDate ?? "") || 0;
+}
+//#endregion
+//#region src/commands/jira-sprints.ts
+async function jiraSprints({ session, term }, ref, options) {
+	const chosen = parseChoices(options.state, SPRINT_STATES, "--state");
+	const states = chosen.length > 0 ? chosen : ["active"];
+	const limit = parseLimit(options.limit);
+	const sprints = await withBoard(session, ref, (id) => listSprints(session, id, states).catch((err) => {
+		throw withoutSprints(err, id);
+	}));
+	const shown = sprints.slice(0, limit);
+	if (options.json) term.json(shown);
+	else if (shown.length === 0) term.out(`No ${orList(states)} sprints.`);
+	else if (sprints.length > limit) term.out([...formatSprintRows(shown), searchFooter(limit)]);
+	else term.out(formatSprintRows(shown));
+}
+function withoutSprints(err, id) {
+	if (!(err instanceof HttpError) || err.status !== 400) return err;
+	return /* @__PURE__ */ new Error(`Board ${id} does not support sprints. Only scrum boards have them.`);
+}
+function formatSprintRows(sprints) {
+	const cells = sprints.map((s) => [
+		String(s.id),
+		s.state,
+		s.name,
+		s.start ? formatDate$1(s.start) : "-",
+		s.end ? formatDate$1(s.end) : "-"
+	]);
+	const widths = cells[0].map((_, i) => Math.max(...cells.map((row) => row[i].length)));
+	return cells.map((row) => row.map((cell, i) => cell.padEnd(widths[i])).join("  ").trimEnd());
+}
+//#endregion
 //#region src/cli/jira.ts
+const FIELD_OPTION = [
+	"-f, --field <name|id>",
+	"add a field's value to each issue (repeatable)",
+	collect
+];
 function registerJira(jira) {
 	jira.description("Jira commands");
 	jira.command("projects [query]").description("List projects (optionally filtered by key or name)").option("--json", "output results as JSON").action(jiraAction(jiraProjects));
 	jira.command("statuses [query]").description("List statuses (optionally filtered by name, scoped with --project)").option("-p, --project <key>", "limit to statuses used by a project").option("--json", "output results as JSON").action(jiraAction(jiraStatuses));
+	jira.command("boards [query]").description("List boards (optionally filtered by name, scoped with --project)").option("-p, --project <key>", "limit to boards located in a project").option("--json", "output results as JSON").action(jiraAction(jiraBoards));
+	jira.command("board <ref>").description("Show a board's estimation field, filter JQL and columns (id, URL or exact name)").option("--json", "output results as JSON").action(jiraAction(jiraBoard));
+	jira.command("sprints <ref>").description("List a board's sprints, active by default (id, URL or exact name)").option("-s, --state <state>", "active, future, or closed (repeatable)", collect).option("-l, --limit <n>", "max results (default 25, max 100)").option("--json", "output results as JSON").action(jiraAction(jiraSprints));
 	jira.command("create [project] [type]").description("Create a Jira issue, prompting for fields or taking them all as flags").option("-s, --summary <text>", "issue summary").option("-d, --description <markdown>", "description as Markdown").option("--description-file <path>", "read the description from a Markdown file").option("-a, --assignee <who>", "assignee: me, an account id, or a name to look up").option("--priority <name>", "priority name").option("-l, --label <label>", "label (repeatable)", collect).option("-c, --component <name>", "component (repeatable)", collect).option("--parent <key>", "parent issue key for subtasks").option("-f, --field <name=value>", "any other create-screen field (repeatable)", collect).option("--dry-run", "print the resolved payload instead of creating").option("--json", "print the created issue as JSON").action(jiraAction(jiraCreate));
-	jira.command("fields <project> [type]").description("Show the issue types you can create in a project, or the create form for one type").option("--json", "output results as JSON").action(jiraAction(jiraFields));
+	jira.command("fields [project] [type]").description("List site fields, or the issue types a project offers, or the create form for one type").option("--search <text>", "site fields only: filter by name or id").option("--json", "output results as JSON").action(jiraAction(jiraFields));
 	jira.command("view [issue]").description("Show a Jira issue (key or URL) in the terminal").option("--all-comments", "show all comments instead of the last 5").option("--no-pager", "print directly instead of paging long output").action(jiraAction(jiraView));
 	jira.command("copy [issue]").description("Copy a Jira issue (key or URL) to a Markdown file").option("-o, --out <path>", "output file or directory").action(jiraAction(jiraCopy));
 	jira.command("update [file]").description("Update a Jira issue description from an edited Markdown file").option("--summary", "also push the H1 as the issue summary").option("-f, --force", "skip the stale-issue and data-loss checks").option("--dry-run", "show what would change without writing").action(jiraAction(jiraUpdate));
-	outputOptions(jira.command("list").description("List open issues assigned to you").option("-p, --project <key>", "limit to a project").option("-a, --all", "include Done issues updated in the last 30 days")).action(jiraAction(jiraList));
-	outputOptions(jira.command("search [query]").description("Search Jira issues by text and filters").option("-p, --project <key>", "limit to a project (repeatable)", collect).option("-a, --assignee <who>", "limit to an assignee: me, a name, or an account id", collect).option("--reporter <who>", "limit to a reporter: me, a name, or an account id", collect).option("-s, --status <status>", "limit to a status (repeatable)", collect).option("-t, --type <type>", "limit to an issue type (repeatable)", collect).option("--label <label>", "limit to a label (repeatable)", collect).option("-u, --updated <when>", "changed since 7d, 2w, 3m, or YYYY-MM-DD").option("--open", "exclude issues in the Done category").addOption(moved("--jql <jql>", "jira jql"))).action(jiraAction(jiraSearch));
-	outputOptions(jira.command("jql <query>").description("Search Jira issues with a raw JQL query")).action(jiraAction(jiraJql));
+	outputOptions(jira.command("list").description("List open issues assigned to you").option("-p, --project <key>", "limit to a project").option("-a, --all", "include Done issues updated in the last 30 days").option(...FIELD_OPTION), "max results (default all, max 100)").action(jiraAction(jiraList));
+	outputOptions(jira.command("search [query]").description("Search Jira issues by text and filters").option("-p, --project <key>", "limit to a project (repeatable)", collect).option("-a, --assignee <who>", "limit to an assignee: me, a name, or an account id", collect).option("--reporter <who>", "limit to a reporter: me, a name, or an account id", collect).option("-s, --status <status>", "limit to a status (repeatable)", collect).option("-t, --type <type>", "limit to an issue type (repeatable)", collect).option("--label <label>", "limit to a label (repeatable)", collect).option("--sprint <sprint>", "limit to a sprint: active, future, an id, or a name (repeatable)", collect).option("-u, --updated <when>", "changed since 7d, 2w, 3m, or YYYY-MM-DD").option("--open", "exclude issues in the Done category").option(...FIELD_OPTION).addOption(moved("--jql <jql>", "jira jql"))).action(jiraAction(jiraSearch));
+	outputOptions(jira.command("jql <query>").description("Search Jira issues with a raw JQL query").option(...FIELD_OPTION)).action(jiraAction(jiraJql));
 	return jira;
 }
 //#endregion
 //#region package.json
-var version = "2.1.0";
+var version = "2.2.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-_4VuIcqF.mjs";
+import { r as fail, t as buildAtlass } from "./build-H7eTLrf3.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-_4VuIcqF.mjs";
+import { n as buildStandalone, r as fail } from "./build-H7eTLrf3.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-_4VuIcqF.mjs";
+import { n as buildStandalone, r as fail } from "./build-H7eTLrf3.mjs";
 //#region src/jira.ts
 buildStandalone("jira").parseAsync().catch(fail);
 //#endregion

package/package.json

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