@guiho/mirror 3.0.0-alpha.9 → 3.0.0

package/CHANGELOG.md

@@ -1,16 +1,46 @@
-# Changelog
+# 🪞 GUIHO Mirror Changelog
 
-## 3.0.0-alpha.2 (2026-05-17)
+All notable changes to this project will be documented in this file.
 
-Initial open source release.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-### Features
+## [3.0.0] - 2026-05-17
 
-- TOML-based configuration with `mirror.config.toml`
-- Semantic versioning with `semver` support
-- Adapters for `package.json`, `jsr.json`, and Git tags
-- CLI with `mirror init`, `mirror config`, and `mirror version` commands
-- Dry-run mode, dirty worktree protection, and interactive confirmation
-- Text and JSON output formats
-- Git commit, tag, and push automation
-- Prerelease identifier support
+This release marks a major milestone as we prepare for the **initial open-source release** of GUIHO Mirror. We have completely overhauled the error handling experience, modernized the CI/CD publishing pipeline, and hardened the CLI commands for public usage.
+
+### ✨ Features
+
+- **TOML-Based Configuration**: Full support for `mirror.config.toml` for predictable, versionable configurations.
+- **Semantic Versioning Engine**: Powerful integration with `semver` for accurate version calculations across major, minor, patch, and prerelease identifiers.
+- **Multi-Adapter Support**: Seamlessly reads and writes version updates to `package.json`, `jsr.json`, and Git tags in a single synchronized operation.
+- **Comprehensive CLI**: 
+  - `mirror init` to scaffold new configurations.
+  - `mirror config` to inspect and validate schemas.
+  - `mirror version` to manage the lifecycle (current, next, plan, apply).
+- **Dry-Run & Plan Mode**: Output a transparent execution plan of what will happen before any mutations occur.
+- **Git Automation**: Automated creation of version bumps, commits, tags, and pushes directly from the CLI.
+- **Verbose Error Logging**: Added a new `--verbose` flag across the CLI. By default, errors are now clean, succinct, and user-friendly, with full stack traces hidden behind the verbose flag for better developer experience.
+- **Dynamic NPM Dist-Tags**: The publishing pipeline now dynamically parses prerelease identifiers (e.g., `alpha`, `beta`) and maps them to npm distribution tags automatically.
+
+### 🐛 Bug Fixes & Improvements
+
+- **Graceful Error Handling**: Completely reworked the error propagation from `citty`. Errors such as invalid targets (e.g. typos like `prerlease`) now fail gracefully with clear messages instead of dumping the raw Bun runtime stack trace.
+- **Dirty Worktree Protection**: The apply command now strictly blocks operations on dirty git worktrees unless explicitly bypassed, preventing accidental commits.
+- **Interactive Prompts**: Added safe interactive confirmations for applying versions, with a `--yes` flag to bypass for CI environments.
+- **NPM Authentication Conflict**: Resolved an issue in the GitHub Actions workflow where `npm publish` would fail due to `always-auth` configurations.
+
+### 🧹 Refactoring & Chores
+
+- **CI/CD Modernization**: Migrated away from legacy shell scripts (`build-test-publish.sh`) and Google Cloud Build (`cloudbuild.yaml`) in favor of a robust GitHub Actions workflow (`publish.yml`).
+- **NPM Registry Integration**: Added `actions/setup-node` to the workflow to securely handle NPM registry publishing alongside the primary Bun ecosystem.
+- **Cleaned Up Documentation**: Consolidated the `README.md` to the repository root for better visibility on GitHub, ensuring it is automatically copied to the distribution bundle upon publishing.
+
+---
+
+## [3.0.0-alpha.2] - 2026-05-17
+
+### Added
+- Initial structure for the v3 open-source release.
+- Baseline configuration schema and typescript types.
+- Initial support for JSON and Text output formats (`--format=json|text`).

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiho/mirror",
-  "version": "3.0.0-alpha.9",
+  "version": "3.0.0",
   "exports": "./source/guiho-mirror.ts",
   "publish": {
     "include": [

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@guiho/mirror",
   "description": "Open source project versioning for Bun, npm, JSR, and Git.",
-  "version": "3.0.0-alpha.9",
+  "version": "3.0.0",
   "type": "module",
   "main": "./library/guiho-mirror.js",
   "types": "./library/guiho-mirror.d.ts",
@@ -72,6 +72,7 @@
     "semver": "^7.8.0"
   },
   "devDependencies": {
+    "@guiho/mirror": "^3.0.0-alpha.9",
     "@types/bun": "1.3.3",
     "@types/semver": "^7.7.1",
     "typescript": "5.8.2"