jira-ai 0.6.6 → 0.6.8

package/dist/cli.js

@@ -18,7 +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, confluenceListSpacesCommand, confluenceGetSpacePagesHierarchyCommand, confluenceAddCommentCommand } from './commands/confluence.js';
+import { confluenceGetPageCommand, confluenceListSpacesCommand, confluenceGetSpacePagesHierarchyCommand, confluenceAddCommentCommand, confluenceCreatePageCommand, confluenceUpdateDescriptionCommand } from './commands/confluence.js';
 import { aboutCommand } from './commands/about.js';
 import { authCommand } from './commands/auth.js';
 import { settingsCommand } from './commands/settings.js';
@@ -264,10 +264,21 @@ confl
     .description('Display a hierarchical tree view of pages within a specific space.')
     .action(withPermission('confl', confluenceGetSpacePagesHierarchyCommand, { skipValidation: false }));
 confl
-    .command('add-comment <url>')
+    .command('create-page <space> <title> [parent-page]')
+    .description('Create a new Confluence page')
+    .action(withPermission('confl', confluenceCreatePageCommand, { skipValidation: false }));
+confl
+    .command('add-comment')
+    .argument('<url>', 'The full URL of the Confluence page.')
     .description('Add a new comment to a Confluence page using content from a local Markdown file.')
-    .requiredOption('--from-file <path>', 'Path to Markdown file')
+    .option('-f, --from-file <path>', 'Path to the markdown file containing the comment content.')
     .action(withPermission('confl', confluenceAddCommentCommand, { schema: ConfluenceAddCommentSchema }));
+confl
+    .command('update-description')
+    .argument('<url>', 'The full URL of the Confluence page.')
+    .description('Update the content of an existing Confluence page using a Markdown file.')
+    .option('-f, --from-file <path>', 'Path to the markdown file containing the new content.')
+    .action(withPermission('confl', confluenceUpdateDescriptionCommand, { schema: UpdateDescriptionSchema }));
 // About command (always allowed)
 program
     .command('about')

package/dist/commands/confluence.js

@@ -2,11 +2,37 @@ import chalk from 'chalk';
 import * as fs from 'fs';
 import * as path from 'path';
 import { markdownToAdf } from 'marklassian';
-import { getPage, getPageComments, parseConfluenceUrl, listSpaces, getSpacePagesHierarchy, addPageComment } from '../lib/confluence-client.js';
+import { getPage, getPageComments, parseConfluenceUrl, listSpaces, getSpacePagesHierarchy, addPageComment, createPage, updatePageContent } from '../lib/confluence-client.js';
 import { formatConfluencePage, formatConfluenceSpaces, formatConfluencePageHierarchy } from '../lib/formatters.js';
 import { ui } from '../lib/ui.js';
 import { CommandError } from '../lib/errors.js';
 import { isConfluenceSpaceAllowed } from '../lib/settings.js';
+export async function confluenceCreatePageCommand(space, title, parentPage) {
+    // Validate space key
+    if (!isConfluenceSpaceAllowed(space)) {
+        throw new CommandError(`Access to Confluence space '${space}' is restricted by your settings.`);
+    }
+    ui.startSpinner(`Creating Confluence page '${title}' in space '${space}'...`);
+    try {
+        const url = await createPage(space, title, parentPage);
+        ui.succeedSpinner(chalk.green('Confluence page created successfully'));
+        console.log(chalk.cyan(`\nURL: ${url}`));
+    }
+    catch (error) {
+        ui.failSpinner();
+        if (error instanceof CommandError)
+            throw error;
+        const errorMsg = error.message?.toLowerCase() || '';
+        const hints = [];
+        if (errorMsg.includes('401') || errorMsg.includes('403') || errorMsg.includes('unauthorized')) {
+            hints.push('Authentication failed or you do not have permission to create pages in this space.');
+        }
+        else if (errorMsg.includes('404')) {
+            hints.push('Space or parent page not found.');
+        }
+        throw new CommandError(`Failed to create Confluence page: ${error.message}`, { hints });
+    }
+}
 export async function confluenceAddCommentCommand(url, options) {
     const { fromFile } = options;
     // Validate space key before proceeding
@@ -151,3 +177,62 @@ export async function confluenceGetSpacePagesHierarchyCommand(spaceKey) {
         throw new CommandError(`Failed to fetch page hierarchy: ${error.message}`);
     }
 }
+export async function confluenceUpdateDescriptionCommand(url, options) {
+    const { fromFile } = options;
+    // Validate space key before proceeding
+    try {
+        const { spaceKey } = parseConfluenceUrl(url);
+        if (spaceKey && !isConfluenceSpaceAllowed(spaceKey)) {
+            throw new CommandError(`Access to Confluence space '${spaceKey}' is restricted by your settings.`);
+        }
+    }
+    catch (e) {
+        if (e instanceof CommandError)
+            throw e;
+    }
+    // Resolve and read file
+    const absolutePath = path.resolve(fromFile);
+    let markdownContent;
+    try {
+        markdownContent = fs.readFileSync(absolutePath, 'utf-8');
+    }
+    catch (error) {
+        throw new CommandError(`Error reading file: ${error.message}`, {
+            hints: ['Make sure the file exists and you have permission to read it.']
+        });
+    }
+    if (markdownContent.trim() === '') {
+        throw new CommandError('Markdown file is empty');
+    }
+    // Convert Markdown to ADF
+    let adfContent;
+    try {
+        adfContent = markdownToAdf(markdownContent);
+    }
+    catch (error) {
+        throw new CommandError(`Error converting Markdown to ADF: ${error.message}`, {
+            hints: ['Ensure the Markdown content is valid.']
+        });
+    }
+    ui.startSpinner('Updating Confluence page content...');
+    try {
+        await updatePageContent(url, adfContent);
+        ui.succeedSpinner(chalk.green('Confluence page content updated successfully'));
+        console.log(chalk.gray(`\nPage: ${url}`));
+        console.log(chalk.gray(`File: ${absolutePath}`));
+    }
+    catch (error) {
+        ui.failSpinner();
+        if (error instanceof CommandError)
+            throw error;
+        const errorMsg = error.message?.toLowerCase() || '';
+        const hints = [];
+        if (errorMsg.includes('404') || errorMsg.includes('not found')) {
+            hints.push('The Confluence page was not found. Check if the URL is correct.');
+        }
+        else if (errorMsg.includes('401') || errorMsg.includes('403') || errorMsg.includes('unauthorized')) {
+            hints.push('Authentication failed or you do not have permission to update this page.');
+        }
+        throw new CommandError(`Failed to update Confluence page: ${error.message}`, { hints });
+    }
+}

package/dist/lib/confluence-client.js

@@ -1,6 +1,7 @@
 import { ConfluenceClient } from 'confluence.js';
 import { loadCredentials, getCurrentOrganizationAlias, setOrganizationOverride as setAuthOrgOverride } from './auth-storage.js';
 import { convertADFToMarkdown } from './utils.js';
+import { CommandError } from './errors.js';
 let confluenceClient = null;
 /**
  * Set a global organization override for the current execution
@@ -200,3 +201,71 @@ export async function addPageComment(url, adfContent) {
         }
     });
 }
+/**
+ * Create a new Confluence page
+ */
+export async function createPage(spaceKey, title, parentId) {
+    const client = getConfluenceClient();
+    const response = await client.content.createContent({
+        type: 'page',
+        title,
+        space: { key: spaceKey },
+        ancestors: parentId ? [{ id: parentId }] : undefined,
+        body: {
+            atlas_doc_format: {
+                value: JSON.stringify({
+                    type: 'doc',
+                    version: 1,
+                    content: []
+                }),
+                representation: 'atlas_doc_format'
+            }
+        }
+    });
+    // @ts-ignore - accessing host to construct URL
+    const host = client.config.host || '';
+    return `${host.replace(/\/$/, '')}/pages/${response.id}`;
+}
+/**
+ * Update the content of an existing Confluence page
+ */
+export async function updatePageContent(url, adfContent) {
+    const client = getConfluenceClient();
+    const { pageId } = parseConfluenceUrl(url);
+    // 1. Fetch current page details to get version and title
+    let page;
+    try {
+        page = await client.content.getContentById({
+            id: pageId,
+            expand: ['version', 'space'],
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch page details: ${error.message}`);
+    }
+    const currentVersion = page.version?.number || 0;
+    const title = page.title;
+    // 2. Update the page content
+    try {
+        await client.content.updateContent({
+            id: pageId,
+            version: { number: currentVersion + 1 },
+            title,
+            type: 'page',
+            body: {
+                atlas_doc_format: {
+                    value: JSON.stringify(adfContent),
+                    representation: 'atlas_doc_format',
+                },
+            },
+        });
+    }
+    catch (error) {
+        if (error.status === 409 || error.message?.includes('409') || error.message?.toLowerCase().includes('conflict')) {
+            throw new CommandError('Version mismatch when updating Confluence page. Someone else might have updated it. Please try again.', {
+                hints: ['Reload the page content and try your update again.']
+            });
+        }
+        throw new Error(`Failed to update page content: ${error.message}`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jira-ai",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "description": "AI friendly Jira CLI to save context",
   "type": "module",
   "main": "dist/cli.js",