@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 +21 -0
- package/lib/cli/__init__.py +1 -1
- package/lib/darkarts/annotations/parser.py +5 -5
- package/lib/darkarts/annotations/translator.py +2 -2
- package/lib/darkarts/annotations/types.py +1 -1
- package/lib/darkarts/instructions/claude.md +1 -10
- package/lib/darkarts/instructions/cursor.md +1 -10
- package/lib/darkarts/instructions/default.md +1 -10
- package/package.json +1 -1
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!**
|
package/lib/cli/__init__.py
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"""@darkarts
|
|
2
2
|
⊢parser:annotations.multi-lang
|
|
3
3
|
∂{re,ast,pathlib,types}
|
|
4
|
-
⚠{src:utf8,@
|
|
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 @
|
|
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 @
|
|
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 '@
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.**
|
|
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.**
|
|
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.**
|
|
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