@vfarcic/dot-ai 0.62.0 → 0.64.0

package/dist/core/doc-testing-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-testing-session.d.ts","sourceRoot":"","sources":["../../src/core/doc-testing-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,iBAAiB,EACjB,eAAe,EAEf,YAAY,EACZ,eAAe,EACf,aAAa,EAEb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,wBAAwB;IAEnC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,iBAAiB;IAyB7D;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,iBAAiB,GAAG,IAAI;IAiBnE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IASxD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,IAAI;IAyC/F;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqD5B;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,iBAAiB,EAAE;IAyBjD,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoDvB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAejG;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,eAAe,EAAE,GAAG,IAAI;IAMnE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgFxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAShC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAsD/F;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IA4B/E;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuC7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmDhC;;OAEG;IACH,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,EACvC,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,GAAG,GACT,IAAI;IAoCP;;OAEG;IACH,iCAAiC,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QACxC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,EACF,IAAI,CAAC,EAAE,GAAG,GACT,IAAI;IA4CP;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,WAAW,EAAE;CAqBrE"}
+{"version":3,"file":"doc-testing-session.d.ts","sourceRoot":"","sources":["../../src/core/doc-testing-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,iBAAiB,EACjB,eAAe,EAEf,YAAY,EACZ,eAAe,EACf,aAAa,EAEb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,wBAAwB;IAEnC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,iBAAiB;IAyB7D;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,iBAAiB,GAAG,IAAI;IAiBnE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IASxD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,IAAI;IAyC/F;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqD5B;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,iBAAiB,EAAE;IAyBjD,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoDvB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAejG;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,eAAe,EAAE,GAAG,IAAI;IAMnE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgFxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAShC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAmD/F;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IA4B/E;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuC7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACH,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,EACvC,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,GAAG,GACT,IAAI;IA2BP;;OAEG;IACH,iCAAiC,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QACxC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,EACF,IAAI,CAAC,EAAE,GAAG,GACT,IAAI;IAmCP;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,WAAW,EAAE;CAmBrE"}

package/dist/core/doc-testing-session.js

@@ -112,14 +112,14 @@ DOCUMENTATION TESTING WORKFLOW:
 RESULT SUBMISSION:
 - Always include the sessionId when submitting results
 - Include sectionId when testing individual sections  
-- For section testing: use JSON format {"whatWasDone": "...", "issues": [...], "recommendations": [...]}
+- For section testing: use JSON format {"whatWasDone": "...", "issues": [...]}
 - For scan results: use JSON format {"sections": ["Section 1", "Section 2", ...]}
 - After submitting, the system automatically provides the next step
 
 WORKFLOW PHASES:
 - scan: Identify testable sections → submit {"sections": [...]} JSON
-- test: Test individual sections → submit {"whatWasDone": "...", "issues": [...], "recommendations": [...]} JSON
-- analyze: Review all test results → submit analysis and recommendations
+- test: Test individual sections → submit {"whatWasDone": "...", "issues": [...]} JSON
+- analyze: Review all test results → submit analysis
 - fix: Apply fixes based on analysis → submit fix results
 
 The system manages session state and workflow progression automatically.`;
@@ -205,7 +205,7 @@ The system manages session state and workflow progression automatically.`;
         // Count all items by status
         const allItems = [];
         Object.values(session.sectionResults).forEach(result => {
-            allItems.push(...result.issues, ...result.recommendations);
+            allItems.push(...result.issues);
         });
         if (allItems.length === 0) {
             return "✅ **No issues found** - Documentation appears to be in excellent condition!";
@@ -519,14 +519,11 @@ The system manages session state and workflow progression automatically.`;
             if (!Array.isArray(parsedResults.issues)) {
                 throw new Error('Missing or invalid "issues" field - must be array');
             }
-            if (!Array.isArray(parsedResults.recommendations)) {
-                throw new Error('Missing or invalid "recommendations" field - must be array');
-            }
-            // Convert string arrays to FixableItem arrays if needed
+            // Convert string array to FixableItem array with tracking
+            // Note: Format consolidated in PRD #34 - issues now contain both problems and solutions
             const processedResults = {
                 whatWasDone: parsedResults.whatWasDone,
-                issues: this.convertToFixableItems(parsedResults.issues, session),
-                recommendations: this.convertToFixableItems(parsedResults.recommendations, session)
+                issues: this.convertToFixableItems(parsedResults.issues, session)
             };
             parsedResults = processedResults;
         }
@@ -584,10 +581,10 @@ The system manages session state and workflow progression automatically.`;
         const allItems = [];
         // Collect all FixableItems from all sections
         Object.values(session.sectionResults).forEach(result => {
-            allItems.push(...result.issues, ...result.recommendations);
+            allItems.push(...result.issues);
         });
         if (allItems.length === 0) {
-            return "No issues or recommendations found during testing.";
+            return "No issues found during testing.";
         }
         // Count by status
         const statusCounts = {
@@ -618,33 +615,21 @@ The system manages session state and workflow progression automatically.`;
             return "No test results available.";
         }
         const pendingItems = [];
-        const issues = [];
-        const recommendations = [];
         // Collect all pending/failed items from all sections
+        // Note: Format consolidated in PRD #34 - all issues now include problems and solutions
         Object.values(session.sectionResults).forEach(result => {
             const pendingIssues = result.issues.filter(item => item.status === 'pending' || item.status === 'failed');
-            const pendingRecs = result.recommendations.filter(item => item.status === 'pending' || item.status === 'failed');
-            issues.push(...pendingIssues);
-            recommendations.push(...pendingRecs);
-            pendingItems.push(...pendingIssues, ...pendingRecs);
+            pendingItems.push(...pendingIssues);
         });
         if (pendingItems.length === 0) {
-            return "No pending items - all issues and recommendations have been addressed!";
+            return "No pending items - all issues have been addressed!";
         }
         let output = "";
-        // Format issues section
-        if (issues.length > 0) {
-            output += "### Issues Found (Items requiring fixes)\n";
-            issues.forEach(item => {
-                const statusIndicator = item.status === 'failed' ? ' ❌ [RETRY]' : '';
-                output += `${item.id}. ${item.text}${statusIndicator}\n`;
-            });
-            output += "\n";
-        }
-        // Format recommendations section  
-        if (recommendations.length > 0) {
-            output += "### Recommendations (Items suggesting improvements)\n";
-            recommendations.forEach(item => {
+        // Format all pending items (consolidated format with problems and solutions)
+        if (pendingItems.length > 0) {
+            output += "### Items Requiring Attention\n";
+            output += "*Each item includes both the problem and its fix*\n\n";
+            pendingItems.forEach(item => {
                 const statusIndicator = item.status === 'failed' ? ' ❌ [RETRY]' : '';
                 output += `${item.id}. ${item.text}${statusIndicator}\n`;
             });
@@ -662,7 +647,7 @@ The system manages session state and workflow progression automatically.`;
         let itemFound = false;
         // Search through all sections to find the item with the specified ID
         Object.values(session.sectionResults).forEach(result => {
-            // Check issues
+            // Check issues (consolidated format - all items are in issues array)
             const issueIndex = result.issues.findIndex(item => item.id === itemId);
             if (issueIndex !== -1) {
                 result.issues[issueIndex].status = status;
@@ -671,15 +656,6 @@ The system manages session state and workflow progression automatically.`;
                 itemFound = true;
                 return;
             }
-            // Check recommendations  
-            const recIndex = result.recommendations.findIndex(item => item.id === itemId);
-            if (recIndex !== -1) {
-                result.recommendations[recIndex].status = status;
-                if (explanation)
-                    result.recommendations[recIndex].explanation = explanation;
-                itemFound = true;
-                return;
-            }
         });
         if (!itemFound) {
             throw new Error(`FixableItem with ID ${itemId} not found in session ${sessionId}`);
@@ -699,7 +675,7 @@ The system manages session state and workflow progression automatically.`;
         updates.forEach(update => {
             let itemFound = false;
             Object.values(session.sectionResults).forEach(result => {
-                // Check issues
+                // Check issues (consolidated format - all items are in issues array)
                 const issueIndex = result.issues.findIndex(item => item.id === update.itemId);
                 if (issueIndex !== -1) {
                     result.issues[issueIndex].status = update.status;
@@ -708,15 +684,6 @@ The system manages session state and workflow progression automatically.`;
                     itemFound = true;
                     return;
                 }
-                // Check recommendations  
-                const recIndex = result.recommendations.findIndex(item => item.id === update.itemId);
-                if (recIndex !== -1) {
-                    result.recommendations[recIndex].status = update.status;
-                    if (update.explanation)
-                        result.recommendations[recIndex].explanation = update.explanation;
-                    itemFound = true;
-                    return;
-                }
             });
             if (!itemFound) {
                 notFoundItems.push(update.itemId);
@@ -736,10 +703,10 @@ The system manages session state and workflow progression automatically.`;
             return [];
         }
         const pendingItems = [];
+        // Collect all pending/failed items (consolidated format)
         Object.values(session.sectionResults).forEach(result => {
             const pendingIssues = result.issues.filter(item => item.status === 'pending' || item.status === 'failed');
-            const pendingRecs = result.recommendations.filter(item => item.status === 'pending' || item.status === 'failed');
-            pendingItems.push(...pendingIssues, ...pendingRecs);
+            pendingItems.push(...pendingIssues);
         });
         return pendingItems.sort((a, b) => a.id - b.id); // Sort by ID for consistent ordering
     }

package/dist/core/doc-testing-types.d.ts

@@ -77,11 +77,13 @@ export interface FixableItem {
 }
 /**
  * Structured test results for a section (JSON format from client agent)
+ *
+ * Note: Format was consolidated in PRD #34 - issues now contain both problems and solutions
+ * in format "[Location]: [Problem]. Fix: [Solution]"
  */
 export interface SectionTestResult {
     whatWasDone: string;
     issues: FixableItem[];
-    recommendations: FixableItem[];
 }
 /**
  * Workflow step returned by MCP interface to guide AI agents

package/dist/core/doc-testing-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-testing-types.d.ts","sourceRoot":"","sources":["../../src/core/doc-testing-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doc-testing-types.d.ts","sourceRoot":"","sources":["../../src/core/doc-testing-types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.62.0",
+  "version": "0.64.0",
   "description": "Universal Kubernetes application deployment agent with MCP interface",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prompts/doc-testing-done.md

@@ -40,7 +40,7 @@ Your session data is stored at: `{sessionDir}/{sessionId}.json`
 
 This contains:
 - Complete test results for each section
-- Status of all issues and recommendations  
+- Status of all issues and their fixes  
 - Timestamps and progress tracking
 - Applied fixes and user decisions
 

package/prompts/doc-testing-test-section.md

@@ -3,7 +3,7 @@
 You are testing a specific section of documentation to validate both functionality AND accuracy. You must verify that instructions work AND that the documentation text truthfully describes what actually happens.
 
 **Important**: 
-- Skip content that has ignore comments containing "dotai-ignore" (e.g., `<!-- dotai-ignore -->`, `.. dotai-ignore`, `// dotai-ignore`). Do not generate issues or recommendations for ignored content.
+- Skip content that has ignore comments containing "dotai-ignore" (e.g., `<!-- dotai-ignore -->`, `.. dotai-ignore`, `// dotai-ignore`). Do not generate issues for ignored content.
 - Look for testing hints in comments containing "dotai-test-hint" (e.g., `<!-- dotai-test-hint: use mcp__dot-ai__prompts to verify slash commands -->`, `.. dotai-test-hint: run command X to test claim Y`, `// dotai-test-hint: check actual behavior with tool Z`). Follow these hints when testing the associated content.
 
 ## CRITICAL MINDSET: User Behavior Simulation
@@ -124,12 +124,8 @@ Return your results as JSON in this exact format:
 {
   "whatWasDone": "Brief summary of what you tested and executed in this section",
   "issues": [
-    "Specific problem or issue you found while testing",
-    "Another issue that prevents users from succeeding"
-  ],
-  "recommendations": [
-    "Specific actionable suggestion to fix an issue",
-    "Improvement that would help users succeed"
+    "In 'Section Name': Specific problem or issue you found while testing. Fix: Specific actionable solution to resolve this issue",
+    "Under 'Code Example': Another issue that prevents users from succeeding. Fix: Detailed steps to correct this problem"
   ]
 }
 ```
@@ -138,13 +134,23 @@ Return your results as JSON in this exact format:
 
 **whatWasDone** (string): Concise summary covering BOTH functional testing AND semantic analysis - what commands/procedures you executed and what claims you analyzed.
 
-**issues** (array): CRITICAL PROBLEMS that prevent users from succeeding (broken functionality, incorrect information, missing required steps). Include precise location and explain user impact. Each issue must be ACTIONABLE - describe what needs to be changed/fixed.
+**issues** (array): Each issue must contain BOTH the problem AND its solution in a single string using this exact format:
+- **Location**: Start with precise location: "In 'Section Name':", "Under 'Heading':", "At line X:", etc.
+- **Problem**: Clear description of what's wrong, broken, or prevents user success
+- **Solution**: Follow with " Fix: " and provide specific actionable steps to resolve the issue
 
-**recommendations** (array): OPTIONAL IMPROVEMENTS that would enhance user experience (NOT critical problems). Must be genuinely optional - user can succeed without these changes. Each recommendation must be ACTIONABLE - describe a specific change to make. Do NOT include statements that validate existing content is correct (e.g., "The format matches actual behavior - this is accurate"). Only include suggestions for actual changes or additions. Do NOT repeat anything from issues array.
+**Format Requirements:**
+- **Include both critical problems AND optional improvements** - All actionable findings go in the issues array
+- **Location specificity**: Every issue must identify exactly where the problem is found
+- **Complete solutions**: Each fix must be detailed enough for implementation
+- **User impact focus**: Emphasize how problems affect user success and how fixes improve experience
+- **Consistent pattern**: "[Location]: [Problem description]. Fix: [Detailed solution]"
 
-**ACTIONABILITY REQUIREMENT**: Both issues and recommendations must suggest concrete changes. Avoid validation statements like "X is correct" or "Y matches expected behavior." If something is working correctly, don't mention it unless suggesting an enhancement.
+**ACTIONABILITY REQUIREMENT**: Every issue must be actionable with a concrete fix. Avoid validation statements like "X is correct." If something is working correctly, don't mention it unless suggesting a specific enhancement.
 
-**ANTI-DUPLICATION RULES**: If something is broken/incorrect → issues only. If something could be enhanced but works fine → recommendations only. Never put the same concept in both arrays.
+**Examples:**
+- "In 'Installation' section: Missing kubectl prerequisite causes setup failure. Fix: Add 'kubectl installation required' note before cluster setup steps"
+- "Under 'API Examples': Outdated endpoint URL returns 404 errors. Fix: Update endpoint from '/v1/api' to '/v2/api' throughout examples"
 
 ## Instructions