@vfarcic/dot-ai 0.12.0 → 0.14.0

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

@@ -5,7 +5,7 @@ import { z } from 'zod';
 import { DotAI } from '../core/index';
 import { Logger } from '../core/error-handling';
 export declare const ANSWERQUESTION_TOOL_NAME = "answerQuestion";
-export declare const ANSWERQUESTION_TOOL_DESCRIPTION = "Process user answers and return remaining questions or completion status";
+export declare const ANSWERQUESTION_TOOL_DESCRIPTION = "Process user answers and return remaining questions or completion status. For open stage, use \"open\" as the answer key.";
 export declare const ANSWERQUESTION_TOOL_INPUT_SCHEMA: {
     solutionId: z.ZodString;
     stage: z.ZodEnum<["required", "basic", "advanced", "open"]>;

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,6EAA6E,CAAC;AAG1H,eAAO,MAAM,gCAAgC;;;;CAI5C,CAAC;AAodF;;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;AA6eF;;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"}

package/dist/tools/answer-question.js

@@ -46,12 +46,12 @@ const path = __importStar(require("path"));
 const session_utils_1 = require("../core/session-utils");
 // Tool metadata for direct MCP registration
 exports.ANSWERQUESTION_TOOL_NAME = 'answerQuestion';
-exports.ANSWERQUESTION_TOOL_DESCRIPTION = 'Process user answers and return remaining questions or completion status';
+exports.ANSWERQUESTION_TOOL_DESCRIPTION = 'Process user answers and return remaining questions or completion status. For open stage, use "open" as the answer key.';
 // Zod schema for MCP registration
 exports.ANSWERQUESTION_TOOL_INPUT_SCHEMA = {
     solutionId: zod_1.z.string().regex(/^sol_[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{6}_[a-f0-9]+$/).describe('The solution ID to update (e.g., sol_2025-07-01T154349_1e1e242592ff)'),
     stage: zod_1.z.enum(['required', 'basic', 'advanced', 'open']).describe('The configuration stage being addressed'),
-    answers: zod_1.z.record(zod_1.z.any()).describe('User answers to configuration questions for the specified stage')
+    answers: zod_1.z.record(zod_1.z.any()).describe('User answers to configuration questions for the specified stage. For required/basic/advanced stages, use questionId as key. For open stage, use "open" as key (e.g., {"open": "add persistent storage"})')
 };
 /**
  * Load solution file by ID
@@ -227,21 +227,50 @@ function getCurrentStage(solution) {
 /**
  * Validate stage transition is allowed
  */
-function validateStageTransition(currentStage, requestedStage) {
-    const validTransitions = {
-        'required': ['basic', 'open'],
-        'basic': ['advanced', 'open'],
-        'advanced': ['open'],
-        'open': []
-    };
+function validateStageTransition(currentStage, requestedStage, solution) {
+    // Allow processing the same stage (for answering or skipping)
     if (currentStage === requestedStage) {
-        return { valid: true }; // Same stage is always valid
+        return { valid: true };
+    }
+    // Determine the next stage based on what questions exist
+    let expectedNext = null;
+    if (currentStage === 'required') {
+        if (solution.questions.basic && solution.questions.basic.length > 0) {
+            expectedNext = 'basic';
+        }
+        else if (solution.questions.advanced && solution.questions.advanced.length > 0) {
+            expectedNext = 'advanced';
+        }
+        else {
+            expectedNext = 'open';
+        }
+    }
+    else if (currentStage === 'basic') {
+        if (solution.questions.advanced && solution.questions.advanced.length > 0) {
+            expectedNext = 'advanced';
+        }
+        else {
+            expectedNext = 'open';
+        }
+    }
+    else if (currentStage === 'advanced') {
+        expectedNext = 'open';
+    }
+    else {
+        expectedNext = null; // open stage is final
+    }
+    // If we're at the final stage, no transitions allowed
+    if (expectedNext === null) {
+        return {
+            valid: false,
+            error: `Cannot transition from '${currentStage}' stage. All stages completed.`
+        };
     }
-    const allowedNext = validTransitions[currentStage] || [];
-    if (!allowedNext.includes(requestedStage)) {
+    // Only allow transition to the immediate next stage
+    if (requestedStage !== expectedNext) {
         return {
             valid: false,
-            error: `Cannot transition from '${currentStage}' to '${requestedStage}'. Valid options: ${allowedNext.join(', ')}`
+            error: `Cannot skip to '${requestedStage}' stage. Must process '${expectedNext}' stage next. Use empty answers to skip the current stage.`
         };
     }
     return { valid: true };
@@ -483,7 +512,7 @@ async function handleAnswerQuestionTool(args, dotAI, logger, requestId) {
         // Stage-based validation and workflow
         const stageState = getCurrentStage(solution);
         // Validate stage transition
-        const transitionResult = validateStageTransition(stageState.currentStage, args.stage);
+        const transitionResult = validateStageTransition(stageState.currentStage, args.stage, solution);
         if (!transitionResult.valid) {
             const response = {
                 status: 'stage_error',
@@ -512,7 +541,7 @@ async function handleAnswerQuestionTool(args, dotAI, logger, requestId) {
             if (args.stage === 'open') {
                 // Only allow 'open' as the question ID for open stage
                 if (questionId !== 'open') {
-                    validationErrors.push(`Unknown question ID '${questionId}' for stage '${args.stage}'. Open stage only accepts 'open' as question ID.`);
+                    validationErrors.push(`Invalid question ID '${questionId}' for open stage. Use "open" as the key, e.g., {"open": "add persistent storage"}.`);
                     continue;
                 }
                 // Skip further validation for open stage as it doesn't follow Question interface

package/package.json

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