@dzhechkov/keysarium 1.5.0 → 1.5.2

package/README.md

@@ -28,10 +28,10 @@ After installation, open Claude Code in your project directory and start using s
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| **Skills** | 9 | `explore`, `frontend-design`, `goap-research`, `presentation-storyteller`, `problem-solver`, `reverse-engineering`, `bto`, `knowledge-extractor`, `ai-factory-mapper` |
-| **Commands** | 24 | `/casarium`, `/new-research`, `/parallel-research`, `/discovery`, `/explore-case`, `/research`, `/cjm-prototype`, `/solve`, `/architecture-phase`, `/presentation`, `/harvest`, `/brain-export`, `/brain-import`, `/bto`, `/bto-build`, `/bto-test`, `/bto-optimize`, `/bto-benchmark`, `/feature-adr`, `/init-platform`, `/learning-stats`, `/dream`, `/workers`, `/verify-chain` |
-| **Rules** | 16 | `research-quality`, `checkpoint-protocol`, `agent-swarm`, `domain-specific`, `anti-patterns`, `file-conventions`, `modular-reuse`, `feedback-loops`, `model-routing`, `trust-tiers`, `bto-quality-gates`, `background-workers`, `dream-cycles`, `reward-learning`, `witness-chain`, `feature-adr-conventions` |
-| **Shards** | 10 | Context shards for each phase: `phase-0-discovery`, `phase-1-explore`, `phase-2-research`, `phase-25-cjm`, `phase-3-solve`, `phase-4-architecture`, `phase-5-presentation`, `phase-ai-factory`, `bto-evaluation`, `feature-adr` |
+| **Skills** | 12 | `explore`, `frontend-design`, `goap-research-ed25519`, `presentation-storyteller`, `problem-solver-enhanced`, `reverse-engineering-unicorn`, `knowledge-extractor`, `ai-factory-mapper`, `analyst-manual-full`, `edu-site-generator`, `transcript-site-generator`, `feature-adr` |
+| **Commands** | 20 | `/casarium`, `/new-research`, `/parallel-research`, `/discovery`, `/explore-case`, `/research`, `/cjm-prototype`, `/solve`, `/architecture-phase`, `/presentation`, `/harvest`, `/brain-export`, `/brain-import`, `/bto-benchmark`, `/feature-adr`, `/init-platform`, `/learning-stats`, `/dream`, `/workers`, `/analyst-manual` |
+| **Rules** | 14 | `research-quality`, `checkpoint-protocol`, `agent-swarm`, `domain-specific`, `anti-patterns`, `file-conventions`, `modular-reuse`, `feedback-loops`, `model-routing`, `trust-tiers`, `background-workers`, `dream-cycles`, `reward-learning`, `feature-adr-conventions` |
+| **Shards** | 9 | Context shards for each phase: `phase-0-discovery`, `phase-1-explore`, `phase-2-research`, `phase-25-cjm`, `phase-3-solve`, `phase-4-architecture`, `phase-5-presentation`, `phase-ai-factory`, `feature-adr` |
 | **Agent Templates** | 5 | `discovery-worker`, `research-worker`, `cjm-variant-worker`, `presentation-worker`, `parallel-research-orchestrator` |
 | **Library** | 4 | `phase-utils`, `agent-patterns`, `skill-loader`, `domain-templates` |
 | **Documentation** | 12 | Deployment, admin, user guide, infrastructure, architecture, flows (for Keysarium and BTO) |

package/README.ru.md

@@ -0,0 +1,541 @@
+# Keysarium — AI-исследовательский тулкит
+
+**7-фазный pipeline** для проведения AI-исследований на кейсариумах, хакатонах и в продуктовой аналитике. Содержит 12 скиллов, 20 slash-команд, 14 правил, 9 governance shards и систему самообучения.
+
+```bash
+npx @dzhechkov/keysarium init
+```
+
+## Содержание
+
+- [Быстрый старт](#быстрый-старт)
+- [7-фазный pipeline](#7-фазный-pipeline)
+- [Скиллы — внутреннее устройство](#скиллы--внутреннее-устройство)
+- [Reverse Engineering Unicorn — подробно](#reverse-engineering-unicorn--подробно)
+- [Slash-команды](#slash-команды)
+- [Правила (Rules)](#правила-rules)
+- [Governance Shards](#governance-shards)
+- [Система самообучения](#система-самообучения)
+- [Фоновые воркеры и Dream Cycles](#фоновые-воркеры-и-dream-cycles)
+- [Портативный мозг (Brain)](#портативный-мозг-brain)
+- [Мульти-платформенная поддержка](#мульти-платформенная-поддержка)
+
+---
+
+## Быстрый старт
+
+```bash
+# Установить в проект
+npx @dzhechkov/keysarium init
+
+# Запустить полный pipeline по кейсу
+/casarium "Автоматизация кредитного скоринга для банка"
+
+# С маппингом на Cloud.ru AI Factory
+/casarium --ai-factory "Чат-бот поддержки для ритейла"
+
+# Параллельно несколько кейсов
+/parallel-research "Кейс 1" | "Кейс 2" | "Кейс 3"
+```
+
+## 7-фазный pipeline
+
+```
+Phase 0 (15%)  →  Phase 1 (5%)  →  Phase 2 (15%)  →  Phase 2.5 ⭐ (10%)  →  Phase 3 (15%)  →  Phase 4 (15%)  →  Phase 5 (20%)
+DISCOVERY         EXPLORE           RESEARCH           CJM ПРОТОТИП           SOLVE               ARCHITECTURE       PRESENTATION
+```
+
+| Фаза | Команда | Скилл | Что делает | Артефакт |
+|------|---------|-------|-----------|----------|
+| **0** | `/discovery` | reverse-engineering-unicorn | JTBD + конкуренты + ROI + бизнес-кейс | `00_product_discovery.md` |
+| **1** | `/explore-case` | explore | Глубокое понимание кейса, 5 Whys, критерии успеха | `01_case_brief.md` |
+| **2** | `/research` | goap-research-ed25519 | PARANOID research: аналоги, технологии, регуляторика (3 параллельных агента) | `02_research_findings.md` |
+| **2.5** ⭐ | `/cjm-prototype` | reverse-eng + frontend-design | 3 варианта CJM → кликабельный React прототип → выбор | `prototype/cjm-prototype.jsx` |
+| **3** | `/solve` | problem-solver-enhanced | Стратегия решения: SCQA, Process Design, AI Pipeline, HITL | `03_solution_strategy.md` |
+| **4** | `/architecture-phase` | (встроенный) | C4 диаграммы, компоненты, безопасность, MVP scope | `04_architecture.md` |
+| **5** | `/presentation` | presentation-storyteller | 10-12 слайдов + speaker script + Q&A + Executive Summary | `05-08_*.md` |
+
+**Ключевые правила:**
+- Phase 2.5 (CJM) — **ОБЯЗАТЕЛЬНА, нельзя пропустить**
+- `08_executive_summary.md` — **ОБЯЗАТЕЛЕН**
+- Checkpoint после каждой фазы — ждёт `"ок"` от пользователя
+- Research в PARANOID mode — ноль непроверенных утверждений
+- `{CHOSEN_CJM}` передаётся из Phase 2.5 в Phase 3-5
+
+---
+
+## Скиллы — внутреннее устройство
+
+### Граф зависимостей
+
+```
+reverse-engineering-unicorn (оркестратор pipeline)
+  ├── explore (Socratic кларификация)
+  ├── goap-research-ed25519 (GOAP + Ed25519 верификация)
+  ├── problem-solver-enhanced (TRIZ + Game Theory + 5 Whys)
+  ├── frontend-design (UI для CJM прототипа)
+  └── presentation-storyteller (слайды + speaker script)
+        ├── explore
+        └── goap-research-ed25519
+```
+
+### 1. explore — адаптивная кларификация
+
+**Что делает:** Превращает расплывчатые запросы в чёткие спецификации через Socratic questioning.
+
+**Протокол:**
+1. Классифицирует задачу: Product / Problem / Decision / Creative / Research / Process
+2. Выбирает 3-5 измерений для исследования (цель, ограничения, ресурсы, timeline, критерии успеха)
+3. Задаёт таргетированные вопросы (не шаблонные — адаптивные)
+4. Формирует **Task Brief** с objective, constraints, success criteria, out-of-scope
+
+**Когда вызывается:** Phase 1, а также как зависимость в reverse-engineering-unicorn, presentation-storyteller, analyst-manual, feature-adr, ai-factory-mapper.
+
+### 2. goap-research-ed25519 — верифицированный research
+
+**Что делает:** GOAP (Goal-Oriented Action Planning) + OODA loop + Ed25519 криптографические подписи для антигаллюцинации.
+
+**Протокол:**
+1. Оценивает текущее состояние (что знаем / не знаем)
+2. Строит план исследования через A* алгоритм с учётом стоимости верификации
+3. Выполняет OODA цикл (Observe → Orient → Decide → Act) с checkpoint'ами подписей
+4. Каждый факт подписывается Ed25519 → цепочка доверия (citation chain)
+5. Генерирует подписанный research report
+
+**3 уровня строгости:** moderate (0.85), strict (0.95), paranoid (0.99)
+
+**Когда вызывается:** Phase 2 (основной), а также все DEEP/VERIFIED режимы в других скиллах.
+
+### 3. problem-solver-enhanced — решатель проблем
+
+**Что делает:** 9-модульная система решения сложных проблем.
+
+**9 модулей:**
+1. **First Principles** — декомпозиция до фундаментальных истин
+2. **5 Whys** — корневой анализ причин
+3. **SCQA** — Situation, Complication, Question, Answer
+4. **Game Theory** — анализ стратегических взаимодействий
+5. **Second-Order Thinking** — последствия 2-го и 3-го порядка
+6. **TRIZ** — разрешение противоречий без компромисса + Идеальный Конечный Результат
+7. **Design Thinking** — Empathize → Define → Ideate → Prototype → Test
+8. **OODA Loop** — Observe → Orient → Decide → Act (для динамичных ситуаций)
+9. **Solution Synthesis** — объединение находок в actionable решение
+
+**Когда вызывается:** Phase 3, а также при разрешении сложных trade-off'ов в feature-adr, ai-factory-mapper.
+
+### 4. frontend-design — дизайн интерфейсов
+
+**Что делает:** Создаёт production-grade UI с bold aesthetic direction. Антитеза "generic AI slop".
+
+**Протокол:**
+1. Выбирает контекст и обязывается к эстетическому направлению (minimal / maximalist / retro-futuristic / etc.)
+2. Применяет: distinctive typography, committed color palette, micro-animations, unexpected spatial composition
+3. Генерирует рабочий HTML/CSS/JS или React код
+
+**Когда вызывается:** Phase 2.5 (CJM прототип), а также в feature-adr Step 7 для UI-фич.
+
+### 5. presentation-storyteller — презентации со storytelling
+
+**Что делает:** 3 файла за один запуск: outline → full presentation → speaker script.
+
+**Фреймворки:** AIDA, Hero's Journey, Problem-Solution.
+
+**Протокол:**
+1. Кларификация (explore) → цель, аудитория, ограничения
+2. Research (goap-research-ed25519) → верифицированные данные и источники
+3. Структура (storytelling arc + outline с тезисами)
+4. Полная презентация в Markdown со ссылками на источники
+5. Speaker script «Как рассказывать?» — связная история для каждого слайда
+
+**Когда вызывается:** Phase 5.
+
+### 6. knowledge-extractor — извлечение знаний (Trust Tier 2)
+
+**Что делает:** 5 параллельных агентов-экстракторов → 7 категорий → 8 blocking quality gates.
+
+**4 модуля:**
+1. **Extract** — 5 агентов сканируют проект через разные линзы (patterns / commands / rules / templates / snippets)
+2. **Classify** — 7-категорная классификация + cross-dedup
+3. **Gate** — 8 quality gates в 2 прохода (deterministic G1-G2/G5-G7 + semantic G3-G4/G8 через haiku)
+4. **Integrate** — auto-placement в `.claude/` + обновление TOOLKIT_HARVEST.md
+
+**Когда вызывается:** `/harvest` после завершения любого проекта.
+
+### 7. ai-factory-mapper — маппинг на Cloud.ru AI Factory
+
+**Что делает:** Декомпозирует ЛЮБУЮ бизнес-задачу на pipeline из сервисов Cloud.ru Evolution AI Factory.
+
+**Протокол:**
+1. Clarity gate → уточнение через explore
+2. Каталог sync (catalog.md + web search для обновлений)
+3. Декомпозиция через problem-solver-enhanced (7-12 шагов)
+4. Маппинг: шаг → сервис → ✅/⚠️/❌
+5. Gap identification + Coverage scoring
+6. Synthesis: report + Mermaid + DOCX
+
+**Когда вызывается:** `/casarium --ai-factory` (аддитивно на всех фазах).
+
+### 8. analyst-manual-full — стратегический аналитик
+
+**Что делает:** Композитный оркестратор: explore → goap-research → problem-solver с ручными checkpoint'ами.
+
+**3 фазы с подтверждением:**
+1. Explore → Task Brief → **CHECKPOINT** (выбор verification mode: moderate/strict/paranoid)
+2. Verified Research (Ed25519) → **CHECKPOINT**
+3. Solve (9-module framework) → **CHECKPOINT**
+4. Синтез: 4 документа × 2 формата (md + docx)
+
+**Когда вызывается:** `/analyst-manual` для стратегических задач (ценообразование, GTM, конкурентный анализ).
+
+### 9-10. edu-site-generator + transcript-site-generator
+
+**edu-site-generator:** Генерирует gamified educational SPA из документации. 6 типов упражнений, Vite + TailwindCSS, GitHub Pages deploy.
+
+**transcript-site-generator (Trust Tier 2):** Превращает транскрипт / YouTube ссылку в интерактивный static site. Full-text search, YouTube timestamp sync, dark/light mode, speaker labels.
+
+### 11-12. feature-adr + bto
+
+**feature-adr:** 11-шаговый pipeline разработки фич с Complexity Router (S/M/L/XL). Независим от casarium pipeline — артефакты в `features/<slug>/`.
+
+**bto:** Build-Benchmark-Test-Optimize. Мульти-агентная оценка и эволюционная оптимизация скиллов. 4 модуля: BUILD → BENCHMARK → TEST → OPTIMIZE.
+
+---
+
+## Reverse Engineering Unicorn — подробно
+
+Главный оркестратор pipeline. Декомпозирует любую компанию в actionable launch playbook за 7 модулей.
+
+### 3 режима
+
+| Режим | Research | Анализ | Время |
+|-------|---------|--------|-------|
+| 🟢 **QUICK** | Статические запросы | Шаблоны | ~70 мин |
+| 🔵 **DEEP** | GOAP A* + OODA | + Game Theory, TRIZ, CJM прототип, BS-check | ~140 мин |
+| 🟣 **VERIFIED** | GOAP + Ed25519 | + Криптоподписи, audit trail, trusted issuers | ~170 мин |
+
+### 7 модулей
+
+#### Module 0: PRE-FLIGHT
+Если входные данные неясны → вызывает `explore` для кларификации.
+Определяет: `{COMPANY}`, `{URL}`, `{INDUSTRY}`, `{GEOGRAPHY}`, `{MODE}`.
+
+#### Module 1: INTELLIGENCE → Verified Fact Sheet
+- Год основания, штаб-квартира, команда, финансирование
+- Ключевые метрики: выручка, MAU, NPS
+- Каждый факт верифицирован (DEEP → GOAP, VERIFIED → Ed25519)
+- **Артефакт:** Fact Sheet с confidence scores
+
+#### Module 2: PRODUCT & CUSTOMERS → JTBD + Segments + Voice of Customer
+- [JTBD Canvas](references/jtbd-canvas.md) для каждого сегмента
+- Сегментация (STP): демография, поведение, потребности
+- Voice of Customer: реальные цитаты из отзывов, App Store, Product Hunt
+- **Артефакт:** JTBD карты + VoC матрица
+
+#### Module 2.5: CJM PROTOTYPE → Кликабельный React прототип ⭐
+Это **ключевой** модуль — обязателен, нельзя пропустить.
+
+1. Генерирует **3 варианта CJM** (Variant A, B, C) — каждый с разным фокусом
+2. Параллельно запускает **Trend Research** → Variant D (на базе трендов)
+3. Вызывает `frontend-design` → генерирует **кликабельный React JSX** прототип
+4. Пользователь **интерактивно** сравнивает варианты:
+   - ⚖️ Сравнение бок о бок
+   - 🔧 Кастомный микс (шаги из разных вариантов)
+   - 👁 Предпросмотр с данными
+5. Пользователь **фиксирует** выбранный CJM → `{CHOSEN_CJM}`
+
+**{CHOSEN_CJM} передаётся во все последующие фазы:**
+- Phase 3: user flow строится на базе выбранного CJM
+- Phase 4: MVP scope = экраны из CJM
+- Phase 5: слайд с CJM в презентации
+
+#### Module 3: MARKET & COMPETITION → TAM/SAM + Game Theory + TRIZ
+- TAM/SAM/SOM оценка рынка
+- Game Theory: матрица стратегий конкурентов, Nash equilibrium
+- TRIZ: противоречия в рынке → изобретательские решения
+- Competitive Aha: сравнение aha-момента конкурента vs `{CHOSEN_CJM}`
+- **Артефакт:** Market analysis + competition matrix
+
+#### Module 4: BUSINESS & FINANCE → Unit Economics + P&L
+- Unit economics: LTV, CAC, LTV/CAC ratio (с бенчмарками из [industry-benchmarks.md](references/industry-benchmarks.md))
+- P&L модель на 3 года
+- Sensitivity analysis: что если CAC ×2? что если retention −20%?
+- Revenue model привязан к paywall timing из `{CHOSEN_CJM}`
+- **Артефакт:** Financial model + sensitivity table
+
+#### Module 5: GROWTH ENGINE → Loop + Channels + Moats
+- Growth Loop: вирусный цикл из CJM
+- Channel scoring: organic vs paid vs partnership
+- Moats: network effects, data, brand, switching costs
+- Second-Order Thinking: "что произойдёт через 3 года?"
+- **Артефакт:** Growth strategy + moat analysis
+
+#### Module 6: PLAYBOOK SYNTHESIS → 90-Day Plan + BS-check
+- 90-Day Launch Plan: Week 1-4 → 5-8 → 9-12 с конкретными задачами
+- MVP scope = экраны из `{CHOSEN_CJM}`
+- BS-check (DEEP mode): вызывает `brutal-honesty-review` — безжалостная проверка на bullsh*t
+- **Артефакт:** Launch playbook + BS-check report
+
+### Параллелизм внутри модулей
+
+```
+Module 2.5:  Agent 1 (opus) → Variant A
+             Agent 2 (opus) → Variant B + C
+             Agent 3 (sonnet) → Trend Research → Variant D
+```
+
+### Пример использования
+
+```
+"Проанализируй Notion в режиме DEEP"
+→ Module 0: Pre-flight (Notion, notion.so, Productivity, Global, DEEP)
+→ Module 1: Fact Sheet (2016, SF, $10B valuation, 100M users)
+→ Module 2: JTBD (3 сегмента: students, teams, enterprise) + VoC
+→ Module 2.5: 3 CJM варианта → React прототип → пользователь выбирает Variant B
+→ Module 3: TAM $40B, конкуренты (Obsidian, Coda, ClickUp), TRIZ
+→ Module 4: LTV/CAC=4.2, P&L breakeven Year 2
+→ Module 5: Growth via templates (viral loop), moat = integrations + community
+→ Module 6: 90-Day Plan + BS-check ✅
+```
+
+---
+
+## Slash-команды
+
+### Pipeline-команды (7 фаз)
+
+| Команда | Фаза | Что делает |
+|---------|------|-----------|
+| `/casarium [текст]` | Все | Полный 7-фазный pipeline |
+| `/casarium --ai-factory [текст]` | Все | + маппинг на Cloud.ru AI Factory |
+| `/discovery` | 0 | Product Discovery |
+| `/explore-case` | 1 | Глубокое понимание кейса |
+| `/research` | 2 | PARANOID research (3 агента) |
+| `/cjm-prototype` | 2.5 | CJM → React прототип |
+| `/solve` | 3 | Стратегия решения |
+| `/architecture-phase` | 4 | Техническая архитектура |
+| `/presentation` | 5 | Презентация + speaker script |
+
+### Управление исследованиями
+
+| Команда | Что делает |
+|---------|-----------|
+| `/new-research [название]` | Создать новую директорию исследования |
+| `/parallel-research кейс1 \| кейс2` | Параллельный запуск Phase 0 для нескольких кейсов |
+| `/harvest [путь]` | Извлечение знаний (5 агентов → 7 категорий → 8 gates) |
+| `/brain-export` | Экспорт знаний в portable JSON (v1.1, SHA-256 manifest) |
+| `/brain-import [файл]` | Импорт знаний из другого проекта |
+
+### Инструменты разработки
+
+| Команда | Что делает |
+|---------|-----------|
+| `/feature-adr [описание]` | 11-шаговый pipeline разработки фич (S/M/L/XL) |
+| `/analyst-manual [тема]` | Стратегический анализ с checkpoint'ами |
+| `/bto [путь]` | Build-Benchmark-Test-Optimize |
+| `/init-platform --platform X` | Генерация конфигов для Cursor/OpenCode/Copilot |
+
+### Самообучение
+
+| Команда | Что делает |
+|---------|-----------|
+| `/learning-stats` | Dashboard аналитики reward learning |
+| `/dream run` | Запуск dream cycle (анализ паттернов) |
+| `/dream insights` | Показать последние инсайты |
+| `/workers start <тип>` | Запуск фонового воркера |
+| `/workers status` | Статус воркеров |
+
+---
+
+## Правила (Rules)
+
+14 правил в `.claude/rules/` — всегда активны, применяются автоматически.
+
+| Правило | Назначение |
+|---------|-----------|
+| `research-quality` | PARANOID mode: каждый факт должен иметь источник, confidence ≥ 0.99 |
+| `checkpoint-protocol` | Формат checkpoint'ов, promise tags, запрет авто-продвижения |
+| `agent-swarm` | Когда и как запускать параллельных агентов, модели, изоляция |
+| `domain-specific` | Авто-детекция домена → доменные правила (Banking, Retail, Enterprise, Healthcare) |
+| `anti-patterns` | 9 запрещённых паттернов с авто-детекцией и fix'ами |
+| `file-conventions` | Всё в `researches/<slug>/`, нумерация, timing |
+| `modular-reuse` | Скиллы domain-agnostic, команды pipeline-specific |
+| `feedback-loops` | 7 именованных cross-phase feedback loops с контрактами |
+| `model-routing` | 3-tier маршрутизация: haiku (1x) / sonnet (15x) / opus (75x) |
+| `trust-tiers` | 4-tier классификация скиллов (Advisory → Structured → Validated → Verified) |
+| `background-workers` | Авто-запуск, изоляция, concurrency limit (max 3) |
+| `dream-cycles` | Триггеры dream cycles, интеграция с memory, retention |
+| `reward-learning` | Когда вызывать memory_query/store, reward scores (1.0/0.7/0.3/0.0) |
+| `feature-adr-conventions` | Когда /feature-adr vs /casarium, output directory, slug naming |
+
+---
+
+## Governance Shards
+
+9 shards в `.claude/shards/` — загружаются перед каждой фазой для предотвращения context drift.
+
+Каждый shard содержит:
+- **Time budget** — % от общего времени
+- **Skill to load** — какой скилл загрузить
+- **Prerequisites** — upstream promise tags
+- **Quality gates** — что проверить перед выходом
+- **Agent swarm config** — параллельные агенты
+- **Promise tag** — что эмитировать в checkpoint
+
+| Shard | Фаза | Обязательные upstream |
+|-------|------|---------------------|
+| `phase-0-discovery` | Discovery | — |
+| `phase-1-explore` | Explore | `DISCOVERY_COMPLETE` |
+| `phase-2-research` | Research | `CASE_EXPLORED` |
+| `phase-25-cjm` | CJM Prototype ⭐ | `RESEARCH_PARANOID_PASSED` |
+| `phase-3-solve` | Solve | `CJM_VALIDATED` + `{CHOSEN_CJM}` |
+| `phase-4-architecture` | Architecture | `SOLUTION_DESIGNED` |
+| `phase-5-presentation` | Presentation | `ARCHITECTURE_DEFINED` |
+| `phase-ai-factory` | AI Factory (все фазы) | Только при `--ai-factory` |
+| `feature-adr` | Feature Development | Независим от casarium |
+
+---
+
+## Система самообучения
+
+### Reward-Calibrated Learning
+
+На каждом checkpoint:
+1. `memory_query()` — загружает исторические паттерны для текущего домена/фазы
+2. Пользователь отвечает → reward score:
+
+| Ответ | Reward | Метка |
+|-------|--------|-------|
+| "ок" | 1.0 | excellent |
+| "углуби X" | 0.7 | good |
+| "переделай" (3+ замечаний) | 0.3 | needs_work |
+| "заново" | 0.0 | failed |
+
+3. `memory_store()` — сохраняет результат с promise tag и контекстом
+4. Данные хранятся в `.keysarium/memory/` (90 дней retention)
+
+### Аналитика
+
+```
+/learning-stats                    # общий dashboard
+/learning-stats --domain banking   # по домену
+/learning-stats --phase 2          # по фазе
+```
+
+---
+
+## Фоновые воркеры и Dream Cycles
+
+### 4 типа воркеров (max 3 одновременно)
+
+| Тип | Модель | Что делает |
+|-----|--------|-----------|
+| `consolidate` | sonnet | Анализирует завершённые исследования, обновляет TOOLKIT_HARVEST.md |
+| `export-brain` | haiku | Фоновый экспорт brain в JSON |
+| `health-check` | haiku | Проверка trust tiers, поиск устаревших данных |
+| `pattern-analysis` | sonnet | Анализ трендов в reward data |
+
+### Dream Cycles
+
+Background sonnet-агент анализирует накопленные reward данные → генерирует инсайты.
+
+**Триггеры:** 20+ новых записей, 7+ дней с последнего dream, quality gate failure, завершение кейса.
+
+**Инсайты применяются в:**
+- Phase 0: фильтрация по домену, предупреждения
+- Phase 2: warning о проблемных фазах для текущего домена
+
+```
+/dream run        # Запустить dream cycle
+/dream insights   # Показать инсайты
+/dream status     # Состояние триггеров
+/dream clear      # Очистить старые (оставить 10)
+```
+
+---
+
+## Портативный мозг (Brain)
+
+Brain v1.1 — JSON контейнер с SHA-256 manifest для переноса знаний между проектами.
+
+```bash
+/brain-export                              # Полный экспорт
+/brain-export --delta <parent-brain.json>   # Дельта (COW, JSON Patch RFC 6902)
+/brain-import <brain.json>                  # Импорт с merge-not-overwrite
+```
+
+**Содержит:** skill metadata, domain patterns, research summaries, harvest patterns, pipeline metrics, reward data.
+
+**Lifecycle записей:** HOT → WARM → COLD → PURGE.
+
+---
+
+## Мульти-платформенная поддержка
+
+```bash
+/init-platform --platform cursor     # → .cursorrules
+/init-platform --platform opencode   # → .opencode/
+/init-platform --platform copilot    # → .github/copilot-instructions.md
+```
+
+Транслирует содержимое `.claude/` в формат целевой платформы.
+
+---
+
+## Доменная поддержка
+
+Домен авто-детектируется из описания кейса и активирует специфичные правила:
+
+| Домен | Ключевые ограничения | Палитра |
+|-------|---------------------|---------|
+| **Banking/FinTech** | On-premise LLM (GigaChat/YandexGPT), ФЗ-152, ЦБ, ФСТЭК, HITL обязателен | Blue/Navy/Silver |
+| **Retail/E-commerce** | Latency < 200ms, A/B testing, GDPR/ФЗ-152, персонализация vs privacy | Amber/Orange |
+| **Enterprise/B2B** | Change Management, Legacy integration, SLA, ROI в FTE/часах | Teal/Indigo |
+| **Healthcare** | HITL для ВСЕХ клинических решений, ФЗ-323, explainability, изоляция данных | — |
+
+---
+
+## Антипаттерны
+
+| Паттерн | Исправление |
+|---------|------------|
+| «Засунем GPT и всё заработает» | Конкретные модели + pipeline |
+| Игнорировать ограничения | Явно адресовать каждое |
+| Слишком сложная архитектура | MVP-first |
+| Нет метрик | Конкретные KPI + baseline |
+| Читать со слайдов | Storytelling + визуалы |
+| Нет Human-in-the-Loop | Чёткая escalation policy |
+| «Улучшим эффективность» без цифр | «Сократим с 4 часов до 15 минут» |
+| Пропустить Phase 2.5 (CJM) | БЛОКИРОВКА — CJM обязательна |
+| Нет Executive Summary | БЛОКИРОВКА — `08_executive_summary.md` обязателен |
+
+---
+
+## Структура проекта
+
+```
+.claude/
+├── commands/     ← 20 slash-команд (/casarium, /discovery, /harvest, ...)
+├── shards/       ← 9 governance shards (per-phase правила)
+├── skills/       ← 12 скиллов (building blocks)
+└── rules/        ← 14 правил (всегда активны)
+lib/              ← Библиотеки (memory, dream, workers, platform adapters)
+researches/       ← Результаты исследований (по кейсам)
+features/         ← Результаты feature-adr (по фичам)
+.keysarium/       ← Runtime данные (memory, insights, exports, workers)
+```
+
+---
+
+## Связанные пакеты
+
+| Пакет | Что делает |
+|-------|-----------|
+| [@dzhechkov/keysarium](https://www.npmjs.com/package/@dzhechkov/keysarium) | Этот тулкит (research pipeline) |
+| [@dzhechkov/keysarium-core](https://www.npmjs.com/package/@dzhechkov/keysarium-core) | Shared framework (governance, memory, orchestration) |
+| [@dzhechkov/skills-bto](https://www.npmjs.com/package/@dzhechkov/skills-bto) | Build-Benchmark-Test-Optimize |
+| [@dzhechkov/skills-feature-adr](https://www.npmjs.com/package/@dzhechkov/skills-feature-adr) | 11-step feature pipeline |
+| [@dzhechkov/harness-cli](https://www.npmjs.com/package/@dzhechkov/harness-cli) | `dz` CLI — единая точка входа |
+
+---
+
+*Версия 1.5.0 · MIT License · [GitHub](https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/keysarium)*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/keysarium",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "AI Case Research Toolkit for Claude Code — full 7-phase pipeline with feature-adr, dream cycles, background workers, multi-platform support, reward learning, and Cloud.ru AI Factory mapping (--ai-factory flag)",
   "main": "src/cli.js",
   "bin": {
@@ -11,10 +11,6 @@
     "src/",
     "templates/"
   ],
-  "scripts": {
-    "test": "node bin/cli.js doctor",
-    "prepublishOnly": "node scripts/sync-templates.js"
-  },
   "keywords": [
     "claude",
     "claude-code",
@@ -36,9 +32,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/dzhechko/product-keysarium-2026"
+    "url": "https://github.com/djd1m/dz-harness-hub.git",
+    "directory": "packages/@dzhechkov/keysarium"
   },
-  "homepage": "https://github.com/dzhechko/product-keysarium-2026#readme",
+  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/keysarium#readme",
   "bugs": {
     "url": "https://github.com/dzhechko/product-keysarium-2026/issues"
   },
@@ -49,5 +46,8 @@
     "@dzhechkov/keysarium-core": {
       "optional": true
     }
+  },
+  "publishConfig": {
+    "access": "public"
   }
-}
+}

package/src/cli.js

@@ -91,8 +91,17 @@ function parseArgs(argv) {
         command = 'version';
         break;
       default:
-        if (!arg.startsWith('-') && command === null) {
+        if (arg.startsWith('-')) {
+          // Reject unknown options loudly — a typo like --dry-rum or --froce must
+          // never silently downgrade behavior (real install instead of dry-run, or
+          // an unguarded destructive command).
+          error(`Unknown option: ${arg}`);
+          process.exit(1);
+        } else if (command === null) {
           command = arg;
+        } else {
+          error(`Unexpected argument: ${arg}`);
+          process.exit(1);
         }
         break;
     }

package/src/commands/init.js

@@ -5,7 +5,7 @@ const path = require('path');
 const {
   green, yellow, cyan, bold, dim,
   info, success, warn, error: logError, step,
-  copyDirRecursive, fileExists, readJSON,
+  copyDirRecursive, copyDirTracked, fileExists, readJSON,
   ensureDir, getRelativePaths,
   createManifest, writeManifest, getTemplatesDir,
   COMPONENTS, MANIFEST_FILE,
@@ -41,7 +41,7 @@ function resolveComponents(options) {
  * Copy a single component from templates to the target directory.
  * Returns array of relative file paths that were installed.
  */
-function installComponent(comp, templatesDir, targetDir) {
+function installComponent(comp, templatesDir, targetDir, force) {
   const src = path.join(templatesDir, comp.src);
   const dest = path.join(targetDir, comp.src);
 
@@ -51,13 +51,21 @@ function installComponent(comp, templatesDir, targetDir) {
   }
 
   if (comp.isFile) {
+    if (fileExists(dest) && !force) {
+      // Preserve a user-modified file (e.g. their own CLAUDE.md / settings.json)
+      // when re-installing without --force. It is still manifest-tracked because
+      // it originates from the template.
+      return [comp.src];
+    }
     ensureDir(path.dirname(dest));
     fs.copyFileSync(src, dest);
     return [comp.src];
   }
 
-  copyDirRecursive(src, dest);
-  return getRelativePaths(dest).map((rel) => path.join(comp.src, rel));
+  // Track files via the TEMPLATE source — never a scan of the destination —
+  // so user-created files under dest are neither recorded nor (later) removed.
+  const { copied, skipped } = copyDirTracked(src, dest, force);
+  return [...copied, ...skipped].map((rel) => path.join(comp.src, rel));
 }
 
 // ---------------------------------------------------------------------------
@@ -118,7 +126,7 @@ async function run(options) {
     const comp = COMPONENTS[key];
     step(i + 1, totalComponents, `Installing ${comp.label}...`);
 
-    const files = installComponent(comp, templatesDir, targetDir);
+    const files = installComponent(comp, templatesDir, targetDir, force);
     installedFiles.push(...files);
   }
 

package/src/commands/update.js

@@ -159,12 +159,16 @@ async function run(options) {
     const comp = COMPONENTS[key];
     if (!comp) continue;
     const destPath = path.join(targetDir, comp.src);
+    const srcPath = path.join(templatesDir, comp.src);
     if (comp.isFile) {
       if (fileExists(destPath)) {
         allFiles.push(comp.src);
       }
     } else if (fileExists(destPath)) {
-      const paths = getRelativePaths(destPath);
+      // Record files from the TEMPLATE source, not a scan of the destination —
+      // otherwise user-created files in dest get adopted into the manifest and
+      // a later `remove` would delete them.
+      const paths = getRelativePaths(fileExists(srcPath) ? srcPath : destPath);
       allFiles.push(...paths.map((rel) => path.join(comp.src, rel)));
     }
   }

package/src/utils.js

@@ -64,6 +64,39 @@ function copyDirRecursive(src, dest) {
   }
 }
 
+/**
+ * Copy from a TEMPLATE source into dest, tracking which files were written.
+ * Walks the SOURCE tree (never the destination), so only template-originated
+ * files are ever recorded — a user-created file in dest with no template
+ * counterpart is never touched and never returned (prevents `remove` from
+ * deleting user data). When `force` is false, a pre-existing destination file
+ * is PRESERVED (skipped) rather than clobbered (protects user-modified files
+ * on a re-install where the manifest was lost).
+ *
+ * @returns {{copied: string[], skipped: string[]}} relative paths (to dest root)
+ */
+function copyDirTracked(src, dest, force, rel = '', acc = { copied: [], skipped: [] }) {
+  const stat = fs.statSync(src);
+  if (stat.isFile()) {
+    if (fileExists(dest) && !force) {
+      acc.skipped.push(rel);
+    } else {
+      ensureDir(path.dirname(dest));
+      fs.copyFileSync(src, dest);
+      acc.copied.push(rel);
+    }
+    return acc;
+  }
+  if (stat.isDirectory()) {
+    ensureDir(dest);
+    for (const entry of fs.readdirSync(src)) {
+      copyDirTracked(path.join(src, entry), path.join(dest, entry), force,
+        rel ? path.join(rel, entry) : entry, acc);
+    }
+  }
+  return acc;
+}
+
 /**
  * Returns true if the path exists (file or directory).
  */
@@ -254,6 +287,7 @@ module.exports = {
 
   // File operations
   copyDirRecursive,
+  copyDirTracked,
   fileExists,
   readJSON,
   writeJSON,

package/templates/.claude/commands/bto-benchmark.md

@@ -1,302 +0,0 @@
-# /bto-benchmark — Deterministic Benchmarking of a Skill or Command
-
-## Usage
-```
-/bto-benchmark [path to skill directory or file]
-```
-
-## Parameters
-- $ARGUMENTS — Path to a skill directory (`.claude/skills/<name>/`), a command file (`.claude/commands/<name>.md`), a rule file (`.claude/rules/<name>.md`), or any structured artifact. Optionally include "verbose" to show expanded per-section diagnostics for all layers.
-
-## Protocol
-
-### Step 1: Load Skill and Module
-
-Read `.claude/skills/bto/SKILL.md`
-Read `.claude/skills/bto/modules/benchmark.md`
-Read `.claude/skills/bto/references/golden-samples.md`
-
-### Step 2: Validate Input
-
-If $ARGUMENTS is empty:
-- Ask: "Provide a path to the skill directory or artifact file you want to benchmark."
-- Stop and wait.
-
-Resolve the artifact path from $ARGUMENTS:
-- Strip any trailing slash
-- If the path points to a directory → look for `SKILL.md` inside it as the primary file, but include all files in the directory for context
-- If the path points to a file → use that file directly
-- If the path does not exist → report "Path not found: [path]" and stop
-
-### Step 3: Detect Artifact Type
-
-Auto-detect from path pattern:
-
-| Path Pattern | Detected Type |
-|-------------|--------------|
-| `.claude/skills/*/SKILL.md` or `.claude/skills/*/` | skill |
-| `.claude/commands/*.md` | command |
-| `.claude/rules/*.md` | rule |
-| `.claude/agents/*.md` | agent |
-| `researches/**/*.md` | research artifact |
-
-If type cannot be determined from path → infer from file content structure.
-
-### Step 4: Layer B0 — Golden Sample Comparison (Deterministic)
-
-**Purpose:** Compare artifact structure against the canonical golden sample for its type. Zero LLM cost.
-
-Load golden samples for the detected type from `references/golden-samples.md`.
-
-**Procedure:**
-
-1. Parse the artifact into a section tree (heading hierarchy, section lengths, ordering)
-2. Parse the matching golden sample into the same section tree format
-3. Compare across three structural axes:
-
-**Axis 1 — Section Coverage:**
-For each required section in the golden sample, check if the artifact contains a matching section (by heading text or semantic equivalent).
-- `section_coverage = matched_sections / total_golden_sections`
-
-**Axis 2 — Ordering Score:**
-Compare the ordering of matched sections against the golden sample ordering.
-- Use normalized Kendall tau distance: `ordering_score = 1 - (inversions / max_inversions)`
-- If fewer than 3 matched sections → ordering_score = 1.0 (too few to meaningfully compare)
-
-**Axis 3 — Proportion Score:**
-For each matched section, compute the ratio of artifact section length to golden sample section length.
-- `proportion_score = 1 - mean(|log(artifact_len / golden_len)|)` clamped to [0, 1]
-- Measures whether sections are proportionally sized (not too bloated, not too thin)
-
-**Display per-section MATCH/MISS table:**
-
-```
-Golden Section              Status    Artifact Section             Size Ratio
-─────────────────────────── ──────── ──────────────────────────── ──────────
-## Overview                 MATCH    ## Overview                  1.2x
-## Protocol                 MATCH    ## Protocol                  0.8x
-## Anti-Patterns            MATCH    ## Anti-Patterns             1.0x
-## Dependencies             MISS     —                            —
-## Quick Start              MATCH    ## Quick Start               1.5x
-```
-
-**Golden Similarity Score:**
-```
-B0 = section_coverage * 0.50 + ordering_score * 0.25 + proportion_score * 0.25
-```
-
-**Gate:** If B0 < 0.30 → BLOCK immediately. The artifact's structure is too far from the expected form to benchmark meaningfully.
-
-### Step 5: Layer B1 — Deterministic Test Suite
-
-**Purpose:** Run all applicable deterministic tests for the detected artifact type. Zero LLM cost.
-
-Execute all applicable checks from `benchmark.md` for the detected artifact type. These overlap with but extend the Layer 0 checks from `/bto-test`:
-
-**Universal Checks (U1-U12):**
-- U-01: File exists and is non-empty
-- U-02: UTF-8 encoding valid
-- U-03: Starts with level-1 heading
-- U-04: No placeholder text (`[TODO]`, `[TBD]`, `<INSERT>`, `[PLACEHOLDER]`)
-- U-05: No empty sections (heading with no content before next heading)
-- U-06: Consistent heading hierarchy (no h1→h3 jumps)
-- U-07: No broken internal cross-references
-- U-08: File size within bounds (200B – 100KB per file)
-- U-09: No trailing whitespace on lines
-- U-10: Standard Markdown only (no HTML unless in code blocks)
-- U-11: All code blocks properly closed
-- U-12: No duplicate top-level sections
-
-**Type-Specific Checks:**
-- Skill: SK-01 through SK-16 (SKILL.md exists, required sections, modules/, references/, examples/, etc.)
-- Command: CM-01 through CM-08 (Usage section, Parameters, Protocol steps, Checkpoint, Critical Rules, etc.)
-- Rule: RL-01 through RL-06 (Table format, detection signals, fix actions, no contradictions, etc.)
-- Agent: AG-01 through AG-04 (Model specified, isolation rules, naming convention, output format)
-
-**Display per-test PASS/FAIL table:**
-
-```
-ID      Check                              Result   Note
-─────── ──────────────────────────────────  ──────── ────────────────────────────
-U-01    File exists and is non-empty       PASS     8.4 KB
-U-02    UTF-8 encoding                     PASS
-...
-SK-01   SKILL.md exists at skill root      PASS
-SK-02   Has ## Overview section            PASS
-SK-03   Has ## Anti-Patterns section       FAIL     Section missing
-...
-```
-
-**Test Pass Rate:**
-```
-B1 = passed_tests / total_applicable_tests
-```
-
-**Gate:** If B1 < 0.60 → BLOCK. Too many structural failures to proceed to consistency probing.
-
-### Step 6: Layer B2 — Consistency Probe
-
-**Purpose:** Measure evaluation stability by running identical prompts across multiple agents. Detects artifacts that produce inconsistent interpretations.
-
-**Model:** haiku (cost-optimized)
-
-**Spawn 3 parallel haiku agents with the identical evaluation prompt:**
-
-Each agent receives the exact same prompt:
-```
-You are evaluating a Claude Code artifact for structural quality.
-Rate these 4 dimensions (0.0 to 1.0 each, two decimal places):
-1. STRUCTURE — Does the artifact follow a clear, logical organization?
-2. CLARITY — Are instructions unambiguous and actionable?
-3. COVERAGE — Does it address all aspects implied by its title/scope?
-4. CONSISTENCY — Is the internal terminology and style uniform?
-Output as JSON: {"structure": X.XX, "clarity": X.XX, "coverage": X.XX, "consistency": X.XX}
-```
-
-**Isolation:** Each agent evaluates independently. No cross-communication.
-
-**After all 3 return, compute structural agreement:**
-
-For each dimension:
-```
-agreement[dim] = 1 - (max(scores[dim]) - min(scores[dim]))
-```
-
-**Consistency Score:**
-```
-B2 = mean(agreement across all 4 dimensions)
-```
-
-**Interpretation:**
-- B2 > 0.85 → HIGH consistency — the artifact is unambiguously structured
-- B2 0.60-0.85 → MODERATE consistency — some sections are open to interpretation
-- B2 < 0.60 → LOW consistency — the artifact is structurally ambiguous
-
-**Display per-probe comparison:**
-
-```
-Dimension      Probe 1   Probe 2   Probe 3   Range    Agreement
-──────────── ────────── ────────── ────────── ──────── ──────────
-STRUCTURE      0.80       0.85       0.82      0.05     0.95
-CLARITY        0.70       0.75       0.65      0.10     0.90
-COVERAGE       0.60       0.70       0.55      0.15     0.85
-CONSISTENCY    0.75       0.78       0.73      0.05     0.95
-                                                Mean:    0.91
-```
-
-No gate on B2 — consistency is informational and feeds into the aggregate score.
-
-### Step 7: Layer B3 — Performance Metrics
-
-**Purpose:** Quantify token efficiency and information density. Zero LLM cost.
-
-**Metric 1 — Token Efficiency:**
-```
-token_efficiency = meaningful_content_tokens / total_tokens
-```
-Where `meaningful_content_tokens` excludes: blank lines, decorative separators, repeated boilerplate headers, and excessive whitespace. Target: > 0.70.
-
-**Metric 2 — Information Density:**
-```
-information_density = unique_concepts / total_sections
-```
-Where `unique_concepts` = count of distinct topics, terms, or instructions introduced. Measures whether each section contributes new information vs. repeating prior content. Target: > 2.0 concepts per section.
-
-**Metric 3 — Bloat Detection:**
-Identify sections where:
-- Section length > 3x the golden sample equivalent → BLOATED
-- Section length < 0.2x the golden sample equivalent → THIN
-- Section repeats > 30% of content from another section → REDUNDANT
-
-```
-bloat_score = 1 - (bloated_sections + thin_sections + redundant_sections) / total_sections
-```
-Clamped to [0, 1].
-
-**Performance Score:**
-```
-B3 = token_efficiency * 0.35 + normalize(information_density, 0, 4) * 0.35 + bloat_score * 0.30
-```
-Where `normalize(x, min, max)` clamps and scales x to [0, 1].
-
-**Display per-section metrics:**
-
-```
-Section                    Tokens   Concepts   Golden Ratio   Flag
-─────────────────────────  ──────── ────────── ──────────────  ──────────
-## Overview                 320      4          1.2x           OK
-## Protocol                 1840     12         0.8x           OK
-## Anti-Patterns            580      6          2.8x           BLOATED
-## Quick Start              95       2          0.3x           THIN
-## Dependencies             210      3          1.0x           OK
-```
-
-### Step 8: Aggregate & Gate
-
-**BENCHMARK_SCORE formula:**
-```
-BENCHMARK_SCORE = B0 * 0.30 + B1 * 0.35 + B2 * 0.15 + B3 * 0.20
-```
-
-**Weight rationale:**
-- B0 (Golden Comparison) at 0.30 — structural conformance is the primary benchmark signal
-- B1 (Test Suite) at 0.35 — deterministic correctness is the most reliable signal
-- B2 (Consistency) at 0.15 — stability matters but is a secondary signal
-- B3 (Performance) at 0.20 — efficiency matters for production artifacts
-
-**Gate:**
-- BENCHMARK_SCORE < 0.50 → **BLOCK** — artifact requires significant rework before evaluation
-- BENCHMARK_SCORE 0.50-0.70 → **WARN** — artifact has structural issues; proceed to TEST with caution
-- BENCHMARK_SCORE > 0.70 → **PASS** — artifact meets benchmark standards; ready for TEST
-
-Record `BENCHMARK_SCORE` for downstream consumption by `/bto-test` and `/bto`.
-
----
-
-## Checkpoint
-
-```
-═══════════════════════════════════════════════════════
-CHECKPOINT: BENCHMARK Complete
-<promise>BTO_BENCHMARKED</promise>
-Artifact: [path]
-Type: [detected type]
-
-Layer B0 (Golden):      X.XX — section coverage, ordering, proportions
-Layer B1 (Test Suite):  X.XX — Y/Z tests passed
-Layer B2 (Consistency): X.XX — agreement across 3 probes
-Layer B3 (Performance): X.XX — token efficiency, density, bloat
-
-BENCHMARK SCORE: X.XX [PASS / WARN / BLOCK]
-
-• "ок" — proceed to TEST
-• "покажи детали [B0/B1/B2/B3]" — expand layer details
-• "пропусти тест" — skip TEST (if PASS)
-═══════════════════════════════════════════════════════
-```
-
-Wait for user confirmation.
-
----
-
-## Modular Usage
-
-This command is also invoked internally by:
-- `/bto` — as a pre-flight step before TEST phase (if benchmark module is loaded)
-- `/bto-test` — optionally as a prerequisite gate (if user requests `benchmark` flag)
-
-The `BENCHMARK_SCORE` is available to downstream commands:
-- `/bto-test` may use it to calibrate Layer 1 expectations
-- `/bto-optimize` may use it to set a structural baseline floor
-
-## Critical Rules
-
-- Layer B0 and B1 are fully deterministic — no LLM calls, zero cost
-- Layer B2 uses haiku only — NEVER use sonnet or opus for consistency probes
-- Agent tool is REQUIRED for Layer B2 — do not run probes sequentially
-- Golden samples from `references/golden-samples.md` are the authoritative structural reference
-- If golden sample does not exist for the detected type → skip B0, set B0 = 0.50 (neutral), and log a warning
-- Report `BENCHMARK_SCORE` explicitly so downstream commands can consume it
-- BLOCK verdict at B0 or B1 halts the benchmark — do NOT proceed to subsequent layers
-- Layer B3 bloat detection uses golden sample proportions — without a golden sample, use absolute thresholds only
-- If "verbose" is in $ARGUMENTS, show expanded per-section diagnostics for all layers without prompting