@kendoo.agentdesk/agentdesk 0.18.0 → 0.18.1

package/CHANGELOG.md

@@ -8,6 +8,11 @@ All user-facing changes to AgentDesk. Each entry is tagged:
 
 Internal refactors, infrastructure changes, and architectural notes are not listed here.
 
+## [0.18.1] — 2026-04-18
+
+### Fixed
+- `[CLI]` Jira permission check now trims a trailing slash from the stored base URL (a leftover double-slash could produce a spurious 404) and falls back to REST API v2 if v3 isn't exposed. The error message now includes the exact URL called so misconfigs are easier to diagnose.
+
 ## [0.18.0] — 2026-04-18
 
 ### Changed

package/cli/tracker-check.mjs

@@ -94,9 +94,13 @@ async function checkJira({ baseUrl, project }, creds) {
   let identity = null;
   const auth = "Basic " + Buffer.from(`${email}:${token}`).toString("base64");
 
+  // Normalize the base URL: trim trailing slashes, so `...net/` doesn't
+  // produce `...net//rest/...` which some Atlassian paths reject.
+  const cleanBase = String(baseUrl || "").replace(/\/+$/, "");
+
   // Fetch the authenticated user so we can report "Posting as X".
   try {
-    const meRes = await fetch(`${baseUrl}/rest/api/3/myself`, {
+    const meRes = await fetch(`${cleanBase}/rest/api/3/myself`, {
       headers: { Authorization: auth, Accept: "application/json" },
       signal: AbortSignal.timeout(10000),
     });
@@ -106,15 +110,24 @@ async function checkJira({ baseUrl, project }, creds) {
     }
   } catch {}
 
-  // Use Jira's mypermissions endpoint to check all permissions at once
+  // Use Jira's mypermissions endpoint to check all permissions at once.
+  // Try REST v3 first (Jira Cloud), fall back to v2 on 404 (older tenants /
+  // Data Center installs where v3 isn't exposed).
   const permissionsToCheck = "BROWSE_PROJECTS,CREATE_ISSUES,EDIT_ISSUES,ADD_COMMENTS,TRANSITION_ISSUES";
+  const tryVersions = ["3", "2"];
+  let res = null;
+  let lastUrl = "";
   try {
-    const url = `${baseUrl}/rest/api/3/mypermissions?permissions=${permissionsToCheck}` +
-      (project ? `&projectKey=${project}` : "");
-    const res = await fetch(url, {
-      headers: { Authorization: auth, Accept: "application/json" },
-      signal: AbortSignal.timeout(10000),
-    });
+    for (const v of tryVersions) {
+      const url = `${cleanBase}/rest/api/${v}/mypermissions?permissions=${permissionsToCheck}` +
+        (project ? `&projectKey=${project}` : "");
+      lastUrl = url;
+      res = await fetch(url, {
+        headers: { Authorization: auth, Accept: "application/json" },
+        signal: AbortSignal.timeout(10000),
+      });
+      if (res.status !== 404) break;
+    }
 
     if (res.status === 401) {
       return { ok: false, errors: ["Jira authentication failed — check JIRA_EMAIL and JIRA_API_TOKEN"] };
@@ -123,7 +136,7 @@ async function checkJira({ baseUrl, project }, creds) {
       return { ok: false, errors: ["Jira access forbidden — your account may lack access to this project"] };
     }
     if (!res.ok) {
-      return { ok: false, errors: [`Jira API error (${res.status}) — check your base URL: ${baseUrl}`] };
+      return { ok: false, errors: [`Jira API error (${res.status}) calling ${lastUrl} — check that the base URL is the Atlassian tenant root (e.g. https://yourco.atlassian.net) without a path.`] };
     }
 
     const data = await res.json();
@@ -144,9 +157,9 @@ async function checkJira({ baseUrl, project }, creds) {
     }
   } catch (e) {
     if (e.name === "AbortError" || e.name === "TimeoutError") {
-      return { ok: false, errors: [`Cannot reach Jira at ${baseUrl} — request timed out`] };
+      return { ok: false, errors: [`Cannot reach Jira at ${cleanBase} — request timed out`] };
     }
-    return { ok: false, errors: [`Cannot reach Jira at ${baseUrl}: ${e.message}`] };
+    return { ok: false, errors: [`Cannot reach Jira at ${cleanBase}: ${e.message}`] };
   }
 
   return { ok: errors.length === 0, errors, identity };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {