docviz-builder 0.1.0

package/dist/build/skill.js

@@ -0,0 +1,63 @@
+/**
+ * Instalacion del contrato de DocViz como skill de agente.
+ *
+ * `docviz init` deja un `AGENTS.md` en el proyecto, y eso basta para los
+ * agentes que lo leen solos. Pero un agente solo abre `AGENTS.md` si ya esta
+ * trabajando en ese repositorio: no hay forma de que sepa que DocViz existe
+ * antes de eso. Un skill instalado —en el proyecto o en el perfil del usuario—
+ * lo pone en su radar desde el primer mensaje.
+ */
+import { copyFile, mkdir, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DocVizError, ERROR_CODES } from '../core/errors.js';
+/** Fuente del skill dentro del propio paquete. */
+export function skillSourcePath() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // dist/build/skill.js -> raiz del paquete
+    return path.resolve(here, '..', '..', 'skills', 'docviz', 'SKILL.md');
+}
+/**
+ * Directorio donde el agente busca sus skills.
+ *
+ * Se admite `dir` explicito porque cada agente elige el suyo y esa lista
+ * cambia mas rapido que este paquete: fijarla aqui garantizaria quedarse
+ * desactualizado.
+ */
+export function skillTargetDir(options) {
+    if (options.dir !== undefined)
+        return path.resolve(options.cwd, options.dir);
+    const base = options.global === true ? homedir() : options.cwd;
+    return path.join(base, '.claude', 'skills');
+}
+export async function installSkill(options) {
+    const origen = skillSourcePath();
+    if (!existsSync(origen)) {
+        throw new DocVizError('el paquete no incluye el skill', {}, `se esperaba en ${origen}`, ERROR_CODES.CONFIG);
+    }
+    const destino = path.join(skillTargetDir(options), 'docviz', 'SKILL.md');
+    if (existsSync(destino) && options.force !== true) {
+        return { destino, escrito: false, motivo: 'ya existe' };
+    }
+    await mkdir(path.dirname(destino), { recursive: true });
+    await copyFile(origen, destino);
+    return { destino, escrito: true };
+}
+/** Informe legible de la instalacion. */
+export function formatearSkill(result) {
+    if (!result.escrito) {
+        return (`\nel skill ya estaba instalado en ${result.destino}\n` +
+            '  (usa --force para sobrescribirlo)\n\n');
+    }
+    return (`\nskill instalado en ${result.destino}\n\n` +
+        'A partir de ahora tu agente sabe que DocViz existe y como usarlo.\n' +
+        'Para el catalogo completo de los 57 tipos, ejecuta `docviz init` en el\n' +
+        'proyecto: deja un AGENTS.md con las tablas de decision.\n\n');
+}
+/** Contenido del skill, para comprobar que sigue siendo valido. */
+export async function readSkill() {
+    return readFile(skillSourcePath(), 'utf8');
+}
+//# sourceMappingURL=skill.js.map

package/dist/build/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/build/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoB7D,kDAAkD;AAClD,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,0CAA0C;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAqB;IACtD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,WAAW,CACnB,gCAAgC,EAChC,EAAE,EACF,kBAAkB,MAAM,EAAE,EAC1B,WAAW,CAAC,MAAM,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzE,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CACL,qCAAqC,MAAM,CAAC,OAAO,IAAI;YACvD,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IACD,OAAO,CACL,wBAAwB,MAAM,CAAC,OAAO,MAAM;QAC5C,qEAAqE;QACrE,0EAA0E;QAC1E,6DAA6D,CAC9D,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,QAAQ,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/build/verify.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Verificacion del Markdown ya compilado.
+ *
+ * Responde a la pregunta del criterio de aceptacion "no hay imagenes rotas":
+ * cada referencia de imagen del documento debe existir en disco, ser relativa y
+ * quedar dentro del directorio de salida.
+ */
+export interface VerifyIssue {
+    file: string;
+    line: number;
+    url: string;
+    reason: string;
+}
+export interface VerifyResult {
+    documents: number;
+    images: number;
+    /** Bloques declarativos que quedaron sin compilar en la salida. */
+    residualBlocks: Array<{
+        file: string;
+        line: number;
+        lang: string;
+    }>;
+    issues: VerifyIssue[];
+}
+export declare function verify(outputDir: string): Promise<VerifyResult>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/build/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/build/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAqBD,wBAAsB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAwErE"}

package/dist/build/verify.js

@@ -0,0 +1,99 @@
+/**
+ * Verificacion del Markdown ya compilado.
+ *
+ * Responde a la pregunta del criterio de aceptacion "no hay imagenes rotas":
+ * cada referencia de imagen del documento debe existir en disco, ser relativa y
+ * quedar dentro del directorio de salida.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { visit } from 'unist-util-visit';
+import { parseMarkdown } from '../markdown/scan.js';
+import { collectMarkdown } from './builder.js';
+import { toPosix } from '../core/paths.js';
+const DECLARATIVE_LANGS = new Set([
+    'plantuml',
+    'puml',
+    'uml',
+    'mermaid',
+    'mmd',
+    'd2',
+    'graphviz',
+    'dot',
+    'vega-lite',
+    'vegalite',
+    'vl',
+    'likec4',
+    'c4',
+    'diagram',
+    'chart',
+    'architecture',
+]);
+export async function verify(outputDir) {
+    const files = await collectMarkdown(outputDir);
+    const result = { documents: files.length, images: 0, residualBlocks: [], issues: [] };
+    for (const file of files) {
+        const relative = toPosix(path.relative(outputDir, file));
+        const text = await readFile(file, 'utf8');
+        const tree = parseMarkdown(text);
+        const images = [];
+        visit(tree, 'image', (node) => {
+            images.push({ url: node.url, line: node.position?.start.line ?? 0, alt: node.alt ?? null });
+        });
+        visit(tree, 'code', (node) => {
+            const lang = (node.lang ?? '').trim().toLowerCase();
+            if (DECLARATIVE_LANGS.has(lang)) {
+                result.residualBlocks.push({ file: relative, line: node.position?.start.line ?? 0, lang });
+            }
+        });
+        for (const image of images) {
+            result.images += 1;
+            const { url } = image;
+            if (/^[a-z][a-z0-9+.-]*:/i.test(url)) {
+                if (!url.startsWith('data:')) {
+                    result.issues.push({
+                        file: relative,
+                        line: image.line,
+                        url,
+                        reason: 'la imagen usa una URL absoluta en lugar de una ruta relativa',
+                    });
+                }
+                continue;
+            }
+            if (url.startsWith('/')) {
+                result.issues.push({
+                    file: relative,
+                    line: image.line,
+                    url,
+                    reason: 'la ruta de la imagen es absoluta; el documento dejaria de funcionar al moverlo',
+                });
+                continue;
+            }
+            const clean = decodeURIComponent(url.replace(/^<|>$/g, '').split('#')[0].split('?')[0]);
+            const target = path.resolve(path.dirname(file), clean);
+            if (path.relative(outputDir, target).startsWith('..')) {
+                result.issues.push({
+                    file: relative,
+                    line: image.line,
+                    url,
+                    reason: 'la imagen apunta fuera del directorio de salida',
+                });
+                continue;
+            }
+            try {
+                const info = await stat(target);
+                if (!info.isFile() || info.size === 0) {
+                    result.issues.push({ file: relative, line: image.line, url, reason: 'el recurso existe pero esta vacio' });
+                }
+            }
+            catch {
+                result.issues.push({ file: relative, line: image.line, url, reason: 'el recurso no existe' });
+            }
+            if (image.alt === null || image.alt.trim() === '') {
+                result.issues.push({ file: relative, line: image.line, url, reason: 'la imagen no tiene texto alternativo' });
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=verify.js.map

package/dist/build/verify.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Interfaz de linea de comandos (seccion 17).
+ *
+ *   docviz build <source> --output <target> [--theme ...] [--clean] ...
+ *   docviz check <source>
+ *   docviz diff <base> <head>
+ *   docviz setup
+ *   docviz skill
+ *   docviz fix <archivo>
+ *   docviz verify <output>
+ *   docviz preview <output>
+ *   docviz types
+ */
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+/** Ficha legible de un tipo, con su ejemplo listo para copiar. */
+/** Idiomas en los que se puede leer el catalogo. */
+export type Idioma = 'es' | 'en';
+export declare function run(argv?: readonly string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC,wBAAgB,aAAa,IAAI,OAAO,CAkXvC;AAED,kEAAkE;AAClE,oDAAoD;AACpD,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAgEjC,wBAAsB,GAAG,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBjF"}

package/dist/cli.js

@@ -0,0 +1,427 @@
+/**
+ * Interfaz de linea de comandos (seccion 17).
+ *
+ *   docviz build <source> --output <target> [--theme ...] [--clean] ...
+ *   docviz check <source>
+ *   docviz diff <base> <head>
+ *   docviz setup
+ *   docviz skill
+ *   docviz fix <archivo>
+ *   docviz verify <output>
+ *   docviz preview <output>
+ *   docviz types
+ */
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { promisify } from 'node:util';
+import { Command } from 'commander';
+import { build, check } from './build/builder.js';
+import { diff, formatDiff, hasChanges } from './build/diff.js';
+import { diagnosticar, formatearDiagnostico } from './build/doctor.js';
+import { init, formatearInit } from './build/init.js';
+import { startPreview } from './build/preview.js';
+import { installSkill, formatearSkill } from './build/skill.js';
+import { fixBlock } from './mcp/tools.js';
+import { verify } from './build/verify.js';
+import { loadConfig, resolveFromRoot } from './config/load.js';
+import { BuildFailedError, DocVizError } from './core/errors.js';
+import { dslCatalog, findType, TYPE_CATALOG } from './dsl/index.js';
+import { suggestType } from './mcp/tools.js';
+import { themeNames } from './themes/index.js';
+const VERSION = '0.1.0';
+const ejecutar = promisify(execFile);
+/** Lee el bloque de la entrada estandar, para encadenarlo con otro comando. */
+async function leerEntrada() {
+    const trozos = [];
+    for await (const trozo of process.stdin)
+        trozos.push(Buffer.from(trozo));
+    return Buffer.concat(trozos).toString('utf8');
+}
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('docviz')
+        .description('Compila bloques declarativos de diagramas dentro de Markdown a imagenes SVG/PNG.')
+        .version(VERSION);
+    program
+        .command('build')
+        .description('compila los documentos de <source> hacia el directorio de salida')
+        .argument('[source]', 'directorio de documentos fuente')
+        .option('-o, --output <dir>', 'directorio de salida')
+        .option('-t, --theme <name>', `tema visual (${themeNames().join(', ')})`)
+        .option('-c, --config <file>', 'archivo de configuracion')
+        .option('--clean', 'borra el directorio de salida antes de compilar', false)
+        .option('--verbose', 'muestra cada diagrama procesado', false)
+        .option('--no-cache', 'ignora el cache y vuelve a renderizar todo')
+        .option('--renderer-url <url>', 'URL de una instancia Kroki self-hosted')
+        .option('--backend <backend>', 'backend por defecto: local | kroki')
+        .option('--continue-on-error', 'no aborta ante un diagrama invalido', false)
+        .action(async (source, opts) => {
+        const config = await loadConfig({
+            configPath: opts.config,
+            overrides: {
+                ...(source !== undefined ? { source } : {}),
+                ...(opts.output !== undefined ? { output: opts.output } : {}),
+                ...(opts.theme !== undefined ? { theme: opts.theme } : {}),
+                ...(opts.cache === false ? { cacheEnabled: false } : {}),
+                ...(opts.rendererUrl !== undefined ? { krokiUrl: opts.rendererUrl } : {}),
+                ...(opts.backend !== undefined ? { backend: opts.backend } : {}),
+            },
+        });
+        const started = Date.now();
+        const result = await build(config, {
+            clean: opts.clean,
+            verbose: opts.verbose,
+            continueOnError: opts.continueOnError,
+            onLog: (m) => process.stdout.write(`${m}\n`),
+        });
+        const elapsed = ((Date.now() - started) / 1000).toFixed(1);
+        process.stdout.write([
+            '',
+            `documentos:      ${result.stats.documents}`,
+            `diagramas:       ${result.stats.blocks}`,
+            `regenerados:     ${result.stats.generated}`,
+            `cache hits:      ${result.stats.cacheHits}`,
+            `salida:          ${path.relative(process.cwd(), resolveFromRoot(config, config.output))}`,
+            `tema:            ${config.theme.name}`,
+            `tiempo:          ${elapsed}s`,
+            '',
+        ].join('\n'));
+        escribirAvisos(result.warnings);
+        if (result.errors.length > 0) {
+            process.stderr.write(`\n${result.errors.map((e) => e.format()).join('\n\n')}\n`);
+            process.stderr.write(`\n${result.errors.length} diagrama(s) fallaron (--continue-on-error activo)\n`);
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command('check')
+        .description('valida los bloques declarativos sin renderizar')
+        .argument('[source]', 'directorio de documentos fuente')
+        .option('-c, --config <file>', 'archivo de configuracion')
+        .option('--verbose', 'lista cada bloque detectado', false)
+        .action(async (source, opts) => {
+        const config = await loadConfig({
+            configPath: opts.config,
+            overrides: source !== undefined ? { source } : {},
+        });
+        const result = await check(config);
+        if (opts.verbose === true) {
+            for (const f of result.findings) {
+                process.stdout.write(`  ${f.file}:${f.line}  ${f.lang} -> ${f.rendererType}  "${f.title}"\n`);
+            }
+        }
+        // El conteo distingue los bloques que compilan de los que no: decir
+        // "bloques: 0" cuando habia tres rotos oculta justo lo que hay que ver.
+        const invalidos = result.invalidBlocks > 0 ? `  (${result.invalidBlocks} invalido(s))` : '';
+        process.stdout.write(`\ndocumentos: ${result.documents}\nbloques:    ${result.blocks}${invalidos}\n` +
+            `avisos:     ${result.warnings.length}\nerrores:    ${result.errors.length}\n`);
+        escribirAvisos(result.warnings);
+        if (result.errors.length > 0) {
+            process.stderr.write(`\n${result.errors.map((e) => e.format()).join('\n\n')}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write('\ncheck OK\n');
+    });
+    program
+        .command('diff')
+        .description('compara los diagramas de dos versiones de la documentacion')
+        .argument('<base>', 'directorio de la version anterior')
+        .argument('<head>', 'directorio de la version nueva')
+        .option('-c, --config <file>', 'archivo de configuracion')
+        .option('--all', 'incluye tambien los diagramas que no cambiaron', false)
+        .option('--json', 'salida en JSON', false)
+        .option('--exit-code', 'termina con codigo 1 si algo cambio, como git diff', false)
+        .action(async (base, head, opts) => {
+        const config = await loadConfig(opts.config !== undefined ? { configPath: opts.config } : {});
+        const result = await diff(config, path.resolve(base), path.resolve(head));
+        process.stdout.write(opts.json === true ? `${JSON.stringify(result, null, 2)}\n` : formatDiff(result, { all: opts.all }));
+        if (opts.exitCode === true && hasChanges(result))
+            process.exitCode = 1;
+    });
+    program
+        .command('verify')
+        .description('comprueba que el Markdown compilado no tenga imagenes rotas')
+        .argument('[output]', 'directorio de salida a verificar')
+        .option('-c, --config <file>', 'archivo de configuracion')
+        .action(async (output, opts) => {
+        const config = await loadConfig({
+            configPath: opts.config,
+            overrides: output !== undefined ? { output } : {},
+        });
+        const dir = resolveFromRoot(config, config.output);
+        const result = await verify(dir);
+        process.stdout.write(`\ndocumentos: ${result.documents}\nimagenes:   ${result.images}\nproblemas:  ${result.issues.length}\n`);
+        for (const block of result.residualBlocks) {
+            process.stderr.write(`AVISO ${block.file}:${block.line} quedo un bloque "${block.lang}" sin compilar en la salida\n`);
+        }
+        if (result.issues.length > 0) {
+            for (const issue of result.issues) {
+                process.stderr.write(`ERROR ${issue.file}:${issue.line} ${issue.url} -> ${issue.reason}\n`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (result.residualBlocks.length > 0) {
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write('\nverify OK\n');
+    });
+    program
+        .command('preview')
+        .description('sirve el Markdown compilado para revisarlo visualmente')
+        .argument('[output]', 'directorio de salida a servir')
+        .option('-c, --config <file>', 'archivo de configuracion')
+        .option('-p, --port <port>', 'puerto', '4321')
+        .action(async (output, opts) => {
+        const config = await loadConfig({
+            configPath: opts.config,
+            overrides: output !== undefined ? { output } : {},
+        });
+        const dir = resolveFromRoot(config, config.output);
+        const server = await startPreview(dir, Number.parseInt(opts.port, 10));
+        process.stdout.write(`previsualizacion en ${server.url}\npulsa Ctrl+C para detener\n`);
+        await new Promise((resolve) => {
+            process.on('SIGINT', () => {
+                void server.close().then(resolve);
+            });
+        });
+    });
+    program
+        .command('init')
+        .description('prepara este proyecto para usar DocViz')
+        .option('-t, --theme <name>', `tema inicial (${themeNames().join(', ')})`, 'default')
+        .option('--force', 'sobrescribe los archivos que ya existan', false)
+        .action(async (opts) => {
+        if (!themeNames().includes(opts.theme)) {
+            process.stderr.write(`el tema "${opts.theme}" no existe\ntemas: ${themeNames().join(', ')}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const result = await init({ cwd: process.cwd(), theme: opts.theme, force: opts.force === true });
+        process.stdout.write(formatearInit(result, opts.theme));
+    });
+    program
+        .command('fix')
+        .description('corrige las erratas de un bloque que no compila')
+        .argument('<archivo>', 'archivo con el bloque, o - para leer de la entrada estandar')
+        .option('-l, --lang <valla>', 'valla del bloque: diagram | chart | architecture', 'diagram')
+        .option('--json', 'salida en JSON', false)
+        .action(async (archivo, opts) => {
+        const source = archivo === '-' ? await leerEntrada() : await readFile(path.resolve(archivo), 'utf8');
+        const result = fixBlock({ source, ...(opts.lang !== undefined ? { lang: opts.lang } : {}) });
+        if (opts.json === true) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+            if (!result.ok)
+                process.exitCode = 1;
+            return;
+        }
+        for (const c of (result['aplicado'] ?? [])) {
+            process.stderr.write(`corregido: "${c.de}" -> "${c.a}"\n`);
+        }
+        process.stdout.write(`${String(result['source'] ?? source)}\n`);
+        if (!result.ok) {
+            process.stderr.write(`\n${String(result['detail'] ?? result['error'] ?? 'sigue sin compilar')}\n`);
+            for (const p2 of (result['pendientes'] ?? []))
+                process.stderr.write(`  ${p2}\n`);
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command('setup')
+        .description('descarga plantuml.jar dentro del paquete (unica operacion de red)')
+        .argument('[version]', 'version de PlantUML a descargar')
+        .action(async (version) => {
+        // Instalado como dependencia, `npm run setup` no existe: los scripts del
+        // paquete no son los del proyecto. Sin este comando, los 12 tipos de
+        // PlantUML quedan muertos tras un `npm install` y nadie sabe por que.
+        const script = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'scripts', 'fetch-plantuml.mjs');
+        try {
+            const { stdout, stderr } = await ejecutar(process.execPath, version !== undefined ? [script, version] : [script], { timeout: 300_000, maxBuffer: 4 * 1024 * 1024 });
+            process.stdout.write(stdout);
+            if (stderr !== '')
+                process.stderr.write(stderr);
+        }
+        catch (err) {
+            const salida = err;
+            if (salida.stdout)
+                process.stdout.write(salida.stdout);
+            process.stderr.write(salida.stderr ?? `${salida.message ?? String(err)}\n`);
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command('skill')
+        .description('instala el contrato de DocViz como skill de tu agente')
+        .option('-g, --global', 'instala en tu perfil en lugar de en el proyecto', false)
+        .option('-d, --dir <dir>', 'directorio de skills de otro agente')
+        .option('--force', 'sobrescribe una instalacion anterior', false)
+        .action(async (opts) => {
+        const result = await installSkill({
+            cwd: process.cwd(),
+            global: opts.global === true,
+            force: opts.force === true,
+            ...(opts.dir !== undefined ? { dir: opts.dir } : {}),
+        });
+        process.stdout.write(formatearSkill(result));
+    });
+    program
+        .command('doctor')
+        .description('comprueba el entorno y que tipos se pueden dibujar')
+        .option('-c, --config <file>', 'archivo de configuracion')
+        .option('--json', 'salida en JSON', false)
+        .action(async (opts) => {
+        const config = await loadConfig(opts.config !== undefined ? { configPath: opts.config } : {});
+        const diagnostico = await diagnosticar(config);
+        process.stdout.write(opts.json === true ? `${JSON.stringify(diagnostico, null, 2)}\n` : formatearDiagnostico(diagnostico));
+        // Falta de entorno es un fallo: en un pipeline conviene enterarse antes de
+        // compilar, no a mitad del build.
+        if (!diagnostico.ok)
+            process.exitCode = 1;
+    });
+    program
+        .command('types')
+        .description('lista los tipos del DSL con su proposito y su ejemplo')
+        .argument('[type]', 'muestra la ficha completa de un tipo concreto')
+        .option('--short', 'solo los nombres, sin metadatos', false)
+        .option('--json', 'salida en JSON, para consumirla desde otro programa', false)
+        .option('-l, --lang <idioma>', 'idioma de las fichas: es | en', 'es')
+        .action((type, opts) => {
+        const idioma = opts.lang === 'en' ? 'en' : 'es';
+        if (type !== undefined) {
+            const spec = findType(type);
+            if (spec === undefined) {
+                process.stderr.write(`el tipo "${type}" no existe\n\ntipos disponibles:\n  ${TYPE_CATALOG.map((s) => s.type).sort().join(', ')}\n`);
+                process.exitCode = 1;
+                return;
+            }
+            process.stdout.write(opts.json === true ? `${JSON.stringify(spec, null, 2)}\n` : ficha(spec, idioma));
+            return;
+        }
+        if (opts.json === true) {
+            process.stdout.write(`${JSON.stringify({ types: TYPE_CATALOG, themes: themeNames() }, null, 2)}\n`);
+            return;
+        }
+        if (opts.short === true) {
+            for (const [lang, types] of Object.entries(dslCatalog())) {
+                process.stdout.write(`\n\`\`\`${lang}\`\`\`\n`);
+                for (const t of types)
+                    process.stdout.write(`  - ${t}\n`);
+            }
+            process.stdout.write(`\ntemas: ${themeNames().join(', ')}\n`);
+            return;
+        }
+        // Por defecto se muestra el proposito de cada tipo: una lista de nombres
+        // obliga a adivinar, que es justo lo que el catalogo existe para evitar.
+        for (const lang of ['diagram', 'chart', 'architecture']) {
+            const specs = TYPE_CATALOG.filter((s) => s.lang === lang);
+            process.stdout.write(`\n\`\`\`${lang}\`\`\`\n`);
+            const ancho = Math.max(...specs.map((s) => s.type.length));
+            for (const spec of specs) {
+                const proposito = idioma === 'en' && spec.en !== undefined ? spec.en.purpose : spec.purpose;
+                process.stdout.write(`  ${spec.type.padEnd(ancho)}  ${proposito}\n`);
+            }
+        }
+        process.stdout.write(`\ntemas: ${themeNames().join(', ')}\n` +
+            `\ndocviz types <tipo>   ficha completa con ejemplo\n` +
+            `docviz suggest "..."  recomendacion a partir de una frase\n`);
+    });
+    program
+        .command('suggest')
+        .description('recomienda un tipo a partir de lo que quieres explicar')
+        .argument('<necesidad...>', 'que quieres explicar, en una frase')
+        .option('-n, --limit <n>', 'numero de sugerencias', '3')
+        .option('--json', 'salida en JSON', false)
+        .action((palabras, opts) => {
+        const need = palabras.join(' ');
+        const result = suggestType({ need, limit: Number.parseInt(opts.limit, 10) });
+        if (opts.json === true) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+            if (result.ok !== true)
+                process.exitCode = 1;
+            return;
+        }
+        if (result.ok !== true) {
+            process.stderr.write(`${String(result['error'])}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const matches = result['matches'];
+        if (matches.length === 0) {
+            process.stdout.write(`${String(result['advice'])}\n`);
+            return;
+        }
+        for (const match of matches) {
+            process.stdout.write(`\n${match['type']}  (${match['lang']}, ${match['engine']})\n` +
+                `  ${match['purpose']}\n` +
+                `  cuando: ${match['whenToUse']}\n` +
+                `  cuando no: ${match['whenNotToUse']}\n\n` +
+                `${match['block'].split('\n').map((l) => `  ${l}`).join('\n')}\n`);
+        }
+    });
+    return program;
+}
+const ETIQUETAS = {
+    es: { usar: 'cuando usarlo:', evitar: 'cuando no:     ', alias: 'alias:         ', respaldo: 'respaldo:      ' },
+    en: { usar: 'when to use:  ', evitar: 'when not to:  ', alias: 'aliases:      ', respaldo: 'fallbacks:    ' },
+};
+/** Ficha legible de un tipo, con su ejemplo listo para copiar. */
+function ficha(spec, idioma = 'es') {
+    const texto = idioma === 'en' && spec.en !== undefined ? spec.en : spec;
+    const et = ETIQUETAS[idioma];
+    const lineas = [
+        '',
+        `${spec.type}  (${spec.lang}, ${spec.engine})`,
+        '',
+        `  ${texto.purpose}`,
+        '',
+        `  ${et.usar}  ${texto.whenToUse}`,
+        `  ${et.evitar}  ${texto.whenNotToUse}`,
+    ];
+    if (spec.aliases !== undefined && spec.aliases.length > 0) {
+        lineas.push(`  ${et.alias}  ${spec.aliases.join(', ')}`);
+    }
+    if (spec.fallbacks !== undefined && spec.fallbacks.length > 0) {
+        lineas.push(`  ${et.respaldo}  ${spec.fallbacks.join(', ')}`);
+    }
+    lineas.push('', `  \`\`\`${spec.lang}`);
+    for (const l of spec.example.split('\n'))
+        lineas.push(`  ${l}`);
+    lineas.push('  ```', '');
+    return `${lineas.join('\n')}\n`;
+}
+/**
+ * Los avisos van a stderr y no cambian el codigo de salida.
+ *
+ * Un campo ignorado no rompe el documento, pero si se mezcla con la salida
+ * normal nadie lo lee; y si fallara el build, corregir una errata seria
+ * obligatorio antes de publicar cualquier cosa.
+ */
+function escribirAvisos(warnings) {
+    for (const w of warnings) {
+        process.stderr.write(`AVISO ${w.file}:${w.line} [${w.code}] ${w.message}\n`);
+    }
+}
+export async function run(argv = process.argv) {
+    try {
+        await createProgram().parseAsync([...argv]);
+        return typeof process.exitCode === 'number' ? process.exitCode : 0;
+    }
+    catch (err) {
+        if (err instanceof BuildFailedError) {
+            process.stderr.write(`\n${err.format()}\n\n${err.message}\n`);
+            return 1;
+        }
+        if (err instanceof DocVizError) {
+            process.stderr.write(`\n${err.format()}\n`);
+            return 1;
+        }
+        process.stderr.write(`\nERROR inesperado\n${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=cli.js.map