claude-flow-novice 2.18.12 → 2.18.13

package/.claude/agents/custom/claude-code-expert.md

@@ -237,6 +237,61 @@ Claude Code auto-discovers MCP servers from:
 
 To prevent auto-discovered servers from connecting, add them to `disabledMcpServers`.
 
+## SKILL.md Best Practices
+
+### Description Field is Primary Discovery
+- Claude reads **only the `description` field** at startup to decide when to invoke skills
+- Full SKILL.md content is loaded **only after** Claude decides the skill is relevant
+- Description must answer: **What does it do?** + **When should it be used?**
+
+### Effective Description Formula
+```yaml
+description: "<Capability>. Use when <condition 1>, <condition 2>, or <condition 3>."
+```
+
+**Good example:**
+```yaml
+description: "Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction."
+```
+
+**Bad examples:**
+- `"Helps with documents"` - too vague
+- `"Processes data"` - too generic
+- Missing trigger conditions
+
+### Required Frontmatter
+```yaml
+---
+name: lowercase-skill-name    # Max 64 chars, hyphens/lowercase only
+description: What + when      # Max 1024 chars
+version: 1.0.0               # Optional but recommended
+tags: [category, type]       # For organization (not indexed by Claude)
+---
+```
+
+### Content Best Practices
+- **Under 500 lines** in SKILL.md body
+- Use **progressive disclosure** - detailed docs in separate files
+- Include concrete **Quick Start** examples
+- One level deep for reference files (no deep nesting)
+
+### Anti-Patterns to Avoid
+- Missing trigger conditions in description
+- Verbose prose instead of blueprints
+- Time-sensitive information
+- Offering too many options without clear recommendation
+- Inconsistent terminology
+
+### Skill Analysis Checklist
+When reviewing SKILL.md files, verify:
+- [ ] Description includes both capability AND trigger conditions
+- [ ] Uses "Use when..." pattern for discovery
+- [ ] Under 500 lines in body
+- [ ] Has YAML frontmatter with name, description
+- [ ] Includes concrete Quick Start example
+- [ ] No deep nesting of reference files
+- [ ] Consistent terminology throughout
+
 ## Documentation URLs to Reference
 
 Primary resources:
@@ -244,6 +299,7 @@ Primary resources:
 - https://docs.claudecode.com/workflows
 - https://docs.claudecode.com/tools
 - https://docs.claudecode.com/best-practices
+- https://docs.claudecode.com/skills (skill creation guide)
 
 ## Output Format
 

package/.claude/skills/cfn-agent-lifecycle/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-agent-lifecycle
-description: Unified agent management from selection through completion - spawning, execution, output processing
+description: "Unified agent management from selection through completion - spawning, execution, output processing. Use when selecting agents for tasks, spawning agents with dependency validation, processing agent outputs, or tracking agent lifecycle events with audit trails."
 version: 2.0.0
 tags: [mega-skill, agent-management, lifecycle, spawning]
 status: production

package/.claude/skills/cfn-agent-tooling/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-agent-tooling
-description: Agent development tools - generation and validation
+description: "Agent development tools - generation and validation. Use when creating new agent templates from scaffolding, or validating and linting existing agent profiles for correctness and completeness."
 version: 1.0.0
 tags: [mega-skill, agents, templates, validation, development]
 status: production

package/.claude/skills/cfn-compilation-error-fixer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-compilation-error-fixer
-description: Two-phase compilation error fixer for Rust and TypeScript using Cerebras LLM bulk processing + dedicated agent cleanup
+description: "Two-phase compilation error fixer for Rust and TypeScript using Cerebras LLM bulk processing + dedicated agent cleanup. Use when you have 20+ compilation errors that need fast bulk reduction, or when errors are mostly mechanical (type mismatches, missing imports, syntax issues)."
 version: 2.0.0
 tags: [rust, typescript, compilation, cerebras, error-fixer, cfn]
 status: production

package/.claude/skills/cfn-compilation-error-fixer/lib/fixer/cerebras-gated-fixer-v2.ts

@@ -25,7 +25,7 @@ const CONFIG = {
   maxLayer1Retries: 3,  // Max retries when Layer 1 gates reject
   maxTokens: 4000,
   model: 'zai-glm-4.6',
-  projectPath: '/mnt/c/Users/masha/Documents/ourstories-v2/services/rust-services',
+  projectPath: process.env.RUST_PROJECT_PATH || '/mnt/c/Users/masha/Documents/ourstories-v2/services/rust-services',
   parallelLLMCalls: 10,
   enableLayer3: !process.argv.includes('--no-layer3'),
   enableClippy: !process.argv.includes('--no-clippy'),

package/.claude/skills/cfn-config/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-config
-description: Configuration management and environment sanitization
+description: "Configuration management and environment sanitization. Use when you need to manage configuration files, validate environment variables, sanitize sensitive data, or update system settings across CFN Loop components."
 version: 1.0.0
 tags: [mega-skill, config, environment, sanitization]
 status: production

package/.claude/skills/cfn-dependency-management/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-dependency-management
-description: Task dependency extraction and context ingestion
+description: "Task dependency extraction and context ingestion. Use when you need to parse task criteria, identify dependencies, generate execution order, or inject context for complex multi-step tasks."
 version: 1.1.0
 tags: [mega-skill, dependencies, extraction, ingestion, orchestration]
 status: production

package/.claude/skills/cfn-deployment-lifecycle/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-deployment-lifecycle
-description: Skill deployment and promotion lifecycle management
+description: "Skill deployment and promotion lifecycle management. Use when transitioning skills from APPROVED to DEPLOYED status, or promoting skills from staging to production with SLA enforcement."
 version: 1.0.0
 tags: [mega-skill, deployment, promotion, lifecycle]
 status: production

package/.claude/skills/cfn-docker-runtime/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-docker-runtime
-description: Docker container orchestration for CFN Loop - spawning, coordination, logging, wave execution
+description: "Docker container orchestration for CFN Loop - spawning, coordination, logging, wave execution. Use when running CFN Loop agents in Docker containers, executing waves of parallel agents, coordinating containerized agents via Redis, or managing Docker-based agent lifecycle."
 version: 1.0.0
 tags: [mega-skill, docker, containers, orchestration]
 status: production

package/.claude/skills/cfn-edit-safety/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-edit-safety
-description: Pre-edit backup and post-edit validation for safe file modifications
+description: "Pre-edit backup and post-edit validation for safe file modifications. Use when you need to capture file state before edits, validate changes after modifications, revert files to previous state, or ensure edit safety with automatic backup and validation hooks."
 version: 1.0.0
 tags: [mega-skill, backup, hooks, validation, safety]
 status: production

package/.claude/skills/cfn-epic-parser/SKILL.md

@@ -1,3 +1,11 @@
+---
+name: cfn-epic-parser
+description: "Converts natural language epic documents from markdown into structured JSON configurations for MDAP or CFN Loop execution. Use when you need to parse epic documents, validate epic structure, or generate execution configurations from planning documents."
+version: 1.0.0
+tags: [epic, parser, mdap, cfn-loop, planning]
+status: production
+---
+
 # CFN Epic Parser
 
 ## Overview

package/.claude/skills/cfn-error-management/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-error-management
-description: Unified error handling, batching, and logging for CFN Loop
+description: "Unified error handling, batching, and logging for CFN Loop. Use when you need to capture agent errors, batch multiple errors for processing, log structured error data, or categorize and recover from agent failures."
 version: 1.0.0
 tags: [mega-skill, errors, logging, batch-processing]
 status: production

package/.claude/skills/cfn-intervention-system/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-intervention-system
-description: Human intervention detection and orchestration for CFN Loop
+description: "Human intervention detection and orchestration for CFN Loop. Use when automated processes need human oversight, when escalation is required, or when managing intervention workflows and approval gates."
 version: 1.0.0
 tags: [mega-skill, intervention, human-in-the-loop, escalation]
 status: production

package/.claude/skills/cfn-knowledge-base/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-knowledge-base
-description: Organizational learning from CFN Loop execution - workflow codification and playbooks
+description: "Organizational learning from CFN Loop execution - workflow codification and playbooks. Use when you need to store successful patterns, query past learnings, track edge cases and failures, or retrieve agent configurations and iteration strategies from previous tasks."
 version: 1.0.0
 tags: [mega-skill, learning, workflow, playbook]
 status: production

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

@@ -1,3 +1,11 @@
+---
+name: cfn-local-ruvector-accelerator
+description: "Lightning-fast local RuVector storage optimized for solo development with pure local file storage and vector search. Use when you need instant pattern lookup without PostgreSQL or Docker overhead, or when working offline with local semantic code search."
+version: 1.0.0
+tags: [ruvector, local, vector-search, patterns, offline]
+status: production
+---
+
 # Local RuVector Accelerator
 
 ## Description

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

@@ -31,6 +31,7 @@ impl Default for IndexStats {
 
 pub struct IndexCommand {
     project_dir: PathBuf,
+    source_path: PathBuf,  // Path to walk for files (can differ from project_dir)
     index_path: PathBuf,
     file_types: Vec<String>,
     patterns: Option<Vec<String>>,
@@ -53,8 +54,16 @@ impl IndexCommand {
         let search_engine = SearchEngine::new(project_dir).unwrap();
         let store = SqliteStore::new(&index_path.join("index.db")).unwrap();
 
+        // Use path argument for file collection, defaulting to project_dir if path is empty
+        let source_path = if path.as_os_str().is_empty() || path == Path::new(".") {
+            project_dir.to_path_buf()
+        } else {
+            path.to_path_buf()
+        };
+
         Self {
             project_dir: project_dir.to_path_buf(),
+            source_path,
             index_path,
             file_types,
             patterns,
@@ -95,7 +104,7 @@ impl IndexCommand {
             .context("Failed to create index directory")?;
 
         // Initialize search engine
-        let mut search_engine = self.search_engine.clone();
+        let mut search_engine = self.search_engine.duplicate()?;
         search_engine.load_or_create()?;
 
         // Initialize database
@@ -106,11 +115,11 @@ impl IndexCommand {
     }
 
     fn collect_files(&self) -> Result<Vec<PathBuf>> {
-        info!("Collecting files to index");
+        info!("Collecting files to index from: {}", self.source_path.display());
 
         let mut files = Vec::new();
 
-        let walker = WalkDir::new(&self.project_dir)
+        let walker = WalkDir::new(&self.source_path)
             .into_iter()
             .filter_entry(|e| !Self::is_hidden(e))
             .filter_map(|e| e.ok())
@@ -125,6 +134,15 @@ impl IndexCommand {
                     return false;
                 }
 
+                // Skip node_modules, target, dist, build directories
+                let path_str = e.path().to_string_lossy();
+                if path_str.contains("/node_modules/") ||
+                   path_str.contains("/target/") ||
+                   path_str.contains("/dist/") ||
+                   path_str.contains("/build/") {
+                    return false;
+                }
+
                 // Check file extension
                 if let Some(ext) = e.path().extension() {
                     self.file_types.contains(&ext.to_string_lossy().to_string())
@@ -144,7 +162,14 @@ impl IndexCommand {
     fn is_hidden(entry: &DirEntry) -> bool {
         entry.file_name()
             .to_str()
-            .map(|s| s.starts_with('.'))
+            .map(|s| {
+                // Allow .claude directory (contains agents, skills, commands, hooks)
+                if s == ".claude" {
+                    return false;
+                }
+                // Skip other hidden directories (like .git, .ruvector, etc.)
+                s.starts_with('.')
+            })
             .unwrap_or(false)
     }
 

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

@@ -62,7 +62,7 @@ impl QueryCommand {
         info!("Executing query: {}", self.config.query);
 
         // Load the search engine
-        let mut search_engine = self.search_engine.clone();
+        let mut search_engine = self.search_engine.duplicate()?;
         search_engine.load_or_create()?;
 
         // Perform search
@@ -170,7 +170,7 @@ impl BatchQueryCommand {
         info!("Executing batch queries from: {}", self.batch_file.display());
 
         // Load the search engine
-        let mut search_engine = self.search_engine.clone();
+        let mut search_engine = self.search_engine.duplicate()?;
         search_engine.load_or_create()?;
 
         // Read batch queries

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

@@ -1,14 +1,157 @@
+use anyhow::{Result, Context, anyhow};
+use ndarray::{Array1, Array2};
+use byteorder::{LittleEndian, ReadBytesExt, WriteBytesExt};
+use std::path::{Path, PathBuf};
+use std::fs::{File, OpenOptions};
+use std::io::{Read, Write, BufReader, BufWriter};
+use std::collections::HashMap;
+use serde::{Serialize, Deserialize};
+use tracing::info;
+use memmap2::MmapOptions;
+use crate::embeddings::EmbeddingsManager;
+use crate::sqlite_store::SqliteStore;
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct SearchConfig {
+    pub dimension: usize,
+    pub batch_size: usize,
+    pub max_results: usize,
+    pub index_path: PathBuf,
+    pub use_mmap: bool,
+}
+
+impl Default for SearchConfig {
+    fn default() -> Self {
+        Self {
+            dimension: 1536,
+            batch_size: 100,
+            max_results: 10,
+            index_path: PathBuf::from("index"),
+            use_mmap: true,
+        }
+    }
+}
+
+#[derive(Debug, Clone)]
+pub struct VectorIndex {
+    pub vectors: Array2<f32>,
+    pub ids: Vec<String>,
+    pub metadata: HashMap<String, IndexMetadata>,
+}
+
+impl VectorIndex {
+    pub fn new(dimension: usize) -> Self {
+        Self {
+            vectors: Array2::zeros((0, dimension)),
+            ids: Vec::new(),
+            metadata: HashMap::new(),
+        }
+    }
+
+    pub fn add_vector(&mut self, id: String, vector: Array1<f32>, metadata: IndexMetadata) -> Result<()> {
+        if vector.len() != self.vectors.ncols() {
+            return Err(anyhow!("Vector dimension mismatch"));
+        }
+
+        let new_row = self.vectors.nrows();
+        self.vectors.push_row(vector.view())?;
+        self.ids.push(id.clone());
+        self.metadata.insert(id, metadata);
+
+        Ok(())
+    }
+
+    pub fn add_vectors(&mut self, vectors: Vec<Array1<f32>>, ids: Vec<String>, metadata: HashMap<String, IndexMetadata>) -> Result<()> {
+        if vectors.len() != ids.len() {
+            return Err(anyhow!("Vectors and IDs length mismatch"));
+        }
+
+        for (vector, id) in vectors.into_iter().zip(ids.into_iter()) {
+            let meta = metadata.get(&id).cloned().unwrap_or_else(|| IndexMetadata::default());
+            self.add_vector(id, vector, meta)?;
+        }
+
+        Ok(())
+    }
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, Default)]
+pub struct IndexMetadata {
+    pub path: String,
+    pub pattern: String,
+    pub context: Option<String>,
+    pub line_number: Option<usize>,
+    pub snippet: Option<String>,
+    pub file_hash: String,
+    pub indexed_at: u64,
+}
+
+#[derive(Debug, Clone)]
+pub struct SearchResult {
+    pub id: String,
+    pub path: String,
+    pub pattern: String,
+    pub score: f32,
+    pub context: Option<String>,
+    pub line_number: Option<usize>,
+    pub snippet: Option<String>,
+}
+
+#[derive(Debug, Clone)]
+pub struct IndexStats {
+    pub num_vectors: usize,
+    pub dimension: usize,
+    pub index_size_bytes: u64,
+    pub metadata_count: usize,
+}
+
+pub struct SearchEngine {
+    pub index: VectorIndex,
+    pub config: SearchConfig,
+    pub embedding_manager: EmbeddingsManager,
+    pub store: SqliteStore,
+}
+
+impl std::fmt::Debug for SearchEngine {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        f.debug_struct("SearchEngine")
+            .field("index", &self.index)
+            .field("config", &self.config)
+            .finish_non_exhaustive()
+    }
+}
+
+impl SearchEngine {
+    /// Create a copy of the search engine by recreating connections
+    pub fn duplicate(&self) -> Result<Self> {
+        let index_path = &self.config.index_path;
+        let embedding_manager = EmbeddingsManager::new(index_path)?;
+        let store = SqliteStore::new(&index_path.join("index.db"))?;
+
+        Ok(Self {
+            index: self.index.clone(),
+            config: self.config.clone(),
+            embedding_manager,
+            store,
+        })
+    }
+}
+
 impl SearchEngine {
     pub fn new(project_dir: &Path) -> Result<Self> {
-        let config = SearchConfig::default();
+        let mut config = SearchConfig::default();
         let index_path = project_dir.join(&config.index_path);
+        // Update config with absolute path for consistent usage
+        config.index_path = index_path.clone();
 
         let embedding_manager = EmbeddingsManager::new(&index_path)?;
+        let store = SqliteStore::new(&index_path.join("index.db"))?;
 
         Ok(Self {
             index: VectorIndex::new(config.dimension),
             config,
             embedding_manager,
+            store,
         })
     }
 
@@ -36,14 +179,12 @@ impl SearchEngine {
     pub fn search(&self, query: &str, max_results: Option<usize>) -> Result<Vec<SearchResult>> {
         let max_results = max_results.unwrap_or(self.config.max_results);
 
-        // Search patterns using SQLite store
-        let pattern_results = self.embedding_manager.store.search_patterns(query, max_results)?;
+        let pattern_results = self.store.search_patterns(query, max_results)?;
 
         let mut results = Vec::new();
 
         for (pattern, score) in pattern_results {
-            // Get full metadata for each pattern
-            if let Some((_, metadata)) = self.embedding_manager.store.get_embedding(&pattern)? {
+            if let Some((_, metadata)) = self.store.get_embedding(&pattern)? {
                 results.push(SearchResult {
                     id: pattern.clone(),
                     path: metadata.path.clone(),
@@ -56,7 +197,6 @@ impl SearchEngine {
             }
         }
 
-        // Sort and limit results
         results.sort_by(|a, b| b.score.partial_cmp(&a.score).unwrap());
         results.truncate(max_results);
 
@@ -94,10 +234,8 @@ impl SearchEngine {
         let index_file = self.config.index_path.join("index.bin");
         let metadata_file = self.config.index_path.join("metadata.json");
 
-        // Save vectors and IDs
         self.save_vectors(&index_file)?;
 
-        // Save metadata
         let metadata_json = serde_json::to_string_pretty(&self.index.metadata)?;
         std::fs::write(&metadata_file, metadata_json)?;
 
@@ -114,22 +252,18 @@ impl SearchEngine {
 
         let mut writer = BufWriter::new(file);
 
-        // Write magic number and version
-        writer.write_u32::<LittleEndian>(0x52554345)?; // "RUCE"
-        writer.write_u32::<LittleEndian>(1)?; // Version
+        writer.write_u32::<LittleEndian>(0x52554345)?;
+        writer.write_u32::<LittleEndian>(1)?;
 
-        // Write dimensions and count
         writer.write_u32::<LittleEndian>(self.config.dimension as u32)?;
         writer.write_u32::<LittleEndian>(self.index.vectors.nrows() as u32)?;
 
-        // Write vectors
         for vector in self.index.vectors.rows() {
             for &value in vector.iter() {
                 writer.write_f32::<LittleEndian>(value)?;
             }
         }
 
-        // Write IDs (length-prefixed strings)
         for id in &self.index.ids {
             writer.write_u32::<LittleEndian>(id.len() as u32)?;
             writer.write_all(id.as_bytes())?;
@@ -143,10 +277,8 @@ impl SearchEngine {
         let index_file = self.config.index_path.join("index.bin");
         let metadata_file = self.config.index_path.join("metadata.json");
 
-        // Load vectors and IDs
         self.load_vectors(&index_file)?;
 
-        // Load metadata
         let metadata_json = std::fs::read_to_string(&metadata_file)
             .context("Failed to read metadata file")?;
         self.index.metadata = serde_json::from_str(&metadata_json)
@@ -159,11 +291,9 @@ impl SearchEngine {
         let file = File::open(path)?;
 
         if self.config.use_mmap {
-            // Use memory mapping for large files
             let mmap = unsafe { MmapOptions::new().map(&file)? };
             self.load_vectors_from_slice(&mmap)?;
         } else {
-            // Read normally for smaller files
             let mut reader = BufReader::new(file);
             self.load_vectors_from_reader(&mut reader)?;
         }
@@ -179,19 +309,16 @@ impl SearchEngine {
     }
 
     fn load_vectors_from_reader<R: Read>(&mut self, reader: &mut R) -> Result<()> {
-        // Read and verify magic number
         let magic = reader.read_u32::<LittleEndian>()?;
         if magic != 0x52554345 {
             return Err(anyhow!("Invalid file format"));
         }
 
-        // Read version
         let version = reader.read_u32::<LittleEndian>()?;
         if version != 1 {
             return Err(anyhow!("Unsupported version: {}", version));
         }
 
-        // Read dimensions and count
         let dimension = reader.read_u32::<LittleEndian>()? as usize;
         let count = reader.read_u32::<LittleEndian>()? as usize;
 
@@ -203,7 +330,6 @@ impl SearchEngine {
             ));
         }
 
-        // Read vectors
         let mut vectors = Vec::with_capacity(count * dimension);
         for _ in 0..count * dimension {
             vectors.push(reader.read_f32::<LittleEndian>()?);
@@ -211,7 +337,6 @@ impl SearchEngine {
 
         let vectors_array = Array2::from_shape_vec((count, dimension), vectors)?;
 
-        // Read IDs
         let mut ids = Vec::with_capacity(count);
         for _ in 0..count {
             let len = reader.read_u32::<LittleEndian>()? as usize;
@@ -236,7 +361,7 @@ impl SearchEngine {
     }
 
     fn estimate_index_size(&self) -> u64 {
-        let vectors_size = self.index.vectors.nrows() * self.index.vectors.ncols() * 4; // f32 = 4 bytes
+        let vectors_size = self.index.vectors.nrows() * self.index.vectors.ncols() * 4;
         let ids_size: usize = self.index.ids.iter().map(|id| id.len()).sum();
         (vectors_size + ids_size) as u64
     }
@@ -244,7 +369,6 @@ impl SearchEngine {
     pub fn optimize_index(&mut self) -> Result<()> {
         info!("Optimizing index...");
 
-        // Normalize all vectors
         for mut vector in self.index.vectors.rows_mut() {
             let norm = vector.iter().map(|x| x * x).sum::<f32>().sqrt();
             if norm > 0.0 {
@@ -254,15 +378,13 @@ impl SearchEngine {
             }
         }
 
-        // Optional: Rebuild metadata index for faster lookups
-        self.rebuild_metadata_indexlettes()?;
+        self.rebuild_metadata_index()?;
 
         info!("Index optimized successfully");
         Ok(())
     }
 
     fn rebuild_metadata_index(&mut self) -> Result<()> {
-        // Create path-based index for faster filtering
         let mut path_index: HashMap<String, Vec<String>> = HashMap::new();
 
         for (id, metadata) in &self.index.metadata {
@@ -271,7 +393,6 @@ impl SearchEngine {
                 .push(id.clone());
         }
 
-        // Store path index as metadata
         let path_index_json = serde_json::to_string(&path_index)?;
         let path_index_file = self.config.index_path.join("path_index.json");
         std::fs::write(path_index_file, path_index_json)?;

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

@@ -122,7 +122,7 @@ impl SqliteStore {
             "SELECT pattern FROM embeddings WHERE pattern LIKE ? LIMIT ?"
         )?;
 
-        let mut rows = stmt.query([&format!("%{}%", query)])?;
+        let mut rows = stmt.query(params![format!("%{}%", query), limit as i64])?;
 
         let mut results = Vec::new();
         while let Some(row) = rows.next()? {

package/.claude/skills/cfn-loop-orchestration-v2/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-loop-orchestration-v2
-description: CFN Loop coordination and orchestration - gate checks, validation, consensus, coordination patterns
+description: "CFN Loop coordination and orchestration - gate checks, validation, consensus, coordination patterns. Use when orchestrating multi-agent workflows, managing iteration cycles, or coordinating Loop 2/Loop 3 dependencies."
 version: 1.0.0
 tags: [mega-skill, cfn-loop, orchestration, coordination]
 status: production

package/.claude/skills/cfn-loop-orchestration-v2/lib/decision/SKILL.md

@@ -1,3 +1,11 @@
+---
+name: cfn-product-owner-decision
+description: "Strategic decision-making for CFN Loop progression with robust parsing. Use when evaluating validator consensus and determining PROCEED/ITERATE/ABORT outcomes."
+version: 2.0.0
+tags: [cfn-loop, decision-making, product-owner, typescript, consensus]
+status: production
+---
+
 # Product Owner Decision Skill
 
 **Version:** 2.0.0 (TypeScript)

package/.claude/skills/cfn-loop-orchestration-v2/lib/orchestrator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-loop-orchestration
-description: CFN Loop workflow orchestration - three-loop structure management with gate checks and consensus
+description: "CFN Loop workflow orchestration - three-loop structure management with gate checks and consensus. Use when coordinating Loop 3 implementers and Loop 2 validators, managing iteration cycles, or enforcing quality gates."
 version: 3.1.0
 tags: [orchestration, cfn-loop, workflow, consensus]
 status: production

package/.claude/skills/cfn-loop-orchestration-v2/lib/output/SKILL.md

@@ -1,3 +1,11 @@
+---
+name: cfn-loop-output-processing
+description: "Type-safe output processing for Loop 2 validators and Loop 3 implementers. Use when parsing agent confidence scores, feedback, or calculating consensus from multiple validators."
+version: 1.0.0
+tags: [cfn-loop, output-processing, typescript, validation, consensus]
+status: production
+---
+
 # CFN Loop Output Processing - Unified TypeScript Module
 
 **Version:** 1.0.0

package/.claude/skills/cfn-loop-orchestration-v2/lib/validation/SKILL.md

@@ -1,9 +1,18 @@
+---
+name: cfn-loop-validation
+description: "Multi-layer validation and quality gates for CFN Loop workflows. Use when implementing gate checks, consensus validation, or enforcing clean agent exit patterns."
+version: 2.3.0
+tags: [cfn-loop, validation, quality-gates, consensus, typescript]
+status: production
+confidence: 0.98
+---
+
 # CFN Loop Validation Skill
 
 **Purpose:** Implement multi-layer validation and quality gates for CFN Loop workflows with clean agent exit patterns.
 
-**Version:** 2.3.0  
-**Confidence:** 0.98  
+**Version:** 2.3.0
+**Confidence:** 0.98
 **Status:** Production Ready (Robustness Enhanced)
 
 ---

package/.claude/skills/cfn-memory-persistence/lib/auto/SKILL.md

@@ -1,3 +1,10 @@
+---
+name: cfn-automatic-memory-persistence
+description: "Automatic, structured persistence of agent outputs to SQLite database. Use when tracking agent outputs across CFN Loop workflows, persisting confidence scores, or querying agent execution history."
+version: 1.0.0
+tags: [memory, persistence, sqlite, auto, agent-tracking]
+---
+
 # Automatic Memory Persistence Skill
 
 ## Overview

package/.claude/skills/cfn-memory-persistence/lib/management/SKILL.md

@@ -1,3 +1,10 @@
+---
+name: cfn-memory-management
+description: "Prevent and detect memory leaks in Claude CLI operations through proactive monitoring, limits, and profiling. Use when managing memory limits for long-running agents, detecting memory leaks, profiling heap usage, or implementing recovery procedures."
+version: 1.0.0
+tags: [memory, monitoring, profiling, leak-detection, performance]
+---
+
 # CFN Memory Management Skill
 
 **Purpose:** Prevent and detect memory leaks in Claude CLI operations through proactive monitoring, limits, and profiling.

package/.claude/skills/cfn-parameterized-queries/SKILL.md

@@ -1,3 +1,11 @@
+---
+name: cfn-parameterized-queries
+description: "Secure SQL query execution with parameterized queries to prevent SQL injection attacks. Use when executing database queries, inserting/updating records, or performing any SQL operations that require security hardening."
+version: 1.0.0
+tags: [security, sql, database, parameterized-queries, injection-prevention]
+status: production
+---
+
 #!/bin/bash
 
 # CFN Parameterized Queries - Secure SQL Query Execution

package/.claude/skills/cfn-planning/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-planning
-description: Epic decomposition, coordinator planning, and scope management
+description: "Epic decomposition, coordinator planning, and scope management. Use when breaking down epics into sprints and tasks, coordinating multi-coordinator workflows, or simplifying and managing project scope boundaries."
 version: 1.0.0
 tags: [mega-skill, epic, planning, scope, decomposition]
 status: production

package/.claude/skills/cfn-skill-management/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-skill-management
-description: Skill loading, propagation, and building for CFN
+description: "Skill loading, propagation, and building for CFN. Use when dynamically discovering and loading skills, deploying skills across environments, or creating new skill scaffolding."
 version: 1.0.0
 tags: [mega-skill, skills, loader, builder, deployment]
 status: production

package/.claude/skills/cfn-transparency-middleware/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-transparency-middleware
-description: Agent interaction capture, logging, and analysis with memory tracking and security (Rust implementation)
+description: "Agent interaction capture, logging, and analysis with memory tracking and security (Rust implementation). Use when you need to capture and analyze agent interactions, track tool usage and performance metrics, query execution history, or export audit trails for compliance."
 version: 1.0.0
 tags: [middleware, logging, security, transparency, memory, rust]
 status: production

package/.claude/skills/cfn-utilities/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-utilities
-description: Reusable bash utility functions for CFN Loop - logging, error handling, retry, file operations
+description: "Reusable bash utility functions for CFN Loop - logging, error handling, retry, file operations. Use when you need structured logging, atomic file operations, retry logic with exponential backoff, or standardized error handling in bash scripts."
 version: 1.0.0
 tags: [bash, logging, error-handling, retry, file-operations, utilities]
 status: production

package/.claude/skills/cfn-vision-analysis/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cfn-vision-analysis
-description: Image and vision analysis capabilities for screenshot and mockup validation
+description: "Image and vision analysis capabilities for screenshot and mockup validation. Use when validating screenshots against mockups, checking UI consistency, detecting visual regressions, or verifying brand guideline compliance."
 version: 1.0.0
 tags: [vision, image, analysis, screenshots]
 status: production

package/index/metadata.json

@@ -0,0 +1 @@
+{}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.18.12",
+  "version": "2.18.13",
   "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/.claude/skills/cfn-compilation-error-fixer/HANDOFF.md

@@ -1,29 +0,0 @@
-┌─────────────────┐
-│  cargo check    │ → Parse Rust errors
-└────────┬────────┘
-         ▼
-┌─────────────────┐
-│ Cerebras LLM    │ → Generate fix
-└────────┬────────┘
-         ▼
-┌─────────────────────────────────────────┐
-│          LAYER 1: Structural Gates      │
-│  A: Line Count Delta     G: Import Path │
-│  B: Function Signature  H: Pattern Dup │
-│  C: Import Duplicates   I: Impl Loc    │
-│  D: Brace Balance       J: Type Cast   │
-│  E: Semantic Diff       K: Match Arm   │
-│  F: Orphaned Code       L: Regression  │
-└────────┬────────────────────────────────┘
-         ▼
-┌─────────────────┐
-│  LAYER 2: Clippy│
-└────────┬────────┘
-         ▼
-┌─────────────────┐
-│ LAYER 3: Review │
-└────────┬────────┘
-         ▼
-┌─────────────────┐
-│  Write to file  │
-└─────────────────┘