agentvibes 1.0.7 → 1.0.9

package/.claude/hooks/voice-manager.sh

@@ -260,7 +260,24 @@ case "$1" in
 
   replay)
     # Replay recent TTS audio from history
-    AUDIO_DIR="$HOME/.claude/audio"
+    # Use project-local directory with same logic as play-tts.sh
+    if [[ -n "$CLAUDE_PROJECT_DIR" ]]; then
+      AUDIO_DIR="$CLAUDE_PROJECT_DIR/.claude/audio"
+    else
+      # Fallback: try to find .claude directory in current path
+      CURRENT_DIR="$PWD"
+      while [[ "$CURRENT_DIR" != "/" ]]; do
+        if [[ -d "$CURRENT_DIR/.claude" ]]; then
+          AUDIO_DIR="$CURRENT_DIR/.claude/audio"
+          break
+        fi
+        CURRENT_DIR=$(dirname "$CURRENT_DIR")
+      done
+      # Final fallback to global if no project .claude found
+      if [[ -z "$AUDIO_DIR" ]]; then
+        AUDIO_DIR="$HOME/.claude/audio"
+      fi
+    fi
 
     # Default to replay last audio (N=1)
     N="${2:-1}"
@@ -298,7 +315,9 @@ case "$1" in
       exit 1
     fi
 
-    echo "🔊 Replaying audio #$N: $(basename "$AUDIO_FILE")"
+    echo "🔊 Replaying audio #$N:"
+    echo "   File: $(basename "$AUDIO_FILE")"
+    echo "   Path: $AUDIO_FILE"
 
     # Play the audio file in background
     (paplay "$AUDIO_FILE" 2>/dev/null || aplay "$AUDIO_FILE" 2>/dev/null || mpg123 "$AUDIO_FILE" 2>/dev/null) &

package/README.md

@@ -5,6 +5,8 @@
 > Professional text-to-speech narration powered by ElevenLabs AI
 
 [![npm version](https://badge.fury.io/js/agentvibes.svg)](https://badge.fury.io/js/agentvibes)
+[![Test Suite](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml)
+[![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
 **Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire))

package/RELEASE_PROCESS.md

@@ -0,0 +1,204 @@
+# AgentVibes Release Process
+
+## 📦 npm Publishing Best Practices
+
+### Current Setup ✅
+
+AgentVibes follows industry best practices for npm package releases:
+
+1. **Semantic Versioning (SemVer)**
+   - `MAJOR.MINOR.PATCH` format (e.g., 1.0.7)
+   - MAJOR: Breaking changes
+   - MINOR: New features (backward compatible)
+   - PATCH: Bug fixes
+
+2. **Conventional Commits**
+   - `feat:` → New features (MINOR bump)
+   - `fix:` → Bug fixes (PATCH bump)
+   - `docs:` → Documentation only
+   - `test:` → Test updates
+   - `chore:` → Maintenance tasks
+
+3. **Automated Publishing**
+   - GitHub Actions handles all releases
+   - No manual `npm publish` needed
+   - Publishes on git tag push
+
+4. **Dual Release Strategy**
+   - npm package (automated)
+   - GitHub Release (automated with categorized notes)
+
+## 🚀 How to Release
+
+### Simple Release Process
+
+```bash
+# 1. Make your changes and commit using conventional commits
+git add -A
+git commit -m "feat: Add new voice preview feature"
+
+# 2. Bump version and create tag (this triggers everything)
+npm version patch   # For bug fixes (1.0.7 → 1.0.8)
+npm version minor   # For new features (1.0.7 → 1.1.0)
+npm version major   # For breaking changes (1.0.7 → 2.0.0)
+
+# 3. Push with tags
+git push origin master --follow-tags
+
+# 4. Update v1 branch (optional but recommended)
+git checkout v1 && git merge master --no-edit && git push origin v1 && git checkout master
+```
+
+**That's it!** GitHub Actions automatically:
+- ✅ Publishes to npm
+- ✅ Creates GitHub Release
+- ✅ Generates categorized changelog
+- ✅ Tags the release
+
+## 📋 What Happens Automatically
+
+### When you push a version tag (e.g., v1.0.8):
+
+1. **npm Publishing** (`.github/workflows/publish.yml`)
+   - Runs on Ubuntu latest
+   - Uses Node.js 20
+   - Runs `npm ci` for clean install
+   - Publishes to npm registry
+   - Uses `NPM_TOKEN` secret for authentication
+
+2. **GitHub Release Creation**
+   - Extracts version from tag
+   - Categorizes commits by type:
+     - ✨ New Features (feat:)
+     - 🐛 Bug Fixes (fix:)
+     - 📚 Documentation (docs:)
+     - 🧪 Testing (test:)
+     - 🔧 Maintenance (chore:)
+   - Generates formatted release notes
+   - Includes installation instructions
+   - Adds links to npm, docs, and issues
+   - Uses GitHub's auto-generated notes too
+
+3. **Testing** (`.github/workflows/test.yml`)
+   - Runs all BATS tests
+   - Validates no regressions
+   - Shows status in PR/commit
+
+## 🏷️ Release Notes Format
+
+Example output:
+```markdown
+## AgentVibes v1.0.8
+
+> Professional text-to-speech narration for Claude Code sessions
+
+### 📦 Installation
+\`\`\`bash
+npx agentvibes@1.0.8 install
+\`\`\`
+
+### 📝 What's Changed
+
+### ✨ New Features
+- Add voice preview feature (abc123)
+- Support custom personalities (def456)
+
+### 🐛 Bug Fixes
+- Fix audio save directory detection (ghi789)
+- Resolve double-audio bug in personality switching (jkl012)
+
+### 📚 Documentation
+- Update README with new commands (mno345)
+
+### 🔗 Links
+- 📦 [npm package](https://www.npmjs.com/package/agentvibes/v/1.0.8)
+- 📚 [Full Documentation](https://github.com/paulpreibisch/AgentVibes#readme)
+- 🐛 [Report Issues](https://github.com/paulpreibisch/AgentVibes/issues)
+
+---
+
+**Built with ❤️ by Paul Preibisch | Powered by ElevenLabs AI**
+```
+
+## 🔐 Secrets Configuration
+
+Required GitHub secrets:
+- `NPM_TOKEN` - Automation token from npmjs.com
+- `GITHUB_TOKEN` - Auto-provided by GitHub Actions
+
+## 📊 Release Checklist
+
+Before releasing:
+- [ ] All tests passing locally (`npm test`)
+- [ ] Conventional commit messages used
+- [ ] CHANGELOG reflects changes (auto-generated)
+- [ ] Version bump appropriate for changes
+- [ ] Both master and v1 branches updated
+
+After releasing:
+- [ ] Check npm package published: https://www.npmjs.com/package/agentvibes
+- [ ] Verify GitHub Release created
+- [ ] Test installation: `npx agentvibes@VERSION install`
+- [ ] Check badges on README (should be green)
+
+## 🎯 Best Practices We Follow
+
+✅ **Automated Everything**
+- No manual npm publish
+- No manual release notes
+- No manual changelog
+
+✅ **Semantic Versioning**
+- Clear version meaning
+- Predictable upgrades
+
+✅ **Conventional Commits**
+- Auto-categorized changes
+- Better git history
+
+✅ **Comprehensive Testing**
+- 29+ tests with mocks
+- No API token usage
+- CI/CD integration
+
+✅ **Clear Documentation**
+- Installation in release notes
+- Links to resources
+- Version-specific npx commands
+
+## 🚨 Common Issues
+
+**Release didn't trigger:**
+- Ensure tag format is `v*.*.*` (e.g., v1.0.8)
+- Check GitHub Actions tab for errors
+- Verify NPM_TOKEN is valid
+
+**Tests failing:**
+- Run `npm test` locally first
+- Check test output in Actions tab
+- Fix issues before releasing
+
+**npm already has this version:**
+- Can't republish same version
+- Bump version again
+- Delete tag if needed: `git tag -d v1.0.8 && git push origin :refs/tags/v1.0.8`
+
+## 📈 Version History
+
+Current release: **v1.0.7**
+
+Recent changes (unreleased):
+- test: Add tests for replay command directory detection and output
+- fix: Replay command now uses project-local audio directory
+- feat: Show full file path in replay command output
+- docs: Add GitHub Actions status badges for tests and publishing
+
+Next release will be: **v1.0.8** (PATCH - bug fixes and tests)
+
+## 🔮 Future Improvements
+
+- [ ] Automated security scanning
+- [ ] Performance benchmarks
+- [ ] Pre-release/beta channel support
+- [ ] Automatic dependency updates (Dependabot)
+- [ ] Release candidate workflow

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Beautiful ElevenLabs TTS voice commands for Claude Code - Add professional narration to your AI coding sessions",
   "keywords": [
     "elevenlabs",

package/test/helpers/test-helper.bash

@@ -95,7 +95,17 @@ EOF
 
 # Copy AgentVibes scripts to test location
 setup_agentvibes_scripts() {
-  local REPO_ROOT="${BATS_TEST_DIRNAME}/.."
+  # BATS_TEST_DIRNAME points to test/unit/, so go up two levels to repo root
+  local REPO_ROOT="${BATS_TEST_DIRNAME}/../.."
+
+  # Verify paths exist before copying
+  if [[ ! -d "$REPO_ROOT/.claude/hooks" ]]; then
+    echo "Error: Cannot find .claude/hooks at $REPO_ROOT/.claude/hooks"
+    echo "BATS_TEST_DIRNAME: $BATS_TEST_DIRNAME"
+    echo "REPO_ROOT: $REPO_ROOT"
+    ls -la "$REPO_ROOT" || true
+    return 1
+  fi
 
   # Copy hooks to test .claude directory
   cp -r "$REPO_ROOT/.claude/hooks" "$TEST_CLAUDE_DIR/"

package/test/unit/voice-manager.bats

@@ -30,8 +30,8 @@ teardown() {
   run "$VOICE_MANAGER" get
 
   [ "$status" -eq 0 ]
-  # Should return Cowboy Bob as default
-  [[ "$output" == "Cowboy Bob" ]]
+  # Should return Cowboy Bob as default (may include warnings)
+  assert_output_contains "Cowboy Bob"
 }
 
 @test "voice-manager switch changes voice" {
@@ -40,9 +40,9 @@ teardown() {
   [ "$status" -eq 0 ]
   assert_output_contains "Voice switched to: Aria"
 
-  # Verify voice was saved
+  # Verify voice was saved (may include warnings)
   run "$VOICE_MANAGER" get
-  [[ "$output" == "Aria" ]]
+  assert_output_contains "Aria"
 }
 
 @test "voice-manager switch by number works" {
@@ -80,9 +80,47 @@ teardown() {
   assert_output_contains "Voice: Aria"
 }
 
+@test "voice-manager replay uses project-local directory" {
+  # Create test audio file in project-local directory
+  mkdir -p "$CLAUDE_PROJECT_DIR/.claude/audio"
+  touch "$CLAUDE_PROJECT_DIR/.claude/audio/tts-123456.mp3"
+
+  run "$VOICE_MANAGER" replay 1
+
+  [ "$status" -eq 0 ]
+  assert_output_contains "Replaying audio #1"
+  assert_output_contains "$CLAUDE_PROJECT_DIR/.claude/audio/tts-123456.mp3"
+}
+
+@test "voice-manager replay falls back to HOME when no project directory" {
+  unset CLAUDE_PROJECT_DIR
+  mkdir -p "$TEST_HOME/.claude/audio"
+  touch "$TEST_HOME/.claude/audio/tts-789012.mp3"
+
+  cd "$TEST_HOME"
+
+  run "$VOICE_MANAGER" replay 1
+
+  [ "$status" -eq 0 ]
+  assert_output_contains "Replaying audio #1"
+  assert_output_contains "$TEST_HOME/.claude/audio/tts-789012.mp3"
+}
+
 @test "voice-manager replay with no audio history fails gracefully" {
   run "$VOICE_MANAGER" replay 1
 
   [ "$status" -eq 1 ]
-  assert_output_contains "No audio history found"
+  # Accept either error message format
+  [[ "$output" =~ "No audio history found"|"Audio #1 not found in history" ]]
+}
+
+@test "voice-manager replay shows both filename and path" {
+  mkdir -p "$CLAUDE_PROJECT_DIR/.claude/audio"
+  touch "$CLAUDE_PROJECT_DIR/.claude/audio/tts-999999.mp3"
+
+  run "$VOICE_MANAGER" replay 1
+
+  [ "$status" -eq 0 ]
+  assert_output_contains "File: tts-999999.mp3"
+  assert_output_contains "Path: $CLAUDE_PROJECT_DIR/.claude/audio/tts-999999.mp3"
 }