@voodocs/cli 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,3 +1,208 @@
+## v1.0.2 (2024-12-21)
+
+### 🔧 Critical Bug Fixes
+
+This patch release fixes critical issues that prevented @voodocs/cli from working out of the box in standard environments.
+
+---
+
+### 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
+- **Root Cause:** `Path(__file__).parent` didn't resolve symlinks created by npm in `.bin/`
+- **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
+- **Features:**
+  - Creates configuration file with sensible defaults
+  - Generates example annotated files (TypeScript and Python)
+  - Supports both `@voodocs` and `@darkarts` formats
+  - `--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
+- **Changes:**
+  - Parser accepts both `/**@voodocs` and `/**@darkarts`
+  - CLI help text clarifies support for both formats
+  - README updated with current v1.0.2 functionality
+  - Outdated commands removed from documentation
+
+---
+
+### Added
+
+- **DarkArts Symbolic Format Guide:** New comprehensive guide at `docs/darkarts/DARKARTS_SYMBOLIC_GUIDE.md`
+- **Symbol Quick Reference:** Complete reference for all symbolic annotations
+- **Updated README:** Matches current v1.0.2 functionality with correct commands
+
+---
+
+### Improved
+
+- **Better Error Messages:** More helpful error messages when annotations are missing
+- **Documentation Accuracy:** All documentation now matches actual CLI functionality
+- **CI/CD Example:** Added GitHub Actions workflow example for validation
+
+---
+
+### 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
+- ✅ Both `@voodocs` and `@darkarts` tags are recognized
+
+---
+
+### Upgrade Notes
+
+If you're upgrading from v1.0.1:
+
+1. **No breaking changes** - All existing annotations continue to work
+2. **New `init` command** - Use `voodocs init` to set up new projects
+3. **Better TypeScript support** - Annotations will now be detected correctly
+4. **Both formats supported** - Use either `@voodocs` or `@darkarts` tags
+
+---
+
+### Known Issues
+
+None - all critical issues from v1.0.1 have been resolved.
+
+## v1.0.1 (2024-12-21)
+
+### 🔧 Bug Fixes: DarkArts Convert Command
+
+This patch release fixes critical issues with the `voodocs darkarts convert` command that were preventing proper conversion of @voodocs annotations to @darkarts format.
+
+---
+
+### 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:
+  - **Module-level:** module_purpose, dependencies, assumptions, invariants, security_model, performance_model (6 fields)
+  - **Function-level:** preconditions, postconditions, invariants, security_implications, complexity (5 fields)
+  - **Class-level:** invariants, assumptions (2 fields)
+- **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
+  - ✅ "authenticated" stays "authenticated"
+  - ✅ "exists" → "∃" (whole word only)
+  - ✅ "or" → "∨" (standalone only)
+  - ✅ "if and only if" → "⇔"
+- **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
+- **Impact:** Can safely convert files in place without manual editing
+
+---
+
+### 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
+
+---
+
+### Technical Details
+
+**Files Changed:** 45 files  
+**Commit:** 626bedb  
+**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
+
+---
+
+### Testing
+
+**Python Files:**
+```bash
+voodocs darkarts convert test.py
+# ✅ Module + function annotations converted
+# ✅ All fields preserved
+# ✅ Symbol conversion correct
+```
+
+**TypeScript Files:**
+```bash
+voodocs darkarts convert test.ts
+# ✅ TypeScript syntax recognized
+# ✅ Comment format preserved (/**@darkarts ... */)
+# ✅ No text corruption
+```
+
+**In-Place Modification:**
+```bash
+voodocs darkarts convert test.py --in-place
+# ✅ File modified successfully
+# ✅ Proper syntax maintained
+```
+
+---
+
+### Upgrade Notes
+
+No breaking changes. Simply update to v1.0.1:
+
+```bash
+npm install -g @voodocs/cli@1.0.1
+```
+
+The convert command now works as originally intended with full multi-language support and complete field preservation.
+
+---
+
+### Known Limitations
+
+- TypeScript parser doesn't extract function-level annotations yet (parser issue, not convert issue)
+- Convert command is ready when parser is enhanced
+
+---
+
+**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