@voodocs/cli 2.1.3 → 2.2.1

package/lib/darkarts/context/ai_integrations.py

@@ -6,7 +6,7 @@
 🔒{read-only:detect,write:explicit-user-command}
 ⚡{O(n²):detect-with-analysis,O(k):generate|k=ai-count}
 
-AI-specific integration templates for VooDocs Context System.
+AI-specific integration templates for Voodocs Context System.
 
 This module provides native integration with different AI assistants:
 - Claude Code (skills)
@@ -23,7 +23,7 @@ from pathlib import Path
 
 def generate_claude_skill(project_name: str, project_purpose: str) -> Dict[str, str]:
     """
-    Generate Claude Code skill for VooDocs context system.
+    Generate Claude Code skill for Voodocs context system.
     
     Args:
         project_name: Name of the project
@@ -34,15 +34,15 @@ def generate_claude_skill(project_name: str, project_purpose: str) -> Dict[str,
     """
     skill_md = f"""---
 name: voodocs-context
-description: Access and query the VooDocs context system for project understanding, invariants, and architecture
+description: Access and query the Voodocs context system for project understanding, invariants, and architecture
 ---
 
-# VooDocs Context System Skill
+# Voodocs Context System Skill
 
 ## Project: {project_name}
 {project_purpose}
 
-This skill provides access to the VooDocs context system for understanding project architecture, invariants, and assumptions.
+This skill provides access to the Voodocs context system for understanding project architecture, invariants, and assumptions.
 
 ## Available Commands
 
@@ -152,7 +152,7 @@ voodocs context check
 
 def generate_cursor_rules(project_name: str, project_purpose: str) -> Dict[str, str]:
     """
-    Generate Cursor rules for VooDocs context system.
+    Generate Cursor rules for Voodocs context system.
     
     Args:
         project_name: Name of the project
@@ -162,12 +162,12 @@ def generate_cursor_rules(project_name: str, project_purpose: str) -> Dict[str,
         Dictionary mapping file paths to content
     """
     
-    main_rule = f"""# VooDocs Context System
+    main_rule = f"""# Voodocs Context System
 
 ## Project: {project_name}
 {project_purpose}
 
-This project uses the VooDocs Context System (v0.2.0+) for documentation and validation.
+This project uses the Voodocs Context System (v0.2.0+) for documentation and validation.
 
 ## Context File
 - **Location**: `.voodocs.context`
@@ -283,7 +283,7 @@ voodocs context query "module-name" --section architecture
 
 def generate_copilot_instructions(project_name: str, project_purpose: str) -> Dict[str, str]:
     """
-    Generate GitHub Copilot instructions for VooDocs context system.
+    Generate GitHub Copilot instructions for Voodocs context system.
     
     Args:
         project_name: Name of the project
@@ -298,9 +298,9 @@ def generate_copilot_instructions(project_name: str, project_purpose: str) -> Di
 ## Project Overview
 {project_purpose}
 
-## VooDocs Context System
+## Voodocs Context System
 
-This project uses VooDocs Context System (v0.2.0+) for documentation and validation.
+This project uses Voodocs Context System (v0.2.0+) for documentation and validation.
 
 ### Context File
 - **Location**: `.voodocs.context` (YAML format)
@@ -400,7 +400,7 @@ voodocs context diagram --type modules
 
 def generate_windsurf_rules(project_name: str, project_purpose: str) -> Dict[str, str]:
     """
-    Generate Windsurf rules for VooDocs context system.
+    Generate Windsurf rules for Voodocs context system.
     
     Args:
         project_name: Name of the project
@@ -415,9 +415,9 @@ def generate_windsurf_rules(project_name: str, project_purpose: str) -> Dict[str
 ## Project
 {project_purpose}
 
-## VooDocs Context System
+## Voodocs Context System
 
-This project uses VooDocs (v0.2.0+) for context management.
+This project uses Voodocs (v0.2.0+) for context management.
 
 ### Context Commands
 
@@ -478,7 +478,7 @@ invariants: ["rules"]
 
 def generate_cline_rules(project_name: str, project_purpose: str) -> Dict[str, str]:
     """
-    Generate Cline rules for VooDocs context system.
+    Generate Cline rules for Voodocs context system.
     
     Args:
         project_name: Name of the project
@@ -493,7 +493,7 @@ def generate_cline_rules(project_name: str, project_purpose: str) -> Dict[str, s
 ## Project
 {project_purpose}
 
-## VooDocs Context System
+## Voodocs Context System
 
 Context file: `.voodocs.context` (YAML)
 

package/lib/darkarts/context/commands.py

@@ -210,7 +210,7 @@ def cmd_context_init(force: bool = False) -> int:
         Exit code (0 for success, 1 for error)
     """
     try:
-        print_header("VooDocs Context Initialization")
+        print_header("Voodocs Context Initialization")
         
         # Check if context file already exists
         context_path = get_context_file_path()
@@ -224,7 +224,7 @@ def cmd_context_init(force: bool = False) -> int:
             if not confirm(f"Overwrite existing context file at {context_path}?", default=False):
                 raise UserInterruptError("Initialization")
         
-        step("Initializing VooDocs context...")
+        step("Initializing Voodocs context...")
         print()
         
         # Detect project information
@@ -375,7 +375,7 @@ def cmd_context_init(force: bool = False) -> int:
                     
                     print()
                     print("🤖 AI integration complete!")
-                    print(f"   Your {ai_type} assistant will now understand the VooDocs context system.")
+                    print(f"   Your {ai_type} assistant will now understand the Voodocs context system.")
                     
                 except Exception as e:
                     print(f"⚠️  Warning: Failed to generate AI integration: {e}")
@@ -1368,7 +1368,7 @@ def cmd_context_generate(source_dir: Optional[str] = None, update_existing: bool
         return 1
     except ImportError as e:
         error(f"Failed to import annotation parser: {e}")
-        warning("Make sure VooDocs is properly installed")
+        warning("Make sure Voodocs is properly installed")
         return 1
     except Exception as e:
         error(f"Failed to generate context: {e}")

package/lib/darkarts/context/errors.py

@@ -52,7 +52,7 @@ class GitNotAvailableError(ConfigurationError):
     def __init__(self):
         super().__init__(
             f"Git is not available\n\n"
-            f"💡 Some VooDocs features require Git. Please install Git:\n"
+            f"💡 Some Voodocs features require Git. Please install Git:\n"
             f"   https://git-scm.com/downloads"
         )
 

package/lib/darkarts/context/models.py

@@ -8,7 +8,7 @@
 
 Context System Data Models
 
-This module defines the data structures for the VooDocs context system.
+This module defines the data structures for the Voodocs context system.
 """
 
 from dataclasses import dataclass, field, asdict

package/lib/darkarts/context/ui.py

@@ -119,8 +119,8 @@ def step(message: str) -> None:
         message: Step message to display
         
     Example:
-        >>> step("Initializing VooDocs context...")
-        ▶️  Initializing VooDocs context...
+        >>> step("Initializing Voodocs context...")
+        ▶️  Initializing Voodocs context...
     """
     print(f"{Colors.CYAN}▶️  {message}{Colors.RESET}")
 
@@ -243,10 +243,10 @@ def print_header(title: str) -> None:
         title: Header title
         
     Example:
-        >>> print_header("VooDocs Context System")
+        >>> print_header("Voodocs Context System")
         
         ═══════════════════════════════════════════════════════════════
-        VooDocs Context System
+        Voodocs Context System
         ═══════════════════════════════════════════════════════════════
     """
     width = 80

package/lib/darkarts/context/yaml_utils.py

@@ -56,7 +56,7 @@ def write_context_yaml(context: ContextFile, file_path: Path) -> None:
     # Create file with header comment
     with open(file_path, 'w', encoding='utf-8') as f:
         # Write header
-        f.write("# VooDocs Context File\n")
+        f.write("# Voodocs Context File\n")
         f.write("# This file contains structured project context for AI assistants and developers.\n")
         f.write("# Format: YAML (DSL for machines, use 'voodocs context view' for human-readable Markdown)\n")
         f.write("# Version: {}\n".format(context.versioning.context_version))
@@ -333,14 +333,14 @@ def add_to_gitignore(project_root: Path) -> bool:
             # Ensure there's a newline before our section
             if not content.endswith('\n'):
                 f.write('\n')
-            f.write('\n# VooDocs Context File (contains internal project details)\n')
+            f.write('\n# Voodocs Context File (contains internal project details)\n')
             f.write(f'{context_entry}\n')
         
         return True
     else:
         # Create .gitignore with entry
         with open(gitignore_path, 'w', encoding='utf-8') as f:
-            f.write('# VooDocs Context File (contains internal project details)\n')
+            f.write('# Voodocs Context File (contains internal project details)\n')
             f.write(f'{context_entry}\n')
         
         return True

package/lib/darkarts/core/loader.py

@@ -199,7 +199,7 @@ class PluginLoader:
             plugin = self.load_from_module("darkarts.plugins.voodocs", "VooDocsPlugin")
             plugins.append(plugin)
         except PluginError:
-            pass  # VooDocs plugin not yet implemented
+            pass  # Voodocs plugin not yet implemented
         
         return plugins
     

package/lib/darkarts/documentation/__init__.py

@@ -0,0 +1,10 @@
+"""
+Documentation Generation Module
+
+Provides consolidated, human-readable documentation generation.
+"""
+
+from .consolidator import DocumentationConsolidator, DocumentedItem
+from .categorizer import AnnotationCategorizer
+
+__all__ = ['DocumentationConsolidator', 'DocumentedItem', 'AnnotationCategorizer']

package/lib/darkarts/documentation/categorizer.py

@@ -0,0 +1,137 @@
+"""
+Annotation Categorizer
+
+Extracts categorization metadata from @darkarts annotations.
+"""
+
+from typing import Dict, Set, Any, List
+from pathlib import Path
+
+
+class AnnotationCategorizer:
+    """Categorizes code based on @darkarts annotations and file paths."""
+    
+    # Type detection patterns
+    TYPE_PATTERNS = {
+        'component': ['component', 'tsx', 'jsx', 'ui', 'view'],
+        'function': ['function', 'util', 'helper'],
+        'module': ['module', 'service', 'manager'],
+        'api': ['api', 'route', 'endpoint', 'handler'],
+        'data': ['schema', 'model', 'type', 'interface'],
+    }
+    
+    # Domain keywords
+    DOMAIN_KEYWORDS = {
+        'authentication': ['auth', 'login', 'signup', 'session', 'token'],
+        'billing': ['billing', 'subscription', 'payment', 'invoice', 'stripe'],
+        'admin': ['admin', 'dashboard', 'management'],
+        'user_management': ['user', 'account', 'profile'],
+        'analytics': ['analytics', 'tracking', 'metrics', 'stats'],
+        'marketplace': ['marketplace', 'listing', 'product'],
+        'api': ['api', 'endpoint', 'route'],
+    }
+    
+    # Layer detection
+    LAYER_PATTERNS = {
+        'frontend': ['component', 'ui', 'view', 'page', 'tsx', 'jsx', 'client'],
+        'backend': ['api', 'server', 'route', 'handler', 'controller'],
+        'database': ['schema', 'model', 'db', 'database', 'query'],
+    }
+    
+    @staticmethod
+    def detect_type(file_path: str, annotations: Dict[str, Any]) -> str:
+        """Detect the type of code item."""
+        path_lower = file_path.lower()
+        
+        # Check file path for type hints
+        for item_type, patterns in AnnotationCategorizer.TYPE_PATTERNS.items():
+            if any(pattern in path_lower for pattern in patterns):
+                return item_type
+                
+        # Check annotations
+        if 'module_purpose' in annotations or '⊢' in str(annotations):
+            return 'module'
+            
+        return 'other'
+        
+    @staticmethod
+    def detect_domains(file_path: str, annotations: Dict[str, Any]) -> Set[str]:
+        """Detect which domains this code belongs to."""
+        domains = set()
+        path_lower = file_path.lower()
+        
+        # Check file path
+        for domain, keywords in AnnotationCategorizer.DOMAIN_KEYWORDS.items():
+            if any(keyword in path_lower for keyword in keywords):
+                domains.add(domain)
+                
+        # Check annotation content
+        annotation_text = str(annotations).lower()
+        for domain, keywords in AnnotationCategorizer.DOMAIN_KEYWORDS.items():
+            if any(keyword in annotation_text for keyword in keywords):
+                domains.add(domain)
+                
+        return domains
+        
+    @staticmethod
+    def detect_concerns(annotations: Dict[str, Any]) -> Set[str]:
+        """Detect cross-cutting concerns."""
+        concerns = set()
+        
+        # Check for security
+        if 'security' in annotations or '🔒' in str(annotations):
+            concerns.add('security')
+            
+        # Check for business logic
+        if 'business_logic' in annotations:
+            concerns.add('business_logic')
+            
+        # Check for performance
+        if 'complexity' in annotations or '⚡' in str(annotations):
+            concerns.add('performance')
+            
+        # Check for integrations (external dependencies)
+        dependencies = annotations.get('dependencies', [])
+        if isinstance(dependencies, list):
+            external_deps = [d for d in dependencies if not str(d).startswith('.')]
+            if external_deps:
+                concerns.add('integrations')
+                
+        # Check for error handling
+        if 'error_handling' in annotations or 'exceptions' in str(annotations).lower():
+            concerns.add('error_handling')
+            
+        return concerns
+        
+    @staticmethod
+    def detect_layers(file_path: str, annotations: Dict[str, Any]) -> Set[str]:
+        """Detect which architectural layers this code belongs to."""
+        layers = set()
+        path_lower = file_path.lower()
+        
+        for layer, patterns in AnnotationCategorizer.LAYER_PATTERNS.items():
+            if any(pattern in path_lower for pattern in patterns):
+                layers.add(layer)
+                
+        return layers
+        
+    @staticmethod
+    def extract_name(file_path: str) -> str:
+        """Extract a human-readable name from file path."""
+        path = Path(file_path)
+        name = path.stem
+        
+        # Remove common suffixes
+        suffixes_to_remove = [
+            '.test', '.spec', '.component', '.service',
+            '.controller', '.model', '.schema'
+        ]
+        for suffix in suffixes_to_remove:
+            if name.endswith(suffix):
+                name = name[:-len(suffix)]
+                
+        # Convert kebab-case and snake_case to Title Case
+        name = name.replace('-', ' ').replace('_', ' ')
+        name = ' '.join(word.capitalize() for word in name.split())
+        
+        return name