71 lines
1.4 KiB
Markdown
71 lines
1.4 KiB
Markdown
# Versioning Rules - VoIdea
|
|
|
|
**Date:** 2026-05-10
|
|
|
|
---
|
|
|
|
## Format
|
|
|
|
MAJOR.MINOR.PATCH (SemVer)
|
|
|
|
- MAJOR (X.0.0): breaking changes, full releases
|
|
- MINOR (0.X.0): new functionality, backward compatible
|
|
- PATCH (0.0.X): bug fixes
|
|
|
|
---
|
|
|
|
## CHANGELOG
|
|
|
|
Location: CHANGELOG/
|
|
- New file on X change: vX.0.md
|
|
- New file on Y change: vX.Y.md
|
|
- PATCH appended to existing file
|
|
|
|
Examples:
|
|
- CHANGELOG/v1.0.md (1.0.0 -> 1.0.5)
|
|
- CHANGELOG/v1.1.md (1.1.0 -> 1.1.3)
|
|
- CHANGELOG/v2.0.md (2.0.0 -> ...)
|
|
|
|
---
|
|
|
|
## Generation
|
|
|
|
Auto-generated by SpecAgent on version change.
|
|
|
|
---
|
|
|
|
## Agent Versioning
|
|
|
|
Each system agent is versioned independently (A.B.C).
|
|
|
|
### Rules
|
|
|
|
| Component | When | Who |
|
|
|-----------|------|-----|
|
|
| A (major) | Breaking change in public interface | EvolutionAgent |
|
|
| B (minor) | New capability (method, role, prompt) | EvolutionAgent |
|
|
| C (patch) | Internal fixes, no behavior change | Agent itself (auto) |
|
|
|
|
### Mechanism
|
|
|
|
1. Agent runs → `compute_checksum()` (SHA256 of `__file__`)
|
|
2. Compares with `AgentConfig.checksum` in DB
|
|
3. Mismatch → auto-bump patch → update changelog → save new checksum
|
|
4. EvolutionAgent handles minor/major bumps via capability analysis
|
|
|
|
### Storage
|
|
|
|
`CHANGELOG/agents/<agent_name>.md` — flat file, all history in one file.
|
|
|
|
Format:
|
|
```markdown
|
|
# audit_agent Changelog
|
|
|
|
## 1.0.2 (2026-05-10)
|
|
- Fixed: ruff output parsing for Windows paths
|
|
```
|
|
|
|
---
|
|
|
|
*Updated: 2026-05-10*
|