@crypto512/jicon-mcp 0.7.1 → 1.0.1

package/dist/utils/jicon-help.js

@@ -0,0 +1,873 @@
+/**
+ * Unified help tool for Jicon MCP Server
+ *
+ * Provides workflow guides and syntax references via topic parameter.
+ * Entry point for all help content - no API calls.
+ */
+import { z } from "zod";
+import { formatSuccess, formatError } from "./response-formatter.js";
+// Available topics
+const TOPICS = ["jql", "cql", "storage", "plantuml"];
+// Default workflow guide (shown when no topic specified)
+const WORKFLOW_GUIDE = `# Jicon Quick Reference
+
+## Topics Available
+\`help(topic="jql|cql|storage|plantuml")\`
+
+---
+
+## Confluence Workflows
+
+### Create Page
+\`\`\`
+help(topic="storage") <- GET SYNTAX FIRST
+  -> confluence_draft_create(spaceKey, title, content)
+     Returns: draftId, bufferId, url
+  -> User publishes via Confluence UI
+\`\`\`
+
+### Create Page with Diagram
+\`\`\`
+help(topic="plantuml") <- GET DIAGRAM SYNTAX FIRST
+help(topic="storage") <- GET PAGE SYNTAX
+  -> confluence_draft_create(...)
+  -> User publishes via Confluence UI
+\`\`\`
+
+### Draft Workflow (iterative editing)
+\`\`\`
+help(topic="storage") <- if syntax needed
+  -> confluence_draft_create(spaceKey, title, content)
+     Returns: draftId, bufferId, url (click to preview)
+  -> buffer_edit_xhtml(...) or buffer_edit(...) [repeat]
+  -> confluence_draft_save(draftId, bufferId) [checkpoint]
+  -> User publishes manually via Confluence UI
+\`\`\`
+
+### Update Page
+\`\`\`
+confluence_get_page(pageId) -> bufferId
+  -> buffer_edit_xhtml(...) or buffer_edit(...)
+  -> confluence_draft_create(spaceKey, title, bufferId=bufferId)
+  -> User publishes via Confluence UI
+\`\`\`
+
+### Search Pages
+\`\`\`
+help(topic="cql") <- GET QUERY SYNTAX FIRST
+  -> confluence_search_content(cql)
+\`\`\`
+
+### Write-Home Restriction
+When enabled, writes restricted to personal space only.
+\`\`\`
+confluence_get_current_user_space() <- GET YOUR SPACE KEY FIRST
+  -> use spaceKey for create/update
+\`\`\`
+
+---
+
+## Jira Workflows
+
+### Search Issues
+\`\`\`
+jira_get_issue_types() <- DISCOVER TYPE NAMES FIRST
+help(topic="jql") <- GET QUERY SYNTAX
+  -> jira_search_issues(jql)
+\`\`\`
+
+### Create Issue
+\`\`\`
+jira_get_issue_types() <- DISCOVER TYPES FIRST
+  -> jira_create_issue(projectKey, issueType, summary)
+  -> fullurl(issueKey) for clickable link
+\`\`\`
+
+### Worklogs
+\`\`\`
+jira_get_issue_worklogs(issueKey) [single issue]
+jira_get_total_worklogs(epicKey) [epic + children]
+  -> workload_convert/workload_sum for calculations
+\`\`\`
+
+---
+
+## Tempo Workflows
+
+### Log Work
+\`\`\`
+tempo_log_work(issueKey, hours, date, description)
+\`\`\`
+
+### Get Worklogs
+\`\`\`
+tempo_get_user_info() <- GET workerKey FIRST
+  -> tempo_get_worklogs(dateFrom, dateTo, workerKey)
+  WARNING: No workerKey = ALL worklogs (slow!)
+\`\`\`
+
+### Epic Analysis
+\`\`\`
+tempo_get_epic_worklogs(epicKey) [more efficient than Jira API]
+\`\`\`
+
+---
+
+## Buffer Patterns
+
+### Large Response
+\`\`\`
+[tool] returns bufferId when > 16KB
+  -> buffer_get_chunk(bufferId, offset, limit)
+  -> buffer_grep(bufferId, pattern) [search]
+\`\`\`
+
+### Edit Before Persist
+\`\`\`
+buffer_create(content) OR [tool that returns bufferId]
+  -> buffer_edit(bufferId, old, new)
+  -> buffer_get_chunk(bufferId, limit=50000)
+  -> confluence_draft_create(..., bufferId=bufferId)
+  -> User publishes via Confluence UI
+\`\`\`
+
+---
+
+## Utility Tools
+
+### fullurl - Clickable Links (display only)
+\`\`\`
+fullurl("PROJ-123")  -> Jira URL
+fullurl("123456")    -> Confluence page URL
+\`\`\`
+WARNING: Never persist fullurl output to Jira/Confluence
+
+### workload_convert / workload_sum
+\`\`\`
+workload_convert(28800, "seconds") -> 8h, 1d
+workload_sum([...]) -> total in all units
+\`\`\`
+
+---
+
+## Decision Tree
+
+| Need | Action |
+|------|--------|
+| Create page with diagram | \`help(topic="plantuml")\` then \`help(topic="storage")\` |
+| Create/update page | \`help(topic="storage")\` |
+| Search Confluence | \`help(topic="cql")\` |
+| Search Jira | \`jira_get_issue_types()\` then \`help(topic="jql")\` |
+| User's worklogs | \`tempo_get_user_info()\` first |
+| Write to Confluence | \`confluence_get_current_user_space()\` if restricted |
+`;
+// JQL syntax guide
+const JQL_HELP = `# JQL Syntax Guide
+
+## Operators
+- Field operators: =, !=, >, <, >=, <=, ~, IN, NOT IN
+- Text search: use ~ for "contains" (e.g., summary~"bug")
+- Combine: AND, OR, NOT
+- Order: ORDER BY field ASC/DESC
+
+## Common Examples
+1. All Epics in a project:
+   project = PROJ AND type = Epic
+
+2. Stories in current sprint:
+   project = PROJ AND type = Story AND sprint in openSprints()
+
+3. Open bugs by priority:
+   project = PROJ AND type = Bug AND status != Done ORDER BY priority DESC
+
+4. Recently updated issues (last 7 days):
+   updated >= startOfDay(-7)
+
+5. Issues by assignee:
+   assignee = currentUser()
+
+6. Text search in summary/description:
+   summary~"login" OR description~"login"
+
+7. Date range:
+   created >= "2025-01-01" AND created <= "2025-01-31"
+
+8. Multiple projects:
+   project IN (PROJ1, PROJ2, PROJ3)
+
+9. Exclude resolved:
+   resolution = Unresolved
+
+10. Issues with specific label:
+    labels = "urgent" AND status != Done
+
+## Tips
+- Use jira_get_issue_types first to discover type names for your instance
+- 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")`;
+// CQL syntax guide
+const CQL_HELP = `# CQL Syntax Guide
+
+## Operators
+- Text search: text~"term" (searches both title and body)
+- Title only: title~"term"
+- By space: space=KEY (use space KEY, not name!)
+- By type: type=page or type=blogpost
+- Combine: AND, OR, NOT
+- Order: ORDER BY created/lastmodified ASC/DESC
+
+## Critical Warnings
+WARNING: Do NOT use 'content~' or 'body~' - they're invalid! Use 'text~' instead.
+
+WARNING: WRONG: text~("term1" OR "term2") - Cannot use OR inside the operator
+OK: (text~"term1" OR text~"term2") - Each term needs its own text~ operator
+
+## Common Examples
+1. Recently updated pages (last 7 days):
+   type=page AND lastmodified >= now("-7d")
+
+2. Pages created by a person:
+   type=page AND creator="username"
+
+3. Pages with specific label:
+   type=page AND label="meeting-notes"
+
+4. Pages in space modified recently:
+   space=DOCS AND lastmodified >= now("-30d") ORDER BY lastmodified DESC
+
+5. Text search in a space:
+   text~"API" AND space=DOCS AND type=page
+
+6. Date range:
+   lastmodified >= "2025-01-01" AND lastmodified <= "2025-01-31"
+
+7. Multiple spaces:
+   space IN (DOCS, PROJ, WIKI)
+
+8. Pages by title pattern:
+   type=page AND title~"Sprint Review" ORDER BY created DESC
+
+9. Find by creator name:
+   creator.fullname~"John Smith"
+
+10. Pages created this week:
+    type=page AND created >= startOfWeek()
+
+## Tips
+- 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`;
+// Confluence storage format (unified)
+const STORAGE_FORMAT_HELP = `# Confluence Storage Format
+
+XHTML-based format. All tags must be closed (XML rules).
+
+## Workflows
+
+### Create Page
+\`\`\`
+confluence_draft_create(spaceKey, title, content) -> draftId, bufferId, url
+[user previews via url]
+buffer_edit_xhtml(bufferId, ...) [repeat as needed]
+confluence_draft_save(draftId, bufferId) [checkpoint, returns new draftId and url]
+[user publishes via Confluence UI]
+\`\`\`
+
+### Update Page
+\`\`\`
+confluence_get_page(pageId) -> bufferId
+buffer_edit_xhtml(bufferId, ...) or buffer_edit(bufferId, old, new)
+confluence_draft_create(spaceKey, title, bufferId=bufferId) -> draftId, url
+[user publishes via Confluence UI]
+\`\`\`
+
+---
+
+## Basic Elements
+
+| Element | Syntax |
+|---------|--------|
+| Paragraph | \`<p>text</p>\` |
+| Headings | \`<h1>\`...\`<h6>\` |
+| Bold/Italic | \`<strong>\`, \`<em>\` |
+| Code | \`<code>text</code>\` |
+| Link | \`<a href="url">text</a>\` |
+| List | \`<ul><li>item</li></ul>\` |
+
+## Tables
+\`\`\`xml
+<table><tbody>
+  <tr><th>Header</th></tr>
+  <tr><td>Cell</td></tr>
+</tbody></table>
+\`\`\`
+Merge: \`colspan="2"\`, \`rowspan="2"\`
+
+## Layouts
+\`\`\`xml
+<ac:layout>
+  <ac:layout-section ac:type="two_equal">
+    <ac:layout-cell><p>Left</p></ac:layout-cell>
+    <ac:layout-cell><p>Right</p></ac:layout-cell>
+  </ac:layout-section>
+</ac:layout>
+\`\`\`
+Types: single, two_equal, two_left_sidebar, two_right_sidebar, three_equal
+
+## Page Links
+\`\`\`xml
+<ac:link><ri:page ri:content-title="Page"/>
+  <ac:plain-text-link-body><![CDATA[text]]></ac:plain-text-link-body>
+</ac:link>
+\`\`\`
+Cross-space: add \`ri:space-key="KEY"\`
+
+## Images
+\`\`\`xml
+<ac:image ac:width="300"><ri:attachment ri:filename="img.png"/></ac:image>
+<ac:image><ri:url ri:value="https://..."/></ac:image>
+\`\`\`
+
+## Task List
+\`\`\`xml
+<ac:task-list>
+  <ac:task>
+    <ac:task-status>incomplete</ac:task-status>
+    <ac:task-body>Todo</ac:task-body>
+  </ac:task>
+</ac:task-list>
+\`\`\`
+
+---
+
+## Structure Editing (buffer_edit_xhtml)
+
+CSS-like selectors to target elements:
+- Tag: \`p\`, \`table\`, \`h1\`
+- Namespaced: \`ac:structured-macro\`, \`ri:page\`
+- Attribute: \`[ac:name="plantuml"]\`, \`ac:structured-macro[ac:name="code"]\`
+- Pseudo: \`:nth-child(2)\`, \`:first-child\`, \`:last-child\`
+- Descendant: \`table tbody tr\`
+- Direct child: \`ul > li\`
+
+### Operations
+
+| Op | Use | Required params |
+|----|-----|-----------------|
+| insert | Add element | selector, position, content |
+| update | Change content/attrs | selector, content or attributes |
+| remove | Delete element | selector |
+| move | Relocate element | selector, targetSelector, position |
+| wrap | Wrap with parent | selector, content |
+| insert-plantuml | Add diagram | selector, position, plantuml |
+| update-plantuml | Edit diagram | selector, plantuml |
+
+Positions: \`before\`, \`after\`, \`inside-start\`, \`inside-end\`
+
+### Examples
+
+**Add row to table:**
+\`\`\`
+buffer_edit_xhtml(bufferId,
+  operation="insert",
+  selector="table tbody tr:last-child",
+  position="after",
+  content="<tr><td>New</td><td>Row</td></tr>")
+\`\`\`
+
+**Update heading:**
+\`\`\`
+buffer_edit_xhtml(bufferId,
+  operation="update",
+  selector="h1",
+  content="<h1>New Title</h1>")
+\`\`\`
+
+**Insert PlantUML (auto-validates + wraps in macro):**
+\`\`\`
+buffer_edit_xhtml(bufferId,
+  operation="insert-plantuml",
+  selector="h2:first-child",
+  position="after",
+  plantuml="@startuml\\nA -> B: msg\\n@enduml")
+\`\`\`
+
+**Remove element:**
+\`\`\`
+buffer_edit_xhtml(bufferId,
+  operation="remove",
+  selector="ac:structured-macro[ac:name=\\"toc\\"]")
+\`\`\`
+
+Options: \`matchIndex=N\` (0-based) or \`matchAll=true\` for multiple matches`;
+// PlantUML syntax guide
+const PLANTUML_HELP = `# PlantUML in Confluence - Syntax Guide
+
+## PlantUML Workflow
+
+PlantUML diagrams must be inserted using \`buffer_edit_xhtml\` with the \`insert-plantuml\` operation.
+Raw @startuml blocks in content are not supported.
+
+### Required Workflow
+\`\`\`
+1. Create XHTML content (WITHOUT PlantUML)
+2. plantuml_validate(code="@startuml...") <- Validate syntax first
+3. buffer_edit_xhtml(bufferId, operation="insert-plantuml", plantuml=code, semanticPosition="...")
+4. confluence_draft_create/save(bufferId)
+5. User publishes via Confluence UI
+\`\`\`
+
+### Example
+\`\`\`
+buffer_edit_xhtml(bufferId,
+  operation="insert-plantuml",
+  semanticPosition="after-title",
+  plantuml="@startuml\\nA -> B\\n@enduml")
+\`\`\`
+Validation happens automatically during insertion.
+
+---
+
+## PlantUML Tools (Docker-based)
+
+### Validation
+\`\`\`
+plantuml_validate(code="@startuml\\nA -> B: msg\\n@enduml")
+\`\`\`
+Returns: \`valid\`, \`diagramType\`, \`errors\` with line numbers.
+Docker container starts automatically on first use.
+
+**Example Error Response:**
+\`\`\`json
+{
+  "valid": false,
+  "diagramType": "sequence",
+  "errors": [{"line": 3, "message": "Syntax error: unknown arrow type"}]
+}
+\`\`\`
+
+### Rendering
+\`\`\`
+plantuml_render(code="...", format="ascii|svg|png|eps")
+\`\`\`
+Returns: rendered content (ASCII/SVG inline, PNG/EPS as base64).
+Large renders return \`bufferId\` for retrieval.
+
+### Status
+\`\`\`
+plantuml_status()
+\`\`\`
+Returns: whether Docker container is running.
+
+---
+
+## Insert PlantUML with Semantic Positions
+
+Use \`buffer_edit_xhtml\` with \`semanticPosition\` for easy insertion:
+
+\`\`\`
+buffer_edit_xhtml(bufferId,
+  operation="insert-plantuml",
+  semanticPosition="after-title",  // No selector needed!
+  plantuml="@startuml\\nA -> B\\n@enduml")
+\`\`\`
+
+**Semantic positions:**
+- \`after-title\`: After first h1 or h2
+- \`after-heading\`: After first heading (h1-h6)
+- \`before-content\`: At document start
+- \`end\`: At document end
+- \`after-toc\`: After table of contents macro
+
+---
+
+## Confluence Macro Structure
+
+PlantUML diagrams MUST use this exact XML structure:
+
+\`\`\`xml
+<ac:structured-macro ac:name="plantuml" ac:schema-version="1" ac:macro-id="auto-generated">
+  <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
+  <ac:plain-text-body><![CDATA[
+@startuml
+' Your diagram code here
+@enduml
+]]></ac:plain-text-body>
+</ac:structured-macro>
+\`\`\`
+
+**Required attributes:**
+- \`ac:name="plantuml"\` - Macro identifier
+- \`ac:schema-version="1"\` - Must be "1"
+- \`ac:macro-id\` - Any unique ID (use "auto-generated" or UUID)
+
+**Required parameter:**
+- \`atlassian-macro-output-type=INLINE\` - Renders diagram inline
+
+**Required body:**
+- \`ac:plain-text-body\` with \`CDATA\` wrapping
+- Newline before \`@startuml\` marker
+
+---
+
+## Choosing the Right Diagram
+
+| Diagram | Use When |
+|---------|----------|
+| Sequence | API calls, request/response flows, message exchanges between systems |
+| Class | Data models, entity relationships, object structures |
+| Activity | Workflows, business processes, decision trees, algorithms |
+| Component | System architecture, module dependencies, deployment structure |
+| State | Lifecycle states, status transitions, finite state machines |
+| Use Case | User requirements, system features, actor interactions |
+| Context (C4) | High-level system overview, external dependencies |
+| Container (C4) | Application architecture, runtime components |
+| Component (C4) | Internal structure of a container/service |
+
+---
+
+## Diagram Types
+
+### Sequence Diagram
+**Use for:** API call flows, request/response interactions, message exchanges, authentication flows
+\`\`\`
+@startuml
+participant Alice
+participant Bob
+
+Alice -> Bob: Request
+Bob --> Alice: Response
+@enduml
+\`\`\`
+
+### Class Diagram
+**Use for:** Data models, entity relationships, database schemas, object structures
+\`\`\`
+@startuml
+class User {
+  +id: string
+  +name: string
+  +login(): boolean
+}
+
+class Order {
+  +items: Item[]
+  +total(): number
+}
+
+User "1" --> "*" Order : places
+@enduml
+\`\`\`
+
+### Activity Diagram
+**Use for:** Workflows, business processes, decision trees, algorithms, approval flows
+\`\`\`
+@startuml
+start
+:Initialize;
+if (Valid?) then (yes)
+  :Process;
+else (no)
+  :Reject;
+endif
+stop
+@enduml
+\`\`\`
+
+### Component Diagram
+**Use for:** System architecture, module dependencies, package structure, deployment topology
+\`\`\`
+@startuml
+package "Frontend" {
+  [Web App]
+  [Mobile App]
+}
+
+package "Backend" {
+  [API Server]
+  [Database]
+}
+
+[Web App] --> [API Server]
+[Mobile App] --> [API Server]
+[API Server] --> [Database]
+@enduml
+\`\`\`
+
+### State Diagram
+**Use for:** Object lifecycle, status transitions, order states, ticket workflows
+\`\`\`
+@startuml
+[*] --> Draft
+Draft --> Review : submit
+Review --> Approved : approve
+Review --> Draft : reject
+Approved --> Published : publish
+Published --> [*]
+@enduml
+\`\`\`
+
+### Use Case Diagram
+**Use for:** User requirements, feature overview, actor roles, system boundaries
+\`\`\`
+@startuml
+actor User
+actor Admin
+
+rectangle System {
+  usecase "Login" as UC1
+  usecase "View Data" as UC2
+  usecase "Manage Users" as UC3
+}
+
+User --> UC1
+User --> UC2
+Admin --> UC1
+Admin --> UC3
+@enduml
+\`\`\`
+
+---
+
+## C4-Style Architecture Diagrams
+
+C4-style diagrams for architecture documentation. These use native PlantUML syntax (no external includes required).
+
+### Context Diagram
+**Use for:** High-level system overview, stakeholders, external dependencies, system boundaries
+\`\`\`
+@startuml
+title System Context
+
+skinparam rectangle {
+  BackgroundColor<<person>> #08427B
+  FontColor<<person>> white
+  BackgroundColor<<system>> #1168BD
+  FontColor<<system>> white
+  BackgroundColor<<external>> #999999
+  FontColor<<external>> white
+}
+
+rectangle "User" <<person>> as user
+rectangle "My System" <<system>> as system
+rectangle "External API" <<external>> as external
+
+user --> system : Uses
+system --> external : Calls API
+@enduml
+\`\`\`
+
+### Container Diagram
+**Use for:** Application architecture, runtime components, technology choices, data stores
+\`\`\`
+@startuml
+title Container Diagram
+
+skinparam rectangle {
+  BackgroundColor<<container>> #438DD5
+  FontColor<<container>> white
+  BackgroundColor<<database>> #438DD5
+  FontColor<<database>> white
+}
+
+actor "User" as user
+
+rectangle "My System" {
+  rectangle "Web App\\n[React]" <<container>> as web
+  rectangle "API Server\\n[Node.js]" <<container>> as api
+  database "Database\\n[PostgreSQL]" <<database>> as db
+}
+
+user --> web : Uses [HTTPS]
+web --> api : Calls [REST/JSON]
+api --> db : Reads/Writes [SQL]
+@enduml
+\`\`\`
+
+### Component Diagram
+**Use for:** Internal structure of a container, code organization, module responsibilities
+\`\`\`
+@startuml
+title API Components
+
+skinparam component {
+  BackgroundColor #85BBF0
+  BorderColor #5588BB
+}
+
+package "API Application" {
+  component "Auth Controller" as auth
+  component "User Controller" as userCtrl
+  component "User Service" as service
+  database "User Repository" as repo
+}
+
+auth --> service : Uses
+userCtrl --> service : Uses
+service --> repo : Queries
+@enduml
+\`\`\`
+
+---
+
+## Common Styling
+
+### Colors and Themes
+\`\`\`
+@startuml
+skinparam backgroundColor #FEFEFE
+skinparam roundcorner 10
+
+skinparam class {
+  BackgroundColor #E8F4FD
+  BorderColor #2196F3
+  ArrowColor #1976D2
+}
+
+class Example
+@enduml
+\`\`\`
+
+### Notes
+\`\`\`
+@startuml
+Alice -> Bob: Message
+note right: This is a note
+note over Alice, Bob: Shared note
+@enduml
+\`\`\`
+
+### Grouping
+\`\`\`
+@startuml
+box "Service A" #LightBlue
+  participant A1
+  participant A2
+end box
+
+box "Service B" #LightGreen
+  participant B1
+end box
+
+A1 -> B1: Request
+@enduml
+\`\`\`
+
+---
+
+## Common Pitfalls
+
+**Avoid:**
+- Missing \`ac:schema-version="1"\`
+- Using \`ac:rich-text-body\` instead of \`ac:plain-text-body\`
+- No CDATA wrapper around diagram code
+- No newline before \`@startuml\`
+- Missing \`@startuml\`/\`@enduml\` markers
+
+**Always:**
+- Use exact macro structure shown above
+- Wrap diagram code in CDATA
+- Include \`atlassian-macro-output-type=INLINE\` parameter
+- Start with \`@startuml\` and end with \`@enduml\`
+
+---
+
+## IMPORTANT: External Includes NOT Supported
+
+**Never use external !include statements:**
+\`\`\`
+!include https://raw.githubusercontent.com/...  <-- NOT SUPPORTED
+\`\`\`
+
+Confluence's PlantUML plugin cannot fetch external URLs.
+Use native PlantUML syntax instead (see C4-Style examples above).
+
+---
+
+## Full Example
+
+Complete Confluence storage format for a sequence diagram:
+
+\`\`\`xml
+<ac:structured-macro ac:name="plantuml" ac:schema-version="1" ac:macro-id="diagram-1">
+  <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
+  <ac:plain-text-body><![CDATA[
+@startuml
+skinparam backgroundColor #FEFEFE
+
+participant "Client" as C
+participant "Server" as S
+database "Database" as DB
+
+C -> S: POST /api/data
+S -> DB: INSERT
+DB --> S: OK
+S --> C: 201 Created
+@enduml
+]]></ac:plain-text-body>
+</ac:structured-macro>
+\`\`\``;
+// Topic content map
+const TOPIC_CONTENT = {
+    jql: JQL_HELP,
+    cql: CQL_HELP,
+    storage: STORAGE_FORMAT_HELP,
+    plantuml: PLANTUML_HELP,
+};
+export function createJiconHelpTools() {
+    return {
+        help: {
+            description: `Get Jicon MCP Server help - workflows and syntax guides.
+
+Without topic: Returns workflow quick reference with decision trees.
+With topic: Returns detailed syntax guide.
+
+Available topics:
+- jql: JQL (Jira Query Language) syntax
+- cql: CQL (Confluence Query Language) syntax
+- storage: Confluence storage format + structure editing (buffer_edit_xhtml)
+- plantuml: PlantUML diagram syntax for Confluence
+
+Examples:
+  help() -> Workflow guide
+  help(topic="storage") -> Confluence format guide
+  help(topic="plantuml") -> Diagram syntax guide`,
+            inputSchema: z.object({
+                topic: z
+                    .enum(TOPICS)
+                    .optional()
+                    .describe('Topic for detailed help: "jql", "cql", "storage", "plantuml"'),
+            }),
+            handler: async (args) => {
+                const { topic } = args;
+                // No topic: return workflow guide
+                if (!topic) {
+                    return formatSuccess({
+                        guide: WORKFLOW_GUIDE,
+                    });
+                }
+                // Valid topic: return specific guide
+                if (topic in TOPIC_CONTENT) {
+                    return formatSuccess({
+                        topic,
+                        guide: TOPIC_CONTENT[topic],
+                    });
+                }
+                // Invalid topic (shouldn't happen with zod validation, but just in case)
+                return formatError({
+                    error: true,
+                    message: `Invalid topic: "${topic}". Available topics: ${TOPICS.join(", ")}`,
+                    statusCode: 400,
+                });
+            },
+        },
+    };
+}
+// Tool names for registry
+export const JICON_HELP_TOOLS = ["help"];
+// Export workflow guide for MCP prompt
+export { WORKFLOW_GUIDE };
+//# sourceMappingURL=jicon-help.js.map