@codeyam/codeyam-cli 0.1.0-bleeding-edge.8afd3ee

package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js

@@ -0,0 +1,190 @@
+import completionCall from "./completionCall.js";
+import { saveLlmCall } from "../../../../packages/aws/dynamodb/index.js";
+import generateEntityKeyAttributesGenerator from "./promptGenerators/generateEntityKeyAttributesGenerator.js";
+import { awsLog } from "../../../../packages/utils/index.js";
+import { DEFAULT_LARGER_MODEL } from "../../../../packages/ai/index.js";
+import isFrontend from "./isFrontend.js";
+import { gatherAttributesMap } from "./promptGenerators/gatherAttributesMap.js";
+export default async function generateChangesEntityKeyAttributes({ entity, existingKeyAttributes, analysis, commitDiff, model, }) {
+    awsLog(`CodeYam: Generating entity key attributes`, {
+        filePath: entity.filePath,
+        entityName: entity.name,
+        analysisId: analysis.id,
+        existingKeyAttributes: existingKeyAttributes?.map((a) => a.externalPath),
+    });
+    const { attributesMap, associationMap, dataStructurePathMap } = gatherAttributesMap(entity, true);
+    const prompt = generateEntityKeyAttributesGenerator({
+        code: entity.code,
+        attributesMap,
+        existingKeyAttributes,
+        commitDiff,
+    });
+    const response = await completionCall({
+        type: `generateChangesEntityKeyAttributes`,
+        systemMessage: isFrontend(entity.filePath)
+            ? FRONTEND_SYSTEM_MESSAGE
+            : BACKEND_SYSTEM_MESSAGE,
+        prompt,
+        model: model ?? DEFAULT_LARGER_MODEL,
+    });
+    const llmCall = await saveLlmCall({
+        object_type: 'analysis',
+        object_id: analysis.id,
+        propsJson: {
+            entity: {
+                name: entity.name,
+                filePath: entity.filePath,
+                code: entity.code,
+            },
+            analysis: {
+                id: analysis.id,
+                metadata: {
+                    isolatedDataStructure: entity.metadata.isolatedDataStructure,
+                    keyAttributes: analysis.metadata?.keyAttributes ?? [],
+                },
+            },
+            commitDiff,
+            model,
+        },
+        ...response.stats,
+    });
+    const { completion: keyAttributesString } = response;
+    if (!keyAttributesString) {
+        console.log(`CodeYam Error: Error Generating changes entity key attributes failed: No response from AI`);
+        return null;
+    }
+    awsLog(`LLMCall ${llmCall ? llmCall.id : 'N/A'}: ${entity.filePath} ${entity.name} changes key attributes :>> `, keyAttributesString);
+    const { addedKeyAttributes, removedKeyAttributes } = JSON.parse(keyAttributesString);
+    const keyAttributes = [
+        ...(existingKeyAttributes ?? []),
+    ];
+    for (const addedKeyAttribute of addedKeyAttributes ?? []) {
+        const internalPath = addedKeyAttribute.path;
+        const index = keyAttributes.findIndex((a) => a.internalPath === internalPath);
+        const fullKeyAttribute = {
+            internalPath,
+            externalPath: associationMap[internalPath],
+            dataStructurePath: dataStructurePathMap[internalPath] || internalPath,
+            description: addedKeyAttribute.description,
+            validValueOptions: addedKeyAttribute.validValueOptions,
+            errorValueOptions: addedKeyAttribute.errorValueOptions,
+        };
+        if (index !== -1) {
+            keyAttributes.splice(index, 1, fullKeyAttribute);
+        }
+        else {
+            keyAttributes.push(fullKeyAttribute);
+        }
+    }
+    for (const removedKeyAttribute of removedKeyAttributes ?? []) {
+        const internalPath = typeof removedKeyAttribute === 'string'
+            ? removedKeyAttribute
+            : removedKeyAttribute.path;
+        const index = keyAttributes.findIndex((a) => a.internalPath === internalPath);
+        if (index !== -1) {
+            keyAttributes.splice(index, 1);
+        }
+    }
+    const sortedUniqueKeyAttributes = keyAttributes
+        .filter((keyAttribute, index, self) => self.findIndex((ka) => ka.internalPath === keyAttribute.internalPath) === index)
+        .filter((keyAttribute) => attributesMap[keyAttribute.internalPath]);
+    return {
+        keyAttributes: sortedUniqueKeyAttributes,
+        llmCall,
+    };
+}
+const FRONTEND_SYSTEM_MESSAGE = `You are updating the key attributes for a frontend component that was recently changed.
+
+This is an INCREMENTAL update. Existing key attributes should be preserved unless the code change clearly invalidates them. Removing and re-adding attributes across changes causes unnecessary churn.
+
+## Stability Rules
+
+- REMOVE only if the attribute is clearly no longer used (variable deleted, conditional removed, no longer referenced)
+- KEEP marginal attributes—if unsure, preserve rather than remove
+- ADD new attributes freely when warranted
+
+## What Makes a Key Attribute
+
+A key attribute is a data path from "Attributes and Value Types" that dramatically changes how the component renders:
+
+- Controls a conditional that shows/hides significant UI sections
+- Changes the component's primary visual state (not just minor text differences)
+- Determines which branch of rendering logic executes
+
+NOT key attributes:
+- Values that only affect non-visible behavior (hrefs, image srcs)
+- Fallback values that won't be used if primary values exist
+- Values that would cause errors if changed
+
+Note: A conditional that shows a different UI state (e.g., loading screen, redirect message) IS significant—include it. Only exclude guard clauses that render literally nothing.
+
+## Path Format
+
+Only return attributes from the "Attributes and Value Types" list—these are the only values we can control. Use the exact path provided. Use \`functionCallReturnValue\` for function return values. Use \`[]\` for array items (e.g., \`items[]\`).
+
+## Response Format
+
+For \`validValueOptions\`, include boundary/extreme values that trigger different behavior—but NOT values that would cause errors.
+
+\`\`\`json
+{
+  "addedKeyAttributes": [
+    {
+      "path": "user",
+      "description": "Controls whether the main form or redirect screen displays",
+      "validValueOptions": ["truthy user object", "null/undefined"]
+    }
+  ],
+  "removedKeyAttributes": ["oldAttribute.path"]
+}
+\`\`\`
+
+Return empty arrays if no changes needed.
+`;
+const BACKEND_SYSTEM_MESSAGE = `You are updating the key attributes for a backend function that was recently changed.
+
+This is an INCREMENTAL update. Existing key attributes should be preserved unless the code change clearly invalidates them. Removing and re-adding attributes across changes causes unnecessary churn.
+
+## Stability Rules
+
+- REMOVE only if the attribute is clearly no longer used (variable deleted, conditional removed, no longer referenced)
+- KEEP marginal attributes—if unsure, preserve rather than remove
+- ADD new attributes freely when warranted
+
+## What Makes a Key Attribute
+
+A key attribute is a data path from "Attributes and Value Types" that dramatically changes the function's behavior:
+
+- Controls a conditional that significantly alters execution flow or return value
+- Determines which branch of logic executes
+- For side-effect functions: changes how external systems are called (database, email, etc.)
+
+NOT key attributes:
+- Fallback values that won't be used if primary values exist
+- Values that would cause errors if changed
+- Guard clauses that return nothing/minimal data
+
+## Path Format
+
+Only return attributes from the "Attributes and Value Types" list—these are the only values we can control. Use the exact path provided. Use \`functionCallReturnValue\` for function return values. Use \`[]\` for array items (e.g., \`items[]\`).
+
+## Response Format
+
+For \`validValueOptions\`, include boundary/extreme values that trigger different behavior—but NOT values that would cause errors.
+
+\`\`\`json
+{
+  "addedKeyAttributes": [
+    {
+      "path": "config.enabled",
+      "description": "Controls whether the main processing logic runs",
+      "validValueOptions": ["true", "false"]
+    }
+  ],
+  "removedKeyAttributes": ["oldAttribute.path"]
+}
+\`\`\`
+
+Return empty arrays if no changes needed.
+`;
+//# sourceMappingURL=generateChangesEntityKeyAttributes.js.map

package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js.map

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

package/packages/ai/src/lib/generateChangesEntityScenarioData.js

@@ -0,0 +1,375 @@
+import completionCall from "./completionCall.js";
+import generateChangesEntityScenarioDataGenerator from "./promptGenerators/generateChangesEntityScenarioDataGenerator.js";
+import generateEntityScenarioDataGenerator from "./promptGenerators/generateEntityScenarioDataGenerator.js";
+import { generateIncompleteSystemMessage, generateSystemMessage, } from "./generateEntityScenarioData.js";
+import { saveLlmCall } from "../../../../packages/aws/dynamodb/index.js";
+import validateJson from "./validateJson.js";
+import checkAllAttributes from "./checkAllAttributes.js";
+import { awsLog } from "../../../../packages/utils/index.js";
+import { parseJsonSafe } from "../../../../packages/ai/index.js";
+const DEFAULT_SCENARIO_NAME = 'Default Scenario';
+async function generateChangesDataForScenario({ entity, structure, existingStructure, scenario, defaultScenarioData, existingScenario, analysisId, incompleteResponse, model, }) {
+    if (structure === existingStructure &&
+        scenario.metadata.keyAttributeInstructions ===
+            existingScenario.metadata.keyAttributeInstructions) {
+        console.log("CodeYam: No changes in scenario's structure or keyAttributeInstructions - returning existing scenario data", {
+            analysisId: scenario.analysisId,
+            scenarioId: scenario.id,
+            scenarioName: scenario.name,
+        });
+        return {
+            scenarioData: {
+                scenarioName: scenario.name,
+                scenarioDescription: scenario.description,
+                data: existingScenario.metadata.data,
+            },
+            llmCalls: [],
+        };
+    }
+    try {
+        let prompt = '';
+        if (existingScenario) {
+            prompt = generateChangesEntityScenarioDataGenerator(structure, scenario, existingScenario, defaultScenarioData, incompleteResponse);
+        }
+        else {
+            prompt = generateEntityScenarioDataGenerator(structure, scenario, defaultScenarioData, incompleteResponse);
+        }
+        prompt = prompt.replace(/\*functionResponse\*/g, `"*a function that returns*"`);
+        prompt = prompt.replace(/\*function\*/g, `"*a void function*"`);
+        const isDefault = scenario.name === DEFAULT_SCENARIO_NAME;
+        let systemMessage = '';
+        if (existingScenario) {
+            if (incompleteResponse) {
+                systemMessage = generateChangesIncompleteSystemMessage(scenario.name, isDefault);
+            }
+            else {
+                systemMessage = generateChangesSystemMessage(scenario.name, isDefault);
+            }
+        }
+        else {
+            if (incompleteResponse) {
+                systemMessage = generateIncompleteSystemMessage(scenario.name, isDefault);
+            }
+            else {
+                systemMessage = generateSystemMessage(scenario.name, isDefault);
+            }
+        }
+        const response = await completionCall({
+            type: existingScenario
+                ? 'generateChangesEntityScenarioData'
+                : 'generateEntityScenarioData',
+            systemMessage,
+            prompt,
+            model,
+        });
+        const llmCall = await saveLlmCall({
+            object_type: 'analysis',
+            object_id: analysisId,
+            propsJson: {
+                entity: { name: entity.name, filePath: entity.filePath },
+                structure,
+                existingStructure,
+                scenario,
+                defaultScenarioData,
+                existingScenario,
+                analysisId,
+                incompleteResponse,
+                model,
+            },
+            ...response.stats,
+        });
+        const { completion, finishReason } = response;
+        if (!completion) {
+            console.log('CodeYam Error: Example changes data generation failed: No response from AI');
+            return null;
+        }
+        const fullCompletion = incompleteResponse
+            ? `${incompleteResponse}${completion}`
+            : completion;
+        awsLog(`LLMCall ${llmCall ? llmCall.id : 'N/A'}: ${entity.filePath} ${entity.name} ${scenario.name} changes data completion :>> Finish reason:`, finishReason, fullCompletion);
+        if (finishReason === 'length') {
+            const fullResult = await generateChangesDataForScenario({
+                entity,
+                structure,
+                existingStructure,
+                scenario,
+                defaultScenarioData,
+                existingScenario,
+                analysisId,
+                incompleteResponse: fullCompletion,
+                model,
+            });
+            // return the improved result with our original llmCall prepended
+            fullResult.llmCalls.unshift({ name: scenario.name, id: llmCall.id });
+            return fullResult;
+        }
+        const validJson = validateJson(fullCompletion);
+        const { scenarioData: scenarioDataWithoutDescription } = parseJsonSafe(validJson);
+        const fullScenarioData = {
+            ...scenarioDataWithoutDescription,
+            scenarioDescription: scenario.description,
+        };
+        if (structure.arguments && !fullScenarioData.data.argumentsData) {
+            fullScenarioData.data.argumentsData = [];
+            for (let i = 0; i < structure.arguments.length; ++i) {
+                if (!fullScenarioData.data.argumentsData[i]) {
+                    fullScenarioData.data.argumentsData[i] = {};
+                }
+                for (const argKey of Object.keys(structure.arguments[i])) {
+                    const dataAsAny = fullScenarioData.data;
+                    fullScenarioData.data.argumentsData[i][argKey] = dataAsAny[argKey];
+                }
+            }
+        }
+        let argumentsData = fullScenarioData.data.argumentsData;
+        if (!Array.isArray(argumentsData)) {
+            argumentsData = [];
+        }
+        fullScenarioData.data.argumentsData = argumentsData.map((arg) => checkAllAttributes(arg));
+        if (structure.dataForMocks && !fullScenarioData.data.mockData) {
+            fullScenarioData.data.mockData = {};
+            for (const propKey of Object.keys(structure.arguments)) {
+                const dataAsAny = fullScenarioData.data;
+                fullScenarioData.data.mockData[propKey] = dataAsAny[propKey];
+            }
+        }
+        fullScenarioData.data.mockData = checkAllAttributes(fullScenarioData.data.mockData);
+        return {
+            llmCalls: [{ name: scenario.name, id: llmCall.id }],
+            scenarioData: fullScenarioData,
+        };
+    }
+    catch (error) {
+        console.log('CodeYam Error: Example changes data generation failed:', scenario, error);
+        throw error;
+    }
+}
+export default async function generateChangesEntityScenarioData({ entity, structure, existingStructure, scenarios, defaultScenario, existingScenarios, analysisId, model, }) {
+    const scenarioDatas = [];
+    const llmCalls = [];
+    const defaultScenarioResponse = await generateChangesDataForScenario({
+        entity,
+        structure,
+        existingStructure,
+        scenario: defaultScenario,
+        existingScenario: existingScenarios.find((existingScenario) => existingScenario.name === defaultScenario.name),
+        analysisId,
+        model,
+    });
+    const defaultScenarioData = defaultScenarioResponse.scenarioData;
+    scenarioDatas.push(defaultScenarioData);
+    llmCalls.push(...defaultScenarioResponse.llmCalls);
+    const scenariosOtherThanDefault = scenarios.filter((scenario) => scenario.name !== DEFAULT_SCENARIO_NAME);
+    const resolutions = await Promise.all(scenariosOtherThanDefault.map(async (scenario) => await generateChangesDataForScenario({
+        entity,
+        structure,
+        existingStructure,
+        scenario,
+        defaultScenarioData,
+        existingScenario: existingScenarios.find((existingScenario) => existingScenario.name === scenario.name),
+        analysisId,
+        incompleteResponse: null,
+        model,
+    })));
+    for (const resolution of resolutions) {
+        scenarioDatas.push(resolution.scenarioData);
+        llmCalls.push(...resolution.llmCalls);
+    }
+    awsLog('CodeYam: scenarioDatas :>> ', JSON.stringify({
+        filePath: entity.filePath,
+        entityName: entity.name,
+        scenarioDatas,
+    }, null, 2));
+    return { scenarioDatas, llmCalls };
+}
+const generateChangesSystemMessage = (scenarioName, isDefault) => `## Overview
+- You will be provided with a structure for scenario data, the "mockData structure", and for the arguments of the function, the "argumentsData structure", and a scenario describing a new state of data for this function.
+
+- Your goal is to modify the existing data, if necssary, to satisfy the current scenario "keyAttributeInstructions" and the data structures.
+
+## Provided Information
+
+- The "mockData structure" and "argumentsData structure" describe all of the data required for the simulation to work. ${isDefault ? 'Generate valid data for every object, attribute, and nested attribute described in the data structure' : 'Ensure between the default data and the data for this scenario all attributes are appropriately filled in unless they are intentionally not defined'}. 
+
+- The "Scenario" provides instruction on how to generate the data for this scenario. 
+
+${isDefault
+    ? ''
+    : `- The "Default Scenario" provides the default scenario data. The data for this scenario will be merged into the ${DEFAULT_SCENARIO_NAME} data to produce the full data.
+`}
+- The "Existing Scenario" provides the data for this scenario prior to the code change. This data should be maintained as much as possible. It should only be edited to satisfy the requirements for this scenario.
+
+## Instructions
+${isDefault
+    ? `
+- As the ${DEFAULT_SCENARIO_NAME} please ensure all data is filled in to meet the needs of the current code.
+
+- The one exception to this is error data. Sometimes the data structure will contain structures for both success and error data. In this case you should only fill in the success data and leave out the error data completely.
+
+- Always use realistic data, filling in all arrays, attributes, and sub-attributes (except for error data), creating a high quality default scenario.
+`
+    : `
+- If the code change and new "keyAttributeInstructions" dictate changes to the "Existing Scenario" then make those changes, returning the complete data that will be merged into the "Default Scenario" data. There is no need to duplicate any of the "Default Scenario" data.
+
+- If you need to remove data from the ${DEFAULT_SCENARIO_NAME} data then you can set any attribute to null, which will remove it during the merge process.`}
+- If the type is described as "any" then create a realistic example of that type based on its name. If the type is "date" or "timestamp" then use the instructione below to generate a dynamic date or timestamp. If the type is "*a void function*" then provide a void function per the instructions below. If the key value is "*a function that returns*" then provide a function that returns a value as described by the "*a function that returns*".
+
+- If the data in the "Existing Scenario" is sufficient then return the following:
+
+\`\`\`
+{
+  "scenarioData": {
+    "scenarioName: "${scenarioName}",
+    "data": {}
+  }
+}
+\`\`\`
+
+## Example Response
+
+{
+  "scenarioData": {
+    "scenarioName": "${scenarioName}",
+    "data': {
+      "mockData": {
+        "user": {
+          "name": "John Doe",
+          "metadata": {
+            "hobbies": ["fishing", "hiking", "camping"]
+            "favoriteColor": "blue",
+          },
+          "joinedAt": {
+            "~~codeyam-code~~": "new Date(Date.now() - 3 * 24 * 60 * 60 * 1000)"         
+          },
+          "loadRank: {
+            "~~codeyam-code~~": "() => { console.log('loadRank called'); return { rank: 5 } }" 
+          }
+        },
+        "project": {
+          "name": "New Project",
+          "slug": "new-project",
+          "files": [
+            {
+              "name": "File 1",
+              "slug": "file-1",
+              "content": "This is the content of file 1"
+            },
+            {
+              "name": "File 2",
+              "slug": "file-2",
+              "content": "This is the content of file 2"
+            },
+            {
+              "name": "File 3",
+              "slug": "file-3",
+              "content": "This is the content of file 3"
+            }
+          ]
+        }
+      },
+      "argumentsData": [
+        {
+          "open": "true",
+          "onClick": {
+            "~~codeyam-code~~": "() => console.log('clicked')"
+          },
+          "children: "Click Me!"        
+        }      
+      ]        
+    }
+  }
+}
+
+## scenarioData
+
+You will return a JSON object called scenarioData containing the name and data for this scenario.
+
+If you encounter a "date" then you should use "~~codeyam-code~~" along with code in string format. That string will be evaled to create the date or timestamp needed.
+
+For example the "timestamp" above should probably not be a hard-coded timestamp but should be a function that returns a timestamp. If you want to return a timestamp that is 24 hours in the future, you would return this object:
+
+\`\`\`
+{
+  "scenarioData": {
+    "scenarioName": ${scenarioName},
+    "data": {
+      "mockData": {
+        "dataLoaders": {
+          "fetchUser()": {
+            "user": {
+              "name": "John Doe",
+              "metadata": {
+                "hobbies": ["fishing", "hiking", "camping"],
+                "favoriteColor": "blue"
+              },
+              "joinedAt": {
+                "~~codeyam-code~~": "new Date(Date.now() - 3 * 24 * 60 * 60 * 1000).toISOString()"
+              }  
+            }
+          }
+        }
+      }
+    }
+  }
+}
+\`\`\`
+
+Keep in mind the above pattern is also valid for argumentsData.
+
+All code should be written in JavaScript. It will run in a node environment (not the browser) with no reference to external libraries. It will essentially be run in a sandboxed environment. Do not reference any external libraries in the code.
+
+With argumentsData you may also need to return a "children" argument. "children" can either be a string or a jsx element.
+
+If you want to return a jsx element you would return something like this:
+
+\`\`\`
+{
+  "scenarioData": {
+    "scenarioName": ${scenarioName},
+    "data": {
+      "argumentsData": [
+        {
+          "children": {
+            "~~codeyam-jsx~~": "<div>Click Me!</div>"
+          }
+        }
+      ]
+    }
+  }
+}
+\`\`\`
+
+The "~~codeyam-jsx~~" key in a "children" prop will be rendered directly to the code as a jsx element, not a string. Only return basic elements like "<div>".
+
+Do not import or reference any libraries in this code. No external libraries will be imported.
+
+If either mockData or argumentsData is empty you can return an empty object for mockData ("{}") or empty array for argumentsData ("[]"). 
+
+If an object inside of mockData or argumentsData is intended to not exist you can set it to null.
+
+Never use "~~codeyam-code~~" or "~~codeyam-jsx~~" as a partial key in the response. Even if the key looks like it should have a relative date or code. "~~codeyam-code~~" and "~~codeyam-jsx~~" are only used as independent keys used to mark values that are code.
+
+## Common Mistakes
+
+- Do not use the term undefined in the response. If something is missing leave it out or use null.
+- Leave out error data (e.g. a data attribute labeled as "error"), especially when it is in a data structure that has success data as well. Only include the success data and simply leave out the error data. Error data is usually labeled as "error" in the structure. Leave it out entirely.
+- Do not reference data in the response (e.g. if there was a "posts" field you can not say "posts[0]" elsewhere in the response - you need to duplicate the data). Unfortunately all data must be written out directly in the response.
+- Ensure each scenario in the response matches the full scenario name, commas and all, in the scenarios provided.
+- Do not throw errors from this data in any manner. Simple leave out any error data.
+- If the data structure contains a type that is a "date" then use ~~codeyam-code~~ to generate a dynamic timestamp or date. Do not hard-code dates unless it needs to be a very specific date. Otherwise it should be a relative, dynamic date.
+- The response must be valid JSON. Do not include raw code in the response.
+`;
+const generateChangesIncompleteSystemMessage = (scenarioName, isDefault) => `Your previous response provided us with an incomplete json object.
+
+Can you help us complete it? 
+
+The previous response got cut off because it was too long so to complete the response you'll need to pick up where you left off providing just the necessary text to make the full response a valid json object.
+
+We'll combine the initial response with your response this time to form the full json object.
+
+Here is the initial system message:
+
+${generateChangesSystemMessage(scenarioName, isDefault)}
+\`\`\`
+`;
+//# sourceMappingURL=generateChangesEntityScenarioData.js.map

package/packages/ai/src/lib/generateChangesEntityScenarioData.js.map

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