jira-ai 0.6.5 → 0.6.7

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 } from './commands/confluence.js';
+import { confluenceGetPageCommand, confluenceListSpacesCommand, confluenceGetSpacePagesHierarchyCommand, confluenceAddCommentCommand, confluenceCreatePageCommand } from './commands/confluence.js';
 import { aboutCommand } from './commands/about.js';
 import { authCommand } from './commands/auth.js';
 import { settingsCommand } from './commands/settings.js';
@@ -30,7 +30,7 @@ import { checkForUpdate, formatUpdateMessage, checkForUpdateSync } from './lib/u
 import { CliError } from './types/errors.js';
 import { CommandError } from './lib/errors.js';
 import { ui } from './lib/ui.js';
-import { CreateTaskSchema, AddCommentSchema, UpdateDescriptionSchema, RunJqlSchema, GetPersonWorklogSchema, GetIssueStatisticsSchema, validateOptions, IssueKeySchema, ProjectKeySchema, TimeframeSchema } from './lib/validation.js';
+import { CreateTaskSchema, AddCommentSchema, UpdateDescriptionSchema, ConfluenceAddCommentSchema, RunJqlSchema, GetPersonWorklogSchema, GetIssueStatisticsSchema, validateOptions, IssueKeySchema, ProjectKeySchema, TimeframeSchema } from './lib/validation.js';
 import { realpathSync } from 'fs';
 // Load environment variables
 // @ts-ignore - quiet option exists but is not in types
@@ -263,6 +263,15 @@ confl
     .command('pages <space-key>')
     .description('Display a hierarchical tree view of pages within a specific space.')
     .action(withPermission('confl', confluenceGetSpacePagesHierarchyCommand, { skipValidation: false }));
+confl
+    .command('create-page <space> <title> [parent-page]')
+    .description('Create a new Confluence page')
+    .action(withPermission('confl', confluenceCreatePageCommand, { skipValidation: false }));
+confl
+    .command('add-comment <url>')
+    .description('Add a new comment to a Confluence page using content from a local Markdown file.')
+    .requiredOption('--from-file <path>', 'Path to Markdown file')
+    .action(withPermission('confl', confluenceAddCommentCommand, { schema: ConfluenceAddCommentSchema }));
 // About command (always allowed)
 program
     .command('about')

package/dist/commands/confluence.js

@@ -1,9 +1,98 @@
 import chalk from 'chalk';
-import { getPage, getPageComments, parseConfluenceUrl, listSpaces, getSpacePagesHierarchy } from '../lib/confluence-client.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import { markdownToAdf } from 'marklassian';
+import { getPage, getPageComments, parseConfluenceUrl, listSpaces, getSpacePagesHierarchy, addPageComment, createPage } 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
+    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;
+        // URL parsing errors will be caught during addPageComment
+    }
+    // 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('Adding comment to Confluence page...');
+    try {
+        await addPageComment(url, adfContent);
+        ui.succeedSpinner(chalk.green('Comment added successfully to Confluence page'));
+        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 comment on this page.');
+        }
+        throw new CommandError(`Failed to add comment: ${error.message}`, { hints });
+    }
+}
 export async function confluenceGetPageCommand(url) {
     // Check permission before fetching if space key can be extracted from URL
     try {

package/dist/lib/confluence-client.js

@@ -182,3 +182,46 @@ export async function getSpacePagesHierarchy(spaceKey, maxDepth = 5) {
     }
     return hierarchy;
 }
+/**
+ * Add a comment to a Confluence page
+ */
+export async function addPageComment(url, adfContent) {
+    const client = getConfluenceClient();
+    const { pageId } = parseConfluenceUrl(url);
+    // @ts-ignore - CreateContent type requires title and space which are not needed for comments
+    await client.content.createContent({
+        type: 'comment',
+        container: { id: pageId, type: 'page' },
+        body: {
+            atlas_doc_format: {
+                value: JSON.stringify(adfContent),
+                representation: 'atlas_doc_format'
+            }
+        }
+    });
+}
+/**
+ * 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}`;
+}

package/dist/lib/validation.js

@@ -62,6 +62,9 @@ export const AddCommentSchema = z.object({
     filePath: z.string().trim().min(1, 'File path is required').pipe(FilePathSchema),
     issueKey: z.string().trim().min(1, 'Issue key is required').pipe(IssueKeySchema),
 });
+export const ConfluenceAddCommentSchema = z.object({
+    fromFile: z.string().trim().min(1, 'File path is required').pipe(FilePathSchema),
+});
 export const UpdateDescriptionSchema = z.object({
     fromFile: z.string().trim().min(1, 'File path is required').pipe(FilePathSchema),
 });

package/package.json

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