confluence-exporter 1.0.0

package/dist/commands/plan.command.js

@@ -0,0 +1,272 @@
+/**
+ * Plan command handler - Creates _queue.yaml for download
+ */
+import * as fs from 'fs';
+import path from 'path';
+import yaml from 'yaml';
+import { checkPageStatus } from '../utils.js';
+export class PlanCommand {
+    config;
+    queuePath;
+    treePath;
+    tree;
+    constructor(config) {
+        this.config = config;
+        this.queuePath = path.join(this.config.outputDir, '_queue.yaml');
+        this.treePath = path.join(this.config.outputDir, '_tree.yaml');
+        this.tree = [];
+    }
+    async execute(context) {
+        // Create output directory if it doesn't exist
+        fs.mkdirSync(this.config.outputDir, { recursive: true });
+        // Check for --force flag
+        const forceMode = this.config.force === true;
+        if (forceMode) {
+            console.log('\n⚠️  Force mode enabled - all pages will be queued regardless of status\n');
+        }
+        // Step 1: Build complete tree structure (no limits applied here)
+        this.tree = this.buildTreeFromIndex();
+        if (this.config.pageId) {
+            // Build tree from specific page and all children
+            console.log(`Building tree from specific page: ${this.config.pageId}`);
+            this.tree = [this.collectPageTree(this.config.pageId)];
+        }
+        // Step 2: Create queue from tree with smart filtering
+        console.log(`\nCreating download queue from tree...`);
+        try {
+            const allPages = this.flattenTreeArray(this.tree);
+            console.log(`Flattened tree to ${allPages.length} pages`);
+            // Apply smart filtering (check if pages need downloading)
+            const { pagesToQueue, stats } = this.filterPagesForQueue(allPages, forceMode);
+            // Apply limit if specified (only affects queue, not tree)
+            const finalQueue = this.config.limit ? pagesToQueue.slice(0, this.config.limit) : pagesToQueue;
+            if (this.config.limit && pagesToQueue.length > this.config.limit) {
+                console.log(`Limiting queue to first ${this.config.limit} pages`);
+            }
+            this.writeQueue(this.queuePath, this.config, finalQueue);
+            console.log(`\n✓ Queue created: ${this.queuePath}`);
+            console.log(`  📊 Statistics:`);
+            console.log(`     New pages:     ${stats.new}`);
+            console.log(`     Updated pages: ${stats.updated}`);
+            console.log(`     Skipped:       ${stats.skipped} (up-to-date)`);
+            console.log(`     Total queued:  ${finalQueue.length}`);
+            console.log(`     Total in tree: ${allPages.length}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to create queue from tree: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    /**
+     * Recursively collect a page and all its descendants
+     */
+    collectPageTree(pageId, depth = 0) {
+        const indent = '  '.repeat(depth);
+        // Find the page in the tree
+        const node = this.findNodeInTree(this.tree, pageId);
+        if (!node) {
+            throw new Error(`Page ${pageId} not found in tree`);
+        }
+        console.log(`${indent}Found page: ${node.title} (${node.id})`);
+        return node;
+    }
+    /**
+     * Find a node by ID in the tree structure
+     */
+    findNodeInTree(nodes, pageId) {
+        for (const node of nodes) {
+            if (node.id === pageId) {
+                return node;
+            }
+            if (node.children && node.children.length > 0) {
+                const found = this.findNodeInTree(node.children, pageId);
+                if (found) {
+                    return found;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Flatten tree structure to array of PageIndexEntry
+     */
+    flattenTree(node, result = []) {
+        result.push({
+            id: node.id,
+            title: node.title,
+            version: node.version,
+            parentId: node.parentId,
+            modifiedDate: node.modifiedDate,
+            indexedDate: new Date().toISOString(),
+            pageNumber: 0
+        });
+        if (node.children) {
+            for (const child of node.children) {
+                this.flattenTree(child, result);
+            }
+        }
+        return result;
+    }
+    /**
+     * Flatten array of tree nodes to array of PageIndexEntry
+     */
+    flattenTreeArray(trees) {
+        const result = [];
+        for (const tree of trees) {
+            this.flattenTree(tree, result);
+        }
+        return result;
+    }
+    /**
+     * 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
+     */
+    filterPagesForQueue(pages, forceMode) {
+        const pagesToQueue = [];
+        const stats = { new: 0, updated: 0, skipped: 0 };
+        console.log('\n📋 Checking page status...');
+        // Force mode: include all pages without checking
+        if (forceMode) {
+            for (const page of pages) {
+                pagesToQueue.push({ ...page, queueReason: 'new' });
+                stats.new++;
+            }
+            return { pagesToQueue, stats };
+        }
+        // Read index once for all lookups
+        const indexPath = path.join(this.config.outputDir, '_index.yaml');
+        const indexEntries = this.loadIndexEntries(indexPath);
+        const indexMap = new Map(indexEntries.map(entry => [entry.id, entry]));
+        console.log(`Loaded ${indexEntries.length} entries from index for status checking`);
+        // Process pages in batches of 100 for better performance
+        const batchSize = 100;
+        for (let i = 0; i < pages.length; i += batchSize) {
+            const batch = pages.slice(i, i + batchSize);
+            console.log(`Processing batch ${Math.floor(i / batchSize) + 1}/${Math.ceil(pages.length / batchSize)} (${batch.length} pages)`);
+            for (const page of batch) {
+                // Check if page has been downloaded by looking at index entry
+                const existingEntry = indexMap.get(page.id);
+                if (!existingEntry || !existingEntry.downloadedVersion) {
+                    // Page not downloaded yet
+                    console.log(`  [NEW] ${page.title} (${page.id})`);
+                    pagesToQueue.push({ ...page, queueReason: 'new' });
+                    stats.new++;
+                    continue;
+                }
+                // Check if page needs update
+                const status = checkPageStatus(existingEntry);
+                if (status.needsDownload) {
+                    const details = status.details ? ` - ${status.details}` : '';
+                    console.log(`  [UPDATE] ${page.title} (${page.id})${details}`);
+                    pagesToQueue.push({ ...page, queueReason: 'updated' });
+                    stats.updated++;
+                }
+                else {
+                    console.log(`  [SKIP] ${page.title} (${page.id}) - up to date (v${existingEntry.downloadedVersion})`);
+                    stats.skipped++;
+                }
+            }
+        }
+        return { pagesToQueue, stats };
+    }
+    /**
+     * Load all index entries from _index.yaml file
+     */
+    loadIndexEntries(indexPath) {
+        if (!fs.existsSync(indexPath))
+            return [];
+        try {
+            const content = fs.readFileSync(indexPath, 'utf-8');
+            return yaml.parse(content);
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to load index file ${indexPath}: ${error}`);
+            return [];
+        }
+    }
+    /**
+     * Build tree structure from flat index
+     */
+    buildTreeFromIndex() {
+        const indexPath = path.join(this.config.outputDir, '_index.yaml');
+        const yamlContent = fs.readFileSync(indexPath, 'utf-8');
+        const pages = yaml.parse(yamlContent);
+        console.log(`Read ${pages.length} pages from _index.yaml`);
+        const nodeMap = new Map();
+        const roots = [];
+        // First pass: create all nodes
+        for (const page of pages) {
+            nodeMap.set(page.id, {
+                id: page.id,
+                title: page.title,
+                version: page.version,
+                parentId: page.parentId,
+                modifiedDate: page.modifiedDate,
+                children: []
+            });
+        }
+        // Second pass: build tree structure
+        for (const page of pages) {
+            const node = nodeMap.get(page.id);
+            if (!node)
+                continue;
+            if (page.parentId && nodeMap.has(page.parentId)) {
+                // Add as child to parent
+                const parent = nodeMap.get(page.parentId);
+                if (parent?.children) {
+                    parent.children.push(node);
+                }
+            }
+            else {
+                // No parent or parent not in index - it's a root
+                roots.push(node);
+            }
+        }
+        this.writeTree(roots);
+        console.log(`✓ Complete tree structure saved: ${this.treePath}`);
+        return roots;
+    }
+    /**
+     * Write _tree.yaml file with hierarchical structure
+     */
+    writeTree(tree) {
+        const header = `# Confluence Page Tree
+# Space: ${this.config.spaceKey}
+# Created: ${new Date().toISOString()}
+
+`;
+        const yamlContent = yaml.stringify(tree, {
+            indent: 2,
+            lineWidth: 0 // No line wrapping
+        });
+        fs.writeFileSync(this.treePath, header + yamlContent, 'utf-8');
+    }
+    /**
+     * Write _queue.yaml file
+     */
+    writeQueue(queuePath, config, pages) {
+        const header = `# Confluence Download Queue
+# Space: ${config.spaceKey}
+# Created: ${new Date().toISOString()}
+# Total Pages: ${pages.length}
+
+`;
+        fs.writeFileSync(queuePath, header, 'utf-8');
+        // Write each page as YAML array entry
+        for (const page of pages) {
+            const yamlDoc = yaml.stringify(page).trim();
+            const lines = yamlDoc.split('\n');
+            const arrayItem = lines.map((line, index) => {
+                if (index === 0) {
+                    return `- ${line}`;
+                }
+                return `  ${line}`;
+            }).join('\n');
+            fs.appendFileSync(queuePath, arrayItem + '\n', 'utf-8');
+        }
+    }
+}
+//# sourceMappingURL=plan.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.command.js","sourceRoot":"","sources":["../../src/commands/plan.command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAoB,eAAe,EAAoB,MAAM,aAAa,CAAC;AAElF,MAAM,OAAO,WAAW;IAKF;IAJpB,SAAS,CAAS;IAClB,QAAQ,CAAS;IACjB,IAAI,CAAiB;IAErB,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAuB;QAEnC,8CAA8C;QAC9C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzD,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;QAC7C,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;QAC5F,CAAC;QAED,iEAAiE;QACjE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,iDAAiD;YACjD,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACvE,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,sDAAsD;QACtD,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,qBAAqB,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC;YAE1D,0DAA0D;YAC1D,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE9E,0DAA0D;YAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;YAE/F,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjE,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC;YACpE,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAEzD,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,uBAAuB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAc,EAAE,QAAgB,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAElC,4BAA4B;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,oBAAoB,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,KAAqB,EAAE,MAAc;QAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACzD,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAkB,EAAE,SAA2B,EAAE;QACnE,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,KAAqB;QAC5C,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACK,mBAAmB,CACzB,KAAuB,EACvB,SAAkB;QAElB,MAAM,YAAY,GAAqB,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAEjD,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAE5C,iDAAiD;QACjD,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;gBACnD,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,CAAC;YACD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QAED,kCAAkC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAEvE,OAAO,CAAC,GAAG,CAAC,UAAU,YAAY,CAAC,MAAM,yCAAyC,CAAC,CAAC;QAEpF,yDAAyD;QACzD,MAAM,SAAS,GAAG,GAAG,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAK,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;YAEhI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,8DAA8D;gBAC9D,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAE5C,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;oBACvD,0BAA0B;oBAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;oBAClD,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;oBACnD,KAAK,CAAC,GAAG,EAAE,CAAC;oBACZ,SAAS;gBACX,CAAC;gBAED,6BAA6B;gBAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;gBAE9C,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;oBAC/D,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;oBACvD,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,oBAAoB,aAAa,CAAC,iBAAiB,GAAG,CAAC,CAAC;oBACtG,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,SAAiB;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,sCAAsC,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAElE,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAqB,CAAC;QAE1D,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,MAAM,yBAAyB,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;QAChD,MAAM,KAAK,GAAmB,EAAE,CAAC;QAEjC,+BAA+B;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;gBACnB,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;QACL,CAAC;QAED,oCAAoC;QACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChD,yBAAyB;gBACzB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC1C,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;oBACrB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,iDAAiD;gBACjD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,IAAoB;QACpC,MAAM,MAAM,GAAG;WACR,IAAI,CAAC,MAAM,CAAC,QAAQ;aAClB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;CAEpC,CAAC;QAEE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;YACvC,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC,CAAC,mBAAmB;SACjC,CAAC,CAAC;QAEH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,SAAiB,EAAE,MAAgC,EAAE,KAAuB;QAC7F,MAAM,MAAM,GAAG;WACR,MAAM,CAAC,QAAQ;aACb,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpB,KAAK,CAAC,MAAM;;CAE5B,CAAC;QAEE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAE7C,sCAAsC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBAC1C,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,CAAC;gBACD,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF"}

package/dist/commands/registry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Command registry - maps command names to handlers
+ */
+import type { Command, CommandHandler } from './types.js';
+import { ConfluenceConfig } from 'src/types.js';
+export declare class CommandRegistry {
+    private handlers;
+    constructor(config?: ConfluenceConfig);
+    getHandler(command: Command): CommandHandler | undefined;
+    isValidCommand(command: string): command is Command;
+    getValidCommands(): Command[];
+}

package/dist/commands/registry.js

@@ -0,0 +1,32 @@
+/**
+ * Command registry - maps command names to handlers
+ */
+import { HelpCommand } from './help.command.js';
+import { IndexCommand } from './index.command.js';
+import { UpdateCommand } from './update.command.js';
+import { PlanCommand } from './plan.command.js';
+import { DownloadCommand } from './download.command.js';
+import { TransformCommand } from './transform.command.js';
+export class CommandRegistry {
+    handlers;
+    constructor(config) {
+        this.handlers = new Map([
+            ['help', new HelpCommand()],
+            ['index', new IndexCommand(config)],
+            ['update', new UpdateCommand(config)],
+            ['plan', new PlanCommand(config)],
+            ['download', new DownloadCommand(config)],
+            ['transform', new TransformCommand(config)]
+        ]);
+    }
+    getHandler(command) {
+        return this.handlers.get(command);
+    }
+    isValidCommand(command) {
+        return this.handlers.has(command);
+    }
+    getValidCommands() {
+        return Array.from(this.handlers.keys());
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/commands/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;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;AAI1D,MAAM,OAAO,eAAe;IAClB,QAAQ,CAA+B;IAE/C,YAAY,MAAyB;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAA0B;YAC/C,CAAC,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC3B,CAAC,OAAO,EAAE,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,QAAQ,EAAE,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC,MAAM,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC,UAAU,EAAE,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC,WAAW,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAkB,CAAC,CAAC;IAC/C,CAAC;IAED,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

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

@@ -0,0 +1,69 @@
+/**
+ * Transform command handler - Transforms HTML files to Markdown
+ */
+import type { CommandContext, CommandHandler } from './types.js';
+import type { ConfluenceConfig } from '../types.js';
+export declare class TransformCommand implements CommandHandler {
+    private config;
+    private pendingIncludes;
+    private api;
+    constructor(config: ConfluenceConfig);
+    execute(_context: CommandContext): Promise<void>;
+    /**
+     * Process a single HTML file to Markdown
+     */
+    private processFile;
+    /**
+     * Basic HTML to Markdown conversion
+     */
+    private htmlToMarkdown;
+    /**
+     * Transform images and download attachments
+     */
+    private transformImages;
+    /**
+     * Build a Markdown list from an included page's HTML content.
+     * Prefer extracting <ul>/<ol> list items and anchor links; fall back to full page transform.
+     */
+    private buildIncludeList;
+    /**
+     * Transform Confluence macros to Markdown
+     */
+    private transformMacros;
+    /**
+     * Transform user links to display names
+     */
+    private transformUserLinks;
+    /**
+     * Transform page links to markdown links
+     */
+    private transformPageLinks;
+    /**
+     * Clean up malformed markdown patterns
+     */
+    private cleanMarkdown;
+    /**
+     * Clean up specific problematic patterns that appear in Confluence exports
+     */
+    private cleanConfluencePatterns;
+    /**
+     * General markdown cleanup
+     */
+    private cleanGeneral;
+    /**
+     * Create links folder with symlinks and _links.md with tree structure
+     */
+    private createLinksStructure;
+    /**
+     * Build a tree structure from flat file list
+     */
+    private buildFileTree;
+    /**
+     * Generate markdown tree structure
+     */
+    private generateTreeMarkdown;
+    /**
+     * Recursively clear existing .md files and images folders
+     */
+    private clearExistingFiles;
+}