@iservu-inc/adf-cli 0.12.9 → 0.12.11

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,155 @@ 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.10] - 2025-12-23
+
+### 🐛 Critical Bug Fixes
+
+**Patch Release:** Two critical bug fixes for deployment and AI provider error handling.
+
+#### Fixed
+
+**Deployment Error Fix:**
+- 🔧 **Fixed EISDIR error** when deploying to directory-based tools (claude-code, deepagent, generic)
+- Error: `EISDIR: illegal operation on a directory, open '.framework/agents'`
+- Root cause: Attempting to write file to directory path
+- Solution: Skip generic config writing for tools with directory-based configs (ending with `/`)
+- These tools use dedicated generators that handle file creation properly
+
+**AI Provider Error Handling:**
+- 🔧 **Improved rate limit error detection** for Google Gemini models
+- Now distinguishes between rate limit/quota errors vs model availability issues
+- Clear messaging for quota exceeded scenarios with actionable solutions:
+  - Try different model with available quota
+  - Wait for quota reset
+  - Upgrade to paid tier
+  - Use different AI provider
+- Added **Google Gemini free tier model recommendations**:
+  - `gemini-1.5-flash` (fastest, lowest quota usage) - Recommended
+  - `gemini-1.5-flash-8b` (ultra-fast, minimal quota)
+  - `gemini-2.0-flash-exp` (newer, experimental)
+- Warns about Pro models (gemini-pro, gemini-2.5-pro) potentially exceeding free tier quota
+
+#### Technical Details
+
+**Modified Files:**
+- `lib/commands/deploy.js` - Skip config writing for directory-based tools
+- `lib/ai/ai-config.js` - Enhanced error detection and messaging for rate limits
+
+#### Impact
+- ✅ Deployment now succeeds for all 11 supported tools
+- ✅ Users get clear guidance when hitting API rate limits
+- ✅ Reduces confusion about model availability vs quota issues
+
+## [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,33 @@ 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.10 (2025-12-23)
+- **Critical Bug Fixes (v0.12.10)** - Patch release
+  - Fixed EISDIR deployment error for directory-based tools
+  - Improved rate limit error detection for Gemini models
+  - Added free tier model recommendations for Google Gemini
+  - Clear messaging for quota vs availability issues
+
+**Previous Releases:**
+- **v0.12.9 (2025-12-23)** - Multi-Tool Expansion & AI Provider Robustness
+  - 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
+- **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/lib/generators/tool-config-generator.js

@@ -177,6 +177,116 @@ class ToolConfigGenerator {
     await fs.ensureDir(path.join(this.projectPath, dirPath));
   }
 
+  /**
+   * Get project context (name, commands, directories)
+   */
+  async getProjectContext() {
+    const context = {
+      name: this.getProjectName(),
+      overview: '',
+      buildCommand: 'npm run build',
+      testCommand: 'npm test',
+      lintCommand: 'npm run lint',
+      sourceDir: 'src/',
+      testDir: 'tests/',
+      docsDir: 'docs/'
+    };
+
+    // Try to extract overview from outputs
+    if (this.outputs.constitution) {
+      const overview = this.extractSection(this.outputs.constitution, 'overview');
+      if (overview) context.overview = overview;
+    } else if (this.outputs.prd) {
+      const overview = this.extractSection(this.outputs.prd, 'overview');
+      if (overview) context.overview = overview;
+    } else if (this.outputs.prp) {
+      const overview = this.extractSection(this.outputs.prp, 'overview');
+      if (overview) context.overview = overview;
+    }
+
+    // Try to read package.json for accurate commands
+    try {
+      const packageJsonPath = path.join(this.projectPath, 'package.json');
+      if (await fs.pathExists(packageJsonPath)) {
+        const packageJson = await fs.readJson(packageJsonPath);
+        if (packageJson.scripts) {
+          if (packageJson.scripts.build) context.buildCommand = 'npm run build';
+          if (packageJson.scripts.test) context.testCommand = 'npm test';
+          if (packageJson.scripts.lint) context.lintCommand = 'npm run lint';
+        }
+      }
+    } catch (error) {
+      // Ignore, use defaults
+    }
+
+    return context;
+  }
+
+  /**
+   * Get framework-specific context
+   */
+  async getFrameworkContext() {
+    const context = {
+      type: this.framework,
+      keyPoints: ''
+    };
+
+    // Extract key points from outputs
+    if (this.outputs.constitution) {
+      context.keyPoints = this.extractSection(this.outputs.constitution, 'key principles');
+    } else if (this.outputs.prd) {
+      context.keyPoints = this.extractSection(this.outputs.prd, 'key requirements');
+    }
+
+    return context;
+  }
+
+  /**
+   * Get summary of generated outputs
+   */
+  async getOutputSummary() {
+    const files = Object.keys(this.outputs);
+    if (files.length === 0) return null;
+
+    return `Generated outputs: ${files.map(f => `${f}.md`).join(', ')}`;
+  }
+
+  /**
+   * Deploy agent files to target directory
+   */
+  async deployAgentFiles(targetDir) {
+    const agentsList = this.getAgentsList();
+    const deployedFiles = [];
+
+    for (const agent of agentsList) {
+      const srcAgent = path.join(__dirname, '../templates/shared/agents', `${agent}.md`);
+      const destAgent = path.join(targetDir, `${agent}.md`);
+
+      if (await fs.pathExists(srcAgent)) {
+        await fs.copy(srcAgent, destAgent);
+        deployedFiles.push(destAgent);
+      }
+    }
+
+    return deployedFiles;
+  }
+
+  /**
+   * Get list of agents based on framework
+   */
+  getAgentsList() {
+    switch (this.framework) {
+      case 'rapid':
+        return ['dev', 'qa'];
+      case 'balanced':
+        return ['analyst', 'pm', 'dev', 'qa'];
+      case 'comprehensive':
+        return ['analyst', 'pm', 'architect', 'sm', 'dev', 'qa'];
+      default:
+        return ['dev', 'qa'];
+    }
+  }
+
   /**
    * Generate all configurations (override in subclasses)
    */

package/package.json

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