@boristype/bt-cli 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 BorisType
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# btc — BorisType Compiler
+
+Транспилятор TypeScript → BorisScript для платформы WebSoft HCM.
+
+Использует [bt-ir](../bt-ir/) для emit: TypeScript Compiler API создаёт Program с `noEmit: true`, а кодогенерация выполняется через `compileSourceFile()` из bt-ir.
+
+## CLI-команды
+
+```
+btc init          # Создать проект (scaffold)
+btc build         # Однократная сборка
+btc dev           # Watch mode с инкрементальной компиляцией и авто-линковкой
+btc link          # Линковка модулей в dist/
+btc push          # Деплой dist/ на сервер WSHCM
+btc artifact      # Создание артефакта для развёртывания
+```
+
+## Структура `src/`
+
+```
+src/
+├── index.ts                  # Точка входа (CLI bootstrap)
+├── cli/                      # Тонкие обёртки над commander
+│   ├── index.ts              # Регистрация команд
+│   └── commands/             # Обработчики CLI-команд
+├── core/                     # Вся бизнес-логика
+│   ├── config.ts             # Чтение tsconfig / btconfig
+│   ├── logger.ts             # Re-export логгера
+│   ├── utils/                # Общие утилиты
+│   │   ├── logger.ts         # Logger (singleton)
+│   │   ├── properties.ts     # Парсер .properties файлов
+│   │   └── xml.ts            # Общие XML builder/parser
+│   ├── building/             # Компиляция TS → BS
+│   │   ├── compiler.ts       # Program + emit через bt-ir
+│   │   ├── compile-mode.ts   # Определение режима файла (module/script)
+│   │   ├── coordinator.ts    # Координатор dev mode (multi-package)
+│   │   ├── files.ts          # Копирование non-TS файлов
+│   │   ├── output.ts         # Пост-обработка вывода
+│   │   └── types.ts          # BuildContext, BuildResult, BtcCompileOptions
+│   ├── linking/              # Сборка dist/ из модулей
+│   │   ├── index.ts          # Pipeline: resolve → link → finalize
+│   │   ├── parsers.ts        # Парсеры PackageInfo
+│   │   ├── executables.ts    # Сбор executables
+│   │   ├── dependencies.ts   # Дерево зависимостей
+│   │   ├── cache.ts          # Кэширование линковки
+│   │   ├── context.ts        # LinkingContext
+│   │   ├── types.ts          # PackageInfo, LinkingOptions
+│   │   ├── linkers/          # Линковщики по типу пакета
+│   │   ├── generators/       # Генерация api_ext.xml, init.xml и т.д.
+│   │   └── utils/            # URL, copy, node_modules
+│   ├── pushing/              # Деплой на сервер WSHCM
+│   │   ├── session.ts        # DeploySession (с retry/reconnect)
+│   │   ├── upload.ts         # Загрузка файлов
+│   │   ├── config.ts         # Чтение btconfig.properties
+│   │   ├── queue.ts          # DebouncedPushQueue для dev mode
+│   │   └── reinit.ts         # Реинициализация на сервере
+│   └── artifacting/          # Создание архивов для деплоя
+```
+
+## Сборка
+
+```bash
+npm run build    # tsc → build/
+```
+
+Требуется Node.js 22+.

package/build/builder/config.js

@@ -0,0 +1,88 @@
+"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.getTSConfig = getTSConfig;
+exports.getBTConfig = getBTConfig;
+const typescript_1 = __importDefault(require("typescript"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("../core/logger");
+function getTSConfig(cwd, project = 'tsconfig.json') {
+    const tsconfigPath = typescript_1.default.findConfigFile(cwd, typescript_1.default.sys.fileExists, project);
+    if (!tsconfigPath) {
+        logger_1.logger.error(`There is no any configuration files at "${cwd}". Execute npx tsc -init to create a new one.`);
+        process.exit(1);
+    }
+    const { config, error } = typescript_1.default.readConfigFile(tsconfigPath, typescript_1.default.sys.readFile);
+    if (error) {
+        logger_1.logger.error(error.messageText.toString());
+        process.exit(1);
+    }
+    // Используем директорию tsconfig.json как базу для резолва путей
+    const configDir = path.dirname(tsconfigPath);
+    const configFileContent = typescript_1.default.parseJsonConfigFileContent(config, typescript_1.default.sys, configDir);
+    if (configFileContent.errors.length > 0) {
+        configFileContent.errors.forEach(diagnostic => {
+            logger_1.logger.error(diagnostic.messageText.toString());
+        });
+        process.exit(1);
+    }
+    return configFileContent;
+}
+/**
+ * Читает и парсит btconfig.json
+ * @param cwd Рабочая директория
+ * @param project Имя файла конфигурации (по умолчанию btconfig.json)
+ * @returns Объект конфигурации BtConfig или undefined если файл не найден
+ */
+function getBTConfig(cwd, project = 'btconfig.json') {
+    const btconfigPath = path.join(cwd, project);
+    // Если файл не существует, возвращаем undefined
+    if (!fs.existsSync(btconfigPath)) {
+        return undefined;
+    }
+    try {
+        const configContent = fs.readFileSync(btconfigPath, 'utf-8');
+        const config = JSON.parse(configContent);
+        return config;
+    }
+    catch (error) {
+        logger_1.logger.error(`Error reading or parsing ${project}: ${error}`);
+        process.exit(1);
+    }
+}

package/build/cli/commands/artifact.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.artifactCommand = artifactCommand;
+const artifacting_1 = require("../../core/artifacting");
+/**
+ * Команда artifact - создание архивов для поставки
+ * Создаёт zip-архив из директории dist
+ *
+ * @param options - Опции команды
+ */
+async function artifactCommand(options = {}) {
+    const cwd = process.cwd();
+    await (0, artifacting_1.processArtifact)(cwd, { clean: options.clean ?? false });
+}

package/build/cli/commands/build.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCommand = buildCommand;
+const config_js_1 = require("../../core/config.js");
+const index_js_1 = require("../../core/building/index.js");
+/**
+ * Команда build - транспиляция TypeScript в BorisScript
+ *
+ * @param files - Список файлов для компиляции (пустой = все файлы из tsconfig)
+ * @param options - Опции компиляции
+ */
+async function buildCommand(files, options) {
+    const cwd = process.cwd();
+    const tsConfig = (0, config_js_1.getTSConfig)(cwd, 'tsconfig.json');
+    const _btConfig = (0, config_js_1.getBTConfig)(cwd, 'btconfig.json'); // TODO: использовать в будущем
+    const result = index_js_1.BuildPipeline.run({
+        tsConfig,
+        options,
+        files,
+        cwd,
+    });
+    if (!result.success) {
+        process.exitCode = 1;
+    }
+}

package/build/cli/commands/dev.js

@@ -0,0 +1,190 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devCommand = devCommand;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const logger_1 = require("../../core/logger");
+const index_1 = require("../../core/linking/index");
+const config_1 = require("../../core/config");
+const index_2 = require("../../core/building/index");
+const index_3 = require("../../core/pushing/index");
+const queue_1 = require("../../core/pushing/queue");
+const coordinator_1 = require("../../core/building/coordinator");
+/**
+ * Команда dev - режим разработки с watch
+ *
+ * Использует TypeScript watch API для инкрементальной компиляции.
+ * Координирует сборку и линковку для multi-package проектов:
+ * 1. Запускает watch для всех пакетов
+ * 2. Ждёт завершения initial build всех пакетов
+ * 3. Выполняет полную линковку
+ * 4. Переходит в инкрементальный режим
+ */
+async function devCommand(options = {}) {
+    const projectPath = process.cwd();
+    const enablePush = options.push !== false;
+    logger_1.logger.info('🔧 Starting dev mode...');
+    // 1. Получаем пакеты для линковки
+    const packages = (0, index_1.resolvePackagesToLink)(projectPath);
+    logger_1.logger.info(`📦 Found ${packages.length} package(s) to process`);
+    // 2. Фильтруем только ws:package пакеты (не статический контент)
+    const watchPackages = resolveWatchPackages(projectPath, packages);
+    if (watchPackages.length === 0) {
+        logger_1.logger.warning('⚠️ No ws:package packages found to watch');
+        return;
+    }
+    logger_1.logger.info(`👀 Watching ${watchPackages.length} package(s):`);
+    for (const pkg of watchPackages) {
+        logger_1.logger.info(`   - ${pkg.wsName} (${pkg.packageType}) at ${pkg.name}`);
+    }
+    // 3. Создаём координатор
+    let pushQueue = null;
+    if (enablePush) {
+        logger_1.logger.info('📤 Auto-push enabled (use --no-push to disable)');
+        const connectionOptions = (0, index_3.resolvePushConnectionOptions)(projectPath);
+        logger_1.logger.info(`📡 Server: ${connectionOptions.https ? 'https' : 'http'}://${connectionOptions.host}:${connectionOptions.port}`);
+        const distPath = path.join(projectPath, 'dist');
+        const session = new index_3.DeploySession(connectionOptions);
+        pushQueue = new queue_1.DebouncedPushQueue(session, distPath);
+    }
+    const coordinator = new coordinator_1.DevCoordinator(projectPath, watchPackages, packages, pushQueue);
+    // 4. Запускаем watchers для каждого пакета
+    logger_1.logger.info('🔨 Starting initial build...');
+    const watchers = [];
+    for (const pkg of watchPackages) {
+        const watcher = startPackageWatch(pkg, coordinator);
+        if (watcher) {
+            watchers.push(watcher);
+        }
+    }
+    // Обработка graceful shutdown
+    process.on('SIGINT', async () => {
+        logger_1.logger.info('\n🛑 Stopping dev mode...');
+        for (const w of watchers) {
+            w.close();
+        }
+        if (pushQueue) {
+            await pushQueue.close();
+        }
+        process.exit(0);
+    });
+}
+/**
+ * Определяет какие пакеты являются ws:package и могут быть watch-ены
+ */
+function resolveWatchPackages(projectPath, packages) {
+    const result = [];
+    for (const pkg of packages) {
+        const packageDir = pkg.name === '.'
+            ? projectPath
+            : path.join(projectPath, pkg.name);
+        const packageJsonPath = path.join(packageDir, 'package.json');
+        if (!fs.existsSync(packageJsonPath)) {
+            // Нет package.json - это статический контент, не watch-им
+            continue;
+        }
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            const wsPackage = packageJson['ws:package'];
+            const wsName = packageJson['ws:name'];
+            // Только пакеты с ws:package (standalone, component, system)
+            if (!wsPackage || !wsName) {
+                // Не BT пакет - пропускаем
+                continue;
+            }
+            // library пакеты не watch-им напрямую
+            if (wsPackage === 'library' || wsPackage === 'lib') {
+                continue;
+            }
+            result.push({
+                name: pkg.name,
+                absolutePath: packageDir,
+                wsName,
+                packageType: wsPackage,
+            });
+        }
+        catch (error) {
+            logger_1.logger.warning(`⚠️ Failed to parse package.json in ${pkg.name}: ${error}`);
+        }
+    }
+    return result;
+}
+/**
+ * Запускает watch для пакета используя BuildPipeline.watch()
+ *
+ * @param pkg - Информация о пакете
+ * @param coordinator - Координатор dev mode
+ */
+function startPackageWatch(pkg, coordinator) {
+    const tsconfigPath = path.join(pkg.absolutePath, 'tsconfig.json');
+    if (!fs.existsSync(tsconfigPath)) {
+        logger_1.logger.warning(`⚠️ No tsconfig.json found for ${pkg.wsName}, skipping watch`);
+        return null;
+    }
+    logger_1.logger.info(`  🔄 Starting watcher for ${pkg.wsName}...`);
+    // Получаем tsconfig
+    const tsConfig = (0, config_1.getTSConfig)(pkg.absolutePath, 'tsconfig.json');
+    // Запускаем watch через BuildPipeline
+    const watcher = index_2.BuildPipeline.watch({
+        tsConfig,
+        options: {
+            includeNonTsFiles: true,
+            retainNonAsciiCharacters: false,
+            removeComments: false,
+            useBabel: false,
+            usePolyfill: true,
+            useRemodule: true,
+        },
+        files: [],
+        cwd: pkg.absolutePath,
+    }, {
+        onRebuild: (result) => {
+            if (result.success) {
+                logger_1.logger.success(`✅ [${pkg.wsName}] Build successful (${result.duration}ms)`);
+                // Координатор решает: полная или инкрементальная линковка
+                coordinator.onPackageBuild(pkg, result.emittedFiles);
+            }
+            else {
+                logger_1.logger.error(`❌ [${pkg.wsName}] Build failed`);
+            }
+        },
+        onNonTsFileChange: (filePath) => {
+            // Координатор обрабатывает изменения non-TS файлов
+            coordinator.onNonTsFileChange(pkg, filePath);
+        },
+    });
+    return watcher;
+}

package/build/cli/commands/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushCommand = exports.devCommand = exports.artifactCommand = exports.linkCommand = exports.buildCommand = exports.initCommand = void 0;
+/**
+ * Реэкспорт всех команд CLI
+ */
+var init_1 = require("./init");
+Object.defineProperty(exports, "initCommand", { enumerable: true, get: function () { return init_1.initCommand; } });
+var build_1 = require("./build");
+Object.defineProperty(exports, "buildCommand", { enumerable: true, get: function () { return build_1.buildCommand; } });
+var link_1 = require("./link");
+Object.defineProperty(exports, "linkCommand", { enumerable: true, get: function () { return link_1.linkCommand; } });
+var artifact_1 = require("./artifact");
+Object.defineProperty(exports, "artifactCommand", { enumerable: true, get: function () { return artifact_1.artifactCommand; } });
+var dev_1 = require("./dev");
+Object.defineProperty(exports, "devCommand", { enumerable: true, get: function () { return dev_1.devCommand; } });
+var push_1 = require("./push");
+Object.defineProperty(exports, "pushCommand", { enumerable: true, get: function () { return push_1.pushCommand; } });

package/build/cli/commands/init.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const config_1 = require("../../core/config");
+const logger_1 = require("../../core/logger");
+/**
+ * Команда init - инициализация BorisType проекта
+ * Создаёт tsconfig.json с настройками по умолчанию
+ */
+async function initCommand() {
+    const cwd = process.cwd();
+    logger_1.logger.info('🚀 Initializing BorisType project...');
+    (0, config_1.generateDefaultTSConfig)(cwd);
+    logger_1.logger.success('✅ Project initialized successfully');
+}

package/build/cli/commands/link.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.linkCommand = linkCommand;
+const index_1 = require("../../core/linking/index");
+/**
+ * Команда link - компоновка модулей и зависимостей
+ * Собирает все необходимые модули в директорию dist
+ *
+ * @param options - Опции команды
+ */
+async function linkCommand(options = {}) {
+    const linkingOptions = {
+        clean: options.clean,
+        noCache: options.noCache,
+        systemLinkMode: options.linkingSystemAs ?? 'component'
+    };
+    await (0, index_1.processLinking)(linkingOptions);
+}

package/build/cli/commands/push.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Команда push — CLI обёртка для загрузки dist на WSHCM сервер
+ *
+ * Тонкая обёртка над core/pushing/processPush().
+ * Вся бизнес-логика находится в core/pushing/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushCommand = pushCommand;
+const index_1 = require("../../core/pushing/index");
+/**
+ * Команда push - загрузка dist на WSHCM сервер
+ *
+ * Выполняет:
+ * 1. Отправку dist на WSHCM сервер
+ * 2. Сброс кеша модулей
+ * 3. Reinit для standalone и components
+ *
+ * Приоритет опций:
+ * 1. CLI параметры
+ * 2. btconfig.properties
+ * 3. Дефолтные значения (localhost:80, user1:user1)
+ *
+ * @param cliOptions - Опции из CLI (опциональные)
+ */
+async function pushCommand(cliOptions = {}) {
+    await (0, index_1.processPush)(process.cwd(), cliOptions);
+}

package/build/cli/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushCommand = exports.devCommand = exports.artifactCommand = exports.linkCommand = exports.buildCommand = exports.initCommand = void 0;
+/**
+ * CLI модуль btc
+ * Реэкспорт команд и типов
+ */
+var commands_1 = require("./commands");
+Object.defineProperty(exports, "initCommand", { enumerable: true, get: function () { return commands_1.initCommand; } });
+Object.defineProperty(exports, "buildCommand", { enumerable: true, get: function () { return commands_1.buildCommand; } });
+Object.defineProperty(exports, "linkCommand", { enumerable: true, get: function () { return commands_1.linkCommand; } });
+Object.defineProperty(exports, "artifactCommand", { enumerable: true, get: function () { return commands_1.artifactCommand; } });
+Object.defineProperty(exports, "devCommand", { enumerable: true, get: function () { return commands_1.devCommand; } });
+Object.defineProperty(exports, "pushCommand", { enumerable: true, get: function () { return commands_1.pushCommand; } });

package/build/cli/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/core/artifacting/context.js

@@ -0,0 +1,54 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createArtifactContext = createArtifactContext;
+const path = __importStar(require("path"));
+/**
+ * Создаёт начальный контекст для artifact pipeline
+ *
+ * @param cwd - Рабочая директория
+ * @param options - Опции pipeline
+ * @returns Начальный контекст
+ */
+function createArtifactContext(cwd, options) {
+    const distPath = path.join(cwd, 'dist');
+    const artifactPath = path.join(cwd, 'artifact');
+    return {
+        cwd,
+        distPath,
+        artifactPath,
+        options,
+    };
+}

package/build/core/artifacting/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Artifact Pipeline
+ *
+ * Создание архива для поставки из директории dist
+ *
+ * Pipeline stages:
+ * 1. Validate - проверка dist, очистка/создание artifact/
+ * 2. Create Archive - создание main.zip (полное содержимое dist)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processArtifact = processArtifact;
+const logger_1 = require("../logger");
+const context_1 = require("./context");
+const stages_1 = require("./stages");
+/**
+ * Выполняет artifact pipeline
+ *
+ * @param cwd - Рабочая директория
+ * @param options - Опции pipeline
+ * @returns Финальный контекст с информацией о созданном архиве
+ */
+async function processArtifact(cwd, options) {
+    logger_1.logger.info('🚀 Artifact Pipeline Started');
+    logger_1.logger.info('─'.repeat(40));
+    // Создаём начальный контекст
+    let ctx = (0, context_1.createArtifactContext)(cwd, options);
+    // Stage 1: Validate
+    ctx = (0, stages_1.stageValidate)(ctx);
+    // Stage 2: Create Archive
+    ctx = await (0, stages_1.stageMainArchive)(ctx);
+    // Summary
+    logger_1.logger.info('─'.repeat(40));
+    logger_1.logger.info(`✅ Artifact Pipeline Completed`);
+    logger_1.logger.info(`   Архив: ${ctx.archivePath}`);
+    return ctx;
+}

package/build/core/artifacting/stages/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stageMainArchive = exports.stageValidate = void 0;
+/**
+ * Реэкспорт stages для artifact pipeline
+ */
+var validate_1 = require("./validate");
+Object.defineProperty(exports, "stageValidate", { enumerable: true, get: function () { return validate_1.stageValidate; } });
+var main_archive_1 = require("./main-archive");
+Object.defineProperty(exports, "stageMainArchive", { enumerable: true, get: function () { return main_archive_1.stageMainArchive; } });