@voodocs/cli 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,26 @@
1
+ # CHANGELOG
2
+
3
+ ## [2.0.1] - 2024-12-21
4
+
5
+ ### Fixed
6
+ - Removed non-existent conversion script reference from CHANGELOG migration guide
7
+ - Updated parser to check for `@darkarts` annotations instead of `@voodocs`
8
+ - Removed "incorrect format" examples from instruction files for cleaner documentation
9
+
10
+ ### Changed
11
+ - Simplified migration guide to manual-only approach
12
+ - Updated all internal references from `@voodocs` annotation format to `@darkarts`
13
+ - Instruction files now focus exclusively on `@darkarts` format without showing legacy examples
14
+
15
+ ### Documentation
16
+ - Clarified that v2.0.0+ is DarkArts-only (no migration tooling needed)
17
+ - Emphasized distinction between Voodocs (product) and DarkArts (language)
18
+
19
+ ---
20
+
1
21
  ## [2.0.0] - 2024-12-21
2
22
 
23
+
3
24
  ### 🚨 BREAKING CHANGES
4
25
 
5
26
  **VooDocs is now DarkArts-only!**
@@ -16,7 +16,7 @@ This module provides the command-line interface for VooDocs.
16
16
  import click
17
17
  from typing import Optional
18
18
 
19
- __version__ = "2.0.0"
19
+ __version__ = "2.0.1"
20
20
 
21
21
 
22
22
  @click.group()
@@ -1,7 +1,7 @@
1
1
  """@darkarts
2
2
  ⊢parser:annotations.multi-lang
3
3
  ∂{re,ast,pathlib,types}
4
- ⚠{src:utf8,@voodocs∈docstrings,yaml-lists,fs:readable}
4
+ ⚠{src:utf8,@darkarts∈docstrings,yaml-lists,fs:readable}
5
5
  ⊨{∀parse→¬modify-src,∀read→handle-encoding,parsed∈pyobj,dedup-invariants,lang-detect:accurate}
6
6
  🔒{read-only,¬exec}
7
7
  ⚡{O(n'*m/c)|n'=files-with-annotations,m=avg-file-size,c=cache-constant,speedup=5-10x}
@@ -681,10 +681,10 @@ class AnnotationParser:
681
681
  @staticmethod
682
682
  def _has_annotations(file_path: Path) -> bool:
683
683
  """
684
- Quick check if a file contains @voodocs annotations.
684
+ Quick check if a file contains @darkarts annotations.
685
685
 
686
686
  Phase 1 Optimization: Pre-filter files before full parsing.
687
- Reads only first 10KB to check for @voodocs marker.
687
+ Reads only first 10KB to check for @darkarts marker.
688
688
 
689
689
  Args:
690
690
  file_path: Path to the file to check
@@ -696,7 +696,7 @@ class AnnotationParser:
696
696
  with open(file_path, 'r', encoding='utf-8', errors='ignore') as f:
697
697
  # Read first 10KB (enough for module-level annotations)
698
698
  preview = f.read(10000)
699
- return '@voodocs' in preview
699
+ return '@darkarts' in preview
700
700
  except Exception:
701
701
  # If we can't read it, skip it
702
702
  return False
@@ -813,7 +813,7 @@ class AnnotationParser:
813
813
  return self._parse_generic(source_code, source_file, language, translated_annotations)
814
814
 
815
815
  def _darkarts_to_voodocs_yaml(self, annotation_dict: Dict[str, Any]) -> str:
816
- """Convert DarkArts annotation dict to @voodocs YAML format."""
816
+ """Convert DarkArts annotation dict to YAML format (legacy)."""
817
817
  lines = []
818
818
 
819
819
  # Module name becomes module_purpose (just use the identifier)
@@ -271,7 +271,7 @@ class DarkArtsTranslator:
271
271
 
272
272
  def create_darkarts_from_voodocs(self, voodocs_dict: Dict) -> str:
273
273
  """
274
- Create @darkarts annotation from @voodocs dictionary.
274
+ Create @darkarts annotation from dictionary (legacy conversion).
275
275
 
276
276
  Args:
277
277
  voodocs_dict: Dictionary with keys like 'module_purpose',
@@ -408,6 +408,6 @@ def translate_to_symbols(text: str) -> str:
408
408
 
409
409
 
410
410
  def convert_voodocs_to_darkarts(voodocs_dict: Dict) -> str:
411
- """Convert @voodocs dictionary to @darkarts annotation."""
411
+ """Convert dictionary to @darkarts annotation (legacy)."""
412
412
  translator = DarkArtsTranslator()
413
413
  return translator.create_darkarts_from_voodocs(voodocs_dict)
@@ -8,7 +8,7 @@
8
8
 
9
9
  DarkArts Annotation Types
10
10
 
11
- Data structures for parsed @darkarts/@voodocs annotations with:
11
+ Data structures for parsed @darkarts annotations with:
12
12
  - Annotation types (function, method, class, module)
13
13
  - Language support (Python, TypeScript, JavaScript, Java, C++, C#, Go, Rust)
14
14
  - Complexity annotations (time, space, best/worst/average case)
@@ -13,7 +13,7 @@ Your primary goal is to **write and maintain symbolic DarkArts annotations** for
13
13
 
14
14
  ## 2. Annotation Format: Symbolic DarkArts
15
15
 
16
- **Always use the symbolic DarkArts format.** Do not use the natural language `@voodocs` format.
16
+ **Always use the symbolic DarkArts format.** This is the only supported format in v2.0+.
17
17
 
18
18
  ### Correct Format
19
19
 
@@ -33,15 +33,6 @@ Your primary goal is to **write and maintain symbolic DarkArts annotations** for
33
33
  */
34
34
  ```
35
35
 
36
- ### Incorrect Format (Do Not Use)
37
-
38
- ```typescript
39
- /**@voodocs
40
- module_purpose: "..."
41
- dependencies: [...]
42
- */
43
- ```
44
-
45
36
  ---
46
37
 
47
38
  ## 3. Key Rules
@@ -13,7 +13,7 @@ Your primary goal is to **write and maintain symbolic DarkArts annotations** for
13
13
 
14
14
  ## 2. Annotation Format: Symbolic DarkArts
15
15
 
16
- **Always use the symbolic DarkArts format.** Do not use the natural language `@voodocs` format.
16
+ **Always use the symbolic DarkArts format.** This is the only supported format in v2.0+.
17
17
 
18
18
  ### Correct Format
19
19
 
@@ -33,15 +33,6 @@ Your primary goal is to **write and maintain symbolic DarkArts annotations** for
33
33
  */
34
34
  ```
35
35
 
36
- ### Incorrect Format (Do Not Use)
37
-
38
- ```typescript
39
- /**@voodocs
40
- module_purpose: "..."
41
- dependencies: [...]
42
- */
43
- ```
44
-
45
36
  ---
46
37
 
47
38
  ## 3. Key Rules
@@ -13,7 +13,7 @@ Your primary goal is to **write and maintain symbolic DarkArts annotations** for
13
13
 
14
14
  ## 2. Annotation Format: Symbolic DarkArts
15
15
 
16
- **Always use the symbolic DarkArts format.** Do not use the natural language `@voodocs` format.
16
+ **Always use the symbolic DarkArts format.** This is the only supported format in v2.0+.
17
17
 
18
18
  ### Correct Format
19
19
 
@@ -33,15 +33,6 @@ Your primary goal is to **write and maintain symbolic DarkArts annotations** for
33
33
  */
34
34
  ```
35
35
 
36
- ### Incorrect Format (Do Not Use)
37
-
38
- ```typescript
39
- /**@voodocs
40
- module_purpose: "..."
41
- dependencies: [...]
42
- */
43
- ```
44
-
45
36
  ---
46
37
 
47
38
  ## 3. Key Rules
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@voodocs/cli",
3
- "version": "2.0.0",
3
+ "version": "2.0.1",
4
4
  "description": "AI-Native Symbolic Documentation System - The world's first documentation tool using mathematical notation with semantic validation",
5
5
  "main": "voodocs_cli.py",
6
6
  "bin": {