# v1.9.1 - Taskfile Alignment & Development Workflow Enhancement (2025-12-29)

## What Changed?

This release improves development workflow consistency by aligning the Taskfile.yml with the `kazunoko` project structure.
New environment management tasks enable developers to set up and maintain their development environment more easily. The release also introduces release note creation tooling and git management commands for streamlined workflows.

---

## What's New

### Environment Management Tasks

**What it does**:
Simplifies development environment setup and cleanup with unified task commands.

**How to use it**:

```bash
# Set up entire development environment (install deps + pre-commit hooks)
task env:setup

# Clean cached files and build artifacts
task env:clean
```

### Git Management Tasks

**What it does**:
Provides quick access to git operations for v1 branch development.

**How to use it**:

```bash
task status      # Show git status
task log         # Display last 10 commits
task push        # Push v1 branch to remote
task push:tags   # Push with git tags
```

### Enhanced Pre-commit Hooks Management

**What it does**:
Expands pre-commit hook operations with setup, update, and uninstall capabilities.

**How to use it**:
```bash
task pre-commit:setup       # Install pre-commit hooks
task pre-commit:update      # Update hooks to latest versions
task pre-commit:uninstall   # Remove pre-commit hooks
task pre-commit             # Run hooks on all files
```

### Release Note Creation

**What it does**:
Automates release note file creation from template with standardized structure.

**How to use it**:

```bash
task docs:release -- v1.9.1
# Creates docs/releases/v1.9.1.md from template
```

---

## Installation

### Quick Start

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

# Setup development environment
task env:setup

# Run tests to verify
task test
```

---

## What's Different from the Last Version?

### ✅ Added

- `env:setup` and `env:clean` tasks for development environment management
- `status`, `log`, `push`, and `push:tags` git management tasks
- `pre-commit:setup`, `pre-commit:update`, and `pre-commit:uninstall` tasks
- `deps:setup` task for poetry dependency installation
- `docs:release` task for automated release note creation
- CLAUDE.md documentation on worktree structure (v0, v1, main/v2 branches)

### 🔧 Changed

- Pre-commit hook management renamed to use consistent `:setup` suffix
- Development workflow documentation updated in CLAUDE.md with branch strategy
- Taskfile.yml section headers standardized to match kazunoko project format

### 🐛 Fixed

- N/A (maintenance release)

---

## Is It Safe to Upgrade?

**Backward Compatible**: Yes

- All new tasks are additive and do not break existing functionality
- Existing task names remain unchanged (except internal `:setup` naming convention)
- Deprecated tasks maintain backward compatibility
- No API changes or breaking changes

---

## Tests Passed

- ✅ Builds without errors
- ✅ Pre-commit hooks validation
- ✅ Taskfile YAML validation
- ✅ Task descriptions and help text verification

---

## Release Details

- **Date**: 2025-12-29
- **Version**: v1.9.1
- **Files Changed**: 4 (CLAUDE.md, Taskfile.yml, pyproject.toml, src/haniwers/__init__.py)
- **Commits**:
  - `09ef993` docs(claude): Add worktree structure and development strategy
  - `f4f285b` feat(taskfile): Add environment setup/clean and kazunoko-aligned tasks
  - `a4e01c0` feat(taskfile): Add git management tasks (status, log, push)
  - `adc3016` feat(taskfile): Update pre-commit tasks and add docs:release
  - `b9a7478` bump: version 1.9.0 → 1.9.1

---

## Next Steps

- Merge v1 improvements to main (v2) branch
- Continue refactoring and modernizing v1 architecture
- Align v0 maintenance documentation with current practices