@paulduvall/claude-dev-toolkit 0.0.1-alpha.2 → 0.0.1-alpha.21

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Paul Duvall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,12 @@
 # Claude Dev Toolkit
 
-[![npm version](https://badge.fury.io/js/claude-dev-toolkit.svg)](https://www.npmjs.com/package/claude-dev-toolkit)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-![Test Status](https://img.shields.io/badge/tests-100%25%20passing-brightgreen)
-![Active Commands](https://img.shields.io/badge/active%20commands-13-blue)
-![Experimental Commands](https://img.shields.io/badge/experimental%20commands-45-orange)
-![Total Commands](https://img.shields.io/badge/total%20commands-58-brightgreen)
-
-**Transform Claude Code into a complete development platform** with 58 AI-powered custom commands that automate your entire software development workflow.
+**Transform Claude Code into a complete development platform** with 62 AI-powered custom commands that automate your entire software development workflow.
 
 ## 🚀 Quick Installation
 
 ```bash
 # Install globally via NPM
-npm install -g claude-dev-toolkit
+npm install -g @paulduvall/claude-dev-toolkit
 
 # Commands are immediately available in Claude Code
 claude
@@ -22,33 +15,34 @@ claude
 
 ## 📦 What's Included
 
-- **13 Active Commands**: Production-ready commands for immediate use
-- **45 Experimental Commands**: Cutting-edge features for early adopters  
+- **16 Active Commands**: Production-ready commands for immediate use
+- **46 Experimental Commands**: Cutting-edge features for early adopters  
 - **Security Hooks**: Automated security validation and governance
 - **Configuration Templates**: Pre-configured settings for different workflows
 - **Interactive Setup Wizard**: Guided installation with customization options
-- **JavaScript Test Suite**: 100% test coverage with 10 comprehensive test suites
+- **JavaScript Test Suite**: 25 test suites validating package structure, commands, and integration
 
 ## 🎯 Quick Start
 
 ### Option 1: Automatic Setup (Recommended)
 ```bash
-npm install -g claude-dev-toolkit
+npm install -g @paulduvall/claude-dev-toolkit
 # Interactive setup wizard runs automatically
 ```
 
 ### Option 2: Manual Command Installation
 ```bash
 # Install specific command sets
-claude-commands install --active        # Install 13 production commands
-claude-commands install --experimental  # Install 45 experimental commands  
-claude-commands install --all           # Install all 58 commands
+claude-commands install --active        # Install 16 production commands
+claude-commands install --experiments  # Install 46 experimental commands
+claude-commands install --all           # Install all 62 commands
 ```
 
 ### Option 3: Custom Installation
 ```bash
 claude-commands list                     # See all available commands
 claude-commands status                   # Check installation status
+claude-commands oidc --help             # Configure GitHub Actions OIDC with AWS
 ```
 
 ## 📋 Available Commands
@@ -74,7 +68,7 @@ claude-commands status                   # Check installation status
 - **`/xconfig`** - Configuration management
 - **`/xtdd`** - Test-driven development automation
 
-### 🧪 **Experimental Commands** (45 Additional)
+### 🧪 **Experimental Commands** (46 Additional)
 Advanced commands for specialized workflows:
 - **Planning & Analytics**: `/xplanning`, `/xanalytics`, `/xmetrics`
 - **Infrastructure**: `/xinfra`, `/xmonitoring`, `/xaws`
@@ -89,9 +83,24 @@ Advanced commands for specialized workflows:
 claude-commands list                    # List all available commands
 claude-commands status                  # Show installation status
 claude-commands install --active       # Install production commands
-claude-commands install --experimental # Install experimental commands
+claude-commands install --experiments # Install experimental commands
 claude-commands install --all          # Install all commands
 
+# Configuration Management
+claude-commands config --list          # List available templates
+claude-commands config --template <name> # Apply configuration template
+claude-commands config --help          # Show config command help
+
+# OIDC Configuration (NEW)
+claude-commands oidc --help            # Show OIDC configuration options
+claude-commands oidc --dry-run         # Preview OIDC setup actions
+claude-commands oidc --region us-west-2 --stack-name my-oidc # Configure AWS OIDC
+
+# Subagents Management
+claude-commands subagents --list        # List available subagents
+claude-commands subagents --install     # Install subagents to Claude Code
+claude-commands subagents --help        # Show subagents command help
+
 # In Claude Code
 /xhelp                                 # Show command help
 /xtest                                 # Run intelligent test suite
@@ -102,19 +111,37 @@ claude-commands install --all          # Install all commands
 
 ## 🔧 Configuration
 
+### Configuration Management
+
+Use the built-in config command to manage Claude Code settings:
+
+```bash
+# List available configuration templates
+claude-commands config --list
+
+# Apply a specific template
+claude-commands config --template basic-settings.json
+claude-commands config --template security-focused-settings.json  
+claude-commands config --template comprehensive-settings.json
+
+# Show help for config command
+claude-commands config --help
+```
+
 ### Installation Locations
 - **Commands**: `~/.claude/commands/active/` and `~/.claude/commands/experiments/`
 - **Configuration**: `~/.claude/settings.json`
 - **Security Hooks**: `~/.claude/hooks/`
+- **Templates**: Bundled with package installation
 
 ### Configuration Templates
 The package includes three pre-configured templates:
 
 1. **Basic** (`basic-settings.json`): Minimal setup for command functionality
-2. **Security-Focused** (`security-focused-settings.json`): Enhanced security with hooks
+2. **Security-Focused** (`security-focused-settings.json`): Enhanced security with hooks  
 3. **Comprehensive** (`comprehensive-settings.json`): Full feature set with governance
 
-Templates are automatically applied during interactive setup or can be manually copied to `~/.claude/settings.json`.
+Templates are applied via the config command with automatic backup of existing settings.
 
 ## 🧪 Development & Testing
 
@@ -127,6 +154,8 @@ npm test
 npm run test:commands     # Command validation
 npm run test:workflow     # Core workflow tests
 npm run test:security     # Security command tests
+npm run test:config       # Configuration command tests
+npm run test:subagents    # Subagents CLI command tests
 npm run test:req007       # Interactive setup wizard
 npm run test:req009       # Configuration templates
 npm run test:req018       # Security hook installation
@@ -137,15 +166,15 @@ npm run lint             # Code linting
 ```
 
 ### Test Coverage
-- **10 Test Suites**: 100% passing
-- **Command Validation**: All 58 commands validated
-- **Security Tests**: Comprehensive security pattern validation
-- **Integration Tests**: End-to-end workflow testing
-- **Configuration Tests**: Template and setup validation
+- **25 Test Suites**: Package structure, CLI, and command validation
+- **Command Validation**: All commands validated for structure and naming
+- **Security Tests**: Credential exposure and placeholder detection
+- **Integration Tests**: Hook and subagent workflow testing
+- **Shell Tests**: 8 bash test suites for hooks and lib modules
 
 ### Architecture
-- **Symlink Consolidation**: Single source of truth with root directory
-- **JavaScript-Based**: Migrated from Python for better Node.js integration
+- **Self-Contained Package**: No dependencies on repository cloning
+- **JavaScript-Based**: Native Node.js integration with comprehensive testing
 - **Modular Design**: Separate installer, config, and validation modules
 - **Cross-Platform**: Works on macOS, Linux, and Windows
 
@@ -173,7 +202,7 @@ claude-commands install --active       # Reinstall commands
 chmod 755 ~/.claude/commands/*.md      # Fix permissions
 
 # Missing experimental commands?
-claude-commands install --experimental # Install experimental set
+claude-commands install --experiments # Install experimental set
 
 # Test failures?
 npm test                               # Run full test suite
@@ -182,13 +211,13 @@ npm run validate                       # Validate package
 
 ### Validation Commands
 ```bash
-# Repository validation (from main repo)
-./validate-commands.sh                 # JavaScript-based validation
-./verify-setup.sh                     # Complete setup verification
-
 # Package validation
 npm run validate                       # Package structure validation
 npm test                              # Comprehensive test suite
+
+# CLI validation
+claude-commands verify                 # Complete setup verification
+claude-commands list                   # Check installed commands
 ```
 
 ## 📚 Documentation
@@ -204,6 +233,7 @@ Every command includes built-in help:
 /xtest help         # Show all testing options
 /xquality help      # Show quality check options  
 /xsecurity help     # Show security scanning options
+/xconfig help       # Show configuration options
 ```
 
 ## 🤝 Contributing
@@ -221,8 +251,8 @@ npm test
 ```
 
 ### Adding Commands
-1. Create command files in root `slash-commands/active/` or `slash-commands/experiments/`
-2. Commands automatically sync to NPM package via symlinks
+1. Create command files in repository `slash-commands/active/` or `slash-commands/experiments/`
+2. Commands are included in NPM package through build process
 3. Validate with `npm run test:commands`
 4. Follow existing patterns and security guidelines
 
@@ -233,12 +263,33 @@ npm test
 
 ## 🔄 Recent Updates
 
-### Version 0.0.1-alpha.1
+### Version 0.0.1-alpha.9
+- ✅ **NEW: OIDC Command**: GitHub Actions to AWS OIDC integration (`claude-commands oidc`)
+- ✅ **TDD Implementation**: Phase 1 foundation with comprehensive test coverage (14/14 tests)
+- ✅ **CLI Integration**: Full command-line interface with help, dry-run, and configuration options
+- ✅ **Error Framework**: Enhanced error handling with context-aware recovery suggestions
+- ✅ **Dependency Validation**: AWS CLI, Git, and GitHub CLI availability checking
+
+### Version 0.0.1-alpha.8
+- ✅ **Documentation Consistency**: Fixed command counts and subagent counts
+- ✅ **Test Infrastructure**: Enhanced test-results directory handling
+- ✅ **Repository Cleanup**: Removed outdated documentation and test artifacts
+- ✅ **Validation Logic**: Improved scenario-aware test validation
+- ✅ **Version Alignment**: Synchronized all version references
+
+### Version 0.0.1-alpha.7
+- ✅ **NPM Scoped Package**: Published as `@paulduvall/claude-dev-toolkit`
+- ✅ **Configuration Command**: Built-in `config` command for template management
+- ✅ **Workflow Reporting**: Comprehensive GitHub Actions reporting
+- ✅ **Subagents Support**: Multi-agent coordination capabilities
+- ✅ **Enhanced Documentation**: Updated installation and usage instructions
+
+### Version 0.0.1-alpha.2
 - ✅ **Symlink Consolidation**: Eliminated duplicate directories
 - ✅ **JavaScript Migration**: Complete test suite migration from Python
 - ✅ **Enhanced Templates**: Fixed configuration template issues
-- ✅ **100% Test Coverage**: All 10 test suites passing
-- ✅ **58 Total Commands**: 13 active + 45 experimental commands
+- ✅ **Test Suites**: Package structure and command validation
+- ✅ **62 Total Commands**: 16 active + 46 experimental commands
 - ✅ **Security Enhancements**: Comprehensive security hook system
 
 ## 📄 License