jira-ai 0.6.0 → 0.6.1

package/dist/cli.js

@@ -18,6 +18,7 @@ import { createTaskCommand } from './commands/create-task.js';
 import { transitionCommand } from './commands/transition.js';
 import { getIssueStatisticsCommand } from './commands/get-issue-statistics.js';
 import { getPersonWorklogCommand } from './commands/get-person-worklog.js';
+import { confluenceGetPageCommand } from './commands/confluence.js';
 import { aboutCommand } from './commands/about.js';
 import { authCommand } from './commands/auth.js';
 import { settingsCommand } from './commands/settings.js';
@@ -246,6 +247,14 @@ program
         validateOptions(TimeframeSchema, args[1]);
     }
 }));
+// Confluence commands
+const confl = program
+    .command('confl')
+    .description('Interact with Confluence pages and content');
+confl
+    .command('get-page <url>')
+    .description('Download and display Confluence page content and comments from a given URL.')
+    .action(withPermission('confl', confluenceGetPageCommand, { skipValidation: false }));
 // About command (always allowed)
 program
     .command('about')

package/dist/commands/confluence.js

@@ -0,0 +1,22 @@
+import chalk from 'chalk';
+import { getPage, getPageComments } from '../lib/confluence-client.js';
+import { formatConfluencePage } from '../lib/formatters.js';
+import { ui } from '../lib/ui.js';
+export async function confluenceGetPageCommand(url) {
+    ui.startSpinner(`Fetching Confluence page details for: ${url}`);
+    try {
+        const [page, comments] = await Promise.all([
+            getPage(url),
+            getPageComments(url)
+        ]);
+        ui.succeedSpinner(chalk.green('Confluence page details retrieved'));
+        console.log(formatConfluencePage(page, comments));
+    }
+    catch (error) {
+        ui.failSpinner();
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new Error('An unknown error occurred while fetching Confluence page');
+    }
+}

package/dist/lib/confluence-client.js

@@ -0,0 +1,125 @@
+import { ConfluenceClient } from 'confluence.js';
+import { loadCredentials } from './auth-storage.js';
+import { convertADFToMarkdown } from './utils.js';
+let confluenceClient = null;
+let organizationOverride = undefined;
+/**
+ * Set a global organization override for the current execution
+ */
+export function setOrganizationOverride(alias) {
+    organizationOverride = alias;
+    confluenceClient = null; // Force client recreation
+}
+/**
+ * Get or create Confluence client instance
+ */
+export function getConfluenceClient() {
+    if (!confluenceClient) {
+        const host = process.env.JIRA_HOST;
+        const email = process.env.JIRA_USER_EMAIL;
+        const apiToken = process.env.JIRA_API_TOKEN;
+        if (host && email && apiToken) {
+            confluenceClient = new ConfluenceClient({
+                host: host.includes('/wiki') ? host : `${host.replace(/\/$/, '')}/wiki`,
+                authentication: {
+                    basic: {
+                        email,
+                        apiToken,
+                    },
+                },
+            });
+        }
+        else {
+            const storedCreds = loadCredentials(organizationOverride);
+            if (storedCreds) {
+                confluenceClient = new ConfluenceClient({
+                    host: storedCreds.host.includes('/wiki') ? storedCreds.host : `${storedCreds.host.replace(/\/$/, '')}/wiki`,
+                    authentication: {
+                        basic: {
+                            email: storedCreds.email,
+                            apiToken: storedCreds.apiToken,
+                        },
+                    },
+                });
+            }
+            else {
+                const errorMsg = organizationOverride
+                    ? `Credentials for organization "${organizationOverride}" not found.`
+                    : 'Credentials not found. Please set environment variables or run "jira-ai auth"';
+                throw new Error(errorMsg);
+            }
+        }
+    }
+    return confluenceClient;
+}
+/**
+ * Parse Confluence URL to extract page ID
+ */
+export function parseConfluenceUrl(url) {
+    try {
+        const parsedUrl = new URL(url);
+        // Pattern: /wiki/spaces/SPACE/pages/PAGE_ID/TITLE
+        const pagesMatch = parsedUrl.pathname.match(/\/pages\/(\d+)/);
+        if (pagesMatch && pagesMatch[1]) {
+            return pagesMatch[1];
+        }
+        // Pattern: /wiki/pages/viewpage.action?pageId=PAGE_ID
+        const pageIdParam = parsedUrl.searchParams.get('pageId');
+        if (pageIdParam) {
+            return pageIdParam;
+        }
+        throw new Error('Could not extract Page ID from URL');
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Invalid Confluence URL: ${error.message}`);
+        }
+        throw new Error('Invalid Confluence URL');
+    }
+}
+/**
+ * Get Confluence page details
+ */
+export async function getPage(url) {
+    const client = getConfluenceClient();
+    const pageId = parseConfluenceUrl(url);
+    const page = await client.content.getContentById({
+        id: pageId,
+        expand: ['body.atlas_doc_format', 'version', 'space', 'history.lastUpdated'],
+    });
+    const adfBody = page.body?.atlas_doc_format?.value;
+    const content = adfBody ? convertADFToMarkdown(JSON.parse(adfBody)) : 'No content available.';
+    // @ts-ignore - accessing host to show it in UI
+    const host = client.config.host || '';
+    return {
+        id: page.id || '',
+        title: page.title || '',
+        content,
+        space: page.space?.name || page.space?.key || 'Unknown',
+        author: page.history?.createdBy?.displayName || 'Unknown',
+        lastUpdated: page.history?.lastUpdated?.when || page.version?.when || '',
+        url: `${host}/pages/${page.id}`,
+    };
+}
+/**
+ * Get Confluence page comments
+ */
+export async function getPageComments(url) {
+    const client = getConfluenceClient();
+    const pageId = parseConfluenceUrl(url);
+    const response = await client.contentChildrenAndDescendants.getContentChildrenByType({
+        id: pageId,
+        type: 'comment',
+        expand: ['body.atlas_doc_format', 'history.lastUpdated', 'version'],
+    });
+    return (response.results || []).map((comment) => {
+        const adfBody = comment.body?.atlas_doc_format?.value;
+        const body = adfBody ? convertADFToMarkdown(JSON.parse(adfBody)) : 'No content available.';
+        return {
+            id: comment.id,
+            author: comment.history?.createdBy?.displayName || 'Unknown',
+            body,
+            created: comment.history?.createdDate || comment.version?.when || '',
+        };
+    });
+}

package/dist/lib/formatters.js

@@ -514,3 +514,33 @@ export function formatSettings(settings) {
     output += table.toString() + '\n';
     return output;
 }
+/**
+ * Format Confluence page details
+ */
+export function formatConfluencePage(page, comments) {
+    let output = '\n' + chalk.bold.cyan(`Confluence Page: ${decode(page.title)}`) + '\n\n';
+    // Basic info table
+    const infoTable = createTable(['Property', 'Value'], [15, 65]);
+    infoTable.push(['Space', page.space], ['Author', page.author], ['Last Updated', formatTimestamp(page.lastUpdated)], ['URL', page.url]);
+    output += infoTable.toString() + '\n\n';
+    // Content
+    output += chalk.bold('Content:') + '\n';
+    output += chalk.dim('─'.repeat(80)) + '\n';
+    output += decode(page.content) + '\n';
+    output += chalk.dim('─'.repeat(80)) + '\n\n';
+    // Comments
+    if (comments.length > 0) {
+        output += chalk.bold(`Comments (${comments.length}):`) + '\n\n';
+        comments.forEach((comment, index) => {
+            output += chalk.cyan(`${index + 1}. ${comment.author}`) +
+                chalk.gray(` - ${formatTimestamp(comment.created)}`) + '\n';
+            output += chalk.dim('─'.repeat(80)) + '\n';
+            output += decode(comment.body) + '\n';
+            output += chalk.dim('─'.repeat(80)) + '\n\n';
+        });
+    }
+    else {
+        output += chalk.gray('No comments found.\n\n');
+    }
+    return output;
+}

package/dist/lib/settings.js

@@ -23,7 +23,8 @@ export const DEFAULT_SETTINGS = {
         'get-person-worklog',
         'organization',
         'transition',
-        'update-description'
+        'update-description',
+        'confl'
     ]
 };
 const CONFIG_DIR = path.join(os.homedir(), '.jira-ai');

package/dist/lib/validation.js

@@ -95,5 +95,5 @@ export const ProjectSettingSchema = z.union([
 ]);
 export const SettingsSchema = z.object({
     projects: z.array(ProjectSettingSchema).nullish().transform(val => val || ['all']),
-    commands: z.array(z.string()).nullish().transform(val => val || ['me', 'projects', 'task-with-details', 'run-jql', 'list-issue-types', 'project-statuses', 'create-task', 'list-colleagues', 'add-comment', 'add-label-to-issue', 'delete-label-from-issue', 'get-issue-statistics', 'get-person-worklog', 'organization', 'transition', 'update-description']),
+    commands: z.array(z.string()).nullish().transform(val => val || ['me', 'projects', 'task-with-details', 'run-jql', 'list-issue-types', 'project-statuses', 'create-task', 'list-colleagues', 'add-comment', 'add-label-to-issue', 'delete-label-from-issue', 'get-issue-statistics', 'get-person-worklog', 'organization', 'transition', 'update-description', 'confl']),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jira-ai",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "AI friendly Jira CLI to save context",
   "type": "module",
   "main": "dist/cli.js",
@@ -52,6 +52,7 @@
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^11.0.0",
+    "confluence.js": "^2.1.0",
     "dotenv": "^17.2.3",
     "html-entities": "^2.6.0",
     "inquirer": "^9.3.8",