@crypto512/jicon-mcp 1.2.0 → 1.3.0

package/dist/tempo/tools.js

@@ -2,7 +2,7 @@
  * Tempo MCP Tools
  */
 import { z } from "zod";
-import { formatSuccess, formatError, isApiError, formatConflictError, } from "../utils/response-formatter.js";
+import { formatSuccess, formatSuccessBuffered, formatError, isApiError, formatConflictError, } from "../utils/response-formatter.js";
 import { contentBuffer } from "../utils/content-buffer.js";
 import { formatWorklogSearchMetadata } from "./formatters.js";
 import { formatTimeSpent } from "../utils/time-formatter.js";
@@ -11,6 +11,8 @@ export function createTempoTools(client) {
         tempo_get_worklogs: {
             description: `Get Tempo worklogs with filters.
 
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.
+
 TIP: Call tempo_get_user_info first to get workerKey for user-specific results.
 
 WARNING: No workerKey = returns ALL worklogs (slow!).`,
@@ -33,9 +35,22 @@ WARNING: No workerKey = returns ALL worklogs (slow!).`,
             handler: async (args) => {
                 try {
                     const result = await client.getWorklogs(args.dateFrom, args.dateTo, args.projectKey, args.issueKey, args.workerKey);
-                    return formatSuccess({
+                    const titleParts = ["Worklogs"];
+                    if (args.dateFrom || args.dateTo) {
+                        titleParts.push(`${args.dateFrom || "..."} to ${args.dateTo || "..."}`);
+                    }
+                    if (args.workerKey)
+                        titleParts.push(`(${args.workerKey})`);
+                    if (args.projectKey)
+                        titleParts.push(`[${args.projectKey}]`);
+                    if (args.issueKey)
+                        titleParts.push(`[${args.issueKey}]`);
+                    return formatSuccessBuffered({
                         ...formatWorklogSearchMetadata(result),
                         worklogs: result.results,
+                    }, {
+                        resourceType: "tempo_worklogs",
+                        title: titleParts.join(" "),
                     });
                 }
                 catch (error) {
@@ -44,18 +59,21 @@ WARNING: No workerKey = returns ALL worklogs (slow!).`,
             },
         },
         tempo_get_worklog: {
-            description: "Get detailed information about a specific worklog entry",
+            description: `Get detailed information about a specific worklog entry.
+
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.`,
             inputSchema: z.object({
                 worklogId: z.number().describe("Tempo worklog ID"),
             }),
             handler: async (args) => {
                 try {
                     const result = await client.getWorklog(args.worklogId);
-                    // Pass resource metadata for buffer tracking and invalidation
-                    return formatSuccess(result, {
+                    const issueKey = result.issue?.key || "";
+                    return formatSuccessBuffered(result, {
                         resourceType: "tempo_worklog",
+                        title: issueKey ? `${issueKey} worklog #${args.worklogId}` : `Worklog #${args.worklogId}`,
                         resourceId: String(args.worklogId),
-                        issueKey: result.issue?.key,
+                        issueKey,
                     });
                 }
                 catch (error) {
@@ -183,13 +201,17 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
             },
         },
         tempo_get_accounts: {
-            description: `Get all Tempo accounts. Accounts track work against customers, projects, or cost centers.`,
+            description: `Get all Tempo accounts. Accounts track work against customers, projects, or cost centers.
+
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.`,
             inputSchema: z.object({}),
             handler: async () => {
                 try {
                     const result = await client.getAccounts();
-                    // Use formatSuccess for automatic buffering of large responses
-                    return formatSuccess(result);
+                    return formatSuccessBuffered(result, {
+                        resourceType: "tempo_accounts",
+                        title: "All Tempo Accounts",
+                    });
                 }
                 catch (error) {
                     return formatError(isApiError(error) ? error : new Error(String(error)));
@@ -197,15 +219,20 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
             },
         },
         tempo_get_account: {
-            description: "Get detailed information about a Tempo account",
+            description: `Get detailed information about a Tempo account.
+
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.`,
             inputSchema: z.object({
                 accountKey: z.string().describe("Account key"),
             }),
             handler: async (args) => {
                 try {
                     const result = await client.getAccount(args.accountKey);
-                    // Use formatSuccess for automatic buffering of large responses
-                    return formatSuccess(result);
+                    return formatSuccessBuffered(result, {
+                        resourceType: "tempo_account",
+                        title: result.name || args.accountKey,
+                        accountKey: args.accountKey,
+                    });
                 }
                 catch (error) {
                     return formatError(isApiError(error) ? error : new Error(String(error)));
@@ -213,13 +240,17 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
             },
         },
         tempo_get_teams: {
-            description: `Get all Tempo teams. Teams organize users and track capacity/workload.`,
+            description: `Get all Tempo teams. Teams organize users and track capacity/workload.
+
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.`,
             inputSchema: z.object({}),
             handler: async () => {
                 try {
                     const result = await client.getTeams();
-                    // Use formatSuccess for automatic buffering of large responses
-                    return formatSuccess(result);
+                    return formatSuccessBuffered(result, {
+                        resourceType: "tempo_teams",
+                        title: "All Tempo Teams",
+                    });
                 }
                 catch (error) {
                     return formatError(isApiError(error) ? error : new Error(String(error)));
@@ -227,15 +258,20 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
             },
         },
         tempo_get_team: {
-            description: "Get detailed information about a Tempo team",
+            description: `Get detailed information about a Tempo team.
+
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.`,
             inputSchema: z.object({
                 teamId: z.number().describe("Team ID"),
             }),
             handler: async (args) => {
                 try {
                     const result = await client.getTeam(args.teamId);
-                    // Use formatSuccess for automatic buffering of large responses
-                    return formatSuccess(result);
+                    return formatSuccessBuffered(result, {
+                        resourceType: "tempo_team",
+                        title: result.name || `Team #${args.teamId}`,
+                        teamId: args.teamId,
+                    });
                 }
                 catch (error) {
                     return formatError(isApiError(error) ? error : new Error(String(error)));
@@ -243,7 +279,9 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
             },
         },
         tempo_get_team_worklogs: {
-            description: `Get all worklogs for a team within a date range. Large responses are buffered.`,
+            description: `Get all worklogs for a team within a date range.
+
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.`,
             inputSchema: z.object({
                 teamId: z.number().describe("Team ID"),
                 dateFrom: z.string().describe("Start date (YYYY-MM-DD)"),
@@ -252,9 +290,13 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
             handler: async (args) => {
                 try {
                     const result = await client.getTeamWorklogs(args.teamId, args.dateFrom, args.dateTo);
-                    return formatSuccess({
+                    return formatSuccessBuffered({
                         ...formatWorklogSearchMetadata(result),
                         worklogs: result.results,
+                    }, {
+                        resourceType: "tempo_team_worklogs",
+                        title: `Team #${args.teamId} worklogs ${args.dateFrom} to ${args.dateTo}`,
+                        teamId: args.teamId,
                     });
                 }
                 catch (error) {
@@ -282,7 +324,9 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
             },
         },
         tempo_get_epic_worklogs: {
-            description: `Get all worklogs for an Epic and its child issues in one API call. More efficient than jira_get_total_worklogs for Tempo instances. Large responses are buffered.`,
+            description: `Get all worklogs for an Epic and its child issues in one API call. More efficient than jira_get_total_worklogs for Tempo instances.
+
+Returns bufferId. Use buffer_get_chunk to read, buffer_grep to search.`,
             inputSchema: z.object({
                 epicKey: z.string().describe("Epic issue key (e.g., PROJ-100)"),
                 dateFrom: z.string().optional().describe("Start date filter (YYYY-MM-DD)"),
@@ -314,7 +358,11 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
                         ...item,
                         timeSpent: formatTimeSpent(item.timeSpentSeconds),
                     }));
-                    return formatSuccess({
+                    const titleParts = [args.epicKey, "epic worklogs"];
+                    if (args.dateFrom || args.dateTo) {
+                        titleParts.push(`${args.dateFrom || "..."} to ${args.dateTo || "..."}`);
+                    }
+                    return formatSuccessBuffered({
                         epicKey: args.epicKey,
                         totalTimeSpentSeconds,
                         totalTimeSpent: formatTimeSpent(totalTimeSpentSeconds),
@@ -322,6 +370,10 @@ Time format: hours as decimal (1.5 = 1h 30m), date as YYYY-MM-DD.`,
                         issueCount: breakdown.length,
                         breakdown,
                         worklogs: result.results,
+                    }, {
+                        resourceType: "tempo_epic_worklogs",
+                        title: titleParts.join(" "),
+                        epicKey: args.epicKey,
                     });
                 }
                 catch (error) {

package/dist/tempo/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tempo/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tempo/tools.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"];
 type Topic = (typeof TOPICS)[number];
-declare const WORKFLOW_GUIDE = "# Jicon Quick Reference\n\n## Decision Tree - Which Topic?\n\n| Task | First Step |\n|------|------------|\n| Edit Confluence page | `confluence_edit(input)` \u2190 accepts URL, pageId, or SPACE/Title |\n| Create NEW page | `confluence_draft_create(spaceKey, title, content)` |\n| Create page with diagram | `help(topic=\"plantuml\")` |\n| XHTML syntax needed | `help(topic=\"storage\")` |\n| Search Confluence | `help(topic=\"cql\")` |\n| Search Jira | `jira_get_issue_types()` then `help(topic=\"jql\")` |\n| Log/get time | `tempo_get_user_info()` first |\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\n   \u2192 Use plantuml=\"@startuml...\" for diagrams\n   \u2192 Use fromBufferId=\"buf_xxx\" to merge another buffer\n3. 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\n4. User reviews in Confluence UI (can share draft with team)\n5. confluence_review_publish(reviewDraftId) \u2192 applies changes to original\n   OR confluence_review_discard(reviewDraftId) \u2192 cancels without changes\n6. For more edits: confluence_edit(same URL or \"SPACE/Title\")\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### Create NEW Confluence Page\n```\n1. confluence_draft_create(spaceKey, title, content)\n   \u2192 Returns: draftId, bufferId, draft URL\n2. User reviews and publishes via Confluence UI\n3. For edits after publish: confluence_edit(\"SPACE/Title\")\n```\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\n## Decision Tree - Which Topic?\n\n| Task | First Step |\n|------|------------|\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| Log/get time | `tempo_get_user_info()` first |\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### 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;AAKzE,QAAA,MAAM,MAAM,2DAA4D,CAAC;AACzE,KAAK,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAGrC,QAAA,MAAM,cAAc,8sGAuFnB,CAAC;AA4fF,wBAAgB,oBAAoB;;;;;;;;;;wBA2BR;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;AAKzE,QAAA,MAAM,MAAM,2DAA4D,CAAC;AACzE,KAAK,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAGrC,QAAA,MAAM,cAAc,2lHA4FnB,CAAC;AA4gBF,wBAAgB,oBAAoB;;;;;;;;;;wBA2BR;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"}

package/dist/utils/jicon-help.js

@@ -17,9 +17,9 @@ const WORKFLOW_GUIDE = `# Jicon Quick Reference
 | Task | First Step |
 |------|------------|
 | Edit Confluence page | \`confluence_edit(input)\` ← accepts URL, pageId, or SPACE/Title |
-| Create NEW page | \`confluence_draft_create(spaceKey, title, content)\` |
+| Create NEW page | \`buffer_create(content, contentType="xhtml")\` then \`confluence_draft_create\` |
 | Create page with diagram | \`help(topic="plantuml")\` |
-| XHTML syntax needed | \`help(topic="storage")\` |
+| XHTML syntax needed | \`help(topic="storage")\` ← **READ THIS for HTML vs XHTML** |
 | Search Confluence | \`help(topic="cql")\` |
 | Search Jira | \`jira_get_issue_types()\` then \`help(topic="jql")\` |
 | Log/get time | \`tempo_get_user_info()\` first |
@@ -34,16 +34,16 @@ const WORKFLOW_GUIDE = `# Jicon Quick Reference
    - Accepts: URL, pageId, "draft:ID", or "SPACE/Title"
    → Returns: bufferId, structure (element IDs), pageId
 2. buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)
-   → Use content="<p>text</p>" for XHTML
+   → Use content="<p>text</p>" for XHTML (use <br/> not <br>!)
    → Use plantuml="@startuml..." for diagrams
    → Use fromBufferId="buf_xxx" to merge another buffer
-3. confluence_draft_create(pageId=..., bufferId=...)
+3. buffer_validate_xhtml(bufferId) → check for errors before saving
+4. confluence_draft_create(pageId=..., bufferId=...)
    → Creates "[jicon-mcp REVIEW] Title" draft linked to original
    → Returns: reviewDraftId, draft URL for user review
-4. User reviews in Confluence UI (can share draft with team)
-5. confluence_review_publish(reviewDraftId) → applies changes to original
+5. User reviews in Confluence UI (can share draft with team)
+6. confluence_review_publish(reviewDraftId) → applies changes to original
    OR confluence_review_discard(reviewDraftId) → cancels without changes
-6. For more edits: confluence_edit(same URL or "SPACE/Title")
 \`\`\`
 
 **Review Workflow Tools:**
@@ -51,14 +51,19 @@ const WORKFLOW_GUIDE = `# Jicon Quick Reference
 - \`confluence_review_discard(reviewDraftId)\` - Discard without changes
 - \`confluence_review_list()\` - Find all review drafts for cleanup
 
-### Create NEW Confluence Page
+### Create NEW Confluence Page (Buffer-First)
 \`\`\`
-1. confluence_draft_create(spaceKey, title, content)
-   → Returns: draftId, bufferId, draft URL
-2. User reviews and publishes via Confluence UI
-3. For edits after publish: confluence_edit("SPACE/Title")
+1. buffer_create(content="<h1>Title</h1><p>Content</p>", contentType="xhtml")
+   → Returns: bufferId, structure (element IDs)
+2. buffer_validate_xhtml(bufferId)
+   → If errors: use buffer_edit(bufferId, replace=elementId, ...) to fix
+3. confluence_draft_create(spaceKey, title, bufferId)
+   → Returns: draftId, draft URL for user review
+4. User reviews and publishes via Confluence UI
 \`\`\`
 
+**Why buffer-first?** Enables validation and surgical error fixing with element IDs.
+
 ### Insert PlantUML Diagram
 \`\`\`
 1. plantuml_validate(code="@startuml...") ← Validate FIRST
@@ -143,7 +148,8 @@ const JQL_HELP = `# JQL Syntax Guide
 - Date functions: startOfDay(), startOfWeek(), startOfMonth(), now()
 - Relative dates: startOfDay(-7) = 7 days ago
 - Always quote field values that contain spaces
-- Issue type names may be localized (e.g., "Epopee" instead of "Epic")`;
+- Issue type names may be localized (e.g., "Epopee" instead of "Epic")
+- Results are always buffered - use buffer_get_chunk to read, buffer_grep to search`;
 // CQL syntax guide
 const CQL_HELP = `# CQL Syntax Guide
 
@@ -196,25 +202,48 @@ OK: (text~"term1" OR text~"term2") - Each term needs its own text~ operator
 - Use space KEY (e.g., 'DOCS') not space name (e.g., 'Documentation')
 - Date functions: now(), startOfDay(), startOfWeek(), startOfMonth()
 - Relative dates: now("-7d") = 7 days ago
-- Results are auto-fetched (up to 5000) and buffered for large responses`;
+- Results are always buffered - use buffer_get_chunk to read, buffer_grep to search`;
 // Confluence storage format (XHTML syntax only)
 const STORAGE_FORMAT_HELP = `# Confluence Storage Format (XHTML)
 
-All tags must be closed (XML rules). For editing workflow, see \`help(topic="buffers")\`.
+Confluence uses **XHTML** (strict XML), NOT loose HTML5. This matters!
 
-## CRITICAL: CDATA Usage
+## CRITICAL: HTML vs XHTML Differences
 
-**NEVER wrap content in \`<![CDATA[...]]>\`**
+| HTML (loose) | XHTML (strict) | Why |
+|--------------|----------------|-----|
+| \`<br>\` | \`<br/>\` | Self-closing required |
+| \`<hr>\` | \`<hr/>\` | Self-closing required |
+| \`<img src="x">\` | \`<img src="x"/>\` | Self-closing required |
+| \`<p>text\` | \`<p>text</p>\` | All tags must close |
+| \`<li>item\` | \`<li>item</li>\` | All tags must close |
+| \`&\` in URLs | \`&amp;\` | Must escape special chars |
+| \`<LI>\` | \`<li>\` | Tags are lowercase |
 
-CDATA is ONLY used inside \`<ac:plain-text-body>\` elements (code blocks, PlantUML):
-\`\`\`xml
-<!-- CORRECT: CDATA inside ac:plain-text-body -->
-<ac:structured-macro ac:name="code">
-  <ac:plain-text-body><![CDATA[code here]]></ac:plain-text-body>
-</ac:structured-macro>
+## Common Mistakes to AVOID
+
+| ❌ Wrong | ✅ Correct | Error |
+|----------|-----------|-------|
+| \`<br>\` | \`<br/>\` | Parser expects \`</br>\` |
+| \`li>item</li>\` | \`<li>item</li>\` | Missing \`<\` before tag |
+| \`h2. Title\` | \`<h2>Title</h2>\` | Wiki syntax not allowed |
+| \`**bold**\` | \`<strong>bold</strong>\` | Markdown not allowed |
+| \`<![CDATA[<p>...</p>]]>\` | \`<p>...</p>\` | CDATA only in macros |
+
+## Workflow: Buffer-First Approach
 
-<!-- WRONG: CDATA wrapping content -->
-<![CDATA[<h1>Title</h1>]]>
+\`\`\`
+1. buffer_create(content="<h1>Title</h1><p>Text</p>", contentType="xhtml")
+   → bufferId, structure (element IDs)
+
+2. buffer_validate_xhtml(bufferId)
+   → If errors: shows elementId to fix
+
+3. buffer_edit(bufferId, replace=elementId, content="<p>Fixed</p>")
+   → Surgical fix using element ID
+
+4. confluence_draft_create(spaceKey, title, bufferId)
+   → Creates draft for user review
 \`\`\`
 
 ## Basic Elements
@@ -222,11 +251,13 @@ CDATA is ONLY used inside \`<ac:plain-text-body>\` elements (code blocks, PlantU
 | Element | Syntax |
 |---------|--------|
 | Paragraph | \`<p>text</p>\` |
-| Headings | \`<h1>\`...\`<h6>\` |
-| Bold/Italic | \`<strong>\`, \`<em>\` |
+| Headings | \`<h1>...</h1>\` to \`<h6>...</h6>\` |
+| Bold/Italic | \`<strong>text</strong>\`, \`<em>text</em>\` |
+| Line break | \`<br/>\` (self-closing!) |
+| Horizontal rule | \`<hr/>\` (self-closing!) |
 | Code inline | \`<code>text</code>\` |
 | Link | \`<a href="url">text</a>\` |
-| List | \`<ul><li>item</li></ul>\` or \`<ol>\` |
+| List | \`<ul><li>item</li></ul>\` or \`<ol><li>...</li></ol>\` |
 
 ## Tables
 \`\`\`xml
@@ -269,10 +300,14 @@ Cross-space: add \`ri:space-key="KEY"\` to ri:page
 </ac:task-list>
 \`\`\`
 
-## Emoticons
+## Status Indicators (use emoticons)
 \`\`\`xml
-<ac:emoticon ac:name="tick"/>  <!-- tick, cross, warning, information -->
-<ac:emoticon ac:name="thumbs-up"/>  <!-- thumbs-up/down, plus, minus -->
+<ac:emoticon ac:name="tick"/>      <!-- ✓ green checkmark -->
+<ac:emoticon ac:name="cross"/>     <!-- ✗ red X -->
+<ac:emoticon ac:name="warning"/>   <!-- ⚠ yellow warning -->
+<ac:emoticon ac:name="information"/>  <!-- ℹ blue info -->
+<ac:emoticon ac:name="plus"/>      <!-- + green plus -->
+<ac:emoticon ac:name="minus"/>     <!-- - red minus -->
 \`\`\`
 
 ## Code Block Macro
@@ -291,18 +326,31 @@ Cross-space: add \`ri:space-key="KEY"\` to ri:page
 \`\`\`
 Types: \`info\`, \`note\`, \`warning\`, \`tip\`
 
-## Macro Rules
+## CDATA Rules
+
+**CDATA is ONLY used inside \`<ac:plain-text-body>\`** (code blocks, PlantUML):
+\`\`\`xml
+<!-- CORRECT: CDATA inside ac:plain-text-body -->
+<ac:structured-macro ac:name="code">
+  <ac:plain-text-body><![CDATA[code here]]></ac:plain-text-body>
+</ac:structured-macro>
+
+<!-- WRONG: CDATA wrapping regular content -->
+<![CDATA[<h1>Title</h1>]]>
+\`\`\`
+
+## Macro Content Rules
 
 | Element | Content Allowed |
 |---------|-----------------|
 | \`ac:parameter\` | Plain text only (no child elements) |
-| \`ac:plain-text-body\` | Raw text, wrap in \`<![CDATA[...]]>\` |
-| \`ac:rich-text-body\` | XHTML for info/warning panels |
+| \`ac:plain-text-body\` | Raw text wrapped in \`<![CDATA[...]]>\` |
+| \`ac:rich-text-body\` | XHTML (for info/warning panels) |
 
 ---
 
-For element ID editing workflow, see \`help(topic="buffers")\`.
-For PlantUML diagrams, see \`help(topic="plantuml")\`.`;
+For element ID editing: \`help(topic="buffers")\`
+For PlantUML diagrams: \`help(topic="plantuml")\``;
 // PlantUML syntax guide (Confluence-specific only - LLMs know PlantUML syntax)
 const PLANTUML_HELP = `# PlantUML in Confluence
 
@@ -322,18 +370,6 @@ const PLANTUML_HELP = `# PlantUML in Confluence
 | \`plantuml_render(code, format)\` | Preview: ascii, svg, png, eps |
 | \`plantuml_status()\` | Check Docker container status |
 
-## Confluence Macro Structure (auto-generated by buffer_edit)
-\`\`\`xml
-<ac:structured-macro ac:name="plantuml" ac:schema-version="1" ac:macro-id="uuid">
-  <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
-  <ac:plain-text-body><![CDATA[
-@startuml
-' diagram code
-@enduml
-]]></ac:plain-text-body>
-</ac:structured-macro>
-\`\`\`
-
 ## Critical Rules (MANDATORY)
 
 1. **Always use \`plantuml\` parameter**: \`buffer_edit(..., plantuml="...")\` is REQUIRED
@@ -434,34 +470,19 @@ Rel(sys, pay, "Pays via")
 | "Element not found" | Check \`buffer_get_structure\` for valid IDs |
 | "XHTML invalid" | Create fresh buffer, insert diagram |
 
-## Advanced: Direct Macro Embedding
-
-For pages with **multiple diagrams**, reduce tool calls by embedding macros directly:
-
-\`\`\`
-1. plantuml_validate(code) × N   ← Validate ALL diagrams first (parallel)
-2. buffer_create with embedded macros:
-\`\`\`
+## Multiple Diagrams
 
-\`\`\`xml
-<h2>Architecture</h2>
-<ac:structured-macro ac:name="plantuml" ac:schema-version="1" ac:macro-id="diag-1">
-  <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
-  <ac:plain-text-body><![CDATA[@startuml
-...validated code...
-@enduml]]></ac:plain-text-body>
-</ac:structured-macro>
-<h2>Sequence Flow</h2>
-<ac:structured-macro ac:name="plantuml" ac:schema-version="1" ac:macro-id="diag-2">
-  ...second diagram...
-</ac:structured-macro>
-\`\`\`
+For pages with multiple diagrams, call \`buffer_edit\` multiple times:
 
 \`\`\`
-3. confluence_draft_create(bufferId=...)
+1. plantuml_validate(code1)  ← Validate first diagram
+2. plantuml_validate(code2)  ← Validate second diagram (parallel)
+3. buffer_edit(bufferId, after=5, plantuml=code1)
+4. buffer_edit(bufferId, after=6, plantuml=code2)
+5. confluence_draft_create(bufferId=...)
 \`\`\`
 
-**Benefit**: 3 diagrams = 5 calls (vs 8 with buffer_edit per diagram)
+Each \`plantuml\` parameter = one diagram. The macro wrapping is automatic.
 
 For element ID editing: \`help(topic="buffers")\``;
 // Buffers help guide (canonical element ID reference)
@@ -611,7 +632,7 @@ Available topics:
 - cql: CQL (Confluence Query Language) syntax
 - storage: Confluence storage format + structure editing (element IDs)
 - plantuml: PlantUML diagram syntax for Confluence
-- buffers: Buffer management and large response handling
+- buffers: Buffer management and element ID editing
 
 Examples:
   help() -> Workflow guide

package/dist/utils/jicon-help.js.map

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

package/dist/utils/response-formatter.d.ts

@@ -7,6 +7,19 @@ import type { ToolResult, ApiError } from "../types.js";
  */
 export declare function getMaxOutputSize(): number;
 export declare function formatSuccess(data: unknown, metadata?: Record<string, unknown>): ToolResult;
+/**
+ * Format a successful response that ALWAYS buffers data.
+ * Use for data-heavy tools (search, list, get) to provide consistent buffer-based access.
+ *
+ * @param data - The data to buffer
+ * @param metadata - Required metadata including resourceType and title for origin tracking
+ * @returns ToolResult with bufferId and metadata
+ */
+export declare function formatSuccessBuffered(data: unknown, metadata: {
+    resourceType: string;
+    title: string;
+    [key: string]: unknown;
+}): ToolResult;
 export declare function formatError(error: ApiError | Error): ToolResult;
 export declare function isApiError(error: unknown): error is ApiError;
 /**

package/dist/utils/response-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/response-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMxD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAqE3F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CA0B/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAO5D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,iBAAiB,GAAG,YAAY,GAAG,eAAe,CAAC;CACnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,CAwDpF"}
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/response-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMxD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAqE3F;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACxE,UAAU,CAiBZ;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CA0B/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAO5D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,iBAAiB,GAAG,YAAY,GAAG,eAAe,CAAC;CACnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,CAwDpF"}