@codemieai/code 0.0.37 → 0.0.40

package/dist/agents/plugins/claude/plugin/commands/memory-refresh.md

@@ -1,6 +1,6 @@
 # Refresh and Audit Project Documentation
 
-**Purpose**: Verify and update project documentation to reflect current implementation.
+**Purpose**: Intelligently detect code changes and update documentation to reflect current implementation.
 
 **CRITICAL**: Not every code change requires documentation updates. Only update documentation when:
 - Implementation patterns have actually changed
@@ -10,34 +10,174 @@
 
 If documentation accurately reflects the current codebase, no changes are needed.
 
-
+---
 
 ## Additional user's input
 Additional context/input from user: $ARGUMENTS. Might be empty by default.
 
+---
+
+## Workflow Overview
+
+This command supports two modes based on documentation type:
+
+**🚀 Smart Mode (Codemie Docs)**:
+- Detects `.codemie/guides/` directory
+- Uses git to identify changed files
+- Maps changes to affected guide categories
+- Updates only impacted guides (selective)
+- Fast and efficient for regular updates
+
+**📋 Traditional Mode (All Documentation)**:
+- Works with any documentation structure
+- Comprehensive audit of all docs
+- Reviews all guides vs implementation
+- Updates as needed
+- Thorough for major refactors
+
+**Decision Flow**:
+```
+Step 1: Discover docs
+  ├─ Codemie docs found → Step 2A (Smart Mode)
+  └─ Other docs found → Step 2B (Traditional Mode)
+```
+
+User can override and request full audit at any point.
+
+---
+
 ## Step 1: Discover What Documentation Exists
 
 Identify documentation systems in this project:
 
-**A. Structured Guides** (if present):
-Common locations to check:
-- `docs/`, `.claude/guides/`, `.codemie/guides/`, `documentation/`
+**A. Codemie-Generated Documentation** (if present):
+- `CLAUDE.md` in project root
+- `.codemie/guides/` directory with structured guides
+- Check if generated by `/codemie-init` (mentions template structure)
+
+**B. Structured Guides** (if present):
+- `docs/`, `.claude/guides/`, `documentation/`
 - Look for topical organization (architecture, development, testing, etc.)
 
-**B. CLAUDE.md Files** (if present):
+**C. CLAUDE.md Files** (if present):
 - Root `CLAUDE.md` (project overview)
 - Component-specific `CLAUDE.md` in subdirectories
 - Common in: `src/`, `lib/`, feature directories
 
-**C. Other Documentation**:
+**D. Other Documentation**:
 - `README.md`, `CONTRIBUTING.md`, `ARCHITECTURE.md`
 - Wiki, Confluence, or external docs (mentioned in README)
 
 **Note**: Projects may have any combination of these, or none at all.
 
+**Decision Point**:
+- ✅ Codemie docs found → Use smart change detection (Step 2A)
+- ✅ Other docs found → Use traditional audit (Step 2B)
+
+---
+
+## Step 2A: Smart Change Detection (For Codemie Docs)
+
+**Use this workflow when `.codemie/guides/` exists**
+
+### Step 2A.1: Detect Changed Files
+
+**Ask user** which timeframe to analyze:
+- Recent uncommitted changes (default)
+- Last N commits (e.g., 5, 10)
+- Changes since specific date
+- All changes (comprehensive audit)
+
+**Git Commands**:
+```bash
+# Option 1: Uncommitted changes
+git status --short
+git diff HEAD --name-only
+
+# Option 2: Last N commits
+git diff HEAD~5 HEAD --name-only
+
+# Option 3: Since date
+git log --since="2 weeks ago" --name-only --pretty=format: | sort -u
+
+# Option 4: All staged/unstaged
+git diff --name-only && git diff --cached --name-only
+```
+
+**Filter relevant changes** (exclude):
+- Test files (unless testing patterns changed)
+- Build artifacts, dependencies
+- Documentation files themselves
+- Config files (unless tools changed)
+
+**Output**: List of changed source files
+
+**Decision Point**:
+- ✅ Changes detected → Continue to Step 2A.2
+- ❌ No changes → Skip to Step 6 (validation only)
+
 ---
 
-## Step 2: Review Recent Changes
+### Step 2A.2: Map Changes to Guide Categories
+
+**For each changed file**, determine which guides are affected:
+
+| Changed File Pattern | Affected Guide Category | Example Guides |
+|----------------------|-------------------------|----------------|
+| `src/api/`, `routes/`, `controllers/` | API Development | api/api-patterns.md |
+| `src/models/`, `repositories/`, `schemas/` | Data & Database | data/database-patterns.md |
+| `src/services/`, `domain/`, `business/` | Architecture | architecture/architecture.md |
+| `src/components/`, `ui/`, `views/` | Development Practices | development/frontend-patterns.md |
+| `src/utils/errors.`, `exceptions/` | Development Practices | development/error-handling.md |
+| `src/utils/logger.`, `logging/` | Development Practices | development/logging.md |
+| `src/auth/`, `security/`, `middleware/auth` | Security | security/security-patterns.md |
+| `tests/`, `*.test.`, `*.spec.` | Testing | testing/testing-patterns.md |
+| `src/integrations/`, `clients/`, `adapters/` | Integrations | integration/external-integrations.md |
+| Root directory changes (new folders) | Architecture | architecture/architecture.md |
+
+**Assess impact**:
+- **High impact**: Multiple files in same category changed
+- **Low impact**: Single file changed
+- **No impact**: Only tests changed, no pattern shifts
+
+**List existing guides**:
+```bash
+find .codemie/guides -name "*.md" -type f
+```
+
+**Cross-reference**:
+- Guide exists + impacted → Update candidate
+- Guide exists + not impacted → Skip
+- Guide missing + impacted → Note for user
+
+**Present to user**:
+```
+📊 Change Impact Analysis
+
+🔴 HIGH IMPACT (multiple files, pattern changes):
+   ✏️ api/api-patterns.md (3 files changed)
+   ✏️ security/security-patterns.md (2 files changed)
+
+🟡 LOW IMPACT (single file, minor updates):
+   ✏️ development/development-practices.md (1 file)
+
+⏭️ SKIPPED (no pattern changes):
+   - testing/testing-patterns.md
+   - data/database-patterns.md
+
+Proceed with selective update? (Yes / Full Audit / Cancel)
+```
+
+**Decision Point**:
+- User selects "Yes" → Continue to Step 3A (selective update)
+- User selects "Full Audit" → Jump to Step 2B (traditional audit)
+- User selects "Cancel" → Exit
+
+---
+
+## Step 2B: Traditional Audit (For All Documentation)
+
+**Use this workflow for non-Codemie docs or when user requests full audit**
 
 Before reviewing documentation, understand what changed:
 
@@ -54,7 +194,73 @@ Before reviewing documentation, understand what changed:
 
 ---
 
-## Step 3: Audit Structured Guides (if present)
+## Step 3A: Selective Update (For Codemie Docs)
+
+**For each guide identified in Step 2A.2**:
+
+### Step 3A.1: Analyze Changed Code
+
+**For files mapped to this guide**:
+1. Read the changed files
+2. Identify what patterns changed (new, modified, or removed)
+3. Extract updated code examples (5-15 lines max)
+4. Note file paths with line numbers
+
+### Step 3A.2: Compare Current Guide vs Code
+
+**Load current guide**:
+```bash
+Read .codemie/guides/[category]/[guide].md
+```
+
+**Load template** (for structural reference):
+```bash
+Read .codemie/claude-templates/templates/guides/[category]/[template].md.template
+```
+
+**Check**:
+- [ ] Are documented patterns still used?
+- [ ] Are code examples still accurate?
+- [ ] Are file references still valid?
+- [ ] Are new patterns present that should be documented?
+- [ ] Are any documented patterns now obsolete?
+
+### Step 3A.3: Execute Selective Updates
+
+**Determine update scope**:
+
+| Finding | Action |
+|---------|--------|
+| Code example outdated | Update specific example, preserve structure |
+| Pattern evolved | Update pattern description and example |
+| New pattern introduced | Add new pattern section (if space allows) |
+| Pattern removed | Remove or mark as deprecated |
+| File path changed | Update reference path |
+| Everything accurate | Skip update (no changes needed) |
+
+**Update strategy**:
+- ✅ Use Edit tool for selective updates (NOT Write)
+- ✅ Update specific sections that changed
+- ✅ Preserve guide structure (maintain template alignment)
+- ✅ Keep existing examples that are still valid
+- ✅ Update file:line references
+- ❌ Don't rewrite entire guide
+- ❌ Don't change structure unnecessarily
+
+**Validate size**:
+```bash
+wc -l .codemie/guides/[category]/[guide].md  # Must be ≤400 lines
+```
+
+If exceeded → Condense: remove redundant examples, use tables, tighten prose.
+
+**Skip to Step 6** (validation) after updating impacted guides.
+
+---
+
+## Step 3B: Traditional Audit of Structured Guides
+
+**Use for non-Codemie docs or full audit mode**
 
 For each guide/doc file that exists:
 
@@ -115,7 +321,7 @@ find . -name "CLAUDE.md" -not -path "*/node_modules/*" -not -path "*/.git/*"
 
 ---
 
-## Step 5: Determine What Needs Updating
+## Step 5: Determine What Needs Updating (Traditional Mode)
 
 Categorize findings:
 
@@ -141,7 +347,14 @@ Categorize findings:
 
 ---
 
-## Step 6: Execute Selective Updates
+## Step 6: Execute Updates
+
+**For Codemie Docs** (if using selective update from Step 3A):
+- Updates already completed in Step 3A.3
+- Skip to Step 7 (validation)
+
+**For Traditional Audit** (if using Step 3B-5):
+- Continue with updates below
 
 Only modify files where changes are actually needed:
 
@@ -159,11 +372,19 @@ Only modify files where changes are actually needed:
 4. Remove obsolete patterns
 5. Ensure info is in most appropriate file
 
+**For Codemie Guides** (if updating in traditional mode):
+1. Maintain template structure from `.codemie/claude-templates/`
+2. Update specific sections that are outdated
+3. Preserve existing valid examples
+4. Keep guides within size limits (200-400 lines)
+5. Update file:line references if paths changed
+
 **Content Placement**:
 - **Broad patterns** (used across project) → Root docs or main CLAUDE.md
 - **Component-specific** (local to one area) → Component CLAUDE.md or specific guide section
 - **Project-wide conventions** → Root README or CLAUDE.md
 - **Module implementation details** → Module-level CLAUDE.md
+- **Codemie guides** → Category-specific guides in `.codemie/guides/[category]/`
 
 ---
 
@@ -173,10 +394,34 @@ Before finalizing:
 
 **Accuracy Check**:
 - [ ] All technical claims verified against current code
-- [ ] Examples reference existing files/functions
+- [ ] Examples reference existing files/functions (check with actual file paths)
 - [ ] Patterns match actual implementation
 - [ ] No contradictions between different docs
 
+**For Codemie Docs** (additional checks):
+- [ ] All file:line references are valid
+```bash
+# Verify referenced files exist
+grep -o '\[.*\..*:.*\]' .codemie/guides/**/*.md | while read ref; do
+    file=$(echo $ref | cut -d: -f1 | tr -d '[]')
+    [ -f "$file" ] || echo "Missing: $file"
+done
+```
+- [ ] No placeholders remain ([PLACEHOLDER], FILL IN, TODO)
+```bash
+grep -r '\[.*\]' .codemie/guides/ | grep -v '.git'
+grep -r 'FILL IN\|TODO\|PLACEHOLDER' .codemie/guides/
+```
+- [ ] Guide structure matches template conventions
+- [ ] Size limits maintained (≤400 lines per guide)
+```bash
+for guide in .codemie/guides/**/*.md; do
+    lines=$(wc -l < "$guide")
+    [ $lines -gt 400 ] && echo "⚠️ $guide exceeds 400 lines ($lines)"
+done
+```
+- [ ] CLAUDE.md guide references are current (if guides added/removed)
+
 **Relevance Check**:
 - [ ] Information is actionable
 - [ ] Content helps future understanding
@@ -191,6 +436,61 @@ Before finalizing:
 
 ---
 
+## Summary Report
+
+After completing updates, provide a summary:
+
+**For Selective Updates (Codemie Docs)**:
+```markdown
+# Documentation Refresh Complete
+
+## Updated Guides (3)
+
+### High Impact Updates
+**api/api-patterns.md** ✅
+- Updated: Validation middleware pattern
+- Updated: Error response format examples
+- References: 3 files updated, all verified
+
+**security/security-patterns.md** ✅
+- Updated: JWT token generation example
+- References: 2 files updated, all verified
+
+### Low Impact Updates
+**development/development-practices.md** ✅
+- Updated: Validation helper reference
+- References: 1 file updated, verified
+
+## Skipped Guides (5)
+- testing/testing-patterns.md (no pattern changes)
+- data/database-patterns.md (no changes)
+- architecture/architecture.md (structure unchanged)
+
+## Validation Status
+- ✅ All file references verified
+- ✅ No placeholders remain
+- ✅ Size limits maintained
+- ✅ Template structure preserved
+```
+
+**For Traditional Audit**:
+```markdown
+# Documentation Audit Complete
+
+## Files Updated
+- CLAUDE.md (updated commands section)
+- .codemie/guides/api/api-patterns.md (new pattern added)
+- src/services/CLAUDE.md (updated integration points)
+
+## Validation Status
+- ✅ All technical claims verified
+- ✅ Examples reference existing code
+- ✅ No contradictions found
+- ✅ Links validated
+```
+
+---
+
 ## Key Principles
 
 **Accuracy Over Completeness**:
@@ -221,12 +521,23 @@ Before finalizing:
 
 Before making changes, ask:
 
-1. **Is this change needed?** (Does doc mismatch implementation?)
-2. **Is it significant?** (Will this help future understanding?)
-3. **Where should it go?** (Most specific applicable location)
-4. **What's the scope?** (Component-specific or project-wide?)
-5. **Is it accurate?** (Verified against current code?)
-6. **Is it clear?** (Would someone else understand this?)
+1. **Which mode applies?** (Codemie docs → Smart Mode | Other docs → Traditional)
+2. **Is this change needed?** (Does doc mismatch implementation?)
+3. **Is it significant?** (Will this help future understanding?)
+4. **Where should it go?** (Most specific applicable location)
+5. **What's the scope?** (Component-specific or project-wide?)
+6. **Is it accurate?** (Verified against current code?)
+7. **Is it clear?** (Would someone else understand this?)
+
+**Smart Mode Benefits**:
+- Faster: Only checks changed areas
+- Targeted: Updates specific guides
+- Efficient: Good for regular maintenance
+
+**Traditional Mode Benefits**:
+- Comprehensive: Reviews all docs
+- Thorough: Catches subtle issues
+- Complete: Good for major refactors
 
 **If unsure**: Verify implementation first, then update documentation.
 

package/dist/agents/plugins/claude/plugin/hooks/hooks.json

@@ -8,6 +8,10 @@
             "type": "command",
             "command": "codemie hook",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "~/.codemie/claude-plugin/sounds/play-random-sound.sh ~/.codemie/sounds/SessionStart"
           }
         ]
       }
@@ -30,6 +34,10 @@
             "type": "command",
             "command": "codemie hook",
             "timeout": 2
+          },
+          {
+            "type": "command",
+            "command": "~/.codemie/claude-plugin/sounds/play-random-sound.sh ~/.codemie/sounds/PermissionRequest"
           }
         ]
       }
@@ -52,6 +60,10 @@
             "type": "command",
             "command": "codemie hook",
             "timeout": 2
+          },
+          {
+            "type": "command",
+            "command": "~/.codemie/claude-plugin/sounds/play-random-sound.sh ~/.codemie/sounds/Stop"
           }
         ]
       }
@@ -63,6 +75,10 @@
             "type": "command",
             "command": "codemie hook",
             "timeout": 2
+          },
+          {
+            "type": "command",
+            "command": "~/.codemie/claude-plugin/sounds/play-random-sound.sh ~/.codemie/sounds/UserPromptSubmit"
           }
         ]
       }

package/dist/agents/plugins/claude/plugin/sounds/play-random-sound.ps1

@@ -0,0 +1,112 @@
+# play-random-sound.ps1
+# Plays a random WAV or MP3 file from the specified directory (Windows)
+# Usage: .\play-random-sound.ps1 <directory>
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$Directory
+)
+
+# Set error action preference to stop on errors
+$ErrorActionPreference = "Stop"
+
+# Expand environment variables in the path (e.g., %USERPROFILE%)
+$SoundDir = [System.Environment]::ExpandEnvironmentVariables($Directory)
+
+# Check if directory exists - exit silently if not found
+if (-not (Test-Path -Path $SoundDir -PathType Container)) {
+    exit 0
+}
+
+# Find all audio files (WAV and MP3)
+$AudioFiles = Get-ChildItem -Path $SoundDir -File -Include *.wav,*.mp3 -ErrorAction SilentlyContinue
+
+# Check if any audio files were found
+if ($AudioFiles.Count -eq 0) {
+    exit 0
+}
+
+# Select a random file
+$SelectedFile = $AudioFiles | Get-Random
+
+# Function to play audio using mpg123 (if available)
+function Play-WithMpg123 {
+    param([string]$FilePath)
+
+    try {
+        $mpg123 = Get-Command mpg123 -ErrorAction Stop
+        Start-Process -FilePath $mpg123.Source -ArgumentList "-q", "`"$FilePath`"" -NoNewWindow -Wait:$false
+        return $true
+    } catch {
+        return $false
+    }
+}
+
+# Function to play audio using Windows Media Player COM
+function Play-WithWMP {
+    param([string]$FilePath)
+
+    try {
+        $wmp = New-Object -ComObject WMPlayer.OCX
+        $wmp.URL = $FilePath
+        $wmp.controls.play()
+
+        # Start playback in background (don't wait for completion)
+        Start-Sleep -Milliseconds 500
+        return $true
+    } catch {
+        return $false
+    }
+}
+
+# Function to play audio using .NET SoundPlayer (WAV only)
+function Play-WithSoundPlayer {
+    param([string]$FilePath)
+
+    # SoundPlayer only supports WAV files
+    if ($FilePath -notmatch '\.wav$') {
+        return $false
+    }
+
+    try {
+        Add-Type -AssemblyName System.Windows.Forms
+        $player = New-Object System.Media.SoundPlayer
+        $player.SoundLocation = $FilePath
+        $player.PlaySync() # Play asynchronously
+
+        # Start in background job to avoid blocking
+        Start-Job -ScriptBlock {
+            param($path)
+            Add-Type -AssemblyName System.Windows.Forms
+            $p = New-Object System.Media.SoundPlayer
+            $p.SoundLocation = $path
+            $p.PlaySync()
+        } -ArgumentList $FilePath | Out-Null
+
+        return $true
+    } catch {
+        return $false
+    }
+}
+
+# Try audio players in order of preference
+$played = $false
+
+# 1. Try mpg123 (best option, cross-platform)
+if (Play-WithMpg123 -FilePath $SelectedFile.FullName) {
+    $played = $true
+}
+# 2. Try Windows Media Player COM
+elseif (Play-WithWMP -FilePath $SelectedFile.FullName) {
+    $played = $true
+}
+# 3. Try .NET SoundPlayer (WAV only)
+elseif (Play-WithSoundPlayer -FilePath $SelectedFile.FullName) {
+    $played = $true
+}
+
+if (-not $played) {
+    exit 0
+}
+
+exit 0

package/dist/agents/plugins/claude/plugin/sounds/play-random-sound.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+
+# play-random-sound.sh
+# Plays a random WAV file from the specified directory
+# Usage: ./play-random-sound.sh <directory>
+
+set -e
+
+# Check if directory argument is provided
+if [ $# -eq 0 ]; then
+    echo "Usage: $0 <directory>" >&2
+    echo "Example: $0 ~/.codemie/claude-plugin/sounds/acolyte" >&2
+    exit 0
+fi
+
+# Expand tilde in the directory path
+SOUND_DIR="${1/#\~/$HOME}"
+
+# Check if directory exists - exit silently if not found
+if [ ! -d "$SOUND_DIR" ]; then
+    exit 0
+fi
+
+# Find all audio files and store in array (compatible way)
+WAV_FILES=()
+while IFS= read -r -d '' file; do
+    WAV_FILES+=("$file")
+done < <(find "$SOUND_DIR" -maxdepth 1 -type f \( -iname "*.wav" -o -iname "*.mp3" \) -print0 2>/dev/null)
+
+# Check if any audio files were found
+if [ ${#WAV_FILES[@]} -eq 0 ]; then
+    echo "Error: No WAV or MP3 files found in $SOUND_DIR" >&2
+    exit 0
+fi
+
+# Select a random file
+RANDOM_INDEX=$((RANDOM % ${#WAV_FILES[@]}))
+SELECTED_FILE="${WAV_FILES[$RANDOM_INDEX]}"
+
+# Detect platform and use appropriate audio player
+if command -v afplay &> /dev/null; then
+    # macOS
+    afplay "$SELECTED_FILE" &
+elif command -v aplay &> /dev/null; then
+    # Linux with ALSA
+    aplay -q "$SELECTED_FILE" &
+elif command -v paplay &> /dev/null; then
+    # Linux with PulseAudio
+    paplay "$SELECTED_FILE" &
+elif command -v mpg123 &> /dev/null; then
+    # Cross-platform mpg123
+    mpg123 -q "$SELECTED_FILE" &
+else
+    echo "Error: No audio player found. Install afplay (macOS), aplay, paplay, or mpg123" >&2
+    exit 0
+fi
+
+exit 0

package/dist/agents/plugins/claude/sounds-installer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sounds Installer
+ *
+ * Automated installation of the sound hooks system for Claude Code.
+ * Creates hook directories, installs play-random-sound.sh script, and configures hooks.
+ */
+/**
+ * Install fun sounds system
+ * Creates directories, installs script, and saves hooks configuration to ~/.claude/settings.json
+ *
+ * @returns Hooks configuration object if successful, null if installation failed
+ */
+export declare function installSounds(): Promise<string | null>;
+/**
+ * Check if sounds are already installed
+ * @returns true if exist sounds directory
+ */
+export declare function isSoundsInstalled(): boolean;
+//# sourceMappingURL=sounds-installer.d.ts.map

package/dist/agents/plugins/claude/sounds-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sounds-installer.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/claude/sounds-installer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2GH;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqD5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C"}