@voodocs/cli 2.1.3 → 2.2.1

package/CHANGELOG.md

@@ -1,19 +1,23 @@
 ## [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
 
@@ -23,11 +27,13 @@
 ## [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`
@@ -44,11 +50,13 @@
 - **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)
@@ -58,12 +66,14 @@
 ## [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
@@ -71,6 +81,7 @@
 - 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)
 
@@ -79,16 +90,19 @@
 ## [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)
 
@@ -96,20 +110,21 @@
 
 ## [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 (⊢, ∂, ⚠, ⊳, ⊲, ⊨, ⚡, 🔒)
@@ -126,9 +141,10 @@ 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"
@@ -137,6 +153,7 @@ dependencies: ["database"]
 ```
 
 **After (v2.0):**
+
 ```typescript
 /**@darkarts
 ⊢{User service}
@@ -155,6 +172,7 @@ 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
@@ -165,11 +183,13 @@ 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
 
@@ -197,11 +217,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 |
 
 ---
 
@@ -234,13 +254,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 |
 
 ---
 
@@ -261,28 +281,34 @@ 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
@@ -301,20 +327,21 @@ 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
@@ -328,11 +355,13 @@ export function hello(name: string): string {
 ```
 
 **Command:**
+
 ```bash
 voodocs generate ./test.ts ./docs
 ```
 
 **Result:**
+
 ```markdown
 # test.ts
 
@@ -348,6 +377,7 @@ Node.js environment
 ### Upgrade Notes
 
 No breaking changes. Simply upgrade:
+
 ```bash
 npm install -g @voodocs/cli@1.0.4
 ```
@@ -365,12 +395,14 @@ 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
@@ -379,6 +411,7 @@ 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
@@ -396,6 +429,7 @@ 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
@@ -427,6 +461,7 @@ voodocs instruct --output .cursorrules
 ### Upgrade Notes
 
 No breaking changes. Simply upgrade:
+
 ```bash
 npm install -g @voodocs/cli@1.0.3
 ```
@@ -442,6 +477,7 @@ 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
@@ -449,6 +485,7 @@ 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
@@ -459,12 +496,14 @@ 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
@@ -495,6 +534,7 @@ 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
@@ -528,12 +568,14 @@ 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:
@@ -543,6 +585,7 @@ 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
@@ -553,6 +596,7 @@ 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
@@ -563,14 +607,17 @@ 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
 
@@ -583,6 +630,7 @@ 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
@@ -592,6 +640,7 @@ 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
@@ -600,6 +649,7 @@ voodocs darkarts convert test.py
 ```
 
 **TypeScript Files:**
+
 ```bash
 voodocs darkarts convert test.ts
 # ✅ TypeScript syntax recognized
@@ -608,6 +658,7 @@ voodocs darkarts convert test.ts
 ```
 
 **In-Place Modification:**
+
 ```bash
 voodocs darkarts convert test.py --in-place
 # ✅ File modified successfully
@@ -636,11 +687,12 @@ 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.
 
 ---
 
@@ -651,6 +703,7 @@ 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)
@@ -659,6 +712,7 @@ 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)
@@ -666,6 +720,7 @@ 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
@@ -680,6 +735,7 @@ 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
@@ -691,6 +747,7 @@ 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
@@ -699,6 +756,7 @@ 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
@@ -715,6 +773,7 @@ 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
@@ -723,12 +782,14 @@ 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
@@ -745,12 +806,14 @@ 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
@@ -768,6 +831,7 @@ 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
@@ -775,12 +839,14 @@ 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
@@ -791,6 +857,7 @@ 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²))
@@ -801,12 +868,14 @@ 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
@@ -816,6 +885,7 @@ 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)
@@ -823,6 +893,7 @@ 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
@@ -837,10 +908,11 @@ 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
@@ -849,22 +921,25 @@ 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
    ```
@@ -874,6 +949,7 @@ 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]
@@ -883,13 +959,14 @@ 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
@@ -898,7 +975,7 @@ repos:
         name: Validate @darkarts annotations
         entry: voodocs validate
         language: system
-        args: ['-r', '--strict']
+        args: ["-r", "--strict"]
         pass_filenames: false
 ```
 
@@ -909,12 +986,14 @@ 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
@@ -922,13 +1001,14 @@ 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
@@ -951,6 +1031,7 @@ 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
@@ -961,6 +1042,7 @@ 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)
@@ -981,6 +1063,7 @@ 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
@@ -988,6 +1071,7 @@ This release introduces **DarkArts**, a revolutionary symbolic documentation lan
 - **Fully compatible** - Works alongside existing @voodocs annotations
 
 **Symbol Vocabulary:**
+
 - `⊢` - Module declaration
 - `∂` - Dependencies
 - `⚠` - Assumptions
@@ -1003,6 +1087,7 @@ This release introduces **DarkArts**, a revolutionary symbolic documentation lan
 - And 40+ more symbols for comprehensive documentation
 
 **Example:**
+
 ```python
 """@darkarts
 ⊢module:auth.validation
@@ -1015,6 +1100,7 @@ This release introduces **DarkArts**, a revolutionary symbolic documentation lan
 ```
 
 **Translates to:**
+
 ```python
 """@voodocs
 module_purpose: "Module auth.validation"
@@ -1030,12 +1116,14 @@ 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)
@@ -1043,17 +1131,20 @@ 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
@@ -1063,6 +1154,7 @@ 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 (❌)
@@ -1070,6 +1162,7 @@ performance_model: "O(1) complexity"
   - User-friendly language (no jargon)
 
 **Custom Exceptions:**
+
 - `ContextFileNotFoundError` - With recovery suggestions
 - `InvalidContextError` - With validation guidance
 - `GitNotAvailableError` - With installation instructions
@@ -1080,6 +1173,7 @@ 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
@@ -1088,6 +1182,7 @@ 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
@@ -1097,6 +1192,7 @@ 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
@@ -1111,6 +1207,7 @@ 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
@@ -1121,12 +1218,14 @@ 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)
@@ -1134,6 +1233,7 @@ 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
@@ -1142,11 +1242,13 @@ 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
@@ -1158,6 +1260,7 @@ All 12 context commands now have professional error handling:
 #### Module Model Bug (Critical Fix)
 
 **Problem:**
+
 ```python
 # Before: BROKEN
 modules_info[rel_path] = {
@@ -1168,6 +1271,7 @@ 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
@@ -1175,6 +1279,7 @@ modules_info[rel_path] = {
 - `extract_modules_from_results()` - Batch extraction
 
 **Result:**
+
 ```python
 # After: FIXED
 modules_info = extract_modules_from_results(results, scan_path)
@@ -1182,6 +1287,7 @@ 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
@@ -1198,18 +1304,21 @@ 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
@@ -1220,12 +1329,14 @@ 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)
 
@@ -1234,12 +1345,14 @@ 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
@@ -1249,6 +1362,7 @@ 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
@@ -1257,12 +1371,14 @@ 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
@@ -1275,7 +1391,8 @@ 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
@@ -1283,6 +1400,7 @@ Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, C#, Objective-C, Swift,
    ```
 
 2. Verify installation:
+
    ```bash
    voodocs --version  # Should show 0.4.0
    ```
@@ -1308,6 +1426,7 @@ 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
@@ -1317,6 +1436,7 @@ 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
@@ -1324,6 +1444,7 @@ 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
@@ -1333,6 +1454,7 @@ 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
@@ -1362,6 +1484,7 @@ 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)
@@ -1373,6 +1496,7 @@ 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
@@ -1386,6 +1510,7 @@ 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
@@ -1394,6 +1519,7 @@ 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
@@ -1412,19 +1538,22 @@ 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
@@ -1440,28 +1569,34 @@ 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
@@ -1472,6 +1607,7 @@ 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
@@ -1480,6 +1616,7 @@ 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
@@ -1488,26 +1625,30 @@ 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
@@ -1522,6 +1663,7 @@ 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
@@ -1530,6 +1672,7 @@ 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
@@ -1537,6 +1680,7 @@ 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
@@ -1545,22 +1689,26 @@ 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
@@ -1569,25 +1717,30 @@ 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
@@ -1595,20 +1748,24 @@ 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
@@ -1618,22 +1775,25 @@ 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).
@@ -1642,12 +1802,13 @@ 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
@@ -1658,6 +1819,7 @@ 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)
@@ -1665,29 +1827,34 @@ 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
@@ -1696,6 +1863,7 @@ 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
@@ -1704,6 +1872,7 @@ 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)
@@ -1713,28 +1882,33 @@ 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
@@ -1742,12 +1916,14 @@ 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
@@ -1773,7 +1949,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
 
@@ -1787,6 +1963,7 @@ 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