atlass 1.3.0 → 1.4.0

package/README.md

@@ -163,6 +163,19 @@ 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.
+
 ### 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.4.0";
 //#endregion
 //#region src/api/client.ts
 var AtlassianClient = class {
@@ -1254,13 +1254,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 +1298,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 +1311,33 @@ 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();
+}
 function jqlValue(value) {
 	return `"${value.replace(/(["\\])/g, "\\$1")}"`;
 }
@@ -1320,6 +1350,23 @@ 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 jiraCopy(arg, options) {
 	const auth = await requireAuth();
 	const key = await resolveKey(arg);
@@ -1470,6 +1517,7 @@ 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("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.4.0",
 	"description": "CLI to copy Jira issues and Confluence pages to Markdown, and update Confluence pages.",
 	"license": "MIT",
 	"repository": {