confluence-exporter 1.0.0

package/dist/commands/download.command.js

@@ -0,0 +1,257 @@
+/**
+ * Download command handler - Downloads HTML pages from _queue.yaml
+ */
+import { ConfluenceApi } from '../api.js';
+import path, { join } from 'path';
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'fs';
+import { parse, stringify } from 'yaml';
+import { format } from 'prettier';
+import { updateIndexEntry, readIndexEntry } from '../utils.js';
+export class DownloadCommand {
+    config;
+    name = 'download';
+    description = 'Download HTML pages from Confluence';
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(context) {
+        const api = new ConfluenceApi(this.config);
+        // Single page mode
+        if (this.config.pageId) {
+            console.log(`\n📄 Downloading single page: ${this.config.pageId}\n`);
+            // Check if page needs downloading
+            const indexPath = join(this.config.outputDir, '_index.yaml');
+            const indexEntry = readIndexEntry(indexPath, this.config.pageId);
+            if (indexEntry && indexEntry.downloadedVersion !== undefined && indexEntry.downloadedAt) {
+                // Check if we have current version info
+                const currentVersion = indexEntry.version ?? 0;
+                const downloadedVersion = indexEntry.downloadedVersion;
+                if (currentVersion === downloadedVersion) {
+                    console.log(`⏭️  Page ${this.config.pageId} is up-to-date (v${downloadedVersion}), skipping download`);
+                    console.log('\n✅ Download complete!\n');
+                    return;
+                }
+                else {
+                    console.log(`📥 Updating page ${this.config.pageId} from v${downloadedVersion} to v${currentVersion}`);
+                }
+            }
+            else {
+                console.log(`📥 Downloading new page ${this.config.pageId}`);
+            }
+            await this.downloadPage(api, this.config.pageId);
+            console.log('\n✅ Download complete!\n');
+            return;
+        }
+        // Queue mode - check for tree first, then fallback to queue
+        const treeFile = join(this.config.outputDir, '_tree.yaml');
+        const queueFile = join(this.config.outputDir, '_queue.yaml');
+        console.log(`\n🔍 Checking for tree file: ${treeFile}`);
+        console.log(`🔍 Checking for queue file: ${queueFile}\n`);
+        const hasTree = existsSync(treeFile);
+        const hasQueue = existsSync(queueFile);
+        if (!hasTree || !hasQueue) {
+            throw new Error(`❌ Tree or queue file not found. Run 'plan' command first to create the tree and queue.`);
+        }
+        // Read queue
+        const queueContent = readFileSync(queueFile, 'utf-8');
+        const queue = parse(queueContent);
+        console.log(`📊 Queue contains ${queue.length} pages\n`);
+        // Apply limit if specified
+        const pagesToProcess = this.config.limit ? queue.slice(0, this.config.limit) : queue;
+        await this.downloadFromQueueWithHierarchy(api, this.config, pagesToProcess);
+    }
+    async downloadFromQueueWithHierarchy(api, config, queue) {
+        const treeFile = join(config.outputDir, '_tree.yaml');
+        const treeContent = readFileSync(treeFile, 'utf-8');
+        const tree = parse(treeContent);
+        // Build a map of pageId -> path
+        const pagePathMap = new Map();
+        const buildPathMap = (node, currentPath) => {
+            // Store the path for this page
+            pagePathMap.set(node.id, currentPath);
+            // If node has children, build paths for them too
+            if (node.children && node.children.length > 0) {
+                const slug = this.slugify(node.title);
+                const childDir = join(currentPath, `${node.id}-${slug}`);
+                for (const child of node.children) {
+                    buildPathMap(child, childDir);
+                }
+            }
+        };
+        // Create root folder for space
+        const rootDir = join(config.outputDir, config.spaceKey);
+        mkdirSync(rootDir, { recursive: true });
+        // Build the path map from tree
+        for (const node of tree) {
+            buildPathMap(node, rootDir);
+        }
+        // Display first page path as tree
+        const firstPagePath = pagePathMap.get(queue[0].id);
+        if (firstPagePath) {
+            this.displayPathAsTree(path.dirname(firstPagePath), rootDir);
+        }
+        // Download pages from queue using the path map in batches
+        const batchSize = config.parallel || 5;
+        for (let batchStart = 0; batchStart < queue.length; batchStart += batchSize) {
+            const batchEnd = Math.min(batchStart + batchSize, queue.length);
+            const batch = queue.slice(batchStart, batchEnd);
+            console.log(`\n📦 Processing batch ${Math.floor(batchStart / batchSize) + 1}/${Math.ceil(queue.length / batchSize)} (${batch.length} pages)`);
+            await this.downloadBatch(api, config, batch, pagePathMap, rootDir);
+        }
+        console.log('\n✅ Download complete!\n');
+    }
+    async downloadBatch(api, config, batch, pagePathMap, rootDir) {
+        const indexPath = join(config.outputDir, '_index.yaml');
+        // Read index once for the entire batch
+        const indexContent = readFileSync(indexPath, 'utf-8');
+        const allIndexEntries = parse(indexContent);
+        const indexMap = new Map(allIndexEntries.map(entry => [entry.id, entry]));
+        // Determine which pages need downloading
+        const pagesToDownload = [];
+        const skippedPages = [];
+        for (const entry of batch) {
+            const pagePath = pagePathMap.get(entry.id) || rootDir;
+            const indexEntry = indexMap.get(entry.id);
+            let skip = false;
+            let skipReason = '';
+            if (indexEntry && indexEntry.downloadedVersion !== undefined && indexEntry.downloadedAt) {
+                // Page has been downloaded before
+                const currentVersion = entry.version ?? 0;
+                const downloadedVersion = indexEntry.downloadedVersion;
+                if (currentVersion === downloadedVersion) {
+                    skip = true;
+                    skipReason = `(⏭️ skipped - up-to-date v${downloadedVersion})`;
+                }
+                else {
+                    skipReason = `(📥 updating v${downloadedVersion} → v${currentVersion})`;
+                }
+            }
+            else {
+                skipReason = `(📥 new download)`;
+            }
+            const filename = `${entry.id}-${this.slugify(entry.title)}.html`;
+            const deep = Math.max(0, pagePath.split(path.sep).length - rootDir.split(path.sep).length - 1);
+            console.log(`${'  '.repeat(deep)}/${filename} ${skipReason}`);
+            if (skip) {
+                skippedPages.push({ entry, pagePath, skipReason });
+            }
+            else {
+                pagesToDownload.push({ entry, pagePath, skipReason });
+            }
+        }
+        // Download pages in parallel
+        if (pagesToDownload.length > 0) {
+            console.log(`\n📥 Downloading ${pagesToDownload.length} pages in parallel...`);
+            const downloadPromises = pagesToDownload.map(async ({ entry, pagePath }) => {
+                try {
+                    // Create directory if it doesn't exist
+                    mkdirSync(pagePath, { recursive: true });
+                    const page = await api.getPage(entry.id);
+                    // Update the index entry in memory
+                    const indexEntry = indexMap.get(entry.id);
+                    if (indexEntry) {
+                        indexEntry.downloadedVersion = page.version ?? 0;
+                        indexEntry.downloadedAt = new Date().toISOString();
+                    }
+                    return { entry, page, pagePath, success: true };
+                }
+                catch (error) {
+                    console.error(`❌ Failed to download page ${entry.id}:`, error);
+                    return { entry, page: null, pagePath, success: false };
+                }
+            });
+            const results = await Promise.all(downloadPromises);
+            // Process successful downloads
+            for (const result of results) {
+                if (result.success && result.page) {
+                    try {
+                        await this.savePageToFile(result.page, result.pagePath);
+                    }
+                    catch (error) {
+                        console.error(`❌ Failed to save page ${result.entry.id}:`, error);
+                    }
+                }
+            }
+        }
+        // Write updated index back to file once for the entire batch
+        if (pagesToDownload.length > 0) {
+            const yamlContent = stringify(allIndexEntries, {
+                indent: 2,
+                lineWidth: 0
+            });
+            writeFileSync(indexPath, yamlContent, 'utf-8');
+            console.log(`💾 Updated index with ${pagesToDownload.length} downloaded pages`);
+        }
+        console.log(`✅ Batch complete: ${pagesToDownload.length} downloaded, ${skippedPages.length} skipped`);
+    }
+    async savePageToFile(page, filePath) {
+        const slug = this.slugify(page.title);
+        const filename = `${page.id}-${slug}.html`;
+        const fullPath = join(filePath, filename);
+        // Format HTML with Prettier
+        let formattedHtml = page.body;
+        try {
+            formattedHtml = await format(page.body, {
+                parser: 'html',
+                printWidth: 120,
+                htmlWhitespaceSensitivity: 'ignore',
+                tabWidth: 2,
+            });
+        }
+        catch {
+            console.warn(`⚠️  Failed to format HTML for ${page.title}, saving unformatted`);
+        }
+        writeFileSync(fullPath, formattedHtml, 'utf-8');
+    }
+    displayPathAsTree(fullPath, rootDir) {
+        // Get relative path from root
+        const relativePath = path.relative(rootDir, fullPath);
+        // Split path into segments
+        const segments = relativePath.split(path.sep).filter(s => s);
+        // Display each segment with proper indentation
+        for (let i = 0; i < segments.length; i++) {
+            const indent = '  '.repeat(i);
+            console.log(`${indent}/${segments[i]}`);
+        }
+    }
+    async downloadPage(api, pageId, outputDir) {
+        const page = await api.getPage(pageId);
+        const slug = this.slugify(page.title);
+        const filename = `${pageId}-${slug}.html`;
+        const dir = outputDir || process.cwd();
+        const filepath = join(dir, filename);
+        // Format HTML with Prettier
+        let formattedHtml = page.body;
+        try {
+            formattedHtml = await format(page.body, {
+                parser: 'html',
+                printWidth: 120,
+                htmlWhitespaceSensitivity: 'ignore',
+                tabWidth: 2,
+            });
+        }
+        catch {
+            console.warn(`⚠️  Failed to format HTML for ${page.title}, saving unformatted`);
+        }
+        writeFileSync(filepath, formattedHtml, 'utf-8');
+        // Update _index.yaml with download metadata
+        const indexPath = join(this.config.outputDir, '_index.yaml');
+        const success = updateIndexEntry(indexPath, page.id, {
+            downloadedVersion: page.version ?? 0,
+            downloadedAt: new Date().toISOString()
+        });
+        if (!success) {
+            console.warn(`⚠️  Failed to update index for page ${page.title}`);
+        }
+    }
+    slugify(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/-+/g, '-')
+            .trim()
+            .substring(0, 50); // Limit length for filesystem
+    }
+}
+//# sourceMappingURL=download.command.js.map

package/dist/commands/download.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.command.js","sourceRoot":"","sources":["../../src/commands/download.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/executor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Command executor - orchestrates command execution
+ */
+import { ConfluenceConfig } from 'src/types.js';
+import type { Command, CommandContext } from './types.js';
+export declare class CommandExecutor {
+    private config;
+    private registry;
+    constructor(config: ConfluenceConfig);
+    /**
+     * Validate commands and return parsed list
+     */
+    validateCommands(commands: string[]): Command[];
+    /**
+     * Execute a sequence of commands
+     */
+    executeCommands(commands: Command[], context: CommandContext): Promise<void>;
+    /**
+     * Get list of valid commands
+     */
+    getValidCommands(): Command[];
+}

package/dist/commands/executor.js

@@ -0,0 +1,52 @@
+/**
+ * Command executor - orchestrates command execution
+ */
+import { CommandRegistry } from './registry.js';
+export class CommandExecutor {
+    config;
+    registry;
+    constructor(config) {
+        this.config = config;
+        this.registry = new CommandRegistry(config);
+    }
+    /**
+     * Validate commands and return parsed list
+     */
+    validateCommands(commands) {
+        const validated = [];
+        for (const cmd of commands) {
+            const command = cmd.toLowerCase();
+            if (this.registry.isValidCommand(command)) {
+                validated.push(command);
+            }
+            else {
+                throw new Error(`Unknown command: "${cmd}"`);
+            }
+        }
+        return validated;
+    }
+    /**
+     * Execute a sequence of commands
+     */
+    async executeCommands(commands, context) {
+        for (let i = 0; i < commands.length; i++) {
+            const command = commands[i];
+            if (i > 0) {
+                console.log('\n' + '─'.repeat(60) + '\n');
+            }
+            const handler = this.registry.getHandler(command);
+            if (!handler) {
+                throw new Error(`No handler found for command: ${command}`);
+            }
+            await handler.execute(context);
+        }
+        console.log('\n✓ All commands completed successfully!');
+    }
+    /**
+     * Get list of valid commands
+     */
+    getValidCommands() {
+        return this.registry.getValidCommands();
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/commands/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/commands/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,OAAO,eAAe;IAGN;IAFZ,QAAQ,CAAkB;IAElC,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAkB;QACjC,MAAM,SAAS,GAAc,EAAE,CAAC;QAEhC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1C,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,GAAG,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAmB,EAAE,OAAuB;QAChE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAE5B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/commands/help.command.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Help command handler
+ */
+import type { CommandContext, CommandHandler } from './types.js';
+export declare class HelpCommand implements CommandHandler {
+    execute(_context: CommandContext): Promise<void>;
+    private showHelp;
+}

package/dist/commands/help.command.js

@@ -0,0 +1,68 @@
+/**
+ * Help command handler
+ */
+export class HelpCommand {
+    async execute(_context) {
+        this.showHelp();
+    }
+    showHelp() {
+        console.log('Minimal Confluence to Markdown Exporter\n');
+        console.log('Usage: node index.js [command] [options]\n');
+        console.log('If no command is provided, runs full sync: update index (or create if not exists), plan, download, and transform.\n');
+        console.log('Commands:');
+        console.log('  help                          Show this help message');
+        console.log('  index                         Create _index.yaml with page metadata');
+        console.log('  update                        Check for new/updated pages and update _index.yaml');
+        console.log('  plan                          Create _queue.yaml for download (from index or specific page tree)');
+        console.log('  download                      Download HTML pages from _queue.yaml');
+        console.log('  transform                     Transform HTML files to Markdown (skips existing MD files, creates links structure)');
+        console.log('  index plan download transform Run all commands in sequence\n');
+        console.log('Options:');
+        console.log('  -u, --url <url>          Confluence base URL');
+        console.log('  -n, --username <email>   Confluence username/email');
+        console.log('  -p, --password <token>   Confluence API token');
+        console.log('  -s, --space <key>        Confluence space key');
+        console.log('  -i, --pageId <id>        Download specific page ID only (optional)');
+        console.log('  -o, --output <dir>       Output directory (default: ./output)');
+        console.log('  -l, --limit <number>     Limit number of pages to process (optional)');
+        console.log('  --parallel <number>      Number of concurrent operations (default: 5)');
+        console.log('  -f, --force              Force re-download of all pages (skip version check)');
+        console.log('  --clear                  Clear existing MD files and images before transforming');
+        console.log('  --pageSize <number>      Items per API page (default: 25)');
+        console.log('  -h, --help               Show this help message\n');
+        console.log('Environment Variables:');
+        console.log('  CONFLUENCE_BASE_URL');
+        console.log('  CONFLUENCE_USERNAME');
+        console.log('  CONFLUENCE_PASSWORD');
+        console.log('  CONFLUENCE_SPACE_KEY');
+        console.log('  OUTPUT_DIR\n');
+        console.log('Examples:');
+        console.log('  # Full workflow: index, plan, download, and transform');
+        console.log('  node index.js index plan download transform -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Full workflow with limit (process first 10 pages only)');
+        console.log('  node index.js index plan download transform -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE -l 10\n');
+        console.log('  # Create index only (Phase 1)');
+        console.log('  node index.js index -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Check for new/updated pages and update existing index');
+        console.log('  node index.js update -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Create download queue from existing index (Phase 2)');
+        console.log('  node index.js plan -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Create download queue for specific page and all children');
+        console.log('  node index.js plan -i 123456789 -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Force re-download all pages (ignore version check)');
+        console.log('  node index.js plan --force -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Download HTML pages from existing queue (Phase 3)');
+        console.log('  node index.js download -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Transform HTML to Markdown (Phase 4)');
+        console.log('  node index.js transform -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Transform HTML to Markdown with clear (remove existing MD files first)');
+        console.log('  node index.js transform --clear -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Download and transform together');
+        console.log('  node index.js download transform -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Download and transform with higher concurrency');
+        console.log('  node index.js download transform --parallel 10 -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE\n');
+        console.log('  # Download single page HTML only (no index/plan needed)');
+        console.log('  node index.js download -i 123456789 -u https://mysite.atlassian.net -n user@example.com -p token -s MYSPACE');
+    }
+}
+//# sourceMappingURL=help.command.js.map

package/dist/commands/help.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.command.js","sourceRoot":"","sources":["../../src/commands/help.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/index.command.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Index command handler - Creates _index.yaml with all page metadata
+ */
+import type { ConfluenceConfig } from '../types.js';
+import type { CommandContext, CommandHandler } from './types.js';
+export declare class IndexCommand implements CommandHandler {
+    private config;
+    constructor(config: ConfluenceConfig);
+    execute(context: CommandContext): Promise<void>;
+    /**
+     * Create _index.yaml file with all pages to download
+     */
+    private createIndex;
+}

package/dist/commands/index.command.js

@@ -0,0 +1,95 @@
+/**
+ * Index command handler - Creates _index.yaml with all page metadata
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import yaml from 'yaml';
+import { ConfluenceApi } from '../api.js';
+export class IndexCommand {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(context) {
+        const api = new ConfluenceApi(this.config);
+        // Create output directory if it doesn't exist
+        await fs.mkdir(this.config.outputDir, { recursive: true });
+        console.log(`Starting indexing of space: ${this.config.spaceKey}`);
+        console.log(`Output directory: ${this.config.outputDir}\n`);
+        // Phase 1: Create _index.yaml
+        console.log('Phase 1: Creating _index.yaml...');
+        await this.createIndex(api, this.config);
+        console.log(`\nIndexing complete!`);
+        console.log(`Index saved to: ${this.config.outputDir}/_index.yaml`);
+    }
+    /**
+     * Create _index.yaml file with all pages to download
+     */
+    async createIndex(api, config) {
+        const indexPath = path.join(config.outputDir, '_index.yaml');
+        let pageCount = 0;
+        let pageSize = config.pageSize || 100;
+        let startFrom = 0;
+        // Check if _index.yaml already exists (resume functionality)
+        try {
+            const existingContent = await fs.readFile(indexPath, 'utf-8');
+            // Extract page size from comment if it exists
+            const pageSizeMatch = existingContent.match(/# Page Size: (\d+)/);
+            if (pageSizeMatch) {
+                pageSize = parseInt(pageSizeMatch[1], 10);
+                console.log(`Using existing page size from index: ${pageSize}`);
+            }
+            const existingPages = yaml.parse(existingContent);
+            if (existingPages && Array.isArray(existingPages)) {
+                pageCount = existingPages.length;
+                // Calculate the start position for the API
+                startFrom = pageCount;
+                console.log(`Found existing index with ${pageCount} pages. Resuming from position ${startFrom + 1}...\n`);
+            }
+        }
+        catch (_error) {
+            // File doesn't exist or is invalid, start fresh
+            const header = `# Confluence Export Index
+# Space: ${config.spaceKey}
+# Export Date: ${new Date().toISOString()}
+# Page Size: ${pageSize}
+
+`;
+            await fs.writeFile(indexPath, header, 'utf-8');
+            console.log(`Creating new index with page size: ${pageSize}...\n`);
+        }
+        // Fetch pages starting from where we left off
+        for await (const page of api.getAllPages(config.spaceKey, pageSize, startFrom)) {
+            pageCount++;
+            console.log(`[${pageCount}] Indexed: ${page.title} (${page.id}) [API Page ${page.apiPageNumber}]`);
+            // Create page entry
+            const pageEntry = {
+                id: page.id,
+                title: page.title,
+                version: page.version,
+                parentId: page.parentId,
+                modifiedDate: page.modifiedDate,
+                indexedDate: new Date().toISOString(),
+                pageNumber: page.apiPageNumber
+            };
+            // Convert to YAML and format as array item (with leading -)
+            const yamlDoc = yaml.stringify(pageEntry).trim();
+            const lines = yamlDoc.split('\n');
+            const arrayItem = lines.map((line, index) => {
+                if (index === 0) {
+                    return `- ${line}`;
+                }
+                return `  ${line}`;
+            }).join('\n');
+            await fs.appendFile(indexPath, arrayItem + '\n', 'utf-8');
+            // Check if limit is reached
+            if (config.limit && pageCount >= config.limit) {
+                console.log(`\n⚠ Limit reached: ${config.limit} pages indexed`);
+                break;
+            }
+        }
+        console.log(`\n✓ Index created: ${indexPath}`);
+        console.log(`  Total pages indexed: ${pageCount}`);
+    }
+}
+//# sourceMappingURL=index.command.js.map

package/dist/commands/index.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.command.js","sourceRoot":"","sources":["../../src/commands/index.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Commands module exports
+ * Re-exports all command-related classes and types for easier importing
+ */
+export { HelpCommand } from './help.command.js';
+export { IndexCommand } from './index.command.js';
+export { UpdateCommand } from './update.command.js';
+export { PlanCommand } from './plan.command.js';
+export { DownloadCommand } from './download.command.js';
+export { TransformCommand } from './transform.command.js';
+export { CommandRegistry } from './registry.js';
+export { CommandExecutor } from './executor.js';
+export type { Command, CommandContext, CommandHandler } from './types.js';

package/dist/commands/index.js

@@ -0,0 +1,13 @@
+/**
+ * Commands module exports
+ * Re-exports all command-related classes and types for easier importing
+ */
+export { HelpCommand } from './help.command.js';
+export { IndexCommand } from './index.command.js';
+export { UpdateCommand } from './update.command.js';
+export { PlanCommand } from './plan.command.js';
+export { DownloadCommand } from './download.command.js';
+export { TransformCommand } from './transform.command.js';
+export { CommandRegistry } from './registry.js';
+export { CommandExecutor } from './executor.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/commands/plan.command.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Plan command handler - Creates _queue.yaml for download
+ */
+import type { ConfluenceConfig, PageTreeNode } from '../types.js';
+import type { CommandContext, CommandHandler } from './types.js';
+export declare class PlanCommand implements CommandHandler {
+    private config;
+    queuePath: string;
+    treePath: string;
+    tree: PageTreeNode[];
+    constructor(config: ConfluenceConfig);
+    execute(context: CommandContext): Promise<void>;
+    /**
+     * Recursively collect a page and all its descendants
+     */
+    private collectPageTree;
+    /**
+     * Find a node by ID in the tree structure
+     */
+    private findNodeInTree;
+    /**
+     * Flatten tree structure to array of PageIndexEntry
+     */
+    private flattenTree;
+    /**
+     * Flatten array of tree nodes to array of PageIndexEntry
+     */
+    private flattenTreeArray;
+    /**
+     * Filter pages based on whether they need to be downloaded
+     * Checks for existing files and compares versions/dates
+     *
+     * @param pages - All pages from the tree
+     * @param forceMode - If true, skip all checks and include all pages
+     * @returns Filtered pages with queueReason and statistics
+     */
+    private filterPagesForQueue;
+    /**
+     * Load all index entries from _index.yaml file
+     */
+    private loadIndexEntries;
+    /**
+     * Build tree structure from flat index
+     */
+    private buildTreeFromIndex;
+    /**
+     * Write _tree.yaml file with hierarchical structure
+     */
+    private writeTree;
+    /**
+     * Write _queue.yaml file
+     */
+    private writeQueue;
+}