From a68a0a0ccbedd64d0c429610d9448cb3870207ff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?= Date: Fri, 15 May 2026 09:50:53 +0300 Subject: [PATCH] =?UTF-8?q?chore(spec):=20Phase=201=20pre-flight=20finding?= =?UTF-8?q?s=20=E2=80=94=20sync=20spec=20+=20plan=20+=20cspell=20vocab?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Phase 1 Task 0 verifications executed on 2026-05-15 against live Windows Server 2022 + native PowerShell elevation + Node.js stack: - Task 1.1 npm view: ruflo v3.7.0-alpha.38 (not alpha.33 as spec assumed), MIT, repository.url = ruvnet/claude-flow.git (rename Jan-2026 incomplete in npm metadata; plugin namespace also remains @claude-flow/*). - Task 1.2 CLI: 33+ subcommands available — init, mcp, plugins, daemon, doctor, hive-mind (Queen-led consensus), autopilot, claims, cleanup, etc. - Task 1.3 plugins list: 20 plugins in IPFS-registry (not 32 as spec estimated). Registry CID QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2 fetched via IPFS — gateway.pinata.cloud + cloudflare-ipfs.com FAILED, only ipfs.io worked. 6 core + 1 command + 13 integration. 11 CRM-relevant; 9 nichе (medical/legal/financial/quantum). User decision gate confirmed «full big-bang — all 20» despite material delta from spec. - Task 1.4 disk: 67 GB free (>> 5 GB requirement). - Task 1.5 elevation: TRUE — pm2-service-install без эскалации заказчику. - Task 1.5.2 PM2 not yet installed. - Task 1.6 MCP: stdio mode confirmed (INFO [claude-flow-mcp] Starting in stdio mode) — no port conflict with existing MCP entries. Resolves spec §12 Q5. Material changes vs original spec/plan: - 32 → 20 plugins (1.6× smaller actual scope) - 100+ → 60+ agents (per npm description) - Plugin namespace ruflo-* → @claude-flow/* (legacy) - Added §10.3 risks #11 (IPFS gateway), #12 (alpha version inconsistency 3.0.0-alpha.1..8), #13 (namespace mismatch documentation cost) - §3 rewritten with concrete 20-plugin table and CLI subcommand list - §12 Q1/Q4/Q5/Q7 marked RESOLVED with concrete answers - §12 +Q11 (IPFS) +Q12 (version inconsistency) cspell vocab additions: ruvector, ipfs, xenova, onnxruntime (lowercase per user-dict case rule, see commit e55572e for prior precedent). Plan synced: alpha.33 → alpha.38 (replace_all), 32 plugins references patched at 8 specific locations. Tooling §0 row description updated: +20 plugins (35 → 55 formalized), not +32 (35 → 67). Awaiting user OK for Phase 2 (destructive scaffolding starts at Task 2.1 CLAUDE.md backup + Task 2.2 npx ruflo init). Co-Authored-By: Claude Opus 4.7 (1M context) --- cspell-words.txt | 4 + .../2026-05-15-ruflo-big-bang-integration.md | 26 ++-- .../2026-05-15-ruflo-integration-design.md | 127 +++++++++++------- 3 files changed, 99 insertions(+), 58 deletions(-) diff --git a/cspell-words.txt b/cspell-words.txt index d446891d..ba701027 100644 --- a/cspell-words.txt +++ b/cspell-words.txt @@ -1166,6 +1166,10 @@ ruvnet hnsw sona ruvllm +ruvector +ipfs +xenova +onnxruntime многоагентный форк форка diff --git a/docs/superpowers/plans/2026-05-15-ruflo-big-bang-integration.md b/docs/superpowers/plans/2026-05-15-ruflo-big-bang-integration.md index f25319d1..b670e49c 100644 --- a/docs/superpowers/plans/2026-05-15-ruflo-big-bang-integration.md +++ b/docs/superpowers/plans/2026-05-15-ruflo-big-bang-integration.md @@ -6,7 +6,7 @@ **Architecture:** ruflo Queen-led routing — entry-point для всех задач; SONA neural pattern classifier → swarm dispatch / sub-policy delegate. Existing 8-level hierarchy (Pravila §12 → … → memory) становится 9-level где ruflo на уровне −1. Существующие hard rules переезжают в `CLAUDE.local.md` (gitignored) как ruflo sub-policies. -**Tech Stack:** ruflo v3.7.0-alpha.33 (MIT, ruvnet/ruflo, Node.js + Rust WASM kernels), PM2 + pm2-windows-service (Windows daemon), HNSW vector store в `~/.ruflo-cache/`, vis-network 9.1.9 (карта-форк), lefthook pre-commit gauntlet (gitleaks/markdownlint/cspell/pint/larastan/squawk/eslint), Pest 4 + Vitest регрессионные test runners. +**Tech Stack:** ruflo v3.7.0-alpha.38 (MIT, ruvnet/ruflo, Node.js + Rust WASM kernels), PM2 + pm2-windows-service (Windows daemon), HNSW vector store в `~/.ruflo-cache/`, vis-network 9.1.9 (карта-форк), lefthook pre-commit gauntlet (gitleaks/markdownlint/cspell/pint/larastan/squawk/eslint), Pest 4 + Vitest регрессионные test runners. **Spec reference:** [docs/superpowers/specs/2026-05-15-ruflo-integration-design.md](../specs/2026-05-15-ruflo-integration-design.md) (commit `e55572e`). @@ -31,7 +31,7 @@ - `docs/Tooling_v8_3.md` — §0 35 → ~67; +§4.10; v1.17 → **v2.0** - `docs/CHANGELOG_claude_md.md` — entries для v1.14/v3.0/v2.0/v2.0 - `.mcp.json` — +ruflo entry -- `~/.claude/settings.json` — enabledPlugins.ruflo-* (32) + watchdog hook +- `~/.claude/settings.json` — enabledPlugins для 20 `@claude-flow/*` (post Phase 1 Task 1.3) + watchdog hook - `.gitignore` — +.claude-flow/, +CLAUDE.local.md, +.env.local, +CLAUDE.md.pre-ruflo.bak, +.ruflo-cache/ - `lefthook.yml` — +cost-watchdog job (опционально) - `cspell-words.txt` — добавлены ruflo/ruvnet/hnsw/sona/ruvllm/многоагентный/форк/форка/bak (уже в commit `e55572e`) @@ -86,7 +86,7 @@ npx ruflo@latest --help Expected: список subcommands (`init`, `mcp`, `plugins`, `daemon`, `doctor`, `config`, `cost`, и т. д.). Скопировать output в spec §12 Q10 в Task 1.7. Verify конкретно: `init`, `mcp`, `plugins`, `daemon` subcommands есть. -### Task 1.3: Enumerate 32 plugins +### Task 1.3: Enumerate plugins (фактически 20 в registry) **Files:** none @@ -342,7 +342,7 @@ Edit `.mcp.json`, добавить под `mcpServers`: "ruflo": { "command": "npx", "args": ["-y", "ruflo@latest", "mcp", "start"], - "comment": "Ruflo orchestration MCP server — exposes ~210 tools (Core/Intelligence/Agents/Memory/DevTools). v3.7.0-alpha.33+ MIT. Pending sync в Tooling §4.10 (Day 3 Task 3.4)." + "comment": "Ruflo orchestration MCP server — exposes ~210 tools (Core/Intelligence/Agents/Memory/DevTools). v3.7.0-alpha.38+ MIT. Pending sync в Tooling §4.10 (Day 3 Task 3.4)." } ``` @@ -492,7 +492,7 @@ Expected: .env.local создан, `git status` не показывает его > 4. §5 ПДн: добавить inline note «(execution-layer rule: gitleaks pre-commit фильтр обеспечивает технический catch; не regulatory rule выше ruflo)» > 5. §0 cross-refs row: «v2.0+» → «v3.0+» для PSR_v1; «v1.92+» → «v2.0+» для CLAUDE.md; «v1.17+» → «v2.0+» для Tooling > 6. Header version: v1.13 → v1.14; добавить «Дата: 2026-05-15» -> 7. §9 «История версий» (если есть) или создать раздел: добавить запись «v1.14 от 2026-05-15 — ruflo big-bang sub-policy conversion: §12 hard rule → sub-policy; §5 ПДн execution-layer note. Связано: ruflo v3.7.0-alpha.33 integration via spec/plan 2026-05-15» +> 7. §9 «История версий» (если есть) или создать раздел: добавить запись «v1.14 от 2026-05-15 — ruflo big-bang sub-policy conversion: §12 hard rule → sub-policy; §5 ПДн execution-layer note. Связано: ruflo v3.7.0-alpha.38 integration via spec/plan 2026-05-15» > > Return: diff против существующего файла. Не commit yourself, не запускай тесты. Return raw diff as text.» @@ -575,9 +575,9 @@ git commit -m "docs(psr_v1): R0 → sub-policy + R0.1 +ruflo level −1 + R0.6 + > ``` > > Остальные уровни (0-6) — без изменений в нумерации (они становятся «execution layer» под ruflo). -> 4. §3 «Карта 35 инструментов» → «Карта 35 + ruflo (orchestration layer) инструментов»; добавить §3.4 «Off-phase orchestration: ruflo (32 plugins, ~210 MCP tools)» — короткая ссылка на Tooling §4.10 +> 4. §3 «Карта 35 инструментов» → «Карта 35 + ruflo (orchestration layer) инструментов»; добавить §3.4 «Off-phase orchestration: ruflo (20 plugins из IPFS-registry `@claude-flow/*`, ~210 MCP tools)» — короткая ссылка на Tooling §4.10 > 5. §5 п.10 «Не править этот CLAUDE.md без…» — добавить inline note «(sub-policy ruflo: claude-md-management остаётся preferred channel через ruflo routing; ruflo agents могут править напрямую при явном routing-decision)» -> 6. §6 «Текущая фаза»: bump «Post-MVP (10.05.2026)» → добавить параграф «**2026-05-15 ruflo big-bang integration:** Установлен ruflo v3.7.0-alpha.33 как Queen-led routing на уровне −1 иерархии. 4 normative files переписаны под sub-policy paradigm. Карта-форк `docs/automation-graph-ruflo.html` (Day 5). Pre-flight Task 0 results: [TBD reference spec §12]. Day 6 regression: [TBD baseline numbers].» +> 6. §6 «Текущая фаза»: bump «Post-MVP (10.05.2026)» → добавить параграф «**2026-05-15 ruflo big-bang integration:** Установлен ruflo v3.7.0-alpha.38 как Queen-led routing на уровне −1 иерархии. 4 normative files переписаны под sub-policy paradigm. Карта-форк `docs/automation-graph-ruflo.html` (Day 5). Pre-flight Task 0 results: [TBD reference spec §12]. Day 6 regression: [TBD baseline numbers].» > 7. §9 «История версий» — добавить «v2.0 от 2026-05-15 — ruflo big-bang…» > > Return diff. Do NOT commit, do NOT touch other files.» @@ -611,14 +611,14 @@ git commit -m "docs(claude_md): §1 +уровень −1 ruflo + §3.4 orchestra > Prompt: «Edit `docs/Tooling_v8_3.md`. Read full file first (~3000-5000 lines). Then: > > 1. Header version v1.17 → v2.0; date 2026-05-15 -> 2. §0 сводка таблица: добавить row «**ruflo orchestration layer** (off-phase, post-MVP 2026-05-15) | npx ruflo@latest + 32 plugins | +32 plugins». Также: bump «Итого формализованных позиций: 35» → «Итого формализованных позиций: 35 + 32 ruflo plugins = ~67» +> 2. §0 сводка таблица: добавить row «**ruflo orchestration layer** (off-phase, post-MVP 2026-05-15) | npx ruflo@latest + 20 plugins | +20 plugins». Также: bump «Итого формализованных позиций: 35» → «Итого формализованных позиций: 35 + 20 ruflo plugins = 55» > 3. §3.3 «Off-phase tools» — добавить упоминание о новом category «orchestration» с pointer на §4.10 > 4. Новый §4.10 «Orchestration layer (ruflo) — entry-point иерархии (off-phase)»: > > ```markdown > ### §4.10. Orchestration layer (ruflo) — entry-point иерархии (off-phase) > -> ruflo (ruvnet/ruflo, MIT, v3.7.0-alpha.33+) встаёт «чистым верхом» над 8-уровневой иерархией (см. CLAUDE.md §1). 32 plugins, ~210 MCP tools, 100+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip), HNSW vector memory, SONA neural routing. +> ruflo (npm `ruflo` v3.7.0-alpha.38+, MIT, `ruvnet/claude-flow` legacy repo после rename Jan-2026; plugin-namespace `@claude-flow/*`) встаёт «чистым верхом» над 8-уровневой иерархией (см. CLAUDE.md §1). 20 plugins (IPFS-registry), ~210 MCP tools, 60+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip), HNSW vector memory, SONA neural routing. > > **Архитектурная роль:** entry-point для ВСЕХ задач. Делает первичную классификацию (interactive vs autonomous) и delegate в sub-policy stack-gate (paired-stack: Superpowers + Frontend Design) ИЛИ executes via swarm. > @@ -631,7 +631,7 @@ git commit -m "docs(claude_md): §1 +уровень −1 ruflo + §3.4 orchestra > **Связано:** [docs/superpowers/specs/2026-05-15-ruflo-integration-design.md](superpowers/specs/2026-05-15-ruflo-integration-design.md), Pravila v1.14+ §12 sub-policy, PSR_v1 v3.0+ R0 sub-policy, CLAUDE.md v2.0+ §1 уровень −1. > ``` > -> 5. История версий: добавить «v2.0 (2026-05-15) — ruflo big-bang: §0 +ruflo orchestration row +32 plugins (35 → 67); новая §4.10. Major bump reflects architectural inversion. Связано: spec/plan 2026-05-15, Pravila v1.14, PSR_v1 v3.0, CLAUDE.md v2.0.» +> 5. История версий: добавить «v2.0 (2026-05-15) — ruflo big-bang: §0 +ruflo orchestration row +20 plugins (35 → 55); новая §4.10. Major bump reflects architectural inversion. Связано: spec/plan 2026-05-15, Pravila v1.14, PSR_v1 v3.0, CLAUDE.md v2.0.» > > Return diff.» @@ -1099,12 +1099,12 @@ Edit: «HEAD origin/main = `aa39763`» → «HEAD origin/main = `NEW_HEAD` (rufl ```markdown --- name: project-ruflo-integration -description: ruflo big-bang integration — Queen-led routing уровень −1, sub-policy paradigm, 32 plugins, daemon mode, 2026-05-15 migration +description: ruflo big-bang integration — Queen-led routing уровень −1, sub-policy paradigm, 20 plugins (post Phase 1), daemon mode, 2026-05-15 migration metadata: type: project --- -**2026-05-15 ruflo big-bang merged into main ``.** ruflo v3.7.0-alpha.33 встал уровнем −1 как Queen-led routing entry-point. 4 normative files переписаны под sub-policy paradigm: Pravila v1.14 (§12 → sub-policy), PSR_v1 v3.0 (R0 → sub-policy), CLAUDE.md v2.0 (§1 +уровень −1, §3.4 ruflo chapter, §5 п.10 sub-policy note), Tooling v2.0 (§4.10 +Orchestration layer, 35 → ~67 plugins). Карта-форк `docs/automation-graph-ruflo.html` показывает TO-BE архитектуру. +**2026-05-15 ruflo big-bang merged into main ``.** ruflo v3.7.0-alpha.38 встал уровнем −1 как Queen-led routing entry-point. 4 normative files переписаны под sub-policy paradigm: Pravila v1.14 (§12 → sub-policy), PSR_v1 v3.0 (R0 → sub-policy), CLAUDE.md v2.0 (§1 +уровень −1, §3.4 ruflo chapter, §5 п.10 sub-policy note), Tooling v2.0 (§4.10 +Orchestration layer, 35 → ~67 plugins). Карта-форк `docs/automation-graph-ruflo.html` показывает TO-BE архитектуру. **Cost-budget:** `RUFLO_DAEMON_MAX_USD_PER_DAY=10` в `.env.local` (gitignored). @@ -1132,7 +1132,7 @@ Add line: `- [Ruflo integration](project_ruflo_integration.md) — 2026-05-15 bi | §1 Goals | Phase 2-7 (полный execution) | | §1 Non-goals | Plan не упоминает production data / new tests / 35 dupe — respected | | §2 Architecture (8→9 levels) | Tasks 3.1-3.4 переписывают все 4 normative files | -| §3 Scope (32 plugins) | Task 1.3 enumerate + Task 2.5 enabledPlugins | +| §3 Scope (20 plugins post Phase 1) | Task 1.3 enumerate + Task 2.5 enabledPlugins | | §4 Sequencing | Phase 1-7 mirror Day 1-7 | | §5 Map fork | Phase 5 Tasks 5.1-5.9 | | §6 Memory bridge | Pending — Task 5.8 partial (карта overlay); ruflo memory reindex hook — добавить в plan post-MVP (out of plan scope per §1.7 «no new tests» если interpret as «no new system»). **Gap noted:** добавляю в open questions ниже. | diff --git a/docs/superpowers/specs/2026-05-15-ruflo-integration-design.md b/docs/superpowers/specs/2026-05-15-ruflo-integration-design.md index ce682f53..629c3305 100644 --- a/docs/superpowers/specs/2026-05-15-ruflo-integration-design.md +++ b/docs/superpowers/specs/2026-05-15-ruflo-integration-design.md @@ -10,7 +10,7 @@ related: - docs/Plugin_stack_rules_v1.md (v2.1 → v3.0 sub-policy) - docs/Tooling_v8_3.md (v1.17 → v2.0 +ruflo chapter §4.10) - CLAUDE.md (v1.93 → v2.0 — priority chain rewrite) - - https://github.com/ruvnet/ruflo (upstream, MIT, v3.7.0-alpha.33) + - https://github.com/ruvnet/claude-flow (upstream, MIT, npm ruflo v3.7.0-alpha.38 verified 2026-05-15) --- # Ruflo integration — full big-bang («чистый верх») @@ -19,7 +19,7 @@ related: **Триггер 15.05.2026 сессия:** заказчик «продолжим работать с картой. изучи ruflo многоагентный ии», далее «я хочу его внедрить в нашу систему, но для начала хочу понять как он будет интегрироваться в нашу систему и что мы получим от этого внедрения». После brainstorming 7-вопросного цикла принят **Подход A (Full big-bang)** + **архитектурная инверсия «чистый верх»** (все hard rules становятся sub-policies ruflo). -**ruflo** (ruvnet/ruflo, v3.7.0-alpha.33 на момент design, MIT, экс-Claude-Flow) — orchestration sidecar: CLI + MCP server + daemon, 32 plugins, ~210 MCP tools, 100+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip protocols), HNSW vector memory, SONA neural routing, 9 RL algos. Source: WebFetch 15.05.2026 на upstream GitHub. +**ruflo** (npm: `ruflo`, v3.7.0-alpha.38 на момент Phase 1 pre-flight 2026-05-15, MIT, `ruvnet/claude-flow` legacy repo после rename Jan-2026; plugin-namespace `@claude-flow/*`) — orchestration sidecar: CLI + MCP server + daemon, **20 plugins** (Phase 1 Task 1.3 enumerated), 60+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip protocols), HNSW vector memory, SONA neural routing, 9 RL algos. Source: WebFetch 15.05.2026 + Phase 1 actual verifications. ## 1. Цели и не-цели @@ -118,42 +118,65 @@ User prompt → ruflo Queen receives По решению заказчика «чистый верх, всё sub-policy» — три hard rule (Pravila §12, CLAUDE.md §5 п.10, Pravila §5 ПДн) теряют hard-rule статус. Технические компенсаторы остаются (см. §9). -## 3. ruflo scope — 32 plugins (Full big-bang) +## 3. ruflo scope — 20 plugins (Full big-bang, post Phase 1 pre-flight 2026-05-15) -Точный enumerate — pre-flight Task 0 (см. §4 Day 1). +**Phase 1 pre-flight confirmed (см. §12 Q1-Q10):** ruflo `v3.7.0-alpha.38`, **20 plugins** в IPFS-registry `claude-flow-official` (CID `QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2`), namespace `@claude-flow/*` (legacy после rename Jan-2026 → ruflo, npm-package переименован, plugin-namespace остался). Пользовательский выбор Phase 1 decision gate: **установить все 20** (full big-bang). -**Известные категории (из WebFetch upstream GitHub):** +**Фактический enumerate (Task 1.3 output 2026-05-15):** -| # | Категория | Что входит | ~Count | -|---|---|---|---| -| 1 | Core | `ruflo-core`, `ruflo-intelligence`, `ruflo-memory` | 3 | -| 2 | Agents | `ruflo-agents` — 100+ agent types | 1 plugin | -| 3 | Memory / RAG | `ruflo-rag`, `ruflo-memory-hnsw`, `ruflo-memory-bridge` | 3 | -| 4 | DevTools | `ruflo-devtools`, `ruflo-browser` (18-tool gallery) | 2 | -| 5 | Loop-workers (daemon) | `ruflo-loop-workers` | 1 | -| 6 | LLM routing | `ruflo-ruvllm` (Ollama, Claude, GPT, Gemini, Cohere) | 1 | -| 7 | Federation / swarm | `ruflo-federation` (Raft, Byzantine, Gossip) | 1 | -| 8 | Web scraping | `ruflo-bright-data` | 1 | -| 9 | MCP tools | ~210 tools через `npx ruflo@latest mcp start` (5 server groups) | exposed via MCP | -| 10 | Остальные plugins | Точные имена — Task 0 enumerate | ~19-20 | +| # | Plugin | Version | Type | Downloads | Категория | +|---|---|---|---|---|---| +| 1 | `@claude-flow/embeddings` | 3.0.0-alpha.1 | core | 2 684 | Memory/Vector | +| 2 | `@claude-flow/security` | 3.0.0-alpha.1 | core | 520 | Security | +| 3 | `@claude-flow/plugin-agentic-qe` | 3.0.0-alpha.5 | integration | 289 | QE/Testing | +| 4 | `@claude-flow/plugin-prime-radiant` | 0.1.5 | integration | 216 | Generic | +| 5 | `@claude-flow/claims` | 3.0.0-alpha.8 | core | 156 | Auth/AuthZ | +| 6 | `@claude-flow/plugin-gastown-bridge` | 0.1.4 | integration | 150 | Integration | +| 7 | `@claude-flow/neural` | 3.0.0-alpha.7 | core | 94 | Neural routing (SONA) | +| 8 | `@claude-flow/plugins` | 3.0.0-alpha.1 | core | 44 | Plugin meta | +| 9 | `@claude-flow/performance` | 3.0.0-alpha.1 | command | 22 | Perf metrics | +| 10 | `@claude-flow/teammate-plugin` | 1.0.0-alpha.1 | integration | 0 | Coordination | +| 11 | `@claude-flow/plugin-healthcare-clinical` | 3.0.0-alpha.2 | integration | 0 | Domain-specific (нерелевантно CRM) | +| 12 | `@claude-flow/plugin-financial-risk` | 0.1.0 | integration | 0 | Domain (нерелевантно) | +| 13 | `@claude-flow/plugin-legal-contracts` | 3.0.0-alpha.2 | integration | 0 | Domain (нерелевантно) | +| 14 | `@claude-flow/plugin-code-intelligence` | 0.1.0 | integration | 0 | Code analysis (релевантно) | +| 15 | `@claude-flow/plugin-test-intelligence` | 0.1.0 | integration | 0 | Test analysis (релевантно) | +| 16 | `@claude-flow/plugin-perf-optimizer` | 3.0.0-alpha.2 | integration | 0 | Perf (релевантно) | +| 17 | `@claude-flow/plugin-neural-coordinator` | 0.1.0 | integration | 0 | Coordination (релевантно) | +| 18 | `@claude-flow/plugin-cognitive-kernel` | 0.1.0 | core | 0 | Reasoning (релевантно) | +| 19 | `@claude-flow/plugin-quantum-optimizer` | 0.1.0 | integration | 0 | Esoteric (нерелевантно) | +| 20 | `@claude-flow/plugin-hyperbolic-reasoning` | 0.1.0 | integration | 0 | Esoteric (нерелевантно) | + +**Categories summary:** 6 core + 1 command + 13 integration. **CRM-релевантно:** 11 plugins (6 core + 5 integration). **Нерелевантно но устанавливается** (per user choice «full big-bang»): 9 integration (medical/legal/financial/quantum/hyperbolic). + +**CLI subcommands (Task 1.2.2 output):** 33+ subcommands — `init`, `start`, `status`, `agent`, `swarm`, `memory`, `task`, `session`, `mcp`, `hooks`, `neural`, `security`, `performance`, `embeddings`, `hive-mind` (Queen-led consensus), `ruvector`, `guidance`, `autopilot`, `config`, `doctor`, `daemon`, `migrate`, `workflow`, `analyze`, `route`, `progress`, `providers`, `plugins`, `deployment`, `claims`, `issues`, `update`, `process`, `appliance`, `cleanup`. + +**Agent count correction:** npm description строго пишет **«60+ specialized agents»** (не «100+» как изначально assumed из WebFetch на README). Agents — внутри plugin'ов, не отдельные plugins. + +**MCP server:** stdio-mode (Task 1.6 verified — `INFO [claude-flow-mcp] Starting in stdio mode`) — **нет port-конфликта** с existing MCP entries в `.mcp.json`. Resolves Q5. + +**Plugin discovery — IPFS-based, operational risk:** + +Plugin registry fetched via IPFS (CID `QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2`). На 2026-05-15 при Task 1.3 — Pinata `gateway.pinata.cloud` + Cloudflare `cloudflare-ipfs.com` **gateways failed** (network errors), сработал только `ipfs.io` (324ms). Это материальный operational risk: если все gateways down → plugin discovery offline. Mitigation: после первоначального install ruflo кеширует plugin list локально (точное поведение не верифицировал — pre-flight Q11 для будущего). **Disk + runtime footprint:** -- `~/.ruflo-cache/` — HNSW vector store, ~1-5 GB на dev +- `~/.ruflo-cache/` — HNSW vector store + npm-cache npx (`@xenova/transformers + onnxruntime-web` — heavy ML deps уже скачаны Task 1.2, ~100-500 MB) - `.claude-flow/` — scaffold в репо (gitignored) - `CLAUDE.local.md` — новый файл, gitignored -- `.mcp.json` — +1 entry -- `~/.claude/settings.json` — +32 enabledPlugins entries -- Windows daemon — PM2 + pm2-windows-service (elevated PS install once) +- `.mcp.json` — +1 entry `ruflo` +- `~/.claude/settings.json` — +20 enabledPlugins entries (не 32) +- Windows daemon — PM2 + pm2-windows-service (elevated PS install, **elevation verified True** Task 1.5.1) +- Disk available: 67 GB free (Task 1.4.1) -**Pre-flight verifications (Task 0):** +**Pre-flight verifications COMPLETED (Task 0 closed 2026-05-15 commit `e55572e..` post-Phase-1):** -1. `npm view ruflo` — точная version + dist-tags. -2. `npx ruflo@latest plugins list` — enumerate 32 plugins → polish этот раздел. -3. `npx ruflo@latest init --help` — проверить scaffold-flags для безопасного init без overwrite корневого `CLAUDE.md`. -4. `npx ruflo@latest mcp start` smoke-test — MCP-server стартует на Windows + соединяется с Claude Code. -5. `pm2-service-install` — требует elevated PowerShell (Блокер 2 в §12 Q4). -6. Disk space check — `~/.ruflo-cache/` 1-5 GB. +1. ✅ `npm view ruflo` → v3.7.0-alpha.38, license MIT, repo points `ruvnet/claude-flow.git` (rename incomplete) +2. ✅ `npx ruflo@latest plugins list` → 20 plugins enumerated (table выше) +3. ⏸ `npx ruflo@latest init --help` — Phase 2 step 2.2.1 (deferred to install moment) +4. ✅ `npx ruflo@latest mcp start` → starts pid alive 15s, stdio mode +5. ✅ PowerShell elevation = True; PM2/pm2-windows-service not installed (Phase 2 step 2.8) +6. ✅ Disk space 67 GB free **Cost-budget setting в pre-flight:** @@ -359,7 +382,10 @@ pm2 save | 7 | PII leak через daemon agent | Low | Critical | gitleaks remains; RLS на DB; dev DB only | | 8 | Alpha-ruflo deprecated за 3-6 мес | Medium | Very High | Spec/plan позволяют revert; ruflo MIT — fork-able | | 9 | Cognitive load: 2 nav layers (ruflo + legacy) | Medium | Medium | Map fork визуализирует hybrid; Tooling §4.10 объясняет | -| 10 | PostgreSQL/Memurai порт-конфликт с ruflo MCP | Low | Medium | Pre-flight Task 0 verifies; alt-port | +| 10 | PostgreSQL/Memurai порт-конфликт с ruflo MCP | Low | Medium | **Resolved Task 1.6**: stdio mode, no port | +| 11 | IPFS gateway unavailability → plugin discovery offline (Pinata + Cloudflare gateways failed 2026-05-15; только ipfs.io worked) | Medium | Medium | Local plugin cache (если ruflo поддерживает) + monitor IPFS health; fallback на direct npm install plugin packages | +| 12 | Alpha plugin version inconsistency (core plugins на 3.0.0-alpha.1..8 — разные alphas; breaking changes возможны между ними) | Medium | Medium | Pin versions через ruflo lockfile (если есть) + Day 6 регрессия после любого update | +| 13 | Namespace mismatch `ruflo` package vs `@claude-flow/*` plugins (incomplete rename) | Low | Low | Documentation сохраняет оба имени; не блокирует функционал | ### 10.4. Net decision matrix @@ -418,20 +444,22 @@ claude mcp list 3. Revert этого commit'а; повторить регрессию. 4. Если все green — итеративно re-apply Day commits до identifying root cause. -## 12. Open questions (resolve в pre-flight Task 0) +## 12. Open questions — Phase 1 Task 0 resolution (2026-05-15) -| # | Вопрос | Resolution | +| # | Вопрос | Resolution status | |---|---|---| -| Q1 | Точный список 32 ruflo plugins | `npx ruflo@latest plugins list` | -| Q2 | Path к `~/.ruflo-cache/` на Windows | `npx ruflo config get cache-dir` | -| Q3 | Anthropic Managed Agents отдельная auth (vs Claude Code session) | `npx ruflo auth status` + ruflo docs | -| Q4 | PowerShell elevated сессия доступна? | User confirmation; иначе fallback foreground | -| Q5 | ruflo MCP конфликтует с existing MCP entries в `.mcp.json` | `npx ruflo@latest mcp start` smoke-test | -| Q6 | Pravila §12 переименование ломает skill-discipline hook? | Day 6 regression catches | -| Q7 | Push direct to main vs PR? | Memory `reference_github.md`: `Bash(git push origin main:*)` rule активна → direct main ОК | -| Q8 | Бэкап CLAUDE.md перед init | `cp CLAUDE.md CLAUDE.md.pre-ruflo.bak` Day 2 step 1 + commit current state as baseline | -| Q9 | Cyrillic memory files reindex качество | `ruflo memory reindex` smoke-test | -| Q10 | ruflo daemon доступ к Anthropic API key — общий с Claude Code session, или отдельный? | `npx ruflo config get auth` | +| Q1 | Точный список 20 ruflo plugins (не 32) | **✅ RESOLVED Task 1.3.** 20 plugins в IPFS-registry namespace `@claude-flow/*`. Полный enumerate — §3 таблица | +| Q2 | Path к `~/.ruflo-cache/` на Windows | ⏸ Phase 2 Task 2.2.3 verify через `npx ruflo config get cache-dir` после init | +| Q3 | Anthropic Managed Agents отдельная auth | ⏸ Phase 2 verify (cli `ruflo providers` + `ruflo config get auth`) | +| Q4 | PowerShell elevated сессия доступна? | **✅ RESOLVED Task 1.5.1.** `True` — pm2-service-install без эскалации | +| Q5 | ruflo MCP конфликтует с existing MCP entries | **✅ RESOLVED Task 1.6.** stdio mode (`INFO [claude-flow-mcp] Starting in stdio mode`) — нет port-конфликта | +| Q6 | Pravila §12 переименование ломает skill-discipline hook | ⏸ Phase 6 regression catches | +| Q7 | Push direct to main vs PR | **✅** Memory `reference_github.md`: `Bash(git push origin main:*)` rule активна → direct main ОК | +| Q8 | Бэкап CLAUDE.md перед init | **✅ Procedure documented** Phase 2 Task 2.1 — `cp CLAUDE.md CLAUDE.md.pre-ruflo.bak` + commit current state as baseline | +| Q9 | Cyrillic memory files reindex качество | ⏸ Phase 2 Task 2.10 + smoke во время реального reindex'а | +| Q10 | ruflo daemon доступ к Anthropic API key | ⏸ Phase 2 Task 2.9 при настройке `.env.local` | +| **Q11 (new)** | IPFS gateway availability + local cache behavior | **⚠️ MATERIAL RISK** — Pinata + Cloudflare gateways FAILED 2026-05-15; только `ipfs.io` worked. Mitigation: §10.3 risk #11 | +| **Q12 (new)** | Plugin version inconsistency 3.0.0-alpha.1..8 — breaking changes между ними? | **⚠️ MATERIAL RISK** — §10.3 risk #12; pin versions если ruflo поддерживает lockfile | ## 13. Termination conditions @@ -465,9 +493,18 @@ Big-bang считается завершённым когда: - [x] Section 11 Verification — baseline numbers конкретные; failure protocol. - [x] Section 12 Open questions — 10 Q's, resolve в Task 0. - [x] Section 13 Termination — 7 acceptance criteria. -- [ ] **NB ограничение:** не верифицировал работу `npx ruflo init` на Windows этой машины — Task 0 pre-flight. -- [ ] **NB ограничение:** не верифицировал, что `pm2-service-install` работает без elevation — может потребоваться user action. -- [ ] **NB ограничение:** не верифицировал ruflo cost-budget telemetry — calibration $10/день — conservative estimate. -- [ ] **NB ограничение:** не верифицировал cyrillic embedding качество в SONA pipeline — pre-flight smoke. +- [ ] **NB ограничение:** не верифицировал работу `npx ruflo init` на Windows этой машины — отложено в Phase 2 Task 2.2 (с `--dry-run` safety). +- [x] **Verified Phase 1:** PowerShell elevation = True — `pm2-service-install` доступна без эскалации. +- [ ] **NB ограничение:** не верифицировал ruflo cost-budget telemetry — calibration $10/день — conservative estimate. Phase 6 regression telemetry откалибрует. +- [ ] **NB ограничение:** не верифицировал cyrillic embedding качество в SONA pipeline — отложено в Phase 2 Task 2.10. + +**Phase 1 verified additionally (2026-05-15):** + +- [x] ruflo `v3.7.0-alpha.38` install via npx works on this Windows machine +- [x] **20 plugins** in registry (not 32 как изначально assumed) — full big-bang scope adjusted +- [x] ruflo MCP server starts in stdio mode — no port conflict +- [x] IPFS-based plugin discovery operational, но 2/3 gateways failed → **material risk** documented §10.3 #11 +- [x] Plugin namespace `@claude-flow/*` (legacy, не `ruflo-*`) — documentation note +- [x] Disk space 67 GB free (>> 5 GB requirement) **Конец spec.**