claude-flow-novice 2.18.17 → 2.18.18

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.18",
   "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",