@uniswap/ai-toolkit-nx-claude 0.5.30-next.2 → 0.5.30-next.3

package/dist/packages/ai-toolkit-nx-claude/src/cli-generator.d.ts

@@ -3,14 +3,13 @@
  * Unified CLI wrapper for ai-toolkit-nx-claude generators.
  *
  * Available generators:
- * - hooks: Install Claude Code notification hooks
  * - addons: Install and configure Claude Code addons including MCP servers
  *
  * Usage:
  * - No arguments -> shows interactive menu of generators
  * - Specific generator name -> runs that generator
  *
- * Note: The init, add-command, and add-agent generators have been removed.
+ * Note: The init, add-command, add-agent, and hooks generators have been removed.
  * For Claude Code setup, use the marketplace-based plugin architecture instead.
  */
 export {};

package/dist/packages/ai-toolkit-nx-claude/src/cli-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli-generator.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"cli-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli-generator.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}

package/dist/packages/ai-toolkit-nx-claude/src/index.d.ts

@@ -1,3 +1,2 @@
-export { default as hooksGenerator } from './generators/hooks/generator';
 export { default as addonsGenerator } from './generators/addons/generator';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/ai-toolkit-nx-claude/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/generators.json

@@ -1,10 +1,5 @@
 {
   "generators": {
-    "hooks": {
-      "factory": "./dist/generators/hooks/generator",
-      "schema": "./dist/generators/hooks/schema.json",
-      "description": "Install Claude Code notification hooks"
-    },
     "addons": {
       "factory": "./dist/generators/addons/generator",
       "schema": "./dist/generators/addons/schema.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniswap/ai-toolkit-nx-claude",
-  "version": "0.5.30-next.2",
+  "version": "0.5.30-next.3",
   "private": false,
   "main": "./dist/index.cjs",
   "module": "./dist/index.cjs",
@@ -47,8 +47,7 @@
           "additionalEntryPoints": [
             "packages/ai-toolkit-nx-claude/src/index.ts",
             "packages/ai-toolkit-nx-claude/src/scripts/claude-plus/index.ts",
-            "packages/ai-toolkit-nx-claude/src/generators/addons/generator.ts",
-            "packages/ai-toolkit-nx-claude/src/generators/hooks/generator.ts"
+            "packages/ai-toolkit-nx-claude/src/generators/addons/generator.ts"
           ],
           "tsConfig": "packages/ai-toolkit-nx-claude/tsconfig.lib.json",
           "bundle": true,

package/dist/generators/hooks/CLAUDE.md

@@ -1,378 +0,0 @@
-# CLAUDE.md - Hooks Generator
-
-## Overview
-
-The `hooks` generator is a specialized Nx generator that automates the installation of notification hooks for Claude Code, providing audio and speech alerts when Claude needs user input during development sessions.
-
-## Core Functionality
-
-### What It Does
-
-1. **Dependency Validation**: Checks for Node.js, npm, and Git installations
-2. **Repository Management**: Clones or updates the awesome-claude-code repository
-3. **Interactive Configuration**: Prompts for notification preferences (sound vs speech)
-4. **Backup Management**: Creates timestamped backups of existing hook configurations
-5. **Script Orchestration**: Executes awesome-claude-code's install-global.sh with user selections
-6. **Installation Verification**: Validates that hooks were properly installed
-7. **Rollback Support**: Restores from backup if installation fails
-8. **Test Capability**: Optionally tests the installed hooks to verify functionality
-
-### Key Design Decision
-
-This generator provides a streamlined installation process that:
-
-- Automatically downloads the latest hook implementations
-- Handles all configuration and setup
-- Manages backups and rollback
-- Provides a consistent installation experience
-
-## Architecture
-
-### Module Structure
-
-```
-packages/ai-toolkit-nx-claude/src/generators/hooks/
-├── generator.ts           # Main generator orchestrator
-├── generator.spec.ts      # Test suite
-├── schema.json           # Configuration schema for Nx
-├── schema.d.ts           # TypeScript interface for options
-├── dependency-checker.ts  # System dependency validation
-├── repo-manager.ts       # Git repository operations
-├── install-orchestrator.ts # Installation script execution
-└── CLAUDE.md            # This documentation file
-```
-
-### Key Components
-
-#### 1. Generator (generator.ts)
-
-The main orchestrator that:
-
-- Coordinates the entire installation flow
-- Manages user prompts via schema-driven prompting
-- Handles dry-run mode
-- Provides verbose/quiet output modes
-- Manages cleanup on success/failure
-
-#### 2. Dependency Checker (dependency-checker.ts)
-
-Validates system requirements:
-
-- **checkDependencies()**: Returns status for Node, npm, and Git
-- **validateDependencies()**: Logs detailed version information
-- **checkAndValidateDependencies()**: Combined check with user-friendly output
-- Cross-platform command detection (handles Windows/Unix differences)
-
-#### 3. Repository Manager (repo-manager.ts)
-
-Manages the hook file downloads:
-
-- **ensureRepository()**: Main entry point that clones or updates
-- **cloneRepository()**: Handles HTTPS/SSH fallback for cloning
-- **updateRepository()**: Git pull with stash handling for uncommitted changes
-- **getRepoStatus()**: Detailed repository state information
-- **cleanupRepository()**: Removes temporary repository after installation
-
-#### 4. Installation Orchestrator (install-orchestrator.ts)
-
-Executes the actual installation:
-
-- **runInstallation()**: Main installation coordinator
-- **executeInstallScript()**: Spawns bash process with input piping
-- **backupExistingHooks()**: Creates timestamped backups
-- **verifyInstallation()**: Checks for expected files and settings
-- **restoreBackup()**: Rollback capability on failure
-- **testHooks()**: Triggers test notifications
-
-## Installation Flow
-
-### Step-by-Step Process
-
-1. **Dependency Check**
-
-   - Validates Node.js, npm, and Git are available
-   - Can be skipped with `--force` flag (not recommended)
-
-2. **User Prompting**
-
-   - Uses schema.json to generate prompts
-   - Reuses prompt-utils from init generator
-   - Options: notification type, voice selection, update, backup
-
-3. **Hook Download**
-
-   - Downloads latest hook files to temp directory
-   - Always fetches latest version
-   - Handles download with automatic fallback
-
-4. **Backup Creation**
-
-   - Backs up ~/.claude/hooks/\* if exists
-   - Saves settings.json state
-   - Creates timestamped backup directory
-
-5. **Script Execution**
-
-   - Runs installation script
-   - Pipes user selections to script stdin
-   - Handles interactive script input programmatically
-
-6. **Verification**
-
-   - Checks for notification.ts, stop.ts, subagent_stop.ts
-   - Validates settings.json has hooks configuration
-   - Returns list of installed files
-
-7. **Optional Testing**
-
-   - In verbose mode, offers to test hooks
-   - Executes notification hook with test payload
-   - User should hear/see the notification
-
-8. **Cleanup**
-   - Removes temporary repository (unless --verbose)
-   - Preserves backup for user reference
-
-## Generator Options
-
-### Schema Properties
-
-```typescript
-interface HooksGeneratorSchema {
-  notificationType?: 'sound' | 'speech'; // Default: 'sound'
-  voiceSelection?: string; // For speech mode
-  backup?: boolean; // Create backup (default: true)
-  'dry-run'?: boolean; // Preview without changes
-  force?: boolean; // Skip dependency checks
-  verbose?: boolean; // Detailed output
-  installMode?: 'default' | 'custom'; // Installation mode from parent generator (hidden)
-}
-```
-
-### installMode Parameter
-
-The `installMode` parameter is a **hidden** parameter designed for programmatic use only. It's passed from parent generators (like `init`) to control the prompting behavior:
-
-- **`'default'`**: Skips all interactive prompts and uses default values for all options. This provides a streamlined, non-interactive installation experience.
-- **`'custom'`**: (or undefined): Enables full interactive prompting, allowing users to configure all options through CLI prompts.
-
-**Usage Pattern**:
-
-```typescript
-// Called programmatically from init generator in default mode
-await hooksGenerator(tree, {
-  installMode: 'default', // Skips all prompts
-  force: false,
-  dry: false,
-  backup: true,
-  verbose: false,
-});
-
-// Called programmatically from init generator in custom mode (or standalone)
-await hooksGenerator(tree, {
-  // installMode omitted or 'custom' - enables prompts
-  force: false,
-});
-```
-
-**Implementation**: When `installMode === 'default'`, the generator bypasses the entire `promptForMissingOptions()` flow and constructs the normalized options directly using default values.
-
-### Input Handling
-
-The generator pipes input to the install-global.sh script based on options:
-
-- Sound mode: Sends "1\n"
-- Speech mode: Sends "2\n" followed by voice selection if provided
-
-## File Operations
-
-### Created Files
-
-```
-~/.claude/
-├── hooks/
-│   ├── notification.ts    # User input needed hook
-│   ├── stop.ts           # Execution stopped hook
-│   └── subagent_stop.ts  # Subagent stopped hook
-└── settings.json         # Updated with hook paths
-```
-
-### Backup Structure
-
-```
-~/.claude/
-└── hooks-backup-2024-01-01T12-00-00-000Z/
-    ├── notification.ts
-    ├── stop.ts
-    ├── subagent_stop.ts
-    └── settings.json.backup
-```
-
-## Error Handling
-
-### Failure Scenarios
-
-1. **Missing Dependencies**: Clear error messages with installation instructions
-2. **Git Clone Failure**: Falls back from HTTPS to SSH for default repo
-3. **Script Execution Failure**: Captures exit codes and stderr
-4. **Verification Failure**: Lists missing files, attempts rollback
-5. **Backup Restoration**: Automatic rollback on installation failure
-
-### Recovery Mechanisms
-
-- Backup restoration on failure
-- Force flag to bypass checks
-- Verbose mode for debugging
-- Dry-run for preview
-
-## Cross-Platform Considerations
-
-### Dependency Detection
-
-- **Node/npm**: Uses `which` on Unix, `where` on Windows
-- **Git**: Standard git commands work cross-platform
-- **Paths**: Uses Node.js path module for OS-appropriate separators
-
-### Notification Support
-
-The hooks handle platform differences automatically:
-
-- **macOS**: afplay for sound, say for speech
-- **Windows**: PowerShell for sound, SAPI for speech
-- **Linux**: aplay/paplay for sound, espeak/festival for speech
-
-## Testing Strategy
-
-### Unit Tests (generator.spec.ts)
-
-Should test:
-
-- Schema validation
-- Dependency checking logic
-- Repository management operations
-- Backup/restore functionality
-- Script execution with mocked child_process
-
-### Integration Testing
-
-Manual testing checklist:
-
-1. Fresh installation with sound
-2. Fresh installation with speech
-3. Update existing installation
-4. Dry-run mode verification
-5. Force mode with missing dependencies
-6. Backup and restore flow
-7. Custom repository usage
-
-## Development Notes
-
-### Programmatic Usage Pattern
-
-This generator implements the **installMode pattern** for sub-generators:
-
-**Purpose**: Prevent duplicate prompting when generators are called programmatically from parent generators.
-
-**Implementation**:
-
-1. Add `installMode?: 'default' | 'custom'` to schema with `hidden: true`
-2. Add `installMode?: 'default' | 'custom'` to TypeScript interface
-3. In generator.ts, check `if (options.installMode === 'default')` before prompting
-4. When 'default', construct normalized options with defaults instead of prompting
-5. When undefined or 'custom', proceed with normal prompting flow
-
-**Why This Works**:
-
-- Hidden schema properties don't show up in CLI help or prompts
-- Parent generators can pass the mode to control child behavior
-- Avoids issues with `getExplicitlyProvidedOptions()` reading `process.argv`
-- Each generator maintains backward compatibility (works standalone or programmatically)
-
-**Pattern Applied**: This pattern is used across all sub-generators that are called from the `init` generator (hooks, addons, etc.).
-
-### Adding New Features
-
-To extend the generator:
-
-1. Update schema.json with new options
-2. Update schema.d.ts TypeScript interface
-3. Modify generator.ts to handle new options
-4. Update prompt flow if interactive
-5. Add tests for new functionality
-6. Update README.md and CLAUDE.md
-
-### Debugging
-
-Use verbose mode to debug issues:
-
-```bash
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --verbose
-```
-
-This preserves the cloned repository and shows detailed output.
-
-### Common Issues
-
-1. **Script Permission Denied**: The generator runs `chmod +x` on install-global.sh
-2. **Input Not Received**: Script stdin is properly ended after writing
-3. **Repository Already Exists**: Handles existing repos, can force update
-4. **Hooks Not Triggering**: Verification step ensures proper installation
-
-## Integration with Nx
-
-### Generator Registration
-
-Registered in `packages/ai-toolkit-nx-claude/generators.json`:
-
-```json
-{
-  "generators": {
-    "hooks": {
-      "factory": "./dist/generators/hooks/generator",
-      "schema": "./dist/generators/hooks/schema.json",
-      "description": "Install Claude Code notification hooks using awesome-claude-code"
-    }
-  }
-}
-```
-
-### Building and Testing
-
-```bash
-# Build the generator
-npx nx build nx-claude
-
-# Run tests
-npx nx test nx-claude
-
-# Test locally
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --dry-run
-```
-
-## Future Enhancements
-
-Potential improvements (not yet implemented):
-
-1. **Custom Sound Files**: Allow users to provide their own notification sounds
-2. **Hook Templates**: Provide customizable hook templates
-3. **Multiple Notification Channels**: Support multiple simultaneous notifications
-4. **Notification Rules**: Configure when notifications should fire
-5. **Integration with IDEs**: VS Code extension integration
-6. **Metrics/Analytics**: Track notification patterns
-
-## Maintenance Requirements
-
-⚠️ **IMPORTANT**: This CLAUDE.md file must be updated whenever the hooks generator changes:
-
-- New options or parameters
-- Changes to installation flow
-- Updates to file structure
-- New dependencies or requirements
-- Bug fixes that change behavior
-- Integration with new hook versions
-
-The documentation should always reflect the current state of the generator implementation to ensure AI assistants have accurate information.
-
-## Credits
-
-This generator provides an Nx-integrated installation experience for Claude Code notification hooks.

package/dist/generators/hooks/README.md

@@ -1,220 +0,0 @@
-# Claude Code Hooks Generator
-
-## Overview
-
-The `hooks` generator automatically installs notification hooks for Claude Code. These hooks provide audio notifications when Claude needs user input, improving the development workflow by alerting you when your attention is required.
-
-## Features
-
-- 🔔 **Sound Notifications**: Custom sound alerts when Claude needs input
-- 🔄 **Auto-update**: Always installs the latest version
-- 💾 **Backup & Restore**: Automatically backs up existing configurations
-- 🧪 **Test Mode**: Verify hooks are working correctly
-- 🌍 **Cross-platform**: Works on macOS, Windows, and Linux
-
-## Prerequisites
-
-The generator will check for these dependencies and warn if missing:
-
-- **Node.js** (v16 or higher)
-- **npm** (for executing TypeScript hooks)
-- **Git** (for downloading hook files)
-
-## Installation
-
-### Run the Generator
-
-```bash
-# From any directory (installs globally to ~/.claude/hooks/)
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks
-
-# Or with npm
-npm run nx generate @uniswap/ai-toolkit-nx-claude:hooks
-```
-
-### Interactive Mode (Default)
-
-When run without options, the generator will interactively prompt for:
-
-1. **Backup**: Whether to backup existing configuration
-2. **Dry Run**: Preview changes without installation
-3. **Verbose**: Show detailed output
-
-### Non-Interactive Examples
-
-```bash
-# Install with all defaults (using Nx's built-in flag)
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --no-interactive
-
-# Dry run to preview changes
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --dry
-
-# Also works with --dry-run alias for Nx compatibility
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --dry-run
-
-# Skip backup during installation
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --backup=false --no-interactive
-
-# Force installation (skip dependency checks)
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --force
-
-# Verbose output for debugging
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --verbose
-```
-
-## Generator Options
-
-| Option    | Type      | Default | Description                                   |
-| --------- | --------- | ------- | --------------------------------------------- |
-| `backup`  | `boolean` | `true`  | Backup existing hooks before installation     |
-| `dry`     | `boolean` | `false` | Preview installation without making changes   |
-| `dry-run` | `boolean` | `false` | Alias for `dry` (for Nx compatibility)        |
-| `force`   | `boolean` | `false` | Skip dependency checks and force installation |
-| `verbose` | `boolean` | `false` | Show detailed output during installation      |
-
-**Note**: Use Nx's built-in `--no-interactive` flag to skip all prompts and use defaults.
-
-## What Gets Installed
-
-The generator installs the following hooks to `~/.claude/hooks/`:
-
-### Hook Files
-
-- **notification.ts**: Triggered when Claude needs user input
-- **stop.ts**: Triggered when Claude stops execution
-- **subagent_stop.ts**: Triggered when a subagent stops
-
-### Configuration
-
-The generator also updates `~/.claude/settings.json` to register the hooks:
-
-```json
-{
-  "hooks": {
-    "notification": "~/.claude/hooks/notification.ts",
-    "stop": "~/.claude/hooks/stop.ts",
-    "subagent_stop": "~/.claude/hooks/subagent_stop.ts"
-  }
-}
-```
-
-## Platform Support
-
-The notification system automatically detects and uses the appropriate audio playback method for your platform:
-
-- **macOS**: Uses `afplay` (built-in)
-- **Windows**: Uses PowerShell audio playback
-- **Linux**: Uses `aplay` or `paplay`
-
-## Testing the Installation
-
-After installation, you can test the hooks:
-
-```bash
-# Run with verbose flag to get testing option
-npx nx generate @uniswap/ai-toolkit-nx-claude:hooks --verbose
-
-# When prompted, choose to test the hooks
-# You should hear a notification sound
-```
-
-## Backup and Recovery
-
-### Automatic Backup
-
-By default, the generator creates a backup before modifying existing hooks:
-
-- Backup location: `~/.claude/hooks-backup-[timestamp]/`
-- Includes all hook files and settings.json
-
-### Manual Recovery
-
-If you need to restore a backup:
-
-```bash
-# List backups
-ls -la ~/.claude/hooks-backup-*
-
-# Restore a specific backup
-cp -r ~/.claude/hooks-backup-2024-01-01T12-00-00/* ~/.claude/hooks/
-```
-
-## Troubleshooting
-
-### Missing Dependencies
-
-If you see dependency warnings:
-
-```bash
-# Install Node.js
-# Visit https://nodejs.org or use a version manager like nvm
-
-# Install Git
-# macOS: brew install git
-# Ubuntu/Debian: sudo apt-get install git
-# Windows: Download from https://git-scm.com
-```
-
-### Hooks Not Working
-
-1. **Verify Installation**:
-
-   ```bash
-   ls -la ~/.claude/hooks/
-   cat ~/.claude/settings.json | grep hooks
-   ```
-
-2. **Check TypeScript Execution**:
-
-   ```bash
-   npx tsx --version
-   ```
-
-3. **Test Manually**:
-
-   ```bash
-   echo '{"hook_event_name":"Notification"}' | npx tsx ~/.claude/hooks/notification.ts
-   ```
-
-### Sound Not Playing
-
-- **macOS**: Check System Preferences > Sound > Sound Effects volume
-- **Windows**: Check Windows Volume Mixer settings
-- **Linux**: Verify audio packages are installed (`sudo apt-get install alsa-utils`)
-
-## Customization
-
-### Modifying Installed Hooks
-
-After installation, you can customize the hooks by editing files in `~/.claude/hooks/`. The TypeScript files can be modified to:
-
-- Change notification sounds
-- Customize speech messages
-- Add logging or debugging
-- Integrate with other tools
-
-## How It Works
-
-1. **Dependency Check**: Verifies Node.js, npm, and Git are installed
-2. **Download**: Fetches the latest hook files
-3. **Backup Creation**: Saves existing configuration if present
-4. **Script Execution**: Runs the installation script
-5. **Verification**: Confirms hooks are properly installed
-6. **Cleanup**: Removes temporary files (unless --verbose is used)
-
-## Credits
-
-This generator provides an automated installation process for Claude Code notification hooks, integrated with the Nx toolchain.
-
-## Contributing
-
-To contribute to this generator:
-
-1. Fork or pull down the AI Toolkit repository
-2. Make your changes in `packages/ai-toolkit-nx-claude/src/generators/hooks/`
-3. Add tests in `packages/ai-toolkit-nx-claude/src/generators/hooks/generator.spec.ts`
-4. Submit a pull request
-
-## License
-
-This generator is part of the AI Toolkit project.