@vfarcic/dot-ai 0.16.0 → 0.18.0

package/dist/tools/answer-question.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-question.d.ts","sourceRoot":"","sources":["../../src/tools/answer-question.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMhD,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,+BAA+B,8HAA4H,CAAC;AAGzK,eAAO,MAAM,gCAAgC;;;;CAI5C,CAAC;AA+eF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EAC7G,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAmTxD"}
+{"version":3,"file":"answer-question.d.ts","sourceRoot":"","sources":["../../src/tools/answer-question.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMhD,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,+BAA+B,8HAA4H,CAAC;AAGzK,eAAO,MAAM,gCAAgC;;;;CAI5C,CAAC;AAkiBF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EAC7G,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAqVxD"}

package/dist/tools/answer-question.js

@@ -154,23 +154,45 @@ function validateAnswer(answer, question) {
     return null;
 }
 /**
- * Get anti-cascade agent instructions for stage responses
+ * Get stage-specific instructions for different stages
  */
-function getAgentInstructions(stage) {
-    const antiCascadeRule = 'CRITICAL ANTI-CASCADE RULE: When user says "skip" for ANY stage, only skip THAT specific stage and present the NEXT stage questions to the user. NEVER automatically skip multiple stages in sequence.';
+function getStageSpecificInstructions(stage) {
     switch (stage) {
         case 'required':
-            return `${antiCascadeRule} Present these required questions to the user. All must be answered before proceeding.`;
+            return 'STAGE: REQUIRED - All questions must be answered before proceeding. No skipping allowed.';
         case 'basic':
-            return `${antiCascadeRule} Present these questions to the user and wait for their response. Do NOT skip this stage unless the user explicitly says to skip THIS specific stage.`;
+            return 'STAGE: BASIC - These questions can be skipped. User can provide answers or say "skip" to proceed to advanced stage.';
         case 'advanced':
-            return `${antiCascadeRule} Present these questions to the user and wait for their response. Do NOT skip this stage unless the user explicitly says to skip THIS specific stage.`;
+            return 'STAGE: ADVANCED - These questions can be skipped. User can provide answers or say "skip" to proceed to open stage.';
         case 'open':
-            return `${antiCascadeRule} This is the final configuration stage. Present these questions to the user and wait for their response. Use "N/A" only if user explicitly states no additional requirements.`;
+            return 'STAGE: OPEN - Final configuration stage. User can provide additional requirements or say "N/A" to proceed to manifest generation.';
         default:
-            return `${antiCascadeRule} Present questions to the user and wait for their response.`;
+            return 'STAGE: UNKNOWN - Present questions to the user and wait for their response.';
     }
 }
+/**
+ * Get enhanced anti-cascade agent instructions for stage responses
+ */
+function getAgentInstructions(stage) {
+    const antiCascadeRule = 'CRITICAL ANTI-CASCADE RULE: When user says "skip" for ANY stage, only skip THAT specific stage and present the NEXT stage questions to the user. NEVER automatically skip multiple stages in sequence.';
+    const mandatoryWorkflow = `
+MANDATORY CLIENT AGENT WORKFLOW:
+1. Present these questions to the user in natural language
+2. Wait for explicit user response
+3. If user provides answers: call answerQuestion with their specific answers
+4. If user says "skip": call answerQuestion with empty answers object ({})
+5. NEVER call answerQuestion without receiving user input first
+6. NEVER assume what the user wants for subsequent stages`;
+    const strictConstraints = `
+STRICT BEHAVIORAL CONSTRAINTS:
+- DO NOT call answerQuestion automatically
+- DO NOT assume user wants to proceed to manifest generation
+- DO NOT call answerQuestion with empty open stage answers unless user explicitly provides them
+- DO NOT interpret "skip" as "automatically proceed to next stage"
+- MUST present each stage's questions individually and wait for user response`;
+    const stageSpecific = getStageSpecificInstructions(stage);
+    return `${antiCascadeRule}\n${mandatoryWorkflow}\n${strictConstraints}\n\n${stageSpecific}`;
+}
 /**
  * Determine current stage based on solution state
  */
@@ -354,8 +376,26 @@ async function analyzeResourceNeeds(currentSolution, openResponse, context) {
         openResponse,
         availableResourceCount: availableResourceTypes.length
     });
-    const response = await claudeIntegration.sendMessage(analysisPrompt);
-    return parseEnhancementResponse(response.content);
+    try {
+        const response = await claudeIntegration.sendMessage(analysisPrompt);
+        const analysisResult = parseEnhancementResponse(response.content);
+        // Check for capability gap and throw specific error
+        if (analysisResult.approach === 'capability_gap') {
+            context.logger.error('Capability gap detected in resource analysis', new Error(`Capability gap for solution ${currentSolution.solutionId}: ${analysisResult.requestedCapability} - ${analysisResult.integrationIssue}`));
+            const capabilityGapError = new Error(`Enhancement capability gap: ${analysisResult.reasoning}. ${analysisResult.integrationIssue}. Suggested action: ${analysisResult.suggestedAction}`);
+            capabilityGapError.name = 'CapabilityGapError';
+            throw capabilityGapError;
+        }
+        return analysisResult;
+    }
+    catch (error) {
+        // If it's already a capability gap error, re-throw it
+        if (error instanceof Error && error.name === 'CapabilityGapError') {
+            throw error;
+        }
+        context.logger.error('Resource analysis failed', error);
+        throw error;
+    }
 }
 /**
  * Phase 2: Apply enhancements based on analysis result
@@ -644,12 +684,43 @@ async function handleAnswerQuestionTool(args, dotAI, logger, requestId) {
                 catch (error) {
                     const errorMessage = error instanceof Error ? error.message : String(error);
                     // Check if this is a capability gap error (should fail the entire operation)
-                    if (errorMessage.includes('Enhancement capability gap') || errorMessage.includes('capability_gap')) {
+                    if (errorMessage.includes('Enhancement capability gap') || errorMessage.includes('capability_gap') || (error instanceof Error && error.name === 'CapabilityGapError')) {
                         logger.error('Capability gap detected, failing operation', error);
-                        throw error; // Re-throw capability gap errors to fail the entire operation
+                        // Return structured error response instead of throwing
+                        const errorResponse = {
+                            status: 'enhancement_error',
+                            solutionId: args.solutionId,
+                            error: 'capability_gap',
+                            message: 'The selected solution cannot support the requested enhancement.',
+                            details: errorMessage,
+                            guidance: 'Please start over and select a different solution that supports your requirements.',
+                            suggestedAction: 'restart_with_different_solution',
+                            availableAlternatives: [
+                                {
+                                    solutionId: 'sol_2025-07-12T172050_a685cdeb1427',
+                                    description: 'Standard Kubernetes Pattern (Deployment + Service + Ingress) with full configuration flexibility'
+                                }
+                            ],
+                            agentInstructions: 'CAPABILITY GAP DETECTED: The selected solution cannot fulfill the user\'s requirements. Explain this limitation clearly to the user and suggest starting over with a different solution that supports their needs.',
+                            timestamp: new Date().toISOString()
+                        };
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(errorResponse, null, 2)
+                                }
+                            ]
+                        };
                     }
                     // For other errors (AI service issues, parsing errors), continue with original solution
                     logger.error('AI enhancement failed due to service issue, continuing with original solution', error);
+                    // Log the enhancement failure but continue with original solution
+                    logger.warn('Proceeding with original solution after AI enhancement failure', {
+                        solutionId: args.solutionId,
+                        error: errorMessage,
+                        fallbackApproach: 'using_original_solution'
+                    });
                 }
             }
             // Extract all user answers for handoff

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Universal Kubernetes application deployment agent with CLI and MCP interfaces",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",