pixotope-documentalist 1.0.0

package/dist/parser/fileScanner.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanPath = scanPath;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const SUPPORTED_EXTENSIONS = new Set([
+    ".ts", ".tsx", ".js", ".jsx",
+    ".py",
+    ".h", ".cpp", ".hpp",
+]);
+function scanPath(filePath) {
+    const resolved = path_1.default.resolve(filePath);
+    if (!fs_1.default.existsSync(resolved)) {
+        throw new Error(`Path not found: ${resolved}`);
+    }
+    const stat = fs_1.default.statSync(resolved);
+    if (stat.isFile()) {
+        return isSupportedFile(resolved) ? [resolved] : [];
+    }
+    if (stat.isDirectory()) {
+        return scanDirectory(resolved);
+    }
+    return [];
+}
+function scanDirectory(dirPath) {
+    const results = [];
+    const entries = fs_1.default.readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path_1.default.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            // Skip node_modules and hidden dirs
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            results.push(...scanDirectory(fullPath));
+        }
+        else if (entry.isFile() && isSupportedFile(fullPath)) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+function isSupportedFile(filePath) {
+    return SUPPORTED_EXTENSIONS.has(path_1.default.extname(filePath).toLowerCase());
+}
+//# sourceMappingURL=fileScanner.js.map

package/dist/parser/fileScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileScanner.js","sourceRoot":"","sources":["../../src/parser/fileScanner.ts"],"names":[],"mappings":";;;;;AASA,4BAkBC;AA3BD,4CAAoB;AACpB,gDAAwB;AAExB,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAC5B,KAAK;IACL,IAAI,EAAE,MAAM,EAAE,MAAM;CACrB,CAAC,CAAC;AAEH,SAAgB,QAAQ,CAAC,QAAgB;IACvC,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAExC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAClB,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,YAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,oCAAoC;YACpC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC1E,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,oBAAoB,CAAC,GAAG,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/parser/index.d.ts

@@ -0,0 +1,4 @@
+export { scanPath } from "./fileScanner";
+export { extractDocBlocks, RawDocBlock } from "./commentExtractor";
+export { blocksToDocument } from "./tagParser";
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blocksToDocument = exports.extractDocBlocks = exports.scanPath = void 0;
+var fileScanner_1 = require("./fileScanner");
+Object.defineProperty(exports, "scanPath", { enumerable: true, get: function () { return fileScanner_1.scanPath; } });
+var commentExtractor_1 = require("./commentExtractor");
+Object.defineProperty(exports, "extractDocBlocks", { enumerable: true, get: function () { return commentExtractor_1.extractDocBlocks; } });
+var tagParser_1 = require("./tagParser");
+Object.defineProperty(exports, "blocksToDocument", { enumerable: true, get: function () { return tagParser_1.blocksToDocument; } });
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AACjB,uDAAmE;AAA1D,oHAAA,gBAAgB,OAAA;AACzB,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA"}

package/dist/parser/tagParser.d.ts

@@ -0,0 +1,9 @@
+import { Document } from "../models";
+import { RawDocBlock } from "./commentExtractor";
+/**
+ * Convert a set of doc blocks into a Document.
+ * Each block with @api becomes an endpoint.
+ * @group tags create new groups; endpoints after a @group belong to it.
+ */
+export declare function blocksToDocument(blocks: RawDocBlock[], title?: string): Document;
+//# sourceMappingURL=tagParser.d.ts.map

package/dist/parser/tagParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagParser.d.ts","sourceRoot":"","sources":["../../src/parser/tagParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,QAAQ,EAIT,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuKjD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,QAAQ,CAyFpF"}

package/dist/parser/tagParser.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blocksToDocument = blocksToDocument;
+const models_1 = require("../models");
+/**
+ * Parse raw lines from a doc block into structured tags.
+ * Tags start with @tagname and their content continues until the next @tag.
+ */
+function parseTagsFromLines(lines) {
+    const tags = [];
+    let currentTag = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const tagMatch = trimmed.match(/^@(\w+)\s*(.*)/);
+        if (tagMatch) {
+            // Flush previous tag
+            if (currentTag) {
+                tags.push(currentTag);
+            }
+            currentTag = {
+                name: tagMatch[1].toLowerCase(),
+                rawContent: tagMatch[2] || "",
+            };
+        }
+        else if (currentTag) {
+            // Continuation line — append to current tag
+            currentTag.rawContent += "\n" + trimmed;
+        }
+    }
+    // Flush last tag
+    if (currentTag) {
+        tags.push(currentTag);
+    }
+    return tags;
+}
+/**
+ * Parse a @param or @returns tag content.
+ * Format: {type} Name - Description
+ * Or:     {type} [Name=default] - Description
+ */
+function parseParamContent(rawContent) {
+    const content = rawContent.trim();
+    let type = "";
+    let remaining = content;
+    // Extract {type}
+    const typeMatch = content.match(/^\{([^}]+)\}\s*/);
+    if (typeMatch) {
+        type = typeMatch[1];
+        remaining = content.slice(typeMatch[0].length);
+    }
+    // Check for optional [Name] or [Name=default]
+    let optional = false;
+    let defaultValue;
+    let name = "";
+    let description = "";
+    const optionalMatch = remaining.match(/^\[([^\]]+)\]\s*(?:-\s*)?/);
+    if (optionalMatch) {
+        optional = true;
+        const inner = optionalMatch[1];
+        const eqIndex = inner.indexOf("=");
+        if (eqIndex !== -1) {
+            name = inner.slice(0, eqIndex);
+            defaultValue = inner.slice(eqIndex + 1);
+        }
+        else {
+            name = inner;
+        }
+        description = remaining.slice(optionalMatch[0].length).trim();
+    }
+    else {
+        // Required param: Name - Description
+        const dashIndex = remaining.indexOf(" - ");
+        if (dashIndex !== -1) {
+            name = remaining.slice(0, dashIndex).trim();
+            description = remaining.slice(dashIndex + 3).trim();
+        }
+        else {
+            // No description separator — entire thing is the name
+            name = remaining.trim();
+        }
+    }
+    // Clean up multiline descriptions
+    description = description.replace(/\n/g, " ").trim();
+    const param = { name, type, description, optional };
+    if (defaultValue !== undefined) {
+        param.default = defaultValue;
+    }
+    return param;
+}
+/**
+ * Parse @example tag content.
+ * First line is the title/description.
+ * Lines starting with >>> are request messages.
+ * Lines starting with <<< are response messages.
+ * Other lines are appended to the last category.
+ */
+function parseExampleContent(rawContent) {
+    const lines = rawContent.split("\n");
+    const description = lines[0]?.trim() || "";
+    const request = [];
+    const response = [];
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        if (line.startsWith(">>>")) {
+            request.push(line.slice(3).trim());
+        }
+        else if (line.startsWith("<<<")) {
+            response.push(line.slice(3).trim());
+        }
+        else {
+            // Continuation of previous category
+            if (response.length > 0) {
+                response[response.length - 1] += " " + line;
+            }
+            else if (request.length > 0) {
+                request[request.length - 1] += " " + line;
+            }
+        }
+    }
+    return { description, request, response };
+}
+/**
+ * Parse @value tag content into a Value tree node.
+ * Format: {type} Name - Description
+ * Dot notation: Name.Child.Grandchild
+ */
+function parseValueContent(rawContent) {
+    const content = rawContent.trim();
+    let type = "";
+    let remaining = content;
+    const typeMatch = content.match(/^\{([^}]+)\}\s*/);
+    if (typeMatch) {
+        type = typeMatch[1];
+        remaining = content.slice(typeMatch[0].length);
+    }
+    let name = "";
+    let description = "";
+    const dashIndex = remaining.indexOf(" - ");
+    if (dashIndex !== -1) {
+        name = remaining.slice(0, dashIndex).trim();
+        description = remaining.slice(dashIndex + 3).trim();
+    }
+    else {
+        name = remaining.trim();
+    }
+    description = description.replace(/\n/g, " ").trim();
+    return { name, type, description, children: [] };
+}
+/**
+ * Convert a set of doc blocks into a Document.
+ * Each block with @api becomes an endpoint.
+ * @group tags create new groups; endpoints after a @group belong to it.
+ */
+function blocksToDocument(blocks, title = "") {
+    const doc = (0, models_1.createDocument)(title);
+    let currentGroupIndex = 0;
+    for (const block of blocks) {
+        const tags = parseTagsFromLines(block.lines);
+        // Check if this block is a standalone @group tag
+        const groupTag = tags.find((t) => t.name === "group");
+        const apiTag = tags.find((t) => t.name === "api");
+        if (groupTag && !apiTag) {
+            // Standalone group — create a new group section
+            const group = (0, models_1.createGroup)(groupTag.rawContent.trim());
+            // Check for description tag in same block
+            const descTag = tags.find((t) => t.name === "description");
+            if (descTag) {
+                group.description = descTag.rawContent.replace(/\n/g, " ").trim();
+            }
+            currentGroupIndex = doc.groups.length;
+            doc.groups.push(group);
+            continue;
+        }
+        if (!apiTag)
+            continue;
+        // This block defines an endpoint
+        const endpointName = apiTag.rawContent.trim();
+        // Determine kind
+        const kindTag = tags.find((t) => t.name === "kind");
+        const kind = kindTag?.rawContent.trim() || "call";
+        const endpoint = (0, models_1.createEndpoint)(endpointName, kind);
+        // If this block also has @group, create a new group first
+        if (groupTag) {
+            const group = (0, models_1.createGroup)(groupTag.rawContent.trim());
+            currentGroupIndex = doc.groups.length;
+            doc.groups.push(group);
+        }
+        // Process all tags
+        for (const tag of tags) {
+            switch (tag.name) {
+                case "description":
+                    endpoint.description = tag.rawContent.replace(/\n/g, " ").trim();
+                    break;
+                case "param":
+                    endpoint.params.push(parseParamContent(tag.rawContent));
+                    break;
+                case "returns":
+                    endpoint.returns.push(parseParamContent(tag.rawContent));
+                    break;
+                case "example":
+                    endpoint.examples.push(parseExampleContent(tag.rawContent));
+                    break;
+                case "warning":
+                    endpoint.warnings.push(tag.rawContent.replace(/\n/g, " ").trim());
+                    break;
+                case "since":
+                    endpoint.since = tag.rawContent.trim();
+                    break;
+                case "deprecated":
+                    endpoint.deprecated = tag.rawContent.replace(/\n/g, " ").trim();
+                    break;
+                case "internal":
+                    endpoint.internal = true;
+                    break;
+                case "value": {
+                    const value = parseValueContent(tag.rawContent);
+                    doc.groups[currentGroupIndex].values.push(value);
+                    break;
+                }
+            }
+        }
+        // Skip internal endpoints
+        if (!endpoint.internal) {
+            doc.groups[currentGroupIndex].endpoints.push(endpoint);
+        }
+    }
+    // Remove empty default group if others exist
+    if (doc.groups.length > 1 && doc.groups[0].endpoints.length === 0 && doc.groups[0].values.length === 0) {
+        doc.groups.shift();
+    }
+    return doc;
+}
+//# sourceMappingURL=tagParser.js.map

package/dist/parser/tagParser.js.map

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

package/dist/pipeline.d.ts

@@ -0,0 +1,31 @@
+import { Config, Document, DocumentConfig } from "./models";
+export interface PipelineOptions {
+    config: Config;
+    configDir: string;
+    document?: string;
+    target: "master" | "release";
+    version: string;
+    verbose: boolean;
+}
+/**
+ * Parse source files for a single document config entry.
+ * Returns the intermediate Document model.
+ */
+export declare function parseDocument(docConfig: DocumentConfig, config: Config, configDir: string, verbose: boolean): Document;
+/**
+ * Parse command: parse source files and output JSON.
+ */
+export declare function runParse(options: PipelineOptions): void;
+/**
+ * Preview command: parse + render to HTML files.
+ */
+export declare function runPreview(options: PipelineOptions): void;
+/**
+ * Publish command: parse + render + upload to Confluence.
+ */
+export declare function runPublish(options: PipelineOptions): Promise<void>;
+/**
+ * Diff command: show what would change without publishing.
+ */
+export declare function runDiff(options: PipelineOptions): Promise<void>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM5D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,QAAQ,CA+BV;AAsBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA6BvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAoBzD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCxE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrE"}

package/dist/pipeline.js

@@ -0,0 +1,147 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDocument = parseDocument;
+exports.runParse = runParse;
+exports.runPreview = runPreview;
+exports.runPublish = runPublish;
+exports.runDiff = runDiff;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("./config");
+const parser_1 = require("./parser");
+const renderer_1 = require("./renderer");
+const publisher_1 = require("./publisher");
+/**
+ * Parse source files for a single document config entry.
+ * Returns the intermediate Document model.
+ */
+function parseDocument(docConfig, config, configDir, verbose) {
+    const allBlocks = [];
+    for (const source of docConfig.sources) {
+        const resolvedPath = (0, config_1.resolveSourcePath)(config.source_root, source.path, configDir);
+        if (verbose) {
+            console.log(`  Scanning: ${resolvedPath}`);
+        }
+        const files = (0, parser_1.scanPath)(resolvedPath);
+        for (const file of files) {
+            if (verbose) {
+                console.log(`    Parsing: ${file}`);
+            }
+            const blocks = (0, parser_1.extractDocBlocks)(file);
+            allBlocks.push(...blocks);
+            if (verbose && blocks.length > 0) {
+                console.log(`      Found ${blocks.length} doc block(s)`);
+            }
+        }
+    }
+    const doc = (0, parser_1.blocksToDocument)(allBlocks, docConfig.title);
+    doc.version = config.source_root;
+    doc.confluenceId =
+        docConfig.confluenceId.master; // Default, overridden by target
+    return doc;
+}
+/**
+ * Get the list of document configs to process (all or filtered by --document).
+ */
+function getDocConfigs(config, documentFilter) {
+    if (documentFilter) {
+        const found = config.documents.filter((d) => d.id === documentFilter);
+        if (found.length === 0) {
+            const available = config.documents.map((d) => d.id).join(", ");
+            throw new Error(`Document "${documentFilter}" not found. Available: ${available}`);
+        }
+        return found;
+    }
+    return config.documents;
+}
+/**
+ * Parse command: parse source files and output JSON.
+ */
+function runParse(options) {
+    const docConfigs = getDocConfigs(options.config, options.document);
+    for (const docConfig of docConfigs) {
+        console.log(`\nParsing: ${docConfig.title}`);
+        const doc = parseDocument(docConfig, options.config, options.configDir, options.verbose);
+        // Count endpoints
+        let endpointCount = 0;
+        for (const group of doc.groups) {
+            endpointCount += group.endpoints.length;
+        }
+        console.log(`  Found ${doc.groups.length} group(s), ${endpointCount} endpoint(s)`);
+        // Output JSON
+        const outputDir = path_1.default.resolve(options.configDir, "output", "collected");
+        fs_1.default.mkdirSync(outputDir, { recursive: true });
+        const outputPath = path_1.default.join(outputDir, `${docConfig.id}.json`);
+        fs_1.default.writeFileSync(outputPath, JSON.stringify(doc, null, 2), "utf-8");
+        console.log(`  Saved JSON: ${outputPath}`);
+    }
+}
+/**
+ * Preview command: parse + render to HTML files.
+ */
+function runPreview(options) {
+    const docConfigs = getDocConfigs(options.config, options.document);
+    for (const docConfig of docConfigs) {
+        console.log(`\nProcessing: ${docConfig.title}`);
+        const doc = parseDocument(docConfig, options.config, options.configDir, options.verbose);
+        const html = (0, renderer_1.renderDocument)(doc);
+        // Save HTML
+        const outputDir = path_1.default.resolve(options.configDir, "output", "formatted");
+        fs_1.default.mkdirSync(outputDir, { recursive: true });
+        const outputPath = path_1.default.join(outputDir, `${docConfig.id}.html`);
+        fs_1.default.writeFileSync(outputPath, html, "utf-8");
+        console.log(`  Saved HTML: ${outputPath}`);
+    }
+}
+/**
+ * Publish command: parse + render + upload to Confluence.
+ */
+async function runPublish(options) {
+    const client = (0, publisher_1.createClientFromEnv)(options.config.confluence.base_url);
+    const docConfigs = getDocConfigs(options.config, options.document);
+    for (const docConfig of docConfigs) {
+        console.log(`\nPublishing: ${docConfig.title}`);
+        const doc = parseDocument(docConfig, options.config, options.configDir, options.verbose);
+        const html = (0, renderer_1.renderDocument)(doc);
+        const confluenceId = options.target === "release"
+            ? docConfig.confluenceId.release
+            : docConfig.confluenceId.master;
+        if (!confluenceId) {
+            console.log(`  Skipped: no ${options.target} confluence_id configured`);
+            continue;
+        }
+        const result = await client.publish(confluenceId, docConfig.title, html);
+        if (result.success) {
+            console.log(`  ${result.message}`);
+        }
+        else {
+            console.error(`  ERROR: ${result.message}`);
+            process.exit(1);
+        }
+    }
+}
+/**
+ * Diff command: show what would change without publishing.
+ */
+async function runDiff(options) {
+    const client = (0, publisher_1.createClientFromEnv)(options.config.confluence.base_url);
+    const docConfigs = getDocConfigs(options.config, options.document);
+    for (const docConfig of docConfigs) {
+        console.log(`\nChecking: ${docConfig.title}`);
+        const doc = parseDocument(docConfig, options.config, options.configDir, options.verbose);
+        const html = (0, renderer_1.renderDocument)(doc);
+        const confluenceId = options.target === "release"
+            ? docConfig.confluenceId.release
+            : docConfig.confluenceId.master;
+        if (!confluenceId) {
+            console.log(`  Skipped: no ${options.target} confluence_id configured`);
+            continue;
+        }
+        const diffResult = await client.diff(confluenceId, html);
+        console.log(`  ${diffResult}`);
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":";;;;;AAqBA,sCAoCC;AAyBD,4BA6BC;AAKD,gCAoBC;AAKD,gCAqCC;AAKD,0BA2BC;AAlND,4CAAoB;AACpB,gDAAwB;AAExB,qCAA6C;AAC7C,qCAAwE;AACxE,yCAA4C;AAC5C,2CAAiE;AAWjE;;;GAGG;AACH,SAAgB,aAAa,CAC3B,SAAyB,EACzB,MAAc,EACd,SAAiB,EACjB,OAAgB;IAEhB,MAAM,SAAS,GAAwC,EAAE,CAAC;IAE1D,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,IAAA,0BAAiB,EAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEnF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,eAAe,YAAY,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,iBAAQ,EAAC,YAAY,CAAC,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,MAAM,GAAG,IAAA,yBAAgB,EAAC,IAAI,CAAC,CAAC;YACtC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;YAE1B,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,MAAM,eAAe,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,yBAAgB,EAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;IACjC,GAAG,CAAC,YAAY;QACd,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,gCAAgC;IAEjE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,MAAc,EACd,cAAuB;IAEvB,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,cAAc,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/D,MAAM,IAAI,KAAK,CACb,aAAa,cAAc,2BAA2B,SAAS,EAAE,CAClE,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,OAAwB;IAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,aAAa,CACvB,SAAS,EACT,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;QAEF,kBAAkB;QAClB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC/B,aAAa,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAC1C,CAAC;QAED,OAAO,CAAC,GAAG,CACT,WAAW,GAAG,CAAC,MAAM,CAAC,MAAM,cAAc,aAAa,cAAc,CACtE,CAAC;QAEF,cAAc;QACd,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACzE,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAwB;IACjD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,iBAAiB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,aAAa,CACvB,SAAS,EACT,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;QACF,MAAM,IAAI,GAAG,IAAA,yBAAc,EAAC,GAAG,CAAC,CAAC;QAEjC,YAAY;QACZ,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACzE,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,UAAU,CAAC,OAAwB;IACvD,MAAM,MAAM,GAAG,IAAA,+BAAmB,EAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,iBAAiB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,aAAa,CACvB,SAAS,EACT,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;QACF,MAAM,IAAI,GAAG,IAAA,yBAAc,EAAC,GAAG,CAAC,CAAC;QAEjC,MAAM,YAAY,GAChB,OAAO,CAAC,MAAM,KAAK,SAAS;YAC1B,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO;YAChC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC;QAEpC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,MAAM,2BAA2B,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAkB,MAAM,MAAM,CAAC,OAAO,CAChD,YAAY,EACZ,SAAS,CAAC,KAAK,EACf,IAAI,CACL,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,OAAO,CAAC,OAAwB;IACpD,MAAM,MAAM,GAAG,IAAA,+BAAmB,EAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,aAAa,CACvB,SAAS,EACT,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;QACF,MAAM,IAAI,GAAG,IAAA,yBAAc,EAAC,GAAG,CAAC,CAAC;QAEjC,MAAM,YAAY,GAChB,OAAO,CAAC,MAAM,KAAK,SAAS;YAC1B,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO;YAChC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC;QAEpC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,MAAM,2BAA2B,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/publisher/confluenceApi.d.ts

@@ -0,0 +1,33 @@
+export interface PublishResult {
+    success: boolean;
+    message: string;
+    pageId: string;
+}
+export declare class ConfluenceClient {
+    private client;
+    constructor(baseUrl: string, username: string, token: string);
+    /**
+     * Get the current page version number.
+     */
+    getPageVersion(pageId: string): Promise<number>;
+    /**
+     * Get the current page body content (storage format).
+     */
+    getPageContent(pageId: string): Promise<string>;
+    /**
+     * Publish content to a Confluence page.
+     * Only updates if content has actually changed.
+     */
+    publish(pageId: string, title: string, html: string, options?: {
+        force?: boolean;
+    }): Promise<PublishResult>;
+    /**
+     * Get a diff summary of what would change.
+     */
+    diff(pageId: string, newHtml: string): Promise<string>;
+}
+/**
+ * Create a ConfluenceClient from environment variables.
+ */
+export declare function createClientFromEnv(baseUrl: string): ConfluenceClient;
+//# sourceMappingURL=confluenceApi.d.ts.map

package/dist/publisher/confluenceApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluenceApi.d.ts","sourceRoot":"","sources":["../../src/publisher/confluenceApi.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;gBAElB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAa5D;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrD;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQrD;;;OAGG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAChC,OAAO,CAAC,aAAa,CAAC;IA0DzB;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAc7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAYrE"}