workflow-ai 1.0.62 → 1.0.64

package/src/scripts/scan-fixtures-for-secrets.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { findProjectRoot } from 'workflow-ai/lib/find-root.mjs';
+import { printResult } from 'workflow-ai/lib/utils.mjs';
+
+const PROJECT_DIR = findProjectRoot();
+
+const DEFAULT_ALLOWLIST = [
+  'localhost',
+  '127.0.0.1',
+  '::1',
+  'example.com',
+  'example.org',
+  'example.net'
+];
+
+const BASE_PATTERNS = [
+  { name: 'api[_-]?key', regex: /api[_-]?key\s*[:=]\s*\S+/gi },
+  { name: 'bearer', regex: /bearer\s+[A-Za-z0-9._-]+/gi },
+  { name: 'openai-key', regex: /sk-[a-zA-Z0-9]{20,}/gi },
+  { name: 'jwt', regex: /eyJ[a-zA-Z0-9_-]{20,}\.[a-zA-Z0-9_-]+\./gi },
+  { name: 'password', regex: /password\s*[:=]\s*\S+/gi },
+  { name: 'token', regex: /token\s*[:=]\s*\S+/gi }
+];
+
+const STRICT_PATTERNS = [
+  { name: 'aws-access-key', regex: /AKIA[0-9A-Z]{16}/g },
+  { name: 'github-token', regex: /(gh[pousr]_[a-zA-Z0-9_]{36,})/g },
+  { name: 'slack-token', regex: /xox[baprs]-[0-9a-zA-Z-]+/g },
+  { name: 'private-key', regex: /-----BEGIN (RSA |EC |DSA |OPENSSH )?PRIVATE KEY-----/g },
+  { name: 'google-api-key', regex: /AIza[0-9A-Za-z-_]{35}/g },
+  { name: 'stripe-key', regex: /(sk|pk)_(test|live)_[0-9a-zA-Z]{24,}/g },
+  { name: 'sendgrid-key', regex: /SG\.[a-zA-Z0-9_-]{22}\.[a-zA-Z0-9_-]{43}/g },
+  { name: 'mailchimp-key', regex: /[a-f0-9]{32}-us[0-9]{1,2}/g },
+  { name: 'generic-secret', regex: /secret\s*[:=]\s*["']?\S+["']?/gi },
+  { name: 'client-secret', regex: /client[_-]?secret\s*[:=]\s*\S+/gi }
+];
+
+let PATTERNS = [...BASE_PATTERNS];
+
+const IP_PRIVATE_REGEX = /(^127\.)|(^10\.)|(^172\.(1[6-9]|2[0-9]|3[0-1])\.)|(^192\.168\.)|(^::1$)|(^fe80:)|(^fc)|(^fd)/i;
+const DOMAIN_PRIVATE_REGEX = /(localhost|127\.[0-9]+\.[0-9]+\.[0-9]+|::1|example\.(com|org|net))$/i;
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const options = {
+    path: null,
+    strict: false
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--path' && args[i + 1]) {
+      options.path = args[i + 1];
+      i++;
+    } else if (args[i] === '--strict') {
+      options.strict = true;
+    }
+  }
+
+  return options;
+}
+
+function getDefaultScanPaths() {
+  const skillsDir = path.join(PROJECT_DIR, 'src', 'skills');
+  if (!fs.existsSync(skillsDir)) {
+    return [];
+  }
+
+  const paths = [];
+  try {
+    const skills = fs.readdirSync(skillsDir);
+    for (const skill of skills) {
+      const fixturesPath = path.join(skillsDir, skill, 'tests', 'fixtures');
+      if (fs.existsSync(fixturesPath)) {
+        paths.push(fixturesPath);
+      }
+    }
+  } catch (e) {
+  }
+
+  return paths;
+}
+
+function isPrivateIp(ip, allowlist) {
+  if (!ip) return false;
+  const normalized = ip.trim().toLowerCase();
+  if (DEFAULT_ALLOWLIST.includes(normalized) || allowlist.includes(normalized)) {
+    return false;
+  }
+  return IP_PRIVATE_REGEX.test(normalized);
+}
+
+function isPrivateDomain(domain, allowlist) {
+  if (!domain) return false;
+  const normalized = domain.trim().toLowerCase();
+  if (DEFAULT_ALLOWLIST.includes(normalized) || allowlist.includes(normalized)) {
+    return false;
+  }
+  return DOMAIN_PRIVATE_REGEX.test(normalized);
+}
+
+function scanFile(filePath, allowlist = []) {
+  const findings = [];
+  const content = fs.readFileSync(filePath, 'utf8');
+  const lines = content.split('\n');
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineNum = i + 1;
+
+    for (const pattern of PATTERNS) {
+      let match;
+      pattern.regex.lastIndex = 0;
+      while ((match = pattern.regex.exec(line)) !== null) {
+        findings.push({
+          file: filePath,
+          line: lineNum,
+          pattern: pattern.name,
+          match: match[0]
+        });
+      }
+    }
+
+    const ipRegex = /\b(?:\d{1,3}\.){3}\d{1,3}\b/g;
+    let ipMatch;
+    while ((ipMatch = ipRegex.exec(line)) !== null) {
+      if (isPrivateIp(ipMatch[0], allowlist)) {
+        findings.push({
+          file: filePath,
+          line: lineNum,
+          pattern: 'private-ip',
+          match: ipMatch[0]
+        });
+      }
+    }
+
+    const domainRegex = /\b(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}\b/g;
+    let domainMatch;
+    while ((domainMatch = domainRegex.exec(line)) !== null) {
+      if (isPrivateDomain(domainMatch[0], allowlist)) {
+        findings.push({
+          file: filePath,
+          line: lineNum,
+          pattern: 'private-domain',
+          match: domainMatch[0]
+        });
+      }
+    }
+  }
+
+  return findings;
+}
+
+function scanDirectory(dirPath, allowlist = []) {
+  const findings = [];
+
+  if (!fs.existsSync(dirPath)) {
+    return findings;
+  }
+
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+
+    if (entry.isDirectory()) {
+      findings.push(...scanDirectory(fullPath, allowlist));
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name).toLowerCase();
+      const scannable = ['.js', '.json', '.yaml', '.yml', '.txt', '.log', '.md', '.env', '.sh', '.bash', '.ts', '.tsx'];
+      if (scannable.includes(ext) || ext === '') {
+        findings.push(...scanFile(fullPath, allowlist));
+      }
+    }
+  }
+
+  return findings;
+}
+
+function printFindings(findings) {
+  if (findings.length === 0) {
+    return;
+  }
+
+  console.log('---RESULT---');
+  console.log('status: failed');
+  console.log('findings:');
+
+  for (const f of findings) {
+    console.log(`  - file: ${f.file}`);
+    console.log(`    line: ${f.line}`);
+    console.log(`    pattern: "${f.pattern}"`);
+    console.log(`    match: "${f.match}"`);
+  }
+
+  console.log('---RESULT---');
+}
+
+async function main() {
+  const options = parseArgs();
+  const allowlist = [...DEFAULT_ALLOWLIST];
+
+  if (options.strict) {
+    PATTERNS = [...BASE_PATTERNS, ...STRICT_PATTERNS];
+    console.log('[Scanner] Running in STRICT mode');
+  }
+
+  let scanPaths = [];
+
+  if (options.path) {
+    const absolutePath = path.isAbsolute(options.path)
+      ? options.path
+      : path.join(PROJECT_DIR, options.path);
+    scanPaths.push(absolutePath);
+  } else {
+    scanPaths = getDefaultScanPaths();
+  }
+
+  if (scanPaths.length === 0) {
+    console.log('---RESULT---');
+    console.log('status: passed');
+    console.log('findings:');
+    console.log('---RESULT---');
+    return;
+  }
+
+  const allFindings = [];
+
+  for (const scanPath of scanPaths) {
+    const findings = scanDirectory(scanPath, allowlist);
+    allFindings.push(...findings);
+  }
+
+  printFindings(allFindings);
+
+  if (allFindings.length > 0) {
+    process.exit(1);
+  }
+
+  printResult({ status: 'passed', findings: [] });
+}
+
+main().catch(e => {
+  console.error(`[ERROR] ${e.message}`);
+  process.exit(1);
+});

package/src/scripts/tests/timeout-cascade.test.js

@@ -0,0 +1,28 @@
+function parseTimeout(testCase, index) {
+  return testCase.execution?.timeout_s || index.execution?.default_timeout_s || 300;
+}
+
+function testTimeoutCascade() {
+  const index = { execution: { default_timeout_s: 300 } };
+  
+  const testCases = [
+    { name: 'TC-001', execution: { timeout_s: 600 } },
+    { name: 'TC-002', execution: {} },
+    { name: 'TC-003' }
+  ];
+  
+  const results = testCases.map(tc => ({
+    case: tc.name,
+    timeout: parseTimeout(tc, index)
+  }));
+  
+  console.log('Timeout cascade results:', results);
+  
+  const expected = [600, 300, 300];
+  const passed = results.every((r, i) => r.timeout === expected[i]);
+  
+  console.log(`Test ${passed ? 'PASSED' : 'FAILED'}`);
+  process.exit(passed ? 0 : 1);
+}
+
+testTimeoutCascade();

package/src/skills/analyze-report/README.md

@@ -0,0 +1,44 @@
+# Analyze Report — Agent Skill
+
+Аналитик отчётов для workflow-ai. Анализирует отчёты о выполненных задачах, оценивает прогресс по планам, проводит ретроспективы и формирует actionable рекомендации.
+
+## Структура
+
+```
+analyze-report/
+├── SKILL.md                              # Ядро: роль, маршрутизация, принципы
+├── README.md                             # Документация
+├── workflows/
+│   ├── progress.md                       # Оценка прогресса по плану
+│   └── retrospective.md                  # Ретроспектива завершённого плана
+├── knowledge/
+│   ├── analysis-frameworks.md            # Методологии анализа, метрики, паттерны
+│   └── report-structure.md               # Структура отчётов, правила извлечения данных
+├── algorithms/
+│   └── progress-assessment.md            # Алгоритм оценки прогресса (формулы, пороги)
+└── templates/
+    └── analysis-report.md                # Шаблон результата анализа
+```
+
+## Как это работает
+
+1. Любой скил проекта создаёт тикет `ANL-*` с запросом на анализ
+2. Analyze Report определяет тип (PROGRESS / RETROSPECTIVE)
+3. Загружает соответствующий workflow
+4. Собирает данные из отчётов, тикетов, планов
+5. Рассчитывает метрики, выявляет проблемы, формулирует рекомендации
+6. Формирует структурированный результат анализа
+
+## Как расширять
+
+### Новый тип анализа
+1. Создай файл в `workflows/{type}.md`
+2. Добавь запись в таблицу маршрутизации в `SKILL.md`
+
+### Новый knowledge-модуль
+1. Создай файл в `knowledge/{module}.md`
+2. Добавь запись в таблицу загрузки знаний в `SKILL.md`
+
+### Новый шаблон вывода
+1. Создай файл в `templates/{template}.md`
+2. Добавь запись в таблицу шаблонов в `SKILL.md`

package/src/skills/analyze-report/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: analyze-report
+description: >
+  Скилл аналитика отчётов для workflow-ai. Анализирует отчёты о выполненных
+  задачах, оценивает прогресс по планам, проводит ретроспективы завершённых
+  планов, выявляет проблемы и формирует actionable рекомендации.
+ticket_prefix: ANL
+---
+
+# Analyze Report — Agent Skill
+
+## Роль
+
+Ты — аналитик системы workflow-ai. Твоя задача — анализировать отчёты о выполненных задачах, оценивать прогресс по планам, выявлять проблемы и паттерны, формулировать конкретные рекомендации для принятия решений.
+
+**Ты делаешь:** анализ отчётов из `.workflow/reports/`, оценку прогресса по планам, ретроспективный анализ завершённых планов, выявление паттернов проблем и успехов, формирование actionable рекомендаций, сравнительный анализ между итерациями.
+
+**Ты НЕ делаешь:** выполнение бизнес-задач, создание планов или тикетов, принятие решений (только рекомендации для принятия решений), изменение кода или конфигурации, создание отчётов (их создаёт соответствующий скил).
+
+## Маршрутизация тикетов ANL-*
+
+| Тип | Триггеры в тикете | Действие | Воркфлоу |
+|-----|-------------------|----------|----------|
+| **PROGRESS** | «оценить прогресс», «статус плана», «как дела по плану» | Оценка прогресса по активному плану | → `workflows/progress.md` |
+| **RETROSPECTIVE** | «ретроспектива», «итоги», «анализ завершённого» | Ретроспективный анализ завершённого плана | → `workflows/retrospective.md` |
+
+Если тип не определяется — используй PROGRESS как дефолт.
+
+## Загрузка знаний
+
+| Модуль | Когда загружать |
+|--------|----------------|
+| `knowledge/analysis-frameworks.md` | **ВСЕГДА** — методологии анализа, метрики, паттерны проблем |
+| `knowledge/report-structure.md` | При работе с отчётами — что извлекать из отчётов |
+
+## Загрузка алгоритмов
+
+| Алгоритм | Когда загружать |
+|----------|----------------|
+| `algorithms/progress-assessment.md` | Оценка прогресса по плану — пороги, формулы, классификация |
+
+## Шаблоны вывода
+
+| Шаблон | Когда использовать |
+|--------|-------------------|
+| `templates/analysis-report.md` | Основной формат результата анализа |
+
+## Принципы
+
+1. **Evidence-Based** — все выводы основаны на данных из отчётов, тикетов и планов. Нет данных = нет вывода. Не додумывай.
+2. **Структурированность** — результат всегда структурирован: executive summary, находки, детали, рекомендации. Используй таблицы для сравнений и метрик.
+3. **Объективность** — разделяй факты и интерпретации. Указывай уровень уверенности: `[HIGH]`, `[MEDIUM]`, `[LOW]`.
+4. **Конкретность рекомендаций** — каждая рекомендация содержит: что сделать, почему, ожидаемый результат. Абстрактные рекомендации («улучшить процесс») запрещены.
+5. **Scope Discipline** — анализируй строго в рамках заданного отчёта/плана. Находки за пределами скоупа — кратко в секции «За пределами скоупа».
+
+## Self-check перед завершением тикета
+
+**ОБЯЗАТЕЛЬНО перед закрытием тикета выполни:**
+
+1. Проверь что секция **Result** заполнена (не пустой шаблон)
+2. Проверь что каждый вывод подкреплён **конкретными данными** из отчёта
+3. Пройди по **каждому пункту DoD** — отметь `[x]` только если реально выполнен
+4. Проверь что рекомендации **actionable** (содержат конкретное действие)
+
+**Если хотя бы один пункт не пройден — тикет НЕ завершён.**
+
+## Формат вывода
+
+- Русский язык
+- Структурированный markdown с заголовками, таблицами, списками
+- Executive Summary в начале (3-5 предложений)
+- Метрики в табличном виде
+- Уровень уверенности для ключевых выводов: `[HIGH/MEDIUM/LOW]`
+- Рекомендации с приоритетами: CRITICAL / HIGH / MEDIUM / LOW
+
+## Интеграция с пайплайном
+
+> **ОБЯЗАТЕЛЬНО:** Последние строки твоего ответа ВСЕГДА должны быть блоком `---RESULT---`.
+> Без этого блока пайплайн не распознает статус и завершит работу без декомпозиции пробелов.
+
+По результатам анализа верни один из статусов:
+
+### completed — план завершён, пробелов нет
+
+```
+---RESULT---
+status: completed
+report_id: REPORT-NNN
+---RESULT---
+```
+
+### has_gaps — план не завершён или обнаружены проблемы/пробелы
+
+Используй этот статус когда:
+- есть тикеты в backlog/blocked/in-progress
+- обнаружены CRITICAL или HIGH проблемы
+- QA-верификация провалена
+- статус плана ATTENTION, AT_RISK или CRITICAL
+
+```
+---RESULT---
+status: has_gaps
+report_id: REPORT-NNN
+gaps: "Краткое описание пробелов для декомпозиции (1-2 предложения)"
+---RESULT---
+```
+
+> **КРИТИЧНО**: `status` принимает ТОЛЬКО значения `completed` или `has_gaps`.
+> Любой другой вывод (`default`, `ok`, `done`, и т.д.) — **ОШИБКА**, пайплайн завершится вместо декомпозиции пробелов.
+
+## Границы компетенции
+
+- **Создание отчётов** → соответствующий скил проекта
+- **Создание/изменение планов** → соответствующий скил проекта
+- **Выполнение бизнес-задач** → соответствующий скил проекта
+- **Улучшение скилов** → соответствующий скил проекта
+- **Декомпозиция задач** → соответствующий скил проекта
+
+---
+
+**Регрессионные тесты:** `tests/index.yaml`. Прогон: `node .workflow/src/scripts/run-skill-tests.js --skill analyze-report`

package/src/skills/analyze-report/algorithms/progress-assessment.md

@@ -0,0 +1,108 @@
+# Алгоритм: Оценка прогресса по плану
+
+Формализованный метод оценки текущего прогресса выполнения плана.
+
+## Вход
+
+- Список всех тикетов плана с их статусами (done, in-progress, ready, blocked, backlog)
+- Сложность каждого тикета (simple, medium, complex)
+- Даты создания и завершения тикетов
+- Данные ревью (прошёл / не прошёл / пропущен)
+
+## Алгоритм
+
+### 1. Подсчитай распределение по статусам
+
+```
+total = count(all tickets)
+done = count(status == done)
+in_progress = count(status == in-progress)
+ready = count(status == ready)
+blocked = count(status == blocked)
+backlog = count(status == backlog)
+```
+
+### 2. Рассчитай Completion Rate
+
+**Простой (по количеству):**
+```
+completion_rate = done / total × 100%
+```
+
+**Взвешенный (по сложности):**
+
+| Сложность | Вес |
+|-----------|-----|
+| simple | 1 |
+| medium | 2 |
+| complex | 3 |
+
+```
+weighted_done = Σ(weight[t] for t in done_tickets)
+weighted_total = Σ(weight[t] for t in all_tickets)
+weighted_completion = weighted_done / weighted_total × 100%
+```
+
+### 3. Рассчитай Quality Rate
+
+```
+reviewed = count(tickets with review)
+passed_first = count(tickets passed review on first attempt)
+first_pass_rate = passed_first / reviewed × 100%
+```
+
+### 4. Рассчитай Block Rate
+
+```
+block_rate = blocked / total × 100%
+```
+
+### 5. Определи статус прогресса
+
+| Completion | Block Rate | First-Pass Rate | Статус | Рекомендация |
+|------------|-----------|-----------------|--------|-------------|
+| ≥80% | <10% | ≥70% | 🟢 ON_TRACK | Продолжить по плану |
+| 50-80% | <20% | ≥50% | 🟡 ATTENTION | Обратить внимание на отстающие задачи |
+| 30-50% | <30% | Любой | 🟠 AT_RISK | Пересмотреть приоритеты, разблокировать |
+| <30% | ≥30% | Любой | 🔴 CRITICAL | Эскалировать, пересмотреть план |
+
+### 6. Оцени тренд
+
+Если есть данные за несколько периодов:
+```
+velocity_current = done_last_period / period_length
+velocity_previous = done_prev_period / period_length
+trend = velocity_current - velocity_previous
+```
+
+| Тренд | Интерпретация |
+|-------|---------------|
+| trend > 0 | 📈 Ускорение |
+| trend ≈ 0 | ➡️ Стабильно |
+| trend < 0 | 📉 Замедление |
+
+## Выход
+
+- Completion Rate (простой и взвешенный)
+- Quality Rate (First-Pass Rate)
+- Block Rate
+- Статус прогресса (ON_TRACK / ATTENTION / AT_RISK / CRITICAL)
+- Тренд (если данных достаточно)
+- Распределение тикетов по статусам
+
+## Пример
+
+```
+Total: 12 тикетов
+Done: 7 (3 simple, 3 medium, 1 complex)
+In-progress: 2 (1 medium, 1 complex)
+Ready: 1 (simple)
+Blocked: 2 (1 medium, 1 complex)
+
+Completion Rate: 7/12 = 58%
+Weighted: (3×1 + 3×2 + 1×3) / (4×1 + 4×2 + 4×3) = 12/24 = 50%
+Block Rate: 2/12 = 17%
+First-Pass Rate: 5/7 = 71%
+
+Статус: 🟡 ATTENTION (50% weighted, 17% blocked, 71% first-pass)
+```

package/src/skills/analyze-report/knowledge/analysis-frameworks.md

@@ -0,0 +1,66 @@
+# Методологии анализа отчётов
+
+Базовые фреймворки и метрики для анализа отчётов о выполненных задачах.
+
+## Фреймворк анализа прогресса
+
+### Количественные метрики
+
+| Метрика | Формула | Интерпретация |
+|---------|---------|---------------|
+| **Completion Rate** | done / total × 100% | Общий прогресс по плану |
+| **Weighted Completion** | Σ(done × complexity) / Σ(total × complexity) × 100% | Прогресс с учётом сложности |
+| **Throughput** | done / time_elapsed | Скорость выполнения |
+| **Block Rate** | blocked / total × 100% | Доля заблокированных задач |
+| **Rework Rate** | reworked / done × 100% | Доля задач с переделками |
+| **First-Pass Rate** | passed_review_first / done × 100% | Качество выполнения с первого раза |
+
+### Качественные индикаторы
+
+| Индикатор | Сигнал | Действие |
+|-----------|--------|----------|
+| Много заблокированных задач | Проблемы с зависимостями | Пересмотреть порядок задач |
+| Низкий First-Pass Rate | Проблемы с качеством | Усилить критерии DoD |
+| Высокий Rework Rate | Нечёткие требования | Улучшить описания задач |
+| Throughput падает | Усталость / сложность растёт | Декомпозировать оставшиеся задачи |
+
+## Фреймворк ретроспективы: Keep / Stop / Try
+
+### Keep (Продолжать)
+Практики, которые доказали эффективность:
+- Что конкретно делалось?
+- Какой результат это дало?
+- Почему это сработало?
+
+### Stop (Прекратить)
+Практики, которые создавали проблемы:
+- Что конкретно происходило?
+- Какой вред это наносило?
+- Что вызвало эту практику?
+
+### Try (Попробовать)
+Новые подходы для эксперимента:
+- Что конкретно предлагается?
+- Какую проблему это решает?
+- Как измерить результат?
+
+## Паттерны типичных проблем
+
+| Паттерн | Симптомы | Корневая причина | Рекомендация |
+|---------|---------|-----------------|--------------|
+| **Scope Creep** | Количество задач растёт, прогресс стоит | Нечёткие границы плана | Зафиксировать скоуп, новые задачи — в следующий план |
+| **Dependency Hell** | Много заблокированных задач | Плохая декомпозиция зависимостей | Пересмотреть порядок, разблокировать критический путь |
+| **Quality Debt** | Высокий rework rate | Слабые критерии DoD | Усилить DoD, добавить чеклисты |
+| **Single Point of Failure** | Один тип задач блокирует всё | Отсутствие параллелизма | Декомпозировать для параллельного выполнения |
+| **Velocity Decay** | Throughput падает со временем | Растущая сложность / усталость | Декомпозировать крупные задачи, ротация фокуса |
+
+## Классификация серьёзности проблем
+
+| Уровень | Описание | Действие |
+|---------|----------|----------|
+| **CRITICAL** | Блокирует весь план, прогресс невозможен | Немедленное вмешательство |
+| **HIGH** | Значительно замедляет прогресс | Решить в текущей итерации |
+| **MEDIUM** | Влияет на качество, но не блокирует | Запланировать решение |
+| **LOW** | Мелкие недочёты, потенциальные улучшения | Учесть при следующем планировании |
+
+<!-- РАСШИРЕНИЕ: добавляй новые паттерны и фреймворки ниже -->

package/src/skills/analyze-report/knowledge/report-structure.md

@@ -0,0 +1,61 @@
+# Структура отчётов и извлечение данных
+
+Описание типовой структуры отчётов workflow-ai и правила извлечения данных из них.
+
+## Типовая структура отчёта
+
+Отчёты находятся в `.workflow/reports/` и содержат:
+
+| Секция | Что извлекать |
+|--------|--------------|
+| **Frontmatter** | ID, дата, связанный план, период |
+| **Выполненные задачи** | Список завершённых тикетов, результаты |
+| **Проблемы** | Заблокированные задачи, ошибки, отклонения |
+| **Статистика** | Количественные данные: done/total, время |
+| **Рекомендации** | Выводы предыдущего анализа (если есть) |
+
+## Извлечение данных из тикетов
+
+### Из завершённых тикетов (done/)
+
+| Поле | Где искать | Зачем |
+|------|-----------|-------|
+| `id` | Frontmatter | Идентификация |
+| `complexity` | Frontmatter | Weighted completion |
+| `created_at` / `completed_at` | Frontmatter | Время выполнения |
+| **Result** | Секция `## Result` | Что реально сделано |
+| **DoD** | Секция критериев | Все ли выполнены |
+| **Ревью** | Секция `## Ревью` | Прошёл ли с первого раза |
+
+### Из заблокированных тикетов (blocked/)
+
+| Поле | Зачем |
+|------|-------|
+| `id`, `title` | Идентификация |
+| `dependencies` | Что блокирует |
+| Причина блокировки | Для рекомендаций по разблокировке |
+
+### Из тикетов в работе (in-progress/)
+
+| Поле | Зачем |
+|------|-------|
+| `id`, `title` | Текущая работа |
+| `created_at` | Как давно в работе |
+
+## Извлечение данных из планов
+
+| Секция плана | Что извлекать |
+|-------------|--------------|
+| **Цели** | Ожидаемые результаты для сравнения |
+| **Задачи** | Полный список для подсчёта покрытия |
+| **Приоритеты** | Для оценки порядка выполнения |
+| **Риски** | Для проверки — сработали ли |
+
+## Правила работы с данными
+
+- **Считай только то, что есть** — не экстраполируй, не предполагай
+- **Указывай источник** — для каждой метрики укажи откуда взяты данные
+- **Отмечай пробелы** — если данных не хватает для вывода, явно укажи
+- **Разделяй факты и выводы** — сначала данные, потом интерпретация
+
+<!-- РАСШИРЕНИЕ: обновляй при изменении структуры отчётов -->