@voodocs/cli 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## [0.3.2] - 2025-12-20
+
+### Fixed
+- Fixed architecture decisions and modules parsing in yaml_utils.py
+- Now properly converts dict objects to ArchitectureDecision and Module objects
+- Fixes "'dict' object has no attribute 'decision'" error in context view
+- Discovered during dogfooding (setting up VooDocs in vooodooo-magic repo)
+
+### Added
+- Comprehensive @voodocs annotations to 4 core modules (commands, ai_integrations, checker, diagram)
+- Self-documentation: VooDocs now documents itself using its own annotation system
+- 93 lines of detailed annotations with dependencies, assumptions, invariants, security and performance models
+
+## [0.3.1] - 2025-12-20
+
+### Fixed
+- Improved AI selection prompt handling in `voodocs context init`
+- Changed prompt text from '[6 for all]' to '[default: 6]' for clarity
+- Added EOFError and KeyboardInterrupt handling for graceful abort
+- Added sys.stdout.flush() to ensure prompt displays immediately
+- Better error messages for invalid input
+
+This patch fixes the hanging issue some users experienced at the AI selection prompt.
+
 ## [0.3.0] - 2025-12-20
 
 ### Added

package/cli.py

@@ -137,7 +137,7 @@ Documentation: https://github.com/3vilEnterprises/vooodooo-magic/tree/main/packa
     parser.add_argument(
         "--version",
         action="version",
-        version="VooDocs 0.3.0"
+        version="VooDocs 0.3.2"
     )
     
     subparsers = parser.add_subparsers(dest="command", help="Available commands")

package/lib/darkarts/context/ai_integrations.py

@@ -1,4 +1,25 @@
-"""
+"""@voodocs
+module_purpose: "Native AI assistant integrations (Claude, Cursor, Copilot, Windsurf, Cline)"
+dependencies: [
+    "pathlib: File path handling",
+    "typing: Type hints"
+]
+assumptions: [
+    "AI config directories follow standard conventions (.claude/skills/, .cursor/rules/, etc.)",
+    "Project root is current working directory",
+    "File system allows directory creation",
+    "UTF-8 encoding is supported"
+]
+invariants: [
+    "All generated configs must be valid for their respective AIs",
+    "Detection must not modify any files",
+    "Generated content must be UTF-8 encoded",
+    "File paths must use forward slashes for cross-platform compatibility",
+    "Each AI integration must return Dict[str, str] mapping paths to content"
+]
+security_model: "Read-only detection, write only when explicitly called by user commands"
+performance_model: "O(1) for detection, O(k) for generation where k=number of AI assistants"
+
 AI-specific integration templates for VooDocs Context System.
 
 This module provides native integration with different AI assistants:

package/lib/darkarts/context/checker.py

@@ -1,4 +1,27 @@
-"""
+"""@voodocs
+module_purpose: "Invariant checking system - validates code against documented invariants"
+dependencies: [
+    "re: Pattern matching for code analysis",
+    "ast: Python AST parsing",
+    "pathlib: File traversal",
+    "dataclasses: Data structures for violations"
+]
+assumptions: [
+    "Source files are text-based and UTF-8 encoded",
+    "Invariants are written in natural language",
+    "File system is readable",
+    "Code is syntactically valid (for AST parsing)"
+]
+invariants: [
+    "Checker must never modify source files",
+    "All file reads must handle encoding errors gracefully",
+    "Pattern matching must be case-insensitive for security checks",
+    "Each invariant check must return a list of violations",
+    "Violation severity must be one of: error, warning, info"
+]
+security_model: "Read-only access to source files, no execution of code"
+performance_model: "O(n*m*l) where n=files, m=invariants, l=average lines per file"
+
 Invariant Checker
 
 Validates that code respects documented invariants.

package/lib/darkarts/context/commands.py

@@ -1,4 +1,28 @@
-"""
+"""@voodocs
+module_purpose: "Core context system commands (init, generate, check, diagram, validate, etc.)"
+dependencies: [
+    "yaml_utils: YAML parsing and serialization",
+    "models: Data structures for context",
+    "ai_integrations: AI assistant integration",
+    "checker: Invariant checking system",
+    "diagram: Architecture diagram generation"
+]
+assumptions: [
+    "Context file (.voodocs.context) is in project root",
+    "Git is available for commit/author detection",
+    "Python 3.11+ is installed",
+    "Project root is current working directory"
+]
+invariants: [
+    "Context file must be valid YAML",
+    "Version numbers must follow semver (major.minor)",
+    "All commands must return 0 (success) or 1 (error) exit code",
+    "Context updates must increment version number",
+    "Generated files must be UTF-8 encoded"
+]
+security_model: "Read context from disk, write only with user confirmation for init"
+performance_model: "O(1) for most commands, O(n) for generate where n=number of source files"
+
 Context System Commands
 
 Implements the command-line interface for the context system.
@@ -285,14 +309,15 @@ def cmd_context_init(force: bool = False) -> int:
                 print(f"  [{marker}] {i}. {desc}")
             
             print()
+            sys.stdout.flush()  # Ensure prompt is displayed
             
             # Get user choice
             while True:
-                choice_input = input("Enter number (1-7) [6 for all]: ").strip()
-                if not choice_input:
-                    choice_input = "6"  # Default to "all"
-                
                 try:
+                    choice_input = input("Enter number (1-7) [default: 6]: ").strip()
+                    if not choice_input:
+                        choice_input = "6"  # Default to "all"
+                    
                     choice_num = int(choice_input)
                     if 1 <= choice_num <= len(choices):
                         ai_type = choices[choice_num - 1][0]
@@ -301,6 +326,14 @@ def cmd_context_init(force: bool = False) -> int:
                         print(f"Please enter a number between 1 and {len(choices)}")
                 except ValueError:
                     print("Please enter a valid number")
+                except EOFError:
+                    # Handle Ctrl+D or EOF
+                    print("\nAborted.")
+                    return 1
+                except KeyboardInterrupt:
+                    # Handle Ctrl+C
+                    print("\nAborted.")
+                    return 1
             
             if ai_type != "none":
                 try:

package/lib/darkarts/context/diagram.py

@@ -1,4 +1,25 @@
-"""
+"""@voodocs
+module_purpose: "Architecture diagram generation from context (Mermaid and D2 formats)"
+dependencies: [
+    "subprocess: External diagram rendering (manus-render-diagram)",
+    "pathlib: File path handling",
+    "typing: Type hints"
+]
+assumptions: [
+    "Context file contains architecture.modules section",
+    "manus-render-diagram utility is available for PNG rendering",
+    "Output directory is writable",
+    "Mermaid/D2 syntax is valid"
+]
+invariants: [
+    "Generated diagrams must be valid Mermaid or D2 syntax",
+    "Module names must be sanitized for diagram syntax",
+    "Diagram generation must not modify context file",
+    "PNG rendering is optional and fails gracefully if utility unavailable"
+]
+security_model: "Read context file, write diagram files to user-specified paths"
+performance_model: "O(n) where n=number of modules, O(n^2) for dependency graphs"
+
 Architecture Diagram Generator
 
 Generates visual diagrams from context files.

package/lib/darkarts/context/yaml_utils.py

@@ -121,9 +121,39 @@ def parse_context_file(data: Dict[str, Any]) -> ContextFile:
     
     # Parse architecture
     arch_data = data.get('architecture', {})
+    
+    # Parse decisions
+    decisions_data = arch_data.get('decisions', [])
+    decisions = []
+    for dec in decisions_data:
+        if isinstance(dec, dict):
+            from .models import ArchitectureDecision
+            decisions.append(ArchitectureDecision(
+                decision=dec.get('decision', ''),
+                rationale=dec.get('rationale', ''),
+                alternatives_considered=dec.get('alternatives_considered', []),
+                tradeoffs=dec.get('tradeoffs'),
+                date=dec.get('date'),
+                author=dec.get('author')
+            ))
+    
+    # Parse modules
+    modules_data = arch_data.get('modules', {})
+    modules = {}
+    for name, mod in modules_data.items():
+        if isinstance(mod, dict):
+            from .models import Module
+            modules[name] = Module(
+                description=mod.get('description', mod.get('purpose', '')),
+                path=mod.get('path'),
+                language=mod.get('language'),
+                dependencies=mod.get('dependencies', []),
+                public_api=mod.get('public_api', [])
+            )
+    
     architecture = Architecture(
-        decisions=arch_data.get('decisions', []),
-        modules=arch_data.get('modules', {}),
+        decisions=decisions,
+        modules=modules,
         tech_stack=arch_data.get('tech_stack', {})
     )
     

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voodocs/cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "AI-Native Documentation System - Generate docs, tests, and API specs from @voodocs annotations using the DarkArts language",
   "main": "cli.py",
   "bin": {