chore: v1.0.4-alpha - Homebrew v2 syntax and npm publishing ready

- Fixed Homebrew formula to use v2 syntax (removed deprecated bottle :unneeded)
- Updated formula templates with platform-specific install methods
- Enabled npm publish job in release workflow (bin/doplan.js ready)
- Updated documentation with Homebrew v2 syntax examples
- Updated package.json version to 1.0.4-alpha

Author: Test User

.github/workflows/release.yml

@@ -56,8 +56,7 @@ jobs:
     name: Publish to npm
     runs-on: ubuntu-latest
     needs: release
-    if: false  # Disabled until npm package structure is complete (bin/doplan.js needed)
-    # TODO: Enable once npm package structure is set up with bin/doplan.js
+    # npm package structure is ready (bin/doplan.js exists)
     steps:
       - name: Checkout code
         uses: actions/checkout@v4

CHANGELOG.md

@@ -7,14 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
-- CI/CD workflows for testing, linting, and building
-- Multi-platform builds (Linux, macOS, Windows)
-- Automated release process with GoReleaser
-- Homebrew tap support (pending repository setup)
-- PR checks workflow for automated quality gates
-- Coverage reporting with Codecov integration
-- Enhanced release automation with changelog generation
+## [1.0.4-alpha] - 2025-11-14
+
+### Fixed
+- **Homebrew v2 Syntax**: Updated Homebrew formula to use v2 syntax (removed deprecated `bottle :unneeded`)
+  - Platform-specific `install` methods inside each `on_macos` and `on_linux` block
+  - Added `Hardware::CPU.is_64_bit?` checks for Linux (v2 requirement)
+  - Updated formula templates in `Formula/doplan.rb` and setup scripts
+  - GoReleaser automatically generates v2-compliant formulas
+
+### Changed
+- **npm Publishing**: Enabled npm publish job in release workflow
+  - `bin/doplan.js` wrapper script is ready and verified
+  - npm package structure complete and ready for publishing
+  - Automated npm publishing will trigger on tag pushes (requires `NPM_TOKEN` secret)
+
+### Documentation
+- Updated `docs/development/HOMEBREW_SETUP.md` with Homebrew v2 syntax examples and notes
+- Added notes about GoReleaser's automatic v2 syntax generation
 
 ## [1.0.0] - 2025-11-14
 
@@ -108,6 +118,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Contribution guidelines
 - Release process documentation
 
-[Unreleased]: https://github.com/DoPlan-dev/CLI/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/DoPlan-dev/CLI/compare/v1.0.4-alpha...HEAD
+[1.0.4-alpha]: https://github.com/DoPlan-dev/CLI/releases/tag/v1.0.4-alpha
 [1.0.0]: https://github.com/DoPlan-dev/CLI/releases/tag/v1.0.0
 

Formula/doplan.rb

@@ -7,32 +7,43 @@ class Doplan < Formula
   homepage "https://github.com/DoPlan-dev/CLI"
   version "1.0.0"
   license "MIT"
-  bottle :unneeded
 
   on_macos do
     if Hardware::CPU.intel?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_darwin_amd64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256_AFTER_FIRST_RELEASE"
+
+      def install
+        bin.install "doplan"
+      end
     end
     if Hardware::CPU.arm?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_darwin_arm64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256_AFTER_FIRST_RELEASE"
+
+      def install
+        bin.install "doplan"
+      end
     end
   end
 
   on_linux do
-    if Hardware::CPU.intel?
+    if Hardware::CPU.intel? && Hardware::CPU.is_64_bit?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_linux_amd64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256_AFTER_FIRST_RELEASE"
+
+      def install
+        bin.install "doplan"
+      end
     end
-    if Hardware::CPU.arm?
+    if Hardware::CPU.arm? && Hardware::CPU.is_64_bit?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_linux_arm64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256_AFTER_FIRST_RELEASE"
-    end
-  end
 
-  def install
-    bin.install "doplan"
+      def install
+        bin.install "doplan"
+      end
+    end
   end
 
   test do

docs/development/HOMEBREW_SETUP.md

@@ -48,32 +48,43 @@ class Doplan < Formula
   homepage "https://github.com/DoPlan-dev/CLI"
   version "1.0.0"
   license "MIT"
-  bottle :unneeded
 
   on_macos do
     if Hardware::CPU.intel?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_darwin_amd64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
+
+      def install
+        bin.install "doplan"
+      end
     end
     if Hardware::CPU.arm?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_darwin_arm64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
+
+      def install
+        bin.install "doplan"
+      end
     end
   end
 
   on_linux do
-    if Hardware::CPU.intel?
+    if Hardware::CPU.intel? && Hardware::CPU.is_64_bit?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_linux_amd64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
+
+      def install
+        bin.install "doplan"
+      end
     end
-    if Hardware::CPU.arm?
+    if Hardware::CPU.arm? && Hardware::CPU.is_64_bit?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_linux_arm64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
-    end
-  end
 
-  def install
-    bin.install "doplan"
+      def install
+        bin.install "doplan"
+      end
+    end
   end
 
   test do
@@ -104,7 +115,7 @@ See [DoPlan CLI](https://github.com/DoPlan-dev/CLI) for documentation.
 
 ## GoReleaser Configuration
 
-The GoReleaser configuration (`.goreleaser.yml`) is already set up to automatically create PRs to the Homebrew tap repository:
+The GoReleaser configuration (`.goreleaser.yml`) is already set up to automatically create PRs to the Homebrew tap repository. GoReleaser will automatically generate Homebrew v2 syntax (without deprecated `bottle :unneeded`) with platform-specific install methods:
 
 ```yaml
 homebrew:
@@ -126,6 +137,11 @@ homebrew:
       bin.install "doplan"
 ```
 
+**Note:** GoReleaser automatically generates Homebrew v2 syntax with:
+- No deprecated `bottle :unneeded` directive
+- Platform-specific `install` methods inside each `on_macos` and `on_linux` block
+- Proper architecture checks (`Hardware::CPU.is_64_bit?` for Linux)
+
 ## GitHub Token Setup
 
 ### 1. Create Personal Access Token

package.json

@@ -1,6 +1,6 @@
 {
   "name": "doplan-cli",
-  "version": "1.0.0",
+  "version": "1.0.4-alpha",
   "description": "Project workflow automation tool that transforms app ideas into well-structured, documented, and trackable development projects",
   "main": "index.js",
   "bin": {

scripts/setup-homebrew-tap.sh

@@ -90,32 +90,43 @@ class Doplan < Formula
   homepage "https://github.com/DoPlan-dev/CLI"
   version "1.0.0"
   license "MIT"
-  bottle :unneeded
 
   on_macos do
     if Hardware::CPU.intel?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_darwin_amd64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
+
+      def install
+        bin.install "doplan"
+      end
     end
     if Hardware::CPU.arm?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_darwin_arm64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
+
+      def install
+        bin.install "doplan"
+      end
     end
   end
 
   on_linux do
-    if Hardware::CPU.intel?
+    if Hardware::CPU.intel? && Hardware::CPU.is_64_bit?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_linux_amd64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
+
+      def install
+        bin.install "doplan"
+      end
     end
-    if Hardware::CPU.arm?
+    if Hardware::CPU.arm? && Hardware::CPU.is_64_bit?
       url "https://github.com/DoPlan-dev/CLI/releases/download/v1.0.0/doplan_1.0.0_linux_arm64.tar.gz"
       sha256 "REPLACE_WITH_ACTUAL_SHA256"
-    end
-  end
 
-  def install
-    bin.install "doplan"
+      def install
+        bin.install "doplan"
+      end
+    end
   end
 
   test do