@codeyam/codeyam-cli 0.1.0-staging.1 → 0.1.0-staging.596f0eb

package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js

@@ -1,8 +1,39 @@
 import cleanOutBoundary from "../cleanOutBoundary.js";
 import { joinParenthesesAndArrays, splitOutsideParenthesesAndArrays, } from "../splitOutsideParentheses.js";
+/**
+ * Checks if a bracket-only path is a valid string key access (not just an index).
+ * Valid: ['*'], ['someKey'] - string key access
+ * Invalid: [0], [1] - numeric index only (meaningless without parent path)
+ */
+function isValidBracketStringKey(attribute) {
+    // Match ['string'] or ["string"] patterns
+    return /^\[['"][^'"]+['"]\]$/.test(attribute);
+}
+/**
+ * Extracts the string key from a bracket notation like ['*'] or ["key"]
+ * Returns the key without quotes and brackets, e.g., '*' or 'key'
+ */
+function extractBracketStringKey(attribute) {
+    const match = attribute.match(/^\[['"]([^'"]+)['"]\]$/);
+    return match ? match[1] : null;
+}
+/**
+ * Normalizes a path by extracting string keys from bracket notation.
+ * If the path is a single bracket string key like ['*'], returns the key ('*').
+ * Otherwise returns the path unchanged.
+ */
+function normalizePathForInternalUse(path) {
+    const extracted = extractBracketStringKey(path);
+    return extracted !== null ? extracted : path;
+}
 function validAttribute(attribute) {
-    if (!attribute || attribute.length === 0 || attribute.startsWith('['))
+    if (!attribute || attribute.length === 0)
         return false;
+    // Allow string-key bracket access like ['*'] or ['someKey']
+    // These are valid data paths from objects with dynamic/special keys
+    if (attribute.startsWith('[')) {
+        return isValidBracketStringKey(attribute);
+    }
     const attributeParts = splitOutsideParenthesesAndArrays(attribute);
     if (attributeParts.some((part) => cleanOutBoundary(cleanOutBoundary(part), '<', '>').match(/\s/))) {
         return false;
@@ -16,15 +47,57 @@ function validAttribute(attribute) {
     }
     return true;
 }
-export function gatherAttributesMap(entity, reverse = false) {
+/**
+ * Gathers attributes from data structures for use in prompts.
+ *
+ * @param isolatedDataStructure - The entity's own data structure (determines which paths to include)
+ * @param mergedDataStructureOrEquivalentVars - Either the merged data structure (with richer types from
+ *   dependent analyses) OR equivalentSignatureVariables for backwards compatibility
+ * @param equivalentSignatureVariablesOrReverse - Either equivalentSignatureVariables OR reverse flag
+ * @param reverseArg - The reverse flag (only used when all 4 args provided)
+ */
+export function gatherAttributesMap(isolatedDataStructure, mergedDataStructureOrEquivalentVars, equivalentSignatureVariablesOrReverse, reverseArg) {
+    // Handle backwards compatibility: detect if called with old signature
+    // Old: (mergedDataStructure, equivalentSignatureVariables?, reverse?)
+    // New: (isolatedDataStructure, mergedDataStructure, equivalentSignatureVariables?, reverse?)
+    let mergedDataStructure;
+    let equivalentSignatureVariables;
+    let reverse;
+    if (mergedDataStructureOrEquivalentVars &&
+        typeof mergedDataStructureOrEquivalentVars === 'object' &&
+        'dependencySchemas' in mergedDataStructureOrEquivalentVars) {
+        // New signature: (isolated, merged, equivalentVars?, reverse?)
+        mergedDataStructure = mergedDataStructureOrEquivalentVars;
+        equivalentSignatureVariables =
+            equivalentSignatureVariablesOrReverse ??
+                {};
+        reverse = reverseArg ?? false;
+    }
+    else {
+        // Old signature: (merged, equivalentVars?, reverse?)
+        // Use isolatedDataStructure as both isolated and merged for backwards compatibility
+        mergedDataStructure = null; // Will use isolatedDataStructure for types
+        equivalentSignatureVariables =
+            mergedDataStructureOrEquivalentVars ??
+                {};
+        reverse =
+            equivalentSignatureVariablesOrReverse ?? false;
+    }
     const attributesMap = {};
     const associationMap = {};
     // Maps internalPath -> full data structure path (e.g., "useDiffModal().diffView")
     const dataStructurePathMap = {};
-    const { signatureSchema, equivalentSignatureVariables, dependencySchemas } = entity.metadata.isolatedDataStructure;
-    for (const key in signatureSchema) {
+    // Use isolatedDataStructure for paths, but look up types in mergedDataStructure when available
+    const isolatedSignatureSchema = isolatedDataStructure.signatureSchema;
+    const mergedSignatureSchema = mergedDataStructure?.signatureSchema ?? isolatedSignatureSchema;
+    const isolatedDependencySchemas = isolatedDataStructure.dependencySchemas;
+    const mergedDependencySchemas = mergedDataStructure?.dependencySchemas ?? isolatedDependencySchemas;
+    // Process signature schema - use isolatedDataStructure keys, but merged types
+    for (const key in isolatedSignatureSchema) {
         const keyParts = splitOutsideParenthesesAndArrays(key);
         if (keyParts[0].startsWith('signature')) {
+            // Use merged type if available, otherwise fall back to isolated type
+            const typeValue = mergedSignatureSchema[key] ?? isolatedSignatureSchema[key];
             const equivalentSignatureVariable = equivalentSignatureVariables[keyParts[0]];
             const equivalentSignatureVariableParts = splitOutsideParenthesesAndArrays(equivalentSignatureVariable);
             if (equivalentSignatureVariable &&
@@ -34,7 +107,7 @@ export function gatherAttributesMap(entity, reverse = false) {
                     equivalentKey,
                     ...keyParts.slice(1),
                 ]);
-                attributesMap[equivalentPath] = signatureSchema[key];
+                attributesMap[equivalentPath] = typeValue;
                 associationMap[reverse ? equivalentPath : key] = reverse
                     ? key
                     : equivalentPath;
@@ -43,7 +116,7 @@ export function gatherAttributesMap(entity, reverse = false) {
             }
             else {
                 const relativePath = joinParenthesesAndArrays(keyParts.slice(1));
-                attributesMap[relativePath] = signatureSchema[key];
+                attributesMap[relativePath] = typeValue;
                 associationMap[reverse ? relativePath : key] = reverse
                     ? key
                     : relativePath;
@@ -52,22 +125,29 @@ export function gatherAttributesMap(entity, reverse = false) {
             }
         }
     }
-    for (const filePath in dependencySchemas) {
-        for (const entityName in dependencySchemas[filePath]) {
-            const returnValueDataStructure = dependencySchemas[filePath][entityName].returnValueSchema ?? {};
-            // First pass: collect all function paths
+    // Process dependency schemas - iterate through isolatedDependencySchemas (for which paths to include)
+    // but use mergedDependencySchemas for types (richer type information)
+    for (const filePath in isolatedDependencySchemas) {
+        for (const entityName in isolatedDependencySchemas[filePath]) {
+            // Get the isolated return value schema (determines which paths exist)
+            const isolatedReturnValueSchema = isolatedDependencySchemas[filePath][entityName].returnValueSchema ?? {};
+            // Get the merged return value schema (for richer types)
+            const mergedReturnValueSchema = mergedDependencySchemas?.[filePath]?.[entityName]?.returnValueSchema ??
+                isolatedReturnValueSchema;
+            // First pass: collect all function paths from merged schema (for broader coverage)
             const functionPaths = [];
-            for (const path in returnValueDataStructure) {
-                if (returnValueDataStructure[path] === 'function') {
+            for (const path in mergedReturnValueSchema) {
+                if (mergedReturnValueSchema[path] === 'function') {
                     functionPaths.push(path);
                 }
             }
-            // Second pass: process all paths
-            for (const path in returnValueDataStructure) {
+            // Second pass: process paths from merged schema, but only include paths that
+            // are rooted in an isolated path (i.e., isolatedDataStructure knows about this dependency)
+            for (const path in mergedReturnValueSchema) {
                 const pathParts = splitOutsideParenthesesAndArrays(path);
                 if (pathParts.length < 2)
                     continue;
-                if (returnValueDataStructure[path] === 'function') {
+                if (mergedReturnValueSchema[path] === 'function') {
                     continue;
                 }
                 // Check if this path is inside a function (but not a function return value we care about)
@@ -106,7 +186,7 @@ export function gatherAttributesMap(entity, reverse = false) {
                             const relativePath = path;
                             if (!validAttribute(relativePath))
                                 continue;
-                            attributesMap[relativePath] = returnValueDataStructure[path];
+                            attributesMap[relativePath] = mergedReturnValueSchema[path];
                             associationMap[reverse ? relativePath : path] = reverse
                                 ? path
                                 : relativePath;
@@ -117,10 +197,13 @@ export function gatherAttributesMap(entity, reverse = false) {
                     }
                     // Fall through to normal processing for other return value properties
                 }
-                const relativePath = joinParenthesesAndArrays(pathParts.slice(2));
-                if (!validAttribute(relativePath))
+                const rawRelativePath = joinParenthesesAndArrays(pathParts.slice(2));
+                if (!validAttribute(rawRelativePath))
                     continue;
-                attributesMap[relativePath] = returnValueDataStructure[path];
+                // Normalize the path for internal use (e.g., ['*'] -> '*')
+                const relativePath = normalizePathForInternalUse(rawRelativePath);
+                // Use the type from mergedReturnValueSchema
+                attributesMap[relativePath] = mergedReturnValueSchema[path];
                 associationMap[reverse ? relativePath : path] = reverse
                     ? path
                     : relativePath;

package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"gatherAttributesMap.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/gatherAttributesMap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gatherAttributesMap.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/gatherAttributesMap.ts"],"names":[],"mappings":"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"}

package/packages/ai/src/lib/promptGenerators/generateChangesEntityDocumentationGenerator.js

@@ -1,43 +1,18 @@
 export default function generateChangesEntityDocumentationGenerator(entity, previousDocumentation) {
-    return `A function recently changed. Here is the current documentation for that function:
+    return `## Task
+Review if the existing documentation is still accurate after code changes. If accurate, respond "No changes needed". Otherwise, provide updated documentation.
 
-"""
+## Current Documentation
 ${previousDocumentation}
-"""  
 
-and here is the new code for ${entity.name}:
-  
-"""
+## Updated Code
+\`\`\`typescript
 ${entity.code}
-"""
-
-If the existing documentation is still accurate please respond with "No changes needed". 
-
-Otherwise, please update the documentation to reflect the changes in the code. Using these instructions:
-
-- Start with an overview that describes the overall intent of the code. Be concise in your language. Immediately start with the intent of the code. Here is an example Overview:
-
-\`\`\` Overview
-Displays details about a specific Git commit. It shows the commit message, author, date, and provides a link to the commit on GitHub. Users can copy the commit SHA to their clipboard, with a visual indication of the copy action.
 \`\`\`
 
-Note that it does not mention the name of the function but dives directly into what the code does in concise language followed by a small amount of detail.
-
-- Next, specify the inputs (with details about types, how the input is used, and examples) and expected outputs (with details about types and examples).
-
-- Finally, provide examples of how the code can be used with clear inputs and outputs for each example. Provide diverse examples (there's no need to include repetitive examples). 
-
-Write the documentation as markdown. Be concise. Use bullets when possible. No one wants to read long paragraphs of text. 
-
-Provide no other text than the documentation in proper markdown using the headers below.
-
-## Overview
-
-## Inputs
-
-## Output
+## Overview Example
+Good: "Displays details about a specific Git commit. Shows the commit message, author, date, and provides a link to GitHub."
 
-## Examples
-`;
+Bad: "The CommitDetails function takes a commit object..." (mentions the function name)`;
 }
 //# sourceMappingURL=generateChangesEntityDocumentationGenerator.js.map

package/packages/ai/src/lib/promptGenerators/generateChangesEntityDocumentationGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateChangesEntityDocumentationGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateChangesEntityDocumentationGenerator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,2CAA2C,CACjE,MAAc,EACd,qBAA6B;IAE7B,OAAO;;;EAGP,qBAAqB;;;+BAGQ,MAAM,CAAC,IAAI;;;EAGxC,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BZ,CAAC;AACF,CAAC"}
+{"version":3,"file":"generateChangesEntityDocumentationGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateChangesEntityDocumentationGenerator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,2CAA2C,CACjE,MAAc,EACd,qBAA6B;IAE7B,OAAO;;;;EAIP,qBAAqB;;;;EAIrB,MAAM,CAAC,IAAI;;;;;;wFAM2E,CAAC;AACzF,CAAC"}

package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js

@@ -41,62 +41,56 @@ function filterData(rootStructure, rootData) {
     };
 }
 export default function generateChangesEntityScenarioDataGenerator(structure, scenario, existingScenario, defaultScenarioData, incompleteResponse) {
-    return `${incompleteResponse
+    const incompleteSection = incompleteResponse
         ? `## Incomplete Response
-
-Here is the incomplete response. Please use this and the following data to complete the response, only returning the missing data.
-
-Just pick up where this response left off. It will be improper json but we will combine the responses into proper json.
-
-\`\`\` START INCOMPLETE RESPONSE \`\`\`
+Continue from where this left off (combine for valid JSON):
+\`\`\`
 ${incompleteResponse}
-\`\`\` END INCOMPLETE RESPONSE \`\`\`
+\`\`\`
 
 `
-        : ''}## Scenario
-  
-This scenario needs mock data to support it. Here are the keyAttributeInstructions for generating this scenario:
-\`\`\`
-${JSON.stringify({
+        : '';
+    const scenarioJson = JSON.stringify({
         name: scenario.name,
         description: scenario.description,
         keyAttributeInstructions: scenario.metadata.keyAttributeInstructions,
-    }, null, 2)}
-\`\`\`
-
-## Existing Scenario
-  
-Here are the "keyAttributeInstructions" and data for this scenario before this more recent code change. Please maintain the existing data as effectively as possible while fulfilling the new data structure and "keyAttributeInstructions".
-\`\`\`
-${JSON.stringify({
+    }, null, 2);
+    const existingJson = JSON.stringify({
         name: existingScenario.name,
         data: filterData(structure, existingScenario.metadata.data),
-    }, null, 2)}
-\`\`\`
-${defaultScenarioData
+    }, null, 2);
+    const defaultSection = defaultScenarioData
         ? `
-## Default Scenario
-
-Data for the default scenario. Do not modify it. The data you are generating will be merged into it to create the full data.
-\`\`\`
+## Default Scenario Data (merge base, do not modify)
+\`\`\`json
 ${JSON.stringify(defaultScenarioData.data, null, 2)}
 \`\`\`
 `
-        : ''}
-${structure.dataForMocks
-        ? `The mockData structure (for the default scenario provide robust values for the entire structure):
-\`\`\`
+        : '';
+    const mockDataSection = structure.dataForMocks
+        ? `## mockData Structure
+\`\`\`json
 ${JSON.stringify(structure.dataForMocks, null, 2)}
-\`\`\`
-`
-        : 'There is no mockData for this file. Return {} for the mockData.'}
-    
-${structure.arguments
-        ? `The argumentsData structure (for the default scenario provide robust values for the entire structure):
-\`\`\`
+\`\`\``
+        : '## mockData Structure\nNone—return `{}` for mockData.';
+    const argumentsSection = structure.arguments
+        ? `## argumentsData Structure
+\`\`\`json
 ${JSON.stringify(structure.arguments, null, 2)}
+\`\`\``
+        : '## argumentsData Structure\nNone—return `[]` for argumentsData.';
+    return `${incompleteSection}## Scenario (new instructions)
+\`\`\`json
+${scenarioJson}
 \`\`\`
-`
-        : 'There is no argumentsData for this file. Return [] for the argumentsData.'}`;
+
+## Existing Scenario (preserve where possible)
+\`\`\`json
+${existingJson}
+\`\`\`
+${defaultSection}
+${mockDataSection}
+
+${argumentsSection}`;
 }
 //# sourceMappingURL=generateChangesEntityScenarioDataGenerator.js.map

package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateChangesEntityScenarioDataGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generateChangesEntityScenarioDataGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.ts"],"names":[],"mappings":"AAEA,SAAS,UAAU,CACjB,aAAqC,EACrC,QAA8B;IAE9B,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ;QAAE,OAAO;IAExC,MAAM,WAAW,GAAG,CAAC,SAAc,EAAE,IAAS,EAAO,EAAE;QACrD,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAErC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/D,MAAM,YAAY,GAAQ,EAAE,CAAC;YAC7B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,IAAI,GAAG,KAAK,kBAAkB,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;oBAC5D,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChC,CAAC;qBAAM,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpC,IAAI,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;wBACvC,YAAY,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7D,CAAC;yBAAM,CAAC;wBACN,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,MAAM,aAAa,GAAG,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAChC,aAAa,CAAC,IAAI,CAChB,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CACnD,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,aAAa,CAAC;QACvE,YAAY,EAAE,WAAW,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,0CAA0C,CAChE,SAAiC,EACjC,QAAkB,EAClB,gBAA0B,EAC1B,mBAAkC,EAClC,kBAA2B;IAE3B,MAAM,iBAAiB,GAAG,kBAAkB;QAC1C,CAAC,CAAC;;;EAGJ,kBAAkB;;;CAGnB;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CACjC;QACE,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,wBAAwB,EAAE,QAAQ,CAAC,QAAQ,CAAC,wBAAwB;KACrE,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CACjC;QACE,IAAI,EAAE,gBAAgB,CAAC,IAAI;QAC3B,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;KAC5D,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IAEF,MAAM,cAAc,GAAG,mBAAmB;QACxC,CAAC,CAAC;;;EAGJ,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;;CAElD;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,eAAe,GAAG,SAAS,CAAC,YAAY;QAC5C,CAAC,CAAC;;EAEJ,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;OAC1C;QACH,CAAC,CAAC,uDAAuD,CAAC;IAE5D,MAAM,gBAAgB,GAAG,SAAS,CAAC,SAAS;QAC1C,CAAC,CAAC;;EAEJ,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;OACvC;QACH,CAAC,CAAC,iEAAiE,CAAC;IAEtE,OAAO,GAAG,iBAAiB;;EAE3B,YAAY;;;;;EAKZ,YAAY;;EAEZ,cAAc;EACd,eAAe;;EAEf,gBAAgB,EAAE,CAAC;AACrB,CAAC"}

package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js

@@ -1,13 +1,13 @@
 import gatherRelevantDependentKeyAttributes from "../gatherRelevantDependentKeyAttributes.js";
-export default function generateChangesEntityScenariosGenerator({ entity, keyAttributes, addedKeyAttributes, removedKeyAttributes, dependentAnalyses, existingScenarios, commitDiff, error, changedDataStructureFields = [], }) {
-    const relevantDependentKeyAttributesFlat = gatherRelevantDependentKeyAttributes(entity, dependentAnalyses);
+export default function generateChangesEntityScenariosGenerator({ entity, mergedDataStructure, keyAttributes, addedKeyAttributes, removedKeyAttributes, dependentAnalyses, existingScenarios, commitDiff, error, changedDataStructureFields = [], }) {
+    const relevantDependentKeyAttributesFlat = gatherRelevantDependentKeyAttributes(entity, mergedDataStructure, dependentAnalyses);
     // Restructure flat array into nested format: { [filePath]: { [entityName]: KeyAttribute[] } }
     const relevantDependentKeyAttributes = {};
     for (const attr of relevantDependentKeyAttributesFlat) {
         const filePath = attr.filePath;
         const entityName = attr.originalEntityName;
         if (!filePath || !entityName)
-            continue; // Skip if missing required fields
+            continue;
         if (!relevantDependentKeyAttributes[filePath]) {
             relevantDependentKeyAttributes[filePath] = {};
         }
@@ -16,101 +16,94 @@ export default function generateChangesEntityScenariosGenerator({ entity, keyAtt
         }
         relevantDependentKeyAttributes[filePath][entityName].push(attr);
     }
-    return `Added Key Attributes:
-
-\`\`\`
-${addedKeyAttributes && addedKeyAttributes.length > 0
-        ? JSON.stringify(addedKeyAttributes.map((ka) => ({
-            dataStructurePath: ka.dataStructurePath, // Full path in mockData
-            localVariable: ka.internalPath, // Local variable name
-            description: ka.description,
-            validValueOptions: ka.validValueOptions,
-        })), null, 2)
-        : 'None'}
-\`\`\`
-
-Removed Key Attributes:
-
-\`\`\`
-${removedKeyAttributes && removedKeyAttributes.length > 0 ? JSON.stringify(removedKeyAttributes, null, 2) : 'None'}
-\`\`\`
-
-${changedDataStructureFields.length > 0
-        ? `Changed Data Structure Fields:
-
-The following fields in the data structure have changed (type changed, added, or removed):
-
-\`\`\`
-${JSON.stringify(changedDataStructureFields, null, 2)}
-\`\`\`
-
-**IMPORTANT**: For scenarios that reference these changed fields in their keyAttributeInstructions, you MUST regenerate those specific instructions to match the new data structure. For example:
-- If "stats.visualEntities" changed from an array to a number, update keyAttributeInstructions from "Array of 10 objects" to "10 (count of visual entities)"
-- If a field was removed, remove it from keyAttributeInstructions
-- If a field was added, you may add it to keyAttributeInstructions if relevant for the scenario
-
-Fields that did NOT change can retain their existing keyAttributeInstructions.
-
-`
-        : ''}
-Existing Key Attributes:
-
-\`\`\`
-${JSON.stringify(keyAttributes.map((ka) => ({
-        dataStructurePath: ka.dataStructurePath, // Full path in mockData
-        localVariable: ka.internalPath, // Local variable name
+    const formatKeyAttrs = (attrs) => attrs.map((ka) => ({
+        dataStructurePath: ka.dataStructurePath,
+        localVariable: ka.internalPath,
         description: ka.description,
         validValueOptions: ka.validValueOptions,
-    })), null, 2)}
+        // Include new fields when present
+        ...(ka.valueType && { valueType: ka.valueType }),
+        ...(ka.dependencies && { dependencies: ka.dependencies }),
+    }));
+    const addedSection = addedKeyAttributes?.length > 0
+        ? JSON.stringify(formatKeyAttrs(addedKeyAttributes), null, 2)
+        : 'None';
+    const removedSection = removedKeyAttributes?.length > 0
+        ? JSON.stringify(removedKeyAttributes, null, 2)
+        : 'None';
+    const changedFieldsSection = changedDataStructureFields.length > 0
+        ? `
+## Changed Data Structure Fields
+Fields that changed type, were added, or removed:
+\`\`\`json
+${JSON.stringify(changedDataStructureFields, null, 2)}
 \`\`\`
 
-Existing Scenarios:
-
-\`\`\`
-${JSON.stringify(existingScenarios
+**Update keyAttributeInstructions for affected scenarios** (e.g., if "stats.visualEntities" changed from array to number).
+`
+        : '';
+    const existingScenariosJson = JSON.stringify(existingScenarios
         .filter((s) => (error ? !!s.metadata.error : !s.metadata.error))
         .map((s) => ({
         name: s.name,
         description: s.description,
         keyAttributeInstructions: s.metadata.keyAttributeInstructions,
         playwrightInstructions: s.metadata.playwrightInstructions,
-    })), null, 2)}
-\`\`\`
-
-${commitDiff
+    })), null, 2);
+    const diffSection = commitDiff
         ? `
-Code Change:
-
-\`\`\`
+## Code Change (Diff)
+\`\`\`diff
 ${commitDiff}
-\`\`\`
-`
-        : ''}
-Function Code:
-
-\`\`\`
-${entity.code}
-\`\`\`
-
-${!error &&
+\`\`\``
+        : '';
+    const dependencySection = !error &&
         relevantDependentKeyAttributes &&
         Object.keys(relevantDependentKeyAttributes).length > 0
-        ? `Key Attributes for Dependencies:
-\`\`\`
+        ? `
+## Dependency Key Attributes
+\`\`\`json
 ${JSON.stringify(Object.keys(relevantDependentKeyAttributes).reduce((acc, path) => {
             acc[path] = Object.keys(relevantDependentKeyAttributes[path]).reduce((entityAcc, entityName) => {
                 entityAcc[entityName] = relevantDependentKeyAttributes[path][entityName].map((ka) => ({
-                    dataStructurePath: ka.dataStructurePath, // Full path in mockData
-                    localVariable: ka.path || ka.internalPath, // Local variable name
+                    dataStructurePath: ka.dataStructurePath,
+                    localVariable: ka.path || ka.internalPath,
                     description: ka.description,
                     validValueOptions: ka.validValueOptions,
+                    // Include new fields when present
+                    ...(ka.valueType && { valueType: ka.valueType }),
+                    ...(ka.dependencies && { dependencies: ka.dependencies }),
                 }));
                 return entityAcc;
             }, {});
             return acc;
         }, {}), null, 2)}
 \`\`\``
-        : ''}
-`;
+        : '';
+    return `## Added Key Attributes
+\`\`\`json
+${addedSection}
+\`\`\`
+
+## Removed Key Attributes
+\`\`\`json
+${removedSection}
+\`\`\`
+${changedFieldsSection}
+## Current Key Attributes
+\`\`\`json
+${JSON.stringify(formatKeyAttrs(keyAttributes), null, 2)}
+\`\`\`
+
+## Existing Scenarios
+\`\`\`json
+${existingScenariosJson}
+\`\`\`
+${diffSection}
+
+## Current Code
+\`\`\`typescript
+${entity.code}
+\`\`\`${dependencySection}`;
 }
 //# sourceMappingURL=generateChangesEntityScenariosGenerator.js.map

package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateChangesEntityScenariosGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generateChangesEntityScenariosGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.ts"],"names":[],"mappings":"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"}

package/packages/ai/src/lib/promptGenerators/generateEntityDocumentationGenerator.js

@@ -1,34 +1,15 @@
 export default function generateEntityDocumentationGenerator(entity) {
-    return `Here is the code for ${entity.name}:
-  
-"""
-${entity.code}
-"""
-
-What does this code do? Please create documentation for this code. 
-
-- Start with an overview that describes the overall intent of the code. Be concise in your language. Immediately start with the intent of the code. Here is an example Overview:
+    return `## Task
+Document the following code.
 
-\`\`\` Overview
-Displays details about a specific Git commit. It shows the commit message, author, date, and provides a link to the commit on GitHub. Users can copy the commit SHA to their clipboard, with a visual indication of the copy action.
+## Code
+\`\`\`typescript
+${entity.code}
 \`\`\`
 
-Note that it does not mention the name of the function but dives directly into what the code does in concise language followed by a small amount of detail.
-
-- Next, specify the inputs (with details about types, how the input is used, and examples) and expected outputs (with details about types and examples).
-
-- Finally, provide examples of how the code can be used with clear inputs and outputs for each example. Provide diverse examples (there's no need to include repetitive examples). 
-
-Write the documentation as markdown. Be concise. Use bullets when possible. No one wants to read long paragraphs of text. 
-
-Provide no other text than the documentation in proper markdown using the headers below.
-
-## Overview
-
-## Inputs
-
-## Output
+## Overview Example
+Good: "Displays details about a specific Git commit. Shows the commit message, author, date, and provides a link to GitHub. Users can copy the commit SHA to clipboard."
 
-## Examples`;
+Bad: "The CommitDetails function takes a commit object..." (mentions the function name)`;
 }
 //# sourceMappingURL=generateEntityDocumentationGenerator.js.map

package/packages/ai/src/lib/promptGenerators/generateEntityDocumentationGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateEntityDocumentationGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateEntityDocumentationGenerator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,oCAAoC,CAAC,MAAc;IACzE,OAAO,wBAAwB,MAAM,CAAC,IAAI;;;EAG1C,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;YA2BD,CAAC;AACb,CAAC"}
+{"version":3,"file":"generateEntityDocumentationGenerator.js","sourceRoot":"","sources":["../../../../../../../packages/ai/src/lib/promptGenerators/generateEntityDocumentationGenerator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,oCAAoC,CAAC,MAAc;IACzE,OAAO;;;;;EAKP,MAAM,CAAC,IAAI;;;;;;wFAM2E,CAAC;AACzF,CAAC"}