@crypto512/jicon-mcp 2.3.0 → 2.3.19

package/dist/utils/http-client.js

@@ -2,6 +2,30 @@
  * HTTP client utility for API requests
  */
 import axios from "axios";
+import { debug, isDebugEnabled } from "./logger.js";
+/** Maximum response body length to log (characters) */
+const DEBUG_MAX_BODY_LENGTH = 5000;
+/**
+ * Sanitize headers for debug logging (mask Authorization tokens)
+ */
+function sanitizeHeaders(headers) {
+    const sanitized = { ...headers };
+    if (sanitized.Authorization && typeof sanitized.Authorization === "string") {
+        // Show first 2 chars of token: "Bearer ab***" or "Basic ab***"
+        const parts = sanitized.Authorization.split(" ");
+        if (parts.length === 2 && parts[1].length > 2) {
+            sanitized.Authorization = `${parts[0]} ${parts[1].substring(0, 2)}***`;
+        }
+    }
+    // Also sanitize lowercase version (axios normalizes to lowercase in some cases)
+    if (sanitized.authorization && typeof sanitized.authorization === "string") {
+        const parts = sanitized.authorization.split(" ");
+        if (parts.length === 2 && parts[1].length > 2) {
+            sanitized.authorization = `${parts[0]} ${parts[1].substring(0, 2)}***`;
+        }
+    }
+    return sanitized;
+}
 export class HttpClient {
     client;
     constructor(config) {
@@ -33,8 +57,69 @@ export class HttpClient {
             };
         }
         this.client = axios.create(axiosConfig);
-        // Add response interceptor for error handling
-        this.client.interceptors.response.use((response) => response, (error) => {
+        // Add debug request interceptor (only when debug level enabled)
+        this.client.interceptors.request.use((request) => {
+            if (isDebugEnabled()) {
+                const method = request.method?.toUpperCase() || "?";
+                const url = request.url || "?";
+                debug(`→ ${method} ${url}`);
+                debug(`→ Headers: ${JSON.stringify(sanitizeHeaders(request.headers))}`);
+                if (request.data) {
+                    debug(`→ Body: ${JSON.stringify(request.data)}`);
+                }
+            }
+            return request;
+        }, (error) => {
+            if (isDebugEnabled()) {
+                debug(`→ Request Error: ${error.message}`);
+            }
+            return Promise.reject(error);
+        });
+        // Add response interceptor for error handling (and debug logging)
+        this.client.interceptors.response.use((response) => {
+            if (isDebugEnabled()) {
+                const status = response.status;
+                const statusText = response.statusText || "";
+                debug(`← ${status} ${statusText}`);
+                debug(`← Headers: ${JSON.stringify(response.headers)}`);
+                const body = JSON.stringify(response.data);
+                if (body.length > DEBUG_MAX_BODY_LENGTH) {
+                    debug(`← Body: ${body.substring(0, DEBUG_MAX_BODY_LENGTH)}... [truncated, ${body.length} chars total]`);
+                }
+                else {
+                    debug(`← Body: ${body}`);
+                }
+            }
+            // Check for anonymous user on success responses (token invalid but query allowed)
+            const ausername = response.headers["x-ausername"];
+            if (ausername === "anonymous") {
+                const authError = {
+                    error: true,
+                    message: "Authentication failed: Invalid or expired API token",
+                    statusCode: 401,
+                };
+                throw authError;
+            }
+            return response;
+        }, (error) => {
+            if (isDebugEnabled()) {
+                if (error.response) {
+                    const status = error.response.status;
+                    const statusText = error.response.statusText || "";
+                    debug(`← ${status} ${statusText} (ERROR)`);
+                    debug(`← Headers: ${JSON.stringify(error.response.headers)}`);
+                    const body = JSON.stringify(error.response.data);
+                    if (body.length > DEBUG_MAX_BODY_LENGTH) {
+                        debug(`← Body: ${body.substring(0, DEBUG_MAX_BODY_LENGTH)}... [truncated, ${body.length} chars total]`);
+                    }
+                    else {
+                        debug(`← Body: ${body}`);
+                    }
+                }
+                else {
+                    debug(`← Error: ${error.message}`);
+                }
+            }
             throw this.handleError(error);
         });
     }
@@ -66,6 +151,9 @@ export class HttpClient {
             // Server responded with error status
             const statusCode = error.response.status;
             const contentType = error.response.headers["content-type"] || "";
+            // Check for anonymous user indicator (common in Atlassian products for auth failures)
+            const ausername = error.response.headers["x-ausername"];
+            const isAnonymous = ausername === "anonymous";
             // Handle HTML error responses (common for 401, 403, etc.)
             if (contentType.includes("text/html")) {
                 return {
@@ -74,9 +162,18 @@ export class HttpClient {
                     statusCode,
                     details: {
                         hint: this.getAuthenticationHint(statusCode),
+                        ...(isAnonymous && { authHint: "Request treated as anonymous - verify your API token is valid" }),
                     },
                 };
             }
+            // If user is anonymous, return auth error immediately (token invalid/expired)
+            if (isAnonymous) {
+                return {
+                    error: true,
+                    message: "Authentication failed: Invalid or expired API token",
+                    statusCode: 401,
+                };
+            }
             // Handle JSON error responses
             const errorMessage = error.response.data
                 ?.errorMessages?.[0] ||

package/dist/utils/http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"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"}

package/dist/utils/jicon-help.d.ts

@@ -8,7 +8,7 @@ import { z } from "zod";
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 declare const TOPICS: readonly ["jql", "cql", "storage", "plantuml", "buffers", "analysis"];
 type Topic = (typeof TOPICS)[number];
-declare const WORKFLOW_GUIDE = "# Jicon Quick Reference\n\nTOOLS: jira(26) confluence(21) tempo(13) buffer(12) plantuml(3) url(2) date(1) help(1)\n\n## Decision Tree - Which Topic?\n\n| Task | First Step |\n|------|------------|\n| **What happened on project X?** | `jira_get_activity_digest(projectKey, since=\"7d\")` \u2190 **AI analysis** |\n| **Analyze Epic progress (deep)** | `jira_analyze_epic(issueKey)` \u2190 time metrics, comments, Confluence links |\n| **Analyze Sprint progress** | `jira_analyze_sprint(sprintId)` \u2190 progress, risks, team distribution |\n| **Quick Epic status** | `jira_epic_summary(issueKey)` \u2190 lightweight hierarchy + status |\n| **List Epic children** | `jira_list_epic_children(parentKey)` \u2190 no JQL needed |\n| **Top issues by workload** | `tempo_get_top_worklogs(since=\"last_week\")` \u2190 **AI analysis** |\n| Edit Confluence page | `confluence_edit(input)` \u2190 accepts URL, pageId, or SPACE/Title |\n| Create NEW page | `buffer_create(content, contentType=\"xhtml\")` then `confluence_draft_create` |\n| Create page with diagram | `help(topic=\"plantuml\")` |\n| XHTML syntax needed | `help(topic=\"storage\")` \u2190 **READ THIS for HTML vs XHTML** |\n| Search Confluence | `help(topic=\"cql\")` |\n| Search Jira | `jira_get_issue_types()` then `help(topic=\"jql\")` |\n| Non-English Jira fields | `jira_get_fields(search=\"epic\")` \u2192 use cf[ID] syntax |\n| Log/get time | `tempo_get_user_info()` first |\n| **Create table for Confluence** | `buffer_transform(..., code=\"return toTable(issues,{columns:[...]})\")` \u2192 XHTML |\n| **Create table to show user** | `buffer_transform(..., code=\"return toMarkdownTable(issues,{columns:[...]})\")` \u2192 Markdown |\n| **Iterate items for AI analysis** | `buffer_get_items(bufferId, start=0, count=50)` |\n| **Large dataset + AI columns** | Batch workflow - see `help(topic=\"buffers\")` |\n| **LLM analysis tools guide** | `help(topic=\"analysis\")` |\n\n---\n\n## Core Workflows\n\n### Edit Confluence Page (Review Workflow)\n```\n1. confluence_edit(input)\n   - Accepts: URL, pageId, \"draft:ID\", or \"SPACE/Title\"\n   \u2192 Returns: bufferId, structure (element IDs), pageId\n2. buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)\n   \u2192 Use content=\"<p>text</p>\" for XHTML (use <br/> not <br>!)\n   \u2192 Use plantuml=\"@startuml...\" for diagrams\n   \u2192 Use fromBufferId=\"buf_xxx\" to merge another buffer\n3. buffer_validate_xhtml(bufferId) \u2192 check for errors before saving\n4. confluence_draft_create(pageId=..., bufferId=...)\n   \u2192 Creates \"[jicon-mcp REVIEW] Title\" draft linked to original\n   \u2192 Returns: reviewDraftId, draft URL for user review\n5. User reviews in Confluence UI (can share draft with team)\n6. confluence_review_publish(reviewDraftId) \u2192 applies changes to original\n   OR confluence_review_discard(reviewDraftId) \u2192 cancels without changes\n```\n\n**Review Workflow Tools:**\n- `confluence_review_publish(reviewDraftId)` - Apply changes to original page\n- `confluence_review_discard(reviewDraftId)` - Discard without changes\n- `confluence_review_list()` - Find all review drafts for cleanup\n\n**Draft Management Tools:**\n- `confluence_draft_list()` - List all drafts in your personal space\n- `confluence_draft_open(draftId)` - Reopen a draft for editing\n- `confluence_draft_delete(draftId)` - Delete a draft\n\n### Create NEW Confluence Page (Buffer-First)\n```\n1. buffer_create(content=\"<h1>Title</h1><p>Content</p>\", contentType=\"xhtml\")\n   \u2192 Returns: bufferId, structure (element IDs)\n2. buffer_validate_xhtml(bufferId)\n   \u2192 If errors: use buffer_edit(bufferId, replace=elementId, ...) to fix\n3. confluence_draft_create(spaceKey, title, bufferId)\n   \u2192 Returns: draftId, draft URL for user review\n4. User reviews and publishes via Confluence UI\n```\n\n**Why buffer-first?** Enables validation and surgical error fixing with element IDs.\n\n### Insert PlantUML Diagram\n```\n1. plantuml_validate(code=\"@startuml...\") \u2190 Validate FIRST\n2. buffer_edit(bufferId, after=ID, plantuml=\"@startuml...\")\n   \u2192 Auto-wraps in Confluence macro\n```\n**Multiple diagrams?** See `help(topic=\"plantuml\")` for direct macro embedding (fewer tool calls).\n\n### Search\n```\nConfluence: confluence_search_content(cql=\"space=KEY AND text~\\\"term\\\"\")\nJira: jira_search_issues(jql=\"project=KEY AND type=Bug\")\n```\n\n### Tempo Time\n```\ntempo_get_user_info() \u2192 workerKey\ntempo_get_worklogs(dateFrom, dateTo, workerKey=workerKey)\ntempo_log_work(issueKey, hours, date)\n```\n\n---\n\n## Element ID System (Key Concept)\n\nEvery XHTML element gets a stable ID. Use IDs for precise positioning:\n\n```\nstructure: [{id:1, type:\"h1\"}, {id:2, type:\"p\"}, {id:3, type:\"ul\"}]\n\nbuffer_edit(bufferId, after=1, content=\"<p>New</p>\")  \u2192 Insert after h1\nbuffer_edit(bufferId, replace=2, content=\"<p>Updated</p>\")  \u2192 Replace p\nbuffer_edit(bufferId, remove=3)  \u2192 Delete ul\nbuffer_edit(bufferId, append=true, plantuml=\"@startuml...\")  \u2192 Add at end\n```\n\n**IDs are STABLE** - never change when content is inserted/deleted.\nSee `help(topic=\"buffers\")` for full details.\n";
+declare const WORKFLOW_GUIDE = "# Jicon Quick Reference\n\nTOOLS: jira, confluence, tempo, buffer, workload, plantuml, url, date, help, whoami\n\n## Decision Tree - Which Topic?\n\n| Task | First Step |\n|------|------------|\n| **What happened on project X?** | `jira_get_activity_digest(projectKey, since=\"7d\")` \u2190 **AI analysis** |\n| **Analyze Epic progress (deep)** | `jira_analyze_epic(issueKey)` \u2190 time metrics, comments, Confluence links |\n| **Analyze Sprint progress** | `jira_analyze_sprint(sprintId)` \u2190 progress, risks, team distribution |\n| **Quick Epic status** | `jira_epic_summary(issueKey)` \u2190 lightweight hierarchy + status |\n| **List Epic children** | `jira_list_epic_children(parentKey)` \u2190 no JQL needed |\n| **Top issues by workload** | `tempo_get_top_worklogs(since=\"last_week\")` \u2190 **AI analysis** |\n| Edit Confluence page | `confluence_edit(input)` \u2190 accepts URL, pageId, or SPACE/Title |\n| Create NEW page | `buffer_create(content, contentType=\"xhtml\")` then `confluence_draft_create` |\n| Create page with diagram | `help(topic=\"plantuml\")` |\n| XHTML syntax needed | `help(topic=\"storage\")` \u2190 **READ THIS for HTML vs XHTML** |\n| Search Confluence | `help(topic=\"cql\")` |\n| Search Jira | `jira_get_issue_types()` then `help(topic=\"jql\")` |\n| Non-English Jira fields | `jira_get_fields(search=\"epic\")` \u2192 use cf[ID] syntax |\n| **Find user for JQL query** | `jira_search_users(query=\"name\")` \u2192 get username for assignee/reporter JQL |\n| **Issues worked on in period** | `tempo_get_worklogs(workerKey, dateFrom, dateTo)` \u2190 NOT JQL created/updated |\n| Log/get time | `tempo_get_user_info()` first |\n| **Create table for Confluence** | `buffer_transform(..., code=\"return toTable(issues,{columns:[...]})\")` \u2192 XHTML |\n| **Create table to show user** | `buffer_transform(..., code=\"return toMarkdownTable(issues,{columns:[...]})\")` \u2192 Markdown |\n| **Iterate items for AI analysis** | `buffer_get_items(bufferId, start=0, count=50)` |\n| **Large dataset + AI columns** | Batch workflow - see `help(topic=\"buffers\")` |\n| **LLM analysis tools guide** | `help(topic=\"analysis\")` |\n\n---\n\n## Core Workflows\n\n### Edit Confluence Page (Review Workflow)\n```\n1. confluence_edit(input)\n   - Accepts: URL, pageId, \"draft:ID\", or \"SPACE/Title\"\n   \u2192 Returns: bufferId, structure (element IDs), pageId\n2. buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)\n   \u2192 Use content=\"<p>text</p>\" for XHTML (use <br/> not <br>!)\n   \u2192 Use plantuml=\"@startuml...\" for diagrams\n   \u2192 Use fromBufferId=\"buf_xxx\" to merge another buffer\n3. buffer_validate_xhtml(bufferId) \u2192 check for errors before saving\n4. confluence_draft_create(pageId=..., bufferId=...)\n   \u2192 Creates \"[jicon-mcp REVIEW] Title\" draft linked to original\n   \u2192 Returns: reviewDraftId, draft URL for user review\n5. User reviews in Confluence UI (can share draft with team)\n6. confluence_review_publish(reviewDraftId) \u2192 applies changes to original\n   OR confluence_review_discard(reviewDraftId) \u2192 cancels without changes\n```\n\n**Review Workflow Tools:**\n- `confluence_review_publish(reviewDraftId)` - Apply changes to original page\n- `confluence_review_discard(reviewDraftId)` - Discard without changes\n- `confluence_review_list()` - Find all review drafts for cleanup\n\n**Draft Management Tools:**\n- `confluence_draft_list()` - List all drafts in your personal space\n- `confluence_draft_open(draftId)` - Reopen a draft for editing\n- `confluence_draft_delete(draftId)` - Delete a draft\n\n### Create NEW Confluence Page (Buffer-First)\n```\n1. buffer_create(content=\"<h1>Title</h1><p>Content</p>\", contentType=\"xhtml\")\n   \u2192 Returns: bufferId, structure (element IDs)\n2. buffer_validate_xhtml(bufferId)\n   \u2192 If errors: use buffer_edit(bufferId, replace=elementId, ...) to fix\n3. confluence_draft_create(spaceKey, title, bufferId)\n   \u2192 Returns: draftId, draft URL for user review\n4. User reviews and publishes via Confluence UI\n```\n\n**Why buffer-first?** Enables validation and surgical error fixing with element IDs.\n\n### Insert PlantUML Diagram\n```\n1. plantuml_validate(code=\"@startuml...\") \u2190 Validate FIRST\n2. buffer_edit(bufferId, after=ID, plantuml=\"@startuml...\")\n   \u2192 Auto-wraps in Confluence macro\n```\n**Multiple diagrams?** See `help(topic=\"plantuml\")` for direct macro embedding (fewer tool calls).\n\n### Search\n```\nConfluence: confluence_search_content(cql=\"space=KEY AND text~\\\"term\\\"\")\nJira: jira_search_issues(jql=\"project=KEY AND type=Bug\")\n```\n\n### Tempo Time\n```\ntempo_get_user_info() \u2192 workerKey\ntempo_get_worklogs(dateFrom, dateTo, workerKey=workerKey)\ntempo_log_work(issueKey, hours, date)\n```\n\n---\n\n## Element ID System (Key Concept)\n\nEvery XHTML element gets a stable ID. Use IDs for precise positioning:\n\n```\nstructure: [{id:1, type:\"h1\"}, {id:2, type:\"p\"}, {id:3, type:\"ul\"}]\n\nbuffer_edit(bufferId, after=1, content=\"<p>New</p>\")  \u2192 Insert after h1\nbuffer_edit(bufferId, replace=2, content=\"<p>Updated</p>\")  \u2192 Replace p\nbuffer_edit(bufferId, remove=3)  \u2192 Delete ul\nbuffer_edit(bufferId, append=true, plantuml=\"@startuml...\")  \u2192 Add at end\n```\n\n**IDs are STABLE** - never change when content is inserted/deleted.\nSee `help(topic=\"buffers\")` for full details.\n";
 export declare function createJiconHelpTools(): {
     help: {
         description: string;

package/dist/utils/jicon-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jicon-help.d.ts","sourceRoot":"","sources":["../../src/utils/jicon-help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE,QAAA,MAAM,MAAM,uEAAwE,CAAC;AACrF,KAAK,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAGrC,QAAA,MAAM,cAAc,mlKA+GnB,CAAC;AA6jCF,wBAAgB,oBAAoB;;;;;;;;;;wBA4BR;YAAE,KAAK,CAAC,EAAE,KAAK,CAAA;SAAE,KAAG,OAAO,CAAC,cAAc,CAAC;;EA2BtE;AAGD,eAAO,MAAM,gBAAgB,mBAAoB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"jicon-help.d.ts","sourceRoot":"","sources":["../../src/utils/jicon-help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE,QAAA,MAAM,MAAM,uEAAwE,CAAC;AACrF,KAAK,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAGrC,QAAA,MAAM,cAAc,4zKAiHnB,CAAC;AAy2BF,wBAAgB,oBAAoB;;;;;;;;;;wBA4BR;YAAE,KAAK,CAAC,EAAE,KAAK,CAAA;SAAE,KAAG,OAAO,CAAC,cAAc,CAAC;;EA2BtE;AAGD,eAAO,MAAM,gBAAgB,mBAAoB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,CAAC"}