@aaronshaf/confluence-cli 1.0.1 → 1.0.4

package/README.md

@@ -47,6 +47,7 @@ cn spaces
 | `cn comments <id\|file>` | Show page comments |
 | `cn labels <id\|file>` | Manage page labels |
 | `cn move <id\|file> <parentId>` | Move a page to a new parent |
+| `cn read <id\|file>` | Read and display page content |
 | `cn attachments <id\|file>` | Manage page attachments |
 | `cn folder <subcommand>` | Manage folders (create, list, delete, move) |
 | `cn clone <SPACE_KEY>` | Clone a space to a new folder |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aaronshaf/confluence-cli",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "Confluence CLI for syncing spaces and local markdown files",
   "type": "module",
   "bin": {

package/src/cli/commands/read.ts

@@ -0,0 +1,53 @@
+import chalk from 'chalk';
+import { ConfluenceClient } from '../../lib/confluence-client/index.js';
+import { ConfigManager } from '../../lib/config.js';
+import { EXIT_CODES } from '../../lib/errors.js';
+import { escapeXml } from '../../lib/formatters.js';
+import { MarkdownConverter } from '../../lib/markdown/index.js';
+import { resolvePageTarget } from '../../lib/resolve-page-target.js';
+
+export interface ReadCommandOptions {
+  xml?: boolean;
+  html?: boolean;
+}
+
+export async function readCommand(target: string, options: ReadCommandOptions = {}): Promise<void> {
+  const configManager = new ConfigManager();
+  const config = await configManager.getConfig();
+
+  if (!config) {
+    console.error(chalk.red('Not configured. Run: cn setup'));
+    process.exit(EXIT_CODES.CONFIG_ERROR);
+  }
+
+  if (options.xml && options.html) {
+    console.error(chalk.red('Cannot use --xml and --html together.'));
+    process.exit(EXIT_CODES.INVALID_ARGUMENTS);
+  }
+
+  const pageId = resolvePageTarget(target);
+  const client = new ConfluenceClient(config);
+  const page = await client.getPage(pageId, true);
+
+  const storageHtml = page.body?.storage?.value || '';
+
+  if (options.xml) {
+    const converter = new MarkdownConverter();
+    const markdown = converter.convert(storageHtml);
+    console.log('<page>');
+    console.log(`  <id>${escapeXml(page.id)}</id>`);
+    console.log(`  <title>${escapeXml(page.title)}</title>`);
+    console.log(`  <content>${escapeXml(markdown)}</content>`);
+    console.log('</page>');
+    return;
+  }
+
+  if (options.html) {
+    console.log(storageHtml);
+    return;
+  }
+
+  const converter = new MarkdownConverter();
+  const markdown = converter.convert(storageHtml);
+  console.log(markdown);
+}

package/src/cli/help.ts

@@ -171,8 +171,16 @@ ${chalk.yellow('Usage:')}
   cn spaces [options]
 
 ${chalk.yellow('Options:')}
+  --limit <n>               Number of spaces per page (default: 25)
+  --page <n>                Page number for pagination
   --xml                     Output in XML format
   --help                    Show this help message
+
+${chalk.yellow('Examples:')}
+  cn spaces                 List first 25 spaces
+  cn spaces --limit 50      List 50 spaces
+  cn spaces --page 2        Show second page of results
+  cn spaces --page 2 --limit 10  Custom page size
 `);
 }
 
@@ -214,6 +222,29 @@ ${chalk.yellow('Options:')}
 `);
 }
 
+export function showReadHelp(): void {
+  console.log(`
+${chalk.bold('cn read - Read and display page content')}
+
+${chalk.yellow('Usage:')}
+  cn read <id|file> [options]
+
+${chalk.yellow('Arguments:')}
+  id|file                   Page ID or path to local .md file
+
+${chalk.yellow('Options:')}
+  --xml                     Output in XML format
+  --html                    Output raw Confluence storage format HTML
+  --help                    Show this help message
+
+${chalk.yellow('Examples:')}
+  cn read 123456            Read page by ID
+  cn read ./docs/page.md    Read page from local file
+  cn read 123456 --xml      Read page in XML format
+  cn read 123456 --html     Read raw HTML storage format
+`);
+}
+
 export function showCreateHelp(): void {
   console.log(`
 ${chalk.bold('cn create - Create a new Confluence page')}
@@ -419,6 +450,7 @@ ${chalk.yellow('Commands:')}
   cn search                 Search pages using CQL
   cn spaces                 List available spaces
   cn info                   Show page info and labels
+  cn read                   Read and display page content
   cn create                 Create a new page
   cn update                 Update an existing page
   cn delete                 Delete a page

package/src/cli/index.ts

@@ -13,6 +13,7 @@ import {
   showDoctorHelp,
   showHelp,
   showInfoHelp,
+  showReadHelp,
   showLabelsHelp,
   showMoveHelp,
   showOpenHelp,
@@ -37,6 +38,7 @@ import { moveCommand } from './commands/move.js';
 import { openCommand } from './commands/open.js';
 import { folderCommand } from './commands/folder.js';
 import { pullCommand } from './commands/pull.js';
+import { readCommand } from './commands/read.js';
 import { searchCommand } from './commands/search.js';
 import { setup } from './commands/setup.js';
 import { spacesCommand } from './commands/spaces.js';
@@ -276,6 +278,21 @@ async function main(): Promise<void> {
         break;
       }
 
+      case 'read': {
+        if (args.includes('--help')) {
+          showReadHelp();
+          process.exit(EXIT_CODES.SUCCESS);
+        }
+        const target = subArgs.find((arg) => !arg.startsWith('--'));
+        if (!target) {
+          console.error(chalk.red('Page ID or file path is required.'));
+          console.log(chalk.gray('Usage: cn read <id|file>'));
+          process.exit(EXIT_CODES.INVALID_ARGUMENTS);
+        }
+        await readCommand(target, { xml: args.includes('--xml'), html: args.includes('--html') });
+        break;
+      }
+
       case 'create': {
         if (args.includes('--help')) {
           showCreateHelp();