workflow-ai 1.0.39 → 1.0.41

package/src/skills/deep-research/knowledge/research-methodology.md

@@ -0,0 +1,54 @@
+# Методология проведения исследований
+
+Базовая методология для всех типов исследовательских задач.
+
+## Этапы исследования
+
+| Этап | Описание | Выход |
+|------|----------|-------|
+| **1. Скоупинг** | Определить границы: что ищем, зачем, для кого | Чёткий исследовательский вопрос |
+| **2. Сбор данных** | Поиск по множеству источников | Сырые данные с ссылками |
+| **3. Фильтрация** | Отсеять нерелевантные, устаревшие, ненадёжные | Валидированный пул данных |
+| **4. Анализ** | Выявить паттерны, противоречия, пробелы | Аналитические находки |
+| **5. Синтез** | Сформулировать выводы и рекомендации | Структурированный отчёт |
+| **6. Валидация** | Проверить ключевые выводы через доп. источники | Верифицированный отчёт |
+
+## Типы источников и их приоритет
+
+| Приоритет | Тип источника | Примеры |
+|-----------|---------------|---------|
+| 1 (высший) | Первичные данные | Официальная статистика, API, базы данных |
+| 2 | Отраслевые отчёты | Statista, SimilarWeb, Sensor Tower, App Annie |
+| 3 | Авторитетные издания | TechCrunch, The Verge, Ars Technica, отраслевые блоги |
+| 4 | Экспертные мнения | Блоги экспертов, конференции, подкасты |
+| 5 (низший) | Пользовательский контент | Reddit, форумы, отзывы, комментарии |
+
+## Стратегии поиска
+
+### Breadth-First (для обзорных исследований)
+1. Начни с широких запросов
+2. Выяви ключевые подтемы и терминологию
+3. Углубись в каждую подтему
+4. Собери перекрёстные ссылки
+
+### Depth-First (для точечных вопросов)
+1. Начни с конкретного запроса
+2. Найди авторитетный источник
+3. Пройди по его ссылкам и цитатам
+4. Верифицируй через альтернативные источники
+
+### Adversarial (для верификации)
+1. Сформулируй тезис
+2. Целенаправленно ищи опровержения
+3. Оцени силу аргументов за и против
+4. Сформулируй взвешенный вывод
+
+## Правила работы с данными
+
+- **Числа**: всегда указывай источник, дату, методологию сбора
+- **Проценты**: указывай базу (% от чего)
+- **Прогнозы**: отделяй от фактов, указывай автора прогноза
+- **Цитаты**: только прямые с указанием автора и контекста
+- **Устаревшие данные**: помечай `[DATA: YYYY]` если старше 1 года
+
+<!-- РАСШИРЕНИЕ: добавляй новые методологические подходы ниже -->

package/src/skills/deep-research/knowledge/source-evaluation.md

@@ -0,0 +1,33 @@
+# Оценка надёжности источников
+
+Критерии для оценки качества и надёжности найденных источников.
+
+## CRAAP-тест (адаптированный)
+
+| Критерий | Вопрос | Вес |
+|----------|--------|-----|
+| **Currency** (актуальность) | Когда опубликовано? Обновлялось ли? | 20% |
+| **Relevance** (релевантность) | Напрямую отвечает на вопрос? | 25% |
+| **Authority** (авторитетность) | Кто автор? Какой опыт/квалификация? | 25% |
+| **Accuracy** (точность) | Есть ли ссылки на первоисточники? Подтверждается другими? | 20% |
+| **Purpose** (цель) | Информирование vs продажа vs мнение? | 10% |
+
+## Красные флаги источников
+
+| Флаг | Описание | Действие |
+|------|----------|----------|
+| Нет автора | Анонимный контент | Понизить доверие, искать подтверждение |
+| Нет даты | Неизвестная актуальность | Помечать `[DATE: unknown]` |
+| Affiliate/sponsored | Коммерческая заинтересованность | Помечать `[SPONSORED]`, не использовать как единственный |
+| Circular citation | Источники ссылаются друг на друга | Найти первоисточник |
+| Outlier data | Данные сильно отличаются от консенсуса | Отдельно исследовать причину |
+
+## Уровни доверия
+
+| Уровень | Условие | Маркировка |
+|---------|---------|------------|
+| **HIGH** | 2+ независимых авторитетных источника подтверждают | `[HIGH]` |
+| **MEDIUM** | 1 авторитетный источник ИЛИ 2+ неавторитетных совпадают | `[MEDIUM]` |
+| **LOW** | 1 неавторитетный источник ИЛИ данные противоречивы | `[LOW]` |
+
+<!-- РАСШИРЕНИЕ: добавляй критерии оценки специфических типов источников ниже -->

package/src/skills/deep-research/scripts/perplexity-research.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+
+/**
+ * perplexity-research.js — обёртка для вызова Perplexity через kilo proxy без tool use.
+ *
+ * Проблема: kilo CLI всегда отправляет tool definitions → Perplexity через OpenRouter
+ * не поддерживает tool use и возвращает ошибку.
+ *
+ * Решение: вызываем OpenRouter API через kilo proxy напрямую (без tools),
+ * получаем текстовый ответ и выводим в stdout.
+ *
+ * Использование:
+ *   node perplexity-research.js "тема исследования"
+ *   node perplexity-research.js --model perplexity/sonar "тема"
+ *   node perplexity-research.js --system "Ты исследователь..." "тема"
+ *
+ * Результат (markdown) выводится в stdout.
+ * Прогресс и ошибки — в stderr.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import http from 'http';
+import https from 'https';
+import { findProjectRoot } from '../../../lib/find-root.mjs';
+import { createLogger } from '../../../lib/logger.mjs';
+
+const logger = createLogger();
+
+const AUTH_FILE = path.join(
+  process.env.HOME || process.env.USERPROFILE,
+  '.local', 'share', 'kilo', 'auth.json'
+);
+
+const API_URL = 'https://api.kilo.ai/api/openrouter/chat/completions';
+const DEFAULT_MODEL = 'perplexity/sonar-deep-research';
+
+const DEFAULT_SYSTEM_PROMPT = `Ты — опытный исследователь-аналитик. Проводи глубокие исследования по заданным темам.
+
+Принципы:
+- Каждый факт подкреплён ссылкой на источник. Нет источника = нет факта.
+- Ключевые данные подтверждай минимум 2 независимыми источниками. Если не удалось — помечай [SINGLE SOURCE].
+- Помечай уровень уверенности: [HIGH], [MEDIUM], [LOW].
+- Всегда указывай дату данных.
+- Отделяй факты от прогнозов и мнений.
+
+Формат ответа:
+1. Executive Summary (3-5 предложений)
+2. Ключевые находки (с уровнями уверенности)
+3. Детальный анализ (данные, таблицы, сравнения)
+4. Выводы и рекомендации
+5. Пробелы и ограничения
+6. Источники (полный список с URL)
+
+Язык: русский. Формат: markdown.`;
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const result = {
+    model: DEFAULT_MODEL,
+    system: DEFAULT_SYSTEM_PROMPT,
+    message: null,
+  };
+
+  let i = 0;
+  const messageParts = [];
+
+  while (i < args.length) {
+    if (args[i] === '--model' && i + 1 < args.length) {
+      result.model = args[++i];
+    } else if (args[i] === '--system' && i + 1 < args.length) {
+      result.system = args[++i];
+    } else if (args[i] === '--help' || args[i] === '-h') {
+      console.log(`
+Использование: node perplexity-research.js [опции] "тема исследования"
+
+Результат (markdown) выводится в stdout.
+
+Опции:
+  --model <id>     Модель Perplexity (по умолчанию: ${DEFAULT_MODEL})
+  --system <text>  Системный промпт (по умолчанию: встроенный промпт исследователя)
+  -h, --help       Показать справку
+`);
+      process.exit(0);
+    } else {
+      messageParts.push(args[i]);
+    }
+    i++;
+  }
+
+  result.message = messageParts.join(' ');
+  return result;
+}
+
+function loadKiloToken() {
+  if (!fs.existsSync(AUTH_FILE)) {
+    throw new Error(`Kilo auth file not found: ${AUTH_FILE}\nRun 'kilo auth login' first.`);
+  }
+
+  const auth = JSON.parse(fs.readFileSync(AUTH_FILE, 'utf-8'));
+  const kiloAuth = auth.kilo;
+
+  if (!kiloAuth || !kiloAuth.access) {
+    throw new Error('Kilo OAuth token not found in auth.json. Run "kilo auth login" first.');
+  }
+
+  if (kiloAuth.expires && Date.now() > kiloAuth.expires) {
+    throw new Error('Kilo OAuth token expired. Run "kilo auth login" to refresh.');
+  }
+
+  return kiloAuth.access;
+}
+
+function loadEnvFile() {
+  const PROJECT_DIR = findProjectRoot();
+  const envPath = path.join(PROJECT_DIR, '.workflow', 'config', '.env');
+  if (!fs.existsSync(envPath)) return;
+
+  const content = fs.readFileSync(envPath, 'utf-8');
+  for (const line of content.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eq = trimmed.indexOf('=');
+    if (eq === -1) continue;
+    const key = trimmed.slice(0, eq).trim();
+    const val = trimmed.slice(eq + 1).trim();
+    if (!process.env[key]) {
+      process.env[key] = val;
+    }
+  }
+}
+
+function getProxyUrl() {
+  return process.env.HTTPS_PROXY || process.env.https_proxy
+    || process.env.HTTP_PROXY || process.env.http_proxy
+    || process.env.ALL_PROXY || process.env.all_proxy
+    || null;
+}
+
+function callPerplexityAPI(token, model, systemPrompt, userMessage) {
+  return new Promise((resolve, reject) => {
+    const payload = JSON.stringify({
+      model,
+      messages: [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userMessage },
+      ],
+    });
+
+    const targetUrl = new URL(API_URL);
+    const proxyUrl = getProxyUrl();
+
+    const requestHeaders = {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${token}`,
+      'Content-Length': Buffer.byteLength(payload),
+    };
+
+    function handleResponse(res) {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        if (res.statusCode !== 200) {
+          reject(new Error(`API error ${res.statusCode}: ${data}`));
+          return;
+        }
+        try {
+          const json = JSON.parse(data);
+          resolve(json);
+        } catch (e) {
+          reject(new Error(`Failed to parse API response: ${e.message}\n${data}`));
+        }
+      });
+    }
+
+    let req;
+
+    if (proxyUrl) {
+      const proxy = new URL(proxyUrl);
+      const proxyAuth = proxy.username && proxy.password
+        ? `${decodeURIComponent(proxy.username)}:${decodeURIComponent(proxy.password)}`
+        : null;
+
+      const connectOptions = {
+        hostname: proxy.hostname,
+        port: parseInt(proxy.port) || 8080,
+        method: 'CONNECT',
+        path: `${targetUrl.hostname}:443`,
+        headers: {
+          'Host': `${targetUrl.hostname}:443`,
+        },
+      };
+
+      if (proxyAuth) {
+        connectOptions.headers['Proxy-Authorization'] =
+          'Basic ' + Buffer.from(proxyAuth).toString('base64');
+      }
+
+      logger.info(`Using proxy: ${proxy.hostname}:${proxy.port}`);
+
+      const proxyReq = http.request(connectOptions);
+
+      proxyReq.on('connect', (res, socket) => {
+        if (res.statusCode !== 200) {
+          reject(new Error(`Proxy CONNECT failed: ${res.statusCode}`));
+          socket.destroy();
+          return;
+        }
+
+        const tlsOptions = {
+          hostname: targetUrl.hostname,
+          path: targetUrl.pathname,
+          method: 'POST',
+          headers: requestHeaders,
+          socket,
+          agent: false,
+        };
+
+        req = https.request(tlsOptions, handleResponse);
+        req.on('error', (e) => reject(new Error(`Request failed: ${e.message}`)));
+        req.setTimeout(600000, () => {
+          req.destroy();
+          reject(new Error('Request timeout (10 minutes)'));
+        });
+        req.write(payload);
+        req.end();
+      });
+
+      proxyReq.on('error', (e) => reject(new Error(`Proxy connection failed: ${e.message}`)));
+      proxyReq.setTimeout(30000, () => {
+        proxyReq.destroy();
+        reject(new Error('Proxy connection timeout'));
+      });
+      proxyReq.end();
+
+    } else {
+      const options = {
+        hostname: targetUrl.hostname,
+        port: 443,
+        path: targetUrl.pathname,
+        method: 'POST',
+        headers: requestHeaders,
+      };
+
+      req = https.request(options, handleResponse);
+      req.on('error', (e) => reject(new Error(`Request failed: ${e.message}`)));
+      req.setTimeout(600000, () => {
+        req.destroy();
+        reject(new Error('Request timeout (10 minutes)'));
+      });
+      req.write(payload);
+      req.end();
+    }
+  });
+}
+
+function formatOutput(apiResponse, model, userMessage) {
+  const choice = apiResponse.choices?.[0];
+  if (!choice) throw new Error('No response from API');
+
+  const content = choice.message?.content || '';
+  const annotations = choice.message?.annotations || [];
+
+  let output = content;
+
+  if (annotations.length > 0) {
+    const urlCitations = annotations.filter(a => a.type === 'url_citation' && a.url_citation?.url);
+    const uniqueUrls = [...new Set(urlCitations.map(a => a.url_citation.url))];
+
+    if (uniqueUrls.length > 0) {
+      output += '\n\n---\n\n## Источники (автоматические цитаты)\n\n';
+      uniqueUrls.forEach((url, i) => {
+        const citation = urlCitations.find(a => a.url_citation.url === url);
+        const title = citation.url_citation.title || url;
+        output += `${i + 1}. [${title}](${url})\n`;
+      });
+    }
+  }
+
+  return output;
+}
+
+async function main() {
+  loadEnvFile();
+  const args = parseArgs(process.argv);
+
+  if (!args.message) {
+    console.error('Ошибка: не указана тема исследования');
+    console.error('Использование: node perplexity-research.js "тема исследования"');
+    process.exit(1);
+  }
+
+  logger.info(`Research query: ${args.message}`);
+  logger.info(`Model: ${args.model}`);
+
+  const token = loadKiloToken();
+
+  console.error(`Запуск исследования через ${args.model}...`);
+  console.error(`Ожидание ответа (deep research может занять до 5-10 минут)...`);
+
+  const response = await callPerplexityAPI(token, args.model, args.system, args.message);
+  const output = formatOutput(response, args.model, args.message);
+  const usage = response.usage || {};
+
+  // Результат — в stdout
+  console.log(output);
+
+  // Метаданные — в stderr
+  console.error(`Готово. Токены: ${usage.total_tokens || 'N/A'}, стоимость: $${usage.cost || 'N/A'}`);
+}
+
+main().catch((err) => {
+  console.error(`Ошибка: ${err.message}`);
+  process.exit(1);
+});

package/src/skills/deep-research/templates/brief-summary.md

@@ -0,0 +1,25 @@
+# Шаблон: Краткая справка
+
+Используется для быстрых исследовательских ответов, когда полный отчёт избыточен.
+
+## Структура
+
+```markdown
+# Справка: {Тема}
+
+**Дата:** {YYYY-MM-DD} | **Заказчик:** {тикет-ID}
+
+## Ответ
+
+{2-3 абзаца с ключевыми данными и выводами}
+
+## Ключевые данные
+
+| Метрика | Значение | Источник | Уверенность |
+|---------|----------|----------|-------------|
+| {метрика} | {значение} | {источник} | [HIGH/MEDIUM/LOW] |
+
+## Источники
+
+1. {Название} — {URL} ({дата})
+```

package/src/skills/deep-research/templates/research-report.md

@@ -0,0 +1,76 @@
+# Шаблон: Исследовательский отчёт
+
+## Структура отчёта
+
+```markdown
+# {Тема исследования}
+
+**Дата исследования:** {YYYY-MM-DD}
+**Заказчик:** {тикет-ID, скил}
+**Исследовательский вопрос:** {формулировка}
+**Скоуп:** {что входит и не входит}
+
+---
+
+## Executive Summary
+
+{3-5 предложений: главные находки, ключевой вывод, уровень уверенности}
+
+---
+
+## Ключевые находки
+
+### 1. {Находка}
+**Уверенность:** [HIGH/MEDIUM/LOW]
+
+{Описание находки}
+
+| Источник | Данные | Дата |
+|----------|--------|------|
+| {название} | {факт/число} | {дата} |
+
+### 2. {Находка}
+...
+
+---
+
+## Детальный анализ
+
+### {Подтема 1}
+
+{Развёрнутый анализ с данными, таблицами, сравнениями}
+
+### {Подтема 2}
+...
+
+---
+
+## Выводы и рекомендации
+
+| # | Вывод | Уверенность | Рекомендация |
+|---|-------|-------------|--------------|
+| 1 | {тезис} | [HIGH] | {что делать} |
+| 2 | {тезис} | [MEDIUM] | {что делать} |
+
+---
+
+## Пробелы и ограничения
+
+- {Что не удалось найти и почему}
+- {Какие данные требуют дополнительной верификации}
+- {Известные ограничения методологии}
+
+---
+
+## За пределами скоупа
+
+{Интересные находки, не входящие в скоуп, но потенциально полезные}
+
+---
+
+## Источники
+
+| # | Название | URL | Тип | Дата | Оценка |
+|---|----------|-----|-----|------|--------|
+| 1 | {название} | {url} | {тип} | {дата} | {A/B/C} |
+```

package/src/skills/deep-research/workflows/benchmark.md

@@ -0,0 +1,56 @@
+# Воркфлоу: BENCHMARK — Сбор бенчмарков
+
+Сбор отраслевых бенчмарков и лучших практик для сравнения с текущими показателями.
+
+## Алгоритм выполнения
+
+### 1. Определи что бенчмаркить
+
+- Какие метрики нужны (retention, conversion, ARPU, etc.)
+- В какой нише/сегменте
+- Какой масштаб продукта (стартап vs enterprise)
+
+### 2. Собери бенчмарки
+
+Приоритет источников:
+1. Отраслевые отчёты с методологией (Mixpanel, Amplitude, Lenny's Newsletter)
+2. Публичные данные компаний (S-1 filings, earnings reports)
+3. Агрегаторы бенчмарков (ChartMogul, ProfitWell)
+4. Экспертные статьи с данными
+5. Кейс-стади
+
+### 3. Нормализуй данные
+
+- Привести к единой методологии (DAU vs WAU vs MAU)
+- Учесть разницу в определениях (что считается active user?)
+- Учесть сегмент (mobile vs web vs extension)
+- Учесть stage (pre-PMF vs growth vs mature)
+
+### 4. Сформируй таблицу бенчмарков
+
+| Метрика | Bottom 25% | Median | Top 25% | Best-in-class | Наш | Источник |
+|---------|-----------|--------|---------|--------------|-----|----------|
+| ... | ... | ... | ... | ... | ... | ... |
+
+### 5. Проанализируй gaps
+
+Для каждой метрики где наш показатель ниже медианы:
+- Насколько критичен gap
+- Что делают top-performers иначе
+- Реалистично ли достичь медианы и за какой срок
+
+### 6. Синтезируй выводы
+
+→ Загрузи `algorithms/synthesis.md`
+
+### 7. Сформируй отчёт
+
+→ Используй `templates/research-report.md`
+
+### 8. Валидация
+
+- [ ] Бенчмарки из 2+ источников для ключевых метрик
+- [ ] Данные нормализованы (единая методология)
+- [ ] Указаны сегмент и stage для каждого бенчмарка
+- [ ] Gap-анализ с приоритизацией
+- [ ] Источники с датами

package/src/skills/deep-research/workflows/competitor.md

@@ -0,0 +1,63 @@
+# Воркфлоу: COMPETITOR — Анализ конкурентов
+
+Глубокий анализ конкурентов: продукты, позиционирование, метрики, сильные/слабые стороны.
+
+## Алгоритм выполнения
+
+### 1. Определи скоуп
+
+- Каких конкурентов анализировать (или найти самостоятельно)
+- По каким параметрам сравнивать
+- Прямые vs косвенные конкуренты
+
+### 2. Составь список конкурентов
+
+Если не задан:
+1. Поиск по ключевым запросам в нише
+2. Маркетплейсы/сторы (Chrome Web Store, App Store, etc.)
+3. Обзорные статьи "Top N {category}"
+4. Альтернативы (AlternativeTo, G2, Capterra)
+
+### 3. Собери данные по каждому конкуренту
+
+| Параметр | Что искать |
+|----------|-----------|
+| Продукт | Функции, цены, модель монетизации |
+| Масштаб | Пользователи, загрузки, revenue (если публично) |
+| Позиционирование | Messaging, целевая аудитория, USP |
+| Каналы | Как привлекают пользователей |
+| Отзывы | Рейтинги, частые жалобы, что хвалят |
+| Технологии | Стек, интеграции, открытый код |
+
+→ Загрузи `algorithms/source-scoring.md` для оценки данных
+
+### 4. Проведи сравнительный анализ
+
+Создай comparison matrix:
+
+| Параметр | Конкурент A | Конкурент B | Наш продукт |
+|----------|------------|------------|-------------|
+| ... | ... | ... | ... |
+
+### 5. Определи паттерны
+
+- Общие стратегии успешных конкурентов
+- Незанятые ниши
+- Типичные ошибки
+- Тренды в продуктах
+
+### 6. Синтезируй выводы
+
+→ Загрузи `algorithms/synthesis.md`
+
+### 7. Сформируй отчёт
+
+→ Используй `templates/research-report.md`
+
+### 8. Валидация
+
+- [ ] Минимум 5 конкурентов проанализировано (или все если < 5)
+- [ ] Данные по каждому из одного периода
+- [ ] Comparison matrix заполнена
+- [ ] Выводы actionable для заказчика
+- [ ] Источники указаны для каждого факта

package/src/skills/deep-research/workflows/custom.md

@@ -0,0 +1,45 @@
+# Воркфлоу: CUSTOM — Кастомное исследование
+
+Исследование по произвольному ТЗ, не попадающее в стандартные типы.
+
+## Алгоритм выполнения
+
+### 1. Определи исследовательский вопрос
+
+Из тикета извлеки:
+- Что именно нужно узнать (конкретный вопрос)
+- Для чего (контекст решения)
+- Глубина: справка (brief) vs полное исследование (report)
+- Ограничения по скоупу
+
+### 2. Выбери стратегию поиска
+
+→ Загрузи `knowledge/research-methodology.md`
+
+- Обзорный вопрос → Breadth-First
+- Конкретный вопрос → Depth-First
+- Проверка гипотезы → Adversarial
+
+### 3. Проведи исследование
+
+1. Сформулируй 3-5 поисковых запросов
+2. Для каждого запроса собери топ-5 релевантных результатов
+3. Оцени источники → `algorithms/source-scoring.md`
+4. Валидируй данные → `knowledge/data-validation.md`
+
+### 4. Синтезируй
+
+→ Загрузи `algorithms/synthesis.md`
+
+### 5. Сформируй результат
+
+- Справка → `templates/brief-summary.md`
+- Полное исследование → `templates/research-report.md`
+
+### 6. Валидация
+
+- [ ] Исследовательский вопрос отвечен
+- [ ] Ключевые данные подкреплены источниками
+- [ ] Уровни уверенности указаны
+- [ ] Пробелы в данных явно отмечены
+- [ ] Формат соответствует глубине запроса