@iservu-inc/adf-cli 0.12.10 → 0.12.11

package/CHANGELOG.md

@@ -5,6 +5,46 @@ 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

package/README.md

@@ -501,16 +501,20 @@ When we release updates to the framework:
 
 See [CHANGELOG.md](./CHANGELOG.md) for detailed version history.
 
-**Latest:** v0.12.9 (2025-12-23)
-- **Multi-Tool Expansion & AI Provider Robustness (v0.12.9)**
+**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
-  - 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

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.10",
+  "version": "0.12.11",
   "description": "CLI tool for AgentDevFramework - AI-assisted development framework with multi-provider AI support",
   "main": "index.js",
   "bin": {