@codeyam/codeyam-cli 0.1.0-staging.ad31e3e → 0.1.0-staging.ad44cd3

package/codeyam-cli/templates/debug-command.md

@@ -1,125 +0,0 @@
-# Debug Scenario or Analysis
-
-When a user asks to debug a scenario or analysis (e.g., `/debug [ID]`), use this systematic process. The `codeyam debug` command auto-detects whether you've provided a scenario ID or analysis ID.
-
-## Step 1: Run Debug Command
-
-Set up the debug environment with the ID provided:
-
-```bash
-cd ../PROJECT_NAME
-codeyam debug ID
-```
-
-The command auto-detects whether the ID is a scenario or analysis.
-
-The output includes:
-
-1. **Project path**: `/tmp/codeyam/local-dev/{slug}/project`
-2. **Start command**: The exact `cd ... && pnpm dev` command to run
-3. **URL**: `http://localhost:3112/static/codeyam-sample`
-4. **Log path**: Where to watch for errors
-
----
-
-## Step 2: Manual Debugging in /tmp
-
-Work directly in the Tmp Project at `/tmp/codeyam/local-dev/{slug}/project`.
-
-### 2.1 Start the development server
-
-Copy the start command from the debug output and run it:
-
-```bash
-cd /tmp/codeyam/local-dev/{slug}/project && pnpm dev
-# Or the framework-specific command shown in the debug output
-```
-
-### 2.2 Verify the page loads with curl
-
-**CRITICAL: Server starting is NOT sufficient verification.**
-
-```bash
-curl -s http://localhost:3112/static/codeyam-sample | head -50
-```
-
-**What to look for:**
-
-- **Success**: HTML with `<div>` elements, no error messages
-- **Failure**: Look for `"statusCode":500` or `"err":` in the JSON
-
-### 2.3 Verification checklist
-
-Before declaring "it works", confirm ALL of these:
-
-- [ ] Server process started without crashing
-- [ ] `curl` returns clean HTML (no `statusCode:500` or error messages)
-- [ ] Browser shows the component rendering (not blank/error)
-- [ ] No errors in browser console (DevTools > Console)
-
-**If ANY of these fail, the bug is NOT fixed. Keep iterating.**
-
-### 2.4 Identify and fix the issue
-
-Common failure points:
-
-1. **Server fails to start**: JSON parse errors, missing dependencies, port in use
-2. **Page fails to compile**: Missing exports in mock files, import resolution failures
-3. **Page loads but component doesn't render**: ReferenceError, missing mock data
-
-**Fix the issue directly in the Tmp Project files.** Iterate until all verification checks pass.
-
----
-
-## Step 3: Document the Fix
-
-Once verified (all checklist items pass):
-
-1. **What file(s) did you edit?**
-2. **What was the change?**
-3. **Why was the original code wrong?**
-
-Categorize the fix:
-
-- **Mock content issue**: The generated mock had wrong exports or missing values
-- **Scenario file issue**: The scenario component file had incorrect structure
-- **Import rewriting issue**: An import was incorrectly rewritten or not rewritten
-- **Package.json corruption**: JSON files were incorrectly modified
-- **Missing dependency**: A required package wasn't installed
-
----
-
-## Step 4: Create a Failing Test (in CodeYam Repo)
-
-Write a test that fails without the fix:
-
-| Bug type                 | Test location                                                                      |
-| ------------------------ | ---------------------------------------------------------------------------------- |
-| Scenario file generation | `background/src/lib/virtualized/project/__tests__/writeScenarioComponents.test.ts` |
-| Universal mocks          | `background/src/lib/virtualized/project/__tests__/writeUniversalMocks.test.ts`     |
-| Mock generation          | `background/src/lib/virtualized/project/__tests__/constructMockCode.test.ts`       |
-| Entity analysis          | `packages/analyze/src/lib/files/__tests__/*.test.ts`                               |
-| Scope analysis           | `packages/ai/src/lib/astScopes/__tests__/*.test.ts`                                |
-
----
-
-## Step 5: Implement the Fix
-
-1. Edit the source file in the CodeYam Repo
-2. Run the test to confirm it passes
-3. Rebuild the CLI: `pnpm cli`
-4. Clear the cached project: `rm -rf /tmp/codeyam/local-dev/{slug}/project`
-5. Re-run debug: `codeyam debug ID`
-6. **Run the full verification checklist** - server starts, page loads, component renders
-
----
-
-## Key Source Files
-
-| Purpose               | File                                                                |
-| --------------------- | ------------------------------------------------------------------- |
-| Universal mocks       | `background/src/lib/virtualized/project/writeUniversalMocks.ts`     |
-| Scenario file writing | `background/src/lib/virtualized/project/writeScenarioComponents.ts` |
-| Mock code generation  | `background/src/lib/virtualized/project/constructMockCode.ts`       |
-| Entity analysis       | `packages/analyze/src/lib/files/analyzeEntity.ts`                   |
-| Data structure        | `packages/ai/src/lib/generateEntityDataStructure.ts`                |

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

@@ -1,77 +0,0 @@
-import { normalizeKey } from "../../../../packages/utils/index.js";
-import { joinParenthesesAndArrays, splitOutsideParenthesesAndArrays, } from "./splitOutsideParentheses.js";
-function findEquivalent(path, equivalents) {
-    const pathParts = splitOutsideParenthesesAndArrays(path);
-    for (const equivalentKey in equivalents) {
-        const equivalentKeyParts = splitOutsideParenthesesAndArrays(equivalentKey);
-        if (equivalentKeyParts.some((part) => part.startsWith('signature['))) {
-            continue;
-        }
-        const relevantKey = joinParenthesesAndArrays(pathParts.slice(0, equivalentKeyParts.length));
-        if (equivalentKey === relevantKey) {
-            const equivalentValue = equivalents[equivalentKey];
-            return joinParenthesesAndArrays([
-                equivalentValue,
-                ...pathParts.slice(equivalentKeyParts.length),
-            ]);
-        }
-    }
-}
-function findReverseEquivalent(path, equivalents) {
-    const pathParts = splitOutsideParenthesesAndArrays(path);
-    for (const [equivalentKey, equivalentValue] of Object.entries(equivalents)) {
-        const equivalentKeyParts = splitOutsideParenthesesAndArrays(equivalentKey);
-        if (equivalentKeyParts.some((part) => part.startsWith('signature['))) {
-            continue;
-        }
-        const equivalentValueParts = splitOutsideParenthesesAndArrays(equivalentValue);
-        const relevantKey = joinParenthesesAndArrays(pathParts.slice(0, equivalentValueParts.length));
-        if (equivalentValue === relevantKey) {
-            return joinParenthesesAndArrays([
-                equivalentKey,
-                ...pathParts.slice(equivalentValueParts.length),
-            ]);
-        }
-    }
-}
-export default function findMatchingAttribute(attributePath, attributesList, equivalents) {
-    // console.log("CODEYAM DEBUG: findMatchingAttribute called with", JSON.stringify({
-    //   attributePath,
-    //   attributesList,
-    //   equivalents,
-    // }, null, 2));
-    const equivalent = findEquivalent(attributePath, equivalents);
-    const reverseEquivalent = findReverseEquivalent(attributePath, equivalents);
-    if (attributesList.includes(attributePath)) {
-        if (reverseEquivalent) {
-            return reverseEquivalent;
-        }
-        return attributePath;
-    }
-    else if (equivalent && attributesList.includes(equivalent)) {
-        return equivalent;
-    }
-    else {
-        const normalizedPath = normalizeKey(attributePath);
-        const matchingAttribute = attributesList.find((attr) => normalizeKey(attr) === normalizedPath);
-        // If no exact match find the attribute that matches the most characters starting from the beginning
-        if (!matchingAttribute) {
-            const options = attributesList;
-            const normalizedPathCharacters = normalizedPath.split('');
-            for (const attr of options) {
-                const attrCharacters = normalizeKey(attr).split('');
-                const matchLength = normalizedPathCharacters.findIndex((char, index) => char !== attrCharacters[index]);
-                if (matchLength !== -1) {
-                    const matchedPrefix = normalizedPathCharacters.slice(0, matchLength);
-                    if (matchedPrefix.length > 0) {
-                        return attr;
-                    }
-                }
-            }
-        }
-        if (matchingAttribute)
-            return matchingAttribute;
-        return null;
-    }
-}
-//# sourceMappingURL=findMatchingAttribute.js.map

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

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

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

@@ -1,134 +0,0 @@
-import { joinParenthesesAndArrays, splitOutsideParenthesesAndArrays, } from "./splitOutsideParentheses.js";
-import { gatherAttributesMap } from "./promptGenerators/gatherAttributesMap.js";
-export default function gatherRelevantDependentKeyAttributes(entity, dependentAnalyses) {
-    // console.info(
-    //   'CODEYAM DEBUG: gatherRelevantDependentKeyAttributes inputs',
-    //   entity.name,
-    //   JSON.stringify(
-    //     {
-    //       entity: {
-    //         metadata: {
-    //           isolatedDataStructure:
-    //             entity.metadata?.isolatedDataStructure,
-    //         },
-    //       },
-    //       dependentAnalyses: Object.keys(dependentAnalyses).reduce(
-    //         (acc, path) => {
-    //           acc[path] = Object.keys(dependentAnalyses[path]).reduce(
-    //             (entityAcc, entityName) => {
-    //               entityAcc[entityName] = {
-    //                 metadata: {
-    //                   keyAttributes:
-    //                     dependentAnalyses[path][entityName].metadata
-    //                       .keyAttributes,
-    //                 },
-    //                 entity: {
-    //                   metadata: {
-    //                     isolatedDataStructure:
-    //                       dependentAnalyses[path][entityName].entity.metadata
-    //                         ?.isolatedDataStructure,
-    //                   },
-    //                 },
-    //               };
-    //               return entityAcc;
-    //             },
-    //             {},
-    //           );
-    //           return acc;
-    //         },
-    //         {} as Record<string, Record<string, Record<string, unknown>[]>>,
-    //       ),
-    //     },
-    //     null,
-    //     2,
-    //   ),
-    // );
-    const { associationMap } = gatherAttributesMap(entity);
-    const dependencySchemas = entity.metadata?.isolatedDataStructure?.dependencySchemas;
-    const relevantDependentKeyAttributes = [];
-    Object.keys(dependentAnalyses).forEach((path) => {
-        Object.keys(dependentAnalyses[path]).forEach((entityName) => {
-            const dependentAnalysis = dependentAnalyses[path][entityName];
-            const dependentKeyAtttributes = dependentAnalysis?.metadata?.keyAttributes;
-            if (!dependentKeyAtttributes || dependentKeyAtttributes.length === 0)
-                return;
-            const dependencySchema = dependencySchemas?.[path]?.[entityName];
-            const signatureSchema = dependencySchema?.signatureSchema;
-            if (!signatureSchema)
-                return;
-            const sourceEquivalencies = dependencySchema?.sourceEquivalencies ?? {};
-            // If sourceEquivalencies is empty but the child has mocked imports,
-            // propagate key attributes directly since they affect the parent's visual output
-            if (Object.keys(sourceEquivalencies).length === 0) {
-                // Check both importedExports and nodeModuleImports for mocked imports
-                const importedExports = dependentAnalysis.entity?.metadata?.importedExports ?? [];
-                const nodeModuleImports = dependentAnalysis.entity?.metadata?.nodeModuleImports ?? {};
-                const hasMockedImportedExports = importedExports.some((imp) => imp.isMocked);
-                const hasMockedNodeModuleImports = Object.values(nodeModuleImports).some((imports) => imports?.some((imp) => imp.isMocked));
-                const childHasMockedImports = hasMockedImportedExports || hasMockedNodeModuleImports;
-                if (childHasMockedImports) {
-                    for (const dependentKeyAttribute of dependentKeyAtttributes) {
-                        relevantDependentKeyAttributes.push({
-                            ...dependentKeyAttribute,
-                            dependentEntityName: entityName,
-                            originalEntityName: entityName,
-                            filePath: path,
-                        });
-                    }
-                }
-                return;
-            }
-            for (const dependentKeyAttribute of dependentKeyAtttributes) {
-                const dependentKeyAttributeExternalPathParts = splitOutsideParenthesesAndArrays(dependentKeyAttribute.externalPath);
-                let matchFound = false;
-                for (let i = dependentKeyAttributeExternalPathParts.length; i > 0; i--) {
-                    const subExternalPath = joinParenthesesAndArrays(dependentKeyAttributeExternalPathParts.slice(0, i));
-                    for (const sourceEquivalencyPath in dependencySchema?.sourceEquivalencies ??
-                        {}) {
-                        const sourceEquivalencyPathParts = splitOutsideParenthesesAndArrays(sourceEquivalencyPath);
-                        const relevantSourceEquivalencyPath = joinParenthesesAndArrays(sourceEquivalencyPathParts.slice(1));
-                        if (relevantSourceEquivalencyPath !== subExternalPath)
-                            continue;
-                        const sourcePath = dependencySchema?.sourceEquivalencies[sourceEquivalencyPath][0]
-                            ?.schemaPath;
-                        if (!sourcePath)
-                            continue;
-                        let externalPath = sourcePath;
-                        let internalPath = associationMap[sourcePath];
-                        if (i < dependentKeyAttributeExternalPathParts.length) {
-                            externalPath = joinParenthesesAndArrays([
-                                externalPath,
-                                ...dependentKeyAttributeExternalPathParts.slice(i),
-                            ]);
-                            // Only build internalPath if we have a valid base path from associationMap
-                            // Otherwise leave it undefined to avoid paths like "undefined.foo.bar"
-                            if (internalPath !== undefined) {
-                                internalPath = joinParenthesesAndArrays([
-                                    internalPath,
-                                    ...dependentKeyAttributeExternalPathParts.slice(i),
-                                ]);
-                            }
-                        }
-                        const dependentEntityName = dependentKeyAttribute.dependentEntityName
-                            ? `${dependentKeyAttribute.dependentEntityName} (through ${entityName})`
-                            : entityName;
-                        relevantDependentKeyAttributes.push({
-                            ...dependentKeyAttribute,
-                            dependentEntityName,
-                            originalEntityName: entityName, // Original entity name without "(through X)"
-                            filePath: path, // File path for restructuring into nested format
-                            internalPath,
-                            externalPath,
-                        });
-                        matchFound = true;
-                        break;
-                    }
-                    if (matchFound)
-                        break;
-                }
-            }
-        });
-    });
-    return relevantDependentKeyAttributes;
-}
-//# sourceMappingURL=gatherRelevantDependentKeyAttributes.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"gatherRelevantDependentKeyAttributes.js","sourceRoot":"","sources":["../../../../../../packages/ai/src/lib/gatherRelevantDependentKeyAttributes.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAE7E,MAAM,CAAC,OAAO,UAAU,oCAAoC,CAC1D,MAAyC,EACzC,iBAAsC;IAEtC,gBAAgB;IAChB,kEAAkE;IAClE,iBAAiB;IACjB,oBAAoB;IACpB,QAAQ;IACR,kBAAkB;IAClB,sBAAsB;IACtB,mCAAmC;IACnC,sDAAsD;IACtD,aAAa;IACb,WAAW;IACX,kEAAkE;IAClE,2BAA2B;IAC3B,qEAAqE;IACrE,2CAA2C;IAC3C,0CAA0C;IAC1C,8BAA8B;IAC9B,mCAAmC;IACnC,mEAAmE;IACnE,wCAAwC;IACxC,qBAAqB;IACrB,4BAA4B;IAC5B,gCAAgC;IAChC,6CAA6C;IAC7C,4EAA4E;IAC5E,mDAAmD;IACnD,uBAAuB;IACvB,qBAAqB;IACrB,mBAAmB;IACnB,kCAAkC;IAClC,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,wBAAwB;IACxB,aAAa;IACb,2EAA2E;IAC3E,WAAW;IACX,SAAS;IACT,YAAY;IACZ,SAAS;IACT,OAAO;IACP,KAAK;IAEL,MAAM,EAAE,cAAc,EAAE,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAEvD,MAAM,iBAAiB,GACrB,MAAM,CAAC,QAAQ,EAAE,qBAAqB,EAAE,iBAAiB,CAAC;IAC5D,MAAM,8BAA8B,GAClC,EAAE,CAAC;IACL,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9C,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAC1D,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;YAC9D,MAAM,uBAAuB,GAC3B,iBAAiB,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC7C,IAAI,CAAC,uBAAuB,IAAI,uBAAuB,CAAC,MAAM,KAAK,CAAC;gBAClE,OAAO;YAET,MAAM,gBAAgB,GAAG,iBAAiB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;YACjE,MAAM,eAAe,GAAG,gBAAgB,EAAE,eAAe,CAAC;YAC1D,IAAI,CAAC,eAAe;gBAAE,OAAO;YAE7B,MAAM,mBAAmB,GAAG,gBAAgB,EAAE,mBAAmB,IAAI,EAAE,CAAC;YAExE,oEAAoE;YACpE,iFAAiF;YACjF,IAAI,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClD,sEAAsE;gBACtE,MAAM,eAAe,GACnB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,IAAI,EAAE,CAAC;gBAC5D,MAAM,iBAAiB,GACrB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,IAAI,EAAE,CAAC;gBAE9D,MAAM,wBAAwB,GAAG,eAAe,CAAC,IAAI,CACnD,CAAC,GAA2B,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAC9C,CAAC;gBACF,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAC9C,iBAAiB,CAClB,CAAC,IAAI,CAAC,CAAC,OAAc,EAAE,EAAE,CACxB,OAAO,EAAE,IAAI,CAAC,CAAC,GAA2B,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAC7D,CAAC;gBAEF,MAAM,qBAAqB,GACzB,wBAAwB,IAAI,0BAA0B,CAAC;gBAEzD,IAAI,qBAAqB,EAAE,CAAC;oBAC1B,KAAK,MAAM,qBAAqB,IAAI,uBAAuB,EAAE,CAAC;wBAC5D,8BAA8B,CAAC,IAAI,CAAC;4BAClC,GAAG,qBAAqB;4BACxB,mBAAmB,EAAE,UAAU;4BAC/B,kBAAkB,EAAE,UAAU;4BAC9B,QAAQ,EAAE,IAAI;yBACR,CAAC,CAAC;oBACZ,CAAC;gBACH,CAAC;gBACD,OAAO;YACT,CAAC;YAED,KAAK,MAAM,qBAAqB,IAAI,uBAAuB,EAAE,CAAC;gBAC5D,MAAM,sCAAsC,GAC1C,gCAAgC,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;gBAEvE,IAAI,UAAU,GAAG,KAAK,CAAC;gBACvB,KACE,IAAI,CAAC,GAAG,sCAAsC,CAAC,MAAM,EACrD,CAAC,GAAG,CAAC,EACL,CAAC,EAAE,EACH,CAAC;oBACD,MAAM,eAAe,GAAG,wBAAwB,CAC9C,sCAAsC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CACnD,CAAC;oBAEF,KAAK,MAAM,qBAAqB,IAAI,gBAAgB,EAAE,mBAAmB;wBACvE,EAAE,EAAE,CAAC;wBACL,MAAM,0BAA0B,GAAG,gCAAgC,CACjE,qBAAqB,CACtB,CAAC;wBAEF,MAAM,6BAA6B,GAAG,wBAAwB,CAC5D,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC,CACpC,CAAC;wBAEF,IAAI,6BAA6B,KAAK,eAAe;4BAAE,SAAS;wBAEhE,MAAM,UAAU,GACd,gBAAgB,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;4BAC7D,EAAE,UAAU,CAAC;wBAEjB,IAAI,CAAC,UAAU;4BAAE,SAAS;wBAE1B,IAAI,YAAY,GAAG,UAAU,CAAC;wBAC9B,IAAI,YAAY,GAAuB,cAAc,CAAC,UAAU,CAAC,CAAC;wBAElE,IAAI,CAAC,GAAG,sCAAsC,CAAC,MAAM,EAAE,CAAC;4BACtD,YAAY,GAAG,wBAAwB,CAAC;gCACtC,YAAY;gCACZ,GAAG,sCAAsC,CAAC,KAAK,CAAC,CAAC,CAAC;6BACnD,CAAC,CAAC;4BAEH,2EAA2E;4BAC3E,uEAAuE;4BACvE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gCAC/B,YAAY,GAAG,wBAAwB,CAAC;oCACtC,YAAY;oCACZ,GAAG,sCAAsC,CAAC,KAAK,CAAC,CAAC,CAAC;iCACnD,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;wBAED,MAAM,mBAAmB,GACvB,qBAAqB,CAAC,mBAAmB;4BACvC,CAAC,CAAC,GAAG,qBAAqB,CAAC,mBAAmB,aAAa,UAAU,GAAG;4BACxE,CAAC,CAAC,UAAU,CAAC;wBAEjB,8BAA8B,CAAC,IAAI,CAAC;4BAClC,GAAG,qBAAqB;4BACxB,mBAAmB;4BACnB,kBAAkB,EAAE,UAAU,EAAE,6CAA6C;4BAC7E,QAAQ,EAAE,IAAI,EAAE,iDAAiD;4BACjE,YAAY;4BACZ,YAAY;yBACN,CAAC,CAAC;wBAEV,UAAU,GAAG,IAAI,CAAC;wBAClB,MAAM;oBACR,CAAC;oBAED,IAAI,UAAU;wBAAE,MAAM;gBACxB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,8BAA8B,CAAC;AACxC,CAAC"}

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

@@ -1,190 +0,0 @@
-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

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