mirror of
https://github.com/ruvnet/ruflo.git
synced 2026-09-14 14:01:28 +08:00
33a2c3ed07
* docs(dream-cycle): backfill LEDGER rows for 2026-08-24..09-03 Ledger-append step silently failed again for 10 consecutive nights (3rd occurrence of this failure class, first flagged 2026-08-19). Verified via git ls-remote + GitHub MCP issue/PR search before concluding this (all 10 nights ran to completion: real branch, issue, and draft PR each) rather than inferring failure from a sparse table. 2026-08-20..08-23 is a separate, confirmed-genuine 4-night gap where the pipeline did not run at all. Co-Authored-By: RuFlo <ruv@ruv.net> Claude-Session: https://claude.ai/code/session_01YQUz3bkMpqgtLXgkYa1LFF * dream(performance): wire real cold-start measurement, remove fabricated V2-vs-V3 benchmark (evaluated, ACCEPT-scoped) cli-cold-start.bench.ts's own measureColdStart() (a real, spawn-based process timer) was never called anywhere in the file. Every reported number instead came from setTimeout() delays, including a "V2 vs V3 Speedup: 5.00x" that was guaranteed by construction (setTimeout(100) vs setTimeout(20), no code between them) regardless of any real behavior. - Export measureColdStart(), add runRealColdStartMeasurement() and CLI_BIN_PATH; wire the real spawn-based measurement into the suite. - Remove the fabricated V2-vs-V3 comparison outright (no V2 binary remains to honestly compare against). - Add a deterministic Vitest regression test (4 assertions); fails against baseline (functions not exported, fabricated pattern still present), passes against candidate — confirmed via git-stash isolation. Full @claude-flow/performance suite: 99/99 passing. tsc --noEmit: clean. - Real measured number: node bin/cli.js --version, 5 runs, mean 54.65ms (min 51.94 / max 57.92) — well under the 500ms target. Caveat disclosed in-code: --version is the one subcommand that succeeds without a built dist/ in this worktree; this is not a full-CLI cold-start measurement. - Correct the two stale "Achieved" claims this fed in ADR-STATUS-SUMMARY.md's Performance Targets table (CLI Startup, and the already-known-false HNSW 150x-12,500x figure one row up). Darwin: skipped, scope mismatch (dead-code-wiring fix, not a tunable parameter). Flywheel: no signed bundle, deterministic Vitest evidence retained instead. Follow-ups documented in tonight's gist: same anti-pattern in agent-spawn/mcp-server-init/cli-warm-start bench files (not touched, kept to one conceptual change); a Raft election safety gap and a plugin supply-chain enforcement gap found by tonight's scan roles (hive-mind, security) but out of scope for the performance DEEP surface. Co-Authored-By: RuFlo <ruv@ruv.net> Claude-Session: https://claude.ai/code/session_01YQUz3bkMpqgtLXgkYa1LFF * docs(dream-cycle): append 2026-09-05 ledger row Co-Authored-By: RuFlo <ruv@ruv.net> Claude-Session: https://claude.ai/code/session_01YQUz3bkMpqgtLXgkYa1LFF --------- Co-authored-by: Claude <noreply@anthropic.com>
V3 Implementation Documentation
This directory contains all implementation documentation, planning, and research for Claude-Flow V3.
Directory Structure
implementation/
├── adrs/ # Architecture Decision Records
├── architecture/ # Architecture analysis & assessment
├── integration/ # Integration guides
├── migration/ # Migration documentation
├── optimization/ # Performance optimization roadmap
├── planning/ # Master plans & optimized strategies
├── research/ # Technical research (SQLite, Windows)
├── security/ # Security audit & fixes
└── swarm-plans/ # 15-agent swarm specifications
Document Index
ADRs (Architecture Decision Records)
| Document | Description |
|---|---|
| v3-adrs.md | All 10 ADRs (001-010) master document |
Architecture
| Document | Description |
|---|---|
| AGENTIC-FLOW-INTEGRATION-ANALYSIS.md | Deep analysis of agentic-flow integration |
| SDK-ARCHITECTURE-ANALYSIS.md | SDK architecture patterns and analysis |
| v3-assessment.md | V3 current state assessment |
Integration
| Document | Description |
|---|---|
| AGENTS-SKILLS-COMMANDS-HOOKS.md | Agent, skill, command, hook mapping |
| HOOKS-LEARNING-INTEGRATION.md | Learning hooks integration guide |
Migration
| Document | Description |
|---|---|
| MIGRATION-GUIDE.md | V2 to V3 migration guide |
| v3-migration-roadmap.md | Detailed migration roadmap |
Optimization
| Document | Description |
|---|---|
| V3-OPTIMIZATION-ROADMAP.md | Performance optimization targets |
Planning
| Document | Description |
|---|---|
| CLAUDE-FLOW-V3-MASTER-PLAN.md | Complete V3 master plan |
| LEARNING-OPTIMIZED-PLAN.md | Learning system optimization |
| V3-OPTIMIZED-PLAN.md | Optimized implementation plan |
Research
| Document | Description |
|---|---|
| better-sqlite3-usage-inventory.md | better-sqlite3 usage analysis |
| sqljs-implementation-guide.md | sql.js WASM implementation |
| windows-sqlite-sqljs-migration.md | Windows SQLite migration |
| windows-support-summary.md | Windows platform support |
Security
| Document | Description |
|---|---|
| SECURITY_AUDIT_REPORT.md | Full security audit report |
| SECURITY_FIXES_CHECKLIST.md | Security fixes checklist |
| SECURITY_SUMMARY.md | Security summary |
Swarm Plans
| Document | Description |
|---|---|
| SWARM-OVERVIEW.md | 15-agent swarm architecture |
| AGENT-SPECIFICATIONS.md | Individual agent specifications |
| TDD-LONDON-SCHOOL-PLAN.md | TDD methodology guide |
| BENCHMARK-OPTIMIZATION.md | Benchmark targets |
| DEPLOYMENT-PLAN.md | Deployment strategy |
| GITHUB-ISSUE-TRACKING.md | Issue tracking system |
| hooks/STATUSLINE-DAEMON.md | Statusline daemon system |
Quick Links
- Master Issue: GitHub Issue #927
- ADR Documentation: /v3/docs/adrs/
- Module Source: /v3/@claude-flow/
Statistics
| Category | Files | Total Size |
|---|---|---|
| ADRs | 1 | 22KB |
| Architecture | 3 | 177KB |
| Integration | 2 | 35KB |
| Migration | 2 | 38KB |
| Optimization | 1 | 11KB |
| Planning | 3 | 91KB |
| Research | 4 | 79KB |
| Security | 3 | 41KB |
| Swarm Plans | 7 | 111KB |
| Total | 26 | ~605KB |
Last Updated: 2026-01-05
Recovered From: Git history (commits 80a7f9f4, 52b2a308, 146c0cdc)