@maxisoft/instantcms-mcp 1.2.3

package/dist/registry/meta-tools.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMetaTools = registerMetaTools;
+const zod_1 = require("zod");
+const components_js_1 = require("../data/components.js");
+const hooks_js_1 = require("../data/hooks.js");
+const schemas_js_1 = require("../data/schemas.js");
+const version_profiles_js_1 = require("../data/version-profiles.js");
+const artifact_tool_js_1 = require("../tools/artifact-tool.js");
+const define_tool_js_1 = require("../utils/define-tool.js");
+const find_tool_js_1 = require("../utils/find-tool.js");
+const mcp_result_js_1 = require("../utils/mcp-result.js");
+const workflows = {
+    addon: [
+        'analyze_requirement',
+        'get_addon_structure',
+        'scaffold_addon',
+        'validate_addon',
+        'validate_generated_artifacts',
+        'build_addon_archive',
+    ],
+    widget: ['list_widgets', 'scaffold_widget', 'validate_generated_artifacts'],
+    template: [
+        'get_template_structure',
+        'scaffold_complete_template',
+        'analyze_instantcms_template',
+        'scaffold_template_override',
+        'scaffold_layout_scheme',
+        'validate_layout_scheme',
+        'check_template_override_compatibility',
+        'merge_template_overrides',
+        'audit_template_frontend',
+        'extract_template_design_tokens',
+        'audit_template_widget_positions',
+        'scaffold_template_e2e_environment',
+        'index_upstream_template_sources',
+        'scaffold_template_php_quality',
+        'validate_generated_artifacts',
+    ],
+    audit: [
+        'get_server_capabilities',
+        'validate_addon',
+        'validate_generated_artifacts',
+        'inspect_addon_archive',
+    ],
+    repair: [
+        'load_instantcms_project',
+        'explain_instantcms_project',
+        'audit_instantcms_project',
+        'plan_project_changes',
+        'repair_instantcms_project',
+        'create_project_patch',
+        'audit_instantcms_project',
+    ],
+    upgrade: [
+        'explain_instantcms_project',
+        'plan_instantcms_upgrade',
+        'plan_project_changes',
+        'audit_instantcms_project',
+    ],
+};
+const toolCatalog = [
+    {
+        category: 'addon',
+        keywords: ['addon', 'дополнение', 'controller', 'crud'],
+        tools: workflows.addon,
+    },
+    {
+        category: 'database',
+        keywords: ['database', 'база', 'sql', 'migration'],
+        tools: ['introspect_database', 'describe_table', 'scaffold_migration'],
+    },
+    {
+        category: 'integration',
+        keywords: ['api', 'oauth', 'webhook', 'email'],
+        tools: ['scaffold_api', 'scaffold_oauth', 'scaffold_webhook', 'scaffold_email'],
+    },
+    {
+        category: 'template',
+        keywords: ['template', 'шаблон', 'layout', 'widget'],
+        tools: workflows.template,
+    },
+    {
+        category: 'project',
+        keywords: ['project', 'проект', 'audit', 'аудит', 'repair', 'исправ', 'upgrade', 'обнов'],
+        tools: [...workflows.repair, 'plan_instantcms_upgrade'],
+    },
+];
+function registerMetaTools(server) {
+    (0, define_tool_js_1.defineTool)(server, 'get_server_capabilities', 'Версии, профили и объём базы знаний MCP-сервера', {}, () => ({
+        server_version: '1.2.3',
+        tools_count: 100,
+        instantcms_profiles: version_profiles_js_1.instantCmsVersionProfiles,
+        knowledge: {
+            hooks: hooks_js_1.hooks.length,
+            hook_categories: hooks_js_1.hookCategories.length,
+            components: components_js_1.components.length,
+            addon_types: Object.keys(schemas_js_1.addonStructures),
+        },
+    }));
+    (0, define_tool_js_1.defineTool)(server, 'find_tool', 'Подбирает MCP-инструменты по описанию задачи', { query: zod_1.z.string().trim().min(2).max(500) }, args => {
+        const query = args.query;
+        const { matches, ranked } = (0, find_tool_js_1.findToolCategories)(query, toolCatalog);
+        return {
+            query,
+            matches: matches.length ? matches : toolCatalog,
+            ranked,
+        };
+    });
+    (0, define_tool_js_1.defineTool)(server, 'get_workflow', 'Возвращает рекомендуемую последовательность инструментов', { workflow: zod_1.z.enum(['addon', 'widget', 'template', 'audit', 'repair', 'upgrade']) }, args => {
+        const workflow = args.workflow;
+        return { workflow, tools: workflows[workflow] };
+    });
+    (0, define_tool_js_1.defineTool)(server, 'diagnose_request', 'Определяет тип InstantCMS-задачи и рекомендуемый workflow', { request: zod_1.z.string().trim().min(3).max(2000) }, args => {
+        const request = args.request;
+        const lower = request.toLowerCase();
+        const workflow = lower.includes('виджет') || lower.includes('widget')
+            ? 'widget'
+            : lower.includes('шаблон') || lower.includes('template') || lower.includes('layout')
+                ? 'template'
+                : lower.includes('провер') || lower.includes('audit')
+                    ? 'audit'
+                    : lower.includes('обнов') || lower.includes('upgrade')
+                        ? 'upgrade'
+                        : lower.includes('исправ') || lower.includes('repair')
+                            ? 'repair'
+                            : 'addon';
+        return { workflow, tools: workflows[workflow] };
+    });
+    (0, define_tool_js_1.defineToolWithManualResult)(server, 'explain_validation_error', 'Объясняет стабильный код диагностики', { code: zod_1.z.string().trim().min(2).max(100) }, args => {
+        const code = args.code;
+        const explanations = {
+            MISSING_REQUIRED_FILE: 'Добавьте обязательный файл в каталог контроллера.',
+            INVALID_BASE_CLASS: 'Проверьте наследование класса InstantCMS.',
+            INVALID_ARTIFACT_SYNTAX: 'Разберите файл соответствующим parser и исправьте синтаксис.',
+            VALIDATION_NOTICE: 'Проверьте контекст сообщения: код является общим fallback.',
+        };
+        return explanations[code]
+            ? (0, mcp_result_js_1.successResult)({ code, explanation: explanations[code] })
+            : (0, mcp_result_js_1.errorResult)('UNKNOWN_DIAGNOSTIC_CODE', `Код ${code} не документирован`);
+    });
+    (0, define_tool_js_1.defineTool)(server, 'compare_instantcms_versions', 'Сравнивает документированные профили InstantCMS', { from: zod_1.z.string(), to: zod_1.z.string() }, args => (0, version_profiles_js_1.compareVersionProfiles)(args.from, args.to));
+    (0, define_tool_js_1.defineTool)(server, 'get_project_health', 'Возвращает состояние встроенной базы и рекомендуемые проверки', {}, () => ({
+        status: 'ready',
+        server_version: '1.2.3',
+        tested_instantcms: '2.18.2',
+        checks: ['npm run check', 'npm run test:integration', 'npm run build', 'npm audit'],
+    }));
+    (0, define_tool_js_1.defineTool)(server, 'validate_generated_artifacts', 'Проверяет XML, INI, YAML и форму PHP-файлов настоящими parser-ами', { files: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).refine(files => Object.keys(files).length <= 500) }, args => (0, artifact_tool_js_1.validateGeneratedArtifacts)(args.files));
+    (0, define_tool_js_1.defineTool)(server, 'build_addon_archive', 'Создаёт ZIP дополнения в памяти и возвращает base64', { files: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).refine(files => Object.keys(files).length <= 500) }, args => (0, artifact_tool_js_1.buildAddonArchive)(args.files));
+    (0, define_tool_js_1.defineTool)(server, 'inspect_addon_archive', 'Проверяет пути и синтаксис файлов ZIP-архива base64', { archive: zod_1.z.string().max(20_000_000) }, args => (0, artifact_tool_js_1.inspectAddonArchive)(args.archive));
+}

package/dist/registry/project-tools.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProjectTools = registerProjectTools;
+const zod_1 = require("zod");
+const project_workflow_tool_js_1 = require("../tools/project-workflow-tool.js");
+const mcp_result_js_1 = require("../utils/mcp-result.js");
+const project_patch_tool_js_1 = require("../tools/project-patch-tool.js");
+const project_source_tool_js_1 = require("../tools/project-source-tool.js");
+const filesSchema = zod_1.z
+    .record(zod_1.z.string(), zod_1.z.string())
+    .refine(files => Object.keys(files).length <= 2000);
+const loadLimitsSchema = {
+    max_files: zod_1.z.number().int().min(1).max(5000).optional(),
+    max_file_bytes: zod_1.z
+        .number()
+        .int()
+        .min(1024)
+        .max(5 * 1024 * 1024)
+        .optional(),
+    max_total_bytes: zod_1.z
+        .number()
+        .int()
+        .min(1024)
+        .max(50 * 1024 * 1024)
+        .optional(),
+};
+function registerProjectTools(server) {
+    server.tool('load_instantcms_project', 'Загружает текстовые файлы проекта из локальной директории или публичного GitHub-репозитория', {
+        source: zod_1.z.discriminatedUnion('type', [
+            zod_1.z.object({ type: zod_1.z.literal('local'), path: zod_1.z.string().min(1), ...loadLimitsSchema }),
+            zod_1.z.object({
+                type: zod_1.z.literal('github'),
+                repository: zod_1.z.string().min(3),
+                ref: zod_1.z.string().min(1).default('main'),
+                subpath: zod_1.z.string().default(''),
+                ...loadLimitsSchema,
+            }),
+        ]),
+    }, async ({ source }) => (0, mcp_result_js_1.successResult)(source.type === 'local'
+        ? await (0, project_source_tool_js_1.loadLocalProject)(source.path, source)
+        : await (0, project_source_tool_js_1.loadGithubProject)(source.repository, source.ref, source.subpath, source)));
+    server.tool('create_project_patch', 'Создаёт стандартный unified Git patch между двумя project file map', { before: filesSchema, after: filesSchema }, async ({ before, after }) => (0, mcp_result_js_1.successResult)((0, project_patch_tool_js_1.createProjectPatch)(before, after)));
+    server.tool('audit_instantcms_project', 'Аудит существующего InstantCMS project file map', { files: filesSchema }, async ({ files }) => (0, mcp_result_js_1.successResult)((0, project_workflow_tool_js_1.auditInstantCmsProject)(files)));
+    server.tool('plan_project_changes', 'Строит план исправлений после аудита без изменения файлов', { files: filesSchema }, async ({ files }) => (0, mcp_result_js_1.successResult)((0, project_workflow_tool_js_1.planProjectChanges)(files)));
+    server.tool('repair_instantcms_project', 'Применяет только безопасные структурные исправления и возвращает новый file map', { files: filesSchema }, async ({ files }) => (0, mcp_result_js_1.successResult)((0, project_workflow_tool_js_1.repairInstantCmsProject)(files)));
+    server.tool('explain_instantcms_project', 'Кратко объясняет структуру существующего InstantCMS проекта', { files: filesSchema }, async ({ files }) => (0, mcp_result_js_1.successResult)((0, project_workflow_tool_js_1.explainInstantCmsProject)(files)));
+    server.tool('plan_instantcms_upgrade', 'Планирует обновление проекта между версиями InstantCMS', { files: filesSchema, from: zod_1.z.string().min(2).max(30), to: zod_1.z.string().min(2).max(30) }, async ({ files, from, to }) => (0, mcp_result_js_1.successResult)((0, project_workflow_tool_js_1.planInstantCmsUpgrade)(files, from, to)));
+}

package/dist/registry/resources.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerResources = registerResources;
+const hooks_js_1 = require("../data/hooks.js");
+const components_js_1 = require("../data/components.js");
+const schemas_js_1 = require("../data/schemas.js");
+function registerResources(server) {
+    // ═══════════════════════════════════════════════════════════════════════════
+    server.resource('instantcms-hooks-all', 'instantcms://hooks/all', { mimeType: 'application/json', description: 'Полный список хуков InstantCMS' }, async () => ({
+        contents: [
+            {
+                uri: 'instantcms://hooks/all',
+                mimeType: 'application/json',
+                text: JSON.stringify({ total: hooks_js_1.hooks.length, categories: hooks_js_1.hookCategories, hooks: hooks_js_1.hooks }, null, 2),
+            },
+        ],
+    }));
+    server.resource('instantcms-components-all', 'instantcms://components/all', { mimeType: 'application/json', description: 'Все компоненты и их API' }, async () => ({
+        contents: [
+            {
+                uri: 'instantcms://components/all',
+                mimeType: 'application/json',
+                text: JSON.stringify({ total: components_js_1.components.length, components: components_js_1.components }, null, 2),
+            },
+        ],
+    }));
+    server.resource('instantcms-addon-types', 'instantcms://addon/types', { mimeType: 'application/json', description: 'Типы дополнений и их структуры' }, async () => ({
+        contents: [
+            {
+                uri: 'instantcms://addon/types',
+                mimeType: 'application/json',
+                text: JSON.stringify(schemas_js_1.addonStructures, null, 2),
+            },
+        ],
+    }));
+    server.resource('instantcms-quickstart', 'instantcms://quickstart', { mimeType: 'text/markdown', description: 'Краткое руководство по созданию дополнения' }, async () => ({
+        contents: [
+            {
+                uri: 'instantcms://quickstart',
+                mimeType: 'text/markdown',
+                text: `# Быстрый старт: создание дополнения InstantCMS 2
+
+## 1. Минимальный набор файлов
+\`\`\`
+/system/controllers/myaddon/
+├── manifest.xml      ← метаданные и хуки
+├── install.php       ← создание таблиц
+├── uninstall.php     ← удаление таблиц
+├── frontend.php      ← контроллер (class myaddon extends cmsFrontend)
+└── model.php         ← модель (class modelMyaddon extends cmsModel)
+\`\`\`
+
+## 2. Соглашения об именовании классов
+| Файл | Класс |
+|------|-------|
+| frontend.php | \`class myaddon extends cmsFrontend\` |
+| backend.php | \`class backendMyaddon extends cmsBackend\` |
+| model.php | \`class modelMyaddon extends cmsModel\` |
+| hooks/hook_name.php | \`class onMyaddonHookName extends cmsAction\` |
+| forms/form_item.php | \`class formMyaddonItem extends cmsForm\` |
+| grids/grid_items.php | \`function grid_items($controller) { return [...]; }\` |
+| widgets/list/widget.php | \`class widgetMyaddonList extends cmsWidget\` |
+
+## 3. Базовый паттерн action
+\`\`\`php
+public function actionIndex() {
+    $items = $this->model->filterEqual('is_pub', 1)->get('myaddon_items');
+    return $this->cms_template->render('index', ['items' => $items]);
+}
+\`\`\`
+
+## 4. Регистрация хука в manifest.xml
+\`\`\`xml
+<hooks>
+    <hook controller="myaddon" name="content_after_add_approve" />
+</hooks>
+\`\`\`
+
+## 5. Файл хука hooks/content_after_add_approve.php
+\`\`\`php
+class onMyaddonContentAfterAddApprove extends cmsAction {
+    public function run($data) {
+        // логика
+        return $data; // ОБЯЗАТЕЛЬНО
+    }
+}
+\`\`\`
+
+## Инструменты MCP
+- \`scaffold_addon\` — сгенерировать все файлы дополнения
+- \`get_hook_details\` — детали хука с примером кода
+- \`get_component_api\` — API класса (cmsModel, cmsTemplate и др.)
+- \`validate_addon\` — проверить корректность структуры
+`,
+            },
+        ],
+    }));
+}

package/dist/registry/source-tools.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSourceTools = registerSourceTools;
+const zod_1 = require("zod");
+const addon_tool_js_1 = require("../tools/addon-tool.js");
+const source_tool_js_1 = require("../tools/source-tool.js");
+const migration_tool_js_1 = require("../tools/migration-tool.js");
+const requirement_tool_js_1 = require("../tools/requirement-tool.js");
+function registerSourceTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════════
+    // SOURCE CODE TOOLS (Фаза 2: Виджеты, трейты, поля)
+    // ═══════════════════════════════════════════════════════════════════════════
+    // ── 29. Список виджетов ─────────────────────────────────────────────────
+    server.tool('list_widgets', 'Список всех доступных виджетов InstantCMS. Можно фильтровать по контроллеру.', {
+        controller: zod_1.z.string().optional().describe('Фильтр по контроллеру. Пример: content, users'),
+    }, async ({ controller }) => {
+        const result = (0, source_tool_js_1.listWidgets)(controller);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 30. Информация о виджете ────────────────────────────────────────────
+    server.tool('get_widget_info', 'Подробная информация о виджете: класс, файл, настройки.', {
+        name: zod_1.z.string().describe('Имя виджета. Пример: text, menu, html'),
+    }, async ({ name }) => {
+        const result = (0, source_tool_js_1.getWidgetInfo)(name);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 31. Список трейтов ─────────────────────────────────────────────────
+    server.tool('list_traits', 'Список всех системных трейтов. Можно фильтровать по namespace.', {
+        namespace: zod_1.z
+            .string()
+            .optional()
+            .describe('Фильтр по namespace. Пример: services, controllers'),
+    }, async ({ namespace }) => {
+        const result = (0, source_tool_js_1.listTraits)(namespace);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 32. Информация о трейте ────────────────────────────────────────────
+    server.tool('get_trait_info', 'Подробная информация о трейте: методы, параметры, описание.', {
+        name: zod_1.z.string().describe('Имя трейта. Пример: fieldsParseable, listgrid'),
+    }, async ({ name }) => {
+        const result = (0, source_tool_js_1.getTraitInfo)(name);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 33. Список типов полей ─────────────────────────────────────────────
+    server.tool('list_field_types', 'Список всех типов полей для форм InstantCMS: string, text, image, list и др.', {}, async () => {
+        const result = (0, source_tool_js_1.listFields)();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 34. Информация о поле ─────────────────────────────────────────────
+    server.tool('get_field_type_info', 'Подробная информация о типе поля: класс, опции, описание.', {
+        name: zod_1.z.string().describe('Имя типа поля. Пример: string, list, image, date'),
+    }, async ({ name }) => {
+        const result = (0, source_tool_js_1.getFieldInfo)(name);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 35. Список маршрутов ───────────────────────────────────────────────
+    server.tool('list_routes', 'Список всех маршрутов (routes) системы. Маршруты определяют URL-паттерны и действия контроллеров.', {
+        controller: zod_1.z
+            .string()
+            .optional()
+            .describe('Имя контроллера для фильтрации (content, photos)'),
+    }, async ({ controller }) => {
+        const result = (0, source_tool_js_1.listRoutes)(controller);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 36. Генерация миграции ────────────────────────────────────────────
+    server.tool('generate_migration', 'Генерация SQL и PHP кода для создания таблицы. Генерирует install.php, SQL CREATE TABLE и соглашения по именованию.', {
+        name: zod_1.z
+            .string()
+            .describe('Имя таблицы (без префикса cms_). Пример: my_items, catalog_products'),
+        fields: zod_1.z
+            .array(zod_1.z.object({
+            name: zod_1.z.string().describe('Имя поля'),
+            type: zod_1.z
+                .string()
+                .describe('Тип: varchar(255), text, int(11), datetime, tinyint(1), decimal(10,2)'),
+            nullable: zod_1.z.boolean().optional().describe('Может быть NULL'),
+            default: zod_1.z.string().optional().describe('Значение по умолчанию'),
+            comment: zod_1.z.string().optional().describe('Комментарий к полю'),
+        }))
+            .describe('Массив полей таблицы'),
+    }, async ({ name, fields }) => {
+        const result = (0, migration_tool_js_1.generateMigration)(name, fields);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 36. Подсказки по полям ────────────────────────────────────────────
+    server.tool('get_field_suggestions', 'Подсказки по типичным полям для генерации миграций: string, text, number, datetime, user, bool.', {
+        field_type: zod_1.z
+            .enum(['string', 'text', 'number', 'datetime', 'user', 'bool'])
+            .describe('Тип категории полей'),
+    }, async ({ field_type }) => {
+        const result = (0, migration_tool_js_1.generateFieldSuggestions)(field_type);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 37. Анализ требований ──────────────────────────────────────────
+    server.tool('analyze_requirement', 'AI анализ запроса пользователя и предложение структуры дополнения. Определяет тип дополнения, необходимые хуки, таблицы, контроллеры.', {
+        requirement: zod_1.z
+            .string()
+            .describe("Описание задачи. Пример: 'каталог товаров с корзиной', 'блог с комментариями', 'RSS лента новостей'"),
+    }, async ({ requirement }) => {
+        const result = (0, requirement_tool_js_1.analyzeRequirement)(requirement);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 38. Структура по типу ─────────────────────────────────────────
+    server.tool('suggest_addon_structure', 'Предложить структуру файлов для типа дополнения (basic, with_admin, with_hooks, with_routes, with_widget).', {
+        type: zod_1.z
+            .enum(['basic', 'with_admin', 'with_hooks', 'with_routes', 'with_widget'])
+            .describe('Тип дополнения'),
+    }, async ({ type }) => {
+        const result = (0, requirement_tool_js_1.suggestAddonStructure)(type);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ── 39. Генерация хука ───────────────────────────────────────────────
+    server.tool('scaffold_hook', 'Генерирует PHP файл хука с полным кодом класса. Автоматически определяет параметры, тип (action/filter), формирует className.', {
+        addon_name: zod_1.z.string().describe('Имя дополнения (техническое). Пример: myaddon'),
+        hook_name: zod_1.z
+            .string()
+            .describe('Имя хука. Пример: content_after_add_approve, user_registered'),
+        type: zod_1.z
+            .enum(['action', 'filter'])
+            .optional()
+            .describe('Тип хука: action (реагирует на событие) или filter (изменяет данные)'),
+    }, async ({ addon_name, hook_name, type }) => {
+        const result = (0, addon_tool_js_1.scaffoldHook)({ addon_name, hook_name, type });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}

package/dist/registry/template-development-tools.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTemplateDevelopmentTools = registerTemplateDevelopmentTools;
+const zod_1 = require("zod");
+const template_development_tool_js_1 = require("../tools/template-development-tool.js");
+const mcp_result_js_1 = require("../utils/mcp-result.js");
+const template_productivity_tool_js_1 = require("../tools/template-productivity-tool.js");
+const templateFilesSchema = zod_1.z
+    .record(zod_1.z.string(), zod_1.z.string())
+    .refine(files => Object.keys(files).length <= 3000);
+function registerTemplateDevelopmentTools(server) {
+    server.tool('merge_template_overrides', 'Безопасно переносит upstream-изменения в неизменённые overrides и возвращает Git patch', {
+        theme_files: templateFilesSchema,
+        upstream_before: templateFilesSchema,
+        upstream_after: templateFilesSchema,
+    }, async ({ theme_files, upstream_before, upstream_after }) => (0, mcp_result_js_1.successResult)((0, template_productivity_tool_js_1.mergeTemplateOverrides)(theme_files, upstream_before, upstream_after)));
+    server.tool('audit_template_frontend', 'Проверяет HTML, accessibility, escaping и качество CSS файлов шаблона', { files: templateFilesSchema }, async ({ files }) => (0, mcp_result_js_1.successResult)((0, template_productivity_tool_js_1.auditTemplateFrontend)(files)));
+    server.tool('extract_template_design_tokens', 'Извлекает CSS custom properties, цвета и spacing и предлагает design tokens', { files: templateFilesSchema }, async ({ files }) => (0, mcp_result_js_1.successResult)((0, template_productivity_tool_js_1.extractTemplateDesignTokens)(files)));
+    server.tool('audit_template_widget_positions', 'Сопоставляет позиции виджетов в PHP-шаблонах и YAML layout-схемах', { files: templateFilesSchema }, async ({ files }) => (0, mcp_result_js_1.successResult)((0, template_productivity_tool_js_1.auditTemplateWidgetPositions)(files)));
+    server.tool('scaffold_template_e2e_environment', 'Генерирует Docker Compose и Playwright visual regression окружение для темы', {
+        theme: zod_1.z.string().regex(/^[a-z][a-z0-9_]{1,63}$/),
+        base_url: zod_1.z.string().url().optional(),
+    }, async (options) => (0, mcp_result_js_1.successResult)((0, template_productivity_tool_js_1.scaffoldTemplateE2eEnvironment)(options)));
+    server.tool('index_upstream_template_sources', 'Индексирует upstream template-файлы с SHA-256 и ссылками на исходный commit', {
+        files: templateFilesSchema,
+        repository: zod_1.z.string().regex(/^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/),
+        ref: zod_1.z.string().regex(/^[a-zA-Z0-9._/-]+$/),
+    }, async ({ files, repository, ref }) => (0, mcp_result_js_1.successResult)((0, template_productivity_tool_js_1.indexUpstreamTemplateSources)(files, { repository, ref })));
+    server.tool('scaffold_template_php_quality', 'Генерирует PHPStan, PHPCS и PHPCompatibility конфигурацию для шаблона', {
+        theme: zod_1.z.string().regex(/^[a-z][a-z0-9_]{1,63}$/),
+        php_min: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+$/)
+            .optional()
+            .default('7.2'),
+    }, async (options) => (0, mcp_result_js_1.successResult)((0, template_productivity_tool_js_1.scaffoldTemplatePhpQuality)(options)));
+    server.tool('scaffold_complete_template', 'Создаёт полный каркас frontend-шаблона InstantCMS и импортируемую layout-схему', {
+        name: zod_1.z.string().regex(/^[a-z][a-z0-9_]{1,63}$/),
+        title: zod_1.z.string().trim().min(1).max(200),
+        author: zod_1.z.string().trim().max(200).optional(),
+        inherit: zod_1.z
+            .array(zod_1.z.string().regex(/^[a-z][a-z0-9_]{1,63}$/))
+            .max(10)
+            .optional(),
+        with_layout_scheme: zod_1.z.boolean().optional().default(true),
+    }, async (options) => (0, mcp_result_js_1.successResult)((0, template_development_tool_js_1.scaffoldCompleteTemplate)(options)));
+    server.tool('analyze_instantcms_template', 'Анализирует структуру, overrides, widget positions, layout-файлы и риски шаблона', {
+        files: templateFilesSchema,
+        theme: zod_1.z
+            .string()
+            .regex(/^[a-z][a-z0-9_]{1,63}$/)
+            .optional(),
+    }, async ({ files, theme }) => (0, mcp_result_js_1.successResult)((0, template_development_tool_js_1.analyzeInstantCmsTemplate)(files, theme)));
+    server.tool('scaffold_template_override', 'Создаёт точную копию upstream template-файла в правильном каталоге override темы', {
+        theme: zod_1.z.string().regex(/^[a-z][a-z0-9_]{1,63}$/),
+        source_path: zod_1.z.string().min(1).max(500),
+        source_content: zod_1.z.string().max(2 * 1024 * 1024),
+        controller: zod_1.z
+            .string()
+            .regex(/^[a-z][a-z0-9_]{1,63}$/)
+            .optional(),
+        action: zod_1.z
+            .string()
+            .regex(/^[a-z][a-z0-9_]{0,63}$/)
+            .optional(),
+        backend: zod_1.z.boolean().optional(),
+    }, async (options) => (0, mcp_result_js_1.successResult)((0, template_development_tool_js_1.scaffoldTemplateOverride)(options)));
+    server.tool('validate_layout_scheme', 'Проверяет YAML-синтаксис, layout root и widget positions схемы InstantCMS', {
+        yaml: zod_1.z
+            .string()
+            .min(1)
+            .max(2 * 1024 * 1024),
+    }, async ({ yaml }) => (0, mcp_result_js_1.successResult)((0, template_development_tool_js_1.validateLayoutScheme)(yaml)));
+    server.tool('check_template_override_compatibility', 'Сравнивает overrides темы с upstream template-файлами до и после обновления InstantCMS', {
+        theme_files: templateFilesSchema,
+        upstream_before: templateFilesSchema,
+        upstream_after: templateFilesSchema,
+    }, async ({ theme_files, upstream_before, upstream_after }) => (0, mcp_result_js_1.successResult)((0, template_development_tool_js_1.checkTemplateOverrideCompatibility)(theme_files, upstream_before, upstream_after)));
+}

package/dist/server.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const meta_tools_js_1 = require("./registry/meta-tools.js");
+const generator_tools_js_1 = require("./registry/generator-tools.js");
+const knowledge_tools_js_1 = require("./registry/knowledge-tools.js");
+const database_tools_js_1 = require("./registry/database-tools.js");
+const source_tools_js_1 = require("./registry/source-tools.js");
+const language_tools_js_1 = require("./registry/language-tools.js");
+const extension_tools_js_1 = require("./registry/extension-tools.js");
+const resources_js_1 = require("./registry/resources.js");
+const project_tools_js_1 = require("./registry/project-tools.js");
+const template_development_tools_js_1 = require("./registry/template-development-tools.js");
+function createServer() {
+    const server = new mcp_js_1.McpServer({
+        name: 'instantcms-mcp',
+        version: '1.2.0',
+        description: 'MCP сервер для разработки дополнений и шаблонов InstantCMS 2',
+    });
+    (0, meta_tools_js_1.registerMetaTools)(server);
+    (0, generator_tools_js_1.registerGeneratorTools)(server);
+    (0, knowledge_tools_js_1.registerKnowledgeTools)(server);
+    (0, database_tools_js_1.registerDatabaseTools)(server);
+    (0, source_tools_js_1.registerSourceTools)(server);
+    (0, language_tools_js_1.registerLanguageTools)(server);
+    (0, extension_tools_js_1.registerExtensionTools)(server);
+    (0, resources_js_1.registerResources)(server);
+    (0, project_tools_js_1.registerProjectTools)(server);
+    (0, template_development_tools_js_1.registerTemplateDevelopmentTools)(server);
+    return server;
+}