@codeyam/codeyam-cli 0.1.0-staging.76566f9 → 0.1.0-staging.790201e

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (959) hide show
  1. package/analyzer-template/.build-info.json +8 -8
  2. package/analyzer-template/common/execAsync.ts +1 -1
  3. package/analyzer-template/log.txt +3 -3
  4. package/analyzer-template/package.json +24 -21
  5. package/analyzer-template/packages/ai/index.ts +21 -5
  6. package/analyzer-template/packages/ai/package.json +3 -3
  7. package/analyzer-template/packages/ai/src/lib/__mocks__/completionCall.ts +122 -0
  8. package/analyzer-template/packages/ai/src/lib/analyzeScope.ts +226 -24
  9. package/analyzer-template/packages/ai/src/lib/astScopes/arrayDerivationDetector.ts +199 -0
  10. package/analyzer-template/packages/ai/src/lib/astScopes/astScopeAnalyzer.ts +183 -10
  11. package/analyzer-template/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.ts +644 -0
  12. package/analyzer-template/packages/ai/src/lib/astScopes/methodSemantics.ts +181 -23
  13. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.ts +10 -17
  14. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.ts +18 -0
  15. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.ts +15 -0
  16. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.ts +181 -1
  17. package/analyzer-template/packages/ai/src/lib/astScopes/processExpression.ts +1229 -30
  18. package/analyzer-template/packages/ai/src/lib/astScopes/sharedPatterns.ts +28 -0
  19. package/analyzer-template/packages/ai/src/lib/astScopes/types.ts +265 -6
  20. package/analyzer-template/packages/ai/src/lib/checkAllAttributes.ts +29 -10
  21. package/analyzer-template/packages/ai/src/lib/completionCall.ts +216 -36
  22. package/analyzer-template/packages/ai/src/lib/dataStructure/ScopeDataStructure.ts +2000 -341
  23. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.ts +5 -1
  24. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.ts +296 -35
  25. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.ts +10 -2
  26. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.ts +16 -3
  27. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.ts +6 -4
  28. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.ts +54 -3
  29. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.ts +129 -20
  30. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.ts +70 -0
  31. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.ts +140 -14
  32. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.ts +179 -0
  33. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.ts +40 -30
  34. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.ts +393 -90
  35. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.ts +129 -0
  36. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/stripNullableMarkers.ts +35 -0
  37. package/analyzer-template/packages/ai/src/lib/dataStructureChunking.ts +183 -0
  38. package/analyzer-template/packages/ai/src/lib/deepEqual.ts +30 -0
  39. package/analyzer-template/packages/ai/src/lib/e2eDataTracking.ts +334 -0
  40. package/analyzer-template/packages/ai/src/lib/extractCriticalDataKeys.ts +120 -0
  41. package/analyzer-template/packages/ai/src/lib/generateChangesEntityScenarioData.ts +33 -7
  42. package/analyzer-template/packages/ai/src/lib/generateChangesEntityScenarios.ts +86 -142
  43. package/analyzer-template/packages/ai/src/lib/generateEntityDataStructure.ts +59 -3
  44. package/analyzer-template/packages/ai/src/lib/generateEntityScenarioData.ts +1385 -67
  45. package/analyzer-template/packages/ai/src/lib/generateEntityScenarios.ts +200 -196
  46. package/analyzer-template/packages/ai/src/lib/generateExecutionFlows.ts +710 -0
  47. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.ts +528 -0
  48. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromConditionals.ts +2484 -0
  49. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.ts +239 -0
  50. package/analyzer-template/packages/ai/src/lib/guessScenarioDataFromDescription.ts +5 -5
  51. package/analyzer-template/packages/ai/src/lib/isolateScopes.ts +328 -7
  52. package/analyzer-template/packages/ai/src/lib/mergeJsonTypeDefinitions.ts +5 -0
  53. package/analyzer-template/packages/ai/src/lib/mergeStatements.ts +111 -87
  54. package/analyzer-template/packages/ai/src/lib/promptGenerators/collapseNullableObjects.ts +118 -0
  55. package/analyzer-template/packages/ai/src/lib/promptGenerators/gatherAttributesMap.ts +10 -7
  56. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.ts +1 -1
  57. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.ts +32 -142
  58. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChunkPrompt.ts +82 -0
  59. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateCriticalKeysPrompt.ts +103 -0
  60. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.ts +110 -6
  61. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.ts +14 -89
  62. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.ts +58 -0
  63. package/analyzer-template/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.ts +11 -11
  64. package/analyzer-template/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.ts +391 -0
  65. package/analyzer-template/packages/ai/src/lib/resolvePathToControllable.ts +824 -0
  66. package/analyzer-template/packages/ai/src/lib/splitOutsideParentheses.ts +5 -1
  67. package/analyzer-template/packages/ai/src/lib/validateExecutionFlowPaths.ts +531 -0
  68. package/analyzer-template/packages/ai/src/lib/worker/SerializableDataStructure.ts +122 -3
  69. package/analyzer-template/packages/ai/src/lib/worker/analyzeScopeWorker.ts +114 -2
  70. package/analyzer-template/packages/analyze/index.ts +2 -0
  71. package/analyzer-template/packages/analyze/src/lib/FileAnalyzer.ts +79 -59
  72. package/analyzer-template/packages/analyze/src/lib/ProjectAnalyzer.ts +113 -26
  73. package/analyzer-template/packages/analyze/src/lib/analysisContext.ts +44 -4
  74. package/analyzer-template/packages/analyze/src/lib/asts/nodes/getNodeType.ts +1 -0
  75. package/analyzer-template/packages/analyze/src/lib/asts/nodes/index.ts +1 -0
  76. package/analyzer-template/packages/analyze/src/lib/asts/nodes/isAsyncFunction.ts +67 -0
  77. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.ts +19 -0
  78. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.ts +19 -0
  79. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllExports.ts +11 -0
  80. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.ts +8 -0
  81. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.ts +49 -1
  82. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.ts +2 -1
  83. package/analyzer-template/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.ts +467 -283
  84. package/analyzer-template/packages/analyze/src/lib/files/analyze/analyzeEntities.ts +34 -1
  85. package/analyzer-template/packages/analyze/src/lib/files/analyze/dependencyResolver.ts +6 -0
  86. package/analyzer-template/packages/analyze/src/lib/files/analyze/findOrCreateEntity.ts +3 -0
  87. package/analyzer-template/packages/analyze/src/lib/files/analyze/gatherEntityMap.ts +4 -2
  88. package/analyzer-template/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.ts +33 -10
  89. package/analyzer-template/packages/analyze/src/lib/files/analyzeChange.ts +31 -15
  90. package/analyzer-template/packages/analyze/src/lib/files/analyzeEntity.ts +11 -7
  91. package/analyzer-template/packages/analyze/src/lib/files/analyzeInitial.ts +11 -12
  92. package/analyzer-template/packages/analyze/src/lib/files/analyzeRemixRoute.ts +4 -5
  93. package/analyzer-template/packages/analyze/src/lib/files/enums/steps.ts +1 -1
  94. package/analyzer-template/packages/analyze/src/lib/files/getImportedExports.ts +14 -12
  95. package/analyzer-template/packages/analyze/src/lib/files/scenarios/TransformationTracer.ts +1315 -0
  96. package/analyzer-template/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.ts +201 -46
  97. package/analyzer-template/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.ts +102 -0
  98. package/analyzer-template/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.ts +304 -66
  99. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.ts +28 -62
  100. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateDataStructure.ts +306 -20
  101. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.ts +264 -0
  102. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateScenarioData.ts +1 -0
  103. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateScenarios.ts +2 -3
  104. package/analyzer-template/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.ts +825 -71
  105. package/analyzer-template/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.ts +56 -11
  106. package/analyzer-template/packages/analyze/src/lib/files/scenarios/propagateArrayItemSchemas.ts +474 -0
  107. package/analyzer-template/packages/analyze/src/lib/files/setImportedExports.ts +2 -1
  108. package/analyzer-template/packages/analyze/src/lib/index.ts +1 -0
  109. package/analyzer-template/packages/analyze/src/lib/utils/getFileByPath.ts +19 -0
  110. package/analyzer-template/packages/aws/codebuild/index.ts +1 -0
  111. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.d.ts +11 -1
  112. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.d.ts.map +1 -1
  113. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.js +29 -18
  114. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.js.map +1 -1
  115. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.d.ts +2 -2
  116. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.d.ts.map +1 -1
  117. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.js +2 -2
  118. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.js.map +1 -1
  119. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.d.ts +8 -18
  120. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.d.ts.map +1 -1
  121. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.js +17 -61
  122. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.js.map +1 -1
  123. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.d.ts.map +1 -1
  124. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.js +8 -1
  125. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.js.map +1 -1
  126. package/analyzer-template/packages/aws/package.json +10 -10
  127. package/analyzer-template/packages/aws/src/lib/codebuild/waitForBuild.ts +43 -19
  128. package/analyzer-template/packages/aws/src/lib/ecs/ecsDefineContainer.ts +3 -3
  129. package/analyzer-template/packages/aws/src/lib/ecs/ecsTaskFactory.ts +17 -69
  130. package/analyzer-template/packages/aws/src/lib/s3/uploadFileToS3.ts +8 -1
  131. package/analyzer-template/packages/database/package.json +1 -1
  132. package/analyzer-template/packages/database/src/lib/analysisBranchToDb.ts +1 -1
  133. package/analyzer-template/packages/database/src/lib/analysisToDb.ts +1 -1
  134. package/analyzer-template/packages/database/src/lib/branchToDb.ts +1 -1
  135. package/analyzer-template/packages/database/src/lib/commitBranchToDb.ts +1 -1
  136. package/analyzer-template/packages/database/src/lib/commitToDb.ts +1 -1
  137. package/analyzer-template/packages/database/src/lib/fileToDb.ts +1 -1
  138. package/analyzer-template/packages/database/src/lib/kysely/db.ts +14 -1
  139. package/analyzer-template/packages/database/src/lib/kysely/tables/commitsTable.ts +6 -0
  140. package/analyzer-template/packages/database/src/lib/kysely/tables/debugReportsTable.ts +17 -1
  141. package/analyzer-template/packages/database/src/lib/kysely/tables/labsRequestsTable.ts +52 -0
  142. package/analyzer-template/packages/database/src/lib/loadAnalyses.ts +58 -1
  143. package/analyzer-template/packages/database/src/lib/loadAnalysis.ts +13 -0
  144. package/analyzer-template/packages/database/src/lib/loadBranch.ts +16 -1
  145. package/analyzer-template/packages/database/src/lib/loadCommit.ts +11 -0
  146. package/analyzer-template/packages/database/src/lib/loadCommits.ts +28 -0
  147. package/analyzer-template/packages/database/src/lib/loadEntities.ts +26 -3
  148. package/analyzer-template/packages/database/src/lib/loadEntityBranches.ts +12 -0
  149. package/analyzer-template/packages/database/src/lib/loadReadyToBeCapturedAnalyses.ts +7 -3
  150. package/analyzer-template/packages/database/src/lib/projectToDb.ts +1 -1
  151. package/analyzer-template/packages/database/src/lib/saveFiles.ts +1 -1
  152. package/analyzer-template/packages/database/src/lib/scenarioToDb.ts +1 -1
  153. package/analyzer-template/packages/database/src/lib/updateCommitMetadata.ts +7 -14
  154. package/analyzer-template/packages/database/src/lib/userScenarioToDb.ts +1 -1
  155. package/analyzer-template/packages/generate/index.ts +3 -0
  156. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.ts +17 -1
  157. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.ts +193 -0
  158. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.ts +73 -0
  159. package/analyzer-template/packages/generate/src/lib/scenarioComponentForServer.ts +114 -0
  160. package/analyzer-template/packages/github/dist/database/src/lib/analysisBranchToDb.js +1 -1
  161. package/analyzer-template/packages/github/dist/database/src/lib/analysisBranchToDb.js.map +1 -1
  162. package/analyzer-template/packages/github/dist/database/src/lib/analysisToDb.js +1 -1
  163. package/analyzer-template/packages/github/dist/database/src/lib/analysisToDb.js.map +1 -1
  164. package/analyzer-template/packages/github/dist/database/src/lib/branchToDb.js +1 -1
  165. package/analyzer-template/packages/github/dist/database/src/lib/branchToDb.js.map +1 -1
  166. package/analyzer-template/packages/github/dist/database/src/lib/commitBranchToDb.js +1 -1
  167. package/analyzer-template/packages/github/dist/database/src/lib/commitBranchToDb.js.map +1 -1
  168. package/analyzer-template/packages/github/dist/database/src/lib/commitToDb.js +1 -1
  169. package/analyzer-template/packages/github/dist/database/src/lib/commitToDb.js.map +1 -1
  170. package/analyzer-template/packages/github/dist/database/src/lib/fileToDb.js +1 -1
  171. package/analyzer-template/packages/github/dist/database/src/lib/fileToDb.js.map +1 -1
  172. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts +2 -0
  173. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts.map +1 -1
  174. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js +11 -1
  175. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js.map +1 -1
  176. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/analysesTable.d.ts +1 -18
  177. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/analysesTable.d.ts.map +1 -1
  178. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.d.ts +1 -0
  179. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.d.ts.map +1 -1
  180. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.js +3 -0
  181. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.js.map +1 -1
  182. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.d.ts +17 -1
  183. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.d.ts.map +1 -1
  184. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.js.map +1 -1
  185. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/entitiesTable.d.ts +1 -0
  186. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/entitiesTable.d.ts.map +1 -1
  187. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.d.ts +23 -0
  188. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.d.ts.map +1 -0
  189. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.js +35 -0
  190. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.js.map +1 -0
  191. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts +2 -6
  192. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts.map +1 -1
  193. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.d.ts +2 -0
  194. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.d.ts.map +1 -1
  195. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.js +45 -2
  196. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.js.map +1 -1
  197. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.d.ts.map +1 -1
  198. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.js +8 -0
  199. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.js.map +1 -1
  200. package/analyzer-template/packages/github/dist/database/src/lib/loadBranch.js +11 -1
  201. package/analyzer-template/packages/github/dist/database/src/lib/loadBranch.js.map +1 -1
  202. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.d.ts.map +1 -1
  203. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.js +7 -0
  204. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.js.map +1 -1
  205. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.d.ts +3 -1
  206. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.d.ts.map +1 -1
  207. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js +22 -1
  208. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js.map +1 -1
  209. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.d.ts +3 -1
  210. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.d.ts.map +1 -1
  211. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js +23 -4
  212. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js.map +1 -1
  213. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.d.ts.map +1 -1
  214. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.js +9 -0
  215. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.js.map +1 -1
  216. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.d.ts.map +1 -1
  217. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js +7 -4
  218. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  219. package/analyzer-template/packages/github/dist/database/src/lib/projectToDb.js +1 -1
  220. package/analyzer-template/packages/github/dist/database/src/lib/projectToDb.js.map +1 -1
  221. package/analyzer-template/packages/github/dist/database/src/lib/saveFiles.js +1 -1
  222. package/analyzer-template/packages/github/dist/database/src/lib/saveFiles.js.map +1 -1
  223. package/analyzer-template/packages/github/dist/database/src/lib/scenarioToDb.js +1 -1
  224. package/analyzer-template/packages/github/dist/database/src/lib/scenarioToDb.js.map +1 -1
  225. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.d.ts +2 -2
  226. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.d.ts.map +1 -1
  227. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js +5 -4
  228. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js.map +1 -1
  229. package/analyzer-template/packages/github/dist/generate/index.d.ts +3 -0
  230. package/analyzer-template/packages/github/dist/generate/index.d.ts.map +1 -1
  231. package/analyzer-template/packages/github/dist/generate/index.js +3 -0
  232. package/analyzer-template/packages/github/dist/generate/index.js.map +1 -1
  233. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.d.ts.map +1 -1
  234. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js +16 -1
  235. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js.map +1 -1
  236. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.d.ts +9 -0
  237. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.d.ts.map +1 -0
  238. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +189 -0
  239. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -0
  240. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts +20 -0
  241. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts.map +1 -0
  242. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js +53 -0
  243. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js.map +1 -0
  244. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts +8 -0
  245. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts.map +1 -0
  246. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js +89 -0
  247. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js.map +1 -0
  248. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.d.ts.map +1 -1
  249. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.js +10 -0
  250. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.js.map +1 -1
  251. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.d.ts.map +1 -1
  252. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.js +3 -0
  253. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.js.map +1 -1
  254. package/analyzer-template/packages/github/dist/types/index.d.ts +3 -4
  255. package/analyzer-template/packages/github/dist/types/index.d.ts.map +1 -1
  256. package/analyzer-template/packages/github/dist/types/index.js +0 -1
  257. package/analyzer-template/packages/github/dist/types/index.js.map +1 -1
  258. package/analyzer-template/packages/github/dist/types/src/types/Analysis.d.ts +71 -27
  259. package/analyzer-template/packages/github/dist/types/src/types/Analysis.d.ts.map +1 -1
  260. package/analyzer-template/packages/github/dist/types/src/types/Commit.d.ts +2 -0
  261. package/analyzer-template/packages/github/dist/types/src/types/Commit.d.ts.map +1 -1
  262. package/analyzer-template/packages/github/dist/types/src/types/Entity.d.ts +2 -0
  263. package/analyzer-template/packages/github/dist/types/src/types/Entity.d.ts.map +1 -1
  264. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts +7 -0
  265. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  266. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts +9 -54
  267. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts.map +1 -1
  268. package/analyzer-template/packages/github/dist/types/src/types/Scenario.js +1 -21
  269. package/analyzer-template/packages/github/dist/types/src/types/Scenario.js.map +1 -1
  270. package/analyzer-template/packages/github/dist/types/src/types/ScenariosDataStructure.d.ts +153 -5
  271. package/analyzer-template/packages/github/dist/types/src/types/ScenariosDataStructure.d.ts.map +1 -1
  272. package/analyzer-template/packages/github/dist/types/src/types/ScopeAnalysis.d.ts +6 -1
  273. package/analyzer-template/packages/github/dist/types/src/types/ScopeAnalysis.d.ts.map +1 -1
  274. package/analyzer-template/packages/github/dist/types/src/types/StatementInfo.d.ts +2 -0
  275. package/analyzer-template/packages/github/dist/types/src/types/StatementInfo.d.ts.map +1 -1
  276. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.d.ts +9 -1
  277. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.d.ts.map +1 -1
  278. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js +29 -3
  279. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js.map +1 -1
  280. package/analyzer-template/packages/github/package.json +1 -1
  281. package/analyzer-template/packages/github/src/lib/loadOrCreateCommit.ts +14 -0
  282. package/analyzer-template/packages/github/src/lib/syncPrimaryBranch.ts +2 -0
  283. package/analyzer-template/packages/process/index.ts +2 -0
  284. package/analyzer-template/packages/process/package.json +12 -0
  285. package/analyzer-template/packages/process/tsconfig.json +8 -0
  286. package/analyzer-template/packages/types/index.ts +3 -6
  287. package/analyzer-template/packages/types/src/types/Analysis.ts +87 -27
  288. package/analyzer-template/packages/types/src/types/Commit.ts +2 -0
  289. package/analyzer-template/packages/types/src/types/Entity.ts +2 -0
  290. package/analyzer-template/packages/types/src/types/ProjectMetadata.ts +7 -0
  291. package/analyzer-template/packages/types/src/types/Scenario.ts +9 -77
  292. package/analyzer-template/packages/types/src/types/ScenariosDataStructure.ts +181 -5
  293. package/analyzer-template/packages/types/src/types/ScopeAnalysis.ts +6 -1
  294. package/analyzer-template/packages/types/src/types/StatementInfo.ts +2 -0
  295. package/analyzer-template/packages/utils/dist/types/index.d.ts +3 -4
  296. package/analyzer-template/packages/utils/dist/types/index.d.ts.map +1 -1
  297. package/analyzer-template/packages/utils/dist/types/index.js +0 -1
  298. package/analyzer-template/packages/utils/dist/types/index.js.map +1 -1
  299. package/analyzer-template/packages/utils/dist/types/src/types/Analysis.d.ts +71 -27
  300. package/analyzer-template/packages/utils/dist/types/src/types/Analysis.d.ts.map +1 -1
  301. package/analyzer-template/packages/utils/dist/types/src/types/Commit.d.ts +2 -0
  302. package/analyzer-template/packages/utils/dist/types/src/types/Commit.d.ts.map +1 -1
  303. package/analyzer-template/packages/utils/dist/types/src/types/Entity.d.ts +2 -0
  304. package/analyzer-template/packages/utils/dist/types/src/types/Entity.d.ts.map +1 -1
  305. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts +7 -0
  306. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  307. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts +9 -54
  308. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts.map +1 -1
  309. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.js +1 -21
  310. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.js.map +1 -1
  311. package/analyzer-template/packages/utils/dist/types/src/types/ScenariosDataStructure.d.ts +153 -5
  312. package/analyzer-template/packages/utils/dist/types/src/types/ScenariosDataStructure.d.ts.map +1 -1
  313. package/analyzer-template/packages/utils/dist/types/src/types/ScopeAnalysis.d.ts +6 -1
  314. package/analyzer-template/packages/utils/dist/types/src/types/ScopeAnalysis.d.ts.map +1 -1
  315. package/analyzer-template/packages/utils/dist/types/src/types/StatementInfo.d.ts +2 -0
  316. package/analyzer-template/packages/utils/dist/types/src/types/StatementInfo.d.ts.map +1 -1
  317. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.d.ts.map +1 -1
  318. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.js +93 -2
  319. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.js.map +1 -1
  320. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.d.ts +9 -1
  321. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.d.ts.map +1 -1
  322. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.js +29 -3
  323. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.js.map +1 -1
  324. package/analyzer-template/packages/utils/src/lib/fs/rsyncCopy.ts +108 -2
  325. package/analyzer-template/packages/utils/src/lib/safeFileName.ts +48 -3
  326. package/analyzer-template/playwright/capture.ts +57 -26
  327. package/analyzer-template/playwright/captureStatic.ts +1 -1
  328. package/analyzer-template/playwright/getCodeYamInfo.ts +12 -7
  329. package/analyzer-template/playwright/waitForServer.ts +21 -6
  330. package/analyzer-template/project/analyzeBaselineCommit.ts +9 -0
  331. package/analyzer-template/project/analyzeBranchCommit.ts +4 -0
  332. package/analyzer-template/project/analyzeFileEntities.ts +4 -0
  333. package/analyzer-template/project/analyzeRegularCommit.ts +9 -0
  334. package/analyzer-template/project/captureLibraryFunctionDirect.ts +29 -26
  335. package/analyzer-template/project/constructMockCode.ts +1037 -111
  336. package/analyzer-template/project/controller/startController.ts +16 -1
  337. package/analyzer-template/project/createEntitiesAndSortFiles.ts +83 -0
  338. package/analyzer-template/project/executeLibraryFunctionDirect.ts +7 -3
  339. package/analyzer-template/project/loadReadyToBeCaptured.ts +65 -41
  340. package/analyzer-template/project/mocks/analyzeFileMock.ts +8 -7
  341. package/analyzer-template/project/orchestrateCapture/AwsCaptureTaskRunner.ts +12 -4
  342. package/analyzer-template/project/orchestrateCapture/KyselyAnalysisLoader.ts +3 -6
  343. package/analyzer-template/project/orchestrateCapture/SequentialCaptureTaskRunner.ts +18 -7
  344. package/analyzer-template/project/orchestrateCapture/taskRunner.ts +4 -2
  345. package/analyzer-template/project/orchestrateCapture.ts +85 -10
  346. package/analyzer-template/project/reconcileMockDataKeys.ts +240 -0
  347. package/analyzer-template/project/runAnalysis.ts +11 -0
  348. package/analyzer-template/project/serverOnlyModules.ts +127 -2
  349. package/analyzer-template/project/start.ts +51 -15
  350. package/analyzer-template/project/startScenarioCapture.ts +6 -0
  351. package/analyzer-template/project/writeMockDataTsx.ts +298 -11
  352. package/analyzer-template/project/writeScenarioClientWrapper.ts +21 -0
  353. package/analyzer-template/project/writeScenarioComponents.ts +388 -54
  354. package/analyzer-template/project/writeScenarioFiles.ts +26 -0
  355. package/analyzer-template/project/writeSimpleRoot.ts +23 -13
  356. package/analyzer-template/scripts/comboWorkerLoop.cjs +99 -50
  357. package/analyzer-template/scripts/defaultCmd.sh +9 -0
  358. package/analyzer-template/tsconfig.json +2 -1
  359. package/background/src/lib/local/createLocalAnalyzer.js +2 -30
  360. package/background/src/lib/local/createLocalAnalyzer.js.map +1 -1
  361. package/background/src/lib/local/execAsync.js +1 -1
  362. package/background/src/lib/local/execAsync.js.map +1 -1
  363. package/background/src/lib/virtualized/common/execAsync.js +1 -1
  364. package/background/src/lib/virtualized/common/execAsync.js.map +1 -1
  365. package/background/src/lib/virtualized/project/analyzeBaselineCommit.js +7 -1
  366. package/background/src/lib/virtualized/project/analyzeBaselineCommit.js.map +1 -1
  367. package/background/src/lib/virtualized/project/analyzeBranchCommit.js +2 -1
  368. package/background/src/lib/virtualized/project/analyzeBranchCommit.js.map +1 -1
  369. package/background/src/lib/virtualized/project/analyzeFileEntities.js +2 -1
  370. package/background/src/lib/virtualized/project/analyzeFileEntities.js.map +1 -1
  371. package/background/src/lib/virtualized/project/analyzeRegularCommit.js +7 -1
  372. package/background/src/lib/virtualized/project/analyzeRegularCommit.js.map +1 -1
  373. package/background/src/lib/virtualized/project/captureLibraryFunctionDirect.js +3 -3
  374. package/background/src/lib/virtualized/project/captureLibraryFunctionDirect.js.map +1 -1
  375. package/background/src/lib/virtualized/project/constructMockCode.js +908 -75
  376. package/background/src/lib/virtualized/project/constructMockCode.js.map +1 -1
  377. package/background/src/lib/virtualized/project/controller/startController.js +11 -1
  378. package/background/src/lib/virtualized/project/controller/startController.js.map +1 -1
  379. package/background/src/lib/virtualized/project/createEntitiesAndSortFiles.js +73 -1
  380. package/background/src/lib/virtualized/project/createEntitiesAndSortFiles.js.map +1 -1
  381. package/background/src/lib/virtualized/project/executeLibraryFunctionDirect.js +6 -3
  382. package/background/src/lib/virtualized/project/executeLibraryFunctionDirect.js.map +1 -1
  383. package/background/src/lib/virtualized/project/loadReadyToBeCaptured.js +19 -8
  384. package/background/src/lib/virtualized/project/loadReadyToBeCaptured.js.map +1 -1
  385. package/background/src/lib/virtualized/project/mocks/analyzeFileMock.js +7 -7
  386. package/background/src/lib/virtualized/project/mocks/analyzeFileMock.js.map +1 -1
  387. package/background/src/lib/virtualized/project/orchestrateCapture/AwsCaptureTaskRunner.js +2 -2
  388. package/background/src/lib/virtualized/project/orchestrateCapture/AwsCaptureTaskRunner.js.map +1 -1
  389. package/background/src/lib/virtualized/project/orchestrateCapture/KyselyAnalysisLoader.js +3 -2
  390. package/background/src/lib/virtualized/project/orchestrateCapture/KyselyAnalysisLoader.js.map +1 -1
  391. package/background/src/lib/virtualized/project/orchestrateCapture/SequentialCaptureTaskRunner.js +7 -5
  392. package/background/src/lib/virtualized/project/orchestrateCapture/SequentialCaptureTaskRunner.js.map +1 -1
  393. package/background/src/lib/virtualized/project/orchestrateCapture.js +69 -11
  394. package/background/src/lib/virtualized/project/orchestrateCapture.js.map +1 -1
  395. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js +199 -0
  396. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js.map +1 -1
  397. package/background/src/lib/virtualized/project/runAnalysis.js +9 -0
  398. package/background/src/lib/virtualized/project/runAnalysis.js.map +1 -1
  399. package/background/src/lib/virtualized/project/serverOnlyModules.js +106 -3
  400. package/background/src/lib/virtualized/project/serverOnlyModules.js.map +1 -1
  401. package/background/src/lib/virtualized/project/start.js +47 -15
  402. package/background/src/lib/virtualized/project/start.js.map +1 -1
  403. package/background/src/lib/virtualized/project/startScenarioCapture.js +7 -0
  404. package/background/src/lib/virtualized/project/startScenarioCapture.js.map +1 -1
  405. package/background/src/lib/virtualized/project/writeMockDataTsx.js +255 -8
  406. package/background/src/lib/virtualized/project/writeMockDataTsx.js.map +1 -1
  407. package/background/src/lib/virtualized/project/writeScenarioClientWrapper.js +15 -0
  408. package/background/src/lib/virtualized/project/writeScenarioClientWrapper.js.map +1 -0
  409. package/background/src/lib/virtualized/project/writeScenarioComponents.js +301 -48
  410. package/background/src/lib/virtualized/project/writeScenarioComponents.js.map +1 -1
  411. package/background/src/lib/virtualized/project/writeScenarioFiles.js +19 -0
  412. package/background/src/lib/virtualized/project/writeScenarioFiles.js.map +1 -1
  413. package/background/src/lib/virtualized/project/writeSimpleRoot.js +23 -13
  414. package/background/src/lib/virtualized/project/writeSimpleRoot.js.map +1 -1
  415. package/codeyam-cli/scripts/apply-setup.js +180 -0
  416. package/codeyam-cli/scripts/apply-setup.js.map +1 -1
  417. package/codeyam-cli/src/cli.js +37 -18
  418. package/codeyam-cli/src/cli.js.map +1 -1
  419. package/codeyam-cli/src/codeyam-cli.js +18 -2
  420. package/codeyam-cli/src/codeyam-cli.js.map +1 -1
  421. package/codeyam-cli/src/commands/analyze.js +5 -3
  422. package/codeyam-cli/src/commands/analyze.js.map +1 -1
  423. package/codeyam-cli/src/commands/baseline.js +176 -0
  424. package/codeyam-cli/src/commands/baseline.js.map +1 -0
  425. package/codeyam-cli/src/commands/debug.js +37 -23
  426. package/codeyam-cli/src/commands/debug.js.map +1 -1
  427. package/codeyam-cli/src/commands/default.js +30 -34
  428. package/codeyam-cli/src/commands/default.js.map +1 -1
  429. package/codeyam-cli/src/commands/detect-universal-mocks.js +2 -0
  430. package/codeyam-cli/src/commands/detect-universal-mocks.js.map +1 -1
  431. package/codeyam-cli/src/commands/init.js +49 -257
  432. package/codeyam-cli/src/commands/init.js.map +1 -1
  433. package/codeyam-cli/src/commands/memory.js +307 -0
  434. package/codeyam-cli/src/commands/memory.js.map +1 -0
  435. package/codeyam-cli/src/commands/recapture.js +31 -18
  436. package/codeyam-cli/src/commands/recapture.js.map +1 -1
  437. package/codeyam-cli/src/commands/report.js +46 -1
  438. package/codeyam-cli/src/commands/report.js.map +1 -1
  439. package/codeyam-cli/src/commands/setup-sandbox.js +2 -0
  440. package/codeyam-cli/src/commands/setup-sandbox.js.map +1 -1
  441. package/codeyam-cli/src/commands/setup-simulations.js +284 -0
  442. package/codeyam-cli/src/commands/setup-simulations.js.map +1 -0
  443. package/codeyam-cli/src/commands/start.js +8 -12
  444. package/codeyam-cli/src/commands/start.js.map +1 -1
  445. package/codeyam-cli/src/commands/status.js +23 -1
  446. package/codeyam-cli/src/commands/status.js.map +1 -1
  447. package/codeyam-cli/src/commands/test-startup.js +3 -1
  448. package/codeyam-cli/src/commands/test-startup.js.map +1 -1
  449. package/codeyam-cli/src/commands/verify.js +14 -2
  450. package/codeyam-cli/src/commands/verify.js.map +1 -1
  451. package/codeyam-cli/src/commands/wipe.js +108 -0
  452. package/codeyam-cli/src/commands/wipe.js.map +1 -0
  453. package/codeyam-cli/src/utils/__tests__/npmVersionCheck.test.js +179 -0
  454. package/codeyam-cli/src/utils/__tests__/npmVersionCheck.test.js.map +1 -0
  455. package/codeyam-cli/src/utils/__tests__/serverVersionStaleness.test.js +81 -0
  456. package/codeyam-cli/src/utils/__tests__/serverVersionStaleness.test.js.map +1 -0
  457. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js +128 -82
  458. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js.map +1 -1
  459. package/codeyam-cli/src/utils/analysisRunner.js +29 -15
  460. package/codeyam-cli/src/utils/analysisRunner.js.map +1 -1
  461. package/codeyam-cli/src/utils/analyzer.js +7 -0
  462. package/codeyam-cli/src/utils/analyzer.js.map +1 -1
  463. package/codeyam-cli/src/utils/backgroundServer.js +102 -21
  464. package/codeyam-cli/src/utils/backgroundServer.js.map +1 -1
  465. package/codeyam-cli/src/utils/database.js +91 -5
  466. package/codeyam-cli/src/utils/database.js.map +1 -1
  467. package/codeyam-cli/src/utils/generateReport.js +4 -3
  468. package/codeyam-cli/src/utils/generateReport.js.map +1 -1
  469. package/codeyam-cli/src/utils/git.js +79 -0
  470. package/codeyam-cli/src/utils/git.js.map +1 -0
  471. package/codeyam-cli/src/utils/install-skills.js +76 -37
  472. package/codeyam-cli/src/utils/install-skills.js.map +1 -1
  473. package/codeyam-cli/src/utils/labsAutoCheck.js +19 -0
  474. package/codeyam-cli/src/utils/labsAutoCheck.js.map +1 -0
  475. package/codeyam-cli/src/utils/npmVersionCheck.js +76 -0
  476. package/codeyam-cli/src/utils/npmVersionCheck.js.map +1 -0
  477. package/codeyam-cli/src/utils/progress.js +7 -0
  478. package/codeyam-cli/src/utils/progress.js.map +1 -1
  479. package/codeyam-cli/src/utils/queue/job.js +109 -0
  480. package/codeyam-cli/src/utils/queue/job.js.map +1 -1
  481. package/codeyam-cli/src/utils/queue/manager.js +6 -0
  482. package/codeyam-cli/src/utils/queue/manager.js.map +1 -1
  483. package/codeyam-cli/src/utils/queue/persistence.js.map +1 -1
  484. package/codeyam-cli/src/utils/requireSimulations.js +10 -0
  485. package/codeyam-cli/src/utils/requireSimulations.js.map +1 -0
  486. package/codeyam-cli/src/utils/ruleReflection/__tests__/confusionDetector.test.js +82 -0
  487. package/codeyam-cli/src/utils/ruleReflection/__tests__/confusionDetector.test.js.map +1 -0
  488. package/codeyam-cli/src/utils/ruleReflection/__tests__/contextBuilder.test.js +230 -0
  489. package/codeyam-cli/src/utils/ruleReflection/__tests__/contextBuilder.test.js.map +1 -0
  490. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/assertRules.js +67 -0
  491. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/assertRules.js.map +1 -0
  492. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/captureFixture.js +105 -0
  493. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/captureFixture.js.map +1 -0
  494. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/loadCapturedFixture.js +34 -0
  495. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/loadCapturedFixture.js.map +1 -0
  496. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/runClaude.js +162 -0
  497. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/runClaude.js.map +1 -0
  498. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js +74 -0
  499. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js.map +1 -0
  500. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js +376 -0
  501. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js.map +1 -0
  502. package/codeyam-cli/src/utils/ruleReflection/__tests__/promptBuilder.test.js +116 -0
  503. package/codeyam-cli/src/utils/ruleReflection/__tests__/promptBuilder.test.js.map +1 -0
  504. package/codeyam-cli/src/utils/ruleReflection/__tests__/transcriptParser.test.js +127 -0
  505. package/codeyam-cli/src/utils/ruleReflection/__tests__/transcriptParser.test.js.map +1 -0
  506. package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js +50 -0
  507. package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js.map +1 -0
  508. package/codeyam-cli/src/utils/ruleReflection/contextBuilder.js +116 -0
  509. package/codeyam-cli/src/utils/ruleReflection/contextBuilder.js.map +1 -0
  510. package/codeyam-cli/src/utils/ruleReflection/index.js +5 -0
  511. package/codeyam-cli/src/utils/ruleReflection/index.js.map +1 -0
  512. package/codeyam-cli/src/utils/ruleReflection/promptBuilder.js +44 -0
  513. package/codeyam-cli/src/utils/ruleReflection/promptBuilder.js.map +1 -0
  514. package/codeyam-cli/src/utils/ruleReflection/transcriptParser.js +85 -0
  515. package/codeyam-cli/src/utils/ruleReflection/transcriptParser.js.map +1 -0
  516. package/codeyam-cli/src/utils/ruleReflection/types.js +5 -0
  517. package/codeyam-cli/src/utils/ruleReflection/types.js.map +1 -0
  518. package/codeyam-cli/src/utils/rules/__tests__/ruleState.test.js +293 -0
  519. package/codeyam-cli/src/utils/rules/__tests__/ruleState.test.js.map +1 -0
  520. package/codeyam-cli/src/utils/rules/index.js +6 -0
  521. package/codeyam-cli/src/utils/rules/index.js.map +1 -0
  522. package/codeyam-cli/src/utils/rules/parser.js +83 -0
  523. package/codeyam-cli/src/utils/rules/parser.js.map +1 -0
  524. package/codeyam-cli/src/utils/rules/pathMatcher.js +18 -0
  525. package/codeyam-cli/src/utils/rules/pathMatcher.js.map +1 -0
  526. package/codeyam-cli/src/utils/rules/ruleState.js +150 -0
  527. package/codeyam-cli/src/utils/rules/ruleState.js.map +1 -0
  528. package/codeyam-cli/src/utils/rules/staleness.js +137 -0
  529. package/codeyam-cli/src/utils/rules/staleness.js.map +1 -0
  530. package/codeyam-cli/src/utils/serverState.js +37 -10
  531. package/codeyam-cli/src/utils/serverState.js.map +1 -1
  532. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js +21 -42
  533. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js.map +1 -1
  534. package/codeyam-cli/src/utils/simulationGateMiddleware.js +138 -0
  535. package/codeyam-cli/src/utils/simulationGateMiddleware.js.map +1 -0
  536. package/codeyam-cli/src/utils/syncMocksMiddleware.js +5 -24
  537. package/codeyam-cli/src/utils/syncMocksMiddleware.js.map +1 -1
  538. package/codeyam-cli/src/utils/versionInfo.js +67 -15
  539. package/codeyam-cli/src/utils/versionInfo.js.map +1 -1
  540. package/codeyam-cli/src/utils/wipe.js +128 -0
  541. package/codeyam-cli/src/utils/wipe.js.map +1 -0
  542. package/codeyam-cli/src/webserver/__tests__/dependency-smoke.test.js +66 -0
  543. package/codeyam-cli/src/webserver/__tests__/dependency-smoke.test.js.map +1 -0
  544. package/codeyam-cli/src/webserver/app/lib/database.js +88 -23
  545. package/codeyam-cli/src/webserver/app/lib/database.js.map +1 -1
  546. package/codeyam-cli/src/webserver/app/lib/dbNotifier.js.map +1 -1
  547. package/codeyam-cli/src/webserver/backgroundServer.js +50 -0
  548. package/codeyam-cli/src/webserver/backgroundServer.js.map +1 -1
  549. package/codeyam-cli/src/webserver/bootstrap.js +51 -0
  550. package/codeyam-cli/src/webserver/bootstrap.js.map +1 -1
  551. package/codeyam-cli/src/webserver/build/client/assets/CopyButton-jNYXRRNI.js +1 -0
  552. package/codeyam-cli/src/webserver/build/client/assets/EntityItem-bwuHPyTa.js +11 -0
  553. package/codeyam-cli/src/webserver/build/client/assets/{EntityTypeBadge-CzGX-miz.js → EntityTypeBadge-CvzqMxcu.js} +1 -1
  554. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeIcon-BH0XDim7.js +41 -0
  555. package/codeyam-cli/src/webserver/build/client/assets/InlineSpinner-EhOseatT.js +34 -0
  556. package/codeyam-cli/src/webserver/build/client/assets/InteractivePreview-yjIHlOGa.js +25 -0
  557. package/codeyam-cli/src/webserver/build/client/assets/{LibraryFunctionPreview-CBQPrpT0.js → LibraryFunctionPreview-Cq5o8jL4.js} +1 -1
  558. package/codeyam-cli/src/webserver/build/client/assets/{LoadingDots-D1CdlbrV.js → LoadingDots-BvMu2i-g.js} +1 -1
  559. package/codeyam-cli/src/webserver/build/client/assets/{LogViewer-wDPcZNKx.js → LogViewer-kgBTLoJD.js} +1 -1
  560. package/codeyam-cli/src/webserver/build/client/assets/ReportIssueModal-BzPgx-xO.js +11 -0
  561. package/codeyam-cli/src/webserver/build/client/assets/{SafeScreenshot-BfmDgXxG.js → SafeScreenshot-CwZrv-Ok.js} +1 -1
  562. package/codeyam-cli/src/webserver/build/client/assets/ScenarioViewer-BX2Ny2Qj.js +10 -0
  563. package/codeyam-cli/src/webserver/build/client/assets/{TruncatedFilePath-6J7zDUD5.js → TruncatedFilePath-CDpEprKa.js} +1 -1
  564. package/codeyam-cli/src/webserver/build/client/assets/_index-BRx8ZGZo.js +11 -0
  565. package/codeyam-cli/src/webserver/build/client/assets/activity.(_tab)-4S4yPfFw.js +27 -0
  566. package/codeyam-cli/src/webserver/build/client/assets/agent-transcripts-DHKuQSmR.js +17 -0
  567. package/codeyam-cli/src/webserver/build/client/assets/api.memory-profile-l0sNRNKZ.js +1 -0
  568. package/codeyam-cli/src/webserver/build/client/assets/api.restart-server-l0sNRNKZ.js +1 -0
  569. package/codeyam-cli/src/webserver/build/client/assets/api.save-fixture-l0sNRNKZ.js +1 -0
  570. package/codeyam-cli/src/webserver/build/client/assets/book-open-D4IPYH_y.js +6 -0
  571. package/codeyam-cli/src/webserver/build/client/assets/{chevron-down-BYimnrHg.js → chevron-down-CG65viiV.js} +1 -1
  572. package/codeyam-cli/src/webserver/build/client/assets/chunk-JZWAC4HX-DB3aFuEO.js +51 -0
  573. package/codeyam-cli/src/webserver/build/client/assets/{circle-check-CaVsIRxt.js → circle-check-igfMr5DY.js} +1 -1
  574. package/codeyam-cli/src/webserver/build/client/assets/copy-Coc4o_8c.js +11 -0
  575. package/codeyam-cli/src/webserver/build/client/assets/{createLucideIcon-CgUsG7ib.js → createLucideIcon-D1zB-pYc.js} +1 -1
  576. package/codeyam-cli/src/webserver/build/client/assets/{cy-logo-cli-C1gnJVOL.svg → cy-logo-cli-CCKUIm0S.svg} +2 -2
  577. package/codeyam-cli/src/webserver/build/client/assets/cy-logo-cli-DcX-ZS3p.js +1 -0
  578. package/codeyam-cli/src/webserver/build/client/assets/dev.empty-JTAjQ54M.js +1 -0
  579. package/codeyam-cli/src/webserver/build/client/assets/{entity._sha._-Dt-SjPsw.js → entity._sha._-B0h9AqE6.js} +12 -12
  580. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.fullscreen-DjLxr2JB.js +6 -0
  581. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-CtYowLOt.js +6 -0
  582. package/codeyam-cli/src/webserver/build/client/assets/{entity._sha_.edit._scenarioId-CfLCUi9S.js → entity._sha_.edit._scenarioId-PePWg17F.js} +1 -1
  583. package/codeyam-cli/src/webserver/build/client/assets/{entry.client-DKJyZfAY.js → entry.client-I-Wo99C_.js} +6 -6
  584. package/codeyam-cli/src/webserver/build/client/assets/executionFlowCoverage-BWhdfn70.js +1 -0
  585. package/codeyam-cli/src/webserver/build/client/assets/{fileTableUtils-DAtOlaWE.js → fileTableUtils-9sMMAiWJ.js} +1 -1
  586. package/codeyam-cli/src/webserver/build/client/assets/files-Co65J0s3.js +1 -0
  587. package/codeyam-cli/src/webserver/build/client/assets/{git-D62Lxxmv.js → git-BdHOxVfg.js} +8 -8
  588. package/codeyam-cli/src/webserver/build/client/assets/globals-BSZfYCkU.css +1 -0
  589. package/codeyam-cli/src/webserver/build/client/assets/{index-CzNNiTkw.js → index-CUM5iXwc.js} +1 -1
  590. package/codeyam-cli/src/webserver/build/client/assets/{index-BosqDOlH.js → index-_417gcQW.js} +1 -1
  591. package/codeyam-cli/src/webserver/build/client/assets/labs-DAvt-sy-.js +1 -0
  592. package/codeyam-cli/src/webserver/build/client/assets/{loader-circle-CNp9QFCX.js → loader-circle-TzRHMVog.js} +1 -1
  593. package/codeyam-cli/src/webserver/build/client/assets/manifest-6947409c.js +1 -0
  594. package/codeyam-cli/src/webserver/build/client/assets/memory-UIDVz141.js +92 -0
  595. package/codeyam-cli/src/webserver/build/client/assets/pause-hjzB7t2z.js +11 -0
  596. package/codeyam-cli/src/webserver/build/client/assets/root-D1WadSdf.js +62 -0
  597. package/codeyam-cli/src/webserver/build/client/assets/{search-DDGjYAMJ.js → search-DcAwD_Ln.js} +1 -1
  598. package/codeyam-cli/src/webserver/build/client/assets/settings-CclxrcPK.js +1 -0
  599. package/codeyam-cli/src/webserver/build/client/assets/simulations-DVNJVQgD.js +1 -0
  600. package/codeyam-cli/src/webserver/build/client/assets/terminal-DbEAHMbA.js +11 -0
  601. package/codeyam-cli/src/webserver/build/client/assets/{triangle-alert-CBc5dE1s.js → triangle-alert-CAD5b1o_.js} +1 -1
  602. package/codeyam-cli/src/webserver/build/client/assets/useCustomSizes-BqgrAzs3.js +1 -0
  603. package/codeyam-cli/src/webserver/build/client/assets/{useLastLogLine-BqPPNjAl.js → useLastLogLine-DAFqfEDH.js} +1 -1
  604. package/codeyam-cli/src/webserver/build/client/assets/useReportContext-DZlYx2c4.js +1 -0
  605. package/codeyam-cli/src/webserver/build/client/assets/{useToast-DWHcCcl1.js → useToast-ihdMtlf6.js} +1 -1
  606. package/codeyam-cli/src/webserver/build/server/assets/index-mgnAFRsm.js +1 -0
  607. package/codeyam-cli/src/webserver/build/server/assets/server-build-YljqAnWW.js +273 -0
  608. package/codeyam-cli/src/webserver/build/server/index.js +1 -1
  609. package/codeyam-cli/src/webserver/build-info.json +5 -5
  610. package/codeyam-cli/src/webserver/server.js +35 -25
  611. package/codeyam-cli/src/webserver/server.js.map +1 -1
  612. package/codeyam-cli/templates/{codeyam-debug-skill.md → codeyam-debug.md} +48 -4
  613. package/codeyam-cli/templates/codeyam-diagnose.md +481 -0
  614. package/codeyam-cli/templates/codeyam-memory-hook.sh +199 -0
  615. package/codeyam-cli/templates/codeyam-memory.md +396 -0
  616. package/codeyam-cli/templates/codeyam-new-rule.md +13 -0
  617. package/codeyam-cli/templates/{codeyam-setup-skill.md → codeyam-setup.md} +13 -1
  618. package/codeyam-cli/templates/{codeyam-sim-skill.md → codeyam-sim.md} +1 -1
  619. package/codeyam-cli/templates/{codeyam-test-skill.md → codeyam-test.md} +1 -1
  620. package/codeyam-cli/templates/{codeyam-verify-skill.md → codeyam-verify.md} +1 -1
  621. package/codeyam-cli/templates/rule-notification-hook.py +56 -0
  622. package/codeyam-cli/templates/rule-reflection-hook.py +627 -0
  623. package/codeyam-cli/templates/rules-instructions.md +132 -0
  624. package/package.json +20 -17
  625. package/packages/ai/index.js +8 -6
  626. package/packages/ai/index.js.map +1 -1
  627. package/packages/ai/src/lib/analyzeScope.js +179 -13
  628. package/packages/ai/src/lib/analyzeScope.js.map +1 -1
  629. package/packages/ai/src/lib/astScopes/arrayDerivationDetector.js +150 -0
  630. package/packages/ai/src/lib/astScopes/arrayDerivationDetector.js.map +1 -0
  631. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js +138 -9
  632. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js.map +1 -1
  633. package/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.js +435 -0
  634. package/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.js.map +1 -0
  635. package/packages/ai/src/lib/astScopes/methodSemantics.js +138 -23
  636. package/packages/ai/src/lib/astScopes/methodSemantics.js.map +1 -1
  637. package/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.js +10 -14
  638. package/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.js.map +1 -1
  639. package/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.js +8 -0
  640. package/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.js.map +1 -1
  641. package/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.js +7 -0
  642. package/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.js.map +1 -1
  643. package/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.js +138 -1
  644. package/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.js.map +1 -1
  645. package/packages/ai/src/lib/astScopes/processExpression.js +944 -30
  646. package/packages/ai/src/lib/astScopes/processExpression.js.map +1 -1
  647. package/packages/ai/src/lib/astScopes/sharedPatterns.js +25 -0
  648. package/packages/ai/src/lib/astScopes/sharedPatterns.js.map +1 -1
  649. package/packages/ai/src/lib/checkAllAttributes.js +24 -9
  650. package/packages/ai/src/lib/checkAllAttributes.js.map +1 -1
  651. package/packages/ai/src/lib/completionCall.js +178 -31
  652. package/packages/ai/src/lib/completionCall.js.map +1 -1
  653. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js +1579 -189
  654. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js.map +1 -1
  655. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.js +5 -1
  656. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.js.map +1 -1
  657. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js +230 -23
  658. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js.map +1 -1
  659. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.js +7 -1
  660. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.js.map +1 -1
  661. package/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.js +13 -3
  662. package/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.js.map +1 -1
  663. package/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.js +6 -4
  664. package/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.js.map +1 -1
  665. package/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.js +52 -3
  666. package/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.js.map +1 -1
  667. package/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.js +111 -14
  668. package/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.js.map +1 -1
  669. package/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.js +63 -0
  670. package/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.js.map +1 -0
  671. package/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.js +122 -12
  672. package/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.js.map +1 -1
  673. package/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.js +173 -0
  674. package/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.js.map +1 -0
  675. package/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.js +37 -20
  676. package/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.js.map +1 -1
  677. package/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js +333 -81
  678. package/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js.map +1 -1
  679. package/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.js +107 -0
  680. package/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.js.map +1 -0
  681. package/packages/ai/src/lib/dataStructureChunking.js +130 -0
  682. package/packages/ai/src/lib/dataStructureChunking.js.map +1 -0
  683. package/packages/ai/src/lib/deepEqual.js +32 -0
  684. package/packages/ai/src/lib/deepEqual.js.map +1 -0
  685. package/packages/ai/src/lib/e2eDataTracking.js +241 -0
  686. package/packages/ai/src/lib/e2eDataTracking.js.map +1 -0
  687. package/packages/ai/src/lib/extractCriticalDataKeys.js +96 -0
  688. package/packages/ai/src/lib/extractCriticalDataKeys.js.map +1 -0
  689. package/packages/ai/src/lib/generateChangesEntityScenarioData.js +21 -5
  690. package/packages/ai/src/lib/generateChangesEntityScenarioData.js.map +1 -1
  691. package/packages/ai/src/lib/generateChangesEntityScenarios.js +78 -120
  692. package/packages/ai/src/lib/generateChangesEntityScenarios.js.map +1 -1
  693. package/packages/ai/src/lib/generateEntityDataStructure.js +47 -2
  694. package/packages/ai/src/lib/generateEntityDataStructure.js.map +1 -1
  695. package/packages/ai/src/lib/generateEntityScenarioData.js +1101 -62
  696. package/packages/ai/src/lib/generateEntityScenarioData.js.map +1 -1
  697. package/packages/ai/src/lib/generateEntityScenarios.js +177 -163
  698. package/packages/ai/src/lib/generateEntityScenarios.js.map +1 -1
  699. package/packages/ai/src/lib/generateExecutionFlows.js +495 -0
  700. package/packages/ai/src/lib/generateExecutionFlows.js.map +1 -0
  701. package/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.js +380 -0
  702. package/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.js.map +1 -0
  703. package/packages/ai/src/lib/generateExecutionFlowsFromConditionals.js +1807 -0
  704. package/packages/ai/src/lib/generateExecutionFlowsFromConditionals.js.map +1 -0
  705. package/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.js +194 -0
  706. package/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.js.map +1 -0
  707. package/packages/ai/src/lib/guessScenarioDataFromDescription.js +2 -2
  708. package/packages/ai/src/lib/guessScenarioDataFromDescription.js.map +1 -1
  709. package/packages/ai/src/lib/isolateScopes.js +270 -7
  710. package/packages/ai/src/lib/isolateScopes.js.map +1 -1
  711. package/packages/ai/src/lib/mergeJsonTypeDefinitions.js +5 -0
  712. package/packages/ai/src/lib/mergeJsonTypeDefinitions.js.map +1 -1
  713. package/packages/ai/src/lib/mergeStatements.js +88 -46
  714. package/packages/ai/src/lib/mergeStatements.js.map +1 -1
  715. package/packages/ai/src/lib/promptGenerators/collapseNullableObjects.js +97 -0
  716. package/packages/ai/src/lib/promptGenerators/collapseNullableObjects.js.map +1 -0
  717. package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js +10 -4
  718. package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js.map +1 -1
  719. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js +1 -1
  720. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js.map +1 -1
  721. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js +21 -100
  722. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js.map +1 -1
  723. package/packages/ai/src/lib/promptGenerators/generateChunkPrompt.js +54 -0
  724. package/packages/ai/src/lib/promptGenerators/generateChunkPrompt.js.map +1 -0
  725. package/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.js +83 -6
  726. package/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.js.map +1 -1
  727. package/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.js +10 -70
  728. package/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.js.map +1 -1
  729. package/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.js +45 -0
  730. package/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.js.map +1 -0
  731. package/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.js +9 -9
  732. package/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.js.map +1 -1
  733. package/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.js +335 -0
  734. package/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.js.map +1 -0
  735. package/packages/ai/src/lib/resolvePathToControllable.js +677 -0
  736. package/packages/ai/src/lib/resolvePathToControllable.js.map +1 -0
  737. package/packages/ai/src/lib/splitOutsideParentheses.js +3 -1
  738. package/packages/ai/src/lib/splitOutsideParentheses.js.map +1 -1
  739. package/packages/ai/src/lib/worker/SerializableDataStructure.js +29 -0
  740. package/packages/ai/src/lib/worker/SerializableDataStructure.js.map +1 -1
  741. package/packages/ai/src/lib/worker/analyzeScopeWorker.js +94 -1
  742. package/packages/ai/src/lib/worker/analyzeScopeWorker.js.map +1 -1
  743. package/packages/analyze/index.js +1 -0
  744. package/packages/analyze/index.js.map +1 -1
  745. package/packages/analyze/src/lib/FileAnalyzer.js +75 -36
  746. package/packages/analyze/src/lib/FileAnalyzer.js.map +1 -1
  747. package/packages/analyze/src/lib/ProjectAnalyzer.js +96 -26
  748. package/packages/analyze/src/lib/ProjectAnalyzer.js.map +1 -1
  749. package/packages/analyze/src/lib/analysisContext.js +30 -5
  750. package/packages/analyze/src/lib/analysisContext.js.map +1 -1
  751. package/packages/analyze/src/lib/asts/nodes/getNodeType.js +1 -0
  752. package/packages/analyze/src/lib/asts/nodes/getNodeType.js.map +1 -1
  753. package/packages/analyze/src/lib/asts/nodes/index.js +1 -0
  754. package/packages/analyze/src/lib/asts/nodes/index.js.map +1 -1
  755. package/packages/analyze/src/lib/asts/nodes/isAsyncFunction.js +52 -0
  756. package/packages/analyze/src/lib/asts/nodes/isAsyncFunction.js.map +1 -0
  757. package/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.js +14 -0
  758. package/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.js.map +1 -1
  759. package/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.js +14 -0
  760. package/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.js.map +1 -1
  761. package/packages/analyze/src/lib/asts/sourceFiles/getAllExports.js +6 -0
  762. package/packages/analyze/src/lib/asts/sourceFiles/getAllExports.js.map +1 -1
  763. package/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.js +6 -0
  764. package/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.js.map +1 -1
  765. package/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.js +39 -1
  766. package/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.js.map +1 -1
  767. package/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.js +2 -1
  768. package/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.js.map +1 -1
  769. package/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.js +206 -57
  770. package/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.js.map +1 -1
  771. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js +24 -1
  772. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js.map +1 -1
  773. package/packages/analyze/src/lib/files/analyze/dependencyResolver.js +5 -0
  774. package/packages/analyze/src/lib/files/analyze/dependencyResolver.js.map +1 -1
  775. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js +2 -0
  776. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js.map +1 -1
  777. package/packages/analyze/src/lib/files/analyze/gatherEntityMap.js +2 -1
  778. package/packages/analyze/src/lib/files/analyze/gatherEntityMap.js.map +1 -1
  779. package/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.js +31 -10
  780. package/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.js.map +1 -1
  781. package/packages/analyze/src/lib/files/analyzeChange.js +21 -11
  782. package/packages/analyze/src/lib/files/analyzeChange.js.map +1 -1
  783. package/packages/analyze/src/lib/files/analyzeEntity.js +9 -8
  784. package/packages/analyze/src/lib/files/analyzeEntity.js.map +1 -1
  785. package/packages/analyze/src/lib/files/analyzeInitial.js +9 -10
  786. package/packages/analyze/src/lib/files/analyzeInitial.js.map +1 -1
  787. package/packages/analyze/src/lib/files/analyzeRemixRoute.js +3 -2
  788. package/packages/analyze/src/lib/files/analyzeRemixRoute.js.map +1 -1
  789. package/packages/analyze/src/lib/files/enums/steps.js +1 -1
  790. package/packages/analyze/src/lib/files/enums/steps.js.map +1 -1
  791. package/packages/analyze/src/lib/files/getImportedExports.js +11 -7
  792. package/packages/analyze/src/lib/files/getImportedExports.js.map +1 -1
  793. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js +880 -0
  794. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js.map +1 -0
  795. package/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.js +170 -40
  796. package/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.js.map +1 -1
  797. package/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.js +85 -0
  798. package/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.js.map +1 -0
  799. package/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.js +253 -42
  800. package/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.js.map +1 -1
  801. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.js +29 -34
  802. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.js.map +1 -1
  803. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js +218 -20
  804. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js.map +1 -1
  805. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js +144 -0
  806. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js.map +1 -0
  807. package/packages/analyze/src/lib/files/scenarios/generateScenarioData.js +1 -0
  808. package/packages/analyze/src/lib/files/scenarios/generateScenarioData.js.map +1 -1
  809. package/packages/analyze/src/lib/files/scenarios/generateScenarios.js +2 -3
  810. package/packages/analyze/src/lib/files/scenarios/generateScenarios.js.map +1 -1
  811. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js +670 -53
  812. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js.map +1 -1
  813. package/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.js +46 -9
  814. package/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.js.map +1 -1
  815. package/packages/analyze/src/lib/files/setImportedExports.js +2 -1
  816. package/packages/analyze/src/lib/files/setImportedExports.js.map +1 -1
  817. package/packages/analyze/src/lib/index.js +1 -0
  818. package/packages/analyze/src/lib/index.js.map +1 -1
  819. package/packages/analyze/src/lib/utils/getFileByPath.js +12 -0
  820. package/packages/analyze/src/lib/utils/getFileByPath.js.map +1 -0
  821. package/packages/aws/src/lib/ecs/ecsDefineContainer.js +2 -2
  822. package/packages/aws/src/lib/ecs/ecsDefineContainer.js.map +1 -1
  823. package/packages/aws/src/lib/ecs/ecsTaskFactory.js +17 -61
  824. package/packages/aws/src/lib/ecs/ecsTaskFactory.js.map +1 -1
  825. package/packages/database/src/lib/analysisBranchToDb.js +1 -1
  826. package/packages/database/src/lib/analysisBranchToDb.js.map +1 -1
  827. package/packages/database/src/lib/analysisToDb.js +1 -1
  828. package/packages/database/src/lib/analysisToDb.js.map +1 -1
  829. package/packages/database/src/lib/branchToDb.js +1 -1
  830. package/packages/database/src/lib/branchToDb.js.map +1 -1
  831. package/packages/database/src/lib/commitBranchToDb.js +1 -1
  832. package/packages/database/src/lib/commitBranchToDb.js.map +1 -1
  833. package/packages/database/src/lib/commitToDb.js +1 -1
  834. package/packages/database/src/lib/commitToDb.js.map +1 -1
  835. package/packages/database/src/lib/fileToDb.js +1 -1
  836. package/packages/database/src/lib/fileToDb.js.map +1 -1
  837. package/packages/database/src/lib/kysely/db.js +11 -1
  838. package/packages/database/src/lib/kysely/db.js.map +1 -1
  839. package/packages/database/src/lib/kysely/tables/commitsTable.js +3 -0
  840. package/packages/database/src/lib/kysely/tables/commitsTable.js.map +1 -1
  841. package/packages/database/src/lib/kysely/tables/debugReportsTable.js.map +1 -1
  842. package/packages/database/src/lib/kysely/tables/labsRequestsTable.js +35 -0
  843. package/packages/database/src/lib/kysely/tables/labsRequestsTable.js.map +1 -0
  844. package/packages/database/src/lib/loadAnalyses.js +45 -2
  845. package/packages/database/src/lib/loadAnalyses.js.map +1 -1
  846. package/packages/database/src/lib/loadAnalysis.js +8 -0
  847. package/packages/database/src/lib/loadAnalysis.js.map +1 -1
  848. package/packages/database/src/lib/loadBranch.js +11 -1
  849. package/packages/database/src/lib/loadBranch.js.map +1 -1
  850. package/packages/database/src/lib/loadCommit.js +7 -0
  851. package/packages/database/src/lib/loadCommit.js.map +1 -1
  852. package/packages/database/src/lib/loadCommits.js +22 -1
  853. package/packages/database/src/lib/loadCommits.js.map +1 -1
  854. package/packages/database/src/lib/loadEntities.js +23 -4
  855. package/packages/database/src/lib/loadEntities.js.map +1 -1
  856. package/packages/database/src/lib/loadEntityBranches.js +9 -0
  857. package/packages/database/src/lib/loadEntityBranches.js.map +1 -1
  858. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js +7 -4
  859. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  860. package/packages/database/src/lib/projectToDb.js +1 -1
  861. package/packages/database/src/lib/projectToDb.js.map +1 -1
  862. package/packages/database/src/lib/saveFiles.js +1 -1
  863. package/packages/database/src/lib/saveFiles.js.map +1 -1
  864. package/packages/database/src/lib/scenarioToDb.js +1 -1
  865. package/packages/database/src/lib/scenarioToDb.js.map +1 -1
  866. package/packages/database/src/lib/updateCommitMetadata.js +5 -4
  867. package/packages/database/src/lib/updateCommitMetadata.js.map +1 -1
  868. package/packages/generate/index.js +3 -0
  869. package/packages/generate/index.js.map +1 -1
  870. package/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js +16 -1
  871. package/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js.map +1 -1
  872. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +189 -0
  873. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -0
  874. package/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js +53 -0
  875. package/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js.map +1 -0
  876. package/packages/generate/src/lib/scenarioComponentForServer.js +89 -0
  877. package/packages/generate/src/lib/scenarioComponentForServer.js.map +1 -0
  878. package/packages/github/src/lib/loadOrCreateCommit.js +10 -0
  879. package/packages/github/src/lib/loadOrCreateCommit.js.map +1 -1
  880. package/packages/github/src/lib/syncPrimaryBranch.js +3 -0
  881. package/packages/github/src/lib/syncPrimaryBranch.js.map +1 -1
  882. package/packages/process/index.js +3 -0
  883. package/packages/process/index.js.map +1 -0
  884. package/packages/process/src/GlobalProcessManager.js.map +1 -0
  885. package/{background/src/lib/process → packages/process/src}/ProcessManager.js +1 -1
  886. package/packages/process/src/ProcessManager.js.map +1 -0
  887. package/packages/process/src/index.js.map +1 -0
  888. package/packages/process/src/managedExecAsync.js.map +1 -0
  889. package/packages/types/index.js +0 -1
  890. package/packages/types/index.js.map +1 -1
  891. package/packages/types/src/types/Scenario.js +1 -21
  892. package/packages/types/src/types/Scenario.js.map +1 -1
  893. package/packages/utils/src/lib/fs/rsyncCopy.js +93 -2
  894. package/packages/utils/src/lib/fs/rsyncCopy.js.map +1 -1
  895. package/packages/utils/src/lib/safeFileName.js +29 -3
  896. package/packages/utils/src/lib/safeFileName.js.map +1 -1
  897. package/scripts/finalize-analyzer.cjs +8 -76
  898. package/analyzer-template/packages/ai/src/lib/findMatchingAttribute.ts +0 -102
  899. package/analyzer-template/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.ts +0 -409
  900. package/analyzer-template/packages/ai/src/lib/generateChangesEntityKeyAttributes.ts +0 -288
  901. package/analyzer-template/packages/ai/src/lib/generateEntityKeyAttributes.ts +0 -495
  902. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.ts +0 -67
  903. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.ts +0 -120
  904. package/analyzer-template/process/INTEGRATION_COMPLETE.md +0 -333
  905. package/analyzer-template/process/INTEGRATION_EXAMPLE.md +0 -525
  906. package/analyzer-template/process/README.md +0 -507
  907. package/background/src/lib/process/GlobalProcessManager.js.map +0 -1
  908. package/background/src/lib/process/ProcessManager.js.map +0 -1
  909. package/background/src/lib/process/index.js.map +0 -1
  910. package/background/src/lib/process/managedExecAsync.js.map +0 -1
  911. package/codeyam-cli/src/webserver/build/client/assets/EntityItem-wXL1Z2Aq.js +0 -1
  912. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeIcon-CXFKsCOD.js +0 -41
  913. package/codeyam-cli/src/webserver/build/client/assets/InteractivePreview-D-9pXIaY.js +0 -25
  914. package/codeyam-cli/src/webserver/build/client/assets/ReportIssueModal-4lcOlid-.js +0 -11
  915. package/codeyam-cli/src/webserver/build/client/assets/ScenarioViewer-CUxUNEEC.js +0 -15
  916. package/codeyam-cli/src/webserver/build/client/assets/_index-DHImXdXq.js +0 -11
  917. package/codeyam-cli/src/webserver/build/client/assets/activity.(_tab)-CVP_WGQ3.js +0 -32
  918. package/codeyam-cli/src/webserver/build/client/assets/chunk-JMJ3UQ3L-BambyYE_.js +0 -51
  919. package/codeyam-cli/src/webserver/build/client/assets/cy-logo-cli-CKnwPCDr.js +0 -1
  920. package/codeyam-cli/src/webserver/build/client/assets/dev.empty-DW_hdGUc.js +0 -1
  921. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.fullscreen-DyB90fWk.js +0 -1
  922. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-D_3ero5o.js +0 -1
  923. package/codeyam-cli/src/webserver/build/client/assets/files-ClR0d32A.js +0 -1
  924. package/codeyam-cli/src/webserver/build/client/assets/globals-C9s7Lhdl.css +0 -1
  925. package/codeyam-cli/src/webserver/build/client/assets/keyAttributeCoverage-CTlFMihX.js +0 -1
  926. package/codeyam-cli/src/webserver/build/client/assets/manifest-0d27da29.js +0 -1
  927. package/codeyam-cli/src/webserver/build/client/assets/root-B_wIKCIf.js +0 -56
  928. package/codeyam-cli/src/webserver/build/client/assets/settings-DgTyB-Wg.js +0 -1
  929. package/codeyam-cli/src/webserver/build/client/assets/simulations-CoNWGt0K.js +0 -1
  930. package/codeyam-cli/src/webserver/build/client/assets/useCustomSizes-BMIGFP-m.js +0 -1
  931. package/codeyam-cli/src/webserver/build/client/assets/useInteractiveMode-Dk_FQqWJ.js +0 -1
  932. package/codeyam-cli/src/webserver/build/client/assets/useReportContext-DsJbgMY9.js +0 -1
  933. package/codeyam-cli/src/webserver/build/server/assets/index-CU58-Ttc.js +0 -1
  934. package/codeyam-cli/src/webserver/build/server/assets/server-build-D35o2uae.js +0 -175
  935. package/codeyam-cli/templates/debug-codeyam.md +0 -625
  936. package/packages/ai/src/lib/findMatchingAttribute.js +0 -77
  937. package/packages/ai/src/lib/findMatchingAttribute.js.map +0 -1
  938. package/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.js +0 -298
  939. package/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.js.map +0 -1
  940. package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js +0 -226
  941. package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js.map +0 -1
  942. package/packages/ai/src/lib/generateEntityKeyAttributes.js +0 -408
  943. package/packages/ai/src/lib/generateEntityKeyAttributes.js.map +0 -1
  944. package/packages/ai/src/lib/isFrontend.js +0 -5
  945. package/packages/ai/src/lib/isFrontend.js.map +0 -1
  946. package/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.js +0 -40
  947. package/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.js.map +0 -1
  948. package/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.js +0 -77
  949. package/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.js.map +0 -1
  950. /package/analyzer-template/{process → packages/process/src}/GlobalProcessManager.ts +0 -0
  951. /package/analyzer-template/{process → packages/process/src}/ProcessManager.ts +0 -0
  952. /package/analyzer-template/{process → packages/process/src}/index.ts +0 -0
  953. /package/analyzer-template/{process → packages/process/src}/managedExecAsync.ts +0 -0
  954. /package/codeyam-cli/src/webserver/build/client/assets/{api.link-scenario-value-l0sNRNKZ.js → api.agent-transcripts-l0sNRNKZ.js} +0 -0
  955. /package/codeyam-cli/src/webserver/build/client/assets/{api.update-key-attributes-l0sNRNKZ.js → api.health-l0sNRNKZ.js} +0 -0
  956. /package/codeyam-cli/src/webserver/build/client/assets/{api.update-valid-values-l0sNRNKZ.js → api.labs-unlock-l0sNRNKZ.js} +0 -0
  957. /package/{background/src/lib/process → packages/process/src}/GlobalProcessManager.js +0 -0
  958. /package/{background/src/lib/process → packages/process/src}/index.js +0 -0
  959. /package/{background/src/lib/process → packages/process/src}/managedExecAsync.js +0 -0
@@ -79,15 +79,29 @@
79
79
  * - `helpers/README.md` - Overview of the helper module architecture
80
80
  */
81
81
  import fillInSchemaGapsAndUnknowns from "./helpers/fillInSchemaGapsAndUnknowns.js";
82
+ import { clearCleanKnownObjectFunctionsCache } from "./helpers/cleanKnownObjectFunctions.js";
83
+ import { clearCleanNonObjectFunctionsCache } from "./helpers/cleanNonObjectFunctions.js";
84
+ /**
85
+ * Patterns that indicate recursive type structures in schema paths.
86
+ * Used by hasExcessivePatternRepetition() to detect exponential path blowup.
87
+ */
88
+ const RECURSIVE_PATH_PATTERNS = [
89
+ /\.attributes\.properties\[\]/g, // TypeScript AST JSX nodes
90
+ /\.children\[\]/g, // Tree structures
91
+ /\.elements\[\]/g, // Array-like structures
92
+ /\.members\[\]/g, // Class/interface members
93
+ /\.properties\[\]/g, // Object properties
94
+ /\.items\[\]/g, // Generic items arrays
95
+ ];
82
96
  import ensureSchemaConsistency from "./helpers/ensureSchemaConsistency.js";
83
97
  import cleanPath from "./helpers/cleanPath.js";
84
98
  import { PathManager } from "./helpers/PathManager.js";
85
- import { uniqueId, uniqueScopeVariables, uniqueScopeAndPaths, } from "./helpers/uniqueIdUtils.js";
99
+ import { uniqueId, uniqueScopeAndPaths, uniqueScopeVariables, } from "./helpers/uniqueIdUtils.js";
86
100
  import selectBestValue from "./helpers/selectBestValue.js";
87
101
  import { VisitedTracker } from "./helpers/VisitedTracker.js";
88
102
  import { DebugTracer } from "./helpers/DebugTracer.js";
89
103
  import { BatchSchemaProcessor } from "./helpers/BatchSchemaProcessor.js";
90
- import { ScopeTreeManager, ROOT_SCOPE_NAME, } from "./helpers/ScopeTreeManager.js";
104
+ import { ROOT_SCOPE_NAME, ScopeTreeManager, } from "./helpers/ScopeTreeManager.js";
91
105
  import cleanScopeNodeName from "./helpers/cleanScopeNodeName.js";
92
106
  import getFunctionCallRoot from "./helpers/getFunctionCallRoot.js";
93
107
  import cleanPathOfNonTransformingFunctions from "./helpers/cleanPathOfNonTransformingFunctions.js";
@@ -108,6 +122,17 @@ export function resetScopeDataStructureMetrics() {
108
122
  followEquivalenciesEarlyExitPhase1Count = 0;
109
123
  followEquivalenciesWithWorkCount = 0;
110
124
  addEquivalencyCallCount = 0;
125
+ // Clear module-level caches to prevent unbounded memory growth across entities
126
+ const knownObjectCache = clearCleanKnownObjectFunctionsCache();
127
+ const nonObjectCache = clearCleanNonObjectFunctionsCache();
128
+ if (knownObjectCache.count > 0 || nonObjectCache.count > 0) {
129
+ const totalBytes = knownObjectCache.estimatedBytes + nonObjectCache.estimatedBytes;
130
+ console.log('CodeYam: Cleared analysis caches', {
131
+ knownObjectCache: `${knownObjectCache.count} entries, ${(knownObjectCache.estimatedBytes / 1024).toFixed(1)}KB`,
132
+ nonObjectCache: `${nonObjectCache.count} entries, ${(nonObjectCache.estimatedBytes / 1024).toFixed(1)}KB`,
133
+ totalKB: `${(totalBytes / 1024).toFixed(1)}KB`,
134
+ });
135
+ }
111
136
  }
112
137
  // Performance: Pre-computed Sets for equivalency reason filtering (O(1) vs O(n))
113
138
  const ALLOWED_EQUIVALENCY_REASONS = new Set([
@@ -156,6 +181,7 @@ const SILENTLY_IGNORED_EQUIVALENCY_REASONS = new Set([
156
181
  'transformed non-object function equivalency - implicit parent equivalency - rerouted via useCallback',
157
182
  'transformed non-object function equivalency - Array.from() equivalency',
158
183
  'Spread operator equivalency key update: Explicit array deconstruction equivalency value',
184
+ // 'transformed non-object function equivalency - Explicit array deconstruction equivalency value',
159
185
  ]);
160
186
  export class ScopeDataStructure {
161
187
  // Getter for backward compatibility - returns the tree structure
@@ -176,6 +202,26 @@ export class ScopeDataStructure {
176
202
  * Maps local variable path to array of usages.
177
203
  */
178
204
  this.rawConditionalUsages = {};
205
+ /**
206
+ * Conditional effects collected during AST analysis.
207
+ * Tracks what setter calls happen inside conditionals (if, switch, ternary).
208
+ */
209
+ this.rawConditionalEffects = [];
210
+ /**
211
+ * Compound conditionals collected during AST analysis.
212
+ * Groups conditions that must all be true together (e.g., a && b && c).
213
+ */
214
+ this.rawCompoundConditionals = [];
215
+ /**
216
+ * Gating conditions for child component boundaries.
217
+ * Maps child component name to the conditions that must be true for it to render.
218
+ */
219
+ this.rawChildBoundaryGatingConditions = {};
220
+ /**
221
+ * JSX rendering usages collected during AST analysis.
222
+ * Tracks arrays rendered via .map() and strings interpolated in JSX.
223
+ */
224
+ this.rawJsxRenderingUsages = [];
179
225
  this.lastAddToSchemaId = 0;
180
226
  this.lastEquivalencyId = 0;
181
227
  this.lastEquivalencyDatabaseId = 0;
@@ -430,6 +476,10 @@ export class ScopeDataStructure {
430
476
  }
431
477
  return;
432
478
  }
479
+ // PERF: Early exit for paths with repeated function-call signature patterns
480
+ if (this.hasExcessivePatternRepetition(path)) {
481
+ return;
482
+ }
433
483
  // Update chain metadata for database tracking
434
484
  if (equivalencyValueChain.length > 0) {
435
485
  equivalencyValueChain[equivalencyValueChain.length - 1].addToSchemaId =
@@ -599,7 +649,6 @@ export class ScopeDataStructure {
599
649
  }
600
650
  addEquivalency(path, equivalentPath, equivalentScopeName, scopeNode, equivalencyReason, equivalencyValueChain, traceId) {
601
651
  var _a;
602
- // DEBUG: Detect infinite loops
603
652
  addEquivalencyCallCount++;
604
653
  if (addEquivalencyCallCount > 50000) {
605
654
  console.error('INFINITE LOOP DETECTED in addEquivalency', {
@@ -927,6 +976,12 @@ export class ScopeDataStructure {
927
976
  const value1 = scopeNode.schema[schemaPath];
928
977
  const value2 = equivalentScopeNode.schema[equivalentSchemaPath];
929
978
  const bestValue = selectBestValue(value1, value2);
979
+ // PERF: Skip paths with repeated function-call signature patterns
980
+ // to prevent recursive type expansion (e.g., string.localeCompare returns string)
981
+ if (this.hasExcessivePatternRepetition(schemaPath) ||
982
+ this.hasExcessivePatternRepetition(equivalentSchemaPath)) {
983
+ continue;
984
+ }
930
985
  scopeNode.schema[schemaPath] = bestValue;
931
986
  equivalentScopeNode.schema[equivalentSchemaPath] = bestValue;
932
987
  }
@@ -938,6 +993,10 @@ export class ScopeDataStructure {
938
993
  equivalentPath,
939
994
  ...remainingSchemaPathParts,
940
995
  ]);
996
+ // PERF: Skip paths with repeated function-call signature patterns
997
+ if (this.hasExcessivePatternRepetition(newEquivalentPath)) {
998
+ continue;
999
+ }
941
1000
  equivalentScopeNode.schema[newEquivalentPath] =
942
1001
  scopeNode.schema[schemaPath];
943
1002
  }
@@ -994,26 +1053,103 @@ export class ScopeDataStructure {
994
1053
  isValidPath(path) {
995
1054
  return this.pathManager.isValidPath(path);
996
1055
  }
1056
+ /**
1057
+ * Detects if a path contains excessive repetition of the same pattern.
1058
+ *
1059
+ * This prevents exponential blowup when analyzing recursive type structures.
1060
+ * For example, TypeScript AST nodes have `.attributes.properties[]` where each
1061
+ * property is also a node with `.attributes.properties[]`. Without this check,
1062
+ * paths like `signature[0].attributes.properties[].attributes.properties[].attributes.properties[]...`
1063
+ * would be generated exponentially.
1064
+ *
1065
+ * Two detection strategies:
1066
+ * 1. Known patterns: Check RECURSIVE_PATH_PATTERNS for common recursive structures
1067
+ * 2. Generic detection: For longer paths, detect any 2-3 part segment that repeats
1068
+ *
1069
+ * @param path - The schema path to check
1070
+ * @param maxRepetitions - Maximum allowed repetitions of any pattern (default: 2)
1071
+ * @returns true if the path has excessive repetition
1072
+ */
1073
+ hasExcessivePatternRepetition(path, maxRepetitions = 2) {
1074
+ // Check known recursive patterns
1075
+ for (const pattern of RECURSIVE_PATH_PATTERNS) {
1076
+ const matches = path.match(pattern);
1077
+ if (matches && matches.length > maxRepetitions) {
1078
+ return true;
1079
+ }
1080
+ }
1081
+ // Check for repeated function calls that indicate recursive type expansion.
1082
+ // E.g., localeCompare(b[])...localeCompare(b[]) means string.localeCompare
1083
+ // returns a type that again has localeCompare, causing infinite expansion.
1084
+ // We extract all function call patterns like "funcName(args)" and check if
1085
+ // the same normalized call appears more than once.
1086
+ const funcCallPattern = /(?:^|\.)[^.([]+\([^)]*\)/g;
1087
+ const funcCallMatches = path.match(funcCallPattern);
1088
+ if (funcCallMatches && funcCallMatches.length > 1) {
1089
+ const seen = new Set();
1090
+ for (const match of funcCallMatches) {
1091
+ // Strip leading dot and normalize array indices
1092
+ const normalized = match.replace(/^\./, '').replace(/\[\d+\]/g, '[]');
1093
+ if (seen.has(normalized))
1094
+ return true;
1095
+ seen.add(normalized);
1096
+ }
1097
+ }
1098
+ // For longer paths, detect any repeated multi-part segments we haven't explicitly listed
1099
+ const pathParts = this.splitPath(path);
1100
+ if (pathParts.length <= 6) {
1101
+ return false;
1102
+ }
1103
+ // Check for repeated sequences of 2-3 consecutive parts
1104
+ for (let segmentLength = 2; segmentLength <= 3; segmentLength++) {
1105
+ const seen = new Map();
1106
+ for (let i = 0; i <= pathParts.length - segmentLength; i++) {
1107
+ const segment = pathParts.slice(i, i + segmentLength).join('.');
1108
+ const normalizedSegment = segment.replace(/\[\d+\]/g, '[]');
1109
+ const count = (seen.get(normalizedSegment) || 0) + 1;
1110
+ seen.set(normalizedSegment, count);
1111
+ if (count > maxRepetitions) {
1112
+ return true;
1113
+ }
1114
+ }
1115
+ }
1116
+ return false;
1117
+ }
997
1118
  addToTree(pathParts) {
998
1119
  this.scopeTreeManager.addPath(pathParts);
999
1120
  }
1000
1121
  setInstantiatedVariables(scopeNode) {
1001
1122
  let instantiatedVariables = scopeNode.analysis?.instantiatedVariables ?? [];
1002
- for (const [path, equivalentPath] of Object.entries(scopeNode.analysis.isolatedEquivalentVariables ?? {})) {
1003
- if (typeof equivalentPath !== 'string') {
1004
- continue;
1005
- }
1006
- if (equivalentPath.startsWith('signature[')) {
1007
- const equivalentPathParts = this.splitPath(equivalentPath);
1008
- instantiatedVariables.push(equivalentPathParts[0]);
1009
- instantiatedVariables.push(path);
1123
+ for (const [path, rawEquivalentPath] of Object.entries(scopeNode.analysis.isolatedEquivalentVariables ?? {})) {
1124
+ // Normalize to array for consistent handling (supports both string and string[])
1125
+ const equivalentPaths = Array.isArray(rawEquivalentPath)
1126
+ ? rawEquivalentPath
1127
+ : rawEquivalentPath
1128
+ ? [rawEquivalentPath]
1129
+ : [];
1130
+ for (const equivalentPath of equivalentPaths) {
1131
+ if (typeof equivalentPath !== 'string') {
1132
+ continue;
1133
+ }
1134
+ if (equivalentPath.startsWith('signature[')) {
1135
+ const equivalentPathParts = this.splitPath(equivalentPath);
1136
+ instantiatedVariables.push(equivalentPathParts[0]);
1137
+ instantiatedVariables.push(path);
1138
+ }
1010
1139
  }
1011
1140
  const duplicateInstantiated = instantiatedVariables.find((v) => path.split('::cyDuplicateKey')[0] === v.split('::cyDuplicateKey')[0]);
1012
1141
  if (duplicateInstantiated) {
1013
1142
  instantiatedVariables.push(path);
1014
1143
  }
1015
1144
  }
1016
- instantiatedVariables = instantiatedVariables.filter((varName, index, self) => self.indexOf(varName) === index);
1145
+ const instantiatedSeen = new Set();
1146
+ instantiatedVariables = instantiatedVariables.filter((varName) => {
1147
+ if (instantiatedSeen.has(varName)) {
1148
+ return false;
1149
+ }
1150
+ instantiatedSeen.add(varName);
1151
+ return true;
1152
+ });
1017
1153
  scopeNode.instantiatedVariables = instantiatedVariables;
1018
1154
  if (!scopeNode.tree || scopeNode.tree.length === 0) {
1019
1155
  return;
@@ -1025,125 +1161,156 @@ export class ScopeDataStructure {
1025
1161
  const parentInstantiatedVariables = [
1026
1162
  ...(parentScopeNode.parentInstantiatedVariables ?? []),
1027
1163
  ...parentScopeNode.instantiatedVariables.filter((v) => !v.startsWith('signature[') && !v.startsWith('returnValue')),
1028
- ].filter((varName, index, self) => !instantiatedVariables.includes(varName) &&
1029
- self.indexOf(varName) === index);
1030
- scopeNode.parentInstantiatedVariables = parentInstantiatedVariables;
1164
+ ].filter((varName) => !instantiatedSeen.has(varName));
1165
+ const parentInstantiatedSeen = new Set();
1166
+ const dedupedParentInstantiatedVariables = parentInstantiatedVariables.filter((varName) => {
1167
+ if (parentInstantiatedSeen.has(varName)) {
1168
+ return false;
1169
+ }
1170
+ parentInstantiatedSeen.add(varName);
1171
+ return true;
1172
+ });
1173
+ scopeNode.parentInstantiatedVariables = dedupedParentInstantiatedVariables;
1031
1174
  }
1032
1175
  trackFunctionCalls(scopeNode) {
1033
1176
  this.captureFunctionCalls(scopeNode);
1034
1177
  this.checkExternalFunctionCalls();
1035
1178
  }
1036
1179
  determineEquivalenciesAndBuildSchema(scopeNode) {
1037
- const { isolatedStructure, isolatedEquivalentVariables } = scopeNode.analysis;
1038
- // DEBUG: Log all equivalencies related to useFetcher
1039
- if (Object.keys(isolatedEquivalentVariables || {}).some((k) => k.includes('Fetcher') || k.includes('fetcher'))) {
1040
- console.log('CodeYam DEBUG determineEquivalenciesAndBuildSchema:', JSON.stringify({
1041
- scopeNodeName: scopeNode.name,
1042
- fetcherEquivalencies: Object.entries(isolatedEquivalentVariables || {})
1043
- .filter(([k, v]) => k.includes('Fetcher') ||
1044
- k.includes('fetcher') ||
1045
- String(v).includes('Fetcher') ||
1046
- String(v).includes('fetcher'))
1047
- .reduce((acc, [k, v]) => {
1048
- acc[k] = v;
1049
- return acc;
1050
- }, {}),
1051
- }, null, 2));
1180
+ if (!scopeNode.analysis) {
1181
+ return;
1052
1182
  }
1183
+ const { isolatedStructure, isolatedEquivalentVariables } = scopeNode.analysis;
1184
+ // Flatten isolatedEquivalentVariables values for allPaths (handles both string and string[])
1185
+ const flattenedEquivValues = Object.values(isolatedEquivalentVariables || {}).flatMap((v) => (Array.isArray(v) ? v : [v]));
1053
1186
  const allPaths = Array.from(new Set([
1054
1187
  ...Object.keys(isolatedStructure || {}),
1055
1188
  ...Object.keys(isolatedEquivalentVariables || {}),
1056
- ...Object.values(isolatedEquivalentVariables || {}),
1189
+ ...flattenedEquivValues,
1057
1190
  ]));
1058
1191
  for (let path in isolatedEquivalentVariables) {
1059
- let equivalentValue = isolatedEquivalentVariables?.[path];
1060
- if (equivalentValue && this.isValidPath(equivalentValue)) {
1061
- path = cleanPath(path.replace(/::cyDuplicateKey\d+::/g, ''), allPaths);
1062
- equivalentValue = cleanPath(equivalentValue.replace(/::cyDuplicateKey\d+::/g, ''), allPaths);
1063
- this.addEquivalency(path, equivalentValue, scopeNode.name, scopeNode, 'original equivalency');
1064
- // Propagate equivalencies involving parent-scope variables to those parent scopes.
1065
- // This handles patterns like: collected.push({...entity}) where 'collected' is defined
1066
- // in a parent scope. The equivalency collected[] -> push().signature[0] needs to be
1067
- // visible when tracing from the parent scope.
1068
- const rootVariable = this.extractRootVariable(path);
1069
- const equivalentRootVariable = this.extractRootVariable(equivalentValue);
1070
- // Skip propagation for self-referential reassignment patterns like:
1071
- // x = x.method().functionCallReturnValue
1072
- // where the path IS the variable itself (not a sub-path like x[] or x.prop).
1073
- // These create circular references since both sides reference the same variable.
1074
- //
1075
- // But DO propagate for patterns like collected[] -> collected.push(...).signature[0]
1076
- // where the path has additional segments beyond the root variable.
1077
- const pathIsJustRootVariable = path === rootVariable;
1078
- const isSelfReferentialReassignment = pathIsJustRootVariable && rootVariable === equivalentRootVariable;
1079
- if (rootVariable &&
1080
- !isSelfReferentialReassignment &&
1081
- scopeNode.parentInstantiatedVariables?.includes(rootVariable)) {
1082
- // Find the parent scope where this variable is defined
1083
- for (const parentScopeName of scopeNode.tree || []) {
1084
- const parentScope = this.scopeNodes[parentScopeName];
1085
- if (parentScope?.instantiatedVariables?.includes(rootVariable)) {
1086
- // Add the equivalency to the parent scope as well
1087
- this.addEquivalency(path, equivalentValue, scopeNode.name, // The equivalent path's scope remains the child scope
1088
- parentScope, // But store it in the parent scope's equivalencies
1089
- 'propagated parent-variable equivalency');
1090
- break;
1192
+ const rawEquivalentValue = isolatedEquivalentVariables?.[path];
1193
+ // Normalize to array for consistent handling
1194
+ const equivalentValues = Array.isArray(rawEquivalentValue)
1195
+ ? rawEquivalentValue
1196
+ : [rawEquivalentValue];
1197
+ for (let equivalentValue of equivalentValues) {
1198
+ if (equivalentValue && this.isValidPath(equivalentValue)) {
1199
+ // IMPORTANT: DO NOT strip ::cyDuplicateKey:: markers from equivalencies.
1200
+ // These markers are critical for distinguishing variable reassignments.
1201
+ // For example, with:
1202
+ // let fetcher = useFetcher<ConfigData>();
1203
+ // const configData = fetcher.data?.data;
1204
+ // fetcher = useFetcher<SettingsData>();
1205
+ // const settingsData = fetcher.data?.data;
1206
+ //
1207
+ // mergeStatements creates:
1208
+ // fetcher useFetcher<ConfigData>()...
1209
+ // fetcher::cyDuplicateKey1:: useFetcher<SettingsData>()...
1210
+ // configData fetcher.data.data
1211
+ // settingsData fetcher::cyDuplicateKey1::.data.data
1212
+ //
1213
+ // If we strip ::cyDuplicateKey::, settingsData would incorrectly trace
1214
+ // to useFetcher<ConfigData>() instead of useFetcher<SettingsData>().
1215
+ path = cleanPath(path, allPaths);
1216
+ equivalentValue = cleanPath(equivalentValue, allPaths);
1217
+ this.addEquivalency(path, equivalentValue, scopeNode.name, scopeNode, 'original equivalency');
1218
+ // Propagate equivalencies involving parent-scope variables to those parent scopes.
1219
+ // This handles patterns like: collected.push({...entity}) where 'collected' is defined
1220
+ // in a parent scope. The equivalency collected[] -> push().signature[0] needs to be
1221
+ // visible when tracing from the parent scope.
1222
+ const rootVariable = this.extractRootVariable(path);
1223
+ const equivalentRootVariable = this.extractRootVariable(equivalentValue);
1224
+ // Skip propagation for self-referential reassignment patterns like:
1225
+ // x = x.method().functionCallReturnValue
1226
+ // where the path IS the variable itself (not a sub-path like x[] or x.prop).
1227
+ // These create circular references since both sides reference the same variable.
1228
+ //
1229
+ // But DO propagate for patterns like collected[] -> collected.push(...).signature[0]
1230
+ // where the path has additional segments beyond the root variable.
1231
+ const pathIsJustRootVariable = path === rootVariable;
1232
+ const isSelfReferentialReassignment = pathIsJustRootVariable && rootVariable === equivalentRootVariable;
1233
+ if (rootVariable &&
1234
+ !isSelfReferentialReassignment &&
1235
+ scopeNode.parentInstantiatedVariables?.includes(rootVariable)) {
1236
+ // Find the parent scope where this variable is defined
1237
+ for (const parentScopeName of scopeNode.tree || []) {
1238
+ const parentScope = this.scopeNodes[parentScopeName];
1239
+ if (parentScope?.instantiatedVariables?.includes(rootVariable)) {
1240
+ // Add the equivalency to the parent scope as well
1241
+ this.addEquivalency(path, equivalentValue, scopeNode.name, // The equivalent path's scope remains the child scope
1242
+ parentScope, // But store it in the parent scope's equivalencies
1243
+ 'propagated parent-variable equivalency');
1244
+ break;
1245
+ }
1091
1246
  }
1092
1247
  }
1093
- }
1094
- // Propagate sub-property equivalencies when the equivalentValue is a simple variable
1095
- // that has sub-properties defined in the isolatedEquivalentVariables.
1096
- // This handles cases like: dataItem={{ structure: completeDataStructure }}
1097
- // where completeDataStructure has sub-properties like completeDataStructure['Function Arguments']
1098
- // We need to propagate these to create: dataItem.structure['Function Arguments'] equivalencies
1099
- const isSimpleVariable = !equivalentValue.startsWith('signature[') &&
1100
- !equivalentValue.includes('functionCallReturnValue') &&
1101
- !equivalentValue.includes('.') &&
1102
- !equivalentValue.includes('[');
1103
- if (isSimpleVariable) {
1104
- // Look in current scope and all parent scopes for sub-properties
1105
- const scopesToCheck = [scopeNode.name, ...scopeNode.tree];
1106
- for (const scopeName of scopesToCheck) {
1107
- const checkScope = this.scopeNodes[scopeName];
1108
- if (!checkScope?.analysis?.isolatedEquivalentVariables)
1109
- continue;
1110
- for (const [subPath, subValue] of Object.entries(checkScope.analysis.isolatedEquivalentVariables)) {
1111
- // Check if this is a sub-property of the equivalentValue variable
1112
- // e.g., completeDataStructure['Function Arguments'] or completeDataStructure.foo
1113
- const matchesDot = subPath.startsWith(equivalentValue + '.');
1114
- const matchesBracket = subPath.startsWith(equivalentValue + '[');
1115
- if (matchesDot || matchesBracket) {
1116
- const subPropertyPath = subPath.substring(equivalentValue.length);
1117
- const newPath = cleanPath(path + subPropertyPath, allPaths);
1118
- const newEquivalentValue = cleanPath(subValue.replace(/::cyDuplicateKey\d+::/g, ''), allPaths);
1119
- if (newEquivalentValue &&
1120
- this.isValidPath(newEquivalentValue)) {
1121
- this.addEquivalency(newPath, newEquivalentValue, checkScope.name, // Use the scope where the sub-property was found
1122
- scopeNode, 'propagated sub-property equivalency');
1248
+ // Propagate sub-property equivalencies when the equivalentValue is a simple variable
1249
+ // that has sub-properties defined in the isolatedEquivalentVariables.
1250
+ // This handles cases like: dataItem={{ structure: completeDataStructure }}
1251
+ // where completeDataStructure has sub-properties like completeDataStructure['Function Arguments']
1252
+ // We need to propagate these to create: dataItem.structure['Function Arguments'] equivalencies
1253
+ const isSimpleVariable = !equivalentValue.startsWith('signature[') &&
1254
+ !equivalentValue.includes('functionCallReturnValue') &&
1255
+ !equivalentValue.includes('.') &&
1256
+ !equivalentValue.includes('[');
1257
+ if (isSimpleVariable) {
1258
+ // Look in current scope and all parent scopes for sub-properties
1259
+ const scopesToCheck = [scopeNode.name, ...scopeNode.tree];
1260
+ for (const scopeName of scopesToCheck) {
1261
+ const checkScope = this.scopeNodes[scopeName];
1262
+ if (!checkScope?.analysis?.isolatedEquivalentVariables)
1263
+ continue;
1264
+ for (const [subPath, rawSubValue] of Object.entries(checkScope.analysis.isolatedEquivalentVariables)) {
1265
+ // Normalize to array for consistent handling
1266
+ const subValues = Array.isArray(rawSubValue)
1267
+ ? rawSubValue
1268
+ : rawSubValue
1269
+ ? [rawSubValue]
1270
+ : [];
1271
+ // Check if this is a sub-property of the equivalentValue variable
1272
+ // e.g., completeDataStructure['Function Arguments'] or completeDataStructure.foo
1273
+ const matchesDot = subPath.startsWith(equivalentValue + '.');
1274
+ const matchesBracket = subPath.startsWith(equivalentValue + '[');
1275
+ if (matchesDot || matchesBracket) {
1276
+ const subPropertyPath = subPath.substring(equivalentValue.length);
1277
+ const newPath = cleanPath(path + subPropertyPath, allPaths);
1278
+ for (const subValue of subValues) {
1279
+ if (typeof subValue !== 'string')
1280
+ continue;
1281
+ const newEquivalentValue = cleanPath(subValue.replace(/::cyDuplicateKey\d+::/g, ''), allPaths);
1282
+ if (newEquivalentValue &&
1283
+ this.isValidPath(newEquivalentValue)) {
1284
+ this.addEquivalency(newPath, newEquivalentValue, checkScope.name, // Use the scope where the sub-property was found
1285
+ scopeNode, 'propagated sub-property equivalency');
1286
+ }
1287
+ }
1288
+ }
1289
+ // Also check if equivalentValue itself maps to a functionCallReturnValue
1290
+ // e.g., result = useMemo(...).functionCallReturnValue
1291
+ for (const subValue of subValues) {
1292
+ if (subPath === equivalentValue &&
1293
+ typeof subValue === 'string' &&
1294
+ subValue.endsWith('.functionCallReturnValue')) {
1295
+ this.propagateFunctionCallReturnSubProperties(path, subValue, scopeNode, allPaths);
1296
+ }
1123
1297
  }
1124
- }
1125
- // Also check if equivalentValue itself maps to a functionCallReturnValue
1126
- // e.g., result = useMemo(...).functionCallReturnValue
1127
- if (subPath === equivalentValue &&
1128
- typeof subValue === 'string' &&
1129
- subValue.endsWith('.functionCallReturnValue')) {
1130
- this.propagateFunctionCallReturnSubProperties(path, subValue, scopeNode, allPaths);
1131
1298
  }
1132
1299
  }
1133
1300
  }
1134
- }
1135
- // Handle function call return values by propagating returnValue.* sub-properties
1136
- // from the callback scope to the usage path
1137
- if (equivalentValue.endsWith('.functionCallReturnValue')) {
1138
- this.propagateFunctionCallReturnSubProperties(path, equivalentValue, scopeNode, allPaths);
1139
- // Track which variable receives the return value of each function call
1140
- // This enables generating separate mock data for each call site
1141
- this.trackReceivingVariable(path, equivalentValue);
1142
- }
1143
- // Also track variables that receive destructured properties from function call return values
1144
- // e.g., "userData" -> "db.query('users').functionCallReturnValue.data"
1145
- if (equivalentValue.includes('.functionCallReturnValue.')) {
1146
- this.trackReceivingVariable(path, equivalentValue);
1301
+ // Handle function call return values by propagating returnValue.* sub-properties
1302
+ // from the callback scope to the usage path
1303
+ if (equivalentValue.endsWith('.functionCallReturnValue')) {
1304
+ this.propagateFunctionCallReturnSubProperties(path, equivalentValue, scopeNode, allPaths);
1305
+ // Track which variable receives the return value of each function call
1306
+ // This enables generating separate mock data for each call site
1307
+ this.trackReceivingVariable(path, equivalentValue);
1308
+ }
1309
+ // Also track variables that receive destructured properties from function call return values
1310
+ // e.g., "userData" -> "db.query('users').functionCallReturnValue.data"
1311
+ if (equivalentValue.includes('.functionCallReturnValue.')) {
1312
+ this.trackReceivingVariable(path, equivalentValue);
1313
+ }
1147
1314
  }
1148
1315
  }
1149
1316
  }
@@ -1151,7 +1318,7 @@ export class ScopeDataStructure {
1151
1318
  // This eliminates deep call stacks and improves deduplication
1152
1319
  this.batchProcessor = new BatchSchemaProcessor();
1153
1320
  this.batchQueuedSet = new Set();
1154
- for (const key of Array.from(allPaths)) {
1321
+ for (const key of allPaths) {
1155
1322
  let value = isolatedStructure[key] ?? 'unknown';
1156
1323
  if (['null', 'undefined'].includes(value)) {
1157
1324
  value = 'unknown';
@@ -1185,7 +1352,14 @@ export class ScopeDataStructure {
1185
1352
  processBatchQueue() {
1186
1353
  if (!this.batchProcessor)
1187
1354
  return;
1355
+ let iterations = 0;
1188
1356
  while (this.batchProcessor.hasWork()) {
1357
+ iterations++;
1358
+ // Safety: detect potential infinite loops
1359
+ if (iterations > 100000) {
1360
+ console.error(`[ScopeDataStructure] processBatchQueue exceeded 100k iterations, possible infinite loop!`);
1361
+ break;
1362
+ }
1189
1363
  const item = this.batchProcessor.getNextWork();
1190
1364
  if (!item)
1191
1365
  break;
@@ -1232,18 +1406,6 @@ export class ScopeDataStructure {
1232
1406
  // Find the FunctionCallInfo that matches this call signature
1233
1407
  const searchKey = getFunctionCallRoot(callSignature);
1234
1408
  const functionCallInfo = this.getExternalFunctionCallsIndex().get(searchKey);
1235
- // DEBUG: Track useFetcher calls
1236
- if (searchKey === 'useFetcher' || callSignature.includes('useFetcher')) {
1237
- console.log('CodeYam DEBUG trackReceivingVariable:', JSON.stringify({
1238
- receivingVariable,
1239
- equivalentValue,
1240
- callSignature,
1241
- searchKey,
1242
- foundFunctionCallInfo: !!functionCallInfo,
1243
- existingRecvVars: functionCallInfo?.receivingVariableNames,
1244
- existingCallSigToVar: functionCallInfo?.callSignatureToVariable,
1245
- }, null, 2));
1246
- }
1247
1409
  if (!functionCallInfo) {
1248
1410
  return;
1249
1411
  }
@@ -1292,8 +1454,15 @@ export class ScopeDataStructure {
1292
1454
  const checkScope = this.scopeNodes[scopeName];
1293
1455
  if (!checkScope?.analysis?.isolatedEquivalentVariables)
1294
1456
  continue;
1295
- const functionRef = checkScope.analysis.isolatedEquivalentVariables[functionName];
1296
- if (typeof functionRef === 'string' && functionRef.endsWith('F')) {
1457
+ const rawFunctionRef = checkScope.analysis.isolatedEquivalentVariables[functionName];
1458
+ // Normalize to array and find first string ending with 'F'
1459
+ const functionRefs = Array.isArray(rawFunctionRef)
1460
+ ? rawFunctionRef
1461
+ : rawFunctionRef
1462
+ ? [rawFunctionRef]
1463
+ : [];
1464
+ const functionRef = functionRefs.find((r) => typeof r === 'string' && r.endsWith('F'));
1465
+ if (typeof functionRef === 'string') {
1297
1466
  callbackScopeName = functionRef.slice(0, -1);
1298
1467
  break;
1299
1468
  }
@@ -1316,22 +1485,32 @@ export class ScopeDataStructure {
1316
1485
  if (!callbackScope.analysis?.isolatedEquivalentVariables)
1317
1486
  return;
1318
1487
  const isolatedVars = callbackScope.analysis.isolatedEquivalentVariables;
1488
+ // Get the first returnValue equivalency (normalize array to single value for these checks)
1489
+ const rawReturnValue = isolatedVars.returnValue;
1490
+ const firstReturnValue = Array.isArray(rawReturnValue)
1491
+ ? rawReturnValue[0]
1492
+ : rawReturnValue;
1319
1493
  // First, check if returnValue is an alias to another variable (e.g., returnValue = intermediate)
1320
1494
  // If so, we need to look for that variable's sub-properties too
1321
- const returnValueAlias = typeof isolatedVars.returnValue === 'string' &&
1322
- !isolatedVars.returnValue.includes('.')
1323
- ? isolatedVars.returnValue
1495
+ const returnValueAlias = typeof firstReturnValue === 'string' && !firstReturnValue.includes('.')
1496
+ ? firstReturnValue
1324
1497
  : undefined;
1325
1498
  // Pattern 3: Object.keys(X).reduce() - the reduce result has the same sub-properties as X
1326
1499
  // When returnValue = "Object.keys(source).reduce(...).functionCallReturnValue", look for source.* sub-properties
1327
1500
  let reduceSourceVar;
1328
- if (typeof isolatedVars.returnValue === 'string') {
1329
- const reduceMatch = isolatedVars.returnValue.match(/^Object\.keys\((\w+)\)\.reduce\(.*\)\.functionCallReturnValue$/);
1501
+ if (typeof firstReturnValue === 'string') {
1502
+ const reduceMatch = firstReturnValue.match(/^Object\.keys\((\w+)\)\.reduce\(.*\)\.functionCallReturnValue$/);
1330
1503
  if (reduceMatch) {
1331
1504
  reduceSourceVar = reduceMatch[1];
1332
1505
  }
1333
1506
  }
1334
- for (const [subPath, subValue] of Object.entries(isolatedVars)) {
1507
+ for (const [subPath, rawSubValue] of Object.entries(isolatedVars)) {
1508
+ // Normalize to array for consistent handling
1509
+ const subValues = Array.isArray(rawSubValue)
1510
+ ? rawSubValue
1511
+ : rawSubValue
1512
+ ? [rawSubValue]
1513
+ : [];
1335
1514
  // Check for direct returnValue.* sub-properties
1336
1515
  const isReturnValueSub = subPath.startsWith('returnValue.') ||
1337
1516
  subPath.startsWith('returnValue[');
@@ -1343,33 +1522,36 @@ export class ScopeDataStructure {
1343
1522
  const isReduceSourceSub = reduceSourceVar &&
1344
1523
  (subPath.startsWith(reduceSourceVar + '.') ||
1345
1524
  subPath.startsWith(reduceSourceVar + '['));
1346
- if (typeof subValue !== 'string' ||
1347
- (!isReturnValueSub && !isAliasSub && !isReduceSourceSub))
1348
- continue;
1349
- // Convert alias/reduceSource paths to returnValue paths
1350
- let effectiveSubPath = subPath;
1351
- if (isAliasSub && !isReturnValueSub) {
1352
- // Replace the alias prefix with returnValue
1353
- effectiveSubPath =
1354
- 'returnValue' + subPath.substring(returnValueAlias.length);
1355
- }
1356
- else if (isReduceSourceSub && !isReturnValueSub && !isAliasSub) {
1357
- // Replace the reduce source prefix with returnValue
1358
- effectiveSubPath =
1359
- 'returnValue' + subPath.substring(reduceSourceVar.length);
1360
- }
1361
- const subPropertyPath = effectiveSubPath.substring('returnValue'.length);
1362
- const newPath = cleanPath(path + subPropertyPath, allPaths);
1363
- let newEquivalentValue = cleanPath(subValue.replace(/::cyDuplicateKey\d+::/g, ''), allPaths);
1364
- // Resolve variable references through parent scope equivalencies
1365
- const resolved = this.resolveVariableThroughParentScopes(newEquivalentValue, callbackScope, allPaths);
1366
- newEquivalentValue = resolved.resolvedPath;
1367
- const equivalentScopeName = resolved.scopeName;
1368
- if (!newEquivalentValue || !this.isValidPath(newEquivalentValue))
1525
+ if (!isReturnValueSub && !isAliasSub && !isReduceSourceSub)
1369
1526
  continue;
1370
- this.addEquivalency(newPath, newEquivalentValue, equivalentScopeName, scopeNode, 'propagated function call return sub-property equivalency');
1371
- // Ensure the database entry has the usage path
1372
- this.addUsageToEquivalencyDatabaseEntry(newPath, newEquivalentValue, equivalentScopeName, scopeNode.name);
1527
+ for (const subValue of subValues) {
1528
+ if (typeof subValue !== 'string')
1529
+ continue;
1530
+ // Convert alias/reduceSource paths to returnValue paths
1531
+ let effectiveSubPath = subPath;
1532
+ if (isAliasSub && !isReturnValueSub) {
1533
+ // Replace the alias prefix with returnValue
1534
+ effectiveSubPath =
1535
+ 'returnValue' + subPath.substring(returnValueAlias.length);
1536
+ }
1537
+ else if (isReduceSourceSub && !isReturnValueSub && !isAliasSub) {
1538
+ // Replace the reduce source prefix with returnValue
1539
+ effectiveSubPath =
1540
+ 'returnValue' + subPath.substring(reduceSourceVar.length);
1541
+ }
1542
+ const subPropertyPath = effectiveSubPath.substring('returnValue'.length);
1543
+ const newPath = cleanPath(path + subPropertyPath, allPaths);
1544
+ let newEquivalentValue = cleanPath(subValue.replace(/::cyDuplicateKey\d+::/g, ''), allPaths);
1545
+ // Resolve variable references through parent scope equivalencies
1546
+ const resolved = this.resolveVariableThroughParentScopes(newEquivalentValue, callbackScope, allPaths);
1547
+ newEquivalentValue = resolved.resolvedPath;
1548
+ const equivalentScopeName = resolved.scopeName;
1549
+ if (!newEquivalentValue || !this.isValidPath(newEquivalentValue))
1550
+ continue;
1551
+ this.addEquivalency(newPath, newEquivalentValue, equivalentScopeName, scopeNode, 'propagated function call return sub-property equivalency');
1552
+ // Ensure the database entry has the usage path
1553
+ this.addUsageToEquivalencyDatabaseEntry(newPath, newEquivalentValue, equivalentScopeName, scopeNode.name);
1554
+ }
1373
1555
  }
1374
1556
  }
1375
1557
  /**
@@ -1401,7 +1583,14 @@ export class ScopeDataStructure {
1401
1583
  const parentScope = this.scopeNodes[parentScopeName];
1402
1584
  if (!parentScope?.analysis?.isolatedEquivalentVariables)
1403
1585
  continue;
1404
- const rootEquiv = parentScope.analysis.isolatedEquivalentVariables[rootVar];
1586
+ const rawRootEquiv = parentScope.analysis.isolatedEquivalentVariables[rootVar];
1587
+ // Normalize to array and use first string value
1588
+ const rootEquivs = Array.isArray(rawRootEquiv)
1589
+ ? rawRootEquiv
1590
+ : rawRootEquiv
1591
+ ? [rawRootEquiv]
1592
+ : [];
1593
+ const rootEquiv = rootEquivs.find((r) => typeof r === 'string');
1405
1594
  if (typeof rootEquiv === 'string') {
1406
1595
  return {
1407
1596
  resolvedPath: cleanPath(rootEquiv + restOfPath, allPaths),
@@ -1595,9 +1784,21 @@ export class ScopeDataStructure {
1595
1784
  const remainingPath = this.joinPathParts(remainingPathParts);
1596
1785
  if (relevantSubPathParts.every((part, i) => part === schemaPathParts[i]) &&
1597
1786
  equivalentValue.scopeNodeName === scopeNode.name) {
1787
+ // DEBUG
1598
1788
  continue;
1599
1789
  }
1600
1790
  const newEquivalentPath = this.joinPathParts([schemaPath, remainingPath]);
1791
+ // PERF: Detect repeated patterns in paths to prevent exponential blowup
1792
+ // Paths like `signature[0].attributes.properties[].attributes.properties[]...`
1793
+ // indicate recursive type structures that cause exponential schema explosion
1794
+ if (this.hasExcessivePatternRepetition(newEquivalentPath)) {
1795
+ if (traceId && debugLevel > 0) {
1796
+ console.info('Debug: skipping path with excessive pattern repetition', {
1797
+ path: newEquivalentPath,
1798
+ });
1799
+ }
1800
+ continue;
1801
+ }
1601
1802
  if (!equivalentScopeNode) {
1602
1803
  if (traceId) {
1603
1804
  console.info('Debug Propagation: missing equivalent scope info', {
@@ -1725,6 +1926,8 @@ export class ScopeDataStructure {
1725
1926
  return;
1726
1927
  }
1727
1928
  const usageScopeNode = this.getScopeOrFunctionCallInfo(usageEquivalency.scopeNodeName);
1929
+ if (!usageScopeNode)
1930
+ continue;
1728
1931
  // Guard against infinite recursion by tracking which paths we've already
1729
1932
  // added from addComplexSourcePathVariables
1730
1933
  if (this.visitedTracker.checkAndMarkComplexSourceVisited(usageScopeNode.name, newUsageEquivalentPath)) {
@@ -1773,6 +1976,8 @@ export class ScopeDataStructure {
1773
1976
  continue;
1774
1977
  }
1775
1978
  const usageScopeNode = this.getScopeOrFunctionCallInfo(usageEquivalency.scopeNodeName);
1979
+ if (!usageScopeNode)
1980
+ continue;
1776
1981
  // This is put in place to avoid propagating array functions like 'filter' through complex equivalencies
1777
1982
  // but may cause problems if the funtion call is not on a known object (e.g. string or array)
1778
1983
  if (newUsageEquivalentPath.endsWith(')') ||
@@ -1869,9 +2074,70 @@ export class ScopeDataStructure {
1869
2074
  // Update inverted index
1870
2075
  this.intermediatesOrderIndex.set(pathId, databaseEntry);
1871
2076
  if (intermediateIndex === 0) {
1872
- const isValidSourceCandidate = pathInfo.schemaPath.startsWith('signature[') ||
2077
+ let isValidSourceCandidate = pathInfo.schemaPath.startsWith('signature[') ||
1873
2078
  pathInfo.schemaPath.includes('functionCallReturnValue');
1874
- if (isValidSourceCandidate) {
2079
+ // Check if path STARTS with a spread pattern like [...var]
2080
+ // This handles cases like [...files][][0] or [...files].sort(...).functionCallReturnValue[][0]
2081
+ // where the spread source variable needs to be resolved to a signature path.
2082
+ // We do this REGARDLESS of isValidSourceCandidate because even paths containing
2083
+ // functionCallReturnValue may need spread resolution to trace back to the signature.
2084
+ const spreadMatch = pathInfo.schemaPath.match(/^\[\.\.\.(\w+)\]/);
2085
+ if (spreadMatch) {
2086
+ const spreadVar = spreadMatch[1];
2087
+ const spreadPattern = spreadMatch[0]; // The full [...var] match
2088
+ const scopeNode = this.scopeNodes[pathInfo.scopeNodeName];
2089
+ if (scopeNode?.equivalencies) {
2090
+ // Follow the equivalency chain to find a signature path
2091
+ // e.g., files (cyScope1) → files (root) → signature[0].files
2092
+ const resolveToSignature = (varName, currentScopeName, visited) => {
2093
+ const visitKey = `${currentScopeName}::${varName}`;
2094
+ if (visited.has(visitKey))
2095
+ return null;
2096
+ visited.add(visitKey);
2097
+ const currentScope = this.scopeNodes[currentScopeName];
2098
+ if (!currentScope?.equivalencies)
2099
+ return null;
2100
+ const varEquivs = currentScope.equivalencies[varName];
2101
+ if (!varEquivs)
2102
+ return null;
2103
+ // First check if any equivalency directly points to a signature path
2104
+ const signatureEquiv = varEquivs.find((eq) => eq.schemaPath.startsWith('signature['));
2105
+ if (signatureEquiv) {
2106
+ return signatureEquiv;
2107
+ }
2108
+ // Otherwise, follow the chain to other scopes
2109
+ for (const equiv of varEquivs) {
2110
+ // If the equivalency points to the same variable in a different scope,
2111
+ // follow the chain
2112
+ if (equiv.schemaPath === varName &&
2113
+ equiv.scopeNodeName !== currentScopeName) {
2114
+ const result = resolveToSignature(varName, equiv.scopeNodeName, visited);
2115
+ if (result)
2116
+ return result;
2117
+ }
2118
+ }
2119
+ return null;
2120
+ };
2121
+ const signatureEquiv = resolveToSignature(spreadVar, pathInfo.scopeNodeName, new Set());
2122
+ if (signatureEquiv) {
2123
+ // Replace ONLY the [...var] part with the resolved signature path
2124
+ // This preserves any suffix like .sort(...).functionCallReturnValue[][0]
2125
+ const resolvedPath = pathInfo.schemaPath.replace(spreadPattern, signatureEquiv.schemaPath);
2126
+ // Add the resolved path as a source candidate
2127
+ if (!databaseEntry.sourceCandidates.some((sc) => sc.schemaPath === resolvedPath &&
2128
+ sc.scopeNodeName === pathInfo.scopeNodeName)) {
2129
+ databaseEntry.sourceCandidates.push({
2130
+ scopeNodeName: pathInfo.scopeNodeName,
2131
+ schemaPath: resolvedPath,
2132
+ });
2133
+ }
2134
+ isValidSourceCandidate = true;
2135
+ }
2136
+ }
2137
+ }
2138
+ if (isValidSourceCandidate &&
2139
+ !databaseEntry.sourceCandidates.some((sc) => sc.schemaPath === pathInfo.schemaPath &&
2140
+ sc.scopeNodeName === pathInfo.scopeNodeName)) {
1875
2141
  databaseEntry.sourceCandidates.push(pathInfo);
1876
2142
  }
1877
2143
  }
@@ -2017,6 +2283,13 @@ export class ScopeDataStructure {
2017
2283
  delete scopeNode.schema[key];
2018
2284
  }
2019
2285
  }
2286
+ // Ensure parameter-to-signature equivalencies are fully propagated.
2287
+ // When a parameter variable (e.g., `node`) is equivalenced to `signature[N]`,
2288
+ // all sub-paths of that variable should also appear under `signature[N]`.
2289
+ // This handles cases where the sub-path was added to the schema via a propagation
2290
+ // chain that already included the variable↔signature equivalency, causing the
2291
+ // cycle detection to prevent the reverse mapping.
2292
+ this.propagateParameterToSignaturePaths(scopeNode);
2020
2293
  fillInSchemaGapsAndUnknowns(scopeNode, fillInUnknowns);
2021
2294
  if (final) {
2022
2295
  for (const manager of this.equivalencyManagers) {
@@ -2028,6 +2301,85 @@ export class ScopeDataStructure {
2028
2301
  ensureSchemaConsistency(scopeNode.schema);
2029
2302
  }
2030
2303
  }
2304
+ /**
2305
+ * For each equivalency where a simple variable maps to signature[N],
2306
+ * ensure all sub-paths of that variable are reflected under signature[N].
2307
+ */
2308
+ propagateParameterToSignaturePaths(scopeNode) {
2309
+ // Helper: check if a type is a concrete scalar that cannot have sub-properties.
2310
+ const SCALAR_TYPES = new Set([
2311
+ 'string',
2312
+ 'number',
2313
+ 'boolean',
2314
+ 'bigint',
2315
+ 'symbol',
2316
+ 'void',
2317
+ 'never',
2318
+ ]);
2319
+ const isDefinitelyScalar = (type) => {
2320
+ const parts = type.split('|').map((s) => s.trim());
2321
+ const base = parts.filter((s) => s !== 'undefined' && s !== 'null');
2322
+ return base.length > 0 && base.every((b) => SCALAR_TYPES.has(b));
2323
+ };
2324
+ // Find variable → signature[N] equivalencies
2325
+ for (const [varName, equivalencies] of Object.entries(scopeNode.equivalencies)) {
2326
+ // Only process simple variable names (no dots, brackets, or parens)
2327
+ if (varName.includes('.') ||
2328
+ varName.includes('[') ||
2329
+ varName.includes('(')) {
2330
+ continue;
2331
+ }
2332
+ for (const equiv of equivalencies) {
2333
+ if (equiv.scopeNodeName === scopeNode.name &&
2334
+ equiv.schemaPath.startsWith('signature[')) {
2335
+ const signaturePath = equiv.schemaPath;
2336
+ const varPrefix = varName + '.';
2337
+ const varBracketPrefix = varName + '[';
2338
+ // Find all schema keys starting with the variable
2339
+ for (const key in scopeNode.schema) {
2340
+ if (key.startsWith(varPrefix) || key.startsWith(varBracketPrefix)) {
2341
+ const suffix = key.slice(varName.length);
2342
+ const sigKey = signaturePath + suffix;
2343
+ // Only add if the signature path doesn't already exist
2344
+ if (!scopeNode.schema[sigKey]) {
2345
+ // Check if this path represents variable conflation:
2346
+ // When a standalone variable (e.g., showWorkoutForm from useState)
2347
+ // appears as a sub-property of a scalar-typed ancestor (e.g.,
2348
+ // activity_type = "string"), it's from scope conflation, not real
2349
+ // property access. Block these while allowing legitimate built-in
2350
+ // accesses like string.length or string.slice.
2351
+ let isConflatedPath = false;
2352
+ let checkPos = signaturePath.length;
2353
+ while (true) {
2354
+ checkPos = sigKey.indexOf('.', checkPos + 1);
2355
+ if (checkPos === -1)
2356
+ break;
2357
+ const ancestorPath = sigKey.substring(0, checkPos);
2358
+ const ancestorType = scopeNode.schema[ancestorPath];
2359
+ if (ancestorType && isDefinitelyScalar(ancestorType)) {
2360
+ // Ancestor is scalar — check if the immediate sub-property
2361
+ // is also a standalone variable (indicating conflation)
2362
+ const afterDot = sigKey.substring(checkPos + 1);
2363
+ const nextSep = afterDot.search(/[.\[]/);
2364
+ const subPropName = nextSep === -1
2365
+ ? afterDot
2366
+ : afterDot.substring(0, nextSep);
2367
+ if (scopeNode.schema[subPropName] !== undefined) {
2368
+ isConflatedPath = true;
2369
+ break;
2370
+ }
2371
+ }
2372
+ }
2373
+ if (!isConflatedPath) {
2374
+ scopeNode.schema[sigKey] = scopeNode.schema[key];
2375
+ }
2376
+ }
2377
+ }
2378
+ }
2379
+ }
2380
+ }
2381
+ }
2382
+ }
2031
2383
  filterAndConvertSchema({ filterPath, newPath, schema, }) {
2032
2384
  const filterPathParts = this.splitPath(filterPath);
2033
2385
  return Object.keys(schema).reduce((acc, key) => {
@@ -2087,6 +2439,10 @@ export class ScopeDataStructure {
2087
2439
  path,
2088
2440
  ...this.splitPath(key).slice(equivalentValueSchemaPathParts.length),
2089
2441
  ]);
2442
+ // PERF: Skip keys with repeated function-call signature patterns
2443
+ // to prevent recursive type expansion (e.g., string.localeCompare returns string)
2444
+ if (this.hasExcessivePatternRepetition(newKey))
2445
+ continue;
2090
2446
  resolvedSchema[newKey] = value;
2091
2447
  }
2092
2448
  }
@@ -2108,6 +2464,9 @@ export class ScopeDataStructure {
2108
2464
  if (!subSchema)
2109
2465
  continue;
2110
2466
  for (const resolvedKey in subSchema) {
2467
+ // PERF: Skip keys with repeated function-call signature patterns
2468
+ if (this.hasExcessivePatternRepetition(resolvedKey))
2469
+ continue;
2111
2470
  if (!resolvedSchema[resolvedKey] ||
2112
2471
  subSchema[resolvedKey] === 'unknown') {
2113
2472
  resolvedSchema[resolvedKey] = subSchema[resolvedKey];
@@ -2244,9 +2603,22 @@ export class ScopeDataStructure {
2244
2603
  }
2245
2604
  }
2246
2605
  }
2247
- return mergedSchema;
2606
+ return this.filterDuplicateKeys(mergedSchema);
2248
2607
  }
2249
- return schema;
2608
+ return this.filterDuplicateKeys(schema);
2609
+ }
2610
+ /**
2611
+ * Filter out ::cyDuplicateKey:: entries from a schema.
2612
+ * These are internal markers for tracking variable reassignments
2613
+ * and should not appear in output schemas or LLM prompts.
2614
+ */
2615
+ filterDuplicateKeys(schema) {
2616
+ return Object.entries(schema).reduce((acc, [key, value]) => {
2617
+ if (!key.includes('::cyDuplicateKey')) {
2618
+ acc[key] = value;
2619
+ }
2620
+ return acc;
2621
+ }, {});
2250
2622
  }
2251
2623
  getEquivalencies(scopeName) {
2252
2624
  const scopeNode = this.getScopeOrFunctionCallInfo(scopeName);
@@ -2268,18 +2640,204 @@ export class ScopeDataStructure {
2268
2640
  if (!scopeNode) {
2269
2641
  return {};
2270
2642
  }
2271
- const entries = this.equivalencyDatabase.filter((entry) => entry.usages.some((usage) => usage.scopeNodeName === scopeNode.name));
2272
- return entries.reduce((acc, entry) => {
2643
+ // Collect all descendant scope names (including the scope itself)
2644
+ // This ensures we include external calls from nested scopes like cyScope2
2645
+ const getAllDescendantScopeNames = (node) => {
2646
+ const names = new Set([node.name]);
2647
+ for (const child of node.children) {
2648
+ for (const name of getAllDescendantScopeNames(child)) {
2649
+ names.add(name);
2650
+ }
2651
+ }
2652
+ return names;
2653
+ };
2654
+ const treeNode = this.scopeTreeManager.findNode(scopeNode.name);
2655
+ const descendantScopeNames = treeNode
2656
+ ? getAllDescendantScopeNames(treeNode)
2657
+ : new Set([scopeNode.name]);
2658
+ // Get all external function calls made from this scope or any descendant scope
2659
+ // This allows us to include prop equivalencies from JSX components
2660
+ // that were rendered in nested scopes (e.g., FileTableRow called from cyScope2)
2661
+ const externalCallsFromScope = this.externalFunctionCalls.filter((efc) => descendantScopeNames.has(efc.callScope));
2662
+ const externalCallNames = new Set(externalCallsFromScope.map((efc) => efc.name));
2663
+ // Helper to check if a usage belongs to this scope (directly, via descendant, or via external call)
2664
+ const usageMatchesScope = (usage) => descendantScopeNames.has(usage.scopeNodeName) ||
2665
+ externalCallNames.has(usage.scopeNodeName);
2666
+ const entries = this.equivalencyDatabase.filter((entry) => entry.usages.some(usageMatchesScope));
2667
+ // Helper to resolve a source candidate through equivalency chains to find signature paths
2668
+ const resolveToSignature = (source, visited) => {
2669
+ const visitKey = `${source.scopeNodeName}::${source.schemaPath}`;
2670
+ if (visited.has(visitKey))
2671
+ return [];
2672
+ visited.add(visitKey);
2673
+ // If already a signature path, return as-is
2674
+ if (source.schemaPath.startsWith('signature[')) {
2675
+ return [source];
2676
+ }
2677
+ const currentScope = this.scopeNodes[source.scopeNodeName];
2678
+ if (!currentScope?.equivalencies)
2679
+ return [source];
2680
+ // Check for direct equivalencies FIRST (full path match)
2681
+ // This ensures paths like "useMemo(...).functionCallReturnValue" follow to "cyScope1::returnValue"
2682
+ // before prefix matching tries "useMemo(...)" which goes to the useMemo scope
2683
+ const directEquivs = currentScope.equivalencies[source.schemaPath];
2684
+ if (directEquivs?.length > 0) {
2685
+ const results = [];
2686
+ for (const equiv of directEquivs) {
2687
+ const resolved = resolveToSignature({
2688
+ scopeNodeName: equiv.scopeNodeName,
2689
+ schemaPath: equiv.schemaPath,
2690
+ }, visited);
2691
+ results.push(...resolved);
2692
+ }
2693
+ if (results.length > 0)
2694
+ return results;
2695
+ }
2696
+ // Handle spread patterns like [...items].sort().functionCallReturnValue
2697
+ // Extract the spread variable and resolve it through the equivalency chain
2698
+ const spreadMatch = source.schemaPath.match(/^\[\.\.\.(\w+)\]/);
2699
+ if (spreadMatch) {
2700
+ const spreadVar = spreadMatch[1];
2701
+ const spreadPattern = spreadMatch[0];
2702
+ const varEquivs = currentScope.equivalencies[spreadVar];
2703
+ if (varEquivs?.length > 0) {
2704
+ const results = [];
2705
+ for (const equiv of varEquivs) {
2706
+ // Follow the variable equivalency and then resolve from there
2707
+ const resolvedVar = resolveToSignature({
2708
+ scopeNodeName: equiv.scopeNodeName,
2709
+ schemaPath: equiv.schemaPath,
2710
+ }, visited);
2711
+ // For each resolved variable path, create the full path with array element suffix
2712
+ for (const rv of resolvedVar) {
2713
+ if (rv.schemaPath.startsWith('signature[')) {
2714
+ // Get the suffix after the spread pattern
2715
+ let suffix = source.schemaPath.slice(spreadPattern.length);
2716
+ // Clean the suffix: strip array method chains like .sort(...).functionCallReturnValue[]
2717
+ // These don't change the data identity, just transform it.
2718
+ // Keep only the final element access parts like [0], [1], etc.
2719
+ // Pattern: strip everything from a method call up through functionCallReturnValue[]
2720
+ suffix = suffix.replace(/\.\w+\([^)]*\)\.functionCallReturnValue\[\]/g, '');
2721
+ // Also handle simpler case without nested parens
2722
+ suffix = suffix.replace(/\.sort\(\w*\(\)\)\.functionCallReturnValue\[\]/g, '');
2723
+ // Add [] to indicate array element access from the spread
2724
+ const resolvedPath = rv.schemaPath + '[]' + suffix;
2725
+ results.push({
2726
+ scopeNodeName: rv.scopeNodeName,
2727
+ schemaPath: resolvedPath,
2728
+ });
2729
+ }
2730
+ }
2731
+ }
2732
+ if (results.length > 0)
2733
+ return results;
2734
+ }
2735
+ }
2736
+ // Try to find prefix equivalencies that can resolve this path
2737
+ // For path like "cyScope3().signature[0][0]", check "cyScope3().signature[0]", etc.
2738
+ const pathParts = this.splitPath(source.schemaPath);
2739
+ for (let i = pathParts.length - 1; i > 0; i--) {
2740
+ const prefix = this.joinPathParts(pathParts.slice(0, i));
2741
+ const suffix = this.joinPathParts(pathParts.slice(i));
2742
+ const prefixEquivs = currentScope.equivalencies[prefix];
2743
+ if (prefixEquivs?.length > 0) {
2744
+ const results = [];
2745
+ for (const equiv of prefixEquivs) {
2746
+ const newPath = this.joinPathParts([equiv.schemaPath, suffix]);
2747
+ const resolved = resolveToSignature({ scopeNodeName: equiv.scopeNodeName, schemaPath: newPath }, visited);
2748
+ results.push(...resolved);
2749
+ }
2750
+ if (results.length > 0)
2751
+ return results;
2752
+ }
2753
+ }
2754
+ return [source];
2755
+ };
2756
+ const acc = entries.reduce((result, entry) => {
2273
2757
  var _a;
2274
2758
  if (entry.sourceCandidates.length === 0)
2275
- return acc;
2276
- const usages = entry.usages.filter((u) => u.scopeNodeName === scopeNode.name);
2759
+ return result;
2760
+ const usages = entry.usages.filter(usageMatchesScope);
2277
2761
  for (const usage of usages) {
2278
- acc[_a = usage.schemaPath] || (acc[_a] = []);
2279
- acc[usage.schemaPath].push(...entry.sourceCandidates);
2762
+ result[_a = usage.schemaPath] || (result[_a] = []);
2763
+ // Resolve each source candidate through the equivalency chain
2764
+ for (const source of entry.sourceCandidates) {
2765
+ const resolvedSources = resolveToSignature(source, new Set());
2766
+ result[usage.schemaPath].push(...resolvedSources);
2767
+ }
2280
2768
  }
2281
- return acc;
2769
+ return result;
2282
2770
  }, {});
2771
+ // Post-processing: enrich useState-backed sources with co-located external
2772
+ // function calls. When a useState value resolves to a setter variable that
2773
+ // lives in the same scope as a fetch/API call, that fetch is a data source.
2774
+ this.enrichUseStateSourcesWithCoLocatedCalls(acc);
2775
+ return acc;
2776
+ }
2777
+ /**
2778
+ * For each source that ends at a useState path, check if the setter was called
2779
+ * from a scope that also contains external function calls (like fetch).
2780
+ * If so, add those external calls as additional source candidates.
2781
+ */
2782
+ enrichUseStateSourcesWithCoLocatedCalls(acc) {
2783
+ const rootScopeName = this.scopeTreeManager.getRootName();
2784
+ const rootScope = this.scopeNodes[rootScopeName];
2785
+ if (!rootScope)
2786
+ return;
2787
+ // Collect all descendants for each scope node
2788
+ const getAllDescendants = (node) => {
2789
+ const names = new Set([node.name]);
2790
+ for (const child of node.children) {
2791
+ for (const name of getAllDescendants(child)) {
2792
+ names.add(name);
2793
+ }
2794
+ }
2795
+ return names;
2796
+ };
2797
+ for (const [usagePath, sources] of Object.entries(acc)) {
2798
+ const additionalSources = [];
2799
+ for (const source of sources) {
2800
+ // Check if this source is a useState-related terminal path
2801
+ // (e.g., useState(X).functionCallReturnValue[1] or useState(X).signature[0])
2802
+ if (!source.schemaPath.match(/^useState\([^)]*\)\./))
2803
+ continue;
2804
+ // Find the useState call from the source path
2805
+ const useStateCallMatch = source.schemaPath.match(/^(useState\([^)]*\))\./);
2806
+ if (!useStateCallMatch)
2807
+ continue;
2808
+ const useStateCall = useStateCallMatch[1];
2809
+ // Look in the root scope for the useState value equivalency
2810
+ // which tells us where the setter was called from
2811
+ const valuePath = `${useStateCall}.functionCallReturnValue[0]`;
2812
+ const valueEquivs = rootScope.equivalencies[valuePath];
2813
+ if (!valueEquivs)
2814
+ continue;
2815
+ for (const equiv of valueEquivs) {
2816
+ // Find the scope where the setter was called
2817
+ const setterScopeName = equiv.scopeNodeName;
2818
+ const setterScopeTree = this.scopeTreeManager.findNode(setterScopeName);
2819
+ if (!setterScopeTree)
2820
+ continue;
2821
+ // Get all descendant scope names from the setter scope
2822
+ const relatedScopes = getAllDescendants(setterScopeTree);
2823
+ // Find external function calls in those scopes whose return values
2824
+ // are actually consumed (assigned to a variable). This excludes
2825
+ // fire-and-forget calls like analytics.track() or console.log().
2826
+ const coLocatedCalls = this.externalFunctionCalls.filter((efc) => relatedScopes.has(efc.callScope) &&
2827
+ efc.receivingVariableNames &&
2828
+ efc.receivingVariableNames.length > 0);
2829
+ for (const call of coLocatedCalls) {
2830
+ additionalSources.push({
2831
+ scopeNodeName: call.callScope,
2832
+ schemaPath: `${call.callSignature}.functionCallReturnValue`,
2833
+ });
2834
+ }
2835
+ }
2836
+ }
2837
+ if (additionalSources.length > 0) {
2838
+ acc[usagePath].push(...additionalSources);
2839
+ }
2840
+ }
2283
2841
  }
2284
2842
  getUsageEquivalencies(functionName) {
2285
2843
  const scopeNode = this.getScopeOrFunctionCallInfo(functionName);
@@ -2344,6 +2902,66 @@ export class ScopeDataStructure {
2344
2902
  }
2345
2903
  }
2346
2904
  }
2905
+ // Enrich schema with deeply nested paths from internal function call scopes.
2906
+ // When a function call like traverse(tree) exists, and traverse's scope has
2907
+ // signature[0].children[path][entityName] (from propagateParameterToSignaturePaths),
2908
+ // we need to map those paths back to the argument variable (tree) in this scope.
2909
+ // This handles cases where cycle detection prevented the equivalency chain from
2910
+ // propagating deep paths during Phase 2 batch queue processing.
2911
+ for (const equivalenceKey in equivalencies ?? {}) {
2912
+ // Look for keys matching function call pattern: funcName(...).signature[N]
2913
+ const funcCallMatch = equivalenceKey.match(/^([^(]+)\(.*?\)\.(signature\[\d+\])$/);
2914
+ if (!funcCallMatch)
2915
+ continue;
2916
+ const calledFunctionName = funcCallMatch[1];
2917
+ const signatureParam = funcCallMatch[2]; // e.g., "signature[0]"
2918
+ for (const equivalenceValue of equivalencies[equivalenceKey]) {
2919
+ if (equivalenceValue.scopeNodeName !== scopeName)
2920
+ continue;
2921
+ const targetVariable = equivalenceValue.schemaPath;
2922
+ // Get the called function's schema (includes propagated parameter paths)
2923
+ const childSchema = this.getSchema({
2924
+ scopeName: calledFunctionName,
2925
+ });
2926
+ if (!childSchema)
2927
+ continue;
2928
+ // Map child function's signature paths to parent variable paths
2929
+ const sigPrefix = signatureParam + '.';
2930
+ const sigBracketPrefix = signatureParam + '[';
2931
+ for (const childKey in childSchema) {
2932
+ let suffix = null;
2933
+ if (childKey.startsWith(sigPrefix)) {
2934
+ suffix = childKey.slice(signatureParam.length);
2935
+ }
2936
+ else if (childKey.startsWith(sigBracketPrefix)) {
2937
+ suffix = childKey.slice(signatureParam.length);
2938
+ }
2939
+ if (suffix !== null) {
2940
+ const parentKey = targetVariable + suffix;
2941
+ if (!schema[parentKey]) {
2942
+ schema[parentKey] = childSchema[childKey];
2943
+ }
2944
+ }
2945
+ }
2946
+ }
2947
+ }
2948
+ // Helper: check if a type is a concrete scalar that cannot have sub-properties.
2949
+ // e.g., "string", "number | undefined", "boolean | null" are scalar.
2950
+ // "object", "array", "function", "unknown", "Workout", etc. are NOT scalar.
2951
+ const SCALAR_TYPES = new Set([
2952
+ 'string',
2953
+ 'number',
2954
+ 'boolean',
2955
+ 'bigint',
2956
+ 'symbol',
2957
+ 'void',
2958
+ 'never',
2959
+ ]);
2960
+ const isDefinitelyScalarType = (type) => {
2961
+ const parts = type.split('|').map((s) => s.trim());
2962
+ const base = parts.filter((s) => s !== 'undefined' && s !== 'null');
2963
+ return base.length > 0 && base.every((b) => SCALAR_TYPES.has(b));
2964
+ };
2347
2965
  // Propagate nested paths from variables to their signature equivalents
2348
2966
  // e.g., if workouts = signature[0].workouts, then workouts[].title becomes
2349
2967
  // signature[0].workouts[].title
@@ -2363,12 +2981,72 @@ export class ScopeDataStructure {
2363
2981
  const signatureKey = signaturePath + suffix;
2364
2982
  // Add to schema if not already present
2365
2983
  if (!tempScopeNode.schema[signatureKey]) {
2366
- tempScopeNode.schema[signatureKey] = schema[schemaKey];
2984
+ // Check if this path represents variable conflation:
2985
+ // When a standalone variable (e.g., showWorkoutForm from useState)
2986
+ // appears as a sub-property of a scalar-typed ancestor (e.g.,
2987
+ // activity_type = "string"), it's from scope conflation, not real
2988
+ // property access. Block these while allowing legitimate built-in
2989
+ // accesses like string.length or string.slice.
2990
+ let isConflatedPath = false;
2991
+ let checkPos = signaturePath.length;
2992
+ while (true) {
2993
+ checkPos = signatureKey.indexOf('.', checkPos + 1);
2994
+ if (checkPos === -1)
2995
+ break;
2996
+ const ancestorPath = signatureKey.substring(0, checkPos);
2997
+ const ancestorType = tempScopeNode.schema[ancestorPath];
2998
+ if (ancestorType && isDefinitelyScalarType(ancestorType)) {
2999
+ // Ancestor is scalar — check if the immediate sub-property
3000
+ // is also a standalone variable (indicating conflation)
3001
+ const afterDot = signatureKey.substring(checkPos + 1);
3002
+ const nextSep = afterDot.search(/[.\[]/);
3003
+ const subPropName = nextSep === -1 ? afterDot : afterDot.substring(0, nextSep);
3004
+ if (schema[subPropName] !== undefined) {
3005
+ isConflatedPath = true;
3006
+ break;
3007
+ }
3008
+ }
3009
+ }
3010
+ if (!isConflatedPath) {
3011
+ tempScopeNode.schema[signatureKey] = schema[schemaKey];
3012
+ }
3013
+ }
3014
+ }
3015
+ }
3016
+ }
3017
+ // Post-process: filter out conflated signature paths.
3018
+ // During phase 2 scope analysis, useState(false) conflation can create
3019
+ // bad paths like signature[0].mockWorkouts[].activity_type.showWorkoutForm
3020
+ // directly in scopeNode.schema. These flow through signatureInSchema into
3021
+ // tempScopeNode.schema without any guard. Filter them out here by checking:
3022
+ // 1. An ancestor in the path has a concrete scalar type (string, number, boolean, etc.)
3023
+ // 2. The immediate sub-property of that scalar ancestor is also a standalone
3024
+ // variable in the schema (indicating conflation, not a real property access)
3025
+ for (const key of Object.keys(tempScopeNode.schema)) {
3026
+ if (!key.startsWith('signature['))
3027
+ continue;
3028
+ // Walk through the path looking for scalar-typed ancestors
3029
+ let pos = 0;
3030
+ while (true) {
3031
+ pos = key.indexOf('.', pos + 1);
3032
+ if (pos === -1)
3033
+ break;
3034
+ const ancestorPath = key.substring(0, pos);
3035
+ const ancestorType = tempScopeNode.schema[ancestorPath];
3036
+ if (ancestorType && isDefinitelyScalarType(ancestorType)) {
3037
+ // Found a scalar ancestor — check if the sub-property name
3038
+ // is a standalone variable in the getSchema() result
3039
+ const afterDot = key.substring(pos + 1);
3040
+ const nextSep = afterDot.search(/[.\[]/);
3041
+ const subPropName = nextSep === -1 ? afterDot : afterDot.substring(0, nextSep);
3042
+ if (schema[subPropName] !== undefined) {
3043
+ delete tempScopeNode.schema[key];
3044
+ break;
2367
3045
  }
2368
3046
  }
2369
3047
  }
2370
3048
  }
2371
- return tempScopeNode.schema;
3049
+ return this.filterDuplicateKeys(tempScopeNode.schema);
2372
3050
  }
2373
3051
  getReturnValue({ functionName, fillInUnknowns, }) {
2374
3052
  // Trigger finalization on all managers to apply any pending updates
@@ -2411,14 +3089,27 @@ export class ScopeDataStructure {
2411
3089
  // Include function paths even if their return value wasn't captured
2412
3090
  // This ensures methods like onAuthStateChange are included in the schema
2413
3091
  // But exclude signature entries (they should only be included via functionCallReturnValue paths)
2414
- (schema[key] === 'function' && key.indexOf('signature[') === -1))
3092
+ // Also exclude bare function call signatures - paths that are JUST a call like
3093
+ // "useCustomSizes(projectSlug)" should not be included as return values.
3094
+ // These represent "the function exists" not actual return data, and including
3095
+ // them causes nested path bugs in dependencySchemas.
3096
+ (schema[key] === 'function' &&
3097
+ key.indexOf('signature[') === -1 &&
3098
+ // Exclude bare call signatures: function calls with no dots OUTSIDE parentheses
3099
+ // e.g., "useCustomSizes(projectSlug)" is bare (exclude)
3100
+ // e.g., "loadProject({nested.property})" is bare - dots are inside args (exclude)
3101
+ // e.g., "getSupabase().auth.method()" has dots outside - method chain (include)
3102
+ !this.isBareCallSignature(key)))
2415
3103
  .reduce((acc, key) => {
2416
3104
  acc[key] = schema[key];
2417
3105
  const keyParts = this.splitPath(key);
2418
3106
  for (const path in schema) {
2419
3107
  const pathParts = this.splitPath(path);
2420
3108
  if (pathParts.every((p, i) => keyParts[i] === p)) {
2421
- acc[path] = schema[path];
3109
+ // Also exclude bare call signatures from prefix paths
3110
+ if (!this.isBareCallSignature(path)) {
3111
+ acc[path] = schema[path];
3112
+ }
2422
3113
  }
2423
3114
  }
2424
3115
  return acc;
@@ -2432,7 +3123,56 @@ export class ScopeDataStructure {
2432
3123
  this.onlyEquivalencies = true;
2433
3124
  this.validateSchema(tempScopeNode, true, fillInUnknowns);
2434
3125
  this.onlyEquivalencies = wasOnlyEquivalencies;
2435
- return tempScopeNode.schema;
3126
+ // Remove bare call signatures from the return value schema.
3127
+ // fillInSchemaGapsAndUnknowns may add parent paths like "useCustomSizes(projectSlug)"
3128
+ // when it sees "useCustomSizes(projectSlug).functionCallReturnValue". These bare
3129
+ // call signatures represent "the function exists" not actual return data, and
3130
+ // including them causes nested path bugs in dependencySchemas.
3131
+ const resultSchema = tempScopeNode.schema;
3132
+ for (const key of Object.keys(resultSchema)) {
3133
+ if (this.isBareCallSignature(key)) {
3134
+ delete resultSchema[key];
3135
+ }
3136
+ }
3137
+ return resultSchema;
3138
+ }
3139
+ /**
3140
+ * Checks if a schema key is a "bare call signature" - a function call with no
3141
+ * method chain before it and no path segments after it.
3142
+ *
3143
+ * A bare call signature represents "this function exists" rather than actual
3144
+ * return data, and including them causes nested path bugs in dependencySchemas.
3145
+ *
3146
+ * Examples:
3147
+ * - "useCustomSizes(projectSlug)" -> bare (true)
3148
+ * - "loadProject({nested.property})" -> bare (dots are inside args, true)
3149
+ * - "getSupabase().auth.method()" -> not bare (has dots outside parens, false)
3150
+ * - "useProject().functionCallReturnValue" -> not bare (has path after, false)
3151
+ */
3152
+ isBareCallSignature(key) {
3153
+ // Must end with ) and contain ( to be a call
3154
+ if (!key.endsWith(')') || key.indexOf('(') === -1) {
3155
+ return false;
3156
+ }
3157
+ // Check if there are any dots OUTSIDE of parentheses
3158
+ // Strip out content inside balanced parentheses, then check for dots
3159
+ let depth = 0;
3160
+ let hasDotsOutsideParens = false;
3161
+ for (let i = 0; i < key.length; i++) {
3162
+ const char = key[i];
3163
+ if (char === '(') {
3164
+ depth++;
3165
+ }
3166
+ else if (char === ')') {
3167
+ depth--;
3168
+ }
3169
+ else if (char === '.' && depth === 0) {
3170
+ hasDotsOutsideParens = true;
3171
+ break;
3172
+ }
3173
+ }
3174
+ // It's a bare call signature if there are no dots outside parentheses
3175
+ return !hasDotsOutsideParens;
2436
3176
  }
2437
3177
  /**
2438
3178
  * Replaces cyScope placeholder references (e.g., cyScope10()) in schema keys
@@ -2503,12 +3243,371 @@ export class ScopeDataStructure {
2503
3243
  getEquivalentSignatureVariables() {
2504
3244
  const scopeNode = this.scopeNodes[this.scopeTreeManager.getRootName()];
2505
3245
  const equivalentSignatureVariables = {};
3246
+ // Helper to add equivalencies - accumulates into array if multiple values for same key
3247
+ // This is critical for OR expressions like `x = a || b` where x should map to both a and b
3248
+ const addEquivalency = (key, value) => {
3249
+ const existing = equivalentSignatureVariables[key];
3250
+ if (existing === undefined) {
3251
+ // First value - store as string
3252
+ equivalentSignatureVariables[key] = value;
3253
+ }
3254
+ else if (typeof existing === 'string') {
3255
+ if (existing !== value) {
3256
+ // Second different value - convert to array
3257
+ equivalentSignatureVariables[key] = [existing, value];
3258
+ }
3259
+ // Same value - no change needed
3260
+ }
3261
+ else {
3262
+ // Already an array - add if not already present
3263
+ if (!existing.includes(value)) {
3264
+ existing.push(value);
3265
+ }
3266
+ }
3267
+ };
2506
3268
  for (const [path, equivalentValues] of Object.entries(scopeNode.equivalencies)) {
2507
3269
  for (const equivalentValue of equivalentValues) {
3270
+ // Case 1: Props/signature equivalencies (existing behavior)
3271
+ // Maps local variable names to their signature paths
3272
+ // e.g., "propValue" -> "signature[0].prop"
2508
3273
  if (path.startsWith('signature[')) {
2509
- equivalentSignatureVariables[equivalentValue.schemaPath] = path;
3274
+ addEquivalency(equivalentValue.schemaPath, path);
3275
+ }
3276
+ // Case 2: Hook variable equivalencies (new behavior)
3277
+ // The equivalencies are stored as: path = variable name, schemaPath = data source
3278
+ // e.g., path = "debugFetcher", schemaPath = "useFetcher<...>().functionCallReturnValue"
3279
+ // We need to map: "debugFetcher" -> "useFetcher<...>()"
3280
+ // This enables resolving paths like "debugFetcher.state" to
3281
+ // "useFetcher<...>().state" for execution flow validation
3282
+ if (equivalentValue.schemaPath.endsWith('.functionCallReturnValue')) {
3283
+ // Extract the hook call path (everything before .functionCallReturnValue)
3284
+ let hookCallPath = equivalentValue.schemaPath.slice(0, -'.functionCallReturnValue'.length);
3285
+ // Only include if it looks like a hook call (contains parentheses)
3286
+ // and the variable name (path) is a simple identifier (no dots)
3287
+ if (hookCallPath.includes('(') && !path.includes('.')) {
3288
+ // Special case: If hookCallPath is a callback scope (cyScope pattern),
3289
+ // trace through it to find what the callback actually returns.
3290
+ // This handles useState(() => { return prop; }) patterns.
3291
+ const cyScopeMatch = hookCallPath.match(/^(cyScope\d+)\(\)$/);
3292
+ if (cyScopeMatch) {
3293
+ // Use the equivalency database to trace the callback's return value
3294
+ // to its actual source (e.g., viewModeFromUrl -> segments -> params -> useParams)
3295
+ const dbEntry = this.getEquivalenciesDatabaseEntry(scopeNode.name, // Component scope
3296
+ path);
3297
+ if (dbEntry?.sourceCandidates?.length > 0) {
3298
+ // Use the traced source instead of the callback scope
3299
+ hookCallPath = dbEntry.sourceCandidates[0].schemaPath;
3300
+ }
3301
+ }
3302
+ addEquivalency(path, hookCallPath);
3303
+ }
3304
+ }
3305
+ // Case 3: Destructured variables from local variables
3306
+ // e.g., const { scenarios } = currentEntityAnalysis;
3307
+ // This creates: path = "scenarios", schemaPath = "currentEntityAnalysis.scenarios"
3308
+ // We need to map: "scenarios" -> "currentEntityAnalysis.scenarios"
3309
+ // AND resolve transitively if currentEntityAnalysis is itself equivalent to a hook call
3310
+ if (!path.includes('.') && // path is a simple identifier
3311
+ !equivalentValue.schemaPath.startsWith('signature[') && // not a signature path
3312
+ !equivalentValue.schemaPath.endsWith('.functionCallReturnValue') // not already handled above
3313
+ ) {
3314
+ // Skip bare "returnValue" from child scopes — this is the child's return value,
3315
+ // not a meaningful data source path in the parent scope
3316
+ if (equivalentValue.schemaPath === 'returnValue' &&
3317
+ equivalentValue.scopeNodeName !==
3318
+ this.scopeTreeManager.getRootName()) {
3319
+ continue;
3320
+ }
3321
+ // Add equivalency (will accumulate if multiple values for OR expressions)
3322
+ addEquivalency(path, equivalentValue.schemaPath);
3323
+ }
3324
+ // Case 4: Child component prop mappings (Fix 22)
3325
+ // When parent renders <ChildComponent prop={value} />, we get equivalencies like:
3326
+ // path = "ChildComponent().signature[0].prop"
3327
+ // schemaPath = "value" (the variable passed as the prop)
3328
+ // We need to include these so translateChildPathToParent can work.
3329
+ // Pattern: ComponentName().signature[N] or ComponentName().signature[N].propName
3330
+ if (path.includes('().signature[') &&
3331
+ !equivalentValue.schemaPath.includes('()') // schemaPath is a simple variable, not a function call
3332
+ ) {
3333
+ addEquivalency(path, equivalentValue.schemaPath);
3334
+ }
3335
+ // Case 5: Destructured function parameters (Fix 25)
3336
+ // When a function has destructured props: function Comp({ propA, propB }: Props)
3337
+ // We get equivalencies like:
3338
+ // path = "propA" (the destructured variable name)
3339
+ // schemaPath = "signature[0].propA" (the signature path)
3340
+ // We need to map: "propA" -> "signature[0].propA"
3341
+ // This enables translateChildPathToParent to resolve child variable paths
3342
+ // to their signature paths when merging execution flows.
3343
+ if (!path.includes('.') && // path is a simple identifier (destructured prop name)
3344
+ equivalentValue.schemaPath.startsWith('signature[') // schemaPath IS a signature path
3345
+ ) {
3346
+ addEquivalency(path, equivalentValue.schemaPath);
3347
+ }
3348
+ // Case 7: Method calls on variables that result in .functionCallReturnValue (Fix 33)
3349
+ // When we have patterns like:
3350
+ // path = "segments" (simple identifier)
3351
+ // schemaPath = "splat.split('/').functionCallReturnValue"
3352
+ // This is a method call on a variable (not a hook call), but we still need to
3353
+ // track it so transitive resolution can resolve `splat` to its actual source.
3354
+ // E.g., if splat -> useParams().functionCallReturnValue['*'], then
3355
+ // segments -> useParams().functionCallReturnValue['*'].split('/').functionCallReturnValue
3356
+ if (!path.includes('.') && // path is a simple identifier
3357
+ equivalentValue.schemaPath.endsWith('.functionCallReturnValue') && // ends with function return
3358
+ equivalentValue.schemaPath.includes('.') // has property access (method call)
3359
+ ) {
3360
+ // Check if this looks like a method call on a variable (not a hook call)
3361
+ // Hook calls look like: hookName() or hookName<T>()
3362
+ // Method calls look like: variable.method() or variable.method<T>()
3363
+ const hookCallPath = equivalentValue.schemaPath.slice(0, -'.functionCallReturnValue'.length);
3364
+ // If it's a method call (contains a dot before the parenthesis), include it
3365
+ const dotBeforeParen = hookCallPath.indexOf('.');
3366
+ const parenPos = hookCallPath.indexOf('(');
3367
+ if (dotBeforeParen !== -1 && dotBeforeParen < parenPos) {
3368
+ // This is a method call like "splat.split('/')", not a hook call
3369
+ addEquivalency(path, equivalentValue.schemaPath);
3370
+ }
3371
+ }
3372
+ }
3373
+ }
3374
+ // Case 6: Collect JSX child prop equivalencies from child scopes (Fix 26)
3375
+ // When a parent component renders <ChildComponent prop={value} />, the JSX
3376
+ // return statement may be in a child scope (e.g., cyScope2). The equivalencies
3377
+ // like ChildComponent().signature[0].prop -> value get stored in that child scope.
3378
+ // But translateChildPathToParent needs to find them from the parent scope's context.
3379
+ // So we collect Case 4 patterns from ALL child scopes that belong to this root scope.
3380
+ const rootName = this.scopeTreeManager.getRootName();
3381
+ for (const [scopeName, childScopeNode] of Object.entries(this.scopeNodes)) {
3382
+ // Skip the root scope (already processed above)
3383
+ if (scopeName === rootName)
3384
+ continue;
3385
+ // Only include scopes that are children of the root (their tree includes root)
3386
+ if (!childScopeNode.tree?.includes(rootName))
3387
+ continue;
3388
+ // Look for Case 4 patterns in the child scope
3389
+ for (const [path, equivalentValues] of Object.entries(childScopeNode.equivalencies || {})) {
3390
+ for (const equivalentValue of equivalentValues) {
3391
+ // Case 4 pattern: ChildComponent().signature[0].propName -> parentVariable
3392
+ if (path.includes('().signature[') &&
3393
+ !equivalentValue.schemaPath.includes('()') // schemaPath is a simple variable
3394
+ ) {
3395
+ // Only add if not already present from the root scope
3396
+ // Root scope values take precedence over child scope values
3397
+ if (!(path in equivalentSignatureVariables)) {
3398
+ addEquivalency(path, equivalentValue.schemaPath);
3399
+ }
3400
+ }
3401
+ }
3402
+ }
3403
+ }
3404
+ // Transitive resolution: Resolve variable chains through multiple levels
3405
+ // E.g., analysis → currentEntityAnalysis → useLoaderData().functionCallReturnValue.currentEntityAnalysis
3406
+ // We need multiple passes because resolutions can depend on each other
3407
+ const maxIterations = 5; // Prevent infinite loops
3408
+ // Helper function to resolve a single source path using equivalencies
3409
+ const resolveSourcePath = (sourcePath, equivMap) => {
3410
+ // Extract base variable from the path
3411
+ const dotIndex = sourcePath.indexOf('.');
3412
+ const bracketIndex = sourcePath.indexOf('[');
3413
+ let baseVar;
3414
+ let rest;
3415
+ if (dotIndex === -1 && bracketIndex === -1) {
3416
+ baseVar = sourcePath;
3417
+ rest = '';
3418
+ }
3419
+ else if (dotIndex === -1) {
3420
+ baseVar = sourcePath.slice(0, bracketIndex);
3421
+ rest = sourcePath.slice(bracketIndex);
3422
+ }
3423
+ else if (bracketIndex === -1) {
3424
+ baseVar = sourcePath.slice(0, dotIndex);
3425
+ rest = sourcePath.slice(dotIndex);
3426
+ }
3427
+ else {
3428
+ const firstIndex = Math.min(dotIndex, bracketIndex);
3429
+ baseVar = sourcePath.slice(0, firstIndex);
3430
+ rest = sourcePath.slice(firstIndex);
3431
+ }
3432
+ // Look up the base variable in equivalencies
3433
+ if (baseVar in equivMap && equivMap[baseVar] !== sourcePath) {
3434
+ const baseResolved = equivMap[baseVar];
3435
+ // Skip if baseResolved is an array (handle later)
3436
+ if (Array.isArray(baseResolved))
3437
+ return null;
3438
+ // If it resolves to a signature path, build the full resolved path
3439
+ if (baseResolved.startsWith('signature[') ||
3440
+ baseResolved.includes('()')) {
3441
+ if (baseResolved.endsWith('()')) {
3442
+ return baseResolved + '.functionCallReturnValue' + rest;
3443
+ }
3444
+ return baseResolved + rest;
2510
3445
  }
2511
3446
  }
3447
+ return null;
3448
+ };
3449
+ for (let iteration = 0; iteration < maxIterations; iteration++) {
3450
+ let changed = false;
3451
+ for (const [varName, sourcePathOrArray] of Object.entries(equivalentSignatureVariables)) {
3452
+ // Handle arrays (OR expressions) by resolving each element
3453
+ if (Array.isArray(sourcePathOrArray)) {
3454
+ const resolvedArray = [];
3455
+ let arrayChanged = false;
3456
+ for (const sourcePath of sourcePathOrArray) {
3457
+ // Try to resolve this path using transitive resolution
3458
+ const resolved = resolveSourcePath(sourcePath, equivalentSignatureVariables);
3459
+ if (resolved && resolved !== sourcePath) {
3460
+ resolvedArray.push(resolved);
3461
+ arrayChanged = true;
3462
+ }
3463
+ else {
3464
+ resolvedArray.push(sourcePath);
3465
+ }
3466
+ }
3467
+ if (arrayChanged) {
3468
+ equivalentSignatureVariables[varName] = resolvedArray;
3469
+ changed = true;
3470
+ }
3471
+ continue;
3472
+ }
3473
+ const sourcePath = sourcePathOrArray;
3474
+ // Skip if already fully resolved (contains function call syntax)
3475
+ // BUT first check for computed value patterns that need resolution (Fix 28)
3476
+ // AND method call patterns that need base variable resolution (Fix 33)
3477
+ if (sourcePath.includes('()')) {
3478
+ // Fix 28: Handle computed value patterns with dependency arrays
3479
+ // Patterns like `functionName(arg, [dep1, dep2, ...])` are NOT controllable
3480
+ // data sources. We trace through the dependencies to find controllable sources.
3481
+ const bracketStart = sourcePath.indexOf('[');
3482
+ const bracketEnd = sourcePath.lastIndexOf(']');
3483
+ if (bracketStart !== -1 && bracketEnd > bracketStart) {
3484
+ const arrayContent = sourcePath.slice(bracketStart + 1, bracketEnd);
3485
+ const items = arrayContent.split(',').map((s) => s.trim());
3486
+ // Only process if this looks like a dependency array:
3487
+ // multiple items that are all simple identifiers (not numbers or expressions)
3488
+ const isIdentifier = (s) => /^\w+$/.test(s) && !/^\d+$/.test(s);
3489
+ if (items.length > 1 && items.every(isIdentifier)) {
3490
+ // Look for a dependency that's already resolved to a controllable source
3491
+ for (const dep of items) {
3492
+ if (dep in equivalentSignatureVariables) {
3493
+ const resolvedDep = equivalentSignatureVariables[dep];
3494
+ // Use if it's a controllable path (contains hook call)
3495
+ // and is NOT another unresolved computed pattern (has comma-separated deps)
3496
+ const hasCommaInBrackets = resolvedDep.includes('[') &&
3497
+ resolvedDep.includes(',') &&
3498
+ resolvedDep.indexOf(',') > resolvedDep.indexOf('[');
3499
+ if (resolvedDep.includes('()') && !hasCommaInBrackets) {
3500
+ // Computed value is typically an element from an array
3501
+ equivalentSignatureVariables[varName] = resolvedDep + '[]';
3502
+ changed = true;
3503
+ break;
3504
+ }
3505
+ }
3506
+ }
3507
+ }
3508
+ }
3509
+ // Fix 33: Handle method call patterns on variables
3510
+ // Patterns like: "splat.split('/').functionCallReturnValue"
3511
+ // We need to resolve the base variable (splat) to its actual source
3512
+ // Check if this is a method call on a variable (dot before first parenthesis)
3513
+ const dotIndex = sourcePath.indexOf('.');
3514
+ const parenIndex = sourcePath.indexOf('(');
3515
+ if (dotIndex !== -1 &&
3516
+ dotIndex < parenIndex &&
3517
+ !sourcePath.startsWith('use') // Not a hook call like useState()
3518
+ ) {
3519
+ // Extract the base variable (before the first dot)
3520
+ const baseVar = sourcePath.slice(0, dotIndex);
3521
+ const rest = sourcePath.slice(dotIndex); // includes ".method(...).functionCallReturnValue"
3522
+ // Check if the base variable can be resolved
3523
+ if (baseVar in equivalentSignatureVariables &&
3524
+ baseVar !== varName) {
3525
+ const baseResolved = equivalentSignatureVariables[baseVar];
3526
+ // Skip if baseResolved is an array (OR expression)
3527
+ if (Array.isArray(baseResolved))
3528
+ continue;
3529
+ // Only resolve if the base resolved to something useful (contains () or .)
3530
+ if (baseResolved.includes('()') || baseResolved.includes('.')) {
3531
+ const newPath = baseResolved + rest;
3532
+ if (newPath !== equivalentSignatureVariables[varName]) {
3533
+ equivalentSignatureVariables[varName] = newPath;
3534
+ changed = true;
3535
+ }
3536
+ }
3537
+ }
3538
+ }
3539
+ // Fix 38: Handle cyScope lazy initializer return values
3540
+ // When we have viewMode -> cyScope20(), trace through to find what cyScope20 returns.
3541
+ // The lazy initializer's return value should be the controllable data source.
3542
+ // Pattern: cyScopeN() where N is a number
3543
+ const cyScopeMatch = sourcePath.match(/^(cyScope\d+)\(\)$/);
3544
+ if (cyScopeMatch) {
3545
+ const cyScopeName = cyScopeMatch[1];
3546
+ const cyScopeNode = this.scopeNodes[cyScopeName];
3547
+ if (cyScopeNode?.equivalencies) {
3548
+ // Look for returnValue equivalency in the cyScope
3549
+ const returnValueEquivs = cyScopeNode.equivalencies['returnValue'];
3550
+ if (returnValueEquivs && returnValueEquivs.length > 0) {
3551
+ // Get the first return value source
3552
+ const returnSource = returnValueEquivs[0].schemaPath;
3553
+ // If the return source is a simple variable (not a complex path),
3554
+ // resolve varName directly to that variable
3555
+ if (returnSource &&
3556
+ !returnSource.includes('(') &&
3557
+ !returnSource.includes('[')) {
3558
+ // Update varName to point to the return source
3559
+ if (equivalentSignatureVariables[varName] !== returnSource) {
3560
+ equivalentSignatureVariables[varName] = returnSource;
3561
+ changed = true;
3562
+ }
3563
+ }
3564
+ }
3565
+ }
3566
+ }
3567
+ continue;
3568
+ }
3569
+ // Check if the source path starts with a variable that's also in the map
3570
+ const dotIndex = sourcePath.indexOf('.');
3571
+ let baseVar;
3572
+ let rest;
3573
+ if (dotIndex > 0) {
3574
+ // Path has a dot: "a.b.c" -> baseVar="a", rest=".b.c"
3575
+ baseVar = sourcePath.slice(0, dotIndex);
3576
+ rest = sourcePath.slice(dotIndex); // includes the leading dot
3577
+ }
3578
+ else {
3579
+ // Path is a simple identifier: "currentEntityAnalysis" -> baseVar="currentEntityAnalysis", rest=""
3580
+ baseVar = sourcePath;
3581
+ rest = '';
3582
+ }
3583
+ if (baseVar in equivalentSignatureVariables && baseVar !== varName) {
3584
+ // Handle array case (OR expressions) - use first element
3585
+ const rawBaseResolved = equivalentSignatureVariables[baseVar];
3586
+ const baseResolved = Array.isArray(rawBaseResolved)
3587
+ ? rawBaseResolved[0]
3588
+ : rawBaseResolved;
3589
+ if (!baseResolved)
3590
+ continue;
3591
+ // If the base resolves to a hook call, add .functionCallReturnValue
3592
+ if (baseResolved.endsWith('()')) {
3593
+ const newPath = baseResolved + '.functionCallReturnValue' + rest;
3594
+ if (newPath !== equivalentSignatureVariables[varName]) {
3595
+ equivalentSignatureVariables[varName] = newPath;
3596
+ changed = true;
3597
+ }
3598
+ }
3599
+ else if (baseResolved !== sourcePath) {
3600
+ const newPath = baseResolved + rest;
3601
+ if (newPath !== equivalentSignatureVariables[varName]) {
3602
+ equivalentSignatureVariables[varName] = newPath;
3603
+ changed = true;
3604
+ }
3605
+ }
3606
+ }
3607
+ }
3608
+ // Stop if no changes were made in this iteration
3609
+ if (!changed)
3610
+ break;
2512
3611
  }
2513
3612
  return equivalentSignatureVariables;
2514
3613
  }
@@ -2557,7 +3656,95 @@ export class ScopeDataStructure {
2557
3656
  // Replace cyScope placeholders in all external function call data
2558
3657
  // This ensures call signatures and schema paths use actual callback text
2559
3658
  // instead of internal cyScope names, preventing mock data merge conflicts.
2560
- return this.externalFunctionCalls.map((efc) => this.cleanCyScopeFromFunctionCallInfo(efc));
3659
+ const rootScopeName = this.scopeTreeManager.getRootName();
3660
+ const rootSchema = this.scopeNodes[rootScopeName]?.schema ?? {};
3661
+ return this.externalFunctionCalls.map((efc) => {
3662
+ const cleaned = this.cleanCyScopeFromFunctionCallInfo(efc);
3663
+ return this.filterConflatedExternalPaths(cleaned, rootSchema);
3664
+ });
3665
+ }
3666
+ /**
3667
+ * Filters out conflated paths from external function call schemas.
3668
+ *
3669
+ * When multiple useState(false) calls create equivalency conflation during
3670
+ * Phase 1 analysis, standalone boolean state variables (like showWorkoutForm,
3671
+ * showGoalForm) can bleed into external function call schemas as sub-properties
3672
+ * of unrelated data fields (like data[].activity_type.showWorkoutForm).
3673
+ *
3674
+ * Detection: group sub-properties by parent path. If 2+ sub-properties of
3675
+ * the same parent all match standalone root scope variable names, treat them
3676
+ * as conflation artifacts and remove them.
3677
+ */
3678
+ filterConflatedExternalPaths(efc, rootSchema) {
3679
+ // Build a set of top-level root scope variable names (simple names, no dots/brackets)
3680
+ const topLevelRootVars = new Set();
3681
+ for (const key of Object.keys(rootSchema)) {
3682
+ if (!key.includes('.') && !key.includes('[')) {
3683
+ topLevelRootVars.add(key);
3684
+ }
3685
+ }
3686
+ if (topLevelRootVars.size === 0)
3687
+ return efc;
3688
+ // Group sub-property matches by their parent path.
3689
+ // For a path like "...data[].activity_type.showWorkoutForm",
3690
+ // parent = "...data[].activity_type", child = "showWorkoutForm"
3691
+ const parentToConflatedKeys = new Map();
3692
+ for (const key of Object.keys(efc.schema)) {
3693
+ const lastDot = key.lastIndexOf('.');
3694
+ if (lastDot === -1)
3695
+ continue;
3696
+ const parent = key.substring(0, lastDot);
3697
+ const child = key.substring(lastDot + 1);
3698
+ // Skip array access or function call patterns
3699
+ if (child.includes('[') || child.includes('('))
3700
+ continue;
3701
+ // Only consider paths inside array element chains (contains []).
3702
+ // Direct children of functionCallReturnValue are legitimate destructured
3703
+ // return values, not conflation. Conflation happens deeper in the chain
3704
+ // when array element fields get corrupted sub-properties.
3705
+ if (!parent.includes('['))
3706
+ continue;
3707
+ if (topLevelRootVars.has(child)) {
3708
+ if (!parentToConflatedKeys.has(parent)) {
3709
+ parentToConflatedKeys.set(parent, []);
3710
+ }
3711
+ parentToConflatedKeys.get(parent).push(key);
3712
+ }
3713
+ }
3714
+ // Only filter when 2+ sub-properties of the same parent match root scope vars.
3715
+ // This threshold avoids false positives from coincidental name matches.
3716
+ const keysToRemove = new Set();
3717
+ const parentsToRestore = new Set();
3718
+ for (const [parent, conflatedKeys] of parentToConflatedKeys) {
3719
+ if (conflatedKeys.length >= 2) {
3720
+ for (const key of conflatedKeys) {
3721
+ keysToRemove.add(key);
3722
+ }
3723
+ parentsToRestore.add(parent);
3724
+ }
3725
+ }
3726
+ if (keysToRemove.size === 0)
3727
+ return efc;
3728
+ // Create a new schema without the conflated paths
3729
+ const newSchema = {};
3730
+ for (const [key, value] of Object.entries(efc.schema)) {
3731
+ if (keysToRemove.has(key))
3732
+ continue;
3733
+ // Restore parent type: if it was changed to "object" because of conflated
3734
+ // sub-properties, and now all those sub-properties are removed, change it
3735
+ // back to "unknown" (we don't know the original type)
3736
+ if (parentsToRestore.has(key) && value === 'object') {
3737
+ // Check if there are any remaining sub-properties
3738
+ const hasRemainingSubProps = Object.keys(efc.schema).some((k) => !keysToRemove.has(k) &&
3739
+ k !== key &&
3740
+ (k.startsWith(key + '.') || k.startsWith(key + '[')));
3741
+ newSchema[key] = hasRemainingSubProps ? value : 'unknown';
3742
+ }
3743
+ else {
3744
+ newSchema[key] = value;
3745
+ }
3746
+ }
3747
+ return { ...efc, schema: newSchema };
2561
3748
  }
2562
3749
  /**
2563
3750
  * Cleans cyScope placeholder references from a FunctionCallInfo.
@@ -2669,12 +3856,116 @@ export class ScopeDataStructure {
2669
3856
  }
2670
3857
  }
2671
3858
  }
3859
+ /**
3860
+ * Add conditional effects from AST analysis.
3861
+ * Called during scope analysis to collect all setter calls inside conditionals.
3862
+ */
3863
+ addConditionalEffects(effects) {
3864
+ // Add effects, avoiding duplicates based on effect stateVariable and condition paths
3865
+ for (const effect of effects) {
3866
+ const exists = this.rawConditionalEffects.some((existing) => {
3867
+ // Same effect target (stateVariable + value)
3868
+ const sameEffect = existing.effect.stateVariable === effect.effect.stateVariable &&
3869
+ existing.effect.value === effect.effect.value;
3870
+ if (!sameEffect)
3871
+ return false;
3872
+ // Same condition(s)
3873
+ if (existing.condition && effect.condition) {
3874
+ return (existing.condition.path === effect.condition.path &&
3875
+ existing.condition.requiredValue === effect.condition.requiredValue);
3876
+ }
3877
+ if (existing.conditions && effect.conditions) {
3878
+ if (existing.conditions.length !== effect.conditions.length)
3879
+ return false;
3880
+ return existing.conditions.every((ec, i) => {
3881
+ const newCond = effect.conditions[i];
3882
+ return (ec.path === newCond.path &&
3883
+ ec.requiredValue === newCond.requiredValue);
3884
+ });
3885
+ }
3886
+ return false;
3887
+ });
3888
+ if (!exists) {
3889
+ this.rawConditionalEffects.push(effect);
3890
+ }
3891
+ }
3892
+ }
3893
+ /**
3894
+ * Get conditional effects collected during analysis.
3895
+ */
3896
+ getConditionalEffects() {
3897
+ return this.rawConditionalEffects;
3898
+ }
3899
+ /**
3900
+ * Add compound conditionals from AST analysis.
3901
+ * Called during scope analysis to collect grouped conditions (e.g., a && b && c).
3902
+ */
3903
+ addCompoundConditionals(compounds) {
3904
+ // Add compounds, avoiding duplicates based on chainId
3905
+ for (const compound of compounds) {
3906
+ const exists = this.rawCompoundConditionals.some((existing) => existing.chainId === compound.chainId);
3907
+ if (!exists) {
3908
+ this.rawCompoundConditionals.push(compound);
3909
+ }
3910
+ }
3911
+ }
3912
+ /**
3913
+ * Get compound conditionals collected during analysis.
3914
+ */
3915
+ getCompoundConditionals() {
3916
+ return this.rawCompoundConditionals;
3917
+ }
3918
+ /**
3919
+ * Add child boundary gating conditions from AST analysis.
3920
+ * These track which conditions must be true for a child component to render.
3921
+ */
3922
+ addChildBoundaryGatingConditions(conditions) {
3923
+ for (const [childName, usages] of Object.entries(conditions)) {
3924
+ if (!this.rawChildBoundaryGatingConditions[childName]) {
3925
+ this.rawChildBoundaryGatingConditions[childName] = [];
3926
+ }
3927
+ // Add usages, avoiding duplicates
3928
+ for (const usage of usages) {
3929
+ const exists = this.rawChildBoundaryGatingConditions[childName].some((existing) => existing.path === usage.path &&
3930
+ existing.conditionType === usage.conditionType &&
3931
+ existing.isNegated === usage.isNegated);
3932
+ if (!exists) {
3933
+ this.rawChildBoundaryGatingConditions[childName].push(usage);
3934
+ }
3935
+ }
3936
+ }
3937
+ }
3938
+ /**
3939
+ * Get enriched child boundary gating conditions with source tracing.
3940
+ * Similar to getEnrichedConditionalUsages but for gating conditions.
3941
+ */
3942
+ getEnrichedChildBoundaryGatingConditions() {
3943
+ const enriched = {};
3944
+ const rootScopeName = this.scopeTreeManager.getTree().name;
3945
+ for (const [childName, usages] of Object.entries(this.rawChildBoundaryGatingConditions)) {
3946
+ enriched[childName] = usages.map((usage) => {
3947
+ // Try to trace this path back to a data source
3948
+ const explanation = this.explainPath(rootScopeName, usage.path);
3949
+ let sourceDataPath;
3950
+ if (explanation.source) {
3951
+ sourceDataPath = `${explanation.source.scope}.${explanation.source.path}`;
3952
+ }
3953
+ return {
3954
+ ...usage,
3955
+ sourceDataPath,
3956
+ };
3957
+ });
3958
+ }
3959
+ return enriched;
3960
+ }
2672
3961
  /**
2673
3962
  * Get enriched conditional usages with source tracing.
2674
3963
  * Uses explainPath to trace each local variable back to its data source.
3964
+ * Preserves all fields from the raw conditional usages including derivedFrom.
2675
3965
  */
2676
3966
  getEnrichedConditionalUsages() {
2677
3967
  const enriched = {};
3968
+ console.log(`[getEnrichedConditionalUsages] Processing ${Object.keys(this.rawConditionalUsages).length} conditional paths: [${Object.keys(this.rawConditionalUsages).join(', ')}]`);
2678
3969
  for (const [path, usages] of Object.entries(this.rawConditionalUsages)) {
2679
3970
  // Try to trace this path back to a data source
2680
3971
  // First, try the root scope
@@ -2682,9 +3973,47 @@ export class ScopeDataStructure {
2682
3973
  const explanation = this.explainPath(rootScopeName, path);
2683
3974
  let sourceDataPath;
2684
3975
  if (explanation.source) {
2685
- // Build the full data path: scopeName.path
2686
- sourceDataPath = `${explanation.source.scope}.${explanation.source.path}`;
3976
+ const { scope, path: sourcePath } = explanation.source;
3977
+ // Build initial path — avoid redundant prefix when path already contains the scope call
3978
+ let fullPath;
3979
+ if (sourcePath.startsWith(`${scope}(`)) {
3980
+ fullPath = sourcePath;
3981
+ }
3982
+ else {
3983
+ fullPath = `${scope}.${sourcePath}`;
3984
+ }
3985
+ sourceDataPath = fullPath;
3986
+ console.log(`[getEnrichedConditionalUsages] "${path}" explainPath → scope="${scope}", sourcePath="${sourcePath}" → sourceDataPath="${sourceDataPath}"`);
3987
+ }
3988
+ else {
3989
+ console.log(`[getEnrichedConditionalUsages] "${path}" explainPath → no source found`);
2687
3990
  }
3991
+ // If explainPath didn't find a useful external source (e.g., it traced to
3992
+ // useState or just to the component scope itself), check sourceEquivalencies
3993
+ // for an external function call source like a fetch call
3994
+ const hasExternalSource = sourceDataPath?.includes('.functionCallReturnValue');
3995
+ if (!hasExternalSource) {
3996
+ console.log(`[getEnrichedConditionalUsages] "${path}" no external source (sourceDataPath="${sourceDataPath}"), checking sourceEquivalencies fallback...`);
3997
+ const sourceEquiv = this.getSourceEquivalencies();
3998
+ const returnValueKey = `returnValue.${path}`;
3999
+ const sources = sourceEquiv[returnValueKey];
4000
+ if (sources) {
4001
+ console.log(`[getEnrichedConditionalUsages] "${path}" sourceEquivalencies["${returnValueKey}"] has ${sources.length} sources: [${sources.map((s) => s.schemaPath).join(', ')}]`);
4002
+ const externalSource = sources.find((s) => s.schemaPath.includes('.functionCallReturnValue') &&
4003
+ !s.schemaPath.startsWith('useState('));
4004
+ if (externalSource) {
4005
+ console.log(`[getEnrichedConditionalUsages] "${path}" sourceEquivalencies fallback found external source: "${externalSource.schemaPath}"`);
4006
+ sourceDataPath = externalSource.schemaPath;
4007
+ }
4008
+ else {
4009
+ console.log(`[getEnrichedConditionalUsages] "${path}" sourceEquivalencies fallback found no external function call source`);
4010
+ }
4011
+ }
4012
+ else {
4013
+ console.log(`[getEnrichedConditionalUsages] "${path}" sourceEquivalencies["${returnValueKey}"] not found`);
4014
+ }
4015
+ }
4016
+ console.log(`[getEnrichedConditionalUsages] "${path}" FINAL sourceDataPath="${sourceDataPath ?? '(none)'}" (${usages.length} usages)`);
2688
4017
  enriched[path] = usages.map((usage) => ({
2689
4018
  ...usage,
2690
4019
  sourceDataPath,
@@ -2692,9 +4021,29 @@ export class ScopeDataStructure {
2692
4021
  }
2693
4022
  return enriched;
2694
4023
  }
4024
+ /**
4025
+ * Add JSX rendering usages from AST analysis.
4026
+ * These track arrays rendered via .map() and strings interpolated in JSX.
4027
+ */
4028
+ addJsxRenderingUsages(usages) {
4029
+ // Add usages, avoiding duplicates based on path and renderingType
4030
+ for (const usage of usages) {
4031
+ const exists = this.rawJsxRenderingUsages.some((existing) => existing.path === usage.path &&
4032
+ existing.renderingType === usage.renderingType);
4033
+ if (!exists) {
4034
+ this.rawJsxRenderingUsages.push(usage);
4035
+ }
4036
+ }
4037
+ }
4038
+ /**
4039
+ * Get JSX rendering usages collected during analysis.
4040
+ */
4041
+ getJsxRenderingUsages() {
4042
+ return this.rawJsxRenderingUsages;
4043
+ }
2695
4044
  toSerializable() {
2696
- // Helper to clean cyScope from a string
2697
- const cleanCyScope = (str) => this.replaceCyScopeInString(str);
4045
+ // Helper to clean cyScope and cyDuplicateKey from a string for output
4046
+ const cleanCyScope = (str) => this.replaceCyScopeInString(str).replace(/::cyDuplicateKey\d+::/g, '');
2698
4047
  // Helper to convert ScopeVariable to SerializableScopeVariable (with cyScope cleaned)
2699
4048
  const toSerializableVariable = (vars) => vars.map((v) => ({
2700
4049
  scopeNodeName: cleanCyScope(v.scopeNodeName),
@@ -2914,7 +4263,8 @@ export class ScopeDataStructure {
2914
4263
  }
2915
4264
  }
2916
4265
  if (Object.keys(varSchema).length > 0) {
2917
- perVariableSchemas[varName] = varSchema;
4266
+ // Clean the variable name when using as key in output
4267
+ perVariableSchemas[cleanCyScope(varName)] = varSchema;
2918
4268
  }
2919
4269
  }
2920
4270
  // Only include if we have any entries
@@ -2922,11 +4272,21 @@ export class ScopeDataStructure {
2922
4272
  perVariableSchemas = undefined;
2923
4273
  }
2924
4274
  }
4275
+ // Enrich the schema with inferred types by applying fillInSchemaGapsAndUnknowns.
4276
+ // This ensures the serialized schema has the same type inference as getReturnValue().
4277
+ // Without this, evidence like "entities[].analyses: array" becomes "unknown".
4278
+ const enrichedSchema = { ...efc.schema };
4279
+ const tempScopeNode = {
4280
+ name: efc.name,
4281
+ schema: enrichedSchema,
4282
+ equivalencies: efc.equivalencies ?? {},
4283
+ };
4284
+ fillInSchemaGapsAndUnknowns(tempScopeNode, true);
2925
4285
  return {
2926
4286
  name: efc.name,
2927
4287
  callSignature: efc.callSignature,
2928
4288
  callScope: efc.callScope,
2929
- schema: efc.schema,
4289
+ schema: enrichedSchema,
2930
4290
  equivalencies: efc.equivalencies
2931
4291
  ? Object.entries(efc.equivalencies).reduce((acc, [key, vars]) => {
2932
4292
  // Clean cyScope from the key as well as variable properties
@@ -2935,8 +4295,13 @@ export class ScopeDataStructure {
2935
4295
  }, {})
2936
4296
  : undefined,
2937
4297
  allCallSignatures: efc.allCallSignatures,
2938
- receivingVariableNames: efc.receivingVariableNames,
2939
- callSignatureToVariable: efc.callSignatureToVariable,
4298
+ receivingVariableNames: efc.receivingVariableNames?.map(cleanCyScope),
4299
+ callSignatureToVariable: efc.callSignatureToVariable
4300
+ ? Object.fromEntries(Object.entries(efc.callSignatureToVariable).map(([k, v]) => [
4301
+ k,
4302
+ cleanCyScope(v),
4303
+ ]))
4304
+ : undefined,
2940
4305
  perVariableSchemas,
2941
4306
  };
2942
4307
  });
@@ -3038,6 +4403,12 @@ export class ScopeDataStructure {
3038
4403
  };
3039
4404
  // Apply deduplication
3040
4405
  const deduplicatedExternalFunctionCalls = deduplicateParameterizedEntries(externalFunctionCalls);
4406
+ // IMPORTANT: Get equivalent signature variables BEFORE calling getFunctionResult
4407
+ // because getFunctionResult calls validateSchema which may remove equivalencies
4408
+ // during the finalize step (e.g., cleanNonObjectFunctions removes method call
4409
+ // equivalencies like `segments -> splat.split('/').functionCallReturnValue`).
4410
+ // Fix 33: Move this call before any schema validation to preserve method call chains.
4411
+ const equivalentSignatureVariables = this.getEquivalentSignatureVariables();
3041
4412
  // Get root function result
3042
4413
  const rootFunction = getFunctionResult();
3043
4414
  // Get results for each external function (use cleaned calls for consistency)
@@ -3045,14 +4416,29 @@ export class ScopeDataStructure {
3045
4416
  for (const efc of cleanedExternalCalls) {
3046
4417
  functionResults[efc.name] = getFunctionResult(efc.name);
3047
4418
  }
3048
- // Get equivalent signature variables
3049
- const equivalentSignatureVariables = this.getEquivalentSignatureVariables();
3050
4419
  const environmentVariables = this.getEnvironmentVariables();
3051
4420
  // Get enriched conditional usages with source tracing
3052
4421
  const enrichedConditionalUsages = this.getEnrichedConditionalUsages();
3053
4422
  const conditionalUsages = Object.keys(enrichedConditionalUsages).length > 0
3054
4423
  ? enrichedConditionalUsages
3055
4424
  : undefined;
4425
+ // Get conditional effects (setter calls inside conditionals)
4426
+ const conditionalEffects = this.rawConditionalEffects.length > 0
4427
+ ? this.rawConditionalEffects
4428
+ : undefined;
4429
+ // Get compound conditionals (grouped conditions that must all be true)
4430
+ const compoundConditionals = this.rawCompoundConditionals.length > 0
4431
+ ? this.rawCompoundConditionals
4432
+ : undefined;
4433
+ // Get child boundary gating conditions
4434
+ const enrichedGatingConditions = this.getEnrichedChildBoundaryGatingConditions();
4435
+ const childBoundaryGatingConditions = Object.keys(enrichedGatingConditions).length > 0
4436
+ ? enrichedGatingConditions
4437
+ : undefined;
4438
+ // Get JSX rendering usages (arrays via .map(), strings via interpolation)
4439
+ const jsxRenderingUsages = this.rawJsxRenderingUsages.length > 0
4440
+ ? this.rawJsxRenderingUsages
4441
+ : undefined;
3056
4442
  return {
3057
4443
  externalFunctionCalls: deduplicatedExternalFunctionCalls,
3058
4444
  rootFunction,
@@ -3060,6 +4446,10 @@ export class ScopeDataStructure {
3060
4446
  equivalentSignatureVariables,
3061
4447
  environmentVariables,
3062
4448
  conditionalUsages,
4449
+ conditionalEffects,
4450
+ compoundConditionals,
4451
+ childBoundaryGatingConditions,
4452
+ jsxRenderingUsages,
3063
4453
  };
3064
4454
  }
3065
4455
  // ═══════════════════════════════════════════════════════════════════════════