@iservu-inc/adf-cli 0.4.29 → 0.4.31

package/CHANGELOG.md

@@ -5,6 +5,58 @@ 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.4.31] - 2025-10-04
+
+### 🐛 Fix: OpenAI o-series Model Support (o3, o3-mini, o3-pro)
+
+**Fixed: o3 Models Failing with Parameter Error**
+- **Problem:** o3 models failed with `Unsupported parameter: 'max_tokens' is not supported with this model`
+- **Root Cause:** Only checking for `o1` models, not all o-series models (o1, o3, etc.)
+- **Solution:** Updated regex to detect ANY o-series model (`/^o\d/`)
+
+**Code Change (ai-client.js:118):**
+```javascript
+// ❌ BEFORE - Only o1 models
+const isO1Model = this.model.startsWith('o1');
+
+// ✅ AFTER - All o-series models (o1, o3, o5, etc.)
+const isOSeriesModel = /^o\d/.test(this.model);
+```
+
+**Impact:**
+- ✅ o1, o1-mini, o1-preview now work
+- ✅ o3, o3-mini, o3-pro now work
+- ✅ Future o-series models automatically supported
+- Uses `max_completion_tokens` parameter (as required by OpenAI API)
+- Removes `temperature` parameter (not supported by o-series)
+
+---
+
+## [0.4.30] - 2025-10-04
+
+### 🔒 Security: Auto .gitignore Protection
+
+**Added: Automatic .gitignore Management**
+- **Feature:** Automatically create/update `.gitignore` to protect `.adf/.env` file
+- **Purpose:** Prevent accidentally committing API keys to version control
+- **Implementation:**
+  - New `ensureGitignore()` function in `ai-config.js`
+  - Called automatically after saving API keys
+  - Creates `.gitignore` if it doesn't exist
+  - Adds `.adf/.env` entry with warning comment
+  - Skips if entry already exists (non-destructive)
+
+**Code Changes:**
+- `lib/ai/ai-config.js:106-136` - New `ensureGitignore()` function
+- `lib/ai/ai-config.js:158-160` - Auto-call after saving API keys
+
+**User Benefit:**
+- No more risk of committing API keys
+- Automatic protection without manual setup
+- Works with existing `.gitignore` files safely
+
+---
+
 ## [0.4.29] - 2025-10-04
 
 ### 🐛 CRITICAL FIX: OpenAI Model Fetching

package/lib/ai/ai-client.js

@@ -113,8 +113,9 @@ class AIClient {
    * OpenAI GPT request
    */
   async openaiRequest(prompt, maxTokens, temperature) {
-    // o1 models use max_completion_tokens instead of max_tokens
-    const isO1Model = this.model.startsWith('o1');
+    // o-series models (o1, o3, etc.) use max_completion_tokens instead of max_tokens
+    // Check for any model starting with 'o' followed by a digit
+    const isOSeriesModel = /^o\d/.test(this.model);
 
     const requestParams = {
       model: this.model,
@@ -126,10 +127,10 @@ class AIClient {
       ]
     };
 
-    // o1 models use different parameter names
-    if (isO1Model) {
+    // o-series models use different parameter names
+    if (isOSeriesModel) {
       requestParams.max_completion_tokens = maxTokens;
-      // o1 models don't support temperature parameter
+      // o-series models don't support temperature parameter
     } else {
       requestParams.max_tokens = maxTokens;
       requestParams.temperature = temperature;

package/lib/ai/ai-config.js

@@ -103,6 +103,38 @@ async function loadEnvFile(envPath) {
   return {};
 }
 
+/**
+ * Ensure .gitignore includes .adf/.env to protect API keys
+ */
+async function ensureGitignore(projectPath) {
+  const gitignorePath = path.join(projectPath, '.gitignore');
+  const entryToAdd = '.adf/.env';
+
+  let content = '';
+  let hasEntry = false;
+
+  // Read existing .gitignore if it exists
+  if (await fs.pathExists(gitignorePath)) {
+    content = await fs.readFile(gitignorePath, 'utf-8');
+    hasEntry = content.split('\n').some(line => line.trim() === entryToAdd);
+  }
+
+  // Add entry if not already present
+  if (!hasEntry) {
+    const lines = content ? content.split('\n') : [];
+
+    // Add a section header if .gitignore is empty or doesn't have the entry
+    if (lines.length === 0 || (lines[lines.length - 1] && lines[lines.length - 1].trim() !== '')) {
+      lines.push(''); // Add blank line if file is not empty
+    }
+
+    lines.push('# adf-cli - AI Provider API Keys (DO NOT COMMIT)');
+    lines.push(entryToAdd);
+
+    await fs.writeFile(gitignorePath, lines.join('\n'), 'utf-8');
+  }
+}
+
 /**
  * Save API key to .env file
  */
@@ -122,6 +154,10 @@ async function saveToEnvFile(envPath, key, value) {
 
   await fs.ensureDir(path.dirname(envPath));
   await fs.writeFile(envPath, lines.join('\n'), 'utf-8');
+
+  // Ensure .gitignore protects this file
+  const projectPath = path.dirname(path.dirname(envPath)); // Go up from .adf/.env to project root
+  await ensureGitignore(projectPath);
 }
 
 /**

package/package.json

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