atlass 1.4.0 → 1.5.0

package/README.md

@@ -176,6 +176,23 @@ A discovery aid for the `--project` filter above: it fetches every project
 list. An optional query filters by key or name server-side. `--json` emits
 `{ key, name, id, type, url }` per project.
 
+### List Jira statuses
+
+```bash
+atlass jira statuses                 # every status on the site
+atlass jira statuses progress        # filter by name
+atlass jira statuses --project PROJ  # statuses used by one project
+atlass jira statuses --json          # machine output
+```
+
+A discovery aid for the `--status` filter above. Without `--project` it lists
+every status on the site; with `--project` it lists the statuses that project's
+issue types use (flattened to one list). An optional query filters by name
+(case-insensitive substring). Statuses are collapsed by name and category, then
+ordered by workflow lifecycle (To Do, then In Progress, then Done) and name.
+Prints an aligned `Name  Category` list; `--json` emits
+`{ name, id, category, categoryKey }` per status.
+
 ### Search Confluence pages
 
 ```bash

package/dist/cli.mjs

@@ -8,7 +8,7 @@ import { Entry } from "@napi-rs/keyring";
 import { marked } from "marked";
 import { randomUUID } from "node:crypto";
 //#region package.json
-var version = "1.4.0";
+var version = "1.5.0";
 //#endregion
 //#region src/api/client.ts
 var AtlassianClient = class {
@@ -76,20 +76,21 @@ var AtlassianClient = class {
 		return new Uint8Array(await res.arrayBuffer());
 	}
 };
-function httpError(status, path, body = "") {
-	if (status === 401 || status === 403) return /* @__PURE__ */ new Error("Authentication failed (401/403). Run `atlass auth login` to update your token.");
-	if (status === 404) return /* @__PURE__ */ new Error(`Not found (404): ${path}`);
-	if (status === 409) {
-		const detail = extractError(body);
-		return /* @__PURE__ */ new Error(`Conflict (409): ${detail || "the page changed on the server"}`);
-	}
-	if (status === 413) return /* @__PURE__ */ new Error("Payload too large (413): the page or an attachment exceeds the size limit.");
-	if (status === 400) {
-		const detail = extractError(body);
-		return /* @__PURE__ */ new Error(`Bad request (400): ${detail || path}`);
+var HttpError = class extends Error {
+	status;
+	constructor(status, message) {
+		super(message);
+		this.status = status;
+		this.name = "HttpError";
 	}
-	const detail = extractError(body);
-	return /* @__PURE__ */ new Error(`Request failed (${status}): ${detail || path}`);
+};
+function httpError(status, path, body = "") {
+	if (status === 401 || status === 403) return new HttpError(status, "Authentication failed (401/403). Run `atlass auth login` to update your token.");
+	if (status === 404) return new HttpError(status, `Not found (404): ${path}`);
+	if (status === 409) return new HttpError(status, `Conflict (409): ${extractError(body) || "the page changed on the server"}`);
+	if (status === 413) return new HttpError(status, "Payload too large (413): the page or an attachment exceeds the size limit.");
+	if (status === 400) return new HttpError(status, `Bad request (400): ${extractError(body) || path}`);
+	return new HttpError(status, `Request failed (${status}): ${extractError(body) || path}`);
 }
 function extractError(body) {
 	if (!body) return "";
@@ -1338,6 +1339,44 @@ function projectSearchQuery(query, startAt) {
 	if (query) params.set("query", query);
 	return params.toString();
 }
+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 CATEGORY_LAST = 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] ?? CATEGORY_LAST;
+		return rank(a) - rank(b) || a.name.localeCompare(b.name);
+	});
+}
 function jqlValue(value) {
 	return `"${value.replace(/(["\\])/g, "\\$1")}"`;
 }
@@ -1367,6 +1406,26 @@ 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(query, options) {
+	let statuses = await listStatuses(new AtlassianClient(await requireAuth()), options.project);
+	if (query) {
+		const needle = query.toLowerCase();
+		statuses = statuses.filter((s) => s.name.toLowerCase().includes(needle));
+	}
+	if (options.json) {
+		console.log(JSON.stringify(statuses, null, 2));
+		return;
+	}
+	if (statuses.length === 0) {
+		console.log("No matching statuses.");
+		return;
+	}
+	for (const line of formatStatusRows(statuses)) console.log(line);
+}
+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 jiraCopy(arg, options) {
 	const auth = await requireAuth();
 	const key = await resolveKey(arg);
@@ -1518,6 +1577,7 @@ auth.command("logout").description("Remove stored credentials").action(run(logou
 auth.command("status").description("Show the current login").action(run(status));
 const jira = program.command("jira").description("Jira commands");
 jira.command("projects [query]").description("List projects (optionally filtered by key or name)").option("--json", "output results as JSON").action(run(jiraProjects));
+jira.command("statuses [query]").description("List statuses (optionally filtered by name, scoped with --project)").option("-p, --project <key>", "limit to statuses used by a project").option("--json", "output results as JSON").action(run(jiraStatuses));
 jira.command("copy [issue]").description("Copy a Jira issue (key or URL) to a Markdown file").option("-o, --out <path>", "output file or directory").action(run(jiraCopy));
 jira.command("update [file]").description("Update a Jira issue description from an edited Markdown file").option("--summary", "also push the H1 as the issue summary").option("-f, --force", "skip the stale-issue and data-loss checks").option("--dry-run", "show what would change without writing").action(run(jiraUpdate));
 jira.command("search [query]").description("Search Jira issues (text query, filters, or --jql)").option("-p, --project <key>", "limit to a project").option("-a, --assignee <who>", "limit to an assignee (or 'me')").option("-s, --status <status>", "limit to a status").option("--jql <jql>", "raw JQL query (ignores other filters)").option("-l, --limit <n>", "max results (default 25, max 100)").option("--json", "output results as JSON").option("-c, --copy", "pick results to copy to Markdown").option("-o, --out <dir>", "output directory for --copy").action(run(jiraSearch));

package/package.json

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