@geeveeh/atlassian-tools 0.2.0 → 0.4.0

package/README.md

@@ -4,8 +4,8 @@ CLI and MCP server for Atlassian Cloud. Manage Confluence pages and Jira issues
 
 ## Features
 
-- **Confluence** — Full CRUD for pages: search, read, create, update, delete
-- **Jira** — Issues: search (JQL), view, create, update, transition, delete
+- **Confluence** — Pages: search (space-scoped or full CQL), read, create (from content or template), copy, update, delete; plus comments, labels, attachments, and child pages
+- **Jira** — Issues: search (JQL), view, create (with subtask support), update, transition, delete; plus comments, attachments, issue links, work logs, epics, boards, sprints, and user search
 - **Shared auth** — One set of credentials (`ATLASSIAN_URL`, `ATLASSIAN_EMAIL`, `ATLASSIAN_TOKEN`) for all products
 - **CLI** — `atlassian` command with product subcommands, interactive confirmations, coloured output
 - **MCP server** — Expose all operations as tools for AI agents (Claude Code, etc.)
@@ -38,30 +38,70 @@ Generate an API token at https://id.atlassian.com/manage-profile/security/api-to
 
 ## CLI usage
 
+All write/delete commands prompt for confirmation. Pass `-y` to skip (useful in scripts).
+
 ### Confluence
 
 ```bash
 # Verify connection
 atlassian confluence auth
 
-# List spaces
+# Spaces
 atlassian confluence spaces
+atlassian confluence spaces --limit 50
 
 # Read a page
 atlassian confluence read 12345678
 atlassian confluence read 12345678 --json
 
 # Search pages in a space
+atlassian confluence search -s DEV
 atlassian confluence search -s DEV -t "Architecture"
 
+# CQL search — full-text across all spaces, label filters, date ranges, etc.
+atlassian confluence cql 'type=page AND text ~ "kubernetes"'
+atlassian confluence cql 'type=page AND label = "approved" AND space.key = "DEV"'
+atlassian confluence cql 'type=page AND lastModified > "2024-01-01"' --limit 10
+
+# List child pages
+atlassian confluence children 12345678
+
+# List available templates
+atlassian confluence templates
+atlassian confluence templates -s DEV
+
 # Create a page (prompts for confirmation)
 atlassian confluence create -s DEV -t "New RFC" -f proposal.md
+atlassian confluence create -s DEV -t "New RFC" -f proposal.md --parent 87654321
+atlassian confluence create -s DEV -t "Draft" -f draft.md --draft
+# Create from a template
+atlassian confluence create -s DEV -t "Q3 Retro" --template "Retrospective"
+atlassian confluence create -s DEV -t "Meeting" --template "Meeting Notes" --parent 87654321
 
 # Update a page
 atlassian confluence update 12345678 -f updated.md -m "Revised section 3"
+atlassian confluence update 12345678 -t "New Title"
+
+# Copy a page
+atlassian confluence copy 12345678 -t "Copy of RFC" -d 87654321
+atlassian confluence copy 12345678 -t "Copy of RFC" -d 87654321 --attachments --labels
 
 # Delete a page
 atlassian confluence delete 12345678
+
+# Comments
+atlassian confluence comments 12345678
+atlassian confluence comment 12345678 -t "Looks good, approved."
+
+# Labels
+atlassian confluence labels 12345678
+atlassian confluence add-label 12345678 rfc approved
+atlassian confluence remove-label 12345678 rfc
+
+# Attachments
+atlassian confluence attachments 12345678
+atlassian confluence attach 12345678 /path/to/screenshot.png
+atlassian confluence attach 12345678 /path/to/diagram.pdf -c "Architecture diagram v2"
 ```
 
 ### Jira
@@ -70,12 +110,14 @@ atlassian confluence delete 12345678
 # Verify connection
 atlassian jira auth
 
-# List projects
+# Projects
 atlassian jira projects
+atlassian jira projects --limit 50
 
 # Search issues
 atlassian jira list --project CARD --status "In Progress"
 atlassian jira list --jql 'assignee = currentUser() AND status != Done'
+atlassian jira list --type Bug --limit 10
 
 # View an issue
 atlassian jira view CARD-42
@@ -83,19 +125,53 @@ atlassian jira view CARD-42 --json
 
 # Create an issue (prompts for confirmation)
 atlassian jira create --project CARD --type Bug --summary "Fix login"
+atlassian jira create --project CARD --type Task --summary "Set up CI" --priority High
+# Create a subtask
+atlassian jira create --project CARD --type Subtask --summary "Write tests" --parent CARD-42
 
 # Update an issue
 atlassian jira update CARD-42 --priority High --summary "Fix login regression"
+atlassian jira update CARD-42 --labels "critical,frontend"
 
 # Transition an issue
+atlassian jira transition CARD-42 --list          # show available transitions
 atlassian jira transition CARD-42 --to "In Progress"
-atlassian jira transition CARD-42 --list   # show available transitions
 
 # Delete an issue
 atlassian jira delete CARD-42
-```
 
-All write/delete commands prompt for confirmation. Pass `-y` to skip (useful in scripts).
+# Comments
+atlassian jira comments CARD-42
+atlassian jira comment CARD-42 -t "Blocked on CARD-10, see discussion."
+
+# Issue links
+atlassian jira link-types                         # show available link types
+atlassian jira links CARD-42                      # list links on an issue
+atlassian jira link CARD-42 --type "Blocks" --target CARD-99
+atlassian jira link CARD-42 --type "Relates to" --target CARD-7
+
+# Work logs
+atlassian jira worklogs CARD-42
+atlassian jira log CARD-42 --time "2h 30m"
+atlassian jira log CARD-42 --time "1d" --comment "Implemented auth flow"
+
+# Attachments
+atlassian jira attachments CARD-42
+atlassian jira attach CARD-42 /path/to/screenshot.png
+
+# User search (find accountIds for assignee)
+atlassian jira users "Jane Smith"
+atlassian jira users "jane@"
+
+# Epics
+atlassian jira epic CARD-5                        # list all issues in an epic
+
+# Boards & sprints
+atlassian jira boards
+atlassian jira sprints 42                         # list sprints on board 42
+atlassian jira sprints 42 --state active
+atlassian jira move-to-sprint 10 CARD-42 CARD-43  # move issues to sprint 10
+```
 
 ## MCP server usage
 
@@ -138,28 +214,54 @@ Or without a global install:
 
 #### Confluence
 
-| Tool                       | Description                          | Confirmation needed |
-|----------------------------|--------------------------------------|---------------------|
-| `confluence_auth`          | Verify connection                    | No                  |
-| `confluence_list_spaces`   | List spaces                          | No                  |
-| `confluence_read_page`     | Read page content by ID              | No                  |
-| `confluence_search_pages`  | Search by space key and title        | No                  |
-| `confluence_create_page`   | Create a new page                    | **Yes**             |
-| `confluence_update_page`   | Update an existing page              | **Yes**             |
-| `confluence_delete_page`   | Delete a page                        | **Yes**             |
+| Tool                              | Description                                 | Confirmation needed |
+|-----------------------------------|---------------------------------------------|---------------------|
+| `confluence_auth`                 | Verify connection                           | No                  |
+| `confluence_list_spaces`          | List spaces                                 | No                  |
+| `confluence_read_page`            | Read page content by ID                     | No                  |
+| `confluence_search_pages`         | Search by space key and title               | No                  |
+| `confluence_search_cql`           | Full-text CQL search across all spaces      | No                  |
+| `confluence_list_templates`       | List page templates for a space or globally | No                  |
+| `confluence_list_child_pages`     | List child pages of a page                  | No                  |
+| `confluence_create_page`          | Create a new page (supports `templateName`) | **Yes**             |
+| `confluence_copy_page`            | Copy a page to a new location               | **Yes**             |
+| `confluence_update_page`          | Update an existing page                     | **Yes**             |
+| `confluence_delete_page`          | Delete a page                               | **Yes**             |
+| `confluence_list_comments`        | List comments on a page                     | No                  |
+| `confluence_add_comment`          | Add a comment to a page                     | **Yes**             |
+| `confluence_list_labels`          | List labels on a page                       | No                  |
+| `confluence_add_labels`           | Add labels to a page                        | **Yes**             |
+| `confluence_remove_label`         | Remove a label from a page                  | **Yes**             |
+| `confluence_list_attachments`     | List attachments on a page                  | No                  |
+| `confluence_upload_attachment`    | Upload a file as an attachment to a page    | **Yes**             |
 
 #### Jira
 
-| Tool                       | Description                          | Confirmation needed |
-|----------------------------|--------------------------------------|---------------------|
-| `jira_auth`                | Verify connection                    | No                  |
-| `jira_list_projects`       | List projects                        | No                  |
-| `jira_get_issue`           | Get issue details by key             | No                  |
-| `jira_search_issues`       | Search with JQL or filters           | No                  |
-| `jira_create_issue`        | Create a new issue                   | **Yes**             |
-| `jira_update_issue`        | Update an existing issue             | **Yes**             |
-| `jira_transition_issue`    | Transition issue status              | **Yes**             |
-| `jira_delete_issue`        | Delete an issue                      | **Yes**             |
+| Tool                              | Description                                 | Confirmation needed |
+|-----------------------------------|---------------------------------------------|---------------------|
+| `jira_auth`                       | Verify connection                           | No                  |
+| `jira_list_projects`              | List projects                               | No                  |
+| `jira_get_issue`                  | Get issue details by key                    | No                  |
+| `jira_search_issues`              | Search with JQL or filters                  | No                  |
+| `jira_create_issue`               | Create a new issue (supports `parentKey` for subtasks) | **Yes** |
+| `jira_update_issue`               | Update an existing issue                    | **Yes**             |
+| `jira_transition_issue`           | Transition issue status                     | **Yes**             |
+| `jira_delete_issue`               | Delete an issue                             | **Yes**             |
+| `jira_list_comments`              | List comments on an issue                   | No                  |
+| `jira_add_comment`                | Add a comment to an issue                   | **Yes**             |
+| `jira_list_link_types`            | List available issue link types             | No                  |
+| `jira_list_issue_links`           | List links on an issue                      | No                  |
+| `jira_link_issues`                | Link two issues together                    | **Yes**             |
+| `jira_remove_issue_link`          | Remove a link between two issues            | **Yes**             |
+| `jira_list_worklogs`              | List work log entries on an issue           | No                  |
+| `jira_log_work`                   | Log time worked on an issue                 | **Yes**             |
+| `jira_list_attachments`           | List attachments on an issue                | No                  |
+| `jira_upload_attachment`          | Upload a file as an attachment to an issue  | **Yes**             |
+| `jira_search_users`               | Search users by name or email (for accountIds) | No               |
+| `jira_list_epic_issues`           | List all issues in an epic                  | No                  |
+| `jira_list_boards`                | List Scrum and Kanban boards                | No                  |
+| `jira_list_sprints`               | List sprints on a board                     | No                  |
+| `jira_move_to_sprint`             | Move issues to a sprint                     | **Yes**             |
 
 ## Project structure
 
@@ -177,6 +279,7 @@ src/
 │   └── index.ts    # Barrel export
 ├── jira/           # Jira-specific client + types
 │   ├── client.ts   # Jira REST API v3 client
+│   ├── helpers.ts  # ADF conversion + JQL builder
 │   ├── types.ts    # Jira interfaces
 │   └── index.ts    # Barrel export
 ├── cli/            # Commander.js with product subcommands
@@ -199,8 +302,35 @@ const config = loadConfigFromEnv();
 const confluence = new ConfluenceClient(config);
 const jira = new JiraClient(config);
 
+// Pages
 const pages = await confluence.searchPages({ spaceKey: "DEV", title: "RFC" });
+const results = await confluence.searchCQL('type=page AND text ~ "kubernetes"');
+const children = await confluence.listChildPages("12345678");
+const templates = await confluence.listTemplates("DEV");
+const copy = await confluence.copyPage({ pageId: "12345678", title: "Copy of RFC", destinationPageId: "87654321" });
+
+// Comments & labels
+await confluence.addComment("12345678", "<p>Approved.</p>");
+await confluence.addLabels("12345678", ["approved", "published"]);
+
+// Attachments
+await confluence.uploadAttachment({ pageId: "12345678", filePath: "/tmp/diagram.png" });
+
+// Jira issues
 const issues = await jira.searchIssues({ project: "CARD", status: "In Progress" });
+const epicIssues = await jira.listEpicIssues("CARD-5");
+await jira.addComment("CARD-42", "Blocked on infra, see CARD-10.");
+await jira.linkIssues("CARD-42", "Blocks", "CARD-99");
+await jira.addWorklog({ issueKey: "CARD-42", timeSpent: "2h", comment: "Auth implementation" });
+await jira.uploadAttachment({ issueKey: "CARD-42", filePath: "/tmp/screenshot.png" });
+
+// Boards & sprints
+const boards = await jira.listBoards();
+const sprints = await jira.listSprints(boards[0].id, "active");
+await jira.moveToSprint(sprints[0].id, ["CARD-42", "CARD-43"]);
+
+// User search
+const users = await jira.searchUsers("Jane Smith");
 ```
 
 ## Development

package/dist/cli/confluence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confluence.d.ts","sourceRoot":"","sources":["../../src/cli/confluence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,QAuM1D"}
+{"version":3,"file":"confluence.d.ts","sourceRoot":"","sources":["../../src/cli/confluence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,QA6lB1D"}