@imolko/create-ultra-reporter 2.1.23-beta

package/bin/commands/generate-documentation.js

@@ -0,0 +1,249 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommandGenerateDocumentation = registerCommandGenerateDocumentation;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = __importDefault(require("../classes/logger"));
+const utils_1 = require("../utils");
+const path_1 = require("path");
+const delete_paths_1 = require("../scripts/delete-paths");
+const promises_1 = __importDefault(require("fs/promises"));
+const converter_1 = require("../scripts/converter");
+const generate_domain_documentation_1 = require("../reporters/generate-domain-documentation");
+const generate_use_cases_documentation_1 = require("../reporters/generate-use-cases-documentation");
+const types_1 = require("./types");
+// Crear un logger específico para este comando
+const cmdLogger = logger_1.default.createContextLogger('cmd:generate-documentation');
+const DOCUSAURUS_DOMAIN_CONFIG = {
+    "label": "Domain Artifacts",
+    "position": 2,
+};
+const DOCUSAURUS_AGGEGATES_CONFIG = {
+    "label": "Aggregates",
+    "position": 1,
+};
+function registerCommandGenerateDocumentation(program) {
+    program
+        .command('generate-documentation')
+        .description('Generate documentation')
+        .option("-p, --documentation-path <path>", "Documentation directory", "./documentation")
+        .action(async (options) => {
+        cmdLogger.info('Starting generate-documentation command');
+        cmdLogger.debug('Local options', options);
+        // Check if the documentation folder already exists
+        const documentationPath = (0, path_1.resolve)(process.cwd(), options.documentationPath);
+        if (!(0, utils_1.existsFolder)(documentationPath)) {
+            cmdLogger.info('Documentation folder does not exist');
+            cmdLogger.debug('Documentation folder path', { path: options.documentationPath });
+            cmdLogger.info('Command generate-documentation completed');
+            process.exit(0);
+        }
+        const configFilePath = (0, path_1.resolve)(documentationPath, "ultra-reporter.config.json");
+        if (!(0, utils_1.existsFile)(configFilePath)) {
+            cmdLogger.error('Configuration file does not exist');
+            cmdLogger.info('Command generate-documentation completed');
+            process.exit(1);
+        }
+        const configFile = (await (0, utils_1.getJSONFile)(configFilePath));
+        const targets = configFile.targets || [];
+        const cmdRoot = __dirname;
+        // Clear manifest for fresh regeneration (append-only per target)
+        const manifestDir = path.resolve(documentationPath, 'static', 'data');
+        const manifestPath = path.resolve(manifestDir, 'artifacts-manifest.json');
+        if ((0, utils_1.existsFile)(manifestPath)) {
+            fs.unlinkSync(manifestPath);
+        }
+        for (let i = 0; i < targets.length; i++) {
+            const target = targets[i];
+            if (target.type === types_1.TargetType.Domain) {
+                const cwd = process.cwd();
+                const domainSrc = target.domainSrc;
+                const contextName = target.contextName;
+                const packageRootName = target.packageRoot.match(/\w+/g)?.join("-") || "package-root";
+                const artifactsFolderPath = (0, path_1.resolve)(cwd, domainSrc);
+                const packageRootPath = (0, path_1.resolve)(cwd, target.packageRoot);
+                const documentationDataPath = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName);
+                await (0, delete_paths_1.deletePaths)([
+                    documentationDataPath
+                ]);
+                await (0, utils_1.createFolder)(documentationDataPath);
+                const artifactsJsonPath = (0, path_1.resolve)(documentationDataPath, 'artifacts.json');
+                // Pre-compiled track script — no generation or tsc compilation needed
+                const trackArtifactsScriptPath = (0, path_1.resolve)(cmdRoot, "../scripts/track-artifacts.js");
+                await (0, utils_1.runCommand)(`node ${trackArtifactsScriptPath} ${artifactsFolderPath} ${artifactsJsonPath} ${contextName}`);
+                // Generar reporte JSDoc
+                const jsdocNameFile = "jsdoc-report.txt";
+                const jsdocOutputFile = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName, jsdocNameFile);
+                const internalJsdocConfigPath = (0, path_1.resolve)(cmdRoot, "../../jsdoc.conf.json");
+                const jsonFile2 = await (0, utils_1.getJSONFile)(internalJsdocConfigPath);
+                const includePath = (0, path_1.resolve)(cwd, domainSrc);
+                jsonFile2.source.include = [includePath];
+                const jsdocConfigPath = (0, path_1.resolve)(packageRootPath, "jsdoc.conf.json");
+                await promises_1.default.writeFile(jsdocConfigPath, JSON.stringify(jsonFile2, null, 2));
+                await (0, utils_1.runCommand)(`./node_modules/.bin/jsdoc --explain -c ${jsdocConfigPath} > ${jsdocOutputFile}`);
+                const testResultsPath = (0, path_1.resolve)(cwd, target.testsResultFile);
+                const testResultsFile = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName, "ctfr-test-results.json");
+                if ((0, utils_1.existsFile)(testResultsPath)) {
+                    const testResults = await (0, utils_1.getJSONFile)(testResultsPath);
+                    await promises_1.default.writeFile(testResultsFile, JSON.stringify(testResults, null, 2));
+                    const newTestResultsFile = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName, "test-results.json");
+                    (0, converter_1.convertTestJsonFormat)(testResultsFile, newTestResultsFile);
+                }
+                else {
+                    const emptyTestResults = {
+                        "numFailedTestSuites": 0,
+                        "numFailedTests": 0,
+                        "numPassedTestSuites": 0,
+                        "numPassedTests": 0,
+                        "numPendingTestSuites": 0,
+                        "numPendingTests": 0,
+                        "numRuntimeErrorTestSuites": 0,
+                        "numTodoTests": 0,
+                        "numTotalTestSuites": 400,
+                        "numTotalTests": 0,
+                        "startTime": 0,
+                        "success": true,
+                        "testResults": []
+                    };
+                    await promises_1.default.writeFile(testResultsFile, JSON.stringify(emptyTestResults, null, 2));
+                }
+                // Clean up temporary config file
+                await (0, delete_paths_1.deletePaths)([
+                    jsdocConfigPath
+                ]);
+                const domainTabName = target.docusaurus?.domain?.name || 'domain';
+                const docusaurusDomainPath = (0, path_1.resolve)(documentationPath, "docs", domainTabName);
+                let categoryConfigPath = (0, path_1.resolve)(docusaurusDomainPath, "_category_.json");
+                let categoryConfig = target.docusaurus?.domain?.config ? target.docusaurus.domain.config : DOCUSAURUS_DOMAIN_CONFIG;
+                await (0, delete_paths_1.deletePaths)([docusaurusDomainPath]);
+                await (0, utils_1.createFolder)(docusaurusDomainPath);
+                await promises_1.default.writeFile(categoryConfigPath, JSON.stringify(categoryConfig, null, 2));
+                const aggregatesTabName = target.docusaurus?.aggregates?.name || 'aggregates';
+                const docusaurusAggregatesPath = (0, path_1.resolve)(documentationPath, "docs", aggregatesTabName);
+                categoryConfigPath = (0, path_1.resolve)(docusaurusAggregatesPath, "_category_.json");
+                categoryConfig = target.docusaurus?.aggregates?.config ? target.docusaurus.aggregates.config : DOCUSAURUS_AGGEGATES_CONFIG;
+                await (0, delete_paths_1.deletePaths)([docusaurusAggregatesPath]);
+                await (0, utils_1.createFolder)(docusaurusAggregatesPath);
+                await promises_1.default.writeFile(categoryConfigPath, JSON.stringify(categoryConfig, null, 2));
+                await (0, generate_domain_documentation_1.generateDomainDocumentation)({
+                    packageRootName,
+                    contextName,
+                    documentationPath,
+                    domainPath: artifactsFolderPath,
+                    domainTabName,
+                    aggregateTabName: aggregatesTabName,
+                    templateDir: (0, path_1.resolve)(cmdRoot, "../reporters/templates"),
+                    repoSourceUrl: configFile.repoSourceUrl,
+                });
+            }
+            else if (target.type === types_1.TargetType.UseCases) {
+                const cwd = process.cwd();
+                const useCasesSrc = target.useCasesSrc;
+                const title = target.title;
+                const packageRootName = target.packageRoot.match(/\w+/g)?.join("-") || "package-root";
+                const documentationDataPath = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName);
+                await (0, delete_paths_1.deletePaths)([
+                    documentationDataPath
+                ]);
+                await (0, utils_1.createFolder)(documentationDataPath);
+                // Generar reporte JSDoc
+                const jsdocNameFile = "jsdoc-report.txt";
+                console.log({ documentationPath, packageRootName, jsdocNameFile });
+                const jsdocOutputFile = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName, jsdocNameFile);
+                const internalJsdocConfigPath = (0, path_1.resolve)(cmdRoot, "../../jsdoc.conf.json");
+                const jsonFile2 = await (0, utils_1.getJSONFile)(internalJsdocConfigPath);
+                const includePath = (0, path_1.resolve)(cwd, useCasesSrc);
+                jsonFile2.source.include = [includePath];
+                const packageRootPath = (0, path_1.resolve)(cwd, target.packageRoot);
+                const jsdocConfigPath = (0, path_1.resolve)(packageRootPath, "jsdoc.conf.json");
+                await promises_1.default.writeFile(jsdocConfigPath, JSON.stringify(jsonFile2, null, 2));
+                await (0, utils_1.runCommand)(`./node_modules/.bin/jsdoc --explain -c ${jsdocConfigPath} > ${jsdocOutputFile}`);
+                const testResultsPath = (0, path_1.resolve)(cwd, target.testsResultFile);
+                const testResultsFile = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName, "ctfr-test-results.json");
+                if ((0, utils_1.existsFile)(testResultsPath)) {
+                    const testResults = await (0, utils_1.getJSONFile)(testResultsPath);
+                    await promises_1.default.writeFile(testResultsFile, JSON.stringify(testResults, null, 2));
+                    const newTestResultsFile = (0, path_1.resolve)(documentationPath, ".data-generated", packageRootName, "test-results.json");
+                    (0, converter_1.convertTestJsonFormat)(testResultsFile, newTestResultsFile);
+                }
+                else {
+                    const emptyTestResults = {
+                        "numFailedTestSuites": 0,
+                        "numFailedTests": 0,
+                        "numPassedTestSuites": 0,
+                        "numPassedTests": 0,
+                        "numPendingTestSuites": 0,
+                        "numPendingTests": 0,
+                        "numRuntimeErrorTestSuites": 0,
+                        "numTodoTests": 0,
+                        "numTotalTestSuites": 400,
+                        "numTotalTests": 0,
+                        "startTime": 0,
+                        "success": true,
+                        "testResults": []
+                    };
+                    await promises_1.default.writeFile(testResultsFile, JSON.stringify(emptyTestResults, null, 2));
+                }
+                // Clean up temporary config file
+                await (0, delete_paths_1.deletePaths)([
+                    jsdocConfigPath
+                ]);
+                const useCasesTabName = target.docusaurus?.useCases?.name || 'use-cases';
+                const docusaurusUseCasesPath = (0, path_1.resolve)(documentationPath, "docs", useCasesTabName);
+                let categoryConfigPath = (0, path_1.resolve)(docusaurusUseCasesPath, "_category_.json");
+                let categoryConfig = target.docusaurus?.useCases?.config ? target.docusaurus.useCases.config : DOCUSAURUS_DOMAIN_CONFIG;
+                await (0, delete_paths_1.deletePaths)([docusaurusUseCasesPath]);
+                await (0, utils_1.createFolder)(docusaurusUseCasesPath);
+                await promises_1.default.writeFile(categoryConfigPath, JSON.stringify(categoryConfig, null, 2));
+                const useCasesFolderPath = (0, path_1.resolve)(cwd, useCasesSrc);
+                await (0, generate_use_cases_documentation_1.generateUseCasesDocumentation)({
+                    packageRootName,
+                    title,
+                    documentationPath,
+                    useCasesPath: useCasesFolderPath,
+                    useCasesTabName,
+                    templateDir: (0, path_1.resolve)(cmdRoot, "../reporters/templates"),
+                    cwd,
+                    repoSourceUrl: configFile.repoSourceUrl,
+                });
+            }
+        }
+    });
+}
+//# sourceMappingURL=generate-documentation.js.map

package/bin/commands/generate-documentation.js.map

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

package/bin/commands/generate.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCommandGenerate(program: Command): void;

package/bin/commands/generate.js

@@ -0,0 +1,79 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// generate command — generate docs only, no dev server
+//
+// For CI/CD pipelines:
+//   ultra-reporter generate
+// ---------------------------------------------------------------------------
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommandGenerate = registerCommandGenerate;
+const path = __importStar(require("path"));
+const path_1 = require("path");
+const logger_1 = __importDefault(require("../classes/logger"));
+const reader_1 = require("../config/reader");
+const generate_1 = require("../pipeline/generate");
+const cmdLogger = logger_1.default.createContextLogger('cmd:generate');
+function registerCommandGenerate(program) {
+    program
+        .command('generate')
+        .description('Generate documentation without starting a server')
+        .action(async () => {
+        cmdLogger.info('Starting generate command');
+        const cwd = process.cwd();
+        // Find config
+        const configPath = (0, reader_1.findConfig)(cwd);
+        if (!configPath) {
+            cmdLogger.error('No ultra-reporter.config.json found. Run "npx @imolko/create-ultra-reporter create" first.');
+            process.exit(1);
+        }
+        const configDir = path.dirname(configPath);
+        const cmdRoot = (0, path_1.resolve)(__dirname, '..');
+        try {
+            await (0, generate_1.generateAllDocs)(configDir, cmdRoot);
+            cmdLogger.info('Documentation generated successfully!');
+        }
+        catch (err) {
+            cmdLogger.error('Failed to generate documentation', {
+                message: err instanceof Error ? err.message : String(err),
+            });
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=generate.js.map

package/bin/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,uDAAuD;AACvD,EAAE;AACF,uBAAuB;AACvB,4BAA4B;AAC5B,8EAA8E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAW9E,0DA+BC;AAvCD,2CAA6B;AAC7B,+BAA+B;AAC/B,+DAAuC;AACvC,6CAA8C;AAC9C,mDAAuD;AAEvD,MAAM,SAAS,GAAG,gBAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;AAE7D,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,SAAS,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAE5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE1B,cAAc;QACd,MAAM,UAAU,GAAG,IAAA,mBAAU,EAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS,CAAC,KAAK,CACb,4FAA4F,CAC7F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,IAAA,0BAAe,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC1C,SAAS,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,KAAK,CAAC,kCAAkC,EAAE;gBAClD,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/bin/commands/index.d.ts

@@ -0,0 +1,6 @@
+export { registerCommandInit } from "./init";
+export { registerCommandGenerateDocumentation } from "./generate-documentation";
+export { registerCommandCreate } from "./create";
+export { registerCommandServe } from "./serve";
+export { registerCommandGenerate } from "./generate";
+export { registerCommandBuild } from "./build";

package/bin/commands/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommandBuild = exports.registerCommandGenerate = exports.registerCommandServe = exports.registerCommandCreate = exports.registerCommandGenerateDocumentation = exports.registerCommandInit = void 0;
+var init_1 = require("./init");
+Object.defineProperty(exports, "registerCommandInit", { enumerable: true, get: function () { return init_1.registerCommandInit; } });
+var generate_documentation_1 = require("./generate-documentation");
+Object.defineProperty(exports, "registerCommandGenerateDocumentation", { enumerable: true, get: function () { return generate_documentation_1.registerCommandGenerateDocumentation; } });
+var create_1 = require("./create");
+Object.defineProperty(exports, "registerCommandCreate", { enumerable: true, get: function () { return create_1.registerCommandCreate; } });
+var serve_1 = require("./serve");
+Object.defineProperty(exports, "registerCommandServe", { enumerable: true, get: function () { return serve_1.registerCommandServe; } });
+var generate_1 = require("./generate");
+Object.defineProperty(exports, "registerCommandGenerate", { enumerable: true, get: function () { return generate_1.registerCommandGenerate; } });
+var build_1 = require("./build");
+Object.defineProperty(exports, "registerCommandBuild", { enumerable: true, get: function () { return build_1.registerCommandBuild; } });
+//# sourceMappingURL=index.js.map

package/bin/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":";;;AAAA,+BAA4C;AAAnC,2GAAA,mBAAmB,OAAA;AAC5B,mEAA+E;AAAtE,8IAAA,oCAAoC,OAAA;AAC7C,mCAAgD;AAAvC,+GAAA,qBAAqB,OAAA;AAC9B,iCAA8C;AAArC,6GAAA,oBAAoB,OAAA;AAC7B,uCAAoD;AAA3C,mHAAA,uBAAuB,OAAA;AAChC,iCAA8C;AAArC,6GAAA,oBAAoB,OAAA"}

package/bin/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCommandInit(program: Command): void;

package/bin/commands/init.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommandInit = registerCommandInit;
+const logger_1 = __importDefault(require("../classes/logger"));
+const utils_1 = require("../utils");
+const path_1 = require("path");
+// Crear un logger específico para este comando
+const cmdLogger = logger_1.default.createContextLogger('cmd:init');
+function registerCommandInit(program) {
+    program
+        .command('init')
+        .description('initialize documentation repository')
+        .option("-p, --documentation-path <path>", "Documentation directory", "./documentation")
+        .action(async (options) => {
+        cmdLogger.info('Starting init command');
+        cmdLogger.debug('Local options', options);
+        // validate options
+        if (!options.documentationPath) {
+            cmdLogger.error('Documentation path is required');
+            process.exit(1);
+        }
+        // Check if the documentation folder already exists
+        if ((0, utils_1.existsFolder)(options.documentationPath)) {
+            cmdLogger.info('Documentation folder already exists');
+            cmdLogger.debug('Documentation folder path', { path: options.documentationPath });
+            cmdLogger.info('Command Init completed');
+            process.exit(0);
+        }
+        // Create documentation folder
+        cmdLogger.info('Creating documentation folder');
+        cmdLogger.debug('Documentation folder path', { path: options.documentationPath });
+        try {
+            const cmdRoot = __dirname;
+            const templateDocumentationFolderPath = "../../templates/documentation";
+            const templateDocumentationFolder = (0, path_1.resolve)(cmdRoot, templateDocumentationFolderPath);
+            cmdLogger.debug('Template documentation folder', { templateDocumentationFolder });
+            const copyFilesScriptPath = (0, path_1.resolve)(cmdRoot, "../scripts/copy-files.js");
+            cmdLogger.debug('Copy files script path', { copyFilesScriptPath });
+            await (0, utils_1.runCommand)(`node ${copyFilesScriptPath} ${templateDocumentationFolder} ${options.documentationPath}`);
+            cmdLogger.info('Command Init completed');
+        }
+        catch (error) {
+            cmdLogger.error('Error in command Init', {
+                message: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined
+            });
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/bin/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";;;;;AAYA,kDA4CC;AAvDD,+DAAsC;AACtC,oCAAoD;AACpD,+BAA+B;AAE/B,+CAA+C;AAC/C,MAAM,SAAS,GAAG,gBAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;AAMzD,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CACL,iCAAiC,EACjC,yBAAyB,EACzB,iBAAiB,CAClB;SACA,MAAM,CAAC,KAAK,EAAE,OAAwB,EAAE,EAAE;QACzC,SAAS,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACxC,SAAS,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC1C,mBAAmB;QACnB,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC/B,SAAS,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,mDAAmD;QACnD,IAAI,IAAA,oBAAY,EAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC5C,SAAS,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACtD,SAAS,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAClF,SAAS,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,8BAA8B;QAC9B,SAAS,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAChD,SAAS,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,CAAC;YAC1B,MAAM,+BAA+B,GAAG,+BAA+B,CAAC;YACxE,MAAM,2BAA2B,GAAG,IAAA,cAAO,EAAC,OAAO,EAAE,+BAA+B,CAAC,CAAC;YACtF,SAAS,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,2BAA2B,EAAE,CAAC,CAAC;YAClF,MAAM,mBAAmB,GAAG,IAAA,cAAO,EAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;YACzE,SAAS,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,mBAAmB,EAAE,CAAC,CAAC;YACnE,MAAM,IAAA,kBAAU,EAAC,QAAQ,mBAAmB,IAAI,2BAA2B,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC5G,SAAS,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACvC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxD,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/bin/commands/serve.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCommandServe(program: Command): void;

package/bin/commands/serve.js

@@ -0,0 +1,124 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// serve command — generate docs, assemble Docusaurus, start dev server
+//
+// Single command for daily development:
+//   ultra-reporter serve [--port 3000] [--full]
+//
+// Watches source files and regenerates on change (debounced 500ms).
+// Lazy-installs Docusaurus deps on first run.
+// ---------------------------------------------------------------------------
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommandServe = registerCommandServe;
+const path = __importStar(require("path"));
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+const logger_1 = __importDefault(require("../classes/logger"));
+const reader_1 = require("../config/reader");
+const assembler_1 = require("../scaffold/assembler");
+const doc_assembler_1 = require("../scaffold/doc-assembler");
+const generate_1 = require("../pipeline/generate");
+const utils_1 = require("../utils");
+const cmdLogger = logger_1.default.createContextLogger('cmd:serve');
+/** Promise wrapper around child_process.exec. */
+function execPromise(command, options) {
+    return new Promise((resolve, reject) => {
+        (0, child_process_1.exec)(command, { ...options }, (error, stdout, stderr) => {
+            if (error) {
+                reject(stderr || error.message);
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function registerCommandServe(program) {
+    program
+        .command('serve')
+        .description('Generate documentation and start the dev server')
+        .option('--port <port>', 'Port to serve on', '3000')
+        .option('--full', 'Force full regeneration including JSDoc extraction', false)
+        .action(async (options) => {
+        cmdLogger.info('Starting serve command');
+        const cwd = process.cwd();
+        // Find config
+        const configPath = (0, reader_1.findConfig)(cwd);
+        if (!configPath) {
+            cmdLogger.error('No ultra-reporter.config.json found. Run "npx @imolko/create-ultra-reporter create" first.');
+            process.exit(1);
+        }
+        const configDir = path.dirname(configPath);
+        const docusaurusDir = path.resolve(configDir, '.ultra-reporter', 'docusaurus');
+        const cmdRoot = (0, path_1.resolve)(__dirname, '..');
+        // 1. Assemble/update Docusaurus scaffold if needed
+        const libraryTemplateDir = (0, path_1.resolve)(cmdRoot, '../templates/documentation');
+        (0, assembler_1.assembleScaffold)(configDir, libraryTemplateDir);
+        // 2. Lazy npm install inside Docusaurus dir
+        if (!(0, utils_1.existsFolder)(path.join(docusaurusDir, 'node_modules'))) {
+            cmdLogger.info('Installing Docusaurus dependencies (first run)...');
+            try {
+                await execPromise('npm install', { cwd: docusaurusDir });
+                cmdLogger.info('Dependencies installed.');
+            }
+            catch (err) {
+                cmdLogger.error('Failed to install Docusaurus dependencies');
+                process.exit(1);
+            }
+        }
+        // 3. Generate docs
+        cmdLogger.info('Generating documentation...');
+        await (0, generate_1.generateAllDocs)(configDir, cmdRoot);
+        // 4. Assemble docs into Docusaurus
+        (0, doc_assembler_1.assembleDocs)(configDir);
+        // 5. Start Docusaurus dev server
+        const port = options.port || '3000';
+        cmdLogger.info(`Starting documentation server on port ${port}...`);
+        console.log(`\n📖 Documentation server starting at http://localhost:${port}\n`);
+        const docusaurusStart = (0, child_process_1.exec)(`npx docusaurus start --port ${port} --no-open`, { cwd: docusaurusDir });
+        docusaurusStart.stdout?.pipe(process.stdout);
+        docusaurusStart.stderr?.pipe(process.stderr);
+        docusaurusStart.on('exit', (code) => {
+            if (code !== 0) {
+                cmdLogger.error(`Docusaurus exited with code ${code}`);
+                process.exit(code || 1);
+            }
+        });
+    });
+}
+//# sourceMappingURL=serve.js.map

package/bin/commands/serve.js.map

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