@iservu-inc/adf-cli 0.12.9 → 0.12.10

package/.claude/settings.local.json

@@ -17,7 +17,8 @@
       "WebFetch(domain:openrouter.ai)",
       "WebFetch(domain:github.com)",
       "WebFetch(domain:antigravity.google)",
-      "WebSearch"
+      "WebSearch",
+      "Bash(node -c:*)"
     ],
     "deny": [],
     "ask": []

package/CHANGELOG.md

@@ -5,6 +5,115 @@ All notable changes to `@iservu-inc/adf-cli` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.9] - 2025-12-23
+
+### 🚀 Multi-Tool Expansion & AI Provider Robustness
+
+**MAJOR ENHANCEMENTS:** Expanded deployment support to 4 additional CLI tools and significantly improved AI provider reliability with comprehensive model verification and parameter compatibility fixes.
+
+#### What's New
+
+**New CLI Tool Support:**
+- **OpenCode CLI** - Complete generator with JSON configuration
+  - Output: `.opencode.json` with project config, agents, and MCP servers
+  - Model selection: Anthropic Claude models based on framework complexity
+  - MCP integration: Filesystem server for project access
+  - Auto-compacting and debug configuration
+
+- **Google Gemini CLI** - Markdown-based project context
+  - Output: `GEMINI.md` with structured project information
+  - Role-specific agent guidance
+  - Build/test/lint command reference
+  - Development guidelines and security standards
+
+- **DeepAgent (Abacus.ai)** - Agent markdown deployment
+  - Output: `.deepagent/agents/*.md` + `.deepagent/README.md`
+  - Similar to Claude Code but for DeepAgent CLI
+  - Project overview and workflow documentation
+  - Per-agent markdown files with role-specific instructions
+
+- **Zed Editor Support Verified** - Confirmed full 253-line generator integration
+  - MCP server configuration (project_context, archon)
+  - AGENTS.md symlink support (`.zed/rules -> ../AGENTS.md`)
+  - Agent-specific keymap configuration
+  - Model selection based on framework complexity
+
+**AI Provider Improvements:**
+
+**Model Verification System:**
+- ✅ **Test Before Save** - All models now tested with actual API request before configuration
+- ✅ **Clear Error Messages** - Detailed failure reasons when models don't work
+- ✅ **Retry Option** - Easy retry with different model on failure
+- ✅ **Operational Status** - Distinguishes between "listed" and "operational" models
+
+**Google Gemini Fixes:**
+- 🔧 Fixed API key validation (`genAI.listModels is not a function` error)
+- 🔧 Implemented dynamic model fetching via REST API (`/v1beta/models` endpoint)
+- 🔧 Updated validation model from deprecated `gemini-pro` to `gemini-1.5-flash`
+- 🔧 Filters models by `generateContent` support capability
+
+**Anthropic Model Expansion:**
+- 📊 Expanded from 3 to 11 models with comprehensive coverage
+- 📊 Added Claude 4.5 series (Sonnet, Opus)
+- 📊 Added Claude 3.5 series (Sonnet variants, Haiku)
+- 📊 Added Claude 3 series (Opus, Sonnet, Haiku)
+- 📊 Added Claude 2 series (2.1, 2.0, Instant)
+- 📊 Attempts dynamic fetch from API with fallback to curated list
+
+**OpenAI & OpenRouter Parameter Compatibility:**
+- 🔧 Fixed parameter compatibility for newer models (GPT-5, o-series)
+- 🔧 Updated regex pattern from `/^(o\d|gpt-5)/` to `/^(o1|o3|gpt-5)/i`
+- 🔧 Uses `max_completion_tokens` for reasoning models instead of `max_tokens`
+- 🔧 Automatic retry with fallback parameters on 400 errors
+- ✅ Confirmed working with `gpt-5.2-chat-latest` and other GPT-5 models
+
+**Enhanced Help System:**
+- 📚 Comprehensive `--help` documentation for all commands
+- 📚 Quick Start section with step-by-step workflow
+- 📚 Detailed command breakdowns (init, deploy, config, update)
+- 📚 Tool-by-tool deployment guide with output locations
+- 📚 Performance mode explanations (Fast/Balanced/Comprehensive)
+- 📚 AI provider setup instructions with API key links
+- 📚 Configuration categories with feature descriptions
+- 📚 Examples for common workflows
+
+#### Technical Details
+
+**New Files:**
+- `lib/generators/opencode-generator.js` - OpenCode CLI configuration generator (120+ lines)
+- `lib/generators/gemini-cli-generator.js` - Gemini CLI markdown generator (150+ lines)
+- `lib/generators/deepagent-generator.js` - DeepAgent configuration generator (145+ lines)
+
+**Modified Files:**
+- `lib/ai/ai-client.js` - Parameter compatibility fixes for newer models
+- `lib/ai/ai-config.js` - Model verification, Google Gemini fixes, Anthropic expansion
+- `bin/adf.js` - Comprehensive help system enhancements (300+ lines of documentation)
+- `lib/commands/deploy.js` - Added new tool registrations and deployment cases
+- `lib/generators/index.js` - Export new generators
+
+**Deployment Support Summary:**
+- **IDEs (6):** Windsurf, Cursor, VS Code, Zed, Antigravity, VS Code Insider
+- **CLI Tools (5):** Claude Code, OpenCode, Gemini CLI, DeepAgent, Generic
+- **Total Tools:** 11 deployment targets
+
+#### Bug Fixes
+- Fixed: OpenRouter models listed but not operational (added verification)
+- Fixed: OpenAI GPT-5 models parameter incompatibility (`max_tokens` vs `max_completion_tokens`)
+- Fixed: Google Gemini API validation failure (`listModels` method error)
+- Fixed: Anthropic incomplete model listing (3 models → 11 models)
+- Fixed: Model testing skipped during configuration process
+
+#### Keywords Added
+- `opencode` - OpenCode CLI support
+- `gemini-cli` - Google Gemini CLI support
+- `deepagent` - Abacus.ai DeepAgent support
+
+#### Backward Compatibility
+- ✅ **100% Backward Compatible** - All changes are additive
+- ✅ All existing deployments continue to work
+- ✅ No breaking changes to API or CLI commands
+- ✅ Existing configurations automatically benefit from improved verification
+
 ## [0.12.0] - 2025-12-22
 
 ### 🎯 Agent-Native Development Framework (ANDF) Standard Implementation

package/README.md

@@ -98,15 +98,21 @@ adf deploy --list
 ```
 
 **Supported Tools:**
-- windsurf
-- cursor
-- vscode
-- vscode-insider
-- kiro
-- trae
-- claude-code
-- gemini-cli
-- codex-cli
+
+**IDEs:**
+- windsurf - Codeium Windsurf IDE
+- cursor - Cursor AI IDE
+- vscode - Visual Studio Code
+- vscode-insider - VS Code Insider
+- zed - Zed Editor
+- antigravity - Google Antigravity
+
+**CLI Tools:**
+- claude-code - Anthropic Claude Code CLI
+- opencode - OpenCode CLI
+- gemini-cli - Google Gemini CLI
+- deepagent - Abacus.ai DeepAgent
+- generic - Generic AI tools
 
 ### Update CLI
 
@@ -495,16 +501,29 @@ When we release updates to the framework:
 
 See [CHANGELOG.md](./CHANGELOG.md) for detailed version history.
 
-**Latest:** v0.10.0 (2025-10-27)
-- **Pattern Decay Algorithm (v0.10.0)** - Phase 6: Advanced Learning Features
+**Latest:** v0.12.9 (2025-12-23)
+- **Multi-Tool Expansion & AI Provider Robustness (v0.12.9)**
+  - Added 4 new CLI tools: OpenCode, Gemini CLI, DeepAgent, verified Zed support
+  - Comprehensive AI provider improvements with model verification
+  - Fixed Google Gemini API integration and expanded Anthropic models (3 → 11)
+  - Enhanced help system with detailed documentation
+  - OpenAI/OpenRouter parameter compatibility for GPT-5 and o-series models
+  - All models now tested before configuration save
+
+**Previous Releases:**
+- **v0.12.0 (2025-12-22)** - ANDF Standard Implementation
+  - Complete AGENTS.md standard compliance with YAML frontmatter
+  - .context/ directory support with architecture and glossary generation
+  - Zed Editor and Google Antigravity full generator support
+  - MCP integration and agent configuration
+
+- **v0.10.0 (2025-10-27)** - Pattern Decay Algorithm
   - Time-based exponential decay for inactive patterns
   - Confidence-based decay rates (high/medium/low)
   - Automatic pattern cleanup and renewal system
   - 40+ comprehensive tests for decay functionality
-  - Pattern metadata tracking (timestamps, renewal counts)
-  - Removal history and analytics
 
-**Previous Release:** v0.9.1 (2025-10-05)
+- **v0.9.1 (2025-10-05)** - AI Analysis Settings
 - **AI Analysis Settings (v0.9.0)** - Performance modes and configurable AI features
   - Three performance modes: Fast, Balanced, Comprehensive
   - Five individually configurable AI features

package/lib/ai/ai-config.js

@@ -600,13 +600,19 @@ async function configureAIProvider(projectPath = process.cwd()) {
   // Fetch available models (only after successful validation)
   const availableModels = await fetchAvailableModels(selectedProvider, apiKey);
 
-  // Show helpful tip about model selection
+  // Show helpful tips about model selection
   if (selectedProvider.id === 'openrouter' && availableModels.length > 50) {
     console.log(chalk.gray('\n💡 Tip: Recommended models for best compatibility:'));
     console.log(chalk.gray('   • anthropic/claude-sonnet-4-5'));
     console.log(chalk.gray('   • openai/gpt-4-turbo'));
     console.log(chalk.gray('   • google/gemini-pro-1.5'));
     console.log(chalk.yellow('   ⚠️  Free models may require specific privacy settings\n'));
+  } else if (selectedProvider.id === 'google') {
+    console.log(chalk.gray('\n💡 Tip: Recommended models for free tier:'));
+    console.log(chalk.gray('   • gemini-1.5-flash (fastest, lowest quota usage)'));
+    console.log(chalk.gray('   • gemini-1.5-flash-8b (ultra-fast, minimal quota)'));
+    console.log(chalk.gray('   • gemini-2.0-flash-exp (newer, experimental)'));
+    console.log(chalk.yellow('   ⚠️  Pro models (gemini-pro, gemini-2.5-pro) may exceed free tier quota\n'));
   }
 
   // Model selection with autocomplete
@@ -651,19 +657,41 @@ async function configureAIProvider(projectPath = process.cwd()) {
     modelTestSpinner.succeed(chalk.green(`Model ${model} verified successfully`));
   } catch (error) {
     modelTestSpinner.fail(chalk.red(`Model ${model} test failed`));
-    console.log(chalk.red(`\nError: ${error.message}\n`));
-    console.log(chalk.yellow('⚠️  This model appears to be listed but not operational.'));
-    console.log(chalk.gray('Possible reasons:'));
-    console.log(chalk.gray('  • Model requires higher API tier or special access'));
-    console.log(chalk.gray('  • Model is experimental or in preview'));
-    console.log(chalk.gray('  • Model has specific parameter requirements'));
-    console.log(chalk.gray('  • Provider-side issue or rate limiting\n'));
+
+    // Check if this is a rate limit error
+    const isRateLimit = error.message.includes('429') ||
+                       error.message.includes('Too Many Requests') ||
+                       error.message.includes('quota') ||
+                       error.message.includes('rate limit');
+
+    if (isRateLimit) {
+      console.log(chalk.yellow('\n⚠️  Rate Limit / Quota Exceeded'));
+      console.log(chalk.gray('\nThis model is operational but you\'ve exceeded your API quota.'));
+      console.log(chalk.gray('Common causes:'));
+      console.log(chalk.gray('  • Free tier daily/hourly limits reached'));
+      console.log(chalk.gray('  • Too many recent requests'));
+      console.log(chalk.gray('  • Model requires paid API tier\n'));
+
+      console.log(chalk.cyan('Solutions:'));
+      console.log(chalk.gray('  1. Select a different model with available quota'));
+      console.log(chalk.gray('  2. Wait for quota reset (usually hourly or daily)'));
+      console.log(chalk.gray('  3. Upgrade to paid tier at: https://ai.google.dev/pricing'));
+      console.log(chalk.gray('  4. Use a different AI provider (OpenAI, Anthropic, etc.)\n'));
+    } else {
+      console.log(chalk.red(`\nError: ${error.message}\n`));
+      console.log(chalk.yellow('⚠️  This model appears to be listed but not operational.'));
+      console.log(chalk.gray('Possible reasons:'));
+      console.log(chalk.gray('  • Model requires higher API tier or special access'));
+      console.log(chalk.gray('  • Model is experimental or in preview'));
+      console.log(chalk.gray('  • Model has specific parameter requirements'));
+      console.log(chalk.gray('  • Provider-side issue\n'));
+    }
 
     const { retry } = await inquirer.prompt([
       {
         type: 'confirm',
         name: 'retry',
-        message: 'Try selecting a different model?',
+        message: isRateLimit ? 'Try selecting a different model?' : 'Try selecting a different model?',
         default: true
       }
     ]);

package/lib/commands/deploy.js

@@ -241,8 +241,9 @@ async function deployToTool(tool, options = {}) {
     }
 
     // Copy tool-specific config (simplified)
+    // Skip for directory-based tools (claude-code, deepagent, generic) - they use dedicated generators
     const toolConfig = TOOLS[tool];
-    if (toolConfig) {
+    if (toolConfig && !toolConfig.configFile.endsWith('/')) {
       const configPath = path.join(cwd, toolConfig.configFile);
       const configDir = path.dirname(configPath);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iservu-inc/adf-cli",
-  "version": "0.12.9",
+  "version": "0.12.10",
   "description": "CLI tool for AgentDevFramework - AI-assisted development framework with multi-provider AI support",
   "main": "index.js",
   "bin": {