claude-flow-novice 1.5.14 → 1.5.16

package/.claude-flow-novice/dist/src/agents/agent-loader.js

@@ -2,7 +2,7 @@
  * Dynamic Agent Loader - Reads agent definitions from .claude/agents/ directory
  * This is the single source of truth for all agent types in the system
  */ import { readFileSync, existsSync } from 'node:fs';
-import glob from 'glob';
+import { glob } from 'glob';
 import { resolve, dirname } from 'node:path';
 import { parse as parseYaml } from 'yaml';
 // Legacy agent type mapping for backward compatibility
@@ -45,24 +45,44 @@ export class AgentLoader {
    */ parseAgentFile(filePath) {
         try {
             const content = readFileSync(filePath, 'utf-8');
-            // Split frontmatter and content
-            const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+            // Split frontmatter and content (handle both \n and \r\n line endings)
+            const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
             if (!frontmatterMatch) {
                 console.warn(`No frontmatter found in ${filePath}`);
                 return null;
             }
             const [, yamlContent, markdownContent] = frontmatterMatch;
             const frontmatter = parseYaml(yamlContent);
-            if (!frontmatter.name || !frontmatter.metadata?.description) {
-                console.warn(`Missing required fields (name, metadata.description) in ${filePath}`);
+            // Support both formats: direct fields and metadata-wrapped fields
+            const description = frontmatter.description || frontmatter.metadata?.description;
+            const capabilities = frontmatter.capabilities || frontmatter.metadata?.capabilities || [];
+            // Parse tools - can be in multiple locations and formats
+            let tools = [];
+            // Check direct tools field first
+            if (frontmatter.tools) {
+                if (Array.isArray(frontmatter.tools)) {
+                    tools = frontmatter.tools;
+                } else if (typeof frontmatter.tools === 'string') {
+                    // Split by comma or space, trim, and filter empty
+                    tools = frontmatter.tools.split(/[,\s]+/).map((t)=>t.trim()).filter((t)=>t.length > 0);
+                }
+            } else if (frontmatter.capabilities?.tools) {
+                if (Array.isArray(frontmatter.capabilities.tools)) {
+                    tools = frontmatter.capabilities.tools;
+                }
+            }
+            if (!frontmatter.name || !description) {
+                console.warn(`Missing required fields (name, description) in ${filePath}`);
                 return null;
             }
             return {
                 name: frontmatter.name,
                 type: frontmatter.type,
                 color: frontmatter.color,
-                description: frontmatter.metadata.description,
-                capabilities: frontmatter.metadata.capabilities || frontmatter.capabilities || [],
+                model: frontmatter.model,
+                description,
+                tools,
+                capabilities,
                 priority: frontmatter.priority || 'medium',
                 hooks: frontmatter.hooks,
                 content: markdownContent.trim()

package/.claude-flow-novice/dist/src/agents/agent-loader.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/agents/agent-loader.ts"],"names":["readFileSync","existsSync","glob","resolve","dirname","parse","parseYaml","LEGACY_AGENT_MAPPING","analyst","coordinator","optimizer","documenter","monitor","specialist","architect","resolveLegacyAgentType","legacyType","AgentLoader","agentCache","Map","categoriesCache","lastLoadTime","cacheExpiry","getAgentsDirectory","currentDir","process","cwd","claudeAgentsPath","parseAgentFile","filePath","content","frontmatterMatch","match","console","warn","yamlContent","markdownContent","frontmatter","name","metadata","description","type","color","capabilities","priority","hooks","trim","error","loadAgents","agentsDir","agentFiles","ignore","absolute","clear","categoryMap","agent","set","relativePath","replace","pathParts","split","category","has","get","push","Array","from","entries","map","agents","sort","a","b","localeCompare","Date","now","needsRefresh","ensureLoaded","size","getAvailableAgentTypes","currentTypes","keys","legacyTypes","Object","combined","uniqueTypes","Set","getAgent","getAllAgents","values","getAgentCategories","searchAgents","query","lowerQuery","toLowerCase","filter","includes","some","cap","isValidAgentType","getAgentsByCategory","categories","found","find","cat","refresh","agentLoader","refreshAgents"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/agents/agent-loader.ts"],"names":["readFileSync","existsSync","glob","resolve","dirname","parse","parseYaml","LEGACY_AGENT_MAPPING","analyst","coordinator","optimizer","documenter","monitor","specialist","architect","resolveLegacyAgentType","legacyType","AgentLoader","agentCache","Map","categoriesCache","lastLoadTime","cacheExpiry","getAgentsDirectory","currentDir","process","cwd","claudeAgentsPath","parseAgentFile","filePath","content","frontmatterMatch","match","console","warn","yamlContent","markdownContent","frontmatter","description","metadata","capabilities","tools","Array","isArray","split","map","t","trim","filter","length","name","type","color","model","priority","hooks","error","loadAgents","agentsDir","agentFiles","ignore","absolute","clear","categoryMap","agent","set","relativePath","replace","pathParts","category","has","get","push","from","entries","agents","sort","a","b","localeCompare","Date","now","needsRefresh","ensureLoaded","size","getAvailableAgentTypes","currentTypes","keys","legacyTypes","Object","combined","uniqueTypes","Set","getAgent","getAllAgents","values","getAgentCategories","searchAgents","query","lowerQuery","toLowerCase","includes","some","cap","isValidAgentType","getAgentsByCategory","categories","found","find","cat","refresh","agentLoader","refreshAgents"],"mappings":"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"}

package/.claude-flow-novice/dist/src/cli/simple-commands/init/templates/CLAUDE.md

@@ -15,6 +15,8 @@
 6. **NEVER SAVE TO ROOT** - Organize files in appropriate subdirectories
 7. **USE CLAUDE CODE'S TASK TOOL** - For spawning agents concurrently, not just MCP
 8. **USE THE CFN LOOP** - For a self correcting dev loop that saves time and resources
+9. **DO NOT CREATE GUIDES, SUMMARIES, OR REPORT FILES** - unless specifically asked. 
+10. **USE SPARTAN LANGUAGE** - no fluff encouraged
 
 ### 🚫 WHEN YOU MUST USE AGENTS (MANDATORY)
 
@@ -58,6 +60,7 @@
 - ❌ Writing code without a tester agent
 - ❌ Making architectural decisions without an architect agent
 - ❌ Deploying without security review from security-specialist agent
+- ❌ Creating reports documents, summary documents, or guides unless explicity asked
 
 ## 🎯 Claude Code vs MCP Tools
 
@@ -95,88 +98,29 @@ npx claude-flow-novice hooks pre-command --command "[command]" --validate-safety
 npx claude-flow-novice hooks pre-edit --file "[file]" --auto-assign-agents true --load-context true
 ```
 
-#### Post-Task Hooks (Validation & Quality)
+#### Post-Edit Hook (MANDATORY After Every File Edit)
 ```bash
-# Track metrics and store results
-npx claude-flow-novice hooks post-command --command "[command]" --track-metrics true --store-results true
+# Unified pipeline: standard validation + TDD + Rust quality
+node config/hooks/post-edit-pipeline.js "[FILE]" --memory-key "swarm/[agent]/[step]"
 
-# Enhanced post-edit pipeline with comprehensive TDD validation
-npx enhanced-hooks post-edit "[file]" --memory-key "swarm/[agent]/[step]" --minimum-coverage 80 --structured
+# Enable TDD mode (single-file testing, coverage, phase detection)
+node config/hooks/post-edit-pipeline.js "[FILE]" --tdd-mode --minimum-coverage 80
 
-# Manual hook execution (guaranteed working)
-node src/hooks/enhanced-hooks-cli.js post-edit "[file]" --memory-key "[key]" --structured
+# Enable Rust strict mode (unwrap/expect/panic detection)
+node config/hooks/post-edit-pipeline.js "[FILE]" --rust-strict
 
-# Validates: formatting, linting, type checking, dependencies, security, tests, TDD compliance
-# Progressive validation: graceful degradation when dependencies missing (beginner-friendly)
+# Full mode: TDD + Rust + coverage threshold
+node config/hooks/post-edit-pipeline.js "[FILE]" --tdd-mode --rust-strict --minimum-coverage 90
 ```
 
-## 🎯 **Enhanced Post-Edit Hook System**
-
-### **🚨 MANDATORY: Manual Hook Execution After Every File Edit**
-
-**CRITICAL RULE**: After **EVERY** file edit operation, you **MUST** run the enhanced post-edit hook:
-
-```bash
-# After editing any file, IMMEDIATELY run:
-npx enhanced-hooks post-edit "[FILE_PATH]" --memory-key "swarm/[AGENT]/[STEP]" --minimum-coverage 80 --structured
-
-# Or via slash command:
-/hooks post-edit [FILE_PATH] --memory-key "[CONTEXT]" --structured
-```
-
-**⚠️ NO EXCEPTIONS**: This applies to:
-- All JavaScript/TypeScript files
-- All Rust files
-- All Python files
-- All configuration files
-- ALL file modifications
-
-### **Enhanced Post-Edit Pipeline Features:**
-- **🧪 TDD Testing**: Single-file testing without full system compilation
-- **📊 Real-time Coverage**: Coverage analysis with configurable thresholds (default: 80%)
-- **🌐 Multi-Language Support**:
-  - **JavaScript/TypeScript**: Jest, Mocha, Prettier, ESLint integration
-  - **Rust**: cargo check, cargo test, cargo-tarpaulin, rustfmt
-  - **Python**: pytest, unittest, black, pylint
-  - **Go**: go test, go fmt, go vet
-  - **Java**: JUnit, TestNG, google-java-format
-  - **C/C++**: GTest, Catch2, clang-format
-- **🎨 Formatting**: Prettier, Black, RustFmt, GoFmt with diff preview
-- **🔒 Security Analysis**: XSS, eval(), hardcoded credentials, SQL injection detection
-- **✅ TDD Compliance**: Red-Green-Refactor phase detection and enforcement
-- **🔍 Framework Detection**: Automatic test framework identification
-- **🤖 Agent Feedback**: Structured JSON with actionable recommendations
-- **💾 Memory Coordination**: Cross-agent state sharing and enhanced persistence
-- **🚫 Blocking Mechanisms**: Quality gates for critical validation failures
-
-### **Usage Examples:**
-```bash
-# For JavaScript/TypeScript files
-npx enhanced-hooks post-edit "src/components/Button.tsx" --memory-key "frontend/button" --structured
-
-# For Rust files (full cargo integration)
-npx enhanced-hooks post-edit "src/lib.rs" --memory-key "backend/rust" --minimum-coverage 90 --structured
-
-# Via slash commands in Claude Code
-/hooks post-edit your-file.js --memory-key "agent-memory-key" --structured
-```
-
-### **Response Structure:**
-```json
-{
-  "success": true,
-  "file": "src/component.js",
-  "validation": { "passed": true, "issues": [], "coverage": "advanced" },
-  "formatting": { "needed": true, "changes": 12, "formatter": "prettier" },
-  "testing": { "executed": true, "framework": "jest", "results": {...} },
-  "tddCompliance": { "hasTests": true, "coverage": 85, "recommendations": [...] },
-  "recommendations": [
-    { "type": "security", "priority": "high", "message": "...", "action": "..." },
-    { "type": "formatting", "priority": "medium", "action": "prettier file.js" }
-  ],
-  "memory": { "stored": true, "enhancedStore": true }
-}
-```
+**Features (all languages):**
+- Formatting, linting, type checking, security, dependencies
+- Single-file testing (1-5s vs 10-60s full suite)
+- Real-time coverage (Jest, pytest, cargo-tarpaulin)
+- TDD compliance (Red-Green-Refactor detection)
+- Rust quality (unwrap/expect/panic with line numbers)
+- Comment-aware validation, structured JSON output
+- Logs to `post-edit-pipeline.log` (500 entries max)
 
 #### Session Management
 ```bash
@@ -261,7 +205,7 @@ npx claude-flow-novice hooks session-end --generate-summary true --persist-state
 **After completion:**
 - ✅ Consensus validation achieved (≥90% agreement)
 - ✅ Results stored in memory
-- ✅ Next steps provided with claude code continuing to the next documented phase or next steps provided to user if no todos left
+- ✅ Next steps determined
 
 ### Agent Selection Guide
 
@@ -352,7 +296,7 @@ claude mcp add claude-flow-novice npx claude-flow-novice mcp start
 ### Step 3: Self-Assessment Gate
 - **If confidence scores ≥75%** → Proceed to Step 4 (Consensus Verification)
 - **If confidence scores <75%** → Relaunch agents for Step 2 with feedback
-- **Maximum iterations**: 3 attempts before escalation
+- **Maximum iterations**: 3 attempts before escalation using next steps guidance
 
 ### Step 4: Verify - Consensus Swarm (2-4 validators REQUIRED)
 ```javascript
@@ -373,13 +317,13 @@ claude mcp add claude-flow-novice npx claude-flow-novice mcp start
 ### Step 6: Action Based on Decision
 - **PASS** →
   1. Store results in SwarmMemory
-  2. Update documentation
+  2. Update documentation if asked to do so
   3. Update todos and move to next task
 
 - **FAIL** →
   1. Round counter++
   2. If Round < 10: Inject validator feedback → Return to Step 2
-  3. If Round ≥ 10: Escalate to human with comprehensive report
+  3. If Round ≥ 10: Escalate to human with next steps guidance
 
 ### 🚨 ENFORCEMENT CHECKPOINTS
 
@@ -393,9 +337,7 @@ claude mcp add claude-flow-novice npx claude-flow-novice mcp start
 
 ---
 
-## 🎯 MANDATORY: NEXT STEPS GUIDANCE
-
-**After completing ANY task, you MUST provide:**
+## NEXT STEPS GUIDANCE
 
 1. **✅ What was completed**: Brief summary of delivered work
 2. **📊 Validation results**: Confidence scores, test coverage, consensus approval

package/.claude-flow-novice/dist/src/hooks/enhanced-hooks-cli.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+
+/**
+ * Enhanced Hooks CLI for Claude Flow Novice
+ *
+ * Wrapper for the unified post-edit-pipeline.js
+ * Provides backward compatibility with enhanced-hooks command
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Enhanced hooks CLI interface
+export async function enhancedHooksCLI() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  if (!command || command === '--help' || command === '-h') {
+    console.log(`
+🚀 Enhanced Hooks CLI for Claude Flow Novice - v2.0.0
+
+Available commands:
+  post-edit <file> [options]         Enhanced post-edit with TDD testing
+  enhanced-post-edit <file> [options] Alias for post-edit
+
+Options:
+  --memory-key <key>                 Store results with specific memory key
+  --format                           Analyze formatting (default: true)
+  --validate                         Run validation (default: true)
+  --enable-tdd                       Enable TDD testing (default: true)
+  --minimum-coverage <percent>       Minimum coverage threshold (default: 80)
+  --block-on-critical               Block execution on critical errors
+  --structured                       Return structured JSON data
+  --generate-recommendations        Generate actionable recommendations (default: true)
+
+Examples:
+  npx claude-flow-novice enhanced-hooks post-edit src/app.js --memory-key "swarm/coder/step-1"
+  npx claude-flow-novice enhanced-hooks post-edit test.js --minimum-coverage 90 --structured
+
+Enhanced Features:
+  ✅ TDD testing with single-file execution
+  ✅ Real-time coverage analysis and diff reporting
+  ✅ Advanced multi-language validation with error locations
+  ✅ Formatting diff preview and change detection
+  ✅ Actionable recommendations by category
+  ✅ Blocking mechanisms for critical failures
+  ✅ Enhanced memory store with versioning
+    `);
+    return;
+  }
+
+  if (command === 'post-edit' || command === 'enhanced-post-edit') {
+    const file = args[1];
+    if (!file) {
+      console.log('❌ File path required for post-edit hook');
+      return;
+    }
+
+    // Build unified pipeline command with TDD mode enabled by default
+    // Use process.cwd() to find config/hooks in the actual project, not dist
+    const pipelinePath = join(process.cwd(), 'config/hooks/post-edit-pipeline.js');
+    const pipelineArgs = [file, '--tdd-mode'];
+
+    // Pass through all relevant flags
+    if (args.includes('--memory-key')) {
+      const idx = args.indexOf('--memory-key');
+      pipelineArgs.push('--memory-key', args[idx + 1]);
+    }
+    if (args.includes('--minimum-coverage')) {
+      const idx = args.indexOf('--minimum-coverage');
+      pipelineArgs.push('--minimum-coverage', args[idx + 1]);
+    }
+    if (args.includes('--block-on-critical')) {
+      pipelineArgs.push('--block-on-tdd-violations');
+    }
+    if (args.includes('--structured')) {
+      // Structured output is default in unified pipeline
+    }
+
+    // Execute unified pipeline
+    const proc = spawn('node', [pipelinePath, ...pipelineArgs], {
+      stdio: 'inherit',
+      cwd: process.cwd()
+    });
+
+    proc.on('close', (code) => {
+      process.exit(code || 0);
+    });
+
+    proc.on('error', (error) => {
+      console.error(`❌ Failed to execute unified pipeline: ${error.message}`);
+      process.exit(1);
+    });
+
+  } else {
+    console.log(`❌ Unknown command: ${command}`);
+    console.log('Use --help for available commands');
+    process.exit(1);
+  }
+}
+
+// Enhanced hooks function for programmatic use (delegates to unified pipeline)
+export async function enhancedPostEdit(file, memoryKey = null, options = {}) {
+  return new Promise((resolve, reject) => {
+    const pipelinePath = join(process.cwd(), 'config/hooks/post-edit-pipeline.js');
+    const args = [file, '--tdd-mode'];
+
+    if (memoryKey) args.push('--memory-key', memoryKey);
+    if (options.minimumCoverage) args.push('--minimum-coverage', options.minimumCoverage.toString());
+    if (options.blockOnCritical) args.push('--block-on-tdd-violations');
+
+    const proc = spawn('node', [pipelinePath, ...args], {
+      stdio: 'pipe',
+      cwd: process.cwd()
+    });
+
+    let stdout = '';
+    let stderr = '';
+
+    proc.stdout.on('data', (data) => stdout += data.toString());
+    proc.stderr.on('data', (data) => stderr += data.toString());
+
+    proc.on('close', (code) => {
+      resolve({
+        success: code === 0,
+        file,
+        memoryKey,
+        timestamp: new Date().toISOString(),
+        output: stdout,
+        error: stderr,
+        exitCode: code
+      });
+    });
+
+    proc.on('error', (error) => {
+      reject(error);
+    });
+  });
+}
+
+// Backward compatibility function (delegates to unified pipeline)
+export async function legacyPostEditHook(file, memoryKey = null, options = {}) {
+  const result = await enhancedPostEdit(file, memoryKey, options);
+
+  return {
+    success: result.success,
+    file: result.file,
+    timestamp: result.timestamp,
+    formatted: true,
+    validated: result.success,
+    recommendations: 0,
+    enhanced: true,
+    legacy: true,
+    unified: true
+  };
+}
+
+// Run CLI if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  enhancedHooksCLI().catch(error => {
+    console.error(`💥 Fatal error: ${error.message}`);
+    process.exit(1);
+  });
+}

package/.claude-flow-novice/dist/src/preferences/example.js

@@ -0,0 +1,203 @@
+/**
+ * User Preference Manager - Usage Examples
+ *
+ * This file demonstrates how to use the UserPreferenceManager
+ * in different scenarios.
+ */ import { UserPreferenceManager, getDefaultPreferenceManager, createPreferenceManager, PreferenceError } from "./user-preference-manager";
+/**
+ * Example 1: Basic Usage
+ */ async function basicUsageExample() {
+    console.log("=== Example 1: Basic Usage ===\n");
+    const prefs = new UserPreferenceManager();
+    // Initialize the preference manager
+    await prefs.initialize();
+    console.log("✓ Preference manager initialized");
+    // Set preferences
+    await prefs.setPreference("theme", "dark");
+    console.log("✓ Set theme to 'dark'");
+    await prefs.setPreference("language", "es");
+    console.log("✓ Set language to 'es'");
+    // Get preferences
+    const theme = prefs.getPreference("theme");
+    console.log(`✓ Retrieved theme: ${theme}`);
+    // Get with default value
+    const fontSize = prefs.getPreference("fontSize", 14);
+    console.log(`✓ Retrieved fontSize with default: ${fontSize}`);
+    console.log("\n");
+}
+/**
+ * Example 2: Using the Singleton Pattern
+ */ async function singletonExample() {
+    console.log("=== Example 2: Singleton Pattern ===\n");
+    const prefs1 = getDefaultPreferenceManager();
+    await prefs1.initialize();
+    await prefs1.setPreference("theme", "dark");
+    // Get the same instance elsewhere
+    const prefs2 = getDefaultPreferenceManager();
+    const theme = prefs2.getPreference("theme");
+    console.log(`✓ Retrieved theme from singleton: ${theme}`);
+    console.log("✓ Both instances share the same data");
+    console.log("\n");
+}
+/**
+ * Example 3: Event Handling
+ */ async function eventHandlingExample() {
+    console.log("=== Example 3: Event Handling ===\n");
+    const prefs = new UserPreferenceManager();
+    // Set up event listeners
+    prefs.on("initialized", (data)=>{
+        console.log(`✓ Event: initialized at ${data.timestamp}`);
+    });
+    prefs.on("preferenceChanged", (data)=>{
+        console.log(`✓ Event: ${data.key} changed from ${data.oldValue} to ${data.newValue}`);
+    });
+    prefs.on("preferencesSaved", (data)=>{
+        console.log(`✓ Event: Saved ${data.count} preferences to ${data.path}`);
+    });
+    await prefs.initialize();
+    await prefs.setPreference("theme", "dark");
+    await prefs.setPreference("theme", "light"); // Will trigger change event
+    console.log("\n");
+}
+/**
+ * Example 4: Error Handling
+ */ async function errorHandlingExample() {
+    console.log("=== Example 4: Error Handling ===\n");
+    const prefs = new UserPreferenceManager();
+    try {
+        // This will throw - not initialized
+        prefs.getPreference("theme");
+    } catch (error) {
+        if (error instanceof PreferenceError) {
+            console.log(`✓ Caught expected error: ${error.message}`);
+        }
+    }
+    await prefs.initialize();
+    try {
+        // This will throw - invalid key
+        await prefs.setPreference("", "value");
+    } catch (error) {
+        if (error instanceof PreferenceError) {
+            console.log(`✓ Caught expected error: ${error.message}`);
+        }
+    }
+    try {
+        // This will throw - undefined value
+        await prefs.setPreference("test", undefined);
+    } catch (error) {
+        if (error instanceof PreferenceError) {
+            console.log(`✓ Caught expected error: ${error.message}`);
+        }
+    }
+    console.log("\n");
+}
+/**
+ * Example 5: Custom Storage Path
+ */ async function customStorageExample() {
+    console.log("=== Example 5: Custom Storage Path ===\n");
+    const prefs = createPreferenceManager({
+        storagePath: "/tmp/custom-preferences.json",
+        autoSave: true,
+        cacheEnabled: true
+    });
+    await prefs.initialize();
+    console.log(`✓ Custom storage path: ${prefs.getStoragePath()}`);
+    await prefs.setPreference("customSetting", "value");
+    console.log("✓ Set custom preference (auto-saved)");
+    console.log("\n");
+}
+/**
+ * Example 6: Bulk Operations
+ */ async function bulkOperationsExample() {
+    console.log("=== Example 6: Bulk Operations ===\n");
+    const prefs = new UserPreferenceManager();
+    await prefs.initialize();
+    // Set multiple preferences
+    await prefs.setPreference("theme", "dark");
+    await prefs.setPreference("language", "en");
+    await prefs.setPreference("notifications", false);
+    // Get all preferences
+    const allPrefs = prefs.getAllPreferences();
+    console.log("✓ All preferences:", allPrefs);
+    // Check preference count
+    console.log(`✓ Total preferences: ${prefs.getPreferenceCount()}`);
+    // Check if preference exists
+    console.log(`✓ Has 'theme': ${prefs.hasPreference("theme")}`);
+    console.log(`✓ Has 'unknown': ${prefs.hasPreference("unknown")}`);
+    console.log("\n");
+}
+/**
+ * Example 7: Reset and Defaults
+ */ async function resetExample() {
+    console.log("=== Example 7: Reset and Defaults ===\n");
+    const prefs = new UserPreferenceManager();
+    await prefs.initialize();
+    // Modify some preferences
+    await prefs.setPreference("theme", "dark");
+    await prefs.setPreference("language", "es");
+    console.log("✓ Modified preferences");
+    console.log(`  - Theme: ${prefs.getPreference("theme")}`);
+    console.log(`  - Language: ${prefs.getPreference("language")}`);
+    // Reset to defaults
+    await prefs.reset();
+    console.log("✓ Reset to defaults");
+    console.log(`  - Theme: ${prefs.getPreference("theme")}`);
+    console.log(`  - Language: ${prefs.getPreference("language")}`);
+    console.log("\n");
+}
+/**
+ * Example 8: Manual Save/Load
+ */ async function manualSaveLoadExample() {
+    console.log("=== Example 8: Manual Save/Load ===\n");
+    // Create with auto-save disabled
+    const prefs = createPreferenceManager({
+        autoSave: false
+    });
+    await prefs.initialize();
+    // Set preferences (not auto-saved)
+    await prefs.setPreference("theme", "dark");
+    await prefs.setPreference("language", "es");
+    console.log("✓ Set preferences (not auto-saved)");
+    // Manually save
+    await prefs.save();
+    console.log("✓ Manually saved preferences");
+    // Create new instance and load
+    const prefs2 = createPreferenceManager({
+        storagePath: prefs.getStoragePath()
+    });
+    await prefs2.load();
+    console.log("✓ Loaded preferences into new instance");
+    console.log(`  - Theme: ${prefs2.getPreference("theme")}`);
+    console.log(`  - Language: ${prefs2.getPreference("language")}`);
+    console.log("\n");
+}
+/**
+ * Run all examples
+ */ async function runAllExamples() {
+    console.log("\n╔═══════════════════════════════════════════════╗");
+    console.log("║   User Preference Manager - Usage Examples   ║");
+    console.log("╚═══════════════════════════════════════════════╝\n");
+    try {
+        await basicUsageExample();
+        await singletonExample();
+        await eventHandlingExample();
+        await errorHandlingExample();
+        await customStorageExample();
+        await bulkOperationsExample();
+        await resetExample();
+        await manualSaveLoadExample();
+        console.log("╔═══════════════════════════════════════════════╗");
+        console.log("║          All examples completed! ✓            ║");
+        console.log("╚═══════════════════════════════════════════════╝\n");
+    } catch (error) {
+        console.error("Error running examples:", error);
+    }
+}
+// Run examples if this file is executed directly
+if (require.main === module) {
+    runAllExamples();
+}
+// Export for use in other modules
+export { basicUsageExample, singletonExample, eventHandlingExample, errorHandlingExample, customStorageExample, bulkOperationsExample, resetExample, manualSaveLoadExample };
+
+//# sourceMappingURL=example.js.map

package/.claude-flow-novice/dist/src/preferences/example.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/preferences/example.ts"],"names":["UserPreferenceManager","getDefaultPreferenceManager","createPreferenceManager","PreferenceError","basicUsageExample","console","log","prefs","initialize","setPreference","theme","getPreference","fontSize","singletonExample","prefs1","prefs2","eventHandlingExample","on","data","timestamp","key","oldValue","newValue","count","path","errorHandlingExample","error","message","undefined","customStorageExample","storagePath","autoSave","cacheEnabled","getStoragePath","bulkOperationsExample","allPrefs","getAllPreferences","getPreferenceCount","hasPreference","resetExample","reset","manualSaveLoadExample","save","load","runAllExamples","require","main","module"],"mappings":"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"}