Skip to content

Commit eb13c0e

Browse files
committed
docs: Add comprehensive CHANGELOG entries for v1.4 and v1.5
Added detailed documentation for two missing version releases: v1.5.0 (2025-11-05): - Semantic naming suggestions with 200+ action verbs - Cosine similarity matching in 4D semantic space - --suggest-names and --top-suggestions CLI flags - 35 new tests (59 total) - Example output showing intelligent name suggestions v1.4.0 (2025-11-03): - Configuration file support (.harmonizer.yml) - Self-healing refactoring engine - Dimensional split functionality - --suggest-refactor CLI flag - Enhanced AST parser with per-node mapping - Project restructure from src/ to harmonizer/ package Both versions include comprehensive technical details, examples, and explanations of their impact on the tool's capabilities. This brings the CHANGELOG up to date with the actual codebase state.
1 parent fa40894 commit eb13c0e

File tree

1 file changed

+147
-0
lines changed

1 file changed

+147
-0
lines changed

CHANGELOG.md

Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,153 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1111

1212
---
1313

14+
## [1.5.0] - 2025-11-05
15+
16+
### Added
17+
- **Semantic Naming Suggestions** 🎯 **(Major Feature)**
18+
- Intelligent function name suggestions based on execution semantics
19+
- 200+ action verbs mapped to LJWP coordinate space
20+
- Cosine similarity matching in 4D semantic space to find best name matches
21+
- Context-aware suggestions that extract nouns from function names
22+
- `--suggest-names` CLI flag to enable naming suggestions
23+
- `--top-suggestions N` flag to control number of suggestions (default: 3)
24+
- Suggestions show match percentage and semantic emphasis breakdown
25+
26+
- **Enhanced Test Coverage**
27+
- 35 new tests for semantic naming engine
28+
- Total test suite: 59 tests (all passing)
29+
- Tests validate coordinate normalization and accuracy
30+
- End-to-end CLI integration tests
31+
32+
- **Expanded Vocabulary**
33+
- 200+ action verbs covering all four dimensions:
34+
* Love domain: notify, inform, communicate, connect, share
35+
* Justice domain: validate, authorize, verify, enforce, check
36+
* Power domain: create, update, delete, transform, execute
37+
* Wisdom domain: analyze, calculate, search, measure, understand
38+
- Uses validated LJWP mixing formula from empirical testing
39+
40+
### Changed
41+
- Version bumped to 1.5
42+
- Updated README with v1.5 feature showcase
43+
- Updated test count badge (59 tests)
44+
- Enhanced CLI help text with new flags
45+
46+
### Technical Details
47+
- New file: `harmonizer/semantic_naming.py` (190+ lines)
48+
- New tests: `tests/test_semantic_naming.py` (373+ lines, 35 tests)
49+
- Modified: `harmonizer/main.py` (integrated naming suggestions)
50+
- SemanticNamingEngine uses cosine similarity for intelligent matching
51+
- Performance optimized with efficient vector calculations
52+
53+
### Example Output
54+
```
55+
delete_user: !! DISHARMONY (Score: 1.22)
56+
57+
💡 SUGGESTED FUNCTION NAMES (based on execution semantics):
58+
Function emphasizes: 50% love (connection/care), 50% wisdom (analysis/understanding)
59+
Suggestions:
60+
• notify_user (match: 85%)
61+
• inform_user (match: 82%)
62+
• communicate_user (match: 80%)
63+
```
64+
65+
### What This Means
66+
This feature transforms the Harmonizer from a **detector** to a **teacher**, providing actionable suggestions for better function names based on what the code actually does.
67+
68+
---
69+
70+
## [1.4.0] - 2025-11-03
71+
72+
### Added
73+
- **Configuration File Support** ⚙️ **(Major Feature)**
74+
- `.harmonizer.yml` file for project-specific configuration
75+
- File exclusion patterns (e.g., `tests/`, `venv/`, `*.pyc`)
76+
- Custom vocabulary extensions for domain-specific terms
77+
- Configuration documentation: `docs/CONFIGURATION.md`
78+
- Template file: `.harmonizer.yml.template`
79+
80+
- **Self-Healing Refactoring Engine** 🔧 **(Experimental Feature)**
81+
- Automated code refactoring suggestions based on dimensional analysis
82+
- Dimensional split functionality - splits mixed-concern functions
83+
- `--suggest-refactor` CLI flag to trigger refactoring suggestions
84+
- Generates refactored code that separates Love, Justice, Power, Wisdom concerns
85+
- AST-based code generation with proper formatting (Black integration)
86+
87+
- **Enhanced AST Parser**
88+
- Per-node dimensional mapping (every AST node mapped to dimension)
89+
- Granular semantic analysis for refactoring engine
90+
- Improved contextual awareness
91+
- Better handling of complex code structures
92+
93+
- **Project Restructure**
94+
- Moved from `src/` layout to root-level `harmonizer/` package
95+
- Improved import structure and module organization
96+
- Better compatibility with standard Python packaging
97+
98+
### Changed
99+
- Version bumped to 1.4
100+
- Added PyYAML dependency for configuration file parsing
101+
- Enhanced test suite with configuration and refactoring tests
102+
- README updated with configuration features
103+
104+
### Technical Details
105+
- New file: `harmonizer/refactorer.py` (90+ lines)
106+
- New tests: `tests/test_refactorer.py` (71+ lines)
107+
- Modified: `harmonizer/ast_semantic_parser.py` (enhanced dimensional mapping)
108+
- Modified: `harmonizer/main.py` (configuration loading, refactoring integration)
109+
- Added: `docs/CONFIGURATION.md` (70+ lines)
110+
- Added: `docs/META_ANALYSIS_V2.md` (113+ lines)
111+
112+
### Configuration Example
113+
```yaml
114+
# .harmonizer.yml
115+
exclude:
116+
- "venv/**"
117+
- "tests/**"
118+
- "*.pyc"
119+
120+
custom_vocabulary:
121+
authenticate: justice
122+
serialize: wisdom
123+
broadcast: love
124+
deploy: power
125+
```
126+
127+
### Refactoring Example
128+
```python
129+
# Before: Mixed-concern function
130+
def process_user(user):
131+
validate_email(user.email) # Justice
132+
user.save() # Power
133+
send_welcome_email(user.email) # Love
134+
log_registration(user) # Wisdom
135+
136+
# After: Dimensional split suggested by refactorer
137+
def _process_user_justice(user):
138+
validate_email(user.email)
139+
140+
def _process_user_power(user):
141+
user.save()
142+
143+
def _process_user_love(user):
144+
send_welcome_email(user.email)
145+
146+
def _process_user_wisdom(user):
147+
log_registration(user)
148+
149+
def process_user(user):
150+
_process_user_justice(user)
151+
_process_user_power(user)
152+
_process_user_love(user)
153+
_process_user_wisdom(user)
154+
```
155+
156+
### What This Means
157+
v1.4 introduces **configurability** and **automation** to the Harmonizer, allowing it to adapt to your project's needs and actively suggest improvements.
158+
159+
---
160+
14161
## [1.3.0] - 2025-11-01
15162
16163
### Added

0 commit comments

Comments
 (0)