@kendoo.agentdesk/agentdesk 0.18.0 → 0.18.2

package/CHANGELOG.md

@@ -8,6 +8,16 @@ All user-facing changes to AgentDesk. Each entry is tagged:
 
 Internal refactors, infrastructure changes, and architectural notes are not listed here.
 
+## [0.18.2] — 2026-04-18
+
+### Fixed
+- `[CLI]` Jira tracker check no longer blocks on a 404 from the `mypermissions` endpoint (some tenants don't expose it). Auth verification now lives in the `/myself` call; `mypermissions` is best-effort and only reports missing permissions if the tenant returns them. A 404 on `/myself` itself still fails loudly — that's a real configuration problem.
+
+## [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,59 +94,83 @@ async function checkJira({ baseUrl, project }, creds) {
   let identity = null;
   const auth = "Basic " + Buffer.from(`${email}:${token}`).toString("base64");
 
-  // Fetch the authenticated user so we can report "Posting as X".
-  try {
-    const meRes = await fetch(`${baseUrl}/rest/api/3/myself`, {
-      headers: { Authorization: auth, Accept: "application/json" },
-      signal: AbortSignal.timeout(10000),
-    });
-    if (meRes.ok) {
-      const me = await meRes.json();
-      identity = { name: me.displayName || email, email: me.emailAddress || email, id: me.accountId };
+  // Normalize the base URL: trim trailing slashes, so `...net/` doesn't
+  // produce `...net//rest/...` which some Atlassian paths reject.
+  const cleanBase = String(baseUrl || "").replace(/\/+$/, "");
+
+  // Primary check: /myself. If this works, the tenant + auth are fine.
+  // Try v3 first, fall back to v2 on 404. This is what we report to the
+  // user as "auth works"; mypermissions is now a best-effort follow-up.
+  let myselfRes = null;
+  let lastUrl = "";
+  for (const v of ["3", "2"]) {
+    lastUrl = `${cleanBase}/rest/api/${v}/myself`;
+    try {
+      myselfRes = await fetch(lastUrl, {
+        headers: { Authorization: auth, Accept: "application/json" },
+        signal: AbortSignal.timeout(10000),
+      });
+      if (myselfRes.status !== 404) break;
+    } catch (e) {
+      if (e.name === "AbortError" || e.name === "TimeoutError") {
+        return { ok: false, errors: [`Cannot reach Jira at ${cleanBase} — request timed out`] };
+      }
+      return { ok: false, errors: [`Cannot reach Jira at ${cleanBase}: ${e.message}`] };
     }
+  }
+  if (!myselfRes) return { ok: false, errors: [`Cannot reach Jira at ${cleanBase}`] };
+  if (myselfRes.status === 401) {
+    return { ok: false, errors: ["Jira authentication failed — check JIRA_EMAIL and JIRA_API_TOKEN"] };
+  }
+  if (myselfRes.status === 403) {
+    return { ok: false, errors: ["Jira access forbidden — your account may lack access to this tenant"] };
+  }
+  if (myselfRes.status === 404) {
+    return { ok: false, errors: [`Jira API not found at ${cleanBase} (tried /rest/api/3/myself and /rest/api/2/myself). Confirm the base URL is the Atlassian tenant root and Jira is enabled on this tenant.`] };
+  }
+  if (!myselfRes.ok) {
+    return { ok: false, errors: [`Jira API error (${myselfRes.status}) calling ${lastUrl}`] };
+  }
+  try {
+    const me = await myselfRes.json();
+    identity = { name: me.displayName || email, email: me.emailAddress || email, id: me.accountId };
   } catch {}
 
-  // Use Jira's mypermissions endpoint to check all permissions at once
-  const permissionsToCheck = "BROWSE_PROJECTS,CREATE_ISSUES,EDIT_ISSUES,ADD_COMMENTS,TRANSITION_ISSUES";
+  // Best-effort permission check. If it 404s or otherwise fails, we log the
+  // specific perms we COULD verify and return ok — the user's auth works;
+  // any missing permission will surface when the agent tries the operation.
   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),
-    });
-
-    if (res.status === 401) {
-      return { ok: false, errors: ["Jira authentication failed — check JIRA_EMAIL and JIRA_API_TOKEN"] };
+    const permissionsToCheck = "BROWSE_PROJECTS,CREATE_ISSUES,EDIT_ISSUES,ADD_COMMENTS,TRANSITION_ISSUES";
+    let permRes = null;
+    for (const v of ["3", "2"]) {
+      const url = `${cleanBase}/rest/api/${v}/mypermissions?permissions=${permissionsToCheck}` +
+        (project ? `&projectKey=${project}` : "");
+      permRes = await fetch(url, {
+        headers: { Authorization: auth, Accept: "application/json" },
+        signal: AbortSignal.timeout(10000),
+      });
+      if (permRes.status !== 404) break;
     }
-    if (res.status === 403) {
-      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}`] };
-    }
-
-    const data = await res.json();
-    const perms = data.permissions || {};
-
-    const permMap = {
-      BROWSE_PROJECTS: "read tasks",
-      CREATE_ISSUES: "create tasks",
-      EDIT_ISSUES: "update tasks",
-      ADD_COMMENTS: "add comments",
-      TRANSITION_ISSUES: "change task status",
-    };
-
-    for (const [key, label] of Object.entries(permMap)) {
-      if (perms[key] && !perms[key].havePermission) {
-        errors.push(`Missing permission: ${label} (${key})`);
+    if (permRes && permRes.ok) {
+      const data = await permRes.json();
+      const perms = data.permissions || {};
+      const permMap = {
+        BROWSE_PROJECTS: "read tasks",
+        CREATE_ISSUES: "create tasks",
+        EDIT_ISSUES: "update tasks",
+        ADD_COMMENTS: "add comments",
+        TRANSITION_ISSUES: "change task status",
+      };
+      for (const [key, label] of Object.entries(permMap)) {
+        if (perms[key] && !perms[key].havePermission) {
+          errors.push(`Missing permission: ${label} (${key})`);
+        }
       }
     }
-  } 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 ${baseUrl}: ${e.message}`] };
+    // If mypermissions failed, silently skip — agent will hit real errors
+    // when it tries an operation, which is more accurate anyway.
+  } catch {
+    // Ignore — auth already verified via /myself above.
   }
 
   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.2",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {