atlass 1.3.0 → 1.5.0

package/README.md

@@ -163,6 +163,36 @@ filters. Prints one issue per line (`KEY  status  summary`); use `--json` for
 machine output. Only the first `--limit` results are shown (default 25, max
 100).
 
+### List Jira projects
+
+```bash
+atlass jira projects            # every project you can browse
+atlass jira projects pay        # filter by key or name
+atlass jira projects --json     # machine output
+```
+
+A discovery aid for the `--project` filter above: it fetches every project
+(paginated, ordered by key) and prints one per line as an aligned `KEY  Name`
+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.3.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 "";
@@ -1254,13 +1255,16 @@ const FIELDS = [
 	"updated",
 	"attachment"
 ].join(",");
+function browseUrl(site, key) {
+	return `${site}/browse/${key}`;
+}
 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: `${site}/browse/${issue.key}`,
+		url: browseUrl(site, issue.key),
 		summary: f.summary ?? "",
 		type: f.issuetype?.name ?? "",
 		status: f.status?.name ?? "",
@@ -1295,7 +1299,7 @@ async function searchIssues(client, site, params) {
 		key: i.key,
 		status: i.fields?.status?.name ?? "",
 		summary: decodeEntities(i.fields?.summary ?? ""),
-		url: `${site}/browse/${i.key}`
+		url: browseUrl(site, i.key)
 	}));
 }
 function buildJql(params) {
@@ -1308,6 +1312,71 @@ function buildJql(params) {
 	if (clauses.length === 0) clauses.push("updated >= -30d");
 	return `${clauses.join(" AND ")} ORDER BY updated DESC`;
 }
+const PROJECT_PAGE_SIZE = 50;
+async function listProjects(client, site, query) {
+	const projects = [];
+	for (let startAt = 0;;) {
+		const res = await client.getJson(`/rest/api/3/project/search?${projectSearchQuery(query, startAt)}`);
+		const values = res.values ?? [];
+		for (const p of values) projects.push({
+			key: p.key,
+			name: p.name,
+			id: p.id,
+			type: p.projectTypeKey ?? "",
+			url: browseUrl(site, p.key)
+		});
+		if (res.isLast || values.length === 0) break;
+		startAt += values.length;
+	}
+	return projects;
+}
+function projectSearchQuery(query, startAt) {
+	const params = new URLSearchParams({
+		orderBy: "key",
+		maxResults: String(PROJECT_PAGE_SIZE),
+		startAt: String(startAt)
+	});
+	if (query) params.set("query", query);
+	return params.toString();
+}
+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")}"`;
 }
@@ -1320,6 +1389,43 @@ async function fetchComments(client, key) {
 }
 //#endregion
 //#region src/commands/jira.ts
+async function jiraProjects(query, options) {
+	const auth = await requireAuth();
+	const projects = await listProjects(new AtlassianClient(auth), auth.site, query);
+	if (options.json) {
+		console.log(JSON.stringify(projects, null, 2));
+		return;
+	}
+	if (projects.length === 0) {
+		console.log("No matching projects.");
+		return;
+	}
+	for (const line of formatProjectRows(projects)) console.log(line);
+}
+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);
@@ -1470,6 +1576,8 @@ auth.command("login").description("Store site, email, and API token").action(run
 auth.command("logout").description("Remove stored credentials").action(run(logout));
 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.3.0",
+	"version": "1.5.0",
 	"description": "CLI to copy Jira issues and Confluence pages to Markdown, and update Confluence pages.",
 	"license": "MIT",
 	"repository": {