claude-flow-novice 2.18.17 → 2.18.19

package/.claude/commands/cfn-ruvector/cfn-codebase-reindex.md

@@ -1,37 +1,33 @@
 ---
-description: Update codebase index using git-detected changes (auto mode, incremental)
+description: Update codebase index (default incremental, --force for full rebuild)
 ---
 
 # Codebase Reindex Command
 
-**Default mode: Auto-detection** - Indexes only changed files detected from git status (fast, incremental).
+**Default mode:** Incremental - only re-indexes files with changed hashes (fast).
 
 **Use when:**
-- After committing code changes (recommended workflow)
-- Regular updates after development work
-- Need to refresh index for recently modified files
+- After code changes
+- Regular development workflow
+- Need to refresh index
 
-**Process (--auto mode):**
-1. Detects staged and modified files via `git diff`
-2. Filters for indexable extensions (TypeScript, Python, etc.)
-3. Incrementally updates RuVector database
-4. Only re-indexes changed files
+**For full rebuild:**
+Add `--force` flag for complete reindex:
+- First-time setup
+- Major restructuring
+- Index issues
 
-**Estimated time:** 5-30 seconds (depends on number of changed files)
+**Prerequisites:**
+- OPENAI_API_KEY must be set: `export OPENAI_API_KEY="sk-..."`
 
 ---
 
-**For full rebuild (only when needed):**
-Add `--full` flag if you need to rebuild the entire index from scratch:
-- First-time setup
-- Major codebase restructuring
-- Index corrupted or missing
-- After config changes (extensions, ignore patterns)
+Execute reindex:
 
 ```bash
-# Default: Auto-detect changed files (fast)
-./.claude/skills/cfn-ruvector-codebase-index/index.sh --auto
+# Incremental (default - only changed files)
+./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector index --path . --types rs,ts,js,py,sh,md
 
-# Full rebuild (only when explicitly needed)
-./.claude/skills/cfn-ruvector-codebase-index/index.sh --full
+# Full rebuild (when needed)
+# ./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector index --path . --types rs,ts,js,py,sh,md --force
 ```

package/.claude/commands/cfn-ruvector/cfn-codebase-search.md

@@ -1,38 +1,31 @@
 ---
-description: Search codebase using natural language queries via RuVector semantic index
+description: Search codebase using RuVector semantic index (400x faster than grep)
 arguments:
   query:
     description: Natural language search query
     required: true
   --top:
-    description: Number of results to return (default 5)
+    description: Number of results to return (default 10)
     required: false
 ---
 
 # Codebase Search Command
 
-Search your indexed codebase using natural language queries. Uses RuVector's semantic search to find relevant files based on meaning, not just keywords.
+Search your indexed codebase using RuVector. Uses SQLite index for fast lookups.
 
 **Examples:**
-- `/codebase-search authentication logic`
-- `/codebase-search React components for user profile --top 10`
-- `/codebase-search database migration utilities`
-- `/codebase-search error handling patterns`
-
-**Returns:**
-- File paths ranked by relevance
-- File purpose and exports
-- Code metrics (lines, complexity)
-- Relevance scores
+- `/cfn-ruvector:cfn-codebase-search authentication logic`
+- `/cfn-ruvector:cfn-codebase-search React components --top 20`
+- `/cfn-ruvector:cfn-codebase-search database migration`
 
 **Prerequisites:**
-- Codebase must be indexed first (run `/codebase-reindex`)
-- OPENAI_API_KEY or ZAI_API_KEY must be set
+- Codebase must be indexed: `./local-ruvector index --path . --force`
+- OPENAI_API_KEY must be set for indexing
 
 ---
 
 Execute the search:
 
 ```bash
-./.claude/skills/cfn-ruvector-codebase-index/search.sh "{{query}}" {{#if top}}--top {{top}}{{/if}}
+./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector query "{{query}}" --max-results {{#if top}}{{top}}{{else}}10{{/if}}
 ```

package/.claude/commands/cfn-ruvector-search.md

@@ -1,46 +1,34 @@
 ---
-description: "Semantic code search with RuVector"
+description: "Semantic code search with RuVector (400x faster than grep)"
 argument-hint: "<query>"
 ---
 
-# /search - Semantic Code Search
+# RuVector Search
 
-Quick semantic search through your codebase using RuVector.
+Quick semantic search through your indexed codebase.
 
 ## Usage
 
-```bash
-/search "authentication middleware"
-/search "error handling pattern"
-/search "database connection setup"
+```
+/cfn-ruvector-search "authentication middleware"
+/cfn-ruvector-search "error handling pattern"
 ```
 
 ## What it does
 
-- Searches for semantically similar code (not just text matching)
-- Returns the most relevant code snippets with similarity scores
-- Helps find existing implementations before building new ones
+- Queries pre-built SQLite index (not filesystem scan)
+- Returns file paths with line numbers
+- 400x faster than grep for indexed projects
 
-## Examples
+## Prerequisites
 
-Find similar implementations:
-```bash
-/search "user login flow"
-```
+- Project must be indexed first
+- Run: `./local-ruvector index --path . --force`
 
-Find error patterns:
-```bash
-/search "timeout error handling"
-```
-
-Find API patterns:
-```bash
-/search "REST API validation"
-```
+---
 
-## Advanced Options
+Execute search:
 
-For more control, use the full command:
 ```bash
-/codebase-search "query" --top 10 --full
-```
+./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector query "$ARGUMENTS" --max-results 10
+```

package/.claude/skills/cfn-local-ruvector-accelerator/SKILL.md

@@ -29,8 +29,8 @@ sqlite3 ~/.local/share/ruvector/index_v2.db "SELECT file_path, line_number FROM
 /codebase-search "authentication middleware pattern"
 /cfn-ruvector-search "error handling in API routes"
 
-# CLI direct
-./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector query --pattern "user login flow"
+# CLI direct (note: query text is positional, use --max-results not --limit)
+./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector query "user login flow" --max-results 5
 ```
 
 ### Structural Search (V2 - SQL on AST)
@@ -48,6 +48,27 @@ sqlite3 ~/.local/share/ruvector/index_v2.db \
   "SELECT COUNT(*) FROM entities WHERE project_root = '/path/to/project';"
 ```
 
+## Prerequisites
+
+**OPENAI_API_KEY is REQUIRED for indexing.** Indexing will fail without a valid key.
+
+```bash
+# Option 1: Export before running
+export OPENAI_API_KEY="sk-..."
+
+# Option 2: Add to shell profile (~/.bashrc or ~/.zshrc)
+echo 'export OPENAI_API_KEY="sk-..."' >> ~/.bashrc
+source ~/.bashrc
+
+# Option 3: Inline with command
+OPENAI_API_KEY="sk-..." ./local-ruvector index --path /project
+```
+
+**Verify key is set:**
+```bash
+echo $OPENAI_API_KEY  # Should show your key (not empty)
+```
+
 ## Index Management
 
 ```bash
@@ -78,8 +99,10 @@ sqlite3 ~/.local/share/ruvector/index_v2.db "SELECT project_root, COUNT(*) FROM
 
 Before implementing changes, ALWAYS query RuVector first:
 ```bash
-# Find similar patterns
+# Find similar patterns (slash command uses --top, CLI uses --max-results)
 /codebase-search "relevant search terms" --top 5
+# Or via CLI:
+./local-ruvector query "relevant search terms" --max-results 5
 
 # Query past errors
 ./.claude/skills/cfn-ruvector-codebase-index/query-error-patterns.sh --task-description "description"

package/.claude/skills/cfn-local-ruvector-accelerator/src/cli/index.rs

@@ -46,7 +46,7 @@ use anyhow::{Result, Context, anyhow};
 use std::fs;
 use std::path::{Path, PathBuf};
 use walkdir::{WalkDir, DirEntry};
-use tracing::{info, debug, warn};
+use tracing::{info, debug, warn, error};
 use regex::Regex;
 use std::sync::Arc;
 use std::sync::RwLock;
@@ -286,6 +286,15 @@ impl IndexCommand {
     }
 
     pub fn execute(&mut self) -> Result<IndexStats> {
+        // Fail early if OPENAI_API_KEY is not set
+        if std::env::var("OPENAI_API_KEY").is_err() {
+            error!("OPENAI_API_KEY environment variable is required for indexing");
+            return Err(anyhow!(
+                "OPENAI_API_KEY not found. Set it with: export OPENAI_API_KEY=\"sk-...\"\n\
+                 Indexing requires a valid OpenAI API key for generating embeddings."
+            ));
+        }
+
         info!("Starting index process");
         info!("File types: {:?}", self.file_types);
         if let Some(ref patterns) = self.patterns {

package/.claude/skills/cfn-local-ruvector-accelerator/src/cli/index_ast.rs

@@ -99,6 +99,15 @@ impl AstIndexCommand {
     }
 
     pub fn execute(&mut self) -> Result<IndexStats> {
+        // Fail early if OPENAI_API_KEY is not set
+        if std::env::var("OPENAI_API_KEY").is_err() {
+            error!("OPENAI_API_KEY environment variable is required for indexing");
+            return Err(anyhow!(
+                "OPENAI_API_KEY not found. Set it with: export OPENAI_API_KEY=\"sk-...\"\n\
+                 Indexing requires a valid OpenAI API key for generating embeddings."
+            ));
+        }
+
         let start_time = std::time::Instant::now();
 
         info!("Starting AST-based index process");

package/.claude/skills/cfn-local-ruvector-accelerator/src/embeddings.rs

@@ -101,13 +101,10 @@ impl EmbeddingsManager {
         debug!("Generating embeddings for {} texts", texts.len());
 
         if self.config.api_key.is_none() {
-            warn!("OpenAI API key not found, falling back to dummy embeddings");
-            let mut embeddings = Vec::with_capacity(texts.len());
-            for text in texts {
-                embeddings.push(self.generate_dummy_embedding(text));
-            }
-            info!("Generated {} dummy embeddings", embeddings.len());
-            return Ok(embeddings);
+            error!("OPENAI_API_KEY environment variable not set");
+            return Err(anyhow!(
+                "OPENAI_API_KEY not found. Set it with: export OPENAI_API_KEY=\"sk-...\""
+            ));
         }
 
         let mut all_embeddings = Vec::with_capacity(texts.len());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.18.17",
+  "version": "2.18.19",
   "description": "Claude Flow Novice - Advanced orchestration platform for multi-agent AI workflows with CFN Loop architecture\n\nIncludes Local RuVector Accelerator and all CFN skills for complete functionality.",
   "main": "index.js",
   "type": "module",