@voodocs/cli 2.3.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # CHANGELOG
 
+## [2.4.0] - 2025-12-24
+
+### Added
+- **VooDocs Lite Format** - Ultra-compact symbolic notation with 27-30% token reduction
+  - New `voodocs convert` command to convert between Standard and Lite formats
+  - Single-character symbols (`>`, `@`, `!`, `<`, `=`, `~`, `#`) instead of Unicode
+  - Aggressive abbreviation dictionary (70+ common terms)
+  - Article removal and symbol replacements for maximum compression
+  - Bidirectional conversion (Standard ↔ Lite) with zero semantic loss
+  - Support for `@darkarts-lite` annotation format
+- **VooDocs Lite Parser** module (`lib/darkarts/voodocs_lite_parser.py`)
+  - `parse_lite()` - Parse Lite format annotations
+  - `parse_standard()` - Parse Standard format annotations
+  - `lite_to_standard()` - Convert Lite to Standard with expansion
+  - `standard_to_lite()` - Convert Standard to Lite with compression
+  - `detect_format()` - Auto-detect annotation format
+- **Ultra-Aggressive Compression** (`lib/darkarts/voodocs_lite_dict_v2.py`)
+  - `ultra_compress()` - Maximum compression with article removal
+  - `ultra_expand()` - Expand compressed text to full form
+  - 70+ abbreviations for common terms
+  - Symbol replacements (and→&, or→|, >=, <=, etc.)
+- **Comprehensive Test Suite** - 24 unit tests for VooDocs Lite functionality
+
+### Improved
+- Token efficiency for AI context (+27-30% reduction)
+- Scannability with single-character symbols
+- Format flexibility (choose Standard or Lite based on needs)
+- Backward compatibility (both formats supported)
+
+### Documentation
+- Added VooDocs Lite section to README.md
+- Added convert command documentation
+- Added format comparison examples
+- Added symbol mapping table
+
+---
+
 ## [2.3.0] - 2025-12-24
 
 ### Added

package/README.md

@@ -91,6 +91,80 @@ def authenticate_user(user_id: str, password: str) -> Optional[str]:
 
 ---
 
+## VooDocs Lite: Ultra-Compact Format
+
+**NEW in v2.4.0!** VooDocs Lite is an ultra-compact symbolic notation that reduces token count by **~30%** while maintaining all semantic information.
+
+### Why VooDocs Lite?
+
+- **Token Efficient**: 27-30% fewer tokens for AI context
+- **More Scannable**: Single-character symbols easier to read
+- **Same Information**: Zero semantic loss
+- **Bidirectional**: Convert between Standard and Lite freely
+
+### Format Comparison
+
+**Standard VooDocs:**
+```typescript
+/**@darkarts
+⊢{User authentication service with JWT token generation}
+∂{bcrypt, jsonwebtoken, database}
+⚠{Users must be stored in database}
+⊳{userId must be a valid UUID, password must be ≥8 characters}
+⊲{Returns JWT token ∨ null}
+⊨{Does ¬ modify database, Password is ¬ logged}
+⚡{O(1)}
+🔒{Password hashed with bcrypt, Token signed with secret}
+*/
+```
+**114 tokens**
+
+**VooDocs Lite:**
+```typescript
+/**@darkarts-lite
+>u auth svc w/ JWT tok gen
+@bcrypt,jsonwebtoken,database
+!us stored in db
+<id valid UUID, pw>=8 characters
+>ret JWT tok|N
+=!mod db, pw !logged
+~O(1)
+#pw hashed w/ bcrypt, tok signed w/ secret
+*/
+```
+**83 tokens** (27% reduction)
+
+### Symbol Mapping
+
+| Standard | Lite | Meaning |
+|----------|------|----------|
+| `⊢{}` | `>` | Purpose |
+| `∂{}` | `@` | Dependencies |
+| `⚠{}` | `!` | Assumptions |
+| `⊳{}` | `<` | Preconditions |
+| `⊲{}` | `>` | Postconditions |
+| `⊨{}` | `=` | Invariants |
+| `⚡{}` | `~` | Complexity |
+| `🔒{}` | `#` | Security |
+
+### Convert Between Formats
+
+```bash
+# Convert Standard to Lite
+voodocs convert src/ --to lite -r
+
+# Convert Lite to Standard
+voodocs convert src/ --to standard -r
+
+# Preview conversion
+voodocs convert src/ --to lite --dry-run
+
+# Modify files in-place
+voodocs convert src/ --to lite --in-place
+```
+
+---
+
 ## Companion Files for Compiled Languages
 
 **NEW in v2.3.0!** For compiled languages like Solidity, Rust, or C++ where inline annotations may interfere with compilation, VooDocs supports **companion documentation files**.
@@ -262,6 +336,18 @@ voodocs companion contracts/ --dry-run  # Preview changes
 voodocs companion contracts/ --force    # Overwrite existing
 ```
 
+### `voodocs convert`
+
+Convert between Standard and Lite VooDocs formats:
+
+```bash
+voodocs convert src/ --to lite      # Convert to Lite format
+voodocs convert src/ --to standard  # Convert to Standard format
+voodocs convert src/ --to lite -r   # Recursive conversion
+voodocs convert src/ --to lite --dry-run  # Preview changes
+voodocs convert src/ --to lite --in-place # Modify files in-place
+```
+
 ### `voodocs generate`
 
 Generate documentation from annotations:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voodocs/cli",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "AI-Native Symbolic Documentation System - The world's first documentation tool using mathematical notation with semantic validation",
   "main": "voodocs_cli.py",
   "bin": {