@voodocs/cli 2.2.0 → 2.2.2

package/lib/darkarts/annotations/parser.py

@@ -763,50 +763,229 @@ class AnnotationParser:
         language: Language,
         darkarts_matches: List
     ) -> ParsedAnnotations:
-        """Parse @darkarts annotations and translate to VooDocs format."""
-        from .darkarts_parser import parse_darkarts
-        from .translator import DarkArtsTranslator
+        """Parse @darkarts annotations using two-pass approach.
         
-        # Parse all @darkarts annotations
-        translator = DarkArtsTranslator()
-        translated_annotations = []
+        Pass 1: Extract code structure using language-specific parser
+        Pass 2: Parse annotations and overlay them onto structure by line number
+        """
+        from .darkarts_parser import DarkArtsParser
+        
+        # PASS 1: Extract code structure using language-specific parser
+        if language == Language.PYTHON:
+            # For Python, extract structure using AST
+            structure = self._extract_python_structure(source_code, source_file)
+        elif language in (Language.TYPESCRIPT, Language.JAVASCRIPT):
+            # For TypeScript/JavaScript, use TypeScript parser
+            structure = self._extract_typescript_structure(source_file)
+        else:
+            # For other languages, create empty structure
+            structure = self._create_empty_structure(source_file, language)
+        
+        # PASS 2: Parse @darkarts annotations and match to structure
+        darkarts_parser = DarkArtsParser()
+        annotations_by_line = {}
         
         for match in darkarts_matches:
             darkarts_text = match.group(1)
+            line_number = source_code[:match.start()].count('\n') + 1
             
-            # Parse @darkarts annotation (parse_annotation expects just the content)
-            from .darkarts_parser import DarkArtsParser
-            parser = DarkArtsParser()
-            darkarts_annotation = parser.parse_annotation(darkarts_text)
-            
-            # Process the annotation
+            # Parse @darkarts annotation
+            darkarts_annotation = darkarts_parser.parse_annotation(darkarts_text)
             if darkarts_annotation:
-                # Convert DarkArtsAnnotation to dict for YAML generation
-                annotation_dict = {
-                    'module': darkarts_annotation.module,
-                    'dependencies': darkarts_annotation.dependencies,
-                    'assumptions': darkarts_annotation.assumptions,
-                    'invariants': darkarts_annotation.invariants,
-                    'security_model': darkarts_annotation.security,
-                    'performance': darkarts_annotation.performance,
-                }
+                annotations_by_line[line_number] = darkarts_annotation
+        
+        # PASS 3: Overlay annotations onto structure
+        return self._overlay_annotations(structure, annotations_by_line)
+    
+    def _extract_python_structure(self, source_code: str, source_file: str) -> ParsedAnnotations:
+        """Extract Python code structure using AST (without annotations)."""
+        try:
+            tree = ast.parse(source_code)
+        except SyntaxError:
+            return self._create_empty_structure(source_file, Language.PYTHON)
+        
+        module = ModuleAnnotation(
+            name=Path(source_file).stem,
+            source_file=source_file,
+            language=Language.PYTHON,
+        )
+        
+        # Extract functions and classes from AST
+        for node in ast.walk(tree):
+            if isinstance(node, ast.FunctionDef):
+                func = FunctionAnnotation(
+                    name=node.name,
+                    line_number=node.lineno,
+                )
+                module.functions.append(func)
+            elif isinstance(node, ast.ClassDef):
+                cls = ClassAnnotation(
+                    name=node.name,
+                    line_number=node.lineno,
+                )
+                # Extract methods
+                for item in node.body:
+                    if isinstance(item, ast.FunctionDef):
+                        method = FunctionAnnotation(
+                            name=item.name,
+                            line_number=item.lineno,
+                        )
+                        cls.methods.append(method)
+                module.classes.append(cls)
+        
+        return ParsedAnnotations(
+            module=module,
+            language=Language.PYTHON,
+            source_file=source_file,
+        )
+    
+    def _extract_typescript_structure(self, source_file: str) -> ParsedAnnotations:
+        """Extract TypeScript/JavaScript code structure using TypeScript parser."""
+        try:
+            check_parser_for_language('typescript')
+        except ParserNotBuiltError:
+            return self._create_empty_structure(source_file, Language.TYPESCRIPT)
+        
+        # Get the path to the TypeScript parser CLI
+        parser_dir = Path(__file__).parent.parent / 'parsers' / 'typescript'
+        parser_cli = parser_dir / 'dist' / 'cli.js'
+        
+        if not parser_cli.exists():
+            return self._create_empty_structure(source_file, Language.TYPESCRIPT)
+        
+        # Run the TypeScript parser
+        try:
+            result = subprocess.run(
+                ['node', str(parser_cli), source_file],
+                capture_output=True,
+                text=True,
+                check=True
+            )
+            data = json.loads(result.stdout)
+        except (subprocess.CalledProcessError, json.JSONDecodeError):
+            return self._create_empty_structure(source_file, Language.TYPESCRIPT)
+        
+        # Convert TypeScript parser output to our format
+        language = Language.TYPESCRIPT if data['language'] == 'typescript' else Language.JAVASCRIPT
+        
+        module = ModuleAnnotation(
+            name=Path(source_file).stem,
+            source_file=source_file,
+            language=language,
+        )
+        
+        # Extract classes
+        for cls_data in data.get('classes', []):
+            cls = ClassAnnotation(
+                name=cls_data['name'],
+                line_number=cls_data['line'],
+            )
+            # Extract methods
+            for method_data in cls_data.get('methods', []):
+                method = FunctionAnnotation(
+                    name=method_data['name'],
+                    line_number=method_data['line'],
+                )
+                cls.methods.append(method)
+            module.classes.append(cls)
+        
+        # Extract functions
+        for func_data in data.get('functions', []):
+            func = FunctionAnnotation(
+                name=func_data['name'],
+                line_number=func_data['line'],
+            )
+            module.functions.append(func)
+        
+        return ParsedAnnotations(
+            module=module,
+            language=language,
+            source_file=source_file,
+        )
+    
+    def _create_empty_structure(self, source_file: str, language: Language) -> ParsedAnnotations:
+        """Create empty structure for unsupported languages."""
+        module = ModuleAnnotation(
+            name=Path(source_file).stem,
+            source_file=source_file,
+            language=language,
+        )
+        return ParsedAnnotations(
+            module=module,
+            language=language,
+            source_file=source_file,
+        )
+    
+    def _overlay_annotations(self, structure: ParsedAnnotations, annotations_by_line: Dict[int, Any]) -> ParsedAnnotations:
+        """Overlay parsed annotations onto code structure by matching line numbers."""
+        # Match annotations to code elements by finding the closest following element
+        for line_num, annotation in annotations_by_line.items():
+            # Check if this is a module-level annotation (appears before any code)
+            if self._is_module_annotation(annotation):
+                self._apply_module_annotation_from_darkarts(structure.module, annotation)
+                continue
+            
+            # Find the closest function or class after this line
+            matched = False
+            
+            # Try to match to a function
+            for func in structure.module.functions:
+                if func.line_number >= line_num and func.line_number - line_num <= 5:
+                    self._apply_function_annotation_from_darkarts(func, annotation)
+                    matched = True
+                    break
+            
+            if matched:
+                continue
+            
+            # Try to match to a class
+            for cls in structure.module.classes:
+                if cls.line_number >= line_num and cls.line_number - line_num <= 5:
+                    self._apply_class_annotation_from_darkarts(cls, annotation)
+                    matched = True
+                    break
                 
-                # Convert to @voodocs YAML format
-                voodocs_yaml = self._darkarts_to_voodocs_yaml(annotation_dict)
+                # Try to match to a method within the class
+                for method in cls.methods:
+                    if method.line_number >= line_num and method.line_number - line_num <= 5:
+                        self._apply_function_annotation_from_darkarts(method, annotation)
+                        matched = True
+                        break
                 
-                line_number = source_code[:match.start()].count('\n') + 1
-                translated_annotations.append({
-                    'text': voodocs_yaml,
-                    'line': line_number,
-                    'start': match.start(),
-                    'end': match.end(),
-                })
-        
-        # Parse as if they were @voodocs
-        if language == Language.PYTHON:
-            return self._parse_python(source_code, source_file, translated_annotations)
-        else:
-            return self._parse_generic(source_code, source_file, language, translated_annotations)
+                if matched:
+                    break
+        
+        return structure
+    
+    def _is_module_annotation(self, annotation: Any) -> bool:
+        """Check if annotation is module-level."""
+        return hasattr(annotation, 'module') and annotation.module
+    
+    def _apply_module_annotation_from_darkarts(self, module: ModuleAnnotation, annotation: Any):
+        """Apply @darkarts annotation to module."""
+        if hasattr(annotation, 'module') and annotation.module:
+            module.module_purpose = f"Module {{{annotation.module}}}"
+        if hasattr(annotation, 'dependencies') and annotation.dependencies:
+            module.dependencies = annotation.dependencies
+        if hasattr(annotation, 'assumptions') and annotation.assumptions:
+            module.assumptions = annotation.assumptions
+    
+    def _apply_function_annotation_from_darkarts(self, func: FunctionAnnotation, annotation: Any):
+        """Apply @darkarts annotation to function."""
+        if hasattr(annotation, 'preconditions') and annotation.preconditions:
+            func.preconditions = annotation.preconditions
+        if hasattr(annotation, 'postconditions') and annotation.postconditions:
+            func.postconditions = annotation.postconditions
+        if hasattr(annotation, 'invariants') and annotation.invariants:
+            func.invariants = annotation.invariants
+        if hasattr(annotation, 'performance') and annotation.performance:
+            if isinstance(annotation.performance, dict) and 'complexity' in annotation.performance:
+                func.complexity = annotation.performance['complexity']
+    
+    def _apply_class_annotation_from_darkarts(self, cls: ClassAnnotation, annotation: Any):
+        """Apply @darkarts annotation to class."""
+        if hasattr(annotation, 'invariants') and annotation.invariants:
+            cls.invariants = annotation.invariants
     
     def _darkarts_to_voodocs_yaml(self, annotation_dict: Dict[str, Any]) -> str:
         """Convert DarkArts annotation dict to YAML format (legacy)."""

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

package/lib/darkarts/documentation/consolidator.py

@@ -0,0 +1,303 @@
+"""
+Documentation Consolidator
+
+Generates human-readable consolidated documentation from @darkarts annotations.
+Organizes content by multiple categorization schemes for better readability.
+"""
+
+from typing import Dict, List, Set, Any
+from pathlib import Path
+from dataclasses import dataclass, field
+
+
+@dataclass
+class DocumentedItem:
+    """Represents a single documented code item."""
+    name: str
+    file_path: str
+    item_type: str  # component, function, module, api, etc.
+    content: str
+    annotations: Dict[str, Any] = field(default_factory=dict)
+    
+    # Categorization metadata
+    domains: Set[str] = field(default_factory=set)  # auth, billing, admin, etc.
+    concerns: Set[str] = field(default_factory=set)  # business_logic, security, etc.
+    layers: Set[str] = field(default_factory=set)  # frontend, backend, database
+    
+
+class DocumentationConsolidator:
+    """Consolidates scattered documentation into organized, readable documents."""
+    
+    def __init__(self, project_name: str = "Project"):
+        self.project_name = project_name
+        self.items: List[DocumentedItem] = []
+        
+    def add_item(self, item: DocumentedItem):
+        """Add a documented item to the consolidator."""
+        self.items.append(item)
+        
+    def categorize_items(self):
+        """Automatically categorize all items."""
+        for item in self.items:
+            self._categorize_by_type(item)
+            self._categorize_by_path(item)
+            self._categorize_by_annotations(item)
+            
+    def _categorize_by_type(self, item: DocumentedItem):
+        """Categorize by code type."""
+        # Determine layer from file extension and path
+        path_lower = item.file_path.lower()
+        
+        if any(x in path_lower for x in ['component', 'ui', 'view', '.tsx', '.jsx']):
+            item.layers.add('frontend')
+        if any(x in path_lower for x in ['api', 'server', 'backend', 'route']):
+            item.layers.add('backend')
+        if any(x in path_lower for x in ['schema', 'model', 'database', 'db']):
+            item.layers.add('database')
+            
+    def _categorize_by_path(self, item: DocumentedItem):
+        """Categorize by file path patterns."""
+        path_parts = Path(item.file_path).parts
+        
+        # Extract domain from path
+        domain_keywords = {
+            'auth': 'authentication',
+            'billing': 'billing',
+            'subscription': 'billing',
+            'admin': 'admin',
+            'user': 'user_management',
+            'account': 'user_management',
+            'api': 'api',
+            'payment': 'billing',
+            'analytics': 'analytics',
+            'marketplace': 'marketplace',
+        }
+        
+        for part in path_parts:
+            part_lower = part.lower()
+            for keyword, domain in domain_keywords.items():
+                if keyword in part_lower:
+                    item.domains.add(domain)
+                    
+    def _categorize_by_annotations(self, item: DocumentedItem):
+        """Categorize by @darkarts annotation content."""
+        annotations = item.annotations
+        
+        # Check for security concerns
+        if 'security' in annotations or '🔒' in str(annotations):
+            item.concerns.add('security')
+            
+        # Check for business logic
+        if 'business_logic' in annotations:
+            item.concerns.add('business_logic')
+            
+        # Check for performance
+        if 'complexity' in annotations or '⚡' in str(annotations):
+            item.concerns.add('performance')
+            
+        # Check for integrations
+        dependencies = annotations.get('dependencies', [])
+        if any(dep for dep in dependencies if not dep.startswith('.')):
+            item.concerns.add('integrations')
+            
+    def generate_by_type(self) -> Dict[str, str]:
+        """Generate documentation organized by type."""
+        categories = {
+            'component': [],
+            'function': [],
+            'module': [],
+            'api': [],
+            'data': [],
+        }
+        
+        for item in self.items:
+            item_type = item.item_type.lower()
+            if item_type in categories:
+                categories[item_type].append(item)
+            else:
+                categories.setdefault('other', []).append(item)
+                
+        docs = {}
+        for category, items in categories.items():
+            if items:
+                docs[f'by-type/{category.upper()}.md'] = self._generate_category_doc(
+                    f"{category.title()}s",
+                    items,
+                    f"All {category}s in the project"
+                )
+        return docs
+        
+    def generate_by_domain(self) -> Dict[str, str]:
+        """Generate documentation organized by domain."""
+        domain_items = {}
+        
+        for item in self.items:
+            for domain in item.domains:
+                domain_items.setdefault(domain, []).append(item)
+                
+        docs = {}
+        for domain, items in domain_items.items():
+            docs[f'by-domain/{domain.upper()}.md'] = self._generate_category_doc(
+                domain.replace('_', ' ').title(),
+                items,
+                f"All code related to {domain.replace('_', ' ')}"
+            )
+        return docs
+        
+    def generate_by_concern(self) -> Dict[str, str]:
+        """Generate documentation organized by concern."""
+        concern_items = {}
+        
+        for item in self.items:
+            for concern in item.concerns:
+                concern_items.setdefault(concern, []).append(item)
+                
+        docs = {}
+        for concern, items in concern_items.items():
+            docs[f'by-concern/{concern.upper()}.md'] = self._generate_category_doc(
+                concern.replace('_', ' ').title(),
+                items,
+                f"Code with {concern.replace('_', ' ')} considerations"
+            )
+        return docs
+        
+    def generate_by_layer(self) -> Dict[str, str]:
+        """Generate documentation organized by layer."""
+        layer_items = {}
+        
+        for item in self.items:
+            for layer in item.layers:
+                layer_items.setdefault(layer, []).append(item)
+                
+        docs = {}
+        for layer, items in layer_items.items():
+            docs[f'by-layer/{layer.upper()}.md'] = self._generate_category_doc(
+                f"{layer.title()} Layer",
+                items,
+                f"All {layer} code"
+            )
+        return docs
+        
+    def generate_master_readme(self, all_docs: Dict[str, str]) -> str:
+        """Generate master README with overview and navigation."""
+        sections = []
+        
+        # Header
+        sections.append(f"# {self.project_name} Documentation\n")
+        sections.append(f"*Generated by Voodocs from @darkarts annotations*\n")
+        sections.append(f"**Total Items Documented:** {len(self.items)}\n")
+        sections.append("---\n")
+        
+        # Quick Navigation
+        sections.append("## 📚 Documentation Categories\n")
+        sections.append("### By Type")
+        for doc_path in sorted(all_docs.keys()):
+            if doc_path.startswith('by-type/'):
+                name = doc_path.replace('by-type/', '').replace('.md', '')
+                sections.append(f"- [{name}]({doc_path})")
+        sections.append("")
+        
+        sections.append("### By Domain")
+        for doc_path in sorted(all_docs.keys()):
+            if doc_path.startswith('by-domain/'):
+                name = doc_path.replace('by-domain/', '').replace('.md', '')
+                sections.append(f"- [{name}]({doc_path})")
+        sections.append("")
+        
+        sections.append("### By Concern")
+        for doc_path in sorted(all_docs.keys()):
+            if doc_path.startswith('by-concern/'):
+                name = doc_path.replace('by-concern/', '').replace('.md', '')
+                sections.append(f"- [{name}]({doc_path})")
+        sections.append("")
+        
+        sections.append("### By Layer")
+        for doc_path in sorted(all_docs.keys()):
+            if doc_path.startswith('by-layer/'):
+                name = doc_path.replace('by-layer/', '').replace('.md', '')
+                sections.append(f"- [{name}]({doc_path})")
+        sections.append("")
+        
+        sections.append("---\n")
+        
+        # Statistics
+        sections.append("## 📊 Project Statistics\n")
+        
+        type_counts = {}
+        for item in self.items:
+            type_counts[item.item_type] = type_counts.get(item.item_type, 0) + 1
+        sections.append("### By Type")
+        for item_type, count in sorted(type_counts.items()):
+            sections.append(f"- **{item_type.title()}**: {count}")
+        sections.append("")
+        
+        # Domain distribution
+        domain_counts = {}
+        for item in self.items:
+            for domain in item.domains:
+                domain_counts[domain] = domain_counts.get(domain, 0) + 1
+        if domain_counts:
+            sections.append("### By Domain")
+            for domain, count in sorted(domain_counts.items(), key=lambda x: x[1], reverse=True):
+                sections.append(f"- **{domain.replace('_', ' ').title()}**: {count}")
+            sections.append("")
+        
+        sections.append("---\n")
+        
+        # Index
+        sections.append("## 🔍 Complete Index\n")
+        for item in sorted(self.items, key=lambda x: x.name):
+            sections.append(f"- **{item.name}** ({item.item_type}) - `{item.file_path}`")
+        
+        return "\n".join(sections)
+        
+    def _generate_category_doc(self, title: str, items: List[DocumentedItem], description: str) -> str:
+        """Generate documentation for a specific category."""
+        sections = []
+        
+        sections.append(f"# {title}\n")
+        sections.append(f"*{description}*\n")
+        sections.append(f"**Items in this category:** {len(items)}\n")
+        sections.append("---\n")
+        
+        # Table of contents
+        sections.append("## Table of Contents\n")
+        for item in sorted(items, key=lambda x: x.name):
+            sections.append(f"- [{item.name}](#{item.name.lower().replace(' ', '-')})")
+        sections.append("\n---\n")
+        
+        # Items
+        for item in sorted(items, key=lambda x: x.name):
+            sections.append(f"## {item.name}\n")
+            sections.append(f"**Type:** {item.item_type}  ")
+            sections.append(f"**File:** `{item.file_path}`\n")
+            
+            if item.domains:
+                sections.append(f"**Domains:** {', '.join(sorted(item.domains))}  ")
+            if item.concerns:
+                sections.append(f"**Concerns:** {', '.join(sorted(item.concerns))}  ")
+            if item.layers:
+                sections.append(f"**Layers:** {', '.join(sorted(item.layers))}  ")
+            sections.append("")
+            
+            sections.append(item.content)
+            sections.append("\n---\n")
+            
+        return "\n".join(sections)
+        
+    def generate_all(self) -> Dict[str, str]:
+        """Generate all consolidated documentation."""
+        # Categorize all items first
+        self.categorize_items()
+        
+        # Generate all category docs
+        all_docs = {}
+        all_docs.update(self.generate_by_type())
+        all_docs.update(self.generate_by_domain())
+        all_docs.update(self.generate_by_concern())
+        all_docs.update(self.generate_by_layer())
+        
+        # Generate master README
+        all_docs['README.md'] = self.generate_master_readme(all_docs)
+        
+        return all_docs

package/lib/darkarts/parsers/typescript/dist/parser.d.ts

@@ -66,6 +66,22 @@ export declare class TypeScriptAnnotationParser {
      * Parse an interface declaration
      */
     private parseInterface;
+    /**
+     * Parse a variable statement that may contain function expressions or arrow functions
+     */
+    private parseVariableStatement;
+    /**
+     * Extract parameters from a function expression or arrow function
+     */
+    private extractParametersFromExpression;
+    /**
+     * Extract return type from a function expression or arrow function
+     */
+    private extractReturnTypeFromExpression;
+    /**
+     * Check if a function expression or arrow function is async
+     */
+    private isAsyncExpression;
     /**
      * Extract annotations from a node's JSDoc comments
      */

package/lib/darkarts/parsers/typescript/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,UAAU;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,0BAA0B;IAIzB,OAAO,CAAC,QAAQ;IAH5B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAS;gBAEP,QAAQ,EAAE,MAAM;IAUpC;;OAEG;IACI,KAAK,IAAI,WAAW;IAqC3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,UAAU;IA2BlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2C3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAmElB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,UAAU;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,0BAA0B;IAIzB,OAAO,CAAC,QAAQ;IAH5B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAS;gBAEP,QAAQ,EAAE,MAAM;IAUpC;;OAEG;IACI,KAAK,IAAI,WAAW;IAyC3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,UAAU;IA2BlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAQvC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAOvC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2C3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAmElB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/lib/darkarts/parsers/typescript/dist/parser.js

@@ -74,6 +74,11 @@ class TypeScriptAnnotationParser {
                     result.functions.push(funcInfo);
                 }
             }
+            else if (ts.isVariableStatement(node)) {
+                // Handle arrow functions and function expressions
+                const funcInfos = this.parseVariableStatement(node);
+                result.functions.push(...funcInfos);
+            }
             else if (ts.isInterfaceDeclaration(node)) {
                 const interfaceInfo = this.parseInterface(node);
                 if (interfaceInfo) {
@@ -172,6 +177,65 @@ class TypeScriptAnnotationParser {
             is_exported: this.isExported(node)
         };
     }
+    /**
+     * Parse a variable statement that may contain function expressions or arrow functions
+     */
+    parseVariableStatement(node) {
+        const functions = [];
+        const isExported = this.isExported(node);
+        for (const declaration of node.declarationList.declarations) {
+            if (!ts.isVariableDeclaration(declaration))
+                continue;
+            if (!declaration.initializer)
+                continue;
+            const name = declaration.name.text;
+            if (!name)
+                continue;
+            // Check if the initializer is a function expression or arrow function
+            const init = declaration.initializer;
+            if (ts.isFunctionExpression(init) || ts.isArrowFunction(init)) {
+                functions.push({
+                    name,
+                    line: this.getLineNumber(declaration),
+                    parameters: this.extractParametersFromExpression(init),
+                    return_type: this.extractReturnTypeFromExpression(init),
+                    annotations: this.extractAnnotations(node),
+                    is_async: this.isAsyncExpression(init),
+                    is_exported: isExported
+                });
+            }
+        }
+        return functions;
+    }
+    /**
+     * Extract parameters from a function expression or arrow function
+     */
+    extractParametersFromExpression(node) {
+        return node.parameters.map(param => {
+            const name = param.name.text;
+            const type = param.type ? `: ${param.type.getText(this.sourceFile)}` : '';
+            return `${name}${type}`;
+        });
+    }
+    /**
+     * Extract return type from a function expression or arrow function
+     */
+    extractReturnTypeFromExpression(node) {
+        if (node.type) {
+            return node.type.getText(this.sourceFile);
+        }
+        return null;
+    }
+    /**
+     * Check if a function expression or arrow function is async
+     */
+    isAsyncExpression(node) {
+        if (ts.canHaveModifiers(node)) {
+            const modifiers = ts.getModifiers(node);
+            return modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) || false;
+        }
+        return false;
+    }
     /**
      * Extract annotations from a node's JSDoc comments
      */

package/lib/darkarts/parsers/typescript/dist/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/lib/darkarts/parsers/typescript/src/parser.ts

@@ -86,6 +86,10 @@ export class TypeScriptAnnotationParser {
         if (funcInfo) {
           result.functions.push(funcInfo);
         }
+      } else if (ts.isVariableStatement(node)) {
+        // Handle arrow functions and function expressions
+        const funcInfos = this.parseVariableStatement(node);
+        result.functions.push(...funcInfos);
       } else if (ts.isInterfaceDeclaration(node)) {
         const interfaceInfo = this.parseInterface(node);
         if (interfaceInfo) {
@@ -195,6 +199,70 @@ export class TypeScriptAnnotationParser {
     };
   }
 
+  /**
+   * Parse a variable statement that may contain function expressions or arrow functions
+   */
+  private parseVariableStatement(node: ts.VariableStatement): FunctionInfo[] {
+    const functions: FunctionInfo[] = [];
+    const isExported = this.isExported(node);
+
+    for (const declaration of node.declarationList.declarations) {
+      if (!ts.isVariableDeclaration(declaration)) continue;
+      if (!declaration.initializer) continue;
+
+      const name = (declaration.name as ts.Identifier).text;
+      if (!name) continue;
+
+      // Check if the initializer is a function expression or arrow function
+      const init = declaration.initializer;
+      if (ts.isFunctionExpression(init) || ts.isArrowFunction(init)) {
+        functions.push({
+          name,
+          line: this.getLineNumber(declaration),
+          parameters: this.extractParametersFromExpression(init),
+          return_type: this.extractReturnTypeFromExpression(init),
+          annotations: this.extractAnnotations(node),
+          is_async: this.isAsyncExpression(init),
+          is_exported: isExported
+        });
+      }
+    }
+
+    return functions;
+  }
+
+  /**
+   * Extract parameters from a function expression or arrow function
+   */
+  private extractParametersFromExpression(node: ts.FunctionExpression | ts.ArrowFunction): string[] {
+    return node.parameters.map(param => {
+      const name = (param.name as ts.Identifier).text;
+      const type = param.type ? `: ${param.type.getText(this.sourceFile)}` : '';
+      return `${name}${type}`;
+    });
+  }
+
+  /**
+   * Extract return type from a function expression or arrow function
+   */
+  private extractReturnTypeFromExpression(node: ts.FunctionExpression | ts.ArrowFunction): string | null {
+    if (node.type) {
+      return node.type.getText(this.sourceFile);
+    }
+    return null;
+  }
+
+  /**
+   * Check if a function expression or arrow function is async
+   */
+  private isAsyncExpression(node: ts.FunctionExpression | ts.ArrowFunction): boolean {
+    if (ts.canHaveModifiers(node)) {
+      const modifiers = ts.getModifiers(node);
+      return modifiers?.some((m: ts.Modifier) => m.kind === ts.SyntaxKind.AsyncKeyword) || false;
+    }
+    return false;
+  }
+
   /**
    * Extract annotations from a node's JSDoc comments
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voodocs/cli",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "AI-Native Symbolic Documentation System - The world's first documentation tool using mathematical notation with semantic validation",
   "main": "voodocs_cli.py",
   "bin": {
@@ -60,6 +60,7 @@
     "lib/darkarts/core/",
     "lib/darkarts/validation/",
     "lib/darkarts/instructions/",
+    "lib/darkarts/documentation/",
     "lib/darkarts/exceptions.py",
     "lib/darkarts/telemetry.py",
     "lib/darkarts/parsers/typescript/dist/",