dsh-jira-tasks 1.0.5 → 1.0.7

package/README.en.md

@@ -11,6 +11,7 @@ Shows the current JIRA project's **open / reopened** issues **assigned to the cu
 - 📋 Panel shown below the composer in both new and active sessions (aligned with the input width in new sessions)
 - 👤 Defaults to the current user (`assignee = currentUser()`) with status `开启 / 重新开启` (Open / Reopened)
 - ⚙️ **Settings → Plugins → JIRA** edits the base URL and access token (the token is written to the credential store and never sent back to the browser)
+- 🟢 The card auto-probes the connection and shows a status light: green = usable, red = unusable, grey = unconfigured; **Test connection** verifies unsaved drafts immediately
 - ⚙️ Project key and JQL are saved per workspace; unconfigured workspaces show "unconfigured"
 - 🔄 Auto-query on every new session, with a one-click refresh (⟳)
 - 🔗 Click an issue to open its JIRA detail in a new tab
@@ -24,12 +25,18 @@ Published to npm:
 dsh plugin --profile web add dsh-jira-tasks
 ```
 
+Or straight from GitHub (the repository root is the package directory; `lib/` is prebuilt):
+
+```bash
+dsh plugin --profile web add github:liu3734/jira-tasks-dsh-plugin
+```
+
 **Restart DSH** to activate.
 
 <details>
 <summary>Manual install (without npm)</summary>
 
-1. Copy the repo's `profile-package/` to `~/.dsh/profiles/web/packages/dsh-jira-tasks/`
+1. Copy this repository (its root is the package directory) to `~/.dsh/profiles/web/packages/dsh-jira-tasks/` (skip `.git/`)
 2. Edit `~/.dsh/profiles/web/package.json`:
    - Add to `dependencies`: `"dsh-jira-tasks": "file:./packages/dsh-jira-tasks"`
    - Append to `dsh.profile.bundles`: `"dsh-jira-tasks"`
@@ -56,6 +63,16 @@ Open **Settings → Plugins → Plugin configuration → JIRA** and fill in:
 
 Leaving the token blank on save keeps the existing one; clearing the address on save removes the override and falls back to the environment. Auth is auto-detected: tokens containing `:` use Basic, otherwise Bearer (JIRA PAT).
 
+> **A token supplied by the environment cannot be overwritten from this card.** If the environment that launched DSH already defines `JIRA_API_TOKEN` (a Windows *user-level* variable counts), DSH treats that reference as read-only: the card disables the token field and explains why. The panel already uses that variable, so **no save is needed**; to manage the token from settings instead, remove the variable first (Windows: System Properties → Environment Variables, or PowerShell `[Environment]::SetEnvironmentVariable('JIRA_API_TOKEN', $null, 'User')`) and restart DSH.
+
+#### Connection test
+
+The card's footer carries a status light and a **Test connection** button:
+
+- Opening the card **auto-probes** once (against JIRA `/rest/api/2/myself`), and saving re-probes
+- **Green** = address and token work (the current user is shown); **red** = unusable (JIRA's reason, e.g. 401, is shown); **grey** = address or token not configured
+- **Test connection** probes what is currently in the fields, saved or not, so you can check before saving
+
 Environment variables / credentials still work as a **fallback** (used when the settings card is empty), hot-reloaded without a restart:
 
 ```yaml
@@ -99,6 +116,20 @@ dsh plugin --profile web remove dsh-jira-tasks
 | Cannot parse JIRA response | Network / proxy issue, curl produced no output |
 </details>
 
+<details>
+<summary>Saving the token fails with "is supplied read-only by the launching environment"</summary>
+
+`JIRA_API_TOKEN` (or `JIRA_TOKEN`) is supplied by the environment that launched DSH, and DSH treats that reference as read-only: a write would be shadowed by the variable, so it is refused. The panel already uses that variable and queries fine, so **there is nothing to save**.
+
+To manage the token from the settings card instead, remove the variable and restart DSH:
+
+- Windows (PowerShell): `[Environment]::SetEnvironmentVariable('JIRA_API_TOKEN', $null, 'User')`, then reopen the terminal
+- Windows (GUI): System Properties → Advanced → Environment Variables, delete the user variable
+- macOS / Linux: remove the export from `~/.zshrc` / `~/.bashrc` (or equivalent) and reopen the terminal
+
+Since v1.0.7 the card detects a read-only token, disables the field, and shows this guidance inline instead of failing on save.
+</details>
+
 <details>
 <summary>Panel does not appear</summary>
 

package/README.md

@@ -15,6 +15,10 @@
 
 - 👤 默认仅显示当前用户（`assignee = currentUser()`）的「开启 / 重新开启」任务
 - ⚙️ **设置 → 插件 → JIRA** 配置 JIRA 地址与访问令牌（令牌写入凭据存储，不回传前端）
+- 🟢 设置卡片自动探测连接并显示状态灯：绿=可用、红=不可用、灰=未配置；点「测试连接」可用**未保存的草稿值**即时验证
+
+<img width="1590" height="1574" alt="image" src="https://github.com/user-attachments/assets/af5f11c6-aa9a-4c3b-84ca-cff6c0017b22" />
+
 - ⚙️ 项目 Key 与 JQL 按工作区保存；未配置的工作区显示"未配置"
 - 🔄 打开新会话自动查询，面板内支持一键刷新（⟳）
 - 🧭 点击标题可**收起 / 展开**面板；标题徽标显示查询命中的任务总数（列表最多展示 50 条，按更新时间倒序）
@@ -30,6 +34,12 @@
 dsh plugin --profile web add dsh-jira-tasks
 ```
 
+或直接从 GitHub 安装（仓库根即包目录，`lib/` 为预构建产物）：
+
+```bash
+dsh plugin --profile web add github:liu3734/jira-tasks-dsh-plugin
+```
+
 **重启 DSH** 后生效。
 
 > 若改用 GitHub Packages 源：先在 profile 的 `.npmrc` 配置 `@liu3734:registry=https://npm.pkg.github.com/` 及读取令牌，再执行 `dsh plugin --profile web add @liu3734/dsh-jira-tasks`。
@@ -37,7 +47,7 @@ dsh plugin --profile web add dsh-jira-tasks
 <details>
 <summary>手动安装（不使用 npm）</summary>
 
-1. 将仓库 `profile-package/` 复制为 `~/.dsh/profiles/web/packages/dsh-jira-tasks/`
+1. 将本仓库（仓库根目录即包目录）复制为 `~/.dsh/profiles/web/packages/dsh-jira-tasks/`（可忽略 `.git/`）
 2. 编辑 `~/.dsh/profiles/web/package.json`：
    - `dependencies` 增加：`"dsh-jira-tasks": "file:./packages/dsh-jira-tasks"`
    - `dsh.profile.bundles` 追加：`"dsh-jira-tasks"`
@@ -64,6 +74,16 @@ dsh plugin --profile web add dsh-jira-tasks
 
 留空并保存会保持已有令牌不变；地址留空并保存则清除设置项，回退到环境变量。认证自动识别：令牌含 `:` 用 Basic，否则用 Bearer（JIRA PAT）。
 
+> **令牌已由环境变量提供时，设置页无法改写它**：若启动 DSH 的环境里已设置 `JIRA_API_TOKEN`（Windows 用户级环境变量也算），DSH 会将该引用视为只读，卡片会禁用令牌输入并说明原因。此时面板已直接使用该环境变量，**无需保存**；要改由设置页管理，请先移除环境变量（Windows：系统属性 → 环境变量，或 PowerShell `[Environment]::SetEnvironmentVariable('JIRA_API_TOKEN', $null, 'User')`）后重启 DSH。
+
+#### 连接测试
+
+卡片底部有连接状态灯与 **测试连接** 按钮：
+
+- 打开卡片时会**自动探测**一次（请求 JIRA `/rest/api/2/myself`），保存后也会自动重测
+- **绿** = 地址与令牌可用（并显示当前登录用户）；**红** = 不可用（显示 JIRA 返回的原因，如 401 认证失败）；**灰** = 地址或令牌未配置
+- 点 **测试连接** 会用**当前输入框里的内容**（未保存也可）立即测试，方便改完再存
+
 以下环境变量 / 凭据仍作为**回退**（设置页未配置时生效，兼容旧部署），热加载无需重启：
 
 ```yaml
@@ -110,6 +130,20 @@ dsh plugin --profile web remove dsh-jira-tasks
 | 无法解析 JIRA 响应：… | 网络 / 代理问题，curl 无输出 |
 </details>
 
+<details>
+<summary>保存令牌报 “is supplied read-only by the launching environment”</summary>
+
+`JIRA_API_TOKEN`（或 `JIRA_TOKEN`）已由启动 DSH 的环境提供，DSH 判定该引用只读：写入会被环境变量遮蔽，因此拒绝保存。此时面板已经直接使用该环境变量，能正常查询，**无需在设置页保存**。
+
+如需改由设置页管理令牌，先移除环境变量再重启 DSH：
+
+- Windows（PowerShell）：`[Environment]::SetEnvironmentVariable('JIRA_API_TOKEN', $null, 'User')`，然后重开终端
+- Windows（图形界面）：系统属性 → 高级 → 环境变量，删除对应用户变量
+- macOS / Linux：从 `~/.zshrc` / `~/.bashrc` 等启动脚本中移除后重开终端
+
+v1.0.7 起卡片会检测只读令牌并直接禁用输入框、在卡片内给出上述提示，不再等到保存才报英文错误。
+</details>
+
 <details>
 <summary>面板不显示</summary>
 

package/lib/client.js

@@ -47,7 +47,12 @@ window.__ModuleLoader__.load({
       + ".jt-set-card{box-sizing:border-box;list-style:none;margin:0;border:1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.28));background:var(--dsw-alias-bg-layer-1, rgba(127,127,127,.05));border-radius:10px;padding:10px 12px}"
       + ".jt-set-head{display:flex;flex-direction:column;gap:2px;margin-bottom:8px}"
       + ".jt-set-title{font-weight:600;font-size:13px;color:var(--dsw-alias-label-primary, #222)}"
-      + ".jt-set-desc{font-size:12px;color:var(--dsw-alias-label-secondary, #666);line-height:1.6}";
+      + ".jt-set-desc{font-size:12px;color:var(--dsw-alias-label-secondary, #666);line-height:1.6}"
+      + ".jt-probe{display:flex;align-items:center;gap:6px;margin:0 0 8px;font-size:12px;color:var(--dsw-alias-label-secondary, #666);line-height:1.6;word-break:break-word}"
+      + ".jt-dot{flex:none;width:8px;height:8px;border-radius:50%;background:var(--dsw-alias-label-secondary, #999)}"
+      + ".jt-dot-ok{background:var(--dsw-alias-state-success-primary, #1a9d4f)}"
+      + ".jt-dot-fail{background:var(--dsw-alias-state-error-primary, #d93026)}"
+      + ".jt-dot-testing{background:var(--dsw-alias-state-warn-primary, #b76e00)}";
 
     var STORAGE_KEY = "dsh.jiraTasks.config.v1";
 
@@ -107,6 +112,15 @@ window.__ModuleLoader__.load({
       }).then(function (r) { return r.json(); });
     }
 
+    // 探测 JIRA 地址/令牌可用性；可选传入未保存的草稿值。
+    function testConnection(payload) {
+      return fetch("/jira/api/test", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload || {})
+      }).then(function (r) { return r.json(); });
+    }
+
     function JiraTasksDock(props) {
       var blankOnly = !!(props && props.blankOnly === true);
       var useWorkspaces = props && typeof props.useWorkspaces === "function" ? props.useWorkspaces : null;
@@ -274,6 +288,18 @@ window.__ModuleLoader__.load({
     var TOKEN_REF = "JIRA_API_TOKEN";
     var TOKEN_REFS = ["JIRA_API_TOKEN", "JIRA_TOKEN"];
 
+    // credentials-local 拒绝写入“由启动环境提供”的引用时，原始信息是英文的；这里取出引用名并给出可操作的中文说明。
+    function shadowedTokenRef(message) {
+      var m = /"([^"]+)" is supplied read-only by the launching environment/.exec(String(message || ""));
+      return m ? m[1] : "";
+    }
+    function tokenReadOnlyHint(ref) {
+      var name = ref || TOKEN_REF;
+      return "令牌由启动 DSH 的环境变量 " + name + " 提供（只读），面板已直接使用，无需在此保存。"
+        + "如需改由设置页管理，请先移除该环境变量并重启 DSH；Windows 可在 PowerShell 执行 "
+        + "[Environment]::SetEnvironmentVariable('" + name + "', $null, 'User') 后重开终端。";
+    }
+
     function useScopeSnapshot(scope) {
       var state = React.useState(function () { return scope.getSnapshot(); });
       var snapshot = state[0], setSnapshot = state[1];
@@ -289,15 +315,20 @@ window.__ModuleLoader__.load({
     function createJiraSettingsCard(scope, credentials) {
       function readTokenInfo() {
         return credentials.describe(TOKEN_REFS).then(function (res) {
-          if (!res || !res.ok || !res.value) return { configured: false, writable: false };
+          if (!res || !res.ok || !res.value) return { configured: false, writable: true };
           for (var i = 0; i < TOKEN_REFS.length; i++) {
-            var info = res.value[TOKEN_REFS[i]];
-            if (info && info.configured) return { configured: true, writable: info.writable !== false };
+            var ref = TOKEN_REFS[i];
+            var info = res.value[ref];
+            // 命中的第一个引用即生效来源；writable 为 false 表示只读（由启动环境提供），写不进去。
+            if (info && info.configured) {
+              return { configured: true, writable: info.writable !== false, ref: ref };
+            }
           }
           var primary = res.value[TOKEN_REF];
-          return { configured: false, writable: primary ? primary.writable !== false : true };
+          return { configured: false, writable: primary ? primary.writable !== false : true, ref: TOKEN_REF };
         }).catch(function () {
-          return { configured: false, writable: false };
+          // 状态读取失败不阻断保存，交由写入路径给出真实错误。
+          return { configured: false, writable: true };
         });
       }
 
@@ -313,6 +344,9 @@ window.__ModuleLoader__.load({
         var busy = busyState[0], setBusy = busyState[1];
         var failedState = React.useState("");
         var failed = failedState[0], setFailed = failedState[1];
+        var probeState = React.useState({ phase: "idle" });
+        var probe = probeState[0], setProbe = probeState[1];
+        var probeGen = React.useRef(0);
 
         React.useEffect(function () {
           var alive = true;
@@ -320,10 +354,19 @@ window.__ModuleLoader__.load({
           return function () { alive = false; };
         }, []);
 
+        // 自动测试：命名空间就绪后、以及已保存配置变更（含保存后）时各探测一次。
+        React.useEffect(function () {
+          if (snapshot.status !== "ready") return;
+          runProbe({});
+        }, [snapshot.status, snapshot.revision]);
+
         var storedBase = snapshot.value && typeof snapshot.value.baseUrl === "string" ? snapshot.value.baseUrl : "";
         var baseValue = baseEdit === undefined ? storedBase : baseEdit;
         var dirty = (baseEdit !== undefined && baseEdit !== storedBase) || (tokenDraft || "").length > 0;
         var writable = snapshot.writable !== false;
+        // 令牌可能来自启动环境（只读）：此时禁用输入并说明原因，而不是等到保存才报 DSH 的英文错误。
+        var tokenWritable = !tokenInfo || tokenInfo.writable !== false;
+        var tokenReadOnly = !!(tokenInfo && tokenInfo.configured && tokenInfo.writable === false);
 
         // 命名空间未挂载时不显示，避免留下一张无法操作的卡片。
         if (snapshot.status === "unavailable") return null;
@@ -337,6 +380,11 @@ window.__ModuleLoader__.load({
             tasks.push(baseEdit === "" ? scope.unset("baseUrl") : scope.set("baseUrl", baseEdit));
           }
           var token = (tokenDraft || "").trim();
+          if (token && !tokenWritable) {
+            setBusy(false);
+            setFailed(tokenReadOnlyHint(tokenInfo && tokenInfo.ref));
+            return;
+          }
           if (token) {
             tasks.push(credentials.set(TOKEN_REF, token).then(function (res) {
               if (res && res.ok === false) {
@@ -354,7 +402,8 @@ window.__ModuleLoader__.load({
             setBusy(false);
           }).catch(function (err) {
             setBusy(false);
-            setFailed(String((err && err.message) || err));
+            var shadowed = shadowedTokenRef(err && err.message);
+            setFailed(shadowed ? tokenReadOnlyHint(shadowed) : String((err && err.message) || err));
           });
         }
 
@@ -364,9 +413,29 @@ window.__ModuleLoader__.load({
           setFailed("");
         }
 
+        // 探测连接：payload 传入即测草稿，传空对象则测已保存/环境配置。
+        function runProbe(payload) {
+          var gen = ++probeGen.current;
+          setProbe({ phase: "testing", message: "正在测试连接…" });
+          testConnection(payload).then(function (res) {
+            if (gen !== probeGen.current) return;
+            if (res && res.ok) setProbe({ phase: "ok", message: "可用" + (res.user ? "：" + res.user : "") });
+            else if (res && res.code === "unconfigured") setProbe({ phase: "idle", message: "未配置地址或令牌" });
+            else setProbe({ phase: "fail", message: (res && res.error) || "不可用" });
+          }).catch(function (err) {
+            if (gen !== probeGen.current) return;
+            setProbe({ phase: "fail", message: String((err && err.message) || err) });
+          });
+        }
+
         var tokenHint = tokenInfo === null
           ? "正在读取令牌状态…"
-          : (tokenInfo.configured ? "令牌已配置；留空并保存可保持不变。" : "令牌未配置。含 “:” 时用 Basic，否则用 Bearer。");
+          : (tokenReadOnly
+            ? tokenReadOnlyHint(tokenInfo.ref)
+            : (tokenInfo.configured ? "令牌已配置；留空并保存可保持不变。" : "令牌未配置。含 “:” 时用 Basic，否则用 Bearer。"));
+        var dotClass = probe.phase === "ok" ? "jt-dot jt-dot-ok"
+          : probe.phase === "fail" ? "jt-dot jt-dot-fail"
+            : probe.phase === "testing" ? "jt-dot jt-dot-testing" : "jt-dot";
 
         return h("li", { className: "jt-set-card" },
           h("div", { className: "jt-set-head" },
@@ -392,18 +461,29 @@ window.__ModuleLoader__.load({
               className: "jt-input",
               type: "password",
               value: tokenDraft,
-              placeholder: tokenInfo && tokenInfo.configured ? "已配置，留空保持不变" : "粘贴令牌",
+              placeholder: tokenReadOnly ? "由环境变量提供（只读）" : (tokenInfo && tokenInfo.configured ? "已配置，留空保持不变" : "粘贴令牌"),
               autoComplete: "off",
-              disabled: !writable || busy,
+              disabled: !writable || busy || !tokenWritable,
               onChange: function (e) { setTokenDraft(e.target.value); },
               onKeyDown: function (e) { if (e.key === "Enter") save(); }
             })
           ),
           h("div", { className: "jt-hint", style: { marginBottom: "8px" } }, tokenHint),
+          h("div", { className: "jt-probe", role: "status" },
+            h("span", { className: dotClass, "aria-hidden": "true" }),
+            h("span", null, probe.message || "未测试")
+          ),
           failed ? h("div", { className: "jt-error", style: { marginBottom: "8px" } }, "保存失败：" + failed) : null,
           h("div", { className: "jt-buttons" },
+            h("button", {
+              className: "jt-btn",
+              style: { marginRight: "auto" },
+              disabled: busy || probe.phase === "testing",
+              title: "用当前填写的内容测试 JIRA 地址与令牌",
+              onClick: function () { runProbe({ baseUrl: baseValue, token: (tokenDraft || "").trim() }); }
+            }, probe.phase === "testing" ? "测试中…" : "测试连接"),
             h("button", { className: "jt-btn", disabled: !dirty || busy, onClick: discard }, "放弃"),
-            h("button", { className: "jt-btn jt-btn-primary", disabled: !dirty || busy || !writable, onClick: save }, busy ? "保存中…" : "保存")
+            h("button", { className: "jt-btn jt-btn-primary", disabled: !dirty || busy || !writable || ((tokenDraft || "").trim().length > 0 && !tokenWritable), onClick: save }, busy ? "保存中…" : "保存")
           )
         );
       };

package/lib/index.js

@@ -117,6 +117,49 @@ export default {
       return { exitCode: outcome.exitCode, stdout, stderr };
     }
 
+    // 从 JIRA 错误响应体/curl stderr 中提取可读信息。
+    function errorTextFrom(body, stderr, fallback) {
+      let message = (stderr || '').trim() || fallback;
+      try {
+        const parsed = JSON.parse(body);
+        if (parsed.errorMessages && parsed.errorMessages.length) message = parsed.errorMessages.join('；');
+        else if (parsed.message) message = parsed.message;
+      } catch (e) { /* body 非 JSON */ }
+      return message;
+    }
+
+    // 连通性/鉴权探测：GET /rest/api/2/myself，stdout 末尾追加 HTTP 状态码。
+    async function probeJira(baseUrl, token) {
+      const auth = buildAuthHeader(token);
+      const cleanBase = baseUrl.replace(/\/+$/, '');
+      let curl;
+      try {
+        curl = await subprocess.resolveExecutable('curl');
+      } catch (e) {
+        curl = '/usr/bin/curl';
+      }
+      const handle = subprocess.spawn({
+        argv: [
+          curl, '-sS', '--max-time', '15',
+          '-H', 'Accept: application/json',
+          '--config', '-',
+          '-w', '\n%{http_code}',
+          cleanBase + '/rest/api/2/myself'
+        ],
+        cwd: workspaceRoot,
+        stdio: {
+          stdin: { data: 'header = "Authorization: ' + auth + '"\n' },
+          stdout: { maxBytes: 1024 * 1024, spill: { maxBytes: 4 * 1024 * 1024 } },
+          stderr: { maxBytes: 256 * 1024, spill: { maxBytes: 1024 * 1024 } }
+        },
+        graceMs: 5000
+      });
+      const outcome = await handle.done;
+      const stdout = (handle.collected.stdout ? handle.collected.stdout.readFrom(0).text : '') || '';
+      const stderr = (handle.collected.stderr ? handle.collected.stderr.readFrom(0).text : '') || '';
+      return { exitCode: outcome.exitCode, stdout, stderr };
+    }
+
     async function handleSearch(args) {
       const projectKey = String((args && args.projectKey) || '').trim();
       if (!projectKey) return { ok: false, error: '未设置项目 Key' };
@@ -132,13 +175,7 @@ export default {
         const stderr = raw.stderr;
 
         if (raw.exitCode !== 0) {
-          let message = stderr.trim() || ('curl 退出码 ' + String(raw.exitCode));
-          try {
-            const parsed = JSON.parse(stdout);
-            if (parsed.errorMessages && parsed.errorMessages.length) message = parsed.errorMessages.join('；');
-            else if (parsed.message) message = parsed.message;
-          } catch (e) { /* stdout 非 JSON */ }
-          return { ok: false, error: message };
+          return { ok: false, error: errorTextFrom(stdout, stderr, 'curl 退出码 ' + String(raw.exitCode)) };
         }
 
         let data;
@@ -169,6 +206,43 @@ export default {
       }
     }
 
+    // 设置卡片“测试连接”：用草稿值（未保存也可测）或已保存/环境配置探测 JIRA。
+    async function handleTest(args) {
+      try {
+        const draftBase = args && typeof args.baseUrl === 'string' ? args.baseUrl.trim() : '';
+        const draftToken = args && typeof args.token === 'string' ? args.token.trim() : '';
+        const baseUrl = draftBase || settingsBaseUrl() || await resolveFirst(['JIRA_BASE_URL', 'JIRA_URL']);
+        if (!baseUrl) return { ok: false, code: 'unconfigured', error: '未配置 JIRA 地址' };
+        const token = draftToken || await resolveFirst(['JIRA_API_TOKEN', 'JIRA_TOKEN']);
+        if (!token) return { ok: false, code: 'unconfigured', error: '未配置 JIRA 令牌' };
+
+        const raw = await probeJira(baseUrl, token);
+        if (raw.exitCode !== 0) {
+          return { ok: false, code: 'network', error: (raw.stderr || '').trim() || ('curl 退出码 ' + String(raw.exitCode)) };
+        }
+        const nl = raw.stdout.lastIndexOf('\n');
+        const body = nl === -1 ? raw.stdout : raw.stdout.slice(0, nl);
+        const httpCode = Number((nl === -1 ? '' : raw.stdout.slice(nl + 1)).trim()) || 0;
+
+        if (httpCode >= 200 && httpCode < 300) {
+          let data = {};
+          try { data = JSON.parse(body); } catch (e) { /* 空/非 JSON 也视为连通 */ }
+          return {
+            ok: true,
+            baseUrl: baseUrl.replace(/\/+$/, ''),
+            user: data.displayName || data.name || data.key || ''
+          };
+        }
+        return {
+          ok: false,
+          code: httpCode === 401 || httpCode === 403 ? 'auth' : 'http',
+          error: errorTextFrom(body, raw.stderr, 'HTTP ' + String(httpCode))
+        };
+      } catch (err) {
+        return { ok: false, code: 'error', error: String((err && err.message) || err) };
+      }
+    }
+
     if (webServer && typeof webServer.register === 'function') {
       webServer.register({
         kind: 'exact',
@@ -181,6 +255,17 @@ export default {
           }
         }
       });
+      webServer.register({
+        kind: 'exact',
+        path: '/jira/api/test',
+        handler: async (req, res) => {
+          try {
+            sendJson(res, await handleTest(await readBody(req)));
+          } catch (e) {
+            sendJson(res, { ok: false, code: 'error', error: String((e && e.message) || e) });
+          }
+        }
+      });
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-jira-tasks",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "JIRA open tasks panel for DeepSeek Harness (DSH): shows the current user's open/reopened issues below the composer, per-workspace project key, persistent profile bundle.",
   "type": "module",
   "main": "lib/index.js",