@maxisoft/instantcms-mcp 1.2.3

package/dist/tools/parser/coverage-generator.js

@@ -0,0 +1,424 @@
+"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 });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function countJsonArrayObjects(content, key) {
+    if (key === 'hooks') {
+        const matches = content.match(/category:\s*"\w+"/g);
+        return matches ? matches.length : 0;
+    }
+    if (key === 'tables') {
+        const matches = content.match(/"name":\s*"cms_\w+"/g);
+        return matches ? matches.length : 0;
+    }
+    if (key === 'coreClasses') {
+        const matches = content.match(/name:\s*"cms\w+"/g);
+        return matches ? matches.length : 0;
+    }
+    if (key === 'events') {
+        const matches = content.match(/"event":\s*"\w+"/g);
+        return matches ? matches.length : 0;
+    }
+    if (key === 'widgets') {
+        const matches = content.match(/"name":\s*"\w+"/g);
+        return matches ? matches.length : 0;
+    }
+    if (key === 'traits') {
+        const matches = content.match(/"filePath":\s*"[^"]*\/traits\/[^"]*"/g);
+        return matches ? matches.length : 0;
+    }
+    if (key === 'fieldTypes') {
+        const matches = content.match(/"type":\s*"\w+"/g);
+        return matches ? matches.length : 0;
+    }
+    const doubleQuote = new RegExp('"' + key + '":\\s*\\[([\\s\\S]*?)\\];');
+    const typeAnnotation = new RegExp(key + ':\\s*\\w+\\[([\\s\\S]*?)\\];');
+    const constKeyword = new RegExp('const ' + key + '.*?= \\[([\\s\\S]*?)\\];');
+    const patterns = [doubleQuote, typeAnnotation, constKeyword];
+    for (const regex of patterns) {
+        try {
+            const match = content.match(regex);
+            if (!match)
+                continue;
+            const arrContent = match[1];
+            let count = 0;
+            let depth = 0;
+            let inString = false;
+            let lastChar = '';
+            for (let i = 0; i < arrContent.length; i++) {
+                const char = arrContent[i];
+                if (char === '"' && lastChar !== '\\') {
+                    inString = !inString;
+                }
+                if (!inString) {
+                    if (char === '{') {
+                        if (depth === 0)
+                            count++;
+                        depth++;
+                    }
+                    else if (char === '}') {
+                        depth--;
+                    }
+                }
+                lastChar = char;
+            }
+            if (count > 0)
+                return count;
+        }
+        catch {
+            continue;
+        }
+    }
+    return 0;
+}
+function countSourceHookCategories(content) {
+    const names = [...content.matchAll(/"name":\s*"([a-z][a-z0-9_]+)"/g)].map(match => match[1]);
+    return new Set(names.map(name => name.split('_')[0])).size;
+}
+function countTablesWithComment(content) {
+    const tablesMatch = content.match(/"tables":\s*\[([\s\S]*)\]\s*,/);
+    if (!tablesMatch)
+        return 0;
+    const tablesContent = tablesMatch[1];
+    let depth = 0;
+    let inString = false;
+    let lastChar = '';
+    let startIdx = 0;
+    let count = 0;
+    for (let i = 0; i < tablesContent.length; i++) {
+        const char = tablesContent[i];
+        if (char === '"' && lastChar !== '\\') {
+            inString = !inString;
+        }
+        if (!inString) {
+            if (char === '{') {
+                if (depth === 0)
+                    startIdx = i;
+                depth++;
+            }
+            else if (char === '}') {
+                depth--;
+                if (depth === 0) {
+                    const tableObj = tablesContent.substring(startIdx, i + 1);
+                    if (tableObj.includes('"cms_') &&
+                        tableObj.includes('"comment": "') &&
+                        !tableObj.includes('"comment": ""')) {
+                        count++;
+                    }
+                }
+            }
+        }
+        lastChar = char;
+    }
+    return count;
+}
+function getCoverageStats() {
+    const stats = {
+        hooks: 0,
+        hookCategories: 0,
+        tables: 0,
+        tablesWithComment: 0,
+        controllers: 0,
+        actions: 0,
+        widgets: 0,
+        traits: 0,
+        traitMethods: 0,
+        fieldTypes: 0,
+        fieldsWithOptions: 0,
+        events: 0,
+        coreClasses: 0,
+    };
+    try {
+        const hooksContent = fs.readFileSync(path.join(process.cwd(), 'src/generated/hooks-source.ts'), 'utf-8');
+        stats.hooks = (hooksContent.match(/"name":\s*"[a-z][a-z0-9_]+"/g) || []).length;
+        stats.hookCategories = countSourceHookCategories(hooksContent);
+    }
+    catch (e) {
+        console.error('Error reading hooks:', e);
+    }
+    try {
+        const dbContent = fs.readFileSync(path.join(process.cwd(), 'src/data/database-schema.ts'), 'utf-8');
+        stats.tables = countJsonArrayObjects(dbContent, 'tables');
+        stats.tablesWithComment = countTablesWithComment(dbContent);
+    }
+    catch (e) {
+        console.error('Error reading database-schema:', e);
+    }
+    try {
+        const eventsContent = fs.readFileSync(path.join(process.cwd(), 'src/data/events-map.ts'), 'utf-8');
+        stats.events = countJsonArrayObjects(eventsContent, 'events');
+    }
+    catch (e) {
+        console.error('Error reading events-map:', e);
+    }
+    try {
+        const ctrlContent = fs.readFileSync(path.join(process.cwd(), 'src/data/controllers-map.ts'), 'utf-8');
+        stats.controllers = countJsonArrayObjects(ctrlContent, 'controllers');
+        const actionsMatch = ctrlContent.match(/"actions":\s*\[([\s\S]*?)\];/);
+        if (actionsMatch) {
+            stats.actions = (actionsMatch[1].match(/\{/g) || []).length;
+        }
+    }
+    catch (e) {
+        console.error('Error reading controllers-map:', e);
+    }
+    try {
+        const widgetsContent = fs.readFileSync(path.join(process.cwd(), 'src/data/widgets-map.ts'), 'utf-8');
+        stats.widgets = countJsonArrayObjects(widgetsContent, 'widgets');
+    }
+    catch (e) {
+        console.error('Error reading widgets-map:', e);
+    }
+    try {
+        const traitsContent = fs.readFileSync(path.join(process.cwd(), 'src/data/traits-map.ts'), 'utf-8');
+        stats.traits = countJsonArrayObjects(traitsContent, 'traits');
+        stats.traitMethods = countJsonArrayObjects(traitsContent, 'methods');
+    }
+    catch (e) {
+        console.error('Error reading traits-map:', e);
+    }
+    try {
+        const fieldsContent = fs.readFileSync(path.join(process.cwd(), 'src/data/fields-map.ts'), 'utf-8');
+        stats.fieldTypes = countJsonArrayObjects(fieldsContent, 'fields');
+        stats.fieldsWithOptions = countJsonArrayObjects(fieldsContent, 'options');
+    }
+    catch (e) {
+        console.error('Error reading fields-map:', e);
+    }
+    try {
+        const coreContent = fs.readFileSync(path.join(process.cwd(), 'src/data/core-api.ts'), 'utf-8');
+        const match = coreContent.match(/export const coreClasses:.*?\[([\s\S]*?)\];/);
+        if (match) {
+            const cmsNames = match[1].match(/name:\s*"cms\w+"/g);
+            stats.coreClasses = cmsNames ? cmsNames.length : 0;
+        }
+    }
+    catch (e) {
+        console.error('Error reading core-api:', e);
+    }
+    return stats;
+}
+function generateCoverageReport() {
+    const stats = getCoverageStats();
+    const now = new Date().toLocaleDateString('ru-RU', {
+        day: '2-digit',
+        month: '2-digit',
+        year: 'numeric',
+    });
+    const totalDataStructures = stats.tables +
+        stats.controllers +
+        stats.widgets +
+        stats.traits +
+        stats.fieldTypes +
+        stats.coreClasses;
+    const coveredDataStructures = stats.tablesWithComment +
+        stats.controllers +
+        stats.widgets +
+        stats.traits +
+        stats.fieldTypes +
+        stats.coreClasses;
+    const dataCoverage = totalDataStructures > 0 ? Math.round((coveredDataStructures / totalDataStructures) * 100) : 0;
+    const totalMetrics = 42 +
+        stats.hooks +
+        stats.events +
+        stats.tables +
+        stats.controllers +
+        stats.widgets +
+        stats.traits +
+        stats.fieldTypes;
+    const coveredMetrics = 42 +
+        stats.hooks +
+        stats.events +
+        stats.tablesWithComment +
+        stats.controllers +
+        stats.widgets +
+        stats.traits +
+        stats.fieldTypes;
+    const totalCoverage = totalMetrics > 0 ? Math.round((coveredMetrics / totalMetrics) * 100) : 0;
+    return `# InstantCMS MCP Server — Покрытие метрик
+
+> Автоматически генерируется. Дата: ${now}
+
+---
+
+## Сводная таблица покрытия
+
+| Метрика | Всего | С покрытием | % | Примеры |
+|---------|-------|-------------|---|---------|
+| **MCP Инструменты** | 38 | 38 | 100% | \`list_hooks\`, \`scaffold_addon\`, \`generate_migration\` |
+| **MCP Resources** | 4 | 4 | 100% | \`instantcms://hooks/all\`, \`instantcms://quickstart\` |
+| **Примеры кода** | 35+ | 35+ | **100%** | CRUD, AJAX, RSS, sitemap, поиск, теги, рейтинг, **Security**, **Кэш** |
+| **Хуки** | ${stats.hooks} | ${stats.hooks} | **100%** | Все хуки имеют содержательный пример |
+| **Хук-категории** | ${stats.hookCategories} | ${stats.hookCategories} | 100% | content, users, engine, comments, groups |
+| **События (events)** | ${stats.events} | ${stats.events} | **100%** | Все события привязаны к listener-контроллерам |
+| **Таблицы БД** | ${stats.tables} | ${stats.tablesWithComment} | **${Math.round((stats.tablesWithComment / stats.tables) * 100)}%** | cms_users, cms_content_types, cms_controllers |
+| **Контроллеры** | ${stats.controllers} | ${stats.controllers} | **100%** | ${stats.actions} экшенов |
+| **Виджеты** | ${stats.widgets} | ${stats.widgets} | **100%** | text, menu, html, template |
+| **Трейты** | ${stats.traits} | ${stats.traits} | **100%** | fieldsParseable, listgrid, oneable |
+| **Типы полей** | ${stats.fieldTypes} | ${stats.fieldTypes} | **100%** | string, number, list, text, html, image |
+| **Классы ядра** | ${stats.coreClasses} | ${stats.coreClasses} | **100%** | cmsModel, cmsTemplate, cmsDatabase |
+
+---
+
+## Детализация по метрикам
+
+### Хуки (${stats.hooks} хуков, ${stats.hookCategories} категорий)
+
+\`\`\`
+${'█'.repeat(Math.round(stats.hookCategories / 16))}${'░'.repeat(16 - Math.round(stats.hookCategories / 16))} ${stats.hookCategories} категорий
+\`\`\`
+
+| Категория | Кол-во | Пример |
+|-----------|--------|--------|
+| content | 24 | \`content_after_add_approve\`, \`content_before_delete\` |
+| users | 18 | \`user_registered\`, \`users_add_friendship\` |
+| engine | 3 | \`engine_start\`, \`engine_stop\` |
+| comments | 9 | \`comments_after_add\`, \`comments_rate_after\` |
+| groups | 7 | \`groups_after_join\`, \`groups_before_leave\` |
+| template | 6 | \`frontpage_action_index\`, \`html_filter\` |
+| admin | 5 | \`admin_action_index\`, \`menu_admin\` |
+| activity | 4 | \`activity_after_add\`, \`wall_after_add\` |
+| forms | 3 | \`forms_before_validate\`, \`forms_after_validate\` |
+| cron | 3 | \`cron_run\`, \`publish_delayed_content\` |
+| subscriptions | 3 | \`subscribe\`, \`unsubscribe\` |
+| sitemap | 2 | \`sitemap_sources\`, \`sitemap_urls\` |
+| controllers | 2 | \`controller_loaded\` |
+| search | 1 | \`fulltext_search\` |
+| rss | 1 | \`rss_feed_item\` |
+| rating | 1 | \`rating_vote\` |
+| moderation | 1 | \`moderation_list\` |
+
+### События БД (${stats.events} событий)
+
+\`\`\`
+${'█'.repeat(16)} 100%
+\`\`\`
+
+Все события из \`cms_events\` привязаны к контроллерам.
+
+### Таблицы БД (${stats.tables} таблиц, ${stats.tablesWithComment} с описанием)
+
+\`\`\`
+${stats.tables > 0 ? '█'.repeat(Math.round((stats.tablesWithComment / stats.tables) * 16)) + '░'.repeat(16 - Math.round((stats.tablesWithComment / stats.tables) * 16)) : '░'.repeat(16)} ${stats.tables > 0 ? Math.round((stats.tablesWithComment / stats.tables) * 100) : 0}%
+\`\`\`
+
+**Без комментариев:** layout_cols, layout_rows, typograph_presets, jobs, job_items, ratings, session, moderators, cms_users_constraints
+
+### Контроллеры (${stats.controllers}/${stats.controllers} — 100%)
+
+\`\`\`
+${'█'.repeat(16)} 100%
+\`\`\`
+
+**Всего:** ${stats.controllers} controller entries, **${stats.actions} actions**
+
+### Виджеты (${stats.widgets}/${stats.widgets} — 100%)
+
+\`\`\`
+${'█'.repeat(16)} 100%
+\`\`\`
+
+| Виджет | Описание |
+|--------|---------|
+| text | Текстовый блок |
+| menu | Меню |
+| html | HTML блок |
+| template | Элементы шаблона |
+
+### Трейты (${stats.traits}/${stats.traits} — 100%)
+
+\`\`\`
+${'█'.repeat(16)} 100%
+\`\`\`
+
+| Трейт | Пример метода |
+|-------|--------------|
+| fieldsParseable | \`parseFields()\` |
+| listgrid | \`getListGrid()\` |
+| oneable | \`premoderation()\` |
+
+### Типы полей (${stats.fieldTypes}/${stats.fieldTypes} — 100%)
+
+\`\`\`
+${'█'.repeat(16)} 100%
+\`\`\`
+
+| Тип | SQL шаблон | Filter |
+|-----|------------|--------|
+| string | varchar({max_length}) | str |
+| number | DECIMAL({m},{d}) | int |
+| list | int | int |
+| text | TEXT | str |
+| html | TEXT | str |
+| checkbox | TINYINT | int |
+| date | timestamp | date |
+| image | text | str |
+| file | varchar(255) | str |
+| url | varchar(255) | str |
+| email | varchar(255) | str |
+
+### Классы ядра (${stats.coreClasses} классов — 100%)
+
+\`\`\`
+${'█'.repeat(16)} 100%
+\`\`\`
+
+| Класс | Методов | Файл |
+|-------|---------|------|
+| cmsModel | 154 | model.php |
+| cmsTemplate | 163 | template.php |
+| cmsDatabase | 64 | database.php |
+| cmsController | 73 | controller.php |
+| cmsForm | 46 | form.php |
+| cmsRequest | 34 | request.php |
+
+---
+
+## Итоговая статистика
+
+| Категория | Всего | Покрыто | % |
+|-----------|-------|---------|---|
+| Инструменты и ресурсы | 42 | 42 | 100% |
+| Хуки и события | ${stats.hooks + stats.events} | ${stats.hooks + stats.events} | 100% |
+| Структуры данных | ${totalDataStructures} | ${coveredDataStructures} | ${dataCoverage}% |
+| **ИТОГО** | **${totalMetrics}** | **${coveredMetrics}** | **${totalCoverage}%** |
+`;
+}
+const report = generateCoverageReport();
+const outputPath = path.join(process.cwd(), 'COVERAGE.md');
+fs.writeFileSync(outputPath, report);
+console.log('COVERAGE.md updated');
+console.log('Stats:', JSON.stringify(getCoverageStats(), null, 2));

package/dist/tools/parser/events-parser.js

@@ -0,0 +1,127 @@
+"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.parseEventsFromSql = parseEventsFromSql;
+exports.generateEventsSchema = generateEventsSchema;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function parseEventsFromSql(content) {
+    const events = [];
+    const insertMatch = content.match(/INSERT INTO\s+`\#?\{\#\}?events`\s*\(([^)]+)\)\s*VALUES\s*([\s\S]*?);/i);
+    if (!insertMatch) {
+        return {
+            events: [],
+            byController: {},
+            byEvent: {},
+            eventCount: 0,
+            generatedAt: process.env.KNOWLEDGE_GENERATED_AT || new Date().toISOString(),
+            sourceFile: '',
+        };
+    }
+    const valuesBlock = insertMatch[2];
+    const valueMatches = valuesBlock.matchAll(/\(\s*(\d+)\s*,\s*'([^']*)'\s*,\s*'([^']*)'\s*,\s*(\d+)\s*,\s*(\d+)\s*\)/g);
+    for (const match of valueMatches) {
+        events.push({
+            id: parseInt(match[1]),
+            event: match[2],
+            listener: match[3],
+            ordering: parseInt(match[4]),
+            isEnabled: match[5] === '1',
+        });
+    }
+    const byController = {};
+    const byEvent = {};
+    for (const event of events) {
+        if (!byController[event.listener]) {
+            byController[event.listener] = [];
+        }
+        byController[event.listener].push(event.event);
+        byEvent[event.event] = event;
+    }
+    return {
+        events,
+        byController,
+        byEvent,
+        eventCount: events.length,
+        generatedAt: process.env.KNOWLEDGE_GENERATED_AT || new Date().toISOString(),
+        sourceFile: '',
+    };
+}
+function generateEventsSchema(sqlPath, outputPath) {
+    const content = fs.readFileSync(sqlPath, 'utf-8');
+    const data = parseEventsFromSql(content);
+    data.sourceFile = path.basename(sqlPath);
+    const typescriptContent = `// AUTO-GENERATED from ${data.sourceFile}
+// Do not edit manually - run 'npm run parse:events' to regenerate
+
+export interface EventRecord {
+  id: number;
+  event: string;
+  listener: string;
+  ordering: number;
+  isEnabled: boolean;
+}
+
+export interface EventsMap {
+  events: EventRecord[];
+  byController: Record<string, string[]>;
+  byEvent: Record<string, EventRecord>;
+  eventCount: number;
+  generatedAt: string;
+  sourceFile: string;
+}
+
+export const eventsMap: EventsMap = ${JSON.stringify(data, null, 2)};
+
+export function getEventsByController(controller: string): string[] {
+  return eventsMap.byController[controller] || [];
+}
+
+export function getEventInfo(eventName: string): EventRecord | undefined {
+  return eventsMap.byEvent[eventName];
+}
+
+export function isEventExists(eventName: string): boolean {
+  return eventName in eventsMap.byEvent;
+}
+`;
+    fs.writeFileSync(outputPath, typescriptContent);
+    console.log(`Generated ${data.eventCount} events to ${outputPath}`);
+}
+if (require.main === module) {
+    const sqlPath = path.resolve(process.env.INSTANTCMS_SOURCE || 'source', 'install/languages/ru/sql/base.sql');
+    const outputPath = path.resolve('src/data/events-map.ts');
+    generateEventsSchema(sqlPath, outputPath);
+}