# v1.9.2 - v2 Foundation and CLI Entry Point (2025-12-29)

## What Changed?

This release introduces the v2 entry point for next-generation cosmic ray detection analysis. v2 represents a major architectural overhaul with simplified CLI commands (measure, convert) replacing the complex v1 command structure.
The v1 CLI remains available for backward compatibility.

---

## What's New

### Main Feature: v2 CLI Entry Point

**What it does**:
Introduces the next-generation v2 command-line interface with simplified, purpose-driven commands.
The v2 CLI features two core commands: `measure` for data acquisition and `convert` for data processing.

**How to use it**:

```bash
# Show v2 version
poetry run haniwers-v2 version

# Measure cosmic ray data (placeholder - implementation pending)
poetry run haniwers-v2 measure

# Convert data format (placeholder - implementation pending)
poetry run haniwers-v2 convert
```

**Architecture**:

- v2 uses independent implementation from v1
- Simplified command structure for better user experience
- Foundation for next-generation features with `kazunoko` (measurement) and `datemaki` (conversion)

---

## Installation

### Quick Start

```bash
# Get the release
git checkout v1.9.2

# Setup
task env:setup

# Run CLI
poetry run haniwers-v2 --help
```

---

## What's Different from the Last Version?

### ✅ Added

- v2 CLI entry point with `version`, `measure`, and `convert` commands
- v2 package at `src/haniwers/v2/` with version 2.0.0
- `haniwers-v2` command-line entry point in pyproject.toml
- v2 support in haniwers-ng unified CLI

### 🔧 Changed

- v2 placeholders for `measure` and `convert` commands (awaiting implementation)

### 🐛 Fixed

- None (foundation release)

---

## Is It Safe to Upgrade?

**Backward Compatible**: Yes

- v1 CLI remains fully functional and unchanged
- v2 is a new optional entry point
- No breaking changes to existing v1 functionality

---

## Tests Passed

- ✅ Builds without errors
- ✅ `poetry run haniwers-v2 --help` works
- ✅ `poetry run haniwers-v2 version` displays v2 version (2.0.0)
- ✅ Pre-commit hooks passed

---

## Release Details

- **Date**: 2025-12-29
- **Version**: v1.9.2
- **Files Changed**: 6 files
- **Commits**: 5126f8b, 7546cf1, 6fdc291, 39ff960

---

## Next Steps

- Implement v2 `measure` command integration with `kazunoko` measurement framework
- Implement v2 `convert` command integration with `datemaki` data conversion framework
- Migrate v1 advanced features to v2 as needed
- Plan v0 deprecation and removal from main branch