viberadar 0.3.140 → 0.3.142

package/dist/server/index.js

@@ -1499,6 +1499,107 @@ function buildScreenshotInstructions(featureKey, routes) {
         `- Под каждым скриншотом — курсивная подпись: *Экран входа в систему*`,
     ].join('\n');
 }
+function buildScenarioPrompt(scenario, featureDocs, currentDoc, nextVersion) {
+    const outPath = `docs/scenarios/${scenario.key}/v${nextVersion}.md`;
+    const isFirstVersion = nextVersion === 1;
+    const featureDocBlocks = featureDocs.map(fd => `### Документация фичи "${fd.label}" (${fd.key}):\n${fd.content.slice(0, 3000)}${fd.content.length > 3000 ? '\n...(обрезано)' : ''}`).join('\n\n');
+    if (isFirstVersion) {
+        return [
+            `Напиши пользовательский сценарий "${scenario.label}".`,
+            ``,
+            scenario.description ? `Цель сценария: ${scenario.description}` : '',
+            ``,
+            `Сценарий охватывает следующие фичи (в порядке шагов): ${scenario.featureKeys.join(' → ')}`,
+            ``,
+            `Ниже — документация по каждой задействованной фиче. Используй её как источник информации:`,
+            ``,
+            featureDocBlocks,
+            ``,
+            `Задача:`,
+            `1. Напиши единый пошаговый сценарий от лица пользователя`,
+            `2. Каждый шаг должен быть конкретным действием: что открыть, что нажать, что ввести`,
+            `3. Переходы между фичами должны быть плавными — пользователь не видит "фичей", он видит задачу`,
+            ``,
+            `Структура документа:`,
+            `# ${scenario.label}`,
+            `> одна строка — какую задачу решает пользователь`,
+            ``,
+            `## Что понадобится`,
+            `- список предусловий (что должно быть настроено/готово заранее)`,
+            ``,
+            `## Шаги`,
+            `### Шаг 1. [Название действия]`,
+            `(описание + что пользователь видит в итоге)`,
+            `### Шаг 2. ...`,
+            `(и т.д.)`,
+            ``,
+            `## Результат`,
+            `Что пользователь получил в итоге всего сценария.`,
+            ``,
+            `## Возможные проблемы`,
+            `Таблица | Проблема | Решение |`,
+            ``,
+            `Требования:`,
+            `- Простой язык без технических терминов`,
+            `- Не упоминать компоненты, файлы, API`,
+            `- Описывать только то, что видит пользователь`,
+            `- Запиши результат в: ${outPath}`,
+            `- Создай директорию docs/scenarios/${scenario.key}/ если её нет`,
+        ].filter(Boolean).join('\n');
+    }
+    return [
+        `Актуализируй пользовательский сценарий "${scenario.label}".`,
+        ``,
+        `Текущая версия документа (v${nextVersion - 1}):`,
+        `${currentDoc?.slice(0, 2000) || '(пусто)'}`,
+        ``,
+        `Актуальная документация по фичам сценария:`,
+        ``,
+        featureDocBlocks,
+        ``,
+        `Задача: обнови сценарий с учётом изменений в фичах. Сохрани структуру и стиль.`,
+        `Запиши результат в: ${outPath}`,
+        `Создай директорию docs/scenarios/${scenario.key}/ если её нет`,
+    ].filter(Boolean).join('\n');
+}
+function buildGenerateScenariosPrompt(features, configPath, existingConfig) {
+    const featureList = features.map(f => `- ${f.key}: "${f.label}"${f.description ? ` — ${f.description}` : ''}`).join('\n');
+    return [
+        `Проанализируй список фич продукта и сгенерируй 15 реалистичных пользовательских сценариев (user journeys).`,
+        ``,
+        `Фичи продукта:`,
+        featureList,
+        ``,
+        `Требования к сценариям:`,
+        `1. Каждый сценарий описывает реальный путь пользователя — от цели к результату`,
+        `2. Каждый сценарий задействует 2-4 фичи из списка выше`,
+        `3. Ключи сценариев — латиница через дефис, отражают суть: "first-login", "export-report"`,
+        `4. Сценарии охватывают разные типы пользователей и задачи (онбординг, повседневные задачи, edge-cases)`,
+        `5. НЕ повторяй фичи/темы — каждый сценарий уникален`,
+        ``,
+        `Запиши сценарии в файл ${configPath}, добавив секцию "scenarios" к существующему конфигу.`,
+        ``,
+        `Существующий конфиг:`,
+        existingConfig || '{}',
+        ``,
+        `Формат секции "scenarios":`,
+        `{`,
+        `  "scenarios": {`,
+        `    "ключ-сценария": {`,
+        `      "label": "Человеческое название (на русском)",`,
+        `      "description": "Одно предложение — что пользователь хочет достичь",`,
+        `      "features": ["feature-key-1", "feature-key-2"]`,
+        `    }`,
+        `  }`,
+        `}`,
+        ``,
+        `Важно:`,
+        `- Используй ТОЛЬКО ключи фич из списка выше для поля "features"`,
+        `- Не ломай существующий конфиг — добавь/замени только секцию "scenarios"`,
+        `- Ровно 15 сценариев`,
+        `- label на русском языке, description на русском`,
+    ].join('\n');
+}
 function buildActualizeDocsPrompt(feat, modules, currentDoc, nextVersion, changedFiles, screenshotsCaptured = false) {
     const sourceFiles = modules
         .filter(m => m.featureKeys.includes(feat.key) && m.type !== 'test' && !m.isInfra)
@@ -2219,6 +2320,56 @@ function startServer({ data: initialData, port, projectRoot }) {
                 }
                 prompt = buildActualizeDocsPrompt(feat, currentData.modules, currentDoc, nextVersion, changedFiles, screenshotsCaptured);
             }
+            else if (task === 'actualize-scenario') {
+                const scenarioKey = featureKey; // reuse featureKey param as scenarioKey
+                if (!scenarioKey || !currentData.scenarios) {
+                    failBeforeStart('Сценарий не найден');
+                    return;
+                }
+                const scenarioStatus = currentData.scenarios.scenarios.find((s) => s.key === scenarioKey);
+                if (!scenarioStatus) {
+                    failBeforeStart(`Сценарий ${scenarioKey} не найден`);
+                    return;
+                }
+                const latestVer = scenarioStatus.latestVersion ?? null;
+                const nextVer = (latestVer ?? 0) + 1;
+                let currentDoc = null;
+                if (latestVer !== null) {
+                    try {
+                        currentDoc = fs.readFileSync(path.join(projectRoot, 'docs', 'scenarios', scenarioKey, `v${latestVer}.md`), 'utf-8');
+                    }
+                    catch { }
+                }
+                // Read latest docs for each referenced feature
+                const featureDocs = [];
+                for (const fk of scenarioStatus.featureKeys) {
+                    const fLabel = scenarioStatus.featureLabels[scenarioStatus.featureKeys.indexOf(fk)] || fk;
+                    const fDocDir = path.join(projectRoot, 'docs', 'features', fk);
+                    try {
+                        const entries = fs.readdirSync(fDocDir);
+                        const versions = entries
+                            .map((e) => { const m = e.match(/^v(\d+)\.md$/); return m ? { file: e, n: parseInt(m[1], 10) } : null; })
+                            .filter((x) => x !== null)
+                            .sort((a, b) => b.n - a.n);
+                        if (versions.length) {
+                            const content = fs.readFileSync(path.join(fDocDir, versions[0].file), 'utf-8');
+                            featureDocs.push({ key: fk, label: fLabel, content });
+                        }
+                    }
+                    catch { }
+                }
+                prompt = buildScenarioPrompt(scenarioStatus, featureDocs, currentDoc, nextVer);
+            }
+            else if (task === 'generate-scenarios') {
+                const configFilePath = path.join(projectRoot, 'viberadar.config.json');
+                let existingConfig = null;
+                try {
+                    existingConfig = fs.readFileSync(configFilePath, 'utf-8');
+                }
+                catch { }
+                const feats = (currentData.features || []).map((f) => ({ key: f.key, label: f.label, description: f.description }));
+                prompt = buildGenerateScenariosPrompt(feats, 'viberadar.config.json', existingConfig);
+            }
             else if (task === 'generate-pipelines') {
                 if (!featureKey || !currentData.features) {
                     failBeforeStart('Фича не найдена');
@@ -2790,6 +2941,17 @@ function startServer({ data: initialData, port, projectRoot }) {
                 const label = meta?.fieldName ? `поле ${meta.fieldName}` : meta?.recommendationType || 'логи';
                 title = `${agentLabel} — ${label} (${count} модулей)`;
             }
+            else if (task === 'actualize-docs') {
+                const feat = currentData.features?.find(f => f.key === featureKey);
+                title = feat ? `${agentLabel} — документация "${feat.label}"` : `${agentLabel} — документация`;
+            }
+            else if (task === 'actualize-scenario') {
+                const sc = currentData.scenarios?.scenarios.find((s) => s.key === featureKey);
+                title = sc ? `${agentLabel} — сценарий "${sc.label}"` : `${agentLabel} — сценарий`;
+            }
+            else if (task === 'generate-scenarios') {
+                title = `${agentLabel} — генерация 15 сценариев`;
+            }
             else if (task === 'generate-pipelines') {
                 const feat = currentData.features?.find(f => f.key === featureKey);
                 if (!feat) {
@@ -3551,6 +3713,32 @@ function startServer({ data: initialData, port, projectRoot }) {
                 return;
             }
             // ── Documentation API ─────────────────────────────────────────────────────
+            if (url === '/api/scenarios/content' && req.method === 'GET') {
+                const scenarioKey = parsedUrl.searchParams.get('scenario');
+                if (!scenarioKey) {
+                    res.writeHead(400, jsonH);
+                    res.end(JSON.stringify({ error: 'Missing scenario param' }));
+                    return;
+                }
+                const docDir = path.join(projectRoot, 'docs', 'scenarios', scenarioKey);
+                try {
+                    const entries = fs.readdirSync(docDir);
+                    const versions = entries
+                        .map(e => { const m = e.match(/^v(\d+)\.md$/); return m ? { file: e, n: parseInt(m[1], 10) } : null; })
+                        .filter((x) => x !== null)
+                        .sort((a, b) => b.n - a.n);
+                    if (versions.length === 0)
+                        throw new Error('no versions');
+                    const content = fs.readFileSync(path.join(docDir, versions[0].file), 'utf-8');
+                    res.writeHead(200, jsonH);
+                    res.end(JSON.stringify({ content, exists: true, version: versions[0].n }));
+                }
+                catch {
+                    res.writeHead(200, jsonH);
+                    res.end(JSON.stringify({ content: null, exists: false }));
+                }
+                return;
+            }
             if (url === '/api/docs/content' && req.method === 'GET') {
                 const featureKey = parsedUrl.searchParams.get('feature');
                 if (!featureKey) {
@@ -3655,6 +3843,25 @@ function startServer({ data: initialData, port, projectRoot }) {
             if (url.startsWith('/api/docs/export/md') && req.method === 'GET') {
                 try {
                     const featureKey = parsedUrl.searchParams.get('feature');
+                    const scenarioKey = parsedUrl.searchParams.get('scenario');
+                    const translit = (s) => { const m = { а: 'a', б: 'b', в: 'v', г: 'g', д: 'd', е: 'e', ё: 'yo', ж: 'zh', з: 'z', и: 'i', й: 'j', к: 'k', л: 'l', м: 'm', н: 'n', о: 'o', п: 'p', р: 'r', с: 's', т: 't', у: 'u', ф: 'f', х: 'h', ц: 'ts', ч: 'ch', ш: 'sh', щ: 'sch', ъ: '', ы: 'y', ь: '', э: 'e', ю: 'yu', я: 'ya' }; return s.toLowerCase().split('').map(c => m[c] ?? c).join('').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, ''); };
+                    // Scenario export
+                    if (scenarioKey) {
+                        const scenario = currentData.scenarios?.scenarios.find((s) => s.key === scenarioKey);
+                        if (!scenario?.docExists) {
+                            res.writeHead(404, jsonH);
+                            res.end(JSON.stringify({ error: 'Scenario doc not found' }));
+                            return;
+                        }
+                        const docDir = path.join(projectRoot, 'docs', 'scenarios', scenarioKey);
+                        const entries = fs.readdirSync(docDir);
+                        const versions = entries.map((e) => { const mv = e.match(/^v(\d+)\.md$/); return mv ? { file: e, n: parseInt(mv[1], 10) } : null; }).filter((x) => x !== null).sort((a, b) => b.n - a.n);
+                        const content = fs.readFileSync(path.join(docDir, versions[0].file), 'utf-8');
+                        const buf = Buffer.from(content, 'utf-8');
+                        res.writeHead(200, { 'Content-Type': 'text/markdown; charset=utf-8', 'Content-Disposition': `attachment; filename="${translit(scenario.label)}-scenario-v${scenario.latestVersion}.md"`, 'Content-Length': buf.length });
+                        res.end(buf);
+                        return;
+                    }
                     const docReport = currentData.documentation;
                     if (!docReport) {
                         res.writeHead(400, jsonH);
@@ -3694,7 +3901,6 @@ function startServer({ data: initialData, port, projectRoot }) {
                     catch {
                         return 'docs';
                     } })();
-                    const translit = (s) => { const m = { а: 'a', б: 'b', в: 'v', г: 'g', д: 'd', е: 'e', ё: 'yo', ж: 'zh', з: 'z', и: 'i', й: 'j', к: 'k', л: 'l', м: 'm', н: 'n', о: 'o', п: 'p', р: 'r', с: 's', т: 't', у: 'u', ф: 'f', х: 'h', ц: 'ts', ч: 'ch', ш: 'sh', щ: 'sch', ъ: '', ы: 'y', ь: '', э: 'e', ю: 'yu', я: 'ya' }; return s.toLowerCase().split('').map(c => m[c] ?? c).join('').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, ''); };
                     const filename = featureKey && features.length === 1
                         ? `${translit(features[0].label)}-v${features[0].latestVersion || 1}.md`
                         : `${projName}-docs.md`;
@@ -3716,6 +3922,22 @@ function startServer({ data: initialData, port, projectRoot }) {
             if (url.startsWith('/api/docs/export/docx') && req.method === 'GET') {
                 try {
                     const featureKey = parsedUrl.searchParams.get('feature');
+                    const scenarioKeyDocx = parsedUrl.searchParams.get('scenario');
+                    const translit2 = (s) => { const m = { а: 'a', б: 'b', в: 'v', г: 'g', д: 'd', е: 'e', ё: 'yo', ж: 'zh', з: 'z', и: 'i', й: 'j', к: 'k', л: 'l', м: 'm', н: 'n', о: 'o', п: 'p', р: 'r', с: 's', т: 't', у: 'u', ф: 'f', х: 'h', ц: 'ts', ч: 'ch', ш: 'sh', щ: 'sch', ъ: '', ы: 'y', ь: '', э: 'e', ю: 'yu', я: 'ya' }; return s.toLowerCase().split('').map(c => m[c] ?? c).join('').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, ''); };
+                    // Scenario DOCX export
+                    if (scenarioKeyDocx) {
+                        const scenario = currentData.scenarios?.scenarios.find((s) => s.key === scenarioKeyDocx);
+                        if (!scenario?.docExists) {
+                            res.writeHead(404, jsonH);
+                            res.end(JSON.stringify({ error: 'Scenario doc not found' }));
+                            return;
+                        }
+                        const docxBuf = (0, docx_1.buildDocx)([{ key: scenarioKeyDocx, label: scenario.label, latestVersion: scenario.latestVersion, docVersions: scenario.docVersions }], path.join(projectRoot, 'docs', 'scenarios'));
+                        const filename2 = `${translit2(scenario.label)}-scenario-v${scenario.latestVersion}.docx`;
+                        res.writeHead(200, { 'Content-Type': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'Content-Disposition': `attachment; filename="${filename2}"`, 'Content-Length': docxBuf.length });
+                        res.end(docxBuf);
+                        return;
+                    }
                     const docReport = currentData.documentation;
                     if (!docReport) {
                         res.writeHead(400, jsonH);
@@ -3737,9 +3959,8 @@ function startServer({ data: initialData, port, projectRoot }) {
                     catch {
                         return 'docs';
                     } })();
-                    const translit = (s) => { const m = { а: 'a', б: 'b', в: 'v', г: 'g', д: 'd', е: 'e', ё: 'yo', ж: 'zh', з: 'z', и: 'i', й: 'j', к: 'k', л: 'l', м: 'm', н: 'n', о: 'o', п: 'p', р: 'r', с: 's', т: 't', у: 'u', ф: 'f', х: 'h', ц: 'ts', ч: 'ch', ш: 'sh', щ: 'sch', ъ: '', ы: 'y', ь: '', э: 'e', ю: 'yu', я: 'ya' }; return s.toLowerCase().split('').map(c => m[c] ?? c).join('').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, ''); };
                     const filename = featureKey && features.length === 1
-                        ? `${translit(features[0].label)}-v${features[0].latestVersion || 1}.docx`
+                        ? `${translit2(features[0].label)}-v${features[0].latestVersion || 1}.docx`
                         : `${projName}-docs.docx`;
                     res.writeHead(200, {
                         'Content-Type': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',