@voodocs/cli 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,3 +1,96 @@
+## [0.3.1] - 2025-12-20
+
+### Fixed
+- Improved AI selection prompt handling in `voodocs context init`
+- Changed prompt text from '[6 for all]' to '[default: 6]' for clarity
+- Added EOFError and KeyboardInterrupt handling for graceful abort
+- Added sys.stdout.flush() to ensure prompt displays immediately
+- Better error messages for invalid input
+
+This patch fixes the hanging issue some users experienced at the AI selection prompt.
+
+## [0.3.0] - 2025-12-20
+
+### Added
+
+#### 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
+
+5. **Cline** - Generates `.clinerules` (806 chars)
+   - Minimal configuration
+   - Core workflow
+   - Context basics
+
+**Integration Features:**
+- Context system overview and commands
+- @voodocs annotation format (Python & TypeScript)
+- Development workflow best practices
+- Invariant checking instructions
+- Architecture diagram generation
+- AI-specific guidance and tips
+
+**User Experience:**
+- ✓ markers show detected AI configurations
+- Numbered menu for easy selection
+- Creates parent directories automatically
+- Handles existing files with overwrite prompt
+- Default: generate all integrations
+- 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.
+
+**Key Benefits:**
+- One command sets up everything
+- Works with any AI assistant
+- Native format for each AI
+- No manual configuration needed
+- Consistent AI behavior across teams
+- Context-aware development
+
 ## [0.2.0] - 2025-12-19
 
 ### Added

package/README.md

@@ -90,7 +90,7 @@ voodocs generate ./src --tests-only
 - `voodocs generate <path>`: Generate docs, tests, and API specs from annotations
 - `voodocs status`: Check project status and statistics
 
-### Context System (NEW in v0.2.0)
+### Context System (Enhanced in v0.3.0)
 - `voodocs context init`: Initialize project context file
 - `voodocs context generate`: Auto-generate context from code annotations
 - `voodocs context check`: Validate code against documented invariants
@@ -99,6 +99,27 @@ voodocs generate ./src --tests-only
 - `voodocs context query`: Query context like a database
 - `voodocs context view`: View context as Markdown
 
+### AI Integration (NEW in v0.3.0)
+
+VooDocs now **natively integrates** with 5+ AI assistants! When you run `voodocs context init`, it automatically:
+- Detects existing AI configurations (Claude, Cursor, Copilot, etc.)
+- Prompts you to select your AI assistant(s)
+- Generates native configuration files for each AI
+
+**Supported AI Assistants:**
+- **Claude Code** - `.claude/skills/voodocs-context/SKILL.md`
+- **Cursor** - `.cursor/rules/voodocs-context.mdc`
+- **GitHub Copilot** - `.github/copilot-instructions.md`
+- **Windsurf** - `.windsurfrules`
+- **Cline** - `.clinerules`
+
+Your AI will automatically understand the VooDocs context system and:
+- Check context before making changes
+- Respect documented invariants
+- Update context when adding features
+- Generate architecture diagrams
+- Follow best practices
+
 ## The DarkArts Language
 
 Voodocs uses the **DarkArts language** - a mathematical and logical notation system that represents how AI naturally thinks about code. Instead of forcing AI to write verbose human documentation, Voodocs lets AI express concepts precisely using:

package/cli.py

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