@alfacapital-tech/c4builder 0.4.0-rc.4 → 0.5.0-rc.1

package/dist/cli/commands/check.js

@@ -6,8 +6,9 @@ import { VENDORED_JAR } from "../../util/utils.js";
 import { resolveJava } from "../../core/render/jre.js";
 import { renderDiagram } from "../../core/render/diagrams.js";
 import { renderD2, teardownD2 } from "../../core/render/d2renderer.js";
+import { BpmnError, renderBpmn, teardownBpmn } from "../../core/render/bpmnrenderer.js";
 // `c4builder check <file...>` — валидация отдельных диаграмм ТЕМ ЖЕ движком, что и
-// сборка (вендорный PlantUML jar + системная/managed java, бандл D2), без проекта и
+// сборка (вендорный PlantUML jar + системная/managed java, бандл D2, конвейер BPMN), без проекта и
 // `.c4builder`. Рендер идёт в память и выбрасывается: проверяем ровно то, что упало бы
 // в сборке (системный `plantuml` может отличаться версией). Код выхода 0 — все файлы ок,
 // 1 — есть ошибка (движка, неизвестного расширения или чтения файла).
@@ -23,39 +24,51 @@ const getJava = () => {
     javaPromise ??= resolveJava({ log: (m) => console.log(chalk.gray(m)) }).then((r) => r.path);
     return javaPromise;
 };
+// .iuml — библиотека без @startuml: сам по себе PlantUML «рендерит» его без ошибок,
+// поэтому проверяем через включение в пустую диаграмму. Контекст C4 библиотеке стилей
+// задаёт подключающая диаграмма — при ошибке движка повтор с C4-stdlib (Dynamic тянет
+// Component → Container → Context, Deployment — Container). Не сразу с C4: это +~1.2 с
+// java на файл, а самодостаточные библиотеки подключают C4 сами.
+const LIB_CONTEXTS = ['', '!include <C4/C4_Dynamic>\n!include <C4/C4_Deployment>\n'];
 const checkPlantUml = async (abs) => {
-    // .iuml — библиотека без @startuml: сам по себе PlantUML «рендерит» его без ошибок,
-    // поэтому проверяем через включение в пустую диаграмму.
     const isLib = path.extname(abs) === '.iuml';
-    const content = isLib ? `@startuml\n!include ${abs}\n@enduml\n` : await readFile(abs);
-    const isDitaa = /@startditaa/i.test(content.toString());
-    try {
-        await renderDiagram(content, {
-            javaBin: await getJava(),
-            jarPath: JAR_PATH,
-            includePath: path.dirname(abs),
-            format: isDitaa ? 'png' : 'svg',
-            charset: 'UTF-8',
-            isDitaa,
-            useSystemFonts: false
-        });
-    }
-    catch (e) {
-        const m = e.message.match(PUML_ERROR);
-        if (!m)
-            throw e;
-        // Для .iuml позиция относится к обёртке, а не к файлу — не показываем.
-        throw new Error(isLib ? m[2] : `строка ${Number(m[1]) + 1}: ${m[2]}`);
+    const attempts = isLib
+        ? LIB_CONTEXTS.map((ctx) => `@startuml\n${ctx}!include ${abs}\n@enduml\n`)
+        : [await readFile(abs)];
+    for (const [i, content] of attempts.entries()) {
+        const isDitaa = /@startditaa/i.test(content.toString());
+        try {
+            await renderDiagram(content, {
+                javaBin: await getJava(),
+                jarPath: JAR_PATH,
+                includePath: path.dirname(abs),
+                format: isDitaa ? 'png' : 'svg',
+                charset: 'UTF-8',
+                isDitaa,
+                useSystemFonts: false
+            });
+            return;
+        }
+        catch (e) {
+            const m = e.message.match(PUML_ERROR);
+            if (!m)
+                throw e;
+            if (i < attempts.length - 1)
+                continue;
+            // Для .iuml позиция относится к обёртке, а не к файлу — не показываем.
+            throw new Error(isLib ? m[2] : `line ${Number(m[1]) + 1}: ${m[2]}`);
+        }
     }
 };
 const CHECKERS = {
     '.puml': checkPlantUml,
     '.iuml': checkPlantUml,
-    '.d2': (abs) => renderD2(abs)
+    '.d2': (abs) => renderD2(abs),
+    '.bpmn': async (abs) => renderBpmn(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs))
 };
 export default async (files) => {
     if (files.length === 0) {
-        console.log(chalk.red('использование: c4builder check <file...>  (.puml | .iuml | .d2)'));
+        console.log(chalk.red('usage: c4builder check <file...>  (.puml | .iuml | .d2 | .bpmn)'));
         process.exit(1);
     }
     let failed = 0;
@@ -65,16 +78,20 @@ export default async (files) => {
         const check = CHECKERS[path.extname(abs).toLowerCase()];
         try {
             if (!check)
-                throw new Error('неизвестное расширение (ожидается .puml, .iuml или .d2)');
+                throw new Error('unsupported extension (expected .puml, .iuml, .d2 or .bpmn)');
             await check(abs);
             console.log(chalk.green(`✓ ${file}`));
         }
         catch (e) {
             failed++;
-            console.error(chalk.red(`✗ ${file}: ${e.message}`));
+            // BPMN: по строке на нарушение — агент правит их по id элемента.
+            const problems = e instanceof BpmnError ? e.problems : [e.message];
+            for (const p of problems)
+                console.error(chalk.red(`✗ ${file}: ${p}`));
         }
     }
     await teardownD2();
+    await teardownBpmn();
     if (failed)
         process.exit(1);
 };

package/dist/cli/commands/help.js

@@ -4,7 +4,8 @@ export default () => {
     console.log(chalk.blue(figlet.textSync('c4builder')));
     console.log(`
 Full documentation
-${chalk.blue('https://adrianvlupu.github.io/C4-Builder/')}
+${chalk.blue('https://alfacapital-tech.github.io/C4-Builder/ru/')} (in Russian)
+${chalk.blue('https://alfacapital-tech.github.io/C4-Builder/en/')} (English)
 
 CONFIGURATION OPTIONS 
 ${chalk.cyan('Project Name')}
@@ -30,6 +31,8 @@ ${chalk.cyan('Generate website')}
 Uses docsify to generate a website with a sidebar for navigation. The site can be easily deployed to github pages.
     ${chalk.cyan('Website docsify theme')}
     Changes the default theme of the generated docsify website
+    ${chalk.cyan('Generate llms.txt for AI agents')} (${chalk.gray('.c4builder → "generateLLMS"')})
+    Writes llms.txt (page index) and llms-full.txt (all pages with diagram sources) to the site root.
 ${chalk.cyan('Generate diagram images locally')}
 Uses the localy installed plantuml package to build svg images for each diagram.
 ${chalk.cyan('Replace diagrams with a link')}
@@ -39,7 +42,7 @@ Shows the original folder hierarchy after each title.
 ${chalk.cyan('Plugins')} (${chalk.gray('.c4builder → "plugins", no wizard prompt')})
 List of build plugins: "name" or ["name", { options }]. Built-in: openspec (local OpenSpec store →
 site section), openapi (swagger-ui pages for OpenAPI specs from a folder or an HTTP archive).
-See README «Plugins».
+See the "Plugins" page of the documentation.
 ${chalk.cyan('Place diagrams before text')}
 Choose to place diagrams before or after the text.
 ${chalk.cyan('Exclude other files')}

package/dist/cli/commands/jre.js

@@ -13,22 +13,22 @@ export default async (args = [], { force = false } = {}) => {
         return;
     }
     if (action !== 'install') {
-        console.log(chalk.red(`неизвестная подкоманда: c4builder jre ${action || ''}`.trim()));
-        console.log(chalk.gray('доступно: c4builder jre install [--force] | jre info'));
+        console.log(chalk.red(`unknown subcommand: c4builder jre ${action || ''}`.trim()));
+        console.log(chalk.gray('available: c4builder jre install [--force] | jre info'));
         process.exit(1);
     }
     try {
         if (!force) {
             const sys = detectSystemJava();
             if (sys) {
-                console.log(chalk.green(`системная java годна (v${sys.major}): ${sys.path}`));
-                console.log(chalk.gray('скачивание не требуется — для форс-загрузки: c4builder jre install --force'));
+                console.log(chalk.green(`system java is suitable (v${sys.major}): ${sys.path}`));
+                console.log(chalk.gray('no download needed — to force it: c4builder jre install --force'));
                 return;
             }
         }
         const resolved = await resolveJava({ force, log: (m) => console.log(chalk.gray(m)) });
-        const from = resolved.source === 'download' ? `Temurin ${TEMURIN_FEATURE}, скачан` : resolved.source;
-        console.log(chalk.green(`JRE готов (${from}): ${resolved.path}`));
+        const from = resolved.source === 'download' ? `Temurin ${TEMURIN_FEATURE}, downloaded` : resolved.source;
+        console.log(chalk.green(`JRE ready (${from}): ${resolved.path}`));
     }
     catch (e) {
         console.log(chalk.red(e.message));

package/dist/cli/commands/list.js

@@ -38,6 +38,9 @@ Generate website: ${currentConfiguration.GENERATE_WEBSITE !== undefined
             ? chalk.green(currentConfiguration.DOCSIFY_TEMPLATE)
             : chalk.red('not set')}`
         : ''}
+    Generate llms.txt for AI agents: ${currentConfiguration.GENERATE_LLMS !== undefined
+        ? chalk.green(currentConfiguration.GENERATE_LLMS)
+        : chalk.red('not set')}
     Repository Url: ${currentConfiguration.REPO_NAME ? chalk.green(currentConfiguration.REPO_NAME) : chalk.red('not set')}
 Include breadcrumbs: ${currentConfiguration.INCLUDE_BREADCRUMBS !== undefined
         ? chalk.green(currentConfiguration.INCLUDE_BREADCRUMBS)
@@ -80,7 +83,7 @@ Plugins: ${currentConfiguration.PLUGINS?.length
     // Битые ключи показаны выше как «not set» (щадящий разбор их выбросил); помечаем их
     // сырым значением и причиной, чтобы было видно, что и почему требует правки/визарда.
     if (issues.length) {
-        console.log(chalk.yellow('⚠ Невалидные ключи в .c4builder (показаны как «not set», чините через `c4builder --config`):'));
+        console.log(chalk.yellow('⚠ Invalid keys in .c4builder (shown as "not set", fix them with `c4builder --config`):'));
         for (const { key, value, message } of issues)
             console.log(chalk.yellow(`  ⚠ ${key}: ${JSON.stringify(value)} — ${message}`));
         console.log('');

package/dist/cli/commands/new.js

@@ -11,16 +11,16 @@ import { TEMPLATE_DIR } from "../../util/paths.js";
 // Интерактив показывает её и переспрашивает; --yes падает с ней (exit≠0), без ре-промпта.
 const validateProjectName = (name) => {
     if (!name?.trim())
-        return 'имя проекта не задано';
+        return 'project name is not set';
     if (name.indexOf('/') !== -1 || name.indexOf('\\') !== -1)
-        return 'имя проекта не должно содержать «/» или «\\»';
+        return 'project name must not contain "/" or "\\"';
     const target = path.join(process.cwd(), name);
     if (fs.existsSync(target)) {
         // readdirSync по файлу бросает ENOTDIR — сперва различаем файл и каталог.
         if (!fs.statSync(target).isDirectory())
-            return `«${name}» уже существует и является файлом`;
+            return `"${name}" already exists and is a file`;
         if (fs.readdirSync(target).length > 0)
-            return `папка «${name}» уже существует и не пуста`;
+            return `folder "${name}" already exists and is not empty`;
     }
     return null;
 };
@@ -34,13 +34,13 @@ export default async (opts = {}) => {
     if (opts.name) {
         const err = validateProjectName(opts.name);
         if (err) {
-            console.log(chalk.red(`ОШИБКА: ${err}`));
+            console.log(chalk.red(`ERROR: ${err}`));
             process.exit(1);
         }
         projectName = opts.name;
     }
     else if (nonInteractive) {
-        console.log(chalk.red('ОШИБКА: режим --yes требует --name <name>'));
+        console.log(chalk.red('ERROR: --yes requires --name <name>'));
         process.exit(1);
     }
     else {

package/dist/cli/commands/site.js

@@ -4,6 +4,9 @@ import fs from 'node:fs';
 import express from 'express';
 import open from 'open';
 const LIVERELOAD_PATH = '/__livereload';
+// Восстановление скролла после reload: docsify рендерит контент асинхронно после fetch md,
+// высота страницы доступна не сразу — поллим до достижения нужной y или таймаута.
+// Комментарии держим здесь, а не в сниппете: он уходит в браузер пользователя.
 const LIVERELOAD_SNIPPET = `
 <script>
 (function () {
@@ -16,8 +19,6 @@ const LIVERELOAD_SNIPPET = `
             sessionStorage.removeItem(KEY);
             var data = JSON.parse(saved);
             if (data && data.hash === location.hash && typeof data.y === 'number') {
-                // docsify рендерит контент асинхронно после fetch md,
-                // высота страницы доступна не сразу — поллим до достижения нужной y или таймаута.
                 var deadline = Date.now() + 2000;
                 var tryRestore = function () {
                     var maxScroll = document.documentElement.scrollHeight - window.innerHeight;

package/dist/cli/dispatch.js

@@ -21,9 +21,12 @@ import { acquireBuildLock, BuildLockHeldError } from "../util/lock.js";
 // переживать ребилды (его пересоздание — секунды), гасим его только когда сборок
 // больше не будет (одиночный запуск).
 import { teardownD2 } from "../core/render/d2renderer.js";
+import { teardownBpmn } from "../core/render/bpmnrenderer.js";
 import { packageJson as pkg } from "../util/paths.js";
 import { outputDirs, parseConfig } from "../config/options.js";
 import { isValidPort } from "../config/schema.js";
+// Позиционные подкоманды: allowExcessArguments пропускает любые, список — единственный фильтр.
+const COMMANDS = ['check', 'jre', 'site', 'new', 'config'];
 const intro = () => {
     console.log(chalk.blue(figlet.textSync('c4builder')));
     console.log(chalk.gray('Blow up your software documentation writing skills'));
@@ -47,7 +50,7 @@ function readLenientConfig(conf) {
 // Строгий путь (сборка) не терпит битого конфига: печатает внятную ошибку и завершает
 // процесс с ненулевым кодом. Держим решение о выходе здесь, в CLI, а не в config/*.
 function failOnConfigIssues(issues) {
-    console.error(chalk.red('Ошибка в .c4builder — невалидные значения не дают собрать документацию:'));
+    console.error(chalk.red('.c4builder error — invalid values prevent building the documentation:'));
     for (const { key, message } of issues)
         console.error(chalk.red(`  ${key} — ${message}`));
     process.exit(1);
@@ -55,7 +58,7 @@ function failOnConfigIssues(issues) {
 // Щадящий путь (--config/первый запуск визарда) предупреждает о битых ключах: они
 // трактуются как «не задано» и будут перезаписаны валидными значениями после визарда.
 function warnConfigIssues(issues) {
-    console.log(chalk.yellow('\n⚠ Невалидные ключи в .c4builder (трактуются как «не задано», визард их перезапишет):'));
+    console.log(chalk.yellow('\n⚠ Invalid keys in .c4builder (treated as "not set", the wizard will overwrite them):'));
     for (const { key, value, message } of issues)
         console.log(chalk.yellow(`  ⚠ ${key}: ${JSON.stringify(value)} — ${message}`));
 }
@@ -67,6 +70,7 @@ function getOptions(c) {
         GENERATE_MD: c.generateMD,
         GENERATE_WEBSITE: c.generateWEB,
         GENERATE_COMPLETE_MD_FILE: c.generateCompleteMD,
+        GENERATE_LLMS: c.generateLLMS,
         // Легаси-детект: PDF-вывод удалён, но truthy-ключи в старых .c4builder
         // ловим здесь (где доступен conf) и отдаём build.js для предупреждения.
         LEGACY_PDF_KEYS: ['generatePDF', 'generateCompletePDF'].filter((k) => c[k]),
@@ -119,27 +123,43 @@ export default async () => {
         .option('-p, --port <n>', 'port used for serving the generated site', (v) => {
         // parseInt молча резал бы опечатку ('30OO' → 30) — валидируем строго.
         if (!isValidPort(v))
-            throw new InvalidArgumentError('ожидается TCP-порт: целое число 1..65535');
+            throw new InvalidArgumentError('expected a TCP port: an integer 1..65535');
         return Number(v);
     })
         .allowExcessArguments() // позиционные аргументы подкоманд `jre <action>` и `check <file...>`
         .parse(process.argv);
     const opts = program.opts();
+    const [cmd, ...cmdArgs] = program.args;
+    // allowExcessArguments глотает любой позиционный аргумент — без этой проверки
+    // опечатка (`c4builder nwe`) молча превращалась бы в сборку.
+    if (cmd !== undefined && !COMMANDS.includes(cmd)) {
+        console.error(chalk.red(`unknown command: ${cmd}`));
+        console.error(`available commands: ${COMMANDS.join(', ')} (see c4builder --help for options)`);
+        process.exit(1);
+    }
     // Прогрев JRE — до загрузки конфига проекта и intro: команда самостоятельна.
-    if (program.args[0] === 'jre')
-        return cmdJre(program.args.slice(1), { force: opts.force });
+    if (cmd === 'jre')
+        return cmdJre(cmdArgs, { force: opts.force });
     // Проверка отдельных диаграмм — тоже без конфига проекта.
-    if (program.args[0] === 'check')
-        return cmdCheck(program.args.slice(1));
-    // `c4builder site` — подсказка после сборки печатает именно эту форму; без
-    // этой строки allowExcessArguments молча глотал бы её и просто пересобирал.
-    if (program.args[0] === 'site')
-        opts.site = true;
+    if (cmd === 'check')
+        return cmdCheck(cmdArgs);
+    // `site`/`new`/`config` — позиционные синонимы одноимённых флагов: эту форму печатают
+    // подсказки CLI и учат README, шаблон и скиллы.
+    if (cmd)
+        opts[cmd] = true;
+    // Справочные команды не должны оставлять файлов: конструктор Configstore сразу пишет
+    // .c4builder и .c4builder.cache, и следующий запуск считал бы каталог проектом.
+    if (opts.docs)
+        return cmdHelp();
+    const configPath = path.join(process.cwd(), opts.configFile ?? '.c4builder');
+    if ((opts.list || opts.reset) && !opts.new && !fs.existsSync(configPath)) {
+        console.error(chalk.red(`no .c4builder in ${process.cwd()} — run inside a project or create one with c4builder new`));
+        process.exit(1);
+    }
     let conf = { get: () => { } };
     let cacheConf = { get: () => { }, set: () => { }, clear: () => { } };
     // Лок сборки — рядом с конфигом проекта (см. util/lock.ts). Заполняется вместе с conf.
     let lockPath = '';
-    const configPath = path.join(process.cwd(), opts.configFile ?? '.c4builder');
     if (!opts.new) {
         const projectKey = process.cwd().split(path.sep).splice(1).join('_');
         lockPath = `${configPath}.lock`;
@@ -155,8 +175,6 @@ export default async () => {
             conf.delete('checksums');
         }
     }
-    if (opts.docs)
-        return cmdHelp();
     // --reset чистит .c4builder при ЛЮБОМ его содержимом — до строгой проверки конфига,
     // чтобы сломанное значение не мешало собственному сбросу.
     if (opts.reset && !opts.new) {
@@ -175,7 +193,7 @@ export default async () => {
         clearConsole();
     intro();
     if (!currentConfig.HAS_RUN && !opts.new) {
-        console.log(`\nif you created the project using the 'c4model new' command you can just press enter and go with the default options to get a basic idea of how it works.\n`);
+        console.log(`\nif you created the project using the 'c4builder new' command you can just press enter and go with the default options to get a basic idea of how it works.\n`);
         console.log(`you can always change the configuration by running > c4builder config\n`);
     }
     if (opts.new)
@@ -221,7 +239,7 @@ export default async () => {
             options.USE_SYSTEM_FONTS = true; // флаг сильнее ключа конфига
         // Плагины грузятся и валидируются до первой сборки: битые опции — exit 1 сразу.
         const plugins = await loadPlugins(options.PLUGINS, process.cwd(), options).catch((e) => {
-            console.error(chalk.red(`Ошибка загрузки плагинов: ${e.message}`));
+            console.error(chalk.red(`failed to load plugins: ${e.message}`));
             return process.exit(1);
         });
         const reloadEmitter = new EventEmitter();
@@ -274,7 +292,7 @@ export default async () => {
                     attemptedWatchBuild = false;
                     if (err instanceof BuildLockHeldError) {
                         // Соседняя сборка ещё идёт — ребилд пропущен, watch жив.
-                        console.log(chalk.yellow(`ребилд пропущен: ${err.message}`));
+                        console.log(chalk.yellow(`rebuild skipped: ${err.message}`));
                     }
                     else {
                         const e = err;
@@ -305,8 +323,10 @@ export default async () => {
             release();
             // Одиночная сборка: D2-воркер больше не нужен, без teardown он держал бы
             // процесс. В watch-режиме воркер живёт до конца процесса (Ctrl+C).
-            if (!opts.watch)
+            if (!opts.watch) {
                 await teardownD2();
+                await teardownBpmn();
+            }
         }
         isBuilding = false;
         if (opts.site)

package/dist/cli/wizard/collect.js

@@ -9,7 +9,7 @@ const nonEmptyString = z.string().trim().min(1);
 // Валидатор ответа визарда: true при успешном safeParse, иначе текст ошибки для inquirer.
 // Пустой Enter уже подставил дефолт (answer = value || default) — сообщение получают
 // только явно введённые пробелы/пустая строка при отсутствии дефолта.
-const validate = (schema, message = 'значение обязательно') => (answer) => schema.safeParse(answer).success || message;
+const validate = (schema, message = 'a value is required') => (answer) => schema.safeParse(answer).success || message;
 // Пункт default-списка чекбокса inquirer: ключ отмечен, если он включён в текущем
 // конфиге, а при незаданном значении — если включён по умолчанию.
 const checkedKey = (current, dflt, key) => (current === undefined ? dflt : current) ? key : null;
@@ -23,7 +23,7 @@ export default async (currentConfiguration, conf, program) => {
             name: 'projectName',
             message: 'Project Name',
             default: currentConfiguration.PROJECT_NAME || path.parse(process.cwd()).name,
-            validate: validate(nonEmptyString, 'укажите имя проекта')
+            validate: validate(nonEmptyString, 'enter a project name')
         });
         conf.set('projectName', responses.projectName);
     }
@@ -33,7 +33,7 @@ export default async (currentConfiguration, conf, program) => {
             name: 'homepageName',
             message: 'HomePage Name',
             default: currentConfiguration.HOMEPAGE_NAME || defaultConfig.homepageName,
-            validate: validate(nonEmptyString, 'укажите имя главной страницы')
+            validate: validate(nonEmptyString, 'enter a home page name')
         });
         conf.set('homepageName', responses.homepageName);
     }
@@ -45,17 +45,17 @@ export default async (currentConfiguration, conf, program) => {
             default: currentConfiguration.ROOT_FOLDER || defaultConfig.rootFolder,
             validate: (answer) => {
                 if (!nonEmptyString.safeParse(answer).success)
-                    return 'укажите папку с документацией';
+                    return 'enter the documentation folder';
                 if (answer.indexOf('/') !== -1 || answer.indexOf('\\') !== -1)
-                    return 'имя папки не должно содержать «/» или «\\»';
+                    return 'folder name must not contain "/" or "\\"';
                 // statSync бросает ENOENT для несуществующего пути — ловим и превращаем в
                 // сообщение, иначе async-хендлер inquirer уронит процесс сырым стектрейсом.
                 try {
                     if (!fs.statSync(path.join(process.cwd(), answer)).isDirectory())
-                        return 'указанный путь не является каталогом';
+                        return 'the path is not a directory';
                 }
                 catch {
-                    return 'папка не найдена';
+                    return 'folder not found';
                 }
                 return true;
             }
@@ -88,7 +88,8 @@ export default async (currentConfiguration, conf, program) => {
         const defaults = [
             checkedKey(currentConfiguration.GENERATE_MD, defaultConfig.generateMD, 'generateMD'),
             checkedKey(currentConfiguration.GENERATE_COMPLETE_MD_FILE, defaultConfig.generateCompleteMD, 'generateCompleteMD'),
-            checkedKey(currentConfiguration.GENERATE_WEBSITE, defaultConfig.generateWEB, 'generateWEB')
+            checkedKey(currentConfiguration.GENERATE_WEBSITE, defaultConfig.generateWEB, 'generateWEB'),
+            checkedKey(currentConfiguration.GENERATE_LLMS, defaultConfig.generateLLMS, 'generateLLMS')
         ];
         responses = await inquirer.prompt({
             type: 'checkbox',
@@ -107,12 +108,17 @@ export default async (currentConfiguration, conf, program) => {
                 {
                     name: 'Generate website',
                     value: 'generateWEB'
+                },
+                {
+                    name: 'llms.txt for AI agents (needs website)',
+                    value: 'generateLLMS'
                 }
             ]
         });
         conf.set('generateMD', responses.generate.includes('generateMD'));
         conf.set('generateCompleteMD', responses.generate.includes('generateCompleteMD'));
         conf.set('generateWEB', responses.generate.includes('generateWEB'));
+        conf.set('generateLLMS', responses.generate.includes('generateLLMS'));
         if (responses.generate.includes('generateMD')) {
             let mdOptions = await inquirer.prompt({
                 type: 'confirm',
@@ -244,7 +250,7 @@ export default async (currentConfiguration, conf, program) => {
             name: 'plantumlServerUrl',
             message: 'PlantUML Server URL',
             default: currentConfiguration.PLANTUML_SERVER_URL || defaultConfig.plantumlServerUrl,
-            validate: validate(nonEmptyString, 'укажите URL сервера PlantUML')
+            validate: validate(nonEmptyString, 'enter the PlantUML server URL')
         });
         conf.set('plantumlServerUrl', responses.plantumlServerUrl);
     }
@@ -254,7 +260,7 @@ export default async (currentConfiguration, conf, program) => {
             name: 'diagramFormat',
             message: 'Diagram Image Format',
             default: currentConfiguration.DIAGRAM_FORMAT || defaultConfig.diagramFormat,
-            validate: validate(nonEmptyString, 'укажите формат изображения диаграмм')
+            validate: validate(nonEmptyString, 'enter the diagram image format')
         });
         conf.set('diagramFormat', responses.diagramFormat);
     }

package/dist/config/defaults.js

@@ -12,6 +12,7 @@ const defaultConfig = {
     generateMD: true,
     generateCompleteMD: false,
     generateWEB: true,
+    generateLLMS: true,
     includeNavigation: false,
     includeTableOfContents: true,
     webTheme: 'vendor/vue.css',

package/dist/config/options.js

@@ -24,7 +24,7 @@ export function parseConfig(raw) {
     const issues = [];
     const brokenKeys = new Set();
     for (const issue of parsed.error.issues) {
-        const key = issue.path.length ? String(issue.path[0]) : '(корень)';
+        const key = issue.path.length ? String(issue.path[0]) : '(root)';
         if (brokenKeys.has(key))
             continue; // один ключ — одно сообщение (напр. массив с N битых элементов)
         brokenKeys.add(key);

package/dist/config/schema.js

@@ -32,6 +32,9 @@ export const configSchema = z.object({
     generateMD: bool(defaultConfig.generateMD),
     generateCompleteMD: bool(defaultConfig.generateCompleteMD),
     generateWEB: bool(defaultConfig.generateWEB),
+    // Намеренно не defaultConfig.generateLLMS: отсутствующий ключ = выкл — легаси-конфиги
+    // не меняют вывод. Новые проекты получают true из defaultConfig (new --yes, wizard).
+    generateLLMS: bool(false),
     includeNavigation: bool(defaultConfig.includeNavigation),
     includeTableOfContents: bool(defaultConfig.includeTableOfContents),
     webTheme: str(defaultConfig.webTheme),
@@ -41,7 +44,7 @@ export const configSchema = z.object({
     docsifyTemplate: str(defaultConfig.docsifyTemplate),
     webPort: z.preprocess(strPre, z
         .string()
-        .refine(isValidPort, 'ожидается TCP-порт: целое число 1..65535')
+        .refine(isValidPort, 'expected a TCP port: an integer 1..65535')
         .default(defaultConfig.webPort)),
     includeBreadcrumbs: bool(defaultConfig.includeBreadcrumbs),
     includeLinkToDiagram: bool(defaultConfig.includeLinkToDiagram),
@@ -66,7 +69,7 @@ export const configSchema = z.object({
     // проверяет лишь форму записи, чтобы ошибка называла `plugins` и позицию.
     plugins: nullish(z
         .array(z.union([z.string(), z.tuple([z.string(), z.record(z.string(), z.unknown())])], {
-        error: 'ожидается "имя" либо ["имя", {опции}]'
+        error: 'expected "name" or ["name", {options}]'
     }))
         .default([])),
     // Легаси-ключи старых `.c4builder` — читаются лишь для однократного предупреждения.

package/dist/core/build.js

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import path from 'node:path';
 import fsextra from 'fs-extra';
-import { makeDirectory, writeOnSameLine } from "../util/utils.js";
+import { makeDirectory, writeFile, writeOnSameLine } from "../util/utils.js";
 // clearD2FileCache: сброс кеша графа D2-импортов на границах сборки (сам webworker
 // D2 гасит CLI после одиночной сборки — в watch-режиме он переживает ребилды).
 import { clearD2FileCache } from "./render/d2renderer.js";
@@ -9,7 +9,7 @@ import { DIST_BACKUP_FOLDER_SUFFIX } from "../config/options.js";
 // Фазы сборки: scan (дерево исходников) → render (диаграммы) → compose (markdown/сайт).
 import { generateTree, engineSupportsRemote, clearIncludeCache } from "./scan/tree.js";
 import { generateImages } from "./render/diagrams.js";
-import { generateMD, generateWebMD, generateCompleteMD, clearDiagramCache } from "./compose/markdown.js";
+import { generateMD, generateWebMD, generateCompleteMD, generateLlmsTxt, generateLlmsFull, clearDiagramCache } from "./compose/markdown.js";
 // Плагины: хуки afterScan (виртуальные страницы) / afterBuild и ассеты сайта.
 // Загружены заранее в cli/dispatch и приходят третьим аргументом (как cacheConf).
 import { runAfterScan, runAfterBuild } from "./plugins/hooks.js";
@@ -51,8 +51,8 @@ const build = async (options, cacheConf, plugins = []) => {
         if (!options.GENERATE_LOCAL_IMAGES) {
             const offline = new Set(tree.flatMap((item) => item.diagrams.filter((d) => !engineSupportsRemote(d.engine)).map((d) => d.engine)));
             if (offline.size) {
-                throw new Error(`В проекте есть диаграммы без онлайн-сервера рендера (${[...offline].join(', ')}), ` +
-                    'но generateLocalImages выключен — включите локальную генерацию изображений ' +
+                throw new Error(`The project has diagrams with no online render server (${[...offline].join(', ')}), ` +
+                    'but generateLocalImages is off — enable local image generation ' +
                     '(generateLocalImages).');
             }
         }
@@ -75,6 +75,15 @@ const build = async (options, cacheConf, plugins = []) => {
             await generateWebMD(tree, options);
             await injectPluginAssets(plugins, options);
         }
+        // llms.txt ссылается на .md страниц сайта — без website ссылаться не на что.
+        if (options.GENERATE_LLMS && options.GENERATE_WEBSITE) {
+            console.log(chalk.blue('generating llms.txt'));
+            await writeFile(path.join(options.DIST_FOLDER, 'llms.txt'), generateLlmsTxt(tree, options));
+            await writeFile(path.join(options.DIST_FOLDER, 'llms-full.txt'), await generateLlmsFull(tree, options));
+        }
+        else if (options.GENERATE_LLMS) {
+            console.log(chalk.yellow('generateLLMS requires generateWEB — llms.txt not created'));
+        }
         if (options.GENERATE_COMPLETE_MD_FILE) {
             console.log(chalk.blue('generating complete markdown file'));
             await generateCompleteMD(tree, options);
@@ -84,7 +93,7 @@ const build = async (options, cacheConf, plugins = []) => {
         // остальные выходы (exit 0). Конфиг НЕ мутируем — только подсказка пользователю.
         if (options.LEGACY_PDF_KEYS?.length) {
             console.log(chalk.bold(chalk.yellow('WARNING:')));
-            console.log(chalk.yellow(`PDF-вывод больше не поддерживается. Удалите вручную из .c4builder: ${options.LEGACY_PDF_KEYS.join(', ')}.`));
+            console.log(chalk.yellow(`PDF output is no longer supported. Remove manually from .c4builder: ${options.LEGACY_PDF_KEYS.join(', ')}.`));
         }
         await runAfterBuild(options, plugins);
         console.log(chalk.green(`built in ${(Date.now() - start_date.getTime()) / 1000} seconds`));
@@ -98,7 +107,7 @@ const build = async (options, cacheConf, plugins = []) => {
             await fsextra.removeSync(bkFolderName);
         }
         else if (options.GENERATE_LOCAL_IMAGES && fsextra.existsSync(bkFolderName)) {
-            console.log(chalk.yellow(`\nсборка прервана — бэкап предыдущего билда сохранён в ./${bkFolderName}`));
+            console.log(chalk.yellow(`\nbuild aborted — the previous build is backed up in ./${bkFolderName}`));
         }
         // Пофайловые кеши нужны только внутри сборки — чистим и на выходе, чтобы
         // watch-процесс не держал base64 всех диаграмм в памяти между ребилдами.

package/dist/core/compose/docsify.template.js

@@ -18,7 +18,6 @@ export default (options) => {
         window.$docsify = ${JSON.stringify(options, null, 2)};
         </script>
         <script src="vendor/docsify.min.js"></script>
-        <script src="vendor/docsify-plantuml.min.js"></script>
         <script src="vendor/zoom-image.min.js"></script>
         ${options.supportSearch ? `<script src="vendor/search.min.js"></script>` : ''}
         ${options.executeScript ? `<script src="vendor/swagger-ui-bundle.js"></script>` : ''}