chore(release): merge release/v0.4.x into main

Author: antonbelev

CHANGELOG.md

@@ -8,6 +8,98 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ---
 
 
+## [0.4.0](https://github.com/antonbelev/claude-owl/compare/v0.1.3...v0.4.0) (2025-12-09)
+
+
+### ⚠ BREAKING CHANGES
+
+* PathService methods now enforce explicit projectPath when
+location='project'. This prevents reliance on process.cwd() which returns
+incorrect paths when Claude Owl is launched from Start Menu on Windows.
+
+Core Implementation:
+- Platform-aware CLI detection (where vs which)
+- Windows PATH handling with semicolon separator
+- MCP cmd /c wrapper for npx commands on Windows
+- Managed settings path refactoring with path.join()
+- Debug logs path validation for Windows
+- Removed process.cwd() fallback per design constraint
+
+Windows-Specific Changes:
+- ClaudeService: Uses 'where' command on Windows, handles multiple paths
+- ClaudeService: Adds Windows paths (Program Files, AppData/npm, System32)
+- ClaudeService: Wraps npx stdio commands with 'cmd /c' on Windows
+- SettingsService: Uses ProgramData env var for managed settings
+- PathService: Validates APPDATA env var, logs Windows debug path
+- PathService: Enforces projectPath requirement with TypeScript overloads
+
+Testing:
+- Added 34+ Windows-specific unit tests
+- All existing tests passing (324 total)
+- TypeScript strict mode compliance
+- Production build verified
+
+Files Modified:
+- src/main/services/ClaudeService.ts
+- src/main/services/SettingsService.ts
+- src/main/services/core/PathService.ts
+- tests/unit/services/*.windows.test.ts (new)
+
+References: ADR-007, Claude Code docs (mcp, settings)
+Phase 1-2 Complete. Phase 3-4 (hooks, CI/CD) pending user testing.
+
+### ♻️ Code Refactoring
+
+* **gh-pages:** Extract header navigation into shared component ([7778a47](https://github.com/antonbelev/claude-owl/commit/7778a474fb928f76fda4efa3b8c1af44bd5ce209))
+
+
+### 🐛 Bug Fixes
+
+* add version badge to all pages and load version script ([0a92ac7](https://github.com/antonbelev/claude-owl/commit/0a92ac781bddfd7116f27791dcf31da098b0fc8d))
+* **build:** disable Windows code signing to fix packaging errors ([412ea4c](https://github.com/antonbelev/claude-owl/commit/412ea4c96cc58af55b6bc6a8cc8c81230cf7bcdb))
+* **ci:** disable auto code signing discovery for unsigned macOS builds ([5faa180](https://github.com/antonbelev/claude-owl/commit/5faa1806be6d359e172e6ef182c877946ee0892a))
+* **deps:** revert glob to v10.5.0 for Node.js 18 compatibility ([922429c](https://github.com/antonbelev/claude-owl/commit/922429cfdf82a429d6f25d4b10f1813ad972cd9e))
+* **gh-pages:** Embed header HTML inline to support local file:// testing ([d90683a](https://github.com/antonbelev/claude-owl/commit/d90683a173aecc265bc0c3850d0a21d5c27e3651))
+* **gh-pages:** Fix version badge and console errors on non-home pages ([a7fc618](https://github.com/antonbelev/claude-owl/commit/a7fc6188c54483a7f585a0459d81aed8712304e9))
+* **mac:** use identity null to completely disable code signing ([cad049a](https://github.com/antonbelev/claude-owl/commit/cad049a5027d210f9ac5e06b0c85a9faad0e03c3))
+* **metrics:** improve ModelBreakdownChart Y-axis formatting ([25b3275](https://github.com/antonbelev/claude-owl/commit/25b3275eb28d07f1449642f316eb9cba187a67da))
+* **metrics:** increase Y-axis label padding ([1ff5c7a](https://github.com/antonbelev/claude-owl/commit/1ff5c7a5311146eb0d9b73a5c189b954f30f7b2a))
+* remove unnecessary escape characters in regex patterns ([4a681c2](https://github.com/antonbelev/claude-owl/commit/4a681c29b9e785b6d5e00f8edd960f2cd2117578))
+* **security:** implement critical security fixes for Electron configuration and URL validation ([e00a8c0](https://github.com/antonbelev/claude-owl/commit/e00a8c0e7838bb3a587140b66d7f7e48392d372d))
+* **security:** update glob to patched version 10.5.0/11.1.0 to address CVE-2025-64756 ([37e4d8e](https://github.com/antonbelev/claude-owl/commit/37e4d8e2bb8c5e6d3f89ec4e9be04f555983aa4e))
+* show only model label in dropdown trigger, description in menu ([1a839a4](https://github.com/antonbelev/claude-owl/commit/1a839a492b06ec9ba4f426faacdbf1c456e2ac42))
+* simplify Windows platform tests to focus on cross-platform logic ([f091f27](https://github.com/antonbelev/claude-owl/commit/f091f27823a7385f34100bdf22d6f4b7686823fd))
+* **types:** use conditional spread for optional icon property ([a0fb77f](https://github.com/antonbelev/claude-owl/commit/a0fb77fc107120f7bb0d47b7e40a0955c580cf12))
+* **windows:** detect Claude in .local\bin and add installer icons ([c884a0d](https://github.com/antonbelev/claude-owl/commit/c884a0d474426105b08d6f5161a94a9d6a9f215d))
+* **windows:** embed icon into executable using afterPack hook ([aba7d38](https://github.com/antonbelev/claude-owl/commit/aba7d38459cf86528867da8d318e481814c64fcf))
+
+
+### 📚 Documentation
+
+* add ADR-008 for native usage metrics and analytics system ([ee66448](https://github.com/antonbelev/claude-owl/commit/ee6644848f70fc25fa31307af8f8832257eeb3a0))
+* add Anthropic disclaimer to README and homepage ([1060a0d](https://github.com/antonbelev/claude-owl/commit/1060a0ddb2cbfe39736b04417005bbda59cefc4e))
+* add macOS installation workaround and BETA indicators ([d85c8c5](https://github.com/antonbelev/claude-owl/commit/d85c8c5fa02e631bea6a59166134b3203d79ecf5))
+* add Usage Metrics dashboard section to screenshots page ([72e49c3](https://github.com/antonbelev/claude-owl/commit/72e49c3b6d25088f312a70ed316c1bfe177c9ae2))
+* add Windows support to website and installation guide ([2691d16](https://github.com/antonbelev/claude-owl/commit/2691d16594b785fb89d400482d765d891f5690bc))
+* **adr-008:** refocus Phase 0 as MVP with live charts ([895b826](https://github.com/antonbelev/claude-owl/commit/895b8268f68032c5dab1eab088168b3c55a44a67))
+* **adr:** add ADR-007 comprehensive Windows support gaps analysis and remediation strategy ([f9896d0](https://github.com/antonbelev/claude-owl/commit/f9896d0c89bc3beb0e0d2f959ef276a1191d01d5))
+* consolidate Windows statusline ADR, remove duplicate ([3903121](https://github.com/antonbelev/claude-owl/commit/3903121a869533bf09aa4b9edff27a23052e6f29))
+* **security:** update security assessment to reflect resolved critical issues ([42d4762](https://github.com/antonbelev/claude-owl/commit/42d476211e7e0bdc39912e48dcca92bb9c6c124a))
+* simplify security.html for end users ([f182e6b](https://github.com/antonbelev/claude-owl/commit/f182e6b5a0e70c396437699e030c42ab9741b948))
+* update Anthropic legal entity name (PBC → Inc) ([6abd3b0](https://github.com/antonbelev/claude-owl/commit/6abd3b03739f29fc929153ac811b6ff6170378a8))
+
+
+### ✨ Features
+
+* **docs:** Add comprehensive security and risk assessment ([f39bc90](https://github.com/antonbelev/claude-owl/commit/f39bc9086a52748230645270341de03d01004001))
+* **gh-pages:** Add Google Analytics 4 tracking to all pages ([4ca0b0f](https://github.com/antonbelev/claude-owl/commit/4ca0b0fa160f857d2198500a28e645af5d5ec099))
+* **gh-pages:** Configure Google Analytics with Measurement ID ([2e962b2](https://github.com/antonbelev/claude-owl/commit/2e962b277110668e752bc33ae80e5aff9728bab1))
+* implement 2025 Year in Review feature ([b640301](https://github.com/antonbelev/claude-owl/commit/b640301d501c6df860ca474ab2ecfc5c25fa1193))
+* implement Windows platform support (ADR-007 Phase 1-2) ([878e51e](https://github.com/antonbelev/claude-owl/commit/878e51e2483934b5245ea1c25f6c691b5df9b400))
+* implement Windows-aware statusline platform detection and execution ([0ee46c7](https://github.com/antonbelev/claude-owl/commit/0ee46c7f1d60e3aed3a4186c074f92fe2b628dac))
+* **metrics:** implement comprehensive metrics dashboard with token analysis ([ebaa51b](https://github.com/antonbelev/claude-owl/commit/ebaa51be355b7974ae767b15914acc8e02aa161e))
+* use official Claude Code model aliases for all model selection ([33ca49a](https://github.com/antonbelev/claude-owl/commit/33ca49a1fd493472535d528fa4272b67e1487dcb))
+
 ## [0.3.0](https://github.com/antonbelev/claude-owl/compare/v0.1.3...v0.3.0) (2025-12-07)
 
 

README.md

@@ -21,6 +21,20 @@ For a complete list of features, see [SCREENSHOTS.md](SCREENSHOTS.md) and [CHANG
 
 ![Claude Owl Dashboard](screenshots/claude-owl-dashboard.png)
 
+### 🎄 2025 Year in Review
+
+Celebrate your year of AI-powered development! Claude Owl now includes a festive Year in Review feature that showcases your 2025 coding journey with Claude Code:
+
+- **📊 Beautiful Stats**: Token usage, costs, sessions, and activity patterns
+- **🏆 Achievement Badges**: Earn badges for milestones and coding habits
+- **🎯 Model Insights**: See your favorite Claude models and usage breakdown
+- **📈 Activity Analytics**: Peak coding months, longest streaks, and daily patterns
+- **🎁 Social Sharing**: Share your year with customizable stats for Twitter/X
+
+![Year in Review 2025](screenshots/year-in-review-2025-total-tokens.png)
+
+Available now through January 1, 2026!
+
 ## Installation
 
 ### Prerequisites

docs/index.html

@@ -170,13 +170,79 @@ <h4 class="text-yellow-300 font-semibold mb-2">Windows SmartScreen Warning</h4>
     </div>
   </section>
 
+  <!-- Year in Review Highlight Section -->
+  <section class="py-20 px-6 bg-gradient-to-br from-amber-900/20 via-red-900/20 to-slate-800/50">
+    <div class="container mx-auto max-w-6xl">
+      <div class="text-center mb-12">
+        <div class="inline-block bg-amber-500/20 border border-amber-500/50 rounded-full px-4 py-1 text-amber-300 text-sm font-semibold mb-4">
+          🎄 NEW FEATURE • Available through Jan 1, 2026
+        </div>
+        <h2 class="text-4xl md:text-5xl font-bold mb-4 bg-gradient-to-r from-amber-400 to-red-400 bg-clip-text text-transparent">
+          2025 Year in Review
+        </h2>
+        <p class="text-xl text-slate-300 max-w-2xl mx-auto">
+          Celebrate your year of AI-powered development with beautiful stats, achievement badges, and social sharing
+        </p>
+      </div>
+
+      <!-- Screenshot -->
+      <div class="rounded-2xl overflow-hidden border-2 border-amber-500/30 shadow-2xl mb-8">
+        <img
+          src="../screenshots/year-in-review-2025-total-tokens.png"
+          alt="Claude Owl Year in Review 2025"
+          class="w-full"
+        />
+      </div>
+
+      <!-- Features Grid -->
+      <div class="grid md:grid-cols-2 lg:grid-cols-4 gap-4 mb-8">
+        <div class="bg-slate-900/60 p-4 rounded-lg border border-amber-500/20">
+          <div class="text-2xl mb-2">📊</div>
+          <h4 class="font-semibold text-amber-300 mb-1">Beautiful Stats</h4>
+          <p class="text-sm text-slate-400">Token usage, costs, sessions, and activity patterns</p>
+        </div>
+        <div class="bg-slate-900/60 p-4 rounded-lg border border-amber-500/20">
+          <div class="text-2xl mb-2">🏆</div>
+          <h4 class="font-semibold text-amber-300 mb-1">Achievement Badges</h4>
+          <p class="text-sm text-slate-400">Earn 10 badges for coding milestones and habits</p>
+        </div>
+        <div class="bg-slate-900/60 p-4 rounded-lg border border-amber-500/20">
+          <div class="text-2xl mb-2">📈</div>
+          <h4 class="font-semibold text-amber-300 mb-1">Activity Analytics</h4>
+          <p class="text-sm text-slate-400">Peak months, longest streaks, daily patterns</p>
+        </div>
+        <div class="bg-slate-900/60 p-4 rounded-lg border border-amber-500/20">
+          <div class="text-2xl mb-2">🎁</div>
+          <h4 class="font-semibold text-amber-300 mb-1">Social Sharing</h4>
+          <p class="text-sm text-slate-400">Share your year on Twitter/X with one click</p>
+        </div>
+      </div>
+
+      <div class="text-center">
+        <a href="#download-section" class="inline-block bg-gradient-to-r from-amber-500 to-red-500 hover:from-amber-600 hover:to-red-600 text-white font-semibold py-3 px-8 rounded-lg transition transform hover:scale-105">
+          Download Claude Owl to See Your 2025 Year in Review
+        </a>
+      </div>
+    </div>
+  </section>
+
   <!-- Features Section -->
   <section id="features" class="py-20 px-6 bg-slate-800/50">
     <div class="container mx-auto">
       <h2 class="text-4xl font-bold text-center mb-4">Features</h2>
       <p class="text-center text-slate-400 mb-12">Everything you need to manage Claude Code visually</p>
 
       <div class="grid md:grid-cols-2 lg:grid-cols-3 gap-6 max-w-6xl mx-auto">
+        <!-- Feature: Year in Review -->
+        <div class="bg-gradient-to-br from-amber-900/40 to-red-900/40 p-6 rounded-xl border-2 border-amber-500/50 hover:border-amber-400 transition relative overflow-hidden">
+          <div class="absolute top-0 right-0 text-xs bg-amber-500 text-white px-2 py-1 rounded-bl-lg font-semibold">NEW</div>
+          <div class="text-4xl mb-4">🎄</div>
+          <h3 class="text-xl font-semibold mb-2">2025 Year in Review</h3>
+          <p class="text-slate-400 text-sm">
+            Celebrate your AI-powered development year! View stats, earn badges, analyze activity patterns, and share your journey on social media. Available through Jan 1, 2026.
+          </p>
+        </div>
+
         <!-- Feature 1 -->
         <div class="bg-slate-900 p-6 rounded-xl border border-slate-700 hover:border-blue-500 transition">
           <div class="text-4xl mb-4">⚙️</div>

docs/screenshots.html

@@ -103,6 +103,7 @@ <h1 class="text-4xl md:text-5xl font-bold mb-4 bg-gradient-to-r from-blue-400 to
       <div class="bg-slate-800 rounded-xl p-6 border border-slate-700">
         <h2 class="text-xl font-semibold mb-4">Jump to Section</h2>
         <div class="grid md:grid-cols-3 gap-3 text-sm">
+          <a href="#year-review" class="text-amber-400 hover:underline font-semibold">🎄 2025 Year in Review</a>
           <a href="#dashboard" class="text-blue-400 hover:underline">🏠 Dashboard</a>
           <a href="#settings" class="text-blue-400 hover:underline">⚙️ Settings</a>
           <a href="#subagents" class="text-blue-400 hover:underline">🤖 Subagents</a>
@@ -118,6 +119,44 @@ <h2 class="text-xl font-semibold mb-4">Jump to Section</h2>
     </div>
   </section>
 
+  <!-- Year in Review -->
+  <section id="year-review" class="py-12 px-6 bg-gradient-to-br from-amber-900/20 to-red-900/20">
+    <div class="container mx-auto max-w-5xl">
+      <div class="flex items-center justify-between mb-2">
+        <h2 class="text-3xl font-bold flex items-center">
+          <span class="text-4xl mr-3">🎄</span> 2025 Year in Review
+        </h2>
+        <span class="bg-amber-500 text-white text-xs font-semibold px-3 py-1 rounded-full">NEW</span>
+      </div>
+      <p class="text-slate-400 mb-6">Celebrate your year of AI-powered development with beautiful stats, badges, and social sharing</p>
+
+      <div class="space-y-6">
+        <div>
+          <h3 class="text-xl font-semibold mb-3 text-amber-300">Year in Review Dashboard</h3>
+          <img src="https://raw.githubusercontent.com/antonbelev/claude-owl/main/screenshots/year-in-review-2025-total-tokens.png"
+               alt="2025 Year in Review"
+               class="screenshot-img w-full"
+               onclick="openModal(this.src, this.alt)">
+          <p class="text-sm text-slate-400 mt-2">
+            View your 2025 coding journey: token usage stats, AI spending, achievement badges, model insights, activity patterns, and social sharing. Features 9 interactive cards with snowfall animations. Available through January 1, 2026.
+          </p>
+        </div>
+
+        <div class="bg-amber-900/30 border border-amber-500/50 rounded-xl p-6">
+          <h4 class="font-semibold text-amber-300 mb-3">Key Features</h4>
+          <ul class="space-y-2 text-sm text-slate-300">
+            <li>📊 <strong>Beautiful Stats:</strong> Total tokens, costs, sessions, and daily activity patterns</li>
+            <li>🏆 <strong>10 Achievement Badges:</strong> Early Bird, Night Owl, Cache Master, Hot Streak, Million Club, and more</li>
+            <li>🎯 <strong>Model Insights:</strong> Favorite Claude model with personality, usage breakdown by tokens</li>
+            <li>📈 <strong>Activity Analytics:</strong> Peak month, peak day, longest coding streak, monthly charts</li>
+            <li>🎁 <strong>Social Sharing:</strong> Copy stats or tweet your year with one click (opens in default browser)</li>
+            <li>❄️ <strong>Festive UI:</strong> Animated snowflakes with accessibility support (respects prefers-reduced-motion)</li>
+          </ul>
+        </div>
+      </div>
+    </div>
+  </section>
+
   <!-- Dashboard -->
   <section id="dashboard" class="py-12 px-6 bg-slate-800/30">
     <div class="container mx-auto max-w-5xl">

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-owl",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Open-source UI for managing Claude Code configurations, settings, and features",
   "main": "dist/main/index.js",
   "author": "Claude Owl Contributors",