@voodocs/cli 3.0.0 → 3.0.1

package/lib/cli/__init__.py

@@ -16,7 +16,7 @@ This module provides the command-line interface for VooDocs.
 import click
 from typing import Optional
 
-__version__ = "3.0.0"
+__version__ = "3.0.1"
 
 
 @click.group()

package/lib/darkarts/companion_files_expansion.py

@@ -0,0 +1,138 @@
+"""
+⊢companion_files:expansion
+∂{re,typing}
+⚠{python≥3.7}
+⊨{∀abbrev→expanded}
+🔒{read-only}
+⚡{O(n)|n=text-length}
+"""
+
+"""
+DarkArts v3.0.0 - Abbreviation Expansion for Companion Files
+
+Expands abbreviated text in companion files to full human-readable form.
+"""
+
+import re
+from typing import Dict
+
+# Import abbreviation dictionary from v3.0.0
+import sys
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).parent))
+from darkarts_abbreviations import ABBREVIATIONS
+
+
+def expand_abbreviations(text: str) -> str:
+    """
+    Expand abbreviations in text to full human-readable form.
+    
+    Args:
+        text: Text containing abbreviations (e.g., "u auth svc w/ JWT tok gen")
+    
+    Returns:
+        Expanded text (e.g., "user authentication service with JWT token generation")
+    
+    Examples:
+        >>> expand_abbreviations("u auth svc")
+        'user authentication service'
+        >>> expand_abbreviations("ret JWT tok|null")
+        'return JWT token or null'
+    """
+    # Sort by length (longest first) to avoid partial matches
+    sorted_abbrevs = sorted(ABBREVIATIONS.keys(), key=len, reverse=True)
+    
+    expanded = text
+    for abbrev in sorted_abbrevs:
+        full = ABBREVIATIONS[abbrev]
+        # Use word boundaries to avoid partial replacements
+        pattern = r'\b' + re.escape(abbrev) + r'\b'
+        expanded = re.sub(pattern, full, expanded, flags=re.IGNORECASE)
+    
+    return expanded
+
+
+def expand_pattern_shortcuts(text: str) -> str:
+    """
+    Expand pattern shortcuts to human-readable descriptions.
+    
+    Args:
+        text: Text containing pattern shortcuts (e.g., "id:uuid, pw≥8")
+    
+    Returns:
+        Expanded text (e.g., "id must be valid UUID, password must be at least 8 characters")
+    
+    Examples:
+        >>> expand_pattern_shortcuts("email:email")
+        'email must be valid email address'
+        >>> expand_pattern_shortcuts("pw≥8")
+        'password must be at least 8 characters'
+    """
+    pattern_expansions = {
+        r':uuid': ' must be valid UUID',
+        r':email': ' must be valid email address',
+        r':url': ' must be valid URL',
+        r':json': ' must be valid JSON',
+        r':jwt': ' must be valid JWT token',
+        r':hash': ' must be cryptographic hash',
+        r':enc': ' must be encrypted',
+        r'≥(\d+)': r' must be at least \1 characters',
+        r'≤(\d+)': r' must be at most \1 characters',
+        r'>(\d+)': r' must be greater than \1',
+        r'<(\d+)': r' must be less than \1',
+        r'\[(\d+),(\d+)\]': r' must be between \1 and \2',
+        r'∈\{([^}]+)\}': r' must be one of: \1'
+    }
+    
+    expanded = text
+    for pattern, replacement in pattern_expansions.items():
+        expanded = re.sub(pattern, replacement, expanded)
+    
+    return expanded
+
+
+def expand_companion_content(content: str, expand_patterns: bool = True, expand_abbrevs: bool = True) -> str:
+    """
+    Expand all abbreviations and patterns in companion file content.
+    
+    Args:
+        content: Raw companion file content
+        expand_patterns: Whether to expand pattern shortcuts
+        expand_abbrevs: Whether to expand abbreviations
+    
+    Returns:
+        Fully expanded human-readable content
+    
+    Examples:
+        >>> content = "⊢{u auth svc}\\n⊳{email:email,pw≥8}"
+        >>> expand_companion_content(content)
+        '⊢{user authentication service}\\n⊳{email must be valid email address, password must be at least 8 characters}'
+    """
+    expanded = content
+    
+    if expand_patterns:
+        expanded = expand_pattern_shortcuts(expanded)
+    
+    if expand_abbrevs:
+        expanded = expand_abbreviations(expanded)
+    
+    return expanded
+
+
+def expand_symbol_content(symbol_text: str) -> str:
+    """
+    Expand content within a specific symbol notation (e.g., ⊢{...}, ∂{...}).
+    
+    Args:
+        symbol_text: Text inside symbol braces
+    
+    Returns:
+        Expanded text
+    
+    Examples:
+        >>> expand_symbol_content("u auth svc w/ JWT tok gen")
+        'user authentication service with JWT token generation'
+    """
+    expanded = expand_abbreviations(symbol_text)
+    expanded = expand_pattern_shortcuts(expanded)
+    return expanded

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voodocs/cli",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "AI-Native Symbolic Documentation System - The world's first documentation tool using mathematical notation with semantic validation",
   "main": "voodocs_cli.py",
   "bin": {
@@ -64,6 +64,7 @@
     "lib/darkarts/exceptions.py",
     "lib/darkarts/telemetry.py",
     "lib/darkarts/companion_files.py",
+    "lib/darkarts/companion_files_expansion.py",
     "lib/darkarts/darkarts_abbreviations.py",
     "lib/darkarts/darkarts_patterns.py",
     "lib/darkarts/darkarts_symbols.py",