---
date: 2025-12-29
version: 1.8.0
previous_version: 1.7.2
release_type: minor
---

# Release v1.8.0

## Overview

**v1.8.0** is a minor release marking the transition of the default CLI entry point from v0 to v1, establishing v1 as the primary implementation while maintaining backward compatibility.

**Release Timeline**: v1.7.2 (2025-12-17) → v1.8.0 (2025-12-29)

---

## 📊 Release Statistics

| Metric | Value |
|--------|-------|
| **Total Commits** | 2 |
| **Code Changes** | ~5 lines modified |
| **Features** | 1 major change |
| **Files Modified** | 1 file |
| **Breaking Changes** | None - full backward compatibility |

---

## ✨ Primary Change: Default CLI Migration to v1

### Overview

The default `haniwers` command now uses the v1 CLI implementation. This marks the official transition from v0 (legacy) to v1 (next-generation) architecture, while maintaining full backward compatibility for existing users.

### Implementation Details

**Commit**: [`611b5f0`](https://gitlab.com/qumasan/haniwers/-/commit/611b5f0)

**Code Changes**:
- `pyproject.toml` - Updated CLI entry point (1 line)
  - `haniwers = "haniwers.v1.cli:app"` (changed from v0)

### CLI Entry Points

**After v1.8.0**:

| Command | Implementation | Use Case |
|---------|----------------|----------|
| `haniwers` | v1 (default) | Recommended for all new work |
| `haniwers-v1` | v1 (explicit) | Production-grade next-generation CLI |
| `haniwers-ng` | v1 (alias) | Next-generation shorthand |
| `haniwers-v0` | v0 (legacy) | Backward compatibility & maintenance |

### Compatibility

- ✅ **Backward Compatible**: v0 CLI remains available via `haniwers-v0` command
- ✅ **No Breaking Changes**: All v1.7.2 functionality preserved
- ✅ **Drop-in Replacement**: `haniwers` command usage unchanged

### Benefits

- ✅ Unified default CLI across all installations
- ✅ Users get v1's modern architecture by default
- ✅ Legacy v0 available for production systems needing stability
- ✅ Clear migration path for existing deployments

---

## 🔄 Migration Guide (v1.7.2 → v1.8.0)

### Breaking Changes

**None** - Full backward compatibility maintained

### For Existing Users

**No action required** - The `haniwers` command will automatically use v1 CLI.

If you prefer to explicitly use v0 for any reason:

```bash
# Continue using v0 (legacy)
haniwers-v0 --version
# Output: haniwers 1.8.0 (v0 implementation)
```

### For New Installations

The `haniwers` command now provides the modern v1 experience:

```bash
# Use modern v1 CLI (default)
haniwers --version
# Output: haniwers 1.8.0

haniwers daq --help
haniwers-v1 config init
```

### Verification Steps

```bash
# Verify default CLI points to v1
haniwers --version

# Test v1 CLI functionality
haniwers config show

# Verify v0 still available (if needed)
haniwers-v0 --version
```

---

## 📦 Installation

### PyPI

```bash
pip install haniwers==1.8.0
```

### From Source

```bash
git fetch origin
git checkout v1.8.0
poetry install
```

---

## 🙏 Contributors & Reviewers

This release represents the completion of the v1 migration effort, enabling:
- Modern CLI architecture as the default
- Improved user experience with v1 features
- Stable legacy v0 available for maintenance

---

## 📌 Known Issues & Limitations

None for this release - v1.8.0 is a smooth transition release.

---

## 🔗 Related Resources

- [v1 CLI Architecture](../developers/architecture.md)
- [v1.7.2 Release Notes](v1.7.2.md) - Previous features
- [Project Constitution](../../.specify/memory/constitution.md) - Development principles

---

## 🚀 Next Steps

### Planned for v1.9.0+

- Enhanced error handling refinements
- Additional CLI command optimizations
- Documentation updates based on user feedback

### Community Feedback

Please report issues at: https://gitlab.com/qumasan/haniwers/issues

---

**Release Date**: December 29, 2025
**Status**: ✅ Ready for Production
**Quality Gates**: All pre-commit checks passing, full backward compatibility verified