@imolko/create-ultra-reporter 2.1.23-beta

package/README.md

@@ -0,0 +1,219 @@
+## Quick Start
+
+```bash
+# One-time setup (interactive wizard)
+npm create @imolko/ultra-reporter
+
+# Daily workflow
+npm run docs:serve     # Generate docs + start dev server at http://localhost:3000
+npm run docs:gen       # Generate docs only (CI/CD)
+npm run docs:build     # Production static build
+```
+
+The wizard auto-detects your project structure and asks a few questions with smart defaults. After setup, everything lives in:
+
+| Location | Purpose | Git |
+|---|---|---|
+| `ultra-reporter.config.json` | Your configuration | ✅ Commit |
+| `docs/` | Your manual markdown files | ✅ Commit |
+| `.ultra-reporter/` | Generated docs + Docusaurus internals | ❌ Gitignored |
+| `.ultra-reporter-overrides/` | Optional theme customizations | ✅ Commit |
+
+## Command Reference
+
+### `ultra-reporter create`
+
+Interactive wizard to configure ultra-reporter. Can also be run non-interactively:
+
+```bash
+ultra-reporter create \
+  --domain-name sentinel \
+  --domain-src ./domain/src \
+  --use-cases-src ./features/src \
+  --docs-path ./docs \
+  --repo-source-url https://github.com/myorg/myrepo
+```
+
+### `ultra-reporter serve [--port 3000] [--full]`
+
+Generates documentation, assembles the Docusaurus site, installs dependencies (first run), and starts the dev server. Watches source files for changes.
+
+- `--port`: Port to serve on (default: 3000)
+- `--full`: Force full regeneration including JSDoc extraction (slower)
+
+### `ultra-reporter generate`
+
+Generates documentation without starting a server. Useful for CI/CD pipelines.
+
+### `ultra-reporter build [--output ./public]`
+
+Generates documentation and produces a static production build. Output goes to `.ultra-reporter/build/` by default, configurable via `--output`.
+
+## Configuration
+
+`ultra-reporter.config.json` at your project root:
+
+```json
+{
+  "repoSourceUrl": "https://github.com/myorg/myrepo",
+  "domain": {
+    "name": "sentinel",
+    "srcPath": "./domain/src",
+    "testResultsPath": "./domain/ctrf.json"
+  },
+  "useCases": {
+    "title": "Sentinel Use Cases",
+    "srcPath": "./features/src",
+    "testResultsPath": "./features/ctrf.json"
+  },
+  "docs": {
+    "path": "./docs"
+  }
+}
+```
+
+Only `domain.name` and `domain.srcPath` are required. All other fields are optional.
+
+### Test Integration
+
+If you use Jest, the wizard can install and configure `jest-ctrf-json-reporter` automatically. This adds a `reporters` entry to your jest config:
+
+```js
+reporters: [
+  "default",
+  ["jest-ctrf-json-reporter", { outputDir: ".", outputFile: "ctrf.json" }]
+]
+```
+
+Run your tests before generating docs:
+
+```bash
+npm run test
+```
+
+### Manual Docs
+
+Place `.md` files in your configured `docs/` folder. They'll appear in the documentation site under the "Documentation" section.
+
+### Customization
+
+For advanced customization, create a `.ultra-reporter-overrides/` folder:
+
+```
+.ultra-reporter-overrides/
+├── docusaurus.config.override.ts   # Merged with generated config
+├── custom.css                       # Additional CSS
+├── components/                      # Custom React components
+└── static/                          # Extra static assets (logos, favicon)
+```
+
+## Old Workflow (deprecated)
+
+The previous workflow using `init` and `generate-documentation` commands is still available but deprecated. New projects should use the `create` → `serve`/`generate`/`build` workflow.
+
+## Consideraciones
+
+1. El generador escanea todos los archivos `.md` dentro de cada carpeta de artefacto y extrae el frontmatter de cada uno. El metadata se mergea combinando todos los `.md`, y sus cuerpos se concatenan en orden alfabético para formar la documentación del artefacto. Se recomienda usar `README.md` como nombre para el archivo de explicación, siguiendo el mismo patrón que GitHub y GitLab usan en sus exploradores online.
+
+2. El archivo `definition.yaml` **ya no es requerido**. Si existe, se carga como metadata base, y el frontmatter de los `.md` lo sobrescribe. Para proyectos nuevos, toda la metadata puede declararse directamente como frontmatter en los archivos `.md`.
+
+3. Este generador asume que la estructura de los archivos en la carpeta de cada artefacto hace uso del paquete `@imolko/ultra-ddd` y por tanto tiene una estructura como la siguiente:
+
+```plaintext
+domain
+├── src
+│   ├── Artifact1
+│   │   ├── README.md
+│   │   ├── conditions.ts
+│   │   ├── definition.ts
+│   │   ├── entity.spec.ts
+│   │   ├── entity.ts
+│   │   ├── index.ts
+│   │   ├── payload.ts
+│   │   ├── primitive.ts
+│   │   ├── props.ts
+│   └── Artifact2
+│   │   ├── ...
+└── README.md
+```
+
+Los archivos `.md` contienen la documentación de los artefactos a través de su frontmatter y cuerpo. Es importante que estén presentes y bien documentados.
+
+4. En la carpeta `documentation` se generan los archivos relacionados con la documentacion de los artefactos y una introducccion al contexto.
+
+5. Dentro de `documentation` hay archivos que deben ser editados para ajustarlos a cada contexto, como:
+
+- `/documentation/docusaurus.config.ts`
+
+6. Dentro de `documentation` se pueden generar paginas y blogs para documentar de forma manual otros aspectos del contexto. Vea [Docusaurus](https://docusaurus.io/docs/)
+
+---
+
+## 🛠 Desarrollo del generador (para contributors)
+
+Si vas a modificar las plantillas o scripts que generan la documentación, usa este flujo para iterar rápidamente.
+
+### Arquitectura
+
+El generador tiene **dos capas** que producen la documentación final:
+
+| Capa | Qué controla | Dónde editar |
+|---|---|---|
+| **1. Contenido `.md`** | Layout de páginas de artefactos y use-cases, estructura de cards, estilos inline de los docs generados | `src/reporters/rendering.ts` (templates), `src/reporters/generate-*.ts` (orquestadores), `src/reporters/data-*.ts` (carga y transformación) |
+| **2. Sitio Docusaurus** | CSS, branding, navbar, footer, landing page, sidebar | `templates/documentation/` |
+
+#### Detalle de archivos — Capa 1
+
+| Archivo | Función |
+|---|---|
+| `src/reporters/rendering.ts` | Templates hardcodeados de las páginas de artefacto y use-case, panels de test, tabla de propiedades, definiciones de métodos. **Acá se editan los estilos visuales.** |
+| `src/reporters/generate-domain-documentation.ts` | Orquestador del pipeline domain: load → transform → render → write |
+| `src/reporters/generate-use-cases-documentation.ts` | Orquestador del pipeline use-cases |
+| `src/reporters/data-loading.ts` | Carga de artifacts, JSDoc, test results, frontmatter de `.md` (y `definition.yaml` legacy) |
+| `src/reporters/data-transformation.ts` | Enriquecimiento: match JSDoc ↔ artifacts, merge de datos |
+| `src/reporters/file-writing.ts` | Escritura de archivos `.md` generados |
+| `src/reporters/types.ts` | Tipos compartidos entre todas las capas |
+| `src/scripts/labels.ts` | Labels HTML para tags (type, model status, test status) |
+| `src/scripts/markdown.ts` | Utilidades de formato markdown |
+| `templates/track-artifacts-script.ts` | Template del script que descubre artefactos del dominio |
+
+#### Detalle de archivos — Capa 2
+
+| Archivo | Función |
+|---|---|
+| `templates/documentation/docusaurus.config.ts` | Config del sitio: título, navbar, footer, Mermaid |
+| `templates/documentation/src/css/custom.css` | Variables de color, estilos globales |
+| `templates/documentation/src/pages/index.tsx` | Landing page |
+| `templates/documentation/src/pages/index.module.css` | Estilos de la landing page |
+| `templates/documentation/sidebars.ts` | Configuración de sidebar |
+| `templates/documentation/static/` | Assets estáticos (imágenes, favicon) |
+
+### Scripts de desarrollo
+
+```bash
+# Terminal A — Arranca el servidor (solo una vez)
+./bootstrap_fixture.sh
+# → Genera docs del fixture, copia scaffold Docusaurus, instala deps, inicia en http://localhost:3000
+```
+
+```bash
+# Terminal B — Regenera los .md después de editar archivos de Capa 1
+./regenerate_fixture_docs.sh
+# → Docusaurus hace hot-reload automático en el navegador
+```
+
+| Editaste... | Comando |
+|---|---|
+| `src/reporters/rendering.ts` | `./regenerate_fixture_docs.sh` |
+| `src/reporters/generate-*.ts` | `./regenerate_fixture_docs.sh` |
+| `src/reporters/data-*.ts` | `./regenerate_fixture_docs.sh` |
+| `src/reporters/file-writing.ts` | `./regenerate_fixture_docs.sh` |
+| `src/scripts/labels.ts` | `./regenerate_fixture_docs.sh` |
+| `src/scripts/markdown.ts` | `./regenerate_fixture_docs.sh` |
+| `templates/documentation/src/**` | Nada (hot-reload automático) |
+| `templates/documentation/docusaurus.config.ts` | Nada (hot-reload automático) |
+| Archivos nuevos en `templates/documentation/` | Borrar `__fixtures__/minimal-project/documentation/` y re-ejecutar `./bootstrap_fixture.sh` |
+
+### Documentación detallada
+
+Para una explicación completa de la arquitectura y el flujo de trabajo, consultá: [`docs/developer-workflow.md`](docs/developer-workflow.md)

package/bin/classes/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/bin/classes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":""}

package/bin/classes/logger.d.ts

@@ -0,0 +1,42 @@
+interface LoggerOptions {
+    enabled?: boolean;
+    level?: string;
+    context?: string;
+}
+interface LogMetadata {
+    [key: string]: any;
+    context?: string;
+}
+declare class Logger {
+    private initialized;
+    private logger;
+    private enabled;
+    private level;
+    private globalContext;
+    constructor();
+    initialize(options?: LoggerOptions): Logger;
+    get isInitialized(): boolean;
+    private getColorizedLevel;
+    log(level: string, message: string, meta?: LogMetadata): void;
+    error(message: string, meta?: LogMetadata): void;
+    warn(message: string, meta?: LogMetadata): void;
+    info(message: string, meta?: LogMetadata): void;
+    debug(message: string, meta?: LogMetadata): void;
+    verbose(message: string, meta?: LogMetadata): void;
+    setEnabled(enabled: boolean): void;
+    setLevel(level: string): void;
+    createContextLogger(context: string): ContextLogger;
+}
+declare class ContextLogger {
+    private logger;
+    private context;
+    constructor(logger: Logger, context: string);
+    error(message: string, meta?: LogMetadata): void;
+    warn(message: string, meta?: LogMetadata): void;
+    info(message: string, meta?: LogMetadata): void;
+    debug(message: string, meta?: LogMetadata): void;
+    verbose(message: string, meta?: LogMetadata): void;
+    setContext(context: string): void;
+}
+declare const loggerInstance: Logger;
+export default loggerInstance;

package/bin/classes/logger.js

@@ -0,0 +1,185 @@
+"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 });
+const winston_1 = __importStar(require("winston"));
+const chalk_1 = __importDefault(require("chalk"));
+// Configuración de colores para diferentes niveles de log
+const colors = {
+    error: 'red',
+    warn: 'yellow',
+    info: 'green',
+    debug: 'blue',
+    verbose: 'magenta'
+};
+class Logger {
+    constructor() {
+        this.initialized = false;
+        this.logger = null;
+        this.enabled = true;
+        this.level = 'info';
+        this.globalContext = 'app';
+        // Constructor intencionalmente vacío para el singleton
+    }
+    // Método de inicialización que acepta opciones de configuración
+    initialize(options = {}) {
+        if (this.initialized) {
+            return this;
+        }
+        this.enabled = options.enabled !== false;
+        this.level = options.level || 'info';
+        this.globalContext = options.context || 'app';
+        // Crear el logger con Winston
+        this.logger = winston_1.default.createLogger({
+            level: this.level,
+            format: winston_1.format.combine(winston_1.format.timestamp({
+                format: 'YYYY-MM-DD HH:mm:ss'
+            }), winston_1.format.printf(info => {
+                const { timestamp, level, message, context, ...rest } = info;
+                const colorizedLevel = this.getColorizedLevel(level);
+                const contextStr = context ? chalk_1.default.cyan(`[${context}]`) : '';
+                // Extraer metadatos sin contexto para evitar duplicación
+                const { context: _, ...metadata } = rest;
+                const metadataStr = Object.keys(metadata).length ?
+                    chalk_1.default.gray(` ${JSON.stringify(metadata)}`) : '';
+                return `${chalk_1.default.gray(timestamp)} ${colorizedLevel} ${contextStr}: ${message}${metadataStr}`;
+            })),
+            transports: [
+                new winston_1.default.transports.Console({
+                    silent: !this.enabled
+                })
+            ]
+        });
+        // Marcar como inicializado
+        this.initialized = true;
+        return this;
+    }
+    // Getter para verificar estado de inicialización
+    get isInitialized() {
+        return this.initialized;
+    }
+    // Colorear el nivel de log según su tipo
+    getColorizedLevel(level) {
+        const color = colors[level] || 'white';
+        return chalk_1.default[color].bold(`[${level.toUpperCase()}]`);
+    }
+    // Método para registrar mensajes - verifica inicialización primero
+    log(level, message, meta = {}) {
+        if (!this.initialized) {
+            console.warn('Logger no inicializado. Llamando a initialize() con valores predeterminados...');
+            this.initialize();
+        }
+        // Asegurar que context siempre exista en los metadatos
+        const context = meta.context || this.globalContext;
+        this.logger?.log(level, message, { ...meta, context });
+    }
+    // Métodos convenientes para cada nivel de log
+    error(message, meta = {}) {
+        this.log('error', message, meta);
+    }
+    warn(message, meta = {}) {
+        this.log('warn', message, meta);
+    }
+    info(message, meta = {}) {
+        this.log('info', message, meta);
+    }
+    debug(message, meta = {}) {
+        this.log('debug', message, meta);
+    }
+    verbose(message, meta = {}) {
+        this.log('verbose', message, meta);
+    }
+    // Habilitar o deshabilitar los logs
+    setEnabled(enabled) {
+        if (!this.initialized) {
+            this.initialize({ enabled });
+            return;
+        }
+        this.enabled = enabled;
+        this.logger?.transports.forEach(transport => {
+            if (transport instanceof winston_1.default.transports.Console) {
+                transport.silent = !enabled;
+            }
+        });
+    }
+    // Cambiar el nivel de log
+    setLevel(level) {
+        if (!this.initialized) {
+            this.initialize({ level });
+            return;
+        }
+        this.level = level;
+        if (this.logger) {
+            this.logger.level = level;
+        }
+    }
+    // Crear una instancia de logger con contexto específico
+    createContextLogger(context) {
+        return new ContextLogger(this, context);
+    }
+}
+// Clase para logger con contexto
+class ContextLogger {
+    constructor(logger, context) {
+        this.logger = logger;
+        this.context = context;
+    }
+    error(message, meta = {}) {
+        this.logger.error(message, { ...meta, context: this.context });
+    }
+    warn(message, meta = {}) {
+        this.logger.warn(message, { ...meta, context: this.context });
+    }
+    info(message, meta = {}) {
+        this.logger.info(message, { ...meta, context: this.context });
+    }
+    debug(message, meta = {}) {
+        this.logger.debug(message, { ...meta, context: this.context });
+    }
+    verbose(message, meta = {}) {
+        this.logger.verbose(message, { ...meta, context: this.context });
+    }
+    // Método para cambiar el contexto
+    setContext(context) {
+        this.context = context;
+    }
+}
+// Crear la instancia singleton
+const loggerInstance = new Logger();
+// Exportar la instancia singleton
+exports.default = loggerInstance;
+//# sourceMappingURL=logger.js.map

package/bin/classes/logger.js.map

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

package/bin/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const logger_1 = __importDefault(require("./classes/logger"));
+const commands_1 = require("./commands");
+// Create a specific logger for the main CLI
+const cliLogger = logger_1.default.createContextLogger('cli');
+commander_1.program
+    .version("1.0.0")
+    .description("Ultra Reporter CLI")
+    .option('-d, --debug', 'enable debug logs')
+    .option('-s, --silent', 'disable all logs')
+    .option('-l, --log-level <level>', 'log level (error, warn, info, debug, verbose)', 'info')
+    .hook("preAction", async () => {
+    // Initialize logger based on global options before any command
+    const options = commander_1.program.opts();
+    logger_1.default.initialize({
+        enabled: !options.silent,
+        level: options.debug ? 'debug' : options.logLevel,
+        context: 'app' // Default global context
+    });
+    cliLogger.info('CLI initialized');
+    cliLogger.debug('CLI options', options);
+})
+    .action(async (options) => {
+});
+// Custom help command
+commander_1.program.on("--help", () => {
+    console.log("");
+    console.log("Examples:");
+    console.log("\t\t$ npx @imolko/create-ultra-reporter -d -p documentation"); // Enable debug logs
+    console.log("\t\t$ npx @imolko/create-ultra-reporter -s -p documentation"); // Disable all logs
+    console.log("\t\t$ npx @imolko/create-ultra-reporter -l debug -p documentation"); // Set log level
+    console.log("\t\t$ npx @imolko/create-ultra-reporter -c my-config.json");
+});
+// Register modular commands
+(0, commands_1.registerCommandInit)(commander_1.program);
+(0, commands_1.registerCommandGenerateDocumentation)(commander_1.program);
+(0, commands_1.registerCommandCreate)(commander_1.program);
+(0, commands_1.registerCommandServe)(commander_1.program);
+(0, commands_1.registerCommandGenerate)(commander_1.program);
+(0, commands_1.registerCommandBuild)(commander_1.program);
+commander_1.program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AACA,yCAAmC;AACnC,8DAAqC;AACrC,yCAAkL;AAGlL,4CAA4C;AAC5C,MAAM,SAAS,GAAG,gBAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpD,mBAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,oBAAoB,CAAC;KACjC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC;KAC1C,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC;KAC1C,MAAM,CAAC,yBAAyB,EAAE,+CAA+C,EAAE,MAAM,CAAC;KAC1F,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;IAC5B,+DAA+D;IAC/D,MAAM,OAAO,GAAG,mBAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,gBAAM,CAAC,UAAU,CAAC;QAChB,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAkB;QAC3D,OAAO,EAAE,KAAK,CAAC,yBAAyB;KACzC,CAAC,CAAC;IACH,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAClC,SAAS,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC;KACD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;AAE1B,CAAC,CAAC,CAAC;AAEL,sBAAsB;AACtB,mBAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC,CAAC,oBAAoB;IAChG,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC,CAAC,mBAAmB;IAC/F,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC,CAAC,gBAAgB;IAClG,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;AAC3E,CAAC,CAAC,CAAC;AAEH,4BAA4B;AAC5B,IAAA,8BAAmB,EAAC,mBAAO,CAAC,CAAA;AAC5B,IAAA,+CAAoC,EAAC,mBAAO,CAAC,CAAA;AAC7C,IAAA,gCAAqB,EAAC,mBAAO,CAAC,CAAA;AAC9B,IAAA,+BAAoB,EAAC,mBAAO,CAAC,CAAA;AAC7B,IAAA,kCAAuB,EAAC,mBAAO,CAAC,CAAA;AAChC,IAAA,+BAAoB,EAAC,mBAAO,CAAC,CAAA;AAE7B,mBAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/commands/build.d.ts

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