@voodocs/cli 2.2.1 → 2.2.2

package/CHANGELOG.md

@@ -1,23 +1,19 @@
 ## [2.1.2] - 2025-12-21
 
 ### Fixed
-
 ## [2.1.3] - 2025-12-21
 
 ### Added
-
 - Full AI integration system wired to `voodocs init`
 - Claude Code skill generation (`.claude/skills/voodocs-context/`)
 - Automatic instructions.md generation with context reference
 
 ### Fixed
-
 - Context generation bug (write_context_yaml import issue)
 - AI integration parameter order
 - Claude integration now generates both skill and instructions
 
 ### Changed
-
 - `voodocs init` now sets up complete AI integration in one command
 - No need for separate `voodocs instruct` command
 
@@ -27,13 +23,11 @@
 ## [2.1.1] - 2025-12-21
 
 ### Fixed
-
 - npm publish issue (version bump to resolve registry conflict)
 
 ## [2.1.0] - 2025-12-21
 
 ### Added
-
 - **Context System Integration**: Full AI context generation from @darkarts annotations
   - New `voodocs context` command group (init, generate, view, status, validate)
   - Automatic context generation during `voodocs generate`
@@ -50,13 +44,11 @@
 - **Examples in Output Directory**: Examples now created in `./voodocs/examples/`
 
 ### Fixed
-
 - Parser now correctly handles @darkarts-only format (removed @voodocs pattern lookup)
 - Context system now recognizes @darkarts annotations instead of @voodocs
 - Git hooks installation for automatic context updates
 
 ### Changed
-
 - Default output directory changed from `./docs/` to `./voodocs/`
 - Examples directory moved from project root to output directory
 - Context generation is now opt-in via config (enabled by default)
@@ -66,14 +58,12 @@
 ## [2.0.2] - 2024-12-21
 
 ### Added
-
 - **Default paths in config** - `.voodocs.json` now includes `paths` section with `source`, `output`, and `recursive` settings
 - **Generate without arguments** - `voodocs generate` now uses config defaults, no need to specify source/output every time
 - **Recursive by default** - New projects default to recursive scanning (can be overridden with explicit flag)
 - **Examples in output directory** - Example files now created in `{output}/examples/` instead of project root
 
 ### Changed
-
 - **Default output directory** - Changed from `./docs` to `./voodocs` for better branding
 - **Examples location** - Examples now created in `./voodocs/examples/` instead of `./voodocs-examples/`
 - `voodocs generate` SOURCE and OUTPUT arguments are now optional
@@ -81,7 +71,6 @@
 - Improved user experience - simpler workflow after `voodocs init`
 
 ### Documentation
-
 - Updated generate command help text to show config-based usage
 - Added example: `voodocs generate` (uses config defaults)
 
@@ -90,19 +79,16 @@
 ## [2.0.1] - 2024-12-21
 
 ### Fixed
-
 - Removed non-existent conversion script reference from CHANGELOG migration guide
 - Updated parser to check for `@darkarts` annotations instead of `@voodocs`
 - Removed "incorrect format" examples from instruction files for cleaner documentation
 
 ### Changed
-
 - Simplified migration guide to manual-only approach
 - Updated all internal references from `@voodocs` annotation format to `@darkarts`
 - Instruction files now focus exclusively on `@darkarts` format without showing legacy examples
 
 ### Documentation
-
 - Clarified that v2.0.0+ is DarkArts-only (no migration tooling needed)
 - Emphasized distinction between Voodocs (product) and DarkArts (language)
 
@@ -110,21 +96,20 @@
 
 ## [2.0.0] - 2024-12-21
 
+
 ### 🚨 BREAKING CHANGES
 
-**Voodocs is now DarkArts-only!**
+**VooDocs is now DarkArts-only!**
 
 This major version removes support for natural language `@voodocs` annotations and focuses exclusively on the symbolic `@darkarts` format.
 
 ### Removed
-
 - **Natural language format (`@voodocs`)** - No longer supported
 - Parser no longer recognizes `@voodocs` tags
 - Generator no longer processes natural language annotations
 - Init wizard no longer offers format choice
 
 ### Changed
-
 - **DarkArts symbolic format is now the only format**
 - All annotations must use `@darkarts` tag
 - All annotations must use symbolic notation (⊢, ∂, ⚠, ⊳, ⊲, ⊨, ⚡, 🔒)
@@ -141,10 +126,9 @@ This major version removes support for natural language `@voodocs` annotations a
 
 ### Migration Guide
 
-Voodocs v2.0.0 only supports `@darkarts` symbolic format. If you have existing `@voodocs` annotations, you'll need to manually update them:
+VooDocs v2.0.0 only supports `@darkarts` symbolic format. If you have existing `@voodocs` annotations, you'll need to manually update them:
 
 **Before (v1.x):**
-
 ```typescript
 /**@voodocs
 module_purpose: "User service"
@@ -153,7 +137,6 @@ dependencies: ["database"]
 ```
 
 **After (v2.0):**
-
 ```typescript
 /**@darkarts
 ⊢{User service}
@@ -172,7 +155,6 @@ dependencies: ["database"]
 ## [1.0.7] - 2024-12-21
 
 ### Added
-
 - **Enhanced Init Wizard**: Complete interactive setup experience
   - Auto-detects project details (name, version, repository)
   - Generates AI instructions automatically
@@ -183,13 +165,11 @@ dependencies: ["database"]
   - Beautiful CLI interface with status icons and summaries
 
 ### Changed
-
 - `voodocs init` now includes full wizard experience
 - Wizard supports both fresh install and upgrade scenarios
 - Auto-detection of AI environment (Cursor, Claude)
 
 ### Fixed
-
 - Init command now properly integrates with instruct command
 - Upgrade path for users installing new versions
 
@@ -217,11 +197,11 @@ dependencies: ["database"]
 
 ### Testing
 
-| Test Case                                  | Status  |
-| ------------------------------------------ | ------- |
+| Test Case | Status |
+|-----------|--------|
 | Instructions directory included in package | ✅ Pass |
-| `voodocs instruct --list-templates`        | ✅ Pass |
-| `voodocs instruct --ai cursor`             | ✅ Pass |
+| `voodocs instruct --list-templates` | ✅ Pass |
+| `voodocs instruct --ai cursor` | ✅ Pass |
 
 ---
 
@@ -254,13 +234,13 @@ npm install -g @voodocs/cli@1.0.6
 
 ### Testing
 
-| Test Case                                | Status  |
-| ---------------------------------------- | ------- |
-| `voodocs instruct --list-templates`      | ✅ Pass |
-| `voodocs instruct --ai cursor`           | ✅ Pass |
-| `voodocs instruct --ai claude`           | ✅ Pass |
+| Test Case | Status |
+|-----------|--------|
+| `voodocs instruct --list-templates` | ✅ Pass |
+| `voodocs instruct --ai cursor` | ✅ Pass |
+| `voodocs instruct --ai claude` | ✅ Pass |
 | `voodocs instruct --output .cursorrules` | ✅ Pass |
-| AI auto-detection                        | ✅ Pass |
+| AI auto-detection | ✅ Pass |
 
 ---
 
@@ -281,34 +261,28 @@ This release fixes critical bugs that prevented documentation generation for Typ
 ### Fixed
 
 #### Issue 1: Annotation Parsing Failure
-
 **Problem:** The generator failed to recognize valid `@voodocs` or `@darkarts` annotations in TypeScript/JavaScript files.
 
 **Root Cause:** The `_extract_annotation` function only looked for Python docstring format (`"""@darkarts`), not TypeScript/JavaScript block comments (`/**@voodocs` or `/**@darkarts`).
 
 **Fix:**
-
 - Added regex pattern matching for TypeScript/JavaScript block comments
 - Support both `/**@voodocs` and `/**@darkarts` tags
 - Support both Python (`"""`) and JS/TS (`/**`) comment styles
 
 #### Issue 2: File Discovery Limitations
-
 **Problem:** When running `voodocs generate . ./docs` in a directory, the tool reported "No Python files found to process" even when TypeScript or Solidity files were present.
 
 **Root Cause:** The file discovery logic only looked for `.py` files.
 
 **Fix:**
-
 - Extended file discovery to include: `.py`, `.ts`, `.js`, `.jsx`, `.tsx`, `.sol`
 - Updated error message to list all supported extensions
 
 #### Issue 3: Natural Language Format Parsing
-
 **Problem:** YAML-style annotations (e.g., `module_purpose: "..."`, `dependencies: []`) were not being parsed correctly.
 
 **Fix:**
-
 - Added support for natural language format alongside symbolic format
 - Properly handle YAML-style lists with `-` markers
 - Clean up formatting and remove trailing comment markers
@@ -327,21 +301,20 @@ This release fixes critical bugs that prevented documentation generation for Typ
 
 All reported issues have been tested and verified:
 
-| Test Case                           | Status  |
-| ----------------------------------- | ------- |
-| TypeScript file with `/**@voodocs`  | ✅ Pass |
+| Test Case | Status |
+|-----------|--------|
+| TypeScript file with `/**@voodocs` | ✅ Pass |
 | TypeScript file with `/**@darkarts` | ✅ Pass |
-| Natural language format             | ✅ Pass |
-| Symbolic format                     | ✅ Pass |
-| Directory discovery (`.ts` files)   | ✅ Pass |
-| Multiple files in directory         | ✅ Pass |
+| Natural language format | ✅ Pass |
+| Symbolic format | ✅ Pass |
+| Directory discovery (`.ts` files) | ✅ Pass |
+| Multiple files in directory | ✅ Pass |
 
 ---
 
 ### Example: Now Working
 
 **File: test.ts**
-
 ```typescript
 /**@voodocs
 module_purpose: Test module
@@ -355,13 +328,11 @@ export function hello(name: string): string {
 ```
 
 **Command:**
-
 ```bash
 voodocs generate ./test.ts ./docs
 ```
 
 **Result:**
-
 ```markdown
 # test.ts
 
@@ -377,7 +348,6 @@ Node.js environment
 ### Upgrade Notes
 
 No breaking changes. Simply upgrade:
-
 ```bash
 npm install -g @voodocs/cli@1.0.4
 ```
@@ -395,14 +365,12 @@ This release adds the `voodocs instruct` command to automatically generate AI-sp
 ### Added
 
 #### `voodocs instruct` Command
-
 - **Auto-detects AI environment** (Cursor, Claude, Gemini, etc.)
 - **Generates tailored instructions** for each AI assistant
 - **Supports multiple output formats** (console or file)
 - **Lists available templates** with `--list-templates` flag
 
 **Usage:**
-
 ```bash
 voodocs instruct                    # Auto-detect and print instructions
 voodocs instruct --ai cursor        # Generate for specific AI
@@ -411,7 +379,6 @@ voodocs instruct --list-templates   # List available templates
 ```
 
 #### Updated Instruction Templates
-
 - **Symbolic DarkArts format** - All templates updated to use symbolic annotations
 - **Cursor template** - Tailored for Cursor AI
 - **Claude template** - Tailored for Claude AI
@@ -429,7 +396,6 @@ voodocs instruct --list-templates   # List available templates
 ### What This Means
 
 With `voodocs instruct`, you can now:
-
 1. Run the command in your project
 2. Get AI-specific instructions
 3. Add them to your `.cursorrules` or Claude project settings
@@ -461,7 +427,6 @@ voodocs instruct --output .cursorrules
 ### Upgrade Notes
 
 No breaking changes. Simply upgrade:
-
 ```bash
 npm install -g @voodocs/cli@1.0.3
 ```
@@ -477,7 +442,6 @@ This patch release fixes critical issues that prevented @voodocs/cli from workin
 ### Fixed
 
 #### 1. CLI Entry Point (ModuleNotFoundError)
-
 - **Fixed:** CLI entry point now correctly resolves symlinks for npm global installs
 - **Before:** `voodocs` command failed with `ModuleNotFoundError: No module named 'cli'`
 - **After:** Works correctly when installed globally via npm
@@ -485,7 +449,6 @@ This patch release fixes critical issues that prevented @voodocs/cli from workin
 - **Solution:** Added `.resolve()` to follow symlinks to actual package location
 
 #### 2. Missing `init` Command
-
 - **Fixed:** Implemented and registered the `voodocs init` command
 - **Before:** Command referenced in documentation but didn't exist
 - **After:** `voodocs init` creates `.voodocs.json` config and example files
@@ -496,14 +459,12 @@ This patch release fixes critical issues that prevented @voodocs/cli from workin
   - `--config-only` flag to skip example generation
 
 #### 3. Annotation Parsing Failure for TypeScript
-
 - **Fixed:** TypeScript parser now correctly identifies `/**@voodocs` and `/**@darkarts` blocks
 - **Before:** Parser looked for `/*@voodocs` (single asterisk) and failed to find annotations
 - **After:** Correctly matches JSDoc-style comments with `/**@voodocs` (double asterisk)
 - **Impact:** All TypeScript/JavaScript annotations now parse correctly
 
 #### 4. Inconsistent Terminology
-
 - **Fixed:** Standardized support for both `@voodocs` and `@darkarts` tags
 - **Before:** README used `@voodocs`, but CLI complained about missing `@darkarts`
 - **After:** Both tags are supported and documented
@@ -534,7 +495,6 @@ This patch release fixes critical issues that prevented @voodocs/cli from workin
 ### Testing
 
 All fixes have been tested and verified:
-
 - ✅ CLI entry point works with global npm install
 - ✅ `voodocs init` creates config and examples
 - ✅ TypeScript annotation parsing works correctly
@@ -568,14 +528,12 @@ This patch release fixes critical issues with the `voodocs darkarts convert` com
 ### Fixed
 
 #### 1. TypeScript/JavaScript Support
-
 - **Fixed:** Convert command now properly handles TypeScript and JavaScript files
 - **Before:** Only worked with Python files (`"""@voodocs`)
 - **After:** Supports Python (`"""@voodocs`), TypeScript/JavaScript (`/**@voodocs`)
 - **Impact:** Can now convert annotations in multi-language codebases
 
 #### 2. Preserve ALL Annotation Fields
-
 - **Fixed:** Now converts all annotation fields, not just module-level basics
 - **Before:** Only converted 3 fields (module_purpose, dependencies, assumptions) - lost 95% of documentation
 - **After:** Converts all fields:
@@ -585,7 +543,6 @@ This patch release fixes critical issues with the `voodocs darkarts convert` com
 - **Impact:** No data loss during conversion
 
 #### 3. Fixed Symbol Conversion (Word Boundaries)
-
 - **Fixed:** Symbol conversion now uses word boundaries to prevent mid-word replacements
 - **Before:** "authenticated" → "au⇒ticated", "verification" → "ver⇒ication"
 - **After:** Only replaces whole words/phrases
@@ -596,7 +553,6 @@ This patch release fixes critical issues with the `voodocs darkarts convert` com
 - **Impact:** No text corruption during conversion
 
 #### 4. Working --in-place Flag
-
 - **Fixed:** --in-place flag now properly modifies files
 - **Before:** Broken replacement logic, only worked for Python
 - **After:** Works for Python, TypeScript, JavaScript with proper syntax preservation
@@ -607,17 +563,14 @@ This patch release fixes critical issues with the `voodocs darkarts convert` com
 ### Additional Fixes
 
 #### Syntax Errors
-
 - Fixed 40+ files with unterminated string literals (`""""` → `"""`)
 - Files affected: types.py, exceptions.py, ai_detector.py, cli.py, and 36 more
 
 #### Missing Imports
-
 - Added missing `re` module import in cli_darkarts.py
 - Added missing `Language` enum import
 
 #### Complexity Serialization
-
 - Fixed ComplexityAnnotation object serialization
 - Now properly extracts time complexity string for output
 
@@ -630,7 +583,6 @@ This patch release fixes critical issues with the `voodocs darkarts convert` com
 **Lines Changed:** +418, -60
 
 **Core Changes:**
-
 - `lib/darkarts/cli_darkarts.py` - Complete rewrite of `cmd_darkarts_convert()`
 - `lib/darkarts/annotations/translator.py` - Fixed `natural_to_symbols()` and `create_darkarts_from_voodocs()`
 - Added `_replace_annotations_in_file()` helper function for proper file modification
@@ -640,7 +592,6 @@ This patch release fixes critical issues with the `voodocs darkarts convert` com
 ### Testing
 
 **Python Files:**
-
 ```bash
 voodocs darkarts convert test.py
 # ✅ Module + function annotations converted
@@ -649,7 +600,6 @@ voodocs darkarts convert test.py
 ```
 
 **TypeScript Files:**
-
 ```bash
 voodocs darkarts convert test.ts
 # ✅ TypeScript syntax recognized
@@ -658,7 +608,6 @@ voodocs darkarts convert test.ts
 ```
 
 **In-Place Modification:**
-
 ```bash
 voodocs darkarts convert test.py --in-place
 # ✅ File modified successfully
@@ -687,12 +636,11 @@ The convert command now works as originally intended with full multi-language su
 ---
 
 **Full Changelog:** https://github.com/3vilEnterprises/vooodooo-magic/compare/v1.0.0...v1.0.1
-
 ## [1.0.0] - 2024-12-21
 
 ### 🎉 Major Release: Validation Integration - The Only Documentation Tool That Validates Annotations
 
-This release transforms Voodocs from a documentation generator into a **production-ready validation tool** that guarantees annotation accuracy. Voodocs is now the only documentation tool that validates your annotations and guarantees accuracy.
+This release transforms VooDocs from a documentation generator into a **production-ready validation tool** that guarantees annotation accuracy. VooDocs is now the only documentation tool that validates your annotations and guarantees accuracy.
 
 ---
 
@@ -703,7 +651,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 **Four New CLI Commands:**
 
 1. **`voodocs validate`** - Validate @darkarts annotations for correctness
-
    - Semantic validation (dependencies match imports)
    - Performance validation (complexity claims verified)
    - Multiple output formats (text, json, html)
@@ -712,7 +659,6 @@ This release transforms Voodocs from a documentation generator into a **producti
    - Exit codes for automation
 
 2. **`voodocs fix`** - Automatically fix validation issues
-
    - Dry-run mode (preview changes)
    - Automatic backups before changes
    - Selective fixing (dependencies or performance)
@@ -720,7 +666,6 @@ This release transforms Voodocs from a documentation generator into a **producti
    - Rollback support
 
 3. **`voodocs benchmark`** - Benchmark performance to validate complexity claims
-
    - Configurable iterations
    - Multiple output formats (text, json, html)
    - HTML reports with detailed metrics
@@ -735,7 +680,6 @@ This release transforms Voodocs from a documentation generator into a **producti
    - Extracts all @darkarts sections
 
 **Validation Module:**
-
 - New module: `lib/darkarts/validation/` (13 files, ~2700 lines)
 - `semantic.py` - Semantic validation (dependencies vs imports)
 - `performance.py` - Performance tracking and complexity analysis
@@ -747,7 +691,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 - Wrapper modules for easy integration
 
 **CLI Infrastructure:**
-
 - New module: `lib/cli/` (5 files, ~960 lines)
 - Migrated from argparse to Click framework
 - Professional command structure
@@ -756,7 +699,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 - Rich output formatting
 
 **Features:**
-
 - ✅ **100% Annotation Coverage** - All 86 files validated
 - ✅ **Semantic Validation** - Dependencies match actual imports
 - ✅ **Performance Validation** - Complexity claims verified via static analysis
@@ -773,7 +715,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 **Comprehensive User Documentation:**
 
 1. **USER_GUIDE.md** (~800 lines)
-
    - Installation instructions
    - Quick start guide
    - Detailed command reference
@@ -782,14 +723,12 @@ This release transforms Voodocs from a documentation generator into a **producti
    - Troubleshooting section
 
 2. **API_REFERENCE.md** (~400 lines)
-
    - Core class documentation
    - Method signatures with examples
    - Data structure reference
    - Programmatic usage examples
 
 3. **TUTORIALS.md** (~500 lines)
-
    - First validation tutorial
    - Documentation generation tutorial
    - CI/CD setup tutorial
@@ -806,14 +745,12 @@ This release transforms Voodocs from a documentation generator into a **producti
 ### Testing
 
 **Comprehensive Test Suite:**
-
 - 11 new CLI integration tests (100% pass rate)
 - Test coverage: 7% (CLI commands only, as expected)
 - Validation module: 100% self-validation (dog-fooding)
 - All tests passing ✅
 
 **Test Coverage:**
-
 - `test_validate_command_valid_file` - Validates correct annotations
 - `test_validate_command_invalid_file` - Detects validation errors
 - `test_validate_command_json_output` - JSON format output
@@ -831,7 +768,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 ### Changed
 
 **CLI Structure:**
-
 - **Breaking Change**: Main CLI entry point changed from `cli.py` to `voodocs_cli.py`
 - Migrated from argparse to Click framework for better UX
 - All commands now have consistent option naming
@@ -839,14 +775,12 @@ This release transforms Voodocs from a documentation generator into a **producti
 - Better output formatting
 
 **Package Structure:**
-
 - Added `lib/cli/` directory for command implementations
 - Added `lib/darkarts/validation/` directory for validation module
 - Updated package.json to include new files
 - Updated bin entry point to `voodocs_cli.py`
 
 **Validation Coverage:**
-
 - Achieved 100% @darkarts annotation coverage (86/86 files)
 - Fixed 11 validation module files with incorrect complexity claims
 - Converted 4 @voodocs files to @darkarts format
@@ -857,7 +791,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 ### Fixed
 
 **Validation Issues:**
-
 - Fixed complexity claims in 11 validation module files
 - Corrected dependency declarations across codebase
 - Fixed validate.py complexity claim (O(n) → O(n²))
@@ -868,14 +801,12 @@ This release transforms Voodocs from a documentation generator into a **producti
 ### Performance
 
 **Validation Performance:**
-
 - Semantic validation: O(n) per file
-- Performance validation: O(n\*m) per file (n=lines, m=functions)
+- Performance validation: O(n*m) per file (n=lines, m=functions)
 - Benchmarking: O(n*m*k) (k=iterations)
 - Auto-fix: O(n) per file
 
 **Optimization:**
-
 - Static analysis for complexity detection
 - Efficient import parsing
 - Minimal overhead for validation
@@ -885,7 +816,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 ### Code Statistics
 
 **New Code:**
-
 - CLI code: 960 lines (4 commands)
 - Validation module: ~2700 lines (13 files)
 - Test code: 300+ lines (11 tests)
@@ -893,7 +823,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 - **Total: ~5900 lines**
 
 **Files Created:**
-
 - 5 CLI command files
 - 13 validation module files
 - 1 test file
@@ -908,11 +837,10 @@ This release transforms Voodocs from a documentation generator into a **producti
 **From 0.4.x to 1.0.0:**
 
 1. **CLI Entry Point Changed:**
-
    ```bash
    # Old (still works via npm bin)
    voodocs context init
-
+   
    # New commands available
    voodocs validate lib/ -r
    voodocs fix lib/ -r
@@ -921,25 +849,22 @@ This release transforms Voodocs from a documentation generator into a **producti
    ```
 
 2. **New Dependencies:**
-
    - Click >= 8.0.0 (for CLI framework)
    - All other dependencies remain the same
 
 3. **No Breaking Changes for Existing Features:**
-
    - All `voodocs context` commands work unchanged
    - All `voodocs darkarts` commands work unchanged
    - Existing annotations remain valid
 
 4. **Recommended Actions:**
-
    ```bash
    # Validate your codebase
    voodocs validate your_project/ -r
-
+   
    # Fix any issues
    voodocs fix your_project/ -r
-
+   
    # Generate documentation with validation
    voodocs generate your_project/ docs/ -r --validate
    ```
@@ -949,7 +874,6 @@ This release transforms Voodocs from a documentation generator into a **producti
 ### CI/CD Integration
 
 **GitHub Actions Example:**
-
 ```yaml
 name: Validate Annotations
 on: [push, pull_request]
@@ -959,14 +883,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - name: Install Voodocs
+      - name: Install VooDocs
         run: npm install -g @voodocs/cli
       - name: Validate
         run: voodocs validate lib/ -r --strict
 ```
 
 **Pre-commit Hook Example:**
-
 ```yaml
 repos:
   - repo: local
@@ -975,7 +898,7 @@ repos:
         name: Validate @darkarts annotations
         entry: voodocs validate
         language: system
-        args: ["-r", "--strict"]
+        args: ['-r', '--strict']
         pass_filenames: false
 ```
 
@@ -986,14 +909,12 @@ repos:
 **The Only Tool That Validates Annotations:**
 
 Other documentation tools:
-
 - ❌ Generate documentation from annotations
 - ❌ No validation of accuracy
 - ❌ Annotations can drift over time
 - ❌ Manual quality checking required
 
-Voodocs v1.0.0:
-
+VooDocs v1.0.0:
 - ✅ Generates documentation
 - ✅ Validates annotation accuracy
 - ✅ Auto-fixes issues
@@ -1001,14 +922,13 @@ Voodocs v1.0.0:
 - ✅ Guarantees accuracy
 - ✅ CI/CD integration
 
-**Voodocs is now the only documentation tool that validates your annotations and guarantees accuracy.**
+**VooDocs is now the only documentation tool that validates your annotations and guarantees accuracy.**
 
 ---
 
 ### Acknowledgments
 
 This release represents 4 phases of development:
-
 - **Phase 1**: Validation module structure
 - **Phase 2**: CLI integration
 - **Phase 3**: Core commands implementation
@@ -1031,7 +951,6 @@ All objectives achieved. All tests passing. Production ready.
 ## [0.4.2] - 2024-12-20
 
 ### Fixed
-
 - **npm package**: Added missing `cli_darkarts.py` to package files list
   - Fixes "ModuleNotFoundError: No module named 'darkarts.cli_darkarts'" error
   - DarkArts CLI commands now work correctly after npm install
@@ -1042,7 +961,6 @@ All objectives achieved. All tests passing. Production ready.
 ## [0.4.1] - 2024-12-20
 
 ### Fixed
-
 - **Python version compatibility**: Changed CLI shebang from `python3.11` to `python3` to support Python 3.7+ installations
   - Fixes "python3.11: not found" error on systems with Python 3.8, 3.9, 3.10, 3.12, 3.13, etc.
   - CLI now works with any Python 3.7+ version (matches package.json requirement)
@@ -1063,7 +981,6 @@ This release introduces **DarkArts**, a revolutionary symbolic documentation lan
 #### DarkArts Symbolic Documentation Language
 
 **The Innovation:**
-
 - **AI-native syntax** using mathematical symbols instead of verbose natural language
 - **70% compression** - Annotations are 3x more information-dense
 - **10x faster parsing** - AI understands symbols instantly
@@ -1071,7 +988,6 @@ This release introduces **DarkArts**, a revolutionary symbolic documentation lan
 - **Fully compatible** - Works alongside existing @voodocs annotations
 
 **Symbol Vocabulary:**
-
 - `⊢` - Module declaration
 - `∂` - Dependencies
 - `⚠` - Assumptions
@@ -1087,7 +1003,6 @@ This release introduces **DarkArts**, a revolutionary symbolic documentation lan
 - And 40+ more symbols for comprehensive documentation
 
 **Example:**
-
 ```python
 """@darkarts
 ⊢module:auth.validation
@@ -1100,7 +1015,6 @@ This release introduces **DarkArts**, a revolutionary symbolic documentation lan
 ```
 
 **Translates to:**
-
 ```python
 """@voodocs
 module_purpose: "Module auth.validation"
@@ -1116,14 +1030,12 @@ performance_model: "O(1) complexity"
 ```
 
 **New CLI Commands:**
-
 - `voodocs darkarts translate <file>` - Translate @darkarts to natural language
 - `voodocs darkarts convert <file>` - Convert @voodocs to @darkarts
 - `voodocs darkarts stats <dir>` - Show DarkArts usage statistics
 - `voodocs darkarts validate <dir>` - Validate @darkarts annotations
 
 **Implementation:**
-
 - New module: `lib/darkarts/annotations/symbols.py` (Symbol vocabulary and types)
 - New module: `lib/darkarts/annotations/darkarts_parser.py` (DarkArts annotation parser)
 - New module: `lib/darkarts/annotations/translator.py` (Bidirectional translator)
@@ -1131,20 +1043,17 @@ performance_model: "O(1) complexity"
 - Integration: `lib/darkarts/annotations/parser.py` (Auto-detect and translate @darkarts)
 
 **Testing:**
-
 - 18 comprehensive unit tests
 - 100% code coverage for new modules
 - Integration tests with context generation
-- Real-world usage: 12 files converted in Voodocs codebase
+- Real-world usage: 12 files converted in VooDocs codebase
 
 **Documentation:**
-
 - `lib/darkarts/annotations/DARKARTS_SYMBOLS.md` - Complete symbol reference
 - `lib/darkarts/annotations/TRANSFORMATION_EXAMPLES.md` - Real conversion examples
 - `UPGRADE_v0.4.0.md` - Upgrade guide with DarkArts introduction
 
 **Impact:**
-
 - **For AI:** Instant comprehension, no parsing overhead, unambiguous meaning
 - **For Humans:** Translate on demand, learn symbols gradually, optional adoption
 - **For Projects:** Mix @voodocs and @darkarts freely, no migration required
@@ -1154,7 +1063,6 @@ performance_model: "O(1) complexity"
 #### Professional Error Handling & UX (Phase A)
 
 **Error Handling Framework:**
-
 - New module: `lib/darkarts/context/errors.py` (10+ custom exception classes)
 - Every exception includes:
   - Clear error message with emoji (❌)
@@ -1162,7 +1070,6 @@ performance_model: "O(1) complexity"
   - User-friendly language (no jargon)
 
 **Custom Exceptions:**
-
 - `ContextFileNotFoundError` - With recovery suggestions
 - `InvalidContextError` - With validation guidance
 - `GitNotAvailableError` - With installation instructions
@@ -1173,7 +1080,6 @@ performance_model: "O(1) complexity"
 - And more...
 
 **Input Validation:**
-
 - New module: `lib/darkarts/context/validation.py` (8 validation functions)
 - `validate_project_name()` - Filesystem-safe names
 - `validate_version()` - Semantic versioning
@@ -1182,7 +1088,6 @@ performance_model: "O(1) complexity"
 - `validate_url()`, `validate_email()`, `validate_choice()` - And more
 
 **UI Utilities:**
-
 - New module: `lib/darkarts/context/ui.py` (Professional UI functions)
 - Colored output (success ✅, error ❌, warning ⚠️, info ℹ️)
 - Progress bars with tqdm
@@ -1192,7 +1097,6 @@ performance_model: "O(1) complexity"
 
 **Updated Commands:**
 All 12 context commands now have professional error handling:
-
 - `voodocs context init` - Validation, confirmations, step messages
 - `voodocs context view` - Error handling, file output validation
 - `voodocs context check` - Dependency checks, error handling
@@ -1207,7 +1111,6 @@ All 12 context commands now have professional error handling:
 - `voodocs context diagram` - Error handling, step messages
 
 **Impact:**
-
 - Users get helpful error messages instead of stack traces
 - Clear guidance on how to fix problems
 - Professional user experience
@@ -1218,14 +1121,12 @@ All 12 context commands now have professional error handling:
 #### Comprehensive Testing (Phase B)
 
 **Test Suite Expansion:**
-
 - **176 existing tests** (from previous versions)
 - **18 new tests** for DarkArts (100% coverage)
 - **Total: 194 tests**
 - **Overall coverage: 94%** (exceeded 80% goal by 14%)
 
 **New Test Files:**
-
 - `tests/unit/context/test_errors.py` (53 tests for error classes)
 - `tests/unit/context/test_validation.py` (63 tests for validation functions)
 - `tests/unit/context/test_ui.py` (60 tests for UI utilities)
@@ -1233,7 +1134,6 @@ All 12 context commands now have professional error handling:
 - `tests/test_darkarts_annotations.py` (18 tests for DarkArts system)
 
 **Coverage Breakdown:**
-
 - `errors.py`: 100% coverage
 - `validation.py`: 96% coverage
 - `ui.py`: 86% coverage
@@ -1242,13 +1142,11 @@ All 12 context commands now have professional error handling:
 - `translator.py`: 100% coverage
 
 **Test Infrastructure:**
-
 - pytest framework
 - pytest-cov for coverage reporting
 - Comprehensive test documentation (`tests/README.md`)
 
 **Quality Assurance:**
-
 - All tests passing ✅
 - No regressions
 - Production-ready code quality
@@ -1260,7 +1158,6 @@ All 12 context commands now have professional error handling:
 #### Module Model Bug (Critical Fix)
 
 **Problem:**
-
 ```python
 # Before: BROKEN
 modules_info[rel_path] = {
@@ -1271,7 +1168,6 @@ modules_info[rel_path] = {
 ```
 
 **Solution:**
-
 - New module: `lib/darkarts/context/module_utils.py` (Dedicated helper functions)
 - `detect_language()` - Auto-detect language from 20+ file extensions
 - `extract_public_api()` - Extract public functions/classes
@@ -1279,7 +1175,6 @@ modules_info[rel_path] = {
 - `extract_modules_from_results()` - Batch extraction
 
 **Result:**
-
 ```python
 # After: FIXED
 modules_info = extract_modules_from_results(results, scan_path)
@@ -1287,7 +1182,6 @@ modules_info = extract_modules_from_results(results, scan_path)
 ```
 
 **Impact:**
-
 - Context generation now works end-to-end
 - Complete module information (description, path, language, dependencies, public_api)
 - Auto-detect 20+ programming languages
@@ -1304,21 +1198,18 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 #### Context Generation Improvements
 
 **Enhanced Module Extraction:**
-
 - Now populates all 5 Module fields (was only 2)
 - Auto-detects programming language
 - Extracts public API automatically
 - Calculates relative paths correctly
 
 **DarkArts Integration:**
-
 - Context generation now supports @darkarts annotations
 - Automatic translation to @voodocs format
 - Seamless integration with existing parser
 - No configuration needed
 
 **Error Messages:**
-
 - All commands now have colored, helpful error messages
 - Progress indicators for long operations
 - User confirmations for destructive actions
@@ -1329,14 +1220,12 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 ### Documentation
 
 **New Documentation:**
-
 - `UPGRADE_v0.4.0.md` - Comprehensive upgrade guide
 - `lib/darkarts/annotations/DARKARTS_SYMBOLS.md` - Symbol reference (50+ symbols)
 - `lib/darkarts/annotations/TRANSFORMATION_EXAMPLES.md` - Real conversion examples
 - `tests/README.md` - Test suite documentation
 
 **Updated Documentation:**
-
 - `CHANGELOG.md` - This comprehensive changelog
 - `README.md` - Updated with DarkArts information (to be done)
 
@@ -1345,14 +1234,12 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 ### Performance
 
 **DarkArts Performance:**
-
 - 70% smaller annotations (3x compression)
 - 10x faster parsing for AI
 - Negligible overhead for translation
 - Same context generation speed
 
 **Module Extraction:**
-
 - O(1) for language detection
 - O(n) for public API extraction (n = number of functions/classes)
 - Minimal overhead added to context generation
@@ -1362,7 +1249,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 ### Code Statistics
 
 **Lines Added:**
-
 - DarkArts implementation: ~1,500 lines
 - Error handling framework: ~750 lines
 - Module utilities: ~500 lines
@@ -1371,14 +1257,12 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 - **Total: ~5,600 lines**
 
 **Files Created:**
-
 - 12 new Python modules
 - 5 new test files
 - 4 new documentation files
 - **Total: 21 new files**
 
 **Code Quality:**
-
 - 194 tests (all passing)
 - 94% code coverage
 - Professional error handling
@@ -1391,8 +1275,7 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 
 **Upgrading from v0.3.x:**
 
-1. Update Voodocs:
-
+1. Update VooDocs:
    ```bash
    npm update -g @voodocs/cli
    # or
@@ -1400,7 +1283,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
    ```
 
 2. Verify installation:
-
    ```bash
    voodocs --version  # Should show 0.4.0
    ```
@@ -1426,7 +1308,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 **No security issues fixed in this release.**
 
 **Security Model:**
-
 - DarkArts parser: Read-only, no code execution
 - Module extraction: Read-only, no file modification
 - Error handling: No sensitive data in error messages
@@ -1436,7 +1317,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 ### Contributors
 
 **Development:**
-
 - Error handling framework implementation
 - DarkArts language design and implementation
 - Module extraction refactoring
@@ -1444,7 +1324,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 - Documentation
 
 **Testing:**
-
 - 194 tests written and verified
 - 94% code coverage achieved
 - Real-world usage validation
@@ -1454,7 +1333,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 ### Acknowledgments
 
 **Special Thanks:**
-
 - To the AI community for inspiring DarkArts
 - To early adopters for feedback
 - To the open-source community for tools and libraries
@@ -1484,7 +1362,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 **Easy** - No breaking changes, 5-minute upgrade
 
 **Steps:**
-
 1. Update package (1 minute)
 2. Verify installation (1 minute)
 3. (Optional) Try DarkArts (3 minutes)
@@ -1496,7 +1373,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 ### What's Next?
 
 **Coming in v0.5.0:**
-
 - Documentation website
 - More DarkArts symbols for domain-specific use
 - Performance optimizations
@@ -1510,7 +1386,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 **v0.4.0 is a MAJOR release** that introduces revolutionary AI-native documentation while maintaining 100% backward compatibility.
 
 **Key Achievements:**
-
 - 🎉 World's first AI-native documentation language (DarkArts)
 - ✅ Professional error handling across all commands
 - 🧪 194 tests, 94% coverage
@@ -1519,7 +1394,6 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 - 🚀 Production-ready quality
 
 **Impact:**
-
 - **For AI:** Instant comprehension, no parsing overhead
 - **For Developers:** Better UX, helpful error messages
 - **For Projects:** Complete module information, working context generation
@@ -1538,22 +1412,19 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
 ## [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)
+- 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
+- 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
@@ -1569,34 +1440,28 @@ This patch fixes the hanging issue some users experienced at the AI selection pr
 #### AI-Aware Integration System
 
 **Native AI Assistant Integration**
-
 - Auto-detects existing AI configurations (Claude, Cursor, Copilot, Gemini, Junie)
 - Interactive menu for selecting AI assistant(s) during `voodocs context init`
 - Generates native configuration files for each AI assistant
 - Supports 5+ AI assistants with more coming
 
 **Supported AI Assistants:**
-
 1. **Claude Code** - Generates `.claude/skills/voodocs-context/SKILL.md` (2,341 chars)
-
    - Full skill with YAML frontmatter
    - On-demand context loading
    - Executable scripts support
 
 2. **Cursor** - Generates `.cursor/rules/voodocs-context.mdc` (2,560 chars)
-
    - Comprehensive rules file
    - Context system commands
    - Workflow best practices
 
 3. **GitHub Copilot** - Generates `.github/copilot-instructions.md` (1,981 chars)
-
    - Project-specific instructions
    - Context integration guide
    - Annotation format examples
 
 4. **Windsurf** - Generates `.windsurfrules` (1,180 chars)
-
    - Concise rules format
    - Essential commands
    - Quick reference
@@ -1607,7 +1472,6 @@ This patch fixes the hanging issue some users experienced at the AI selection pr
    - Context basics
 
 **Integration Features:**
-
 - Context system overview and commands
 - @voodocs annotation format (Python & TypeScript)
 - Development workflow best practices
@@ -1616,7 +1480,6 @@ This patch fixes the hanging issue some users experienced at the AI selection pr
 - AI-specific guidance and tips
 
 **User Experience:**
-
 - ✓ markers show detected AI configurations
 - Numbered menu for easy selection
 - Creates parent directories automatically
@@ -1625,30 +1488,26 @@ This patch fixes the hanging issue some users experienced at the AI selection pr
 - Can select individual AIs or all at once
 
 **Technical Implementation:**
-
 - New module: `ai_integrations.py` (685 lines)
 - Detection: `detect_ai_assistants()` function
 - Generation: AI-specific template functions
 - Integration: Updated `cmd_context_init()` command
 
 ### Changed
-
 - Enhanced `voodocs context init` with AI assistant detection and integration
 - Improved user prompts with visual markers for detected configurations
 - Updated next steps to include AI-specific guidance
 
 ### Documentation
-
 - Added AI integration research notes
 - Created comprehensive AI integration summary
 - Documented all supported AI assistant formats
 
 ### Impact
 
-This release makes Voodocs **truly AI-native**, working seamlessly with any AI assistant. The context system becomes the single source of truth that all AIs understand and respect.
+This release makes VooDocs **truly AI-native**, working seamlessly with any AI assistant. The context system becomes the single source of truth that all AIs understand and respect.
 
 **Key Benefits:**
-
 - One command sets up everything
 - Works with any AI assistant
 - Native format for each AI
@@ -1663,7 +1522,6 @@ This release makes Voodocs **truly AI-native**, working seamlessly with any AI a
 #### Context System - Phase 4: Verification & Visualization
 
 **Invariant Checking (`voodocs context check`)**
-
 - Automatically validate code against documented invariants
 - Pattern-based detection for 6 common security issues (SQL injection, unhashed passwords, logged secrets, etc.)
 - File and line number reporting for violations
@@ -1672,7 +1530,6 @@ This release makes Voodocs **truly AI-native**, working seamlessly with any AI a
 - Severity levels (error, warning, info)
 
 **Architecture Diagram Generation (`voodocs context diagram`)**
-
 - Auto-generate visual diagrams from context files
 - 3 diagram types: modules, dependencies, flow
 - Supports Mermaid and D2 formats
@@ -1680,7 +1537,6 @@ This release makes Voodocs **truly AI-native**, working seamlessly with any AI a
 - Console output or file export
 
 **Enhanced Validation (`voodocs context validate`)**
-
 - Smart suggestions for missing sections
 - Integrated invariant checking with `--check-invariants` flag
 - Completeness, quality, and consistency checks
@@ -1689,26 +1545,22 @@ This release makes Voodocs **truly AI-native**, working seamlessly with any AI a
 #### Context System - Phase 3: Auto-Generation & Query
 
 **Auto-Generation (`voodocs context generate`)**
-
 - Automatically extract context from @voodocs annotations
 - Recursively scans codebase for annotations
 - Extracts global invariants, assumptions, and modules
 - Supports multiple languages (Python, TypeScript, JavaScript, Java, C++, Go, Rust)
 
 **Query System (`voodocs context query`)**
-
 - Query context like a database using regex patterns
 - Section filtering and multiple output formats (text, JSON, YAML)
 
 **Git Integration**
-
 - Auto-detects Git commit hash and author
 - Integrated into `update` and `sync` commands
 
 #### Context System - Phase 2: Versioning & History
 
 **Version Management**
-
 - `voodocs context update`: Update context and increment version
 - `voodocs context sync`: Sync context with code version
 - `voodocs context history`: Show version history
@@ -1717,30 +1569,25 @@ This release makes Voodocs **truly AI-native**, working seamlessly with any AI a
 #### Context System - Phase 1: Foundation
 
 **Core Commands**
-
 - `voodocs context init`: Initialize .voodocs.context file
 - `voodocs context view`: View context as Markdown
 - `voodocs context status`: Show context file status
 
 ### Changed
-
 - Enhanced `voodocs context validate` with smart suggestions
 - Improved error messages and user feedback
 
 ### Documentation
-
 - Added comprehensive Phase 3 and Phase 4 implementation guides
 - Updated README with new context system commands
 - Added example architecture diagram
 
 ### Performance
-
 - Invariant checking: < 1 second for 15 files
 - Diagram generation: < 100ms + 1-2s for PNG rendering
 - Enhanced validation: < 50ms
 
 ### Code Statistics
-
 - Total Context System: 3,060 lines across 4 phases
 - 12 context commands implemented
 - 980 lines added in Phase 4
@@ -1748,24 +1595,20 @@ This release makes Voodocs **truly AI-native**, working seamlessly with any AI a
 ## [0.1.2] - 2025-12-19
 
 ### Fixed
-
 - Fixed bug in documentation generator where `class_invariants` was incorrectly referenced as `invariants` on line 570
 - Function-level invariants now render correctly in generated documentation
 
 ### Added
-
 - Comprehensive example file demonstrating function-level invariants (`examples/test_function_invariants.py`)
 - Examples showing `transfer_funds()`, `binary_search()`, and `BankAccount` class with invariants
 - Documentation in USAGE.md clarifying when to use `invariants` vs `class_invariants`
 - Real-world examples of conservation laws and state constraints using invariants
 
 ### Changed
-
 - Updated USAGE.md annotation fields table to clarify `invariants` usage
 - Added "Function with Invariants" and "Class with Invariants" examples to USAGE.md
 
 ### Documentation
-
 - Clarified that `invariants` can be used at function level for execution-time properties
 - Clarified that `class_invariants` should be used for object state constraints
 - Added examples showing both use cases
@@ -1775,25 +1618,22 @@ This release makes Voodocs **truly AI-native**, working seamlessly with any AI a
 ### Fixed
 
 **Critical Bug Fix:**
-
 - Fixed `ModuleNotFoundError: No module named 'darkarts.telemetry'` when using pnpm global installation
 - Improved symlink resolution in `cli.py` to handle both npm and pnpm directory structures
 - Now works correctly with npm, pnpm, and direct execution
 
 **Technical Details:**
-
 - pnpm uses a different symlink structure (`.pnpm/@voodocs+cli@version/node_modules/...`)
 - Previous path resolution only worked with npm's simpler symlink structure
 - New implementation properly resolves symlinks for both package managers
 
 **Affected Users:**
-
 - Users installing with `pnpm install -g @voodocs/cli`
 - npm users are unaffected (already working)
 
 # Changelog
 
-All notable changes to Voodocs will be documented in this file.
+All notable changes to VooDocs will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
@@ -1802,13 +1642,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### 🎉 Initial Release
 
-First public release of Voodocs - AI-native documentation for modern development.
+First public release of VooDocs - AI-native documentation for modern development.
 
 ### Added
 
 **Core Commands:**
-
-- `voodocs init` - Initialize Voodocs in a project with interactive prompts
+- `voodocs init` - Initialize VooDocs in a project with interactive prompts
 - `voodocs instruct` - Generate AI assistant instructions for 5 major AI coding assistants (Cursor, Claude Code, GitHub Copilot, Cody, Windsurf)
 - `voodocs generate` - Generate documentation, tests, and API specs from @voodocs annotations
 - `voodocs status` - Show project statistics and annotation coverage
@@ -1819,7 +1658,6 @@ First public release of Voodocs - AI-native documentation for modern development
 - `voodocs telemetry` - Control anonymous telemetry (enable/disable/status)
 
 **Documentation Generation:**
-
 - Mathematical notation translation (LaTeX → human-readable)
 - Support for Python and TypeScript
 - Multi-language output (English, Spanish, French, German, Chinese, Japanese)
@@ -1827,34 +1665,29 @@ First public release of Voodocs - AI-native documentation for modern development
 - Code examples and usage documentation
 
 **Test Generation:**
-
 - Property-based testing using Hypothesis (Python)
 - Automatic test case generation from @voodocs annotations
 - Support for pytest, unittest, and jest frameworks
 - Edge case detection and testing
 
 **API Specification:**
-
 - OpenAPI 3.0 spec generation
 - Swagger 2.0 support
 - GraphQL schema generation
 - Automatic endpoint documentation
 
 **Quality Tools:**
-
 - Annotation validation with detailed error messages
 - Coverage checking and reporting
 - Best practices recommendations
 - CI/CD integration templates (GitHub Actions, GitLab CI, pre-commit hooks)
 
 **Export Capabilities:**
-
 - HTML export with responsive design
 - PDF export with professional formatting
 - Customizable templates
 
 **Telemetry & Privacy:**
-
 - Anonymous usage analytics with Supabase backend
 - Privacy-respecting data collection (no PII)
 - Easy opt-out mechanism
@@ -1863,7 +1696,6 @@ First public release of Voodocs - AI-native documentation for modern development
 - Transparent privacy policy (PRIVACY.md)
 
 **Configuration:**
-
 - Project-level configuration via `.voodocs/config.json`
 - Customizable output directories
 - Language selection
@@ -1872,7 +1704,6 @@ First public release of Voodocs - AI-native documentation for modern development
 - Exclude/include patterns
 
 **Developer Experience:**
-
 - Interactive CLI with prompts
 - Comprehensive error messages
 - Detailed usage documentation (USAGE.md)
@@ -1882,33 +1713,28 @@ First public release of Voodocs - AI-native documentation for modern development
 ### Technical Details
 
 **Package:**
-
 - Size: 169.6 kB (compressed)
 - Unpacked size: 616.1 kB
 - Total files: 70
 - Zero dependencies (standalone)
 
 **Supported Languages:**
-
 - Python (≥3.7)
 - TypeScript (via compiled parser)
 - JavaScript (via TypeScript parser)
 
 **Supported Platforms:**
-
 - Linux
 - macOS
 - Windows
 
 **Requirements:**
-
 - Node.js ≥16.0.0
 - Python ≥3.7.0
 
 ### Architecture
 
 **DarkArts Language:**
-
 - Mathematical notation for AI-readable specifications
 - @voodocs annotation syntax
 - LaTeX-style mathematical expressions
@@ -1916,14 +1742,12 @@ First public release of Voodocs - AI-native documentation for modern development
 - Set theory notation
 
 **Plugin System:**
-
 - Extensible architecture
 - Custom generator support
 - Custom validator support
 - Custom exporter support
 
 **Parsers:**
-
 - Python AST parser
 - TypeScript/JavaScript parser (compiled)
 - Annotation extraction and validation
@@ -1949,7 +1773,7 @@ First public release of Voodocs - AI-native documentation for modern development
 - USAGE.md - Comprehensive user guide (350+ lines)
 - PRIVACY.md - Telemetry and privacy policy
 - NPM_PUBLISH_GUIDE.md - Publishing instructions
-- TELEMETRY\_\*.md - Telemetry implementation details
+- TELEMETRY_*.md - Telemetry implementation details
 
 ### Links
 
@@ -1963,7 +1787,6 @@ First public release of Voodocs - AI-native documentation for modern development
 ## [Unreleased]
 
 ### Planned for v0.2.0
-
 - Additional language support (Java, Go, Rust)
 - Web dashboard for analytics
 - Team collaboration features