@iservu-inc/adf-cli 0.14.0 → 0.14.2

package/CHANGELOG.md

@@ -5,6 +5,27 @@ 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.14.2] - 2026-01-12
+
+### 🐛 Fix - Google Gemini API Validation
+
+**Patch Release:** Fixed a bug where valid Google API keys were sometimes reported as invalid.
+
+#### Fixed
+- 🔧 **Improved Validation** - Switched Google API key validation to use the official SDK's `countTokens` method instead of a manual REST API call.
+- 🔧 **URL Encoding** - Added `encodeURIComponent` to the API key in model fetching requests to handle special characters.
+- 🔧 **Better Error Messaging** - Clearer error descriptions when a Google key fails validation.
+
+## [0.14.1] - 2026-01-12
+
+### 🚀 Integration - Project Context Synthesis in core CLI
+
+**Patch Release:** Integrated the Synthesis Engine and Adaptive Augmentation flow directly into the `adf init` command.
+
+#### Fixed/Integrated
+- 🔧 **Core CLI Integration** - The `adf init` command now automatically detects existing BMAD, OpenSpec, and Spec-Kit frameworks and offers a "Synthesize & Augment" path.
+- 🔧 **Dependency Fix** - Ensured all new analysis utilities are correctly required in the command entry point.
+
 ## [0.14.0] - 2026-01-12
 
 ### 🚀 Major Feature - Project Context Synthesis & Adaptive Augmentation

package/README.md

@@ -501,8 +501,18 @@ When we release updates to the framework:
 
 See [CHANGELOG.md](./CHANGELOG.md) for detailed version history.
 
-**Latest:** v0.12.10 (2025-12-23)
-- **Critical Bug Fixes (v0.12.10)** - Patch release
+**Latest:** v0.14.0 (2026-01-12)
+- **Project Context Synthesis & Extended Tool Support (v0.14.0)** - Minor release
+  - ✨ **Adaptive Project Augmentation** - Synthesizes existing .adf, BMAD, OpenSpec, and Spec-Kit project files into unified context.
+  - ✨ **AI-Driven Gap Analysis** - Automatically identifies knowledge gaps and generates targeted questionnaire to fill them.
+  - ✨ **Extended Tool Support** - Native generators for Kiro, Trae, and Codex CLI.
+  - ✨ **Tool Audit Registry** - New `adf tools audit` command to monitor integration features across all 12+ supported tools.
+
+**Previous Releases:**
+- **v0.13.0 (2026-01-03)** - OpenCode Multi-Agent Integration
+  - Complete OpenCode generator rewrite with multi-provider, multi-agent support.
+  - Optimal model assignment and MCP server integration.
+- **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

package/lib/ai/ai-config.js

@@ -215,20 +215,19 @@ async function validateAPIKeyWithProvider(provider, apiKey) {
       break;
 
     case 'google':
-      const fetchGoogle = require('node-fetch');
-      // Validate by fetching models list (validates key and shows available models)
-      const googleResponse = await fetchGoogle(
-        `https://generativelanguage.googleapis.com/v1beta/models?key=${apiKey}`
-      );
-
-      if (!googleResponse.ok) {
-        const errorText = await googleResponse.text();
-        throw new Error(`HTTP ${googleResponse.status}: ${errorText || googleResponse.statusText}`);
-      }
-
-      const googleData = await googleResponse.json();
-      if (!googleData.models || !Array.isArray(googleData.models) || googleData.models.length === 0) {
-        throw new Error('No models available for this API key');
+      try {
+        const { GoogleGenerativeAI } = require('@google/generative-ai');
+        const genAI = new GoogleGenerativeAI(apiKey);
+        // Use gemini-1.5-flash as it's the most available model for validation
+        const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' });
+        // countTokens is a metadata call that validates the API key without incurring costs
+        await model.countTokens("connectivity test");
+      } catch (error) {
+        // If SDK fails, provide a clearer error message
+        if (error.message.includes('API_KEY_INVALID') || error.message.includes('API key not found')) {
+          throw new Error('Invalid Google API key. Please check your key at https://aistudio.google.com/app/apikey');
+        }
+        throw error;
       }
       break;
 
@@ -332,7 +331,7 @@ async function fetchAvailableModels(provider, apiKey) {
 
           // Use Google's REST API to list available models
           const response = await fetch(
-            `https://generativelanguage.googleapis.com/v1beta/models?key=${apiKey}`
+            `https://generativelanguage.googleapis.com/v1beta/models?key=${encodeURIComponent(apiKey)}`
           );
 
           if (!response.ok) {

package/lib/commands/init.js

@@ -7,6 +7,12 @@ const {
   detectProjectType,
   getWorkflowRecommendation
 } = require('../utils/project-detector');
+const FrameworkDetector = require('../utils/framework-detector');
+const ContextExtractor = require('../utils/context-extractor');
+const SynthesisEngine = require('../analysis/synthesis-engine');
+const HeuristicGapAnalyzer = require('../analysis/heuristic-gap-analyzer');
+const AIGapAnalyzer = require('../analysis/ai-gap-analyzer');
+const DynamicQuestionGenerator = require('../analysis/dynamic-question-generator');
 const Interviewer = require('../frameworks/interviewer');
 const SessionManager = require('../frameworks/session-manager');
 const { deployToTool } = require('./deploy');
@@ -24,6 +30,94 @@ async function init(options) {
     loadEnvIntoProcess(envPath);
   }
 
+  // Detect existing frameworks for potential synthesis
+  const detectedFrameworks = await FrameworkDetector.detect(cwd);
+  const hasOtherFrameworks = detectedFrameworks.filter(f => f !== 'adf').length > 0;
+
+  if (hasOtherFrameworks) {
+    console.log(chalk.cyan('📦 Existing Development Frameworks Detected:'));
+    console.log(chalk.gray(`   ${detectedFrameworks.join(', ')}\n`));
+
+    const { action } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'action',
+        message: 'How would you like to proceed?',
+        choices: [
+          {
+            name: 'Synthesize & Augment (Seamless Merge - Recommended)',
+            value: 'synthesize'
+          },
+          {
+            name: 'Start Fresh (Ignore existing frameworks)',
+            value: 'fresh'
+          },
+          new inquirer.Separator(),
+          {
+            name: chalk.gray('← Exit'),
+            value: 'exit'
+          }
+        ]
+      }
+    ]);
+
+    if (action === 'exit') return;
+
+    if (action === 'synthesize') {
+      const spinner = ora('Synthesizing project context...').start();
+      try {
+        const context = await ContextExtractor.extract(cwd, detectedFrameworks);
+        const sessionPath = await SynthesisEngine.createAugmentedSession(cwd, context, 'balanced');
+        spinner.succeed(chalk.green(`✓ Project synthesized into new session: ${path.basename(sessionPath)}`));
+        
+        console.log(chalk.yellow('\n💡 Starting Adaptive Augmentation Interview to fill knowledge gaps...\n'));
+        
+        // Load AI config for the interviewer
+        const aiConfig = await configureAIProvider(cwd);
+        const sessionProgress = await fs.readJson(path.join(sessionPath, '_progress.json'));
+
+        // Perform Knowledge Gap Analysis
+        console.log(chalk.cyan('🔍 Analyzing for knowledge gaps...'));
+        const hGaps = HeuristicGapAnalyzer.analyze(context, 'balanced');
+        
+        let aiGaps = [];
+        if (aiConfig) {
+          const AIClient = require('../ai/ai-client');
+          const aiClient = new AIClient(aiConfig);
+          const aiAnalyzer = new AIGapAnalyzer(aiClient);
+          aiGaps = await aiAnalyzer.analyze(context);
+        }
+
+        const dynamicQuestions = DynamicQuestionGenerator.generate(hGaps, aiGaps);
+
+        if (dynamicQuestions.length === 0) {
+          console.log(chalk.green('✓ Context is comprehensive. No additional questions needed.'));
+          const interviewer = new Interviewer('balanced', cwd, {
+            sessionId: path.basename(sessionPath),
+            sessionPath,
+            progress: sessionProgress
+          }, aiConfig);
+          await interviewer.generateOutputs();
+          return;
+        }
+
+        console.log(chalk.yellow(`\n💡 Identified ${dynamicQuestions.length} gaps. Starting targeted interview...\n`));
+        
+        const interviewer = new Interviewer('balanced', cwd, {
+          sessionId: path.basename(sessionPath),
+          sessionPath,
+          progress: sessionProgress
+        }, aiConfig, dynamicQuestions);
+        
+        await interviewer.start();
+        return;
+      } catch (error) {
+        spinner.fail(chalk.red(`Synthesis failed: ${error.message}`));
+        console.log(chalk.yellow('Falling back to standard initialization...\n'));
+      }
+    }
+  }
+
   // Check for resumable sessions FIRST (before asking to overwrite)
   const sessionManager = new SessionManager(cwd);
   const existingSession = await sessionManager.promptToResume();

package/lib/frameworks/interviewer.js

@@ -21,10 +21,11 @@ const DynamicPipeline = require('../analysis/dynamic-pipeline');
  */
 
 class Interviewer {
-  constructor(framework, projectPath, existingSession = null, aiConfig = null) {
+  constructor(framework, projectPath, existingSession = null, aiConfig = null, customQuestions = null) {
     this.framework = framework;
     this.projectPath = projectPath;
     this.aiConfig = aiConfig;  // Store AI configuration
+    this.customQuestions = customQuestions; // Dynamic questions for augmentation
 
     if (existingSession) {
       // Resuming existing session
@@ -293,8 +294,8 @@ class Interviewer {
       projectContext = { type: 'unknown', frameworks: [], languages: [], confidence: 0 };
     }
 
-    // Get questions for framework
-    let questions = getQuestionsForFramework(this.framework);
+    // Get questions for framework (or use custom ones if provided)
+    let questions = this.customQuestions || getQuestionsForFramework(this.framework);
 
     // Apply smart filtering if enabled
     let filteringResult = null;

package/package.json

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