claude-dev-cli 0.16.0__py3-none-any.whl → 0.16.2__py3-none-any.whl

claude_dev_cli/__init__.py

@@ -9,7 +9,7 @@ Features:
 - Interactive and single-shot modes
 """
 
-__version__ = "0.16.0"
+__version__ = "0.16.2"
 __author__ = "Julio"
 __license__ = "MIT"
 

claude_dev_cli/workflows.py

@@ -130,6 +130,7 @@ class WorkflowEngine:
             generate_tests, code_review, debug_code, 
             generate_docs, refactor_code, git_commit_message
         )
+        from claude_dev_cli.core import ClaudeClient
         
         # Map commands to functions
         command_map = {
@@ -141,11 +142,23 @@ class WorkflowEngine:
             'git commit': git_commit_message,
         }
         
+        # Handle special commands that need different execution
+        if command == 'ask':
+            return self._execute_ask_command(interpolated_args)
+        elif command in ['generate code', 'generate feature']:
+            # These are CLI-only commands that would need file generation logic
+            # For now, redirect to shell equivalent
+            return StepResult(
+                success=False,
+                output="",
+                error=f"Command '{command}' not yet supported in workflows. Use shell step with 'cdc {command}' instead."
+            )
+        
         if command not in command_map:
             return StepResult(
                 success=False,
                 output="",
-                error=f"Unknown command: {command}"
+                error=f"Unknown command: {command}. Supported: {', '.join(command_map.keys())}, ask"
             )
         
         try:
@@ -159,6 +172,8 @@ class WorkflowEngine:
                 func_args['error_message'] = interpolated_args['error']
             if 'api' in interpolated_args:
                 func_args['api_config_name'] = interpolated_args['api']
+            if 'model' in interpolated_args:
+                func_args['model'] = interpolated_args['model']
             
             # Execute
             result = func(**func_args)
@@ -180,6 +195,39 @@ class WorkflowEngine:
                 error=str(e)
             )
     
+    def _execute_ask_command(self, args: Dict[str, Any]) -> StepResult:
+        """Execute an ask command step."""
+        try:
+            from claude_dev_cli.core import ClaudeClient
+            
+            prompt = args.get('prompt', args.get('question', ''))
+            if not prompt:
+                return StepResult(
+                    success=False,
+                    output="",
+                    error="ask command requires 'prompt' or 'question' argument"
+                )
+            
+            api = args.get('api')
+            model = args.get('model')
+            system = args.get('system')
+            
+            client = ClaudeClient(api_config_name=api)
+            result = client.call(prompt, system_prompt=system, model=model)
+            
+            return StepResult(
+                success=True,
+                output=result,
+                metadata={'command': 'ask'}
+            )
+        
+        except Exception as e:
+            return StepResult(
+                success=False,
+                output="",
+                error=str(e)
+            )
+    
     def _execute_shell_step(self, step: Dict[str, Any], context: WorkflowContext) -> StepResult:
         """Execute a shell command step."""
         command = step['shell']

{claude_dev_cli-0.16.0.dist-info → claude_dev_cli-0.16.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-dev-cli
-Version: 0.16.0
+Version: 0.16.2
 Summary: A powerful CLI tool for developers using Claude AI with multi-API routing, test generation, code review, and usage tracking
 Author-email: Julio <thinmanj@users.noreply.github.com>
 License: MIT
@@ -175,6 +175,17 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
 - **Project Memory**: Remember preferences per project
 - **Global Config**: Set context defaults in `~/.claude-dev-cli/config.json`
 
+### 🔄 Workflows (v0.7.0+, Enhanced v0.16.1)
+- **Multi-Step Automation**: Chain AI operations and shell commands with YAML
+- **AI Decision Making**: Use `ask` command to make intelligent workflow decisions (v0.16.1)
+- **Variable Interpolation**: Pass data between steps with `{{variable}}` syntax
+- **Conditional Execution**: Skip steps based on conditions with `if` clauses
+- **Approval Gates**: Human-in-the-loop with `approval_required: true`
+- **Model Selection**: Use different AI models per step for cost optimization (v0.16.1)
+- **Error Handling**: Continue on failure with `continue_on_error: true`
+- **Three Step Types**: command (cdc), shell (bash/zsh), set (variables)
+- **Cost Optimization**: Mix free local AI with paid cloud AI strategically
+
 ### 🎒 TOON Format Support (Optional)
 - **Token Reduction**: 30-60% fewer tokens than JSON
 - **Cost Savings**: Reduce API costs significantly
@@ -770,7 +781,208 @@ cdc history delete 20240109_143022
 - Reduces API costs by ~30-50% in long conversations
 - Shows token savings after summarization
 
-### 7. Usage Tracking
+### 7. Workflows - AI-Powered Automation (v0.7.0+, Enhanced v0.16.1)
+
+Chain multiple AI operations into automated sequences with YAML workflows.
+
+#### Basic Workflow Usage
+
+```bash
+# Run a workflow
+cdc workflow run my-workflow.yaml
+
+# Pass variables
+cdc workflow run workflow.yaml --var file=main.py --var api=local
+
+# List available workflows
+cdc workflow list
+
+# Show workflow details
+cdc workflow show workflow.yaml
+```
+
+#### Example: Simple Review & Test Workflow
+
+```yaml
+name: "Review and Test"
+description: "Review code and generate tests"
+
+steps:
+  - name: code-review
+    command: review
+    args:
+      file: "{{target_file}}"
+      api: "local"  # Use FREE local AI
+      model: "smart-local"
+    output_var: review_result
+  
+  - name: generate-tests
+    command: generate tests
+    args:
+      file: "{{target_file}}"
+      api: "local"
+      model: "code-local"
+    output_var: tests
+  
+  - name: run-tests
+    shell: "pytest tests/"
+    continue_on_error: true
+```
+
+**Run it:**
+```bash
+cdc workflow run review-test.yaml --var target_file=app.py
+```
+
+#### Example: AI Decision Making (NEW in v0.16.1)
+
+Use the `ask` command to make intelligent workflow decisions:
+
+```yaml
+name: "Adaptive Code Analysis"
+description: "AI analyzes code complexity and adapts workflow"
+
+steps:
+  # AI rates complexity
+  - name: check-complexity
+    command: ask
+    args:
+      prompt: "Rate this code complexity 1-10, respond with number only: {{code}}"
+      api: "local"  # FREE
+      model: "fast-local"
+    output_var: complexity
+  
+  # Conditional deep review for complex code
+  - name: deep-review
+    command: review
+    args:
+      file: "{{file}}"
+      api: "personal"  # Use paid API for complex code
+      model: "powerful"
+    if: "{{complexity}} > 7"
+    approval_required: true  # Ask before using paid API
+  
+  # Simple refactor for medium complexity
+  - name: simple-refactor
+    command: refactor
+    args:
+      file: "{{file}}"
+      api: "local"  # FREE
+    if: "{{complexity}} >= 5 and {{complexity}} <= 7"
+```
+
+**Key Features:**
+- ✨ `ask` command for AI queries
+- 💰 Mix free local and paid cloud AI
+- 🎯 Conditional execution based on AI responses  
+- ✋ Approval gates before expensive operations
+
+#### Example: Cost-Optimized Workflow
+
+```yaml
+name: "Smart Cost Optimization"
+description: "Use local AI first, cloud only when critical"
+
+steps:
+  # Quick scan with FREE local AI
+  - name: quick-scan
+    command: ask
+    args:
+      prompt: "Quick scan for obvious issues: {{code}}"
+      api: "local"  # FREE
+      model: "fast-local"
+    output_var: issues
+  
+  # Only use expensive cloud AI if critical issues found
+  - name: deep-security-analysis
+    command: ask
+    args:
+      prompt: "Deep security analysis: {{code}}"
+      api: "personal"  # PAID
+      model: "powerful"  # Claude Opus - expensive
+      system: "You are a security expert"
+    if: "{{issues}} contains 'critical' or {{issues}} contains 'security'"
+    approval_required: true
+  
+  # Tests with local code-specialized model (FREE)
+  - name: generate-tests
+    command: generate tests
+    args:
+      file: "{{file}}"
+      api: "local"  # FREE
+      model: "code-local"
+```
+
+**Cost Savings:**
+- Local AI for initial scans: $0
+- Cloud AI only when needed: saves 70-90%
+- Approval gates prevent accidental costs
+
+#### Workflow Step Types
+
+**1. Command Steps (cdc commands)**
+```yaml
+- name: review-code
+  command: review  # or: generate tests, debug, refactor, etc.
+  args:
+    file: "{{file}}"
+    api: "local"
+    model: "smart-local"
+  output_var: result
+```
+
+**Supported commands:** `review`, `generate tests`, `generate docs`, `refactor`, `debug`, `git commit`, `ask` (v0.16.1)
+
+**2. Shell Steps (any command)**
+```yaml
+- name: run-tests
+  shell: "pytest tests/ -v"
+  output_var: test_output
+  continue_on_error: true
+```
+
+**3. Set Steps (variables)**
+```yaml
+- name: set-config
+  set: api_endpoint
+  value: "https://api.example.com"
+```
+
+#### Advanced Features
+
+**Conditional Execution:**
+```yaml
+if: "{{score}} > 7"  # Simple comparison
+if: "{{result}} contains 'error'"  # String matching
+if: "{{tests.success}}"  # Access step results
+```
+
+**Approval Gates:**
+```yaml
+approval_required: true  # Pause for user confirmation
+```
+
+**Error Handling:**
+```yaml
+continue_on_error: true  # Don't stop workflow on failure
+```
+
+**Variable Interpolation:**
+```yaml
+{{variable}}  # Simple variable
+{{step_name.output}}  # Step output
+{{step_name.success}}  # Step success status
+```
+
+#### Example Workflows Included
+
+**Location:** `examples/workflows/`
+
+1. **review-and-refactor.yaml** - Basic review workflow
+2. **ai-decision-workflow.yaml** - AI-powered decisions (v0.16.1)
+3. **multi-model-workflow.yaml** - Cost optimization (v0.16.1)
+
+### 8. Usage Tracking
 
 ```bash
 # View all usage
@@ -783,7 +995,7 @@ cdc usage --days 7
 cdc usage --api client
 ```
 
-### 7. TOON Format (Optional - Reduces Tokens by 30-60%)
+### 9. TOON Format (Optional - Reduces Tokens by 30-60%)
 
 ```bash
 # Check if TOON is installed
@@ -952,6 +1164,31 @@ When using a client's Enterprise API:
 |---------|-------------|
 | `cdc git commit` | Generate commit message |
 
+### Workflows (v0.7.0+)
+
+| Command | Description |
+|---------|-------------|
+| `cdc workflow run <file>` | Execute workflow from YAML |
+| `cdc workflow list` | List available workflows |
+| `cdc workflow show <file>` | Show workflow details |
+
+### Ollama (Local AI) (v0.16.0+)
+
+| Command | Description |
+|---------|-------------|
+| `cdc ollama list` | List local models |
+| `cdc ollama pull <model>` | Download model |
+| `cdc ollama show <model>` | Show model details |
+
+### Model Profiles (v0.10.0+)
+
+| Command | Description |
+|---------|-------------|
+| `cdc model list` | List all model profiles |
+| `cdc model show <name>` | Show profile details |
+| `cdc model add <name> <model_id>` | Add custom profile |
+| `cdc model set-default <name>` | Set default profile |
+
 ## Options
 
 ### Common Options
@@ -962,11 +1199,33 @@ When using a client's Enterprise API:
 - `-f, --file <path>`: Include file in prompt
 - `-o, --output <path>`: Save output to file
 
-### Models
+### Model Profiles
+
+**Anthropic (Claude):**
+- `fast` / `claude-3-5-haiku-20241022` - Fast & economical ($0.80/$4 per Mtok)
+- `smart` / `claude-sonnet-4-5-20250929` - Balanced (default) ($3/$15 per Mtok)
+- `powerful` / `claude-opus-4-20250514` - Most capable ($15/$75 per Mtok)
+
+**OpenAI (GPT):** (requires `pip install 'claude-dev-cli[openai]'`)
+- `fast-openai` / `gpt-3.5-turbo` - Fast & cheap ($0.50/$1.50 per Mtok)
+- `smart-openai` / `gpt-4-turbo` - Balanced ($10/$30 per Mtok)
+- `powerful-openai` / `gpt-4` - High capability ($30/$60 per Mtok)
+
+**Ollama (Local - FREE):** (requires `pip install 'claude-dev-cli[ollama]'`)
+- `fast-local` / `mistral` - Fast inference (8k context, FREE)
+- `smart-local` / `mixtral` - Powerful reasoning (32k context, FREE)
+- `code-local` / `codellama` - Code specialist (16k context, FREE)
 
-- `claude-3-5-sonnet-20241022` (default)
-- `claude-3-opus-20240229`
-- `claude-3-haiku-20240307`
+**Usage:**
+```bash
+# Use model profile
+cdc ask -m fast "quick question"  # Uses Haiku
+cdc ask -m fast-local "question"  # Uses Mistral (FREE)
+
+# Use specific model ID
+cdc ask -m claude-opus-4-20250514 "complex task"
+cdc ask -m gpt-4-turbo "openai task"
+```
 
 ## Examples
 

{claude_dev_cli-0.16.0.dist-info → claude_dev_cli-0.16.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-claude_dev_cli/__init__.py,sha256=kYIzIW-2GfcMEdRmvAB0S6560l0r5X11CNH1UhDs3bw,470
+claude_dev_cli/__init__.py,sha256=UX6d3t4T9Y3Ju9Ip1rBlnMGEx89aGVZDtqX6Gof6jV4,470
 claude_dev_cli/cli.py,sha256=wy3IOb4qvCM64hQ8PKMuAvouY4ln95U2DeyeWbe0I4E,108673
 claude_dev_cli/commands.py,sha256=RKGx2rv56PM6eErvA2uoQ20hY8babuI5jav8nCUyUOk,3964
 claude_dev_cli/config.py,sha256=1pycr6LSEKc8yKA4CTavL7mH_JfZYszX9YvAE5Fx9gE,23719
@@ -14,7 +14,7 @@ claude_dev_cli/templates.py,sha256=lKxH943ySfUKgyHaWa4W3LVv91SgznKgajRtSRp_4UY,2
 claude_dev_cli/toon_utils.py,sha256=S3px2UvmNEaltmTa5K-h21n2c0CPvYjZc9mc7kHGqNQ,2828
 claude_dev_cli/usage.py,sha256=7F92mVUenSsONZxmug3ZLbd-8l1qcbqCAzzLbsrJF5Y,7700
 claude_dev_cli/warp_integration.py,sha256=PDufAJecl7uN0DGz6XW4uDSEeu7Ssg53DOIFKm-AXVg,6909
-claude_dev_cli/workflows.py,sha256=WpLq9I_0MmDsJIbCi9-f662JVyn8iKTs1KZ50w-GlZU,12202
+claude_dev_cli/workflows.py,sha256=tAo45rsY-GW6cKMAvb6r4IuTnQcepgbAyAbJzxw1QyU,14099
 claude_dev_cli/plugins/__init__.py,sha256=BdiZlylBzEgnwK2tuEdn8cITxhAZRVbTnDbWhdDhgqs,1340
 claude_dev_cli/plugins/base.py,sha256=H4HQet1I-a3WLCfE9F06Lp8NuFvVoIlou7sIgyJFK-c,1417
 claude_dev_cli/plugins/diff_editor/__init__.py,sha256=gqR5S2TyIVuq-sK107fegsutQ7Z-sgAIEbtc71FhXIM,101
@@ -26,9 +26,9 @@ claude_dev_cli/providers/base.py,sha256=KC2KQKGbR5_Oz_Xf5bjrGoEI-b3nfikRP5FXSy-4
 claude_dev_cli/providers/factory.py,sha256=w9LXY1U7HZcDoYcGcRpFTcjl0IpzvO_7QaIl7yo1p5M,3978
 claude_dev_cli/providers/ollama.py,sha256=DeetIbBmVifT2E5EIz7leZwsCWvP4kHwBkYfKCaCOjk,9642
 claude_dev_cli/providers/openai.py,sha256=UV8XAYTzhcAaX9KgV4Dkm5UAt1EsEUQ2RFsJkg0x3CY,9405
-claude_dev_cli-0.16.0.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
-claude_dev_cli-0.16.0.dist-info/METADATA,sha256=6ZC56-5QQCvCeZkAfPnQZ_7rDhMTCVf7TNWWfqhZymQ,33374
-claude_dev_cli-0.16.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-claude_dev_cli-0.16.0.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
-claude_dev_cli-0.16.0.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
-claude_dev_cli-0.16.0.dist-info/RECORD,,
+claude_dev_cli-0.16.2.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
+claude_dev_cli-0.16.2.dist-info/METADATA,sha256=cpT5DmhijqCsJ-rYsYi7KromYkkd-_ifQjgP8oN-fXQ,40616
+claude_dev_cli-0.16.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+claude_dev_cli-0.16.2.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
+claude_dev_cli-0.16.2.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
+claude_dev_cli-0.16.2.dist-info/RECORD,,