@claude-flow/cli 3.0.0-alpha.122 → 3.0.0-alpha.124

package/.claude/commands/training/neural-patterns.md

@@ -1,7 +1,15 @@
 # Neural Pattern Training
 
 ## Purpose
-Continuously improve coordination through neural network learning.
+Continuously improve coordination through neural network learning with SONA (Self-Optimizing Neural Architecture).
+
+## Pattern Persistence
+
+Patterns are **automatically persisted** to disk:
+- **Patterns**: `.claude-flow/neural/patterns.json`
+- **Stats**: `.claude-flow/neural/stats.json`
+
+Patterns survive process restarts and are loaded automatically on next session.
 
 ## How Training Works
 
@@ -13,17 +21,24 @@ Every successful operation trains the neural networks:
 - Agent coordination patterns
 
 ### 2. Manual Training
-```
-Tool: mcp__claude-flow__neural_train
-Parameters: {
-  "pattern_type": "coordination",
-  "training_data": "successful task patterns",
-  "epochs": 50
-}
+```bash
+# Train coordination patterns (50 epochs)
+npx claude-flow neural train -p coordination -e 50
+
+# Train optimization patterns with custom learning rate
+npx claude-flow neural train -p optimization -l 0.005
+
+# Quick training (10 epochs)
+npx claude-flow neural train -e 10
 ```
 
 ### 3. Pattern Types
 
+**Training Pattern Types:**
+- `coordination` - Task coordination strategies (default)
+- `optimization` - Performance optimization patterns
+- `prediction` - Predictive preloading patterns
+
 **Cognitive Patterns:**
 - Convergent: Focused problem-solving
 - Divergent: Creative exploration
@@ -33,42 +48,61 @@ Parameters: {
 - Abstract: High-level design
 
 ### 4. Improvement Tracking
-```
-Tool: mcp__claude-flow__neural_status
-Result: {
-  "patterns": {
-    "convergent": 0.92,
-    "divergent": 0.87,
-    "lateral": 0.85
-  },
-  "improvement": "5.3% since last session",
-  "confidence": 0.89
-}
+```bash
+# Check neural system status
+npx claude-flow neural status
 ```
 
-## Pattern Analysis
-```
-Tool: mcp__claude-flow__neural_patterns
-Parameters: {
-  "action": "analyze",
-  "operation": "recent_edits"
-}
+## Pattern Management
+
+```bash
+# List all persisted patterns
+npx claude-flow neural patterns --action list
+
+# Search patterns by query
+npx claude-flow neural patterns --action list -q "error handling"
+
+# Analyze patterns
+npx claude-flow neural patterns --action analyze -q "coordination"
 ```
 
+## Performance Targets
+
+| Metric | Target |
+|--------|--------|
+| SONA Adaptation | <0.05ms (achieved: ~2μs) |
+| Pattern Search | O(log n) with HNSW |
+| Memory Efficient | Circular buffers |
+
 ## Benefits
 - 🧠 Learns your coding style
 - 📈 Improves with each use
 - 🎯 Better task predictions
 - ⚡ Faster coordination
+- 💾 Patterns persist across sessions
+
+## CLI Reference
 
-## CLI Usage
 ```bash
-# Train neural patterns via CLI
-npx claude-flow neural train --type coordination --epochs 50
+# Train neural patterns
+npx claude-flow neural train -p coordination -e 50
 
 # Check neural status
 npx claude-flow neural status
 
+# List patterns
+npx claude-flow neural patterns --action list
+
+# Search patterns
+npx claude-flow neural patterns --action list -q "query"
+
 # Analyze patterns
-npx claude-flow neural patterns --analyze
-```
+npx claude-flow neural patterns --action analyze -q "coordination"
+```
+
+## Related Commands
+
+- `neural train` - Train patterns with SONA
+- `neural status` - Check neural system status
+- `neural patterns` - List and search patterns
+- `neural predict` - Make predictions using trained models

package/.claude/commands/training/neural-train.md

@@ -1,25 +1,75 @@
 # neural-train
 
-Train neural patterns from operations.
+Train neural patterns with SONA (Self-Optimizing Neural Architecture) for adaptive learning and pattern recognition.
 
 ## Usage
 ```bash
-npx claude-flow training neural-train [options]
+npx claude-flow neural train [options]
 ```
 
 ## Options
-- `--data <source>` - Training data source
-- `--model <name>` - Target model
-- `--epochs <n>` - Training epochs
+- `-p, --pattern <type>` - Pattern type: coordination, optimization, prediction (default: coordination)
+- `-e, --epochs <n>` - Number of training epochs (default: 50)
+- `-d, --data <file>` - Training data file (JSON)
+- `-m, --model <id>` - Model ID to train
+- `-l, --learning-rate <rate>` - Learning rate (default: 0.001)
+- `-b, --batch-size <n>` - Batch size (default: 32)
+
+## Pattern Persistence
+
+Trained patterns are **automatically persisted** to disk:
+- **Location**: `.claude-flow/neural/patterns.json`
+- **Stats**: `.claude-flow/neural/stats.json`
+
+Patterns survive process restarts and are loaded automatically on next session.
 
 ## Examples
+
 ```bash
-# Train from recent ops
-npx claude-flow training neural-train --data recent
+# Train coordination patterns (50 epochs)
+npx claude-flow neural train -p coordination -e 50
+
+# Train with custom learning rate
+npx claude-flow neural train -p optimization -l 0.005
 
-# Specific model
-npx claude-flow training neural-train --model task-predictor
+# Train from file
+npx claude-flow neural train -d ./training-data.json
 
-# Custom epochs
-npx claude-flow training neural-train --epochs 100
+# Quick training (10 epochs)
+npx claude-flow neural train -e 10
 ```
+
+## Output
+
+Training produces:
+- **Patterns Recorded**: Number of patterns stored in ReasoningBank
+- **Trajectories**: Complete learning sequences recorded
+- **SONA Adaptation**: Target is <0.05ms per operation
+- **Persistence Path**: Where patterns are saved
+
+## List Trained Patterns
+
+```bash
+# List all persisted patterns
+npx claude-flow neural patterns --action list
+
+# Search patterns by query
+npx claude-flow neural patterns --action list -q "error handling"
+
+# Analyze patterns
+npx claude-flow neural patterns --action analyze -q "coordination"
+```
+
+## Performance Targets
+
+| Metric | Target |
+|--------|--------|
+| SONA Adaptation | <0.05ms (achieved: ~2μs) |
+| Pattern Search | O(log n) with HNSW |
+| Memory Efficient | Circular buffers |
+
+## Related Commands
+
+- `neural patterns` - List and search patterns
+- `neural status` - Check neural system status
+- `neural predict` - Make predictions using trained models

package/README.md

@@ -3786,33 +3786,67 @@ docker run -d -p 5432:5432 ruvnet/ruvector-postgres
 | **[@ruvector/graph-node](https://www.npmjs.com/package/@ruvector/graph-node)** | Graph DB with Cypher queries | 10x faster than WASM |
 | **[@ruvector/rvlite](https://www.npmjs.com/package/@ruvector/rvlite)** | Standalone DB (SQL, SPARQL, Cypher) | All-in-one solution |
 
-### 🐘 RuVector Postgres — Centralized Learning & Coordination
+### 🐘 RuVector PostgreSQL — Enterprise Vector Database
 
-For production swarms requiring centralized state and coordination:
+**77+ SQL functions** for AI operations directly in PostgreSQL with ~61µs search latency and 16,400 QPS.
 
 ```bash
-# Pull and run RuVector Postgres
+# Quick setup with CLI (recommended)
+npx claude-flow ruvector setup --output ./my-ruvector
+cd my-ruvector && docker-compose up -d
+
+# Or pull directly from Docker Hub
 docker run -d \
   --name ruvector-postgres \
   -p 5432:5432 \
-  -e POSTGRES_PASSWORD=ruvector \
-  -v ruvector-data:/var/lib/postgresql/data \
+  -e POSTGRES_USER=claude \
+  -e POSTGRES_PASSWORD=claude-flow-test \
+  -e POSTGRES_DB=claude_flow \
   ruvnet/ruvector-postgres
 
-# Configure Claude-Flow to use centralized backend
-npx claude-flow@v3alpha config set memory.backend postgres
-npx claude-flow@v3alpha config set memory.postgresUrl "postgresql://postgres:ruvector@localhost:5432/ruvector"
+# Migrate existing memory to PostgreSQL
+npx claude-flow ruvector import --input memory-export.json
+```
+
+**RuVector PostgreSQL vs pgvector:**
+
+| Feature | pgvector | RuVector PostgreSQL |
+|---------|----------|---------------------|
+| **SQL Functions** | ~10 basic | **77+ comprehensive** |
+| **Search Latency** | ~1ms | **~61µs** |
+| **Throughput** | ~5K QPS | **16,400 QPS** |
+| **Attention Mechanisms** | ❌ None | **✅ 39 types (self, multi-head, cross)** |
+| **GNN Operations** | ❌ None | **✅ GAT, message passing** |
+| **Hyperbolic Embeddings** | ❌ None | **✅ Poincaré/Lorentz space** |
+| **Hybrid Search** | ❌ Manual | **✅ BM25/TF-IDF built-in** |
+| **Local Embeddings** | ❌ None | **✅ 6 fastembed models** |
+| **Self-Learning** | ❌ None | **✅ GNN-based optimization** |
+| **SIMD Optimization** | Basic | **AVX-512/AVX2/NEON (~2x faster)** |
+
+**Key SQL Functions:**
+
+```sql
+-- Vector operations with HNSW indexing
+SELECT * FROM embeddings ORDER BY embedding <=> query_vec LIMIT 10;
+
+-- Hyperbolic embeddings for hierarchical data
+SELECT ruvector_poincare_distance(a, b, -1.0) AS distance;
+SELECT ruvector_mobius_add(a, b, -1.0) AS result;
+
+-- Cosine similarity
+SELECT cosine_similarity_arr(a, b) AS similarity;
 ```
 
-**Benefits of Centralized Postgres:**
+**Benefits over Local SQLite:**
 
-| Feature | Local SQLite | RuVector Postgres |
-|---------|--------------|-------------------|
+| Feature | Local SQLite | RuVector PostgreSQL |
+|---------|--------------|---------------------|
 | **Multi-Agent Coordination** | Single machine | Distributed across hosts |
 | **Pattern Sharing** | File-based | Real-time synchronized |
 | **Learning Persistence** | Local only | Centralized, backed up |
 | **Swarm Scale** | 15 agents | 100+ agents |
-| **Query Language** | Basic KV | Full SQL + pgvector |
+| **Query Language** | Basic KV | Full SQL + 77 functions |
+| **AI Operations** | External only | **In-database (attention, GNN)** |
 
 <details>
 <summary>⚡ <strong>@ruvector/attention</strong> — Flash Attention (2.49x-7.47x Speedup)</summary>
@@ -3950,17 +3984,33 @@ const similarity = attention.attention(queries, keys, values);
 ### CLI Commands
 
 ```bash
-# Check ruvector installation
-npx ruvector status
-
-# Benchmark HNSW performance
+# RuVector PostgreSQL Setup (generates Docker files + SQL)
+npx claude-flow ruvector setup                    # Output to ./ruvector-postgres
+npx claude-flow ruvector setup --output ./mydir   # Custom directory
+npx claude-flow ruvector setup --print            # Preview files
+
+# Import from sql.js/JSON to PostgreSQL
+npx claude-flow ruvector import --input data.json              # Direct import
+npx claude-flow ruvector import --input data.json --output sql # Dry-run (generate SQL)
+
+# Other RuVector commands
+npx claude-flow ruvector status --verbose         # Check connection
+npx claude-flow ruvector benchmark --vectors 10000 # Performance test
+npx claude-flow ruvector optimize --analyze       # Optimization suggestions
+npx claude-flow ruvector backup --output backup.sql # Backup data
+
+# Native ruvector CLI
+npx ruvector status                               # Check installation
 npx ruvector benchmark --vectors 10000 --dimensions 384
+```
 
-# Initialize Postgres backend
-npx ruvector postgres init --url postgresql://localhost:5432/ruvector
-
-# Migrate patterns to centralized storage
-npx ruvector postgres migrate --from ./data/patterns
+**Generated Setup Files:**
+```
+ruvector-postgres/
+├── docker-compose.yml    # Docker services (PostgreSQL + pgAdmin)
+├── README.md             # Quick start guide
+└── scripts/
+    └── init-db.sql       # Database initialization (tables, indexes, functions)
 ```
 
 </details>

package/dist/src/commands/hive-mind.d.ts

@@ -1,6 +1,9 @@
 /**
  * V3 CLI Hive Mind Command
  * Queen-led consensus-based multi-agent coordination
+ *
+ * Updated to support --claude flag for launching interactive Claude Code sessions
+ * PR: Fix #955 - Implement --claude flag for hive-mind spawn command
  */
 import type { Command } from '../types.js';
 export declare const hiveMindCommand: Command;

package/dist/src/commands/hive-mind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hive-mind.d.ts","sourceRoot":"","sources":["../../../src/commands/hive-mind.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AA4zB1E,eAAO,MAAM,eAAe,EAAE,OA2C7B,CAAC;AAqEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"hive-mind.d.ts","sourceRoot":"","sources":["../../../src/commands/hive-mind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AA+uC1E,eAAO,MAAM,eAAe,EAAE,OAiD7B,CAAC;AAqEF,eAAe,eAAe,CAAC"}