@voodocs/cli 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [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

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.1"
+        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.

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.1",
+  "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": {