claude-flow-novice 2.18.20 → 2.18.22

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

@@ -25,9 +25,12 @@ Add `--force` flag for complete reindex:
 Execute reindex:
 
 ```bash
+RUVECTOR_BIN="${HOME}/.local/bin/local-ruvector"
+[ ! -f "$RUVECTOR_BIN" ] && RUVECTOR_BIN="./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector"
+
 # Incremental (default - only changed files)
-./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector index --path . --types rs,ts,js,py,sh,md
+"$RUVECTOR_BIN" index --path . --types rs,ts,js,py,sh,md
 
 # Full rebuild (when needed)
-# ./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector index --path . --types rs,ts,js,py,sh,md --force
+# "$RUVECTOR_BIN" index --path . --types rs,ts,js,py,sh,md --force
 ```

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

@@ -27,5 +27,7 @@ Search your indexed codebase using RuVector. Uses SQLite index for fast lookups.
 Execute the search:
 
 ```bash
-./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector query "{{query}}" --max-results {{#if top}}{{top}}{{else}}10{{/if}}
+RUVECTOR_BIN="${HOME}/.local/bin/local-ruvector"
+[ ! -f "$RUVECTOR_BIN" ] && RUVECTOR_BIN="./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector"
+"$RUVECTOR_BIN" query "{{query}}" --max-results {{#if top}}{{top}}{{else}}10{{/if}}
 ```

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

@@ -30,5 +30,7 @@ Quick semantic search through your indexed codebase.
 Execute search:
 
 ```bash
-./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector query "$ARGUMENTS" --max-results 10
+RUVECTOR_BIN="${HOME}/.local/bin/local-ruvector"
+[ ! -f "$RUVECTOR_BIN" ] && RUVECTOR_BIN="./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector"
+"$RUVECTOR_BIN" query "$ARGUMENTS" --max-results 10
 ```

package/.claude/hooks/SessionStart-cfn-build-ruvector.sh

@@ -1,12 +1,24 @@
 #!/bin/bash
-# SessionStart hook: Build RuVector Rust binary if missing
+# SessionStart hook: Ensure RuVector binary is available (global or local)
+GLOBAL_BINARY="$HOME/.local/bin/local-ruvector"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
 RUVECTOR_DIR="$PROJECT_ROOT/.claude/skills/cfn-local-ruvector-accelerator"
-BINARY="$RUVECTOR_DIR/target/release/local-ruvector"
+LOCAL_BINARY="$RUVECTOR_DIR/target/release/local-ruvector"
 
-if [ ! -f "$BINARY" ]; then
+# Check global first (preferred)
+if [ -f "$GLOBAL_BINARY" ]; then
+    exit 0
+fi
+
+# Fall back to local binary
+if [ -f "$LOCAL_BINARY" ]; then
+    exit 0
+fi
+
+# Build locally if cargo available
+if command -v cargo &>/dev/null && [ -d "$RUVECTOR_DIR" ]; then
     echo "[cfn-build-ruvector] Building RuVector..."
-    command -v cargo &>/dev/null && cd "$RUVECTOR_DIR" && cargo build --release --quiet 2>/dev/null
-    [ -f "$BINARY" ] && echo "[cfn-build-ruvector] ✅ Built" || echo "[cfn-build-ruvector] Build skipped"
+    cd "$RUVECTOR_DIR" && cargo build --release --quiet 2>/dev/null
+    [ -f "$LOCAL_BINARY" ] && echo "[cfn-build-ruvector] Built locally" || echo "[cfn-build-ruvector] Build skipped"
 fi

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 (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
+# CLI direct (global install preferred)
+local-ruvector query "user login flow" --max-results 5
 ```
 
 ### Structural Search (V2 - SQL on AST)
@@ -48,6 +48,19 @@ sqlite3 ~/.local/share/ruvector/index_v2.db \
   "SELECT COUNT(*) FROM entities WHERE project_root = '/path/to/project';"
 ```
 
+## Installation
+
+**Global install (recommended for multi-project use):**
+```bash
+# From claude-flow-novice project
+./scripts/install-ruvector-global.sh
+
+# Verify
+local-ruvector --version
+```
+
+This installs to `~/.local/bin/local-ruvector` for access from any project.
+
 ## Prerequisites
 
 **OPENAI_API_KEY is REQUIRED for indexing.** Indexing will fail without a valid key.
@@ -73,7 +86,7 @@ echo $OPENAI_API_KEY  # Should show your key (not empty)
 
 ```bash
 # Index a project (first time or full rebuild)
-./target/release/local-ruvector index --path /path/to/project --types rs,ts,py
+local-ruvector index --path /path/to/project --types rs,ts,py
 
 # Incremental update (after code changes)
 /codebase-reindex
@@ -102,7 +115,7 @@ Before implementing changes, ALWAYS query RuVector first:
 # 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
+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

@@ -15,7 +15,7 @@
 //! - rs, ts, js, json, md, sh, yaml, yml, txt, config
 //! - Use --types to specify custom extensions
 //!
-//! ## Excluded Directories (see EXCLUDED_DIRS constant - 52 patterns):
+//! ## Excluded Directories (see EXCLUDED_DIRS constant - 54 patterns):
 //! - Dependencies: node_modules, vendor, .pnpm, .yarn
 //! - Build artifacts: target, dist, build, out, .next, .nuxt, .output, .turbo, .parcel-cache
 //! - VCS: .git, .svn, .hg
@@ -23,7 +23,7 @@
 //! - Cache: .cache, __pycache__, .pytest_cache, .mypy_cache, .ruff_cache, coverage, .nyc_output
 //! - Virtual envs: .venv, venv, env
 //! - IaC: .terraform, .serverless, .aws-sam
-//! - Project-specific: .artifacts, .ruvector, .archive, archive
+//! - Project-specific: .artifacts, .ruvector, .archive, archive, .archived, archived
 //! - Backups/temp: backups, .backups, backup, tmp, .tmp, temp, logs
 //! - Test artifacts: __snapshots__, __mocks__, playwright-report, test-results
 //! - Doc builds: _site, .docusaurus, site
@@ -122,6 +122,8 @@ const EXCLUDED_DIRS: &[&str] = &[
     ".ruvector",         // RuVector local index (avoid self-indexing)
     ".archive",          // Archived/deprecated code
     "archive",           // Archive directories
+    ".archived",         // Archived code (alternate naming)
+    "archived",          // Archived directories
 
     // Backups & generated
     "backups",           // Backup directories

package/CLAUDE.md

@@ -54,7 +54,7 @@ Always provide `context_files` when code needs imports from existing files.
    ```bash
    # Semantic search
    /codebase-search "authentication middleware pattern"
-   ./.claude/skills/cfn-local-ruvector-accelerator/target/release/local-ruvector query --pattern "auth"
+   local-ruvector query --pattern "auth"
 
    # Structural SQL query
    sqlite3 ~/.local/share/ruvector/index_v2.db "SELECT * FROM refs WHERE target_name = 'MyFunction';"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.18.20",
+  "version": "2.18.22",
   "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",

package/scripts/install-ruvector-global.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# Install RuVector binary to ~/.local/bin for global access
+# Usage: ./scripts/install-ruvector-global.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+RUVECTOR_DIR="$PROJECT_ROOT/.claude/skills/cfn-local-ruvector-accelerator"
+TARGET_BIN="$HOME/.local/bin/local-ruvector"
+
+echo "[ruvector-install] Installing RuVector to ~/.local/bin/"
+
+# Ensure ~/.local/bin exists
+mkdir -p "$HOME/.local/bin"
+
+# Check if we need to build
+SOURCE_BINARY="$RUVECTOR_DIR/target/release/local-ruvector"
+if [ ! -f "$SOURCE_BINARY" ]; then
+    echo "[ruvector-install] Building RuVector from source..."
+    if ! command -v cargo &>/dev/null; then
+        echo "[ruvector-install] ERROR: cargo not found. Install Rust: https://rustup.rs"
+        exit 1
+    fi
+    cd "$RUVECTOR_DIR"
+    cargo build --release
+fi
+
+# Copy binary
+if [ -f "$SOURCE_BINARY" ]; then
+    cp "$SOURCE_BINARY" "$TARGET_BIN"
+    chmod +x "$TARGET_BIN"
+    echo "[ruvector-install] Installed: $TARGET_BIN"
+    echo "[ruvector-install] Version: $($TARGET_BIN --version 2>/dev/null || echo 'unknown')"
+else
+    echo "[ruvector-install] ERROR: Build failed - binary not found"
+    exit 1
+fi
+
+# Verify PATH
+if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
+    echo ""
+    echo "[ruvector-install] WARNING: ~/.local/bin not in PATH"
+    echo "Add to your shell profile:"
+    echo '  export PATH="$HOME/.local/bin:$PATH"'
+fi
+
+echo "[ruvector-install] Done. Run 'local-ruvector --help' to verify."